@runtypelabs/sdk 10.2.2 → 10.3.0

package/dist/index.d.cts

@@ -809,6 +809,8 @@ interface paths {
                                 url: string;
                             }[];
                             model?: string;
+                            /** @description Scheduled and batch runs only. When true, files the agent writes to /mnt/session/outputs/ are stored as runtype-asset:// handles and the session is resumed for one delivery turn that lists them (for example, to attach them with send_email). */
+                            outputHandoff?: boolean;
                             /** @enum {string} */
                             setupMode: "create" | "connect";
                             systemPrompt?: string;
@@ -918,6 +920,8 @@ interface paths {
                                 thinkingLevel?: string;
                             };
                             sandbox?: {
+                                /** @description Coding agents the Sandbox can run as typed sessions. Non-empty adds the agent_session_* tools; empty or absent adds none. */
+                                codingAgents?: "opencode"[];
                                 enabled: boolean;
                                 /**
                                  * @description Only standard-4 is supported on the hosted Agent Sandbox path; other sizes cannot be enabled.
@@ -1033,6 +1037,7 @@ interface paths {
                                         [key: string]: unknown;
                                     };
                                     description: string;
+                                    hiddenParameterNames?: string[];
                                     idempotent?: boolean;
                                     name: string;
                                     parametersSchema: {
@@ -1432,6 +1437,8 @@ interface paths {
                                     thinkingLevel?: string;
                                 };
                                 sandbox?: {
+                                    /** @description Coding agents the Sandbox can run as typed sessions. Non-empty adds the agent_session_* tools; empty or absent adds none. */
+                                    codingAgents?: "opencode"[];
                                     enabled: boolean;
                                     /**
                                      * @description Only standard-4 is supported on the hosted Agent Sandbox path; other sizes cannot be enabled.
@@ -1547,6 +1554,7 @@ interface paths {
                                             [key: string]: unknown;
                                         };
                                         description: string;
+                                        hiddenParameterNames?: string[];
                                         idempotent?: boolean;
                                         name: string;
                                         parametersSchema: {
@@ -2111,6 +2119,8 @@ interface paths {
                                 url: string;
                             }[];
                             model?: string;
+                            /** @description Scheduled and batch runs only. When true, files the agent writes to /mnt/session/outputs/ are stored as runtype-asset:// handles and the session is resumed for one delivery turn that lists them (for example, to attach them with send_email). */
+                            outputHandoff?: boolean;
                             /** @enum {string} */
                             setupMode?: "create" | "connect";
                             systemPrompt?: string;
@@ -2220,6 +2230,8 @@ interface paths {
                                 thinkingLevel?: string;
                             };
                             sandbox?: {
+                                /** @description Coding agents the Sandbox can run as typed sessions. Non-empty adds the agent_session_* tools; empty or absent adds none. */
+                                codingAgents?: "opencode"[];
                                 enabled: boolean;
                                 /**
                                  * @description Only standard-4 is supported on the hosted Agent Sandbox path; other sizes cannot be enabled.
@@ -2335,6 +2347,7 @@ interface paths {
                                         [key: string]: unknown;
                                     };
                                     description: string;
+                                    hiddenParameterNames?: string[];
                                     idempotent?: boolean;
                                     name: string;
                                     parametersSchema: {
@@ -4344,7 +4357,8 @@ interface paths {
         };
         /**
          * List agent executions
-         * @description List execution history for an agent with cursor pagination. Rows include `finalOutput` by default; pass `view=compact` for the lighter projection that omits it and previews long strings. Supports cross-agent subagent drill-down via parentExecutionId or executionId filters.
+         * @deprecated
+         * @description Deprecated: use `GET /v1/runs?agentId={id}`, the single run list for every agent and flow run, including runs dispatched with `storeResults: false` that write no row here. This endpoint stays available and unchanged. It reads the control-plane `agent_executions` table only. List execution history for an agent with cursor pagination. Rows include `finalOutput` by default; pass `view=compact` for the lighter projection that omits it and previews long strings. Supports cross-agent subagent drill-down via parentExecutionId or executionId filters.
          */
         get: {
             parameters: {
@@ -4780,7 +4794,7 @@ interface paths {
         };
         /**
          * Stream execution events
-         * @description Reconnect to a durable agent turn: replay-and-tail its Server-Sent Events. A turn that streams over an expired watch lease ends with `await` / `awaitReason: "detached"` while the execution keeps running; pass the last seen SSE `id:` as `after` to rejoin it. The session owner is resolved from the execution's own persisted record — its conversation for a top-level turn, its private child thread for a subagent run — and the optional `conversationId` is used only for a turn that persists no record of its own. Replays buffered events strictly past the `after` cursor, then live-tails if the turn is still running. Each event carries an SSE `id:` line — a durable row seq, or (unified vocabulary) a composite `<seq>.<subIndex>` when one durable row translates to multiple events. Pass that id verbatim after any disconnect (tab reload, sleep, stream timeout) to resume without missing or duplicating events. Replayed and live-tailed frames use the unified execution vocabulary.
+         * @description Reconnect to a durable agent turn: replay-and-tail its Server-Sent Events. A turn that streams over an expired watch lease ends with `await` / `awaitReason: "detached"` while the execution keeps running; pass the last seen SSE `id:` as `after` to rejoin it. The session owner is resolved from the execution's own persisted record — its conversation for a top-level turn, its private child thread for a subagent run — and the optional `conversationId` is used only for a turn that persists no record of its own. Replays buffered events strictly past the `after` cursor, then live-tails if the turn is still running. Each event carries an SSE `id:` line — a durable row seq, or (unified vocabulary) a composite `<seq>.<subIndex>` when one durable row translates to multiple events. Pass that id verbatim after any disconnect (tab reload, sleep, stream timeout) to resume without missing or duplicating events. Replayed and live-tailed frames use the unified execution vocabulary. A Runtype session turn's response carries `X-Runtype-Execution-Driver`, the driver holding the turn when the stream attached: `request-worker` or `workflow-leg` while that driver holds it, otherwise `owner`.
          */
         get: {
             parameters: {
@@ -9678,14 +9692,22 @@ interface paths {
                     "application/json": {
                         durableRecovery?: boolean;
                         flowId?: string;
-                        identityProof?: string;
+                        /** @description Customer-native auth proof for the Identity Exchange, as a bare token string or the `{ provider, token }` object `/v1/client/chat` accepts. The integration is selected by the verified issuer, not by `provider`: in the object form `provider` is a consistency hint (a hint that disagrees with the matched integration is rejected), and the bare string carries no hint. A Runtype-hosted `rt_eu_` token is sent as the bare string. */
+                        identityProof?: string | {
+                            provider: string;
+                            token: string;
+                        };
                         token: string;
                         visitorHistory?: boolean;
                         visitorToken?: string;
                     } | {
                         durableRecovery?: boolean;
                         flowId?: string;
-                        identityProof?: string;
+                        /** @description Customer-native auth proof for the Identity Exchange, as a bare token string or the `{ provider, token }` object `/v1/client/chat` accepts. The integration is selected by the verified issuer, not by `provider`: in the object form `provider` is a consistency hint (a hint that disagrees with the matched integration is rejected), and the bare string carries no hint. A Runtype-hosted `rt_eu_` token is sent as the bare string. */
+                        identityProof?: string | {
+                            provider: string;
+                            token: string;
+                        };
                         sessionId: string;
                         token: string;
                         visitorHistory?: boolean;
@@ -9694,7 +9716,11 @@ interface paths {
                         conversationId: string;
                         durableRecovery?: boolean;
                         flowId?: string;
-                        identityProof?: string;
+                        /** @description Customer-native auth proof for the Identity Exchange, as a bare token string or the `{ provider, token }` object `/v1/client/chat` accepts. The integration is selected by the verified issuer, not by `provider`: in the object form `provider` is a consistency hint (a hint that disagrees with the matched integration is rejected), and the bare string carries no hint. A Runtype-hosted `rt_eu_` token is sent as the bare string. */
+                        identityProof?: string | {
+                            provider: string;
+                            token: string;
+                        };
                         token: string;
                         visitorHistory?: boolean;
                         visitorToken: string;
@@ -9702,7 +9728,11 @@ interface paths {
                         conversationId: string;
                         durableRecovery?: boolean;
                         flowId?: string;
-                        identityProof: string;
+                        /** @description Customer-native auth proof for the Identity Exchange, as a bare token string or the `{ provider, token }` object `/v1/client/chat` accepts. The integration is selected by the verified issuer, not by `provider`: in the object form `provider` is a consistency hint (a hint that disagrees with the matched integration is rejected), and the bare string carries no hint. A Runtype-hosted `rt_eu_` token is sent as the bare string. */
+                        identityProof: string | {
+                            provider: string;
+                            token: string;
+                        };
                         token: string;
                         visitorHistory?: boolean;
                         visitorToken?: string;
@@ -12971,6 +13001,8 @@ interface paths {
                                 thinkingLevel?: string;
                             };
                             sandbox?: {
+                                /** @description Coding agents the Sandbox can run as typed sessions. Non-empty adds the agent_session_* tools; empty or absent adds none. */
+                                codingAgents?: "opencode"[];
                                 enabled: boolean;
                                 /**
                                  * @description Only standard-4 is supported on the hosted Agent Sandbox path; other sizes cannot be enabled.
@@ -13419,6 +13451,8 @@ interface paths {
                                 thinkingLevel?: string;
                             };
                             sandbox?: {
+                                /** @description Coding agents the Sandbox can run as typed sessions. Non-empty adds the agent_session_* tools; empty or absent adds none. */
+                                codingAgents?: "opencode"[];
                                 enabled: boolean;
                                 /**
                                  * @description Only standard-4 is supported on the hosted Agent Sandbox path; other sizes cannot be enabled.
@@ -18137,7 +18171,7 @@ interface paths {
         };
         /**
          * Stream execution events
-         * @description Execution-scoped alias of `GET /v1/agents/{id}/executions/{executionId}/events`: reconnect to a durable turn and replay-and-tail its Server-Sent Events without already knowing which agent ran it. The agent is resolved from the execution's own persisted record, so a run started through `/v1/dispatch` reconnects by execution id alone; a record with no agent (an inline definition, which addresses no durable session) answers 404. A turn that streams over an expired watch lease ends with `await` / `awaitReason: "detached"` while the execution keeps running; pass the last seen SSE `id:` as `after` to rejoin it. Replays buffered events strictly past the `after` cursor, then live-tails if the turn is still running. Each event carries an SSE `id:` line — a durable row seq, or (unified vocabulary) a composite `<seq>.<subIndex>` when one durable row translates to multiple events. Pass that id verbatim after any disconnect (tab reload, sleep, stream timeout) to resume without missing or duplicating events. Replayed and live-tailed frames use the unified execution vocabulary. An API key needs `AGENTS:READ`, `AGENTS:*`, `DISPATCH:*`, or `*`; `DISPATCH:*` is admitted because this alias exists for dispatch-started runs.
+         * @description Execution-scoped alias of `GET /v1/agents/{id}/executions/{executionId}/events`: reconnect to a durable turn and replay-and-tail its Server-Sent Events without already knowing which agent ran it. The agent is resolved from the execution's own persisted record, so a run started through `/v1/dispatch` reconnects by execution id alone; a record with no agent (an inline definition, which addresses no durable session) answers 404. A turn that streams over an expired watch lease ends with `await` / `awaitReason: "detached"` while the execution keeps running; pass the last seen SSE `id:` as `after` to rejoin it. Replays buffered events strictly past the `after` cursor, then live-tails if the turn is still running. Each event carries an SSE `id:` line — a durable row seq, or (unified vocabulary) a composite `<seq>.<subIndex>` when one durable row translates to multiple events. Pass that id verbatim after any disconnect (tab reload, sleep, stream timeout) to resume without missing or duplicating events. Replayed and live-tailed frames use the unified execution vocabulary. A Runtype session turn's response carries `X-Runtype-Execution-Driver`, the driver holding the turn when the stream attached: `request-worker` or `workflow-leg` while that driver holds it, otherwise `owner`. An API key needs `AGENTS:READ`, `AGENTS:*`, `DISPATCH:*`, or `*`; `DISPATCH:*` is admitted because this alias exists for dispatch-started runs.
          */
         get: {
             parameters: {
@@ -25184,8 +25218,12 @@ interface paths {
                     surfaceId?: string;
                     /** @description Filter by conversation ID */
                     conversationId?: string;
-                    /** @description Full-text search in message */
+                    /** @description Case-insensitive substring search over a span's message, name, operation, tool name or error class; a live-tier row matches on its message. */
                     search?: string;
+                    /** @description Comma-separated statuses (running,completed,failed,queued,cancelled,unknown). An unknown value is rejected with 400. A row is unknown while its activity has not finished, else failed at level error and completed otherwise; running, queued and cancelled match no row today. */
+                    status?: string;
+                    /** @description Comma-separated entry types (flow,step,tool,batch,system,agent,model,schedule,audit). An unknown value is rejected with 400. Matches the type each row is rendered with, so step selects step spans only and flow selects flow runs without their steps. Combined with category by AND. */
+                    type?: string;
                     /** @description Max results per page (default 500, max 1000) */
                     limit?: string;
                     /** @description Pagination cursor */
@@ -25413,8 +25451,12 @@ interface paths {
                     surfaceId?: string;
                     /** @description Filter by conversation ID */
                     conversationId?: string;
-                    /** @description Full-text search in message */
+                    /** @description Case-insensitive substring search over a span's message, name, operation, tool name or error class; a live-tier row matches on its message. */
                     search?: string;
+                    /** @description Comma-separated statuses (running,completed,failed,queued,cancelled,unknown). An unknown value is rejected with 400. A row is unknown while its activity has not finished, else failed at level error and completed otherwise; running, queued and cancelled match no row today. */
+                    status?: string;
+                    /** @description Comma-separated entry types (flow,step,tool,batch,system,agent,model,schedule,audit). An unknown value is rejected with 400. Matches the type each row is rendered with, so step selects step spans only and flow selects flow runs without their steps. Combined with category by AND. */
+                    type?: string;
                     /** @description Max results per page (default 500, max 1000) */
                     limit?: string;
                     /** @description Pagination cursor */
@@ -30771,6 +30813,10 @@ interface paths {
                                         batchExecutionId: string | null;
                                         /** @description Budget exhausted. Absent means the overlay did not answer, which is not false and not null. */
                                         budgetExhausted?: boolean | null;
+                                        /** @description Prompt-cache reads summed over the run's model calls (a subset of inputTokens). Returned by GET /v1/runs/{executionId} only; null means no model call reported one. */
+                                        cacheReadTokens?: number | null;
+                                        /** @description Prompt-cache writes summed over the run's model calls (a subset of inputTokens). Returned by GET /v1/runs/{executionId} only; null means no model call reported one. */
+                                        cacheWriteTokens?: number | null;
                                         /** @description Cancel request. Absent means the overlay did not answer, which is not false and not null. */
                                         cancelRequestedAt?: string | null;
                                         /** @description How many runs name this one as their parent. The unscoped feed returns roots only, so this is the size of the fold underneath a row; read the children with parentExecutionId=<executionId>. It is populated on a resource-scoped page too, where nothing is folded, so a surface can still offer the same expansion. WHICH children are counted depends on the arm that served the row: the span store counts every child, agent and nested-flow alike, while the legacy control-plane fallback counts agent children only, so on that arm a parent whose only child is a nested flow reports 0. That is deliberate — the fallback arm cannot enumerate a nested-flow child either, so counting one would advertise a fold that opens on nothing. It counts only children the CALLER may read: a credential holding one execution family (AGENTS:READ or FLOWS:READ alone) counts the children of that family and no others, so a count never discloses a run the same credential could not list. NULL means the arm cannot count children at all, which is not zero. */
@@ -30828,6 +30874,8 @@ interface paths {
                                         pendingApproval?: unknown;
                                         /** @description Live progress document. Absent means the overlay did not answer, which is not false and not null. */
                                         progress?: unknown;
+                                        /** @description Reasoning tokens summed over the run's model calls (a subset of outputTokens). Returned by GET /v1/runs/{executionId} only; null means no model call reported one. */
+                                        reasoningTokens?: number | null;
                                         /** @description Record this run processed. */
                                         recordId: string | null;
                                         /** @description Retention removed the spans; the run still lists and reads as completed. */
@@ -31835,6 +31883,7 @@ interface paths {
                     "application/json": {
                         behavior?: unknown;
                         config?: unknown;
+                        /** @description Inbound config. Slack, Telegram and iMessage accept channelResponseMode (mention, the default; always; or judge, which asks the platform response-gate judgment whether to reply and waits for a mention when the judgment fails), responseRules (free text up to 2000 characters the judgment reads), eagerness (conservative, balanced or eager), onUncertain (silent or reply), responseGateShadow (opt-in: judge and record without changing behavior in mention or always mode), keywords, channelOverrides (per-channel channelResponseMode and eagerness) and contextBackfill ({ mode: window (default), judged (only the messages the judgment finds relevant, falling back to window on failure) or none, maxMessages up to 20, maxAgeMinutes up to 1440 }). */
                         inbound?: {
                             [key: string]: unknown;
                         };
@@ -32304,6 +32353,7 @@ interface paths {
                     "application/json": {
                         behavior?: unknown;
                         config?: unknown;
+                        /** @description Inbound config. Slack, Telegram and iMessage accept channelResponseMode (mention, the default; always; or judge, which asks the platform response-gate judgment whether to reply and waits for a mention when the judgment fails), responseRules (free text up to 2000 characters the judgment reads), eagerness (conservative, balanced or eager), onUncertain (silent or reply), responseGateShadow (opt-in: judge and record without changing behavior in mention or always mode), keywords, channelOverrides (per-channel channelResponseMode and eagerness) and contextBackfill ({ mode: window (default), judged (only the messages the judgment finds relevant, falling back to window on failure) or none, maxMessages up to 20, maxAgeMinutes up to 1440 }). */
                         inbound?: {
                             [key: string]: unknown;
                         };
@@ -38167,6 +38217,764 @@ interface paths {
         patch?: never;
         trace?: never;
     };
+    "/v1/question-sets": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /**
+         * List question sets
+         * @description List the organization's question sets with cursor pagination, newest first.
+         */
+        get: {
+            parameters: {
+                query?: {
+                    limit?: string;
+                    cursor?: string;
+                    direction?: "next" | "prev";
+                    includeCount?: string;
+                };
+                header?: never;
+                path?: never;
+                cookie?: never;
+            };
+            requestBody?: never;
+            responses: {
+                /** @description Paginated question sets */
+                200: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": {
+                            data: components["schemas"]["QuestionSetListItem"][];
+                            pagination: components["schemas"]["Pagination"];
+                        };
+                    };
+                };
+                /** @description Invalid request */
+                400: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["QuestionSetError"];
+                    };
+                };
+                /** @description Unauthorized */
+                401: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["Error"];
+                    };
+                };
+                /** @description Insufficient permissions, or no organization context */
+                403: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["Error"];
+                    };
+                };
+                /** @description Not found */
+                404: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["QuestionSetError"];
+                    };
+                };
+            };
+        };
+        put?: never;
+        /**
+         * Create a question set
+         * @description Create a question set with its first version as a draft. Publish the version before a tool, step or grader can reference it.
+         */
+        post: {
+            parameters: {
+                query?: never;
+                header?: never;
+                path?: never;
+                cookie?: never;
+            };
+            requestBody?: {
+                content: {
+                    "application/json": {
+                        description?: string | null;
+                        inputMapping?: {
+                            [key: string]: string;
+                        } | null;
+                        model?: string | null;
+                        name: string;
+                        /** @description Judgment questions keyed by question id. Each is `{ type: "boolean" | "choice" | "score", instructions, criteria }`. The id is never sent to the model, so instructions and criteria carry the meaning. */
+                        questions: {
+                            [key: string]: unknown;
+                        };
+                        /** @description Stable handle, unique in the organization: lowercase letters, digits, `-` and `_`, up to 64. */
+                        slug: string;
+                    };
+                };
+            };
+            responses: {
+                /** @description Created */
+                201: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": {
+                            questionSet: components["schemas"]["QuestionSet"];
+                            version: components["schemas"]["QuestionSetVersion"];
+                        };
+                    };
+                };
+                /** @description Invalid request */
+                400: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["QuestionSetError"];
+                    };
+                };
+                /** @description Unauthorized */
+                401: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["Error"];
+                    };
+                };
+                /** @description Insufficient permissions, or no organization context */
+                403: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["Error"];
+                    };
+                };
+                /** @description Not found */
+                404: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["QuestionSetError"];
+                    };
+                };
+                /** @description Conflict */
+                409: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["QuestionSetError"];
+                    };
+                };
+            };
+        };
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/v1/question-sets/{id}": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /**
+         * Get a question set
+         * @description A question set with its versions, newest first.
+         */
+        get: {
+            parameters: {
+                query?: never;
+                header?: never;
+                path: {
+                    id: string;
+                };
+                cookie?: never;
+            };
+            requestBody?: never;
+            responses: {
+                /** @description Question set */
+                200: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": {
+                            questionSet: components["schemas"]["QuestionSet"];
+                            versions: components["schemas"]["QuestionSetVersion"][];
+                        };
+                    };
+                };
+                /** @description Invalid request */
+                400: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["QuestionSetError"];
+                    };
+                };
+                /** @description Unauthorized */
+                401: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["Error"];
+                    };
+                };
+                /** @description Insufficient permissions, or no organization context */
+                403: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["Error"];
+                    };
+                };
+                /** @description Not found */
+                404: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["QuestionSetError"];
+                    };
+                };
+            };
+        };
+        /**
+         * Update a question set
+         * @description Update the name or description, and append a new draft version when `questions`, `inputMapping` or `model` is present. Fields left out of a new version carry over from the latest version. No existing version is changed, and the slug is fixed.
+         */
+        put: {
+            parameters: {
+                query?: never;
+                header?: never;
+                path: {
+                    id: string;
+                };
+                cookie?: never;
+            };
+            requestBody?: {
+                content: {
+                    "application/json": {
+                        description?: string | null;
+                        inputMapping?: {
+                            [key: string]: string;
+                        } | null;
+                        model?: string | null;
+                        name?: string;
+                        /** @description Judgment questions keyed by question id. Each is `{ type: "boolean" | "choice" | "score", instructions, criteria }`. The id is never sent to the model, so instructions and criteria carry the meaning. */
+                        questions?: {
+                            [key: string]: unknown;
+                        };
+                    };
+                };
+            };
+            responses: {
+                /** @description Updated */
+                200: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": {
+                            questionSet: components["schemas"]["QuestionSet"];
+                            version: components["schemas"]["QuestionSetVersion"] & (Record<string, never> | null);
+                        };
+                    };
+                };
+                /** @description Invalid request */
+                400: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["QuestionSetError"];
+                    };
+                };
+                /** @description Unauthorized */
+                401: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["Error"];
+                    };
+                };
+                /** @description Insufficient permissions, or no organization context */
+                403: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["Error"];
+                    };
+                };
+                /** @description Not found */
+                404: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["QuestionSetError"];
+                    };
+                };
+                /** @description Conflict */
+                409: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["QuestionSetError"];
+                    };
+                };
+            };
+        };
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/v1/question-sets/{id}/resolved": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /**
+         * Resolve a question set
+         * @description The question set exactly as an execution receives it: the current published version (or the published `version` named), with its current calibration. A draft-only set answers 404 QUESTION_SET_UNRESOLVED.
+         */
+        get: {
+            parameters: {
+                query?: {
+                    version?: number;
+                };
+                header?: never;
+                path: {
+                    id: string;
+                };
+                cookie?: never;
+            };
+            requestBody?: never;
+            responses: {
+                /** @description Resolved */
+                200: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["ResolvedQuestionSet"];
+                    };
+                };
+                /** @description Invalid request */
+                400: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["QuestionSetError"];
+                    };
+                };
+                /** @description Unauthorized */
+                401: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["Error"];
+                    };
+                };
+                /** @description Insufficient permissions, or no organization context */
+                403: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["Error"];
+                    };
+                };
+                /** @description Not found */
+                404: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["QuestionSetError"];
+                    };
+                };
+            };
+        };
+        put?: never;
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/v1/question-sets/{id}/versions": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /**
+         * List a question set's versions
+         * @description Every version, newest first.
+         */
+        get: {
+            parameters: {
+                query?: never;
+                header?: never;
+                path: {
+                    id: string;
+                };
+                cookie?: never;
+            };
+            requestBody?: never;
+            responses: {
+                /** @description Versions */
+                200: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": {
+                            data: components["schemas"]["QuestionSetVersion"][];
+                        };
+                    };
+                };
+                /** @description Invalid request */
+                400: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["QuestionSetError"];
+                    };
+                };
+                /** @description Unauthorized */
+                401: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["Error"];
+                    };
+                };
+                /** @description Insufficient permissions, or no organization context */
+                403: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["Error"];
+                    };
+                };
+                /** @description Not found */
+                404: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["QuestionSetError"];
+                    };
+                };
+            };
+        };
+        put?: never;
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/v1/question-sets/{id}/versions/{versionNumber}/calibrations": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /**
+         * List a question set version's calibrations
+         * @description The calibration history of one version, newest first, with cursor pagination.
+         */
+        get: {
+            parameters: {
+                query?: {
+                    /** @description 1-200, default 50. */
+                    limit?: string;
+                    /** @description `pagination.nextCursor` from a previous page. */
+                    cursor?: string;
+                };
+                header?: never;
+                path: {
+                    id: string;
+                    versionNumber: number;
+                };
+                cookie?: never;
+            };
+            requestBody?: never;
+            responses: {
+                /** @description Calibrations */
+                200: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": {
+                            data: components["schemas"]["JudgmentCalibrationRecord"][];
+                            pagination: components["schemas"]["Pagination"];
+                        };
+                    };
+                };
+                /** @description Invalid request */
+                400: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["QuestionSetError"];
+                    };
+                };
+                /** @description Unauthorized */
+                401: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["Error"];
+                    };
+                };
+                /** @description Insufficient permissions, or no organization context */
+                403: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["Error"];
+                    };
+                };
+                /** @description Not found */
+                404: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["QuestionSetError"];
+                    };
+                };
+            };
+        };
+        put?: never;
+        /**
+         * Record a calibration for a question set version
+         * @description Append a calibration measurement to a published version and make it the current one. Calibrations are never edited or deleted, so every past decision keeps the calibration it was taken under.
+         */
+        post: {
+            parameters: {
+                query?: never;
+                header?: never;
+                path: {
+                    id: string;
+                    versionNumber: number;
+                };
+                cookie?: never;
+            };
+            requestBody?: {
+                content: {
+                    "application/json": {
+                        /** @description The eval run that measured this calibration. It must resolve in this account; the row is then recorded as `eval_suite`. Without it the row is `customer`. */
+                        evalRunId?: string;
+                        record: {
+                            labeledSetRef: string;
+                            measuredModel: string;
+                            perQuestion: {
+                                [key: string]: {
+                                    ece: number;
+                                    handledRate: number;
+                                    heldOutAccuracy: number;
+                                    targetAccuracy: number;
+                                    threshold: number;
+                                };
+                            };
+                        };
+                    };
+                };
+            };
+            responses: {
+                /** @description Recorded */
+                201: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": {
+                            calibration: components["schemas"]["JudgmentCalibrationRecord"];
+                            version: components["schemas"]["QuestionSetVersion"];
+                        };
+                    };
+                };
+                /** @description Invalid request */
+                400: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["QuestionSetError"];
+                    };
+                };
+                /** @description Unauthorized */
+                401: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["Error"];
+                    };
+                };
+                /** @description Insufficient permissions, or no organization context */
+                403: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["Error"];
+                    };
+                };
+                /** @description Not found */
+                404: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["QuestionSetError"];
+                    };
+                };
+                /** @description Conflict */
+                409: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["QuestionSetError"];
+                    };
+                };
+            };
+        };
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/v1/question-sets/{id}/versions/{versionNumber}/publish": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        get?: never;
+        put?: never;
+        /**
+         * Publish a question set version
+         * @description Freeze the version and make it the one executions resolve when they name no version. Publishing an already-published version moves the current pointer back to it.
+         */
+        post: {
+            parameters: {
+                query?: never;
+                header?: never;
+                path: {
+                    id: string;
+                    versionNumber: number;
+                };
+                cookie?: never;
+            };
+            requestBody?: never;
+            responses: {
+                /** @description Published */
+                200: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": {
+                            questionSet: components["schemas"]["QuestionSet"];
+                            version: components["schemas"]["QuestionSetVersion"];
+                        };
+                    };
+                };
+                /** @description Invalid request */
+                400: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["QuestionSetError"];
+                    };
+                };
+                /** @description Unauthorized */
+                401: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["Error"];
+                    };
+                };
+                /** @description Insufficient permissions, or no organization context */
+                403: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["Error"];
+                    };
+                };
+                /** @description Not found */
+                404: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["QuestionSetError"];
+                    };
+                };
+            };
+        };
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
     "/v1/records": {
         parameters: {
             query?: never;
@@ -40029,7 +40837,7 @@ interface paths {
         };
         /**
          * List runs
-         * @description Every agent and flow run in the span store, newest start first, including runs that write no control-plane row. The UNSCOPED feed is ROOT runs only: a subagent or nested-flow run folds under its parent, `childCount` says how many are folded there, and `parentExecutionId=<id>` reads them. Pass `includeChildren=true` for the flat enumeration. Any resource-scoped filter (`agentId`, `flowId`, `conversationId`, `surfaceId`, `recordId`, `batchExecutionId`, `parentExecutionId`, `rootExecutionId`, `executionId`) is already an explicit selection and never folds, so an agent that only ever runs as a subagent still lists under `agentId`. Each row carries `origin` (dashboard | api | internal | null), read from the caller's authenticated principal, and `test` as its derived alias for `origin === "dashboard"`; any entrance that resolves a principal stamps origin, including the Runtype MCP server tools and Code Mode (`api`) and the hosted `/v1/mcp` proxy (`internal`). A lane with no principal answers null for both by design: schedule, webhook, messaging, A2A, an agent exposed as an MCP surface, subagent, nested flow, a client-token product surface, an ingested run, and any row whose header predates the field. `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.
+         * @description Every agent and flow run in the span store, newest start first, including runs that write no control-plane row. The UNSCOPED feed is ROOT runs only: a subagent or nested-flow run folds under its parent, `childCount` says how many are folded there, and `parentExecutionId=<id>` reads them. Pass `includeChildren=true` for the flat enumeration. Any resource-scoped filter (`agentId`, `flowId`, `conversationId`, `surfaceId`, `recordId`, `batchExecutionId`, `parentExecutionId`, `rootExecutionId`, `executionId`) is already an explicit selection and never folds, so an agent that only ever runs as a subagent still lists under `agentId`. Each row carries `origin` (dashboard | api | internal | null), read from the caller's authenticated principal, and `test` as its derived alias for `origin === "dashboard"`; any entrance that resolves a principal stamps origin, including the Runtype MCP server tools and Code Mode (`api`) and the hosted `/v1/mcp` proxy (`internal`). A lane with no principal answers null for both by design: schedule, webhook, messaging, A2A, an agent exposed as an MCP surface, subagent, nested flow, a client-token product surface, an ingested run, and any row whose header predates the field. `overlay=live` adds live control-plane fields; the overlay never adds, drops or reorders a row. A cursor minted by the retired control-plane list lane (`cp.` prefix) restarts at page one and answers `pagination.cursorReset: true`.
          */
         get: {
             parameters: {
@@ -40088,6 +40896,8 @@ interface paths {
                         "application/json": {
                             data: components["schemas"]["RunListRow"][];
                             pagination: {
+                                /** @description True when the supplied cursor could not be honoured and the read restarted at page one. A paging client must stop rather than follow the fresh cursor. Absent otherwise. */
+                                cursorReset?: boolean;
                                 hasMore: boolean;
                                 hasPrev: boolean;
                                 limit: number;
@@ -40128,22 +40938,6 @@ interface paths {
                         "application/json": components["schemas"]["Error"];
                     };
                 };
-                /** @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": {
-                            /**
-                             * @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 */
                 500: {
                     headers: {
@@ -45272,8 +46066,227 @@ interface paths {
                         "application/json": components["schemas"]["Error"];
                     };
                 };
-                /** @description Not found */
-                404: {
+                /** @description Not found */
+                404: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["Error"];
+                    };
+                };
+            };
+        };
+        put?: never;
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/v1/skills/{id}/versions/{versionId}/publish": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        get?: never;
+        put?: never;
+        /** Publish a skill version */
+        post: {
+            parameters: {
+                query?: never;
+                header?: never;
+                path: {
+                    id: string;
+                    versionId: string;
+                };
+                cookie?: never;
+            };
+            requestBody?: never;
+            responses: {
+                /** @description Published */
+                200: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": {
+                            success: boolean;
+                        };
+                    };
+                };
+                /** @description Unauthorized */
+                401: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["Error"];
+                    };
+                };
+                /** @description Insufficient permissions */
+                403: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["Error"];
+                    };
+                };
+                /** @description Not found */
+                404: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["Error"];
+                    };
+                };
+            };
+        };
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/v1/surfaces": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /**
+         * List surfaces
+         * @description List product surfaces across the authenticated user/org's products with cursor-based pagination. Supports filtering by product, type, and status. Slack inbound config is returned only for Slack surfaces and only includes safe-to-expose keys.
+         */
+        get: {
+            parameters: {
+                query?: {
+                    limit?: string;
+                    cursor?: string;
+                    productId?: string;
+                    type?: string;
+                    status?: string;
+                };
+                header?: never;
+                path?: never;
+                cookie?: never;
+            };
+            requestBody?: never;
+            responses: {
+                /** @description Paginated list of surfaces */
+                200: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": {
+                            data: {
+                                createdAt: string;
+                                /** @description Canonical public URL of this surface (MCP, API, A2A, AG-UI, webhook, chat). Null for surface types reached through their own channels (Slack, email, schedule, ...). Clients should use this instead of constructing the URL themselves. */
+                                endpoint: string | null;
+                                id: string;
+                                inbound: {
+                                    appId?: string;
+                                    /** @description Per-channel channelResponseMode and eagerness, keyed by channel ID. */
+                                    channelOverrides?: {
+                                        [key: string]: {
+                                            /** @enum {string} */
+                                            channelResponseMode?: "mention" | "judge" | "always";
+                                            /** @enum {string} */
+                                            eagerness?: "conservative" | "balanced" | "eager";
+                                        };
+                                    };
+                                    /**
+                                     * @description When the bot answers an unmentioned channel message: mention (default for new surfaces), always, or judge (asks the platform response-gate judgment whether to reply; a failed judgment waits for a mention).
+                                     * @enum {string}
+                                     */
+                                    channelResponseMode?: "mention" | "judge" | "always";
+                                    /** @description How skipped channel messages reach the conversation when the bot answers: window (default) adds up to maxMessages (default and ceiling 20) from the last maxAgeMinutes (default 360, ceiling 1440) as context; judged adds, within the same bounds, only the messages the platform response-gate judgment finds needed to understand the answered message, and falls back to window when the judgment fails; none adds nothing. */
+                                    contextBackfill?: {
+                                        maxAgeMinutes?: number;
+                                        maxMessages?: number;
+                                        /** @enum {string} */
+                                        mode?: "judged" | "window" | "none";
+                                    };
+                                    continueThreads?: boolean;
+                                    /**
+                                     * @description How readily judge mode replies: conservative, balanced (default) or eager. Each selects a pair of reply and silence thresholds.
+                                     * @enum {string}
+                                     */
+                                    eagerness?: "conservative" | "balanced" | "eager";
+                                    integrationId?: string;
+                                    /** @description Whole-word, case-insensitive filter on unmentioned messages in always and judge mode; judge mode applies it before the judgment. */
+                                    keywords?: {
+                                        ignore?: string[];
+                                        require?: string[];
+                                    };
+                                    listenChannels?: string[];
+                                    listenDms?: boolean;
+                                    /**
+                                     * @description What judge mode does when the judgment lands between the two thresholds: silent (default) or reply.
+                                     * @enum {string}
+                                     */
+                                    onUncertain?: "silent" | "reply";
+                                    /** @description Opt-in. In mention or always mode, also judge each unmentioned channel message and record the decision and probability without changing what the bot does. */
+                                    responseGateShadow?: boolean;
+                                    /** @description Free text (up to 2000 characters) the judge-mode judgment reads as the rules for when the bot should speak, for example "answer questions about resetting Acme account passwords". */
+                                    responseRules?: string;
+                                    teamId?: string;
+                                    teamName?: string;
+                                    /**
+                                     * @deprecated
+                                     * @description Deprecated; use channelResponseMode. true reads as mention, false as always.
+                                     */
+                                    triggerOnMention?: boolean;
+                                } | null;
+                                name: string;
+                                productId: string;
+                                /** @description Name of the product this surface belongs to. Non-nullable: the list query inner-joins products (so a surface with no product cannot appear) and products.name is NOT NULL. Present so a cross-product picker can disambiguate two surfaces that share a name. */
+                                productName: string;
+                                status: string;
+                                type: string;
+                                updatedAt: string;
+                                webhookHealth: components["schemas"]["WebhookHealth"];
+                            }[];
+                            pagination: components["schemas"]["Pagination"];
+                        };
+                    };
+                };
+                /** @description Invalid parameters */
+                400: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["Error"];
+                    };
+                };
+                /** @description Unauthorized */
+                401: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["Error"];
+                    };
+                };
+                /** @description Insufficient permissions */
+                403: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["Error"];
+                    };
+                };
+                /** @description Internal server error */
+                500: {
                     headers: {
                         [name: string]: unknown;
                     };
@@ -45291,75 +46304,7 @@ interface paths {
         patch?: never;
         trace?: never;
     };
-    "/v1/skills/{id}/versions/{versionId}/publish": {
-        parameters: {
-            query?: never;
-            header?: never;
-            path?: never;
-            cookie?: never;
-        };
-        get?: never;
-        put?: never;
-        /** Publish a skill version */
-        post: {
-            parameters: {
-                query?: never;
-                header?: never;
-                path: {
-                    id: string;
-                    versionId: string;
-                };
-                cookie?: never;
-            };
-            requestBody?: never;
-            responses: {
-                /** @description Published */
-                200: {
-                    headers: {
-                        [name: string]: unknown;
-                    };
-                    content: {
-                        "application/json": {
-                            success: boolean;
-                        };
-                    };
-                };
-                /** @description Unauthorized */
-                401: {
-                    headers: {
-                        [name: string]: unknown;
-                    };
-                    content: {
-                        "application/json": components["schemas"]["Error"];
-                    };
-                };
-                /** @description Insufficient permissions */
-                403: {
-                    headers: {
-                        [name: string]: unknown;
-                    };
-                    content: {
-                        "application/json": components["schemas"]["Error"];
-                    };
-                };
-                /** @description Not found */
-                404: {
-                    headers: {
-                        [name: string]: unknown;
-                    };
-                    content: {
-                        "application/json": components["schemas"]["Error"];
-                    };
-                };
-            };
-        };
-        delete?: never;
-        options?: never;
-        head?: never;
-        patch?: never;
-        trace?: never;
-    };
-    "/v1/surfaces": {
+    "/v1/surfaces/{surfaceId}": {
         parameters: {
             query?: never;
             header?: never;
@@ -45367,60 +46312,86 @@ interface paths {
             cookie?: never;
         };
         /**
-         * List surfaces
-         * @description List product surfaces across the authenticated user/org's products with cursor-based pagination. Supports filtering by product, type, and status. Slack inbound config is returned only for Slack surfaces and only includes safe-to-expose keys.
+         * Get surface details
+         * @description Get an authorized surface by its globally unique ID, including items and keys.
          */
         get: {
             parameters: {
-                query?: {
-                    limit?: string;
-                    cursor?: string;
-                    productId?: string;
-                    type?: string;
-                    status?: string;
-                };
+                query?: never;
                 header?: never;
-                path?: never;
+                path: {
+                    surfaceId: string;
+                };
                 cookie?: never;
             };
             requestBody?: never;
             responses: {
-                /** @description Paginated list of surfaces */
+                /** @description Surface details */
                 200: {
                     headers: {
                         [name: string]: unknown;
                     };
                     content: {
                         "application/json": {
-                            data: {
+                            behavior?: unknown;
+                            createdAt: string;
+                            /** @description Canonical public URL of this surface (MCP, API, A2A, AG-UI, webhook, chat). Null for surface types reached through their own channels (Slack, email, schedule, ...). Clients should use this instead of constructing the URL themselves. */
+                            endpoint: string | null;
+                            id: string;
+                            inbound?: unknown;
+                            items: {
+                                agentId: string | null;
+                                agentType: string | null;
+                                cachedSkills: unknown[] | null;
+                                capabilityId: string;
+                                capabilityName: string | null;
+                                config?: unknown;
                                 createdAt: string;
-                                /** @description Canonical public URL of this surface (MCP, API, A2A, AG-UI, webhook, chat). Null for surface types reached through their own channels (Slack, email, schedule, ...). Clients should use this instead of constructing the URL themselves. */
-                                endpoint: string | null;
+                                displayOrder: number | null;
+                                enabled: boolean;
+                                endpointSlug: string | null;
+                                exposedDescription: string | null;
+                                exposedName: string | null;
+                                flowId: string | null;
+                                id: string;
+                                isEntryPoint: boolean;
+                                parametersSchema?: unknown;
+                            }[];
+                            keys: {
+                                canReveal: boolean;
+                                createdAt: string;
+                                environment: string;
+                                expiresAt: string | null;
+                                id: string;
+                                isActive: boolean;
+                                isDevelopment: boolean;
+                                keyHint: string | null;
+                                keyPrefix: string;
+                                lastUsedAt: string | null;
+                                name: string | null;
+                                rateLimitPerDay: number | null;
+                                rateLimitPerMinute: number | null;
+                                scopeTargetIds: string[] | null;
+                                scopes: string[];
+                                usageCount: number | null;
+                            }[];
+                            name: string;
+                            outbound?: unknown;
+                            productId: string;
+                            scopeTargets: {
+                                capabilityId?: string;
                                 id: string;
-                                inbound: {
-                                    appId?: string;
-                                    continueThreads?: boolean;
-                                    integrationId?: string;
-                                    listenChannels?: string[];
-                                    listenDms?: boolean;
-                                    teamId?: string;
-                                    teamName?: string;
-                                    triggerOnMention?: boolean;
-                                } | null;
                                 name: string;
-                                productId: string;
-                                /** @description Name of the product this surface belongs to. Non-nullable: the list query inner-joins products (so a surface with no product cannot appear) and products.name is NOT NULL. Present so a cross-product picker can disambiguate two surfaces that share a name. */
-                                productName: string;
-                                status: string;
-                                type: string;
-                                updatedAt: string;
-                                webhookHealth: components["schemas"]["WebhookHealth"];
+                                surfaceItemId?: string;
                             }[];
-                            pagination: components["schemas"]["Pagination"];
+                            status: string;
+                            type: string;
+                            updatedAt: string;
+                            webhookHealth: components["schemas"]["WebhookHealth"];
                         };
                     };
                 };
-                /** @description Invalid parameters */
+                /** @description Invalid surface ID */
                 400: {
                     headers: {
                         [name: string]: unknown;
@@ -45447,6 +46418,15 @@ interface paths {
                         "application/json": components["schemas"]["Error"];
                     };
                 };
+                /** @description Surface not found */
+                404: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["Error"];
+                    };
+                };
                 /** @description Internal server error */
                 500: {
                     headers: {
@@ -45466,7 +46446,7 @@ interface paths {
         patch?: never;
         trace?: never;
     };
-    "/v1/surfaces/{surfaceId}": {
+    "/v1/surfaces/{surfaceId}/channel-context": {
         parameters: {
             query?: never;
             header?: never;
@@ -45474,12 +46454,15 @@ interface paths {
             cookie?: never;
         };
         /**
-         * Get surface details
-         * @description Get an authorized surface by its globally unique ID, including items and keys.
+         * Read a channel context window
+         * @description Read the recent channel messages a Slack, Telegram or iMessage surface holds for one channel or group (at most 20, newest 24 hours, oldest first), each with the response gate decision recorded for it, and the next-turn labels recorded on those decisions. Skipped messages create no conversation, so this is where their decisions are read.
          */
         get: {
             parameters: {
-                query?: never;
+                query: {
+                    /** @description Slack channel ID, Telegram chat ID, or iMessage group ID. */
+                    channelId: string;
+                };
                 header?: never;
                 path: {
                     surfaceId: string;
@@ -45488,72 +46471,24 @@ interface paths {
             };
             requestBody?: never;
             responses: {
-                /** @description Surface details */
+                /** @description The channel window with its gate decisions and labels */
                 200: {
                     headers: {
                         [name: string]: unknown;
                     };
                     content: {
                         "application/json": {
-                            behavior?: unknown;
-                            createdAt: string;
-                            /** @description Canonical public URL of this surface (MCP, API, A2A, AG-UI, webhook, chat). Null for surface types reached through their own channels (Slack, email, schedule, ...). Clients should use this instead of constructing the URL themselves. */
-                            endpoint: string | null;
-                            id: string;
-                            inbound?: unknown;
-                            items: {
-                                agentId: string | null;
-                                agentType: string | null;
-                                cachedSkills: unknown[] | null;
-                                capabilityId: string;
-                                capabilityName: string | null;
-                                config?: unknown;
-                                createdAt: string;
-                                displayOrder: number | null;
-                                enabled: boolean;
-                                endpointSlug: string | null;
-                                exposedDescription: string | null;
-                                exposedName: string | null;
-                                flowId: string | null;
-                                id: string;
-                                isEntryPoint: boolean;
-                                parametersSchema?: unknown;
-                            }[];
-                            keys: {
-                                canReveal: boolean;
-                                createdAt: string;
-                                environment: string;
-                                expiresAt: string | null;
-                                id: string;
-                                isActive: boolean;
-                                isDevelopment: boolean;
-                                keyHint: string | null;
-                                keyPrefix: string;
-                                lastUsedAt: string | null;
-                                name: string | null;
-                                rateLimitPerDay: number | null;
-                                rateLimitPerMinute: number | null;
-                                scopeTargetIds: string[] | null;
-                                scopes: string[];
-                                usageCount: number | null;
-                            }[];
-                            name: string;
-                            outbound?: unknown;
-                            productId: string;
-                            scopeTargets: {
-                                capabilityId?: string;
-                                id: string;
-                                name: string;
-                                surfaceItemId?: string;
-                            }[];
-                            status: string;
-                            type: string;
-                            updatedAt: string;
-                            webhookHealth: components["schemas"]["WebhookHealth"];
+                            channelId: string;
+                            /** @description Labels on decisions the channel still retains (newest 50 messages, 24 hours), oldest first. Empty until a next turn produces one. */
+                            labels: components["schemas"]["ChannelContextLabel"][];
+                            messages: components["schemas"]["ChannelContextMessage"][];
+                            /** @enum {string} */
+                            provider: "slack" | "telegram" | "imessage";
+                            surfaceId: string;
                         };
                     };
                 };
-                /** @description Invalid surface ID */
+                /** @description Invalid surface ID, or a surface type without a channel context */
                 400: {
                     headers: {
                         [name: string]: unknown;
@@ -45589,15 +46524,6 @@ interface paths {
                         "application/json": components["schemas"]["Error"];
                     };
                 };
-                /** @description Internal server error */
-                500: {
-                    headers: {
-                        [name: string]: unknown;
-                    };
-                    content: {
-                        "application/json": components["schemas"]["Error"];
-                    };
-                };
             };
         };
         put?: never;
@@ -45725,7 +46651,7 @@ interface paths {
         };
         /**
          * Inspect OTLP admission, queryability, and durable recovery debt
-         * @description Owner-scoped delivery receipts retained for 30 days. Lag is acceptance to the first positive query probe, not stream ACK latency or a production SLO guarantee. Idle is not proof of sink health. No transcripts or retained payloads are returned. Requires ANALYTICS:READ or AGENTS:READ; TELEMETRY:WRITE alone is append-only.
+         * @description Owner-scoped delivery receipts retained for 30 days. Lag is acceptance to confirmation (a positive hot receipt read, or a successful raw send), not a production SLO guarantee. Idle is not proof of sink health. No transcripts or retained payloads are returned. Requires ANALYTICS:READ or AGENTS:READ; TELEMETRY:WRITE alone is append-only.
          */
         get: operations["getOtlpIngestHealth"];
         put?: never;
@@ -47481,18 +48407,22 @@ interface paths {
                         parameters: {
                             [key: string]: unknown;
                         };
+                        /** @description Built-in tools only: the instance config an agent's toolConfigs entry would carry, validated against the tool's configSchema. Rejected for a saved tool. */
+                        toolConfig?: {
+                            [key: string]: unknown;
+                        };
                         toolId?: string;
                     };
                 };
             };
             responses: {
-                /** @description Tool execution result (JSON for non-flow tools, SSE stream for flow tools) */
+                /** @description Tool execution result: BuiltinToolExecuteResult for a builtin: or platform: id, ExecuteToolResult for a saved non-flow tool, an SSE stream for a flow tool */
                 200: {
                     headers: {
                         [name: string]: unknown;
                     };
                     content: {
-                        "application/json": {
+                        "application/json": components["schemas"]["BuiltinToolExecuteResult"] | {
                             error?: string;
                             executionId: string;
                             executionTimeMs: number;
@@ -47502,13 +48432,13 @@ interface paths {
                         };
                     };
                 };
-                /** @description Validation error */
+                /** @description Invalid request, tool config, or judgment input */
                 400: {
                     headers: {
                         [name: string]: unknown;
                     };
                     content: {
-                        "application/json": components["schemas"]["Error"];
+                        "application/json": components["schemas"]["ToolExecuteError"];
                     };
                 };
                 /** @description Unauthorized */
@@ -47529,13 +48459,22 @@ interface paths {
                         "application/json": components["schemas"]["Error"];
                     };
                 };
-                /** @description Tool not found */
+                /** @description Tool not found, or a judgment question set that does not resolve */
                 404: {
                     headers: {
                         [name: string]: unknown;
                     };
                     content: {
-                        "application/json": components["schemas"]["Error"];
+                        "application/json": components["schemas"]["ToolExecuteError"];
+                    };
+                };
+                /** @description A judgment the gateway cannot serve: an unlisted model or no gateway credential */
+                422: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["ToolExecuteError"];
                     };
                 };
                 /** @description Internal server error */
@@ -47585,13 +48524,13 @@ interface paths {
                 };
             };
             responses: {
-                /** @description Tool execution result (forwarded from the execute endpoint) */
+                /** @description Tool execution result, forwarded from the execute endpoint */
                 200: {
                     headers: {
                         [name: string]: unknown;
                     };
                     content: {
-                        "application/json": {
+                        "application/json": components["schemas"]["BuiltinToolExecuteResult"] | {
                             error?: string;
                             executionId: string;
                             executionTimeMs: number;
@@ -47601,6 +48540,15 @@ interface paths {
                         };
                     };
                 };
+                /** @description Invalid request, tool config, or judgment input */
+                400: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["ToolExecuteError"];
+                    };
+                };
                 /** @description Unauthorized */
                 401: {
                     headers: {
@@ -47619,6 +48567,24 @@ interface paths {
                         "application/json": components["schemas"]["Error"];
                     };
                 };
+                /** @description Tool not found, or a judgment question set that does not resolve */
+                404: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["ToolExecuteError"];
+                    };
+                };
+                /** @description A judgment the gateway cannot serve: an unlisted model or no gateway credential */
+                422: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["ToolExecuteError"];
+                    };
+                };
                 /** @description Internal server error */
                 500: {
                     headers: {
@@ -48730,6 +49696,8 @@ interface components {
                         thinkingLevel?: string;
                     };
                     sandbox?: {
+                        /** @description Coding agents the Sandbox can run as typed sessions. Non-empty adds the agent_session_* tools; empty or absent adds none. */
+                        codingAgents?: "opencode"[];
                         enabled: boolean;
                         /**
                          * @description Only standard-4 is supported on the hosted Agent Sandbox path; other sizes cannot be enabled.
@@ -48845,6 +49813,7 @@ interface components {
                                 [key: string]: unknown;
                             };
                             description: string;
+                            hiddenParameterNames?: string[];
                             idempotent?: boolean;
                             name: string;
                             parametersSchema: {
@@ -49009,6 +49978,15 @@ interface components {
         } & {
             [key: string]: unknown;
         };
+        BuiltinToolExecuteResult: {
+            /** @description Execution metadata for the caller, never part of a model-facing tool result. builtin:typesafe_judge sets metadata.judgment: requestedModel, resolvedModelId, keySource, questionSetId and questionSetVersion (configured mode), usage { inputTokens, outputTokens, reported }, and estimatedCostUsd (provider rates, before margin). */
+            metadata?: {
+                [key: string]: unknown;
+            };
+            result?: unknown;
+            toolId: string;
+            toolName: string;
+        };
         CaptureExecutionPreview: {
             /** @description The recorded tool-call actions in invocation order — the fork-picker rows. */
             actions: components["schemas"]["CaptureExecutionPreviewAction"][];
@@ -49036,6 +50014,53 @@ interface components {
             /** @description True when every recorded tool output was captured in full. False when any output was truncated at capture — the case still saves, but tool outputs are partial ("⚠ tool outputs weren’t fully captured"). */
             replayable: boolean;
         };
+        ChannelContextDecision: {
+            /** @description Whether the assistant ran for this message. */
+            activated: boolean;
+            /**
+             * @description The response gate decision. not_judged means no judgment answered: the mode never asks one, or the judgment failed and the message waited for a mention.
+             * @enum {string}
+             */
+            decision: "not_judged" | "reply" | "silent" | "band";
+            /**
+             * @description Why the judgment did not answer, when one was asked and failed. error: the model call failed for a reason other than a provider server error, for example a missing credential or a rejected request. upstream: the model provider returned a server error. timeout: the model budget ran out. unanswered: the model gave no decision. no_assistant: the surface has no product to describe. preparation: the pre-model loads failed or ran out of time. circuit_open: repeated upstream failures paused judgments, so none was asked. Absent on a decision that answered, and on decisions recorded before this field existed.
+             * @enum {string}
+             */
+            failure?: "error" | "upstream" | "timeout" | "unanswered" | "no_assistant" | "preparation" | "circuit_open";
+            /** @description The judged shouldReply probability; absent when not_judged. */
+            probability?: number;
+        } | null;
+        ChannelContextLabel: {
+            decision: components["schemas"]["ChannelContextDecision"];
+            /** @description The labeled message, whose decision the label judges. */
+            externalMessageId: string;
+            /**
+             * @description gate_false_negative: the assistant stayed silent and a person mentioned it soon after. gate_false_positive: the assistant replied and a person pushed back. backfill_false_negative: after a judged context backfill, a person said the answer was already above.
+             * @enum {string}
+             */
+            label: "gate_false_negative" | "gate_false_positive" | "backfill_false_negative";
+            /** @description ISO timestamp the label was recorded. */
+            labeledAt: string;
+            /**
+             * @description The next-turn signal that produced the label.
+             * @enum {string}
+             */
+            source: "mention_after_silence" | "not_you_reply" | "negative_reaction" | "reply_deleted" | "already_said_reply";
+        };
+        ChannelContextMessage: {
+            authorId: string;
+            /** @enum {string} */
+            authorKind: "user" | "assistant" | "bot";
+            decision: components["schemas"]["ChannelContextDecision"];
+            externalMessageId: string;
+            hasAttachment: boolean;
+            mentionsAssistant: boolean;
+            /** @description Message text, truncated to 1,000 characters. */
+            text: string;
+            threadId?: string;
+            /** @description ISO timestamp of the provider message. */
+            timestamp: string;
+        };
         ClientInputDeliveryReceipt: {
             deliveryId: string;
             executionId: string;
@@ -49970,6 +50995,9 @@ interface components {
             /** @enum {string} */
             type: "turn_start";
         } | {
+            attributes?: {
+                [key: string]: string | number | boolean;
+            };
             completedAt?: string;
             content?: string;
             cost?: number;
@@ -50036,6 +51064,9 @@ interface components {
             /** @enum {string} */
             type: "model_call_start";
         } | {
+            attributes?: {
+                [key: string]: string | number | boolean;
+            };
             completedAt?: string;
             cost?: number;
             durationMs?: number;
@@ -50059,6 +51090,7 @@ interface components {
                 cacheWrite?: number;
                 input: number;
                 output: number;
+                reasoning?: number;
             };
             turnId?: string;
             /** @enum {string} */
@@ -50634,6 +51666,23 @@ interface components {
             /** @enum {string} */
             status: "pending" | "applied" | "settled" | "not_applied";
         };
+        JudgmentCalibrationRecord: {
+            createdAt: string;
+            createdByUserId: string | null;
+            evalRunId: string | null;
+            id: string;
+            measuredModel: string;
+            questionSetVersionId: string;
+            /** @description The calibration record as posted. */
+            record: {
+                [key: string]: unknown;
+            };
+            /**
+             * @description Derived: `eval_suite` only when the posted `evalRunId` resolved to an eval run in this account.
+             * @enum {string}
+             */
+            source: "eval_suite" | "customer";
+        };
         ManagedAgentRunOutput: {
             anthropicFileId: string;
             /** @description Asset-storage key the bytes were persisted to. */
@@ -50819,6 +51868,45 @@ interface components {
             productId: string;
             updatedAt: string | null;
         };
+        QuestionSet: {
+            createdAt: string;
+            createdByUserId: string | null;
+            /** @description The published version executions resolve when they name no version; null until a publish. */
+            currentVersionId: string | null;
+            description: string | null;
+            id: string;
+            name: string;
+            organizationId: string;
+            slug: string;
+            updatedAt: string;
+        };
+        QuestionSetError: components["schemas"]["Error"] & {
+            /** @description Stable code, e.g. QUESTION_SET_INVALID or QUESTION_SET_UNRESOLVED. */
+            code?: string;
+        };
+        QuestionSetListItem: components["schemas"]["QuestionSet"] & {
+            currentVersionNumber: number | null;
+            latestVersionNumber: number;
+        };
+        QuestionSetVersion: {
+            createdAt: string;
+            createdByUserId: string | null;
+            currentCalibrationId: string | null;
+            id: string;
+            inputMapping: {
+                [key: string]: string;
+            } | null;
+            /** @description Requested judgment model id; null uses the platform default. */
+            model: string | null;
+            /** @description Set once, at the first publish; a published version never changes. */
+            publishedAt: string | null;
+            questionSetId: string;
+            /** @description Judgment questions keyed by question id. Each is `{ type: "boolean" | "choice" | "score", instructions, criteria }`. The id is never sent to the model, so instructions and criteria carry the meaning. */
+            questions: {
+                [key: string]: unknown;
+            };
+            versionNumber: number;
+        };
         RecordFilterCondition: {
             field: string;
             /** @enum {string} */
@@ -50839,6 +51927,29 @@ interface components {
             recordName?: string;
             schemaVersion: number;
         };
+        ResolvedQuestionSet: {
+            calibration: {
+                createdAt: string;
+                id: string;
+                measuredModel: string;
+                record: {
+                    [key: string]: unknown;
+                };
+                /** @enum {string} */
+                source: "eval_suite" | "customer";
+            } | null;
+            id: string;
+            inputMapping: {
+                [key: string]: string;
+            } | null;
+            model: string | null;
+            /** @description Judgment questions keyed by question id. Each is `{ type: "boolean" | "choice" | "score", instructions, criteria }`. The id is never sent to the model, so instructions and criteria carry the meaning. */
+            questions: {
+                [key: string]: unknown;
+            };
+            slug: string;
+            version: number;
+        };
         RunEvalResponse: {
             /** @description The release alias the run resolved through, when it resolved through one. */
             agentTargetAlias?: string | null;
@@ -50925,6 +52036,10 @@ interface components {
             batchExecutionId: string | null;
             /** @description Budget exhausted. Absent means the overlay did not answer, which is not false and not null. */
             budgetExhausted?: boolean | null;
+            /** @description Prompt-cache reads summed over the run's model calls (a subset of inputTokens). Returned by GET /v1/runs/{executionId} only; null means no model call reported one. */
+            cacheReadTokens?: number | null;
+            /** @description Prompt-cache writes summed over the run's model calls (a subset of inputTokens). Returned by GET /v1/runs/{executionId} only; null means no model call reported one. */
+            cacheWriteTokens?: number | null;
             /** @description Cancel request. Absent means the overlay did not answer, which is not false and not null. */
             cancelRequestedAt?: string | null;
             /** @description How many runs name this one as their parent. The unscoped feed returns roots only, so this is the size of the fold underneath a row; read the children with parentExecutionId=<executionId>. It is populated on a resource-scoped page too, where nothing is folded, so a surface can still offer the same expansion. WHICH children are counted depends on the arm that served the row: the span store counts every child, agent and nested-flow alike, while the legacy control-plane fallback counts agent children only, so on that arm a parent whose only child is a nested flow reports 0. That is deliberate — the fallback arm cannot enumerate a nested-flow child either, so counting one would advertise a fold that opens on nothing. It counts only children the CALLER may read: a credential holding one execution family (AGENTS:READ or FLOWS:READ alone) counts the children of that family and no others, so a count never discloses a run the same credential could not list. NULL means the arm cannot count children at all, which is not zero. */
@@ -50982,6 +52097,8 @@ interface components {
             pendingApproval?: unknown;
             /** @description Live progress document. Absent means the overlay did not answer, which is not false and not null. */
             progress?: unknown;
+            /** @description Reasoning tokens summed over the run's model calls (a subset of outputTokens). Returned by GET /v1/runs/{executionId} only; null means no model call reported one. */
+            reasoningTokens?: number | null;
             /** @description Record this run processed. */
             recordId: string | null;
             /** @description Retention removed the spans; the run still lists and reads as completed. */
@@ -51248,6 +52365,13 @@ interface components {
             result: "plan";
             toolId?: string;
         };
+        ToolExecuteError: components["schemas"]["Error"] & {
+            /** @description Stable code for a caller-fixable failure, e.g. JUDGMENT_QUESTIONS_INVALID or QUESTION_SET_UNRESOLVED. */
+            code?: string;
+            details?: {
+                [key: string]: unknown;
+            };
+        };
         ToolPullResponse: {
             contentHash: string;
             definition: {
@@ -51339,6 +52463,7 @@ interface components {
             providerRateLimitHeaders?: {
                 [key: string]: string;
             } | null;
+            reasoningTokens?: number | null;
             recordId?: string | null;
             recordName?: string | null;
             requestId?: string | null;
@@ -51576,6 +52701,7 @@ interface operations {
                                 repairs: number;
                                 waiting: number;
                             };
+                            /** @description Hot tier: confirmed by a positive receipt read, not a stream acknowledgment. */
                             hot: {
                                 confirmed: number;
                                 maximumConfirmedLagMs: number | null;
@@ -51583,6 +52709,7 @@ interface operations {
                                 repairs: number;
                                 waiting: number;
                             };
+                            /** @description Raw storage tier: confirmed when its send succeeds (at-least-once, no read-back). `waiting` counts rows whose send has not yet succeeded. */
                             raw: {
                                 confirmed: number;
                                 maximumConfirmedLagMs: number | null;
@@ -51605,7 +52732,7 @@ interface operations {
                         trace: {
                             acceptedAt: string;
                             completeness: string;
-                            /** @description Receipt counts for this trace only; confirmations require positive tier reads, not stream acknowledgments. */
+                            /** @description Receipt counts for this trace only; hot confirmations require a positive receipt read, raw confirmations a successful send. */
                             delivery: {
                                 accepted: number;
                                 /** @description Deprecated: the canonical storage tier is retired and every field is permanently zero. It is emitted only so already-published SDKs, which model it as required, keep parsing; it is removed in a following release. */
@@ -53796,14 +54923,40 @@ interface UpdateToolRequest {
 interface ExecuteToolRequest {
     toolId: string;
     parameters: JsonObject;
+    /** Built-in tools only: the instance config, validated against the tool's configSchema. */
+    toolConfig?: JsonObject;
 }
-interface ExecuteToolResponse {
+/**
+ * `POST /v1/tools/{id}/execute` (and `/test`) for a saved non-flow tool
+ * (OpenAPI `ExecuteToolResult`).
+ */
+interface SavedToolExecuteResponse {
     executionId: string;
-    result: JsonValue;
-    status: 'success' | 'failed';
+    status: 'pending' | 'success' | 'failed' | 'waiting_for_local';
+    result?: JsonValue;
+    error?: string;
+    /** @deprecated The API never sends this field; read `error`. */
     errorMessage?: string;
     executionTimeMs: number;
 }
+/**
+ * `POST /v1/tools/{id}/execute` (and `/test`) for a `builtin:` or `platform:`
+ * tool (OpenAPI `BuiltinToolExecuteResult`).
+ */
+interface BuiltinToolExecuteResponse {
+    toolId: string;
+    toolName: string;
+    result?: JsonValue;
+    /** Built-in execution metadata a model never sees, e.g. `metadata.judgment`. */
+    metadata?: JsonObject;
+}
+/**
+ * The tool execute response: a built-in result for a `builtin:` or
+ * `platform:` id, a saved-tool result otherwise. Narrow with
+ * `isBuiltinToolExecuteResponse` before reading shape-specific fields.
+ */
+type ExecuteToolResponse = SavedToolExecuteResponse | BuiltinToolExecuteResponse;
+declare function isBuiltinToolExecuteResponse(response: ExecuteToolResponse): response is BuiltinToolExecuteResponse;
 type SandboxDeployRetention = '10m' | '1h' | '24h' | 'unlimited';
 type SandboxDeploySleepPolicy = {
     mode: 'never';
@@ -53915,6 +55068,12 @@ interface RuntimeTool {
      * re-decides, rather than silently re-fired.
      */
     idempotent?: boolean;
+    /**
+     * Parameters the runtime fills from execution variables (or `_record.metadata`)
+     * and strips from the schema the model sees. Names starting with `_internal`
+     * are rejected at save time.
+     */
+    hiddenParameterNames?: string[];
 }
 type RuntimeToolConfig = RuntimeFlowToolConfig | RuntimeCustomToolConfig | RuntimeExternalToolConfig | RuntimeLocalToolConfig | RuntimeSubagentToolConfig;
 interface RuntimeLocalToolConfig {
@@ -54277,7 +55436,12 @@ interface LogQueryParams {
     executionId?: string;
     surfaceId?: string;
     conversationId?: string;
+    /** Substring match on a span's message, name, operation, tool name or error class. */
     search?: string;
+    /** Comma-separated statuses (completed,failed,unknown,running,queued,cancelled). */
+    status?: string;
+    /** Comma-separated entry types (flow,step,tool,batch,system,agent,model,schedule,audit). */
+    type?: string;
     limit?: number;
     cursor?: string;
     order?: 'asc' | 'desc';
@@ -57924,6 +59088,12 @@ interface RunListRow {
     spanCount: number | null;
     inputTokens: number | null;
     outputTokens: number | null;
+    /** Prompt-cache reads over the run's model calls (subset of inputTokens); `GET /v1/runs/{id}` only. */
+    cacheReadTokens?: number | null;
+    /** Prompt-cache writes over the run's model calls (subset of inputTokens); `GET /v1/runs/{id}` only. */
+    cacheWriteTokens?: number | null;
+    /** Reasoning tokens over the run's model calls (subset of outputTokens); `GET /v1/runs/{id}` only. */
+    reasoningTokens?: number | null;
     totalCost: string | null;
     selfReportedCost: string | null;
     /**
@@ -58014,6 +59184,8 @@ interface RunListResponse {
         hasMore: boolean;
         hasPrev: boolean;
         limit: number;
+        /** True when the supplied cursor was rejected and the read restarted at page one; stop paging. */
+        cursorReset?: boolean;
     };
     window: {
         from: string;
@@ -61396,6 +62568,8 @@ interface AgentRuntimeToolDefinition {
     toolType: 'flow' | 'custom' | 'external' | 'local' | 'subagent';
     parametersSchema: Record<string, unknown>;
     config?: Record<string, unknown>;
+    /** Parameters filled from execution variables and hidden from the model's schema. */
+    hiddenParameterNames?: string[];
 }
 /**
  * Agent execute request
@@ -64333,4 +65507,4 @@ declare function getLikelySupportingCandidatePaths(bestCandidatePath: string | u
 declare function getDefaultPlanPath(taskName: string): string;
 declare function sanitizeTaskSlug(taskName: string): string;
 
-export { type AIGrader, type ActivateAgentAliasInput, type ActivateAgentPromotionInput, type Agent, type AgentAdmissionOptions, type AgentAlias, type AgentAliasActivation, type AgentAliasArchiveFailure, type AgentAliasArchived, AgentAliasDependencyError, type AgentAliasList, AgentAliasNotFoundError, AgentAliasPreviewLimitError, AgentAliasRevisionMismatchError, AgentAliasRevisionRequiredError, type AgentAliasTransport, AgentAliasesNamespace, type AgentApprovalCompleteEvent, type AgentApprovalStartEvent, type AgentCompleteEvent, type AgentDefinition, type AgentDefinitionConfig, type AgentDeploymentList, type AgentDeploymentPromotion, type AgentDeploymentReceipt, AgentDeploymentsNamespace, AgentDriftError, type AgentElicitation, type AgentElicitationRequest, AgentEnsureConflictError, type AgentErrorEvent, type AgentEvent, type AgentEventType, type AgentExecuteRequest, type AgentExecuteResponse, type AgentIterationCompleteEvent, type AgentIterationStartEvent, type AgentMediaEvent, type AgentMessage, type AgentPausedEvent, type AgentPingEvent, AgentPromotionError, type AgentPromotionManifest, type AgentPromotionTransport, type AgentPromotionValidation, type AgentPullResult, type AgentReflectionEvent, type AgentRunInsightsResponse, type AgentRuntimeToolDefinition, type AgentStartEvent, type AgentStreamCallbacks, type AgentStreamEvent, type AgentSubagentConfig, type AgentToolCompleteEvent, type AgentToolDeltaEvent, type AgentToolInputCompleteEvent, type AgentToolInputDeltaEvent, type AgentToolStartEvent, type AgentTurnCompleteEvent, type AgentTurnDeltaEvent, type AgentTurnStartEvent, type AgentVersionDetail, type AgentVersionListItem, type AgentVersionPublishResponse, AgentVersionsEndpoint, type AgentVersionsListResponse, AgentsEndpoint, AgentsNamespace, AnalyticsEndpoint, type ApiClient, type ApiKey, type ApiKeyRequest, type ApiKeyRequestDelivery, type ApiKeyRequestEnvironment, type ApiKeyRequestHandoff, type ApiKeyRequestListParams, type ApiKeyRequestRequester, type ApiKeyRequestStatus, ApiKeyRequestsEndpoint, ApiKeysEndpoint, type ApiResponse, type ApplyGeneratedProposalOptions, type ApplyGeneratedProposalResult, type ArchiveAgentAliasEverywhereResult, type ArchiveAgentAliasInput, type AssetReferenceContentPart, type AsyncExecutionHandle, type AsyncExecutionStatus, type AttachRuntimeToolsOptions, type BaseAgentEvent, BatchBuilder, type BatchClient, type BatchListParams, type BatchOptions, type BatchRequest, type BatchResult, type BatchScheduleConfig, type BatchStatus, BatchesNamespace, BillingEndpoint, type BillingSpendAnalyticsParams, type BindSkillInput, type BuiltInGraderId, type BuiltInTool, type BulkEditCondition, type BulkEditRequest, type BulkEditResponse, type BulkEditResult, type CanonicalDispatchMessageContent, type CanonicalDispatchRequest, type CaseExpected, type CatalogClientToolRef, ChatEndpoint, type CheckGrader, type ClaimApiKeyRequestInput, type ClaimApiKeyRequestResponse, type ClaudeManagedEvalOverrideValues, ClientBatchBuilder, type ClientConfig, type ClientConversation, ClientEvalBuilder, ClientFlowBuilder, type ClientToken, type ClientTokenConfig, type ClientTokenEnvironment, type ClientTokenVersionPin, ClientTokensEndpoint, type ClientToolDefinition, type ClientToolEntry, type ClientWidgetTheme, type CollectionMeta, CollectionsEndpoint, type ConditionalGetResult, type ConditionalStepConfig$1 as ConditionalStepConfig, type ContextErrorHandling, type ContextFallback, ContextTemplatesEndpoint, type Conversation, type ConversationListItem, type ConversationListParams, type ConversationMessage, type ConversationSource, ConversationsEndpoint, type ConversationsListResponse, type CreateApiKeyRequest, type CreateApiKeyRequestInput, type CreateApiKeyRequestResponse, type CreateClientTokenRequest, type CreateClientTokenResponse, type CreateCollectionRequest, type CreateConversationRequest, type CreateEvalSuiteInput, type CreateFlowRequest, type CreateModelConfigRequest, type CreatePromptData, type CreatePromptRequest, type CreateProviderKeyRequest, type CreateRecordRequest, type CreateScheduleRequest, type CreateSecretRequest, type CreateToolRequest, type CurrentBilledSpendResponse, type CurrentBilledSpendSource, type CustomMCPServer, type CustomMCPServerAuth, type CustomToolConfig, DEFAULT_MAX_DETACHED_RECONNECTS, DEFAULT_RECOVERY_AFTER_EMPTY_SESSIONS, DEFAULT_STALL_STOP_AFTER, type DecomposeCriteriaResult, type DefineAgentInput, type DefineEvalCaseInput, type DefineEvalInput, type DefineFlowInput, type DefineProductInput, type DefineSkillInput, type DefineSurfaceInput, type DefineToolInput, type DeployCfSandboxRequest, type DeployCfSandboxResponse, type DeploySandboxRequest, type DeploySandboxResponse, type DetachedReattach, type DetachedReconnectOptions, type DiscoveredModel, type DispatchAgentInput, type DispatchApprovalContinuationResponse, type DispatchApproveRequest, type DispatchApproveResponse, type DispatchClient, type DispatchContinuationRequest, type DispatchContinuationResponse, type DispatchDetachedApprovalResponse, type DispatchDetachedToolOutputResponse, DispatchEndpoint, type DispatchEnvironment, type DispatchEvent, type DispatchFlowInput, type DispatchMessageContent, type DispatchOptions$1 as DispatchOptions, type DispatchRequest, type DispatchResponse, type DispatchResumeJsonResponse, type DispatchResumeRequest, type DispatchResumeResponse, ENSURE_RELEASE_DEPLOY_CONFLICT_MESSAGE, type EndUserUsageQuery, type EndUserUsageResponse, type EnsureAgentConverged, type EnsureAgentOptions, type EnsureAgentPlan, type EnsureAgentResult, type EnsureEvalResult, type EnsureFlowConverged, type EnsureFlowOptions, type EnsureFlowPlan, type EnsureFlowResult, type EnsureFpoOptions, type EnsureFpoResult, type EnsureProductConverged, type EnsureProductOptions, type EnsureProductPlan, type EnsureProductResult, type EnsureSkillConverged, type EnsureSkillOptions, type EnsureSkillPlan, type EnsureSkillResult, type EnsureSurfaceConverged, type EnsureSurfaceOptions, type EnsureSurfacePlan, type EnsureSurfaceResult, type EnsureToolConverged, type EnsureToolOptions, type EnsureToolPlan, type EnsureToolResult, type ErrorHandlingMode, type EvalAgentSelector, type EvalAgentTargetResolution, EvalBuilder, type EvalCaseDefinition, type EvalCaseInput, type EvalCaseProposal, type EvalCaseProposalAccepted, type EvalCaseProposalListResult, type EvalCasesGenerated, type EvalClient, type EvalDefinition, EvalEndpoint, type EvalListParams, type EvalMessage, type EvalOptions, type EvalOverrideValues, type EvalProposalSource, type EvalProposalStatus, type EvalProposedCase, type EvalPullResult, type EvalRecord, type EvalRequest, type EvalResult, type EvalRunCaseScores, type EvalRunConfig, type EvalRunEvidence, type EvalRunScores, EvalRunner, type EvalStatus, type EvalSuiteCase, type EvalSuiteCaseInput, type EvalSuiteCoverage, type EvalSuiteDetail, type EvalSuiteLatestRun, type EvalSuiteListResult, type EvalSuiteRunQueued, type EvalSuiteRunResult, type EvalSuiteSummary, EvalSuitesNamespace, type EvalTarget, EvalsNamespace, type ExecuteToolRequest, type ExecuteToolResponse, type ExecutionCounts, type ExecutionStreamEvent, ExecutionsEndpoint, ExecutionsNamespace, type ExternalAgentContext, type ExternalToolConfig, type FallbackFailEvent, type FallbackStartEvent, type FallbackSuccessEvent, type FallbackTrigger, type FallbackTriggerType, type FallbacksExhaustedEvent, type FallbacksInitiatedEvent, type FetchUrlStepConfig$1 as FetchUrlStepConfig, type FieldFormat, type FileContentPart, type Flow, type FlowAttachment, FlowBuilder, type FlowCompleteEvent, type FlowConfig$1 as FlowConfig, type FlowDefinition, type FlowDefinitionStep, FlowDriftError, FlowEnsureConflictError, type FlowErrorEvent, type FlowFallback, type FlowInlineEvalInput, type FlowListItem, type FlowPausedEvent, type FlowPullResult, FlowResult, type FlowStartEvent, type FlowStep, type FlowStepDefinition, type FlowStepType, FlowStepsEndpoint, type FlowStreamEvent, type FlowSummary, type FlowToolConfig, type FlowValidationClient, type FlowValidationIssue, type FlowValidationResult, type FlowVersionDetail, type FlowVersionListItem, type FlowVersionPublishResponse, FlowVersionsEndpoint, type FlowVersionsListResponse, FlowsEndpoint, FlowsNamespace, type FpoEntityOutcome, type FpoInput, type GenerateEmbeddingStepConfig$1 as GenerateEmbeddingStepConfig, type GenerateEvalCasesInput, type GeneratedRuntimeToolGateDecision, type GeneratedRuntimeToolGateOptions, type GetApiKeyRequestResponse, type GetRecordStepConfig$1 as GetRecordStepConfig, type Gradeable, type GraderConfig, type GraderOutcome, type GraderSeverity, type HealthInsight, type HumanVerdict, type ImageContentPart, type InferCollectionSchemaResponse, type InputDeliveryReceipt, type Integration, type IntegrationTool, IntegrationsEndpoint, type IntegrationsListResponse, type JSONSchema, type JsonArray, type JsonObject, type JsonPrimitive, type JsonValue, LEDGER_ARTIFACT_LINE_PREFIX, LIVE_AGENT_ALIAS, type ListAgentAliasesOptions, type ListAgentDeploymentsOptions, type ListCollectionsResponse, type ListConversationsResponse, type ListParams, type ListRecordsStepConfig$1 as ListRecordsStepConfig, type LocalToolConfig, type LocalToolDefinition, type LocalToolExecutionCompleteEvent, type LocalToolExecutionLoopSnapshotSlice, type LocalToolExecutionStartEvent, type LogEntry, type LogQueryParams, type LogQueryResponse, type LogQueryResult, type LogSearchedWindow, type LogStatsParams, type LogStatsResponse, type LogStatsResult, LogsEndpoint, type LoopStepConfig$1 as LoopStepConfig, type Message$1 as Message, type MessageContent, type MessageFallback, type Metadata, type MetricDelta, type ModelConfig, ModelConfigsEndpoint, type ModelFallback, type ModelOverride, type ModelUsageDetail, type ModelUsageQueryParams, type ModelUsageResponse, type ModelUsageSummary, type ModelUsageTimeSeries, type OrganizationAgentAlias, type OrganizationAgentAliasList, type PaginationResponse, type PersistedGraderOutcome, type PrepareAgentPromotionInput, type ProductDefinition, ProductDriftError, ProductEnsureConflictError, type ProductPullResult, type ProductionHealthQuery, type ProductionHealthResponse, ProductsNamespace, type PromoteAgentInput, type PromoteAgentResult, type Prompt$1 as Prompt, type PromptErrorHandling, type PromptFallback, type PromptListParams, type PromptStepConfig$1 as PromptStepConfig, PromptsEndpoint, PromptsNamespace, type ProviderApiKey, type ProviderKeyModel, ProviderKeysEndpoint, type PullFpoResult, RUNTYPE_CLIENT_KIND, type ReasoningConfig, type ReasoningContentPart, type ReasoningValue, type RecordCollection, type RecordCollectionWithHistory, type RecordCollections, type RecordConfig$1 as RecordConfig, type RecordCostAggregation, type RecordCostModelBreakdown, type RecordFilter, type RecordFilterCondition, type RecordFilterGroup, type RecordFilterOperator, type RecordListItem, type RecordListParams, type RecordStepResult, type RecordStepResultsParams, type RecordStepResultsResponse, type RecordWriteResponse, RecordsEndpoint, type RetrieveRecordStepConfig$1 as RetrieveRecordStepConfig, type RetryFallback, type RollbackAgentAliasInput, type RunEvalCaseResult, type RunEvalInput, type RunEvalResult, type RunListParams, type RunListResponse, type RunListRow, type RunTaskContextBudgetBreakdown, type RunTaskContextCompactionEvent, type RunTaskContextCompactionStrategy, type RunTaskContextNoticeEvent, type RunTaskContextSummaryEntry, type RunTaskContinuation, type RunTaskOffloadRecorder, type RunTaskOnContextCompaction, type RunTaskOnContextNotice, type RunTaskOnSession, type RunTaskOptions, type RunTaskResult, type RunTaskResumeState, type RunTaskSessionSummary, type RunTaskState, type RunTaskStateSlice, type RunTaskStatus, type RunTaskToolTraceSlice, RunsNamespace, type RuntimeCustomToolConfig, type RuntimeExternalToolConfig, type RuntimeFlowToolConfig, type RuntimeLocalToolConfig, type RuntimeSubagentToolConfig, type RuntimeTool, type RuntimeToolConfig, Runtype, type AgentSkillBinding as RuntypeAgentSkillBinding, RuntypeApiError, RuntypeClient, type ConditionalStepConfig as RuntypeConditionalStepConfig, type RuntypeConfig, type FetchUrlStepConfig as RuntypeFetchUrlStepConfig, RuntypeFlowBuilder, type FlowConfig as RuntypeFlowConfig, type GenerateEmbeddingStepConfig as RuntypeGenerateEmbeddingStepConfig, type GetRecordStepConfig as RuntypeGetRecordStepConfig, type ListRecordsStepConfig as RuntypeListRecordsStepConfig, type LoopStepConfig as RuntypeLoopStepConfig, type Message as RuntypeMessage, type ModelOverride$1 as RuntypeModelOverride, type Prompt as RuntypePrompt, type PromptStepConfig as RuntypePromptStepConfig, type RuntypeRecord, type RecordConfig as RuntypeRecordConfig, type RetrieveRecordStepConfig as RuntypeRetrieveRecordStepConfig, type SearchStepConfig as RuntypeSearchStepConfig, type SendEmailStepConfig as RuntypeSendEmailStepConfig, type SendEventStepConfig as RuntypeSendEventStepConfig, type SendStreamStepConfig as RuntypeSendStreamStepConfig, type SetVariableStepConfig as RuntypeSetVariableStepConfig, type Skill as RuntypeSkill, type SkillBindingWithAgent as RuntypeSkillBindingWithAgent, type SkillCapabilities as RuntypeSkillCapabilities, type SkillFrontmatter as RuntypeSkillFrontmatter, type SkillManifest as RuntypeSkillManifest, type SkillProposal as RuntypeSkillProposal, type SkillRuntypeExtensions as RuntypeSkillRuntypeExtensions, type SkillVersion as RuntypeSkillVersion, type TransformDataStepConfig as RuntypeTransformDataStepConfig, type UpsertFlowConfig as RuntypeUpsertFlowConfig, type UpsertRecordStepConfig as RuntypeUpsertRecordStepConfig, type VectorSearchStepConfig as RuntypeVectorSearchStepConfig, type WaitUntilStepConfig as RuntypeWaitUntilStepConfig, SDK_USER_AGENT, SDK_VERSION, STEP_FIELD_REGISTRY, STEP_TYPE_TO_METHOD, type SandboxDeployEffectivePolicy, type SandboxDeployRetention, type SandboxDeploySleepPolicy, type Schedule, type ScheduleExecutionOptions, type ScheduleListParams, type ScheduleMessage, type ScheduleMessageSet, type ScheduleMessages, type ScheduleMutationResponse, type ScheduleRun, type ScheduleRunNowResponse, type ScheduleStatusResponse, type ScheduleTarget, type ScheduleTrigger, SchedulesEndpoint, type SearchStepConfig$1 as SearchStepConfig, type Secret, type SecretCheckResponse, type SecretDeleteResponse, type SecretSetupUrlRequest, type SecretSetupUrlResponse, SecretsEndpoint, type SelectOrganizationProviderCredentialRequest, type SelectOrganizationProviderCredentialResponse, type SendEmailStepConfig$1 as SendEmailStepConfig, type SendEventStepConfig$1 as SendEventStepConfig, type SendStreamStepConfig$1 as SendStreamStepConfig, type SetVariableStepConfig$1 as SetVariableStepConfig, type SkillDefinition, SkillDriftError, SkillEnsureConflictError, type SkillListPage, type SkillListPagination, type SkillListParams, type SkillManifestInput, type SkillMarkdownInput, type SkillOrigin, type SkillProposalStatus, SkillProposalsNamespace, type SkillPullResult, type SkillStatus, type SkillTrustLevel, type SkillVersionStatus, type SkillWithVersion, type SkillWriteInput, SkillsNamespace, type SlackAppStatusResponse, type SlackInstallRequest, type SlackManifestRequest, type SlackManifestResponse, type SlackOAuthStartRequest, type SlackOAuthStartResponse, type StepCompleteEvent, type StepDeltaEvent, type StepFallback, type StepFieldMeta, type StepStartEvent, type StepWaitingLocalEvent, type StreamCallbacks, type StreamConsumeOptions, type StreamEvent, type StreamEventOf, type SubagentToolConfig, type Surface, type SurfaceDefinition, type SurfaceDefinitionStatus, type SurfaceDefinitionType, SurfaceDriftError, SurfaceEnsureConflictError, type SurfaceListParams, type SurfacePullResult, SurfacesEndpoint, SurfacesNamespace, type TextContentPart, type Tool, type ToolApprovalGrant, ToolApprovalGrantsEndpoint, type ToolConfig, type ToolDefinition, type ToolDefinitionType, ToolDriftError, ToolEnsureConflictError, type ToolPullResult, type ToolWithValidation, type ToolsConfig, ToolsEndpoint, ToolsNamespace, type TransformDataStepConfig$1 as TransformDataStepConfig, type TypedCreateRecordRequest, type TypedRecordListItem, type TypedRecordWriteResponse, TypedRecordsScope, type TypedRuntypeRecord, UNIFIED_EVENTS_QUERY, type UpdateClientTokenRequest, type UpdateCollectionRequest, type UpdateCollectionResponse, type UpdateConversationRequest, type UpdateEvalCaseInput, type UpdateEvalSuiteInput, type UpdateFlowRequest, type UpdatePromptData, type UpdateProviderKeyRequest, type UpdateScheduleRequest, type UpdateSecretRequest, type UpdateToolRequest, type UpdatedAgent, type UpdatedFlow, type UpsertFlowConfig$1 as UpsertFlowConfig, type UpsertOptions, type UpsertRecordStepConfig$1 as UpsertRecordStepConfig, type UserProfile, UsersEndpoint, type ValidateAgentPromotionInput, type ValidateExistingRecordsResponse, type VectorSearchStepConfig$1 as VectorSearchStepConfig, type VersionPublishOptions, type VersionType, type WaitUntilStepConfig$1 as WaitUntilStepConfig, type WorkflowCompileDeps, type WorkflowCompletionCriteriaConfig, type WorkflowConfig, type WorkflowConfigFactory, type WorkflowContext, type WorkflowDefinition, type WorkflowHookEntry, type WorkflowHookKind, type WorkflowHookRef, type WorkflowHookSignatures, type WorkflowMilestoneConfig, type WorkflowPhase, type WorkflowPolicyConfig, type WorkflowRecoveryConfig, type WorkflowSlot, type WorkflowStallPolicy, activateAgentPromotion, agentAliasErrorCode, applyGeneratedRuntimeToolProposalToDispatchRequest, attachRuntimeToolsToDispatchRequest, buildAgentAdmissionHeaders, buildEmptySessionNudge, buildExecutionEventsPath, buildGeneratedRuntimeToolGateOutput, buildLedgerOffloadReference, buildObservationMaskMarker, buildPolicyGuidance, buildSendViewOffloadMarker, calledTool, combineAbortSignals, compileWorkflowConfig, completed, computeAgentContentHash, computeEvalContentHash, computeFlowContentHash, computeFpoContentHash, computeProductContentHash, computeSkillContentHash, computeSurfaceContentHash, computeToolContentHash, contains, cost, createAgentEventTranslator, createClient, createExternalTool, createFlowEventTranslator, defaultWorkflow, defaultWorkflowConfig, defineAgent, defineEval, defineFlow, defineFpo, definePlaybook, defineProduct, defineSkill, defineSurface, defineTool, deployWorkflow, ensureDefaultWorkflowHooks, ensureEval, ensureFpo, evaluateGeneratedRuntimeToolProposal, extractDeclaredToolResultChars, gameWorkflow, getDefaultPlanPath, getLikelySupportingCandidatePaths, interpolateWorkflowTemplate, isCatalogClientToolRef, isDiscoveryToolName, isMarathonArtifactPath, isPreservationSensitiveTask, isUnifiedEventType, isWorkflowHookRef, jsonField, judge, judges, latency, length, listWorkflowHooks, matchesExpected, maxToolCalls, noError, normalizeAgentDefinition, normalizeCandidatePath, normalizeFpoDefinition, normalizeProductDefinition, normalizeSkillDefinition, normalizeSurfaceDefinition, normalizeToolDefinition, notCalledTool, notContains, parseFinalBuffer, parseLedgerArtifactRelativePath, parseOffloadedOutputId, parseSSEChunk, prepareAgentPromotion, processStream, promoteAgent, promotionIdempotencyKey, pullEval, pullFpo, ranStep, regex, registerWorkflowHook, resolveStallStopAfter, resolveWorkflowHook, runEvalSuite, sanitizeTaskSlug, shouldInjectEmptySessionNudge, shouldRequestModelEscalation, stepOrder, streamEvents, toolOrder, unregisterWorkflowHook, usedNoTools, validJson, validateAgentPromotion, withDetachedReconnect, withUnifiedEvents };
+export { type AIGrader, type ActivateAgentAliasInput, type ActivateAgentPromotionInput, type Agent, type AgentAdmissionOptions, type AgentAlias, type AgentAliasActivation, type AgentAliasArchiveFailure, type AgentAliasArchived, AgentAliasDependencyError, type AgentAliasList, AgentAliasNotFoundError, AgentAliasPreviewLimitError, AgentAliasRevisionMismatchError, AgentAliasRevisionRequiredError, type AgentAliasTransport, AgentAliasesNamespace, type AgentApprovalCompleteEvent, type AgentApprovalStartEvent, type AgentCompleteEvent, type AgentDefinition, type AgentDefinitionConfig, type AgentDeploymentList, type AgentDeploymentPromotion, type AgentDeploymentReceipt, AgentDeploymentsNamespace, AgentDriftError, type AgentElicitation, type AgentElicitationRequest, AgentEnsureConflictError, type AgentErrorEvent, type AgentEvent, type AgentEventType, type AgentExecuteRequest, type AgentExecuteResponse, type AgentIterationCompleteEvent, type AgentIterationStartEvent, type AgentMediaEvent, type AgentMessage, type AgentPausedEvent, type AgentPingEvent, AgentPromotionError, type AgentPromotionManifest, type AgentPromotionTransport, type AgentPromotionValidation, type AgentPullResult, type AgentReflectionEvent, type AgentRunInsightsResponse, type AgentRuntimeToolDefinition, type AgentStartEvent, type AgentStreamCallbacks, type AgentStreamEvent, type AgentSubagentConfig, type AgentToolCompleteEvent, type AgentToolDeltaEvent, type AgentToolInputCompleteEvent, type AgentToolInputDeltaEvent, type AgentToolStartEvent, type AgentTurnCompleteEvent, type AgentTurnDeltaEvent, type AgentTurnStartEvent, type AgentVersionDetail, type AgentVersionListItem, type AgentVersionPublishResponse, AgentVersionsEndpoint, type AgentVersionsListResponse, AgentsEndpoint, AgentsNamespace, AnalyticsEndpoint, type ApiClient, type ApiKey, type ApiKeyRequest, type ApiKeyRequestDelivery, type ApiKeyRequestEnvironment, type ApiKeyRequestHandoff, type ApiKeyRequestListParams, type ApiKeyRequestRequester, type ApiKeyRequestStatus, ApiKeyRequestsEndpoint, ApiKeysEndpoint, type ApiResponse, type ApplyGeneratedProposalOptions, type ApplyGeneratedProposalResult, type ArchiveAgentAliasEverywhereResult, type ArchiveAgentAliasInput, type AssetReferenceContentPart, type AsyncExecutionHandle, type AsyncExecutionStatus, type AttachRuntimeToolsOptions, type BaseAgentEvent, BatchBuilder, type BatchClient, type BatchListParams, type BatchOptions, type BatchRequest, type BatchResult, type BatchScheduleConfig, type BatchStatus, BatchesNamespace, BillingEndpoint, type BillingSpendAnalyticsParams, type BindSkillInput, type BuiltInGraderId, type BuiltInTool, type BuiltinToolExecuteResponse, type BulkEditCondition, type BulkEditRequest, type BulkEditResponse, type BulkEditResult, type CanonicalDispatchMessageContent, type CanonicalDispatchRequest, type CaseExpected, type CatalogClientToolRef, ChatEndpoint, type CheckGrader, type ClaimApiKeyRequestInput, type ClaimApiKeyRequestResponse, type ClaudeManagedEvalOverrideValues, ClientBatchBuilder, type ClientConfig, type ClientConversation, ClientEvalBuilder, ClientFlowBuilder, type ClientToken, type ClientTokenConfig, type ClientTokenEnvironment, type ClientTokenVersionPin, ClientTokensEndpoint, type ClientToolDefinition, type ClientToolEntry, type ClientWidgetTheme, type CollectionMeta, CollectionsEndpoint, type ConditionalGetResult, type ConditionalStepConfig$1 as ConditionalStepConfig, type ContextErrorHandling, type ContextFallback, ContextTemplatesEndpoint, type Conversation, type ConversationListItem, type ConversationListParams, type ConversationMessage, type ConversationSource, ConversationsEndpoint, type ConversationsListResponse, type CreateApiKeyRequest, type CreateApiKeyRequestInput, type CreateApiKeyRequestResponse, type CreateClientTokenRequest, type CreateClientTokenResponse, type CreateCollectionRequest, type CreateConversationRequest, type CreateEvalSuiteInput, type CreateFlowRequest, type CreateModelConfigRequest, type CreatePromptData, type CreatePromptRequest, type CreateProviderKeyRequest, type CreateRecordRequest, type CreateScheduleRequest, type CreateSecretRequest, type CreateToolRequest, type CurrentBilledSpendResponse, type CurrentBilledSpendSource, type CustomMCPServer, type CustomMCPServerAuth, type CustomToolConfig, DEFAULT_MAX_DETACHED_RECONNECTS, DEFAULT_RECOVERY_AFTER_EMPTY_SESSIONS, DEFAULT_STALL_STOP_AFTER, type DecomposeCriteriaResult, type DefineAgentInput, type DefineEvalCaseInput, type DefineEvalInput, type DefineFlowInput, type DefineProductInput, type DefineSkillInput, type DefineSurfaceInput, type DefineToolInput, type DeployCfSandboxRequest, type DeployCfSandboxResponse, type DeploySandboxRequest, type DeploySandboxResponse, type DetachedReattach, type DetachedReconnectOptions, type DiscoveredModel, type DispatchAgentInput, type DispatchApprovalContinuationResponse, type DispatchApproveRequest, type DispatchApproveResponse, type DispatchClient, type DispatchContinuationRequest, type DispatchContinuationResponse, type DispatchDetachedApprovalResponse, type DispatchDetachedToolOutputResponse, DispatchEndpoint, type DispatchEnvironment, type DispatchEvent, type DispatchFlowInput, type DispatchMessageContent, type DispatchOptions$1 as DispatchOptions, type DispatchRequest, type DispatchResponse, type DispatchResumeJsonResponse, type DispatchResumeRequest, type DispatchResumeResponse, ENSURE_RELEASE_DEPLOY_CONFLICT_MESSAGE, type EndUserUsageQuery, type EndUserUsageResponse, type EnsureAgentConverged, type EnsureAgentOptions, type EnsureAgentPlan, type EnsureAgentResult, type EnsureEvalResult, type EnsureFlowConverged, type EnsureFlowOptions, type EnsureFlowPlan, type EnsureFlowResult, type EnsureFpoOptions, type EnsureFpoResult, type EnsureProductConverged, type EnsureProductOptions, type EnsureProductPlan, type EnsureProductResult, type EnsureSkillConverged, type EnsureSkillOptions, type EnsureSkillPlan, type EnsureSkillResult, type EnsureSurfaceConverged, type EnsureSurfaceOptions, type EnsureSurfacePlan, type EnsureSurfaceResult, type EnsureToolConverged, type EnsureToolOptions, type EnsureToolPlan, type EnsureToolResult, type ErrorHandlingMode, type EvalAgentSelector, type EvalAgentTargetResolution, EvalBuilder, type EvalCaseDefinition, type EvalCaseInput, type EvalCaseProposal, type EvalCaseProposalAccepted, type EvalCaseProposalListResult, type EvalCasesGenerated, type EvalClient, type EvalDefinition, EvalEndpoint, type EvalListParams, type EvalMessage, type EvalOptions, type EvalOverrideValues, type EvalProposalSource, type EvalProposalStatus, type EvalProposedCase, type EvalPullResult, type EvalRecord, type EvalRequest, type EvalResult, type EvalRunCaseScores, type EvalRunConfig, type EvalRunEvidence, type EvalRunScores, EvalRunner, type EvalStatus, type EvalSuiteCase, type EvalSuiteCaseInput, type EvalSuiteCoverage, type EvalSuiteDetail, type EvalSuiteLatestRun, type EvalSuiteListResult, type EvalSuiteRunQueued, type EvalSuiteRunResult, type EvalSuiteSummary, EvalSuitesNamespace, type EvalTarget, EvalsNamespace, type ExecuteToolRequest, type ExecuteToolResponse, type ExecutionCounts, type ExecutionStreamEvent, ExecutionsEndpoint, ExecutionsNamespace, type ExternalAgentContext, type ExternalToolConfig, type FallbackFailEvent, type FallbackStartEvent, type FallbackSuccessEvent, type FallbackTrigger, type FallbackTriggerType, type FallbacksExhaustedEvent, type FallbacksInitiatedEvent, type FetchUrlStepConfig$1 as FetchUrlStepConfig, type FieldFormat, type FileContentPart, type Flow, type FlowAttachment, FlowBuilder, type FlowCompleteEvent, type FlowConfig$1 as FlowConfig, type FlowDefinition, type FlowDefinitionStep, FlowDriftError, FlowEnsureConflictError, type FlowErrorEvent, type FlowFallback, type FlowInlineEvalInput, type FlowListItem, type FlowPausedEvent, type FlowPullResult, FlowResult, type FlowStartEvent, type FlowStep, type FlowStepDefinition, type FlowStepType, FlowStepsEndpoint, type FlowStreamEvent, type FlowSummary, type FlowToolConfig, type FlowValidationClient, type FlowValidationIssue, type FlowValidationResult, type FlowVersionDetail, type FlowVersionListItem, type FlowVersionPublishResponse, FlowVersionsEndpoint, type FlowVersionsListResponse, FlowsEndpoint, FlowsNamespace, type FpoEntityOutcome, type FpoInput, type GenerateEmbeddingStepConfig$1 as GenerateEmbeddingStepConfig, type GenerateEvalCasesInput, type GeneratedRuntimeToolGateDecision, type GeneratedRuntimeToolGateOptions, type GetApiKeyRequestResponse, type GetRecordStepConfig$1 as GetRecordStepConfig, type Gradeable, type GraderConfig, type GraderOutcome, type GraderSeverity, type HealthInsight, type HumanVerdict, type ImageContentPart, type InferCollectionSchemaResponse, type InputDeliveryReceipt, type Integration, type IntegrationTool, IntegrationsEndpoint, type IntegrationsListResponse, type JSONSchema, type JsonArray, type JsonObject, type JsonPrimitive, type JsonValue, LEDGER_ARTIFACT_LINE_PREFIX, LIVE_AGENT_ALIAS, type ListAgentAliasesOptions, type ListAgentDeploymentsOptions, type ListCollectionsResponse, type ListConversationsResponse, type ListParams, type ListRecordsStepConfig$1 as ListRecordsStepConfig, type LocalToolConfig, type LocalToolDefinition, type LocalToolExecutionCompleteEvent, type LocalToolExecutionLoopSnapshotSlice, type LocalToolExecutionStartEvent, type LogEntry, type LogQueryParams, type LogQueryResponse, type LogQueryResult, type LogSearchedWindow, type LogStatsParams, type LogStatsResponse, type LogStatsResult, LogsEndpoint, type LoopStepConfig$1 as LoopStepConfig, type Message$1 as Message, type MessageContent, type MessageFallback, type Metadata, type MetricDelta, type ModelConfig, ModelConfigsEndpoint, type ModelFallback, type ModelOverride, type ModelUsageDetail, type ModelUsageQueryParams, type ModelUsageResponse, type ModelUsageSummary, type ModelUsageTimeSeries, type OrganizationAgentAlias, type OrganizationAgentAliasList, type PaginationResponse, type PersistedGraderOutcome, type PrepareAgentPromotionInput, type ProductDefinition, ProductDriftError, ProductEnsureConflictError, type ProductPullResult, type ProductionHealthQuery, type ProductionHealthResponse, ProductsNamespace, type PromoteAgentInput, type PromoteAgentResult, type Prompt$1 as Prompt, type PromptErrorHandling, type PromptFallback, type PromptListParams, type PromptStepConfig$1 as PromptStepConfig, PromptsEndpoint, PromptsNamespace, type ProviderApiKey, type ProviderKeyModel, ProviderKeysEndpoint, type PullFpoResult, RUNTYPE_CLIENT_KIND, type ReasoningConfig, type ReasoningContentPart, type ReasoningValue, type RecordCollection, type RecordCollectionWithHistory, type RecordCollections, type RecordConfig$1 as RecordConfig, type RecordCostAggregation, type RecordCostModelBreakdown, type RecordFilter, type RecordFilterCondition, type RecordFilterGroup, type RecordFilterOperator, type RecordListItem, type RecordListParams, type RecordStepResult, type RecordStepResultsParams, type RecordStepResultsResponse, type RecordWriteResponse, RecordsEndpoint, type RetrieveRecordStepConfig$1 as RetrieveRecordStepConfig, type RetryFallback, type RollbackAgentAliasInput, type RunEvalCaseResult, type RunEvalInput, type RunEvalResult, type RunListParams, type RunListResponse, type RunListRow, type RunTaskContextBudgetBreakdown, type RunTaskContextCompactionEvent, type RunTaskContextCompactionStrategy, type RunTaskContextNoticeEvent, type RunTaskContextSummaryEntry, type RunTaskContinuation, type RunTaskOffloadRecorder, type RunTaskOnContextCompaction, type RunTaskOnContextNotice, type RunTaskOnSession, type RunTaskOptions, type RunTaskResult, type RunTaskResumeState, type RunTaskSessionSummary, type RunTaskState, type RunTaskStateSlice, type RunTaskStatus, type RunTaskToolTraceSlice, RunsNamespace, type RuntimeCustomToolConfig, type RuntimeExternalToolConfig, type RuntimeFlowToolConfig, type RuntimeLocalToolConfig, type RuntimeSubagentToolConfig, type RuntimeTool, type RuntimeToolConfig, Runtype, type AgentSkillBinding as RuntypeAgentSkillBinding, RuntypeApiError, RuntypeClient, type ConditionalStepConfig as RuntypeConditionalStepConfig, type RuntypeConfig, type FetchUrlStepConfig as RuntypeFetchUrlStepConfig, RuntypeFlowBuilder, type FlowConfig as RuntypeFlowConfig, type GenerateEmbeddingStepConfig as RuntypeGenerateEmbeddingStepConfig, type GetRecordStepConfig as RuntypeGetRecordStepConfig, type ListRecordsStepConfig as RuntypeListRecordsStepConfig, type LoopStepConfig as RuntypeLoopStepConfig, type Message as RuntypeMessage, type ModelOverride$1 as RuntypeModelOverride, type Prompt as RuntypePrompt, type PromptStepConfig as RuntypePromptStepConfig, type RuntypeRecord, type RecordConfig as RuntypeRecordConfig, type RetrieveRecordStepConfig as RuntypeRetrieveRecordStepConfig, type SearchStepConfig as RuntypeSearchStepConfig, type SendEmailStepConfig as RuntypeSendEmailStepConfig, type SendEventStepConfig as RuntypeSendEventStepConfig, type SendStreamStepConfig as RuntypeSendStreamStepConfig, type SetVariableStepConfig as RuntypeSetVariableStepConfig, type Skill as RuntypeSkill, type SkillBindingWithAgent as RuntypeSkillBindingWithAgent, type SkillCapabilities as RuntypeSkillCapabilities, type SkillFrontmatter as RuntypeSkillFrontmatter, type SkillManifest as RuntypeSkillManifest, type SkillProposal as RuntypeSkillProposal, type SkillRuntypeExtensions as RuntypeSkillRuntypeExtensions, type SkillVersion as RuntypeSkillVersion, type TransformDataStepConfig as RuntypeTransformDataStepConfig, type UpsertFlowConfig as RuntypeUpsertFlowConfig, type UpsertRecordStepConfig as RuntypeUpsertRecordStepConfig, type VectorSearchStepConfig as RuntypeVectorSearchStepConfig, type WaitUntilStepConfig as RuntypeWaitUntilStepConfig, SDK_USER_AGENT, SDK_VERSION, STEP_FIELD_REGISTRY, STEP_TYPE_TO_METHOD, type SandboxDeployEffectivePolicy, type SandboxDeployRetention, type SandboxDeploySleepPolicy, type SavedToolExecuteResponse, type Schedule, type ScheduleExecutionOptions, type ScheduleListParams, type ScheduleMessage, type ScheduleMessageSet, type ScheduleMessages, type ScheduleMutationResponse, type ScheduleRun, type ScheduleRunNowResponse, type ScheduleStatusResponse, type ScheduleTarget, type ScheduleTrigger, SchedulesEndpoint, type SearchStepConfig$1 as SearchStepConfig, type Secret, type SecretCheckResponse, type SecretDeleteResponse, type SecretSetupUrlRequest, type SecretSetupUrlResponse, SecretsEndpoint, type SelectOrganizationProviderCredentialRequest, type SelectOrganizationProviderCredentialResponse, type SendEmailStepConfig$1 as SendEmailStepConfig, type SendEventStepConfig$1 as SendEventStepConfig, type SendStreamStepConfig$1 as SendStreamStepConfig, type SetVariableStepConfig$1 as SetVariableStepConfig, type SkillDefinition, SkillDriftError, SkillEnsureConflictError, type SkillListPage, type SkillListPagination, type SkillListParams, type SkillManifestInput, type SkillMarkdownInput, type SkillOrigin, type SkillProposalStatus, SkillProposalsNamespace, type SkillPullResult, type SkillStatus, type SkillTrustLevel, type SkillVersionStatus, type SkillWithVersion, type SkillWriteInput, SkillsNamespace, type SlackAppStatusResponse, type SlackInstallRequest, type SlackManifestRequest, type SlackManifestResponse, type SlackOAuthStartRequest, type SlackOAuthStartResponse, type StepCompleteEvent, type StepDeltaEvent, type StepFallback, type StepFieldMeta, type StepStartEvent, type StepWaitingLocalEvent, type StreamCallbacks, type StreamConsumeOptions, type StreamEvent, type StreamEventOf, type SubagentToolConfig, type Surface, type SurfaceDefinition, type SurfaceDefinitionStatus, type SurfaceDefinitionType, SurfaceDriftError, SurfaceEnsureConflictError, type SurfaceListParams, type SurfacePullResult, SurfacesEndpoint, SurfacesNamespace, type TextContentPart, type Tool, type ToolApprovalGrant, ToolApprovalGrantsEndpoint, type ToolConfig, type ToolDefinition, type ToolDefinitionType, ToolDriftError, ToolEnsureConflictError, type ToolPullResult, type ToolWithValidation, type ToolsConfig, ToolsEndpoint, ToolsNamespace, type TransformDataStepConfig$1 as TransformDataStepConfig, type TypedCreateRecordRequest, type TypedRecordListItem, type TypedRecordWriteResponse, TypedRecordsScope, type TypedRuntypeRecord, UNIFIED_EVENTS_QUERY, type UpdateClientTokenRequest, type UpdateCollectionRequest, type UpdateCollectionResponse, type UpdateConversationRequest, type UpdateEvalCaseInput, type UpdateEvalSuiteInput, type UpdateFlowRequest, type UpdatePromptData, type UpdateProviderKeyRequest, type UpdateScheduleRequest, type UpdateSecretRequest, type UpdateToolRequest, type UpdatedAgent, type UpdatedFlow, type UpsertFlowConfig$1 as UpsertFlowConfig, type UpsertOptions, type UpsertRecordStepConfig$1 as UpsertRecordStepConfig, type UserProfile, UsersEndpoint, type ValidateAgentPromotionInput, type ValidateExistingRecordsResponse, type VectorSearchStepConfig$1 as VectorSearchStepConfig, type VersionPublishOptions, type VersionType, type WaitUntilStepConfig$1 as WaitUntilStepConfig, type WorkflowCompileDeps, type WorkflowCompletionCriteriaConfig, type WorkflowConfig, type WorkflowConfigFactory, type WorkflowContext, type WorkflowDefinition, type WorkflowHookEntry, type WorkflowHookKind, type WorkflowHookRef, type WorkflowHookSignatures, type WorkflowMilestoneConfig, type WorkflowPhase, type WorkflowPolicyConfig, type WorkflowRecoveryConfig, type WorkflowSlot, type WorkflowStallPolicy, activateAgentPromotion, agentAliasErrorCode, applyGeneratedRuntimeToolProposalToDispatchRequest, attachRuntimeToolsToDispatchRequest, buildAgentAdmissionHeaders, buildEmptySessionNudge, buildExecutionEventsPath, buildGeneratedRuntimeToolGateOutput, buildLedgerOffloadReference, buildObservationMaskMarker, buildPolicyGuidance, buildSendViewOffloadMarker, calledTool, combineAbortSignals, compileWorkflowConfig, completed, computeAgentContentHash, computeEvalContentHash, computeFlowContentHash, computeFpoContentHash, computeProductContentHash, computeSkillContentHash, computeSurfaceContentHash, computeToolContentHash, contains, cost, createAgentEventTranslator, createClient, createExternalTool, createFlowEventTranslator, defaultWorkflow, defaultWorkflowConfig, defineAgent, defineEval, defineFlow, defineFpo, definePlaybook, defineProduct, defineSkill, defineSurface, defineTool, deployWorkflow, ensureDefaultWorkflowHooks, ensureEval, ensureFpo, evaluateGeneratedRuntimeToolProposal, extractDeclaredToolResultChars, gameWorkflow, getDefaultPlanPath, getLikelySupportingCandidatePaths, interpolateWorkflowTemplate, isBuiltinToolExecuteResponse, isCatalogClientToolRef, isDiscoveryToolName, isMarathonArtifactPath, isPreservationSensitiveTask, isUnifiedEventType, isWorkflowHookRef, jsonField, judge, judges, latency, length, listWorkflowHooks, matchesExpected, maxToolCalls, noError, normalizeAgentDefinition, normalizeCandidatePath, normalizeFpoDefinition, normalizeProductDefinition, normalizeSkillDefinition, normalizeSurfaceDefinition, normalizeToolDefinition, notCalledTool, notContains, parseFinalBuffer, parseLedgerArtifactRelativePath, parseOffloadedOutputId, parseSSEChunk, prepareAgentPromotion, processStream, promoteAgent, promotionIdempotencyKey, pullEval, pullFpo, ranStep, regex, registerWorkflowHook, resolveStallStopAfter, resolveWorkflowHook, runEvalSuite, sanitizeTaskSlug, shouldInjectEmptySessionNudge, shouldRequestModelEscalation, stepOrder, streamEvents, toolOrder, unregisterWorkflowHook, usedNoTools, validJson, validateAgentPromotion, withDetachedReconnect, withUnifiedEvents };