@runtypelabs/sdk 10.7.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;
@@ -5792,6 +5789,24 @@ var AgentsEndpoint = class AgentsEndpoint {
 		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,
 	* average tokens and cost, and which attached tools were never called.
 	*/
@@ -13483,7 +13498,7 @@ function transformQueryParams(params) {
 }
 //#endregion
 //#region src/version.ts
-const SDK_VERSION = "10.7.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

@@ -5270,6 +5270,8 @@ interface paths {
           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: {
@@ -5279,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;
@@ -5310,6 +5312,7 @@ interface paths {
               /** @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, or both `versionId` and `alias` were supplied */
@@ -5366,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;
@@ -42445,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: {
@@ -42631,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: {
@@ -42790,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: {
@@ -42932,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: {
@@ -43066,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: {
@@ -43224,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: {
@@ -43391,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: {
@@ -43538,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: {
@@ -43687,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: {
@@ -43845,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: {
@@ -65160,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;
@@ -65199,6 +65129,14 @@ export declare class AgentsEndpoint {
     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

@@ -5270,6 +5270,8 @@ interface paths {
           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: {
@@ -5279,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;
@@ -5310,6 +5312,7 @@ interface paths {
               /** @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, or both `versionId` and `alias` were supplied */
@@ -5366,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;
@@ -42445,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: {
@@ -42631,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: {
@@ -42790,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: {
@@ -42932,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: {
@@ -43066,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: {
@@ -43224,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: {
@@ -43391,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: {
@@ -43538,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: {
@@ -43687,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: {
@@ -43845,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: {
@@ -65160,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;
@@ -65199,6 +65129,14 @@ export declare class AgentsEndpoint {
     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;
@@ -5791,6 +5788,24 @@ var AgentsEndpoint = class AgentsEndpoint {
 		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,
 	* average tokens and cost, and which attached tools were never called.
 	*/
@@ -13482,7 +13497,7 @@ function transformQueryParams(params) {
 }
 //#endregion
 //#region src/version.ts
-const SDK_VERSION = "10.7.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.7.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.68.0",
+    "@runtypelabs/shared": "3.68.1",
     "openapi-typescript": "^7.13.0",
     "tsdown": "^0.23.0",
     "typescript": "^6.0.3",