@statelyai/agent 2.0.0-alpha.28 → 2.0.0-alpha.30

package/dist/log.cjs

@@ -1,5 +1,6 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
-const require_event_log_store = require("./event-log-store-C-COhIXP.cjs");
+const require_event_log = require("./event-log-BZRfBRd7.cjs");
+const require_event_log_store = require("./event-log-store-DZR4IIWe.cjs");
 //#region src/event-log-store-conformance.ts
 /**
 * The runner-agnostic conformance suite for {@link AgentEventLogStore}
@@ -341,6 +342,59 @@ const cases = [
 			if (!(caughtZero instanceof Error) || caughtZero instanceof require_event_log_store.AgentEventLogConflictError) fail("forking with upToIndex 0 must reject with a plain Error");
 			if (await store.length("fork-zero") !== 0) fail("a rejected fork must not create the target thread");
 		}
+	},
+	{
+		name: "listThreads (optional) pages by prefix, limit, and cursor",
+		async run(create) {
+			const store = await create();
+			if (store.listThreads === void 0) return;
+			assertJsonEqual((await store.listThreads()).threadIds, [], "listThreads on an empty store must list nothing");
+			for (const threadId of [
+				"user:b",
+				"user:a",
+				"admin:x",
+				"user:c"
+			]) await store.append({
+				threadId,
+				expectedIndex: 0,
+				entries: [entry(0, "start")]
+			});
+			await store.fork({
+				threadId: "user:a",
+				newThreadId: "user:d"
+			});
+			const all = await store.listThreads();
+			assertJsonEqual([...all.threadIds].sort(), [
+				"admin:x",
+				"user:a",
+				"user:b",
+				"user:c",
+				"user:d"
+			], "listThreads must list every non-empty thread, forks included");
+			if (all.cursor !== void 0) fail("listThreads without a limit must return no cursor");
+			const seen = [];
+			let cursor;
+			let pages = 0;
+			do {
+				const page = await store.listThreads({
+					prefix: "user:",
+					limit: 2,
+					...cursor !== void 0 ? { cursor } : {}
+				});
+				if (page.threadIds.length > 2) fail(`listThreads must honor limit 2, got ${page.threadIds.length} ids`);
+				seen.push(...page.threadIds);
+				cursor = page.cursor;
+				if (++pages > 10) fail("listThreads paging must terminate");
+			} while (cursor !== void 0);
+			assertJsonEqual([...seen].sort(), [
+				"user:a",
+				"user:b",
+				"user:c",
+				"user:d"
+			], "paging listThreads by prefix must return each matching thread exactly once");
+			if (seen.length !== new Set(seen).size) fail("paging listThreads must not repeat a thread");
+			if (pages !== 2) fail(`4 matching threads at limit 2 must take exactly 2 pages, took ${pages}`);
+		}
 	}
 ];
 /**
@@ -349,7 +403,8 @@ const cases = [
 * stale-`expectedIndex` conflict with correct fields; an interleaved concurrent
 * append race (exactly one winner); entry-id uniqueness; `read({ from })`
 * incremental correctness; thread isolation; metadata round-trip; deep-copy
-* isolation on append and read; and the full fork contract.
+* isolation on append and read; the full fork contract; and, when the store
+* implements the optional `listThreads`, its prefix/limit/cursor paging.
 *
 * Without a `harness`, every case runs in sequence and the first violation
 * throws. With one, each case is registered as its own test:
@@ -369,24 +424,26 @@ async function assertEventLogStoreConformance(create, harness) {
 	for (const testCase of cases) await testCase.run(create);
 }
 //#endregion
-exports.AGENT_EVENT_SCHEMA_VERSION = require_event_log_store.AGENT_EVENT_SCHEMA_VERSION;
-exports.AGENT_INIT_EVENT_TYPE = require_event_log_store.AGENT_INIT_EVENT_TYPE;
+exports.AGENT_EVENT_SCHEMA_VERSION = require_event_log.AGENT_EVENT_SCHEMA_VERSION;
+exports.AGENT_INIT_EVENT_TYPE = require_event_log.AGENT_INIT_EVENT_TYPE;
 exports.AgentEventLogConflictError = require_event_log_store.AgentEventLogConflictError;
-exports.AgentEventLogError = require_event_log_store.AgentEventLogError;
-exports.AgentMachineVersionMismatchError = require_event_log_store.AgentMachineVersionMismatchError;
-exports.AgentReplayDivergenceError = require_event_log_store.AgentReplayDivergenceError;
-exports.NonSerializableAgentEventError = require_event_log_store.NonSerializableAgentEventError;
-exports.agentCallOccurrence = require_event_log_store.agentCallOccurrence;
-exports.assertAgentLogEntry = require_event_log_store.assertAgentLogEntry;
+exports.AgentEventLogError = require_event_log.AgentEventLogError;
+exports.AgentMachineVersionMismatchError = require_event_log.AgentMachineVersionMismatchError;
+exports.AgentReplayDivergenceError = require_event_log.AgentReplayDivergenceError;
+exports.NonSerializableAgentEventError = require_event_log.NonSerializableAgentEventError;
+exports.agentCallOccurrence = require_event_log.agentCallOccurrence;
+exports.assertAgentLogEntry = require_event_log.assertAgentLogEntry;
 exports.assertEventLogStoreConformance = assertEventLogStoreConformance;
-exports.assertJsonSerializable = require_event_log_store.assertJsonSerializable;
+exports.assertJsonSerializable = require_event_log.assertJsonSerializable;
 exports.createInMemoryEventLogStore = require_event_log_store.createInMemoryEventLogStore;
-exports.createReplayEntry = require_event_log_store.createReplayEntry;
-exports.forkEventLog = require_event_log_store.forkEventLog;
-exports.getLogExecutionId = require_event_log_store.getLogExecutionId;
-exports.getSnapshotStateHash = require_event_log_store.getSnapshotStateHash;
-exports.getUsageFromEvents = require_event_log_store.getUsageFromEvents;
-exports.initEntry = require_event_log_store.initEntry;
-exports.rebindActorSession = require_event_log_store.rebindActorSession;
-exports.replay = require_event_log_store.replay;
-exports.validateReplayEntries = require_event_log_store.validateReplayEntries;
+exports.createReplayEntry = require_event_log.createReplayEntry;
+exports.forkEventLog = require_event_log.forkEventLog;
+exports.getDecisionAttempts = require_event_log.getDecisionAttempts;
+exports.getLogExecutionId = require_event_log.getLogExecutionId;
+exports.getSnapshotStateHash = require_event_log.getSnapshotStateHash;
+exports.getUsageFromEvents = require_event_log.getUsageFromEvents;
+exports.initEntry = require_event_log.initEntry;
+exports.rebindActorSession = require_event_log.rebindActorSession;
+exports.recordLog = require_event_log.recordLog;
+exports.replay = require_event_log.replay;
+exports.validateReplayEntries = require_event_log.validateReplayEntries;

package/dist/log.d.cts

@@ -1,5 +1,4 @@
-import { A as validateReplayEntries, C as forkEventLog, D as initEntry, E as getUsageFromEvents, O as rebindActorSession, S as createReplayEntry, T as getSnapshotStateHash, _ as ReplayOptions, a as AGENT_INIT_EVENT_TYPE, b as assertAgentLogEntry, c as AgentLogEntry, d as AgentMachineVersionMismatchError, f as AgentPersistedSnapshot, g as NonSerializableAgentEventError, h as JsonValue, i as AGENT_EVENT_SCHEMA_VERSION, k as replay, 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 ReplayResult, w as getLogExecutionId, x as assertJsonSerializable, y as agentCallOccurrence } from "./event-log-store-2xzFmgr2.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-CLAC9q2Y.cjs";
 //#region src/event-log-store-conformance.d.ts
 /** Produces a fresh, empty store for one case. */
 type CreateStore = () => Promise<AgentEventLogStore> | AgentEventLogStore;
@@ -17,7 +16,8 @@ interface EventLogStoreConformanceHarness {
  * stale-`expectedIndex` conflict with correct fields; an interleaved concurrent
  * append race (exactly one winner); entry-id uniqueness; `read({ from })`
  * incremental correctness; thread isolation; metadata round-trip; deep-copy
- * isolation on append and read; and the full fork contract.
+ * isolation on append and read; the full fork contract; and, when the store
+ * implements the optional `listThreads`, its prefix/limit/cursor paging.
  *
  * Without a `harness`, every case runs in sequence and the first violation
  * throws. With one, each case is registered as its own test:
@@ -27,6 +27,6 @@ interface EventLogStoreConformanceHarness {
  * assertEventLogStoreConformance(createMyStore, { describe, it });
  * ```
  */
-declare function assertEventLogStoreConformance(create: CreateStore, harness?: EventLogStoreConformanceHarness): Promise<void>;
+export declare function assertEventLogStoreConformance(create: CreateStore, harness?: EventLogStoreConformanceHarness): Promise<void>;
 //#endregion
-export { AGENT_EVENT_SCHEMA_VERSION, AGENT_INIT_EVENT_TYPE, AgentEventLogConflictError, AgentEventLogError, type AgentEventLogStore, type AgentInitEvent, type AgentLogEntry, type AgentLogInit, type AgentLogVerification, AgentMachineVersionMismatchError, type AgentPersistedSnapshot, AgentReplayDivergenceError, type CreateReplayEntryOptions, type EventLogStoreConformanceHarness, type JsonValue, NonSerializableAgentEventError, type ReplayOptions, type ReplayResult, agentCallOccurrence, assertAgentLogEntry, assertEventLogStoreConformance, assertJsonSerializable, createInMemoryEventLogStore, createReplayEntry, forkEventLog, getLogExecutionId, getSnapshotStateHash, getUsageFromEvents, initEntry, rebindActorSession, replay, validateReplayEntries };
+export { AGENT_EVENT_SCHEMA_VERSION, AGENT_INIT_EVENT_TYPE, AgentEventLogConflictError, AgentEventLogError, type AgentEventLogStore, type AgentInitEvent, type AgentLogEntry, type AgentLogInit, type AgentLogVerification, AgentMachineVersionMismatchError, type AgentPersistedSnapshot, AgentReplayDivergenceError, type CreateReplayEntryOptions, type EventLogStoreConformanceHarness, type JsonValue, type LogRecorder, NonSerializableAgentEventError, type ReplayOptions, type ReplayResult, agentCallOccurrence, assertAgentLogEntry, assertJsonSerializable, createInMemoryEventLogStore, createReplayEntry, forkEventLog, getDecisionAttempts, getLogExecutionId, getSnapshotStateHash, getUsageFromEvents, initEntry, rebindActorSession, recordLog, replay, validateReplayEntries };

package/dist/log.d.mts

@@ -1,5 +1,4 @@
-import { A as validateReplayEntries, C as forkEventLog, D as initEntry, E as getUsageFromEvents, O as rebindActorSession, S as createReplayEntry, T as getSnapshotStateHash, _ as ReplayOptions, a as AGENT_INIT_EVENT_TYPE, b as assertAgentLogEntry, c as AgentLogEntry, d as AgentMachineVersionMismatchError, f as AgentPersistedSnapshot, g as NonSerializableAgentEventError, h as JsonValue, i as AGENT_EVENT_SCHEMA_VERSION, k as replay, 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 ReplayResult, w as getLogExecutionId, x as assertJsonSerializable, y as agentCallOccurrence } from "./event-log-store-BIPOz-di.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-CIIJohjj.mjs";
 //#region src/event-log-store-conformance.d.ts
 /** Produces a fresh, empty store for one case. */
 type CreateStore = () => Promise<AgentEventLogStore> | AgentEventLogStore;
@@ -17,7 +16,8 @@ interface EventLogStoreConformanceHarness {
  * stale-`expectedIndex` conflict with correct fields; an interleaved concurrent
  * append race (exactly one winner); entry-id uniqueness; `read({ from })`
  * incremental correctness; thread isolation; metadata round-trip; deep-copy
- * isolation on append and read; and the full fork contract.
+ * isolation on append and read; the full fork contract; and, when the store
+ * implements the optional `listThreads`, its prefix/limit/cursor paging.
  *
  * Without a `harness`, every case runs in sequence and the first violation
  * throws. With one, each case is registered as its own test:
@@ -27,6 +27,6 @@ interface EventLogStoreConformanceHarness {
  * assertEventLogStoreConformance(createMyStore, { describe, it });
  * ```
  */
-declare function assertEventLogStoreConformance(create: CreateStore, harness?: EventLogStoreConformanceHarness): Promise<void>;
+export declare function assertEventLogStoreConformance(create: CreateStore, harness?: EventLogStoreConformanceHarness): Promise<void>;
 //#endregion
-export { AGENT_EVENT_SCHEMA_VERSION, AGENT_INIT_EVENT_TYPE, AgentEventLogConflictError, AgentEventLogError, type AgentEventLogStore, type AgentInitEvent, type AgentLogEntry, type AgentLogInit, type AgentLogVerification, AgentMachineVersionMismatchError, type AgentPersistedSnapshot, AgentReplayDivergenceError, type CreateReplayEntryOptions, type EventLogStoreConformanceHarness, type JsonValue, NonSerializableAgentEventError, type ReplayOptions, type ReplayResult, agentCallOccurrence, assertAgentLogEntry, assertEventLogStoreConformance, assertJsonSerializable, createInMemoryEventLogStore, createReplayEntry, forkEventLog, getLogExecutionId, getSnapshotStateHash, getUsageFromEvents, initEntry, rebindActorSession, replay, validateReplayEntries };
+export { AGENT_EVENT_SCHEMA_VERSION, AGENT_INIT_EVENT_TYPE, AgentEventLogConflictError, AgentEventLogError, type AgentEventLogStore, type AgentInitEvent, type AgentLogEntry, type AgentLogInit, type AgentLogVerification, AgentMachineVersionMismatchError, type AgentPersistedSnapshot, AgentReplayDivergenceError, type CreateReplayEntryOptions, type EventLogStoreConformanceHarness, type JsonValue, type LogRecorder, NonSerializableAgentEventError, type ReplayOptions, type ReplayResult, agentCallOccurrence, assertAgentLogEntry, assertJsonSerializable, createInMemoryEventLogStore, createReplayEntry, forkEventLog, getDecisionAttempts, getLogExecutionId, getSnapshotStateHash, getUsageFromEvents, initEntry, rebindActorSession, recordLog, replay, validateReplayEntries };

package/dist/log.mjs

@@ -1,4 +1,5 @@
-import { _ as getUsageFromEvents, a as AgentEventLogError, b as replay, c as NonSerializableAgentEventError, d as assertJsonSerializable, g as getSnapshotStateHash, h as getLogExecutionId, i as AGENT_INIT_EVENT_TYPE, l as agentCallOccurrence, m as forkEventLog, n as createInMemoryEventLogStore, o as AgentMachineVersionMismatchError, p as createReplayEntry, r as AGENT_EVENT_SCHEMA_VERSION, s as AgentReplayDivergenceError, t as AgentEventLogConflictError, u as assertAgentLogEntry, v as initEntry, x as validateReplayEntries, y as rebindActorSession } from "./event-log-store-2pAFiWuc.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-DJCMHek_.mjs";
+import { n as createInMemoryEventLogStore, t as AgentEventLogConflictError } from "./event-log-store-DsP6GCRh.mjs";
 //#region src/event-log-store-conformance.ts
 /**
 * The runner-agnostic conformance suite for {@link AgentEventLogStore}
@@ -340,6 +341,59 @@ const cases = [
 			if (!(caughtZero instanceof Error) || caughtZero instanceof AgentEventLogConflictError) fail("forking with upToIndex 0 must reject with a plain Error");
 			if (await store.length("fork-zero") !== 0) fail("a rejected fork must not create the target thread");
 		}
+	},
+	{
+		name: "listThreads (optional) pages by prefix, limit, and cursor",
+		async run(create) {
+			const store = await create();
+			if (store.listThreads === void 0) return;
+			assertJsonEqual((await store.listThreads()).threadIds, [], "listThreads on an empty store must list nothing");
+			for (const threadId of [
+				"user:b",
+				"user:a",
+				"admin:x",
+				"user:c"
+			]) await store.append({
+				threadId,
+				expectedIndex: 0,
+				entries: [entry(0, "start")]
+			});
+			await store.fork({
+				threadId: "user:a",
+				newThreadId: "user:d"
+			});
+			const all = await store.listThreads();
+			assertJsonEqual([...all.threadIds].sort(), [
+				"admin:x",
+				"user:a",
+				"user:b",
+				"user:c",
+				"user:d"
+			], "listThreads must list every non-empty thread, forks included");
+			if (all.cursor !== void 0) fail("listThreads without a limit must return no cursor");
+			const seen = [];
+			let cursor;
+			let pages = 0;
+			do {
+				const page = await store.listThreads({
+					prefix: "user:",
+					limit: 2,
+					...cursor !== void 0 ? { cursor } : {}
+				});
+				if (page.threadIds.length > 2) fail(`listThreads must honor limit 2, got ${page.threadIds.length} ids`);
+				seen.push(...page.threadIds);
+				cursor = page.cursor;
+				if (++pages > 10) fail("listThreads paging must terminate");
+			} while (cursor !== void 0);
+			assertJsonEqual([...seen].sort(), [
+				"user:a",
+				"user:b",
+				"user:c",
+				"user:d"
+			], "paging listThreads by prefix must return each matching thread exactly once");
+			if (seen.length !== new Set(seen).size) fail("paging listThreads must not repeat a thread");
+			if (pages !== 2) fail(`4 matching threads at limit 2 must take exactly 2 pages, took ${pages}`);
+		}
 	}
 ];
 /**
@@ -348,7 +402,8 @@ const cases = [
 * stale-`expectedIndex` conflict with correct fields; an interleaved concurrent
 * append race (exactly one winner); entry-id uniqueness; `read({ from })`
 * incremental correctness; thread isolation; metadata round-trip; deep-copy
-* isolation on append and read; and the full fork contract.
+* isolation on append and read; the full fork contract; and, when the store
+* implements the optional `listThreads`, its prefix/limit/cursor paging.
 *
 * Without a `harness`, every case runs in sequence and the first violation
 * throws. With one, each case is registered as its own test:
@@ -368,4 +423,4 @@ async function assertEventLogStoreConformance(create, harness) {
 	for (const testCase of cases) await testCase.run(create);
 }
 //#endregion
-export { AGENT_EVENT_SCHEMA_VERSION, AGENT_INIT_EVENT_TYPE, AgentEventLogConflictError, AgentEventLogError, AgentMachineVersionMismatchError, AgentReplayDivergenceError, NonSerializableAgentEventError, agentCallOccurrence, assertAgentLogEntry, assertEventLogStoreConformance, assertJsonSerializable, createInMemoryEventLogStore, createReplayEntry, forkEventLog, getLogExecutionId, getSnapshotStateHash, getUsageFromEvents, initEntry, rebindActorSession, replay, validateReplayEntries };
+export { AGENT_EVENT_SCHEMA_VERSION, AGENT_INIT_EVENT_TYPE, AgentEventLogConflictError, AgentEventLogError, AgentMachineVersionMismatchError, AgentReplayDivergenceError, NonSerializableAgentEventError, agentCallOccurrence, assertAgentLogEntry, assertEventLogStoreConformance, assertJsonSerializable, createInMemoryEventLogStore, createReplayEntry, forkEventLog, getDecisionAttempts, getLogExecutionId, getSnapshotStateHash, getUsageFromEvents, initEntry, rebindActorSession, recordLog, replay, validateReplayEntries };

package/dist/machines.cjs

@@ -1,5 +1,5 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
-const require_setup_agent = require("./setup-agent-DV4cTou-.cjs");
+const require_setup_agent = require("./setup-agent-DoUk7EdC.cjs");
 //#region src/machines/internal.ts
 /** The builtin inline text request every preset lowers a request entry to. */
 const GENERATE_TEXT_SRC = "agent.generateText";

package/dist/machines.d.cts

@@ -1,6 +1,5 @@
-import { _ as StandardSchemaV1, s as AgentTools } from "./types-hR5f5YXa.cjs";
+import { _ as StandardSchemaV1, s as AgentTools } from "./types-Dp5_Ru4R.cjs";
 import { AnyActorRef, AnyStateMachine, EventObject, MachineContext, MetaObject, StateMachine, StateSchema, StateValue } from "xstate";
-
 //#region src/machines/internal.d.ts
 /**
  * The machine type a preset factory returns: its context, event union, input
@@ -95,7 +94,7 @@ type ToolLoopMachine = PresetMachine<ToolLoopContext, ToolLoopInput, ToolLoopOut
  * // Snapshots and log entries carry machine.version ("1") automatically.
  * ```
  */
-declare function createToolLoopMachine(config: CreateToolLoopMachineConfig): ToolLoopMachine;
+export declare function createToolLoopMachine(config: CreateToolLoopMachineConfig): ToolLoopMachine;
 //#endregion
 //#region src/machines/sequential.d.ts
 /** Arguments a {@link SequentialStep}'s `prompt` receives. */
@@ -166,7 +165,7 @@ type SequentialMachine = PresetMachine<SequentialContext, SequentialInput, Seque
  * });
  * ```
  */
-declare function createSequentialMachine(config: CreateSequentialMachineConfig): SequentialMachine;
+export declare function createSequentialMachine(config: CreateSequentialMachineConfig): SequentialMachine;
 //#endregion
 //#region src/machines/router.d.ts
 /** Config for {@link createRouterMachine}. */
@@ -202,7 +201,7 @@ type RouterEvent<TRoute extends string = string> = {
 /** The machine {@link createRouterMachine} returns. */
 type RouterMachine<TRoute extends string = string> = PresetMachine<RouterContext<TRoute>, RouterInput, RouterOutput<TRoute>, RouterEvent<TRoute>>;
 /** The event a route decision chooses: `ROUTE_<name>`. */
-declare function routeEventType(route: string): string;
+export declare function routeEventType(route: string): string;
 /**
  * One `agent.decide` picks exactly one declared route, then the machine runs
  * it. Only the declared routes have events and transitions, so a model naming
@@ -222,7 +221,7 @@ declare function routeEventType(route: string): string;
  * });
  * ```
  */
-declare function createRouterMachine<const TRoutes extends Record<string, PresetEntry>>(config: CreateRouterMachineConfig<TRoutes>): RouterMachine<keyof TRoutes & string>;
+export declare function createRouterMachine<const TRoutes extends Record<string, PresetEntry>>(config: CreateRouterMachineConfig<TRoutes>): RouterMachine<keyof TRoutes & string>;
 //#endregion
 //#region src/machines/parallel.d.ts
 /** Config for {@link createParallelMachine}. */
@@ -268,7 +267,7 @@ type ParallelMachine = PresetMachine<ParallelContext, ParallelInput, ParallelOut
  * });
  * ```
  */
-declare function createParallelMachine(config: CreateParallelMachineConfig): ParallelMachine;
+export declare function createParallelMachine(config: CreateParallelMachineConfig): ParallelMachine;
 //#endregion
 //#region src/machines/loop.d.ts
 /** The accumulated state a {@link CreateLoopMachineConfig.until} predicate reads. */
@@ -288,7 +287,8 @@ interface CreateLoopMachineConfig {
   model: string;
   /** The repeated unit of work: an inline request or a child machine. */
   body: PresetEntry & {
-    /** Builds each iteration's prompt. Defaults to the machine's `prompt`. */prompt?: (state: LoopState) => string;
+    /** Builds each iteration's prompt. Defaults to the machine's `prompt`. */
+    prompt?: (state: LoopState) => string;
   };
   /** Stop condition, checked after each iteration. */
   until: (state: LoopState) => boolean;
@@ -330,7 +330,7 @@ type LoopMachine = PresetMachine<LoopContext, LoopInput, LoopOutput>;
  * });
  * ```
  */
-declare function createLoopMachine(config: CreateLoopMachineConfig): LoopMachine;
+export declare function createLoopMachine(config: CreateLoopMachineConfig): LoopMachine;
 //#endregion
 //#region src/machines/supervisor.d.ts
 /** Config for {@link createSupervisorMachine}. */
@@ -369,9 +369,9 @@ type SupervisorEvent<TWorker extends string = string> = {
 /** The machine {@link createSupervisorMachine} returns. */
 type SupervisorMachine<TWorker extends string = string> = PresetMachine<SupervisorContext<TWorker>, SupervisorInput, SupervisorOutput, SupervisorEvent<TWorker>>;
 /** The event a supervising decision chooses to delegate to a worker: `DELEGATE_<name>`. */
-declare function delegateEventType(worker: string): string;
+export declare function delegateEventType(worker: string): string;
 /** The event a supervising decision chooses to stop. */
-declare const FINISH_EVENT_TYPE = "FINISH";
+export declare const FINISH_EVENT_TYPE = "FINISH";
 /**
  * A supervisor delegating to typed workers: each turn, one `agent.decide`
  * picks a worker or `FINISH`. Worker results accumulate in context and are fed
@@ -398,7 +398,7 @@ declare const FINISH_EVENT_TYPE = "FINISH";
  * });
  * ```
  */
-declare function createSupervisorMachine<const TWorkers extends Record<string, PresetEntry>>(config: CreateSupervisorMachineConfig<TWorkers>): SupervisorMachine<keyof TWorkers & string>;
+export declare function createSupervisorMachine<const TWorkers extends Record<string, PresetEntry>>(config: CreateSupervisorMachineConfig<TWorkers>): SupervisorMachine<keyof TWorkers & string>;
 //#endregion
 //#region src/machines/handoff.d.ts
 /** Config for {@link createHandoffMachine}. */
@@ -429,7 +429,7 @@ type HandoffEvent<TAgent extends string = string> = {
 /** The machine {@link createHandoffMachine} returns. There is no final state, so it has no output. */
 type HandoffMachine<TAgent extends string = string> = PresetMachine<HandoffContext<TAgent>, HandoffInput<TAgent>, undefined, HandoffEvent<TAgent>>;
 /** The event that hands the mic to a peer: `transfer_to_<name>`. */
-declare function transferEventType(agent: string): string;
+export declare function transferEventType(agent: string): string;
 /**
  * Peer handoff (the swarm shape): `context.activeAgent` holds the mic, runs one
  * turn, then the machine settles idle in `waiting`. A `transfer_to_<name>`
@@ -459,6 +459,6 @@ declare function transferEventType(agent: string): string;
  * });
  * ```
  */
-declare function createHandoffMachine<const TAgents extends Record<string, PresetEntry>>(config: CreateHandoffMachineConfig<TAgents>): HandoffMachine<keyof TAgents & string>;
+export declare function createHandoffMachine<const TAgents extends Record<string, PresetEntry>>(config: CreateHandoffMachineConfig<TAgents>): HandoffMachine<keyof TAgents & string>;
 //#endregion
-export { type CreateHandoffMachineConfig, type CreateLoopMachineConfig, type CreateParallelMachineConfig, type CreateRouterMachineConfig, type CreateSequentialMachineConfig, type CreateSupervisorMachineConfig, type CreateToolLoopMachineConfig, FINISH_EVENT_TYPE, type HandoffContext, type HandoffEvent, type HandoffInput, type HandoffMachine, type LoopContext, type LoopInput, type LoopMachine, type LoopOutput, type LoopState, type ParallelContext, type ParallelInput, type ParallelMachine, type ParallelOutput, type PresetEntry, type PresetMachine, type PresetMachineEntry, type PresetRequestEntry, type RouterContext, type RouterEvent, type RouterInput, type RouterMachine, type RouterOutput, type SequentialContext, type SequentialInput, type SequentialMachine, type SequentialOutput, type SequentialPromptArgs, type SequentialStep, type SupervisorContext, type SupervisorEvent, type SupervisorInput, type SupervisorMachine, type SupervisorOutput, type ToolLoopContext, type ToolLoopInput, type ToolLoopMachine, type ToolLoopOutput, createHandoffMachine, createLoopMachine, createParallelMachine, createRouterMachine, createSequentialMachine, createSupervisorMachine, createToolLoopMachine, delegateEventType, routeEventType, transferEventType };
+export type { CreateHandoffMachineConfig, CreateLoopMachineConfig, CreateParallelMachineConfig, CreateRouterMachineConfig, CreateSequentialMachineConfig, CreateSupervisorMachineConfig, CreateToolLoopMachineConfig, HandoffContext, HandoffEvent, HandoffInput, HandoffMachine, LoopContext, LoopInput, LoopMachine, LoopOutput, LoopState, ParallelContext, ParallelInput, ParallelMachine, ParallelOutput, PresetEntry, PresetMachine, PresetMachineEntry, PresetRequestEntry, RouterContext, RouterEvent, RouterInput, RouterMachine, RouterOutput, SequentialContext, SequentialInput, SequentialMachine, SequentialOutput, SequentialPromptArgs, SequentialStep, SupervisorContext, SupervisorEvent, SupervisorInput, SupervisorMachine, SupervisorOutput, ToolLoopContext, ToolLoopInput, ToolLoopMachine, ToolLoopOutput };

package/dist/machines.d.mts

@@ -1,6 +1,5 @@
-import { _ as StandardSchemaV1, s as AgentTools } from "./types-BgNbNKnJ.mjs";
+import { _ as StandardSchemaV1, s as AgentTools } from "./types-Dp5_Ru4R.mjs";
 import { AnyActorRef, AnyStateMachine, EventObject, MachineContext, MetaObject, StateMachine, StateSchema, StateValue } from "xstate";
-
 //#region src/machines/internal.d.ts
 /**
  * The machine type a preset factory returns: its context, event union, input
@@ -95,7 +94,7 @@ type ToolLoopMachine = PresetMachine<ToolLoopContext, ToolLoopInput, ToolLoopOut
  * // Snapshots and log entries carry machine.version ("1") automatically.
  * ```
  */
-declare function createToolLoopMachine(config: CreateToolLoopMachineConfig): ToolLoopMachine;
+export declare function createToolLoopMachine(config: CreateToolLoopMachineConfig): ToolLoopMachine;
 //#endregion
 //#region src/machines/sequential.d.ts
 /** Arguments a {@link SequentialStep}'s `prompt` receives. */
@@ -166,7 +165,7 @@ type SequentialMachine = PresetMachine<SequentialContext, SequentialInput, Seque
  * });
  * ```
  */
-declare function createSequentialMachine(config: CreateSequentialMachineConfig): SequentialMachine;
+export declare function createSequentialMachine(config: CreateSequentialMachineConfig): SequentialMachine;
 //#endregion
 //#region src/machines/router.d.ts
 /** Config for {@link createRouterMachine}. */
@@ -202,7 +201,7 @@ type RouterEvent<TRoute extends string = string> = {
 /** The machine {@link createRouterMachine} returns. */
 type RouterMachine<TRoute extends string = string> = PresetMachine<RouterContext<TRoute>, RouterInput, RouterOutput<TRoute>, RouterEvent<TRoute>>;
 /** The event a route decision chooses: `ROUTE_<name>`. */
-declare function routeEventType(route: string): string;
+export declare function routeEventType(route: string): string;
 /**
  * One `agent.decide` picks exactly one declared route, then the machine runs
  * it. Only the declared routes have events and transitions, so a model naming
@@ -222,7 +221,7 @@ declare function routeEventType(route: string): string;
  * });
  * ```
  */
-declare function createRouterMachine<const TRoutes extends Record<string, PresetEntry>>(config: CreateRouterMachineConfig<TRoutes>): RouterMachine<keyof TRoutes & string>;
+export declare function createRouterMachine<const TRoutes extends Record<string, PresetEntry>>(config: CreateRouterMachineConfig<TRoutes>): RouterMachine<keyof TRoutes & string>;
 //#endregion
 //#region src/machines/parallel.d.ts
 /** Config for {@link createParallelMachine}. */
@@ -268,7 +267,7 @@ type ParallelMachine = PresetMachine<ParallelContext, ParallelInput, ParallelOut
  * });
  * ```
  */
-declare function createParallelMachine(config: CreateParallelMachineConfig): ParallelMachine;
+export declare function createParallelMachine(config: CreateParallelMachineConfig): ParallelMachine;
 //#endregion
 //#region src/machines/loop.d.ts
 /** The accumulated state a {@link CreateLoopMachineConfig.until} predicate reads. */
@@ -288,7 +287,8 @@ interface CreateLoopMachineConfig {
   model: string;
   /** The repeated unit of work: an inline request or a child machine. */
   body: PresetEntry & {
-    /** Builds each iteration's prompt. Defaults to the machine's `prompt`. */prompt?: (state: LoopState) => string;
+    /** Builds each iteration's prompt. Defaults to the machine's `prompt`. */
+    prompt?: (state: LoopState) => string;
   };
   /** Stop condition, checked after each iteration. */
   until: (state: LoopState) => boolean;
@@ -330,7 +330,7 @@ type LoopMachine = PresetMachine<LoopContext, LoopInput, LoopOutput>;
  * });
  * ```
  */
-declare function createLoopMachine(config: CreateLoopMachineConfig): LoopMachine;
+export declare function createLoopMachine(config: CreateLoopMachineConfig): LoopMachine;
 //#endregion
 //#region src/machines/supervisor.d.ts
 /** Config for {@link createSupervisorMachine}. */
@@ -369,9 +369,9 @@ type SupervisorEvent<TWorker extends string = string> = {
 /** The machine {@link createSupervisorMachine} returns. */
 type SupervisorMachine<TWorker extends string = string> = PresetMachine<SupervisorContext<TWorker>, SupervisorInput, SupervisorOutput, SupervisorEvent<TWorker>>;
 /** The event a supervising decision chooses to delegate to a worker: `DELEGATE_<name>`. */
-declare function delegateEventType(worker: string): string;
+export declare function delegateEventType(worker: string): string;
 /** The event a supervising decision chooses to stop. */
-declare const FINISH_EVENT_TYPE = "FINISH";
+export declare const FINISH_EVENT_TYPE = "FINISH";
 /**
  * A supervisor delegating to typed workers: each turn, one `agent.decide`
  * picks a worker or `FINISH`. Worker results accumulate in context and are fed
@@ -398,7 +398,7 @@ declare const FINISH_EVENT_TYPE = "FINISH";
  * });
  * ```
  */
-declare function createSupervisorMachine<const TWorkers extends Record<string, PresetEntry>>(config: CreateSupervisorMachineConfig<TWorkers>): SupervisorMachine<keyof TWorkers & string>;
+export declare function createSupervisorMachine<const TWorkers extends Record<string, PresetEntry>>(config: CreateSupervisorMachineConfig<TWorkers>): SupervisorMachine<keyof TWorkers & string>;
 //#endregion
 //#region src/machines/handoff.d.ts
 /** Config for {@link createHandoffMachine}. */
@@ -429,7 +429,7 @@ type HandoffEvent<TAgent extends string = string> = {
 /** The machine {@link createHandoffMachine} returns. There is no final state, so it has no output. */
 type HandoffMachine<TAgent extends string = string> = PresetMachine<HandoffContext<TAgent>, HandoffInput<TAgent>, undefined, HandoffEvent<TAgent>>;
 /** The event that hands the mic to a peer: `transfer_to_<name>`. */
-declare function transferEventType(agent: string): string;
+export declare function transferEventType(agent: string): string;
 /**
  * Peer handoff (the swarm shape): `context.activeAgent` holds the mic, runs one
  * turn, then the machine settles idle in `waiting`. A `transfer_to_<name>`
@@ -459,6 +459,6 @@ declare function transferEventType(agent: string): string;
  * });
  * ```
  */
-declare function createHandoffMachine<const TAgents extends Record<string, PresetEntry>>(config: CreateHandoffMachineConfig<TAgents>): HandoffMachine<keyof TAgents & string>;
+export declare function createHandoffMachine<const TAgents extends Record<string, PresetEntry>>(config: CreateHandoffMachineConfig<TAgents>): HandoffMachine<keyof TAgents & string>;
 //#endregion
-export { type CreateHandoffMachineConfig, type CreateLoopMachineConfig, type CreateParallelMachineConfig, type CreateRouterMachineConfig, type CreateSequentialMachineConfig, type CreateSupervisorMachineConfig, type CreateToolLoopMachineConfig, FINISH_EVENT_TYPE, type HandoffContext, type HandoffEvent, type HandoffInput, type HandoffMachine, type LoopContext, type LoopInput, type LoopMachine, type LoopOutput, type LoopState, type ParallelContext, type ParallelInput, type ParallelMachine, type ParallelOutput, type PresetEntry, type PresetMachine, type PresetMachineEntry, type PresetRequestEntry, type RouterContext, type RouterEvent, type RouterInput, type RouterMachine, type RouterOutput, type SequentialContext, type SequentialInput, type SequentialMachine, type SequentialOutput, type SequentialPromptArgs, type SequentialStep, type SupervisorContext, type SupervisorEvent, type SupervisorInput, type SupervisorMachine, type SupervisorOutput, type ToolLoopContext, type ToolLoopInput, type ToolLoopMachine, type ToolLoopOutput, createHandoffMachine, createLoopMachine, createParallelMachine, createRouterMachine, createSequentialMachine, createSupervisorMachine, createToolLoopMachine, delegateEventType, routeEventType, transferEventType };
+export type { CreateHandoffMachineConfig, CreateLoopMachineConfig, CreateParallelMachineConfig, CreateRouterMachineConfig, CreateSequentialMachineConfig, CreateSupervisorMachineConfig, CreateToolLoopMachineConfig, HandoffContext, HandoffEvent, HandoffInput, HandoffMachine, LoopContext, LoopInput, LoopMachine, LoopOutput, LoopState, ParallelContext, ParallelInput, ParallelMachine, ParallelOutput, PresetEntry, PresetMachine, PresetMachineEntry, PresetRequestEntry, RouterContext, RouterEvent, RouterInput, RouterMachine, RouterOutput, SequentialContext, SequentialInput, SequentialMachine, SequentialOutput, SequentialPromptArgs, SequentialStep, SupervisorContext, SupervisorEvent, SupervisorInput, SupervisorMachine, SupervisorOutput, ToolLoopContext, ToolLoopInput, ToolLoopMachine, ToolLoopOutput };

package/dist/machines.mjs

@@ -1,4 +1,4 @@
-import { r as setupAgent } from "./setup-agent-BuanDXeh.mjs";
+import { r as setupAgent } from "./setup-agent-7rV_cujV.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-BCKg4qJ1.cjs

@@ -0,0 +1,44 @@
+const require_event_log = require("./event-log-BZRfBRd7.cjs");
+const require_decision = require("./decision-CIb7ddIv.cjs");
+//#region src/internal/model-source.ts
+function hasEntries(value) {
+	return require_decision.isRecord(value) && Object.keys(value).length > 0;
+}
+function isMachineLike(value) {
+	return "config" in value && typeof value.transition === "function";
+}
+/** Short description of a value for construction-time error messages. */
+function describeValue(value) {
+	if (value === null) return "null";
+	if (Array.isArray(value)) return "an array";
+	if (typeof value !== "object") return typeof value;
+	if (isMachineLike(value)) return require_event_log.getAgentExecutionOptions(value) ? "a machine whose setupAgent(...) declared no models" : "a machine not built by setupAgent(...).createMachine";
+	if (typeof value.createMachine === "function") return "a setupAgent(...) result that declared no models";
+	const keys = Object.keys(value);
+	return keys.length ? `an object with keys ${keys.join(", ")}` : "an empty object";
+}
+/**
+* Normalizes an adapter's first argument to its options object. Accepts the
+* options object itself (`{ models }`, `{ resolveModel }`), a `setupAgent(...)`
+* result (its `models`), or a machine built by `setupAgent(...).createMachine`
+* (the `models` registered for it). Provider-free: the adapter decides what the
+* model values are. Throws, naming what it got, for anything else. @internal
+*/
+function resolveModelSource(adapter, source) {
+	if (require_decision.isRecord(source)) {
+		if (typeof source.createMachine === "function") {
+			if (hasEntries(source.models)) return { models: source.models };
+		} else if (isMachineLike(source)) {
+			const models = require_event_log.getAgentExecutionOptions(source)?.models;
+			if (hasEntries(models)) return { models };
+		} else if (require_decision.isRecord(source.models) || typeof source.resolveModel === "function") return source;
+	}
+	throw new TypeError(`${adapter}: expected { models }, { resolveModel }, a setupAgent(...) result with models, or a machine from its createMachine; got ${describeValue(source)}.`);
+}
+//#endregion
+Object.defineProperty(exports, "resolveModelSource", {
+	enumerable: true,
+	get: function() {
+		return resolveModelSource;
+	}
+});

package/dist/model-source-BaHwJ1wK.mjs

@@ -0,0 +1,39 @@
+import { H as getAgentExecutionOptions } from "./event-log-DJCMHek_.mjs";
+import { m as isRecord } from "./decision-BHkvuImD.mjs";
+//#region src/internal/model-source.ts
+function hasEntries(value) {
+	return isRecord(value) && Object.keys(value).length > 0;
+}
+function isMachineLike(value) {
+	return "config" in value && typeof value.transition === "function";
+}
+/** Short description of a value for construction-time error messages. */
+function describeValue(value) {
+	if (value === null) return "null";
+	if (Array.isArray(value)) return "an array";
+	if (typeof value !== "object") return typeof value;
+	if (isMachineLike(value)) return getAgentExecutionOptions(value) ? "a machine whose setupAgent(...) declared no models" : "a machine not built by setupAgent(...).createMachine";
+	if (typeof value.createMachine === "function") return "a setupAgent(...) result that declared no models";
+	const keys = Object.keys(value);
+	return keys.length ? `an object with keys ${keys.join(", ")}` : "an empty object";
+}
+/**
+* Normalizes an adapter's first argument to its options object. Accepts the
+* options object itself (`{ models }`, `{ resolveModel }`), a `setupAgent(...)`
+* result (its `models`), or a machine built by `setupAgent(...).createMachine`
+* (the `models` registered for it). Provider-free: the adapter decides what the
+* model values are. Throws, naming what it got, for anything else. @internal
+*/
+function resolveModelSource(adapter, source) {
+	if (isRecord(source)) {
+		if (typeof source.createMachine === "function") {
+			if (hasEntries(source.models)) return { models: source.models };
+		} else if (isMachineLike(source)) {
+			const models = getAgentExecutionOptions(source)?.models;
+			if (hasEntries(models)) return { models };
+		} else if (isRecord(source.models) || typeof source.resolveModel === "function") return source;
+	}
+	throw new TypeError(`${adapter}: expected { models }, { resolveModel }, a setupAgent(...) result with models, or a machine from its createMachine; got ${describeValue(source)}.`);
+}
+//#endregion
+export { resolveModelSource as t };