@runtypelabs/sdk 10.7.0 → 10.8.1

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.
 	*/
@@ -8545,6 +8560,17 @@ var ToolApprovalGrantsEndpoint = class {
 };
 //#endregion
 //#region src/detached-buffered-follow.ts
+/** The release fields a response body carries, dropping any it does not name. */
+function releaseFieldsOf(data) {
+	if (typeof data !== "object" || data === null) return {};
+	const record = data;
+	const resolution = record.agentTargetResolution;
+	return {
+		...typeof record.agentVersionId === "string" ? { agentVersionId: record.agentVersionId } : {},
+		...typeof record.alias === "string" ? { alias: record.alias } : {},
+		...resolution === "alias" || resolution === "version" || resolution === "legacy-live-row" ? { agentTargetResolution: resolution } : {}
+	};
+}
 function isDetachedToolOutputAck(data) {
 	if (typeof data !== "object" || data === null) return false;
 	const record = data;
@@ -8572,9 +8598,12 @@ function isLocalToolAwait(event) {
 * buffered continuation envelope a non-streaming local-tool loop expects.
 *
 * `after` is the last `seq` the loop had already consumed, so the replay
-* never re-delivers the await the outputs just answered.
+* never re-delivers the await the outputs just answered. Version fields from
+* earlier responses (`carried`) and the ack land on the envelope, since the
+* events stream never repeats them.
 */
-async function followDetachedResume(client, executionId, after) {
+async function followDetachedResume(client, ack, after, carried = {}) {
+	const { executionId } = ack;
 	const open = (cursor, signal) => client.requestStream(buildExecutionEventsPath(executionId, cursor ? { after: cursor } : {}), {
 		method: "GET",
 		...signal ? { signal } : {}
@@ -8632,7 +8661,9 @@ async function followDetachedResume(client, executionId, after) {
 		executionId,
 		events,
 		status,
-		...error ? { error } : {}
+		...error ? { error } : {},
+		...carried,
+		...releaseFieldsOf(ack)
 	};
 }
 //#endregion
@@ -10205,9 +10236,11 @@ var RuntypeFlowBuilder = class {
 			}
 		};
 		let currentResponse;
+		let carriedRelease = {};
 		if (isStreaming) currentResponse = await client.dispatch(config);
 		else {
 			const data = await client.dispatchJson(config);
+			carriedRelease = releaseFieldsOf(data);
 			currentResponse = new Response(JSON.stringify(data), { headers: { "content-type": "application/json" } });
 		}
 		while (true) {
@@ -10242,7 +10275,11 @@ var RuntypeFlowBuilder = class {
 					}).catch(() => null));
 					else {
 						const data = await client.post("/dispatch/resume", resumeData);
-						const envelope = isDetachedToolOutputAck(data) ? await followDetachedResume(client, data.executionId, pausedResult.resumeCursor) : data;
+						carriedRelease = {
+							...carriedRelease,
+							...releaseFieldsOf(data)
+						};
+						const envelope = isDetachedToolOutputAck(data) ? await followDetachedResume(client, data, pausedResult.resumeCursor, carriedRelease) : data;
 						currentResponse = new Response(JSON.stringify(envelope), { headers: { "content-type": "application/json" } });
 					}
 				} catch (error) {
@@ -11418,6 +11455,8 @@ const DEFINE_TOP_LEVEL_KEYS = /* @__PURE__ */ new Set([
 	"icon",
 	...AGENT_CONFIG_KEYS
 ]);
+/** A minted tool typeid; `alwaysLoaded` also holds tool names, which may begin with `tool_`. */
+const TOOL_TYPEID_PATTERN = /^tool_[0-7][0-9a-hjkmnp-tv-z]{25}$/;
 /**
 * Collect account-scoped `tool_…` references (inlined copy of
 * `collectNonPortableAgentToolRefs` in @runtypelabs/shared). The v1 ensure
@@ -11444,6 +11483,9 @@ function collectNonPortableToolRefs(config) {
 	if (isPlainObject(tools.approval)) scanArray(tools.approval.require, "tools.approval.require");
 	if (isPlainObject(tools.subagentConfig)) scanArray(tools.subagentConfig.toolPool, "tools.subagentConfig.toolPool");
 	if (isPlainObject(tools.codeModeConfig)) scanArray(tools.codeModeConfig.toolPool, "tools.codeModeConfig.toolPool");
+	if (isPlainObject(tools.toolSearch) && Array.isArray(tools.toolSearch.alwaysLoaded)) tools.toolSearch.alwaysLoaded.forEach((ref, i) => {
+		if (typeof ref === "string" && TOOL_TYPEID_PATTERN.test(ref)) found.push(`tools.toolSearch.alwaysLoaded[${i}]`);
+	});
 	if (Array.isArray(tools.runtimeTools)) tools.runtimeTools.forEach((runtimeTool, i) => {
 		if (!isPlainObject(runtimeTool) || !isPlainObject(runtimeTool.config)) return;
 		const base = `tools.runtimeTools[${i}].config`;
@@ -13483,7 +13525,7 @@ function transformQueryParams(params) {
 }
 //#endregion
 //#region src/version.ts
-const SDK_VERSION = "10.7.0";
+const SDK_VERSION = "10.8.1";
 /**
 * Canonical client identity the API uses for attribution
 * (`detectActorSource` in apps/api/src/lib/audit-log.ts keys `'sdk'` off the
@@ -13694,9 +13736,11 @@ var RuntypeClient = class {
 			}
 		};
 		let currentResponse;
+		let carriedRelease = {};
 		if (isStreaming) currentResponse = await this.dispatch.executeStream(modifiedRequest);
 		else {
 			const data = await this.dispatch.execute(modifiedRequest);
+			carriedRelease = releaseFieldsOf(data);
 			currentResponse = new Response(JSON.stringify(data), { headers: { "content-type": "application/json" } });
 		}
 		while (true) {
@@ -13730,7 +13774,11 @@ var RuntypeClient = class {
 					if (isStreaming) currentResponse = await this.dispatch.resume(resumeData);
 					else {
 						const data = await this.dispatch.resume(resumeData);
-						const envelope = isDetachedToolOutputAck(data) ? await followDetachedResume(this, data.executionId, result.resumeCursor) : data;
+						carriedRelease = {
+							...carriedRelease,
+							...releaseFieldsOf(data)
+						};
+						const envelope = isDetachedToolOutputAck(data) ? await followDetachedResume(this, data, result.resumeCursor, carriedRelease) : data;
 						currentResponse = new Response(JSON.stringify(envelope), { headers: { "content-type": "application/json" } });
 					}
 				} catch (error) {

package/dist/index.d.cts

@@ -1204,6 +1204,11 @@ interface paths {
                   };
                 };
                 toolIds?: string[];
+                toolSearch?: {
+                  alwaysLoaded?: string[];
+                  enabled?: boolean;
+                  threshold?: number;
+                };
               };
               topK?: number;
               topP?: number;
@@ -1725,6 +1730,11 @@ interface paths {
                     };
                   };
                   toolIds?: string[];
+                  toolSearch?: {
+                    alwaysLoaded?: string[];
+                    enabled?: boolean;
+                    threshold?: number;
+                  };
                 };
                 topK?: number;
                 topP?: number;
@@ -2522,6 +2532,11 @@ interface paths {
                   };
                 };
                 toolIds?: string[];
+                toolSearch?: {
+                  alwaysLoaded?: string[];
+                  enabled?: boolean;
+                  threshold?: number;
+                } | null;
               };
               topK?: number;
               topP?: number;
@@ -5270,6 +5285,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 +5296,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 +5327,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 +5384,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;
@@ -28724,7 +28751,7 @@ interface paths {
                 /** @enum {string} */
                 executorProvider?: "openai" | "anthropic" | "google" | "xai" | "vertex" | "vertex-anthropic" | "bedrock" | "tinfoil" | "vercel" | "generic-openai";
                 inputCostPer1kTokens: number;
-                /** @default 4096 */
+                /** @default 32768 */
                 maxOutputTokens?: number;
                 /**
                  * @description Where a system message that follows a conversation turn lands on this endpoint. Omitted keeps it at its position (Mistral- and Gemma-family ids fold it into the leading prompt); "hoist" folds it for any endpoint whose chat template rejects a non-leading system role.
@@ -29395,7 +29422,7 @@ interface paths {
                 /** @enum {string} */
                 executorProvider?: "openai" | "anthropic" | "google" | "xai" | "vertex" | "vertex-anthropic" | "bedrock" | "tinfoil" | "vercel" | "generic-openai";
                 inputCostPer1kTokens: number;
-                /** @default 4096 */
+                /** @default 32768 */
                 maxOutputTokens?: number;
                 /**
                  * @description Where a system message that follows a conversation turn lands on this endpoint. Omitted keeps it at its position (Mistral- and Gemma-family ids fold it into the leading prompt); "hoist" folds it for any endpoint whose chat template rejects a non-leading system role.
@@ -42445,15 +42472,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 +42649,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 +42799,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 +42932,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 +43057,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 +43206,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 +43364,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 +43502,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 +43642,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 +43791,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: {
@@ -51083,6 +51020,11 @@ interface components {
               };
             };
             toolIds?: string[];
+            toolSearch?: {
+              alwaysLoaded?: string[];
+              enabled?: boolean;
+              threshold?: number;
+            };
           };
           topK?: number;
           topP?: number;
@@ -51784,6 +51726,11 @@ interface components {
             };
           };
           toolIds?: string[];
+          toolSearch?: {
+            alwaysLoaded?: string[];
+            enabled?: boolean;
+            threshold?: number;
+          } | null;
         };
         topK?: number;
         topP?: number;
@@ -51907,7 +51854,12 @@ interface components {
     };
     DispatchAgentJsonResponse: {
       agentExecutionId?: string;
-      /** @description The published agent version the run executed. Absent when no stored version ran. */
+      /**
+       * @description How the run selected its definition: `alias` or `version` for a request that named a selector, `legacy-live-row` for a run that read the mutable agent row. Matches `GET /v1/executions/{executionId}/status`.
+       * @enum {string}
+       */
+      agentTargetResolution?: "alias" | "version" | "legacy-live-row";
+      /** @description The agent version recorded for the run. When `agentTargetResolution` is `legacy-live-row`, this is the version the agent row pointed at, and the run read the mutable row rather than that version. Absent when neither exists. */
       agentVersionId?: string;
       /** @description The release alias (for example `live`) the version was resolved through, when one was. */
       alias?: string;
@@ -51967,6 +51919,15 @@ interface components {
       status: "running";
     };
     DispatchDetachedToolOutputJsonResponse: {
+      /**
+       * @description How the run selected its definition: `alias` or `version` for a request that named a selector, `legacy-live-row` for a run that read the mutable agent row. Matches `GET /v1/executions/{executionId}/status`.
+       * @enum {string}
+       */
+      agentTargetResolution?: "alias" | "version" | "legacy-live-row";
+      /** @description The agent version recorded for the run. When `agentTargetResolution` is `legacy-live-row`, this is the version the agent row pointed at, and the run read the mutable row rather than that version. Absent when neither exists. */
+      agentVersionId?: string;
+      /** @description The release alias (for example `live`) the version was resolved through, when one was. */
+      alias?: string;
       executionId: string;
       /** @enum {string} */
       pauseKind: "client_tool" | "elicitation";
@@ -52017,6 +51978,15 @@ interface components {
     };
     DispatchResumeJsonResponse: components["schemas"]["DispatchToolOutputContinuationJsonResponse"] | components["schemas"]["DispatchDetachedToolOutputJsonResponse"];
     DispatchToolOutputContinuationJsonResponse: {
+      /**
+       * @description How the run selected its definition: `alias` or `version` for a request that named a selector, `legacy-live-row` for a run that read the mutable agent row. Matches `GET /v1/executions/{executionId}/status`.
+       * @enum {string}
+       */
+      agentTargetResolution?: "alias" | "version" | "legacy-live-row";
+      /** @description The agent version recorded for the run. When `agentTargetResolution` is `legacy-live-row`, this is the version the agent row pointed at, and the run read the mutable row rather than that version. Absent when neither exists. */
+      agentVersionId?: string;
+      /** @description The release alias (for example `live`) the version was resolved through, when one was. */
+      alias?: string;
       blockReason?: string;
       code?: string;
       error?: string;
@@ -60610,6 +60580,11 @@ interface AgentDefinitionConfig {
     }>;
     subagentConfig?: Record<string, unknown>;
     codeModeConfig?: Record<string, unknown>;
+    toolSearch?: {
+      enabled?: boolean;
+      threshold?: number;
+      alwaysLoaded?: string[];
+    };
   };
   artifacts?: {
     enabled: true;
@@ -65160,6 +65135,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 +65182,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

@@ -1204,6 +1204,11 @@ interface paths {
                   };
                 };
                 toolIds?: string[];
+                toolSearch?: {
+                  alwaysLoaded?: string[];
+                  enabled?: boolean;
+                  threshold?: number;
+                };
               };
               topK?: number;
               topP?: number;
@@ -1725,6 +1730,11 @@ interface paths {
                     };
                   };
                   toolIds?: string[];
+                  toolSearch?: {
+                    alwaysLoaded?: string[];
+                    enabled?: boolean;
+                    threshold?: number;
+                  };
                 };
                 topK?: number;
                 topP?: number;
@@ -2522,6 +2532,11 @@ interface paths {
                   };
                 };
                 toolIds?: string[];
+                toolSearch?: {
+                  alwaysLoaded?: string[];
+                  enabled?: boolean;
+                  threshold?: number;
+                } | null;
               };
               topK?: number;
               topP?: number;
@@ -5270,6 +5285,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 +5296,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 +5327,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 +5384,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;
@@ -28724,7 +28751,7 @@ interface paths {
                 /** @enum {string} */
                 executorProvider?: "openai" | "anthropic" | "google" | "xai" | "vertex" | "vertex-anthropic" | "bedrock" | "tinfoil" | "vercel" | "generic-openai";
                 inputCostPer1kTokens: number;
-                /** @default 4096 */
+                /** @default 32768 */
                 maxOutputTokens?: number;
                 /**
                  * @description Where a system message that follows a conversation turn lands on this endpoint. Omitted keeps it at its position (Mistral- and Gemma-family ids fold it into the leading prompt); "hoist" folds it for any endpoint whose chat template rejects a non-leading system role.
@@ -29395,7 +29422,7 @@ interface paths {
                 /** @enum {string} */
                 executorProvider?: "openai" | "anthropic" | "google" | "xai" | "vertex" | "vertex-anthropic" | "bedrock" | "tinfoil" | "vercel" | "generic-openai";
                 inputCostPer1kTokens: number;
-                /** @default 4096 */
+                /** @default 32768 */
                 maxOutputTokens?: number;
                 /**
                  * @description Where a system message that follows a conversation turn lands on this endpoint. Omitted keeps it at its position (Mistral- and Gemma-family ids fold it into the leading prompt); "hoist" folds it for any endpoint whose chat template rejects a non-leading system role.
@@ -42445,15 +42472,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 +42649,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 +42799,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 +42932,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 +43057,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 +43206,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 +43364,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 +43502,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 +43642,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 +43791,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: {
@@ -51083,6 +51020,11 @@ interface components {
               };
             };
             toolIds?: string[];
+            toolSearch?: {
+              alwaysLoaded?: string[];
+              enabled?: boolean;
+              threshold?: number;
+            };
           };
           topK?: number;
           topP?: number;
@@ -51784,6 +51726,11 @@ interface components {
             };
           };
           toolIds?: string[];
+          toolSearch?: {
+            alwaysLoaded?: string[];
+            enabled?: boolean;
+            threshold?: number;
+          } | null;
         };
         topK?: number;
         topP?: number;
@@ -51907,7 +51854,12 @@ interface components {
     };
     DispatchAgentJsonResponse: {
       agentExecutionId?: string;
-      /** @description The published agent version the run executed. Absent when no stored version ran. */
+      /**
+       * @description How the run selected its definition: `alias` or `version` for a request that named a selector, `legacy-live-row` for a run that read the mutable agent row. Matches `GET /v1/executions/{executionId}/status`.
+       * @enum {string}
+       */
+      agentTargetResolution?: "alias" | "version" | "legacy-live-row";
+      /** @description The agent version recorded for the run. When `agentTargetResolution` is `legacy-live-row`, this is the version the agent row pointed at, and the run read the mutable row rather than that version. Absent when neither exists. */
       agentVersionId?: string;
       /** @description The release alias (for example `live`) the version was resolved through, when one was. */
       alias?: string;
@@ -51967,6 +51919,15 @@ interface components {
       status: "running";
     };
     DispatchDetachedToolOutputJsonResponse: {
+      /**
+       * @description How the run selected its definition: `alias` or `version` for a request that named a selector, `legacy-live-row` for a run that read the mutable agent row. Matches `GET /v1/executions/{executionId}/status`.
+       * @enum {string}
+       */
+      agentTargetResolution?: "alias" | "version" | "legacy-live-row";
+      /** @description The agent version recorded for the run. When `agentTargetResolution` is `legacy-live-row`, this is the version the agent row pointed at, and the run read the mutable row rather than that version. Absent when neither exists. */
+      agentVersionId?: string;
+      /** @description The release alias (for example `live`) the version was resolved through, when one was. */
+      alias?: string;
       executionId: string;
       /** @enum {string} */
       pauseKind: "client_tool" | "elicitation";
@@ -52017,6 +51978,15 @@ interface components {
     };
     DispatchResumeJsonResponse: components["schemas"]["DispatchToolOutputContinuationJsonResponse"] | components["schemas"]["DispatchDetachedToolOutputJsonResponse"];
     DispatchToolOutputContinuationJsonResponse: {
+      /**
+       * @description How the run selected its definition: `alias` or `version` for a request that named a selector, `legacy-live-row` for a run that read the mutable agent row. Matches `GET /v1/executions/{executionId}/status`.
+       * @enum {string}
+       */
+      agentTargetResolution?: "alias" | "version" | "legacy-live-row";
+      /** @description The agent version recorded for the run. When `agentTargetResolution` is `legacy-live-row`, this is the version the agent row pointed at, and the run read the mutable row rather than that version. Absent when neither exists. */
+      agentVersionId?: string;
+      /** @description The release alias (for example `live`) the version was resolved through, when one was. */
+      alias?: string;
       blockReason?: string;
       code?: string;
       error?: string;
@@ -60610,6 +60580,11 @@ interface AgentDefinitionConfig {
     }>;
     subagentConfig?: Record<string, unknown>;
     codeModeConfig?: Record<string, unknown>;
+    toolSearch?: {
+      enabled?: boolean;
+      threshold?: number;
+      alwaysLoaded?: string[];
+    };
   };
   artifacts?: {
     enabled: true;
@@ -65160,6 +65135,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 +65182,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.
 	*/
@@ -8544,6 +8559,17 @@ var ToolApprovalGrantsEndpoint = class {
 };
 //#endregion
 //#region src/detached-buffered-follow.ts
+/** The release fields a response body carries, dropping any it does not name. */
+function releaseFieldsOf(data) {
+	if (typeof data !== "object" || data === null) return {};
+	const record = data;
+	const resolution = record.agentTargetResolution;
+	return {
+		...typeof record.agentVersionId === "string" ? { agentVersionId: record.agentVersionId } : {},
+		...typeof record.alias === "string" ? { alias: record.alias } : {},
+		...resolution === "alias" || resolution === "version" || resolution === "legacy-live-row" ? { agentTargetResolution: resolution } : {}
+	};
+}
 function isDetachedToolOutputAck(data) {
 	if (typeof data !== "object" || data === null) return false;
 	const record = data;
@@ -8571,9 +8597,12 @@ function isLocalToolAwait(event) {
 * buffered continuation envelope a non-streaming local-tool loop expects.
 *
 * `after` is the last `seq` the loop had already consumed, so the replay
-* never re-delivers the await the outputs just answered.
+* never re-delivers the await the outputs just answered. Version fields from
+* earlier responses (`carried`) and the ack land on the envelope, since the
+* events stream never repeats them.
 */
-async function followDetachedResume(client, executionId, after) {
+async function followDetachedResume(client, ack, after, carried = {}) {
+	const { executionId } = ack;
 	const open = (cursor, signal) => client.requestStream(buildExecutionEventsPath(executionId, cursor ? { after: cursor } : {}), {
 		method: "GET",
 		...signal ? { signal } : {}
@@ -8631,7 +8660,9 @@ async function followDetachedResume(client, executionId, after) {
 		executionId,
 		events,
 		status,
-		...error ? { error } : {}
+		...error ? { error } : {},
+		...carried,
+		...releaseFieldsOf(ack)
 	};
 }
 //#endregion
@@ -10204,9 +10235,11 @@ var RuntypeFlowBuilder = class {
 			}
 		};
 		let currentResponse;
+		let carriedRelease = {};
 		if (isStreaming) currentResponse = await client.dispatch(config);
 		else {
 			const data = await client.dispatchJson(config);
+			carriedRelease = releaseFieldsOf(data);
 			currentResponse = new Response(JSON.stringify(data), { headers: { "content-type": "application/json" } });
 		}
 		while (true) {
@@ -10241,7 +10274,11 @@ var RuntypeFlowBuilder = class {
 					}).catch(() => null));
 					else {
 						const data = await client.post("/dispatch/resume", resumeData);
-						const envelope = isDetachedToolOutputAck(data) ? await followDetachedResume(client, data.executionId, pausedResult.resumeCursor) : data;
+						carriedRelease = {
+							...carriedRelease,
+							...releaseFieldsOf(data)
+						};
+						const envelope = isDetachedToolOutputAck(data) ? await followDetachedResume(client, data, pausedResult.resumeCursor, carriedRelease) : data;
 						currentResponse = new Response(JSON.stringify(envelope), { headers: { "content-type": "application/json" } });
 					}
 				} catch (error) {
@@ -11417,6 +11454,8 @@ const DEFINE_TOP_LEVEL_KEYS = /* @__PURE__ */ new Set([
 	"icon",
 	...AGENT_CONFIG_KEYS
 ]);
+/** A minted tool typeid; `alwaysLoaded` also holds tool names, which may begin with `tool_`. */
+const TOOL_TYPEID_PATTERN = /^tool_[0-7][0-9a-hjkmnp-tv-z]{25}$/;
 /**
 * Collect account-scoped `tool_…` references (inlined copy of
 * `collectNonPortableAgentToolRefs` in @runtypelabs/shared). The v1 ensure
@@ -11443,6 +11482,9 @@ function collectNonPortableToolRefs(config) {
 	if (isPlainObject(tools.approval)) scanArray(tools.approval.require, "tools.approval.require");
 	if (isPlainObject(tools.subagentConfig)) scanArray(tools.subagentConfig.toolPool, "tools.subagentConfig.toolPool");
 	if (isPlainObject(tools.codeModeConfig)) scanArray(tools.codeModeConfig.toolPool, "tools.codeModeConfig.toolPool");
+	if (isPlainObject(tools.toolSearch) && Array.isArray(tools.toolSearch.alwaysLoaded)) tools.toolSearch.alwaysLoaded.forEach((ref, i) => {
+		if (typeof ref === "string" && TOOL_TYPEID_PATTERN.test(ref)) found.push(`tools.toolSearch.alwaysLoaded[${i}]`);
+	});
 	if (Array.isArray(tools.runtimeTools)) tools.runtimeTools.forEach((runtimeTool, i) => {
 		if (!isPlainObject(runtimeTool) || !isPlainObject(runtimeTool.config)) return;
 		const base = `tools.runtimeTools[${i}].config`;
@@ -13482,7 +13524,7 @@ function transformQueryParams(params) {
 }
 //#endregion
 //#region src/version.ts
-const SDK_VERSION = "10.7.0";
+const SDK_VERSION = "10.8.1";
 /**
 * Canonical client identity the API uses for attribution
 * (`detectActorSource` in apps/api/src/lib/audit-log.ts keys `'sdk'` off the
@@ -13693,9 +13735,11 @@ var RuntypeClient = class {
 			}
 		};
 		let currentResponse;
+		let carriedRelease = {};
 		if (isStreaming) currentResponse = await this.dispatch.executeStream(modifiedRequest);
 		else {
 			const data = await this.dispatch.execute(modifiedRequest);
+			carriedRelease = releaseFieldsOf(data);
 			currentResponse = new Response(JSON.stringify(data), { headers: { "content-type": "application/json" } });
 		}
 		while (true) {
@@ -13729,7 +13773,11 @@ var RuntypeClient = class {
 					if (isStreaming) currentResponse = await this.dispatch.resume(resumeData);
 					else {
 						const data = await this.dispatch.resume(resumeData);
-						const envelope = isDetachedToolOutputAck(data) ? await followDetachedResume(this, data.executionId, result.resumeCursor) : data;
+						carriedRelease = {
+							...carriedRelease,
+							...releaseFieldsOf(data)
+						};
+						const envelope = isDetachedToolOutputAck(data) ? await followDetachedResume(this, data, result.resumeCursor, carriedRelease) : data;
 						currentResponse = new Response(JSON.stringify(envelope), { headers: { "content-type": "application/json" } });
 					}
 				} catch (error) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@runtypelabs/sdk",
-  "version": "10.7.0",
+  "version": "10.8.1",
   "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.2",
     "openapi-typescript": "^7.13.0",
     "tsdown": "^0.23.0",
     "typescript": "^6.0.3",