@statelyai/agent 2.0.0-alpha.20 → 2.0.0-alpha.21

package/dist/ai-sdk.cjs

@@ -1,5 +1,5 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
-const require_decision = require("./decision-DhsKLYAI.cjs");
+const require_decision = require("./decision-BnTCsuJv.cjs");
 require("./validate.cjs");
 let ai = require("ai");
 //#region src/ai-sdk/mappers.ts
@@ -51,6 +51,27 @@ const unknownSchema = { "~standard": {
 	jsonSchema: { input: () => ({}) }
 } };
 /**
+* Folds AI SDK v7's nested token details onto the flat field names core
+* aggregates. v7 moved `reasoningTokens` under `outputTokenDetails` and the
+* cached-input count under `inputTokenDetails.cacheReadTokens`, while
+* {@link AgentCallUsage} stays flat and provider-agnostic. The SDK's own shape
+* is spread through unchanged, so `onResult` consumers still see every field
+* the provider reported, including v7's `raw`.
+*/
+function toAgentCallUsage(usage) {
+	const reasoningTokens = usage.outputTokenDetails?.reasoningTokens;
+	const cachedInputTokens = usage.inputTokenDetails?.cacheReadTokens;
+	return {
+		...usage,
+		...reasoningTokens !== void 0 ? { reasoningTokens } : {},
+		...cachedInputTokens !== void 0 ? { cachedInputTokens } : {}
+	};
+}
+/** 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));
+}
+/**
 * AI SDK request-mapping settings shared by `generateText`/`streamText`.
 * `AgentTextRequest.messages` (`AgentMessage[]`) and AI SDK's `ModelMessage[]`
 * are structurally compatible by design (§1 of .scratch/p0-design.md) — the cast
@@ -60,16 +81,36 @@ function toAiSdkCallSettings(request) {
 	const messages = request.messages;
 	return {
 		system: request.system,
-		...messages ? { messages } : { prompt: request.prompt ?? "" },
+		...messages ? {
+			messages,
+			allowSystemInMessages: true
+		} : { prompt: request.prompt ?? "" },
+		...toAiSdkGenerationSettings(request),
+		...defined({
+			tools: request.tools ? toAiSdkTools(request.tools) : void 0,
+			toolChoice: toAiSdkToolChoice(request.toolChoice)
+		})
+	};
+}
+/**
+* The generation settings a text request and a decision request share, with
+* unset keys omitted.
+*
+* Omitting matters: these settings are one layer of a stack — the host's
+* `createAiSdkExecutors({ settings })`, then the model ref's own, then the
+* request's — and an `undefined` spread over a layer below erases it. Both the
+* text path and `decide` map their settings through here so neither can drift
+* back into writing the keys unconditionally.
+*/
+function toAiSdkGenerationSettings(request) {
+	return defined({
 		temperature: request.temperature,
 		maxOutputTokens: request.maxOutputTokens,
 		topP: request.topP,
 		topK: request.topK,
 		seed: request.seed,
-		stopSequences: request.stopSequences,
-		tools: request.tools ? toAiSdkTools(request.tools) : void 0,
-		toolChoice: toAiSdkToolChoice(request.toolChoice)
-	};
+		stopSequences: request.stopSequences
+	});
 }
 /** Maps an {@link AgentToolChoice} to AI SDK's tool-choice shape — `{ type: 'tool'; name }` becomes `{ type: 'tool'; toolName }`; `'auto'`/`'none'`/`'required'`/`undefined` pass through unchanged. */
 function toAiSdkToolChoice(toolChoice) {
@@ -167,13 +208,29 @@ function maxStepsSetting(request) {
 function defineModels(models) {
 	return models;
 }
+/** Resolves the host's `settings` option for one request. */
+function callSettings(options, request) {
+	const settings = options.settings;
+	return (typeof settings === "function" ? settings(request) : settings) ?? {};
+}
 function resolveAiSdkModel(options, modelRef) {
-	if (options.resolveModel) return options.resolveModel(modelRef);
+	if (options.resolveModel) return { model: options.resolveModel(modelRef) };
 	const models = options.models;
 	if (!models) throw new Error(`createAiSdkExecutors: no model resolver configured for '${modelRef}'.`);
-	const model = models[modelRef];
-	if (!model) throw new Error(`createAiSdkExecutors: unknown model '${modelRef}'.`);
-	return model;
+	const entry = models[modelRef];
+	if (!entry) throw new Error(`createAiSdkExecutors: unknown model '${modelRef}'.`);
+	return isModelWithSettings(entry) ? entry : { model: entry };
+}
+/**
+* The `LanguageModel` inside a map entry, whichever form it takes. `defineModels`
+* widens its return to {@link AiSdkModelMap}, so reading an entry out of the map
+* to hand to a raw AI SDK call needs this to get past the union.
+*/
+function toLanguageModel(entry) {
+	return isModelWithSettings(entry) ? entry.model : entry;
+}
+function isModelWithSettings(entry) {
+	return typeof entry === "object" && entry !== null && "model" in entry;
 }
 function withJsonRepair(output) {
 	return {
@@ -208,14 +265,17 @@ function withJsonRepair(output) {
 */
 function createAiSdkExecutors(options) {
 	const generateText = async (request, info) => {
+		const { model, settings: modelSettings } = resolveAiSdkModel(options, request.model);
 		const common = {
-			model: resolveAiSdkModel(options, request.model),
+			model,
 			abortSignal: info?.signal,
+			...callSettings(options, request),
+			...defined(modelSettings ?? {}),
 			...toAiSdkCallSettings(request),
 			...maxStepsSetting(request)
 		};
 		if (isStructuredOutputRequest(request)) {
-			const envelope = require_decision.buildEnvelopeSchema(request.outputSchema, { reasoning: request.reasoning });
+			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;
@@ -235,7 +295,7 @@ function createAiSdkExecutors(options) {
 			return {
 				output,
 				...reasoning !== void 0 ? { reasoning } : {},
-				usage: result.usage,
+				usage: toAgentCallUsage(result.usage),
 				finishReason: result.finishReason,
 				toolCalls: result.toolCalls,
 				toolResults: result.toolResults
@@ -244,44 +304,47 @@ function createAiSdkExecutors(options) {
 		const result = await (0, ai.generateText)(common);
 		return {
 			output: result.text,
-			usage: result.usage,
+			usage: toAgentCallUsage(result.usage),
 			finishReason: result.finishReason,
 			toolCalls: result.toolCalls,
 			toolResults: result.toolResults
 		};
 	};
 	const streamText = async (request, info) => {
+		const { model, settings: modelSettings } = resolveAiSdkModel(options, request.model);
 		const result = (0, ai.streamText)({
-			model: resolveAiSdkModel(options, request.model),
+			model,
 			abortSignal: info?.signal,
+			...callSettings(options, request),
+			...defined(modelSettings ?? {}),
 			...toAiSdkCallSettings(request),
 			...maxStepsSetting(request)
 		});
 		for await (const chunk of result.textStream) info?.onChunk?.(chunk);
 		return {
 			output: await result.text,
-			usage: await result.usage,
+			usage: toAgentCallUsage(await result.usage),
 			finishReason: await result.finishReason
 		};
 	};
 	const decide = async (request) => {
-		const model = resolveAiSdkModel(options, request.model);
+		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,
+			...callSettings(options, request),
+			...defined(modelSettings ?? {}),
 			system: request.system,
-			...messages ? { messages } : { prompt: request.prompt ?? "" },
+			...messages ? {
+				messages,
+				allowSystemInMessages: true
+			} : { prompt: request.prompt ?? "" },
 			tools,
 			toolChoice: "required",
 			stopWhen: (0, ai.stepCountIs)(1),
-			temperature: request.temperature,
-			maxOutputTokens: request.maxOutputTokens,
-			topP: request.topP,
-			topK: request.topK,
-			seed: request.seed,
-			stopSequences: request.stopSequences
+			...toAiSdkGenerationSettings(request)
 		});
 		const toolCall = result.toolCalls[0];
 		if (!toolCall) throw new Error("createAiSdkExecutors: decide — model did not call an event tool.");
@@ -292,7 +355,7 @@ function createAiSdkExecutors(options) {
 				...toolCall.input && typeof toolCall.input === "object" ? toolCall.input : {},
 				type: chosenEvent.type
 			},
-			usage: result.usage,
+			usage: toAgentCallUsage(result.usage),
 			finishReason: result.finishReason
 		};
 	};
@@ -305,3 +368,4 @@ function createAiSdkExecutors(options) {
 //#endregion
 exports.createAiSdkExecutors = createAiSdkExecutors;
 exports.defineModels = defineModels;
+exports.toLanguageModel = toLanguageModel;

package/dist/ai-sdk.d.cts

@@ -1,10 +1,28 @@
-import { d as ChosenEvent } from "./types-pJ5Hn8fv.cjs";
-import { A as AgentDecisionExecutor, l as AgentRequestExecutors, o as AgentRequestExecutor } from "./text-logic-Cavva1W6.cjs";
-import { FinishReason, LanguageModel, LanguageModelUsage, ToolSet, TypedToolCall, TypedToolResult } from "ai";
+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-Mmbgb2jy.cjs";
+import { FinishReason, LanguageModel, LanguageModelUsage, ToolSet, TypedToolCall, TypedToolResult, generateText } from "ai";
 
+//#region src/ai-sdk/mappers.d.ts
+/**
+ * One call's usage as the adapter reports it: the AI SDK's `LanguageModelUsage`
+ * plus the flat {@link AgentCallUsage} token fields core folds into a run's
+ * aggregated usage.
+ */
+type AiSdkCallUsage = LanguageModelUsage & Pick<AgentCallUsage, "reasoningTokens" | "cachedInputTokens">;
+//#endregion
 //#region src/ai-sdk/index.d.ts
-/** AI SDK model registry: maps model refs (as used in `setupAgent({ models })`/`AgentTextRequest.model`) to AI SDK `LanguageModel` values. The optional `TKey` parameter pins the ref keys (see {@link defineModels}); it defaults to `string`, so bare `AiSdkModelMap` stays `Record<string, LanguageModel>`. */
-type AiSdkModelMap<TKey extends string = string> = Record<TKey, LanguageModel>;
+/**
+ * One entry in an {@link AiSdkModelMap}: a bare `LanguageModel`, or a model
+ * paired with the {@link AiSdkCallSettings} that ref always runs with. The
+ * paired form is how a host gives a ref a persona — `deep` thinks harder than
+ * `quick` — without the machine naming a provider knob.
+ */
+type AiSdkModelEntry = LanguageModel | {
+  model: LanguageModel;
+  settings?: AiSdkCallSettings;
+};
+/** AI SDK model registry: maps model refs (as used in `setupAgent({ models })`/`AgentTextRequest.model`) to AI SDK `LanguageModel` values, or to `{ model, settings }` pairs. The optional `TKey` parameter pins the ref keys (see {@link defineModels}); it defaults to `string`, so bare `AiSdkModelMap` stays `Record<string, AiSdkModelEntry>`. */
+type AiSdkModelMap<TKey extends string = string> = Record<TKey, AiSdkModelEntry>;
 /**
  * Identity helper for a `models` map whose value is exported. Returns the map
  * unchanged, but types it as {@link AiSdkModelMap}`<keyof T & string>` — a
@@ -23,20 +41,45 @@ type AiSdkModelMap<TKey extends string = string> = Record<TKey, LanguageModel>;
  * // typeof models === AiSdkModelMap<'quick' | 'deep'>
  * ```
  */
-declare function defineModels<T extends Record<string, LanguageModel>>(models: T): AiSdkModelMap<keyof T & string>;
+declare function defineModels<T extends Record<string, AiSdkModelEntry>>(models: T): AiSdkModelMap<keyof T & string>;
+/**
+ * Per-call AI SDK settings a host can apply on top of what the machine asked
+ * for — reasoning effort, `providerOptions`, and anything else the SDK's call
+ * options accept. Typed straight off `generateText`, so it tracks the
+ * installed `ai` version instead of restating its vocabulary.
+ *
+ * The request's own fields (`model`, `prompt`/`messages`, `tools`, and the
+ * generation settings every provider shares) are excluded: those belong to the
+ * machine, and a host override would silently contradict it.
+ */
+type AiSdkCallSettings = Omit<Parameters<typeof generateText>[0], "model" | "prompt" | "messages" | "system" | "instructions" | "tools" | "toolChoice" | "output" | "abortSignal" | "stopWhen">;
 /**
  * Options for {@link createAiSdkExecutors}: either a static `models` map
  * (model refs resolved by lookup), a `resolveModel` function (refs resolved
  * dynamically, e.g. `"openai/gpt-5.4-mini"` → `openai('gpt-5.4-mini')`), or
  * both — `resolveModel` takes precedence when both are supplied.
+ *
+ * `settings` carries provider knobs that are the HOST's business rather than
+ * the machine's, such as reasoning effort. Pass an object to apply it to every
+ * call, or a function to vary it per request (`request.name` is the request's
+ * registered key). Core neither declares nor reads these: a machine stays
+ * portable, and a host that cannot honor a knob simply does not set it.
  */
 type CreateAiSdkExecutorsOptions<TModels extends AiSdkModelMap = AiSdkModelMap> = {
+  settings?: AiSdkCallSettings | ((request: AgentTextRequest | AgentDecisionRequest) => AiSdkCallSettings | undefined);
+} & ({
   models: TModels;
   resolveModel?: (modelRef: keyof TModels & string) => LanguageModel;
 } | {
   models?: TModels;
   resolveModel: (modelRef: string) => LanguageModel;
-};
+});
+/**
+ * The `LanguageModel` inside a map entry, whichever form it takes. `defineModels`
+ * widens its return to {@link AiSdkModelMap}, so reading an entry out of the map
+ * to hand to a raw AI SDK call needs this to get past the union.
+ */
+declare function toLanguageModel(entry: AiSdkModelEntry): LanguageModel;
 /**
  * Raw result shape from {@link AiSdkExecutors.generateText} — the `{ output }`
  * envelope (the validated structured object for structured-output requests,
@@ -54,8 +97,9 @@ type AiSdkGenerateResult = {
   reasoning?: string;
   /** The call's token usage. Its flat `inputTokens`/`outputTokens`/`totalTokens`/
    * `reasoningTokens`/`cachedInputTokens` fields are what `runAgent` folds into
-   * the run result's aggregated `AgentUsage`. */
-  usage: LanguageModelUsage;
+   * the run result's aggregated `AgentUsage`; the AI SDK's own nested
+   * `inputTokenDetails`/`outputTokenDetails` and `raw` ride along untouched. */
+  usage: AiSdkCallUsage;
   finishReason: FinishReason;
   toolCalls: TypedToolCall<ToolSet>[];
   toolResults: TypedToolResult<ToolSet>[];
@@ -63,13 +107,13 @@ type AiSdkGenerateResult = {
 /** 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: LanguageModelUsage;
+  usage: AiSdkCallUsage;
   finishReason: FinishReason;
 };
 /** Raw result shape from {@link AiSdkExecutors.decide} — the chosen event plus the AI SDK call metadata, delivered per decision attempt to `onResult`. */
 type AiSdkDecideResult = {
   event: ChosenEvent; /** This attempt's usage; aggregated into the run result's `AgentUsage`. */
-  usage: LanguageModelUsage;
+  usage: AiSdkCallUsage;
   finishReason: FinishReason;
 };
 /** `createAiSdkExecutors` always populates all three slots (unlike the
@@ -96,4 +140,4 @@ interface AiSdkExecutors extends AgentRequestExecutors<AiSdkGenerateResult, AiSd
  */
 declare function createAiSdkExecutors<TModels extends AiSdkModelMap>(options: CreateAiSdkExecutorsOptions<TModels>): AiSdkExecutors;
 //#endregion
-export { AiSdkDecideResult, AiSdkExecutors, AiSdkGenerateResult, AiSdkModelMap, AiSdkStreamResult, CreateAiSdkExecutorsOptions, createAiSdkExecutors, defineModels };
+export { AiSdkCallSettings, AiSdkDecideResult, AiSdkExecutors, AiSdkGenerateResult, AiSdkModelEntry, AiSdkModelMap, AiSdkStreamResult, CreateAiSdkExecutorsOptions, createAiSdkExecutors, defineModels, toLanguageModel };

package/dist/ai-sdk.d.mts

@@ -1,10 +1,28 @@
-import { d as ChosenEvent } from "./types-DYpK3QF4.mjs";
-import { A as AgentDecisionExecutor, l as AgentRequestExecutors, o as AgentRequestExecutor } from "./text-logic-Er5KkTX6.mjs";
-import { FinishReason, LanguageModel, LanguageModelUsage, ToolSet, TypedToolCall, TypedToolResult } from "ai";
+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-BR5twXCv.mjs";
+import { FinishReason, LanguageModel, LanguageModelUsage, ToolSet, TypedToolCall, TypedToolResult, generateText } from "ai";
 
+//#region src/ai-sdk/mappers.d.ts
+/**
+ * One call's usage as the adapter reports it: the AI SDK's `LanguageModelUsage`
+ * plus the flat {@link AgentCallUsage} token fields core folds into a run's
+ * aggregated usage.
+ */
+type AiSdkCallUsage = LanguageModelUsage & Pick<AgentCallUsage, "reasoningTokens" | "cachedInputTokens">;
+//#endregion
 //#region src/ai-sdk/index.d.ts
-/** AI SDK model registry: maps model refs (as used in `setupAgent({ models })`/`AgentTextRequest.model`) to AI SDK `LanguageModel` values. The optional `TKey` parameter pins the ref keys (see {@link defineModels}); it defaults to `string`, so bare `AiSdkModelMap` stays `Record<string, LanguageModel>`. */
-type AiSdkModelMap<TKey extends string = string> = Record<TKey, LanguageModel>;
+/**
+ * One entry in an {@link AiSdkModelMap}: a bare `LanguageModel`, or a model
+ * paired with the {@link AiSdkCallSettings} that ref always runs with. The
+ * paired form is how a host gives a ref a persona — `deep` thinks harder than
+ * `quick` — without the machine naming a provider knob.
+ */
+type AiSdkModelEntry = LanguageModel | {
+  model: LanguageModel;
+  settings?: AiSdkCallSettings;
+};
+/** AI SDK model registry: maps model refs (as used in `setupAgent({ models })`/`AgentTextRequest.model`) to AI SDK `LanguageModel` values, or to `{ model, settings }` pairs. The optional `TKey` parameter pins the ref keys (see {@link defineModels}); it defaults to `string`, so bare `AiSdkModelMap` stays `Record<string, AiSdkModelEntry>`. */
+type AiSdkModelMap<TKey extends string = string> = Record<TKey, AiSdkModelEntry>;
 /**
  * Identity helper for a `models` map whose value is exported. Returns the map
  * unchanged, but types it as {@link AiSdkModelMap}`<keyof T & string>` — a
@@ -23,20 +41,45 @@ type AiSdkModelMap<TKey extends string = string> = Record<TKey, LanguageModel>;
  * // typeof models === AiSdkModelMap<'quick' | 'deep'>
  * ```
  */
-declare function defineModels<T extends Record<string, LanguageModel>>(models: T): AiSdkModelMap<keyof T & string>;
+declare function defineModels<T extends Record<string, AiSdkModelEntry>>(models: T): AiSdkModelMap<keyof T & string>;
+/**
+ * Per-call AI SDK settings a host can apply on top of what the machine asked
+ * for — reasoning effort, `providerOptions`, and anything else the SDK's call
+ * options accept. Typed straight off `generateText`, so it tracks the
+ * installed `ai` version instead of restating its vocabulary.
+ *
+ * The request's own fields (`model`, `prompt`/`messages`, `tools`, and the
+ * generation settings every provider shares) are excluded: those belong to the
+ * machine, and a host override would silently contradict it.
+ */
+type AiSdkCallSettings = Omit<Parameters<typeof generateText>[0], "model" | "prompt" | "messages" | "system" | "instructions" | "tools" | "toolChoice" | "output" | "abortSignal" | "stopWhen">;
 /**
  * Options for {@link createAiSdkExecutors}: either a static `models` map
  * (model refs resolved by lookup), a `resolveModel` function (refs resolved
  * dynamically, e.g. `"openai/gpt-5.4-mini"` → `openai('gpt-5.4-mini')`), or
  * both — `resolveModel` takes precedence when both are supplied.
+ *
+ * `settings` carries provider knobs that are the HOST's business rather than
+ * the machine's, such as reasoning effort. Pass an object to apply it to every
+ * call, or a function to vary it per request (`request.name` is the request's
+ * registered key). Core neither declares nor reads these: a machine stays
+ * portable, and a host that cannot honor a knob simply does not set it.
  */
 type CreateAiSdkExecutorsOptions<TModels extends AiSdkModelMap = AiSdkModelMap> = {
+  settings?: AiSdkCallSettings | ((request: AgentTextRequest | AgentDecisionRequest) => AiSdkCallSettings | undefined);
+} & ({
   models: TModels;
   resolveModel?: (modelRef: keyof TModels & string) => LanguageModel;
 } | {
   models?: TModels;
   resolveModel: (modelRef: string) => LanguageModel;
-};
+});
+/**
+ * The `LanguageModel` inside a map entry, whichever form it takes. `defineModels`
+ * widens its return to {@link AiSdkModelMap}, so reading an entry out of the map
+ * to hand to a raw AI SDK call needs this to get past the union.
+ */
+declare function toLanguageModel(entry: AiSdkModelEntry): LanguageModel;
 /**
  * Raw result shape from {@link AiSdkExecutors.generateText} — the `{ output }`
  * envelope (the validated structured object for structured-output requests,
@@ -54,8 +97,9 @@ type AiSdkGenerateResult = {
   reasoning?: string;
   /** The call's token usage. Its flat `inputTokens`/`outputTokens`/`totalTokens`/
    * `reasoningTokens`/`cachedInputTokens` fields are what `runAgent` folds into
-   * the run result's aggregated `AgentUsage`. */
-  usage: LanguageModelUsage;
+   * the run result's aggregated `AgentUsage`; the AI SDK's own nested
+   * `inputTokenDetails`/`outputTokenDetails` and `raw` ride along untouched. */
+  usage: AiSdkCallUsage;
   finishReason: FinishReason;
   toolCalls: TypedToolCall<ToolSet>[];
   toolResults: TypedToolResult<ToolSet>[];
@@ -63,13 +107,13 @@ type AiSdkGenerateResult = {
 /** 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: LanguageModelUsage;
+  usage: AiSdkCallUsage;
   finishReason: FinishReason;
 };
 /** Raw result shape from {@link AiSdkExecutors.decide} — the chosen event plus the AI SDK call metadata, delivered per decision attempt to `onResult`. */
 type AiSdkDecideResult = {
   event: ChosenEvent; /** This attempt's usage; aggregated into the run result's `AgentUsage`. */
-  usage: LanguageModelUsage;
+  usage: AiSdkCallUsage;
   finishReason: FinishReason;
 };
 /** `createAiSdkExecutors` always populates all three slots (unlike the
@@ -96,4 +140,4 @@ interface AiSdkExecutors extends AgentRequestExecutors<AiSdkGenerateResult, AiSd
  */
 declare function createAiSdkExecutors<TModels extends AiSdkModelMap>(options: CreateAiSdkExecutorsOptions<TModels>): AiSdkExecutors;
 //#endregion
-export { AiSdkDecideResult, AiSdkExecutors, AiSdkGenerateResult, AiSdkModelMap, AiSdkStreamResult, CreateAiSdkExecutorsOptions, createAiSdkExecutors, defineModels };
+export { AiSdkCallSettings, AiSdkDecideResult, AiSdkExecutors, AiSdkGenerateResult, AiSdkModelEntry, AiSdkModelMap, AiSdkStreamResult, CreateAiSdkExecutorsOptions, createAiSdkExecutors, defineModels, toLanguageModel };

package/dist/ai-sdk.mjs

@@ -1,4 +1,4 @@
-import { H as isStandardSchema, _ as getAgentOutputMode, i as renderDecisionAttempts, p as buildEnvelopeSchema } from "./decision-BfhSgCc6.mjs";
+import { W as isStandardSchema, h as buildEnvelopeSchema, i as renderDecisionAttempts, y as getAgentOutputMode } from "./decision-JWx6n3xR.mjs";
 import { NoObjectGeneratedError, Output, generateText, stepCountIs, streamText, tool } from "ai";
 //#region src/ai-sdk/mappers.ts
 /**
@@ -49,6 +49,27 @@ const unknownSchema = { "~standard": {
 	jsonSchema: { input: () => ({}) }
 } };
 /**
+* Folds AI SDK v7's nested token details onto the flat field names core
+* aggregates. v7 moved `reasoningTokens` under `outputTokenDetails` and the
+* cached-input count under `inputTokenDetails.cacheReadTokens`, while
+* {@link AgentCallUsage} stays flat and provider-agnostic. The SDK's own shape
+* is spread through unchanged, so `onResult` consumers still see every field
+* the provider reported, including v7's `raw`.
+*/
+function toAgentCallUsage(usage) {
+	const reasoningTokens = usage.outputTokenDetails?.reasoningTokens;
+	const cachedInputTokens = usage.inputTokenDetails?.cacheReadTokens;
+	return {
+		...usage,
+		...reasoningTokens !== void 0 ? { reasoningTokens } : {},
+		...cachedInputTokens !== void 0 ? { cachedInputTokens } : {}
+	};
+}
+/** 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));
+}
+/**
 * AI SDK request-mapping settings shared by `generateText`/`streamText`.
 * `AgentTextRequest.messages` (`AgentMessage[]`) and AI SDK's `ModelMessage[]`
 * are structurally compatible by design (§1 of .scratch/p0-design.md) — the cast
@@ -58,16 +79,36 @@ function toAiSdkCallSettings(request) {
 	const messages = request.messages;
 	return {
 		system: request.system,
-		...messages ? { messages } : { prompt: request.prompt ?? "" },
+		...messages ? {
+			messages,
+			allowSystemInMessages: true
+		} : { prompt: request.prompt ?? "" },
+		...toAiSdkGenerationSettings(request),
+		...defined({
+			tools: request.tools ? toAiSdkTools(request.tools) : void 0,
+			toolChoice: toAiSdkToolChoice(request.toolChoice)
+		})
+	};
+}
+/**
+* The generation settings a text request and a decision request share, with
+* unset keys omitted.
+*
+* Omitting matters: these settings are one layer of a stack — the host's
+* `createAiSdkExecutors({ settings })`, then the model ref's own, then the
+* request's — and an `undefined` spread over a layer below erases it. Both the
+* text path and `decide` map their settings through here so neither can drift
+* back into writing the keys unconditionally.
+*/
+function toAiSdkGenerationSettings(request) {
+	return defined({
 		temperature: request.temperature,
 		maxOutputTokens: request.maxOutputTokens,
 		topP: request.topP,
 		topK: request.topK,
 		seed: request.seed,
-		stopSequences: request.stopSequences,
-		tools: request.tools ? toAiSdkTools(request.tools) : void 0,
-		toolChoice: toAiSdkToolChoice(request.toolChoice)
-	};
+		stopSequences: request.stopSequences
+	});
 }
 /** Maps an {@link AgentToolChoice} to AI SDK's tool-choice shape — `{ type: 'tool'; name }` becomes `{ type: 'tool'; toolName }`; `'auto'`/`'none'`/`'required'`/`undefined` pass through unchanged. */
 function toAiSdkToolChoice(toolChoice) {
@@ -165,13 +206,29 @@ function maxStepsSetting(request) {
 function defineModels(models) {
 	return models;
 }
+/** Resolves the host's `settings` option for one request. */
+function callSettings(options, request) {
+	const settings = options.settings;
+	return (typeof settings === "function" ? settings(request) : settings) ?? {};
+}
 function resolveAiSdkModel(options, modelRef) {
-	if (options.resolveModel) return options.resolveModel(modelRef);
+	if (options.resolveModel) return { model: options.resolveModel(modelRef) };
 	const models = options.models;
 	if (!models) throw new Error(`createAiSdkExecutors: no model resolver configured for '${modelRef}'.`);
-	const model = models[modelRef];
-	if (!model) throw new Error(`createAiSdkExecutors: unknown model '${modelRef}'.`);
-	return model;
+	const entry = models[modelRef];
+	if (!entry) throw new Error(`createAiSdkExecutors: unknown model '${modelRef}'.`);
+	return isModelWithSettings(entry) ? entry : { model: entry };
+}
+/**
+* The `LanguageModel` inside a map entry, whichever form it takes. `defineModels`
+* widens its return to {@link AiSdkModelMap}, so reading an entry out of the map
+* to hand to a raw AI SDK call needs this to get past the union.
+*/
+function toLanguageModel(entry) {
+	return isModelWithSettings(entry) ? entry.model : entry;
+}
+function isModelWithSettings(entry) {
+	return typeof entry === "object" && entry !== null && "model" in entry;
 }
 function withJsonRepair(output) {
 	return {
@@ -206,14 +263,17 @@ function withJsonRepair(output) {
 */
 function createAiSdkExecutors(options) {
 	const generateText$1 = async (request, info) => {
+		const { model, settings: modelSettings } = resolveAiSdkModel(options, request.model);
 		const common = {
-			model: resolveAiSdkModel(options, request.model),
+			model,
 			abortSignal: info?.signal,
+			...callSettings(options, request),
+			...defined(modelSettings ?? {}),
 			...toAiSdkCallSettings(request),
 			...maxStepsSetting(request)
 		};
 		if (isStructuredOutputRequest(request)) {
-			const envelope = buildEnvelopeSchema(request.outputSchema, { reasoning: request.reasoning });
+			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;
@@ -233,7 +293,7 @@ function createAiSdkExecutors(options) {
 			return {
 				output,
 				...reasoning !== void 0 ? { reasoning } : {},
-				usage: result.usage,
+				usage: toAgentCallUsage(result.usage),
 				finishReason: result.finishReason,
 				toolCalls: result.toolCalls,
 				toolResults: result.toolResults
@@ -242,44 +302,47 @@ function createAiSdkExecutors(options) {
 		const result = await generateText(common);
 		return {
 			output: result.text,
-			usage: result.usage,
+			usage: toAgentCallUsage(result.usage),
 			finishReason: result.finishReason,
 			toolCalls: result.toolCalls,
 			toolResults: result.toolResults
 		};
 	};
 	const streamText$1 = async (request, info) => {
+		const { model, settings: modelSettings } = resolveAiSdkModel(options, request.model);
 		const result = streamText({
-			model: resolveAiSdkModel(options, request.model),
+			model,
 			abortSignal: info?.signal,
+			...callSettings(options, request),
+			...defined(modelSettings ?? {}),
 			...toAiSdkCallSettings(request),
 			...maxStepsSetting(request)
 		});
 		for await (const chunk of result.textStream) info?.onChunk?.(chunk);
 		return {
 			output: await result.text,
-			usage: await result.usage,
+			usage: toAgentCallUsage(await result.usage),
 			finishReason: await result.finishReason
 		};
 	};
 	const decide = async (request) => {
-		const model = resolveAiSdkModel(options, request.model);
+		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,
+			...callSettings(options, request),
+			...defined(modelSettings ?? {}),
 			system: request.system,
-			...messages ? { messages } : { prompt: request.prompt ?? "" },
+			...messages ? {
+				messages,
+				allowSystemInMessages: true
+			} : { prompt: request.prompt ?? "" },
 			tools,
 			toolChoice: "required",
 			stopWhen: stepCountIs(1),
-			temperature: request.temperature,
-			maxOutputTokens: request.maxOutputTokens,
-			topP: request.topP,
-			topK: request.topK,
-			seed: request.seed,
-			stopSequences: request.stopSequences
+			...toAiSdkGenerationSettings(request)
 		});
 		const toolCall = result.toolCalls[0];
 		if (!toolCall) throw new Error("createAiSdkExecutors: decide — model did not call an event tool.");
@@ -290,7 +353,7 @@ function createAiSdkExecutors(options) {
 				...toolCall.input && typeof toolCall.input === "object" ? toolCall.input : {},
 				type: chosenEvent.type
 			},
-			usage: result.usage,
+			usage: toAgentCallUsage(result.usage),
 			finishReason: result.finishReason
 		};
 	};
@@ -301,4 +364,4 @@ function createAiSdkExecutors(options) {
 	};
 }
 //#endregion
-export { createAiSdkExecutors, defineModels };
+export { createAiSdkExecutors, defineModels, toLanguageModel };