agentic-flow 3.0.0-alpha.2 → 3.1.0

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

@@ -1,582 +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
- */
-/**
- * Register explainability tools with FastMCP server
- */
-export declare function registerExplainabilityTools(server: any): void;
-export declare const explainabilityTools: ({
-    name: string;
-    description: string;
-    inputSchema: {
-        type: string;
-        properties: {
-            traceId: {
-                type: string;
-                description: string;
-            };
-            modelUsed?: undefined;
-            totalCost?: undefined;
-            success?: undefined;
-            error?: undefined;
-            inputText?: undefined;
-            outputText?: undefined;
-            heads?: undefined;
-            rootNode?: undefined;
-            original?: undefined;
-            modifications?: undefined;
-            inputs?: undefined;
-            output?: undefined;
-            traceIds?: undefined;
-        };
-        required: string[];
-    };
-    handler: (args: {
-        traceId: string;
-    }) => Promise<{
-        success: boolean;
-        trace: {
-            traceId: string;
-            startTime: number;
-            steps: number;
-        };
-    }>;
-} | {
-    name: string;
-    description: string;
-    inputSchema: {
-        type: string;
-        properties: {
-            traceId: {
-                type: string;
-                description: string;
-            };
-            modelUsed: {
-                type: string;
-                description: string;
-            };
-            totalCost: {
-                type: string;
-                description: string;
-            };
-            success: {
-                type: string;
-                description: string;
-            };
-            error: {
-                type: string;
-                description: string;
-            };
-            inputText?: undefined;
-            outputText?: undefined;
-            heads?: undefined;
-            rootNode?: undefined;
-            original?: undefined;
-            modifications?: undefined;
-            inputs?: undefined;
-            output?: undefined;
-            traceIds?: undefined;
-        };
-        required: string[];
-    };
-    handler: (args: {
-        traceId: string;
-        modelUsed: string;
-        totalCost: number;
-        success: boolean;
-        error?: string;
-    }) => Promise<{
-        success: boolean;
-        trace: {
-            traceId: string;
-            durationMs: number;
-            modelUsed: string;
-            totalCost: number;
-            success: boolean;
-            steps: number;
-        };
-    }>;
-} | {
-    name: string;
-    description: string;
-    inputSchema: {
-        type: string;
-        properties: {
-            traceId: {
-                type: string;
-                description: string;
-            };
-            modelUsed?: undefined;
-            totalCost?: undefined;
-            success?: undefined;
-            error?: undefined;
-            inputText?: undefined;
-            outputText?: undefined;
-            heads?: undefined;
-            rootNode?: undefined;
-            original?: undefined;
-            modifications?: undefined;
-            inputs?: undefined;
-            output?: undefined;
-            traceIds?: undefined;
-        };
-        required: string[];
-    };
-    handler: (args: {
-        traceId: string;
-    }) => Promise<{
-        success: boolean;
-        error: string;
-        trace?: undefined;
-    } | {
-        success: boolean;
-        trace: {
-            traceId: string;
-            startTime: number;
-            endTime: number;
-            durationMs: number;
-            modelUsed: string;
-            totalCost: number;
-            success: boolean;
-            error: string;
-            steps: {
-                stepId: string;
-                type: "output" | "input" | "error" | "decision" | "processing";
-                timestamp: number;
-                durationMs: number;
-                description: string;
-                metadata: Record<string, unknown>;
-            }[];
-        };
-        error?: undefined;
-    }>;
-} | {
-    name: string;
-    description: string;
-    inputSchema: {
-        type: string;
-        properties: {
-            traceId: {
-                type: string;
-                description: string;
-            };
-            inputText: {
-                type: string;
-                description: string;
-            };
-            outputText: {
-                type: string;
-                description: string;
-            };
-            heads: {
-                type: string;
-                description: string;
-                items: {
-                    type: string;
-                    properties: {
-                        headId: {
-                            type: string;
-                        };
-                        layer: {
-                            type: string;
-                        };
-                        weights: {
-                            type: string;
-                            items: {
-                                type: string;
-                                properties: {
-                                    token: {
-                                        type: string;
-                                    };
-                                    weight: {
-                                        type: string;
-                                    };
-                                    position: {
-                                        type: string;
-                                    };
-                                };
-                            };
-                        };
-                        topK: {
-                            type: string;
-                            items: {
-                                type: string;
-                            };
-                        };
-                    };
-                };
-            };
-            modelUsed?: undefined;
-            totalCost?: undefined;
-            success?: undefined;
-            error?: undefined;
-            rootNode?: undefined;
-            original?: undefined;
-            modifications?: undefined;
-            inputs?: undefined;
-            output?: undefined;
-            traceIds?: undefined;
-        };
-        required: string[];
-    };
-    handler: (args: {
-        traceId: string;
-        inputText: string;
-        outputText: string;
-        heads: Array<{
-            headId: number;
-            layer: number;
-            weights: Array<{
-                token: string;
-                weight: number;
-                position: number;
-            }>;
-            topK: string[];
-        }>;
-    }) => Promise<{
-        success: boolean;
-        visualization: {
-            traceId: string;
-            focusTokens: string[];
-            totalHeads: number;
-            aggregatedWeights: {
-                token: string;
-                weight: number;
-            }[];
-        };
-    }>;
-} | {
-    name: string;
-    description: string;
-    inputSchema: {
-        type: string;
-        properties: {
-            traceId: {
-                type: string;
-                description: string;
-            };
-            rootNode: {
-                type: string;
-                description: string;
-                properties: {
-                    nodeId: {
-                        type: string;
-                    };
-                    decision: {
-                        type: string;
-                    };
-                    reasoning: {
-                        type: string;
-                    };
-                    confidence: {
-                        type: string;
-                    };
-                    alternatives: {
-                        type: string;
-                        items: {
-                            type: string;
-                            properties: {
-                                decision: {
-                                    type: string;
-                                };
-                                confidence: {
-                                    type: string;
-                                };
-                                reasoning: {
-                                    type: string;
-                                };
-                            };
-                        };
-                    };
-                    children: {
-                        type: string;
-                        items: {
-                            type: string;
-                        };
-                    };
-                };
-                required: string[];
-            };
-            modelUsed?: undefined;
-            totalCost?: undefined;
-            success?: undefined;
-            error?: undefined;
-            inputText?: undefined;
-            outputText?: undefined;
-            heads?: undefined;
-            original?: undefined;
-            modifications?: undefined;
-            inputs?: undefined;
-            output?: undefined;
-            traceIds?: undefined;
-        };
-        required: string[];
-    };
-    handler: (args: {
-        traceId: string;
-        rootNode: {
-            nodeId: string;
-            decision: string;
-            reasoning: string;
-            confidence: number;
-            alternatives?: Array<{
-                decision: string;
-                confidence: number;
-                reasoning: string;
-            }>;
-            children?: any[];
-            metadata?: Record<string, unknown>;
-        };
-    }) => Promise<{
-        success: boolean;
-        tree: {
-            traceId: string;
-            depth: number;
-            totalNodes: number;
-            criticalPath: string[];
-            rootDecision: string;
-        };
-    }>;
-} | {
-    name: string;
-    description: string;
-    inputSchema: {
-        type: string;
-        properties: {
-            traceId: {
-                type: string;
-                description: string;
-            };
-            original: {
-                type: string;
-                description: string;
-            };
-            modifications: {
-                type: string;
-                description: string;
-            };
-            modelUsed?: undefined;
-            totalCost?: undefined;
-            success?: undefined;
-            error?: undefined;
-            inputText?: undefined;
-            outputText?: undefined;
-            heads?: undefined;
-            rootNode?: undefined;
-            inputs?: undefined;
-            output?: undefined;
-            traceIds?: undefined;
-        };
-        required: string[];
-    };
-    handler: (args: {
-        traceId: string;
-        original: Record<string, unknown>;
-        modifications: Record<string, unknown>;
-    }) => Promise<{
-        success: boolean;
-        scenario: {
-            changedKeys: string[];
-            originalOutcome: string;
-            counterfactualOutcome: string;
-            outcomeChanged: boolean;
-            explanation: string;
-        };
-    }>;
-} | {
-    name: string;
-    description: string;
-    inputSchema: {
-        type: string;
-        properties: {
-            traceId: {
-                type: string;
-                description: string;
-            };
-            inputs: {
-                type: string;
-                description: string;
-            };
-            output: {
-                type: string;
-                description: string;
-            };
-            modelUsed?: undefined;
-            totalCost?: undefined;
-            success?: undefined;
-            error?: undefined;
-            inputText?: undefined;
-            outputText?: undefined;
-            heads?: undefined;
-            rootNode?: undefined;
-            original?: undefined;
-            modifications?: undefined;
-            traceIds?: undefined;
-        };
-        required: string[];
-    };
-    handler: (args: {
-        traceId: string;
-        inputs: Record<string, unknown>;
-        output: string;
-    }) => Promise<{
-        success: boolean;
-        features: {
-            feature: string;
-            importance: number;
-            impact: "positive" | "negative" | "neutral";
-            examples: string[];
-        }[];
-    }>;
-} | {
-    name: string;
-    description: string;
-    inputSchema: {
-        type: string;
-        properties: {
-            traceId: {
-                type: string;
-                description: string;
-            };
-            modelUsed?: undefined;
-            totalCost?: undefined;
-            success?: undefined;
-            error?: undefined;
-            inputText?: undefined;
-            outputText?: undefined;
-            heads?: undefined;
-            rootNode?: undefined;
-            original?: undefined;
-            modifications?: undefined;
-            inputs?: undefined;
-            output?: undefined;
-            traceIds?: undefined;
-        };
-        required: string[];
-    };
-    handler: (args: {
-        traceId: string;
-    }) => Promise<{
-        success: boolean;
-        error: string;
-        profile?: undefined;
-    } | {
-        success: boolean;
-        profile: {
-            traceId: string;
-            hotPaths: {
-                path: string;
-                count: number;
-                totalMs: number;
-                avgMs: number;
-            }[];
-            bottlenecks: {
-                stepId: string;
-                durationMs: number;
-                percentage: number;
-            }[];
-            memoryUsage: number;
-            cpuUsage: number;
-        };
-        error?: undefined;
-    }>;
-} | {
-    name: string;
-    description: string;
-    inputSchema: {
-        type: string;
-        properties: {
-            traceIds: {
-                type: string;
-                description: string;
-                items: {
-                    type: string;
-                };
-            };
-            traceId?: undefined;
-            modelUsed?: undefined;
-            totalCost?: undefined;
-            success?: undefined;
-            error?: undefined;
-            inputText?: undefined;
-            outputText?: undefined;
-            heads?: undefined;
-            rootNode?: undefined;
-            original?: undefined;
-            modifications?: undefined;
-            inputs?: undefined;
-            output?: undefined;
-        };
-        required?: undefined;
-    };
-    handler: (args: {
-        traceIds?: string[];
-    }) => Promise<{
-        success: boolean;
-        report: {
-            reportId: string;
-            generatedAt: number;
-            summary: {
-                totalRequests: number;
-                successRate: number;
-                averageLatency: number;
-                totalCost: number;
-                modelsUsed: Record<string, number>;
-            };
-            auditLogEntries: number;
-            dataHandling: {
-                piiDetected: boolean;
-                piiLocations: string[];
-                dataRetentionCompliant: boolean;
-                encryptionUsed: boolean;
-            };
-            traceCount: number;
-        };
-    }>;
-} | {
-    name: string;
-    description: string;
-    inputSchema: {
-        type: string;
-        properties: {
-            traceId?: undefined;
-            modelUsed?: undefined;
-            totalCost?: undefined;
-            success?: undefined;
-            error?: undefined;
-            inputText?: undefined;
-            outputText?: undefined;
-            heads?: undefined;
-            rootNode?: undefined;
-            original?: undefined;
-            modifications?: undefined;
-            inputs?: undefined;
-            output?: undefined;
-            traceIds?: undefined;
-        };
-        required?: undefined;
-    };
-    handler: () => Promise<{
-        success: boolean;
-        metrics: {
-            tracesCollected: number;
-            averageOverheadMs: number;
-            overheadPercentage: number;
-            storageUsedMB: number;
-            complianceReportsGenerated: number;
-        };
-    }>;
-})[];
-//# sourceMappingURL=explainability-tools.d.ts.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"explainability-tools.d.ts","sourceRoot":"","sources":["../../../../src/mcp/fastmcp/tools/explainability-tools.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAMH;;GAEG;AACH,wBAAgB,2BAA2B,CAAC,MAAM,EAAE,GAAG,GAAG,IAAI,CAS7D;AAED,eAAO,MAAM,mBAAmB;;;;;;;;;;;;;;;;;;;;;;;;;;oBAeN;QAAE,OAAO,EAAE,MAAM,CAAA;KAAE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;oBA2CnB;QACpB,OAAO,EAAE,MAAM,CAAC;QAChB,SAAS,EAAE,MAAM,CAAC;QAClB,SAAS,EAAE,MAAM,CAAC;QAClB,OAAO,EAAE,OAAO,CAAC;QACjB,KAAK,CAAC,EAAE,MAAM,CAAC;KAChB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;oBAgCqB;QAAE,OAAO,EAAE,MAAM,CAAA;KAAE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;oBAkFnB;QACpB,OAAO,EAAE,MAAM,CAAC;QAChB,SAAS,EAAE,MAAM,CAAC;QAClB,UAAU,EAAE,MAAM,CAAC;QACnB,KAAK,EAAE,KAAK,CAAC;YACX,MAAM,EAAE,MAAM,CAAC;YACf,KAAK,EAAE,MAAM,CAAC;YACd,OAAO,EAAE,KAAK,CAAC;gBAAE,KAAK,EAAE,MAAM,CAAC;gBAAC,MAAM,EAAE,MAAM,CAAC;gBAAC,QAAQ,EAAE,MAAM,CAAA;aAAE,CAAC,CAAC;YACpE,IAAI,EAAE,MAAM,EAAE,CAAC;SAChB,CAAC,CAAC;KACJ;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;oBA0DqB;QACpB,OAAO,EAAE,MAAM,CAAC;QAChB,QAAQ,EAAE;YACR,MAAM,EAAE,MAAM,CAAC;YACf,QAAQ,EAAE,MAAM,CAAC;YACjB,SAAS,EAAE,MAAM,CAAC;YAClB,UAAU,EAAE,MAAM,CAAC;YACnB,YAAY,CAAC,EAAE,KAAK,CAAC;gBAAE,QAAQ,EAAE,MAAM,CAAC;gBAAC,UAAU,EAAE,MAAM,CAAC;gBAAC,SAAS,EAAE,MAAM,CAAA;aAAE,CAAC,CAAC;YAClF,QAAQ,CAAC,EAAE,GAAG,EAAE,CAAC;YACjB,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;SACpC,CAAC;KACH;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;oBA4CqB;QACpB,OAAO,EAAE,MAAM,CAAC;QAChB,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;QAClC,aAAa,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;KACxC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;oBAsCqB;QACpB,OAAO,EAAE,MAAM,CAAC;QAChB,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;QAChC,MAAM,EAAE,MAAM,CAAC;KAChB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;oBA6BqB;QAAE,OAAO,EAAE,MAAM,CAAA;KAAE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;oBAqCnB;QAAE,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAA;KAAE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;IAwChD,CAAC"}