mcp-agent-foundry 1.3.1 → 2.0.0

package/dist/mcp/auto-mode.js

@@ -0,0 +1,436 @@
+/**
+ * MCP Auto Mode
+ *
+ * Automatically defers tool descriptions when they would exceed a configurable
+ * percentage of the context window. This prevents context overflow in long
+ * sessions with many tools.
+ *
+ * Based on Claude Code v2.1.7's MCP Auto Mode feature.
+ *
+ * Key features:
+ * - Configurable percentage threshold for tool descriptions
+ * - Priority-based tool selection
+ * - Always-include and always-defer lists
+ * - On-demand fetching of deferred tool descriptions
+ * - Force-include override for user requests
+ */
+// ============================================================================
+// Default Configuration
+// ============================================================================
+const DEFAULT_CONFIG = {
+    enabled: true,
+    maxToolDescriptionPercent: 10,
+    minToolsToInclude: 5,
+    alwaysInclude: [],
+    alwaysDefer: [],
+};
+// ============================================================================
+// MCPAutoMode Class
+// ============================================================================
+/**
+ * MCP Auto Mode - Intelligent tool description management
+ *
+ * Automatically defers tool descriptions that would exceed context limits.
+ * This is based on Claude Code v2.1.7's MCP Auto Mode feature.
+ *
+ * @example
+ * ```typescript
+ * const autoMode = new MCPAutoMode(
+ *   { maxToolDescriptionPercent: 15 },
+ *   contextManager,
+ *   logger
+ * );
+ *
+ * // Register tools
+ * autoMode.registerTool({
+ *   name: 'invoke_agent',
+ *   description: 'Invoke a specialized agent...',
+ *   estimatedTokens: 150,
+ *   priority: 10,
+ * });
+ *
+ * // Before each request, process tools
+ * const contextState = contextManager.getState('openai', 'gpt-4o', messages);
+ * const result = autoMode.processForRequest(contextState);
+ *
+ * // Use result.includedTools for this request
+ * if (result.hadDeferrals) {
+ *   console.log(result.deferralMessage);
+ * }
+ * ```
+ */
+export class MCPAutoMode {
+    config;
+    contextManager;
+    logger;
+    toolRegistry = new Map();
+    forcedIncludes = new Set();
+    /**
+     * Create a new MCPAutoMode instance.
+     *
+     * @param config - Partial configuration (merged with defaults)
+     * @param contextManager - ContextManager for token estimation
+     * @param logger - Logger instance for observability
+     */
+    constructor(config, contextManager, logger) {
+        this.config = {
+            ...DEFAULT_CONFIG,
+            ...config,
+            alwaysInclude: config.alwaysInclude ?? DEFAULT_CONFIG.alwaysInclude,
+            alwaysDefer: config.alwaysDefer ?? DEFAULT_CONFIG.alwaysDefer,
+        };
+        this.contextManager = contextManager;
+        this.logger = logger;
+        this.logger.debug('MCPAutoMode initialized', {
+            enabled: this.config.enabled,
+            maxToolDescriptionPercent: this.config.maxToolDescriptionPercent,
+            minToolsToInclude: this.config.minToolsToInclude,
+            alwaysIncludeCount: this.config.alwaysInclude?.length ?? 0,
+            alwaysDeferCount: this.config.alwaysDefer?.length ?? 0,
+        });
+    }
+    // ==========================================================================
+    // Tool Registration
+    // ==========================================================================
+    /**
+     * Register a tool with its description.
+     *
+     * @param tool - Tool descriptor to register
+     */
+    registerTool(tool) {
+        // Validate tool
+        if (!tool.name) {
+            this.logger.warn('Attempted to register tool without name', { tool });
+            return;
+        }
+        // Set defaults
+        const normalizedTool = {
+            ...tool,
+            priority: tool.priority ?? 0,
+            deferred: false,
+            estimatedTokens: tool.estimatedTokens > 0
+                ? tool.estimatedTokens
+                : this.estimateToolTokens(tool),
+        };
+        this.toolRegistry.set(tool.name, normalizedTool);
+        this.logger.debug('Tool registered', {
+            name: tool.name,
+            estimatedTokens: normalizedTool.estimatedTokens,
+            priority: normalizedTool.priority,
+        });
+    }
+    /**
+     * Unregister a tool.
+     *
+     * @param name - Name of tool to unregister
+     */
+    unregisterTool(name) {
+        if (this.toolRegistry.has(name)) {
+            this.toolRegistry.delete(name);
+            this.forcedIncludes.delete(name);
+            this.logger.debug('Tool unregistered', { name });
+        }
+    }
+    /**
+     * Get all registered tools.
+     *
+     * @returns Array of all tool descriptors
+     */
+    getAllTools() {
+        return Array.from(this.toolRegistry.values());
+    }
+    /**
+     * Calculate total tokens for all tool descriptions.
+     *
+     * @returns Total estimated tokens
+     */
+    getTotalToolTokens() {
+        let total = 0;
+        for (const tool of this.toolRegistry.values()) {
+            total += tool.estimatedTokens;
+        }
+        return total;
+    }
+    // ==========================================================================
+    // Request Processing
+    // ==========================================================================
+    /**
+     * Process tools for a request given current context state.
+     * Returns which tools to include and which to defer.
+     *
+     * @param contextState - Current context state from ContextManager
+     * @param requestedTools - Optional list of specifically requested tool names
+     * @returns AutoModeResult with included/deferred tools
+     */
+    processForRequest(contextState, requestedTools) {
+        // If auto mode is disabled, include all tools
+        if (!this.config.enabled) {
+            const allTools = Array.from(this.toolRegistry.keys());
+            return {
+                includedTools: allTools,
+                deferredTools: [],
+                tokensSaved: 0,
+                hadDeferrals: false,
+            };
+        }
+        // Calculate how many tokens we can use for tools
+        const maxToolTokens = Math.floor(contextState.maxTokens * (this.config.maxToolDescriptionPercent / 100));
+        this.logger.debug('Processing tools for request', {
+            maxToolTokens,
+            totalRegisteredTools: this.toolRegistry.size,
+            requestedToolsCount: requestedTools?.length ?? 0,
+        });
+        // Sort tools by priority
+        const sortedTools = this.getSortedTools(requestedTools);
+        // Greedily include tools until we hit the limit
+        const included = [];
+        const deferred = [];
+        let usedTokens = 0;
+        for (const tool of sortedTools) {
+            // Always include first
+            if (this.config.alwaysInclude?.includes(tool.name)) {
+                included.push(tool.name);
+                usedTokens += tool.estimatedTokens;
+                tool.deferred = false;
+                continue;
+            }
+            // Always defer
+            if (this.config.alwaysDefer?.includes(tool.name) && !this.forcedIncludes.has(tool.name)) {
+                deferred.push(tool.name);
+                tool.deferred = true;
+                continue;
+            }
+            // Forced includes from user override
+            if (this.forcedIncludes.has(tool.name)) {
+                included.push(tool.name);
+                usedTokens += tool.estimatedTokens;
+                tool.deferred = false;
+                continue;
+            }
+            // Check if we have room (always include minimum tools)
+            if (usedTokens + tool.estimatedTokens <= maxToolTokens ||
+                included.length < this.config.minToolsToInclude) {
+                included.push(tool.name);
+                usedTokens += tool.estimatedTokens;
+                tool.deferred = false;
+            }
+            else {
+                deferred.push(tool.name);
+                tool.deferred = true;
+            }
+        }
+        // Calculate tokens saved
+        const tokensSaved = this.calculateTokensSaved(deferred);
+        const result = {
+            includedTools: included,
+            deferredTools: deferred,
+            tokensSaved,
+            hadDeferrals: deferred.length > 0,
+            deferralMessage: deferred.length > 0
+                ? `${deferred.length} tool${deferred.length !== 1 ? 's' : ''} deferred to save context (${tokensSaved} tokens saved). Use tool explicitly to include.`
+                : undefined,
+        };
+        this.logger.debug('Tool processing completed', {
+            includedCount: included.length,
+            deferredCount: deferred.length,
+            tokensSaved,
+            usedTokens,
+            maxToolTokens,
+        });
+        return result;
+    }
+    /**
+     * Get deferred tool description on demand.
+     * (When user explicitly requests a deferred tool)
+     *
+     * @param name - Name of deferred tool
+     * @returns Tool descriptor if found, undefined otherwise
+     */
+    getDeferredToolDescription(name) {
+        const tool = this.toolRegistry.get(name);
+        if (tool?.deferred) {
+            this.logger.debug('Fetching deferred tool description', { name });
+            return tool;
+        }
+        return undefined;
+    }
+    /**
+     * Check if a specific tool is currently deferred.
+     *
+     * @param name - Tool name to check
+     * @returns True if tool is deferred
+     */
+    isDeferred(name) {
+        return this.toolRegistry.get(name)?.deferred ?? false;
+    }
+    /**
+     * Force include a deferred tool (user override).
+     * This tool will be included in subsequent requests until reset.
+     *
+     * @param name - Tool name to force include
+     */
+    forceInclude(name) {
+        if (this.toolRegistry.has(name)) {
+            this.forcedIncludes.add(name);
+            const tool = this.toolRegistry.get(name);
+            if (tool) {
+                tool.deferred = false;
+            }
+            this.logger.debug('Tool force-included', { name });
+        }
+        else {
+            this.logger.warn('Attempted to force-include unknown tool', { name });
+        }
+    }
+    /**
+     * Reset all deferrals and force-includes.
+     */
+    resetDeferrals() {
+        this.forcedIncludes.clear();
+        for (const tool of this.toolRegistry.values()) {
+            tool.deferred = false;
+        }
+        this.logger.debug('Deferrals reset');
+    }
+    /**
+     * Mark a tool as recently used (for recency-based prioritization).
+     *
+     * @param name - Tool name that was used
+     */
+    markToolUsed(name) {
+        const tool = this.toolRegistry.get(name);
+        if (tool) {
+            tool.lastUsedAt = Date.now();
+        }
+    }
+    // ==========================================================================
+    // Configuration
+    // ==========================================================================
+    /**
+     * Get current configuration.
+     *
+     * @returns Current MCPAutoModeConfig
+     */
+    getConfig() {
+        return { ...this.config };
+    }
+    /**
+     * Update configuration.
+     *
+     * @param config - Partial configuration to merge
+     */
+    updateConfig(config) {
+        this.config = {
+            ...this.config,
+            ...config,
+            alwaysInclude: config.alwaysInclude ?? this.config.alwaysInclude,
+            alwaysDefer: config.alwaysDefer ?? this.config.alwaysDefer,
+        };
+        this.logger.debug('MCPAutoMode config updated', {
+            enabled: this.config.enabled,
+            maxToolDescriptionPercent: this.config.maxToolDescriptionPercent,
+            minToolsToInclude: this.config.minToolsToInclude,
+        });
+    }
+    // ==========================================================================
+    // Private Methods
+    // ==========================================================================
+    /**
+     * Sort tools by priority for inclusion decisions.
+     *
+     * Priority order:
+     * 1. Tools in alwaysInclude
+     * 2. Tools explicitly requested for this call
+     * 3. Tools that were force-included by user
+     * 4. Recently used tools
+     * 5. Tools with higher priority scores
+     * 6. Other tools
+     * 7. Tools in alwaysDefer (lowest priority)
+     */
+    getSortedTools(requestedTools) {
+        const tools = Array.from(this.toolRegistry.values());
+        const requestedSet = new Set(requestedTools ?? []);
+        const alwaysIncludeSet = new Set(this.config.alwaysInclude ?? []);
+        const alwaysDeferSet = new Set(this.config.alwaysDefer ?? []);
+        const now = Date.now();
+        return tools.sort((a, b) => {
+            // 1. alwaysInclude tools first
+            const aAlwaysInclude = alwaysIncludeSet.has(a.name) ? 1 : 0;
+            const bAlwaysInclude = alwaysIncludeSet.has(b.name) ? 1 : 0;
+            if (aAlwaysInclude !== bAlwaysInclude) {
+                return bAlwaysInclude - aAlwaysInclude;
+            }
+            // 2. Explicitly requested tools
+            const aRequested = requestedSet.has(a.name) ? 1 : 0;
+            const bRequested = requestedSet.has(b.name) ? 1 : 0;
+            if (aRequested !== bRequested) {
+                return bRequested - aRequested;
+            }
+            // 3. Force-included tools
+            const aForced = this.forcedIncludes.has(a.name) ? 1 : 0;
+            const bForced = this.forcedIncludes.has(b.name) ? 1 : 0;
+            if (aForced !== bForced) {
+                return bForced - aForced;
+            }
+            // 4. Recently used tools (within last 5 minutes)
+            const recentThreshold = 5 * 60 * 1000; // 5 minutes
+            const aRecent = a.lastUsedAt && (now - a.lastUsedAt) < recentThreshold ? 1 : 0;
+            const bRecent = b.lastUsedAt && (now - b.lastUsedAt) < recentThreshold ? 1 : 0;
+            if (aRecent !== bRecent) {
+                return bRecent - aRecent;
+            }
+            // 5. Priority score (higher = more important)
+            const priorityDiff = (b.priority ?? 0) - (a.priority ?? 0);
+            if (priorityDiff !== 0) {
+                return priorityDiff;
+            }
+            // 6. alwaysDefer tools last
+            const aAlwaysDefer = alwaysDeferSet.has(a.name) ? 1 : 0;
+            const bAlwaysDefer = alwaysDeferSet.has(b.name) ? 1 : 0;
+            if (aAlwaysDefer !== bAlwaysDefer) {
+                return aAlwaysDefer - bAlwaysDefer;
+            }
+            // 7. Alphabetical as tie-breaker for consistency
+            return a.name.localeCompare(b.name);
+        });
+    }
+    /**
+     * Calculate total tokens saved by deferring tools.
+     */
+    calculateTokensSaved(deferredTools) {
+        let total = 0;
+        for (const name of deferredTools) {
+            const tool = this.toolRegistry.get(name);
+            if (tool) {
+                total += tool.estimatedTokens;
+            }
+        }
+        return total;
+    }
+    /**
+     * Estimate token count for a tool based on its description.
+     * Uses the context manager's estimation logic.
+     */
+    estimateToolTokens(tool) {
+        // Base estimate from description
+        const descriptionTokens = this.contextManager.estimateTokens(tool.description);
+        // Add overhead for tool schema (name, parameters structure)
+        const schemaOverhead = 20;
+        return descriptionTokens + schemaOverhead;
+    }
+}
+// ============================================================================
+// Factory Function
+// ============================================================================
+/**
+ * Create an MCPAutoMode instance.
+ *
+ * @param config - Partial configuration (merged with defaults)
+ * @param contextManager - ContextManager instance
+ * @param logger - Logger instance
+ * @returns Configured MCPAutoMode instance
+ */
+export function createMCPAutoMode(config, contextManager, logger) {
+    return new MCPAutoMode(config, contextManager, logger);
+}
+//# sourceMappingURL=auto-mode.js.map

package/dist/mcp/auto-mode.js.map

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

package/dist/mcp/index.d.ts

@@ -0,0 +1,14 @@
+/**
+ * MCP Module Index
+ *
+ * Exports MCP-related functionality including:
+ * - Auto Mode for intelligent tool description management
+ * - Tool registration utilities
+ * - Transport implementations
+ */
+export { MCPAutoMode, createMCPAutoMode, } from './auto-mode.js';
+export type { MCPAutoModeConfig, ToolDescriptor, AutoModeResult, } from './auto-mode.js';
+export { registerTools } from './tools/index.js';
+export { registerInvokeAgentTool, registerCompareAgentsTool, registerCritiquePlanTool, registerDesignFeedbackTool, registerReviewCodeTool, registerWorktreeTools, registerWorktreeManagementTools, registerResolveConflictsTool, registerListWorktreesTool, registerCleanupWorktreesTool, registerGetWorktreeStatusTool, } from './tools/index.js';
+export { createStdioTransport } from './transport/stdio.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/mcp/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/mcp/index.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAMH,OAAO,EACL,WAAW,EACX,iBAAiB,GAClB,MAAM,gBAAgB,CAAC;AAExB,YAAY,EACV,iBAAiB,EACjB,cAAc,EACd,cAAc,GACf,MAAM,gBAAgB,CAAC;AAMxB,OAAO,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AAEjD,OAAO,EACL,uBAAuB,EACvB,yBAAyB,EACzB,wBAAwB,EACxB,0BAA0B,EAC1B,sBAAsB,EACtB,qBAAqB,EACrB,+BAA+B,EAC/B,4BAA4B,EAC5B,yBAAyB,EACzB,4BAA4B,EAC5B,6BAA6B,GAC9B,MAAM,kBAAkB,CAAC;AAM1B,OAAO,EAAE,oBAAoB,EAAE,MAAM,sBAAsB,CAAC"}

package/dist/mcp/index.js

@@ -0,0 +1,22 @@
+/**
+ * MCP Module Index
+ *
+ * Exports MCP-related functionality including:
+ * - Auto Mode for intelligent tool description management
+ * - Tool registration utilities
+ * - Transport implementations
+ */
+// ============================================================================
+// Auto Mode
+// ============================================================================
+export { MCPAutoMode, createMCPAutoMode, } from './auto-mode.js';
+// ============================================================================
+// Tools
+// ============================================================================
+export { registerTools } from './tools/index.js';
+export { registerInvokeAgentTool, registerCompareAgentsTool, registerCritiquePlanTool, registerDesignFeedbackTool, registerReviewCodeTool, registerWorktreeTools, registerWorktreeManagementTools, registerResolveConflictsTool, registerListWorktreesTool, registerCleanupWorktreesTool, registerGetWorktreeStatusTool, } from './tools/index.js';
+// ============================================================================
+// Transport
+// ============================================================================
+export { createStdioTransport } from './transport/stdio.js';
+//# sourceMappingURL=index.js.map

package/dist/mcp/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/mcp/index.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,+EAA+E;AAC/E,YAAY;AACZ,+EAA+E;AAE/E,OAAO,EACL,WAAW,EACX,iBAAiB,GAClB,MAAM,gBAAgB,CAAC;AAQxB,+EAA+E;AAC/E,QAAQ;AACR,+EAA+E;AAE/E,OAAO,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AAEjD,OAAO,EACL,uBAAuB,EACvB,yBAAyB,EACzB,wBAAwB,EACxB,0BAA0B,EAC1B,sBAAsB,EACtB,qBAAqB,EACrB,+BAA+B,EAC/B,4BAA4B,EAC5B,yBAAyB,EACzB,4BAA4B,EAC5B,6BAA6B,GAC9B,MAAM,kBAAkB,CAAC;AAE1B,+EAA+E;AAC/E,YAAY;AACZ,+EAA+E;AAE/E,OAAO,EAAE,oBAAoB,EAAE,MAAM,sBAAsB,CAAC"}

package/dist/mcp/tools/tasks/delete-task.d.ts

@@ -0,0 +1,25 @@
+/**
+ * delete_task MCP Tool
+ *
+ * Deletes a task from the state coordinator and optionally cleans up
+ * any associated worktree resources.
+ */
+import { type McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import type { Logger } from "../../../observability/logger.js";
+import type { TaskCoordinator } from "../../../tasks/coordinator.js";
+/**
+ * Registers the delete_task tool with the MCP server
+ *
+ * @param server - MCP server instance
+ * @param coordinator - TaskCoordinator for task lifecycle management
+ * @param logger - Logger instance for structured logging
+ *
+ * @example
+ * ```typescript
+ * const server = new McpServer({ name: 'agent-foundry', version: '1.0.0' });
+ * const coordinator = new TaskCoordinator({ logger });
+ * registerDeleteTaskTool(server, coordinator, logger);
+ * ```
+ */
+export declare function registerDeleteTaskTool(server: McpServer, coordinator: TaskCoordinator, logger: Logger): void;
+//# sourceMappingURL=delete-task.d.ts.map

package/dist/mcp/tools/tasks/delete-task.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"delete-task.d.ts","sourceRoot":"","sources":["../../../../src/mcp/tools/tasks/delete-task.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,KAAK,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAGzE,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,kCAAkC,CAAC;AAC/D,OAAO,KAAK,EAAE,eAAe,EAAoB,MAAM,+BAA+B,CAAC;AAsFvF;;;;;;;;;;;;;GAaG;AACH,wBAAgB,sBAAsB,CACpC,MAAM,EAAE,SAAS,EACjB,WAAW,EAAE,eAAe,EAC5B,MAAM,EAAE,MAAM,GACb,IAAI,CAkFN"}

package/dist/mcp/tools/tasks/delete-task.js

@@ -0,0 +1,148 @@
+/**
+ * delete_task MCP Tool
+ *
+ * Deletes a task from the state coordinator and optionally cleans up
+ * any associated worktree resources.
+ */
+import { z } from "zod";
+// ============================================================================
+// Constants
+// ============================================================================
+/**
+ * Tool description for delete_task
+ */
+const TOOL_DESCRIPTION = "Delete a task from the state coordinator. " +
+    "By default, running tasks cannot be deleted unless force is set to true. " +
+    "Optionally cleans up any associated git worktree.";
+// ============================================================================
+// Input Schema
+// ============================================================================
+/**
+ * Zod schema shape for delete_task input validation.
+ */
+const deleteTaskInputSchemaShape = {
+    taskId: z.string().min(1).describe("The task ID to delete"),
+    force: z
+        .boolean()
+        .optional()
+        .default(false)
+        .describe("Force deletion even if the task is currently running (default: false)"),
+    deleteWorktree: z
+        .boolean()
+        .optional()
+        .default(true)
+        .describe("Delete the associated worktree if one exists (default: true)"),
+    reason: z
+        .string()
+        .optional()
+        .describe("Optional reason for deletion (logged for audit purposes)"),
+};
+// ============================================================================
+// Response Formatter
+// ============================================================================
+/**
+ * Formats the task deletion response for MCP text output
+ */
+function formatDeleteTaskResponse(taskId, result, reason) {
+    if (!result.success) {
+        return (`## Task Deletion Failed\n\n` +
+            `**Task ID:** ${taskId}\n` +
+            `**Error:** ${result.error ?? "Unknown error"}\n`);
+    }
+    let response = `## Task Deleted Successfully\n\n` +
+        `**Task ID:** ${taskId}\n` +
+        `**Task Removed:** ${result.taskDeleted ? "Yes" : "No"}\n` +
+        `**Worktree Removed:** ${result.worktreeDeleted ? "Yes" : "No"}\n`;
+    if (reason) {
+        response += `**Reason:** ${reason}\n`;
+    }
+    return response;
+}
+// ============================================================================
+// Tool Registration
+// ============================================================================
+/**
+ * Registers the delete_task tool with the MCP server
+ *
+ * @param server - MCP server instance
+ * @param coordinator - TaskCoordinator for task lifecycle management
+ * @param logger - Logger instance for structured logging
+ *
+ * @example
+ * ```typescript
+ * const server = new McpServer({ name: 'agent-foundry', version: '1.0.0' });
+ * const coordinator = new TaskCoordinator({ logger });
+ * registerDeleteTaskTool(server, coordinator, logger);
+ * ```
+ */
+export function registerDeleteTaskTool(server, coordinator, logger) {
+    // Use type assertion to work around Zod version compatibility issues
+    /* eslint-disable @typescript-eslint/no-explicit-any, @typescript-eslint/no-unsafe-assignment */
+    const inputSchema = deleteTaskInputSchemaShape;
+    server.registerTool("delete_task", {
+        title: "Delete Task",
+        description: TOOL_DESCRIPTION,
+        inputSchema,
+    }, 
+    /* eslint-enable @typescript-eslint/no-explicit-any, @typescript-eslint/no-unsafe-assignment */
+    async (args) => {
+        const { taskId, force, deleteWorktree, reason } = args;
+        logger.info("delete_task called", {
+            taskId,
+            force,
+            deleteWorktree,
+            reason,
+        });
+        try {
+            const result = await coordinator.deleteTask(taskId, {
+                force,
+                deleteWorktree,
+                reason,
+            });
+            if (result.success) {
+                logger.info("delete_task completed", {
+                    taskId,
+                    taskDeleted: result.taskDeleted,
+                    worktreeDeleted: result.worktreeDeleted,
+                });
+            }
+            else {
+                logger.warn("delete_task failed", {
+                    taskId,
+                    error: result.error,
+                });
+            }
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: formatDeleteTaskResponse(taskId, result, reason),
+                    },
+                ],
+            };
+        }
+        catch (error) {
+            const errorMessage = error instanceof Error ? error.message : String(error);
+            logger.error("delete_task failed with exception", {
+                taskId,
+                error: error instanceof Error ? error : undefined,
+                errorMessage,
+            });
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: formatDeleteTaskResponse(taskId, {
+                            success: false,
+                            taskDeleted: false,
+                            worktreeDeleted: false,
+                            error: errorMessage,
+                        }, reason),
+                    },
+                ],
+            };
+        }
+    });
+    logger.debug("Registered delete_task tool");
+}
+//# sourceMappingURL=delete-task.js.map