@statelyai/agent 2.0.0-alpha.13 → 2.0.0-alpha.14

package/dist/ai-sdk.cjs

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

package/dist/ai-sdk.d.cts

@@ -1,5 +1,5 @@
-import { d as ChosenEvent } from "./types-QbEfCVny.cjs";
-import { k as AgentDecisionExecutor, l as AgentRequestExecutors, o as AgentRequestExecutor } from "./text-logic-BDxwQNsD.cjs";
+import { d as ChosenEvent } from "./types-rMe7x6NR.cjs";
+import { k as AgentDecisionExecutor, l as AgentRequestExecutors, o as AgentRequestExecutor } from "./text-logic-Jkilp1Ie.cjs";
 import { FinishReason, LanguageModel, LanguageModelUsage, ToolSet, TypedToolCall, TypedToolResult } from "ai";
 
 //#region src/ai-sdk/index.d.ts

package/dist/ai-sdk.d.mts

@@ -1,5 +1,5 @@
-import { d as ChosenEvent } from "./types-_FXoFBGO.mjs";
-import { k as AgentDecisionExecutor, l as AgentRequestExecutors, o as AgentRequestExecutor } from "./text-logic-TkKPw8Aq.mjs";
+import { d as ChosenEvent } from "./types-9Bqg5rZB.mjs";
+import { k as AgentDecisionExecutor, l as AgentRequestExecutors, o as AgentRequestExecutor } from "./text-logic-C5kbjaDz.mjs";
 import { FinishReason, LanguageModel, LanguageModelUsage, ToolSet, TypedToolCall, TypedToolResult } from "ai";
 
 //#region src/ai-sdk/index.d.ts

package/dist/ai-sdk.mjs

@@ -1,4 +1,4 @@
-import { J as isStandardSchema, T as getAgentOutputMode, b as buildEnvelopeSchema, l as renderDecisionAttempts } from "./decision-BezSD_YC.mjs";
+import { V as isStandardSchema, i as renderDecisionAttempts, p as buildEnvelopeSchema, v as getAgentOutputMode } from "./decision-D9Zi7Xi5.mjs";
 import { NoObjectGeneratedError, Output, generateText, stepCountIs, streamText, tool } from "ai";
 //#region src/ai-sdk/mappers.ts
 /**

package/dist/{decision-dWGhBh0P.cjs → decision-C0cUKvNt.cjs}

@@ -281,7 +281,6 @@ const USER_INPUT_ACTOR = "agent.userInput";
 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";
 /**
@@ -882,68 +881,6 @@ function decideActorWithExecutor(execute) {
 function createDecideActor() {
 	return decideActorWithExecutor();
 }
-/**
-* Reserved event type the `agent.plan` builtin adds to every step's
-* candidates as the explicit "no further action needed" move. Choosing it
-* ends the plan (`stopped: 'done'`); it is never sent to the machine, so
-* machines need no no-op sentinel event of their own.
-*/
-const PLAN_DONE_EVENT_TYPE = "agent.plan.done";
-function createPlanActor() {
-	const logic = (0, xstate.createLogic)({
-		context: ({ input }) => ({
-			applied: [],
-			stepsRemaining: input.maxSteps ?? 8,
-			stopped: null
-		}),
-		run: ({ context, event }) => event.type === "plan.applied" ? { context: {
-			...context,
-			applied: [...context.applied, event.event],
-			stepsRemaining: context.stepsRemaining - 1
-		} } : event.type === "plan.ended" ? {
-			context: {
-				...context,
-				stopped: event.stopped
-			},
-			status: "done",
-			output: {
-				steps: context.applied,
-				stopped: event.stopped
-			}
-		} : void 0
-	});
-	return Object.assign(logic, {
-		kind: "statelyai.planLogic",
-		maxRetries: 2,
-		request: decideRequestFromInput,
-		allowedEventTypes: (input) => resolveAllowedEventTypes(input.allowedEvents, input)
-	});
-}
-const PLAN_LEDGER_SCOPE = {
-	emit: () => {},
-	self: { id: "agent.plan.ledger" }
-};
-/**
-* Builds a fresh plan ledger snapshot from resolved plan input — the shared
-* starting point for BOTH hosts (the step path reads the invoke child's own
-* initial snapshot; runAgent seeds a local ledger with this). @internal
-*/
-function initialPlanLedger(logic, input) {
-	return logic.getInitialSnapshot(PLAN_LEDGER_SCOPE, input);
-}
-/**
-* Advances a plan ledger by one {@link PlanLedgerEvent}, returning the next
-* snapshot (unwrapping `createLogic`'s `[snapshot, effects]` tuple). Pure — no
-* mutation of the input snapshot. @internal
-*/
-function advancePlanLedger(logic, snapshot, event) {
-	const result = logic.transition(snapshot, event, PLAN_LEDGER_SCOPE);
-	return Array.isArray(result) ? result[0] : result;
-}
-/** Type guard: true for the `agent.plan` builtin logic (checks the `kind` marker). @internal */
-function isPlanLogic(logic) {
-	return !!logic && logic.kind === "statelyai.planLogic";
-}
 function resolveAllowedEventTypes(allowedEvents, input) {
 	if (allowedEvents === void 0) return;
 	const resolved = typeof allowedEvents === "function" ? allowedEvents({ input }) : allowedEvents;
@@ -1087,30 +1024,12 @@ Object.defineProperty(exports, "INTERPRET_SOURCE", {
 		return INTERPRET_SOURCE;
 	}
 });
-Object.defineProperty(exports, "PLAN_ACTOR", {
-	enumerable: true,
-	get: function() {
-		return PLAN_ACTOR;
-	}
-});
-Object.defineProperty(exports, "PLAN_DONE_EVENT_TYPE", {
-	enumerable: true,
-	get: function() {
-		return PLAN_DONE_EVENT_TYPE;
-	}
-});
 Object.defineProperty(exports, "USER_INPUT_ACTOR", {
 	enumerable: true,
 	get: function() {
 		return USER_INPUT_ACTOR;
 	}
 });
-Object.defineProperty(exports, "advancePlanLedger", {
-	enumerable: true,
-	get: function() {
-		return advancePlanLedger;
-	}
-});
 Object.defineProperty(exports, "agentExecutionOptions", {
 	enumerable: true,
 	get: function() {
@@ -1147,12 +1066,6 @@ Object.defineProperty(exports, "createDecideActor", {
 		return createDecideActor;
 	}
 });
-Object.defineProperty(exports, "createPlanActor", {
-	enumerable: true,
-	get: function() {
-		return createPlanActor;
-	}
-});
 Object.defineProperty(exports, "createTextLogic", {
 	enumerable: true,
 	get: function() {
@@ -1243,24 +1156,12 @@ Object.defineProperty(exports, "getStateMeta", {
 		return getStateMeta;
 	}
 });
-Object.defineProperty(exports, "initialPlanLedger", {
-	enumerable: true,
-	get: function() {
-		return initialPlanLedger;
-	}
-});
 Object.defineProperty(exports, "isDecisionLogic", {
 	enumerable: true,
 	get: function() {
 		return isDecisionLogic;
 	}
 });
-Object.defineProperty(exports, "isPlanLogic", {
-	enumerable: true,
-	get: function() {
-		return isPlanLogic;
-	}
-});
 Object.defineProperty(exports, "isStandardSchema", {
 	enumerable: true,
 	get: function() {
@@ -1345,12 +1246,6 @@ Object.defineProperty(exports, "resolveDecision", {
 		return resolveDecision;
 	}
 });
-Object.defineProperty(exports, "sanitizeEventToolName", {
-	enumerable: true,
-	get: function() {
-		return sanitizeEventToolName;
-	}
-});
 Object.defineProperty(exports, "systemMessage", {
 	enumerable: true,
 	get: function() {

package/dist/{decision-BezSD_YC.mjs → decision-D9Zi7Xi5.mjs}

@@ -1,5 +1,5 @@
 import { t as AgentError } from "./errors-CeSXQx0v.mjs";
-import { createAsyncLogic, createLogic, getNextTransitions } from "xstate";
+import { createAsyncLogic, getNextTransitions } from "xstate";
 //#region src/utils.ts
 /**
 * Deep-clones a snapshot to a plain-JSON value via a `JSON` round-trip, the
@@ -281,7 +281,6 @@ const USER_INPUT_ACTOR = "agent.userInput";
 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";
 /**
@@ -882,68 +881,6 @@ function decideActorWithExecutor(execute) {
 function createDecideActor() {
 	return decideActorWithExecutor();
 }
-/**
-* Reserved event type the `agent.plan` builtin adds to every step's
-* candidates as the explicit "no further action needed" move. Choosing it
-* ends the plan (`stopped: 'done'`); it is never sent to the machine, so
-* machines need no no-op sentinel event of their own.
-*/
-const PLAN_DONE_EVENT_TYPE = "agent.plan.done";
-function createPlanActor() {
-	const logic = createLogic({
-		context: ({ input }) => ({
-			applied: [],
-			stepsRemaining: input.maxSteps ?? 8,
-			stopped: null
-		}),
-		run: ({ context, event }) => event.type === "plan.applied" ? { context: {
-			...context,
-			applied: [...context.applied, event.event],
-			stepsRemaining: context.stepsRemaining - 1
-		} } : event.type === "plan.ended" ? {
-			context: {
-				...context,
-				stopped: event.stopped
-			},
-			status: "done",
-			output: {
-				steps: context.applied,
-				stopped: event.stopped
-			}
-		} : void 0
-	});
-	return Object.assign(logic, {
-		kind: "statelyai.planLogic",
-		maxRetries: 2,
-		request: decideRequestFromInput,
-		allowedEventTypes: (input) => resolveAllowedEventTypes(input.allowedEvents, input)
-	});
-}
-const PLAN_LEDGER_SCOPE = {
-	emit: () => {},
-	self: { id: "agent.plan.ledger" }
-};
-/**
-* Builds a fresh plan ledger snapshot from resolved plan input — the shared
-* starting point for BOTH hosts (the step path reads the invoke child's own
-* initial snapshot; runAgent seeds a local ledger with this). @internal
-*/
-function initialPlanLedger(logic, input) {
-	return logic.getInitialSnapshot(PLAN_LEDGER_SCOPE, input);
-}
-/**
-* Advances a plan ledger by one {@link PlanLedgerEvent}, returning the next
-* snapshot (unwrapping `createLogic`'s `[snapshot, effects]` tuple). Pure — no
-* mutation of the input snapshot. @internal
-*/
-function advancePlanLedger(logic, snapshot, event) {
-	const result = logic.transition(snapshot, event, PLAN_LEDGER_SCOPE);
-	return Array.isArray(result) ? result[0] : result;
-}
-/** Type guard: true for the `agent.plan` builtin logic (checks the `kind` marker). @internal */
-function isPlanLogic(logic) {
-	return !!logic && logic.kind === "statelyai.planLogic";
-}
 function resolveAllowedEventTypes(allowedEvents, input) {
 	if (allowedEvents === void 0) return;
 	const resolved = typeof allowedEvents === "function" ? allowedEvents({ input }) : allowedEvents;
@@ -1063,4 +1000,4 @@ async function resolveDecision(request, executor, options = {}) {
 	throw new AgentDecisionExhaustedError(attempts);
 }
 //#endregion
-export { validateSchemaSync as $, parseStructuredEnvelope as A, missingActor as B, executeAgentTextRequest as C, normalizeGeneratorResult as D, isTextLogic as E, getMachineSuspensionPredicate as F, getJsonSchemaSync as G, findNonSerializableContextPaths as H, getRegisteredAgentExecutionOptions as I, isStandardSchema as J, getMachineStructuralHash as K, isUnboundPlaceholder as L, agentExecutionOptions as M, executorBoundLogics as N, parseModelRef as O, getMachineStaticTransitionTargets as P, userMessage as Q, machineStaticTransitionTargets as R, createTextLogic as S, getAgentOutputMode as T, getAgentMessages as U, assistantMessage as V, getJsonSchema as W, systemMessage as X, persistSnapshot as Y, toolMessage as Z, PLAN_ACTOR as _, createPlanActor as a, buildEnvelopeSchema as b, isPlanLogic as c, getAcceptedEvents as d, parseAgentEvent as f, INTERPRET_SOURCE as g, DECIDE_ACTOR as h, createDecideActor as i, userInputActor as j, parseOutput as k, renderDecisionAttempts as l, AGENT_USAGE_TOKEN_FIELDS as m, PLAN_DONE_EVENT_TYPE as n, initialPlanLedger as o, sanitizeEventToolName as p, getStateMeta as q, advancePlanLedger as r, isDecisionLogic as s, AgentDecisionExhaustedError as t, resolveDecision as u, USER_INPUT_ACTOR as v, extractCallUsage as w, builtinTextActors as x, bindRequestExecutor as y, machineSuspensionPredicates as z };
+export { isUnboundPlaceholder as A, getStateMeta as B, parseStructuredEnvelope as C, getMachineStaticTransitionTargets as D, executorBoundLogics as E, findNonSerializableContextPaths as F, userMessage as G, persistSnapshot as H, getAgentMessages as I, validateSchemaSync as K, getJsonSchema as L, machineSuspensionPredicates as M, missingActor as N, getMachineSuspensionPredicate as O, assistantMessage as P, getJsonSchemaSync as R, parseOutput as S, agentExecutionOptions as T, systemMessage as U, isStandardSchema as V, toolMessage as W, extractCallUsage as _, resolveDecision as a, normalizeGeneratorResult as b, AGENT_USAGE_TOKEN_FIELDS as c, USER_INPUT_ACTOR as d, bindRequestExecutor as f, executeAgentTextRequest as g, createTextLogic as h, renderDecisionAttempts as i, machineStaticTransitionTargets as j, getRegisteredAgentExecutionOptions as k, DECIDE_ACTOR as l, builtinTextActors as m, createDecideActor as n, getAcceptedEvents as o, buildEnvelopeSchema as p, isDecisionLogic as r, parseAgentEvent as s, AgentDecisionExhaustedError as t, INTERPRET_SOURCE as u, getAgentOutputMode as v, userInputActor as w, parseModelRef as x, isTextLogic as y, getMachineStructuralHash as z };

package/dist/index.cjs

@@ -1,7 +1,7 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
 const require_errors = require("./errors-DUBBzRLP.cjs");
-const require_setup_agent = require("./setup-agent-DP95MFrI.cjs");
-const require_decision = require("./decision-dWGhBh0P.cjs");
+const require_setup_agent = require("./setup-agent-CpK0ZRWV.cjs");
+const require_decision = require("./decision-C0cUKvNt.cjs");
 const require_event_log_store = require("./event-log-store-CNT_7F0V.cjs");
 let xstate = require("xstate");
 //#region src/internal/state-request-pass.ts
@@ -365,7 +365,7 @@ function assertMachineBindable(machine, effectiveSources, options, ctx) {
 				assertChildMachineBindable(src, src, stateName, options, ctx);
 				continue;
 			}
-			if ((require_decision.isTextLogic(src) || require_decision.isDecisionLogic(src) || require_decision.isPlanLogic(src)) && !require_decision.executorBoundLogics.has(src)) throw new Error(`runAgent: ${where} '${stateName}' invokes a direct-object actor logic (kind: '${src.kind}'). Direct-object invoke srcs cannot be rebound by runAgent — either call '.withExecutor(...)' on the logic before invoking it, or register it as a string-keyed actor source instead (machine.provide({ actors: { name: logic } })) and invoke it by name.`);
+			if ((require_decision.isTextLogic(src) || require_decision.isDecisionLogic(src)) && !require_decision.executorBoundLogics.has(src)) throw new Error(`runAgent: ${where} '${stateName}' invokes a direct-object actor logic (kind: '${src.kind}'). Direct-object invoke srcs cannot be rebound by runAgent — either call '.withExecutor(...)' on the logic before invoking it, or register it as a string-keyed actor source instead (machine.provide({ actors: { name: logic } })) and invoke it by name.`);
 			continue;
 		}
 		const logic = effectiveSources[src];
@@ -381,11 +381,6 @@ function assertMachineBindable(machine, effectiveSources, options, ctx) {
 			if (!options.hasDecide) throw new Error(`runAgent: ${where} '${stateName}' invokes decision source '${src}' but no 'decide' executor was provided to runAgent(...).`);
 			continue;
 		}
-		if (require_decision.isPlanLogic(logic)) {
-			if (!ctx.rebindable) throw unrebindableChildRequestError(ctx.childPath, stateName, src, "plan");
-			if (!options.hasDecide) throw new Error(`runAgent: ${where} '${stateName}' invokes plan source '${src}' but no 'decide' executor was provided to runAgent(...).`);
-			continue;
-		}
 		if (require_decision.isTextLogic(logic)) {
 			if (require_decision.executorBoundLogics.has(logic)) continue;
 			if (!ctx.rebindable) throw unrebindableChildRequestError(ctx.childPath, stateName, src, logic.mode === "stream" ? "streaming text" : "text");
@@ -443,11 +438,11 @@ function selfIdAndSrc(self) {
 	};
 }
 /**
-* The machine actor that INVOKED a decision/plan request — the actor whose
+* The machine actor that INVOKED a decision request — the actor whose
 * live snapshot supplies the candidate events and drives `canTake`/`send`.
 * For a top-level request this is the root actor (identity-equal to
 * `runCtx.actorHolder.actorRef`); for a request inside an invoked child
-* machine it is that child's actor, so a child decision/plan reads and drives
+* machine it is that child's actor, so a child decision reads and drives
 * the CHILD's snapshot — not the root's. Read off `self._parent`, with the
 * root actor as a fallback.
 */
@@ -542,7 +537,7 @@ function wrapTextLogicForRunAgent(logic, runCtx) {
 		}
 	});
 }
-function createCountingDecide(runCtx, self, kind = "decision") {
+function createCountingDecide(runCtx, self) {
 	return async (attemptRequest) => {
 		runCtx.consumeModelCall();
 		runCtx.onTrace?.({
@@ -558,7 +553,7 @@ function createCountingDecide(runCtx, self, kind = "decision") {
 			if (usage) {
 				const { src } = selfIdAndSrc(self);
 				runCtx.recordUsage?.(usage, {
-					kind,
+					kind: "decision",
 					...attemptRequest.id ? { id: attemptRequest.id } : {},
 					...src !== "" ? { src } : {},
 					model: attemptRequest.model
@@ -595,8 +590,8 @@ function createCountingDecide(runCtx, self, kind = "decision") {
 * logic here that calls `resolveDecision` itself, reusing `logic.request(...)`
 * to build the request the same way the original logic would have.
 *
-* On success it SENDS the chosen event to the invoking actor (auto-delivery,
-* mirroring {@link createRunAgentPlanLogic}) and then completes with that event
+* On success it SENDS the chosen event to the invoking actor (auto-delivery)
+* and then completes with that event
 * as its output — so callers never wire an `onDone` to deliver it. See the
 * send-then-complete note inside `run` for how exit-cancels-invoke interacts
 * with `onDone`.
@@ -633,85 +628,6 @@ function createRunAgentDecisionLogic(logic, runCtx) {
 	});
 }
 /**
-* Builds the plan actor logic runAgent installs in place of the `agent.plan`
-* builtin: iterated {@link resolveDecision}. Each step re-reads the live
-* snapshot (so the candidate set reflects everything applied so far), asks
-* the `decide` executor for one legal event with the same validation/retry
-* loop a decision gets, and sends it to the machine. The loop ends on a
-* `stopOn` event, at `maxSteps`, when no legal candidate remains, or when an
-* applied event exits the invoking state (xstate cancels this invoke — the
-* machine simply moves on and the pending output is discarded).
-*
-* The invoke's `input` is resolved once, so the prompt cannot re-render
-* context between steps; instead the applied trail is appended to the prompt
-* each step so the model can see plan progress.
-*/
-function createRunAgentPlanLogic(logic, runCtx) {
-	const planLogic = (0, xstate.createAsyncLogic)({ run: async ({ input, signal, self }) => {
-		if (!runCtx.decide) throw new Error("runAgent: no 'decide' executor provided.");
-		const { id } = selfIdAndSrc(self);
-		const stopOn = new Set(input.stopOn ?? []);
-		const countingDecide = createCountingDecide(runCtx, self, "plan");
-		const base = logic.request(input);
-		let ledger = require_decision.initialPlanLedger(logic, input);
-		const end = (stopped) => {
-			ledger = require_decision.advancePlanLedger(logic, ledger, {
-				type: "plan.ended",
-				stopped
-			});
-			return ledger.output;
-		};
-		await Promise.resolve();
-		const invokingActor = invokingActorOf(self, runCtx);
-		while (ledger.context.stepsRemaining > 0) {
-			const actorRef = invokingActor;
-			if (!actorRef || signal.aborted) break;
-			const machineEvents = require_decision.getAcceptedEvents(actorRef.getSnapshot(), {
-				schemas: runCtx.schemas,
-				eventTypes: logic.allowedEventTypes(input)
-			});
-			if (machineEvents.length === 0) return end("no-legal-events");
-			const doneDescriptor = {
-				type: require_decision.PLAN_DONE_EVENT_TYPE,
-				toolName: require_decision.sanitizeEventToolName(require_decision.PLAN_DONE_EVENT_TYPE)
-			};
-			const events = machineEvents.some((event) => event.type === "agent.plan.done") ? machineEvents : [...machineEvents, doneDescriptor];
-			const applied = ledger.context.applied;
-			const trail = applied.length === 0 ? "" : `\n\nEvents already applied in this plan, in order:\n${applied.map((step) => JSON.stringify(step)).join("\n")}\nContinue from here; do not repeat applied events.`;
-			const doneHint = `\n\nWhen the request is fully handled (or no action is needed), choose '${require_decision.PLAN_DONE_EVENT_TYPE}'.`;
-			const chosen = await require_decision.resolveDecision({
-				...base,
-				id: `${id}[${applied.length}]`,
-				events,
-				prompt: `${base.prompt ?? ""}${trail}${doneHint}`,
-				attempts: []
-			}, countingDecide, {
-				maxRetries: input.maxRetries ?? logic.maxRetries,
-				signal,
-				canTake: (event) => {
-					if (event.type === "agent.plan.done" || stopOn.has(event.type)) return true;
-					return invokingActor ? invokingActor.getSnapshot().can(event) : true;
-				}
-			});
-			if (chosen.type === "agent.plan.done") return end("done");
-			actorRef.send(chosen);
-			ledger = require_decision.advancePlanLedger(logic, ledger, {
-				type: "plan.applied",
-				event: chosen
-			});
-			await Promise.resolve();
-			if (stopOn.has(chosen.type)) return end("stop-event");
-		}
-		return end("max-steps");
-	} });
-	return Object.assign(planLogic, {
-		kind: "statelyai.planLogic",
-		maxRetries: logic.maxRetries,
-		request: logic.request,
-		allowedEventTypes: logic.allowedEventTypes
-	});
-}
-/**
 * The set of string-keyed actor `src`s the machine's own config invokes
 * (top-level, recursing into child STATES but not into invoked child
 * machines). {@link provideExecutors} uses it to require an executor only for a
@@ -851,17 +767,9 @@ function bindDecisionForProvide(machine, logic, executors, options) {
 	return createRunAgentDecisionLogic(logic, provideBindContext(machine, executors, options));
 }
 /**
-* Host-binds one `agent.plan` source for {@link provideExecutors}: runAgent's
-* plan wrapper (iterated snapshot-driven decisions, auto-delivery) with the same
-* request-level tracing runAgent emits, minus run-scoped counting. @internal
-*/
-function bindPlanForProvide(machine, logic, executors, options) {
-	return createRunAgentPlanLogic(logic, provideBindContext(machine, executors, options));
-}
-/**
 * Recursively rebinds an invoked child machine's own agent sources with the
 * SAME host-backed wrappers runAgent applies to the top-level machine, so a
-* child's text/stream/decision/plan requests inherit runAgent's executors and
+* child's text/stream/decision requests inherit runAgent's executors and
 * participate in maxModelCalls counting, onTrace/onChunk/onResult exactly like
 * parent requests. Returns the child machine to invoke: a `.provide`-rebound
 * copy when any inner source needed wrapping, else the original untouched.
@@ -882,10 +790,6 @@ function rebindChildMachine(childMachine, runCtx, visited) {
 			if (!require_decision.executorBoundLogics.has(logic)) wrapped[key] = createRunAgentDecisionLogic(logic, runCtx);
 			continue;
 		}
-		if (require_decision.isPlanLogic(logic)) {
-			wrapped[key] = createRunAgentPlanLogic(logic, runCtx);
-			continue;
-		}
 		if (require_decision.isTextLogic(logic)) {
 			if (!require_decision.executorBoundLogics.has(logic)) wrapped[key] = wrapTextLogicForRunAgent(logic, runCtx);
 			continue;
@@ -1085,10 +989,6 @@ function createAgentSession(machine, options, lifecycle) {
 			wrappedSources[key] = createRunAgentDecisionLogic(logic, runCtx);
 			continue;
 		}
-		if (require_decision.isPlanLogic(logic)) {
-			wrappedSources[key] = createRunAgentPlanLogic(logic, runCtx);
-			continue;
-		}
 		if (require_decision.isTextLogic(logic)) {
 			if (!require_decision.executorBoundLogics.has(logic)) wrappedSources[key] = wrapTextLogicForRunAgent(logic, runCtx);
 			continue;
@@ -1225,10 +1125,8 @@ function createAgentSession(machine, options, lifecycle) {
 			settle({
 				status: "idle",
 				snapshot: current,
-				...pendingUserInputs.length > 0 ? {
-					pendingUserInputs,
-					persistedSnapshot: actor.getPersistedSnapshot()
-				} : {}
+				persistedSnapshot: actor.getPersistedSnapshot(),
+				...pendingUserInputs.length > 0 ? { pendingUserInputs } : {}
 			});
 		};
 		let interpreting = false;
@@ -1359,7 +1257,13 @@ function createAgentSession(machine, options, lifecycle) {
 					return;
 				}
 				if (!deliveringResumeEvent && isSuspended(snapshot) && isIdleSnapshot(snapshot, { ignoreUserInputChildren: userInputIsPlaceholder })) {
-					if (!maybeInterpret(snapshot)) settleIdle(snapshot);
+					queueMicrotask(() => {
+						if (settled) return;
+						const current = actor.getSnapshot();
+						if (isSuspended(current) && isIdleSnapshot(current, { ignoreUserInputChildren: userInputIsPlaceholder })) {
+							if (!maybeInterpret(current)) settleIdle(current);
+						} else scheduleIdleCheck();
+					});
 					return;
 				}
 				scheduleIdleCheck();
@@ -1499,7 +1403,10 @@ function isIdleSnapshot(snapshot, { ignoreUserInputChildren }) {
 	if (Object.values(snapshot.children ?? {}).some((child) => {
 		const ref = child;
 		if (ignoreUserInputChildren && ref?.src === "agent.userInput") return false;
-		return ref?.getSnapshot?.()?.status === "active";
+		const childSnapshot = ref?.getSnapshot?.();
+		if (childSnapshot?.status !== "active") return false;
+		if ((0, xstate.isMachineSnapshot)(childSnapshot)) return !isIdleSnapshot(childSnapshot, { ignoreUserInputChildren });
+		return true;
 	})) return false;
 	return !(0, xstate.getNextTransitions)(snapshot).some((transitionDef) => transitionDef.eventType === "" || transitionDef.eventType.startsWith("xstate.after"));
 }
@@ -1638,7 +1545,6 @@ function createAgentRun(machine, options) {
 * - decision / `agent.decide` source → `executors.decide` (snapshot-driven
 *   candidate events, guard `canTake`, and auto-delivery of the chosen event,
 *   mirroring `runAgent` but without its model-call counting)
-* - `agent.plan` source → `executors.decide` (iterated, same semantics)
 *
 * Pass `options.onTrace` to observe request-level trace events (identical in
 * shape to `runAgent`'s); pair it with {@link traceTransitions} on the actor's
@@ -1676,14 +1582,6 @@ function provideExecutors(machine, executors, options = {}) {
 			wrappedSources[key] = bindDecisionForProvide(provided, logic, executors, bindOptions);
 			continue;
 		}
-		if (require_decision.isPlanLogic(logic)) {
-			if (!executors.decide) {
-				if (invokedSrcs.has(key)) throw missingExecutorError(key, "plan", "decide");
-				continue;
-			}
-			wrappedSources[key] = bindPlanForProvide(provided, logic, executors, bindOptions);
-			continue;
-		}
 		if (require_decision.isTextLogic(logic)) {
 			if (require_decision.executorBoundLogics.has(logic)) continue;
 			if (!(logic.mode === "stream" ? executors.streamText : executors.generateText)) {
@@ -1702,7 +1600,6 @@ function missingExecutorError(src, kind, executor) {
 //#endregion
 //#region src/verify.ts
 const DECIDE_SRC = "agent.decide";
-const PLAN_SRC = "agent.plan";
 function normalizeInvokes(invoke) {
 	if (invoke === void 0 || invoke === null) return [];
 	return Array.isArray(invoke) ? invoke : [invoke];
@@ -1839,17 +1736,12 @@ function hasNonEmptyOn(config) {
 function decisionKindOf(src, actors) {
 	if (typeof src === "string") {
 		if (src === DECIDE_SRC) return "decision";
-		if (src === PLAN_SRC) return "plan";
-		const logic = actors[src];
-		if (require_decision.isDecisionLogic(logic)) return "decision";
-		if (require_decision.isPlanLogic(logic)) return "plan";
-		return;
+		return require_decision.isDecisionLogic(actors[src]) ? "decision" : void 0;
 	}
-	if (require_decision.isDecisionLogic(src)) return "decision";
-	if (require_decision.isPlanLogic(src)) return "plan";
+	return require_decision.isDecisionLogic(src) ? "decision" : void 0;
 }
 function isAgentLogicNeedingBinding(src) {
-	return (require_decision.isTextLogic(src) || require_decision.isDecisionLogic(src) || require_decision.isPlanLogic(src)) && !require_decision.executorBoundLogics.has(src);
+	return (require_decision.isTextLogic(src) || require_decision.isDecisionLogic(src)) && !require_decision.executorBoundLogics.has(src);
 }
 function schemaExposesJson(schema) {
 	if (!schema) return false;
@@ -2130,17 +2022,6 @@ async function simulateAgent(machine, options) {
 				});
 				continue;
 			}
-			if (request.kind === "plan") {
-				const taken = takeFromQueue(script.decisions, request.src);
-				if (!taken.found) throw scriptDryError("decision", request.src, request.id, request);
-				const event = taken.value;
-				step = await require_setup_agent.resolveAgentRequests(machine, step, { decide: async () => ({ event }) });
-				trail.push({
-					state: step.snapshot.value,
-					appliedEvent: taken.value
-				});
-				continue;
-			}
 			const taken = takeFromQueue(script.text, request.src);
 			if (!taken.found) throw scriptDryError("text", request.src, request.id);
 			step = require_setup_agent.resolveAgentStep(machine, step, request, taken.value);
@@ -2224,7 +2105,7 @@ async function explore(machine, options, stopWhen) {
 				recordState(current.snapshot);
 				continue;
 			}
-			if (request && (request.kind === "decision" || request.kind === "plan")) return { step: current };
+			if (request && request.kind === "decision") return { step: current };
 			const [invoke] = pendingInvokes(current);
 			if (invoke) {
 				if (!(invoke.src in textOutputs)) return {
@@ -2271,8 +2152,7 @@ async function explore(machine, options, stopWhen) {
 			return;
 		}
 		const request = settled.requests[0];
-		const isPlan = request?.kind === "plan";
-		const branchEvents = request?.kind === "decision" || request?.kind === "plan" ? request.events.map((descriptor) => ({ type: descriptor.type })) : require_decision.getAcceptedEvents(settled.snapshot).map((descriptor) => ({ type: descriptor.type }));
+		const branchEvents = request?.kind === "decision" ? request.events.map((descriptor) => ({ type: descriptor.type })) : require_decision.getAcceptedEvents(settled.snapshot).map((descriptor) => ({ type: descriptor.type }));
 		if (branchEvents.length === 0) {
 			pathsExplored++;
 			terminals.push({
@@ -2297,11 +2177,11 @@ async function explore(machine, options, stopWhen) {
 				if (pathsExplored >= maxPaths) hitPathCap = true;
 				return;
 			}
-			if (!(isPlan && event.type === "agent.plan.done") && !settled.snapshot.can(event)) {
+			if (!settled.snapshot.can(event)) {
 				prunedByGuard++;
 				continue;
 			}
-			const next = isPlan ? await require_setup_agent.resolveAgentRequests(machine, settled, { decide: async () => ({ event }) }) : require_setup_agent.transitionAgentStep(machine, settled, event);
+			const next = require_setup_agent.transitionAgentStep(machine, settled, event);
 			recordState(next.snapshot);
 			await visit(next, [...path, event], depth + 1);
 		}
@@ -2324,10 +2204,7 @@ async function explore(machine, options, stopWhen) {
 * depth, model-free, and reports which states are reached and how each path
 * terminates. At each decision request it forks one branch per candidate event
 * (guard-rejected candidates are counted in `prunedByGuard`, not explored); at
-* an idle wait it forks per externally-accepted event. A `agent.plan` request
-* forks the same way — one branch per candidate, including the reserved
-* `agent.plan.done` move — advancing each branch through the real plan protocol
-* (`resolveAgentRequests`), so a plan can consume several depth units. Text/`userInput` invokes
+* an idle wait it forks per externally-accepted event. Text/`userInput` invokes
 * are resolved from `textOutputs` (a by-src canned-output map) — a missing src
 * halts that branch with a `needs-output` terminal rather than throwing.
 *
@@ -2811,7 +2688,6 @@ exports.AgentReplayDivergenceError = require_setup_agent.AgentReplayDivergenceEr
 exports.AgentReplayMachineMismatchError = require_setup_agent.AgentReplayMachineMismatchError;
 exports.AgentSnapshotVersionMismatchError = AgentSnapshotVersionMismatchError;
 exports.NonSerializableAgentEventError = require_event_log_store.NonSerializableAgentEventError;
-exports.PLAN_DONE_EVENT_TYPE = require_decision.PLAN_DONE_EVENT_TYPE;
 exports.appendMessages = require_setup_agent.appendMessages;
 exports.assertAgentLogEntry = require_event_log_store.assertAgentLogEntry;
 exports.assertAgentMachine = assertAgentMachine;