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

package/dist/index.d.cts

@@ -1,9 +1,9 @@
-import { C as UserMessage, S as ToolResultPart, _ as StandardSchemaV1, a as AgentToolDescriptor, b as ToolCallPart, c as AllowedEvents, d as EventUnion, f as FilePart, g as NormalizedEventSchemas, h as InferOutput, i as AgentToolChoice, l as AssistantMessage, m as InferInput, n as AgentMessage, o as AgentToolExecute, p as ImagePart, r as AgentTool, s as AgentTools, t as AgentEventSchemaInputMap, u as ChosenEvent, v as SystemMessage, w as WithAgentInputSchema, x as ToolMessage, y as TextPart } from "./types-B1Qs2q3q.cjs";
-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 { 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";
+import { C as UserMessage, S as ToolResultPart, _ as StandardSchemaV1, a as AgentToolDescriptor, b as ToolCallPart, c as AllowedEvents, d as EventUnion, f as FilePart, g as NormalizedEventSchemas, h as InferOutput, i as AgentToolChoice, l as AssistantMessage, m as InferInput, n as AgentMessage, o as AgentToolExecute, p as ImagePart, r as AgentTool, s as AgentTools, t as AgentEventSchemaInputMap, u as ChosenEvent, v as SystemMessage, w as WithAgentInputSchema, x as ToolMessage, y as TextPart } from "./types-hR5f5YXa.cjs";
+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-IjfYy9DP.cjs";
+import { C as serializeTraceEvent, D as AGENT_USAGE_EVENT_TYPE, E as AgentStepRequest, O as AgentUsageEvent, S as runToQuiescence, T as AgentRequest, _ as InspectedActorRef, a as AgentRunErrorCause, b as inspectTransitions, c as AgentRunResult, d as AgentRuntimeOptions, f as AgentSnapshotDivergedError, g as AgentTransitionHandler, h as AgentTraceEvent, i as AgentMaxModelCallsExceededError, l as AgentRunStart, m as AgentTimerScheduler, n as AgentEffects, o as AgentRunInit, p as AgentTimerEvent, r as AgentInputFrom, s as AgentRunMeta, t as AGENT_TRACE_SCHEMA_VERSION, u as AgentRuntime, v as JsonSerializableTraceEvent, w as traceTransitions, x as isAgentIdle, y as createAgentRuntime } from "./run-agent-ByO-Bxyd.cjs";
+import { c as AgentLogEntry, d as AgentMachineVersionMismatchError, n as AgentEventLogStore, t as AgentEventLogConflictError } from "./event-log-store-2xzFmgr2.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-o4YRdHJX.cjs";
+import { AnyActorLogic, AnyMachineSnapshot, AnySetupConfig, AnyStateMachine, AsyncActorLogic, ContextFrom, DoneActorEvent, EventFromLogic, EventObject, InputFrom, MachineContext, MetaObject, NonReducibleUnknown, OutputFrom, SetupReturnFromConfig, SetupStateSchema, SnapshotFrom, StateValueFrom } from "xstate";
 
 //#region src/type-helpers.d.ts
 type SchemaAt<T, TKey extends PropertyKey> = T extends {
@@ -199,17 +199,6 @@ interface AgentWorkflowConfig {
   actors?: Record<string, AgentWorkflowActorConfig>;
   initial: string;
   states: Record<string, AgentWorkflowStateConfig>;
-  /**
-   * State tags that mark an INTENTIONAL wait for an external event (a human
-   * approval, an inbound webhook, …) — the declarative form of `setupAgent({
-   * isIdle })`, since a config cannot carry a function. Lowered to a
-   * `snapshot.hasTag(...)`-any-of predicate so `runAgent` settles those
-   * snapshots idle deterministically instead of using its timing heuristic.
-   * Every listed tag must appear in some state's `tags` — an unused tag is a
-   * build-time error. A `fromConfig(config, { isIdle })` option takes
-   * precedence over declarative `idleTags`.
-   */
-  idleTags?: string[];
   meta?: Record<string, unknown>;
 }
 /** A `requests` entry in {@link AgentWorkflowConfig} — the JSON equivalent of a `setupAgent({ requests })` `TextLogicConfig`. Fields beyond `input`/`output`/`tools`/`mode`/`description` are `unknown` because they accept template-expression strings (see {@link AgentWorkflowConfig}). */
@@ -313,7 +302,7 @@ interface AgentWorkflowActionConfig {
  */
 interface FromConfigResult {
   machine: AnyStateMachine;
-  /** Compiled `context`/`events`/`input`/`output`/`meta`/`emitted` schemas — the same pack `runAgent` executes this machine with. */
+  /** Compiled `context`/`events`/`input`/`output`/`meta`/`emitted` schemas — the same pack `createAgentRuntime` executes this machine with. */
   schemas: AgentSchemaPack<StandardSchemaV1<Record<string, unknown>>, Record<string, StandardSchemaV1>, StandardSchemaV1, StandardSchemaV1, StandardSchemaV1<MetaObject>>;
 }
 /** Options for `setupAgent.fromConfig(...)`. */
@@ -342,15 +331,6 @@ interface FromConfigOptions {
    * implementation here is a build-time error.
    */
   actions?: Record<string, (params: any) => unknown>;
-  /**
-   * Detects a snapshot that is an INTENTIONAL wait for an external event —
-   * the same machine-carried predicate `setupAgent({ isIdle })` declares
-   * for TS-authored machines, registered here because a function cannot live
-   * in the workflow config itself. Takes precedence over the config's
-   * declarative {@link AgentWorkflowConfig.idleTags}. Travels with the machine
-   * through `machine.provide(...)`.
-   */
-  isIdle?: (snapshot: AnyMachineSnapshot) => boolean;
 }
 //#endregion
 //#region src/setup-agent.d.ts
@@ -386,8 +366,7 @@ type AgentDefaultMeta<TEventSchemas extends AgentEventSchemaInputMap> = AgentInt
  * A machine's full schema set — context, event payloads, machine input/
  * output, and state/transition meta — as returned by {@link createAgentSchemas}
  * and retained on `setupAgent(...)`'s `result.schemas` for runtime
- * validation (e.g. by the step path to validate `initialAgentStep` input, or
- * by `getAcceptedEvents` to attach event payload schemas). Unlike
+ * validation (e.g. by `getAcceptedEvents` to attach event payload schemas). Unlike
  * `AgentSchemaConfig` (the input to `createAgentSchemas`), every field here
  * is required — `events`/`input`/`output`/`meta` default to empty/unknown
  * schemas when not supplied.
@@ -398,7 +377,7 @@ interface AgentSchemaPack<TContextSchema extends StandardSchemaV1<Record<string,
   input: TInputSchema;
   output: TOutputSchema;
   meta: TMetaSchema;
-  /** Schemas for events the machine emits (`enq.emit(...)`), keyed by event type — they type `enq.emit` in the machine and the `on` handlers of {@link runAgent}. Optional: omitted means emitted events stay untyped. */
+  /** Schemas for events the machine emits (`enq.emit(...)`), keyed by event type — they type `enq.emit` in the machine and the `on` handlers of {@link createAgentRuntime}. Optional: omitted means emitted events stay untyped. */
   emitted?: TEmittedSchemas;
 }
 type AgentSchemaConfig<TContextSchema extends StandardSchemaV1<Record<string, unknown>>, TEventSchemas extends AgentEventSchemaInputMap, TInputSchema extends StandardSchemaV1, TOutputSchema extends StandardSchemaV1, TMetaSchema extends StandardSchemaV1, TEmittedSchemas extends Record<string, StandardSchemaV1> = Record<string, StandardSchemaV1>> = {
@@ -464,7 +443,7 @@ type AgentSetupEmittedSchema<TEmittedSchemas extends Record<string, StandardSche
  * XState resolves `schemas.input` to a single type used both by
  * `createActor`'s `input` option and by the `context: ({ input })` factory —
  * and it never validates, so a schema default reads as a required field at the
- * call site while being absent at runtime. `runAgent` validates the input
+ * call site while being absent at runtime. The runtime validates the input
  * (filling defaults) and reads this brand back through `AgentInputFrom` to
  * accept the schema's looser *input* side, while the factory keeps seeing the
  * validated *output* side.
@@ -504,17 +483,6 @@ type SetupAgentBaseConfig<TContextSchema extends StandardSchemaV1<Record<string,
   actions?: NonNullable<AnySetupConfig["actions"]>;
   guards?: AgentGuardSources<TContextSchema, TEventSchemas>;
   delays?: AgentDelaySources<TContextSchema, TEventSchemas>;
-  /**
-   * Detects a snapshot that is an INTENTIONAL wait for an external event (a
-   * human approval, an inbound webhook, …) — the machine's own declaration of
-   * what "idle" means for it, so `runAgent` settles those snapshots idle
-   * deterministically instead of using its timing heuristic. Travels with the
-   * machine through `machine.provide(...)`. Without one, `runAgent` recognizes
-   * resting event-handling states and `meta.interaction` by structure. Use a
-   * predicate only for a more specialized machine-owned wait rule. Import and
-   * call `isAgentIdle(snapshot)` inside it when expanding the default rule.
-   */
-  isIdle?: (snapshot: AnyMachineSnapshot) => boolean;
 };
 type SetupAgentXStateResult<TContextSchema extends StandardSchemaV1<Record<string, unknown>>, TEventSchemas extends AgentEventSchemaInputMap, TActors extends { [K in keyof TActors]: AnyActorLogic }, TRequestSchemas extends AgentRequestSchemaMap, TInputSchema extends StandardSchemaV1, TOutputSchema extends StandardSchemaV1, TMetaSchema extends StandardSchemaV1, TModels extends AgentModelMap, TEmittedSchemas extends Record<string, StandardSchemaV1> = {}, TStateSchemas extends Record<string, SetupStateSchema> = Record<string, SetupStateSchema>> = SetupReturnFromConfig<AgentSetupXStateConfig<TContextSchema, TEventSchemas, TActors, TRequestSchemas, TInputSchema, TOutputSchema, TMetaSchema, TModels, TEmittedSchemas, TStateSchemas>>;
 /**
@@ -522,13 +490,13 @@ type SetupAgentXStateResult<TContextSchema extends StandardSchemaV1<Record<strin
  * (`createMachine`, `assign`, …) extended with `schemas` (the resolved
  * {@link AgentSchemaPack}), `models`, and `requests` (the built request
  * actors). Machines created here are registered so
- * `runAgent` and the free step helpers can resolve their schemas/actors
+ * `createAgentRuntime` can resolve their schemas/actors
  * without re-passing them each call.
  */
 type SetupAgentResult<TContextSchema extends StandardSchemaV1<Record<string, unknown>>, TEventSchemas extends AgentEventSchemaInputMap, TActors extends { [K in keyof TActors]: AnyActorLogic }, TRequestSchemas extends AgentRequestSchemaMap, TInputSchema extends StandardSchemaV1, TOutputSchema extends StandardSchemaV1, TMetaSchema extends StandardSchemaV1, TModels extends AgentModelMap, TEmittedSchemas extends Record<string, StandardSchemaV1> = {}, TStateSchemas extends Record<string, SetupStateSchema> = Record<string, SetupStateSchema>> = Omit<SetupAgentXStateResult<TContextSchema, TEventSchemas, TActors, TRequestSchemas, TInputSchema, TOutputSchema, TMetaSchema, TModels, TEmittedSchemas, TStateSchemas>, "createMachine"> & {
   /**
    * Creates the agent machine — XState's own `createMachine`, plus: the
-   * machine is registered so step helpers and {@link runAgent} can resolve
+   * machine is registered so {@link createAgentRuntime} can resolve
    * its schemas/actors without re-passing them, and a single final state's
    * `output` is copied to the machine root when the root declares none.
    */
@@ -540,7 +508,7 @@ type SetupAgentResult<TContextSchema extends StandardSchemaV1<Record<string, unk
 /**
  * Schema-first `setup(...)` for agent machines — the standard entry point
  * for authoring a machine (the blueprint) that this library then runs (via
- * {@link runAgent} or the step helpers) against host-supplied model/decision
+ * {@link createAgentRuntime}) against host-supplied model/decision
  * executors. Context, events, machine input, machine output, and
  * state/transition meta are all standard schemas — no `{} as Type` casts —
  * and are retained on `result.schemas` for runtime validation. Also
@@ -602,7 +570,10 @@ declare namespace setupAgent {
    * const { machine, schemas } = setupAgent.fromConfig(workflowConfig, {
    *   compileSchema,
    * });
-   * const result = await runAgent(machine, { input: { ticket }, executors: { generateText, decide } });
+   * const result = await runToQuiescence(
+   *   createAgentRuntime(machine, { executors: { generateText, decide } }),
+   *   { input: { ticket } },
+   * );
    * const event = parseAgentEvent(result.snapshot, raw, { events: schemas.events });
    * ```
    */
@@ -620,57 +591,6 @@ declare namespace setupAgent {
  */
 declare function getAgentSchemas(machine: AnyStateMachine): AgentSchemas | undefined;
 //#endregion
-//#region src/agent-run.d.ts
-type AgentStreamEvent<TMachine extends AnyStateMachine = AnyStateMachine> = {
-  kind: "request";
-  phase: "start" | "end";
-  name: string;
-  id: string;
-  request: AgentStepRequest;
-  output?: unknown;
-  raw?: unknown;
-} | {
-  kind: "request";
-  phase: "error";
-  name: string;
-  id: string;
-  request: AgentStepRequest;
-  error: unknown;
-} | {
-  kind: "chunk";
-  name: string;
-  id: string;
-  delta: string;
-} | {
-  kind: "transition";
-  value: StateValue;
-  event: EventFromLogic<TMachine>;
-} | {
-  kind: "emit";
-  event: EmittedFrom<TMachine>;
-} | {
-  kind: "done";
-  result: Extract<RunAgentResult<TMachine>, {
-    status: "done";
-  }>;
-} | {
-  kind: "idle";
-  result: Extract<RunAgentResult<TMachine>, {
-    status: "idle";
-  }>;
-} | {
-  kind: "error";
-  result: Extract<RunAgentResult<TMachine>, {
-    status: "error";
-  }>;
-};
-/**
- * Streams one {@link runAgent} call as agent-level events. The machine remains
- * the single artifact; this function only projects its requests, chunks,
- * transitions, emitted events, and terminal result into an async iterable.
- */
-declare function runAgentStream<TMachine extends AnyStateMachine>(machine: TMachine, options: RunAgentOptions<TMachine>): AsyncGenerator<AgentStreamEvent<TMachine>, void>;
-//#endregion
 //#region src/provide-executors.d.ts
 /** Options for {@link provideExecutors}. */
 interface ProvideExecutorsOptions<TMachine extends AnyStateMachine = AnyStateMachine> {
@@ -687,12 +607,12 @@ interface ProvideExecutorsOptions<TMachine extends AnyStateMachine = AnyStateMac
   /**
    * A single ordered stream of request-level trace events
    * (`request.start`/`request.end`/`request.error`/`stream.chunk`) with the
-   * SAME versioned envelope {@link runAgent} emits. Because one bound machine can
+   * SAME versioned envelope {@link createAgentRuntime} emits. Because one bound machine can
    * back many concurrent root actors, envelope state (`runId`, monotonic `seq`)
    * is minted per ROOT actor at runtime — two concurrent actors get distinct
    * `runId`s and independent `seq`. Pair with {@link traceTransitions} on the
    * actor's `inspect` to fold `machine.transition` events into the same stream.
-   * Unlike `runAgent` there are NO `run.start`/`run.end` events (no run
+   * Unlike `createAgentRuntime` there are NO `run.start`/`run.end` events (no run
    * boundary).
    */
   onTrace?: (event: AgentTraceEvent<TMachine>) => void;
@@ -700,8 +620,8 @@ interface ProvideExecutorsOptions<TMachine extends AnyStateMachine = AnyStateMac
 /**
  * Binds a machine's agent actor sources to a set of host `executors` in one
  * call, returning a `machine.provide(...)`-ed copy ready for a plain
- * `createActor(...)` — the uncontrolled-mode counterpart to {@link runAgent}.
- * No run loop, no idle settling: the returned machine drives itself, so
+ * `createActor(...)` — the uncontrolled-mode counterpart to {@link createAgentRuntime}.
+ * No run loop, no settling: the returned machine drives itself, so
  *
  * ```ts
  * const actor = createActor(provideExecutors(machine, { generateText, decide }), { input });
@@ -716,10 +636,10 @@ interface ProvideExecutorsOptions<TMachine extends AnyStateMachine = AnyStateMac
  * - `mode: 'stream'` text source → `executors.streamText`
  * - decision / `agent.decide` source → `executors.decide` (snapshot-driven
  *   candidate events, guard `canTake`, and auto-delivery of the chosen event,
- *   mirroring `runAgent` but without its model-call counting)
+ *   mirroring `createAgentRuntime` but without its model-call counting)
  *
  * Pass `options.onTrace` to observe request-level trace events (identical in
- * shape to `runAgent`'s); pair it with {@link traceTransitions} on the actor's
+ * shape to `createAgentRuntime`'s); pair it with {@link traceTransitions} on the actor's
  * `inspect` to also capture `machine.transition` events in the same stream.
  *
  * A source that already carries its own executor (`.withExecutor(...)`) is left
@@ -730,7 +650,7 @@ interface ProvideExecutorsOptions<TMachine extends AnyStateMachine = AnyStateMac
  * Throws at bind time if a source needs an executor kind that `executors` does
  * not provide.
  *
- * Executor inheritance is RECURSIVE, exactly as in `runAgent`: a string-keyed
+ * Executor inheritance is RECURSIVE, exactly as in `createAgentRuntime`: a string-keyed
  * invoked child machine is rebound too, so its own text/decision requests — at
  * any depth — reach the same host executors. A direct-object invoke `src`
  * cannot be swapped via `.provide`, so nothing under one inherits; bind those
@@ -739,4 +659,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 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, type AgentEffects, 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 AgentRunErrorCause, type AgentRunInit, type AgentRunMeta, type AgentRunResult, type AgentRunStart, type AgentRuntime, type AgentRuntimeOptions, type AgentSchemaPack, type AgentSchemas, AgentSnapshotDivergedError, type AgentStepRequest, type AgentTextRequest, type AgentTextResult, type AgentTimerEvent, type AgentTimerScheduler, 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 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, createAgentRuntime, createAgentSchemas, createDecisionLogic, createDecisionRequest, createTextLogic, eventFromInteraction, getAcceptedEvents, getAgentOutputMode, getAgentSchemas, getCallFinishReason, getCallUsage, getInteraction, getJsonSchema, getJsonSchemaSync, getMachineStructuralHash, getMessageText, getStateMeta, getStatePath, inspectTransitions, interactionMetaSchema, isAgentIdle, isAgentMessages, isStandardSchema, messagesSchema, parseAgentEvent, parseOutput, parseProviderOutput, provideExecutors, providerOutputSchema, renderDecisionAttempts, resolveDecision, runToQuiescence, serializeTraceEvent, setupAgent, systemMessage, toolMessage, traceTransitions, userMessage };

package/dist/index.d.mts

@@ -1,9 +1,9 @@
-import { C as UserMessage, S as ToolResultPart, _ as StandardSchemaV1, a as AgentToolDescriptor, b as ToolCallPart, c as AllowedEvents, d as EventUnion, f as FilePart, g as NormalizedEventSchemas, h as InferOutput, i as AgentToolChoice, l as AssistantMessage, m as InferInput, n as AgentMessage, o as AgentToolExecute, p as ImagePart, r as AgentTool, s as AgentTools, t as AgentEventSchemaInputMap, u as ChosenEvent, v as SystemMessage, w as WithAgentInputSchema, x as ToolMessage, y as TextPart } from "./types-tA3SdczG.mjs";
-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 { 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";
+import { C as UserMessage, S as ToolResultPart, _ as StandardSchemaV1, a as AgentToolDescriptor, b as ToolCallPart, c as AllowedEvents, d as EventUnion, f as FilePart, g as NormalizedEventSchemas, h as InferOutput, i as AgentToolChoice, l as AssistantMessage, m as InferInput, n as AgentMessage, o as AgentToolExecute, p as ImagePart, r as AgentTool, s as AgentTools, t as AgentEventSchemaInputMap, u as ChosenEvent, v as SystemMessage, w as WithAgentInputSchema, x as ToolMessage, y as TextPart } from "./types-BgNbNKnJ.mjs";
+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-D-czVPYp.mjs";
+import { C as serializeTraceEvent, D as AGENT_USAGE_EVENT_TYPE, E as AgentStepRequest, O as AgentUsageEvent, S as runToQuiescence, T as AgentRequest, _ as InspectedActorRef, a as AgentRunErrorCause, b as inspectTransitions, c as AgentRunResult, d as AgentRuntimeOptions, f as AgentSnapshotDivergedError, g as AgentTransitionHandler, h as AgentTraceEvent, i as AgentMaxModelCallsExceededError, l as AgentRunStart, m as AgentTimerScheduler, n as AgentEffects, o as AgentRunInit, p as AgentTimerEvent, r as AgentInputFrom, s as AgentRunMeta, t as AGENT_TRACE_SCHEMA_VERSION, u as AgentRuntime, v as JsonSerializableTraceEvent, w as traceTransitions, x as isAgentIdle, y as createAgentRuntime } from "./run-agent-COXXc0RW.mjs";
+import { c as AgentLogEntry, d as AgentMachineVersionMismatchError, n as AgentEventLogStore, t as AgentEventLogConflictError } from "./event-log-store-BIPOz-di.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-_q7F-AZu.mjs";
+import { AnyActorLogic, AnyMachineSnapshot, AnySetupConfig, AnyStateMachine, AsyncActorLogic, ContextFrom, DoneActorEvent, EventFromLogic, EventObject, InputFrom, MachineContext, MetaObject, NonReducibleUnknown, OutputFrom, SetupReturnFromConfig, SetupStateSchema, SnapshotFrom, StateValueFrom } from "xstate";
 
 //#region src/type-helpers.d.ts
 type SchemaAt<T, TKey extends PropertyKey> = T extends {
@@ -199,17 +199,6 @@ interface AgentWorkflowConfig {
   actors?: Record<string, AgentWorkflowActorConfig>;
   initial: string;
   states: Record<string, AgentWorkflowStateConfig>;
-  /**
-   * State tags that mark an INTENTIONAL wait for an external event (a human
-   * approval, an inbound webhook, …) — the declarative form of `setupAgent({
-   * isIdle })`, since a config cannot carry a function. Lowered to a
-   * `snapshot.hasTag(...)`-any-of predicate so `runAgent` settles those
-   * snapshots idle deterministically instead of using its timing heuristic.
-   * Every listed tag must appear in some state's `tags` — an unused tag is a
-   * build-time error. A `fromConfig(config, { isIdle })` option takes
-   * precedence over declarative `idleTags`.
-   */
-  idleTags?: string[];
   meta?: Record<string, unknown>;
 }
 /** A `requests` entry in {@link AgentWorkflowConfig} — the JSON equivalent of a `setupAgent({ requests })` `TextLogicConfig`. Fields beyond `input`/`output`/`tools`/`mode`/`description` are `unknown` because they accept template-expression strings (see {@link AgentWorkflowConfig}). */
@@ -313,7 +302,7 @@ interface AgentWorkflowActionConfig {
  */
 interface FromConfigResult {
   machine: AnyStateMachine;
-  /** Compiled `context`/`events`/`input`/`output`/`meta`/`emitted` schemas — the same pack `runAgent` executes this machine with. */
+  /** Compiled `context`/`events`/`input`/`output`/`meta`/`emitted` schemas — the same pack `createAgentRuntime` executes this machine with. */
   schemas: AgentSchemaPack<StandardSchemaV1<Record<string, unknown>>, Record<string, StandardSchemaV1>, StandardSchemaV1, StandardSchemaV1, StandardSchemaV1<MetaObject>>;
 }
 /** Options for `setupAgent.fromConfig(...)`. */
@@ -342,15 +331,6 @@ interface FromConfigOptions {
    * implementation here is a build-time error.
    */
   actions?: Record<string, (params: any) => unknown>;
-  /**
-   * Detects a snapshot that is an INTENTIONAL wait for an external event —
-   * the same machine-carried predicate `setupAgent({ isIdle })` declares
-   * for TS-authored machines, registered here because a function cannot live
-   * in the workflow config itself. Takes precedence over the config's
-   * declarative {@link AgentWorkflowConfig.idleTags}. Travels with the machine
-   * through `machine.provide(...)`.
-   */
-  isIdle?: (snapshot: AnyMachineSnapshot) => boolean;
 }
 //#endregion
 //#region src/setup-agent.d.ts
@@ -386,8 +366,7 @@ type AgentDefaultMeta<TEventSchemas extends AgentEventSchemaInputMap> = AgentInt
  * A machine's full schema set — context, event payloads, machine input/
  * output, and state/transition meta — as returned by {@link createAgentSchemas}
  * and retained on `setupAgent(...)`'s `result.schemas` for runtime
- * validation (e.g. by the step path to validate `initialAgentStep` input, or
- * by `getAcceptedEvents` to attach event payload schemas). Unlike
+ * validation (e.g. by `getAcceptedEvents` to attach event payload schemas). Unlike
  * `AgentSchemaConfig` (the input to `createAgentSchemas`), every field here
  * is required — `events`/`input`/`output`/`meta` default to empty/unknown
  * schemas when not supplied.
@@ -398,7 +377,7 @@ interface AgentSchemaPack<TContextSchema extends StandardSchemaV1<Record<string,
   input: TInputSchema;
   output: TOutputSchema;
   meta: TMetaSchema;
-  /** Schemas for events the machine emits (`enq.emit(...)`), keyed by event type — they type `enq.emit` in the machine and the `on` handlers of {@link runAgent}. Optional: omitted means emitted events stay untyped. */
+  /** Schemas for events the machine emits (`enq.emit(...)`), keyed by event type — they type `enq.emit` in the machine and the `on` handlers of {@link createAgentRuntime}. Optional: omitted means emitted events stay untyped. */
   emitted?: TEmittedSchemas;
 }
 type AgentSchemaConfig<TContextSchema extends StandardSchemaV1<Record<string, unknown>>, TEventSchemas extends AgentEventSchemaInputMap, TInputSchema extends StandardSchemaV1, TOutputSchema extends StandardSchemaV1, TMetaSchema extends StandardSchemaV1, TEmittedSchemas extends Record<string, StandardSchemaV1> = Record<string, StandardSchemaV1>> = {
@@ -464,7 +443,7 @@ type AgentSetupEmittedSchema<TEmittedSchemas extends Record<string, StandardSche
  * XState resolves `schemas.input` to a single type used both by
  * `createActor`'s `input` option and by the `context: ({ input })` factory —
  * and it never validates, so a schema default reads as a required field at the
- * call site while being absent at runtime. `runAgent` validates the input
+ * call site while being absent at runtime. The runtime validates the input
  * (filling defaults) and reads this brand back through `AgentInputFrom` to
  * accept the schema's looser *input* side, while the factory keeps seeing the
  * validated *output* side.
@@ -504,17 +483,6 @@ type SetupAgentBaseConfig<TContextSchema extends StandardSchemaV1<Record<string,
   actions?: NonNullable<AnySetupConfig["actions"]>;
   guards?: AgentGuardSources<TContextSchema, TEventSchemas>;
   delays?: AgentDelaySources<TContextSchema, TEventSchemas>;
-  /**
-   * Detects a snapshot that is an INTENTIONAL wait for an external event (a
-   * human approval, an inbound webhook, …) — the machine's own declaration of
-   * what "idle" means for it, so `runAgent` settles those snapshots idle
-   * deterministically instead of using its timing heuristic. Travels with the
-   * machine through `machine.provide(...)`. Without one, `runAgent` recognizes
-   * resting event-handling states and `meta.interaction` by structure. Use a
-   * predicate only for a more specialized machine-owned wait rule. Import and
-   * call `isAgentIdle(snapshot)` inside it when expanding the default rule.
-   */
-  isIdle?: (snapshot: AnyMachineSnapshot) => boolean;
 };
 type SetupAgentXStateResult<TContextSchema extends StandardSchemaV1<Record<string, unknown>>, TEventSchemas extends AgentEventSchemaInputMap, TActors extends { [K in keyof TActors]: AnyActorLogic }, TRequestSchemas extends AgentRequestSchemaMap, TInputSchema extends StandardSchemaV1, TOutputSchema extends StandardSchemaV1, TMetaSchema extends StandardSchemaV1, TModels extends AgentModelMap, TEmittedSchemas extends Record<string, StandardSchemaV1> = {}, TStateSchemas extends Record<string, SetupStateSchema> = Record<string, SetupStateSchema>> = SetupReturnFromConfig<AgentSetupXStateConfig<TContextSchema, TEventSchemas, TActors, TRequestSchemas, TInputSchema, TOutputSchema, TMetaSchema, TModels, TEmittedSchemas, TStateSchemas>>;
 /**
@@ -522,13 +490,13 @@ type SetupAgentXStateResult<TContextSchema extends StandardSchemaV1<Record<strin
  * (`createMachine`, `assign`, …) extended with `schemas` (the resolved
  * {@link AgentSchemaPack}), `models`, and `requests` (the built request
  * actors). Machines created here are registered so
- * `runAgent` and the free step helpers can resolve their schemas/actors
+ * `createAgentRuntime` can resolve their schemas/actors
  * without re-passing them each call.
  */
 type SetupAgentResult<TContextSchema extends StandardSchemaV1<Record<string, unknown>>, TEventSchemas extends AgentEventSchemaInputMap, TActors extends { [K in keyof TActors]: AnyActorLogic }, TRequestSchemas extends AgentRequestSchemaMap, TInputSchema extends StandardSchemaV1, TOutputSchema extends StandardSchemaV1, TMetaSchema extends StandardSchemaV1, TModels extends AgentModelMap, TEmittedSchemas extends Record<string, StandardSchemaV1> = {}, TStateSchemas extends Record<string, SetupStateSchema> = Record<string, SetupStateSchema>> = Omit<SetupAgentXStateResult<TContextSchema, TEventSchemas, TActors, TRequestSchemas, TInputSchema, TOutputSchema, TMetaSchema, TModels, TEmittedSchemas, TStateSchemas>, "createMachine"> & {
   /**
    * Creates the agent machine — XState's own `createMachine`, plus: the
-   * machine is registered so step helpers and {@link runAgent} can resolve
+   * machine is registered so {@link createAgentRuntime} can resolve
    * its schemas/actors without re-passing them, and a single final state's
    * `output` is copied to the machine root when the root declares none.
    */
@@ -540,7 +508,7 @@ type SetupAgentResult<TContextSchema extends StandardSchemaV1<Record<string, unk
 /**
  * Schema-first `setup(...)` for agent machines — the standard entry point
  * for authoring a machine (the blueprint) that this library then runs (via
- * {@link runAgent} or the step helpers) against host-supplied model/decision
+ * {@link createAgentRuntime}) against host-supplied model/decision
  * executors. Context, events, machine input, machine output, and
  * state/transition meta are all standard schemas — no `{} as Type` casts —
  * and are retained on `result.schemas` for runtime validation. Also
@@ -602,7 +570,10 @@ declare namespace setupAgent {
    * const { machine, schemas } = setupAgent.fromConfig(workflowConfig, {
    *   compileSchema,
    * });
-   * const result = await runAgent(machine, { input: { ticket }, executors: { generateText, decide } });
+   * const result = await runToQuiescence(
+   *   createAgentRuntime(machine, { executors: { generateText, decide } }),
+   *   { input: { ticket } },
+   * );
    * const event = parseAgentEvent(result.snapshot, raw, { events: schemas.events });
    * ```
    */
@@ -620,57 +591,6 @@ declare namespace setupAgent {
  */
 declare function getAgentSchemas(machine: AnyStateMachine): AgentSchemas | undefined;
 //#endregion
-//#region src/agent-run.d.ts
-type AgentStreamEvent<TMachine extends AnyStateMachine = AnyStateMachine> = {
-  kind: "request";
-  phase: "start" | "end";
-  name: string;
-  id: string;
-  request: AgentStepRequest;
-  output?: unknown;
-  raw?: unknown;
-} | {
-  kind: "request";
-  phase: "error";
-  name: string;
-  id: string;
-  request: AgentStepRequest;
-  error: unknown;
-} | {
-  kind: "chunk";
-  name: string;
-  id: string;
-  delta: string;
-} | {
-  kind: "transition";
-  value: StateValue;
-  event: EventFromLogic<TMachine>;
-} | {
-  kind: "emit";
-  event: EmittedFrom<TMachine>;
-} | {
-  kind: "done";
-  result: Extract<RunAgentResult<TMachine>, {
-    status: "done";
-  }>;
-} | {
-  kind: "idle";
-  result: Extract<RunAgentResult<TMachine>, {
-    status: "idle";
-  }>;
-} | {
-  kind: "error";
-  result: Extract<RunAgentResult<TMachine>, {
-    status: "error";
-  }>;
-};
-/**
- * Streams one {@link runAgent} call as agent-level events. The machine remains
- * the single artifact; this function only projects its requests, chunks,
- * transitions, emitted events, and terminal result into an async iterable.
- */
-declare function runAgentStream<TMachine extends AnyStateMachine>(machine: TMachine, options: RunAgentOptions<TMachine>): AsyncGenerator<AgentStreamEvent<TMachine>, void>;
-//#endregion
 //#region src/provide-executors.d.ts
 /** Options for {@link provideExecutors}. */
 interface ProvideExecutorsOptions<TMachine extends AnyStateMachine = AnyStateMachine> {
@@ -687,12 +607,12 @@ interface ProvideExecutorsOptions<TMachine extends AnyStateMachine = AnyStateMac
   /**
    * A single ordered stream of request-level trace events
    * (`request.start`/`request.end`/`request.error`/`stream.chunk`) with the
-   * SAME versioned envelope {@link runAgent} emits. Because one bound machine can
+   * SAME versioned envelope {@link createAgentRuntime} emits. Because one bound machine can
    * back many concurrent root actors, envelope state (`runId`, monotonic `seq`)
    * is minted per ROOT actor at runtime — two concurrent actors get distinct
    * `runId`s and independent `seq`. Pair with {@link traceTransitions} on the
    * actor's `inspect` to fold `machine.transition` events into the same stream.
-   * Unlike `runAgent` there are NO `run.start`/`run.end` events (no run
+   * Unlike `createAgentRuntime` there are NO `run.start`/`run.end` events (no run
    * boundary).
    */
   onTrace?: (event: AgentTraceEvent<TMachine>) => void;
@@ -700,8 +620,8 @@ interface ProvideExecutorsOptions<TMachine extends AnyStateMachine = AnyStateMac
 /**
  * Binds a machine's agent actor sources to a set of host `executors` in one
  * call, returning a `machine.provide(...)`-ed copy ready for a plain
- * `createActor(...)` — the uncontrolled-mode counterpart to {@link runAgent}.
- * No run loop, no idle settling: the returned machine drives itself, so
+ * `createActor(...)` — the uncontrolled-mode counterpart to {@link createAgentRuntime}.
+ * No run loop, no settling: the returned machine drives itself, so
  *
  * ```ts
  * const actor = createActor(provideExecutors(machine, { generateText, decide }), { input });
@@ -716,10 +636,10 @@ interface ProvideExecutorsOptions<TMachine extends AnyStateMachine = AnyStateMac
  * - `mode: 'stream'` text source → `executors.streamText`
  * - decision / `agent.decide` source → `executors.decide` (snapshot-driven
  *   candidate events, guard `canTake`, and auto-delivery of the chosen event,
- *   mirroring `runAgent` but without its model-call counting)
+ *   mirroring `createAgentRuntime` but without its model-call counting)
  *
  * Pass `options.onTrace` to observe request-level trace events (identical in
- * shape to `runAgent`'s); pair it with {@link traceTransitions} on the actor's
+ * shape to `createAgentRuntime`'s); pair it with {@link traceTransitions} on the actor's
  * `inspect` to also capture `machine.transition` events in the same stream.
  *
  * A source that already carries its own executor (`.withExecutor(...)`) is left
@@ -730,7 +650,7 @@ interface ProvideExecutorsOptions<TMachine extends AnyStateMachine = AnyStateMac
  * Throws at bind time if a source needs an executor kind that `executors` does
  * not provide.
  *
- * Executor inheritance is RECURSIVE, exactly as in `runAgent`: a string-keyed
+ * Executor inheritance is RECURSIVE, exactly as in `createAgentRuntime`: a string-keyed
  * invoked child machine is rebound too, so its own text/decision requests — at
  * any depth — reach the same host executors. A direct-object invoke `src`
  * cannot be swapped via `.provide`, so nothing under one inherits; bind those
@@ -739,4 +659,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 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, type AgentEffects, 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 AgentRunErrorCause, type AgentRunInit, type AgentRunMeta, type AgentRunResult, type AgentRunStart, type AgentRuntime, type AgentRuntimeOptions, type AgentSchemaPack, type AgentSchemas, AgentSnapshotDivergedError, type AgentStepRequest, type AgentTextRequest, type AgentTextResult, type AgentTimerEvent, type AgentTimerScheduler, 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 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, createAgentRuntime, createAgentSchemas, createDecisionLogic, createDecisionRequest, createTextLogic, eventFromInteraction, getAcceptedEvents, getAgentOutputMode, getAgentSchemas, getCallFinishReason, getCallUsage, getInteraction, getJsonSchema, getJsonSchemaSync, getMachineStructuralHash, getMessageText, getStateMeta, getStatePath, inspectTransitions, interactionMetaSchema, isAgentIdle, isAgentMessages, isStandardSchema, messagesSchema, parseAgentEvent, parseOutput, parseProviderOutput, provideExecutors, providerOutputSchema, renderDecisionAttempts, resolveDecision, runToQuiescence, serializeTraceEvent, setupAgent, systemMessage, toolMessage, traceTransitions, userMessage };