agentic-flow 3.0.0-alpha.2 → 3.0.0

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

@@ -1,429 +0,0 @@
-/**
- * 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

@@ -1 +0,0 @@
-{"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

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

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

@@ -1 +0,0 @@
-{"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

@@ -1,153 +0,0 @@
-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