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

package/dist/{setup-agent-DP95MFrI.cjs → setup-agent-CpK0ZRWV.cjs}

@@ -1,5 +1,5 @@
 const require_errors = require("./errors-DUBBzRLP.cjs");
-const require_decision = require("./decision-dWGhBh0P.cjs");
+const require_decision = require("./decision-C0cUKvNt.cjs");
 const require_event_log_store = require("./event-log-store-CNT_7F0V.cjs");
 let xstate = require("xstate");
 //#region src/messages.ts
@@ -117,7 +117,7 @@ function getInvokeEffectMetadata(action) {
 * @internal
 */
 function getAgentRequestsWith(actions, options = {}) {
-	return [...actions.flatMap((action) => {
+	return actions.flatMap((action) => {
 		const params = getInvokeEffectMetadata(action);
 		if (!params || typeof params.src !== "string") return [];
 		if (typeof params.id !== "string" || params.id.length === 0) throw new Error(`Agent invoke '${params.src}' must define a durable string id.`);
@@ -149,60 +149,7 @@ function getAgentRequestsWith(actions, options = {}) {
 			tools: input.tools ?? {},
 			events: []
 		}];
-	}), ...getActivePlanRequests(options)];
-}
-/**
-* Scans the live snapshot's children for active `agent.plan` (plan-logic)
-* invokes and lowers each into an {@link AgentPlanRequest} — the re-surfacing
-* half of plan discovery. Reads the applied-event trail and remaining budget
-* from the child's own ledger `context` ({@link PlanLedgerContext}), recomputes
-* the currently-legal candidates (∩ declared `allowedEvents`) plus the reserved
-* `agent.plan.done` move, and takes `stepsRemaining` from the ledger (falling
-* back to `maxSteps - applied.length` for a snapshot with no context yet).
-* Returns `[]` when no snapshot is available (candidates need a live snapshot).
-*
-* @internal
-*/
-function getActivePlanRequests(options) {
-	const snapshot = options.snapshot;
-	if (!snapshot) return [];
-	const children = snapshot.children;
-	if (!children) return [];
-	const requests = [];
-	for (const [id, child] of Object.entries(children)) {
-		const ref = child;
-		if (typeof ref?.getSnapshot !== "function") continue;
-		const src = typeof ref.src === "string" ? ref.src : void 0;
-		const logic = (src ? options.actors?.[src] : void 0) ?? ref.logic;
-		if (!require_decision.isPlanLogic(logic)) continue;
-		const childSnapshot = ref.getSnapshot();
-		if (childSnapshot?.status !== "active") continue;
-		const input = childSnapshot.input ?? {};
-		const maxSteps = input.maxSteps ?? 8;
-		const ledger = childSnapshot.context ?? {};
-		const applied = ledger.applied ?? [];
-		const stepsRemaining = ledger.stepsRemaining ?? maxSteps - applied.length;
-		const machineEvents = require_decision.getAcceptedEvents(snapshot, {
-			events: options.events,
-			schemas: options.schemas,
-			eventTypes: logic.allowedEventTypes(input) ?? void 0,
-			eventToolName: options.eventToolName
-		});
-		const events = machineEvents.some((event) => event.type === "agent.plan.done") ? machineEvents : [...machineEvents, {
-			type: require_decision.PLAN_DONE_EVENT_TYPE,
-			toolName: require_decision.sanitizeEventToolName(require_decision.PLAN_DONE_EVENT_TYPE)
-		}];
-		requests.push({
-			kind: "plan",
-			id,
-			src: src ?? "",
-			input,
-			events,
-			applied,
-			stepsRemaining: Math.max(0, stepsRemaining)
-		});
-	}
-	return requests;
+	});
 }
 /**
 * Builds the canonical `xstate.done.actor` event xstate's `transition()`
@@ -289,133 +236,11 @@ async function executeAgentRequest(requestOrEffect, executors, options) {
 		raw
 	} : normalizedOutput;
 }
-/**
-* Resolves the current step's pending requests and returns the next
-* {@link AgentStep} — one iteration of the durable step loop, collapsing the
-* manual `request.kind` dispatch a host would otherwise write by hand.
-*
-* For each pending request, in order: a `kind: 'text'` request is run with
-* {@link executeAgentRequest} then fed back via {@link resolveAgentStep}; a
-* `kind: 'decision'` request is resolved with `resolveDecision` (wiring
-* `canTake` to `step.snapshot.can` so guard-rejected choices retry) then
-* applied with {@link transitionAgentStep}. The **current** step is re-read
-* after each application — the machine may advance and its `requests` change —
-* so this always resolves against the live step, never a stale list.
-*
-* A `kind: 'plan'` request (`agent.plan`) is resolved natively too: one plan
-* step per call. It resolves a single decision from `request.events` (wiring
-* `canTake` to `step.snapshot.can`, exempting the reserved `agent.plan.done`
-* move and `stopOn` events), then either applies the chosen machine event and
-* lets the next step re-surface the plan, or completes the plan (feeding its
-* `{ steps, stopped }` output back) on the done move / a `stopOn` event / an
-* exhausted budget / no legal events. The plan's applied trail is carried in
-* the invoke child's snapshot, so persisting the step between calls resumes the
-* plan identically.
-*
-* Missing the executor a request needs throws a clear error
-* (`generateText`/`streamText` for text, `decide` for decisions and plans).
-*
-* A complete durable host is two lines:
-*
-* ```ts
-* let step = initialAgentStep(machine, input);
-* while (!step.done) step = await resolveAgentRequests(machine, step, executors);
-* ```
-*
-* All pending **text** requests of a step are resolved in parallel
-* (`Promise.all`) — parallel statechart regions are genuinely concurrent, so
-* their model calls run concurrently — then their outputs apply in
-* **request-array order** (deterministic for durable replay regardless of which
-* call finishes first). Decisions and plans stay **one at a time**: applying
-* either changes the set of legal candidates for what follows, so they cannot be
-* resolved against a stale snapshot. A host that instead wants strictly
-* sequential text resolution loops the manual per-request helpers
-* ({@link executeAgentRequest} + {@link resolveAgentStep}) one at a time.
-*/
-async function resolveAgentRequests(machine, step, executors, options) {
-	const [request] = step.requests;
-	if (!request) return step;
-	if (request.kind === "decision") {
-		if (!executors.decide) throw new Error(`this step's decision request '${request.id}' needs a 'decide' executor but none was provided.`);
-		return transitionAgentStep(machine, step, await require_decision.resolveDecision(request, executors.decide, {
-			canTake: (event) => step.snapshot.can(event),
-			maxRetries: options?.maxRetries
-		}), options);
-	}
-	if (request.kind === "plan") return resolvePlanRequest(machine, step, request, executors, options);
-	const textRequests = step.requests.filter((candidate) => candidate.kind === "text");
-	for (const textRequest of textRequests) assertTextExecutor(textRequest, executors);
-	const outputs = await Promise.all(textRequests.map((textRequest) => executeAgentRequest(textRequest, executors)));
-	let next = step;
-	for (let index = 0; index < textRequests.length; index++) next = resolveAgentStep(machine, next, textRequests[index], outputs[index], options);
-	return next;
-}
 function assertTextExecutor(request, executors) {
 	const mode = request.mode ?? "generate";
 	const kind = mode === "stream" ? "streamText" : "generateText";
 	if (!(mode === "stream" ? executors.streamText : executors.generateText)) throw new Error(`this step's text request '${request.src}' needs a '${kind}' executor but none was provided.`);
 }
-async function resolvePlanRequest(machine, step, request, executors, options) {
-	if (!executors.decide) throw new Error(`this step's plan request '${request.src}' needs a 'decide' executor but none was provided.`);
-	const stopOn = new Set(request.input.stopOn ?? []);
-	if (request.stepsRemaining <= 0) return completePlan(machine, step, request.id, request.applied, "max-steps", options);
-	if (request.events.filter((event) => event.type !== "agent.plan.done").length === 0) return completePlan(machine, step, request.id, request.applied, "no-legal-events", options);
-	const chosen = await require_decision.resolveDecision(planStepDecisionRequest(request), executors.decide, {
-		maxRetries: options?.maxRetries,
-		canTake: (event) => {
-			if (event.type === "agent.plan.done" || stopOn.has(event.type)) return true;
-			return step.snapshot.can(event);
-		}
-	});
-	if (chosen.type === "agent.plan.done") return completePlan(machine, step, request.id, request.applied, "done", options);
-	const applied = [...request.applied, chosen];
-	advancePlanChildLedger(step.snapshot, request.id, {
-		type: "plan.applied",
-		event: chosen
-	});
-	const next = transitionAgentStep(machine, step, chosen, options);
-	if (stopOn.has(chosen.type)) {
-		if (isPlanActive(next.snapshot, request.id)) return completePlan(machine, next, request.id, applied, "stop-event", options);
-	}
-	return next;
-}
-function completePlan(machine, step, id, steps, stopped, options) {
-	return resolveAgentStep(machine, step, { id }, {
-		steps,
-		stopped
-	}, options);
-}
-function planStepDecisionRequest(request) {
-	const { input, applied, events, id } = request;
-	const trail = applied.length === 0 ? "" : `\n\nEvents already applied in this plan, in order:\n${applied.map((step) => JSON.stringify(step)).join("\n")}\nContinue from here; do not repeat applied events.`;
-	const doneHint = `\n\nWhen the request is fully handled (or no action is needed), choose '${require_decision.PLAN_DONE_EVENT_TYPE}'.`;
-	return {
-		kind: "decision",
-		id: `${id}[${applied.length}]`,
-		model: input.model,
-		system: input.system,
-		prompt: `${input.prompt ?? ""}${trail}${doneHint}`,
-		messages: input.messages,
-		events,
-		attempts: [],
-		temperature: input.temperature,
-		maxOutputTokens: input.maxOutputTokens,
-		topP: input.topP,
-		topK: input.topK,
-		seed: input.seed,
-		stopSequences: input.stopSequences,
-		metadata: input.metadata
-	};
-}
-function advancePlanChildLedger(snapshot, id, event) {
-	const child = snapshot.children?.[id];
-	const childSnapshot = child?.getSnapshot?.();
-	if (!require_decision.isPlanLogic(child?.logic) || !childSnapshot || typeof childSnapshot !== "object") return;
-	Object.assign(childSnapshot, require_decision.advancePlanLedger(child.logic, childSnapshot, event));
-}
-function isPlanActive(snapshot, id) {
-	return (snapshot.children?.[id])?.getSnapshot?.()?.status === "active";
-}
 function createAgentStep(machine, snapshot, actions, options) {
 	applyFinalStateOutput(machine, snapshot);
 	return {
@@ -644,12 +469,7 @@ function buildInvokeEffect(meta, mapped, events, snapshot, options) {
 		requestId,
 		request: mapped
 	};
-	if (mapped?.kind === "plan") return {
-		kind: "plan",
-		requestId,
-		request: mapped
-	};
-	const logic = require_decision.isTextLogic(meta.logic) || require_decision.isDecisionLogic(meta.logic) || require_decision.isPlanLogic(meta.logic) ? meta.logic : typeof meta.src === "string" ? options.actors?.[meta.src] : void 0;
+	const logic = require_decision.isTextLogic(meta.logic) || require_decision.isDecisionLogic(meta.logic) ? meta.logic : typeof meta.src === "string" ? options.actors?.[meta.src] : void 0;
 	if (require_decision.isTextLogic(logic)) return {
 		kind: "text",
 		requestId,
@@ -692,8 +512,8 @@ function buildInvokeEffect(meta, mapped, events, snapshot, options) {
 * Ordering is load-bearing: a single transition's actions are emitted in
 * document order (a custom entry action, a spawn, and a `sendTo` in that order
 * yield `execute`, then `task`/agent effect, then `execute` — never a
-* reordered set). Effects visible only on the snapshot (an `agent.plan` that
-* re-surfaces every step, and children spawned by an EARLIER transition that
+* reordered set). Effects visible only on the snapshot (children spawned by
+* an EARLIER transition that
 * have not completed yet — the fan-out / crash-resume case) are appended after
 * the action-derived effects, deduped by site id.
 *
@@ -754,14 +574,6 @@ function getAgentEffects(machine, snapshot, actions, options = {}) {
 			});
 		}
 	}
-	for (const request of requests) if (request.kind === "plan" && !emitted.has(request.id)) {
-		effects.push({
-			kind: "plan",
-			requestId: `${request.id}#${invokeOccurrence(events, request.id)}`,
-			request
-		});
-		emitted.add(request.id);
-	}
 	const children = snapshot.children;
 	for (const [id, child] of Object.entries(children ?? {})) {
 		if (emitted.has(id) || invokeOccurrence(events, id) > 1) continue;
@@ -1388,11 +1200,7 @@ const USAGE_ATTRIBUTION_FIELDS = [
 	"model",
 	"name"
 ];
-const USAGE_KINDS = [
-	"text",
-	"decision",
-	"plan"
-];
+const USAGE_KINDS = ["text", "decision"];
 /**
 * Standard Schema for the reserved `'@agent.usage'` payload. Hand-rolled (no
 * validation-library dependency in core) and deliberately permissive about
@@ -1510,7 +1318,7 @@ function resolveAgentStateSchemas(contextSchema, states) {
 * 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
@@ -1632,14 +1440,13 @@ function assertStateSchemaKeysExist(stateSchemas, machineStates, path = []) {
 const RESERVED_AGENT_ACTOR_KEYS = [
 	...Object.keys(require_decision.builtinTextActors),
 	require_decision.USER_INPUT_ACTOR,
-	require_decision.DECIDE_ACTOR,
-	require_decision.PLAN_ACTOR
+	require_decision.DECIDE_ACTOR
 ];
 /**
 * Rejects a user-supplied `actors`/`requests` key in the reserved
 * `agent.*` builtin namespace. Without this, the builtins-first spread in
 * {@link createAgentActors} lets such a key overwrite the builtin
-* (`agent.decide`, `agent.plan`, …) silently. Deliberate override of a builtin
+* (`agent.decide`, …) silently. Deliberate override of a builtin
 * is still possible after the machine is created, via
 * `machine.provide({ actors: { 'agent.decide': ... } })`.
 */
@@ -1654,7 +1461,6 @@ function createAgentActors(actors, requestActors) {
 		...require_decision.builtinTextActors,
 		[require_decision.USER_INPUT_ACTOR]: require_decision.userInputActor,
 		[require_decision.DECIDE_ACTOR]: require_decision.createDecideActor(),
-		[require_decision.PLAN_ACTOR]: require_decision.createPlanActor(),
 		...actors,
 		...requestActors
 	};
@@ -1804,12 +1610,6 @@ Object.defineProperty(exports, "replay", {
 		return replay;
 	}
 });
-Object.defineProperty(exports, "resolveAgentRequests", {
-	enumerable: true,
-	get: function() {
-		return resolveAgentRequests;
-	}
-});
 Object.defineProperty(exports, "resolveAgentStep", {
 	enumerable: true,
 	get: function() {

package/dist/{setup-agent-DAZZSjDS.mjs → setup-agent-DeHRW-qX.mjs}

@@ -1,5 +1,5 @@
 import { t as AgentError } from "./errors-CeSXQx0v.mjs";
-import { $ as validateSchemaSync, B as missingActor, C as executeAgentTextRequest, E as isTextLogic, I as getRegisteredAgentExecutionOptions, K as getMachineStructuralHash, M as agentExecutionOptions, R as machineStaticTransitionTargets, S as createTextLogic, _ as PLAN_ACTOR, a as createPlanActor, c as isPlanLogic, d as getAcceptedEvents, h as DECIDE_ACTOR, i as createDecideActor, j as userInputActor, n as PLAN_DONE_EVENT_TYPE, p as sanitizeEventToolName, r as advancePlanLedger, s as isDecisionLogic, u as resolveDecision, v as USER_INPUT_ACTOR, w as extractCallUsage, x as builtinTextActors, z as machineSuspensionPredicates } from "./decision-BezSD_YC.mjs";
+import { K as validateSchemaSync, M as machineSuspensionPredicates, N as missingActor, T as agentExecutionOptions, _ as extractCallUsage, d as USER_INPUT_ACTOR, g as executeAgentTextRequest, h as createTextLogic, j as machineStaticTransitionTargets, k as getRegisteredAgentExecutionOptions, l as DECIDE_ACTOR, m as builtinTextActors, n as createDecideActor, o as getAcceptedEvents, r as isDecisionLogic, w as userInputActor, y as isTextLogic, z as getMachineStructuralHash } from "./decision-D9Zi7Xi5.mjs";
 import { i as assertAgentLogEntry, o as assertJsonSerializable } from "./event-log-store-D7pWtIhb.mjs";
 import { createMachineFromConfig, initialTransition, setup, transition } from "xstate";
 //#region src/messages.ts
@@ -117,7 +117,7 @@ function getInvokeEffectMetadata(action) {
 * @internal
 */
 function getAgentRequestsWith(actions, options = {}) {
-	return [...actions.flatMap((action) => {
+	return actions.flatMap((action) => {
 		const params = getInvokeEffectMetadata(action);
 		if (!params || typeof params.src !== "string") return [];
 		if (typeof params.id !== "string" || params.id.length === 0) throw new Error(`Agent invoke '${params.src}' must define a durable string id.`);
@@ -149,60 +149,7 @@ function getAgentRequestsWith(actions, options = {}) {
 			tools: input.tools ?? {},
 			events: []
 		}];
-	}), ...getActivePlanRequests(options)];
-}
-/**
-* Scans the live snapshot's children for active `agent.plan` (plan-logic)
-* invokes and lowers each into an {@link AgentPlanRequest} — the re-surfacing
-* half of plan discovery. Reads the applied-event trail and remaining budget
-* from the child's own ledger `context` ({@link PlanLedgerContext}), recomputes
-* the currently-legal candidates (∩ declared `allowedEvents`) plus the reserved
-* `agent.plan.done` move, and takes `stepsRemaining` from the ledger (falling
-* back to `maxSteps - applied.length` for a snapshot with no context yet).
-* Returns `[]` when no snapshot is available (candidates need a live snapshot).
-*
-* @internal
-*/
-function getActivePlanRequests(options) {
-	const snapshot = options.snapshot;
-	if (!snapshot) return [];
-	const children = snapshot.children;
-	if (!children) return [];
-	const requests = [];
-	for (const [id, child] of Object.entries(children)) {
-		const ref = child;
-		if (typeof ref?.getSnapshot !== "function") continue;
-		const src = typeof ref.src === "string" ? ref.src : void 0;
-		const logic = (src ? options.actors?.[src] : void 0) ?? ref.logic;
-		if (!isPlanLogic(logic)) continue;
-		const childSnapshot = ref.getSnapshot();
-		if (childSnapshot?.status !== "active") continue;
-		const input = childSnapshot.input ?? {};
-		const maxSteps = input.maxSteps ?? 8;
-		const ledger = childSnapshot.context ?? {};
-		const applied = ledger.applied ?? [];
-		const stepsRemaining = ledger.stepsRemaining ?? maxSteps - applied.length;
-		const machineEvents = getAcceptedEvents(snapshot, {
-			events: options.events,
-			schemas: options.schemas,
-			eventTypes: logic.allowedEventTypes(input) ?? void 0,
-			eventToolName: options.eventToolName
-		});
-		const events = machineEvents.some((event) => event.type === "agent.plan.done") ? machineEvents : [...machineEvents, {
-			type: PLAN_DONE_EVENT_TYPE,
-			toolName: sanitizeEventToolName(PLAN_DONE_EVENT_TYPE)
-		}];
-		requests.push({
-			kind: "plan",
-			id,
-			src: src ?? "",
-			input,
-			events,
-			applied,
-			stepsRemaining: Math.max(0, stepsRemaining)
-		});
-	}
-	return requests;
+	});
 }
 /**
 * Builds the canonical `xstate.done.actor` event xstate's `transition()`
@@ -289,133 +236,11 @@ async function executeAgentRequest(requestOrEffect, executors, options) {
 		raw
 	} : normalizedOutput;
 }
-/**
-* Resolves the current step's pending requests and returns the next
-* {@link AgentStep} — one iteration of the durable step loop, collapsing the
-* manual `request.kind` dispatch a host would otherwise write by hand.
-*
-* For each pending request, in order: a `kind: 'text'` request is run with
-* {@link executeAgentRequest} then fed back via {@link resolveAgentStep}; a
-* `kind: 'decision'` request is resolved with `resolveDecision` (wiring
-* `canTake` to `step.snapshot.can` so guard-rejected choices retry) then
-* applied with {@link transitionAgentStep}. The **current** step is re-read
-* after each application — the machine may advance and its `requests` change —
-* so this always resolves against the live step, never a stale list.
-*
-* A `kind: 'plan'` request (`agent.plan`) is resolved natively too: one plan
-* step per call. It resolves a single decision from `request.events` (wiring
-* `canTake` to `step.snapshot.can`, exempting the reserved `agent.plan.done`
-* move and `stopOn` events), then either applies the chosen machine event and
-* lets the next step re-surface the plan, or completes the plan (feeding its
-* `{ steps, stopped }` output back) on the done move / a `stopOn` event / an
-* exhausted budget / no legal events. The plan's applied trail is carried in
-* the invoke child's snapshot, so persisting the step between calls resumes the
-* plan identically.
-*
-* Missing the executor a request needs throws a clear error
-* (`generateText`/`streamText` for text, `decide` for decisions and plans).
-*
-* A complete durable host is two lines:
-*
-* ```ts
-* let step = initialAgentStep(machine, input);
-* while (!step.done) step = await resolveAgentRequests(machine, step, executors);
-* ```
-*
-* All pending **text** requests of a step are resolved in parallel
-* (`Promise.all`) — parallel statechart regions are genuinely concurrent, so
-* their model calls run concurrently — then their outputs apply in
-* **request-array order** (deterministic for durable replay regardless of which
-* call finishes first). Decisions and plans stay **one at a time**: applying
-* either changes the set of legal candidates for what follows, so they cannot be
-* resolved against a stale snapshot. A host that instead wants strictly
-* sequential text resolution loops the manual per-request helpers
-* ({@link executeAgentRequest} + {@link resolveAgentStep}) one at a time.
-*/
-async function resolveAgentRequests(machine, step, executors, options) {
-	const [request] = step.requests;
-	if (!request) return step;
-	if (request.kind === "decision") {
-		if (!executors.decide) throw new Error(`this step's decision request '${request.id}' needs a 'decide' executor but none was provided.`);
-		return transitionAgentStep(machine, step, await resolveDecision(request, executors.decide, {
-			canTake: (event) => step.snapshot.can(event),
-			maxRetries: options?.maxRetries
-		}), options);
-	}
-	if (request.kind === "plan") return resolvePlanRequest(machine, step, request, executors, options);
-	const textRequests = step.requests.filter((candidate) => candidate.kind === "text");
-	for (const textRequest of textRequests) assertTextExecutor(textRequest, executors);
-	const outputs = await Promise.all(textRequests.map((textRequest) => executeAgentRequest(textRequest, executors)));
-	let next = step;
-	for (let index = 0; index < textRequests.length; index++) next = resolveAgentStep(machine, next, textRequests[index], outputs[index], options);
-	return next;
-}
 function assertTextExecutor(request, executors) {
 	const mode = request.mode ?? "generate";
 	const kind = mode === "stream" ? "streamText" : "generateText";
 	if (!(mode === "stream" ? executors.streamText : executors.generateText)) throw new Error(`this step's text request '${request.src}' needs a '${kind}' executor but none was provided.`);
 }
-async function resolvePlanRequest(machine, step, request, executors, options) {
-	if (!executors.decide) throw new Error(`this step's plan request '${request.src}' needs a 'decide' executor but none was provided.`);
-	const stopOn = new Set(request.input.stopOn ?? []);
-	if (request.stepsRemaining <= 0) return completePlan(machine, step, request.id, request.applied, "max-steps", options);
-	if (request.events.filter((event) => event.type !== "agent.plan.done").length === 0) return completePlan(machine, step, request.id, request.applied, "no-legal-events", options);
-	const chosen = await resolveDecision(planStepDecisionRequest(request), executors.decide, {
-		maxRetries: options?.maxRetries,
-		canTake: (event) => {
-			if (event.type === "agent.plan.done" || stopOn.has(event.type)) return true;
-			return step.snapshot.can(event);
-		}
-	});
-	if (chosen.type === "agent.plan.done") return completePlan(machine, step, request.id, request.applied, "done", options);
-	const applied = [...request.applied, chosen];
-	advancePlanChildLedger(step.snapshot, request.id, {
-		type: "plan.applied",
-		event: chosen
-	});
-	const next = transitionAgentStep(machine, step, chosen, options);
-	if (stopOn.has(chosen.type)) {
-		if (isPlanActive(next.snapshot, request.id)) return completePlan(machine, next, request.id, applied, "stop-event", options);
-	}
-	return next;
-}
-function completePlan(machine, step, id, steps, stopped, options) {
-	return resolveAgentStep(machine, step, { id }, {
-		steps,
-		stopped
-	}, options);
-}
-function planStepDecisionRequest(request) {
-	const { input, applied, events, id } = request;
-	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}'.`;
-	return {
-		kind: "decision",
-		id: `${id}[${applied.length}]`,
-		model: input.model,
-		system: input.system,
-		prompt: `${input.prompt ?? ""}${trail}${doneHint}`,
-		messages: input.messages,
-		events,
-		attempts: [],
-		temperature: input.temperature,
-		maxOutputTokens: input.maxOutputTokens,
-		topP: input.topP,
-		topK: input.topK,
-		seed: input.seed,
-		stopSequences: input.stopSequences,
-		metadata: input.metadata
-	};
-}
-function advancePlanChildLedger(snapshot, id, event) {
-	const child = snapshot.children?.[id];
-	const childSnapshot = child?.getSnapshot?.();
-	if (!isPlanLogic(child?.logic) || !childSnapshot || typeof childSnapshot !== "object") return;
-	Object.assign(childSnapshot, advancePlanLedger(child.logic, childSnapshot, event));
-}
-function isPlanActive(snapshot, id) {
-	return (snapshot.children?.[id])?.getSnapshot?.()?.status === "active";
-}
 function createAgentStep(machine, snapshot, actions, options) {
 	applyFinalStateOutput(machine, snapshot);
 	return {
@@ -644,12 +469,7 @@ function buildInvokeEffect(meta, mapped, events, snapshot, options) {
 		requestId,
 		request: mapped
 	};
-	if (mapped?.kind === "plan") return {
-		kind: "plan",
-		requestId,
-		request: mapped
-	};
-	const logic = isTextLogic(meta.logic) || isDecisionLogic(meta.logic) || isPlanLogic(meta.logic) ? meta.logic : typeof meta.src === "string" ? options.actors?.[meta.src] : void 0;
+	const logic = isTextLogic(meta.logic) || isDecisionLogic(meta.logic) ? meta.logic : typeof meta.src === "string" ? options.actors?.[meta.src] : void 0;
 	if (isTextLogic(logic)) return {
 		kind: "text",
 		requestId,
@@ -692,8 +512,8 @@ function buildInvokeEffect(meta, mapped, events, snapshot, options) {
 * Ordering is load-bearing: a single transition's actions are emitted in
 * document order (a custom entry action, a spawn, and a `sendTo` in that order
 * yield `execute`, then `task`/agent effect, then `execute` — never a
-* reordered set). Effects visible only on the snapshot (an `agent.plan` that
-* re-surfaces every step, and children spawned by an EARLIER transition that
+* reordered set). Effects visible only on the snapshot (children spawned by
+* an EARLIER transition that
 * have not completed yet — the fan-out / crash-resume case) are appended after
 * the action-derived effects, deduped by site id.
 *
@@ -754,14 +574,6 @@ function getAgentEffects(machine, snapshot, actions, options = {}) {
 			});
 		}
 	}
-	for (const request of requests) if (request.kind === "plan" && !emitted.has(request.id)) {
-		effects.push({
-			kind: "plan",
-			requestId: `${request.id}#${invokeOccurrence(events, request.id)}`,
-			request
-		});
-		emitted.add(request.id);
-	}
 	const children = snapshot.children;
 	for (const [id, child] of Object.entries(children ?? {})) {
 		if (emitted.has(id) || invokeOccurrence(events, id) > 1) continue;
@@ -1388,11 +1200,7 @@ const USAGE_ATTRIBUTION_FIELDS = [
 	"model",
 	"name"
 ];
-const USAGE_KINDS = [
-	"text",
-	"decision",
-	"plan"
-];
+const USAGE_KINDS = ["text", "decision"];
 /**
 * Standard Schema for the reserved `'@agent.usage'` payload. Hand-rolled (no
 * validation-library dependency in core) and deliberately permissive about
@@ -1510,7 +1318,7 @@ function resolveAgentStateSchemas(contextSchema, states) {
 * 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
@@ -1632,14 +1440,13 @@ function assertStateSchemaKeysExist(stateSchemas, machineStates, path = []) {
 const RESERVED_AGENT_ACTOR_KEYS = [
 	...Object.keys(builtinTextActors),
 	USER_INPUT_ACTOR,
-	DECIDE_ACTOR,
-	PLAN_ACTOR
+	DECIDE_ACTOR
 ];
 /**
 * Rejects a user-supplied `actors`/`requests` key in the reserved
 * `agent.*` builtin namespace. Without this, the builtins-first spread in
 * {@link createAgentActors} lets such a key overwrite the builtin
-* (`agent.decide`, `agent.plan`, …) silently. Deliberate override of a builtin
+* (`agent.decide`, …) silently. Deliberate override of a builtin
 * is still possible after the machine is created, via
 * `machine.provide({ actors: { 'agent.decide': ... } })`.
 */
@@ -1654,7 +1461,6 @@ function createAgentActors(actors, requestActors) {
 		...builtinTextActors,
 		[USER_INPUT_ACTOR]: userInputActor,
 		[DECIDE_ACTOR]: createDecideActor(),
-		[PLAN_ACTOR]: createPlanActor(),
 		...actors,
 		...requestActors
 	};
@@ -1708,4 +1514,4 @@ function createSetupAgent(config) {
 	});
 }
 //#endregion
-export { resolveAgentRequests as _, AgentReplayDivergenceError as a, appendMessages as b, diffEventLogs as c, initEntry as d, replay as f, initialAgentStep as g, getInvokeEffectMetadata as h, AGENT_USAGE_EVENT_TYPE as i, getAgentEffects as l, executeAgentRequest as m, setupAgent as n, AgentReplayMachineMismatchError as o, verifyReplay as p, AGENT_INIT_EVENT_TYPE as r, createReplayEntry as s, createAgentSchemas as t, getCallUsage as u, resolveAgentStep as v, messagesSchema as x, transitionAgentStep as y };
+export { resolveAgentStep as _, AgentReplayDivergenceError as a, messagesSchema as b, diffEventLogs as c, initEntry as d, replay as f, initialAgentStep as g, getInvokeEffectMetadata as h, AGENT_USAGE_EVENT_TYPE as i, getAgentEffects as l, executeAgentRequest as m, setupAgent as n, AgentReplayMachineMismatchError as o, verifyReplay as p, AGENT_INIT_EVENT_TYPE as r, createReplayEntry as s, createAgentSchemas as t, getCallUsage as u, transitionAgentStep as v, appendMessages as y };

package/dist/sqlite.d.cts

@@ -1,5 +1,5 @@
-import { r as AgentSnapshotStore } from "./types-QbEfCVny.cjs";
-import { r as AgentEventLogStore } from "./event-log-store-Ruq18mGp.cjs";
+import { r as AgentSnapshotStore } from "./types-DFD28AWe.cjs";
+import { r as AgentEventLogStore } from "./event-log-store-CVd2eyRy.cjs";
 
 //#region src/sqlite/index.d.ts
 /** A prepared statement, structurally compatible with `node:sqlite`'s `StatementSync`. */

package/dist/sqlite.d.mts

@@ -1,5 +1,5 @@
-import { r as AgentSnapshotStore } from "./types-_FXoFBGO.mjs";
-import { r as AgentEventLogStore } from "./event-log-store-CriMgX1D.mjs";
+import { r as AgentSnapshotStore } from "./types-CTBhMnFu.mjs";
+import { r as AgentEventLogStore } from "./event-log-store-BkUNtyOF.mjs";
 
 //#region src/sqlite/index.d.ts
 /** A prepared statement, structurally compatible with `node:sqlite`'s `StatementSync`. */