@runtypelabs/sdk 10.6.0 → 10.8.0

package/dist/index.cjs

@@ -5743,9 +5743,6 @@ function buildAgentAdmissionHeaders(options) {
 	if (options.idempotencyKey) headers["idempotency-key"] = options.idempotencyKey;
 	return headers;
 }
-/**
-* Agents endpoint handlers
-*/
 var AgentsEndpoint = class AgentsEndpoint {
 	constructor(client) {
 		this.client = client;
@@ -5784,10 +5781,30 @@ 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);
+	}
+	/**
+	* Export an agent as a vendorable zip: `agent.json`, the prebuilt `runtime/` package, `manifest.json`,
+	* and `LICENSE`. Two exports of the same version are byte-identical; `contentHash` pins them.
+	*/
+	async exportRuntimeBundle(id, selector) {
+		const query = new URLSearchParams({ format: "bundle" });
+		if (selector?.versionId !== void 0) query.set("versionId", selector.versionId);
+		if (selector?.alias !== void 0) query.set("alias", selector.alias);
+		const response = await this.client.requestStream(`/agents/${id}/export-runtime?${query}`, { method: "GET" });
+		const disposition = response.headers.get("Content-Disposition") ?? "";
+		return {
+			bytes: new Uint8Array(await response.arrayBuffer()),
+			fileName: /filename="([^"]+)"/.exec(disposition)?.[1] ?? `${id}-runtime-bundle.zip`,
+			contentHash: response.headers.get("X-Runtype-Bundle-Content-Hash"),
+			runtimeVersion: response.headers.get("X-Runtype-Runtime-Version"),
+			runtimeCommit: response.headers.get("X-Runtype-Runtime-Commit")
+		};
 	}
 	/**
 	* Roll up the agent's most recent runs: per-version and per-tool counts,
@@ -13481,7 +13498,7 @@ function transformQueryParams(params) {
 }
 //#endregion
 //#region src/version.ts
-const SDK_VERSION = "10.6.0";
+const SDK_VERSION = "10.8.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,22 @@ 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;
+          /** @description `json` (the default) returns the exported definition. `bundle` returns a vendorable `application/zip` with `agent.json` (the same definition), `runtime/` (the prebuilt `@runtypelabs/runtime` ESM package for the platform runtime version, installable as `file:./runtime`), `manifest.json`, and `LICENSE` (the runtime ships under FSL-1.1-ALv2). */
+          format?: "json" | "bundle";
+        };
         header?: never;
         path: {
           id: string;
@@ -5272,7 +5281,7 @@ interface paths {
       };
       requestBody?: never;
       responses: {
-        /** @description Exported agent definition */
+        /** @description Exported agent definition, or with `format=bundle` a zip archive. Two bundle exports of the same version are byte-identical. The bundle `manifest.json` records the runtime version and source commit, the agent `versionId`/alias, the entrypoints, `hostDependencies`, and `contentHash`: sha256 over the `sha256sum` listing (`<sha256>  <path>` lines sorted by path) of every file except `manifest.json`. The same hash is sent in the `X-Runtype-Bundle-Content-Hash` header. */
         200: {
           headers: {
             [name: string]: unknown;
@@ -5294,10 +5303,19 @@ 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"][];
             };
+            "application/zip": string;
           };
         };
-        /** @description Invalid agent ID */
+        /** @description Invalid agent ID, or both `versionId` and `alias` were supplied */
         400: {
           headers: {
             [name: string]: unknown;
@@ -5324,7 +5342,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 +5351,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: {
@@ -5342,6 +5369,15 @@ interface paths {
             "application/json": components["schemas"]["Error"];
           };
         };
+        /** @description With `format=bundle`: the prebuilt runtime artifact for this platform version is not available (code `RUNTIME_ARTIFACT_UNAVAILABLE`, with a `reason` such as `artifact_missing`) */
+        503: {
+          headers: {
+            [name: string]: unknown;
+          };
+          content: {
+            "application/json": components["schemas"]["Error"];
+          };
+        };
       };
     };
     put?: never;
@@ -30220,7 +30256,9 @@ interface paths {
               data: {
                 canvas?: unknown;
                 capabilities: {
+                  agentId: string | null;
                   capabilityName: string;
+                  flowId: string | null;
                 }[];
                 capabilityCount: number;
                 createdAt: string;
@@ -42419,15 +42457,6 @@ interface paths {
             "application/json": components["schemas"]["Error"];
           };
         };
-        /** @description Endpoint not yet available in this environment (the hosted runtime endpoint family is dark-launched and returns 404 until general availability) */
-        404: {
-          headers: {
-            [name: string]: unknown;
-          };
-          content: {
-            "application/json": components["schemas"]["Error"];
-          };
-        };
         /** @description Daily execution limit or rate limit exceeded */
         429: {
           headers: {
@@ -42605,15 +42634,6 @@ interface paths {
             "application/json": components["schemas"]["RuntimeEmailAdmissionError"];
           };
         };
-        /** @description Endpoint not yet available in this environment (the hosted runtime endpoint family is dark-launched and returns 404 until general availability) */
-        404: {
-          headers: {
-            [name: string]: unknown;
-          };
-          content: {
-            "application/json": components["schemas"]["Error"];
-          };
-        };
         /** @description Daily execution limit or rate limit exceeded */
         429: {
           headers: {
@@ -42764,15 +42784,6 @@ interface paths {
             "application/json": components["schemas"]["Error"];
           };
         };
-        /** @description Endpoint not yet available in this environment (the hosted runtime endpoint family is dark-launched and returns 404 until general availability) */
-        404: {
-          headers: {
-            [name: string]: unknown;
-          };
-          content: {
-            "application/json": components["schemas"]["Error"];
-          };
-        };
         /** @description Daily execution limit or rate limit exceeded */
         429: {
           headers: {
@@ -42906,15 +42917,6 @@ interface paths {
             "application/json": components["schemas"]["Error"];
           };
         };
-        /** @description Endpoint not yet available in this environment (the hosted runtime endpoint family is dark-launched and returns 404 until general availability) */
-        404: {
-          headers: {
-            [name: string]: unknown;
-          };
-          content: {
-            "application/json": components["schemas"]["Error"];
-          };
-        };
         /** @description Daily execution limit or rate limit exceeded */
         429: {
           headers: {
@@ -43040,15 +43042,6 @@ interface paths {
             "application/json": components["schemas"]["Error"];
           };
         };
-        /** @description Endpoint not yet available in this environment (the hosted runtime endpoint family is dark-launched and returns 404 until general availability) */
-        404: {
-          headers: {
-            [name: string]: unknown;
-          };
-          content: {
-            "application/json": components["schemas"]["Error"];
-          };
-        };
         /** @description Daily execution limit or rate limit exceeded */
         429: {
           headers: {
@@ -43198,15 +43191,6 @@ interface paths {
             "application/json": components["schemas"]["Error"];
           };
         };
-        /** @description Endpoint not yet available in this environment (the hosted runtime endpoint family is dark-launched and returns 404 until general availability) */
-        404: {
-          headers: {
-            [name: string]: unknown;
-          };
-          content: {
-            "application/json": components["schemas"]["Error"];
-          };
-        };
         /** @description Daily execution limit or rate limit exceeded */
         429: {
           headers: {
@@ -43365,15 +43349,6 @@ interface paths {
             "application/json": components["schemas"]["Error"];
           };
         };
-        /** @description Endpoint not yet available in this environment (the hosted runtime endpoint family is dark-launched and returns 404 until general availability) */
-        404: {
-          headers: {
-            [name: string]: unknown;
-          };
-          content: {
-            "application/json": components["schemas"]["Error"];
-          };
-        };
         /** @description Daily execution limit or rate limit exceeded */
         429: {
           headers: {
@@ -43512,15 +43487,6 @@ interface paths {
             "application/json": components["schemas"]["Error"];
           };
         };
-        /** @description Endpoint not yet available in this environment (the hosted runtime endpoint family is dark-launched and returns 404 until general availability) */
-        404: {
-          headers: {
-            [name: string]: unknown;
-          };
-          content: {
-            "application/json": components["schemas"]["Error"];
-          };
-        };
         /** @description Daily execution limit or rate limit exceeded */
         429: {
           headers: {
@@ -43661,15 +43627,6 @@ interface paths {
             "application/json": components["schemas"]["Error"];
           };
         };
-        /** @description Endpoint not yet available in this environment (the hosted runtime endpoint family is dark-launched and returns 404 until general availability) */
-        404: {
-          headers: {
-            [name: string]: unknown;
-          };
-          content: {
-            "application/json": components["schemas"]["Error"];
-          };
-        };
         /** @description Daily execution limit or rate limit exceeded */
         429: {
           headers: {
@@ -43819,15 +43776,6 @@ interface paths {
             "application/json": components["schemas"]["Error"];
           };
         };
-        /** @description Endpoint not yet available in this environment (the hosted runtime endpoint family is dark-launched and returns 404 until general availability) */
-        404: {
-          headers: {
-            [name: string]: unknown;
-          };
-          content: {
-            "application/json": components["schemas"]["Error"];
-          };
-        };
         /** @description Daily execution limit or rate limit exceeded */
         429: {
           headers: {
@@ -51881,6 +51829,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 +53838,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} */
@@ -65117,6 +65082,14 @@ export interface AgentRunInsightsResponse {
 /**
  * Agents endpoint handlers
  */
+/** A `format=bundle` agent runtime export: the zip bytes plus the identity headers the API sends with it. */
+export interface AgentRuntimeBundle {
+  bytes: Uint8Array;
+  fileName: string;
+  contentHash: string | null;
+  runtimeVersion: string | null;
+  runtimeCommit: string | null;
+}
 export declare class AgentsEndpoint {
   private client;
   private static readonly AUTO_COMPACT_SUMMARY_PREFIX;
@@ -65148,9 +65121,22 @@ 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>;
+  /**
+   * Export an agent as a vendorable zip: `agent.json`, the prebuilt `runtime/` package, `manifest.json`,
+   * and `LICENSE`. Two exports of the same version are byte-identical; `contentHash` pins them.
+   */
+  exportRuntimeBundle(id: string, selector?: {
+    versionId?: string;
+    alias?: string;
+  }): Promise<AgentRuntimeBundle>;
   /**
    * 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,22 @@ 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;
+          /** @description `json` (the default) returns the exported definition. `bundle` returns a vendorable `application/zip` with `agent.json` (the same definition), `runtime/` (the prebuilt `@runtypelabs/runtime` ESM package for the platform runtime version, installable as `file:./runtime`), `manifest.json`, and `LICENSE` (the runtime ships under FSL-1.1-ALv2). */
+          format?: "json" | "bundle";
+        };
         header?: never;
         path: {
           id: string;
@@ -5272,7 +5281,7 @@ interface paths {
       };
       requestBody?: never;
       responses: {
-        /** @description Exported agent definition */
+        /** @description Exported agent definition, or with `format=bundle` a zip archive. Two bundle exports of the same version are byte-identical. The bundle `manifest.json` records the runtime version and source commit, the agent `versionId`/alias, the entrypoints, `hostDependencies`, and `contentHash`: sha256 over the `sha256sum` listing (`<sha256>  <path>` lines sorted by path) of every file except `manifest.json`. The same hash is sent in the `X-Runtype-Bundle-Content-Hash` header. */
         200: {
           headers: {
             [name: string]: unknown;
@@ -5294,10 +5303,19 @@ 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"][];
             };
+            "application/zip": string;
           };
         };
-        /** @description Invalid agent ID */
+        /** @description Invalid agent ID, or both `versionId` and `alias` were supplied */
         400: {
           headers: {
             [name: string]: unknown;
@@ -5324,7 +5342,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 +5351,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: {
@@ -5342,6 +5369,15 @@ interface paths {
             "application/json": components["schemas"]["Error"];
           };
         };
+        /** @description With `format=bundle`: the prebuilt runtime artifact for this platform version is not available (code `RUNTIME_ARTIFACT_UNAVAILABLE`, with a `reason` such as `artifact_missing`) */
+        503: {
+          headers: {
+            [name: string]: unknown;
+          };
+          content: {
+            "application/json": components["schemas"]["Error"];
+          };
+        };
       };
     };
     put?: never;
@@ -30220,7 +30256,9 @@ interface paths {
               data: {
                 canvas?: unknown;
                 capabilities: {
+                  agentId: string | null;
                   capabilityName: string;
+                  flowId: string | null;
                 }[];
                 capabilityCount: number;
                 createdAt: string;
@@ -42419,15 +42457,6 @@ interface paths {
             "application/json": components["schemas"]["Error"];
           };
         };
-        /** @description Endpoint not yet available in this environment (the hosted runtime endpoint family is dark-launched and returns 404 until general availability) */
-        404: {
-          headers: {
-            [name: string]: unknown;
-          };
-          content: {
-            "application/json": components["schemas"]["Error"];
-          };
-        };
         /** @description Daily execution limit or rate limit exceeded */
         429: {
           headers: {
@@ -42605,15 +42634,6 @@ interface paths {
             "application/json": components["schemas"]["RuntimeEmailAdmissionError"];
           };
         };
-        /** @description Endpoint not yet available in this environment (the hosted runtime endpoint family is dark-launched and returns 404 until general availability) */
-        404: {
-          headers: {
-            [name: string]: unknown;
-          };
-          content: {
-            "application/json": components["schemas"]["Error"];
-          };
-        };
         /** @description Daily execution limit or rate limit exceeded */
         429: {
           headers: {
@@ -42764,15 +42784,6 @@ interface paths {
             "application/json": components["schemas"]["Error"];
           };
         };
-        /** @description Endpoint not yet available in this environment (the hosted runtime endpoint family is dark-launched and returns 404 until general availability) */
-        404: {
-          headers: {
-            [name: string]: unknown;
-          };
-          content: {
-            "application/json": components["schemas"]["Error"];
-          };
-        };
         /** @description Daily execution limit or rate limit exceeded */
         429: {
           headers: {
@@ -42906,15 +42917,6 @@ interface paths {
             "application/json": components["schemas"]["Error"];
           };
         };
-        /** @description Endpoint not yet available in this environment (the hosted runtime endpoint family is dark-launched and returns 404 until general availability) */
-        404: {
-          headers: {
-            [name: string]: unknown;
-          };
-          content: {
-            "application/json": components["schemas"]["Error"];
-          };
-        };
         /** @description Daily execution limit or rate limit exceeded */
         429: {
           headers: {
@@ -43040,15 +43042,6 @@ interface paths {
             "application/json": components["schemas"]["Error"];
           };
         };
-        /** @description Endpoint not yet available in this environment (the hosted runtime endpoint family is dark-launched and returns 404 until general availability) */
-        404: {
-          headers: {
-            [name: string]: unknown;
-          };
-          content: {
-            "application/json": components["schemas"]["Error"];
-          };
-        };
         /** @description Daily execution limit or rate limit exceeded */
         429: {
           headers: {
@@ -43198,15 +43191,6 @@ interface paths {
             "application/json": components["schemas"]["Error"];
           };
         };
-        /** @description Endpoint not yet available in this environment (the hosted runtime endpoint family is dark-launched and returns 404 until general availability) */
-        404: {
-          headers: {
-            [name: string]: unknown;
-          };
-          content: {
-            "application/json": components["schemas"]["Error"];
-          };
-        };
         /** @description Daily execution limit or rate limit exceeded */
         429: {
           headers: {
@@ -43365,15 +43349,6 @@ interface paths {
             "application/json": components["schemas"]["Error"];
           };
         };
-        /** @description Endpoint not yet available in this environment (the hosted runtime endpoint family is dark-launched and returns 404 until general availability) */
-        404: {
-          headers: {
-            [name: string]: unknown;
-          };
-          content: {
-            "application/json": components["schemas"]["Error"];
-          };
-        };
         /** @description Daily execution limit or rate limit exceeded */
         429: {
           headers: {
@@ -43512,15 +43487,6 @@ interface paths {
             "application/json": components["schemas"]["Error"];
           };
         };
-        /** @description Endpoint not yet available in this environment (the hosted runtime endpoint family is dark-launched and returns 404 until general availability) */
-        404: {
-          headers: {
-            [name: string]: unknown;
-          };
-          content: {
-            "application/json": components["schemas"]["Error"];
-          };
-        };
         /** @description Daily execution limit or rate limit exceeded */
         429: {
           headers: {
@@ -43661,15 +43627,6 @@ interface paths {
             "application/json": components["schemas"]["Error"];
           };
         };
-        /** @description Endpoint not yet available in this environment (the hosted runtime endpoint family is dark-launched and returns 404 until general availability) */
-        404: {
-          headers: {
-            [name: string]: unknown;
-          };
-          content: {
-            "application/json": components["schemas"]["Error"];
-          };
-        };
         /** @description Daily execution limit or rate limit exceeded */
         429: {
           headers: {
@@ -43819,15 +43776,6 @@ interface paths {
             "application/json": components["schemas"]["Error"];
           };
         };
-        /** @description Endpoint not yet available in this environment (the hosted runtime endpoint family is dark-launched and returns 404 until general availability) */
-        404: {
-          headers: {
-            [name: string]: unknown;
-          };
-          content: {
-            "application/json": components["schemas"]["Error"];
-          };
-        };
         /** @description Daily execution limit or rate limit exceeded */
         429: {
           headers: {
@@ -51881,6 +51829,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 +53838,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} */
@@ -65117,6 +65082,14 @@ export interface AgentRunInsightsResponse {
 /**
  * Agents endpoint handlers
  */
+/** A `format=bundle` agent runtime export: the zip bytes plus the identity headers the API sends with it. */
+export interface AgentRuntimeBundle {
+  bytes: Uint8Array;
+  fileName: string;
+  contentHash: string | null;
+  runtimeVersion: string | null;
+  runtimeCommit: string | null;
+}
 export declare class AgentsEndpoint {
   private client;
   private static readonly AUTO_COMPACT_SUMMARY_PREFIX;
@@ -65148,9 +65121,22 @@ 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>;
+  /**
+   * Export an agent as a vendorable zip: `agent.json`, the prebuilt `runtime/` package, `manifest.json`,
+   * and `LICENSE`. Two exports of the same version are byte-identical; `contentHash` pins them.
+   */
+  exportRuntimeBundle(id: string, selector?: {
+    versionId?: string;
+    alias?: string;
+  }): Promise<AgentRuntimeBundle>;
   /**
    * 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

@@ -5742,9 +5742,6 @@ function buildAgentAdmissionHeaders(options) {
 	if (options.idempotencyKey) headers["idempotency-key"] = options.idempotencyKey;
 	return headers;
 }
-/**
-* Agents endpoint handlers
-*/
 var AgentsEndpoint = class AgentsEndpoint {
 	constructor(client) {
 		this.client = client;
@@ -5783,10 +5780,30 @@ 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);
+	}
+	/**
+	* Export an agent as a vendorable zip: `agent.json`, the prebuilt `runtime/` package, `manifest.json`,
+	* and `LICENSE`. Two exports of the same version are byte-identical; `contentHash` pins them.
+	*/
+	async exportRuntimeBundle(id, selector) {
+		const query = new URLSearchParams({ format: "bundle" });
+		if (selector?.versionId !== void 0) query.set("versionId", selector.versionId);
+		if (selector?.alias !== void 0) query.set("alias", selector.alias);
+		const response = await this.client.requestStream(`/agents/${id}/export-runtime?${query}`, { method: "GET" });
+		const disposition = response.headers.get("Content-Disposition") ?? "";
+		return {
+			bytes: new Uint8Array(await response.arrayBuffer()),
+			fileName: /filename="([^"]+)"/.exec(disposition)?.[1] ?? `${id}-runtime-bundle.zip`,
+			contentHash: response.headers.get("X-Runtype-Bundle-Content-Hash"),
+			runtimeVersion: response.headers.get("X-Runtype-Runtime-Version"),
+			runtimeCommit: response.headers.get("X-Runtype-Runtime-Commit")
+		};
 	}
 	/**
 	* Roll up the agent's most recent runs: per-version and per-tool counts,
@@ -13480,7 +13497,7 @@ function transformQueryParams(params) {
 }
 //#endregion
 //#region src/version.ts
-const SDK_VERSION = "10.6.0";
+const SDK_VERSION = "10.8.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.8.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.1",
     "openapi-typescript": "^7.13.0",
     "tsdown": "^0.23.0",
     "typescript": "^6.0.3",