aws-runtime-bridge 1.9.51 → 1.9.55

package/package/acode/README.md

@@ -86,3 +86,29 @@ prompt or tool call. Hook errors are reported as runtime `error` events and are
 otherwise fail-open so extension failures do not crash the session. The
 `modify` decision value is reserved for a future prompt/tool-argument mutation
 API and is not applied by the current runtime.
+
+## Code symbols (tree-sitter)
+
+ACode bundles tree-sitter for AST-based code analysis, exposed via the
+`symbols` built-in tool. Supports 13 languages: TypeScript (incl. TSX),
+JavaScript (incl. JSX), Python, Go, Rust, Java, C, C++, C#, Ruby, PHP, Lua,
+Bash.
+
+Three modes:
+- `definitions` — find symbol declarations (functions, classes, methods, etc.)
+- `references` — find symbol usages within a single file
+- `outline` — return the full symbol structure of a file
+
+ASTs are cached in-memory (LRU, 100 files) keyed by path + mtime + size.
+Grammar WASM files are lazy-loaded on first use of each language.
+
+Grammar WASM files live in `grammars/`. To refresh them after a
+`web-tree-sitter` upgrade:
+
+    node scripts/fetch-grammars.mjs
+
+To add a new language:
+1. Add an entry to `scripts/fetch-grammars.mjs`
+2. Run the script
+3. Add extension mapping in `parsers/language-detector.ts`
+4. Add query patterns in `parsers/language-queries.ts`

package/package/acode/dist/built-in-file-tools.d.ts

@@ -26,5 +26,16 @@ export interface AgentFileChangeRecord {
     afterContent: string | null;
 }
 export type OnAgentFileChange = (record: AgentFileChangeRecord) => void | Promise<void>;
+export interface ResolvedWorkspaceTarget {
+    workspaceRoot: string;
+    requestedPath: string;
+    targetPath: string;
+}
+export declare function ensureInsideWorkspace(workspaceRoot: string, targetPath: string): string;
+/**
+ * 解析内置文件工具目标路径。
+ * 主流程：同时校验请求路径与 realpath 工作区边界，防止绝对路径、`..` 与符号链接目录穿透。
+ */
+export declare function resolveWorkspaceTarget(workingDirectory: string, rawFilePath: string): Promise<ResolvedWorkspaceTarget>;
 export declare function createBuiltInFileTools(workingDirectory: string, agentId?: string, onFileChange?: OnAgentFileChange): ACodeBuiltInTool[];
 //# sourceMappingURL=built-in-file-tools.d.ts.map

package/package/acode/dist/built-in-file-tools.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"built-in-file-tools.d.ts","sourceRoot":"","sources":["../src/built-in-file-tools.ts"],"names":[],"mappings":"AAKA,OAAO,EAEL,KAAK,iBAAiB,EACvB,MAAM,kCAAkC,CAAC;AAiC1C,MAAM,MAAM,SAAS,GACjB,MAAM,GACN,MAAM,GACN,OAAO,GACP,IAAI,GACJ,SAAS,EAAE,GACX;IAAE,CAAC,GAAG,EAAE,MAAM,GAAG,SAAS,CAAA;CAAE,CAAC;AACjC,MAAM,MAAM,UAAU,GAAG;IAAE,CAAC,GAAG,EAAE,MAAM,GAAG,SAAS,CAAA;CAAE,CAAC;AAEtD,MAAM,WAAW,gBAAgB;IAC/B,IAAI,EAAE,SAAS,CAAC;IAChB,QAAQ,EAAE,MAAM,CAAC;IACjB,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,UAAU,CAAC;IACxB,OAAO,CACL,IAAI,EAAE,UAAU,EAChB,OAAO,CAAC,EAAE,gCAAgC,GACzC,OAAO,CAAC,OAAO,CAAC,CAAC;CACrB;AAED,MAAM,WAAW,gCAAgC;IAC/C,QAAQ,CAAC,QAAQ,CAAC,EAAE,iBAAiB,CAAC;IACtC,kEAAkE;IAClE,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC;CAC9B;AAED,sCAAsC;AACtC,MAAM,WAAW,qBAAqB;IACpC,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,QAAQ,GAAG,QAAQ,GAAG,QAAQ,CAAC;IAC1C,aAAa,EAAE,MAAM,GAAG,IAAI,CAAC;IAC7B,YAAY,EAAE,MAAM,GAAG,IAAI,CAAC;CAC7B;AAED,MAAM,MAAM,iBAAiB,GAAG,CAAC,MAAM,EAAE,qBAAqB,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;AAgrCxF,wBAAgB,sBAAsB,CACpC,gBAAgB,EAAE,MAAM,EACxB,OAAO,CAAC,EAAE,MAAM,EAChB,YAAY,CAAC,EAAE,iBAAiB,GAC/B,gBAAgB,EAAE,CAUpB"}
+{"version":3,"file":"built-in-file-tools.d.ts","sourceRoot":"","sources":["../src/built-in-file-tools.ts"],"names":[],"mappings":"AAKA,OAAO,EAEL,KAAK,iBAAiB,EACvB,MAAM,kCAAkC,CAAC;AAkC1C,MAAM,MAAM,SAAS,GACjB,MAAM,GACN,MAAM,GACN,OAAO,GACP,IAAI,GACJ,SAAS,EAAE,GACX;IAAE,CAAC,GAAG,EAAE,MAAM,GAAG,SAAS,CAAA;CAAE,CAAC;AACjC,MAAM,MAAM,UAAU,GAAG;IAAE,CAAC,GAAG,EAAE,MAAM,GAAG,SAAS,CAAA;CAAE,CAAC;AAEtD,MAAM,WAAW,gBAAgB;IAC/B,IAAI,EAAE,SAAS,CAAC;IAChB,QAAQ,EAAE,MAAM,CAAC;IACjB,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,UAAU,CAAC;IACxB,OAAO,CACL,IAAI,EAAE,UAAU,EAChB,OAAO,CAAC,EAAE,gCAAgC,GACzC,OAAO,CAAC,OAAO,CAAC,CAAC;CACrB;AAED,MAAM,WAAW,gCAAgC;IAC/C,QAAQ,CAAC,QAAQ,CAAC,EAAE,iBAAiB,CAAC;IACtC,kEAAkE;IAClE,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC;CAC9B;AAED,sCAAsC;AACtC,MAAM,WAAW,qBAAqB;IACpC,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,QAAQ,GAAG,QAAQ,GAAG,QAAQ,CAAC;IAC1C,aAAa,EAAE,MAAM,GAAG,IAAI,CAAC;IAC7B,YAAY,EAAE,MAAM,GAAG,IAAI,CAAC;CAC7B;AAED,MAAM,MAAM,iBAAiB,GAAG,CAAC,MAAM,EAAE,qBAAqB,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;AAExF,MAAM,WAAW,uBAAuB;IACtC,aAAa,EAAE,MAAM,CAAC;IACtB,aAAa,EAAE,MAAM,CAAC;IACtB,UAAU,EAAE,MAAM,CAAC;CACpB;AAkHD,wBAAgB,qBAAqB,CACnC,aAAa,EAAE,MAAM,EACrB,UAAU,EAAE,MAAM,GACjB,MAAM,CAOR;AA+DD;;;GAGG;AACH,wBAAsB,sBAAsB,CAC1C,gBAAgB,EAAE,MAAM,EACxB,WAAW,EAAE,MAAM,GAClB,OAAO,CAAC,uBAAuB,CAAC,CAgClC;AAw8BD,wBAAgB,sBAAsB,CACpC,gBAAgB,EAAE,MAAM,EACxB,OAAO,CAAC,EAAE,MAAM,EAChB,YAAY,CAAC,EAAE,iBAAiB,GAC/B,gBAAgB,EAAE,CAWpB"}

package/package/acode/dist/built-in-file-tools.js

@@ -3,6 +3,7 @@ import { promises as fs, createReadStream } from "node:fs";
 import path from "node:path";
 import readline from "node:readline";
 import { runShellCommand, } from "./builtins/shellCommandRunner.js";
+import { symbolsTool } from "./built-in-symbols-tool.js";
 // ── read_file pagination & truncation constants ──────────────────────────────
 const DEFAULT_READ_LIMIT = 2000;
 const MAX_LINE_LENGTH = 2000;
@@ -123,7 +124,7 @@ async function isBinaryFile(filePath) {
         await handle.close();
     }
 }
-function ensureInsideWorkspace(workspaceRoot, targetPath) {
+export function ensureInsideWorkspace(workspaceRoot, targetPath) {
     const resolvedTargetPath = path.resolve(targetPath);
     const relativePath = path.relative(workspaceRoot, resolvedTargetPath);
     if (relativePath.startsWith("..") || path.isAbsolute(relativePath)) {
@@ -179,7 +180,7 @@ async function ensureWritableTarget(workspaceRoot, targetPath) {
  * 解析内置文件工具目标路径。
  * 主流程：同时校验请求路径与 realpath 工作区边界，防止绝对路径、`..` 与符号链接目录穿透。
  */
-async function resolveWorkspaceTarget(workingDirectory, rawFilePath) {
+export async function resolveWorkspaceTarget(workingDirectory, rawFilePath) {
     const requestedRoot = path.resolve(String(workingDirectory || "").trim());
     const workspaceRoot = await fs.realpath(requestedRoot);
     const workspaceStat = await fs.stat(workspaceRoot);
@@ -960,5 +961,6 @@ export function createBuiltInFileTools(workingDirectory, agentId, onFileChange)
         deleteFileTool(workingDirectory, onFileChange),
         grepTool(workingDirectory),
         bashTool(workingDirectory, resolvedAgentId),
+        symbolsTool(workingDirectory),
     ];
 }

package/package/acode/dist/built-in-symbols-tool.d.ts

@@ -0,0 +1,7 @@
+import type { ACodeBuiltInTool } from "./built-in-file-tools.js";
+/**
+ * symbols 工具入口：参数校验 → 调 extractor → 标准化输出。
+ * 不直接操作 tree-sitter API，所有解析逻辑在 parsers/ 里。
+ */
+export declare function symbolsTool(workingDirectory: string): ACodeBuiltInTool;
+//# sourceMappingURL=built-in-symbols-tool.d.ts.map

package/package/acode/dist/built-in-symbols-tool.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"built-in-symbols-tool.d.ts","sourceRoot":"","sources":["../src/built-in-symbols-tool.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAc,MAAM,0BAA0B,CAAC;AAkB7E;;;GAGG;AACH,wBAAgB,WAAW,CAAC,gBAAgB,EAAE,MAAM,GAAG,gBAAgB,CA8DtE"}

package/package/acode/dist/built-in-symbols-tool.js

@@ -0,0 +1,117 @@
+import { extractSymbols } from "./parsers/symbol-extractor.js";
+const SYMBOLS_TOOL_DESCRIPTION = "Query code symbols (definitions, references, outline) by parsing file AST via tree-sitter. " +
+    "Unlike grep (text matching), this tool understands syntax structure — no false positives from " +
+    "comments/strings, and it knows whether 'foo' is a function, class, variable, or method. " +
+    "Supports 13 languages: TypeScript, JavaScript, Python, Go, Rust, Java, C, C++, C#, Ruby, PHP, " +
+    "Lua, Bash. Single-file scope (no cross-file reference resolution). " +
+    "Falls back to grep for files in unsupported languages.\n\n" +
+    "When to use `symbols` vs `grep`:\n" +
+    "- Use `symbols` when you need to find function/class/method **declarations** or their " +
+    "**type-aware usages** in supported languages. It avoids false positives from comments/strings.\n" +
+    "- Use `grep` for: cross-file text search, unsupported languages (e.g., Markdown, YAML), " +
+    "searching non-symbol patterns (TODOs, log strings, config values), or when `symbols` returns " +
+    "\"unsupported language\".";
+/**
+ * symbols 工具入口：参数校验 → 调 extractor → 标准化输出。
+ * 不直接操作 tree-sitter API，所有解析逻辑在 parsers/ 里。
+ */
+export function symbolsTool(workingDirectory) {
+    return {
+        kind: "builtin",
+        toolName: "symbols",
+        exposedName: "symbols",
+        description: SYMBOLS_TOOL_DESCRIPTION,
+        inputSchema: {
+            type: "object",
+            properties: {
+                path: {
+                    type: "string",
+                    description: "Workspace-relative file path to analyze. Must be a single file (not a directory).",
+                },
+                mode: {
+                    type: "string",
+                    enum: ["definitions", "references", "outline"],
+                    description: "Query mode: " +
+                        "'definitions' finds symbol declarations matching pattern/kind " +
+                        "(e.g., function/class/method declarations); " +
+                        "'references' finds all usages of symbols matching pattern " +
+                        "(e.g., calls, type annotations, assignments); " +
+                        "'outline' returns the full symbol structure of the file " +
+                        "(ignores pattern/kind filters).",
+                },
+                pattern: {
+                    type: "string",
+                    description: "Optional regex to filter symbol names (case-sensitive by default; use (?i) prefix for case-insensitive). " +
+                        "In 'outline' mode this is ignored. " +
+                        "Example: '^getUser' matches getUserById, getUserByEmail.",
+                },
+                kind: {
+                    type: "string",
+                    enum: ["function", "class", "method", "variable", "import", "all"],
+                    description: "Symbol kind filter. 'all' (default) returns all kinds. " +
+                        "Note: not all languages distinguish all kinds (e.g., Bash has no 'class').",
+                },
+                max_results: {
+                    type: "number",
+                    description: "Maximum number of symbols to return. Default 100.",
+                },
+            },
+            required: ["path", "mode"],
+            additionalProperties: false,
+        },
+        async execute(args) {
+            const filePath = readStringArg(args, ["path"], "path");
+            const mode = readModeArg(args);
+            const pattern = readOptionalStringArg(args, ["pattern"]);
+            const kind = readKindArg(args);
+            const maxResults = readOptionalPositiveIntegerArg(args, ["max_results"], 100);
+            return extractSymbols(workingDirectory, filePath, mode, {
+                pattern,
+                kind,
+                maxResults,
+            });
+        },
+    };
+}
+// ── 参数读取辅助（与 built-in-file-tools.ts 保持风格一致） ────────────────
+function readStringArg(args, names, label) {
+    for (const name of names) {
+        const v = args[name];
+        if (typeof v === "string")
+            return v;
+    }
+    throw new Error(`${label} is required`);
+}
+function readOptionalStringArg(args, names) {
+    for (const name of names) {
+        const v = args[name];
+        if (typeof v === "string" && v.trim())
+            return v;
+    }
+    return undefined;
+}
+function readModeArg(args) {
+    const v = args.mode;
+    if (v === "definitions" || v === "references" || v === "outline")
+        return v;
+    throw new Error(`mode must be one of: definitions, references, outline`);
+}
+function readKindArg(args) {
+    const v = args.kind;
+    if (v === undefined || v === null || v === "all")
+        return "all";
+    if (v === "function" || v === "class" || v === "method" ||
+        v === "variable" || v === "import" || v === "error") {
+        return v;
+    }
+    throw new Error(`kind must be one of: function, class, method, variable, import, all`);
+}
+function readOptionalPositiveIntegerArg(args, names, fallback) {
+    for (const name of names) {
+        const v = args[name];
+        const num = typeof v === "number" ? v : typeof v === "string" ? Number(v) : NaN;
+        if (Number.isFinite(num) && num > 0)
+            return Math.floor(num);
+    }
+    return fallback;
+}

package/package/acode/dist/index.d.ts

@@ -9,4 +9,11 @@ export * from './sub-agent-types.js';
 export * from './sub-agent-store.js';
 export * from './sub-agent-manager.js';
 export * from './sub-agent-tools.js';
+export * from './parsers/types.js';
+export * from './parsers/tree-sitter-loader.js';
+export * from './parsers/ast-cache.js';
+export * from './parsers/language-detector.js';
+export * from './parsers/language-queries.js';
+export * from './parsers/symbol-extractor.js';
+export * from './built-in-symbols-tool.js';
 //# sourceMappingURL=index.d.ts.map

package/package/acode/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,+BAA+B,CAAC;AAC9C,cAAc,6BAA6B,CAAC;AAC5C,cAAc,6BAA6B,CAAC;AAC5C,cAAc,aAAa,CAAC;AAC5B,cAAc,oBAAoB,CAAC;AACnC,cAAc,cAAc,CAAC;AAC7B,cAAc,YAAY,CAAC;AAC3B,cAAc,sBAAsB,CAAC;AACrC,cAAc,sBAAsB,CAAC;AACrC,cAAc,wBAAwB,CAAC;AACvC,cAAc,sBAAsB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,+BAA+B,CAAC;AAC9C,cAAc,6BAA6B,CAAC;AAC5C,cAAc,6BAA6B,CAAC;AAC5C,cAAc,aAAa,CAAC;AAC5B,cAAc,oBAAoB,CAAC;AACnC,cAAc,cAAc,CAAC;AAC7B,cAAc,YAAY,CAAC;AAC3B,cAAc,sBAAsB,CAAC;AACrC,cAAc,sBAAsB,CAAC;AACrC,cAAc,wBAAwB,CAAC;AACvC,cAAc,sBAAsB,CAAC;AAGrC,cAAc,oBAAoB,CAAC;AACnC,cAAc,iCAAiC,CAAC;AAChD,cAAc,wBAAwB,CAAC;AACvC,cAAc,gCAAgC,CAAC;AAC/C,cAAc,+BAA+B,CAAC;AAC9C,cAAc,+BAA+B,CAAC;AAC9C,cAAc,4BAA4B,CAAC"}

package/package/acode/dist/index.js

@@ -9,3 +9,11 @@ export * from './sub-agent-types.js';
 export * from './sub-agent-store.js';
 export * from './sub-agent-manager.js';
 export * from './sub-agent-tools.js';
+// tree-sitter symbols 工具
+export * from './parsers/types.js';
+export * from './parsers/tree-sitter-loader.js';
+export * from './parsers/ast-cache.js';
+export * from './parsers/language-detector.js';
+export * from './parsers/language-queries.js';
+export * from './parsers/symbol-extractor.js';
+export * from './built-in-symbols-tool.js';

package/package/acode/dist/parsers/ast-cache.d.ts

@@ -0,0 +1,33 @@
+import type { Tree } from "web-tree-sitter";
+/**
+ * AST 缓存：LRU + mtime/size 失效。
+ *
+ * 设计要点：
+ *  - cache key 用 path + mtimeMs + size 三重校验，mtime 秒级精度不够时 size 兜底
+ *  - LRU 用 JS Map 的插入顺序语义实现：命中时 delete+set 让它变最新
+ *  - tree-sitter 的 Tree 是 WASM 对象，必须显式 tree.delete()，不归 V8 GC 管
+ *  - capacity 默认 100，淘汰最旧时调 tree.delete() 释放 WASM 内存
+ */
+export declare class AstCache {
+    private map;
+    private readonly capacity;
+    constructor(capacity?: number);
+    /**
+     * 取缓存。mtimeMs 或 size 不匹配则视为 stale，删除并返回 null。
+     */
+    get(absolutePath: string, mtimeMs: number, size: number): Tree | null;
+    /**
+     * 存缓存。若 key 已存在则覆盖（旧 tree 释放）。
+     * 超容量时淘汰最旧（Map 的 keys().next().value）。
+     */
+    set(absolutePath: string, tree: Tree, language: string, mtimeMs: number, size: number): void;
+    /** 主动失效：删除并释放 tree */
+    invalidate(absolutePath: string): void;
+    /** 清空所有缓存并释放所有 tree */
+    clear(): void;
+    /** 当前缓存条目数（测试用） */
+    size(): number;
+}
+/** 进程级单例，容量 100 */
+export declare const astCache: AstCache;
+//# sourceMappingURL=ast-cache.d.ts.map

package/package/acode/dist/parsers/ast-cache.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ast-cache.d.ts","sourceRoot":"","sources":["../../src/parsers/ast-cache.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,iBAAiB,CAAC;AAS5C;;;;;;;;GAQG;AACH,qBAAa,QAAQ;IACnB,OAAO,CAAC,GAAG,CAAiC;IAC5C,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAS;gBAEtB,QAAQ,SAAM;IAK1B;;OAEG;IACH,GAAG,CAAC,YAAY,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,IAAI,GAAG,IAAI;IAerE;;;OAGG;IACH,GAAG,CACD,YAAY,EAAE,MAAM,EACpB,IAAI,EAAE,IAAI,EACV,QAAQ,EAAE,MAAM,EAChB,OAAO,EAAE,MAAM,EACf,IAAI,EAAE,MAAM,GACX,IAAI;IAgBP,sBAAsB;IACtB,UAAU,CAAC,YAAY,EAAE,MAAM,GAAG,IAAI;IAQtC,uBAAuB;IACvB,KAAK,IAAI,IAAI;IAOb,mBAAmB;IACnB,IAAI,IAAI,MAAM;CAGf;AAED,mBAAmB;AACnB,eAAO,MAAM,QAAQ,UAAoB,CAAC"}

package/package/acode/dist/parsers/ast-cache.js

@@ -0,0 +1,76 @@
+/**
+ * AST 缓存：LRU + mtime/size 失效。
+ *
+ * 设计要点：
+ *  - cache key 用 path + mtimeMs + size 三重校验，mtime 秒级精度不够时 size 兜底
+ *  - LRU 用 JS Map 的插入顺序语义实现：命中时 delete+set 让它变最新
+ *  - tree-sitter 的 Tree 是 WASM 对象，必须显式 tree.delete()，不归 V8 GC 管
+ *  - capacity 默认 100，淘汰最旧时调 tree.delete() 释放 WASM 内存
+ */
+export class AstCache {
+    constructor(capacity = 100) {
+        this.map = new Map();
+        if (capacity < 1)
+            throw new Error(`capacity must be >= 1, got ${capacity}`);
+        this.capacity = capacity;
+    }
+    /**
+     * 取缓存。mtimeMs 或 size 不匹配则视为 stale，删除并返回 null。
+     */
+    get(absolutePath, mtimeMs, size) {
+        const entry = this.map.get(absolutePath);
+        if (!entry)
+            return null;
+        if (entry.mtimeMs !== mtimeMs || entry.size !== size) {
+            // stale：删除并释放 tree
+            entry.tree.delete();
+            this.map.delete(absolutePath);
+            return null;
+        }
+        // LRU 提升：delete + set 让它变最新
+        this.map.delete(absolutePath);
+        this.map.set(absolutePath, entry);
+        return entry.tree;
+    }
+    /**
+     * 存缓存。若 key 已存在则覆盖（旧 tree 释放）。
+     * 超容量时淘汰最旧（Map 的 keys().next().value）。
+     */
+    set(absolutePath, tree, language, mtimeMs, size) {
+        const existing = this.map.get(absolutePath);
+        if (existing) {
+            existing.tree.delete();
+            this.map.delete(absolutePath);
+        }
+        this.map.set(absolutePath, { tree, language, mtimeMs, size });
+        while (this.map.size > this.capacity) {
+            const oldestKey = this.map.keys().next().value;
+            if (oldestKey === undefined)
+                break;
+            const oldest = this.map.get(oldestKey);
+            oldest?.tree.delete();
+            this.map.delete(oldestKey);
+        }
+    }
+    /** 主动失效：删除并释放 tree */
+    invalidate(absolutePath) {
+        const entry = this.map.get(absolutePath);
+        if (entry) {
+            entry.tree.delete();
+            this.map.delete(absolutePath);
+        }
+    }
+    /** 清空所有缓存并释放所有 tree */
+    clear() {
+        for (const entry of this.map.values()) {
+            entry.tree.delete();
+        }
+        this.map.clear();
+    }
+    /** 当前缓存条目数（测试用） */
+    size() {
+        return this.map.size;
+    }
+}
+/** 进程级单例，容量 100 */
+export const astCache = new AstCache(100);

package/package/acode/dist/parsers/language-detector.d.ts

@@ -0,0 +1,7 @@
+/**
+ * 根据文件扩展名检测 tree-sitter language 名。
+ * 大小写不敏感（扩展名统一转小写后查表）。
+ * 未知扩展名返回 null。
+ */
+export declare function detectLanguage(filePath: string): string | null;
+//# sourceMappingURL=language-detector.d.ts.map

package/package/acode/dist/parsers/language-detector.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"language-detector.d.ts","sourceRoot":"","sources":["../../src/parsers/language-detector.ts"],"names":[],"mappings":"AAqCA;;;;GAIG;AACH,wBAAgB,cAAc,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAG9D"}

package/package/acode/dist/parsers/language-detector.js

@@ -0,0 +1,44 @@
+import path from "node:path";
+/**
+ * 文件扩展名 → tree-sitter language 名映射。
+ *
+ * tsx/jsx 单独映射，因为 tree-sitter-typescript 包内
+ * 同时提供 typescript 和 tsx 两个 grammar（同理 javascript 包内含 jsx）。
+ * loader 按 language 名加载对应的 wasm 文件。
+ */
+const EXTENSION_MAP = {
+    ".ts": "typescript",
+    ".tsx": "tsx",
+    ".mts": "typescript",
+    ".cts": "typescript",
+    ".js": "javascript",
+    ".jsx": "jsx",
+    ".mjs": "javascript",
+    ".cjs": "javascript",
+    ".py": "python",
+    ".go": "go",
+    ".rs": "rust",
+    ".java": "java",
+    ".c": "c",
+    ".h": "c",
+    ".cpp": "cpp",
+    ".cc": "cpp",
+    ".cxx": "cpp",
+    ".hpp": "cpp",
+    ".hxx": "cpp",
+    ".cs": "c-sharp",
+    ".rb": "ruby",
+    ".php": "php",
+    ".lua": "lua",
+    ".sh": "bash",
+    ".bash": "bash",
+};
+/**
+ * 根据文件扩展名检测 tree-sitter language 名。
+ * 大小写不敏感（扩展名统一转小写后查表）。
+ * 未知扩展名返回 null。
+ */
+export function detectLanguage(filePath) {
+    const ext = path.extname(filePath).toLowerCase();
+    return EXTENSION_MAP[ext] ?? null;
+}

package/package/acode/dist/parsers/language-queries.d.ts

@@ -0,0 +1,5 @@
+import type { LanguageQueryPack } from "./types.js";
+export declare const LANGUAGE_QUERIES: Record<string, LanguageQueryPack>;
+/** 所有支持的语言名（15 项，含 tsx/jsx） */
+export declare const SUPPORTED_LANGUAGES: string[];
+//# sourceMappingURL=language-queries.d.ts.map

package/package/acode/dist/parsers/language-queries.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"language-queries.d.ts","sourceRoot":"","sources":["../../src/parsers/language-queries.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAC;AA0oBpD,eAAO,MAAM,gBAAgB,EAAE,MAAM,CAAC,MAAM,EAAE,iBAAiB,CAgB9D,CAAC;AAEF,+BAA+B;AAC/B,eAAO,MAAM,mBAAmB,UAAgC,CAAC"}