@statelyai/agent 2.0.0-alpha.10 → 2.0.0-alpha.12

package/dist/ai-sdk.cjs

@@ -1,8 +1,7 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
-const require_run_agent = require("./run-agent-BFMkuI1F.cjs");
-const require_decision = require("./decision-b-lkcs4L.cjs");
+const require_decision = require("./decision-dWGhBh0P.cjs");
 let ai = require("ai");
-//#region src/ai-sdk/index.ts
+//#region src/ai-sdk/mappers.ts
 /**
 * Maps an {@link AgentTools} map onto AI SDK `tool()` definitions. A tool that
 * already carries its own Standard Schema `inputSchema` — an AI SDK
@@ -11,8 +10,7 @@ let ai = require("ai");
 * every extra property (`providerOptions`, `toModelOutput`, …) survives. A bare
 * `AgentToolExecute` function becomes a tool with an unconstrained input schema;
 * a minimal descriptor with no readable schema is converted with a permissive
-* fallback. Used internally by {@link toAiSdkCallSettings}; exported for callers
-* building AI SDK calls by hand outside `createAiSdkExecutors`.
+* fallback. Used by {@link toAiSdkCallSettings}.
 */
 function toAiSdkTools(tools) {
 	const entries = [];
@@ -45,9 +43,6 @@ function toAiSdkTools(tools) {
 	}
 	return Object.fromEntries(entries);
 }
-function maxStepsSetting(request) {
-	return typeof request.metadata?.maxSteps === "number" ? { stopWhen: (0, ai.stepCountIs)(request.metadata.maxSteps) } : {};
-}
 const unknownSchema = { "~standard": {
 	version: 1,
 	vendor: "statelyai-agent",
@@ -55,35 +50,6 @@ const unknownSchema = { "~standard": {
 	jsonSchema: { input: () => ({}) }
 } };
 /**
-* Identity helper for a `models` map whose value is exported. Returns the map
-* unchanged, but types it as {@link AiSdkModelMap}`<keyof T & string>` — a
-* portable, nameable type — so an exported `const models = defineModels({...})`
-* needs no `Record<'a' | 'b', LanguageModel>` annotation and never triggers
-* TS2742 ("inferred type cannot be named without a reference to …"). The exact
-* ref keys survive, so `createAiSdkExecutors({ models })` and
-* `setupAgent({ models })` still infer/autocomplete them.
-*
-* @example
-* ```ts
-* export const models = defineModels({
-*   quick: openai('gpt-5.4-mini'),
-*   deep: openai('gpt-5.4'),
-* });
-* // typeof models === AiSdkModelMap<'quick' | 'deep'>
-* ```
-*/
-function defineModels(models) {
-	return models;
-}
-function resolveAiSdkModel(options, modelRef) {
-	if (options.resolveModel) return 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;
-}
-/**
 * 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
@@ -148,6 +114,65 @@ function extractFirstJsonValue(text) {
 		}
 	}
 }
+/** One AI SDK `tool()` per candidate event — the "tool-per-event +
+* toolChoice: 'required'" recipe from .scratch/p0-design.md §2.6. */
+function toAiSdkEventTools(events) {
+	return Object.fromEntries(events.map((event) => [event.toolName, (0, ai.tool)({
+		description: `Choose the '${event.type}' move.`,
+		inputSchema: event.inputSchema ? event.inputSchema : unknownSchema
+	})]));
+}
+/**
+* Messages for a decision request, with prior failed `attempts` (§2.6)
+* rendered as appended user messages (via core's {@link renderDecisionAttempts})
+* so retries converge. Core never rewrites prompts — this is adapter business.
+*/
+function toDecisionMessages(request) {
+	if (!request.messages && request.attempts.length === 0) return;
+	const messages = [...request.messages ?? (request.prompt !== void 0 ? [{
+		role: "user",
+		content: request.prompt
+	}] : [])];
+	for (const attempt of require_decision.renderDecisionAttempts(request)) messages.push({
+		role: "user",
+		content: attempt.content
+	});
+	return messages;
+}
+//#endregion
+//#region src/ai-sdk/index.ts
+function maxStepsSetting(request) {
+	return typeof request.metadata?.maxSteps === "number" ? { stopWhen: (0, ai.stepCountIs)(request.metadata.maxSteps) } : {};
+}
+/**
+* Identity helper for a `models` map whose value is exported. Returns the map
+* unchanged, but types it as {@link AiSdkModelMap}`<keyof T & string>` — a
+* portable, nameable type — so an exported `const models = defineModels({...})`
+* needs no `Record<'a' | 'b', LanguageModel>` annotation and never triggers
+* TS2742 ("inferred type cannot be named without a reference to …"). The exact
+* ref keys survive, so `createAiSdkExecutors({ models })` and
+* `setupAgent({ models })` still infer/autocomplete them.
+*
+* @example
+* ```ts
+* export const models = defineModels({
+*   quick: openai('gpt-5.4-mini'),
+*   deep: openai('gpt-5.4'),
+* });
+* // typeof models === AiSdkModelMap<'quick' | 'deep'>
+* ```
+*/
+function defineModels(models) {
+	return models;
+}
+function resolveAiSdkModel(options, modelRef) {
+	if (options.resolveModel) return 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;
+}
 function withJsonRepair(output) {
 	return {
 		...output,
@@ -275,68 +300,6 @@ function createAiSdkExecutors(options) {
 		decide
 	};
 }
-/** AI SDK host for a machine authored with `setupAgent({ models })`. */
-function runAgent(machine, options) {
-	const models = require_decision.getRegisteredAgentModels(machine);
-	if (!models || Object.keys(models).length === 0) throw new Error("AI SDK runAgent: machine has no models. Pass `models` to setupAgent, or use core runAgent with explicit executors.");
-	return require_run_agent.runAgent(machine, {
-		...options,
-		executors: createAiSdkExecutors({ models })
-	});
-}
-function createAgent(config) {
-	const { model, models: configuredModels, schemas, ...machineConfig } = config;
-	const models = configuredModels ?? { default: model };
-	const executors = createAiSdkExecutors({ models });
-	const machine = require_run_agent.setupAgent({
-		...schemas,
-		models
-	}).createMachine(machineConfig);
-	return {
-		machine,
-		run(runInput, options = {}) {
-			return require_run_agent.runAgent(machine, {
-				...options,
-				input: runInput,
-				executors
-			});
-		}
-	};
-}
-/** One AI SDK `tool()` per candidate event — the "tool-per-event +
-* toolChoice: 'required'" recipe from .scratch/p0-design.md §2.6. */
-function toAiSdkEventTools(events) {
-	return Object.fromEntries(events.map((event) => [event.toolName, (0, ai.tool)({
-		description: `Choose the '${event.type}' move.`,
-		inputSchema: event.inputSchema ? event.inputSchema : unknownSchema
-	})]));
-}
-/**
-* Messages for a decision request, with prior failed `attempts` (§2.6)
-* rendered as appended user messages (via core's {@link renderDecisionAttempts})
-* so retries converge. Core never rewrites prompts — this is adapter business.
-*/
-function toDecisionMessages(request) {
-	if (!request.messages && request.attempts.length === 0) return;
-	const messages = [...request.messages ?? (request.prompt !== void 0 ? [{
-		role: "user",
-		content: request.prompt
-	}] : [])];
-	for (const attempt of require_decision.renderDecisionAttempts(request)) messages.push({
-		role: "user",
-		content: attempt.content
-	});
-	return messages;
-}
 //#endregion
-exports.createAgent = createAgent;
 exports.createAiSdkExecutors = createAiSdkExecutors;
 exports.defineModels = defineModels;
-exports.extractFirstJsonValue = extractFirstJsonValue;
-exports.isStructuredOutputRequest = isStructuredOutputRequest;
-exports.runAgent = runAgent;
-exports.toAiSdkCallSettings = toAiSdkCallSettings;
-exports.toAiSdkEventTools = toAiSdkEventTools;
-exports.toAiSdkToolChoice = toAiSdkToolChoice;
-exports.toAiSdkTools = toAiSdkTools;
-exports.toDecisionMessages = toDecisionMessages;

package/dist/ai-sdk.d.cts

@@ -1,24 +1,8 @@
-import { C as StandardSchemaV1, m as ChosenEvent, n as AgentEventSchemaInputMap, u as AgentTools } from "./types-C9QiMjre.cjs";
-import { H as AgentEventDescriptor, i as AgentRequestExecutor, j as AgentDecisionRequest, k as AgentDecisionExecutor, l as AgentTextRequest, s as AgentRequestExecutors } from "./text-logic-CZjyACzQ.cjs";
-import { D as AgentMachine, O as AgentMachineConfig, l as RunAgentOptions, u as RunAgentResult } from "./run-agent-BVMd--1l.cjs";
-import * as _$xstate from "xstate";
-import { FinishReason, LanguageModel, LanguageModelUsage, ModelMessage, Tool, ToolSet, TypedToolCall, TypedToolResult } from "ai";
+import { d as ChosenEvent } from "./types-QbEfCVny.cjs";
+import { O as AgentDecisionExecutor, a as AgentRequestExecutor, c as AgentRequestExecutors } from "./text-logic-CorGzucG.cjs";
+import { FinishReason, LanguageModel, LanguageModelUsage, ToolSet, TypedToolCall, TypedToolResult } from "ai";
 
 //#region src/ai-sdk/index.d.ts
-/**
- * Maps an {@link AgentTools} map onto AI SDK `tool()` definitions. A tool that
- * already carries its own Standard Schema `inputSchema` — an AI SDK
- * `tool({...})`, or any equivalent descriptor — is passed through **unchanged**,
- * so the SDK applies its own validation, calls `execute(input, options)`, and
- * every extra property (`providerOptions`, `toModelOutput`, …) survives. A bare
- * `AgentToolExecute` function becomes a tool with an unconstrained input schema;
- * a minimal descriptor with no readable schema is converted with a permissive
- * fallback. Used internally by {@link toAiSdkCallSettings}; exported for callers
- * building AI SDK calls by hand outside `createAiSdkExecutors`.
- */
-declare function toAiSdkTools(tools: AgentTools): {
-  [k: string]: Tool<unknown, unknown> | Tool<unknown, never>;
-};
 /** 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>;
 /**
@@ -53,63 +37,6 @@ type CreateAiSdkExecutorsOptions<TModels extends AiSdkModelMap = AiSdkModelMap>
   models?: TModels;
   resolveModel: (modelRef: string) => LanguageModel;
 };
-/**
- * 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
- * below is a typed identity mapping, not a semantic conversion.
- */
-declare function toAiSdkCallSettings(request: AgentTextRequest & {
-  tools?: AgentTools;
-}): {
-  temperature: number | undefined;
-  maxOutputTokens: number | undefined;
-  topP: number | undefined;
-  topK: number | undefined;
-  seed: number | undefined;
-  stopSequences: string[] | undefined;
-  tools: {
-    [k: string]: Tool<unknown, unknown> | Tool<unknown, never>;
-  } | undefined;
-  toolChoice: "auto" | "none" | "required" | {
-    type: "tool";
-    toolName: string;
-  } | undefined;
-  messages: ModelMessage[];
-  system: string | undefined;
-} | {
-  temperature: number | undefined;
-  maxOutputTokens: number | undefined;
-  topP: number | undefined;
-  topK: number | undefined;
-  seed: number | undefined;
-  stopSequences: string[] | undefined;
-  tools: {
-    [k: string]: Tool<unknown, unknown> | Tool<unknown, never>;
-  } | undefined;
-  toolChoice: "auto" | "none" | "required" | {
-    type: "tool";
-    toolName: string;
-  } | undefined;
-  prompt: string;
-  system: string | undefined;
-};
-/** 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. */
-declare function toAiSdkToolChoice(toolChoice: AgentTextRequest["toolChoice"]): "auto" | "none" | "required" | {
-  type: "tool";
-  toolName: string;
-} | undefined;
-/** `true` when the request should use AI SDK structured `Output.object`. */
-declare function isStructuredOutputRequest(request: Pick<AgentTextRequest, "outputSchema">): boolean;
-/**
- * Extracts the first complete top-level JSON value from `text`, or returns
- * `undefined` when there is nothing to repair (no complete value, or the value
- * already spans the whole text). Models occasionally emit two structured-output
- * envelopes back to back (`{"result":{…}}{"result":{…}}`), which fails JSON
- * parsing wholesale; the balanced scan below recovers the first value and
- * drops the rest.
- */
-declare function extractFirstJsonValue(text: string): string | undefined;
 /**
  * Raw result shape from {@link AiSdkExecutors.generateText} — the `{ output }`
  * envelope (the validated structured object for structured-output requests,
@@ -125,6 +52,9 @@ type AiSdkGenerateResult = {
    * `reasoning: true` and the model produced it (see the structured-output
    * envelope in {@link buildEnvelopeSchema}). Never enters machine context/output. */
   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;
   finishReason: FinishReason;
   toolCalls: TypedToolCall<ToolSet>[];
@@ -132,13 +62,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;
+  output: string; /** The stream's final (awaited) usage; aggregated into the run result's `AgentUsage`. */
   usage: LanguageModelUsage;
   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;
+  event: ChosenEvent; /** This attempt's usage; aggregated into the run result's `AgentUsage`. */
   usage: LanguageModelUsage;
   finishReason: FinishReason;
 };
@@ -146,6 +76,7 @@ type AiSdkDecideResult = {
  * 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;
 }
@@ -164,43 +95,5 @@ interface AiSdkExecutors extends AgentRequestExecutors<AiSdkGenerateResult, AiSd
  * ```
  */
 declare function createAiSdkExecutors<TModels extends AiSdkModelMap>(options: CreateAiSdkExecutorsOptions<TModels>): AiSdkExecutors;
-/** AI SDK host for a machine authored with `setupAgent({ models })`. */
-declare function runAgent<TMachine extends _$xstate.AnyStateMachine>(machine: TMachine, options: Omit<RunAgentOptions<TMachine>, "executors">): Promise<RunAgentResult<TMachine>>;
-type CreateAgentMachineConfig<TContextSchema extends StandardSchemaV1<Record<string, unknown>>, TInputSchema extends StandardSchemaV1, TEventSchemas extends AgentEventSchemaInputMap, TOutputSchema extends StandardSchemaV1, TModels extends AiSdkModelMap> = Omit<AgentMachineConfig<TContextSchema, TInputSchema, TEventSchemas, TOutputSchema, TModels>, "schemas">;
-type CreateAgentBaseConfig<TContextSchema extends StandardSchemaV1<Record<string, unknown>>, TInputSchema extends StandardSchemaV1, TEventSchemas extends AgentEventSchemaInputMap, TOutputSchema extends StandardSchemaV1, TModels extends AiSdkModelMap> = CreateAgentMachineConfig<TContextSchema, TInputSchema, TEventSchemas, TOutputSchema, TModels> & {
-  schemas: {
-    context: TContextSchema;
-    input: TInputSchema;
-    events?: TEventSchemas;
-    output?: TOutputSchema;
-  };
-};
-interface CreatedAgent<TMachine extends _$xstate.AnyStateMachine> {
-  machine: TMachine;
-  run(input: _$xstate.InputFrom<TMachine>, options?: Omit<RunAgentOptions<TMachine>, "input" | "executors">): Promise<RunAgentResult<TMachine>>;
-}
-/**
- * One-call AI SDK entry point for the common case: creates a typed machine and
- * a `run(input)` method with model executors already wired.
- */
-declare function createAgent<TContextSchema extends StandardSchemaV1<Record<string, unknown>>, TInputSchema extends StandardSchemaV1, TEventSchemas extends AgentEventSchemaInputMap = {}, TOutputSchema extends StandardSchemaV1 = StandardSchemaV1>(config: CreateAgentBaseConfig<TContextSchema, TInputSchema, TEventSchemas, TOutputSchema, AiSdkModelMap<"default">> & {
-  model: LanguageModel;
-  models?: never;
-}): CreatedAgent<AgentMachine<TContextSchema, TInputSchema, TEventSchemas, TOutputSchema, AiSdkModelMap<"default">>>;
-declare function createAgent<TModels extends AiSdkModelMap, TContextSchema extends StandardSchemaV1<Record<string, unknown>>, TInputSchema extends StandardSchemaV1, TEventSchemas extends AgentEventSchemaInputMap = {}, TOutputSchema extends StandardSchemaV1 = StandardSchemaV1>(config: CreateAgentBaseConfig<TContextSchema, TInputSchema, TEventSchemas, TOutputSchema, TModels> & {
-  models: TModels;
-  model?: never;
-}): CreatedAgent<AgentMachine<TContextSchema, TInputSchema, TEventSchemas, TOutputSchema, TModels>>;
-/** One AI SDK `tool()` per candidate event — the "tool-per-event +
- * toolChoice: 'required'" recipe from .scratch/p0-design.md §2.6. */
-declare function toAiSdkEventTools(events: AgentEventDescriptor[]): {
-  [k: string]: Tool<unknown, never>;
-};
-/**
- * Messages for a decision request, with prior failed `attempts` (§2.6)
- * rendered as appended user messages (via core's {@link renderDecisionAttempts})
- * so retries converge. Core never rewrites prompts — this is adapter business.
- */
-declare function toDecisionMessages(request: Pick<AgentDecisionRequest, "messages" | "prompt" | "events" | "attempts">): ModelMessage[] | undefined;
 //#endregion
-export { AiSdkDecideResult, AiSdkExecutors, AiSdkGenerateResult, AiSdkModelMap, AiSdkStreamResult, CreateAiSdkExecutorsOptions, CreatedAgent, createAgent, createAiSdkExecutors, defineModels, extractFirstJsonValue, isStructuredOutputRequest, runAgent, toAiSdkCallSettings, toAiSdkEventTools, toAiSdkToolChoice, toAiSdkTools, toDecisionMessages };
+export { AiSdkDecideResult, AiSdkExecutors, AiSdkGenerateResult, AiSdkModelMap, AiSdkStreamResult, CreateAiSdkExecutorsOptions, createAiSdkExecutors, defineModels };

package/dist/ai-sdk.d.mts

@@ -1,24 +1,8 @@
-import { C as StandardSchemaV1, m as ChosenEvent, n as AgentEventSchemaInputMap, u as AgentTools } from "./types-qm00QF91.mjs";
-import { H as AgentEventDescriptor, i as AgentRequestExecutor, j as AgentDecisionRequest, k as AgentDecisionExecutor, l as AgentTextRequest, s as AgentRequestExecutors } from "./text-logic-C7WJpCIc.mjs";
-import { D as AgentMachine, O as AgentMachineConfig, l as RunAgentOptions, u as RunAgentResult } from "./run-agent-DzYJb3CK.mjs";
-import * as _$xstate from "xstate";
-import { FinishReason, LanguageModel, LanguageModelUsage, ModelMessage, Tool, ToolSet, TypedToolCall, TypedToolResult } from "ai";
+import { d as ChosenEvent } from "./types-_FXoFBGO.mjs";
+import { O as AgentDecisionExecutor, a as AgentRequestExecutor, c as AgentRequestExecutors } from "./text-logic-DjR5PUVz.mjs";
+import { FinishReason, LanguageModel, LanguageModelUsage, ToolSet, TypedToolCall, TypedToolResult } from "ai";
 
 //#region src/ai-sdk/index.d.ts
-/**
- * Maps an {@link AgentTools} map onto AI SDK `tool()` definitions. A tool that
- * already carries its own Standard Schema `inputSchema` — an AI SDK
- * `tool({...})`, or any equivalent descriptor — is passed through **unchanged**,
- * so the SDK applies its own validation, calls `execute(input, options)`, and
- * every extra property (`providerOptions`, `toModelOutput`, …) survives. A bare
- * `AgentToolExecute` function becomes a tool with an unconstrained input schema;
- * a minimal descriptor with no readable schema is converted with a permissive
- * fallback. Used internally by {@link toAiSdkCallSettings}; exported for callers
- * building AI SDK calls by hand outside `createAiSdkExecutors`.
- */
-declare function toAiSdkTools(tools: AgentTools): {
-  [k: string]: Tool<unknown, unknown> | Tool<unknown, never>;
-};
 /** 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>;
 /**
@@ -53,63 +37,6 @@ type CreateAiSdkExecutorsOptions<TModels extends AiSdkModelMap = AiSdkModelMap>
   models?: TModels;
   resolveModel: (modelRef: string) => LanguageModel;
 };
-/**
- * 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
- * below is a typed identity mapping, not a semantic conversion.
- */
-declare function toAiSdkCallSettings(request: AgentTextRequest & {
-  tools?: AgentTools;
-}): {
-  temperature: number | undefined;
-  maxOutputTokens: number | undefined;
-  topP: number | undefined;
-  topK: number | undefined;
-  seed: number | undefined;
-  stopSequences: string[] | undefined;
-  tools: {
-    [k: string]: Tool<unknown, unknown> | Tool<unknown, never>;
-  } | undefined;
-  toolChoice: "auto" | "none" | "required" | {
-    type: "tool";
-    toolName: string;
-  } | undefined;
-  messages: ModelMessage[];
-  system: string | undefined;
-} | {
-  temperature: number | undefined;
-  maxOutputTokens: number | undefined;
-  topP: number | undefined;
-  topK: number | undefined;
-  seed: number | undefined;
-  stopSequences: string[] | undefined;
-  tools: {
-    [k: string]: Tool<unknown, unknown> | Tool<unknown, never>;
-  } | undefined;
-  toolChoice: "auto" | "none" | "required" | {
-    type: "tool";
-    toolName: string;
-  } | undefined;
-  prompt: string;
-  system: string | undefined;
-};
-/** 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. */
-declare function toAiSdkToolChoice(toolChoice: AgentTextRequest["toolChoice"]): "auto" | "none" | "required" | {
-  type: "tool";
-  toolName: string;
-} | undefined;
-/** `true` when the request should use AI SDK structured `Output.object`. */
-declare function isStructuredOutputRequest(request: Pick<AgentTextRequest, "outputSchema">): boolean;
-/**
- * Extracts the first complete top-level JSON value from `text`, or returns
- * `undefined` when there is nothing to repair (no complete value, or the value
- * already spans the whole text). Models occasionally emit two structured-output
- * envelopes back to back (`{"result":{…}}{"result":{…}}`), which fails JSON
- * parsing wholesale; the balanced scan below recovers the first value and
- * drops the rest.
- */
-declare function extractFirstJsonValue(text: string): string | undefined;
 /**
  * Raw result shape from {@link AiSdkExecutors.generateText} — the `{ output }`
  * envelope (the validated structured object for structured-output requests,
@@ -125,6 +52,9 @@ type AiSdkGenerateResult = {
    * `reasoning: true` and the model produced it (see the structured-output
    * envelope in {@link buildEnvelopeSchema}). Never enters machine context/output. */
   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;
   finishReason: FinishReason;
   toolCalls: TypedToolCall<ToolSet>[];
@@ -132,13 +62,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;
+  output: string; /** The stream's final (awaited) usage; aggregated into the run result's `AgentUsage`. */
   usage: LanguageModelUsage;
   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;
+  event: ChosenEvent; /** This attempt's usage; aggregated into the run result's `AgentUsage`. */
   usage: LanguageModelUsage;
   finishReason: FinishReason;
 };
@@ -146,6 +76,7 @@ type AiSdkDecideResult = {
  * 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;
 }
@@ -164,43 +95,5 @@ interface AiSdkExecutors extends AgentRequestExecutors<AiSdkGenerateResult, AiSd
  * ```
  */
 declare function createAiSdkExecutors<TModels extends AiSdkModelMap>(options: CreateAiSdkExecutorsOptions<TModels>): AiSdkExecutors;
-/** AI SDK host for a machine authored with `setupAgent({ models })`. */
-declare function runAgent<TMachine extends _$xstate.AnyStateMachine>(machine: TMachine, options: Omit<RunAgentOptions<TMachine>, "executors">): Promise<RunAgentResult<TMachine>>;
-type CreateAgentMachineConfig<TContextSchema extends StandardSchemaV1<Record<string, unknown>>, TInputSchema extends StandardSchemaV1, TEventSchemas extends AgentEventSchemaInputMap, TOutputSchema extends StandardSchemaV1, TModels extends AiSdkModelMap> = Omit<AgentMachineConfig<TContextSchema, TInputSchema, TEventSchemas, TOutputSchema, TModels>, "schemas">;
-type CreateAgentBaseConfig<TContextSchema extends StandardSchemaV1<Record<string, unknown>>, TInputSchema extends StandardSchemaV1, TEventSchemas extends AgentEventSchemaInputMap, TOutputSchema extends StandardSchemaV1, TModels extends AiSdkModelMap> = CreateAgentMachineConfig<TContextSchema, TInputSchema, TEventSchemas, TOutputSchema, TModels> & {
-  schemas: {
-    context: TContextSchema;
-    input: TInputSchema;
-    events?: TEventSchemas;
-    output?: TOutputSchema;
-  };
-};
-interface CreatedAgent<TMachine extends _$xstate.AnyStateMachine> {
-  machine: TMachine;
-  run(input: _$xstate.InputFrom<TMachine>, options?: Omit<RunAgentOptions<TMachine>, "input" | "executors">): Promise<RunAgentResult<TMachine>>;
-}
-/**
- * One-call AI SDK entry point for the common case: creates a typed machine and
- * a `run(input)` method with model executors already wired.
- */
-declare function createAgent<TContextSchema extends StandardSchemaV1<Record<string, unknown>>, TInputSchema extends StandardSchemaV1, TEventSchemas extends AgentEventSchemaInputMap = {}, TOutputSchema extends StandardSchemaV1 = StandardSchemaV1>(config: CreateAgentBaseConfig<TContextSchema, TInputSchema, TEventSchemas, TOutputSchema, AiSdkModelMap<"default">> & {
-  model: LanguageModel;
-  models?: never;
-}): CreatedAgent<AgentMachine<TContextSchema, TInputSchema, TEventSchemas, TOutputSchema, AiSdkModelMap<"default">>>;
-declare function createAgent<TModels extends AiSdkModelMap, TContextSchema extends StandardSchemaV1<Record<string, unknown>>, TInputSchema extends StandardSchemaV1, TEventSchemas extends AgentEventSchemaInputMap = {}, TOutputSchema extends StandardSchemaV1 = StandardSchemaV1>(config: CreateAgentBaseConfig<TContextSchema, TInputSchema, TEventSchemas, TOutputSchema, TModels> & {
-  models: TModels;
-  model?: never;
-}): CreatedAgent<AgentMachine<TContextSchema, TInputSchema, TEventSchemas, TOutputSchema, TModels>>;
-/** One AI SDK `tool()` per candidate event — the "tool-per-event +
- * toolChoice: 'required'" recipe from .scratch/p0-design.md §2.6. */
-declare function toAiSdkEventTools(events: AgentEventDescriptor[]): {
-  [k: string]: Tool<unknown, never>;
-};
-/**
- * Messages for a decision request, with prior failed `attempts` (§2.6)
- * rendered as appended user messages (via core's {@link renderDecisionAttempts})
- * so retries converge. Core never rewrites prompts — this is adapter business.
- */
-declare function toDecisionMessages(request: Pick<AgentDecisionRequest, "messages" | "prompt" | "events" | "attempts">): ModelMessage[] | undefined;
 //#endregion
-export { AiSdkDecideResult, AiSdkExecutors, AiSdkGenerateResult, AiSdkModelMap, AiSdkStreamResult, CreateAiSdkExecutorsOptions, CreatedAgent, createAgent, createAiSdkExecutors, defineModels, extractFirstJsonValue, isStructuredOutputRequest, runAgent, toAiSdkCallSettings, toAiSdkEventTools, toAiSdkToolChoice, toAiSdkTools, toDecisionMessages };
+export { AiSdkDecideResult, AiSdkExecutors, AiSdkGenerateResult, AiSdkModelMap, AiSdkStreamResult, CreateAiSdkExecutorsOptions, createAiSdkExecutors, defineModels };