n2-qln 3.4.2 → 4.1.0

package/{lib → dist/lib}/router.js

@@ -1,40 +1,37 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Router = void 0;
 // QLN — L1 Router (3-Stage parallel search engine)
 // Query → Stage1(Trigger) + Stage2(BM25 Keyword) + Stage3(Semantic) → Merge → Top-K
-const { buildSearchText } = require('./schema');
-
+const schema_1 = require("./schema");
 /**
  * 3-Stage search engine.
  *
  * Score formula:
- *   final = trigger×3.0 + bm25_keyword×1.0 + semantic×2.0
- *         + log2(usageCount+1)×0.5 + successRate×1.0
+ *   final = (trigger×3.0 + bm25_keyword×1.0 + semantic×2.0
+ *         + log2(usageCount+1)×0.5 + successRate×1.0) × sourceWeight
  */
 class Router {
-    /**
-     * @param {import('./registry').Registry} registry
-     * @param {import('./vector-index').VectorIndex} vectorIndex
-     * @param {import('./embedding').Embedding} [embedding]
-     */
-    constructor(registry, vectorIndex, embedding = null) {
+    _registry;
+    _vectorIndex;
+    _embedding;
+    // BM25 parameters (standard Okapi BM25 defaults)
+    _k1 = 1.2;
+    _b = 0.75;
+    // IDF cache (rebuilt when tools change)
+    _idfCache = new Map();
+    _avgDocLen = 0;
+    _idfDirty = true;
+    // Source weights (per-source score multiplier)
+    _sourceWeights;
+    constructor(registry, vectorIndex, embedding = null, sourceWeights = {}) {
         this._registry = registry;
         this._vectorIndex = vectorIndex;
         this._embedding = embedding;
-
-        // BM25 parameters (standard Okapi BM25 defaults)
-        this._k1 = 1.2;   // Term frequency saturation
-        this._b = 0.75;    // Document length normalization
-
-        // IDF cache (rebuilt when tools change)
-        this._idfCache = new Map();
-        this._avgDocLen = 0;
-        this._idfDirty = true;
+        this._sourceWeights = sourceWeights;
     }
-
     /**
      * Route natural language query to tools.
-     * @param {string} query - Natural language (e.g. "take a screenshot")
-     * @param {{topK?: number, threshold?: number}} [options]
-     * @returns {Promise<{results: object[], timing: object}>}
      */
     async route(query, options = {}) {
         const topK = options.topK || 5;
@@ -42,34 +39,28 @@ class Router {
         const scores = new Map();
         const timing = { stage1: 0, stage2: 0, stage3: 0, merge: 0, total: 0 };
         const t0 = Date.now();
-
         // Rebuild IDF if registry changed
-        if (this._idfDirty) this._buildIDF();
-
+        if (this._idfDirty)
+            this._buildIDF();
         // Stage 1: Trigger exact match (fastest)
         const t1 = Date.now();
         this._stage1TriggerMatch(query, scores);
         timing.stage1 = Date.now() - t1;
-
         // Stage 2: BM25 keyword search
         const t2 = Date.now();
         this._stage2BM25(query, scores);
         timing.stage2 = Date.now() - t2;
-
         // Stage 3: Semantic vector search (when embedding available)
         const t3 = Date.now();
         await this._stage3SemanticSearch(query, scores);
         timing.stage3 = Date.now() - t3;
-
         // Merge: Calculate final scores
         const t4 = Date.now();
         const results = this._mergeAndRank(scores, topK, threshold);
         timing.merge = Date.now() - t4;
         timing.total = Date.now() - t0;
-
         return { results, timing };
     }
-
     /** Stage 1: Trigger word exact match. Weight: 3.0 */
     _stage1TriggerMatch(query, scores) {
         const queryWords = query.toLowerCase().split(/\s+/).filter(w => w.length > 1);
@@ -77,64 +68,54 @@ class Router {
             const triggers = tool.triggers || [];
             let hits = 0;
             for (const word of queryWords) {
-                if (triggers.some(t => t === word || t.includes(word))) hits++;
+                if (triggers.some(t => t === word || t.includes(word)))
+                    hits++;
             }
             if (hits > 0) {
                 this._getOrCreate(scores, tool.name).stage1 = hits * 3.0;
             }
         }
     }
-
     /** Stage 2: BM25 keyword search. Weight: 1.0 */
     _stage2BM25(query, scores) {
         const queryTerms = this._tokenize(query);
-        if (queryTerms.length === 0) return;
-
+        if (queryTerms.length === 0)
+            return;
         for (const tool of this._registry.getAll()) {
-            const text = (tool.searchText || buildSearchText(tool)).toLowerCase();
+            const text = (tool.searchText || (0, schema_1.buildSearchText)(tool)).toLowerCase();
             const bm25 = this._bm25Score(queryTerms, text);
             if (bm25 > 0) {
                 this._getOrCreate(scores, tool.name).stage2 = bm25 * 1.0;
             }
         }
     }
-
-    /**
-     * Calculate BM25 score for a query against a document.
-     * @param {string[]} queryTerms - Tokenized query terms
-     * @param {string} docText - Document text (lowercased)
-     * @returns {number} BM25 score
-     */
+    /** Calculate BM25 score for a query against a document. */
     _bm25Score(queryTerms, docText) {
         const docTerms = docText.split(/[\s_\-./]+/).filter(w => w.length > 1);
         const docLen = docTerms.length;
-        if (docLen === 0) return 0;
-
+        if (docLen === 0)
+            return 0;
         // Build term frequency map for this document
         const tf = new Map();
         for (const term of docTerms) {
             tf.set(term, (tf.get(term) || 0) + 1);
         }
-
         let score = 0;
         for (const term of queryTerms) {
             const idf = this._idfCache.get(term) || 0;
             const freq = tf.get(term) || 0;
-            if (freq === 0) continue;
-
+            if (freq === 0)
+                continue;
             // BM25 formula: IDF × (f × (k1+1)) / (f + k1 × (1 - b + b × |d|/avgDL))
             const numerator = freq * (this._k1 + 1);
             const denominator = freq + this._k1 * (1 - this._b + this._b * (docLen / this._avgDocLen));
             score += idf * (numerator / denominator);
         }
-
         return score;
     }
-
     /**
      * Build IDF cache from all registered tools.
      * IDF(term) = ln((N - n(t) + 0.5) / (n(t) + 0.5) + 1)
-     * where N = total docs, n(t) = docs containing term
      */
     _buildIDF() {
         const tools = this._registry.getAll();
@@ -143,141 +124,119 @@ class Router {
             this._idfDirty = false;
             return;
         }
-
-        // Tokenize all documents and count document frequencies
         const docFreq = new Map();
         let totalLen = 0;
-
         for (const tool of tools) {
-            const text = (tool.searchText || buildSearchText(tool)).toLowerCase();
+            const text = (tool.searchText || (0, schema_1.buildSearchText)(tool)).toLowerCase();
             const terms = text.split(/[\s_\-./]+/).filter(w => w.length > 1);
             totalLen += terms.length;
-
-            // Unique terms per document
             const uniqueTerms = new Set(terms);
             for (const term of uniqueTerms) {
                 docFreq.set(term, (docFreq.get(term) || 0) + 1);
             }
         }
-
         this._avgDocLen = totalLen / N;
-
-        // Calculate IDF for each term
         this._idfCache.clear();
         for (const [term, df] of docFreq) {
-            // BM25 IDF: ln((N - df + 0.5) / (df + 0.5) + 1)
             const idf = Math.log((N - df + 0.5) / (df + 0.5) + 1);
             this._idfCache.set(term, idf);
         }
-
         this._idfDirty = false;
     }
-
-    /**
-     * Tokenize query string into search terms.
-     * @param {string} query
-     * @returns {string[]}
-     */
+    /** Tokenize query string into search terms. */
     _tokenize(query) {
         return query.toLowerCase().split(/[\s_\-./]+/).filter(w => w.length > 2);
     }
-
     /** Stage 3: Semantic vector search. Weight: 2.0 */
     async _stage3SemanticSearch(query, scores) {
-        if (!this._embedding || !this._vectorIndex) return;
+        if (!this._embedding || !this._vectorIndex)
+            return;
         try {
             const available = await this._embedding.isAvailable();
-            if (!available) return;
+            if (!available)
+                return;
             const queryVec = await this._embedding.embed(query);
-            if (!queryVec || queryVec.length === 0) return;
+            if (!queryVec || queryVec.length === 0)
+                return;
             const semanticResults = this._vectorIndex.search(queryVec, 20);
             for (const r of semanticResults) {
                 this._getOrCreate(scores, r.name).stage3 = r.score * 2.0;
             }
-        } catch { /* graceful degradation */ }
+        }
+        catch { /* graceful degradation */ }
     }
-
     /** Merge all stage results + usage/success bonus + recency decay → ranking */
     _mergeAndRank(scores, topK, threshold) {
         const results = [];
         for (const [name, s] of scores) {
             const tool = this._registry.get(name);
-            if (!tool) continue;
-
+            if (!tool)
+                continue;
             // Recency Decay: usage bonus fades over 30-day half-life
             const daysSinceUse = tool.lastUsedAt
                 ? (Date.now() - new Date(tool.lastUsedAt).getTime()) / 86400000
                 : 0;
             const recencyFactor = tool.lastUsedAt ? Math.exp(-daysSinceUse / 30) : 1.0;
             const usageBonus = Math.log2((tool.usageCount || 0) + 1) * 0.5 * recencyFactor;
-
             const successBonus = (tool.successRate ?? 1.0) * 1.0;
-            const finalScore = (s.stage1 || 0) + (s.stage2 || 0) + (s.stage3 || 0)
+            const rawScore = (s.stage1 || 0) + (s.stage2 || 0) + (s.stage3 || 0)
                 + usageBonus + successBonus;
+            // Apply source weight multiplier (default: 1.0)
+            const sourceWeight = this._sourceWeights[tool.source] ?? 1.0;
+            const finalScore = rawScore * sourceWeight;
             if (finalScore >= threshold) {
                 results.push({
                     name,
                     score: Math.round(finalScore * 100) / 100,
                     stages: {
-                        trigger: s.stage1 || 0,
-                        keyword: s.stage2 || 0,
-                        semantic: s.stage3 || 0,
+                        trigger: s.stage1 || 0, keyword: s.stage2 || 0, semantic: s.stage3 || 0,
                         usage: Math.round(usageBonus * 100) / 100,
                         success: Math.round(successBonus * 100) / 100,
                         recencyFactor: Math.round(recencyFactor * 1000) / 1000,
                     },
-                    description: tool.description,
-                    source: tool.source,
-                    category: tool.category,
-                    inputSchema: tool.inputSchema,
+                    description: tool.description, source: tool.source,
+                    category: tool.category, inputSchema: tool.inputSchema,
                 });
             }
         }
         results.sort((a, b) => b.score - a.score);
         const ranked = results.slice(0, topK);
-
-        // 5% Explorer: inject least-used tool into last slot
-        if (ranked.length >= topK && topK >= 2) {
-            const resultNames = new Set(ranked.map(r => r.name));
-            const allTools = this._registry.getAll()
-                .filter(t => !resultNames.has(t.name))
-                .sort((a, b) => (a.usageCount || 0) - (b.usageCount || 0));
-            if (allTools.length > 0) {
-                const explorer = allTools[0];
-                ranked[ranked.length - 1] = {
-                    name: explorer.name,
-                    score: 0,
-                    stages: { trigger: 0, keyword: 0, semantic: 0, usage: 0, success: 0, recencyFactor: 0 },
-                    description: explorer.description,
-                    source: explorer.source,
-                    category: explorer.category,
-                    inputSchema: explorer.inputSchema,
-                    explorer: true,
-                };
-            }
-        }
-
+        this._injectExplorer(ranked);
         return ranked;
     }
-
+    /** 5% Explorer: append least-used tool as bonus slot (never replaces regular results) */
+    _injectExplorer(ranked) {
+        if (ranked.length < 2 || Math.random() >= 0.05)
+            return;
+        const resultNames = new Set(ranked.map(r => r.name));
+        const allTools = this._registry.getAll()
+            .filter(t => !resultNames.has(t.name))
+            .sort((a, b) => (a.usageCount || 0) - (b.usageCount || 0));
+        if (allTools.length > 0) {
+            const explorer = allTools[0];
+            ranked.push({
+                name: explorer.name, score: 0,
+                stages: { trigger: 0, keyword: 0, semantic: 0, usage: 0, success: 0, recencyFactor: 0 },
+                description: explorer.description, source: explorer.source,
+                category: explorer.category, inputSchema: explorer.inputSchema,
+                explorer: true,
+            });
+        }
+    }
     /** Build vector index and refresh IDF cache */
     buildIndex() {
         this._idfDirty = true;
         return this._vectorIndex.build(this._registry.getAll());
     }
-
     /** Mark IDF cache as dirty (call after tool registration changes) */
     invalidateIDF() {
         this._idfDirty = true;
     }
-
-    /** @private */
     _getOrCreate(scores, name) {
-        if (!scores.has(name)) scores.set(name, { stage1: 0, stage2: 0, stage3: 0 });
+        if (!scores.has(name))
+            scores.set(name, { stage1: 0, stage2: 0, stage3: 0 });
         return scores.get(name);
     }
-
-    /** @returns {object} */
     stats() {
         return {
             registrySize: this._registry.size,
@@ -292,6 +251,5 @@ class Router {
         };
     }
 }
-
-module.exports = { Router };
-
+exports.Router = Router;
+//# sourceMappingURL=router.js.map

package/dist/lib/router.js.map

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

package/dist/lib/schema.d.ts

@@ -0,0 +1,20 @@
+import type { ToolEntry, RawToolEntry } from '../types';
+/**
+ * Convert raw tool data to a normalized entry.
+ */
+export declare function createToolEntry(raw: RawToolEntry): ToolEntry;
+/**
+ * Build searchable text from tool entry.
+ * Used by Stage 2 (keyword matching) and Stage 3 (embedding generation).
+ */
+export declare function buildSearchText(entry: ToolEntry): string;
+/**
+ * Auto-extract trigger words from tool name/description.
+ * Used by Stage 1 (exact matching).
+ */
+export declare function extractTriggers(name: string, description?: string, tags?: string[]): string[];
+/**
+ * Infer category from tool name/source.
+ */
+export declare function inferCategory(name: string, source?: string): string;
+//# sourceMappingURL=schema.d.ts.map

package/{lib → dist/lib}/schema.js

@@ -1,10 +1,11 @@
-// QLN — Tool schema normalization + trigger extraction
-// Converts tools from various sources (MCP, plugins, local) into a standard format
-
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createToolEntry = createToolEntry;
+exports.buildSearchText = buildSearchText;
+exports.extractTriggers = extractTriggers;
+exports.inferCategory = inferCategory;
 /**
  * Convert raw tool data to a normalized entry.
- * @param {object} raw - Raw tool data
- * @returns {object} Normalized tool entry
  */
 function createToolEntry(raw) {
     return {
@@ -19,20 +20,19 @@ function createToolEntry(raw) {
         examples: raw.examples || [],
         endpoint: raw.endpoint || '',
         searchText: '',
+        boostKeywords: raw.boostKeywords || '',
         usageCount: raw.usageCount || 0,
         successRate: typeof raw.successRate === 'number' ? raw.successRate : 1.0,
+        consecutiveFailures: 0,
         lastUsedAt: raw.lastUsedAt || null,
         embedding: raw.embedding || null,
         registeredAt: raw.registeredAt || new Date().toISOString(),
         updatedAt: new Date().toISOString(),
     };
 }
-
 /**
  * Build searchable text from tool entry.
  * Used by Stage 2 (keyword matching) and Stage 3 (embedding generation).
- * @param {object} entry - Normalized tool entry
- * @returns {string}
  */
 function buildSearchText(entry) {
     const parts = [
@@ -41,25 +41,30 @@ function buildSearchText(entry) {
         entry.category,
         entry.provider,
     ];
-    if (entry.triggers?.length > 0) parts.push(entry.triggers.join(' '));
-    if (entry.tags?.length > 0) parts.push(entry.tags.join(' '));
-    if (entry.examples?.length > 0) parts.push(entry.examples.join(' '));
+    // boostKeywords gets double weight — it's a curated capability phrase
+    if (entry.boostKeywords) {
+        parts.push(entry.boostKeywords);
+        parts.push(entry.boostKeywords); // intentional duplication for BM25 term frequency boost
+    }
+    if (entry.triggers?.length > 0)
+        parts.push(entry.triggers.join(' '));
+    if (entry.tags?.length > 0)
+        parts.push(entry.tags.join(' '));
+    if (entry.examples?.length > 0)
+        parts.push(entry.examples.join(' '));
     return parts.filter(Boolean).join(' ').toLowerCase();
 }
-
 /**
  * Auto-extract trigger words from tool name/description.
  * Used by Stage 1 (exact matching).
- * @param {string} name - Tool name (e.g. 'read_page')
- * @param {string} description - Tool description
- * @returns {string[]} Trigger word array
  */
 function extractTriggers(name, description = '', tags = []) {
     const triggers = [];
     if (name) {
         triggers.push(name);
         const parts = name.split(/[_\-\.]/);
-        if (parts.length > 1) triggers.push(...parts);
+        if (parts.length > 1)
+            triggers.push(...parts);
     }
     if (description) {
         const firstWord = description.trim().split(/\s+/)[0]?.toLowerCase();
@@ -69,28 +74,31 @@ function extractTriggers(name, description = '', tags = []) {
     }
     if (tags && tags.length > 0) {
         for (const tag of tags) {
-            if (tag.length > 2 && !triggers.includes(tag)) triggers.push(tag);
+            if (tag.length > 2 && !triggers.includes(tag))
+                triggers.push(tag);
         }
     }
     return [...new Set(triggers.filter(t => t.length > 1))];
 }
-
 /**
  * Infer category from tool name/source.
- * @param {string} name - Tool name
- * @param {string} source - Source ('mcp', 'plugin', 'local')
- * @returns {string} Category
  */
 function inferCategory(name, source = 'unknown') {
     const lower = (name || '').toLowerCase();
-    if (lower.includes('screenshot') || lower.includes('capture') || lower.includes('record')) return 'capture';
-    if (lower.includes('scroll') || lower.includes('tab') || lower.includes('read_page') || lower.includes('navigate')) return 'web';
-    if (lower.includes('extract') || lower.includes('scrape') || lower.includes('parse')) return 'data';
-    if (lower.includes('search') || lower.includes('ai') || lower.includes('query')) return 'ai';
-    if (lower.includes('file') || lower.includes('write') || lower.includes('read')) return 'file';
-    if (lower.includes('code') || lower.includes('compile') || lower.includes('lint')) return 'dev';
-    if (source === 'mcp') return 'mcp';
+    if (lower.includes('screenshot') || lower.includes('capture') || lower.includes('record'))
+        return 'capture';
+    if (lower.includes('scroll') || lower.includes('tab') || lower.includes('read_page') || lower.includes('navigate'))
+        return 'web';
+    if (lower.includes('extract') || lower.includes('scrape') || lower.includes('parse'))
+        return 'data';
+    if (lower.includes('search') || lower.includes('ai') || lower.includes('query'))
+        return 'ai';
+    if (lower.includes('file') || lower.includes('write') || lower.includes('read'))
+        return 'file';
+    if (lower.includes('code') || lower.includes('compile') || lower.includes('lint'))
+        return 'dev';
+    if (source === 'mcp')
+        return 'mcp';
     return 'misc';
 }
-
-module.exports = { createToolEntry, buildSearchText, extractTriggers, inferCategory };
+//# sourceMappingURL=schema.js.map

package/dist/lib/schema.js.map

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

package/dist/lib/store.d.ts

@@ -0,0 +1,37 @@
+import type { ToolEntry, SqlJsStatic } from '../types';
+/**
+ * Initialize sql.js WASM module (once per process).
+ */
+declare function initSqlJs(): Promise<SqlJsStatic>;
+/**
+ * QLN SQLite store.
+ * Dedicated tool index DB — separated from Soul KV-Cache.
+ *
+ * File: {dataDir}/qln-tools.sqlite
+ */
+export declare class Store {
+    private _dataDir;
+    private _db;
+    private _dbPath;
+    constructor(dataDir: string);
+    /** Async init — load sql.js + open DB + create schema */
+    init(): Promise<void>;
+    /** Create tools + providers table schema */
+    private _createSchema;
+    /** Schema migration — safe ADD COLUMN (ignores if already exists) */
+    private _migrateSchema;
+    /** Upsert a tool entry. */
+    upsert(entry: ToolEntry): void;
+    /** Remove a tool by name. */
+    remove(name: string): boolean;
+    /** Purge all tools by source (for re-sync). */
+    purgeBySource(source: string): void;
+    /** Load all tools from DB. */
+    loadAll(): Record<string, unknown>[];
+    /** Persist DB to disk */
+    private _persist;
+    /** Close connection */
+    dispose(): void;
+}
+export { initSqlJs };
+//# sourceMappingURL=store.d.ts.map