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

package/dist/openai.cjs

@@ -1,5 +1,6 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
-const require_decision = require("./decision-Cv6SfNWl.cjs");
+const require_text_logic = require("./text-logic-C8xyr6Ag.cjs");
+const require_decision = require("./decision-CM9CYZ6t.cjs");
 //#region src/openai/index.ts
 /** Thrown for a message part Chat Completions cannot carry — dropping it would
 * silently change what the model sees. */
@@ -145,7 +146,7 @@ function toOpenAiTools(tools) {
 			function: {
 				name,
 				description: staticDescription(descriptor),
-				parameters: (require_decision.isStandardSchema(inputSchema) ? require_decision.getJsonSchemaSync(inputSchema) : void 0) ?? {}
+				parameters: (require_text_logic.isStandardSchema(inputSchema) ? require_text_logic.getJsonSchemaSync(inputSchema) : void 0) ?? {}
 			}
 		}];
 	});
@@ -171,7 +172,7 @@ function toOpenAiEventTools(events) {
 		function: {
 			name: event.toolName,
 			description: `Choose the '${event.type}' move.`,
-			parameters: require_decision.getJsonSchemaSync(event.inputSchema) ?? {}
+			parameters: require_text_logic.getJsonSchemaSync(event.inputSchema) ?? {}
 		}
 	}));
 }
@@ -233,7 +234,7 @@ function callSettings(options, request) {
 	return entry;
 }
 function truncated(request, info, partialOutput, cause) {
-	return new require_decision.AgentTruncatedError(`createOpenAiExecutors: request '${request.name ?? "(unnamed)"}' hit the output token limit — its structured output never completed. Raise \`maxOutputTokens\`, shorten the input, or ask for a smaller output schema.`, {
+	return new require_text_logic.AgentTruncatedError(`createOpenAiExecutors: request '${request.name ?? "(unnamed)"}' hit the output token limit — its structured output never completed. Raise \`maxOutputTokens\`, shorten the input, or ask for a smaller output schema.`, {
 		requestName: request.name ?? "(unnamed)",
 		...info?.requestId !== void 0 ? { requestId: info.requestId } : {},
 		...partialOutput !== void 0 ? { partialOutput } : {},
@@ -252,7 +253,7 @@ function usageField(usage) {
 function addAgentCallUsage(total, next) {
 	if (!total || !next) return total ?? next;
 	const sum = {};
-	for (const field of require_decision.AGENT_USAGE_TOKEN_FIELDS) if (total[field] !== void 0 || next[field] !== void 0) sum[field] = (total[field] ?? 0) + (next[field] ?? 0);
+	for (const field of require_text_logic.AGENT_USAGE_TOKEN_FIELDS) if (total[field] !== void 0 || next[field] !== void 0) sum[field] = (total[field] ?? 0) + (next[field] ?? 0);
 	return sum;
 }
 /**
@@ -276,7 +277,7 @@ function toToolContent(output) {
 * same shape, different SDK underneath.
 *
 * Structured output uses `response_format: { type: 'json_schema' }` around the
-* uniform `{ result, reasoning? }` envelope, and decisions force a tool call
+* `{ result, reasoning? }` provider output schema, and decisions force a tool call
 * with `tool_choice: 'required'`, one function tool per candidate event.
 *
 * @example
@@ -301,12 +302,12 @@ function createOpenAiExecutors(options) {
 			...extra
 		};
 	};
-	const envelopeSchema = async (request) => {
-		if (require_decision.getAgentOutputMode(request.outputSchema) !== "structured") return;
-		return require_decision.getJsonSchema(require_decision.buildEnvelopeSchema(request.outputSchema, { reasoning: request.includeReasoning }));
+	const structuredSchema = async (request) => {
+		if (require_text_logic.getAgentOutputMode(request.outputSchema) !== "structured") return;
+		return require_text_logic.getJsonSchema(require_text_logic.providerOutputSchema(request.outputSchema, { reasoning: request.includeReasoning }));
 	};
 	const generateText = async (request, info) => {
-		const jsonSchema = await envelopeSchema(request);
+		const jsonSchema = await structuredSchema(request);
 		const responseFormat = jsonSchema ? { response_format: {
 			type: "json_schema",
 			json_schema: {
@@ -349,7 +350,7 @@ function createOpenAiExecutors(options) {
 				});
 			}
 		}
-		const unwrap = (content) => require_decision.parseStructuredEnvelope(request, content ? JSON.parse(content) : void 0);
+		const unwrap = (content) => require_text_logic.parseProviderOutput(request, content ? JSON.parse(content) : void 0);
 		const choice = response.choices[0];
 		const finishReason = toAgentFinishReason(choice?.finish_reason);
 		const content = choice?.message.content;
@@ -357,7 +358,7 @@ function createOpenAiExecutors(options) {
 			if (finishReason === "length") throw truncated(request, info, content ?? void 0);
 			const parsed = unwrap(content);
 			return {
-				output: parsed.result,
+				result: parsed.result,
 				...typeof parsed.reasoning === "string" ? { reasoning: parsed.reasoning } : {},
 				...usageField(usage),
 				finishReason,
@@ -365,14 +366,14 @@ function createOpenAiExecutors(options) {
 			};
 		}
 		return {
-			output: content ?? "",
+			result: content ?? "",
 			...usageField(usage),
 			finishReason,
 			raw: response
 		};
 	};
 	const streamText = async (request, info) => {
-		if (require_decision.getAgentOutputMode(request.outputSchema) === "structured") throw new Error("createOpenAiExecutors: streamText is text-only — a request declaring a structured output schema must be routed to generateText.");
+		if (require_text_logic.getAgentOutputMode(request.outputSchema) === "structured") throw new Error("createOpenAiExecutors: streamText is text-only — a request declaring a structured output schema must be routed to generateText.");
 		if (Object.keys(request.tools ?? {}).length > 0) throw new Error("createOpenAiExecutors: streamText is text-only — a request declaring tools must be routed to generateText.");
 		const stream = await client.chat.completions.create({
 			model: resolveModel(request.model),
@@ -398,7 +399,7 @@ function createOpenAiExecutors(options) {
 			if (chunk.usage) usage = chunk.usage;
 		}
 		return {
-			output: text,
+			result: text,
 			...usageField(toAgentCallUsage(usage)),
 			finishReason,
 			raw: last

package/dist/openai.d.cts

@@ -1,5 +1,5 @@
-import { i as AgentToolChoice, n as AgentMessage, s as AgentTools, u as ChosenEvent } from "./types-CjHk5OdH.cjs";
-import { F as AgentDecisionRequest, K as AgentEventDescriptor, c as AgentRequestExecutorInfo, f as AgentTextRequest, r as AgentFinishReason, t as AgentCallUsage } from "./text-logic-C7bSnH_B.cjs";
+import { i as AgentToolChoice, n as AgentMessage, s as AgentTools, u as ChosenEvent } from "./types-B1Qs2q3q.cjs";
+import { M as AgentDecisionRequest, U as AgentEventDescriptor, c as AgentRequestExecutorInfo, f as AgentTextRequest, r as AgentFinishReason, t as AgentCallUsage } from "./text-logic-BFEOxyxv.cjs";
 import OpenAI from "openai";
 import { ChatCompletion, ChatCompletionCreateParamsNonStreaming, ChatCompletionMessageParam, ChatCompletionTool } from "openai/resources/chat/completions/completions.js";
 
@@ -104,13 +104,13 @@ type CreateOpenAiExecutorsOptions = {
   settings?: Record<string, OpenAiCallSettings> | ((request: AgentTextRequest | AgentDecisionRequest) => OpenAiCallSettings | undefined);
 };
 /**
- * Raw result shape from {@link OpenAiExecutors.generateText} — the `{ output }`
- * envelope (the validated structured object for structured-output requests, or
- * the model's text otherwise) plus the call metadata. Core only reads `output`; everything else flows
- * verbatim to `runAgent`'s `onResult(request, { raw })`.
+ * Raw result shape from {@link OpenAiExecutors.generateText} — `result` (the
+ * validated structured object for structured-output requests, or the model's
+ * text otherwise) plus the call metadata. Core reads `result` and `usage`;
+ * everything else flows verbatim to `runAgent`'s `onResult(request, { raw })`.
  */
 type OpenAiGenerateResult = {
-  output: unknown;
+  result: unknown;
   /** The model's reasoning, present only when the request opted in via
    * `includeReasoning` and the model produced it. Never enters machine
    * context/output. */
@@ -123,7 +123,7 @@ type OpenAiGenerateResult = {
 };
 /** Raw result shape from {@link OpenAiExecutors.streamText} — the accumulated text once the stream finishes (chunks are delivered separately via `onChunk`), plus the stream's final usage/finish metadata. */
 type OpenAiStreamResult = {
-  output: string; /** Present when the stream carried a usage chunk (the adapter asks for one via `stream_options`). */
+  result: string; /** Present when the stream carried a usage chunk (the adapter asks for one via `stream_options`). */
   usage?: AgentCallUsage;
   finishReason: AgentFinishReason; /** The last chunk seen, which carries the stream's finish metadata. */
   raw: unknown;
@@ -160,7 +160,7 @@ declare function addAgentCallUsage(total: AgentCallUsage | undefined, next: Agen
  * same shape, different SDK underneath.
  *
  * Structured output uses `response_format: { type: 'json_schema' }` around the
- * uniform `{ result, reasoning? }` envelope, and decisions force a tool call
+ * `{ result, reasoning? }` provider output schema, and decisions force a tool call
  * with `tool_choice: 'required'`, one function tool per candidate event.
  *
  * @example

package/dist/openai.d.mts

@@ -1,5 +1,5 @@
-import { i as AgentToolChoice, n as AgentMessage, s as AgentTools, u as ChosenEvent } from "./types-DWA6X9R-.mjs";
-import { F as AgentDecisionRequest, K as AgentEventDescriptor, c as AgentRequestExecutorInfo, f as AgentTextRequest, r as AgentFinishReason, t as AgentCallUsage } from "./text-logic-DJBK3LbG.mjs";
+import { i as AgentToolChoice, n as AgentMessage, s as AgentTools, u as ChosenEvent } from "./types-tA3SdczG.mjs";
+import { M as AgentDecisionRequest, U as AgentEventDescriptor, c as AgentRequestExecutorInfo, f as AgentTextRequest, r as AgentFinishReason, t as AgentCallUsage } from "./text-logic-hZSiRUo1.mjs";
 import OpenAI from "openai";
 import { ChatCompletion, ChatCompletionCreateParamsNonStreaming, ChatCompletionMessageParam, ChatCompletionTool } from "openai/resources/chat/completions/completions.js";
 
@@ -104,13 +104,13 @@ type CreateOpenAiExecutorsOptions = {
   settings?: Record<string, OpenAiCallSettings> | ((request: AgentTextRequest | AgentDecisionRequest) => OpenAiCallSettings | undefined);
 };
 /**
- * Raw result shape from {@link OpenAiExecutors.generateText} — the `{ output }`
- * envelope (the validated structured object for structured-output requests, or
- * the model's text otherwise) plus the call metadata. Core only reads `output`; everything else flows
- * verbatim to `runAgent`'s `onResult(request, { raw })`.
+ * Raw result shape from {@link OpenAiExecutors.generateText} — `result` (the
+ * validated structured object for structured-output requests, or the model's
+ * text otherwise) plus the call metadata. Core reads `result` and `usage`;
+ * everything else flows verbatim to `runAgent`'s `onResult(request, { raw })`.
  */
 type OpenAiGenerateResult = {
-  output: unknown;
+  result: unknown;
   /** The model's reasoning, present only when the request opted in via
    * `includeReasoning` and the model produced it. Never enters machine
    * context/output. */
@@ -123,7 +123,7 @@ type OpenAiGenerateResult = {
 };
 /** Raw result shape from {@link OpenAiExecutors.streamText} — the accumulated text once the stream finishes (chunks are delivered separately via `onChunk`), plus the stream's final usage/finish metadata. */
 type OpenAiStreamResult = {
-  output: string; /** Present when the stream carried a usage chunk (the adapter asks for one via `stream_options`). */
+  result: string; /** Present when the stream carried a usage chunk (the adapter asks for one via `stream_options`). */
   usage?: AgentCallUsage;
   finishReason: AgentFinishReason; /** The last chunk seen, which carries the stream's finish metadata. */
   raw: unknown;
@@ -160,7 +160,7 @@ declare function addAgentCallUsage(total: AgentCallUsage | undefined, next: Agen
  * same shape, different SDK underneath.
  *
  * Structured output uses `response_format: { type: 'json_schema' }` around the
- * uniform `{ result, reasoning? }` envelope, and decisions force a tool call
+ * `{ result, reasoning? }` provider output schema, and decisions force a tool call
  * with `tool_choice: 'required'`, one function tool per candidate event.
  *
  * @example

package/dist/openai.mjs

@@ -1,4 +1,5 @@
-import { S as getAgentOutputMode, U as getJsonSchema, W as getJsonSchemaSync, Y as isStandardSchema, f as AGENT_USAGE_TOKEN_FIELDS, k as parseStructuredEnvelope, o as renderDecisionAttempts, st as AgentTruncatedError, v as buildEnvelopeSchema } from "./decision-BBZ2jMO1.mjs";
+import { A as getJsonSchema, I as isStandardSchema, U as AgentTruncatedError, g as providerOutputSchema, h as parseProviderOutput, j as getJsonSchemaSync, l as getAgentOutputMode, t as AGENT_USAGE_TOKEN_FIELDS } from "./text-logic-Bl_ZRxDi.mjs";
+import { o as renderDecisionAttempts } from "./decision-DzSv1NpD.mjs";
 //#region src/openai/index.ts
 /** Thrown for a message part Chat Completions cannot carry — dropping it would
 * silently change what the model sees. */
@@ -275,7 +276,7 @@ function toToolContent(output) {
 * same shape, different SDK underneath.
 *
 * Structured output uses `response_format: { type: 'json_schema' }` around the
-* uniform `{ result, reasoning? }` envelope, and decisions force a tool call
+* `{ result, reasoning? }` provider output schema, and decisions force a tool call
 * with `tool_choice: 'required'`, one function tool per candidate event.
 *
 * @example
@@ -300,12 +301,12 @@ function createOpenAiExecutors(options) {
 			...extra
 		};
 	};
-	const envelopeSchema = async (request) => {
+	const structuredSchema = async (request) => {
 		if (getAgentOutputMode(request.outputSchema) !== "structured") return;
-		return getJsonSchema(buildEnvelopeSchema(request.outputSchema, { reasoning: request.includeReasoning }));
+		return getJsonSchema(providerOutputSchema(request.outputSchema, { reasoning: request.includeReasoning }));
 	};
 	const generateText = async (request, info) => {
-		const jsonSchema = await envelopeSchema(request);
+		const jsonSchema = await structuredSchema(request);
 		const responseFormat = jsonSchema ? { response_format: {
 			type: "json_schema",
 			json_schema: {
@@ -348,7 +349,7 @@ function createOpenAiExecutors(options) {
 				});
 			}
 		}
-		const unwrap = (content) => parseStructuredEnvelope(request, content ? JSON.parse(content) : void 0);
+		const unwrap = (content) => parseProviderOutput(request, content ? JSON.parse(content) : void 0);
 		const choice = response.choices[0];
 		const finishReason = toAgentFinishReason(choice?.finish_reason);
 		const content = choice?.message.content;
@@ -356,7 +357,7 @@ function createOpenAiExecutors(options) {
 			if (finishReason === "length") throw truncated(request, info, content ?? void 0);
 			const parsed = unwrap(content);
 			return {
-				output: parsed.result,
+				result: parsed.result,
 				...typeof parsed.reasoning === "string" ? { reasoning: parsed.reasoning } : {},
 				...usageField(usage),
 				finishReason,
@@ -364,7 +365,7 @@ function createOpenAiExecutors(options) {
 			};
 		}
 		return {
-			output: content ?? "",
+			result: content ?? "",
 			...usageField(usage),
 			finishReason,
 			raw: response
@@ -397,7 +398,7 @@ function createOpenAiExecutors(options) {
 			if (chunk.usage) usage = chunk.usage;
 		}
 		return {
-			output: text,
+			result: text,
 			...usageField(toAgentCallUsage(usage)),
 			finishReason,
 			raw: last

package/dist/otel.d.cts

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

package/dist/otel.d.mts

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