contextpro-mcp 0.0.0-stage → 1.4.0

package/build/core/tree-sitter-runtime.js

@@ -0,0 +1,324 @@
+// Web-tree-sitter based multi-language parser using WASM grammars
+// Supports 36 languages via tree-sitter-wasms, extracts symbols from AST
+import { readFile } from "fs/promises";
+import { join, dirname } from "path";
+import { fileURLToPath } from "url";
+const GRAMMAR_DIR = join(dirname(fileURLToPath(import.meta.url)), "../../node_modules/tree-sitter-wasms/out");
+const EXT_TO_GRAMMAR = {
+    ".ts": "typescript", ".tsx": "tsx", ".js": "javascript", ".jsx": "javascript",
+    ".mjs": "javascript", ".cjs": "javascript", ".py": "python", ".rs": "rust",
+    ".go": "go", ".java": "java", ".c": "c", ".h": "c", ".cpp": "cpp",
+    ".hpp": "cpp", ".cc": "cpp", ".cs": "c_sharp", ".rb": "ruby", ".php": "php",
+    ".swift": "swift", ".kt": "kotlin", ".kts": "kotlin", ".lua": "lua",
+    ".dart": "dart", ".ex": "elixir", ".exs": "elixir", ".elm": "elm",
+    ".ml": "ocaml", ".scala": "scala", ".sc": "scala", ".sol": "solidity",
+    ".zig": "zig", ".vue": "vue", ".sh": "bash", ".bash": "bash", ".zsh": "bash",
+    ".toml": "toml", ".yaml": "yaml", ".yml": "yaml", ".json": "json",
+    ".html": "html", ".css": "css", ".m": "objc", ".re": "rescript",
+};
+const DEFINITION_TYPES = {
+    typescript: {
+        function_declaration: "function", method_definition: "method",
+        class_declaration: "class", interface_declaration: "interface",
+        enum_declaration: "enum", type_alias_declaration: "type",
+        lexical_declaration: "const",
+    },
+    javascript: {
+        function_declaration: "function", method_definition: "method",
+        class_declaration: "class", variable_declaration: "const",
+        lexical_declaration: "const",
+    },
+    tsx: {
+        function_declaration: "function", method_definition: "method",
+        class_declaration: "class", interface_declaration: "interface",
+        enum_declaration: "enum", type_alias_declaration: "type",
+        lexical_declaration: "const",
+    },
+    python: {
+        function_definition: "function", class_definition: "class",
+    },
+    rust: {
+        function_item: "function", struct_item: "struct",
+        enum_item: "enum", trait_item: "trait", impl_item: "class",
+    },
+    go: {
+        function_declaration: "function", method_declaration: "method",
+        type_spec: "type",
+    },
+    java: {
+        method_declaration: "method", class_declaration: "class",
+        interface_declaration: "interface", enum_declaration: "enum",
+    },
+    c: {
+        function_definition: "function", struct_specifier: "struct",
+        enum_specifier: "enum",
+    },
+    cpp: {
+        function_definition: "function", class_specifier: "class",
+        struct_specifier: "struct", enum_specifier: "enum",
+    },
+    c_sharp: {
+        method_declaration: "method", class_declaration: "class",
+        interface_declaration: "interface", enum_declaration: "enum",
+        struct_declaration: "struct",
+    },
+    ruby: {},
+    lua: {},
+    dart: {},
+    elixir: {},
+    php: {
+        function_definition: "function", method_declaration: "method",
+        class_declaration: "class", interface_declaration: "interface",
+        enum_declaration: "enum",
+    },
+    swift: {
+        function_declaration: "function", class_declaration: "class",
+        struct_declaration: "struct", enum_declaration: "enum",
+        protocol_declaration: "interface",
+    },
+    kotlin: {
+        function_declaration: "function", class_declaration: "class",
+        object_declaration: "class", interface_delegation: "interface",
+    },
+    scala: {
+        function_definition: "function", class_definition: "class",
+        trait_definition: "trait", object_definition: "class",
+    },
+    solidity: {
+        function_definition: "function", contract_declaration: "class",
+        struct_declaration: "struct", enum_declaration: "enum",
+        event_definition: "export",
+    },
+    zig: {
+        function_declaration: "function",
+    },
+    bash: {
+        function_definition: "function",
+    },
+    ocaml: {
+        let_binding: "function", type_binding: "type",
+    },
+};
+let ParserClass = null;
+const grammarCache = new Map();
+let parserInitialization = null;
+const grammarLoads = new Map();
+async function initParser() {
+    if (ParserClass)
+        return ParserClass;
+    if (!parserInitialization) {
+        parserInitialization = (async () => {
+            const mod = await import("web-tree-sitter");
+            const Parser = mod.default ?? mod;
+            await Parser.init();
+            ParserClass = Parser;
+            return Parser;
+        })().catch((error) => { parserInitialization = null; throw error; });
+    }
+    return parserInitialization;
+}
+async function loadGrammar(grammarName) {
+    if (grammarCache.has(grammarName))
+        return grammarCache.get(grammarName);
+    if (grammarLoads.has(grammarName))
+        return grammarLoads.get(grammarName);
+    const loading = (async () => {
+        try {
+            const Parser = await initParser();
+            const wasmPath = join(GRAMMAR_DIR, `tree-sitter-${grammarName}.wasm`);
+            await readFile(wasmPath);
+            const lang = await Parser.Language.load(wasmPath);
+            grammarCache.set(grammarName, lang);
+            return lang;
+        }
+        catch {
+            return null;
+        }
+        finally {
+            grammarLoads.delete(grammarName);
+        }
+    })();
+    grammarLoads.set(grammarName, loading);
+    return loading;
+}
+function extractName(node, _kind) {
+    const nameNode = node.childForFieldName("name")
+        ?? node.childForFieldName("declarator")
+        ?? node.namedChildren?.find((c) => c.type === "identifier" || c.type === "type_identifier"
+            || c.type === "property_identifier" || c.type === "simple_identifier");
+    if (nameNode) {
+        if (nameNode.type === "function_declarator" || nameNode.type === "pointer_declarator") {
+            const inner = nameNode.childForFieldName("declarator") ?? nameNode.namedChildren?.[0];
+            if (inner)
+                return inner.text;
+        }
+        return nameNode.text;
+    }
+    for (const child of node.namedChildren ?? []) {
+        if (child.type === "variable_declarator" || child.type === "const_declaration") {
+            const inner = child.childForFieldName("name");
+            if (inner)
+                return inner.text;
+        }
+    }
+    return node.text.split(/[\s({]/)[0]?.trim() ?? "anonymous";
+}
+function extractSignature(node) {
+    const lines = node.text.split("\n");
+    const firstLine = lines[0].trim();
+    return firstLine.length > 150 ? firstLine.substring(0, 150) + "..." : firstLine;
+}
+function mapKind(typeStr) {
+    const kinds = {
+        function: "function", method: "method", class: "class",
+        struct: "struct", enum: "enum", interface: "interface",
+        type: "type", trait: "trait", const: "const", variable: "variable",
+        export: "export",
+    };
+    return (kinds[typeStr] ?? "function");
+}
+function walkTree(rootNode, defTypes, maxDepth = 3) {
+    const symbols = [];
+    function visit(node, depth, parent) {
+        if (depth > maxDepth)
+            return;
+        const kindStr = defTypes[node.type];
+        if (kindStr) {
+            const span = node.parent?.type === "export_statement" ? node.parent : node;
+            const sym = {
+                startIndex: span.startIndex,
+                endIndex: span.endIndex,
+                ...(["lexical_declaration", "variable_declaration"].includes(node.type)
+                    && node.namedChildren.filter((child) => child.type === "variable_declarator").length > 1
+                    ? { sharedDeclaration: true } : {}),
+                name: extractName(node, kindStr),
+                kind: mapKind(kindStr),
+                line: span.startPosition.row + 1,
+                endLine: span.endPosition.row + 1,
+                signature: extractSignature(node),
+                children: [],
+            };
+            if (parent && depth > 0) {
+                parent.children.push(sym);
+            }
+            else {
+                symbols.push(sym);
+            }
+            for (const child of node.namedChildren ?? []) {
+                visit(child, depth + 1, sym);
+            }
+            return;
+        }
+        for (const child of node.namedChildren ?? []) {
+            visit(child, depth, parent);
+        }
+    }
+    visit(rootNode, 0, null);
+    return symbols;
+}
+export function getGrammarName(ext) {
+    return EXT_TO_GRAMMAR[ext.toLowerCase()] ?? null;
+}
+export async function parseWithTreeSitter(content, ext) {
+    const grammarName = getGrammarName(ext);
+    if (!grammarName)
+        return null;
+    const defTypes = DEFINITION_TYPES[grammarName];
+    if (!defTypes)
+        return null;
+    const lang = await loadGrammar(grammarName);
+    if (!lang)
+        return null;
+    let parser = null;
+    let tree = null;
+    try {
+        const Parser = await initParser();
+        parser = new Parser();
+        parser.setLanguage(lang);
+        tree = parser.parse(content);
+        return walkTree(tree.rootNode, defTypes);
+    }
+    catch {
+        return null;
+    }
+    finally {
+        tree?.delete?.();
+        parser?.delete?.();
+    }
+}
+export function getSupportedExtensions() {
+    return Object.keys(EXT_TO_GRAMMAR);
+}
+function nodeIsMissing(node) {
+    // `isMissing` is a method in web-tree-sitter, a property in some node bindings.
+    const v = node.isMissing;
+    if (typeof v === "function")
+        return Boolean(node.isMissing());
+    return Boolean(v);
+}
+function nodeHasError(node) {
+    const v = node.hasError;
+    if (typeof v === "function")
+        return Boolean(node.hasError());
+    return Boolean(v);
+}
+function findFirstSyntaxError(node) {
+    // Depth-first search for the first ERROR or MISSING node. Tree-sitter marks malformed regions
+    // with `type === "ERROR"` and inserted-recovery tokens via isMissing().
+    const stack = [node];
+    while (stack.length > 0) {
+        const current = stack.pop();
+        if (!current)
+            continue;
+        const missing = nodeIsMissing(current);
+        if (current.type === "ERROR" || missing) {
+            const point = current.startPosition ?? { row: 0, column: 0 };
+            return { line: point.row + 1, column: point.column + 1, type: missing ? "MISSING" : "ERROR" };
+        }
+        const count = current.childCount ?? 0;
+        for (let i = count - 1; i >= 0; i--) {
+            const child = current.child(i);
+            if (child)
+                stack.push(child);
+        }
+    }
+    return null;
+}
+/**
+ * Parse `content` with the grammar for `ext` and report the first syntax error, if any.
+ * Returns checked=false when no grammar is available (caller should skip validation rather than
+ * block the edit). This is the safety check used before committing a replace_symbol_body edit.
+ */
+export async function validateSyntax(content, ext) {
+    const grammarName = getGrammarName(ext);
+    if (!grammarName)
+        return { ok: true, checked: false, firstError: null };
+    const lang = await loadGrammar(grammarName);
+    if (!lang)
+        return { ok: true, checked: false, firstError: null };
+    let parser = null;
+    let tree = null;
+    try {
+        const Parser = await initParser();
+        parser = new Parser();
+        parser.setLanguage(lang);
+        tree = parser.parse(content);
+        const root = tree.rootNode;
+        // Fast path: when the tree reports no error at all, skip the full walk.
+        if (!nodeHasError(root)) {
+            return { ok: true, checked: true, firstError: null };
+        }
+        const firstError = findFirstSyntaxError(root);
+        // hasError was true but we couldn't pinpoint a node — still treat as invalid.
+        return { ok: false, checked: true, firstError: firstError ?? { line: 1, column: 1, type: "ERROR" } };
+    }
+    catch {
+        // Parser failure shouldn't block the edit; treat as "not checked".
+        return { ok: true, checked: false, firstError: null };
+    }
+    finally {
+        tree?.delete?.();
+        parser?.delete?.();
+    }
+}
+//# sourceMappingURL=tree-sitter-runtime.js.map

package/build/core/tree-sitter-runtime.js.map

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

package/build/core/tree-sitter.d.ts

@@ -0,0 +1,6 @@
+import type { CodeSymbol } from "./parser.js";
+import { type SyntaxValidationResult } from "./tree-sitter-runtime.js";
+export { getGrammarName, getSupportedExtensions, type SyntaxValidationResult } from "./tree-sitter-runtime.js";
+export declare function parseWithTreeSitter(content: string, ext: string): Promise<CodeSymbol[] | null>;
+export declare function validateSyntax(content: string, ext: string): Promise<SyntaxValidationResult>;
+//# sourceMappingURL=tree-sitter.d.ts.map

package/build/core/tree-sitter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tree-sitter.d.ts","sourceRoot":"","sources":["../../src/core/tree-sitter.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAC9C,OAAO,EAAkB,KAAK,sBAAsB,EAAE,MAAM,0BAA0B,CAAC;AAEvF,OAAO,EAAE,cAAc,EAAE,sBAAsB,EAAE,KAAK,sBAAsB,EAAE,MAAM,0BAA0B,CAAC;AAI/G,wBAAsB,mBAAmB,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,EAAE,GAAG,IAAI,CAAC,CAIpG;AAED,wBAAsB,cAAc,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,sBAAsB,CAAC,CAMlG"}

package/build/core/tree-sitter.js

@@ -0,0 +1,24 @@
+import { getGrammarName } from "./tree-sitter-runtime.js";
+import { IsolatedParser } from "./parser-process.js";
+export { getGrammarName, getSupportedExtensions } from "./tree-sitter-runtime.js";
+const parser = new IsolatedParser();
+export async function parseWithTreeSitter(content, ext) {
+    if (!getGrammarName(ext))
+        return null;
+    try {
+        return await parser.request("parse", content, ext);
+    }
+    catch {
+        return null;
+    } // analyzeContent uses its structural regex fallback.
+}
+export async function validateSyntax(content, ext) {
+    if (!getGrammarName(ext))
+        return { ok: true, checked: false, firstError: null };
+    // A crashed parser is not evidence that an edit is valid. Fail closed.
+    const result = await parser.request("validate", content, ext);
+    if (!result.checked)
+        throw new Error("Syntax validation unavailable: parser could not check the source. Retry or validate with a native language tool.");
+    return result;
+}
+//# sourceMappingURL=tree-sitter.js.map

package/build/core/tree-sitter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tree-sitter.js","sourceRoot":"","sources":["../../src/core/tree-sitter.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,cAAc,EAA+B,MAAM,0BAA0B,CAAC;AACvF,OAAO,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AACrD,OAAO,EAAE,cAAc,EAAE,sBAAsB,EAA+B,MAAM,0BAA0B,CAAC;AAE/G,MAAM,MAAM,GAAG,IAAI,cAAc,EAAE,CAAC;AAEpC,MAAM,CAAC,KAAK,UAAU,mBAAmB,CAAC,OAAe,EAAE,GAAW;IACpE,IAAI,CAAC,cAAc,CAAC,GAAG,CAAC;QAAE,OAAO,IAAI,CAAC;IACtC,IAAI,CAAC;QAAC,OAAO,MAAM,MAAM,CAAC,OAAO,CAAC,OAAO,EAAE,OAAO,EAAE,GAAG,CAAwB,CAAC;IAAC,CAAC;IAClF,MAAM,CAAC;QAAC,OAAO,IAAI,CAAC;IAAC,CAAC,CAAC,qDAAqD;AAC9E,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,cAAc,CAAC,OAAe,EAAE,GAAW;IAC/D,IAAI,CAAC,cAAc,CAAC,GAAG,CAAC;QAAE,OAAO,EAAE,EAAE,EAAE,IAAI,EAAE,OAAO,EAAE,KAAK,EAAE,UAAU,EAAE,IAAI,EAAE,CAAC;IAChF,uEAAuE;IACvE,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,OAAO,CAAC,UAAU,EAAE,OAAO,EAAE,GAAG,CAA2B,CAAC;IACxF,IAAI,CAAC,MAAM,CAAC,OAAO;QAAE,MAAM,IAAI,KAAK,CAAC,kHAAkH,CAAC,CAAC;IACzJ,OAAO,MAAM,CAAC;AAChB,CAAC"}

package/build/core/typescript-reference-process.d.ts

@@ -0,0 +1,30 @@
+import type { findTypeScriptReferences, CompilerInput, CompilerResult } from "./typescript-references.js";
+type Input = Parameters<typeof findTypeScriptReferences>[0];
+type Result = ReturnType<typeof findTypeScriptReferences>;
+/** Compiler work cannot block MCP heartbeats or take down the stdio process. */
+export declare class TypeScriptReferenceProcess {
+    private options;
+    private child;
+    private active;
+    private queue;
+    private deadline;
+    private idle;
+    private sequence;
+    constructor(options?: {
+        worker?: URL;
+        timeoutMs?: number;
+        idleMs?: number;
+        heapMb?: number;
+    });
+    query(input: Input): Promise<Result>;
+    compiler(input: CompilerInput): Promise<CompilerResult>;
+    private enqueue;
+    close(): void;
+    private fail;
+    private dispatch;
+}
+export declare const queryTypeScriptReferences: (input: Input) => Promise<Result>;
+export declare const closeTypeScriptReferenceProcess: () => void;
+export declare const queryTypeScriptCompiler: (input: CompilerInput) => Promise<CompilerResult>;
+export {};
+//# sourceMappingURL=typescript-reference-process.d.ts.map

package/build/core/typescript-reference-process.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"typescript-reference-process.d.ts","sourceRoot":"","sources":["../../src/core/typescript-reference-process.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,wBAAwB,EAAE,aAAa,EAAE,cAAc,EAAE,MAAM,4BAA4B,CAAC;AAG1G,KAAK,KAAK,GAAG,UAAU,CAAC,OAAO,wBAAwB,CAAC,CAAC,CAAC,CAAC,CAAC;AAC5D,KAAK,MAAM,GAAG,UAAU,CAAC,OAAO,wBAAwB,CAAC,CAAC;AAM1D,gFAAgF;AAChF,qBAAa,0BAA0B;IAOzB,OAAO,CAAC,OAAO;IAN3B,OAAO,CAAC,KAAK,CAA2B;IACxC,OAAO,CAAC,MAAM,CAAsB;IACpC,OAAO,CAAC,KAAK,CAAiB;IAC9B,OAAO,CAAC,QAAQ,CAA6B;IAC7C,OAAO,CAAC,IAAI,CAA6B;IACzC,OAAO,CAAC,QAAQ,CAAK;gBACD,OAAO,GAAE;QAAE,MAAM,CAAC,EAAE,GAAG,CAAC;QAAC,SAAS,CAAC,EAAE,MAAM,CAAC;QAAC,MAAM,CAAC,EAAE,MAAM,CAAC;QAAC,MAAM,CAAC,EAAE,MAAM,CAAA;KAAO;IAExG,KAAK,CAAC,KAAK,EAAE,KAAK,GAAG,OAAO,CAAC,MAAM,CAAC;IAIpC,QAAQ,CAAC,KAAK,EAAE,aAAa,GAAG,OAAO,CAAC,cAAc,CAAC;IAIvD,OAAO,CAAC,OAAO;IAKf,KAAK,IAAI,IAAI;IAEb,OAAO,CAAC,IAAI;IASZ,OAAO,CAAC,QAAQ;CAoDjB;AAGD,eAAO,MAAM,yBAAyB,GAAU,OAAO,KAAK,KAAG,OAAO,CAAC,MAAM,CAG5E,CAAC;AACF,eAAO,MAAM,+BAA+B,QAAO,IAAgC,CAAC;AACpF,eAAO,MAAM,uBAAuB,GAAU,OAAO,aAAa,KAAG,OAAO,CAAC,cAAc,CAG1F,CAAC"}

package/build/core/typescript-reference-process.js

@@ -0,0 +1,124 @@
+import { fork } from "node:child_process";
+import { sharedCompute } from "./local-daemon.js";
+// Full compiler graphs for ordinary monorepos exceed 512 MB even when projects
+// are disposed sequentially. This is a ceiling, not an up-front allocation.
+const DEFAULT_HEAP_MB = 1024;
+/** Compiler work cannot block MCP heartbeats or take down the stdio process. */
+export class TypeScriptReferenceProcess {
+    options;
+    child;
+    active;
+    queue = [];
+    deadline;
+    idle;
+    sequence = 0;
+    constructor(options = {}) {
+        this.options = options;
+    }
+    query(input) {
+        return this.enqueue(input);
+    }
+    compiler(input) {
+        return this.enqueue(input);
+    }
+    enqueue(input) {
+        if (this.queue.length >= 16 || input.files.length > 20_000)
+            return Promise.reject(new Error("Reference lookup exceeds queue or file capacity; narrow the workspace."));
+        return new Promise((resolve, reject) => { this.queue.push({ id: ++this.sequence, input, resolve, reject }); this.dispatch(); });
+    }
+    close() { this.fail(new Error("Reference worker closed.")); }
+    fail(error, rejectQueued = true) {
+        clearTimeout(this.deadline);
+        clearTimeout(this.idle);
+        const child = this.child;
+        this.child = undefined;
+        child?.kill("SIGKILL");
+        this.active?.reject(error);
+        this.active = undefined;
+        if (rejectQueued)
+            for (const pending of this.queue.splice(0))
+                pending.reject(error);
+        else
+            this.dispatch();
+    }
+    dispatch() {
+        if (this.active || !this.queue.length)
+            return;
+        clearTimeout(this.idle);
+        try {
+            if (!this.child) {
+                const configured = this.options.heapMb ?? Number(process.env.CONTEXTPRO_REFERENCE_HEAP_MB ?? DEFAULT_HEAP_MB);
+                const heapMb = Number.isInteger(configured) && configured >= 256 && configured <= 4096 ? configured : DEFAULT_HEAP_MB;
+                let stderrTail = "";
+                let outOfMemory = false;
+                const child = fork(this.options.worker ?? new URL("./typescript-reference-worker.js", import.meta.url), [], {
+                    execArgv: [`--max-old-space-size=${heapMb}`, "--expose-gc"], stdio: ["ignore", "ignore", "pipe", "ipc"], serialization: "advanced",
+                });
+                this.child = child;
+                child.stderr?.on("data", chunk => {
+                    stderrTail = (stderrTail + String(chunk)).slice(-8192);
+                    outOfMemory ||= /heap out of memory|allocation failed|reached heap limit/i.test(stderrTail);
+                });
+                // Captured diagnostics must not keep an otherwise idle MCP/test process
+                // alive. Active requests are held by the child and deadline timer.
+                child.stderr?.unref?.();
+                child.on("error", error => { if (this.child === child)
+                    this.fail(error); });
+                // close follows stderr drain, so an OOM report cannot race the exit event.
+                child.on("close", (code, signal) => {
+                    if (this.child !== child)
+                        return;
+                    this.fail(new Error(outOfMemory
+                        ? `Reference worker exhausted its ${heapMb} MB JavaScript heap; no reference result is available. Set CONTEXTPRO_REFERENCE_HEAP_MB (256–4096) to a larger limit and restart the MCP host, or use native references.`
+                        : `Reference worker exited (${signal ?? code}); retry or use native references.`));
+                });
+                child.on("message", (message) => {
+                    if (this.child !== child || !this.active || message?.id !== this.active.id)
+                        return;
+                    clearTimeout(this.deadline);
+                    const pending = this.active;
+                    this.active = undefined;
+                    if (message.error)
+                        pending.reject(new Error(message.error));
+                    else if (message.result)
+                        pending.resolve(message.result);
+                    else
+                        pending.reject(new Error("Reference worker returned no result."));
+                    if (this.queue.length)
+                        this.dispatch();
+                    else {
+                        child.unref();
+                        child.channel?.unref();
+                        this.idle = setTimeout(() => { if (this.child === child && !this.active)
+                            this.close(); }, this.options.idleMs ?? 60_000);
+                        this.idle.unref();
+                    }
+                });
+            }
+            const pending = this.queue.shift();
+            this.active = pending;
+            const child = this.child;
+            child.ref();
+            child.channel?.ref();
+            // Waiting requests have not used their analysis budget. Restart the worker
+            // for them rather than reporting the active request's timeout as theirs.
+            this.deadline = setTimeout(() => this.fail(new Error("Reference analysis exceeded its time limit; narrow the workspace or retry."), false), this.options.timeoutMs ?? 30_000);
+            child.send({ id: pending.id, input: pending.input }, error => { if (error && this.child === child)
+                this.fail(error); });
+        }
+        catch (error) {
+            this.fail(error instanceof Error ? error : new Error(String(error)));
+        }
+    }
+}
+const referenceProcess = new TypeScriptReferenceProcess();
+export const queryTypeScriptReferences = async (input) => {
+    const shared = await sharedCompute("references", input);
+    return shared ? shared.value : referenceProcess.query(input);
+};
+export const closeTypeScriptReferenceProcess = () => referenceProcess.close();
+export const queryTypeScriptCompiler = async (input) => {
+    const shared = await sharedCompute("compiler", input);
+    return shared ? shared.value : referenceProcess.compiler(input);
+};
+//# sourceMappingURL=typescript-reference-process.js.map

package/build/core/typescript-reference-process.js.map

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

package/build/core/typescript-reference-worker.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=typescript-reference-worker.d.ts.map

package/build/core/typescript-reference-worker.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"typescript-reference-worker.d.ts","sourceRoot":"","sources":["../../src/core/typescript-reference-worker.ts"],"names":[],"mappings":""}

package/build/core/typescript-reference-worker.js

@@ -0,0 +1,14 @@
+import { findTypeScriptReferences, runTypeScriptOperation } from "./typescript-references.js";
+process.on("disconnect", () => process.exit(0));
+process.on("message", (message) => {
+    try {
+        const result = "operation" in message.input ? runTypeScriptOperation(message.input) : findTypeScriptReferences(message.input);
+        if (process.connected)
+            process.send?.({ id: message.id, result });
+    }
+    catch (error) {
+        if (process.connected)
+            process.send?.({ id: message.id, error: error instanceof Error ? error.message : String(error) });
+    }
+});
+//# sourceMappingURL=typescript-reference-worker.js.map

package/build/core/typescript-reference-worker.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"typescript-reference-worker.js","sourceRoot":"","sources":["../../src/core/typescript-reference-worker.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,wBAAwB,EAAE,sBAAsB,EAAsB,MAAM,4BAA4B,CAAC;AAElH,OAAO,CAAC,EAAE,CAAC,YAAY,EAAE,GAAG,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC;AAChD,OAAO,CAAC,EAAE,CAAC,SAAS,EAAE,CAAC,OAA8F,EAAE,EAAE;IACvH,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,WAAW,IAAI,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,sBAAsB,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,wBAAwB,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;QAC9H,IAAI,OAAO,CAAC,SAAS;YAAE,OAAO,CAAC,IAAI,EAAE,CAAC,EAAE,EAAE,EAAE,OAAO,CAAC,EAAE,EAAE,MAAM,EAAE,CAAC,CAAC;IACpE,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,IAAI,OAAO,CAAC,SAAS;YAAE,OAAO,CAAC,IAAI,EAAE,CAAC,EAAE,EAAE,EAAE,OAAO,CAAC,EAAE,EAAE,KAAK,EAAE,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;IAC3H,CAAC;AACH,CAAC,CAAC,CAAC"}

package/build/core/typescript-references.d.ts

@@ -0,0 +1,71 @@
+export interface TypedReference {
+    file: string;
+    line: number;
+    column: number;
+    context: string;
+    isDefinition: boolean;
+    kind: "definition" | "import" | "call" | "reference";
+}
+export interface CompilerInput {
+    rootDir: string;
+    files: string[];
+    operation: "diagnostics" | "rename";
+    file?: string;
+    line?: number;
+    column?: number;
+    newName?: string;
+}
+export interface CompilerResult {
+    engine: "typescript" | "pyright";
+    warnings: string[];
+    diagnostics?: Array<{
+        file: string;
+        line: number;
+        column: number;
+        severity: string;
+        code: string;
+        message: string;
+    }>;
+    edits?: Array<{
+        file: string;
+        start: number;
+        length: number;
+        text: string;
+    }>;
+}
+export declare function clearTypeScriptReferenceCache(): void;
+export declare function findTypeScriptReferences(input: {
+    rootDir: string;
+    files: string[];
+    file: string;
+    line: number;
+    symbol: string;
+    limit?: number;
+}): {
+    references: TypedReference[];
+    total: number;
+    counts: {
+        definition: number;
+        import: number;
+        call: number;
+        reference: number;
+    };
+    callsByFile: {
+        file: string;
+        calls: number;
+    }[];
+    callFileCount: number;
+    warnings: string[];
+    scope: {
+        kind: string;
+        files: number;
+        checkedFiles: number;
+        configs: string[];
+        includesIndexedTests: boolean;
+    };
+    projectCount: number;
+    reusedProjects: number;
+};
+/** Diagnostics and rename share the existing bounded compiler cache and worker. */
+export declare function runTypeScriptOperation(input: CompilerInput): CompilerResult;
+//# sourceMappingURL=typescript-references.d.ts.map