@superdurable/dex-agents 0.4.0 → 0.5.0

package/dist/src/{stepwise/stepwise-input-items.js → builtin-loop/builtin-loop-input-items.js}

@@ -5,16 +5,20 @@
 // See the LICENSE file in the repository root.
 //
 // SPDX-License-Identifier: LicenseRef-Sustainable-Use-1.0
-import { outcomeUnknownToolResult } from "../agent-session-values.js";
-/** Returns the session message that stores one item; `frameworkItem` is the item's compact snake_case JSON. */
-export function toStepwiseFrameworkMessage(item) {
+import { outcomeUnknownToolResult, } from "../agent-session-values.js";
+/**
+ * Returns the session message that stores one item; `frameworkItem` is the item's compact snake_case JSON. A user
+ * text or tool result item with images adds an `images` list of references; a tool result message also shows them
+ * in `images`.
+ */
+export function toBuiltinLoopFrameworkMessage(item) {
     switch (item.type) {
         case "user_text":
             return {
                 ...emptyProjection,
                 role: "user",
                 text: item.text,
-                frameworkItem: JSON.stringify({ type: "user_text", text: item.text }),
+                frameworkItem: JSON.stringify({ type: "user_text", text: item.text, ...encodeImages(item.images) }),
             };
         case "tool_result":
             return {
@@ -28,7 +32,9 @@ export function toStepwiseFrameworkMessage(item) {
                     tool_call_id: item.toolCallId,
                     tool_name: item.toolName,
                     output: item.output,
+                    ...encodeImages(item.images),
                 }),
+                ...((item.images ?? []).length === 0 ? {} : { images: item.images }),
             };
         case "model_output": {
             const singleToolCall = item.toolCalls.length === 1 ? item.toolCalls[0] : undefined;
@@ -55,13 +61,13 @@ export function toStepwiseFrameworkMessage(item) {
         }
     }
 }
-/** Reads the Stepwise item stored in one session message. */
+/** Reads the built-in loop item stored in one session message. */
 export function readStoredModelInputItem(message) {
     try {
         return decodeModelInputItem(JSON.parse(message.frameworkItem));
     }
     catch (error) {
-        throw new TypeError(`message ${message.sequence} is not a Stepwise item`, { cause: error });
+        throw new TypeError(`message ${message.sequence} is not a built-in loop item`, { cause: error });
     }
 }
 /**
@@ -109,16 +115,17 @@ function createOutcomeUnknownResult(toolCall) {
     };
 }
 function decodeModelInputItem(value) {
-    const record = requireRecord(value, "Stepwise item");
+    const record = requireRecord(value, "built-in loop item");
     switch (record["type"]) {
         case "user_text":
-            return { type: "user_text", text: requireString(record, "text") };
+            return { type: "user_text", text: requireString(record, "text"), ...decodeImages(record) };
         case "tool_result":
             return {
                 type: "tool_result",
                 toolCallId: requireString(record, "tool_call_id"),
                 toolName: requireString(record, "tool_name"),
                 output: requireString(record, "output"),
+                ...decodeImages(record),
             };
         case "model_output": {
             const text = record["text"] ?? null;
@@ -146,8 +153,48 @@ function decodeModelInputItem(value) {
             };
         }
         default:
-            throw new TypeError(`unknown Stepwise item type ${JSON.stringify(record["type"])}`);
+            throw new TypeError(`unknown built-in loop item type ${JSON.stringify(record["type"])}`);
+    }
+}
+/** An item without images keeps the bytes it had before images existed. */
+function encodeImages(images) {
+    if (images === undefined || images.length === 0) {
+        return {};
+    }
+    return {
+        images: images.map((image) => ({
+            type: image.type,
+            uri: image.uri,
+            mime_type: image.mimeType,
+            sha256: image.sha256,
+            size_bytes: image.sizeBytes,
+        })),
+    };
+}
+function decodeImages(record) {
+    const images = record["images"] ?? [];
+    if (!Array.isArray(images)) {
+        throw new TypeError("images must be an array");
+    }
+    if (images.length === 0) {
+        return {};
     }
+    return {
+        images: images.map((image) => {
+            const imageRecord = requireRecord(image, "images item");
+            const sizeBytes = imageRecord["size_bytes"];
+            if (typeof sizeBytes !== "number") {
+                throw new TypeError("size_bytes must be a number");
+            }
+            return {
+                type: "image",
+                uri: requireString(imageRecord, "uri"),
+                mimeType: requireString(imageRecord, "mime_type"),
+                sha256: requireString(imageRecord, "sha256"),
+                sizeBytes,
+            };
+        }),
+    };
 }
 const emptyProjection = {
     text: null,
@@ -169,4 +216,4 @@ function requireString(record, field) {
     }
     return value;
 }
-//# sourceMappingURL=stepwise-input-items.js.map
+//# sourceMappingURL=builtin-loop-input-items.js.map

package/dist/src/builtin-loop/builtin-loop-input-items.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"builtin-loop-input-items.js","sourceRoot":"","sources":["../../../src/builtin-loop/builtin-loop-input-items.ts"],"names":[],"mappings":"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"}

package/dist/src/builtin-loop/function-tool.d.ts

@@ -0,0 +1,282 @@
+import type { AgentEventWriter } from "../agent-framework-runner.js";
+import type { MediaStore } from "../agent-media.js";
+import type { AgentImageReference, QuestionAnswer, ToolEffect } from "../agent-session-values.js";
+/**
+ * A value that {@link FunctionToolDefinition.prepareArguments} may return: any value except a Promise or another
+ * object with a `then` method, because the conversion must be synchronous.
+ *
+ * Return an object for arguments that can pass the schema check. Any other value fails the call with
+ * `expected a JSON object`. An argument named `then` is allowed when its value is JSON, such as a string;
+ * only a function there is refused. To return the decoded arguments unchanged, narrow them first, such as
+ * with `args as object`.
+ * @since 0.5.0
+ */
+export type PreparedToolArguments = string | number | boolean | null | readonly unknown[] | {
+    readonly then?: PreparedToolArgumentThenValue;
+    readonly [key: string]: unknown;
+} | (object & {
+    readonly then?: PreparedToolArgumentThenValue;
+});
+/** JSON values that an argument named `then` may hold; a function there would make the arguments a thenable. */
+type PreparedToolArgumentThenValue = string | number | boolean | null | readonly unknown[] | Readonly<Record<string, unknown>>;
+/**
+ * What a function tool receives besides its arguments, for one run of one tool call.
+ *
+ * Pass {@link idempotencyKey} to services that deduplicate requests: it is the same on every attempt
+ * of the call, so an `idempotent_write` retried by `CallTool` is applied once.
+ */
+export interface ToolCallContext {
+    /** Flow ID, which is the session ID. */
+    readonly flowId: string;
+    /** Turn that requested the call. */
+    readonly turnId: string;
+    /** Model tool call ID. */
+    readonly toolCallId: string;
+    /** Stable key `<flowId>/<turnId>/<toolCallId>`, identical on every attempt of the call. */
+    readonly idempotencyKey: string;
+    /** One-based attempt of the tool Step; `read` and `idempotent_write` calls get up to three. */
+    readonly attempt: number;
+    /**
+     * Effect of this call after the tool policies are applied.
+     *
+     * It is the effect stored on the call, which chose `CallTool` or `CallSingleAttemptTool` and the default
+     * approval. It can differ from {@link FunctionToolDefinition.effect} when a policy in
+     * {@link AgentDefinition.toolPolicies} or a session policy overrides it.
+     *
+     * The runner always sets it. It is `undefined` only in a context built by hand, such as in a unit test.
+     * Treat `undefined` as an unknown effect, and handle the call as a write whose outcome may be unknown.
+     *
+     * Use it in a wrapper that turns errors into {@link ToolExecutionError}. `non_idempotent_write` and
+     * `unclassified` calls run once in `CallSingleAttemptTool`. For them, and for an unknown effect, let an error
+     * whose outcome is unknown propagate, so the session records `outcome_unknown` and never repeats the call.
+     *
+     * @example
+     * ```ts
+     * execute: async (args, context) => {
+     *   try {
+     *     return await client.send(args);
+     *   } catch (error) {
+     *     if (context.effect !== "read" && context.effect !== "idempotent_write") throw error;
+     *     throw new ToolExecutionError(String(error));
+     *   }
+     * },
+     * ```
+     * @since 0.5.0
+     */
+    readonly effect?: ToolEffect;
+    /** Events writer bound to the turn and attempt, for progress text. */
+    readonly events: AgentEventWriter;
+    /** Signal aborted when Dex cancels the attempt; pass it to network calls. */
+    readonly cancellationSignal: AbortSignal;
+    /** Absolute deadline of the current attempt, or `undefined`. */
+    readonly deadline: Date | undefined;
+    /**
+     * Answers to the questions this call asked by returning {@link ToolInputRequested}, oldest first;
+     * empty on the first run.
+     */
+    readonly inputAnswers: readonly QuestionAnswer[];
+    /** `continuation` of the call's last {@link ToolInputRequested}, or `null`. */
+    readonly inputContinuation: string | null;
+    /**
+     * The store that holds the session's images, the one the runner was built with, or `undefined` when it has none.
+     *
+     * Upload image bytes with `putImage` and return the references with {@link functionToolResult}. See
+     * {@link functionToolResult} for an example.
+     * @since 0.5.0
+     */
+    readonly mediaStore?: MediaStore;
+    /**
+     * Records a heartbeat. The session already records one every 20 seconds while the tool runs.
+     * @returns A Promise that resolves when the Worker accepted the heartbeat.
+     */
+    heartbeat(): Promise<void>;
+}
+/**
+ * Text and images that a function tool returns. Create it with {@link functionToolResult}.
+ *
+ * Only an object that {@link functionToolResult} created is a result with images. Any other object with the same
+ * fields, such as a copy or a literal, is serialized as JSON like every other tool result.
+ * @since 0.5.0
+ */
+export interface FunctionToolResult {
+    /** Tool output text the model sees. */
+    readonly output: string;
+    /**
+     * Images the model sees after {@link output}, uploaded with `MediaStore.putImage`, at most
+     * `maxImagesPerMessage`. Omit it for none.
+     */
+    readonly images?: readonly AgentImageReference[];
+}
+/**
+ * Creates a function tool result with text and images.
+ *
+ * Return it from {@link FunctionToolDefinition.execute} to show the model images with the output. Upload each
+ * image's bytes with {@link ToolCallContext.mediaStore} inside the call, then return the references. A retried
+ * attempt uploads the same bytes to the same object, so uploading again is safe.
+ *
+ * The runner returns the result as a `ToolExecutionResult` with the same output and images, so the session checks
+ * the images exactly as it checks a tool source's images. More than `maxImagesPerMessage` images, or a reference
+ * that `validateImageReference` refuses, fails the attempt with `ImageValidationError`. A failed attempt of a
+ * `read` or `idempotent_write` tool retries; a failed single-attempt call records `outcome_unknown`. Images from a
+ * runner without a media store throw `ToolExecutionError` instead, because no retry could show them: the session
+ * records `failed` once and the model sees the error text. A result without images is the same as returning
+ * `output` as a string. Return the object it creates: a copy is serialized as JSON.
+ *
+ * @example
+ * ```ts
+ * const takeScreenshot = functionTool<Record<string, never>>({
+ *   name: "take_screenshot",
+ *   description: "Take a screenshot of the screen.",
+ *   parameters: { type: "object", properties: {} },
+ *   effect: "read",
+ *   execute: async (_args, context) => {
+ *     if (context.mediaStore === undefined) {
+ *       return "Screenshots need a media store.";
+ *     }
+ *     const reference = await context.mediaStore.putImage(await screen.capturePng());
+ *     return functionToolResult({ output: "Took a screenshot.", images: [reference] });
+ *   },
+ * });
+ * ```
+ * @param result - The output text and, optionally, the image references.
+ * @returns The frozen result, to return from `execute`.
+ * @throws {TypeError} When `output` is not a string or `images` is not an array.
+ * @since 0.5.0
+ */
+export declare function functionToolResult(result: {
+    readonly output: string;
+    readonly images?: readonly AgentImageReference[];
+}): FunctionToolResult;
+export declare function isFunctionToolResult(value: unknown): value is FunctionToolResult;
+/** Definition passed to {@link functionTool}. */
+export interface FunctionToolDefinition<Arguments> {
+    /** Tool name as the model calls it: 1 to 64 letters, digits, `_`, or `-`, unique within the agent. */
+    readonly name: string;
+    /** Description for the model; say what the tool does and when to use it. */
+    readonly description: string;
+    /**
+     * JSON Schema of the arguments, with `type` `"object"`. The runner checks the model's arguments
+     * against it before {@link execute} runs, as the Python core does: `type`, `enum`, `anyOf`,
+     * `properties`, `required`, `additionalProperties`, `items`, `minimum`, and `maximum` are checked, and
+     * other keywords are only shown to the model.
+     */
+    readonly parameters: Readonly<Record<string, unknown>>;
+    /** Side-effect class; it picks `CallTool` or `CallSingleAttemptTool` and the default approval. */
+    readonly effect: ToolEffect;
+    /**
+     * Whether every call waits for `resolve_interrupt` before it runs. Defaults to `true` for
+     * `non_idempotent_write` and `unclassified` and to `false` otherwise. A tool policy in
+     * {@link AgentDefinition.toolPolicies} overrides it.
+     */
+    readonly requiresApproval?: boolean;
+    /**
+     * Converts the model's arguments before the {@link parameters} check, such as an argument shape that an
+     * earlier version of the tool accepted.
+     *
+     * The runner calls it with the arguments decoded from JSON, which may be any JSON value. It checks the
+     * returned value against {@link parameters} and passes it to {@link execute}. A throw fails the call like
+     * a schema violation: the model sees `invalid arguments for <tool>: <message>`, and {@link execute} does not
+     * run. Absent, the decoded arguments are checked unchanged.
+     *
+     * It must be synchronous and deterministic, and it must have no side effects. Every attempt converts the
+     * stored arguments again. A Promise or another object with a `then` method fails the call with
+     * `invalid arguments for <tool>: argument conversion must be synchronous`. The stored tool call, the approval
+     * interrupt, and the transcript keep the model's original arguments.
+     *
+     * @example
+     * ```ts
+     * // Version 1 took { id }; version 2 takes { order_id }.
+     * prepareArguments: (args) => {
+     *   const record = args as Record<string, unknown>;
+     *   return "id" in record && !("order_id" in record) ? { order_id: record["id"] } : record;
+     * },
+     * ```
+     * @param args - The model's arguments, decoded from JSON.
+     * @returns The arguments to check against {@link parameters}.
+     * @since 0.5.0
+     */
+    readonly prepareArguments?: (args: unknown) => PreparedToolArguments;
+    /**
+     * Runs the tool once, inside its own tool Step.
+     *
+     * A `string` result is the output the model sees. A {@link FunctionToolResult} from {@link functionToolResult}
+     * shows the model its output and images. A {@link ToolInputRequested} result asks the user a
+     * question; return it only before the tool took any effect, and the tool runs again with the answer in
+     * {@link ToolCallContext.inputAnswers}. Any other result is serialized as JSON, with the separators
+     * of Python's `json.dumps`. Throw `ToolExecutionError` for a failure the model should see; any other
+     * error fails the attempt, as {@link ToolExecutionError} describes.
+     *
+     * Changed in 0.5.0: a {@link FunctionToolResult} result shows the model its images.
+     * @param args - Arguments that passed the {@link parameters} check.
+     * @param context - Idempotency key, attempt, events, and heartbeat of this run.
+     * @returns The tool result.
+     */
+    readonly execute: (args: Arguments, context: ToolCallContext) => unknown;
+}
+/** A tool implemented by a plain function, created by {@link functionTool}. */
+export interface FunctionTool {
+    /** Discriminator. */
+    readonly kind: "function_tool";
+    /** Tool name. */
+    readonly name: string;
+    /** Description for the model. */
+    readonly description: string;
+    /** JSON Schema of the arguments. */
+    readonly parameters: Readonly<Record<string, unknown>>;
+    /** Side-effect class. */
+    readonly effect: ToolEffect;
+    /** Approval override, or `undefined` for the effect's default. */
+    readonly requiresApproval: boolean | undefined;
+    /**
+     * Converts the model's decoded arguments before the schema check, or `undefined` to check them unchanged.
+     * See {@link FunctionToolDefinition.prepareArguments}.
+     * @param args - The model's arguments, decoded from JSON.
+     * @returns The arguments to check against {@link parameters}.
+     * @since 0.5.0
+     */
+    readonly prepareArguments?: (args: unknown) => PreparedToolArguments;
+    /**
+     * Runs the tool with checked arguments.
+     * @param args - Arguments that passed the schema check.
+     * @param context - Context of this run.
+     * @returns A Promise of the tool result.
+     */
+    execute(args: unknown, context: ToolCallContext): Promise<unknown>;
+}
+/**
+ * Creates a function tool for a built-in loop agent.
+ *
+ * Every function tool declares its effect, which picks the tool Step and the default approval exactly
+ * as for adapter tools. Each call runs in its own Step, so a crash repeats at most a `read` or
+ * `idempotent_write` call and never repeats a `non_idempotent_write` call.
+ *
+ * @example
+ * ```ts
+ * const lookupOrder = functionTool<{ order_id: string }>({
+ *   name: "lookup_order",
+ *   description: "Look up an order by its ID.",
+ *   parameters: { type: "object", properties: { order_id: { type: "string" } }, required: ["order_id"] },
+ *   effect: "read",
+ *   execute: async ({ order_id }) => orders.get(order_id),
+ * });
+ * const refundOrder = functionTool<{ order_id: string; amount_cents: number }>({
+ *   name: "refund_order",
+ *   description: "Refund part of an order.",
+ *   parameters: {
+ *     type: "object",
+ *     properties: { order_id: { type: "string" }, amount_cents: { type: "integer", minimum: 1 } },
+ *     required: ["order_id", "amount_cents"],
+ *   },
+ *   effect: "non_idempotent_write",
+ *   execute: async ({ order_id, amount_cents }, context) =>
+ *     payments.refund(order_id, amount_cents, { idempotencyKey: context.idempotencyKey }),
+ * });
+ * ```
+ * @typeParam Arguments - Type of the checked arguments; it is not checked against the schema.
+ * @param definition - Name, description, schema, effect, approval, argument conversion, and implementation.
+ * @returns The tool, to pass in {@link AgentDefinition.tools}.
+ * @throws {TypeError} When the name, description, schema, effect, argument conversion, or implementation is
+ * invalid.
+ */
+export declare function functionTool<Arguments = Record<string, unknown>>(definition: FunctionToolDefinition<Arguments>): FunctionTool;
+export {};

package/dist/src/{stepwise → builtin-loop}/function-tool.js

@@ -7,8 +7,63 @@
 // SPDX-License-Identifier: LicenseRef-Sustainable-Use-1.0
 const toolNamePattern = /^[A-Za-z0-9_-]{1,64}$/;
 const toolEffects = ["read", "idempotent_write", "non_idempotent_write", "unclassified"];
+// Identity, not fields, marks a result, so a tool's plain JSON with the same keys stays JSON.
+const createdFunctionToolResults = new WeakSet();
 /**
- * Creates a function tool for a Stepwise agent.
+ * Creates a function tool result with text and images.
+ *
+ * Return it from {@link FunctionToolDefinition.execute} to show the model images with the output. Upload each
+ * image's bytes with {@link ToolCallContext.mediaStore} inside the call, then return the references. A retried
+ * attempt uploads the same bytes to the same object, so uploading again is safe.
+ *
+ * The runner returns the result as a `ToolExecutionResult` with the same output and images, so the session checks
+ * the images exactly as it checks a tool source's images. More than `maxImagesPerMessage` images, or a reference
+ * that `validateImageReference` refuses, fails the attempt with `ImageValidationError`. A failed attempt of a
+ * `read` or `idempotent_write` tool retries; a failed single-attempt call records `outcome_unknown`. Images from a
+ * runner without a media store throw `ToolExecutionError` instead, because no retry could show them: the session
+ * records `failed` once and the model sees the error text. A result without images is the same as returning
+ * `output` as a string. Return the object it creates: a copy is serialized as JSON.
+ *
+ * @example
+ * ```ts
+ * const takeScreenshot = functionTool<Record<string, never>>({
+ *   name: "take_screenshot",
+ *   description: "Take a screenshot of the screen.",
+ *   parameters: { type: "object", properties: {} },
+ *   effect: "read",
+ *   execute: async (_args, context) => {
+ *     if (context.mediaStore === undefined) {
+ *       return "Screenshots need a media store.";
+ *     }
+ *     const reference = await context.mediaStore.putImage(await screen.capturePng());
+ *     return functionToolResult({ output: "Took a screenshot.", images: [reference] });
+ *   },
+ * });
+ * ```
+ * @param result - The output text and, optionally, the image references.
+ * @returns The frozen result, to return from `execute`.
+ * @throws {TypeError} When `output` is not a string or `images` is not an array.
+ * @since 0.5.0
+ */
+export function functionToolResult(result) {
+    if (typeof result?.output !== "string") {
+        throw new TypeError("function tool result output must be a string");
+    }
+    if (result.images !== undefined && !Array.isArray(result.images)) {
+        throw new TypeError("function tool result images must be an array");
+    }
+    const created = Object.freeze({
+        output: result.output,
+        ...(result.images === undefined ? {} : { images: result.images }),
+    });
+    createdFunctionToolResults.add(created);
+    return created;
+}
+export function isFunctionToolResult(value) {
+    return typeof value === "object" && value !== null && createdFunctionToolResults.has(value);
+}
+/**
+ * Creates a function tool for a built-in loop agent.
  *
  * Every function tool declares its effect, which picks the tool Step and the default approval exactly
  * as for adapter tools. Each call runs in its own Step, so a crash repeats at most a `read` or
@@ -37,9 +92,10 @@ const toolEffects = ["read", "idempotent_write", "non_idempotent_write", "unclas
  * });
  * ```
  * @typeParam Arguments - Type of the checked arguments; it is not checked against the schema.
- * @param definition - Name, description, schema, effect, approval, and implementation.
+ * @param definition - Name, description, schema, effect, approval, argument conversion, and implementation.
  * @returns The tool, to pass in {@link AgentDefinition.tools}.
- * @throws {TypeError} When the name, description, schema, effect, or implementation is invalid.
+ * @throws {TypeError} When the name, description, schema, effect, argument conversion, or implementation is
+ * invalid.
  */
 export function functionTool(definition) {
     if (typeof definition?.name !== "string" || !toolNamePattern.test(definition.name)) {
@@ -61,6 +117,9 @@ export function functionTool(definition) {
     if (typeof definition.execute !== "function") {
         throw new TypeError(`function tool ${definition.name} needs an execute function`);
     }
+    if (definition.prepareArguments !== undefined && typeof definition.prepareArguments !== "function") {
+        throw new TypeError(`function tool ${definition.name} prepareArguments must be a function`);
+    }
     const execute = definition.execute;
     return Object.freeze({
         kind: "function_tool",
@@ -69,6 +128,7 @@ export function functionTool(definition) {
         parameters,
         effect: definition.effect,
         requiresApproval: definition.requiresApproval,
+        ...(definition.prepareArguments === undefined ? {} : { prepareArguments: definition.prepareArguments }),
         execute: async (args, context) => await execute(args, context),
     });
 }

package/dist/src/builtin-loop/function-tool.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"function-tool.js","sourceRoot":"","sources":["../../../src/builtin-loop/function-tool.ts"],"names":[],"mappings":"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"}

package/dist/src/builtin-loop/index.d.ts

@@ -0,0 +1,8 @@
+export { type AgentDefinition, type InstructionContext, type PlanningToolChoice, type ContinueTurn, type TurnContinuation, type TurnContinuationContext, } from "./agent-definition.js";
+export { functionTool, functionToolResult, type FunctionTool, type FunctionToolDefinition, type FunctionToolResult, type PreparedToolArguments, type ToolCallContext, } from "./function-tool.js";
+export { type ModelClient, type ModelInputItem, type ModelOutputItem, type ModelOutputWriter, type ModelRequest, type ModelRequestMetadata, type ModelResponse, type ModelSettings, type ModelToolCall, type ModelToolChoice, type ModelToolDefinition, type ModelToolResultItem, type ModelUserTextItem, } from "./model-client.js";
+export { ScriptedModelClient, defaultMaxRecordedRequests, scriptedModelApi, scriptedModelProvider, type ScriptedModelReply, type ScriptedModelResponder, type ScriptedToolCall, } from "./scripted-model-client.js";
+export { createBuiltinAgentSessionFlow, type BuiltinAgentSessionFlowOptions } from "./builtin-agent-session-flow.js";
+export { buildContextSummaryNote, buildContextSummaryOmissionNote, contextSummaryInstructions, contextSummaryNoteHeader, contextSummaryRequest, } from "../agent-context-compaction.js";
+export { BuiltinLoopAgentRunner, defaultToolSourceListingTimeoutMs, maxConsecutiveTurnContinuations, } from "./builtin-loop-agent-runner.js";
+export { type SourceToolDefinition, type ToolSource } from "./tool-source.js";

package/dist/src/builtin-loop/index.js

@@ -0,0 +1,13 @@
+// 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 { functionTool, functionToolResult, } from "./function-tool.js";
+export { ScriptedModelClient, defaultMaxRecordedRequests, scriptedModelApi, scriptedModelProvider, } from "./scripted-model-client.js";
+export { createBuiltinAgentSessionFlow } from "./builtin-agent-session-flow.js";
+export { buildContextSummaryNote, buildContextSummaryOmissionNote, contextSummaryInstructions, contextSummaryNoteHeader, contextSummaryRequest, } from "../agent-context-compaction.js";
+export { BuiltinLoopAgentRunner, defaultToolSourceListingTimeoutMs, maxConsecutiveTurnContinuations, } from "./builtin-loop-agent-runner.js";
+//# sourceMappingURL=index.js.map

package/dist/src/builtin-loop/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/builtin-loop/index.ts"],"names":[],"mappings":"AAAA,yCAAyC;AACzC,EAAE;AACF,kDAAkD;AAClD,mEAAmE;AACnE,+CAA+C;AAC/C,EAAE;AACF,0DAA0D;AAU1D,OAAO,EACL,YAAY,EACZ,kBAAkB,GAMnB,MAAM,oBAAoB,CAAC;AAgB5B,OAAO,EACL,mBAAmB,EACnB,0BAA0B,EAC1B,gBAAgB,EAChB,qBAAqB,GAItB,MAAM,4BAA4B,CAAC;AACpC,OAAO,EAAE,6BAA6B,EAAuC,MAAM,iCAAiC,CAAC;AACrH,OAAO,EACL,uBAAuB,EACvB,+BAA+B,EAC/B,0BAA0B,EAC1B,wBAAwB,EACxB,qBAAqB,GACtB,MAAM,gCAAgC,CAAC;AACxC,OAAO,EACL,sBAAsB,EACtB,iCAAiC,EACjC,+BAA+B,GAChC,MAAM,gCAAgC,CAAC"}

package/dist/src/builtin-loop/json-schema-validation.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"json-schema-validation.js","sourceRoot":"","sources":["../../../src/builtin-loop/json-schema-validation.ts"],"names":[],"mappings":"AAAA,yCAAyC;AACzC,EAAE;AACF,kDAAkD;AAClD,mEAAmE;AACnE,+CAA+C;AAC/C,EAAE;AACF,0DAA0D;AAM1D,oHAAoH;AACpH,MAAM,UAAU,uBAAuB,CAAC,KAAc,EAAE,MAAkB,EAAE,IAAY;IACtF,MAAM,KAAK,GAAG,MAAM,CAAC,OAAO,CAAC,CAAC;IAC9B,MAAM,sBAAsB,GAC1B,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC;QACpB,KAAK,CAAC,KAAK,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,uBAAuB,CAAC,KAAK,EAAE,MAAoB,EAAE,IAAI,CAAC,KAAK,SAAS,CAAC,CAAC;IACpG,IAAI,sBAAsB,EAAE,CAAC;QAC3B,OAAO,GAAG,IAAI,oCAAoC,CAAC;IACrD,CAAC;IACD,MAAM,QAAQ,GAAG,MAAM,CAAC,MAAM,CAAC,CAAC;IAChC,IAAI,QAAQ,KAAK,SAAS,EAAE,CAAC;QAC3B,MAAM,aAAa,GAAG,CAAC,OAAO,QAAQ,KAAK,QAAQ,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAE,QAAsB,CAAC,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;QACxG,IAAI,CAAC,aAAa,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,eAAe,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC,EAAE,CAAC;YAChE,OAAO,GAAG,IAAI,YAAY,aAAa,CAAC,IAAI,CAAC,MAAM,CAAC,EAAE,CAAC;QACzD,CAAC;IACH,CAAC;IACD,MAAM,aAAa,GAAG,MAAM,CAAC,MAAM,CAAC,CAAC;IACrC,IAAI,KAAK,CAAC,OAAO,CAAC,aAAa,CAAC,IAAI,CAAC,aAAa,CAAC,IAAI,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,aAAa,CAAC,OAAO,EAAE,KAAK,CAAC,CAAC,EAAE,CAAC;QACpG,OAAO,GAAG,IAAI,mBAAmB,iCAAiC,CAAC,aAAa,CAAC,EAAE,CAAC;IACtF,CAAC;IACD,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;QACzE,OAAO,mBAAmB,CAAC,KAA0C,EAAE,MAAM,EAAE,IAAI,CAAC,CAAC;IACvF,CAAC;IACD,MAAM,KAAK,GAAG,MAAM,CAAC,OAAO,CAAC,CAAC;IAC9B,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI,EAAE,CAAC;QACxE,KAAK,MAAM,CAAC,KAAK,EAAE,IAAI,CAAC,IAAI,KAAK,CAAC,OAAO,EAAE,EAAE,CAAC;YAC5C,MAAM,SAAS,GAAG,uBAAuB,CAAC,IAAI,EAAE,KAAmB,EAAE,GAAG,IAAI,IAAI,KAAK,GAAG,CAAC,CAAC;YAC1F,IAAI,SAAS,KAAK,SAAS,EAAE,CAAC;gBAC5B,OAAO,SAAS,CAAC;YACnB,CAAC;QACH,CAAC;IACH,CAAC;IACD,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;QAC9B,IAAI,OAAO,MAAM,CAAC,SAAS,CAAC,KAAK,QAAQ,IAAI,KAAK,GAAG,MAAM,CAAC,SAAS,CAAC,EAAE,CAAC;YACvE,OAAO,GAAG,IAAI,qBAAqB,MAAM,CAAC,SAAS,CAAC,EAAE,CAAC;QACzD,CAAC;QACD,IAAI,OAAO,MAAM,CAAC,SAAS,CAAC,KAAK,QAAQ,IAAI,KAAK,GAAG,MAAM,CAAC,SAAS,CAAC,EAAE,CAAC;YACvE,OAAO,GAAG,IAAI,oBAAoB,MAAM,CAAC,SAAS,CAAC,EAAE,CAAC;QACxD,CAAC;IACH,CAAC;IACD,OAAO,SAAS,CAAC;AACnB,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,iCAAiC,CAAC,KAAc;IAC9D,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;QACzB,OAAO,IAAI,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,iCAAiC,CAAC,IAAI,KAAK,SAAS,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC;IACpH,CAAC;IACD,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI,EAAE,CAAC;QAChD,MAAM,MAAM,GAAG,OAAQ,KAA8B,CAAC,MAAM,KAAK,UAAU;YACzE,CAAC,CAAG,KAAmC,CAAC,MAAM,EAAwC;YACtF,CAAC,CAAE,KAA2C,CAAC;QACjD,IAAI,OAAO,MAAM,KAAK,QAAQ,IAAI,MAAM,KAAK,IAAI,EAAE,CAAC;YAClD,OAAO,iCAAiC,CAAC,MAAM,CAAC,CAAC;QACnD,CAAC;QACD,MAAM,OAAO,GAAG,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,WAAW,CAAC,EAAE,EAAE,CAAC,WAAW,KAAK,SAAS,CAAC,CAAC;QAC9F,OAAO,IAAI,OAAO;aACf,GAAG,CAAC,CAAC,CAAC,GAAG,EAAE,WAAW,CAAC,EAAE,EAAE,CAAC,GAAG,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,KAAK,iCAAiC,CAAC,WAAW,CAAC,EAAE,CAAC;aACxG,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC;IACnB,CAAC;IACD,MAAM,IAAI,GAAG,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC;IACnC,IAAI,IAAI,KAAK,SAAS,EAAE,CAAC;QACvB,MAAM,IAAI,SAAS,CAAC,KAAK,OAAO,KAAK,qCAAqC,CAAC,CAAC;IAC9E,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC;AAED,SAAS,mBAAmB,CAC1B,KAAwC,EACxC,MAAkB,EAClB,IAAY;IAEZ,MAAM,UAAU,GAAG,CAAC,MAAM,CAAC,YAAY,CAAC,IAAI,EAAE,CAAyC,CAAC;IACxF,KAAK,MAAM,YAAY,IAAI,CAAC,MAAM,CAAC,UAAU,CAAC,IAAI,EAAE,CAAsB,EAAE,CAAC;QAC3E,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,KAAK,EAAE,YAAY,CAAC,EAAE,CAAC;YACxC,OAAO,GAAG,IAAI,IAAI,YAAY,cAAc,CAAC;QAC/C,CAAC;IACH,CAAC;IACD,MAAM,oBAAoB,GAAG,MAAM,CAAC,sBAAsB,CAAC,IAAI,IAAI,CAAC;IACpE,KAAK,MAAM,CAAC,IAAI,EAAE,aAAa,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;QAC1D,IAAI,SAA6B,CAAC;QAClC,IAAI,MAAM,CAAC,MAAM,CAAC,UAAU,EAAE,IAAI,CAAC,EAAE,CAAC;YACpC,SAAS,GAAG,uBAAuB,CAAC,aAAa,EAAE,UAAU,CAAC,IAAI,CAAC,IAAI,EAAE,EAAE,GAAG,IAAI,IAAI,IAAI,EAAE,CAAC,CAAC;QAChG,CAAC;aAAM,IAAI,oBAAoB,KAAK,KAAK,EAAE,CAAC;YAC1C,SAAS,GAAG,GAAG,IAAI,IAAI,IAAI,iBAAiB,CAAC;QAC/C,CAAC;aAAM,IAAI,OAAO,oBAAoB,KAAK,QAAQ,IAAI,oBAAoB,KAAK,IAAI,EAAE,CAAC;YACrF,SAAS,GAAG,uBAAuB,CAAC,aAAa,EAAE,oBAAkC,EAAE,GAAG,IAAI,IAAI,IAAI,EAAE,CAAC,CAAC;QAC5G,CAAC;QACD,IAAI,SAAS,KAAK,SAAS,EAAE,CAAC;YAC5B,OAAO,SAAS,CAAC;QACnB,CAAC;IACH,CAAC;IACD,OAAO,SAAS,CAAC;AACnB,CAAC;AAED,6GAA6G;AAC7G,SAAS,aAAa,CAAC,IAAa,EAAE,KAAc;IAClD,MAAM,SAAS,GAAG,CAAC,KAAc,EAA6B,EAAE,CAAC,OAAO,KAAK,KAAK,QAAQ,IAAI,OAAO,KAAK,KAAK,SAAS,CAAC;IACzH,IAAI,SAAS,CAAC,IAAI,CAAC,IAAI,SAAS,CAAC,KAAK,CAAC,EAAE,CAAC;QACxC,OAAO,SAAS,CAAC,IAAI,CAAC,IAAI,SAAS,CAAC,KAAK,CAAC,IAAI,MAAM,CAAC,IAAI,CAAC,KAAK,MAAM,CAAC,KAAK,CAAC,CAAC;IAC/E,CAAC;IACD,IAAI,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;QAChD,OAAO,CACL,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC;YACnB,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC;YACpB,IAAI,CAAC,MAAM,KAAK,KAAK,CAAC,MAAM;YAC5B,IAAI,CAAC,KAAK,CAAC,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE,CAAC,aAAa,CAAC,IAAI,EAAE,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,CAC/D,CAAC;IACJ,CAAC;IACD,IAAI,OAAO,IAAI,KAAK,QAAQ,IAAI,IAAI,KAAK,IAAI,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI,EAAE,CAAC;QAC7F,MAAM,UAAU,GAAG,IAAyC,CAAC;QAC7D,MAAM,WAAW,GAAG,KAA0C,CAAC;QAC/D,MAAM,QAAQ,GAAG,MAAM,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;QACzC,OAAO,CACL,QAAQ,CAAC,MAAM,KAAK,MAAM,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC,MAAM;YACnD,QAAQ,CAAC,KAAK,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,MAAM,CAAC,MAAM,CAAC,WAAW,EAAE,GAAG,CAAC,IAAI,aAAa,CAAC,UAAU,CAAC,GAAG,CAAC,EAAE,WAAW,CAAC,GAAG,CAAC,CAAC,CAAC,CAC7G,CAAC;IACJ,CAAC;IACD,OAAO,IAAI,KAAK,KAAK,CAAC;AACxB,CAAC;AAED,SAAS,eAAe,CAAC,IAAY,EAAE,KAAc;IACnD,QAAQ,IAAI,EAAE,CAAC;QACb,KAAK,QAAQ;YACX,OAAO,OAAO,KAAK,KAAK,QAAQ,CAAC;QACnC,KAAK,SAAS;YACZ,OAAO,OAAO,KAAK,KAAK,SAAS,CAAC;QACpC,KAAK,MAAM;YACT,OAAO,KAAK,KAAK,IAAI,CAAC;QACxB,KAAK,OAAO;YACV,OAAO,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;QAC9B,KAAK,QAAQ;YACX,OAAO,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;QAC9E,KAAK,QAAQ;YACX,OAAO,OAAO,KAAK,KAAK,QAAQ,CAAC;QACnC,KAAK,SAAS;YACZ,OAAO,OAAO,KAAK,KAAK,QAAQ,IAAI,MAAM,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC;QAC9D;YACE,MAAM,IAAI,SAAS,CAAC,gCAAgC,IAAI,EAAE,CAAC,CAAC;IAChE,CAAC;AACH,CAAC"}