@runtypelabs/sdk 9.0.0 → 9.1.0

package/dist/index.cjs

@@ -6437,7 +6437,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.0".length > 0 ? "9.1.0" : FALLBACK_VERSION;
 var RUNTYPE_CLIENT_KIND = "sdk";
 var SDK_USER_AGENT = `runtype-sdk/${SDK_VERSION} (typescript)`;
 

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;
@@ -17815,6 +17845,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 +34866,7 @@ interface paths {
                     type?: string;
                     search?: string;
                     name?: string;
+                    ownerId?: string;
                     distinct?: string;
                     includeFields?: string;
                     include_fields?: string;
@@ -34878,6 +34914,7 @@ interface paths {
                                 };
                                 name: string;
                                 organizationId: string | null;
+                                ownerId: string | null;
                                 productSurfaceId: string | null;
                                 schemaValid: boolean | null;
                                 type: string;
@@ -34961,6 +34998,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 +35028,7 @@ interface paths {
                             };
                             name: string;
                             organizationId: string | null;
+                            ownerId: string | null;
                             productSurfaceId: string | null;
                             schemaValid: boolean | null;
                             schemaWarnings?: {
@@ -35317,6 +35357,7 @@ interface paths {
                     type?: string;
                     search?: string;
                     name?: string;
+                    ownerId?: string;
                     distinct?: string;
                     includeFields?: string;
                     include_fields?: string;
@@ -35820,6 +35861,7 @@ interface paths {
                             };
                             name: string;
                             organizationId: string | null;
+                            ownerId: string | null;
                             productSurfaceId: string | null;
                             schemaValid: boolean | null;
                             type: string;
@@ -35901,6 +35943,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 +35973,7 @@ interface paths {
                             };
                             name: string;
                             organizationId: string | null;
+                            ownerId: string | null;
                             productSurfaceId: string | null;
                             schemaValid: boolean | null;
                             schemaWarnings?: {
@@ -36228,14 +36273,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 +36482,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 +37580,7 @@ interface paths {
                                 } | null;
                                 name: string;
                                 organizationId: string | null;
+                                ownerId?: string | null;
                                 productSurfaceId?: string | null;
                                 schemaValid?: boolean | null;
                                 type: string;
@@ -37687,6 +37747,7 @@ interface paths {
                                 } | null;
                                 name: string;
                                 organizationId: string | null;
+                                ownerId?: string | null;
                                 productSurfaceId?: string | null;
                                 schemaValid?: boolean | null;
                                 type: string;
@@ -37833,6 +37894,7 @@ interface paths {
                                 } | null;
                                 name: string;
                                 organizationId: string | null;
+                                ownerId?: string | null;
                                 productSurfaceId?: string | null;
                                 schemaValid?: boolean | null;
                                 type: string;
@@ -37981,6 +38043,7 @@ interface paths {
                                 } | null;
                                 name: string;
                                 organizationId: string | null;
+                                ownerId?: string | null;
                                 productSurfaceId?: string | null;
                                 schemaValid?: boolean | null;
                                 type: string;
@@ -38472,6 +38535,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 +38727,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 +45137,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: {
@@ -47865,6 +47943,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 +48355,7 @@ interface ListParams {
 interface RecordListParams extends ListParams {
     metadataKeys?: string;
     metadataKeysAll?: string;
+    ownerId?: string;
     minFields?: number;
     maxFields?: number;
     metadataTypes?: string;
@@ -48284,9 +48373,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 +48524,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 +48767,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[];
 }

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;
@@ -17815,6 +17845,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 +34866,7 @@ interface paths {
                     type?: string;
                     search?: string;
                     name?: string;
+                    ownerId?: string;
                     distinct?: string;
                     includeFields?: string;
                     include_fields?: string;
@@ -34878,6 +34914,7 @@ interface paths {
                                 };
                                 name: string;
                                 organizationId: string | null;
+                                ownerId: string | null;
                                 productSurfaceId: string | null;
                                 schemaValid: boolean | null;
                                 type: string;
@@ -34961,6 +34998,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 +35028,7 @@ interface paths {
                             };
                             name: string;
                             organizationId: string | null;
+                            ownerId: string | null;
                             productSurfaceId: string | null;
                             schemaValid: boolean | null;
                             schemaWarnings?: {
@@ -35317,6 +35357,7 @@ interface paths {
                     type?: string;
                     search?: string;
                     name?: string;
+                    ownerId?: string;
                     distinct?: string;
                     includeFields?: string;
                     include_fields?: string;
@@ -35820,6 +35861,7 @@ interface paths {
                             };
                             name: string;
                             organizationId: string | null;
+                            ownerId: string | null;
                             productSurfaceId: string | null;
                             schemaValid: boolean | null;
                             type: string;
@@ -35901,6 +35943,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 +35973,7 @@ interface paths {
                             };
                             name: string;
                             organizationId: string | null;
+                            ownerId: string | null;
                             productSurfaceId: string | null;
                             schemaValid: boolean | null;
                             schemaWarnings?: {
@@ -36228,14 +36273,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 +36482,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 +37580,7 @@ interface paths {
                                 } | null;
                                 name: string;
                                 organizationId: string | null;
+                                ownerId?: string | null;
                                 productSurfaceId?: string | null;
                                 schemaValid?: boolean | null;
                                 type: string;
@@ -37687,6 +37747,7 @@ interface paths {
                                 } | null;
                                 name: string;
                                 organizationId: string | null;
+                                ownerId?: string | null;
                                 productSurfaceId?: string | null;
                                 schemaValid?: boolean | null;
                                 type: string;
@@ -37833,6 +37894,7 @@ interface paths {
                                 } | null;
                                 name: string;
                                 organizationId: string | null;
+                                ownerId?: string | null;
                                 productSurfaceId?: string | null;
                                 schemaValid?: boolean | null;
                                 type: string;
@@ -37981,6 +38043,7 @@ interface paths {
                                 } | null;
                                 name: string;
                                 organizationId: string | null;
+                                ownerId?: string | null;
                                 productSurfaceId?: string | null;
                                 schemaValid?: boolean | null;
                                 type: string;
@@ -38472,6 +38535,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 +38727,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 +45137,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: {
@@ -47865,6 +47943,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 +48355,7 @@ interface ListParams {
 interface RecordListParams extends ListParams {
     metadataKeys?: string;
     metadataKeysAll?: string;
+    ownerId?: string;
     minFields?: number;
     maxFields?: number;
     metadataTypes?: string;
@@ -48284,9 +48373,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 +48524,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 +48767,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[];
 }

package/dist/index.mjs

@@ -6249,7 +6249,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.0".length > 0 ? "9.1.0" : FALLBACK_VERSION;
 var RUNTYPE_CLIENT_KIND = "sdk";
 var SDK_USER_AGENT = `runtype-sdk/${SDK_VERSION} (typescript)`;
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@runtypelabs/sdk",
-  "version": "9.0.0",
+  "version": "9.1.0",
   "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",