@statelyai/agent 2.0.0-alpha.25 → 2.0.0-alpha.26

package/dist/index.d.cts

@@ -2,7 +2,7 @@ import { C as UserMessage, S as ToolResultPart, _ as StandardSchemaV1, a as Agen
 import { A as AgentDecisionExhaustedError, B as createDecisionRequest, C as getAgentOutputMode, D as parseProviderOutput, E as parseOutput, F as DecisionAttempt, G as AgentRequestOptions, H as resolveDecision, I as DecisionLogic, J as EventFromSnapshot, K as AgentRequestSource, L as DecisionLogicConfig, M as AgentDecisionRequest, N as AgentExecutorDecisionRequest, O as providerOutputSchema, P as CreateDecisionRequestOptions, Q as AgentTruncatedError, R as ResolveDecisionOptions, S as createTextLogic, T as getCallUsage, U as AgentEventDescriptor, V as renderDecisionAttempts, W as AgentInvalidEventPayloadError, X as parseAgentEvent, Y as getAcceptedEvents, Z as AgentError, _ as TextLogic, a as AgentModelRef, b as TextLogicExecutor, c as AgentRequestExecutorInfo, d as AgentRequestMode, f as AgentTextRequest, g as ProviderStructuredOutput, h as BuiltinAgentActors, i as AgentModelMap, j as AgentDecisionInput, k as AgentDecisionExecutor, l as AgentRequestExecutorResult, m as AgentUsage, n as AgentExecutorTextRequest, o as AgentOutputMode, p as AgentTextResult, q as AgentSchemas, 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 createDecisionLogic } from "./text-logic-BFEOxyxv.cjs";
 import { C as rejectAgentStep, D as AgentUsageEvent, E as AGENT_USAGE_EVENT_TYPE, S as initialAgentStep, T as transitionAgentStep, _ as traceTransitions, a as AgentSnapshotDivergedError, b as AgentStepRequest, c as InspectedActorRef, d as RunAgentOptions, f as RunAgentResult, g as serializeTraceEvent, h as runAgent, i as AgentRunMeta, l as JsonSerializableTraceEvent, m as isAgentIdle, n as AgentInputFrom, o as AgentTraceEvent, p as inspectTransitions, r as AgentMaxModelCallsExceededError, s as AgentTransitionHandler, t as AGENT_TRACE_SCHEMA_VERSION, u as RunAgentErrorCause, v as AgentRequest, w as resolveAgentStep, x as executeAgentRequest, y as AgentStep } from "./run-agent-BOfoJg5B.cjs";
 import { c as AgentLogEntry, d as AgentMachineVersionMismatchError, n as AgentEventLogStore, t as AgentEventLogConflictError } from "./event-log-store-DvOcs10J.cjs";
-import { _ as ScriptedExecutorsScript, a as getMachineStructuralHash, c as getStatePath, d as toolMessage, f as userMessage, g as ScriptedExecutors, h as ScriptedDecisionValue, i as getJsonSchemaSync, l as isStandardSchema, m as ScriptedDecisionEntry, n as assistantMessage, o as getMessageText, p as ScriptedByName, r as getJsonSchema, s as getStateMeta, u as systemMessage, v as ScriptedTextEntry } from "./utils-RalRn9sk.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-ceStNCOh.cjs";
 import { AnyActorLogic, AnyMachineSnapshot, AnySetupConfig, AnyStateMachine, AsyncActorLogic, ContextFrom, DoneActorEvent, EmittedFrom, EventFromLogic, EventObject, InputFrom, MachineContext, MetaObject, NonReducibleUnknown, OutputFrom, SetupReturnFromConfig, SetupStateSchema, SnapshotFrom, StateValue, StateValueFrom } from "xstate";
 
 //#region src/type-helpers.d.ts
@@ -739,4 +739,4 @@ interface ProvideExecutorsOptions<TMachine extends AnyStateMachine = AnyStateMac
  */
 declare function provideExecutors<TMachine extends AnyStateMachine>(machine: TMachine, executors: AgentRequestExecutors, options?: ProvideExecutorsOptions<TMachine>): TMachine;
 //#endregion
-export { AGENT_TRACE_SCHEMA_VERSION, AGENT_USAGE_EVENT_TYPE, type AgentCallUsage, type AgentDecisionExecutor, AgentDecisionExhaustedError, type AgentDecisionInput, type AgentDecisionRequest, type AgentDefaultMeta, AgentError, type AgentEventDescriptor, AgentEventLogConflictError, type AgentEventLogStore, type AgentExecutorDecisionRequest, type AgentExecutorTextRequest, type AgentFinishReason, type AgentInputFrom, type AgentInteraction, type AgentInteractionDescriptor, type AgentInteractionEvent, type AgentInteractionEventMeta, type AgentInteractionMeta, AgentInvalidEventPayloadError, type AgentLogEntry, AgentMachineVersionMismatchError, AgentMaxModelCallsExceededError, type AgentMessage, type AgentModelRef, type AgentOutputMode, type AgentRequest, type AgentRequestExecutor, type AgentRequestExecutorInfo, type AgentRequestExecutorResult, type AgentRequestExecutors, type AgentRequestOptions, type AgentRequestSource, type AgentRunMeta, type AgentSchemaPack, type AgentSchemas, AgentSnapshotDivergedError, type AgentStep, type AgentStepRequest, type AgentStreamEvent, type AgentTextRequest, type AgentTextResult, type AgentTool, type AgentToolChoice, type AgentToolDescriptor, type AgentToolExecute, type AgentTools, type AgentTraceEvent, type AgentTransitionHandler, AgentTruncatedError, type AgentUsage, type AgentUsageEvent, type AgentUsageEventPayload, type AgentWorkflowActionConfig, type AgentWorkflowActorConfig, type AgentWorkflowConfig, type AgentWorkflowInvokeConfig, type AgentWorkflowRequestConfig, type AgentWorkflowStateConfig, type AgentWorkflowTransitionConfig, type AllowedEvents, type AssistantMessage, type ChosenEvent, type ContextOf, type CreateDecisionRequestOptions, type DecisionAttempt, type DecisionLogic, type DecisionLogicConfig, type DoneActorEventOf, type EventOf, type FilePart, type FromConfigOptions, type FromConfigResult, type GetInteractionOptions, type ImagePart, type InferInput, type InferOutput, type InputOf, type InspectedActorRef, type JsonSerializableTraceEvent, type MetaOf, type OutputOf, type ProvideExecutorsOptions, type ProviderStructuredOutput, type RequestNamesOf, type ResolveDecisionOptions, type RunAgentErrorCause, type RunAgentOptions, type RunAgentResult, type SchemaCompiler, type ScriptedByName, type ScriptedDecisionEntry, type ScriptedDecisionValue, type ScriptedExecutors, type ScriptedExecutorsScript, type ScriptedTextEntry, type SnapshotOf, type StandardSchemaV1, type StateValueOf, type SystemMessage, type TextLogic, type TextLogicConfig, type TextLogicExecuteArgs, type TextLogicExecutor, type TextPart, type ToolCallPart, type ToolMessage, type ToolResultPart, type UserMessage, type WithAgentEvents, type WithAgentUsageEvent, assistantMessage, bindRequestExecutor, createAgentSchemas, createDecisionLogic, createDecisionRequest, createTextLogic, eventFromInteraction, executeAgentRequest, getAcceptedEvents, getAgentOutputMode, getAgentSchemas, getCallFinishReason, getCallUsage, getInteraction, getJsonSchema, getJsonSchemaSync, getMachineStructuralHash, getMessageText, getStateMeta, getStatePath, initialAgentStep, inspectTransitions, interactionMetaSchema, isAgentIdle, isAgentMessages, isStandardSchema, messagesSchema, parseAgentEvent, parseOutput, parseProviderOutput, provideExecutors, providerOutputSchema, rejectAgentStep, renderDecisionAttempts, resolveAgentStep, resolveDecision, runAgent, runAgentStream, serializeTraceEvent, setupAgent, systemMessage, toolMessage, traceTransitions, transitionAgentStep, userMessage };
+export { AGENT_TRACE_SCHEMA_VERSION, AGENT_USAGE_EVENT_TYPE, type AgentCallUsage, type AgentDecisionExecutor, AgentDecisionExhaustedError, type AgentDecisionInput, type AgentDecisionRequest, type AgentDefaultMeta, AgentError, type AgentEventDescriptor, AgentEventLogConflictError, type AgentEventLogStore, type AgentExecutorDecisionRequest, type AgentExecutorTextRequest, type AgentFinishReason, type AgentInputFrom, type AgentInteraction, type AgentInteractionDescriptor, type AgentInteractionEvent, type AgentInteractionEventMeta, type AgentInteractionMeta, AgentInvalidEventPayloadError, type AgentLogEntry, AgentMachineVersionMismatchError, AgentMaxModelCallsExceededError, type AgentMessage, type AgentModelRef, type AgentOutputMode, type AgentRequest, type AgentRequestExecutor, type AgentRequestExecutorInfo, type AgentRequestExecutorResult, type AgentRequestExecutors, type AgentRequestOptions, type AgentRequestSource, type AgentRunMeta, type AgentSchemaPack, type AgentSchemas, AgentSnapshotDivergedError, type AgentStep, type AgentStepRequest, type AgentStreamEvent, type AgentTextRequest, type AgentTextResult, type AgentTool, type AgentToolChoice, type AgentToolDescriptor, type AgentToolExecute, type AgentTools, type AgentTraceEvent, type AgentTransitionHandler, AgentTruncatedError, type AgentUsage, type AgentUsageEvent, type AgentUsageEventPayload, type AgentWorkflowActionConfig, type AgentWorkflowActorConfig, type AgentWorkflowConfig, type AgentWorkflowInvokeConfig, type AgentWorkflowRequestConfig, type AgentWorkflowStateConfig, type AgentWorkflowTransitionConfig, type AllowedEvents, type AssistantMessage, type ChosenEvent, type ContextOf, type CreateDecisionRequestOptions, type DecisionAttempt, type DecisionLogic, type DecisionLogicConfig, type DoneActorEventOf, type EventOf, type FilePart, type FromConfigOptions, type FromConfigResult, type GetInteractionOptions, type ImagePart, type InferInput, type InferOutput, type InputOf, type InspectedActorRef, type JsonSerializableTraceEvent, type MetaOf, type OutputOf, type ProvideExecutorsOptions, type ProviderStructuredOutput, type RequestNamesOf, type ResolveDecisionOptions, type RunAgentErrorCause, type RunAgentOptions, type RunAgentResult, type SchemaCompiler, type SnapshotOf, type StandardSchemaV1, type StateValueOf, type SystemMessage, type TextLogic, type TextLogicConfig, type TextLogicExecuteArgs, type TextLogicExecutor, type TextPart, type ToolCallPart, type ToolMessage, type ToolResultPart, type UserMessage, type WithAgentEvents, type WithAgentUsageEvent, assistantMessage, bindRequestExecutor, createAgentSchemas, createDecisionLogic, createDecisionRequest, createTextLogic, eventFromInteraction, executeAgentRequest, getAcceptedEvents, getAgentOutputMode, getAgentSchemas, getCallFinishReason, getCallUsage, getInteraction, getJsonSchema, getJsonSchemaSync, getMachineStructuralHash, getMessageText, getStateMeta, getStatePath, initialAgentStep, inspectTransitions, interactionMetaSchema, isAgentIdle, isAgentMessages, isStandardSchema, messagesSchema, parseAgentEvent, parseOutput, parseProviderOutput, provideExecutors, providerOutputSchema, rejectAgentStep, renderDecisionAttempts, resolveAgentStep, resolveDecision, runAgent, runAgentStream, serializeTraceEvent, setupAgent, systemMessage, toolMessage, traceTransitions, transitionAgentStep, userMessage };

package/dist/index.d.mts

@@ -2,7 +2,7 @@ import { C as UserMessage, S as ToolResultPart, _ as StandardSchemaV1, a as Agen
 import { A as AgentDecisionExhaustedError, B as createDecisionRequest, C as getAgentOutputMode, D as parseProviderOutput, E as parseOutput, F as DecisionAttempt, G as AgentRequestOptions, H as resolveDecision, I as DecisionLogic, J as EventFromSnapshot, K as AgentRequestSource, L as DecisionLogicConfig, M as AgentDecisionRequest, N as AgentExecutorDecisionRequest, O as providerOutputSchema, P as CreateDecisionRequestOptions, Q as AgentTruncatedError, R as ResolveDecisionOptions, S as createTextLogic, T as getCallUsage, U as AgentEventDescriptor, V as renderDecisionAttempts, W as AgentInvalidEventPayloadError, X as parseAgentEvent, Y as getAcceptedEvents, Z as AgentError, _ as TextLogic, a as AgentModelRef, b as TextLogicExecutor, c as AgentRequestExecutorInfo, d as AgentRequestMode, f as AgentTextRequest, g as ProviderStructuredOutput, h as BuiltinAgentActors, i as AgentModelMap, j as AgentDecisionInput, k as AgentDecisionExecutor, l as AgentRequestExecutorResult, m as AgentUsage, n as AgentExecutorTextRequest, o as AgentOutputMode, p as AgentTextResult, q as AgentSchemas, 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 createDecisionLogic } from "./text-logic-hZSiRUo1.mjs";
 import { C as rejectAgentStep, D as AgentUsageEvent, E as AGENT_USAGE_EVENT_TYPE, S as initialAgentStep, T as transitionAgentStep, _ as traceTransitions, a as AgentSnapshotDivergedError, b as AgentStepRequest, c as InspectedActorRef, d as RunAgentOptions, f as RunAgentResult, g as serializeTraceEvent, h as runAgent, i as AgentRunMeta, l as JsonSerializableTraceEvent, m as isAgentIdle, n as AgentInputFrom, o as AgentTraceEvent, p as inspectTransitions, r as AgentMaxModelCallsExceededError, s as AgentTransitionHandler, t as AGENT_TRACE_SCHEMA_VERSION, u as RunAgentErrorCause, v as AgentRequest, w as resolveAgentStep, x as executeAgentRequest, y as AgentStep } from "./run-agent-CG343kFs.mjs";
 import { c as AgentLogEntry, d as AgentMachineVersionMismatchError, n as AgentEventLogStore, t as AgentEventLogConflictError } from "./event-log-store-DxyVgnas.mjs";
-import { _ as ScriptedExecutorsScript, a as getMachineStructuralHash, c as getStatePath, d as toolMessage, f as userMessage, g as ScriptedExecutors, h as ScriptedDecisionValue, i as getJsonSchemaSync, l as isStandardSchema, m as ScriptedDecisionEntry, n as assistantMessage, o as getMessageText, p as ScriptedByName, r as getJsonSchema, s as getStateMeta, u as systemMessage, v as ScriptedTextEntry } from "./utils-C1p37X_c.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-C2DPqomn.mjs";
 import { AnyActorLogic, AnyMachineSnapshot, AnySetupConfig, AnyStateMachine, AsyncActorLogic, ContextFrom, DoneActorEvent, EmittedFrom, EventFromLogic, EventObject, InputFrom, MachineContext, MetaObject, NonReducibleUnknown, OutputFrom, SetupReturnFromConfig, SetupStateSchema, SnapshotFrom, StateValue, StateValueFrom } from "xstate";
 
 //#region src/type-helpers.d.ts
@@ -739,4 +739,4 @@ interface ProvideExecutorsOptions<TMachine extends AnyStateMachine = AnyStateMac
  */
 declare function provideExecutors<TMachine extends AnyStateMachine>(machine: TMachine, executors: AgentRequestExecutors, options?: ProvideExecutorsOptions<TMachine>): TMachine;
 //#endregion
-export { AGENT_TRACE_SCHEMA_VERSION, AGENT_USAGE_EVENT_TYPE, type AgentCallUsage, type AgentDecisionExecutor, AgentDecisionExhaustedError, type AgentDecisionInput, type AgentDecisionRequest, type AgentDefaultMeta, AgentError, type AgentEventDescriptor, AgentEventLogConflictError, type AgentEventLogStore, type AgentExecutorDecisionRequest, type AgentExecutorTextRequest, type AgentFinishReason, type AgentInputFrom, type AgentInteraction, type AgentInteractionDescriptor, type AgentInteractionEvent, type AgentInteractionEventMeta, type AgentInteractionMeta, AgentInvalidEventPayloadError, type AgentLogEntry, AgentMachineVersionMismatchError, AgentMaxModelCallsExceededError, type AgentMessage, type AgentModelRef, type AgentOutputMode, type AgentRequest, type AgentRequestExecutor, type AgentRequestExecutorInfo, type AgentRequestExecutorResult, type AgentRequestExecutors, type AgentRequestOptions, type AgentRequestSource, type AgentRunMeta, type AgentSchemaPack, type AgentSchemas, AgentSnapshotDivergedError, type AgentStep, type AgentStepRequest, type AgentStreamEvent, type AgentTextRequest, type AgentTextResult, type AgentTool, type AgentToolChoice, type AgentToolDescriptor, type AgentToolExecute, type AgentTools, type AgentTraceEvent, type AgentTransitionHandler, AgentTruncatedError, type AgentUsage, type AgentUsageEvent, type AgentUsageEventPayload, type AgentWorkflowActionConfig, type AgentWorkflowActorConfig, type AgentWorkflowConfig, type AgentWorkflowInvokeConfig, type AgentWorkflowRequestConfig, type AgentWorkflowStateConfig, type AgentWorkflowTransitionConfig, type AllowedEvents, type AssistantMessage, type ChosenEvent, type ContextOf, type CreateDecisionRequestOptions, type DecisionAttempt, type DecisionLogic, type DecisionLogicConfig, type DoneActorEventOf, type EventOf, type FilePart, type FromConfigOptions, type FromConfigResult, type GetInteractionOptions, type ImagePart, type InferInput, type InferOutput, type InputOf, type InspectedActorRef, type JsonSerializableTraceEvent, type MetaOf, type OutputOf, type ProvideExecutorsOptions, type ProviderStructuredOutput, type RequestNamesOf, type ResolveDecisionOptions, type RunAgentErrorCause, type RunAgentOptions, type RunAgentResult, type SchemaCompiler, type ScriptedByName, type ScriptedDecisionEntry, type ScriptedDecisionValue, type ScriptedExecutors, type ScriptedExecutorsScript, type ScriptedTextEntry, type SnapshotOf, type StandardSchemaV1, type StateValueOf, type SystemMessage, type TextLogic, type TextLogicConfig, type TextLogicExecuteArgs, type TextLogicExecutor, type TextPart, type ToolCallPart, type ToolMessage, type ToolResultPart, type UserMessage, type WithAgentEvents, type WithAgentUsageEvent, assistantMessage, bindRequestExecutor, createAgentSchemas, createDecisionLogic, createDecisionRequest, createTextLogic, eventFromInteraction, executeAgentRequest, getAcceptedEvents, getAgentOutputMode, getAgentSchemas, getCallFinishReason, getCallUsage, getInteraction, getJsonSchema, getJsonSchemaSync, getMachineStructuralHash, getMessageText, getStateMeta, getStatePath, initialAgentStep, inspectTransitions, interactionMetaSchema, isAgentIdle, isAgentMessages, isStandardSchema, messagesSchema, parseAgentEvent, parseOutput, parseProviderOutput, provideExecutors, providerOutputSchema, rejectAgentStep, renderDecisionAttempts, resolveAgentStep, resolveDecision, runAgent, runAgentStream, serializeTraceEvent, setupAgent, systemMessage, toolMessage, traceTransitions, transitionAgentStep, userMessage };
+export { AGENT_TRACE_SCHEMA_VERSION, AGENT_USAGE_EVENT_TYPE, type AgentCallUsage, type AgentDecisionExecutor, AgentDecisionExhaustedError, type AgentDecisionInput, type AgentDecisionRequest, type AgentDefaultMeta, AgentError, type AgentEventDescriptor, AgentEventLogConflictError, type AgentEventLogStore, type AgentExecutorDecisionRequest, type AgentExecutorTextRequest, type AgentFinishReason, type AgentInputFrom, type AgentInteraction, type AgentInteractionDescriptor, type AgentInteractionEvent, type AgentInteractionEventMeta, type AgentInteractionMeta, AgentInvalidEventPayloadError, type AgentLogEntry, AgentMachineVersionMismatchError, AgentMaxModelCallsExceededError, type AgentMessage, type AgentModelRef, type AgentOutputMode, type AgentRequest, type AgentRequestExecutor, type AgentRequestExecutorInfo, type AgentRequestExecutorResult, type AgentRequestExecutors, type AgentRequestOptions, type AgentRequestSource, type AgentRunMeta, type AgentSchemaPack, type AgentSchemas, AgentSnapshotDivergedError, type AgentStep, type AgentStepRequest, type AgentStreamEvent, type AgentTextRequest, type AgentTextResult, type AgentTool, type AgentToolChoice, type AgentToolDescriptor, type AgentToolExecute, type AgentTools, type AgentTraceEvent, type AgentTransitionHandler, AgentTruncatedError, type AgentUsage, type AgentUsageEvent, type AgentUsageEventPayload, type AgentWorkflowActionConfig, type AgentWorkflowActorConfig, type AgentWorkflowConfig, type AgentWorkflowInvokeConfig, type AgentWorkflowRequestConfig, type AgentWorkflowStateConfig, type AgentWorkflowTransitionConfig, type AllowedEvents, type AssistantMessage, type ChosenEvent, type ContextOf, type CreateDecisionRequestOptions, type DecisionAttempt, type DecisionLogic, type DecisionLogicConfig, type DoneActorEventOf, type EventOf, type FilePart, type FromConfigOptions, type FromConfigResult, type GetInteractionOptions, type ImagePart, type InferInput, type InferOutput, type InputOf, type InspectedActorRef, type JsonSerializableTraceEvent, type MetaOf, type OutputOf, type ProvideExecutorsOptions, type ProviderStructuredOutput, type RequestNamesOf, type ResolveDecisionOptions, type RunAgentErrorCause, type RunAgentOptions, type RunAgentResult, type SchemaCompiler, type SnapshotOf, type StandardSchemaV1, type StateValueOf, type SystemMessage, type TextLogic, type TextLogicConfig, type TextLogicExecuteArgs, type TextLogicExecutor, type TextPart, type ToolCallPart, type ToolMessage, type ToolResultPart, type UserMessage, type WithAgentEvents, type WithAgentUsageEvent, assistantMessage, bindRequestExecutor, createAgentSchemas, createDecisionLogic, createDecisionRequest, createTextLogic, eventFromInteraction, executeAgentRequest, getAcceptedEvents, getAgentOutputMode, getAgentSchemas, getCallFinishReason, getCallUsage, getInteraction, getJsonSchema, getJsonSchemaSync, getMachineStructuralHash, getMessageText, getStateMeta, getStatePath, initialAgentStep, inspectTransitions, interactionMetaSchema, isAgentIdle, isAgentMessages, isStandardSchema, messagesSchema, parseAgentEvent, parseOutput, parseProviderOutput, provideExecutors, providerOutputSchema, rejectAgentStep, renderDecisionAttempts, resolveAgentStep, resolveDecision, runAgent, runAgentStream, serializeTraceEvent, setupAgent, systemMessage, toolMessage, traceTransitions, transitionAgentStep, userMessage };

package/dist/testing.cjs

@@ -870,43 +870,7 @@ function matchesTrajectory(actual, expected, options = {}) {
 	};
 }
 //#endregion
-//#region src/scripted-executors.ts
-/**
-* Scripted executors — a deterministic stand-in for a model host.
-*
-* `createScriptedExecutors` builds a full `{ generateText, streamText, decide }`
-* set that plays back canned answers keyed by
-* request name, so `runAgent` (or `provideExecutors`, or a bare
-* `TextLogic.execute`) runs with no API key and no network.
-*
-* One rule: entries for a name are consumed in order, and the last entry
-* repeats forever.
-*
-* @module
-*/
-function toQueues(value) {
-	return new Map(Object.entries(value ?? {}).map(([name, entries]) => [name, {
-		entries: Array.isArray(entries) ? [...entries] : [entries],
-		index: 0
-	}]));
-}
-/**
-* Takes the next entry for `name`, holding on the last entry once the list is
-* spent. `undefined` means the script has no route for this name at all.
-* @internal
-*/
-function takeEntry(queues, name) {
-	const queue = queues.get(name) ?? queues.get("*");
-	if (!queue || queue.entries.length === 0) return;
-	const entry = queue.entries[Math.min(queue.index, queue.entries.length - 1)];
-	queue.index++;
-	return entry;
-}
-/** @internal */
-function noAnswer(name, queues) {
-	const known = [...queues.keys()].join(", ") || "(none)";
-	return /* @__PURE__ */ new Error(`No scripted answer for request '${name}'. Known: ${known}`);
-}
+//#region src/seam.ts
 /** The only own keys an executor result carries. @internal */
 const TEXT_RESULT_KEYS = new Set([
 	"result",
@@ -925,123 +889,26 @@ function isTextResult(value) {
 	return Object.hasOwn(value, "result") && Object.keys(value).every((key) => TEXT_RESULT_KEYS.has(key));
 }
 /**
-* Resolves ONE scripted text entry to an executor result: a function entry is
+* Resolves ONE scripted entry to an executor result: a function entry is
 * called with the request, and the value is taken as the executor result only
-* when it is one (see {@link isTextResult}). Shared with `runSeam`, whose routed
-* queues follow the same entry conventions. @internal
+* when it is one (see {@link isTextResult}). @internal
 */
-async function resolveScriptedTextEntry(entry, request, info) {
+async function resolveSeamScriptEntry(entry, request, info) {
 	const value = typeof entry === "function" ? await entry(request, info) : entry;
 	return require_decision.isRecord(value) && isTextResult(value) ? value : { result: value };
 }
-/**
-* Names a pending text request in an error message. Shared with `runSeam`.
-* @internal
-*/
+/** Names a pending text request in an error message. @internal */
 function describeText(request) {
 	return request.name ? `'${request.name}' (model '${request.model}')` : `(model '${request.model}')`;
 }
 /**
-* Stream semantics with no model: the whole text lands as one chunk. Shared
-* with `runSeam`, whose scripted answers stream the same way. @internal
+* Stream semantics with no model: the whole text lands as one chunk. @internal
 */
 function emitScriptedChunk(result, info) {
 	const text = require_decision.isRecord(result) ? result["result"] : void 0;
 	if (typeof text === "string") info?.onChunk?.(text);
 }
 /**
-* Executors that replay a script instead of calling a model. Every slot is
-* provided, so any machine binds.
-*
-* Answers are keyed by the request's resolved name — its authored `name`, else
-* the invoke `id` — and `"*"` serves anything unmatched.
-* Entries for a name are consumed in order and the last one repeats forever, so
-* a looping machine needs no extra option. A request the script has no route
-* for throws an ordinary `Error` from inside the executor, which reaches the
-* machine as an actor error.
-*
-* Queues are copied on creation, so the caller's arrays are never mutated and
-* each call builds a fresh, independent playthrough. Entries may be plain
-* values or functions of the request.
-*
-* @example
-* ```ts
-* const result = await runAgent(moderationMachine, {
-*   input: { comment: 'honestly this update is terrible', trust: 20 },
-*   executors: createScriptedExecutors({
-*     decisions: { moderate: [{ type: 'FLAG', reason: 'Borderline tone.' }] },
-*   }),
-* });
-* ```
-*
-* @example Dynamic entries
-* ```ts
-* createScriptedExecutors({
-*   text: { draft: (request) => `Draft about ${request.prompt}` },
-*   decisions: { route: (request) => ({ type: request.events[0]!.type }) },
-* });
-* ```
-*/
-function createScriptedExecutors(script = {}) {
-	const decisions = toQueues(script.decisions);
-	const text = toQueues(script.text);
-	const calls = [];
-	const withDefaultUsage = (result) => result.usage || !script.usage ? result : {
-		...result,
-		usage: script.usage
-	};
-	const nextText = async (kind, request, info) => {
-		const name = request.name ?? "*";
-		calls.push({
-			kind,
-			name,
-			input: request.input,
-			request
-		});
-		const entry = takeEntry(text, name);
-		if (entry === void 0) throw noAnswer(name, text);
-		return withDefaultUsage(await resolveScriptedTextEntry(entry, request, info));
-	};
-	return {
-		calls,
-		generateText: (request, info) => nextText("generateText", request, info),
-		streamText: async (request, info) => {
-			const name = request.name ?? "*";
-			const streamEntry = script.stream?.[name] ?? script.stream?.["*"];
-			if (streamEntry !== void 0) {
-				calls.push({
-					kind: "streamText",
-					name,
-					input: request.input,
-					request
-				});
-				const resolved = typeof streamEntry === "function" ? await streamEntry(request, info) : streamEntry;
-				const chunks = typeof resolved === "string" ? [resolved] : [...resolved];
-				for (const chunk of chunks) info?.onChunk?.(chunk);
-				return withDefaultUsage({ result: chunks.join("") });
-			}
-			const result = await nextText("streamText", request, info);
-			emitScriptedChunk(result, info);
-			return result;
-		},
-		decide: async (request) => {
-			const name = request.name ?? request.id;
-			calls.push({
-				kind: "decide",
-				name,
-				input: request.input,
-				request
-			});
-			const entry = takeEntry(decisions, name);
-			if (entry === void 0) throw noAnswer(name, decisions);
-			const value = typeof entry === "function" ? await entry(request) : entry;
-			return withDefaultUsage(require_decision.isRecord(value) && typeof value["type"] !== "string" && "event" in value ? value : { event: value });
-		}
-	};
-}
-//#endregion
-//#region src/seam.ts
-/**
 * The seam's own answer, for scoring: the executor result's `result`.
 * @internal
 */
@@ -1063,8 +930,8 @@ async function seamOutputOf(result, request) {
 * @example No API key: the seam is scripted too, so the whole thing runs offline.
 * ```ts
 * const run = await runSeam(emailDrafter, {
-*   scripts: { promptEvaluator: [vague, complete], emailDrafter: [draft] },
-*   seam: { request: 'evaluatePrompt' },
+*   scripts: { writeFollowUps: [followUps], emailDrafter: [draft] },
+*   seam: { request: 'writeFollowUps' },
 *   respond: ({ state }) => (state === 'prompting' ? { type: 'PROMPT_SUBMITTED', prompt } : null),
 * });
 *
@@ -1100,7 +967,7 @@ async function runSeam(machine, options) {
 	const takeScriptedSlot = async (request, info) => {
 		const queue = queues.get(queueKeyOf(request));
 		if (!queue?.length) return;
-		return resolveScriptedTextEntry(options.repeatLast && queue.length === 1 ? queue[0] : queue.shift(), request, info);
+		return resolveSeamScriptEntry(options.repeatLast && queue.length === 1 ? queue[0] : queue.shift(), request, info);
 	};
 	const scriptedAnswer = async (request, info) => {
 		const scripted = await takeScriptedSlot(request, info);
@@ -1214,7 +1081,6 @@ exports.AgentLintError = AgentLintError;
 exports.AgentUnknownStateError = AgentUnknownStateError;
 exports.assertAgentMachine = assertAgentMachine;
 exports.canReach = canReach;
-exports.createScriptedExecutors = createScriptedExecutors;
 exports.explorePaths = explorePaths;
 exports.lintAgentMachine = lintAgentMachine;
 exports.matchesTrajectory = matchesTrajectory;

package/dist/testing.d.cts

@@ -1,7 +1,7 @@
 import { u as ChosenEvent } from "./types-B1Qs2q3q.cjs";
-import { Z as AgentError, s as AgentRequestExecutor, t as AgentCallUsage, u as AgentRequestExecutors } from "./text-logic-BFEOxyxv.cjs";
+import { Z as AgentError, c as AgentRequestExecutorInfo, f as AgentTextRequest, s as AgentRequestExecutor, t as AgentCallUsage, u as AgentRequestExecutors } from "./text-logic-BFEOxyxv.cjs";
 import { d as RunAgentOptions, f as RunAgentResult } from "./run-agent-BOfoJg5B.cjs";
-import { _ as ScriptedExecutorsScript, g as ScriptedExecutors, h as ScriptedDecisionValue, m as ScriptedDecisionEntry, p as ScriptedByName, t as MetaOfSnapshot, v as ScriptedTextEntry, y as createScriptedExecutors } from "./utils-RalRn9sk.cjs";
+import { t as MetaOfSnapshot } from "./utils-ceStNCOh.cjs";
 import { AnyMachineSnapshot, AnyStateMachine, EventFromLogic, InputFrom, SnapshotFrom, StateValue } from "xstate";
 
 //#region src/verify.d.ts
@@ -435,6 +435,20 @@ interface TrajectoryMatch {
 declare function matchesTrajectory(actual: readonly unknown[], expected: readonly TrajectoryItem[], options?: MatchTrajectoryOptions): TrajectoryMatch;
 //#endregion
 //#region src/seam.d.ts
+/**
+ * One scripted answer in a {@link RunSeamOptions.scripts} queue: the request's
+ * output value (a string, or the object a structured request declares), or a
+ * function of the {@link AgentTextRequest} returning one.
+ *
+ * An entry is taken as the executor result (instead of the value itself)
+ * only when its OWN keys are a `result` plus, optionally, `messages`/`usage`/
+ * `raw` — that is how an entry reports token `usage`. Anything else, including
+ * an object that merely happens to have a `result` key alongside its own data
+ * (`{ result: 'draft', confidence: 0.9 }`), is the output value. For a
+ * structured request whose declared output is exactly `{ result }` (or
+ * `{ result, usage }`), wrap it once more: `{ result: { result: '…' } }`.
+ */
+type SeamScriptEntry = ((request: AgentTextRequest, info?: AgentRequestExecutorInfo) => unknown) | string | number | boolean | null | object;
 /**
  * Which model call is under test: the Nth call with this request `name` (the
  * `setupAgent({ requests })` key, or `createTextLogic({ name })`). Name the
@@ -505,12 +519,12 @@ interface RunSeamOptions<TMachine extends AnyStateMachine> {
    * machine whose requests are named routes by name and an unnamed one routes
    * by model.
    *
-   * Entries follow {@link ScriptedTextEntry} conventions (a value, an
+   * Entries follow {@link SeamScriptEntry} conventions (a value, an
    * `{ result, usage? }` object, or a function of the request). A queue that
    * runs dry throws; set {@link RunSeamOptions.repeatLast} to replay its last
    * entry instead.
    */
-  scripts?: Record<string, ScriptedTextEntry[]>;
+  scripts?: Record<string, SeamScriptEntry[]>;
   /**
    * Replay the LAST entry of a queue once it is exhausted, so a live seam that
    * sends the run down a longer branch still finds an answer. Off by default:
@@ -534,8 +548,9 @@ interface RunSeamOptions<TMachine extends AnyStateMachine> {
   /** Maximum idle pauses to answer before stopping. Default `12`. */
   maxTurns?: number;
   /**
-   * Base executors merged UNDER the seam routing — supply `decide` (e.g. from
-   * `createScriptedExecutors({ decisions })`) for a machine that also decides.
+   * Base executors merged UNDER the seam routing — supply `decide` (a plain
+   * function of the decision request, or `createAiSdkExecutors` over a mock
+   * model) for a machine that also decides.
    * Text slots are always owned by the routing.
    */
   executors?: Partial<AgentRequestExecutors>;
@@ -583,8 +598,8 @@ interface RunSeamResult<TMachine extends AnyStateMachine> {
  * @example No API key: the seam is scripted too, so the whole thing runs offline.
  * ```ts
  * const run = await runSeam(emailDrafter, {
- *   scripts: { promptEvaluator: [vague, complete], emailDrafter: [draft] },
- *   seam: { request: 'evaluatePrompt' },
+ *   scripts: { writeFollowUps: [followUps], emailDrafter: [draft] },
+ *   seam: { request: 'writeFollowUps' },
  *   respond: ({ state }) => (state === 'prompting' ? { type: 'PROMPT_SUBMITTED', prompt } : null),
  * });
  *
@@ -599,4 +614,4 @@ interface RunSeamResult<TMachine extends AnyStateMachine> {
  */
 declare function runSeam<TMachine extends AnyStateMachine>(machine: TMachine, options: RunSeamOptions<TMachine>): Promise<RunSeamResult<TMachine>>;
 //#endregion
-export { type AgentLintDiagnostic, AgentLintError, type AgentLintSeverity, type AgentPathReport, type AgentPathTerminal, AgentUnknownStateError, type AssertAgentMachineOptions, type CanReachResult, type ExplorePathsOptions, type LintAgentMachineOptions, type MatchTrajectoryOptions, type RunSeamOptions, type RunSeamResult, type ScriptedByName, type ScriptedDecisionEntry, type ScriptedDecisionValue, type ScriptedExecutors, type ScriptedExecutorsScript, type ScriptedTextEntry, type SeamCall, type SeamRef, type SeamSlice, type SeamTurn, type SimulateAgentOptions, type SimulateAgentResult, type SimulationScript, type SimulationTrailEntry, type TrajectoryEvent, type TrajectoryItem, type TrajectoryMatch, type TrajectoryMiss, assertAgentMachine, canReach, createScriptedExecutors, explorePaths, lintAgentMachine, matchesTrajectory, runSeam, simulateAgent };
+export { type AgentLintDiagnostic, AgentLintError, type AgentLintSeverity, type AgentPathReport, type AgentPathTerminal, AgentUnknownStateError, type AssertAgentMachineOptions, type CanReachResult, type ExplorePathsOptions, type LintAgentMachineOptions, type MatchTrajectoryOptions, type RunSeamOptions, type RunSeamResult, type SeamCall, type SeamRef, type SeamScriptEntry, type SeamSlice, type SeamTurn, type SimulateAgentOptions, type SimulateAgentResult, type SimulationScript, type SimulationTrailEntry, type TrajectoryEvent, type TrajectoryItem, type TrajectoryMatch, type TrajectoryMiss, assertAgentMachine, canReach, explorePaths, lintAgentMachine, matchesTrajectory, runSeam, simulateAgent };

package/dist/testing.d.mts

@@ -1,7 +1,7 @@
 import { u as ChosenEvent } from "./types-tA3SdczG.mjs";
-import { Z as AgentError, s as AgentRequestExecutor, t as AgentCallUsage, u as AgentRequestExecutors } from "./text-logic-hZSiRUo1.mjs";
+import { Z as AgentError, c as AgentRequestExecutorInfo, f as AgentTextRequest, s as AgentRequestExecutor, t as AgentCallUsage, u as AgentRequestExecutors } from "./text-logic-hZSiRUo1.mjs";
 import { d as RunAgentOptions, f as RunAgentResult } from "./run-agent-CG343kFs.mjs";
-import { _ as ScriptedExecutorsScript, g as ScriptedExecutors, h as ScriptedDecisionValue, m as ScriptedDecisionEntry, p as ScriptedByName, t as MetaOfSnapshot, v as ScriptedTextEntry, y as createScriptedExecutors } from "./utils-C1p37X_c.mjs";
+import { t as MetaOfSnapshot } from "./utils-C2DPqomn.mjs";
 import { AnyMachineSnapshot, AnyStateMachine, EventFromLogic, InputFrom, SnapshotFrom, StateValue } from "xstate";
 
 //#region src/verify.d.ts
@@ -435,6 +435,20 @@ interface TrajectoryMatch {
 declare function matchesTrajectory(actual: readonly unknown[], expected: readonly TrajectoryItem[], options?: MatchTrajectoryOptions): TrajectoryMatch;
 //#endregion
 //#region src/seam.d.ts
+/**
+ * One scripted answer in a {@link RunSeamOptions.scripts} queue: the request's
+ * output value (a string, or the object a structured request declares), or a
+ * function of the {@link AgentTextRequest} returning one.
+ *
+ * An entry is taken as the executor result (instead of the value itself)
+ * only when its OWN keys are a `result` plus, optionally, `messages`/`usage`/
+ * `raw` — that is how an entry reports token `usage`. Anything else, including
+ * an object that merely happens to have a `result` key alongside its own data
+ * (`{ result: 'draft', confidence: 0.9 }`), is the output value. For a
+ * structured request whose declared output is exactly `{ result }` (or
+ * `{ result, usage }`), wrap it once more: `{ result: { result: '…' } }`.
+ */
+type SeamScriptEntry = ((request: AgentTextRequest, info?: AgentRequestExecutorInfo) => unknown) | string | number | boolean | null | object;
 /**
  * Which model call is under test: the Nth call with this request `name` (the
  * `setupAgent({ requests })` key, or `createTextLogic({ name })`). Name the
@@ -505,12 +519,12 @@ interface RunSeamOptions<TMachine extends AnyStateMachine> {
    * machine whose requests are named routes by name and an unnamed one routes
    * by model.
    *
-   * Entries follow {@link ScriptedTextEntry} conventions (a value, an
+   * Entries follow {@link SeamScriptEntry} conventions (a value, an
    * `{ result, usage? }` object, or a function of the request). A queue that
    * runs dry throws; set {@link RunSeamOptions.repeatLast} to replay its last
    * entry instead.
    */
-  scripts?: Record<string, ScriptedTextEntry[]>;
+  scripts?: Record<string, SeamScriptEntry[]>;
   /**
    * Replay the LAST entry of a queue once it is exhausted, so a live seam that
    * sends the run down a longer branch still finds an answer. Off by default:
@@ -534,8 +548,9 @@ interface RunSeamOptions<TMachine extends AnyStateMachine> {
   /** Maximum idle pauses to answer before stopping. Default `12`. */
   maxTurns?: number;
   /**
-   * Base executors merged UNDER the seam routing — supply `decide` (e.g. from
-   * `createScriptedExecutors({ decisions })`) for a machine that also decides.
+   * Base executors merged UNDER the seam routing — supply `decide` (a plain
+   * function of the decision request, or `createAiSdkExecutors` over a mock
+   * model) for a machine that also decides.
    * Text slots are always owned by the routing.
    */
   executors?: Partial<AgentRequestExecutors>;
@@ -583,8 +598,8 @@ interface RunSeamResult<TMachine extends AnyStateMachine> {
  * @example No API key: the seam is scripted too, so the whole thing runs offline.
  * ```ts
  * const run = await runSeam(emailDrafter, {
- *   scripts: { promptEvaluator: [vague, complete], emailDrafter: [draft] },
- *   seam: { request: 'evaluatePrompt' },
+ *   scripts: { writeFollowUps: [followUps], emailDrafter: [draft] },
+ *   seam: { request: 'writeFollowUps' },
  *   respond: ({ state }) => (state === 'prompting' ? { type: 'PROMPT_SUBMITTED', prompt } : null),
  * });
  *
@@ -599,4 +614,4 @@ interface RunSeamResult<TMachine extends AnyStateMachine> {
  */
 declare function runSeam<TMachine extends AnyStateMachine>(machine: TMachine, options: RunSeamOptions<TMachine>): Promise<RunSeamResult<TMachine>>;
 //#endregion
-export { type AgentLintDiagnostic, AgentLintError, type AgentLintSeverity, type AgentPathReport, type AgentPathTerminal, AgentUnknownStateError, type AssertAgentMachineOptions, type CanReachResult, type ExplorePathsOptions, type LintAgentMachineOptions, type MatchTrajectoryOptions, type RunSeamOptions, type RunSeamResult, type ScriptedByName, type ScriptedDecisionEntry, type ScriptedDecisionValue, type ScriptedExecutors, type ScriptedExecutorsScript, type ScriptedTextEntry, type SeamCall, type SeamRef, type SeamSlice, type SeamTurn, type SimulateAgentOptions, type SimulateAgentResult, type SimulationScript, type SimulationTrailEntry, type TrajectoryEvent, type TrajectoryItem, type TrajectoryMatch, type TrajectoryMiss, assertAgentMachine, canReach, createScriptedExecutors, explorePaths, lintAgentMachine, matchesTrajectory, runSeam, simulateAgent };
+export { type AgentLintDiagnostic, AgentLintError, type AgentLintSeverity, type AgentPathReport, type AgentPathTerminal, AgentUnknownStateError, type AssertAgentMachineOptions, type CanReachResult, type ExplorePathsOptions, type LintAgentMachineOptions, type MatchTrajectoryOptions, type RunSeamOptions, type RunSeamResult, type SeamCall, type SeamRef, type SeamScriptEntry, type SeamSlice, type SeamTurn, type SimulateAgentOptions, type SimulateAgentResult, type SimulationScript, type SimulationTrailEntry, type TrajectoryEvent, type TrajectoryItem, type TrajectoryMatch, type TrajectoryMiss, assertAgentMachine, canReach, explorePaths, lintAgentMachine, matchesTrajectory, runSeam, simulateAgent };

package/dist/testing.mjs

@@ -869,43 +869,7 @@ function matchesTrajectory(actual, expected, options = {}) {
 	};
 }
 //#endregion
-//#region src/scripted-executors.ts
-/**
-* Scripted executors — a deterministic stand-in for a model host.
-*
-* `createScriptedExecutors` builds a full `{ generateText, streamText, decide }`
-* set that plays back canned answers keyed by
-* request name, so `runAgent` (or `provideExecutors`, or a bare
-* `TextLogic.execute`) runs with no API key and no network.
-*
-* One rule: entries for a name are consumed in order, and the last entry
-* repeats forever.
-*
-* @module
-*/
-function toQueues(value) {
-	return new Map(Object.entries(value ?? {}).map(([name, entries]) => [name, {
-		entries: Array.isArray(entries) ? [...entries] : [entries],
-		index: 0
-	}]));
-}
-/**
-* Takes the next entry for `name`, holding on the last entry once the list is
-* spent. `undefined` means the script has no route for this name at all.
-* @internal
-*/
-function takeEntry(queues, name) {
-	const queue = queues.get(name) ?? queues.get("*");
-	if (!queue || queue.entries.length === 0) return;
-	const entry = queue.entries[Math.min(queue.index, queue.entries.length - 1)];
-	queue.index++;
-	return entry;
-}
-/** @internal */
-function noAnswer(name, queues) {
-	const known = [...queues.keys()].join(", ") || "(none)";
-	return /* @__PURE__ */ new Error(`No scripted answer for request '${name}'. Known: ${known}`);
-}
+//#region src/seam.ts
 /** The only own keys an executor result carries. @internal */
 const TEXT_RESULT_KEYS = new Set([
 	"result",
@@ -924,123 +888,26 @@ function isTextResult(value) {
 	return Object.hasOwn(value, "result") && Object.keys(value).every((key) => TEXT_RESULT_KEYS.has(key));
 }
 /**
-* Resolves ONE scripted text entry to an executor result: a function entry is
+* Resolves ONE scripted entry to an executor result: a function entry is
 * called with the request, and the value is taken as the executor result only
-* when it is one (see {@link isTextResult}). Shared with `runSeam`, whose routed
-* queues follow the same entry conventions. @internal
+* when it is one (see {@link isTextResult}). @internal
 */
-async function resolveScriptedTextEntry(entry, request, info) {
+async function resolveSeamScriptEntry(entry, request, info) {
 	const value = typeof entry === "function" ? await entry(request, info) : entry;
 	return isRecord(value) && isTextResult(value) ? value : { result: value };
 }
-/**
-* Names a pending text request in an error message. Shared with `runSeam`.
-* @internal
-*/
+/** Names a pending text request in an error message. @internal */
 function describeText(request) {
 	return request.name ? `'${request.name}' (model '${request.model}')` : `(model '${request.model}')`;
 }
 /**
-* Stream semantics with no model: the whole text lands as one chunk. Shared
-* with `runSeam`, whose scripted answers stream the same way. @internal
+* Stream semantics with no model: the whole text lands as one chunk. @internal
 */
 function emitScriptedChunk(result, info) {
 	const text = isRecord(result) ? result["result"] : void 0;
 	if (typeof text === "string") info?.onChunk?.(text);
 }
 /**
-* Executors that replay a script instead of calling a model. Every slot is
-* provided, so any machine binds.
-*
-* Answers are keyed by the request's resolved name — its authored `name`, else
-* the invoke `id` — and `"*"` serves anything unmatched.
-* Entries for a name are consumed in order and the last one repeats forever, so
-* a looping machine needs no extra option. A request the script has no route
-* for throws an ordinary `Error` from inside the executor, which reaches the
-* machine as an actor error.
-*
-* Queues are copied on creation, so the caller's arrays are never mutated and
-* each call builds a fresh, independent playthrough. Entries may be plain
-* values or functions of the request.
-*
-* @example
-* ```ts
-* const result = await runAgent(moderationMachine, {
-*   input: { comment: 'honestly this update is terrible', trust: 20 },
-*   executors: createScriptedExecutors({
-*     decisions: { moderate: [{ type: 'FLAG', reason: 'Borderline tone.' }] },
-*   }),
-* });
-* ```
-*
-* @example Dynamic entries
-* ```ts
-* createScriptedExecutors({
-*   text: { draft: (request) => `Draft about ${request.prompt}` },
-*   decisions: { route: (request) => ({ type: request.events[0]!.type }) },
-* });
-* ```
-*/
-function createScriptedExecutors(script = {}) {
-	const decisions = toQueues(script.decisions);
-	const text = toQueues(script.text);
-	const calls = [];
-	const withDefaultUsage = (result) => result.usage || !script.usage ? result : {
-		...result,
-		usage: script.usage
-	};
-	const nextText = async (kind, request, info) => {
-		const name = request.name ?? "*";
-		calls.push({
-			kind,
-			name,
-			input: request.input,
-			request
-		});
-		const entry = takeEntry(text, name);
-		if (entry === void 0) throw noAnswer(name, text);
-		return withDefaultUsage(await resolveScriptedTextEntry(entry, request, info));
-	};
-	return {
-		calls,
-		generateText: (request, info) => nextText("generateText", request, info),
-		streamText: async (request, info) => {
-			const name = request.name ?? "*";
-			const streamEntry = script.stream?.[name] ?? script.stream?.["*"];
-			if (streamEntry !== void 0) {
-				calls.push({
-					kind: "streamText",
-					name,
-					input: request.input,
-					request
-				});
-				const resolved = typeof streamEntry === "function" ? await streamEntry(request, info) : streamEntry;
-				const chunks = typeof resolved === "string" ? [resolved] : [...resolved];
-				for (const chunk of chunks) info?.onChunk?.(chunk);
-				return withDefaultUsage({ result: chunks.join("") });
-			}
-			const result = await nextText("streamText", request, info);
-			emitScriptedChunk(result, info);
-			return result;
-		},
-		decide: async (request) => {
-			const name = request.name ?? request.id;
-			calls.push({
-				kind: "decide",
-				name,
-				input: request.input,
-				request
-			});
-			const entry = takeEntry(decisions, name);
-			if (entry === void 0) throw noAnswer(name, decisions);
-			const value = typeof entry === "function" ? await entry(request) : entry;
-			return withDefaultUsage(isRecord(value) && typeof value["type"] !== "string" && "event" in value ? value : { event: value });
-		}
-	};
-}
-//#endregion
-//#region src/seam.ts
-/**
 * The seam's own answer, for scoring: the executor result's `result`.
 * @internal
 */
@@ -1062,8 +929,8 @@ async function seamOutputOf(result, request) {
 * @example No API key: the seam is scripted too, so the whole thing runs offline.
 * ```ts
 * const run = await runSeam(emailDrafter, {
-*   scripts: { promptEvaluator: [vague, complete], emailDrafter: [draft] },
-*   seam: { request: 'evaluatePrompt' },
+*   scripts: { writeFollowUps: [followUps], emailDrafter: [draft] },
+*   seam: { request: 'writeFollowUps' },
 *   respond: ({ state }) => (state === 'prompting' ? { type: 'PROMPT_SUBMITTED', prompt } : null),
 * });
 *
@@ -1099,7 +966,7 @@ async function runSeam(machine, options) {
 	const takeScriptedSlot = async (request, info) => {
 		const queue = queues.get(queueKeyOf(request));
 		if (!queue?.length) return;
-		return resolveScriptedTextEntry(options.repeatLast && queue.length === 1 ? queue[0] : queue.shift(), request, info);
+		return resolveSeamScriptEntry(options.repeatLast && queue.length === 1 ? queue[0] : queue.shift(), request, info);
 	};
 	const scriptedAnswer = async (request, info) => {
 		const scripted = await takeScriptedSlot(request, info);
@@ -1209,4 +1076,4 @@ async function runSeam(machine, options) {
 	};
 }
 //#endregion
-export { AgentLintError, AgentUnknownStateError, assertAgentMachine, canReach, createScriptedExecutors, explorePaths, lintAgentMachine, matchesTrajectory, runSeam, simulateAgent };
+export { AgentLintError, AgentUnknownStateError, assertAgentMachine, canReach, explorePaths, lintAgentMachine, matchesTrajectory, runSeam, simulateAgent };

package/dist/{utils-C1p37X_c.d.mts → utils-C2DPqomn.d.mts}

@@ -1,106 +1,6 @@
-import { C as UserMessage, S as ToolResultPart, _ as StandardSchemaV1, b as ToolCallPart, f as FilePart, l as AssistantMessage, n as AgentMessage, p as ImagePart, u as ChosenEvent, v as SystemMessage, x as ToolMessage, y as TextPart } from "./types-tA3SdczG.mjs";
-import { M as AgentDecisionRequest, c as AgentRequestExecutorInfo, f as AgentTextRequest, t as AgentCallUsage, u as AgentRequestExecutors } from "./text-logic-hZSiRUo1.mjs";
+import { C as UserMessage, S as ToolResultPart, _ as StandardSchemaV1, b as ToolCallPart, f as FilePart, l as AssistantMessage, n as AgentMessage, p as ImagePart, v as SystemMessage, x as ToolMessage, y as TextPart } from "./types-tA3SdczG.mjs";
 import { AnyMachineSnapshot, AnyStateMachine, StateValue } from "xstate";
 
-//#region src/scripted-executors.d.ts
-/**
- * A scripted `decide` answer: either the {@link ChosenEvent} itself (an object
- * with a string `type`), or the executor result `{ event, reason?, usage? }`
- * when the entry also reports a `reason` or token `usage`.
- */
-type ScriptedDecisionValue = ChosenEvent | {
-  event: ChosenEvent;
-  reason?: string;
-  usage?: AgentCallUsage;
-};
-/**
- * One scripted `decide` answer, or a function of the
- * {@link AgentDecisionRequest} returning one (for choices that depend on the
- * prompt, the candidate `events`, or the prior failed `attempts`).
- */
-type ScriptedDecisionEntry = ScriptedDecisionValue | ((request: AgentDecisionRequest) => ScriptedDecisionValue | PromiseLike<ScriptedDecisionValue>);
-/**
- * One scripted text answer: the request's output value (a string, or the
- * object a structured request declares), or a function of the
- * {@link AgentTextRequest} returning one.
- *
- * An entry is taken as the executor result (instead of the value itself)
- * only when its OWN keys are a `result` plus, optionally, `messages`/`usage`/
- * `raw` — that is how an entry reports token `usage`. Anything else, including
- * an object that merely happens to have a `result` key alongside its own data
- * (`{ result: 'draft', confidence: 0.9 }`), is the output value. For a
- * structured request whose declared output is exactly `{ result }` (or
- * `{ result, usage }`), wrap it once more: `{ result: { result: '…' } }`.
- */
-type ScriptedTextEntry = ((request: AgentTextRequest, info?: AgentRequestExecutorInfo) => unknown) | string | number | boolean | null | object;
-/**
- * A request-name keyed script. The key is the request's resolved `name` — the
- * authored name, else the invoke `id`. `"*"` is the fallback route.
- */
-type ScriptedByName<TEntry> = Record<string, TEntry | TEntry[]>;
-/** One scripted stream call: chunks, or a function producing chunks. */
-type ScriptedStreamEntry = string | readonly string[] | ((request: AgentTextRequest, info?: AgentRequestExecutorInfo) => string | readonly string[] | PromiseLike<string | readonly string[]>);
-/** A call observed by {@link createScriptedExecutors}. */
-interface ScriptedExecutorCall {
-  kind: "generateText" | "streamText" | "decide";
-  name: string;
-  input: unknown;
-  request: AgentTextRequest | AgentDecisionRequest;
-}
-/**
- * The script {@link createScriptedExecutors} plays back. Every channel is
- * keyed by request name and consumed in order; the last entry for a name
- * repeats forever.
- */
-interface ScriptedExecutorsScript {
-  /** Answers for `decide` requests, keyed by request name. */
-  decisions?: ScriptedByName<ScriptedDecisionEntry>;
-  /** Answers for generate requests, keyed by request name. */
-  text?: ScriptedByName<ScriptedTextEntry>;
-  /** Stream chunks keyed by request name. */
-  stream?: Record<string, ScriptedStreamEntry>;
-  /** Default usage attached when an entry does not provide its own. */
-  usage?: AgentCallUsage;
-}
-/** What {@link createScriptedExecutors} returns: the full executor set plus the calls it observed. */
-type ScriptedExecutors = Required<AgentRequestExecutors> & {
-  calls: ScriptedExecutorCall[];
-};
-/**
- * Executors that replay a script instead of calling a model. Every slot is
- * provided, so any machine binds.
- *
- * Answers are keyed by the request's resolved name — its authored `name`, else
- * the invoke `id` — and `"*"` serves anything unmatched.
- * Entries for a name are consumed in order and the last one repeats forever, so
- * a looping machine needs no extra option. A request the script has no route
- * for throws an ordinary `Error` from inside the executor, which reaches the
- * machine as an actor error.
- *
- * Queues are copied on creation, so the caller's arrays are never mutated and
- * each call builds a fresh, independent playthrough. Entries may be plain
- * values or functions of the request.
- *
- * @example
- * ```ts
- * const result = await runAgent(moderationMachine, {
- *   input: { comment: 'honestly this update is terrible', trust: 20 },
- *   executors: createScriptedExecutors({
- *     decisions: { moderate: [{ type: 'FLAG', reason: 'Borderline tone.' }] },
- *   }),
- * });
- * ```
- *
- * @example Dynamic entries
- * ```ts
- * createScriptedExecutors({
- *   text: { draft: (request) => `Draft about ${request.prompt}` },
- *   decisions: { route: (request) => ({ type: request.events[0]!.type }) },
- * });
- * ```
- */
-declare function createScriptedExecutors(script?: ScriptedExecutorsScript): ScriptedExecutors;
-//#endregion
 //#region src/utils.d.ts
 /** Returns the human-readable text carried by a message, ignoring non-text parts. */
 declare function getMessageText(message: AgentMessage): string;
@@ -206,4 +106,4 @@ declare function getJsonSchema(schema?: StandardSchemaV1): Promise<Record<string
  */
 declare function getJsonSchemaSync(schema?: StandardSchemaV1): Record<string, unknown> | undefined;
 //#endregion
-export { ScriptedExecutorsScript as _, getMachineStructuralHash as a, getStatePath as c, toolMessage as d, userMessage as f, ScriptedExecutors as g, ScriptedDecisionValue as h, getJsonSchemaSync as i, isStandardSchema as l, ScriptedDecisionEntry as m, assistantMessage as n, getMessageText as o, ScriptedByName as p, getJsonSchema as r, getStateMeta as s, MetaOfSnapshot as t, systemMessage as u, ScriptedTextEntry as v, createScriptedExecutors as y };
+export { getMachineStructuralHash as a, getStatePath as c, toolMessage as d, userMessage as f, getJsonSchemaSync as i, isStandardSchema as l, assistantMessage as n, getMessageText as o, getJsonSchema as r, getStateMeta as s, MetaOfSnapshot as t, systemMessage as u };

package/dist/{utils-RalRn9sk.d.cts → utils-ceStNCOh.d.cts}

@@ -1,106 +1,6 @@
-import { C as UserMessage, S as ToolResultPart, _ as StandardSchemaV1, b as ToolCallPart, f as FilePart, l as AssistantMessage, n as AgentMessage, p as ImagePart, u as ChosenEvent, v as SystemMessage, x as ToolMessage, y as TextPart } from "./types-B1Qs2q3q.cjs";
-import { M as AgentDecisionRequest, c as AgentRequestExecutorInfo, f as AgentTextRequest, t as AgentCallUsage, u as AgentRequestExecutors } from "./text-logic-BFEOxyxv.cjs";
+import { C as UserMessage, S as ToolResultPart, _ as StandardSchemaV1, b as ToolCallPart, f as FilePart, l as AssistantMessage, n as AgentMessage, p as ImagePart, v as SystemMessage, x as ToolMessage, y as TextPart } from "./types-B1Qs2q3q.cjs";
 import { AnyMachineSnapshot, AnyStateMachine, StateValue } from "xstate";
 
-//#region src/scripted-executors.d.ts
-/**
- * A scripted `decide` answer: either the {@link ChosenEvent} itself (an object
- * with a string `type`), or the executor result `{ event, reason?, usage? }`
- * when the entry also reports a `reason` or token `usage`.
- */
-type ScriptedDecisionValue = ChosenEvent | {
-  event: ChosenEvent;
-  reason?: string;
-  usage?: AgentCallUsage;
-};
-/**
- * One scripted `decide` answer, or a function of the
- * {@link AgentDecisionRequest} returning one (for choices that depend on the
- * prompt, the candidate `events`, or the prior failed `attempts`).
- */
-type ScriptedDecisionEntry = ScriptedDecisionValue | ((request: AgentDecisionRequest) => ScriptedDecisionValue | PromiseLike<ScriptedDecisionValue>);
-/**
- * One scripted text answer: the request's output value (a string, or the
- * object a structured request declares), or a function of the
- * {@link AgentTextRequest} returning one.
- *
- * An entry is taken as the executor result (instead of the value itself)
- * only when its OWN keys are a `result` plus, optionally, `messages`/`usage`/
- * `raw` — that is how an entry reports token `usage`. Anything else, including
- * an object that merely happens to have a `result` key alongside its own data
- * (`{ result: 'draft', confidence: 0.9 }`), is the output value. For a
- * structured request whose declared output is exactly `{ result }` (or
- * `{ result, usage }`), wrap it once more: `{ result: { result: '…' } }`.
- */
-type ScriptedTextEntry = ((request: AgentTextRequest, info?: AgentRequestExecutorInfo) => unknown) | string | number | boolean | null | object;
-/**
- * A request-name keyed script. The key is the request's resolved `name` — the
- * authored name, else the invoke `id`. `"*"` is the fallback route.
- */
-type ScriptedByName<TEntry> = Record<string, TEntry | TEntry[]>;
-/** One scripted stream call: chunks, or a function producing chunks. */
-type ScriptedStreamEntry = string | readonly string[] | ((request: AgentTextRequest, info?: AgentRequestExecutorInfo) => string | readonly string[] | PromiseLike<string | readonly string[]>);
-/** A call observed by {@link createScriptedExecutors}. */
-interface ScriptedExecutorCall {
-  kind: "generateText" | "streamText" | "decide";
-  name: string;
-  input: unknown;
-  request: AgentTextRequest | AgentDecisionRequest;
-}
-/**
- * The script {@link createScriptedExecutors} plays back. Every channel is
- * keyed by request name and consumed in order; the last entry for a name
- * repeats forever.
- */
-interface ScriptedExecutorsScript {
-  /** Answers for `decide` requests, keyed by request name. */
-  decisions?: ScriptedByName<ScriptedDecisionEntry>;
-  /** Answers for generate requests, keyed by request name. */
-  text?: ScriptedByName<ScriptedTextEntry>;
-  /** Stream chunks keyed by request name. */
-  stream?: Record<string, ScriptedStreamEntry>;
-  /** Default usage attached when an entry does not provide its own. */
-  usage?: AgentCallUsage;
-}
-/** What {@link createScriptedExecutors} returns: the full executor set plus the calls it observed. */
-type ScriptedExecutors = Required<AgentRequestExecutors> & {
-  calls: ScriptedExecutorCall[];
-};
-/**
- * Executors that replay a script instead of calling a model. Every slot is
- * provided, so any machine binds.
- *
- * Answers are keyed by the request's resolved name — its authored `name`, else
- * the invoke `id` — and `"*"` serves anything unmatched.
- * Entries for a name are consumed in order and the last one repeats forever, so
- * a looping machine needs no extra option. A request the script has no route
- * for throws an ordinary `Error` from inside the executor, which reaches the
- * machine as an actor error.
- *
- * Queues are copied on creation, so the caller's arrays are never mutated and
- * each call builds a fresh, independent playthrough. Entries may be plain
- * values or functions of the request.
- *
- * @example
- * ```ts
- * const result = await runAgent(moderationMachine, {
- *   input: { comment: 'honestly this update is terrible', trust: 20 },
- *   executors: createScriptedExecutors({
- *     decisions: { moderate: [{ type: 'FLAG', reason: 'Borderline tone.' }] },
- *   }),
- * });
- * ```
- *
- * @example Dynamic entries
- * ```ts
- * createScriptedExecutors({
- *   text: { draft: (request) => `Draft about ${request.prompt}` },
- *   decisions: { route: (request) => ({ type: request.events[0]!.type }) },
- * });
- * ```
- */
-declare function createScriptedExecutors(script?: ScriptedExecutorsScript): ScriptedExecutors;
-//#endregion
 //#region src/utils.d.ts
 /** Returns the human-readable text carried by a message, ignoring non-text parts. */
 declare function getMessageText(message: AgentMessage): string;
@@ -206,4 +106,4 @@ declare function getJsonSchema(schema?: StandardSchemaV1): Promise<Record<string
  */
 declare function getJsonSchemaSync(schema?: StandardSchemaV1): Record<string, unknown> | undefined;
 //#endregion
-export { ScriptedExecutorsScript as _, getMachineStructuralHash as a, getStatePath as c, toolMessage as d, userMessage as f, ScriptedExecutors as g, ScriptedDecisionValue as h, getJsonSchemaSync as i, isStandardSchema as l, ScriptedDecisionEntry as m, assistantMessage as n, getMessageText as o, ScriptedByName as p, getJsonSchema as r, getStateMeta as s, MetaOfSnapshot as t, systemMessage as u, ScriptedTextEntry as v, createScriptedExecutors as y };
+export { getMachineStructuralHash as a, getStatePath as c, toolMessage as d, userMessage as f, getJsonSchemaSync as i, isStandardSchema as l, assistantMessage as n, getMessageText as o, getJsonSchema as r, getStateMeta as s, MetaOfSnapshot as t, systemMessage as u };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@statelyai/agent",
-  "version": "2.0.0-alpha.25",
+  "version": "2.0.0-alpha.26",
   "description": "Make invalid agent actions impossible. Agent logic as state machines: deterministic, inspectable, resumable, runs anywhere.",
   "keywords": [
     "agent",
@@ -115,6 +115,7 @@
   },
   "devDependencies": {
     "@ai-sdk/openai": "^4.0.0",
+    "@ai-sdk/typesafe-ai": "3.0.6",
     "@anthropic-ai/sdk": "^0.120.0",
     "@changesets/changelog-github": "^0.5.2",
     "@changesets/cli": "^2.31.1",
@@ -128,7 +129,7 @@
     "@opentelemetry/sdk-trace-base": "^2.10.0",
     "@types/node": "^20.19.43",
     "@types/react": "^19.2.18",
-    "ai": "^7.0.0",
+    "ai": "^7.0.113",
     "ajv": "^8.20.0",
     "braintrust": "^3.28.0",
     "dotenv": "^16.6.1",

package/readme.md

@@ -40,6 +40,8 @@ For the optional raw OpenAI SDK executor (`@statelyai/agent/openai`):
 pnpm add openai
 ```
 
+Classification, grading, relevance, and yes/no checks are judgments: call the AI SDK's `experimental_evaluate` with `@ai-sdk/typesafe-ai` (`pnpm add ai @ai-sdk/typesafe-ai`) from an ordinary actor; see [Judgments with the AI SDK](docs/judgments.md).
+
 Requirements:
 
 - Node 22.18 or newer, and XState v6 alpha.46 or newer.
@@ -139,7 +141,7 @@ const liveResult = await runAgent(refundMachine, {
 });
 ```
 
-For a machine with several requests, `createScriptedExecutors` from `@statelyai/agent/testing` holds ordered answers keyed by request name. See [Evals](docs/evals.md#scripted-executors).
+For a machine with several requests, the executor routes on `request.name`, or `MockLanguageModelV3` from `ai/test` stands in for the provider behind `createAiSdkExecutors`. See [Evals](docs/evals.md#testing-without-a-provider).
 
 Passing the same `models` map to `setupAgent({ models })` types the machine's model refs. Executors are always explicit, and core does not import the AI SDK. See [Hosts and executors](docs/hosts.md).
 
@@ -155,7 +157,7 @@ flowchart LR
   R -->|event or output| M
 ```
 
-The machine never talks to a model directly, so swapping `createAiSdkExecutors` for `createScriptedExecutors` (or your own functions) changes nothing about the agent.
+The machine never talks to a model directly, so swapping `createAiSdkExecutors` for your own functions changes nothing about the agent.
 
 The example above has one model decision and two final outcomes. Real machines add approval states, retries, parallel work, child agents, and long-running waits without changing how control flow is represented.