@runtypelabs/sdk 10.6.0 → 10.7.0

package/dist/index.cjs

@@ -5784,10 +5784,12 @@ var AgentsEndpoint = class AgentsEndpoint {
 		return this.client.delete(`/agents/${id}`);
 	}
 	/**
-	* Export an agent as a self-contained runtime definition for @runtypelabs/runtime
+	* Export an agent as a self-contained runtime definition for @runtypelabs/runtime.
+	* Pass `versionId` or `alias` (at most one) to export a published version or the
+	* version a release alias points at; the result's `release` records which one.
 	*/
-	async exportRuntime(id) {
-		return this.client.get(`/agents/${id}/export-runtime`);
+	async exportRuntime(id, selector) {
+		return this.client.get(`/agents/${id}/export-runtime`, selector);
 	}
 	/**
 	* Roll up the agent's most recent runs: per-version and per-tool counts,
@@ -13481,7 +13483,7 @@ function transformQueryParams(params) {
 }
 //#endregion
 //#region src/version.ts
-const SDK_VERSION = "10.6.0";
+const SDK_VERSION = "10.7.0";
 /**
 * 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

@@ -5257,13 +5257,20 @@ interface paths {
     };
     /**
      * Export agent for runtime
-     * @description Export a fully-resolved, self-contained agent definition that the @runtypelabs/runtime package can consume directly at boot. Capabilities, flows, and nested sub-agents are inlined recursively (up to 3 levels). MCP credential values and external-agent auth credentials are replaced with secret-name references. Requires the `RUNTIME:EXPORT` scope and an Enterprise plan (the `byoc` entitlement); an unentitled account receives `403` with code `BYOC_PLAN_REQUIRED` in every environment.
+     * @description Export a fully-resolved, self-contained agent definition that the @runtypelabs/runtime package can consume directly at boot. Capabilities, flows, and nested sub-agents are inlined recursively (up to 3 levels). Skills bound to the agent are snapshotted into `skills`, each with the skill version it resolved to, and the runtime loads them with no host wiring. MCP credential values and external-agent auth credentials are replaced with secret-name references. Requires the `RUNTIME:EXPORT` scope and an Enterprise plan (the `byoc` entitlement); an unentitled account receives `403` with code `BYOC_PLAN_REQUIRED` in every environment.
      *
      *     The response carries `hostDependencies`: the runtime seams the exported artifact needs a host to wire before it can run everything it describes. A durable-class step (`wait-until` or `crawl`) anywhere in the agent's executable closure declares a `durable-pause-host` dependency; a detached-capable dynamic subagent pool or a detached inline subagent tool declares a `background-run-coordinator` dependency. The array is empty when nothing needs wiring.
+     *
+     *     Pass at most one release selector. `versionId` exports that published version; `alias` exports the version a release alias (for example `staging`, `live` or `pr-42`) currently points at, resolved exactly as the execution selector `agent: { agentId, alias }` resolves it. With neither, the export follows the agent's default target: the version its `live` alias names when the org runs on release aliases, otherwise the agent's current definition. A version-backed export carries `release` with the resolved `versionId`, plus `alias` and `aliasRevision` when an alias selected it. An unknown version or alias, or an archived or expired alias, answers `404`.
      */
     get: {
       parameters: {
-        query?: never;
+        query?: {
+          /** @description Export this published agent version. Mutually exclusive with `alias`. */
+          versionId?: string;
+          /** @description Export the version this release alias currently points at. Mutually exclusive with `versionId`. */
+          alias?: string;
+        };
         header?: never;
         path: {
           id: string;
@@ -5294,10 +5301,18 @@ interface paths {
               hostDependencies: components["schemas"]["RuntimeHostDependency"][];
               id: string;
               name: string;
+              /** @description The published version this export contains. `alias` and `aliasRevision` are present when a release alias selected it. Absent when the export read the agent's current definition. */
+              release?: {
+                alias?: string;
+                aliasRevision?: number;
+                versionId: string;
+              };
+              /** @description Skills bound to the agent, snapshotted with the skill version each resolved to. `executeAgent` loads them with no host wiring. Absent when the agent has no bound skills. */
+              skills?: components["schemas"]["RuntimeExportedSkill"][];
             };
           };
         };
-        /** @description Invalid agent ID */
+        /** @description Invalid agent ID, or both `versionId` and `alias` were supplied */
         400: {
           headers: {
             [name: string]: unknown;
@@ -5324,7 +5339,7 @@ interface paths {
             "application/json": components["schemas"]["Error"];
           };
         };
-        /** @description Agent not found */
+        /** @description Agent not found, or the selected version or alias does not exist, is archived, or has expired */
         404: {
           headers: {
             [name: string]: unknown;
@@ -5333,6 +5348,15 @@ interface paths {
             "application/json": components["schemas"]["Error"];
           };
         };
+        /** @description The agent type cannot export a selected version */
+        422: {
+          headers: {
+            [name: string]: unknown;
+          };
+          content: {
+            "application/json": components["schemas"]["Error"];
+          };
+        };
         /** @description Internal server error */
         500: {
           headers: {
@@ -30220,7 +30244,9 @@ interface paths {
               data: {
                 canvas?: unknown;
                 capabilities: {
+                  agentId: string | null;
                   capabilityName: string;
+                  flowId: string | null;
                 }[];
                 capabilityCount: number;
                 createdAt: string;
@@ -51881,6 +51907,10 @@ interface components {
     };
     DispatchAgentJsonResponse: {
       agentExecutionId?: string;
+      /** @description The published agent version the run executed. Absent when no stored version ran. */
+      agentVersionId?: string;
+      /** @description The release alias (for example `live`) the version was resolved through, when one was. */
+      alias?: string;
       blockReason?: string;
       claudeManagedAgentId?: string;
       code?: string;
@@ -53886,6 +53916,19 @@ interface components {
       error: string;
       message?: string;
     };
+    RuntimeExportedSkill: {
+      approvalDelta: string[];
+      body: string;
+      description: string;
+      resolvedTools: {
+        [key: string]: unknown;
+      }[];
+      skillId?: string;
+      /** @description The skill version this snapshot was resolved from. */
+      skillVersionId?: string;
+      /** @description Skill slug; the agent loads it as `skill:<slug>`. */
+      slug: string;
+    };
     RuntimeHostDependency: {
       interface: string;
       /** @enum {string} */
@@ -65148,9 +65191,14 @@ export declare class AgentsEndpoint {
    */
   delete(id: string): Promise<void>;
   /**
-   * Export an agent as a self-contained runtime definition for @runtypelabs/runtime
+   * Export an agent as a self-contained runtime definition for @runtypelabs/runtime.
+   * Pass `versionId` or `alias` (at most one) to export a published version or the
+   * version a release alias points at; the result's `release` records which one.
    */
-  exportRuntime(id: string): Promise<any>;
+  exportRuntime(id: string, selector?: {
+    versionId?: string;
+    alias?: string;
+  }): Promise<any>;
   /**
    * Roll up the agent's most recent runs: per-version and per-tool counts,
    * average tokens and cost, and which attached tools were never called.

package/dist/index.d.ts

@@ -5257,13 +5257,20 @@ interface paths {
     };
     /**
      * Export agent for runtime
-     * @description Export a fully-resolved, self-contained agent definition that the @runtypelabs/runtime package can consume directly at boot. Capabilities, flows, and nested sub-agents are inlined recursively (up to 3 levels). MCP credential values and external-agent auth credentials are replaced with secret-name references. Requires the `RUNTIME:EXPORT` scope and an Enterprise plan (the `byoc` entitlement); an unentitled account receives `403` with code `BYOC_PLAN_REQUIRED` in every environment.
+     * @description Export a fully-resolved, self-contained agent definition that the @runtypelabs/runtime package can consume directly at boot. Capabilities, flows, and nested sub-agents are inlined recursively (up to 3 levels). Skills bound to the agent are snapshotted into `skills`, each with the skill version it resolved to, and the runtime loads them with no host wiring. MCP credential values and external-agent auth credentials are replaced with secret-name references. Requires the `RUNTIME:EXPORT` scope and an Enterprise plan (the `byoc` entitlement); an unentitled account receives `403` with code `BYOC_PLAN_REQUIRED` in every environment.
      *
      *     The response carries `hostDependencies`: the runtime seams the exported artifact needs a host to wire before it can run everything it describes. A durable-class step (`wait-until` or `crawl`) anywhere in the agent's executable closure declares a `durable-pause-host` dependency; a detached-capable dynamic subagent pool or a detached inline subagent tool declares a `background-run-coordinator` dependency. The array is empty when nothing needs wiring.
+     *
+     *     Pass at most one release selector. `versionId` exports that published version; `alias` exports the version a release alias (for example `staging`, `live` or `pr-42`) currently points at, resolved exactly as the execution selector `agent: { agentId, alias }` resolves it. With neither, the export follows the agent's default target: the version its `live` alias names when the org runs on release aliases, otherwise the agent's current definition. A version-backed export carries `release` with the resolved `versionId`, plus `alias` and `aliasRevision` when an alias selected it. An unknown version or alias, or an archived or expired alias, answers `404`.
      */
     get: {
       parameters: {
-        query?: never;
+        query?: {
+          /** @description Export this published agent version. Mutually exclusive with `alias`. */
+          versionId?: string;
+          /** @description Export the version this release alias currently points at. Mutually exclusive with `versionId`. */
+          alias?: string;
+        };
         header?: never;
         path: {
           id: string;
@@ -5294,10 +5301,18 @@ interface paths {
               hostDependencies: components["schemas"]["RuntimeHostDependency"][];
               id: string;
               name: string;
+              /** @description The published version this export contains. `alias` and `aliasRevision` are present when a release alias selected it. Absent when the export read the agent's current definition. */
+              release?: {
+                alias?: string;
+                aliasRevision?: number;
+                versionId: string;
+              };
+              /** @description Skills bound to the agent, snapshotted with the skill version each resolved to. `executeAgent` loads them with no host wiring. Absent when the agent has no bound skills. */
+              skills?: components["schemas"]["RuntimeExportedSkill"][];
             };
           };
         };
-        /** @description Invalid agent ID */
+        /** @description Invalid agent ID, or both `versionId` and `alias` were supplied */
         400: {
           headers: {
             [name: string]: unknown;
@@ -5324,7 +5339,7 @@ interface paths {
             "application/json": components["schemas"]["Error"];
           };
         };
-        /** @description Agent not found */
+        /** @description Agent not found, or the selected version or alias does not exist, is archived, or has expired */
         404: {
           headers: {
             [name: string]: unknown;
@@ -5333,6 +5348,15 @@ interface paths {
             "application/json": components["schemas"]["Error"];
           };
         };
+        /** @description The agent type cannot export a selected version */
+        422: {
+          headers: {
+            [name: string]: unknown;
+          };
+          content: {
+            "application/json": components["schemas"]["Error"];
+          };
+        };
         /** @description Internal server error */
         500: {
           headers: {
@@ -30220,7 +30244,9 @@ interface paths {
               data: {
                 canvas?: unknown;
                 capabilities: {
+                  agentId: string | null;
                   capabilityName: string;
+                  flowId: string | null;
                 }[];
                 capabilityCount: number;
                 createdAt: string;
@@ -51881,6 +51907,10 @@ interface components {
     };
     DispatchAgentJsonResponse: {
       agentExecutionId?: string;
+      /** @description The published agent version the run executed. Absent when no stored version ran. */
+      agentVersionId?: string;
+      /** @description The release alias (for example `live`) the version was resolved through, when one was. */
+      alias?: string;
       blockReason?: string;
       claudeManagedAgentId?: string;
       code?: string;
@@ -53886,6 +53916,19 @@ interface components {
       error: string;
       message?: string;
     };
+    RuntimeExportedSkill: {
+      approvalDelta: string[];
+      body: string;
+      description: string;
+      resolvedTools: {
+        [key: string]: unknown;
+      }[];
+      skillId?: string;
+      /** @description The skill version this snapshot was resolved from. */
+      skillVersionId?: string;
+      /** @description Skill slug; the agent loads it as `skill:<slug>`. */
+      slug: string;
+    };
     RuntimeHostDependency: {
       interface: string;
       /** @enum {string} */
@@ -65148,9 +65191,14 @@ export declare class AgentsEndpoint {
    */
   delete(id: string): Promise<void>;
   /**
-   * Export an agent as a self-contained runtime definition for @runtypelabs/runtime
+   * Export an agent as a self-contained runtime definition for @runtypelabs/runtime.
+   * Pass `versionId` or `alias` (at most one) to export a published version or the
+   * version a release alias points at; the result's `release` records which one.
    */
-  exportRuntime(id: string): Promise<any>;
+  exportRuntime(id: string, selector?: {
+    versionId?: string;
+    alias?: string;
+  }): Promise<any>;
   /**
    * Roll up the agent's most recent runs: per-version and per-tool counts,
    * average tokens and cost, and which attached tools were never called.

package/dist/index.mjs

@@ -5783,10 +5783,12 @@ var AgentsEndpoint = class AgentsEndpoint {
 		return this.client.delete(`/agents/${id}`);
 	}
 	/**
-	* Export an agent as a self-contained runtime definition for @runtypelabs/runtime
+	* Export an agent as a self-contained runtime definition for @runtypelabs/runtime.
+	* Pass `versionId` or `alias` (at most one) to export a published version or the
+	* version a release alias points at; the result's `release` records which one.
 	*/
-	async exportRuntime(id) {
-		return this.client.get(`/agents/${id}/export-runtime`);
+	async exportRuntime(id, selector) {
+		return this.client.get(`/agents/${id}/export-runtime`, selector);
 	}
 	/**
 	* Roll up the agent's most recent runs: per-version and per-tool counts,
@@ -13480,7 +13482,7 @@ function transformQueryParams(params) {
 }
 //#endregion
 //#region src/version.ts
-const SDK_VERSION = "10.6.0";
+const SDK_VERSION = "10.7.0";
 /**
 * 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.6.0",
+  "version": "10.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",
@@ -24,7 +24,7 @@
   ],
   "dependencies": {},
   "devDependencies": {
-    "@runtypelabs/shared": "3.67.0",
+    "@runtypelabs/shared": "3.68.0",
     "openapi-typescript": "^7.13.0",
     "tsdown": "^0.23.0",
     "typescript": "^6.0.3",