@nitrostack/core 1.0.17 → 1.1.0-beta.1

package/dist/core/transforms/search/regex-match.worker.js

@@ -0,0 +1,19 @@
+import { parentPort, workerData } from 'node:worker_threads';
+/**
+ * Off-thread regular expression match. The host terminates this worker if the
+ * match does not finish, so a catastrophic pattern cannot block the server.
+ */
+const data = workerData;
+try {
+    const pattern = String(data?.pattern ?? '');
+    const fields = Array.isArray(data?.fields) ? data.fields : [];
+    const regex = new RegExp(pattern, 'i');
+    parentPort?.postMessage({
+        ok: true,
+        hits: fields.map((field) => regex.test(String(field))),
+    });
+}
+catch {
+    parentPort?.postMessage({ ok: false });
+}
+//# sourceMappingURL=regex-match.worker.js.map

package/dist/core/transforms/search/regex-match.worker.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"regex-match.worker.js","sourceRoot":"","sources":["../../../../src/core/transforms/search/regex-match.worker.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAC;AAE7D;;;GAGG;AACH,MAAM,IAAI,GAAG,UAAsD,CAAC;AAEpE,IAAI,CAAC;IACH,MAAM,OAAO,GAAG,MAAM,CAAC,IAAI,EAAE,OAAO,IAAI,EAAE,CAAC,CAAC;IAC5C,MAAM,MAAM,GAAG,KAAK,CAAC,OAAO,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC;IAC9D,MAAM,KAAK,GAAG,IAAI,MAAM,CAAC,OAAO,EAAE,GAAG,CAAC,CAAC;IACvC,UAAU,EAAE,WAAW,CAAC;QACtB,EAAE,EAAE,IAAI;QACR,IAAI,EAAE,MAAM,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC;KACvD,CAAC,CAAC;AACL,CAAC;AAAC,MAAM,CAAC;IACP,UAAU,EAAE,WAAW,CAAC,EAAE,EAAE,EAAE,KAAK,EAAE,CAAC,CAAC;AACzC,CAAC"}

package/dist/core/transforms/search/regex-search.transform.d.ts

@@ -0,0 +1,41 @@
+import { Worker } from 'node:worker_threads';
+import { Tool } from '../../tool.js';
+import { BaseSearchTransform } from './base-search.transform.js';
+import { SearchTransformOptions } from './types.js';
+/** After this quiet period a disabled transform may use the worker again. */
+export declare const REGEX_TIMEOUT_COOLDOWN_MS = 60000;
+type RegexWorkerFactory = (filename: string, options: {
+    workerData: {
+        pattern: string;
+        fields: string[];
+    };
+    resourceLimits: {
+        maxOldGenerationSizeMb: number;
+    };
+}) => Worker;
+/** Test hook: replace worker construction. Pass undefined to restore the real Worker. */
+export declare function setRegexWorkerFactoryForTests(factory?: RegexWorkerFactory): void;
+/** Test hook: highest concurrent regex workers since the last reset. */
+export declare function regexWorkerPeak(): number;
+/** Test hook. */
+export declare function resetRegexWorkerStats(): void;
+export declare class RegexSearchTransform extends BaseSearchTransform {
+    readonly name = "RegexSearchTransform";
+    private toolsList;
+    private toolMetadata;
+    private consecutiveRegexTimeouts;
+    private regexDisabledUntil;
+    constructor(options?: SearchTransformOptions);
+    protected updateIndex(tools: Tool[], _hash: string): void;
+    protected search(query: string, limit: number): Promise<Tool[]>;
+    private regexMatchingDisabled;
+    /**
+     * The query reaches us straight from the MCP client. Compiling it on the server
+     * thread hands the caller an event-loop stall via catastrophic backtracking.
+     * Literal substring matching is the default. Opt-in regex runs in a worker and
+     * falls back to a literal match when the pattern is invalid or does not finish.
+     */
+    private matchFields;
+}
+export {};
+//# sourceMappingURL=regex-search.transform.d.ts.map

package/dist/core/transforms/search/regex-search.transform.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"regex-search.transform.d.ts","sourceRoot":"","sources":["../../../../src/core/transforms/search/regex-search.transform.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,qBAAqB,CAAC;AAI7C,OAAO,EAAE,IAAI,EAAE,MAAM,eAAe,CAAC;AACrC,OAAO,EAAE,mBAAmB,EAAE,MAAM,4BAA4B,CAAC;AACjE,OAAO,EAAE,sBAAsB,EAAE,MAAM,YAAY,CAAC;AAUpD,6EAA6E;AAC7E,eAAO,MAAM,yBAAyB,QAAS,CAAC;AAKhD,KAAK,kBAAkB,GAAG,CACxB,QAAQ,EAAE,MAAM,EAChB,OAAO,EAAE;IAAE,UAAU,EAAE;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,EAAE,CAAA;KAAE,CAAC;IAAC,cAAc,EAAE;QAAE,sBAAsB,EAAE,MAAM,CAAA;KAAE,CAAA;CAAE,KAC/G,MAAM,CAAC;AAIZ,yFAAyF;AACzF,wBAAgB,6BAA6B,CAAC,OAAO,CAAC,EAAE,kBAAkB,GAAG,IAAI,CAEhF;AAED,wEAAwE;AACxE,wBAAgB,eAAe,IAAI,MAAM,CAExC;AAED,iBAAiB;AACjB,wBAAgB,qBAAqB,IAAI,IAAI,CAE5C;AA4GD,qBAAa,oBAAqB,SAAQ,mBAAmB;IAC3D,QAAQ,CAAC,IAAI,0BAA0B;IACvC,OAAO,CAAC,SAAS,CAAc;IAC/B,OAAO,CAAC,YAAY,CAA8C;IAClE,OAAO,CAAC,wBAAwB,CAAK;IACrC,OAAO,CAAC,kBAAkB,CAAK;gBAEnB,OAAO,GAAE,sBAA2B;IAIhD,SAAS,CAAC,WAAW,CAAC,KAAK,EAAE,IAAI,EAAE,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI;cA2CzC,MAAM,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,EAAE,CAAC;IAqCrE,OAAO,CAAC,qBAAqB;IAU7B;;;;;OAKG;YACW,WAAW;CAwB1B"}

package/dist/core/transforms/search/regex-search.transform.js

@@ -0,0 +1,237 @@
+import { Worker } from 'node:worker_threads';
+import { existsSync } from 'node:fs';
+import path from 'node:path';
+import { fileURLToPath } from 'node:url';
+import { BaseSearchTransform } from './base-search.transform.js';
+/** Upper bound on an opted-in regex query. */
+const MAX_REGEX_PATTERN_LENGTH = 200;
+/** A match that is still running after this is treated as catastrophic and abandoned. */
+const REGEX_MATCH_TIMEOUT_MS = 50;
+/** Concurrent off-thread matches. Further queries fall back to a literal search. */
+const MAX_REGEX_WORKERS = 4;
+/** Timeouts in a row after which opted-in regex stays literal until the cooldown. */
+const REGEX_TIMEOUTS_BEFORE_LITERAL = 3;
+/** After this quiet period a disabled transform may use the worker again. */
+export const REGEX_TIMEOUT_COOLDOWN_MS = 60_000;
+let regexWorkersInflight = 0;
+let regexWorkersPeak = 0;
+let regexWorkerFactory = (filename, options) => new Worker(filename, options);
+/** Test hook: replace worker construction. Pass undefined to restore the real Worker. */
+export function setRegexWorkerFactoryForTests(factory) {
+    regexWorkerFactory = factory ?? ((filename, options) => new Worker(filename, options));
+}
+/** Test hook: highest concurrent regex workers since the last reset. */
+export function regexWorkerPeak() {
+    return regexWorkersPeak;
+}
+/** Test hook. */
+export function resetRegexWorkerStats() {
+    regexWorkersPeak = 0;
+}
+function tryAcquireRegexWorker() {
+    if (regexWorkersInflight >= MAX_REGEX_WORKERS)
+        return false;
+    regexWorkersInflight += 1;
+    regexWorkersPeak = Math.max(regexWorkersPeak, regexWorkersInflight);
+    return true;
+}
+function releaseRegexWorker() {
+    regexWorkersInflight = Math.max(0, regexWorkersInflight - 1);
+}
+/**
+ * Runs `new RegExp(pattern, 'i')` against every field off the server event loop.
+ * Returns null when the pattern is invalid or the match does not finish in time,
+ * so the caller can fall back to a literal substring search.
+ */
+function regexWorkerScript() {
+    const here = path.dirname(fileURLToPath(import.meta.url));
+    const candidates = [
+        path.join(here, 'regex-match.worker.js'),
+        path.resolve(process.cwd(), 'dist/core/transforms/search/regex-match.worker.js'),
+    ];
+    return candidates.find((candidate) => existsSync(candidate));
+}
+function matchRegexOffThread(pattern, fields) {
+    const script = regexWorkerScript();
+    if (!script)
+        return Promise.resolve({ status: 'skip' });
+    if (!tryAcquireRegexWorker())
+        return Promise.resolve({ status: 'skip' });
+    return new Promise((resolve) => {
+        let worker;
+        try {
+            worker = regexWorkerFactory(script, {
+                workerData: { pattern, fields },
+                resourceLimits: { maxOldGenerationSizeMb: 32 },
+            });
+        }
+        catch {
+            releaseRegexWorker();
+            resolve({ status: 'skip' });
+            return;
+        }
+        let settled = false;
+        let released = false;
+        let exitWatch;
+        const release = () => {
+            if (released)
+                return;
+            released = true;
+            if (exitWatch)
+                clearTimeout(exitWatch);
+            releaseRegexWorker();
+        };
+        // The slot stays taken until the thread is gone. Releasing on the timer
+        // lets the next query spawn another worker while this one is still matching.
+        worker.once('exit', () => release());
+        const resolveCaller = (outcome) => {
+            if (settled)
+                return;
+            settled = true;
+            clearTimeout(timer);
+            resolve(outcome);
+        };
+        const stopWorker = () => {
+            void worker.terminate().catch(() => undefined);
+            if (released || exitWatch)
+                return;
+            exitWatch = setTimeout(() => {
+                console.warn('Regex worker did not exit after terminate; its slot stays occupied until exit');
+            }, 1000);
+        };
+        const timer = setTimeout(() => {
+            resolveCaller({ status: 'timeout' });
+            stopWorker();
+        }, REGEX_MATCH_TIMEOUT_MS);
+        worker.once('message', (msg) => {
+            resolveCaller(msg?.ok && Array.isArray(msg.hits)
+                ? { status: 'hit', hits: msg.hits }
+                : { status: 'skip' });
+            stopWorker();
+        });
+        worker.once('error', () => {
+            resolveCaller({ status: 'skip' });
+            stopWorker();
+        });
+    });
+}
+export class RegexSearchTransform extends BaseSearchTransform {
+    name = 'RegexSearchTransform';
+    toolsList = [];
+    toolMetadata = new Map();
+    consecutiveRegexTimeouts = 0;
+    regexDisabledUntil = 0;
+    constructor(options = {}) {
+        super(options);
+    }
+    updateIndex(tools, _hash) {
+        const toolMetadata = new Map();
+        for (const tool of tools) {
+            let paramKeywords = '';
+            const schema = tool.inputSchema;
+            if (schema) {
+                if (schema.properties && typeof schema.properties === 'object') {
+                    for (const [key, prop] of Object.entries(schema.properties)) {
+                        paramKeywords += ` ${key}`;
+                        if (prop && typeof prop === 'object' && prop.description) {
+                            paramKeywords += ` ${prop.description}`;
+                        }
+                    }
+                }
+                else {
+                    // Extract Zod schema shape properties if available
+                    const shape = typeof schema._def?.shape === 'function'
+                        ? schema._def.shape()
+                        : schema.shape || schema._def?.shape;
+                    if (shape && typeof shape === 'object') {
+                        for (const [key, prop] of Object.entries(shape)) {
+                            paramKeywords += ` ${key}`;
+                            if (prop && typeof prop === 'object' && prop.description) {
+                                paramKeywords += ` ${prop.description}`;
+                            }
+                        }
+                    }
+                }
+            }
+            toolMetadata.set(tool.name, {
+                name: tool.name,
+                title: tool.title || '',
+                description: tool.description || '',
+                paramKeywords,
+            });
+        }
+        this.toolsList = tools;
+        this.toolMetadata = toolMetadata;
+    }
+    async search(query, limit) {
+        if (!query || query.trim().length === 0) {
+            return [];
+        }
+        const rows = [];
+        const fields = [];
+        for (const tool of this.toolsList) {
+            const meta = this.toolMetadata.get(tool.name);
+            if (!meta)
+                continue;
+            rows.push(meta);
+            fields.push(meta.name, meta.title, meta.description, meta.paramKeywords);
+        }
+        const hits = await this.matchFields(query, fields);
+        const matches = [];
+        for (let i = 0; i < rows.length; i++) {
+            const meta = rows[i];
+            const base = i * 4;
+            const hit = hits[base] ||
+                (meta.title ? hits[base + 1] : false) ||
+                hits[base + 2] ||
+                hits[base + 3];
+            if (hit) {
+                const tool = this.toolsList.find((candidate) => candidate.name === meta.name);
+                if (!tool)
+                    continue;
+                matches.push(tool);
+                if (matches.length >= limit)
+                    break;
+            }
+        }
+        return matches;
+    }
+    regexMatchingDisabled() {
+        if (this.consecutiveRegexTimeouts < REGEX_TIMEOUTS_BEFORE_LITERAL)
+            return false;
+        if (Date.now() >= this.regexDisabledUntil) {
+            this.consecutiveRegexTimeouts = 0;
+            this.regexDisabledUntil = 0;
+            return false;
+        }
+        return true;
+    }
+    /**
+     * The query reaches us straight from the MCP client. Compiling it on the server
+     * thread hands the caller an event-loop stall via catastrophic backtracking.
+     * Literal substring matching is the default. Opt-in regex runs in a worker and
+     * falls back to a literal match when the pattern is invalid or does not finish.
+     */
+    async matchFields(query, fields) {
+        if (this.options.allowRegex &&
+            !this.regexMatchingDisabled() &&
+            query.length > 0 &&
+            query.length <= MAX_REGEX_PATTERN_LENGTH) {
+            const timed = await matchRegexOffThread(query, fields);
+            if (timed.status === 'hit' && timed.hits.length === fields.length) {
+                this.consecutiveRegexTimeouts = 0;
+                this.regexDisabledUntil = 0;
+                return timed.hits;
+            }
+            if (timed.status === 'timeout') {
+                this.consecutiveRegexTimeouts += 1;
+                if (this.consecutiveRegexTimeouts >= REGEX_TIMEOUTS_BEFORE_LITERAL) {
+                    this.regexDisabledUntil = Date.now() + REGEX_TIMEOUT_COOLDOWN_MS;
+                }
+            }
+        }
+        const needle = query.toLowerCase();
+        return fields.map((field) => field.toLowerCase().includes(needle));
+    }
+}
+//# sourceMappingURL=regex-search.transform.js.map

package/dist/core/transforms/search/regex-search.transform.js.map

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

package/dist/core/transforms/search/synthetic-tools.d.ts

@@ -0,0 +1,11 @@
+import { Tool } from '../../tool.js';
+import { ExecutionContext } from '../../types.js';
+import { DetailLevel } from './tool-serializer.js';
+import { validateToolArguments } from '../validate-tool-arguments.js';
+/** One search call cannot dump the whole catalog. */
+export declare const MAX_SEARCH_RESULTS = 20;
+export declare function clampSearchLimit(requested: unknown, fallback: number): number;
+export { validateToolArguments };
+export declare function buildSearchTool(name: string, searchFn: (query: string, limit: number, context?: ExecutionContext) => Promise<Tool[]>, defaultLimit?: number, defaultDetail?: DetailLevel): Tool;
+export declare function buildCallTool(name: string, resolveFn: (name: string, context?: ExecutionContext) => Promise<Tool | undefined>, searchToolName?: string): Tool;
+//# sourceMappingURL=synthetic-tools.d.ts.map

package/dist/core/transforms/search/synthetic-tools.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"synthetic-tools.d.ts","sourceRoot":"","sources":["../../../../src/core/transforms/search/synthetic-tools.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,MAAM,eAAe,CAAC;AACrC,OAAO,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AAElD,OAAO,EAAE,WAAW,EAAkB,MAAM,sBAAsB,CAAC;AACnE,OAAO,EAAE,qBAAqB,EAAE,MAAM,+BAA+B,CAAC;AAEtE,qDAAqD;AACrD,eAAO,MAAM,kBAAkB,KAAK,CAAC;AAErC,wBAAgB,gBAAgB,CAAC,SAAS,EAAE,OAAO,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM,CAK7E;AAED,OAAO,EAAE,qBAAqB,EAAE,CAAC;AAEjC,wBAAgB,eAAe,CAC7B,IAAI,EAAE,MAAM,EACZ,QAAQ,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,gBAAgB,KAAK,OAAO,CAAC,IAAI,EAAE,CAAC,EACvF,YAAY,GAAE,MAAU,EACxB,aAAa,GAAE,WAAwB,GACtC,IAAI,CAiCN;AAED,wBAAgB,aAAa,CAC3B,IAAI,EAAE,MAAM,EACZ,SAAS,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,gBAAgB,KAAK,OAAO,CAAC,IAAI,GAAG,SAAS,CAAC,EAClF,cAAc,GAAE,MAAuB,GACtC,IAAI,CAyCN"}

package/dist/core/transforms/search/synthetic-tools.js

@@ -0,0 +1,76 @@
+import { Tool } from '../../tool.js';
+import { CatalogTransform } from '../catalog.transform.js';
+import { serializeTools } from './tool-serializer.js';
+import { validateToolArguments } from '../validate-tool-arguments.js';
+/** One search call cannot dump the whole catalog. */
+export const MAX_SEARCH_RESULTS = 20;
+export function clampSearchLimit(requested, fallback) {
+    if (typeof requested !== 'number' || !Number.isFinite(requested) || requested <= 0) {
+        return fallback;
+    }
+    return Math.min(Math.floor(requested), MAX_SEARCH_RESULTS);
+}
+export { validateToolArguments };
+export function buildSearchTool(name, searchFn, defaultLimit = 5, defaultDetail = 'detailed') {
+    return new Tool({
+        name,
+        description: 'Searches available tools by natural language query or keywords. Returns matching tool names, descriptions, and parameter schemas.',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                query: { type: 'string', description: 'Natural language search query or keywords' },
+                limit: {
+                    type: 'number',
+                    description: `Maximum number of tools to return (default: ${defaultLimit})`,
+                },
+                detail: {
+                    type: 'string',
+                    enum: ['brief', 'detailed', 'full'],
+                    description: 'Level of detail: brief (name & 1-line summary), detailed (name, summary, and parameters list), full (complete JSON Schema)',
+                },
+            },
+            required: ['query'],
+        },
+        handler: async (args, ctx) => {
+            const limit = clampSearchLimit(args.limit, defaultLimit);
+            const detail = args.detail ?? defaultDetail;
+            const results = await searchFn(args.query, limit, ctx);
+            const text = await serializeTools(results, detail);
+            return { content: [{ type: 'text', text }] };
+        },
+    });
+}
+export function buildCallTool(name, resolveFn, searchToolName = 'search_tools') {
+    return new Tool({
+        name,
+        description: 'Executes a discovered tool by name with the specified arguments object.',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                name: { type: 'string', description: 'Name of the tool to execute' },
+                arguments: {
+                    type: 'object',
+                    description: 'Arguments object matching the target tool parameters',
+                },
+            },
+            required: ['name'],
+        },
+        handler: async (args, ctx) => {
+            if (args.name === name || args.name === searchToolName) {
+                throw new Error(`'${args.name}' cannot be invoked through ${name}`);
+            }
+            const targetTool = await resolveFn(args.name, ctx);
+            if (!targetTool) {
+                throw new Error(`Tool '${args.name}' not found. Use ${searchToolName} to discover available tools.`);
+            }
+            const toolArgs = args.arguments ?? {};
+            // 1. Validate arguments against target tool's schema before execution.
+            //    Zod defaults and coercions are applied; JSON Schema checks throw only.
+            const parsedArgs = validateToolArguments(targetTool, toolArgs);
+            // 2. Execute target tool through full NitroStack pipeline (guards, middleware, interceptors, pipes, handler).
+            //    withBypass covers catalog listing inside the handler. Authorization already ran in resolveFn.
+            return await CatalogTransform.withBypass(() => targetTool.execute(parsedArgs, ctx));
+        },
+    });
+}
+//# sourceMappingURL=synthetic-tools.js.map

package/dist/core/transforms/search/synthetic-tools.js.map

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

package/dist/core/transforms/search/tokenizer.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Standard English stop words set for information retrieval.
+ * Preserves common API identifiers like 'id', 'get', 'set', etc.
+ */
+export declare const STOP_WORDS: Set<string>;
+/**
+ * Splits text into normalized alphanumeric tokens, handling camelCase,
+ * snake_case, kebab-case, punctuation, and stop-word filtration.
+ */
+export declare function tokenize(text: string): string[];
+//# sourceMappingURL=tokenizer.d.ts.map

package/dist/core/transforms/search/tokenizer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tokenizer.d.ts","sourceRoot":"","sources":["../../../../src/core/transforms/search/tokenizer.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,eAAO,MAAM,UAAU,aAcrB,CAAC;AAEH;;;GAGG;AACH,wBAAgB,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,EAAE,CAe/C"}

package/dist/core/transforms/search/tokenizer.js

@@ -0,0 +1,38 @@
+/**
+ * Standard English stop words set for information retrieval.
+ * Preserves common API identifiers like 'id', 'get', 'set', etc.
+ */
+export const STOP_WORDS = new Set([
+    'a', 'about', 'above', 'after', 'again', 'against', 'all', 'am', 'an', 'and', 'any',
+    'are', 'aren', 'as', 'at', 'be', 'because', 'been', 'before', 'being', 'below',
+    'between', 'both', 'but', 'by', 'can', 'cannot', 'could', 'did', 'do', 'does',
+    'doing', 'down', 'during', 'each', 'few', 'for', 'from', 'further', 'had', 'has',
+    'have', 'having', 'he', 'her', 'here', 'hers', 'herself', 'him', 'himself', 'his',
+    'how', 'if', 'in', 'into', 'is', 'isn', 'it', 'its', 'itself', 'me', 'more',
+    'most', 'my', 'myself', 'no', 'nor', 'not', 'of', 'off', 'on', 'once', 'only',
+    'or', 'other', 'our', 'ours', 'ourselves', 'out', 'over', 'own', 'same', 'she',
+    'should', 'so', 'some', 'such', 'than', 'that', 'the', 'their', 'theirs', 'them',
+    'themselves', 'then', 'there', 'these', 'they', 'this', 'those', 'through', 'to',
+    'too', 'under', 'until', 'up', 'very', 'was', 'we', 'were', 'what', 'when',
+    'where', 'which', 'while', 'who', 'whom', 'why', 'with', 'won', 'you', 'your',
+    'yours', 'yourself', 'yourselves',
+]);
+/**
+ * Splits text into normalized alphanumeric tokens, handling camelCase,
+ * snake_case, kebab-case, punctuation, and stop-word filtration.
+ */
+export function tokenize(text) {
+    if (!text)
+        return [];
+    // 1. Separate camelCase and snake/kebab/punctuation transitions
+    const normalized = text
+        .replace(/([a-z])([A-Z])/g, '$1 $2')
+        .replace(/([A-Z]+)([A-Z][a-z])/g, '$1 $2')
+        .replace(/[_\-.:/\\,;?!=+*~`'"`()\[\]{}|<>#@$%^&]+/g, ' ')
+        .toLowerCase();
+    // 2. Extract words >= 2 chars, including non-Latin letters.
+    const tokens = normalized.match(/[\p{L}\p{N}]+/gu) || [];
+    // 3. Filter common English stop words
+    return tokens.filter((t) => t.length >= 2 && !STOP_WORDS.has(t));
+}
+//# sourceMappingURL=tokenizer.js.map

package/dist/core/transforms/search/tokenizer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tokenizer.js","sourceRoot":"","sources":["../../../../src/core/transforms/search/tokenizer.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,MAAM,CAAC,MAAM,UAAU,GAAG,IAAI,GAAG,CAAS;IACxC,GAAG,EAAE,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,SAAS,EAAE,KAAK,EAAE,IAAI,EAAE,IAAI,EAAE,KAAK,EAAE,KAAK;IACnF,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,SAAS,EAAE,MAAM,EAAE,QAAQ,EAAE,OAAO,EAAE,OAAO;IAC9E,SAAS,EAAE,MAAM,EAAE,KAAK,EAAE,IAAI,EAAE,KAAK,EAAE,QAAQ,EAAE,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,MAAM;IAC7E,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,KAAK,EAAE,KAAK,EAAE,MAAM,EAAE,SAAS,EAAE,KAAK,EAAE,KAAK;IAChF,MAAM,EAAE,QAAQ,EAAE,IAAI,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,SAAS,EAAE,KAAK,EAAE,SAAS,EAAE,KAAK;IACjF,KAAK,EAAE,IAAI,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,KAAK,EAAE,QAAQ,EAAE,IAAI,EAAE,MAAM;IAC3E,MAAM,EAAE,IAAI,EAAE,QAAQ,EAAE,IAAI,EAAE,KAAK,EAAE,KAAK,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM;IAC7E,IAAI,EAAE,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,WAAW,EAAE,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,KAAK;IAC9E,QAAQ,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,EAAE,QAAQ,EAAE,MAAM;IAChF,YAAY,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,SAAS,EAAE,IAAI;IAChF,KAAK,EAAE,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM;IAC1E,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,KAAK,EAAE,MAAM;IAC7E,OAAO,EAAE,UAAU,EAAE,YAAY;CAClC,CAAC,CAAC;AAEH;;;GAGG;AACH,MAAM,UAAU,QAAQ,CAAC,IAAY;IACnC,IAAI,CAAC,IAAI;QAAE,OAAO,EAAE,CAAC;IAErB,gEAAgE;IAChE,MAAM,UAAU,GAAG,IAAI;SACpB,OAAO,CAAC,iBAAiB,EAAE,OAAO,CAAC;SACnC,OAAO,CAAC,uBAAuB,EAAE,OAAO,CAAC;SACzC,OAAO,CAAC,2CAA2C,EAAE,GAAG,CAAC;SACzD,WAAW,EAAE,CAAC;IAEjB,4DAA4D;IAC5D,MAAM,MAAM,GAAG,UAAU,CAAC,KAAK,CAAC,iBAAiB,CAAC,IAAI,EAAE,CAAC;IAEzD,sCAAsC;IACtC,OAAO,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,IAAI,CAAC,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC;AACnE,CAAC"}

package/dist/core/transforms/search/tool-serializer.d.ts

@@ -0,0 +1,6 @@
+import { Tool } from '../../tool.js';
+import { SearchDetailLevel } from './types.js';
+export type DetailLevel = SearchDetailLevel;
+export declare function serializeTool(tool: Tool, detail?: DetailLevel): Promise<string>;
+export declare function serializeTools(tools: Tool[], detail?: DetailLevel): Promise<string>;
+//# sourceMappingURL=tool-serializer.d.ts.map

package/dist/core/transforms/search/tool-serializer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tool-serializer.d.ts","sourceRoot":"","sources":["../../../../src/core/transforms/search/tool-serializer.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,MAAM,eAAe,CAAC;AACrC,OAAO,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAC;AAE/C,MAAM,MAAM,WAAW,GAAG,iBAAiB,CAAC;AAE5C,wBAAsB,aAAa,CAAC,IAAI,EAAE,IAAI,EAAE,MAAM,GAAE,WAAwB,GAAG,OAAO,CAAC,MAAM,CAAC,CAqCjG;AAED,wBAAsB,cAAc,CAClC,KAAK,EAAE,IAAI,EAAE,EACb,MAAM,GAAE,WAAwB,GAC/B,OAAO,CAAC,MAAM,CAAC,CAIjB"}

package/dist/core/transforms/search/tool-serializer.js

@@ -0,0 +1,41 @@
+export async function serializeTool(tool, detail = 'detailed') {
+    const mcpTool = await tool.toMcpTool();
+    const schema = mcpTool.inputSchema || {};
+    const properties = schema?.properties || {};
+    const requiredSet = new Set(Array.isArray(schema?.required) ? schema.required : []);
+    switch (detail) {
+        case 'brief':
+            return `- **${tool.name}**: ${tool.description || 'No description'}`;
+        case 'detailed': {
+            const lines = [
+                `### ${tool.name}`,
+                tool.description || 'No description',
+                '**Parameters**:',
+            ];
+            const propKeys = Object.keys(properties);
+            if (propKeys.length === 0) {
+                lines.push('  *(none)*');
+            }
+            else {
+                for (const key of propKeys) {
+                    const prop = properties[key] || {};
+                    const isReq = requiredSet.has(key) ? 'required' : 'optional';
+                    const type = prop.type || 'any';
+                    const desc = prop.description ? `: ${prop.description}` : '';
+                    const defaultVal = prop.default !== undefined ? ` (default: ${JSON.stringify(prop.default)})` : '';
+                    lines.push(`  - \`${key}\` (${type}, ${isReq})${defaultVal}${desc}`);
+                }
+            }
+            return lines.join('\n');
+        }
+        case 'full':
+            return `### ${tool.name}\n${tool.description || ''}\n\`\`\`json\n${JSON.stringify(schema, null, 2)}\n\`\`\``;
+    }
+}
+export async function serializeTools(tools, detail = 'detailed') {
+    if (tools.length === 0)
+        return 'No matching tools found.';
+    const serialized = await Promise.all(tools.map((t) => serializeTool(t, detail)));
+    return serialized.join('\n\n');
+}
+//# sourceMappingURL=tool-serializer.js.map

package/dist/core/transforms/search/tool-serializer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tool-serializer.js","sourceRoot":"","sources":["../../../../src/core/transforms/search/tool-serializer.ts"],"names":[],"mappings":"AAKA,MAAM,CAAC,KAAK,UAAU,aAAa,CAAC,IAAU,EAAE,SAAsB,UAAU;IAC9E,MAAM,OAAO,GAAG,MAAM,IAAI,CAAC,SAAS,EAAE,CAAC;IACvC,MAAM,MAAM,GAAI,OAAO,CAAC,WAAmC,IAAI,EAAE,CAAC;IAClE,MAAM,UAAU,GAAG,MAAM,EAAE,UAAU,IAAI,EAAE,CAAC;IAC5C,MAAM,WAAW,GAAG,IAAI,GAAG,CAAC,KAAK,CAAC,OAAO,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;IAEpF,QAAQ,MAAM,EAAE,CAAC;QACf,KAAK,OAAO;YACV,OAAO,OAAO,IAAI,CAAC,IAAI,OAAO,IAAI,CAAC,WAAW,IAAI,gBAAgB,EAAE,CAAC;QAEvE,KAAK,UAAU,CAAC,CAAC,CAAC;YAChB,MAAM,KAAK,GAAa;gBACtB,OAAO,IAAI,CAAC,IAAI,EAAE;gBAClB,IAAI,CAAC,WAAW,IAAI,gBAAgB;gBACpC,iBAAiB;aAClB,CAAC;YAEF,MAAM,QAAQ,GAAG,MAAM,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;YACzC,IAAI,QAAQ,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;gBAC1B,KAAK,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC;YAC3B,CAAC;iBAAM,CAAC;gBACN,KAAK,MAAM,GAAG,IAAI,QAAQ,EAAE,CAAC;oBAC3B,MAAM,IAAI,GAAG,UAAU,CAAC,GAAG,CAAC,IAAI,EAAE,CAAC;oBACnC,MAAM,KAAK,GAAG,WAAW,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,UAAU,CAAC;oBAC7D,MAAM,IAAI,GAAG,IAAI,CAAC,IAAI,IAAI,KAAK,CAAC;oBAChC,MAAM,IAAI,GAAG,IAAI,CAAC,WAAW,CAAC,CAAC,CAAC,KAAK,IAAI,CAAC,WAAW,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;oBAC7D,MAAM,UAAU,GACd,IAAI,CAAC,OAAO,KAAK,SAAS,CAAC,CAAC,CAAC,cAAc,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC;oBAClF,KAAK,CAAC,IAAI,CAAC,SAAS,GAAG,OAAO,IAAI,KAAK,KAAK,IAAI,UAAU,GAAG,IAAI,EAAE,CAAC,CAAC;gBACvE,CAAC;YACH,CAAC;YACD,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAC1B,CAAC;QAED,KAAK,MAAM;YACT,OAAO,OAAO,IAAI,CAAC,IAAI,KAAK,IAAI,CAAC,WAAW,IAAI,EAAE,iBAAiB,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,UAAU,CAAC;IACjH,CAAC;AACH,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,cAAc,CAClC,KAAa,EACb,SAAsB,UAAU;IAEhC,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,0BAA0B,CAAC;IAC1D,MAAM,UAAU,GAAG,MAAM,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,aAAa,CAAC,CAAC,EAAE,MAAM,CAAC,CAAC,CAAC,CAAC;IACjF,OAAO,UAAU,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;AACjC,CAAC"}

package/dist/core/transforms/search/types.d.ts

@@ -0,0 +1,36 @@
+export type SearchDetailLevel = 'brief' | 'detailed' | 'full';
+export interface SearchTransformOptions {
+    searchToolName?: string;
+    callToolName?: string;
+    defaultLimit?: number;
+    defaultDetail?: SearchDetailLevel;
+    alwaysVisible?: string[];
+    /**
+     * Interpret the search query as a regular expression instead of a literal substring
+     * (RegexSearchTransform only; default: false).
+     *
+     * The match runs in a worker and is abandoned if it does not finish quickly, so a
+     * catastrophic pattern cannot block the server event loop. On timeout or invalid
+     * syntax the query is treated as a literal substring.
+     */
+    allowRegex?: boolean;
+}
+export interface BM25Document<T> {
+    id: string;
+    item: T;
+    length: number;
+    termFrequencies: Map<string, number>;
+}
+export interface BM25SearchResult<T> {
+    item: T;
+    score: number;
+}
+export interface IndexDocumentInput<T> {
+    id: string;
+    name: string;
+    title?: string;
+    description?: string;
+    parametersText?: string;
+    item: T;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/core/transforms/search/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../../src/core/transforms/search/types.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,iBAAiB,GAAG,OAAO,GAAG,UAAU,GAAG,MAAM,CAAC;AAE9D,MAAM,WAAW,sBAAsB;IACrC,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,aAAa,CAAC,EAAE,iBAAiB,CAAC;IAClC,aAAa,CAAC,EAAE,MAAM,EAAE,CAAC;IACzB;;;;;;;OAOG;IACH,UAAU,CAAC,EAAE,OAAO,CAAC;CACtB;AAED,MAAM,WAAW,YAAY,CAAC,CAAC;IAC7B,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,CAAC,CAAC;IACR,MAAM,EAAE,MAAM,CAAC;IACf,eAAe,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CACtC;AAED,MAAM,WAAW,gBAAgB,CAAC,CAAC;IACjC,IAAI,EAAE,CAAC,CAAC;IACR,KAAK,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,kBAAkB,CAAC,CAAC;IACnC,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,IAAI,EAAE,CAAC,CAAC;CACT"}

package/dist/core/transforms/search/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/core/transforms/search/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../../src/core/transforms/search/types.ts"],"names":[],"mappings":""}

package/dist/core/transforms/tool-cache-key.d.ts

@@ -0,0 +1,15 @@
+import { Tool } from '../tool.js';
+/**
+ * Schema and visibility material for catalog cache keys.
+ * Name and description alone reuse a stale index when a parameter list changes.
+ */
+export declare function toolCacheFields(tool: Tool): {
+    schema: string;
+    visibility: string;
+};
+/**
+ * Length-prefixed catalog fingerprint. Without a delimiter, ('ab','c') and ('a','bc')
+ * hash to the same key and a transform can serve a stale tool list.
+ */
+export declare function catalogCacheKey(tools: Tool[], visibleNames: string[]): string;
+//# sourceMappingURL=tool-cache-key.d.ts.map

package/dist/core/transforms/tool-cache-key.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tool-cache-key.d.ts","sourceRoot":"","sources":["../../../src/core/transforms/tool-cache-key.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,IAAI,EAAE,MAAM,YAAY,CAAC;AAElC;;;GAGG;AACH,wBAAgB,eAAe,CAAC,IAAI,EAAE,IAAI,GAAG;IAAE,MAAM,EAAE,MAAM,CAAC;IAAC,UAAU,EAAE,MAAM,CAAA;CAAE,CAKlF;AA0CD;;;GAGG;AACH,wBAAgB,eAAe,CAAC,KAAK,EAAE,IAAI,EAAE,EAAE,YAAY,EAAE,MAAM,EAAE,GAAG,MAAM,CAa7E"}