@statelyai/agent 2.0.0-alpha.6 → 2.0.0-alpha.8

package/dist/{text-logic-1ZQkO3zr.d.cts → text-logic-C7WJpCIc.d.mts}

@@ -1,4 +1,4 @@
-import { b as StandardSchemaV1, c as AgentTools, f as ChosenEvent, i as AgentToolChoice, t as AgentMessage, u as AllowedEvents, v as InferOutput } from "./types-BHjeDdch.cjs";
+import { C as StandardSchemaV1, b as InferOutput, f as AllowedEvents, m as ChosenEvent, o as AgentToolChoice, r as AgentMessage, u as AgentTools } from "./types-qm00QF91.mjs";
 import { AnyMachineSnapshot, AsyncActorLogic, EventObject, LogicActorLogic, MachineSnapshot } from "xstate";
 
 //#region src/events.d.ts
@@ -383,6 +383,21 @@ type AgentModelMap = Record<string, unknown>;
  * adapter's models map / `resolveModel`) resolves them to a real model.
  */
 type AgentModelRef<TModels extends AgentModelMap = {}> = [keyof TModels] extends [never] ? string : (keyof TModels & string) | (string & {});
+/**
+ * Splits a portable `"provider/model-id"` model ref (the convention JSON
+ * workflows and registry-less hosts use, e.g. `"openai/gpt-5.4-mini"`) into
+ * its parts. A ref with no `/` has no provider — `modelId` is the whole ref.
+ * The standard building block for a host's `resolveModel`:
+ *
+ * @example
+ * ```ts
+ * const resolveModel = (ref: string) => openai(parseModelRef(ref).modelId);
+ * ```
+ */
+declare function parseModelRef(modelRef: string): {
+  provider: string | undefined;
+  modelId: string;
+};
 /**
  * Portable, provider-agnostic input a text request passes to a host
  * executor (`generateText`/`streamText` on {@link AgentRequestExecutors}).
@@ -437,17 +452,22 @@ interface AgentTextRequest<TMetadata = Record<string, unknown>> {
    */
   metadata?: TMetadata;
 }
-/** Inline input for the `agent.userInput` builtin actor — a human-input request (CLI prompt, form, chat reply, …). See {@link RunAgentOptions.userInput}. */
+/**
+ * Inline input for the `agent.userInput` builtin actor — a human-input request
+ * (CLI prompt, chat reply, …) that resolves to the `string` the human typed.
+ * See {@link RunAgentOptions.userInput}. For structured input, parse/classify
+ * the string in a follow-up state, or register a custom actor source; host
+ * rendering hints (a form spec, say) belong in `metadata`.
+ */
 interface AgentUserInput<TMetadata = Record<string, unknown>> {
   prompt?: string;
-  schema?: StandardSchemaV1;
   metadata?: TMetadata;
 }
 /** The five `agent.*` builtin actor logics every setupAgent-built machine registers. @internal */
 type BuiltinAgentActors<TEvent extends string = string, TModel extends string = string> = {
   [GENERATE_TEXT_ACTOR]: AsyncActorLogic<unknown, AgentTextRequest>;
   [STREAM_TEXT_ACTOR]: AsyncActorLogic<unknown, AgentTextRequest>;
-  [USER_INPUT_ACTOR]: AsyncActorLogic<unknown, AgentUserInput>;
+  [USER_INPUT_ACTOR]: AsyncActorLogic<string, AgentUserInput>;
   [DECIDE_ACTOR]: AsyncActorLogic<ChosenEvent, AgentDecisionInput<TEvent, Record<string, unknown>, TModel>>;
   [PLAN_ACTOR]: PlanLogic<StandardSchemaV1<AgentPlanInput<TEvent, Record<string, unknown>, TModel>>>;
 };
@@ -564,7 +584,7 @@ declare function createTextLogic<TInputSchema extends StandardSchemaV1, TOutputS
  * });
  * ```
  */
-declare function bindRequestExecutor<TInputSchema extends StandardSchemaV1, TOutputSchema extends StandardSchemaV1, TMetadata>(logic: TextLogic<TInputSchema, TOutputSchema, TMetadata>, executor: AgentRequestExecutor): TextLogic<TInputSchema, TOutputSchema, TMetadata>;
+declare function bindRequestExecutor<TInputSchema extends StandardSchemaV1, TOutputSchema extends StandardSchemaV1, TMetadata>(logic: TextLogic<TInputSchema, TOutputSchema, TMetadata>, executor: AgentRequestExecutor, info?: Pick<AgentRequestExecutorInfo, "onChunk">): TextLogic<TInputSchema, TOutputSchema, TMetadata>;
 /**
  * The envelope an {@link AgentRequestExecutor} must return: `{ output }` where
  * `output` is the request's value (a text string or a structured object).
@@ -678,5 +698,13 @@ interface StructuredOutputEnvelope {
 declare function buildEnvelopeSchema(inner: StandardSchemaV1, options?: {
   reasoning?: boolean;
 }): StandardSchemaV1<StructuredOutputEnvelope>;
+/**
+ * Validates a raw provider value against the structured-output envelope for
+ * `request` and returns the unwrapped `{ result, reasoning? }` — the checked
+ * replacement for `raw as StructuredOutputEnvelope` in hand-written hosts.
+ * Pair with {@link buildEnvelopeSchema} (which produced the schema the
+ * provider was asked to satisfy).
+ */
+declare function parseStructuredEnvelope(request: Pick<AgentTextRequest, "outputSchema" | "reasoning">, value: unknown): StructuredOutputEnvelope;
 //#endregion
-export { AgentPlanInput as A, AgentEventDescriptor as B, createTextLogic as C, AgentDecisionExecutor as D, parseOutput as E, DecisionLogicConfig as F, getAcceptedEvents as G, AgentRequestOptions as H, PLAN_DONE_EVENT_TYPE as I, matchesEventPattern as K, ResolveDecisionOptions as L, DecisionAttempt as M, DecisionExhaustedError as N, AgentDecisionInput as O, DecisionLogic as P, renderDecisionAttempts as R, buildEnvelopeSchema as S, isStructuredOutputSchema as T, AgentRequestSource as U, AgentEventToolNameResolver as V, EVENT_TOOL_PREFIX as W, TextLogicExecuteArgs as _, AgentRequestExecutorInfo as a, TextLogicOutput as b, AgentRequestMode as c, AiSdkShapedStreamResult as d, AiSdkShapedTextResult as f, TextLogicConfig as g, TextLogic as h, AgentRequestExecutor as i, AgentPlanOutput as j, AgentDecisionRequest as k, AgentTextRequest as l, StructuredOutputEnvelope as m, AgentModelRef as n, AgentRequestExecutorResult as o, BuiltinAgentActors as p, parseAgentEvent as q, AgentOutputMode as r, AgentRequestExecutors as s, AgentModelMap as t, AgentUserInput as u, TextLogicExecutor as v, getAgentOutputMode as w, bindRequestExecutor as x, TextLogicInput as y, resolveDecision as z };
+export { AgentDecisionInput as A, renderDecisionAttempts as B, createTextLogic as C, parseOutput as D, parseModelRef as E, DecisionExhaustedError as F, AgentRequestSource as G, AgentEventDescriptor as H, DecisionLogic as I, matchesEventPattern as J, EVENT_TOOL_PREFIX as K, DecisionLogicConfig as L, AgentPlanInput as M, AgentPlanOutput as N, parseStructuredEnvelope as O, DecisionAttempt as P, PLAN_DONE_EVENT_TYPE as R, buildEnvelopeSchema as S, isStructuredOutputSchema as T, AgentEventToolNameResolver as U, resolveDecision as V, AgentRequestOptions as W, parseAgentEvent as Y, TextLogicExecuteArgs as _, AgentRequestExecutorInfo as a, TextLogicOutput as b, AgentRequestMode as c, AiSdkShapedStreamResult as d, AiSdkShapedTextResult as f, TextLogicConfig as g, TextLogic as h, AgentRequestExecutor as i, AgentDecisionRequest as j, AgentDecisionExecutor as k, AgentTextRequest as l, StructuredOutputEnvelope as m, AgentModelRef as n, AgentRequestExecutorResult as o, BuiltinAgentActors as p, getAcceptedEvents as q, AgentOutputMode as r, AgentRequestExecutors as s, AgentModelMap as t, AgentUserInput as u, TextLogicExecutor as v, getAgentOutputMode as w, bindRequestExecutor as x, TextLogicInput as y, ResolveDecisionOptions as z };

package/dist/{text-logic-2EMJIS-n.d.mts → text-logic-CZjyACzQ.d.cts}

@@ -1,4 +1,4 @@
-import { b as StandardSchemaV1, c as AgentTools, f as ChosenEvent, i as AgentToolChoice, t as AgentMessage, u as AllowedEvents, v as InferOutput } from "./types-Cq1YlAQ6.mjs";
+import { C as StandardSchemaV1, b as InferOutput, f as AllowedEvents, m as ChosenEvent, o as AgentToolChoice, r as AgentMessage, u as AgentTools } from "./types-C9QiMjre.cjs";
 import { AnyMachineSnapshot, AsyncActorLogic, EventObject, LogicActorLogic, MachineSnapshot } from "xstate";
 
 //#region src/events.d.ts
@@ -383,6 +383,21 @@ type AgentModelMap = Record<string, unknown>;
  * adapter's models map / `resolveModel`) resolves them to a real model.
  */
 type AgentModelRef<TModels extends AgentModelMap = {}> = [keyof TModels] extends [never] ? string : (keyof TModels & string) | (string & {});
+/**
+ * Splits a portable `"provider/model-id"` model ref (the convention JSON
+ * workflows and registry-less hosts use, e.g. `"openai/gpt-5.4-mini"`) into
+ * its parts. A ref with no `/` has no provider — `modelId` is the whole ref.
+ * The standard building block for a host's `resolveModel`:
+ *
+ * @example
+ * ```ts
+ * const resolveModel = (ref: string) => openai(parseModelRef(ref).modelId);
+ * ```
+ */
+declare function parseModelRef(modelRef: string): {
+  provider: string | undefined;
+  modelId: string;
+};
 /**
  * Portable, provider-agnostic input a text request passes to a host
  * executor (`generateText`/`streamText` on {@link AgentRequestExecutors}).
@@ -437,17 +452,22 @@ interface AgentTextRequest<TMetadata = Record<string, unknown>> {
    */
   metadata?: TMetadata;
 }
-/** Inline input for the `agent.userInput` builtin actor — a human-input request (CLI prompt, form, chat reply, …). See {@link RunAgentOptions.userInput}. */
+/**
+ * Inline input for the `agent.userInput` builtin actor — a human-input request
+ * (CLI prompt, chat reply, …) that resolves to the `string` the human typed.
+ * See {@link RunAgentOptions.userInput}. For structured input, parse/classify
+ * the string in a follow-up state, or register a custom actor source; host
+ * rendering hints (a form spec, say) belong in `metadata`.
+ */
 interface AgentUserInput<TMetadata = Record<string, unknown>> {
   prompt?: string;
-  schema?: StandardSchemaV1;
   metadata?: TMetadata;
 }
 /** The five `agent.*` builtin actor logics every setupAgent-built machine registers. @internal */
 type BuiltinAgentActors<TEvent extends string = string, TModel extends string = string> = {
   [GENERATE_TEXT_ACTOR]: AsyncActorLogic<unknown, AgentTextRequest>;
   [STREAM_TEXT_ACTOR]: AsyncActorLogic<unknown, AgentTextRequest>;
-  [USER_INPUT_ACTOR]: AsyncActorLogic<unknown, AgentUserInput>;
+  [USER_INPUT_ACTOR]: AsyncActorLogic<string, AgentUserInput>;
   [DECIDE_ACTOR]: AsyncActorLogic<ChosenEvent, AgentDecisionInput<TEvent, Record<string, unknown>, TModel>>;
   [PLAN_ACTOR]: PlanLogic<StandardSchemaV1<AgentPlanInput<TEvent, Record<string, unknown>, TModel>>>;
 };
@@ -564,7 +584,7 @@ declare function createTextLogic<TInputSchema extends StandardSchemaV1, TOutputS
  * });
  * ```
  */
-declare function bindRequestExecutor<TInputSchema extends StandardSchemaV1, TOutputSchema extends StandardSchemaV1, TMetadata>(logic: TextLogic<TInputSchema, TOutputSchema, TMetadata>, executor: AgentRequestExecutor): TextLogic<TInputSchema, TOutputSchema, TMetadata>;
+declare function bindRequestExecutor<TInputSchema extends StandardSchemaV1, TOutputSchema extends StandardSchemaV1, TMetadata>(logic: TextLogic<TInputSchema, TOutputSchema, TMetadata>, executor: AgentRequestExecutor, info?: Pick<AgentRequestExecutorInfo, "onChunk">): TextLogic<TInputSchema, TOutputSchema, TMetadata>;
 /**
  * The envelope an {@link AgentRequestExecutor} must return: `{ output }` where
  * `output` is the request's value (a text string or a structured object).
@@ -678,5 +698,13 @@ interface StructuredOutputEnvelope {
 declare function buildEnvelopeSchema(inner: StandardSchemaV1, options?: {
   reasoning?: boolean;
 }): StandardSchemaV1<StructuredOutputEnvelope>;
+/**
+ * Validates a raw provider value against the structured-output envelope for
+ * `request` and returns the unwrapped `{ result, reasoning? }` — the checked
+ * replacement for `raw as StructuredOutputEnvelope` in hand-written hosts.
+ * Pair with {@link buildEnvelopeSchema} (which produced the schema the
+ * provider was asked to satisfy).
+ */
+declare function parseStructuredEnvelope(request: Pick<AgentTextRequest, "outputSchema" | "reasoning">, value: unknown): StructuredOutputEnvelope;
 //#endregion
-export { AgentPlanInput as A, AgentEventDescriptor as B, createTextLogic as C, AgentDecisionExecutor as D, parseOutput as E, DecisionLogicConfig as F, getAcceptedEvents as G, AgentRequestOptions as H, PLAN_DONE_EVENT_TYPE as I, matchesEventPattern as K, ResolveDecisionOptions as L, DecisionAttempt as M, DecisionExhaustedError as N, AgentDecisionInput as O, DecisionLogic as P, renderDecisionAttempts as R, buildEnvelopeSchema as S, isStructuredOutputSchema as T, AgentRequestSource as U, AgentEventToolNameResolver as V, EVENT_TOOL_PREFIX as W, TextLogicExecuteArgs as _, AgentRequestExecutorInfo as a, TextLogicOutput as b, AgentRequestMode as c, AiSdkShapedStreamResult as d, AiSdkShapedTextResult as f, TextLogicConfig as g, TextLogic as h, AgentRequestExecutor as i, AgentPlanOutput as j, AgentDecisionRequest as k, AgentTextRequest as l, StructuredOutputEnvelope as m, AgentModelRef as n, AgentRequestExecutorResult as o, BuiltinAgentActors as p, parseAgentEvent as q, AgentOutputMode as r, AgentRequestExecutors as s, AgentModelMap as t, AgentUserInput as u, TextLogicExecutor as v, getAgentOutputMode as w, bindRequestExecutor as x, TextLogicInput as y, resolveDecision as z };
+export { AgentDecisionInput as A, renderDecisionAttempts as B, createTextLogic as C, parseOutput as D, parseModelRef as E, DecisionExhaustedError as F, AgentRequestSource as G, AgentEventDescriptor as H, DecisionLogic as I, matchesEventPattern as J, EVENT_TOOL_PREFIX as K, DecisionLogicConfig as L, AgentPlanInput as M, AgentPlanOutput as N, parseStructuredEnvelope as O, DecisionAttempt as P, PLAN_DONE_EVENT_TYPE as R, buildEnvelopeSchema as S, isStructuredOutputSchema as T, AgentEventToolNameResolver as U, resolveDecision as V, AgentRequestOptions as W, parseAgentEvent as Y, TextLogicExecuteArgs as _, AgentRequestExecutorInfo as a, TextLogicOutput as b, AgentRequestMode as c, AiSdkShapedStreamResult as d, AiSdkShapedTextResult as f, TextLogicConfig as g, TextLogic as h, AgentRequestExecutor as i, AgentDecisionRequest as j, AgentDecisionExecutor as k, AgentTextRequest as l, StructuredOutputEnvelope as m, AgentModelRef as n, AgentRequestExecutorResult as o, BuiltinAgentActors as p, getAcceptedEvents as q, AgentOutputMode as r, AgentRequestExecutors as s, AgentModelMap as t, AgentUserInput as u, TextLogicExecutor as v, getAgentOutputMode as w, bindRequestExecutor as x, TextLogicInput as y, ResolveDecisionOptions as z };

package/dist/{types-BHjeDdch.d.cts → types-C9QiMjre.d.cts}

@@ -38,15 +38,26 @@ interface StandardSchemaV1<Input = unknown, Output = Input> {
 type InferOutput<T> = T extends StandardSchemaV1<any, infer O> ? O : never;
 /** An event schema's output, widened to `unknown` when it validates an empty object (no payload fields). */
 type EventPayload<T> = T extends Record<string, never> ? unknown : T;
+/**
+ * One entry in an event schema map: a Standard Schema for the event's
+ * payload, or the `{}` shorthand for a payload-less event
+ * (`events: { CONFIRM: {} }` ≡ `events: { CONFIRM: z.object({}) }`).
+ */
+type AgentEventSchemaInput = StandardSchemaV1 | Record<string, never>;
+/** An event schema map as authored: payload schemas and/or `{}` payload-less shorthands, keyed by event type. */
+type AgentEventSchemaInputMap = Record<string, AgentEventSchemaInput>;
+/** Resolves an authored event schema map's `{}` shorthands to real (empty-payload) schemas — the type-level counterpart of the runtime normalization in `createAgentSchemas`. */
+type NormalizedEventSchemas<T extends AgentEventSchemaInputMap> = { [K in keyof T]: T[K] extends StandardSchemaV1 ? T[K] : StandardSchemaV1<{}> };
 /**
  * The discriminated event union derived from a machine's event schema map
  * (e.g. `{ ASK: z.object({ question: z.string() }) }` → `{ type: 'ASK';
- * question: string }`). Used internally by {@link createAgentSchemas} and
- * `setupAgent` to type a machine's `TEvent`.
+ * question: string }`; a `{}` shorthand entry yields its bare `{ type: K }`).
+ * Used internally by {@link createAgentSchemas} and `setupAgent` to type a
+ * machine's `TEvent`.
  */
-type EventUnion<T extends Record<string, StandardSchemaV1>> = { [K in keyof T & string]: {
+type EventUnion<T extends AgentEventSchemaInputMap> = { [K in keyof T & string]: {
   type: K;
-} & EventPayload<InferOutput<T[K]>> }[keyof T & string];
+} & (T[K] extends StandardSchemaV1 ? EventPayload<InferOutput<T[K]>> : unknown) }[keyof T & string];
 /** Raw binary or string content for an {@link ImagePart}/{@link FilePart}. */
 type DataContent = string | Uint8Array | ArrayBuffer;
 /** Provider-specific passthrough options, keyed by provider name (e.g. `{ anthropic: { cacheControl: ... } }`). */
@@ -205,4 +216,4 @@ type AllowedEvents<TEvent extends string = string, TInput = unknown> = AllowedEv
   input: TInput;
 }) => AllowedEventPattern<TEvent> | readonly AllowedEventPattern<TEvent>[]);
 //#endregion
-export { ToolCallPart as C, UserMessage as D, ToolResultPart as E, TextPart as S, ToolResultOutput as T, ImagePart as _, AgentToolDescriptor as a, StandardSchemaV1 as b, AgentTools as c, AssistantMessage as d, ChosenEvent as f, FilePart as g, EventUnion as h, AgentToolChoice as i, AllowedEventPattern as l, EventPayload as m, AgentSnapshotStore as n, AgentToolExecute as o, DataContent as p, AgentTool as r, AgentToolSchema as s, AgentMessage as t, AllowedEvents as u, InferOutput as v, ToolMessage as w, SystemMessage as x, ProviderOptions as y };
+export { UserMessage as A, StandardSchemaV1 as C, ToolMessage as D, ToolCallPart as E, ToolResultOutput as O, ProviderOptions as S, TextPart as T, EventUnion as _, AgentTool as a, InferOutput as b, AgentToolExecute as c, AllowedEventPattern as d, AllowedEvents as f, EventPayload as g, DataContent as h, AgentSnapshotStore as i, ToolResultPart as k, AgentToolSchema as l, ChosenEvent as m, AgentEventSchemaInputMap as n, AgentToolChoice as o, AssistantMessage as p, AgentMessage as r, AgentToolDescriptor as s, AgentEventSchemaInput as t, AgentTools as u, FilePart as v, SystemMessage as w, NormalizedEventSchemas as x, ImagePart as y };

package/dist/{types-Cq1YlAQ6.d.mts → types-qm00QF91.d.mts}

@@ -38,15 +38,26 @@ interface StandardSchemaV1<Input = unknown, Output = Input> {
 type InferOutput<T> = T extends StandardSchemaV1<any, infer O> ? O : never;
 /** An event schema's output, widened to `unknown` when it validates an empty object (no payload fields). */
 type EventPayload<T> = T extends Record<string, never> ? unknown : T;
+/**
+ * One entry in an event schema map: a Standard Schema for the event's
+ * payload, or the `{}` shorthand for a payload-less event
+ * (`events: { CONFIRM: {} }` ≡ `events: { CONFIRM: z.object({}) }`).
+ */
+type AgentEventSchemaInput = StandardSchemaV1 | Record<string, never>;
+/** An event schema map as authored: payload schemas and/or `{}` payload-less shorthands, keyed by event type. */
+type AgentEventSchemaInputMap = Record<string, AgentEventSchemaInput>;
+/** Resolves an authored event schema map's `{}` shorthands to real (empty-payload) schemas — the type-level counterpart of the runtime normalization in `createAgentSchemas`. */
+type NormalizedEventSchemas<T extends AgentEventSchemaInputMap> = { [K in keyof T]: T[K] extends StandardSchemaV1 ? T[K] : StandardSchemaV1<{}> };
 /**
  * The discriminated event union derived from a machine's event schema map
  * (e.g. `{ ASK: z.object({ question: z.string() }) }` → `{ type: 'ASK';
- * question: string }`). Used internally by {@link createAgentSchemas} and
- * `setupAgent` to type a machine's `TEvent`.
+ * question: string }`; a `{}` shorthand entry yields its bare `{ type: K }`).
+ * Used internally by {@link createAgentSchemas} and `setupAgent` to type a
+ * machine's `TEvent`.
  */
-type EventUnion<T extends Record<string, StandardSchemaV1>> = { [K in keyof T & string]: {
+type EventUnion<T extends AgentEventSchemaInputMap> = { [K in keyof T & string]: {
   type: K;
-} & EventPayload<InferOutput<T[K]>> }[keyof T & string];
+} & (T[K] extends StandardSchemaV1 ? EventPayload<InferOutput<T[K]>> : unknown) }[keyof T & string];
 /** Raw binary or string content for an {@link ImagePart}/{@link FilePart}. */
 type DataContent = string | Uint8Array | ArrayBuffer;
 /** Provider-specific passthrough options, keyed by provider name (e.g. `{ anthropic: { cacheControl: ... } }`). */
@@ -205,4 +216,4 @@ type AllowedEvents<TEvent extends string = string, TInput = unknown> = AllowedEv
   input: TInput;
 }) => AllowedEventPattern<TEvent> | readonly AllowedEventPattern<TEvent>[]);
 //#endregion
-export { ToolCallPart as C, UserMessage as D, ToolResultPart as E, TextPart as S, ToolResultOutput as T, ImagePart as _, AgentToolDescriptor as a, StandardSchemaV1 as b, AgentTools as c, AssistantMessage as d, ChosenEvent as f, FilePart as g, EventUnion as h, AgentToolChoice as i, AllowedEventPattern as l, EventPayload as m, AgentSnapshotStore as n, AgentToolExecute as o, DataContent as p, AgentTool as r, AgentToolSchema as s, AgentMessage as t, AllowedEvents as u, InferOutput as v, ToolMessage as w, SystemMessage as x, ProviderOptions as y };
+export { UserMessage as A, StandardSchemaV1 as C, ToolMessage as D, ToolCallPart as E, ToolResultOutput as O, ProviderOptions as S, TextPart as T, EventUnion as _, AgentTool as a, InferOutput as b, AgentToolExecute as c, AllowedEventPattern as d, AllowedEvents as f, EventPayload as g, DataContent as h, AgentSnapshotStore as i, ToolResultPart as k, AgentToolSchema as l, ChosenEvent as m, AgentEventSchemaInputMap as n, AgentToolChoice as o, AssistantMessage as p, AgentMessage as r, AgentToolDescriptor as s, AgentEventSchemaInput as t, AgentTools as u, FilePart as v, SystemMessage as w, NormalizedEventSchemas as x, ImagePart as y };

package/dist/{utils-CWUCa3pF.d.mts → utils-Dri7aeEG.d.cts}

@@ -1,4 +1,4 @@
-import { C as ToolCallPart, D as UserMessage, E as ToolResultPart, S as TextPart, _ as ImagePart, b as StandardSchemaV1, d as AssistantMessage, g as FilePart, t as AgentMessage, w as ToolMessage, x as SystemMessage } from "./types-Cq1YlAQ6.mjs";
+import { A as UserMessage, C as StandardSchemaV1, D as ToolMessage, E as ToolCallPart, T as TextPart, k as ToolResultPart, p as AssistantMessage, r as AgentMessage, v as FilePart, w as SystemMessage, y as ImagePart } from "./types-C9QiMjre.cjs";
 import { AnyMachineSnapshot, AnyStateMachine } from "xstate";
 
 //#region src/utils.d.ts

package/dist/{utils-lK1wnL2i.d.cts → utils-Y6GDRGGE.d.mts}

@@ -1,4 +1,4 @@
-import { C as ToolCallPart, D as UserMessage, E as ToolResultPart, S as TextPart, _ as ImagePart, b as StandardSchemaV1, d as AssistantMessage, g as FilePart, t as AgentMessage, w as ToolMessage, x as SystemMessage } from "./types-BHjeDdch.cjs";
+import { A as UserMessage, C as StandardSchemaV1, D as ToolMessage, E as ToolCallPart, T as TextPart, k as ToolResultPart, p as AssistantMessage, r as AgentMessage, v as FilePart, w as SystemMessage, y as ImagePart } from "./types-qm00QF91.mjs";
 import { AnyMachineSnapshot, AnyStateMachine } from "xstate";
 
 //#region src/utils.d.ts

package/dist/zod.d.cts

@@ -1,4 +1,4 @@
-import { t as AgentMessage } from "./types-BHjeDdch.cjs";
+import { r as AgentMessage } from "./types-C9QiMjre.cjs";
 import { z } from "zod";
 
 //#region src/zod/index.d.ts

package/dist/zod.d.mts

@@ -1,4 +1,4 @@
-import { t as AgentMessage } from "./types-Cq1YlAQ6.mjs";
+import { r as AgentMessage } from "./types-qm00QF91.mjs";
 import { z } from "zod";
 
 //#region src/zod/index.d.ts

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@statelyai/agent",
-  "version": "2.0.0-alpha.6",
+  "version": "2.0.0-alpha.8",
   "description": "State-machine authoring layer for AI agents",
   "type": "module",
   "main": "dist/index.cjs",
@@ -96,7 +96,7 @@
     "tsx": "^4.21.0",
     "typescript": "^5.6.2",
     "vitest": "^2.1.2",
-    "xstate": "6.0.0-alpha.17",
+    "xstate": "6.0.0-alpha.21",
     "zod": "^4.3.6"
   },
   "publishConfig": {

package/readme.md

@@ -24,18 +24,18 @@ Node 22.18 or newer is required.
 
 ## Quick start
 
-<!-- refund decision example using setupAgent, agent.decide, a machine guard, and runAgent -->
+<!-- refund decision example using setupAgent, agent.decide, a machine guard, and the AI SDK runAgent host -->
 
 This agent reviews refund requests. The model may propose an automatic refund, but the state machine owns the $100 limit.
 
 ```ts
-import { openai } from '@ai-sdk/openai';
-import { createAiSdkExecutors, defineModels } from '@statelyai/agent/ai-sdk';
-import { runAgent, setupAgent } from '@statelyai/agent';
-import { z } from 'zod';
+import { openai } from "@ai-sdk/openai";
+import { defineModels, runAgent } from "@statelyai/agent/ai-sdk";
+import { setupAgent } from "@statelyai/agent";
+import { z } from "zod";
 
 const models = defineModels({
-  fast: openai('gpt-5.4-mini'),
+  fast: openai("gpt-5.4-mini"),
 });
 
 const agent = setupAgent({
@@ -49,54 +49,52 @@ const agent = setupAgent({
     amount: z.number(),
   }),
   output: z.object({
-    outcome: z.enum(['refunded', 'review']),
+    outcome: z.enum(["refunded", "review"]),
   }),
   events: {
-    AUTO_REFUND: z.object({}),
+    AUTO_REFUND: {},
     REVIEW: z.object({ reason: z.string() }),
   },
 });
 
 const refundMachine = agent.createMachine({
   context: ({ input }) => input,
-  initial: 'deciding',
+  initial: "deciding",
   states: {
     deciding: {
       invoke: {
-        src: 'agent.decide',
+        src: "agent.decide",
         input: ({ context }) => ({
-          model: 'fast',
-          system: 'Choose AUTO_REFUND for eligible requests. Otherwise choose REVIEW.',
+          model: "fast",
+          system: "Choose AUTO_REFUND for eligible requests. Otherwise choose REVIEW.",
           prompt: `${context.request}\nAmount: $${context.amount}`,
-          allowedEvents: ['AUTO_REFUND', 'REVIEW'],
+          allowedEvents: ["AUTO_REFUND", "REVIEW"],
         }),
       },
       on: {
-        AUTO_REFUND: ({ context }) =>
-          context.amount <= 100 ? { target: 'refunded' } : undefined,
-        REVIEW: { target: 'review' },
+        AUTO_REFUND: ({ context }) => (context.amount <= 100 ? { target: "refunded" } : undefined),
+        REVIEW: { target: "review" },
       },
     },
     refunded: {
-      type: 'final',
-      output: () => ({ outcome: 'refunded' }),
+      type: "final",
+      output: () => ({ outcome: "refunded" }),
     },
     review: {
-      type: 'final',
-      output: () => ({ outcome: 'review' }),
+      type: "final",
+      output: () => ({ outcome: "review" }),
     },
   },
 });
 
 const result = await runAgent(refundMachine, {
   input: {
-    request: 'I was charged twice for the same order.',
+    request: "I was charged twice for the same order.",
     amount: 75,
   },
-  executors: createAiSdkExecutors({ models }),
 });
 
-if (result.status === 'done') {
+if (result.status === "done") {
   console.log(result.output);
 }
 ```
@@ -132,6 +130,7 @@ The example has one model decision and two final outcomes. Real machines can add
 <!-- starter examples derived from examples/*/metadata.json and examples/index.ts -->
 
 - [Twenty Questions](examples/twenty-questions) shows a model choosing legal events in a loop.
+- [Go Fish](examples/go-fish) pits a model against a human while the machine enforces hidden-information game rules.
 - [Human in the loop](examples/human-in-the-loop) pauses, stores a snapshot, and resumes after review.
 - [Ticket triage](examples/triage) returns structured data from a model request.
 - [JSON agent](examples/json-agent) runs a machine defined as data.