n2-qln 3.4.2 → 4.1.1

package/dist/lib/store.js

@@ -0,0 +1,234 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Store = void 0;
+exports.initSqlJs = initSqlJs;
+// QLN — SQLite storage engine (pure JS via sql.js WASM). No native dependencies.
+const fs_1 = __importDefault(require("fs"));
+const path_1 = __importDefault(require("path"));
+/** sql.js module singleton */
+let _SQL = null;
+/** sql.js init promise */
+let _initPromise = null;
+/**
+ * Initialize sql.js WASM module (once per process).
+ */
+async function initSqlJs() {
+    if (_SQL)
+        return _SQL;
+    if (_initPromise)
+        return _initPromise;
+    _initPromise = (async () => {
+        // sql.js uses CJS export — require is needed here
+        const initFn = require('sql.js');
+        _SQL = await initFn();
+        return _SQL;
+    })();
+    return _initPromise;
+}
+/**
+ * QLN SQLite store.
+ * Dedicated tool index DB — separated from Soul KV-Cache.
+ *
+ * File: {dataDir}/qln-tools.sqlite
+ */
+class Store {
+    _dataDir;
+    _db;
+    _dbPath;
+    _batchMode;
+    _batchDirty;
+    constructor(dataDir) {
+        this._dataDir = dataDir;
+        this._db = null;
+        this._dbPath = path_1.default.join(dataDir, 'qln-tools.sqlite');
+        this._batchMode = false;
+        this._batchDirty = false;
+    }
+    /** Async init — load sql.js + open DB + create schema */
+    async init() {
+        const SQL = await initSqlJs();
+        if (!fs_1.default.existsSync(this._dataDir)) {
+            fs_1.default.mkdirSync(this._dataDir, { recursive: true });
+        }
+        if (fs_1.default.existsSync(this._dbPath)) {
+            const buffer = fs_1.default.readFileSync(this._dbPath);
+            this._db = new SQL.Database(buffer);
+        }
+        else {
+            this._db = new SQL.Database();
+        }
+        this._createSchema();
+    }
+    /** Create tools + providers table schema */
+    _createSchema() {
+        this._db.run(`
+      CREATE TABLE IF NOT EXISTS tools (
+        name TEXT PRIMARY KEY,
+        description TEXT DEFAULT '',
+        source TEXT DEFAULT 'unknown',
+        category TEXT DEFAULT 'misc',
+        provider TEXT DEFAULT '',
+        input_schema TEXT DEFAULT '{}',
+        triggers TEXT DEFAULT '[]',
+        tags TEXT DEFAULT '[]',
+        examples TEXT DEFAULT '[]',
+        endpoint TEXT DEFAULT '',
+        search_text TEXT DEFAULT '',
+        embedding TEXT DEFAULT '',
+        usage_count INTEGER DEFAULT 0,
+        success_rate REAL DEFAULT 1.0,
+        registered_at TEXT DEFAULT (datetime('now')),
+        updated_at TEXT DEFAULT (datetime('now'))
+      )
+    `);
+        this._db.run(`CREATE INDEX IF NOT EXISTS idx_tools_source ON tools(source)`);
+        this._db.run(`CREATE INDEX IF NOT EXISTS idx_tools_category ON tools(category)`);
+        this._db.run(`
+      CREATE TABLE IF NOT EXISTS providers (
+        name TEXT PRIMARY KEY,
+        version TEXT DEFAULT '1.0.0',
+        description TEXT DEFAULT '',
+        endpoint TEXT DEFAULT '',
+        tool_count INTEGER DEFAULT 0,
+        registered_at TEXT DEFAULT (datetime('now')),
+        updated_at TEXT DEFAULT (datetime('now'))
+      )
+    `);
+        this._migrateSchema();
+    }
+    /** Schema migration — safe ADD COLUMN (ignores if already exists) */
+    _migrateSchema() {
+        const addCol = (table, col, type, dflt) => {
+            try {
+                this._db.run(`ALTER TABLE ${table} ADD COLUMN ${col} ${type} DEFAULT ${dflt}`);
+            }
+            catch { /* column already exists */ }
+        };
+        addCol('tools', 'provider', 'TEXT', "''");
+        addCol('tools', 'examples', 'TEXT', "'[]'");
+        addCol('tools', 'endpoint', 'TEXT', "''");
+        addCol('tools', 'last_used_at', 'TEXT', 'NULL');
+        // v4.1.0: boostKeywords + Circuit Breaker
+        addCol('tools', 'boost_keywords', 'TEXT', "''");
+        addCol('tools', 'consecutive_failures', 'INTEGER', '0');
+        // Copy plugin_name → provider (if old schema has plugin_name)
+        try {
+            const cols = this._db.exec("PRAGMA table_info(tools)");
+            if (cols.length > 0) {
+                const colNames = cols[0].values.map(r => r[1]);
+                if (colNames.includes('plugin_name') && colNames.includes('provider')) {
+                    this._db.run("UPDATE tools SET provider = plugin_name WHERE provider = '' AND plugin_name != ''");
+                }
+            }
+        }
+        catch { /* table doesn't exist yet */ }
+        try {
+            this._db.run(`CREATE INDEX IF NOT EXISTS idx_tools_provider ON tools(provider)`);
+        }
+        catch { /* already exists */ }
+    }
+    /**
+     * Enter batch mode — suppresses per-upsert disk writes.
+     * Call endBatch() when done to flush once.
+     */
+    beginBatch() {
+        this._batchMode = true;
+        this._batchDirty = false;
+    }
+    /**
+     * Exit batch mode — flush to disk if any writes occurred.
+     */
+    endBatch() {
+        this._batchMode = false;
+        if (this._batchDirty) {
+            this._persist();
+            this._batchDirty = false;
+        }
+    }
+    /** Upsert a tool entry. */
+    upsert(entry) {
+        this._db.run(`
+      INSERT INTO tools (name, description, source, category, provider,
+        input_schema, triggers, tags, examples, endpoint, search_text, boost_keywords,
+        embedding, usage_count, success_rate, consecutive_failures, last_used_at, updated_at)
+      VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, ?,
+        ?, ?, COALESCE(?, (SELECT embedding FROM tools WHERE name = ?)),
+        ?, ?, ?, ?, datetime('now'))
+      ON CONFLICT(name) DO UPDATE SET
+        description = excluded.description,
+        source = excluded.source,
+        category = excluded.category,
+        provider = excluded.provider,
+        input_schema = excluded.input_schema,
+        triggers = excluded.triggers,
+        tags = excluded.tags,
+        examples = excluded.examples,
+        endpoint = excluded.endpoint,
+        search_text = excluded.search_text,
+        boost_keywords = excluded.boost_keywords,
+        embedding = COALESCE(excluded.embedding, tools.embedding),
+        usage_count = excluded.usage_count,
+        success_rate = excluded.success_rate,
+        consecutive_failures = excluded.consecutive_failures,
+        last_used_at = excluded.last_used_at,
+        updated_at = excluded.updated_at
+    `, [
+            entry.name, entry.description, entry.source, entry.category, entry.provider,
+            JSON.stringify(entry.inputSchema), JSON.stringify(entry.triggers),
+            JSON.stringify(entry.tags), JSON.stringify(entry.examples), entry.endpoint || '',
+            entry.searchText, entry.boostKeywords || '',
+            entry.embedding ? JSON.stringify(entry.embedding) : null, entry.name,
+            entry.usageCount, entry.successRate, entry.consecutiveFailures || 0,
+            entry.lastUsedAt || null,
+        ]);
+        if (this._batchMode) {
+            this._batchDirty = true;
+        }
+        else {
+            this._persist();
+        }
+    }
+    /** Remove a tool by name. */
+    remove(name) {
+        this._db.run('DELETE FROM tools WHERE name = ?', [name]);
+        this._persist();
+        return true;
+    }
+    /** Purge all tools by source (for re-sync). */
+    purgeBySource(source) {
+        this._db.run('DELETE FROM tools WHERE source = ?', [source]);
+        this._persist();
+    }
+    /** Load all tools from DB. */
+    loadAll() {
+        const results = this._db.exec('SELECT * FROM tools ORDER BY name');
+        if (results.length === 0)
+            return [];
+        const cols = results[0].columns;
+        return results[0].values.map(row => {
+            const obj = {};
+            cols.forEach((c, i) => { obj[c] = row[i]; });
+            return obj;
+        });
+    }
+    /** Persist DB to disk */
+    _persist() {
+        if (!this._db)
+            return;
+        const data = this._db.export();
+        fs_1.default.writeFileSync(this._dbPath, Buffer.from(data));
+    }
+    /** Close connection */
+    dispose() {
+        if (this._db) {
+            this._persist();
+            this._db.close();
+            this._db = null;
+        }
+    }
+}
+exports.Store = Store;
+//# sourceMappingURL=store.js.map

package/dist/lib/store.js.map

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

package/dist/lib/validator.d.ts

@@ -0,0 +1,37 @@
+import type { ValidationError } from '../types';
+/** Valid tool categories */
+export declare const VALID_CATEGORIES: readonly ["web", "data", "file", "dev", "ai", "capture", "misc"];
+/** Tool name pattern: verb_target (e.g. read_pdf, take_screenshot) */
+export declare const NAME_PATTERN: RegExp;
+/** Minimum description length */
+export declare const MIN_DESCRIPTION_LENGTH = 10;
+export interface ValidatableParams {
+    name?: string;
+    description?: string;
+    category?: string;
+    tags?: string[];
+    [key: string]: unknown;
+}
+interface RegistryLike {
+    get(name: string): unknown | null;
+}
+interface ValidationResult {
+    valid: boolean;
+    errors: ValidationError[];
+}
+/**
+ * Validate tool entry for registration.
+ * Pattern: accumulate errors → reject if any error exists.
+ */
+export declare function validateToolEntry(params: ValidatableParams, registry: RegistryLike): ValidationResult;
+/**
+ * Validate tool update params.
+ * Same rules as create, but no duplicate check (updating existing tool).
+ */
+export declare function validateUpdateEntry(params: ValidatableParams, existing: ValidatableParams): ValidationResult;
+/**
+ * Format validation errors as user-readable string.
+ */
+export declare function formatValidationErrors(errors: ValidationError[]): string;
+export {};
+//# sourceMappingURL=validator.d.ts.map

package/dist/lib/validator.js

@@ -0,0 +1,114 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.MIN_DESCRIPTION_LENGTH = exports.NAME_PATTERN = exports.VALID_CATEGORIES = void 0;
+exports.validateToolEntry = validateToolEntry;
+exports.validateUpdateEntry = validateUpdateEntry;
+exports.formatValidationErrors = formatValidationErrors;
+/** Valid tool categories */
+exports.VALID_CATEGORIES = ['web', 'data', 'file', 'dev', 'ai', 'capture', 'misc'];
+/** Tool name pattern: verb_target (e.g. read_pdf, take_screenshot) */
+exports.NAME_PATTERN = /^[a-z]+_[a-z][a-z0-9_]*$/;
+/** Minimum description length */
+exports.MIN_DESCRIPTION_LENGTH = 10;
+/** Validate name: required + verb_target format */
+function _validateName(name, errors) {
+    if (!name || name.trim() === '') {
+        errors.push({ field: 'name', message: 'name is required', severity: 'error' });
+    }
+    else if (!exports.NAME_PATTERN.test(name)) {
+        errors.push({ field: 'name', message: `'${name}' must follow verb_target format (e.g. read_pdf, take_screenshot)`, severity: 'error' });
+    }
+}
+/** Validate description: required + min length */
+function _validateDescription(desc, errors) {
+    if (!desc || desc.trim() === '') {
+        errors.push({ field: 'description', message: 'description is required (explain what the tool does)', severity: 'error' });
+    }
+    else if (desc.trim().length < exports.MIN_DESCRIPTION_LENGTH) {
+        errors.push({ field: 'description', message: `minimum ${exports.MIN_DESCRIPTION_LENGTH} characters required (current: ${desc.trim().length})`, severity: 'error' });
+    }
+}
+/** Validate category: must be in enum */
+function _validateCategory(category, errors) {
+    if (category && !exports.VALID_CATEGORIES.includes(category)) {
+        errors.push({ field: 'category', message: `'${category}' is not valid — use one of: ${exports.VALID_CATEGORIES.join(' | ')}`, severity: 'error' });
+    }
+}
+/**
+ * Validate tool entry for registration.
+ * Pattern: accumulate errors → reject if any error exists.
+ */
+function validateToolEntry(params, registry) {
+    const errors = [];
+    _validateName(params.name, errors);
+    _validateDescription(params.description, errors);
+    _validateCategory(params.category, errors);
+    // Rule 4: duplicate name check
+    if (params.name && registry && registry.get(params.name)) {
+        errors.push({ field: 'name', message: `'${params.name}' already exists. Use action: "update" instead`, severity: 'error' });
+    }
+    // Warning: no tags (search accuracy may be lower)
+    if (!params.tags || params.tags.length === 0) {
+        errors.push({ field: 'tags', message: 'no tags specified — search accuracy may be reduced', severity: 'warning' });
+    }
+    const errorCount = errors.filter(e => e.severity === 'error').length;
+    return { valid: errorCount === 0, errors };
+}
+/**
+ * Validate tool update params.
+ * Same rules as create, but no duplicate check (updating existing tool).
+ */
+function validateUpdateEntry(params, existing) {
+    const errors = [];
+    // Rule 1: name format (if changed)
+    if (params.name && !exports.NAME_PATTERN.test(params.name)) {
+        errors.push({
+            field: 'name',
+            message: `'${params.name}' must follow verb_target format (e.g. read_pdf, take_screenshot)`,
+            severity: 'error',
+        });
+    }
+    // Rule 2: description min length (if changed)
+    if (params.description && params.description.trim().length < exports.MIN_DESCRIPTION_LENGTH) {
+        errors.push({
+            field: 'description',
+            message: `minimum ${exports.MIN_DESCRIPTION_LENGTH} characters required (current: ${params.description.trim().length})`,
+            severity: 'error',
+        });
+    }
+    // Rule 2b: warn if description is shorter than existing
+    if (params.description && existing.description
+        && params.description.trim().length < existing.description.trim().length * 0.5) {
+        errors.push({
+            field: 'description',
+            message: `description is >50% shorter than existing (${existing.description.trim().length} → ${params.description.trim().length} chars)`,
+            severity: 'warning',
+        });
+    }
+    // Rule 3: category enum (if changed)
+    if (params.category && !exports.VALID_CATEGORIES.includes(params.category)) {
+        errors.push({
+            field: 'category',
+            message: `'${params.category}' is not valid — use one of: ${exports.VALID_CATEGORIES.join(' | ')}`,
+            severity: 'error',
+        });
+    }
+    const errorCount = errors.filter(e => e.severity === 'error').length;
+    return { valid: errorCount === 0, errors };
+}
+/**
+ * Format validation errors as user-readable string.
+ */
+function formatValidationErrors(errors) {
+    const errorCount = errors.filter(e => e.severity === 'error').length;
+    const warnCount = errors.filter(e => e.severity === 'warning').length;
+    const lines = errors.map(e => {
+        const icon = e.severity === 'error' ? '❌' : '⚠️';
+        return `  ${icon} [${e.field}] ${e.message}`;
+    });
+    const header = errorCount > 0
+        ? `Registration rejected (${errorCount} error${errorCount > 1 ? 's' : ''}${warnCount > 0 ? `, ${warnCount} warning` : ''}):`
+        : `Registration complete (${warnCount} warning${warnCount > 1 ? 's' : ''}):`;
+    return `${header}\n${lines.join('\n')}`;
+}
+//# sourceMappingURL=validator.js.map

package/dist/lib/validator.js.map

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

package/dist/lib/vector-index.d.ts

@@ -0,0 +1,37 @@
+import type { ToolEntry, VectorBuildResult, VectorStats } from '../types';
+/**
+ * Vector index — Float32Array matrix + category centroid partitioned search.
+ *
+ * Scaling:
+ *   100 tools → ~1ms
+ *   1,000 tools → ~3ms
+ *   10,000 tools → ~5ms (centroid hierarchy)
+ */
+export declare class VectorIndex {
+    private _matrix;
+    private _names;
+    private _dim;
+    private _count;
+    private _centroids;
+    private _partitions;
+    private _built;
+    constructor();
+    /**
+     * Build vector index from tool entries.
+     * Only indexes tools with embeddings, computes per-category centroids.
+     */
+    build(tools: ToolEntry[]): VectorBuildResult;
+    /**
+     * Centroid hierarchy search — top-K categories → scan within partition.
+     */
+    search(queryVec: number[], topK?: number, topCategories?: number): Array<{
+        name: string;
+        score: number;
+    }>;
+    stats(): VectorStats;
+    /** Reset index */
+    reset(): void;
+    /** Cosine similarity */
+    private _cosineSim;
+}
+//# sourceMappingURL=vector-index.d.ts.map

package/{lib → dist/lib}/vector-index.js

@@ -1,6 +1,6 @@
-// QLN — Float32Array vector index (centroid hierarchy)
-// Stage 3 semantic search only. ~3ms search at 1000 tools.
-
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.VectorIndex = void 0;
 /**
  * Vector index — Float32Array matrix + category centroid partitioned search.
  *
@@ -10,27 +10,25 @@
  *   10,000 tools → ~5ms (centroid hierarchy)
  */
 class VectorIndex {
+    _matrix;
+    _names;
+    _dim;
+    _count;
+    _centroids;
+    _partitions;
+    _built;
     constructor() {
-        /** @type {Float32Array|null} N tools × D dimensions */
         this._matrix = null;
-        /** @type {string[]} Tool names (matrix row order) */
         this._names = [];
-        /** @type {number} Embedding dimension */
         this._dim = 0;
-        /** @type {number} Number of indexed tools */
         this._count = 0;
-        /** @type {Map<string, Float32Array>} Category → centroid vector */
         this._centroids = new Map();
-        /** @type {Map<string, number[]>} Category → matrix row indices */
         this._partitions = new Map();
         this._built = false;
     }
-
     /**
      * Build vector index from tool entries.
      * Only indexes tools with embeddings, computes per-category centroids.
-     * @param {object[]} tools
-     * @returns {{indexed: number, categories: number, dimension: number}}
      */
     build(tools) {
         const valid = tools.filter(t => t.embedding && Array.isArray(t.embedding) && t.embedding.length > 0);
@@ -38,11 +36,9 @@ class VectorIndex {
             this._built = false;
             return { indexed: 0, categories: 0, dimension: 0 };
         }
-
         this._dim = valid[0].embedding.length;
         this._count = valid.length;
         this._names = valid.map(t => t.name);
-
         // Pack into Float32Array matrix
         this._matrix = new Float32Array(this._count * this._dim);
         for (let i = 0; i < this._count; i++) {
@@ -51,16 +47,15 @@ class VectorIndex {
                 this._matrix[i * this._dim + j] = vec[j] || 0;
             }
         }
-
         // Build category partitions
         this._partitions.clear();
         this._centroids.clear();
         for (let i = 0; i < valid.length; i++) {
             const cat = valid[i].category || 'misc';
-            if (!this._partitions.has(cat)) this._partitions.set(cat, []);
+            if (!this._partitions.has(cat))
+                this._partitions.set(cat, []);
             this._partitions.get(cat).push(i);
         }
-
         // Compute centroids (category average vector)
         for (const [cat, indices] of this._partitions) {
             const centroid = new Float32Array(this._dim);
@@ -71,26 +66,20 @@ class VectorIndex {
                 }
             }
             const n = indices.length;
-            for (let j = 0; j < this._dim; j++) centroid[j] /= n;
+            for (let j = 0; j < this._dim; j++)
+                centroid[j] /= n;
             this._centroids.set(cat, centroid);
         }
-
         this._built = true;
         return { indexed: this._count, categories: this._partitions.size, dimension: this._dim };
     }
-
     /**
      * Centroid hierarchy search — top-K categories → scan within partition.
-     * @param {number[]} queryVec
-     * @param {number} topK
-     * @param {number} topCategories
-     * @returns {{name: string, score: number}[]}
      */
     search(queryVec, topK = 10, topCategories = 4) {
-        if (!this._built || !this._matrix || !queryVec || queryVec.length !== this._dim) return [];
-
+        if (!this._built || !this._matrix || !queryVec || queryVec.length !== this._dim)
+            return [];
         const qVec = new Float32Array(queryVec);
-
         // Step 1: Rank categories by centroid similarity
         const catScores = [];
         for (const [cat, centroid] of this._centroids) {
@@ -98,7 +87,6 @@ class VectorIndex {
         }
         catScores.sort((a, b) => b.score - a.score);
         const selectedCats = catScores.slice(0, topCategories).map(c => c.cat);
-
         // Step 2: Search individual tools within selected partitions
         const candidates = [];
         for (const cat of selectedCats) {
@@ -107,12 +95,9 @@ class VectorIndex {
                 candidates.push({ name: this._names[idx], score: this._cosineSim(qVec, toolVec) });
             }
         }
-
         candidates.sort((a, b) => b.score - a.score);
         return candidates.slice(0, topK);
     }
-
-    /** @returns {object} */
     stats() {
         return {
             built: this._built,
@@ -123,7 +108,6 @@ class VectorIndex {
             memoryKB: this._matrix ? Math.round(this._matrix.byteLength / 1024) : 0,
         };
     }
-
     /** Reset index */
     reset() {
         this._matrix = null;
@@ -134,8 +118,7 @@ class VectorIndex {
         this._partitions.clear();
         this._built = false;
     }
-
-    /** @private Cosine similarity */
+    /** Cosine similarity */
     _cosineSim(a, b) {
         let dot = 0, normA = 0, normB = 0;
         for (let i = 0; i < a.length; i++) {
@@ -147,5 +130,5 @@ class VectorIndex {
         return denom === 0 ? 0 : dot / denom;
     }
 }
-
-module.exports = { VectorIndex };
+exports.VectorIndex = VectorIndex;
+//# sourceMappingURL=vector-index.js.map

package/dist/lib/vector-index.js.map

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

package/dist/tools/qln-call.d.ts

@@ -0,0 +1,41 @@
+import type { Router } from '../lib/router';
+import type { Executor } from '../lib/executor';
+import type { Registry } from '../lib/registry';
+import type { McpDiscovery } from '../lib/mcp-discovery';
+/** Zod-like validator interface (minimal) */
+interface ZodLike {
+    enum(values: readonly string[]): {
+        describe(d: string): unknown;
+    };
+    string(): {
+        optional(): {
+            describe(d: string): unknown;
+        };
+    };
+    number(): {
+        optional(): {
+            describe(d: string): unknown;
+        };
+    };
+    record(v: unknown): {
+        optional(): {
+            describe(d: string): unknown;
+        };
+    };
+    array(v: unknown): {
+        optional(): {
+            describe(d: string): unknown;
+        };
+    };
+    unknown(): unknown;
+}
+/** MCP server interface (minimal — uses any to match SDK's complex overloads) */
+interface McpServerLike {
+    tool(...args: unknown[]): unknown;
+}
+/**
+ * Register the unified n2_qln_call MCP tool.
+ */
+export declare function registerQlnCall(server: McpServerLike, z: ZodLike, router: Router, executor: Executor, registry: Registry, discovery?: McpDiscovery | null): void;
+export {};
+//# sourceMappingURL=qln-call.d.ts.map