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

package/CHANGELOG.md

@@ -1,5 +1,27 @@
 # @statelyai/agent
 
+## 2.0.0-alpha.33
+
+### Minor Changes
+
+- [#181](https://github.com/statelyai/agent/pull/181) [`407e2a6`](https://github.com/statelyai/agent/commit/407e2a6c03e463d4b8d92997cf59e72b30301511) Thanks [@davidkpiano](https://github.com/davidkpiano)! - **Four eval helpers in `@statelyai/agent/testing`.**
+  
+  - `traceCoverage(machine, traces, { reachable? })` reports which states and handlers no trace exercised. Coverage is per handler: a state and an event it handles, with the targets it declares and the ones runs reached. `always` handlers are listed as unobservable, because traces record one step per macrostep.
+  - `repeatRuns({ scenarios, k, run, passed })` runs each scenario `k` times and reports passes, pass@k, pass^k, distinct paths, and the state where the runs diverged. `report.passHat(j)` estimates the suite's pass^j. `summarizeRepeats` builds the same report from runs collected elsewhere.
+  - `judgeAgreement(rows, { positive?, groupBy? })` compares a judge's labels with confirmed human labels: accuracy, per-label recall, the confusion matrix, disagreements, the true positive and true negative rates, and a correction for the judge's bias.
+  - `firstDivergence(actual, reference)` finds the first step where a run departs from a reference trace or an expected trajectory, and names the state it was in.
+  - `foldTraces` takes a `blame` option and adds a `blamed` column: failed runs counted once, against the state their failure started in. Rows now always include `blamed`, which is 0 without `blame`.
+
+## 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;