@runtypelabs/sdk 5.6.0 → 5.7.0

package/dist/index.cjs

@@ -6188,7 +6188,7 @@ var Runtype = class {
 
 // src/version.ts
 var FALLBACK_VERSION = "0.0.0";
-var SDK_VERSION = "5.6.0".length > 0 ? "5.6.0" : FALLBACK_VERSION;
+var SDK_VERSION = "5.7.0".length > 0 ? "5.7.0" : FALLBACK_VERSION;
 var RUNTYPE_CLIENT_KIND = "sdk";
 var SDK_USER_AGENT = `runtype-sdk/${SDK_VERSION} (typescript)`;
 

package/dist/index.d.cts

@@ -2776,6 +2776,107 @@ interface paths {
         patch?: never;
         trace?: never;
     };
+    "/v1/agents/{id}/executions/{executionId}/events": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /**
+         * Stream execution events
+         * @description Reconnect to a durable Claude Managed agent turn: replay-and-tail its Server-Sent Events. Resolves the per-conversation session owner by (agentId, conversationId), replays buffered events with seq greater than `after`, then live-tails if the turn is still running. Each event carries an SSE `id:` line with its durable seq; reconnect after a disconnect (tab reload, sleep, stream timeout) by passing the last seen id as `after` to resume without missing or duplicating events. The vocabulary follows the same negotiation as the execution stream (`?events=`, `X-Persona-Version`, then the default-sse-event-format flag).
+         */
+        get: {
+            parameters: {
+                query: {
+                    /** @description The conversation key that, with the agent id, resolves the durable session owner. */
+                    conversationId: string;
+                    /** @description Replay only events with seq greater than this value (the last seen SSE id). Defaults to 0. */
+                    after?: string;
+                };
+                header?: never;
+                path: {
+                    id: string;
+                    executionId: string;
+                };
+                cookie?: never;
+            };
+            requestBody?: never;
+            responses: {
+                /** @description Server-Sent Events stream (buffered replay followed by a live tail) */
+                200: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "text/event-stream": unknown;
+                    };
+                };
+                /** @description Invalid agent ID or missing conversationId */
+                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 Agent not found */
+                404: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["Error"];
+                    };
+                };
+                /** @description Internal server error */
+                500: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["Error"];
+                    };
+                };
+                /** @description Failed to attach to the execution stream */
+                502: {
+                    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}/executions/{executionId}/tool-calls": {
         parameters: {
             query?: never;
@@ -3380,6 +3481,189 @@ interface paths {
         patch?: never;
         trace?: never;
     };
+    "/v1/agents/{id}/runs": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /**
+         * List managed agent runs
+         * @description List the durable per-turn run summaries for a saved Claude Managed agent, newest first, optionally scoped to one conversation. Each row is written when a managed turn settles. Auth: agent ownership + AGENTS:READ (the same trust level as the events reconnect route).
+         */
+        get: {
+            parameters: {
+                query?: {
+                    /** @description Scope to a single conversation key. */
+                    conversationId?: string;
+                    /** @description Max rows to return (default 50, capped at 200). */
+                    limit?: number;
+                };
+                header?: never;
+                path: {
+                    id: string;
+                };
+                cookie?: never;
+            };
+            requestBody?: never;
+            responses: {
+                /** @description The agent run summaries */
+                200: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": {
+                            runs: components["schemas"]["ManagedAgentRunSummary"][];
+                        };
+                    };
+                };
+                /** @description Invalid agent ID */
+                400: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["Error"];
+                    };
+                };
+                /** @description Unauthorized */
+                401: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["Error"];
+                    };
+                };
+                /** @description Insufficient permissions */
+                403: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["Error"];
+                    };
+                };
+                /** @description Agent not found */
+                404: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["Error"];
+                    };
+                };
+                /** @description Internal server error */
+                500: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["Error"];
+                    };
+                };
+            };
+        };
+        put?: never;
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/v1/agents/{id}/runs/{runId}": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /**
+         * Get a managed agent run
+         * @description Fetch one durable run summary plus its deliverable pointers (the swept `/mnt/session/outputs/` files; the bytes live in asset storage). Auth: agent ownership + AGENTS:READ.
+         */
+        get: {
+            parameters: {
+                query?: never;
+                header?: never;
+                path: {
+                    id: string;
+                    runId: string;
+                };
+                cookie?: never;
+            };
+            requestBody?: never;
+            responses: {
+                /** @description The run summary and its deliverables */
+                200: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": {
+                            outputs: components["schemas"]["ManagedAgentRunOutput"][];
+                            run: components["schemas"]["ManagedAgentRunSummary"];
+                        };
+                    };
+                };
+                /** @description Invalid agent ID */
+                400: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["Error"];
+                    };
+                };
+                /** @description Unauthorized */
+                401: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["Error"];
+                    };
+                };
+                /** @description Insufficient permissions */
+                403: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["Error"];
+                    };
+                };
+                /** @description Agent or run not found */
+                404: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["Error"];
+                    };
+                };
+                /** @description Internal server error */
+                500: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["Error"];
+                    };
+                };
+            };
+        };
+        put?: never;
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
     "/v1/agents/{id}/voice": {
         parameters: {
             query?: never;
@@ -36717,7 +37001,9 @@ interface components {
             /** @enum {string} */
             type: "approval_complete";
         } | {
+            awaitReason?: string;
             awaitedAt?: string;
+            crawlId?: string;
             executionId: string;
             /** @enum {string} */
             origin?: "webmcp" | "sdk";
@@ -36726,6 +37012,7 @@ interface components {
                 [key: string]: unknown;
             };
             seq: number;
+            stepId?: string;
             toolCallId?: string;
             toolId?: string;
             toolName?: string;
@@ -36885,7 +37172,9 @@ interface components {
             type: "flow_error";
             upgradeUrl?: string;
         } | {
+            awaitReason?: string;
             awaitedAt: string;
+            crawlId?: string;
             executionId?: string;
             flowId: string;
             /** @enum {string} */
@@ -36895,6 +37184,7 @@ interface components {
                 [key: string]: unknown;
             };
             seq?: number;
+            stepId?: string;
             toolCallId?: string;
             toolId?: string;
             toolName?: string;
@@ -37186,6 +37476,39 @@ interface components {
             valid: boolean;
             warnings: components["schemas"]["FlowValidationIssue"][];
         };
+        ManagedAgentRunOutput: {
+            anthropicFileId: string;
+            /** @description Asset-storage key the bytes were persisted to. */
+            assetRef: string | null;
+            createdAt: string;
+            filename: string;
+            /** @description Deliverable pointer id (typeid, `mao_…`). */
+            id: string;
+            mimeType: string;
+            sizeBytes: number;
+        };
+        ManagedAgentRunSummary: {
+            agentId: string;
+            conversationId: string;
+            /** @description Cost in thousandths of a cent ($1 = 100,000). */
+            costThousandths: number;
+            createdAt: string;
+            error: string | null;
+            /** @description The DO-minted execution id for the turn. */
+            executionId: string;
+            /** @description The final assistant text (may be large or null). */
+            finalText: string | null;
+            /** @description Run id (typeid, `mar_…`). */
+            id: string;
+            inputTokens: number;
+            /** @description The durable seq at settle (reconnect ceiling). */
+            lastEventSeq: number;
+            outputTokens: number;
+            settledAt: string;
+            startedAt: string;
+            /** @description 'completed' | 'failed' | 'interrupted'. */
+            status: string;
+        };
         Pagination: {
             currentOffset: number;
             currentPage?: number;

package/dist/index.d.ts

@@ -2776,6 +2776,107 @@ interface paths {
         patch?: never;
         trace?: never;
     };
+    "/v1/agents/{id}/executions/{executionId}/events": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /**
+         * Stream execution events
+         * @description Reconnect to a durable Claude Managed agent turn: replay-and-tail its Server-Sent Events. Resolves the per-conversation session owner by (agentId, conversationId), replays buffered events with seq greater than `after`, then live-tails if the turn is still running. Each event carries an SSE `id:` line with its durable seq; reconnect after a disconnect (tab reload, sleep, stream timeout) by passing the last seen id as `after` to resume without missing or duplicating events. The vocabulary follows the same negotiation as the execution stream (`?events=`, `X-Persona-Version`, then the default-sse-event-format flag).
+         */
+        get: {
+            parameters: {
+                query: {
+                    /** @description The conversation key that, with the agent id, resolves the durable session owner. */
+                    conversationId: string;
+                    /** @description Replay only events with seq greater than this value (the last seen SSE id). Defaults to 0. */
+                    after?: string;
+                };
+                header?: never;
+                path: {
+                    id: string;
+                    executionId: string;
+                };
+                cookie?: never;
+            };
+            requestBody?: never;
+            responses: {
+                /** @description Server-Sent Events stream (buffered replay followed by a live tail) */
+                200: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "text/event-stream": unknown;
+                    };
+                };
+                /** @description Invalid agent ID or missing conversationId */
+                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 Agent not found */
+                404: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["Error"];
+                    };
+                };
+                /** @description Internal server error */
+                500: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["Error"];
+                    };
+                };
+                /** @description Failed to attach to the execution stream */
+                502: {
+                    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}/executions/{executionId}/tool-calls": {
         parameters: {
             query?: never;
@@ -3380,6 +3481,189 @@ interface paths {
         patch?: never;
         trace?: never;
     };
+    "/v1/agents/{id}/runs": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /**
+         * List managed agent runs
+         * @description List the durable per-turn run summaries for a saved Claude Managed agent, newest first, optionally scoped to one conversation. Each row is written when a managed turn settles. Auth: agent ownership + AGENTS:READ (the same trust level as the events reconnect route).
+         */
+        get: {
+            parameters: {
+                query?: {
+                    /** @description Scope to a single conversation key. */
+                    conversationId?: string;
+                    /** @description Max rows to return (default 50, capped at 200). */
+                    limit?: number;
+                };
+                header?: never;
+                path: {
+                    id: string;
+                };
+                cookie?: never;
+            };
+            requestBody?: never;
+            responses: {
+                /** @description The agent run summaries */
+                200: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": {
+                            runs: components["schemas"]["ManagedAgentRunSummary"][];
+                        };
+                    };
+                };
+                /** @description Invalid agent ID */
+                400: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["Error"];
+                    };
+                };
+                /** @description Unauthorized */
+                401: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["Error"];
+                    };
+                };
+                /** @description Insufficient permissions */
+                403: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["Error"];
+                    };
+                };
+                /** @description Agent not found */
+                404: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["Error"];
+                    };
+                };
+                /** @description Internal server error */
+                500: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["Error"];
+                    };
+                };
+            };
+        };
+        put?: never;
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/v1/agents/{id}/runs/{runId}": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /**
+         * Get a managed agent run
+         * @description Fetch one durable run summary plus its deliverable pointers (the swept `/mnt/session/outputs/` files; the bytes live in asset storage). Auth: agent ownership + AGENTS:READ.
+         */
+        get: {
+            parameters: {
+                query?: never;
+                header?: never;
+                path: {
+                    id: string;
+                    runId: string;
+                };
+                cookie?: never;
+            };
+            requestBody?: never;
+            responses: {
+                /** @description The run summary and its deliverables */
+                200: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": {
+                            outputs: components["schemas"]["ManagedAgentRunOutput"][];
+                            run: components["schemas"]["ManagedAgentRunSummary"];
+                        };
+                    };
+                };
+                /** @description Invalid agent ID */
+                400: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["Error"];
+                    };
+                };
+                /** @description Unauthorized */
+                401: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["Error"];
+                    };
+                };
+                /** @description Insufficient permissions */
+                403: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["Error"];
+                    };
+                };
+                /** @description Agent or run not found */
+                404: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["Error"];
+                    };
+                };
+                /** @description Internal server error */
+                500: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["Error"];
+                    };
+                };
+            };
+        };
+        put?: never;
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
     "/v1/agents/{id}/voice": {
         parameters: {
             query?: never;
@@ -36717,7 +37001,9 @@ interface components {
             /** @enum {string} */
             type: "approval_complete";
         } | {
+            awaitReason?: string;
             awaitedAt?: string;
+            crawlId?: string;
             executionId: string;
             /** @enum {string} */
             origin?: "webmcp" | "sdk";
@@ -36726,6 +37012,7 @@ interface components {
                 [key: string]: unknown;
             };
             seq: number;
+            stepId?: string;
             toolCallId?: string;
             toolId?: string;
             toolName?: string;
@@ -36885,7 +37172,9 @@ interface components {
             type: "flow_error";
             upgradeUrl?: string;
         } | {
+            awaitReason?: string;
             awaitedAt: string;
+            crawlId?: string;
             executionId?: string;
             flowId: string;
             /** @enum {string} */
@@ -36895,6 +37184,7 @@ interface components {
                 [key: string]: unknown;
             };
             seq?: number;
+            stepId?: string;
             toolCallId?: string;
             toolId?: string;
             toolName?: string;
@@ -37186,6 +37476,39 @@ interface components {
             valid: boolean;
             warnings: components["schemas"]["FlowValidationIssue"][];
         };
+        ManagedAgentRunOutput: {
+            anthropicFileId: string;
+            /** @description Asset-storage key the bytes were persisted to. */
+            assetRef: string | null;
+            createdAt: string;
+            filename: string;
+            /** @description Deliverable pointer id (typeid, `mao_…`). */
+            id: string;
+            mimeType: string;
+            sizeBytes: number;
+        };
+        ManagedAgentRunSummary: {
+            agentId: string;
+            conversationId: string;
+            /** @description Cost in thousandths of a cent ($1 = 100,000). */
+            costThousandths: number;
+            createdAt: string;
+            error: string | null;
+            /** @description The DO-minted execution id for the turn. */
+            executionId: string;
+            /** @description The final assistant text (may be large or null). */
+            finalText: string | null;
+            /** @description Run id (typeid, `mar_…`). */
+            id: string;
+            inputTokens: number;
+            /** @description The durable seq at settle (reconnect ceiling). */
+            lastEventSeq: number;
+            outputTokens: number;
+            settledAt: string;
+            startedAt: string;
+            /** @description 'completed' | 'failed' | 'interrupted'. */
+            status: string;
+        };
         Pagination: {
             currentOffset: number;
             currentPage?: number;

package/dist/index.mjs

@@ -6002,7 +6002,7 @@ var Runtype = class {
 
 // src/version.ts
 var FALLBACK_VERSION = "0.0.0";
-var SDK_VERSION = "5.6.0".length > 0 ? "5.6.0" : FALLBACK_VERSION;
+var SDK_VERSION = "5.7.0".length > 0 ? "5.7.0" : FALLBACK_VERSION;
 var RUNTYPE_CLIENT_KIND = "sdk";
 var SDK_USER_AGENT = `runtype-sdk/${SDK_VERSION} (typescript)`;
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@runtypelabs/sdk",
-  "version": "5.6.0",
+  "version": "5.7.0",
   "type": "module",
   "description": "TypeScript SDK for the Runtype API with fluent methods. Use it to quickly realize AI products, agents, and workflows.",
   "main": "dist/index.cjs",