@statelyai/agent 2.0.0-alpha.22 → 2.0.0-alpha.24

package/dist/ai-sdk.cjs

@@ -1,5 +1,5 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
-const require_decision = require("./decision-1o45_ZrS.cjs");
+const require_decision = require("./decision-Cv6SfNWl.cjs");
 require("./validate.cjs");
 let ai = require("ai");
 //#region src/ai-sdk/mappers.ts
@@ -67,6 +67,16 @@ function toAgentCallUsage(usage) {
 		...cachedInputTokens !== void 0 ? { cachedInputTokens } : {}
 	};
 }
+/**
+* Maps the AI SDK's unified finish reason onto the portable
+* {@link AgentFinishReason}. Only `'error'` differs: core's union has no
+* `'error'` member, since a call that failed outright rejects instead of
+* returning, so it lands on `'other'`. The SDK's own value stays on the
+* result's `raw`.
+*/
+function toAgentFinishReason(finishReason) {
+	return finishReason === "error" ? "other" : finishReason;
+}
 /** Drops keys whose value is `undefined`, so a spread cannot erase what it lands on. */
 function defined(settings) {
 	return Object.fromEntries(Object.entries(settings).filter(([, value]) => value !== void 0));
@@ -184,7 +194,7 @@ function toDecisionMessages(request) {
 //#endregion
 //#region src/ai-sdk/index.ts
 function maxStepsSetting(request) {
-	const maxSteps = typeof request.maxSteps === "number" ? request.maxSteps : request.metadata?.maxSteps;
+	const maxSteps = request.maxSteps;
 	return typeof maxSteps === "number" ? { stopWhen: (0, ai.stepCountIs)(maxSteps) } : {};
 }
 /**
@@ -206,7 +216,12 @@ function maxStepsSetting(request) {
 * ```
 */
 function defineModels(models) {
-	return models;
+	const registry = { ...models };
+	Object.defineProperty(registry, require_decision.DEFAULT_AGENT_EXECUTORS, {
+		enumerable: false,
+		value: () => createAiSdkExecutors({ models: registry })
+	});
+	return registry;
 }
 /** Resolves the host's `settings` option for one request. */
 function callSettings(options, request) {
@@ -249,6 +264,14 @@ function withJsonRepair(output) {
 		}
 	};
 }
+function truncated(request, info, partialOutput, cause) {
+	return new require_decision.AgentTruncatedError(`createAiSdkExecutors: request '${request.name ?? "(unnamed)"}' hit the output token limit — its structured output never completed. Raise \`maxOutputTokens\`, shorten the input, or ask for a smaller output schema.`, {
+		requestName: request.name ?? "(unnamed)",
+		...info?.requestId !== void 0 ? { requestId: info.requestId } : {},
+		...partialOutput !== void 0 ? { partialOutput } : {},
+		...cause !== void 0 ? { cause } : {}
+	});
+}
 /**
 * The canonical Vercel AI SDK adapter: builds the `{ generateText, streamText,
 * decide }` executor set consumed by `runAgent`/`executeAgentRequest`. `ai`
@@ -277,37 +300,40 @@ function createAiSdkExecutors(options) {
 		if (isStructuredOutputRequest(request)) {
 			const envelope = require_decision.buildEnvelopeSchema(request.outputSchema, { reasoning: request.includeReasoning });
 			const structuredOutput = withJsonRepair(ai.Output.object({ schema: envelope }));
-			const canRetry = !request.tools || Object.keys(request.tools).length === 0;
-			let result;
-			try {
-				result = await (0, ai.generateText)({
-					...common,
-					output: structuredOutput
-				});
-			} catch (error) {
-				if (!canRetry || !ai.NoObjectGeneratedError.isInstance(error) || info?.signal?.aborted) throw error;
-				result = await (0, ai.generateText)({
-					...common,
-					output: structuredOutput
-				});
-			}
-			const { result: output, reasoning } = result.output;
+			const result = await (0, ai.generateText)({
+				...common,
+				output: structuredOutput
+			}).catch((error) => {
+				throw ai.NoObjectGeneratedError.isInstance(error) && error.finishReason === "length" ? truncated(request, info, error.text, error) : error;
+			});
+			const { result: output, reasoning } = (() => {
+				try {
+					return result.output;
+				} catch (error) {
+					throw result.finishReason === "length" ? truncated(request, info, result.text, error) : error;
+				}
+			})();
+			if (result.finishReason === "length") throw truncated(request, info, output);
 			return {
 				output,
 				...reasoning !== void 0 ? { reasoning } : {},
 				usage: toAgentCallUsage(result.usage),
-				finishReason: result.finishReason,
+				finishReason: toAgentFinishReason(result.finishReason),
 				toolCalls: result.toolCalls,
-				toolResults: result.toolResults
+				toolResults: result.toolResults,
+				messages: result.responseMessages,
+				raw: result
 			};
 		}
 		const result = await (0, ai.generateText)(common);
 		return {
 			output: result.text,
 			usage: toAgentCallUsage(result.usage),
-			finishReason: result.finishReason,
+			finishReason: toAgentFinishReason(result.finishReason),
 			toolCalls: result.toolCalls,
-			toolResults: result.toolResults
+			toolResults: result.toolResults,
+			messages: result.responseMessages,
+			raw: result
 		};
 	};
 	const streamText = async (request, info) => {
@@ -324,16 +350,18 @@ function createAiSdkExecutors(options) {
 		return {
 			output: await result.text,
 			usage: toAgentCallUsage(await result.usage),
-			finishReason: await result.finishReason
+			finishReason: toAgentFinishReason(await result.finishReason),
+			messages: await result.responseMessages,
+			raw: result
 		};
 	};
-	const decide = async (request) => {
+	const decide = async (request, info) => {
 		const { model, settings: modelSettings } = resolveAiSdkModel(options, request.model);
 		const tools = toAiSdkEventTools(request.events);
 		const messages = toDecisionMessages(request);
 		const result = await (0, ai.generateText)({
 			model,
-			abortSignal: request.signal,
+			abortSignal: info?.signal,
 			...callSettings(options, request),
 			...defined(modelSettings ?? {}),
 			system: request.system,

package/dist/ai-sdk.d.cts

@@ -1,6 +1,6 @@
-import { d as ChosenEvent } from "./types-DSdj2tGs.cjs";
-import { A as AgentDecisionExecutor, N as AgentDecisionRequest, d as AgentTextRequest, l as AgentRequestExecutors, o as AgentRequestExecutor, t as AgentCallUsage } from "./text-logic-BaxPrcLk.cjs";
-import { FinishReason, LanguageModel, LanguageModelUsage, ToolSet, TypedToolCall, TypedToolResult, generateText } from "ai";
+import { s as AgentTools, u as ChosenEvent } from "./types-CjHk5OdH.cjs";
+import { F as AgentDecisionRequest, c as AgentRequestExecutorInfo, f as AgentTextRequest, r as AgentFinishReason, t as AgentCallUsage } from "./text-logic-C7bSnH_B.cjs";
+import { FinishReason, LanguageModel, LanguageModelUsage, ModelMessage, ToolSet, TypedToolCall, TypedToolResult, generateText } from "ai";
 
 //#region src/ai-sdk/mappers.d.ts
 /**
@@ -99,16 +99,20 @@ type AiSdkGenerateResult = {
    * `reasoningTokens`/`cachedInputTokens` fields are what `runAgent` folds into
    * the run result's aggregated `AgentUsage`; the AI SDK's own nested
    * `inputTokenDetails`/`outputTokenDetails` and `raw` ride along untouched. */
-  usage: AiSdkCallUsage;
-  finishReason: FinishReason;
+  usage: AiSdkCallUsage; /** Why the call stopped, normalized to the portable {@link AgentFinishReason}. The SDK's own value stays on `raw`. */
+  finishReason: AgentFinishReason;
   toolCalls: TypedToolCall<ToolSet>[];
-  toolResults: TypedToolResult<ToolSet>[];
+  toolResults: TypedToolResult<ToolSet>[]; /** AI SDK response messages, including tool calls/results from every step. */
+  messages: ModelMessage[]; /** The untouched AI SDK result. */
+  raw: unknown;
 };
 /** Raw result shape from {@link AiSdkExecutors.streamText} — the `{ output }` envelope carrying the fully-accumulated text once the stream finishes (chunks are delivered separately via `onChunk`), plus the stream's final usage/finish metadata for `onResult`. */
 type AiSdkStreamResult = {
   output: string; /** The stream's final (awaited) usage; aggregated into the run result's `AgentUsage`. */
-  usage: AiSdkCallUsage;
-  finishReason: FinishReason;
+  usage: AiSdkCallUsage; /** Why the stream stopped, normalized to the portable {@link AgentFinishReason}. The SDK's own value stays on `raw`. */
+  finishReason: AgentFinishReason; /** AI SDK response messages, including tool calls/results from every step. */
+  messages: ModelMessage[]; /** The untouched AI SDK result. */
+  raw: unknown;
 };
 /** Raw result shape from {@link AiSdkExecutors.decide} — the chosen event plus the AI SDK call metadata, delivered per decision attempt to `onResult`. */
 type AiSdkDecideResult = {
@@ -119,10 +123,14 @@ type AiSdkDecideResult = {
 /** `createAiSdkExecutors` always populates all three slots (unlike the
  * general `AgentRequestExecutors`, where `streamText`/`decide` are optional),
  * and its `generateText`/`streamText` results are concretely typed. */
-interface AiSdkExecutors extends AgentRequestExecutors<AiSdkGenerateResult, AiSdkStreamResult> {
-  generateText: AgentRequestExecutor<AiSdkGenerateResult>;
-  streamText: AgentRequestExecutor<AiSdkStreamResult>;
-  decide: AgentDecisionExecutor;
+interface AiSdkExecutors {
+  generateText: (request: AgentTextRequest & {
+    tools: AgentTools;
+  }, info?: AgentRequestExecutorInfo) => Promise<AiSdkGenerateResult>;
+  streamText: (request: AgentTextRequest & {
+    tools: AgentTools;
+  }, info?: AgentRequestExecutorInfo) => Promise<AiSdkStreamResult>;
+  decide: (request: AgentDecisionRequest, info?: AgentRequestExecutorInfo) => Promise<AiSdkDecideResult>;
 }
 /**
  * The canonical Vercel AI SDK adapter: builds the `{ generateText, streamText,

package/dist/ai-sdk.d.mts

@@ -1,6 +1,6 @@
-import { d as ChosenEvent } from "./types-CvWRGFxP.mjs";
-import { A as AgentDecisionExecutor, N as AgentDecisionRequest, d as AgentTextRequest, l as AgentRequestExecutors, o as AgentRequestExecutor, t as AgentCallUsage } from "./text-logic-DhfFWzu9.mjs";
-import { FinishReason, LanguageModel, LanguageModelUsage, ToolSet, TypedToolCall, TypedToolResult, generateText } from "ai";
+import { s as AgentTools, u as ChosenEvent } from "./types-DWA6X9R-.mjs";
+import { F as AgentDecisionRequest, c as AgentRequestExecutorInfo, f as AgentTextRequest, r as AgentFinishReason, t as AgentCallUsage } from "./text-logic-DJBK3LbG.mjs";
+import { FinishReason, LanguageModel, LanguageModelUsage, ModelMessage, ToolSet, TypedToolCall, TypedToolResult, generateText } from "ai";
 
 //#region src/ai-sdk/mappers.d.ts
 /**
@@ -99,16 +99,20 @@ type AiSdkGenerateResult = {
    * `reasoningTokens`/`cachedInputTokens` fields are what `runAgent` folds into
    * the run result's aggregated `AgentUsage`; the AI SDK's own nested
    * `inputTokenDetails`/`outputTokenDetails` and `raw` ride along untouched. */
-  usage: AiSdkCallUsage;
-  finishReason: FinishReason;
+  usage: AiSdkCallUsage; /** Why the call stopped, normalized to the portable {@link AgentFinishReason}. The SDK's own value stays on `raw`. */
+  finishReason: AgentFinishReason;
   toolCalls: TypedToolCall<ToolSet>[];
-  toolResults: TypedToolResult<ToolSet>[];
+  toolResults: TypedToolResult<ToolSet>[]; /** AI SDK response messages, including tool calls/results from every step. */
+  messages: ModelMessage[]; /** The untouched AI SDK result. */
+  raw: unknown;
 };
 /** Raw result shape from {@link AiSdkExecutors.streamText} — the `{ output }` envelope carrying the fully-accumulated text once the stream finishes (chunks are delivered separately via `onChunk`), plus the stream's final usage/finish metadata for `onResult`. */
 type AiSdkStreamResult = {
   output: string; /** The stream's final (awaited) usage; aggregated into the run result's `AgentUsage`. */
-  usage: AiSdkCallUsage;
-  finishReason: FinishReason;
+  usage: AiSdkCallUsage; /** Why the stream stopped, normalized to the portable {@link AgentFinishReason}. The SDK's own value stays on `raw`. */
+  finishReason: AgentFinishReason; /** AI SDK response messages, including tool calls/results from every step. */
+  messages: ModelMessage[]; /** The untouched AI SDK result. */
+  raw: unknown;
 };
 /** Raw result shape from {@link AiSdkExecutors.decide} — the chosen event plus the AI SDK call metadata, delivered per decision attempt to `onResult`. */
 type AiSdkDecideResult = {
@@ -119,10 +123,14 @@ type AiSdkDecideResult = {
 /** `createAiSdkExecutors` always populates all three slots (unlike the
  * general `AgentRequestExecutors`, where `streamText`/`decide` are optional),
  * and its `generateText`/`streamText` results are concretely typed. */
-interface AiSdkExecutors extends AgentRequestExecutors<AiSdkGenerateResult, AiSdkStreamResult> {
-  generateText: AgentRequestExecutor<AiSdkGenerateResult>;
-  streamText: AgentRequestExecutor<AiSdkStreamResult>;
-  decide: AgentDecisionExecutor;
+interface AiSdkExecutors {
+  generateText: (request: AgentTextRequest & {
+    tools: AgentTools;
+  }, info?: AgentRequestExecutorInfo) => Promise<AiSdkGenerateResult>;
+  streamText: (request: AgentTextRequest & {
+    tools: AgentTools;
+  }, info?: AgentRequestExecutorInfo) => Promise<AiSdkStreamResult>;
+  decide: (request: AgentDecisionRequest, info?: AgentRequestExecutorInfo) => Promise<AiSdkDecideResult>;
 }
 /**
  * The canonical Vercel AI SDK adapter: builds the `{ generateText, streamText,

package/dist/ai-sdk.mjs

@@ -1,4 +1,4 @@
-import { G as isStandardSchema, a as renderDecisionAttempts, b as getAgentOutputMode, g as buildEnvelopeSchema } from "./decision-DxSTqzgZ.mjs";
+import { S as getAgentOutputMode, Y as isStandardSchema, j as DEFAULT_AGENT_EXECUTORS, o as renderDecisionAttempts, st as AgentTruncatedError, v as buildEnvelopeSchema } from "./decision-BBZ2jMO1.mjs";
 import { NoObjectGeneratedError, Output, generateText, stepCountIs, streamText, tool } from "ai";
 //#region src/ai-sdk/mappers.ts
 /**
@@ -65,6 +65,16 @@ function toAgentCallUsage(usage) {
 		...cachedInputTokens !== void 0 ? { cachedInputTokens } : {}
 	};
 }
+/**
+* Maps the AI SDK's unified finish reason onto the portable
+* {@link AgentFinishReason}. Only `'error'` differs: core's union has no
+* `'error'` member, since a call that failed outright rejects instead of
+* returning, so it lands on `'other'`. The SDK's own value stays on the
+* result's `raw`.
+*/
+function toAgentFinishReason(finishReason) {
+	return finishReason === "error" ? "other" : finishReason;
+}
 /** Drops keys whose value is `undefined`, so a spread cannot erase what it lands on. */
 function defined(settings) {
 	return Object.fromEntries(Object.entries(settings).filter(([, value]) => value !== void 0));
@@ -182,7 +192,7 @@ function toDecisionMessages(request) {
 //#endregion
 //#region src/ai-sdk/index.ts
 function maxStepsSetting(request) {
-	const maxSteps = typeof request.maxSteps === "number" ? request.maxSteps : request.metadata?.maxSteps;
+	const maxSteps = request.maxSteps;
 	return typeof maxSteps === "number" ? { stopWhen: stepCountIs(maxSteps) } : {};
 }
 /**
@@ -204,7 +214,12 @@ function maxStepsSetting(request) {
 * ```
 */
 function defineModels(models) {
-	return models;
+	const registry = { ...models };
+	Object.defineProperty(registry, DEFAULT_AGENT_EXECUTORS, {
+		enumerable: false,
+		value: () => createAiSdkExecutors({ models: registry })
+	});
+	return registry;
 }
 /** Resolves the host's `settings` option for one request. */
 function callSettings(options, request) {
@@ -247,6 +262,14 @@ function withJsonRepair(output) {
 		}
 	};
 }
+function truncated(request, info, partialOutput, cause) {
+	return new AgentTruncatedError(`createAiSdkExecutors: request '${request.name ?? "(unnamed)"}' hit the output token limit — its structured output never completed. Raise \`maxOutputTokens\`, shorten the input, or ask for a smaller output schema.`, {
+		requestName: request.name ?? "(unnamed)",
+		...info?.requestId !== void 0 ? { requestId: info.requestId } : {},
+		...partialOutput !== void 0 ? { partialOutput } : {},
+		...cause !== void 0 ? { cause } : {}
+	});
+}
 /**
 * The canonical Vercel AI SDK adapter: builds the `{ generateText, streamText,
 * decide }` executor set consumed by `runAgent`/`executeAgentRequest`. `ai`
@@ -275,37 +298,40 @@ function createAiSdkExecutors(options) {
 		if (isStructuredOutputRequest(request)) {
 			const envelope = buildEnvelopeSchema(request.outputSchema, { reasoning: request.includeReasoning });
 			const structuredOutput = withJsonRepair(Output.object({ schema: envelope }));
-			const canRetry = !request.tools || Object.keys(request.tools).length === 0;
-			let result;
-			try {
-				result = await generateText({
-					...common,
-					output: structuredOutput
-				});
-			} catch (error) {
-				if (!canRetry || !NoObjectGeneratedError.isInstance(error) || info?.signal?.aborted) throw error;
-				result = await generateText({
-					...common,
-					output: structuredOutput
-				});
-			}
-			const { result: output, reasoning } = result.output;
+			const result = await generateText({
+				...common,
+				output: structuredOutput
+			}).catch((error) => {
+				throw NoObjectGeneratedError.isInstance(error) && error.finishReason === "length" ? truncated(request, info, error.text, error) : error;
+			});
+			const { result: output, reasoning } = (() => {
+				try {
+					return result.output;
+				} catch (error) {
+					throw result.finishReason === "length" ? truncated(request, info, result.text, error) : error;
+				}
+			})();
+			if (result.finishReason === "length") throw truncated(request, info, output);
 			return {
 				output,
 				...reasoning !== void 0 ? { reasoning } : {},
 				usage: toAgentCallUsage(result.usage),
-				finishReason: result.finishReason,
+				finishReason: toAgentFinishReason(result.finishReason),
 				toolCalls: result.toolCalls,
-				toolResults: result.toolResults
+				toolResults: result.toolResults,
+				messages: result.responseMessages,
+				raw: result
 			};
 		}
 		const result = await generateText(common);
 		return {
 			output: result.text,
 			usage: toAgentCallUsage(result.usage),
-			finishReason: result.finishReason,
+			finishReason: toAgentFinishReason(result.finishReason),
 			toolCalls: result.toolCalls,
-			toolResults: result.toolResults
+			toolResults: result.toolResults,
+			messages: result.responseMessages,
+			raw: result
 		};
 	};
 	const streamText$1 = async (request, info) => {
@@ -322,16 +348,18 @@ function createAiSdkExecutors(options) {
 		return {
 			output: await result.text,
 			usage: toAgentCallUsage(await result.usage),
-			finishReason: await result.finishReason
+			finishReason: toAgentFinishReason(await result.finishReason),
+			messages: await result.responseMessages,
+			raw: result
 		};
 	};
-	const decide = async (request) => {
+	const decide = async (request, info) => {
 		const { model, settings: modelSettings } = resolveAiSdkModel(options, request.model);
 		const tools = toAiSdkEventTools(request.events);
 		const messages = toDecisionMessages(request);
 		const result = await generateText({
 			model,
-			abortSignal: request.signal,
+			abortSignal: info?.signal,
 			...callSettings(options, request),
 			...defined(modelSettings ?? {}),
 			system: request.system,