agentic-flow 2.0.7 → 3.0.0-alpha.2

package/dist/agentic-flow/src/mcp/fastmcp/tools/explainability-tools.js

@@ -0,0 +1,404 @@
+/**
+ * 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: {
+            traceId: {
+                type: 'string',
+                description: 'Unique trace identifier',
+                required: true,
+            }
+        },
+        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: {
+            traceId: {
+                type: 'string',
+                description: 'Trace identifier',
+                required: true,
+            },
+            modelUsed: {
+                type: 'string',
+                description: 'Model used for execution',
+                required: true,
+            },
+            totalCost: {
+                type: 'number',
+                description: 'Total cost in USD',
+                required: true,
+            },
+            success: {
+                type: 'boolean',
+                description: 'Execution success status',
+                required: true,
+            },
+            error: {
+                type: 'string',
+                description: 'Error message if failed',
+                required: false,
+            }
+        },
+        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: {
+            traceId: {
+                type: 'string',
+                description: 'Trace identifier',
+                required: true,
+            }
+        },
+        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: {
+            traceId: {
+                type: 'string',
+                description: 'Trace identifier',
+                required: true,
+            },
+            inputText: {
+                type: 'string',
+                description: 'Input text to the model',
+                required: true,
+            },
+            outputText: {
+                type: 'string',
+                description: 'Output text from the model',
+                required: true,
+            },
+            heads: {
+                type: 'array',
+                description: 'Attention heads with weights',
+                required: true,
+                items: {
+                    properties: {
+                        headId: { type: 'number' },
+                        layer: { type: 'number' },
+                        weights: {
+                            type: 'array',
+                            items: {
+                                properties: {
+                                    token: { type: 'string' },
+                                    weight: { type: 'number' },
+                                    position: { type: 'number' }
+                                }
+                            }
+                        },
+                        topK: {
+                            type: 'array',
+                            items: { type: 'string' }
+                        }
+                    }
+                }
+            }
+        },
+        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: {
+            traceId: {
+                type: 'string',
+                description: 'Trace identifier',
+                required: true,
+            },
+            rootNode: {
+                description: 'Root decision node',
+                required: true,
+                properties: {
+                    nodeId: { type: 'string' },
+                    decision: { type: 'string' },
+                    reasoning: { type: 'string' },
+                    confidence: { type: 'number' },
+                    alternatives: {
+                        type: 'array',
+                        items: {
+                            properties: {
+                                decision: { type: 'string' },
+                                confidence: { type: 'number' },
+                                reasoning: { type: 'string' }
+                            }
+                        }
+                    },
+                    children: {
+                        type: 'array',
+                        items: { type: 'object' }
+                    }
+                }
+            }
+        },
+        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: {
+            traceId: {
+                type: 'string',
+                description: 'Trace identifier',
+                required: true,
+            },
+            original: {
+                description: 'Original input parameters',
+                required: true,
+            },
+            modifications: {
+                description: 'Parameters to modify',
+                required: true,
+            }
+        },
+        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: {
+            traceId: {
+                type: 'string',
+                description: 'Trace identifier',
+                required: true,
+            },
+            inputs: {
+                description: 'Input parameters to analyze',
+                required: true,
+            },
+            output: {
+                type: 'string',
+                description: 'Output from the model',
+                required: true,
+            }
+        },
+        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: {
+            traceId: {
+                type: 'string',
+                description: 'Trace identifier',
+                required: true,
+            }
+        },
+        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: {
+            traceIds: {
+                type: 'array',
+                description: 'Optional array of trace IDs to include (all traces if not provided)',
+                required: false,
+                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: {},
+        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/agentic-flow/src/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      traceId: {\n        type: 'string',\n        description: 'Unique trace identifier',\n        required: true,\n      }\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      traceId: {\n        type: 'string',\n        description: 'Trace identifier',\n        required: true,\n      },\n      modelUsed: {\n        type: 'string',\n        description: 'Model used for execution',\n        required: true,\n      },\n      totalCost: {\n        type: 'number',\n        description: 'Total cost in USD',\n        required: true,\n      },\n      success: {\n        type: 'boolean',\n        description: 'Execution success status',\n        required: true,\n      },\n      error: {\n        type: 'string',\n        description: 'Error message if failed',\n        required: false,\n      }\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      traceId: {\n        type: 'string',\n        description: 'Trace identifier',\n        required: true,\n      }\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      traceId: {\n        type: 'string',\n        description: 'Trace identifier',\n        required: true,\n      },\n      inputText: {\n        type: 'string',\n        description: 'Input text to the model',\n        required: true,\n      },\n      outputText: {\n        type: 'string',\n        description: 'Output text from the model',\n        required: true,\n      },\n      heads: {\n        type: 'array',\n        description: 'Attention heads with weights',\n        required: true,\n        items: {\n          properties: {\n            headId: { type: 'number' },\n            layer: { type: 'number' },\n            weights: {\n              type: 'array',\n              items: {\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    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      traceId: {\n        type: 'string',\n        description: 'Trace identifier',\n        required: true,\n      },\n      rootNode: {\n        description: 'Root decision node',\n        required: true,\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              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      }\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      traceId: {\n        type: 'string',\n        description: 'Trace identifier',\n        required: true,\n      },\n      original: {\n        description: 'Original input parameters',\n        required: true,\n      },\n      modifications: {\n        description: 'Parameters to modify',\n        required: true,\n      }\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      traceId: {\n        type: 'string',\n        description: 'Trace identifier',\n        required: true,\n      },\n      inputs: {\n        description: 'Input parameters to analyze',\n        required: true,\n      },\n      output: {\n        type: 'string',\n        description: 'Output from the model',\n        required: true,\n      }\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      traceId: {\n        type: 'string',\n        description: 'Trace identifier',\n        required: true,\n      }\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      traceIds: {\n        type: 'array',\n        description: 'Optional array of trace IDs to include (all traces if not provided)',\n        required: false,\n        items: { type: 'string' }\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    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/agentic-flow/src/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/agentic-flow/src/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/agentic-flow/src/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

package/dist/agentic-flow/src/mcp/fastmcp/tools/github-tools.js.map

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