toolpack-sdk 0.1.0-SNAPSHOT

package/dist/tools/search/bm25-engine.js

@@ -0,0 +1,218 @@
+"use strict";
+/**
+ * BM25 Search Engine for Tool Discovery
+ *
+ * BM25 (Best Matching 25) is the industry-standard ranking algorithm used by:
+ * - Elasticsearch
+ * - Anthropic's Tool Search
+ * - Apache Lucene/Solr
+ *
+ * Searches across: name, displayName, description, category, parameter names
+ * Returns: Top N tools ranked by relevance score
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.BM25SearchEngine = void 0;
+// Field weights for scoring (higher = more important)
+const FIELD_WEIGHTS = {
+    name: 3.0,
+    displayName: 2.5,
+    description: 2.0,
+    category: 1.5,
+    parameterNames: 1.0,
+    parameterDescriptions: 0.5,
+};
+// ── BM25 Search Engine ───────────────────────────────────────────────────────
+class BM25SearchEngine {
+    documents = [];
+    avgDocLength = 0;
+    idf = new Map();
+    totalDocs = 0;
+    docFrequencies = new Map();
+    // BM25 hyperparameters (tuned for short documents like tool descriptions)
+    k1 = 1.2; // Term frequency saturation parameter
+    b = 0.75; // Document length normalization parameter
+    /**
+     * Index all tools for search.
+     * Call this once after loading all tools.
+     */
+    index(tools) {
+        this.documents = [];
+        this.docFrequencies.clear();
+        this.idf.clear();
+        // Create documents with weighted text
+        for (const tool of tools) {
+            const doc = this.createDocument(tool);
+            this.documents.push(doc);
+            // Count document frequencies for IDF
+            const uniqueTerms = new Set(doc.tokens);
+            for (const term of uniqueTerms) {
+                this.docFrequencies.set(term, (this.docFrequencies.get(term) || 0) + 1);
+            }
+        }
+        this.totalDocs = this.documents.length;
+        this.computeIDF();
+        this.avgDocLength = this.computeAvgDocLength();
+    }
+    /**
+     * Search for tools matching the query.
+     * Returns top N results sorted by relevance score.
+     */
+    search(query, options) {
+        const limit = options?.limit ?? 5;
+        const category = options?.category;
+        const minScore = options?.minScore ?? 0;
+        const queryTerms = this.tokenize(query.toLowerCase());
+        if (queryTerms.length === 0) {
+            return [];
+        }
+        const scores = [];
+        for (const doc of this.documents) {
+            // Category filter
+            if (category && doc.tool.category !== category) {
+                continue;
+            }
+            const score = this.computeBM25Score(queryTerms, doc);
+            if (score > minScore) {
+                scores.push({
+                    toolName: doc.toolName,
+                    score,
+                    tool: doc.tool,
+                });
+            }
+        }
+        // Sort by score descending, return top N
+        return scores
+            .sort((a, b) => b.score - a.score)
+            .slice(0, limit)
+            .map(({ toolName, score, tool }) => ({
+            toolName,
+            score,
+            tool: this.toSchema(tool),
+        }));
+    }
+    /**
+     * Get the number of indexed tools.
+     */
+    getIndexedCount() {
+        return this.documents.length;
+    }
+    /**
+     * Check if a tool is indexed.
+     */
+    isIndexed(toolName) {
+        return this.documents.some(d => d.toolName === toolName);
+    }
+    // ── Private Methods ──────────────────────────────────────────────────────
+    createDocument(tool) {
+        // Build weighted text from all searchable fields
+        const textParts = [];
+        // Name (highest weight - repeat to increase term frequency)
+        for (let i = 0; i < FIELD_WEIGHTS.name; i++) {
+            textParts.push(tool.name);
+        }
+        // Display name
+        for (let i = 0; i < FIELD_WEIGHTS.displayName; i++) {
+            textParts.push(tool.displayName);
+        }
+        // Description
+        for (let i = 0; i < FIELD_WEIGHTS.description; i++) {
+            textParts.push(tool.description);
+        }
+        // Category
+        for (let i = 0; i < FIELD_WEIGHTS.category; i++) {
+            textParts.push(tool.category);
+        }
+        // Parameter names and descriptions
+        if (tool.parameters?.properties) {
+            for (const [paramName, paramDef] of Object.entries(tool.parameters.properties)) {
+                for (let i = 0; i < FIELD_WEIGHTS.parameterNames; i++) {
+                    textParts.push(paramName);
+                }
+                if (paramDef.description) {
+                    for (let i = 0; i < FIELD_WEIGHTS.parameterDescriptions; i++) {
+                        textParts.push(paramDef.description);
+                    }
+                }
+            }
+        }
+        const text = textParts.join(' ').toLowerCase();
+        const tokens = this.tokenize(text);
+        const termFrequencies = this.computeTermFrequencies(tokens);
+        return {
+            toolName: tool.name,
+            tool,
+            text,
+            tokens,
+            length: tokens.length,
+            termFrequencies,
+        };
+    }
+    tokenize(text) {
+        // Split on non-alphanumeric, filter empty, dedupe common words
+        return text
+            .toLowerCase()
+            .split(/[^a-z0-9]+/)
+            .filter(token => token.length > 1)
+            .filter(token => !STOP_WORDS.has(token));
+    }
+    computeTermFrequencies(tokens) {
+        const frequencies = new Map();
+        for (const token of tokens) {
+            frequencies.set(token, (frequencies.get(token) || 0) + 1);
+        }
+        return frequencies;
+    }
+    computeIDF() {
+        this.idf.clear();
+        for (const [term, docFreq] of this.docFrequencies) {
+            // IDF formula: log((N - df + 0.5) / (df + 0.5) + 1)
+            // This is the BM25 IDF variant that handles edge cases better
+            const idf = Math.log((this.totalDocs - docFreq + 0.5) / (docFreq + 0.5) + 1);
+            this.idf.set(term, idf);
+        }
+    }
+    computeAvgDocLength() {
+        if (this.documents.length === 0)
+            return 0;
+        const totalLength = this.documents.reduce((sum, doc) => sum + doc.length, 0);
+        return totalLength / this.documents.length;
+    }
+    computeBM25Score(queryTerms, doc) {
+        let score = 0;
+        for (const term of queryTerms) {
+            const tf = doc.termFrequencies.get(term) || 0;
+            if (tf === 0)
+                continue;
+            const idf = this.idf.get(term) || 0;
+            const docLength = doc.length;
+            // BM25 scoring formula
+            const numerator = tf * (this.k1 + 1);
+            const denominator = tf + this.k1 * (1 - this.b + this.b * (docLength / this.avgDocLength));
+            score += idf * (numerator / denominator);
+        }
+        return score;
+    }
+    toSchema(tool) {
+        return {
+            name: tool.name,
+            displayName: tool.displayName,
+            description: tool.description,
+            parameters: tool.parameters,
+            category: tool.category,
+        };
+    }
+}
+exports.BM25SearchEngine = BM25SearchEngine;
+// ── Stop Words ───────────────────────────────────────────────────────────────
+const STOP_WORDS = new Set([
+    'a', 'an', 'the', 'and', 'or', 'but', 'in', 'on', 'at', 'to', 'for',
+    'of', 'with', 'by', 'from', 'as', 'is', 'was', 'are', 'were', 'been',
+    'be', 'have', 'has', 'had', 'do', 'does', 'did', 'will', 'would',
+    'could', 'should', 'may', 'might', 'must', 'shall', 'can', 'need',
+    'it', 'its', 'this', 'that', 'these', 'those', 'i', 'you', 'he',
+    'she', 'we', 'they', 'what', 'which', 'who', 'whom', 'when', 'where',
+    'why', 'how', 'all', 'each', 'every', 'both', 'few', 'more', 'most',
+    'other', 'some', 'such', 'no', 'nor', 'not', 'only', 'own', 'same',
+    'so', 'than', 'too', 'very', 'just', 'also', 'now', 'here', 'there',
+]);
+//# sourceMappingURL=bm25-engine.js.map

package/dist/tools/search/bm25-engine.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"bm25-engine.js","sourceRoot":"","sources":["../../../src/tools/search/bm25-engine.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;GAUG;;;AA2BH,sDAAsD;AACtD,MAAM,aAAa,GAAG;IAClB,IAAI,EAAE,GAAG;IACT,WAAW,EAAE,GAAG;IAChB,WAAW,EAAE,GAAG;IAChB,QAAQ,EAAE,GAAG;IACb,cAAc,EAAE,GAAG;IACnB,qBAAqB,EAAE,GAAG;CAC7B,CAAC;AAEF,gFAAgF;AAEhF,MAAa,gBAAgB;IACjB,SAAS,GAAmB,EAAE,CAAC;IAC/B,YAAY,GAAW,CAAC,CAAC;IACzB,GAAG,GAAwB,IAAI,GAAG,EAAE,CAAC;IACrC,SAAS,GAAW,CAAC,CAAC;IACtB,cAAc,GAAwB,IAAI,GAAG,EAAE,CAAC;IAExD,0EAA0E;IAClE,EAAE,GAAG,GAAG,CAAC,CAAE,sCAAsC;IACjD,CAAC,GAAG,IAAI,CAAC,CAAE,0CAA0C;IAE7D;;;OAGG;IACH,KAAK,CAAC,KAAuB;QACzB,IAAI,CAAC,SAAS,GAAG,EAAE,CAAC;QACpB,IAAI,CAAC,cAAc,CAAC,KAAK,EAAE,CAAC;QAC5B,IAAI,CAAC,GAAG,CAAC,KAAK,EAAE,CAAC;QAEjB,sCAAsC;QACtC,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;YACvB,MAAM,GAAG,GAAG,IAAI,CAAC,cAAc,CAAC,IAAI,CAAC,CAAC;YACtC,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;YAEzB,qCAAqC;YACrC,MAAM,WAAW,GAAG,IAAI,GAAG,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;YACxC,KAAK,MAAM,IAAI,IAAI,WAAW,EAAE,CAAC;gBAC7B,IAAI,CAAC,cAAc,CAAC,GAAG,CAAC,IAAI,EAAE,CAAC,IAAI,CAAC,cAAc,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC;YAC5E,CAAC;QACL,CAAC;QAED,IAAI,CAAC,SAAS,GAAG,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC;QACvC,IAAI,CAAC,UAAU,EAAE,CAAC;QAClB,IAAI,CAAC,YAAY,GAAG,IAAI,CAAC,mBAAmB,EAAE,CAAC;IACnD,CAAC;IAED;;;OAGG;IACH,MAAM,CAAC,KAAa,EAAE,OAAuB;QACzC,MAAM,KAAK,GAAG,OAAO,EAAE,KAAK,IAAI,CAAC,CAAC;QAClC,MAAM,QAAQ,GAAG,OAAO,EAAE,QAAQ,CAAC;QACnC,MAAM,QAAQ,GAAG,OAAO,EAAE,QAAQ,IAAI,CAAC,CAAC;QAExC,MAAM,UAAU,GAAG,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC,WAAW,EAAE,CAAC,CAAC;QACtD,IAAI,UAAU,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YAC1B,OAAO,EAAE,CAAC;QACd,CAAC;QAED,MAAM,MAAM,GAAqE,EAAE,CAAC;QAEpF,KAAK,MAAM,GAAG,IAAI,IAAI,CAAC,SAAS,EAAE,CAAC;YAC/B,kBAAkB;YAClB,IAAI,QAAQ,IAAI,GAAG,CAAC,IAAI,CAAC,QAAQ,KAAK,QAAQ,EAAE,CAAC;gBAC7C,SAAS;YACb,CAAC;YAED,MAAM,KAAK,GAAG,IAAI,CAAC,gBAAgB,CAAC,UAAU,EAAE,GAAG,CAAC,CAAC;YACrD,IAAI,KAAK,GAAG,QAAQ,EAAE,CAAC;gBACnB,MAAM,CAAC,IAAI,CAAC;oBACR,QAAQ,EAAE,GAAG,CAAC,QAAQ;oBACtB,KAAK;oBACL,IAAI,EAAE,GAAG,CAAC,IAAI;iBACjB,CAAC,CAAC;YACP,CAAC;QACL,CAAC;QAED,yCAAyC;QACzC,OAAO,MAAM;aACR,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK,GAAG,CAAC,CAAC,KAAK,CAAC;aACjC,KAAK,CAAC,CAAC,EAAE,KAAK,CAAC;aACf,GAAG,CAAC,CAAC,EAAE,QAAQ,EAAE,KAAK,EAAE,IAAI,EAAE,EAAE,EAAE,CAAC,CAAC;YACjC,QAAQ;YACR,KAAK;YACL,IAAI,EAAE,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC;SAC5B,CAAC,CAAC,CAAC;IACZ,CAAC;IAED;;OAEG;IACH,eAAe;QACX,OAAO,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC;IACjC,CAAC;IAED;;OAEG;IACH,SAAS,CAAC,QAAgB;QACtB,OAAO,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,QAAQ,KAAK,QAAQ,CAAC,CAAC;IAC7D,CAAC;IAED,4EAA4E;IAEpE,cAAc,CAAC,IAAoB;QACvC,iDAAiD;QACjD,MAAM,SAAS,GAAa,EAAE,CAAC;QAE/B,4DAA4D;QAC5D,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,aAAa,CAAC,IAAI,EAAE,CAAC,EAAE,EAAE,CAAC;YAC1C,SAAS,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAC9B,CAAC;QAED,eAAe;QACf,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,aAAa,CAAC,WAAW,EAAE,CAAC,EAAE,EAAE,CAAC;YACjD,SAAS,CAAC,IAAI,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC;QACrC,CAAC;QAED,cAAc;QACd,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,aAAa,CAAC,WAAW,EAAE,CAAC,EAAE,EAAE,CAAC;YACjD,SAAS,CAAC,IAAI,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC;QACrC,CAAC;QAED,WAAW;QACX,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,aAAa,CAAC,QAAQ,EAAE,CAAC,EAAE,EAAE,CAAC;YAC9C,SAAS,CAAC,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;QAClC,CAAC;QAED,mCAAmC;QACnC,IAAI,IAAI,CAAC,UAAU,EAAE,UAAU,EAAE,CAAC;YAC9B,KAAK,MAAM,CAAC,SAAS,EAAE,QAAQ,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,UAAU,CAAC,UAAU,CAAC,EAAE,CAAC;gBAC7E,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,aAAa,CAAC,cAAc,EAAE,CAAC,EAAE,EAAE,CAAC;oBACpD,SAAS,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;gBAC9B,CAAC;gBACD,IAAI,QAAQ,CAAC,WAAW,EAAE,CAAC;oBACvB,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,aAAa,CAAC,qBAAqB,EAAE,CAAC,EAAE,EAAE,CAAC;wBAC3D,SAAS,CAAC,IAAI,CAAC,QAAQ,CAAC,WAAW,CAAC,CAAC;oBACzC,CAAC;gBACL,CAAC;YACL,CAAC;QACL,CAAC;QAED,MAAM,IAAI,GAAG,SAAS,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,WAAW,EAAE,CAAC;QAC/C,MAAM,MAAM,GAAG,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC;QACnC,MAAM,eAAe,GAAG,IAAI,CAAC,sBAAsB,CAAC,MAAM,CAAC,CAAC;QAE5D,OAAO;YACH,QAAQ,EAAE,IAAI,CAAC,IAAI;YACnB,IAAI;YACJ,IAAI;YACJ,MAAM;YACN,MAAM,EAAE,MAAM,CAAC,MAAM;YACrB,eAAe;SAClB,CAAC;IACN,CAAC;IAEO,QAAQ,CAAC,IAAY;QACzB,+DAA+D;QAC/D,OAAO,IAAI;aACN,WAAW,EAAE;aACb,KAAK,CAAC,YAAY,CAAC;aACnB,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC;aACjC,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC,UAAU,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC;IACjD,CAAC;IAEO,sBAAsB,CAAC,MAAgB;QAC3C,MAAM,WAAW,GAAG,IAAI,GAAG,EAAkB,CAAC;QAC9C,KAAK,MAAM,KAAK,IAAI,MAAM,EAAE,CAAC;YACzB,WAAW,CAAC,GAAG,CAAC,KAAK,EAAE,CAAC,WAAW,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC;QAC9D,CAAC;QACD,OAAO,WAAW,CAAC;IACvB,CAAC;IAEO,UAAU;QACd,IAAI,CAAC,GAAG,CAAC,KAAK,EAAE,CAAC;QACjB,KAAK,MAAM,CAAC,IAAI,EAAE,OAAO,CAAC,IAAI,IAAI,CAAC,cAAc,EAAE,CAAC;YAChD,oDAAoD;YACpD,8DAA8D;YAC9D,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,SAAS,GAAG,OAAO,GAAG,GAAG,CAAC,GAAG,CAAC,OAAO,GAAG,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC;YAC7E,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,IAAI,EAAE,GAAG,CAAC,CAAC;QAC5B,CAAC;IACL,CAAC;IAEO,mBAAmB;QACvB,IAAI,IAAI,CAAC,SAAS,CAAC,MAAM,KAAK,CAAC;YAAE,OAAO,CAAC,CAAC;QAC1C,MAAM,WAAW,GAAG,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC,GAAG,EAAE,GAAG,EAAE,EAAE,CAAC,GAAG,GAAG,GAAG,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC;QAC7E,OAAO,WAAW,GAAG,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC;IAC/C,CAAC;IAEO,gBAAgB,CAAC,UAAoB,EAAE,GAAiB;QAC5D,IAAI,KAAK,GAAG,CAAC,CAAC;QAEd,KAAK,MAAM,IAAI,IAAI,UAAU,EAAE,CAAC;YAC5B,MAAM,EAAE,GAAG,GAAG,CAAC,eAAe,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;YAC9C,IAAI,EAAE,KAAK,CAAC;gBAAE,SAAS;YAEvB,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;YACpC,MAAM,SAAS,GAAG,GAAG,CAAC,MAAM,CAAC;YAE7B,uBAAuB;YACvB,MAAM,SAAS,GAAG,EAAE,GAAG,CAAC,IAAI,CAAC,EAAE,GAAG,CAAC,CAAC,CAAC;YACrC,MAAM,WAAW,GAAG,EAAE,GAAG,IAAI,CAAC,EAAE,GAAG,CAAC,CAAC,GAAG,IAAI,CAAC,CAAC,GAAG,IAAI,CAAC,CAAC,GAAG,CAAC,SAAS,GAAG,IAAI,CAAC,YAAY,CAAC,CAAC,CAAC;YAC3F,KAAK,IAAI,GAAG,GAAG,CAAC,SAAS,GAAG,WAAW,CAAC,CAAC;QAC7C,CAAC;QAED,OAAO,KAAK,CAAC;IACjB,CAAC;IAEO,QAAQ,CAAC,IAAoB;QACjC,OAAO;YACH,IAAI,EAAE,IAAI,CAAC,IAAI;YACf,WAAW,EAAE,IAAI,CAAC,WAAW;YAC7B,WAAW,EAAE,IAAI,CAAC,WAAW;YAC7B,UAAU,EAAE,IAAI,CAAC,UAAU;YAC3B,QAAQ,EAAE,IAAI,CAAC,QAAQ;SAC1B,CAAC;IACN,CAAC;CACJ;AAjND,4CAiNC;AAED,gFAAgF;AAEhF,MAAM,UAAU,GAAG,IAAI,GAAG,CAAC;IACvB,GAAG,EAAE,IAAI,EAAE,KAAK,EAAE,KAAK,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,KAAK;IACnE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,IAAI,EAAE,KAAK,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM;IACpE,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,KAAK,EAAE,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,OAAO;IAChE,OAAO,EAAE,QAAQ,EAAE,KAAK,EAAE,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,KAAK,EAAE,MAAM;IACjE,IAAI,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,EAAE,GAAG,EAAE,KAAK,EAAE,IAAI;IAC/D,KAAK,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO;IACpE,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM;IACnE,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,KAAK,EAAE,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM;IAClE,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,OAAO;CACtE,CAAC,CAAC"}

package/dist/tools/search/index.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Tool Search Module
+ *
+ * Provides industry-standard tool discovery using BM25 ranking,
+ * automatic caching, and the tool.search meta-tool.
+ */
+export { BM25SearchEngine, SearchOptions, SearchResult } from './bm25-engine.js';
+export { ToolDiscoveryCache, SearchHistoryEntry } from './tool-cache.js';
+export { toolSearchDefinition, getToolSearchSchema, isToolSearchTool, TOOL_SEARCH_NAME } from './tool-search.js';
+export { generateToolCategoriesPrompt } from './system-prompt.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/tools/search/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/tools/search/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,gBAAgB,EAAE,aAAa,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC;AACjF,OAAO,EAAE,kBAAkB,EAAE,kBAAkB,EAAE,MAAM,iBAAiB,CAAC;AACzE,OAAO,EACH,oBAAoB,EACpB,mBAAmB,EACnB,gBAAgB,EAChB,gBAAgB,EACnB,MAAM,kBAAkB,CAAC;AAC1B,OAAO,EAAE,4BAA4B,EAAE,MAAM,oBAAoB,CAAC"}

package/dist/tools/search/index.js

@@ -0,0 +1,21 @@
+"use strict";
+/**
+ * Tool Search Module
+ *
+ * Provides industry-standard tool discovery using BM25 ranking,
+ * automatic caching, and the tool.search meta-tool.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.generateToolCategoriesPrompt = exports.TOOL_SEARCH_NAME = exports.isToolSearchTool = exports.getToolSearchSchema = exports.toolSearchDefinition = exports.ToolDiscoveryCache = exports.BM25SearchEngine = void 0;
+var bm25_engine_js_1 = require("./bm25-engine.js");
+Object.defineProperty(exports, "BM25SearchEngine", { enumerable: true, get: function () { return bm25_engine_js_1.BM25SearchEngine; } });
+var tool_cache_js_1 = require("./tool-cache.js");
+Object.defineProperty(exports, "ToolDiscoveryCache", { enumerable: true, get: function () { return tool_cache_js_1.ToolDiscoveryCache; } });
+var tool_search_js_1 = require("./tool-search.js");
+Object.defineProperty(exports, "toolSearchDefinition", { enumerable: true, get: function () { return tool_search_js_1.toolSearchDefinition; } });
+Object.defineProperty(exports, "getToolSearchSchema", { enumerable: true, get: function () { return tool_search_js_1.getToolSearchSchema; } });
+Object.defineProperty(exports, "isToolSearchTool", { enumerable: true, get: function () { return tool_search_js_1.isToolSearchTool; } });
+Object.defineProperty(exports, "TOOL_SEARCH_NAME", { enumerable: true, get: function () { return tool_search_js_1.TOOL_SEARCH_NAME; } });
+var system_prompt_js_1 = require("./system-prompt.js");
+Object.defineProperty(exports, "generateToolCategoriesPrompt", { enumerable: true, get: function () { return system_prompt_js_1.generateToolCategoriesPrompt; } });
+//# sourceMappingURL=index.js.map

package/dist/tools/search/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/tools/search/index.ts"],"names":[],"mappings":";AAAA;;;;;GAKG;;;AAEH,mDAAiF;AAAxE,kHAAA,gBAAgB,OAAA;AACzB,iDAAyE;AAAhE,mHAAA,kBAAkB,OAAA;AAC3B,mDAK0B;AAJtB,sHAAA,oBAAoB,OAAA;AACpB,qHAAA,mBAAmB,OAAA;AACnB,kHAAA,gBAAgB,OAAA;AAChB,kHAAA,gBAAgB,OAAA;AAEpB,uDAAkE;AAAzD,gIAAA,4BAA4B,OAAA"}

package/dist/tools/search/system-prompt.d.ts

@@ -0,0 +1,20 @@
+/**
+ * System Prompt Generator for Tool Search
+ *
+ * Generates system prompt sections describing available tool categories.
+ * This helps the AI know what's available before searching.
+ *
+ * OpenAI Best Practice:
+ * "Add a system prompt section describing available tool categories"
+ */
+import { ToolRegistry } from '../registry.js';
+/**
+ * Generate a system prompt section describing available tool categories.
+ * Include this in the system prompt when tool search is enabled.
+ */
+export declare function generateToolCategoriesPrompt(registry: ToolRegistry): string;
+/**
+ * Generate a compact tool categories summary (for token efficiency).
+ */
+export declare function generateCompactCategoriesPrompt(registry: ToolRegistry): string;
+//# sourceMappingURL=system-prompt.d.ts.map

package/dist/tools/search/system-prompt.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"system-prompt.d.ts","sourceRoot":"","sources":["../../../src/tools/search/system-prompt.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAc9C;;;GAGG;AACH,wBAAgB,4BAA4B,CAAC,QAAQ,EAAE,YAAY,GAAG,MAAM,CAwB3E;AAED;;GAEG;AACH,wBAAgB,+BAA+B,CAAC,QAAQ,EAAE,YAAY,GAAG,MAAM,CAc9E"}

package/dist/tools/search/system-prompt.js

@@ -0,0 +1,62 @@
+"use strict";
+/**
+ * System Prompt Generator for Tool Search
+ *
+ * Generates system prompt sections describing available tool categories.
+ * This helps the AI know what's available before searching.
+ *
+ * OpenAI Best Practice:
+ * "Add a system prompt section describing available tool categories"
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.generateToolCategoriesPrompt = generateToolCategoriesPrompt;
+exports.generateCompactCategoriesPrompt = generateCompactCategoriesPrompt;
+// ── Category Descriptions ────────────────────────────────────────────────────
+const CATEGORY_DESCRIPTIONS = {
+    filesystem: 'File operations (read, write, delete, list, search files)',
+    network: 'HTTP requests and web scraping (GET, POST, fetch pages, extract data)',
+    execution: 'Run shell commands and manage processes',
+    system: 'System information, environment variables, disk usage',
+    meta: 'Tool discovery and management',
+};
+// ── System Prompt Generator ──────────────────────────────────────────────────
+/**
+ * Generate a system prompt section describing available tool categories.
+ * Include this in the system prompt when tool search is enabled.
+ */
+function generateToolCategoriesPrompt(registry) {
+    const categories = registry.getCategories();
+    if (categories.length === 0) {
+        return 'No tools are currently available.';
+    }
+    const lines = [
+        'You have access to tools in the following categories:',
+        '',
+    ];
+    for (const category of categories) {
+        const tools = registry.getByCategory(category);
+        const count = tools.length;
+        const desc = CATEGORY_DESCRIPTIONS[category] || category;
+        lines.push(`- **${category}** (${count} tools): ${desc}`);
+    }
+    lines.push('');
+    lines.push('Use `tool.search` to discover specific tools when needed.');
+    lines.push('Example: tool.search({ query: "read file" }) to find file reading tools.');
+    return lines.join('\n');
+}
+/**
+ * Generate a compact tool categories summary (for token efficiency).
+ */
+function generateCompactCategoriesPrompt(registry) {
+    const categories = registry.getCategories();
+    if (categories.length === 0) {
+        return '';
+    }
+    const parts = [];
+    for (const category of categories) {
+        const count = registry.getByCategory(category).length;
+        parts.push(`${category}(${count})`);
+    }
+    return `Available tool categories: ${parts.join(', ')}. Use tool.search to discover tools.`;
+}
+//# sourceMappingURL=system-prompt.js.map

package/dist/tools/search/system-prompt.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"system-prompt.js","sourceRoot":"","sources":["../../../src/tools/search/system-prompt.ts"],"names":[],"mappings":";AAAA;;;;;;;;GAQG;;AAoBH,oEAwBC;AAKD,0EAcC;AA3DD,gFAAgF;AAEhF,MAAM,qBAAqB,GAA2B;IAClD,UAAU,EAAE,2DAA2D;IACvE,OAAO,EAAE,uEAAuE;IAChF,SAAS,EAAE,yCAAyC;IACpD,MAAM,EAAE,uDAAuD;IAC/D,IAAI,EAAE,+BAA+B;CACxC,CAAC;AAEF,gFAAgF;AAEhF;;;GAGG;AACH,SAAgB,4BAA4B,CAAC,QAAsB;IAC/D,MAAM,UAAU,GAAG,QAAQ,CAAC,aAAa,EAAE,CAAC;IAE5C,IAAI,UAAU,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC1B,OAAO,mCAAmC,CAAC;IAC/C,CAAC;IAED,MAAM,KAAK,GAAa;QACpB,uDAAuD;QACvD,EAAE;KACL,CAAC;IAEF,KAAK,MAAM,QAAQ,IAAI,UAAU,EAAE,CAAC;QAChC,MAAM,KAAK,GAAG,QAAQ,CAAC,aAAa,CAAC,QAAQ,CAAC,CAAC;QAC/C,MAAM,KAAK,GAAG,KAAK,CAAC,MAAM,CAAC;QAC3B,MAAM,IAAI,GAAG,qBAAqB,CAAC,QAAQ,CAAC,IAAI,QAAQ,CAAC;QACzD,KAAK,CAAC,IAAI,CAAC,OAAO,QAAQ,OAAO,KAAK,YAAY,IAAI,EAAE,CAAC,CAAC;IAC9D,CAAC;IAED,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACf,KAAK,CAAC,IAAI,CAAC,2DAA2D,CAAC,CAAC;IACxE,KAAK,CAAC,IAAI,CAAC,0EAA0E,CAAC,CAAC;IAEvF,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAC5B,CAAC;AAED;;GAEG;AACH,SAAgB,+BAA+B,CAAC,QAAsB;IAClE,MAAM,UAAU,GAAG,QAAQ,CAAC,aAAa,EAAE,CAAC;IAE5C,IAAI,UAAU,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC1B,OAAO,EAAE,CAAC;IACd,CAAC;IAED,MAAM,KAAK,GAAa,EAAE,CAAC;IAC3B,KAAK,MAAM,QAAQ,IAAI,UAAU,EAAE,CAAC;QAChC,MAAM,KAAK,GAAG,QAAQ,CAAC,aAAa,CAAC,QAAQ,CAAC,CAAC,MAAM,CAAC;QACtD,KAAK,CAAC,IAAI,CAAC,GAAG,QAAQ,IAAI,KAAK,GAAG,CAAC,CAAC;IACxC,CAAC;IAED,OAAO,8BAA8B,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,sCAAsC,CAAC;AAChG,CAAC"}

package/dist/tools/search/tool-cache.d.ts

@@ -0,0 +1,56 @@
+/**
+ * Tool Discovery Cache
+ *
+ * Tracks tools discovered via tool.search in the current conversation.
+ * Discovered tools are automatically included in subsequent requests.
+ *
+ * This matches Anthropic's behavior:
+ * "The system automatically expands tool_reference blocks throughout
+ *  the entire conversation history, so Claude can reuse discovered
+ *  tools in subsequent turns without re-searching."
+ */
+import { Message } from '../../types/index.js';
+export interface SearchHistoryEntry {
+    query: string;
+    tools: string[];
+    timestamp: number;
+}
+export declare class ToolDiscoveryCache {
+    private discoveredTools;
+    private searchHistory;
+    /**
+     * Record tools discovered from a search result.
+     */
+    recordDiscovery(searchQuery: string, toolNames: string[]): void;
+    /**
+     * Get all tools discovered in this conversation.
+     */
+    getDiscoveredTools(): string[];
+    /**
+     * Check if a tool was discovered (can be called without re-search).
+     */
+    isDiscovered(toolName: string): boolean;
+    /**
+     * Get the number of discovered tools.
+     */
+    getDiscoveredCount(): number;
+    /**
+     * Get search history.
+     */
+    getSearchHistory(): SearchHistoryEntry[];
+    /**
+     * Extract discovered tools from conversation history.
+     * Used for resuming conversations or loading from storage.
+     */
+    static fromMessages(messages: Message[]): ToolDiscoveryCache;
+    /**
+     * Clear cache (call when starting a new conversation).
+     */
+    clear(): void;
+    /**
+     * Merge another cache into this one.
+     * Useful for combining caches from different sources.
+     */
+    merge(other: ToolDiscoveryCache): void;
+}
+//# sourceMappingURL=tool-cache.d.ts.map

package/dist/tools/search/tool-cache.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tool-cache.d.ts","sourceRoot":"","sources":["../../../src/tools/search/tool-cache.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,EAAE,OAAO,EAAE,MAAM,sBAAsB,CAAC;AAI/C,MAAM,WAAW,kBAAkB;IAC/B,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,EAAE,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;CACrB;AAID,qBAAa,kBAAkB;IAC3B,OAAO,CAAC,eAAe,CAA0B;IACjD,OAAO,CAAC,aAAa,CAA4B;IAEjD;;OAEG;IACH,eAAe,CAAC,WAAW,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,GAAG,IAAI;IAW/D;;OAEG;IACH,kBAAkB,IAAI,MAAM,EAAE;IAI9B;;OAEG;IACH,YAAY,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO;IAIvC;;OAEG;IACH,kBAAkB,IAAI,MAAM;IAI5B;;OAEG;IACH,gBAAgB,IAAI,kBAAkB,EAAE;IAIxC;;;OAGG;IACH,MAAM,CAAC,YAAY,CAAC,QAAQ,EAAE,OAAO,EAAE,GAAG,kBAAkB;IA8B5D;;OAEG;IACH,KAAK,IAAI,IAAI;IAKb;;;OAGG;IACH,KAAK,CAAC,KAAK,EAAE,kBAAkB,GAAG,IAAI;CAMzC"}

package/dist/tools/search/tool-cache.js

@@ -0,0 +1,107 @@
+"use strict";
+/**
+ * Tool Discovery Cache
+ *
+ * Tracks tools discovered via tool.search in the current conversation.
+ * Discovered tools are automatically included in subsequent requests.
+ *
+ * This matches Anthropic's behavior:
+ * "The system automatically expands tool_reference blocks throughout
+ *  the entire conversation history, so Claude can reuse discovered
+ *  tools in subsequent turns without re-searching."
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ToolDiscoveryCache = void 0;
+// ── Tool Discovery Cache ─────────────────────────────────────────────────────
+class ToolDiscoveryCache {
+    discoveredTools = new Set();
+    searchHistory = [];
+    /**
+     * Record tools discovered from a search result.
+     */
+    recordDiscovery(searchQuery, toolNames) {
+        for (const name of toolNames) {
+            this.discoveredTools.add(name);
+        }
+        this.searchHistory.push({
+            query: searchQuery,
+            tools: toolNames,
+            timestamp: Date.now(),
+        });
+    }
+    /**
+     * Get all tools discovered in this conversation.
+     */
+    getDiscoveredTools() {
+        return Array.from(this.discoveredTools);
+    }
+    /**
+     * Check if a tool was discovered (can be called without re-search).
+     */
+    isDiscovered(toolName) {
+        return this.discoveredTools.has(toolName);
+    }
+    /**
+     * Get the number of discovered tools.
+     */
+    getDiscoveredCount() {
+        return this.discoveredTools.size;
+    }
+    /**
+     * Get search history.
+     */
+    getSearchHistory() {
+        return [...this.searchHistory];
+    }
+    /**
+     * Extract discovered tools from conversation history.
+     * Used for resuming conversations or loading from storage.
+     */
+    static fromMessages(messages) {
+        const cache = new ToolDiscoveryCache();
+        for (const msg of messages) {
+            // Look for tool results from tool.search
+            if (msg.role === 'tool') {
+                const toolMsg = msg;
+                // Check if this is a tool.search result by looking at the content
+                if (typeof toolMsg.content === 'string') {
+                    try {
+                        const result = JSON.parse(toolMsg.content);
+                        // Check if it looks like a tool.search result
+                        if (result.query && result.tools && Array.isArray(result.tools)) {
+                            const toolNames = result.tools
+                                .map((t) => typeof t === 'string' ? t : t.name)
+                                .filter(Boolean);
+                            if (toolNames.length > 0) {
+                                cache.recordDiscovery(result.query, toolNames);
+                            }
+                        }
+                    }
+                    catch {
+                        // Not JSON or not a tool.search result, ignore
+                    }
+                }
+            }
+        }
+        return cache;
+    }
+    /**
+     * Clear cache (call when starting a new conversation).
+     */
+    clear() {
+        this.discoveredTools.clear();
+        this.searchHistory = [];
+    }
+    /**
+     * Merge another cache into this one.
+     * Useful for combining caches from different sources.
+     */
+    merge(other) {
+        for (const tool of other.getDiscoveredTools()) {
+            this.discoveredTools.add(tool);
+        }
+        this.searchHistory.push(...other.getSearchHistory());
+    }
+}
+exports.ToolDiscoveryCache = ToolDiscoveryCache;
+//# sourceMappingURL=tool-cache.js.map

package/dist/tools/search/tool-cache.js.map

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

package/dist/tools/search/tool-search.d.ts

@@ -0,0 +1,21 @@
+/**
+ * Tool Search Meta-Tool
+ *
+ * A special built-in tool that enables AI models to dynamically discover
+ * tools on-demand, following Anthropic's Tool Search pattern.
+ *
+ * This tool is NEVER deferred - it's always loaded so the AI can search
+ * for other tools when needed.
+ */
+import { ToolDefinition, ToolSchema } from '../types.js';
+export declare const TOOL_SEARCH_NAME = "tool.search";
+export declare const toolSearchDefinition: ToolDefinition;
+/**
+ * Get the tool.search schema (without execute function).
+ */
+export declare function getToolSearchSchema(): ToolSchema;
+/**
+ * Check if a tool name is the tool.search meta-tool.
+ */
+export declare function isToolSearchTool(toolName: string): boolean;
+//# sourceMappingURL=tool-search.d.ts.map

package/dist/tools/search/tool-search.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tool-search.d.ts","sourceRoot":"","sources":["../../../src/tools/search/tool-search.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EAAE,cAAc,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAIzD,eAAO,MAAM,gBAAgB,gBAAgB,CAAC;AAE9C,eAAO,MAAM,oBAAoB,EAAE,cA8BlC,CAAC;AAEF;;GAEG;AACH,wBAAgB,mBAAmB,IAAI,UAAU,CAQhD;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAE1D"}

package/dist/tools/search/tool-search.js

@@ -0,0 +1,66 @@
+"use strict";
+/**
+ * Tool Search Meta-Tool
+ *
+ * A special built-in tool that enables AI models to dynamically discover
+ * tools on-demand, following Anthropic's Tool Search pattern.
+ *
+ * This tool is NEVER deferred - it's always loaded so the AI can search
+ * for other tools when needed.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.toolSearchDefinition = exports.TOOL_SEARCH_NAME = void 0;
+exports.getToolSearchSchema = getToolSearchSchema;
+exports.isToolSearchTool = isToolSearchTool;
+// ── Tool Search Definition ───────────────────────────────────────────────────
+exports.TOOL_SEARCH_NAME = 'tool.search';
+exports.toolSearchDefinition = {
+    name: exports.TOOL_SEARCH_NAME,
+    displayName: 'Search Tools',
+    category: 'meta',
+    description: `Search for available tools by keyword or natural language query.
+Use this to discover tools before using them.
+Examples: "file operations", "web scraping", "run command", "http request"
+
+Returns a list of matching tools with their names, descriptions, and parameters.
+After discovering tools, you can call them directly by name.`,
+    parameters: {
+        type: 'object',
+        properties: {
+            query: {
+                type: 'string',
+                description: 'Natural language search query (e.g., "read files", "web scraping", "execute shell commands")',
+            },
+            category: {
+                type: 'string',
+                description: 'Optional: filter by category',
+                enum: ['filesystem', 'network', 'execution', 'system', 'meta'],
+            },
+        },
+        required: ['query'],
+    },
+    execute: async () => {
+        // This is a placeholder - actual execution is handled by AIClient
+        // which has access to the BM25SearchEngine
+        throw new Error('tool.search execution must be handled by AIClient');
+    },
+};
+/**
+ * Get the tool.search schema (without execute function).
+ */
+function getToolSearchSchema() {
+    return {
+        name: exports.toolSearchDefinition.name,
+        displayName: exports.toolSearchDefinition.displayName,
+        description: exports.toolSearchDefinition.description,
+        parameters: exports.toolSearchDefinition.parameters,
+        category: exports.toolSearchDefinition.category,
+    };
+}
+/**
+ * Check if a tool name is the tool.search meta-tool.
+ */
+function isToolSearchTool(toolName) {
+    return toolName === exports.TOOL_SEARCH_NAME;
+}
+//# sourceMappingURL=tool-search.js.map

package/dist/tools/search/tool-search.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tool-search.js","sourceRoot":"","sources":["../../../src/tools/search/tool-search.ts"],"names":[],"mappings":";AAAA;;;;;;;;GAQG;;;AA2CH,kDAQC;AAKD,4CAEC;AAtDD,gFAAgF;AAEnE,QAAA,gBAAgB,GAAG,aAAa,CAAC;AAEjC,QAAA,oBAAoB,GAAmB;IAChD,IAAI,EAAE,wBAAgB;IACtB,WAAW,EAAE,cAAc;IAC3B,QAAQ,EAAE,MAAM;IAChB,WAAW,EAAE;;;;;6DAK4C;IACzD,UAAU,EAAE;QACR,IAAI,EAAE,QAAQ;QACd,UAAU,EAAE;YACR,KAAK,EAAE;gBACH,IAAI,EAAE,QAAQ;gBACd,WAAW,EAAE,8FAA8F;aAC9G;YACD,QAAQ,EAAE;gBACN,IAAI,EAAE,QAAQ;gBACd,WAAW,EAAE,8BAA8B;gBAC3C,IAAI,EAAE,CAAC,YAAY,EAAE,SAAS,EAAE,WAAW,EAAE,QAAQ,EAAE,MAAM,CAAC;aACjE;SACJ;QACD,QAAQ,EAAE,CAAC,OAAO,CAAC;KACtB;IACD,OAAO,EAAE,KAAK,IAAI,EAAE;QAChB,kEAAkE;QAClE,2CAA2C;QAC3C,MAAM,IAAI,KAAK,CAAC,mDAAmD,CAAC,CAAC;IACzE,CAAC;CACJ,CAAC;AAEF;;GAEG;AACH,SAAgB,mBAAmB;IAC/B,OAAO;QACH,IAAI,EAAE,4BAAoB,CAAC,IAAI;QAC/B,WAAW,EAAE,4BAAoB,CAAC,WAAW;QAC7C,WAAW,EAAE,4BAAoB,CAAC,WAAW;QAC7C,UAAU,EAAE,4BAAoB,CAAC,UAAU;QAC3C,QAAQ,EAAE,4BAAoB,CAAC,QAAQ;KAC1C,CAAC;AACN,CAAC;AAED;;GAEG;AACH,SAAgB,gBAAgB,CAAC,QAAgB;IAC7C,OAAO,QAAQ,KAAK,wBAAgB,CAAC;AACzC,CAAC"}

package/dist/tools/system-tools/index.d.ts

@@ -0,0 +1,8 @@
+import { ToolProject } from '../types.js';
+export { systemInfoTool } from './tools/info/index.js';
+export { systemEnvTool } from './tools/env/index.js';
+export { systemSetEnvTool } from './tools/set-env/index.js';
+export { systemCwdTool } from './tools/cwd/index.js';
+export { systemDiskUsageTool } from './tools/disk-usage/index.js';
+export declare const systemToolsProject: ToolProject;
+//# sourceMappingURL=index.d.ts.map

package/dist/tools/system-tools/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/tools/system-tools/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAO1C,OAAO,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AACvD,OAAO,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AACrD,OAAO,EAAE,gBAAgB,EAAE,MAAM,0BAA0B,CAAC;AAC5D,OAAO,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AACrD,OAAO,EAAE,mBAAmB,EAAE,MAAM,6BAA6B,CAAC;AAElE,eAAO,MAAM,kBAAkB,EAAE,WAmBhC,CAAC"}