attocode 0.2.3 → 0.2.5

package/dist/src/integrations/utilities/routing.js

@@ -0,0 +1,348 @@
+/**
+ * Lesson 23: Routing Integration
+ *
+ * Integrates model routing (Lesson 22) into the production agent.
+ * Provides intelligent model selection and fallback capabilities.
+ */
+import { logger } from './logger.js';
+// =============================================================================
+// ROUTING MANAGER
+// =============================================================================
+/**
+ * Manages model routing and fallbacks.
+ */
+export class RoutingManager {
+    config;
+    models = new Map();
+    circuitState = new Map();
+    constructor(config) {
+        this.config = config;
+        this.initializeModels();
+    }
+    /**
+     * Initialize models from config.
+     */
+    initializeModels() {
+        for (const modelConfig of this.config.models || []) {
+            const capability = {
+                model: modelConfig.id,
+                provider: modelConfig.provider,
+                maxTokens: modelConfig.maxTokens || 4096,
+                supportsTools: modelConfig.capabilities?.includes('tools') ?? true,
+                supportsVision: modelConfig.capabilities?.includes('vision') ?? false,
+                costPer1kInput: modelConfig.costPer1kInput || 0.001,
+                costPer1kOutput: modelConfig.costPer1kOutput || 0.002,
+                latencyMs: 0, // Will be updated with actual measurements
+                qualityScore: 0.8, // Default quality score
+                available: true,
+                errorCount: 0,
+            };
+            this.models.set(modelConfig.id, capability);
+            // Initialize circuit breaker state
+            this.circuitState.set(modelConfig.id, {
+                state: 'closed',
+                failures: 0,
+                lastFailure: undefined,
+                nextAttempt: undefined,
+            });
+        }
+    }
+    /**
+     * Select best model for a task.
+     */
+    selectModel(context) {
+        // Check routing rules first (function-based from RoutingConfig)
+        for (const rule of this.config.rules || []) {
+            // RoutingRule.condition is a function that takes RoutingContext
+            const routingContext = {
+                task: context.task,
+                complexity: context.complexity,
+                requiredCapabilities: context.hasTools ? ['tools'] : [],
+            };
+            if (rule.condition(routingContext)) {
+                const model = this.models.get(rule.model);
+                if (model && this.isModelAvailable(rule.model)) {
+                    return rule.model;
+                }
+            }
+        }
+        // Use strategy-based selection
+        const availableModels = Array.from(this.models.entries())
+            .filter(([id]) => this.isModelAvailable(id))
+            .map(([_, model]) => model);
+        if (availableModels.length === 0) {
+            return null;
+        }
+        switch (this.config.strategy) {
+            case 'cost':
+                return this.selectByCost(availableModels, context);
+            case 'quality':
+                return this.selectByQuality(availableModels, context);
+            case 'latency':
+                return this.selectByLatency(availableModels, context);
+            case 'balanced':
+            default:
+                return this.selectBalanced(availableModels, context);
+        }
+    }
+    /**
+     * Evaluate an internal routing rule (object-based conditions).
+     * Used for internal rule processing when function-based rules
+     * are converted or for custom internal rules.
+     */
+    evaluateInternalRule(rule, context) {
+        // Check complexity threshold
+        if (rule.condition.minComplexity !== undefined) {
+            if (context.complexity < rule.condition.minComplexity) {
+                return false;
+            }
+        }
+        if (rule.condition.maxComplexity !== undefined) {
+            if (context.complexity > rule.condition.maxComplexity) {
+                return false;
+            }
+        }
+        // Check tool requirement
+        if (rule.condition.requiresTools && !context.hasTools) {
+            return false;
+        }
+        // Check vision requirement
+        if (rule.condition.requiresVision && !context.hasImages) {
+            return false;
+        }
+        // Check task type
+        if (rule.condition.taskTypes && rule.condition.taskTypes.length > 0) {
+            if (!rule.condition.taskTypes.includes(context.taskType)) {
+                return false;
+            }
+        }
+        return true;
+    }
+    /**
+     * Select model by cost (cheapest first).
+     */
+    selectByCost(models, context) {
+        const estimated = context.estimatedTokens || 1000;
+        const sorted = [...models].sort((a, b) => {
+            const costA = (estimated / 1000) * (a.costPer1kInput + a.costPer1kOutput);
+            const costB = (estimated / 1000) * (b.costPer1kInput + b.costPer1kOutput);
+            return costA - costB;
+        });
+        return sorted[0].model;
+    }
+    /**
+     * Select model by quality (highest first).
+     */
+    selectByQuality(models, context) {
+        const sorted = [...models].sort((a, b) => b.qualityScore - a.qualityScore);
+        return sorted[0].model;
+    }
+    /**
+     * Select model by latency (fastest first).
+     */
+    selectByLatency(models, context) {
+        const sorted = [...models].sort((a, b) => a.latencyMs - b.latencyMs);
+        return sorted[0].model;
+    }
+    /**
+     * Balanced selection considering all factors.
+     */
+    selectBalanced(models, context) {
+        const estimated = context.estimatedTokens || 1000;
+        const scored = models.map((model) => {
+            // Normalize scores to 0-1 range
+            const costScore = 1 - Math.min((estimated / 1000) * (model.costPer1kInput + model.costPer1kOutput) / 0.1, 1);
+            const qualityScore = model.qualityScore;
+            const latencyScore = 1 - Math.min(model.latencyMs / 5000, 1);
+            // Weight based on context
+            let costWeight = 0.3;
+            let qualityWeight = 0.5;
+            let latencyWeight = 0.2;
+            if (context.complexity > 7) {
+                qualityWeight = 0.7;
+                costWeight = 0.15;
+                latencyWeight = 0.15;
+            }
+            else if (context.complexity < 3) {
+                costWeight = 0.5;
+                qualityWeight = 0.3;
+                latencyWeight = 0.2;
+            }
+            const score = costScore * costWeight + qualityScore * qualityWeight + latencyScore * latencyWeight;
+            return { model: model.model, score };
+        });
+        scored.sort((a, b) => b.score - a.score);
+        return scored[0].model;
+    }
+    /**
+     * Check if model is available (circuit breaker).
+     */
+    isModelAvailable(modelId) {
+        if (!this.config.circuitBreaker) {
+            const model = this.models.get(modelId);
+            return model?.available ?? false;
+        }
+        const circuit = this.circuitState.get(modelId);
+        if (!circuit)
+            return false;
+        switch (circuit.state) {
+            case 'closed':
+                return true;
+            case 'open':
+                // Check if we should try half-open
+                if (circuit.nextAttempt && Date.now() >= circuit.nextAttempt.getTime()) {
+                    circuit.state = 'half-open';
+                    return true;
+                }
+                return false;
+            case 'half-open':
+                return true;
+        }
+    }
+    /**
+     * Record successful call.
+     */
+    recordSuccess(modelId) {
+        const circuit = this.circuitState.get(modelId);
+        if (!circuit)
+            return;
+        circuit.failures = 0;
+        if (circuit.state === 'half-open') {
+            circuit.state = 'closed';
+        }
+        const model = this.models.get(modelId);
+        if (model) {
+            model.errorCount = 0;
+        }
+    }
+    /**
+     * Record failed call.
+     */
+    recordFailure(modelId, error) {
+        const circuit = this.circuitState.get(modelId);
+        if (!circuit)
+            return;
+        circuit.failures++;
+        circuit.lastFailure = new Date();
+        const model = this.models.get(modelId);
+        if (model) {
+            model.errorCount++;
+            model.lastError = new Date();
+        }
+        // Open circuit after threshold
+        const threshold = 3;
+        if (circuit.failures >= threshold) {
+            circuit.state = 'open';
+            // Try again after 30 seconds
+            circuit.nextAttempt = new Date(Date.now() + 30000);
+        }
+    }
+    /**
+     * Get provider for a model.
+     */
+    getProvider(modelId) {
+        const model = this.models.get(modelId);
+        return model?.provider || null;
+    }
+    /**
+     * Execute with fallback chain.
+     */
+    async executeWithFallback(messages, context) {
+        // Build fallback chain
+        const chain = this.config.fallbackChain?.length
+            ? this.config.fallbackChain
+            : Array.from(this.models.keys());
+        let lastError = null;
+        for (const modelId of chain) {
+            if (!this.isModelAvailable(modelId)) {
+                continue;
+            }
+            const provider = this.getProvider(modelId);
+            if (!provider)
+                continue;
+            try {
+                const response = await provider.chat(messages);
+                this.recordSuccess(modelId);
+                return { response, model: modelId };
+            }
+            catch (err) {
+                lastError = err instanceof Error ? err : new Error(String(err));
+                this.recordFailure(modelId, lastError);
+                logger.warn(`[Routing] Model ${modelId} failed:`, { error: lastError.message });
+            }
+        }
+        throw lastError || new Error('No available models');
+    }
+    /**
+     * Get model statistics.
+     */
+    getStats() {
+        return Array.from(this.models.values()).map((model) => ({
+            model: model.model,
+            available: this.isModelAvailable(model.model),
+            circuitState: this.circuitState.get(model.model)?.state || 'unknown',
+            errorCount: model.errorCount,
+            lastError: model.lastError,
+        }));
+    }
+    /**
+     * Add or update a model.
+     */
+    addModel(capability) {
+        this.models.set(capability.model, {
+            ...capability,
+            available: true,
+            errorCount: 0,
+        });
+        this.circuitState.set(capability.model, {
+            state: 'closed',
+            failures: 0,
+            lastFailure: undefined,
+            nextAttempt: undefined,
+        });
+    }
+    /**
+     * Remove a model.
+     */
+    removeModel(modelId) {
+        this.models.delete(modelId);
+        this.circuitState.delete(modelId);
+    }
+    /**
+     * Estimate task complexity.
+     */
+    estimateComplexity(task) {
+        let score = 1;
+        // Length-based complexity
+        if (task.length > 100)
+            score += 1;
+        if (task.length > 200)
+            score += 1;
+        if (task.length > 500)
+            score += 1;
+        // Keyword-based complexity
+        const complexKeywords = [
+            'implement', 'refactor', 'migrate', 'integrate', 'build',
+            'create', 'design', 'architect', 'optimize', 'debug',
+            'analyze', 'compare', 'evaluate', 'synthesize',
+        ];
+        for (const keyword of complexKeywords) {
+            if (task.toLowerCase().includes(keyword)) {
+                score += 0.5;
+            }
+        }
+        // Multi-step indicators
+        if (task.includes(' and ') || task.includes(' then '))
+            score += 1;
+        if (/\d\./.test(task) || task.includes('first'))
+            score += 1;
+        return Math.min(Math.round(score), 10);
+    }
+}
+// =============================================================================
+// FACTORY
+// =============================================================================
+export function createRoutingManager(config) {
+    return new RoutingManager(config);
+}
+//# sourceMappingURL=routing.js.map

package/dist/src/integrations/utilities/routing.js.map

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

package/dist/src/integrations/utilities/rules.d.ts

@@ -0,0 +1,131 @@
+/**
+ * Lesson 25: Rules System Integration
+ *
+ * Loads and applies rules from CLAUDE.md and other sources (from Lesson 12).
+ * Rules can modify the system prompt, add constraints, or provide context.
+ */
+/**
+ * Rule source configuration.
+ */
+export interface RuleSource {
+    type: 'file' | 'inline';
+    path?: string;
+    content?: string;
+    priority?: number;
+}
+/**
+ * Rules configuration.
+ */
+export interface RulesConfig {
+    enabled?: boolean;
+    sources?: RuleSource[];
+    watch?: boolean;
+}
+/**
+ * Loaded rule.
+ */
+export interface LoadedRule {
+    source: string;
+    content: string;
+    priority: number;
+    loadedAt: Date;
+}
+/**
+ * Rules manager events.
+ */
+export type RulesEvent = {
+    type: 'rules.loaded';
+    count: number;
+    sources: string[];
+} | {
+    type: 'rules.reloaded';
+    source: string;
+} | {
+    type: 'rules.error';
+    source: string;
+    error: string;
+};
+export type RulesEventListener = (event: RulesEvent) => void;
+/**
+ * RulesManager loads and manages rules from various sources.
+ */
+export declare class RulesManager {
+    private config;
+    private rules;
+    private listeners;
+    private watchers;
+    private baseDir;
+    constructor(config?: Partial<RulesConfig>, baseDir?: string);
+    /**
+     * Load rules from configured sources.
+     */
+    loadRules(): Promise<void>;
+    /**
+     * Load a single rule source.
+     */
+    private loadSource;
+    /**
+     * Setup file watchers for auto-reload.
+     */
+    private setupWatchers;
+    /**
+     * Reload a specific source.
+     */
+    private reloadSource;
+    /**
+     * Clean up watchers.
+     */
+    private cleanupWatchers;
+    /**
+     * Get all rules as a combined string for system prompt.
+     */
+    getRulesContent(): string;
+    /**
+     * Get rules as context strings for memory augmentation.
+     */
+    getRulesContext(): string[];
+    /**
+     * Get loaded rules.
+     */
+    getLoadedRules(): LoadedRule[];
+    /**
+     * Add a rule at runtime.
+     */
+    addRule(content: string, priority?: number, source?: string): void;
+    /**
+     * Remove a rule by source.
+     */
+    removeRule(source: string): boolean;
+    /**
+     * Subscribe to events.
+     */
+    on(listener: RulesEventListener): () => void;
+    /**
+     * Emit an event.
+     */
+    private emit;
+    /**
+     * Cleanup resources.
+     */
+    cleanup(): void;
+}
+/**
+ * Create a rules manager and load rules.
+ */
+export declare function createRulesManager(config?: Partial<RulesConfig>, baseDir?: string): Promise<RulesManager>;
+/**
+ * Default rule sources to check.
+ */
+export declare const DEFAULT_RULE_SOURCES: RuleSource[];
+/**
+ * Parse rules from markdown content.
+ * Extracts sections and returns structured rules.
+ */
+export declare function parseRulesFromMarkdown(content: string): {
+    sections: Array<{
+        heading: string;
+        content: string;
+    }>;
+    raw: string;
+};
+//# sourceMappingURL=rules.d.ts.map

package/dist/src/integrations/utilities/rules.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"rules.d.ts","sourceRoot":"","sources":["../../../../src/integrations/utilities/rules.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAUH;;GAEG;AACH,MAAM,WAAW,UAAU;IACzB,IAAI,EAAE,MAAM,GAAG,QAAQ,CAAC;IACxB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED;;GAEG;AACH,MAAM,WAAW,WAAW;IAC1B,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,OAAO,CAAC,EAAE,UAAU,EAAE,CAAC;IACvB,KAAK,CAAC,EAAE,OAAO,CAAC;CACjB;AAED;;GAEG;AACH,MAAM,WAAW,UAAU;IACzB,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,IAAI,CAAC;CAChB;AAED;;GAEG;AACH,MAAM,MAAM,UAAU,GAClB;IAAE,IAAI,EAAE,cAAc,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,EAAE,CAAA;CAAE,GAC1D;IAAE,IAAI,EAAE,gBAAgB,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,GAC1C;IAAE,IAAI,EAAE,aAAa,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,CAAC;AAE3D,MAAM,MAAM,kBAAkB,GAAG,CAAC,KAAK,EAAE,UAAU,KAAK,IAAI,CAAC;AAM7D;;GAEG;AACH,qBAAa,YAAY;IACvB,OAAO,CAAC,MAAM,CAAc;IAC5B,OAAO,CAAC,KAAK,CAAoB;IACjC,OAAO,CAAC,SAAS,CAA4B;IAC7C,OAAO,CAAC,QAAQ,CAAmB;IACnC,OAAO,CAAC,OAAO,CAAS;gBAEZ,MAAM,GAAE,OAAO,CAAC,WAAW,CAAM,EAAE,OAAO,CAAC,EAAE,MAAM;IAS/D;;OAEG;IACG,SAAS,IAAI,OAAO,CAAC,IAAI,CAAC;IA8BhC;;OAEG;YACW,UAAU;IA8BxB;;OAEG;IACH,OAAO,CAAC,aAAa;IAwBrB;;OAEG;YACW,YAAY;IAoB1B;;OAEG;IACH,OAAO,CAAC,eAAe;IAOvB;;OAEG;IACH,eAAe,IAAI,MAAM;IAQzB;;OAEG;IACH,eAAe,IAAI,MAAM,EAAE;IAI3B;;OAEG;IACH,cAAc,IAAI,UAAU,EAAE;IAI9B;;OAEG;IACH,OAAO,CAAC,OAAO,EAAE,MAAM,EAAE,QAAQ,GAAE,MAAU,EAAE,MAAM,GAAE,MAAkB,GAAG,IAAI;IAUhF;;OAEG;IACH,UAAU,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO;IASnC;;OAEG;IACH,EAAE,CAAC,QAAQ,EAAE,kBAAkB,GAAG,MAAM,IAAI;IAQ5C;;OAEG;IACH,OAAO,CAAC,IAAI;IAUZ;;OAEG;IACH,OAAO,IAAI,IAAI;CAKhB;AAMD;;GAEG;AACH,wBAAsB,kBAAkB,CACtC,MAAM,CAAC,EAAE,OAAO,CAAC,WAAW,CAAC,EAC7B,OAAO,CAAC,EAAE,MAAM,GACf,OAAO,CAAC,YAAY,CAAC,CAIvB;AAMD;;GAEG;AACH,eAAO,MAAM,oBAAoB,EAAE,UAAU,EAQ5C,CAAC;AAEF;;;GAGG;AACH,wBAAgB,sBAAsB,CAAC,OAAO,EAAE,MAAM,GAAG;IACvD,QAAQ,EAAE,KAAK,CAAC;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IACtD,GAAG,EAAE,MAAM,CAAC;CACb,CAiCA"}