@evalops/maestro 0.10.17 → 0.10.20

package/dist/tools/parallel-execution.js

@@ -26,6 +26,7 @@
  *
  * @module tools/parallel-execution
  */
+import { isAbsolute, resolve } from "node:path";
 /**
  * Set of known read-only tool names.
  *
@@ -74,6 +75,7 @@ export const READ_ONLY_TOOLS = new Set([
  * operations on the same resources.
  */
 export const WRITE_TOOLS = new Set([
+    "apply_patch",
     "write",
     "Write",
     "edit",
@@ -92,7 +94,7 @@ export const WRITE_TOOLS = new Set([
  * @param annotations - Optional tool annotations
  * @returns true if the tool is read-only
  */
-export function isReadOnlyTool(toolName, annotations) {
+export function isReadOnlyTool(toolName, annotations, _source) {
     // Check explicit annotation first
     if (annotations?.readOnlyHint === true) {
         return true;
@@ -103,6 +105,15 @@ export function isReadOnlyTool(toolName, annotations) {
     // Fall back to known tool lists
     return READ_ONLY_TOOLS.has(toolName);
 }
+export function isParallelSafeTool(toolName, annotations, source) {
+    if (isReadOnlyTool(toolName, annotations, source)) {
+        return true;
+    }
+    if (annotations?.destructiveHint === true) {
+        return false;
+    }
+    return source?.type === "mcp" && source.supportsParallelToolCalls === true;
+}
 /**
  * Check if a tool is a write/mutating operation.
  *
@@ -136,12 +147,18 @@ export function getOptimalConcurrency(toolCalls, tools, config) {
         return baseConcurrency;
     }
     // Build a map of tool names to annotations
-    const toolAnnotations = new Map();
+    const toolMetadata = new Map();
     for (const tool of tools) {
-        toolAnnotations.set(tool.name, tool.annotations);
+        toolMetadata.set(tool.name, {
+            annotations: tool.annotations,
+            source: tool.source,
+        });
     }
     // Check if all tools are read-only
-    const allReadOnly = toolCalls.every((call) => isReadOnlyTool(call.name, toolAnnotations.get(call.name)));
+    const allReadOnly = toolCalls.every((call) => {
+        const metadata = toolMetadata.get(call.name);
+        return isReadOnlyTool(call.name, metadata?.annotations, metadata?.source);
+    });
     if (allReadOnly) {
         // Safe to use higher concurrency
         return Math.min(maxReadOnlyConcurrency, toolCalls.length);
@@ -160,14 +177,18 @@ export function getOptimalConcurrency(toolCalls, tools, config) {
  * @returns Object with readOnly and write arrays
  */
 export function partitionToolCalls(toolCalls, tools) {
-    const toolAnnotations = new Map();
+    const toolMetadata = new Map();
     for (const tool of tools) {
-        toolAnnotations.set(tool.name, tool.annotations);
+        toolMetadata.set(tool.name, {
+            annotations: tool.annotations,
+            source: tool.source,
+        });
     }
     const readOnly = [];
     const write = [];
     for (const call of toolCalls) {
-        if (isReadOnlyTool(call.name, toolAnnotations.get(call.name))) {
+        const metadata = toolMetadata.get(call.name);
+        if (isReadOnlyTool(call.name, metadata?.annotations, metadata?.source)) {
             readOnly.push(call);
         }
         else {
@@ -176,6 +197,156 @@ export function partitionToolCalls(toolCalls, tools) {
     }
     return { readOnly, write };
 }
+const PATH_SCOPED_MUTATION_TOOLS = new Set([
+    "apply_patch",
+    "write",
+    "Write",
+    "edit",
+    "Edit",
+    "MultiEdit",
+    "notebook_edit",
+    "NotebookEdit",
+]);
+const PATH_ARGUMENT_KEYS = new Set([
+    "file",
+    "file_path",
+    "filePath",
+    "files",
+    "path",
+    "paths",
+    "target",
+    "targets",
+    "target_path",
+    "targetPath",
+    "notebook_path",
+    "notebookPath",
+    "output_path",
+    "outputPath",
+]);
+const PATH_ARGUMENT_CONTAINER_KEYS = new Set([
+    "edits",
+    "operations",
+    "patches",
+]);
+const PATCH_ARGUMENT_KEYS = new Set(["patch", "patch_text", "patchText"]);
+function normalizeMutationPath(value, cwd = process.cwd()) {
+    const input = value.trim().replace(/\\/g, "/");
+    if (!input || /[*?[\]{}]/u.test(input)) {
+        return undefined;
+    }
+    const basePath = cwd.replace(/\\/g, "/");
+    let normalized = (isAbsolute(input) ? resolve(input) : resolve(basePath, input))
+        .replace(/\\/g, "/")
+        .replace(/\/+/g, "/");
+    normalized = normalized.toLowerCase();
+    if (normalized.length > 1) {
+        normalized = normalized.replace(/\/$/u, "");
+    }
+    return normalized || undefined;
+}
+function collectPathArgumentValues(value, paths, cwd, matchedKeys, stringIsPath) {
+    if (typeof value === "string") {
+        if (stringIsPath) {
+            const path = normalizeMutationPath(value, cwd);
+            if (path) {
+                paths.push(path);
+            }
+        }
+        return;
+    }
+    if (Array.isArray(value)) {
+        for (const entry of value) {
+            collectPathArgumentValues(entry, paths, cwd, matchedKeys, stringIsPath);
+        }
+        return;
+    }
+    if (value && typeof value === "object") {
+        for (const [key, nested] of Object.entries(value)) {
+            if (PATH_ARGUMENT_KEYS.has(key)) {
+                matchedKeys.add(key);
+                collectPathArgumentValues(nested, paths, cwd, matchedKeys, true);
+                continue;
+            }
+            if (PATCH_ARGUMENT_KEYS.has(key)) {
+                matchedKeys.add(key);
+                collectPatchHeaderPaths(nested, paths, cwd, matchedKeys);
+                continue;
+            }
+            if (PATH_ARGUMENT_CONTAINER_KEYS.has(key)) {
+                matchedKeys.add(key);
+                collectPathArgumentValues(nested, paths, cwd, matchedKeys, false);
+            }
+        }
+    }
+}
+function collectPatchHeaderPaths(value, paths, cwd, matchedKeys) {
+    if (typeof value === "string") {
+        for (const match of value.matchAll(/^\*\*\* (?:Update File|Add File|Delete File|Move to):\s+(.+)$/gmu)) {
+            const rawPath = match[1]?.trim();
+            if (!rawPath)
+                continue;
+            const path = normalizeMutationPath(rawPath, cwd);
+            if (path) {
+                paths.push(path);
+                matchedKeys.add("patch");
+            }
+        }
+        return;
+    }
+    if (Array.isArray(value)) {
+        for (const entry of value) {
+            collectPatchHeaderPaths(entry, paths, cwd, matchedKeys);
+        }
+        return;
+    }
+    if (value && typeof value === "object") {
+        collectPathArgumentValues(value, paths, cwd, matchedKeys, false);
+    }
+}
+export function getPathScopedMutation(toolCall, tool, cwd = process.cwd()) {
+    const annotations = tool?.annotations;
+    const source = annotations?.pathScopedMutationHint === true ? "annotation" : "known_tool";
+    const isPathScopedTool = annotations?.pathScopedMutationHint === true ||
+        PATH_SCOPED_MUTATION_TOOLS.has(tool?.name ?? toolCall.name);
+    if (!isPathScopedTool || annotations?.readOnlyHint === true) {
+        return undefined;
+    }
+    const args = toolCall.arguments &&
+        typeof toolCall.arguments === "object" &&
+        !Array.isArray(toolCall.arguments)
+        ? toolCall.arguments
+        : undefined;
+    if (!args) {
+        return undefined;
+    }
+    const paths = [];
+    const matchedKeys = new Set();
+    for (const [key, value] of Object.entries(args)) {
+        if (PATH_ARGUMENT_KEYS.has(key)) {
+            matchedKeys.add(key);
+            collectPathArgumentValues(value, paths, cwd, matchedKeys, true);
+            continue;
+        }
+        if (PATCH_ARGUMENT_KEYS.has(key)) {
+            matchedKeys.add(key);
+            collectPatchHeaderPaths(value, paths, cwd, matchedKeys);
+            continue;
+        }
+        if (PATH_ARGUMENT_CONTAINER_KEYS.has(key)) {
+            matchedKeys.add(key);
+            collectPathArgumentValues(value, paths, cwd, matchedKeys, false);
+        }
+    }
+    const uniquePaths = [...new Set(paths)];
+    return uniquePaths.length > 0
+        ? { paths: uniquePaths, source, argumentKeys: [...matchedKeys].sort() }
+        : undefined;
+}
+export function pathScopesOverlap(left, right) {
+    return left.paths.some((leftPath) => right.paths.some((rightPath) => leftPath === rightPath ||
+        leftPath.startsWith(`${rightPath}/`) ||
+        rightPath.startsWith(`${leftPath}/`)));
+}
 /**
  * Add read-only annotation to a tool definition.
  *

package/dist/tools/parallel-execution.js.map

@@ -1 +1 @@
-{"version":3,"file":"parallel-execution.js","sourceRoot":"","sources":["../../src/tools/parallel-execution.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * Parallel Execution - Optimized concurrent tool execution for read-only operations\n *\n * This module provides utilities for safely increasing concurrency when executing\n * read-only tools. Read-only tools can run in parallel without risk of conflicts,\n * enabling significant latency improvements for batch operations.\n *\n * ## Read-Only Tools\n *\n * Tools are considered read-only if they:\n * - Do not modify files or system state\n * - Are idempotent (same input = same output)\n * - Have no side effects on external systems\n *\n * Examples: read, list, find, search, diff, status\n *\n * ## Usage\n *\n * ```typescript\n * import { isReadOnlyTool, getOptimalConcurrency } from './parallel-execution.js';\n *\n * const tools = [readTool, listTool, findTool];\n * const allReadOnly = tools.every(t => isReadOnlyTool(t.name));\n * const concurrency = getOptimalConcurrency(tools, baseConcurrency);\n * ```\n *\n * @module tools/parallel-execution\n */\n\nimport type { AgentTool, ToolAnnotations } from \"../agent/types.js\";\n\n/**\n * Set of known read-only tool names.\n *\n * These tools are safe to execute in parallel because they:\n * - Only read data, never modify it\n * - Have no side effects\n * - Are idempotent\n */\nexport const READ_ONLY_TOOLS = new Set([\n\t// File reading\n\t\"Read\",\n\t\"read\",\n\t// Directory listing\n\t\"LS\",\n\t\"list\",\n\t// File finding\n\t\"Glob\",\n\t\"find\",\n\t// Content search\n\t\"Grep\",\n\t\"search\",\n\t\"parallel_ripgrep\",\n\t// Git operations (read-only)\n\t\"diff\",\n\t// System info\n\t\"status\",\n\t// Document extraction\n\t\"extract_document\",\n\t// VS Code read operations\n\t\"vscode_get_definition\",\n\t\"vscode_find_references\",\n\t\"vscode_get_diagnostics\",\n\t\"vscode_read_file_range\",\n\t// JetBrains read operations\n\t\"jetbrains_get_definition\",\n\t\"jetbrains_find_references\",\n\t\"jetbrains_get_diagnostics\",\n\t\"jetbrains_read_file_range\",\n\t// LSP operations (read-only)\n\t\"LSP\",\n]);\n\n/**\n * Set of known write/mutating tool names.\n *\n * These tools modify state and should not run concurrently with\n * operations on the same resources.\n */\nexport const WRITE_TOOLS = new Set([\n\t\"write\",\n\t\"Write\",\n\t\"edit\",\n\t\"Edit\",\n\t\"MultiEdit\",\n\t\"notebook_edit\",\n\t\"NotebookEdit\",\n\t\"bash\",\n\t\"Bash\",\n\t\"background_tasks\",\n]);\n\n/**\n * Check if a tool is read-only based on its name or annotations.\n *\n * @param toolName - Name of the tool\n * @param annotations - Optional tool annotations\n * @returns true if the tool is read-only\n */\nexport function isReadOnlyTool(\n\ttoolName: string,\n\tannotations?: ToolAnnotations,\n): boolean {\n\t// Check explicit annotation first\n\tif (annotations?.readOnlyHint === true) {\n\t\treturn true;\n\t}\n\tif (annotations?.readOnlyHint === false) {\n\t\treturn false;\n\t}\n\n\t// Fall back to known tool lists\n\treturn READ_ONLY_TOOLS.has(toolName);\n}\n\n/**\n * Check if a tool is a write/mutating operation.\n *\n * @param toolName - Name of the tool\n * @param annotations - Optional tool annotations\n * @returns true if the tool modifies state\n */\nexport function isWriteTool(\n\ttoolName: string,\n\tannotations?: ToolAnnotations,\n): boolean {\n\t// Check explicit annotation\n\tif (annotations?.destructiveHint === true) {\n\t\treturn true;\n\t}\n\n\treturn WRITE_TOOLS.has(toolName);\n}\n\n/**\n * Configuration for parallel execution optimization.\n */\nexport interface ParallelExecutionConfig {\n\t/** Base concurrency limit (default: 2) */\n\tbaseConcurrency?: number;\n\t/** Maximum concurrency for read-only batches (default: 8) */\n\tmaxReadOnlyConcurrency?: number;\n\t/** Whether to enable parallel optimization (default: true) */\n\tenabled?: boolean;\n}\n\n/**\n * Get the optimal concurrency level for a batch of tool calls.\n *\n * When all tools in a batch are read-only, we can safely increase\n * concurrency to improve latency. Write operations force serialization.\n *\n * @param toolCalls - Array of tool calls to analyze\n * @param tools - Tool definitions (for annotation lookup)\n * @param config - Parallel execution configuration\n * @returns Optimal concurrency level for this batch\n */\nexport function getOptimalConcurrency(\n\ttoolCalls: Array<{ name: string }>,\n\ttools: AgentTool[],\n\tconfig?: ParallelExecutionConfig,\n): number {\n\tconst baseConcurrency = config?.baseConcurrency ?? 2;\n\tconst maxReadOnlyConcurrency = config?.maxReadOnlyConcurrency ?? 8;\n\tconst enabled = config?.enabled ?? true;\n\n\tif (!enabled || toolCalls.length === 0) {\n\t\treturn baseConcurrency;\n\t}\n\n\t// Build a map of tool names to annotations\n\tconst toolAnnotations = new Map<string, ToolAnnotations | undefined>();\n\tfor (const tool of tools) {\n\t\ttoolAnnotations.set(tool.name, tool.annotations);\n\t}\n\n\t// Check if all tools are read-only\n\tconst allReadOnly = toolCalls.every((call) =>\n\t\tisReadOnlyTool(call.name, toolAnnotations.get(call.name)),\n\t);\n\n\tif (allReadOnly) {\n\t\t// Safe to use higher concurrency\n\t\treturn Math.min(maxReadOnlyConcurrency, toolCalls.length);\n\t}\n\n\t// Has write operations - use base concurrency\n\treturn baseConcurrency;\n}\n\n/**\n * Partition tool calls into read-only and write batches.\n *\n * This enables executing all read-only operations in parallel first,\n * then executing write operations with appropriate ordering.\n *\n * @param toolCalls - Array of tool calls\n * @param tools - Tool definitions\n * @returns Object with readOnly and write arrays\n */\nexport function partitionToolCalls<T extends { name: string }>(\n\ttoolCalls: T[],\n\ttools: AgentTool[],\n): { readOnly: T[]; write: T[] } {\n\tconst toolAnnotations = new Map<string, ToolAnnotations | undefined>();\n\tfor (const tool of tools) {\n\t\ttoolAnnotations.set(tool.name, tool.annotations);\n\t}\n\n\tconst readOnly: T[] = [];\n\tconst write: T[] = [];\n\n\tfor (const call of toolCalls) {\n\t\tif (isReadOnlyTool(call.name, toolAnnotations.get(call.name))) {\n\t\t\treadOnly.push(call);\n\t\t} else {\n\t\t\twrite.push(call);\n\t\t}\n\t}\n\n\treturn { readOnly, write };\n}\n\n/**\n * Add read-only annotation to a tool definition.\n *\n * Use this to mark custom tools as read-only for parallel execution.\n *\n * @param tool - Tool definition to annotate\n * @returns Tool with readOnlyHint annotation\n */\nexport function markReadOnly<T extends AgentTool>(tool: T): T {\n\treturn {\n\t\t...tool,\n\t\tannotations: {\n\t\t\t...tool.annotations,\n\t\t\treadOnlyHint: true,\n\t\t},\n\t};\n}\n\n/**\n * Add write/destructive annotation to a tool definition.\n *\n * @param tool - Tool definition to annotate\n * @returns Tool with destructiveHint annotation\n */\nexport function markDestructive<T extends AgentTool>(tool: T): T {\n\treturn {\n\t\t...tool,\n\t\tannotations: {\n\t\t\t...tool.annotations,\n\t\t\tdestructiveHint: true,\n\t\t},\n\t};\n}\n"]}
+{"version":3,"file":"parallel-execution.js","sourceRoot":"","sources":["../../src/tools/parallel-execution.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * Parallel Execution - Optimized concurrent tool execution for read-only operations\n *\n * This module provides utilities for safely increasing concurrency when executing\n * read-only tools. Read-only tools can run in parallel without risk of conflicts,\n * enabling significant latency improvements for batch operations.\n *\n * ## Read-Only Tools\n *\n * Tools are considered read-only if they:\n * - Do not modify files or system state\n * - Are idempotent (same input = same output)\n * - Have no side effects on external systems\n *\n * Examples: read, list, find, search, diff, status\n *\n * ## Usage\n *\n * ```typescript\n * import { isReadOnlyTool, getOptimalConcurrency } from './parallel-execution.js';\n *\n * const tools = [readTool, listTool, findTool];\n * const allReadOnly = tools.every(t => isReadOnlyTool(t.name));\n * const concurrency = getOptimalConcurrency(tools, baseConcurrency);\n * ```\n *\n * @module tools/parallel-execution\n */\n\nimport { isAbsolute, resolve } from \"node:path\";\nimport type {\n\tAgentTool,\n\tToolAnnotations,\n\tToolSourceMetadata,\n} from \"../agent/types.js\";\n\n/**\n * Set of known read-only tool names.\n *\n * These tools are safe to execute in parallel because they:\n * - Only read data, never modify it\n * - Have no side effects\n * - Are idempotent\n */\nexport const READ_ONLY_TOOLS = new Set([\n\t// File reading\n\t\"Read\",\n\t\"read\",\n\t// Directory listing\n\t\"LS\",\n\t\"list\",\n\t// File finding\n\t\"Glob\",\n\t\"find\",\n\t// Content search\n\t\"Grep\",\n\t\"search\",\n\t\"parallel_ripgrep\",\n\t// Git operations (read-only)\n\t\"diff\",\n\t// System info\n\t\"status\",\n\t// Document extraction\n\t\"extract_document\",\n\t// VS Code read operations\n\t\"vscode_get_definition\",\n\t\"vscode_find_references\",\n\t\"vscode_get_diagnostics\",\n\t\"vscode_read_file_range\",\n\t// JetBrains read operations\n\t\"jetbrains_get_definition\",\n\t\"jetbrains_find_references\",\n\t\"jetbrains_get_diagnostics\",\n\t\"jetbrains_read_file_range\",\n\t// LSP operations (read-only)\n\t\"LSP\",\n]);\n\n/**\n * Set of known write/mutating tool names.\n *\n * These tools modify state and should not run concurrently with\n * operations on the same resources.\n */\nexport const WRITE_TOOLS = new Set([\n\t\"apply_patch\",\n\t\"write\",\n\t\"Write\",\n\t\"edit\",\n\t\"Edit\",\n\t\"MultiEdit\",\n\t\"notebook_edit\",\n\t\"NotebookEdit\",\n\t\"bash\",\n\t\"Bash\",\n\t\"background_tasks\",\n]);\n\n/**\n * Check if a tool is read-only based on its name or annotations.\n *\n * @param toolName - Name of the tool\n * @param annotations - Optional tool annotations\n * @returns true if the tool is read-only\n */\nexport function isReadOnlyTool(\n\ttoolName: string,\n\tannotations?: ToolAnnotations,\n\t_source?: ToolSourceMetadata,\n): boolean {\n\t// Check explicit annotation first\n\tif (annotations?.readOnlyHint === true) {\n\t\treturn true;\n\t}\n\tif (annotations?.readOnlyHint === false) {\n\t\treturn false;\n\t}\n\n\t// Fall back to known tool lists\n\treturn READ_ONLY_TOOLS.has(toolName);\n}\n\nexport function isParallelSafeTool(\n\ttoolName: string,\n\tannotations?: ToolAnnotations,\n\tsource?: ToolSourceMetadata,\n): boolean {\n\tif (isReadOnlyTool(toolName, annotations, source)) {\n\t\treturn true;\n\t}\n\tif (annotations?.destructiveHint === true) {\n\t\treturn false;\n\t}\n\treturn source?.type === \"mcp\" && source.supportsParallelToolCalls === true;\n}\n\n/**\n * Check if a tool is a write/mutating operation.\n *\n * @param toolName - Name of the tool\n * @param annotations - Optional tool annotations\n * @returns true if the tool modifies state\n */\nexport function isWriteTool(\n\ttoolName: string,\n\tannotations?: ToolAnnotations,\n): boolean {\n\t// Check explicit annotation\n\tif (annotations?.destructiveHint === true) {\n\t\treturn true;\n\t}\n\n\treturn WRITE_TOOLS.has(toolName);\n}\n\n/**\n * Configuration for parallel execution optimization.\n */\nexport interface ParallelExecutionConfig {\n\t/** Base concurrency limit (default: 2) */\n\tbaseConcurrency?: number;\n\t/** Maximum concurrency for read-only batches (default: 8) */\n\tmaxReadOnlyConcurrency?: number;\n\t/** Whether to enable parallel optimization (default: true) */\n\tenabled?: boolean;\n}\n\n/**\n * Get the optimal concurrency level for a batch of tool calls.\n *\n * When all tools in a batch are read-only, we can safely increase\n * concurrency to improve latency. Write operations force serialization.\n *\n * @param toolCalls - Array of tool calls to analyze\n * @param tools - Tool definitions (for annotation lookup)\n * @param config - Parallel execution configuration\n * @returns Optimal concurrency level for this batch\n */\nexport function getOptimalConcurrency(\n\ttoolCalls: Array<{ name: string }>,\n\ttools: AgentTool[],\n\tconfig?: ParallelExecutionConfig,\n): number {\n\tconst baseConcurrency = config?.baseConcurrency ?? 2;\n\tconst maxReadOnlyConcurrency = config?.maxReadOnlyConcurrency ?? 8;\n\tconst enabled = config?.enabled ?? true;\n\n\tif (!enabled || toolCalls.length === 0) {\n\t\treturn baseConcurrency;\n\t}\n\n\t// Build a map of tool names to annotations\n\tconst toolMetadata = new Map<\n\t\tstring,\n\t\t{ annotations?: ToolAnnotations; source?: ToolSourceMetadata }\n\t>();\n\tfor (const tool of tools) {\n\t\ttoolMetadata.set(tool.name, {\n\t\t\tannotations: tool.annotations,\n\t\t\tsource: tool.source,\n\t\t});\n\t}\n\n\t// Check if all tools are read-only\n\tconst allReadOnly = toolCalls.every((call) => {\n\t\tconst metadata = toolMetadata.get(call.name);\n\t\treturn isReadOnlyTool(call.name, metadata?.annotations, metadata?.source);\n\t});\n\n\tif (allReadOnly) {\n\t\t// Safe to use higher concurrency\n\t\treturn Math.min(maxReadOnlyConcurrency, toolCalls.length);\n\t}\n\n\t// Has write operations - use base concurrency\n\treturn baseConcurrency;\n}\n\n/**\n * Partition tool calls into read-only and write batches.\n *\n * This enables executing all read-only operations in parallel first,\n * then executing write operations with appropriate ordering.\n *\n * @param toolCalls - Array of tool calls\n * @param tools - Tool definitions\n * @returns Object with readOnly and write arrays\n */\nexport function partitionToolCalls<T extends { name: string }>(\n\ttoolCalls: T[],\n\ttools: AgentTool[],\n): { readOnly: T[]; write: T[] } {\n\tconst toolMetadata = new Map<\n\t\tstring,\n\t\t{ annotations?: ToolAnnotations; source?: ToolSourceMetadata }\n\t>();\n\tfor (const tool of tools) {\n\t\ttoolMetadata.set(tool.name, {\n\t\t\tannotations: tool.annotations,\n\t\t\tsource: tool.source,\n\t\t});\n\t}\n\n\tconst readOnly: T[] = [];\n\tconst write: T[] = [];\n\n\tfor (const call of toolCalls) {\n\t\tconst metadata = toolMetadata.get(call.name);\n\t\tif (isReadOnlyTool(call.name, metadata?.annotations, metadata?.source)) {\n\t\t\treadOnly.push(call);\n\t\t} else {\n\t\t\twrite.push(call);\n\t\t}\n\t}\n\n\treturn { readOnly, write };\n}\n\nexport interface PathScopedMutation {\n\tpaths: string[];\n\tsource: \"annotation\" | \"known_tool\";\n\targumentKeys?: string[];\n}\n\nconst PATH_SCOPED_MUTATION_TOOLS = new Set([\n\t\"apply_patch\",\n\t\"write\",\n\t\"Write\",\n\t\"edit\",\n\t\"Edit\",\n\t\"MultiEdit\",\n\t\"notebook_edit\",\n\t\"NotebookEdit\",\n]);\n\nconst PATH_ARGUMENT_KEYS = new Set([\n\t\"file\",\n\t\"file_path\",\n\t\"filePath\",\n\t\"files\",\n\t\"path\",\n\t\"paths\",\n\t\"target\",\n\t\"targets\",\n\t\"target_path\",\n\t\"targetPath\",\n\t\"notebook_path\",\n\t\"notebookPath\",\n\t\"output_path\",\n\t\"outputPath\",\n]);\n\nconst PATH_ARGUMENT_CONTAINER_KEYS = new Set([\n\t\"edits\",\n\t\"operations\",\n\t\"patches\",\n]);\n\nconst PATCH_ARGUMENT_KEYS = new Set([\"patch\", \"patch_text\", \"patchText\"]);\n\nfunction normalizeMutationPath(\n\tvalue: string,\n\tcwd = process.cwd(),\n): string | undefined {\n\tconst input = value.trim().replace(/\\\\/g, \"/\");\n\tif (!input || /[*?[\\]{}]/u.test(input)) {\n\t\treturn undefined;\n\t}\n\tconst basePath = cwd.replace(/\\\\/g, \"/\");\n\tlet normalized = (\n\t\tisAbsolute(input) ? resolve(input) : resolve(basePath, input)\n\t)\n\t\t.replace(/\\\\/g, \"/\")\n\t\t.replace(/\\/+/g, \"/\");\n\tnormalized = normalized.toLowerCase();\n\tif (normalized.length > 1) {\n\t\tnormalized = normalized.replace(/\\/$/u, \"\");\n\t}\n\treturn normalized || undefined;\n}\n\nfunction collectPathArgumentValues(\n\tvalue: unknown,\n\tpaths: string[],\n\tcwd: string,\n\tmatchedKeys: Set<string>,\n\tstringIsPath: boolean,\n): void {\n\tif (typeof value === \"string\") {\n\t\tif (stringIsPath) {\n\t\t\tconst path = normalizeMutationPath(value, cwd);\n\t\t\tif (path) {\n\t\t\t\tpaths.push(path);\n\t\t\t}\n\t\t}\n\t\treturn;\n\t}\n\tif (Array.isArray(value)) {\n\t\tfor (const entry of value) {\n\t\t\tcollectPathArgumentValues(entry, paths, cwd, matchedKeys, stringIsPath);\n\t\t}\n\t\treturn;\n\t}\n\tif (value && typeof value === \"object\") {\n\t\tfor (const [key, nested] of Object.entries(\n\t\t\tvalue as Record<string, unknown>,\n\t\t)) {\n\t\t\tif (PATH_ARGUMENT_KEYS.has(key)) {\n\t\t\t\tmatchedKeys.add(key);\n\t\t\t\tcollectPathArgumentValues(nested, paths, cwd, matchedKeys, true);\n\t\t\t\tcontinue;\n\t\t\t}\n\t\t\tif (PATCH_ARGUMENT_KEYS.has(key)) {\n\t\t\t\tmatchedKeys.add(key);\n\t\t\t\tcollectPatchHeaderPaths(nested, paths, cwd, matchedKeys);\n\t\t\t\tcontinue;\n\t\t\t}\n\t\t\tif (PATH_ARGUMENT_CONTAINER_KEYS.has(key)) {\n\t\t\t\tmatchedKeys.add(key);\n\t\t\t\tcollectPathArgumentValues(nested, paths, cwd, matchedKeys, false);\n\t\t\t}\n\t\t}\n\t}\n}\n\nfunction collectPatchHeaderPaths(\n\tvalue: unknown,\n\tpaths: string[],\n\tcwd: string,\n\tmatchedKeys: Set<string>,\n): void {\n\tif (typeof value === \"string\") {\n\t\tfor (const match of value.matchAll(\n\t\t\t/^\\*\\*\\* (?:Update File|Add File|Delete File|Move to):\\s+(.+)$/gmu,\n\t\t)) {\n\t\t\tconst rawPath = match[1]?.trim();\n\t\t\tif (!rawPath) continue;\n\t\t\tconst path = normalizeMutationPath(rawPath, cwd);\n\t\t\tif (path) {\n\t\t\t\tpaths.push(path);\n\t\t\t\tmatchedKeys.add(\"patch\");\n\t\t\t}\n\t\t}\n\t\treturn;\n\t}\n\tif (Array.isArray(value)) {\n\t\tfor (const entry of value) {\n\t\t\tcollectPatchHeaderPaths(entry, paths, cwd, matchedKeys);\n\t\t}\n\t\treturn;\n\t}\n\tif (value && typeof value === \"object\") {\n\t\tcollectPathArgumentValues(value, paths, cwd, matchedKeys, false);\n\t}\n}\n\nexport function getPathScopedMutation(\n\ttoolCall: { name: string; arguments?: unknown },\n\ttool?: AgentTool,\n\tcwd = process.cwd(),\n): PathScopedMutation | undefined {\n\tconst annotations = tool?.annotations;\n\tconst source =\n\t\tannotations?.pathScopedMutationHint === true ? \"annotation\" : \"known_tool\";\n\tconst isPathScopedTool =\n\t\tannotations?.pathScopedMutationHint === true ||\n\t\tPATH_SCOPED_MUTATION_TOOLS.has(tool?.name ?? toolCall.name);\n\tif (!isPathScopedTool || annotations?.readOnlyHint === true) {\n\t\treturn undefined;\n\t}\n\tconst args =\n\t\ttoolCall.arguments &&\n\t\ttypeof toolCall.arguments === \"object\" &&\n\t\t!Array.isArray(toolCall.arguments)\n\t\t\t? (toolCall.arguments as Record<string, unknown>)\n\t\t\t: undefined;\n\tif (!args) {\n\t\treturn undefined;\n\t}\n\tconst paths: string[] = [];\n\tconst matchedKeys = new Set<string>();\n\tfor (const [key, value] of Object.entries(args)) {\n\t\tif (PATH_ARGUMENT_KEYS.has(key)) {\n\t\t\tmatchedKeys.add(key);\n\t\t\tcollectPathArgumentValues(value, paths, cwd, matchedKeys, true);\n\t\t\tcontinue;\n\t\t}\n\t\tif (PATCH_ARGUMENT_KEYS.has(key)) {\n\t\t\tmatchedKeys.add(key);\n\t\t\tcollectPatchHeaderPaths(value, paths, cwd, matchedKeys);\n\t\t\tcontinue;\n\t\t}\n\t\tif (PATH_ARGUMENT_CONTAINER_KEYS.has(key)) {\n\t\t\tmatchedKeys.add(key);\n\t\t\tcollectPathArgumentValues(value, paths, cwd, matchedKeys, false);\n\t\t}\n\t}\n\tconst uniquePaths = [...new Set(paths)];\n\treturn uniquePaths.length > 0\n\t\t? { paths: uniquePaths, source, argumentKeys: [...matchedKeys].sort() }\n\t\t: undefined;\n}\n\nexport function pathScopesOverlap(\n\tleft: PathScopedMutation,\n\tright: PathScopedMutation,\n): boolean {\n\treturn left.paths.some((leftPath) =>\n\t\tright.paths.some(\n\t\t\t(rightPath) =>\n\t\t\t\tleftPath === rightPath ||\n\t\t\t\tleftPath.startsWith(`${rightPath}/`) ||\n\t\t\t\trightPath.startsWith(`${leftPath}/`),\n\t\t),\n\t);\n}\n\n/**\n * Add read-only annotation to a tool definition.\n *\n * Use this to mark custom tools as read-only for parallel execution.\n *\n * @param tool - Tool definition to annotate\n * @returns Tool with readOnlyHint annotation\n */\nexport function markReadOnly<T extends AgentTool>(tool: T): T {\n\treturn {\n\t\t...tool,\n\t\tannotations: {\n\t\t\t...tool.annotations,\n\t\t\treadOnlyHint: true,\n\t\t},\n\t};\n}\n\n/**\n * Add write/destructive annotation to a tool definition.\n *\n * @param tool - Tool definition to annotate\n * @returns Tool with destructiveHint annotation\n */\nexport function markDestructive<T extends AgentTool>(tool: T): T {\n\treturn {\n\t\t...tool,\n\t\tannotations: {\n\t\t\t...tool.annotations,\n\t\t\tdestructiveHint: true,\n\t\t},\n\t};\n}\n"]}

package/dist/tools/parallel-ripgrep.d.ts

@@ -75,6 +75,7 @@ export declare const parallelRipgrepTool: Readonly<{
         headLimit: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TInteger>;
     }>;
     annotations: import("../agent/types.js").ToolAnnotations | undefined;
+    source: import("../agent/types.js").McpToolSourceMetadata | undefined;
     toolType: string | undefined;
     inputExamples: unknown[] | undefined;
     allowedCallers: string[] | undefined;

package/dist/tools/parallel-ripgrep.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"parallel-ripgrep.d.ts","sourceRoot":"","sources":["../../src/tools/parallel-ripgrep.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AA4GH;;;GAGG;AACH,KAAK,WAAW,GAAG;IAClB,gCAAgC;IAChC,IAAI,EAAE,MAAM,CAAC;IACb,kCAAkC;IAClC,KAAK,EAAE,MAAM,CAAC;IACd,4CAA4C;IAC5C,GAAG,EAAE,MAAM,CAAC;IACZ,sDAAsD;IACtD,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,kCAAkC;IAClC,OAAO,EAAE,MAAM,CAAC;CAChB,CAAC;AAEF;;;GAGG;AACH,KAAK,sBAAsB,GAAG;IAC7B,8CAA8C;IAC9C,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,uCAAuC;IACvC,GAAG,EAAE,MAAM,CAAC;IACZ,6DAA6D;IAC7D,UAAU,EAAE,MAAM,CAAC;IACnB,6CAA6C;IAC7C,UAAU,EAAE,MAAM,CAAC;IACnB,8CAA8C;IAC9C,MAAM,EAAE,WAAW,EAAE,CAAC;IACtB,iDAAiD;IACjD,SAAS,EAAE,OAAO,CAAC;CACnB,CAAC;AA+HF,eAAO,MAAM,mBAAmB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EA4N9B,CAAC"}
+{"version":3,"file":"parallel-ripgrep.d.ts","sourceRoot":"","sources":["../../src/tools/parallel-ripgrep.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AA4GH;;;GAGG;AACH,KAAK,WAAW,GAAG;IAClB,gCAAgC;IAChC,IAAI,EAAE,MAAM,CAAC;IACb,kCAAkC;IAClC,KAAK,EAAE,MAAM,CAAC;IACd,4CAA4C;IAC5C,GAAG,EAAE,MAAM,CAAC;IACZ,sDAAsD;IACtD,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,kCAAkC;IAClC,OAAO,EAAE,MAAM,CAAC;CAChB,CAAC;AAEF;;;GAGG;AACH,KAAK,sBAAsB,GAAG;IAC7B,8CAA8C;IAC9C,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,uCAAuC;IACvC,GAAG,EAAE,MAAM,CAAC;IACZ,6DAA6D;IAC7D,UAAU,EAAE,MAAM,CAAC;IACnB,6CAA6C;IAC7C,UAAU,EAAE,MAAM,CAAC;IACnB,8CAA8C;IAC9C,MAAM,EAAE,WAAW,EAAE,CAAC;IACtB,iDAAiD;IACjD,SAAS,EAAE,OAAO,CAAC;CACnB,CAAC;AA+HF,eAAO,MAAM,mBAAmB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EA4N9B,CAAC"}

package/dist/tools/pipeline.d.ts

@@ -60,6 +60,7 @@ export declare const pipelineSearchContactsTool: Readonly<{
         limit: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TInteger>;
     }>;
     annotations: import("../agent/types.js").ToolAnnotations | undefined;
+    source: import("../agent/types.js").McpToolSourceMetadata | undefined;
     toolType: string | undefined;
     inputExamples: unknown[] | undefined;
     allowedCallers: string[] | undefined;
@@ -85,6 +86,7 @@ export declare const pipelineSearchDealsTool: Readonly<{
         limit: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TInteger>;
     }>;
     annotations: import("../agent/types.js").ToolAnnotations | undefined;
+    source: import("../agent/types.js").McpToolSourceMetadata | undefined;
     toolType: string | undefined;
     inputExamples: unknown[] | undefined;
     allowedCallers: string[] | undefined;
@@ -113,6 +115,7 @@ export declare const pipelineCreateSignalTool: Readonly<{
         data: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TAny>;
     }>;
     annotations: import("../agent/types.js").ToolAnnotations | undefined;
+    source: import("../agent/types.js").McpToolSourceMetadata | undefined;
     toolType: string | undefined;
     inputExamples: unknown[] | undefined;
     allowedCallers: string[] | undefined;
@@ -143,6 +146,7 @@ export declare const pipelineLogActivityTool: Readonly<{
         occurredAt: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
     }>;
     annotations: import("../agent/types.js").ToolAnnotations | undefined;
+    source: import("../agent/types.js").McpToolSourceMetadata | undefined;
     toolType: string | undefined;
     inputExamples: unknown[] | undefined;
     allowedCallers: string[] | undefined;

package/dist/tools/pipeline.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"pipeline.d.ts","sourceRoot":"","sources":["../../src/tools/pipeline.ts"],"names":[],"mappings":"AAwCA,MAAM,WAAW,gBAAgB;IAChC,EAAE,EAAE,MAAM,CAAC;IACX,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,WAAW,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,cAAc;IAC9B,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,IAAI,CAAC,EAAE,OAAO,CAAC;CACf;AAuMD,MAAM,WAAW,6BAA6B;IAC7C,QAAQ,EAAE,KAAK,CAAC;QACf,EAAE,EAAE,MAAM,CAAC;QACX,IAAI,EAAE,MAAM,CAAC;QACb,KAAK,CAAC,EAAE,MAAM,CAAC;QACf,KAAK,CAAC,EAAE,MAAM,CAAC;QACf,SAAS,CAAC,EAAE,MAAM,CAAC;QACnB,KAAK,CAAC,EAAE,MAAM,CAAC;QACf,SAAS,CAAC,EAAE,MAAM,CAAC;QACnB,WAAW,CAAC,EAAE,MAAM,CAAC;QACrB,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;KAChB,CAAC,CAAC;IACH,KAAK,EAAE,MAAM,CAAC;CACd;AAED,MAAM,WAAW,0BAA0B;IAC1C,KAAK,EAAE,KAAK,CAAC;QACZ,EAAE,EAAE,MAAM,CAAC;QACX,KAAK,EAAE,MAAM,CAAC;QACd,KAAK,CAAC,EAAE,MAAM,CAAC;QACf,KAAK,CAAC,EAAE,MAAM,CAAC;QACf,QAAQ,CAAC,EAAE,MAAM,CAAC;QAClB,WAAW,CAAC,EAAE,MAAM,CAAC;QACrB,aAAa,CAAC,EAAE,MAAM,CAAC;QACvB,SAAS,CAAC,EAAE,MAAM,CAAC;QACnB,SAAS,CAAC,EAAE,MAAM,CAAC;KACnB,CAAC,CAAC;IACH,KAAK,EAAE,MAAM,CAAC;CACd;AAED,eAAO,MAAM,0BAA0B;;;;;;;;;;;;;;;;;;;;;;;;;;EAmErC,CAAC;AAEH,eAAO,MAAM,uBAAuB;;;;;;;;;;;;;;;;;;;;;;;;EAkElC,CAAC;AAEH,eAAO,MAAM,wBAAwB;;;;;;;;;;;;;;;;;;;;;;;;;;;EAmDnC,CAAC;AAEH,eAAO,MAAM,uBAAuB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAoDlC,CAAC"}
+{"version":3,"file":"pipeline.d.ts","sourceRoot":"","sources":["../../src/tools/pipeline.ts"],"names":[],"mappings":"AAwCA,MAAM,WAAW,gBAAgB;IAChC,EAAE,EAAE,MAAM,CAAC;IACX,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,WAAW,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,cAAc;IAC9B,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,IAAI,CAAC,EAAE,OAAO,CAAC;CACf;AAuMD,MAAM,WAAW,6BAA6B;IAC7C,QAAQ,EAAE,KAAK,CAAC;QACf,EAAE,EAAE,MAAM,CAAC;QACX,IAAI,EAAE,MAAM,CAAC;QACb,KAAK,CAAC,EAAE,MAAM,CAAC;QACf,KAAK,CAAC,EAAE,MAAM,CAAC;QACf,SAAS,CAAC,EAAE,MAAM,CAAC;QACnB,KAAK,CAAC,EAAE,MAAM,CAAC;QACf,SAAS,CAAC,EAAE,MAAM,CAAC;QACnB,WAAW,CAAC,EAAE,MAAM,CAAC;QACrB,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;KAChB,CAAC,CAAC;IACH,KAAK,EAAE,MAAM,CAAC;CACd;AAED,MAAM,WAAW,0BAA0B;IAC1C,KAAK,EAAE,KAAK,CAAC;QACZ,EAAE,EAAE,MAAM,CAAC;QACX,KAAK,EAAE,MAAM,CAAC;QACd,KAAK,CAAC,EAAE,MAAM,CAAC;QACf,KAAK,CAAC,EAAE,MAAM,CAAC;QACf,QAAQ,CAAC,EAAE,MAAM,CAAC;QAClB,WAAW,CAAC,EAAE,MAAM,CAAC;QACrB,aAAa,CAAC,EAAE,MAAM,CAAC;QACvB,SAAS,CAAC,EAAE,MAAM,CAAC;QACnB,SAAS,CAAC,EAAE,MAAM,CAAC;KACnB,CAAC,CAAC;IACH,KAAK,EAAE,MAAM,CAAC;CACd;AAED,eAAO,MAAM,0BAA0B;;;;;;;;;;;;;;;;;;;;;;;;;;;EAmErC,CAAC;AAEH,eAAO,MAAM,uBAAuB;;;;;;;;;;;;;;;;;;;;;;;;;EAkElC,CAAC;AAEH,eAAO,MAAM,wBAAwB;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAmDnC,CAAC;AAEH,eAAO,MAAM,uBAAuB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAoDlC,CAAC"}

package/dist/tools/read.d.ts

@@ -70,6 +70,7 @@ export declare const readTool: Readonly<{
         encoding: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TUnion<[import("@sinclair/typebox").TLiteral<"utf-8">, import("@sinclair/typebox").TLiteral<"utf-16le">, import("@sinclair/typebox").TLiteral<"latin1">, import("@sinclair/typebox").TLiteral<"ascii">]>>;
     }>;
     annotations: import("../agent/types.js").ToolAnnotations | undefined;
+    source: import("../agent/types.js").McpToolSourceMetadata | undefined;
     toolType: string | undefined;
     inputExamples: unknown[] | undefined;
     allowedCallers: string[] | undefined;

package/dist/tools/read.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"read.d.ts","sourceRoot":"","sources":["../../src/tools/read.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AAoOH;;;GAGG;AACH,KAAK,eAAe,GAAG;IACtB,6CAA6C;IAC7C,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,gCAAgC;IAChC,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,8BAA8B;IAC9B,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,wBAAwB;IACxB,IAAI,CAAC,EAAE,MAAM,CAAC;IAEd,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,YAAY,CAAC,EAAE,OAAO,CAAC;CACvB,CAAC;AAEF;;;;;;;;;GASG;AACH,eAAO,MAAM,QAAQ;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EA2ZnB,CAAC"}
+{"version":3,"file":"read.d.ts","sourceRoot":"","sources":["../../src/tools/read.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AAoOH;;;GAGG;AACH,KAAK,eAAe,GAAG;IACtB,6CAA6C;IAC7C,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,gCAAgC;IAChC,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,8BAA8B;IAC9B,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,wBAAwB;IACxB,IAAI,CAAC,EAAE,MAAM,CAAC;IAEd,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,YAAY,CAAC,EAAE,OAAO,CAAC;CACvB,CAAC;AAEF;;;;;;;;;GASG;AACH,eAAO,MAAM,QAAQ;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EA2ZnB,CAAC"}

package/dist/tools/search.d.ts

@@ -90,6 +90,7 @@ export declare const searchTool: Readonly<{
         headLimit: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TInteger>;
     }>;
     annotations: import("../agent/types.js").ToolAnnotations | undefined;
+    source: import("../agent/types.js").McpToolSourceMetadata | undefined;
     toolType: string | undefined;
     inputExamples: unknown[] | undefined;
     allowedCallers: string[] | undefined;

package/dist/tools/search.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"search.d.ts","sourceRoot":"","sources":["../../src/tools/search.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAkDG;AAIH,OAAO,EACN,KAAK,YAAY,EAMjB,MAAM,oBAAoB,CAAC;AAkI5B,KAAK,iBAAiB,GAAG;IACxB,OAAO,EAAE,MAAM,CAAC;IAChB,GAAG,EAAE,MAAM,CAAC;IACZ,MAAM,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,OAAO,CAAC;IAC7C,OAAO,CAAC,EAAE,YAAY,EAAE,CAAC;IACzB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,KAAK,CAAC,EAAE,MAAM,EAAE,CAAC;IACjB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,MAAM,CAAC,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAChD,SAAS,CAAC,EAAE,OAAO,CAAC;CACpB,CAAC;AAEF,eAAO,MAAM,UAAU;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAsUrB,CAAC"}
+{"version":3,"file":"search.d.ts","sourceRoot":"","sources":["../../src/tools/search.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAkDG;AAIH,OAAO,EACN,KAAK,YAAY,EAMjB,MAAM,oBAAoB,CAAC;AAkI5B,KAAK,iBAAiB,GAAG;IACxB,OAAO,EAAE,MAAM,CAAC;IAChB,GAAG,EAAE,MAAM,CAAC;IACZ,MAAM,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,OAAO,CAAC;IAC7C,OAAO,CAAC,EAAE,YAAY,EAAE,CAAC;IACzB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,KAAK,CAAC,EAAE,MAAM,EAAE,CAAC;IACjB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,MAAM,CAAC,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAChD,SAAS,CAAC,EAAE,OAAO,CAAC;CACpB,CAAC;AAEF,eAAO,MAAM,UAAU;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAsUrB,CAAC"}

package/dist/tools/status.d.ts

@@ -9,6 +9,7 @@ export declare const statusTool: Readonly<{
         paths: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TUnion<[import("@sinclair/typebox").TString, import("@sinclair/typebox").TArray<import("@sinclair/typebox").TString>]>>;
     }>;
     annotations: import("../agent/types.js").ToolAnnotations | undefined;
+    source: import("../agent/types.js").McpToolSourceMetadata | undefined;
     toolType: string | undefined;
     inputExamples: unknown[] | undefined;
     allowedCallers: string[] | undefined;

package/dist/tools/status.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"status.d.ts","sourceRoot":"","sources":["../../src/tools/status.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,KAAK,YAAY,EAAqB,MAAM,WAAW,CAAC;AA0EjE,eAAO,MAAM,UAAU;;;;;;;;;;;;;;;;;;;;;;;iBAEX,MAAM;iBAAW,YAAY;;iBAA7B,MAAM;iBAAW,YAAY;;EAyDvC,CAAC"}
+{"version":3,"file":"status.d.ts","sourceRoot":"","sources":["../../src/tools/status.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,KAAK,YAAY,EAAqB,MAAM,WAAW,CAAC;AA0EjE,eAAO,MAAM,UAAU;;;;;;;;;;;;;;;;;;;;;;;;iBAEX,MAAM;iBAAW,YAAY;;iBAA7B,MAAM;iBAAW,YAAY;;EAyDvC,CAAC"}

package/dist/tools/todo.d.ts

@@ -122,6 +122,7 @@ export declare const todoTool: Readonly<{
         includeSummary: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TBoolean>;
     }>;
     annotations: import("../agent/types.js").ToolAnnotations | undefined;
+    source: import("../agent/types.js").McpToolSourceMetadata | undefined;
     toolType: string | undefined;
     inputExamples: unknown[] | undefined;
     allowedCallers: string[] | undefined;

package/dist/tools/todo.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"todo.d.ts","sourceRoot":"","sources":["../../src/tools/todo.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6DG;AAiBH,YAAY,EAAE,cAAc,EAAE,SAAS,EAAE,SAAS,EAAE,CAAC;AAIrD,QAAA,MAAM,aAAa;;;;CAIT,CAAC;AAEX,KAAK,SAAS,GAAG,MAAM,OAAO,aAAa,CAAC;AAqK5C,KAAK,cAAc,GAAG;IACrB,EAAE,EAAE,MAAM,CAAC;IACX,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,SAAS,GAAG,aAAa,GAAG,WAAW,CAAC;IAChD,QAAQ,EAAE,MAAM,GAAG,QAAQ,GAAG,KAAK,CAAC;IACpC,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,SAAS,CAAC,EAAE,MAAM,EAAE,CAAC;CACrB,CAAC;AAEF,KAAK,SAAS,GAAG,MAAM,CACtB,MAAM,EACN;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,cAAc,EAAE,CAAC;IAAC,SAAS,EAAE,MAAM,CAAA;CAAE,CAC5D,CAAC;AAEF,eAAO,MAAM,gBAAgB,QAAmB,CAAC;AAQjD,wBAAsB,SAAS,IAAI,OAAO,CAAC,SAAS,CAAC,CAiBpD;AAED,wBAAsB,SAAS,CAAC,KAAK,EAAE,SAAS,GAAG,OAAO,CAAC,IAAI,CAAC,CAI/D;AAuDD,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAEtD;AAED,wBAAgB,oBAAoB,CACnC,MAAM,EAAE,MAAM,CAAC,SAAS,GAAG,OAAO,EAAE,MAAM,CAAC,GACzC,MAAM,CAYR;AAeD,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,cAAc,EAAE,GAAG,MAAM,CAMlE;AA4BD,KAAK,eAAe,GAAG;IACtB,KAAK,EAAE,cAAc,EAAE,CAAC;IACxB,OAAO,EAAE,MAAM,CAAC;IAChB,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,EAAE,MAAM,CAAC;CACd,CAAC;AAEF,eAAO,MAAM,QAAQ;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EA+GnB,CAAC"}
+{"version":3,"file":"todo.d.ts","sourceRoot":"","sources":["../../src/tools/todo.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6DG;AAiBH,YAAY,EAAE,cAAc,EAAE,SAAS,EAAE,SAAS,EAAE,CAAC;AAIrD,QAAA,MAAM,aAAa;;;;CAIT,CAAC;AAEX,KAAK,SAAS,GAAG,MAAM,OAAO,aAAa,CAAC;AAqK5C,KAAK,cAAc,GAAG;IACrB,EAAE,EAAE,MAAM,CAAC;IACX,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,SAAS,GAAG,aAAa,GAAG,WAAW,CAAC;IAChD,QAAQ,EAAE,MAAM,GAAG,QAAQ,GAAG,KAAK,CAAC;IACpC,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,SAAS,CAAC,EAAE,MAAM,EAAE,CAAC;CACrB,CAAC;AAEF,KAAK,SAAS,GAAG,MAAM,CACtB,MAAM,EACN;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,cAAc,EAAE,CAAC;IAAC,SAAS,EAAE,MAAM,CAAA;CAAE,CAC5D,CAAC;AAEF,eAAO,MAAM,gBAAgB,QAAmB,CAAC;AAQjD,wBAAsB,SAAS,IAAI,OAAO,CAAC,SAAS,CAAC,CAiBpD;AAED,wBAAsB,SAAS,CAAC,KAAK,EAAE,SAAS,GAAG,OAAO,CAAC,IAAI,CAAC,CAI/D;AAuDD,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAEtD;AAED,wBAAgB,oBAAoB,CACnC,MAAM,EAAE,MAAM,CAAC,SAAS,GAAG,OAAO,EAAE,MAAM,CAAC,GACzC,MAAM,CAYR;AAeD,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,cAAc,EAAE,GAAG,MAAM,CAMlE;AA4BD,KAAK,eAAe,GAAG;IACtB,KAAK,EAAE,cAAc,EAAE,CAAC;IACxB,OAAO,EAAE,MAAM,CAAC;IAChB,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,EAAE,MAAM,CAAC;CACd,CAAC;AAEF,eAAO,MAAM,QAAQ;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EA+GnB,CAAC"}

package/dist/tools/tool-dsl.d.ts

@@ -64,7 +64,7 @@
  * @module tools/tool-dsl
  */
 import type { Static, TSchema } from "@sinclair/typebox";
-import type { AgentToolResult, AgentToolUpdateCallback, ToolAnnotations } from "../agent/types.js";
+import type { AgentToolResult, AgentToolUpdateCallback, ToolAnnotations, ToolSourceMetadata } from "../agent/types.js";
 import type { Sandbox } from "../sandbox/types.js";
 export declare class ToolResponseBuilder<Details> {
     private _content;
@@ -89,6 +89,7 @@ export interface CreateToolOptions<Schema extends TSchema, Details> {
     description: string;
     schema: Schema;
     annotations?: ToolAnnotations;
+    source?: ToolSourceMetadata;
     toolType?: string;
     inputExamples?: unknown[];
     allowedCallers?: string[];
@@ -112,6 +113,7 @@ export declare function createTool<Schema extends TSchema, Details = undefined>(
     description: string;
     parameters: Schema;
     annotations: ToolAnnotations | undefined;
+    source: import("../agent/types.js").McpToolSourceMetadata | undefined;
     toolType: string | undefined;
     inputExamples: unknown[] | undefined;
     allowedCallers: string[] | undefined;
@@ -142,6 +144,7 @@ export declare function createTextTool<Schema extends TSchema, Details = undefin
     description: string;
     parameters: Schema;
     annotations: ToolAnnotations | undefined;
+    source: import("../agent/types.js").McpToolSourceMetadata | undefined;
     toolType: string | undefined;
     inputExamples: unknown[] | undefined;
     allowedCallers: string[] | undefined;
@@ -165,6 +168,7 @@ export declare function createJsonTool<Schema extends TSchema, Details = undefin
     description: string;
     parameters: Schema;
     annotations: ToolAnnotations | undefined;
+    source: import("../agent/types.js").McpToolSourceMetadata | undefined;
     toolType: string | undefined;
     inputExamples: unknown[] | undefined;
     allowedCallers: string[] | undefined;

package/dist/tools/tool-dsl.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"tool-dsl.d.ts","sourceRoot":"","sources":["../../src/tools/tool-dsl.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"tool-dsl.d.ts","sourceRoot":"","sources":["../../src/tools/tool-dsl.ts"],"names":[],"mappings":"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"}

package/dist/tools/tool-dsl.js

@@ -140,6 +140,7 @@ export function createTool(options) {
         description: options.description,
         parameters: options.schema,
         annotations: options.annotations,
+        source: options.source,
         toolType: options.toolType,
         inputExamples: options.inputExamples,
         allowedCallers: options.allowedCallers,

package/dist/tools/tool-dsl.js.map

@@ -1 +1 @@
-{"version":3,"file":"tool-dsl.js","sourceRoot":"","sources":["../../src/tools/tool-dsl.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * Tool DSL - Domain-Specific Language for Creating Agent Tools\n *\n * This module provides a fluent, type-safe API for defining tools that can be\n * executed by the Composer agent. It handles schema validation, response building,\n * retry logic, and sandbox integration.\n *\n * ## Architecture\n *\n * ```\n * ┌─────────────────────────────────────────────────────────────────┐\n * │                     Tool Creation Flow                          │\n * ├─────────────────────────────────────────────────────────────────┤\n * │  createTool(options)                                            │\n * │       │                                                         │\n * │       ▼                                                         │\n * │  ┌─────────────┐    ┌──────────────┐    ┌─────────────────┐    │\n * │  │   Schema    │───▶│  Validator   │───▶│   execute()     │    │\n * │  │  (TypeBox)  │    │   (AJV)      │    │   function      │    │\n * │  └─────────────┘    └──────────────┘    └─────────────────┘    │\n * │                                               │                 │\n * │                                               ▼                 │\n * │                     ┌─────────────────────────────────────┐     │\n * │                     │  ToolResponseBuilder                │     │\n * │                     │  - text(), image(), error()         │     │\n * │                     │  - detail() for structured data     │     │\n * │                     └─────────────────────────────────────┘     │\n * └─────────────────────────────────────────────────────────────────┘\n * ```\n *\n * ## Tool Types\n *\n * | Factory       | Return Type      | Use Case                          |\n * |---------------|------------------|-----------------------------------|\n * | createTool    | AgentToolResult  | Full control over response        |\n * | createTextTool| string → text    | Simple text responses             |\n * | createJsonTool| object → JSON    | Structured data responses         |\n *\n * ## Example\n *\n * ```typescript\n * import { createTool, Type } from './tool-dsl';\n *\n * const greetTool = createTool({\n *   name: 'greet',\n *   description: 'Greet a user by name',\n *   schema: Type.Object({\n *     name: Type.String({ description: 'Name to greet' }),\n *   }),\n *   run: async ({ name }, { respond }) => {\n *     return respond.text(`Hello, ${name}!`);\n *   },\n * });\n * ```\n *\n * ## Features\n *\n * - **Type-safe schemas**: Uses TypeBox for compile-time type inference\n * - **AJV validation**: Runtime validation with format support\n * - **Retry logic**: Built-in exponential backoff for transient failures\n * - **Sandbox support**: Tools can run in isolated environments\n * - **Context interpolation**: Environment variables and paths\n *\n * @module tools/tool-dsl\n */\n\nimport type { Static, TSchema } from \"@sinclair/typebox\";\nimport { Ajv, type ErrorObject, type ValidateFunction } from \"ajv\";\nimport addFormatsModule, { type FormatsPlugin } from \"ajv-formats\";\nimport type {\n\tAgentToolResult,\n\tAgentToolUpdateCallback,\n\tToolAnnotations,\n} from \"../agent/types.js\";\nimport type { Sandbox } from \"../sandbox/types.js\";\nimport { resolveDefaultExport } from \"../utils/module-interop.js\";\n\n// ESM/CJS interop: ajv-formats default may be nested under .default in some loaders\nconst addFormats = resolveDefaultExport<FormatsPlugin>(addFormatsModule);\n\n// Create a singleton AJV instance for schema validation\nlet ajv: Ajv | null = null;\ntry {\n\tajv = new Ajv({\n\t\t// Avoid unbounded error collection on large/invalid payloads\n\t\tallErrors: false,\n\t\tstrict: false,\n\t\tuseDefaults: true, // Apply schema defaults to input\n\t});\n\taddFormats(ajv);\n} catch {\n\t// AJV initialization failed (likely CSP restriction)\n\tajv = null;\n}\n\n// Cache compiled validators per schema to avoid recompiling on every execute()\nconst validatorCache = new WeakMap<TSchema, ValidateFunction>();\n\nfunction getOrCompileValidator(schema: TSchema): ValidateFunction | null {\n\tif (!ajv) return null;\n\n\tlet validate = validatorCache.get(schema);\n\tif (!validate) {\n\t\tvalidate = ajv.compile(schema);\n\t\tvalidatorCache.set(schema, validate);\n\t}\n\treturn validate;\n}\n\nexport class ToolResponseBuilder<Details> {\n\tprivate _content: (\n\t\t| { type: \"text\"; text: string }\n\t\t| { type: \"image\"; data: string; mimeType: string }\n\t)[] = [];\n\tprivate _details?: Details;\n\tprivate _isError = false;\n\n\ttext(content: string): this {\n\t\tthis._content.push({ type: \"text\", text: content });\n\t\treturn this;\n\t}\n\n\timage(base64: string, mimeType: string): this {\n\t\tthis._content.push({ type: \"image\", data: base64, mimeType });\n\t\treturn this;\n\t}\n\n\tdetail(details: Details): this {\n\t\tthis._details = details;\n\t\treturn this;\n\t}\n\n\terror(message: string): this {\n\t\tthis.text(message);\n\t\tthis._isError = true;\n\t\treturn this;\n\t}\n\n\tbuild(): AgentToolResult<Details> {\n\t\treturn {\n\t\t\tcontent: this._content,\n\t\t\tdetails: this._details,\n\t\t\tisError: this._isError,\n\t\t};\n\t}\n}\n\nexport interface ToolRunContext<Details> {\n\ttoolCallId: string;\n\tsignal?: AbortSignal;\n\trespond: ToolResponseBuilder<Details>;\n\tsandbox?: Sandbox;\n\tonUpdate?: AgentToolUpdateCallback<Details>;\n}\n\nexport interface CreateToolOptions<Schema extends TSchema, Details> {\n\tname: string;\n\tlabel?: string;\n\tdescription: string;\n\tschema: Schema;\n\tannotations?: ToolAnnotations;\n\ttoolType?: string;\n\tinputExamples?: unknown[];\n\tallowedCallers?: string[];\n\tdeferApiDefinition?: boolean;\n\trun: (\n\t\tparams: import(\"@sinclair/typebox\").Static<Schema>,\n\t\tcontext: ToolRunContext<Details>,\n\t) =>\n\t\t| undefined\n\t\t| ToolResponseBuilder<Details>\n\t\t| AgentToolResult<Details>\n\t\t| Promise<\n\t\t\t\tundefined | ToolResponseBuilder<Details> | AgentToolResult<Details>\n\t\t  >;\n\tmaxRetries?: number;\n\tretryDelayMs?: number;\n\tshouldRetry?: (error: unknown) => boolean;\n\tgetToolUseSummary?: (params: Static<Schema>) => string | null;\n\tgetDisplayName?: (params: Static<Schema>) => string | null;\n\tgetActivityDescription?: (params: Static<Schema>) => string | null;\n}\n\ntype StaticSchema<Schema extends TSchema> = Static<Schema>;\n\nexport class ToolError extends Error {\n\tconstructor(\n\t\tmessage: string,\n\t\tpublic readonly code?: string,\n\t\tpublic readonly details?: unknown,\n\t) {\n\t\tsuper(message);\n\t\tthis.name = \"ToolError\";\n\t}\n}\n\nexport function createTool<Schema extends TSchema, Details = undefined>(\n\toptions: CreateToolOptions<Schema, Details>,\n) {\n\treturn Object.freeze({\n\t\tname: options.name,\n\t\tlabel: options.label ?? options.name,\n\t\tdescription: options.description,\n\t\tparameters: options.schema,\n\t\tannotations: options.annotations,\n\t\ttoolType: options.toolType,\n\t\tinputExamples: options.inputExamples,\n\t\tallowedCallers: options.allowedCallers,\n\t\tdeferApiDefinition: options.deferApiDefinition,\n\t\tmaxRetries: options.maxRetries,\n\t\tretryDelayMs: options.retryDelayMs,\n\t\tshouldRetry: options.shouldRetry,\n\t\tgetToolUseSummary: options.getToolUseSummary\n\t\t\t? (params: Record<string, unknown>) =>\n\t\t\t\t\toptions.getToolUseSummary?.(params as StaticSchema<Schema>) ?? null\n\t\t\t: undefined,\n\t\tgetDisplayName: options.getDisplayName\n\t\t\t? (params: Record<string, unknown>) =>\n\t\t\t\t\toptions.getDisplayName?.(params as StaticSchema<Schema>) ?? null\n\t\t\t: undefined,\n\t\tgetActivityDescription: options.getActivityDescription\n\t\t\t? (params: Record<string, unknown>) =>\n\t\t\t\t\toptions.getActivityDescription?.(params as StaticSchema<Schema>) ??\n\t\t\t\t\tnull\n\t\t\t: undefined,\n\t\texecute: async (\n\t\t\ttoolCallId: string,\n\t\t\tparams: Record<string, unknown>,\n\t\t\tsignal?: AbortSignal,\n\t\t\tcontext?: { sandbox?: Sandbox },\n\t\t\tonUpdate?: AgentToolUpdateCallback<Details>,\n\t\t) => {\n\t\t\t// Validate params against schema using cached validator\n\t\t\tif (options.schema) {\n\t\t\t\tconst validate = getOrCompileValidator(options.schema);\n\t\t\t\tif (validate && !validate(params)) {\n\t\t\t\t\tconst errors =\n\t\t\t\t\t\t(validate.errors ?? [])\n\t\t\t\t\t\t\t.map((err) => {\n\t\t\t\t\t\t\t\tconst path =\n\t\t\t\t\t\t\t\t\terr.instancePath && err.instancePath.length > 1\n\t\t\t\t\t\t\t\t\t\t? err.instancePath.substring(1)\n\t\t\t\t\t\t\t\t\t\t: (err.params as { missingProperty?: string })\n\t\t\t\t\t\t\t\t\t\t\t\t.missingProperty || \"root\";\n\t\t\t\t\t\t\t\treturn `  - ${path}: ${err.message ?? \"invalid value\"}`;\n\t\t\t\t\t\t\t})\n\t\t\t\t\t\t\t.join(\"\\n\") || \"Unknown validation error\";\n\t\t\t\t\tthrow new ToolError(\n\t\t\t\t\t\t`Validation failed for tool \"${options.name}\":\\n${errors}`,\n\t\t\t\t\t\t\"VALIDATION_ERROR\",\n\t\t\t\t\t\t{ params },\n\t\t\t\t\t);\n\t\t\t\t}\n\t\t\t}\n\n\t\t\tconst maxRetries = options.maxRetries ?? 0;\n\t\t\tconst retryDelayMs = options.retryDelayMs ?? 1000;\n\t\t\tconst shouldRetry = options.shouldRetry ?? (() => true);\n\t\t\tconst typedParams = params as StaticSchema<Schema>;\n\n\t\t\tlet lastError: unknown;\n\t\t\tfor (let attempt = 0; attempt <= maxRetries; attempt++) {\n\t\t\t\tif (attempt > 0) {\n\t\t\t\t\t// Exponential backoff: delay * 2^(attempt-1)\n\t\t\t\t\tconst delay = retryDelayMs * 2 ** (attempt - 1);\n\t\t\t\t\tif (signal) {\n\t\t\t\t\t\tconst activeSignal = signal;\n\t\t\t\t\t\tawait new Promise<void>((resolve, reject) => {\n\t\t\t\t\t\t\tif (activeSignal.aborted) {\n\t\t\t\t\t\t\t\treject(new Error(\"Operation aborted\"));\n\t\t\t\t\t\t\t\treturn;\n\t\t\t\t\t\t\t}\n\t\t\t\t\t\t\tconst timeout = setTimeout(() => {\n\t\t\t\t\t\t\t\tactiveSignal.removeEventListener(\"abort\", onAbort);\n\t\t\t\t\t\t\t\tresolve();\n\t\t\t\t\t\t\t}, delay);\n\t\t\t\t\t\t\tfunction onAbort() {\n\t\t\t\t\t\t\t\tclearTimeout(timeout);\n\t\t\t\t\t\t\t\tactiveSignal.removeEventListener(\"abort\", onAbort);\n\t\t\t\t\t\t\t\treject(new Error(\"Operation aborted\"));\n\t\t\t\t\t\t\t}\n\t\t\t\t\t\t\tactiveSignal.addEventListener(\"abort\", onAbort, { once: true });\n\t\t\t\t\t\t});\n\t\t\t\t\t} else {\n\t\t\t\t\t\tawait new Promise((resolve) => setTimeout(resolve, delay));\n\t\t\t\t\t}\n\t\t\t\t}\n\n\t\t\t\ttry {\n\t\t\t\t\tconst builder = new ToolResponseBuilder<Details>();\n\t\t\t\t\tconst result = await options.run(typedParams, {\n\t\t\t\t\t\ttoolCallId,\n\t\t\t\t\t\tsignal,\n\t\t\t\t\t\trespond: builder,\n\t\t\t\t\t\tsandbox: context?.sandbox,\n\t\t\t\t\t\tonUpdate,\n\t\t\t\t\t});\n\t\t\t\t\tif (result instanceof ToolResponseBuilder) {\n\t\t\t\t\t\treturn result.build();\n\t\t\t\t\t}\n\t\t\t\t\tif (result) {\n\t\t\t\t\t\treturn result;\n\t\t\t\t\t}\n\t\t\t\t\treturn builder.build();\n\t\t\t\t} catch (error) {\n\t\t\t\t\tlastError = error;\n\t\t\t\t\tif (attempt < maxRetries && shouldRetry(error)) {\n\t\t\t\t\t\tcontinue;\n\t\t\t\t\t}\n\t\t\t\t\tthrow error;\n\t\t\t\t}\n\t\t\t}\n\t\t\tthrow lastError;\n\t\t},\n\t});\n}\n\nimport { getHomeDir } from \"../utils/path-expansion.js\";\nimport { expandUserPath as expandUserPathBase } from \"../utils/path-validation.js\";\n\n// Re-export shared path expansion utility to keep tool-dsl API stable\nexport const expandUserPath = expandUserPathBase;\n\n/**\n * Interpolate environment variables and context in a string.\n * Supports: ${env.VAR}, ${cwd}, ${home}\n */\nexport function interpolateContext(value: string): string {\n\treturn value\n\t\t.replace(/\\$\\{env\\.([^}]+)\\}/g, (_, varName) => process.env[varName] ?? \"\")\n\t\t.replace(/\\$\\{cwd\\}/g, process.cwd())\n\t\t.replace(/\\$\\{home\\}/g, getHomeDir());\n}\n\nexport interface CreateTextToolOptions<Schema extends TSchema, Details>\n\textends Omit<CreateToolOptions<Schema, Details>, \"run\"> {\n\trun: (\n\t\tparams: import(\"@sinclair/typebox\").Static<Schema>,\n\t\tcontext: ToolRunContext<Details>,\n\t) =>\n\t\t| string\n\t\t| undefined\n\t\t| ToolResponseBuilder<Details>\n\t\t| AgentToolResult<Details>\n\t\t| Promise<\n\t\t\t\t| string\n\t\t\t\t| undefined\n\t\t\t\t| ToolResponseBuilder<Details>\n\t\t\t\t| AgentToolResult<Details>\n\t\t  >;\n}\n\nexport function createTextTool<Schema extends TSchema, Details = undefined>(\n\toptions: CreateTextToolOptions<Schema, Details>,\n) {\n\treturn createTool<Schema, Details>({\n\t\t...options,\n\t\trun: async (params, context) => {\n\t\t\tconst result = await options.run(params, context);\n\t\t\tif (typeof result === \"string\") {\n\t\t\t\treturn context.respond.text(result);\n\t\t\t}\n\t\t\treturn result;\n\t\t},\n\t});\n}\n\nexport interface CreateJsonToolOptions<Schema extends TSchema, Details>\n\textends Omit<CreateToolOptions<Schema, Details>, \"run\"> {\n\trun: (\n\t\tparams: import(\"@sinclair/typebox\").Static<Schema>,\n\t\tcontext: ToolRunContext<Details>,\n\t) =>\n\t\t| unknown\n\t\t| undefined\n\t\t| ToolResponseBuilder<Details>\n\t\t| AgentToolResult<Details>\n\t\t| Promise<\n\t\t\t\t| unknown\n\t\t\t\t| undefined\n\t\t\t\t| ToolResponseBuilder<Details>\n\t\t\t\t| AgentToolResult<Details>\n\t\t  >;\n}\n\nexport function createJsonTool<Schema extends TSchema, Details = undefined>(\n\toptions: CreateJsonToolOptions<Schema, Details>,\n) {\n\treturn createTool<Schema, Details>({\n\t\t...options,\n\t\trun: async (params, context) => {\n\t\t\tconst result = await options.run(params, context);\n\t\t\tif (result === undefined) {\n\t\t\t\treturn result;\n\t\t\t}\n\t\t\tif (result instanceof ToolResponseBuilder) {\n\t\t\t\treturn result;\n\t\t\t}\n\t\t\tif (isAgentToolResult<Details>(result)) {\n\t\t\t\treturn result;\n\t\t\t}\n\t\t\treturn context.respond.text(JSON.stringify(result, null, 2));\n\t\t},\n\t});\n}\n\nfunction isAgentToolResult<Details>(\n\tvalue: unknown,\n): value is AgentToolResult<Details> {\n\treturn (\n\t\ttypeof value === \"object\" &&\n\t\tvalue !== null &&\n\t\t\"content\" in value &&\n\t\tArray.isArray((value as AgentToolResult<Details>).content)\n\t);\n}\n"]}
+{"version":3,"file":"tool-dsl.js","sourceRoot":"","sources":["../../src/tools/tool-dsl.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * Tool DSL - Domain-Specific Language for Creating Agent Tools\n *\n * This module provides a fluent, type-safe API for defining tools that can be\n * executed by the Composer agent. It handles schema validation, response building,\n * retry logic, and sandbox integration.\n *\n * ## Architecture\n *\n * ```\n * ┌─────────────────────────────────────────────────────────────────┐\n * │                     Tool Creation Flow                          │\n * ├─────────────────────────────────────────────────────────────────┤\n * │  createTool(options)                                            │\n * │       │                                                         │\n * │       ▼                                                         │\n * │  ┌─────────────┐    ┌──────────────┐    ┌─────────────────┐    │\n * │  │   Schema    │───▶│  Validator   │───▶│   execute()     │    │\n * │  │  (TypeBox)  │    │   (AJV)      │    │   function      │    │\n * │  └─────────────┘    └──────────────┘    └─────────────────┘    │\n * │                                               │                 │\n * │                                               ▼                 │\n * │                     ┌─────────────────────────────────────┐     │\n * │                     │  ToolResponseBuilder                │     │\n * │                     │  - text(), image(), error()         │     │\n * │                     │  - detail() for structured data     │     │\n * │                     └─────────────────────────────────────┘     │\n * └─────────────────────────────────────────────────────────────────┘\n * ```\n *\n * ## Tool Types\n *\n * | Factory       | Return Type      | Use Case                          |\n * |---------------|------------------|-----------------------------------|\n * | createTool    | AgentToolResult  | Full control over response        |\n * | createTextTool| string → text    | Simple text responses             |\n * | createJsonTool| object → JSON    | Structured data responses         |\n *\n * ## Example\n *\n * ```typescript\n * import { createTool, Type } from './tool-dsl';\n *\n * const greetTool = createTool({\n *   name: 'greet',\n *   description: 'Greet a user by name',\n *   schema: Type.Object({\n *     name: Type.String({ description: 'Name to greet' }),\n *   }),\n *   run: async ({ name }, { respond }) => {\n *     return respond.text(`Hello, ${name}!`);\n *   },\n * });\n * ```\n *\n * ## Features\n *\n * - **Type-safe schemas**: Uses TypeBox for compile-time type inference\n * - **AJV validation**: Runtime validation with format support\n * - **Retry logic**: Built-in exponential backoff for transient failures\n * - **Sandbox support**: Tools can run in isolated environments\n * - **Context interpolation**: Environment variables and paths\n *\n * @module tools/tool-dsl\n */\n\nimport type { Static, TSchema } from \"@sinclair/typebox\";\nimport { Ajv, type ErrorObject, type ValidateFunction } from \"ajv\";\nimport addFormatsModule, { type FormatsPlugin } from \"ajv-formats\";\nimport type {\n\tAgentToolResult,\n\tAgentToolUpdateCallback,\n\tToolAnnotations,\n\tToolSourceMetadata,\n} from \"../agent/types.js\";\nimport type { Sandbox } from \"../sandbox/types.js\";\nimport { resolveDefaultExport } from \"../utils/module-interop.js\";\n\n// ESM/CJS interop: ajv-formats default may be nested under .default in some loaders\nconst addFormats = resolveDefaultExport<FormatsPlugin>(addFormatsModule);\n\n// Create a singleton AJV instance for schema validation\nlet ajv: Ajv | null = null;\ntry {\n\tajv = new Ajv({\n\t\t// Avoid unbounded error collection on large/invalid payloads\n\t\tallErrors: false,\n\t\tstrict: false,\n\t\tuseDefaults: true, // Apply schema defaults to input\n\t});\n\taddFormats(ajv);\n} catch {\n\t// AJV initialization failed (likely CSP restriction)\n\tajv = null;\n}\n\n// Cache compiled validators per schema to avoid recompiling on every execute()\nconst validatorCache = new WeakMap<TSchema, ValidateFunction>();\n\nfunction getOrCompileValidator(schema: TSchema): ValidateFunction | null {\n\tif (!ajv) return null;\n\n\tlet validate = validatorCache.get(schema);\n\tif (!validate) {\n\t\tvalidate = ajv.compile(schema);\n\t\tvalidatorCache.set(schema, validate);\n\t}\n\treturn validate;\n}\n\nexport class ToolResponseBuilder<Details> {\n\tprivate _content: (\n\t\t| { type: \"text\"; text: string }\n\t\t| { type: \"image\"; data: string; mimeType: string }\n\t)[] = [];\n\tprivate _details?: Details;\n\tprivate _isError = false;\n\n\ttext(content: string): this {\n\t\tthis._content.push({ type: \"text\", text: content });\n\t\treturn this;\n\t}\n\n\timage(base64: string, mimeType: string): this {\n\t\tthis._content.push({ type: \"image\", data: base64, mimeType });\n\t\treturn this;\n\t}\n\n\tdetail(details: Details): this {\n\t\tthis._details = details;\n\t\treturn this;\n\t}\n\n\terror(message: string): this {\n\t\tthis.text(message);\n\t\tthis._isError = true;\n\t\treturn this;\n\t}\n\n\tbuild(): AgentToolResult<Details> {\n\t\treturn {\n\t\t\tcontent: this._content,\n\t\t\tdetails: this._details,\n\t\t\tisError: this._isError,\n\t\t};\n\t}\n}\n\nexport interface ToolRunContext<Details> {\n\ttoolCallId: string;\n\tsignal?: AbortSignal;\n\trespond: ToolResponseBuilder<Details>;\n\tsandbox?: Sandbox;\n\tonUpdate?: AgentToolUpdateCallback<Details>;\n}\n\nexport interface CreateToolOptions<Schema extends TSchema, Details> {\n\tname: string;\n\tlabel?: string;\n\tdescription: string;\n\tschema: Schema;\n\tannotations?: ToolAnnotations;\n\tsource?: ToolSourceMetadata;\n\ttoolType?: string;\n\tinputExamples?: unknown[];\n\tallowedCallers?: string[];\n\tdeferApiDefinition?: boolean;\n\trun: (\n\t\tparams: import(\"@sinclair/typebox\").Static<Schema>,\n\t\tcontext: ToolRunContext<Details>,\n\t) =>\n\t\t| undefined\n\t\t| ToolResponseBuilder<Details>\n\t\t| AgentToolResult<Details>\n\t\t| Promise<\n\t\t\t\tundefined | ToolResponseBuilder<Details> | AgentToolResult<Details>\n\t\t  >;\n\tmaxRetries?: number;\n\tretryDelayMs?: number;\n\tshouldRetry?: (error: unknown) => boolean;\n\tgetToolUseSummary?: (params: Static<Schema>) => string | null;\n\tgetDisplayName?: (params: Static<Schema>) => string | null;\n\tgetActivityDescription?: (params: Static<Schema>) => string | null;\n}\n\ntype StaticSchema<Schema extends TSchema> = Static<Schema>;\n\nexport class ToolError extends Error {\n\tconstructor(\n\t\tmessage: string,\n\t\tpublic readonly code?: string,\n\t\tpublic readonly details?: unknown,\n\t) {\n\t\tsuper(message);\n\t\tthis.name = \"ToolError\";\n\t}\n}\n\nexport function createTool<Schema extends TSchema, Details = undefined>(\n\toptions: CreateToolOptions<Schema, Details>,\n) {\n\treturn Object.freeze({\n\t\tname: options.name,\n\t\tlabel: options.label ?? options.name,\n\t\tdescription: options.description,\n\t\tparameters: options.schema,\n\t\tannotations: options.annotations,\n\t\tsource: options.source,\n\t\ttoolType: options.toolType,\n\t\tinputExamples: options.inputExamples,\n\t\tallowedCallers: options.allowedCallers,\n\t\tdeferApiDefinition: options.deferApiDefinition,\n\t\tmaxRetries: options.maxRetries,\n\t\tretryDelayMs: options.retryDelayMs,\n\t\tshouldRetry: options.shouldRetry,\n\t\tgetToolUseSummary: options.getToolUseSummary\n\t\t\t? (params: Record<string, unknown>) =>\n\t\t\t\t\toptions.getToolUseSummary?.(params as StaticSchema<Schema>) ?? null\n\t\t\t: undefined,\n\t\tgetDisplayName: options.getDisplayName\n\t\t\t? (params: Record<string, unknown>) =>\n\t\t\t\t\toptions.getDisplayName?.(params as StaticSchema<Schema>) ?? null\n\t\t\t: undefined,\n\t\tgetActivityDescription: options.getActivityDescription\n\t\t\t? (params: Record<string, unknown>) =>\n\t\t\t\t\toptions.getActivityDescription?.(params as StaticSchema<Schema>) ??\n\t\t\t\t\tnull\n\t\t\t: undefined,\n\t\texecute: async (\n\t\t\ttoolCallId: string,\n\t\t\tparams: Record<string, unknown>,\n\t\t\tsignal?: AbortSignal,\n\t\t\tcontext?: { sandbox?: Sandbox },\n\t\t\tonUpdate?: AgentToolUpdateCallback<Details>,\n\t\t) => {\n\t\t\t// Validate params against schema using cached validator\n\t\t\tif (options.schema) {\n\t\t\t\tconst validate = getOrCompileValidator(options.schema);\n\t\t\t\tif (validate && !validate(params)) {\n\t\t\t\t\tconst errors =\n\t\t\t\t\t\t(validate.errors ?? [])\n\t\t\t\t\t\t\t.map((err) => {\n\t\t\t\t\t\t\t\tconst path =\n\t\t\t\t\t\t\t\t\terr.instancePath && err.instancePath.length > 1\n\t\t\t\t\t\t\t\t\t\t? err.instancePath.substring(1)\n\t\t\t\t\t\t\t\t\t\t: (err.params as { missingProperty?: string })\n\t\t\t\t\t\t\t\t\t\t\t\t.missingProperty || \"root\";\n\t\t\t\t\t\t\t\treturn `  - ${path}: ${err.message ?? \"invalid value\"}`;\n\t\t\t\t\t\t\t})\n\t\t\t\t\t\t\t.join(\"\\n\") || \"Unknown validation error\";\n\t\t\t\t\tthrow new ToolError(\n\t\t\t\t\t\t`Validation failed for tool \"${options.name}\":\\n${errors}`,\n\t\t\t\t\t\t\"VALIDATION_ERROR\",\n\t\t\t\t\t\t{ params },\n\t\t\t\t\t);\n\t\t\t\t}\n\t\t\t}\n\n\t\t\tconst maxRetries = options.maxRetries ?? 0;\n\t\t\tconst retryDelayMs = options.retryDelayMs ?? 1000;\n\t\t\tconst shouldRetry = options.shouldRetry ?? (() => true);\n\t\t\tconst typedParams = params as StaticSchema<Schema>;\n\n\t\t\tlet lastError: unknown;\n\t\t\tfor (let attempt = 0; attempt <= maxRetries; attempt++) {\n\t\t\t\tif (attempt > 0) {\n\t\t\t\t\t// Exponential backoff: delay * 2^(attempt-1)\n\t\t\t\t\tconst delay = retryDelayMs * 2 ** (attempt - 1);\n\t\t\t\t\tif (signal) {\n\t\t\t\t\t\tconst activeSignal = signal;\n\t\t\t\t\t\tawait new Promise<void>((resolve, reject) => {\n\t\t\t\t\t\t\tif (activeSignal.aborted) {\n\t\t\t\t\t\t\t\treject(new Error(\"Operation aborted\"));\n\t\t\t\t\t\t\t\treturn;\n\t\t\t\t\t\t\t}\n\t\t\t\t\t\t\tconst timeout = setTimeout(() => {\n\t\t\t\t\t\t\t\tactiveSignal.removeEventListener(\"abort\", onAbort);\n\t\t\t\t\t\t\t\tresolve();\n\t\t\t\t\t\t\t}, delay);\n\t\t\t\t\t\t\tfunction onAbort() {\n\t\t\t\t\t\t\t\tclearTimeout(timeout);\n\t\t\t\t\t\t\t\tactiveSignal.removeEventListener(\"abort\", onAbort);\n\t\t\t\t\t\t\t\treject(new Error(\"Operation aborted\"));\n\t\t\t\t\t\t\t}\n\t\t\t\t\t\t\tactiveSignal.addEventListener(\"abort\", onAbort, { once: true });\n\t\t\t\t\t\t});\n\t\t\t\t\t} else {\n\t\t\t\t\t\tawait new Promise((resolve) => setTimeout(resolve, delay));\n\t\t\t\t\t}\n\t\t\t\t}\n\n\t\t\t\ttry {\n\t\t\t\t\tconst builder = new ToolResponseBuilder<Details>();\n\t\t\t\t\tconst result = await options.run(typedParams, {\n\t\t\t\t\t\ttoolCallId,\n\t\t\t\t\t\tsignal,\n\t\t\t\t\t\trespond: builder,\n\t\t\t\t\t\tsandbox: context?.sandbox,\n\t\t\t\t\t\tonUpdate,\n\t\t\t\t\t});\n\t\t\t\t\tif (result instanceof ToolResponseBuilder) {\n\t\t\t\t\t\treturn result.build();\n\t\t\t\t\t}\n\t\t\t\t\tif (result) {\n\t\t\t\t\t\treturn result;\n\t\t\t\t\t}\n\t\t\t\t\treturn builder.build();\n\t\t\t\t} catch (error) {\n\t\t\t\t\tlastError = error;\n\t\t\t\t\tif (attempt < maxRetries && shouldRetry(error)) {\n\t\t\t\t\t\tcontinue;\n\t\t\t\t\t}\n\t\t\t\t\tthrow error;\n\t\t\t\t}\n\t\t\t}\n\t\t\tthrow lastError;\n\t\t},\n\t});\n}\n\nimport { getHomeDir } from \"../utils/path-expansion.js\";\nimport { expandUserPath as expandUserPathBase } from \"../utils/path-validation.js\";\n\n// Re-export shared path expansion utility to keep tool-dsl API stable\nexport const expandUserPath = expandUserPathBase;\n\n/**\n * Interpolate environment variables and context in a string.\n * Supports: ${env.VAR}, ${cwd}, ${home}\n */\nexport function interpolateContext(value: string): string {\n\treturn value\n\t\t.replace(/\\$\\{env\\.([^}]+)\\}/g, (_, varName) => process.env[varName] ?? \"\")\n\t\t.replace(/\\$\\{cwd\\}/g, process.cwd())\n\t\t.replace(/\\$\\{home\\}/g, getHomeDir());\n}\n\nexport interface CreateTextToolOptions<Schema extends TSchema, Details>\n\textends Omit<CreateToolOptions<Schema, Details>, \"run\"> {\n\trun: (\n\t\tparams: import(\"@sinclair/typebox\").Static<Schema>,\n\t\tcontext: ToolRunContext<Details>,\n\t) =>\n\t\t| string\n\t\t| undefined\n\t\t| ToolResponseBuilder<Details>\n\t\t| AgentToolResult<Details>\n\t\t| Promise<\n\t\t\t\t| string\n\t\t\t\t| undefined\n\t\t\t\t| ToolResponseBuilder<Details>\n\t\t\t\t| AgentToolResult<Details>\n\t\t  >;\n}\n\nexport function createTextTool<Schema extends TSchema, Details = undefined>(\n\toptions: CreateTextToolOptions<Schema, Details>,\n) {\n\treturn createTool<Schema, Details>({\n\t\t...options,\n\t\trun: async (params, context) => {\n\t\t\tconst result = await options.run(params, context);\n\t\t\tif (typeof result === \"string\") {\n\t\t\t\treturn context.respond.text(result);\n\t\t\t}\n\t\t\treturn result;\n\t\t},\n\t});\n}\n\nexport interface CreateJsonToolOptions<Schema extends TSchema, Details>\n\textends Omit<CreateToolOptions<Schema, Details>, \"run\"> {\n\trun: (\n\t\tparams: import(\"@sinclair/typebox\").Static<Schema>,\n\t\tcontext: ToolRunContext<Details>,\n\t) =>\n\t\t| unknown\n\t\t| undefined\n\t\t| ToolResponseBuilder<Details>\n\t\t| AgentToolResult<Details>\n\t\t| Promise<\n\t\t\t\t| unknown\n\t\t\t\t| undefined\n\t\t\t\t| ToolResponseBuilder<Details>\n\t\t\t\t| AgentToolResult<Details>\n\t\t  >;\n}\n\nexport function createJsonTool<Schema extends TSchema, Details = undefined>(\n\toptions: CreateJsonToolOptions<Schema, Details>,\n) {\n\treturn createTool<Schema, Details>({\n\t\t...options,\n\t\trun: async (params, context) => {\n\t\t\tconst result = await options.run(params, context);\n\t\t\tif (result === undefined) {\n\t\t\t\treturn result;\n\t\t\t}\n\t\t\tif (result instanceof ToolResponseBuilder) {\n\t\t\t\treturn result;\n\t\t\t}\n\t\t\tif (isAgentToolResult<Details>(result)) {\n\t\t\t\treturn result;\n\t\t\t}\n\t\t\treturn context.respond.text(JSON.stringify(result, null, 2));\n\t\t},\n\t});\n}\n\nfunction isAgentToolResult<Details>(\n\tvalue: unknown,\n): value is AgentToolResult<Details> {\n\treturn (\n\t\ttypeof value === \"object\" &&\n\t\tvalue !== null &&\n\t\t\"content\" in value &&\n\t\tArray.isArray((value as AgentToolResult<Details>).content)\n\t);\n}\n"]}