@copilotkit/pathfinder 1.1.0

package/dist/mcp/tools/bash-fs.js

@@ -0,0 +1,134 @@
+import fs from 'node:fs';
+import path from 'node:path';
+import { Bash } from 'just-bash';
+import { matchesPatterns } from '../../indexing/source-indexer.js';
+import { generateIndexMd, generateSearchTipsMd } from './bash-virtual-files.js';
+const DEFAULT_SKIP_DIRS = new Set(['node_modules', 'dist', 'build', '.git']);
+const DEFAULT_MAX_FILE_SIZE = 102400; // 100KB
+async function walkFiles(dir, skipDirs, maxFileSize) {
+    const results = [];
+    let entries;
+    try {
+        entries = await fs.promises.readdir(dir, { withFileTypes: true });
+    }
+    catch (err) {
+        console.warn(`[bash-fs] Failed to read directory ${dir}:`, err);
+        return results;
+    }
+    for (const entry of entries) {
+        if (skipDirs.has(entry.name))
+            continue;
+        const fullPath = path.join(dir, entry.name);
+        if (entry.isDirectory()) {
+            results.push(...await walkFiles(fullPath, skipDirs, maxFileSize));
+        }
+        else if (entry.isFile()) {
+            try {
+                const stat = await fs.promises.stat(fullPath);
+                if (stat.size <= maxFileSize)
+                    results.push(fullPath);
+            }
+            catch (err) {
+                console.warn(`[bash-fs] Failed to stat ${fullPath}:`, err);
+                continue;
+            }
+        }
+    }
+    return results;
+}
+export async function buildBashFilesMap(sources, options) {
+    const files = {};
+    const multiSource = sources.length > 1;
+    for (const source of sources) {
+        let rootDir;
+        if (source.repo && options?.cloneDir) {
+            // Git-based source: the orchestrator clones into cloneDir/<repoName>/
+            const repoName = source.repo.replace(/\.git$/, '').split('/').pop();
+            rootDir = path.join(options.cloneDir, repoName, source.path);
+        }
+        else {
+            rootDir = path.resolve(source.path);
+        }
+        if (!fs.existsSync(rootDir)) {
+            console.warn(`[bash-fs] Source "${source.name}" path does not exist: ${rootDir}`);
+            continue;
+        }
+        const skipDirs = new Set([...DEFAULT_SKIP_DIRS, ...(source.skip_dirs ?? [])]);
+        const maxFileSize = source.max_file_size ?? DEFAULT_MAX_FILE_SIZE;
+        const allFiles = await walkFiles(rootDir, skipDirs, maxFileSize);
+        for (const absPath of allFiles) {
+            const relPath = path.relative(rootDir, absPath);
+            if (!matchesPatterns(relPath, source))
+                continue;
+            let content;
+            try {
+                content = await fs.promises.readFile(absPath, 'utf-8');
+            }
+            catch (err) {
+                console.warn(`[bash-fs] Failed to read ${absPath}, skipping:`, err);
+                continue;
+            }
+            const virtualPath = multiSource
+                ? `/${source.name}/${relPath}`
+                : `/${relPath}`;
+            files[virtualPath] = content;
+        }
+    }
+    if (options?.virtualFiles) {
+        files['/INDEX.md'] = generateIndexMd(files);
+        files['/SEARCH_TIPS.md'] = generateSearchTipsMd(options.searchToolNames ?? []);
+    }
+    return files;
+}
+export function buildFileMetadata(files) {
+    const meta = {};
+    for (const [path, content] of Object.entries(files)) {
+        const size = Buffer.byteLength(content, 'utf-8');
+        const lines = content === '' ? 0 : content.endsWith('\n')
+            ? content.split('\n').length - 1
+            : content.split('\n').length;
+        meta[path] = { size, lines };
+    }
+    return meta;
+}
+export function formatLsLong(dir, allPaths, metadata) {
+    const normalizedDir = dir.endsWith('/') ? dir : dir + '/';
+    const files = [];
+    const subdirs = new Set();
+    for (const p of allPaths) {
+        if (!p.startsWith(normalizedDir))
+            continue;
+        const rest = p.slice(normalizedDir.length);
+        const slashIdx = rest.indexOf('/');
+        if (slashIdx === -1) {
+            files.push(p);
+        }
+        else {
+            subdirs.add(rest.slice(0, slashIdx));
+        }
+    }
+    const lines = [];
+    for (const d of [...subdirs].sort()) {
+        lines.push(`drwxr-xr-x  ${d}/`);
+    }
+    for (const f of files.sort()) {
+        const name = f.slice(normalizedDir.length);
+        const meta = metadata[f];
+        if (meta) {
+            const sizeStr = String(meta.size).padStart(8);
+            lines.push(`-rw-r--r--  ${sizeStr}  ${meta.lines} lines  ${name}`);
+        }
+        else {
+            lines.push(`-rw-r--r--  ${name}`);
+        }
+    }
+    return lines.join('\n') + '\n';
+}
+export async function rebuildBashInstance(sources, options) {
+    const filesMap = await buildBashFilesMap(sources, { ...options });
+    return {
+        bash: new Bash({ files: filesMap, cwd: '/' }),
+        fileCount: Object.keys(filesMap).length,
+    };
+}
+//# sourceMappingURL=bash-fs.js.map

package/dist/mcp/tools/bash-fs.js.map

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

package/dist/mcp/tools/bash-grep.d.ts

@@ -0,0 +1,29 @@
+import type { EmbeddingClient } from '../../indexing/embeddings.js';
+import type { ChunkResult } from '../../types.js';
+export interface ParsedGrep {
+    isGrep: boolean;
+    pattern: string;
+    flags: string[];
+    paths: string[];
+}
+export declare function parseGrepCommand(command: string): ParsedGrep;
+export interface ParsedQmd {
+    isQmd: boolean;
+    query: string;
+}
+export declare function parseQmdCommand(command: string): ParsedQmd;
+export interface VectorGrepOptions {
+    pattern: string;
+    sourceName?: string;
+    embeddingClient: EmbeddingClient;
+    searchChunksFn: (embedding: number[], limit: number, sourceName?: string) => Promise<ChunkResult[]>;
+    textSearchFn: (pattern: string, limit: number, sourceName?: string) => Promise<ChunkResult[]>;
+    limit?: number;
+}
+export interface GrepResult {
+    stdout: string;
+    stderr: string;
+    exitCode: number;
+}
+export declare function vectorGrep(options: VectorGrepOptions): Promise<GrepResult>;
+//# sourceMappingURL=bash-grep.d.ts.map

package/dist/mcp/tools/bash-grep.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"bash-grep.d.ts","sourceRoot":"","sources":["../../../src/mcp/tools/bash-grep.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,8BAA8B,CAAC;AACpE,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAElD,MAAM,WAAW,UAAU;IACvB,MAAM,EAAE,OAAO,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,MAAM,EAAE,CAAC;IAChB,KAAK,EAAE,MAAM,EAAE,CAAC;CACnB;AAKD,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,MAAM,GAAG,UAAU,CA6C5D;AAED,MAAM,WAAW,SAAS;IACtB,KAAK,EAAE,OAAO,CAAC;IACf,KAAK,EAAE,MAAM,CAAC;CACjB;AAED,wBAAgB,eAAe,CAAC,OAAO,EAAE,MAAM,GAAG,SAAS,CAoB1D;AAED,MAAM,WAAW,iBAAiB;IAC9B,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,eAAe,EAAE,eAAe,CAAC;IACjC,cAAc,EAAE,CAAC,SAAS,EAAE,MAAM,EAAE,EAAE,KAAK,EAAE,MAAM,EAAE,UAAU,CAAC,EAAE,MAAM,KAAK,OAAO,CAAC,WAAW,EAAE,CAAC,CAAC;IACpG,YAAY,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,UAAU,CAAC,EAAE,MAAM,KAAK,OAAO,CAAC,WAAW,EAAE,CAAC,CAAC;IAC9F,KAAK,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,UAAU;IACvB,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,MAAM,CAAC;CACpB;AAMD,wBAAsB,UAAU,CAAC,OAAO,EAAE,iBAAiB,GAAG,OAAO,CAAC,UAAU,CAAC,CAoDhF"}

package/dist/mcp/tools/bash-grep.js

@@ -0,0 +1,153 @@
+/** Flags that consume the next token as their argument. */
+const FLAGS_WITH_ARGS = new Set(['-e', '-m', '-f', '-A', '-B', '-C']);
+export function parseGrepCommand(command) {
+    const trimmed = command.trim();
+    if (trimmed.includes('|') || trimmed.includes(';') || trimmed.includes('&&')) {
+        return { isGrep: false, pattern: '', flags: [], paths: [] };
+    }
+    if (!trimmed.startsWith('grep ') && trimmed !== 'grep') {
+        return { isGrep: false, pattern: '', flags: [], paths: [] };
+    }
+    const tokens = [];
+    let i = 5;
+    while (i < trimmed.length) {
+        while (i < trimmed.length && trimmed[i] === ' ')
+            i++;
+        if (i >= trimmed.length)
+            break;
+        if (trimmed[i] === '"' || trimmed[i] === "'") {
+            const quote = trimmed[i];
+            i++;
+            let token = '';
+            while (i < trimmed.length && trimmed[i] !== quote) {
+                token += trimmed[i];
+                i++;
+            }
+            i++;
+            tokens.push(token);
+        }
+        else {
+            let token = '';
+            while (i < trimmed.length && trimmed[i] !== ' ') {
+                token += trimmed[i];
+                i++;
+            }
+            tokens.push(token);
+        }
+    }
+    const flags = [];
+    let pattern = '';
+    const paths = [];
+    let patternFound = false;
+    for (let t = 0; t < tokens.length; t++) {
+        const token = tokens[t];
+        if (token.startsWith('-') && !patternFound) {
+            flags.push(token);
+            // If this flag takes an argument, consume the next token too
+            if (FLAGS_WITH_ARGS.has(token) && t + 1 < tokens.length) {
+                t++;
+                flags.push(tokens[t]);
+            }
+        }
+        else if (!patternFound) {
+            pattern = token;
+            patternFound = true;
+        }
+        else {
+            paths.push(token);
+        }
+    }
+    if (!pattern)
+        return { isGrep: false, pattern: '', flags: [], paths: [] };
+    if (paths.length === 0)
+        paths.push('/');
+    return { isGrep: true, pattern, flags, paths };
+}
+export function parseQmdCommand(command) {
+    const trimmed = command.trim();
+    // Reject piped/chained commands
+    if (trimmed.includes('|') || trimmed.includes(';') || trimmed.includes('&&')) {
+        return { isQmd: false, query: '' };
+    }
+    if (!trimmed.startsWith('qmd ') && trimmed !== 'qmd') {
+        return { isQmd: false, query: '' };
+    }
+    // Extract the query after "qmd "
+    const rest = trimmed.slice(4).trim();
+    if (!rest)
+        return { isQmd: false, query: '' };
+    // Handle quoted query: qmd "query" or qmd 'query'
+    if ((rest.startsWith('"') && rest.endsWith('"')) || (rest.startsWith("'") && rest.endsWith("'"))) {
+        const query = rest.slice(1, -1);
+        if (!query)
+            return { isQmd: false, query: '' };
+        return { isQmd: true, query };
+    }
+    // Unquoted: qmd query words here
+    return { isQmd: true, query: rest };
+}
+function escapeRegex(str) {
+    return str.replace(/[.*+?^${}()|[\]\\]/g, '\\$&');
+}
+export async function vectorGrep(options) {
+    const { pattern, sourceName, embeddingClient, searchChunksFn, textSearchFn, limit = 20 } = options;
+    let semanticResults = [];
+    let semanticError = null;
+    try {
+        const embedding = await embeddingClient.embed(pattern);
+        semanticResults = await searchChunksFn(embedding, limit, sourceName);
+    }
+    catch (err) {
+        semanticError = err instanceof Error ? err.message : String(err);
+        console.warn(`[bash-grep] Semantic search failed: ${semanticError}`);
+    }
+    let textResults = [];
+    let textError = null;
+    try {
+        textResults = await textSearchFn(pattern, limit, sourceName);
+    }
+    catch (err) {
+        textError = err instanceof Error ? err.message : String(err);
+        console.warn(`[bash-grep] Text search failed: ${textError}`);
+    }
+    if (semanticResults.length === 0 && textResults.length === 0 && semanticError && textError) {
+        return {
+            stdout: '',
+            stderr: `grep: search unavailable (semantic: ${semanticError}, text: ${textError})\n`,
+            exitCode: 2,
+        };
+    }
+    const seenIds = new Set();
+    const allResults = [];
+    for (const r of [...semanticResults, ...textResults]) {
+        if (!seenIds.has(r.id)) {
+            seenIds.add(r.id);
+            allResults.push(r);
+        }
+    }
+    const regex = new RegExp(escapeRegex(pattern), 'i');
+    const matching = allResults.filter(r => regex.test(r.content));
+    let warnings = '';
+    if (semanticError && !textError) {
+        warnings = `[warning: semantic search unavailable: ${semanticError}]\n`;
+    }
+    else if (!semanticError && textError) {
+        warnings = `[warning: text search unavailable: ${textError}]\n`;
+    }
+    if (matching.length === 0)
+        return { stdout: '', stderr: warnings, exitCode: 1 };
+    const lines = [];
+    for (const r of matching) {
+        const contentLines = r.content.split('\n');
+        const startLine = r.start_line ?? 1;
+        for (let i = 0; i < contentLines.length; i++) {
+            if (regex.test(contentLines[i])) {
+                lines.push(`/${r.file_path}:${startLine + i}:${contentLines[i]}`);
+            }
+        }
+    }
+    if (lines.length === 0)
+        return { stdout: '', stderr: warnings, exitCode: 1 };
+    return { stdout: lines.join('\n') + '\n', stderr: warnings, exitCode: 0 };
+}
+//# sourceMappingURL=bash-grep.js.map

package/dist/mcp/tools/bash-grep.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"bash-grep.js","sourceRoot":"","sources":["../../../src/mcp/tools/bash-grep.ts"],"names":[],"mappings":"AAUA,2DAA2D;AAC3D,MAAM,eAAe,GAAG,IAAI,GAAG,CAAC,CAAC,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,CAAC,CAAC,CAAC;AAEtE,MAAM,UAAU,gBAAgB,CAAC,OAAe;IAC5C,MAAM,OAAO,GAAG,OAAO,CAAC,IAAI,EAAE,CAAC;IAC/B,IAAI,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAC,IAAI,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAC,IAAI,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAC,EAAE,CAAC;QAC3E,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,EAAE,EAAE,KAAK,EAAE,EAAE,EAAE,CAAC;IAChE,CAAC;IACD,IAAI,CAAC,OAAO,CAAC,UAAU,CAAC,OAAO,CAAC,IAAI,OAAO,KAAK,MAAM,EAAE,CAAC;QACrD,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,EAAE,EAAE,KAAK,EAAE,EAAE,EAAE,CAAC;IAChE,CAAC;IACD,MAAM,MAAM,GAAa,EAAE,CAAC;IAC5B,IAAI,CAAC,GAAG,CAAC,CAAC;IACV,OAAO,CAAC,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC;QACxB,OAAO,CAAC,GAAG,OAAO,CAAC,MAAM,IAAI,OAAO,CAAC,CAAC,CAAC,KAAK,GAAG;YAAE,CAAC,EAAE,CAAC;QACrD,IAAI,CAAC,IAAI,OAAO,CAAC,MAAM;YAAE,MAAM;QAC/B,IAAI,OAAO,CAAC,CAAC,CAAC,KAAK,GAAG,IAAI,OAAO,CAAC,CAAC,CAAC,KAAK,GAAG,EAAE,CAAC;YAC3C,MAAM,KAAK,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC;YAAC,CAAC,EAAE,CAAC;YAC9B,IAAI,KAAK,GAAG,EAAE,CAAC;YACf,OAAO,CAAC,GAAG,OAAO,CAAC,MAAM,IAAI,OAAO,CAAC,CAAC,CAAC,KAAK,KAAK,EAAE,CAAC;gBAAC,KAAK,IAAI,OAAO,CAAC,CAAC,CAAC,CAAC;gBAAC,CAAC,EAAE,CAAC;YAAC,CAAC;YAChF,CAAC,EAAE,CAAC;YACJ,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QACvB,CAAC;aAAM,CAAC;YACJ,IAAI,KAAK,GAAG,EAAE,CAAC;YACf,OAAO,CAAC,GAAG,OAAO,CAAC,MAAM,IAAI,OAAO,CAAC,CAAC,CAAC,KAAK,GAAG,EAAE,CAAC;gBAAC,KAAK,IAAI,OAAO,CAAC,CAAC,CAAC,CAAC;gBAAC,CAAC,EAAE,CAAC;YAAC,CAAC;YAC9E,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QACvB,CAAC;IACL,CAAC;IACD,MAAM,KAAK,GAAa,EAAE,CAAC;IAC3B,IAAI,OAAO,GAAG,EAAE,CAAC;IACjB,MAAM,KAAK,GAAa,EAAE,CAAC;IAC3B,IAAI,YAAY,GAAG,KAAK,CAAC;IACzB,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;QACrC,MAAM,KAAK,GAAG,MAAM,CAAC,CAAC,CAAC,CAAC;QACxB,IAAI,KAAK,CAAC,UAAU,CAAC,GAAG,CAAC,IAAI,CAAC,YAAY,EAAE,CAAC;YACzC,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;YAClB,6DAA6D;YAC7D,IAAI,eAAe,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,CAAC;gBACtD,CAAC,EAAE,CAAC;gBACJ,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC;YAC1B,CAAC;QACL,CAAC;aACI,IAAI,CAAC,YAAY,EAAE,CAAC;YAAC,OAAO,GAAG,KAAK,CAAC;YAAC,YAAY,GAAG,IAAI,CAAC;QAAC,CAAC;aAC5D,CAAC;YAAC,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QAAC,CAAC;IAC/B,CAAC;IACD,IAAI,CAAC,OAAO;QAAE,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,EAAE,EAAE,KAAK,EAAE,EAAE,EAAE,CAAC;IAC1E,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC;QAAE,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IACxC,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,CAAC;AACnD,CAAC;AAOD,MAAM,UAAU,eAAe,CAAC,OAAe;IAC3C,MAAM,OAAO,GAAG,OAAO,CAAC,IAAI,EAAE,CAAC;IAC/B,gCAAgC;IAChC,IAAI,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAC,IAAI,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAC,IAAI,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAC,EAAE,CAAC;QAC3E,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,EAAE,EAAE,CAAC;IACvC,CAAC;IACD,IAAI,CAAC,OAAO,CAAC,UAAU,CAAC,MAAM,CAAC,IAAI,OAAO,KAAK,KAAK,EAAE,CAAC;QACnD,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,EAAE,EAAE,CAAC;IACvC,CAAC;IACD,iCAAiC;IACjC,MAAM,IAAI,GAAG,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;IACrC,IAAI,CAAC,IAAI;QAAE,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,EAAE,EAAE,CAAC;IAC9C,kDAAkD;IAClD,IAAI,CAAC,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,IAAI,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,IAAI,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,EAAE,CAAC;QAC/F,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC;QAChC,IAAI,CAAC,KAAK;YAAE,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,EAAE,EAAE,CAAC;QAC/C,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC;IAClC,CAAC;IACD,iCAAiC;IACjC,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC;AACxC,CAAC;AAiBD,SAAS,WAAW,CAAC,GAAW;IAC5B,OAAO,GAAG,CAAC,OAAO,CAAC,qBAAqB,EAAE,MAAM,CAAC,CAAC;AACtD,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,UAAU,CAAC,OAA0B;IACvD,MAAM,EAAE,OAAO,EAAE,UAAU,EAAE,eAAe,EAAE,cAAc,EAAE,YAAY,EAAE,KAAK,GAAG,EAAE,EAAE,GAAG,OAAO,CAAC;IACnG,IAAI,eAAe,GAAkB,EAAE,CAAC;IACxC,IAAI,aAAa,GAAkB,IAAI,CAAC;IACxC,IAAI,CAAC;QACD,MAAM,SAAS,GAAG,MAAM,eAAe,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;QACvD,eAAe,GAAG,MAAM,cAAc,CAAC,SAAS,EAAE,KAAK,EAAE,UAAU,CAAC,CAAC;IACzE,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACX,aAAa,GAAG,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;QACjE,OAAO,CAAC,IAAI,CAAC,uCAAuC,aAAa,EAAE,CAAC,CAAC;IACzE,CAAC;IACD,IAAI,WAAW,GAAkB,EAAE,CAAC;IACpC,IAAI,SAAS,GAAkB,IAAI,CAAC;IACpC,IAAI,CAAC;QACD,WAAW,GAAG,MAAM,YAAY,CAAC,OAAO,EAAE,KAAK,EAAE,UAAU,CAAC,CAAC;IACjE,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACX,SAAS,GAAG,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;QAC7D,OAAO,CAAC,IAAI,CAAC,mCAAmC,SAAS,EAAE,CAAC,CAAC;IACjE,CAAC;IACD,IAAI,eAAe,CAAC,MAAM,KAAK,CAAC,IAAI,WAAW,CAAC,MAAM,KAAK,CAAC,IAAI,aAAa,IAAI,SAAS,EAAE,CAAC;QACzF,OAAO;YACH,MAAM,EAAE,EAAE;YACV,MAAM,EAAE,uCAAuC,aAAa,WAAW,SAAS,KAAK;YACrF,QAAQ,EAAE,CAAC;SACd,CAAC;IACN,CAAC;IACD,MAAM,OAAO,GAAG,IAAI,GAAG,EAAU,CAAC;IAClC,MAAM,UAAU,GAAkB,EAAE,CAAC;IACrC,KAAK,MAAM,CAAC,IAAI,CAAC,GAAG,eAAe,EAAE,GAAG,WAAW,CAAC,EAAE,CAAC;QACnD,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC;YAAC,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;YAAC,UAAU,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QAAC,CAAC;IACtE,CAAC;IACD,MAAM,KAAK,GAAG,IAAI,MAAM,CAAC,WAAW,CAAC,OAAO,CAAC,EAAE,GAAG,CAAC,CAAC;IACpD,MAAM,QAAQ,GAAG,UAAU,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC;IAC/D,IAAI,QAAQ,GAAG,EAAE,CAAC;IAClB,IAAI,aAAa,IAAI,CAAC,SAAS,EAAE,CAAC;QAC9B,QAAQ,GAAG,0CAA0C,aAAa,KAAK,CAAC;IAC5E,CAAC;SAAM,IAAI,CAAC,aAAa,IAAI,SAAS,EAAE,CAAC;QACrC,QAAQ,GAAG,sCAAsC,SAAS,KAAK,CAAC;IACpE,CAAC;IACD,IAAI,QAAQ,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,EAAE,QAAQ,EAAE,QAAQ,EAAE,CAAC,EAAE,CAAC;IAChF,MAAM,KAAK,GAAa,EAAE,CAAC;IAC3B,KAAK,MAAM,CAAC,IAAI,QAAQ,EAAE,CAAC;QACvB,MAAM,YAAY,GAAG,CAAC,CAAC,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;QAC3C,MAAM,SAAS,GAAG,CAAC,CAAC,UAAU,IAAI,CAAC,CAAC;QACpC,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,YAAY,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;YAC3C,IAAI,KAAK,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;gBAC9B,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,SAAS,IAAI,SAAS,GAAG,CAAC,IAAI,YAAY,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;YACtE,CAAC;QACL,CAAC;IACL,CAAC;IACD,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,EAAE,QAAQ,EAAE,QAAQ,EAAE,CAAC,EAAE,CAAC;IAC7E,OAAO,EAAE,MAAM,EAAE,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,QAAQ,EAAE,CAAC,EAAE,CAAC;AAC9E,CAAC"}

package/dist/mcp/tools/bash-related.d.ts

@@ -0,0 +1,14 @@
+import type { EmbeddingClient } from '../../indexing/embeddings.js';
+import type { ChunkResult } from '../../types.js';
+export interface RelatedResult {
+    stdout: string;
+    stderr: string;
+    exitCode: number;
+}
+export declare function parseRelatedCommand(command: string): {
+    isRelated: boolean;
+    path: string;
+};
+export declare function handleRelatedCommand(filePath: string, fileContent: string | undefined, embeddingClient: EmbeddingClient, searchChunksFn: (embedding: number[], limit: number) => Promise<ChunkResult[]>, limit?: number): Promise<RelatedResult>;
+export declare function formatGrepMissSuggestion(searchToolNames: string[]): string;
+//# sourceMappingURL=bash-related.d.ts.map

package/dist/mcp/tools/bash-related.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"bash-related.d.ts","sourceRoot":"","sources":["../../../src/mcp/tools/bash-related.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,8BAA8B,CAAC;AACpE,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAElD,MAAM,WAAW,aAAa;IAC1B,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,MAAM,CAAC;CACpB;AAED,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,MAAM,GAAG;IAAE,SAAS,EAAE,OAAO,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,CAKzF;AAED,wBAAsB,oBAAoB,CACtC,QAAQ,EAAE,MAAM,EAChB,WAAW,EAAE,MAAM,GAAG,SAAS,EAC/B,eAAe,EAAE,eAAe,EAChC,cAAc,EAAE,CAAC,SAAS,EAAE,MAAM,EAAE,EAAE,KAAK,EAAE,MAAM,KAAK,OAAO,CAAC,WAAW,EAAE,CAAC,EAC9E,KAAK,GAAE,MAAW,GACnB,OAAO,CAAC,aAAa,CAAC,CAyCxB;AAED,wBAAgB,wBAAwB,CAAC,eAAe,EAAE,MAAM,EAAE,GAAG,MAAM,CAI1E"}

package/dist/mcp/tools/bash-related.js

@@ -0,0 +1,54 @@
+export function parseRelatedCommand(command) {
+    const trimmed = command.trim();
+    const match = trimmed.match(/^related\s+(\S+)\s*$/);
+    if (match)
+        return { isRelated: true, path: match[1] };
+    return { isRelated: false, path: '' };
+}
+export async function handleRelatedCommand(filePath, fileContent, embeddingClient, searchChunksFn, limit = 10) {
+    if (!fileContent) {
+        return {
+            stdout: '',
+            stderr: `related: ${filePath}: No such file\n`,
+            exitCode: 1,
+        };
+    }
+    try {
+        // Embed the file's content (truncate to reasonable length for embedding)
+        const contentForEmbedding = fileContent.slice(0, 8000);
+        const embedding = await embeddingClient.embed(contentForEmbedding);
+        const results = await searchChunksFn(embedding, limit);
+        // Deduplicate by file_path (keep highest similarity)
+        const byFile = new Map();
+        for (const r of results) {
+            const vPath = r.source_name ? `/${r.source_name}/${r.file_path}` : `/${r.file_path}`;
+            if (vPath === filePath)
+                continue; // skip self — exact match only
+            const existing = byFile.get(vPath);
+            if (!existing || r.similarity > existing.similarity) {
+                byFile.set(vPath, { path: vPath, similarity: r.similarity });
+            }
+        }
+        if (byFile.size === 0) {
+            return { stdout: 'No related files found.\n', stderr: '', exitCode: 0 };
+        }
+        const sorted = [...byFile.values()].sort((a, b) => b.similarity - a.similarity);
+        const lines = [`Semantically related files for ${filePath}:\n`];
+        for (const { path, similarity } of sorted) {
+            lines.push(`  ${similarity.toFixed(2)}  ${path}`);
+        }
+        return { stdout: lines.join('\n') + '\n', stderr: '', exitCode: 0 };
+    }
+    catch (err) {
+        const msg = err instanceof Error ? err.message : String(err);
+        console.error(`[bash-related] Error: ${msg}`);
+        return { stdout: '', stderr: `related: error: ${msg}\n`, exitCode: 1 };
+    }
+}
+export function formatGrepMissSuggestion(searchToolNames) {
+    if (searchToolNames.length === 0)
+        return '';
+    const tools = searchToolNames.join(', ');
+    return `\nNo matches found. Try semantic search: qmd "your query" or ${tools}("your query")\n`;
+}
+//# sourceMappingURL=bash-related.js.map

package/dist/mcp/tools/bash-related.js.map

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

package/dist/mcp/tools/bash-session.d.ts

@@ -0,0 +1,23 @@
+export declare class BashSessionState {
+    private cwd;
+    getCwd(): string;
+    setCwd(dir: string): void;
+    resolvePath(target: string): string;
+}
+export declare class SessionStateManager {
+    private sessions;
+    getOrCreate(sessionId: string): BashSessionState;
+    cleanup(sessionId: string): void;
+    cleanupAll(): void;
+    get size(): number;
+}
+export declare class WorkspaceTracker {
+    private usedBytes;
+    private maxBytes;
+    constructor(maxBytes?: number);
+    getUsedBytes(): number;
+    getMaxBytes(): number;
+    trackWrite(bytes: number): boolean;
+    reset(): void;
+}
+//# sourceMappingURL=bash-session.d.ts.map

package/dist/mcp/tools/bash-session.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"bash-session.d.ts","sourceRoot":"","sources":["../../../src/mcp/tools/bash-session.ts"],"names":[],"mappings":"AAEA,qBAAa,gBAAgB;IACzB,OAAO,CAAC,GAAG,CAAe;IAE1B,MAAM,IAAI,MAAM;IAIhB,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI;IAIzB,WAAW,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM;CAMtC;AAED,qBAAa,mBAAmB;IAC5B,OAAO,CAAC,QAAQ,CAAuC;IAEvD,WAAW,CAAC,SAAS,EAAE,MAAM,GAAG,gBAAgB;IAShD,OAAO,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI;IAIhC,UAAU,IAAI,IAAI;IAIlB,IAAI,IAAI,IAAI,MAAM,CAEjB;CACJ;AAID,qBAAa,gBAAgB;IACzB,OAAO,CAAC,SAAS,CAAK;IACtB,OAAO,CAAC,QAAQ,CAAS;gBAEb,QAAQ,GAAE,MAAoC;IAI1D,YAAY,IAAI,MAAM;IAItB,WAAW,IAAI,MAAM;IAIrB,UAAU,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO;IAMlC,KAAK,IAAI,IAAI;CAGhB"}

package/dist/mcp/tools/bash-session.js

@@ -0,0 +1,60 @@
+import path from 'node:path';
+export class BashSessionState {
+    cwd = '/';
+    getCwd() {
+        return this.cwd;
+    }
+    setCwd(dir) {
+        this.cwd = dir === '/' ? '/' : dir.replace(/\/+$/, '');
+    }
+    resolvePath(target) {
+        const resolved = target.startsWith('/')
+            ? path.posix.normalize(target)
+            : path.posix.normalize(path.posix.join(this.cwd, target));
+        return resolved === '/' ? '/' : resolved.replace(/\/+$/, '');
+    }
+}
+export class SessionStateManager {
+    sessions = new Map();
+    getOrCreate(sessionId) {
+        let state = this.sessions.get(sessionId);
+        if (!state) {
+            state = new BashSessionState();
+            this.sessions.set(sessionId, state);
+        }
+        return state;
+    }
+    cleanup(sessionId) {
+        this.sessions.delete(sessionId);
+    }
+    cleanupAll() {
+        this.sessions.clear();
+    }
+    get size() {
+        return this.sessions.size;
+    }
+}
+const DEFAULT_WORKSPACE_MAX_BYTES = 1024 * 1024; // 1MB
+export class WorkspaceTracker {
+    usedBytes = 0;
+    maxBytes;
+    constructor(maxBytes = DEFAULT_WORKSPACE_MAX_BYTES) {
+        this.maxBytes = maxBytes;
+    }
+    getUsedBytes() {
+        return this.usedBytes;
+    }
+    getMaxBytes() {
+        return this.maxBytes;
+    }
+    trackWrite(bytes) {
+        if (this.usedBytes + bytes > this.maxBytes)
+            return false;
+        this.usedBytes += bytes;
+        return true;
+    }
+    reset() {
+        this.usedBytes = 0;
+    }
+}
+//# sourceMappingURL=bash-session.js.map

package/dist/mcp/tools/bash-session.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"bash-session.js","sourceRoot":"","sources":["../../../src/mcp/tools/bash-session.ts"],"names":[],"mappings":"AAAA,OAAO,IAAI,MAAM,WAAW,CAAC;AAE7B,MAAM,OAAO,gBAAgB;IACjB,GAAG,GAAW,GAAG,CAAC;IAE1B,MAAM;QACF,OAAO,IAAI,CAAC,GAAG,CAAC;IACpB,CAAC;IAED,MAAM,CAAC,GAAW;QACd,IAAI,CAAC,GAAG,GAAG,GAAG,KAAK,GAAG,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC;IAC3D,CAAC;IAED,WAAW,CAAC,MAAc;QACtB,MAAM,QAAQ,GAAG,MAAM,CAAC,UAAU,CAAC,GAAG,CAAC;YACnC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,SAAS,CAAC,MAAM,CAAC;YAC9B,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,SAAS,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,MAAM,CAAC,CAAC,CAAC;QAC9D,OAAO,QAAQ,KAAK,GAAG,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,QAAQ,CAAC,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC;IACjE,CAAC;CACJ;AAED,MAAM,OAAO,mBAAmB;IACpB,QAAQ,GAAG,IAAI,GAAG,EAA4B,CAAC;IAEvD,WAAW,CAAC,SAAiB;QACzB,IAAI,KAAK,GAAG,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC;QACzC,IAAI,CAAC,KAAK,EAAE,CAAC;YACT,KAAK,GAAG,IAAI,gBAAgB,EAAE,CAAC;YAC/B,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,SAAS,EAAE,KAAK,CAAC,CAAC;QACxC,CAAC;QACD,OAAO,KAAK,CAAC;IACjB,CAAC;IAED,OAAO,CAAC,SAAiB;QACrB,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC;IACpC,CAAC;IAED,UAAU;QACN,IAAI,CAAC,QAAQ,CAAC,KAAK,EAAE,CAAC;IAC1B,CAAC;IAED,IAAI,IAAI;QACJ,OAAO,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC;IAC9B,CAAC;CACJ;AAED,MAAM,2BAA2B,GAAG,IAAI,GAAG,IAAI,CAAC,CAAC,MAAM;AAEvD,MAAM,OAAO,gBAAgB;IACjB,SAAS,GAAG,CAAC,CAAC;IACd,QAAQ,CAAS;IAEzB,YAAY,WAAmB,2BAA2B;QACtD,IAAI,CAAC,QAAQ,GAAG,QAAQ,CAAC;IAC7B,CAAC;IAED,YAAY;QACR,OAAO,IAAI,CAAC,SAAS,CAAC;IAC1B,CAAC;IAED,WAAW;QACP,OAAO,IAAI,CAAC,QAAQ,CAAC;IACzB,CAAC;IAED,UAAU,CAAC,KAAa;QACpB,IAAI,IAAI,CAAC,SAAS,GAAG,KAAK,GAAG,IAAI,CAAC,QAAQ;YAAE,OAAO,KAAK,CAAC;QACzD,IAAI,CAAC,SAAS,IAAI,KAAK,CAAC;QACxB,OAAO,IAAI,CAAC;IAChB,CAAC;IAED,KAAK;QACD,IAAI,CAAC,SAAS,GAAG,CAAC,CAAC;IACvB,CAAC;CACJ"}

package/dist/mcp/tools/bash-telemetry.d.ts

@@ -0,0 +1,26 @@
+export interface TelemetryEvent {
+    type: 'file_access' | 'grep_miss' | 'command';
+    timestamp: string;
+    path?: string;
+    pattern?: string;
+    command?: string;
+}
+type InsertFn = (toolName: string, data: Record<string, unknown>) => Promise<void>;
+export declare class BashTelemetry {
+    private events;
+    private insertFn;
+    constructor(insertFn: InsertFn);
+    private addEvent;
+    recordFileAccess(path: string, command: string): void;
+    recordGrepMiss(pattern: string, command: string): void;
+    recordCommand(command: string): void;
+    getEvents(): TelemetryEvent[];
+    getStats(): {
+        totalCommands: number;
+        fileAccesses: number;
+        grepMisses: number;
+    };
+    flush(): Promise<void>;
+}
+export {};
+//# sourceMappingURL=bash-telemetry.d.ts.map

package/dist/mcp/tools/bash-telemetry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"bash-telemetry.d.ts","sourceRoot":"","sources":["../../../src/mcp/tools/bash-telemetry.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,cAAc;IAC3B,IAAI,EAAE,aAAa,GAAG,WAAW,GAAG,SAAS,CAAC;IAC9C,SAAS,EAAE,MAAM,CAAC;IAClB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,OAAO,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,KAAK,QAAQ,GAAG,CAAC,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;AAInF,qBAAa,aAAa;IACtB,OAAO,CAAC,MAAM,CAAwB;IACtC,OAAO,CAAC,QAAQ,CAAW;gBAEf,QAAQ,EAAE,QAAQ;IAI9B,OAAO,CAAC,QAAQ;IAShB,gBAAgB,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,IAAI;IAIrD,cAAc,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,IAAI;IAItD,aAAa,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI;IAIpC,SAAS,IAAI,cAAc,EAAE;IAI7B,QAAQ,IAAI;QAAE,aAAa,EAAE,MAAM,CAAC;QAAC,YAAY,EAAE,MAAM,CAAC;QAAC,UAAU,EAAE,MAAM,CAAA;KAAE;IAUzE,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;CAW/B"}

package/dist/mcp/tools/bash-telemetry.js

@@ -0,0 +1,53 @@
+const MAX_BUFFER_SIZE = 10000;
+export class BashTelemetry {
+    events = [];
+    insertFn;
+    constructor(insertFn) {
+        this.insertFn = insertFn;
+    }
+    addEvent(event) {
+        this.events.push(event);
+        if (this.events.length > MAX_BUFFER_SIZE) {
+            const dropped = this.events.length - MAX_BUFFER_SIZE;
+            this.events = this.events.slice(dropped);
+            console.warn(`[bash-telemetry] Buffer overflow: dropped ${dropped} oldest events`);
+        }
+    }
+    recordFileAccess(path, command) {
+        this.addEvent({ type: 'file_access', timestamp: new Date().toISOString(), path, command });
+    }
+    recordGrepMiss(pattern, command) {
+        this.addEvent({ type: 'grep_miss', timestamp: new Date().toISOString(), pattern, command });
+    }
+    recordCommand(command) {
+        this.addEvent({ type: 'command', timestamp: new Date().toISOString(), command });
+    }
+    getEvents() {
+        return [...this.events];
+    }
+    getStats() {
+        let fileAccesses = 0;
+        let grepMisses = 0;
+        for (const e of this.events) {
+            if (e.type === 'file_access')
+                fileAccesses++;
+            if (e.type === 'grep_miss')
+                grepMisses++;
+        }
+        return { totalCommands: this.events.length, fileAccesses, grepMisses };
+    }
+    async flush() {
+        if (this.events.length === 0)
+            return;
+        const batch = [...this.events];
+        this.events = [];
+        try {
+            await this.insertFn('_telemetry', { events: batch, flushed_at: new Date().toISOString() });
+        }
+        catch (err) {
+            this.events.unshift(...batch);
+            console.error('[bash-telemetry] Flush failed:', err instanceof Error ? err.message : String(err));
+        }
+    }
+}
+//# sourceMappingURL=bash-telemetry.js.map

package/dist/mcp/tools/bash-telemetry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"bash-telemetry.js","sourceRoot":"","sources":["../../../src/mcp/tools/bash-telemetry.ts"],"names":[],"mappings":"AAUA,MAAM,eAAe,GAAG,KAAK,CAAC;AAE9B,MAAM,OAAO,aAAa;IACd,MAAM,GAAqB,EAAE,CAAC;IAC9B,QAAQ,CAAW;IAE3B,YAAY,QAAkB;QAC1B,IAAI,CAAC,QAAQ,GAAG,QAAQ,CAAC;IAC7B,CAAC;IAEO,QAAQ,CAAC,KAAqB;QAClC,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QACxB,IAAI,IAAI,CAAC,MAAM,CAAC,MAAM,GAAG,eAAe,EAAE,CAAC;YACvC,MAAM,OAAO,GAAG,IAAI,CAAC,MAAM,CAAC,MAAM,GAAG,eAAe,CAAC;YACrD,IAAI,CAAC,MAAM,GAAG,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;YACzC,OAAO,CAAC,IAAI,CAAC,6CAA6C,OAAO,gBAAgB,CAAC,CAAC;QACvF,CAAC;IACL,CAAC;IAED,gBAAgB,CAAC,IAAY,EAAE,OAAe;QAC1C,IAAI,CAAC,QAAQ,CAAC,EAAE,IAAI,EAAE,aAAa,EAAE,SAAS,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,EAAE,IAAI,EAAE,OAAO,EAAE,CAAC,CAAC;IAC/F,CAAC;IAED,cAAc,CAAC,OAAe,EAAE,OAAe;QAC3C,IAAI,CAAC,QAAQ,CAAC,EAAE,IAAI,EAAE,WAAW,EAAE,SAAS,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,EAAE,OAAO,EAAE,OAAO,EAAE,CAAC,CAAC;IAChG,CAAC;IAED,aAAa,CAAC,OAAe;QACzB,IAAI,CAAC,QAAQ,CAAC,EAAE,IAAI,EAAE,SAAS,EAAE,SAAS,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,EAAE,OAAO,EAAE,CAAC,CAAC;IACrF,CAAC;IAED,SAAS;QACL,OAAO,CAAC,GAAG,IAAI,CAAC,MAAM,CAAC,CAAC;IAC5B,CAAC;IAED,QAAQ;QACJ,IAAI,YAAY,GAAG,CAAC,CAAC;QACrB,IAAI,UAAU,GAAG,CAAC,CAAC;QACnB,KAAK,MAAM,CAAC,IAAI,IAAI,CAAC,MAAM,EAAE,CAAC;YAC1B,IAAI,CAAC,CAAC,IAAI,KAAK,aAAa;gBAAE,YAAY,EAAE,CAAC;YAC7C,IAAI,CAAC,CAAC,IAAI,KAAK,WAAW;gBAAE,UAAU,EAAE,CAAC;QAC7C,CAAC;QACD,OAAO,EAAE,aAAa,EAAE,IAAI,CAAC,MAAM,CAAC,MAAM,EAAE,YAAY,EAAE,UAAU,EAAE,CAAC;IAC3E,CAAC;IAED,KAAK,CAAC,KAAK;QACP,IAAI,IAAI,CAAC,MAAM,CAAC,MAAM,KAAK,CAAC;YAAE,OAAO;QACrC,MAAM,KAAK,GAAG,CAAC,GAAG,IAAI,CAAC,MAAM,CAAC,CAAC;QAC/B,IAAI,CAAC,MAAM,GAAG,EAAE,CAAC;QACjB,IAAI,CAAC;YACD,MAAM,IAAI,CAAC,QAAQ,CAAC,YAAY,EAAE,EAAE,MAAM,EAAE,KAAK,EAAE,UAAU,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,EAAE,CAAC,CAAC;QAC/F,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACX,IAAI,CAAC,MAAM,CAAC,OAAO,CAAC,GAAG,KAAK,CAAC,CAAC;YAC9B,OAAO,CAAC,KAAK,CAAC,gCAAgC,EAAE,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC;QACtG,CAAC;IACL,CAAC;CACJ"}

package/dist/mcp/tools/bash-virtual-files.d.ts

@@ -0,0 +1,3 @@
+export declare function generateIndexMd(fileTree: Record<string, string>): string;
+export declare function generateSearchTipsMd(searchToolNames: string[]): string;
+//# sourceMappingURL=bash-virtual-files.d.ts.map

package/dist/mcp/tools/bash-virtual-files.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"bash-virtual-files.d.ts","sourceRoot":"","sources":["../../../src/mcp/tools/bash-virtual-files.ts"],"names":[],"mappings":"AAAA,wBAAgB,eAAe,CAAC,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,MAAM,CA8BxE;AAED,wBAAgB,oBAAoB,CAAC,eAAe,EAAE,MAAM,EAAE,GAAG,MAAM,CA4BtE"}