@superdurable/dex-agents 0.0.0-stage → 0.2.0

package/dist/src/stepwise/json-schema-validation.js

@@ -0,0 +1,141 @@
+// Copyright (c) 2026 Super Durable, Inc.
+//
+// Licensed under the Sustainable Use License 1.0.
+// You may not use this file except in compliance with the License.
+// See the LICENSE file in the repository root.
+//
+// SPDX-License-Identifier: LicenseRef-Sustainable-Use-1.0
+/** Returns the first way `value` breaks the schema, such as `arguments.order_id must be string`, or `undefined`. */
+export function findJsonSchemaViolation(value, schema, path) {
+    const anyOf = schema["anyOf"];
+    const isNoAnyOfOptionMatched = Array.isArray(anyOf) &&
+        anyOf.every((option) => findJsonSchemaViolation(value, option, path) !== undefined);
+    if (isNoAnyOfOptionMatched) {
+        return `${path} matches none of the allowed types`;
+    }
+    const expected = schema["type"];
+    if (expected !== undefined) {
+        const expectedTypes = (typeof expected === "string" ? [expected] : expected).map(String);
+        if (!expectedTypes.some((type) => matchesJsonType(type, value))) {
+            return `${path} must be ${expectedTypes.join(" or ")}`;
+        }
+    }
+    const allowedValues = schema["enum"];
+    if (Array.isArray(allowedValues) && !allowedValues.some((allowed) => isPythonEqual(allowed, value))) {
+        return `${path} must be one of ${serializeJsonWithSpacedSeparators(allowedValues)}`;
+    }
+    if (typeof value === "object" && value !== null && !Array.isArray(value)) {
+        return findObjectViolation(value, schema, path);
+    }
+    const items = schema["items"];
+    if (Array.isArray(value) && typeof items === "object" && items !== null) {
+        for (const [index, item] of value.entries()) {
+            const violation = findJsonSchemaViolation(item, items, `${path}[${index}]`);
+            if (violation !== undefined) {
+                return violation;
+            }
+        }
+    }
+    if (typeof value === "number") {
+        if (typeof schema["minimum"] === "number" && value < schema["minimum"]) {
+            return `${path} must be at least ${schema["minimum"]}`;
+        }
+        if (typeof schema["maximum"] === "number" && value > schema["maximum"]) {
+            return `${path} must be at most ${schema["maximum"]}`;
+        }
+    }
+    return undefined;
+}
+/**
+ * Serializes JSON with `", "` and `": "` separators and unescaped non-ASCII text, the format of Python's
+ * `json.dumps`, so model-visible text matches the Python core.
+ */
+export function serializeJsonWithSpacedSeparators(value) {
+    if (Array.isArray(value)) {
+        return `[${value.map((item) => serializeJsonWithSpacedSeparators(item === undefined ? null : item)).join(", ")}]`;
+    }
+    if (typeof value === "object" && value !== null) {
+        const record = typeof value.toJSON === "function"
+            ? value.toJSON()
+            : value;
+        if (typeof record !== "object" || record === null) {
+            return serializeJsonWithSpacedSeparators(record);
+        }
+        const entries = Object.entries(record).filter(([, nestedValue]) => nestedValue !== undefined);
+        return `{${entries
+            .map(([key, nestedValue]) => `${JSON.stringify(key)}: ${serializeJsonWithSpacedSeparators(nestedValue)}`)
+            .join(", ")}}`;
+    }
+    const text = JSON.stringify(value);
+    if (text === undefined) {
+        throw new TypeError(`a ${typeof value} value cannot be serialized as JSON`);
+    }
+    return text;
+}
+function findObjectViolation(value, schema, path) {
+    const properties = (schema["properties"] ?? {});
+    for (const requiredName of (schema["required"] ?? [])) {
+        if (!Object.hasOwn(value, requiredName)) {
+            return `${path}.${requiredName} is required`;
+        }
+    }
+    const additionalProperties = schema["additionalProperties"] ?? true;
+    for (const [name, propertyValue] of Object.entries(value)) {
+        let violation;
+        if (Object.hasOwn(properties, name)) {
+            violation = findJsonSchemaViolation(propertyValue, properties[name] ?? {}, `${path}.${name}`);
+        }
+        else if (additionalProperties === false) {
+            violation = `${path}.${name} is not allowed`;
+        }
+        else if (typeof additionalProperties === "object" && additionalProperties !== null) {
+            violation = findJsonSchemaViolation(propertyValue, additionalProperties, `${path}.${name}`);
+        }
+        if (violation !== undefined) {
+            return violation;
+        }
+    }
+    return undefined;
+}
+/** Python's `==` over JSON values, which the Python core's `enum` check uses: `true == 1` and `1 == 1.0`. */
+function isPythonEqual(left, right) {
+    const isNumeric = (value) => typeof value === "number" || typeof value === "boolean";
+    if (isNumeric(left) || isNumeric(right)) {
+        return isNumeric(left) && isNumeric(right) && Number(left) === Number(right);
+    }
+    if (Array.isArray(left) || Array.isArray(right)) {
+        return (Array.isArray(left) &&
+            Array.isArray(right) &&
+            left.length === right.length &&
+            left.every((item, index) => isPythonEqual(item, right[index])));
+    }
+    if (typeof left === "object" && left !== null && typeof right === "object" && right !== null) {
+        const leftRecord = left;
+        const rightRecord = right;
+        const leftKeys = Object.keys(leftRecord);
+        return (leftKeys.length === Object.keys(rightRecord).length &&
+            leftKeys.every((key) => Object.hasOwn(rightRecord, key) && isPythonEqual(leftRecord[key], rightRecord[key])));
+    }
+    return left === right;
+}
+function matchesJsonType(type, value) {
+    switch (type) {
+        case "string":
+            return typeof value === "string";
+        case "boolean":
+            return typeof value === "boolean";
+        case "null":
+            return value === null;
+        case "array":
+            return Array.isArray(value);
+        case "object":
+            return typeof value === "object" && value !== null && !Array.isArray(value);
+        case "number":
+            return typeof value === "number";
+        case "integer":
+            return typeof value === "number" && Number.isInteger(value);
+        default:
+            throw new TypeError(`unsupported JSON Schema type ${type}`);
+    }
+}
+//# sourceMappingURL=json-schema-validation.js.map

package/dist/src/stepwise/json-schema-validation.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"json-schema-validation.js","sourceRoot":"","sources":["../../../src/stepwise/json-schema-validation.ts"],"names":[],"mappings":"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"}

package/dist/src/stepwise/model-client.d.ts

@@ -0,0 +1,194 @@
+import type { AgentUsage } from "../agent-session-values.js";
+/**
+ * User text in a model input, stored for a user message and for Dex notes such as the turn-failure note.
+ * Wire shape: `{"type":"user_text","text"}`.
+ */
+export interface ModelUserTextItem {
+    /** Discriminator. Wire field: `type`. */
+    readonly type: "user_text";
+    /** The text. Wire field: `text`. */
+    readonly text: string;
+}
+/** One tool call of a model response, in provider-neutral form. */
+export interface ModelToolCall {
+    /** Provider tool call ID. Wire field: `tool_call_id`. */
+    readonly toolCallId: string;
+    /** Tool name. Wire field: `tool_name`. */
+    readonly toolName: string;
+    /** Tool arguments as JSON text, exactly as the model produced them. Wire field: `arguments`. */
+    readonly arguments: string;
+}
+/**
+ * One output item exactly as a provider returned it, with provider-neutral projections.
+ *
+ * Wire shape: `{"type":"model_output","provider","api","item","text","tool_calls"}`. A client returns one
+ * item per provider output item, such as one AI SDK assistant message. {@link item} is the provider's
+ * JSON text, opaque to Dex, so its bytes survive storage: opaque fields such as thinking signatures and
+ * encrypted reasoning stay the exact strings the provider sent. A {@link ModelClient} replays the item
+ * unchanged when {@link provider} and {@link api} match its own. Otherwise it replays {@link text} and
+ * {@link toolCalls} and drops the rest, such as reasoning, so a session can change model between turns.
+ */
+export interface ModelOutputItem {
+    /** Discriminator. Wire field: `type`. */
+    readonly type: "model_output";
+    /** Provider that produced the item, such as `"openai.responses"`. Wire field: `provider`. */
+    readonly provider: string;
+    /** Provider API that produced the item, such as `"ai-sdk"`. Wire field: `api`. */
+    readonly api: string;
+    /** Provider JSON text of the item. Wire field: `item`. */
+    readonly item: string;
+    /** Visible text of the item, or `null` when it has none. Wire field: `text`. */
+    readonly text: string | null;
+    /** Tool calls the item asks for, in model order. Wire field: `tool_calls`. */
+    readonly toolCalls: readonly ModelToolCall[];
+}
+/**
+ * The result of one tool call in a model input, in provider-neutral form.
+ * Wire shape: `{"type":"tool_result","tool_call_id","tool_name","output"}`.
+ */
+export interface ModelToolResultItem {
+    /** Discriminator. Wire field: `type`. */
+    readonly type: "tool_result";
+    /** Tool call this result answers. Wire field: `tool_call_id`. */
+    readonly toolCallId: string;
+    /** Tool name. Wire field: `tool_name`. */
+    readonly toolName: string;
+    /** Model-visible result text, from `describeToolCallOutcome`. Wire field: `output`. */
+    readonly output: string;
+}
+/**
+ * One item of a model input. The Stepwise runner stores each one as the `framework_item` of an
+ * `AgentMessage`, as snake_case JSON.
+ */
+export type ModelInputItem = ModelUserTextItem | ModelOutputItem | ModelToolResultItem;
+/** Definition of one tool offered to the model. */
+export interface ModelToolDefinition {
+    /** Tool name. */
+    readonly name: string;
+    /** Tool description for the model. */
+    readonly description: string;
+    /** JSON Schema of the arguments, an object schema. */
+    readonly parameters: Readonly<Record<string, unknown>>;
+}
+/**
+ * How the model may use the offered tools: `auto` lets it choose, `none` forbids tool calls, `required`
+ * forces at least one, and `{ toolName }` forces that tool.
+ */
+export type ModelToolChoice = "auto" | "none" | "required" | {
+    readonly toolName: string;
+};
+/** Settings of every model call of an agent; a {@link ModelClient} passes them to its provider. */
+export interface ModelSettings {
+    /** Sampling temperature; the provider's default when omitted. */
+    readonly temperature?: number;
+    /** Maximum output tokens; the provider's default when omitted. */
+    readonly maxOutputTokens?: number;
+    /** Reasoning effort, such as `"low"` or `"high"`; the provider's default when omitted. */
+    readonly reasoningEffort?: string;
+    /** Provider-specific options by provider name, passed through unchanged. */
+    readonly providerOptions?: Readonly<Record<string, Readonly<Record<string, unknown>>>>;
+}
+/** Identifies the `RunModel` attempt that makes a model call. */
+export interface ModelRequestMetadata {
+    /** Flow ID, which is the session ID. */
+    readonly flowId: string;
+    /** Turn ID. */
+    readonly turnId: string;
+    /** Dex Step execution ID of the `RunModel` Step. */
+    readonly stepExecutionId: string;
+    /** One-based attempt of the `RunModel` Step. */
+    readonly attempt: number;
+}
+/** One model call, built by the Stepwise runner from committed session state only. */
+export interface ModelRequest {
+    /** System instructions for this call. */
+    readonly instructions: string;
+    /** The conversation, oldest first; every tool call is followed by its result. */
+    readonly inputItems: readonly ModelInputItem[];
+    /** Tools the model may call; empty when the call must answer. */
+    readonly tools: readonly ModelToolDefinition[];
+    /** How the model may use {@link tools}. */
+    readonly toolChoice: ModelToolChoice;
+    /** Settings from the agent definition. */
+    readonly settings: ModelSettings;
+    /** The `RunModel` attempt making the call. */
+    readonly metadata: ModelRequestMetadata;
+    /** Signal aborted when Dex cancels the attempt; pass it to the provider request. */
+    readonly cancellationSignal: AbortSignal;
+}
+/** Result of one model call. */
+export interface ModelResponse {
+    /** Provider-exact output items of the response; the session stores them in order. */
+    readonly outputItems: readonly ModelOutputItem[];
+    /** Visible text of the response, a display projection. */
+    readonly text: string;
+    /** Tool calls the model requested, in model order; empty for a final answer. */
+    readonly toolCalls: readonly ModelToolCall[];
+    /** Usage of this one call; `modelCalls` is 1. */
+    readonly usage: AgentUsage;
+    /** Model that answered, as the provider reported it. */
+    readonly responseModel: string;
+    /** Provider finish reason, such as `"stop"` or `"tool-calls"`. */
+    readonly finishReason: string;
+}
+/** Receives the live text of one model call; the Stepwise runner forwards it to `AgentEvents`. */
+export interface ModelOutputWriter {
+    /**
+     * Writes visible text as a `text_delta` event.
+     * @param text - Text chunk; empty chunks are ignored.
+     */
+    writeTextDelta(text: string): void;
+    /**
+     * Writes a provider-authored reasoning summary chunk as a `reasoning_delta` event.
+     * @param text - Text chunk; empty chunks are ignored.
+     */
+    writeReasoningDelta(text: string): void;
+}
+/**
+ * Makes one model call for the Stepwise runner.
+ *
+ * Use `createAiSdkModelClient` from `@superdurable/dex-agents/ai-sdk` for any AI SDK provider, or
+ * implement this interface for another model API. Every client follows these rules:
+ * - One request per call. The client makes no retries of its own; retries are `RunModel` attempts, so
+ *   each one is visible in the Flow history.
+ * - Dex owns the conversation. The client sends the whole input every time and uses no provider-side
+ *   conversation state, such as a previous response ID.
+ * - Provider-exact transcript. The client returns each output item as the provider returned it and
+ *   replays items of its own provider and API unchanged. It never rebuilds opaque fields, such as
+ *   thinking signatures or encrypted reasoning, from display text.
+ * - Dex-authored items, {@link ModelUserTextItem} and {@link ModelToolResultItem}, are converted at call
+ *   time. An item from another provider or API is replayed as its text and tool calls.
+ *
+ * @example
+ * ```ts
+ * const echoModel: ModelClient = {
+ *   async callModel(request, output) {
+ *     const text = `echo: ${request.inputItems.length} items`;
+ *     output.writeTextDelta(text);
+ *     return {
+ *       outputItems: [{ type: "model_output", provider: "echo", api: "echo", item: JSON.stringify({ text }),
+ *         text, toolCalls: [] }],
+ *       text, toolCalls: [], responseModel: "echo-1", finishReason: "stop",
+ *       usage: { modelCalls: 1, inputTokens: 0, outputTokens: 0, cachedInputTokens: 0, reasoningTokens: 0 },
+ *     };
+ *   },
+ *   estimateInputTokens: (request) => JSON.stringify(request.inputItems).length / 4,
+ * };
+ * ```
+ */
+export interface ModelClient {
+    /**
+     * Makes exactly one model call and streams its text to `output`.
+     * @param request - The call; see {@link ModelRequest}.
+     * @param output - Receives text and reasoning deltas while the call streams.
+     * @returns The provider-exact output items, projections, and usage of the call.
+     * @throws Any error to fail the `RunModel` attempt, which Dex retries up to 3 times.
+     */
+    callModel(request: ModelRequest, output: ModelOutputWriter): Promise<ModelResponse>;
+    /**
+     * Estimates the input tokens of a request without a model call.
+     * @param request - The request to measure.
+     * @returns An estimate of its input tokens.
+     */
+    estimateInputTokens(request: ModelRequest): number;
+}

package/dist/src/stepwise/model-client.js

@@ -0,0 +1,9 @@
+// Copyright (c) 2026 Super Durable, Inc.
+//
+// Licensed under the Sustainable Use License 1.0.
+// You may not use this file except in compliance with the License.
+// See the LICENSE file in the repository root.
+//
+// SPDX-License-Identifier: LicenseRef-Sustainable-Use-1.0
+export {};
+//# sourceMappingURL=model-client.js.map

package/dist/src/stepwise/model-client.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"model-client.js","sourceRoot":"","sources":["../../../src/stepwise/model-client.ts"],"names":[],"mappings":"AAAA,yCAAyC;AACzC,EAAE;AACF,kDAAkD;AAClD,mEAAmE;AACnE,+CAA+C;AAC/C,EAAE;AACF,0DAA0D"}

package/dist/src/stepwise/scripted-model-client.d.ts

@@ -0,0 +1,99 @@
+import type { AgentUsage } from "../agent-session-values.js";
+import type { ModelClient, ModelOutputWriter, ModelRequest, ModelResponse, ModelToolResultItem } from "./model-client.js";
+/** {@link ModelOutputItem.provider} of every item {@link ScriptedModelClient} returns. */
+export declare const scriptedModelProvider = "dex-scripted";
+/** {@link ModelOutputItem.api} of every item {@link ScriptedModelClient} returns. */
+export declare const scriptedModelApi = "scripted";
+/** Default number of latest requests {@link ScriptedModelClient.requests} keeps. */
+export declare const defaultMaxRecordedRequests = 100;
+/** One tool call of a {@link ScriptedModelReply}. */
+export interface ScriptedToolCall {
+    /** Tool name. */
+    readonly toolName: string;
+    /** Arguments as JSON text, or an object encoded as JSON. Defaults to `{}`. */
+    readonly arguments?: string | Readonly<Record<string, unknown>>;
+    /** Tool call ID. Defaults to `<stepExecutionId>-<index>`, which is unique in the session. */
+    readonly toolCallId?: string;
+}
+/** What one scripted model call returns. */
+export interface ScriptedModelReply {
+    /** Visible text, streamed as one `text_delta`. Defaults to none. */
+    readonly text?: string;
+    /** Tool calls, in order. Defaults to none. */
+    readonly toolCalls?: readonly ScriptedToolCall[];
+    /** Reasoning summary, streamed as one `reasoning_delta` and stored as a reasoning item. Defaults to none. */
+    readonly reasoning?: string | null;
+    /** Usage of the call. Defaults to one model call with 10 input and 5 output tokens. */
+    readonly usage?: AgentUsage;
+}
+/** The script: a function from the whole request to the reply. */
+export type ScriptedModelResponder = (request: ModelRequest) => ScriptedModelReply | Promise<ScriptedModelReply>;
+/**
+ * A Stepwise {@link ModelClient} that answers every model call from a script, for demos and tests without a
+ * model key. It mirrors the Python core's `ScriptedModelClient`.
+ *
+ * Use it as `AgentDefinition.model` to run a Stepwise agent with no provider account: a local demo
+ * mode of an application, a tutorial, or an integration test. It is a supported part of
+ * `@superdurable/dex-agents/stepwise` and needs no optional peer. `@superdurable/dex-agents/testing`
+ * exports the same class.
+ *
+ * The script is a function of the whole {@link ModelRequest}, so it can read the user text, with
+ * {@link ScriptedModelClient.userTexts}, and the tool results the runner replays, with
+ * {@link ScriptedModelClient.toolResults}, and it can call any offered tool, including built-in and tool
+ * source tools. Keep it deterministic: a Worker that crashes mid-call reruns it in a new process. Its output
+ * items use {@link scriptedModelProvider} and {@link scriptedModelApi}, so a session can switch to a real
+ * model later; that model sees the scripted replies as text.
+ *
+ * @example
+ * ```ts
+ * const model = new ScriptedModelClient((request) =>
+ *   ScriptedModelClient.toolResults(request).length > 0
+ *     ? { text: "done" }
+ *     : { toolCalls: [{ toolName: "lookup_order", arguments: { order_id: "7" } }] });
+ * const flow = createStepwiseAgentSessionFlow(
+ *   { name: "demo", instructions: "Help.", model, tools: [lookupOrder] }, "DemoAgent");
+ * ```
+ */
+export declare class ScriptedModelClient implements ModelClient {
+    private readonly respond;
+    private readonly receivedRequests;
+    private readonly maxRecordedRequests;
+    /**
+     * Creates a client around a script.
+     * @param respond - Function that returns the reply for a request.
+     * @param options - `maxRecordedRequests`: how many of the latest requests {@link requests} keeps, so a
+     * long-running demo Worker does not keep every transcript. `0` records none. Defaults to
+     * {@link defaultMaxRecordedRequests}.
+     * @throws {RangeError} When `maxRecordedRequests` is not a non-negative integer.
+     */
+    constructor(respond: ScriptedModelResponder, options?: {
+        readonly maxRecordedRequests?: number;
+    });
+    /** The latest requests this client received in this process, up to `maxRecordedRequests`, oldest first. */
+    get requests(): readonly ModelRequest[];
+    /**
+     * Runs the script for one request and streams its reply.
+     * @param request - The request.
+     * @param output - Writer for text and reasoning deltas.
+     * @returns One reasoning item, one message item, and one item per tool call, for the parts the reply has.
+     */
+    callModel(request: ModelRequest, output: ModelOutputWriter): Promise<ModelResponse>;
+    /**
+     * Estimates four characters per token over the request text.
+     * @param request - The request.
+     * @returns The estimate.
+     */
+    estimateInputTokens(request: ModelRequest): number;
+    /**
+     * Returns the text of every user item in a request, oldest first.
+     * @param request - The request.
+     * @returns User texts, including Dex notes stored as user text.
+     */
+    static userTexts(request: ModelRequest): string[];
+    /**
+     * Returns the tool results after the last user item of a request.
+     * @param request - The request.
+     * @returns The current turn's tool results, oldest first.
+     */
+    static toolResults(request: ModelRequest): ModelToolResultItem[];
+}

package/dist/src/stepwise/scripted-model-client.js

@@ -0,0 +1,156 @@
+// Copyright (c) 2026 Super Durable, Inc.
+//
+// Licensed under the Sustainable Use License 1.0.
+// You may not use this file except in compliance with the License.
+// See the LICENSE file in the repository root.
+//
+// SPDX-License-Identifier: LicenseRef-Sustainable-Use-1.0
+import { serializeJsonWithSpacedSeparators } from "./json-schema-validation.js";
+/** {@link ModelOutputItem.provider} of every item {@link ScriptedModelClient} returns. */
+export const scriptedModelProvider = "dex-scripted";
+/** {@link ModelOutputItem.api} of every item {@link ScriptedModelClient} returns. */
+export const scriptedModelApi = "scripted";
+/** Default number of latest requests {@link ScriptedModelClient.requests} keeps. */
+export const defaultMaxRecordedRequests = 100;
+/**
+ * A Stepwise {@link ModelClient} that answers every model call from a script, for demos and tests without a
+ * model key. It mirrors the Python core's `ScriptedModelClient`.
+ *
+ * Use it as `AgentDefinition.model` to run a Stepwise agent with no provider account: a local demo
+ * mode of an application, a tutorial, or an integration test. It is a supported part of
+ * `@superdurable/dex-agents/stepwise` and needs no optional peer. `@superdurable/dex-agents/testing`
+ * exports the same class.
+ *
+ * The script is a function of the whole {@link ModelRequest}, so it can read the user text, with
+ * {@link ScriptedModelClient.userTexts}, and the tool results the runner replays, with
+ * {@link ScriptedModelClient.toolResults}, and it can call any offered tool, including built-in and tool
+ * source tools. Keep it deterministic: a Worker that crashes mid-call reruns it in a new process. Its output
+ * items use {@link scriptedModelProvider} and {@link scriptedModelApi}, so a session can switch to a real
+ * model later; that model sees the scripted replies as text.
+ *
+ * @example
+ * ```ts
+ * const model = new ScriptedModelClient((request) =>
+ *   ScriptedModelClient.toolResults(request).length > 0
+ *     ? { text: "done" }
+ *     : { toolCalls: [{ toolName: "lookup_order", arguments: { order_id: "7" } }] });
+ * const flow = createStepwiseAgentSessionFlow(
+ *   { name: "demo", instructions: "Help.", model, tools: [lookupOrder] }, "DemoAgent");
+ * ```
+ */
+export class ScriptedModelClient {
+    respond;
+    receivedRequests = [];
+    maxRecordedRequests;
+    /**
+     * Creates a client around a script.
+     * @param respond - Function that returns the reply for a request.
+     * @param options - `maxRecordedRequests`: how many of the latest requests {@link requests} keeps, so a
+     * long-running demo Worker does not keep every transcript. `0` records none. Defaults to
+     * {@link defaultMaxRecordedRequests}.
+     * @throws {RangeError} When `maxRecordedRequests` is not a non-negative integer.
+     */
+    constructor(respond, options = {}) {
+        this.respond = respond;
+        this.maxRecordedRequests = options.maxRecordedRequests ?? defaultMaxRecordedRequests;
+        if (!Number.isSafeInteger(this.maxRecordedRequests) || this.maxRecordedRequests < 0) {
+            throw new RangeError("maxRecordedRequests must be a non-negative integer");
+        }
+    }
+    /** The latest requests this client received in this process, up to `maxRecordedRequests`, oldest first. */
+    get requests() {
+        return [...this.receivedRequests];
+    }
+    /**
+     * Runs the script for one request and streams its reply.
+     * @param request - The request.
+     * @param output - Writer for text and reasoning deltas.
+     * @returns One reasoning item, one message item, and one item per tool call, for the parts the reply has.
+     */
+    async callModel(request, output) {
+        this.receivedRequests.push(request);
+        if (this.receivedRequests.length > this.maxRecordedRequests) {
+            this.receivedRequests.splice(0, this.receivedRequests.length - this.maxRecordedRequests);
+        }
+        const reply = await this.respond(request);
+        const text = reply.text ?? "";
+        const items = [];
+        if (reply.reasoning !== undefined && reply.reasoning !== null) {
+            output.writeReasoningDelta(reply.reasoning);
+            items.push(createScriptedItem({ type: "reasoning", summary: reply.reasoning }, null, []));
+        }
+        if (text !== "") {
+            output.writeTextDelta(text);
+            items.push(createScriptedItem({ type: "message", text }, text, []));
+        }
+        const toolCalls = [];
+        for (const [index, scripted] of (reply.toolCalls ?? []).entries()) {
+            const toolCall = {
+                toolCallId: scripted.toolCallId ?? `${request.metadata.stepExecutionId}-${index}`,
+                toolName: scripted.toolName,
+                arguments: typeof scripted.arguments === "string"
+                    ? scripted.arguments
+                    : serializeJsonWithSpacedSeparators(scripted.arguments ?? {}),
+            };
+            toolCalls.push(toolCall);
+            items.push(createScriptedItem({ type: "function_call", call_id: toolCall.toolCallId, name: toolCall.toolName, arguments: toolCall.arguments }, null, [toolCall]));
+        }
+        return {
+            outputItems: items,
+            text,
+            toolCalls,
+            usage: reply.usage ?? { modelCalls: 1, inputTokens: 10, outputTokens: 5, cachedInputTokens: 0, reasoningTokens: 0 },
+            responseModel: "scripted",
+            finishReason: toolCalls.length > 0 ? "tool_calls" : "stop",
+        };
+    }
+    /**
+     * Estimates four characters per token over the request text.
+     * @param request - The request.
+     * @returns The estimate.
+     */
+    estimateInputTokens(request) {
+        let characters = request.instructions.length;
+        for (const item of request.inputItems) {
+            characters += (item.type === "model_output" ? item.item : item.type === "user_text" ? item.text : item.output)
+                .length;
+        }
+        return Math.floor(characters / 4);
+    }
+    /**
+     * Returns the text of every user item in a request, oldest first.
+     * @param request - The request.
+     * @returns User texts, including Dex notes stored as user text.
+     */
+    static userTexts(request) {
+        return request.inputItems.flatMap((item) => (item.type === "user_text" ? [item.text] : []));
+    }
+    /**
+     * Returns the tool results after the last user item of a request.
+     * @param request - The request.
+     * @returns The current turn's tool results, oldest first.
+     */
+    static toolResults(request) {
+        let results = [];
+        for (const item of request.inputItems) {
+            if (item.type === "user_text") {
+                results = [];
+            }
+            else if (item.type === "tool_result") {
+                results.push(item);
+            }
+        }
+        return results;
+    }
+}
+function createScriptedItem(item, text, toolCalls) {
+    return {
+        type: "model_output",
+        provider: scriptedModelProvider,
+        api: scriptedModelApi,
+        item: JSON.stringify(item),
+        text,
+        toolCalls,
+    };
+}
+//# sourceMappingURL=scripted-model-client.js.map

package/dist/src/stepwise/scripted-model-client.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"scripted-model-client.js","sourceRoot":"","sources":["../../../src/stepwise/scripted-model-client.ts"],"names":[],"mappings":"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"}