@runtypelabs/sdk 10.1.1 → 10.1.4

package/dist/index.cjs

@@ -13854,7 +13854,10 @@ var Runtype = class {
   }
   /**
    * Runs namespace - the one list of agent and flow runs, read from the span
-   * store. Includes runs dispatched with `storeResults: false` as `test: true`.
+   * store. Each row states two separate facts: `origin` (who dispatched, from
+   * the caller's principal; `test` is its deprecated alias) and `storeResults`
+   * (whether the transcript was kept). A run that wrote no control-plane row
+   * is still listed.
    *
    * @example
    * ```typescript
@@ -14146,7 +14149,7 @@ function transformQueryParams(params) {
 
 // src/version.ts
 var FALLBACK_VERSION = "0.0.0";
-var SDK_VERSION = "10.1.1".length > 0 ? "10.1.1" : FALLBACK_VERSION;
+var SDK_VERSION = "10.1.4".length > 0 ? "10.1.4" : FALLBACK_VERSION;
 var RUNTYPE_CLIENT_KIND = "sdk";
 var SDK_USER_AGENT = `runtype-sdk/${SDK_VERSION} (typescript)`;
 

package/dist/index.d.cts

@@ -25206,6 +25206,8 @@ interface paths {
                     content: {
                         "application/json": {
                             data: {
+                                /** @description True when the historical segment was served by the flat fallback plan because the deduplicating one was rejected, so a re-sent delivery can appear more than once. Absent on healthy responses. */
+                                dedupeFallback?: boolean;
                                 /** @description True when part of the window could not be read, so entries may be missing. Evicted ordinary rows are recovered from R2 when old enough; receipt-backed recovery remains degraded when source time cannot prove ingestion. Absent on healthy responses. */
                                 degraded?: boolean;
                                 entries: {
@@ -25494,6 +25496,8 @@ interface paths {
                                 byType: {
                                     [key: string]: number;
                                 };
+                                /** @description True when counts came from the flat fallback plan because the deduplicating one was rejected, so a re-sent delivery can be counted more than once. Such a response is never cached. Absent on healthy responses. */
+                                dedupeFallback?: boolean;
                                 /** @description True when part of the window could not be read, so counts may be partial. Evicted ordinary rows are counted from R2 when old enough; receipt-backed recovery remains degraded when source time cannot prove ingestion. Absent on healthy responses, which are the only ones cached. */
                                 degraded?: boolean;
                                 histogram: {
@@ -30820,8 +30824,12 @@ interface paths {
                                         fidelityTier: string | null;
                                         /** @description Flow that ran. */
                                         flowId: string | null;
+                                        /** @description True when the dispatch carried a complete inline agent definition (name and model) beside or instead of an agentId, so the run executed that inline config and no stored version; such a row stamps no agentVersionId. False when the run executed the saved definition by reference. NULL when the header states nothing: a flow run, a lane that resolves no agent definition, or a row that predates the field. */
+                                        inlineDefinition: boolean | null;
                                         /** @description Messages the run started from. Absent means the overlay did not answer, which is not false and not null. */
                                         inputMessages?: unknown;
+                                        /** @description The run's first user message, secret-scrubbed and cut to 160 characters, so a list can say what a run was asked to do without reading content. Absent means no input text is recorded for this run, which is not an empty message: the span store holds no run-level input at all, so a run with no control-plane row (a flow leg, a storeResults:false run) has none. */
+                                        inputPreview?: string | null;
                                         /** @description Input tokens reported. */
                                         inputTokens: number | null;
                                         /** @description Loop iterations from the terminal frame. */
@@ -30833,6 +30841,11 @@ interface paths {
                                         kind: "agent" | "flow";
                                         /** @description Last heartbeat. Absent means the overlay did not answer, which is not false and not null. */
                                         lastHeartbeatAt?: string | null;
+                                        /**
+                                         * @description Where the run was dispatched from, taken from the caller's authenticated principal and never from a request field: dashboard for a Clerk session, api for a management API key, internal for a Runtype worker. NULL means the header states nothing about it, which is not "unknown caller": headers written before this field shipped, lanes that never see an auth principal, and every backfilled row carry no origin stamp.
+                                         * @enum {string|null}
+                                         */
+                                        origin: "dashboard" | "api" | "internal" | null;
                                         /** @description Framework identity the producer reported, for a versionless run group. Absent means the overlay did not answer, which is not false and not null. */
                                         otelProducer?: unknown;
                                         /** @description Output tokens reported. */
@@ -30869,11 +30882,16 @@ interface paths {
                                         status: "queued" | "running" | "awaiting" | "completed" | "failed" | "cancelled";
                                         /** @description Stop reason from the terminal frame. */
                                         stopReason?: string | null;
+                                        /** @description The persistence posture the dispatch declared. FALSE means the run wrote no control-plane row, no journal outputs and no span content, so a surface that reports a missing transcript keys on this and never on origin. NULL means the header states nothing, which is not "true": a lane that takes no such flag carries no stamp, and an ingested (OTLP) run declared none. A row served from the legacy control-plane lane answers true, because that row exists only when the run stored. */
+                                        storeResults: boolean | null;
                                         /** @description Product surface that entered this run. */
                                         surfaceId: string | null;
                                         /** @description Surface family (api, chat, webhook, schedule, ...). */
                                         surfaceType: string | null;
-                                        /** @description True when the run was dispatched with storeResults: false, so it has no control-plane row and no overlay. NULL means the header states nothing about it, which is not false: headers written before this field shipped, and lanes that take no such flag, carry no dispatch stamp and are never backfilled. */
+                                        /**
+                                         * @deprecated
+                                         * @description DEPRECATED: a derived alias of origin, kept for one release — read origin instead. True when the run came from the dashboard, i.e. origin === "dashboard"; NULL exactly when origin is NULL. It is never derived from storeResults, which defaults to false across the whole flow lane and which an API caller sets for its own privacy reasons: reading it as "test" labelled production runs as tests. A run whose header predates origin therefore reads NULL rather than claiming either answer.
+                                         */
                                         test: boolean | null;
                                         /** @description Metered cost as a decimal string. */
                                         totalCost: string | null;
@@ -40041,7 +40059,7 @@ interface paths {
         };
         /**
          * List runs
-         * @description Every agent and flow run in the span store, newest start first. A run dispatched with `storeResults: false` is listed with `test: true` rather than being invisible. `overlay=live` adds live control-plane fields; the overlay never adds, drops or reorders a row. Returns 404 when run reads are not enabled for the organization.
+         * @description Every agent and flow run in the span store, newest start first, including runs that write no control-plane row. Each row carries `origin` (dashboard | api | internal | null), read from the caller's authenticated principal, and `test` as its derived alias for `origin === "dashboard"`; both are null when the header states nothing. `overlay=live` adds live control-plane fields; the overlay never adds, drops or reorders a row. Returns 404 with `code: "run_history_unavailable"` when neither plane can serve the page, which a client renders as "no run history here" rather than as a failed read.
          */
         get: {
             parameters: {
@@ -40074,7 +40092,7 @@ interface paths {
                     from?: string;
                     /** @description Window end (ISO 8601). Defaults to now. */
                     to?: string;
-                    /** @description full (the default) returns every field. compact omits exactly these 14: stopReason, iterations, agentVersionId, agentVersionLabel, agentVersionNumber, agentTargetResolution, otelProducer, lastHeartbeatAt, expiresAt, cancelRequestedAt, progress, pendingApproval, budgetExhausted and inputMessages. The status is still overlay-corrected on a compact page; only the fields differ. */
+                    /** @description full (the default) returns every field. compact omits exactly these 15: stopReason, iterations, inputPreview, agentVersionId, agentVersionLabel, agentVersionNumber, agentTargetResolution, otelProducer, lastHeartbeatAt, expiresAt, cancelRequestedAt, progress, pendingApproval, budgetExhausted and inputMessages. The status is still overlay-corrected on a compact page; only the fields differ. */
                     view?: "compact" | "full";
                     /** @description live adds control-plane fields; defaults to live for a session, none for an API key. */
                     overlay?: "live" | "none";
@@ -40138,13 +40156,20 @@ interface paths {
                         "application/json": components["schemas"]["Error"];
                     };
                 };
-                /** @description Run reads are not enabled for this organization */
+                /** @description No plane can answer: store run reads are off for this organization and the request names a predicate the control plane cannot express */
                 404: {
                     headers: {
                         [name: string]: unknown;
                     };
                     content: {
-                        "application/json": components["schemas"]["Error"];
+                        "application/json": {
+                            /**
+                             * @description Neither plane can serve this page, so the caller shows "no run history" rather than a failed read. Matching on the sentence is never the contract.
+                             * @enum {string}
+                             */
+                            code: "run_history_unavailable";
+                            error: string;
+                        };
                     };
                 };
                 /** @description Internal server error */
@@ -40182,7 +40207,7 @@ interface paths {
                 query?: {
                     /** @description live adds control-plane fields; defaults to live for a session, none for an API key. */
                     overlay?: "live" | "none";
-                    /** @description full (the default) returns every field. compact omits exactly these 14: stopReason, iterations, agentVersionId, agentVersionLabel, agentVersionNumber, agentTargetResolution, otelProducer, lastHeartbeatAt, expiresAt, cancelRequestedAt, progress, pendingApproval, budgetExhausted and inputMessages. The status is still overlay-corrected on a compact page; only the fields differ. */
+                    /** @description full (the default) returns every field. compact omits exactly these 15: stopReason, iterations, inputPreview, agentVersionId, agentVersionLabel, agentVersionNumber, agentTargetResolution, otelProducer, lastHeartbeatAt, expiresAt, cancelRequestedAt, progress, pendingApproval, budgetExhausted and inputMessages. The status is still overlay-corrected on a compact page; only the fields differ. */
                     view?: "compact" | "full";
                 };
                 header?: never;
@@ -50949,8 +50974,12 @@ interface components {
             fidelityTier: string | null;
             /** @description Flow that ran. */
             flowId: string | null;
+            /** @description True when the dispatch carried a complete inline agent definition (name and model) beside or instead of an agentId, so the run executed that inline config and no stored version; such a row stamps no agentVersionId. False when the run executed the saved definition by reference. NULL when the header states nothing: a flow run, a lane that resolves no agent definition, or a row that predates the field. */
+            inlineDefinition: boolean | null;
             /** @description Messages the run started from. Absent means the overlay did not answer, which is not false and not null. */
             inputMessages?: unknown;
+            /** @description The run's first user message, secret-scrubbed and cut to 160 characters, so a list can say what a run was asked to do without reading content. Absent means no input text is recorded for this run, which is not an empty message: the span store holds no run-level input at all, so a run with no control-plane row (a flow leg, a storeResults:false run) has none. */
+            inputPreview?: string | null;
             /** @description Input tokens reported. */
             inputTokens: number | null;
             /** @description Loop iterations from the terminal frame. */
@@ -50962,6 +50991,11 @@ interface components {
             kind: "agent" | "flow";
             /** @description Last heartbeat. Absent means the overlay did not answer, which is not false and not null. */
             lastHeartbeatAt?: string | null;
+            /**
+             * @description Where the run was dispatched from, taken from the caller's authenticated principal and never from a request field: dashboard for a Clerk session, api for a management API key, internal for a Runtype worker. NULL means the header states nothing about it, which is not "unknown caller": headers written before this field shipped, lanes that never see an auth principal, and every backfilled row carry no origin stamp.
+             * @enum {string|null}
+             */
+            origin: "dashboard" | "api" | "internal" | null;
             /** @description Framework identity the producer reported, for a versionless run group. Absent means the overlay did not answer, which is not false and not null. */
             otelProducer?: unknown;
             /** @description Output tokens reported. */
@@ -50998,11 +51032,16 @@ interface components {
             status: "queued" | "running" | "awaiting" | "completed" | "failed" | "cancelled";
             /** @description Stop reason from the terminal frame. */
             stopReason?: string | null;
+            /** @description The persistence posture the dispatch declared. FALSE means the run wrote no control-plane row, no journal outputs and no span content, so a surface that reports a missing transcript keys on this and never on origin. NULL means the header states nothing, which is not "true": a lane that takes no such flag carries no stamp, and an ingested (OTLP) run declared none. A row served from the legacy control-plane lane answers true, because that row exists only when the run stored. */
+            storeResults: boolean | null;
             /** @description Product surface that entered this run. */
             surfaceId: string | null;
             /** @description Surface family (api, chat, webhook, schedule, ...). */
             surfaceType: string | null;
-            /** @description True when the run was dispatched with storeResults: false, so it has no control-plane row and no overlay. NULL means the header states nothing about it, which is not false: headers written before this field shipped, and lanes that take no such flag, carry no dispatch stamp and are never backfilled. */
+            /**
+             * @deprecated
+             * @description DEPRECATED: a derived alias of origin, kept for one release — read origin instead. True when the run came from the dashboard, i.e. origin === "dashboard"; NULL exactly when origin is NULL. It is never derived from storeResults, which defaults to false across the whole flow lane and which an API caller sets for its own privacy reasons: reading it as "test" labelled production runs as tests. A run whose header predates origin therefore reads NULL rather than claiming either answer.
+             */
             test: boolean | null;
             /** @description Metered cost as a decimal string. */
             totalCost: string | null;
@@ -57898,13 +57937,39 @@ interface RunListRow {
     totalCost: string | null;
     selfReportedCost: string | null;
     /**
-     * True when the run was dispatched with `storeResults: false`, such as an
-     * editor test. NULL means the header states nothing about it, which is not
-     * `false`: headers written before the field shipped carry no dispatch stamp.
+     * Where the run was dispatched from, taken from the caller's authenticated
+     * principal and never from a request field. NULL means the header states
+     * nothing about it: a lane that sees no principal, or a backfilled row.
+     */
+    origin: 'dashboard' | 'api' | 'internal' | null;
+    /**
+     * The persistence posture the dispatch declared. `false` means the run kept no
+     * control-plane row, no journal outputs and no span content, so a surface
+     * reporting a missing transcript reads this and never `origin`.
+     */
+    storeResults: boolean | null;
+    /**
+     * True when the dispatch carried a complete inline definition, so the run
+     * executed that config and stamps no `agentVersionId`. False for a run of the
+     * saved definition by reference. NULL when the header states nothing.
+     */
+    inlineDefinition: boolean | null;
+    /**
+     * True when the run came from the dashboard (`origin === 'dashboard'`), such
+     * as an editor test.
+     * @deprecated Derived alias of `origin`; read `origin` instead. Kept for one
+     * release. NULL exactly when `origin` is NULL, including on a run whose header
+     * predates the field.
      */
     test: boolean | null;
     stopReason?: string | null;
     iterations?: number | null;
+    /**
+     * The run's first user message, secret-scrubbed and bounded. Absent means no
+     * input text is recorded for the run, which is not an empty message: a run
+     * with no control-plane row carries none.
+     */
+    inputPreview?: string | null;
     /** Overlay fields. Absent means the overlay did not answer, never `false`. */
     agentVersionId?: string | null;
     agentVersionLabel?: string | null;
@@ -57959,8 +58024,8 @@ interface RunListResponse {
 }
 /**
  * Read-only namespace over `/v1/runs`, the one list of agent and flow runs.
- * A run dispatched with `storeResults: false` is listed with `test: true`
- * rather than being absent.
+ * A dashboard editor test is listed with `origin: 'dashboard'` (and its `test`
+ * alias) rather than being absent.
  */
 declare class RunsNamespace {
     private readonly getClient;
@@ -58931,7 +58996,10 @@ declare class Runtype {
     static get executions(): ExecutionsNamespace;
     /**
      * Runs namespace - the one list of agent and flow runs, read from the span
-     * store. Includes runs dispatched with `storeResults: false` as `test: true`.
+     * store. Each row states two separate facts: `origin` (who dispatched, from
+     * the caller's principal; `test` is its deprecated alias) and `storeResults`
+     * (whether the transcript was kept). A run that wrote no control-plane row
+     * is still listed.
      *
      * @example
      * ```typescript

package/dist/index.d.ts

@@ -25206,6 +25206,8 @@ interface paths {
                     content: {
                         "application/json": {
                             data: {
+                                /** @description True when the historical segment was served by the flat fallback plan because the deduplicating one was rejected, so a re-sent delivery can appear more than once. Absent on healthy responses. */
+                                dedupeFallback?: boolean;
                                 /** @description True when part of the window could not be read, so entries may be missing. Evicted ordinary rows are recovered from R2 when old enough; receipt-backed recovery remains degraded when source time cannot prove ingestion. Absent on healthy responses. */
                                 degraded?: boolean;
                                 entries: {
@@ -25494,6 +25496,8 @@ interface paths {
                                 byType: {
                                     [key: string]: number;
                                 };
+                                /** @description True when counts came from the flat fallback plan because the deduplicating one was rejected, so a re-sent delivery can be counted more than once. Such a response is never cached. Absent on healthy responses. */
+                                dedupeFallback?: boolean;
                                 /** @description True when part of the window could not be read, so counts may be partial. Evicted ordinary rows are counted from R2 when old enough; receipt-backed recovery remains degraded when source time cannot prove ingestion. Absent on healthy responses, which are the only ones cached. */
                                 degraded?: boolean;
                                 histogram: {
@@ -30820,8 +30824,12 @@ interface paths {
                                         fidelityTier: string | null;
                                         /** @description Flow that ran. */
                                         flowId: string | null;
+                                        /** @description True when the dispatch carried a complete inline agent definition (name and model) beside or instead of an agentId, so the run executed that inline config and no stored version; such a row stamps no agentVersionId. False when the run executed the saved definition by reference. NULL when the header states nothing: a flow run, a lane that resolves no agent definition, or a row that predates the field. */
+                                        inlineDefinition: boolean | null;
                                         /** @description Messages the run started from. Absent means the overlay did not answer, which is not false and not null. */
                                         inputMessages?: unknown;
+                                        /** @description The run's first user message, secret-scrubbed and cut to 160 characters, so a list can say what a run was asked to do without reading content. Absent means no input text is recorded for this run, which is not an empty message: the span store holds no run-level input at all, so a run with no control-plane row (a flow leg, a storeResults:false run) has none. */
+                                        inputPreview?: string | null;
                                         /** @description Input tokens reported. */
                                         inputTokens: number | null;
                                         /** @description Loop iterations from the terminal frame. */
@@ -30833,6 +30841,11 @@ interface paths {
                                         kind: "agent" | "flow";
                                         /** @description Last heartbeat. Absent means the overlay did not answer, which is not false and not null. */
                                         lastHeartbeatAt?: string | null;
+                                        /**
+                                         * @description Where the run was dispatched from, taken from the caller's authenticated principal and never from a request field: dashboard for a Clerk session, api for a management API key, internal for a Runtype worker. NULL means the header states nothing about it, which is not "unknown caller": headers written before this field shipped, lanes that never see an auth principal, and every backfilled row carry no origin stamp.
+                                         * @enum {string|null}
+                                         */
+                                        origin: "dashboard" | "api" | "internal" | null;
                                         /** @description Framework identity the producer reported, for a versionless run group. Absent means the overlay did not answer, which is not false and not null. */
                                         otelProducer?: unknown;
                                         /** @description Output tokens reported. */
@@ -30869,11 +30882,16 @@ interface paths {
                                         status: "queued" | "running" | "awaiting" | "completed" | "failed" | "cancelled";
                                         /** @description Stop reason from the terminal frame. */
                                         stopReason?: string | null;
+                                        /** @description The persistence posture the dispatch declared. FALSE means the run wrote no control-plane row, no journal outputs and no span content, so a surface that reports a missing transcript keys on this and never on origin. NULL means the header states nothing, which is not "true": a lane that takes no such flag carries no stamp, and an ingested (OTLP) run declared none. A row served from the legacy control-plane lane answers true, because that row exists only when the run stored. */
+                                        storeResults: boolean | null;
                                         /** @description Product surface that entered this run. */
                                         surfaceId: string | null;
                                         /** @description Surface family (api, chat, webhook, schedule, ...). */
                                         surfaceType: string | null;
-                                        /** @description True when the run was dispatched with storeResults: false, so it has no control-plane row and no overlay. NULL means the header states nothing about it, which is not false: headers written before this field shipped, and lanes that take no such flag, carry no dispatch stamp and are never backfilled. */
+                                        /**
+                                         * @deprecated
+                                         * @description DEPRECATED: a derived alias of origin, kept for one release — read origin instead. True when the run came from the dashboard, i.e. origin === "dashboard"; NULL exactly when origin is NULL. It is never derived from storeResults, which defaults to false across the whole flow lane and which an API caller sets for its own privacy reasons: reading it as "test" labelled production runs as tests. A run whose header predates origin therefore reads NULL rather than claiming either answer.
+                                         */
                                         test: boolean | null;
                                         /** @description Metered cost as a decimal string. */
                                         totalCost: string | null;
@@ -40041,7 +40059,7 @@ interface paths {
         };
         /**
          * List runs
-         * @description Every agent and flow run in the span store, newest start first. A run dispatched with `storeResults: false` is listed with `test: true` rather than being invisible. `overlay=live` adds live control-plane fields; the overlay never adds, drops or reorders a row. Returns 404 when run reads are not enabled for the organization.
+         * @description Every agent and flow run in the span store, newest start first, including runs that write no control-plane row. Each row carries `origin` (dashboard | api | internal | null), read from the caller's authenticated principal, and `test` as its derived alias for `origin === "dashboard"`; both are null when the header states nothing. `overlay=live` adds live control-plane fields; the overlay never adds, drops or reorders a row. Returns 404 with `code: "run_history_unavailable"` when neither plane can serve the page, which a client renders as "no run history here" rather than as a failed read.
          */
         get: {
             parameters: {
@@ -40074,7 +40092,7 @@ interface paths {
                     from?: string;
                     /** @description Window end (ISO 8601). Defaults to now. */
                     to?: string;
-                    /** @description full (the default) returns every field. compact omits exactly these 14: stopReason, iterations, agentVersionId, agentVersionLabel, agentVersionNumber, agentTargetResolution, otelProducer, lastHeartbeatAt, expiresAt, cancelRequestedAt, progress, pendingApproval, budgetExhausted and inputMessages. The status is still overlay-corrected on a compact page; only the fields differ. */
+                    /** @description full (the default) returns every field. compact omits exactly these 15: stopReason, iterations, inputPreview, agentVersionId, agentVersionLabel, agentVersionNumber, agentTargetResolution, otelProducer, lastHeartbeatAt, expiresAt, cancelRequestedAt, progress, pendingApproval, budgetExhausted and inputMessages. The status is still overlay-corrected on a compact page; only the fields differ. */
                     view?: "compact" | "full";
                     /** @description live adds control-plane fields; defaults to live for a session, none for an API key. */
                     overlay?: "live" | "none";
@@ -40138,13 +40156,20 @@ interface paths {
                         "application/json": components["schemas"]["Error"];
                     };
                 };
-                /** @description Run reads are not enabled for this organization */
+                /** @description No plane can answer: store run reads are off for this organization and the request names a predicate the control plane cannot express */
                 404: {
                     headers: {
                         [name: string]: unknown;
                     };
                     content: {
-                        "application/json": components["schemas"]["Error"];
+                        "application/json": {
+                            /**
+                             * @description Neither plane can serve this page, so the caller shows "no run history" rather than a failed read. Matching on the sentence is never the contract.
+                             * @enum {string}
+                             */
+                            code: "run_history_unavailable";
+                            error: string;
+                        };
                     };
                 };
                 /** @description Internal server error */
@@ -40182,7 +40207,7 @@ interface paths {
                 query?: {
                     /** @description live adds control-plane fields; defaults to live for a session, none for an API key. */
                     overlay?: "live" | "none";
-                    /** @description full (the default) returns every field. compact omits exactly these 14: stopReason, iterations, agentVersionId, agentVersionLabel, agentVersionNumber, agentTargetResolution, otelProducer, lastHeartbeatAt, expiresAt, cancelRequestedAt, progress, pendingApproval, budgetExhausted and inputMessages. The status is still overlay-corrected on a compact page; only the fields differ. */
+                    /** @description full (the default) returns every field. compact omits exactly these 15: stopReason, iterations, inputPreview, agentVersionId, agentVersionLabel, agentVersionNumber, agentTargetResolution, otelProducer, lastHeartbeatAt, expiresAt, cancelRequestedAt, progress, pendingApproval, budgetExhausted and inputMessages. The status is still overlay-corrected on a compact page; only the fields differ. */
                     view?: "compact" | "full";
                 };
                 header?: never;
@@ -50949,8 +50974,12 @@ interface components {
             fidelityTier: string | null;
             /** @description Flow that ran. */
             flowId: string | null;
+            /** @description True when the dispatch carried a complete inline agent definition (name and model) beside or instead of an agentId, so the run executed that inline config and no stored version; such a row stamps no agentVersionId. False when the run executed the saved definition by reference. NULL when the header states nothing: a flow run, a lane that resolves no agent definition, or a row that predates the field. */
+            inlineDefinition: boolean | null;
             /** @description Messages the run started from. Absent means the overlay did not answer, which is not false and not null. */
             inputMessages?: unknown;
+            /** @description The run's first user message, secret-scrubbed and cut to 160 characters, so a list can say what a run was asked to do without reading content. Absent means no input text is recorded for this run, which is not an empty message: the span store holds no run-level input at all, so a run with no control-plane row (a flow leg, a storeResults:false run) has none. */
+            inputPreview?: string | null;
             /** @description Input tokens reported. */
             inputTokens: number | null;
             /** @description Loop iterations from the terminal frame. */
@@ -50962,6 +50991,11 @@ interface components {
             kind: "agent" | "flow";
             /** @description Last heartbeat. Absent means the overlay did not answer, which is not false and not null. */
             lastHeartbeatAt?: string | null;
+            /**
+             * @description Where the run was dispatched from, taken from the caller's authenticated principal and never from a request field: dashboard for a Clerk session, api for a management API key, internal for a Runtype worker. NULL means the header states nothing about it, which is not "unknown caller": headers written before this field shipped, lanes that never see an auth principal, and every backfilled row carry no origin stamp.
+             * @enum {string|null}
+             */
+            origin: "dashboard" | "api" | "internal" | null;
             /** @description Framework identity the producer reported, for a versionless run group. Absent means the overlay did not answer, which is not false and not null. */
             otelProducer?: unknown;
             /** @description Output tokens reported. */
@@ -50998,11 +51032,16 @@ interface components {
             status: "queued" | "running" | "awaiting" | "completed" | "failed" | "cancelled";
             /** @description Stop reason from the terminal frame. */
             stopReason?: string | null;
+            /** @description The persistence posture the dispatch declared. FALSE means the run wrote no control-plane row, no journal outputs and no span content, so a surface that reports a missing transcript keys on this and never on origin. NULL means the header states nothing, which is not "true": a lane that takes no such flag carries no stamp, and an ingested (OTLP) run declared none. A row served from the legacy control-plane lane answers true, because that row exists only when the run stored. */
+            storeResults: boolean | null;
             /** @description Product surface that entered this run. */
             surfaceId: string | null;
             /** @description Surface family (api, chat, webhook, schedule, ...). */
             surfaceType: string | null;
-            /** @description True when the run was dispatched with storeResults: false, so it has no control-plane row and no overlay. NULL means the header states nothing about it, which is not false: headers written before this field shipped, and lanes that take no such flag, carry no dispatch stamp and are never backfilled. */
+            /**
+             * @deprecated
+             * @description DEPRECATED: a derived alias of origin, kept for one release — read origin instead. True when the run came from the dashboard, i.e. origin === "dashboard"; NULL exactly when origin is NULL. It is never derived from storeResults, which defaults to false across the whole flow lane and which an API caller sets for its own privacy reasons: reading it as "test" labelled production runs as tests. A run whose header predates origin therefore reads NULL rather than claiming either answer.
+             */
             test: boolean | null;
             /** @description Metered cost as a decimal string. */
             totalCost: string | null;
@@ -57898,13 +57937,39 @@ interface RunListRow {
     totalCost: string | null;
     selfReportedCost: string | null;
     /**
-     * True when the run was dispatched with `storeResults: false`, such as an
-     * editor test. NULL means the header states nothing about it, which is not
-     * `false`: headers written before the field shipped carry no dispatch stamp.
+     * Where the run was dispatched from, taken from the caller's authenticated
+     * principal and never from a request field. NULL means the header states
+     * nothing about it: a lane that sees no principal, or a backfilled row.
+     */
+    origin: 'dashboard' | 'api' | 'internal' | null;
+    /**
+     * The persistence posture the dispatch declared. `false` means the run kept no
+     * control-plane row, no journal outputs and no span content, so a surface
+     * reporting a missing transcript reads this and never `origin`.
+     */
+    storeResults: boolean | null;
+    /**
+     * True when the dispatch carried a complete inline definition, so the run
+     * executed that config and stamps no `agentVersionId`. False for a run of the
+     * saved definition by reference. NULL when the header states nothing.
+     */
+    inlineDefinition: boolean | null;
+    /**
+     * True when the run came from the dashboard (`origin === 'dashboard'`), such
+     * as an editor test.
+     * @deprecated Derived alias of `origin`; read `origin` instead. Kept for one
+     * release. NULL exactly when `origin` is NULL, including on a run whose header
+     * predates the field.
      */
     test: boolean | null;
     stopReason?: string | null;
     iterations?: number | null;
+    /**
+     * The run's first user message, secret-scrubbed and bounded. Absent means no
+     * input text is recorded for the run, which is not an empty message: a run
+     * with no control-plane row carries none.
+     */
+    inputPreview?: string | null;
     /** Overlay fields. Absent means the overlay did not answer, never `false`. */
     agentVersionId?: string | null;
     agentVersionLabel?: string | null;
@@ -57959,8 +58024,8 @@ interface RunListResponse {
 }
 /**
  * Read-only namespace over `/v1/runs`, the one list of agent and flow runs.
- * A run dispatched with `storeResults: false` is listed with `test: true`
- * rather than being absent.
+ * A dashboard editor test is listed with `origin: 'dashboard'` (and its `test`
+ * alias) rather than being absent.
  */
 declare class RunsNamespace {
     private readonly getClient;
@@ -58931,7 +58996,10 @@ declare class Runtype {
     static get executions(): ExecutionsNamespace;
     /**
      * Runs namespace - the one list of agent and flow runs, read from the span
-     * store. Includes runs dispatched with `storeResults: false` as `test: true`.
+     * store. Each row states two separate facts: `origin` (who dispatched, from
+     * the caller's principal; `test` is its deprecated alias) and `storeResults`
+     * (whether the transcript was kept). A run that wrote no control-plane row
+     * is still listed.
      *
      * @example
      * ```typescript

package/dist/index.mjs

@@ -13639,7 +13639,10 @@ var Runtype = class {
   }
   /**
    * Runs namespace - the one list of agent and flow runs, read from the span
-   * store. Includes runs dispatched with `storeResults: false` as `test: true`.
+   * store. Each row states two separate facts: `origin` (who dispatched, from
+   * the caller's principal; `test` is its deprecated alias) and `storeResults`
+   * (whether the transcript was kept). A run that wrote no control-plane row
+   * is still listed.
    *
    * @example
    * ```typescript
@@ -13931,7 +13934,7 @@ function transformQueryParams(params) {
 
 // src/version.ts
 var FALLBACK_VERSION = "0.0.0";
-var SDK_VERSION = "10.1.1".length > 0 ? "10.1.1" : FALLBACK_VERSION;
+var SDK_VERSION = "10.1.4".length > 0 ? "10.1.4" : 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": "10.1.1",
+  "version": "10.1.4",
   "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",
@@ -24,7 +24,7 @@
   ],
   "dependencies": {},
   "devDependencies": {
-    "@runtypelabs/shared": "3.57.2",
+    "@runtypelabs/shared": "3.58.1",
     "openapi-typescript": "^7.13.0",
     "tsup": "^8.0.2",
     "typescript": "^6.0.3",