@vybestack/llxprt-code-tools 0.10.0-nightly.260613.1adad3b34

package/dist/src/tools/ast-edit/workspace-context-provider.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"workspace-context-provider.js","sourceRoot":"","sources":["../../../../src/tools/ast-edit/workspace-context-provider.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,QAAQ,IAAI,UAAU,EAAE,MAAM,IAAI,CAAC;AAK5C;;;;;;;;;;GAUG;AACH,MAAM,CAAC,KAAK,UAAU,2BAA2B,CAC/C,cAAsB,EACtB,aAAqB,EACrB,YAAuC,EACvC,YAA+B;IAE/B,MAAM,cAAc,GAAoB,EAAE,CAAC;IAE3C,2CAA2C;IAC3C,yDAAyD;IACzD,MAAM,eAAe,GAAG,MAAM,YAAY,CAAC,kBAAkB,CAAC,aAAa,CAAC,CAAC;IAE7E,0BAA0B;IAC1B,MAAM,UAAU,GAAG,eAAe,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,KAAK,cAAc,CAAC,CAAC;IAEvE,MAAM,OAAO,GAAG,MAAM,OAAO,CAAC,UAAU,CACtC,UAAU,CAAC,GAAG,CAAC,KAAK,EAAE,QAAQ,EAAE,EAAE;QAChC,MAAM,WAAW,GAAG,MAAM,UAAU,CAAC,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;QACjE,MAAM,YAAY,GAAG,MAAM,YAAY,CAAC,mBAAmB,CACzD,QAAQ,EACR,WAAW,CACZ,CAAC;QACF,OAAO,EAAE,QAAQ,EAAE,YAAY,EAAE,CAAC;IACpC,CAAC,CAAC,CACH,CAAC;IAEF,KAAK,MAAM,IAAI,IAAI,OAAO,EAAE,CAAC;QAC3B,IAAI,IAAI,CAAC,MAAM,KAAK,WAAW,EAAE,CAAC;YAChC,cAAc,CAAC,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QAClC,CAAC;IACH,CAAC;IAED,OAAO,cAAc,CAAC;AACxB,CAAC"}

package/dist/src/tools/ast-edit.d.ts

@@ -0,0 +1,43 @@
+/**
+ * @license
+ * Copyright 2025 Vybestack LLC
+ * SPDX-License-Identifier: Apache-2.0
+ *
+ * ## Change Log
+ * - 2025-01-19: Performance Optimization (Phase 2)
+ *   - Disabled eager symbol indexing by default (ENABLE_SYMBOL_INDEXING = false).
+ *   - Implemented 'Lazy' on-demand `findInFiles` queries with strict limits.
+ *   - Added `prioritizeSymbolsFromDeclarations` for smarter symbol selection.
+ *   - Added timeout mechanism and `Promise.allSettled` for fault tolerance.
+ *   - Added performance metrics logging (duration, memory delta).
+ *   - Added env-based override: LLXPRT_ENABLE_SYMBOL_INDEXING.
+ *   - Added MAX_WORKSPACE_FILES guard to prevent OOM in large repos.
+ */
+import type { ToolInvocation } from './tools.js';
+import { BaseDeclarativeTool, type ToolResult } from './tools.js';
+import type { IToolHost, ILspService } from '../interfaces/index.js';
+import type { ModifiableDeclarativeTool, ModifyContext } from './modifiable-tool.js';
+import type { EnhancedDeclaration, ASTEditToolParams, ASTReadFileToolParams } from './ast-edit/types.js';
+import { KEYWORDS, COMMENT_PREFIXES, REGEX, LANGUAGE_MAP, JAVASCRIPT_FAMILY_EXTENSIONS } from './ast-edit/constants.js';
+import { applyReplacement } from './ast-edit/edit-helpers.js';
+export type { EnhancedDeclaration, ASTEditToolParams, ASTReadFileToolParams };
+export { KEYWORDS, COMMENT_PREFIXES, REGEX, LANGUAGE_MAP, JAVASCRIPT_FAMILY_EXTENSIONS, };
+export declare class ASTEditTool extends BaseDeclarativeTool<ASTEditToolParams, ToolResult> implements ModifiableDeclarativeTool<ASTEditToolParams> {
+    private readonly host;
+    private readonly lspService?;
+    static readonly Name = "ast_edit";
+    private contextCollector;
+    static applyReplacement: typeof applyReplacement;
+    constructor(host: IToolHost, lspService?: ILspService | undefined);
+    protected validateToolParamValues(params: ASTEditToolParams): string | null;
+    protected createInvocation(params: ASTEditToolParams): ToolInvocation<ASTEditToolParams, ToolResult>;
+    getModifyContext(_: AbortSignal): ModifyContext<ASTEditToolParams>;
+}
+export declare class ASTReadFileTool extends BaseDeclarativeTool<ASTReadFileToolParams, ToolResult> {
+    private readonly host;
+    static readonly Name = "ast_read_file";
+    private contextCollector;
+    constructor(host: IToolHost);
+    protected validateToolParamValues(params: ASTReadFileToolParams): string | null;
+    protected createInvocation(params: ASTReadFileToolParams): ToolInvocation<ASTReadFileToolParams, ToolResult>;
+}

package/dist/src/tools/ast-edit.js

@@ -0,0 +1,183 @@
+/**
+ * @license
+ * Copyright 2025 Vybestack LLC
+ * SPDX-License-Identifier: Apache-2.0
+ *
+ * ## Change Log
+ * - 2025-01-19: Performance Optimization (Phase 2)
+ *   - Disabled eager symbol indexing by default (ENABLE_SYMBOL_INDEXING = false).
+ *   - Implemented 'Lazy' on-demand `findInFiles` queries with strict limits.
+ *   - Added `prioritizeSymbolsFromDeclarations` for smarter symbol selection.
+ *   - Added timeout mechanism and `Promise.allSettled` for fault tolerance.
+ *   - Added performance metrics logging (duration, memory delta).
+ *   - Added env-based override: LLXPRT_ENABLE_SYMBOL_INDEXING.
+ *   - Added MAX_WORKSPACE_FILES guard to prevent OOM in large repos.
+ */
+import * as path from 'path';
+import fs from 'fs';
+import { BaseDeclarativeTool, Kind } from './tools.js';
+import { isNodeError } from '../utils/errors.js';
+import { KEYWORDS, COMMENT_PREFIXES, REGEX, LANGUAGE_MAP, JAVASCRIPT_FAMILY_EXTENSIONS, } from './ast-edit/constants.js';
+import { ASTContextCollector } from './ast-edit/context-collector.js';
+import { applyReplacement } from './ast-edit/edit-helpers.js';
+import { ASTEditToolInvocation } from './ast-edit/ast-edit-invocation.js';
+import { ASTReadFileToolInvocation } from './ast-edit/ast-read-file-invocation.js';
+import { validatePathWithinWorkspace } from '../utils/pathValidation.js';
+export { KEYWORDS, COMMENT_PREFIXES, REGEX, LANGUAGE_MAP, JAVASCRIPT_FAMILY_EXTENSIONS, };
+/**
+ * Shared validation logic for file path parameters.
+ * Used by both ASTEditTool and ASTReadFileTool.
+ */
+function validateFilePathParam(host, params) {
+    if (!params.file_path) {
+        return "The 'file_path' parameter must be non-empty.";
+    }
+    if (!path.isAbsolute(params.file_path)) {
+        return `File path must be absolute: ${params.file_path}`;
+    }
+    const pathError = validatePathWithinWorkspace(typeof host.getWorkspaceRoots === 'function'
+        ? host.getWorkspaceRoots()
+        : (host
+            .getWorkspaceContext?.()
+            .getDirectories?.() ?? [host.getTargetDir()]), params.file_path);
+    if (pathError) {
+        return pathError;
+    }
+    return null;
+}
+// ===== ASTEdit Tool Implementation =====
+export class ASTEditTool extends BaseDeclarativeTool {
+    host;
+    lspService;
+    static Name = 'ast_edit';
+    contextCollector;
+    static applyReplacement = applyReplacement;
+    constructor(host, lspService) {
+        super(ASTEditTool.Name, 'ASTEdit', `Enhanced edit tool with intelligent context awareness. Performs precise text replacement with validation.
+
+      Replaces exact text matches in files with comprehensive analysis:
+      - AST syntax validation and structure analysis
+      - Context-aware suggestions and related code
+      - File freshness and safety checks
+      - Preview before applying changes
+
+      **Parameters:**
+      - file_path: Absolute path to the file to modify
+      - old_string: Text to replace (must match exactly)
+      - new_string: Replacement text`, Kind.Edit, {
+            properties: {
+                file_path: {
+                    description: "The absolute path to the file to modify. Must start with '/'.",
+                    type: 'string',
+                },
+                old_string: {
+                    description: 'The exact literal text to replace. Must match existing content exactly including whitespace and indentation.',
+                    type: 'string',
+                },
+                new_string: {
+                    description: 'The exact literal text to replace old_string with. Provide the complete replacement text.',
+                    type: 'string',
+                },
+                force: {
+                    type: 'boolean',
+                    description: 'Internal execution control. Managed automatically.',
+                    default: false,
+                },
+                last_modified: {
+                    type: 'number',
+                    description: 'Timestamp of the file when last read. Used for concurrency control.',
+                },
+            },
+            required: ['file_path', 'old_string', 'new_string'],
+            type: 'object',
+        });
+        this.host = host;
+        this.lspService = lspService;
+        this.contextCollector = new ASTContextCollector();
+    }
+    validateToolParamValues(params) {
+        return validateFilePathParam(this.host, params);
+    }
+    createInvocation(params) {
+        return new ASTEditToolInvocation(this.host, params, this.contextCollector, this.lspService);
+    }
+    getModifyContext(_) {
+        return {
+            getFilePath: (params) => params.file_path,
+            getCurrentContent: async (params) => {
+                try {
+                    return await fs.promises.readFile(params.file_path, 'utf-8');
+                }
+                catch (err) {
+                    if (!isNodeError(err) || err.code !== 'ENOENT')
+                        throw err;
+                    return '';
+                }
+            },
+            getProposedContent: async (params) => {
+                try {
+                    const currentContent = await fs.promises.readFile(params.file_path, 'utf-8');
+                    return ASTEditTool.applyReplacement(currentContent, params.old_string, params.new_string, false);
+                }
+                catch (err) {
+                    if (!isNodeError(err) || err.code !== 'ENOENT')
+                        throw err;
+                    return params.new_string;
+                }
+            },
+            createUpdatedParams: (oldContent, modifiedProposedContent, originalParams) => ({
+                ...originalParams,
+                old_string: oldContent,
+                new_string: modifiedProposedContent,
+            }),
+        };
+    }
+}
+// ===== ASTReadFile Tool Implementation =====
+export class ASTReadFileTool extends BaseDeclarativeTool {
+    host;
+    static Name = 'ast_read_file';
+    contextCollector;
+    constructor(host) {
+        super(ASTReadFileTool.Name, 'ASTReadFile', `Enhanced file reading with AST-inspired context analysis. Reads file content with intelligent context extraction.
+
+      **Context-Aware Features:**
+      - Language detection and AST structure analysis
+      - Function/class/variable declaration extraction  
+      - Relevant code snippet collection
+      - Language-specific context information
+
+      **Parameters:**
+      - file_path: Absolute path to the file to read
+      - offset: Line number to start reading from (optional)
+      - limit: Number of lines to read (optional)`, Kind.Read, {
+            properties: {
+                file_path: {
+                    description: "The absolute path to the file to read. Must start with '/'.",
+                    type: 'string',
+                },
+                offset: {
+                    type: 'number',
+                    description: 'The line number to start reading from (1-based, optional).',
+                    minimum: 1,
+                },
+                limit: {
+                    type: 'number',
+                    description: 'The number of lines to read (optional).',
+                    minimum: 1,
+                },
+            },
+            required: ['file_path'],
+            type: 'object',
+        });
+        this.host = host;
+        this.contextCollector = new ASTContextCollector();
+    }
+    validateToolParamValues(params) {
+        return validateFilePathParam(this.host, params);
+    }
+    createInvocation(params) {
+        return new ASTReadFileToolInvocation(this.host, params, this.contextCollector);
+    }
+}
+//# sourceMappingURL=ast-edit.js.map

package/dist/src/tools/ast-edit.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ast-edit.js","sourceRoot":"","sources":["../../../src/tools/ast-edit.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,OAAO,KAAK,IAAI,MAAM,MAAM,CAAC;AAC7B,OAAO,EAAE,MAAM,IAAI,CAAC;AAEpB,OAAO,EAAE,mBAAmB,EAAE,IAAI,EAAmB,MAAM,YAAY,CAAC;AACxE,OAAO,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AAcjD,OAAO,EACL,QAAQ,EACR,gBAAgB,EAChB,KAAK,EACL,YAAY,EACZ,4BAA4B,GAC7B,MAAM,yBAAyB,CAAC;AAEjC,OAAO,EAAE,mBAAmB,EAAE,MAAM,iCAAiC,CAAC;AACtE,OAAO,EAAE,gBAAgB,EAAE,MAAM,4BAA4B,CAAC;AAC9D,OAAO,EAAE,qBAAqB,EAAE,MAAM,mCAAmC,CAAC;AAC1E,OAAO,EAAE,yBAAyB,EAAE,MAAM,wCAAwC,CAAC;AACnF,OAAO,EAAE,2BAA2B,EAAE,MAAM,4BAA4B,CAAC;AAIzE,OAAO,EACL,QAAQ,EACR,gBAAgB,EAChB,KAAK,EACL,YAAY,EACZ,4BAA4B,GAC7B,CAAC;AAEF;;;GAGG;AACH,SAAS,qBAAqB,CAC5B,IAAe,EACf,MAA6B;IAE7B,IAAI,CAAC,MAAM,CAAC,SAAS,EAAE,CAAC;QACtB,OAAO,8CAA8C,CAAC;IACxD,CAAC;IAED,IAAI,CAAC,IAAI,CAAC,UAAU,CAAC,MAAM,CAAC,SAAS,CAAC,EAAE,CAAC;QACvC,OAAO,+BAA+B,MAAM,CAAC,SAAS,EAAE,CAAC;IAC3D,CAAC;IAED,MAAM,SAAS,GAAG,2BAA2B,CAC3C,OAAO,IAAI,CAAC,iBAAiB,KAAK,UAAU;QAC1C,CAAC,CAAC,IAAI,CAAC,iBAAiB,EAAE;QAC1B,CAAC,CAAC,CACE,IAGD;aACE,mBAAmB,EAAE,EAAE;aACvB,cAAc,EAAE,EAAE,IAAI,CAAC,IAAI,CAAC,YAAY,EAAE,CAAC,CAAC,EACnD,MAAM,CAAC,SAAS,CACjB,CAAC;IACF,IAAI,SAAS,EAAE,CAAC;QACd,OAAO,SAAS,CAAC;IACnB,CAAC;IAED,OAAO,IAAI,CAAC;AACd,CAAC;AAED,0CAA0C;AAC1C,MAAM,OAAO,WACX,SAAQ,mBAAkD;IASvC;IACA;IAPnB,MAAM,CAAU,IAAI,GAAG,UAAU,CAAC;IAC1B,gBAAgB,CAAsB;IAE9C,MAAM,CAAC,gBAAgB,GAAG,gBAAgB,CAAC;IAE3C,YACmB,IAAe,EACf,UAAwB;QAEzC,KAAK,CACH,WAAW,CAAC,IAAI,EAChB,SAAS,EACT;;;;;;;;;;;qCAW+B,EAC/B,IAAI,CAAC,IAAI,EACT;YACE,UAAU,EAAE;gBACV,SAAS,EAAE;oBACT,WAAW,EACT,+DAA+D;oBACjE,IAAI,EAAE,QAAQ;iBACf;gBACD,UAAU,EAAE;oBACV,WAAW,EACT,8GAA8G;oBAChH,IAAI,EAAE,QAAQ;iBACf;gBACD,UAAU,EAAE;oBACV,WAAW,EACT,2FAA2F;oBAC7F,IAAI,EAAE,QAAQ;iBACf;gBACD,KAAK,EAAE;oBACL,IAAI,EAAE,SAAS;oBACf,WAAW,EAAE,oDAAoD;oBACjE,OAAO,EAAE,KAAK;iBACf;gBACD,aAAa,EAAE;oBACb,IAAI,EAAE,QAAQ;oBACd,WAAW,EACT,qEAAqE;iBACxE;aACF;YACD,QAAQ,EAAE,CAAC,WAAW,EAAE,YAAY,EAAE,YAAY,CAAC;YACnD,IAAI,EAAE,QAAQ;SACf,CACF,CAAC;QAlDe,SAAI,GAAJ,IAAI,CAAW;QACf,eAAU,GAAV,UAAU,CAAc;QAmDzC,IAAI,CAAC,gBAAgB,GAAG,IAAI,mBAAmB,EAAE,CAAC;IACpD,CAAC;IAEkB,uBAAuB,CACxC,MAAyB;QAEzB,OAAO,qBAAqB,CAAC,IAAI,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;IAClD,CAAC;IAES,gBAAgB,CACxB,MAAyB;QAEzB,OAAO,IAAI,qBAAqB,CAC9B,IAAI,CAAC,IAAI,EACT,MAAM,EACN,IAAI,CAAC,gBAAgB,EACrB,IAAI,CAAC,UAAU,CAChB,CAAC;IACJ,CAAC;IAED,gBAAgB,CAAC,CAAc;QAC7B,OAAO;YACL,WAAW,EAAE,CAAC,MAAyB,EAAE,EAAE,CAAC,MAAM,CAAC,SAAS;YAC5D,iBAAiB,EAAE,KAAK,EAAE,MAAyB,EAAmB,EAAE;gBACtE,IAAI,CAAC;oBACH,OAAO,MAAM,EAAE,CAAC,QAAQ,CAAC,QAAQ,CAAC,MAAM,CAAC,SAAS,EAAE,OAAO,CAAC,CAAC;gBAC/D,CAAC;gBAAC,OAAO,GAAG,EAAE,CAAC;oBACb,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC,IAAI,GAAG,CAAC,IAAI,KAAK,QAAQ;wBAAE,MAAM,GAAG,CAAC;oBAC1D,OAAO,EAAE,CAAC;gBACZ,CAAC;YACH,CAAC;YACD,kBAAkB,EAAE,KAAK,EACvB,MAAyB,EACR,EAAE;gBACnB,IAAI,CAAC;oBACH,MAAM,cAAc,GAAG,MAAM,EAAE,CAAC,QAAQ,CAAC,QAAQ,CAC/C,MAAM,CAAC,SAAS,EAChB,OAAO,CACR,CAAC;oBACF,OAAO,WAAW,CAAC,gBAAgB,CACjC,cAAc,EACd,MAAM,CAAC,UAAU,EACjB,MAAM,CAAC,UAAU,EACjB,KAAK,CACN,CAAC;gBACJ,CAAC;gBAAC,OAAO,GAAG,EAAE,CAAC;oBACb,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC,IAAI,GAAG,CAAC,IAAI,KAAK,QAAQ;wBAAE,MAAM,GAAG,CAAC;oBAC1D,OAAO,MAAM,CAAC,UAAU,CAAC;gBAC3B,CAAC;YACH,CAAC;YACD,mBAAmB,EAAE,CACnB,UAAkB,EAClB,uBAA+B,EAC/B,cAAiC,EACd,EAAE,CAAC,CAAC;gBACvB,GAAG,cAAc;gBACjB,UAAU,EAAE,UAAU;gBACtB,UAAU,EAAE,uBAAuB;aACpC,CAAC;SACH,CAAC;IACJ,CAAC;;AAGH,8CAA8C;AAC9C,MAAM,OAAO,eAAgB,SAAQ,mBAGpC;IAI8B;IAH7B,MAAM,CAAU,IAAI,GAAG,eAAe,CAAC;IAC/B,gBAAgB,CAAsB;IAE9C,YAA6B,IAAe;QAC1C,KAAK,CACH,eAAe,CAAC,IAAI,EACpB,aAAa,EACb;;;;;;;;;;;kDAW4C,EAC5C,IAAI,CAAC,IAAI,EACT;YACE,UAAU,EAAE;gBACV,SAAS,EAAE;oBACT,WAAW,EACT,6DAA6D;oBAC/D,IAAI,EAAE,QAAQ;iBACf;gBACD,MAAM,EAAE;oBACN,IAAI,EAAE,QAAQ;oBACd,WAAW,EACT,4DAA4D;oBAC9D,OAAO,EAAE,CAAC;iBACX;gBACD,KAAK,EAAE;oBACL,IAAI,EAAE,QAAQ;oBACd,WAAW,EAAE,yCAAyC;oBACtD,OAAO,EAAE,CAAC;iBACX;aACF;YACD,QAAQ,EAAE,CAAC,WAAW,CAAC;YACvB,IAAI,EAAE,QAAQ;SACf,CACF,CAAC;QAvCyB,SAAI,GAAJ,IAAI,CAAW;QAyC1C,IAAI,CAAC,gBAAgB,GAAG,IAAI,mBAAmB,EAAE,CAAC;IACpD,CAAC;IAEkB,uBAAuB,CACxC,MAA6B;QAE7B,OAAO,qBAAqB,CAAC,IAAI,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;IAClD,CAAC;IAES,gBAAgB,CACxB,MAA6B;QAE7B,OAAO,IAAI,yBAAyB,CAClC,IAAI,CAAC,IAAI,EACT,MAAM,EACN,IAAI,CAAC,gBAAgB,CACtB,CAAC;IACJ,CAAC"}

package/dist/src/tools/ast-grep.d.ts

@@ -0,0 +1,22 @@
+/**
+ * AST-aware structural code search tool using @ast-grep/napi.
+ * Finds code patterns by AST structure rather than text matching.
+ *
+ * @plan PLAN-20260211-ASTGREP.P05
+ */
+import { BaseDeclarativeTool, type ToolInvocation, type ToolResult } from './tools.js';
+import type { IToolHost, IToolMessageBus } from '../interfaces/index.js';
+export interface AstGrepToolParams {
+    pattern?: string;
+    rule?: Record<string, unknown>;
+    language?: string;
+    path?: string;
+    globs?: string[];
+    maxResults?: number;
+}
+export declare class AstGrepTool extends BaseDeclarativeTool<AstGrepToolParams, ToolResult> {
+    private readonly host;
+    static readonly Name = "ast_grep";
+    constructor(host: IToolHost, _messageBus?: IToolMessageBus);
+    protected createInvocation(params: AstGrepToolParams, messageBus: IToolMessageBus): ToolInvocation<AstGrepToolParams, ToolResult>;
+}

package/dist/src/tools/ast-grep.js

@@ -0,0 +1,291 @@
+/**
+ * AST-aware structural code search tool using @ast-grep/napi.
+ * Finds code patterns by AST structure rather than text matching.
+ *
+ * @plan PLAN-20260211-ASTGREP.P05
+ */
+/* eslint-disable complexity, sonarjs/cognitive-complexity, max-lines -- Phase 5: legacy core boundary retained while larger decomposition continues. */
+import * as path from 'node:path';
+import { promises as fs, statSync, existsSync } from 'node:fs';
+import FastGlob from 'fast-glob';
+import { BaseDeclarativeTool, BaseToolInvocation, Kind, } from './tools.js';
+import { makeRelative } from '../utils/paths.js';
+import { parse, getAstLanguage, resolveLanguageFromPath, LANGUAGE_MAP, } from '../utils/ast-grep-utils.js';
+const DEFAULT_MAX_RESULTS = 100;
+class AstGrepToolInvocation extends BaseToolInvocation {
+    host;
+    constructor(host, params, messageBus) {
+        super(params, messageBus);
+        this.host = host;
+    }
+    getDescription() {
+        const { pattern, rule } = this.params;
+        if (pattern)
+            return `AST pattern: '${pattern}'`;
+        if (rule)
+            return `AST rule query`;
+        return 'AST search';
+    }
+    makeError(message) {
+        return { llmContent: message, returnDisplay: message };
+    }
+    async execute(signal) {
+        const { pattern, rule, globs, maxResults } = this.params;
+        const limit = maxResults ?? DEFAULT_MAX_RESULTS;
+        const resolved = this.validateAndResolveParams();
+        if (resolved instanceof Object && 'llmContent' in resolved)
+            return resolved;
+        const { searchPath, isSingleFile, resolvedLang } = resolved;
+        try {
+            const { allMatches, skippedFiles } = await this.collectMatches(searchPath, isSingleFile, resolvedLang, pattern, rule, globs, signal);
+            return this.formatSearchResults(allMatches, skippedFiles, limit, pattern);
+        }
+        catch (err) {
+            const msg = err instanceof Error ? err.message : String(err);
+            return this.makeError(`Error searching: ${msg}`);
+        }
+    }
+    validateAndResolveParams() {
+        const { pattern, rule, language } = this.params;
+        // REQ-ASTGREP-004: exactly one of pattern or rule
+        if ((pattern && rule) || (!pattern && !rule)) {
+            return this.makeError('Error: Provide exactly one of `pattern` or `rule`, not both and not neither.');
+        }
+        const targetDir = this.host.getTargetDir();
+        let searchPath = this.params.path ?? targetDir;
+        if (!path.isAbsolute(searchPath)) {
+            searchPath = path.resolve(targetDir, searchPath);
+        }
+        // REQ-ASTGREP-006: workspace boundary
+        const normalizedTarget = targetDir.endsWith(path.sep)
+            ? targetDir
+            : targetDir + path.sep;
+        if (searchPath !== targetDir && !searchPath.startsWith(normalizedTarget)) {
+            return this.makeError(`Error: Path "${this.params.path}" resolves outside the workspace root.`);
+        }
+        let isSingleFile = false;
+        try {
+            const stats = statSync(searchPath);
+            isSingleFile = stats.isFile();
+        }
+        catch {
+            if (!existsSync(searchPath)) {
+                return this.makeError(`Error: Path does not exist: ${searchPath}`);
+            }
+        }
+        // REQ-ASTGREP-013: language detection
+        let resolvedLang;
+        if (language) {
+            resolvedLang = getAstLanguage(language);
+            if (!resolvedLang) {
+                return this.makeError(`Error: Unrecognized language "${language}". Supported: ${Object.keys(LANGUAGE_MAP).join(', ')}`);
+            }
+        }
+        else if (isSingleFile) {
+            resolvedLang = resolveLanguageFromPath(searchPath);
+            if (!resolvedLang) {
+                return this.makeError('Error: Could not detect language from file extension. Please provide a `language` parameter.');
+            }
+        }
+        else {
+            return this.makeError('Error: `language` parameter is required when searching a directory.');
+        }
+        return { searchPath, isSingleFile, resolvedLang };
+    }
+    async collectMatches(searchPath, isSingleFile, resolvedLang, pattern, rule, globs, signal) {
+        const targetDir = this.host.getTargetDir();
+        const allMatches = [];
+        let skippedFiles = 0;
+        if (isSingleFile) {
+            const content = await fs.readFile(searchPath, 'utf-8');
+            allMatches.push(...this.searchContent(content, resolvedLang, searchPath, targetDir, pattern, rule));
+        }
+        else {
+            const extensions = this.getExtensionsForLanguage(resolvedLang);
+            let files = await FastGlob(extensions.map((ext) => `**/*.${ext}`), {
+                cwd: searchPath,
+                absolute: true,
+                dot: false,
+                ignore: ['**/node_modules/**', '**/.git/**'],
+            });
+            files = await this.applyGlobFilters(files, globs, searchPath);
+            for (const file of files) {
+                // eslint-disable-next-line sonarjs/nested-control-flow -- Existing structure is intentionally preserved; refactoring this boundary is outside the lint slice.
+                if (signal?.aborted === true)
+                    break;
+                // eslint-disable-next-line sonarjs/nested-control-flow -- Existing structure is intentionally preserved; refactoring this boundary is outside the lint slice.
+                try {
+                    const content = await fs.readFile(file, 'utf-8');
+                    allMatches.push(...this.searchContent(content, resolvedLang, file, targetDir, pattern, rule));
+                }
+                catch {
+                    skippedFiles++;
+                }
+            }
+        }
+        return { allMatches, skippedFiles };
+    }
+    async applyGlobFilters(files, globs, searchPath) {
+        if (!globs || globs.length === 0)
+            return files;
+        const includePatterns = globs.filter((g) => !g.startsWith('!'));
+        const excludePatterns = globs
+            .filter((g) => g.startsWith('!'))
+            .map((g) => g.slice(1));
+        // eslint-disable-next-line sonarjs/nested-control-flow -- Existing structure is intentionally preserved; refactoring this boundary is outside the lint slice.
+        if (includePatterns.length > 0) {
+            const includeSet = new Set(await FastGlob(includePatterns, { cwd: searchPath, absolute: true }));
+            files = files.filter((f) => includeSet.has(f));
+        }
+        // eslint-disable-next-line sonarjs/nested-control-flow -- Existing structure is intentionally preserved; refactoring this boundary is outside the lint slice.
+        if (excludePatterns.length > 0) {
+            const excludeSet = new Set(await FastGlob(excludePatterns, { cwd: searchPath, absolute: true }));
+            files = files.filter((f) => !excludeSet.has(f));
+        }
+        return files;
+    }
+    formatSearchResults(allMatches, skippedFiles, limit, pattern) {
+        const truncated = allMatches.length > limit;
+        const result = {
+            matches: allMatches.slice(0, limit),
+            truncated,
+            skippedFiles: skippedFiles > 0 ? skippedFiles : undefined,
+        };
+        if (truncated) {
+            result.totalMatches = allMatches.length;
+        }
+        const matchCount = result.matches.length;
+        const searchDesc = pattern ? `pattern "${pattern}"` : 'rule query';
+        let llmContent = `Found ${matchCount} AST match${matchCount !== 1 ? 'es' : ''} for ${searchDesc}`;
+        if (truncated) {
+            llmContent += ` (showing ${matchCount} of ${result.totalMatches})`;
+        }
+        llmContent += ':\n---\n';
+        for (const m of result.matches) {
+            llmContent += `${m.file}:${m.startLine} [${m.nodeKind}] ${m.text}\n`;
+            if (Object.keys(m.metaVariables).length > 0) {
+                // eslint-disable-next-line sonarjs/nested-control-flow -- Existing structure is intentionally preserved; refactoring this boundary is outside the lint slice.
+                for (const [k, v] of Object.entries(m.metaVariables)) {
+                    llmContent += `  $${k} = ${v}\n`;
+                }
+            }
+        }
+        const displayMessage = `Found ${matchCount} AST match${matchCount !== 1 ? 'es' : ''}${truncated ? ' (truncated)' : ''}`;
+        return {
+            llmContent: llmContent.trim(),
+            returnDisplay: displayMessage,
+            metadata: result,
+        };
+    }
+    searchContent(content, language, filePath, workspaceRoot, pattern, rule) {
+        const root = parse(language, content);
+        const sgRoot = root.root();
+        const relativePath = makeRelative(filePath, workspaceRoot);
+        let nodes;
+        if (pattern) {
+            nodes = sgRoot.findAll(pattern);
+        }
+        else if (rule) {
+            nodes = sgRoot.findAll({ rule });
+        }
+        else {
+            return [];
+        }
+        return nodes.map((node) => {
+            const range = node.range();
+            const metaVariables = {};
+            // Extract single metavariables ($NAME patterns, excluding $$$ multi-vars)
+            if (pattern) {
+                const metaVarNames = 
+                // eslint-disable-next-line @typescript-eslint/prefer-nullish-coalescing -- intentional falsy coalescing: array default for regex match
+                pattern.match(/(?<!\$)\$(?!\$)([A-Z_][A-Z0-9_]*)/g) || [];
+                for (const raw of metaVarNames) {
+                    const name = raw.slice(1); // remove $
+                    const match = node.getMatch(name);
+                    if (match) {
+                        metaVariables[name] = match.text();
+                    }
+                }
+                // Extract multi metavariables ($$$NAME patterns)
+                // eslint-disable-next-line @typescript-eslint/prefer-nullish-coalescing -- intentional falsy coalescing: array default for regex match
+                const multiVarNames = pattern.match(/\$\$\$([A-Z_][A-Z0-9_]*)/g) || [];
+                for (const raw of multiVarNames) {
+                    const name = raw.slice(3); // remove $$$
+                    const matches = node.getMultipleMatches(name);
+                    if (matches.length > 0) {
+                        metaVariables[name] = matches
+                            .map((m) => m.text())
+                            .join(', ');
+                    }
+                }
+            }
+            return {
+                file: relativePath,
+                startLine: range.start.line + 1,
+                startCol: range.start.column,
+                endLine: range.end.line + 1,
+                endCol: range.end.column,
+                text: node.text(),
+                nodeKind: String(node.kind()),
+                metaVariables,
+            };
+        });
+    }
+    getExtensionsForLanguage(lang) {
+        const extensions = [];
+        for (const [ext, mappedLang] of Object.entries(LANGUAGE_MAP)) {
+            if (mappedLang === lang) {
+                extensions.push(ext);
+            }
+        }
+        return extensions.length > 0 ? extensions : ['*'];
+    }
+}
+export class AstGrepTool extends BaseDeclarativeTool {
+    host;
+    static Name = 'ast_grep';
+    constructor(host, _messageBus) {
+        super(AstGrepTool.Name, 'AstGrep', 'Searches for code patterns using AST (Abstract Syntax Tree) structural matching, not text matching. ' +
+            'Use this for finding specific code structures: method calls, class declarations, import patterns, try/catch blocks, etc. ' +
+            'Supports metavariable capture ($VAR for single node, $$$VAR for multiple). ' +
+            'Unlike search_file_content (ripgrep), this tool understands code structure and ignores comments/strings.', Kind.Search, {
+            properties: {
+                pattern: {
+                    description: 'AST pattern to search for. Use $VAR for single-node metavariables, $$$VAR for multi-node. ' +
+                        'Examples: "$OBJ.foo()", "class $NAME extends $PARENT { $$$BODY }", "try { $$$T } catch ($E) { $$$C }"',
+                    type: 'string',
+                },
+                rule: {
+                    description: 'YAML rule object for complex queries. Fields: kind, has, inside, stopBy, regex. ' +
+                        'Use when pattern syntax is insufficient (e.g., matching by AST node kind).',
+                    type: 'object',
+                },
+                language: {
+                    description: 'Programming language: typescript, javascript, python, ruby, go, rust, java, cpp, c, html, css, json. ' +
+                        'Required for directory searches. Auto-detected for single files.',
+                    type: 'string',
+                },
+                path: {
+                    description: 'File or directory to search. Defaults to workspace root.',
+                    type: 'string',
+                },
+                globs: {
+                    description: 'Glob patterns to include/exclude files. Prefix with ! to exclude. Example: ["*.ts", "!*.test.ts"]',
+                    type: 'array',
+                    items: { type: 'string' },
+                },
+                maxResults: {
+                    description: 'Maximum matches to return. Default 100.',
+                    type: 'number',
+                },
+            },
+            required: [],
+            type: 'object',
+        });
+        this.host = host;
+    }
+    createInvocation(params, messageBus) {
+        return new AstGrepToolInvocation(this.host, params, messageBus);
+    }
+}
+//# sourceMappingURL=ast-grep.js.map

package/dist/src/tools/ast-grep.js.map

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

package/dist/src/tools/check-async-tasks.d.ts

@@ -0,0 +1,46 @@
+/**
+ * @license
+ * Copyright 2025 Vybestack LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+/**
+ * @plan PLAN-20260130-ASYNCTASK.P12
+ * @plan PLAN-20260130-ASYNCTASK.P14
+ * @requirement REQ-ASYNC-005
+ */
+import { BaseDeclarativeTool, BaseToolInvocation, type ToolResult } from './tools.js';
+import type { IToolMessageBus } from '../interfaces/IToolMessageBus.js';
+import type { IAsyncTaskService } from '../interfaces/index.js';
+export interface CheckAsyncTasksParams {
+    task_id?: string;
+}
+export interface CheckAsyncTasksToolDependencies {
+    getAsyncTaskService?: () => IAsyncTaskService | undefined;
+}
+declare class CheckAsyncTasksInvocation extends BaseToolInvocation<CheckAsyncTasksParams, ToolResult> {
+    private readonly taskService;
+    constructor(params: CheckAsyncTasksParams, taskService: IAsyncTaskService, messageBus: IToolMessageBus);
+    getDescription(): string;
+    execute(): Promise<ToolResult>;
+    private executeList;
+    private executePeek;
+    private formatTaskDetails;
+    private formatDuration;
+    private formatTaskDisplay;
+    private statusIcon;
+}
+/**
+ * Tool that allows querying the status of async tasks.
+ * Two modes:
+ * - List mode (no task_id): Shows summary of all tasks
+ * - Peek mode (with task_id): Shows detailed info for specific task
+ */
+export declare class CheckAsyncTasksTool extends BaseDeclarativeTool<CheckAsyncTasksParams, ToolResult> {
+    private readonly dependencies;
+    static readonly Name = "check_async_tasks";
+    constructor(dependencies: CheckAsyncTasksToolDependencies | IAsyncTaskService);
+    protected createInvocation(params: CheckAsyncTasksParams, messageBus: IToolMessageBus): CheckAsyncTasksInvocation;
+    execute(params: CheckAsyncTasksParams): Promise<ToolResult>;
+    protected validateToolParamValues(): string | null;
+}
+export {};