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

package/dist/index.d.cts

@@ -1,8 +1,8 @@
-import { C as UserMessage, S as ToolResultPart, _ as StandardSchemaV1, a as AgentToolChoice, b as ToolCallPart, c as AgentTools, d as ChosenEvent, f as EventUnion, g as NormalizedEventSchemas, h as InferOutput, i as AgentTool, l as AllowedEvents, m as ImagePart, n as AgentMessage, o as AgentToolDescriptor, p as FilePart, r as AgentSnapshotStore, s as AgentToolExecute, t as AgentEventSchemaInputMap, u as AssistantMessage, v as SystemMessage, x as ToolMessage, y as TextPart } from "./types-QbEfCVny.cjs";
+import { C as UserMessage, S as ToolResultPart, _ as StandardSchemaV1, a as AgentToolChoice, b as ToolCallPart, c as AgentTools, d as ChosenEvent, f as EventUnion, g as NormalizedEventSchemas, h as InferOutput, i as AgentTool, l as AllowedEvents, m as ImagePart, n as AgentMessage, o as AgentToolDescriptor, p as FilePart, r as AgentSnapshotStore, s as AgentToolExecute, t as AgentEventSchemaInputMap, u as AssistantMessage, v as SystemMessage, x as ToolMessage, y as TextPart } from "./types-rMe7x6NR.cjs";
 import { t as AgentError } from "./errors-BQRk9eiZ.cjs";
-import { A as AgentDecisionExhaustedError, B as renderDecisionAttempts, C as buildEnvelopeSchema, D as parseOutput, E as parseModelRef, F as DecisionAttempt, G as AgentRequestSource, H as AgentEventDescriptor, I as DecisionLogicConfig, K as getAcceptedEvents, L as PLAN_DONE_EVENT_TYPE, M as AgentDecisionRequest, N as AgentPlanInput, O as parseStructuredEnvelope, P as AgentPlanOutput, R as PlanLogic, S as bindRequestExecutor, T as getAgentOutputMode, U as AgentEventToolNameResolver, V as resolveDecision, W as AgentRequestOptions, _ as StructuredOutputEnvelope, a as AgentOutputMode, b as TextLogicExecuteArgs, c as AgentRequestExecutorResult, d as AgentTextRequest, f as AgentUsage, g as BuiltinAgentActors, h as AiSdkShapedTextResult, i as AgentModelRef, j as AgentDecisionInput, k as AgentDecisionExecutor, l as AgentRequestExecutors, m as AiSdkShapedStreamResult, n as AgentExecutorTextRequest, o as AgentRequestExecutor, p as AgentUserInput, q as parseAgentEvent, r as AgentModelMap, s as AgentRequestExecutorInfo, t as AgentCallUsage, u as AgentRequestMode, v as TextLogic, w as createTextLogic, x as TextLogicExecutor, y as TextLogicConfig, z as ResolveDecisionOptions } from "./text-logic-BDxwQNsD.cjs";
-import { A as AgentReplayDivergenceError, B as getCallUsage, C as AgentStateRequest, D as AgentEffectDiff, E as AgentEffect, F as ReplayOptions, G as AgentRequest, H as replay, I as ReplayResult, K as AgentStepRequest, L as createReplayEntry, M as AgentUsageEvent, N as CreateReplayEntryOptions, O as AgentEventLogDiff, P as GetAgentEffectsOptions, R as diffEventLogs, S as traceTransitions, T as AGENT_USAGE_EVENT_TYPE, U as verifyReplay, V as initEntry, W as AgentPlanRequest, _ as createAgentActor, a as AgentMessageInfo, b as runAgent, c as AgentTraceEvent, d as InspectedActorRef, f as JsonSerializableTraceEvent, g as RunAgentResult, h as RunAgentOptions, i as AgentIllegalResumeEventError, j as AgentReplayMachineMismatchError, k as AgentLogPatchOperation, l as AgentUserInputExecutor, m as RunAgentErrorCause, n as AgentActorSession, o as AgentRunMeta, p as PendingUserInput, q as executeAgentRequest, r as AgentIdleError, s as AgentSnapshotVersionMismatchError, t as AGENT_TRACE_SCHEMA_VERSION, u as GenerateResult, v as generateResult, w as AGENT_INIT_EVENT_TYPE, x as serializeTraceEvent, y as inspectTransitions, z as getAgentEffects } from "./run-agent-DnvtcnTZ.cjs";
-import { a as AgentLogVerification, c as assertAgentLogEntry, d as createInMemoryEventLogStore, i as AgentLogEntry, l as assertEventLogStoreConformance, n as AgentEventLogConflictError, o as JsonValue, r as AgentEventLogStore, s as NonSerializableAgentEventError, t as AGENT_EVENT_SCHEMA_VERSION, u as assertJsonSerializable } from "./event-log-store-Ruq18mGp.cjs";
+import { A as AgentDecisionExhaustedError, B as AgentRequestOptions, C as buildEnvelopeSchema, D as parseOutput, E as parseModelRef, F as ResolveDecisionOptions, H as getAcceptedEvents, I as renderDecisionAttempts, L as resolveDecision, M as AgentDecisionRequest, N as DecisionAttempt, O as parseStructuredEnvelope, P as DecisionLogicConfig, R as AgentEventDescriptor, S as bindRequestExecutor, T as getAgentOutputMode, U as parseAgentEvent, V as AgentRequestSource, _ as StructuredOutputEnvelope, a as AgentOutputMode, b as TextLogicExecuteArgs, c as AgentRequestExecutorResult, d as AgentTextRequest, f as AgentUsage, g as BuiltinAgentActors, h as AiSdkShapedTextResult, i as AgentModelRef, j as AgentDecisionInput, k as AgentDecisionExecutor, l as AgentRequestExecutors, m as AiSdkShapedStreamResult, n as AgentExecutorTextRequest, o as AgentRequestExecutor, p as AgentUserInput, r as AgentModelMap, s as AgentRequestExecutorInfo, t as AgentCallUsage, u as AgentRequestMode, v as TextLogic, w as createTextLogic, x as TextLogicExecutor, y as TextLogicConfig, z as AgentEventToolNameResolver } from "./text-logic-Jkilp1Ie.cjs";
+import { a as AgentLogVerification, c as assertAgentLogEntry, d as createInMemoryEventLogStore, i as AgentLogEntry, l as assertEventLogStoreConformance, n as AgentEventLogConflictError, o as JsonValue, r as AgentEventLogStore, s as NonSerializableAgentEventError, t as AGENT_EVENT_SCHEMA_VERSION, u as assertJsonSerializable } from "./event-log-store-CVd2eyRy.cjs";
+import { A as AgentEffectDiff, B as createReplayEntry, C as AgentStateRequest, D as AGENT_INIT_EVENT_TYPE, E as executeAgentRequest, F as AgentUsageEvent, G as replay, H as getAgentEffects, I as CreateReplayEntryOptions, K as verifyReplay, L as GetAgentEffectsOptions, M as AgentLogPatchOperation, N as AgentReplayDivergenceError, O as AGENT_USAGE_EVENT_TYPE, P as AgentReplayMachineMismatchError, R as ReplayOptions, S as traceTransitions, T as AgentStepRequest, U as getCallUsage, V as diffEventLogs, W as initEntry, _ as createAgentActor, a as AgentMessageInfo, b as runAgent, c as AgentTraceEvent, d as InspectedActorRef, f as JsonSerializableTraceEvent, g as RunAgentResult, h as RunAgentOptions, i as AgentIllegalResumeEventError, j as AgentEventLogDiff, k as AgentEffect, l as AgentUserInputExecutor, m as RunAgentErrorCause, n as AgentActorSession, o as AgentRunMeta, p as PendingUserInput, r as AgentIdleError, s as AgentSnapshotVersionMismatchError, t as AGENT_TRACE_SCHEMA_VERSION, u as GenerateResult, v as generateResult, w as AgentRequest, x as serializeTraceEvent, y as inspectTransitions, z as ReplayResult } from "./run-agent-BlqKwHIF.cjs";
 import { AnyActorLogic, AnyMachineSnapshot, AnySetupConfig, AnyStateMachine, AsyncActorLogic, EventFromLogic, EventObject, InputFrom, MachineContext, MetaObject, NonReducibleUnknown, SetupReturnFromConfig, SetupStateSchema, SnapshotFrom, StateValue } from "xstate";
 
 //#region src/messages.d.ts
@@ -420,7 +420,7 @@ type SetupAgentResult<TContextSchema extends StandardSchemaV1<Record<string, unk
  * state/transition meta are all standard schemas — no `{} as Type` casts —
  * and are retained on `result.schemas` for runtime validation. Also
  * registers the `agent.generateText`/`agent.streamText`/`agent.userInput`/
- * `agent.decide`/`agent.plan` builtin actors and lowers `requests`/`actors` into the
+ * `agent.decide` builtin actors and lowers `requests`/`actors` into the
  * machine's actor sources. The result is the xstate `setup(...)` object with
  * a wrapped `result.createMachine(...)` plus `result.schemas`/`models`/
  * `requests`/`appendMessages` attached. Also has a
@@ -593,7 +593,6 @@ interface ProvideExecutorsOptions<TMachine extends AnyStateMachine = AnyStateMac
  * - 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
@@ -782,10 +781,7 @@ interface AgentPathReport {
  * 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.
  *
@@ -938,7 +934,7 @@ type ScriptedDecisionEntry = ScriptedDecisionValue | ((request: AgentDecisionReq
 type ScriptedTextEntry = ((request: AgentTextRequest, info?: AgentRequestExecutorInfo) => unknown) | string | number | boolean | null | object;
 /** The script {@link createScriptedExecutors} plays back. */
 interface ScriptedExecutorsScript {
-  /** Answers for `decide` (and `agent.plan`) requests, consumed in order. */
+  /** Answers for `decide` requests, consumed in order. */
   decisions?: ScriptedDecisionEntry[];
   /** Answers for text requests, consumed in order. `generateText` and `streamText` share this one queue. */
   text?: ScriptedTextEntry[];
@@ -1202,4 +1198,4 @@ declare function getJsonSchema(schema?: StandardSchemaV1): Promise<Record<string
  */
 declare function getJsonSchemaSync(schema?: StandardSchemaV1): Record<string, unknown> | undefined;
 //#endregion
-export { AGENT_EVENT_SCHEMA_VERSION, AGENT_INIT_EVENT_TYPE, AGENT_TRACE_SCHEMA_VERSION, AGENT_USAGE_EVENT_TYPE, type AgentActorSession, type AgentCallUsage, type AgentDecisionExecutor, AgentDecisionExhaustedError, type AgentDecisionInput, type AgentDecisionRequest, type AgentEffect, type AgentEffectDiff, AgentError, type AgentEventDescriptor, AgentEventLogConflictError, type AgentEventLogDiff, type AgentEventLogStore, type AgentEventToolNameResolver, type AgentExecutorTextRequest, AgentIdleError, AgentIllegalResumeEventError, type AgentLintDiagnostic, AgentLintError, type AgentLintSeverity, type AgentLogEntry, type AgentLogPatchOperation, type AgentLogVerification, type AgentMessage, type AgentMessageInfo, type AgentModelRef, type AgentOutputMode, type AgentPathReport, type AgentPathTerminal, type AgentPlanInput, type AgentPlanOutput, type AgentPlanRequest, AgentReplayDivergenceError, AgentReplayMachineMismatchError, type AgentRequest, type AgentRequestExecutor, type AgentRequestExecutorInfo, type AgentRequestExecutorResult, type AgentRequestExecutors, type AgentRequestOptions, type AgentRequestSource, type AgentRun, type AgentRunMeta, type AgentSchemaPack, type AgentSnapshotStore, AgentSnapshotVersionMismatchError, type AgentStateRequest, type AgentStepRequest, type AgentTextRequest, type AgentTool, type AgentToolChoice, type AgentToolDescriptor, type AgentToolExecute, type AgentTools, type AgentTraceEvent, type AgentUsage, type AgentUsageEvent, type AgentUsageEventPayload, type AgentUserInput, type AgentUserInputExecutor, type AgentWorkflowActionConfig, type AgentWorkflowActorConfig, type AgentWorkflowConfig, type AgentWorkflowInvokeConfig, type AgentWorkflowRequestConfig, type AgentWorkflowStateConfig, type AgentWorkflowTransitionConfig, type AiSdkShapedStreamResult, type AiSdkShapedTextResult, type AllowedEvents, type AssertAgentMachineOptions, type AssistantMessage, type CanReachResult, type ChosenEvent, type CreateReplayEntryOptions, type DecisionAttempt, type DecisionLogicConfig, type ExplorePathsOptions, type FilePart, type FromConfigOptions, type FromConfigResult, type GenerateResult, type GetAgentEffectsOptions, type ImagePart, type InferOutput, type InspectedActorRef, type JsonSerializableTraceEvent, type JsonValue, type LintAgentMachineOptions, type MatchTrajectoryOptions, NonSerializableAgentEventError, PLAN_DONE_EVENT_TYPE, type PendingUserInput, type PlanLogic, type ProvideExecutorsOptions, type ReplayOptions, type ReplayResult, type ResolveDecisionOptions, type RunAgentErrorCause, type RunAgentOptions, type RunAgentResult, type RunSeamOptions, type RunSeamResult, type SchemaCompiler, type ScriptedDecisionEntry, type ScriptedDecisionValue, type ScriptedExecutorsScript, type ScriptedTextEntry, type SeamRef, type SeamSlice, type SeamTurn, type SimulateAgentOptions, type SimulateAgentResult, type SimulationScript, type SimulationTrailEntry, type StandardSchemaV1, type StructuredOutputEnvelope, type SystemMessage, type TextLogic, type TextLogicConfig, type TextLogicExecuteArgs, type TextLogicExecutor, type TextPart, type ToolCallPart, type ToolMessage, type ToolResultPart, type TrajectoryEvent, type TrajectoryItem, type TrajectoryMatch, type TrajectoryMiss, type UserMessage, type WithAgentUsageEvent, 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, type AgentActorSession, type AgentCallUsage, type AgentDecisionExecutor, AgentDecisionExhaustedError, type AgentDecisionInput, type AgentDecisionRequest, type AgentEffect, type AgentEffectDiff, AgentError, type AgentEventDescriptor, AgentEventLogConflictError, type AgentEventLogDiff, type AgentEventLogStore, type AgentEventToolNameResolver, type AgentExecutorTextRequest, AgentIdleError, AgentIllegalResumeEventError, type AgentLintDiagnostic, AgentLintError, type AgentLintSeverity, type AgentLogEntry, type AgentLogPatchOperation, type AgentLogVerification, type AgentMessage, type AgentMessageInfo, type AgentModelRef, type AgentOutputMode, type AgentPathReport, type AgentPathTerminal, AgentReplayDivergenceError, AgentReplayMachineMismatchError, type AgentRequest, type AgentRequestExecutor, type AgentRequestExecutorInfo, type AgentRequestExecutorResult, type AgentRequestExecutors, type AgentRequestOptions, type AgentRequestSource, type AgentRun, type AgentRunMeta, type AgentSchemaPack, type AgentSnapshotStore, AgentSnapshotVersionMismatchError, type AgentStateRequest, type AgentStepRequest, type AgentTextRequest, type AgentTool, type AgentToolChoice, type AgentToolDescriptor, type AgentToolExecute, type AgentTools, type AgentTraceEvent, type AgentUsage, type AgentUsageEvent, type AgentUsageEventPayload, type AgentUserInput, type AgentUserInputExecutor, type AgentWorkflowActionConfig, type AgentWorkflowActorConfig, type AgentWorkflowConfig, type AgentWorkflowInvokeConfig, type AgentWorkflowRequestConfig, type AgentWorkflowStateConfig, type AgentWorkflowTransitionConfig, type AiSdkShapedStreamResult, type AiSdkShapedTextResult, type AllowedEvents, type AssertAgentMachineOptions, type AssistantMessage, type CanReachResult, type ChosenEvent, type CreateReplayEntryOptions, type DecisionAttempt, type DecisionLogicConfig, type ExplorePathsOptions, type FilePart, type FromConfigOptions, type FromConfigResult, type GenerateResult, type GetAgentEffectsOptions, type ImagePart, type InferOutput, type InspectedActorRef, type JsonSerializableTraceEvent, type JsonValue, type LintAgentMachineOptions, type MatchTrajectoryOptions, NonSerializableAgentEventError, type PendingUserInput, type ProvideExecutorsOptions, type ReplayOptions, type ReplayResult, type ResolveDecisionOptions, type RunAgentErrorCause, type RunAgentOptions, type RunAgentResult, type RunSeamOptions, type RunSeamResult, type SchemaCompiler, type ScriptedDecisionEntry, type ScriptedDecisionValue, type ScriptedExecutorsScript, type ScriptedTextEntry, type SeamRef, type SeamSlice, type SeamTurn, type SimulateAgentOptions, type SimulateAgentResult, type SimulationScript, type SimulationTrailEntry, type StandardSchemaV1, type StructuredOutputEnvelope, type SystemMessage, type TextLogic, type TextLogicConfig, type TextLogicExecuteArgs, type TextLogicExecutor, type TextPart, type ToolCallPart, type ToolMessage, type ToolResultPart, type TrajectoryEvent, type TrajectoryItem, type TrajectoryMatch, type TrajectoryMiss, type UserMessage, type WithAgentUsageEvent, 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/index.d.mts

@@ -1,8 +1,8 @@
-import { C as UserMessage, S as ToolResultPart, _ as StandardSchemaV1, a as AgentToolChoice, b as ToolCallPart, c as AgentTools, d as ChosenEvent, f as EventUnion, g as NormalizedEventSchemas, h as InferOutput, i as AgentTool, l as AllowedEvents, m as ImagePart, n as AgentMessage, o as AgentToolDescriptor, p as FilePart, r as AgentSnapshotStore, s as AgentToolExecute, t as AgentEventSchemaInputMap, u as AssistantMessage, v as SystemMessage, x as ToolMessage, y as TextPart } from "./types-_FXoFBGO.mjs";
+import { C as UserMessage, S as ToolResultPart, _ as StandardSchemaV1, a as AgentToolChoice, b as ToolCallPart, c as AgentTools, d as ChosenEvent, f as EventUnion, g as NormalizedEventSchemas, h as InferOutput, i as AgentTool, l as AllowedEvents, m as ImagePart, n as AgentMessage, o as AgentToolDescriptor, p as FilePart, r as AgentSnapshotStore, s as AgentToolExecute, t as AgentEventSchemaInputMap, u as AssistantMessage, v as SystemMessage, x as ToolMessage, y as TextPart } from "./types-9Bqg5rZB.mjs";
 import { t as AgentError } from "./errors-C9rxnWbX.mjs";
-import { A as AgentDecisionExhaustedError, B as renderDecisionAttempts, C as buildEnvelopeSchema, D as parseOutput, E as parseModelRef, F as DecisionAttempt, G as AgentRequestSource, H as AgentEventDescriptor, I as DecisionLogicConfig, K as getAcceptedEvents, L as PLAN_DONE_EVENT_TYPE, M as AgentDecisionRequest, N as AgentPlanInput, O as parseStructuredEnvelope, P as AgentPlanOutput, R as PlanLogic, S as bindRequestExecutor, T as getAgentOutputMode, U as AgentEventToolNameResolver, V as resolveDecision, W as AgentRequestOptions, _ as StructuredOutputEnvelope, a as AgentOutputMode, b as TextLogicExecuteArgs, c as AgentRequestExecutorResult, d as AgentTextRequest, f as AgentUsage, g as BuiltinAgentActors, h as AiSdkShapedTextResult, i as AgentModelRef, j as AgentDecisionInput, k as AgentDecisionExecutor, l as AgentRequestExecutors, m as AiSdkShapedStreamResult, n as AgentExecutorTextRequest, o as AgentRequestExecutor, p as AgentUserInput, q as parseAgentEvent, r as AgentModelMap, s as AgentRequestExecutorInfo, t as AgentCallUsage, u as AgentRequestMode, v as TextLogic, w as createTextLogic, x as TextLogicExecutor, y as TextLogicConfig, z as ResolveDecisionOptions } from "./text-logic-TkKPw8Aq.mjs";
-import { A as AgentReplayDivergenceError, B as getCallUsage, C as AgentStateRequest, D as AgentEffectDiff, E as AgentEffect, F as ReplayOptions, G as AgentRequest, H as replay, I as ReplayResult, K as AgentStepRequest, L as createReplayEntry, M as AgentUsageEvent, N as CreateReplayEntryOptions, O as AgentEventLogDiff, P as GetAgentEffectsOptions, R as diffEventLogs, S as traceTransitions, T as AGENT_USAGE_EVENT_TYPE, U as verifyReplay, V as initEntry, W as AgentPlanRequest, _ as createAgentActor, a as AgentMessageInfo, b as runAgent, c as AgentTraceEvent, d as InspectedActorRef, f as JsonSerializableTraceEvent, g as RunAgentResult, h as RunAgentOptions, i as AgentIllegalResumeEventError, j as AgentReplayMachineMismatchError, k as AgentLogPatchOperation, l as AgentUserInputExecutor, m as RunAgentErrorCause, n as AgentActorSession, o as AgentRunMeta, p as PendingUserInput, q as executeAgentRequest, r as AgentIdleError, s as AgentSnapshotVersionMismatchError, t as AGENT_TRACE_SCHEMA_VERSION, u as GenerateResult, v as generateResult, w as AGENT_INIT_EVENT_TYPE, x as serializeTraceEvent, y as inspectTransitions, z as getAgentEffects } from "./run-agent-C3mFDGTf.mjs";
-import { a as AgentLogVerification, c as assertAgentLogEntry, d as createInMemoryEventLogStore, i as AgentLogEntry, l as assertEventLogStoreConformance, n as AgentEventLogConflictError, o as JsonValue, r as AgentEventLogStore, s as NonSerializableAgentEventError, t as AGENT_EVENT_SCHEMA_VERSION, u as assertJsonSerializable } from "./event-log-store-CriMgX1D.mjs";
+import { A as AgentDecisionExhaustedError, B as AgentRequestOptions, C as buildEnvelopeSchema, D as parseOutput, E as parseModelRef, F as ResolveDecisionOptions, H as getAcceptedEvents, I as renderDecisionAttempts, L as resolveDecision, M as AgentDecisionRequest, N as DecisionAttempt, O as parseStructuredEnvelope, P as DecisionLogicConfig, R as AgentEventDescriptor, S as bindRequestExecutor, T as getAgentOutputMode, U as parseAgentEvent, V as AgentRequestSource, _ as StructuredOutputEnvelope, a as AgentOutputMode, b as TextLogicExecuteArgs, c as AgentRequestExecutorResult, d as AgentTextRequest, f as AgentUsage, g as BuiltinAgentActors, h as AiSdkShapedTextResult, i as AgentModelRef, j as AgentDecisionInput, k as AgentDecisionExecutor, l as AgentRequestExecutors, m as AiSdkShapedStreamResult, n as AgentExecutorTextRequest, o as AgentRequestExecutor, p as AgentUserInput, r as AgentModelMap, s as AgentRequestExecutorInfo, t as AgentCallUsage, u as AgentRequestMode, v as TextLogic, w as createTextLogic, x as TextLogicExecutor, y as TextLogicConfig, z as AgentEventToolNameResolver } from "./text-logic-C5kbjaDz.mjs";
+import { a as AgentLogVerification, c as assertAgentLogEntry, d as createInMemoryEventLogStore, i as AgentLogEntry, l as assertEventLogStoreConformance, n as AgentEventLogConflictError, o as JsonValue, r as AgentEventLogStore, s as NonSerializableAgentEventError, t as AGENT_EVENT_SCHEMA_VERSION, u as assertJsonSerializable } from "./event-log-store-BkUNtyOF.mjs";
+import { A as AgentEffectDiff, B as createReplayEntry, C as AgentStateRequest, D as AGENT_INIT_EVENT_TYPE, E as executeAgentRequest, F as AgentUsageEvent, G as replay, H as getAgentEffects, I as CreateReplayEntryOptions, K as verifyReplay, L as GetAgentEffectsOptions, M as AgentLogPatchOperation, N as AgentReplayDivergenceError, O as AGENT_USAGE_EVENT_TYPE, P as AgentReplayMachineMismatchError, R as ReplayOptions, S as traceTransitions, T as AgentStepRequest, U as getCallUsage, V as diffEventLogs, W as initEntry, _ as createAgentActor, a as AgentMessageInfo, b as runAgent, c as AgentTraceEvent, d as InspectedActorRef, f as JsonSerializableTraceEvent, g as RunAgentResult, h as RunAgentOptions, i as AgentIllegalResumeEventError, j as AgentEventLogDiff, k as AgentEffect, l as AgentUserInputExecutor, m as RunAgentErrorCause, n as AgentActorSession, o as AgentRunMeta, p as PendingUserInput, r as AgentIdleError, s as AgentSnapshotVersionMismatchError, t as AGENT_TRACE_SCHEMA_VERSION, u as GenerateResult, v as generateResult, w as AgentRequest, x as serializeTraceEvent, y as inspectTransitions, z as ReplayResult } from "./run-agent-2MnlQTkB.mjs";
 import { AnyActorLogic, AnyMachineSnapshot, AnySetupConfig, AnyStateMachine, AsyncActorLogic, EventFromLogic, EventObject, InputFrom, MachineContext, MetaObject, NonReducibleUnknown, SetupReturnFromConfig, SetupStateSchema, SnapshotFrom, StateValue } from "xstate";
 
 //#region src/messages.d.ts
@@ -420,7 +420,7 @@ type SetupAgentResult<TContextSchema extends StandardSchemaV1<Record<string, unk
  * state/transition meta are all standard schemas — no `{} as Type` casts —
  * and are retained on `result.schemas` for runtime validation. Also
  * registers the `agent.generateText`/`agent.streamText`/`agent.userInput`/
- * `agent.decide`/`agent.plan` builtin actors and lowers `requests`/`actors` into the
+ * `agent.decide` builtin actors and lowers `requests`/`actors` into the
  * machine's actor sources. The result is the xstate `setup(...)` object with
  * a wrapped `result.createMachine(...)` plus `result.schemas`/`models`/
  * `requests`/`appendMessages` attached. Also has a
@@ -593,7 +593,6 @@ interface ProvideExecutorsOptions<TMachine extends AnyStateMachine = AnyStateMac
  * - 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
@@ -782,10 +781,7 @@ interface AgentPathReport {
  * 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.
  *
@@ -938,7 +934,7 @@ type ScriptedDecisionEntry = ScriptedDecisionValue | ((request: AgentDecisionReq
 type ScriptedTextEntry = ((request: AgentTextRequest, info?: AgentRequestExecutorInfo) => unknown) | string | number | boolean | null | object;
 /** The script {@link createScriptedExecutors} plays back. */
 interface ScriptedExecutorsScript {
-  /** Answers for `decide` (and `agent.plan`) requests, consumed in order. */
+  /** Answers for `decide` requests, consumed in order. */
   decisions?: ScriptedDecisionEntry[];
   /** Answers for text requests, consumed in order. `generateText` and `streamText` share this one queue. */
   text?: ScriptedTextEntry[];
@@ -1202,4 +1198,4 @@ declare function getJsonSchema(schema?: StandardSchemaV1): Promise<Record<string
  */
 declare function getJsonSchemaSync(schema?: StandardSchemaV1): Record<string, unknown> | undefined;
 //#endregion
-export { AGENT_EVENT_SCHEMA_VERSION, AGENT_INIT_EVENT_TYPE, AGENT_TRACE_SCHEMA_VERSION, AGENT_USAGE_EVENT_TYPE, type AgentActorSession, type AgentCallUsage, type AgentDecisionExecutor, AgentDecisionExhaustedError, type AgentDecisionInput, type AgentDecisionRequest, type AgentEffect, type AgentEffectDiff, AgentError, type AgentEventDescriptor, AgentEventLogConflictError, type AgentEventLogDiff, type AgentEventLogStore, type AgentEventToolNameResolver, type AgentExecutorTextRequest, AgentIdleError, AgentIllegalResumeEventError, type AgentLintDiagnostic, AgentLintError, type AgentLintSeverity, type AgentLogEntry, type AgentLogPatchOperation, type AgentLogVerification, type AgentMessage, type AgentMessageInfo, type AgentModelRef, type AgentOutputMode, type AgentPathReport, type AgentPathTerminal, type AgentPlanInput, type AgentPlanOutput, type AgentPlanRequest, AgentReplayDivergenceError, AgentReplayMachineMismatchError, type AgentRequest, type AgentRequestExecutor, type AgentRequestExecutorInfo, type AgentRequestExecutorResult, type AgentRequestExecutors, type AgentRequestOptions, type AgentRequestSource, type AgentRun, type AgentRunMeta, type AgentSchemaPack, type AgentSnapshotStore, AgentSnapshotVersionMismatchError, type AgentStateRequest, type AgentStepRequest, type AgentTextRequest, type AgentTool, type AgentToolChoice, type AgentToolDescriptor, type AgentToolExecute, type AgentTools, type AgentTraceEvent, type AgentUsage, type AgentUsageEvent, type AgentUsageEventPayload, type AgentUserInput, type AgentUserInputExecutor, type AgentWorkflowActionConfig, type AgentWorkflowActorConfig, type AgentWorkflowConfig, type AgentWorkflowInvokeConfig, type AgentWorkflowRequestConfig, type AgentWorkflowStateConfig, type AgentWorkflowTransitionConfig, type AiSdkShapedStreamResult, type AiSdkShapedTextResult, type AllowedEvents, type AssertAgentMachineOptions, type AssistantMessage, type CanReachResult, type ChosenEvent, type CreateReplayEntryOptions, type DecisionAttempt, type DecisionLogicConfig, type ExplorePathsOptions, type FilePart, type FromConfigOptions, type FromConfigResult, type GenerateResult, type GetAgentEffectsOptions, type ImagePart, type InferOutput, type InspectedActorRef, type JsonSerializableTraceEvent, type JsonValue, type LintAgentMachineOptions, type MatchTrajectoryOptions, NonSerializableAgentEventError, PLAN_DONE_EVENT_TYPE, type PendingUserInput, type PlanLogic, type ProvideExecutorsOptions, type ReplayOptions, type ReplayResult, type ResolveDecisionOptions, type RunAgentErrorCause, type RunAgentOptions, type RunAgentResult, type RunSeamOptions, type RunSeamResult, type SchemaCompiler, type ScriptedDecisionEntry, type ScriptedDecisionValue, type ScriptedExecutorsScript, type ScriptedTextEntry, type SeamRef, type SeamSlice, type SeamTurn, type SimulateAgentOptions, type SimulateAgentResult, type SimulationScript, type SimulationTrailEntry, type StandardSchemaV1, type StructuredOutputEnvelope, type SystemMessage, type TextLogic, type TextLogicConfig, type TextLogicExecuteArgs, type TextLogicExecutor, type TextPart, type ToolCallPart, type ToolMessage, type ToolResultPart, type TrajectoryEvent, type TrajectoryItem, type TrajectoryMatch, type TrajectoryMiss, type UserMessage, type WithAgentUsageEvent, 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, type AgentActorSession, type AgentCallUsage, type AgentDecisionExecutor, AgentDecisionExhaustedError, type AgentDecisionInput, type AgentDecisionRequest, type AgentEffect, type AgentEffectDiff, AgentError, type AgentEventDescriptor, AgentEventLogConflictError, type AgentEventLogDiff, type AgentEventLogStore, type AgentEventToolNameResolver, type AgentExecutorTextRequest, AgentIdleError, AgentIllegalResumeEventError, type AgentLintDiagnostic, AgentLintError, type AgentLintSeverity, type AgentLogEntry, type AgentLogPatchOperation, type AgentLogVerification, type AgentMessage, type AgentMessageInfo, type AgentModelRef, type AgentOutputMode, type AgentPathReport, type AgentPathTerminal, AgentReplayDivergenceError, AgentReplayMachineMismatchError, type AgentRequest, type AgentRequestExecutor, type AgentRequestExecutorInfo, type AgentRequestExecutorResult, type AgentRequestExecutors, type AgentRequestOptions, type AgentRequestSource, type AgentRun, type AgentRunMeta, type AgentSchemaPack, type AgentSnapshotStore, AgentSnapshotVersionMismatchError, type AgentStateRequest, type AgentStepRequest, type AgentTextRequest, type AgentTool, type AgentToolChoice, type AgentToolDescriptor, type AgentToolExecute, type AgentTools, type AgentTraceEvent, type AgentUsage, type AgentUsageEvent, type AgentUsageEventPayload, type AgentUserInput, type AgentUserInputExecutor, type AgentWorkflowActionConfig, type AgentWorkflowActorConfig, type AgentWorkflowConfig, type AgentWorkflowInvokeConfig, type AgentWorkflowRequestConfig, type AgentWorkflowStateConfig, type AgentWorkflowTransitionConfig, type AiSdkShapedStreamResult, type AiSdkShapedTextResult, type AllowedEvents, type AssertAgentMachineOptions, type AssistantMessage, type CanReachResult, type ChosenEvent, type CreateReplayEntryOptions, type DecisionAttempt, type DecisionLogicConfig, type ExplorePathsOptions, type FilePart, type FromConfigOptions, type FromConfigResult, type GenerateResult, type GetAgentEffectsOptions, type ImagePart, type InferOutput, type InspectedActorRef, type JsonSerializableTraceEvent, type JsonValue, type LintAgentMachineOptions, type MatchTrajectoryOptions, NonSerializableAgentEventError, type PendingUserInput, type ProvideExecutorsOptions, type ReplayOptions, type ReplayResult, type ResolveDecisionOptions, type RunAgentErrorCause, type RunAgentOptions, type RunAgentResult, type RunSeamOptions, type RunSeamResult, type SchemaCompiler, type ScriptedDecisionEntry, type ScriptedDecisionValue, type ScriptedExecutorsScript, type ScriptedTextEntry, type SeamRef, type SeamSlice, type SeamTurn, type SimulateAgentOptions, type SimulateAgentResult, type SimulationScript, type SimulationTrailEntry, type StandardSchemaV1, type StructuredOutputEnvelope, type SystemMessage, type TextLogic, type TextLogicConfig, type TextLogicExecuteArgs, type TextLogicExecutor, type TextPart, type ToolCallPart, type ToolMessage, type ToolResultPart, type TrajectoryEvent, type TrajectoryItem, type TrajectoryMatch, type TrajectoryMiss, type UserMessage, type WithAgentUsageEvent, 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/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, 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,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.
@@ -881,10 +789,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;
@@ -1084,10 +988,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;
@@ -1224,10 +1124,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;
@@ -1358,7 +1256,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();
@@ -1498,7 +1402,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 +1544,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 +1581,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 +1599,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 +1735,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 +2021,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 +2104,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 +2151,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 +2176,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 +2203,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 +2673,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 { _ as StandardSchemaV1, c as AgentTools } from "./types-rMe7x6NR.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 { _ as StandardSchemaV1, c as AgentTools } from "./types-9Bqg5rZB.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 { c as AgentTraceEvent } from "./run-agent-BlqKwHIF.cjs";
 import { Attributes, Tracer, TracerProvider } from "@opentelemetry/api";
 
 //#region src/otel/index.d.ts