@runtypelabs/sdk 9.11.0 → 9.13.0

package/dist/index.d.cts

@@ -115,6 +115,97 @@ interface ContextErrorHandling {
  * Do not make direct changes to the file.
  */
 interface paths {
+    "/v1/agent-aliases": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /**
+         * List release aliases with one name across the organization
+         * @description Every agent in the caller's organization that carries a release alias with this name, with the pointer revision to quote back as `If-Match`. This is the read a "pull request closed" cleanup makes before archiving each pointer. Archived rows are omitted unless `includeArchived=true`; the built-in `live` alias is readable here like any other name.
+         */
+        get: {
+            parameters: {
+                query: {
+                    /** @description The alias name to look for, e.g. `pr-482`. */
+                    alias: string;
+                    /** @description Pass `true` to include already-archived pointers. */
+                    includeArchived?: string;
+                };
+                header?: never;
+                path?: never;
+                cookie?: never;
+            };
+            requestBody?: never;
+            responses: {
+                /** @description Release aliases with this name */
+                200: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": {
+                            data: {
+                                agentId: string;
+                                agentName: string;
+                                alias: string;
+                                archivedAt: string | null;
+                                expiresAt: string | null;
+                                revision: number;
+                                updatedAt: string;
+                                versionId: string;
+                            }[];
+                        };
+                    };
+                };
+                /** @description Invalid alias name */
+                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;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["Error"];
+                    };
+                };
+            };
+        };
+        put?: never;
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
     "/v1/agent-versions/{agentId}": {
         parameters: {
             query?: never;
@@ -215,11 +306,19 @@ interface paths {
         };
         get?: never;
         put?: never;
-        /** Publish a specific agent version */
+        /**
+         * Publish a specific agent version
+         * @description Apply an immutable version to the live agent row and move the `live` release alias, in one transaction. Until the omitted-selector cutover this is the writer that changes what actually executes, so it is the verb a live deployment uses; the alias activate route owns preview pointers. Supplying `If-Match` opts this call into the same protected-live compare-and-swap the alias routes enforce.
+         */
         post: {
             parameters: {
                 query?: never;
-                header?: never;
+                header?: {
+                    /** @description The `live` alias revision this publish expects. Optional: omitting it keeps the historical last-writer-wins behavior for existing callers. When present and stale, the publish is refused with 412 and nothing is written. */
+                    "if-match"?: string;
+                    /** @description Replay key. Repeating a publish with the same key returns the receipt the first call produced instead of moving the pointer twice. */
+                    "idempotency-key"?: string;
+                };
                 path: {
                     agentId: string;
                 };
@@ -228,6 +327,14 @@ interface paths {
             requestBody?: {
                 content: {
                     "application/json": {
+                        deployment?: {
+                            /**
+                             * @description What the deployment receipt records this move as. Send `rollback` when re-deploying the version a previous deployment replaced, so the history reads as a rollback rather than a fresh deployment.
+                             * @default activate
+                             * @enum {string}
+                             */
+                            action?: "activate" | "rollback";
+                        };
                         /**
                          * @description Use overwrite only after confirming replacement of a code-managed agent.
                          * @default error
@@ -247,7 +354,8 @@ interface paths {
                     content: {
                         "application/json": {
                             agentId: string;
-                            applied: {
+                            /** @description Which fields of the live agent row this publish wrote. Omitted when an `Idempotency-Key` replayed an earlier publish, which applies nothing itself and cannot reconstruct what the original wrote. */
+                            applied?: {
                                 [key: string]: boolean;
                             };
                             /** @enum {string} */
@@ -297,7 +405,7 @@ interface paths {
                         "application/json": components["schemas"]["Error"];
                     };
                 };
-                /** @description Publishing would overwrite a definition managed by code */
+                /** @description Publishing would overwrite a definition managed by code, the idempotency key was already used for a different version, or a declared rollback does not aim at the version the live receipt chain says it replaced */
                 409: {
                     headers: {
                         [name: string]: unknown;
@@ -305,9 +413,24 @@ interface paths {
                     content: {
                         "application/json": components["schemas"]["Error"] & {
                             /** @enum {string} */
-                            code: "managed_by_code_conflict";
+                            code: "managed_by_code_conflict" | "idempotency_key_reused" | "rollback_target_mismatch";
+                            expectedVersionId?: string | null;
                             /** @enum {string} */
-                            lastModifiedSource: "sdk" | "terraform";
+                            lastModifiedSource?: "sdk" | "terraform";
+                        };
+                    };
+                };
+                /** @description The live alias moved since the revision this publish quoted */
+                412: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["Error"] & {
+                            actual: number | null;
+                            /** @enum {string} */
+                            code: "alias_revision_mismatch";
+                            expected: number;
                         };
                     };
                 };
@@ -1568,6 +1691,15 @@ interface paths {
                         "application/json": components["schemas"]["AgentEnsureHashMismatch"];
                     };
                 };
+                /** @description Active preview alias quota exceeded for the organization or the agent (code PREVIEW_ALIAS_LIMIT). Archive a preview alias and retry. */
+                429: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["AgentEnsurePreviewAliasLimit"];
+                    };
+                };
                 /** @description Internal server error, or code alias_activation_failed when a non-live activation could not be applied (nothing was written) */
                 500: {
                     headers: {
@@ -2746,7 +2878,7 @@ interface paths {
         };
         /**
          * Activate a version at a release alias
-         * @description Aim one alias at one immutable version of the same agent, appending a deployment receipt in the same transaction. Moving an existing `live` pointer requires the AGENTS:DEPLOY:LIVE scope and an `If-Match` revision; preview aliases require AGENTS:DEPLOY:PREVIEW. Dependency references the version names are fingerprinted first, and an unresolvable reference refuses the activation.
+         * @description Aim one alias at one immutable version of the same agent, appending a deployment receipt in the same transaction. Moving an existing `live` pointer requires the AGENTS:DEPLOY:LIVE scope and an `If-Match` revision; preview aliases require AGENTS:DEPLOY:PREVIEW. Dependency references the version names are fingerprinted first, and an unresolvable reference refuses the activation. Activating a preview alias renews its 14-day expiry; `live` never expires. Creating a new preview alias past the active-preview quota answers 429 with code PREVIEW_ALIAS_LIMIT.
          */
         put: {
             parameters: {
@@ -2766,6 +2898,7 @@ interface paths {
             requestBody?: {
                 content: {
                     "application/json": {
+                        promotion?: components["schemas"]["AgentDeploymentPromotion"];
                         /** @description Why this deployment happened, recorded on the receipt for humans. Context only: nothing branches on it. */
                         reason?: string;
                         versionId: string;
@@ -2780,8 +2913,12 @@ interface paths {
                     };
                     content: {
                         "application/json": {
+                            /** @description How many preview aliases this agent has active after the write. Null for `live`, which is never counted. Read it beside `previewLimit` to see a per-pull-request pipeline filling up before an activation is refused with PREVIEW_ALIAS_LIMIT. */
+                            activePreviewCount: number | null;
                             alias: string;
                             changed: boolean;
+                            /** @description The active-preview ceiling this agent is counted against. Null for `live`. */
+                            previewLimit: number | null;
                             receiptId: string;
                             revision: number;
                             versionId: string;
@@ -2873,6 +3010,15 @@ interface paths {
                         "application/json": components["schemas"]["Error"];
                     };
                 };
+                /** @description Active preview alias quota exceeded for the organization or the agent */
+                429: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["PreviewAliasLimitError"];
+                    };
+                };
                 /** @description Internal server error */
                 500: {
                     headers: {
@@ -3049,8 +3195,12 @@ interface paths {
                     };
                     content: {
                         "application/json": {
+                            /** @description How many preview aliases this agent has active after the write. Null for `live`, which is never counted. Read it beside `previewLimit` to see a per-pull-request pipeline filling up before an activation is refused with PREVIEW_ALIAS_LIMIT. */
+                            activePreviewCount: number | null;
                             alias: string;
                             changed: boolean;
+                            /** @description The active-preview ceiling this agent is counted against. Null for `live`. */
+                            previewLimit: number | null;
                             receiptId: string;
                             revision: number;
                             versionId: string;
@@ -3700,8 +3850,8 @@ interface paths {
             parameters: {
                 query?: never;
                 header?: {
-                    /** @description How a durable turn behaves when the conversation already has one in flight. `reject` (the default when omitted) answers `CONVERSATION_BUSY`; `supersede` cancels the incumbent and takes over; `queue` runs after it. Ignored for a turn that resolves to the in-process lane. */
-                    "x-runtype-concurrency"?: "reject" | "supersede" | "queue";
+                    /** @description How a durable turn handles overlap. `reject` (default) answers CONVERSATION_BUSY naming the occupant execution, its phase, and a Retry-After; `supersede` cancels and replaces; `queue` runs afterward; `join` durably appends new user-message deltas to the same execution at a safe boundary, attaches through the host's slot claim when the host has not started yet, or starts the next execution if completion wins. Join requires a conversationId, preserves configuration and authority, cannot combine with coalesce, and rejects unsupported lanes. Other policies remain ignored on in-process execution. */
+                    "x-runtype-concurrency"?: "reject" | "supersede" | "queue" | "join";
                     /** @description Send `true` to fold this request into an already-pending turn for the same conversation instead of starting a second one. The response is the pending execution. Any other value (or omitting the header) starts a new turn. */
                     "x-runtype-coalesce"?: "true";
                     /** @description Caller-chosen key that makes admission idempotent: a retry with the same key returns the ORIGINAL execution rather than starting a second turn, and consumes no additional quota. Scoped to the durable lane. */
@@ -3726,6 +3876,7 @@ interface paths {
                         [name: string]: unknown;
                     };
                     content: {
+                        "application/json": components["schemas"]["DispatchAgentJsonResponse"];
                         "text/event-stream": unknown;
                     };
                 };
@@ -3765,7 +3916,7 @@ interface paths {
                         "application/json": components["schemas"]["Error"];
                     };
                 };
-                /** @description Agent not found */
+                /** @description Agent not found, a version selector that names no pointer (alias_not_found, alias_archived, alias_expired, version_not_found), or a saved agent with no runnable live version (AGENT_NOT_DEPLOYED) */
                 404: {
                     headers: {
                         [name: string]: unknown;
@@ -3774,7 +3925,7 @@ interface paths {
                         "application/json": components["schemas"]["Error"];
                     };
                 };
-                /** @description Organization model configuration needs configuration */
+                /** @description Organization model configuration needs configuration, the durable conversation is busy (CONVERSATION_BUSY names the occupant execution and its phase; honor Retry-After or join it), or a `history: "stored"` turn lost the compare-and-swap on its conversation (CONVERSATION_MODIFIED; nothing ran, re-read the conversation and retry) */
                 409: {
                     headers: {
                         [name: string]: unknown;
@@ -3789,7 +3940,16 @@ interface paths {
                             error: string;
                             modelId: string;
                             provider: string;
-                        };
+                        } | components["schemas"]["ConversationBusyError"] | components["schemas"]["ConversationModifiedError"];
+                    };
+                };
+                /** @description A `history: "stored"` turn could not be stored: the conversation is already at the record payload limit. Nothing ran. */
+                413: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["Error"];
                     };
                 };
                 /** @description Internal server error */
@@ -6729,10 +6889,10 @@ interface paths {
                                 errorMessage?: string | null;
                                 estimatedCost?: string | null;
                                 /**
-                                 * @description Engine that actually executed this step ('runtime' | 'legacy'). Recorded at write time from the committed lane decision; never inferred later. Null for rows written before attribution shipped and for units that never started executing (externally executed runs carry no engine).
+                                 * @description Engine that actually executed this step ('runtime' | 'legacy' | 'external'). Recorded at write time from the committed lane decision; never inferred later. 'external' marks a run a customer executed outside Runtype and reported through ingest. Null for rows written before attribution shipped and for units that never started executing.
                                  * @enum {string|null}
                                  */
-                                executionEngine?: "runtime" | "legacy" | null;
+                                executionEngine?: "runtime" | "legacy" | "external" | null;
                                 executionSessionId: string | null;
                                 flowId: string | null;
                                 flowVersionId: string | null;
@@ -7880,7 +8040,7 @@ interface paths {
         put?: never;
         /**
          * Send a client chat message
-         * @description Send a message for a browser client-token chat session. The request streams flow/agent events over Server-Sent Events. `turnId` and `submitMode` are optional and let newer Persona clients suppress stale interrupted responses; older clients can omit both fields.
+         * @description Send a message for a browser client-token chat session. The request streams flow/agent events over Server-Sent Events. `turnId` and `submitMode` are optional and let newer Persona clients suppress stale interrupted responses; older clients can omit both fields. Opt-in `join` accepts exactly one new user message whose `id` equals `turnId` for visitor-owned native durable agents. A new execution streams SSE; joining an existing execution returns a 202 delivery receipt without replacing its response. Retry with the same turn and message IDs.
          */
         post: {
             parameters: {
@@ -7951,7 +8111,7 @@ interface paths {
                         };
                         sessionId: string;
                         /** @enum {string} */
-                        submitMode?: "normal" | "interrupt";
+                        submitMode?: "normal" | "interrupt" | "join";
                         turnId?: string;
                     };
                 };
@@ -7966,6 +8126,25 @@ interface paths {
                         "text/event-stream": unknown;
                     };
                 };
+                /** @description Input accepted by an existing durable execution; no new response stream */
+                202: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": {
+                            /** @enum {boolean} */
+                            accepted: true;
+                            conversationId: string;
+                            deliveryId: string;
+                            /** @enum {string} */
+                            deliveryStatus: "pending" | "applied" | "settled" | "not_applied";
+                            deliveryStatusUrl: string;
+                            eventsUrl: string;
+                            executionId: string;
+                        };
+                    };
+                };
                 /** @description Validation error */
                 400: {
                     headers: {
@@ -7996,7 +8175,7 @@ interface paths {
                         "application/json": components["schemas"]["Error"];
                     };
                 };
-                /** @description Referenced flow or agent not found */
+                /** @description Referenced flow or agent not found, or a saved agent with no runnable live version (AGENT_NOT_DEPLOYED) */
                 404: {
                     headers: {
                         [name: string]: unknown;
@@ -8272,6 +8451,192 @@ interface paths {
         patch?: never;
         trace?: never;
     };
+    "/v1/client/conversations/{conversationId}/executions/{executionId}/cancel": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        get?: never;
+        put?: never;
+        /**
+         * Stop a native durable client execution
+         * @description Cancel the specified execution without starting a replacement. Pending inputs become not applied. Requires the exact visitor and session bound to the conversation.
+         */
+        post: {
+            parameters: {
+                query: {
+                    sessionId: string;
+                };
+                header: {
+                    /** @description The browser's anonymous visitor secret (`cvt_…`) returned by `/client/init`. It is what scopes the request to one visitor's own conversations, so a request without it is refused. Sent as a header so it never lands in access logs or `Referer`. */
+                    "x-visitor-token": string;
+                    /** @description Optional fresh hosted end-user identity proof. When admitted and already bound to the presented visitor, expands the request from this exact browser to sibling visitors for the same verified person. Without it, even a previously bound visitor remains exact-browser scoped. */
+                    "x-identity-proof"?: string;
+                };
+                path: {
+                    conversationId: string;
+                    executionId: string;
+                };
+                cookie?: never;
+            };
+            requestBody?: never;
+            responses: {
+                /** @description Cancellation accepted */
+                202: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": {
+                            accepted: boolean;
+                            executionId: string;
+                        };
+                    };
+                };
+                /** @description Missing or expired session or visitor credential */
+                401: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["Error"];
+                    };
+                };
+                /** @description Inactive client token or origin mismatch */
+                403: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["Error"];
+                    };
+                };
+                /** @description Execution or delivery not owned by this visitor conversation */
+                404: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["Error"];
+                    };
+                };
+                /** @description Execution is already terminal or no longer cancellable */
+                409: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": {
+                            accepted: boolean;
+                            executionId: string;
+                        };
+                    };
+                };
+                /** @description Visitor request rate exceeded */
+                429: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["Error"];
+                    };
+                };
+            };
+        };
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/v1/client/conversations/{conversationId}/executions/{executionId}/deliveries/{deliveryId}": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /**
+         * Read a live input delivery receipt
+         * @description Read whether a joined message is pending, applied, settled, or not applied. Requires the exact visitor and session bound to this conversation.
+         */
+        get: {
+            parameters: {
+                query: {
+                    sessionId: string;
+                };
+                header: {
+                    /** @description The browser's anonymous visitor secret (`cvt_…`) returned by `/client/init`. It is what scopes the request to one visitor's own conversations, so a request without it is refused. Sent as a header so it never lands in access logs or `Referer`. */
+                    "x-visitor-token": string;
+                    /** @description Optional fresh hosted end-user identity proof. When admitted and already bound to the presented visitor, expands the request from this exact browser to sibling visitors for the same verified person. Without it, even a previously bound visitor remains exact-browser scoped. */
+                    "x-identity-proof"?: string;
+                };
+                path: {
+                    conversationId: string;
+                    executionId: string;
+                    deliveryId: string;
+                };
+                cookie?: never;
+            };
+            requestBody?: never;
+            responses: {
+                /** @description Durable input delivery receipt */
+                200: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["ClientInputDeliveryReceipt"];
+                    };
+                };
+                /** @description Missing or expired session or visitor credential */
+                401: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["Error"];
+                    };
+                };
+                /** @description Inactive client token or origin mismatch */
+                403: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["Error"];
+                    };
+                };
+                /** @description Execution or delivery not owned by this visitor conversation */
+                404: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["Error"];
+                    };
+                };
+                /** @description Visitor request rate exceeded */
+                429: {
+                    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/client/conversations/{id}": {
         parameters: {
             query?: never;
@@ -8857,6 +9222,8 @@ interface paths {
                             durableRecovery?: {
                                 /** @description Whether this initialized client-token session has the visitor credential and surface policy needed to use the durable execution reconnect route. Reporting only: individual turns still self-identify as durable through replay cursors. */
                                 enabled: boolean;
+                                /** @description Whether the native durable target supports non-interrupting user-message delivery. */
+                                join?: boolean;
                             };
                             /** @description ISO-8601 session idle-expiry timestamp. */
                             expiresAt: string;
@@ -8922,7 +9289,7 @@ interface paths {
                         "application/json": components["schemas"]["Error"];
                     };
                 };
-                /** @description Referenced flow, agent, or visitor-authorized conversation not found. Conversations outside the visitor scope also answer 404. */
+                /** @description Referenced flow, agent, or visitor-authorized conversation not found, or a saved agent with no runnable live version (AGENT_NOT_DEPLOYED). Conversations outside the visitor scope also answer 404. */
                 404: {
                     headers: {
                         [name: string]: unknown;
@@ -10505,6 +10872,13 @@ interface paths {
             requestBody?: {
                 content: {
                     "application/json": {
+                        /** @description Agent (agent_...) this conversation belongs to, stored as metadata.agentId. Must name an agent the caller owns. */
+                        agentId?: string;
+                        /**
+                         * @description Full-fidelity transcript. A tool message must carry toolResults answering an assistant toolCalls entry issued earlier in the array; ids and createdAt are minted when omitted.
+                         * @default []
+                         */
+                        messages?: components["schemas"]["ConversationTranscriptMessage"][];
                         /** @default {} */
                         metadata?: {
                             [key: string]: unknown;
@@ -10512,6 +10886,7 @@ interface paths {
                         modelId?: string;
                         /** @description Owner key for this conversation, stored in the indexed owner_id column and filterable via ?ownerId=. Overrides a nested metadata.ownerId. Null means no owner. */
                         ownerId?: string | null;
+                        source?: components["schemas"]["ConversationSource"];
                         systemPrompt?: string;
                         /** @default New Chat */
                         title?: string;
@@ -10519,8 +10894,8 @@ interface paths {
                 };
             };
             responses: {
-                /** @description Conversation created */
-                201: {
+                /** @description A conversation with this `source.system` and `source.externalId` was already imported. Nothing was created and the existing conversation is returned with `imported: false`. */
+                200: {
                     headers: {
                         [name: string]: unknown;
                     };
@@ -10528,9 +10903,39 @@ interface paths {
                         "application/json": {
                             createdAt: string;
                             id: string;
-                            messages: {
+                            /** @description Set by POST /v1/conversations only. True when this call created the conversation (201); false when a conversation with the same source.system and source.externalId already existed and is returned unchanged (200). */
+                            imported?: boolean;
+                            messages: components["schemas"]["ConversationTranscriptMessage"][];
+                            metadata: {
                                 [key: string]: unknown;
+                            };
+                            modelId: string | null;
+                            ownerId: string | null;
+                            schemaWarnings?: {
+                                code: string;
+                                field: string;
+                                message: string;
                             }[];
+                            /** @enum {string} */
+                            source: "app" | "client_token";
+                            systemPrompt: string | null;
+                            title: string;
+                            updatedAt: string;
+                        };
+                    };
+                };
+                /** @description Conversation created (`imported: true`) */
+                201: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": {
+                            createdAt: string;
+                            id: string;
+                            /** @description Set by POST /v1/conversations only. True when this call created the conversation (201); false when a conversation with the same source.system and source.externalId already existed and is returned unchanged (200). */
+                            imported?: boolean;
+                            messages: components["schemas"]["ConversationTranscriptMessage"][];
                             metadata: {
                                 [key: string]: unknown;
                             };
@@ -10549,14 +10954,16 @@ interface paths {
                         };
                     };
                 };
-                /** @description Validation error */
+                /** @description Validation error. `code: CONVERSATION_TRANSCRIPT_INVALID` when `messages` breaks the tool-pairing discipline; `details.issues` lists each offending message index. */
                 400: {
                     headers: {
                         [name: string]: unknown;
                     };
                     content: {
                         "application/json": components["schemas"]["Error"] & {
+                            code?: string;
                             details?: unknown;
+                            message?: string;
                         };
                     };
                 };
@@ -10578,6 +10985,15 @@ interface paths {
                         "application/json": components["schemas"]["Error"];
                     };
                 };
+                /** @description The requested agentId names no agent the caller owns */
+                404: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["Error"];
+                    };
+                };
                 /** @description Metadata violates a registered `conversation` collection schema (enforce mode) */
                 422: {
                     headers: {
@@ -10632,9 +11048,9 @@ interface paths {
                         "application/json": {
                             createdAt: string;
                             id: string;
-                            messages: {
-                                [key: string]: unknown;
-                            }[];
+                            /** @description Set by POST /v1/conversations only. True when this call created the conversation (201); false when a conversation with the same source.system and source.externalId already existed and is returned unchanged (200). */
+                            imported?: boolean;
+                            messages: components["schemas"]["ConversationTranscriptMessage"][];
                             metadata: {
                                 [key: string]: unknown;
                             };
@@ -10713,50 +11129,23 @@ interface paths {
             requestBody?: {
                 content: {
                     "application/json": {
-                        messages?: {
-                            content: string | (({
-                                text: string;
-                                /** @enum {string} */
-                                type: "text";
-                            } & {
-                                [key: string]: unknown;
-                            }) | ({
-                                image: string;
-                                mimeType?: string;
-                                /** @enum {string} */
-                                type: "image";
-                            } & {
-                                [key: string]: unknown;
-                            }) | ({
-                                data: string;
-                                filename: string;
-                                mimeType: string;
-                                /** @enum {string} */
-                                type: "file";
-                            } & {
-                                [key: string]: unknown;
-                            }) | {
-                                assetId: string;
-                                filename?: string;
-                                mimeType: string;
-                                orgKey: string;
-                                /** @enum {string} */
-                                refKind: "image" | "file";
-                                sizeBytes: number;
-                                /** @enum {string} */
-                                type: "asset_ref";
-                            })[];
-                            createdAt?: string;
-                            id: string;
-                            /** @enum {string} */
-                            role: "user" | "assistant" | "system";
-                        }[];
+                        /** @description Null clears metadata.agentId; omit to leave it unchanged. */
+                        agentId?: string | null;
+                        /** @description Full-fidelity transcript. A tool message must carry toolResults answering an assistant toolCalls entry issued earlier in the array; ids and createdAt are minted when omitted. */
+                        messages?: components["schemas"]["ConversationTranscriptMessage"][];
+                        /**
+                         * @description How to apply `messages`. `replace` (the default) swaps the whole transcript. `append` adds them to the end, skipping any message whose id is already stored, so a chunked import can retry a chunk safely; the combined transcript is validated and must satisfy the same tool-pairing discipline.
+                         * @default replace
+                         * @enum {string}
+                         */
+                        messagesMode?: "replace" | "append";
                         metadata?: {
                             [key: string]: unknown;
                         };
                         modelId?: string;
                         /** @description Reassigns the owner (indexed owner_id column, filterable via ?ownerId=). Overrides a nested metadata.ownerId. Null clears the owner; omit to leave it unchanged. */
                         ownerId?: string | null;
+                        source?: components["schemas"]["ConversationSource"];
                         systemPrompt?: string;
                         title?: string;
                     };
@@ -10772,9 +11161,9 @@ interface paths {
                         "application/json": {
                             createdAt: string;
                             id: string;
-                            messages: {
-                                [key: string]: unknown;
-                            }[];
+                            /** @description Set by POST /v1/conversations only. True when this call created the conversation (201); false when a conversation with the same source.system and source.externalId already existed and is returned unchanged (200). */
+                            imported?: boolean;
+                            messages: components["schemas"]["ConversationTranscriptMessage"][];
                             metadata: {
                                 [key: string]: unknown;
                             };
@@ -10793,14 +11182,16 @@ interface paths {
                         };
                     };
                 };
-                /** @description Validation error */
+                /** @description Validation error. `code: CONVERSATION_TRANSCRIPT_INVALID` when `messages` breaks the tool-pairing discipline; `details.issues` lists each offending message index. */
                 400: {
                     headers: {
                         [name: string]: unknown;
                     };
                     content: {
                         "application/json": components["schemas"]["Error"] & {
+                            code?: string;
                             details?: unknown;
+                            message?: string;
                         };
                     };
                 };
@@ -10831,6 +11222,15 @@ interface paths {
                         "application/json": components["schemas"]["Error"];
                     };
                 };
+                /** @description `messagesMode: "append"` lost the compare-and-swap on the stored transcript (`CONVERSATION_MODIFIED`) because a concurrent write moved it. Nothing was written; re-read the conversation and retry. */
+                409: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["ConversationModifiedError"];
+                    };
+                };
                 /** @description Metadata violates a registered `conversation` collection schema (enforce mode) */
                 422: {
                     headers: {
@@ -11951,7 +12351,7 @@ interface paths {
         put?: never;
         /**
          * Execute a flow or agent
-         * @description Main dispatch endpoint for flow and agent execution with record resolution. Supports streaming via SSE or synchronous JSON responses. Send the RFC 7240 `Prefer: respond-async` header to receive a durable execution handle immediately, then poll its status URL for completion. A saved agent may run on the durable session lane; the admission headers `x-runtype-concurrency` (reject, supersede, queue), `x-runtype-coalesce` (true) and `idempotency-key` then apply exactly as on `POST /v1/agents/{id}/execute`, and are ignored for a turn that resolves to the in-process lane.
+         * @description Main dispatch endpoint for flow and agent execution with record resolution. Supports streaming via SSE or synchronous JSON responses. Send the RFC 7240 `Prefer: respond-async` header to receive a durable execution handle immediately, then poll its status URL for completion. A saved agent may run on the durable session lane; the admission headers `x-runtype-concurrency` (reject, supersede, queue, join), `x-runtype-coalesce` (true) and `idempotency-key` then apply exactly as on `POST /v1/agents/{id}/execute`, and are ignored for in-process execution except join, which fails explicitly on unsupported lanes. Join accepts only new user-message deltas, preserves the active execution configuration and authority, and returns a deliveryId with a deliveryStatusUrl. Prefer: respond-async with join returns a native delivery receipt without queuing an HTTP replay.
          */
         post: {
             parameters: {
@@ -12258,6 +12658,7 @@ interface paths {
                         inputs?: {
                             [key: string]: unknown;
                         };
+                        /** @description Conversation history for this turn. A `system` message that is not the first message keeps its position on OpenAI-family models (so a per-turn system message sent last leaves the cached leading prompt untouched) and is folded into the leading system prompt on providers that require a single leading system turn. */
                         messages?: {
                             content: string | ({
                                 text: string;
@@ -12677,6 +13078,7 @@ interface paths {
                         inputs?: {
                             [key: string]: unknown;
                         };
+                        /** @description Conversation history for this turn. A `system` message that is not the first message keeps its position on OpenAI-family models (so a per-turn system message sent last leaves the cached leading prompt untouched) and is folded into the leading system prompt on providers that require a single leading system turn. */
                         messages?: {
                             content: string | ({
                                 text: string;
@@ -12859,7 +13261,7 @@ interface paths {
                         "application/json": components["schemas"]["Error"];
                     };
                 };
-                /** @description Saved flow not found (FLOW_NOT_FOUND) */
+                /** @description Saved flow not found (FLOW_NOT_FOUND), a version selector that names no pointer (alias_not_found, alias_archived, alias_expired, version_not_found), or a saved agent with no runnable live version (AGENT_NOT_DEPLOYED) */
                 404: {
                     headers: {
                         [name: string]: unknown;
@@ -12868,6 +13270,15 @@ interface paths {
                         "application/json": components["schemas"]["Error"];
                     };
                 };
+                /** @description The durable conversation is busy (CONVERSATION_BUSY names the occupant execution and its phase; honor Retry-After or send x-runtype-concurrency: join) */
+                409: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["ConversationBusyError"];
+                    };
+                };
                 /** @description The dispatch cannot run: a persisted-flow hash miss (FLOW_DEFINITION_REQUIRED, retry with the full definition), a shaped-wrong definition write (FLOW_DEFINITION_WRITE_REJECTED), no flow definition (FLOW_DEFINITION_MISSING), an unresolvable record or definition (FLOW_RECORD_UNRESOLVED, FLOW_DEFINITION_UNRESOLVED), or a capability the runtime lane cannot host (RUNTIME_LANE_INELIGIBLE, with `reasons`) */
                 422: {
                     headers: {
@@ -14845,6 +15256,7 @@ interface paths {
             requestBody?: {
                 content: {
                     "application/json": {
+                        agent?: components["schemas"]["EvalAgentSelector"] & unknown;
                         definition?: {
                             cases: {
                                 expect: ({
@@ -15266,6 +15678,7 @@ interface paths {
             requestBody?: {
                 content: {
                     "application/json": {
+                        agent?: components["schemas"]["EvalAgentSelector"] & unknown;
                         evalConfig?: components["schemas"]["EvalConfigRequest"];
                         evalConfigs?: components["schemas"]["EvalConfigRequest"][];
                     } & {
@@ -16843,6 +17256,7 @@ interface paths {
             requestBody?: {
                 content: {
                     "application/json": {
+                        agent?: components["schemas"]["EvalAgentSelector"];
                         /**
                          * @description Force the execution path. Default: sync for suites within the synchronous case limit (50), batch above it.
                          * @enum {string}
@@ -16910,7 +17324,7 @@ interface paths {
                         "application/json": components["schemas"]["Error"];
                     };
                 };
-                /** @description Not found */
+                /** @description Not found, a version selector that names no pointer (alias_not_found, alias_archived, alias_expired, version_not_found), or a saved agent with no runnable live version (AGENT_NOT_DEPLOYED) */
                 404: {
                     headers: {
                         [name: string]: unknown;
@@ -16966,6 +17380,15 @@ interface paths {
                     };
                     content: {
                         "application/json": {
+                            /** @description The release alias the run resolved through, when it resolved through one. */
+                            agentTargetAlias?: string | null;
+                            /**
+                             * @description How the run picked its version. Null on a run that predates release aliases.
+                             * @enum {string|null}
+                             */
+                            agentTargetResolution?: "alias" | "version" | "legacy-live-row" | null;
+                            /** @description The exact Agent version every case of this run executed. Null for a legacy run. */
+                            agentVersionId?: string | null;
                             batchExecutionId: string;
                             /** @description Every graded case that errored, with the failure text its scores recorded. Empty when no case errored, when the run is not scored yet, or when it was scored before the field shipped. */
                             caseErrors: {
@@ -16973,10 +17396,14 @@ interface paths {
                                 error: string;
                                 name: string;
                             }[];
+                            /** @description SHA-256 over the ordered, normalized case set this run executed. */
+                            caseManifestHash?: string | null;
                             completedAt?: string;
                             evalConfig?: unknown;
                             evalGroupId?: string;
                             evalName?: string;
+                            /** @description SHA-256 over the evaluator configuration this run scored with. */
+                            evaluatorFingerprint?: string | null;
                             failedRecords: number;
                             flowId: string | null;
                             processedRecords: number;
@@ -16988,10 +17415,10 @@ interface paths {
                                     errorStack: string | null;
                                     executedAt: string;
                                     /**
-                                     * @description Engine that actually executed this step ('runtime' | 'legacy'). Recorded at write time from the committed lane decision; never inferred later. Null for rows written before attribution shipped and for units that never started executing (externally executed runs carry no engine).
+                                     * @description Engine that actually executed this step ('runtime' | 'legacy' | 'external'). Recorded at write time from the committed lane decision; never inferred later. 'external' marks a run a customer executed outside Runtype and reported through ingest. Null for rows written before attribution shipped and for units that never started executing.
                                      * @enum {string|null}
                                      */
-                                    executionEngine?: "runtime" | "legacy" | null;
+                                    executionEngine?: "runtime" | "legacy" | "external" | null;
                                     executionSessionId: string | null;
                                     inputVariables?: unknown;
                                     messageHistory: unknown[] | null;
@@ -17068,6 +17495,75 @@ interface paths {
         patch?: never;
         trace?: never;
     };
+    "/v1/executions/{executionId}/deliveries/{deliveryId}": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /**
+         * Inspect a durable input delivery
+         * @description Read the delivery independently of its host execution. Applied means durably incorporated into context, not model compliance. Settled shares the host outcome; not_applied means the host ended before consuming this input. Receipts are retained within the session retry window.
+         */
+        get: {
+            parameters: {
+                query?: never;
+                header?: never;
+                path: {
+                    executionId: string;
+                    deliveryId: string;
+                };
+                cookie?: never;
+            };
+            requestBody?: never;
+            responses: {
+                /** @description Input delivery receipt */
+                200: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["InputDeliveryReceipt"];
+                    };
+                };
+                /** @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 Delivery not found or expired */
+                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/executions/{executionId}/events": {
         parameters: {
             query?: never;
@@ -19030,9 +19526,7 @@ interface paths {
         };
         /**
          * Export flow for runtime (limited preview)
-         * @description **Limited preview — not yet generally available.** This endpoint is dark-launched and returns `404 Not Found` in production until GA; it is only reachable in non-production environments today.
-         *
-         *     Export a fully-resolved, self-contained flow definition that the @runtypelabs/runtime package can consume directly at boot. All step configs are inlined; no live DB queries are needed at execution time.
+         * @description Export a fully-resolved, self-contained flow definition that the @runtypelabs/runtime package can consume directly at boot. All step configs are inlined; no live DB queries are needed at execution time. Requires the `RUNTIME:EXPORT` scope and an Enterprise plan (the `byoc` entitlement); an unentitled account receives `403` with code `BYOC_PLAN_REQUIRED` in every environment.
          *
          *     The response carries `hostDependencies`: the runtime seams the exported artifact needs a host to wire before it can run everything it describes. A durable-class step (`wait-until` or `crawl`) anywhere in the flow's executable closure declares a `durable-pause-host` dependency; a detached-capable dynamic subagent pool or a detached inline subagent tool declares a `background-run-coordinator` dependency. The array is empty when nothing needs wiring, and the export is never refused for a declared dependency.
          */
@@ -19434,10 +19928,10 @@ interface paths {
                                 errorMessage?: string | null;
                                 estimatedCost?: string | null;
                                 /**
-                                 * @description Engine that actually executed this step ('runtime' | 'legacy'). Recorded at write time from the committed lane decision; never inferred later. Null for rows written before attribution shipped and for units that never started executing (externally executed runs carry no engine).
+                                 * @description Engine that actually executed this step ('runtime' | 'legacy' | 'external'). Recorded at write time from the committed lane decision; never inferred later. 'external' marks a run a customer executed outside Runtype and reported through ingest. Null for rows written before attribution shipped and for units that never started executing.
                                  * @enum {string|null}
                                  */
-                                executionEngine?: "runtime" | "legacy" | null;
+                                executionEngine?: "runtime" | "legacy" | "external" | null;
                                 executionSessionId: string | null;
                                 flowId: string | null;
                                 flowVersionId: string | null;
@@ -24140,7 +24634,7 @@ interface paths {
                     content: {
                         "application/json": {
                             data: {
-                                /** @description True when historical (R2 SQL) logs were unavailable and only recent hot-tier entries are included. Absent on healthy responses. */
+                                /** @description True when part of the window could not be read, so entries are missing: historical (R2 SQL) logs were unavailable, or the recent hot tier failed. Rows the hot tier evicted are served from R2 instead, so an eviction sets this only for the part too recent for R2 to have ingested. Absent on healthy responses. */
                                 degraded?: boolean;
                                 entries: {
                                     [key: string]: unknown;
@@ -24333,7 +24827,7 @@ interface paths {
                                 byType: {
                                     [key: string]: number;
                                 };
-                                /** @description True when historical (R2 SQL) counts were unavailable and stats cover only the recent hot-tier window. Absent on healthy responses. */
+                                /** @description True when part of the window could not be read, so counts are partial: historical (R2 SQL) counts were unavailable, or the recent hot tier failed. Rows the hot tier evicted are counted from R2 instead, so an eviction sets this only for the part too recent for R2 to have ingested. Absent on healthy responses, which are the only ones cached. */
                                 degraded?: boolean;
                                 histogram: {
                                     bucket: string;
@@ -24549,6 +25043,8 @@ interface paths {
                     limit?: string;
                     /** @description Pagination cursor */
                     cursor?: string;
+                    /** @description Set to `true` to include `totalCount`/`totalPages`. Omitted by default so a poll does not pay for a COUNT over the surface. */
+                    includeCount?: string;
                     /** @description Filter by surface ID */
                     surfaceId?: string;
                     /** @description Filter by surface ID (deprecated, use surfaceId) */
@@ -29397,14 +29893,103 @@ interface paths {
                 };
             };
         };
-        post?: never;
+        post?: never;
+        /**
+         * Delete product
+         * @description Delete a product (cascades to capabilities, surfaces, items, keys). Optionally cleans up associated flows/agents via cleanupFlowIds/cleanupAgentIds in the request body.
+         */
+        delete: {
+            parameters: {
+                query?: never;
+                header?: never;
+                path: {
+                    id: string;
+                };
+                cookie?: never;
+            };
+            requestBody?: never;
+            responses: {
+                /** @description Product deleted */
+                200: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": {
+                            success: boolean;
+                            warning?: string;
+                        };
+                    };
+                };
+                /** @description Invalid product ID */
+                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 Product not found */
+                404: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["Error"];
+                    };
+                };
+                /** @description Internal server error */
+                500: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["Error"];
+                    };
+                };
+            };
+        };
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/v1/products/{id}/activity": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
         /**
-         * Delete product
-         * @description Delete a product (cascades to capabilities, surfaces, items, keys). Optionally cleans up associated flows/agents via cleanupFlowIds/cleanupAgentIds in the request body.
+         * Get product activity
+         * @description First page of every activity source a product has: one entry per conversational surface (messaging conversations or client-conversation records) and one per distinct agent capability (compact executions). Rows, cursors and `hasMore` are identical to the per-source list endpoints, so a client can continue any source with its own endpoint. A source that fails returns empty rows plus an `error`; the response is still 200.
          */
-        delete: {
+        get: {
             parameters: {
-                query?: never;
+                query?: {
+                    /** @description Rows per source. Defaults to 50, clamped to 100. */
+                    limit?: string;
+                };
                 header?: never;
                 path: {
                     id: string;
@@ -29413,15 +29998,141 @@ interface paths {
             };
             requestBody?: never;
             responses: {
-                /** @description Product deleted */
+                /** @description Per-source first pages */
                 200: {
                     headers: {
                         [name: string]: unknown;
                     };
                     content: {
                         "application/json": {
-                            success: boolean;
-                            warning?: string;
+                            data: {
+                                agents: {
+                                    agentId: string;
+                                    data: {
+                                        agentId: string | null;
+                                        agentSource: string | null;
+                                        agentSpec?: unknown;
+                                        /**
+                                         * @description How the run selected its definition: `alias` or `version` for a request that named a selector, `legacy-live-row` for a run that read the mutable agent row.
+                                         * @enum {string}
+                                         */
+                                        agentTargetResolution: "alias" | "version" | "legacy-live-row";
+                                        /** @description Version number and label for `agentVersionId`, joined from `agent_versions`. `null` exactly when `agentVersionId` is `null`. */
+                                        agentVersion: {
+                                            id: string;
+                                            label: string | null;
+                                            versionNumber: number;
+                                        } | null;
+                                        /** @description The `agent_versions` row this run was recorded against, or `null`. `null` means the surface that admitted the run stamps no version (A2A, Product API, A2A pause admission and the Product MCP capability path record none today) or the run predates version stamping. It is never a claim that the run executed an unversioned configuration. */
+                                        agentVersionId: string | null;
+                                        /** @description Whether the agent loop ended by exhausting its `maxTurns` budget. Read this rather than inferring truncation from `stopReason`: a single-turn loop publishes `end_turn` on a budget end to preserve its original payload shape, and several clean success paths publish that same value. `null` means UNKNOWN — a run recorded before this field existed, or one executed by a lane that reports no per-iteration breakdown (external agents, Claude Managed) — and must not be read as `false`. */
+                                        budgetExhausted: boolean | null;
+                                        cancelRequestedAt: string | null;
+                                        completedAt: string | null;
+                                        /** @description The conversation thread this run belongs to, so consumers can group a multi-turn conversation's runs without a per-run log query. This is the run's OWN thread, distinct from `parentConversationId` (subagent lineage, the conversation of the run that spawned it). `null` on stateless surfaces (webhook, schedule, eval, one-shot API) and on runs persisted before the column existed. */
+                                        conversationId: string | null;
+                                        createdAt: string;
+                                        executionId: string;
+                                        /** @enum {string} */
+                                        executionMode: "attached" | "detached";
+                                        expiresAt: string | null;
+                                        /** @description The run's final output. Present by default; omitted when `view=compact`. */
+                                        finalOutput?: unknown;
+                                        id: string;
+                                        inputMessages?: unknown;
+                                        iterations: number | null;
+                                        lastHeartbeatAt: string | null;
+                                        /** @enum {string} */
+                                        notificationMode: "none" | "narrate" | "react";
+                                        parentAgentId: string | null;
+                                        parentConversationId: string | null;
+                                        parentExecutionId: string | null;
+                                        parentToolCallId: string | null;
+                                        pendingApproval: {
+                                            approvalId: string;
+                                            description?: string;
+                                            parameters?: unknown;
+                                            reason?: string;
+                                            requestedAt: string;
+                                            timeout?: number;
+                                            toolCallId: string;
+                                            toolName: string;
+                                            toolType: string;
+                                        } | null;
+                                        progress?: unknown;
+                                        retryOfExecutionId: string | null;
+                                        rootExecutionId: string | null;
+                                        startedAt: string | null;
+                                        /** @enum {string} */
+                                        status: "queued" | "running" | "paused" | "completed" | "failed" | "cancelled" | "interrupted";
+                                        stopReason: string | null;
+                                        surfaceType: string | null;
+                                        totalCost: string | null;
+                                        totalTokens?: unknown;
+                                    }[];
+                                    error?: {
+                                        message: string;
+                                    };
+                                    pagination: components["schemas"]["Pagination"];
+                                }[];
+                                surfaces: {
+                                    data: (({
+                                        agentMode: string;
+                                        createdAt: string;
+                                        externalParticipantId: string | null;
+                                        externalThreadId: string | null;
+                                        id: string;
+                                        lastMessageAt: string | null;
+                                        messageCount: number;
+                                        participantEmail: string | null;
+                                        participantName: string | null;
+                                        status: string;
+                                        subject: string | null;
+                                        surfaceId: string;
+                                        takeoverActorId: string | null;
+                                        takeoverActorType: string | null;
+                                        takeoverAt: string | null;
+                                        takeoverReason: string | null;
+                                        timezone: string | null;
+                                        updatedAt: string;
+                                    } & {
+                                        [key: string]: unknown;
+                                    }) | {
+                                        availableFields?: string[];
+                                        createdAt: string;
+                                        id: string;
+                                        messages: unknown[] | null;
+                                        metadata: {
+                                            [key: string]: unknown;
+                                        };
+                                        metadataLabels?: {
+                                            [key: string]: string;
+                                        };
+                                        metadataSchema?: {
+                                            keys: string[];
+                                        } & {
+                                            [key: string]: unknown;
+                                        };
+                                        name: string;
+                                        organizationId: string | null;
+                                        ownerId: string | null;
+                                        productSurfaceId: string | null;
+                                        schemaValid: boolean | null;
+                                        type: string;
+                                        updatedAt: string;
+                                        userId: string;
+                                    })[];
+                                    error?: {
+                                        message: string;
+                                    };
+                                    pagination: components["schemas"]["Pagination"];
+                                    /** @enum {string} */
+                                    source: "messaging" | "client_conversation";
+                                    surfaceId: string;
+                                }[];
+                            };
+                            /** @enum {boolean} */
+                            success: true;
                         };
                     };
                 };
@@ -29443,15 +30154,6 @@ interface paths {
                         "application/json": components["schemas"]["Error"];
                     };
                 };
-                /** @description Insufficient permissions */
-                403: {
-                    headers: {
-                        [name: string]: unknown;
-                    };
-                    content: {
-                        "application/json": components["schemas"]["Error"];
-                    };
-                };
                 /** @description Product not found */
                 404: {
                     headers: {
@@ -29472,6 +30174,9 @@ interface paths {
                 };
             };
         };
+        put?: never;
+        post?: never;
+        delete?: never;
         options?: never;
         head?: never;
         patch?: never;
@@ -38093,10 +38798,10 @@ interface paths {
                                  */
                                 estimatedCost: string | null;
                                 /**
-                                 * @description Engine that actually executed this record execution ('runtime' | 'legacy'). Recorded at write time from the committed lane decision; never inferred later. Null for rows written before attribution shipped and for units that never started executing (externally executed runs carry no engine).
+                                 * @description Engine that actually executed this record execution ('runtime' | 'legacy' | 'external'). Recorded at write time from the committed lane decision; never inferred later. 'external' marks a run a customer executed outside Runtype and reported through ingest. Null for rows written before attribution shipped and for units that never started executing.
                                  * @enum {string|null}
                                  */
-                                executionEngine?: "runtime" | "legacy" | null;
+                                executionEngine?: "runtime" | "legacy" | "external" | null;
                                 executionTimeMs: number | null;
                                 flowId: string | null;
                                 flowName: string | null;
@@ -38304,10 +39009,10 @@ interface paths {
                                 errorMessage?: string | null;
                                 estimatedCost?: string | null;
                                 /**
-                                 * @description Engine that actually executed this step ('runtime' | 'legacy'). Recorded at write time from the committed lane decision; never inferred later. Null for rows written before attribution shipped and for units that never started executing (externally executed runs carry no engine).
+                                 * @description Engine that actually executed this step ('runtime' | 'legacy' | 'external'). Recorded at write time from the committed lane decision; never inferred later. 'external' marks a run a customer executed outside Runtype and reported through ingest. Null for rows written before attribution shipped and for units that never started executing.
                                  * @enum {string|null}
                                  */
-                                executionEngine?: "runtime" | "legacy" | null;
+                                executionEngine?: "runtime" | "legacy" | "external" | null;
                                 executionSessionId: string | null;
                                 flowId: string | null;
                                 flowVersionId: string | null;
@@ -40361,10 +41066,10 @@ interface paths {
                                 error: string | null;
                                 executedAt: string | null;
                                 /**
-                                 * @description Engine that actually executed this record execution ('runtime' | 'legacy'). Recorded at write time from the committed lane decision; never inferred later. Null for rows written before attribution shipped and for units that never started executing (externally executed runs carry no engine).
+                                 * @description Engine that actually executed this record execution ('runtime' | 'legacy' | 'external'). Recorded at write time from the committed lane decision; never inferred later. 'external' marks a run a customer executed outside Runtype and reported through ingest. Null for rows written before attribution shipped and for units that never started executing.
                                  * @enum {string|null}
                                  */
-                                executionEngine?: "runtime" | "legacy" | null;
+                                executionEngine?: "runtime" | "legacy" | "external" | null;
                                 failedAt: string | null;
                                 failedStepCount: number | null;
                                 flowId: string | null;
@@ -40553,10 +41258,10 @@ interface paths {
                                 error: string | null;
                                 executedAt: string | null;
                                 /**
-                                 * @description Engine that actually executed this record execution ('runtime' | 'legacy'). Recorded at write time from the committed lane decision; never inferred later. Null for rows written before attribution shipped and for units that never started executing (externally executed runs carry no engine).
+                                 * @description Engine that actually executed this record execution ('runtime' | 'legacy' | 'external'). Recorded at write time from the committed lane decision; never inferred later. 'external' marks a run a customer executed outside Runtype and reported through ingest. Null for rows written before attribution shipped and for units that never started executing.
                                  * @enum {string|null}
                                  */
-                                executionEngine?: "runtime" | "legacy" | null;
+                                executionEngine?: "runtime" | "legacy" | "external" | null;
                                 failedAt: string | null;
                                 failedStepCount: number | null;
                                 flowId: string | null;
@@ -46666,6 +47371,13 @@ interface components {
             /** @default true */
             streamResponse: boolean;
         };
+        /** @description Source-organization ids and hashes this version was promoted from, linked on the receipt. Provenance only: it never authorizes anything, and the target credentials alone decide what the activation may do. */
+        AgentDeploymentPromotion: {
+            sourceAgentId?: string;
+            sourceCommit?: string;
+            sourceContentHash?: string;
+            sourceVersionId?: string;
+        };
         AgentDetachedApprovalJsonResponse: {
             approvalId: string;
             executionId: string;
@@ -46714,6 +47426,20 @@ interface components {
             contentHash: string;
             error: string;
         };
+        AgentEnsurePreviewAliasLimit: {
+            active: number;
+            /** @enum {string} */
+            code: "PREVIEW_ALIAS_LIMIT";
+            error: string;
+            limit: number;
+            /** @description The same remediation sentence as `error`. */
+            message: string;
+            /**
+             * @description Which population was already at its active-preview limit.
+             * @enum {string}
+             */
+            scope: "organization" | "agent";
+        };
         AgentEnsureResponse: {
             agentId: string;
             /** @description Server-computed canonical content hash. Clients should echo this hash in probes. */
@@ -47067,17 +47793,25 @@ interface components {
             };
         };
         AsyncDispatchHandle: {
+            accepted?: boolean;
             /** @description Present only for ephemeral inline-create dispatch. */
             claudeManagedAgentId?: string;
             /** @description Conversation id, when the request belongs to a conversation. */
             conversationId?: string;
+            /** @description Stable input-delivery identity, distinct from the host execution. */
+            deliveryId?: string;
+            /** @enum {string} */
+            deliveryStatus?: "pending" | "applied" | "settled" | "not_applied";
+            /** @description Poll this receipt to distinguish pending, applied, settled, and not-applied input. */
+            deliveryStatusUrl?: string;
+            eventsUrl?: string;
             /** @description The durable execution handle — poll with this. */
             executionId: string;
             /**
-             * @description Lifecycle status at acceptance.
+             * @description Host lifecycle at acceptance or idempotent delivery replay.
              * @enum {string}
              */
-            status: "queued" | "running";
+            status: "queued" | "running" | "paused" | "completed" | "failed" | "cancelled" | "interrupted";
             /** @description Relative URL for polling this execution. */
             statusUrl: string;
             /** @description Saved flow or agent id, when known. */
@@ -47141,6 +47875,124 @@ 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;
         };
+        ClientInputDeliveryReceipt: {
+            deliveryId: string;
+            executionId: string;
+            initial: boolean;
+            outcome?: string;
+            sequence: number;
+            /** @enum {string} */
+            status: "pending" | "applied" | "settled" | "not_applied";
+        };
+        ConversationBusyError: {
+            /** @enum {string} */
+            code: "CONVERSATION_BUSY";
+            error: string;
+            /** @description The execution holding the conversation slot. Poll /v1/executions/{executionId}/status, or send x-runtype-concurrency: join to attach to it. */
+            executionId?: string;
+            /**
+             * @description Where the occupant is: `claiming` (admitted, not yet started; a join attaches through the claim), `running`, `paused` (a join stays pending until an authorized resume), or `queued` (an earlier queue-only turn is waiting).
+             * @enum {string}
+             */
+            phase?: "claiming" | "running" | "paused" | "queued";
+        };
+        /** @description Who wrote this message in the source system. Stored and returned, never replayed. */
+        ConversationMessageAuthor: {
+            /** @description The author id in the source system. */
+            externalId?: string;
+            /** @description The author id in Runtype, when there is one. */
+            id?: string;
+            name?: string;
+            /** @enum {string} */
+            type: "end_user" | "operator" | "agent" | "system";
+        };
+        ConversationModifiedError: components["schemas"]["Error"] & {
+            /**
+             * @description The stored transcript changed between the read and the write; re-read and retry.
+             * @enum {string}
+             */
+            code: "CONVERSATION_MODIFIED";
+        };
+        /** @description Import provenance, stored as metadata.importSource. */
+        ConversationSource: {
+            /** @description The conversation id in the source system. */
+            externalId?: string;
+            /** Format: date-time */
+            importedAt?: string;
+            /** @description The system the transcript came from, for example "intercom" or "custom". */
+            system: string;
+        };
+        ConversationTranscriptMessage: {
+            author?: components["schemas"]["ConversationMessageAuthor"];
+            content: string | (({
+                text: string;
+                /** @enum {string} */
+                type: "text";
+            } & {
+                [key: string]: unknown;
+            }) | ({
+                image: string;
+                mimeType?: string;
+                /** @enum {string} */
+                type: "image";
+            } & {
+                [key: string]: unknown;
+            }) | ({
+                data: string;
+                filename: string;
+                mimeType: string;
+                /** @enum {string} */
+                type: "file";
+            } & {
+                [key: string]: unknown;
+            }) | ({
+                providerOptions?: {
+                    [key: string]: unknown;
+                };
+                text: string;
+                /** @enum {string} */
+                type: "reasoning";
+            } & {
+                [key: string]: unknown;
+            }) | {
+                assetId: string;
+                filename?: string;
+                mimeType: string;
+                orgKey: string;
+                /** @enum {string} */
+                refKind: "image" | "file";
+                sizeBytes: number;
+                /** @enum {string} */
+                type: "asset_ref";
+            })[];
+            /** @description ISO 8601 when Runtype mints it; any string is accepted on import. */
+            createdAt?: string;
+            id?: string;
+            metadata?: {
+                [key: string]: unknown;
+            };
+            /** @enum {string} */
+            role: "system" | "user" | "assistant" | "tool";
+            toolCalls?: {
+                /** @default {} */
+                args: {
+                    [key: string]: unknown;
+                };
+                providerOptions?: {
+                    [key: string]: unknown;
+                };
+                toolCallId: string;
+                toolName: string;
+            }[];
+            toolResults?: {
+                providerOptions?: {
+                    [key: string]: unknown;
+                };
+                result?: unknown;
+                toolCallId: string;
+                toolName: string;
+            }[];
+        };
         DailyUsageResponse: {
             daily?: {
                 atSpendLimit: boolean;
@@ -47198,12 +48050,21 @@ interface components {
             }[];
         };
         DispatchAgentJsonResponse: {
+            agentExecutionId?: string;
             blockReason?: string;
             claudeManagedAgentId?: string;
             code?: string;
+            conversationId?: string;
+            /** @description Stable input-delivery identity, distinct from the host execution. */
+            deliveryId?: string;
+            /** @enum {string} */
+            deliveryStatus?: "pending" | "applied" | "settled" | "not_applied";
+            /** @description Poll this receipt to distinguish pending, applied, settled, and not-applied input. */
+            deliveryStatusUrl?: string;
             error?: string;
+            executionId?: string;
             /** @enum {string} */
-            executionMode?: "claude_managed";
+            executionMode?: "claude_managed" | "runtype_managed";
             executionTime?: number;
             externalAgent?: {
                 contextId?: string;
@@ -47402,6 +48263,13 @@ interface components {
             }[];
             error: string;
         };
+        /** @description Version selector for an Agent-target suite. Supply at most one of alias or versionId; omit it to run the saved configuration. */
+        EvalAgentSelector: {
+            /** @description Run whichever version this release alias currently points at. Resolved once for the whole run. */
+            alias?: string;
+            /** @description Run this exact immutable version snapshot. */
+            versionId?: string;
+        };
         EvalCase: {
             createdAt: string;
             enabled: boolean;
@@ -47599,16 +48467,27 @@ interface components {
             updatedAt: string | null;
         };
         EvalRunScoresResponse: {
+            /** @description The release alias the run resolved through, when it resolved through one. */
+            agentTargetAlias?: string | null;
+            /**
+             * @description How the run picked its version. Null on a run that predates release aliases.
+             * @enum {string|null}
+             */
+            agentTargetResolution?: "alias" | "version" | "legacy-live-row" | null;
+            /** @description The exact Agent version every case of this run executed. Null for a legacy run. */
+            agentVersionId?: string | null;
+            /** @description SHA-256 over the ordered, normalized case set this run executed. */
+            caseManifestHash?: string | null;
             cases: {
                 /** @description The saved eval case id; null when the case row was deleted or the record could not be mapped to a case. */
                 caseId: string | null;
                 /** @description Why the case errored (the provider or execution failure text, 2000 chars max); null when the case did not error or the run predates this field. */
                 error: string | null;
                 /**
-                 * @description Engine that actually executed this graded case ('runtime' | 'legacy'). Recorded at write time from the committed lane decision; never inferred later. Null for rows written before attribution shipped and for units that never started executing (externally executed runs carry no engine).
+                 * @description Engine that actually executed this graded case ('runtime' | 'legacy' | 'external'). Recorded at write time from the committed lane decision; never inferred later. 'external' marks a run a customer executed outside Runtype and reported through ingest. Null for rows written before attribution shipped and for units that never started executing.
                  * @enum {string|null}
                  */
-                executionEngine?: "runtime" | "legacy" | null;
+                executionEngine?: "runtime" | "legacy" | "external" | null;
                 name: string;
                 /** @description For a checkpoint ("saved from run") case run in next-step mode: the tool-call intent(s) the target emitted as its graded next step. An empty array means it replied with a message instead of calling a tool. Null for ordinary runs and for runs recorded before this field shipped. */
                 nextStepToolCalls: {
@@ -47652,6 +48531,8 @@ interface components {
                 /** @description Recomputed from the persisted outcomes using the run's recorded strict mode, so historical verdicts match what the run originally reported. */
                 passed: boolean;
             }[];
+            /** @description SHA-256 over the evaluator configuration this run scored with. */
+            evaluatorFingerprint?: string | null;
             /** @description The eval name recorded on the run. */
             name: string | null;
             passedCases: number;
@@ -47747,6 +48628,19 @@ interface components {
             total: number;
         };
         EvalSuiteRunQueued: {
+            /** @description The release alias the run resolved through, when it resolved through one. */
+            agentTargetAlias?: string | null;
+            /**
+             * @description How the run picked its version. Null on a run that predates release aliases.
+             * @enum {string|null}
+             */
+            agentTargetResolution?: "alias" | "version" | "legacy-live-row" | null;
+            /** @description The exact Agent version every case of this run executed. Null for a legacy run. */
+            agentVersionId?: string | null;
+            /** @description SHA-256 over the ordered, normalized case set this run executed. */
+            caseManifestHash?: string | null;
+            /** @description SHA-256 over the evaluator configuration this run scored with. */
+            evaluatorFingerprint?: string | null;
             /** @enum {string} */
             mode: "batch";
             name: string;
@@ -48445,6 +49339,15 @@ interface components {
             valid: boolean;
             warnings: components["schemas"]["FlowValidationIssue"][];
         };
+        InputDeliveryReceipt: {
+            deliveryId: string;
+            executionId: string;
+            initial: boolean;
+            outcome?: string;
+            sequence: number;
+            /** @enum {string} */
+            status: "pending" | "applied" | "settled" | "not_applied";
+        };
         ManagedAgentRunOutput: {
             anthropicFileId: string;
             /** @description Asset-storage key the bytes were persisted to. */
@@ -48503,6 +49406,15 @@ interface components {
             totalCount?: number;
             totalPages?: number;
         };
+        PreviewAliasLimitError: components["schemas"]["Error"] & {
+            active: number;
+            /** @enum {string} */
+            code: "PREVIEW_ALIAS_LIMIT";
+            limit: number;
+            message: string;
+            /** @enum {string} */
+            scope: "organization" | "agent";
+        };
         ProductEnsureConflict: {
             /** @enum {string} */
             code: "external_modification" | "remote_changed";
@@ -48642,6 +49554,17 @@ interface components {
             schemaVersion: number;
         };
         RunEvalResponse: {
+            /** @description The release alias the run resolved through, when it resolved through one. */
+            agentTargetAlias?: string | null;
+            /**
+             * @description How the run picked its version. Null on a run that predates release aliases.
+             * @enum {string|null}
+             */
+            agentTargetResolution?: "alias" | "version" | "legacy-live-row" | null;
+            /** @description The exact Agent version every case of this run executed. Null for a legacy run. */
+            agentVersionId?: string | null;
+            /** @description SHA-256 over the ordered, normalized case set this run executed. */
+            caseManifestHash?: string | null;
             cases: {
                 /** @description Why the case errored (the provider or execution failure text, 2000 chars max). Present only when errored is true and the run reported a cause. */
                 error?: string;
@@ -48673,6 +49596,8 @@ interface components {
                 outputExcerpt: string;
                 passed: boolean;
             }[];
+            /** @description SHA-256 over the evaluator configuration this run scored with. */
+            evaluatorFingerprint?: string | null;
             name: string;
             /** @description True when every case passed every grader. */
             passed: boolean;
@@ -49164,6 +50089,29 @@ type AgentStreamEvent = components['schemas']['ExecutionStreamEvent'];
 type StreamEventOf<U, T extends string> = Extract<U, {
     type: T;
 }>;
+/**
+ * One release alias: the named, org-owned mutable pointer that selects which
+ * immutable version of an agent runs (ADR 0025).
+ */
+type AgentAlias = paths['/v1/agents/{id}/aliases/{alias}']['get']['responses'][200]['content']['application/json'];
+/** The envelope `GET /v1/agents/{id}/aliases` answers with. */
+type AgentAliasList = paths['/v1/agents/{id}/aliases']['get']['responses'][200]['content']['application/json'];
+/** The envelope `GET /v1/agent-aliases` answers with: one alias name, org-wide. */
+type OrganizationAgentAliasList = paths['/v1/agent-aliases']['get']['responses'][200]['content']['application/json'];
+/** One row of {@link OrganizationAgentAliasList}: a pointer plus the agent carrying it. */
+type OrganizationAgentAlias = OrganizationAgentAliasList['data'][number];
+/** What activating or rolling back a pointer reports back. */
+type AgentAliasActivation = paths['/v1/agents/{id}/aliases/{alias}']['put']['responses'][200]['content']['application/json'];
+/** What archiving a pointer reports back. */
+type AgentAliasArchived = paths['/v1/agents/{id}/aliases/{alias}']['delete']['responses'][200]['content']['application/json'];
+/** One append-only deployment receipt. */
+type AgentDeploymentReceipt = paths['/v1/agents/{id}/deployments']['get']['responses'][200]['content']['application/json']['data'][number];
+/** The envelope `GET /v1/agents/{id}/deployments` answers with. */
+type AgentDeploymentList = paths['/v1/agents/{id}/deployments']['get']['responses'][200]['content']['application/json'];
+/** Source-organization provenance an activation may link to its receipt. */
+type AgentDeploymentPromotion = NonNullable<NonNullable<paths['/v1/agents/{id}/aliases/{alias}']['put']['requestBody']>['content']['application/json']['promotion']>;
+/** What an ensure converge reports about the pointer it aimed. */
+type AgentEnsureDeployment = components['schemas']['AgentEnsureDeployment'];
 
 /**
  * Options for the flow stream consumers.
@@ -50935,6 +51883,8 @@ type DispatchContinuationRequest = NonNullable<paths['/v1/dispatch/continue']['p
 type DispatchResponse = paths['/v1/dispatch']['post']['responses'][200]['content']['application/json'];
 /** Durable handle returned by execute routes when `Prefer: respond-async` is applied. */
 type AsyncExecutionHandle = components['schemas']['AsyncDispatchHandle'];
+/** Durable user-input receipt, independently observable from its host execution. */
+type InputDeliveryReceipt = components['schemas']['InputDeliveryReceipt'];
 /** Lifecycle response returned by the generic asynchronous execution status route. */
 type AsyncExecutionStatus = paths['/v1/executions/{executionId}/status']['get']['responses'][200]['content']['application/json'];
 /** Buffered ordinary tool-output continuation (a durable-lane resume uses a separate variant). */
@@ -51446,12 +52396,12 @@ interface SurfaceListParams extends ListParams {
     environment?: string;
 }
 type ConversationSource = 'app' | 'client_token';
-interface ConversationMessage {
-    id: string;
-    role: 'user' | 'assistant' | 'system';
-    content: string;
-    createdAt?: string;
-}
+/**
+ * One stored transcript message, sourced directly from the generated OpenAPI
+ * contract: roles include `tool`, content may be an array of parts, and
+ * `toolCalls` / `toolResults` carry full tool fidelity.
+ */
+type ConversationMessage = components['schemas']['ConversationTranscriptMessage'];
 /**
  * Conversation detail (single conversation, with messages).
  *
@@ -51481,31 +52431,19 @@ interface ConversationListParams {
     limit?: number;
     cursor?: string;
 }
-interface CreateConversationRequest {
-    title?: string;
-    modelId?: string;
-    systemPrompt?: string;
-    /**
-     * First-class owner key (#3395) — persisted to the indexed `owner_id` column
-     * and queryable via {@link ConversationListParams.ownerId}. `null` is accepted
-     * for symmetry with {@link UpdateConversationRequest} and simply means "no
-     * owner" on create.
-     */
-    ownerId?: string | null;
-    metadata?: Record<string, unknown>;
-}
-interface UpdateConversationRequest {
-    title?: string;
-    modelId?: string;
-    systemPrompt?: string;
-    /**
-     * First-class owner key (#3395). `null` CLEARS the stored owner; omitting the
-     * field leaves it untouched.
-     */
-    ownerId?: string | null;
-    metadata?: Record<string, unknown>;
-    messages?: ConversationMessage[];
-}
+/**
+ * POST /v1/conversations request body, sourced directly from the generated
+ * OpenAPI contract. `ownerId` (#3395) is persisted to the indexed `owner_id`
+ * column and queryable via {@link ConversationListParams.ownerId}; `null` on
+ * create simply means "no owner".
+ */
+type CreateConversationRequest = NonNullable<paths['/v1/conversations']['post']['requestBody']>['content']['application/json'];
+/**
+ * PUT /v1/conversations/{id} request body, sourced directly from the generated
+ * OpenAPI contract. `ownerId: null` CLEARS the stored owner (#3395); omitting
+ * the field leaves it untouched, and `messages` replaces the whole transcript.
+ */
+type UpdateConversationRequest = NonNullable<paths['/v1/conversations/{id}']['put']['requestBody']>['content']['application/json'];
 interface LogEntry {
     timestamp: string;
     level: string;
@@ -52392,8 +53330,33 @@ interface RunEvalCaseResult {
     /** Why the case errored (provider or execution failure text); present only when `errored` is true and a cause was reported. */
     error?: string;
 }
+/**
+ * Pin an Agent-target run to one version. Supply at most one of `alias` or
+ * `versionId`; the run resolves it once and every case executes that version.
+ */
+interface EvalAgentSelector {
+    /** Run whichever version this release alias currently points at. */
+    alias?: string;
+    /** Run this exact immutable version snapshot. */
+    versionId?: string;
+}
+/** How a run picked its version; `legacy-live-row` means no selector was supplied. */
+type EvalAgentTargetResolution = 'alias' | 'version' | 'legacy-live-row';
+/** What a run recorded about the artifact it evaluated and the judges it used. */
+interface EvalRunEvidence {
+    /** The exact Agent version every case executed; null for a run that pinned none. */
+    agentVersionId?: string | null;
+    /** How the run picked its version; null on a run that predates release aliases. */
+    agentTargetResolution?: EvalAgentTargetResolution | null;
+    /** The release alias the run resolved through, when it resolved through one. */
+    agentTargetAlias?: string | null;
+    /** SHA-256 over the ordered, normalized case set this run executed. */
+    caseManifestHash?: string | null;
+    /** SHA-256 over the evaluator configuration this run scored with. */
+    evaluatorFingerprint?: string | null;
+}
 /** The synchronous run + score result returned by `client.evals.runSuite(...)`. */
-interface RunEvalResult {
+interface RunEvalResult extends EvalRunEvidence {
     /** The saved suite id, or `null` for an inline (virtual) run. */
     suiteId: string | null;
     name: string;
@@ -52448,7 +53411,7 @@ interface EvalRunCaseScores {
     nextStepToolCalls: NextStepToolCall[] | null;
 }
 /** Persisted per-case grader scores for a run (`client.evals.getRunScores`). */
-interface EvalRunScores {
+interface EvalRunScores extends EvalRunEvidence {
     runId: string;
     /** The suite the run executed; null when the suite was since deleted. */
     suiteId: string | null;
@@ -52477,9 +53440,11 @@ type RunEvalInput = {
     suiteId: string;
     strict?: boolean;
     virtual?: boolean;
+    agent?: EvalAgentSelector;
 } | {
     definition: EvalDefinition;
     strict?: boolean;
+    agent?: EvalAgentSelector;
 };
 /**
  * Idempotently converge an eval suite definition onto the platform. Hash-first:
@@ -53352,7 +54317,7 @@ interface EvalSuiteListResult {
     total: number;
 }
 /** A large suite queued as a durable run (graded when it completes). */
-interface EvalSuiteRunQueued {
+interface EvalSuiteRunQueued extends EvalRunEvidence {
     mode: 'batch';
     /** Poll `client.evals.getRunScores(runId)` once the run completes. */
     runId: string;
@@ -53494,6 +54459,10 @@ declare class EvalSuitesNamespace {
     run(suiteId: string, options?: {
         strict?: boolean;
         mode?: 'sync' | 'batch';
+        /** Pin an Agent-target suite to one version for this run only. */
+        agent?: EvalAgentSelector;
+        /** Run every case against this model instead of the target's configured one. */
+        modelOverride?: string;
     }): Promise<EvalSuiteRunResult>;
     /** Add one or more test cases to a suite. */
     addCases(suiteId: string, cases: EvalSuiteCaseInput[]): Promise<{
@@ -54536,6 +55505,204 @@ declare class SkillsNamespace {
     pull(name: string): Promise<SkillPullResult>;
 }
 
+/**
+ * The HTTP verbs the alias plane needs. Both SDK client classes satisfy it, so
+ * one implementation serves `Runtype.agents.aliases` and `client.agents.aliases`.
+ */
+interface AgentAliasTransport {
+    get<T>(path: string, params?: Record<string, any>): Promise<T>;
+    put<T>(path: string, data?: unknown, headers?: Record<string, string>): Promise<T>;
+    post<T>(path: string, data?: unknown, headers?: Record<string, string>): Promise<T>;
+    delete<T>(path: string, data?: unknown, headers?: Record<string, string>): Promise<T>;
+}
+/** The `live` pointer every agent's production traffic follows. Never expires. */
+declare const LIVE_AGENT_ALIAS = "live";
+/**
+ * A stale compare-and-swap on a pointer (HTTP 412). The stored revision moved
+ * on between the read and the write, so re-read the alias and retry.
+ */
+declare class AgentAliasRevisionMismatchError extends Error {
+    readonly code = "alias_revision_mismatch";
+    readonly expectedRevision: number;
+    readonly actualRevision: number | null;
+    constructor(body: {
+        error?: string;
+        expected: number;
+        actual: number | null;
+    });
+}
+/** A write to an existing `live` pointer that quoted no revision (HTTP 428). */
+declare class AgentAliasRevisionRequiredError extends Error {
+    readonly code = "alias_revision_required";
+    constructor(message: string);
+}
+/**
+ * A pointer that does not resolve (HTTP 404). Missing or archived aliases never
+ * fall back to live, so this names the pointer that was asked for.
+ */
+declare class AgentAliasNotFoundError extends Error {
+    readonly code = "alias_not_found";
+    readonly alias: string;
+    readonly agentId: string;
+    constructor(body: {
+        error?: string;
+        alias: string;
+        agentId: string;
+    });
+}
+/**
+ * A new preview pointer refused by the active-preview quota (HTTP 429). Archive
+ * a preview you no longer need — archiving frees the quota immediately — or wait
+ * for one to expire. `live` is never counted.
+ */
+declare class AgentAliasPreviewLimitError extends Error {
+    readonly code = "PREVIEW_ALIAS_LIMIT";
+    readonly scope: 'organization' | 'agent';
+    readonly limit: number;
+    readonly active: number;
+    constructor(body: {
+        error?: string;
+        scope: 'organization' | 'agent';
+        limit: number;
+        active: number;
+    });
+}
+/** A version whose named references no longer resolve in this account (HTTP 422). */
+declare class AgentAliasDependencyError extends Error {
+    readonly code = "alias_dependency_unresolved";
+    readonly refs: string[];
+    constructor(body: {
+        error?: string;
+        refs?: string[];
+    });
+}
+/** Every coded refusal the alias plane maps onto a typed error. */
+type TypedAliasError = AgentAliasRevisionMismatchError | AgentAliasRevisionRequiredError | AgentAliasNotFoundError | AgentAliasDependencyError | AgentAliasPreviewLimitError;
+/** The refusal code, when this is one of the typed alias errors. */
+declare function agentAliasErrorCode(err: unknown): TypedAliasError['code'] | undefined;
+interface ListAgentAliasesOptions {
+    /** Include archived pointers, which never resolve for execution. */
+    includeArchived?: boolean;
+    /** Page size. Omit to receive the whole (small) pointer set. */
+    limit?: number;
+    /** The `nextCursor` a previous page returned. */
+    cursor?: string;
+}
+interface ActivateAgentAliasInput {
+    /** The exact version to aim the pointer at. Never a pointer name. */
+    versionId: string;
+    /**
+     * The revision read from the alias, sent as `If-Match`. Required by the
+     * server on an existing `live` pointer; optional on previews and on the
+     * first live deployment.
+     */
+    revision?: number;
+    /** Replay key: repeating the same activation returns the first receipt. */
+    idempotencyKey?: string;
+    /** Why this deployment happened. Recorded for humans; nothing branches on it. */
+    reason?: string;
+    /** Source-organization ids and hashes for a cross-organization promotion. */
+    promotion?: AgentDeploymentPromotion;
+}
+interface ArchiveAgentAliasInput {
+    revision?: number;
+}
+interface RollbackAgentAliasInput {
+    /** How many pointer-moving receipts to walk back. Defaults to 1. */
+    steps?: number;
+    revision?: number;
+    reason?: string;
+}
+/**
+ * One pointer an {@link AgentAliasesNamespace.archiveEverywhere} pass could not
+ * archive. A stale revision (412) or a concurrent archive (404) is reported
+ * here rather than aborting the sweep over the remaining agents.
+ */
+interface AgentAliasArchiveFailure {
+    agentId: string;
+    agentName: string;
+    error: string;
+    code?: string;
+}
+interface ArchiveAgentAliasEverywhereResult {
+    alias: string;
+    archived: Array<{
+        agentId: string;
+        agentName: string;
+        revision: number;
+        receiptId: string;
+    }>;
+    failed: AgentAliasArchiveFailure[];
+}
+interface ListAgentDeploymentsOptions {
+    /** Only receipts for this pointer. */
+    alias?: string;
+    limit?: number;
+    cursor?: string;
+}
+/**
+ * Release aliases: the named pointers that select which immutable version of an
+ * agent runs. Activation always names an exact `versionId` — the SDK never
+ * resolves a pointer client-side and deploys whatever it found.
+ *
+ * @example
+ * ```typescript
+ * const live = await client.agents.aliases.get('agt_1', 'live')
+ * await client.agents.aliases.activate('agt_1', 'live', {
+ *   versionId: 'agtv_9',
+ *   revision: live.revision,
+ *   idempotencyKey: 'deploy-2026-09-06-1',
+ * })
+ * ```
+ */
+declare class AgentAliasesNamespace {
+    private getTransport;
+    constructor(getTransport: () => AgentAliasTransport);
+    /** List this agent's pointers, `live` first then previews by name. */
+    list(agentId: string, options?: ListAgentAliasesOptions): Promise<AgentAliasList>;
+    /**
+     * Every agent in the organization carrying a pointer with this name, each
+     * with the revision to quote back as `If-Match`. The read a PR-close cleanup
+     * makes before archiving.
+     */
+    listByName(alias: string, options?: {
+        includeArchived?: boolean;
+    }): Promise<OrganizationAgentAliasList>;
+    /**
+     * Archive this pointer on every agent in the organization that carries it,
+     * each under the revision just read. A failure on one agent is reported and
+     * the rest continue; a second run finds nothing active and archives nothing.
+     */
+    archiveEverywhere(alias: string): Promise<ArchiveAgentAliasEverywhereResult>;
+    /** Read one pointer. A missing or archived alias throws, never falls back to live. */
+    get(agentId: string, alias: string, options?: {
+        includeArchived?: boolean;
+    }): Promise<AgentAlias>;
+    /** Aim one pointer at one exact version, appending a deployment receipt. */
+    activate(agentId: string, alias: string, input: ActivateAgentAliasInput): Promise<AgentAliasActivation>;
+    /** Archive a preview pointer: it stops resolving but keeps its history. */
+    archive(agentId: string, alias: string, input?: ArchiveAgentAliasInput): Promise<AgentAliasArchived>;
+    /** Re-aim a pointer at the version its receipt history records before this one. */
+    rollback(agentId: string, alias: string, input?: RollbackAgentAliasInput): Promise<AgentAliasActivation>;
+    private run;
+}
+/**
+ * The append-only deployment history of an agent: every pointer move, its
+ * previous and new versions, the actor, the provenance and the dependency
+ * fingerprints checked at activation.
+ */
+declare class AgentDeploymentsNamespace {
+    private getTransport;
+    constructor(getTransport: () => AgentAliasTransport);
+    /** Receipts newest first, cursor-paginated; filter to one pointer with `alias`. */
+    list(agentId: string, options?: ListAgentDeploymentsOptions): Promise<AgentDeploymentList>;
+}
+
+/**
+ * The refusal a client-side `release` + `deploy` mix answers with. Byte-identical
+ * to the server's, so both spellings of the mistake read the same.
+ */
+declare const ENSURE_RELEASE_DEPLOY_CONFLICT_MESSAGE: string;
 /** Canonical normalized form — must stay byte-identical to the shared impl. */
 declare function normalizeAgentDefinition(definition: {
     name: string;
@@ -54700,8 +55867,21 @@ interface EnsureAgentOptions {
      * rather than ensure. Default 'error' (HTTP 409 → AgentEnsureConflictError).
      */
     onConflict?: 'error' | 'overwrite';
-    /** 'publish' also re-aims the published-version pointer. Default 'none'. */
+    /**
+     * Compatibility input translated to a deploy: 'publish' activates `live`,
+     * 'none' saves without activating. Prefer {@link EnsureAgentOptions.deploy}.
+     * Supplying both is refused client-side and by the server.
+     */
     release?: 'none' | 'publish';
+    /**
+     * Atomically save this definition and activate it at a release alias.
+     * `{ alias: 'live' }` deploys to production; any other name is a preview
+     * pointer that never touches the live row, config hash, capabilities or the
+     * draft pointer. Mutually exclusive with {@link EnsureAgentOptions.release}.
+     */
+    deploy?: {
+        alias: string;
+    };
     /**
      * TOCTOU guard binding a dry run to its apply: the write only proceeds if
      * the remote still hashes to this value (409 remote_changed otherwise).
@@ -54722,6 +55902,10 @@ interface EnsureAgentConverged {
     versionId: string | null;
     /** The server-computed canonical hash (echo this — never your own). */
     contentHash: string;
+    /** For a non-live deploy: the hash the alias carried before this converge. */
+    remoteHash?: string;
+    /** The pointer this converge aimed, present only when it carried release or deploy. */
+    deployment?: AgentEnsureDeployment;
 }
 interface EnsureAgentPlan {
     result: 'plan';
@@ -54730,6 +55914,8 @@ interface EnsureAgentPlan {
     contentHash: string;
     remoteHash?: string;
     agentId?: string;
+    /** The pointer this dry run would aim, and whether it would move. */
+    deployment?: AgentEnsureDeployment;
 }
 type EnsureAgentResult = EnsureAgentConverged | EnsureAgentPlan;
 interface AgentPullResult {
@@ -54785,6 +55971,10 @@ declare class AgentDriftError extends Error {
  */
 declare class AgentsNamespace {
     private getClient;
+    /** Release aliases: the named pointers selecting which version runs (ADR 0025). */
+    readonly aliases: AgentAliasesNamespace;
+    /** The append-only deployment history behind those pointers. */
+    readonly deployments: AgentDeploymentsNamespace;
     constructor(getClient: () => RuntypeClient$1);
     /**
      * Idempotently converge a definition onto the platform. Hash-first: probes
@@ -55130,6 +56320,12 @@ declare function ensureFpo(client: RuntypeClient$1, fpo: FpoInput, options?: Ens
  */
 declare function pullFpo(client: RuntypeClient$1, name: string): Promise<PullFpoResult>;
 
+/** Merged first page of every activity source a product has. */
+type ProductActivityResponse = paths['/v1/products/{id}/activity']['get']['responses'][200]['content']['application/json'];
+interface ProductActivityOptions {
+    /** Rows per source. Defaults to 50 server-side, clamped to 100. */
+    limit?: number;
+}
 declare class ProductsNamespace {
     private getClient;
     constructor(getClient: () => RuntypeClient$1);
@@ -55194,6 +56390,20 @@ declare class ProductsNamespace {
      * ```
      */
     pullFpo(name: string): Promise<PullFpoResult>;
+    /**
+     * One request for the first page of every activity source a product has:
+     * conversations per conversational surface, executions per distinct agent.
+     * Rows, cursors and `hasMore` match the per-source list endpoints, so a
+     * caller continues any source with that source's own endpoint. A source that
+     * fails carries an `error` instead of failing the response.
+     *
+     * @example
+     * ```typescript
+     * const { data } = await Runtype.products.activity('prd_123', { limit: 25 })
+     * for (const surface of data.surfaces) console.log(surface.surfaceId, surface.data.length)
+     * ```
+     */
+    activity(productId: string, options?: ProductActivityOptions): Promise<ProductActivityResponse>;
 }
 
 /**
@@ -55472,7 +56682,7 @@ declare class RuntypeClient$1 {
     /**
      * Generic PUT request
      */
-    put<T>(path: string, data?: unknown): Promise<T>;
+    put<T>(path: string, data?: unknown, extraHeaders?: Record<string, string>): Promise<T>;
     /**
      * Generic PATCH request
      */
@@ -55480,7 +56690,7 @@ declare class RuntypeClient$1 {
     /**
      * Generic DELETE request
      */
-    delete<T>(path: string): Promise<T>;
+    delete<T>(path: string, data?: unknown, extraHeaders?: Record<string, string>): Promise<T>;
     /**
      * Generic request that returns raw Response for streaming
      */
@@ -55833,6 +57043,128 @@ declare class Runtype {
     static get surfaces(): SurfacesNamespace;
 }
 
+/**
+ * The HTTP surface a promotion leg needs from one organization's credentials.
+ * Both SDK client classes satisfy it, and a promotion always holds two of
+ * them — one per organization. Credentials never cross between the two.
+ */
+type AgentPromotionTransport = AgentAliasTransport;
+/** Everything a later promotion step needs, and nothing that could authorize one. */
+interface AgentPromotionManifest {
+    /** Manifest schema version, so a later reader can refuse an unknown shape. */
+    manifest: 1;
+    /** Agent name, the ensure identity in both organizations. */
+    name: string;
+    createdAt: string;
+    source: {
+        agentId: string;
+        versionId: string | null;
+        contentHash: string;
+        /** Source-control commit the promotion ran from, when it ran inside a repo. */
+        commit?: string;
+    };
+    target: {
+        agentId: string;
+        versionId: string;
+        /** The candidate preview pointer the definition was staged at. */
+        alias: string;
+        revision: number | null;
+        contentHash: string;
+    };
+}
+/** What `validate` found, and whether the promotion may proceed. */
+interface AgentPromotionValidation {
+    ok: boolean;
+    /** The dry-run plan re-running the same ensure in the target organization. */
+    plan: EnsureAgentPlan;
+    /** Named references the destination organization could not resolve. */
+    unresolvedRefs: string[];
+    /** Every reference the candidate carries, with the fingerprint recorded at staging. */
+    refs: Array<{
+        ref: string;
+        resolvedId: string | null;
+        fingerprint: string | null;
+    }>;
+}
+/** A promotion step that could not produce a manifest or a usable answer. */
+declare class AgentPromotionError extends Error {
+    constructor(message: string);
+}
+interface PrepareAgentPromotionInput {
+    /** Credentials for the organization the definition is read from. */
+    source: AgentPromotionTransport;
+    /** Credentials for the organization the candidate is staged in. */
+    target: AgentPromotionTransport;
+    /** Agent name, the ensure identity in both organizations. */
+    name: string;
+    /** Preview pointer to stage the candidate at. Never `live`: prepare never deploys. */
+    alias: string;
+    /** Source-control commit recorded on the manifest and the receipt. */
+    commit?: string;
+    /** Provenance stamped on the version row the target converge appends. */
+    version?: components['schemas']['EnsureVersionMetadata'];
+}
+/**
+ * Pull the definition from the source organization and stage it in the target
+ * at a preview pointer. Live is untouched, credentials never move, and secrets
+ * stay `{{secret:NAME}}` references resolved by the target organization.
+ */
+declare function prepareAgentPromotion(input: PrepareAgentPromotionInput): Promise<AgentPromotionManifest>;
+interface ValidateAgentPromotionInput {
+    target: AgentPromotionTransport;
+    manifest: AgentPromotionManifest;
+    /** The definition to re-plan against. Re-pulled from the source when omitted. */
+    definition?: AgentDefinition;
+    source?: AgentPromotionTransport;
+}
+/**
+ * Re-run the staged converge as a dry run in the target and report every named
+ * reference the destination could not resolve. Reporting only: it decides
+ * nothing, and no later step is gated on the answer.
+ */
+declare function validateAgentPromotion(input: ValidateAgentPromotionInput): Promise<AgentPromotionValidation>;
+interface ActivateAgentPromotionInput {
+    target: AgentPromotionTransport;
+    manifest: AgentPromotionManifest;
+    /** Pointer to deploy to in the target organization. Defaults to `live`. */
+    alias?: string;
+    reason?: string;
+    /** Defaults to a key derived from the manifest, so a retry never deploys twice. */
+    idempotencyKey?: string;
+}
+/**
+ * Deploy the exact staged version at the target's pointer, quoting the pointer
+ * revision as `If-Match` and linking the source ids and hashes on the receipt.
+ * The version id comes from the manifest, never from re-resolving a pointer.
+ */
+declare function activateAgentPromotion(input: ActivateAgentPromotionInput): Promise<AgentAliasActivation>;
+/** A replay key one manifest always derives the same way, so retries are safe. */
+declare function promotionIdempotencyKey(manifest: AgentPromotionManifest, alias: string): string;
+interface PromoteAgentInput extends PrepareAgentPromotionInput {
+    /**
+     * Deploy the staged candidate after validation. Omit to stop at the staged
+     * preview: nothing here gates on evaluation, so an explicit opt-in is what
+     * separates staging from shipping.
+     */
+    activate?: {
+        alias?: string;
+        reason?: string;
+        idempotencyKey?: string;
+    };
+}
+interface PromoteAgentResult {
+    manifest: AgentPromotionManifest;
+    validation: AgentPromotionValidation;
+    activation?: AgentAliasActivation;
+}
+/**
+ * The whole cross-organization recipe: stage the definition at a preview
+ * pointer in the target, report unresolved references, and — only when
+ * `activate` is supplied — deploy that exact staged version. Evaluation is the
+ * caller's to run and report; nothing here is gated on it.
+ */
+declare function promoteAgent(input: PromoteAgentInput): Promise<PromoteAgentResult>;
+
 /**
  * Agent API key request types.
  *
@@ -56440,9 +57772,9 @@ interface ApiClient {
         [key: string]: any;
     }): Promise<T>;
     post<T>(path: string, data?: any, headers?: Record<string, string>): Promise<T>;
-    put<T>(path: string, data?: any): Promise<T>;
+    put<T>(path: string, data?: any, headers?: Record<string, string>): Promise<T>;
     patch<T>(path: string, data?: any): Promise<T>;
-    delete<T>(path: string, data?: any): Promise<T>;
+    delete<T>(path: string, data?: any, headers?: Record<string, string>): Promise<T>;
     postFormData<T>(path: string, formData: FormData): Promise<T>;
     postBinary<T>(path: string, body: Uint8Array, contentType: string): Promise<T>;
     requestStream(path: string, options?: RequestInit): Promise<Response>;
@@ -57023,9 +58355,9 @@ declare class DispatchEndpoint {
     /**
      * Dispatch: create and/or execute flows on records atomically
      */
-    execute(data: DispatchRequest): Promise<any>;
+    execute(data: DispatchRequest, admission?: AgentAdmissionOptions): Promise<any>;
     /** Start a dispatch and return its durable execution handle immediately. */
-    executeAsync(data: DispatchRequest): Promise<AsyncExecutionHandle>;
+    executeAsync(data: DispatchRequest, admission?: AgentAdmissionOptions): Promise<AsyncExecutionHandle>;
     /**
      * Dispatch with streaming response
      *
@@ -57036,7 +58368,7 @@ declare class DispatchEndpoint {
      */
     executeStream(data: DispatchRequest, init?: {
         signal?: AbortSignal;
-    } & DetachedReconnectOptions): Promise<Response>;
+    } & DetachedReconnectOptions & AgentAdmissionOptions): Promise<Response>;
     /**
      * The `?after=` reattach leg a detached dispatch stream is followed with.
      *
@@ -57102,6 +58434,7 @@ declare class ExecutionsEndpoint {
     private client;
     constructor(client: ApiClient);
     getStatus(executionId: string): Promise<AsyncExecutionStatus>;
+    getDelivery(executionId: string, deliveryId: string): Promise<InputDeliveryReceipt>;
 }
 /**
  * Chat endpoint handler
@@ -58146,11 +59479,24 @@ interface AgentExecuteRequest {
         forced?: 'durable' | 'in_process';
         watchLeaseMs?: number;
     };
+    /**
+     * Run whichever immutable version this release alias currently points at
+     * (ADR 0025). At most one of `alias` / `versionId`, and neither may be
+     * combined with an inline definition override (`model`, `systemPrompt`,
+     * `tools`, …) — the selected version supplies the definition.
+     */
+    alias?: string;
+    /** Run this exact version snapshot. Mutually exclusive with `alias`. */
+    versionId?: string;
 }
 /**
  * Agent execute response (non-streaming)
  */
 interface AgentExecuteResponse {
+    executionId?: string;
+    deliveryId?: string;
+    deliveryStatus?: InputDeliveryReceipt['status'];
+    deliveryStatusUrl?: string;
     success: boolean;
     result: string;
     iterations: number;
@@ -58582,23 +59928,15 @@ interface Agent {
     createdAt: string;
     updatedAt: string;
 }
-/**
- * Durable-turn admission controls (ADR 0020), sent as request headers on
- * `POST /agents/{id}/execute`.
- *
- * The route declares all three, so they are in the published spec and in every
- * generated SDK; this bag is the hand-written namespace's equivalent. Each is
- * optional, and sending none of them leaves the wire behavior of the call
- * exactly as it was. They are read only by the durable lane: a turn that
- * resolves to the in-process lane ignores them.
- */
+/** Durable admission headers for agent execute and dispatch. Join requires native durable execution. */
 interface AgentAdmissionOptions {
     /**
      * What to do when the conversation already has a turn in flight. `reject`
      * (the default when omitted) answers `CONVERSATION_BUSY`; `supersede`
-     * cancels the incumbent and takes over; `queue` runs after it.
+     * cancels the incumbent and takes over; `queue` runs after it; `join` delivers
+     * new user-message deltas to the incumbent at a safe boundary, without resetting its budgets.
      */
-    concurrency?: 'reject' | 'supersede' | 'queue';
+    concurrency?: 'reject' | 'supersede' | 'queue' | 'join';
     /**
      * Fold this request into an already-pending turn for the same conversation
      * instead of starting a second one. The response is the pending execution.
@@ -58629,6 +59967,10 @@ declare class AgentsEndpoint {
     private static readonly AUTO_COMPACT_SUMMARY_PREFIX;
     private static readonly RESUMED_COMPACT_SUMMARY_PREFIX;
     private static readonly COMPLETED_COMPACT_SUMMARY_PREFIX;
+    /** Release aliases: the named pointers selecting which version runs (ADR 0025). */
+    readonly aliases: AgentAliasesNamespace;
+    /** The append-only deployment history behind those pointers. */
+    readonly deployments: AgentDeploymentsNamespace;
     constructor(client: ApiClient);
     /**
      * List all agents for the authenticated user
@@ -59483,7 +60825,7 @@ declare class RuntypeClient implements ApiClient {
     /**
      * Generic PUT request
      */
-    put<T>(path: string, data?: unknown): Promise<T>;
+    put<T>(path: string, data?: unknown, extraHeaders?: Record<string, string>): Promise<T>;
     /**
      * Generic PATCH request
      */
@@ -59491,7 +60833,7 @@ declare class RuntypeClient implements ApiClient {
     /**
      * Generic DELETE request
      */
-    delete<T>(path: string, data?: unknown): Promise<T>;
+    delete<T>(path: string, data?: unknown, extraHeaders?: Record<string, string>): Promise<T>;
     /**
      * Build full URL with query parameters
      */
@@ -60886,4 +62228,4 @@ declare function getLikelySupportingCandidatePaths(bestCandidatePath: string | u
 declare function getDefaultPlanPath(taskName: string): string;
 declare function sanitizeTaskSlug(taskName: string): string;
 
-export { type AIGrader, type Agent, type AgentAdmissionOptions, type AgentApprovalCompleteEvent, type AgentApprovalStartEvent, type AgentCompleteEvent, type AgentDefinition, type AgentDefinitionConfig, 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, type AgentPullResult, type AgentReflectionEvent, 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 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, 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, 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 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 Integration, type IntegrationTool, IntegrationsEndpoint, type IntegrationsListResponse, type JSONSchema, type JsonArray, type JsonObject, type JsonPrimitive, type JsonValue, LEDGER_ARTIFACT_LINE_PREFIX, 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 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 PaginationResponse, type PersistedGraderOutcome, type ProductDefinition, ProductDriftError, ProductEnsureConflictError, type ProductPullResult, type ProductionHealthQuery, type ProductionHealthResponse, ProductsNamespace, 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 RunEvalCaseResult, type RunEvalInput, type RunEvalResult, 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, 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 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 UpdatedFlow, type UpsertFlowConfig$1 as UpsertFlowConfig, type UpsertOptions, type UpsertRecordStepConfig$1 as UpsertRecordStepConfig, type UserProfile, UsersEndpoint, 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, 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, processStream, pullEval, pullFpo, ranStep, regex, registerWorkflowHook, resolveStallStopAfter, resolveWorkflowHook, runEvalSuite, sanitizeTaskSlug, shouldInjectEmptySessionNudge, shouldRequestModelEscalation, stepOrder, streamEvents, toolOrder, unregisterWorkflowHook, usedNoTools, validJson, 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 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 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 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, 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 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 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 };