token-pilot 0.1.1

package/dist/handlers/project-overview.js

@@ -0,0 +1,84 @@
+import { readFile } from 'node:fs/promises';
+import { resolve } from 'node:path';
+export async function handleProjectOverview(projectRoot, astIndex) {
+    const lines = [
+        `PROJECT OVERVIEW: ${projectRoot}`,
+        '',
+    ];
+    // 1. Try to get ast-index stats
+    try {
+        const statsRaw = await astIndex.search('', { maxResults: 0 });
+        // stats via the stats method is better
+    }
+    catch {
+        // ignore
+    }
+    // 2. Read package.json / Cargo.toml etc. for project info
+    const projectInfo = await detectProjectInfo(projectRoot);
+    if (projectInfo) {
+        lines.push(`Project: ${projectInfo.name} v${projectInfo.version}`);
+        if (projectInfo.description)
+            lines.push(`Description: ${projectInfo.description}`);
+        lines.push(`Type: ${projectInfo.type}`);
+        lines.push('');
+    }
+    // 3. Use ast-index map for compact project structure
+    try {
+        const mapResult = await execAstIndexMap(astIndex);
+        if (mapResult) {
+            lines.push('PROJECT MAP:');
+            lines.push(mapResult);
+            lines.push('');
+        }
+    }
+    catch {
+        // map not available
+    }
+    lines.push('HINT: Use smart_read() on individual files, or search_code() to find specific symbols.');
+    return { content: [{ type: 'text', text: lines.join('\n') }] };
+}
+async function detectProjectInfo(projectRoot) {
+    // Try package.json
+    try {
+        const pkg = JSON.parse(await readFile(resolve(projectRoot, 'package.json'), 'utf-8'));
+        return {
+            name: pkg.name ?? 'unknown',
+            version: pkg.version ?? '0.0.0',
+            description: pkg.description,
+            type: 'Node.js/TypeScript',
+        };
+    }
+    catch { /* not a node project */ }
+    // Try Cargo.toml
+    try {
+        const cargo = await readFile(resolve(projectRoot, 'Cargo.toml'), 'utf-8');
+        const name = cargo.match(/^name\s*=\s*"(.+?)"/m)?.[1] ?? 'unknown';
+        const version = cargo.match(/^version\s*=\s*"(.+?)"/m)?.[1] ?? '0.0.0';
+        return { name, version, type: 'Rust' };
+    }
+    catch { /* not a rust project */ }
+    // Try pyproject.toml
+    try {
+        const pyproject = await readFile(resolve(projectRoot, 'pyproject.toml'), 'utf-8');
+        const name = pyproject.match(/^name\s*=\s*"(.+?)"/m)?.[1] ?? 'unknown';
+        const version = pyproject.match(/^version\s*=\s*"(.+?)"/m)?.[1] ?? '0.0.0';
+        return { name, version, type: 'Python' };
+    }
+    catch { /* not a python project */ }
+    // Try go.mod
+    try {
+        const gomod = await readFile(resolve(projectRoot, 'go.mod'), 'utf-8');
+        const name = gomod.match(/^module\s+(.+)/m)?.[1] ?? 'unknown';
+        return { name, version: '0.0.0', type: 'Go' };
+    }
+    catch { /* not a go project */ }
+    return null;
+}
+async function execAstIndexMap(astIndex) {
+    // ast-index map returns a compact project structure
+    // We access it via the internal exec by using search with empty query
+    // Actually, we need to expose a map() method. For now, return null.
+    // This will be enhanced when we expose more ast-index commands.
+    return null;
+}
+//# sourceMappingURL=project-overview.js.map

package/dist/handlers/project-overview.js.map

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

package/dist/handlers/read-diff.d.ts

@@ -0,0 +1,13 @@
+import type { FileCache } from '../core/file-cache.js';
+import type { ContextRegistry } from '../core/context-registry.js';
+export interface ReadDiffArgs {
+    path: string;
+    context_lines?: number;
+}
+export declare function handleReadDiff(args: ReadDiffArgs, projectRoot: string, fileCache: FileCache, contextRegistry: ContextRegistry): Promise<{
+    content: Array<{
+        type: 'text';
+        text: string;
+    }>;
+}>;
+//# sourceMappingURL=read-diff.d.ts.map

package/dist/handlers/read-diff.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"read-diff.d.ts","sourceRoot":"","sources":["../../src/handlers/read-diff.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,uBAAuB,CAAC;AACvD,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,6BAA6B,CAAC;AAInE,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,MAAM,CAAC;IACb,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB;AAED,wBAAsB,cAAc,CAClC,IAAI,EAAE,YAAY,EAClB,WAAW,EAAE,MAAM,EACnB,SAAS,EAAE,SAAS,EACpB,eAAe,EAAE,eAAe,GAC/B,OAAO,CAAC;IAAE,OAAO,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC,CAAA;CAAE,CAAC,CAgE7D"}

package/dist/handlers/read-diff.js

@@ -0,0 +1,174 @@
+import { readFile, stat } from 'node:fs/promises';
+import { createHash } from 'node:crypto';
+import { estimateTokens, formatSavings } from '../core/token-estimator.js';
+import { resolveSafePath } from '../core/validation.js';
+export async function handleReadDiff(args, projectRoot, fileCache, contextRegistry) {
+    const absPath = resolveSafePath(projectRoot, args.path);
+    const contextLines = args.context_lines ?? 3;
+    // Get cached (previous) version
+    const cached = fileCache.get(absPath);
+    if (!cached) {
+        return {
+            content: [{
+                    type: 'text',
+                    text: `No previous read of ${args.path}. Use smart_read() first, then read_diff() after changes.`,
+                }],
+        };
+    }
+    // Read current version
+    const currentContent = await readFile(absPath, 'utf-8');
+    const currentHash = createHash('sha256').update(currentContent).digest('hex');
+    // No changes?
+    if (currentHash === cached.hash) {
+        return {
+            content: [{
+                    type: 'text',
+                    text: `NO CHANGES: ${args.path} is unchanged since last read.`,
+                }],
+        };
+    }
+    // Compute diff
+    const oldLines = cached.lines;
+    const newLines = currentContent.split('\n');
+    const diff = computeDiff(oldLines, newLines, contextLines);
+    const outputLines = [
+        `DIFF: ${args.path} (modified since last read)`,
+        `PREVIOUS: ${cached.hash.slice(0, 7)} → CURRENT: ${currentHash.slice(0, 7)}`,
+        '',
+        ...diff,
+    ];
+    const output = outputLines.join('\n');
+    const diffTokens = estimateTokens(output);
+    const fullTokens = estimateTokens(currentContent);
+    outputLines.push('');
+    outputLines.push(formatSavings(diffTokens, fullTokens));
+    // Update cache with new content so next diff works correctly
+    const fileStat = await stat(absPath);
+    fileCache.set(absPath, {
+        structure: cached.structure, // reuse structure until next smart_read
+        content: currentContent,
+        lines: newLines,
+        mtime: fileStat.mtimeMs,
+        hash: currentHash,
+        lastAccess: Date.now(),
+    });
+    // Update context registry hash
+    contextRegistry.setContentHash(absPath, currentHash);
+    return { content: [{ type: 'text', text: outputLines.join('\n') }] };
+}
+/**
+ * O(n) line diff using a Map for lookups instead of Array.includes().
+ * Groups consecutive changes into hunks with surrounding context.
+ */
+function computeDiff(oldLines, newLines, contextLines) {
+    // Build a set of line -> positions in newLines for O(1) lookup
+    const newLineIndex = new Map();
+    for (let i = 0; i < newLines.length; i++) {
+        const positions = newLineIndex.get(newLines[i]);
+        if (positions) {
+            positions.push(i);
+        }
+        else {
+            newLineIndex.set(newLines[i], [i]);
+        }
+    }
+    // Walk both arrays, matching lines greedily
+    const changes = [];
+    let oi = 0;
+    let ni = 0;
+    while (oi < oldLines.length || ni < newLines.length) {
+        if (oi < oldLines.length && ni < newLines.length && oldLines[oi] === newLines[ni]) {
+            changes.push({ type: 'same', line: newLines[ni], oldNum: oi + 1, newNum: ni + 1 });
+            oi++;
+            ni++;
+        }
+        else if (oi < oldLines.length && !newLineIndex.has(oldLines[oi])) {
+            // Line only exists in old — it was removed
+            changes.push({ type: 'removed', line: oldLines[oi], oldNum: oi + 1 });
+            oi++;
+        }
+        else if (ni < newLines.length) {
+            // Check if the old line exists later in new (i.e., we need to consume added lines first)
+            const oldLinePositions = oi < oldLines.length ? newLineIndex.get(oldLines[oi]) : undefined;
+            if (oldLinePositions && oldLinePositions.some(p => p >= ni)) {
+                // Old line will match later — current newLine is added
+                changes.push({ type: 'added', line: newLines[ni], newNum: ni + 1 });
+                ni++;
+            }
+            else if (oi < oldLines.length) {
+                // Old line not found ahead — it's removed
+                changes.push({ type: 'removed', line: oldLines[oi], oldNum: oi + 1 });
+                oi++;
+            }
+            else {
+                // Only new lines remain
+                changes.push({ type: 'added', line: newLines[ni], newNum: ni + 1 });
+                ni++;
+            }
+        }
+        else {
+            // Only old lines remain
+            changes.push({ type: 'removed', line: oldLines[oi], oldNum: oi + 1 });
+            oi++;
+        }
+    }
+    // Format with context hunks
+    return formatHunks(changes, contextLines);
+}
+function formatHunks(changes, contextLines) {
+    const output = [];
+    // Find change indices
+    const changeIndices = [];
+    for (let i = 0; i < changes.length; i++) {
+        if (changes[i].type !== 'same')
+            changeIndices.push(i);
+    }
+    if (changeIndices.length === 0) {
+        return ['(No textual differences detected)'];
+    }
+    // Build hunks (groups of nearby changes)
+    const printed = new Set();
+    for (const ci of changeIndices) {
+        // Context before
+        for (let j = Math.max(0, ci - contextLines); j < ci; j++) {
+            if (!printed.has(j) && changes[j].type === 'same') {
+                const num = changes[j].newNum ?? changes[j].oldNum ?? 0;
+                output.push(`  ${String(num).padStart(4)} | ${changes[j].line}`);
+                printed.add(j);
+            }
+        }
+        // The change itself
+        if (!printed.has(ci)) {
+            const c = changes[ci];
+            if (c.type === 'removed') {
+                output.push(`- ${String(c.oldNum ?? 0).padStart(4)} | ${c.line}`);
+            }
+            else {
+                output.push(`+ ${String(c.newNum ?? 0).padStart(4)} | ${c.line}`);
+            }
+            printed.add(ci);
+        }
+        // Context after
+        let afterCount = 0;
+        for (let j = ci + 1; j < changes.length && afterCount < contextLines; j++) {
+            if (changes[j].type === 'same') {
+                if (!printed.has(j)) {
+                    const num = changes[j].newNum ?? changes[j].oldNum ?? 0;
+                    output.push(`  ${String(num).padStart(4)} | ${changes[j].line}`);
+                    printed.add(j);
+                }
+                afterCount++;
+            }
+            else {
+                break; // Next change will be handled in its own iteration
+            }
+        }
+        // Add separator if there's a gap to the next change
+        const nextChangeIdx = changeIndices[changeIndices.indexOf(ci) + 1];
+        if (nextChangeIdx !== undefined && nextChangeIdx - ci > contextLines * 2 + 1) {
+            output.push('  ...');
+        }
+    }
+    return output;
+}
+//# sourceMappingURL=read-diff.js.map

package/dist/handlers/read-diff.js.map

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

package/dist/handlers/read-range.d.ts

@@ -0,0 +1,14 @@
+import type { FileCache } from '../core/file-cache.js';
+import type { ContextRegistry } from '../core/context-registry.js';
+export interface ReadRangeArgs {
+    path: string;
+    start_line: number;
+    end_line: number;
+}
+export declare function handleReadRange(args: ReadRangeArgs, projectRoot: string, fileCache: FileCache, contextRegistry: ContextRegistry): Promise<{
+    content: Array<{
+        type: 'text';
+        text: string;
+    }>;
+}>;
+//# sourceMappingURL=read-range.d.ts.map

package/dist/handlers/read-range.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"read-range.d.ts","sourceRoot":"","sources":["../../src/handlers/read-range.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,uBAAuB,CAAC;AACvD,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,6BAA6B,CAAC;AAInE,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,wBAAsB,eAAe,CACnC,IAAI,EAAE,aAAa,EACnB,WAAW,EAAE,MAAM,EACnB,SAAS,EAAE,SAAS,EACpB,eAAe,EAAE,eAAe,GAC/B,OAAO,CAAC;IAAE,OAAO,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC,CAAA;CAAE,CAAC,CA+C7D"}

package/dist/handlers/read-range.js

@@ -0,0 +1,44 @@
+import { readFile } from 'node:fs/promises';
+import { estimateTokens } from '../core/token-estimator.js';
+import { resolveSafePath } from '../core/validation.js';
+export async function handleReadRange(args, projectRoot, fileCache, contextRegistry) {
+    const absPath = resolveSafePath(projectRoot, args.path);
+    // Get lines
+    const cached = fileCache.get(absPath);
+    let lines;
+    if (cached) {
+        lines = cached.lines;
+    }
+    else {
+        const content = await readFile(absPath, 'utf-8');
+        lines = content.split('\n');
+    }
+    const start = Math.max(0, args.start_line - 1);
+    const end = Math.min(lines.length, args.end_line);
+    if (start >= lines.length || start >= end) {
+        return {
+            content: [{
+                    type: 'text',
+                    text: `Invalid line range: ${args.start_line}-${args.end_line} (file has ${lines.length} lines)`,
+                }],
+        };
+    }
+    const outputLines = [
+        `FILE: ${args.path} [L${args.start_line}-${args.end_line}]`,
+        '',
+    ];
+    for (let i = start; i < end; i++) {
+        const lineNum = String(i + 1).padStart(4);
+        outputLines.push(`${lineNum} | ${lines[i]}`);
+    }
+    const output = outputLines.join('\n');
+    const tokens = estimateTokens(output);
+    contextRegistry.trackLoad(absPath, {
+        type: 'range',
+        startLine: args.start_line,
+        endLine: args.end_line,
+        tokens,
+    });
+    return { content: [{ type: 'text', text: output }] };
+}
+//# sourceMappingURL=read-range.js.map

package/dist/handlers/read-range.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"read-range.js","sourceRoot":"","sources":["../../src/handlers/read-range.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAG5C,OAAO,EAAE,cAAc,EAAE,MAAM,4BAA4B,CAAC;AAC5D,OAAO,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AAQxD,MAAM,CAAC,KAAK,UAAU,eAAe,CACnC,IAAmB,EACnB,WAAmB,EACnB,SAAoB,EACpB,eAAgC;IAEhC,MAAM,OAAO,GAAG,eAAe,CAAC,WAAW,EAAE,IAAI,CAAC,IAAI,CAAC,CAAC;IAExD,YAAY;IACZ,MAAM,MAAM,GAAG,SAAS,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;IACtC,IAAI,KAAe,CAAC;IAEpB,IAAI,MAAM,EAAE,CAAC;QACX,KAAK,GAAG,MAAM,CAAC,KAAK,CAAC;IACvB,CAAC;SAAM,CAAC;QACN,MAAM,OAAO,GAAG,MAAM,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;QACjD,KAAK,GAAG,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;IAC9B,CAAC;IAED,MAAM,KAAK,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,UAAU,GAAG,CAAC,CAAC,CAAC;IAC/C,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,MAAM,EAAE,IAAI,CAAC,QAAQ,CAAC,CAAC;IAElD,IAAI,KAAK,IAAI,KAAK,CAAC,MAAM,IAAI,KAAK,IAAI,GAAG,EAAE,CAAC;QAC1C,OAAO;YACL,OAAO,EAAE,CAAC;oBACR,IAAI,EAAE,MAAM;oBACZ,IAAI,EAAE,uBAAuB,IAAI,CAAC,UAAU,IAAI,IAAI,CAAC,QAAQ,cAAc,KAAK,CAAC,MAAM,SAAS;iBACjG,CAAC;SACH,CAAC;IACJ,CAAC;IAED,MAAM,WAAW,GAAa;QAC5B,SAAS,IAAI,CAAC,IAAI,MAAM,IAAI,CAAC,UAAU,IAAI,IAAI,CAAC,QAAQ,GAAG;QAC3D,EAAE;KACH,CAAC;IAEF,KAAK,IAAI,CAAC,GAAG,KAAK,EAAE,CAAC,GAAG,GAAG,EAAE,CAAC,EAAE,EAAE,CAAC;QACjC,MAAM,OAAO,GAAG,MAAM,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC;QAC1C,WAAW,CAAC,IAAI,CAAC,GAAG,OAAO,MAAM,KAAK,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;IAC/C,CAAC;IAED,MAAM,MAAM,GAAG,WAAW,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACtC,MAAM,MAAM,GAAG,cAAc,CAAC,MAAM,CAAC,CAAC;IAEtC,eAAe,CAAC,SAAS,CAAC,OAAO,EAAE;QACjC,IAAI,EAAE,OAAO;QACb,SAAS,EAAE,IAAI,CAAC,UAAU;QAC1B,OAAO,EAAE,IAAI,CAAC,QAAQ;QACtB,MAAM;KACP,CAAC,CAAC;IAEH,OAAO,EAAE,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC,EAAE,CAAC;AACvD,CAAC"}

package/dist/handlers/read-symbol.d.ts

@@ -0,0 +1,16 @@
+import type { SymbolResolver } from '../core/symbol-resolver.js';
+import type { FileCache } from '../core/file-cache.js';
+import type { ContextRegistry } from '../core/context-registry.js';
+export interface ReadSymbolArgs {
+    path: string;
+    symbol: string;
+    context_before?: number;
+    context_after?: number;
+}
+export declare function handleReadSymbol(args: ReadSymbolArgs, projectRoot: string, symbolResolver: SymbolResolver, fileCache: FileCache, contextRegistry: ContextRegistry): Promise<{
+    content: Array<{
+        type: 'text';
+        text: string;
+    }>;
+}>;
+//# sourceMappingURL=read-symbol.d.ts.map

package/dist/handlers/read-symbol.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"read-symbol.d.ts","sourceRoot":"","sources":["../../src/handlers/read-symbol.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,4BAA4B,CAAC;AACjE,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,uBAAuB,CAAC;AACvD,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,6BAA6B,CAAC;AAInE,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;IACf,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB;AAED,wBAAsB,gBAAgB,CACpC,IAAI,EAAE,cAAc,EACpB,WAAW,EAAE,MAAM,EACnB,cAAc,EAAE,cAAc,EAC9B,SAAS,EAAE,SAAS,EACpB,eAAe,EAAE,eAAe,GAC/B,OAAO,CAAC;IAAE,OAAO,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC,CAAA;CAAE,CAAC,CAiE7D"}

package/dist/handlers/read-symbol.js

@@ -0,0 +1,59 @@
+import { readFile } from 'node:fs/promises';
+import { estimateTokens } from '../core/token-estimator.js';
+import { resolveSafePath } from '../core/validation.js';
+export async function handleReadSymbol(args, projectRoot, symbolResolver, fileCache, contextRegistry) {
+    const absPath = resolveSafePath(projectRoot, args.path);
+    // Get file content
+    const cached = fileCache.get(absPath);
+    let lines;
+    if (cached) {
+        lines = cached.lines;
+    }
+    else {
+        const content = await readFile(absPath, 'utf-8');
+        lines = content.split('\n');
+    }
+    // Resolve symbol
+    const resolved = await symbolResolver.resolve(args.symbol, cached?.structure);
+    if (!resolved) {
+        return {
+            content: [{
+                    type: 'text',
+                    text: `Symbol "${args.symbol}" not found in ${args.path}.\nHINT: Use smart_read("${args.path}") to see available symbols.`,
+                }],
+        };
+    }
+    // Extract source
+    const source = symbolResolver.extractSource(resolved, lines, {
+        contextBefore: args.context_before ?? 2,
+        contextAfter: args.context_after ?? 0,
+    });
+    const loc = `[L${resolved.startLine}-${resolved.endLine}]`;
+    const lineCount = resolved.endLine - resolved.startLine + 1;
+    const outputLines = [
+        `FILE: ${args.path}`,
+        `SYMBOL: ${args.symbol} (${resolved.symbol.kind}) ${loc} (${lineCount} lines)`,
+        '',
+        source,
+    ];
+    // References
+    if (resolved.symbol.references.length > 0) {
+        outputLines.push('');
+        outputLines.push(`REFERENCES: ${resolved.symbol.references.join(', ')}`);
+    }
+    // Build full output including tracking message, THEN estimate tokens
+    outputLines.push('');
+    outputLines.push('CONTEXT TRACKED: This symbol is now in your context.');
+    const output = outputLines.join('\n');
+    const tokens = estimateTokens(output);
+    // Track
+    contextRegistry.trackLoad(absPath, {
+        type: 'symbol',
+        symbolName: args.symbol,
+        startLine: resolved.startLine,
+        endLine: resolved.endLine,
+        tokens,
+    });
+    return { content: [{ type: 'text', text: output }] };
+}
+//# sourceMappingURL=read-symbol.js.map

package/dist/handlers/read-symbol.js.map

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

package/dist/handlers/search-code.d.ts

@@ -0,0 +1,14 @@
+import type { AstIndexClient } from '../ast-index/client.js';
+export interface SearchCodeArgs {
+    query: string;
+    in_file?: string;
+    max_results?: number;
+    fuzzy?: boolean;
+}
+export declare function handleSearchCode(args: SearchCodeArgs, astIndex: AstIndexClient): Promise<{
+    content: Array<{
+        type: 'text';
+        text: string;
+    }>;
+}>;
+//# sourceMappingURL=search-code.d.ts.map

package/dist/handlers/search-code.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"search-code.d.ts","sourceRoot":"","sources":["../../src/handlers/search-code.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,wBAAwB,CAAC;AAE7D,MAAM,WAAW,cAAc;IAC7B,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,KAAK,CAAC,EAAE,OAAO,CAAC;CACjB;AAED,wBAAsB,gBAAgB,CACpC,IAAI,EAAE,cAAc,EACpB,QAAQ,EAAE,cAAc,GACvB,OAAO,CAAC;IAAE,OAAO,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC,CAAA;CAAE,CAAC,CA8B7D"}

package/dist/handlers/search-code.js

@@ -0,0 +1,27 @@
+export async function handleSearchCode(args, astIndex) {
+    const results = await astIndex.search(args.query, {
+        inFile: args.in_file,
+        maxResults: args.max_results ?? 20,
+        fuzzy: args.fuzzy,
+    });
+    if (results.length === 0) {
+        return {
+            content: [{
+                    type: 'text',
+                    text: `No results found for "${args.query}".${args.fuzzy ? '' : '\nHINT: Try fuzzy=true for broader matching.'}`,
+                }],
+        };
+    }
+    const lines = [
+        `SEARCH: "${args.query}" (${results.length} results)`,
+        '',
+    ];
+    for (const r of results) {
+        lines.push(`  ${r.file}:${r.line}`);
+        lines.push(`    ${r.text.trim()}`);
+    }
+    lines.push('');
+    lines.push('HINT: Use read_symbol() or read_range() to load specific results.');
+    return { content: [{ type: 'text', text: lines.join('\n') }] };
+}
+//# sourceMappingURL=search-code.js.map

package/dist/handlers/search-code.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"search-code.js","sourceRoot":"","sources":["../../src/handlers/search-code.ts"],"names":[],"mappings":"AASA,MAAM,CAAC,KAAK,UAAU,gBAAgB,CACpC,IAAoB,EACpB,QAAwB;IAExB,MAAM,OAAO,GAAG,MAAM,QAAQ,CAAC,MAAM,CAAC,IAAI,CAAC,KAAK,EAAE;QAChD,MAAM,EAAE,IAAI,CAAC,OAAO;QACpB,UAAU,EAAE,IAAI,CAAC,WAAW,IAAI,EAAE;QAClC,KAAK,EAAE,IAAI,CAAC,KAAK;KAClB,CAAC,CAAC;IAEH,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACzB,OAAO;YACL,OAAO,EAAE,CAAC;oBACR,IAAI,EAAE,MAAM;oBACZ,IAAI,EAAE,yBAAyB,IAAI,CAAC,KAAK,KAAK,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,8CAA8C,EAAE;iBACjH,CAAC;SACH,CAAC;IACJ,CAAC;IAED,MAAM,KAAK,GAAa;QACtB,YAAY,IAAI,CAAC,KAAK,MAAM,OAAO,CAAC,MAAM,WAAW;QACrD,EAAE;KACH,CAAC;IAEF,KAAK,MAAM,CAAC,IAAI,OAAO,EAAE,CAAC;QACxB,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,IAAI,IAAI,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC;QACpC,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC;IACrC,CAAC;IAED,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACf,KAAK,CAAC,IAAI,CAAC,mEAAmE,CAAC,CAAC;IAEhF,OAAO,EAAE,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,EAAE,CAAC;AACjE,CAAC"}

package/dist/handlers/smart-read-many.d.ts

@@ -0,0 +1,14 @@
+import type { AstIndexClient } from '../ast-index/client.js';
+import type { FileCache } from '../core/file-cache.js';
+import type { ContextRegistry } from '../core/context-registry.js';
+import type { TokenPilotConfig } from '../types.js';
+export interface SmartReadManyArgs {
+    paths: string[];
+}
+export declare function handleSmartReadMany(args: SmartReadManyArgs, projectRoot: string, astIndex: AstIndexClient, fileCache: FileCache, contextRegistry: ContextRegistry, config: TokenPilotConfig): Promise<{
+    content: Array<{
+        type: 'text';
+        text: string;
+    }>;
+}>;
+//# sourceMappingURL=smart-read-many.d.ts.map

package/dist/handlers/smart-read-many.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"smart-read-many.d.ts","sourceRoot":"","sources":["../../src/handlers/smart-read-many.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,wBAAwB,CAAC;AAC7D,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,uBAAuB,CAAC;AACvD,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,6BAA6B,CAAC;AACnE,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAGpD,MAAM,WAAW,iBAAiB;IAChC,KAAK,EAAE,MAAM,EAAE,CAAC;CACjB;AAED,wBAAsB,mBAAmB,CACvC,IAAI,EAAE,iBAAiB,EACvB,WAAW,EAAE,MAAM,EACnB,QAAQ,EAAE,cAAc,EACxB,SAAS,EAAE,SAAS,EACpB,eAAe,EAAE,eAAe,EAChC,MAAM,EAAE,gBAAgB,GACvB,OAAO,CAAC;IAAE,OAAO,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC,CAAA;CAAE,CAAC,CAyC7D"}

package/dist/handlers/smart-read-many.js

@@ -0,0 +1,32 @@
+import { handleSmartRead } from './smart-read.js';
+export async function handleSmartReadMany(args, projectRoot, astIndex, fileCache, contextRegistry, config) {
+    if (!args.paths || args.paths.length === 0) {
+        return {
+            content: [{ type: 'text', text: 'No paths provided.' }],
+        };
+    }
+    if (args.paths.length > 20) {
+        return {
+            content: [{ type: 'text', text: `Too many files (${args.paths.length}). Maximum is 20 per batch.` }],
+        };
+    }
+    const results = [];
+    let totalTokens = 0;
+    for (const path of args.paths) {
+        try {
+            const result = await handleSmartRead({ path }, projectRoot, astIndex, fileCache, contextRegistry, config);
+            const text = result.content[0]?.text ?? '';
+            results.push(text);
+            // Rough count from output length
+            totalTokens += Math.ceil(text.length / 4);
+        }
+        catch (err) {
+            const msg = err instanceof Error ? err.message : String(err);
+            results.push(`FILE: ${path}\nERROR: ${msg}`);
+        }
+    }
+    results.push('');
+    results.push(`BATCH: ${args.paths.length} files loaded (~${totalTokens} tokens total)`);
+    return { content: [{ type: 'text', text: results.join('\n\n---\n\n') }] };
+}
+//# sourceMappingURL=smart-read-many.js.map

package/dist/handlers/smart-read-many.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"smart-read-many.js","sourceRoot":"","sources":["../../src/handlers/smart-read-many.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAC;AAMlD,MAAM,CAAC,KAAK,UAAU,mBAAmB,CACvC,IAAuB,EACvB,WAAmB,EACnB,QAAwB,EACxB,SAAoB,EACpB,eAAgC,EAChC,MAAwB;IAExB,IAAI,CAAC,IAAI,CAAC,KAAK,IAAI,IAAI,CAAC,KAAK,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC3C,OAAO;YACL,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,oBAAoB,EAAE,CAAC;SAExD,CAAC;IACJ,CAAC;IAED,IAAI,IAAI,CAAC,KAAK,CAAC,MAAM,GAAG,EAAE,EAAE,CAAC;QAC3B,OAAO;YACL,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,mBAAmB,IAAI,CAAC,KAAK,CAAC,MAAM,6BAA6B,EAAE,CAAC;SACrG,CAAC;IACJ,CAAC;IAED,MAAM,OAAO,GAAa,EAAE,CAAC;IAC7B,IAAI,WAAW,GAAG,CAAC,CAAC;IAEpB,KAAK,MAAM,IAAI,IAAI,IAAI,CAAC,KAAK,EAAE,CAAC;QAC9B,IAAI,CAAC;YACH,MAAM,MAAM,GAAG,MAAM,eAAe,CAClC,EAAE,IAAI,EAAE,EACR,WAAW,EACX,QAAQ,EACR,SAAS,EACT,eAAe,EACf,MAAM,CACP,CAAC;YACF,MAAM,IAAI,GAAG,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,IAAI,IAAI,EAAE,CAAC;YAC3C,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;YACnB,iCAAiC;YACjC,WAAW,IAAI,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;QAC5C,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,MAAM,GAAG,GAAG,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;YAC7D,OAAO,CAAC,IAAI,CAAC,SAAS,IAAI,YAAY,GAAG,EAAE,CAAC,CAAC;QAC/C,CAAC;IACH,CAAC;IAED,OAAO,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACjB,OAAO,CAAC,IAAI,CAAC,UAAU,IAAI,CAAC,KAAK,CAAC,MAAM,mBAAmB,WAAW,gBAAgB,CAAC,CAAC;IAExF,OAAO,EAAE,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,CAAC,IAAI,CAAC,aAAa,CAAC,EAAE,CAAC,EAAE,CAAC;AAC5E,CAAC"}

package/dist/handlers/smart-read.d.ts

@@ -0,0 +1,18 @@
+import type { AstIndexClient } from '../ast-index/client.js';
+import type { FileCache } from '../core/file-cache.js';
+import type { ContextRegistry } from '../core/context-registry.js';
+import type { TokenPilotConfig } from '../types.js';
+export interface SmartReadArgs {
+    path: string;
+    show_imports?: boolean;
+    show_docs?: boolean;
+    show_references?: boolean;
+    depth?: number;
+}
+export declare function handleSmartRead(args: SmartReadArgs, projectRoot: string, astIndex: AstIndexClient, fileCache: FileCache, contextRegistry: ContextRegistry, config: TokenPilotConfig): Promise<{
+    content: Array<{
+        type: 'text';
+        text: string;
+    }>;
+}>;
+//# sourceMappingURL=smart-read.d.ts.map

package/dist/handlers/smart-read.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"smart-read.d.ts","sourceRoot":"","sources":["../../src/handlers/smart-read.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,wBAAwB,CAAC;AAC7D,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,uBAAuB,CAAC;AACvD,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,6BAA6B,CAAC;AACnE,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAKpD,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,MAAM,CAAC;IACb,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,eAAe,CAAC,EAAE,OAAO,CAAC;IAC1B,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,wBAAsB,eAAe,CACnC,IAAI,EAAE,aAAa,EACnB,WAAW,EAAE,MAAM,EACnB,QAAQ,EAAE,cAAc,EACxB,SAAS,EAAE,SAAS,EACpB,eAAe,EAAE,eAAe,EAChC,MAAM,EAAE,gBAAgB,GACvB,OAAO,CAAC;IAAE,OAAO,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC,CAAA;CAAE,CAAC,CA4F7D"}