@defai.digital/analysis-domain 13.0.3

package/dist/context-builder.js

@@ -0,0 +1,221 @@
+/**
+ * Code Context Builder
+ *
+ * Gathers code from file paths for analysis.
+ */
+import * as fs from 'fs/promises';
+import * as path from 'path';
+import { getLanguageFromPath, LIMIT_LINES_PER_FILE, } from '@defai.digital/contracts';
+/**
+ * Default exclude patterns
+ */
+const DEFAULT_EXCLUDE_PATTERNS = [
+    'node_modules',
+    'dist',
+    'build',
+    '.git',
+    '.next',
+    '__pycache__',
+    'venv',
+    '.venv',
+    'coverage',
+    '.nyc_output',
+    '*.min.js',
+    '*.bundle.js',
+    '*.map',
+    'package-lock.json',
+    'pnpm-lock.yaml',
+    'yarn.lock',
+];
+/**
+ * Analysis context builder error
+ */
+export class ContextBuilderError extends Error {
+    code;
+    constructor(code, message) {
+        super(message);
+        this.code = code;
+        this.name = 'ContextBuilderError';
+    }
+}
+/**
+ * Default gather options
+ */
+const DEFAULT_OPTIONS = {
+    maxFiles: 20,
+    maxLinesPerFile: LIMIT_LINES_PER_FILE,
+};
+/**
+ * Creates a code context builder
+ */
+export function createCodeContextBuilder() {
+    return {
+        async gatherCode(paths, options) {
+            const opts = { ...DEFAULT_OPTIONS, ...options };
+            const excludePatterns = [
+                ...DEFAULT_EXCLUDE_PATTERNS,
+                ...(opts.excludePatterns ?? []),
+            ];
+            const files = [];
+            let totalLines = 0;
+            let truncated = false;
+            // Resolve and deduplicate paths
+            const resolvedPaths = new Set();
+            for (const p of paths) {
+                const resolved = path.resolve(p);
+                resolvedPaths.add(resolved);
+            }
+            // Process each path
+            for (const filePath of resolvedPaths) {
+                if (files.length >= opts.maxFiles) {
+                    truncated = true;
+                    break;
+                }
+                try {
+                    const stat = await fs.stat(filePath);
+                    if (stat.isDirectory()) {
+                        // Recursively gather files from directory
+                        const dirFiles = await gatherFromDirectory(filePath, excludePatterns, opts.maxFiles - files.length, opts.maxLinesPerFile);
+                        files.push(...dirFiles);
+                        totalLines += dirFiles.reduce((sum, f) => sum + f.lines, 0);
+                        if (files.length >= opts.maxFiles) {
+                            truncated = true;
+                        }
+                    }
+                    else if (stat.isFile()) {
+                        // Read single file
+                        const file = await readFile(filePath, opts.maxLinesPerFile);
+                        if (file) {
+                            files.push(file);
+                            totalLines += file.lines;
+                        }
+                    }
+                }
+                catch (error) {
+                    // Skip files that can't be read
+                    if (error instanceof Error && 'code' in error && error.code === 'ENOENT') {
+                        continue;
+                    }
+                    throw error;
+                }
+            }
+            return {
+                files,
+                totalLines,
+                truncated,
+            };
+        },
+    };
+}
+/**
+ * Gather files from a directory recursively
+ */
+async function gatherFromDirectory(dirPath, excludePatterns, maxFiles, maxLinesPerFile) {
+    const files = [];
+    async function walk(currentPath) {
+        if (files.length >= maxFiles)
+            return;
+        const entries = await fs.readdir(currentPath, { withFileTypes: true });
+        for (const entry of entries) {
+            if (files.length >= maxFiles)
+                return;
+            const fullPath = path.join(currentPath, entry.name);
+            const relativePath = path.relative(dirPath, fullPath);
+            // Check exclude patterns
+            if (shouldExclude(relativePath, entry.name, excludePatterns)) {
+                continue;
+            }
+            if (entry.isDirectory()) {
+                await walk(fullPath);
+            }
+            else if (entry.isFile() && isAnalyzableFile(entry.name)) {
+                const file = await readFile(fullPath, maxLinesPerFile);
+                if (file) {
+                    files.push(file);
+                }
+            }
+        }
+    }
+    await walk(dirPath);
+    return files;
+}
+/**
+ * Read a single file
+ */
+async function readFile(filePath, maxLines) {
+    try {
+        const content = await fs.readFile(filePath, 'utf-8');
+        const lines = content.split('\n');
+        const truncatedContent = lines.length > maxLines ? lines.slice(0, maxLines).join('\n') + '\n// ... truncated' : content;
+        return {
+            path: filePath,
+            content: truncatedContent,
+            lines: Math.min(lines.length, maxLines),
+            language: getLanguageFromPath(filePath),
+        };
+    }
+    catch {
+        return null;
+    }
+}
+/**
+ * Check if path should be excluded
+ */
+function shouldExclude(relativePath, name, patterns) {
+    for (const pattern of patterns) {
+        if (pattern.startsWith('*.')) {
+            // Extension pattern
+            const ext = pattern.slice(1);
+            if (name.endsWith(ext))
+                return true;
+        }
+        else {
+            // Name or path pattern
+            if (name === pattern || relativePath.includes(pattern))
+                return true;
+        }
+    }
+    return false;
+}
+/**
+ * Check if file is analyzable (source code)
+ */
+function isAnalyzableFile(name) {
+    const analyzableExtensions = [
+        '.ts',
+        '.tsx',
+        '.js',
+        '.jsx',
+        '.py',
+        '.rb',
+        '.go',
+        '.rs',
+        '.java',
+        '.kt',
+        '.swift',
+        '.c',
+        '.cpp',
+        '.h',
+        '.hpp',
+        '.cs',
+        '.php',
+        '.vue',
+        '.svelte',
+    ];
+    return analyzableExtensions.some((ext) => name.endsWith(ext));
+}
+/**
+ * Format code context for display/debugging
+ */
+export function formatCodeContext(context) {
+    const lines = [];
+    lines.push(`Files: ${context.files.length}`);
+    lines.push(`Total Lines: ${context.totalLines}`);
+    lines.push(`Truncated: ${context.truncated}`);
+    lines.push('');
+    for (const file of context.files) {
+        lines.push(`--- ${file.path} (${file.language}, ${file.lines} lines) ---`);
+    }
+    return lines.join('\n');
+}
+//# sourceMappingURL=context-builder.js.map

package/dist/context-builder.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"context-builder.js","sourceRoot":"","sources":["../src/context-builder.ts"],"names":[],"mappings":"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"}

package/dist/index.d.ts

@@ -0,0 +1,16 @@
+/**
+ * @defai.digital/analysis-domain
+ *
+ * Analysis Domain - LLM-delegated code analysis
+ *
+ * Provides bugfix, refactor, review, and explain capabilities
+ * by delegating analysis to LLM providers.
+ */
+export { createCodeContextBuilder, formatCodeContext, ContextBuilderError, } from './context-builder.js';
+export { createAnalysisPromptBuilder, getTaskDescription, } from './prompt-builder.js';
+export { createAnalysisResponseParser, deduplicateFindings, ResponseParserError, } from './response-parser.js';
+export { createAnalysisService, createSimpleProvider, AnalysisError, } from './analysis-service.js';
+export { createAnalysisProviderRouter, createStubProviderRouter, type ProviderLike, type ProviderRegistryLike, type AnalysisProviderRouterConfig, } from './provider-router.js';
+export type { CodeContextBuilder, AnalysisPromptBuilder, AnalysisResponseParser, AnalysisService, AnalysisServiceDeps, AnalysisProvider, ProviderRouter, ProviderRequest, ProviderResponse, GatherOptions, } from './types.js';
+export type { AnalysisTask, AnalysisRequest, AnalysisResult, AnalysisFinding, CodeContext, AnalysisFile, FindingSeverity, AnalysisSeverityFilter, } from './types.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAGH,OAAO,EACL,wBAAwB,EACxB,iBAAiB,EACjB,mBAAmB,GACpB,MAAM,sBAAsB,CAAC;AAG9B,OAAO,EACL,2BAA2B,EAC3B,kBAAkB,GACnB,MAAM,qBAAqB,CAAC;AAG7B,OAAO,EACL,4BAA4B,EAC5B,mBAAmB,EACnB,mBAAmB,GACpB,MAAM,sBAAsB,CAAC;AAG9B,OAAO,EACL,qBAAqB,EACrB,oBAAoB,EACpB,aAAa,GACd,MAAM,uBAAuB,CAAC;AAG/B,OAAO,EACL,4BAA4B,EAC5B,wBAAwB,EACxB,KAAK,YAAY,EACjB,KAAK,oBAAoB,EACzB,KAAK,4BAA4B,GAClC,MAAM,sBAAsB,CAAC;AAG9B,YAAY,EACV,kBAAkB,EAClB,qBAAqB,EACrB,sBAAsB,EACtB,eAAe,EACf,mBAAmB,EACnB,gBAAgB,EAChB,cAAc,EACd,eAAe,EACf,gBAAgB,EAChB,aAAa,GACd,MAAM,YAAY,CAAC;AAGpB,YAAY,EACV,YAAY,EACZ,eAAe,EACf,cAAc,EACd,eAAe,EACf,WAAW,EACX,YAAY,EACZ,eAAe,EACf,sBAAsB,GACvB,MAAM,YAAY,CAAC"}

package/dist/index.js

@@ -0,0 +1,19 @@
+/**
+ * @defai.digital/analysis-domain
+ *
+ * Analysis Domain - LLM-delegated code analysis
+ *
+ * Provides bugfix, refactor, review, and explain capabilities
+ * by delegating analysis to LLM providers.
+ */
+// Context Builder
+export { createCodeContextBuilder, formatCodeContext, ContextBuilderError, } from './context-builder.js';
+// Prompt Builder
+export { createAnalysisPromptBuilder, getTaskDescription, } from './prompt-builder.js';
+// Response Parser
+export { createAnalysisResponseParser, deduplicateFindings, ResponseParserError, } from './response-parser.js';
+// Analysis Service
+export { createAnalysisService, createSimpleProvider, AnalysisError, } from './analysis-service.js';
+// Provider Router
+export { createAnalysisProviderRouter, createStubProviderRouter, } from './provider-router.js';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,kBAAkB;AAClB,OAAO,EACL,wBAAwB,EACxB,iBAAiB,EACjB,mBAAmB,GACpB,MAAM,sBAAsB,CAAC;AAE9B,iBAAiB;AACjB,OAAO,EACL,2BAA2B,EAC3B,kBAAkB,GACnB,MAAM,qBAAqB,CAAC;AAE7B,kBAAkB;AAClB,OAAO,EACL,4BAA4B,EAC5B,mBAAmB,EACnB,mBAAmB,GACpB,MAAM,sBAAsB,CAAC;AAE9B,mBAAmB;AACnB,OAAO,EACL,qBAAqB,EACrB,oBAAoB,EACpB,aAAa,GACd,MAAM,uBAAuB,CAAC;AAE/B,kBAAkB;AAClB,OAAO,EACL,4BAA4B,EAC5B,wBAAwB,GAIzB,MAAM,sBAAsB,CAAC"}

package/dist/prompt-builder.d.ts

@@ -0,0 +1,16 @@
+/**
+ * Analysis Prompt Builder
+ *
+ * Builds task-specific prompts for LLM analysis.
+ */
+import type { AnalysisTask } from '@defai.digital/contracts';
+import type { AnalysisPromptBuilder } from './types.js';
+/**
+ * Creates an analysis prompt builder
+ */
+export declare function createAnalysisPromptBuilder(): AnalysisPromptBuilder;
+/**
+ * Get task description for display
+ */
+export declare function getTaskDescription(task: AnalysisTask): string;
+//# sourceMappingURL=prompt-builder.d.ts.map

package/dist/prompt-builder.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"prompt-builder.d.ts","sourceRoot":"","sources":["../src/prompt-builder.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAe,MAAM,0BAA0B,CAAC;AAC1E,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,YAAY,CAAC;AAsKxD;;GAEG;AACH,wBAAgB,2BAA2B,IAAI,qBAAqB,CAkBnE;AAuCD;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,YAAY,GAAG,MAAM,CAa7D"}

package/dist/prompt-builder.js

@@ -0,0 +1,232 @@
+/**
+ * Analysis Prompt Builder
+ *
+ * Builds task-specific prompts for LLM analysis.
+ */
+/**
+ * Bugfix analysis prompt template
+ */
+const BUGFIX_PROMPT = `You are an expert code analyzer. Analyze the following code for bugs, errors, and potential issues.
+
+Focus on:
+- Logic errors and incorrect behavior
+- Null/undefined reference issues
+- Resource leaks (unclosed handles, missing cleanup)
+- Type mismatches and type errors
+- Concurrency issues (race conditions, deadlocks)
+- Security vulnerabilities (injection, XSS, etc.)
+- Error handling gaps
+- Edge cases not handled
+
+Code to analyze:
+{code}
+
+{userContext}
+
+Return your findings as JSON in this exact format:
+{
+  "findings": [
+    {
+      "file": "path/to/file.ts",
+      "line": 42,
+      "lineEnd": 45,
+      "title": "Brief issue title (max 100 chars)",
+      "description": "Detailed description of the issue and why it's a problem",
+      "severity": "high",
+      "category": "null-reference",
+      "suggestion": "How to fix this issue with specific code changes",
+      "confidence": 0.9
+    }
+  ]
+}
+
+Severity levels: "critical" (crashes/security), "high" (bugs), "medium" (potential issues), "low" (minor), "info" (suggestions)
+Categories: "logic-error", "null-reference", "type-error", "resource-leak", "security", "concurrency", "error-handling", "edge-case", "other"
+
+Important:
+- Only report actual bugs and issues, not style preferences
+- Be specific about line numbers and file paths
+- Provide actionable suggestions
+- If no issues found, return {"findings": []}
+- Confidence should reflect certainty (0.0-1.0)`;
+/**
+ * Refactor analysis prompt template
+ */
+const REFACTOR_PROMPT = `You are an expert code refactoring advisor. Analyze the following code for refactoring opportunities.
+
+Focus on:
+- Functions that are too long or complex (>50 lines, >10 cyclomatic complexity)
+- Duplicate code that could be extracted into shared functions
+- Poor naming that reduces readability
+- Complex conditionals that could be simplified
+- Opportunities to improve type safety
+- Code that violates single responsibility principle
+- Outdated patterns that could be modernized
+- Missing abstractions that would improve maintainability
+
+Code to analyze:
+{code}
+
+{userContext}
+
+Return your findings as JSON in this exact format:
+{
+  "findings": [
+    {
+      "file": "path/to/file.ts",
+      "line": 42,
+      "lineEnd": 80,
+      "title": "Brief opportunity title (max 100 chars)",
+      "description": "Description of the refactoring opportunity",
+      "severity": "medium",
+      "category": "extract-function",
+      "suggestion": "Suggested refactoring approach with example code",
+      "confidence": 0.85
+    }
+  ]
+}
+
+Severity levels: "high" (significant improvement), "medium" (moderate improvement), "low" (minor improvement), "info" (optional)
+Categories: "extract-function", "extract-variable", "simplify-conditional", "remove-duplication", "improve-types", "rename", "modernize", "split-responsibility", "other"
+
+Important:
+- Focus on impactful improvements that improve maintainability
+- Do not report trivial style issues (formatting, spacing)
+- Be specific about what to extract/change
+- Provide concrete suggestions with example code
+- If no opportunities found, return {"findings": []}`;
+/**
+ * Code review prompt template
+ */
+const REVIEW_PROMPT = `You are an expert code reviewer. Review the following code for quality, correctness, and best practices.
+
+Consider:
+- Code correctness and logic
+- Error handling completeness
+- Edge cases and boundary conditions
+- Performance considerations
+- Security best practices
+- Code readability and maintainability
+- Documentation quality
+- Test coverage considerations
+
+Code to review:
+{code}
+
+{userContext}
+
+Return your review as JSON in this exact format:
+{
+  "findings": [
+    {
+      "file": "path/to/file.ts",
+      "line": 42,
+      "title": "Review finding title",
+      "description": "Detailed explanation of the review finding",
+      "severity": "medium",
+      "category": "best-practice",
+      "suggestion": "Recommendation for improvement",
+      "confidence": 0.8
+    }
+  ]
+}
+
+Severity levels: "critical" (must fix), "high" (should fix), "medium" (consider fixing), "low" (nice to have), "info" (observation)
+Categories: "correctness", "error-handling", "performance", "security", "readability", "documentation", "testing", "best-practice", "other"`;
+/**
+ * Code explanation prompt template
+ */
+const EXPLAIN_PROMPT = `You are an expert code explainer. Explain what the following code does.
+
+Code to explain:
+{code}
+
+{userContext}
+
+Return your explanation as JSON in this exact format:
+{
+  "findings": [
+    {
+      "file": "path/to/file.ts",
+      "line": 1,
+      "title": "Code Overview",
+      "description": "High-level explanation of what this code does and its purpose",
+      "severity": "info",
+      "category": "explanation",
+      "suggestion": "Additional context or notes about the implementation",
+      "confidence": 1.0
+    }
+  ]
+}
+
+For each significant function/component, provide a separate finding explaining:
+- What it does
+- Key implementation details
+- Any notable patterns or techniques used`;
+/**
+ * Creates an analysis prompt builder
+ */
+export function createAnalysisPromptBuilder() {
+    return {
+        buildPrompt(task, context, userContext) {
+            const template = getPromptTemplate(task);
+            const codeBlock = formatCodeForPrompt(context);
+            const contextBlock = userContext
+                ? `Additional context from user:\n${userContext}`
+                : '';
+            return template
+                .replace('{code}', codeBlock)
+                .replace('{userContext}', contextBlock);
+        },
+    };
+}
+/**
+ * Get prompt template for task
+ */
+function getPromptTemplate(task) {
+    switch (task) {
+        case 'bugfix':
+            return BUGFIX_PROMPT;
+        case 'refactor':
+            return REFACTOR_PROMPT;
+        case 'review':
+            return REVIEW_PROMPT;
+        case 'explain':
+            return EXPLAIN_PROMPT;
+        default:
+            return REVIEW_PROMPT;
+    }
+}
+/**
+ * Format code context for inclusion in prompt
+ */
+function formatCodeForPrompt(context) {
+    const parts = [];
+    for (const file of context.files) {
+        parts.push(`--- File: ${file.path} (${file.language}) ---`);
+        parts.push(file.content);
+        parts.push('');
+    }
+    if (context.truncated) {
+        parts.push('--- Note: Some files were truncated due to size limits ---');
+    }
+    return parts.join('\n');
+}
+/**
+ * Get task description for display
+ */
+export function getTaskDescription(task) {
+    switch (task) {
+        case 'bugfix':
+            return 'Bug Detection';
+        case 'refactor':
+            return 'Refactoring Opportunities';
+        case 'review':
+            return 'Code Review';
+        case 'explain':
+            return 'Code Explanation';
+        default:
+            return 'Analysis';
+    }
+}
+//# sourceMappingURL=prompt-builder.js.map

package/dist/prompt-builder.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"prompt-builder.js","sourceRoot":"","sources":["../src/prompt-builder.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAKH;;GAEG;AACH,MAAM,aAAa,GAAG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;gDA0C0B,CAAC;AAEjD;;GAEG;AACH,MAAM,eAAe,GAAG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;qDA0C6B,CAAC;AAEtD;;GAEG;AACH,MAAM,aAAa,GAAG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;4IAkCsH,CAAC;AAE7I;;GAEG;AACH,MAAM,cAAc,GAAG;;;;;;;;;;;;;;;;;;;;;;;;;;0CA0BmB,CAAC;AAE3C;;GAEG;AACH,MAAM,UAAU,2BAA2B;IACzC,OAAO;QACL,WAAW,CACT,IAAkB,EAClB,OAAoB,EACpB,WAAoB;YAEpB,MAAM,QAAQ,GAAG,iBAAiB,CAAC,IAAI,CAAC,CAAC;YACzC,MAAM,SAAS,GAAG,mBAAmB,CAAC,OAAO,CAAC,CAAC;YAC/C,MAAM,YAAY,GAAG,WAAW;gBAC9B,CAAC,CAAC,kCAAkC,WAAW,EAAE;gBACjD,CAAC,CAAC,EAAE,CAAC;YAEP,OAAO,QAAQ;iBACZ,OAAO,CAAC,QAAQ,EAAE,SAAS,CAAC;iBAC5B,OAAO,CAAC,eAAe,EAAE,YAAY,CAAC,CAAC;QAC5C,CAAC;KACF,CAAC;AACJ,CAAC;AAED;;GAEG;AACH,SAAS,iBAAiB,CAAC,IAAkB;IAC3C,QAAQ,IAAI,EAAE,CAAC;QACb,KAAK,QAAQ;YACX,OAAO,aAAa,CAAC;QACvB,KAAK,UAAU;YACb,OAAO,eAAe,CAAC;QACzB,KAAK,QAAQ;YACX,OAAO,aAAa,CAAC;QACvB,KAAK,SAAS;YACZ,OAAO,cAAc,CAAC;QACxB;YACE,OAAO,aAAa,CAAC;IACzB,CAAC;AACH,CAAC;AAED;;GAEG;AACH,SAAS,mBAAmB,CAAC,OAAoB;IAC/C,MAAM,KAAK,GAAa,EAAE,CAAC;IAE3B,KAAK,MAAM,IAAI,IAAI,OAAO,CAAC,KAAK,EAAE,CAAC;QACjC,KAAK,CAAC,IAAI,CAAC,aAAa,IAAI,CAAC,IAAI,KAAK,IAAI,CAAC,QAAQ,OAAO,CAAC,CAAC;QAC5D,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;QACzB,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACjB,CAAC;IAED,IAAI,OAAO,CAAC,SAAS,EAAE,CAAC;QACtB,KAAK,CAAC,IAAI,CAAC,4DAA4D,CAAC,CAAC;IAC3E,CAAC;IAED,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAC1B,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,kBAAkB,CAAC,IAAkB;IACnD,QAAQ,IAAI,EAAE,CAAC;QACb,KAAK,QAAQ;YACX,OAAO,eAAe,CAAC;QACzB,KAAK,UAAU;YACb,OAAO,2BAA2B,CAAC;QACrC,KAAK,QAAQ;YACX,OAAO,aAAa,CAAC;QACvB,KAAK,SAAS;YACZ,OAAO,kBAAkB,CAAC;QAC5B;YACE,OAAO,UAAU,CAAC;IACtB,CAAC;AACH,CAAC"}

package/dist/provider-router.d.ts

@@ -0,0 +1,64 @@
+/**
+ * Analysis Provider Router
+ *
+ * Bridges the analysis domain to actual LLM provider implementations.
+ * Eliminates the mock provider by connecting to real provider registry.
+ */
+import type { ProviderRouter } from './types.js';
+/**
+ * Provider interface (minimal - matches what we need from provider adapters)
+ */
+export interface ProviderLike {
+    providerId: string;
+    complete(request: {
+        requestId: string;
+        model: string;
+        messages: {
+            role: string;
+            content: string;
+        }[];
+        maxTokens?: number;
+        temperature?: number;
+        timeout?: number;
+    }): Promise<{
+        success: boolean;
+        content: string;
+        tokensUsed?: number;
+    } | {
+        success: false;
+        error: unknown;
+    }>;
+    isAvailable(): Promise<boolean>;
+    getModels(): readonly {
+        modelId: string;
+        isDefault?: boolean;
+    }[];
+}
+/**
+ * Provider registry interface (minimal - matches what we need)
+ */
+export interface ProviderRegistryLike {
+    get(providerId: string): ProviderLike | undefined;
+    getProviderIds(): string[];
+}
+/**
+ * Configuration for the analysis provider router
+ */
+export interface AnalysisProviderRouterConfig {
+    /** Provider registry to use */
+    registry: ProviderRegistryLike;
+    /** Default provider ID */
+    defaultProvider?: string;
+    /** Default timeout in ms */
+    defaultTimeout?: number;
+}
+/**
+ * Creates a provider router that bridges to real providers
+ */
+export declare function createAnalysisProviderRouter(config: AnalysisProviderRouterConfig): ProviderRouter;
+/**
+ * Creates a stub provider router for testing
+ * Returns empty findings (same as mock provider behavior)
+ */
+export declare function createStubProviderRouter(): ProviderRouter;
+//# sourceMappingURL=provider-router.d.ts.map

package/dist/provider-router.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"provider-router.d.ts","sourceRoot":"","sources":["../src/provider-router.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,KAAK,EAEV,cAAc,EAGf,MAAM,YAAY,CAAC;AAEpB;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,CAAC,OAAO,EAAE;QAChB,SAAS,EAAE,MAAM,CAAC;QAClB,KAAK,EAAE,MAAM,CAAC;QACd,QAAQ,EAAE;YAAE,IAAI,EAAE,MAAM,CAAC;YAAC,OAAO,EAAE,MAAM,CAAA;SAAE,EAAE,CAAC;QAC9C,SAAS,CAAC,EAAE,MAAM,CAAC;QACnB,WAAW,CAAC,EAAE,MAAM,CAAC;QACrB,OAAO,CAAC,EAAE,MAAM,CAAC;KAClB,GAAG,OAAO,CAAC;QACV,OAAO,EAAE,OAAO,CAAC;QACjB,OAAO,EAAE,MAAM,CAAC;QAChB,UAAU,CAAC,EAAE,MAAM,CAAC;KACrB,GAAG;QAAE,OAAO,EAAE,KAAK,CAAC;QAAC,KAAK,EAAE,OAAO,CAAA;KAAE,CAAC,CAAC;IACxC,WAAW,IAAI,OAAO,CAAC,OAAO,CAAC,CAAC;IAChC,SAAS,IAAI,SAAS;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,SAAS,CAAC,EAAE,OAAO,CAAA;KAAE,EAAE,CAAC;CAClE;AAED;;GAEG;AACH,MAAM,WAAW,oBAAoB;IACnC,GAAG,CAAC,UAAU,EAAE,MAAM,GAAG,YAAY,GAAG,SAAS,CAAC;IAClD,cAAc,IAAI,MAAM,EAAE,CAAC;CAC5B;AAED;;GAEG;AACH,MAAM,WAAW,4BAA4B;IAC3C,+BAA+B;IAC/B,QAAQ,EAAE,oBAAoB,CAAC;IAE/B,0BAA0B;IAC1B,eAAe,CAAC,EAAE,MAAM,CAAC;IAEzB,4BAA4B;IAC5B,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB;AAED;;GAEG;AACH,wBAAgB,4BAA4B,CAC1C,MAAM,EAAE,4BAA4B,GACnC,cAAc,CA+BhB;AA0DD;;;GAGG;AACH,wBAAgB,wBAAwB,IAAI,cAAc,CAoBzD"}