mcp-agent-foundry 1.3.1 → 2.0.0

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

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

package/dist/mcp/tools/tasks/index.d.ts

@@ -19,6 +19,7 @@ import type { WorktreeManager } from "../../../worktrees/manager.js";
  * - execute_pipeline: Create multi-provider task pipelines with dependency resolution
  * - claim_next_task: Generate instructions for workers to claim available tasks
  * - get_pipeline_status: Query the execution status of a pipeline
+ * - delete_task: Delete a task and optionally clean up its worktree
  *
  * @param server - The MCP server instance
  * @param router - The router engine for agent invocation
@@ -30,6 +31,7 @@ import type { WorktreeManager } from "../../../worktrees/manager.js";
 export declare function registerTaskTools(server: McpServer, router: RouterEngine, coordinator: TaskCoordinator, pipelineManager: PipelineManager, logger: Logger, worktreeManager?: WorktreeManager): void;
 export { registerExecuteTaskTool } from "./execute-task.js";
 export { registerCreateRoutedTaskTool } from "./create-routed-task.js";
+export { registerDeleteTaskTool } from "./delete-task.js";
 export { registerExecutePipelineTool } from "./execute-pipeline.js";
 export { registerClaimNextTaskTool } from "./claim-next-task.js";
 export { registerGetPipelineStatusTool, type GetPipelineStatusToolOptions, } from "./get-pipeline-status.js";

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/mcp/tools/tasks/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,KAAK,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAEzE,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,kCAAkC,CAAC;AAC/D,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,2BAA2B,CAAC;AAC9D,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,+BAA+B,CAAC;AACrE,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,oCAAoC,CAAC;AAC1E,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,+BAA+B,CAAC;AAYrE;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,iBAAiB,CAC/B,MAAM,EAAE,SAAS,EACjB,MAAM,EAAE,YAAY,EACpB,WAAW,EAAE,eAAe,EAC5B,eAAe,EAAE,eAAe,EAChC,MAAM,EAAE,MAAM,EACd,eAAe,CAAC,EAAE,eAAe,GAChC,IAAI,CA+BN;AAMD,OAAO,EAAE,uBAAuB,EAAE,MAAM,mBAAmB,CAAC;AAC5D,OAAO,EAAE,4BAA4B,EAAE,MAAM,yBAAyB,CAAC;AACvE,OAAO,EAAE,2BAA2B,EAAE,MAAM,uBAAuB,CAAC;AACpE,OAAO,EAAE,yBAAyB,EAAE,MAAM,sBAAsB,CAAC;AACjE,OAAO,EACL,6BAA6B,EAC7B,KAAK,4BAA4B,GAClC,MAAM,0BAA0B,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/mcp/tools/tasks/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,KAAK,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAEzE,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,kCAAkC,CAAC;AAC/D,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,2BAA2B,CAAC;AAC9D,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,+BAA+B,CAAC;AACrE,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,oCAAoC,CAAC;AAC1E,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,+BAA+B,CAAC;AAarE;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,iBAAiB,CAC/B,MAAM,EAAE,SAAS,EACjB,MAAM,EAAE,YAAY,EACpB,WAAW,EAAE,eAAe,EAC5B,eAAe,EAAE,eAAe,EAChC,MAAM,EAAE,MAAM,EACd,eAAe,CAAC,EAAE,eAAe,GAChC,IAAI,CAmCN;AAMD,OAAO,EAAE,uBAAuB,EAAE,MAAM,mBAAmB,CAAC;AAC5D,OAAO,EAAE,4BAA4B,EAAE,MAAM,yBAAyB,CAAC;AACvE,OAAO,EAAE,sBAAsB,EAAE,MAAM,kBAAkB,CAAC;AAC1D,OAAO,EAAE,2BAA2B,EAAE,MAAM,uBAAuB,CAAC;AACpE,OAAO,EAAE,yBAAyB,EAAE,MAAM,sBAAsB,CAAC;AACjE,OAAO,EACL,6BAA6B,EAC7B,KAAK,4BAA4B,GAClC,MAAM,0BAA0B,CAAC"}

package/dist/mcp/tools/tasks/index.js

@@ -6,6 +6,7 @@
  */
 import { registerClaimNextTaskTool } from "./claim-next-task.js";
 import { registerCreateRoutedTaskTool } from "./create-routed-task.js";
+import { registerDeleteTaskTool } from "./delete-task.js";
 import { registerExecutePipelineTool } from "./execute-pipeline.js";
 import { registerExecuteTaskTool } from "./execute-task.js";
 import { registerGetPipelineStatusTool } from "./get-pipeline-status.js";
@@ -21,6 +22,7 @@ import { registerGetPipelineStatusTool } from "./get-pipeline-status.js";
  * - execute_pipeline: Create multi-provider task pipelines with dependency resolution
  * - claim_next_task: Generate instructions for workers to claim available tasks
  * - get_pipeline_status: Query the execution status of a pipeline
+ * - delete_task: Delete a task and optionally clean up its worktree
  *
  * @param server - The MCP server instance
  * @param router - The router engine for agent invocation
@@ -45,6 +47,8 @@ export function registerTaskTools(server, router, coordinator, pipelineManager,
     registerGetPipelineStatusTool(server, pipelineManager, logger, {
         worktreesEnabled: !!worktreeManager,
     });
+    // Register delete_task tool
+    registerDeleteTaskTool(server, coordinator, logger);
     logger.info("Task tools registered successfully", {
         tools: [
             "execute_task",
@@ -52,6 +56,7 @@ export function registerTaskTools(server, router, coordinator, pipelineManager,
             "execute_pipeline",
             "claim_next_task",
             "get_pipeline_status",
+            "delete_task",
         ],
     });
 }
@@ -60,6 +65,7 @@ export function registerTaskTools(server, router, coordinator, pipelineManager,
 // ============================================================================
 export { registerExecuteTaskTool } from "./execute-task.js";
 export { registerCreateRoutedTaskTool } from "./create-routed-task.js";
+export { registerDeleteTaskTool } from "./delete-task.js";
 export { registerExecutePipelineTool } from "./execute-pipeline.js";
 export { registerClaimNextTaskTool } from "./claim-next-task.js";
 export { registerGetPipelineStatusTool, } from "./get-pipeline-status.js";

package/dist/mcp/tools/tasks/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/mcp/tools/tasks/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAUH,OAAO,EAAE,yBAAyB,EAAE,MAAM,sBAAsB,CAAC;AACjE,OAAO,EAAE,4BAA4B,EAAE,MAAM,yBAAyB,CAAC;AACvE,OAAO,EAAE,2BAA2B,EAAE,MAAM,uBAAuB,CAAC;AACpE,OAAO,EAAE,uBAAuB,EAAE,MAAM,mBAAmB,CAAC;AAC5D,OAAO,EAAE,6BAA6B,EAAE,MAAM,0BAA0B,CAAC;AAEzE,+EAA+E;AAC/E,2BAA2B;AAC3B,+EAA+E;AAE/E;;;;;;;;;;;;;;;;GAgBG;AACH,MAAM,UAAU,iBAAiB,CAC/B,MAAiB,EACjB,MAAoB,EACpB,WAA4B,EAC5B,eAAgC,EAChC,MAAc,EACd,eAAiC;IAEjC,MAAM,CAAC,IAAI,CAAC,wBAAwB,EAAE;QACpC,eAAe,EAAE,CAAC,CAAC,eAAe;KACnC,CAAC,CAAC;IAEH,8DAA8D;IAC9D,uBAAuB,CAAC,MAAM,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,EAAE,eAAe,CAAC,CAAC;IAE9E,mCAAmC;IACnC,4BAA4B,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAE7C,kEAAkE;IAClE,2BAA2B,CAAC,MAAM,EAAE,eAAe,EAAE,MAAM,EAAE,eAAe,CAAC,CAAC;IAE9E,gCAAgC;IAChC,yBAAyB,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAE1C,sEAAsE;IACtE,6BAA6B,CAAC,MAAM,EAAE,eAAe,EAAE,MAAM,EAAE;QAC7D,gBAAgB,EAAE,CAAC,CAAC,eAAe;KACpC,CAAC,CAAC;IAEH,MAAM,CAAC,IAAI,CAAC,oCAAoC,EAAE;QAChD,KAAK,EAAE;YACL,cAAc;YACd,oBAAoB;YACpB,kBAAkB;YAClB,iBAAiB;YACjB,qBAAqB;SACtB;KACF,CAAC,CAAC;AACL,CAAC;AAED,+EAA+E;AAC/E,UAAU;AACV,+EAA+E;AAE/E,OAAO,EAAE,uBAAuB,EAAE,MAAM,mBAAmB,CAAC;AAC5D,OAAO,EAAE,4BAA4B,EAAE,MAAM,yBAAyB,CAAC;AACvE,OAAO,EAAE,2BAA2B,EAAE,MAAM,uBAAuB,CAAC;AACpE,OAAO,EAAE,yBAAyB,EAAE,MAAM,sBAAsB,CAAC;AACjE,OAAO,EACL,6BAA6B,GAE9B,MAAM,0BAA0B,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/mcp/tools/tasks/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAUH,OAAO,EAAE,yBAAyB,EAAE,MAAM,sBAAsB,CAAC;AACjE,OAAO,EAAE,4BAA4B,EAAE,MAAM,yBAAyB,CAAC;AACvE,OAAO,EAAE,sBAAsB,EAAE,MAAM,kBAAkB,CAAC;AAC1D,OAAO,EAAE,2BAA2B,EAAE,MAAM,uBAAuB,CAAC;AACpE,OAAO,EAAE,uBAAuB,EAAE,MAAM,mBAAmB,CAAC;AAC5D,OAAO,EAAE,6BAA6B,EAAE,MAAM,0BAA0B,CAAC;AAEzE,+EAA+E;AAC/E,2BAA2B;AAC3B,+EAA+E;AAE/E;;;;;;;;;;;;;;;;;GAiBG;AACH,MAAM,UAAU,iBAAiB,CAC/B,MAAiB,EACjB,MAAoB,EACpB,WAA4B,EAC5B,eAAgC,EAChC,MAAc,EACd,eAAiC;IAEjC,MAAM,CAAC,IAAI,CAAC,wBAAwB,EAAE;QACpC,eAAe,EAAE,CAAC,CAAC,eAAe;KACnC,CAAC,CAAC;IAEH,8DAA8D;IAC9D,uBAAuB,CAAC,MAAM,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,EAAE,eAAe,CAAC,CAAC;IAE9E,mCAAmC;IACnC,4BAA4B,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAE7C,kEAAkE;IAClE,2BAA2B,CAAC,MAAM,EAAE,eAAe,EAAE,MAAM,EAAE,eAAe,CAAC,CAAC;IAE9E,gCAAgC;IAChC,yBAAyB,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAE1C,sEAAsE;IACtE,6BAA6B,CAAC,MAAM,EAAE,eAAe,EAAE,MAAM,EAAE;QAC7D,gBAAgB,EAAE,CAAC,CAAC,eAAe;KACpC,CAAC,CAAC;IAEH,4BAA4B;IAC5B,sBAAsB,CAAC,MAAM,EAAE,WAAW,EAAE,MAAM,CAAC,CAAC;IAEpD,MAAM,CAAC,IAAI,CAAC,oCAAoC,EAAE;QAChD,KAAK,EAAE;YACL,cAAc;YACd,oBAAoB;YACpB,kBAAkB;YAClB,iBAAiB;YACjB,qBAAqB;YACrB,aAAa;SACd;KACF,CAAC,CAAC;AACL,CAAC;AAED,+EAA+E;AAC/E,UAAU;AACV,+EAA+E;AAE/E,OAAO,EAAE,uBAAuB,EAAE,MAAM,mBAAmB,CAAC;AAC5D,OAAO,EAAE,4BAA4B,EAAE,MAAM,yBAAyB,CAAC;AACvE,OAAO,EAAE,sBAAsB,EAAE,MAAM,kBAAkB,CAAC;AAC1D,OAAO,EAAE,2BAA2B,EAAE,MAAM,uBAAuB,CAAC;AACpE,OAAO,EAAE,yBAAyB,EAAE,MAAM,sBAAsB,CAAC;AACjE,OAAO,EACL,6BAA6B,GAE9B,MAAM,0BAA0B,CAAC"}

package/dist/observability/debug-logger.d.ts

@@ -0,0 +1,209 @@
+/**
+ * Debug Logger Module
+ *
+ * A specialized debug logger for Agent Foundry that can be enabled/disabled
+ * and configured to log specific types of events. Supports file output for
+ * persistent debug logs.
+ */
+import type { Logger } from './logger.js';
+/**
+ * Configuration for the debug logger.
+ */
+export interface DebugLoggerConfig {
+    /** Enable debug logging */
+    enabled: boolean;
+    /** Log tool calls */
+    logToolCalls: boolean;
+    /** Log tool outputs (can be verbose) */
+    logToolOutputs: boolean;
+    /** Log provider requests */
+    logProviderRequests: boolean;
+    /** Log provider responses */
+    logProviderResponses: boolean;
+    /** Log failover events */
+    logFailovers: boolean;
+    /** Log hook executions */
+    logHooks: boolean;
+    /** Maximum output size to log (truncate beyond) */
+    maxOutputSize: number;
+    /** Output file for debug logs (optional) */
+    outputFile?: string;
+}
+/**
+ * A single debug log entry.
+ */
+export interface DebugLogEntry {
+    /** ISO timestamp */
+    timestamp: string;
+    /** Type of log entry */
+    type: string;
+    /** Log data */
+    data: unknown;
+}
+/**
+ * Specialized debug logger for Agent Foundry.
+ *
+ * Provides granular control over what events are logged and supports
+ * writing debug logs to a file for later analysis.
+ *
+ * @example
+ * ```typescript
+ * const debugLogger = new DebugLogger({ enabled: true }, logger);
+ *
+ * // Log a tool call
+ * debugLogger.toolCall('invoke_agent', { role: 'coder', task: '...' });
+ *
+ * // Log a failover event
+ * debugLogger.failover('openai', 'anthropic', 'Rate limited (429)');
+ *
+ * // Clean up
+ * await debugLogger.close();
+ * ```
+ */
+export declare class DebugLogger {
+    private readonly config;
+    private readonly logger;
+    private fileStream;
+    private initialized;
+    /**
+     * Create a new DebugLogger instance.
+     *
+     * @param config - Partial configuration (merged with defaults)
+     * @param logger - Base logger for fallback logging
+     */
+    constructor(config: Partial<DebugLoggerConfig>, logger: Logger);
+    /**
+     * Check if debug logging is enabled.
+     */
+    isEnabled(): boolean;
+    /**
+     * Log a tool call (if enabled).
+     *
+     * @param tool - Tool name
+     * @param input - Tool input parameters
+     */
+    toolCall(tool: string, input: unknown): void;
+    /**
+     * Log a tool result (if enabled).
+     *
+     * @param tool - Tool name
+     * @param output - Tool output
+     * @param durationMs - Execution duration in milliseconds
+     */
+    toolResult(tool: string, output: unknown, durationMs: number): void;
+    /**
+     * Log a tool error (always logged if debug enabled).
+     *
+     * @param tool - Tool name
+     * @param error - Error that occurred
+     */
+    toolError(tool: string, error: Error): void;
+    /**
+     * Log a tool denial (always logged if debug enabled).
+     *
+     * @param tool - Tool name
+     * @param reason - Denial reason
+     */
+    toolDenial(tool: string, reason: string): void;
+    /**
+     * Log a provider request (if enabled).
+     *
+     * @param provider - Provider name
+     * @param model - Model name
+     * @param messages - Request messages
+     */
+    providerRequest(provider: string, model: string, messages: unknown): void;
+    /**
+     * Log a provider response (if enabled).
+     *
+     * @param provider - Provider name
+     * @param model - Model name
+     * @param response - Provider response
+     * @param durationMs - Request duration in milliseconds
+     */
+    providerResponse(provider: string, model: string, response: unknown, durationMs: number): void;
+    /**
+     * Log a failover event (always logged if debug enabled).
+     *
+     * @param from - Provider being switched from
+     * @param to - Provider being switched to
+     * @param reason - Reason for failover
+     */
+    failover(from: string, to: string, reason: string): void;
+    /**
+     * Log a provider health change.
+     *
+     * @param provider - Provider name
+     * @param previousStatus - Previous health status
+     * @param newStatus - New health status
+     * @param reason - Reason for change
+     */
+    healthChange(provider: string, previousStatus: string, newStatus: string, reason: string): void;
+    /**
+     * Log a rate limit warning.
+     *
+     * @param provider - Provider name
+     * @param remaining - Remaining requests
+     * @param limit - Total limit
+     * @param usedPercentage - Percentage of limit used
+     * @param resetsAt - When the rate limit resets
+     */
+    rateLimitWarning(provider: string, remaining: number, limit: number, usedPercentage: number, resetsAt: Date): void;
+    /**
+     * Log a hook execution (if enabled).
+     *
+     * @param hookName - Name of the hook
+     * @param event - Event that triggered the hook
+     * @param output - Hook output
+     */
+    hookExecution(hookName: string, event: string, output: unknown): void;
+    /**
+     * Log a circuit breaker state change.
+     *
+     * @param provider - Provider name
+     * @param previousState - Previous circuit state
+     * @param newState - New circuit state
+     * @param failureCount - Number of failures
+     */
+    circuitBreakerChange(provider: string, previousState: string, newState: string, failureCount: number): void;
+    /**
+     * Log a custom debug event.
+     *
+     * @param type - Event type
+     * @param data - Event data
+     */
+    custom(type: string, data: unknown): void;
+    /**
+     * Flush and close the file handle.
+     */
+    close(): Promise<void>;
+    /**
+     * Initialize the file stream for debug output.
+     */
+    private initFileStream;
+    /**
+     * Write a debug log entry.
+     */
+    private writeEntry;
+    /**
+     * Truncate data to max output size.
+     */
+    private truncate;
+    /**
+     * Format current timestamp for log entries.
+     */
+    private formatTimestamp;
+}
+/**
+ * Create a DebugLogger instance with the given configuration.
+ *
+ * @param config - Partial configuration (merged with defaults)
+ * @param logger - Base logger for fallback logging
+ * @returns DebugLogger instance
+ */
+export declare function createDebugLogger(config: Partial<DebugLoggerConfig>, logger: Logger): DebugLogger;
+/**
+ * Re-export types for convenience.
+ */
+export type { Logger };
+//# sourceMappingURL=debug-logger.d.ts.map

package/dist/observability/debug-logger.d.ts.map

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