@statelyai/agent 2.0.0-alpha.5 → 2.0.0-alpha.6

package/dist/ai-sdk.cjs

@@ -1,5 +1,5 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
-const require_decision = require("./decision-pC-bY2DE.cjs");
+const require_decision = require("./decision-CX3YdwrO.cjs");
 let ai = require("ai");
 //#region src/ai-sdk/index.ts
 /**

package/dist/ai-sdk.mjs

@@ -1,4 +1,4 @@
-import { W as isStandardSchema, b as buildEnvelopeSchema, l as renderDecisionAttempts, w as getAgentOutputMode } from "./decision-FTmbqSEe.mjs";
+import { G as isStandardSchema, T as getAgentOutputMode, l as renderDecisionAttempts, x as buildEnvelopeSchema } from "./decision-D1654JdD.mjs";
 import { Output, generateText, stepCountIs, streamText, tool } from "ai";
 //#region src/ai-sdk/index.ts
 /**

package/dist/cli.cjs

@@ -1,5 +1,5 @@
 #!/usr/bin/env node
-const require_src = require("./src-DcRsWPfV.cjs");
+const require_src = require("./src-wBfi-kTA.cjs");
 let node_fs = require("node:fs");
 //#region src/cli.ts
 /**

package/dist/cli.mjs

@@ -1,5 +1,5 @@
 #!/usr/bin/env node
-import { r as lintAgentMachine, v as setupAgent } from "./src-CjpHDU8F.mjs";
+import { r as lintAgentMachine, v as setupAgent } from "./src-CEa947Dm.mjs";
 import { readFileSync } from "node:fs";
 //#region src/cli.ts
 /**

package/dist/{decision-pC-bY2DE.cjs → decision-CX3YdwrO.cjs}

@@ -264,6 +264,8 @@ const GENERATE_TEXT_ACTOR = "agent.generateText";
 const STREAM_TEXT_ACTOR = "agent.streamText";
 const DECIDE_ACTOR = "agent.decide";
 const PLAN_ACTOR = "agent.plan";
+/** Synthetic `src` stamped on trace requests produced by `getRequests` state interpretation — NOT a registered actor source (nothing is invoked; the pass makes the call directly). */
+const INTERPRET_SOURCE = "agent.interpret";
 const agentTextInputSchema = { "~standard": {
 	version: 1,
 	vendor: "statelyai-agent",
@@ -953,6 +955,12 @@ Object.defineProperty(exports, "EVENT_TOOL_PREFIX", {
 		return EVENT_TOOL_PREFIX;
 	}
 });
+Object.defineProperty(exports, "INTERPRET_SOURCE", {
+	enumerable: true,
+	get: function() {
+		return INTERPRET_SOURCE;
+	}
+});
 Object.defineProperty(exports, "PLAN_ACTOR", {
 	enumerable: true,
 	get: function() {

package/dist/{decision-FTmbqSEe.mjs → decision-D1654JdD.mjs}

@@ -264,6 +264,8 @@ const GENERATE_TEXT_ACTOR = "agent.generateText";
 const STREAM_TEXT_ACTOR = "agent.streamText";
 const DECIDE_ACTOR = "agent.decide";
 const PLAN_ACTOR = "agent.plan";
+/** Synthetic `src` stamped on trace requests produced by `getRequests` state interpretation — NOT a registered actor source (nothing is invoked; the pass makes the call directly). */
+const INTERPRET_SOURCE = "agent.interpret";
 const agentTextInputSchema = { "~standard": {
 	version: 1,
 	vendor: "statelyai-agent",
@@ -935,4 +937,4 @@ async function resolveDecision(request, executor, options = {}) {
 	throw new DecisionExhaustedError(attempts);
 }
 //#endregion
-export { agentExecutionOptions as A, getJsonSchema as B, executeAgentTextRequest as C, normalizeGeneratorResult as D, isTextLogic as E, machineSuspensionPredicates as F, persistSnapshot as G, getMachineStructuralHash as H, missingActor as I, userMessage as J, systemMessage as K, assistantMessage as L, getMachineSuspensionPredicate as M, getRegisteredAgentExecutionOptions as N, parseOutput as O, isUnboundPlaceholder as P, findNonSerializableContextPaths as R, createTextLogic as S, isStructuredOutputSchema as T, getStateMeta as U, getJsonSchemaSync as V, isStandardSchema as W, validateSchemaSync as Y, PLAN_ACTOR as _, createPlanActor as a, buildEnvelopeSchema as b, isPlanLogic as c, EVENT_TOOL_PREFIX as d, getAcceptedEvents as f, DECIDE_ACTOR as g, sanitizeEventToolName as h, createDecideActor as i, executorBoundLogics as j, userInputActor as k, renderDecisionAttempts as l, parseAgentEvent as m, PLAN_DONE_EVENT_TYPE as n, initialPlanLedger as o, matchesEventPattern as p, toolMessage as q, advancePlanLedger as r, isDecisionLogic as s, DecisionExhaustedError as t, resolveDecision as u, USER_INPUT_ACTOR as v, getAgentOutputMode as w, builtinTextActors as x, bindRequestExecutor as y, getAgentMessages as z };
+export { userInputActor as A, getAgentMessages as B, createTextLogic as C, isTextLogic as D, isStructuredOutputSchema as E, isUnboundPlaceholder as F, isStandardSchema as G, getJsonSchemaSync as H, machineSuspensionPredicates as I, toolMessage as J, persistSnapshot as K, missingActor as L, executorBoundLogics as M, getMachineSuspensionPredicate as N, normalizeGeneratorResult as O, getRegisteredAgentExecutionOptions as P, assistantMessage as R, builtinTextActors as S, getAgentOutputMode as T, getMachineStructuralHash as U, getJsonSchema as V, getStateMeta as W, validateSchemaSync as X, userMessage as Y, INTERPRET_SOURCE as _, createPlanActor as a, bindRequestExecutor as b, isPlanLogic as c, EVENT_TOOL_PREFIX as d, getAcceptedEvents as f, DECIDE_ACTOR as g, sanitizeEventToolName as h, createDecideActor as i, agentExecutionOptions as j, parseOutput as k, renderDecisionAttempts as l, parseAgentEvent as m, PLAN_DONE_EVENT_TYPE as n, initialPlanLedger as o, matchesEventPattern as p, systemMessage as q, advancePlanLedger as r, isDecisionLogic as s, DecisionExhaustedError as t, resolveDecision as u, PLAN_ACTOR as v, executeAgentTextRequest as w, buildEnvelopeSchema as x, USER_INPUT_ACTOR as y, findNonSerializableContextPaths as z };

package/dist/index.cjs

@@ -1,6 +1,6 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
-const require_src = require("./src-DcRsWPfV.cjs");
-const require_decision = require("./decision-pC-bY2DE.cjs");
+const require_src = require("./src-wBfi-kTA.cjs");
+const require_decision = require("./decision-CX3YdwrO.cjs");
 exports.AgentIdleError = require_src.AgentIdleError;
 exports.DecisionExhaustedError = require_decision.DecisionExhaustedError;
 exports.EVENT_TOOL_PREFIX = require_decision.EVENT_TOOL_PREFIX;

package/dist/index.d.cts

@@ -842,7 +842,7 @@ interface RunAgentOptions<TMachine extends AnyStateMachine> {
    * that sends no event settles idle. Every model call counts against
    * `maxModelCalls`.
    */
-  getRequests?: (snapshot: SnapshotFrom<TMachine>, context: {
+  getRequests?: (snapshot: SnapshotFrom<TMachine>, agentContext: {
     messages: readonly AgentMessage[];
   }) => AgentStateRequest | readonly AgentStateRequest[] | undefined;
   /**

package/dist/index.d.mts

@@ -842,7 +842,7 @@ interface RunAgentOptions<TMachine extends AnyStateMachine> {
    * that sends no event settles idle. Every model call counts against
    * `maxModelCalls`.
    */
-  getRequests?: (snapshot: SnapshotFrom<TMachine>, context: {
+  getRequests?: (snapshot: SnapshotFrom<TMachine>, agentContext: {
     messages: readonly AgentMessage[];
   }) => AgentStateRequest | readonly AgentStateRequest[] | undefined;
   /**

package/dist/index.mjs

@@ -1,3 +1,3 @@
-import { _ as createAgentSchemas, a as AgentIdleError, b as messagesSchema, c as inspectTransitions, d as executeAgentRequest, f as getAgentRequests, g as transitionAgentStep, h as resolveAgentStep, i as simulateAgent, l as runAgent, m as resolveAgentRequests, n as explorePaths, o as IllegalResumeEventError, p as initialAgentStep, r as lintAgentMachine, s as SnapshotVersionMismatchError, t as canReach, u as runAgentToCompletion, v as setupAgent, y as appendMessages } from "./src-CjpHDU8F.mjs";
-import { B as getJsonSchema, G as persistSnapshot, H as getMachineStructuralHash, J as userMessage, K as systemMessage, L as assistantMessage, O as parseOutput, S as createTextLogic, T as isStructuredOutputSchema, U as getStateMeta, V as getJsonSchemaSync, W as isStandardSchema, Y as validateSchemaSync, b as buildEnvelopeSchema, d as EVENT_TOOL_PREFIX, f as getAcceptedEvents, l as renderDecisionAttempts, m as parseAgentEvent, n as PLAN_DONE_EVENT_TYPE, p as matchesEventPattern, q as toolMessage, t as DecisionExhaustedError, u as resolveDecision, w as getAgentOutputMode, y as bindRequestExecutor, z as getAgentMessages } from "./decision-FTmbqSEe.mjs";
+import { _ as createAgentSchemas, a as AgentIdleError, b as messagesSchema, c as inspectTransitions, d as executeAgentRequest, f as getAgentRequests, g as transitionAgentStep, h as resolveAgentStep, i as simulateAgent, l as runAgent, m as resolveAgentRequests, n as explorePaths, o as IllegalResumeEventError, p as initialAgentStep, r as lintAgentMachine, s as SnapshotVersionMismatchError, t as canReach, u as runAgentToCompletion, v as setupAgent, y as appendMessages } from "./src-CEa947Dm.mjs";
+import { B as getAgentMessages, C as createTextLogic, E as isStructuredOutputSchema, G as isStandardSchema, H as getJsonSchemaSync, J as toolMessage, K as persistSnapshot, R as assistantMessage, T as getAgentOutputMode, U as getMachineStructuralHash, V as getJsonSchema, W as getStateMeta, X as validateSchemaSync, Y as userMessage, b as bindRequestExecutor, d as EVENT_TOOL_PREFIX, f as getAcceptedEvents, k as parseOutput, l as renderDecisionAttempts, m as parseAgentEvent, n as PLAN_DONE_EVENT_TYPE, p as matchesEventPattern, q as systemMessage, t as DecisionExhaustedError, u as resolveDecision, x as buildEnvelopeSchema } from "./decision-D1654JdD.mjs";
 export { AgentIdleError, DecisionExhaustedError, EVENT_TOOL_PREFIX, IllegalResumeEventError, PLAN_DONE_EVENT_TYPE, SnapshotVersionMismatchError, appendMessages, assistantMessage, bindRequestExecutor, buildEnvelopeSchema, canReach, createAgentSchemas, createTextLogic, executeAgentRequest, explorePaths, getAcceptedEvents, getAgentMessages, getAgentOutputMode, getAgentRequests, getJsonSchema, getJsonSchemaSync, getMachineStructuralHash, getStateMeta, initialAgentStep, inspectTransitions, isStandardSchema, isStructuredOutputSchema, lintAgentMachine, matchesEventPattern, messagesSchema, parseAgentEvent, parseOutput, persistSnapshot, renderDecisionAttempts, resolveAgentRequests, resolveAgentStep, resolveDecision, runAgent, runAgentToCompletion, setupAgent, simulateAgent, systemMessage, toolMessage, transitionAgentStep, userMessage, validateSchemaSync };

package/dist/openai-compat.cjs

@@ -1,5 +1,5 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
-const require_decision = require("./decision-pC-bY2DE.cjs");
+const require_decision = require("./decision-CX3YdwrO.cjs");
 //#region src/openai-compat/index.ts
 /**
 * OpenAI-compatible Chat Completions adapter — a COMPLETE `{ generateText,

package/dist/openai-compat.mjs

@@ -1,4 +1,4 @@
-import { B as getJsonSchema, V as getJsonSchemaSync, W as isStandardSchema, b as buildEnvelopeSchema, l as renderDecisionAttempts, w as getAgentOutputMode } from "./decision-FTmbqSEe.mjs";
+import { G as isStandardSchema, H as getJsonSchemaSync, T as getAgentOutputMode, V as getJsonSchema, l as renderDecisionAttempts, x as buildEnvelopeSchema } from "./decision-D1654JdD.mjs";
 //#region src/openai-compat/index.ts
 /**
 * OpenAI-compatible Chat Completions adapter — a COMPLETE `{ generateText,

package/dist/{src-CjpHDU8F.mjs → src-CEa947Dm.mjs}

@@ -1,4 +1,4 @@
-import { A as agentExecutionOptions, C as executeAgentTextRequest, D as normalizeGeneratorResult, E as isTextLogic, F as machineSuspensionPredicates, H as getMachineStructuralHash, I as missingActor, J as userMessage, L as assistantMessage, M as getMachineSuspensionPredicate, N as getRegisteredAgentExecutionOptions, P as isUnboundPlaceholder, R as findNonSerializableContextPaths, S as createTextLogic, V as getJsonSchemaSync, Y as validateSchemaSync, _ as PLAN_ACTOR, a as createPlanActor, c as isPlanLogic, f as getAcceptedEvents, g as DECIDE_ACTOR, h as sanitizeEventToolName, i as createDecideActor, j as executorBoundLogics, k as userInputActor, n as PLAN_DONE_EVENT_TYPE, o as initialPlanLedger, r as advancePlanLedger, s as isDecisionLogic, t as DecisionExhaustedError, u as resolveDecision, v as USER_INPUT_ACTOR, x as builtinTextActors } from "./decision-FTmbqSEe.mjs";
+import { A as userInputActor, B as getAgentMessages, C as createTextLogic, D as isTextLogic, F as isUnboundPlaceholder, H as getJsonSchemaSync, I as machineSuspensionPredicates, L as missingActor, M as executorBoundLogics, N as getMachineSuspensionPredicate, O as normalizeGeneratorResult, P as getRegisteredAgentExecutionOptions, R as assistantMessage, S as builtinTextActors, U as getMachineStructuralHash, X as validateSchemaSync, Y as userMessage, _ as INTERPRET_SOURCE, a as createPlanActor, c as isPlanLogic, f as getAcceptedEvents, g as DECIDE_ACTOR, h as sanitizeEventToolName, i as createDecideActor, j as agentExecutionOptions, n as PLAN_DONE_EVENT_TYPE, o as initialPlanLedger, r as advancePlanLedger, s as isDecisionLogic, t as DecisionExhaustedError, u as resolveDecision, v as PLAN_ACTOR, w as executeAgentTextRequest, y as USER_INPUT_ACTOR, z as findNonSerializableContextPaths } from "./decision-D1654JdD.mjs";
 import { createActor, createAsyncLogic, getNextTransitions, initialTransition, setup, transition } from "xstate";
 //#region src/messages.ts
 function addMessages(resolve) {
@@ -840,7 +840,7 @@ async function runTextPhase(stateRequest, baseMessages, deps) {
 	const agentRequest = {
 		kind: "text",
 		id,
-		src: "agent.interpret",
+		src: INTERPRET_SOURCE,
 		mode: "generate",
 		input: request,
 		tools: {},
@@ -855,6 +855,8 @@ async function runTextPhase(stateRequest, baseMessages, deps) {
 	try {
 		const raw = await deps.generateText(request, { signal: deps.signal });
 		output = await normalizeGeneratorResult(raw, id, { request });
+		const rawReasoning = raw?.reasoning;
+		const reasoning = typeof rawReasoning === "string" ? rawReasoning : void 0;
 		deps.onResult?.(agentRequest, {
 			output,
 			raw
@@ -863,7 +865,8 @@ async function runTextPhase(stateRequest, baseMessages, deps) {
 			type: "request.end",
 			request: agentRequest,
 			output,
-			raw
+			raw,
+			...reasoning !== void 0 ? { reasoning } : {}
 		});
 	} catch (error) {
 		deps.onTrace?.({
@@ -916,8 +919,8 @@ async function runAdvancePhase(plan, deps) {
 		signal: deps.signal,
 		canTake: (event) => deps.getSnapshot().can(event)
 	});
-	deps.appendToLog(assistantMessage(`[chose: ${chosen.type}]`));
 	if (deps.isSettled()) return false;
+	deps.appendToLog(assistantMessage(`[chose: ${chosen.type}]`));
 	deps.send(chosen);
 	return true;
 }
@@ -1571,10 +1574,10 @@ async function runAgent(machine, options) {
 			}
 		}
 	}
-	const priorMessages = effectiveSnapshot?.messages ?? [];
+	const priorMessages = getAgentMessages(effectiveSnapshot);
 	const messages = typeof options.messages === "function" ? [...options.messages([...priorMessages])] : [...priorMessages, ...options.messages ?? []];
 	const stampMessages = (snapshot) => {
-		if (!options.getRequests && !options.messages) return;
+		if (!options.getRequests && !options.messages && messages.length === 0) return;
 		if (snapshot && typeof snapshot === "object") snapshot.messages = [...messages];
 	};
 	if (effectiveSnapshot !== void 0 && options.event !== void 0 && (options.onIllegalResumeEvent ?? "throw") === "throw") {
@@ -1631,10 +1634,11 @@ async function runAgent(machine, options) {
 			messages.push(...items);
 			if (options.onMessage) for (const item of items) options.onMessage(item);
 		};
+		const runErrorCause = (error) => budgetExceeded ? "max-model-calls" : wrapsDecisionExhausted(error) ? "decision-exhausted" : "machine";
 		const settleInterpretError = (error) => {
 			settle({
 				status: "error",
-				cause: budgetExceeded ? "max-model-calls" : wrapsDecisionExhausted(error) ? "decision-exhausted" : "machine",
+				cause: runErrorCause(error),
 				error,
 				snapshot: actor.getSnapshot()
 			});
@@ -1664,7 +1668,7 @@ async function runAgent(machine, options) {
 				settleInterpretError(error);
 				return true;
 			}
-			const requests = (Array.isArray(requested) ? requested : requested ? [requested] : []).filter(Boolean);
+			const requests = (Array.isArray(requested) ? requested : requested ? [requested] : []).filter((stateRequest) => Boolean(stateRequest));
 			if (requests.length === 0) return false;
 			interpreting = true;
 			runStateRequestPass(requests, passDeps).then(({ sentAny }) => {
@@ -1712,7 +1716,7 @@ async function runAgent(machine, options) {
 				if (snapshot.status === "error") {
 					settle({
 						status: "error",
-						cause: budgetExceeded ? "max-model-calls" : wrapsDecisionExhausted(snapshot.error) ? "decision-exhausted" : "machine",
+						cause: runErrorCause(snapshot.error),
 						error: snapshot.error,
 						snapshot
 					});

package/dist/{src-DcRsWPfV.cjs → src-wBfi-kTA.cjs}

@@ -1,4 +1,4 @@
-const require_decision = require("./decision-pC-bY2DE.cjs");
+const require_decision = require("./decision-CX3YdwrO.cjs");
 let xstate = require("xstate");
 //#region src/messages.ts
 function addMessages(resolve) {
@@ -840,7 +840,7 @@ async function runTextPhase(stateRequest, baseMessages, deps) {
 	const agentRequest = {
 		kind: "text",
 		id,
-		src: "agent.interpret",
+		src: require_decision.INTERPRET_SOURCE,
 		mode: "generate",
 		input: request,
 		tools: {},
@@ -855,6 +855,8 @@ async function runTextPhase(stateRequest, baseMessages, deps) {
 	try {
 		const raw = await deps.generateText(request, { signal: deps.signal });
 		output = await require_decision.normalizeGeneratorResult(raw, id, { request });
+		const rawReasoning = raw?.reasoning;
+		const reasoning = typeof rawReasoning === "string" ? rawReasoning : void 0;
 		deps.onResult?.(agentRequest, {
 			output,
 			raw
@@ -863,7 +865,8 @@ async function runTextPhase(stateRequest, baseMessages, deps) {
 			type: "request.end",
 			request: agentRequest,
 			output,
-			raw
+			raw,
+			...reasoning !== void 0 ? { reasoning } : {}
 		});
 	} catch (error) {
 		deps.onTrace?.({
@@ -916,8 +919,8 @@ async function runAdvancePhase(plan, deps) {
 		signal: deps.signal,
 		canTake: (event) => deps.getSnapshot().can(event)
 	});
-	deps.appendToLog(require_decision.assistantMessage(`[chose: ${chosen.type}]`));
 	if (deps.isSettled()) return false;
+	deps.appendToLog(require_decision.assistantMessage(`[chose: ${chosen.type}]`));
 	deps.send(chosen);
 	return true;
 }
@@ -1571,10 +1574,10 @@ async function runAgent(machine, options) {
 			}
 		}
 	}
-	const priorMessages = effectiveSnapshot?.messages ?? [];
+	const priorMessages = require_decision.getAgentMessages(effectiveSnapshot);
 	const messages = typeof options.messages === "function" ? [...options.messages([...priorMessages])] : [...priorMessages, ...options.messages ?? []];
 	const stampMessages = (snapshot) => {
-		if (!options.getRequests && !options.messages) return;
+		if (!options.getRequests && !options.messages && messages.length === 0) return;
 		if (snapshot && typeof snapshot === "object") snapshot.messages = [...messages];
 	};
 	if (effectiveSnapshot !== void 0 && options.event !== void 0 && (options.onIllegalResumeEvent ?? "throw") === "throw") {
@@ -1631,10 +1634,11 @@ async function runAgent(machine, options) {
 			messages.push(...items);
 			if (options.onMessage) for (const item of items) options.onMessage(item);
 		};
+		const runErrorCause = (error) => budgetExceeded ? "max-model-calls" : wrapsDecisionExhausted(error) ? "decision-exhausted" : "machine";
 		const settleInterpretError = (error) => {
 			settle({
 				status: "error",
-				cause: budgetExceeded ? "max-model-calls" : wrapsDecisionExhausted(error) ? "decision-exhausted" : "machine",
+				cause: runErrorCause(error),
 				error,
 				snapshot: actor.getSnapshot()
 			});
@@ -1664,7 +1668,7 @@ async function runAgent(machine, options) {
 				settleInterpretError(error);
 				return true;
 			}
-			const requests = (Array.isArray(requested) ? requested : requested ? [requested] : []).filter(Boolean);
+			const requests = (Array.isArray(requested) ? requested : requested ? [requested] : []).filter((stateRequest) => Boolean(stateRequest));
 			if (requests.length === 0) return false;
 			interpreting = true;
 			runStateRequestPass(requests, passDeps).then(({ sentAny }) => {
@@ -1712,7 +1716,7 @@ async function runAgent(machine, options) {
 				if (snapshot.status === "error") {
 					settle({
 						status: "error",
-						cause: budgetExceeded ? "max-model-calls" : wrapsDecisionExhausted(snapshot.error) ? "decision-exhausted" : "machine",
+						cause: runErrorCause(snapshot.error),
 						error: snapshot.error,
 						snapshot
 					});

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@statelyai/agent",
-  "version": "2.0.0-alpha.5",
+  "version": "2.0.0-alpha.6",
   "description": "State-machine authoring layer for AI agents",
   "type": "module",
   "main": "dist/index.cjs",