@statelyai/agent 2.0.0-alpha.19 → 2.0.0-alpha.20

package/dist/ai-sdk.cjs

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

package/dist/ai-sdk.mjs

@@ -1,4 +1,4 @@
-import { H as isStandardSchema, _ as getAgentOutputMode, i as renderDecisionAttempts, p as buildEnvelopeSchema } from "./decision-DsIkEuHz.mjs";
+import { H as isStandardSchema, _ as getAgentOutputMode, i as renderDecisionAttempts, p as buildEnvelopeSchema } from "./decision-BfhSgCc6.mjs";
 import { NoObjectGeneratedError, Output, generateText, stepCountIs, streamText, tool } from "ai";
 //#region src/ai-sdk/mappers.ts
 /**

package/dist/{decision-DsIkEuHz.mjs → decision-BfhSgCc6.mjs}

@@ -167,7 +167,7 @@ function toolMessage(content) {
 * ```
 */
 function getStateMeta(snapshot) {
-	const nodes = snapshot._nodes;
+	const nodes = snapshot.nodes;
 	const depthById = new Map(nodes?.map((node) => [node.id, node.path.length]));
 	const depth = (id) => depthById.get(id) ?? id.split(".").length;
 	const entries = Object.entries(snapshot.getMeta()).filter((entry) => entry[1] != null).sort(([a], [b]) => depth(a) - depth(b) || (a < b ? -1 : a > b ? 1 : 0));

package/dist/{decision-t26zsnSR.cjs → decision-DhsKLYAI.cjs}

@@ -168,7 +168,7 @@ function toolMessage(content) {
 * ```
 */
 function getStateMeta(snapshot) {
-	const nodes = snapshot._nodes;
+	const nodes = snapshot.nodes;
 	const depthById = new Map(nodes?.map((node) => [node.id, node.path.length]));
 	const depth = (id) => depthById.get(id) ?? id.split(".").length;
 	const entries = Object.entries(snapshot.getMeta()).filter((entry) => entry[1] != null).sort(([a], [b]) => depth(a) - depth(b) || (a < b ? -1 : a > b ? 1 : 0));

package/dist/index.cjs

@@ -1,10 +1,11 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
 const require_errors = require("./errors-DUBBzRLP.cjs");
-const require_setup_agent = require("./setup-agent-BFA4VKpN.cjs");
-const require_decision = require("./decision-t26zsnSR.cjs");
+const require_setup_agent = require("./setup-agent-gISRLxRe.cjs");
+const require_decision = require("./decision-DhsKLYAI.cjs");
 const require_event_log_store = require("./event-log-store-a_TKy1gk.cjs");
 require("./validate.cjs");
 let xstate = require("xstate");
+let xstate_durable = require("xstate/durable");
 //#region src/internal/state-request-pass.ts
 async function runTextPhase(stateRequest, baseMessages, deps) {
 	const { model, system } = stateRequest;
@@ -286,7 +287,7 @@ function serializeTraceEvent(event, options = {}) {
 	return out;
 }
 function snapshotNodes(snapshot) {
-	return (snapshot._nodes ?? []).map((raw) => {
+	return (snapshot.nodes ?? []).map((raw) => {
 		const node = raw;
 		return {
 			id: node.id ?? "",
@@ -1161,6 +1162,7 @@ function createAgentSession(machine, options, lifecycle) {
 		const aligned = Object.assign(Object.create(Object.getPrototypeOf(effectiveSnapshot)), effectiveSnapshot);
 		if (machineOwnVersion === void 0) delete aligned.version;
 		else aligned.version = machineOwnVersion;
+		delete aligned.machine;
 		effectiveSnapshot = aligned;
 	}
 	const priorMessages = require_decision.getAgentMessages(effectiveSnapshot);
@@ -2829,6 +2831,196 @@ async function runSeam(machine, options) {
 	};
 }
 //#endregion
+//#region src/durable.ts
+/**
+* The durable host runner: {@link runDurableAgent} drives an executor-bound
+* agent machine on xstate's `createDurable` execution (`xstate/durable`),
+* with the agent event log as the journal.
+*
+* Where {@link replay} + `getAgentEffects` hand a host an effect list to run
+* itself, `runDurableAgent` owns the whole loop on the durable runtime:
+* invoked actors execute live through xstate's own runtime, every EXTERNAL
+* event (invoke completions included) is appended to the log, and a resume
+* folds the log back through pure transitions — an invoke whose completion is
+* already journaled is never re-started, so recorded model calls are never
+* re-executed. Crash recovery re-runs only the work that was still in flight.
+*
+* @module
+*/
+const DONE_ACTOR_EVENT_TYPE = "xstate.done.actor";
+const ERROR_ACTOR_EVENT_TYPE = "xstate.error.actor";
+function completionActorId(event) {
+	if (event.type !== DONE_ACTOR_EVENT_TYPE && event.type !== ERROR_ACTOR_EVENT_TYPE) return;
+	const actorId = event.actorId;
+	return typeof actorId === "string" ? actorId : void 0;
+}
+function createMailbox() {
+	const queue = [];
+	const waiters = [];
+	return {
+		push(event) {
+			const waiter = waiters.shift();
+			if (waiter) waiter(event);
+			else queue.push(event);
+		},
+		take() {
+			const next = queue.shift();
+			if (next !== void 0) return Promise.resolve(next);
+			return new Promise((resolve) => waiters.push(resolve));
+		},
+		size: () => queue.length
+	};
+}
+/**
+* Runs an agent machine as a durable execution: journal in, journal out.
+*
+* A fresh call starts from `input` and appends a reserved init entry; a
+* resume call folds `entries` through pure transitions first — invokes whose
+* completions are journaled are suppressed (their recorded results replay
+* instead of re-executing), while work that was in flight at the crash
+* re-executes live. After the journal, an optional `options.event` is
+* delivered. The call settles:
+*
+* - `done` when the machine reaches a final state, with `output`;
+* - `idle` when the frontier needs an external event the host has not
+*   supplied (no live work pending, or `isIdle` says the pending work is a
+*   human wait). Persist `entries` and call again with them later.
+*
+* ```ts
+* const first = await runDurableAgent(machine, { input, executors });
+* // ... persist first.entries; later, in a new process:
+* const next = await runDurableAgent(machine, {
+*   entries: first.entries,
+*   event: { type: "APPROVE" },
+*   executors,
+* });
+* ```
+*
+* @experimental Built on xstate's experimental `xstate/durable` entrypoint.
+*/
+async function runDurableAgent(machine, options = {}) {
+	const bound = options.executors ? provideExecutors(machine, options.executors, {
+		actors: options.actors,
+		onChunk: options.onChunk,
+		onTrace: options.onTrace
+	}) : options.actors ? machine.provide({ actors: options.actors }) : machine;
+	const machineId = machine.config.id ?? machine.id ?? "(machine)";
+	const machineVersion = options.machineVersion ?? require_decision.resolveMachineVersion(machine);
+	const priorEntries = options.entries ?? [];
+	if (priorEntries.length > 0) require_setup_agent.validateReplayEntries(priorEntries, {
+		machineId,
+		machineVersion
+	}, "Durable journal entries");
+	const hasInit = priorEntries[0]?.event.type === require_setup_agent.AGENT_INIT_EVENT_TYPE;
+	const input = hasInit ? priorEntries[0].event.input : options.input;
+	const journal = priorEntries.slice(hasInit ? 1 : 0).map((entry) => entry.event);
+	const journaledCompletions = /* @__PURE__ */ new Map();
+	for (const event of journal) {
+		const actorId = completionActorId(event);
+		if (actorId !== void 0) journaledCompletions.set(actorId, (journaledCompletions.get(actorId) ?? 0) + 1);
+	}
+	const mailbox = createMailbox();
+	const rootAddress = machineId;
+	const suppressedChildren = /* @__PURE__ */ new WeakSet();
+	const startsSeen = /* @__PURE__ */ new Map();
+	const liveInFlight = /* @__PURE__ */ new Set();
+	const findChildRef = (effect) => {
+		const raw = effect;
+		const candidates = [raw.actor, ...Array.isArray(raw.args) ? raw.args : []];
+		for (const candidate of candidates) {
+			const ref = candidate;
+			if (ref && typeof ref.sessionId === "string" && typeof ref.id === "string") return ref;
+		}
+	};
+	let replaying = journal.length > 0;
+	const execution = (0, xstate_durable.createDurable)(bound, {
+		sendEvent(source, target, event) {
+			if (target.address === rootAddress) {
+				mailbox.push(event);
+				return;
+			}
+			(0, xstate.deliverEvent)(source, target, event);
+		},
+		runtime(_metadata, effect) {
+			const type = effect.type;
+			if (type === "@xstate.spawn" || type === "@xstate.start") {
+				const child = findChildRef(effect);
+				if (!child) return {};
+				if (type === "@xstate.spawn") {
+					const seen = (startsSeen.get(child.id) ?? 0) + 1;
+					startsSeen.set(child.id, seen);
+					if (seen <= (journaledCompletions.get(child.id) ?? 0)) suppressedChildren.add(child);
+					else liveInFlight.add(child.id);
+				}
+				if (suppressedChildren.has(child)) return {
+					spawnActor() {},
+					startActor() {}
+				};
+			}
+			return {};
+		},
+		executeAction(action) {
+			if (replaying) return;
+			action.exec?.();
+		},
+		waitForEvent() {
+			return mailbox.take();
+		}
+	});
+	const entries = [...priorEntries];
+	const entryOptions = {
+		machineVersion,
+		verification: options.verification ?? false
+	};
+	const appendEntry = (event) => {
+		const entry = require_setup_agent.createReplayEntry(machine, entries, event, entryOptions);
+		entries.push(entry);
+		options.onEntry?.(entry);
+	};
+	if (!hasInit) {
+		const entry = require_setup_agent.initEntry(machine, input, entryOptions);
+		entries.push(entry);
+		options.onEntry?.(entry);
+	}
+	const sessions = /* @__PURE__ */ new Map();
+	let journalIndex = 0;
+	let liveEventConsumed = false;
+	let [snapshot, effects] = execution.initialTransition(input);
+	for (;;) {
+		const captured = await execution.executeEffects(effects);
+		for (const rootEvent of captured) mailbox.push(rootEvent.event);
+		const machineSnapshot = snapshot;
+		if (machineSnapshot.status === "done") return {
+			status: "done",
+			output: machineSnapshot.output,
+			snapshot,
+			entries
+		};
+		if (machineSnapshot.status === "error") throw machineSnapshot.error;
+		let event;
+		let fromJournal = false;
+		if (journalIndex < journal.length) {
+			event = require_setup_agent.rebindActorSession(journal[journalIndex], machineSnapshot, sessions);
+			journalIndex++;
+			fromJournal = true;
+			replaying = journalIndex < journal.length;
+		} else if (mailbox.size() > 0) event = await mailbox.take();
+		else if (liveInFlight.size > 0 && !(options.isIdle?.(snapshot) ?? false)) event = await mailbox.take();
+		else if (!liveEventConsumed && options.event !== void 0) {
+			event = options.event;
+			liveEventConsumed = true;
+		} else return {
+			status: "idle",
+			snapshot,
+			entries
+		};
+		const completedId = completionActorId(event);
+		if (completedId !== void 0) liveInFlight.delete(completedId);
+		if (!fromJournal) appendEntry(event);
+		[snapshot, effects] = execution.transition(snapshot, event);
+	}
+}
+//#endregion
 exports.AGENT_EVENT_SCHEMA_VERSION = require_event_log_store.AGENT_EVENT_SCHEMA_VERSION;
 exports.AGENT_INIT_EVENT_TYPE = require_setup_agent.AGENT_INIT_EVENT_TYPE;
 exports.AGENT_TRACE_SCHEMA_VERSION = AGENT_TRACE_SCHEMA_VERSION;
@@ -2890,6 +3082,7 @@ exports.renderDecisionAttempts = require_decision.renderDecisionAttempts;
 exports.replay = require_setup_agent.replay;
 exports.resolveDecision = require_decision.resolveDecision;
 exports.runAgent = runAgent;
+exports.runDurableAgent = runDurableAgent;
 exports.runSeam = runSeam;
 exports.serializeTraceEvent = serializeTraceEvent;
 Object.defineProperty(exports, "setupAgent", {

package/dist/index.d.cts

@@ -3,7 +3,7 @@ import { t as AgentError } from "./errors-BQRk9eiZ.cjs";
 import { A as AgentDecisionExecutor, B as AgentEventToolNameResolver, C as buildEnvelopeSchema, D as parseModelRef, E as getCallUsage, F as DecisionLogicConfig, G as parseAgentEvent, H as AgentRequestSource, I as ResolveDecisionOptions, L as renderDecisionAttempts, M as AgentDecisionInput, N as AgentDecisionRequest, O as parseOutput, P as DecisionAttempt, R as resolveDecision, S as bindRequestExecutor, T as getAgentOutputMode, U as AgentSchemas, V as AgentRequestOptions, W as getAcceptedEvents, _ 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 AgentDecisionExhaustedError, k as parseStructuredEnvelope, 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 AgentEventDescriptor } from "./text-logic-Cavva1W6.cjs";
 import { a as AgentLogVerification, c as assertAgentLogEntry, d as assertEventLogStoreConformance, i as AgentLogEntry, l as assertJsonSerializable, n as AgentEventLogConflictError, o as JsonValue, r as AgentEventLogStore, s as NonSerializableAgentEventError, t as AGENT_EVENT_SCHEMA_VERSION, u as createInMemoryEventLogStore } from "./event-log-store-Bz7HDBkE.cjs";
 import { A as AgentRequest, B as AgentReplayMachineMismatchError, C as getSnapshotNodes, D as serializeTraceEvent, E as runAgent, F as AgentEffect, G as ReplayResult, H as CreateReplayEntryOptions, I as AgentEffectDiff, J as getAgentEffects, K as createReplayEntry, L as AgentEventLogDiff, M as executeAgentRequest, N as AGENT_INIT_EVENT_TYPE, O as traceTransitions, P as AGENT_USAGE_EVENT_TYPE, R as AgentLogPatchOperation, S as generateResult, T as inspectTransitions, U as GetAgentEffectsOptions, V as AgentUsageEvent, W as ReplayOptions, X as replay, Y as initEntry, _ as PendingUserInput, a as AgentInputFrom, b as RunAgentResult, c as AgentRunMeta, d as AgentTraceEvent, f as AgentUserInputExecutor, g as JsonSerializableTraceEvent, h as InspectedActorRef, i as AgentIllegalResumeEventError, j as AgentStepRequest, k as AgentStateRequest, l as AgentSnapshotNode, m as GetSnapshotRequestsOptions, n as AgentActorSession, o as AgentMaxModelCallsExceededError, p as GenerateResult, q as diffEventLogs, r as AgentIdleError, s as AgentMessageInfo, t as AGENT_TRACE_SCHEMA_VERSION, u as AgentSnapshotVersionMismatchError, v as RunAgentErrorCause, w as getSnapshotRequests, x as createAgentActor, y as RunAgentOptions, z as AgentReplayDivergenceError } from "./run-agent--4bbms-D.cjs";
-import { AnyActorLogic, AnyMachineSnapshot, AnySetupConfig, AnyStateMachine, AsyncActorLogic, EventFromLogic, EventObject, InputFrom, MachineContext, MetaObject, NonReducibleUnknown, SetupReturnFromConfig, SetupStateSchema, SnapshotFrom, StateValue } from "xstate";
+import { AnyActorLogic, AnyMachineSnapshot, AnySetupConfig, AnyStateMachine, AsyncActorLogic, EventFromLogic, EventObject, InputFrom, MachineContext, MetaObject, NonReducibleUnknown, OutputFrom, SetupReturnFromConfig, SetupStateSchema, SnapshotFrom, StateValue } from "xstate";
 
 //#region src/messages.d.ts
 /**
@@ -1309,4 +1309,76 @@ interface RunSeamResult<TMachine extends AnyStateMachine> {
  */
 declare function runSeam<TMachine extends AnyStateMachine>(machine: TMachine, options: RunSeamOptions<TMachine>): Promise<RunSeamResult<TMachine>>;
 //#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 AgentInputFrom, type AgentLintDiagnostic, AgentLintError, type AgentLintSeverity, type AgentLogEntry, type AgentLogPatchOperation, type AgentLogVerification, AgentMaxModelCallsExceededError, 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 AgentSchemas, type AgentSnapshotNode, 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 AssistantMessage, type CanReachResult, type ChosenEvent, type CreateReplayEntryOptions, type DecisionAttempt, type DecisionLogicConfig, type ExplorePathsOptions, type FilePart, type FromConfigOptions, type FromConfigResult, type GenerateResult, type GetAgentEffectsOptions, type GetSnapshotRequestsOptions, type ImagePart, type InferInput, 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 ScriptedExecutors, type ScriptedExecutorsScript, type ScriptedTextEntry, type ScriptedUserInputEntry, 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, assertEventLogStoreConformance, assertJsonSerializable, assistantMessage, bindRequestExecutor, buildEnvelopeSchema, canReach, createAgentActor, createAgentRun, createAgentSchemas, createInMemoryEventLogStore, createReplayEntry, createScriptedExecutors, createTextLogic, diffEventLogs, executeAgentRequest, explorePaths, generateResult, getAcceptedEvents, getAgentEffects, getAgentMessages, getAgentOutputMode, getAgentSchemas, getCallUsage, getJsonSchema, getJsonSchemaSync, getMachineStructuralHash, getSnapshotNodes, getSnapshotRequests, getStateMeta, initEntry, inspectTransitions, isStandardSchema, lintAgentMachine, matchesTrajectory, messagesSchema, parseAgentEvent, parseModelRef, parseOutput, parseStructuredEnvelope, provideExecutors, renderDecisionAttempts, replay, resolveDecision, runAgent, runSeam, serializeTraceEvent, setupAgent, simulateAgent, systemMessage, toolMessage, traceTransitions, userMessage };
+//#region src/durable.d.ts
+/** Options for {@link runDurableAgent}. */
+interface RunDurableAgentOptions<TMachine extends AnyStateMachine> extends Pick<ProvideExecutorsOptions<TMachine>, "actors" | "onChunk" | "onTrace"> {
+  /** Machine input for a FRESH run (ignored when `entries` has an init entry). */
+  input?: InputFrom<TMachine>;
+  /**
+   * The journal to resume from — the `entries` a previous
+   * {@link runDurableAgent} result returned (or any replay-compatible
+   * {@link AgentLogEntry} log with a reserved `@agent.init` first entry).
+   */
+  entries?: readonly AgentLogEntry[];
+  /** One external event to feed after the journal is folded (a user reply, a timer). */
+  event?: EventFromLogic<TMachine>;
+  /** Host executors, bound with {@link provideExecutors} semantics. */
+  executors?: AgentRequestExecutors;
+  /** Called with each entry as it is appended, for incremental persistence. */
+  onEntry?: (entry: AgentLogEntry) => void;
+  /**
+   * Settle `idle` when this returns true for the current snapshot even though
+   * children are still pending — for machines whose wait states keep a
+   * never-resolving invoke in flight (e.g. an unbound `agent.userInput`).
+   */
+  isIdle?: (snapshot: SnapshotFrom<TMachine>) => boolean;
+  /** Explicit machine version for entry stamping; defaults to the structural hash. */
+  machineVersion?: string;
+  /**
+   * Record replay-verification hashes on appended entries. Off by default:
+   * hashing replays the whole prefix per entry, which is quadratic in log
+   * length.
+   */
+  verification?: boolean;
+}
+/** The settled result of a {@link runDurableAgent} call. */
+type DurableAgentResult<TMachine extends AnyStateMachine> = {
+  /** The machine reached a final state. */status: "done";
+  output: OutputFrom<TMachine>;
+  snapshot: SnapshotFrom<TMachine>; /** The complete journal; replaying it reproduces this run. */
+  entries: AgentLogEntry[];
+} | {
+  /** The machine is waiting for an external event. Persist `entries`; resume with them plus `event`. */status: "idle";
+  snapshot: SnapshotFrom<TMachine>;
+  entries: AgentLogEntry[];
+};
+/**
+ * Runs an agent machine as a durable execution: journal in, journal out.
+ *
+ * A fresh call starts from `input` and appends a reserved init entry; a
+ * resume call folds `entries` through pure transitions first — invokes whose
+ * completions are journaled are suppressed (their recorded results replay
+ * instead of re-executing), while work that was in flight at the crash
+ * re-executes live. After the journal, an optional `options.event` is
+ * delivered. The call settles:
+ *
+ * - `done` when the machine reaches a final state, with `output`;
+ * - `idle` when the frontier needs an external event the host has not
+ *   supplied (no live work pending, or `isIdle` says the pending work is a
+ *   human wait). Persist `entries` and call again with them later.
+ *
+ * ```ts
+ * const first = await runDurableAgent(machine, { input, executors });
+ * // ... persist first.entries; later, in a new process:
+ * const next = await runDurableAgent(machine, {
+ *   entries: first.entries,
+ *   event: { type: "APPROVE" },
+ *   executors,
+ * });
+ * ```
+ *
+ * @experimental Built on xstate's experimental `xstate/durable` entrypoint.
+ */
+declare function runDurableAgent<TMachine extends AnyStateMachine>(machine: TMachine, options?: RunDurableAgentOptions<TMachine>): Promise<DurableAgentResult<TMachine>>;
+//#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 AgentInputFrom, type AgentLintDiagnostic, AgentLintError, type AgentLintSeverity, type AgentLogEntry, type AgentLogPatchOperation, type AgentLogVerification, AgentMaxModelCallsExceededError, 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 AgentSchemas, type AgentSnapshotNode, 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 AssistantMessage, type CanReachResult, type ChosenEvent, type CreateReplayEntryOptions, type DecisionAttempt, type DecisionLogicConfig, type DurableAgentResult, type ExplorePathsOptions, type FilePart, type FromConfigOptions, type FromConfigResult, type GenerateResult, type GetAgentEffectsOptions, type GetSnapshotRequestsOptions, type ImagePart, type InferInput, 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 RunDurableAgentOptions, type RunSeamOptions, type RunSeamResult, type SchemaCompiler, type ScriptedDecisionEntry, type ScriptedDecisionValue, type ScriptedExecutors, type ScriptedExecutorsScript, type ScriptedTextEntry, type ScriptedUserInputEntry, 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, assertEventLogStoreConformance, assertJsonSerializable, assistantMessage, bindRequestExecutor, buildEnvelopeSchema, canReach, createAgentActor, createAgentRun, createAgentSchemas, createInMemoryEventLogStore, createReplayEntry, createScriptedExecutors, createTextLogic, diffEventLogs, executeAgentRequest, explorePaths, generateResult, getAcceptedEvents, getAgentEffects, getAgentMessages, getAgentOutputMode, getAgentSchemas, getCallUsage, getJsonSchema, getJsonSchemaSync, getMachineStructuralHash, getSnapshotNodes, getSnapshotRequests, getStateMeta, initEntry, inspectTransitions, isStandardSchema, lintAgentMachine, matchesTrajectory, messagesSchema, parseAgentEvent, parseModelRef, parseOutput, parseStructuredEnvelope, provideExecutors, renderDecisionAttempts, replay, resolveDecision, runAgent, runDurableAgent, runSeam, serializeTraceEvent, setupAgent, simulateAgent, systemMessage, toolMessage, traceTransitions, userMessage };

package/dist/index.d.mts

@@ -3,7 +3,7 @@ import { t as AgentError } from "./errors-C9rxnWbX.mjs";
 import { A as AgentDecisionExecutor, B as AgentEventToolNameResolver, C as buildEnvelopeSchema, D as parseModelRef, E as getCallUsage, F as DecisionLogicConfig, G as parseAgentEvent, H as AgentRequestSource, I as ResolveDecisionOptions, L as renderDecisionAttempts, M as AgentDecisionInput, N as AgentDecisionRequest, O as parseOutput, P as DecisionAttempt, R as resolveDecision, S as bindRequestExecutor, T as getAgentOutputMode, U as AgentSchemas, V as AgentRequestOptions, W as getAcceptedEvents, _ 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 AgentDecisionExhaustedError, k as parseStructuredEnvelope, 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 AgentEventDescriptor } from "./text-logic-Er5KkTX6.mjs";
 import { a as AgentLogVerification, c as assertAgentLogEntry, d as assertEventLogStoreConformance, i as AgentLogEntry, l as assertJsonSerializable, n as AgentEventLogConflictError, o as JsonValue, r as AgentEventLogStore, s as NonSerializableAgentEventError, t as AGENT_EVENT_SCHEMA_VERSION, u as createInMemoryEventLogStore } from "./event-log-store-hrA1vqtN.mjs";
 import { A as AgentRequest, B as AgentReplayMachineMismatchError, C as getSnapshotNodes, D as serializeTraceEvent, E as runAgent, F as AgentEffect, G as ReplayResult, H as CreateReplayEntryOptions, I as AgentEffectDiff, J as getAgentEffects, K as createReplayEntry, L as AgentEventLogDiff, M as executeAgentRequest, N as AGENT_INIT_EVENT_TYPE, O as traceTransitions, P as AGENT_USAGE_EVENT_TYPE, R as AgentLogPatchOperation, S as generateResult, T as inspectTransitions, U as GetAgentEffectsOptions, V as AgentUsageEvent, W as ReplayOptions, X as replay, Y as initEntry, _ as PendingUserInput, a as AgentInputFrom, b as RunAgentResult, c as AgentRunMeta, d as AgentTraceEvent, f as AgentUserInputExecutor, g as JsonSerializableTraceEvent, h as InspectedActorRef, i as AgentIllegalResumeEventError, j as AgentStepRequest, k as AgentStateRequest, l as AgentSnapshotNode, m as GetSnapshotRequestsOptions, n as AgentActorSession, o as AgentMaxModelCallsExceededError, p as GenerateResult, q as diffEventLogs, r as AgentIdleError, s as AgentMessageInfo, t as AGENT_TRACE_SCHEMA_VERSION, u as AgentSnapshotVersionMismatchError, v as RunAgentErrorCause, w as getSnapshotRequests, x as createAgentActor, y as RunAgentOptions, z as AgentReplayDivergenceError } from "./run-agent-CwmzAZwj.mjs";
-import { AnyActorLogic, AnyMachineSnapshot, AnySetupConfig, AnyStateMachine, AsyncActorLogic, EventFromLogic, EventObject, InputFrom, MachineContext, MetaObject, NonReducibleUnknown, SetupReturnFromConfig, SetupStateSchema, SnapshotFrom, StateValue } from "xstate";
+import { AnyActorLogic, AnyMachineSnapshot, AnySetupConfig, AnyStateMachine, AsyncActorLogic, EventFromLogic, EventObject, InputFrom, MachineContext, MetaObject, NonReducibleUnknown, OutputFrom, SetupReturnFromConfig, SetupStateSchema, SnapshotFrom, StateValue } from "xstate";
 
 //#region src/messages.d.ts
 /**
@@ -1309,4 +1309,76 @@ interface RunSeamResult<TMachine extends AnyStateMachine> {
  */
 declare function runSeam<TMachine extends AnyStateMachine>(machine: TMachine, options: RunSeamOptions<TMachine>): Promise<RunSeamResult<TMachine>>;
 //#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 AgentInputFrom, type AgentLintDiagnostic, AgentLintError, type AgentLintSeverity, type AgentLogEntry, type AgentLogPatchOperation, type AgentLogVerification, AgentMaxModelCallsExceededError, 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 AgentSchemas, type AgentSnapshotNode, 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 AssistantMessage, type CanReachResult, type ChosenEvent, type CreateReplayEntryOptions, type DecisionAttempt, type DecisionLogicConfig, type ExplorePathsOptions, type FilePart, type FromConfigOptions, type FromConfigResult, type GenerateResult, type GetAgentEffectsOptions, type GetSnapshotRequestsOptions, type ImagePart, type InferInput, 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 ScriptedExecutors, type ScriptedExecutorsScript, type ScriptedTextEntry, type ScriptedUserInputEntry, 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, assertEventLogStoreConformance, assertJsonSerializable, assistantMessage, bindRequestExecutor, buildEnvelopeSchema, canReach, createAgentActor, createAgentRun, createAgentSchemas, createInMemoryEventLogStore, createReplayEntry, createScriptedExecutors, createTextLogic, diffEventLogs, executeAgentRequest, explorePaths, generateResult, getAcceptedEvents, getAgentEffects, getAgentMessages, getAgentOutputMode, getAgentSchemas, getCallUsage, getJsonSchema, getJsonSchemaSync, getMachineStructuralHash, getSnapshotNodes, getSnapshotRequests, getStateMeta, initEntry, inspectTransitions, isStandardSchema, lintAgentMachine, matchesTrajectory, messagesSchema, parseAgentEvent, parseModelRef, parseOutput, parseStructuredEnvelope, provideExecutors, renderDecisionAttempts, replay, resolveDecision, runAgent, runSeam, serializeTraceEvent, setupAgent, simulateAgent, systemMessage, toolMessage, traceTransitions, userMessage };
+//#region src/durable.d.ts
+/** Options for {@link runDurableAgent}. */
+interface RunDurableAgentOptions<TMachine extends AnyStateMachine> extends Pick<ProvideExecutorsOptions<TMachine>, "actors" | "onChunk" | "onTrace"> {
+  /** Machine input for a FRESH run (ignored when `entries` has an init entry). */
+  input?: InputFrom<TMachine>;
+  /**
+   * The journal to resume from — the `entries` a previous
+   * {@link runDurableAgent} result returned (or any replay-compatible
+   * {@link AgentLogEntry} log with a reserved `@agent.init` first entry).
+   */
+  entries?: readonly AgentLogEntry[];
+  /** One external event to feed after the journal is folded (a user reply, a timer). */
+  event?: EventFromLogic<TMachine>;
+  /** Host executors, bound with {@link provideExecutors} semantics. */
+  executors?: AgentRequestExecutors;
+  /** Called with each entry as it is appended, for incremental persistence. */
+  onEntry?: (entry: AgentLogEntry) => void;
+  /**
+   * Settle `idle` when this returns true for the current snapshot even though
+   * children are still pending — for machines whose wait states keep a
+   * never-resolving invoke in flight (e.g. an unbound `agent.userInput`).
+   */
+  isIdle?: (snapshot: SnapshotFrom<TMachine>) => boolean;
+  /** Explicit machine version for entry stamping; defaults to the structural hash. */
+  machineVersion?: string;
+  /**
+   * Record replay-verification hashes on appended entries. Off by default:
+   * hashing replays the whole prefix per entry, which is quadratic in log
+   * length.
+   */
+  verification?: boolean;
+}
+/** The settled result of a {@link runDurableAgent} call. */
+type DurableAgentResult<TMachine extends AnyStateMachine> = {
+  /** The machine reached a final state. */status: "done";
+  output: OutputFrom<TMachine>;
+  snapshot: SnapshotFrom<TMachine>; /** The complete journal; replaying it reproduces this run. */
+  entries: AgentLogEntry[];
+} | {
+  /** The machine is waiting for an external event. Persist `entries`; resume with them plus `event`. */status: "idle";
+  snapshot: SnapshotFrom<TMachine>;
+  entries: AgentLogEntry[];
+};
+/**
+ * Runs an agent machine as a durable execution: journal in, journal out.
+ *
+ * A fresh call starts from `input` and appends a reserved init entry; a
+ * resume call folds `entries` through pure transitions first — invokes whose
+ * completions are journaled are suppressed (their recorded results replay
+ * instead of re-executing), while work that was in flight at the crash
+ * re-executes live. After the journal, an optional `options.event` is
+ * delivered. The call settles:
+ *
+ * - `done` when the machine reaches a final state, with `output`;
+ * - `idle` when the frontier needs an external event the host has not
+ *   supplied (no live work pending, or `isIdle` says the pending work is a
+ *   human wait). Persist `entries` and call again with them later.
+ *
+ * ```ts
+ * const first = await runDurableAgent(machine, { input, executors });
+ * // ... persist first.entries; later, in a new process:
+ * const next = await runDurableAgent(machine, {
+ *   entries: first.entries,
+ *   event: { type: "APPROVE" },
+ *   executors,
+ * });
+ * ```
+ *
+ * @experimental Built on xstate's experimental `xstate/durable` entrypoint.
+ */
+declare function runDurableAgent<TMachine extends AnyStateMachine>(machine: TMachine, options?: RunDurableAgentOptions<TMachine>): Promise<DurableAgentResult<TMachine>>;
+//#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 AgentInputFrom, type AgentLintDiagnostic, AgentLintError, type AgentLintSeverity, type AgentLogEntry, type AgentLogPatchOperation, type AgentLogVerification, AgentMaxModelCallsExceededError, 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 AgentSchemas, type AgentSnapshotNode, 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 AssistantMessage, type CanReachResult, type ChosenEvent, type CreateReplayEntryOptions, type DecisionAttempt, type DecisionLogicConfig, type DurableAgentResult, type ExplorePathsOptions, type FilePart, type FromConfigOptions, type FromConfigResult, type GenerateResult, type GetAgentEffectsOptions, type GetSnapshotRequestsOptions, type ImagePart, type InferInput, 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 RunDurableAgentOptions, type RunSeamOptions, type RunSeamResult, type SchemaCompiler, type ScriptedDecisionEntry, type ScriptedDecisionValue, type ScriptedExecutors, type ScriptedExecutorsScript, type ScriptedTextEntry, type ScriptedUserInputEntry, 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, assertEventLogStoreConformance, assertJsonSerializable, assistantMessage, bindRequestExecutor, buildEnvelopeSchema, canReach, createAgentActor, createAgentRun, createAgentSchemas, createInMemoryEventLogStore, createReplayEntry, createScriptedExecutors, createTextLogic, diffEventLogs, executeAgentRequest, explorePaths, generateResult, getAcceptedEvents, getAgentEffects, getAgentMessages, getAgentOutputMode, getAgentSchemas, getCallUsage, getJsonSchema, getJsonSchemaSync, getMachineStructuralHash, getSnapshotNodes, getSnapshotRequests, getStateMeta, initEntry, inspectTransitions, isStandardSchema, lintAgentMachine, matchesTrajectory, messagesSchema, parseAgentEvent, parseModelRef, parseOutput, parseStructuredEnvelope, provideExecutors, renderDecisionAttempts, replay, resolveDecision, runAgent, runDurableAgent, runSeam, serializeTraceEvent, setupAgent, simulateAgent, systemMessage, toolMessage, traceTransitions, userMessage };

package/dist/index.mjs

@@ -1,8 +1,9 @@
 import { t as AgentError } from "./errors-CeSXQx0v.mjs";
-import { _ as resolveAgentStep, a as AGENT_USAGE_EVENT_TYPE, b as messagesSchema, c as createReplayEntry, d as initEntry, f as replay, g as initialAgentStep, h as getInvokeEffectMetadata, i as AGENT_INIT_EVENT_TYPE, l as diffEventLogs, m as executeAgentRequest, n as getAgentSchemas, o as AgentReplayDivergenceError, p as validateReplayEntries, r as setupAgent, s as AgentReplayMachineMismatchError, t as createAgentSchemas, u as getAgentEffects, v as transitionAgentStep, y as appendMessages } from "./setup-agent-CPFPN06s.mjs";
-import { A as isUnboundPlaceholder, B as getMachineStructuralHash, C as parseStructuredEnvelope, D as getMachineIdlePredicate, E as executorBoundLogics, G as toolMessage, H as isStandardSchema, I as findNonSerializableContextPaths, K as userMessage, L as getAgentMessages, O as getMachineStaticTransitionTargets, P as assistantMessage, R as getJsonSchema, S as parseOutput, U as resolveMachineVersion, V as getStateMeta, W as systemMessage, _ as getAgentOutputMode, 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, q as validateSchemaSync, r as isDecisionLogic, s as parseAgentEvent, t as AgentDecisionExhaustedError, u as INTERPRET_SOURCE, v as getCallUsage, x as parseModelRef, y as isTextLogic, z as getJsonSchemaSync } from "./decision-DsIkEuHz.mjs";
+import { _ as initialAgentStep, a as AGENT_USAGE_EVENT_TYPE, b as appendMessages, c as createReplayEntry, d as initEntry, f as rebindActorSession, g as getInvokeEffectMetadata, h as executeAgentRequest, i as AGENT_INIT_EVENT_TYPE, l as diffEventLogs, m as validateReplayEntries, n as getAgentSchemas, o as AgentReplayDivergenceError, p as replay, r as setupAgent, s as AgentReplayMachineMismatchError, t as createAgentSchemas, u as getAgentEffects, v as resolveAgentStep, x as messagesSchema, y as transitionAgentStep } from "./setup-agent-BOcSpsIq.mjs";
+import { A as isUnboundPlaceholder, B as getMachineStructuralHash, C as parseStructuredEnvelope, D as getMachineIdlePredicate, E as executorBoundLogics, G as toolMessage, H as isStandardSchema, I as findNonSerializableContextPaths, K as userMessage, L as getAgentMessages, O as getMachineStaticTransitionTargets, P as assistantMessage, R as getJsonSchema, S as parseOutput, U as resolveMachineVersion, V as getStateMeta, W as systemMessage, _ as getAgentOutputMode, 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, q as validateSchemaSync, r as isDecisionLogic, s as parseAgentEvent, t as AgentDecisionExhaustedError, u as INTERPRET_SOURCE, v as getCallUsage, x as parseModelRef, y as isTextLogic, z as getJsonSchemaSync } from "./decision-BfhSgCc6.mjs";
 import { a as assertJsonSerializable, i as assertAgentLogEntry, n as AgentEventLogConflictError, o as createInMemoryEventLogStore, r as NonSerializableAgentEventError, s as assertEventLogStoreConformance, t as AGENT_EVENT_SCHEMA_VERSION } from "./event-log-store-DmIDosD6.mjs";
-import { createActor, createAsyncLogic, getNextTransitions, isMachineSnapshot } from "xstate";
+import { createActor, createAsyncLogic, deliverEvent, getNextTransitions, isMachineSnapshot } from "xstate";
+import { createDurable } from "xstate/durable";
 //#region src/internal/state-request-pass.ts
 async function runTextPhase(stateRequest, baseMessages, deps) {
 	const { model, system } = stateRequest;
@@ -284,7 +285,7 @@ function serializeTraceEvent(event, options = {}) {
 	return out;
 }
 function snapshotNodes(snapshot) {
-	return (snapshot._nodes ?? []).map((raw) => {
+	return (snapshot.nodes ?? []).map((raw) => {
 		const node = raw;
 		return {
 			id: node.id ?? "",
@@ -1159,6 +1160,7 @@ function createAgentSession(machine, options, lifecycle) {
 		const aligned = Object.assign(Object.create(Object.getPrototypeOf(effectiveSnapshot)), effectiveSnapshot);
 		if (machineOwnVersion === void 0) delete aligned.version;
 		else aligned.version = machineOwnVersion;
+		delete aligned.machine;
 		effectiveSnapshot = aligned;
 	}
 	const priorMessages = getAgentMessages(effectiveSnapshot);
@@ -2827,4 +2829,194 @@ 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, AgentMaxModelCallsExceededError, AgentReplayDivergenceError, AgentReplayMachineMismatchError, AgentSnapshotVersionMismatchError, NonSerializableAgentEventError, appendMessages, assertAgentLogEntry, assertEventLogStoreConformance, assertJsonSerializable, assistantMessage, bindRequestExecutor, buildEnvelopeSchema, canReach, createAgentActor, createAgentRun, createAgentSchemas, createInMemoryEventLogStore, createReplayEntry, createScriptedExecutors, createTextLogic, diffEventLogs, executeAgentRequest, explorePaths, generateResult, getAcceptedEvents, getAgentEffects, getAgentMessages, getAgentOutputMode, getAgentSchemas, getCallUsage, getJsonSchema, getJsonSchemaSync, getMachineStructuralHash, getSnapshotNodes, getSnapshotRequests, getStateMeta, initEntry, inspectTransitions, isStandardSchema, lintAgentMachine, matchesTrajectory, messagesSchema, parseAgentEvent, parseModelRef, parseOutput, parseStructuredEnvelope, provideExecutors, renderDecisionAttempts, replay, resolveDecision, runAgent, runSeam, serializeTraceEvent, setupAgent, simulateAgent, systemMessage, toolMessage, traceTransitions, userMessage };
+//#region src/durable.ts
+/**
+* The durable host runner: {@link runDurableAgent} drives an executor-bound
+* agent machine on xstate's `createDurable` execution (`xstate/durable`),
+* with the agent event log as the journal.
+*
+* Where {@link replay} + `getAgentEffects` hand a host an effect list to run
+* itself, `runDurableAgent` owns the whole loop on the durable runtime:
+* invoked actors execute live through xstate's own runtime, every EXTERNAL
+* event (invoke completions included) is appended to the log, and a resume
+* folds the log back through pure transitions — an invoke whose completion is
+* already journaled is never re-started, so recorded model calls are never
+* re-executed. Crash recovery re-runs only the work that was still in flight.
+*
+* @module
+*/
+const DONE_ACTOR_EVENT_TYPE = "xstate.done.actor";
+const ERROR_ACTOR_EVENT_TYPE = "xstate.error.actor";
+function completionActorId(event) {
+	if (event.type !== DONE_ACTOR_EVENT_TYPE && event.type !== ERROR_ACTOR_EVENT_TYPE) return;
+	const actorId = event.actorId;
+	return typeof actorId === "string" ? actorId : void 0;
+}
+function createMailbox() {
+	const queue = [];
+	const waiters = [];
+	return {
+		push(event) {
+			const waiter = waiters.shift();
+			if (waiter) waiter(event);
+			else queue.push(event);
+		},
+		take() {
+			const next = queue.shift();
+			if (next !== void 0) return Promise.resolve(next);
+			return new Promise((resolve) => waiters.push(resolve));
+		},
+		size: () => queue.length
+	};
+}
+/**
+* Runs an agent machine as a durable execution: journal in, journal out.
+*
+* A fresh call starts from `input` and appends a reserved init entry; a
+* resume call folds `entries` through pure transitions first — invokes whose
+* completions are journaled are suppressed (their recorded results replay
+* instead of re-executing), while work that was in flight at the crash
+* re-executes live. After the journal, an optional `options.event` is
+* delivered. The call settles:
+*
+* - `done` when the machine reaches a final state, with `output`;
+* - `idle` when the frontier needs an external event the host has not
+*   supplied (no live work pending, or `isIdle` says the pending work is a
+*   human wait). Persist `entries` and call again with them later.
+*
+* ```ts
+* const first = await runDurableAgent(machine, { input, executors });
+* // ... persist first.entries; later, in a new process:
+* const next = await runDurableAgent(machine, {
+*   entries: first.entries,
+*   event: { type: "APPROVE" },
+*   executors,
+* });
+* ```
+*
+* @experimental Built on xstate's experimental `xstate/durable` entrypoint.
+*/
+async function runDurableAgent(machine, options = {}) {
+	const bound = options.executors ? provideExecutors(machine, options.executors, {
+		actors: options.actors,
+		onChunk: options.onChunk,
+		onTrace: options.onTrace
+	}) : options.actors ? machine.provide({ actors: options.actors }) : machine;
+	const machineId = machine.config.id ?? machine.id ?? "(machine)";
+	const machineVersion = options.machineVersion ?? resolveMachineVersion(machine);
+	const priorEntries = options.entries ?? [];
+	if (priorEntries.length > 0) validateReplayEntries(priorEntries, {
+		machineId,
+		machineVersion
+	}, "Durable journal entries");
+	const hasInit = priorEntries[0]?.event.type === AGENT_INIT_EVENT_TYPE;
+	const input = hasInit ? priorEntries[0].event.input : options.input;
+	const journal = priorEntries.slice(hasInit ? 1 : 0).map((entry) => entry.event);
+	const journaledCompletions = /* @__PURE__ */ new Map();
+	for (const event of journal) {
+		const actorId = completionActorId(event);
+		if (actorId !== void 0) journaledCompletions.set(actorId, (journaledCompletions.get(actorId) ?? 0) + 1);
+	}
+	const mailbox = createMailbox();
+	const rootAddress = machineId;
+	const suppressedChildren = /* @__PURE__ */ new WeakSet();
+	const startsSeen = /* @__PURE__ */ new Map();
+	const liveInFlight = /* @__PURE__ */ new Set();
+	const findChildRef = (effect) => {
+		const raw = effect;
+		const candidates = [raw.actor, ...Array.isArray(raw.args) ? raw.args : []];
+		for (const candidate of candidates) {
+			const ref = candidate;
+			if (ref && typeof ref.sessionId === "string" && typeof ref.id === "string") return ref;
+		}
+	};
+	let replaying = journal.length > 0;
+	const execution = createDurable(bound, {
+		sendEvent(source, target, event) {
+			if (target.address === rootAddress) {
+				mailbox.push(event);
+				return;
+			}
+			deliverEvent(source, target, event);
+		},
+		runtime(_metadata, effect) {
+			const type = effect.type;
+			if (type === "@xstate.spawn" || type === "@xstate.start") {
+				const child = findChildRef(effect);
+				if (!child) return {};
+				if (type === "@xstate.spawn") {
+					const seen = (startsSeen.get(child.id) ?? 0) + 1;
+					startsSeen.set(child.id, seen);
+					if (seen <= (journaledCompletions.get(child.id) ?? 0)) suppressedChildren.add(child);
+					else liveInFlight.add(child.id);
+				}
+				if (suppressedChildren.has(child)) return {
+					spawnActor() {},
+					startActor() {}
+				};
+			}
+			return {};
+		},
+		executeAction(action) {
+			if (replaying) return;
+			action.exec?.();
+		},
+		waitForEvent() {
+			return mailbox.take();
+		}
+	});
+	const entries = [...priorEntries];
+	const entryOptions = {
+		machineVersion,
+		verification: options.verification ?? false
+	};
+	const appendEntry = (event) => {
+		const entry = createReplayEntry(machine, entries, event, entryOptions);
+		entries.push(entry);
+		options.onEntry?.(entry);
+	};
+	if (!hasInit) {
+		const entry = initEntry(machine, input, entryOptions);
+		entries.push(entry);
+		options.onEntry?.(entry);
+	}
+	const sessions = /* @__PURE__ */ new Map();
+	let journalIndex = 0;
+	let liveEventConsumed = false;
+	let [snapshot, effects] = execution.initialTransition(input);
+	for (;;) {
+		const captured = await execution.executeEffects(effects);
+		for (const rootEvent of captured) mailbox.push(rootEvent.event);
+		const machineSnapshot = snapshot;
+		if (machineSnapshot.status === "done") return {
+			status: "done",
+			output: machineSnapshot.output,
+			snapshot,
+			entries
+		};
+		if (machineSnapshot.status === "error") throw machineSnapshot.error;
+		let event;
+		let fromJournal = false;
+		if (journalIndex < journal.length) {
+			event = rebindActorSession(journal[journalIndex], machineSnapshot, sessions);
+			journalIndex++;
+			fromJournal = true;
+			replaying = journalIndex < journal.length;
+		} else if (mailbox.size() > 0) event = await mailbox.take();
+		else if (liveInFlight.size > 0 && !(options.isIdle?.(snapshot) ?? false)) event = await mailbox.take();
+		else if (!liveEventConsumed && options.event !== void 0) {
+			event = options.event;
+			liveEventConsumed = true;
+		} else return {
+			status: "idle",
+			snapshot,
+			entries
+		};
+		const completedId = completionActorId(event);
+		if (completedId !== void 0) liveInFlight.delete(completedId);
+		if (!fromJournal) appendEntry(event);
+		[snapshot, effects] = execution.transition(snapshot, event);
+	}
+}
+//#endregion
+export { AGENT_EVENT_SCHEMA_VERSION, AGENT_INIT_EVENT_TYPE, AGENT_TRACE_SCHEMA_VERSION, AGENT_USAGE_EVENT_TYPE, AgentDecisionExhaustedError, AgentError, AgentEventLogConflictError, AgentIdleError, AgentIllegalResumeEventError, AgentLintError, AgentMaxModelCallsExceededError, AgentReplayDivergenceError, AgentReplayMachineMismatchError, AgentSnapshotVersionMismatchError, NonSerializableAgentEventError, appendMessages, assertAgentLogEntry, assertEventLogStoreConformance, assertJsonSerializable, assistantMessage, bindRequestExecutor, buildEnvelopeSchema, canReach, createAgentActor, createAgentRun, createAgentSchemas, createInMemoryEventLogStore, createReplayEntry, createScriptedExecutors, createTextLogic, diffEventLogs, executeAgentRequest, explorePaths, generateResult, getAcceptedEvents, getAgentEffects, getAgentMessages, getAgentOutputMode, getAgentSchemas, getCallUsage, getJsonSchema, getJsonSchemaSync, getMachineStructuralHash, getSnapshotNodes, getSnapshotRequests, getStateMeta, initEntry, inspectTransitions, isStandardSchema, lintAgentMachine, matchesTrajectory, messagesSchema, parseAgentEvent, parseModelRef, parseOutput, parseStructuredEnvelope, provideExecutors, renderDecisionAttempts, replay, resolveDecision, runAgent, runDurableAgent, runSeam, serializeTraceEvent, setupAgent, simulateAgent, systemMessage, toolMessage, traceTransitions, userMessage };

package/dist/machines.cjs

@@ -1,5 +1,5 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
-const require_setup_agent = require("./setup-agent-BFA4VKpN.cjs");
+const require_setup_agent = require("./setup-agent-gISRLxRe.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.mjs

@@ -1,4 +1,4 @@
-import { r as setupAgent } from "./setup-agent-CPFPN06s.mjs";
+import { r as setupAgent } from "./setup-agent-BOcSpsIq.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/{setup-agent-CPFPN06s.mjs → setup-agent-BOcSpsIq.mjs}

@@ -1,5 +1,5 @@
 import { t as AgentError } from "./errors-CeSXQx0v.mjs";
-import { F as djb2Hex, M as machineStaticTransitionTargets, N as missingActor, T as agentExecutionOptions, U as resolveMachineVersion, d as USER_INPUT_ACTOR, g as executeAgentTextRequest, h as createTextLogic, j as machineIdlePredicates, k as getRegisteredAgentExecutionOptions, l as DECIDE_ACTOR, m as builtinTextActors, n as createDecideActor, o as getAcceptedEvents, q as validateSchemaSync, r as isDecisionLogic, w as userInputActor, y as isTextLogic } from "./decision-DsIkEuHz.mjs";
+import { F as djb2Hex, M as machineStaticTransitionTargets, N as missingActor, T as agentExecutionOptions, U as resolveMachineVersion, d as USER_INPUT_ACTOR, g as executeAgentTextRequest, h as createTextLogic, j as machineIdlePredicates, k as getRegisteredAgentExecutionOptions, l as DECIDE_ACTOR, m as builtinTextActors, n as createDecideActor, o as getAcceptedEvents, q as validateSchemaSync, r as isDecisionLogic, w as userInputActor, y as isTextLogic } from "./decision-BfhSgCc6.mjs";
 import { a as assertJsonSerializable, i as assertAgentLogEntry } from "./event-log-store-DmIDosD6.mjs";
 import { createMachineFromConfig, initialTransition, setup, transition } from "xstate";
 //#region src/messages.ts
@@ -373,6 +373,13 @@ function toEvents(history) {
 		return candidate && typeof candidate === "object" && "event" in candidate && candidate.event ? candidate.event : entry;
 	});
 }
+/**
+* Rewrites a journaled actor event's per-incarnation `sessionId` to the
+* current snapshot's child for the same stable `actorId`, so replayed
+* completions match freshly restored children.
+*
+* @internal
+*/
 function rebindActorSession(event, snapshot, sessions) {
 	const actorEvent = event;
 	if (typeof actorEvent.actorId !== "string" || typeof actorEvent.sessionId !== "string") return event;
@@ -1518,4 +1525,4 @@ function createAgentActors(actors, requestActors) {
 	};
 }
 //#endregion
-export { resolveAgentStep as _, AGENT_USAGE_EVENT_TYPE as a, messagesSchema as b, createReplayEntry as c, initEntry as d, replay as f, initialAgentStep as g, getInvokeEffectMetadata as h, AGENT_INIT_EVENT_TYPE as i, diffEventLogs as l, executeAgentRequest as m, getAgentSchemas as n, AgentReplayDivergenceError as o, validateReplayEntries as p, setupAgent as r, AgentReplayMachineMismatchError as s, createAgentSchemas as t, getAgentEffects as u, transitionAgentStep as v, appendMessages as y };
+export { initialAgentStep as _, AGENT_USAGE_EVENT_TYPE as a, appendMessages as b, createReplayEntry as c, initEntry as d, rebindActorSession as f, getInvokeEffectMetadata as g, executeAgentRequest as h, AGENT_INIT_EVENT_TYPE as i, diffEventLogs as l, validateReplayEntries as m, getAgentSchemas as n, AgentReplayDivergenceError as o, replay as p, setupAgent as r, AgentReplayMachineMismatchError as s, createAgentSchemas as t, getAgentEffects as u, resolveAgentStep as v, messagesSchema as x, transitionAgentStep as y };

package/dist/{setup-agent-BFA4VKpN.cjs → setup-agent-gISRLxRe.cjs}

@@ -1,5 +1,5 @@
 const require_errors = require("./errors-DUBBzRLP.cjs");
-const require_decision = require("./decision-t26zsnSR.cjs");
+const require_decision = require("./decision-DhsKLYAI.cjs");
 const require_event_log_store = require("./event-log-store-a_TKy1gk.cjs");
 require("./validate.cjs");
 let xstate = require("xstate");
@@ -374,6 +374,13 @@ function toEvents(history) {
 		return candidate && typeof candidate === "object" && "event" in candidate && candidate.event ? candidate.event : entry;
 	});
 }
+/**
+* Rewrites a journaled actor event's per-incarnation `sessionId` to the
+* current snapshot's child for the same stable `actorId`, so replayed
+* completions match freshly restored children.
+*
+* @internal
+*/
 function rebindActorSession(event, snapshot, sessions) {
 	const actorEvent = event;
 	if (typeof actorEvent.actorId !== "string" || typeof actorEvent.sessionId !== "string") return event;
@@ -1609,6 +1616,12 @@ Object.defineProperty(exports, "messagesSchema", {
 		return messagesSchema;
 	}
 });
+Object.defineProperty(exports, "rebindActorSession", {
+	enumerable: true,
+	get: function() {
+		return rebindActorSession;
+	}
+});
 Object.defineProperty(exports, "replay", {
 	enumerable: true,
 	get: function() {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@statelyai/agent",
-  "version": "2.0.0-alpha.19",
+  "version": "2.0.0-alpha.20",
   "description": "Make invalid agent actions impossible. Agent logic as state machines: deterministic, inspectable, resumable, runs anywhere.",
   "keywords": [
     "agent",
@@ -131,14 +131,14 @@
     "typescript": "^5.6.2",
     "valibot": "^1.4.2",
     "vitest": "^3.2.6",
-    "xstate": "6.0.0-alpha.25",
+    "xstate": "6.0.0-alpha.41",
     "zod": "^4.3.6"
   },
   "peerDependencies": {
     "@opentelemetry/api": "^1",
     "ai": "^6.0.67",
     "ajv": "^8.20.0",
-    "xstate": ">=6.0.0-alpha.25 <6.0.0"
+    "xstate": ">=6.0.0-alpha.41 <6.0.0"
   },
   "peerDependenciesMeta": {
     "@opentelemetry/api": {