@evalops/maestro 0.10.18 → 0.10.21

package/dist/tools/index.d.ts

@@ -44,6 +44,7 @@
 export { askUserTool, type Question, type QuestionOption, type AskUserInput, type AskUserResult, } from "./ask-user.js";
 export { bashTool } from "./bash.js";
 export { backgroundTasksTool } from "./background/tool-handler.js";
+export { applyPatchTool } from "./apply-patch.js";
 export { codesearchTool } from "./codesearch.js";
 export { diffTool } from "./diff.js";
 export { editTool } from "./edit.js";
@@ -105,6 +106,7 @@ export declare const codingTools: (Readonly<{
         lines: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TNumber>;
     }>]>;
     annotations: import("../agent/types.js").ToolAnnotations | undefined;
+    source: import("../agent/types.js").McpToolSourceMetadata | undefined;
     toolType: string | undefined;
     inputExamples: unknown[] | undefined;
     allowedCallers: string[] | undefined;
@@ -131,6 +133,7 @@ export declare const codingTools: (Readonly<{
         edit_mode: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TUnion<[import("@sinclair/typebox").TLiteral<"replace">, import("@sinclair/typebox").TLiteral<"insert">, import("@sinclair/typebox").TLiteral<"delete">]>>;
     }>;
     annotations: import("../agent/types.js").ToolAnnotations | undefined;
+    source: import("../agent/types.js").McpToolSourceMetadata | undefined;
     toolType: string | undefined;
     inputExamples: unknown[] | undefined;
     allowedCallers: string[] | undefined;
@@ -171,6 +174,7 @@ export declare const codingTools: (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;
@@ -225,6 +229,7 @@ export declare const codingTools: (Readonly<{
         }>>;
     }>;
     annotations: import("../agent/types.js").ToolAnnotations | undefined;
+    source: import("../agent/types.js").McpToolSourceMetadata | undefined;
     toolType: string | undefined;
     inputExamples: unknown[] | undefined;
     allowedCallers: string[] | undefined;
@@ -272,6 +277,7 @@ export declare const codingTools: (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;
@@ -309,6 +315,7 @@ export declare const codingTools: (Readonly<{
         runInBackground: 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;
@@ -331,6 +338,7 @@ export declare const codingTools: (Readonly<{
         tokensNum: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TUnion<[import("@sinclair/typebox").TLiteral<"dynamic">, 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;
@@ -362,6 +370,7 @@ export declare const codingTools: (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;
@@ -381,6 +390,29 @@ export declare const codingTools: (Readonly<{
         command: string;
         status?: import("./diff.js").ParsedStatus;
     }>>;
+}> | Readonly<{
+    name: string;
+    label: string;
+    description: string;
+    parameters: import("@sinclair/typebox").TObject<{
+        patch: import("@sinclair/typebox").TString;
+        dryRun: 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;
+    deferApiDefinition: boolean | undefined;
+    maxRetries: number | undefined;
+    retryDelayMs: number | undefined;
+    shouldRetry: ((error: unknown) => boolean) | undefined;
+    getToolUseSummary: ((params: Record<string, unknown>) => string | null) | undefined;
+    getDisplayName: ((params: Record<string, unknown>) => string | null) | undefined;
+    getActivityDescription: ((params: Record<string, unknown>) => string | null) | undefined;
+    execute: (toolCallId: string, params: Record<string, unknown>, signal?: AbortSignal, context?: {
+        sandbox?: import("../sandbox/types.js").Sandbox;
+    } | undefined, onUpdate?: import("../agent/types.js").AgentToolUpdateCallback<import("./apply-patch.js").ApplyPatchToolDetails> | undefined) => Promise<import("../agent/types.js").AgentToolResult<import("./apply-patch.js").ApplyPatchToolDetails>>;
 }> | Readonly<{
     name: string;
     label: string;
@@ -398,6 +430,7 @@ export declare const codingTools: (Readonly<{
         dryRun: 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;
@@ -432,6 +465,7 @@ export declare const codingTools: (Readonly<{
         maxChars: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TNumber>;
     }>;
     annotations: import("../agent/types.js").ToolAnnotations | undefined;
+    source: import("../agent/types.js").McpToolSourceMetadata | undefined;
     toolType: string | undefined;
     inputExamples: unknown[] | undefined;
     allowedCallers: string[] | undefined;
@@ -456,6 +490,7 @@ export declare const codingTools: (Readonly<{
         includeHidden: 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;
@@ -496,6 +531,7 @@ export declare const codingTools: (Readonly<{
         excludePatterns: import("@sinclair/typebox").TOptional<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;
@@ -530,6 +566,7 @@ export declare const codingTools: (Readonly<{
         backup: 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;
@@ -580,6 +617,7 @@ export declare const codingTools: (Readonly<{
         nameOnly: 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;
@@ -609,6 +647,7 @@ export declare const codingTools: (Readonly<{
         json: 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;
@@ -633,6 +672,7 @@ export declare const codingTools: (Readonly<{
         json: 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;
@@ -659,6 +699,7 @@ export declare const codingTools: (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;
@@ -683,6 +724,7 @@ export declare const codingTools: (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;
@@ -710,6 +752,7 @@ export declare const codingTools: (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;
@@ -739,6 +782,7 @@ export declare const codingTools: (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;
@@ -774,6 +818,7 @@ export declare const codingTools: (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;
@@ -839,6 +884,7 @@ export declare const codingTools: (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;
@@ -889,6 +935,7 @@ export declare const codingTools: (Readonly<{
         files: import("@sinclair/typebox").TOptional<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;
@@ -912,6 +959,7 @@ export declare const codingTools: (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;
@@ -949,6 +997,7 @@ export declare const codingTools: (Readonly<{
         }>]>>;
     }>;
     annotations: import("../agent/types.js").ToolAnnotations | undefined;
+    source: import("../agent/types.js").McpToolSourceMetadata | undefined;
     toolType: string | undefined;
     inputExamples: unknown[] | undefined;
     allowedCallers: string[] | undefined;
@@ -993,6 +1042,7 @@ export declare const codingTools: (Readonly<{
         }>>;
     }>;
     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/index.d.ts.map

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

package/dist/tools/index.js

@@ -54,6 +54,7 @@ import { codesearchTool } from "./codesearch.js";
 // Git operations
 import { diffTool } from "./diff.js";
 // File manipulation
+import { applyPatchTool } from "./apply-patch.js";
 import { editTool } from "./edit.js";
 import { extractDocumentTool } from "./extract-document.js";
 import { findTool } from "./find.js";
@@ -81,6 +82,7 @@ import { websearchTool } from "./websearch.js";
 export { askUserTool, } from "./ask-user.js";
 export { bashTool } from "./bash.js";
 export { backgroundTasksTool } from "./background/tool-handler.js";
+export { applyPatchTool } from "./apply-patch.js";
 export { codesearchTool } from "./codesearch.js";
 export { diffTool } from "./diff.js";
 export { editTool } from "./edit.js";
@@ -126,6 +128,7 @@ export const codingTools = [
     bashTool,
     backgroundTasksTool,
     // File modification
+    applyPatchTool,
     editTool,
     writeTool,
     notebookEditTool,
@@ -165,6 +168,7 @@ export const toolRegistry = {
     diff: diffTool,
     bash: bashTool,
     background_tasks: backgroundTasksTool,
+    apply_patch: applyPatchTool,
     edit: editTool,
     write: writeTool,
     notebook_edit: notebookEditTool,

package/dist/tools/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/tools/index.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * Tool Registry - Central index of all available tools.\n *\n * This module serves as the main entry point for all tool definitions in Composer.\n * It organizes tools into logical groups and provides utilities for filtering and\n * accessing tools by name.\n *\n * ## Tool Categories\n *\n * **Core File Operations:**\n * - read: Read file contents (text, images, PDFs, notebooks)\n * - write: Create or overwrite files\n * - edit: Structured find/replace editing\n * - list: Directory listing and globbing\n * - find: Fast file finder using fd\n *\n * **Search & Navigation:**\n * - search: Ripgrep-style content search\n * - parallel_ripgrep: Parallelized search for large codebases\n * - codesearch: Exa Code API integration (optional)\n *\n * **Shell & System:**\n * - bash: Shell command execution\n * - background_tasks: Long-running process management\n * - status: System and session status\n *\n * **Git & GitHub:**\n * - diff: Git diff inspection\n * - gh_pr/gh_issue/gh_repo: GitHub CLI integration\n * - pipeline_*: Pipeline CRM integration\n *\n * **AI & Automation:**\n * - oracle: Sub-agent for complex reasoning\n * - todo: Task list management\n * - ask_user: Structured user prompts\n *\n * **Web:**\n * - websearch: Web search (requires EXA_API_KEY)\n * - webfetch: Fetch and parse web content\n *\n * **VS Code Integration:**\n * - vscode tools: IDE features when running in VS Code context\n */\n\n// =============================================================================\n// Tool Imports - Organized by category\n// =============================================================================\n\n// User interaction tools\nimport { askUserTool } from \"./ask-user.js\";\nimport { backgroundTasksTool } from \"./background/tool-handler.js\";\n\n// Shell execution with cwd tracking and safety checks\nimport { bashTool } from \"./bash.js\";\n\n// External API integrations (optional - requires API keys)\nimport { codesearchTool } from \"./codesearch.js\";\n\n// Git operations\nimport { diffTool } from \"./diff.js\";\n\n// File manipulation\nimport { editTool } from \"./edit.js\";\nimport { extractDocumentTool } from \"./extract-document.js\";\nimport { findTool } from \"./find.js\";\nimport { listTool } from \"./list.js\";\nimport { notebookEditTool } from \"./notebook.js\";\nimport { readTool } from \"./read.js\";\nimport { writeTool } from \"./write.js\";\n\n// GitHub CLI integration (requires gh CLI installed)\nimport { ghIssueTool, ghPrTool, ghRepoTool } from \"./gh.js\";\nimport {\n\tpipelineCreateSignalTool,\n\tpipelineLogActivityTool,\n\tpipelineSearchContactsTool,\n\tpipelineSearchDealsTool,\n} from \"./pipeline.js\";\n\n// Search tools\nimport { parallelRipgrepTool } from \"./parallel-ripgrep.js\";\nimport { searchTool } from \"./search.js\";\n\n// AI and automation\nimport { oracleTool } from \"./oracle.js\";\nimport { statusTool } from \"./status.js\";\nimport { todoTool } from \"./todo.js\";\n\n// VS Code IDE integration\nimport {\n\tvscodeFindReferencesTool,\n\tvscodeGetDefinitionTool,\n\tvscodeGetDiagnosticsTool,\n\tvscodeReadFileRangeTool,\n} from \"./vscode.js\";\n\n// JetBrains IDE integration\nimport {\n\tjetbrainsFindReferencesTool,\n\tjetbrainsGetDefinitionTool,\n\tjetbrainsGetDiagnosticsTool,\n\tjetbrainsReadFileRangeTool,\n\tjetbrainsTools as jetbrainsToolDefinitions,\n} from \"./jetbrains.js\";\n\n// Conductor browser-client tools\nimport { conductorClientTools } from \"./conductor-client.js\";\n\n// Web tools (optional - requires EXA_API_KEY)\nimport { webfetchTool } from \"./webfetch.js\";\nimport { websearchTool } from \"./websearch.js\";\n\nexport {\n\taskUserTool,\n\ttype Question,\n\ttype QuestionOption,\n\ttype AskUserInput,\n\ttype AskUserResult,\n} from \"./ask-user.js\";\nexport { bashTool } from \"./bash.js\";\nexport { backgroundTasksTool } from \"./background/tool-handler.js\";\nexport { codesearchTool } from \"./codesearch.js\";\nexport { diffTool } from \"./diff.js\";\nexport { editTool } from \"./edit.js\";\nexport { extractDocumentTool } from \"./extract-document.js\";\nexport { findTool } from \"./find.js\";\nexport { listTool } from \"./list.js\";\nexport { notebookEditTool } from \"./notebook.js\";\nexport { parallelRipgrepTool } from \"./parallel-ripgrep.js\";\nexport { readTool } from \"./read.js\";\nexport { searchTool } from \"./search.js\";\nexport { todoTool } from \"./todo.js\";\nexport { webfetchTool } from \"./webfetch.js\";\nexport { websearchTool } from \"./websearch.js\";\nexport { writeTool } from \"./write.js\";\nexport { statusTool } from \"./status.js\";\nexport { ghIssueTool, ghPrTool, ghRepoTool } from \"./gh.js\";\nexport {\n\tpipelineCreateSignalTool,\n\tpipelineLogActivityTool,\n\tpipelineSearchContactsTool,\n\tpipelineSearchDealsTool,\n} from \"./pipeline.js\";\nexport { ensureTool, getToolPath } from \"./tools-manager.js\";\nexport { conductorClientTools } from \"./conductor-client.js\";\n\n// =============================================================================\n// Tool Collections\n// =============================================================================\n\n/**\n * Complete set of coding tools available to the agent.\n *\n * This array defines the default tool set used in interactive sessions.\n * Tools are ordered roughly by frequency of use, though order doesn't\n * affect functionality.\n */\nexport const codingTools = [\n\t// File reading and navigation (most common)\n\treadTool,\n\tlistTool,\n\toracleTool,\n\tfindTool,\n\textractDocumentTool,\n\t// Search capabilities\n\tsearchTool,\n\tparallelRipgrepTool,\n\t// Git operations\n\tdiffTool,\n\t// Shell access\n\tbashTool,\n\tbackgroundTasksTool,\n\t// File modification\n\teditTool,\n\twriteTool,\n\tnotebookEditTool,\n\t// Workflow tools\n\ttodoTool,\n\taskUserTool,\n\t// Web and external services\n\twebsearchTool,\n\tcodesearchTool,\n\twebfetchTool,\n\t// System info\n\tstatusTool,\n\t// GitHub CLI tools\n\tghPrTool,\n\tghIssueTool,\n\tghRepoTool,\n\t// CRM tools\n\tpipelineSearchContactsTool,\n\tpipelineSearchDealsTool,\n\tpipelineCreateSignalTool,\n\tpipelineLogActivityTool,\n];\n\n/**\n * Tool registry mapping tool names to tool instances.\n *\n * Used by the --tools CLI flag to filter available tools.\n * Keys are the canonical tool names used in configuration.\n */\nexport const toolRegistry: Record<string, (typeof codingTools)[number]> = {\n\tread: readTool,\n\tlist: listTool,\n\toracle: oracleTool,\n\tfind: findTool,\n\textract_document: extractDocumentTool,\n\tsearch: searchTool,\n\tparallel_ripgrep: parallelRipgrepTool,\n\tdiff: diffTool,\n\tbash: bashTool,\n\tbackground_tasks: backgroundTasksTool,\n\tedit: editTool,\n\twrite: writeTool,\n\tnotebook_edit: notebookEditTool,\n\ttodo: todoTool,\n\task_user: askUserTool,\n\twebsearch: websearchTool,\n\tcodesearch: codesearchTool,\n\twebfetch: webfetchTool,\n\tstatus: statusTool,\n\tgh_pr: ghPrTool,\n\tgh_issue: ghIssueTool,\n\tgh_repo: ghRepoTool,\n\tpipeline_search_contacts: pipelineSearchContactsTool,\n\tpipeline_search_deals: pipelineSearchDealsTool,\n\tpipeline_create_signal: pipelineCreateSignalTool,\n\tpipeline_log_activity: pipelineLogActivityTool,\n};\n\n// Re-export tool name constants\nexport { readOnlyToolNames, type ReadOnlyToolName } from \"./tool-names.js\";\n\n/**\n * Filter tools by name from the registry.\n *\n * Used to create custom tool sets based on user configuration\n * or security requirements.\n *\n * @param toolNames - Array of tool names to include\n * @returns Array of matching tool instances\n */\nexport function filterTools(\n\ttoolNames: string[],\n): (typeof codingTools)[number][] {\n\tconst filtered: (typeof codingTools)[number][] = [];\n\tfor (const name of toolNames) {\n\t\tconst tool = toolRegistry[name];\n\t\tif (tool) {\n\t\t\tfiltered.push(tool);\n\t\t}\n\t}\n\treturn filtered;\n}\n\n/**\n * VS Code-specific tools for IDE integration.\n *\n * These tools provide IDE features when running in VS Code context:\n * - Language server diagnostics\n * - Go-to-definition\n * - Find references\n * - Smart file range reading\n *\n * Only included when a VS Code client is connected.\n */\nexport const vscodeTools = [\n\tvscodeGetDiagnosticsTool,\n\tvscodeGetDefinitionTool,\n\tvscodeFindReferencesTool,\n\tvscodeReadFileRangeTool,\n];\n\n/**\n * JetBrains-specific tools for IDE integration.\n *\n * These tools provide IDE features when running in JetBrains context:\n * - PSI-based diagnostics\n * - Go-to-definition via reference resolution\n * - Find references via ReferencesSearch\n * - Document-aware file range reading\n *\n * Only included when a JetBrains plugin client is connected.\n */\nexport const jetbrainsTools = jetbrainsToolDefinitions;\n\n// =============================================================================\n// Performance Infrastructure\n// =============================================================================\n\n/**\n * Tool result caching - Caches expensive tool results to avoid redundant work.\n * Particularly useful for read and search operations on unchanged files.\n */\nexport {\n\tToolResultCache,\n\tcreateToolResultCache,\n\tgetGlobalToolResultCache,\n\tresetGlobalToolResultCache,\n\tgetToolResultCacheConfig,\n\ttype ToolCacheConfig,\n\ttype ToolCacheStats,\n} from \"./tool-result-cache.js\";\n\n/**\n * File watching - Monitors filesystem changes to trigger cache invalidation.\n * Supports both file changes and git state changes (branch switches, etc.).\n */\nexport {\n\tFileWatcher,\n\tcreateFileWatcher,\n\tgetGlobalFileWatcher,\n\tinitGlobalFileWatcher,\n\tresetGlobalFileWatcher,\n\ttype FileChangeEvent,\n\ttype FileChangeType,\n\ttype FileWatcherConfig,\n\ttype GitStateChangeEvent,\n} from \"./file-watcher.js\";\n\n/**\n * Cache invalidation - Coordinates cache clearing when files change.\n * Links file watcher events to tool result cache invalidation.\n */\nexport {\n\tCacheInvalidationService,\n\tcreateCacheInvalidationService,\n\tgetGlobalCacheInvalidation,\n\tinitGlobalCacheInvalidation,\n\tresetGlobalCacheInvalidation,\n\ttype CacheInvalidationConfig,\n\ttype InvalidationStats,\n} from \"./cache-invalidation.js\";\n"]}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/tools/index.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * Tool Registry - Central index of all available tools.\n *\n * This module serves as the main entry point for all tool definitions in Composer.\n * It organizes tools into logical groups and provides utilities for filtering and\n * accessing tools by name.\n *\n * ## Tool Categories\n *\n * **Core File Operations:**\n * - read: Read file contents (text, images, PDFs, notebooks)\n * - write: Create or overwrite files\n * - edit: Structured find/replace editing\n * - list: Directory listing and globbing\n * - find: Fast file finder using fd\n *\n * **Search & Navigation:**\n * - search: Ripgrep-style content search\n * - parallel_ripgrep: Parallelized search for large codebases\n * - codesearch: Exa Code API integration (optional)\n *\n * **Shell & System:**\n * - bash: Shell command execution\n * - background_tasks: Long-running process management\n * - status: System and session status\n *\n * **Git & GitHub:**\n * - diff: Git diff inspection\n * - gh_pr/gh_issue/gh_repo: GitHub CLI integration\n * - pipeline_*: Pipeline CRM integration\n *\n * **AI & Automation:**\n * - oracle: Sub-agent for complex reasoning\n * - todo: Task list management\n * - ask_user: Structured user prompts\n *\n * **Web:**\n * - websearch: Web search (requires EXA_API_KEY)\n * - webfetch: Fetch and parse web content\n *\n * **VS Code Integration:**\n * - vscode tools: IDE features when running in VS Code context\n */\n\n// =============================================================================\n// Tool Imports - Organized by category\n// =============================================================================\n\n// User interaction tools\nimport { askUserTool } from \"./ask-user.js\";\nimport { backgroundTasksTool } from \"./background/tool-handler.js\";\n\n// Shell execution with cwd tracking and safety checks\nimport { bashTool } from \"./bash.js\";\n\n// External API integrations (optional - requires API keys)\nimport { codesearchTool } from \"./codesearch.js\";\n\n// Git operations\nimport { diffTool } from \"./diff.js\";\n\n// File manipulation\nimport { applyPatchTool } from \"./apply-patch.js\";\nimport { editTool } from \"./edit.js\";\nimport { extractDocumentTool } from \"./extract-document.js\";\nimport { findTool } from \"./find.js\";\nimport { listTool } from \"./list.js\";\nimport { notebookEditTool } from \"./notebook.js\";\nimport { readTool } from \"./read.js\";\nimport { writeTool } from \"./write.js\";\n\n// GitHub CLI integration (requires gh CLI installed)\nimport { ghIssueTool, ghPrTool, ghRepoTool } from \"./gh.js\";\nimport {\n\tpipelineCreateSignalTool,\n\tpipelineLogActivityTool,\n\tpipelineSearchContactsTool,\n\tpipelineSearchDealsTool,\n} from \"./pipeline.js\";\n\n// Search tools\nimport { parallelRipgrepTool } from \"./parallel-ripgrep.js\";\nimport { searchTool } from \"./search.js\";\n\n// AI and automation\nimport { oracleTool } from \"./oracle.js\";\nimport { statusTool } from \"./status.js\";\nimport { todoTool } from \"./todo.js\";\n\n// VS Code IDE integration\nimport {\n\tvscodeFindReferencesTool,\n\tvscodeGetDefinitionTool,\n\tvscodeGetDiagnosticsTool,\n\tvscodeReadFileRangeTool,\n} from \"./vscode.js\";\n\n// JetBrains IDE integration\nimport {\n\tjetbrainsFindReferencesTool,\n\tjetbrainsGetDefinitionTool,\n\tjetbrainsGetDiagnosticsTool,\n\tjetbrainsReadFileRangeTool,\n\tjetbrainsTools as jetbrainsToolDefinitions,\n} from \"./jetbrains.js\";\n\n// Conductor browser-client tools\nimport { conductorClientTools } from \"./conductor-client.js\";\n\n// Web tools (optional - requires EXA_API_KEY)\nimport { webfetchTool } from \"./webfetch.js\";\nimport { websearchTool } from \"./websearch.js\";\n\nexport {\n\taskUserTool,\n\ttype Question,\n\ttype QuestionOption,\n\ttype AskUserInput,\n\ttype AskUserResult,\n} from \"./ask-user.js\";\nexport { bashTool } from \"./bash.js\";\nexport { backgroundTasksTool } from \"./background/tool-handler.js\";\nexport { applyPatchTool } from \"./apply-patch.js\";\nexport { codesearchTool } from \"./codesearch.js\";\nexport { diffTool } from \"./diff.js\";\nexport { editTool } from \"./edit.js\";\nexport { extractDocumentTool } from \"./extract-document.js\";\nexport { findTool } from \"./find.js\";\nexport { listTool } from \"./list.js\";\nexport { notebookEditTool } from \"./notebook.js\";\nexport { parallelRipgrepTool } from \"./parallel-ripgrep.js\";\nexport { readTool } from \"./read.js\";\nexport { searchTool } from \"./search.js\";\nexport { todoTool } from \"./todo.js\";\nexport { webfetchTool } from \"./webfetch.js\";\nexport { websearchTool } from \"./websearch.js\";\nexport { writeTool } from \"./write.js\";\nexport { statusTool } from \"./status.js\";\nexport { ghIssueTool, ghPrTool, ghRepoTool } from \"./gh.js\";\nexport {\n\tpipelineCreateSignalTool,\n\tpipelineLogActivityTool,\n\tpipelineSearchContactsTool,\n\tpipelineSearchDealsTool,\n} from \"./pipeline.js\";\nexport { ensureTool, getToolPath } from \"./tools-manager.js\";\nexport { conductorClientTools } from \"./conductor-client.js\";\n\n// =============================================================================\n// Tool Collections\n// =============================================================================\n\n/**\n * Complete set of coding tools available to the agent.\n *\n * This array defines the default tool set used in interactive sessions.\n * Tools are ordered roughly by frequency of use, though order doesn't\n * affect functionality.\n */\nexport const codingTools = [\n\t// File reading and navigation (most common)\n\treadTool,\n\tlistTool,\n\toracleTool,\n\tfindTool,\n\textractDocumentTool,\n\t// Search capabilities\n\tsearchTool,\n\tparallelRipgrepTool,\n\t// Git operations\n\tdiffTool,\n\t// Shell access\n\tbashTool,\n\tbackgroundTasksTool,\n\t// File modification\n\tapplyPatchTool,\n\teditTool,\n\twriteTool,\n\tnotebookEditTool,\n\t// Workflow tools\n\ttodoTool,\n\taskUserTool,\n\t// Web and external services\n\twebsearchTool,\n\tcodesearchTool,\n\twebfetchTool,\n\t// System info\n\tstatusTool,\n\t// GitHub CLI tools\n\tghPrTool,\n\tghIssueTool,\n\tghRepoTool,\n\t// CRM tools\n\tpipelineSearchContactsTool,\n\tpipelineSearchDealsTool,\n\tpipelineCreateSignalTool,\n\tpipelineLogActivityTool,\n];\n\n/**\n * Tool registry mapping tool names to tool instances.\n *\n * Used by the --tools CLI flag to filter available tools.\n * Keys are the canonical tool names used in configuration.\n */\nexport const toolRegistry: Record<string, (typeof codingTools)[number]> = {\n\tread: readTool,\n\tlist: listTool,\n\toracle: oracleTool,\n\tfind: findTool,\n\textract_document: extractDocumentTool,\n\tsearch: searchTool,\n\tparallel_ripgrep: parallelRipgrepTool,\n\tdiff: diffTool,\n\tbash: bashTool,\n\tbackground_tasks: backgroundTasksTool,\n\tapply_patch: applyPatchTool,\n\tedit: editTool,\n\twrite: writeTool,\n\tnotebook_edit: notebookEditTool,\n\ttodo: todoTool,\n\task_user: askUserTool,\n\twebsearch: websearchTool,\n\tcodesearch: codesearchTool,\n\twebfetch: webfetchTool,\n\tstatus: statusTool,\n\tgh_pr: ghPrTool,\n\tgh_issue: ghIssueTool,\n\tgh_repo: ghRepoTool,\n\tpipeline_search_contacts: pipelineSearchContactsTool,\n\tpipeline_search_deals: pipelineSearchDealsTool,\n\tpipeline_create_signal: pipelineCreateSignalTool,\n\tpipeline_log_activity: pipelineLogActivityTool,\n};\n\n// Re-export tool name constants\nexport { readOnlyToolNames, type ReadOnlyToolName } from \"./tool-names.js\";\n\n/**\n * Filter tools by name from the registry.\n *\n * Used to create custom tool sets based on user configuration\n * or security requirements.\n *\n * @param toolNames - Array of tool names to include\n * @returns Array of matching tool instances\n */\nexport function filterTools(\n\ttoolNames: string[],\n): (typeof codingTools)[number][] {\n\tconst filtered: (typeof codingTools)[number][] = [];\n\tfor (const name of toolNames) {\n\t\tconst tool = toolRegistry[name];\n\t\tif (tool) {\n\t\t\tfiltered.push(tool);\n\t\t}\n\t}\n\treturn filtered;\n}\n\n/**\n * VS Code-specific tools for IDE integration.\n *\n * These tools provide IDE features when running in VS Code context:\n * - Language server diagnostics\n * - Go-to-definition\n * - Find references\n * - Smart file range reading\n *\n * Only included when a VS Code client is connected.\n */\nexport const vscodeTools = [\n\tvscodeGetDiagnosticsTool,\n\tvscodeGetDefinitionTool,\n\tvscodeFindReferencesTool,\n\tvscodeReadFileRangeTool,\n];\n\n/**\n * JetBrains-specific tools for IDE integration.\n *\n * These tools provide IDE features when running in JetBrains context:\n * - PSI-based diagnostics\n * - Go-to-definition via reference resolution\n * - Find references via ReferencesSearch\n * - Document-aware file range reading\n *\n * Only included when a JetBrains plugin client is connected.\n */\nexport const jetbrainsTools = jetbrainsToolDefinitions;\n\n// =============================================================================\n// Performance Infrastructure\n// =============================================================================\n\n/**\n * Tool result caching - Caches expensive tool results to avoid redundant work.\n * Particularly useful for read and search operations on unchanged files.\n */\nexport {\n\tToolResultCache,\n\tcreateToolResultCache,\n\tgetGlobalToolResultCache,\n\tresetGlobalToolResultCache,\n\tgetToolResultCacheConfig,\n\ttype ToolCacheConfig,\n\ttype ToolCacheStats,\n} from \"./tool-result-cache.js\";\n\n/**\n * File watching - Monitors filesystem changes to trigger cache invalidation.\n * Supports both file changes and git state changes (branch switches, etc.).\n */\nexport {\n\tFileWatcher,\n\tcreateFileWatcher,\n\tgetGlobalFileWatcher,\n\tinitGlobalFileWatcher,\n\tresetGlobalFileWatcher,\n\ttype FileChangeEvent,\n\ttype FileChangeType,\n\ttype FileWatcherConfig,\n\ttype GitStateChangeEvent,\n} from \"./file-watcher.js\";\n\n/**\n * Cache invalidation - Coordinates cache clearing when files change.\n * Links file watcher events to tool result cache invalidation.\n */\nexport {\n\tCacheInvalidationService,\n\tcreateCacheInvalidationService,\n\tgetGlobalCacheInvalidation,\n\tinitGlobalCacheInvalidation,\n\tresetGlobalCacheInvalidation,\n\ttype CacheInvalidationConfig,\n\ttype InvalidationStats,\n} from \"./cache-invalidation.js\";\n"]}

package/dist/tools/list.d.ts

@@ -71,6 +71,7 @@ export declare const listTool: Readonly<{
         excludePatterns: import("@sinclair/typebox").TOptional<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/list.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"list.d.ts","sourceRoot":"","sources":["../../src/tools/list.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAiDG;AAWH,KAAK,eAAe,GAAG;IACtB,MAAM,EAAE,MAAM,GAAG,MAAM,CAAC;IACxB,eAAe,EAAE,OAAO,CAAC;IACzB,KAAK,EAAE,MAAM,CAAC;IACd,SAAS,EAAE,OAAO,CAAC;CACnB,CAAC;AAkFF,eAAO,MAAM,QAAQ;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAgOnB,CAAC"}
+{"version":3,"file":"list.d.ts","sourceRoot":"","sources":["../../src/tools/list.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAiDG;AAWH,KAAK,eAAe,GAAG;IACtB,MAAM,EAAE,MAAM,GAAG,MAAM,CAAC;IACxB,eAAe,EAAE,OAAO,CAAC;IACzB,KAAK,EAAE,MAAM,CAAC;IACd,SAAS,EAAE,OAAO,CAAC;CACnB,CAAC;AAkFF,eAAO,MAAM,QAAQ;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAgOnB,CAAC"}

package/dist/tools/notebook.d.ts

@@ -21,6 +21,7 @@ export declare const notebookEditTool: Readonly<{
         edit_mode: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TUnion<[import("@sinclair/typebox").TLiteral<"replace">, import("@sinclair/typebox").TLiteral<"insert">, import("@sinclair/typebox").TLiteral<"delete">]>>;
     }>;
     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/notebook.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"notebook.d.ts","sourceRoot":"","sources":["../../src/tools/notebook.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAiHH,KAAK,mBAAmB,GAAG;IAC1B,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,UAAU,CAAC,EAAE,MAAM,CAAC;CACpB,CAAC;AAEF,eAAO,MAAM,gBAAgB;;;;;;;;;;;;;;;;;;;;;;;;;;EAgM3B,CAAC;AAIH,wBAAgB,wBAAwB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CA2EhE;AAED,wBAAgB,cAAc,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAExD"}
+{"version":3,"file":"notebook.d.ts","sourceRoot":"","sources":["../../src/tools/notebook.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAiHH,KAAK,mBAAmB,GAAG;IAC1B,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,UAAU,CAAC,EAAE,MAAM,CAAC;CACpB,CAAC;AAEF,eAAO,MAAM,gBAAgB;;;;;;;;;;;;;;;;;;;;;;;;;;;EAgM3B,CAAC;AAIH,wBAAgB,wBAAwB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CA2EhE;AAED,wBAAgB,cAAc,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAExD"}

package/dist/tools/oracle.d.ts

@@ -15,6 +15,7 @@ export declare const oracleTool: Readonly<{
         files: import("@sinclair/typebox").TOptional<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/oracle.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"oracle.d.ts","sourceRoot":"","sources":["../../src/tools/oracle.ts"],"names":[],"mappings":"AA0CA,MAAM,WAAW,iBAAiB;IACjC,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,KAAK,CAAC,EAAE,MAAM,EAAE,CAAC;CACjB;AAED,eAAO,MAAM,UAAU;;;;;;;;;;;;;;;;;;;;;;;;EAyKrB,CAAC"}
+{"version":3,"file":"oracle.d.ts","sourceRoot":"","sources":["../../src/tools/oracle.ts"],"names":[],"mappings":"AA2CA,MAAM,WAAW,iBAAiB;IACjC,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,KAAK,CAAC,EAAE,MAAM,EAAE,CAAC;CACjB;AAED,eAAO,MAAM,UAAU;;;;;;;;;;;;;;;;;;;;;;;;;EAyJrB,CAAC"}

package/dist/tools/oracle.js

@@ -3,6 +3,7 @@ import { randomUUID } from "node:crypto";
 import { unlinkSync, writeFileSync } from "node:fs";
 import { tmpdir } from "node:os";
 import { join } from "node:path";
+import { formatDelegation } from "@evalops/contracts";
 import { Type } from "@sinclair/typebox";
 import { getRegisteredModels } from "../models/registry.js";
 import { buildEvalOpsDelegationEnvironment, issueEvalOpsDelegationToken, } from "../oauth/index.js";
@@ -32,38 +33,22 @@ export const oracleTool = createTool({
         const model = selectOracleModel(modelOverride);
         // Create temporary input file with the Seer summoning
         const tmpFile = join(tmpdir(), `seer-${randomUUID()}.md`);
-        let prompt = `# Summoning the Seer
-
-You are **the Seer**, a prophetic software architect who peers beyond the immediate change to reveal hidden couplings, latent risks, and downstream effects. Temper intuition with evidence: inspect the provided artifacts first, then reason from what you observe. You wield foresight, deep reasoning, and a read-only toolset. You must **never** edit or run code.
-
-## Your Quest
-
-**Task:** ${task}
-
-`;
-        if (context) {
-            prompt += `**Context:** ${context}\n\n`;
-        }
-        if (files?.length) {
-            prompt += `**Artifacts to Examine:** ${files.join(", ")}\n\n`;
-        }
-        prompt += `## Method of Divination
-
-1. Read the referenced files or data before drawing conclusions
-2. Map observations to consequences, citing file paths and line numbers when possible  
-3. Surface trade-offs, alternatives, and assumptions
-
-## Revelation Format
-
-Respond with:
-
-**Summary:** one sentence capturing the core insight.
-
-**Insights:** concise bullets detailing findings, trade-offs, and hidden risks unearthed, grounded in the observed evidence.
-
-**Next steps:** optional guidance on follow-up actions, validations, or open questions.
-
-Always flag uncertainties, assumptions, or blind spots so the summoner knows where the vision grows dim.`;
+        const delegationPrompt = {
+            goal: "Provide read-only architectural guidance for a complex engineering decision.",
+            context: context ??
+                "The caller did not provide extra context beyond the task and artifacts.",
+            task,
+            evidence: files?.length
+                ? files.map((file) => `Artifact to examine: ${file}`)
+                : [],
+            validation: "Inspect referenced artifacts before drawing conclusions, cite file paths and line numbers when possible, and separate evidence from assumptions.",
+            stoppingCondition: "Stop after a concise response with Summary, Insights, optional Next steps, any uncertainties, then final lines `Effort: <S|M|L|XL> (<rough duration or reason>)` and optional `Revisit-if: <signal>`. Never edit or run code.",
+        };
+        const prompt = [
+            "You are the Seer, a read-only software architecture advisor. You must never edit or run code.",
+            "",
+            formatDelegation(delegationPrompt),
+        ].join("\n");
         writeFileSync(tmpFile, prompt);
         let fileCleanedUp = false;
         const cleanupFile = () => {

package/dist/tools/oracle.js.map

@@ -1 +1 @@
-{"version":3,"file":"oracle.js","sourceRoot":"","sources":["../../src/tools/oracle.ts"],"names":[],"mappings":"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","sourcesContent":["import { spawn } from \"node:child_process\";\nimport { randomUUID } from \"node:crypto\";\nimport { unlinkSync, writeFileSync } from \"node:fs\";\nimport { tmpdir } from \"node:os\";\nimport { join } from \"node:path\";\nimport { Type } from \"@sinclair/typebox\";\nimport type { Static } from \"@sinclair/typebox\";\nimport { getRegisteredModels } from \"../models/registry.js\";\nimport {\n\tbuildEvalOpsDelegationEnvironment,\n\tissueEvalOpsDelegationToken,\n} from \"../oauth/index.js\";\nimport { createTool } from \"./tool-dsl.js\";\nimport { readOnlyToolNames } from \"./tool-names.js\";\n\nconst ORACLE_TIMEOUT_MS = 120_000;\n\nconst oracleSchema = Type.Object({\n\ttask: Type.String({\n\t\tdescription:\n\t\t\t\"The task or question you want the Oracle to help with. Be specific about what kind of guidance, review, or planning you need.\",\n\t}),\n\tmodel: Type.Optional(\n\t\tType.String({\n\t\t\tdescription:\n\t\t\t\t\"Optional model id to use for the Oracle (must be available in your configured models). Defaults to a reasoning-capable model such as o3-mini.\",\n\t\t}),\n\t),\n\tcontext: Type.Optional(\n\t\tType.String({\n\t\t\tdescription:\n\t\t\t\t\"Optional context about the current situation, what you've tried, or background information that would help the Oracle provide better guidance.\",\n\t\t}),\n\t),\n\tfiles: Type.Optional(\n\t\tType.Array(Type.String(), {\n\t\t\tdescription:\n\t\t\t\t\"Optional list of specific file paths that the Oracle should examine as part of its analysis.\",\n\t\t}),\n\t),\n});\n\nexport interface OracleToolDetails {\n\ttask: string;\n\tmodel?: string;\n\tcontext?: string;\n\tfiles?: string[];\n}\n\nexport const oracleTool = createTool<typeof oracleSchema, OracleToolDetails>({\n\tname: \"oracle\",\n\tdescription:\n\t\t\"Summon the Seer - a mystical systems advisor that foresees consequences of complex engineering decisions. Ideal for architecture reviews, deep debugging, and strategic guidance.\",\n\tschema: oracleSchema,\n\tasync run(params, { respond, signal, toolCallId }) {\n\t\tconst { task, context, files, model: modelOverride } = params;\n\t\tconst model = selectOracleModel(modelOverride);\n\n\t\t// Create temporary input file with the Seer summoning\n\t\tconst tmpFile = join(tmpdir(), `seer-${randomUUID()}.md`);\n\n\t\tlet prompt = `# Summoning the Seer\n\nYou are **the Seer**, a prophetic software architect who peers beyond the immediate change to reveal hidden couplings, latent risks, and downstream effects. Temper intuition with evidence: inspect the provided artifacts first, then reason from what you observe. You wield foresight, deep reasoning, and a read-only toolset. You must **never** edit or run code.\n\n## Your Quest\n\n**Task:** ${task}\n\n`;\n\n\t\tif (context) {\n\t\t\tprompt += `**Context:** ${context}\\n\\n`;\n\t\t}\n\n\t\tif (files?.length) {\n\t\t\tprompt += `**Artifacts to Examine:** ${files.join(\", \")}\\n\\n`;\n\t\t}\n\n\t\tprompt += `## Method of Divination\n\n1. Read the referenced files or data before drawing conclusions\n2. Map observations to consequences, citing file paths and line numbers when possible  \n3. Surface trade-offs, alternatives, and assumptions\n\n## Revelation Format\n\nRespond with:\n\n**Summary:** one sentence capturing the core insight.\n\n**Insights:** concise bullets detailing findings, trade-offs, and hidden risks unearthed, grounded in the observed evidence.\n\n**Next steps:** optional guidance on follow-up actions, validations, or open questions.\n\nAlways flag uncertainties, assumptions, or blind spots so the summoner knows where the vision grows dim.`;\n\n\t\twriteFileSync(tmpFile, prompt);\n\n\t\tlet fileCleanedUp = false;\n\t\tconst cleanupFile = () => {\n\t\t\tif (fileCleanedUp) return;\n\t\t\tfileCleanedUp = true;\n\t\t\ttry {\n\t\t\t\tunlinkSync(tmpFile);\n\t\t\t} catch {\n\t\t\t\t// File already deleted or other error - ignore\n\t\t\t}\n\t\t};\n\n\t\ttry {\n\t\t\tconst env = await buildOracleEnv(toolCallId);\n\n\t\t\t// Spawn Seer subagent with read-only tools and reasoning model\n\t\t\tconst args = [\n\t\t\t\t\"--read-only\",\n\t\t\t\t\"--tools\",\n\t\t\t\treadOnlyToolNames.join(\",\"),\n\t\t\t\t\"--model\",\n\t\t\t\tmodel, // Use validated reasoning model for prophetic insights\n\t\t\t\t\"--no-session\",\n\t\t\t\t\"exec\",\n\t\t\t\ttmpFile,\n\t\t\t];\n\n\t\t\tconst result = await new Promise<string>((resolve, reject) => {\n\t\t\t\tif (signal?.aborted) {\n\t\t\t\t\tcleanupFile();\n\t\t\t\t\treject(new Error(\"Seer invocation aborted\"));\n\t\t\t\t\treturn;\n\t\t\t\t}\n\n\t\t\t\tconst seer = spawn(\"maestro\", args, {\n\t\t\t\t\tenv,\n\t\t\t\t\tstdio: [\"pipe\", \"pipe\", \"pipe\"],\n\t\t\t\t});\n\n\t\t\t\tlet output = \"\";\n\t\t\t\tlet errorOutput = \"\";\n\t\t\t\tlet timedOut = false;\n\t\t\t\tlet aborted = false;\n\t\t\t\tlet timeoutHandle: NodeJS.Timeout | null = null;\n\n\t\t\t\tconst killChild = () => {\n\t\t\t\t\tif (seer.pid) {\n\t\t\t\t\t\ttry {\n\t\t\t\t\t\t\tprocess.kill(seer.pid);\n\t\t\t\t\t\t} catch {\n\t\t\t\t\t\t\t// Already terminated\n\t\t\t\t\t\t}\n\t\t\t\t\t}\n\t\t\t\t};\n\n\t\t\t\tconst cleanupListeners = () => {\n\t\t\t\t\tif (timeoutHandle) {\n\t\t\t\t\t\tclearTimeout(timeoutHandle);\n\t\t\t\t\t}\n\t\t\t\t\tsignal?.removeEventListener(\"abort\", onAbort);\n\t\t\t\t};\n\n\t\t\t\tconst onAbort = () => {\n\t\t\t\t\taborted = true;\n\t\t\t\t\tkillChild();\n\t\t\t\t};\n\n\t\t\t\tif (signal) {\n\t\t\t\t\tsignal.addEventListener(\"abort\", onAbort);\n\t\t\t\t}\n\n\t\t\t\tconst startTimeout = () => {\n\t\t\t\t\ttimeoutHandle = setTimeout(() => {\n\t\t\t\t\t\ttimedOut = true;\n\t\t\t\t\t\tkillChild();\n\t\t\t\t\t}, ORACLE_TIMEOUT_MS);\n\t\t\t\t};\n\n\t\t\t\tstartTimeout();\n\n\t\t\t\tseer.stdout.on(\"data\", (data) => {\n\t\t\t\t\toutput += data.toString();\n\t\t\t\t});\n\n\t\t\t\tseer.stderr.on(\"data\", (data) => {\n\t\t\t\t\terrorOutput += data.toString();\n\t\t\t\t});\n\n\t\t\t\tseer.on(\"close\", (code) => {\n\t\t\t\t\tcleanupFile();\n\t\t\t\t\tcleanupListeners();\n\n\t\t\t\t\tif (code === 0 && !timedOut && !aborted) {\n\t\t\t\t\t\tresolve(output.trim());\n\t\t\t\t\t} else {\n\t\t\t\t\t\treject(\n\t\t\t\t\t\t\tnew Error(\n\t\t\t\t\t\t\t\taborted\n\t\t\t\t\t\t\t\t\t? \"Seer invocation aborted\"\n\t\t\t\t\t\t\t\t\t: timedOut\n\t\t\t\t\t\t\t\t\t\t? \"Seer divination timed out\"\n\t\t\t\t\t\t\t\t\t\t: `Seer divination failed (exit ${code}): ${errorOutput}`,\n\t\t\t\t\t\t\t),\n\t\t\t\t\t\t);\n\t\t\t\t\t}\n\t\t\t\t});\n\n\t\t\t\tseer.on(\"error\", (err) => {\n\t\t\t\t\tcleanupFile();\n\t\t\t\t\tcleanupListeners();\n\t\t\t\t\treject(new Error(`Failed to summon the Seer: ${err.message}`));\n\t\t\t\t});\n\t\t\t});\n\n\t\t\treturn respond.text(result);\n\t\t} catch (error) {\n\t\t\tcleanupFile();\n\t\t\tthrow error;\n\t\t}\n\t},\n});\n\nasync function buildOracleEnv(\n\ttoolCallId: string,\n): Promise<Record<string, string | undefined>> {\n\tconst baseEnv = { ...process.env };\n\n\ttry {\n\t\tconst delegation = await issueEvalOpsDelegationToken({\n\t\t\tagentId: toolCallId,\n\t\t\tagentType: \"oracle_seer\",\n\t\t\tcapabilities: [\"oracle_read_only\"],\n\t\t\trunId: toolCallId,\n\t\t\tsurface: \"maestro-oracle\",\n\t\t\ttoken: process.env.MAESTRO_EVALOPS_ACCESS_TOKEN,\n\t\t\tttlSeconds: Math.max(60, Math.ceil(ORACLE_TIMEOUT_MS / 1000)),\n\t\t});\n\n\t\treturn {\n\t\t\t...baseEnv,\n\t\t\t...buildEvalOpsDelegationEnvironment(delegation),\n\t\t};\n\t} catch (error) {\n\t\tconst message = error instanceof Error ? error.message : String(error);\n\t\tif (\n\t\t\tmessage.includes(\"Run /login evalops first\") ||\n\t\t\tmessage.includes(\"EvalOps login requires\")\n\t\t) {\n\t\t\treturn baseEnv;\n\t\t}\n\n\t\treturn baseEnv;\n\t}\n}\n\nfunction selectOracleModel(inputOverride?: string): string {\n\tconst envOverride = process.env.MAESTRO_ORACLE_MODEL?.trim();\n\tconst preferred =\n\t\tinputOverride?.trim() ||\n\t\t(envOverride && envOverride.length > 0 ? envOverride : \"o3-mini\");\n\tconst models = getRegisteredModels();\n\n\t// Try the preferred id and common provider-qualified variant\n\tconst candidates = [\n\t\tpreferred,\n\t\tpreferred.startsWith(\"openai/\") ? preferred : `openai/${preferred}`,\n\t];\n\tconst found = models.find((m) => candidates.includes(m.id));\n\tif (found) {\n\t\treturn found.id;\n\t}\n\n\t// Fall back to any reasoning-capable model\n\tconst reasoning = models.find((m) => m.reasoning === true);\n\tif (reasoning) {\n\t\treturn reasoning.id;\n\t}\n\n\t// As a last resort, fall back to any configured model so the tool can still run.\n\t// This prevents hard runtime failures while surfacing a clear warning.\n\tconst fallback = models.at(0);\n\tif (fallback) {\n\t\treturn fallback.id;\n\t}\n\n\t// No acceptable model configured\n\tconst available = models.map((m) => m.id).join(\", \");\n\tthrow new Error(\n\t\t`No model configured for Oracle. Tried ${preferred}. Set MAESTRO_ORACLE_MODEL to an available model or add a reasoning-capable model. Available models: ${available || \"none\"}.`,\n\t);\n}\n"]}
+{"version":3,"file":"oracle.js","sourceRoot":"","sources":["../../src/tools/oracle.ts"],"names":[],"mappings":"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","sourcesContent":["import { spawn } from \"node:child_process\";\nimport { randomUUID } from \"node:crypto\";\nimport { unlinkSync, writeFileSync } from \"node:fs\";\nimport { tmpdir } from \"node:os\";\nimport { join } from \"node:path\";\nimport { type DelegationPrompt, formatDelegation } from \"@evalops/contracts\";\nimport { Type } from \"@sinclair/typebox\";\nimport type { Static } from \"@sinclair/typebox\";\nimport { getRegisteredModels } from \"../models/registry.js\";\nimport {\n\tbuildEvalOpsDelegationEnvironment,\n\tissueEvalOpsDelegationToken,\n} from \"../oauth/index.js\";\nimport { createTool } from \"./tool-dsl.js\";\nimport { readOnlyToolNames } from \"./tool-names.js\";\n\nconst ORACLE_TIMEOUT_MS = 120_000;\n\nconst oracleSchema = Type.Object({\n\ttask: Type.String({\n\t\tdescription:\n\t\t\t\"The task or question you want the Oracle to help with. Be specific about what kind of guidance, review, or planning you need.\",\n\t}),\n\tmodel: Type.Optional(\n\t\tType.String({\n\t\t\tdescription:\n\t\t\t\t\"Optional model id to use for the Oracle (must be available in your configured models). Defaults to a reasoning-capable model such as o3-mini.\",\n\t\t}),\n\t),\n\tcontext: Type.Optional(\n\t\tType.String({\n\t\t\tdescription:\n\t\t\t\t\"Optional context about the current situation, what you've tried, or background information that would help the Oracle provide better guidance.\",\n\t\t}),\n\t),\n\tfiles: Type.Optional(\n\t\tType.Array(Type.String(), {\n\t\t\tdescription:\n\t\t\t\t\"Optional list of specific file paths that the Oracle should examine as part of its analysis.\",\n\t\t}),\n\t),\n});\n\nexport interface OracleToolDetails {\n\ttask: string;\n\tmodel?: string;\n\tcontext?: string;\n\tfiles?: string[];\n}\n\nexport const oracleTool = createTool<typeof oracleSchema, OracleToolDetails>({\n\tname: \"oracle\",\n\tdescription:\n\t\t\"Summon the Seer - a mystical systems advisor that foresees consequences of complex engineering decisions. Ideal for architecture reviews, deep debugging, and strategic guidance.\",\n\tschema: oracleSchema,\n\tasync run(params, { respond, signal, toolCallId }) {\n\t\tconst { task, context, files, model: modelOverride } = params;\n\t\tconst model = selectOracleModel(modelOverride);\n\n\t\t// Create temporary input file with the Seer summoning\n\t\tconst tmpFile = join(tmpdir(), `seer-${randomUUID()}.md`);\n\n\t\tconst delegationPrompt: DelegationPrompt = {\n\t\t\tgoal: \"Provide read-only architectural guidance for a complex engineering decision.\",\n\t\t\tcontext:\n\t\t\t\tcontext ??\n\t\t\t\t\"The caller did not provide extra context beyond the task and artifacts.\",\n\t\t\ttask,\n\t\t\tevidence: files?.length\n\t\t\t\t? files.map((file) => `Artifact to examine: ${file}`)\n\t\t\t\t: [],\n\t\t\tvalidation:\n\t\t\t\t\"Inspect referenced artifacts before drawing conclusions, cite file paths and line numbers when possible, and separate evidence from assumptions.\",\n\t\t\tstoppingCondition:\n\t\t\t\t\"Stop after a concise response with Summary, Insights, optional Next steps, any uncertainties, then final lines `Effort: <S|M|L|XL> (<rough duration or reason>)` and optional `Revisit-if: <signal>`. Never edit or run code.\",\n\t\t};\n\t\tconst prompt = [\n\t\t\t\"You are the Seer, a read-only software architecture advisor. You must never edit or run code.\",\n\t\t\t\"\",\n\t\t\tformatDelegation(delegationPrompt),\n\t\t].join(\"\\n\");\n\n\t\twriteFileSync(tmpFile, prompt);\n\n\t\tlet fileCleanedUp = false;\n\t\tconst cleanupFile = () => {\n\t\t\tif (fileCleanedUp) return;\n\t\t\tfileCleanedUp = true;\n\t\t\ttry {\n\t\t\t\tunlinkSync(tmpFile);\n\t\t\t} catch {\n\t\t\t\t// File already deleted or other error - ignore\n\t\t\t}\n\t\t};\n\n\t\ttry {\n\t\t\tconst env = await buildOracleEnv(toolCallId);\n\n\t\t\t// Spawn Seer subagent with read-only tools and reasoning model\n\t\t\tconst args = [\n\t\t\t\t\"--read-only\",\n\t\t\t\t\"--tools\",\n\t\t\t\treadOnlyToolNames.join(\",\"),\n\t\t\t\t\"--model\",\n\t\t\t\tmodel, // Use validated reasoning model for prophetic insights\n\t\t\t\t\"--no-session\",\n\t\t\t\t\"exec\",\n\t\t\t\ttmpFile,\n\t\t\t];\n\n\t\t\tconst result = await new Promise<string>((resolve, reject) => {\n\t\t\t\tif (signal?.aborted) {\n\t\t\t\t\tcleanupFile();\n\t\t\t\t\treject(new Error(\"Seer invocation aborted\"));\n\t\t\t\t\treturn;\n\t\t\t\t}\n\n\t\t\t\tconst seer = spawn(\"maestro\", args, {\n\t\t\t\t\tenv,\n\t\t\t\t\tstdio: [\"pipe\", \"pipe\", \"pipe\"],\n\t\t\t\t});\n\n\t\t\t\tlet output = \"\";\n\t\t\t\tlet errorOutput = \"\";\n\t\t\t\tlet timedOut = false;\n\t\t\t\tlet aborted = false;\n\t\t\t\tlet timeoutHandle: NodeJS.Timeout | null = null;\n\n\t\t\t\tconst killChild = () => {\n\t\t\t\t\tif (seer.pid) {\n\t\t\t\t\t\ttry {\n\t\t\t\t\t\t\tprocess.kill(seer.pid);\n\t\t\t\t\t\t} catch {\n\t\t\t\t\t\t\t// Already terminated\n\t\t\t\t\t\t}\n\t\t\t\t\t}\n\t\t\t\t};\n\n\t\t\t\tconst cleanupListeners = () => {\n\t\t\t\t\tif (timeoutHandle) {\n\t\t\t\t\t\tclearTimeout(timeoutHandle);\n\t\t\t\t\t}\n\t\t\t\t\tsignal?.removeEventListener(\"abort\", onAbort);\n\t\t\t\t};\n\n\t\t\t\tconst onAbort = () => {\n\t\t\t\t\taborted = true;\n\t\t\t\t\tkillChild();\n\t\t\t\t};\n\n\t\t\t\tif (signal) {\n\t\t\t\t\tsignal.addEventListener(\"abort\", onAbort);\n\t\t\t\t}\n\n\t\t\t\tconst startTimeout = () => {\n\t\t\t\t\ttimeoutHandle = setTimeout(() => {\n\t\t\t\t\t\ttimedOut = true;\n\t\t\t\t\t\tkillChild();\n\t\t\t\t\t}, ORACLE_TIMEOUT_MS);\n\t\t\t\t};\n\n\t\t\t\tstartTimeout();\n\n\t\t\t\tseer.stdout.on(\"data\", (data) => {\n\t\t\t\t\toutput += data.toString();\n\t\t\t\t});\n\n\t\t\t\tseer.stderr.on(\"data\", (data) => {\n\t\t\t\t\terrorOutput += data.toString();\n\t\t\t\t});\n\n\t\t\t\tseer.on(\"close\", (code) => {\n\t\t\t\t\tcleanupFile();\n\t\t\t\t\tcleanupListeners();\n\n\t\t\t\t\tif (code === 0 && !timedOut && !aborted) {\n\t\t\t\t\t\tresolve(output.trim());\n\t\t\t\t\t} else {\n\t\t\t\t\t\treject(\n\t\t\t\t\t\t\tnew Error(\n\t\t\t\t\t\t\t\taborted\n\t\t\t\t\t\t\t\t\t? \"Seer invocation aborted\"\n\t\t\t\t\t\t\t\t\t: timedOut\n\t\t\t\t\t\t\t\t\t\t? \"Seer divination timed out\"\n\t\t\t\t\t\t\t\t\t\t: `Seer divination failed (exit ${code}): ${errorOutput}`,\n\t\t\t\t\t\t\t),\n\t\t\t\t\t\t);\n\t\t\t\t\t}\n\t\t\t\t});\n\n\t\t\t\tseer.on(\"error\", (err) => {\n\t\t\t\t\tcleanupFile();\n\t\t\t\t\tcleanupListeners();\n\t\t\t\t\treject(new Error(`Failed to summon the Seer: ${err.message}`));\n\t\t\t\t});\n\t\t\t});\n\n\t\t\treturn respond.text(result);\n\t\t} catch (error) {\n\t\t\tcleanupFile();\n\t\t\tthrow error;\n\t\t}\n\t},\n});\n\nasync function buildOracleEnv(\n\ttoolCallId: string,\n): Promise<Record<string, string | undefined>> {\n\tconst baseEnv = { ...process.env };\n\n\ttry {\n\t\tconst delegation = await issueEvalOpsDelegationToken({\n\t\t\tagentId: toolCallId,\n\t\t\tagentType: \"oracle_seer\",\n\t\t\tcapabilities: [\"oracle_read_only\"],\n\t\t\trunId: toolCallId,\n\t\t\tsurface: \"maestro-oracle\",\n\t\t\ttoken: process.env.MAESTRO_EVALOPS_ACCESS_TOKEN,\n\t\t\tttlSeconds: Math.max(60, Math.ceil(ORACLE_TIMEOUT_MS / 1000)),\n\t\t});\n\n\t\treturn {\n\t\t\t...baseEnv,\n\t\t\t...buildEvalOpsDelegationEnvironment(delegation),\n\t\t};\n\t} catch (error) {\n\t\tconst message = error instanceof Error ? error.message : String(error);\n\t\tif (\n\t\t\tmessage.includes(\"Run /login evalops first\") ||\n\t\t\tmessage.includes(\"EvalOps login requires\")\n\t\t) {\n\t\t\treturn baseEnv;\n\t\t}\n\n\t\treturn baseEnv;\n\t}\n}\n\nfunction selectOracleModel(inputOverride?: string): string {\n\tconst envOverride = process.env.MAESTRO_ORACLE_MODEL?.trim();\n\tconst preferred =\n\t\tinputOverride?.trim() ||\n\t\t(envOverride && envOverride.length > 0 ? envOverride : \"o3-mini\");\n\tconst models = getRegisteredModels();\n\n\t// Try the preferred id and common provider-qualified variant\n\tconst candidates = [\n\t\tpreferred,\n\t\tpreferred.startsWith(\"openai/\") ? preferred : `openai/${preferred}`,\n\t];\n\tconst found = models.find((m) => candidates.includes(m.id));\n\tif (found) {\n\t\treturn found.id;\n\t}\n\n\t// Fall back to any reasoning-capable model\n\tconst reasoning = models.find((m) => m.reasoning === true);\n\tif (reasoning) {\n\t\treturn reasoning.id;\n\t}\n\n\t// As a last resort, fall back to any configured model so the tool can still run.\n\t// This prevents hard runtime failures while surfacing a clear warning.\n\tconst fallback = models.at(0);\n\tif (fallback) {\n\t\treturn fallback.id;\n\t}\n\n\t// No acceptable model configured\n\tconst available = models.map((m) => m.id).join(\", \");\n\tthrow new Error(\n\t\t`No model configured for Oracle. Tried ${preferred}. Set MAESTRO_ORACLE_MODEL to an available model or add a reasoning-capable model. Available models: ${available || \"none\"}.`,\n\t);\n}\n"]}

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

@@ -26,7 +26,7 @@
  *
  * @module tools/parallel-execution
  */
-import type { AgentTool, ToolAnnotations } from "../agent/types.js";
+import type { AgentTool, ToolAnnotations, ToolSourceMetadata } from "../agent/types.js";
 /**
  * Set of known read-only tool names.
  *
@@ -50,7 +50,8 @@ export declare const WRITE_TOOLS: Set<string>;
  * @param annotations - Optional tool annotations
  * @returns true if the tool is read-only
  */
-export declare function isReadOnlyTool(toolName: string, annotations?: ToolAnnotations): boolean;
+export declare function isReadOnlyTool(toolName: string, annotations?: ToolAnnotations, _source?: ToolSourceMetadata): boolean;
+export declare function isParallelSafeTool(toolName: string, annotations?: ToolAnnotations, source?: ToolSourceMetadata): boolean;
 /**
  * Check if a tool is a write/mutating operation.
  *
@@ -100,6 +101,16 @@ export declare function partitionToolCalls<T extends {
     readOnly: T[];
     write: T[];
 };
+export interface PathScopedMutation {
+    paths: string[];
+    source: "annotation" | "known_tool";
+    argumentKeys?: string[];
+}
+export declare function getPathScopedMutation(toolCall: {
+    name: string;
+    arguments?: unknown;
+}, tool?: AgentTool, cwd?: string): PathScopedMutation | undefined;
+export declare function pathScopesOverlap(left: PathScopedMutation, right: PathScopedMutation): boolean;
 /**
  * Add read-only annotation to a tool definition.
  *

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

@@ -1 +1 @@
-{"version":3,"file":"parallel-execution.d.ts","sourceRoot":"","sources":["../../src/tools/parallel-execution.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AAEpE;;;;;;;GAOG;AACH,eAAO,MAAM,eAAe,aAgC1B,CAAC;AAEH;;;;;GAKG;AACH,eAAO,MAAM,WAAW,aAWtB,CAAC;AAEH;;;;;;GAMG;AACH,wBAAgB,cAAc,CAC7B,QAAQ,EAAE,MAAM,EAChB,WAAW,CAAC,EAAE,eAAe,GAC3B,OAAO,CAWT;AAED;;;;;;GAMG;AACH,wBAAgB,WAAW,CAC1B,QAAQ,EAAE,MAAM,EAChB,WAAW,CAAC,EAAE,eAAe,GAC3B,OAAO,CAOT;AAED;;GAEG;AACH,MAAM,WAAW,uBAAuB;IACvC,0CAA0C;IAC1C,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,6DAA6D;IAC7D,sBAAsB,CAAC,EAAE,MAAM,CAAC;IAChC,8DAA8D;IAC9D,OAAO,CAAC,EAAE,OAAO,CAAC;CAClB;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,qBAAqB,CACpC,SAAS,EAAE,KAAK,CAAC;IAAE,IAAI,EAAE,MAAM,CAAA;CAAE,CAAC,EAClC,KAAK,EAAE,SAAS,EAAE,EAClB,MAAM,CAAC,EAAE,uBAAuB,GAC9B,MAAM,CA2BR;AAED;;;;;;;;;GASG;AACH,wBAAgB,kBAAkB,CAAC,CAAC,SAAS;IAAE,IAAI,EAAE,MAAM,CAAA;CAAE,EAC5D,SAAS,EAAE,CAAC,EAAE,EACd,KAAK,EAAE,SAAS,EAAE,GAChB;IAAE,QAAQ,EAAE,CAAC,EAAE,CAAC;IAAC,KAAK,EAAE,CAAC,EAAE,CAAA;CAAE,CAkB/B;AAED;;;;;;;GAOG;AACH,wBAAgB,YAAY,CAAC,CAAC,SAAS,SAAS,EAAE,IAAI,EAAE,CAAC,GAAG,CAAC,CAQ5D;AAED;;;;;GAKG;AACH,wBAAgB,eAAe,CAAC,CAAC,SAAS,SAAS,EAAE,IAAI,EAAE,CAAC,GAAG,CAAC,CAQ/D"}
+{"version":3,"file":"parallel-execution.d.ts","sourceRoot":"","sources":["../../src/tools/parallel-execution.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AAGH,OAAO,KAAK,EACX,SAAS,EACT,eAAe,EACf,kBAAkB,EAClB,MAAM,mBAAmB,CAAC;AAE3B;;;;;;;GAOG;AACH,eAAO,MAAM,eAAe,aAgC1B,CAAC;AAEH;;;;;GAKG;AACH,eAAO,MAAM,WAAW,aAYtB,CAAC;AAEH;;;;;;GAMG;AACH,wBAAgB,cAAc,CAC7B,QAAQ,EAAE,MAAM,EAChB,WAAW,CAAC,EAAE,eAAe,EAC7B,OAAO,CAAC,EAAE,kBAAkB,GAC1B,OAAO,CAWT;AAED,wBAAgB,kBAAkB,CACjC,QAAQ,EAAE,MAAM,EAChB,WAAW,CAAC,EAAE,eAAe,EAC7B,MAAM,CAAC,EAAE,kBAAkB,GACzB,OAAO,CAQT;AAED;;;;;;GAMG;AACH,wBAAgB,WAAW,CAC1B,QAAQ,EAAE,MAAM,EAChB,WAAW,CAAC,EAAE,eAAe,GAC3B,OAAO,CAOT;AAED;;GAEG;AACH,MAAM,WAAW,uBAAuB;IACvC,0CAA0C;IAC1C,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,6DAA6D;IAC7D,sBAAsB,CAAC,EAAE,MAAM,CAAC;IAChC,8DAA8D;IAC9D,OAAO,CAAC,EAAE,OAAO,CAAC;CAClB;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,qBAAqB,CACpC,SAAS,EAAE,KAAK,CAAC;IAAE,IAAI,EAAE,MAAM,CAAA;CAAE,CAAC,EAClC,KAAK,EAAE,SAAS,EAAE,EAClB,MAAM,CAAC,EAAE,uBAAuB,GAC9B,MAAM,CAkCR;AAED;;;;;;;;;GASG;AACH,wBAAgB,kBAAkB,CAAC,CAAC,SAAS;IAAE,IAAI,EAAE,MAAM,CAAA;CAAE,EAC5D,SAAS,EAAE,CAAC,EAAE,EACd,KAAK,EAAE,SAAS,EAAE,GAChB;IAAE,QAAQ,EAAE,CAAC,EAAE,CAAC;IAAC,KAAK,EAAE,CAAC,EAAE,CAAA;CAAE,CAyB/B;AAED,MAAM,WAAW,kBAAkB;IAClC,KAAK,EAAE,MAAM,EAAE,CAAC;IAChB,MAAM,EAAE,YAAY,GAAG,YAAY,CAAC;IACpC,YAAY,CAAC,EAAE,MAAM,EAAE,CAAC;CACxB;AAsID,wBAAgB,qBAAqB,CACpC,QAAQ,EAAE;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,SAAS,CAAC,EAAE,OAAO,CAAA;CAAE,EAC/C,IAAI,CAAC,EAAE,SAAS,EAChB,GAAG,SAAgB,GACjB,kBAAkB,GAAG,SAAS,CAyChC;AAED,wBAAgB,iBAAiB,CAChC,IAAI,EAAE,kBAAkB,EACxB,KAAK,EAAE,kBAAkB,GACvB,OAAO,CAST;AAED;;;;;;;GAOG;AACH,wBAAgB,YAAY,CAAC,CAAC,SAAS,SAAS,EAAE,IAAI,EAAE,CAAC,GAAG,CAAC,CAQ5D;AAED;;;;;GAKG;AACH,wBAAgB,eAAe,CAAC,CAAC,SAAS,SAAS,EAAE,IAAI,EAAE,CAAC,GAAG,CAAC,CAQ/D"}