dartmind 17.0.0 → 17.3.0

package/dist/core/cost/reflex-layer.d.ts

@@ -0,0 +1,48 @@
+/**
+ * DartMind V17.3 - Reflex Layer
+ *
+ * PURPOSE: Handle trivial inputs locally without API calls.
+ * COST IMPACT: 15-20% of requests → $0.00
+ * QUALITY IMPACT: NONE (only exact pattern matches)
+ *
+ * SAFETY FEATURES:
+ * - Only matches exact patterns (no fuzzy matching)
+ * - Falls through to AI for ANY uncertainty
+ * - Can be disabled via config.enableReflexLayer
+ * - Never intercepts questions or code-related queries
+ *
+ * @module cost/reflex-layer
+ * @version 17.3.0
+ */
+import { ReflexResult } from './types.js';
+interface CommandHandler {
+    command: string;
+    aliases: string[];
+    description: string;
+    handler: (args?: string) => string;
+}
+/**
+ * Check if input should bypass reflex layer entirely.
+ * Returns true if the input looks like a real query.
+ */
+export declare function shouldBypassReflex(input: string): boolean;
+/**
+ * Try to handle input with reflex layer.
+ * Returns handled=true if we can respond locally.
+ * Returns handled=false if we should pass to AI.
+ */
+export declare function tryReflex(input: string): ReflexResult;
+/**
+ * Get all available commands (for help/autocomplete)
+ */
+export declare function getCommands(): CommandHandler[];
+/**
+ * Check if input is a model override command
+ * Returns the model tier if found, null otherwise
+ */
+export declare function checkModelOverride(input: string): {
+    model: 'haiku' | 'sonnet' | 'opus';
+    query: string;
+} | null;
+export {};
+//# sourceMappingURL=reflex-layer.d.ts.map

package/dist/core/cost/reflex-layer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"reflex-layer.d.ts","sourceRoot":"","sources":["../../../src/core/cost/reflex-layer.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAEH,OAAO,EAAE,YAAY,EAAc,MAAM,YAAY,CAAC;AAmHtD,UAAU,cAAc;IACtB,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,WAAW,EAAE,MAAM,CAAC;IACpB,OAAO,EAAE,CAAC,IAAI,CAAC,EAAE,MAAM,KAAK,MAAM,CAAC;CACpC;AA6FD;;;GAGG;AACH,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAmBzD;AAED;;;;GAIG;AACH,wBAAgB,SAAS,CAAC,KAAK,EAAE,MAAM,GAAG,YAAY,CAoDrD;AAED;;GAEG;AACH,wBAAgB,WAAW,IAAI,cAAc,EAAE,CAE9C;AAED;;;GAGG;AACH,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,MAAM,GAAG;IAAE,KAAK,EAAE,OAAO,GAAG,QAAQ,GAAG,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,GAAG,IAAI,CAe9G"}

package/dist/core/cost/reflex-layer.js

@@ -0,0 +1,295 @@
+/**
+ * DartMind V17.3 - Reflex Layer
+ *
+ * PURPOSE: Handle trivial inputs locally without API calls.
+ * COST IMPACT: 15-20% of requests → $0.00
+ * QUALITY IMPACT: NONE (only exact pattern matches)
+ *
+ * SAFETY FEATURES:
+ * - Only matches exact patterns (no fuzzy matching)
+ * - Falls through to AI for ANY uncertainty
+ * - Can be disabled via config.enableReflexLayer
+ * - Never intercepts questions or code-related queries
+ *
+ * @module cost/reflex-layer
+ * @version 17.3.0
+ */
+const REFLEX_PATTERNS = [
+    // ─────────────────────────────────────────────────────────────
+    // GREETINGS - Friendly response, no AI needed
+    // ─────────────────────────────────────────────────────────────
+    {
+        name: 'greeting_simple',
+        intent: 'greeting',
+        pattern: /^(hi|hello|hey|yo|sup|hola|howdy|hiya)[\s!.,;:]*$/i,
+        response: `Hello! I'm ready to help with your Flutter project. What would you like to work on?`
+    },
+    {
+        name: 'greeting_morning',
+        intent: 'greeting',
+        pattern: /^good\s*(morning|afternoon|evening|day)[\s!.,;:]*$/i,
+        response: `Good day! I'm ready to assist with your Flutter development. What can I help you build?`
+    },
+    {
+        name: 'greeting_whatsup',
+        intent: 'greeting',
+        pattern: /^(what'?s?\s*up|wh?assup|wassup)[\s!?,;:]*$/i,
+        response: `Hey! Ready to help with your Flutter project. What are we building today?`
+    },
+    // ─────────────────────────────────────────────────────────────
+    // FAREWELLS - Polite goodbye
+    // ─────────────────────────────────────────────────────────────
+    {
+        name: 'farewell',
+        intent: 'farewell',
+        pattern: /^(bye|goodbye|good\s*bye|see\s*ya|later|cya|quit|exit|done)[\s!.,;:]*$/i,
+        response: `Goodbye! Happy coding!`
+    },
+    // ─────────────────────────────────────────────────────────────
+    // THANKS - Acknowledge politely
+    // ─────────────────────────────────────────────────────────────
+    {
+        name: 'thanks',
+        intent: 'affirmation',
+        pattern: /^(thanks?|thank\s*you|thx|ty|cheers|ta|appreciated?)[\s!.,;:]*$/i,
+        response: `You're welcome! Let me know if you need anything else.`
+    },
+    {
+        name: 'thanks_extended',
+        intent: 'affirmation',
+        pattern: /^(thanks?\s*(a\s*lot|so\s*much|very\s*much)|much\s*appreciated)[\s!.,;:]*$/i,
+        response: `You're very welcome! Happy to help anytime.`
+    },
+    // ─────────────────────────────────────────────────────────────
+    // AFFIRMATIONS - No response needed
+    // ─────────────────────────────────────────────────────────────
+    {
+        name: 'affirmation_yes',
+        intent: 'affirmation',
+        pattern: /^(ok|okay|k|got\s*it|understood|sure|yep|yes|yeah|yea|alright|right|cool|nice|great|perfect|awesome|good|fine)[\s!.,;:]*$/i,
+        response: null // Skip - no response needed
+    },
+    {
+        name: 'affirmation_no',
+        intent: 'affirmation',
+        pattern: /^(no|nope|nah|never\s*mind|nevermind|cancel|stop)[\s!.,;:]*$/i,
+        response: null // Skip - no response needed
+    },
+    // ─────────────────────────────────────────────────────────────
+    // EMPTY / WHITESPACE - Skip
+    // ─────────────────────────────────────────────────────────────
+    {
+        name: 'empty',
+        intent: 'affirmation',
+        pattern: /^\s*$/,
+        response: null
+    },
+    // ─────────────────────────────────────────────────────────────
+    // GIBBERISH - Ask for clarification
+    // ─────────────────────────────────────────────────────────────
+    {
+        name: 'gibberish_no_letters',
+        intent: 'gibberish',
+        pattern: /^[^a-zA-Z]{4,}$/,
+        response: `I didn't catch that. Could you describe what you'd like help with?`
+    },
+    {
+        name: 'gibberish_random_long',
+        intent: 'gibberish',
+        pattern: /^[a-zA-Z]{20,}$/, // Very long string with no spaces/punctuation
+        response: `That doesn't look like a question. What would you like to work on?`
+    },
+    {
+        name: 'gibberish_keyboard_smash',
+        intent: 'gibberish',
+        pattern: /^[asdfghjklqwertyuiopzxcvbnm]{8,}$/i, // Keyboard row patterns
+        response: `Looks like a keyboard mishap! What can I help you with?`
+    },
+];
+const COMMAND_HANDLERS = [
+    {
+        command: '/help',
+        aliases: ['/h', '/?', 'help'],
+        description: 'Show help message',
+        handler: () => `
+**DartMind Commands**
+
+**General:**
+\`/help\`     - Show this help message
+\`/status\`   - Show session status and cost
+\`/version\`  - Show DartMind version
+\`/clear\`    - Clear conversation history
+\`/cost\`     - Show detailed cost breakdown
+
+**Model Control:**
+\`/haiku <query>\`   - Force use Haiku (cheapest)
+\`/sonnet <query>\`  - Force use Sonnet (default)
+\`/opus <query>\`    - Force use Opus (most capable)
+
+**Tips for Lower Costs:**
+- Be specific in one message instead of multiple
+- Use \`flutter analyze\` locally before asking AI
+- Batch related requests together
+    `.trim()
+    },
+    {
+        command: '/version',
+        aliases: ['/v', 'version'],
+        description: 'Show version',
+        handler: () => `DartMind V17.3 - Cost Optimized Edition\n\nOptimizations: Reflex Layer, Prompt Caching, Model Routing, Context Scaling`
+    },
+    {
+        command: '/status',
+        aliases: ['/s', 'status'],
+        description: 'Show status',
+        handler: () => `Session active. All optimizations enabled.\n\nUse \`/cost\` for detailed breakdown.`
+    },
+    {
+        command: '/clear',
+        aliases: ['/c', 'clear'],
+        description: 'Clear history',
+        handler: () => `Conversation cleared. Ready for new task.`
+    },
+    {
+        command: '/cost',
+        aliases: ['cost'],
+        description: 'Show cost breakdown',
+        handler: () => `Cost tracking active. Details will appear after requests.`
+    },
+    {
+        command: '/models',
+        aliases: ['/m', 'models'],
+        description: 'Show available models',
+        handler: () => `
+**Available Models:**
+
+| Model | Cost | Best For |
+|-------|------|----------|
+| Haiku 3.5 | $0.80/1M | Simple tasks, reading, explaining |
+| Sonnet 4 | $3.00/1M | Code generation, refactoring |
+| Opus 4 | $15.00/1M | Architecture, complex reasoning |
+
+Use \`/haiku\`, \`/sonnet\`, or \`/opus\` prefix to force a model.
+    `.trim()
+    },
+];
+// ═══════════════════════════════════════════════════════════════
+// SAFETY: PATTERNS THAT SHOULD NEVER BE REFLEXED
+// These ensure we don't accidentally handle real queries locally
+// ═══════════════════════════════════════════════════════════════
+const BYPASS_PATTERNS = [
+    /\?/, // Any question mark = real question
+    /\b(create|build|make|generate|implement|add|write)\b/i, // Generation
+    /\b(fix|debug|solve|resolve|error|bug|issue|problem)\b/i, // Bug fixes
+    /\b(explain|what|how|why|when|where|which)\b.*\b(is|does|do|are|was|were|can|could|should|would)\b/i, // Questions
+    /\b(code|function|class|widget|screen|component|method)\b/i, // Code-related
+    /\b(refactor|convert|migrate|change|update|modify)\b/i, // Modifications
+    /\b(test|spec|unittest)\b/i, // Testing
+    /\b(import|package|dependency|pubspec)\b/i, // Dependencies
+    /\b(flutter|dart|riverpod|bloc|getx|provider)\b/i, // Framework-specific
+    /```/, // Code blocks
+    /\n/, // Multi-line input
+];
+// ═══════════════════════════════════════════════════════════════
+// MAIN FUNCTIONS
+// ═══════════════════════════════════════════════════════════════
+/**
+ * Check if input should bypass reflex layer entirely.
+ * Returns true if the input looks like a real query.
+ */
+export function shouldBypassReflex(input) {
+    const trimmed = input.trim();
+    // Empty is handled by reflex
+    if (!trimmed)
+        return false;
+    // Check bypass patterns
+    for (const pattern of BYPASS_PATTERNS) {
+        if (pattern.test(trimmed)) {
+            return true;
+        }
+    }
+    // Long inputs (>50 chars) are likely real queries
+    if (trimmed.length > 50) {
+        return true;
+    }
+    return false;
+}
+/**
+ * Try to handle input with reflex layer.
+ * Returns handled=true if we can respond locally.
+ * Returns handled=false if we should pass to AI.
+ */
+export function tryReflex(input) {
+    const trimmed = input.trim();
+    const lowerInput = trimmed.toLowerCase();
+    // ─────────────────────────────────────────────────────────────
+    // Check commands first (highest priority)
+    // ─────────────────────────────────────────────────────────────
+    for (const cmd of COMMAND_HANDLERS) {
+        // Exact command match
+        if (lowerInput === cmd.command || cmd.aliases.includes(lowerInput)) {
+            return {
+                handled: true,
+                response: cmd.handler(),
+                reason: `command:${cmd.command}`,
+                cost: 0
+            };
+        }
+        // Command with arguments (e.g., "/help topic")
+        const cmdWithSpace = cmd.command + ' ';
+        if (lowerInput.startsWith(cmdWithSpace)) {
+            const args = trimmed.slice(cmdWithSpace.length);
+            return {
+                handled: true,
+                response: cmd.handler(args),
+                reason: `command:${cmd.command}`,
+                cost: 0
+            };
+        }
+    }
+    // ─────────────────────────────────────────────────────────────
+    // Check reflex patterns
+    // ─────────────────────────────────────────────────────────────
+    for (const { name, pattern, response, intent } of REFLEX_PATTERNS) {
+        if (pattern.test(trimmed)) {
+            return {
+                handled: true,
+                response: response ?? undefined,
+                reason: `pattern:${name}:${intent}`,
+                cost: 0
+            };
+        }
+    }
+    // ─────────────────────────────────────────────────────────────
+    // Not handled - pass to AI
+    // ─────────────────────────────────────────────────────────────
+    return {
+        handled: false,
+        cost: 0
+    };
+}
+/**
+ * Get all available commands (for help/autocomplete)
+ */
+export function getCommands() {
+    return [...COMMAND_HANDLERS];
+}
+/**
+ * Check if input is a model override command
+ * Returns the model tier if found, null otherwise
+ */
+export function checkModelOverride(input) {
+    const trimmed = input.trim();
+    const lower = trimmed.toLowerCase();
+    if (lower.startsWith('/haiku ')) {
+        return { model: 'haiku', query: trimmed.slice(7) };
+    }
+    if (lower.startsWith('/sonnet ')) {
+        return { model: 'sonnet', query: trimmed.slice(8) };
+    }
+    if (lower.startsWith('/opus ')) {
+        return { model: 'opus', query: trimmed.slice(6) };
+    }
+    return null;
+}
+//# sourceMappingURL=reflex-layer.js.map

package/dist/core/cost/reflex-layer.js.map

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

package/dist/core/cost/response-cache.d.ts

@@ -0,0 +1,139 @@
+/**
+ * DartMind V17.3 - Response Caching
+ *
+ * PURPOSE: Cache repeated queries locally to avoid redundant API calls.
+ * COST IMPACT: 5-10% savings on repeated queries within session
+ * QUALITY IMPACT: NONE (identical responses for identical queries)
+ *
+ * CACHING RULES:
+ * - Only cache for specific intents (explain, search, list, simple_qa)
+ * - TTL: 5 minutes (matches Anthropic's prompt cache)
+ * - Max entries: 100 (LRU eviction)
+ * - Only exact query matches (no fuzzy matching)
+ *
+ * SAFETY:
+ * - Code generation NEVER cached (context-dependent)
+ * - Bug fixes NEVER cached (need latest context)
+ * - Refactoring NEVER cached (code may have changed)
+ * - Cache cleared on file modifications
+ *
+ * @module cost/response-cache
+ * @version 17.3.0
+ */
+import { TaskIntent } from './types.js';
+export interface CachedResponse {
+    query: string;
+    response: string;
+    intent: TaskIntent;
+    timestamp: number;
+    hitCount: number;
+}
+export interface ResponseCacheConfig {
+    enabled: boolean;
+    maxEntries: number;
+    ttlMs: number;
+    cacheableIntents: TaskIntent[];
+}
+export declare const DEFAULT_RESPONSE_CACHE_CONFIG: ResponseCacheConfig;
+export declare const UNCACHEABLE_INTENTS: TaskIntent[];
+export declare class ResponseCache {
+    private cache;
+    private config;
+    private stats;
+    constructor(config?: Partial<ResponseCacheConfig>);
+    /**
+     * Get cached response for a query.
+     *
+     * @param query - User query
+     * @param intent - Task intent (for validation)
+     * @returns Cached response or undefined
+     */
+    get(query: string, intent: TaskIntent): string | undefined;
+    /**
+     * Store response in cache.
+     *
+     * @param query - User query
+     * @param response - API response
+     * @param intent - Task intent
+     */
+    set(query: string, response: string, intent: TaskIntent): void;
+    /**
+     * Check if an intent is cacheable.
+     */
+    isCacheableIntent(intent: TaskIntent): boolean;
+    /**
+     * Clear entire cache.
+     */
+    clear(): void;
+    /**
+     * Clear cache entries related to file modifications.
+     * Call this when files are modified to prevent stale cache hits.
+     *
+     * @param filePath - Path of modified file
+     */
+    invalidateForFile(filePath: string): void;
+    /**
+     * Get cache statistics.
+     */
+    getStats(): {
+        hits: number;
+        misses: number;
+        hitRate: number;
+        entries: number;
+        evictions: number;
+        totalSaved: number;
+    };
+    /**
+     * Format cache stats for logging.
+     */
+    formatStats(): string;
+    /**
+     * Reset statistics.
+     */
+    resetStats(): void;
+    /**
+     * Update configuration.
+     */
+    updateConfig(config: Partial<ResponseCacheConfig>): void;
+    /**
+     * Get current configuration.
+     */
+    getConfig(): ResponseCacheConfig;
+    private getKey;
+    private evictLRU;
+    private estimateTokens;
+}
+/**
+ * Default response cache instance.
+ */
+export declare const responseCache: ResponseCache;
+/**
+ * Quick check if a response is cached.
+ */
+export declare function getCachedResponse(query: string, intent: TaskIntent): string | undefined;
+/**
+ * Quick cache a response.
+ */
+export declare function cacheResponse(query: string, response: string, intent: TaskIntent): void;
+/**
+ * Check if an intent allows caching.
+ */
+export declare function isIntentCacheable(intent: TaskIntent): boolean;
+/**
+ * Invalidate cache when a file is modified.
+ */
+export declare function invalidateCacheForFile(filePath: string): void;
+/**
+ * Check if user requested to bypass cache.
+ * Supports: /no-cache, /fresh
+ */
+export declare function checkNoCacheOverride(input: string): {
+    bypass: boolean;
+    query: string;
+} | null;
+/**
+ * Check if user requested to clear cache.
+ * Supports: /clear-cache
+ */
+export declare function checkClearCacheCommand(input: string): boolean;
+//# sourceMappingURL=response-cache.d.ts.map

package/dist/core/cost/response-cache.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"response-cache.d.ts","sourceRoot":"","sources":["../../../src/core/cost/response-cache.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;GAqBG;AAEH,OAAO,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAMxC,MAAM,WAAW,cAAc;IAC7B,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,UAAU,CAAC;IACnB,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,mBAAmB;IAClC,OAAO,EAAE,OAAO,CAAC;IACjB,UAAU,EAAE,MAAM,CAAC;IACnB,KAAK,EAAE,MAAM,CAAC;IACd,gBAAgB,EAAE,UAAU,EAAE,CAAC;CAChC;AAED,eAAO,MAAM,6BAA6B,EAAE,mBAW3C,CAAC;AAGF,eAAO,MAAM,mBAAmB,EAAE,UAAU,EAU3C,CAAC;AAMF,qBAAa,aAAa;IACxB,OAAO,CAAC,KAAK,CAA0C;IACvD,OAAO,CAAC,MAAM,CAAsB;IACpC,OAAO,CAAC,KAAK,CAKX;gBAEU,MAAM,GAAE,OAAO,CAAC,mBAAmB,CAAM;IAIrD;;;;;;OAMG;IACH,GAAG,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,UAAU,GAAG,MAAM,GAAG,SAAS;IAkC1D;;;;;;OAMG;IACH,GAAG,CAAC,KAAK,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,UAAU,GAAG,IAAI;IA0B9D;;OAEG;IACH,iBAAiB,CAAC,MAAM,EAAE,UAAU,GAAG,OAAO;IAK9C;;OAEG;IACH,KAAK,IAAI,IAAI;IAIb;;;;;OAKG;IACH,iBAAiB,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI;IAiBzC;;OAEG;IACH,QAAQ,IAAI;QACV,IAAI,EAAE,MAAM,CAAC;QACb,MAAM,EAAE,MAAM,CAAC;QACf,OAAO,EAAE,MAAM,CAAC;QAChB,OAAO,EAAE,MAAM,CAAC;QAChB,SAAS,EAAE,MAAM,CAAC;QAClB,UAAU,EAAE,MAAM,CAAC;KACpB;IAYD;;OAEG;IACH,WAAW,IAAI,MAAM;IAUrB;;OAEG;IACH,UAAU,IAAI,IAAI;IAIlB;;OAEG;IACH,YAAY,CAAC,MAAM,EAAE,OAAO,CAAC,mBAAmB,CAAC,GAAG,IAAI;IAIxD;;OAEG;IACH,SAAS,IAAI,mBAAmB;IAQhC,OAAO,CAAC,MAAM;IAKd,OAAO,CAAC,QAAQ;IAsBhB,OAAO,CAAC,cAAc;CAGvB;AAMD;;GAEG;AACH,eAAO,MAAM,aAAa,eAAsB,CAAC;AAMjD;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,UAAU,GAAG,MAAM,GAAG,SAAS,CAEvF;AAED;;GAEG;AACH,wBAAgB,aAAa,CAAC,KAAK,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,UAAU,GAAG,IAAI,CAEvF;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,UAAU,GAAG,OAAO,CAE7D;AAED;;GAEG;AACH,wBAAgB,sBAAsB,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI,CAE7D;AAMD;;;GAGG;AACH,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,MAAM,GAAG;IAAE,MAAM,EAAE,OAAO,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,GAAG,IAAI,CAa7F;AAED;;;GAGG;AACH,wBAAgB,sBAAsB,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAE7D"}