chore(spec): regenerate api-surface, export-origins, declaration-map, reference docs and strictness counts

Claude-Session: https://claude.ai/code/session_01D6F9axfoPzR7t8G1J7Ytzz
Co-authored-by: Claude <noreply@anthropic.com>

Author: claude

content/docs/references/api/automation-api.mdx

@@ -1,7 +1,7 @@
 ---
 title: Protocol reference — every schema by module
 navTitle: Protocol Reference
-description: Every schema published by @objectstack/spec — 1542 schemas across 14 protocol modules
+description: Every schema published by @objectstack/spec — 1544 schemas across 14 protocol modules
 ---
 
 {/* ⚠️  AUTO-GENERATED — DO NOT EDIT. Run build-docs.ts to regenerate. Hand-written docs live in the module folders under content/docs/. */}
@@ -21,7 +21,7 @@ counts are sums of the rows they head. Regenerate with
 | Module | Pages | Schemas | Description |
 | :--- | ---: | ---: | :--- |
 | [AI Protocol](/docs/references/ai) | 12 | 68 | Agents, tools, skills, RAG and knowledge sources, model registry, conversations. |
-| [API Protocol](/docs/references/api) | 32 | 438 | REST contracts, endpoints, routing, realtime, batch, discovery. |
+| [API Protocol](/docs/references/api) | 32 | 440 | REST contracts, endpoints, routing, realtime, batch, discovery. |
 | [Automation Protocol](/docs/references/automation) | 13 | 71 | Flows and their nodes, approvals, ETL pipelines, webhooks, state machines, execution records. |
 | [Data Protocol](/docs/references/data) | 29 | 176 | Objects, fields, queries, filters, datasources and drivers — the ObjectQL layer. |
 | [Identity Protocol](/docs/references/identity) | 5 | 27 | Users and accounts, organizations, positions, SCIM provisioning. |
@@ -34,7 +34,7 @@ counts are sums of the rows they head. Regenerate with
 | [Studio Protocol](/docs/references/studio) | 3 | 35 | Studio designer metadata — the authoring surfaces for the protocols above. |
 | [System Protocol](/docs/references/system) | 36 | 285 | The runtime environment — logging, jobs, cache, metrics, notifications, i18n and compliance. |
 | [UI Protocol](/docs/references/ui) | 16 | 169 | Apps, pages, views, dashboards, reports, actions and themes — the ObjectUI layer. |
-| **Total** | **197** | **1542** | 14 protocol modules |
+| **Total** | **197** | **1544** | 14 protocol modules |
 
 ---
 
@@ -63,7 +63,7 @@ Agents, tools, skills, RAG and knowledge sources, model registry, conversations.
 
 ## API Protocol
 
-**Source:** `packages/spec/src/api/` · **Import:** `@objectstack/spec/api` · **32 pages, 438 schemas**
+**Source:** `packages/spec/src/api/` · **Import:** `@objectstack/spec/api` · **32 pages, 440 schemas**
 
 REST contracts, endpoints, routing, realtime, batch, discovery.
 
@@ -72,7 +72,7 @@ REST contracts, endpoints, routing, realtime, batch, discovery.
 | [`analytics.zod.ts`](/docs/references/api/analytics) | `AnalyticsEndpoint`, `AnalyticsMetadataResponse`, `AnalyticsQueryRequest`, `AnalyticsResultResponse`, `AnalyticsSqlResponse`, `DatasetCompareTo`, `DatasetSelection`, `DatasetTotals`, `GetAnalyticsMetaRequest` |
 | [`auth.zod.ts`](/docs/references/api/auth) | `AuthProvider`, `LoginRequest`, `LoginType`, `RefreshTokenRequest`, `RegisterRequest`, `Session`, `SessionResponse`, `SessionUser`, `UserProfileResponse` |
 | [`auth-endpoints.zod.ts`](/docs/references/api/auth-endpoints) | `AuthEndpoint`, `AuthFeaturesConfig`, `AuthProviderInfo`, `DeviceRequestResponse`, `DeviceTokenResponse`, `EmailPasswordConfigPublic`, `GetAuthConfigResponse` |
-| [`automation-api.zod.ts`](/docs/references/api/automation-api) | `AutomationApiErrorCode`, `AutomationFlowPathParams`, `AutomationRunPathParams`, `CreateFlowRequest`, `CreateFlowResponse`, `DeleteFlowRequest`, `DeleteFlowResponse`, `GetFlowRequest`, `GetFlowResponse`, `GetRunRequest`, `GetRunResponse`, `ListRunsRequest`, `ListRunsResponse`, `ResumeFailureDetails`, `ToggleFlowRequest`, `ToggleFlowResponse`, `TriggerFlowRequest`, `TriggerFlowResponse`, `UpdateFlowRequest`, `UpdateFlowResponse` |
+| [`automation-api.zod.ts`](/docs/references/api/automation-api) | `AutomationApiErrorCode`, `AutomationFlowPathParams`, `AutomationRunPathParams`, `CreateFlowRequest`, `CreateFlowResponse`, `DeleteFlowRequest`, `DeleteFlowResponse`, `FlowFailureDetails`, `FlowInnerRefusal`, `GetFlowRequest`, `GetFlowResponse`, `GetRunRequest`, `GetRunResponse`, `ListRunsRequest`, `ListRunsResponse`, `ResumeFailureDetails`, `ToggleFlowRequest`, `ToggleFlowResponse`, `TriggerFlowRequest`, `TriggerFlowResponse`, `UpdateFlowRequest`, `UpdateFlowResponse` |
 | [`batch.zod.ts`](/docs/references/api/batch) | `BatchConfig`, `BatchOperationResult`, `BatchOperationType`, `BatchOptions`, `BatchRecord`, `BatchUpdateRequest`, `BatchUpdateResponse`, `CrossObjectBatchDroppedFields`, `CrossObjectBatchOperation`, `CrossObjectBatchRequest`, `CrossObjectBatchResponse`, `DeleteManyRequest`, `UpdateManyRecord`, `UpdateManyRequest` |
 | [`contract.zod.ts`](/docs/references/api/contract) | `ApiError`, `BaseResponse`, `BatchLoadingStrategy`, `BulkRequest`, `BulkResponse`, `CreateRequest`, `DataLoaderConfig`, `DeleteResponse`, `ExportRequest`, `IdRequest`, `ListRecordResponse`, `ModificationResult`, `QueryOptimizationConfig`, `RecordData`, `SingleRecordResponse`, `UpdateRequest` |
 | [`discovery.zod.ts`](/docs/references/api/discovery) | `ApiRoutes`, `AuthFamilies`, `CapabilityDescriptor`, `Discovery`, `DiscoveryEnvironment`, `EnvironmentType`, `RouteHealthEntry`, `RouteHealthReport`, `ServiceInfo`, `ServiceSelfInfo`, `ServiceStatus`, `WellKnownCapabilities` |

content/docs/references/index.mdx

@@ -19,4 +19,4 @@ hand-patch a number here** — fix the code or the verdict and regenerate.
 
 | Dir | Sites |
 |---|---|
-| `api/` | 446 |
+| `api/` | 448 |

docs/audits/2026-07-unknown-key-strictness-ledger.counts/api.md

@@ -405,6 +405,12 @@
     "FindReferencesToMetaResponse (type)",
     "FindReferencesToMetaResponseParsed (type)",
     "FindReferencesToMetaResponseSchema (const)",
+    "FlowFailureDetails (type)",
+    "FlowFailureDetailsParsed (type)",
+    "FlowFailureDetailsSchema (const)",
+    "FlowInnerRefusal (type)",
+    "FlowInnerRefusalParsed (type)",
+    "FlowInnerRefusalSchema (const)",
     "FlowRegistration (type)",
     "FlowRegistrationRefusal (type)",
     "FlowRegistrationRefusalSchema (const)",

packages/spec/api-surface/api.json

@@ -689,6 +689,11 @@
     "api/FindDataResponse:records",
     "api/FindDataResponse:total",
     "api/FindReferencesToMetaResponse:references",
+    "api/FlowFailureDetails:errorMessage",
+    "api/FlowFailureDetails:innerRefusal",
+    "api/FlowFailureDetails:summary",
+    "api/FlowInnerRefusal:code",
+    "api/FlowInnerRefusal:message",
     "api/FlowRegistrationRefusal:code",
     "api/FlowRegistrationRefusal:message",
     "api/GeneratedApiDocumentation:generatedAt",

packages/spec/authorable-surface/api.json

@@ -289,6 +289,10 @@
     "FindDataResponseSchema": "api/FindDataResponse",
     "FindReferencesToMetaResponse": "api/FindReferencesToMetaResponse",
     "FindReferencesToMetaResponseSchema": "api/FindReferencesToMetaResponse",
+    "FlowFailureDetails": "api/FlowFailureDetails",
+    "FlowFailureDetailsSchema": "api/FlowFailureDetails",
+    "FlowInnerRefusal": "api/FlowInnerRefusal",
+    "FlowInnerRefusalSchema": "api/FlowInnerRefusal",
     "FlowRegistration": "api/FlowRegistration",
     "FlowRegistrationRefusal": "api/FlowRegistrationRefusal",
     "FlowRegistrationRefusalSchema": "api/FlowRegistrationRefusal",

packages/spec/declaration-map/api.json

@@ -384,6 +384,12 @@
     "FindReferencesToMetaResponse": "src/api/protocol.zod.ts#FindReferencesToMetaResponse (type)",
     "FindReferencesToMetaResponseParsed": "src/api/protocol.zod.ts#FindReferencesToMetaResponseParsed (type)",
     "FindReferencesToMetaResponseSchema": "src/api/protocol.zod.ts#FindReferencesToMetaResponseSchema (const)",
+    "FlowFailureDetails": "src/api/automation-api.zod.ts#FlowFailureDetails (type)",
+    "FlowFailureDetailsParsed": "src/api/automation-api.zod.ts#FlowFailureDetailsParsed (type)",
+    "FlowFailureDetailsSchema": "src/api/automation-api.zod.ts#FlowFailureDetailsSchema (const)",
+    "FlowInnerRefusal": "src/api/automation-api.zod.ts#FlowInnerRefusal (type)",
+    "FlowInnerRefusalParsed": "src/api/automation-api.zod.ts#FlowInnerRefusalParsed (type)",
+    "FlowInnerRefusalSchema": "src/api/automation-api.zod.ts#FlowInnerRefusalSchema (const)",
     "FlowRegistration": "src/api/protocol.zod.ts#FlowRegistration (type)",
     "FlowRegistrationRefusal": "src/api/protocol.zod.ts#FlowRegistrationRefusal (type)",
     "FlowRegistrationRefusalSchema": "src/api/protocol.zod.ts#FlowRegistrationRefusalSchema (const)",

packages/spec/export-origins/api.json

@@ -159,6 +159,8 @@
     "api/FindDataRequest",
     "api/FindDataResponse",
     "api/FindReferencesToMetaResponse",
+    "api/FlowFailureDetails",
+    "api/FlowInnerRefusal",
     "api/FlowRegistration",
     "api/FlowRegistrationRefusal",
     "api/GeneratedApiDocumentation",