@runtypelabs/sdk 10.12.1 → 10.13.2

package/dist/index.cjs

@@ -14445,7 +14445,7 @@ function transformQueryParams(params) {
 }
 //#endregion
 //#region src/version.ts
-const SDK_VERSION = "10.12.1";
+const SDK_VERSION = "10.13.2";
 /**
 * Canonical client identity the API uses for attribution
 * (`detectActorSource` in apps/api/src/lib/audit-log.ts keys `'sdk'` off the

package/dist/index.d.cts

@@ -1125,6 +1125,8 @@ interface paths {
               };
               tools?: {
                 approval?: {
+                  /** @enum {string} */
+                  approver?: "owner" | "end-user";
                   choices?: {
                     alwaysAllow?: boolean;
                     alwaysDeny?: boolean;
@@ -1213,6 +1215,7 @@ interface paths {
               topK?: number;
               topP?: number;
               voice?: {
+                disclosure?: boolean;
                 elevenLabs?: {
                   modelId?: string;
                   similarity?: number;
@@ -1656,6 +1659,8 @@ interface paths {
                 };
                 tools?: {
                   approval?: {
+                    /** @enum {string} */
+                    approver?: "owner" | "end-user";
                     choices?: {
                       alwaysAllow?: boolean;
                       alwaysDeny?: boolean;
@@ -1744,6 +1749,7 @@ interface paths {
                 topK?: number;
                 topP?: number;
                 voice?: {
+                  disclosure?: boolean;
                   elevenLabs?: {
                     modelId?: string;
                     similarity?: number;
@@ -2234,7 +2240,10 @@ interface paths {
     put: {
       parameters: {
         query?: never;
-        header?: never;
+        header?: {
+          /** @description The updatedAt value last loaded. A stale revision returns 409 without saving. */
+          "if-match"?: string;
+        };
         path: {
           id: string;
         };
@@ -2245,6 +2254,21 @@ interface paths {
           "application/json": {
             /** @enum {string} */
             agentType?: "runtype" | "external" | "claude_managed";
+            /** @description Capability additions and removals committed with the definition and its draft snapshot. If-Match guards the entire save. */
+            capabilityChanges?: {
+              /** @default [] */
+              add?: {
+                enabled?: boolean;
+                flowId?: string;
+                parametersSchema?: unknown;
+                subAgentId?: string;
+                toolDescription?: string;
+                toolId?: string;
+                toolName: string;
+              }[];
+              /** @default [] */
+              remove?: string[];
+            };
             claudeManagedConfig?: {
               anthropicAgentId?: string;
               anthropicAgentVersion?: number;
@@ -2460,6 +2484,8 @@ interface paths {
               };
               tools?: {
                 approval?: {
+                  /** @enum {string} */
+                  approver?: "owner" | "end-user";
                   choices?: {
                     alwaysAllow?: boolean;
                     alwaysDeny?: boolean;
@@ -2548,6 +2574,7 @@ interface paths {
               topK?: number;
               topP?: number;
               voice?: {
+                disclosure?: boolean;
                 elevenLabs?: {
                   modelId?: string;
                   similarity?: number;
@@ -2714,7 +2741,7 @@ interface paths {
                 requested: string;
                 supported: string[];
               }[];
-              /** @description The snapshot created by this update, or null if snapshot creation failed. Use this exact ID for save-and-publish; a null result requires another save before publishing. */
+              /** @description The snapshot committed with this update, or the current draft snapshot for an unchanged definition. Save repairs a missing snapshot without changing the definition revision. Definition, capability, and snapshot failures roll back together. */
               savedVersionId: string | null;
               status: string;
               updatedAt: string;
@@ -2767,6 +2794,15 @@ interface paths {
             "application/json": components["schemas"]["Error"];
           };
         };
+        /** @description The saved agent revision changed; local edits were not saved */
+        409: {
+          headers: {
+            [name: string]: unknown;
+          };
+          content: {
+            "application/json": components["schemas"]["Error"];
+          };
+        };
         /** @description Internal server error */
         500: {
           headers: {
@@ -8936,6 +8972,126 @@ interface paths {
     patch?: never;
     trace?: never;
   };
+  "/v1/client/approve": {
+    parameters: {
+      query?: never;
+      header?: never;
+      path?: never;
+      cookie?: never;
+    };
+    get?: never;
+    put?: never;
+    /**
+     * Answer an end-user approval gate
+     * @description Session-authenticated approval for browser client-token sessions. Answers a paused approval whose gate the agent authored with `tools.approval.approver: 'end-user'`, then streams the continued run over Server-Sent Events in the same shape as `/v1/client/resume`. The decision is bound to the session that started the turn, single-use, and bound to the exact reviewed tool parameters; visitors cannot create persistent "always allow" grants. A gate with the default `owner` approver is refused with `403 APPROVAL_APPROVER_NOT_END_USER`; answer those with `POST /v1/dispatch/approve`. Does not count against execution limits.
+     */
+    post: {
+      parameters: {
+        query?: never;
+        header?: never;
+        path?: never;
+        cookie?: never;
+      };
+      requestBody: {
+        content: {
+          "application/json": {
+            /** @description The `approvalId` from the `approval_start` event this decision answers. */
+            approvalId: string;
+            /** @description Id for the assistant message this resumed leg produces, so a re-send deduplicates by id. Optional; same contract as `/v1/client/resume`. */
+            assistantMessageId?: string;
+            /** @enum {string} */
+            decision: "approved" | "denied";
+            executionId: string;
+            /** @description The visitor's own note on the decision, recorded with it. Optional. */
+            reason?: string;
+            sessionId: string;
+            /** @default true */
+            streamResponse?: boolean;
+          };
+        };
+      };
+      responses: {
+        /** @description SSE stream of the continued execution, or a buffered JSON continuation result when streamResponse is false */
+        200: {
+          headers: {
+            [name: string]: unknown;
+          };
+          content: {
+            "application/json": components["schemas"]["DispatchToolOutputContinuationJsonResponse"];
+            "text/event-stream": unknown;
+          };
+        };
+        /** @description Validation error, or the approvalId does not match the pending approval */
+        400: {
+          headers: {
+            [name: string]: unknown;
+          };
+          content: {
+            "application/json": components["schemas"]["Error"];
+          };
+        };
+        /** @description Session not found or expired */
+        401: {
+          headers: {
+            [name: string]: unknown;
+          };
+          content: {
+            "application/json": components["schemas"]["Error"];
+          };
+        };
+        /** @description Client token inactive, origin mismatch, execution belongs to another session, or the gate needs the owner (`APPROVAL_APPROVER_NOT_END_USER`) */
+        403: {
+          headers: {
+            [name: string]: unknown;
+          };
+          content: {
+            "application/json": components["schemas"]["Error"];
+          };
+        };
+        /** @description No paused execution found for the executionId, or the approval expired */
+        404: {
+          headers: {
+            [name: string]: unknown;
+          };
+          content: {
+            "application/json": components["schemas"]["Error"];
+          };
+        };
+        /** @description The approval was already resolved (`APPROVAL_ALREADY_RESOLVED`) */
+        409: {
+          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 Neutral service-unavailable response when the owner platform-key spend limit blocks an end-user continuation */
+        503: {
+          headers: {
+            [name: string]: unknown;
+          };
+          content: {
+            "application/json": components["schemas"]["Error"];
+          };
+        };
+      };
+    };
+    delete?: never;
+    options?: never;
+    head?: never;
+    patch?: never;
+    trace?: never;
+  };
   "/v1/client/chat": {
     parameters: {
       query?: never;
@@ -13790,6 +13946,7 @@ interface paths {
               topP?: number;
               versionId?: string;
               voice?: {
+                disclosure?: boolean;
                 elevenLabs?: {
                   modelId?: string;
                   similarity?: number;
@@ -14240,6 +14397,7 @@ interface paths {
               topP?: number;
               versionId?: string;
               voice?: {
+                disclosure?: boolean;
                 elevenLabs?: {
                   modelId?: string;
                   similarity?: number;
@@ -51784,6 +51942,8 @@ interface components {
           };
           tools?: {
             approval?: {
+              /** @enum {string} */
+              approver?: "owner" | "end-user";
               choices?: {
                 alwaysAllow?: boolean;
                 alwaysDeny?: boolean;
@@ -51872,6 +52032,7 @@ interface components {
           topK?: number;
           topP?: number;
           voice?: {
+            disclosure?: boolean;
             elevenLabs?: {
               modelId?: string;
               similarity?: number;
@@ -52561,6 +52722,8 @@ interface components {
         };
         tools?: {
           approval?: {
+            /** @enum {string} */
+            approver?: "owner" | "end-user";
             choices?: {
               alwaysAllow?: boolean;
               alwaysDeny?: boolean;
@@ -52649,6 +52812,7 @@ interface components {
         topK?: number;
         topP?: number;
         voice?: {
+          disclosure?: boolean;
           elevenLabs?: {
             modelId?: string;
             similarity?: number;

package/dist/index.d.ts

@@ -1125,6 +1125,8 @@ interface paths {
               };
               tools?: {
                 approval?: {
+                  /** @enum {string} */
+                  approver?: "owner" | "end-user";
                   choices?: {
                     alwaysAllow?: boolean;
                     alwaysDeny?: boolean;
@@ -1213,6 +1215,7 @@ interface paths {
               topK?: number;
               topP?: number;
               voice?: {
+                disclosure?: boolean;
                 elevenLabs?: {
                   modelId?: string;
                   similarity?: number;
@@ -1656,6 +1659,8 @@ interface paths {
                 };
                 tools?: {
                   approval?: {
+                    /** @enum {string} */
+                    approver?: "owner" | "end-user";
                     choices?: {
                       alwaysAllow?: boolean;
                       alwaysDeny?: boolean;
@@ -1744,6 +1749,7 @@ interface paths {
                 topK?: number;
                 topP?: number;
                 voice?: {
+                  disclosure?: boolean;
                   elevenLabs?: {
                     modelId?: string;
                     similarity?: number;
@@ -2234,7 +2240,10 @@ interface paths {
     put: {
       parameters: {
         query?: never;
-        header?: never;
+        header?: {
+          /** @description The updatedAt value last loaded. A stale revision returns 409 without saving. */
+          "if-match"?: string;
+        };
         path: {
           id: string;
         };
@@ -2245,6 +2254,21 @@ interface paths {
           "application/json": {
             /** @enum {string} */
             agentType?: "runtype" | "external" | "claude_managed";
+            /** @description Capability additions and removals committed with the definition and its draft snapshot. If-Match guards the entire save. */
+            capabilityChanges?: {
+              /** @default [] */
+              add?: {
+                enabled?: boolean;
+                flowId?: string;
+                parametersSchema?: unknown;
+                subAgentId?: string;
+                toolDescription?: string;
+                toolId?: string;
+                toolName: string;
+              }[];
+              /** @default [] */
+              remove?: string[];
+            };
             claudeManagedConfig?: {
               anthropicAgentId?: string;
               anthropicAgentVersion?: number;
@@ -2460,6 +2484,8 @@ interface paths {
               };
               tools?: {
                 approval?: {
+                  /** @enum {string} */
+                  approver?: "owner" | "end-user";
                   choices?: {
                     alwaysAllow?: boolean;
                     alwaysDeny?: boolean;
@@ -2548,6 +2574,7 @@ interface paths {
               topK?: number;
               topP?: number;
               voice?: {
+                disclosure?: boolean;
                 elevenLabs?: {
                   modelId?: string;
                   similarity?: number;
@@ -2714,7 +2741,7 @@ interface paths {
                 requested: string;
                 supported: string[];
               }[];
-              /** @description The snapshot created by this update, or null if snapshot creation failed. Use this exact ID for save-and-publish; a null result requires another save before publishing. */
+              /** @description The snapshot committed with this update, or the current draft snapshot for an unchanged definition. Save repairs a missing snapshot without changing the definition revision. Definition, capability, and snapshot failures roll back together. */
               savedVersionId: string | null;
               status: string;
               updatedAt: string;
@@ -2767,6 +2794,15 @@ interface paths {
             "application/json": components["schemas"]["Error"];
           };
         };
+        /** @description The saved agent revision changed; local edits were not saved */
+        409: {
+          headers: {
+            [name: string]: unknown;
+          };
+          content: {
+            "application/json": components["schemas"]["Error"];
+          };
+        };
         /** @description Internal server error */
         500: {
           headers: {
@@ -8936,6 +8972,126 @@ interface paths {
     patch?: never;
     trace?: never;
   };
+  "/v1/client/approve": {
+    parameters: {
+      query?: never;
+      header?: never;
+      path?: never;
+      cookie?: never;
+    };
+    get?: never;
+    put?: never;
+    /**
+     * Answer an end-user approval gate
+     * @description Session-authenticated approval for browser client-token sessions. Answers a paused approval whose gate the agent authored with `tools.approval.approver: 'end-user'`, then streams the continued run over Server-Sent Events in the same shape as `/v1/client/resume`. The decision is bound to the session that started the turn, single-use, and bound to the exact reviewed tool parameters; visitors cannot create persistent "always allow" grants. A gate with the default `owner` approver is refused with `403 APPROVAL_APPROVER_NOT_END_USER`; answer those with `POST /v1/dispatch/approve`. Does not count against execution limits.
+     */
+    post: {
+      parameters: {
+        query?: never;
+        header?: never;
+        path?: never;
+        cookie?: never;
+      };
+      requestBody: {
+        content: {
+          "application/json": {
+            /** @description The `approvalId` from the `approval_start` event this decision answers. */
+            approvalId: string;
+            /** @description Id for the assistant message this resumed leg produces, so a re-send deduplicates by id. Optional; same contract as `/v1/client/resume`. */
+            assistantMessageId?: string;
+            /** @enum {string} */
+            decision: "approved" | "denied";
+            executionId: string;
+            /** @description The visitor's own note on the decision, recorded with it. Optional. */
+            reason?: string;
+            sessionId: string;
+            /** @default true */
+            streamResponse?: boolean;
+          };
+        };
+      };
+      responses: {
+        /** @description SSE stream of the continued execution, or a buffered JSON continuation result when streamResponse is false */
+        200: {
+          headers: {
+            [name: string]: unknown;
+          };
+          content: {
+            "application/json": components["schemas"]["DispatchToolOutputContinuationJsonResponse"];
+            "text/event-stream": unknown;
+          };
+        };
+        /** @description Validation error, or the approvalId does not match the pending approval */
+        400: {
+          headers: {
+            [name: string]: unknown;
+          };
+          content: {
+            "application/json": components["schemas"]["Error"];
+          };
+        };
+        /** @description Session not found or expired */
+        401: {
+          headers: {
+            [name: string]: unknown;
+          };
+          content: {
+            "application/json": components["schemas"]["Error"];
+          };
+        };
+        /** @description Client token inactive, origin mismatch, execution belongs to another session, or the gate needs the owner (`APPROVAL_APPROVER_NOT_END_USER`) */
+        403: {
+          headers: {
+            [name: string]: unknown;
+          };
+          content: {
+            "application/json": components["schemas"]["Error"];
+          };
+        };
+        /** @description No paused execution found for the executionId, or the approval expired */
+        404: {
+          headers: {
+            [name: string]: unknown;
+          };
+          content: {
+            "application/json": components["schemas"]["Error"];
+          };
+        };
+        /** @description The approval was already resolved (`APPROVAL_ALREADY_RESOLVED`) */
+        409: {
+          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 Neutral service-unavailable response when the owner platform-key spend limit blocks an end-user continuation */
+        503: {
+          headers: {
+            [name: string]: unknown;
+          };
+          content: {
+            "application/json": components["schemas"]["Error"];
+          };
+        };
+      };
+    };
+    delete?: never;
+    options?: never;
+    head?: never;
+    patch?: never;
+    trace?: never;
+  };
   "/v1/client/chat": {
     parameters: {
       query?: never;
@@ -13790,6 +13946,7 @@ interface paths {
               topP?: number;
               versionId?: string;
               voice?: {
+                disclosure?: boolean;
                 elevenLabs?: {
                   modelId?: string;
                   similarity?: number;
@@ -14240,6 +14397,7 @@ interface paths {
               topP?: number;
               versionId?: string;
               voice?: {
+                disclosure?: boolean;
                 elevenLabs?: {
                   modelId?: string;
                   similarity?: number;
@@ -51784,6 +51942,8 @@ interface components {
           };
           tools?: {
             approval?: {
+              /** @enum {string} */
+              approver?: "owner" | "end-user";
               choices?: {
                 alwaysAllow?: boolean;
                 alwaysDeny?: boolean;
@@ -51872,6 +52032,7 @@ interface components {
           topK?: number;
           topP?: number;
           voice?: {
+            disclosure?: boolean;
             elevenLabs?: {
               modelId?: string;
               similarity?: number;
@@ -52561,6 +52722,8 @@ interface components {
         };
         tools?: {
           approval?: {
+            /** @enum {string} */
+            approver?: "owner" | "end-user";
             choices?: {
               alwaysAllow?: boolean;
               alwaysDeny?: boolean;
@@ -52649,6 +52812,7 @@ interface components {
         topK?: number;
         topP?: number;
         voice?: {
+          disclosure?: boolean;
           elevenLabs?: {
             modelId?: string;
             similarity?: number;

package/dist/index.mjs

@@ -14444,7 +14444,7 @@ function transformQueryParams(params) {
 }
 //#endregion
 //#region src/version.ts
-const SDK_VERSION = "10.12.1";
+const SDK_VERSION = "10.13.2";
 /**
 * Canonical client identity the API uses for attribution
 * (`detectActorSource` in apps/api/src/lib/audit-log.ts keys `'sdk'` off the

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@runtypelabs/sdk",
-  "version": "10.12.1",
+  "version": "10.13.2",
   "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",
@@ -24,7 +24,7 @@
   ],
   "dependencies": {},
   "devDependencies": {
-    "@runtypelabs/shared": "3.73.0",
+    "@runtypelabs/shared": "3.75.1",
     "openapi-typescript": "^7.13.0",
     "tsdown": "^0.23.0",
     "typescript": "^6.0.3",