forgeagent 3.0.0-alpha.12

package/dist/config/capability-aware-token-budget.js

@@ -0,0 +1,125 @@
+/**
+ * Capability-Aware Token Budget
+ *
+ * Provides token budget resolution based on model capabilities
+ * instead of hardcoded model names.
+ */
+import { CapabilityRegistry, DEFAULT_CAPABILITIES } from '../core/ai/registry/capability-registry.js';
+import { CONTEXT_LAYER_NAMES } from '../execution/atomic/stage-context-profiles.js';
+/**
+ * Multipliers for different reasoning tiers
+ */
+const REASONING_TIER_RESPONSE_MULTIPLIER = {
+    'basic': 0.5,
+    'intermediate': 0.75,
+    'advanced': 1.0,
+    'expert': 1.25,
+    'state-of-art': 1.5,
+};
+/**
+ * Resolves token budgets from model capabilities
+ */
+export class CapabilityAwareTokenBudget {
+    registry;
+    constructor(registry) {
+        this.registry = registry || new CapabilityRegistry();
+    }
+    /**
+     * Resolve token budget for a model
+     * Uses capability registry instead of hardcoded model names
+     */
+    resolveTokenBudget(modelId) {
+        const capabilities = this.registry.getCapabilities(modelId);
+        return this.buildBudgetFromCapabilities(capabilities);
+    }
+    /**
+     * Resolve token budget from raw capabilities
+     */
+    resolveFromCapabilities(capabilities) {
+        return this.buildBudgetFromCapabilities(capabilities);
+    }
+    /**
+     * Build token budget from model capabilities
+     */
+    buildBudgetFromCapabilities(capabilities) {
+        const maxContext = capabilities.maxContextTokens || DEFAULT_CAPABILITIES.maxContextTokens;
+        const maxOutput = capabilities.maxOutputTokens || DEFAULT_CAPABILITIES.maxOutputTokens;
+        // Calculate response tokens based on reasoning tier
+        const tierMultiplier = REASONING_TIER_RESPONSE_MULTIPLIER[capabilities.reasoningTier] || 1.0;
+        const baseResponseTokens = Math.min(maxOutput, Math.floor(maxContext * 0.25));
+        const adjustedResponseTokens = Math.floor(baseResponseTokens * tierMultiplier);
+        // Reserved tokens for system prompts and context
+        const reservedTokens = Math.floor(maxContext * 0.1);
+        // Minimum context needed for a meaningful task
+        const minContextForTask = Math.max(2048, Math.floor(maxContext * 0.05));
+        return {
+            maxContextTokens: maxContext,
+            maxResponseTokens: Math.min(adjustedResponseTokens, maxOutput),
+            reservedTokens,
+            minContextForTask,
+        };
+    }
+    /**
+     * Check if a model can handle a given token requirement
+     */
+    canHandleTokens(modelId, requiredTokens) {
+        const budget = this.resolveTokenBudget(modelId);
+        return budget.maxContextTokens >= requiredTokens;
+    }
+    /**
+     * Find models that can handle a given token requirement
+     */
+    findModelsForTokens(requiredTokens) {
+        const allModels = this.registry.getAllKnownModels();
+        return allModels.filter(modelId => this.canHandleTokens(modelId, requiredTokens));
+    }
+    /**
+     * Get available context after reservations
+     */
+    getAvailableContext(modelId) {
+        const budget = this.resolveTokenBudget(modelId);
+        return budget.maxContextTokens - budget.reservedTokens - budget.maxResponseTokens;
+    }
+    /**
+     * Partition the available input context between layers based on a stage profile.
+     *
+     * Logic:
+     * 1. Calculate availableInput = maxContext - reserved - response budget
+     * 2. If profile's totalInputBudget fits within availableInput, use profile budgets as-is
+     * 3. If not, scale all layer budgets proportionally
+     * 4. Layers with include=false get 0 budget
+     *
+     * @param modelId - Model to resolve budget for
+     * @param profile - Stage context profile defining layer budgets
+     * @returns Per-layer budget allocation
+     */
+    partitionInputBudget(modelId, profile) {
+        const resolved = this.resolveTokenBudget(modelId);
+        const availableInput = resolved.maxContextTokens - resolved.reservedTokens - resolved.maxResponseTokens;
+        let wasScaled = false;
+        const budgets = {};
+        if (profile.totalInputBudget <= availableInput) {
+            // Profile fits — use configured budgets directly
+            for (const layerName of CONTEXT_LAYER_NAMES) {
+                const layerConfig = profile.layers[layerName];
+                budgets[layerName] = layerConfig.include ? (layerConfig.maxTokens ?? 0) : 0;
+            }
+        }
+        else {
+            // Scale proportionally
+            wasScaled = true;
+            const scaleFactor = availableInput / profile.totalInputBudget;
+            for (const layerName of CONTEXT_LAYER_NAMES) {
+                const layerConfig = profile.layers[layerName];
+                if (!layerConfig.include) {
+                    budgets[layerName] = 0;
+                }
+                else {
+                    budgets[layerName] = Math.round((layerConfig.maxTokens ?? 0) * scaleFactor);
+                }
+            }
+        }
+        return { budgets, totalAvailable: availableInput, wasScaled };
+    }
+}
+//# sourceMappingURL=capability-aware-token-budget.js.map

package/dist/config/capability-aware-token-budget.js.map

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

package/dist/config/complexity-scorer.d.ts

@@ -0,0 +1,33 @@
+/**
+ * Complexity Scorer Utility
+ * Calculates task complexity and selects appropriate thinking modes
+ */
+import type { ComplexityLevel, ThinkingMode, TaskComplexity } from '../types/thinking-modes.types';
+export declare class ComplexityScorer {
+    /**
+     * Calculate complexity score from task characteristics
+     * Score: 1-10 based on file count, integration depth, and test complexity
+     */
+    static calculateScore(task: TaskComplexity): number;
+    /**
+     * Select appropriate thinking mode based on complexity score
+     */
+    static selectMode(task: TaskComplexity): ComplexityLevel;
+    /**
+     * Validate that a mode meets its quality thresholds
+     */
+    static validateMode(mode: ThinkingMode): boolean;
+    /**
+     * Determine if mode transition is needed
+     */
+    static transitionMode(currentMode: ThinkingMode, task: TaskComplexity): ComplexityLevel;
+    /**
+     * Recommend mode with explanation
+     */
+    static recommendMode(task: TaskComplexity): {
+        mode: ComplexityLevel;
+        score: number;
+        reasoning: string;
+    };
+}
+//# sourceMappingURL=complexity-scorer.d.ts.map

package/dist/config/complexity-scorer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"complexity-scorer.d.ts","sourceRoot":"","sources":["../../src/config/complexity-scorer.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,eAAe,EAAE,YAAY,EAAE,cAAc,EAAE,MAAM,+BAA+B,CAAC;AAGnG,qBAAa,gBAAgB;IAC3B;;;OAGG;IACH,MAAM,CAAC,cAAc,CAAC,IAAI,EAAE,cAAc,GAAG,MAAM;IAmCnD;;OAEG;IACH,MAAM,CAAC,UAAU,CAAC,IAAI,EAAE,cAAc,GAAG,eAAe;IASxD;;OAEG;IACH,MAAM,CAAC,YAAY,CAAC,IAAI,EAAE,YAAY,GAAG,OAAO;IAyBhD;;OAEG;IACH,MAAM,CAAC,cAAc,CACnB,WAAW,EAAE,YAAY,EACzB,IAAI,EAAE,cAAc,GACnB,eAAe;IAUlB;;OAEG;IACH,MAAM,CAAC,aAAa,CAAC,IAAI,EAAE,cAAc,GAAG;QAC1C,IAAI,EAAE,eAAe,CAAC;QACtB,KAAK,EAAE,MAAM,CAAC;QACd,SAAS,EAAE,MAAM,CAAC;KACnB;CAqBF"}

package/dist/config/complexity-scorer.js

@@ -0,0 +1,118 @@
+/**
+ * Complexity Scorer Utility
+ * Calculates task complexity and selects appropriate thinking modes
+ */
+import { MODE_DEFINITIONS } from '../types/thinking-modes.types.js';
+export class ComplexityScorer {
+    /**
+     * Calculate complexity score from task characteristics
+     * Score: 1-10 based on file count, integration depth, and test complexity
+     */
+    static calculateScore(task) {
+        let score = 0;
+        // File count contribution (0-4 points)
+        if (task.fileCount) {
+            if (task.fileCount === 1)
+                score += 1;
+            else if (task.fileCount <= 3)
+                score += 2;
+            else if (task.fileCount <= 6)
+                score += 3;
+            else
+                score += 4;
+        }
+        // Integration depth contribution (0-3 points)
+        if (task.integrationDepth) {
+            if (task.integrationDepth === 0)
+                score += 0; // Isolated
+            else if (task.integrationDepth === 1)
+                score += 1; // Few dependencies
+            else if (task.integrationDepth === 2)
+                score += 2; // Many dependencies
+            else
+                score += 3; // Cross-system
+        }
+        // Test complexity contribution (0-3 points)
+        if (task.testComplexity) {
+            if (task.testComplexity === 0)
+                score += 0; // Unit tests
+            else if (task.testComplexity === 1)
+                score += 1; // Integration tests
+            else if (task.testComplexity === 2)
+                score += 2; // E2E tests
+            else
+                score += 3; // Statistical validation
+        }
+        // Use explicit complexity if provided
+        if (task.complexity !== undefined) {
+            score = task.complexity;
+        }
+        return Math.min(10, score);
+    }
+    /**
+     * Select appropriate thinking mode based on complexity score
+     */
+    static selectMode(task) {
+        const score = this.calculateScore(task);
+        if (score <= 3)
+            return 'simple';
+        if (score <= 6)
+            return 'standard';
+        if (score <= 8)
+            return 'complex';
+        return 'enterprise';
+    }
+    /**
+     * Validate that a mode meets its quality thresholds
+     */
+    static validateMode(mode) {
+        const definition = MODE_DEFINITIONS[mode.complexity];
+        // Check confidence threshold
+        if (mode.confidence < definition.confidence) {
+            return false;
+        }
+        // Check variance threshold if applicable
+        if (definition.variance !== undefined) {
+            if (mode.variance === undefined || mode.variance > definition.variance) {
+                return false;
+            }
+        }
+        // Check sample size if applicable
+        if (definition.sampleSize !== undefined) {
+            if (mode.sampleSize === undefined || mode.sampleSize < definition.sampleSize) {
+                return false;
+            }
+        }
+        return true;
+    }
+    /**
+     * Determine if mode transition is needed
+     */
+    static transitionMode(currentMode, task) {
+        const recommendedMode = this.selectMode(task);
+        if (recommendedMode !== currentMode.complexity) {
+            return recommendedMode;
+        }
+        return currentMode.complexity;
+    }
+    /**
+     * Recommend mode with explanation
+     */
+    static recommendMode(task) {
+        const score = this.calculateScore(task);
+        const mode = this.selectMode(task);
+        const definition = MODE_DEFINITIONS[mode];
+        let reasoning = `Complexity score: ${score}/10. `;
+        reasoning += `Selected ${mode} mode (${definition.budget} token budget, `;
+        reasoning += `${definition.confidence * 100}% confidence threshold`;
+        if (definition.variance) {
+            reasoning += `, variance ≤${definition.variance}`;
+        }
+        if (definition.sampleSize) {
+            reasoning += `, n≥${definition.sampleSize}`;
+        }
+        reasoning += `).`;
+        return { mode, score, reasoning };
+    }
+}
+//# sourceMappingURL=complexity-scorer.js.map

package/dist/config/complexity-scorer.js.map

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

package/dist/config/config-loader.d.ts

@@ -0,0 +1,105 @@
+/**
+ * Central Configuration Loader
+ *
+ * Unified configuration loading with validation, environment variable support,
+ * and multiple config file location support.
+ */
+import { SDLAFFullConfig, PartialSDLAFConfig } from './config-schema.js';
+/**
+ * Config loader options
+ */
+export interface ConfigLoaderOptions {
+    /** Explicit config file path (highest priority) */
+    configPath?: string;
+    /** Whether to throw on validation errors */
+    strict?: boolean;
+    /** Whether to apply environment variable overrides */
+    applyEnvOverrides?: boolean;
+    /** CLI argument overrides */
+    cliOverrides?: Partial<PartialSDLAFConfig>;
+}
+/**
+ * Config load result
+ */
+export interface ConfigLoadResult {
+    config: SDLAFFullConfig;
+    source: 'file' | 'defaults' | 'merged';
+    filePath?: string;
+    warnings: string[];
+}
+/**
+ * Central config loader class
+ */
+export declare class ConfigLoader {
+    private config;
+    private loadedFrom;
+    private warnings;
+    private readonly emitter;
+    private configWatcher;
+    /**
+     * Load configuration from all sources
+     */
+    load(options?: ConfigLoaderOptions): Promise<ConfigLoadResult>;
+    /**
+     * Load configuration from a file
+     */
+    private loadFromFile;
+    /**
+     * Load configuration from environment variables
+     */
+    private loadFromEnv;
+    /**
+     * Deep merge two objects
+     */
+    private deepMerge;
+    /**
+     * Get the current configuration (load if not loaded)
+     */
+    get(options?: ConfigLoaderOptions): Promise<SDLAFFullConfig>;
+    /**
+     * Get a specific config value by path
+     */
+    getValue<T>(path: string, options?: ConfigLoaderOptions): Promise<T | undefined>;
+    /**
+     * Reload configuration
+     */
+    reload(options?: ConfigLoaderOptions): Promise<ConfigLoadResult>;
+    /**
+     * Watch loaded config file for changes and emit updates
+     */
+    watchConfig(): () => void;
+    /**
+     * Register config change listener
+     */
+    onConfigChange(callback: (config: any) => void): void;
+    /**
+     * Get the path the config was loaded from
+     */
+    getLoadedPath(): string | null;
+    /**
+     * Get any warnings from the last load
+     */
+    getWarnings(): string[];
+    /**
+     * Check if config has been loaded
+     */
+    isLoaded(): boolean;
+}
+/**
+ * Get the global config loader instance
+ */
+export declare function getConfigLoader(): ConfigLoader;
+/**
+ * Reset the global config loader (for testing)
+ */
+export declare function resetConfigLoader(): void;
+/**
+ * Convenience function to load config
+ */
+export declare function loadConfig(options?: ConfigLoaderOptions): Promise<ConfigLoadResult>;
+/**
+ * Convenience function to get config
+ */
+export declare function getConfig(options?: ConfigLoaderOptions): Promise<SDLAFFullConfig>;
+export default ConfigLoader;
+//# sourceMappingURL=config-loader.d.ts.map

package/dist/config/config-loader.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config-loader.d.ts","sourceRoot":"","sources":["../../src/config/config-loader.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAMH,OAAO,EAEL,eAAe,EACf,kBAAkB,EAInB,MAAM,oBAAoB,CAAC;AAqB5B;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAClC,mDAAmD;IACnD,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,4CAA4C;IAC5C,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,sDAAsD;IACtD,iBAAiB,CAAC,EAAE,OAAO,CAAC;IAC5B,6BAA6B;IAC7B,YAAY,CAAC,EAAE,OAAO,CAAC,kBAAkB,CAAC,CAAC;CAC5C;AAED;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,MAAM,EAAE,eAAe,CAAC;IACxB,MAAM,EAAE,MAAM,GAAG,UAAU,GAAG,QAAQ,CAAC;IACvC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,MAAM,EAAE,CAAC;CACpB;AAED;;GAEG;AACH,qBAAa,YAAY;IACvB,OAAO,CAAC,MAAM,CAAgC;IAC9C,OAAO,CAAC,UAAU,CAAuB;IACzC,OAAO,CAAC,QAAQ,CAAgB;IAChC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAsB;IAC9C,OAAO,CAAC,aAAa,CAA6B;IAElD;;OAEG;IACG,IAAI,CAAC,OAAO,GAAE,mBAAwB,GAAG,OAAO,CAAC,gBAAgB,CAAC;IA6GxE;;OAEG;YACW,YAAY;IAuB1B;;OAEG;IACH,OAAO,CAAC,WAAW;IA6InB;;OAEG;IACH,OAAO,CAAC,SAAS;IA4BjB;;OAEG;IACG,GAAG,CAAC,OAAO,CAAC,EAAE,mBAAmB,GAAG,OAAO,CAAC,eAAe,CAAC;IAOlE;;OAEG;IACG,QAAQ,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,mBAAmB,GAAG,OAAO,CAAC,CAAC,GAAG,SAAS,CAAC;IAetF;;OAEG;IACG,MAAM,CAAC,OAAO,CAAC,EAAE,mBAAmB,GAAG,OAAO,CAAC,gBAAgB,CAAC;IAOtE;;OAEG;IACH,WAAW,IAAI,MAAM,IAAI;IAiCzB;;OAEG;IACH,cAAc,CAAC,QAAQ,EAAE,CAAC,MAAM,EAAE,GAAG,KAAK,IAAI,GAAG,IAAI;IAIrD;;OAEG;IACH,aAAa,IAAI,MAAM,GAAG,IAAI;IAI9B;;OAEG;IACH,WAAW,IAAI,MAAM,EAAE;IAIvB;;OAEG;IACH,QAAQ,IAAI,OAAO;CAGpB;AAKD;;GAEG;AACH,wBAAgB,eAAe,IAAI,YAAY,CAK9C;AAED;;GAEG;AACH,wBAAgB,iBAAiB,IAAI,IAAI,CAExC;AAED;;GAEG;AACH,wBAAsB,UAAU,CAAC,OAAO,CAAC,EAAE,mBAAmB,GAAG,OAAO,CAAC,gBAAgB,CAAC,CAEzF;AAED;;GAEG;AACH,wBAAsB,SAAS,CAAC,OAAO,CAAC,EAAE,mBAAmB,GAAG,OAAO,CAAC,eAAe,CAAC,CAEvF;AAED,eAAe,YAAY,CAAC"}