@runtypelabs/sdk 4.11.0 → 4.13.0

package/dist/index.d.ts

@@ -4520,6 +4520,131 @@ interface paths {
         patch?: never;
         trace?: never;
     };
+    "/v1/assets/{assetId}/extend": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        get?: never;
+        put?: never;
+        /**
+         * Extend preview expiry
+         * @description Re-up a preview page's expiration, keeping the same URL. Defaults to the caller's current plan TTL; pass `expiresInSeconds` to choose a shorter lifetime (the plan TTL is a hard ceiling — longer requests are clamped). Works on live previews and on previews that have already expired (expired pages keep their stored content; only serving is blocked). Applies to preview-rendering assets created by `publish_page` — download assets are not time-gated at the serving layer and cannot be extended.
+         */
+        post: {
+            parameters: {
+                query?: never;
+                header?: never;
+                path: {
+                    /** @description Asset ID (e.g. "asset_01k…"). A trailing file extension (".html") is ignored. */
+                    assetId: string;
+                };
+                cookie?: never;
+            };
+            requestBody?: {
+                content: {
+                    "application/json": {
+                        /** @description New lifetime in seconds (positive integer). Capped at the plan's preview TTL — shorter is honored, longer is clamped. Omit for the plan default. */
+                        expiresInSeconds?: number;
+                    } & {
+                        [key: string]: unknown;
+                    };
+                };
+            };
+            responses: {
+                /** @description Expiry extended */
+                200: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": {
+                            /** @description The asset ID that was extended. */
+                            assetId: string;
+                            /** @description New expiration timestamp (ISO 8601). null = permanent (plan grants no-expiry previews). */
+                            expiresAt: string | null;
+                            /** @description Seconds until the new expiration. null = permanent. */
+                            expiresIn: number | null;
+                            /** @enum {string} */
+                            rendering: "preview";
+                            /** @description The public URL of the asset (unchanged by extension). */
+                            url: string;
+                        };
+                    };
+                };
+                /** @description Asset is not a preview asset */
+                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 Asset not found */
+                404: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["Error"];
+                    };
+                };
+                /** @description Stored content no longer exists */
+                410: {
+                    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"];
+                    };
+                };
+                /** @description Asset storage not configured */
+                503: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["Error"];
+                    };
+                };
+            };
+        };
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
     "/v1/assets/{orgId}/{assetId}": {
         parameters: {
             query?: never;
@@ -6410,7 +6535,7 @@ interface paths {
         put?: never;
         /**
          * Submit feedback on a message
-         * @description Record message-level (`upvote` / `downvote` / `copy`, requires `messageId`) or conversation-level (`csat` 1-5, `nps` 0-10, requires `rating`) feedback for a client-token session. Idempotent per (session, type, message): a matching prior submission is updated. Expired-but-active sessions are accepted so post-conversation surveys still land.
+         * @description Record message-level (`upvote` / `downvote` / `copy`, requires `messageId`) or conversation-level (`csat` 1-5, `nps` 0-10, requires `rating`) feedback for a client-token session. Requires the client `token` (authenticated like `/init` and `/chat`): the token is verified, its origin allowlist is enforced, and the session lookup is scoped to the token. Idempotent per (session, type, message): a matching prior submission is updated. Expired-but-active sessions are accepted so post-conversation surveys still land.
          */
         post: {
             parameters: {
@@ -6429,6 +6554,7 @@ interface paths {
                         };
                         rating?: number;
                         sessionId: string;
+                        token: string;
                         /** @enum {string} */
                         type: "upvote" | "downvote" | "copy" | "csat" | "nps";
                     };
@@ -6472,7 +6598,16 @@ interface paths {
                         "application/json": components["schemas"]["Error"];
                     };
                 };
-                /** @description Session deactivated, client token inactive, or origin mismatch */
+                /** @description Invalid client token (when a `token` is supplied) */
+                401: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["Error"];
+                    };
+                };
+                /** @description Session deactivated, client token inactive, or origin not allowed */
                 403: {
                     headers: {
                         [name: string]: unknown;
@@ -6481,7 +6616,7 @@ interface paths {
                         "application/json": components["schemas"]["Error"];
                     };
                 };
-                /** @description Session not found */
+                /** @description Session not found (or not owned by the supplied token) */
                 404: {
                     headers: {
                         [name: string]: unknown;
@@ -27031,6 +27166,12 @@ interface paths {
                             type: string;
                             updatedAt: string;
                             userId: string;
+                            warnings?: {
+                                /** @enum {string} */
+                                code: "KEY_RENAMED";
+                                from: string;
+                                to: string;
+                            }[];
                         };
                     };
                 };
@@ -27247,6 +27388,12 @@ interface paths {
                                 id: string;
                             }[];
                             recordIds: string[];
+                            warnings?: {
+                                /** @enum {string} */
+                                code: "KEY_RENAMED";
+                                from: string;
+                                to: string;
+                            }[];
                         };
                     };
                 };
@@ -27716,6 +27863,12 @@ interface paths {
                                 type: string;
                             }[];
                             success: boolean;
+                            warnings?: {
+                                /** @enum {string} */
+                                code: "KEY_RENAMED";
+                                from: string;
+                                to: string;
+                            }[];
                         };
                     };
                 };
@@ -27920,6 +28073,12 @@ interface paths {
                             type: string;
                             updatedAt: string;
                             userId: string;
+                            warnings?: {
+                                /** @enum {string} */
+                                code: "KEY_RENAMED";
+                                from: string;
+                                to: string;
+                            }[];
                         };
                     };
                 };
@@ -31962,6 +32121,7 @@ interface paths {
                             description: string | null;
                             id: string;
                             isActive: boolean;
+                            lastModifiedSource?: string | null;
                             name: string;
                             organizationId: string | null;
                             parametersSchema?: {
@@ -32299,6 +32459,122 @@ interface paths {
         patch?: never;
         trace?: never;
     };
+    "/v1/tools/ensure": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        get?: never;
+        put?: never;
+        /**
+         * Ensure tool (config-as-code converge)
+         * @description Idempotently converge a repo-defined tool 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 tool or update it when the canonical content hash differs. The response always carries the server-computed canonical hash. Set dryRun to plan without writing (CI drift gate), and onConflict: "overwrite" to converge over dashboard/API edits. Tools have no version snapshots, so there is no publish option.
+         */
+        post: {
+            parameters: {
+                query?: never;
+                header?: never;
+                path?: never;
+                cookie?: never;
+            };
+            requestBody?: {
+                content: {
+                    "application/json": {
+                        contentHash?: string;
+                        definition?: {
+                            config: {
+                                [key: string]: unknown;
+                            };
+                            description: string;
+                            name: string;
+                            parametersSchema: {
+                                [key: string]: unknown;
+                            };
+                            /** @enum {string} */
+                            toolType: "flow" | "custom" | "external" | "graphql" | "mcp" | "local" | "subagent";
+                        };
+                        dryRun?: boolean;
+                        expectedRemoteHash?: string;
+                        name: string;
+                        /** @enum {string} */
+                        onConflict?: "error" | "overwrite";
+                    };
+                };
+            };
+            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"]["ToolEnsureResponse"];
+                    };
+                };
+                /** @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"]["ToolEnsureConflict"];
+                    };
+                };
+                /** @description Submitted contentHash does not match the server-recomputed canonical hash */
+                422: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["ToolEnsureHashMismatch"];
+                    };
+                };
+                /** @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/tools/flows/{flowId}/convert-to-tool": {
         parameters: {
             query?: never;
@@ -32343,6 +32619,7 @@ interface paths {
                             description: string | null;
                             id: string;
                             isActive: boolean;
+                            lastModifiedSource?: string | null;
                             name: string;
                             organizationId: string | null;
                             parametersSchema?: {
@@ -32418,6 +32695,83 @@ interface paths {
         patch?: never;
         trace?: never;
     };
+    "/v1/tools/pull": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /**
+         * Pull tool definition (config-as-code)
+         * @description Return the canonical config-as-code definition and provenance for a tool by name — the absorb-drift direction of the ensure protocol. The contentHash is recomputed from the live tool 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"]["ToolPullResponse"];
+                    };
+                };
+                /** @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 tool 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/tools/sandbox/cf-sandbox/deploy": {
         parameters: {
             query?: never;
@@ -32865,6 +33219,7 @@ interface paths {
                             description: string | null;
                             id: string;
                             isActive: boolean;
+                            lastModifiedSource?: string | null;
                             name: string;
                             organizationId: string | null;
                             parametersSchema?: {
@@ -32957,6 +33312,7 @@ interface paths {
                             description: string | null;
                             id: string;
                             isActive: boolean;
+                            lastModifiedSource?: string | null;
                             name: string;
                             organizationId: string | null;
                             parametersSchema?: {
@@ -33590,6 +33946,7 @@ interface paths {
                                 enableAgentSkills: boolean;
                                 enableChromeSurface: boolean;
                                 enableDashboardAssistant: boolean;
+                                enableRuntypeApps: boolean;
                                 productGeneratorModel: string;
                             };
                             id: string;
@@ -34245,6 +34602,8 @@ interface components {
             lastModifiedSource: string | null;
             updatedAt: string | null;
             versionId: string | null;
+            /** @description Present only when a raw tool_… reference could not be emitted as a portable tool:<name> (the tool was deleted, or its name is shadowed by an older same-named tool). Those references are left as raw ids, which the ensure surface rejects; each warning explains how to fix it. */
+            warnings?: string[];
         };
         AgentSSEEvent: {
             agentId: string;
@@ -35049,6 +35408,7 @@ interface components {
             };
             /** @enum {string} */
             type: "step_complete";
+            unresolvedVariables?: string[];
         } | {
             error: string;
             executionId?: string;
@@ -35383,6 +35743,8 @@ interface components {
             lastModifiedSource: string | null;
             updatedAt: string | null;
             versionId: string | null;
+            /** @description Present only when a raw tool_… reference could not be emitted as a portable tool:<name> (the tool was deleted, or its name is shadowed by an older same-named tool). Those references are left as raw ids, which the ensure surface rejects; each warning explains how to fix it. */
+            warnings?: string[];
         };
         FlowSSEEvent: {
             executionContext?: {
@@ -35530,6 +35892,7 @@ interface components {
             };
             /** @enum {string} */
             type: "step_complete";
+            unresolvedVariables?: string[];
         } | {
             error: string;
             executionId?: string;
@@ -35781,6 +36144,58 @@ interface components {
             skillVersionId: string;
             status: string;
         };
+        ToolEnsureConflict: {
+            /** @enum {string} */
+            code: "external_modification" | "remote_changed";
+            currentHash?: string | null;
+            error: string;
+            lastModifiedSource?: string;
+            modifiedAt?: string | null;
+        };
+        ToolEnsureHashMismatch: {
+            /** @enum {string} */
+            code: "content_hash_mismatch";
+            /** @description The server-computed canonical hash of the submitted definition. */
+            contentHash: string;
+            error: string;
+        };
+        ToolEnsureResponse: {
+            /** @description Server-computed canonical content hash. Clients should echo this hash in probes. */
+            contentHash: string;
+            /** @enum {string} */
+            result: "unchanged" | "created" | "updated";
+            toolId: string;
+        } | {
+            /** @enum {string} */
+            result: "definitionRequired";
+        } | {
+            changedKeys: string[];
+            /** @enum {string} */
+            changes: "none" | "create" | "update";
+            contentHash: string;
+            remoteHash?: string;
+            /** @enum {string} */
+            result: "plan";
+            toolId?: string;
+        };
+        ToolPullResponse: {
+            contentHash: string;
+            definition: {
+                config: {
+                    [key: string]: unknown;
+                };
+                description: string;
+                name: string;
+                parametersSchema: {
+                    [key: string]: unknown;
+                };
+                /** @enum {string} */
+                toolType: "flow" | "custom" | "external" | "graphql" | "mcp" | "local" | "subagent";
+            };
+            lastModifiedSource: string | null;
+            toolId: string;
+            updatedAt: string | null;
+        };
         UpdateUserProfileResponse: {
             email?: string;
             firstName?: string;
@@ -37081,6 +37496,7 @@ interface FlowAttachment {
     order: number;
 }
 type RuntypeRecord = paths['/v1/records/{id}']['get']['responses'][200]['content']['application/json'];
+type RecordWriteResponse = paths['/v1/records']['post']['responses'][201]['content']['application/json'];
 type RecordListItem = paths['/v1/records']['get']['responses'][200]['content']['application/json']['data'][number];
 interface ApiKey {
     id: string;
@@ -37185,6 +37601,83 @@ interface BulkEditResult {
 interface BulkEditResponse {
     data: BulkEditResult[];
     recordIds?: number[];
+    /** Deduplicated metadata key-rename notices across the edited records. */
+    warnings?: {
+        code: 'KEY_RENAMED';
+        from: string;
+        to: string;
+    }[];
+}
+/** A single unified step-level execution result for a record. */
+interface RecordStepResult {
+    id: string;
+    userId: string;
+    organizationId: string | null;
+    batchExecutionId: string | null;
+    executionSessionId: string | null;
+    flowId: string | null;
+    flowVersionId: string | null;
+    recordId: string | null;
+    recordName: string | null;
+    recordMetadata?: JsonValue | null;
+    stepId: string | null;
+    stepType: string;
+    stepName: string;
+    order: number | null;
+    status: string;
+    startedAt: string | null;
+    completedAt: string | null;
+    durationMs: number | null;
+    outputPreview: string | null;
+    stepConfig?: JsonValue | null;
+    inputVariables?: JsonValue | null;
+    resolvedPrompt?: string | null;
+    modelUsed?: string | null;
+    promptTokens?: number | null;
+    completionTokens?: number | null;
+    totalTokens?: number | null;
+    estimatedCost?: string | null;
+    errorMessage?: string | null;
+    retryCount?: number | null;
+    createdAt: string;
+}
+/** Query parameters for {@link RecordsEndpoint.getStepResults}. */
+interface RecordStepResultsParams {
+    flowId?: string;
+    batchId?: string;
+    status?: string;
+    from?: string;
+    to?: string;
+    sortBy?: string;
+    sortOrder?: 'asc' | 'desc';
+    limit?: number;
+    offset?: number;
+}
+/** Paginated response from {@link RecordsEndpoint.getStepResults}. */
+interface RecordStepResultsResponse {
+    data: RecordStepResult[];
+    pagination: {
+        limit: number;
+        offset: number;
+        returned: number;
+        hasMore: boolean;
+    };
+}
+/** Per-model cost line within a {@link RecordCostAggregation}. */
+interface RecordCostModelBreakdown {
+    model: string;
+    cost: number;
+    tokens: number;
+    count: number;
+}
+/** Aggregated cost breakdown for a record from {@link RecordsEndpoint.getCosts}. */
+interface RecordCostAggregation {
+    totalCost: number;
+    totalTokens: number;
+    promptTokens: number;
+    completionTokens: number;
+    executionCount: number;
+    modelBreakdown: RecordCostModelBreakdown[];
 }
 type ProviderApiKey = paths['/v1/provider-keys']['get']['responses'][200]['content']['application/json']['providerKeys'][number];
 /**
@@ -38089,6 +38582,13 @@ interface FlowPullResult {
     lastModifiedSource: string | null;
     updatedAt: string | null;
     versionId: string | null;
+    /**
+     * Present only when a raw `tool_…` reference could not be emitted as a
+     * portable `tool:<name>` (the tool was deleted, or its name is shadowed by an
+     * older same-named tool). Those references are left as raw ids — which
+     * `defineFlow`/`ensure` reject — so each warning explains how to fix it.
+     */
+    warnings?: string[];
 }
 /** A 409 from the ensure protocol (external_modification or remote_changed). */
 declare class FlowEnsureConflictError extends Error {
@@ -39659,6 +40159,13 @@ interface AgentPullResult {
     lastModifiedSource: string | null;
     updatedAt: string | null;
     versionId: string | null;
+    /**
+     * Present only when a raw `tool_…` reference could not be emitted as a
+     * portable `tool:<name>` (the tool was deleted, or its name is shadowed by an
+     * older same-named tool). Those references are left as raw ids — which
+     * `defineAgent`/`ensure` reject — so each warning explains how to fix it.
+     */
+    warnings?: string[];
 }
 /** A 409 from the ensure protocol (external_modification or remote_changed). */
 declare class AgentEnsureConflictError extends Error {
@@ -39715,6 +40222,190 @@ declare class AgentsNamespace {
     private request;
 }
 
+/**
+ * Tool config-as-code: `defineTool`, `tools.ensure`, `tools.pull`.
+ *
+ * The deploy-time convergence postcondition for saved tools: "make the
+ * platform's definition of this tool 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 tool and creates a new one.
+ *
+ * Wire protocol (POST /v1/tools/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.
+ *
+ * Unlike agents/flows, tools have NO version snapshots: there is no
+ * `release: 'publish'` option and no `versionId` on the result.
+ *
+ * The content hash is the canonical tool hash (`computeToolContentHash` —
+ * mirrored from `packages/shared/src/utils/tool-content-hash.ts`; this package
+ * is dependency-free by convention) over `{ toolType, description,
+ * parametersSchema, config }`. `name` is identity, not content, so it is
+ * excluded from the hash.
+ *
+ * See docs/adr/0003-agent-config-as-code-ensure.md for the design rationale.
+ */
+
+/** Canonical normalized form of a tool definition (name excluded — identity). */
+declare function normalizeToolDefinition(definition: ToolContentInput): {
+    toolType: string;
+    description?: string;
+    parametersSchema: Record<string, unknown>;
+    config: Record<string, unknown>;
+};
+/** SHA-256 (hex) over the canonical normalized tool definition. */
+declare function computeToolContentHash(definition: ToolContentInput): Promise<string>;
+interface ToolContentInput {
+    description?: string | null;
+    toolType: string;
+    parametersSchema?: Record<string, unknown> | null;
+    config?: Record<string, unknown> | null;
+}
+/** The tool types `ensure` accepts (mirrors the server's CreateToolSchema). */
+type ToolDefinitionType = 'flow' | 'custom' | 'external' | 'graphql' | 'mcp' | 'local' | 'subagent';
+/** `defineTool` input: identity (name) + the convergeable content fields. */
+interface DefineToolInput {
+    name: string;
+    description: string;
+    toolType: ToolDefinitionType;
+    parametersSchema: Record<string, unknown>;
+    config: Record<string, unknown>;
+}
+/** The canonical (wire) definition produced by `defineTool`. */
+interface ToolDefinition {
+    name: string;
+    description: string;
+    toolType: ToolDefinitionType;
+    parametersSchema: Record<string, unknown>;
+    config: Record<string, unknown>;
+}
+/**
+ * Pure-local declarative constructor for a tool definition. No I/O. Validates
+ * structure and rejects unknown fields. Deep validation (custom-tool code
+ * preflight, {{secret:KEY}} reference rules) happens server-side at ensure
+ * time, mirroring the create/update routes.
+ *
+ * @example
+ * ```typescript
+ * const weather = defineTool({
+ *   name: 'Weather Lookup',
+ *   description: 'Fetch the current weather for a city',
+ *   toolType: 'external',
+ *   parametersSchema: {
+ *     type: 'object',
+ *     properties: { city: { type: 'string' } },
+ *     required: ['city'],
+ *   },
+ *   config: { url: 'https://api.example.com/weather?q={{city}}', method: 'GET' },
+ * })
+ * ```
+ */
+declare function defineTool(input: DefineToolInput): ToolDefinition;
+interface EnsureToolOptions {
+    /** Plan without writing (the CI drift gate). Sends the full definition. */
+    dryRun?: boolean;
+    /**
+     * What to do when the tool's last write came from the dashboard/API rather
+     * than ensure. Default 'error' (HTTP 409 → ToolEnsureConflictError).
+     */
+    onConflict?: 'error' | 'overwrite';
+    /**
+     * 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 ToolDriftError unless the plan is 'none'. */
+    expectNoChanges?: boolean;
+}
+interface EnsureToolConverged {
+    result: 'unchanged' | 'created' | 'updated';
+    toolId: string;
+    /** The server-computed canonical hash (echo this — never your own). */
+    contentHash: string;
+}
+interface EnsureToolPlan {
+    result: 'plan';
+    changes: 'none' | 'create' | 'update';
+    changedKeys: string[];
+    contentHash: string;
+    remoteHash?: string;
+    toolId?: string;
+}
+type EnsureToolResult = EnsureToolConverged | EnsureToolPlan;
+interface ToolPullResult {
+    toolId: string;
+    definition: ToolDefinition;
+    contentHash: string;
+    lastModifiedSource: string | null;
+    updatedAt: string | null;
+}
+/** A 409 from the ensure protocol (external_modification or remote_changed). */
+declare class ToolEnsureConflictError 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 ToolDriftError extends Error {
+    readonly plan: EnsureToolPlan;
+    constructor(plan: EnsureToolPlan);
+}
+
+/**
+ * ToolsNamespace — config-as-code operations for saved tools.
+ *
+ * `tools.ensure` is the deploy-time, non-executing converge (create-or-update a
+ * tool by name + account scope); `tools.pull` is the absorb-drift direction.
+ * Both delegate to the implementation in `tools-ensure.ts`.
+ */
+
+declare class ToolsNamespace {
+    private getClient;
+    constructor(getClient: () => RuntypeClient$1);
+    /**
+     * Idempotently converge a `defineTool` definition onto the platform.
+     * Hash-first: the steady state is one tiny probe request. Creates or updates
+     * the saved tool; never deletes. Identity is name + account scope.
+     *
+     * @example
+     * ```typescript
+     * const weather = defineTool({
+     *   name: 'Weather Lookup',
+     *   description: 'Fetch the current weather for a city',
+     *   toolType: 'external',
+     *   parametersSchema: { type: 'object', properties: { city: { type: 'string' } } },
+     *   config: { url: 'https://api.example.com/weather', method: 'GET' },
+     * })
+     *
+     * // Converge (CI/deploy).
+     * const result = await Runtype.tools.ensure(weather)
+     *
+     * // PR drift gate.
+     * await Runtype.tools.ensure(weather, { expectNoChanges: true })
+     * ```
+     */
+    ensure(definition: ToolDefinition, options?: EnsureToolOptions): Promise<EnsureToolResult>;
+    /**
+     * Pull the canonical definition + provenance for a tool by name — the
+     * absorb-drift direction of the ensure protocol.
+     */
+    pull(name: string): Promise<ToolPullResult>;
+}
+
 /**
  * Runtype - The unified SDK client for building and executing flows, batches, evals, and prompts
  *
@@ -39990,6 +40681,32 @@ declare class Runtype {
      * ```
      */
     static get agents(): AgentsNamespace;
+    /**
+     * Tools namespace - Tool config-as-code (define / ensure / pull)
+     *
+     * @example
+     * ```typescript
+     * import { defineTool, Runtype } from '@runtypelabs/sdk'
+     *
+     * const weather = defineTool({
+     *   name: 'Weather Lookup',
+     *   description: 'Fetch the current weather for a city',
+     *   toolType: 'external',
+     *   parametersSchema: { type: 'object', properties: { city: { type: 'string' } } },
+     *   config: { url: 'https://api.example.com/weather', method: 'GET' },
+     * })
+     *
+     * // Converge at deploy time (idempotent; one tiny probe in steady state)
+     * await Runtype.tools.ensure(weather)
+     *
+     * // CI drift gate
+     * await Runtype.tools.ensure(weather, { expectNoChanges: true })
+     *
+     * // Absorb a dashboard edit back into the repo
+     * const { definition } = await Runtype.tools.pull('Weather Lookup')
+     * ```
+     */
+    static get tools(): ToolsNamespace;
 }
 
 /**
@@ -40481,11 +41198,11 @@ declare class RecordsEndpoint {
     /**
      * Create a new record
      */
-    create(data: CreateRecordRequest): Promise<RuntypeRecord>;
+    create(data: CreateRecordRequest): Promise<RecordWriteResponse>;
     /**
      * Update an existing record
      */
-    update(id: string, data: Partial<CreateRecordRequest>): Promise<RuntypeRecord>;
+    update(id: string, data: Partial<CreateRecordRequest>): Promise<RecordWriteResponse>;
     /**
      * Delete a record
      */
@@ -40511,6 +41228,15 @@ declare class RecordsEndpoint {
         fromDate?: string;
         toDate?: string;
     }): Promise<any[]>;
+    /**
+     * Get unified step-level execution results for a record, with filtering and
+     * pagination.
+     */
+    getStepResults(id: string, params?: RecordStepResultsParams): Promise<RecordStepResultsResponse>;
+    /**
+     * Get the aggregated cost breakdown (by model) for a record's executions.
+     */
+    getCosts(id: string): Promise<RecordCostAggregation>;
     /**
      * Delete a specific result for a record
      */
@@ -41850,6 +42576,20 @@ type RunTaskOnContextNotice = (event: RunTaskContextNoticeEvent) => void | Promi
 /**
  * Options for `agents.runTask()`
  */
+/**
+ * Storage seam for hot-tail tool-output offloads. Given a large tool result
+ * the SDK has already decided to offload (above its inline threshold), the
+ * recorder persists the content however it likes and returns the reference
+ * string to splice into the send view in place of the raw output. Return
+ * `undefined` to decline and let the SDK fall back to its built-in store.
+ */
+type RunTaskOffloadRecorder = (details: {
+    toolCallId: string;
+    toolName: string;
+    content: string;
+}) => {
+    reference: string;
+} | undefined;
 interface RunTaskOptions {
     /** The user message / task instruction for the agent */
     message: string;
@@ -41902,6 +42642,18 @@ interface RunTaskOptions {
     onContextNotice?: RunTaskOnContextNotice;
     /** Saved workflow state to seed a resumed or restarted marathon run */
     resumeState?: RunTaskResumeState;
+    /**
+     * Optional storage seam for hot-tail tool-output offloads. When supplied,
+     * `offloadToolResult` delegates persistence to the recorder instead of the
+     * built-in `.runtype/marathons/<slug>/tool-outputs/` fallback, and returns
+     * the recorder's reference in place of the file-pointer marker. The CLI
+     * backs this with its content-addressed ledger store so the 500–100k char
+     * band becomes a first-class ledger citizen (content-addressed, hashed,
+     * `read_offloaded_output`-resolvable, deduped). Returning `undefined` (or
+     * throwing) falls back to the built-in store. A future server-side artifact
+     * upload plugs into this same seam.
+     */
+    offloadRecorder?: RunTaskOffloadRecorder;
     /** How tool results are stored in message history for continuation.
      *  'hot-tail' (default): recent results inline, older offloaded to disk.
      *  'observation-mask': recent results inline, older replaced with placeholder.
@@ -44330,4 +45082,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 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 };
+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 DefineToolInput, 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 EnsureToolConverged, type EnsureToolOptions, type EnsureToolPlan, type EnsureToolResult, 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 RecordCostAggregation, type RecordCostModelBreakdown, type RecordFilter, type RecordFilterCondition, type RecordFilterGroup, type RecordFilterOperator, type RecordListItem, type RecordListParams, type RecordStepResult, type RecordStepResultsParams, type RecordStepResultsResponse, type RecordWriteResponse, RecordsEndpoint, type RetrieveRecordStepConfig$1 as RetrieveRecordStepConfig, type RetryFallback, type RunTaskContextBudgetBreakdown, type RunTaskContextCompactionEvent, type RunTaskContextCompactionStrategy, type RunTaskContextNoticeEvent, type RunTaskContextSummaryEntry, type RunTaskContinuation, type RunTaskOffloadRecorder, type RunTaskOnContextCompaction, type RunTaskOnContextNotice, type RunTaskOnSession, type RunTaskOptions, type RunTaskResult, type RunTaskResumeState, type RunTaskSessionSummary, type RunTaskState, type RunTaskStateSlice, type RunTaskStatus, type RunTaskToolTraceSlice, type RuntimeCustomToolConfig, type RuntimeExternalToolConfig, type RuntimeFlowToolConfig, type RuntimeLocalToolConfig, type RuntimeSubagentToolConfig, type RuntimeTool, type RuntimeToolConfig, Runtype, type AgentSkillBinding as RuntypeAgentSkillBinding, RuntypeApiError, RuntypeClient, type ConditionalStepConfig as RuntypeConditionalStepConfig, type RuntypeConfig, type 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 ToolDefinition, type ToolDefinitionType, ToolDriftError, ToolEnsureConflictError, type ToolPullResult, type ToolWithValidation, type ToolsConfig, ToolsEndpoint, ToolsNamespace, 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, computeToolContentHash, createClient, createExternalTool, defaultWorkflow, defaultWorkflowConfig, defineAgent, defineFlow, definePlaybook, defineTool, deployWorkflow, ensureDefaultWorkflowHooks, evaluateGeneratedRuntimeToolProposal, extractDeclaredToolResultChars, gameWorkflow, getDefaultPlanPath, getLikelySupportingCandidatePaths, interpolateWorkflowTemplate, isDiscoveryToolName, isMarathonArtifactPath, isPreservationSensitiveTask, isWorkflowHookRef, listWorkflowHooks, normalizeAgentDefinition, normalizeCandidatePath, normalizeToolDefinition, parseFinalBuffer, parseLedgerArtifactRelativePath, parseOffloadedOutputId, parseSSEChunk, processStream, registerWorkflowHook, resolveStallStopAfter, resolveWorkflowHook, sanitizeTaskSlug, shouldInjectEmptySessionNudge, shouldRequestModelEscalation, streamEvents, unregisterWorkflowHook };