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

package/dist/index.mjs

@@ -1,8 +1,8 @@
 import { t as AgentError } from "./errors-CeSXQx0v.mjs";
-import { _ as resolveAgentRequests, a as AgentReplayDivergenceError, b as appendMessages, c as diffEventLogs, d as initEntry, f as replay, g as initialAgentStep, h as getInvokeEffectMetadata, i as AGENT_USAGE_EVENT_TYPE, l as getAgentEffects, m as executeAgentRequest, n as setupAgent, o as AgentReplayMachineMismatchError, p as verifyReplay, r as AGENT_INIT_EVENT_TYPE, s as createReplayEntry, t as createAgentSchemas, u as getCallUsage, v as resolveAgentStep, x as messagesSchema, y as transitionAgentStep } from "./setup-agent-DAZZSjDS.mjs";
-import { A as parseStructuredEnvelope, D as normalizeGeneratorResult, E as isTextLogic, F as getMachineSuspensionPredicate, G as getJsonSchemaSync, H as findNonSerializableContextPaths, I as getRegisteredAgentExecutionOptions, J as isStandardSchema, K as getMachineStructuralHash, L as isUnboundPlaceholder, N as executorBoundLogics, O as parseModelRef, P as getMachineStaticTransitionTargets, Q as userMessage, S as createTextLogic, T as getAgentOutputMode, U as getAgentMessages, V as assistantMessage, W as getJsonSchema, X as systemMessage, Y as persistSnapshot, Z as toolMessage, b as buildEnvelopeSchema, c as isPlanLogic, d as getAcceptedEvents, f as parseAgentEvent, g as INTERPRET_SOURCE, k as parseOutput, l as renderDecisionAttempts, m as AGENT_USAGE_TOKEN_FIELDS, n as PLAN_DONE_EVENT_TYPE, o as initialPlanLedger, p as sanitizeEventToolName, q as getStateMeta, r as advancePlanLedger, s as isDecisionLogic, t as AgentDecisionExhaustedError, u as resolveDecision, w as extractCallUsage, y as bindRequestExecutor } from "./decision-BezSD_YC.mjs";
+import { _ as resolveAgentStep, a as AgentReplayDivergenceError, b as messagesSchema, c as diffEventLogs, d as initEntry, f as replay, g as initialAgentStep, h as getInvokeEffectMetadata, i as AGENT_USAGE_EVENT_TYPE, l as getAgentEffects, m as executeAgentRequest, n as setupAgent, o as AgentReplayMachineMismatchError, p as verifyReplay, r as AGENT_INIT_EVENT_TYPE, s as createReplayEntry, t as createAgentSchemas, u as getCallUsage, v as transitionAgentStep, y as appendMessages } from "./setup-agent-DeHRW-qX.mjs";
+import { A as isUnboundPlaceholder, B as getStateMeta, C as parseStructuredEnvelope, D as getMachineStaticTransitionTargets, E as executorBoundLogics, F as findNonSerializableContextPaths, G as userMessage, H as persistSnapshot, I as getAgentMessages, K as validateSchemaSync, L as getJsonSchema, O as getMachineSuspensionPredicate, P as assistantMessage, R as getJsonSchemaSync, S as parseOutput, U as systemMessage, V as isStandardSchema, W as toolMessage, _ as extractCallUsage, a as resolveDecision, b as normalizeGeneratorResult, c as AGENT_USAGE_TOKEN_FIELDS, f as bindRequestExecutor, h as createTextLogic, i as renderDecisionAttempts, k as getRegisteredAgentExecutionOptions, o as getAcceptedEvents, p as buildEnvelopeSchema, r as isDecisionLogic, s as parseAgentEvent, t as AgentDecisionExhaustedError, u as INTERPRET_SOURCE, v as getAgentOutputMode, x as parseModelRef, y as isTextLogic, z as getMachineStructuralHash } from "./decision-D9Zi7Xi5.mjs";
 import { a as assertEventLogStoreConformance, i as assertAgentLogEntry, n as AgentEventLogConflictError, o as assertJsonSerializable, r as NonSerializableAgentEventError, s as createInMemoryEventLogStore, t as AGENT_EVENT_SCHEMA_VERSION } from "./event-log-store-D7pWtIhb.mjs";
-import { createActor, createAsyncLogic, getNextTransitions } from "xstate";
+import { createActor, createAsyncLogic, getNextTransitions, isMachineSnapshot } from "xstate";
 //#region src/internal/state-request-pass.ts
 async function runTextPhase(stateRequest, baseMessages, deps) {
 	const { model, system } = stateRequest;
@@ -364,7 +364,7 @@ function assertMachineBindable(machine, effectiveSources, options, ctx) {
 				assertChildMachineBindable(src, src, stateName, options, ctx);
 				continue;
 			}
-			if ((isTextLogic(src) || isDecisionLogic(src) || isPlanLogic(src)) && !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 ((isTextLogic(src) || isDecisionLogic(src)) && !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];
@@ -380,11 +380,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 (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 (isTextLogic(logic)) {
 			if (executorBoundLogics.has(logic)) continue;
 			if (!ctx.rebindable) throw unrebindableChildRequestError(ctx.childPath, stateName, src, logic.mode === "stream" ? "streaming text" : "text");
@@ -442,11 +437,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.
 */
@@ -541,7 +536,7 @@ function wrapTextLogicForRunAgent(logic, runCtx) {
 		}
 	});
 }
-function createCountingDecide(runCtx, self, kind = "decision") {
+function createCountingDecide(runCtx, self) {
 	return async (attemptRequest) => {
 		runCtx.consumeModelCall();
 		runCtx.onTrace?.({
@@ -557,7 +552,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
@@ -594,8 +589,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`.
@@ -632,85 +627,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 = 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 = initialPlanLedger(logic, input);
-		const end = (stopped) => {
-			ledger = 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 = getAcceptedEvents(actorRef.getSnapshot(), {
-				schemas: runCtx.schemas,
-				eventTypes: logic.allowedEventTypes(input)
-			});
-			if (machineEvents.length === 0) return end("no-legal-events");
-			const doneDescriptor = {
-				type: PLAN_DONE_EVENT_TYPE,
-				toolName: sanitizeEventToolName(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 '${PLAN_DONE_EVENT_TYPE}'.`;
-			const chosen = await 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 = 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
@@ -850,17 +766,29 @@ 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
+* Validates `input` against the machine's registered input schema, returning
+* the schema's output — so defaults are filled and transforms applied before
+* the value reaches `createActor` or the replayable event log.
+*
+* Standard Schema only (no validation library is referenced), so this works for
+* whatever the machine was declared with. Omitted input stays omitted rather
+* than being validated as `{}`: "started with no input" keeps meaning what it
+* has always meant, instead of newly failing schemas with required fields.
 */
-function bindPlanForProvide(machine, logic, executors, options) {
-	return createRunAgentPlanLogic(logic, provideBindContext(machine, executors, options));
+function resolveMachineInput(machine, input) {
+	if (input === void 0) return input;
+	const schema = getRegisteredAgentExecutionOptions(machine).schemas?.input;
+	if (!isStandardSchema(schema)) return input;
+	try {
+		return validateSchemaSync(schema, input);
+	} catch (error) {
+		throw new AgentError("invalid-machine-input", `runAgent: machine input failed validation against the declared input schema: ${error instanceof Error ? error.message : String(error)}`, { cause: error });
+	}
 }
 /**
 * 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.
@@ -881,10 +809,6 @@ function rebindChildMachine(childMachine, runCtx, visited) {
 			if (!executorBoundLogics.has(logic)) wrapped[key] = createRunAgentDecisionLogic(logic, runCtx);
 			continue;
 		}
-		if (isPlanLogic(logic)) {
-			wrapped[key] = createRunAgentPlanLogic(logic, runCtx);
-			continue;
-		}
 		if (isTextLogic(logic)) {
 			if (!executorBoundLogics.has(logic)) wrapped[key] = wrapTextLogicForRunAgent(logic, runCtx);
 			continue;
@@ -971,6 +895,7 @@ function createAgentSession(machine, options, lifecycle) {
 	let warnedHeuristicIdle = false;
 	const runId = `run_${nextRunAgentTraceId++}`;
 	let traceSeq = 0;
+	const resolvedInput = resolveMachineInput(machine, options.input);
 	const machineId = machine.config.id ?? machine.id ?? "(machine)";
 	const machineVersion = options.machineVersion ?? machine.version ?? getMachineStructuralHash(machine);
 	const agentMeta = {
@@ -1084,10 +1009,6 @@ function createAgentSession(machine, options, lifecycle) {
 			wrappedSources[key] = createRunAgentDecisionLogic(logic, runCtx);
 			continue;
 		}
-		if (isPlanLogic(logic)) {
-			wrappedSources[key] = createRunAgentPlanLogic(logic, runCtx);
-			continue;
-		}
 		if (isTextLogic(logic)) {
 			if (!executorBoundLogics.has(logic)) wrappedSources[key] = wrapTextLogicForRunAgent(logic, runCtx);
 			continue;
@@ -1169,7 +1090,7 @@ function createAgentSession(machine, options, lifecycle) {
 		return entry;
 	};
 	if (replayEvents.length === 0 && effectiveSnapshot === void 0) {
-		const entry = initEntry(machine, options.input, { machineVersion });
+		const entry = initEntry(machine, resolvedInput, { machineVersion });
 		replayEventIds.add(entry.id);
 		replayEvents.push(entry);
 		options.onEvent?.(entry);
@@ -1224,10 +1145,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;
@@ -1309,7 +1228,7 @@ function createAgentSession(machine, options, lifecycle) {
 			}, 0);
 		};
 		actor = createActor(boundMachine, {
-			input: options.input,
+			input: resolvedInput,
 			snapshot: effectiveSnapshot,
 			inspect: (event) => {
 				if (typeof options.inspect === "function") options.inspect(event);
@@ -1358,7 +1277,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();
@@ -1400,7 +1325,7 @@ function createAgentSession(machine, options, lifecycle) {
 		}
 		onTrace({
 			type: "run.start",
-			...options.input !== void 0 ? { input: options.input } : {},
+			...resolvedInput !== void 0 ? { input: resolvedInput } : {},
 			...effectiveSnapshot !== void 0 ? { snapshot: effectiveSnapshot } : {},
 			...options.event !== void 0 ? { event: options.event } : {}
 		});
@@ -1498,7 +1423,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 (isMachineSnapshot(childSnapshot)) return !isIdleSnapshot(childSnapshot, { ignoreUserInputChildren });
+		return true;
 	})) return false;
 	return !getNextTransitions(snapshot).some((transitionDef) => transitionDef.eventType === "" || transitionDef.eventType.startsWith("xstate.after"));
 }
@@ -1637,7 +1565,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
@@ -1675,14 +1602,6 @@ function provideExecutors(machine, executors, options = {}) {
 			wrappedSources[key] = bindDecisionForProvide(provided, logic, executors, bindOptions);
 			continue;
 		}
-		if (isPlanLogic(logic)) {
-			if (!executors.decide) {
-				if (invokedSrcs.has(key)) throw missingExecutorError(key, "plan", "decide");
-				continue;
-			}
-			wrappedSources[key] = bindPlanForProvide(provided, logic, executors, bindOptions);
-			continue;
-		}
 		if (isTextLogic(logic)) {
 			if (executorBoundLogics.has(logic)) continue;
 			if (!(logic.mode === "stream" ? executors.streamText : executors.generateText)) {
@@ -1701,7 +1620,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];
@@ -1838,17 +1756,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 (isDecisionLogic(logic)) return "decision";
-		if (isPlanLogic(logic)) return "plan";
-		return;
+		return isDecisionLogic(actors[src]) ? "decision" : void 0;
 	}
-	if (isDecisionLogic(src)) return "decision";
-	if (isPlanLogic(src)) return "plan";
+	return isDecisionLogic(src) ? "decision" : void 0;
 }
 function isAgentLogicNeedingBinding(src) {
-	return (isTextLogic(src) || isDecisionLogic(src) || isPlanLogic(src)) && !executorBoundLogics.has(src);
+	return (isTextLogic(src) || isDecisionLogic(src)) && !executorBoundLogics.has(src);
 }
 function schemaExposesJson(schema) {
 	if (!schema) return false;
@@ -2129,17 +2042,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 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 = resolveAgentStep(machine, step, request, taken.value);
@@ -2223,7 +2125,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 {
@@ -2270,8 +2172,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 })) : getAcceptedEvents(settled.snapshot).map((descriptor) => ({ type: descriptor.type }));
+		const branchEvents = request?.kind === "decision" ? request.events.map((descriptor) => ({ type: descriptor.type })) : getAcceptedEvents(settled.snapshot).map((descriptor) => ({ type: descriptor.type }));
 		if (branchEvents.length === 0) {
 			pathsExplored++;
 			terminals.push({
@@ -2296,11 +2197,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 resolveAgentRequests(machine, settled, { decide: async () => ({ event }) }) : transitionAgentStep(machine, settled, event);
+			const next = transitionAgentStep(machine, settled, event);
 			recordState(next.snapshot);
 			await visit(next, [...path, event], depth + 1);
 		}
@@ -2323,10 +2224,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.
 *
@@ -2796,4 +2694,4 @@ async function runSeam(machine, options) {
 	};
 }
 //#endregion
-export { AGENT_EVENT_SCHEMA_VERSION, AGENT_INIT_EVENT_TYPE, AGENT_TRACE_SCHEMA_VERSION, AGENT_USAGE_EVENT_TYPE, AgentDecisionExhaustedError, AgentError, AgentEventLogConflictError, AgentIdleError, AgentIllegalResumeEventError, AgentLintError, AgentReplayDivergenceError, AgentReplayMachineMismatchError, AgentSnapshotVersionMismatchError, NonSerializableAgentEventError, PLAN_DONE_EVENT_TYPE, appendMessages, assertAgentLogEntry, assertAgentMachine, assertEventLogStoreConformance, assertJsonSerializable, assistantMessage, bindRequestExecutor, buildEnvelopeSchema, canReach, createAgentActor, createAgentRun, createAgentSchemas, createInMemoryEventLogStore, createReplayEntry, createScriptedExecutors, createTextLogic, diffEventLogs, executeAgentRequest, explorePaths, generateResult, getAcceptedEvents, getAgentEffects, getAgentMessages, getAgentOutputMode, getCallUsage, getJsonSchema, getJsonSchemaSync, getMachineStructuralHash, getStateMeta, initEntry, inspectTransitions, isStandardSchema, lintAgentMachine, matchesTrajectory, messagesSchema, parseAgentEvent, parseModelRef, parseOutput, parseStructuredEnvelope, persistSnapshot, provideExecutors, renderDecisionAttempts, replay, resolveDecision, runAgent, runSeam, serializeTraceEvent, setupAgent, simulateAgent, systemMessage, toolMessage, traceTransitions, userMessage, verifyReplay };
+export { AGENT_EVENT_SCHEMA_VERSION, AGENT_INIT_EVENT_TYPE, AGENT_TRACE_SCHEMA_VERSION, AGENT_USAGE_EVENT_TYPE, AgentDecisionExhaustedError, AgentError, AgentEventLogConflictError, AgentIdleError, AgentIllegalResumeEventError, AgentLintError, AgentReplayDivergenceError, AgentReplayMachineMismatchError, AgentSnapshotVersionMismatchError, NonSerializableAgentEventError, appendMessages, assertAgentLogEntry, assertAgentMachine, assertEventLogStoreConformance, assertJsonSerializable, assistantMessage, bindRequestExecutor, buildEnvelopeSchema, canReach, createAgentActor, createAgentRun, createAgentSchemas, createInMemoryEventLogStore, createReplayEntry, createScriptedExecutors, createTextLogic, diffEventLogs, executeAgentRequest, explorePaths, generateResult, getAcceptedEvents, getAgentEffects, getAgentMessages, getAgentOutputMode, getCallUsage, getJsonSchema, getJsonSchemaSync, getMachineStructuralHash, getStateMeta, initEntry, inspectTransitions, isStandardSchema, lintAgentMachine, matchesTrajectory, messagesSchema, parseAgentEvent, parseModelRef, parseOutput, parseStructuredEnvelope, persistSnapshot, provideExecutors, renderDecisionAttempts, replay, resolveDecision, runAgent, runSeam, serializeTraceEvent, setupAgent, simulateAgent, systemMessage, toolMessage, traceTransitions, userMessage, verifyReplay };

package/dist/machines.cjs

@@ -1,5 +1,5 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
-const require_setup_agent = require("./setup-agent-DP95MFrI.cjs");
+const require_setup_agent = require("./setup-agent-CpK0ZRWV.cjs");
 //#region src/machines/internal.ts
 /** The builtin inline text request every preset lowers a request entry to. */
 const GENERATE_TEXT_SRC = "agent.generateText";

package/dist/machines.d.cts

@@ -1,4 +1,4 @@
-import { _ as StandardSchemaV1, c as AgentTools } from "./types-QbEfCVny.cjs";
+import { c as AgentTools, v as StandardSchemaV1 } from "./types-DFD28AWe.cjs";
 import { AnyStateMachine } from "xstate";
 
 //#region src/machines/tool-loop.d.ts

package/dist/machines.d.mts

@@ -1,4 +1,4 @@
-import { _ as StandardSchemaV1, c as AgentTools } from "./types-_FXoFBGO.mjs";
+import { c as AgentTools, v as StandardSchemaV1 } from "./types-CTBhMnFu.mjs";
 import { AnyStateMachine } from "xstate";
 
 //#region src/machines/tool-loop.d.ts

package/dist/machines.mjs

@@ -1,4 +1,4 @@
-import { n as setupAgent } from "./setup-agent-DAZZSjDS.mjs";
+import { n as setupAgent } from "./setup-agent-DeHRW-qX.mjs";
 //#region src/machines/internal.ts
 /** The builtin inline text request every preset lowers a request entry to. */
 const GENERATE_TEXT_SRC = "agent.generateText";

package/dist/otel.cjs

@@ -33,23 +33,15 @@ function usageAttributes(usage) {
 	}
 	return attributes;
 }
-/** The model ref a request targets: text/plan carry it on `input`, a decision inline. */
+/** The model ref a request targets: text carries it on `input`, a decision inline. */
 function requestModel(request) {
 	const model = request.kind === "decision" ? request.model : request.input?.model;
 	return typeof model === "string" ? model : void 0;
 }
-/** The `src` a text/plan invoke was declared with; a decision has none. */
+/** The `src` a text invoke was declared with; a decision has none. */
 function requestSrc(request) {
 	return "src" in request && typeof request.src === "string" ? request.src : void 0;
 }
-/**
-* `gen_ai.operation.name` for a request. A plan request drives the machine
-* through a sequence of events, which semconv names `plan`; text and decision
-* requests are both single chat completions.
-*/
-function operationName(request) {
-	return request.kind === "plan" ? "plan" : "chat";
-}
 /** Best-effort JSON, never throws — content capture must not break a run. */
 function toJson(value) {
 	try {
@@ -162,10 +154,9 @@ function createOtelTraceHandler(options) {
 				const request = event.request;
 				endRequest(request.id, () => {});
 				const model = requestModel(request);
-				const operation = operationName(request);
 				const attributes = {
 					...baseAttributes,
-					"gen_ai.operation.name": operation,
+					"gen_ai.operation.name": "chat",
 					"agent.run_id": event.runId,
 					"agent.request_id": request.id,
 					"agent.request_kind": request.kind
@@ -182,9 +173,8 @@ function createOtelTraceHandler(options) {
 					const json = toJson(input.messages ?? input.prompt);
 					if (json !== void 0) attributes["gen_ai.input.messages"] = json;
 				}
-				const name = operation === "plan" ? `plan ${options.agentName ?? event.machineId}` : `chat ${model ?? request.kind}`;
-				const span = tracer.startSpan(name, {
-					kind: operation === "plan" ? _opentelemetry_api.SpanKind.INTERNAL : _opentelemetry_api.SpanKind.CLIENT,
+				const span = tracer.startSpan(`chat ${model ?? request.kind}`, {
+					kind: _opentelemetry_api.SpanKind.CLIENT,
 					attributes
 				}, runFor(event).context);
 				requests.set(request.id, {

package/dist/otel.d.cts

@@ -1,4 +1,4 @@
-import { c as AgentTraceEvent } from "./run-agent-DnvtcnTZ.cjs";
+import { l as AgentTraceEvent } from "./run-agent-B_n4Qxye.cjs";
 import { Attributes, Tracer, TracerProvider } from "@opentelemetry/api";
 
 //#region src/otel/index.d.ts

package/dist/otel.d.mts

@@ -1,4 +1,4 @@
-import { c as AgentTraceEvent } from "./run-agent-C3mFDGTf.mjs";
+import { l as AgentTraceEvent } from "./run-agent-BWzo4FLv.mjs";
 import { Attributes, Tracer, TracerProvider } from "@opentelemetry/api";
 
 //#region src/otel/index.d.ts

package/dist/otel.mjs

@@ -32,23 +32,15 @@ function usageAttributes(usage) {
 	}
 	return attributes;
 }
-/** The model ref a request targets: text/plan carry it on `input`, a decision inline. */
+/** The model ref a request targets: text carries it on `input`, a decision inline. */
 function requestModel(request) {
 	const model = request.kind === "decision" ? request.model : request.input?.model;
 	return typeof model === "string" ? model : void 0;
 }
-/** The `src` a text/plan invoke was declared with; a decision has none. */
+/** The `src` a text invoke was declared with; a decision has none. */
 function requestSrc(request) {
 	return "src" in request && typeof request.src === "string" ? request.src : void 0;
 }
-/**
-* `gen_ai.operation.name` for a request. A plan request drives the machine
-* through a sequence of events, which semconv names `plan`; text and decision
-* requests are both single chat completions.
-*/
-function operationName(request) {
-	return request.kind === "plan" ? "plan" : "chat";
-}
 /** Best-effort JSON, never throws — content capture must not break a run. */
 function toJson(value) {
 	try {
@@ -161,10 +153,9 @@ function createOtelTraceHandler(options) {
 				const request = event.request;
 				endRequest(request.id, () => {});
 				const model = requestModel(request);
-				const operation = operationName(request);
 				const attributes = {
 					...baseAttributes,
-					"gen_ai.operation.name": operation,
+					"gen_ai.operation.name": "chat",
 					"agent.run_id": event.runId,
 					"agent.request_id": request.id,
 					"agent.request_kind": request.kind
@@ -181,9 +172,8 @@ function createOtelTraceHandler(options) {
 					const json = toJson(input.messages ?? input.prompt);
 					if (json !== void 0) attributes["gen_ai.input.messages"] = json;
 				}
-				const name = operation === "plan" ? `plan ${options.agentName ?? event.machineId}` : `chat ${model ?? request.kind}`;
-				const span = tracer.startSpan(name, {
-					kind: operation === "plan" ? SpanKind.INTERNAL : SpanKind.CLIENT,
+				const span = tracer.startSpan(`chat ${model ?? request.kind}`, {
+					kind: SpanKind.CLIENT,
 					attributes
 				}, runFor(event).context);
 				requests.set(request.id, {