veryfront 0.1.558 → 0.1.560

package/esm/src/testing/deno-compat.js

@@ -19,6 +19,7 @@ import { scaleMs } from "./timing.js";
 import { TIMEOUT_ERROR } from "../errors/index.js";
 export { chmod, createFileSystem, exists, isAlreadyExistsError, isNotFoundError, makeTempDir, mkdir, readDir, readFile, readTextFile, remove, stat, writeFile, writeTextFile, } from "../platform/compat/fs.js";
 export { cwd, deleteEnv, env, getArgs, getEnv, setEnv, } from "../platform/compat/process.js";
+/** Create temp file. */
 export async function makeTempFile(options) {
     if (isDeno) {
         // @ts-ignore - Deno global
@@ -37,6 +38,7 @@ export async function makeTempFile(options) {
     await fs.writeFile(tempPath, "");
     return tempPath;
 }
+/** Options accepted by make temp dir with. */
 export async function makeTempDirWithOptions(options) {
     if (isDeno) {
         // @ts-ignore - Deno global
@@ -55,6 +57,7 @@ export async function makeTempDirWithOptions(options) {
     await fs.mkdir(tempPath, { recursive: true });
     return tempPath;
 }
+/** Wait until a condition succeeds. */
 export async function waitFor(condition, options) {
     const timeout = scaleMs(options?.timeout ?? 5000, 10);
     const interval = scaleMs(options?.interval ?? 100, 5);
@@ -69,9 +72,11 @@ export async function waitFor(condition, options) {
     throw TIMEOUT_ERROR.create({ detail: `${message} (timeout: ${timeout}ms)` });
 }
 // no cleanup needed: one-shot
+/** Wait for a duration in milliseconds. */
 export function delay(ms) {
     return new Promise((resolve) => dntShim.setTimeout(resolve, scaleMs(ms)));
 }
+/** Exit the current process. */
 export function exit(code) {
     if (isDeno) {
         // @ts-ignore - Deno global
@@ -79,6 +84,7 @@ export function exit(code) {
     }
     process.exit(code);
 }
+/** Applies temp dir. */
 export async function withTempDir(fn, options) {
     const tempDir = await makeTempDirWithOptions({ prefix: options?.prefix ?? "test-" });
     try {
@@ -100,6 +106,7 @@ export async function withTempDir(fn, options) {
         }
     }
 }
+/** Applies temp file. */
 export async function withTempFile(fn, options) {
     const tempFile = await makeTempFile({ prefix: options?.prefix, suffix: options?.suffix });
     try {
@@ -121,6 +128,7 @@ export async function withTempFile(fn, options) {
         }
     }
 }
+/** Applies env. */
 export async function withEnv(vars, fn) {
     const { getEnv, setEnv, deleteEnv } = await import("../platform/compat/process.js");
     const original = {};

package/esm/src/testing/isolation.d.ts

@@ -8,6 +8,7 @@
  * @module
  */
 type CleanupTask = () => void | Promise<void>;
+/** Registers test cleanup. */
 export declare function registerTestCleanup(task: CleanupTask): void;
 /**
  * Comprehensive reset of ALL test state across the application.

package/esm/src/testing/isolation.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"isolation.d.ts","sourceRoot":"","sources":["../../../src/src/testing/isolation.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAIH,KAAK,WAAW,GAAG,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;AAQ9C,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,WAAW,GAAG,IAAI,CAE3D;AAwBD;;;;;;;;;;;;;;;GAeG;AACH,wBAAsB,iBAAiB,IAAI,OAAO,CAAC,IAAI,CAAC,CAkHvD"}
+{"version":3,"file":"isolation.d.ts","sourceRoot":"","sources":["../../../src/src/testing/isolation.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAIH,KAAK,WAAW,GAAG,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;AAQ9C,8BAA8B;AAC9B,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,WAAW,GAAG,IAAI,CAE3D;AAwBD;;;;;;;;;;;;;;;GAeG;AACH,wBAAsB,iBAAiB,IAAI,OAAO,CAAC,IAAI,CAAC,CAkHvD"}

package/esm/src/testing/isolation.js

@@ -9,6 +9,7 @@
  */
 import { isBun } from "../platform/compat/runtime.js";
 const cleanupTasks = new Set();
+/** Registers test cleanup. */
 export function registerTestCleanup(task) {
     cleanupTasks.add(task);
 }

package/esm/src/testing/timing.d.ts

@@ -1,4 +1,7 @@
+/** Return test time scale. */
 export declare function getTestTimeScale(): number;
+/** Scale a duration for the current test runtime. */
 export declare function scaleMs(ms: number, minMs?: number): number;
+/** Wait for a test-scaled duration. */
 export declare function testDelay(ms: number): Promise<void>;
 //# sourceMappingURL=timing.d.ts.map

package/esm/src/testing/timing.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"timing.d.ts","sourceRoot":"","sources":["../../../src/src/testing/timing.ts"],"names":[],"mappings":"AAeA,wBAAgB,gBAAgB,IAAI,MAAM,CAEzC;AAED,wBAAgB,OAAO,CAAC,EAAE,EAAE,MAAM,EAAE,KAAK,SAAI,GAAG,MAAM,CAErD;AAGD,wBAAgB,SAAS,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAEnD"}
+{"version":3,"file":"timing.d.ts","sourceRoot":"","sources":["../../../src/src/testing/timing.ts"],"names":[],"mappings":"AAeA,8BAA8B;AAC9B,wBAAgB,gBAAgB,IAAI,MAAM,CAEzC;AAED,qDAAqD;AACrD,wBAAgB,OAAO,CAAC,EAAE,EAAE,MAAM,EAAE,KAAK,SAAI,GAAG,MAAM,CAErD;AAGD,uCAAuC;AACvC,wBAAgB,SAAS,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAEnD"}

package/esm/src/testing/timing.js

@@ -10,13 +10,16 @@ function readScale() {
         return DEFAULT_SCALE;
     return parsed;
 }
+/** Return test time scale. */
 export function getTestTimeScale() {
     return readScale();
 }
+/** Scale a duration for the current test runtime. */
 export function scaleMs(ms, minMs = 1) {
     return Math.max(minMs, Math.round(ms * readScale()));
 }
 // no cleanup needed: one-shot
+/** Wait for a test-scaled duration. */
 export function testDelay(ms) {
     return new Promise((resolve) => dntShim.setTimeout(resolve, scaleMs(ms)));
 }

package/esm/src/testing/utils.d.ts

@@ -2,5 +2,6 @@
  * Shared utility functions for cross-runtime testing.
  ***********************/
 export declare function deepEquals(a: unknown, b: unknown, seen?: WeakSet<object>): boolean;
+/** Serialize unknown values safely for test output. */
 export declare function safeStringify(value: unknown): string;
 //# sourceMappingURL=utils.d.ts.map

package/esm/src/testing/utils.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"utils.d.ts","sourceRoot":"","sources":["../../../src/src/testing/utils.ts"],"names":[],"mappings":"AAAA;;yBAEyB;AAEzB,wBAAgB,UAAU,CAAC,CAAC,EAAE,OAAO,EAAE,CAAC,EAAE,OAAO,EAAE,IAAI,GAAE,OAAO,CAAC,MAAM,CAAiB,GAAG,OAAO,CA0BjG;AAED,wBAAgB,aAAa,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CAWpD"}
+{"version":3,"file":"utils.d.ts","sourceRoot":"","sources":["../../../src/src/testing/utils.ts"],"names":[],"mappings":"AAAA;;yBAEyB;AAEzB,wBAAgB,UAAU,CAAC,CAAC,EAAE,OAAO,EAAE,CAAC,EAAE,OAAO,EAAE,IAAI,GAAE,OAAO,CAAC,MAAM,CAAiB,GAAG,OAAO,CA0BjG;AAED,uDAAuD;AACvD,wBAAgB,aAAa,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CAWpD"}

package/esm/src/testing/utils.js

@@ -30,6 +30,7 @@ export function deepEquals(a, b, seen = new WeakSet()) {
     const bRec = b;
     return aKeys.every((key) => deepEquals(aRec[key], bRec[key], seen));
 }
+/** Serialize unknown values safely for test output. */
 export function safeStringify(value) {
     try {
         return JSON.stringify(value);

package/esm/src/tool/context7.d.ts

@@ -1,9 +1,11 @@
 import type { RemoteToolSource } from "./types.js";
+/** Configuration used by context7 tool source. */
 export interface Context7ToolSourceConfig {
     /** Context7 API key. Falls back to CONTEXT7_API_KEY env var. */
     apiKey?: string;
     /** Override the default endpoint (useful for testing). */
     endpoint?: string;
 }
+/** Create context7 tool source. */
 export declare function createContext7ToolSource(config?: Context7ToolSourceConfig): RemoteToolSource;
 //# sourceMappingURL=context7.d.ts.map

package/esm/src/tool/context7.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"context7.d.ts","sourceRoot":"","sources":["../../../src/src/tool/context7.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AAEnD,MAAM,WAAW,wBAAwB;IACvC,gEAAgE;IAChE,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,0DAA0D;IAC1D,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAcD,wBAAgB,wBAAwB,CACtC,MAAM,GAAE,wBAA6B,GACpC,gBAAgB,CAQlB"}
+{"version":3,"file":"context7.d.ts","sourceRoot":"","sources":["../../../src/src/tool/context7.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AAEnD,kDAAkD;AAClD,MAAM,WAAW,wBAAwB;IACvC,gEAAgE;IAChE,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,0DAA0D;IAC1D,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAcD,mCAAmC;AACnC,wBAAgB,wBAAwB,CACtC,MAAM,GAAE,wBAA6B,GACpC,gBAAgB,CAQlB"}

package/esm/src/tool/context7.js

@@ -8,6 +8,7 @@ function resolveApiKey(config) {
     }
     return key;
 }
+/** Create context7 tool source. */
 export function createContext7ToolSource(config = {}) {
     return createRemoteMCPToolSource({
         id: "context7",

package/esm/src/tool/executor.d.ts

@@ -1,3 +1,4 @@
 import type { ToolExecutionContext } from "./types.js";
+/** Execute a tool definition with validated input. */
 export declare function executeTool(toolId: string, input: unknown, context?: ToolExecutionContext): Promise<unknown>;
 //# sourceMappingURL=executor.d.ts.map

package/esm/src/tool/executor.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"executor.d.ts","sourceRoot":"","sources":["../../../src/src/tool/executor.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,YAAY,CAAC;AAIvD,wBAAgB,WAAW,CACzB,MAAM,EAAE,MAAM,EACd,KAAK,EAAE,OAAO,EACd,OAAO,CAAC,EAAE,oBAAoB,GAC7B,OAAO,CAAC,OAAO,CAAC,CAalB"}
+{"version":3,"file":"executor.d.ts","sourceRoot":"","sources":["../../../src/src/tool/executor.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,YAAY,CAAC;AAIvD,sDAAsD;AACtD,wBAAgB,WAAW,CACzB,MAAM,EAAE,MAAM,EACd,KAAK,EAAE,OAAO,EACd,OAAO,CAAC,EAAE,oBAAoB,GAC7B,OAAO,CAAC,OAAO,CAAC,CAalB"}

package/esm/src/tool/executor.js

@@ -1,5 +1,6 @@
 import { toolRegistry } from "./registry.js";
 import { createError, toError } from "../errors/veryfront-error.js";
+/** Execute a tool definition with validated input. */
 export function executeTool(toolId, input, context) {
     const registeredTool = toolRegistry.get(toolId);
     if (!registeredTool) {

package/esm/src/tool/factory.d.ts

@@ -1,6 +1,8 @@
 import type { Tool, ToolConfig, ToolExecutionContext } from "./types.js";
 import type { JsonSchema } from "../extensions/schema/index.js";
+/** Create a typed tool definition. */
 export declare function tool<TInput = unknown, TOutput = unknown>(config: ToolConfig<TInput, TOutput>): Tool<TInput, TOutput>;
+/** Configuration used by dynamic tool. */
 export interface DynamicToolConfig {
     id?: string;
     description: string;
@@ -10,5 +12,6 @@ export interface DynamicToolConfig {
     toModelOutput?: (output: unknown) => unknown;
     mcp?: ToolConfig["mcp"];
 }
+/** Create a dynamic tool definition. */
 export declare function dynamicTool(config: DynamicToolConfig): Tool<unknown, unknown>;
 //# sourceMappingURL=factory.d.ts.map

package/esm/src/tool/factory.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"factory.d.ts","sourceRoot":"","sources":["../../../src/src/tool/factory.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,IAAI,EAAE,UAAU,EAAE,oBAAoB,EAAE,MAAM,YAAY,CAAC;AACzE,OAAO,KAAK,EAAE,UAAU,EAAU,MAAM,+BAA+B,CAAC;AAyJxE,wBAAgB,IAAI,CAAC,MAAM,GAAG,OAAO,EAAE,OAAO,GAAG,OAAO,EACtD,MAAM,EAAE,UAAU,CAAC,MAAM,EAAE,OAAO,CAAC,GAClC,IAAI,CAAC,MAAM,EAAE,OAAO,CAAC,CAqCvB;AAED,MAAM,WAAW,iBAAiB;IAChC,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,OAAO,CAAC;IACrB,eAAe,CAAC,EAAE,UAAU,CAAC;IAC7B,OAAO,EAAE,CAAC,KAAK,EAAE,OAAO,EAAE,OAAO,CAAC,EAAE,oBAAoB,KAAK,OAAO,CAAC,OAAO,CAAC,GAAG,OAAO,CAAC;IACxF,aAAa,CAAC,EAAE,CAAC,MAAM,EAAE,OAAO,KAAK,OAAO,CAAC;IAC7C,GAAG,CAAC,EAAE,UAAU,CAAC,KAAK,CAAC,CAAC;CACzB;AAED,wBAAgB,WAAW,CAAC,MAAM,EAAE,iBAAiB,GAAG,IAAI,CAAC,OAAO,EAAE,OAAO,CAAC,CA4B7E"}
+{"version":3,"file":"factory.d.ts","sourceRoot":"","sources":["../../../src/src/tool/factory.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,IAAI,EAAE,UAAU,EAAE,oBAAoB,EAAE,MAAM,YAAY,CAAC;AACzE,OAAO,KAAK,EAAE,UAAU,EAAU,MAAM,+BAA+B,CAAC;AAyJxE,sCAAsC;AACtC,wBAAgB,IAAI,CAAC,MAAM,GAAG,OAAO,EAAE,OAAO,GAAG,OAAO,EACtD,MAAM,EAAE,UAAU,CAAC,MAAM,EAAE,OAAO,CAAC,GAClC,IAAI,CAAC,MAAM,EAAE,OAAO,CAAC,CAqCvB;AAED,0CAA0C;AAC1C,MAAM,WAAW,iBAAiB;IAChC,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,OAAO,CAAC;IACrB,eAAe,CAAC,EAAE,UAAU,CAAC;IAC7B,OAAO,EAAE,CAAC,KAAK,EAAE,OAAO,EAAE,OAAO,CAAC,EAAE,oBAAoB,KAAK,OAAO,CAAC,OAAO,CAAC,GAAG,OAAO,CAAC;IACxF,aAAa,CAAC,EAAE,CAAC,MAAM,EAAE,OAAO,KAAK,OAAO,CAAC;IAC7C,GAAG,CAAC,EAAE,UAAU,CAAC,KAAK,CAAC,CAAC;CACzB;AAED,wCAAwC;AACxC,wBAAgB,WAAW,CAAC,MAAM,EAAE,iBAAiB,GAAG,IAAI,CAAC,OAAO,EAAE,OAAO,CAAC,CA4B7E"}

package/esm/src/tool/factory.js

@@ -85,6 +85,7 @@ function markGeneratedToolId(tool) {
         __veryfrontGeneratedId: tool.id,
     };
 }
+/** Create a typed tool definition. */
 export function tool(config) {
     const explicitId = typeof config.id === "string" && config.id.length > 0 ? config.id : undefined;
     const id = explicitId ?? generateToolId();
@@ -113,6 +114,7 @@ export function tool(config) {
     };
     return explicitId ? createdTool : markGeneratedToolId(createdTool);
 }
+/** Create a dynamic tool definition. */
 export function dynamicTool(config) {
     const explicitId = typeof config.id === "string" && config.id.length > 0 ? config.id : undefined;
     const id = explicitId ?? generateToolId();

package/esm/src/tool/host-tools.d.ts

@@ -3,6 +3,7 @@ import type { Tool, ToolConfig, ToolExecutionContext, ToolSet } from "./types.js
 type HostToolExecute = {
     bivarianceHack: (input: unknown, options?: ToolExecutionContext) => Promise<unknown> | unknown;
 }["bivarianceHack"];
+/** Definition for host tool. */
 export type HostToolDefinition = {
     id?: string;
     type?: Tool["type"];
@@ -15,11 +16,15 @@ export type HostToolDefinition = {
     execute?: Tool["execute"] | HostToolExecute;
     mcp?: ToolConfig["mcp"];
 };
+/** Public API contract for host tool set. */
 export type HostToolSet = Record<string, HostToolDefinition>;
+/** Options accepted by host tool materialization. */
 export interface HostToolMaterializationOptions {
     generateToolCallId?: (toolName: string) => string;
 }
+/** Create tools from host definitions. */
 export declare function createToolsFromHostDefinitions(definitions: HostToolSet, options?: HostToolMaterializationOptions): ToolSet;
+/** Create tools from host definitions. */
 export declare function createToolsFromHostDefinitions(definitions: Record<string, unknown>, options?: HostToolMaterializationOptions): ToolSet;
 export {};
 //# sourceMappingURL=host-tools.d.ts.map

package/esm/src/tool/host-tools.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"host-tools.d.ts","sourceRoot":"","sources":["../../../src/src/tool/host-tools.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,UAAU,EAAU,MAAM,+BAA+B,CAAC;AACxE,OAAO,KAAK,EAAE,IAAI,EAAE,UAAU,EAAE,oBAAoB,EAAE,OAAO,EAAE,MAAM,YAAY,CAAC;AAElF,KAAK,eAAe,GAAG;IACrB,cAAc,EAAE,CAAC,KAAK,EAAE,OAAO,EAAE,OAAO,CAAC,EAAE,oBAAoB,KAAK,OAAO,CAAC,OAAO,CAAC,GAAG,OAAO,CAAC;CAChG,CAAC,gBAAgB,CAAC,CAAC;AAEpB,MAAM,MAAM,kBAAkB,GAAG;IAC/B,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,IAAI,CAAC,EAAE,IAAI,CAAC,MAAM,CAAC,CAAC;IACpB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,eAAe,CAAC,EAAE,UAAU,CAAC;IAC7B,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,eAAe,CAAC,EAAE,OAAO,CAAC;IAC1B,OAAO,CAAC,EAAE,IAAI,CAAC,SAAS,CAAC,GAAG,eAAe,CAAC;IAC5C,GAAG,CAAC,EAAE,UAAU,CAAC,KAAK,CAAC,CAAC;CACzB,CAAC;AAEF,MAAM,MAAM,WAAW,GAAG,MAAM,CAAC,MAAM,EAAE,kBAAkB,CAAC,CAAC;AAQ7D,MAAM,WAAW,8BAA8B;IAC7C,kBAAkB,CAAC,EAAE,CAAC,QAAQ,EAAE,MAAM,KAAK,MAAM,CAAC;CACnD;AAmDD,wBAAgB,8BAA8B,CAC5C,WAAW,EAAE,WAAW,EACxB,OAAO,CAAC,EAAE,8BAA8B,GACvC,OAAO,CAAC;AACX,wBAAgB,8BAA8B,CAC5C,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EACpC,OAAO,CAAC,EAAE,8BAA8B,GACvC,OAAO,CAAC"}
+{"version":3,"file":"host-tools.d.ts","sourceRoot":"","sources":["../../../src/src/tool/host-tools.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,UAAU,EAAU,MAAM,+BAA+B,CAAC;AACxE,OAAO,KAAK,EAAE,IAAI,EAAE,UAAU,EAAE,oBAAoB,EAAE,OAAO,EAAE,MAAM,YAAY,CAAC;AAElF,KAAK,eAAe,GAAG;IACrB,cAAc,EAAE,CAAC,KAAK,EAAE,OAAO,EAAE,OAAO,CAAC,EAAE,oBAAoB,KAAK,OAAO,CAAC,OAAO,CAAC,GAAG,OAAO,CAAC;CAChG,CAAC,gBAAgB,CAAC,CAAC;AAEpB,gCAAgC;AAChC,MAAM,MAAM,kBAAkB,GAAG;IAC/B,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,IAAI,CAAC,EAAE,IAAI,CAAC,MAAM,CAAC,CAAC;IACpB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,eAAe,CAAC,EAAE,UAAU,CAAC;IAC7B,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,eAAe,CAAC,EAAE,OAAO,CAAC;IAC1B,OAAO,CAAC,EAAE,IAAI,CAAC,SAAS,CAAC,GAAG,eAAe,CAAC;IAC5C,GAAG,CAAC,EAAE,UAAU,CAAC,KAAK,CAAC,CAAC;CACzB,CAAC;AAEF,6CAA6C;AAC7C,MAAM,MAAM,WAAW,GAAG,MAAM,CAAC,MAAM,EAAE,kBAAkB,CAAC,CAAC;AAQ7D,qDAAqD;AACrD,MAAM,WAAW,8BAA8B;IAC7C,kBAAkB,CAAC,EAAE,CAAC,QAAQ,EAAE,MAAM,KAAK,MAAM,CAAC;CACnD;AAmDD,0CAA0C;AAC1C,wBAAgB,8BAA8B,CAC5C,WAAW,EAAE,WAAW,EACxB,OAAO,CAAC,EAAE,8BAA8B,GACvC,OAAO,CAAC;AACX,0CAA0C;AAC1C,wBAAgB,8BAA8B,CAC5C,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EACpC,OAAO,CAAC,EAAE,8BAA8B,GACvC,OAAO,CAAC"}

package/esm/src/tool/host-tools.js

@@ -42,6 +42,7 @@ function normalizeExecutionContext(toolName, context, options) {
         toolCallId,
     };
 }
+/** Create tools from host definitions. */
 export function createToolsFromHostDefinitions(definitions, options = {}) {
     const tools = {};
     for (const [toolName, definition] of Object.entries(definitions)) {

package/esm/src/tool/project-scoped-remote-tools.d.ts

@@ -1,8 +1,11 @@
 import type { RemoteToolSource, ToolDefinition, ToolExecutionContext } from "./types.js";
+/** Options accepted by project scoped remote tool. */
 export type ProjectScopedRemoteToolOptions = {
     projectNavigationToolNames?: readonly string[];
 };
+/** Public API contract for project scoped remote tool default project ID. */
 export type ProjectScopedRemoteToolDefaultProjectId = string | null | undefined | (() => string | null | undefined);
+/** Options accepted by project scoped remote tool catalog. */
 export type ProjectScopedRemoteToolCatalogOptions = {
     source: RemoteToolSource;
     defaultProjectId?: ProjectScopedRemoteToolDefaultProjectId;
@@ -15,40 +18,52 @@ export type ProjectScopedRemoteToolCatalogOptions = {
         context?: ToolExecutionContext;
     }) => Promise<ToolDefinition[]> | ToolDefinition[];
 };
+/** Public API contract for project scoped remote tool definitions. */
 export type ProjectScopedRemoteToolDefinitions = {
     activeProjectId: string | null;
     toolDefinitions: ToolDefinition[];
 };
+/** Input payload for project scoped remote tool execution. */
 export type ProjectScopedRemoteToolExecutionInput = {
     toolName: string;
     toolInput: Record<string, unknown>;
     context?: ToolExecutionContext;
 };
+/** Public API contract for project scoped remote tool execution. */
 export type ProjectScopedRemoteToolExecution = ProjectScopedRemoteToolDefinitions & {
     toolDefinition: ToolDefinition | undefined;
     toolInput: Record<string, unknown>;
     executeContext: ToolExecutionContext | undefined;
 };
+/** Public API contract for project scoped remote tool catalog. */
 export type ProjectScopedRemoteToolCatalog = {
     id: string;
     listActiveToolDefinitions(context?: ToolExecutionContext): Promise<ProjectScopedRemoteToolDefinitions>;
     listTools(context?: ToolExecutionContext): Promise<ToolDefinition[]>;
     prepareExecution(input: ProjectScopedRemoteToolExecutionInput): Promise<ProjectScopedRemoteToolExecution>;
 };
+/** Options accepted by list project scoped remote tool name. */
 export type ListProjectScopedRemoteToolNameOptions = {
     projectId: string | null;
     context?: ToolExecutionContext;
     projectScopedRemoteToolOptions?: ProjectScopedRemoteToolOptions;
 };
+/** Check whether a remote tool is project-navigation scoped. */
 export declare function isProjectNavigationRemoteTool(toolName: string, options?: ProjectScopedRemoteToolOptions): boolean;
+/** Check whether a remote tool name is allowed. */
 export declare function isRemoteToolNameAllowed(toolName: string, allowedToolNames: ReadonlySet<string> | null | undefined): boolean;
+/** Filter project scoped remote tool definitions. */
 export declare function filterProjectScopedRemoteToolDefinitions(toolDefinitions: readonly ToolDefinition[], projectId: string | null, options?: ProjectScopedRemoteToolOptions): ToolDefinition[];
+/** Input payload for hydrate project scoped remote tool. */
 export declare function hydrateProjectScopedRemoteToolInput(input: {
     toolDefinition: ToolDefinition | undefined;
     activeProjectId: string | null;
     toolInput: Record<string, unknown>;
 }): Record<string, unknown>;
+/** Resolves project scoped remote tool project ID. */
 export declare function resolveProjectScopedRemoteToolProjectId(context: ToolExecutionContext | undefined, defaultProjectId: string | null | undefined): string | null;
+/** Create project scoped remote tool catalog. */
 export declare function createProjectScopedRemoteToolCatalog(input: ProjectScopedRemoteToolCatalogOptions): ProjectScopedRemoteToolCatalog;
+/** List project scoped remote tool names. */
 export declare function listProjectScopedRemoteToolNames(remoteSources: readonly RemoteToolSource[], options: ListProjectScopedRemoteToolNameOptions): Promise<string[]>;
 //# sourceMappingURL=project-scoped-remote-tools.d.ts.map

package/esm/src/tool/project-scoped-remote-tools.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"project-scoped-remote-tools.d.ts","sourceRoot":"","sources":["../../../src/src/tool/project-scoped-remote-tools.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"project-scoped-remote-tools.d.ts","sourceRoot":"","sources":["../../../src/src/tool/project-scoped-remote-tools.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,cAAc,EAAE,oBAAoB,EAAE,MAAM,YAAY,CAAC;AAEzF,sDAAsD;AACtD,MAAM,MAAM,8BAA8B,GAAG;IAC3C,0BAA0B,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;CAChD,CAAC;AAEF,6EAA6E;AAC7E,MAAM,MAAM,uCAAuC,GAC/C,MAAM,GACN,IAAI,GACJ,SAAS,GACT,CAAC,MAAM,MAAM,GAAG,IAAI,GAAG,SAAS,CAAC,CAAC;AAEtC,8DAA8D;AAC9D,MAAM,MAAM,qCAAqC,GAAG;IAClD,MAAM,EAAE,gBAAgB,CAAC;IACzB,gBAAgB,CAAC,EAAE,uCAAuC,CAAC;IAC3D,gBAAgB,CAAC,EAAE,WAAW,CAAC,MAAM,CAAC,GAAG,IAAI,CAAC;IAC9C,8BAA8B,CAAC,EAAE,8BAA8B,CAAC;IAChE,qBAAqB,CAAC,EAAE,CAAC,KAAK,EAAE;QAC9B,MAAM,EAAE,gBAAgB,CAAC;QACzB,eAAe,EAAE,SAAS,cAAc,EAAE,CAAC;QAC3C,eAAe,EAAE,MAAM,GAAG,IAAI,CAAC;QAC/B,OAAO,CAAC,EAAE,oBAAoB,CAAC;KAChC,KAAK,OAAO,CAAC,cAAc,EAAE,CAAC,GAAG,cAAc,EAAE,CAAC;CACpD,CAAC;AAEF,sEAAsE;AACtE,MAAM,MAAM,kCAAkC,GAAG;IAC/C,eAAe,EAAE,MAAM,GAAG,IAAI,CAAC;IAC/B,eAAe,EAAE,cAAc,EAAE,CAAC;CACnC,CAAC;AAEF,8DAA8D;AAC9D,MAAM,MAAM,qCAAqC,GAAG;IAClD,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACnC,OAAO,CAAC,EAAE,oBAAoB,CAAC;CAChC,CAAC;AAEF,oEAAoE;AACpE,MAAM,MAAM,gCAAgC,GAAG,kCAAkC,GAAG;IAClF,cAAc,EAAE,cAAc,GAAG,SAAS,CAAC;IAC3C,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACnC,cAAc,EAAE,oBAAoB,GAAG,SAAS,CAAC;CAClD,CAAC;AAEF,kEAAkE;AAClE,MAAM,MAAM,8BAA8B,GAAG;IAC3C,EAAE,EAAE,MAAM,CAAC;IACX,yBAAyB,CACvB,OAAO,CAAC,EAAE,oBAAoB,GAC7B,OAAO,CAAC,kCAAkC,CAAC,CAAC;IAC/C,SAAS,CAAC,OAAO,CAAC,EAAE,oBAAoB,GAAG,OAAO,CAAC,cAAc,EAAE,CAAC,CAAC;IACrE,gBAAgB,CACd,KAAK,EAAE,qCAAqC,GAC3C,OAAO,CAAC,gCAAgC,CAAC,CAAC;CAC9C,CAAC;AAEF,gEAAgE;AAChE,MAAM,MAAM,sCAAsC,GAAG;IACnD,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,OAAO,CAAC,EAAE,oBAAoB,CAAC;IAC/B,8BAA8B,CAAC,EAAE,8BAA8B,CAAC;CACjE,CAAC;AAoCF,gEAAgE;AAChE,wBAAgB,6BAA6B,CAC3C,QAAQ,EAAE,MAAM,EAChB,OAAO,GAAE,8BAAmC,GAC3C,OAAO,CAMT;AAED,mDAAmD;AACnD,wBAAgB,uBAAuB,CACrC,QAAQ,EAAE,MAAM,EAChB,gBAAgB,EAAE,WAAW,CAAC,MAAM,CAAC,GAAG,IAAI,GAAG,SAAS,GACvD,OAAO,CAET;AAED,qDAAqD;AACrD,wBAAgB,wCAAwC,CACtD,eAAe,EAAE,SAAS,cAAc,EAAE,EAC1C,SAAS,EAAE,MAAM,GAAG,IAAI,EACxB,OAAO,GAAE,8BAAmC,GAC3C,cAAc,EAAE,CAQlB;AAED,4DAA4D;AAC5D,wBAAgB,mCAAmC,CAAC,KAAK,EAAE;IACzD,cAAc,EAAE,cAAc,GAAG,SAAS,CAAC;IAC3C,eAAe,EAAE,MAAM,GAAG,IAAI,CAAC;IAC/B,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACpC,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAgB1B;AAED,sDAAsD;AACtD,wBAAgB,uCAAuC,CACrD,OAAO,EAAE,oBAAoB,GAAG,SAAS,EACzC,gBAAgB,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,GAC1C,MAAM,GAAG,IAAI,CAMf;AA6BD,iDAAiD;AACjD,wBAAgB,oCAAoC,CAClD,KAAK,EAAE,qCAAqC,GAC3C,8BAA8B,CAmFhC;AAED,6CAA6C;AAC7C,wBAAsB,gCAAgC,CACpD,aAAa,EAAE,SAAS,gBAAgB,EAAE,EAC1C,OAAO,EAAE,sCAAsC,GAC9C,OAAO,CAAC,MAAM,EAAE,CAAC,CAgBnB"}

package/esm/src/tool/project-scoped-remote-tools.js

@@ -19,21 +19,25 @@ function requiresActiveProject(toolDefinition, options) {
 function requiresProjectReference(toolDefinition) {
     return getRequiredToolProperties(toolDefinition).includes("project_reference");
 }
+/** Check whether a remote tool is project-navigation scoped. */
 export function isProjectNavigationRemoteTool(toolName, options = {}) {
     if (toolName.length === 0) {
         return false;
     }
     return getProjectNavigationToolNames(options).has(toolName);
 }
+/** Check whether a remote tool name is allowed. */
 export function isRemoteToolNameAllowed(toolName, allowedToolNames) {
     return !allowedToolNames || allowedToolNames.has(toolName);
 }
+/** Filter project scoped remote tool definitions. */
 export function filterProjectScopedRemoteToolDefinitions(toolDefinitions, projectId, options = {}) {
     if (projectId) {
         return [...toolDefinitions];
     }
     return toolDefinitions.filter((toolDefinition) => !requiresActiveProject(toolDefinition, options));
 }
+/** Input payload for hydrate project scoped remote tool. */
 export function hydrateProjectScopedRemoteToolInput(input) {
     if (!input.toolDefinition || !input.activeProjectId ||
         !requiresProjectReference(input.toolDefinition)) {
@@ -47,6 +51,7 @@ export function hydrateProjectScopedRemoteToolInput(input) {
         project_reference: input.activeProjectId,
     };
 }
+/** Resolves project scoped remote tool project ID. */
 export function resolveProjectScopedRemoteToolProjectId(context, defaultProjectId) {
     if (typeof context?.projectId === "string" && context.projectId.length > 0) {
         return context.projectId;
@@ -71,6 +76,7 @@ function withActiveProjectContext(context, activeProjectId) {
         projectId: activeProjectId,
     };
 }
+/** Create project scoped remote tool catalog. */
 export function createProjectScopedRemoteToolCatalog(input) {
     let cachedProjectId;
     let cachedToolDefinitions = null;
@@ -130,6 +136,7 @@ export function createProjectScopedRemoteToolCatalog(input) {
         },
     };
 }
+/** List project scoped remote tool names. */
 export async function listProjectScopedRemoteToolNames(remoteSources, options) {
     const remoteToolNames = new Set();
     const sourceContext = withActiveProjectContext(options.context, options.projectId);

package/esm/src/tool/registry.d.ts

@@ -3,6 +3,7 @@ import { ScopedRegistryFacade } from "../registry/scoped-registry-facade.js";
 declare class ToolRegistryClass extends ScopedRegistryFacade<Tool> {
     getToolsForProvider(): ToolDefinition[];
 }
+/** Shared tool registry value. */
 export declare const toolRegistry: ToolRegistryClass;
 export declare function toolToProviderDefinition(tool: Tool): ToolDefinition;
 export {};

package/esm/src/tool/registry.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"registry.d.ts","sourceRoot":"","sources":["../../../src/src/tool/registry.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,IAAI,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAGvD,OAAO,EAAE,oBAAoB,EAAE,MAAM,uCAAuC,CAAC;AAK7E,cAAM,iBAAkB,SAAQ,oBAAoB,CAAC,IAAI,CAAC;IACxD,mBAAmB,IAAI,cAAc,EAAE;CAGxC;AAED,eAAO,MAAM,YAAY,mBAAqC,CAAC;AAE/D,wBAAgB,wBAAwB,CAAC,IAAI,EAAE,IAAI,GAAG,cAAc,CAenE"}
+{"version":3,"file":"registry.d.ts","sourceRoot":"","sources":["../../../src/src/tool/registry.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,IAAI,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAGvD,OAAO,EAAE,oBAAoB,EAAE,MAAM,uCAAuC,CAAC;AAK7E,cAAM,iBAAkB,SAAQ,oBAAoB,CAAC,IAAI,CAAC;IACxD,mBAAmB,IAAI,cAAc,EAAE;CAGxC;AAED,kCAAkC;AAClC,eAAO,MAAM,YAAY,mBAAqC,CAAC;AAE/D,wBAAgB,wBAAwB,CAAC,IAAI,EAAE,IAAI,GAAG,cAAc,CAenE"}

package/esm/src/tool/registry.js

@@ -8,6 +8,7 @@ class ToolRegistryClass extends ScopedRegistryFacade {
         return [...this.getAll().values()].map(toolToProviderDefinition);
     }
 }
+/** Shared tool registry value. */
 export const toolRegistry = new ToolRegistryClass(toolManager);
 export function toolToProviderDefinition(tool) {
     const hasPreConvertedSchema = tool.inputSchemaJson != null;

package/esm/src/tool/remote-mcp.d.ts

@@ -1,5 +1,6 @@
 import type { RemoteToolSource, ToolExecutionContext } from "./types.js";
 type ResolvableValue<T> = T | ((context?: ToolExecutionContext) => T | Promise<T>);
+/** Configuration used by remote MCP tool source. */
 export interface RemoteMCPToolSourceConfig {
     id?: string;
     endpoint: ResolvableValue<string>;
@@ -8,6 +9,7 @@ export interface RemoteMCPToolSourceConfig {
     listMethod?: string;
     callMethod?: string;
 }
+/** Create remote MCP tool source. */
 export declare function createRemoteMCPToolSource(config: RemoteMCPToolSourceConfig): RemoteToolSource;
 export {};
 //# sourceMappingURL=remote-mcp.d.ts.map

package/esm/src/tool/remote-mcp.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"remote-mcp.d.ts","sourceRoot":"","sources":["../../../src/src/tool/remote-mcp.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,gBAAgB,EAAkB,oBAAoB,EAAE,MAAM,YAAY,CAAC;AAEzF,KAAK,eAAe,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,OAAO,CAAC,EAAE,oBAAoB,KAAK,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC;AAEnF,MAAM,WAAW,yBAAyB;IACxC,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,QAAQ,EAAE,eAAe,CAAC,MAAM,CAAC,CAAC;IAClC,OAAO,CAAC,EAAE,eAAe,CAAC,WAAW,GAAG,SAAS,CAAC,CAAC;IACnD,KAAK,CAAC,EAAE,OAAO,KAAK,CAAC;IACrB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AA4RD,wBAAgB,yBAAyB,CACvC,MAAM,EAAE,yBAAyB,GAChC,gBAAgB,CA6ClB"}
+{"version":3,"file":"remote-mcp.d.ts","sourceRoot":"","sources":["../../../src/src/tool/remote-mcp.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,gBAAgB,EAAkB,oBAAoB,EAAE,MAAM,YAAY,CAAC;AAEzF,KAAK,eAAe,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,OAAO,CAAC,EAAE,oBAAoB,KAAK,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC;AAEnF,oDAAoD;AACpD,MAAM,WAAW,yBAAyB;IACxC,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,QAAQ,EAAE,eAAe,CAAC,MAAM,CAAC,CAAC;IAClC,OAAO,CAAC,EAAE,eAAe,CAAC,WAAW,GAAG,SAAS,CAAC,CAAC;IACnD,KAAK,CAAC,EAAE,OAAO,KAAK,CAAC;IACrB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AA4RD,qCAAqC;AACrC,wBAAgB,yBAAyB,CACvC,MAAM,EAAE,yBAAyB,GAChC,gBAAgB,CA6ClB"}

package/esm/src/tool/remote-mcp.js

@@ -201,6 +201,7 @@ function normalizeCallToolResult(result) {
     }
     return result;
 }
+/** Create remote MCP tool source. */
 export function createRemoteMCPToolSource(config) {
     const id = config.id ?? "remote-mcp";
     const listMethod = config.listMethod ?? "tools/list";

package/esm/src/tool/remote-source-tools.d.ts

@@ -1,8 +1,11 @@
 import type { RemoteToolSource, Tool, ToolDefinition, ToolExecutionContext } from "./types.js";
+/** Options accepted by remote tool materialization. */
 export interface RemoteToolMaterializationOptions {
     context?: ToolExecutionContext;
     toolNameAliases?: Record<string, string>;
 }
+/** Create tools from remote definitions. */
 export declare function createToolsFromRemoteDefinitions(source: RemoteToolSource, definitions: readonly ToolDefinition[], options?: Omit<RemoteToolMaterializationOptions, "context">): Record<string, Tool<unknown, unknown>>;
+/** Loads remote tools from source. */
 export declare function loadRemoteToolsFromSource(source: RemoteToolSource, options?: RemoteToolMaterializationOptions): Promise<Record<string, Tool<unknown, unknown>>>;
 //# sourceMappingURL=remote-source-tools.d.ts.map

package/esm/src/tool/remote-source-tools.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"remote-source-tools.d.ts","sourceRoot":"","sources":["../../../src/src/tool/remote-source-tools.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,gBAAgB,EAAE,IAAI,EAAE,cAAc,EAAE,oBAAoB,EAAE,MAAM,YAAY,CAAC;AAE/F,MAAM,WAAW,gCAAgC;IAC/C,OAAO,CAAC,EAAE,oBAAoB,CAAC;IAC/B,eAAe,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CAC1C;AAkBD,wBAAgB,gCAAgC,CAC9C,MAAM,EAAE,gBAAgB,EACxB,WAAW,EAAE,SAAS,cAAc,EAAE,EACtC,OAAO,GAAE,IAAI,CAAC,gCAAgC,EAAE,SAAS,CAAM,GAC9D,MAAM,CAAC,MAAM,EAAE,IAAI,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC,CAsBxC;AAED,wBAAsB,yBAAyB,CAC7C,MAAM,EAAE,gBAAgB,EACxB,OAAO,GAAE,gCAAqC,GAC7C,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,IAAI,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC,CAAC,CAKjD"}
+{"version":3,"file":"remote-source-tools.d.ts","sourceRoot":"","sources":["../../../src/src/tool/remote-source-tools.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,gBAAgB,EAAE,IAAI,EAAE,cAAc,EAAE,oBAAoB,EAAE,MAAM,YAAY,CAAC;AAE/F,uDAAuD;AACvD,MAAM,WAAW,gCAAgC;IAC/C,OAAO,CAAC,EAAE,oBAAoB,CAAC;IAC/B,eAAe,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CAC1C;AAkBD,4CAA4C;AAC5C,wBAAgB,gCAAgC,CAC9C,MAAM,EAAE,gBAAgB,EACxB,WAAW,EAAE,SAAS,cAAc,EAAE,EACtC,OAAO,GAAE,IAAI,CAAC,gCAAgC,EAAE,SAAS,CAAM,GAC9D,MAAM,CAAC,MAAM,EAAE,IAAI,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC,CAsBxC;AAED,sCAAsC;AACtC,wBAAsB,yBAAyB,CAC7C,MAAM,EAAE,gBAAgB,EACxB,OAAO,GAAE,gCAAqC,GAC7C,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,IAAI,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC,CAAC,CAKjD"}

package/esm/src/tool/remote-source-tools.js

@@ -13,6 +13,7 @@ function toToolInputRecord(input) {
     }
     return Object.fromEntries(Object.entries(input));
 }
+/** Create tools from remote definitions. */
 export function createToolsFromRemoteDefinitions(source, definitions, options = {}) {
     return Object.fromEntries(definitions.map((definition) => {
         const toolName = options.toolNameAliases?.[definition.name] ?? definition.name;
@@ -32,6 +33,7 @@ export function createToolsFromRemoteDefinitions(source, definitions, options =
         ];
     }));
 }
+/** Loads remote tools from source. */
 export async function loadRemoteToolsFromSource(source, options = {}) {
     const definitions = await source.listTools(options.context);
     return createToolsFromRemoteDefinitions(source, definitions, {

package/esm/src/tool/result.d.ts

@@ -1,3 +1,5 @@
+/** Check whether tool execution error marker is present. */
 export declare function hasToolExecutionErrorMarker(value: unknown): boolean;
+/** Result returned from is errored tool execution. */
 export declare function isErroredToolExecutionResult(result: unknown): boolean;
 //# sourceMappingURL=result.d.ts.map

package/esm/src/tool/result.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"result.d.ts","sourceRoot":"","sources":["../../../src/src/tool/result.ts"],"names":[],"mappings":"AAIA,wBAAgB,2BAA2B,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,CAMnE;AAED,wBAAgB,4BAA4B,CAAC,MAAM,EAAE,OAAO,GAAG,OAAO,CAUrE"}
+{"version":3,"file":"result.d.ts","sourceRoot":"","sources":["../../../src/src/tool/result.ts"],"names":[],"mappings":"AAIA,4DAA4D;AAC5D,wBAAgB,2BAA2B,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,CAMnE;AAED,sDAAsD;AACtD,wBAAgB,4BAA4B,CAAC,MAAM,EAAE,OAAO,GAAG,OAAO,CAUrE"}

package/esm/src/tool/result.js

@@ -1,12 +1,14 @@
 function isRecord(value) {
     return typeof value === "object" && value !== null;
 }
+/** Check whether tool execution error marker is present. */
 export function hasToolExecutionErrorMarker(value) {
     if (!isRecord(value)) {
         return false;
     }
     return typeof value.error === "string" || value.isError === true;
 }
+/** Result returned from is errored tool execution. */
 export function isErroredToolExecutionResult(result) {
     if (hasToolExecutionErrorMarker(result)) {
         return true;

package/esm/src/tool/sleep.d.ts

@@ -1,7 +1,10 @@
 import type { InferSchema, Schema } from "../extensions/schema/index.js";
 import type { Tool } from "./types.js";
+/** Default value for sleep tool max seconds. */
 export declare const DEFAULT_SLEEP_TOOL_MAX_SECONDS = 60;
+/** Public API contract for sleep tool wait. */
 export type SleepToolWait = (milliseconds: number) => Promise<void> | void;
+/** Options accepted by create sleep tool. */
 export type CreateSleepToolOptions = {
     maxSeconds?: number;
     wait?: SleepToolWait;
@@ -17,11 +20,14 @@ interface SleepToolInputShape {
  * zero-arg getter — incompatible with per-instance parametric schemas.
  */
 declare function createSleepToolInputSchema(maxSeconds: number): Schema<SleepToolInputShape>;
+/** Input payload for sleep tool. */
 export type SleepToolInput = InferSchema<ReturnType<typeof createSleepToolInputSchema>>;
+/** Output from sleep tool. */
 export type SleepToolOutput = {
     sleptFor: number;
     message: string;
 };
+/** Create sleep tool. */
 export declare function createSleepTool(options?: CreateSleepToolOptions): Tool<SleepToolInputShape, SleepToolOutput>;
 /**
  * Default sleep tool (max 60 s) exposed as a property accessor so the

package/esm/src/tool/sleep.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"sleep.d.ts","sourceRoot":"","sources":["../../../src/src/tool/sleep.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,EAAE,MAAM,+BAA+B,CAAC;AAGzE,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,YAAY,CAAC;AAEvC,eAAO,MAAM,8BAA8B,KAAK,CAAC;AAEjD,MAAM,MAAM,aAAa,GAAG,CAAC,YAAY,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC;AAE3E,MAAM,MAAM,sBAAsB,GAAG;IACnC,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,IAAI,CAAC,EAAE,aAAa,CAAC;CACtB,CAAC;AAOF,UAAU,mBAAmB;IAC3B,OAAO,EAAE,MAAM,CAAC;CACjB;AAED;;;;;;GAMG;AACH,iBAAS,0BAA0B,CAAC,UAAU,EAAE,MAAM,GAAG,MAAM,CAAC,mBAAmB,CAAC,CAOnF;AAED,MAAM,MAAM,cAAc,GAAG,WAAW,CAAC,UAAU,CAAC,OAAO,0BAA0B,CAAC,CAAC,CAAC;AAExF,MAAM,MAAM,eAAe,GAAG;IAC5B,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC;CACjB,CAAC;AAEF,wBAAgB,eAAe,CAAC,OAAO,GAAE,sBAA2B,8CAkBnE;AAeD;;;;GAIG;AACH,eAAO,MAAM,SAAS,EAAE,IAAI,CAAC,cAAc,EAAE,eAAe,CAgB3D,CAAC"}
+{"version":3,"file":"sleep.d.ts","sourceRoot":"","sources":["../../../src/src/tool/sleep.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,EAAE,MAAM,+BAA+B,CAAC;AAGzE,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,YAAY,CAAC;AAEvC,gDAAgD;AAChD,eAAO,MAAM,8BAA8B,KAAK,CAAC;AAEjD,+CAA+C;AAC/C,MAAM,MAAM,aAAa,GAAG,CAAC,YAAY,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC;AAE3E,6CAA6C;AAC7C,MAAM,MAAM,sBAAsB,GAAG;IACnC,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,IAAI,CAAC,EAAE,aAAa,CAAC;CACtB,CAAC;AAOF,UAAU,mBAAmB;IAC3B,OAAO,EAAE,MAAM,CAAC;CACjB;AAED;;;;;;GAMG;AACH,iBAAS,0BAA0B,CAAC,UAAU,EAAE,MAAM,GAAG,MAAM,CAAC,mBAAmB,CAAC,CAOnF;AAED,oCAAoC;AACpC,MAAM,MAAM,cAAc,GAAG,WAAW,CAAC,UAAU,CAAC,OAAO,0BAA0B,CAAC,CAAC,CAAC;AAExF,8BAA8B;AAC9B,MAAM,MAAM,eAAe,GAAG;IAC5B,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC;CACjB,CAAC;AAEF,yBAAyB;AACzB,wBAAgB,eAAe,CAAC,OAAO,GAAE,sBAA2B,8CAkBnE;AAeD;;;;GAIG;AACH,eAAO,MAAM,SAAS,EAAE,IAAI,CAAC,cAAc,EAAE,eAAe,CAgB3D,CAAC"}

package/esm/src/tool/sleep.js

@@ -1,6 +1,7 @@
 import * as dntShim from "../../_dnt.shims.js";
 import { resolveSchemaValidator } from "../schemas/define.js";
 import { tool } from "./factory.js";
+/** Default value for sleep tool max seconds. */
 export const DEFAULT_SLEEP_TOOL_MAX_SECONDS = 60;
 const defaultSleepToolWait = (milliseconds) => new Promise((resolve) => {
     dntShim.setTimeout(resolve, milliseconds);
@@ -18,6 +19,7 @@ function createSleepToolInputSchema(maxSeconds) {
         seconds: v.number().min(1).max(maxSeconds).describe(`Number of seconds to wait (1-${maxSeconds})`),
     });
 }
+/** Create sleep tool. */
 export function createSleepTool(options = {}) {
     const maxSeconds = options.maxSeconds ?? DEFAULT_SLEEP_TOOL_MAX_SECONDS;
     const wait = options.wait ?? defaultSleepToolWait;

package/esm/src/tool/tracing.d.ts

@@ -1,17 +1,22 @@
 import type { HostToolSet } from "./host-tools.js";
 import type { ToolExecutionContext } from "./types.js";
+/** Public API contract for host tool trace runner. */
 export type HostToolTraceRunner = <TResult>(spanName: string, operation: () => TResult) => TResult;
+/** Public API contract for host tool trace attributes. */
 export type HostToolTraceAttributes = Record<string, unknown>;
+/** Input payload for host tool trace attribute. */
 export type HostToolTraceAttributeInput = {
     toolName: string;
     toolCallId: string | undefined;
     context: ToolExecutionContext | undefined;
 };
+/** Options accepted by trace host tools. */
 export type TraceHostToolsOptions<TAttributes extends HostToolTraceAttributes = HostToolTraceAttributes> = {
     trace: HostToolTraceRunner;
     buildAttributes?: (input: HostToolTraceAttributeInput) => TAttributes | undefined;
     setAttributes?: (attributes: TAttributes) => void;
     getSpanName?: (toolName: string) => string;
 };
+/** Wrap host tools with tracing metadata. */
 export declare function traceHostTools<TAttributes extends HostToolTraceAttributes = HostToolTraceAttributes>(tools: HostToolSet, options: TraceHostToolsOptions<TAttributes>): HostToolSet;
 //# sourceMappingURL=tracing.d.ts.map

package/esm/src/tool/tracing.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"tracing.d.ts","sourceRoot":"","sources":["../../../src/src/tool/tracing.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAC;AACnD,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,YAAY,CAAC;AAEvD,MAAM,MAAM,mBAAmB,GAAG,CAAC,OAAO,EACxC,QAAQ,EAAE,MAAM,EAChB,SAAS,EAAE,MAAM,OAAO,KACrB,OAAO,CAAC;AAEb,MAAM,MAAM,uBAAuB,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;AAE9D,MAAM,MAAM,2BAA2B,GAAG;IACxC,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,EAAE,MAAM,GAAG,SAAS,CAAC;IAC/B,OAAO,EAAE,oBAAoB,GAAG,SAAS,CAAC;CAC3C,CAAC;AAEF,MAAM,MAAM,qBAAqB,CAC/B,WAAW,SAAS,uBAAuB,GAAG,uBAAuB,IACnE;IACF,KAAK,EAAE,mBAAmB,CAAC;IAC3B,eAAe,CAAC,EAAE,CAChB,KAAK,EAAE,2BAA2B,KAC/B,WAAW,GAAG,SAAS,CAAC;IAC7B,aAAa,CAAC,EAAE,CAAC,UAAU,EAAE,WAAW,KAAK,IAAI,CAAC;IAClD,WAAW,CAAC,EAAE,CAAC,QAAQ,EAAE,MAAM,KAAK,MAAM,CAAC;CAC5C,CAAC;AAUF,wBAAgB,cAAc,CAC5B,WAAW,SAAS,uBAAuB,GAAG,uBAAuB,EAErE,KAAK,EAAE,WAAW,EAClB,OAAO,EAAE,qBAAqB,CAAC,WAAW,CAAC,GAC1C,WAAW,CA6Bb"}
+{"version":3,"file":"tracing.d.ts","sourceRoot":"","sources":["../../../src/src/tool/tracing.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAC;AACnD,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,YAAY,CAAC;AAEvD,sDAAsD;AACtD,MAAM,MAAM,mBAAmB,GAAG,CAAC,OAAO,EACxC,QAAQ,EAAE,MAAM,EAChB,SAAS,EAAE,MAAM,OAAO,KACrB,OAAO,CAAC;AAEb,0DAA0D;AAC1D,MAAM,MAAM,uBAAuB,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;AAE9D,mDAAmD;AACnD,MAAM,MAAM,2BAA2B,GAAG;IACxC,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,EAAE,MAAM,GAAG,SAAS,CAAC;IAC/B,OAAO,EAAE,oBAAoB,GAAG,SAAS,CAAC;CAC3C,CAAC;AAEF,4CAA4C;AAC5C,MAAM,MAAM,qBAAqB,CAC/B,WAAW,SAAS,uBAAuB,GAAG,uBAAuB,IACnE;IACF,KAAK,EAAE,mBAAmB,CAAC;IAC3B,eAAe,CAAC,EAAE,CAChB,KAAK,EAAE,2BAA2B,KAC/B,WAAW,GAAG,SAAS,CAAC;IAC7B,aAAa,CAAC,EAAE,CAAC,UAAU,EAAE,WAAW,KAAK,IAAI,CAAC;IAClD,WAAW,CAAC,EAAE,CAAC,QAAQ,EAAE,MAAM,KAAK,MAAM,CAAC;CAC5C,CAAC;AAUF,6CAA6C;AAC7C,wBAAgB,cAAc,CAC5B,WAAW,SAAS,uBAAuB,GAAG,uBAAuB,EAErE,KAAK,EAAE,WAAW,EAClB,OAAO,EAAE,qBAAqB,CAAC,WAAW,CAAC,GAC1C,WAAW,CA6Bb"}

package/esm/src/tool/tracing.js

@@ -4,6 +4,7 @@ function defaultSpanName(toolName) {
 function getToolCallId(context) {
     return typeof context?.toolCallId === "string" ? context.toolCallId : undefined;
 }
+/** Wrap host tools with tracing metadata. */
 export function traceHostTools(tools, options) {
     const traced = {};
     const getSpanName = options.getSpanName ?? defaultSpanName;