agentic-flow 2.0.7 → 3.0.0-alpha.2

package/dist/mcp/fastmcp/tools/explainability-tools.js

@@ -0,0 +1,429 @@
+/**
+ * Explainability MCP Tools - Full Transparency for Trust, Debugging, and Compliance
+ *
+ * 10 MCP tools for explainability features:
+ * 1. start_trace - Begin execution trace
+ * 2. end_trace - Complete execution trace
+ * 3. get_trace - Retrieve execution trace
+ * 4. capture_attention - Capture attention visualization
+ * 5. build_decision_tree - Build decision tree
+ * 6. generate_counterfactual - Generate counterfactual explanation
+ * 7. analyze_feature_importance - Analyze feature importance
+ * 8. generate_performance_profile - Generate performance profile
+ * 9. generate_compliance_report - Generate compliance report
+ * 10. get_explainability_metrics - Get explainability metrics
+ */
+import { ExplainabilityService } from '../../../services/explainability-service.js';
+const service = ExplainabilityService.getInstance();
+/**
+ * Register explainability tools with FastMCP server
+ */
+export function registerExplainabilityTools(server) {
+    for (const tool of explainabilityTools) {
+        server.addTool({
+            name: tool.name,
+            description: tool.description,
+            parameters: tool.inputSchema,
+            execute: tool.handler,
+        });
+    }
+}
+export const explainabilityTools = [
+    // 1. Start Trace
+    {
+        name: 'explainability_start_trace',
+        description: 'Begin execution trace for debugging and compliance',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                traceId: {
+                    type: 'string',
+                    description: 'Unique trace identifier'
+                }
+            },
+            required: ['traceId']
+        },
+        handler: async (args) => {
+            const trace = service.startTrace(args.traceId);
+            return {
+                success: true,
+                trace: {
+                    traceId: trace.traceId,
+                    startTime: trace.startTime,
+                    steps: trace.steps.length
+                }
+            };
+        }
+    },
+    // 2. End Trace
+    {
+        name: 'explainability_end_trace',
+        description: 'Complete execution trace',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                traceId: {
+                    type: 'string',
+                    description: 'Trace identifier'
+                },
+                modelUsed: {
+                    type: 'string',
+                    description: 'Model used for execution'
+                },
+                totalCost: {
+                    type: 'number',
+                    description: 'Total cost in USD'
+                },
+                success: {
+                    type: 'boolean',
+                    description: 'Execution success status'
+                },
+                error: {
+                    type: 'string',
+                    description: 'Error message if failed'
+                }
+            },
+            required: ['traceId', 'modelUsed', 'totalCost', 'success']
+        },
+        handler: async (args) => {
+            service.endTrace(args.traceId, args.modelUsed, args.totalCost, args.success, args.error);
+            const trace = service.getTrace(args.traceId);
+            return {
+                success: true,
+                trace: trace ? {
+                    traceId: trace.traceId,
+                    durationMs: trace.durationMs,
+                    modelUsed: trace.modelUsed,
+                    totalCost: trace.totalCost,
+                    success: trace.success,
+                    steps: trace.steps.length
+                } : null
+            };
+        }
+    },
+    // 3. Get Trace
+    {
+        name: 'explainability_get_trace',
+        description: 'Retrieve execution trace for debugging',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                traceId: {
+                    type: 'string',
+                    description: 'Trace identifier'
+                }
+            },
+            required: ['traceId']
+        },
+        handler: async (args) => {
+            const trace = service.getTrace(args.traceId);
+            if (!trace) {
+                return {
+                    success: false,
+                    error: `Trace ${args.traceId} not found`
+                };
+            }
+            return {
+                success: true,
+                trace: {
+                    traceId: trace.traceId,
+                    startTime: trace.startTime,
+                    endTime: trace.endTime,
+                    durationMs: trace.durationMs,
+                    modelUsed: trace.modelUsed,
+                    totalCost: trace.totalCost,
+                    success: trace.success,
+                    error: trace.error,
+                    steps: trace.steps.map(step => ({
+                        stepId: step.stepId,
+                        type: step.type,
+                        timestamp: step.timestamp,
+                        durationMs: step.durationMs,
+                        description: step.description,
+                        metadata: step.metadata
+                    }))
+                }
+            };
+        }
+    },
+    // 4. Capture Attention
+    {
+        name: 'explainability_capture_attention',
+        description: 'Capture attention visualization to see what model focuses on',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                traceId: {
+                    type: 'string',
+                    description: 'Trace identifier'
+                },
+                inputText: {
+                    type: 'string',
+                    description: 'Input text to the model'
+                },
+                outputText: {
+                    type: 'string',
+                    description: 'Output text from the model'
+                },
+                heads: {
+                    type: 'array',
+                    description: 'Attention heads with weights',
+                    items: {
+                        type: 'object',
+                        properties: {
+                            headId: { type: 'number' },
+                            layer: { type: 'number' },
+                            weights: {
+                                type: 'array',
+                                items: {
+                                    type: 'object',
+                                    properties: {
+                                        token: { type: 'string' },
+                                        weight: { type: 'number' },
+                                        position: { type: 'number' }
+                                    }
+                                }
+                            },
+                            topK: {
+                                type: 'array',
+                                items: { type: 'string' }
+                            }
+                        }
+                    }
+                }
+            },
+            required: ['traceId', 'inputText', 'outputText', 'heads']
+        },
+        handler: async (args) => {
+            const viz = service.captureAttention(args.traceId, args.inputText, args.outputText, args.heads);
+            return {
+                success: true,
+                visualization: {
+                    traceId: viz.traceId,
+                    focusTokens: viz.focusTokens,
+                    totalHeads: viz.heads.length,
+                    aggregatedWeights: Array.from(viz.aggregatedWeights.entries()).map(([token, weight]) => ({
+                        token,
+                        weight
+                    }))
+                }
+            };
+        }
+    },
+    // 5. Build Decision Tree
+    {
+        name: 'explainability_build_decision_tree',
+        description: 'Build decision tree to explain routing and model selection',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                traceId: {
+                    type: 'string',
+                    description: 'Trace identifier'
+                },
+                rootNode: {
+                    type: 'object',
+                    description: 'Root decision node',
+                    properties: {
+                        nodeId: { type: 'string' },
+                        decision: { type: 'string' },
+                        reasoning: { type: 'string' },
+                        confidence: { type: 'number' },
+                        alternatives: {
+                            type: 'array',
+                            items: {
+                                type: 'object',
+                                properties: {
+                                    decision: { type: 'string' },
+                                    confidence: { type: 'number' },
+                                    reasoning: { type: 'string' }
+                                }
+                            }
+                        },
+                        children: {
+                            type: 'array',
+                            items: { type: 'object' }
+                        }
+                    },
+                    required: ['nodeId', 'decision', 'reasoning', 'confidence']
+                }
+            },
+            required: ['traceId', 'rootNode']
+        },
+        handler: async (args) => {
+            const rootNode = {
+                ...args.rootNode,
+                alternatives: args.rootNode.alternatives || [],
+                children: args.rootNode.children || []
+            };
+            const tree = service.buildDecisionTree(args.traceId, rootNode);
+            return {
+                success: true,
+                tree: {
+                    traceId: tree.traceId,
+                    depth: tree.depth,
+                    totalNodes: tree.totalNodes,
+                    criticalPath: tree.criticalPath,
+                    rootDecision: tree.rootNode.decision
+                }
+            };
+        }
+    },
+    // 6. Generate Counterfactual
+    {
+        name: 'explainability_generate_counterfactual',
+        description: 'Generate counterfactual explanation ("What if we changed X?")',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                traceId: {
+                    type: 'string',
+                    description: 'Trace identifier'
+                },
+                original: {
+                    type: 'object',
+                    description: 'Original input parameters'
+                },
+                modifications: {
+                    type: 'object',
+                    description: 'Parameters to modify'
+                }
+            },
+            required: ['traceId', 'original', 'modifications']
+        },
+        handler: async (args) => {
+            const scenario = service.generateCounterfactual(args.traceId, args.original, args.modifications);
+            return {
+                success: true,
+                scenario: {
+                    changedKeys: scenario.changedKeys,
+                    originalOutcome: scenario.originalOutcome,
+                    counterfactualOutcome: scenario.counterfactualOutcome,
+                    outcomeChanged: scenario.outcomeChanged,
+                    explanation: scenario.explanation
+                }
+            };
+        }
+    },
+    // 7. Analyze Feature Importance
+    {
+        name: 'explainability_analyze_feature_importance',
+        description: 'Analyze feature importance to understand which inputs matter most',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                traceId: {
+                    type: 'string',
+                    description: 'Trace identifier'
+                },
+                inputs: {
+                    type: 'object',
+                    description: 'Input parameters to analyze'
+                },
+                output: {
+                    type: 'string',
+                    description: 'Output from the model'
+                }
+            },
+            required: ['traceId', 'inputs', 'output']
+        },
+        handler: async (args) => {
+            const features = service.analyzeFeatureImportance(args.traceId, args.inputs, args.output);
+            return {
+                success: true,
+                features: features.map(f => ({
+                    feature: f.feature,
+                    importance: f.importance,
+                    impact: f.impact,
+                    examples: f.examples
+                }))
+            };
+        }
+    },
+    // 8. Generate Performance Profile
+    {
+        name: 'explainability_generate_performance_profile',
+        description: 'Generate performance profile to identify hot paths and bottlenecks',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                traceId: {
+                    type: 'string',
+                    description: 'Trace identifier'
+                }
+            },
+            required: ['traceId']
+        },
+        handler: async (args) => {
+            const profile = service.generatePerformanceProfile(args.traceId);
+            if (!profile) {
+                return {
+                    success: false,
+                    error: `Trace ${args.traceId} not found`
+                };
+            }
+            return {
+                success: true,
+                profile: {
+                    traceId: profile.traceId,
+                    hotPaths: profile.hotPaths,
+                    bottlenecks: profile.bottlenecks,
+                    memoryUsage: profile.memoryUsage.length,
+                    cpuUsage: profile.cpuUsage.length
+                }
+            };
+        }
+    },
+    // 9. Generate Compliance Report
+    {
+        name: 'explainability_generate_compliance_report',
+        description: 'Generate compliance report for audit logs and regulatory requirements',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                traceIds: {
+                    type: 'array',
+                    description: 'Optional array of trace IDs to include (all traces if not provided)',
+                    items: { type: 'string' }
+                }
+            }
+        },
+        handler: async (args) => {
+            const report = service.generateComplianceReport(args.traceIds);
+            return {
+                success: true,
+                report: {
+                    reportId: report.reportId,
+                    generatedAt: report.generatedAt,
+                    summary: report.summary,
+                    auditLogEntries: report.auditLog.length,
+                    dataHandling: report.dataHandling,
+                    traceCount: report.traceIds.length
+                }
+            };
+        }
+    },
+    // 10. Get Explainability Metrics
+    {
+        name: 'explainability_get_metrics',
+        description: 'Get explainability metrics including overhead and storage',
+        inputSchema: {
+            type: 'object',
+            properties: {}
+        },
+        handler: async () => {
+            const metrics = service.getMetrics();
+            return {
+                success: true,
+                metrics: {
+                    tracesCollected: metrics.tracesCollected,
+                    averageOverheadMs: metrics.averageOverheadMs,
+                    overheadPercentage: metrics.overheadPercentage,
+                    storageUsedMB: metrics.storageUsedMB,
+                    complianceReportsGenerated: metrics.complianceReportsGenerated
+                }
+            };
+        }
+    }
+];
+//# sourceMappingURL=explainability-tools.js.map

package/dist/mcp/fastmcp/tools/explainability-tools.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"explainability-tools.js","sourceRoot":"","sources":["../../../../src/mcp/fastmcp/tools/explainability-tools.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * Explainability MCP Tools - Full Transparency for Trust, Debugging, and Compliance\n *\n * 10 MCP tools for explainability features:\n * 1. start_trace - Begin execution trace\n * 2. end_trace - Complete execution trace\n * 3. get_trace - Retrieve execution trace\n * 4. capture_attention - Capture attention visualization\n * 5. build_decision_tree - Build decision tree\n * 6. generate_counterfactual - Generate counterfactual explanation\n * 7. analyze_feature_importance - Analyze feature importance\n * 8. generate_performance_profile - Generate performance profile\n * 9. generate_compliance_report - Generate compliance report\n * 10. get_explainability_metrics - Get explainability metrics\n */\n\nimport { ExplainabilityService } from '../../../services/explainability-service.js';\n\nconst service = ExplainabilityService.getInstance();\n\n/**\n * Register explainability tools with FastMCP server\n */\nexport function registerExplainabilityTools(server: any): void {\n  for (const tool of explainabilityTools) {\n    server.addTool({\n      name: tool.name,\n      description: tool.description,\n      parameters: tool.inputSchema,\n      execute: tool.handler,\n    });\n  }\n}\n\nexport const explainabilityTools = [\n  // 1. Start Trace\n  {\n    name: 'explainability_start_trace',\n    description: 'Begin execution trace for debugging and compliance',\n    inputSchema: {\n      type: 'object',\n      properties: {\n        traceId: {\n          type: 'string',\n          description: 'Unique trace identifier'\n        }\n      },\n      required: ['traceId']\n    },\n    handler: async (args: { traceId: string }) => {\n      const trace = service.startTrace(args.traceId);\n      return {\n        success: true,\n        trace: {\n          traceId: trace.traceId,\n          startTime: trace.startTime,\n          steps: trace.steps.length\n        }\n      };\n    }\n  },\n\n  // 2. End Trace\n  {\n    name: 'explainability_end_trace',\n    description: 'Complete execution trace',\n    inputSchema: {\n      type: 'object',\n      properties: {\n        traceId: {\n          type: 'string',\n          description: 'Trace identifier'\n        },\n        modelUsed: {\n          type: 'string',\n          description: 'Model used for execution'\n        },\n        totalCost: {\n          type: 'number',\n          description: 'Total cost in USD'\n        },\n        success: {\n          type: 'boolean',\n          description: 'Execution success status'\n        },\n        error: {\n          type: 'string',\n          description: 'Error message if failed'\n        }\n      },\n      required: ['traceId', 'modelUsed', 'totalCost', 'success']\n    },\n    handler: async (args: {\n      traceId: string;\n      modelUsed: string;\n      totalCost: number;\n      success: boolean;\n      error?: string;\n    }) => {\n      service.endTrace(args.traceId, args.modelUsed, args.totalCost, args.success, args.error);\n      const trace = service.getTrace(args.traceId);\n\n      return {\n        success: true,\n        trace: trace ? {\n          traceId: trace.traceId,\n          durationMs: trace.durationMs,\n          modelUsed: trace.modelUsed,\n          totalCost: trace.totalCost,\n          success: trace.success,\n          steps: trace.steps.length\n        } : null\n      };\n    }\n  },\n\n  // 3. Get Trace\n  {\n    name: 'explainability_get_trace',\n    description: 'Retrieve execution trace for debugging',\n    inputSchema: {\n      type: 'object',\n      properties: {\n        traceId: {\n          type: 'string',\n          description: 'Trace identifier'\n        }\n      },\n      required: ['traceId']\n    },\n    handler: async (args: { traceId: string }) => {\n      const trace = service.getTrace(args.traceId);\n\n      if (!trace) {\n        return {\n          success: false,\n          error: `Trace ${args.traceId} not found`\n        };\n      }\n\n      return {\n        success: true,\n        trace: {\n          traceId: trace.traceId,\n          startTime: trace.startTime,\n          endTime: trace.endTime,\n          durationMs: trace.durationMs,\n          modelUsed: trace.modelUsed,\n          totalCost: trace.totalCost,\n          success: trace.success,\n          error: trace.error,\n          steps: trace.steps.map(step => ({\n            stepId: step.stepId,\n            type: step.type,\n            timestamp: step.timestamp,\n            durationMs: step.durationMs,\n            description: step.description,\n            metadata: step.metadata\n          }))\n        }\n      };\n    }\n  },\n\n  // 4. Capture Attention\n  {\n    name: 'explainability_capture_attention',\n    description: 'Capture attention visualization to see what model focuses on',\n    inputSchema: {\n      type: 'object',\n      properties: {\n        traceId: {\n          type: 'string',\n          description: 'Trace identifier'\n        },\n        inputText: {\n          type: 'string',\n          description: 'Input text to the model'\n        },\n        outputText: {\n          type: 'string',\n          description: 'Output text from the model'\n        },\n        heads: {\n          type: 'array',\n          description: 'Attention heads with weights',\n          items: {\n            type: 'object',\n            properties: {\n              headId: { type: 'number' },\n              layer: { type: 'number' },\n              weights: {\n                type: 'array',\n                items: {\n                  type: 'object',\n                  properties: {\n                    token: { type: 'string' },\n                    weight: { type: 'number' },\n                    position: { type: 'number' }\n                  }\n                }\n              },\n              topK: {\n                type: 'array',\n                items: { type: 'string' }\n              }\n            }\n          }\n        }\n      },\n      required: ['traceId', 'inputText', 'outputText', 'heads']\n    },\n    handler: async (args: {\n      traceId: string;\n      inputText: string;\n      outputText: string;\n      heads: Array<{\n        headId: number;\n        layer: number;\n        weights: Array<{ token: string; weight: number; position: number }>;\n        topK: string[];\n      }>;\n    }) => {\n      const viz = service.captureAttention(args.traceId, args.inputText, args.outputText, args.heads);\n\n      return {\n        success: true,\n        visualization: {\n          traceId: viz.traceId,\n          focusTokens: viz.focusTokens,\n          totalHeads: viz.heads.length,\n          aggregatedWeights: Array.from(viz.aggregatedWeights.entries()).map(([token, weight]) => ({\n            token,\n            weight\n          }))\n        }\n      };\n    }\n  },\n\n  // 5. Build Decision Tree\n  {\n    name: 'explainability_build_decision_tree',\n    description: 'Build decision tree to explain routing and model selection',\n    inputSchema: {\n      type: 'object',\n      properties: {\n        traceId: {\n          type: 'string',\n          description: 'Trace identifier'\n        },\n        rootNode: {\n          type: 'object',\n          description: 'Root decision node',\n          properties: {\n            nodeId: { type: 'string' },\n            decision: { type: 'string' },\n            reasoning: { type: 'string' },\n            confidence: { type: 'number' },\n            alternatives: {\n              type: 'array',\n              items: {\n                type: 'object',\n                properties: {\n                  decision: { type: 'string' },\n                  confidence: { type: 'number' },\n                  reasoning: { type: 'string' }\n                }\n              }\n            },\n            children: {\n              type: 'array',\n              items: { type: 'object' }\n            }\n          },\n          required: ['nodeId', 'decision', 'reasoning', 'confidence']\n        }\n      },\n      required: ['traceId', 'rootNode']\n    },\n    handler: async (args: {\n      traceId: string;\n      rootNode: {\n        nodeId: string;\n        decision: string;\n        reasoning: string;\n        confidence: number;\n        alternatives?: Array<{ decision: string; confidence: number; reasoning: string }>;\n        children?: any[];\n        metadata?: Record<string, unknown>;\n      };\n    }) => {\n      const rootNode = {\n        ...args.rootNode,\n        alternatives: args.rootNode.alternatives || [],\n        children: args.rootNode.children || []\n      };\n\n      const tree = service.buildDecisionTree(args.traceId, rootNode);\n\n      return {\n        success: true,\n        tree: {\n          traceId: tree.traceId,\n          depth: tree.depth,\n          totalNodes: tree.totalNodes,\n          criticalPath: tree.criticalPath,\n          rootDecision: tree.rootNode.decision\n        }\n      };\n    }\n  },\n\n  // 6. Generate Counterfactual\n  {\n    name: 'explainability_generate_counterfactual',\n    description: 'Generate counterfactual explanation (\"What if we changed X?\")',\n    inputSchema: {\n      type: 'object',\n      properties: {\n        traceId: {\n          type: 'string',\n          description: 'Trace identifier'\n        },\n        original: {\n          type: 'object',\n          description: 'Original input parameters'\n        },\n        modifications: {\n          type: 'object',\n          description: 'Parameters to modify'\n        }\n      },\n      required: ['traceId', 'original', 'modifications']\n    },\n    handler: async (args: {\n      traceId: string;\n      original: Record<string, unknown>;\n      modifications: Record<string, unknown>;\n    }) => {\n      const scenario = service.generateCounterfactual(args.traceId, args.original, args.modifications);\n\n      return {\n        success: true,\n        scenario: {\n          changedKeys: scenario.changedKeys,\n          originalOutcome: scenario.originalOutcome,\n          counterfactualOutcome: scenario.counterfactualOutcome,\n          outcomeChanged: scenario.outcomeChanged,\n          explanation: scenario.explanation\n        }\n      };\n    }\n  },\n\n  // 7. Analyze Feature Importance\n  {\n    name: 'explainability_analyze_feature_importance',\n    description: 'Analyze feature importance to understand which inputs matter most',\n    inputSchema: {\n      type: 'object',\n      properties: {\n        traceId: {\n          type: 'string',\n          description: 'Trace identifier'\n        },\n        inputs: {\n          type: 'object',\n          description: 'Input parameters to analyze'\n        },\n        output: {\n          type: 'string',\n          description: 'Output from the model'\n        }\n      },\n      required: ['traceId', 'inputs', 'output']\n    },\n    handler: async (args: {\n      traceId: string;\n      inputs: Record<string, unknown>;\n      output: string;\n    }) => {\n      const features = service.analyzeFeatureImportance(args.traceId, args.inputs, args.output);\n\n      return {\n        success: true,\n        features: features.map(f => ({\n          feature: f.feature,\n          importance: f.importance,\n          impact: f.impact,\n          examples: f.examples\n        }))\n      };\n    }\n  },\n\n  // 8. Generate Performance Profile\n  {\n    name: 'explainability_generate_performance_profile',\n    description: 'Generate performance profile to identify hot paths and bottlenecks',\n    inputSchema: {\n      type: 'object',\n      properties: {\n        traceId: {\n          type: 'string',\n          description: 'Trace identifier'\n        }\n      },\n      required: ['traceId']\n    },\n    handler: async (args: { traceId: string }) => {\n      const profile = service.generatePerformanceProfile(args.traceId);\n\n      if (!profile) {\n        return {\n          success: false,\n          error: `Trace ${args.traceId} not found`\n        };\n      }\n\n      return {\n        success: true,\n        profile: {\n          traceId: profile.traceId,\n          hotPaths: profile.hotPaths,\n          bottlenecks: profile.bottlenecks,\n          memoryUsage: profile.memoryUsage.length,\n          cpuUsage: profile.cpuUsage.length\n        }\n      };\n    }\n  },\n\n  // 9. Generate Compliance Report\n  {\n    name: 'explainability_generate_compliance_report',\n    description: 'Generate compliance report for audit logs and regulatory requirements',\n    inputSchema: {\n      type: 'object',\n      properties: {\n        traceIds: {\n          type: 'array',\n          description: 'Optional array of trace IDs to include (all traces if not provided)',\n          items: { type: 'string' }\n        }\n      }\n    },\n    handler: async (args: { traceIds?: string[] }) => {\n      const report = service.generateComplianceReport(args.traceIds);\n\n      return {\n        success: true,\n        report: {\n          reportId: report.reportId,\n          generatedAt: report.generatedAt,\n          summary: report.summary,\n          auditLogEntries: report.auditLog.length,\n          dataHandling: report.dataHandling,\n          traceCount: report.traceIds.length\n        }\n      };\n    }\n  },\n\n  // 10. Get Explainability Metrics\n  {\n    name: 'explainability_get_metrics',\n    description: 'Get explainability metrics including overhead and storage',\n    inputSchema: {\n      type: 'object',\n      properties: {}\n    },\n    handler: async () => {\n      const metrics = service.getMetrics();\n\n      return {\n        success: true,\n        metrics: {\n          tracesCollected: metrics.tracesCollected,\n          averageOverheadMs: metrics.averageOverheadMs,\n          overheadPercentage: metrics.overheadPercentage,\n          storageUsedMB: metrics.storageUsedMB,\n          complianceReportsGenerated: metrics.complianceReportsGenerated\n        }\n      };\n    }\n  }\n];\n"]}

package/dist/mcp/fastmcp/tools/github-tools.d.ts

@@ -0,0 +1,2 @@
+export declare function registerGitHubTools(server: any): void;
+//# sourceMappingURL=github-tools.d.ts.map

package/dist/mcp/fastmcp/tools/github-tools.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"github-tools.d.ts","sourceRoot":"","sources":["../../../../src/mcp/fastmcp/tools/github-tools.ts"],"names":[],"mappings":"AAGA,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,GAAG,GAAG,IAAI,CAqJrD"}

package/dist/mcp/fastmcp/tools/github-tools.js

@@ -0,0 +1,153 @@
+import { z } from 'zod';
+import { GitHubService } from '../../../services/github-service.js';
+export function registerGitHubTools(server) {
+    const githubService = GitHubService.getInstance();
+    // Tool: github_pr_create
+    server.addTool({
+        name: 'github_pr_create',
+        description: 'Create a new pull request on the current repository',
+        parameters: z.object({
+            title: z.string().min(1).describe('PR title'),
+            body: z.string().describe('PR description/body'),
+            head: z.string().describe('Head branch (source branch with changes)'),
+            base: z.string().describe('Base branch (target branch to merge into)'),
+            draft: z.boolean().optional().default(false).describe('Create as draft PR'),
+        }),
+        execute: async ({ title, body, head, base, draft }) => {
+            try {
+                const pr = await githubService.createPullRequest({ title, body, head, base, draft });
+                return JSON.stringify({ success: true, data: pr, timestamp: new Date().toISOString() }, null, 2);
+            }
+            catch (error) {
+                return JSON.stringify({ success: false, error: error.message, timestamp: new Date().toISOString() }, null, 2);
+            }
+        }
+    });
+    // Tool: github_pr_list
+    server.addTool({
+        name: 'github_pr_list',
+        description: 'List pull requests on the current repository',
+        parameters: z.object({
+            state: z.enum(['open', 'closed', 'all']).optional().default('open').describe('PR state filter'),
+            limit: z.number().positive().optional().default(10).describe('Maximum PRs to return'),
+        }),
+        execute: async ({ state, limit }) => {
+            try {
+                const prs = await githubService.listPullRequests(state, undefined, undefined, limit);
+                return JSON.stringify({ success: true, data: { prs, count: prs.length }, timestamp: new Date().toISOString() }, null, 2);
+            }
+            catch (error) {
+                return JSON.stringify({ success: false, error: error.message, timestamp: new Date().toISOString() }, null, 2);
+            }
+        }
+    });
+    // Tool: github_pr_review
+    server.addTool({
+        name: 'github_pr_review',
+        description: 'Add a review to a pull request',
+        parameters: z.object({
+            number: z.number().positive().describe('PR number'),
+            body: z.string().min(1).describe('Review comment body'),
+            event: z.enum(['APPROVE', 'REQUEST_CHANGES', 'COMMENT']).optional().default('COMMENT').describe('Review event type'),
+        }),
+        execute: async ({ number, body, event }) => {
+            try {
+                const result = await githubService.createReview(number, event, body);
+                return JSON.stringify({ success: true, data: result, timestamp: new Date().toISOString() }, null, 2);
+            }
+            catch (error) {
+                return JSON.stringify({ success: false, error: error.message, timestamp: new Date().toISOString() }, null, 2);
+            }
+        }
+    });
+    // Tool: github_pr_merge
+    server.addTool({
+        name: 'github_pr_merge',
+        description: 'Merge a pull request by number',
+        parameters: z.object({
+            number: z.number().positive().describe('PR number to merge'),
+            method: z.enum(['merge', 'squash', 'rebase']).optional().default('merge').describe('Merge method'),
+        }),
+        execute: async ({ number, method }) => {
+            try {
+                const result = await githubService.mergePullRequest(number, method);
+                return JSON.stringify({ success: true, data: result, timestamp: new Date().toISOString() }, null, 2);
+            }
+            catch (error) {
+                return JSON.stringify({ success: false, error: error.message, timestamp: new Date().toISOString() }, null, 2);
+            }
+        }
+    });
+    // Tool: github_issue_create
+    server.addTool({
+        name: 'github_issue_create',
+        description: 'Create a new GitHub issue',
+        parameters: z.object({
+            title: z.string().min(1).describe('Issue title'),
+            body: z.string().describe('Issue body/description'),
+            labels: z.array(z.string()).optional().describe('Labels to add'),
+            assignees: z.array(z.string()).optional().describe('GitHub usernames to assign'),
+        }),
+        execute: async ({ title, body, labels, assignees }) => {
+            try {
+                const issue = await githubService.createIssue({ title, body, labels, assignees });
+                return JSON.stringify({ success: true, data: issue, timestamp: new Date().toISOString() }, null, 2);
+            }
+            catch (error) {
+                return JSON.stringify({ success: false, error: error.message, timestamp: new Date().toISOString() }, null, 2);
+            }
+        }
+    });
+    // Tool: github_issue_list
+    server.addTool({
+        name: 'github_issue_list',
+        description: 'List GitHub issues with optional filters',
+        parameters: z.object({
+            state: z.enum(['open', 'closed', 'all']).optional().default('open').describe('Issue state filter'),
+            labels: z.array(z.string()).optional().describe('Filter by labels'),
+            limit: z.number().positive().optional().default(10).describe('Maximum issues to return'),
+        }),
+        execute: async ({ state, labels, limit }) => {
+            try {
+                const issues = await githubService.listIssues(state, labels, undefined, undefined, limit);
+                return JSON.stringify({ success: true, data: { issues, count: issues.length }, timestamp: new Date().toISOString() }, null, 2);
+            }
+            catch (error) {
+                return JSON.stringify({ success: false, error: error.message, timestamp: new Date().toISOString() }, null, 2);
+            }
+        }
+    });
+    // Tool: github_repo_info
+    server.addTool({
+        name: 'github_repo_info',
+        description: 'Get repository metrics and information',
+        parameters: z.object({}),
+        execute: async () => {
+            try {
+                const metrics = await githubService.getMetrics();
+                return JSON.stringify({ success: true, data: metrics, timestamp: new Date().toISOString() }, null, 2);
+            }
+            catch (error) {
+                return JSON.stringify({ success: false, error: error.message, timestamp: new Date().toISOString() }, null, 2);
+            }
+        }
+    });
+    // Tool: github_workflow_status
+    server.addTool({
+        name: 'github_workflow_status',
+        description: 'Check GitHub Actions workflow run status',
+        parameters: z.object({
+            limit: z.number().positive().optional().default(5).describe('Maximum workflow runs to return'),
+        }),
+        execute: async ({ limit }) => {
+            try {
+                const runs = await githubService.getWorkflowRuns(limit);
+                return JSON.stringify({ success: true, data: { runs, count: runs.length }, timestamp: new Date().toISOString() }, null, 2);
+            }
+            catch (error) {
+                return JSON.stringify({ success: false, error: error.message, timestamp: new Date().toISOString() }, null, 2);
+            }
+        }
+    });
+}
+//# sourceMappingURL=github-tools.js.map