modular-studio 1.0.5 → 1.1.0

package/dist-server/server/services/repoIndexer.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"repoIndexer.d.ts","sourceRoot":"","sources":["../../../server/services/repoIndexer.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;GAqBG;AAOH,MAAM,WAAW,QAAQ;IACvB,IAAI,EAAE,MAAM,CAAC;IACb,GAAG,EAAE,MAAM,CAAC;IACZ,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,YAAY,CAAC;IACvB,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,SAAS,EAAE,MAAM,EAAE,CAAC;IACpB,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,KAAK,EAAE,MAAM,EAAE,CAAC;CACjB;AAED,MAAM,MAAM,YAAY,GACpB,WAAW,GACX,OAAO,GACP,SAAS,GACT,MAAM,GACN,OAAO,GACP,QAAQ,GACR,MAAM,GACN,MAAM,GACN,OAAO,GACP,KAAK,GACL,QAAQ,GACR,OAAO,CAAC;AAEZ,MAAM,WAAW,UAAU;IACzB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,QAAQ,EAAE,CAAC;IAClB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB,UAAU,EAAE,MAAM,EAAE,CAAC;IACrB,OAAO,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC,CAAC;CAChC;AAED,MAAM,WAAW,QAAQ;IACvB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,QAAQ,EAAE,CAAC;IAClB,OAAO,EAAE,UAAU,EAAE,CAAC;IACtB,QAAQ,EAAE,WAAW,EAAE,CAAC;IACxB,WAAW,EAAE,cAAc,EAAE,CAAC;IAC9B,KAAK,EAAE,SAAS,CAAC;IACjB,UAAU,EAAE,MAAM,CAAC;IACnB,WAAW,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,cAAc;IAC7B,OAAO,EAAE,MAAM,CAAC;IAChB,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,EAAE,MAAM,EAAE,CAAC;CACpB;AAED,MAAM,WAAW,SAAS;IACxB,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;IAClB,eAAe,EAAE,MAAM,CAAC;IACxB,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;IAClB,cAAc,EAAE,MAAM,CAAC;CACxB;AA6RD,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,QAAQ,CAoErD;AAID;;GAEG;AACH,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,QAAQ,GAAG,MAAM,CAsD1D;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,QAAQ,EAAE,OAAO,EAAE,WAAW,GAAG,MAAM,CA+D/E;AAED;;GAEG;AACH,wBAAgB,qBAAqB,CAAC,IAAI,EAAE,QAAQ,GAAG,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAezE"}
+{"version":3,"file":"repoIndexer.d.ts","sourceRoot":"","sources":["../../../server/services/repoIndexer.ts"],"names":[],"mappings":"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"}

package/dist-server/server/services/repoIndexer.js

@@ -34,6 +34,22 @@ const CODE_EXTENSIONS = new Set([
 ]);
 const MAX_FILE_SIZE = 100_000; // 100KB
 const MAX_FILES = 2000;
+// ── Feature Clustering Constants ──
+const GENERIC_DIRS = new Set([
+    'src', 'lib', 'app', 'server', 'client', 'api',
+    'services', 'service', 'store', 'stores', 'state',
+    'components', 'component', 'pages', 'page', 'views', 'view',
+    'routes', 'route', 'controllers', 'controller',
+    'utils', 'util', 'helpers', 'helper', 'common', 'shared',
+    'models', 'model', 'types', 'interfaces',
+    'panels', 'panel', 'tabs', 'tab', 'layouts', 'layout',
+    'middleware', 'middlewares', 'guards', 'pipes',
+    'config', 'configs', 'constants',
+    'hooks', 'composables', 'providers',
+    'assets', 'static', 'public',
+    '__tests__', '__mocks__', 'test', 'tests', 'spec', 'specs',
+]);
+const FUNCTIONAL_SUFFIXES = /(?:Service|Store|Controller|Route|Router|Form|Panel|Component|View|Page|Tab|Utils?|Helpers?|Handler|Manager|Provider|Factory|Adapter|Middleware|Guard|Pipe|Module|Config|Spec|Test|Mock|Fixture|Schema|Model|Entity|DTO|Repository|Gateway|Client|Api|Hook|Composable|Plugin|Decorator|Interceptor|Filter|Resolver|Validator|Transformer|Mapper|Builder|Strategy|Observer|Subscriber|Listener|Worker|Job|Task|Queue|Cache|Logger|Monitor|Migration|Seed|Index)$/;
 // ── Scanner ──
 function categorizeFile(path, content) {
     const base = basename(path).toLowerCase();
@@ -218,62 +234,259 @@ function detectConventions(files) {
     }
     return conventions;
 }
-/**
- * Cluster files into feature groups based on import relationships and directory structure.
- */
-function clusterFeatures(files, modules) {
-    const features = [];
-    // Group by top-level directory as initial clusters
-    const dirGroups = new Map();
+// ── Feature Clustering Helpers ──
+function extractDomainStem(filePath) {
+    const parts = filePath.replace(/\\/g, '/').split('/');
+    const fileName = parts[parts.length - 1];
+    const baseName = fileName.replace(/\.[^.]+$/, ''); // strip extension
+    // Find last non-generic directory
+    let specificDir = '';
+    for (let i = parts.length - 2; i >= 0; i--) {
+        const dir = parts[i].toLowerCase().replace(/[-_]/g, '');
+        if (!GENERIC_DIRS.has(dir) && dir.length > 1) {
+            specificDir = parts[i];
+            break;
+        }
+    }
+    // Strip functional suffix from filename
+    const strippedName = baseName.replace(FUNCTIONAL_SUFFIXES, '');
+    // If filename is generic (index, main, app, types, utils), use directory
+    const GENERIC_NAMES = new Set(['index', 'main', 'app', 'types', 'utils', 'helpers', 'constants', 'config', 'mod']);
+    const nameToUse = GENERIC_NAMES.has(strippedName.toLowerCase()) && specificDir
+        ? specificDir
+        : strippedName;
+    // Normalize: camelCase/PascalCase → kebab → lower
+    return nameToUse
+        .replace(/([a-z])([A-Z])/g, '$1-$2') // camelCase → kebab
+        .replace(/[-_]+/g, '-')
+        .replace(/\bv\d+$/, '') // strip version suffix (v2, v3)
+        .toLowerCase()
+        .replace(/-+$/, '');
+}
+function resolveImportPath(fromFile, importPath, allFiles) {
+    if (!importPath.startsWith('.'))
+        return null; // skip node_modules
+    const fromDir = fromFile.split('/').slice(0, -1).join('/');
+    let resolved = importPath;
+    // Resolve relative path
+    if (resolved.startsWith('./'))
+        resolved = resolved.slice(2);
+    if (resolved.startsWith('../')) {
+        const parts = fromDir.split('/');
+        for (const seg of resolved.split('/')) {
+            if (seg === '..')
+                parts.pop();
+            else if (seg !== '.')
+                parts.push(seg);
+        }
+        resolved = parts.join('/');
+    }
+    else {
+        resolved = fromDir ? fromDir + '/' + resolved : resolved;
+    }
+    // Try exact match, then with extensions
+    const candidates = [resolved, resolved + '.ts', resolved + '.tsx', resolved + '.js', resolved + '.jsx', resolved + '/index.ts', resolved + '/index.js'];
+    for (const c of candidates) {
+        if (allFiles.some(f => f.path === c))
+            return c;
+    }
+    return null;
+}
+function humanizeStem(stem) {
+    return stem
+        .replace(/-/g, ' ')
+        .replace(/\b\w/g, c => c.toUpperCase());
+}
+function clusterByDomainAndImports(files) {
+    // A) Seed clusters by domain stem
+    const stemMap = new Map();
     for (const f of files) {
-        if (f.category === 'test' || f.category === 'config' || f.category === 'style')
+        if (f.category === 'config' || f.category === 'style')
             continue;
-        const topDir = f.path.split('/')[0] || 'root';
-        if (!dirGroups.has(topDir))
-            dirGroups.set(topDir, []);
-        dirGroups.get(topDir).push(f);
+        const stem = extractDomainStem(f.path);
+        if (!stemMap.has(stem))
+            stemMap.set(stem, []);
+        stemMap.get(stem).push(f);
     }
-    // For each meaningful group, create a feature
-    for (const [dir, groupFiles] of dirGroups) {
-        if (groupFiles.length < 2)
+    // B) Build reverse import index: file path → which files import it
+    const importedBy = new Map();
+    for (const f of files) {
+        for (const imp of f.imports) {
+            const resolved = resolveImportPath(f.path, imp, files);
+            if (!resolved)
+                continue;
+            if (!importedBy.has(resolved))
+                importedBy.set(resolved, new Set());
+            importedBy.get(resolved).add(f.path);
+        }
+    }
+    // C) Absorb orphans: files in clusters of size 1
+    //    If imported by ≥2 files from the same cluster → join that cluster
+    const orphanStems = [...stemMap.entries()].filter(([, fs]) => fs.length === 1);
+    for (const [stem, [orphan]] of orphanStems) {
+        const importers = importedBy.get(orphan.path);
+        if (!importers)
             continue;
-        const stores = groupFiles.filter(f => f.category === 'store');
-        const routes = groupFiles.filter(f => f.category === 'route');
-        const components = groupFiles.filter(f => f.category === 'component');
-        // const services = groupFiles.filter(f => f.category === 'service');
-        // Build import graph within feature
+        // Count how many files from each OTHER cluster import this orphan
+        const clusterHits = new Map();
+        for (const importerPath of importers) {
+            for (const [otherStem, otherFiles] of stemMap) {
+                if (otherStem === stem)
+                    continue;
+                if (otherFiles.some(f => f.path === importerPath)) {
+                    clusterHits.set(otherStem, (clusterHits.get(otherStem) ?? 0) + 1);
+                }
+            }
+        }
+        // Join the cluster with most imports (≥2 threshold)
+        let bestCluster = '';
+        let bestCount = 1; // threshold: needs ≥2
+        for (const [cs, count] of clusterHits) {
+            if (count > bestCount) {
+                bestCluster = cs;
+                bestCount = count;
+            }
+        }
+        if (bestCluster) {
+            stemMap.get(bestCluster).push(orphan);
+            stemMap.delete(stem);
+        }
+    }
+    return stemMap;
+}
+function buildFeatures(stemMap, allFiles) {
+    const features = [];
+    const sharedFiles = [];
+    // A) Merge micro-clusters (<3 files)
+    const microStems = [...stemMap.entries()].filter(([, fs]) => fs.length < 3);
+    for (const [stem, fs] of microStems) {
+        // Find most-connected larger cluster
+        let bestTarget = '';
+        let bestConnections = 0;
+        for (const [otherStem, otherFiles] of stemMap) {
+            if (otherStem === stem || otherFiles.length < 3)
+                continue;
+            let connections = 0;
+            for (const f of fs) {
+                for (const imp of f.imports) {
+                    const resolved = resolveImportPath(f.path, imp, allFiles);
+                    if (resolved && otherFiles.some(of => of.path === resolved))
+                        connections++;
+                }
+            }
+            if (connections > bestConnections) {
+                bestTarget = otherStem;
+                bestConnections = connections;
+            }
+        }
+        if (bestTarget) {
+            stemMap.get(bestTarget).push(...fs);
+        }
+        else {
+            sharedFiles.push(...fs);
+        }
+        stemMap.delete(stem);
+    }
+    // Add "shared" cluster if any orphans remain
+    if (sharedFiles.length > 0) {
+        stemMap.set('shared', sharedFiles);
+    }
+    // B) Build RepoFeature for each cluster
+    for (const [stem, clusterFiles] of stemMap) {
+        if (clusterFiles.length === 0)
+            continue;
+        // Compute import fan-in within cluster
+        const fanIn = new Map();
+        for (const f of clusterFiles) {
+            for (const imp of f.imports) {
+                const resolved = resolveImportPath(f.path, imp, allFiles);
+                if (resolved && clusterFiles.some(cf => cf.path === resolved)) {
+                    fanIn.set(resolved, (fanIn.get(resolved) ?? 0) + 1);
+                }
+            }
+        }
+        const keyFiles = [...clusterFiles]
+            .sort((a, b) => (fanIn.get(b.path) ?? 0) - (fanIn.get(a.path) ?? 0))
+            .slice(0, 5)
+            .map(f => f.path);
+        // Internal imports
         const internalImports = new Map();
-        for (const f of groupFiles) {
-            const deps = f.imports.filter(imp => !imp.startsWith('@') && !imp.startsWith('node:') && imp.startsWith('.'));
+        for (const f of clusterFiles) {
+            const deps = f.imports
+                .map(imp => resolveImportPath(f.path, imp, allFiles))
+                .filter((r) => r !== null && clusterFiles.some(cf => cf.path === r));
             if (deps.length > 0)
                 internalImports.set(f.path, deps);
         }
-        // Find key files (most imported within the group)
-        const importCounts = new Map();
-        for (const f of groupFiles) {
+        // Cross-feature deps
+        const crossDeps = new Set();
+        for (const f of clusterFiles) {
             for (const imp of f.imports) {
-                const resolved = imp.replace(/^\.\//, `${dir}/`);
-                importCounts.set(resolved, (importCounts.get(resolved) || 0) + 1);
+                const resolved = resolveImportPath(f.path, imp, allFiles);
+                if (!resolved)
+                    continue;
+                if (clusterFiles.some(cf => cf.path === resolved))
+                    continue; // internal
+                // Find which feature owns this file
+                for (const [otherStem, otherFiles] of stemMap) {
+                    if (otherStem === stem)
+                        continue;
+                    if (otherFiles.some(of => of.path === resolved)) {
+                        crossDeps.add(humanizeStem(otherStem));
+                    }
+                }
             }
         }
-        const keyFiles = groupFiles
-            .sort((a, b) => (importCounts.get(b.path) || 0) - (importCounts.get(a.path) || 0))
-            .slice(0, 10)
-            .map(f => f.path);
-        const feature = {
-            name: humanizeDirName(dir),
-            description: '', // filled by LLM later
-            modules: modules.filter(m => m.path.startsWith(dir)).map(m => m.path),
+        features.push({
+            name: humanizeStem(stem),
+            domainStem: stem,
+            description: '',
+            files: clusterFiles.map(f => f.path),
             keyFiles,
-            stores: stores.map(f => f.path),
-            routes: routes.map(f => f.path),
-            components: components.map(f => f.path),
+            stores: clusterFiles.filter(f => f.category === 'store').map(f => f.path),
+            routes: clusterFiles.filter(f => f.category === 'route').map(f => f.path),
+            components: clusterFiles.filter(f => f.category === 'component').map(f => f.path),
+            services: clusterFiles.filter(f => f.category === 'service').map(f => f.path),
+            tests: clusterFiles.filter(f => f.category === 'test').map(f => f.path),
             imports: internalImports,
+            crossFeatureDeps: [...crossDeps],
+            fileCount: clusterFiles.length,
+            tokenCount: clusterFiles.reduce((sum, f) => sum + f.tokens, 0),
+        });
+    }
+    // Cap at 50 features, merge smallest
+    features.sort((a, b) => b.fileCount - a.fileCount);
+    if (features.length > 50) {
+        const kept = features.slice(0, 49);
+        const merged = features.slice(49);
+        const overflow = {
+            name: 'Other',
+            domainStem: 'other',
+            description: `${merged.length} small feature clusters merged`,
+            files: merged.flatMap(f => f.files),
+            keyFiles: merged.flatMap(f => f.keyFiles).slice(0, 5),
+            stores: merged.flatMap(f => f.stores),
+            routes: merged.flatMap(f => f.routes),
+            components: merged.flatMap(f => f.components),
+            services: merged.flatMap(f => f.services),
+            tests: merged.flatMap(f => f.tests),
+            imports: new Map(),
+            crossFeatureDeps: [],
+            fileCount: merged.reduce((s, f) => s + f.fileCount, 0),
+            tokenCount: merged.reduce((s, f) => s + f.tokenCount, 0),
         };
-        features.push(feature);
+        kept.push(overflow);
+        return kept;
     }
     return features;
 }
+/**
+ * Cluster files into feature groups using a 3-pass domain+import algorithm.
+ */
+function clusterFeatures(files, _modules) {
+    const stemMap = clusterByDomainAndImports(files);
+    return buildFeatures(stemMap, files);
+}
 function humanizeDirName(dir) {
     return dir
         .replace(/^src\//, '')
@@ -415,16 +628,15 @@ export function generateOverviewDoc(scan) {
         }
     }
     // Feature list
-    lines.push(`## Features`);
+    lines.push(`## Features (${scan.features.length} clusters)`);
+    lines.push('');
     for (const f of scan.features) {
-        lines.push(`### ${f.name}`);
-        lines.push(`Key files: ${f.keyFiles.slice(0, 5).join(', ')}`);
-        if (f.stores.length)
-            lines.push(`Stores: ${f.stores.join(', ')}`);
-        if (f.components.length)
-            lines.push(`Components: ${f.components.length} files`);
-        if (f.routes.length)
-            lines.push(`Routes: ${f.routes.join(', ')}`);
+        const tokK = (f.tokenCount / 1000).toFixed(1);
+        lines.push(`### ${f.name} (${f.fileCount} files · ~${tokK}K tokens)`);
+        if (f.keyFiles.length > 0)
+            lines.push(`Key: ${f.keyFiles.map(p => p.split('/').pop()).join(', ')}`);
+        if (f.crossFeatureDeps.length > 0)
+            lines.push(`Deps: ${f.crossFeatureDeps.join(', ')}`);
         lines.push('');
     }
     return lines.join('\n');
@@ -434,59 +646,48 @@ export function generateOverviewDoc(scan) {
  */
 export function generateFeatureDoc(scan, feature) {
     const lines = [];
+    const tokK = (feature.tokenCount / 1000).toFixed(1);
     lines.push(`# Feature: ${feature.name}`);
+    lines.push(`${feature.fileCount} files · ~${tokK}K tokens`);
     lines.push('');
+    // Key Files
+    if (feature.keyFiles.length > 0) {
+        lines.push(`## Key Files`);
+        for (const fp of feature.keyFiles) {
+            const file = scan.files.find(f => f.path === fp);
+            if (file) {
+                const symbols = [...file.exports, ...file.functions.slice(0, 5)].filter(Boolean).slice(0, 8);
+                const symStr = symbols.length > 0 ? ` — ${symbols.join(', ')}` : '';
+                lines.push(`- ${basename(fp)} (${file.category})${symStr}`);
+            }
+        }
+        lines.push('');
+    }
+    // Architecture
     lines.push(`## Architecture`);
-    lines.push(`This feature spans ${feature.keyFiles.length} key files across ${feature.modules.length} module(s).`);
+    if (feature.stores.length > 0)
+        lines.push(`- Stores: ${feature.stores.map(p => basename(p)).join(', ')}`);
+    if (feature.routes.length > 0)
+        lines.push(`- Routes: ${feature.routes.map(p => basename(p)).join(', ')}`);
+    if (feature.services.length > 0)
+        lines.push(`- Services: ${feature.services.map(p => basename(p)).join(', ')}`);
+    if (feature.components.length > 0)
+        lines.push(`- Components: ${feature.components.map(p => basename(p)).join(', ')}`);
+    if (feature.tests.length > 0)
+        lines.push(`- Tests: ${feature.tests.map(p => basename(p)).join(', ')}`);
     lines.push('');
-    lines.push(`## Key Files`);
-    for (const fp of feature.keyFiles) {
-        const file = scan.files.find(f => f.path === fp);
-        if (file) {
-            const symbols = [...file.exports, ...file.functions.slice(0, 5)].slice(0, 8);
-            lines.push(`### ${fp}`);
-            lines.push(`- Category: ${file.category}`);
-            lines.push(`- Size: ${file.size} bytes (~${file.tokens} tokens)`);
-            if (symbols.length > 0)
-                lines.push(`- Exports: \`${symbols.join('`, `')}\``);
-            if (file.classes.length > 0)
-                lines.push(`- Classes: \`${file.classes.join('`, `')}\``);
-            if (file.types.length > 0)
-                lines.push(`- Types: \`${file.types.join('`, `')}\``);
-            lines.push('');
-        }
+    // Dependencies
+    if (feature.crossFeatureDeps.length > 0) {
+        lines.push(`## Dependencies`);
+        lines.push(`- Imports from: ${feature.crossFeatureDeps.join(', ')}`);
+        lines.push('');
     }
-    // Import graph
+    // Internal Data Flow
     if (feature.imports.size > 0) {
-        lines.push(`## Data Flow`);
-        lines.push('Internal import relationships:');
-        lines.push('');
+        lines.push(`## Internal Data Flow`);
         for (const [file, deps] of feature.imports) {
-            lines.push(`- \`${file}\` → ${deps.map(d => `\`${d}\``).join(', ')}`);
-        }
-        lines.push('');
-    }
-    // Stores
-    if (feature.stores.length > 0) {
-        lines.push(`## State Management`);
-        for (const sp of feature.stores) {
-            const file = scan.files.find(f => f.path === sp);
-            if (file) {
-                lines.push(`### ${basename(sp)}`);
-                lines.push(`- Path: ${sp}`);
-                if (file.exports.length > 0)
-                    lines.push(`- Actions/Selectors: \`${file.exports.join('`, `')}\``);
-                lines.push('');
-            }
-        }
-    }
-    // Components
-    if (feature.components.length > 0) {
-        lines.push(`## Components`);
-        for (const cp of feature.components.slice(0, 10)) {
-            const file = scan.files.find(f => f.path === cp);
-            if (file) {
-                lines.push(`- \`${cp}\` — exports: ${file.exports.slice(0, 3).map(e => `\`${e}\``).join(', ') || 'default'}`);
+            for (const dep of deps) {
+                lines.push(`${basename(file)} → ${basename(dep)}`);
             }
         }
         lines.push('');

package/dist-server/server/services/responseCache.d.ts

@@ -0,0 +1,24 @@
+export interface CachedResponse {
+    id: string;
+    queryHash: string;
+    queryEmbedding: number[] | null;
+    query: string;
+    response: string;
+    model: string;
+    agentId: string;
+    systemPromptHash: string;
+    createdAt: number;
+    hitCount: number;
+    ttl: number;
+}
+export declare function checkCache(query: string, agentId: string, model: string, systemPromptHash: string, _ttlSeconds?: number): Promise<CachedResponse | null>;
+export declare function storeResponse(query: string, response: string, agentId: string, model: string, systemPromptHash: string, ttlSeconds?: number): Promise<void>;
+export declare function evictExpired(): Promise<void>;
+export declare function evictLRU(maxEntries?: number): Promise<void>;
+export declare function getCacheStats(): Promise<{
+    totalEntries: number;
+    hitRate: number;
+    estimatedSavings: number;
+}>;
+export declare function purgeCache(agentId?: string): Promise<void>;
+//# sourceMappingURL=responseCache.d.ts.map

package/dist-server/server/services/responseCache.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"responseCache.d.ts","sourceRoot":"","sources":["../../../server/services/responseCache.ts"],"names":[],"mappings":"AAIA,MAAM,WAAW,cAAc;IAC7B,EAAE,EAAE,MAAM,CAAC;IACX,SAAS,EAAE,MAAM,CAAC;IAClB,cAAc,EAAE,MAAM,EAAE,GAAG,IAAI,CAAC;IAChC,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;IAChB,gBAAgB,EAAE,MAAM,CAAC;IACzB,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,MAAM,CAAC;IACjB,GAAG,EAAE,MAAM,CAAC;CACb;AAwDD,wBAAsB,UAAU,CAC9B,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,gBAAgB,EAAE,MAAM,EAAE,WAAW,SAAO,GAC1F,OAAO,CAAC,cAAc,GAAG,IAAI,CAAC,CAgEhC;AAED,wBAAsB,aAAa,CACjC,KAAK,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAC/D,gBAAgB,EAAE,MAAM,EAAE,UAAU,SAAO,GAC1C,OAAO,CAAC,IAAI,CAAC,CAoBf;AAED,wBAAsB,YAAY,IAAI,OAAO,CAAC,IAAI,CAAC,CAKlD;AAED,wBAAsB,QAAQ,CAAC,UAAU,SAAO,GAAG,OAAO,CAAC,IAAI,CAAC,CAa/D;AAED,wBAAsB,aAAa,IAAI,OAAO,CAAC;IAAE,YAAY,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAC;IAAC,gBAAgB,EAAE,MAAM,CAAA;CAAE,CAAC,CAUlH;AAED,wBAAsB,UAAU,CAAC,OAAO,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAQhE"}

package/dist-server/server/services/responseCache.js

@@ -0,0 +1,163 @@
+import { createHash } from 'node:crypto';
+import { getDb, saveDb } from './sqliteStore.js';
+import embeddingService from './embeddingService.js';
+function toStr(v) { return typeof v === 'string' ? v : ''; }
+function toNum(v) { return typeof v === 'number' ? v : 0; }
+function normalizeQuery(q) {
+    return q.trim().toLowerCase().replace(/\s+/g, ' ');
+}
+function sha256(text) {
+    return createHash('sha256').update(text, 'utf8').digest('hex');
+}
+function levenshtein(a, b) {
+    const prev = Array.from({ length: b.length + 1 }, (_, j) => j);
+    const curr = new Array(b.length + 1).fill(0);
+    for (let i = 1; i <= a.length; i++) {
+        curr[0] = i;
+        for (let j = 1; j <= b.length; j++) {
+            curr[j] = a[i - 1] === b[j - 1] ? prev[j - 1] : 1 + Math.min(prev[j], curr[j - 1], prev[j - 1]);
+        }
+        prev.splice(0, b.length + 1, ...curr);
+    }
+    return prev[b.length];
+}
+function blobToVec(v) {
+    if (!(v instanceof Uint8Array))
+        return null;
+    return Array.from(new Float32Array(v.buffer, v.byteOffset, v.byteLength / 4));
+}
+function rowToCache(row) {
+    return {
+        id: toStr(row[0]),
+        queryHash: toStr(row[1]),
+        queryEmbedding: blobToVec(row[2]),
+        query: toStr(row[3]),
+        response: toStr(row[4]),
+        model: toStr(row[5]),
+        agentId: toStr(row[6]),
+        systemPromptHash: toStr(row[7]),
+        createdAt: toNum(row[8]),
+        hitCount: toNum(row[9]),
+        ttl: toNum(row[10]),
+    };
+}
+async function markHit(id) {
+    const d = await getDb();
+    const now = Math.floor(Date.now() / 1000);
+    d.run(`UPDATE response_cache SET hit_count = hit_count + 1, last_hit_at = ? WHERE id = ?`, [now, id]);
+    saveDb();
+}
+export async function checkCache(query, agentId, model, systemPromptHash, _ttlSeconds = 3600) {
+    const d = await getDb();
+    const now = Math.floor(Date.now() / 1000);
+    const norm = normalizeQuery(query);
+    const qHash = sha256(norm + agentId + model + systemPromptHash);
+    // Tier 1: exact hash match
+    const exact = d.exec(`SELECT id,query_hash,query_embedding,query,response,model,agent_id,system_prompt_hash,created_at,hit_count,ttl
+     FROM response_cache WHERE query_hash=? AND agent_id=? AND model=? AND system_prompt_hash=?
+     AND (ttl=0 OR created_at+ttl>?) LIMIT 1`, [qHash, agentId, model, systemPromptHash, now]);
+    if (exact.length > 0 && exact[0].values.length > 0) {
+        const hit = rowToCache(exact[0].values[0]);
+        await markHit(hit.id);
+        return hit;
+    }
+    // Tier 2: Levenshtein distance < 10% of query length
+    const threshold = Math.max(3, Math.floor(norm.length * 0.1));
+    const recent = d.exec(`SELECT id,query_hash,query_embedding,query,response,model,agent_id,system_prompt_hash,created_at,hit_count,ttl
+     FROM response_cache WHERE agent_id=? AND model=? AND system_prompt_hash=? AND (ttl=0 OR created_at+ttl>?)
+     ORDER BY created_at DESC LIMIT 200`, [agentId, model, systemPromptHash, now]);
+    if (recent.length > 0) {
+        for (const row of recent[0].values) {
+            if (levenshtein(norm, normalizeQuery(toStr(row[3]))) <= threshold) {
+                const hit = rowToCache(row);
+                await markHit(hit.id);
+                return hit;
+            }
+        }
+    }
+    // Tier 3: cosine similarity > 0.92 using embeddings
+    try {
+        const [queryVec] = await embeddingService.embedBatch([norm]);
+        const withEmb = d.exec(`SELECT id,query_hash,query_embedding,query,response,model,agent_id,system_prompt_hash,created_at,hit_count,ttl
+       FROM response_cache WHERE agent_id=? AND model=? AND system_prompt_hash=?
+       AND query_embedding IS NOT NULL AND (ttl=0 OR created_at+ttl>?) ORDER BY created_at DESC LIMIT 500`, [agentId, model, systemPromptHash, now]);
+        if (withEmb.length > 0) {
+            let bestScore = 0;
+            let bestRow = null;
+            for (const row of withEmb[0].values) {
+                const vec = blobToVec(row[2]);
+                if (!vec)
+                    continue;
+                const score = embeddingService.similarity(queryVec, vec);
+                if (score > bestScore) {
+                    bestScore = score;
+                    bestRow = row;
+                }
+            }
+            if (bestScore > 0.92 && bestRow) {
+                const hit = rowToCache(bestRow);
+                await markHit(hit.id);
+                return hit;
+            }
+        }
+    }
+    catch { /* embedding service unavailable — skip tier 3 */ }
+    return null;
+}
+export async function storeResponse(query, response, agentId, model, systemPromptHash, ttlSeconds = 3600) {
+    const d = await getDb();
+    const norm = normalizeQuery(query);
+    const qHash = sha256(norm + agentId + model + systemPromptHash);
+    const id = `rc-${Date.now()}-${Math.random().toString(36).slice(2, 8)}`;
+    const now = Math.floor(Date.now() / 1000);
+    let embeddingBlob = null;
+    try {
+        const [vec] = await embeddingService.embedBatch([norm]);
+        embeddingBlob = Buffer.from(new Float32Array(vec).buffer);
+    }
+    catch { /* skip embedding if unavailable */ }
+    d.run(`INSERT OR REPLACE INTO response_cache
+     (id,query_hash,query_embedding,query,response,model,agent_id,system_prompt_hash,created_at,hit_count,last_hit_at,ttl)
+     VALUES (?,?,?,?,?,?,?,?,?,0,?,?)`, [id, qHash, embeddingBlob, norm, response, model, agentId, systemPromptHash, now, now, ttlSeconds]);
+    saveDb();
+}
+export async function evictExpired() {
+    const d = await getDb();
+    const now = Math.floor(Date.now() / 1000);
+    d.run(`DELETE FROM response_cache WHERE ttl > 0 AND created_at + ttl <= ?`, [now]);
+    saveDb();
+}
+export async function evictLRU(maxEntries = 1000) {
+    const d = await getDb();
+    const agents = d.exec(`SELECT DISTINCT agent_id FROM response_cache`);
+    if (agents.length === 0)
+        return;
+    for (const row of agents[0].values) {
+        const aid = toStr(row[0]);
+        d.run(`DELETE FROM response_cache WHERE agent_id=? AND id NOT IN
+       (SELECT id FROM response_cache WHERE agent_id=? ORDER BY last_hit_at DESC LIMIT ?)`, [aid, aid, maxEntries]);
+    }
+    saveDb();
+}
+export async function getCacheStats() {
+    const d = await getDb();
+    const r = d.exec(`SELECT COUNT(*), COALESCE(SUM(hit_count),0), COALESCE(SUM(CAST(LENGTH(response) AS REAL)/4*hit_count),0) FROM response_cache`);
+    if (r.length === 0 || r[0].values.length === 0)
+        return { totalEntries: 0, hitRate: 0, estimatedSavings: 0 };
+    const row = r[0].values[0];
+    const totalEntries = toNum(row[0]);
+    const totalHits = toNum(row[1]);
+    const estimatedSavings = toNum(row[2]) * 0.000015;
+    const hitRate = totalHits + totalEntries > 0 ? totalHits / (totalHits + totalEntries) : 0;
+    return { totalEntries, hitRate, estimatedSavings };
+}
+export async function purgeCache(agentId) {
+    const d = await getDb();
+    if (agentId) {
+        d.run(`DELETE FROM response_cache WHERE agent_id = ?`, [agentId]);
+    }
+    else {
+        d.run(`DELETE FROM response_cache`);
+    }
+    saveDb();
+}