circle-ir-ai 1.1.0

package/dist/agents/mastra/instance.d.ts

@@ -0,0 +1,383 @@
+/**
+ * Mastra Instance Configuration
+ *
+ * Provides factory functions to create configured Mastra instances
+ * with agents and workflows for security analysis.
+ */
+import { Mastra } from '@mastra/core';
+import { analyzeFile, analyzeFileStream } from './workflow.js';
+import { analyzeFilesSwarm, analyzeFilesSwarmStream } from './swarm.js';
+export interface MastraInstanceOptions {
+    logLevel?: 'debug' | 'info' | 'warn' | 'error';
+}
+/**
+ * Create a configured Mastra instance for security analysis
+ *
+ * This sets up the Mastra framework with:
+ * - Security analysis agents (enrichment, verification, cross-file, orchestrator)
+ * - Single-file analysis workflow
+ * - Multi-file swarm analysis workflow
+ */
+export declare function createMastraInstance(options?: MastraInstanceOptions): {
+    mastra: Mastra<{
+        enrichment: import("@mastra/core/agent").Agent<"enrichment-agent", {
+            classifyRole: import("@mastra/core/tools").Tool<{
+                className: string;
+                methodNames: string;
+                annotations: string;
+                imports: string;
+            }, {
+                role: "controller" | "service" | "repository" | "utility" | "entity" | "unknown";
+                confidence: number;
+                reasoning: string;
+                indicators: string[];
+            }, unknown, unknown, import("@mastra/core/tools").ToolExecutionContext<unknown, unknown, unknown>, "classify-role", unknown>;
+            discoverSources: import("@mastra/core/tools").Tool<{
+                methodName: string;
+                classRole: string;
+                existingSources: string;
+                methodCode: string;
+            }, {
+                sources: {
+                    line: number;
+                    variable: string;
+                    type: string;
+                    confidence: number;
+                    reasoning: string;
+                }[];
+            }, unknown, unknown, import("@mastra/core/tools").ToolExecutionContext<unknown, unknown, unknown>, "discover-sources", unknown>;
+            discoverSinks: import("@mastra/core/tools").Tool<{
+                methodName: string;
+                methodCalls: string;
+                existingSinks: string;
+                methodCode: string;
+            }, {
+                sinks: {
+                    line: number;
+                    method: string;
+                    type: string;
+                    cwe: string;
+                    argPositions: number[];
+                    confidence: number;
+                    reasoning: string;
+                }[];
+            }, unknown, unknown, import("@mastra/core/tools").ToolExecutionContext<unknown, unknown, unknown>, "discover-sinks", unknown>;
+        }, undefined, unknown>;
+        verification: import("@mastra/core/agent").Agent<"verification-agent", {
+            verifyVulnerability: import("@mastra/core/tools").Tool<{
+                cwe: string;
+                sourceType: string;
+                className: string;
+                methodName: string;
+                methodCode: string;
+                sourceLine: number;
+                sourceCode: string;
+                sinkLine: number;
+                sinkCode: string;
+                sinkType: string;
+                sanitizersInPath: string[];
+            }, {
+                verdict: "TRUE_POSITIVE" | "FALSE_POSITIVE" | "UNCERTAIN";
+                confidence: number;
+                reasoning: string;
+                exploitability: "high" | "medium" | "low" | "none";
+                sanitizersFound: string[];
+                attackVector: string;
+            }, unknown, unknown, import("@mastra/core/tools").ToolExecutionContext<unknown, unknown, unknown>, "verify-vulnerability", unknown>;
+        }, undefined, unknown>;
+        crossFile: import("@mastra/core/agent").Agent<"cross-file-agent", {
+            crossFileTaint: import("@mastra/core/tools").Tool<{
+                sourceCode: string;
+                sourceFile: string;
+                targetFile: string;
+                targetCode: string;
+                exportedTaint: {
+                    symbol: string;
+                    type: string;
+                    line: number;
+                }[];
+                importedSymbols: string[];
+            }, {
+                taintFlows: Array<{
+                    sourceSymbol: string;
+                    targetSymbol: string;
+                    flowType: "direct" | "transitive" | "conditional";
+                    confidence: number;
+                }>;
+                reasoning: string;
+            }, unknown, unknown, import("@mastra/core/tools").ToolExecutionContext<unknown, unknown, unknown>, "cross-file-taint", unknown>;
+        }, undefined, unknown>;
+        orchestrator: import("@mastra/core/agent").Agent<"orchestrator-agent", {
+            classifyRole: import("@mastra/core/tools").Tool<{
+                className: string;
+                methodNames: string;
+                annotations: string;
+                imports: string;
+            }, {
+                role: "controller" | "service" | "repository" | "utility" | "entity" | "unknown";
+                confidence: number;
+                reasoning: string;
+                indicators: string[];
+            }, unknown, unknown, import("@mastra/core/tools").ToolExecutionContext<unknown, unknown, unknown>, "classify-role", unknown>;
+            discoverSources: import("@mastra/core/tools").Tool<{
+                methodName: string;
+                classRole: string;
+                existingSources: string;
+                methodCode: string;
+            }, {
+                sources: {
+                    line: number;
+                    variable: string;
+                    type: string;
+                    confidence: number;
+                    reasoning: string;
+                }[];
+            }, unknown, unknown, import("@mastra/core/tools").ToolExecutionContext<unknown, unknown, unknown>, "discover-sources", unknown>;
+            discoverSinks: import("@mastra/core/tools").Tool<{
+                methodName: string;
+                methodCalls: string;
+                existingSinks: string;
+                methodCode: string;
+            }, {
+                sinks: {
+                    line: number;
+                    method: string;
+                    type: string;
+                    cwe: string;
+                    argPositions: number[];
+                    confidence: number;
+                    reasoning: string;
+                }[];
+            }, unknown, unknown, import("@mastra/core/tools").ToolExecutionContext<unknown, unknown, unknown>, "discover-sinks", unknown>;
+            verifyVulnerability: import("@mastra/core/tools").Tool<{
+                cwe: string;
+                sourceType: string;
+                className: string;
+                methodName: string;
+                methodCode: string;
+                sourceLine: number;
+                sourceCode: string;
+                sinkLine: number;
+                sinkCode: string;
+                sinkType: string;
+                sanitizersInPath: string[];
+            }, {
+                verdict: "TRUE_POSITIVE" | "FALSE_POSITIVE" | "UNCERTAIN";
+                confidence: number;
+                reasoning: string;
+                exploitability: "high" | "medium" | "low" | "none";
+                sanitizersFound: string[];
+                attackVector: string;
+            }, unknown, unknown, import("@mastra/core/tools").ToolExecutionContext<unknown, unknown, unknown>, "verify-vulnerability", unknown>;
+            crossFileTaint: import("@mastra/core/tools").Tool<{
+                sourceCode: string;
+                sourceFile: string;
+                targetFile: string;
+                targetCode: string;
+                exportedTaint: {
+                    symbol: string;
+                    type: string;
+                    line: number;
+                }[];
+                importedSymbols: string[];
+            }, {
+                taintFlows: Array<{
+                    sourceSymbol: string;
+                    targetSymbol: string;
+                    flowType: "direct" | "transitive" | "conditional";
+                    confidence: number;
+                }>;
+                reasoning: string;
+            }, unknown, unknown, import("@mastra/core/tools").ToolExecutionContext<unknown, unknown, unknown>, "cross-file-taint", unknown>;
+        }, undefined, unknown>;
+    }, Record<string, import("@mastra/core/workflows").Workflow<any, any, any, any, any, any, any, unknown>>, Record<string, import("@mastra/core/vector").MastraVector<any>>, Record<string, import("@mastra/core/tts").MastraTTS>, import("@mastra/core/logger").IMastraLogger, Record<string, import("@mastra/core/mcp").MCPServerBase<any>>, Record<string, import("@mastra/core/evals").MastraScorer<any, any, any, any>>, Record<string, import("@mastra/core/tools").ToolAction<any, any, any, any, any, any, unknown>>, Record<string, import("@mastra/core/processors").Processor<any, unknown>>, Record<string, import("@mastra/core/memory").MastraMemory>>;
+    agents: {
+        enrichment: import("@mastra/core/agent").Agent<"enrichment-agent", {
+            classifyRole: import("@mastra/core/tools").Tool<{
+                className: string;
+                methodNames: string;
+                annotations: string;
+                imports: string;
+            }, {
+                role: "controller" | "service" | "repository" | "utility" | "entity" | "unknown";
+                confidence: number;
+                reasoning: string;
+                indicators: string[];
+            }, unknown, unknown, import("@mastra/core/tools").ToolExecutionContext<unknown, unknown, unknown>, "classify-role", unknown>;
+            discoverSources: import("@mastra/core/tools").Tool<{
+                methodName: string;
+                classRole: string;
+                existingSources: string;
+                methodCode: string;
+            }, {
+                sources: {
+                    line: number;
+                    variable: string;
+                    type: string;
+                    confidence: number;
+                    reasoning: string;
+                }[];
+            }, unknown, unknown, import("@mastra/core/tools").ToolExecutionContext<unknown, unknown, unknown>, "discover-sources", unknown>;
+            discoverSinks: import("@mastra/core/tools").Tool<{
+                methodName: string;
+                methodCalls: string;
+                existingSinks: string;
+                methodCode: string;
+            }, {
+                sinks: {
+                    line: number;
+                    method: string;
+                    type: string;
+                    cwe: string;
+                    argPositions: number[];
+                    confidence: number;
+                    reasoning: string;
+                }[];
+            }, unknown, unknown, import("@mastra/core/tools").ToolExecutionContext<unknown, unknown, unknown>, "discover-sinks", unknown>;
+        }, undefined, unknown>;
+        verification: import("@mastra/core/agent").Agent<"verification-agent", {
+            verifyVulnerability: import("@mastra/core/tools").Tool<{
+                cwe: string;
+                sourceType: string;
+                className: string;
+                methodName: string;
+                methodCode: string;
+                sourceLine: number;
+                sourceCode: string;
+                sinkLine: number;
+                sinkCode: string;
+                sinkType: string;
+                sanitizersInPath: string[];
+            }, {
+                verdict: "TRUE_POSITIVE" | "FALSE_POSITIVE" | "UNCERTAIN";
+                confidence: number;
+                reasoning: string;
+                exploitability: "high" | "medium" | "low" | "none";
+                sanitizersFound: string[];
+                attackVector: string;
+            }, unknown, unknown, import("@mastra/core/tools").ToolExecutionContext<unknown, unknown, unknown>, "verify-vulnerability", unknown>;
+        }, undefined, unknown>;
+        crossFile: import("@mastra/core/agent").Agent<"cross-file-agent", {
+            crossFileTaint: import("@mastra/core/tools").Tool<{
+                sourceCode: string;
+                sourceFile: string;
+                targetFile: string;
+                targetCode: string;
+                exportedTaint: {
+                    symbol: string;
+                    type: string;
+                    line: number;
+                }[];
+                importedSymbols: string[];
+            }, {
+                taintFlows: Array<{
+                    sourceSymbol: string;
+                    targetSymbol: string;
+                    flowType: "direct" | "transitive" | "conditional";
+                    confidence: number;
+                }>;
+                reasoning: string;
+            }, unknown, unknown, import("@mastra/core/tools").ToolExecutionContext<unknown, unknown, unknown>, "cross-file-taint", unknown>;
+        }, undefined, unknown>;
+        orchestrator: import("@mastra/core/agent").Agent<"orchestrator-agent", {
+            classifyRole: import("@mastra/core/tools").Tool<{
+                className: string;
+                methodNames: string;
+                annotations: string;
+                imports: string;
+            }, {
+                role: "controller" | "service" | "repository" | "utility" | "entity" | "unknown";
+                confidence: number;
+                reasoning: string;
+                indicators: string[];
+            }, unknown, unknown, import("@mastra/core/tools").ToolExecutionContext<unknown, unknown, unknown>, "classify-role", unknown>;
+            discoverSources: import("@mastra/core/tools").Tool<{
+                methodName: string;
+                classRole: string;
+                existingSources: string;
+                methodCode: string;
+            }, {
+                sources: {
+                    line: number;
+                    variable: string;
+                    type: string;
+                    confidence: number;
+                    reasoning: string;
+                }[];
+            }, unknown, unknown, import("@mastra/core/tools").ToolExecutionContext<unknown, unknown, unknown>, "discover-sources", unknown>;
+            discoverSinks: import("@mastra/core/tools").Tool<{
+                methodName: string;
+                methodCalls: string;
+                existingSinks: string;
+                methodCode: string;
+            }, {
+                sinks: {
+                    line: number;
+                    method: string;
+                    type: string;
+                    cwe: string;
+                    argPositions: number[];
+                    confidence: number;
+                    reasoning: string;
+                }[];
+            }, unknown, unknown, import("@mastra/core/tools").ToolExecutionContext<unknown, unknown, unknown>, "discover-sinks", unknown>;
+            verifyVulnerability: import("@mastra/core/tools").Tool<{
+                cwe: string;
+                sourceType: string;
+                className: string;
+                methodName: string;
+                methodCode: string;
+                sourceLine: number;
+                sourceCode: string;
+                sinkLine: number;
+                sinkCode: string;
+                sinkType: string;
+                sanitizersInPath: string[];
+            }, {
+                verdict: "TRUE_POSITIVE" | "FALSE_POSITIVE" | "UNCERTAIN";
+                confidence: number;
+                reasoning: string;
+                exploitability: "high" | "medium" | "low" | "none";
+                sanitizersFound: string[];
+                attackVector: string;
+            }, unknown, unknown, import("@mastra/core/tools").ToolExecutionContext<unknown, unknown, unknown>, "verify-vulnerability", unknown>;
+            crossFileTaint: import("@mastra/core/tools").Tool<{
+                sourceCode: string;
+                sourceFile: string;
+                targetFile: string;
+                targetCode: string;
+                exportedTaint: {
+                    symbol: string;
+                    type: string;
+                    line: number;
+                }[];
+                importedSymbols: string[];
+            }, {
+                taintFlows: Array<{
+                    sourceSymbol: string;
+                    targetSymbol: string;
+                    flowType: "direct" | "transitive" | "conditional";
+                    confidence: number;
+                }>;
+                reasoning: string;
+            }, unknown, unknown, import("@mastra/core/tools").ToolExecutionContext<unknown, unknown, unknown>, "cross-file-taint", unknown>;
+        }, undefined, unknown>;
+    };
+    analyzeFile: typeof analyzeFile;
+    analyzeFileStream: typeof analyzeFileStream;
+    securityAnalysisWorkflow: {
+        id: string;
+        run: typeof analyzeFile;
+        stream: typeof analyzeFileStream;
+    };
+    analyzeFilesSwarm: typeof analyzeFilesSwarm;
+    analyzeFilesSwarmStream: typeof analyzeFilesSwarmStream;
+    swarmAnalysisWorkflow: {
+        id: string;
+        run: typeof analyzeFilesSwarm;
+        stream: typeof analyzeFilesSwarmStream;
+        runInBatches: typeof import("./swarm.js").analyzeFilesInBatches;
+    };
+};
+export default createMastraInstance;
+//# sourceMappingURL=instance.d.ts.map

package/dist/agents/mastra/instance.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"instance.d.ts","sourceRoot":"","sources":["../../../src/agents/mastra/instance.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,MAAM,EAAE,MAAM,cAAc,CAAC;AAEtC,OAAO,EAA4B,WAAW,EAAE,iBAAiB,EAAE,MAAM,eAAe,CAAC;AACzF,OAAO,EAAyB,iBAAiB,EAAE,uBAAuB,EAAE,MAAM,YAAY,CAAC;AAM/F,MAAM,WAAW,qBAAqB;IACpC,QAAQ,CAAC,EAAE,OAAO,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC;CAChD;AAED;;;;;;;GAOG;AACH,wBAAgB,oBAAoB,CAAC,OAAO,CAAC,EAAE,qBAAqB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAmBnE;AAED,eAAe,oBAAoB,CAAC"}

package/dist/agents/mastra/instance.js

@@ -0,0 +1,37 @@
+/**
+ * Mastra Instance Configuration
+ *
+ * Provides factory functions to create configured Mastra instances
+ * with agents and workflows for security analysis.
+ */
+import { Mastra } from '@mastra/core';
+import { agents } from './agents.js';
+import { securityAnalysisWorkflow, analyzeFile, analyzeFileStream } from './workflow.js';
+import { swarmAnalysisWorkflow, analyzeFilesSwarm, analyzeFilesSwarmStream } from './swarm.js';
+/**
+ * Create a configured Mastra instance for security analysis
+ *
+ * This sets up the Mastra framework with:
+ * - Security analysis agents (enrichment, verification, cross-file, orchestrator)
+ * - Single-file analysis workflow
+ * - Multi-file swarm analysis workflow
+ */
+export function createMastraInstance(options) {
+    const mastra = new Mastra({
+        agents,
+    });
+    return {
+        mastra,
+        agents,
+        // Single-file analysis
+        analyzeFile,
+        analyzeFileStream,
+        securityAnalysisWorkflow,
+        // Multi-file swarm analysis
+        analyzeFilesSwarm,
+        analyzeFilesSwarmStream,
+        swarmAnalysisWorkflow,
+    };
+}
+export default createMastraInstance;
+//# sourceMappingURL=instance.js.map

package/dist/agents/mastra/instance.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"instance.js","sourceRoot":"","sources":["../../../src/agents/mastra/instance.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,MAAM,EAAE,MAAM,cAAc,CAAC;AACtC,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AACrC,OAAO,EAAE,wBAAwB,EAAE,WAAW,EAAE,iBAAiB,EAAE,MAAM,eAAe,CAAC;AACzF,OAAO,EAAE,qBAAqB,EAAE,iBAAiB,EAAE,uBAAuB,EAAE,MAAM,YAAY,CAAC;AAU/F;;;;;;;GAOG;AACH,MAAM,UAAU,oBAAoB,CAAC,OAA+B;IAClE,MAAM,MAAM,GAAG,IAAI,MAAM,CAAC;QACxB,MAAM;KACP,CAAC,CAAC;IAEH,OAAO;QACL,MAAM;QACN,MAAM;QAEN,uBAAuB;QACvB,WAAW;QACX,iBAAiB;QACjB,wBAAwB;QAExB,4BAA4B;QAC5B,iBAAiB;QACjB,uBAAuB;QACvB,qBAAqB;KACtB,CAAC;AACJ,CAAC;AAED,eAAe,oBAAoB,CAAC"}