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

package/dist/{text-logic-Er5KkTX6.d.mts → text-logic-BR5twXCv.d.mts}

@@ -1,4 +1,4 @@
-import { a as AgentToolChoice, c as AgentTools, d as ChosenEvent, g as InferOutput, l as AllowedEvents, n as AgentMessage, v as StandardSchemaV1 } from "./types-DYpK3QF4.mjs";
+import { a as AgentToolChoice, c as AgentTools, d as ChosenEvent, g as InferOutput, l as AllowedEvents, n as AgentMessage, v as StandardSchemaV1 } from "./types-CvWRGFxP.mjs";
 import { t as AgentError } from "./errors-C9rxnWbX.mjs";
 import { AnyMachineSnapshot, AsyncActorLogic, EventObject, MachineSnapshot } from "xstate";
 
@@ -342,8 +342,11 @@ interface AgentTextRequest<TMetadata = Record<string, unknown>> {
    * structured-output envelope schema, nudging the model to reason before
    * committing to the result. The reasoning is surfaced on the executor's raw
    * result (never in machine context/output). Ignored for text-mode requests.
+   *
+   * Not a provider setting: reasoning EFFORT belongs to the host, which owns
+   * how hard a model thinks. See `createAiSdkExecutors({ settings })`.
    */
-  reasoning?: boolean;
+  includeReasoning?: boolean;
   temperature?: number;
   /**
    * Maximum number of output tokens to generate. Named `maxOutputTokens` (not
@@ -479,8 +482,8 @@ interface TextLogicConfig<TInputSchema extends StandardSchemaV1 = StandardSchema
   messages?: ResolveTextLogicValue<AgentMessage[] | undefined, InferOutput<TInputSchema>>;
   tools?: ResolveTextLogicValue<AgentTools | undefined, InferOutput<TInputSchema>>;
   toolChoice?: ResolveTextLogicValue<AgentToolChoice | undefined, InferOutput<TInputSchema>>;
-  /** Opt into the structured-output envelope's `reasoning` field (see {@link AgentTextRequest.reasoning}). */
-  reasoning?: ResolveTextLogicValue<boolean | undefined, InferOutput<TInputSchema>>;
+  /** Opt into the structured-output envelope's `reasoning` field (see {@link AgentTextRequest.includeReasoning}). */
+  includeReasoning?: ResolveTextLogicValue<boolean | undefined, InferOutput<TInputSchema>>;
   temperature?: ResolveTextLogicValue<number | undefined, InferOutput<TInputSchema>>;
   maxOutputTokens?: ResolveTextLogicValue<number | undefined, InferOutput<TInputSchema>>;
   topP?: ResolveTextLogicValue<number | undefined, InferOutput<TInputSchema>>;
@@ -739,6 +742,6 @@ declare function buildEnvelopeSchema(inner: StandardSchemaV1, options?: {
  * 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;
+declare function parseStructuredEnvelope(request: Pick<AgentTextRequest, "outputSchema" | "includeReasoning">, value: unknown): StructuredOutputEnvelope;
 //#endregion
 export { AgentDecisionExecutor as A, AgentEventToolNameResolver as B, buildEnvelopeSchema as C, parseModelRef as D, getCallUsage as E, DecisionLogicConfig as F, parseAgentEvent as G, AgentRequestSource as H, ResolveDecisionOptions as I, renderDecisionAttempts as L, AgentDecisionInput as M, AgentDecisionRequest as N, parseOutput as O, DecisionAttempt as P, resolveDecision as R, bindRequestExecutor as S, getAgentOutputMode as T, AgentSchemas as U, AgentRequestOptions as V, getAcceptedEvents as W, StructuredOutputEnvelope as _, AgentOutputMode as a, TextLogicExecuteArgs as b, AgentRequestExecutorResult as c, AgentTextRequest as d, AgentUsage as f, BuiltinAgentActors as g, AiSdkShapedTextResult as h, AgentModelRef as i, AgentDecisionExhaustedError as j, parseStructuredEnvelope as k, AgentRequestExecutors as l, AiSdkShapedStreamResult as m, AgentExecutorTextRequest as n, AgentRequestExecutor as o, AgentUserInput as p, AgentModelMap as r, AgentRequestExecutorInfo as s, AgentCallUsage as t, AgentRequestMode as u, TextLogic as v, createTextLogic as w, TextLogicExecutor as x, TextLogicConfig as y, AgentEventDescriptor as z };

package/dist/{text-logic-Cavva1W6.d.cts → text-logic-Mmbgb2jy.d.cts}

@@ -1,4 +1,4 @@
-import { a as AgentToolChoice, c as AgentTools, d as ChosenEvent, g as InferOutput, l as AllowedEvents, n as AgentMessage, v as StandardSchemaV1 } from "./types-pJ5Hn8fv.cjs";
+import { a as AgentToolChoice, c as AgentTools, d as ChosenEvent, g as InferOutput, l as AllowedEvents, n as AgentMessage, v as StandardSchemaV1 } from "./types-DSdj2tGs.cjs";
 import { t as AgentError } from "./errors-BQRk9eiZ.cjs";
 import { AnyMachineSnapshot, AsyncActorLogic, EventObject, MachineSnapshot } from "xstate";
 
@@ -342,8 +342,11 @@ interface AgentTextRequest<TMetadata = Record<string, unknown>> {
    * structured-output envelope schema, nudging the model to reason before
    * committing to the result. The reasoning is surfaced on the executor's raw
    * result (never in machine context/output). Ignored for text-mode requests.
+   *
+   * Not a provider setting: reasoning EFFORT belongs to the host, which owns
+   * how hard a model thinks. See `createAiSdkExecutors({ settings })`.
    */
-  reasoning?: boolean;
+  includeReasoning?: boolean;
   temperature?: number;
   /**
    * Maximum number of output tokens to generate. Named `maxOutputTokens` (not
@@ -479,8 +482,8 @@ interface TextLogicConfig<TInputSchema extends StandardSchemaV1 = StandardSchema
   messages?: ResolveTextLogicValue<AgentMessage[] | undefined, InferOutput<TInputSchema>>;
   tools?: ResolveTextLogicValue<AgentTools | undefined, InferOutput<TInputSchema>>;
   toolChoice?: ResolveTextLogicValue<AgentToolChoice | undefined, InferOutput<TInputSchema>>;
-  /** Opt into the structured-output envelope's `reasoning` field (see {@link AgentTextRequest.reasoning}). */
-  reasoning?: ResolveTextLogicValue<boolean | undefined, InferOutput<TInputSchema>>;
+  /** Opt into the structured-output envelope's `reasoning` field (see {@link AgentTextRequest.includeReasoning}). */
+  includeReasoning?: ResolveTextLogicValue<boolean | undefined, InferOutput<TInputSchema>>;
   temperature?: ResolveTextLogicValue<number | undefined, InferOutput<TInputSchema>>;
   maxOutputTokens?: ResolveTextLogicValue<number | undefined, InferOutput<TInputSchema>>;
   topP?: ResolveTextLogicValue<number | undefined, InferOutput<TInputSchema>>;
@@ -739,6 +742,6 @@ declare function buildEnvelopeSchema(inner: StandardSchemaV1, options?: {
  * 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;
+declare function parseStructuredEnvelope(request: Pick<AgentTextRequest, "outputSchema" | "includeReasoning">, value: unknown): StructuredOutputEnvelope;
 //#endregion
 export { AgentDecisionExecutor as A, AgentEventToolNameResolver as B, buildEnvelopeSchema as C, parseModelRef as D, getCallUsage as E, DecisionLogicConfig as F, parseAgentEvent as G, AgentRequestSource as H, ResolveDecisionOptions as I, renderDecisionAttempts as L, AgentDecisionInput as M, AgentDecisionRequest as N, parseOutput as O, DecisionAttempt as P, resolveDecision as R, bindRequestExecutor as S, getAgentOutputMode as T, AgentSchemas as U, AgentRequestOptions as V, getAcceptedEvents as W, StructuredOutputEnvelope as _, AgentOutputMode as a, TextLogicExecuteArgs as b, AgentRequestExecutorResult as c, AgentTextRequest as d, AgentUsage as f, BuiltinAgentActors as g, AiSdkShapedTextResult as h, AgentModelRef as i, AgentDecisionExhaustedError as j, parseStructuredEnvelope as k, AgentRequestExecutors as l, AiSdkShapedStreamResult as m, AgentExecutorTextRequest as n, AgentRequestExecutor as o, AgentUserInput as p, AgentModelMap as r, AgentRequestExecutorInfo as s, AgentCallUsage as t, AgentRequestMode as u, TextLogic as v, createTextLogic as w, TextLogicExecutor as x, TextLogicConfig as y, AgentEventDescriptor as z };

package/dist/{types-DYpK3QF4.d.mts → types-CvWRGFxP.d.mts}

@@ -203,7 +203,12 @@ type AgentToolSchema = object;
  * SDK you built the tool with owns its precise input typing.
  */
 interface AgentToolDescriptor {
-  description?: string;
+  /**
+   * Text shown to the model. Typed loosely enough to accept an SDK tool whose
+   * description is computed per call (the AI SDK v7 `tool({ description })`
+   * accepts a function of the call's context); core never reads it.
+   */
+  description?: string | ((...args: any[]) => string);
   inputSchema?: AgentToolSchema;
   outputSchema?: AgentToolSchema;
   execute?: (...args: any[]) => unknown;

package/dist/{types-pJ5Hn8fv.d.cts → types-DSdj2tGs.d.cts}

@@ -203,7 +203,12 @@ type AgentToolSchema = object;
  * SDK you built the tool with owns its precise input typing.
  */
 interface AgentToolDescriptor {
-  description?: string;
+  /**
+   * Text shown to the model. Typed loosely enough to accept an SDK tool whose
+   * description is computed per call (the AI SDK v7 `tool({ description })`
+   * accepts a function of the call's context); core never reads it.
+   */
+  description?: string | ((...args: any[]) => string);
   inputSchema?: AgentToolSchema;
   outputSchema?: AgentToolSchema;
   execute?: (...args: any[]) => unknown;

package/dist/validate.cjs

@@ -22,7 +22,7 @@ var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__ge
 }) : target, mod));
 //#endregion
 let ajv_dist_2020_js = require("ajv/dist/2020.js");
-ajv_dist_2020_js = __toESM(ajv_dist_2020_js);
+ajv_dist_2020_js = __toESM(ajv_dist_2020_js, 1);
 //#region schemas/agent-workflow.json
 var agent_workflow_default = {
 	$schema: "https://json-schema.org/draft/2020-12/schema",
@@ -221,7 +221,7 @@ var agent_workflow_default = {
 						"additionalProperties": false
 					}]
 				},
-				"reasoning": {
+				"includeReasoning": {
 					"description": "Opt into the structured-output envelope's `reasoning` field.",
 					"type": "boolean"
 				},

package/dist/validate.mjs

@@ -197,7 +197,7 @@ var agent_workflow_default = {
 						"additionalProperties": false
 					}]
 				},
-				"reasoning": {
+				"includeReasoning": {
 					"description": "Opt into the structured-output envelope's `reasoning` field.",
 					"type": "boolean"
 				},

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@statelyai/agent",
-  "version": "2.0.0-alpha.20",
+  "version": "2.0.0-alpha.21",
   "description": "Make invalid agent actions impossible. Agent logic as state machines: deterministic, inspectable, resumable, runs anywhere.",
   "keywords": [
     "agent",
@@ -94,51 +94,51 @@
     "access": "public"
   },
   "devDependencies": {
-    "@ai-sdk/openai": "^3.0.25",
-    "@anthropic-ai/sdk": "^0.109.1",
-    "@changesets/changelog-github": "^0.5.0",
-    "@changesets/cli": "^2.27.9",
+    "@ai-sdk/openai": "^4.0.0",
+    "@anthropic-ai/sdk": "^0.120.0",
+    "@changesets/changelog-github": "^0.5.2",
+    "@changesets/cli": "^2.31.1",
     "@earendil-works/pi-ai": "0.83.0",
-    "@flue/runtime": "2.0.0",
-    "@inquirer/prompts": "^8.5.2",
-    "@langchain/core": "^1.2.4",
-    "@langchain/openai": "^1.5.5",
-    "@mastra/core": "^1.54.0",
+    "@flue/runtime": "2.0.3",
+    "@inquirer/prompts": "^8.6.0",
+    "@langchain/core": "^1.2.9",
+    "@langchain/openai": "^1.5.10",
+    "@mastra/core": "^1.61.0",
     "@opentelemetry/api": "^1.9.1",
     "@opentelemetry/context-async-hooks": "^2.10.0",
     "@opentelemetry/exporter-trace-otlp-http": "^0.221.0",
     "@opentelemetry/sdk-trace-base": "^2.10.0",
     "@opentelemetry/sdk-trace-node": "^2.10.0",
-    "@statelyai/sdk": "^0.16.2",
+    "@statelyai/sdk": "^0.22.1",
     "@types/express": "^5.0.6",
-    "@types/node": "^20.16.10",
-    "@types/react": "^19.2.17",
-    "ai": "^6.0.67",
+    "@types/node": "^20.19.43",
+    "@types/react": "^19.2.18",
+    "ai": "^7.0.0",
     "ajv": "^8.20.0",
-    "braintrust": "^3.25.0",
-    "dotenv": "^16.4.5",
+    "braintrust": "^3.28.0",
+    "dotenv": "^16.6.1",
     "express": "^5.2.1",
-    "hono": "^4.12.30",
+    "hono": "^4.13.3",
     "knip": "6.24.0",
-    "langchain": "^1.5.4",
-    "openai": "^6.45.0",
+    "langchain": "^1.5.10",
+    "openai": "^7.5.0",
     "oxfmt": "0.57.0",
     "oxlint": "1.72.0",
-    "react": "^19.2.7",
-    "tsdown": "^0.21.7",
-    "tsx": "^4.21.0",
+    "react": "^19.2.8",
+    "tsdown": "^0.21.10",
+    "tsx": "^4.23.12",
     "twoslash": "^0.3.9",
-    "typescript": "^5.6.2",
+    "typescript": "^5.9.3",
     "valibot": "^1.4.2",
-    "vitest": "^3.2.6",
-    "xstate": "6.0.0-alpha.41",
-    "zod": "^4.3.6"
+    "vitest": "^4.1.11",
+    "xstate": "6.0.0-alpha.48",
+    "zod": "^4.4.3"
   },
   "peerDependencies": {
     "@opentelemetry/api": "^1",
-    "ai": "^6.0.67",
+    "ai": "^7.0.0",
     "ajv": "^8.20.0",
-    "xstate": ">=6.0.0-alpha.41 <6.0.0"
+    "xstate": ">=6.0.0-alpha.46 <6.0.0"
   },
   "peerDependenciesMeta": {
     "@opentelemetry/api": {

package/readme.md

@@ -12,7 +12,7 @@ Stately Agent adds model requests and decisions to XState:
 
 Stately Agent 2 is in alpha. APIs may change before the stable release.
 
-[Documentation](https://stately.ai/docs/agents) · [Examples](examples/README.md) · [XState](https://github.com/statelyai/xstate)
+[Documentation](https://stately.ai/docs/packages/agent) · [Examples](examples/README.md) · [XState](https://github.com/statelyai/xstate)
 
 ## Three starting points
 
@@ -25,14 +25,14 @@ Stately Agent 2 is in alpha. APIs may change before the stable release.
 <!-- install command matching the package prerelease channel and package.json peers -->
 
 ```sh
-pnpm add @statelyai/agent@alpha xstate@alpha zod ai@^6 @ai-sdk/openai@^3
+pnpm add @statelyai/agent@alpha xstate@alpha zod ai@^7 @ai-sdk/openai@^4
 ```
 
 Requirements:
 
-- Node 22.18 or newer, and XState v6 alpha.25 or newer.
+- Node 22.18 or newer, and XState v6 alpha.46 or newer.
 - The package is ESM-first. CommonJS builds are published too, so `require()` works.
-- Provider packages must match your `ai` major: `@ai-sdk/openai@^3` pairs with `ai@^6`. A bare `@ai-sdk/openai` resolves to `@latest`, which can mismatch the `ai` peer.
+- Provider packages must match your `ai` major: `@ai-sdk/openai@^4` pairs with `ai@^7`. A bare `@ai-sdk/openai` resolves to `@latest`, which can mismatch the `ai` peer.
 
 ## Quick start
 

package/schemas/agent-workflow.json

@@ -273,7 +273,7 @@
             }
           ]
         },
-        "reasoning": {
+        "includeReasoning": {
           "description": "Opt into the structured-output envelope's `reasoning` field.",
           "type": "boolean"
         },