@kernel.chat/kbot 2.3.0 → 2.4.0

package/dist/cloud-sync.js

@@ -0,0 +1,184 @@
+// K:BOT Cloud Sync — Persist learning data across machines via kbot-engine
+//
+// Syncs patterns, solutions, profile, and knowledge to the cloud.
+// Pull on startup (if cloud has newer data), push after learning.
+// Requires a kernel.chat account token in config.
+import { homedir } from 'node:os';
+import { join } from 'node:path';
+import { existsSync, readFileSync, writeFileSync } from 'node:fs';
+import { loadConfig, saveConfig } from './auth.js';
+const KBOT_DIR = join(homedir(), '.kbot');
+const LEARN_DIR = join(KBOT_DIR, 'memory');
+const SYNC_STATE_FILE = join(LEARN_DIR, 'sync-state.json');
+const ENGINE_URL = 'https://eoxxpyixdieprsxlpwcs.supabase.co/functions/v1/kbot-engine';
+function loadSyncState() {
+    try {
+        if (existsSync(SYNC_STATE_FILE)) {
+            return JSON.parse(readFileSync(SYNC_STATE_FILE, 'utf-8'));
+        }
+    }
+    catch { /* fresh state */ }
+    return { lastPush: '', lastPull: '', cloudUpdatedAt: '' };
+}
+function saveSyncState(state) {
+    try {
+        writeFileSync(SYNC_STATE_FILE, JSON.stringify(state, null, 2));
+    }
+    catch { /* non-critical */ }
+}
+/** Get the kernel.chat token from config */
+export function getCloudToken() {
+    const config = loadConfig();
+    return config?.kernel_token || null;
+}
+/** Set the kernel.chat token */
+export function setCloudToken(token) {
+    const config = loadConfig() || { default_model: 'auto', default_agent: 'auto' };
+    config.kernel_token = token;
+    saveConfig(config);
+}
+/** Check if cloud sync is configured */
+export function isCloudSyncEnabled() {
+    return !!getCloudToken();
+}
+/** Load local learning data files */
+function loadLocalData() {
+    const load = (file) => {
+        const path = join(LEARN_DIR, file);
+        try {
+            if (existsSync(path))
+                return JSON.parse(readFileSync(path, 'utf-8'));
+        }
+        catch { /* return default */ }
+        return file.endsWith('.json') ? (file.includes('patterns') || file.includes('solutions') || file.includes('knowledge') ? [] : {}) : {};
+    };
+    return {
+        patterns: load('patterns.json'),
+        solutions: load('solutions.json'),
+        profile: load('profile.json'),
+        knowledge: load('knowledge.json'),
+    };
+}
+/** Save cloud data to local files */
+function saveCloudDataLocally(data) {
+    const save = (file, content) => {
+        if (content && (Array.isArray(content) ? content.length > 0 : Object.keys(content).length > 0)) {
+            writeFileSync(join(LEARN_DIR, file), JSON.stringify(content, null, 2));
+        }
+    };
+    if (data.patterns)
+        save('patterns.json', data.patterns);
+    if (data.solutions)
+        save('solutions.json', data.solutions);
+    if (data.profile)
+        save('profile.json', data.profile);
+    if (data.knowledge)
+        save('knowledge.json', data.knowledge);
+}
+/** Pull learning data from cloud (if newer than local) */
+export async function pullFromCloud() {
+    const token = getCloudToken();
+    if (!token)
+        return { synced: false, source: 'none' };
+    try {
+        const res = await fetch(`${ENGINE_URL}/sync`, {
+            method: 'POST',
+            headers: {
+                'Content-Type': 'application/json',
+                'Authorization': `Bearer ${token}`,
+            },
+            body: JSON.stringify({ action: 'get' }),
+            signal: AbortSignal.timeout(10_000),
+        });
+        if (!res.ok)
+            return { synced: false, source: 'none' };
+        const { memory } = await res.json();
+        if (!memory)
+            return { synced: false, source: 'none' };
+        const state = loadSyncState();
+        const cloudTime = new Date(memory.updated_at || 0).getTime();
+        const lastPull = state.lastPull ? new Date(state.lastPull).getTime() : 0;
+        // Only overwrite local if cloud is newer than our last pull
+        if (cloudTime > lastPull) {
+            saveCloudDataLocally(memory);
+            state.lastPull = new Date().toISOString();
+            state.cloudUpdatedAt = memory.updated_at;
+            saveSyncState(state);
+            return { synced: true, source: 'cloud' };
+        }
+        return { synced: false, source: 'local' };
+    }
+    catch {
+        return { synced: false, source: 'none' };
+    }
+}
+/** Push local learning data to cloud */
+export async function pushToCloud() {
+    const token = getCloudToken();
+    if (!token)
+        return false;
+    try {
+        const data = loadLocalData();
+        const res = await fetch(`${ENGINE_URL}/sync`, {
+            method: 'POST',
+            headers: {
+                'Content-Type': 'application/json',
+                'Authorization': `Bearer ${token}`,
+            },
+            body: JSON.stringify({
+                action: 'push',
+                ...data,
+            }),
+            signal: AbortSignal.timeout(10_000),
+        });
+        if (!res.ok)
+            return false;
+        const state = loadSyncState();
+        state.lastPush = new Date().toISOString();
+        saveSyncState(state);
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+/** Sync on startup: pull if cloud has newer data */
+export async function syncOnStartup() {
+    if (!isCloudSyncEnabled())
+        return null;
+    try {
+        const result = await pullFromCloud();
+        if (result.synced && result.source === 'cloud') {
+            return 'Synced learning data from cloud';
+        }
+        return null;
+    }
+    catch {
+        return null;
+    }
+}
+/** Sync after learning: push local data to cloud (debounced — call after interactions) */
+let pushTimer = null;
+const PUSH_DEBOUNCE_MS = 30_000; // Push at most every 30 seconds
+export function schedulePush() {
+    if (!isCloudSyncEnabled())
+        return;
+    if (pushTimer)
+        return; // Already scheduled
+    pushTimer = setTimeout(() => {
+        pushTimer = null;
+        pushToCloud().catch(() => { }); // Fire and forget
+    }, PUSH_DEBOUNCE_MS);
+}
+/** Force an immediate push (call on exit) */
+export function flushCloudSync() {
+    if (pushTimer) {
+        clearTimeout(pushTimer);
+        pushTimer = null;
+    }
+    if (isCloudSyncEnabled()) {
+        // Synchronous-ish push — best effort on exit
+        pushToCloud().catch(() => { });
+    }
+}
+//# sourceMappingURL=cloud-sync.js.map

package/dist/cloud-sync.js.map

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

package/dist/context-manager.d.ts

@@ -0,0 +1,55 @@
+/** Max context tokens before compression kicks in */
+export declare const MAX_CONTEXT_TOKENS = 32000;
+/** Conversation turn (matches memory.ts) */
+export interface ConversationTurn {
+    role: 'user' | 'assistant';
+    content: string;
+}
+/** Extracted key context from a long response */
+export interface KeyContext {
+    /** File paths mentioned */
+    files: string[];
+    /** Decisions or conclusions made */
+    decisions: string[];
+    /** Errors encountered */
+    errors: string[];
+    /** User corrections or explicit instructions */
+    corrections: string[];
+    /** Code snippets (first line of each block) */
+    codeSnippets: string[];
+}
+/** Estimate token count using 4-chars-per-token heuristic */
+export declare function estimateTokens(text: string): number;
+/** Estimate total tokens for an array of turns */
+export declare function estimateTurnTokens(turns: ConversationTurn[]): number;
+/** Extract key context from a long text (response or tool output) */
+export declare function extractKeyContext(text: string): KeyContext;
+/**
+ * Fold conversation history to fit within a token budget.
+ * Implements RLM-style context management:
+ * - Keep the most recent turns verbatim (they're most relevant)
+ * - Summarize older turns into compact bullet points
+ * - Always preserve user corrections and explicit instructions
+ * - Never drop the first user message (establishes the task)
+ */
+export declare function foldContext(turns: ConversationTurn[], maxTokens?: number, keepRecentCount?: number): ConversationTurn[];
+/**
+ * Decide whether content should be delegated to a sub-model.
+ * In an RLM, heavy tool outputs (file contents, search results) are
+ * processed by a cheaper model to extract only the relevant bits.
+ */
+export declare function shouldDelegate(contentTokens: number, currentContextTokens: number, maxTokens?: number): boolean;
+/**
+ * Compress a tool result that's too large for the context window.
+ * Extracts key information and discards the rest.
+ */
+export declare function compressToolResult(result: string, maxChars?: number): string;
+/**
+ * Auto-compact: check if context needs folding and do it.
+ * Call this before each API request.
+ */
+export declare function autoCompact(turns: ConversationTurn[], systemPromptTokens?: number, maxTokens?: number): {
+    turns: ConversationTurn[];
+    wasCompacted: boolean;
+};
+//# sourceMappingURL=context-manager.d.ts.map

package/dist/context-manager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"context-manager.d.ts","sourceRoot":"","sources":["../src/context-manager.ts"],"names":[],"mappings":"AAUA,qDAAqD;AACrD,eAAO,MAAM,kBAAkB,QAAS,CAAA;AAExC,4CAA4C;AAC5C,MAAM,WAAW,gBAAgB;IAC/B,IAAI,EAAE,MAAM,GAAG,WAAW,CAAA;IAC1B,OAAO,EAAE,MAAM,CAAA;CAChB;AAED,iDAAiD;AACjD,MAAM,WAAW,UAAU;IACzB,2BAA2B;IAC3B,KAAK,EAAE,MAAM,EAAE,CAAA;IACf,oCAAoC;IACpC,SAAS,EAAE,MAAM,EAAE,CAAA;IACnB,yBAAyB;IACzB,MAAM,EAAE,MAAM,EAAE,CAAA;IAChB,gDAAgD;IAChD,WAAW,EAAE,MAAM,EAAE,CAAA;IACrB,+CAA+C;IAC/C,YAAY,EAAE,MAAM,EAAE,CAAA;CACvB;AAED,6DAA6D;AAC7D,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAEnD;AAED,kDAAkD;AAClD,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,gBAAgB,EAAE,GAAG,MAAM,CAEpE;AAED,qEAAqE;AACrE,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,MAAM,GAAG,UAAU,CAgD1D;AAqBD;;;;;;;GAOG;AACH,wBAAgB,WAAW,CACzB,KAAK,EAAE,gBAAgB,EAAE,EACzB,SAAS,GAAE,MAA2B,EACtC,eAAe,GAAE,MAAU,GAC1B,gBAAgB,EAAE,CA+CpB;AAED;;;;GAIG;AACH,wBAAgB,cAAc,CAC5B,aAAa,EAAE,MAAM,EACrB,oBAAoB,EAAE,MAAM,EAC5B,SAAS,GAAE,MAA2B,GACrC,OAAO,CAGT;AAED;;;GAGG;AACH,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,MAAM,EAAE,QAAQ,GAAE,MAAa,GAAG,MAAM,CAiClF;AAED;;;GAGG;AACH,wBAAgB,WAAW,CACzB,KAAK,EAAE,gBAAgB,EAAE,EACzB,kBAAkB,GAAE,MAAa,EACjC,SAAS,GAAE,MAA2B,GACrC;IAAE,KAAK,EAAE,gBAAgB,EAAE,CAAC;IAAC,YAAY,EAAE,OAAO,CAAA;CAAE,CAYtD"}

package/dist/context-manager.js

@@ -0,0 +1,192 @@
+// K:BOT Context Manager — RLM-style context delegation
+//
+// Based on Recursive Language Models (Prime Intellect, Dec 2025):
+// Instead of stuffing everything into one context window, the agent
+// manages its own context by compressing, delegating, and preserving
+// only what matters.
+//
+// Key insight: treat the conversation history as a resource to be
+// managed, not an ever-growing log.
+/** Max context tokens before compression kicks in */
+export const MAX_CONTEXT_TOKENS = 32_000;
+/** Estimate token count using 4-chars-per-token heuristic */
+export function estimateTokens(text) {
+    return Math.ceil(text.length / 4);
+}
+/** Estimate total tokens for an array of turns */
+export function estimateTurnTokens(turns) {
+    return turns.reduce((sum, t) => sum + estimateTokens(t.content) + 4, 0); // +4 for role/formatting overhead
+}
+/** Extract key context from a long text (response or tool output) */
+export function extractKeyContext(text) {
+    const files = [];
+    const decisions = [];
+    const errors = [];
+    const corrections = [];
+    const codeSnippets = [];
+    const lines = text.split('\n');
+    for (const line of lines) {
+        const trimmed = line.trim();
+        // File paths — Unix and relative paths
+        const fileMatches = trimmed.match(/(?:^|\s)((?:\.{0,2}\/|~\/|src\/|packages\/)[^\s:,)]+\.\w+)/g);
+        if (fileMatches) {
+            for (const m of fileMatches)
+                files.push(m.trim());
+        }
+        // Decisions — lines starting with action verbs or containing decision language
+        if (/^(?:✓|✗|→|•)\s/.test(trimmed) || /\b(?:decided|chose|using|switched to|will use|created|deleted|updated|fixed|added|removed)\b/i.test(trimmed)) {
+            decisions.push(trimmed.slice(0, 200));
+        }
+        // Errors
+        if (/\b(?:error|fail|exception|TypeError|SyntaxError|ReferenceError|ENOENT|EACCES|404|500|crash)\b/i.test(trimmed)) {
+            errors.push(trimmed.slice(0, 200));
+        }
+        // User corrections
+        if (/^(?:no[,.]?\s|actually[,]?\s|that's wrong|instead[,]?\s|don't|never|always)\b/i.test(trimmed)) {
+            corrections.push(trimmed.slice(0, 200));
+        }
+    }
+    // Code snippets — first line of each code block
+    const codeBlockPattern = /```\w*\n(.+)/g;
+    let match;
+    while ((match = codeBlockPattern.exec(text)) !== null) {
+        codeSnippets.push(match[1].trim().slice(0, 100));
+    }
+    return {
+        files: [...new Set(files)].slice(0, 20),
+        decisions: decisions.slice(0, 10),
+        errors: errors.slice(0, 5),
+        corrections: corrections.slice(0, 5),
+        codeSnippets: codeSnippets.slice(0, 5),
+    };
+}
+/** Summarize a conversation turn into a compact bullet point */
+function summarizeTurn(turn) {
+    const ctx = extractKeyContext(turn.content);
+    const parts = [];
+    if (turn.role === 'user') {
+        // Keep user messages short but preserve intent
+        parts.push(turn.content.slice(0, 150));
+    }
+    else {
+        // Summarize assistant responses by key context
+        if (ctx.decisions.length > 0)
+            parts.push(ctx.decisions.slice(0, 3).join('; '));
+        if (ctx.files.length > 0)
+            parts.push(`Files: ${ctx.files.slice(0, 5).join(', ')}`);
+        if (ctx.errors.length > 0)
+            parts.push(`Errors: ${ctx.errors.slice(0, 2).join('; ')}`);
+        if (parts.length === 0)
+            parts.push(turn.content.split('\n')[0].slice(0, 150));
+    }
+    return `[${turn.role}] ${parts.join(' | ')}`;
+}
+/**
+ * Fold conversation history to fit within a token budget.
+ * Implements RLM-style context management:
+ * - Keep the most recent turns verbatim (they're most relevant)
+ * - Summarize older turns into compact bullet points
+ * - Always preserve user corrections and explicit instructions
+ * - Never drop the first user message (establishes the task)
+ */
+export function foldContext(turns, maxTokens = MAX_CONTEXT_TOKENS, keepRecentCount = 6) {
+    if (turns.length === 0)
+        return [];
+    const currentTokens = estimateTurnTokens(turns);
+    if (currentTokens <= maxTokens)
+        return turns; // No folding needed
+    // Keep the most recent turns verbatim
+    const recentTurns = turns.slice(-keepRecentCount);
+    const olderTurns = turns.slice(0, -keepRecentCount);
+    if (olderTurns.length === 0)
+        return recentTurns;
+    // Summarize older turns, but preserve corrections
+    const summaryLines = ['[Context Summary — earlier conversation]'];
+    const preservedTurns = [];
+    for (const turn of olderTurns) {
+        // Always preserve user corrections verbatim
+        if (turn.role === 'user' && /^(?:no[,.]?\s|actually|that's wrong|instead|don't|never|always)\b/i.test(turn.content.trim())) {
+            preservedTurns.push(turn);
+            continue;
+        }
+        // Summarize everything else
+        summaryLines.push(`• ${summarizeTurn(turn)}`);
+    }
+    const summaryText = summaryLines.join('\n');
+    const summaryTokens = estimateTokens(summaryText);
+    const recentTokens = estimateTurnTokens(recentTurns);
+    const preservedTokens = estimateTurnTokens(preservedTurns);
+    // If summary + recent + preserved fits, use it
+    if (summaryTokens + recentTokens + preservedTokens <= maxTokens) {
+        return [
+            { role: 'assistant', content: summaryText },
+            ...preservedTurns,
+            ...recentTurns,
+        ];
+    }
+    // Still too big — aggressive compression: just keep summary header + recent
+    const aggressiveSummary = summaryLines.slice(0, 10).join('\n');
+    return [
+        { role: 'assistant', content: aggressiveSummary },
+        ...recentTurns,
+    ];
+}
+/**
+ * Decide whether content should be delegated to a sub-model.
+ * In an RLM, heavy tool outputs (file contents, search results) are
+ * processed by a cheaper model to extract only the relevant bits.
+ */
+export function shouldDelegate(contentTokens, currentContextTokens, maxTokens = MAX_CONTEXT_TOKENS) {
+    // Delegate if this content would push us past 70% of budget
+    return (currentContextTokens + contentTokens) > maxTokens * 0.7;
+}
+/**
+ * Compress a tool result that's too large for the context window.
+ * Extracts key information and discards the rest.
+ */
+export function compressToolResult(result, maxChars = 4000) {
+    if (result.length <= maxChars)
+        return result;
+    const ctx = extractKeyContext(result);
+    const parts = [];
+    // Always include errors
+    if (ctx.errors.length > 0) {
+        parts.push('Errors:', ...ctx.errors.map(e => `  • ${e}`));
+    }
+    // Include file references
+    if (ctx.files.length > 0) {
+        parts.push(`Files: ${ctx.files.join(', ')}`);
+    }
+    // Include key decisions/findings
+    if (ctx.decisions.length > 0) {
+        parts.push('Key findings:', ...ctx.decisions.map(d => `  • ${d}`));
+    }
+    // Include first and last portion of raw result for context
+    const lines = result.split('\n');
+    if (lines.length > 20) {
+        parts.push('', '--- First 10 lines ---', ...lines.slice(0, 10));
+        parts.push(`... (${lines.length - 20} lines omitted) ...`);
+        parts.push('--- Last 10 lines ---', ...lines.slice(-10));
+    }
+    else {
+        parts.push('', result.slice(0, maxChars));
+    }
+    const compressed = parts.join('\n').slice(0, maxChars);
+    return `[Compressed from ${result.length} chars]\n${compressed}`;
+}
+/**
+ * Auto-compact: check if context needs folding and do it.
+ * Call this before each API request.
+ */
+export function autoCompact(turns, systemPromptTokens = 2000, maxTokens = MAX_CONTEXT_TOKENS) {
+    const available = maxTokens - systemPromptTokens - 4096; // Reserve 4K for response
+    const current = estimateTurnTokens(turns);
+    if (current <= available) {
+        return { turns, wasCompacted: false };
+    }
+    return {
+        turns: foldContext(turns, available),
+        wasCompacted: true,
+    };
+}
+//# sourceMappingURL=context-manager.js.map

package/dist/context-manager.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"context-manager.js","sourceRoot":"","sources":["../src/context-manager.ts"],"names":[],"mappings":"AAAA,uDAAuD;AACvD,EAAE;AACF,kEAAkE;AAClE,oEAAoE;AACpE,qEAAqE;AACrE,qBAAqB;AACrB,EAAE;AACF,kEAAkE;AAClE,oCAAoC;AAEpC,qDAAqD;AACrD,MAAM,CAAC,MAAM,kBAAkB,GAAG,MAAM,CAAA;AAsBxC,6DAA6D;AAC7D,MAAM,UAAU,cAAc,CAAC,IAAY;IACzC,OAAO,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,MAAM,GAAG,CAAC,CAAC,CAAA;AACnC,CAAC;AAED,kDAAkD;AAClD,MAAM,UAAU,kBAAkB,CAAC,KAAyB;IAC1D,OAAO,KAAK,CAAC,MAAM,CAAC,CAAC,GAAG,EAAE,CAAC,EAAE,EAAE,CAAC,GAAG,GAAG,cAAc,CAAC,CAAC,CAAC,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,CAAA,CAAC,kCAAkC;AAC5G,CAAC;AAED,qEAAqE;AACrE,MAAM,UAAU,iBAAiB,CAAC,IAAY;IAC5C,MAAM,KAAK,GAAa,EAAE,CAAA;IAC1B,MAAM,SAAS,GAAa,EAAE,CAAA;IAC9B,MAAM,MAAM,GAAa,EAAE,CAAA;IAC3B,MAAM,WAAW,GAAa,EAAE,CAAA;IAChC,MAAM,YAAY,GAAa,EAAE,CAAA;IAEjC,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAA;IAE9B,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACzB,MAAM,OAAO,GAAG,IAAI,CAAC,IAAI,EAAE,CAAA;QAE3B,uCAAuC;QACvC,MAAM,WAAW,GAAG,OAAO,CAAC,KAAK,CAAC,6DAA6D,CAAC,CAAA;QAChG,IAAI,WAAW,EAAE,CAAC;YAChB,KAAK,MAAM,CAAC,IAAI,WAAW;gBAAE,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAA;QACnD,CAAC;QAED,+EAA+E;QAC/E,IAAI,gBAAgB,CAAC,IAAI,CAAC,OAAO,CAAC,IAAI,+FAA+F,CAAC,IAAI,CAAC,OAAO,CAAC,EAAE,CAAC;YACpJ,SAAS,CAAC,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC,CAAA;QACvC,CAAC;QAED,SAAS;QACT,IAAI,gGAAgG,CAAC,IAAI,CAAC,OAAO,CAAC,EAAE,CAAC;YACnH,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC,CAAA;QACpC,CAAC;QAED,mBAAmB;QACnB,IAAI,gFAAgF,CAAC,IAAI,CAAC,OAAO,CAAC,EAAE,CAAC;YACnG,WAAW,CAAC,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC,CAAA;QACzC,CAAC;IACH,CAAC;IAED,gDAAgD;IAChD,MAAM,gBAAgB,GAAG,eAAe,CAAA;IACxC,IAAI,KAAK,CAAA;IACT,OAAO,CAAC,KAAK,GAAG,gBAAgB,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,KAAK,IAAI,EAAE,CAAC;QACtD,YAAY,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC,CAAA;IAClD,CAAC;IAED,OAAO;QACL,KAAK,EAAE,CAAC,GAAG,IAAI,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC;QACvC,SAAS,EAAE,SAAS,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC;QACjC,MAAM,EAAE,MAAM,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC;QAC1B,WAAW,EAAE,WAAW,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC;QACpC,YAAY,EAAE,YAAY,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC;KACvC,CAAA;AACH,CAAC;AAED,gEAAgE;AAChE,SAAS,aAAa,CAAC,IAAsB;IAC3C,MAAM,GAAG,GAAG,iBAAiB,CAAC,IAAI,CAAC,OAAO,CAAC,CAAA;IAC3C,MAAM,KAAK,GAAa,EAAE,CAAA;IAE1B,IAAI,IAAI,CAAC,IAAI,KAAK,MAAM,EAAE,CAAC;QACzB,+CAA+C;QAC/C,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC,CAAA;IACxC,CAAC;SAAM,CAAC;QACN,+CAA+C;QAC/C,IAAI,GAAG,CAAC,SAAS,CAAC,MAAM,GAAG,CAAC;YAAE,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAA;QAC9E,IAAI,GAAG,CAAC,KAAK,CAAC,MAAM,GAAG,CAAC;YAAE,KAAK,CAAC,IAAI,CAAC,UAAU,GAAG,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAA;QAClF,IAAI,GAAG,CAAC,MAAM,CAAC,MAAM,GAAG,CAAC;YAAE,KAAK,CAAC,IAAI,CAAC,WAAW,GAAG,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAA;QACrF,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC;YAAE,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC,CAAA;IAC/E,CAAC;IAED,OAAO,IAAI,IAAI,CAAC,IAAI,KAAK,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE,CAAA;AAC9C,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,UAAU,WAAW,CACzB,KAAyB,EACzB,YAAoB,kBAAkB,EACtC,kBAA0B,CAAC;IAE3B,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,EAAE,CAAA;IAEjC,MAAM,aAAa,GAAG,kBAAkB,CAAC,KAAK,CAAC,CAAA;IAC/C,IAAI,aAAa,IAAI,SAAS;QAAE,OAAO,KAAK,CAAA,CAAC,oBAAoB;IAEjE,sCAAsC;IACtC,MAAM,WAAW,GAAG,KAAK,CAAC,KAAK,CAAC,CAAC,eAAe,CAAC,CAAA;IACjD,MAAM,UAAU,GAAG,KAAK,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,eAAe,CAAC,CAAA;IAEnD,IAAI,UAAU,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,WAAW,CAAA;IAE/C,kDAAkD;IAClD,MAAM,YAAY,GAAa,CAAC,0CAA0C,CAAC,CAAA;IAC3E,MAAM,cAAc,GAAuB,EAAE,CAAA;IAE7C,KAAK,MAAM,IAAI,IAAI,UAAU,EAAE,CAAC;QAC9B,4CAA4C;QAC5C,IAAI,IAAI,CAAC,IAAI,KAAK,MAAM,IAAI,oEAAoE,CAAC,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,IAAI,EAAE,CAAC,EAAE,CAAC;YAC3H,cAAc,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;YACzB,SAAQ;QACV,CAAC;QAED,4BAA4B;QAC5B,YAAY,CAAC,IAAI,CAAC,KAAK,aAAa,CAAC,IAAI,CAAC,EAAE,CAAC,CAAA;IAC/C,CAAC;IAED,MAAM,WAAW,GAAG,YAAY,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;IAC3C,MAAM,aAAa,GAAG,cAAc,CAAC,WAAW,CAAC,CAAA;IACjD,MAAM,YAAY,GAAG,kBAAkB,CAAC,WAAW,CAAC,CAAA;IACpD,MAAM,eAAe,GAAG,kBAAkB,CAAC,cAAc,CAAC,CAAA;IAE1D,+CAA+C;IAC/C,IAAI,aAAa,GAAG,YAAY,GAAG,eAAe,IAAI,SAAS,EAAE,CAAC;QAChE,OAAO;YACL,EAAE,IAAI,EAAE,WAAW,EAAE,OAAO,EAAE,WAAW,EAAE;YAC3C,GAAG,cAAc;YACjB,GAAG,WAAW;SACf,CAAA;IACH,CAAC;IAED,4EAA4E;IAC5E,MAAM,iBAAiB,GAAG,YAAY,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;IAC9D,OAAO;QACL,EAAE,IAAI,EAAE,WAAW,EAAE,OAAO,EAAE,iBAAiB,EAAE;QACjD,GAAG,WAAW;KACf,CAAA;AACH,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,cAAc,CAC5B,aAAqB,EACrB,oBAA4B,EAC5B,YAAoB,kBAAkB;IAEtC,4DAA4D;IAC5D,OAAO,CAAC,oBAAoB,GAAG,aAAa,CAAC,GAAG,SAAS,GAAG,GAAG,CAAA;AACjE,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,kBAAkB,CAAC,MAAc,EAAE,WAAmB,IAAI;IACxE,IAAI,MAAM,CAAC,MAAM,IAAI,QAAQ;QAAE,OAAO,MAAM,CAAA;IAE5C,MAAM,GAAG,GAAG,iBAAiB,CAAC,MAAM,CAAC,CAAA;IACrC,MAAM,KAAK,GAAa,EAAE,CAAA;IAE1B,wBAAwB;IACxB,IAAI,GAAG,CAAC,MAAM,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAC1B,KAAK,CAAC,IAAI,CAAC,SAAS,EAAE,GAAG,GAAG,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC,CAAA;IAC3D,CAAC;IAED,0BAA0B;IAC1B,IAAI,GAAG,CAAC,KAAK,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACzB,KAAK,CAAC,IAAI,CAAC,UAAU,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAA;IAC9C,CAAC;IAED,iCAAiC;IACjC,IAAI,GAAG,CAAC,SAAS,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAC7B,KAAK,CAAC,IAAI,CAAC,eAAe,EAAE,GAAG,GAAG,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC,CAAA;IACpE,CAAC;IAED,2DAA2D;IAC3D,MAAM,KAAK,GAAG,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,CAAA;IAChC,IAAI,KAAK,CAAC,MAAM,GAAG,EAAE,EAAE,CAAC;QACtB,KAAK,CAAC,IAAI,CAAC,EAAE,EAAE,wBAAwB,EAAE,GAAG,KAAK,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAA;QAC/D,KAAK,CAAC,IAAI,CAAC,QAAQ,KAAK,CAAC,MAAM,GAAG,EAAE,qBAAqB,CAAC,CAAA;QAC1D,KAAK,CAAC,IAAI,CAAC,uBAAuB,EAAE,GAAG,KAAK,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAA;IAC1D,CAAC;SAAM,CAAC;QACN,KAAK,CAAC,IAAI,CAAC,EAAE,EAAE,MAAM,CAAC,KAAK,CAAC,CAAC,EAAE,QAAQ,CAAC,CAAC,CAAA;IAC3C,CAAC;IAED,MAAM,UAAU,GAAG,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,QAAQ,CAAC,CAAA;IACtD,OAAO,oBAAoB,MAAM,CAAC,MAAM,YAAY,UAAU,EAAE,CAAA;AAClE,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,WAAW,CACzB,KAAyB,EACzB,qBAA6B,IAAI,EACjC,YAAoB,kBAAkB;IAEtC,MAAM,SAAS,GAAG,SAAS,GAAG,kBAAkB,GAAG,IAAI,CAAA,CAAC,0BAA0B;IAClF,MAAM,OAAO,GAAG,kBAAkB,CAAC,KAAK,CAAC,CAAA;IAEzC,IAAI,OAAO,IAAI,SAAS,EAAE,CAAC;QACzB,OAAO,EAAE,KAAK,EAAE,YAAY,EAAE,KAAK,EAAE,CAAA;IACvC,CAAC;IAED,OAAO;QACL,KAAK,EAAE,WAAW,CAAC,KAAK,EAAE,SAAS,CAAC;QACpC,YAAY,EAAE,IAAI;KACnB,CAAA;AACH,CAAC"}

package/dist/embeddings.d.ts

@@ -0,0 +1,40 @@
+/** Save cache to disk (debounced externally) */
+export declare function saveEmbeddingCache(): void;
+/**
+ * Compute semantic similarity between two texts.
+ * Uses embeddings if Ollama is available, falls back to Jaccard.
+ */
+export declare function semanticSimilarity(a: string, b: string): Promise<number>;
+/**
+ * Find the best match from a list of candidates.
+ * Returns the candidate with highest similarity above the threshold.
+ */
+export declare function findBestMatch(query: string, candidates: Array<{
+    text: string;
+    id: string;
+}>, threshold?: number): Promise<{
+    id: string;
+    score: number;
+} | null>;
+/**
+ * Rank candidates by semantic similarity to query.
+ * Returns sorted array with scores.
+ */
+export declare function rankBySimilarity(query: string, candidates: Array<{
+    text: string;
+    id: string;
+}>, topK?: number): Promise<Array<{
+    id: string;
+    score: number;
+}>>;
+/** Warm the embedding cache with common queries (call on startup) */
+export declare function warmCache(texts: string[]): Promise<void>;
+/** Check if embeddings are available (Ollama + nomic-embed-text) */
+export declare function isEmbeddingsAvailable(): Promise<boolean>;
+/** Get cache stats */
+export declare function getCacheStats(): {
+    size: number;
+    maxSize: number;
+    available: boolean | null;
+};
+//# sourceMappingURL=embeddings.d.ts.map

package/dist/embeddings.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"embeddings.d.ts","sourceRoot":"","sources":["../src/embeddings.ts"],"names":[],"mappings":"AAkDA,gDAAgD;AAChD,wBAAgB,kBAAkB,IAAI,IAAI,CAQzC;AAqFD;;;GAGG;AACH,wBAAsB,kBAAkB,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAU9E;AAED;;;GAGG;AACH,wBAAsB,aAAa,CACjC,KAAK,EAAE,MAAM,EACb,UAAU,EAAE,KAAK,CAAC;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,EAAE,EAAE,MAAM,CAAA;CAAE,CAAC,EAC/C,SAAS,GAAE,MAAY,GACtB,OAAO,CAAC;IAAE,EAAE,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,GAAG,IAAI,CAAC,CA0B/C;AAED;;;GAGG;AACH,wBAAsB,gBAAgB,CACpC,KAAK,EAAE,MAAM,EACb,UAAU,EAAE,KAAK,CAAC;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,EAAE,EAAE,MAAM,CAAA;CAAE,CAAC,EAC/C,IAAI,GAAE,MAAU,GACf,OAAO,CAAC,KAAK,CAAC;IAAE,EAAE,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,CAAC,CAAC,CAoB/C;AAED,qEAAqE;AACrE,wBAAsB,SAAS,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAU9D;AAED,oEAAoE;AACpE,wBAAsB,qBAAqB,IAAI,OAAO,CAAC,OAAO,CAAC,CAE9D;AAED,sBAAsB;AACtB,wBAAgB,aAAa,IAAI;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAC;IAAC,SAAS,EAAE,OAAO,GAAG,IAAI,CAAA;CAAE,CAG5F"}