@statelyai/agent 2.0.0-alpha.31 → 2.0.0-alpha.32

package/CHANGELOG.md

@@ -1,5 +1,15 @@
 # @statelyai/agent
 
+## 2.0.0-alpha.32
+
+### Patch Changes
+
+- [#178](https://github.com/statelyai/agent/pull/178) [`efe9dd0`](https://github.com/statelyai/agent/commit/efe9dd029b1fd4b333010f84997e4568eb760eea) Thanks [@davidkpiano](https://github.com/davidkpiano)! - **A fork is its own lineage.** `forkEventLog` and `store.fork` give the fork's init entry a fresh `metadata.executionId` and `metadata.forkedFrom: { executionId?, logIndex }` (the parent's id, when it has one, and the cutoff). Before, a fork kept its parent's execution id, so a call the fork made at the same site got the same `info.callKey` as the parent's, and a cache keyed on it could return the parent's result.
+  
+  - **A custom store's `fork` must store what `forkEventLog` returns** for the prefix. `assertEventLogStoreConformance` now checks the lineage, and its fixtures start with a real init entry.
+  - A snapshot taken on the parent no longer takes the fast path when resuming the fork; the fork's log is folded instead. A version bridge still accepts it while the fork has appended nothing since its cutoff.
+  - Explicit `events` for a stored thread must also match its init entry's `executionId`, so a parent's log is refused for its fork's thread.
+
 ## 2.0.0-alpha.31
 
 ### Minor Changes

package/dist/ai-sdk.cjs

@@ -1,7 +1,7 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
-const require_event_log = require("./event-log-Bdww2l1D.cjs");
-const require_decision = require("./decision-Iys2hzg3.cjs");
-const require_model_source = require("./model-source-DQ7KgJaT.cjs");
+const require_event_log = require("./event-log-CKWeC7H-.cjs");
+const require_decision = require("./decision-BPdEaxPf.cjs");
+const require_model_source = require("./model-source-BQ97_l1-.cjs");
 let ai = require("ai");
 //#region src/ai-sdk/mappers.ts
 /**

package/dist/ai-sdk.d.cts

@@ -1,5 +1,5 @@
 import { s as AgentTools, u as ChosenEvent } from "./types-Dp5_Ru4R.cjs";
-import { N as AgentDecisionRequest, c as AgentRequestExecutorInfo, f as AgentTextRequest, r as AgentFinishReason, t as AgentCallUsage } from "./text-logic-j9hShB7d.cjs";
+import { N as AgentDecisionRequest, c as AgentRequestExecutorInfo, f as AgentTextRequest, r as AgentFinishReason, t as AgentCallUsage } from "./text-logic-CYP502VT.cjs";
 import { Experimental_DecisionModel, FinishReason, LanguageModel, LanguageModelUsage, ModelMessage, ToolSet, TypedToolCall, TypedToolResult, generateText } from "ai";
 import { AnyStateMachine } from "xstate";
 //#region src/ai-sdk/mappers.d.ts

package/dist/ai-sdk.d.mts

@@ -1,5 +1,5 @@
 import { s as AgentTools, u as ChosenEvent } from "./types-Dp5_Ru4R.mjs";
-import { N as AgentDecisionRequest, c as AgentRequestExecutorInfo, f as AgentTextRequest, r as AgentFinishReason, t as AgentCallUsage } from "./text-logic-BwdrDpO9.mjs";
+import { N as AgentDecisionRequest, c as AgentRequestExecutorInfo, f as AgentTextRequest, r as AgentFinishReason, t as AgentCallUsage } from "./text-logic-DuK9HIFM.mjs";
 import { AnyStateMachine } from "xstate";
 import { Experimental_DecisionModel, FinishReason, LanguageModel, LanguageModelUsage, ModelMessage, ToolSet, TypedToolCall, TypedToolResult, generateText } from "ai";
 //#region src/ai-sdk/mappers.d.ts

package/dist/ai-sdk.mjs

@@ -1,6 +1,6 @@
-import { R as providerOutputSchema, dt as AgentTruncatedError, j as getAgentOutputMode, lt as isRecord, tt as isStandardSchema } from "./event-log-DE430ZCa.mjs";
-import { c as renderDecisionAttempts, o as decisionOptionIds } from "./decision-DqO018Tp.mjs";
-import { t as resolveModelSource } from "./model-source-CXsSZPq0.mjs";
+import { R as providerOutputSchema, dt as AgentTruncatedError, j as getAgentOutputMode, lt as isRecord, tt as isStandardSchema } from "./event-log-DAqsalT1.mjs";
+import { c as renderDecisionAttempts, o as decisionOptionIds } from "./decision-CV7WiV5C.mjs";
+import { t as resolveModelSource } from "./model-source-BilDEyqk.mjs";
 import { InvalidResponseDataError, NoObjectGeneratedError, Output, experimental_decide, generateText, jsonSchema, stepCountIs, streamText, tool } from "ai";
 //#region src/ai-sdk/mappers.ts
 /**

package/dist/{decision-Iys2hzg3.cjs → decision-BPdEaxPf.cjs}

@@ -1,4 +1,4 @@
-const require_event_log = require("./event-log-Bdww2l1D.cjs");
+const require_event_log = require("./event-log-CKWeC7H-.cjs");
 let xstate = require("xstate");
 //#region src/events.ts
 /**

package/dist/{decision-DqO018Tp.mjs → decision-CV7WiV5C.mjs}

@@ -1,4 +1,4 @@
-import { H as getAgentExecutionOptions, T as DECIDE_ACTOR, V as executorBoundLogics, at as userMessage, lt as isRecord, ot as validateSchemaSync, u as canonicalEventJson, ut as AgentError, z as resolveTextLogicValue } from "./event-log-DE430ZCa.mjs";
+import { H as getAgentExecutionOptions, T as DECIDE_ACTOR, V as executorBoundLogics, at as userMessage, lt as isRecord, ot as validateSchemaSync, u as canonicalEventJson, ut as AgentError, z as resolveTextLogicValue } from "./event-log-DAqsalT1.mjs";
 import { createAsyncLogic, getNextTransitions } from "xstate";
 //#region src/events.ts
 /**

package/dist/{event-log-Bdww2l1D.cjs → event-log-CKWeC7H-.cjs}

@@ -1239,8 +1239,8 @@ function isSnapshotInitEntry(entry) {
 * Minted once per run and inherited verbatim by every resume of that log, so
 * it names one lineage rather than one process. Entry ids cannot serve this
 * role — the built-in ids are index-derived, so every log's init entry is
-* `evt_00000000`. A fork copies the init entry, so it shares its parent's
-* execution id by construction.
+* `evt_00000000`. A fork ({@link forkEventLog}, `store.fork`) mints its own
+* and records the parent's in `metadata.forkedFrom`.
 *
 * Returns `undefined` for a log with no init entry and for one written without
 * the field — callers must treat the id as optional.
@@ -1288,12 +1288,31 @@ function validateReplayEntries(entries, options = {}) {
 /**
 * The prefix `[0, upToIndex)` of a log, as a new log. `upToIndex` is exclusive
 * and must leave the init entry in place, so the fork is still self-contained.
+*
+* The fork is its own lineage: its init entry gets a fresh
+* `metadata.executionId` and `metadata.forkedFrom: { executionId?, logIndex }`:
+* the cutoff, and the parent's id when it had one. Call keys derive
+* from the execution id, so a fork's calls never collide with its parent's.
+* Every other entry is copied as is.
 */
 function forkEventLog(entries, upToIndex) {
 	if (!Number.isInteger(upToIndex) || upToIndex < 1 || upToIndex > entries.length) throw new AgentEventLogError(`forkEventLog: upToIndex must be an integer in [1, ${entries.length}]; got ${String(upToIndex)}.`);
 	const forked = entries.slice(0, upToIndex);
 	if (!isInitEntry(forked[0])) throw new AgentEventLogError(`forkEventLog: the forked prefix must start with the reserved '${AGENT_INIT_EVENT_TYPE}' entry.`);
-	return forked;
+	const [init, ...rest] = forked;
+	const parentExecutionId = getLogExecutionId(forked);
+	const forkedFrom = {
+		...parentExecutionId !== void 0 ? { executionId: parentExecutionId } : {},
+		logIndex: upToIndex
+	};
+	return [{
+		...init,
+		metadata: {
+			...init.metadata,
+			executionId: crypto.randomUUID(),
+			forkedFrom
+		}
+	}, ...rest];
 }
 const DONE_ACTOR_EVENT_TYPE = "xstate.done.actor";
 const ERROR_ACTOR_EVENT_TYPE = "xstate.error.actor";

package/dist/{event-log-DE430ZCa.mjs → event-log-DAqsalT1.mjs}

@@ -1239,8 +1239,8 @@ function isSnapshotInitEntry(entry) {
 * Minted once per run and inherited verbatim by every resume of that log, so
 * it names one lineage rather than one process. Entry ids cannot serve this
 * role — the built-in ids are index-derived, so every log's init entry is
-* `evt_00000000`. A fork copies the init entry, so it shares its parent's
-* execution id by construction.
+* `evt_00000000`. A fork ({@link forkEventLog}, `store.fork`) mints its own
+* and records the parent's in `metadata.forkedFrom`.
 *
 * Returns `undefined` for a log with no init entry and for one written without
 * the field — callers must treat the id as optional.
@@ -1288,12 +1288,31 @@ function validateReplayEntries(entries, options = {}) {
 /**
 * The prefix `[0, upToIndex)` of a log, as a new log. `upToIndex` is exclusive
 * and must leave the init entry in place, so the fork is still self-contained.
+*
+* The fork is its own lineage: its init entry gets a fresh
+* `metadata.executionId` and `metadata.forkedFrom: { executionId?, logIndex }`:
+* the cutoff, and the parent's id when it had one. Call keys derive
+* from the execution id, so a fork's calls never collide with its parent's.
+* Every other entry is copied as is.
 */
 function forkEventLog(entries, upToIndex) {
 	if (!Number.isInteger(upToIndex) || upToIndex < 1 || upToIndex > entries.length) throw new AgentEventLogError(`forkEventLog: upToIndex must be an integer in [1, ${entries.length}]; got ${String(upToIndex)}.`);
 	const forked = entries.slice(0, upToIndex);
 	if (!isInitEntry(forked[0])) throw new AgentEventLogError(`forkEventLog: the forked prefix must start with the reserved '${AGENT_INIT_EVENT_TYPE}' entry.`);
-	return forked;
+	const [init, ...rest] = forked;
+	const parentExecutionId = getLogExecutionId(forked);
+	const forkedFrom = {
+		...parentExecutionId !== void 0 ? { executionId: parentExecutionId } : {},
+		logIndex: upToIndex
+	};
+	return [{
+		...init,
+		metadata: {
+			...init.metadata,
+			executionId: crypto.randomUUID(),
+			forkedFrom
+		}
+	}, ...rest];
 }
 const DONE_ACTOR_EVENT_TYPE = "xstate.done.actor";
 const ERROR_ACTOR_EVENT_TYPE = "xstate.error.actor";

package/dist/{event-log-store-CCWdTPEP.mjs → event-log-store-BGehvVTb.mjs}

@@ -1,4 +1,4 @@
-import { c as assertAgentLogEntry, ut as AgentError } from "./event-log-DE430ZCa.mjs";
+import { c as assertAgentLogEntry, p as forkEventLog, ut as AgentError } from "./event-log-DAqsalT1.mjs";
 //#region src/event-log-store.ts
 /**
 * Durable storage for {@link AgentLogEntry} logs: the one interface a host
@@ -65,7 +65,7 @@ function createInMemoryEventLogStore() {
 			if (!source) throw new Error(`AgentEventLogStore.fork: unknown source thread "${threadId}".`);
 			const upTo = upToIndex ?? source.length;
 			if (!Number.isInteger(upTo) || upTo < 1 || upTo > source.length) throw new Error(`AgentEventLogStore.fork: upToIndex must be an integer in [1, ${source.length}] on thread "${threadId}"; got ${String(upTo)}.`);
-			threads.set(newThreadId, source.slice(0, upTo).map((entry) => clone(entry)));
+			threads.set(newThreadId, forkEventLog(source, upTo).map((entry) => clone(entry)));
 		},
 		async listThreads(options = {}) {
 			const { prefix = "", limit, cursor } = options;

package/dist/{event-log-store-DTf_OzB-.d.cts → event-log-store-C2NjVlWU.d.mts}

@@ -1,4 +1,4 @@
-import { I as DecisionAttempt, Q as AgentError, t as AgentCallUsage } from "./text-logic-j9hShB7d.cjs";
+import { I as DecisionAttempt, Q as AgentError, t as AgentCallUsage } from "./text-logic-DuK9HIFM.mjs";
 import { Actor, AnyMachineSnapshot, AnyStateMachine, EventObject, Snapshot, SnapshotFrom } from "xstate";
 //#region src/event-log.d.ts
 /** The durable entry envelope version. */
@@ -186,8 +186,8 @@ declare function initEntry(machine: AnyStateMachine, init?: AgentLogInit, option
  * Minted once per run and inherited verbatim by every resume of that log, so
  * it names one lineage rather than one process. Entry ids cannot serve this
  * role — the built-in ids are index-derived, so every log's init entry is
- * `evt_00000000`. A fork copies the init entry, so it shares its parent's
- * execution id by construction.
+ * `evt_00000000`. A fork ({@link forkEventLog}, `store.fork`) mints its own
+ * and records the parent's in `metadata.forkedFrom`.
  *
  * Returns `undefined` for a log with no init entry and for one written without
  * the field — callers must treat the id as optional.
@@ -210,6 +210,12 @@ declare function validateReplayEntries(entries: readonly AgentLogEntry[], option
 /**
  * The prefix `[0, upToIndex)` of a log, as a new log. `upToIndex` is exclusive
  * and must leave the init entry in place, so the fork is still self-contained.
+ *
+ * The fork is its own lineage: its init entry gets a fresh
+ * `metadata.executionId` and `metadata.forkedFrom: { executionId?, logIndex }`:
+ * the cutoff, and the parent's id when it had one. Call keys derive
+ * from the execution id, so a fork's calls never collide with its parent's.
+ * Every other entry is copied as is.
  */
 declare function forkEventLog(entries: readonly AgentLogEntry[], upToIndex: number): AgentLogEntry[];
 /**
@@ -380,8 +386,10 @@ interface AgentEventLogStore {
    * init entry and stays a self-contained log. The fork then appends
    * independently. Rejects (plain `Error`) if `newThreadId` already has
    * entries, the source is unknown, or `upToIndex` is out of range.
-   * Implementations may copy-on-write or physically copy; observable behavior
-   * must match a full copy.
+   *
+   * The fork is its own lineage: store what {@link forkEventLog} returns for
+   * the prefix, whose init entry carries a fresh `metadata.executionId` and
+   * `metadata.forkedFrom`. Every other entry must match the source.
    */
   fork(input: {
     threadId: string;

package/dist/{event-log-store-BWMLi6oh.cjs → event-log-store-DKyE7JKr.cjs}

@@ -1,4 +1,4 @@
-const require_event_log = require("./event-log-Bdww2l1D.cjs");
+const require_event_log = require("./event-log-CKWeC7H-.cjs");
 //#region src/event-log-store.ts
 /**
 * Durable storage for {@link AgentLogEntry} logs: the one interface a host
@@ -65,7 +65,7 @@ function createInMemoryEventLogStore() {
 			if (!source) throw new Error(`AgentEventLogStore.fork: unknown source thread "${threadId}".`);
 			const upTo = upToIndex ?? source.length;
 			if (!Number.isInteger(upTo) || upTo < 1 || upTo > source.length) throw new Error(`AgentEventLogStore.fork: upToIndex must be an integer in [1, ${source.length}] on thread "${threadId}"; got ${String(upTo)}.`);
-			threads.set(newThreadId, source.slice(0, upTo).map((entry) => clone(entry)));
+			threads.set(newThreadId, require_event_log.forkEventLog(source, upTo).map((entry) => clone(entry)));
 		},
 		async listThreads(options = {}) {
 			const { prefix = "", limit, cursor } = options;

package/dist/{event-log-store-RziIobdW.d.mts → event-log-store-s73r1Hxf.d.cts}

@@ -1,4 +1,4 @@
-import { I as DecisionAttempt, Q as AgentError, t as AgentCallUsage } from "./text-logic-BwdrDpO9.mjs";
+import { I as DecisionAttempt, Q as AgentError, t as AgentCallUsage } from "./text-logic-CYP502VT.cjs";
 import { Actor, AnyMachineSnapshot, AnyStateMachine, EventObject, Snapshot, SnapshotFrom } from "xstate";
 //#region src/event-log.d.ts
 /** The durable entry envelope version. */
@@ -186,8 +186,8 @@ declare function initEntry(machine: AnyStateMachine, init?: AgentLogInit, option
  * Minted once per run and inherited verbatim by every resume of that log, so
  * it names one lineage rather than one process. Entry ids cannot serve this
  * role — the built-in ids are index-derived, so every log's init entry is
- * `evt_00000000`. A fork copies the init entry, so it shares its parent's
- * execution id by construction.
+ * `evt_00000000`. A fork ({@link forkEventLog}, `store.fork`) mints its own
+ * and records the parent's in `metadata.forkedFrom`.
  *
  * Returns `undefined` for a log with no init entry and for one written without
  * the field — callers must treat the id as optional.
@@ -210,6 +210,12 @@ declare function validateReplayEntries(entries: readonly AgentLogEntry[], option
 /**
  * The prefix `[0, upToIndex)` of a log, as a new log. `upToIndex` is exclusive
  * and must leave the init entry in place, so the fork is still self-contained.
+ *
+ * The fork is its own lineage: its init entry gets a fresh
+ * `metadata.executionId` and `metadata.forkedFrom: { executionId?, logIndex }`:
+ * the cutoff, and the parent's id when it had one. Call keys derive
+ * from the execution id, so a fork's calls never collide with its parent's.
+ * Every other entry is copied as is.
  */
 declare function forkEventLog(entries: readonly AgentLogEntry[], upToIndex: number): AgentLogEntry[];
 /**
@@ -380,8 +386,10 @@ interface AgentEventLogStore {
    * init entry and stays a self-contained log. The fork then appends
    * independently. Rejects (plain `Error`) if `newThreadId` already has
    * entries, the source is unknown, or `upToIndex` is out of range.
-   * Implementations may copy-on-write or physically copy; observable behavior
-   * must match a full copy.
+   *
+   * The fork is its own lineage: store what {@link forkEventLog} returns for
+   * the prefix, whose init entry carries a fresh `metadata.executionId` and
+   * `metadata.forkedFrom`. Every other entry must match the source.
    */
   fork(input: {
     threadId: string;

package/dist/index.cjs

@@ -1,9 +1,9 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
-const require_event_log = require("./event-log-Bdww2l1D.cjs");
-const require_decision = require("./decision-Iys2hzg3.cjs");
-const require_setup_agent = require("./setup-agent-D0L8Anl_.cjs");
-const require_event_log_store = require("./event-log-store-BWMLi6oh.cjs");
-const require_run_agent = require("./run-agent-tmk58M0x.cjs");
+const require_event_log = require("./event-log-CKWeC7H-.cjs");
+const require_decision = require("./decision-BPdEaxPf.cjs");
+const require_setup_agent = require("./setup-agent-CwUJyqKB.cjs");
+const require_event_log_store = require("./event-log-store-DKyE7JKr.cjs");
+const require_run_agent = require("./run-agent-Cg0xd3K-.cjs");
 let xstate = require("xstate");
 //#region src/messages.ts
 const KNOWN_PART_TYPES = /* @__PURE__ */ new Set([

package/dist/index.d.cts

@@ -1,9 +1,9 @@
 import { C as UserMessage, S as ToolResultPart, _ as StandardSchemaV1, a as AgentToolDescriptor, b as ToolCallPart, c as AllowedEvents, d as EventUnion, f as FilePart, h as InferOutput, i as AgentToolChoice, l as AssistantMessage, m as InferInput, n as AgentMessage, o as AgentToolExecute, p as ImagePart, r as AgentTool, s as AgentTools, u as ChosenEvent, v as SystemMessage, x as ToolMessage, y as TextPart } from "./types-Dp5_Ru4R.cjs";
-import { $ as AgentTruncatedError, A as AgentDecisionExhaustedError, B as createDecisionLogic, C as getAgentOutputMode, D as parseProviderOutput, E as parseOutput, F as CreateDecisionRequestOptions, G as AgentInvalidEventPayloadError, H as renderDecisionAttempts, I as DecisionAttempt, J as AgentSchemas, K as AgentRequestOptions, L as DecisionLogic, M as AgentDecisionOption, N as AgentDecisionRequest, O as providerOutputSchema, P as AgentExecutorDecisionRequest, Q as AgentError, R as DecisionLogicConfig, S as createTextLogic, T as getCallUsage, U as resolveDecision, V as createDecisionRequest, W as AgentEventDescriptor, X as getAcceptedEvents, Y as EventFromSnapshot, Z as parseAgentEvent, _ as TextLogic, a as AgentModelRef, b as TextLogicExecutor, c as AgentRequestExecutorInfo, f as AgentTextRequest, g as ProviderStructuredOutput, j as AgentDecisionInput, k as AgentDecisionExecutor, l as AgentRequestExecutorResult, m as AgentUsage, n as AgentExecutorTextRequest, o as AgentOutputMode, p as AgentTextResult, q as AgentRequestSource, r as AgentFinishReason, s as AgentRequestExecutor, t as AgentCallUsage, u as AgentRequestExecutors, v as TextLogicConfig, w as getCallFinishReason, x as bindRequestExecutor, y as TextLogicExecuteArgs, z as ResolveDecisionOptions } from "./text-logic-j9hShB7d.cjs";
-import { n as AgentUsageEvent, t as AGENT_USAGE_EVENT_TYPE } from "./usage-BYqv7VBw.cjs";
-import { C as AgentInteractionEventMeta, D as getInteraction, E as eventFromInteraction, O as interactionMetaSchema, S as AgentInteractionEvent, T as GetInteractionOptions, _ as FromConfigResult, a as WithAgentUsageEvent, b as AgentInteractionChoice, c as setupAgent, d as AgentWorkflowConfig, f as AgentWorkflowInvokeConfig, g as FromConfigOptions, h as AgentWorkflowTransitionConfig, i as WithAgentEvents, l as AgentWorkflowActionConfig, m as AgentWorkflowStateConfig, n as AgentSchemaPack, o as createAgentSchemas, p as AgentWorkflowRequestConfig, r as AgentUsageEventPayload, s as getAgentSchemas, t as AgentDefaultMeta, u as AgentWorkflowActorConfig, v as SchemaCompiler, w as AgentInteractionMeta, x as AgentInteractionDescriptor, y as AgentInteraction } from "./setup-agent-yFFVXf5s.cjs";
-import { C as runAgent, D as AgentRequest, E as traceTransitions, O as AgentStepRequest, S as isAgentIdle, T as serializeTraceEvent, _ as AgentTransitionHandler, a as AgentRunErrorCause, b as createAgentRuntime, c as AgentRunOptions, d as AgentRuntime, f as AgentRuntimeOptions, g as AgentTraceEvent, h as AgentTimerScheduler, i as AgentMaxModelCallsExceededError, l as AgentRunResult, m as AgentTimerEvent, n as AgentEffects, o as AgentRunInit, p as AgentSnapshotDivergedError, r as AgentInputFrom, s as AgentRunMeta, t as AGENT_TRACE_SCHEMA_VERSION, u as AgentRunStart, v as InspectedActorRef, w as runToQuiescence, x as inspectTransitions, y as JsonSerializableTraceEvent } from "./run-agent-B5opVUxx.cjs";
-import { c as AgentLogEntry, d as AgentMachineVersionMismatchError, n as AgentEventLogStore, t as AgentEventLogConflictError } from "./event-log-store-DTf_OzB-.cjs";
+import { $ as AgentTruncatedError, A as AgentDecisionExhaustedError, B as createDecisionLogic, C as getAgentOutputMode, D as parseProviderOutput, E as parseOutput, F as CreateDecisionRequestOptions, G as AgentInvalidEventPayloadError, H as renderDecisionAttempts, I as DecisionAttempt, J as AgentSchemas, K as AgentRequestOptions, L as DecisionLogic, M as AgentDecisionOption, N as AgentDecisionRequest, O as providerOutputSchema, P as AgentExecutorDecisionRequest, Q as AgentError, R as DecisionLogicConfig, S as createTextLogic, T as getCallUsage, U as resolveDecision, V as createDecisionRequest, W as AgentEventDescriptor, X as getAcceptedEvents, Y as EventFromSnapshot, Z as parseAgentEvent, _ as TextLogic, a as AgentModelRef, b as TextLogicExecutor, c as AgentRequestExecutorInfo, f as AgentTextRequest, g as ProviderStructuredOutput, j as AgentDecisionInput, k as AgentDecisionExecutor, l as AgentRequestExecutorResult, m as AgentUsage, n as AgentExecutorTextRequest, o as AgentOutputMode, p as AgentTextResult, q as AgentRequestSource, r as AgentFinishReason, s as AgentRequestExecutor, t as AgentCallUsage, u as AgentRequestExecutors, v as TextLogicConfig, w as getCallFinishReason, x as bindRequestExecutor, y as TextLogicExecuteArgs, z as ResolveDecisionOptions } from "./text-logic-CYP502VT.cjs";
+import { n as AgentUsageEvent, t as AGENT_USAGE_EVENT_TYPE } from "./usage-DVw-646x.cjs";
+import { C as AgentInteractionEventMeta, D as getInteraction, E as eventFromInteraction, O as interactionMetaSchema, S as AgentInteractionEvent, T as GetInteractionOptions, _ as FromConfigResult, a as WithAgentUsageEvent, b as AgentInteractionChoice, c as setupAgent, d as AgentWorkflowConfig, f as AgentWorkflowInvokeConfig, g as FromConfigOptions, h as AgentWorkflowTransitionConfig, i as WithAgentEvents, l as AgentWorkflowActionConfig, m as AgentWorkflowStateConfig, n as AgentSchemaPack, o as createAgentSchemas, p as AgentWorkflowRequestConfig, r as AgentUsageEventPayload, s as getAgentSchemas, t as AgentDefaultMeta, u as AgentWorkflowActorConfig, v as SchemaCompiler, w as AgentInteractionMeta, x as AgentInteractionDescriptor, y as AgentInteraction } from "./setup-agent-BiF1N3td.cjs";
+import { C as runAgent, D as AgentRequest, E as traceTransitions, O as AgentStepRequest, S as isAgentIdle, T as serializeTraceEvent, _ as AgentTransitionHandler, a as AgentRunErrorCause, b as createAgentRuntime, c as AgentRunOptions, d as AgentRuntime, f as AgentRuntimeOptions, g as AgentTraceEvent, h as AgentTimerScheduler, i as AgentMaxModelCallsExceededError, l as AgentRunResult, m as AgentTimerEvent, n as AgentEffects, o as AgentRunInit, p as AgentSnapshotDivergedError, r as AgentInputFrom, s as AgentRunMeta, t as AGENT_TRACE_SCHEMA_VERSION, u as AgentRunStart, v as InspectedActorRef, w as runToQuiescence, x as inspectTransitions, y as JsonSerializableTraceEvent } from "./run-agent-B5QhabdY.cjs";
+import { c as AgentLogEntry, d as AgentMachineVersionMismatchError, n as AgentEventLogStore, t as AgentEventLogConflictError } from "./event-log-store-s73r1Hxf.cjs";
 import { a as getMachineStructuralHash, c as getStatePath, d as toolMessage, f as userMessage, i as getJsonSchemaSync, l as isStandardSchema, n as assistantMessage, o as getMessageText, r as getJsonSchema, s as getStateMeta, u as systemMessage } from "./utils-ebVpCYoF.cjs";
 import { AnyActorLogic, AnyMachineSnapshot, AnyStateMachine, ContextFrom, DoneActorEvent, EventFromLogic, InputFrom, OutputFrom, SnapshotFrom, StateValueFrom } from "xstate";
 //#region src/type-helpers.d.ts
@@ -197,9 +197,10 @@ interface PolicyDeciderOptions<TPolicy extends AnyStateMachine> extends Omit<Age
    * retry of one, needs its own thread: a thread that already has entries is
    * resumed, so a shared one would return an earlier decision's choice. Default
    * with a `store`: `policy:${info.callKey}:${hash}`, where `hash` is the
-   * SHA-256 of the policy input's canonical JSON. The call key is unique per call and attempt and stays the
-   * same when a crashed run re-issues the call; the hash keeps a fork that asks
-   * something else at the same call site off the parent's thread. Required
+   * SHA-256 of the policy input's canonical JSON. The call key is unique per
+   * call and attempt and stays the same when a crashed run re-issues the call;
+   * the hash keeps a machine that asks something else at the same call site
+   * after a version bridge, which keeps the call key, off the earlier thread. Required
    * with a `store` when the decider is called without a `callKey`.
    */
   threadId?: (request: AgentExecutorDecisionRequest, info?: AgentRequestExecutorInfo) => string;

package/dist/index.d.mts

@@ -1,9 +1,9 @@
 import { C as UserMessage, S as ToolResultPart, _ as StandardSchemaV1, a as AgentToolDescriptor, b as ToolCallPart, c as AllowedEvents, d as EventUnion, f as FilePart, h as InferOutput, i as AgentToolChoice, l as AssistantMessage, m as InferInput, n as AgentMessage, o as AgentToolExecute, p as ImagePart, r as AgentTool, s as AgentTools, u as ChosenEvent, v as SystemMessage, x as ToolMessage, y as TextPart } from "./types-Dp5_Ru4R.mjs";
-import { $ as AgentTruncatedError, A as AgentDecisionExhaustedError, B as createDecisionLogic, C as getAgentOutputMode, D as parseProviderOutput, E as parseOutput, F as CreateDecisionRequestOptions, G as AgentInvalidEventPayloadError, H as renderDecisionAttempts, I as DecisionAttempt, J as AgentSchemas, K as AgentRequestOptions, L as DecisionLogic, M as AgentDecisionOption, N as AgentDecisionRequest, O as providerOutputSchema, P as AgentExecutorDecisionRequest, Q as AgentError, R as DecisionLogicConfig, S as createTextLogic, T as getCallUsage, U as resolveDecision, V as createDecisionRequest, W as AgentEventDescriptor, X as getAcceptedEvents, Y as EventFromSnapshot, Z as parseAgentEvent, _ as TextLogic, a as AgentModelRef, b as TextLogicExecutor, c as AgentRequestExecutorInfo, f as AgentTextRequest, g as ProviderStructuredOutput, j as AgentDecisionInput, k as AgentDecisionExecutor, l as AgentRequestExecutorResult, m as AgentUsage, n as AgentExecutorTextRequest, o as AgentOutputMode, p as AgentTextResult, q as AgentRequestSource, r as AgentFinishReason, s as AgentRequestExecutor, t as AgentCallUsage, u as AgentRequestExecutors, v as TextLogicConfig, w as getCallFinishReason, x as bindRequestExecutor, y as TextLogicExecuteArgs, z as ResolveDecisionOptions } from "./text-logic-BwdrDpO9.mjs";
-import { n as AgentUsageEvent, t as AGENT_USAGE_EVENT_TYPE } from "./usage-Bl4nK8D-.mjs";
-import { C as AgentInteractionEventMeta, D as getInteraction, E as eventFromInteraction, O as interactionMetaSchema, S as AgentInteractionEvent, T as GetInteractionOptions, _ as FromConfigResult, a as WithAgentUsageEvent, b as AgentInteractionChoice, c as setupAgent, d as AgentWorkflowConfig, f as AgentWorkflowInvokeConfig, g as FromConfigOptions, h as AgentWorkflowTransitionConfig, i as WithAgentEvents, l as AgentWorkflowActionConfig, m as AgentWorkflowStateConfig, n as AgentSchemaPack, o as createAgentSchemas, p as AgentWorkflowRequestConfig, r as AgentUsageEventPayload, s as getAgentSchemas, t as AgentDefaultMeta, u as AgentWorkflowActorConfig, v as SchemaCompiler, w as AgentInteractionMeta, x as AgentInteractionDescriptor, y as AgentInteraction } from "./setup-agent-CPyg2ic7.mjs";
-import { C as runAgent, D as AgentRequest, E as traceTransitions, O as AgentStepRequest, S as isAgentIdle, T as serializeTraceEvent, _ as AgentTransitionHandler, a as AgentRunErrorCause, b as createAgentRuntime, c as AgentRunOptions, d as AgentRuntime, f as AgentRuntimeOptions, g as AgentTraceEvent, h as AgentTimerScheduler, i as AgentMaxModelCallsExceededError, l as AgentRunResult, m as AgentTimerEvent, n as AgentEffects, o as AgentRunInit, p as AgentSnapshotDivergedError, r as AgentInputFrom, s as AgentRunMeta, t as AGENT_TRACE_SCHEMA_VERSION, u as AgentRunStart, v as InspectedActorRef, w as runToQuiescence, x as inspectTransitions, y as JsonSerializableTraceEvent } from "./run-agent-D4MwS5GY.mjs";
-import { c as AgentLogEntry, d as AgentMachineVersionMismatchError, n as AgentEventLogStore, t as AgentEventLogConflictError } from "./event-log-store-RziIobdW.mjs";
+import { $ as AgentTruncatedError, A as AgentDecisionExhaustedError, B as createDecisionLogic, C as getAgentOutputMode, D as parseProviderOutput, E as parseOutput, F as CreateDecisionRequestOptions, G as AgentInvalidEventPayloadError, H as renderDecisionAttempts, I as DecisionAttempt, J as AgentSchemas, K as AgentRequestOptions, L as DecisionLogic, M as AgentDecisionOption, N as AgentDecisionRequest, O as providerOutputSchema, P as AgentExecutorDecisionRequest, Q as AgentError, R as DecisionLogicConfig, S as createTextLogic, T as getCallUsage, U as resolveDecision, V as createDecisionRequest, W as AgentEventDescriptor, X as getAcceptedEvents, Y as EventFromSnapshot, Z as parseAgentEvent, _ as TextLogic, a as AgentModelRef, b as TextLogicExecutor, c as AgentRequestExecutorInfo, f as AgentTextRequest, g as ProviderStructuredOutput, j as AgentDecisionInput, k as AgentDecisionExecutor, l as AgentRequestExecutorResult, m as AgentUsage, n as AgentExecutorTextRequest, o as AgentOutputMode, p as AgentTextResult, q as AgentRequestSource, r as AgentFinishReason, s as AgentRequestExecutor, t as AgentCallUsage, u as AgentRequestExecutors, v as TextLogicConfig, w as getCallFinishReason, x as bindRequestExecutor, y as TextLogicExecuteArgs, z as ResolveDecisionOptions } from "./text-logic-DuK9HIFM.mjs";
+import { n as AgentUsageEvent, t as AGENT_USAGE_EVENT_TYPE } from "./usage-D7JKAxLc.mjs";
+import { C as AgentInteractionEventMeta, D as getInteraction, E as eventFromInteraction, O as interactionMetaSchema, S as AgentInteractionEvent, T as GetInteractionOptions, _ as FromConfigResult, a as WithAgentUsageEvent, b as AgentInteractionChoice, c as setupAgent, d as AgentWorkflowConfig, f as AgentWorkflowInvokeConfig, g as FromConfigOptions, h as AgentWorkflowTransitionConfig, i as WithAgentEvents, l as AgentWorkflowActionConfig, m as AgentWorkflowStateConfig, n as AgentSchemaPack, o as createAgentSchemas, p as AgentWorkflowRequestConfig, r as AgentUsageEventPayload, s as getAgentSchemas, t as AgentDefaultMeta, u as AgentWorkflowActorConfig, v as SchemaCompiler, w as AgentInteractionMeta, x as AgentInteractionDescriptor, y as AgentInteraction } from "./setup-agent-J9f_Wu5T.mjs";
+import { C as runAgent, D as AgentRequest, E as traceTransitions, O as AgentStepRequest, S as isAgentIdle, T as serializeTraceEvent, _ as AgentTransitionHandler, a as AgentRunErrorCause, b as createAgentRuntime, c as AgentRunOptions, d as AgentRuntime, f as AgentRuntimeOptions, g as AgentTraceEvent, h as AgentTimerScheduler, i as AgentMaxModelCallsExceededError, l as AgentRunResult, m as AgentTimerEvent, n as AgentEffects, o as AgentRunInit, p as AgentSnapshotDivergedError, r as AgentInputFrom, s as AgentRunMeta, t as AGENT_TRACE_SCHEMA_VERSION, u as AgentRunStart, v as InspectedActorRef, w as runToQuiescence, x as inspectTransitions, y as JsonSerializableTraceEvent } from "./run-agent-Atu-wEk7.mjs";
+import { c as AgentLogEntry, d as AgentMachineVersionMismatchError, n as AgentEventLogStore, t as AgentEventLogConflictError } from "./event-log-store-C2NjVlWU.mjs";
 import { a as getMachineStructuralHash, c as getStatePath, d as toolMessage, f as userMessage, i as getJsonSchemaSync, l as isStandardSchema, n as assistantMessage, o as getMessageText, r as getJsonSchema, s as getStateMeta, u as systemMessage } from "./utils-BnXdWih3.mjs";
 import { AnyActorLogic, AnyMachineSnapshot, AnyStateMachine, ContextFrom, DoneActorEvent, EventFromLogic, InputFrom, OutputFrom, SnapshotFrom, StateValueFrom } from "xstate";
 //#region src/type-helpers.d.ts
@@ -197,9 +197,10 @@ interface PolicyDeciderOptions<TPolicy extends AnyStateMachine> extends Omit<Age
    * retry of one, needs its own thread: a thread that already has entries is
    * resumed, so a shared one would return an earlier decision's choice. Default
    * with a `store`: `policy:${info.callKey}:${hash}`, where `hash` is the
-   * SHA-256 of the policy input's canonical JSON. The call key is unique per call and attempt and stays the
-   * same when a crashed run re-issues the call; the hash keeps a fork that asks
-   * something else at the same call site off the parent's thread. Required
+   * SHA-256 of the policy input's canonical JSON. The call key is unique per
+   * call and attempt and stays the same when a crashed run re-issues the call;
+   * the hash keeps a machine that asks something else at the same call site
+   * after a version bridge, which keeps the call key, off the earlier thread. Required
    * with a `store` when the decider is called without a `callKey`.
    */
   threadId?: (request: AgentExecutorDecisionRequest, info?: AgentRequestExecutorInfo) => string;

package/dist/index.mjs

@@ -1,8 +1,8 @@
-import { $ as getStateMeta, A as createTextLogic, C as AGENT_USAGE_EVENT_TYPE, H as getAgentExecutionOptions, I as parseOutput, L as parseProviderOutput, M as getCallFinishReason, N as getCallUsage, O as bindRequestExecutor, P as isTextLogic, Q as getMessageText, R as providerOutputSchema, V as executorBoundLogics, X as getJsonSchemaSync, Y as getJsonSchema, Z as getMachineStructuralHash, at as userMessage, dt as AgentTruncatedError, et as getStatePath, i as AgentMachineVersionMismatchError, it as toolMessage, j as getAgentOutputMode, l as assertJsonSerializable, lt as isRecord, q as assistantMessage, rt as systemMessage, tt as isStandardSchema, u as canonicalEventJson, ut as AgentError } from "./event-log-DE430ZCa.mjs";
-import { a as createDecisionRequest, c as renderDecisionAttempts, d as getAcceptedEvents, f as getHumanEventTypes, i as createDecisionLogic, l as resolveDecision, m as parseAgentEvent, p as isEventPattern, s as isDecisionLogic, t as AgentDecisionExhaustedError, u as AgentInvalidEventPayloadError } from "./decision-DqO018Tp.mjs";
-import { n as getAgentSchemas, r as setupAgent, t as createAgentSchemas } from "./setup-agent-BaffhCcM.mjs";
-import { t as AgentEventLogConflictError } from "./event-log-store-CCWdTPEP.mjs";
-import { a as bindDecisionForProvide, c as getConfiguredInvokeSrcs, d as isStateMachineLogic, f as runAgent, h as traceTransitions, i as bindChildMachineForProvide, l as inspectTransitions, m as serializeTraceEvent, n as AgentMaxModelCallsExceededError, o as bindTextForProvide, p as runToQuiescence, r as AgentSnapshotDivergedError, s as createAgentRuntime, t as AGENT_TRACE_SCHEMA_VERSION, u as isAgentIdle } from "./run-agent-DWZ1uyBJ.mjs";
+import { $ as getStateMeta, A as createTextLogic, C as AGENT_USAGE_EVENT_TYPE, H as getAgentExecutionOptions, I as parseOutput, L as parseProviderOutput, M as getCallFinishReason, N as getCallUsage, O as bindRequestExecutor, P as isTextLogic, Q as getMessageText, R as providerOutputSchema, V as executorBoundLogics, X as getJsonSchemaSync, Y as getJsonSchema, Z as getMachineStructuralHash, at as userMessage, dt as AgentTruncatedError, et as getStatePath, i as AgentMachineVersionMismatchError, it as toolMessage, j as getAgentOutputMode, l as assertJsonSerializable, lt as isRecord, q as assistantMessage, rt as systemMessage, tt as isStandardSchema, u as canonicalEventJson, ut as AgentError } from "./event-log-DAqsalT1.mjs";
+import { a as createDecisionRequest, c as renderDecisionAttempts, d as getAcceptedEvents, f as getHumanEventTypes, i as createDecisionLogic, l as resolveDecision, m as parseAgentEvent, p as isEventPattern, s as isDecisionLogic, t as AgentDecisionExhaustedError, u as AgentInvalidEventPayloadError } from "./decision-CV7WiV5C.mjs";
+import { n as getAgentSchemas, r as setupAgent, t as createAgentSchemas } from "./setup-agent-CmhB-U5P.mjs";
+import { t as AgentEventLogConflictError } from "./event-log-store-BGehvVTb.mjs";
+import { a as bindDecisionForProvide, c as getConfiguredInvokeSrcs, d as isStateMachineLogic, f as runAgent, h as traceTransitions, i as bindChildMachineForProvide, l as inspectTransitions, m as serializeTraceEvent, n as AgentMaxModelCallsExceededError, o as bindTextForProvide, p as runToQuiescence, r as AgentSnapshotDivergedError, s as createAgentRuntime, t as AGENT_TRACE_SCHEMA_VERSION, u as isAgentIdle } from "./run-agent-2UnSUhDb.mjs";
 import { getNextTransitions, machineToJSON, transition } from "xstate";
 //#region src/messages.ts
 const KNOWN_PART_TYPES = /* @__PURE__ */ new Set([

package/dist/log.cjs

@@ -1,6 +1,6 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
-const require_event_log = require("./event-log-Bdww2l1D.cjs");
-const require_event_log_store = require("./event-log-store-BWMLi6oh.cjs");
+const require_event_log = require("./event-log-CKWeC7H-.cjs");
+const require_event_log_store = require("./event-log-store-DKyE7JKr.cjs");
 //#region src/event-log-store-conformance.ts
 /**
 * The runner-agnostic conformance suite for {@link AgentEventLogStore}
@@ -30,8 +30,11 @@ function entry(index, type, metadata) {
 		...metadata !== void 0 ? { metadata } : {}
 	};
 }
+function initFixture(executionId = "exec-src") {
+	return entry(0, require_event_log.AGENT_INIT_EVENT_TYPE, { executionId });
+}
 function entriesFrom(start, count) {
-	return Array.from({ length: count }, (_unused, i) => entry(start + i, `e${start + i}`));
+	return Array.from({ length: count }, (_unused, i) => start + i === 0 ? initFixture() : entry(start + i, `e${start + i}`));
 }
 function assertJsonEqual(actual, expected, message) {
 	const a = JSON.stringify(actual);
@@ -281,10 +284,42 @@ const cases = [
 				expectedIndex: 1,
 				entries: [entry(1, "branch")]
 			});
-			assertJsonEqual((await store.read("fork-1")).map((e) => e.event.type), ["e0", "branch"], "a forked thread must append independently from its copied length");
+			assertJsonEqual((await store.read("fork-1")).map((e) => e.event.type), [require_event_log.AGENT_INIT_EVENT_TYPE, "branch"], "a forked thread must append independently from its copied length");
 			if (await store.length("src") !== 3) fail("appending to a fork must not touch the source thread");
 		}
 	},
+	{
+		name: "a fork is its own lineage: a fresh executionId, and forkedFrom naming the parent",
+		async run(create) {
+			const store = await create();
+			const source = entriesFrom(0, 3);
+			await store.append({
+				threadId: "src",
+				expectedIndex: 0,
+				entries: source
+			});
+			await store.fork({
+				threadId: "src",
+				newThreadId: "fork-a",
+				upToIndex: 2
+			});
+			await store.fork({
+				threadId: "src",
+				newThreadId: "fork-b",
+				upToIndex: 2
+			});
+			const [a, b] = [await store.read("fork-a"), await store.read("fork-b")];
+			const ids = [require_event_log.getLogExecutionId(a), require_event_log.getLogExecutionId(b)];
+			if (typeof ids[0] !== "string" || typeof ids[1] !== "string") fail("a fork's init entry must carry a string metadata.executionId");
+			if (ids.includes("exec-src") || ids[0] === ids[1]) fail("every fork must mint its own executionId, not reuse the parent's or a sibling's");
+			assertJsonEqual(a[0].metadata?.forkedFrom, {
+				executionId: "exec-src",
+				logIndex: 2
+			}, "a fork's init entry must record forkedFrom: { executionId, logIndex }");
+			assertJsonEqual(a.slice(1), source.slice(1, 2), "a fork must copy every entry after the init entry unchanged");
+			assertJsonEqual(await store.read("src"), source, "forking must not touch the source thread");
+		}
+	},
 	{
 		name: "fork rejects a non-empty target, an unknown source, and an out-of-range cutoff (0 included)",
 		async run(create) {
@@ -357,7 +392,7 @@ const cases = [
 			]) await store.append({
 				threadId,
 				expectedIndex: 0,
-				entries: [entry(0, "start")]
+				entries: [initFixture()]
 			});
 			await store.fork({
 				threadId: "user:a",

package/dist/log.d.cts

@@ -1,4 +1,4 @@
-import { A as rebindActorSession, C as createReplayEntry, D as getSnapshotStateHash, E as getLogExecutionId, M as replay, N as validateReplayEntries, O as getUsageFromEvents, S as assertJsonSerializable, T as getDecisionAttempts, _ as NonSerializableAgentEventError, a as AGENT_INIT_EVENT_TYPE, b as agentCallOccurrence, c as AgentLogEntry, d as AgentMachineVersionMismatchError, f as AgentPersistedSnapshot, g as LogRecorder, h as JsonValue, i as AGENT_EVENT_SCHEMA_VERSION, j as recordLog, k as initEntry, l as AgentLogInit, m as CreateReplayEntryOptions, n as AgentEventLogStore, o as AgentEventLogError, p as AgentReplayDivergenceError, r as createInMemoryEventLogStore, s as AgentInitEvent, t as AgentEventLogConflictError, u as AgentLogVerification, v as ReplayOptions, w as forkEventLog, x as assertAgentLogEntry, y as ReplayResult } from "./event-log-store-DTf_OzB-.cjs";
+import { A as rebindActorSession, C as createReplayEntry, D as getSnapshotStateHash, E as getLogExecutionId, M as replay, N as validateReplayEntries, O as getUsageFromEvents, S as assertJsonSerializable, T as getDecisionAttempts, _ as NonSerializableAgentEventError, a as AGENT_INIT_EVENT_TYPE, b as agentCallOccurrence, c as AgentLogEntry, d as AgentMachineVersionMismatchError, f as AgentPersistedSnapshot, g as LogRecorder, h as JsonValue, i as AGENT_EVENT_SCHEMA_VERSION, j as recordLog, k as initEntry, l as AgentLogInit, m as CreateReplayEntryOptions, n as AgentEventLogStore, o as AgentEventLogError, p as AgentReplayDivergenceError, r as createInMemoryEventLogStore, s as AgentInitEvent, t as AgentEventLogConflictError, u as AgentLogVerification, v as ReplayOptions, w as forkEventLog, x as assertAgentLogEntry, y as ReplayResult } from "./event-log-store-s73r1Hxf.cjs";
 //#region src/event-log-store-conformance.d.ts
 /** Produces a fresh, empty store for one case. */
 type CreateStore = () => Promise<AgentEventLogStore> | AgentEventLogStore;

package/dist/log.d.mts

@@ -1,4 +1,4 @@
-import { A as rebindActorSession, C as createReplayEntry, D as getSnapshotStateHash, E as getLogExecutionId, M as replay, N as validateReplayEntries, O as getUsageFromEvents, S as assertJsonSerializable, T as getDecisionAttempts, _ as NonSerializableAgentEventError, a as AGENT_INIT_EVENT_TYPE, b as agentCallOccurrence, c as AgentLogEntry, d as AgentMachineVersionMismatchError, f as AgentPersistedSnapshot, g as LogRecorder, h as JsonValue, i as AGENT_EVENT_SCHEMA_VERSION, j as recordLog, k as initEntry, l as AgentLogInit, m as CreateReplayEntryOptions, n as AgentEventLogStore, o as AgentEventLogError, p as AgentReplayDivergenceError, r as createInMemoryEventLogStore, s as AgentInitEvent, t as AgentEventLogConflictError, u as AgentLogVerification, v as ReplayOptions, w as forkEventLog, x as assertAgentLogEntry, y as ReplayResult } from "./event-log-store-RziIobdW.mjs";
+import { A as rebindActorSession, C as createReplayEntry, D as getSnapshotStateHash, E as getLogExecutionId, M as replay, N as validateReplayEntries, O as getUsageFromEvents, S as assertJsonSerializable, T as getDecisionAttempts, _ as NonSerializableAgentEventError, a as AGENT_INIT_EVENT_TYPE, b as agentCallOccurrence, c as AgentLogEntry, d as AgentMachineVersionMismatchError, f as AgentPersistedSnapshot, g as LogRecorder, h as JsonValue, i as AGENT_EVENT_SCHEMA_VERSION, j as recordLog, k as initEntry, l as AgentLogInit, m as CreateReplayEntryOptions, n as AgentEventLogStore, o as AgentEventLogError, p as AgentReplayDivergenceError, r as createInMemoryEventLogStore, s as AgentInitEvent, t as AgentEventLogConflictError, u as AgentLogVerification, v as ReplayOptions, w as forkEventLog, x as assertAgentLogEntry, y as ReplayResult } from "./event-log-store-C2NjVlWU.mjs";
 //#region src/event-log-store-conformance.d.ts
 /** Produces a fresh, empty store for one case. */
 type CreateStore = () => Promise<AgentEventLogStore> | AgentEventLogStore;

package/dist/log.mjs

@@ -1,5 +1,5 @@
-import { S as validateReplayEntries, _ as getUsageFromEvents, a as AgentReplayDivergenceError, b as recordLog, c as assertAgentLogEntry, d as createReplayEntry, g as getSnapshotStateHash, h as getLogExecutionId, i as AgentMachineVersionMismatchError, l as assertJsonSerializable, m as getDecisionAttempts, n as AGENT_INIT_EVENT_TYPE, o as NonSerializableAgentEventError, p as forkEventLog, r as AgentEventLogError, s as agentCallOccurrence, t as AGENT_EVENT_SCHEMA_VERSION, v as initEntry, x as replay, y as rebindActorSession } from "./event-log-DE430ZCa.mjs";
-import { n as createInMemoryEventLogStore, t as AgentEventLogConflictError } from "./event-log-store-CCWdTPEP.mjs";
+import { S as validateReplayEntries, _ as getUsageFromEvents, a as AgentReplayDivergenceError, b as recordLog, c as assertAgentLogEntry, d as createReplayEntry, g as getSnapshotStateHash, h as getLogExecutionId, i as AgentMachineVersionMismatchError, l as assertJsonSerializable, m as getDecisionAttempts, n as AGENT_INIT_EVENT_TYPE, o as NonSerializableAgentEventError, p as forkEventLog, r as AgentEventLogError, s as agentCallOccurrence, t as AGENT_EVENT_SCHEMA_VERSION, v as initEntry, x as replay, y as rebindActorSession } from "./event-log-DAqsalT1.mjs";
+import { n as createInMemoryEventLogStore, t as AgentEventLogConflictError } from "./event-log-store-BGehvVTb.mjs";
 //#region src/event-log-store-conformance.ts
 /**
 * The runner-agnostic conformance suite for {@link AgentEventLogStore}
@@ -29,8 +29,11 @@ function entry(index, type, metadata) {
 		...metadata !== void 0 ? { metadata } : {}
 	};
 }
+function initFixture(executionId = "exec-src") {
+	return entry(0, AGENT_INIT_EVENT_TYPE, { executionId });
+}
 function entriesFrom(start, count) {
-	return Array.from({ length: count }, (_unused, i) => entry(start + i, `e${start + i}`));
+	return Array.from({ length: count }, (_unused, i) => start + i === 0 ? initFixture() : entry(start + i, `e${start + i}`));
 }
 function assertJsonEqual(actual, expected, message) {
 	const a = JSON.stringify(actual);
@@ -280,10 +283,42 @@ const cases = [
 				expectedIndex: 1,
 				entries: [entry(1, "branch")]
 			});
-			assertJsonEqual((await store.read("fork-1")).map((e) => e.event.type), ["e0", "branch"], "a forked thread must append independently from its copied length");
+			assertJsonEqual((await store.read("fork-1")).map((e) => e.event.type), [AGENT_INIT_EVENT_TYPE, "branch"], "a forked thread must append independently from its copied length");
 			if (await store.length("src") !== 3) fail("appending to a fork must not touch the source thread");
 		}
 	},
+	{
+		name: "a fork is its own lineage: a fresh executionId, and forkedFrom naming the parent",
+		async run(create) {
+			const store = await create();
+			const source = entriesFrom(0, 3);
+			await store.append({
+				threadId: "src",
+				expectedIndex: 0,
+				entries: source
+			});
+			await store.fork({
+				threadId: "src",
+				newThreadId: "fork-a",
+				upToIndex: 2
+			});
+			await store.fork({
+				threadId: "src",
+				newThreadId: "fork-b",
+				upToIndex: 2
+			});
+			const [a, b] = [await store.read("fork-a"), await store.read("fork-b")];
+			const ids = [getLogExecutionId(a), getLogExecutionId(b)];
+			if (typeof ids[0] !== "string" || typeof ids[1] !== "string") fail("a fork's init entry must carry a string metadata.executionId");
+			if (ids.includes("exec-src") || ids[0] === ids[1]) fail("every fork must mint its own executionId, not reuse the parent's or a sibling's");
+			assertJsonEqual(a[0].metadata?.forkedFrom, {
+				executionId: "exec-src",
+				logIndex: 2
+			}, "a fork's init entry must record forkedFrom: { executionId, logIndex }");
+			assertJsonEqual(a.slice(1), source.slice(1, 2), "a fork must copy every entry after the init entry unchanged");
+			assertJsonEqual(await store.read("src"), source, "forking must not touch the source thread");
+		}
+	},
 	{
 		name: "fork rejects a non-empty target, an unknown source, and an out-of-range cutoff (0 included)",
 		async run(create) {
@@ -356,7 +391,7 @@ const cases = [
 			]) await store.append({
 				threadId,
 				expectedIndex: 0,
-				entries: [entry(0, "start")]
+				entries: [initFixture()]
 			});
 			await store.fork({
 				threadId: "user:a",

package/dist/machines.cjs

@@ -1,5 +1,5 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
-const require_setup_agent = require("./setup-agent-D0L8Anl_.cjs");
+const require_setup_agent = require("./setup-agent-CwUJyqKB.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-BaffhCcM.mjs";
+import { r as setupAgent } from "./setup-agent-CmhB-U5P.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/{model-source-DQ7KgJaT.cjs → model-source-BQ97_l1-.cjs}

@@ -1,4 +1,4 @@
-const require_event_log = require("./event-log-Bdww2l1D.cjs");
+const require_event_log = require("./event-log-CKWeC7H-.cjs");
 //#region src/internal/model-source.ts
 function hasEntries(value) {
 	return require_event_log.isRecord(value) && Object.keys(value).length > 0;

package/dist/{model-source-CXsSZPq0.mjs → model-source-BilDEyqk.mjs}

@@ -1,4 +1,4 @@
-import { H as getAgentExecutionOptions, lt as isRecord } from "./event-log-DE430ZCa.mjs";
+import { H as getAgentExecutionOptions, lt as isRecord } from "./event-log-DAqsalT1.mjs";
 //#region src/internal/model-source.ts
 function hasEntries(value) {
 	return isRecord(value) && Object.keys(value).length > 0;

package/dist/openai.cjs

@@ -1,6 +1,6 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
-const require_event_log = require("./event-log-Bdww2l1D.cjs");
-const require_decision = require("./decision-Iys2hzg3.cjs");
+const require_event_log = require("./event-log-CKWeC7H-.cjs");
+const require_decision = require("./decision-BPdEaxPf.cjs");
 //#region src/openai/index.ts
 /** Thrown for a message part Chat Completions cannot carry — dropping it would
 * silently change what the model sees. */

package/dist/openai.d.cts

@@ -1,5 +1,5 @@
 import { i as AgentToolChoice, n as AgentMessage, s as AgentTools, u as ChosenEvent } from "./types-Dp5_Ru4R.cjs";
-import { N as AgentDecisionRequest, W as AgentEventDescriptor, c as AgentRequestExecutorInfo, f as AgentTextRequest, r as AgentFinishReason, t as AgentCallUsage } from "./text-logic-j9hShB7d.cjs";
+import { N as AgentDecisionRequest, W as AgentEventDescriptor, c as AgentRequestExecutorInfo, f as AgentTextRequest, r as AgentFinishReason, t as AgentCallUsage } from "./text-logic-CYP502VT.cjs";
 import OpenAI from "openai";
 import { ChatCompletion, ChatCompletionCreateParamsNonStreaming, ChatCompletionMessageParam, ChatCompletionTool } from "openai/resources/chat/completions/completions.js";
 //#region src/openai/index.d.ts

package/dist/openai.d.mts

@@ -1,5 +1,5 @@
 import { i as AgentToolChoice, n as AgentMessage, s as AgentTools, u as ChosenEvent } from "./types-Dp5_Ru4R.mjs";
-import { N as AgentDecisionRequest, W as AgentEventDescriptor, c as AgentRequestExecutorInfo, f as AgentTextRequest, r as AgentFinishReason, t as AgentCallUsage } from "./text-logic-BwdrDpO9.mjs";
+import { N as AgentDecisionRequest, W as AgentEventDescriptor, c as AgentRequestExecutorInfo, f as AgentTextRequest, r as AgentFinishReason, t as AgentCallUsage } from "./text-logic-DuK9HIFM.mjs";
 import OpenAI from "openai";
 import { ChatCompletion, ChatCompletionCreateParamsNonStreaming, ChatCompletionMessageParam, ChatCompletionTool } from "openai/resources/chat/completions/completions.js";
 //#region src/openai/index.d.ts

package/dist/openai.mjs

@@ -1,5 +1,5 @@
-import { L as parseProviderOutput, R as providerOutputSchema, X as getJsonSchemaSync, Y as getJsonSchema, dt as AgentTruncatedError, j as getAgentOutputMode, tt as isStandardSchema, w as AGENT_USAGE_TOKEN_FIELDS } from "./event-log-DE430ZCa.mjs";
-import { c as renderDecisionAttempts } from "./decision-DqO018Tp.mjs";
+import { L as parseProviderOutput, R as providerOutputSchema, X as getJsonSchemaSync, Y as getJsonSchema, dt as AgentTruncatedError, j as getAgentOutputMode, tt as isStandardSchema, w as AGENT_USAGE_TOKEN_FIELDS } from "./event-log-DAqsalT1.mjs";
+import { c as renderDecisionAttempts } from "./decision-CV7WiV5C.mjs";
 //#region src/openai/index.ts
 /** Thrown for a message part Chat Completions cannot carry — dropping it would
 * silently change what the model sees. */

package/dist/otel.d.cts

@@ -1,4 +1,4 @@
-import { g as AgentTraceEvent } from "./run-agent-B5opVUxx.cjs";
+import { g as AgentTraceEvent } from "./run-agent-B5QhabdY.cjs";
 import { Attributes, Tracer, TracerProvider } from "@opentelemetry/api";
 //#region src/otel/index.d.ts
 /** Options for {@link createOtelTraceHandler}. */

package/dist/otel.d.mts

@@ -1,4 +1,4 @@
-import { g as AgentTraceEvent } from "./run-agent-D4MwS5GY.mjs";
+import { g as AgentTraceEvent } from "./run-agent-Atu-wEk7.mjs";
 import { Attributes, Tracer, TracerProvider } from "@opentelemetry/api";
 //#region src/otel/index.d.ts
 /** Options for {@link createOtelTraceHandler}. */

package/dist/{run-agent-DWZ1uyBJ.mjs → run-agent-2UnSUhDb.mjs}

@@ -1,6 +1,6 @@
-import { B as responseMessagesOf, C as AGENT_USAGE_EVENT_TYPE, F as normalizeGeneratorResult, J as findNonSerializableContextPaths, M as getCallFinishReason, N as getCallUsage, P as isTextLogic, S as validateReplayEntries, U as getRegisteredAgentExecutionOptions, V as executorBoundLogics, W as isUnboundPlaceholder, _ as getUsageFromEvents, d as createReplayEntry, f as foldLog, g as getSnapshotStateHash, h as getLogExecutionId, i as AgentMachineVersionMismatchError, l as assertJsonSerializable, nt as resolveMachineVersion, ot as validateSchemaSync, s as agentCallOccurrence, st as canonicalJson, tt as isStandardSchema, u as canonicalEventJson, ut as AgentError, v as initEntry, x as replay } from "./event-log-DE430ZCa.mjs";
-import { d as getAcceptedEvents, f as getHumanEventTypes, l as resolveDecision, n as acceptedDecisionOptions, s as isDecisionLogic, t as AgentDecisionExhaustedError } from "./decision-DqO018Tp.mjs";
-import { t as AgentEventLogConflictError } from "./event-log-store-CCWdTPEP.mjs";
+import { B as responseMessagesOf, C as AGENT_USAGE_EVENT_TYPE, F as normalizeGeneratorResult, J as findNonSerializableContextPaths, M as getCallFinishReason, N as getCallUsage, P as isTextLogic, S as validateReplayEntries, U as getRegisteredAgentExecutionOptions, V as executorBoundLogics, W as isUnboundPlaceholder, _ as getUsageFromEvents, d as createReplayEntry, f as foldLog, g as getSnapshotStateHash, h as getLogExecutionId, i as AgentMachineVersionMismatchError, l as assertJsonSerializable, nt as resolveMachineVersion, ot as validateSchemaSync, s as agentCallOccurrence, st as canonicalJson, tt as isStandardSchema, u as canonicalEventJson, ut as AgentError, v as initEntry, x as replay } from "./event-log-DAqsalT1.mjs";
+import { d as getAcceptedEvents, f as getHumanEventTypes, l as resolveDecision, n as acceptedDecisionOptions, s as isDecisionLogic, t as AgentDecisionExhaustedError } from "./decision-CV7WiV5C.mjs";
+import { t as AgentEventLogConflictError } from "./event-log-store-BGehvVTb.mjs";
 import { createAsyncLogic, getNextTransitions, isMachineSnapshot, stopActor } from "xstate";
 import { createDurable } from "xstate/durable";
 //#region src/run-agent.ts
@@ -886,7 +886,7 @@ function assertThreadMatchesEvents(threadId, stored, events) {
 		const givenEntry = events[index];
 		const storedHash = storedEntry.verification?.stateHash;
 		const givenHash = givenEntry.verification?.stateHash;
-		if (!(storedEntry.id === givenEntry.id && storedEntry.index === givenEntry.index && canonicalEventJson(storedEntry.event) === canonicalEventJson(givenEntry.event) && (storedHash === void 0 || givenHash === void 0 || storedHash === givenHash))) throw new AgentError("event-log-conflict", `createAgentRuntime: the given \`events\` diverge from thread "${threadId}" at index ${index} (stored entry '${storedEntry.id}', given '${givenEntry.id}') — the log passed in is not this thread's log.`);
+		if (!(storedEntry.id === givenEntry.id && storedEntry.index === givenEntry.index && canonicalEventJson(storedEntry.event) === canonicalEventJson(givenEntry.event) && (storedHash === void 0 || givenHash === void 0 || storedHash === givenHash) && (index > 0 || getLogExecutionId([storedEntry]) === getLogExecutionId([givenEntry])))) throw new AgentError("event-log-conflict", `createAgentRuntime: the given \`events\` diverge from thread "${threadId}" at index ${index} (stored entry '${storedEntry.id}', given '${givenEntry.id}') — the log passed in is not this thread's log.`);
 	}
 }
 const QUIESCENT = Symbol("quiescent");
@@ -1407,7 +1407,9 @@ function createAgentRuntime(machine, options = {}) {
 						machineVersion: tail.machineVersion
 					});
 					const bridgeMeta = readAgentMeta(init.snapshot);
-					if (inheritedExecutionId === void 0 || bridgeMeta?.logId !== inheritedExecutionId) throw new AgentMachineVersionMismatchError(tail.id, tail.index, {
+					const forkedFrom = resumeEvents[0].metadata?.forkedFrom;
+					const parentCache = forkedFrom?.executionId !== void 0 && bridgeMeta?.logId === forkedFrom.executionId && forkedFrom.logIndex === resumeEvents.length;
+					if (inheritedExecutionId === void 0 || bridgeMeta?.logId !== inheritedExecutionId && !parentCache) throw new AgentMachineVersionMismatchError(tail.id, tail.index, {
 						machineId,
 						machineVersion
 					}, {

package/dist/{run-agent-D4MwS5GY.d.mts → run-agent-Atu-wEk7.d.mts}

@@ -1,7 +1,7 @@
 import { _ as StandardSchemaV1, m as InferInput, s as AgentTools, w as WithAgentInputSchema } from "./types-Dp5_Ru4R.mjs";
-import { I as DecisionAttempt, N as AgentDecisionRequest, Q as AgentError, W as AgentEventDescriptor, d as AgentRequestMode, f as AgentTextRequest, m as AgentUsage, q as AgentRequestSource, r as AgentFinishReason, t as AgentCallUsage, u as AgentRequestExecutors } from "./text-logic-BwdrDpO9.mjs";
-import { n as AgentUsageEvent } from "./usage-Bl4nK8D-.mjs";
-import { c as AgentLogEntry, h as JsonValue$1, n as AgentEventLogStore } from "./event-log-store-RziIobdW.mjs";
+import { I as DecisionAttempt, N as AgentDecisionRequest, Q as AgentError, W as AgentEventDescriptor, d as AgentRequestMode, f as AgentTextRequest, m as AgentUsage, q as AgentRequestSource, r as AgentFinishReason, t as AgentCallUsage, u as AgentRequestExecutors } from "./text-logic-DuK9HIFM.mjs";
+import { n as AgentUsageEvent } from "./usage-D7JKAxLc.mjs";
+import { c as AgentLogEntry, h as JsonValue$1, n as AgentEventLogStore } from "./event-log-store-C2NjVlWU.mjs";
 import { AnyActorLogic, AnyActorRef, AnyMachineSnapshot, AnyStateMachine, AsyncActorLogic, EmittedFrom, EventFromLogic, EventObject, InputFrom, InspectionEvent, OutputFrom, Snapshot, SnapshotFrom, StateValue } from "xstate";
 import { DurableExecution } from "xstate/durable";
 //#region src/steps.d.ts

package/dist/{run-agent-B5opVUxx.d.cts → run-agent-B5QhabdY.d.cts}

@@ -1,7 +1,7 @@
 import { _ as StandardSchemaV1, m as InferInput, s as AgentTools, w as WithAgentInputSchema } from "./types-Dp5_Ru4R.cjs";
-import { I as DecisionAttempt, N as AgentDecisionRequest, Q as AgentError, W as AgentEventDescriptor, d as AgentRequestMode, f as AgentTextRequest, m as AgentUsage, q as AgentRequestSource, r as AgentFinishReason, t as AgentCallUsage, u as AgentRequestExecutors } from "./text-logic-j9hShB7d.cjs";
-import { n as AgentUsageEvent } from "./usage-BYqv7VBw.cjs";
-import { c as AgentLogEntry, h as JsonValue$1, n as AgentEventLogStore } from "./event-log-store-DTf_OzB-.cjs";
+import { I as DecisionAttempt, N as AgentDecisionRequest, Q as AgentError, W as AgentEventDescriptor, d as AgentRequestMode, f as AgentTextRequest, m as AgentUsage, q as AgentRequestSource, r as AgentFinishReason, t as AgentCallUsage, u as AgentRequestExecutors } from "./text-logic-CYP502VT.cjs";
+import { n as AgentUsageEvent } from "./usage-DVw-646x.cjs";
+import { c as AgentLogEntry, h as JsonValue$1, n as AgentEventLogStore } from "./event-log-store-s73r1Hxf.cjs";
 import { AnyActorLogic, AnyActorRef, AnyMachineSnapshot, AnyStateMachine, AsyncActorLogic, EmittedFrom, EventFromLogic, EventObject, InputFrom, InspectionEvent, OutputFrom, Snapshot, SnapshotFrom, StateValue } from "xstate";
 import { DurableExecution } from "xstate/durable";
 //#region src/steps.d.ts

package/dist/{run-agent-tmk58M0x.cjs → run-agent-Cg0xd3K-.cjs}

@@ -1,6 +1,6 @@
-const require_event_log = require("./event-log-Bdww2l1D.cjs");
-const require_decision = require("./decision-Iys2hzg3.cjs");
-const require_event_log_store = require("./event-log-store-BWMLi6oh.cjs");
+const require_event_log = require("./event-log-CKWeC7H-.cjs");
+const require_decision = require("./decision-BPdEaxPf.cjs");
+const require_event_log_store = require("./event-log-store-DKyE7JKr.cjs");
 let xstate = require("xstate");
 let xstate_durable = require("xstate/durable");
 //#region src/run-agent.ts
@@ -886,7 +886,7 @@ function assertThreadMatchesEvents(threadId, stored, events) {
 		const givenEntry = events[index];
 		const storedHash = storedEntry.verification?.stateHash;
 		const givenHash = givenEntry.verification?.stateHash;
-		if (!(storedEntry.id === givenEntry.id && storedEntry.index === givenEntry.index && require_event_log.canonicalEventJson(storedEntry.event) === require_event_log.canonicalEventJson(givenEntry.event) && (storedHash === void 0 || givenHash === void 0 || storedHash === givenHash))) throw new require_event_log.AgentError("event-log-conflict", `createAgentRuntime: the given \`events\` diverge from thread "${threadId}" at index ${index} (stored entry '${storedEntry.id}', given '${givenEntry.id}') — the log passed in is not this thread's log.`);
+		if (!(storedEntry.id === givenEntry.id && storedEntry.index === givenEntry.index && require_event_log.canonicalEventJson(storedEntry.event) === require_event_log.canonicalEventJson(givenEntry.event) && (storedHash === void 0 || givenHash === void 0 || storedHash === givenHash) && (index > 0 || require_event_log.getLogExecutionId([storedEntry]) === require_event_log.getLogExecutionId([givenEntry])))) throw new require_event_log.AgentError("event-log-conflict", `createAgentRuntime: the given \`events\` diverge from thread "${threadId}" at index ${index} (stored entry '${storedEntry.id}', given '${givenEntry.id}') — the log passed in is not this thread's log.`);
 	}
 }
 const QUIESCENT = Symbol("quiescent");
@@ -1407,7 +1407,9 @@ function createAgentRuntime(machine, options = {}) {
 						machineVersion: tail.machineVersion
 					});
 					const bridgeMeta = readAgentMeta(init.snapshot);
-					if (inheritedExecutionId === void 0 || bridgeMeta?.logId !== inheritedExecutionId) throw new require_event_log.AgentMachineVersionMismatchError(tail.id, tail.index, {
+					const forkedFrom = resumeEvents[0].metadata?.forkedFrom;
+					const parentCache = forkedFrom?.executionId !== void 0 && bridgeMeta?.logId === forkedFrom.executionId && forkedFrom.logIndex === resumeEvents.length;
+					if (inheritedExecutionId === void 0 || bridgeMeta?.logId !== inheritedExecutionId && !parentCache) throw new require_event_log.AgentMachineVersionMismatchError(tail.id, tail.index, {
 						machineId,
 						machineVersion
 					}, {

package/dist/{setup-agent-yFFVXf5s.d.cts → setup-agent-BiF1N3td.d.cts}

@@ -1,6 +1,6 @@
 import { _ as StandardSchemaV1, d as EventUnion, g as NormalizedEventSchemas, h as InferOutput, i as AgentToolChoice, m as InferInput, s as AgentTools, t as AgentEventSchemaInputMap, w as WithAgentInputSchema } from "./types-Dp5_Ru4R.cjs";
-import { J as AgentSchemas, Y as EventFromSnapshot, _ as TextLogic, a as AgentModelRef, d as AgentRequestMode, h as BuiltinAgentActors, i as AgentModelMap, v as TextLogicConfig } from "./text-logic-j9hShB7d.cjs";
-import { n as AgentUsageEvent, t as AGENT_USAGE_EVENT_TYPE } from "./usage-BYqv7VBw.cjs";
+import { J as AgentSchemas, Y as EventFromSnapshot, _ as TextLogic, a as AgentModelRef, d as AgentRequestMode, h as BuiltinAgentActors, i as AgentModelMap, v as TextLogicConfig } from "./text-logic-CYP502VT.cjs";
+import { n as AgentUsageEvent, t as AGENT_USAGE_EVENT_TYPE } from "./usage-DVw-646x.cjs";
 import { AnyActorLogic, AnyMachineSnapshot, AnySetupConfig, AnyStateMachine, AsyncActorLogic, EventObject, MachineContext, MetaObject, NonReducibleUnknown, SetupReturnFromConfig, SetupStateSchema } from "xstate";
 //#region src/interaction.d.ts
 interface AgentInteractionEvent<TType extends string = string> {

package/dist/{setup-agent-BaffhCcM.mjs → setup-agent-CmhB-U5P.mjs}

@@ -1,5 +1,5 @@
-import { A as createTextLogic, C as AGENT_USAGE_EVENT_TYPE, G as missingActor, H as getAgentExecutionOptions, K as setAgentExecutionOptions, T as DECIDE_ACTOR, ct as isPlainObject, k as builtinTextActors, ot as validateSchemaSync, ut as AgentError } from "./event-log-DE430ZCa.mjs";
-import { r as createDecideActor } from "./decision-DqO018Tp.mjs";
+import { A as createTextLogic, C as AGENT_USAGE_EVENT_TYPE, G as missingActor, H as getAgentExecutionOptions, K as setAgentExecutionOptions, T as DECIDE_ACTOR, ct as isPlainObject, k as builtinTextActors, ot as validateSchemaSync, ut as AgentError } from "./event-log-DAqsalT1.mjs";
+import { r as createDecideActor } from "./decision-CV7WiV5C.mjs";
 import { machineFromJSON, setup } from "xstate";
 //#region src/workflow-config.ts
 /**

package/dist/{setup-agent-D0L8Anl_.cjs → setup-agent-CwUJyqKB.cjs}

@@ -1,5 +1,5 @@
-const require_event_log = require("./event-log-Bdww2l1D.cjs");
-const require_decision = require("./decision-Iys2hzg3.cjs");
+const require_event_log = require("./event-log-CKWeC7H-.cjs");
+const require_decision = require("./decision-BPdEaxPf.cjs");
 let xstate = require("xstate");
 //#region src/workflow-config.ts
 /**

package/dist/{setup-agent-CPyg2ic7.d.mts → setup-agent-J9f_Wu5T.d.mts}

@@ -1,6 +1,6 @@
 import { _ as StandardSchemaV1, d as EventUnion, g as NormalizedEventSchemas, h as InferOutput, i as AgentToolChoice, m as InferInput, s as AgentTools, t as AgentEventSchemaInputMap, w as WithAgentInputSchema } from "./types-Dp5_Ru4R.mjs";
-import { J as AgentSchemas, Y as EventFromSnapshot, _ as TextLogic, a as AgentModelRef, d as AgentRequestMode, h as BuiltinAgentActors, i as AgentModelMap, v as TextLogicConfig } from "./text-logic-BwdrDpO9.mjs";
-import { n as AgentUsageEvent, t as AGENT_USAGE_EVENT_TYPE } from "./usage-Bl4nK8D-.mjs";
+import { J as AgentSchemas, Y as EventFromSnapshot, _ as TextLogic, a as AgentModelRef, d as AgentRequestMode, h as BuiltinAgentActors, i as AgentModelMap, v as TextLogicConfig } from "./text-logic-DuK9HIFM.mjs";
+import { n as AgentUsageEvent, t as AGENT_USAGE_EVENT_TYPE } from "./usage-D7JKAxLc.mjs";
 import { AnyActorLogic, AnyMachineSnapshot, AnySetupConfig, AnyStateMachine, AsyncActorLogic, EventObject, MachineContext, MetaObject, NonReducibleUnknown, SetupReturnFromConfig, SetupStateSchema } from "xstate";
 //#region src/interaction.d.ts
 interface AgentInteractionEvent<TType extends string = string> {

package/dist/tanstack-ai.cjs

@@ -1,7 +1,7 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
-const require_event_log = require("./event-log-Bdww2l1D.cjs");
-const require_decision = require("./decision-Iys2hzg3.cjs");
-const require_model_source = require("./model-source-DQ7KgJaT.cjs");
+const require_event_log = require("./event-log-CKWeC7H-.cjs");
+const require_decision = require("./decision-BPdEaxPf.cjs");
+const require_model_source = require("./model-source-BQ97_l1-.cjs");
 let _tanstack_ai = require("@tanstack/ai");
 //#region src/tanstack-ai/index.ts
 /**

package/dist/tanstack-ai.d.cts

@@ -1,5 +1,5 @@
 import { i as AgentToolChoice, n as AgentMessage, s as AgentTools, u as ChosenEvent } from "./types-Dp5_Ru4R.cjs";
-import { N as AgentDecisionRequest, W as AgentEventDescriptor, c as AgentRequestExecutorInfo, f as AgentTextRequest, r as AgentFinishReason, t as AgentCallUsage } from "./text-logic-j9hShB7d.cjs";
+import { N as AgentDecisionRequest, W as AgentEventDescriptor, c as AgentRequestExecutorInfo, f as AgentTextRequest, r as AgentFinishReason, t as AgentCallUsage } from "./text-logic-CYP502VT.cjs";
 import { AnyStateMachine } from "xstate";
 import { AnyTextAdapter, ModelMessage, StreamChunk, TokenUsage, Tool } from "@tanstack/ai";
 import { TextActivityOptions } from "@tanstack/ai/adapters";

package/dist/tanstack-ai.d.mts

@@ -1,5 +1,5 @@
 import { i as AgentToolChoice, n as AgentMessage, s as AgentTools, u as ChosenEvent } from "./types-Dp5_Ru4R.mjs";
-import { N as AgentDecisionRequest, W as AgentEventDescriptor, c as AgentRequestExecutorInfo, f as AgentTextRequest, r as AgentFinishReason, t as AgentCallUsage } from "./text-logic-BwdrDpO9.mjs";
+import { N as AgentDecisionRequest, W as AgentEventDescriptor, c as AgentRequestExecutorInfo, f as AgentTextRequest, r as AgentFinishReason, t as AgentCallUsage } from "./text-logic-DuK9HIFM.mjs";
 import { AnyStateMachine } from "xstate";
 import { AnyTextAdapter, ModelMessage, StreamChunk, TokenUsage, Tool } from "@tanstack/ai";
 import { TextActivityOptions } from "@tanstack/ai/adapters";

package/dist/tanstack-ai.mjs

@@ -1,6 +1,6 @@
-import { L as parseProviderOutput, R as providerOutputSchema, X as getJsonSchemaSync, Y as getJsonSchema, dt as AgentTruncatedError, j as getAgentOutputMode, tt as isStandardSchema, w as AGENT_USAGE_TOKEN_FIELDS } from "./event-log-DE430ZCa.mjs";
-import { c as renderDecisionAttempts } from "./decision-DqO018Tp.mjs";
-import { t as resolveModelSource } from "./model-source-CXsSZPq0.mjs";
+import { L as parseProviderOutput, R as providerOutputSchema, X as getJsonSchemaSync, Y as getJsonSchema, dt as AgentTruncatedError, j as getAgentOutputMode, tt as isStandardSchema, w as AGENT_USAGE_TOKEN_FIELDS } from "./event-log-DAqsalT1.mjs";
+import { c as renderDecisionAttempts } from "./decision-CV7WiV5C.mjs";
+import { t as resolveModelSource } from "./model-source-BilDEyqk.mjs";
 import { chat, maxIterations } from "@tanstack/ai";
 //#region src/tanstack-ai/index.ts
 /**

package/dist/testing.cjs

@@ -1,7 +1,7 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
-const require_event_log = require("./event-log-Bdww2l1D.cjs");
-const require_run_agent = require("./run-agent-tmk58M0x.cjs");
-const require_verify = require("./verify-CS_xxvVU.cjs");
+const require_event_log = require("./event-log-CKWeC7H-.cjs");
+const require_run_agent = require("./run-agent-Cg0xd3K-.cjs");
+const require_verify = require("./verify-D_llRCTr.cjs");
 //#region src/trajectory.ts
 /**
 * Classifies one item. Event-shaped things (log entries, events) become events;

package/dist/testing.d.cts

@@ -1,7 +1,7 @@
-import { P as AgentExecutorDecisionRequest, c as AgentRequestExecutorInfo, f as AgentTextRequest, s as AgentRequestExecutor, t as AgentCallUsage, u as AgentRequestExecutors } from "./text-logic-j9hShB7d.cjs";
-import { f as AgentRuntimeOptions, l as AgentRunResult, o as AgentRunInit } from "./run-agent-B5opVUxx.cjs";
+import { P as AgentExecutorDecisionRequest, c as AgentRequestExecutorInfo, f as AgentTextRequest, s as AgentRequestExecutor, t as AgentCallUsage, u as AgentRequestExecutors } from "./text-logic-CYP502VT.cjs";
+import { f as AgentRuntimeOptions, l as AgentRunResult, o as AgentRunInit } from "./run-agent-B5QhabdY.cjs";
 import { t as MetaOfSnapshot } from "./utils-ebVpCYoF.cjs";
-import { _ as assertAgentMachine, a as AgentPathTerminal, b as lintAgentMachine, c as CanReachResult, d as ExploreSnapshot, f as LintAgentMachineOptions, g as SimulationTrailEntry, h as SimulationScript, i as AgentPathReport, l as CanReachTarget, m as SimulateAgentResult, n as AgentLintError, o as AgentUnknownStateError, p as SimulateAgentOptions, r as AgentLintSeverity, s as AssertAgentMachineOptions, t as AgentLintDiagnostic, u as ExplorePathsOptions, v as canReach, x as simulateAgent, y as explorePaths } from "./verify-CPKDPMwY.cjs";
+import { _ as assertAgentMachine, a as AgentPathTerminal, b as lintAgentMachine, c as CanReachResult, d as ExploreSnapshot, f as LintAgentMachineOptions, g as SimulationTrailEntry, h as SimulationScript, i as AgentPathReport, l as CanReachTarget, m as SimulateAgentResult, n as AgentLintError, o as AgentUnknownStateError, p as SimulateAgentOptions, r as AgentLintSeverity, s as AssertAgentMachineOptions, t as AgentLintDiagnostic, u as ExplorePathsOptions, v as canReach, x as simulateAgent, y as explorePaths } from "./verify-Dk3Vwnha.cjs";
 import { AnyStateMachine, EventFromLogic, InputFrom, SnapshotFrom, StateValue } from "xstate";
 //#region src/trajectory.d.ts
 /** An event-shaped trajectory item: anything with a string `type`. */

package/dist/testing.d.mts

@@ -1,7 +1,7 @@
-import { P as AgentExecutorDecisionRequest, c as AgentRequestExecutorInfo, f as AgentTextRequest, s as AgentRequestExecutor, t as AgentCallUsage, u as AgentRequestExecutors } from "./text-logic-BwdrDpO9.mjs";
-import { f as AgentRuntimeOptions, l as AgentRunResult, o as AgentRunInit } from "./run-agent-D4MwS5GY.mjs";
+import { P as AgentExecutorDecisionRequest, c as AgentRequestExecutorInfo, f as AgentTextRequest, s as AgentRequestExecutor, t as AgentCallUsage, u as AgentRequestExecutors } from "./text-logic-DuK9HIFM.mjs";
+import { f as AgentRuntimeOptions, l as AgentRunResult, o as AgentRunInit } from "./run-agent-Atu-wEk7.mjs";
 import { t as MetaOfSnapshot } from "./utils-BnXdWih3.mjs";
-import { _ as assertAgentMachine, a as AgentPathTerminal, b as lintAgentMachine, c as CanReachResult, d as ExploreSnapshot, f as LintAgentMachineOptions, g as SimulationTrailEntry, h as SimulationScript, i as AgentPathReport, l as CanReachTarget, m as SimulateAgentResult, n as AgentLintError, o as AgentUnknownStateError, p as SimulateAgentOptions, r as AgentLintSeverity, s as AssertAgentMachineOptions, t as AgentLintDiagnostic, u as ExplorePathsOptions, v as canReach, x as simulateAgent, y as explorePaths } from "./verify-tkymWz6X.mjs";
+import { _ as assertAgentMachine, a as AgentPathTerminal, b as lintAgentMachine, c as CanReachResult, d as ExploreSnapshot, f as LintAgentMachineOptions, g as SimulationTrailEntry, h as SimulationScript, i as AgentPathReport, l as CanReachTarget, m as SimulateAgentResult, n as AgentLintError, o as AgentUnknownStateError, p as SimulateAgentOptions, r as AgentLintSeverity, s as AssertAgentMachineOptions, t as AgentLintDiagnostic, u as ExplorePathsOptions, v as canReach, x as simulateAgent, y as explorePaths } from "./verify-BVz4cURF.mjs";
 import { AnyStateMachine, EventFromLogic, InputFrom, SnapshotFrom, StateValue } from "xstate";
 //#region src/trajectory.d.ts
 /** An event-shaped trajectory item: anything with a string `type`. */

package/dist/testing.mjs

@@ -1,6 +1,6 @@
-import { $ as getStateMeta, F as normalizeGeneratorResult, N as getCallUsage, lt as isRecord, ut as AgentError } from "./event-log-DE430ZCa.mjs";
-import { p as runToQuiescence, s as createAgentRuntime } from "./run-agent-DWZ1uyBJ.mjs";
-import { a as explorePaths, i as canReach, n as AgentUnknownStateError, o as lintAgentMachine, r as assertAgentMachine, s as simulateAgent, t as AgentLintError } from "./verify-BH5e0XLK.mjs";
+import { $ as getStateMeta, F as normalizeGeneratorResult, N as getCallUsage, lt as isRecord, ut as AgentError } from "./event-log-DAqsalT1.mjs";
+import { p as runToQuiescence, s as createAgentRuntime } from "./run-agent-2UnSUhDb.mjs";
+import { a as explorePaths, i as canReach, n as AgentUnknownStateError, o as lintAgentMachine, r as assertAgentMachine, s as simulateAgent, t as AgentLintError } from "./verify-CoCvR1eM.mjs";
 //#region src/trajectory.ts
 /**
 * Classifies one item. Event-shaped things (log entries, events) become events;

package/dist/{text-logic-j9hShB7d.d.cts → text-logic-CYP502VT.d.cts}

@@ -818,9 +818,11 @@ interface AgentRequestExecutorInfo {
    * `a` being the number of prior failed attempts), so a retry never collides
    * with the rejected attempt it is replacing.
    *
-   * It identifies the CALL SITE, not the request: a fork inherits its parent's
-   * lineage id, so cache on `callKey` together with a fingerprint of the
-   * request and reuse a cached result only when the request also matches.
+   * It identifies the CALL SITE, not the request: a version bridge keeps the
+   * lineage id, so a migrated machine can ask something else under the same
+   * key. Cache on `callKey` together with a fingerprint of the request and
+   * reuse a cached result only when the request also matches. A fork mints
+   * its own lineage id, so its keys never match its parent's.
    *
    * Undefined off the `createAgentRuntime` path, and for a log with no `executionId`.
    */

package/dist/{text-logic-BwdrDpO9.d.mts → text-logic-DuK9HIFM.d.mts}

@@ -818,9 +818,11 @@ interface AgentRequestExecutorInfo {
    * `a` being the number of prior failed attempts), so a retry never collides
    * with the rejected attempt it is replacing.
    *
-   * It identifies the CALL SITE, not the request: a fork inherits its parent's
-   * lineage id, so cache on `callKey` together with a fingerprint of the
-   * request and reuse a cached result only when the request also matches.
+   * It identifies the CALL SITE, not the request: a version bridge keeps the
+   * lineage id, so a migrated machine can ask something else under the same
+   * key. Cache on `callKey` together with a fingerprint of the request and
+   * reuse a cached result only when the request also matches. A fork mints
+   * its own lineage id, so its keys never match its parent's.
    *
    * Undefined off the `createAgentRuntime` path, and for a log with no `executionId`.
    */

package/dist/{usage-BYqv7VBw.d.cts → usage-D7JKAxLc.d.mts}

@@ -1,4 +1,4 @@
-import { t as AgentCallUsage } from "./text-logic-j9hShB7d.cjs";
+import { t as AgentCallUsage } from "./text-logic-DuK9HIFM.mjs";
 import { EventObject } from "xstate";
 //#region src/usage.d.ts
 /** Reserved event delivered after a model call reports token usage. */

package/dist/{usage-Bl4nK8D-.d.mts → usage-DVw-646x.d.cts}

@@ -1,4 +1,4 @@
-import { t as AgentCallUsage } from "./text-logic-BwdrDpO9.mjs";
+import { t as AgentCallUsage } from "./text-logic-CYP502VT.cjs";
 import { EventObject } from "xstate";
 //#region src/usage.d.ts
 /** Reserved event delivered after a model call reports token usage. */

package/dist/validate.cjs

@@ -21,9 +21,9 @@ var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__ge
 	enumerable: true
 }) : target, mod));
 //#endregion
-const require_event_log = require("./event-log-Bdww2l1D.cjs");
-const require_setup_agent = require("./setup-agent-D0L8Anl_.cjs");
-const require_verify = require("./verify-CS_xxvVU.cjs");
+const require_event_log = require("./event-log-CKWeC7H-.cjs");
+const require_setup_agent = require("./setup-agent-CwUJyqKB.cjs");
+const require_verify = require("./verify-D_llRCTr.cjs");
 let ajv_dist_2020_js = require("ajv/dist/2020.js");
 ajv_dist_2020_js = __toESM(ajv_dist_2020_js, 1);
 //#region schemas/agent-workflow.json

package/dist/validate.d.cts

@@ -1,5 +1,5 @@
-import { d as AgentWorkflowConfig, g as FromConfigOptions, v as SchemaCompiler } from "./setup-agent-yFFVXf5s.cjs";
-import { u as ExplorePathsOptions } from "./verify-CPKDPMwY.cjs";
+import { d as AgentWorkflowConfig, g as FromConfigOptions, v as SchemaCompiler } from "./setup-agent-BiF1N3td.cjs";
+import { u as ExplorePathsOptions } from "./verify-Dk3Vwnha.cjs";
 import { AnyActorLogic, AnyStateMachine } from "xstate";
 //#region src/validate/validate-config.d.ts
 /**

package/dist/validate.d.mts

@@ -1,5 +1,5 @@
-import { d as AgentWorkflowConfig, g as FromConfigOptions, v as SchemaCompiler } from "./setup-agent-CPyg2ic7.mjs";
-import { u as ExplorePathsOptions } from "./verify-tkymWz6X.mjs";
+import { d as AgentWorkflowConfig, g as FromConfigOptions, v as SchemaCompiler } from "./setup-agent-J9f_Wu5T.mjs";
+import { u as ExplorePathsOptions } from "./verify-BVz4cURF.mjs";
 import { AnyActorLogic, AnyStateMachine } from "xstate";
 //#region src/validate/validate-config.d.ts
 /**

package/dist/validate.mjs

@@ -1,6 +1,6 @@
-import { D as STREAM_TEXT_ACTOR, E as GENERATE_TEXT_ACTOR, T as DECIDE_ACTOR } from "./event-log-DE430ZCa.mjs";
-import { i as setupAgentFromConfig } from "./setup-agent-BaffhCcM.mjs";
-import { a as explorePaths, o as lintAgentMachine } from "./verify-BH5e0XLK.mjs";
+import { D as STREAM_TEXT_ACTOR, E as GENERATE_TEXT_ACTOR, T as DECIDE_ACTOR } from "./event-log-DAqsalT1.mjs";
+import { i as setupAgentFromConfig } from "./setup-agent-CmhB-U5P.mjs";
+import { a as explorePaths, o as lintAgentMachine } from "./verify-CoCvR1eM.mjs";
 import Ajv2020 from "ajv/dist/2020.js";
 //#region schemas/agent-workflow.json
 var agent_workflow_default = {

package/dist/{verify-tkymWz6X.d.mts → verify-BVz4cURF.d.mts}

@@ -1,5 +1,5 @@
 import { u as ChosenEvent } from "./types-Dp5_Ru4R.mjs";
-import { Q as AgentError } from "./text-logic-BwdrDpO9.mjs";
+import { Q as AgentError } from "./text-logic-DuK9HIFM.mjs";
 import { AnyMachineSnapshot, AnyStateMachine } from "xstate";
 //#region src/verify.d.ts
 /** Severity of an {@link AgentLintDiagnostic}. `error` findings fail CI/the CLI; `warning`s are advisory. */

package/dist/{verify-BH5e0XLK.mjs → verify-CoCvR1eM.mjs}

@@ -1,5 +1,5 @@
-import { P as isTextLogic, U as getRegisteredAgentExecutionOptions, V as executorBoundLogics, X as getJsonSchemaSync, lt as isRecord, ut as AgentError } from "./event-log-DE430ZCa.mjs";
-import { d as getAcceptedEvents, f as getHumanEventTypes, l as resolveDecision, n as acceptedDecisionOptions, p as isEventPattern, s as isDecisionLogic, t as AgentDecisionExhaustedError } from "./decision-DqO018Tp.mjs";
+import { P as isTextLogic, U as getRegisteredAgentExecutionOptions, V as executorBoundLogics, X as getJsonSchemaSync, lt as isRecord, ut as AgentError } from "./event-log-DAqsalT1.mjs";
+import { d as getAcceptedEvents, f as getHumanEventTypes, l as resolveDecision, n as acceptedDecisionOptions, p as isEventPattern, s as isDecisionLogic, t as AgentDecisionExhaustedError } from "./decision-CV7WiV5C.mjs";
 import { getNextTransitions, initialTransition, machineToJSON, transition } from "xstate";
 //#region src/steps.ts
 /**

package/dist/{verify-CS_xxvVU.cjs → verify-D_llRCTr.cjs}

@@ -1,5 +1,5 @@
-const require_event_log = require("./event-log-Bdww2l1D.cjs");
-const require_decision = require("./decision-Iys2hzg3.cjs");
+const require_event_log = require("./event-log-CKWeC7H-.cjs");
+const require_decision = require("./decision-BPdEaxPf.cjs");
 let xstate = require("xstate");
 //#region src/steps.ts
 /**

package/dist/{verify-CPKDPMwY.d.cts → verify-Dk3Vwnha.d.cts}

@@ -1,5 +1,5 @@
 import { u as ChosenEvent } from "./types-Dp5_Ru4R.cjs";
-import { Q as AgentError } from "./text-logic-j9hShB7d.cjs";
+import { Q as AgentError } from "./text-logic-CYP502VT.cjs";
 import { AnyMachineSnapshot, AnyStateMachine } from "xstate";
 //#region src/verify.d.ts
 /** Severity of an {@link AgentLintDiagnostic}. `error` findings fail CI/the CLI; `warning`s are advisory. */

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@statelyai/agent",
-  "version": "2.0.0-alpha.31",
+  "version": "2.0.0-alpha.32",
   "description": "Make invalid agent actions impossible. Agent logic as state machines: deterministic, inspectable, resumable, runs anywhere.",
   "keywords": [
     "agent",