@runtypelabs/sdk 9.0.0 → 9.1.1

package/dist/index.cjs

@@ -404,7 +404,8 @@ function createAgentEventTranslator() {
             agentName: data.agentName,
             maxTurns: data.maxTurns,
             startedAt: data.startedAt,
-            config: data.config
+            config: data.config,
+            resumed: data.resumed
           })
         ];
       case "turn_start":
@@ -542,6 +543,10 @@ function createAgentEventTranslator() {
             toolName: data.toolName,
             success: data.success,
             result: data.result,
+            // A failure's reason travels on the frame's `error` field — the
+            // only carrier for complete-only failures like the MCP discovery
+            // connection pseudo-tool, which no longer emits an `error` frame.
+            error: str(data.error),
             executionTime: data.executionTime
           })
         ];
@@ -6437,7 +6442,7 @@ var Runtype = class {
 
 // src/version.ts
 var FALLBACK_VERSION = "0.0.0";
-var SDK_VERSION = "9.0.0".length > 0 ? "9.0.0" : FALLBACK_VERSION;
+var SDK_VERSION = "9.1.1".length > 0 ? "9.1.1" : FALLBACK_VERSION;
 var RUNTYPE_CLIENT_KIND = "sdk";
 var SDK_USER_AGENT = `runtype-sdk/${SDK_VERSION} (typescript)`;
 
@@ -10005,7 +10010,7 @@ var _AgentsEndpoint = class _AgentsEndpoint {
           ...callbacks,
           onAgentStart: (event) => {
             lastSeenExecutionId = event.executionId;
-            callbacks?.onAgentStart?.(event);
+            if (!event.resumed) callbacks?.onAgentStart?.(event);
           },
           onTurnDelta: (event) => {
             if (event.contentType === "text") {

package/dist/index.d.cts

@@ -2804,6 +2804,8 @@ interface paths {
                                 agentSpec?: unknown;
                                 cancelRequestedAt: string | null;
                                 completedAt: string | null;
+                                /** @description The conversation thread this run belongs to, so consumers can group a multi-turn conversation's runs without a per-run log query. This is the run's OWN thread, distinct from `parentConversationId` (subagent lineage, the conversation of the run that spawned it). `null` on stateless surfaces (webhook, schedule, eval, one-shot API) and on runs persisted before the column existed. */
+                                conversationId: string | null;
                                 createdAt: string;
                                 executionId: string;
                                 /** @enum {string} */
@@ -2937,6 +2939,8 @@ interface paths {
                             agentSpec?: unknown;
                             cancelRequestedAt: string | null;
                             completedAt: string | null;
+                            /** @description The conversation thread this run belongs to, so consumers can group a multi-turn conversation's runs without a per-run log query. This is the run's OWN thread, distinct from `parentConversationId` (subagent lineage, the conversation of the run that spawned it). `null` on stateless surfaces (webhook, schedule, eval, one-shot API) and on runs persisted before the column existed. */
+                            conversationId: string | null;
                             createdAt: string;
                             executionId: string;
                             /** @enum {string} */
@@ -5292,6 +5296,11 @@ interface paths {
                         "application/json": {
                             batchExecutionId: string;
                             completedAt?: string;
+                            /**
+                             * @description Run-level engine summary derived from the batch's per-record executionEngine values: 'runtime' or 'legacy' when every attributed record ran on that engine, 'mixed' when the batch spans both (e.g. a mid-flight fallback), and null when the run has no attributed records (runs recorded before attribution shipped).
+                             * @enum {string|null}
+                             */
+                            executionEngineSummary?: "runtime" | "legacy" | "mixed" | null;
                             failedRecords: number;
                             flowId: string;
                             processedRecords: number;
@@ -5587,6 +5596,11 @@ interface paths {
                                 durationMs: number | null;
                                 errorMessage?: string | null;
                                 estimatedCost?: string | null;
+                                /**
+                                 * @description Engine that actually executed this step ('runtime' | 'legacy'). Recorded at write time from the committed lane decision; never inferred later. Null for rows written before attribution shipped and for units that never started executing (externally executed runs carry no engine).
+                                 * @enum {string|null}
+                                 */
+                                executionEngine?: "runtime" | "legacy" | null;
                                 executionSessionId: string | null;
                                 flowId: string | null;
                                 flowVersionId: string | null;
@@ -6850,6 +6864,15 @@ interface paths {
                         "application/json": components["schemas"]["Error"];
                     };
                 };
+                /** @description Approval-gated execution is unsupported because Client Chat has no continuation channel that can deliver an owner-approved result back to the visitor (`APPROVAL_MODE_UNSUPPORTED`). */
+                501: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["Error"];
+                    };
+                };
             };
         };
         delete?: never;
@@ -9299,7 +9322,8 @@ interface paths {
                             [key: string]: unknown;
                         };
                         modelId?: string;
-                        ownerId?: string;
+                        /** @description Owner key for this conversation, stored in the indexed owner_id column and filterable via ?ownerId=. Overrides a nested metadata.ownerId. Null means no owner. */
+                        ownerId?: string | null;
                         systemPrompt?: string;
                         /** @default New Chat */
                         title?: string;
@@ -9543,7 +9567,8 @@ interface paths {
                             [key: string]: unknown;
                         };
                         modelId?: string;
-                        ownerId?: string;
+                        /** @description Reassigns the owner (indexed owner_id column, filterable via ?ownerId=). Overrides a nested metadata.ownerId. Null clears the owner; omit to leave it unchanged. */
+                        ownerId?: string | null;
                         systemPrompt?: string;
                         title?: string;
                     };
@@ -11089,7 +11114,7 @@ interface paths {
                                 /** @default true */
                                 createVersionOnChange?: boolean;
                             };
-                            /** @description For FLOW dispatches this compatibility field is accepted but ignored: eligible flows always use the @runtypelabs/runtime lane, while ineligible flows still fold to legacy silently. Agent dispatches still require an explicit `true` and remain subject to their separate runtime-agent rollout gate. */
+                            /** @description Compatibility execution-lane OPT-OUT. For FLOW dispatches the field is accepted but ignored: eligible flows always use the @runtypelabs/runtime lane, while ineligible flows still fold to legacy silently. For AGENT dispatches, an eligible agent now uses the @runtypelabs/runtime lane by DEFAULT when this field is omitted; only an explicit `false` forces the legacy engine. Definitions the runtime lane cannot execute faithfully still fold to legacy on their own. */
                             useRuntimePackage?: boolean;
                             versionLabel?: string;
                             versionNotes?: string;
@@ -11454,7 +11479,7 @@ interface paths {
                                 /** @default true */
                                 createVersionOnChange?: boolean;
                             };
-                            /** @description For FLOW dispatches this compatibility field is accepted but ignored: eligible flows always use the @runtypelabs/runtime lane, while ineligible flows still fold to legacy silently. Agent dispatches still require an explicit `true` and remain subject to their separate runtime-agent rollout gate. */
+                            /** @description Compatibility execution-lane OPT-OUT. For FLOW dispatches the field is accepted but ignored: eligible flows always use the @runtypelabs/runtime lane, while ineligible flows still fold to legacy silently. For AGENT dispatches, an eligible agent now uses the @runtypelabs/runtime lane by DEFAULT when this field is omitted; only an explicit `false` forces the legacy engine. Definitions the runtime lane cannot execute faithfully still fold to legacy on their own. */
                             useRuntimePackage?: boolean;
                             versionLabel?: string;
                             versionNotes?: string;
@@ -15606,6 +15631,11 @@ interface paths {
                                     errorMessage: string | null;
                                     errorStack: string | null;
                                     executedAt: string;
+                                    /**
+                                     * @description Engine that actually executed this step ('runtime' | 'legacy'). Recorded at write time from the committed lane decision; never inferred later. Null for rows written before attribution shipped and for units that never started executing (externally executed runs carry no engine).
+                                     * @enum {string|null}
+                                     */
+                                    executionEngine?: "runtime" | "legacy" | null;
                                     executionSessionId: string | null;
                                     inputVariables?: unknown;
                                     messageHistory: unknown[] | null;
@@ -17418,6 +17448,8 @@ interface paths {
          * @description **Limited preview — not yet generally available.** This endpoint is dark-launched and returns `404 Not Found` in production until GA; it is only reachable in non-production environments today.
          *
          *     Export a fully-resolved, self-contained flow definition that the @runtypelabs/runtime package can consume directly at boot. All step configs are inlined; no live DB queries are needed at execution time.
+         *
+         *     Flows containing a durable-class step (`wait-until` or `crawl`) are rejected with `422 Unprocessable Entity` (code `DURABLE_FLOW_EXPORT_UNSUPPORTED`): those steps park their pause on a Cloudflare Workflow, which cannot run inside an exported runtime artifact, so durable flows run hosted only.
          */
         get: {
             parameters: {
@@ -17490,6 +17522,23 @@ interface paths {
                         "application/json": components["schemas"]["Error"];
                     };
                 };
+                /** @description The flow contains durable-class steps and runs hosted only (code `DURABLE_FLOW_EXPORT_UNSUPPORTED`) */
+                422: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": {
+                            /** @enum {string} */
+                            code: "DURABLE_FLOW_EXPORT_UNSUPPORTED";
+                            durableSteps: {
+                                stepId: string;
+                                stepType: string;
+                            }[];
+                            error: string;
+                        };
+                    };
+                };
                 /** @description Internal server error */
                 500: {
                     headers: {
@@ -17815,6 +17864,11 @@ interface paths {
                                 durationMs: number | null;
                                 errorMessage?: string | null;
                                 estimatedCost?: string | null;
+                                /**
+                                 * @description Engine that actually executed this step ('runtime' | 'legacy'). Recorded at write time from the committed lane decision; never inferred later. Null for rows written before attribution shipped and for units that never started executing (externally executed runs carry no engine).
+                                 * @enum {string|null}
+                                 */
+                                executionEngine?: "runtime" | "legacy" | null;
                                 executionSessionId: string | null;
                                 flowId: string | null;
                                 flowVersionId: string | null;
@@ -34831,6 +34885,7 @@ interface paths {
                     type?: string;
                     search?: string;
                     name?: string;
+                    ownerId?: string;
                     distinct?: string;
                     includeFields?: string;
                     include_fields?: string;
@@ -34878,6 +34933,7 @@ interface paths {
                                 };
                                 name: string;
                                 organizationId: string | null;
+                                ownerId: string | null;
                                 productSurfaceId: string | null;
                                 schemaValid: boolean | null;
                                 type: string;
@@ -34961,6 +35017,8 @@ interface paths {
                             [key: string]: unknown;
                         };
                         name: string;
+                        /** @description Owner key for this record, stored in the indexed owner_id column and filterable via ?ownerId=. Overrides a nested metadata.ownerId. Null means no owner. */
+                        ownerId?: string | null;
                         type: string;
                     };
                 };
@@ -34989,6 +35047,7 @@ interface paths {
                             };
                             name: string;
                             organizationId: string | null;
+                            ownerId: string | null;
                             productSurfaceId: string | null;
                             schemaValid: boolean | null;
                             schemaWarnings?: {
@@ -35317,6 +35376,7 @@ interface paths {
                     type?: string;
                     search?: string;
                     name?: string;
+                    ownerId?: string;
                     distinct?: string;
                     includeFields?: string;
                     include_fields?: string;
@@ -35820,6 +35880,7 @@ interface paths {
                             };
                             name: string;
                             organizationId: string | null;
+                            ownerId: string | null;
                             productSurfaceId: string | null;
                             schemaValid: boolean | null;
                             type: string;
@@ -35901,6 +35962,8 @@ interface paths {
                             [key: string]: unknown;
                         };
                         name?: string;
+                        /** @description Reassigns the owner (indexed owner_id column, filterable via ?ownerId=). Overrides a nested metadata.ownerId. Null clears the owner; omit to leave it unchanged. */
+                        ownerId?: string | null;
                         type?: string;
                     };
                 };
@@ -35929,6 +35992,7 @@ interface paths {
                             };
                             name: string;
                             organizationId: string | null;
+                            ownerId: string | null;
                             productSurfaceId: string | null;
                             schemaValid: boolean | null;
                             schemaWarnings?: {
@@ -36228,14 +36292,23 @@ interface paths {
                         "application/json": {
                             data: {
                                 createdAt: string;
+                                estimatedCost: string | null;
+                                /**
+                                 * @description Engine that actually executed this record execution ('runtime' | 'legacy'). Recorded at write time from the committed lane decision; never inferred later. Null for rows written before attribution shipped and for units that never started executing (externally executed runs carry no engine).
+                                 * @enum {string|null}
+                                 */
+                                executionEngine?: "runtime" | "legacy" | null;
+                                executionTimeMs: number | null;
                                 flowId: string | null;
                                 flowName: string | null;
                                 id: string;
+                                modelUsed: string | null;
                                 promptId: string | null;
                                 promptName: string | null;
                                 recordId: string;
                                 result?: unknown;
                                 status: string;
+                                totalTokens: number | null;
                             }[];
                             pagination: {
                                 hasMore: boolean;
@@ -36428,6 +36501,11 @@ interface paths {
                                 durationMs: number | null;
                                 errorMessage?: string | null;
                                 estimatedCost?: string | null;
+                                /**
+                                 * @description Engine that actually executed this step ('runtime' | 'legacy'). Recorded at write time from the committed lane decision; never inferred later. Null for rows written before attribution shipped and for units that never started executing (externally executed runs carry no engine).
+                                 * @enum {string|null}
+                                 */
+                                executionEngine?: "runtime" | "legacy" | null;
                                 executionSessionId: string | null;
                                 flowId: string | null;
                                 flowVersionId: string | null;
@@ -37521,6 +37599,7 @@ interface paths {
                                 } | null;
                                 name: string;
                                 organizationId: string | null;
+                                ownerId?: string | null;
                                 productSurfaceId?: string | null;
                                 schemaValid?: boolean | null;
                                 type: string;
@@ -37687,6 +37766,7 @@ interface paths {
                                 } | null;
                                 name: string;
                                 organizationId: string | null;
+                                ownerId?: string | null;
                                 productSurfaceId?: string | null;
                                 schemaValid?: boolean | null;
                                 type: string;
@@ -37833,6 +37913,7 @@ interface paths {
                                 } | null;
                                 name: string;
                                 organizationId: string | null;
+                                ownerId?: string | null;
                                 productSurfaceId?: string | null;
                                 schemaValid?: boolean | null;
                                 type: string;
@@ -37981,6 +38062,7 @@ interface paths {
                                 } | null;
                                 name: string;
                                 organizationId: string | null;
+                                ownerId?: string | null;
                                 productSurfaceId?: string | null;
                                 schemaValid?: boolean | null;
                                 type: string;
@@ -38472,6 +38554,11 @@ interface paths {
                                 durationMs: number | null;
                                 error: string | null;
                                 executedAt: string | null;
+                                /**
+                                 * @description Engine that actually executed this record execution ('runtime' | 'legacy'). Recorded at write time from the committed lane decision; never inferred later. Null for rows written before attribution shipped and for units that never started executing (externally executed runs carry no engine).
+                                 * @enum {string|null}
+                                 */
+                                executionEngine?: "runtime" | "legacy" | null;
                                 failedAt: string | null;
                                 failedStepCount: number | null;
                                 flowId: string | null;
@@ -38659,6 +38746,11 @@ interface paths {
                                 durationMs: number | null;
                                 error: string | null;
                                 executedAt: string | null;
+                                /**
+                                 * @description Engine that actually executed this record execution ('runtime' | 'legacy'). Recorded at write time from the committed lane decision; never inferred later. Null for rows written before attribution shipped and for units that never started executing (externally executed runs carry no engine).
+                                 * @enum {string|null}
+                                 */
+                                executionEngine?: "runtime" | "legacy" | null;
                                 failedAt: string | null;
                                 failedStepCount: number | null;
                                 flowId: string | null;
@@ -45064,6 +45156,11 @@ interface components {
             cases: {
                 /** @description The saved eval case id; null when the case row was deleted or the record could not be mapped to a case. */
                 caseId: string | null;
+                /**
+                 * @description Engine that actually executed this graded case ('runtime' | 'legacy'). Recorded at write time from the committed lane decision; never inferred later. Null for rows written before attribution shipped and for units that never started executing (externally executed runs carry no engine).
+                 * @enum {string|null}
+                 */
+                executionEngine?: "runtime" | "legacy" | null;
                 name: string;
                 /** @description For a checkpoint ("saved from run") case run in next-step mode: the tool-call intent(s) the target emitted as its graded next step. An empty array means it replied with a message instead of calling a tool. Null for ordinary runs and for runs recorded before this field shipped. */
                 nextStepToolCalls: {
@@ -45255,6 +45352,7 @@ interface components {
             /** @enum {string} */
             kind: "agent" | "flow";
             maxTurns?: number;
+            resumed?: boolean;
             seq: number;
             source?: string;
             startedAt: string;
@@ -47865,6 +47963,16 @@ interface CreatePromptRequest {
 interface CreateRecordRequest {
     type: string;
     name: string;
+    /**
+     * First-class owner key (#3395) — persisted to the indexed `owner_id` column
+     * and queryable via {@link RecordListParams.ownerId}. A nested
+     * `metadata.ownerId` is still lifted into the column by the API; a top-level
+     * value here wins over it.
+     *
+     * On `records.update()` (which takes `Partial<CreateRecordRequest>`),
+     * `null` CLEARS the stored owner and omitting the field leaves it untouched.
+     */
+    ownerId?: string | null;
     metadata?: Metadata;
 }
 interface BulkEditCondition {
@@ -48267,6 +48375,7 @@ interface ListParams {
 interface RecordListParams extends ListParams {
     metadataKeys?: string;
     metadataKeysAll?: string;
+    ownerId?: string;
     minFields?: number;
     maxFields?: number;
     metadataTypes?: string;
@@ -48284,9 +48393,10 @@ interface FlowToolConfig {
     flowId?: string;
     toolId?: string;
     /**
-     * Inline flow definition. Runtime-selected agent dispatches support this with
-     * `options.useRuntimePackage: true`; hosted flow definitions currently
-     * require a `flowId`/`toolId` reference.
+     * Inline flow definition. Runtime-selected agent dispatches support this
+     * (the runtime lane is the default unless `options.useRuntimePackage: false`
+     * opts out); hosted flow definitions currently require a `flowId`/`toolId`
+     * reference.
      */
     flow?: Record<string, unknown>;
     /** Registered-flow name key for the runtime lane (`flowName ?? flowId`). */
@@ -48434,9 +48544,10 @@ interface RuntimeFlowToolConfig {
     flowId?: string;
     toolId?: string;
     /**
-     * Inline flow definition. Runtime-selected agent dispatches support this with
-     * `options.useRuntimePackage: true`; hosted flow definitions currently
-     * require a `flowId`/`toolId` reference.
+     * Inline flow definition. Runtime-selected agent dispatches support this
+     * (the runtime lane is the default unless `options.useRuntimePackage: false`
+     * opts out); hosted flow definitions currently require a `flowId`/`toolId`
+     * reference.
      */
     flow?: Record<string, unknown>;
     /** Registered-flow name key for the runtime lane (`flowName ?? flowId`). */
@@ -48676,14 +48787,24 @@ interface CreateConversationRequest {
     title?: string;
     modelId?: string;
     systemPrompt?: string;
-    ownerId?: string;
+    /**
+     * First-class owner key (#3395) — persisted to the indexed `owner_id` column
+     * and queryable via {@link ConversationListParams.ownerId}. `null` is accepted
+     * for symmetry with {@link UpdateConversationRequest} and simply means "no
+     * owner" on create.
+     */
+    ownerId?: string | null;
     metadata?: Record<string, unknown>;
 }
 interface UpdateConversationRequest {
     title?: string;
     modelId?: string;
     systemPrompt?: string;
-    ownerId?: string;
+    /**
+     * First-class owner key (#3395). `null` CLEARS the stored owner; omitting the
+     * field leaves it untouched.
+     */
+    ownerId?: string | null;
     metadata?: Record<string, unknown>;
     messages?: ConversationMessage[];
 }
@@ -54382,6 +54503,15 @@ interface AgentStartEvent extends BaseAgentEvent {
         model?: string;
         enableReflection?: boolean;
     };
+    /**
+     * `true` when this start opens the RESUME leg of a paused run (approval or
+     * client-tool continuation) rather than a new run. The runtime opens every
+     * response with a start frame; keep run-level state (turn counts, spend
+     * totals, accumulated output) across a resumed start instead of resetting.
+     * `executeWithLocalTools` already folds resumed starts away — its
+     * `onAgentStart` fires once per session.
+     */
+    resumed?: boolean;
 }
 /**
  * Agent iteration start event
@@ -54498,6 +54628,8 @@ interface AgentToolCompleteEvent extends BaseAgentEvent {
     toolName: string;
     success: boolean;
     result?: unknown;
+    /** Failure reason when `success` is false (e.g. an MCP discovery connection failure). */
+    error?: string;
     executionTime?: number;
 }
 interface AgentMediaEvent extends BaseAgentEvent {

package/dist/index.d.ts

@@ -2804,6 +2804,8 @@ interface paths {
                                 agentSpec?: unknown;
                                 cancelRequestedAt: string | null;
                                 completedAt: string | null;
+                                /** @description The conversation thread this run belongs to, so consumers can group a multi-turn conversation's runs without a per-run log query. This is the run's OWN thread, distinct from `parentConversationId` (subagent lineage, the conversation of the run that spawned it). `null` on stateless surfaces (webhook, schedule, eval, one-shot API) and on runs persisted before the column existed. */
+                                conversationId: string | null;
                                 createdAt: string;
                                 executionId: string;
                                 /** @enum {string} */
@@ -2937,6 +2939,8 @@ interface paths {
                             agentSpec?: unknown;
                             cancelRequestedAt: string | null;
                             completedAt: string | null;
+                            /** @description The conversation thread this run belongs to, so consumers can group a multi-turn conversation's runs without a per-run log query. This is the run's OWN thread, distinct from `parentConversationId` (subagent lineage, the conversation of the run that spawned it). `null` on stateless surfaces (webhook, schedule, eval, one-shot API) and on runs persisted before the column existed. */
+                            conversationId: string | null;
                             createdAt: string;
                             executionId: string;
                             /** @enum {string} */
@@ -5292,6 +5296,11 @@ interface paths {
                         "application/json": {
                             batchExecutionId: string;
                             completedAt?: string;
+                            /**
+                             * @description Run-level engine summary derived from the batch's per-record executionEngine values: 'runtime' or 'legacy' when every attributed record ran on that engine, 'mixed' when the batch spans both (e.g. a mid-flight fallback), and null when the run has no attributed records (runs recorded before attribution shipped).
+                             * @enum {string|null}
+                             */
+                            executionEngineSummary?: "runtime" | "legacy" | "mixed" | null;
                             failedRecords: number;
                             flowId: string;
                             processedRecords: number;
@@ -5587,6 +5596,11 @@ interface paths {
                                 durationMs: number | null;
                                 errorMessage?: string | null;
                                 estimatedCost?: string | null;
+                                /**
+                                 * @description Engine that actually executed this step ('runtime' | 'legacy'). Recorded at write time from the committed lane decision; never inferred later. Null for rows written before attribution shipped and for units that never started executing (externally executed runs carry no engine).
+                                 * @enum {string|null}
+                                 */
+                                executionEngine?: "runtime" | "legacy" | null;
                                 executionSessionId: string | null;
                                 flowId: string | null;
                                 flowVersionId: string | null;
@@ -6850,6 +6864,15 @@ interface paths {
                         "application/json": components["schemas"]["Error"];
                     };
                 };
+                /** @description Approval-gated execution is unsupported because Client Chat has no continuation channel that can deliver an owner-approved result back to the visitor (`APPROVAL_MODE_UNSUPPORTED`). */
+                501: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["Error"];
+                    };
+                };
             };
         };
         delete?: never;
@@ -9299,7 +9322,8 @@ interface paths {
                             [key: string]: unknown;
                         };
                         modelId?: string;
-                        ownerId?: string;
+                        /** @description Owner key for this conversation, stored in the indexed owner_id column and filterable via ?ownerId=. Overrides a nested metadata.ownerId. Null means no owner. */
+                        ownerId?: string | null;
                         systemPrompt?: string;
                         /** @default New Chat */
                         title?: string;
@@ -9543,7 +9567,8 @@ interface paths {
                             [key: string]: unknown;
                         };
                         modelId?: string;
-                        ownerId?: string;
+                        /** @description Reassigns the owner (indexed owner_id column, filterable via ?ownerId=). Overrides a nested metadata.ownerId. Null clears the owner; omit to leave it unchanged. */
+                        ownerId?: string | null;
                         systemPrompt?: string;
                         title?: string;
                     };
@@ -11089,7 +11114,7 @@ interface paths {
                                 /** @default true */
                                 createVersionOnChange?: boolean;
                             };
-                            /** @description For FLOW dispatches this compatibility field is accepted but ignored: eligible flows always use the @runtypelabs/runtime lane, while ineligible flows still fold to legacy silently. Agent dispatches still require an explicit `true` and remain subject to their separate runtime-agent rollout gate. */
+                            /** @description Compatibility execution-lane OPT-OUT. For FLOW dispatches the field is accepted but ignored: eligible flows always use the @runtypelabs/runtime lane, while ineligible flows still fold to legacy silently. For AGENT dispatches, an eligible agent now uses the @runtypelabs/runtime lane by DEFAULT when this field is omitted; only an explicit `false` forces the legacy engine. Definitions the runtime lane cannot execute faithfully still fold to legacy on their own. */
                             useRuntimePackage?: boolean;
                             versionLabel?: string;
                             versionNotes?: string;
@@ -11454,7 +11479,7 @@ interface paths {
                                 /** @default true */
                                 createVersionOnChange?: boolean;
                             };
-                            /** @description For FLOW dispatches this compatibility field is accepted but ignored: eligible flows always use the @runtypelabs/runtime lane, while ineligible flows still fold to legacy silently. Agent dispatches still require an explicit `true` and remain subject to their separate runtime-agent rollout gate. */
+                            /** @description Compatibility execution-lane OPT-OUT. For FLOW dispatches the field is accepted but ignored: eligible flows always use the @runtypelabs/runtime lane, while ineligible flows still fold to legacy silently. For AGENT dispatches, an eligible agent now uses the @runtypelabs/runtime lane by DEFAULT when this field is omitted; only an explicit `false` forces the legacy engine. Definitions the runtime lane cannot execute faithfully still fold to legacy on their own. */
                             useRuntimePackage?: boolean;
                             versionLabel?: string;
                             versionNotes?: string;
@@ -15606,6 +15631,11 @@ interface paths {
                                     errorMessage: string | null;
                                     errorStack: string | null;
                                     executedAt: string;
+                                    /**
+                                     * @description Engine that actually executed this step ('runtime' | 'legacy'). Recorded at write time from the committed lane decision; never inferred later. Null for rows written before attribution shipped and for units that never started executing (externally executed runs carry no engine).
+                                     * @enum {string|null}
+                                     */
+                                    executionEngine?: "runtime" | "legacy" | null;
                                     executionSessionId: string | null;
                                     inputVariables?: unknown;
                                     messageHistory: unknown[] | null;
@@ -17418,6 +17448,8 @@ interface paths {
          * @description **Limited preview — not yet generally available.** This endpoint is dark-launched and returns `404 Not Found` in production until GA; it is only reachable in non-production environments today.
          *
          *     Export a fully-resolved, self-contained flow definition that the @runtypelabs/runtime package can consume directly at boot. All step configs are inlined; no live DB queries are needed at execution time.
+         *
+         *     Flows containing a durable-class step (`wait-until` or `crawl`) are rejected with `422 Unprocessable Entity` (code `DURABLE_FLOW_EXPORT_UNSUPPORTED`): those steps park their pause on a Cloudflare Workflow, which cannot run inside an exported runtime artifact, so durable flows run hosted only.
          */
         get: {
             parameters: {
@@ -17490,6 +17522,23 @@ interface paths {
                         "application/json": components["schemas"]["Error"];
                     };
                 };
+                /** @description The flow contains durable-class steps and runs hosted only (code `DURABLE_FLOW_EXPORT_UNSUPPORTED`) */
+                422: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": {
+                            /** @enum {string} */
+                            code: "DURABLE_FLOW_EXPORT_UNSUPPORTED";
+                            durableSteps: {
+                                stepId: string;
+                                stepType: string;
+                            }[];
+                            error: string;
+                        };
+                    };
+                };
                 /** @description Internal server error */
                 500: {
                     headers: {
@@ -17815,6 +17864,11 @@ interface paths {
                                 durationMs: number | null;
                                 errorMessage?: string | null;
                                 estimatedCost?: string | null;
+                                /**
+                                 * @description Engine that actually executed this step ('runtime' | 'legacy'). Recorded at write time from the committed lane decision; never inferred later. Null for rows written before attribution shipped and for units that never started executing (externally executed runs carry no engine).
+                                 * @enum {string|null}
+                                 */
+                                executionEngine?: "runtime" | "legacy" | null;
                                 executionSessionId: string | null;
                                 flowId: string | null;
                                 flowVersionId: string | null;
@@ -34831,6 +34885,7 @@ interface paths {
                     type?: string;
                     search?: string;
                     name?: string;
+                    ownerId?: string;
                     distinct?: string;
                     includeFields?: string;
                     include_fields?: string;
@@ -34878,6 +34933,7 @@ interface paths {
                                 };
                                 name: string;
                                 organizationId: string | null;
+                                ownerId: string | null;
                                 productSurfaceId: string | null;
                                 schemaValid: boolean | null;
                                 type: string;
@@ -34961,6 +35017,8 @@ interface paths {
                             [key: string]: unknown;
                         };
                         name: string;
+                        /** @description Owner key for this record, stored in the indexed owner_id column and filterable via ?ownerId=. Overrides a nested metadata.ownerId. Null means no owner. */
+                        ownerId?: string | null;
                         type: string;
                     };
                 };
@@ -34989,6 +35047,7 @@ interface paths {
                             };
                             name: string;
                             organizationId: string | null;
+                            ownerId: string | null;
                             productSurfaceId: string | null;
                             schemaValid: boolean | null;
                             schemaWarnings?: {
@@ -35317,6 +35376,7 @@ interface paths {
                     type?: string;
                     search?: string;
                     name?: string;
+                    ownerId?: string;
                     distinct?: string;
                     includeFields?: string;
                     include_fields?: string;
@@ -35820,6 +35880,7 @@ interface paths {
                             };
                             name: string;
                             organizationId: string | null;
+                            ownerId: string | null;
                             productSurfaceId: string | null;
                             schemaValid: boolean | null;
                             type: string;
@@ -35901,6 +35962,8 @@ interface paths {
                             [key: string]: unknown;
                         };
                         name?: string;
+                        /** @description Reassigns the owner (indexed owner_id column, filterable via ?ownerId=). Overrides a nested metadata.ownerId. Null clears the owner; omit to leave it unchanged. */
+                        ownerId?: string | null;
                         type?: string;
                     };
                 };
@@ -35929,6 +35992,7 @@ interface paths {
                             };
                             name: string;
                             organizationId: string | null;
+                            ownerId: string | null;
                             productSurfaceId: string | null;
                             schemaValid: boolean | null;
                             schemaWarnings?: {
@@ -36228,14 +36292,23 @@ interface paths {
                         "application/json": {
                             data: {
                                 createdAt: string;
+                                estimatedCost: string | null;
+                                /**
+                                 * @description Engine that actually executed this record execution ('runtime' | 'legacy'). Recorded at write time from the committed lane decision; never inferred later. Null for rows written before attribution shipped and for units that never started executing (externally executed runs carry no engine).
+                                 * @enum {string|null}
+                                 */
+                                executionEngine?: "runtime" | "legacy" | null;
+                                executionTimeMs: number | null;
                                 flowId: string | null;
                                 flowName: string | null;
                                 id: string;
+                                modelUsed: string | null;
                                 promptId: string | null;
                                 promptName: string | null;
                                 recordId: string;
                                 result?: unknown;
                                 status: string;
+                                totalTokens: number | null;
                             }[];
                             pagination: {
                                 hasMore: boolean;
@@ -36428,6 +36501,11 @@ interface paths {
                                 durationMs: number | null;
                                 errorMessage?: string | null;
                                 estimatedCost?: string | null;
+                                /**
+                                 * @description Engine that actually executed this step ('runtime' | 'legacy'). Recorded at write time from the committed lane decision; never inferred later. Null for rows written before attribution shipped and for units that never started executing (externally executed runs carry no engine).
+                                 * @enum {string|null}
+                                 */
+                                executionEngine?: "runtime" | "legacy" | null;
                                 executionSessionId: string | null;
                                 flowId: string | null;
                                 flowVersionId: string | null;
@@ -37521,6 +37599,7 @@ interface paths {
                                 } | null;
                                 name: string;
                                 organizationId: string | null;
+                                ownerId?: string | null;
                                 productSurfaceId?: string | null;
                                 schemaValid?: boolean | null;
                                 type: string;
@@ -37687,6 +37766,7 @@ interface paths {
                                 } | null;
                                 name: string;
                                 organizationId: string | null;
+                                ownerId?: string | null;
                                 productSurfaceId?: string | null;
                                 schemaValid?: boolean | null;
                                 type: string;
@@ -37833,6 +37913,7 @@ interface paths {
                                 } | null;
                                 name: string;
                                 organizationId: string | null;
+                                ownerId?: string | null;
                                 productSurfaceId?: string | null;
                                 schemaValid?: boolean | null;
                                 type: string;
@@ -37981,6 +38062,7 @@ interface paths {
                                 } | null;
                                 name: string;
                                 organizationId: string | null;
+                                ownerId?: string | null;
                                 productSurfaceId?: string | null;
                                 schemaValid?: boolean | null;
                                 type: string;
@@ -38472,6 +38554,11 @@ interface paths {
                                 durationMs: number | null;
                                 error: string | null;
                                 executedAt: string | null;
+                                /**
+                                 * @description Engine that actually executed this record execution ('runtime' | 'legacy'). Recorded at write time from the committed lane decision; never inferred later. Null for rows written before attribution shipped and for units that never started executing (externally executed runs carry no engine).
+                                 * @enum {string|null}
+                                 */
+                                executionEngine?: "runtime" | "legacy" | null;
                                 failedAt: string | null;
                                 failedStepCount: number | null;
                                 flowId: string | null;
@@ -38659,6 +38746,11 @@ interface paths {
                                 durationMs: number | null;
                                 error: string | null;
                                 executedAt: string | null;
+                                /**
+                                 * @description Engine that actually executed this record execution ('runtime' | 'legacy'). Recorded at write time from the committed lane decision; never inferred later. Null for rows written before attribution shipped and for units that never started executing (externally executed runs carry no engine).
+                                 * @enum {string|null}
+                                 */
+                                executionEngine?: "runtime" | "legacy" | null;
                                 failedAt: string | null;
                                 failedStepCount: number | null;
                                 flowId: string | null;
@@ -45064,6 +45156,11 @@ interface components {
             cases: {
                 /** @description The saved eval case id; null when the case row was deleted or the record could not be mapped to a case. */
                 caseId: string | null;
+                /**
+                 * @description Engine that actually executed this graded case ('runtime' | 'legacy'). Recorded at write time from the committed lane decision; never inferred later. Null for rows written before attribution shipped and for units that never started executing (externally executed runs carry no engine).
+                 * @enum {string|null}
+                 */
+                executionEngine?: "runtime" | "legacy" | null;
                 name: string;
                 /** @description For a checkpoint ("saved from run") case run in next-step mode: the tool-call intent(s) the target emitted as its graded next step. An empty array means it replied with a message instead of calling a tool. Null for ordinary runs and for runs recorded before this field shipped. */
                 nextStepToolCalls: {
@@ -45255,6 +45352,7 @@ interface components {
             /** @enum {string} */
             kind: "agent" | "flow";
             maxTurns?: number;
+            resumed?: boolean;
             seq: number;
             source?: string;
             startedAt: string;
@@ -47865,6 +47963,16 @@ interface CreatePromptRequest {
 interface CreateRecordRequest {
     type: string;
     name: string;
+    /**
+     * First-class owner key (#3395) — persisted to the indexed `owner_id` column
+     * and queryable via {@link RecordListParams.ownerId}. A nested
+     * `metadata.ownerId` is still lifted into the column by the API; a top-level
+     * value here wins over it.
+     *
+     * On `records.update()` (which takes `Partial<CreateRecordRequest>`),
+     * `null` CLEARS the stored owner and omitting the field leaves it untouched.
+     */
+    ownerId?: string | null;
     metadata?: Metadata;
 }
 interface BulkEditCondition {
@@ -48267,6 +48375,7 @@ interface ListParams {
 interface RecordListParams extends ListParams {
     metadataKeys?: string;
     metadataKeysAll?: string;
+    ownerId?: string;
     minFields?: number;
     maxFields?: number;
     metadataTypes?: string;
@@ -48284,9 +48393,10 @@ interface FlowToolConfig {
     flowId?: string;
     toolId?: string;
     /**
-     * Inline flow definition. Runtime-selected agent dispatches support this with
-     * `options.useRuntimePackage: true`; hosted flow definitions currently
-     * require a `flowId`/`toolId` reference.
+     * Inline flow definition. Runtime-selected agent dispatches support this
+     * (the runtime lane is the default unless `options.useRuntimePackage: false`
+     * opts out); hosted flow definitions currently require a `flowId`/`toolId`
+     * reference.
      */
     flow?: Record<string, unknown>;
     /** Registered-flow name key for the runtime lane (`flowName ?? flowId`). */
@@ -48434,9 +48544,10 @@ interface RuntimeFlowToolConfig {
     flowId?: string;
     toolId?: string;
     /**
-     * Inline flow definition. Runtime-selected agent dispatches support this with
-     * `options.useRuntimePackage: true`; hosted flow definitions currently
-     * require a `flowId`/`toolId` reference.
+     * Inline flow definition. Runtime-selected agent dispatches support this
+     * (the runtime lane is the default unless `options.useRuntimePackage: false`
+     * opts out); hosted flow definitions currently require a `flowId`/`toolId`
+     * reference.
      */
     flow?: Record<string, unknown>;
     /** Registered-flow name key for the runtime lane (`flowName ?? flowId`). */
@@ -48676,14 +48787,24 @@ interface CreateConversationRequest {
     title?: string;
     modelId?: string;
     systemPrompt?: string;
-    ownerId?: string;
+    /**
+     * First-class owner key (#3395) — persisted to the indexed `owner_id` column
+     * and queryable via {@link ConversationListParams.ownerId}. `null` is accepted
+     * for symmetry with {@link UpdateConversationRequest} and simply means "no
+     * owner" on create.
+     */
+    ownerId?: string | null;
     metadata?: Record<string, unknown>;
 }
 interface UpdateConversationRequest {
     title?: string;
     modelId?: string;
     systemPrompt?: string;
-    ownerId?: string;
+    /**
+     * First-class owner key (#3395). `null` CLEARS the stored owner; omitting the
+     * field leaves it untouched.
+     */
+    ownerId?: string | null;
     metadata?: Record<string, unknown>;
     messages?: ConversationMessage[];
 }
@@ -54382,6 +54503,15 @@ interface AgentStartEvent extends BaseAgentEvent {
         model?: string;
         enableReflection?: boolean;
     };
+    /**
+     * `true` when this start opens the RESUME leg of a paused run (approval or
+     * client-tool continuation) rather than a new run. The runtime opens every
+     * response with a start frame; keep run-level state (turn counts, spend
+     * totals, accumulated output) across a resumed start instead of resetting.
+     * `executeWithLocalTools` already folds resumed starts away — its
+     * `onAgentStart` fires once per session.
+     */
+    resumed?: boolean;
 }
 /**
  * Agent iteration start event
@@ -54498,6 +54628,8 @@ interface AgentToolCompleteEvent extends BaseAgentEvent {
     toolName: string;
     success: boolean;
     result?: unknown;
+    /** Failure reason when `success` is false (e.g. an MCP discovery connection failure). */
+    error?: string;
     executionTime?: number;
 }
 interface AgentMediaEvent extends BaseAgentEvent {

package/dist/index.mjs

@@ -216,7 +216,8 @@ function createAgentEventTranslator() {
             agentName: data.agentName,
             maxTurns: data.maxTurns,
             startedAt: data.startedAt,
-            config: data.config
+            config: data.config,
+            resumed: data.resumed
           })
         ];
       case "turn_start":
@@ -354,6 +355,10 @@ function createAgentEventTranslator() {
             toolName: data.toolName,
             success: data.success,
             result: data.result,
+            // A failure's reason travels on the frame's `error` field — the
+            // only carrier for complete-only failures like the MCP discovery
+            // connection pseudo-tool, which no longer emits an `error` frame.
+            error: str(data.error),
             executionTime: data.executionTime
           })
         ];
@@ -6249,7 +6254,7 @@ var Runtype = class {
 
 // src/version.ts
 var FALLBACK_VERSION = "0.0.0";
-var SDK_VERSION = "9.0.0".length > 0 ? "9.0.0" : FALLBACK_VERSION;
+var SDK_VERSION = "9.1.1".length > 0 ? "9.1.1" : FALLBACK_VERSION;
 var RUNTYPE_CLIENT_KIND = "sdk";
 var SDK_USER_AGENT = `runtype-sdk/${SDK_VERSION} (typescript)`;
 
@@ -9817,7 +9822,7 @@ var _AgentsEndpoint = class _AgentsEndpoint {
           ...callbacks,
           onAgentStart: (event) => {
             lastSeenExecutionId = event.executionId;
-            callbacks?.onAgentStart?.(event);
+            if (!event.resumed) callbacks?.onAgentStart?.(event);
           },
           onTurnDelta: (event) => {
             if (event.contentType === "text") {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@runtypelabs/sdk",
-  "version": "9.0.0",
+  "version": "9.1.1",
   "type": "module",
   "description": "TypeScript SDK for the Runtype API with fluent methods. Use it to quickly realize AI products, agents, and workflows.",
   "main": "dist/index.cjs",