dartmind 17.0.0 → 17.3.1

package/dist/core/cost/integration.js

@@ -0,0 +1,349 @@
+/**
+ * DartMind V17.3 - Cost Optimization Integration
+ *
+ * This file provides integration helpers to connect the cost optimization
+ * module with your existing code WITHOUT modifying core logic.
+ *
+ * USAGE:
+ * 1. Import this module
+ * 2. Call processInput() before sending to API
+ * 3. Use buildOptimizedRequest() to get API parameters
+ *
+ * @module cost/integration
+ * @version 17.3.0
+ */
+import { tryReflex, shouldBypassReflex, checkModelOverride, } from './reflex-layer.js';
+import { buildCachedSystemBlocks, calculateCacheMetrics, formatCacheMetrics, } from './prompt-cache.js';
+import { routeToModel, DEFAULT_ROUTER_CONFIG, } from './model-router.js';
+import { determineContextTier, checkTierOverride, DEFAULT_SCALER_CONFIG, } from './context-scaler.js';
+import { DEFAULT_CONFIG, MODEL_IDS, MODEL_COSTS, } from './types.js';
+// ═══════════════════════════════════════════════════════════════
+// COST OPTIMIZER CLASS
+// ═══════════════════════════════════════════════════════════════
+export class CostOptimizer {
+    config;
+    routerConfig;
+    scalerConfig;
+    projectContext = '';
+    // Metrics tracking
+    reflexCount = 0;
+    apiCallCount = 0;
+    totalInputTokens = 0;
+    totalOutputTokens = 0;
+    totalCacheReadTokens = 0;
+    totalCost = 0;
+    totalSavings = 0;
+    modelCounts = { haiku: 0, sonnet: 0, opus: 0 };
+    tierCounts = { 0: 0, 1: 0, 2: 0, 3: 0, 4: 0 };
+    constructor(config = {}, routerConfig = {}, scalerConfig = {}) {
+        this.config = { ...DEFAULT_CONFIG, ...config };
+        this.routerConfig = { ...DEFAULT_ROUTER_CONFIG, ...routerConfig };
+        this.scalerConfig = { ...DEFAULT_SCALER_CONFIG, ...scalerConfig };
+    }
+    /**
+     * Set project context for caching.
+     * Call this once when project is loaded.
+     */
+    setProjectContext(context) {
+        this.projectContext = context;
+    }
+    /**
+     * Update configuration at runtime.
+     */
+    updateConfig(config) {
+        this.config = { ...this.config, ...config };
+    }
+    /**
+     * Update router configuration at runtime.
+     */
+    updateRouterConfig(config) {
+        this.routerConfig = { ...this.routerConfig, ...config };
+    }
+    /**
+     * Get current configuration.
+     */
+    getConfig() {
+        return { ...this.config };
+    }
+    /**
+     * Get current router configuration.
+     */
+    getRouterConfig() {
+        return { ...this.routerConfig };
+    }
+    /**
+     * Update scaler configuration at runtime.
+     */
+    updateScalerConfig(config) {
+        this.scalerConfig = { ...this.scalerConfig, ...config };
+    }
+    /**
+     * Get current scaler configuration.
+     */
+    getScalerConfig() {
+        return { ...this.scalerConfig };
+    }
+    /**
+     * Process user input through cost optimization layers.
+     * Call this BEFORE sending to Anthropic API.
+     *
+     * @param input - Raw user input
+     * @returns ProcessedInput with skip decision and optional local response
+     */
+    processInput(input) {
+        // ─────────────────────────────────────────────────────────
+        // Layer 1: Reflex - Check for local handling
+        // ─────────────────────────────────────────────────────────
+        if (this.config.enableReflexLayer && !shouldBypassReflex(input)) {
+            const reflex = tryReflex(input);
+            if (reflex.handled) {
+                this.reflexCount++;
+                this.log(`[Reflex] Handled locally: ${reflex.reason}`);
+                return {
+                    skipAPI: true,
+                    localResponse: reflex.response,
+                    reason: reflex.reason,
+                    query: input
+                };
+            }
+        }
+        // ─────────────────────────────────────────────────────────
+        // Check for tier override (/t0-/t4, /minimal, /focused, etc.)
+        // ─────────────────────────────────────────────────────────
+        const tierOverride = checkTierOverride(input);
+        if (tierOverride) {
+            // Still need to route to model, but use the overridden tier
+            const classification = this.config.enableModelRouting
+                ? routeToModel(tierOverride.query, this.routerConfig)
+                : undefined;
+            this.apiCallCount++;
+            const tier = determineContextTier(classification || { intent: 'unknown', model: 'sonnet', modelId: MODEL_IDS.sonnet, confidence: 0.5, reason: 'default' }, { ...this.scalerConfig, minTier: tierOverride.tier, maxTier: tierOverride.tier });
+            this.tierCounts[tier.tier]++;
+            this.log(`[Context] Tier override T${tierOverride.tier} (${tier.name})`);
+            return {
+                skipAPI: false,
+                query: tierOverride.query,
+                modelOverride: classification?.model,
+                classification,
+                contextTier: tier
+            };
+        }
+        // ─────────────────────────────────────────────────────────
+        // Check for model override (/haiku, /sonnet, /opus)
+        // ─────────────────────────────────────────────────────────
+        const override = checkModelOverride(input);
+        if (override) {
+            this.apiCallCount++;
+            return {
+                skipAPI: false,
+                query: override.query,
+                modelOverride: override.model
+            };
+        }
+        // ─────────────────────────────────────────────────────────
+        // Layer 2: Model Routing - Route to cheapest capable model
+        // Layer 3: Context Scaling - Right-size context for task
+        // ─────────────────────────────────────────────────────────
+        if (this.config.enableModelRouting) {
+            const classification = routeToModel(input, this.routerConfig);
+            this.apiCallCount++;
+            // Determine context tier based on classification
+            let contextTier;
+            if (this.config.enableContextScaling) {
+                contextTier = determineContextTier(classification, this.scalerConfig);
+                this.tierCounts[contextTier.tier]++;
+                this.log(`[Context] T${contextTier.tier} (${contextTier.name}) for ${classification.intent}`);
+            }
+            this.log(`[Router] ${classification.model.toUpperCase()} (${(classification.confidence * 100).toFixed(0)}%) - ${classification.intent}: ${classification.reason}`);
+            return {
+                skipAPI: false,
+                query: input,
+                modelOverride: classification.model,
+                classification,
+                contextTier
+            };
+        }
+        // ─────────────────────────────────────────────────────────
+        // Pass to API with default model (Sonnet)
+        // ─────────────────────────────────────────────────────────
+        this.apiCallCount++;
+        return {
+            skipAPI: false,
+            query: input
+        };
+    }
+    /**
+     * Build optimized request parameters for Anthropic API.
+     *
+     * @param modelOverride - Optional model override from processInput
+     * @returns Partial request config with system blocks and model
+     */
+    buildOptimizedRequest(modelOverride) {
+        // Build cached system blocks
+        const systemBlocks = this.config.enablePromptCaching
+            ? buildCachedSystemBlocks(this.projectContext)
+            : buildCachedSystemBlocks(this.projectContext, {
+                enableSystemPromptCache: false,
+                enableToolDefinitionsCache: false,
+                enableProjectContextCache: false
+            });
+        // Determine model
+        const model = modelOverride
+            ? MODEL_IDS[modelOverride]
+            : MODEL_IDS.sonnet; // Default to Sonnet (routing will be added in Day 2)
+        // Track model usage
+        const tier = modelOverride || 'sonnet';
+        this.modelCounts[tier]++;
+        return {
+            model,
+            system: systemBlocks
+        };
+    }
+    /**
+     * Process API response to extract cache metrics and track costs.
+     * Call this after receiving Anthropic API response.
+     */
+    processResponse(usage, model = 'sonnet') {
+        // Track tokens
+        this.totalInputTokens += usage.input_tokens;
+        this.totalOutputTokens += usage.output_tokens;
+        this.totalCacheReadTokens += usage.cache_read_input_tokens ?? 0;
+        // Calculate cost
+        const costs = MODEL_COSTS[model];
+        const inputCost = (usage.input_tokens / 1_000_000) * costs.input;
+        const outputCost = (usage.output_tokens / 1_000_000) * costs.output;
+        const requestCost = inputCost + outputCost;
+        this.totalCost += requestCost;
+        // Calculate cache savings
+        if (this.config.enablePromptCaching) {
+            const metrics = calculateCacheMetrics(usage, costs.input);
+            this.totalSavings += metrics.estimatedSavings;
+            this.log(`[Cache] ${formatCacheMetrics(metrics)}`);
+        }
+        this.log(`[Cost] Request: $${requestCost.toFixed(4)} | Total: $${this.totalCost.toFixed(4)}`);
+    }
+    /**
+     * Get current session metrics.
+     */
+    getMetrics() {
+        const totalRequests = this.reflexCount + this.apiCallCount;
+        const sonnetEquivalentCost = (this.totalInputTokens / 1_000_000) * MODEL_COSTS.sonnet.input +
+            (this.totalOutputTokens / 1_000_000) * MODEL_COSTS.sonnet.output;
+        return {
+            totalRequests,
+            totalCost: this.totalCost,
+            reflexCount: this.reflexCount,
+            cacheHitCount: this.totalCacheReadTokens > 0 ? 1 : 0, // Simplified
+            modelBreakdown: {
+                haiku: { count: this.modelCounts.haiku, tokens: 0, cost: 0 },
+                sonnet: { count: this.modelCounts.sonnet, tokens: 0, cost: 0 },
+                opus: { count: this.modelCounts.opus, tokens: 0, cost: 0 }
+            },
+            averageCostPerRequest: totalRequests > 0 ? this.totalCost / totalRequests : 0,
+            savingsVsAllSonnet: sonnetEquivalentCost - this.totalCost + this.totalSavings,
+            savingsPercent: sonnetEquivalentCost > 0
+                ? ((sonnetEquivalentCost - this.totalCost + this.totalSavings) / sonnetEquivalentCost) * 100
+                : 0
+        };
+    }
+    /**
+     * Format metrics for display.
+     */
+    formatMetrics() {
+        const m = this.getMetrics();
+        const reflexRate = m.totalRequests > 0 ? (m.reflexCount / m.totalRequests) * 100 : 0;
+        const tc = this.tierCounts;
+        return [
+            `Session Stats:`,
+            `  Total requests: ${m.totalRequests}`,
+            `  Reflex handled: ${m.reflexCount} (${reflexRate.toFixed(1)}%)`,
+            `  API calls: ${this.apiCallCount}`,
+            `  Total cost: $${m.totalCost.toFixed(4)}`,
+            `  Total savings: $${m.savingsVsAllSonnet.toFixed(4)} (${m.savingsPercent.toFixed(1)}%)`,
+            `  Avg cost/request: $${m.averageCostPerRequest.toFixed(4)}`,
+            `  Models: H:${this.modelCounts.haiku} S:${this.modelCounts.sonnet} O:${this.modelCounts.opus}`,
+            `  Tiers: T0:${tc[0]} T1:${tc[1]} T2:${tc[2]} T3:${tc[3]} T4:${tc[4]}`
+        ].join('\n');
+    }
+    /**
+     * Reset metrics (for new session).
+     */
+    resetMetrics() {
+        this.reflexCount = 0;
+        this.apiCallCount = 0;
+        this.totalInputTokens = 0;
+        this.totalOutputTokens = 0;
+        this.totalCacheReadTokens = 0;
+        this.totalCost = 0;
+        this.totalSavings = 0;
+        this.modelCounts = { haiku: 0, sonnet: 0, opus: 0 };
+        this.tierCounts = { 0: 0, 1: 0, 2: 0, 3: 0, 4: 0 };
+    }
+    /**
+     * Get tier counts for metrics.
+     */
+    getTierCounts() {
+        return { ...this.tierCounts };
+    }
+    /**
+     * Check if a specific optimization layer is enabled.
+     */
+    isLayerEnabled(layer) {
+        return !!this.config[layer];
+    }
+    /**
+     * Enable/disable a specific layer at runtime.
+     */
+    setLayerEnabled(layer, enabled) {
+        if (layer in this.config && typeof this.config[layer] === 'boolean') {
+            this.config[layer] = enabled;
+        }
+    }
+    log(message) {
+        if (this.config.debug) {
+            console.log(`[CostOptimizer] ${message}`);
+        }
+    }
+}
+// ═══════════════════════════════════════════════════════════════
+// SINGLETON INSTANCE
+// ═══════════════════════════════════════════════════════════════
+/**
+ * Default cost optimizer instance for easy use.
+ * Configure with costOptimizer.updateConfig({ ... })
+ */
+export const costOptimizer = new CostOptimizer({ debug: false });
+// ═══════════════════════════════════════════════════════════════
+// CONVENIENCE FUNCTIONS
+// ═══════════════════════════════════════════════════════════════
+/**
+ * Quick check if input should skip API (reflex handled).
+ */
+export function shouldSkipAPI(input) {
+    if (!shouldBypassReflex(input)) {
+        const reflex = tryReflex(input);
+        return reflex.handled;
+    }
+    return false;
+}
+/**
+ * Get local response if available (for reflex-handled inputs).
+ */
+export function getLocalResponse(input) {
+    if (!shouldBypassReflex(input)) {
+        const reflex = tryReflex(input);
+        if (reflex.handled) {
+            return reflex.response;
+        }
+    }
+    return undefined;
+}
+/**
+ * Estimate cost for a request before making it.
+ */
+export function estimateRequestCost(inputTokens, outputTokens, model = 'sonnet') {
+    const costs = MODEL_COSTS[model];
+    return (inputTokens / 1_000_000) * costs.input +
+        (outputTokens / 1_000_000) * costs.output;
+}
+//# sourceMappingURL=integration.js.map

package/dist/core/cost/integration.js.map

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

package/dist/core/cost/model-router.d.ts

@@ -0,0 +1,70 @@
+/**
+ * DartMind V17.3 - Model Router
+ *
+ * PURPOSE: Route requests to the cheapest model that can handle them.
+ * COST IMPACT: 40-50% savings by using Haiku for 70% of requests
+ * QUALITY IMPACT: NONE (Sonnet for all code generation)
+ *
+ * ROUTING LOGIC:
+ * - Haiku ($0.80/1M): Read, explain, search, list, simple Q&A
+ * - Sonnet ($3.00/1M): Generate, refactor, fix bugs, write tests
+ * - Opus ($15.00/1M): Architecture, security (only if explicitly requested)
+ *
+ * SAFETY FEATURES:
+ * - Code generation ALWAYS goes to Sonnet (never Haiku)
+ * - Low confidence auto-escalates to more capable model
+ * - User can override with /haiku, /sonnet, /opus commands
+ *
+ * @module cost/model-router
+ * @version 17.3.0
+ */
+import { ClassificationResult, ModelTier } from './types.js';
+/**
+ * Classify user input to determine intent and model.
+ *
+ * @param input - User input string
+ * @returns Classification result with intent, model, and confidence
+ */
+export declare function classifyTask(input: string): ClassificationResult;
+export interface RouterConfig {
+    minHaikuConfidence: number;
+    minSonnetConfidence: number;
+    allowOpusEscalation: boolean;
+}
+export declare const DEFAULT_ROUTER_CONFIG: RouterConfig;
+/**
+ * Apply confidence-based escalation rules.
+ * Low confidence tasks get escalated to more capable models.
+ */
+export declare function applyEscalation(classification: ClassificationResult, config?: RouterConfig): ClassificationResult;
+/**
+ * Route input to appropriate model.
+ * Combines classification and escalation.
+ *
+ * @param input - User input
+ * @param config - Router configuration
+ * @returns Final classification with model selection
+ */
+export declare function routeToModel(input: string, config?: RouterConfig): ClassificationResult;
+/**
+ * Estimate cost for a request based on model and tokens.
+ */
+export declare function estimateCost(model: ModelTier, inputTokens: number, outputTokens?: number): number;
+/**
+ * Format classification for logging.
+ */
+export declare function formatClassification(result: ClassificationResult): string;
+/**
+ * Get the model tier from a model ID string.
+ */
+export declare function getModelTier(modelId: string): ModelTier;
+/**
+ * Calculate potential savings compared to using Sonnet for everything.
+ */
+export declare function calculateSavings(model: ModelTier, inputTokens: number, outputTokens: number): {
+    actualCost: number;
+    sonnetCost: number;
+    savings: number;
+    savingsPercent: number;
+};
+//# sourceMappingURL=model-router.d.ts.map

package/dist/core/cost/model-router.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"model-router.d.ts","sourceRoot":"","sources":["../../../src/core/cost/model-router.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AAEH,OAAO,EAEL,oBAAoB,EACpB,SAAS,EAGV,MAAM,YAAY,CAAC;AAmMpB;;;;;GAKG;AACH,wBAAgB,YAAY,CAAC,KAAK,EAAE,MAAM,GAAG,oBAAoB,CA6BhE;AAMD,MAAM,WAAW,YAAY;IAC3B,kBAAkB,EAAE,MAAM,CAAC;IAC3B,mBAAmB,EAAE,MAAM,CAAC;IAC5B,mBAAmB,EAAE,OAAO,CAAC;CAC9B;AAED,eAAO,MAAM,qBAAqB,EAAE,YAInC,CAAC;AAEF;;;GAGG;AACH,wBAAgB,eAAe,CAC7B,cAAc,EAAE,oBAAoB,EACpC,MAAM,GAAE,YAAoC,GAC3C,oBAAoB,CAwBtB;AAMD;;;;;;;GAOG;AACH,wBAAgB,YAAY,CAC1B,KAAK,EAAE,MAAM,EACb,MAAM,GAAE,YAAoC,GAC3C,oBAAoB,CAQtB;AAMD;;GAEG;AACH,wBAAgB,YAAY,CAC1B,KAAK,EAAE,SAAS,EAChB,WAAW,EAAE,MAAM,EACnB,YAAY,GAAE,MAAY,GACzB,MAAM,CAGR;AAED;;GAEG;AACH,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,oBAAoB,GAAG,MAAM,CAQzE;AAED;;GAEG;AACH,wBAAgB,YAAY,CAAC,OAAO,EAAE,MAAM,GAAG,SAAS,CAOvD;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAC9B,KAAK,EAAE,SAAS,EAChB,WAAW,EAAE,MAAM,EACnB,YAAY,EAAE,MAAM,GACnB;IAAE,UAAU,EAAE,MAAM,CAAC;IAAC,UAAU,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAC;IAAC,cAAc,EAAE,MAAM,CAAA;CAAE,CAOrF"}