@statelyai/agent 2.0.0-alpha.7 → 2.0.0-alpha.9

package/dist/{text-logic-2wFNEznm.d.mts → 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-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-qm00QF91.mjs";
 import { AnyMachineSnapshot, AsyncActorLogic, EventObject, LogicActorLogic, MachineSnapshot } from "xstate";
 
 //#region src/events.d.ts

package/dist/{text-logic-4Q2F9kyr.d.cts → 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-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-C9QiMjre.cjs";
 import { AnyMachineSnapshot, AsyncActorLogic, EventObject, LogicActorLogic, MachineSnapshot } from "xstate";
 
 //#region src/events.d.ts

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.7",
+  "version": "2.0.0-alpha.9",
   "description": "State-machine authoring layer for AI agents",
   "type": "module",
   "main": "dist/index.cjs",

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);
 }
 ```