@superdurable/dex-agents 0.3.0 → 0.5.0

package/dist/src/stepwise/index.d.ts

@@ -1,8 +1,41 @@
-export { type AgentDefinition, type InstructionContext, type PlanningToolChoice } from "./agent-definition.js";
-export { functionTool, type FunctionTool, type FunctionToolDefinition, 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 { createStepwiseAgentSessionFlow } from "./stepwise-agent-session-flow.js";
-export { buildContextSummaryNote, buildContextSummaryOmissionNote, contextSummaryInstructions, contextSummaryNoteHeader, contextSummaryRequest, } from "../agent-context-compaction.js";
-export { StepwiseAgentRunner, defaultToolSourceListingTimeoutMs } from "./stepwise-agent-runner.js";
-export { type SourceToolDefinition, type ToolSource } from "./tool-source.js";
+/**
+ * Deprecated alias of `@superdurable/dex-agents/builtin-loop`, the built-in agent loop.
+ *
+ * Every name it exported still works and refers to the same value. Two names changed:
+ * `StepwiseAgentRunner` is `BuiltinLoopAgentRunner`, and `createStepwiseAgentSessionFlow` is
+ * `createBuiltinAgentSessionFlow`.
+ *
+ * @example
+ * ```ts
+ * // Before
+ * import { createStepwiseAgentSessionFlow } from "@superdurable/dex-agents/stepwise";
+ * // After
+ * import { createBuiltinAgentSessionFlow } from "@superdurable/dex-agents/builtin-loop";
+ * ```
+ *
+ * @deprecated Since 0.5.0. Import from `@superdurable/dex-agents/builtin-loop` instead.
+ * @module
+ */
+import { createBuiltinAgentSessionFlow } from "../builtin-loop/builtin-agent-session-flow.js";
+import { BuiltinLoopAgentRunner } from "../builtin-loop/builtin-loop-agent-runner.js";
+export * from "../builtin-loop/index.js";
+/**
+ * The {@link BuiltinLoopAgentRunner} under its old name.
+ *
+ * @deprecated Since 0.5.0. Use `BuiltinLoopAgentRunner` from `@superdurable/dex-agents/builtin-loop`; it is the
+ * same class.
+ */
+export declare const StepwiseAgentRunner: typeof BuiltinLoopAgentRunner;
+/**
+ * The {@link BuiltinLoopAgentRunner} type under its old name.
+ *
+ * @deprecated Since 0.5.0. Use `BuiltinLoopAgentRunner` from `@superdurable/dex-agents/builtin-loop`.
+ */
+export type StepwiseAgentRunner = BuiltinLoopAgentRunner;
+/**
+ * {@link createBuiltinAgentSessionFlow} under its old name.
+ *
+ * @deprecated Since 0.5.0. Use `createBuiltinAgentSessionFlow` from `@superdurable/dex-agents/builtin-loop`; it
+ * is the same function.
+ */
+export declare const createStepwiseAgentSessionFlow: typeof createBuiltinAgentSessionFlow;

package/dist/src/stepwise/index.js

@@ -5,9 +5,39 @@
 // See the LICENSE file in the repository root.
 //
 // SPDX-License-Identifier: LicenseRef-Sustainable-Use-1.0
-export { functionTool, } from "./function-tool.js";
-export { ScriptedModelClient, defaultMaxRecordedRequests, scriptedModelApi, scriptedModelProvider, } from "./scripted-model-client.js";
-export { createStepwiseAgentSessionFlow } from "./stepwise-agent-session-flow.js";
-export { buildContextSummaryNote, buildContextSummaryOmissionNote, contextSummaryInstructions, contextSummaryNoteHeader, contextSummaryRequest, } from "../agent-context-compaction.js";
-export { StepwiseAgentRunner, defaultToolSourceListingTimeoutMs } from "./stepwise-agent-runner.js";
+/**
+ * Deprecated alias of `@superdurable/dex-agents/builtin-loop`, the built-in agent loop.
+ *
+ * Every name it exported still works and refers to the same value. Two names changed:
+ * `StepwiseAgentRunner` is `BuiltinLoopAgentRunner`, and `createStepwiseAgentSessionFlow` is
+ * `createBuiltinAgentSessionFlow`.
+ *
+ * @example
+ * ```ts
+ * // Before
+ * import { createStepwiseAgentSessionFlow } from "@superdurable/dex-agents/stepwise";
+ * // After
+ * import { createBuiltinAgentSessionFlow } from "@superdurable/dex-agents/builtin-loop";
+ * ```
+ *
+ * @deprecated Since 0.5.0. Import from `@superdurable/dex-agents/builtin-loop` instead.
+ * @module
+ */
+import { createBuiltinAgentSessionFlow } from "../builtin-loop/builtin-agent-session-flow.js";
+import { BuiltinLoopAgentRunner } from "../builtin-loop/builtin-loop-agent-runner.js";
+export * from "../builtin-loop/index.js";
+/**
+ * The {@link BuiltinLoopAgentRunner} under its old name.
+ *
+ * @deprecated Since 0.5.0. Use `BuiltinLoopAgentRunner` from `@superdurable/dex-agents/builtin-loop`; it is the
+ * same class.
+ */
+export const StepwiseAgentRunner = BuiltinLoopAgentRunner;
+/**
+ * {@link createBuiltinAgentSessionFlow} under its old name.
+ *
+ * @deprecated Since 0.5.0. Use `createBuiltinAgentSessionFlow` from `@superdurable/dex-agents/builtin-loop`; it
+ * is the same function.
+ */
+export const createStepwiseAgentSessionFlow = createBuiltinAgentSessionFlow;
 //# sourceMappingURL=index.js.map

package/dist/src/stepwise/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/stepwise/index.ts"],"names":[],"mappings":"AAAA,yCAAyC;AACzC,EAAE;AACF,kDAAkD;AAClD,mEAAmE;AACnE,+CAA+C;AAC/C,EAAE;AACF,0DAA0D;AAG1D,OAAO,EACL,YAAY,GAIb,MAAM,oBAAoB,CAAC;AAgB5B,OAAO,EACL,mBAAmB,EACnB,0BAA0B,EAC1B,gBAAgB,EAChB,qBAAqB,GAItB,MAAM,4BAA4B,CAAC;AACpC,OAAO,EAAE,8BAA8B,EAAE,MAAM,kCAAkC,CAAC;AAClF,OAAO,EACL,uBAAuB,EACvB,+BAA+B,EAC/B,0BAA0B,EAC1B,wBAAwB,EACxB,qBAAqB,GACtB,MAAM,gCAAgC,CAAC;AACxC,OAAO,EAAE,mBAAmB,EAAE,iCAAiC,EAAE,MAAM,4BAA4B,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/stepwise/index.ts"],"names":[],"mappings":"AAAA,yCAAyC;AACzC,EAAE;AACF,kDAAkD;AAClD,mEAAmE;AACnE,+CAA+C;AAC/C,EAAE;AACF,0DAA0D;AAE1D;;;;;;;;;;;;;;;;;GAiBG;AAEH,OAAO,EAAE,6BAA6B,EAAE,MAAM,+CAA+C,CAAC;AAC9F,OAAO,EAAE,sBAAsB,EAAE,MAAM,8CAA8C,CAAC;AAEtF,cAAc,0BAA0B,CAAC;AAEzC;;;;;GAKG;AACH,MAAM,CAAC,MAAM,mBAAmB,GAAG,sBAAsB,CAAC;AAS1D;;;;;GAKG;AACH,MAAM,CAAC,MAAM,8BAA8B,GAAG,6BAA6B,CAAC"}

package/dist/src/testing/agent-session-test-client.d.ts

@@ -1,7 +1,7 @@
 import { type Client, type StartFlowOptions } from "@superdurable/dex";
 import type { AgentFrameworkRunner, DeferredToolOutcome } from "../agent-framework-runner.js";
 import type { AgentSessionFlow } from "../agent-session-flow.js";
-import type { AgentEvent, AgentInterrupt, AgentMessagesPage, AgentSnapshot, AgentState, AgentToolCallRecord, SessionSettings } from "../agent-session-values.js";
+import type { AgentEvent, AgentImageReference, AgentInterrupt, AgentMessagesPage, AgentSnapshot, AgentState, AgentToolCallRecord, SessionSettings } from "../agent-session-values.js";
 /** Options of the `waitFor*` methods of {@link AgentSessionTestClient}. */
 export interface AgentSessionWaitOptions {
     /** Total milliseconds to wait. Defaults to 60,000. */
@@ -60,9 +60,12 @@ export declare class AgentSessionTestClient {
      * @param sessionId - Session Flow ID.
      * @param text - Message text.
      * @param planMode - Whether the message starts a planning turn. Defaults to `false`.
-     * @returns The RPC result: `false` for blank text, or for a `planMode` message when plan mode is off.
+     * @param images - Images of the message, uploaded first; none by default. The client does not check them, so a
+     * test can send references that the session refuses. Since 0.5.0.
+     * @returns The RPC result: `false` for blank text, for a `planMode` message when plan mode is off, or for images
+     * that the session refuses.
      */
-    sendUserMessage(sessionId: string, text: string, planMode?: boolean): Promise<boolean>;
+    sendUserMessage(sessionId: string, text: string, planMode?: boolean, images?: readonly AgentImageReference[]): Promise<boolean>;
     /**
      * Calls `execute_plan`, retrying an `RpcLockConflictError` for up to 30 seconds.
      * @param sessionId - Session Flow ID.

package/dist/src/testing/agent-session-test-client.js

@@ -70,10 +70,17 @@ export class AgentSessionTestClient {
      * @param sessionId - Session Flow ID.
      * @param text - Message text.
      * @param planMode - Whether the message starts a planning turn. Defaults to `false`.
-     * @returns The RPC result: `false` for blank text, or for a `planMode` message when plan mode is off.
+     * @param images - Images of the message, uploaded first; none by default. The client does not check them, so a
+     * test can send references that the session refuses. Since 0.5.0.
+     * @returns The RPC result: `false` for blank text, for a `planMode` message when plan mode is off, or for images
+     * that the session refuses.
      */
-    sendUserMessage(sessionId, text, planMode = false) {
-        return this.client.invokeRPC(this.flow.sendUserMessage, sessionId, { text, planMode });
+    sendUserMessage(sessionId, text, planMode = false, images = []) {
+        return this.client.invokeRPC(this.flow.sendUserMessage, sessionId, {
+            text,
+            planMode,
+            ...(images.length > 0 ? { images } : {}),
+        });
     }
     /**
      * Calls `execute_plan`, retrying an `RpcLockConflictError` for up to 30 seconds.

package/dist/src/testing/agent-session-test-client.js.map

@@ -1 +1 @@
-{"version":3,"file":"agent-session-test-client.js","sourceRoot":"","sources":["../../../src/testing/agent-session-test-client.ts"],"names":[],"mappings":"AAAA,yCAAyC;AACzC,EAAE;AACF,kDAAkD;AAClD,mEAAmE;AACnE,+CAA+C;AAC/C,EAAE;AACF,0DAA0D;AAE1D,OAAO,EAAE,UAAU,IAAI,KAAK,EAAE,MAAM,sBAAsB,CAAC;AAE3D,OAAO,EAAE,oBAAoB,EAAsC,MAAM,mBAAmB,CAAC;AAc7F,OAAO,EAAE,iBAAiB,EAAE,MAAM,2BAA2B,CAAC;AAC9D,OAAO,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AAEzC,MAAM,0BAA0B,GAAG,MAAM,CAAC;AAC1C,MAAM,2BAA2B,GAAG,EAAE,CAAC;AACvC,MAAM,cAAc,GAAG,GAAG,CAAC;AAQ3B;;;;;;;;;;;;;;;GAeG;AACH,MAAM,OAAO,sBAAsB;IAQf;IAEA;IATlB;;;;OAIG;IACH;IACE,kCAAkC;IAClB,MAAc;IAC9B,8CAA8C;IAC9B,IAAiE;QAFjE,WAAM,GAAN,MAAM,CAAQ;QAEd,SAAI,GAAJ,IAAI,CAA6D;IAChF,CAAC;IAEJ;;;;;;;;OAQG;IACI,KAAK,CAAC,YAAY,CACvB,SAAiB,EACjB,iBAAgC,IAAI,EACpC,mBAAqC,EAAE,EACvC,kBAA0C,IAAI;QAE9C,MAAM,iBAAiB,CAAC,IAAI,CAAC,MAAM,EAAE,IAAI,CAAC,IAAI,EAAE,SAAS,EAAE,EAAE,cAAc,EAAE,eAAe,EAAE,EAAE,gBAAgB,CAAC,CAAC;IACpH,CAAC;IAED;;;;;OAKG;IACI,qBAAqB,CAAC,SAAiB,EAAE,eAAgC;QAC9E,OAAO,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,IAAI,CAAC,IAAI,CAAC,qBAAqB,EAAE,SAAS,EAAE,EAAE,eAAe,EAAE,CAAC,CAAC;IAChG,CAAC;IAED;;;;;;OAMG;IACI,eAAe,CAAC,SAAiB,EAAE,IAAY,EAAE,QAAQ,GAAG,KAAK;QACtE,OAAO,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,IAAI,CAAC,IAAI,CAAC,eAAe,EAAE,SAAS,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,CAAC,CAAC;IACzF,CAAC;IAED;;;;;OAKG;IACI,WAAW,CAAC,SAAiB,EAAE,QAAgB;QACpD,OAAO,kBAAkB,CAAC,GAAG,EAAE,CAAC,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,SAAS,EAAE,EAAE,QAAQ,EAAE,CAAC,CAAC,CAAC;IACzG,CAAC;IAED;;;;;OAKG;IACI,gBAAgB,CAAC,SAAiB,EAAE,IAAY;QACrD,OAAO,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,IAAI,CAAC,IAAI,CAAC,gBAAgB,EAAE,SAAS,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC;IACjG,CAAC;IAED;;;;;;OAMG;IACI,kBAAkB,CAAC,SAAiB,EAAE,SAAiB;QAC5D,OAAO,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,IAAI,CAAC,IAAI,CAAC,gBAAgB,EAAE,SAAS,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC;IACjG,CAAC;IAED;;;;;;OAMG;IACI,mBAAmB,CAAC,SAAiB,EAAE,SAAiB;QAC7D,OAAO,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,IAAI,CAAC,IAAI,CAAC,mBAAmB,EAAE,SAAS,EAAE,EAAE,SAAS,EAAE,CAAC,CAAC;IACxF,CAAC;IAED;;;;;;OAMG;IACI,UAAU,CAAC,SAAiB,EAAE,SAAwB,IAAI;QAC/D,OAAO,kBAAkB,CAAC,GAAG,EAAE,CAAC,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,IAAI,CAAC,IAAI,CAAC,UAAU,EAAE,SAAS,EAAE,EAAE,MAAM,EAAE,CAAC,CAAC,CAAC;IACtG,CAAC;IAED;;;;;;;OAOG;IACI,gBAAgB,CACrB,SAAiB,EACjB,WAAmB,EACnB,QAAiB,EACjB,mBAAkC,IAAI;QAEtC,OAAO,kBAAkB,CAAC,GAAG,EAAE,CAC7B,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,IAAI,CAAC,IAAI,CAAC,gBAAgB,EAAE,SAAS,EAAE,EAAE,WAAW,EAAE,QAAQ,EAAE,gBAAgB,EAAE,CAAC,CAC1G,CAAC;IACJ,CAAC;IAED;;;;;;OAMG;IACI,cAAc,CAAC,SAAiB,EAAE,WAAmB,EAAE,MAAc;QAC1E,OAAO,kBAAkB,CAAC,GAAG,EAAE,CAC7B,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,IAAI,CAAC,IAAI,CAAC,cAAc,EAAE,SAAS,EAAE,EAAE,WAAW,EAAE,MAAM,EAAE,CAAC,CACpF,CAAC;IACJ,CAAC;IAED;;;;OAIG;IACI,gBAAgB,CAAC,SAAiB;QACvC,OAAO,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,IAAI,CAAC,IAAI,CAAC,gBAAgB,EAAE,SAAS,CAAC,CAAC;IACtE,CAAC;IAED;;;;;;OAMG;IACI,iBAAiB,CACtB,SAAiB,EACjB,cAA6B,EAC7B,KAAa;QAEb,OAAO,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,IAAI,CAAC,IAAI,CAAC,iBAAiB,EAAE,SAAS,EAAE,EAAE,cAAc,EAAE,KAAK,EAAE,CAAC,CAAC;IAClG,CAAC;IAED;;;;OAIG;IACI,KAAK,CAAC,cAAc,CAAC,SAAiB;QAC3C,MAAM,CAAC,KAAK,CAAC,GAAG,MAAM,IAAI,CAAC,MAAM,CAAC,aAAa,CAAC,SAAS,EAAE,IAAI,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;QACjF,OAAO,KAAK,CAAC;IACf,CAAC;IAED;;;;;OAKG;IACI,KAAK,CAAC,YAAY,CAAC,SAAiB,EAAE,UAAkB;QAC7D,MAAM,CAAC,QAAQ,CAAC,GAAG,MAAM,IAAI,CAAC,MAAM,CAAC,aAAa,CAChD,SAAS,EACT,IAAI,CAAC,IAAI,CAAC,cAAc,CAAC,QAAQ,CAAC,UAAU,CAAC,CAC9C,CAAC;QACF,OAAO,QAAQ,CAAC;IAClB,CAAC;IAED;;;;OAIG;IACI,KAAK,CAAC,qBAAqB,CAAC,SAAiB;QAClD,MAAM,CAAC,UAAU,CAAC,GAAG,MAAM,IAAI,CAAC,MAAM,CAAC,aAAa,CAClD,SAAS,EACT,IAAI,CAAC,IAAI,CAAC,iBAAiB,CAC5B,CAAC;QACF,OAAO,UAAU,IAAI,EAAE,CAAC;IAC1B,CAAC;IAED;;;;;;;;OAQG;IACI,oBAAoB,CACzB,SAAiB,EACjB,SAA+C,EAC/C,WAAmB,EACnB,UAAmC,EAAE;QAErC,OAAO,SAAS,CACd,KAAK,IAAI,EAAE;YACT,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,gBAAgB,CAAC,SAAS,CAAC,CAAC;YACxD,OAAO,SAAS,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,SAAS,CAAC;QACpD,CAAC,EACD,EAAE,WAAW,EAAE,GAAG,WAAW,eAAe,SAAS,EAAE,EAAE,GAAG,OAAO,EAAE,CACtE,CAAC;IACJ,CAAC;IAED;;;;;;;;OAQG;IACI,iBAAiB,CACtB,SAAiB,EACjB,SAAyC,EACzC,WAAmB,EACnB,UAAmC,EAAE;QAErC,OAAO,SAAS,CACd,KAAK,IAAI,EAAE;YACT,MAAM,KAAK,GAAG,MAAM,IAAI,CAAC,cAAc,CAAC,SAAS,CAAC,CAAC;YACnD,OAAO,KAAK,KAAK,SAAS,IAAI,SAAS,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,SAAS,CAAC;QACrE,CAAC,EACD,EAAE,WAAW,EAAE,GAAG,WAAW,eAAe,SAAS,EAAE,EAAE,GAAG,OAAO,EAAE,CACtE,CAAC;IACJ,CAAC;IAED;;;;;;OAMG;IACI,qBAAqB,CAC1B,SAAiB,EACjB,SAAiB,EACjB,UAAmC,EAAE;QAErC,OAAO,IAAI,CAAC,iBAAiB,CAC3B,SAAS,EACT,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,MAAM,KAAK,0BAA0B,IAAI,KAAK,CAAC,SAAS,IAAI,SAAS,EACtF,GAAG,SAAS,iBAAiB,EAC7B,OAAO,CACR,CAAC;IACJ,CAAC;IAED;;;;;;OAMG;IACI,uBAAuB,CAC5B,SAAiB,EACjB,QAAiB,EACjB,UAAmC,EAAE;QAErC,OAAO,SAAS,CACd,KAAK,IAAI,EAAE,CACT,CAAC,MAAM,IAAI,CAAC,qBAAqB,CAAC,SAAS,CAAC,CAAC,CAAC,IAAI,CAChD,CAAC,SAAS,EAAE,EAAE,CAAC,QAAQ,KAAK,SAAS,IAAI,SAAS,CAAC,QAAQ,KAAK,QAAQ,CACzE,EACH,EAAE,WAAW,EAAE,yBAAyB,QAAQ,IAAI,UAAU,eAAe,SAAS,EAAE,EAAE,GAAG,OAAO,EAAE,CACvG,CAAC;IACJ,CAAC;IAED;;;;;;;OAOG;IACI,eAAe,CACpB,SAAiB,EACjB,UAAkB,EAClB,SAAqD,EACrD,UAAmC,EAAE;QAErC,OAAO,SAAS,CACd,KAAK,IAAI,EAAE;YACT,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,YAAY,CAAC,SAAS,EAAE,UAAU,CAAC,CAAC;YAChE,OAAO,QAAQ,KAAK,SAAS,IAAI,SAAS,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,SAAS,CAAC;QAC9E,CAAC,EACD,EAAE,WAAW,EAAE,aAAa,UAAU,eAAe,SAAS,EAAE,EAAE,GAAG,OAAO,EAAE,CAC/E,CAAC;IACJ,CAAC;IAED;;;;OAIG;IACI,KAAK,CAAC,eAAe,CAAC,SAAiB;QAC5C,MAAM,WAAW,GAAiB,EAAE,CAAC;QACrC,IAAI,SAAS,GAAG,EAAE,CAAC;QACnB,GAAG,CAAC;YACF,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC,MAAM,CAAC,kBAAkB,CAC/C,SAAS,EACT,IAAI,CAAC,IAAI,CAAC,WAAW,EACrB,cAAc,EACd,SAAS,CACV,CAAC;YACF,WAAW,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC;YACnE,SAAS,GAAG,IAAI,CAAC,aAAa,CAAC;QACjC,CAAC,QAAQ,SAAS,KAAK,EAAE,EAAE;QAC3B,OAAO,WAAW,CAAC,OAAO,EAAE,CAAC;IAC/B,CAAC;CACF;AAED,KAAK,UAAU,kBAAkB,CAAC,MAA8B;IAC9D,MAAM,QAAQ,GAAG,IAAI,CAAC,GAAG,EAAE,GAAG,0BAA0B,CAAC;IACzD,SAAS,CAAC;QACR,IAAI,CAAC;YACH,OAAO,MAAM,MAAM,EAAE,CAAC;QACxB,CAAC;QAAC,OAAO,KAAc,EAAE,CAAC;YACxB,IAAI,CAAC,CAAC,KAAK,YAAY,oBAAoB,CAAC,IAAI,IAAI,CAAC,GAAG,EAAE,IAAI,QAAQ,EAAE,CAAC;gBACvE,MAAM,KAAK,CAAC;YACd,CAAC;QACH,CAAC;QACD,MAAM,KAAK,CAAC,2BAA2B,CAAC,CAAC;IAC3C,CAAC;AACH,CAAC"}
+{"version":3,"file":"agent-session-test-client.js","sourceRoot":"","sources":["../../../src/testing/agent-session-test-client.ts"],"names":[],"mappings":"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"}

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

@@ -1 +1 @@
-export { ScriptedModelClient, scriptedModelApi, scriptedModelProvider, type ScriptedModelReply, type ScriptedModelResponder, type ScriptedToolCall, } from "../stepwise/scripted-model-client.js";
+export { ScriptedModelClient, scriptedModelApi, scriptedModelProvider, type ScriptedModelReply, type ScriptedModelResponder, type ScriptedToolCall, } from "../builtin-loop/scripted-model-client.js";

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

@@ -5,6 +5,6 @@
 // See the LICENSE file in the repository root.
 //
 // SPDX-License-Identifier: LicenseRef-Sustainable-Use-1.0
-// The scripted model client lives in the stepwise entry point; this path keeps the 0.1.0 module.
-export { ScriptedModelClient, scriptedModelApi, scriptedModelProvider, } from "../stepwise/scripted-model-client.js";
+// The scripted model client lives in the builtin-loop entry point; this path keeps the 0.1.0 module.
+export { ScriptedModelClient, scriptedModelApi, scriptedModelProvider, } from "../builtin-loop/scripted-model-client.js";
 //# sourceMappingURL=scripted-model-client.js.map

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

@@ -1 +1 @@
-{"version":3,"file":"scripted-model-client.js","sourceRoot":"","sources":["../../../src/testing/scripted-model-client.ts"],"names":[],"mappings":"AAAA,yCAAyC;AACzC,EAAE;AACF,kDAAkD;AAClD,mEAAmE;AACnE,+CAA+C;AAC/C,EAAE;AACF,0DAA0D;AAG1D,iGAAiG;AACjG,OAAO,EACL,mBAAmB,EACnB,gBAAgB,EAChB,qBAAqB,GAItB,MAAM,sCAAsC,CAAC"}
+{"version":3,"file":"scripted-model-client.js","sourceRoot":"","sources":["../../../src/testing/scripted-model-client.ts"],"names":[],"mappings":"AAAA,yCAAyC;AACzC,EAAE;AACF,kDAAkD;AAClD,mEAAmE;AACnE,+CAA+C;AAC/C,EAAE;AACF,0DAA0D;AAG1D,qGAAqG;AACrG,OAAO,EACL,mBAAmB,EACnB,gBAAgB,EAChB,qBAAqB,GAItB,MAAM,0CAA0C,CAAC"}

package/dist/src/tool-source-router.d.ts

@@ -0,0 +1,211 @@
+import { type AgentTurnContext, type DeferredToolCall, type DeferredToolExecution, type DeferredToolOutcome, type ToolCallStepOptions, type ToolExecutionResult, type ToolTaskCancellation, type ToolTaskPoll, type ToolTaskPollOutcome } from "./agent-framework-runner.js";
+import type { AgentToolCall } from "./agent-session-values.js";
+import type { SourceToolDefinition, ToolSource } from "./builtin-loop/tool-source.js";
+/**
+ * Default `AgentDefinition.toolSourceListingTimeoutMs`: 10 seconds. It is also the default time one model call of a
+ * framework adapter waits for each tool source's listing. Exported from the package root since 0.4.0.
+ */
+export declare const defaultToolSourceListingTimeoutMs = 10000;
+/**
+ * One tool that a {@link ToolSource} listed for a model call, with the source that listed it.
+ * @since 0.4.0
+ */
+export interface ListedSourceTool {
+    /** The source that listed the tool. */
+    readonly source: ToolSource;
+    /** The tool definition as the source listed it. */
+    readonly tool: SourceToolDefinition;
+}
+/**
+ * Options of a {@link ToolSourceRouter}.
+ * @since 0.4.0
+ */
+export interface ToolSourceRouterOptions {
+    /**
+     * JSON key under which the router stores the building source's name in each call's `toolSourceReference`,
+     * such as `"vercel_ai_tool_source"`. Keep it fixed: stored calls are routed by it.
+     */
+    readonly sourceNameKey: string;
+    /** Names of the runner's own tools, which no source tool may repeat. Defaults to none. */
+    readonly localToolNames?: ReadonlySet<string>;
+    /**
+     * What the runner's own tools are, for the collision error, such as `"a function tool"`. Defaults to
+     * `"a tool of the agent"`.
+     */
+    readonly localToolDescription?: string;
+    /** Names of the built-in tools enabled for every session, which no source tool may repeat. Defaults to none. */
+    readonly builtInToolNames?: ReadonlySet<string>;
+    /**
+     * How long one {@link ToolSourceRouter.listSourceTools} waits for each source, in milliseconds. Defaults to
+     * {@link defaultToolSourceListingTimeoutMs}.
+     */
+    readonly listingTimeoutMs?: number;
+}
+/**
+ * Serves {@link ToolSource}s from a framework runner, so their calls run in tool Steps as the built-in loop runner runs
+ * them.
+ *
+ * A framework adapter that implements {@link AgentFrameworkRunner} builds one router from its `toolSources`. In each
+ * `RunModel` it awaits {@link listSourceTools} and offers every listed tool to its framework as a native tool that
+ * never runs inside the model call. When the model calls one, the adapter returns {@link buildDeferredToolCall}, so
+ * the source picks the effect, the approval, and whether the call is an ordered write, and the router stores the
+ * source's name with the source's own `toolSourceReference`. The tool Step then reaches that source through
+ * {@link executeDeferredToolCall} on any Worker, with the full execution: the Step context, the heartbeat
+ * checkpoint, and the attempt. {@link toolCallStepOptions}, {@link pollToolTask}, and {@link cancelToolTask} route
+ * the same way. A runner whose `executeDeferredToolCall` returns only results, and so polls no tool tasks, uses
+ * {@link executeDeferredToolCallForResult} instead. `BuiltinLoopAgentRunner` uses a router too.
+ *
+ * Construction refuses a source without a {@link ToolSource} method or a non-blank, unique `sourceName`, and a
+ * name that a source declares through `declaredToolNames` when it repeats a local tool, a built-in tool, or another
+ * source's tool. Each listing refuses the same collisions among the listed names.
+ *
+ * @example
+ * ```ts
+ * const toolSources = new ToolSourceRouter([new ConnectorToolSource([refund])], {
+ *   sourceNameKey: "my_framework_tool_source",
+ *   localToolNames: new Set(Object.keys(frameworkTools)),
+ * });
+ * const listed = await toolSources.listSourceTools();
+ * const call = toolSources.buildDeferredToolCall(turn, listed.get("refund")!, modelCall);
+ * ```
+ * @since 0.4.0
+ */
+export declare class ToolSourceRouter {
+    private readonly toolSources;
+    private readonly toolSourcesByName;
+    private readonly sourceNameKey;
+    private readonly localToolNames;
+    private readonly localToolDescription;
+    private readonly listingTimeoutMs;
+    /** The last listing of each source, so estimates count its tools without listing again. */
+    private readonly lastListings;
+    /**
+     * Creates the router and checks the sources.
+     * @param toolSources - The sources, in the order the model sees their tools.
+     * @param options - The envelope key, the names source tools must not repeat, and the listing timeout.
+     * @throws {TypeError} When a source lacks a {@link ToolSource} method or a non-blank `sourceName`, two sources
+     * share a `sourceName`, `sourceNameKey` is blank, or a declared tool name repeats a local tool, a built-in tool, or
+     * another source's tool.
+     * @throws {RangeError} When `listingTimeoutMs` is not positive.
+     */
+    constructor(toolSources: readonly ToolSource[], options: ToolSourceRouterOptions);
+    /** Whether the router has at least one source. */
+    get hasToolSources(): boolean;
+    /**
+     * Returns the names the sources always list, from their optional `declaredToolNames`.
+     * @returns The names.
+     */
+    declaredToolNames(): ReadonlySet<string>;
+    /**
+     * Lists every source's tools for one model call, in source order.
+     *
+     * A source whose listing throws or takes longer than the listing timeout offers no tools in this call, with a
+     * warning, so a down server never fails a turn.
+     * @param builtInToolNames - The built-in tools enabled for this turn. Defaults to none.
+     * @returns The listed tools by name.
+     * @throws {TypeError} When a listed name repeats a local tool, an enabled built-in tool, or another source's tool.
+     */
+    listSourceTools(builtInToolNames?: ReadonlySet<string>): Promise<ReadonlyMap<string, ListedSourceTool>>;
+    /**
+     * Returns each source's tools without I/O: its `cachedTools` when it has them, else this router's last listing.
+     * A name listed twice keeps its first source. Use it to estimate the model input.
+     * @returns The cached tools by name.
+     */
+    readCachedSourceTools(): ReadonlyMap<string, ListedSourceTool>;
+    /**
+     * Builds the deferred call for one model call of a listed source tool.
+     *
+     * The source's `deferredToolCall` decides the policy, the `ordered` flag, and its own reference. The router
+     * keeps all of it and wraps the reference with the source's name.
+     * @param turn - The `RunModel` context.
+     * @param listedTool - The listed tool the model called, from {@link listSourceTools} of this model call.
+     * @param modelCall - The model's tool call ID and its arguments as JSON text.
+     * @returns The deferred call to return in `ToolCallsRequested`.
+     */
+    buildDeferredToolCall(turn: AgentTurnContext, listedTool: ListedSourceTool, modelCall: {
+        readonly toolCallId: string;
+        readonly arguments: string;
+    }): DeferredToolCall;
+    /**
+     * Whether a source built this call, so its tool Step and polls go to a source. It reads only the record, so it
+     * answers even when that source is not configured on this Worker; {@link executeDeferredToolCall} then throws.
+     * @param toolCall - The call's record.
+     * @returns `true` when the record holds this router's envelope, or a reference while the router has sources.
+     */
+    isSourceToolCall(toolCall: {
+        readonly toolName: string;
+        readonly toolSourceReference?: string;
+    }): boolean;
+    /**
+     * Runs one call in its tool Step through the source that built it, with the source's own reference and every
+     * other field of `call` unchanged, such as the Step context, the heartbeat checkpoint, and the attempt.
+     * @param call - The deferred execution from the tool Step.
+     * @returns The source's outcome.
+     * @throws {RangeError} When no source built the call, or its source is not configured on this Worker, so the
+     * effect decides the outcome.
+     * @throws Any error of the source, such as `ToolExecutionError` or `ToolOutcomeUnknownError`.
+     */
+    executeDeferredToolCall(call: DeferredToolExecution): Promise<DeferredToolOutcome>;
+    /**
+     * Runs one call as {@link executeDeferredToolCall} does, for a runner that polls no tool tasks and asks no tool
+     * questions, so its `executeDeferredToolCall` returns only a `ToolExecutionResult`. Such a runner has no
+     * `pollToolTask`, so the session tells the source that it cannot start tasks. `ConnectorToolSource` returns only
+     * results.
+     * @param call - The deferred execution from the tool Step.
+     * @returns The source's result.
+     * @throws {ToolExecutionError} When the source asked the user a question. A question comes before any effect, so
+     * the call records `failed` and the model reads why.
+     * @throws {Error} When the source started a tool task anyway. The task may run, so the effect decides the outcome.
+     * @throws Any error of {@link executeDeferredToolCall}.
+     */
+    executeDeferredToolCallForResult(call: DeferredToolExecution): Promise<ToolExecutionResult>;
+    /**
+     * Polls a source's tool task once, through the source that built the call.
+     * @param poll - The call's record from `PollToolTask`.
+     * @returns The source's outcome.
+     * @throws {RangeError} When no source built the call. The task may still run, so `PollToolTask` retries and then
+     * records the call by its effect.
+     * @throws Any error of the source.
+     */
+    pollToolTask(poll: ToolTaskPoll): Promise<ToolTaskPollOutcome>;
+    /**
+     * Cancels a source's task through the source that built the call; a source without `cancelToolTask` leaves its
+     * task running.
+     * @param cancellation - The abandoned call's record from `CancelToolTask`.
+     * @returns A Promise that resolves once the source took the cancellation.
+     * @throws {RangeError} When no source built the call.
+     * @throws Any error of the source.
+     */
+    cancelToolTask(cancellation: ToolTaskCancellation): Promise<void>;
+    /**
+     * Returns the source's options for one call's tool Step.
+     * @param toolCall - The record whose tool Step starts.
+     * @returns The source's options, or `undefined` when no source built the call or its source defines none.
+     * @throws {RangeError} When a source built the call but it is not configured on this Worker; the session then
+     * uses the defaults.
+     */
+    toolCallStepOptions(toolCall: AgentToolCall): ToolCallStepOptions | undefined;
+    private refuseDeclaredToolNameCollisions;
+    private refuseSourceToolName;
+    private listOneSource;
+    private requireToolSource;
+    private routeToToolSource;
+}
+/**
+ * The router's `toolSourceReference`: the source's name under `sourceNameKey` and its own reference, as JSON text.
+ * @param sourceNameKey - The envelope key of the runner.
+ * @param sourceName - The building source's name.
+ * @param reference - The source's own reference, or `undefined`.
+ * @returns The envelope text.
+ */
+export declare function writeToolSourceEnvelope(sourceNameKey: string, sourceName: string, reference: string | undefined): string;
+/**
+ * Reads an envelope that {@link writeToolSourceEnvelope} wrote with the same key.
+ * @param sourceNameKey - The envelope key of the runner.
+ * @param toolSourceReference - A record's `toolSourceReference`.
+ * @returns The source's name and its own reference, or `undefined` when the text is no such envelope.
+ */
+export declare function readToolSourceEnvelope(sourceNameKey: string, toolSourceReference: string | undefined): {
+    readonly sourceName: string;
+    readonly reference: string | undefined;
+} | undefined;