@statelyai/agent 2.0.0-alpha.18 → 2.0.0-alpha.20

package/dist/machines.cjs

@@ -1,5 +1,5 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
-const require_setup_agent = require("./setup-agent-C3ETi_HZ.cjs");
+const require_setup_agent = require("./setup-agent-gISRLxRe.cjs");
 //#region src/machines/internal.ts
 /** The builtin inline text request every preset lowers a request entry to. */
 const GENERATE_TEXT_SRC = "agent.generateText";
@@ -69,7 +69,7 @@ function requestInput(name, entry, defaultModel, prompt) {
 		prompt,
 		...entry.tools ? { tools: entry.tools } : {},
 		...entry.outputSchema ? { outputSchema: entry.outputSchema } : {},
-		...entry.maxTurns !== void 0 ? { metadata: { maxSteps: entry.maxTurns } } : {}
+		...entry.maxSteps !== void 0 ? { maxSteps: entry.maxSteps } : {}
 	};
 }
 /**
@@ -100,7 +100,7 @@ const inputSchema$6 = objectSchema({ prompt: jsonString }, ["prompt"]);
 const outputSchema$5 = objectSchema({ result: jsonAny }, ["result"]);
 /**
 * The single-state tool loop: one text request carries the `tools`, and the
-* host runs the tool loop inside it (`maxTurns` bounds it). Selecting and
+* host runs the tool loop inside it (`maxSteps` bounds it). Selecting and
 * executing tools is the model + host's business, not machine states.
 *
 * States: `answering` → `done`.
@@ -110,7 +110,7 @@ const outputSchema$5 = objectSchema({ result: jsonAny }, ["result"]);
 *   model: "quick",
 *   instructions: "Answer using the tools.",
 *   tools: { calculate },
-*   maxTurns: 5,
+*   maxSteps: 5,
 * });
 *
 * const result = await runAgent(machine, {
@@ -121,11 +121,7 @@ const outputSchema$5 = objectSchema({ result: jsonAny }, ["result"]);
 * ```
 */
 function createToolLoopMachine(config) {
-	const { model, instructions, tools, outputSchema: resultSchema, maxTurns, interruptOn } = config;
-	const metadata = {
-		...maxTurns !== void 0 ? { maxSteps: maxTurns } : {},
-		...interruptOn && interruptOn.length > 0 ? { interruptOn: [...interruptOn] } : {}
-	};
+	const { model, instructions, tools, outputSchema: resultSchema, maxSteps } = config;
 	return require_setup_agent.setupAgent({
 		context: contextSchema$6,
 		input: inputSchema$6,
@@ -149,7 +145,7 @@ function createToolLoopMachine(config) {
 					prompt: context.prompt,
 					...tools ? { tools } : {},
 					...resultSchema ? { outputSchema: resultSchema } : {},
-					...Object.keys(metadata).length > 0 ? { metadata } : {}
+					...maxSteps !== void 0 ? { maxSteps } : {}
 				}),
 				onDone: ({ output }) => ({
 					target: "done",
@@ -212,7 +208,7 @@ function createSequentialMachine(config) {
 				model: step.model,
 				outputSchema: step.outputSchema,
 				tools: step.tools,
-				maxTurns: step.maxTurns
+				maxSteps: step.maxSteps
 			}, model, step.prompt ? step.prompt({
 				prompt: context.prompt,
 				results: context.results,
@@ -448,7 +444,7 @@ const outputSchema$1 = objectSchema({
 }, ["iterations", "results"]);
 /**
 * A bounded repeat: run the body, check `until` over the accumulated state,
-* and either stop or go again. `maxIterations` is a guard, so the loop cannot
+* and either stop or go again. `maxTurns` is a guard, so the loop cannot
 * run away even if `until` never returns `true`.
 *
 * States: `running` → `checking` → (`running` | `done`).
@@ -458,13 +454,13 @@ const outputSchema$1 = objectSchema({
 *   model: "quick",
 *   body: { instructions: "Improve the draft. Return only the draft." },
 *   until: ({ last }) => String(last).length > 500,
-*   maxIterations: 4,
+*   maxTurns: 4,
 * });
 * ```
 */
 function createLoopMachine(config) {
-	const { model, body, until, maxIterations } = config;
-	if (!Number.isInteger(maxIterations) || maxIterations < 1) throw new Error("createLoopMachine: maxIterations must be an integer >= 1.");
+	const { model, body, until, maxTurns } = config;
+	if (!Number.isInteger(maxTurns) || maxTurns < 1) throw new Error("createLoopMachine: maxTurns must be an integer >= 1.");
 	const agentSetup = require_setup_agent.setupAgent({
 		context: contextSchema$2,
 		input: inputSchema$2,
@@ -503,7 +499,7 @@ function createLoopMachine(config) {
 			} },
 			checking: {
 				type: "choice",
-				choice: ({ context }) => context.iterations >= maxIterations || until(loopState(context)) ? { target: "done" } : { target: "running" }
+				choice: ({ context }) => context.iterations >= maxTurns || until(loopState(context)) ? { target: "done" } : { target: "running" }
 			},
 			done: {
 				type: "final",
@@ -700,7 +696,7 @@ function createHandoffMachine(config) {
 		input: inputSchema,
 		events: Object.fromEntries(names.map((name) => [transferEventType(name), transferPayload])),
 		actors: machineActors(agents),
-		isSuspended: (snapshot) => snapshot.matches("waiting")
+		isIdle: (snapshot) => snapshot.matches("waiting")
 	});
 	const turnState = (name) => `${name}Turn`;
 	const states = {

package/dist/machines.d.cts

@@ -12,15 +12,12 @@ interface CreateToolLoopMachineConfig {
   tools?: AgentTools;
   /** Structured output schema. Omitted means the output is plain text. */
   outputSchema?: StandardSchemaV1;
-  /** Bounds the host-side tool loop — lowered to `metadata.maxSteps`. */
-  maxTurns?: number;
   /**
-   * Tool names the host should gate before executing. Lowered to
-   * `metadata.interruptOn`, which only a host that implements gating reads —
-   * the preset itself stays a single state and never pauses. For a real
-   * approval gate as machine states, eject to `examples/review-tool-calls`.
+   * Bounds the host-side tool loop — lowered to the request's typed
+   * {@link AgentTextRequest.maxSteps}. It bounds MODEL STEPS inside one
+   * request, not machine turns, hence the name.
    */
-  interruptOn?: readonly string[];
+  maxSteps?: number;
 }
 /** Context of a {@link createToolLoopMachine} machine. */
 type ToolLoopContext = {
@@ -29,7 +26,7 @@ type ToolLoopContext = {
 };
 /**
  * The single-state tool loop: one text request carries the `tools`, and the
- * host runs the tool loop inside it (`maxTurns` bounds it). Selecting and
+ * host runs the tool loop inside it (`maxSteps` bounds it). Selecting and
  * executing tools is the model + host's business, not machine states.
  *
  * States: `answering` → `done`.
@@ -39,7 +36,7 @@ type ToolLoopContext = {
  *   model: "quick",
  *   instructions: "Answer using the tools.",
  *   tools: { calculate },
- *   maxTurns: 5,
+ *   maxSteps: 5,
  * });
  *
  * const result = await runAgent(machine, {
@@ -75,8 +72,8 @@ interface SequentialStep {
   model?: string;
   /** Tools the host runs inside this step's request. */
   tools?: AgentTools;
-  /** Bounds this step's host-side tool loop (`metadata.maxSteps`). */
-  maxTurns?: number;
+  /** Bounds this step's host-side tool loop (the request's typed `maxSteps`). */
+  maxSteps?: number;
 }
 /** Config for {@link createSequentialMachine}. */
 interface CreateSequentialMachineConfig {
@@ -124,8 +121,8 @@ interface PresetRequestEntry {
   outputSchema?: StandardSchemaV1;
   /** Tools the host runs inside this one request. */
   tools?: AgentTools;
-  /** Bounds the host-side tool loop (lowered to `metadata.maxSteps`). */
-  maxTurns?: number;
+  /** Bounds the host-side tool loop (lowered to the request's typed `maxSteps`). */
+  maxSteps?: number;
 }
 /** One delegated unit of work, lowered to an invoked child machine. */
 interface PresetMachineEntry {
@@ -240,8 +237,8 @@ interface CreateLoopMachineConfig {
   };
   /** Stop condition, checked after each iteration. */
   until: (state: LoopState) => boolean;
-  /** Hard upper bound on iterations, enforced by a guard. */
-  maxIterations: number;
+  /** Hard upper bound on machine turns (iterations), enforced by a guard. */
+  maxTurns: number;
 }
 /** Context of a {@link createLoopMachine} machine. */
 type LoopContext = {
@@ -252,7 +249,7 @@ type LoopContext = {
 };
 /**
  * A bounded repeat: run the body, check `until` over the accumulated state,
- * and either stop or go again. `maxIterations` is a guard, so the loop cannot
+ * and either stop or go again. `maxTurns` is a guard, so the loop cannot
  * run away even if `until` never returns `true`.
  *
  * States: `running` → `checking` → (`running` | `done`).
@@ -262,7 +259,7 @@ type LoopContext = {
  *   model: "quick",
  *   body: { instructions: "Improve the draft. Return only the draft." },
  *   until: ({ last }) => String(last).length > 500,
- *   maxIterations: 4,
+ *   maxTurns: 4,
  * });
  * ```
  */

package/dist/machines.d.mts

@@ -12,15 +12,12 @@ interface CreateToolLoopMachineConfig {
   tools?: AgentTools;
   /** Structured output schema. Omitted means the output is plain text. */
   outputSchema?: StandardSchemaV1;
-  /** Bounds the host-side tool loop — lowered to `metadata.maxSteps`. */
-  maxTurns?: number;
   /**
-   * Tool names the host should gate before executing. Lowered to
-   * `metadata.interruptOn`, which only a host that implements gating reads —
-   * the preset itself stays a single state and never pauses. For a real
-   * approval gate as machine states, eject to `examples/review-tool-calls`.
+   * Bounds the host-side tool loop — lowered to the request's typed
+   * {@link AgentTextRequest.maxSteps}. It bounds MODEL STEPS inside one
+   * request, not machine turns, hence the name.
    */
-  interruptOn?: readonly string[];
+  maxSteps?: number;
 }
 /** Context of a {@link createToolLoopMachine} machine. */
 type ToolLoopContext = {
@@ -29,7 +26,7 @@ type ToolLoopContext = {
 };
 /**
  * The single-state tool loop: one text request carries the `tools`, and the
- * host runs the tool loop inside it (`maxTurns` bounds it). Selecting and
+ * host runs the tool loop inside it (`maxSteps` bounds it). Selecting and
  * executing tools is the model + host's business, not machine states.
  *
  * States: `answering` → `done`.
@@ -39,7 +36,7 @@ type ToolLoopContext = {
  *   model: "quick",
  *   instructions: "Answer using the tools.",
  *   tools: { calculate },
- *   maxTurns: 5,
+ *   maxSteps: 5,
  * });
  *
  * const result = await runAgent(machine, {
@@ -75,8 +72,8 @@ interface SequentialStep {
   model?: string;
   /** Tools the host runs inside this step's request. */
   tools?: AgentTools;
-  /** Bounds this step's host-side tool loop (`metadata.maxSteps`). */
-  maxTurns?: number;
+  /** Bounds this step's host-side tool loop (the request's typed `maxSteps`). */
+  maxSteps?: number;
 }
 /** Config for {@link createSequentialMachine}. */
 interface CreateSequentialMachineConfig {
@@ -124,8 +121,8 @@ interface PresetRequestEntry {
   outputSchema?: StandardSchemaV1;
   /** Tools the host runs inside this one request. */
   tools?: AgentTools;
-  /** Bounds the host-side tool loop (lowered to `metadata.maxSteps`). */
-  maxTurns?: number;
+  /** Bounds the host-side tool loop (lowered to the request's typed `maxSteps`). */
+  maxSteps?: number;
 }
 /** One delegated unit of work, lowered to an invoked child machine. */
 interface PresetMachineEntry {
@@ -240,8 +237,8 @@ interface CreateLoopMachineConfig {
   };
   /** Stop condition, checked after each iteration. */
   until: (state: LoopState) => boolean;
-  /** Hard upper bound on iterations, enforced by a guard. */
-  maxIterations: number;
+  /** Hard upper bound on machine turns (iterations), enforced by a guard. */
+  maxTurns: number;
 }
 /** Context of a {@link createLoopMachine} machine. */
 type LoopContext = {
@@ -252,7 +249,7 @@ type LoopContext = {
 };
 /**
  * A bounded repeat: run the body, check `until` over the accumulated state,
- * and either stop or go again. `maxIterations` is a guard, so the loop cannot
+ * and either stop or go again. `maxTurns` is a guard, so the loop cannot
  * run away even if `until` never returns `true`.
  *
  * States: `running` → `checking` → (`running` | `done`).
@@ -262,7 +259,7 @@ type LoopContext = {
  *   model: "quick",
  *   body: { instructions: "Improve the draft. Return only the draft." },
  *   until: ({ last }) => String(last).length > 500,
- *   maxIterations: 4,
+ *   maxTurns: 4,
  * });
  * ```
  */

package/dist/machines.mjs

@@ -1,4 +1,4 @@
-import { r as setupAgent } from "./setup-agent-BrE2zFDy.mjs";
+import { r as setupAgent } from "./setup-agent-BOcSpsIq.mjs";
 //#region src/machines/internal.ts
 /** The builtin inline text request every preset lowers a request entry to. */
 const GENERATE_TEXT_SRC = "agent.generateText";
@@ -68,7 +68,7 @@ function requestInput(name, entry, defaultModel, prompt) {
 		prompt,
 		...entry.tools ? { tools: entry.tools } : {},
 		...entry.outputSchema ? { outputSchema: entry.outputSchema } : {},
-		...entry.maxTurns !== void 0 ? { metadata: { maxSteps: entry.maxTurns } } : {}
+		...entry.maxSteps !== void 0 ? { maxSteps: entry.maxSteps } : {}
 	};
 }
 /**
@@ -99,7 +99,7 @@ const inputSchema$6 = objectSchema({ prompt: jsonString }, ["prompt"]);
 const outputSchema$5 = objectSchema({ result: jsonAny }, ["result"]);
 /**
 * The single-state tool loop: one text request carries the `tools`, and the
-* host runs the tool loop inside it (`maxTurns` bounds it). Selecting and
+* host runs the tool loop inside it (`maxSteps` bounds it). Selecting and
 * executing tools is the model + host's business, not machine states.
 *
 * States: `answering` → `done`.
@@ -109,7 +109,7 @@ const outputSchema$5 = objectSchema({ result: jsonAny }, ["result"]);
 *   model: "quick",
 *   instructions: "Answer using the tools.",
 *   tools: { calculate },
-*   maxTurns: 5,
+*   maxSteps: 5,
 * });
 *
 * const result = await runAgent(machine, {
@@ -120,11 +120,7 @@ const outputSchema$5 = objectSchema({ result: jsonAny }, ["result"]);
 * ```
 */
 function createToolLoopMachine(config) {
-	const { model, instructions, tools, outputSchema: resultSchema, maxTurns, interruptOn } = config;
-	const metadata = {
-		...maxTurns !== void 0 ? { maxSteps: maxTurns } : {},
-		...interruptOn && interruptOn.length > 0 ? { interruptOn: [...interruptOn] } : {}
-	};
+	const { model, instructions, tools, outputSchema: resultSchema, maxSteps } = config;
 	return setupAgent({
 		context: contextSchema$6,
 		input: inputSchema$6,
@@ -148,7 +144,7 @@ function createToolLoopMachine(config) {
 					prompt: context.prompt,
 					...tools ? { tools } : {},
 					...resultSchema ? { outputSchema: resultSchema } : {},
-					...Object.keys(metadata).length > 0 ? { metadata } : {}
+					...maxSteps !== void 0 ? { maxSteps } : {}
 				}),
 				onDone: ({ output }) => ({
 					target: "done",
@@ -211,7 +207,7 @@ function createSequentialMachine(config) {
 				model: step.model,
 				outputSchema: step.outputSchema,
 				tools: step.tools,
-				maxTurns: step.maxTurns
+				maxSteps: step.maxSteps
 			}, model, step.prompt ? step.prompt({
 				prompt: context.prompt,
 				results: context.results,
@@ -447,7 +443,7 @@ const outputSchema$1 = objectSchema({
 }, ["iterations", "results"]);
 /**
 * A bounded repeat: run the body, check `until` over the accumulated state,
-* and either stop or go again. `maxIterations` is a guard, so the loop cannot
+* and either stop or go again. `maxTurns` is a guard, so the loop cannot
 * run away even if `until` never returns `true`.
 *
 * States: `running` → `checking` → (`running` | `done`).
@@ -457,13 +453,13 @@ const outputSchema$1 = objectSchema({
 *   model: "quick",
 *   body: { instructions: "Improve the draft. Return only the draft." },
 *   until: ({ last }) => String(last).length > 500,
-*   maxIterations: 4,
+*   maxTurns: 4,
 * });
 * ```
 */
 function createLoopMachine(config) {
-	const { model, body, until, maxIterations } = config;
-	if (!Number.isInteger(maxIterations) || maxIterations < 1) throw new Error("createLoopMachine: maxIterations must be an integer >= 1.");
+	const { model, body, until, maxTurns } = config;
+	if (!Number.isInteger(maxTurns) || maxTurns < 1) throw new Error("createLoopMachine: maxTurns must be an integer >= 1.");
 	const agentSetup = setupAgent({
 		context: contextSchema$2,
 		input: inputSchema$2,
@@ -502,7 +498,7 @@ function createLoopMachine(config) {
 			} },
 			checking: {
 				type: "choice",
-				choice: ({ context }) => context.iterations >= maxIterations || until(loopState(context)) ? { target: "done" } : { target: "running" }
+				choice: ({ context }) => context.iterations >= maxTurns || until(loopState(context)) ? { target: "done" } : { target: "running" }
 			},
 			done: {
 				type: "final",
@@ -699,7 +695,7 @@ function createHandoffMachine(config) {
 		input: inputSchema,
 		events: Object.fromEntries(names.map((name) => [transferEventType(name), transferPayload])),
 		actors: machineActors(agents),
-		isSuspended: (snapshot) => snapshot.matches("waiting")
+		isIdle: (snapshot) => snapshot.matches("waiting")
 	});
 	const turnState = (name) => `${name}Turn`;
 	const states = {

package/dist/otel.cjs

@@ -1,4 +1,5 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+require("./validate.cjs");
 let _opentelemetry_api = require("@opentelemetry/api");
 //#region src/otel/index.ts
 /**

package/dist/otel.d.cts

@@ -1,4 +1,4 @@
-import { l as AgentTraceEvent } from "./run-agent-r9OD4z8F.cjs";
+import { d as AgentTraceEvent } from "./run-agent--4bbms-D.cjs";
 import { Attributes, Tracer, TracerProvider } from "@opentelemetry/api";
 
 //#region src/otel/index.d.ts

package/dist/otel.d.mts

@@ -1,4 +1,4 @@
-import { l as AgentTraceEvent } from "./run-agent-DQIDikfd.mjs";
+import { d as AgentTraceEvent } from "./run-agent-CwmzAZwj.mjs";
 import { Attributes, Tracer, TracerProvider } from "@opentelemetry/api";
 
 //#region src/otel/index.d.ts