codereview-aia 0.1.3 → 0.2.0

package/dist/clients/utils/tokenCounter.js

@@ -0,0 +1,184 @@
+"use strict";
+/**
+ * @fileoverview Token counting and cost estimation utilities for AI API usage.
+ *
+ * This module provides utilities for estimating token usage and associated costs
+ * when using OpenRouter models. It implements accurate token counting using
+ * model-specific tokenizers and maintains current pricing information for OpenRouter models.
+ *
+ * Key responsibilities:
+ * - Counting tokens for input and output text using model-specific tokenizers
+ * - Calculating approximate API costs based on token usage and model
+ * - Tracking different pricing tiers for various AI models
+ * - Providing cost information for review outputs
+ * - Supporting cost-aware decision making for API usage
+ *
+ * These utilities help users understand the resource usage and costs associated
+ * with their code reviews, enabling better planning and resource allocation.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.estimateTokenCount = estimateTokenCount;
+exports.calculateCost = calculateCost;
+exports.formatCost = formatCost;
+exports.getCostInfoFromText = getCostInfoFromText;
+exports.getCostInfo = getCostInfo;
+const tokenizers_1 = require("../../tokenizers");
+/**
+ * Utility functions for estimating token counts and costs for AI API calls
+ */
+/**
+ * Count tokens in a text using the appropriate tokenizer for a model
+ * @param text Text to count tokens for
+ * @param modelName Name of the model (optional)
+ * @returns Token count
+ */
+function estimateTokenCount(text, modelName) {
+    return (0, tokenizers_1.countTokens)(text, modelName || 'fallback');
+}
+/**
+ * Pricing information for OpenRouter models
+ */
+const MODEL_PRICING = {
+    // Retained models
+    'x-ai/grok-4-fast': {
+        type: 'standard',
+        inputTokenCost: 0.0002, // $0.20 per 1M input tokens (approx)
+        outputTokenCost: 0.0005, // $0.50 per 1M output tokens (approx)
+    },
+    'moonshotai/kimi-k2-thinking': {
+        type: 'standard',
+        inputTokenCost: 0.00045, // $0.45 per 1M input tokens
+        outputTokenCost: 0.00235, // $2.35 per 1M output tokens
+    },
+    'kimi-k2-thinking': {
+        type: 'standard',
+        inputTokenCost: 0.00045, // $0.45 per 1M input tokens
+        outputTokenCost: 0.00235, // $2.35 per 1M output tokens
+    },
+    // Default fallback pricing (OpenRouter average)
+    default: {
+        type: 'standard',
+        inputTokenCost: 0.005, // $5.00 per 1M tokens
+        outputTokenCost: 0.015, // $15.00 per 1M tokens
+    },
+};
+/**
+ * Get the pricing for a specific model
+ * @param modelName Name of the model
+ * @returns Pricing information for the model
+ */
+function getModelPricing(modelName) {
+    // Handle OpenRouter model names (remove the 'openrouter:' prefix)
+    let actualModelName = modelName;
+    if (modelName.startsWith('openrouter:')) {
+        actualModelName = modelName.substring('openrouter:'.length);
+    }
+    else if (modelName.startsWith('openrouter-')) {
+        actualModelName = modelName.substring('openrouter-'.length);
+    }
+    // Check if we have pricing for this model
+    if (MODEL_PRICING[actualModelName]) {
+        return MODEL_PRICING[actualModelName];
+    }
+    // Default fallback
+    return MODEL_PRICING.default;
+}
+/**
+ * Calculate the cost for a specific tier
+ * @param tokens Number of tokens
+ * @param tokenCost Cost per 1K tokens
+ * @param tierStart Start of the tier
+ * @param tierEnd End of the tier (or undefined for no upper limit)
+ * @returns Cost for this tier
+ */
+function calculateTierCost(tokens, tokenCost, tierStart, tierEnd) {
+    // Calculate how many tokens fall within this tier
+    const tierTokens = tierEnd
+        ? Math.min(Math.max(0, tokens - tierStart), tierEnd - tierStart)
+        : Math.max(0, tokens - tierStart);
+    // Calculate the cost for this tier
+    return (tierTokens / 1000) * tokenCost;
+}
+/**
+ * Calculate the estimated cost for an AI API call
+ * @param inputTokens Number of input tokens
+ * @param outputTokens Number of output tokens
+ * @param modelName Name of the model used
+ * @returns Estimated cost in USD
+ */
+function calculateCost(inputTokens, outputTokens, modelName = 'openrouter:anthropic/claude-3-opus-20240229') {
+    const pricing = getModelPricing(modelName);
+    let inputCost = 0;
+    let outputCost = 0;
+    if (pricing.type === 'standard') {
+        // Standard pricing is simple - just multiply by the cost per token
+        inputCost = (inputTokens / 1000) * pricing.inputTokenCost;
+        outputCost = (outputTokens / 1000) * pricing.outputTokenCost;
+    }
+    else if (pricing.type === 'tiered') {
+        // Tiered pricing requires calculating costs for each tier
+        const tiers = pricing.tiers;
+        // Calculate input token cost across tiers
+        for (let i = 0; i < tiers.length; i++) {
+            const tierStart = tiers[i].threshold;
+            const tierEnd = i < tiers.length - 1 ? tiers[i + 1].threshold : undefined;
+            inputCost += calculateTierCost(inputTokens, tiers[i].inputTokenCost, tierStart, tierEnd);
+        }
+        // Calculate output token cost across tiers
+        for (let i = 0; i < tiers.length; i++) {
+            const tierStart = tiers[i].threshold;
+            const tierEnd = i < tiers.length - 1 ? tiers[i + 1].threshold : undefined;
+            outputCost += calculateTierCost(outputTokens, tiers[i].outputTokenCost, tierStart, tierEnd);
+        }
+    }
+    return inputCost + outputCost;
+}
+/**
+ * Format a cost value as a currency string
+ * @param cost Cost value in USD
+ * @returns Formatted cost string
+ */
+function formatCost(cost) {
+    return `$${cost.toFixed(6)} USD`;
+}
+/**
+ * Calculate cost information for an API call based on text
+ * @param inputText Input text sent to the API
+ * @param outputText Output text received from the API
+ * @param modelName Name of the model used
+ * @returns Cost information
+ */
+function getCostInfoFromText(inputText, outputText, modelName = 'openrouter:anthropic/claude-3-opus-20240229') {
+    const inputTokens = estimateTokenCount(inputText, modelName);
+    const outputTokens = estimateTokenCount(outputText, modelName);
+    const totalTokens = inputTokens + outputTokens;
+    const estimatedCost = calculateCost(inputTokens, outputTokens, modelName);
+    return {
+        inputTokens,
+        outputTokens,
+        totalTokens,
+        estimatedCost,
+        formattedCost: formatCost(estimatedCost),
+        cost: estimatedCost, // Alias for backward compatibility
+    };
+}
+/**
+ * Calculate cost information for an API call based on token counts
+ * @param inputTokens Number of input tokens
+ * @param outputTokens Number of output tokens
+ * @param modelName Name of the model used
+ * @returns Cost information
+ */
+function getCostInfo(inputTokens, outputTokens, modelName = 'openrouter:anthropic/claude-3-opus-20240229') {
+    const totalTokens = inputTokens + outputTokens;
+    const estimatedCost = calculateCost(inputTokens, outputTokens, modelName);
+    return {
+        inputTokens,
+        outputTokens,
+        totalTokens,
+        estimatedCost,
+        formattedCost: formatCost(estimatedCost),
+        cost: estimatedCost, // Alias for backward compatibility
+    };
+}
+//# sourceMappingURL=tokenCounter.js.map

package/dist/clients/utils/tokenCounter.js.map

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

package/dist/core/ApiClientSelector.d.ts

@@ -0,0 +1,8 @@
+export type ApiClientType = 'OpenRouter';
+export interface ApiClientConfig {
+    clientType: ApiClientType;
+    modelName: string;
+    initialized: boolean;
+    provider: 'openrouter';
+}
+export declare function selectApiClient(cliOptions?: any): Promise<ApiClientConfig>;

package/dist/core/ApiClientSelector.js

@@ -0,0 +1,29 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.selectApiClient = selectApiClient;
+const logger_1 = __importDefault(require("../utils/logger"));
+const ConfigurationService_1 = require("../core/ConfigurationService");
+const openRouterClientWrapper_1 = require("../clients/openRouterClientWrapper");
+async function selectApiClient(cliOptions) {
+    logger_1.default.debug('selectApiClient called');
+    // Get model from ConfigurationService or CLI options
+    const config = (0, ConfigurationService_1.getConfig)(cliOptions);
+    const requestedModel = cliOptions?.model || config.model || '';
+    const normalized = requestedModel.replace(/['"`]/g, '').trim();
+    const [, modelName] = normalized.includes(':') ? normalized.split(':', 2) : ['openrouter', normalized];
+    if (!modelName) {
+        throw new Error('AI_CODE_REVIEW_MODEL must specify an OpenRouter-compatible model.');
+    }
+    await (0, openRouterClientWrapper_1.initializeAnyOpenRouterModel)();
+    logger_1.default.info(`Using OpenRouter model: ${modelName}`);
+    return {
+        clientType: 'OpenRouter',
+        modelName: `openrouter:${modelName}`,
+        initialized: true,
+        provider: 'openrouter',
+    };
+}
+//# sourceMappingURL=ApiClientSelector.js.map

package/dist/core/ApiClientSelector.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ApiClientSelector.js","sourceRoot":"","sources":["../../src/core/ApiClientSelector.ts"],"names":[],"mappings":";;;;;AAaA,0CAuBC;AApCD,6DAAqC;AACrC,uEAAyD;AACzD,gFAAkF;AAW3E,KAAK,UAAU,eAAe,CAAC,UAAgB;IACpD,gBAAM,CAAC,KAAK,CAAC,wBAAwB,CAAC,CAAC;IAEvC,qDAAqD;IACrD,MAAM,MAAM,GAAG,IAAA,gCAAS,EAAC,UAAU,CAAC,CAAC;IACrC,MAAM,cAAc,GAAG,UAAU,EAAE,KAAK,IAAI,MAAM,CAAC,KAAK,IAAI,EAAE,CAAC;IAC/D,MAAM,UAAU,GAAG,cAAc,CAAC,OAAO,CAAC,QAAQ,EAAE,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC;IAC/D,MAAM,CAAC,EAAE,SAAS,CAAC,GAAG,UAAU,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,UAAU,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,YAAY,EAAE,UAAU,CAAC,CAAC;IAEvG,IAAI,CAAC,SAAS,EAAE,CAAC;QACf,MAAM,IAAI,KAAK,CAAC,mEAAmE,CAAC,CAAC;IACvF,CAAC;IAED,MAAM,IAAA,sDAA4B,GAAE,CAAC;IAErC,gBAAM,CAAC,IAAI,CAAC,2BAA2B,SAAS,EAAE,CAAC,CAAC;IAEpD,OAAO;QACL,UAAU,EAAE,YAAY;QACxB,SAAS,EAAE,cAAc,SAAS,EAAE;QACpC,WAAW,EAAE,IAAI;QACjB,QAAQ,EAAE,YAAY;KACvB,CAAC;AACJ,CAAC"}

package/dist/core/ConfigurationService.d.ts

@@ -0,0 +1,307 @@
+/**
+ * @fileoverview Unified Configuration Service
+ *
+ * This service consolidates all configuration management into a single, cohesive module.
+ * It replaces the fragmented configuration files (config.ts, configFileManager.ts,
+ * configManager.ts, unifiedConfig.ts, codingTestConfigLoader.ts, envLoader.ts) with
+ * a single source of truth for configuration.
+ *
+ * Key features:
+ * - Single source of truth for all configuration
+ * - Clear precedence order: CLI > Environment > Config File > Defaults
+ * - Type-safe configuration with Zod validation
+ * - Support for YAML and JSON config files
+ * - Environment variable loading with .env.local support
+ * - Comprehensive error handling and validation
+ */
+import { z } from 'zod';
+import type { CliOptions } from '../types/cli';
+declare const ConfigSchema: z.ZodObject<{
+    openRouterApiKey: z.ZodOptional<z.ZodString>;
+    model: z.ZodDefault<z.ZodString>;
+    writerModel: z.ZodOptional<z.ZodString>;
+    outputDir: z.ZodDefault<z.ZodString>;
+    outputFormat: z.ZodDefault<z.ZodEnum<["markdown", "json"]>>;
+    debug: z.ZodDefault<z.ZodBoolean>;
+    logLevel: z.ZodDefault<z.ZodEnum<["debug", "info", "warn", "error", "none"]>>;
+    interactive: z.ZodDefault<z.ZodBoolean>;
+    includeTests: z.ZodDefault<z.ZodBoolean>;
+    includeProjectDocs: z.ZodDefault<z.ZodBoolean>;
+    includeDependencyAnalysis: z.ZodDefault<z.ZodBoolean>;
+    multiPass: z.ZodDefault<z.ZodBoolean>;
+    forceSinglePass: z.ZodDefault<z.ZodBoolean>;
+    contextMaintenanceFactor: z.ZodDefault<z.ZodNumber>;
+    testApi: z.ZodDefault<z.ZodBoolean>;
+    estimate: z.ZodDefault<z.ZodBoolean>;
+    noConfirm: z.ZodDefault<z.ZodBoolean>;
+    contextPaths: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+    configPath: z.ZodOptional<z.ZodString>;
+    assignmentFile: z.ZodOptional<z.ZodString>;
+    assignmentUrl: z.ZodOptional<z.ZodString>;
+    assignmentText: z.ZodOptional<z.ZodString>;
+    evaluationTemplate: z.ZodOptional<z.ZodString>;
+    templateUrl: z.ZodOptional<z.ZodString>;
+    rubricFile: z.ZodOptional<z.ZodString>;
+    assessmentType: z.ZodDefault<z.ZodEnum<["coding-challenge", "take-home", "live-coding", "code-review"]>>;
+    difficultyLevel: z.ZodDefault<z.ZodEnum<["junior", "mid", "senior", "lead", "architect"]>>;
+    weightCorrectness: z.ZodDefault<z.ZodNumber>;
+    weightCodeQuality: z.ZodDefault<z.ZodNumber>;
+    weightArchitecture: z.ZodDefault<z.ZodNumber>;
+    weightPerformance: z.ZodDefault<z.ZodNumber>;
+    weightTesting: z.ZodDefault<z.ZodNumber>;
+    evaluateDocumentation: z.ZodDefault<z.ZodBoolean>;
+    evaluateGitHistory: z.ZodDefault<z.ZodBoolean>;
+    evaluateEdgeCases: z.ZodDefault<z.ZodBoolean>;
+    evaluateErrorHandling: z.ZodDefault<z.ZodBoolean>;
+    scoringSystem: z.ZodDefault<z.ZodEnum<["numeric", "letter", "pass-fail", "custom"]>>;
+    maxScore: z.ZodDefault<z.ZodNumber>;
+    passingThreshold: z.ZodDefault<z.ZodNumber>;
+    scoreBreakdown: z.ZodDefault<z.ZodBoolean>;
+    feedbackLevel: z.ZodDefault<z.ZodEnum<["basic", "detailed", "comprehensive"]>>;
+    includeExamples: z.ZodDefault<z.ZodBoolean>;
+    includeSuggestions: z.ZodDefault<z.ZodBoolean>;
+    includeResources: z.ZodDefault<z.ZodBoolean>;
+    enableAiDetection: z.ZodDefault<z.ZodBoolean>;
+    aiDetectionThreshold: z.ZodDefault<z.ZodNumber>;
+    aiDetectionAnalyzers: z.ZodDefault<z.ZodString>;
+    aiDetectionIncludeInReport: z.ZodDefault<z.ZodBoolean>;
+    aiDetectionFailOnDetection: z.ZodDefault<z.ZodBoolean>;
+    allowedLibraries: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+    forbiddenPatterns: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+    nodeVersion: z.ZodOptional<z.ZodString>;
+    typescriptVersion: z.ZodOptional<z.ZodString>;
+    memoryLimit: z.ZodOptional<z.ZodNumber>;
+    executionTimeout: z.ZodOptional<z.ZodNumber>;
+    timeLimit: z.ZodOptional<z.ZodNumber>;
+    diagram: z.ZodDefault<z.ZodBoolean>;
+    batchTokenLimit: z.ZodOptional<z.ZodNumber>;
+    wordpressAutoDetect: z.ZodDefault<z.ZodBoolean>;
+    wordpressForceEnable: z.ZodDefault<z.ZodBoolean>;
+    wordpressForceDisable: z.ZodDefault<z.ZodBoolean>;
+    wordpressPhpcsEnabled: z.ZodDefault<z.ZodBoolean>;
+    wordpressPhpcsPath: z.ZodOptional<z.ZodString>;
+    wordpressPhpcsStandard: z.ZodOptional<z.ZodString>;
+    wordpressPhpcsTestVersion: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    debug: boolean;
+    model: string;
+    outputDir: string;
+    outputFormat: "json" | "markdown";
+    logLevel: "debug" | "info" | "warn" | "error" | "none";
+    interactive: boolean;
+    includeTests: boolean;
+    includeProjectDocs: boolean;
+    includeDependencyAnalysis: boolean;
+    multiPass: boolean;
+    forceSinglePass: boolean;
+    contextMaintenanceFactor: number;
+    testApi: boolean;
+    estimate: boolean;
+    noConfirm: boolean;
+    assessmentType: "coding-challenge" | "take-home" | "live-coding" | "code-review";
+    difficultyLevel: "junior" | "mid" | "senior" | "lead" | "architect";
+    weightCorrectness: number;
+    weightCodeQuality: number;
+    weightArchitecture: number;
+    weightPerformance: number;
+    weightTesting: number;
+    evaluateDocumentation: boolean;
+    evaluateGitHistory: boolean;
+    evaluateEdgeCases: boolean;
+    evaluateErrorHandling: boolean;
+    scoringSystem: "numeric" | "letter" | "pass-fail" | "custom";
+    maxScore: number;
+    passingThreshold: number;
+    scoreBreakdown: boolean;
+    feedbackLevel: "comprehensive" | "basic" | "detailed";
+    includeExamples: boolean;
+    includeSuggestions: boolean;
+    includeResources: boolean;
+    enableAiDetection: boolean;
+    aiDetectionThreshold: number;
+    aiDetectionAnalyzers: string;
+    aiDetectionIncludeInReport: boolean;
+    aiDetectionFailOnDetection: boolean;
+    diagram: boolean;
+    wordpressAutoDetect: boolean;
+    wordpressForceEnable: boolean;
+    wordpressForceDisable: boolean;
+    wordpressPhpcsEnabled: boolean;
+    openRouterApiKey?: string | undefined;
+    writerModel?: string | undefined;
+    contextPaths?: string[] | undefined;
+    configPath?: string | undefined;
+    assignmentFile?: string | undefined;
+    assignmentUrl?: string | undefined;
+    assignmentText?: string | undefined;
+    evaluationTemplate?: string | undefined;
+    templateUrl?: string | undefined;
+    rubricFile?: string | undefined;
+    allowedLibraries?: string[] | undefined;
+    forbiddenPatterns?: string[] | undefined;
+    nodeVersion?: string | undefined;
+    typescriptVersion?: string | undefined;
+    memoryLimit?: number | undefined;
+    executionTimeout?: number | undefined;
+    timeLimit?: number | undefined;
+    batchTokenLimit?: number | undefined;
+    wordpressPhpcsPath?: string | undefined;
+    wordpressPhpcsStandard?: string | undefined;
+    wordpressPhpcsTestVersion?: string | undefined;
+}, {
+    debug?: boolean | undefined;
+    openRouterApiKey?: string | undefined;
+    model?: string | undefined;
+    writerModel?: string | undefined;
+    outputDir?: string | undefined;
+    outputFormat?: "json" | "markdown" | undefined;
+    logLevel?: "debug" | "info" | "warn" | "error" | "none" | undefined;
+    interactive?: boolean | undefined;
+    includeTests?: boolean | undefined;
+    includeProjectDocs?: boolean | undefined;
+    includeDependencyAnalysis?: boolean | undefined;
+    multiPass?: boolean | undefined;
+    forceSinglePass?: boolean | undefined;
+    contextMaintenanceFactor?: number | undefined;
+    testApi?: boolean | undefined;
+    estimate?: boolean | undefined;
+    noConfirm?: boolean | undefined;
+    contextPaths?: string[] | undefined;
+    configPath?: string | undefined;
+    assignmentFile?: string | undefined;
+    assignmentUrl?: string | undefined;
+    assignmentText?: string | undefined;
+    evaluationTemplate?: string | undefined;
+    templateUrl?: string | undefined;
+    rubricFile?: string | undefined;
+    assessmentType?: "coding-challenge" | "take-home" | "live-coding" | "code-review" | undefined;
+    difficultyLevel?: "junior" | "mid" | "senior" | "lead" | "architect" | undefined;
+    weightCorrectness?: number | undefined;
+    weightCodeQuality?: number | undefined;
+    weightArchitecture?: number | undefined;
+    weightPerformance?: number | undefined;
+    weightTesting?: number | undefined;
+    evaluateDocumentation?: boolean | undefined;
+    evaluateGitHistory?: boolean | undefined;
+    evaluateEdgeCases?: boolean | undefined;
+    evaluateErrorHandling?: boolean | undefined;
+    scoringSystem?: "numeric" | "letter" | "pass-fail" | "custom" | undefined;
+    maxScore?: number | undefined;
+    passingThreshold?: number | undefined;
+    scoreBreakdown?: boolean | undefined;
+    feedbackLevel?: "comprehensive" | "basic" | "detailed" | undefined;
+    includeExamples?: boolean | undefined;
+    includeSuggestions?: boolean | undefined;
+    includeResources?: boolean | undefined;
+    enableAiDetection?: boolean | undefined;
+    aiDetectionThreshold?: number | undefined;
+    aiDetectionAnalyzers?: string | undefined;
+    aiDetectionIncludeInReport?: boolean | undefined;
+    aiDetectionFailOnDetection?: boolean | undefined;
+    allowedLibraries?: string[] | undefined;
+    forbiddenPatterns?: string[] | undefined;
+    nodeVersion?: string | undefined;
+    typescriptVersion?: string | undefined;
+    memoryLimit?: number | undefined;
+    executionTimeout?: number | undefined;
+    timeLimit?: number | undefined;
+    diagram?: boolean | undefined;
+    batchTokenLimit?: number | undefined;
+    wordpressAutoDetect?: boolean | undefined;
+    wordpressForceEnable?: boolean | undefined;
+    wordpressForceDisable?: boolean | undefined;
+    wordpressPhpcsEnabled?: boolean | undefined;
+    wordpressPhpcsPath?: string | undefined;
+    wordpressPhpcsStandard?: string | undefined;
+    wordpressPhpcsTestVersion?: string | undefined;
+}>;
+export type Config = z.infer<typeof ConfigSchema>;
+/**
+ * Unified Configuration Service
+ *
+ * This class provides a single source of truth for all configuration management.
+ * It handles loading from CLI arguments, environment variables, and config files
+ * with a clear precedence order.
+ */
+export declare class ConfigurationService {
+    private static instance;
+    private config;
+    private constructor();
+    /**
+     * Get the singleton instance of the configuration service
+     */
+    static getInstance(): ConfigurationService;
+    /**
+     * Get the current configuration
+     * @param cliOptions Optional CLI options to override configuration
+     * @returns The validated configuration object
+     */
+    getConfig(cliOptions?: CliOptions): Config;
+    /**
+     * Reset the configuration (useful for testing)
+     */
+    resetConfig(): void;
+    /**
+     * Check if any API key is available
+     */
+    hasAnyApiKey(config?: Config): boolean;
+    /**
+     * Get paths configuration
+     */
+    getPathsConfig(): {
+        outputDir: string;
+        promptsDir: string;
+        templatesDir: string;
+        contextPaths?: string[];
+    };
+    /**
+     * Get application config (for backward compatibility)
+     */
+    getApplicationConfig(): {
+        selectedModel: {
+            value: string;
+            source: string;
+        };
+        openRouterApiKey?: {
+            value: string;
+            source: string;
+        };
+        debug: {
+            value: boolean;
+            source: string;
+        };
+        logLevel: {
+            value: string;
+            source: string;
+        };
+        outputDir: {
+            value: string;
+            source: string;
+        };
+    };
+    /**
+     * Build the configuration from all sources with proper precedence
+     */
+    private buildConfiguration;
+    /**
+     * Load environment variables from .env.local file
+     */
+    private loadEnvironmentVariables;
+    /**
+     * Load configuration file (YAML or JSON)
+     */
+    private loadConfigFile;
+    /**
+     * Merge configuration from all sources with proper precedence
+     */
+    private mergeConfigurationSources;
+    /**
+     * Get API key from environment variables (OpenRouter only)
+     */
+    private getApiKey;
+}
+export declare const configurationService: ConfigurationService;
+export declare function getConfig(cliOptions?: CliOptions): Config;
+export declare function resetConfig(): void;
+export declare function hasAnyApiKey(config?: Config): boolean;
+export {};