@runtypelabs/sdk 4.9.0 → 4.11.0

package/dist/index.d.ts

@@ -908,6 +908,7 @@ interface paths {
                             config: {
                                 [key: string]: unknown;
                             } | null;
+                            configHash: string | null;
                             createdAt: string;
                             dashboardUrl?: string;
                             description: string | null;
@@ -919,6 +920,7 @@ interface paths {
                             icon: string | null;
                             id: string;
                             lastHealthCheckAt: string | null;
+                            lastModifiedSource: string | null;
                             name: string;
                             organizationId: string | null;
                             primaryFlowId: string | null;
@@ -991,6 +993,268 @@ interface paths {
         patch?: never;
         trace?: never;
     };
+    "/v1/agents/ensure": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        get?: never;
+        put?: never;
+        /**
+         * Ensure agent (config-as-code converge)
+         * @description Idempotently converge a repo-defined agent definition onto the platform. Identity is name + account scope. Hash-only probes skip the payload in the steady state (a miss is a normal 200 `definitionRequired` response, not an error); full requests create the agent or append a new version when the canonical content hash differs. Non-executing: never touches the execution pipeline. The response always carries the server-computed canonical hash. Set dryRun to plan without writing (CI drift gate), onConflict: "overwrite" to converge over dashboard/API edits, and release: "publish" to also re-aim the published-version pointer.
+         */
+        post: {
+            parameters: {
+                query?: never;
+                header?: never;
+                path?: never;
+                cookie?: never;
+            };
+            requestBody?: {
+                content: {
+                    "application/json": {
+                        contentHash?: string;
+                        definition?: {
+                            config?: {
+                                advisor?: {
+                                    model: string;
+                                    systemPrompt?: string;
+                                } | null;
+                                artifacts?: {
+                                    /** @enum {boolean} */
+                                    enabled: true;
+                                    types: ("markdown" | "component")[];
+                                };
+                                errorHandling?: {
+                                    fallbacks?: ({
+                                        delay?: number;
+                                        /** @enum {string} */
+                                        type: "retry";
+                                    } | {
+                                        delay?: number;
+                                        maxTokens?: number;
+                                        model: string;
+                                        temperature?: number;
+                                        /** @enum {string} */
+                                        type: "model";
+                                    } | {
+                                        delay?: number;
+                                        message: string;
+                                        /** @enum {string} */
+                                        type: "message";
+                                    })[];
+                                    /** @enum {string} */
+                                    onError: "fail" | "continue" | "fallback";
+                                    triggers?: {
+                                        /** @enum {string} */
+                                        type: "error" | "empty-output";
+                                    }[];
+                                };
+                                frequencyPenalty?: number;
+                                /** @enum {string} */
+                                loggingPolicy?: "default" | "on" | "off";
+                                loopConfig?: {
+                                    enableReflection?: boolean;
+                                    maxCost?: number;
+                                    maxTurns?: number;
+                                    reflectionInterval?: number;
+                                };
+                                memory?: {
+                                    enabled: boolean;
+                                    injectSummary?: boolean;
+                                    profileTemplate?: string;
+                                };
+                                model?: string;
+                                presencePenalty?: number;
+                                reasoning?: boolean | {
+                                    budgetTokens?: number;
+                                    enabled: boolean;
+                                    includeThoughts?: boolean;
+                                    /** @enum {string} */
+                                    reasoningEffort?: "minimal" | "low" | "medium" | "high" | "xhigh";
+                                    /** @enum {string} */
+                                    reasoningSummary?: "auto" | "detailed";
+                                    thinkingBudget?: number;
+                                };
+                                seed?: number;
+                                systemPrompt?: string;
+                                temperature?: number;
+                                temporal?: {
+                                    elapsedThresholdSeconds?: number;
+                                    groundNow?: boolean;
+                                    injectElapsed?: boolean;
+                                    timezone?: string;
+                                };
+                                tools?: {
+                                    approval?: {
+                                        requestReason?: boolean;
+                                        require: string[] | boolean;
+                                        timeout?: number;
+                                    };
+                                    codeModeConfig?: {
+                                        description?: string;
+                                        timeoutMs?: number;
+                                        toolPool: string[];
+                                    };
+                                    maxToolCalls?: number;
+                                    mcpServers?: {
+                                        allowedTools?: string[];
+                                        auth?: {
+                                            headerName?: string;
+                                            password?: string;
+                                            token?: string;
+                                            /** @enum {string} */
+                                            type: "api_key" | "bearer" | "basic" | "custom_header" | "none";
+                                            username?: string;
+                                        };
+                                        enabled?: boolean;
+                                        id: string;
+                                        name?: string;
+                                        timeout?: number;
+                                        /** @enum {string} */
+                                        transport?: "streamable_http" | "rest";
+                                        url: string;
+                                    }[];
+                                    perToolLimits?: {
+                                        [key: string]: {
+                                            maxCalls?: number;
+                                            required?: boolean;
+                                        };
+                                    };
+                                    runtimeTools?: {
+                                        config: {
+                                            [key: string]: unknown;
+                                        };
+                                        description: string;
+                                        name: string;
+                                        parametersSchema: {
+                                            [key: string]: unknown;
+                                        };
+                                        /** @enum {string} */
+                                        toolType: "flow" | "custom" | "external" | "local" | "advisor" | "subagent" | "search";
+                                    }[];
+                                    subagentConfig?: {
+                                        allowNesting?: boolean;
+                                        defaultMaxTurns?: number;
+                                        defaultModel?: string;
+                                        defaultTimeoutMs?: number;
+                                        maxSpawnsPerRun?: number;
+                                        maxTurnsLimit?: number;
+                                        toolPool: string[];
+                                    };
+                                    /** @enum {string} */
+                                    toolCallStrategy?: "auto" | "required" | "none";
+                                    toolConfigs?: {
+                                        [key: string]: {
+                                            [key: string]: unknown;
+                                        };
+                                    };
+                                    toolIds?: string[];
+                                };
+                                topK?: number;
+                                topP?: number;
+                                voice?: {
+                                    elevenLabs?: {
+                                        modelId?: string;
+                                        similarity?: number;
+                                        stability?: number;
+                                        voiceId?: string;
+                                    };
+                                    enabled?: boolean;
+                                    /** @enum {string} */
+                                    interruptionMode?: "none" | "cancel" | "barge-in";
+                                    provider?: string;
+                                };
+                            };
+                            description?: string;
+                            icon?: string;
+                            name: string;
+                        };
+                        dryRun?: boolean;
+                        expectedRemoteHash?: string;
+                        name: string;
+                        /** @enum {string} */
+                        onConflict?: "error" | "overwrite";
+                        /** @enum {string} */
+                        release?: "none" | "publish";
+                    };
+                };
+            };
+            responses: {
+                /** @description Converge result: unchanged | created | updated | definitionRequired (hash miss — retry with the full definition) | plan (dryRun) */
+                200: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["AgentEnsureResponse"];
+                    };
+                };
+                /** @description Validation error (or unsupported agent type for ensure) */
+                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 Conflict: external_modification (last write was not ensure; pass onConflict: "overwrite") or remote_changed (expectedRemoteHash guard) */
+                409: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["AgentEnsureConflict"];
+                    };
+                };
+                /** @description Submitted contentHash does not match the server-recomputed canonical hash */
+                422: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["AgentEnsureHashMismatch"];
+                    };
+                };
+                /** @description Internal server error */
+                500: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["Error"];
+                    };
+                };
+            };
+        };
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
     "/v1/agents/fetch-agent-card": {
         parameters: {
             query?: never;
@@ -1124,6 +1388,92 @@ interface paths {
         patch?: never;
         trace?: never;
     };
+    "/v1/agents/pull": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /**
+         * Pull agent definition (config-as-code)
+         * @description Return the canonical config-as-code definition and provenance for an agent by name — the absorb-drift direction of the ensure protocol. The contentHash is recomputed from the live agent state, so it is accurate even immediately after a dashboard edit.
+         */
+        get: {
+            parameters: {
+                query: {
+                    name: string;
+                };
+                header?: never;
+                path?: never;
+                cookie?: never;
+            };
+            requestBody?: never;
+            responses: {
+                /** @description Canonical definition + provenance */
+                200: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["AgentPullResponse"];
+                    };
+                };
+                /** @description Invalid parameters or unsupported agent type */
+                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 No agent with that name in the account scope */
+                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"];
+                    };
+                };
+            };
+        };
+        put?: never;
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
     "/v1/agents/{id}": {
         parameters: {
             query?: never;
@@ -1173,6 +1523,7 @@ interface paths {
                             config: {
                                 [key: string]: unknown;
                             } | null;
+                            configHash: string | null;
                             createdAt: string;
                             dashboardUrl?: string;
                             description: string | null;
@@ -1183,6 +1534,7 @@ interface paths {
                             icon: string | null;
                             id: string;
                             lastHealthCheckAt: string | null;
+                            lastModifiedSource: string | null;
                             name: string;
                             organizationId: string | null;
                             primaryFlow: {
@@ -1551,6 +1903,7 @@ interface paths {
                             config: {
                                 [key: string]: unknown;
                             } | null;
+                            configHash: string | null;
                             createdAt: string;
                             dashboardUrl?: string;
                             description: string | null;
@@ -1562,6 +1915,7 @@ interface paths {
                             icon: string | null;
                             id: string;
                             lastHealthCheckAt: string | null;
+                            lastModifiedSource: string | null;
                             name: string;
                             organizationId: string | null;
                             primaryFlowId: string | null;
@@ -3938,9 +4292,19 @@ interface paths {
                 };
                 cookie?: never;
             };
-            /** @description The app bundle as a zip archive. */
+            /** @description The app bundle: either a raw zip archive (application/zip) or JSON file maps (application/json) that the API zips server-side. */
             requestBody: {
                 content: {
+                    "application/json": {
+                        /** @description Text files for the bundle, path (relative to bundle root) to content. */
+                        files: {
+                            [key: string]: string;
+                        };
+                        /** @description Binary files for the bundle, path to base64-encoded content. */
+                        filesBase64?: {
+                            [key: string]: string;
+                        };
+                    };
                     "application/zip": string;
                 };
             };
@@ -5082,6 +5446,7 @@ interface paths {
                                 maxMessagesPerSession: number | null;
                                 name: string | null;
                                 pinToVersion: string | null;
+                                productSurfaceId?: string | null;
                                 rateLimitPerHour: number | null;
                                 rateLimitPerMinute: number | null;
                                 sessionIdleTimeoutMinutes: number | null;
@@ -5193,6 +5558,7 @@ interface paths {
                                 maxMessagesPerSession: number | null;
                                 name: string | null;
                                 pinToVersion: string | null;
+                                productSurfaceId?: string | null;
                                 rateLimitPerHour: number | null;
                                 rateLimitPerMinute: number | null;
                                 sessionIdleTimeoutMinutes: number | null;
@@ -5309,6 +5675,7 @@ interface paths {
                                 maxMessagesPerSession: number | null;
                                 name: string | null;
                                 pinToVersion: string | null;
+                                productSurfaceId?: string | null;
                                 rateLimitPerHour: number | null;
                                 rateLimitPerMinute: number | null;
                                 sessionIdleTimeoutMinutes: number | null;
@@ -5426,6 +5793,7 @@ interface paths {
                                 maxMessagesPerSession: number | null;
                                 name: string | null;
                                 pinToVersion: string | null;
+                                productSurfaceId?: string | null;
                                 rateLimitPerHour: number | null;
                                 rateLimitPerMinute: number | null;
                                 sessionIdleTimeoutMinutes: number | null;
@@ -10155,82 +10523,276 @@ interface paths {
                 };
             };
         };
-        put?: never;
+        put?: never;
+        /**
+         * Create flow
+         * @description Create a new flow with step definitions.
+         */
+        post: {
+            parameters: {
+                query?: never;
+                header?: never;
+                path?: never;
+                cookie?: never;
+            };
+            requestBody?: {
+                content: {
+                    "application/json": {
+                        flowSteps?: {
+                            config?: unknown;
+                            /** @default true */
+                            enabled?: boolean;
+                            id?: string;
+                            name: string;
+                            order?: number;
+                            /** @enum {string} */
+                            type: "prompt" | "crawl" | "fetch-url" | "retrieve-record" | "fetch-github" | "api-call" | "transform-data" | "template" | "conditional" | "set-variable" | "upsert-record" | "send-email" | "send-text" | "send-event" | "send-stream" | "update-record" | "search" | "generate-embedding" | "vector-search" | "tool-call" | "wait-until" | "paginate-api" | "store-vector" | "execute-agent" | "store-asset" | "generate-pdf" | "save-memory" | "recall-memory" | "memory-summary";
+                            when?: string;
+                        }[];
+                        name: string;
+                        steps?: {
+                            config?: unknown;
+                            /** @default true */
+                            enabled?: boolean;
+                            id?: string;
+                            name: string;
+                            order?: number;
+                            /** @enum {string} */
+                            type: "prompt" | "crawl" | "fetch-url" | "retrieve-record" | "fetch-github" | "api-call" | "transform-data" | "template" | "conditional" | "set-variable" | "upsert-record" | "send-email" | "send-text" | "send-event" | "send-stream" | "update-record" | "search" | "generate-embedding" | "vector-search" | "tool-call" | "wait-until" | "paginate-api" | "store-vector" | "execute-agent" | "store-asset" | "generate-pdf" | "save-memory" | "recall-memory" | "memory-summary";
+                            when?: string;
+                        }[];
+                    };
+                };
+            };
+            responses: {
+                /** @description Created flow */
+                201: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": {
+                            createdAt: string;
+                            dashboardUrl?: string;
+                            flowSteps: {
+                                config?: {
+                                    [key: string]: unknown;
+                                };
+                                enabled?: boolean;
+                                id: string;
+                                name?: string;
+                                order?: number;
+                                type: string;
+                            }[];
+                            id: string;
+                            lastRunAt?: string | null;
+                            name: string;
+                            organizationId: string | null;
+                            sampleMetadata?: {
+                                [key: string]: unknown;
+                            };
+                            stepCount?: number;
+                            updatedAt: string;
+                            userId: string;
+                        };
+                    };
+                };
+                /** @description Validation error */
+                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"];
+                    };
+                };
+            };
+        };
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/v1/flows/ensure": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        get?: never;
+        put?: never;
+        /**
+         * Ensure flow (config-as-code converge)
+         * @description Idempotently converge a repo-defined flow definition onto the platform. Identity is name + account scope. Hash-only probes skip the payload in the steady state (a miss is a normal 200 `definitionRequired` response, not an error); full requests create the flow or append a new version when the canonical content hash differs. Non-executing: never touches the execution pipeline — the deploy-time sibling of the dispatch-coupled `flowMode: "upsert"` (which saves and runs in one request). The response always carries the server-computed canonical hash. Set dryRun to plan without writing (CI drift gate), onConflict: "overwrite" to converge over dashboard/API edits, and release: "publish" to also re-aim the published-version pointer.
+         */
+        post: {
+            parameters: {
+                query?: never;
+                header?: never;
+                path?: never;
+                cookie?: never;
+            };
+            requestBody?: {
+                content: {
+                    "application/json": {
+                        contentHash?: string;
+                        definition?: {
+                            name: string;
+                            steps: {
+                                config?: {
+                                    [key: string]: unknown;
+                                };
+                                enabled?: boolean;
+                                name: string;
+                                order?: number;
+                                type: string;
+                                when?: string;
+                            }[];
+                        };
+                        dryRun?: boolean;
+                        expectedRemoteHash?: string;
+                        name: string;
+                        /** @enum {string} */
+                        onConflict?: "error" | "overwrite";
+                        /** @enum {string} */
+                        release?: "none" | "publish";
+                    };
+                };
+            };
+            responses: {
+                /** @description Converge result: unchanged | created | updated | definitionRequired (hash miss — retry with the full definition) | plan (dryRun) */
+                200: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["FlowEnsureResponse"];
+                    };
+                };
+                /** @description Validation error */
+                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 Conflict: external_modification (last write was not ensure; pass onConflict: "overwrite") or remote_changed (expectedRemoteHash guard) */
+                409: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["FlowEnsureConflict"];
+                    };
+                };
+                /** @description Submitted contentHash does not match the server-recomputed canonical hash */
+                422: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["FlowEnsureHashMismatch"];
+                    };
+                };
+                /** @description Internal server error */
+                500: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["Error"];
+                    };
+                };
+            };
+        };
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/v1/flows/pull": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
         /**
-         * Create flow
-         * @description Create a new flow with step definitions.
+         * Pull flow definition (config-as-code)
+         * @description Return the canonical config-as-code definition and provenance for a flow by name — the absorb-drift direction of the ensure protocol. The contentHash is recomputed from the live flow state, so it is accurate even immediately after a dashboard edit.
          */
-        post: {
+        get: {
             parameters: {
-                query?: never;
+                query: {
+                    name: string;
+                };
                 header?: never;
                 path?: never;
                 cookie?: never;
             };
-            requestBody?: {
-                content: {
-                    "application/json": {
-                        flowSteps?: {
-                            config?: unknown;
-                            /** @default true */
-                            enabled?: boolean;
-                            id?: string;
-                            name: string;
-                            order?: number;
-                            /** @enum {string} */
-                            type: "prompt" | "crawl" | "fetch-url" | "retrieve-record" | "fetch-github" | "api-call" | "transform-data" | "template" | "conditional" | "set-variable" | "upsert-record" | "send-email" | "send-text" | "send-event" | "send-stream" | "update-record" | "search" | "generate-embedding" | "vector-search" | "tool-call" | "wait-until" | "paginate-api" | "store-vector" | "execute-agent" | "store-asset" | "generate-pdf" | "save-memory" | "recall-memory" | "memory-summary";
-                            when?: string;
-                        }[];
-                        name: string;
-                        steps?: {
-                            config?: unknown;
-                            /** @default true */
-                            enabled?: boolean;
-                            id?: string;
-                            name: string;
-                            order?: number;
-                            /** @enum {string} */
-                            type: "prompt" | "crawl" | "fetch-url" | "retrieve-record" | "fetch-github" | "api-call" | "transform-data" | "template" | "conditional" | "set-variable" | "upsert-record" | "send-email" | "send-text" | "send-event" | "send-stream" | "update-record" | "search" | "generate-embedding" | "vector-search" | "tool-call" | "wait-until" | "paginate-api" | "store-vector" | "execute-agent" | "store-asset" | "generate-pdf" | "save-memory" | "recall-memory" | "memory-summary";
-                            when?: string;
-                        }[];
-                    };
-                };
-            };
+            requestBody?: never;
             responses: {
-                /** @description Created flow */
-                201: {
+                /** @description Canonical definition + provenance */
+                200: {
                     headers: {
                         [name: string]: unknown;
                     };
                     content: {
-                        "application/json": {
-                            createdAt: string;
-                            dashboardUrl?: string;
-                            flowSteps: {
-                                config?: {
-                                    [key: string]: unknown;
-                                };
-                                enabled?: boolean;
-                                id: string;
-                                name?: string;
-                                order?: number;
-                                type: string;
-                            }[];
-                            id: string;
-                            lastRunAt?: string | null;
-                            name: string;
-                            organizationId: string | null;
-                            sampleMetadata?: {
-                                [key: string]: unknown;
-                            };
-                            stepCount?: number;
-                            updatedAt: string;
-                            userId: string;
-                        };
+                        "application/json": components["schemas"]["FlowPullResponse"];
                     };
                 };
-                /** @description Validation error */
-                400: {
+                /** @description Unauthorized */
+                401: {
                     headers: {
                         [name: string]: unknown;
                     };
@@ -10238,8 +10800,8 @@ interface paths {
                         "application/json": components["schemas"]["Error"];
                     };
                 };
-                /** @description Unauthorized */
-                401: {
+                /** @description Insufficient permissions */
+                403: {
                     headers: {
                         [name: string]: unknown;
                     };
@@ -10247,8 +10809,8 @@ interface paths {
                         "application/json": components["schemas"]["Error"];
                     };
                 };
-                /** @description Insufficient permissions */
-                403: {
+                /** @description No flow with that name in the account scope */
+                404: {
                     headers: {
                         [name: string]: unknown;
                     };
@@ -10267,6 +10829,8 @@ interface paths {
                 };
             };
         };
+        put?: never;
+        post?: never;
         delete?: never;
         options?: never;
         head?: never;
@@ -17730,6 +18294,12 @@ interface paths {
                                     supported: boolean;
                                     supportsReasoningSummary?: boolean;
                                 };
+                                /** @description True when any provider entry supports extended reasoning */
+                                supportsReasoning?: boolean;
+                                /** @description True when any provider entry supports tool/function calling */
+                                supportsToolUse?: boolean;
+                                /** @description True when any provider entry supports image input */
+                                supportsVision?: boolean;
                                 tags: string[];
                                 uiCategory?: string;
                                 uiPriority?: number;
@@ -20613,7 +21183,7 @@ interface paths {
                         /** @enum {string} */
                         status?: "draft" | "active" | "paused";
                         /** @enum {string} */
-                        type: "chat" | "mcp" | "mcp_code" | "api" | "webhook" | "schedule" | "a2a" | "email" | "slack" | "sms" | "imessage" | "discord" | "whatsapp" | "telegram" | "hosted-page";
+                        type: "chat" | "mcp" | "mcp_code" | "api" | "webhook" | "schedule" | "a2a" | "email" | "slack" | "sms" | "imessage" | "discord" | "whatsapp" | "telegram" | "hosted-page" | "chrome_extension";
                     };
                 };
             };
@@ -30106,9 +30676,7 @@ interface paths {
                     };
                     content: {
                         "application/json": {
-                            data: {
-                                [key: string]: unknown;
-                            }[];
+                            data: components["schemas"]["EnrichedSkillProposal"][];
                         };
                     };
                 };
@@ -30171,7 +30739,7 @@ interface paths {
                     };
                     content: {
                         "application/json": {
-                            [key: string]: unknown;
+                            proposal: components["schemas"]["SkillProposal"];
                         };
                     };
                 };
@@ -30244,7 +30812,7 @@ interface paths {
                     };
                     content: {
                         "application/json": {
-                            [key: string]: unknown;
+                            proposal: components["schemas"]["SkillProposal"];
                         };
                     };
                 };
@@ -30283,12 +30851,16 @@ interface paths {
         };
         /**
          * List skills
-         * @description List skills for the authenticated owner, optionally filtered by status.
+         * @description List skills for the authenticated owner with cursor pagination, optionally filtered by status. Ordered newest-first (id descending).
          */
         get: {
             parameters: {
                 query?: {
                     status?: "draft" | "active" | "archived";
+                    limit?: string;
+                    cursor?: string;
+                    direction?: string;
+                    includeCount?: string;
                 };
                 header?: never;
                 path?: never;
@@ -30296,7 +30868,7 @@ interface paths {
             };
             requestBody?: never;
             responses: {
-                /** @description Skills */
+                /** @description Paginated list of skills */
                 200: {
                     headers: {
                         [name: string]: unknown;
@@ -30306,9 +30878,19 @@ interface paths {
                             data: {
                                 [key: string]: unknown;
                             }[];
+                            pagination: components["schemas"]["Pagination"];
                         };
                     };
                 };
+                /** @description Invalid parameters */
+                400: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["Error"];
+                    };
+                };
                 /** @description Unauthorized */
                 401: {
                     headers: {
@@ -33006,6 +33588,7 @@ interface paths {
                             features: {
                                 dashboardAssistantModel: string;
                                 enableAgentSkills: boolean;
+                                enableChromeSurface: boolean;
                                 enableDashboardAssistant: boolean;
                                 productGeneratorModel: string;
                             };
@@ -33464,6 +34047,205 @@ interface components {
                 timestamp?: string;
             };
         };
+        AgentEnsureConflict: {
+            /** @enum {string} */
+            code: "external_modification" | "remote_changed";
+            currentHash?: string | null;
+            error: string;
+            lastModifiedSource?: string;
+            modifiedAt?: string | null;
+        };
+        AgentEnsureHashMismatch: {
+            /** @enum {string} */
+            code: "content_hash_mismatch";
+            /** @description The server-computed canonical hash of the submitted definition. */
+            contentHash: string;
+            error: string;
+        };
+        AgentEnsureResponse: {
+            agentId: string;
+            /** @description Server-computed canonical content hash. Clients should echo this hash in probes. */
+            contentHash: string;
+            /** @enum {string} */
+            result: "unchanged" | "created" | "updated";
+            /** @description The version snapshot backing this state (null if snapshotting failed). */
+            versionId: string | null;
+        } | {
+            /** @enum {string} */
+            result: "definitionRequired";
+        } | {
+            agentId?: string;
+            changedKeys: string[];
+            /** @enum {string} */
+            changes: "none" | "create" | "update";
+            contentHash: string;
+            remoteHash?: string;
+            /** @enum {string} */
+            result: "plan";
+        };
+        AgentPullResponse: {
+            agentId: string;
+            contentHash: string;
+            definition: {
+                config?: {
+                    advisor?: {
+                        model: string;
+                        systemPrompt?: string;
+                    } | null;
+                    artifacts?: {
+                        /** @enum {boolean} */
+                        enabled: true;
+                        types: ("markdown" | "component")[];
+                    };
+                    errorHandling?: {
+                        fallbacks?: ({
+                            delay?: number;
+                            /** @enum {string} */
+                            type: "retry";
+                        } | {
+                            delay?: number;
+                            maxTokens?: number;
+                            model: string;
+                            temperature?: number;
+                            /** @enum {string} */
+                            type: "model";
+                        } | {
+                            delay?: number;
+                            message: string;
+                            /** @enum {string} */
+                            type: "message";
+                        })[];
+                        /** @enum {string} */
+                        onError: "fail" | "continue" | "fallback";
+                        triggers?: {
+                            /** @enum {string} */
+                            type: "error" | "empty-output";
+                        }[];
+                    };
+                    frequencyPenalty?: number;
+                    /** @enum {string} */
+                    loggingPolicy?: "default" | "on" | "off";
+                    loopConfig?: {
+                        enableReflection?: boolean;
+                        maxCost?: number;
+                        maxTurns?: number;
+                        reflectionInterval?: number;
+                    };
+                    memory?: {
+                        enabled: boolean;
+                        injectSummary?: boolean;
+                        profileTemplate?: string;
+                    };
+                    model?: string;
+                    presencePenalty?: number;
+                    reasoning?: boolean | {
+                        budgetTokens?: number;
+                        enabled: boolean;
+                        includeThoughts?: boolean;
+                        /** @enum {string} */
+                        reasoningEffort?: "minimal" | "low" | "medium" | "high" | "xhigh";
+                        /** @enum {string} */
+                        reasoningSummary?: "auto" | "detailed";
+                        thinkingBudget?: number;
+                    };
+                    seed?: number;
+                    systemPrompt?: string;
+                    temperature?: number;
+                    temporal?: {
+                        elapsedThresholdSeconds?: number;
+                        groundNow?: boolean;
+                        injectElapsed?: boolean;
+                        timezone?: string;
+                    };
+                    tools?: {
+                        approval?: {
+                            requestReason?: boolean;
+                            require: string[] | boolean;
+                            timeout?: number;
+                        };
+                        codeModeConfig?: {
+                            description?: string;
+                            timeoutMs?: number;
+                            toolPool: string[];
+                        };
+                        maxToolCalls?: number;
+                        mcpServers?: {
+                            allowedTools?: string[];
+                            auth?: {
+                                headerName?: string;
+                                password?: string;
+                                token?: string;
+                                /** @enum {string} */
+                                type: "api_key" | "bearer" | "basic" | "custom_header" | "none";
+                                username?: string;
+                            };
+                            enabled?: boolean;
+                            id: string;
+                            name?: string;
+                            timeout?: number;
+                            /** @enum {string} */
+                            transport?: "streamable_http" | "rest";
+                            url: string;
+                        }[];
+                        perToolLimits?: {
+                            [key: string]: {
+                                maxCalls?: number;
+                                required?: boolean;
+                            };
+                        };
+                        runtimeTools?: {
+                            config: {
+                                [key: string]: unknown;
+                            };
+                            description: string;
+                            name: string;
+                            parametersSchema: {
+                                [key: string]: unknown;
+                            };
+                            /** @enum {string} */
+                            toolType: "flow" | "custom" | "external" | "local" | "advisor" | "subagent" | "search";
+                        }[];
+                        subagentConfig?: {
+                            allowNesting?: boolean;
+                            defaultMaxTurns?: number;
+                            defaultModel?: string;
+                            defaultTimeoutMs?: number;
+                            maxSpawnsPerRun?: number;
+                            maxTurnsLimit?: number;
+                            toolPool: string[];
+                        };
+                        /** @enum {string} */
+                        toolCallStrategy?: "auto" | "required" | "none";
+                        toolConfigs?: {
+                            [key: string]: {
+                                [key: string]: unknown;
+                            };
+                        };
+                        toolIds?: string[];
+                    };
+                    topK?: number;
+                    topP?: number;
+                    voice?: {
+                        elevenLabs?: {
+                            modelId?: string;
+                            similarity?: number;
+                            stability?: number;
+                            voiceId?: string;
+                        };
+                        enabled?: boolean;
+                        /** @enum {string} */
+                        interruptionMode?: "none" | "cancel" | "barge-in";
+                        provider?: string;
+                    };
+                };
+                description?: string;
+                icon?: string;
+                name: string;
+            };
+            lastModifiedSource: string | null;
+            updatedAt: string | null;
+            versionId: string | null;
+        };
         AgentSSEEvent: {
             agentId: string;
             agentName: string;
@@ -34506,6 +35288,34 @@ interface components {
         } & {
             [key: string]: unknown;
         });
+        EnrichedSkillProposal: components["schemas"]["SkillProposal"] & {
+            proposingAgent: {
+                id: string;
+                name: string;
+            } | null;
+            resolvedCapabilityNames: {
+                [key: string]: string | null;
+            };
+            skill: {
+                description: string | null;
+                id: string;
+                name: string;
+                status: string;
+            } | null;
+            version: {
+                id: string;
+                manifest: {
+                    body: string;
+                    frontmatter: {
+                        [key: string]: unknown;
+                    };
+                    runtype: {
+                        [key: string]: unknown;
+                    };
+                };
+                versionNumber: number;
+            } | null;
+        };
         Error: {
             details?: {
                 /** @description Stable Runtype validation code (e.g. MISSING_REQUIRED_FIELD, INVALID_ENUM). */
@@ -34518,6 +35328,62 @@ interface components {
             }[];
             error: string;
         };
+        FlowEnsureConflict: {
+            /** @enum {string} */
+            code: "external_modification" | "remote_changed";
+            currentHash?: string | null;
+            error: string;
+            lastModifiedSource?: string;
+            modifiedAt?: string | null;
+        };
+        FlowEnsureHashMismatch: {
+            /** @enum {string} */
+            code: "content_hash_mismatch";
+            /** @description The server-computed canonical hash of the submitted definition. */
+            contentHash: string;
+            error: string;
+        };
+        FlowEnsureResponse: {
+            /** @description Server-computed canonical content hash. Clients should echo this hash in probes. */
+            contentHash: string;
+            flowId: string;
+            /** @enum {string} */
+            result: "unchanged" | "created" | "updated";
+            /** @description The version snapshot backing this state (null if snapshotting failed). */
+            versionId: string | null;
+        } | {
+            /** @enum {string} */
+            result: "definitionRequired";
+        } | {
+            changedKeys: string[];
+            /** @enum {string} */
+            changes: "none" | "create" | "update";
+            contentHash: string;
+            flowId?: string;
+            remoteHash?: string;
+            /** @enum {string} */
+            result: "plan";
+        };
+        FlowPullResponse: {
+            contentHash: string;
+            definition: {
+                name: string;
+                steps: {
+                    config?: {
+                        [key: string]: unknown;
+                    };
+                    enabled?: boolean;
+                    name: string;
+                    order?: number;
+                    type: string;
+                    when?: string;
+                }[];
+            };
+            flowId: string;
+            lastModifiedSource: string | null;
+            updatedAt: string | null;
+            versionId: string | null;
+        };
         FlowSSEEvent: {
             executionContext?: {
                 [key: string]: unknown;
@@ -34903,6 +35769,18 @@ interface components {
             op: "eq" | "neq" | "gt" | "gte" | "lt" | "lte" | "between" | "contains" | "startsWith" | "endsWith" | "in" | "notIn" | "isSet" | "isNotSet" | "isTrue" | "isFalse" | "withinLastDays" | "olderThanDays";
             value?: unknown;
         };
+        SkillProposal: {
+            createdAt: string;
+            id: string;
+            organizationId: string | null;
+            proposingAgentExecutionId: string | null;
+            proposingUserId: string;
+            rejectionReason: string | null;
+            reviewedAt: string | null;
+            reviewedBy: string | null;
+            skillVersionId: string;
+            status: string;
+        };
         UpdateUserProfileResponse: {
             email?: string;
             firstName?: string;
@@ -36232,6 +37110,9 @@ interface ModelConfig {
     supportsStreaming?: boolean;
     supportedResponseFormats?: string[];
     supportsSearch?: boolean;
+    supportsVision?: boolean;
+    supportsToolUse?: boolean;
+    supportsReasoning?: boolean;
     isEnabled: boolean;
     isDefault: boolean;
     settings: JsonObject;
@@ -37084,6 +37965,151 @@ interface BillingSpendAnalyticsParams {
     days?: number;
 }
 
+/**
+ * Flow config-as-code: `defineFlow`, `flows.ensure`, `flows.pull`.
+ *
+ * The non-executing sibling of `flows.upsert()` — `upsert` is the
+ * dispatch-coupled save-and-run motion (it saves the flow AND executes it in
+ * one request); `ensure` is the deploy-time convergence postcondition: "make
+ * the platform's definition of this flow match this object; no-op if it
+ * already does." Identity is name + account scope (the API key's org, else
+ * personal); environment is whichever API the client points at. `ensure`
+ * never deletes, and renaming a definition orphans the old flow and creates a
+ * new one.
+ *
+ * Wire protocol (POST /v1/flows/ensure — APQ-shaped, both APQ scars fixed):
+ *   1. Hash-only probe `{ name, contentHash }`. A match is
+ *      `{ result: 'unchanged' }`; a miss is a NORMAL 200
+ *      `{ result: 'definitionRequired' }`, never an error.
+ *   2. On a miss, retry with the full `definition`. The server recomputes the
+ *      canonical hash itself and returns it on every response — this SDK
+ *      echoes the server's hash (memoized per client instance) rather than
+ *      trusting its own serialization.
+ *
+ * The content hash is the SAME steps-only hash the flow upsert protocol uses
+ * (`computeFlowContentHash` — mirrored from
+ * `packages/shared/src/utils/flow-content-hash.ts`; this package is
+ * dependency-free by convention), so ensure and upsert interoperate on the
+ * same flow. The flow definition surface is `{ name, steps }` — description
+ * is not part of the v1 ensure surface (the shared hash covers steps only).
+ *
+ * See docs/adr/0003-agent-config-as-code-ensure.md for the design rationale.
+ */
+
+/** SHA-256 (hex) over the canonical normalized step list (steps only). */
+declare function computeFlowContentHash(steps: unknown[]): Promise<string>;
+/**
+ * A definition step. Deliberately has no `id` — step ids are server artifacts
+ * (minted on create, carried by name across converges), so definitions stay
+ * environment-portable. The step config is typed loosely per SDK convention;
+ * the server validates strictly through the canonical flow validator.
+ */
+interface FlowDefinitionStep {
+    type: string;
+    name: string;
+    order?: number;
+    enabled?: boolean;
+    when?: string;
+    config?: Record<string, unknown>;
+}
+/** `defineFlow` input: identity + the ordered step list. */
+interface DefineFlowInput {
+    name: string;
+    steps: FlowDefinitionStep[];
+}
+/** The canonical (wire) definition produced by `defineFlow`. */
+interface FlowDefinition {
+    name: string;
+    steps: Array<FlowDefinitionStep & {
+        order: number;
+    }>;
+}
+/**
+ * Pure-local declarative constructor for a flow definition. No I/O.
+ * Validates structure, rejects unknown fields, assigns explicit step order
+ * (1-based, matching the flow builder) when omitted, and rejects
+ * account-scoped `tool_…` references (definitions must be
+ * environment-portable: the same `defineFlow` converges staging and
+ * production). Deep per-step validation happens server-side at ensure time
+ * through the canonical flow validator.
+ *
+ * @example
+ * ```typescript
+ * const onboardingFlow = defineFlow({
+ *   name: 'Onboarding Digest',
+ *   steps: [
+ *     {
+ *       type: 'prompt',
+ *       name: 'Summarize signups',
+ *       config: { model: 'claude-sonnet-4-6', userPrompt: 'Summarize: {{signups}}' },
+ *     },
+ *   ],
+ * })
+ * ```
+ */
+declare function defineFlow(input: DefineFlowInput): FlowDefinition;
+interface EnsureFlowOptions {
+    /** Plan without writing (the CI drift gate). Sends the full definition. */
+    dryRun?: boolean;
+    /**
+     * What to do when the flow's last write came from the dashboard/API
+     * rather than ensure. Default 'error' (HTTP 409 → FlowEnsureConflictError).
+     */
+    onConflict?: 'error' | 'overwrite';
+    /** 'publish' also re-aims the published-version pointer. Default 'none'. */
+    release?: 'none' | 'publish';
+    /**
+     * 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).
+     */
+    expectedRemoteHash?: string;
+    /** Implies dryRun; throws FlowDriftError unless the plan is 'none'. */
+    expectNoChanges?: boolean;
+}
+interface EnsureFlowConverged {
+    result: 'unchanged' | 'created' | 'updated';
+    flowId: string;
+    versionId: string | null;
+    /** The server-computed canonical hash (echo this — never your own). */
+    contentHash: string;
+}
+interface EnsureFlowPlan {
+    result: 'plan';
+    changes: 'none' | 'create' | 'update';
+    changedKeys: string[];
+    contentHash: string;
+    remoteHash?: string;
+    flowId?: string;
+}
+type EnsureFlowResult = EnsureFlowConverged | EnsureFlowPlan;
+interface FlowPullResult {
+    flowId: string;
+    definition: FlowDefinition;
+    contentHash: string;
+    lastModifiedSource: string | null;
+    updatedAt: string | null;
+    versionId: string | null;
+}
+/** A 409 from the ensure protocol (external_modification or remote_changed). */
+declare class FlowEnsureConflictError extends Error {
+    readonly code: 'external_modification' | 'remote_changed';
+    readonly lastModifiedSource?: string;
+    readonly modifiedAt?: string | null;
+    readonly currentHash?: string | null;
+    constructor(body: {
+        error?: string;
+        code: 'external_modification' | 'remote_changed';
+        lastModifiedSource?: string;
+        modifiedAt?: string | null;
+        currentHash?: string | null;
+    });
+}
+/** Thrown by `ensure(def, { expectNoChanges: true })` when drift is detected. */
+declare class FlowDriftError extends Error {
+    readonly plan: EnsureFlowPlan;
+    constructor(plan: EnsureFlowPlan);
+}
+
 /**
  * FlowsNamespace - Static namespace for flow operations
  *
@@ -37145,8 +38171,11 @@ declare class FlowsNamespace {
     /**
      * Create or update a flow by name (upsert mode)
      *
-     * The recommended pattern for code-first flow management.
-     * Creates the flow if it doesn't exist, updates if steps changed.
+     * The recommended pattern for code-first flow management when you want to
+     * save AND run in one dispatch. For a deploy-time, non-executing converge
+     * (CI/CD config-as-code), use {@link ensure} instead — upsert and ensure
+     * are siblings, not versions of each other: upsert is the runtime verb
+     * (save-and-run), ensure is the deploy verb (converge only).
      *
      * @example
      * ```typescript
@@ -37159,6 +38188,29 @@ declare class FlowsNamespace {
      * ```
      */
     upsert(config: UpsertFlowConfig): RuntypeFlowBuilder;
+    /**
+     * Idempotently converge a `defineFlow` definition onto the platform —
+     * the deploy-time, non-executing sibling of {@link upsert}. Hash-first:
+     * the steady state is one tiny probe request. Creates an immutable version
+     * snapshot on every change; never deletes; never executes the flow.
+     *
+     * @example
+     * ```typescript
+     * const def = defineFlow({ name: 'Onboarding Digest', steps: [...] })
+     *
+     * // Converge (CI/deploy).
+     * const result = await Runtype.flows.ensure(def)
+     *
+     * // PR drift gate.
+     * await Runtype.flows.ensure(def, { expectNoChanges: true })
+     * ```
+     */
+    ensure(definition: FlowDefinition, options?: EnsureFlowOptions): Promise<EnsureFlowResult>;
+    /**
+     * Pull the canonical definition + provenance for a flow by name — the
+     * absorb-drift direction of the ensure protocol.
+     */
+    pull(name: string): Promise<FlowPullResult>;
     /**
      * Create a virtual flow (one-off, not saved)
      *
@@ -38158,6 +39210,58 @@ interface SkillProposal {
     reviewedAt: string | null;
     rejectionReason: string | null;
     createdAt: string;
+    /**
+     * Server-enrichment field: the skill this proposal targets. Present on the
+     * list endpoint (`proposals.list()`) so reviewers can see WHAT they are
+     * approving. `null` when the underlying skill row was deleted out from under
+     * the proposal; entirely **absent** on older API servers — consumers must
+     * tolerate it being `undefined`.
+     */
+    skill?: {
+        id: string;
+        name: string;
+        description: string | null;
+        status: string;
+    } | null;
+    /**
+     * Server-enrichment field: the proposed skill version's content. Present on
+     * the list endpoint so reviewers can read the manifest body (the instructions
+     * that would be injected into another agent's context) before approving.
+     * `null` when the underlying version row was deleted; entirely **absent** on
+     * older API servers — consumers must tolerate it being `undefined`.
+     */
+    version?: {
+        id: string;
+        versionNumber: number;
+        manifest: {
+            frontmatter: Record<string, unknown>;
+            /**
+             * The `runtype` extension block — capability bindings (flows, agents,
+             * tools, MCP servers, inline tools) + trustLevel. These bindings are the
+             * most security-relevant part of an approval decision, so the review queue
+             * surfaces them. Optional: older API servers omit it from this list view.
+             */
+            runtype?: SkillRuntypeExtensions;
+            body: string;
+        };
+    } | null;
+    /**
+     * Server-enrichment field: the agent that authored this proposal, resolved
+     * from the proposing execution. `null` when the execution/agent row is gone,
+     * the execution was a synthesized subagent, or the agent is outside the
+     * reviewer's tenant; entirely **absent** on older API servers.
+     */
+    proposingAgent?: {
+        id: string;
+        name: string;
+    } | null;
+    /**
+     * Server-enrichment field: tenant-scoped id → name map for every flow/agent/
+     * tool ID referenced in the manifest's capability block. A `null` name means
+     * the ID does not resolve inside the reviewer's account (a review signal —
+     * surfaced, not dropped); entirely **absent** on older API servers.
+     */
+    resolvedCapabilityNames?: Record<string, string | null>;
 }
 /**
  * Create/update a skill from a raw SKILL.md document. The frontmatter +
@@ -38195,6 +39299,37 @@ interface SkillWithVersion {
     skill: Skill;
     version: SkillVersion;
 }
+/** Query params accepted by the skills list endpoint. */
+interface SkillListParams {
+    /** Filter by lifecycle status. */
+    status?: SkillStatus;
+    /** Page size (1-200, server default 100). */
+    limit?: number;
+    /** Opaque cursor from a previous page's `pagination.nextCursor`/`prevCursor`. */
+    cursor?: string;
+    /** Pagination direction relative to the cursor (default `'next'`). */
+    direction?: 'next' | 'prev';
+    /** Include `totalCount`/`totalPages` in the pagination envelope (extra query). */
+    includeCount?: boolean;
+}
+/** The standard cursor-pagination envelope returned by list endpoints. */
+interface SkillListPagination {
+    nextCursor: string | null;
+    prevCursor: string | null;
+    hasMore: boolean;
+    hasPrev: boolean;
+    limit: number;
+    currentOffset: number;
+    totalPages?: number;
+    currentPage?: number;
+    totalCount?: number;
+}
+/** A page of skills with its pagination envelope. */
+interface SkillListPage {
+    data: Skill[];
+    /** Absent on older API servers that predate skills-list pagination. */
+    pagination?: SkillListPagination;
+}
 /**
  * The admin review queue for agent-authored skill proposals. This is the human
  * review surface for the deployed-agent data plane — listing, approving, and
@@ -38256,15 +39391,26 @@ declare class SkillsNamespace {
     create(input: SkillWriteInput): Promise<SkillWithVersion>;
     /**
      * List skills for the authenticated owner, optionally filtered by status.
+     * Returns just the rows (one page); pass `cursor`/`limit` to page, or use
+     * {@link listPage} when you need the pagination envelope.
      *
      * @example
      * ```typescript
      * const active = await Runtype.skills.list({ status: 'active' })
      * ```
      */
-    list(params?: {
-        status?: SkillStatus;
-    }): Promise<Skill[]>;
+    list(params?: SkillListParams): Promise<Skill[]>;
+    /**
+     * List skills with the cursor-pagination envelope (mirrors the tools list
+     * shape: `{ data, pagination }`).
+     *
+     * @example
+     * ```typescript
+     * const page1 = await Runtype.skills.listPage({ limit: 50, includeCount: true })
+     * const page2 = await Runtype.skills.listPage({ limit: 50, cursor: page1.pagination?.nextCursor ?? undefined })
+     * ```
+     */
+    listPage(params?: SkillListParams): Promise<SkillListPage>;
     /**
      * Get a skill and its full version history.
      *
@@ -38329,6 +39475,246 @@ declare class SkillsNamespace {
     listBindings(agentId: string): Promise<AgentSkillBinding[]>;
 }
 
+/**
+ * AgentsNamespace — agent config-as-code: `defineAgent`, `ensure`, `pull`.
+ *
+ * `ensure` is a convergence postcondition, not a save button: "make the
+ * platform's definition of this agent match this object; no-op if it already
+ * does." Identity is name + account scope (the API key's org, else personal);
+ * environment is whichever API the client points at. `ensure` never deletes,
+ * and renaming a definition orphans the old agent and creates a new one.
+ *
+ * Wire protocol (POST /v1/agents/ensure — APQ-shaped, both APQ scars fixed):
+ *   1. Hash-only probe `{ name, contentHash }`. A match is
+ *      `{ result: 'unchanged' }`; a miss is a NORMAL 200
+ *      `{ result: 'definitionRequired' }`, never an error.
+ *   2. On a miss, retry with the full `definition`. The server recomputes the
+ *      canonical hash itself and returns it on every response — this SDK
+ *      echoes the server's hash (memoized per client instance) rather than
+ *      trusting its own serialization.
+ *
+ * The content-hash implementation below is an INLINED COPY of
+ * `packages/shared/src/utils/agent-content-hash.ts` (this package is
+ * dependency-free by convention, mirroring the flow content hash in
+ * flows-namespace.ts). Parity is pinned by the shared fixture corpus in
+ * `packages/shared/test-fixtures/agent-content-hash/cases.json`, asserted by
+ * both packages' test suites. Change both copies (and regenerate the corpus)
+ * in the same PR.
+ *
+ * See docs/adr/0003-agent-config-as-code-ensure.md for the design rationale.
+ */
+
+/** Canonical normalized form — must stay byte-identical to the shared impl. */
+declare function normalizeAgentDefinition(definition: {
+    name: string;
+    description?: string | null;
+    icon?: string | null;
+    config?: Record<string, unknown> | null;
+}): {
+    name: string;
+    description?: string;
+    icon?: string;
+    config: Record<string, unknown>;
+};
+/** SHA-256 (hex) over the canonical normalized definition. */
+declare function computeAgentContentHash(definition: {
+    name: string;
+    description?: string | null;
+    icon?: string | null;
+    config?: Record<string, unknown> | null;
+}): Promise<string>;
+/**
+ * The runtime-config surface accepted in a definition (mirrors
+ * `agentRuntimeConfigSchema` in @runtypelabs/shared; deep leaves are typed
+ * loosely per SDK convention — the server validates strictly).
+ */
+interface AgentDefinitionConfig {
+    model?: string;
+    systemPrompt?: string;
+    temperature?: number;
+    topP?: number;
+    topK?: number;
+    frequencyPenalty?: number;
+    presencePenalty?: number;
+    seed?: number;
+    tools?: {
+        toolIds?: string[];
+        toolConfigs?: Record<string, Record<string, unknown>>;
+        runtimeTools?: Array<Record<string, unknown>>;
+        mcpServers?: Array<Record<string, unknown>>;
+        maxToolCalls?: number;
+        toolCallStrategy?: 'auto' | 'required' | 'none';
+        approval?: {
+            require: string[] | boolean;
+            timeout?: number;
+            requestReason?: boolean;
+        };
+        perToolLimits?: Record<string, {
+            maxCalls?: number;
+            required?: boolean;
+        }>;
+        subagentConfig?: Record<string, unknown>;
+        codeModeConfig?: Record<string, unknown>;
+    };
+    artifacts?: {
+        enabled: true;
+        types: Array<'markdown' | 'component'>;
+    };
+    reasoning?: boolean | Record<string, unknown>;
+    advisor?: {
+        model: string;
+        systemPrompt?: string;
+    } | null;
+    loopConfig?: {
+        maxTurns?: number;
+        maxCost?: number;
+        enableReflection?: boolean;
+        reflectionInterval?: number;
+    };
+    voice?: Record<string, unknown>;
+    errorHandling?: Record<string, unknown>;
+    loggingPolicy?: 'default' | 'on' | 'off';
+    temporal?: Record<string, unknown>;
+    memory?: {
+        enabled: boolean;
+        profileTemplate?: string;
+        injectSummary?: boolean;
+    };
+}
+/**
+ * `defineAgent` input — the flat authoring shape: identity + presentation
+ * fields alongside the runtime-config fields.
+ */
+interface DefineAgentInput extends AgentDefinitionConfig {
+    name: string;
+    description?: string;
+    icon?: string;
+}
+/** The canonical (wire) definition produced by `defineAgent`. */
+interface AgentDefinition {
+    name: string;
+    description?: string;
+    icon?: string;
+    config: AgentDefinitionConfig;
+}
+/**
+ * Pure-local declarative constructor for an agent definition. No I/O.
+ * Validates structure, rejects unknown top-level fields, and rejects
+ * account-scoped `tool_…` references (definitions must be
+ * environment-portable: the same `defineAgent` converges staging and
+ * production). Deep validation happens server-side at ensure time.
+ *
+ * @example
+ * ```typescript
+ * const pricingAssistant = defineAgent({
+ *   name: 'Pricing Assistant',
+ *   description: 'Marketing pricing page chat assistant.',
+ *   icon: '💬',
+ *   model: 'claude-sonnet-4-6',
+ *   temperature: 0.7,
+ *   loopConfig: { maxTurns: 1 },
+ *   systemPrompt: renderPricingPrompt(plans),
+ * })
+ * ```
+ */
+declare function defineAgent(input: DefineAgentInput): AgentDefinition;
+interface EnsureAgentOptions {
+    /** Plan without writing (the CI drift gate). Sends the full definition. */
+    dryRun?: boolean;
+    /**
+     * What to do when the agent's last write came from the dashboard/API/MCP
+     * rather than ensure. Default 'error' (HTTP 409 → AgentEnsureConflictError).
+     */
+    onConflict?: 'error' | 'overwrite';
+    /** 'publish' also re-aims the published-version pointer. Default 'none'. */
+    release?: 'none' | 'publish';
+    /**
+     * 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).
+     */
+    expectedRemoteHash?: string;
+    /** Implies dryRun; throws AgentDriftError unless the plan is 'none'. */
+    expectNoChanges?: boolean;
+}
+interface EnsureAgentConverged {
+    result: 'unchanged' | 'created' | 'updated';
+    agentId: string;
+    versionId: string | null;
+    /** The server-computed canonical hash (echo this — never your own). */
+    contentHash: string;
+}
+interface EnsureAgentPlan {
+    result: 'plan';
+    changes: 'none' | 'create' | 'update';
+    changedKeys: string[];
+    contentHash: string;
+    remoteHash?: string;
+    agentId?: string;
+}
+type EnsureAgentResult = EnsureAgentConverged | EnsureAgentPlan;
+interface AgentPullResult {
+    agentId: string;
+    definition: AgentDefinition;
+    contentHash: string;
+    lastModifiedSource: string | null;
+    updatedAt: string | null;
+    versionId: string | null;
+}
+/** A 409 from the ensure protocol (external_modification or remote_changed). */
+declare class AgentEnsureConflictError extends Error {
+    readonly code: 'external_modification' | 'remote_changed';
+    readonly lastModifiedSource?: string;
+    readonly modifiedAt?: string | null;
+    readonly currentHash?: string | null;
+    constructor(body: {
+        error?: string;
+        code: 'external_modification' | 'remote_changed';
+        lastModifiedSource?: string;
+        modifiedAt?: string | null;
+        currentHash?: string | null;
+    });
+}
+/** Thrown by `ensure(def, { expectNoChanges: true })` when drift is detected. */
+declare class AgentDriftError extends Error {
+    readonly plan: EnsureAgentPlan;
+    constructor(plan: EnsureAgentPlan);
+}
+/**
+ * Agent config-as-code operations.
+ *
+ * @example
+ * ```typescript
+ * const def = defineAgent({ name: 'Pricing Assistant', model: 'claude-sonnet-4-6', systemPrompt })
+ *
+ * // Converge (CI/deploy). Steady state is one tiny probe request.
+ * const result = await Runtype.agents.ensure(def)
+ *
+ * // PR drift gate.
+ * await Runtype.agents.ensure(def, { expectNoChanges: true })
+ *
+ * // Absorb a dashboard edit back into the repo.
+ * const { definition } = await Runtype.agents.pull('Pricing Assistant')
+ * ```
+ */
+declare class AgentsNamespace {
+    private getClient;
+    constructor(getClient: () => RuntypeClient$1);
+    /**
+     * Idempotently converge a definition onto the platform. Hash-first: probes
+     * with a content hash, and only ships the full definition when the server
+     * reports a miss (`definitionRequired`). Creates an immutable version
+     * snapshot on every change; never deletes.
+     */
+    ensure(definition: AgentDefinition, options?: EnsureAgentOptions): Promise<EnsureAgentResult>;
+    /**
+     * Pull the canonical definition + provenance for an agent by name — the
+     * absorb-drift direction. The contentHash reflects the live agent state.
+     */
+    pull(name: string): Promise<AgentPullResult>;
+    private memoize;
+    private request;
+}
+
 /**
  * Runtype - The unified SDK client for building and executing flows, batches, evals, and prompts
  *
@@ -38580,6 +39966,30 @@ declare class Runtype {
      * ```
      */
     static get skills(): SkillsNamespace;
+    /**
+     * Agents namespace - Agent config-as-code (define / ensure / pull)
+     *
+     * @example
+     * ```typescript
+     * import { defineAgent, Runtype } from '@runtypelabs/sdk'
+     *
+     * const assistant = defineAgent({
+     *   name: 'Pricing Assistant',
+     *   model: 'claude-sonnet-4-6',
+     *   systemPrompt: renderPrompt(pricingData),
+     * })
+     *
+     * // Converge at deploy time (idempotent; one tiny probe in steady state)
+     * await Runtype.agents.ensure(assistant)
+     *
+     * // CI drift gate
+     * await Runtype.agents.ensure(assistant, { expectNoChanges: true })
+     *
+     * // Absorb a dashboard edit back into the repo
+     * const { definition } = await Runtype.agents.pull('Pricing Assistant')
+     * ```
+     */
+    static get agents(): AgentsNamespace;
 }
 
 /**
@@ -38830,6 +40240,8 @@ interface RunTaskStateSlice {
     isCreationTask?: boolean;
     /** For creation tasks: allowed write root (e.g. "public/"). Writes must stay under this path. */
     outputRoot?: string;
+    /** Number of consecutive sessions with no tool actions (the stall-detection counter) */
+    consecutiveEmptySessions?: number;
     sessions: Array<{
         actionKeys?: string[];
         hadTextOutput?: boolean;
@@ -38905,11 +40317,40 @@ interface WorkflowPhase {
     /** Return true if the agent's TASK_COMPLETE claim should be accepted in this phase */
     canAcceptCompletion?: (state: RunTaskStateSlice, trace: RunTaskToolTraceSlice) => boolean;
 }
+/**
+ * Escalation policy for consecutive sessions with no tool actions.
+ *
+ * Every threshold counts the same `consecutiveEmptySessions` counter used for
+ * stall detection: a session is empty when it performed no write, read,
+ * discovery, or verification tool action. Text-only narration ("I'll create
+ * the files now") does NOT reset the counter — a model that narrates intent
+ * without calling tools still escalates here, even though phase-level
+ * `buildRecoveryMessage` conditions keyed on `hadTextOutput` would not fire.
+ */
+interface WorkflowStallPolicy {
+    /**
+     * Inject a generic recovery nudge into the next session after N consecutive
+     * empty sessions, when the current phase's buildRecoveryMessage returns
+     * nothing. Unset = no workflow-level nudge (legacy behavior).
+     */
+    nudgeAfter?: number;
+    /**
+     * Set `state.stallEscalationRequested` when the counter reaches N, signaling
+     * the caller (via onSession) to restart with a fallback model. The SDK only
+     * raises the signal — model switching is the caller's responsibility.
+     * Unset = never signal.
+     */
+    escalateModelAfter?: number;
+    /** Stop the run with status 'stalled' after N consecutive empty sessions (default 3). */
+    stopAfter?: number;
+}
 interface WorkflowDefinition {
     /** Workflow name for logging/debugging */
     name: string;
     /** Ordered list of phases */
     phases: WorkflowPhase[];
+    /** Escalation policy for consecutive sessions with no tool actions */
+    stallPolicy?: WorkflowStallPolicy;
     /** Classify the user message into a variant (e.g. 'create' vs 'modify') */
     classifyVariant?: (message: string) => string | undefined;
     /** Generate bootstrap context before the first session */
@@ -38931,6 +40372,7 @@ interface ApiClient {
     patch<T>(path: string, data?: any): Promise<T>;
     delete<T>(path: string, data?: any): 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>;
 }
 /**
@@ -40181,6 +41623,14 @@ interface ExecuteWithLocalToolsOptions {
      * delivered at the next session boundary instead of after the full session.
      */
     shouldInterrupt?: () => boolean;
+    /**
+     * Hard-abort signal for the in-flight execution. When it aborts, the
+     * active SSE stream is cancelled and the pause/resume loop returns a
+     * synthetic `agent_complete` (stopReason 'end_turn') carrying the cost and
+     * tokens observed so far — it does NOT throw. Callers distinguish an
+     * aborted run by checking their own signal, not the returned event.
+     */
+    abortSignal?: AbortSignal;
 }
 /**
  * Status of a long-task agent run
@@ -40243,6 +41693,14 @@ interface RunTaskSessionSummary {
     /** ISO timestamp when this session completed */
     completedAt: string;
 }
+interface RunTaskContextSummaryEntry {
+    id: string;
+    sessionIndex: number;
+    mode: 'auto' | 'forced';
+    strategy: 'provider_native' | 'summary_fallback';
+    content: string;
+    createdAt: string;
+}
 /**
  * Accumulated state for a long-task agent run.
  * This is both the in-memory state and the record metadata shape.
@@ -40321,10 +41779,25 @@ interface RunTaskState {
     lastCompletionRejectionReason?: string;
     /** Number of consecutive sessions with no tool actions (for stall detection) */
     consecutiveEmptySessions?: number;
+    /** Durable summaries generated by history compaction; mirrored into the marathon tree log. */
+    contextCompactionSummaries?: RunTaskContextSummaryEntry[];
+    /**
+     * Send-window base: index into `messages` of the first message NOT covered
+     * by the latest compaction summary. Replay sends
+     * `[latest summary, messages since base, continuation]` and re-compacts only
+     * when that window re-crosses the threshold. 0/undefined = no compaction yet.
+     */
+    contextWindowBaseIndex?: number;
+    /**
+     * Set when the workflow's stallPolicy.escalateModelAfter threshold is reached.
+     * Callers observe this in onSession and may restart with a fallback model.
+     * Cleared as soon as a session performs tool actions again.
+     */
+    stallEscalationRequested?: boolean;
     /** Arbitrary bag for workflow-specific data */
     workflowState?: Record<string, unknown>;
 }
-type RunTaskResumeState = Pick<RunTaskState, 'originalMessage' | 'bootstrapContext' | 'workflowPhase' | 'planPath' | 'planWritten' | 'bestCandidatePath' | 'bestCandidateReason' | 'candidatePaths' | 'recentReadPaths' | 'recentActionKeys' | 'bestCandidateNeedsVerification' | 'bestCandidateVerified' | 'verificationRequired' | 'lastVerificationPassed' | 'consecutiveBlockedVerificationSessions' | 'isCreationTask' | 'outputRoot' | 'workflowVariant' | 'workflowState'>;
+type RunTaskResumeState = Pick<RunTaskState, 'originalMessage' | 'bootstrapContext' | 'workflowPhase' | 'planPath' | 'planWritten' | 'bestCandidatePath' | 'bestCandidateReason' | 'candidatePaths' | 'recentReadPaths' | 'recentActionKeys' | 'bestCandidateNeedsVerification' | 'bestCandidateVerified' | 'verificationRequired' | 'lastVerificationPassed' | 'consecutiveBlockedVerificationSessions' | 'isCreationTask' | 'outputRoot' | 'workflowVariant' | 'contextCompactionSummaries' | 'contextWindowBaseIndex' | 'workflowState'>;
 /**
  * Callback invoked after each session completes.
  * Return `false` to stop the loop early.
@@ -40339,6 +41812,12 @@ interface RunTaskContextBudgetBreakdown {
     summaryTokens?: number;
     reservedOutputTokens?: number;
     effectiveInputBudgetTokens?: number;
+    /** Estimated tokens in the actual send-view after tool-result reduction. */
+    sendEstimatedInputTokens?: number;
+    /** Tool-result tokens in the actual send-view after tool-result reduction. */
+    sendToolOutputTokens?: number;
+    /** Estimated tokens saved by deriving the send-view from full-fidelity history. */
+    toolOutputReductionTokens?: number;
     estimatedInputTokens: number;
 }
 interface RunTaskContextCompactionEvent {
@@ -40450,6 +41929,15 @@ interface RunTaskOptions {
      * instead of after the session completes.
      */
     hasQueuedUserMessages?: () => boolean;
+    /**
+     * Hard abort for the in-flight task (e.g. user pressed Esc). Aborting
+     * cancels the active session's stream, preserves the cost/tokens observed
+     * so far, persists state via `onSession`, and resolves `runTask` with
+     * status 'paused' (resumable) — it never rejects because of the abort.
+     * In-flight stream cancellation requires the `localTools` streaming path;
+     * other execution paths honor the abort at the next session boundary.
+     */
+    abortSignal?: AbortSignal;
 }
 /**
  * Final result returned by `agents.runTask()`
@@ -40571,7 +42059,9 @@ declare class AgentsEndpoint {
      * // ...
      * ```
      */
-    executeStream(id: string, data: AgentExecuteRequest): Promise<Response>;
+    executeStream(id: string, data: AgentExecuteRequest, init?: {
+        signal?: AbortSignal;
+    }): Promise<Response>;
     /**
      * Execute an agent with streaming and callbacks
      *
@@ -40651,10 +42141,21 @@ declare class AgentsEndpoint {
     private normalizeCandidatePath;
     private dedupeNormalizedCandidatePaths;
     /**
-     * Compact old tool results based on context mode and window setting.
-     * Modifies messages in-place.
+     * Resolve the replay window: the base index sliced off the full history and
+     * the durable summary message that stands in for everything before it.
+     * The base is honored ONLY when the latest summary actually exists —
+     * slicing history with no summary substitute would silently drop prior
+     * context (defensive against states that carried a base but lost their
+     * summaries). The base is also clamped so a stale pointer (fork truncation,
+     * trimmed legacy state) never slices past the end of the array.
+     */
+    private resolveWindowReplay;
+    /**
+     * Derive the message view sent to the model based on context mode and window
+     * setting. This never mutates persisted marathon history; masking/offloading
+     * is a send-time view over the full-fidelity ledger/history.
      */
-    private compactToolResults;
+    private deriveToolContextMessages;
     private compactOneResult;
     private isMarathonArtifactPath;
     private isDiscoveryToolName;
@@ -40720,6 +42221,7 @@ declare class AgentsEndpoint {
     private resolveCompactStrategy;
     private estimateTextTokens;
     private estimateUnknownTokens;
+    private extractDeclaredToolResultChars;
     private estimateMessageContentTokens;
     private estimateToolCallTokens;
     private estimateToolResultTokens;
@@ -40730,13 +42232,13 @@ declare class AgentsEndpoint {
     private loadBuiltinToolSchemas;
     private buildDefaultCompactInstructions;
     private resolveCompactInstructions;
+    private extractArtifactReferencesFromMessages;
     private extractArtifactReferences;
     private buildContextBudgetBreakdown;
     private emitContextCompactionEvent;
     private emitContextNotice;
     private buildCompactHistoryMessagesWithLifecycle;
     private buildCompactHistoryMessages;
-    private isCompactHistoryMessageSet;
     /**
      * Generate a compact summary of prior work for continuation context.
      * Used when compact mode is enabled to keep token usage low.
@@ -41075,6 +42577,103 @@ declare class BillingEndpoint {
      */
     getSpendAnalytics(params?: BillingSpendAnalyticsParams): Promise<Record<string, unknown>>;
 }
+/** App manifest (`runtype.app.json`) — mirrors @runtypelabs/shared appManifestSchema. */
+interface AppManifest {
+    name: string;
+    description?: string;
+    capabilities: {
+        flows: string[];
+        agents: string[];
+    };
+    data: Array<{
+        namespace: string;
+        access: 'read' | 'read-write';
+    }>;
+    auth: 'none' | 'optional' | 'required';
+}
+interface App {
+    id: string;
+    slug: string;
+    shortId: string;
+    hostname: string;
+    /** Public origin the app serves from, e.g. https://retro-board-x7k2p9.runtype.run */
+    url: string;
+    name: string;
+    description: string | null;
+    activeVersionId: string | null;
+    visibility: 'public' | 'unlisted';
+    status: 'active' | 'suspended';
+    clientTokenId: string | null;
+    createdAt: string;
+    updatedAt: string;
+}
+interface AppVersion {
+    id: string;
+    appId: string;
+    versionNumber: number;
+    bundleHash: string;
+    manifest: AppManifest;
+    sizeBytes: number;
+    fileCount: number;
+    status: 'uploaded' | 'active' | 'superseded';
+    createdBy: string;
+    createdAt: string;
+}
+interface CreateAppRequest {
+    /** Lowercase letters, digits, hyphens; must start with a letter; max 40 chars. */
+    slug: string;
+    name: string;
+    description?: string;
+    visibility?: 'public' | 'unlisted';
+}
+interface UpdateAppRequest {
+    name?: string;
+    description?: string | null;
+    visibility?: 'public' | 'unlisted';
+    status?: 'active' | 'suspended';
+}
+/**
+ * Apps endpoint handlers — Runtype Apps are hosted AI apps served at
+ * {slug}-{shortId}.runtype.run. Deploy = upload a version (zip), then
+ * activate (instant pointer flip); rollback = activate an older version.
+ */
+declare class AppsEndpoint {
+    private client;
+    constructor(client: ApiClient);
+    /** List apps for the authenticated owner, newest first. */
+    list(): Promise<{
+        data: App[];
+    }>;
+    /** Get an app by id, including its URL and active version pointer. */
+    get(id: string): Promise<App>;
+    /** Create an app. A client token scoped to the app origin is auto-provisioned. */
+    create(data: CreateAppRequest): Promise<App>;
+    /** Update name, description, visibility, or status (suspended serves 410). */
+    update(id: string, data: UpdateAppRequest): Promise<App>;
+    /** Delete an app, its versions, and its hosting. Irreversible. */
+    delete(id: string): Promise<{
+        success: boolean;
+    }>;
+    /** List an app's versions, newest first. */
+    listVersions(id: string): Promise<{
+        data: AppVersion[];
+    }>;
+    /** Upload a zipped bundle (raw application/zip body) as a new version. */
+    uploadVersion(id: string, zipBytes: Uint8Array): Promise<AppVersion>;
+    /**
+     * Upload a bundle from in-memory file maps (the API zips server-side).
+     * Text files in `files`, binary files base64-encoded in `filesBase64`.
+     */
+    uploadVersionFiles(id: string, data: {
+        files: Record<string, string>;
+        filesBase64?: Record<string, string>;
+    }): Promise<AppVersion>;
+    /** Activate an uploaded version (deploy or rollback). */
+    activate(id: string, versionId: string): Promise<{
+        app: App;
+        version: AppVersion;
+    }>;
+}
 
 /**
  * @layer sdk
@@ -41154,6 +42753,7 @@ declare class RuntypeClient implements ApiClient {
     clientTokens: ClientTokensEndpoint;
     agents: AgentsEndpoint;
     secrets: SecretsEndpoint;
+    apps: AppsEndpoint;
     schedules: SchedulesEndpoint;
     surfaces: SurfacesEndpoint;
     conversations: ConversationsEndpoint;
@@ -41211,6 +42811,10 @@ declare class RuntypeClient implements ApiClient {
      * POST request with FormData support for file uploads
      */
     postFormData<T>(path: string, formData: FormData): Promise<T>;
+    /**
+     * POST request with a raw binary body (e.g. application/zip bundle uploads).
+     */
+    postBinary<T>(path: string, body: Uint8Array, contentType: string): Promise<T>;
     /**
      * Generic request that returns raw Response for streaming
      */
@@ -41259,6 +42863,50 @@ declare class RuntypeApiError extends Error {
  */
 declare function createClient(config?: ClientConfig): RuntypeClient;
 
+/**
+ * Offload marker contract — the single source of truth for the reference
+ * strings that replace large tool outputs in marathon send views.
+ *
+ * Two producers emit these markers:
+ *  - the SDK's hot-tail send-view offload (`AgentsEndpoint.offloadToolResult`)
+ *  - the CLI's ledger offload (`packages/cli/src/marathon/context-offload.ts`)
+ *
+ * Two consumers parse them back:
+ *  - `extractDeclaredToolResultChars` recovers TRUE output sizes for honest
+ *    token accounting (the compaction threshold must see real sizes, not
+ *    placeholder sizes — the original "double lossy compression" bug)
+ *  - the CLI session chunker re-expands ledger references to full payloads
+ *    before semantic indexing
+ *
+ * Because accounting and recall silently degrade when a producer's copy
+ * drifts from a consumer's regex, both sides MUST build and parse through
+ * this module. Do not inline these strings elsewhere.
+ */
+declare const LEDGER_ARTIFACT_LINE_PREFIX = "Ledger artifact: ";
+/** SDK hot-tail send-view marker: large tool result replaced by a file pointer. */
+declare function buildSendViewOffloadMarker(details: {
+    toolName: string;
+    charLength: number;
+    filePath: string;
+}): string;
+/** CLI ledger offload reference: content-addressed artifact recorded in the tree log. */
+declare function buildLedgerOffloadReference(details: {
+    outputId: string;
+    charLength: number;
+    relativePath: string;
+    preview: string;
+    truncated: boolean;
+}): string;
+/**
+ * Recover the declared true size from an offload marker. Returns undefined
+ * for values that are not offload markers (or not strings).
+ */
+declare function extractDeclaredToolResultChars(value: unknown): number | undefined;
+/** Parse the artifact/output id out of a ledger offload reference. */
+declare function parseOffloadedOutputId(value: string): string | undefined;
+/** Parse the tree-log-relative artifact path out of a ledger offload reference. */
+declare function parseLedgerArtifactRelativePath(value: string): string | undefined;
+
 /**
  * SSE Stream Utilities for FlowBuilder
  *
@@ -42346,6 +43994,227 @@ declare const STEP_TYPE_TO_METHOD: {
     readonly 'memory-summary': "memorySummary";
 };
 
+/**
+ * Named workflow hook registry.
+ *
+ * Workflow configs (the data form compiled by `compileWorkflowConfig`) can
+ * reference behavior by name instead of carrying functions: `builtin:*` names
+ * are reserved for the hooks that power the default workflow, and consumers
+ * register their own under a custom namespace (e.g. `acme:my-completion`).
+ *
+ * Every hook declares which SLOT KIND it implements so a config that wires a
+ * hook into the wrong slot fails at load/compile time with an actionable
+ * error — not mid-marathon. Hook misfires in this system don't crash, they
+ * stall, which is the worst failure mode to debug.
+ */
+
+interface WorkflowHookSignatures {
+    /** WorkflowPhase.buildInstructions — used verbatim (no header is added) */
+    instructions: (state: RunTaskStateSlice) => string;
+    /** WorkflowPhase.buildToolGuidance */
+    toolGuidance: (state: RunTaskStateSlice) => string[];
+    /** WorkflowPhase.isComplete */
+    completion: (ctx: WorkflowContext) => boolean;
+    /** WorkflowPhase.buildTransitionSummary */
+    transitionSummary: (state: RunTaskStateSlice, nextPhaseName: string) => string;
+    /** WorkflowPhase.interceptToolCall — may only narrow (block); returning undefined never overrides an outer deny */
+    intercept: (toolName: string, args: Record<string, unknown>, ctx: WorkflowContext) => string | undefined;
+    /** WorkflowPhase.buildRecoveryMessage */
+    recovery: (state: RunTaskStateSlice) => string | undefined;
+    /** WorkflowPhase.shouldForceEndTurn */
+    forceEndTurn: (snapshot: LocalToolExecutionLoopSnapshotSlice, ctx: WorkflowContext) => string | undefined;
+    /** WorkflowPhase.canAcceptCompletion */
+    acceptCompletion: (state: RunTaskStateSlice, trace: RunTaskToolTraceSlice) => boolean;
+    /** WorkflowDefinition.classifyVariant */
+    classify: (message: string) => string | undefined;
+    /** WorkflowDefinition.generateBootstrapContext */
+    bootstrap: (message: string, localTools: Record<string, LocalToolDefinition> | undefined, variant?: string) => Promise<string | undefined>;
+    /** WorkflowDefinition.buildCandidateBlock */
+    candidateBlock: (state: RunTaskStateSlice) => string;
+}
+type WorkflowHookKind = keyof WorkflowHookSignatures;
+interface WorkflowHookEntry<K extends WorkflowHookKind = WorkflowHookKind> {
+    kind: K;
+    fn: WorkflowHookSignatures[K];
+}
+/**
+ * A string is a hook reference iff it full-matches `<namespace>:<id>` with
+ * both segments lowercase [a-z0-9_-]. Inline prose (multi-word strings,
+ * paths, sentences) never matches, so config slots can accept either form.
+ */
+declare function isWorkflowHookRef(value: unknown): value is string;
+/**
+ * Register a custom workflow hook. The `builtin:` namespace is reserved —
+ * "replacing" a builtin means pointing the config slot at your own hook, not
+ * mutating the registry, so a shipped default config keeps a stable meaning.
+ * Re-registering an existing custom name overwrites it (last write wins
+ * within one process, e.g. plugin reload).
+ */
+declare function registerWorkflowHook<K extends WorkflowHookKind>(name: string, entry: WorkflowHookEntry<K>): void;
+/** Resolve a hook by name, validating the slot kind. Throws actionable errors. */
+declare function resolveWorkflowHook<K extends WorkflowHookKind>(name: string, expectedKind: K): WorkflowHookSignatures[K];
+/** List registered hooks (name + kind) for error messages and tooling. */
+declare function listWorkflowHooks(): Array<{
+    name: string;
+    kind: WorkflowHookKind;
+}>;
+/** Test seam: remove a custom hook (builtin entries cannot be removed). */
+declare function unregisterWorkflowHook(name: string): boolean;
+
+/**
+ * Declarative workflow configs and the compiler that turns them into a
+ * `WorkflowDefinition`.
+ *
+ * This is the single compile path for marathon workflows-as-data: the CLI
+ * playbook loader parses YAML/JSON into a `WorkflowConfig` and delegates here,
+ * and the shipped default workflow is itself a `WorkflowConfig`
+ * (`defaultWorkflowConfig` in default-workflow.ts) compiled through the same
+ * function — so playbooks and the default cannot drift in semantics.
+ *
+ * Each behavior slot accepts either INLINE DATA (strings, declarative
+ * criteria, policy rules) or a HOOK REFERENCE (`"<namespace>:<id>"`, see
+ * hook-registry.ts) resolved against the registry with slot-kind validation
+ * at compile time.
+ *
+ * The compiler is environment-free: no fs, no YAML, no glob library. Glob
+ * matching for policy rules is injected via `WorkflowCompileDeps` (the CLI
+ * passes micromatch); configs that use glob policies without a matcher fail
+ * at compile time with an actionable error.
+ */
+
+declare const DEFAULT_RECOVERY_AFTER_EMPTY_SESSIONS = 2;
+/** A `"<namespace>:<id>"` reference into the workflow hook registry. */
+type WorkflowHookRef = string;
+interface WorkflowCompletionCriteriaConfig {
+    /** Built-in criteria type, or a 'completion' hook reference */
+    type: 'evidence' | 'sessions' | 'planWritten' | 'never' | WorkflowHookRef;
+    minReadFiles?: number;
+    minSessions?: number;
+}
+/**
+ * Every behavior slot accepts inline data, a hook reference, or — for configs
+ * authored in TypeScript (module playbooks, programmatic use) — a plain
+ * function with the slot's hook signature. Functions never round-trip through
+ * JSON/YAML, so declarative playbooks are unaffected.
+ */
+type WorkflowSlot<K extends keyof WorkflowHookSignatures, Inline = never> = Inline | WorkflowHookRef | WorkflowHookSignatures[K];
+interface WorkflowRecoveryConfig {
+    /** Inject after N consecutive empty sessions (default 2) */
+    afterEmptySessions?: number;
+    /** Recovery message; supports {{key}} interpolation from run state (e.g. {{planPath}}) */
+    message: string;
+}
+/**
+ * Declarative policy for narrowing runtime behavior.
+ * Cannot override global denies (e.g. secret paths). Precedence: global deny > workflow deny > config narrowing.
+ */
+interface WorkflowPolicyConfig {
+    /** Glob patterns for allowed read paths (e.g. ["src/**", "docs/**"]). If set, reads outside these are blocked. */
+    allowedReadGlobs?: string[];
+    /** Glob patterns for allowed write paths. If set, writes outside these are blocked. */
+    allowedWriteGlobs?: string[];
+    /** Tool names to block (e.g. ["write_file", "search_repo"]). */
+    blockedTools?: string[];
+    /** Require verification before TASK_COMPLETE (consumed by the runner, not the compiler). */
+    requireVerification?: boolean;
+    /** Block discovery tools (search_repo, glob_files, tree_directory, list_directory). */
+    blockDiscoveryTools?: boolean;
+    /** Require plan to be written before any non-plan writes. */
+    requirePlanBeforeWrite?: boolean;
+    /** For creation tasks: allowed write root (e.g. "public/"). Consumed by the runner via state.outputRoot. */
+    outputRoot?: string;
+}
+interface WorkflowMilestoneConfig {
+    name: string;
+    description?: string;
+    /**
+     * Inline instructions (interpolated, with a "--- Workflow Phase ---" header
+     * added), an 'instructions' hook reference, or a function (both used verbatim).
+     */
+    instructions: WorkflowSlot<'instructions', string>;
+    /** Inline guidance lines, a 'toolGuidance' hook reference, or a function. Policy-derived guidance is appended either way. */
+    toolGuidance?: WorkflowSlot<'toolGuidance', string[]>;
+    /** Declarative criteria object, or a 'completion' predicate function */
+    completionCriteria?: WorkflowCompletionCriteriaConfig | WorkflowHookSignatures['completion'];
+    /**
+     * Inline boolean, an 'acceptCompletion' hook reference or function, or absent.
+     * NOTE: absent means the slot is omitted from the compiled phase — the SDK
+     * then ACCEPTS completion by default. Loaders that want reject-by-default
+     * (the playbook behavior) must set `false` explicitly before compiling.
+     */
+    canAcceptCompletion?: WorkflowSlot<'acceptCompletion', boolean>;
+    /** Inline recovery (triggered on the consecutive-empty-sessions counter), a 'recovery' hook reference, or a function */
+    recovery?: WorkflowSlot<'recovery', WorkflowRecoveryConfig>;
+    /** Inline summary (supports {{key}} + {{nextPhase}}), a 'transitionSummary' hook reference, or a function */
+    transitionSummary?: WorkflowSlot<'transitionSummary', string>;
+    /** An 'intercept' hook reference or function; runs after the policy intercept and can only narrow further */
+    intercept?: WorkflowSlot<'intercept'>;
+    /** A 'forceEndTurn' hook reference or function */
+    forceEndTurn?: WorkflowSlot<'forceEndTurn'>;
+    /** Per-milestone model override (consumed by the runner, not the compiler) */
+    model?: string;
+    /** Per-milestone fallback models (consumed by the runner, not the compiler) */
+    fallbackModels?: unknown[];
+}
+interface WorkflowConfig {
+    name: string;
+    description?: string;
+    stallPolicy?: WorkflowStallPolicy;
+    policy?: WorkflowPolicyConfig;
+    /** A 'classify' hook reference or function */
+    classifyVariant?: WorkflowSlot<'classify'>;
+    /** A 'bootstrap' hook reference or function */
+    bootstrap?: WorkflowSlot<'bootstrap'>;
+    /** A 'candidateBlock' hook reference or function */
+    candidateBlock?: WorkflowSlot<'candidateBlock'>;
+    milestones: WorkflowMilestoneConfig[];
+    /** Runner-level passthrough (verification requirements); ignored by the compiler */
+    verification?: {
+        required: boolean;
+        commands?: string[];
+    };
+    /** Runner-level passthrough (extra rules text); ignored by the compiler */
+    rules?: string;
+}
+/**
+ * A module playbook's default export: either a workflow config directly, or a
+ * factory that receives the registration API and returns one. The API is
+ * INJECTED so hooks land in the loading process's registry instance even when
+ * the playbook module would resolve a different copy of @runtypelabs/sdk.
+ */
+type WorkflowConfigFactory = (api: {
+    registerWorkflowHook: typeof registerWorkflowHook;
+}) => WorkflowConfig | Promise<WorkflowConfig>;
+/**
+ * Identity helper for TypeScript playbooks — exists purely for type inference
+ * (the `defineConfig` pattern). Optional: a plain object/function export with
+ * the same shape works identically, so playbook modules don't need
+ * @runtypelabs/sdk installed at runtime.
+ */
+declare function definePlaybook<T extends WorkflowConfig | WorkflowConfigFactory>(playbook: T): T;
+interface WorkflowCompileDeps {
+    /**
+     * Glob matcher for policy allowedReadGlobs / allowedWriteGlobs (the CLI
+     * passes micromatch). Required at compile time when the config uses glob
+     * policies; other configs compile without it.
+     */
+    matchPathGlobs?: (path: string, globs: string[]) => boolean;
+}
+declare function interpolateWorkflowTemplate(template: string, state: RunTaskStateSlice): string;
+/**
+ * Generate tool-guidance lines from the policy block so the model is told
+ * what the interceptor enforces. Guidance and enforcement compile from the
+ * same config, so they cannot drift — a silently-enforced constraint teaches
+ * the model that tools "don't work" instead of what the actual rule is.
+ */
+declare function buildPolicyGuidance(policy?: WorkflowPolicyConfig): string[];
+/**
+ * Compile a declarative workflow config into a WorkflowDefinition.
+ * Hook references are resolved (and kind-validated) eagerly, so a bad
+ * reference fails here — at load time — with an actionable error.
+ */
+declare function compileWorkflowConfig(config: WorkflowConfig, deps?: WorkflowCompileDeps): WorkflowDefinition;
+
 /**
  * Default marathon workflow: research → planning → execution.
  *
@@ -42354,6 +44223,23 @@ declare const STEP_TYPE_TO_METHOD: {
  * via the `workflowVariant` / `isCreationTask` flags on state.
  */
 
+/**
+ * Register the default workflow's behaviors as `builtin:*` hooks. Idempotent.
+ * Importing this module (or anything that pulls in `defaultWorkflow`) calls it
+ * automatically; loaders that compile configs without importing the default
+ * workflow (e.g. the CLI playbook loader) must call it explicitly before
+ * `compileWorkflowConfig` so `builtin:*` references resolve.
+ */
+declare function ensureDefaultWorkflowHooks(): void;
+/**
+ * The default workflow expressed as a declarative config over `builtin:*`
+ * hooks. This is the same shape the CLI playbook loader compiles, so a user
+ * playbook can reuse any slice of the default by referencing the same hooks
+ * (e.g. keep `builtin:research-guard` but supply custom execution
+ * instructions). The heuristic logic stays in this file as named builtins;
+ * the composition is data.
+ */
+declare const defaultWorkflowConfig: WorkflowConfig;
 declare const defaultWorkflow: WorkflowDefinition;
 
 /**
@@ -42397,6 +44283,36 @@ declare const deployWorkflow: WorkflowDefinition;
 
 declare const gameWorkflow: WorkflowDefinition;
 
+/**
+ * Helpers for WorkflowDefinition.stallPolicy: what happens when an agent
+ * produces consecutive sessions with no tool actions.
+ *
+ * All thresholds count the run-level `consecutiveEmptySessions` counter (a
+ * session is empty when it performed no write/read/discovery/verification
+ * tool action), so narration-only sessions escalate here even though they
+ * carry text output. Absent policy values preserve the legacy behavior:
+ * no nudge, no escalation signal, stop after 3.
+ */
+
+declare const DEFAULT_STALL_STOP_AFTER = 3;
+/** Resolve how many consecutive empty sessions end the run as 'stalled'. */
+declare function resolveStallStopAfter(policy?: WorkflowStallPolicy): number;
+/**
+ * Whether to raise the model-escalation signal for this empty-session count.
+ * Fires exactly once per stall episode (when the counter reaches the
+ * threshold), so a caller that cannot escalate is not re-signaled every
+ * subsequent empty session.
+ */
+declare function shouldRequestModelEscalation(policy: WorkflowStallPolicy | undefined, consecutiveEmptySessions: number): boolean;
+/** Whether the workflow-level empty-session nudge should be injected. */
+declare function shouldInjectEmptySessionNudge(policy: WorkflowStallPolicy | undefined, consecutiveEmptySessions: number): boolean;
+/**
+ * Generic recovery nudge used when a phase has no buildRecoveryMessage of its
+ * own (or it returned nothing). Targets the narration-without-tool-calls
+ * failure mode directly.
+ */
+declare function buildEmptySessionNudge(consecutiveEmptySessions: number): string;
+
 /**
  * Utility functions shared between workflow phase handlers and AgentsEndpoint.
  *
@@ -42414,4 +44330,4 @@ declare function getLikelySupportingCandidatePaths(bestCandidatePath: string | u
 declare function getDefaultPlanPath(taskName: string): string;
 declare function sanitizeTaskSlug(taskName: string): string;
 
-export { type Agent, type AgentApprovalCompleteEvent, type AgentApprovalStartEvent, type AgentCompleteEvent, type AgentErrorEvent, type AgentEvent, type AgentEventType, type AgentExecuteRequest, type AgentExecuteResponse, type AgentIterationCompleteEvent, type AgentIterationStartEvent, type AgentMediaEvent, type AgentMessage, type AgentPausedEvent, type AgentPingEvent, 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, AnalyticsEndpoint, type ApiClient, type ApiKey, ApiKeysEndpoint, type ApiResponse, type ApplyGeneratedProposalOptions, type ApplyGeneratedProposalResult, 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 BuiltInTool, type BulkEditCondition, type BulkEditRequest, type BulkEditResponse, type BulkEditResult, ChatEndpoint, ClientBatchBuilder, type ClientConfig, type ClientConversation, ClientEvalBuilder, ClientFlowBuilder, type ClientToken, type ClientTokenConfig, type ClientTokenEnvironment, type ClientTokenVersionPin, ClientTokensEndpoint, type ClientToolDefinition, type ClientWidgetTheme, 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 CreateClientTokenRequest, type CreateClientTokenResponse, type CreateConversationRequest, type CreateFlowRequest, type CreateModelConfigRequest, type CreatePromptData, type CreatePromptRequest, type CreateProviderKeyRequest, type CreateRecordRequest, type CreateScheduleRequest, type CreateSecretRequest, type CreateToolRequest, type CustomMCPServer, type CustomMCPServerAuth, type CustomToolConfig, type DeployCfSandboxRequest, type DeployCfSandboxResponse, type DeploySandboxRequest, type DeploySandboxResponse, type DiscoveredModel, type DispatchClient, DispatchEndpoint, type DispatchEnvironment, type DispatchEvent, type DispatchOptions$1 as DispatchOptions, type DispatchRequest, type ErrorHandlingMode, EvalBuilder, type EvalClient, EvalEndpoint, type EvalListParams, type EvalOptions, type EvalRecord, type EvalRequest, type EvalResult, type EvalRunConfig, EvalRunner, type EvalStatus, EvalsNamespace, type ExecuteToolRequest, type ExecuteToolResponse, type ExternalAgentContext, type ExternalToolConfig, type FallbackFailEvent, type FallbackStartEvent, type FallbackSuccessEvent, type FallbackTrigger, type FallbackTriggerType, type FallbacksExhaustedEvent, type FallbacksInitiatedEvent, type FetchGitHubStepConfig$1 as FetchGitHubStepConfig, type FetchUrlStepConfig$1 as FetchUrlStepConfig, type FieldFormat, type FileContentPart, type Flow, type FlowAttachment, FlowBuilder, type FlowCompleteEvent, type FlowConfig$1 as FlowConfig, type FlowErrorEvent, type FlowFallback, type FlowListItem, type FlowPausedEvent, 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 GenerateEmbeddingStepConfig$1 as GenerateEmbeddingStepConfig, type GeneratedRuntimeToolGateDecision, type GeneratedRuntimeToolGateOptions, type ImageContentPart, type Integration, type IntegrationTool, IntegrationsEndpoint, type IntegrationsListResponse, type JSONSchema, type JsonArray, type JsonObject, type JsonPrimitive, type JsonValue, type ListConversationsResponse, type ListParams, 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 Message$1 as Message, type MessageContent, type MessageFallback, type Metadata, type ModelConfig, ModelConfigsEndpoint, type ModelFallback, type ModelOverride, type ModelUsageDetail, type ModelUsageQueryParams, type ModelUsageResponse, type ModelUsageSummary, type ModelUsageTimeSeries, type PaginationResponse, type Prompt$1 as Prompt, type PromptErrorHandling, type PromptFallback, type PromptListParams, type PromptRunOptions, PromptRunner, type PromptStepConfig$1 as PromptStepConfig, PromptsEndpoint, PromptsNamespace, type ProviderApiKey, type ProviderKeyModel, ProviderKeysEndpoint, type ReasoningConfig, type ReasoningContentPart, type ReasoningValue, type RecordConfig$1 as RecordConfig, type RecordFilter, type RecordFilterCondition, type RecordFilterGroup, type RecordFilterOperator, type RecordListItem, type RecordListParams, RecordsEndpoint, type RetrieveRecordStepConfig$1 as RetrieveRecordStepConfig, type RetryFallback, type RunTaskContextBudgetBreakdown, type RunTaskContextCompactionEvent, type RunTaskContextCompactionStrategy, type RunTaskContextNoticeEvent, type RunTaskContinuation, 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 FetchGitHubStepConfig as RuntypeFetchGitHubStepConfig, type FetchUrlStepConfig as RuntypeFetchUrlStepConfig, RuntypeFlowBuilder, type FlowConfig as RuntypeFlowConfig, type GenerateEmbeddingStepConfig as RuntypeGenerateEmbeddingStepConfig, 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 SendTextStepConfig as RuntypeSendTextStepConfig, 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, STEP_FIELD_REGISTRY, STEP_TYPE_TO_METHOD, 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 SendEmailStepConfig$1 as SendEmailStepConfig, type SendEventStepConfig$1 as SendEventStepConfig, type SendStreamStepConfig$1 as SendStreamStepConfig, type SendTextStepConfig$1 as SendTextStepConfig, type SetVariableStepConfig$1 as SetVariableStepConfig, type SkillManifestInput, type SkillMarkdownInput, type SkillOrigin, type SkillProposalStatus, SkillProposalsNamespace, type SkillStatus, type SkillTrustLevel, type SkillVersionStatus, type SkillWithVersion, type SkillWriteInput, SkillsNamespace, type SlackInstallRequest, type StepCompleteEvent, type StepDeltaEvent, type StepFallback, type StepFieldMeta, type StepStartEvent, type StepWaitingLocalEvent, type StreamCallbacks, type StreamEvent, type StreamEventOf, type SubagentToolConfig, type Surface, type SurfaceListParams, SurfacesEndpoint, type TextContentPart, type Tool, type ToolConfig, type ToolWithValidation, type ToolsConfig, ToolsEndpoint, type TransformDataStepConfig$1 as TransformDataStepConfig, type UpdateClientTokenRequest, type UpdateConversationRequest, 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 VectorSearchStepConfig$1 as VectorSearchStepConfig, type VersionType, type WaitUntilStepConfig$1 as WaitUntilStepConfig, type WorkflowContext, type WorkflowDefinition, type WorkflowPhase, applyGeneratedRuntimeToolProposalToDispatchRequest, attachRuntimeToolsToDispatchRequest, buildGeneratedRuntimeToolGateOutput, createClient, createExternalTool, defaultWorkflow, deployWorkflow, evaluateGeneratedRuntimeToolProposal, gameWorkflow, getDefaultPlanPath, getLikelySupportingCandidatePaths, isDiscoveryToolName, isMarathonArtifactPath, isPreservationSensitiveTask, normalizeCandidatePath, parseFinalBuffer, parseSSEChunk, processStream, sanitizeTaskSlug, streamEvents };
+export { type Agent, type AgentApprovalCompleteEvent, type AgentApprovalStartEvent, type AgentCompleteEvent, type AgentDefinition, type AgentDefinitionConfig, AgentDriftError, 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, ApiKeysEndpoint, type ApiResponse, type App, type AppManifest, type AppVersion, type ApplyGeneratedProposalOptions, type ApplyGeneratedProposalResult, AppsEndpoint, 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 BuiltInTool, type BulkEditCondition, type BulkEditRequest, type BulkEditResponse, type BulkEditResult, ChatEndpoint, ClientBatchBuilder, type ClientConfig, type ClientConversation, ClientEvalBuilder, ClientFlowBuilder, type ClientToken, type ClientTokenConfig, type ClientTokenEnvironment, type ClientTokenVersionPin, ClientTokensEndpoint, type ClientToolDefinition, type ClientWidgetTheme, 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 CreateAppRequest, type CreateClientTokenRequest, type CreateClientTokenResponse, type CreateConversationRequest, type CreateFlowRequest, type CreateModelConfigRequest, type CreatePromptData, type CreatePromptRequest, type CreateProviderKeyRequest, type CreateRecordRequest, type CreateScheduleRequest, type CreateSecretRequest, type CreateToolRequest, type CustomMCPServer, type CustomMCPServerAuth, type CustomToolConfig, DEFAULT_RECOVERY_AFTER_EMPTY_SESSIONS, DEFAULT_STALL_STOP_AFTER, type DefineAgentInput, type DefineFlowInput, type DeployCfSandboxRequest, type DeployCfSandboxResponse, type DeploySandboxRequest, type DeploySandboxResponse, type DiscoveredModel, type DispatchClient, DispatchEndpoint, type DispatchEnvironment, type DispatchEvent, type DispatchOptions$1 as DispatchOptions, type DispatchRequest, type EnsureAgentConverged, type EnsureAgentOptions, type EnsureAgentPlan, type EnsureAgentResult, type EnsureFlowConverged, type EnsureFlowOptions, type EnsureFlowPlan, type EnsureFlowResult, type ErrorHandlingMode, EvalBuilder, type EvalClient, EvalEndpoint, type EvalListParams, type EvalOptions, type EvalRecord, type EvalRequest, type EvalResult, type EvalRunConfig, EvalRunner, type EvalStatus, EvalsNamespace, type ExecuteToolRequest, type ExecuteToolResponse, type ExternalAgentContext, type ExternalToolConfig, type FallbackFailEvent, type FallbackStartEvent, type FallbackSuccessEvent, type FallbackTrigger, type FallbackTriggerType, type FallbacksExhaustedEvent, type FallbacksInitiatedEvent, type FetchGitHubStepConfig$1 as FetchGitHubStepConfig, 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 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 GenerateEmbeddingStepConfig$1 as GenerateEmbeddingStepConfig, type GeneratedRuntimeToolGateDecision, type GeneratedRuntimeToolGateOptions, type ImageContentPart, type Integration, type IntegrationTool, IntegrationsEndpoint, type IntegrationsListResponse, type JSONSchema, type JsonArray, type JsonObject, type JsonPrimitive, type JsonValue, LEDGER_ARTIFACT_LINE_PREFIX, type ListConversationsResponse, type ListParams, 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 Message$1 as Message, type MessageContent, type MessageFallback, type Metadata, type ModelConfig, ModelConfigsEndpoint, type ModelFallback, type ModelOverride, type ModelUsageDetail, type ModelUsageQueryParams, type ModelUsageResponse, type ModelUsageSummary, type ModelUsageTimeSeries, type PaginationResponse, type Prompt$1 as Prompt, type PromptErrorHandling, type PromptFallback, type PromptListParams, type PromptRunOptions, PromptRunner, type PromptStepConfig$1 as PromptStepConfig, PromptsEndpoint, PromptsNamespace, type ProviderApiKey, type ProviderKeyModel, ProviderKeysEndpoint, type ReasoningConfig, type ReasoningContentPart, type ReasoningValue, type RecordConfig$1 as RecordConfig, type RecordFilter, type RecordFilterCondition, type RecordFilterGroup, type RecordFilterOperator, type RecordListItem, type RecordListParams, RecordsEndpoint, type RetrieveRecordStepConfig$1 as RetrieveRecordStepConfig, type RetryFallback, type RunTaskContextBudgetBreakdown, type RunTaskContextCompactionEvent, type RunTaskContextCompactionStrategy, type RunTaskContextNoticeEvent, type RunTaskContextSummaryEntry, type RunTaskContinuation, 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 FetchGitHubStepConfig as RuntypeFetchGitHubStepConfig, type FetchUrlStepConfig as RuntypeFetchUrlStepConfig, RuntypeFlowBuilder, type FlowConfig as RuntypeFlowConfig, type GenerateEmbeddingStepConfig as RuntypeGenerateEmbeddingStepConfig, 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 SendTextStepConfig as RuntypeSendTextStepConfig, 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, STEP_FIELD_REGISTRY, STEP_TYPE_TO_METHOD, 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 SendEmailStepConfig$1 as SendEmailStepConfig, type SendEventStepConfig$1 as SendEventStepConfig, type SendStreamStepConfig$1 as SendStreamStepConfig, type SendTextStepConfig$1 as SendTextStepConfig, type SetVariableStepConfig$1 as SetVariableStepConfig, type SkillListPage, type SkillListPagination, type SkillListParams, type SkillManifestInput, type SkillMarkdownInput, type SkillOrigin, type SkillProposalStatus, SkillProposalsNamespace, type SkillStatus, type SkillTrustLevel, type SkillVersionStatus, type SkillWithVersion, type SkillWriteInput, SkillsNamespace, type SlackInstallRequest, type StepCompleteEvent, type StepDeltaEvent, type StepFallback, type StepFieldMeta, type StepStartEvent, type StepWaitingLocalEvent, type StreamCallbacks, type StreamEvent, type StreamEventOf, type SubagentToolConfig, type Surface, type SurfaceListParams, SurfacesEndpoint, type TextContentPart, type Tool, type ToolConfig, type ToolWithValidation, type ToolsConfig, ToolsEndpoint, type TransformDataStepConfig$1 as TransformDataStepConfig, type UpdateAppRequest, type UpdateClientTokenRequest, type UpdateConversationRequest, 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 VectorSearchStepConfig$1 as VectorSearchStepConfig, 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, buildEmptySessionNudge, buildGeneratedRuntimeToolGateOutput, buildLedgerOffloadReference, buildPolicyGuidance, buildSendViewOffloadMarker, compileWorkflowConfig, computeAgentContentHash, computeFlowContentHash, createClient, createExternalTool, defaultWorkflow, defaultWorkflowConfig, defineAgent, defineFlow, definePlaybook, deployWorkflow, ensureDefaultWorkflowHooks, evaluateGeneratedRuntimeToolProposal, extractDeclaredToolResultChars, gameWorkflow, getDefaultPlanPath, getLikelySupportingCandidatePaths, interpolateWorkflowTemplate, isDiscoveryToolName, isMarathonArtifactPath, isPreservationSensitiveTask, isWorkflowHookRef, listWorkflowHooks, normalizeAgentDefinition, normalizeCandidatePath, parseFinalBuffer, parseLedgerArtifactRelativePath, parseOffloadedOutputId, parseSSEChunk, processStream, registerWorkflowHook, resolveStallStopAfter, resolveWorkflowHook, sanitizeTaskSlug, shouldInjectEmptySessionNudge, shouldRequestModelEscalation, streamEvents, unregisterWorkflowHook };