rlm-analyzer 1.1.0

package/dist/index.js

@@ -0,0 +1,142 @@
+/**
+ * RLM Analyzer
+ * Recursive Language Model code analysis tool
+ *
+ * Based on MIT CSAIL research: arXiv:2512.24601v1
+ * "Recursive Language Models: A Paradigm for Processing Arbitrarily Long Inputs"
+ */
+// Types
+export * from './types.js';
+// Configuration
+export { getApiKey, getAIClient, initConfig, hasApiKey } from './config.js';
+// Model configuration (new in v1.1)
+export { 
+// Resolution functions
+resolveModelConfig, getDefaultModel, getFallbackModel, resolveModelAlias, isModelAlias, 
+// Display helpers
+getModelConfigDisplay, getAliasesDisplay, 
+// Constants
+MODEL_ALIASES, AVAILABLE_MODELS, 
+// Backward compatibility (deprecated)
+DEFAULT_MODEL, FALLBACK_MODEL, } from './models.js';
+// Core components
+export { RLMExecutor } from './executor.js';
+export { RLMOrchestrator } from './orchestrator.js';
+// High-level analysis functions
+export { loadFiles, analyzeCodebase, analyzeArchitecture, analyzeDependencies, analyzeSecurity, analyzePerformance, analyzeRefactoring, summarizeCodebase, findUsages, explainFile, askQuestion, } from './analyzer.js';
+// Prompts
+export { CODE_ANALYSIS_PROMPT, ARCHITECTURE_PROMPT, DEPENDENCY_PROMPT, SECURITY_PROMPT, PERFORMANCE_PROMPT, REFACTOR_PROMPT, SUMMARY_PROMPT, getSystemPrompt, getAnalysisPrompt, buildContextMessage, } from './prompts.js';
+// ============================================================================
+// Factory Functions for IDE Integration (Claude Code, Codex, Cursor)
+// ============================================================================
+import { RLMOrchestrator } from './orchestrator.js';
+import { analyzeCodebase } from './analyzer.js';
+import { resolveModelConfig } from './models.js';
+import { getDefaultRLMConfig } from './types.js';
+/**
+ * Create an analyzer instance for IDE integration
+ *
+ * This is the recommended way to use RLM Analyzer programmatically.
+ * It handles model resolution using the priority chain and returns
+ * a configured analyzer ready for use.
+ *
+ * @example
+ * ```typescript
+ * import { createAnalyzer } from 'rlm-analyzer';
+ *
+ * // Use default configuration
+ * const analyzer = createAnalyzer();
+ * const result = await analyzer.analyze('./my-project');
+ *
+ * // Use specific model
+ * const fastAnalyzer = createAnalyzer({ model: 'fast' });
+ * const result = await fastAnalyzer.analyze('./my-project');
+ *
+ * // Access the orchestrator directly
+ * const orchestrator = analyzer.orchestrator;
+ * ```
+ *
+ * @param options - Configuration options
+ * @returns Analyzer instance with analyze function and orchestrator
+ */
+export function createAnalyzer(options = {}) {
+    const modelConfig = resolveModelConfig({
+        model: options.model,
+        fallbackModel: options.fallbackModel,
+    });
+    const config = getDefaultRLMConfig(modelConfig.defaultModel);
+    // Apply any config overrides
+    if (options.config) {
+        Object.assign(config, options.config);
+    }
+    const orchestrator = new RLMOrchestrator(config, options.verbose);
+    const analyze = async (directory, analysisOptions = {}) => {
+        return analyzeCodebase({
+            directory,
+            ...analysisOptions,
+            model: modelConfig.defaultModel,
+            verbose: options.verbose,
+        });
+    };
+    return {
+        analyze,
+        orchestrator,
+        config,
+        modelConfig,
+    };
+}
+/**
+ * Create a configured RLMOrchestrator instance
+ *
+ * Use this when you need direct access to the orchestrator
+ * for custom workflows or advanced use cases.
+ *
+ * @example
+ * ```typescript
+ * import { createOrchestrator, loadFiles } from 'rlm-analyzer';
+ *
+ * const orchestrator = createOrchestrator({ model: 'smart' });
+ * const files = await loadFiles('./src');
+ * const result = await orchestrator.processQuery(
+ *   'Explain this codebase',
+ *   { files, variables: {}, mode: 'code-analysis' }
+ * );
+ * ```
+ *
+ * @param options - Configuration options
+ * @returns Configured RLMOrchestrator instance
+ */
+export function createOrchestrator(options = {}) {
+    const modelConfig = resolveModelConfig({ model: options.model });
+    const config = getDefaultRLMConfig(modelConfig.defaultModel);
+    // Apply any config overrides
+    if (options.config) {
+        Object.assign(config, options.config);
+    }
+    return new RLMOrchestrator(config, options.verbose);
+}
+/**
+ * Get resolved model configuration
+ *
+ * Use this to check what models will be used based on
+ * the current environment, config file, and any overrides.
+ *
+ * @example
+ * ```typescript
+ * import { getModelConfig } from 'rlm-analyzer';
+ *
+ * const config = getModelConfig();
+ * console.log(`Default model: ${config.defaultModel}`);
+ * console.log(`Source: ${config.defaultSource}`);
+ *
+ * // With override
+ * const custom = getModelConfig({ model: 'fast' });
+ * ```
+ *
+ * @param options - Optional model overrides
+ * @returns Resolved model configuration with source information
+ */
+export function getModelConfig(options = {}) {
+    return resolveModelConfig(options);
+}
+//# 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;;;;;;GAMG;AAEH,QAAQ;AACR,cAAc,YAAY,CAAC;AAE3B,gBAAgB;AAChB,OAAO,EAAE,SAAS,EAAE,WAAW,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAE5E,oCAAoC;AACpC,OAAO;AACL,uBAAuB;AACvB,kBAAkB,EAClB,eAAe,EACf,gBAAgB,EAChB,iBAAiB,EACjB,YAAY;AAEZ,kBAAkB;AAClB,qBAAqB,EACrB,iBAAiB;AAEjB,YAAY;AACZ,aAAa,EACb,gBAAgB;AAEhB,sCAAsC;AACtC,aAAa,EACb,cAAc,GAKf,MAAM,aAAa,CAAC;AAErB,kBAAkB;AAClB,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAC5C,OAAO,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AAEpD,gCAAgC;AAChC,OAAO,EACL,SAAS,EACT,eAAe,EACf,mBAAmB,EACnB,mBAAmB,EACnB,eAAe,EACf,kBAAkB,EAClB,kBAAkB,EAClB,iBAAiB,EACjB,UAAU,EACV,WAAW,EACX,WAAW,GACZ,MAAM,eAAe,CAAC;AAEvB,UAAU;AACV,OAAO,EACL,oBAAoB,EACpB,mBAAmB,EACnB,iBAAiB,EACjB,eAAe,EACf,kBAAkB,EAClB,eAAe,EACf,cAAc,EACd,eAAe,EACf,iBAAiB,EACjB,mBAAmB,GACpB,MAAM,cAAc,CAAC;AAEtB,+EAA+E;AAC/E,qEAAqE;AACrE,+EAA+E;AAE/E,OAAO,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AACpD,OAAO,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AAChD,OAAO,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAC;AACjD,OAAO,EAAE,mBAAmB,EAAE,MAAM,YAAY,CAAC;AAmCjD;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,MAAM,UAAU,cAAc,CAAC,UAAiC,EAAE;IAChE,MAAM,WAAW,GAAG,kBAAkB,CAAC;QACrC,KAAK,EAAE,OAAO,CAAC,KAAK;QACpB,aAAa,EAAE,OAAO,CAAC,aAAa;KACrC,CAAC,CAAC;IAEH,MAAM,MAAM,GAAG,mBAAmB,CAAC,WAAW,CAAC,YAAY,CAAC,CAAC;IAE7D,6BAA6B;IAC7B,IAAI,OAAO,CAAC,MAAM,EAAE,CAAC;QACnB,MAAM,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,MAAM,CAAC,CAAC;IACxC,CAAC;IAED,MAAM,YAAY,GAAG,IAAI,eAAe,CAAC,MAAM,EAAE,OAAO,CAAC,OAAO,CAAC,CAAC;IAElE,MAAM,OAAO,GAAG,KAAK,EACnB,SAAiB,EACjB,kBAAmE,EAAE,EACxC,EAAE;QAC/B,OAAO,eAAe,CAAC;YACrB,SAAS;YACT,GAAG,eAAe;YAClB,KAAK,EAAE,WAAW,CAAC,YAAY;YAC/B,OAAO,EAAE,OAAO,CAAC,OAAO;SACzB,CAAC,CAAC;IACL,CAAC,CAAC;IAEF,OAAO;QACL,OAAO;QACP,YAAY;QACZ,MAAM;QACN,WAAW;KACZ,CAAC;AACJ,CAAC;AAcD;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,MAAM,UAAU,kBAAkB,CAAC,UAAqC,EAAE;IACxE,MAAM,WAAW,GAAG,kBAAkB,CAAC,EAAE,KAAK,EAAE,OAAO,CAAC,KAAK,EAAE,CAAC,CAAC;IACjE,MAAM,MAAM,GAAG,mBAAmB,CAAC,WAAW,CAAC,YAAY,CAAC,CAAC;IAE7D,6BAA6B;IAC7B,IAAI,OAAO,CAAC,MAAM,EAAE,CAAC;QACnB,MAAM,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,MAAM,CAAC,CAAC;IACxC,CAAC;IAED,OAAO,IAAI,eAAe,CAAC,MAAM,EAAE,OAAO,CAAC,OAAO,CAAC,CAAC;AACtD,CAAC;AAED;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,MAAM,UAAU,cAAc,CAAC,UAA8B,EAAE;IAC7D,OAAO,kBAAkB,CAAC,OAAO,CAAC,CAAC;AACrC,CAAC"}

package/dist/mcp-server.d.ts

@@ -0,0 +1,19 @@
+#!/usr/bin/env node
+/**
+ * RLM Analyzer MCP Server
+ * Exposes RLM analysis capabilities via Model Context Protocol
+ *
+ * Usage with Claude Code:
+ * Add to ~/.claude/claude_desktop_config.json:
+ * {
+ *   "mcpServers": {
+ *     "rlm-analyzer": {
+ *       "command": "npx",
+ *       "args": ["rlm-analyzer-mcp"],
+ *       "env": { "GEMINI_API_KEY": "your_key" }
+ *     }
+ *   }
+ * }
+ */
+export {};
+//# sourceMappingURL=mcp-server.d.ts.map

package/dist/mcp-server.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mcp-server.d.ts","sourceRoot":"","sources":["../src/mcp-server.ts"],"names":[],"mappings":";AACA;;;;;;;;;;;;;;;GAeG"}

package/dist/mcp-server.js

@@ -0,0 +1,336 @@
+#!/usr/bin/env node
+/**
+ * RLM Analyzer MCP Server
+ * Exposes RLM analysis capabilities via Model Context Protocol
+ *
+ * Usage with Claude Code:
+ * Add to ~/.claude/claude_desktop_config.json:
+ * {
+ *   "mcpServers": {
+ *     "rlm-analyzer": {
+ *       "command": "npx",
+ *       "args": ["rlm-analyzer-mcp"],
+ *       "env": { "GEMINI_API_KEY": "your_key" }
+ *     }
+ *   }
+ * }
+ */
+import { Server } from '@modelcontextprotocol/sdk/server/index.js';
+import { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js';
+import { ListToolsRequestSchema, CallToolRequestSchema, } from '@modelcontextprotocol/sdk/types.js';
+import { analyzeCodebase, analyzeArchitecture, analyzeDependencies, analyzeSecurity, analyzeRefactoring, summarizeCodebase, askQuestion, } from './analyzer.js';
+import { resolveModelConfig, resolveModelAlias } from './models.js';
+import { hasApiKey } from './config.js';
+// Tool definitions
+const TOOLS = [
+    {
+        name: 'rlm_analyze',
+        description: 'Analyze a codebase using recursive LLM analysis. Can answer complex questions about code architecture, patterns, and implementation details by recursively examining files.',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                directory: {
+                    type: 'string',
+                    description: 'Absolute path to the directory to analyze',
+                },
+                query: {
+                    type: 'string',
+                    description: 'Question or analysis request about the codebase',
+                },
+                analysisType: {
+                    type: 'string',
+                    enum: ['architecture', 'dependencies', 'security', 'performance', 'refactor', 'summary', 'custom'],
+                    description: 'Type of analysis to perform (default: custom if query provided, summary otherwise)',
+                },
+                model: {
+                    type: 'string',
+                    description: 'Model to use: fast, smart, or full model ID (default: from environment)',
+                },
+            },
+            required: ['directory'],
+        },
+    },
+    {
+        name: 'rlm_summarize',
+        description: 'Get a comprehensive summary of a codebase including purpose, tech stack, architecture, and key components.',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                directory: {
+                    type: 'string',
+                    description: 'Absolute path to the directory to analyze',
+                },
+                model: {
+                    type: 'string',
+                    description: 'Model to use: fast, smart, or full model ID',
+                },
+            },
+            required: ['directory'],
+        },
+    },
+    {
+        name: 'rlm_architecture',
+        description: 'Analyze the architecture and structure of a codebase. Identifies patterns, layers, components, and their relationships.',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                directory: {
+                    type: 'string',
+                    description: 'Absolute path to the directory to analyze',
+                },
+                model: {
+                    type: 'string',
+                    description: 'Model to use: fast, smart, or full model ID',
+                },
+            },
+            required: ['directory'],
+        },
+    },
+    {
+        name: 'rlm_security',
+        description: 'Perform security analysis on a codebase. Identifies potential vulnerabilities, insecure patterns, and security best practice violations.',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                directory: {
+                    type: 'string',
+                    description: 'Absolute path to the directory to analyze',
+                },
+                model: {
+                    type: 'string',
+                    description: 'Model to use: fast, smart, or full model ID',
+                },
+            },
+            required: ['directory'],
+        },
+    },
+    {
+        name: 'rlm_dependencies',
+        description: 'Analyze dependencies in a codebase. Maps internal and external dependencies, identifies circular dependencies and coupling issues.',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                directory: {
+                    type: 'string',
+                    description: 'Absolute path to the directory to analyze',
+                },
+                model: {
+                    type: 'string',
+                    description: 'Model to use: fast, smart, or full model ID',
+                },
+            },
+            required: ['directory'],
+        },
+    },
+    {
+        name: 'rlm_refactor',
+        description: 'Find refactoring opportunities in a codebase. Identifies code duplication, complex functions, and improvement opportunities.',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                directory: {
+                    type: 'string',
+                    description: 'Absolute path to the directory to analyze',
+                },
+                model: {
+                    type: 'string',
+                    description: 'Model to use: fast, smart, or full model ID',
+                },
+            },
+            required: ['directory'],
+        },
+    },
+    {
+        name: 'rlm_ask',
+        description: 'Ask a specific question about a codebase. The AI will analyze relevant files to answer your question.',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                directory: {
+                    type: 'string',
+                    description: 'Absolute path to the directory to analyze',
+                },
+                question: {
+                    type: 'string',
+                    description: 'The question to answer about the codebase',
+                },
+                model: {
+                    type: 'string',
+                    description: 'Model to use: fast, smart, or full model ID',
+                },
+            },
+            required: ['directory', 'question'],
+        },
+    },
+    {
+        name: 'rlm_config',
+        description: 'Get current RLM Analyzer configuration including model settings and API key status.',
+        inputSchema: {
+            type: 'object',
+            properties: {},
+        },
+    },
+];
+// Create server
+const server = new Server({ name: 'rlm-analyzer', version: '1.1.0' }, { capabilities: { tools: {} } });
+// Handle tool listing
+server.setRequestHandler(ListToolsRequestSchema, async () => {
+    return { tools: TOOLS };
+});
+// Handle tool calls
+server.setRequestHandler(CallToolRequestSchema, async (request) => {
+    const { name, arguments: args } = request.params;
+    try {
+        // Check API key for analysis tools
+        if (name !== 'rlm_config' && !hasApiKey()) {
+            return {
+                content: [{
+                        type: 'text',
+                        text: 'Error: GEMINI_API_KEY not configured. Set it in the MCP server environment.',
+                    }],
+                isError: true,
+            };
+        }
+        const model = args?.model ? resolveModelAlias(args.model) : undefined;
+        const options = model ? { model } : {};
+        switch (name) {
+            case 'rlm_analyze': {
+                const { directory, query, analysisType } = args;
+                const result = await analyzeCodebase({
+                    directory,
+                    query,
+                    analysisType: analysisType || (query ? 'custom' : 'summary'),
+                    ...options,
+                });
+                return {
+                    content: [{
+                            type: 'text',
+                            text: result.success
+                                ? result.answer || 'Analysis complete but no answer generated.'
+                                : `Error: ${result.error}`,
+                        }],
+                    isError: !result.success,
+                };
+            }
+            case 'rlm_summarize': {
+                const { directory } = args;
+                const result = await summarizeCodebase(directory, options);
+                return {
+                    content: [{
+                            type: 'text',
+                            text: result.success
+                                ? result.answer || 'Summary complete but no content generated.'
+                                : `Error: ${result.error}`,
+                        }],
+                    isError: !result.success,
+                };
+            }
+            case 'rlm_architecture': {
+                const { directory } = args;
+                const result = await analyzeArchitecture(directory, options);
+                return {
+                    content: [{
+                            type: 'text',
+                            text: result.success
+                                ? result.answer || 'Architecture analysis complete.'
+                                : `Error: ${result.error}`,
+                        }],
+                    isError: !result.success,
+                };
+            }
+            case 'rlm_security': {
+                const { directory } = args;
+                const result = await analyzeSecurity(directory, options);
+                return {
+                    content: [{
+                            type: 'text',
+                            text: result.success
+                                ? result.answer || 'Security analysis complete.'
+                                : `Error: ${result.error}`,
+                        }],
+                    isError: !result.success,
+                };
+            }
+            case 'rlm_dependencies': {
+                const { directory } = args;
+                const result = await analyzeDependencies(directory, options);
+                return {
+                    content: [{
+                            type: 'text',
+                            text: result.success
+                                ? result.answer || 'Dependency analysis complete.'
+                                : `Error: ${result.error}`,
+                        }],
+                    isError: !result.success,
+                };
+            }
+            case 'rlm_refactor': {
+                const { directory } = args;
+                const result = await analyzeRefactoring(directory, options);
+                return {
+                    content: [{
+                            type: 'text',
+                            text: result.success
+                                ? result.answer || 'Refactoring analysis complete.'
+                                : `Error: ${result.error}`,
+                        }],
+                    isError: !result.success,
+                };
+            }
+            case 'rlm_ask': {
+                const { directory, question } = args;
+                const result = await askQuestion(directory, question, options);
+                return {
+                    content: [{
+                            type: 'text',
+                            text: result.success
+                                ? result.answer || 'Question answered but no content generated.'
+                                : `Error: ${result.error}`,
+                        }],
+                    isError: !result.success,
+                };
+            }
+            case 'rlm_config': {
+                const config = resolveModelConfig();
+                const apiKeyStatus = hasApiKey() ? 'configured' : 'NOT CONFIGURED';
+                return {
+                    content: [{
+                            type: 'text',
+                            text: `RLM Analyzer Configuration:
+- API Key: ${apiKeyStatus}
+- Default Model: ${config.defaultModel} (source: ${config.defaultSource})
+- Fallback Model: ${config.fallbackModel} (source: ${config.fallbackSource})
+
+Model Aliases:
+- fast → gemini-3-flash-preview
+- smart → gemini-3-pro-preview
+- pro → gemini-3-pro-preview`,
+                        }],
+                };
+            }
+            default:
+                return {
+                    content: [{ type: 'text', text: `Unknown tool: ${name}` }],
+                    isError: true,
+                };
+        }
+    }
+    catch (error) {
+        const message = error instanceof Error ? error.message : String(error);
+        return {
+            content: [{ type: 'text', text: `Error: ${message}` }],
+            isError: true,
+        };
+    }
+});
+// Start server
+async function main() {
+    const transport = new StdioServerTransport();
+    await server.connect(transport);
+    console.error('RLM Analyzer MCP server running on stdio');
+}
+main().catch((error) => {
+    console.error('Failed to start MCP server:', error);
+    process.exit(1);
+});
+//# sourceMappingURL=mcp-server.js.map

package/dist/mcp-server.js.map

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

package/dist/models.d.ts

@@ -0,0 +1,101 @@
+/**
+ * Model Configuration Module
+ * Handles model resolution with configurable priority chain
+ *
+ * Priority chain for model resolution:
+ * 1. CLI --model flag (highest)
+ * 2. Environment variables: RLM_DEFAULT_MODEL, RLM_FALLBACK_MODEL
+ * 3. Config file: ~/.rlm-analyzer/config.json
+ * 4. Programmatic API: createAnalyzer({ model: '...' })
+ * 5. Built-in defaults (lowest, internal only)
+ */
+/**
+ * Model aliases for convenience
+ * Users can specify aliases instead of full model IDs
+ */
+export declare const MODEL_ALIASES: Record<string, string>;
+/**
+ * Available model options (for display in help)
+ */
+export declare const AVAILABLE_MODELS: {
+    id: string;
+    description: string;
+}[];
+export interface ModelConfigOptions {
+    /** Model specified via CLI flag or programmatic API */
+    model?: string;
+    /** Fallback model specified via CLI flag or programmatic API */
+    fallbackModel?: string;
+}
+export interface ResolvedModelConfig {
+    /** The resolved default model ID */
+    defaultModel: string;
+    /** The resolved fallback model ID */
+    fallbackModel: string;
+    /** Source of the default model resolution */
+    defaultSource: 'cli' | 'env' | 'config' | 'api' | 'builtin';
+    /** Source of the fallback model resolution */
+    fallbackSource: 'cli' | 'env' | 'config' | 'api' | 'builtin';
+}
+/**
+ * Resolve a model alias to its full model ID
+ * If the input is not an alias, returns it unchanged
+ *
+ * @param modelOrAlias - Model ID or alias
+ * @returns Full model ID
+ */
+export declare function resolveModelAlias(modelOrAlias: string): string;
+/**
+ * Check if a string is a known model alias
+ */
+export declare function isModelAlias(value: string): boolean;
+/**
+ * Resolve full model configuration using priority chain
+ *
+ * Priority:
+ * 1. CLI/API options (highest)
+ * 2. Environment variables: RLM_DEFAULT_MODEL, RLM_FALLBACK_MODEL
+ * 3. Config file: ~/.rlm-analyzer/config.json
+ * 4. Built-in defaults (lowest)
+ *
+ * @param options - Optional overrides from CLI or programmatic API
+ * @returns Resolved model configuration with source information
+ */
+export declare function resolveModelConfig(options?: ModelConfigOptions): ResolvedModelConfig;
+/**
+ * Get the default model ID using the priority chain
+ * Convenience function for getting just the default model
+ *
+ * @param options - Optional overrides
+ * @returns Resolved default model ID
+ */
+export declare function getDefaultModel(options?: ModelConfigOptions): string;
+/**
+ * Get the fallback model ID using the priority chain
+ * Convenience function for getting just the fallback model
+ *
+ * @param options - Optional overrides
+ * @returns Resolved fallback model ID
+ */
+export declare function getFallbackModel(options?: ModelConfigOptions): string;
+/**
+ * @deprecated Use `getDefaultModel()` instead for dynamic resolution
+ * This is computed at import time and won't reflect runtime changes
+ */
+export declare const DEFAULT_MODEL: string;
+/**
+ * @deprecated Use `getFallbackModel()` instead for dynamic resolution
+ * This is computed at import time and won't reflect runtime changes
+ */
+export declare const FALLBACK_MODEL: string;
+/**
+ * Get formatted string showing current model configuration
+ * Useful for CLI help text and debugging
+ */
+export declare function getModelConfigDisplay(options?: ModelConfigOptions): string;
+/**
+ * Get formatted string showing available aliases
+ * Useful for CLI help text
+ */
+export declare function getAliasesDisplay(): string;
+//# sourceMappingURL=models.d.ts.map

package/dist/models.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"models.d.ts","sourceRoot":"","sources":["../src/models.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAiBH;;;GAGG;AACH,eAAO,MAAM,aAAa,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAQhD,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,gBAAgB;;;GAK5B,CAAC;AAMF,MAAM,WAAW,kBAAkB;IACjC,uDAAuD;IACvD,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,gEAAgE;IAChE,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB;AAED,MAAM,WAAW,mBAAmB;IAClC,oCAAoC;IACpC,YAAY,EAAE,MAAM,CAAC;IACrB,qCAAqC;IACrC,aAAa,EAAE,MAAM,CAAC;IACtB,6CAA6C;IAC7C,aAAa,EAAE,KAAK,GAAG,KAAK,GAAG,QAAQ,GAAG,KAAK,GAAG,SAAS,CAAC;IAC5D,8CAA8C;IAC9C,cAAc,EAAE,KAAK,GAAG,KAAK,GAAG,QAAQ,GAAG,KAAK,GAAG,SAAS,CAAC;CAC9D;AAwCD;;;;;;GAMG;AACH,wBAAgB,iBAAiB,CAAC,YAAY,EAAE,MAAM,GAAG,MAAM,CAG9D;AAED;;GAEG;AACH,wBAAgB,YAAY,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAEnD;AAMD;;;;;;;;;;;GAWG;AACH,wBAAgB,kBAAkB,CAAC,OAAO,GAAE,kBAAuB,GAAG,mBAAmB,CAmDxF;AAED;;;;;;GAMG;AACH,wBAAgB,eAAe,CAAC,OAAO,GAAE,kBAAuB,GAAG,MAAM,CAExE;AAED;;;;;;GAMG;AACH,wBAAgB,gBAAgB,CAAC,OAAO,GAAE,kBAAuB,GAAG,MAAM,CAEzE;AAMD;;;GAGG;AACH,eAAO,MAAM,aAAa,QAAoB,CAAC;AAE/C;;;GAGG;AACH,eAAO,MAAM,cAAc,QAAqB,CAAC;AAMjD;;;GAGG;AACH,wBAAgB,qBAAqB,CAAC,OAAO,GAAE,kBAAuB,GAAG,MAAM,CAO9E;AAED;;;GAGG;AACH,wBAAgB,iBAAiB,IAAI,MAAM,CAK1C"}