codetree-claude 1.4.7 → 1.5.1

package/dist/server/tools/codetree-probe.d.ts

@@ -0,0 +1,53 @@
+import { type CodeTreeConfig } from "../../config.js";
+import type { Indexer } from "../../indexer/indexer.js";
+import type { Database } from "../../storage/database.js";
+export interface ProbeParams {
+    query: string;
+    files?: string[];
+    file_pattern?: string;
+    limit?: number;
+}
+export interface ProbeResult {
+    query: string;
+    hits: Array<{
+        file_path: string;
+        line_numbers: number[];
+    }>;
+    filesScanned: number;
+    truncated: boolean;
+}
+/**
+ * Cheap presence probe — "does X mention Y?". Returns line numbers only,
+ * NEVER returns line content. Massively cheaper than search/read for triage.
+ */
+export declare function createProbeTool(_config: CodeTreeConfig, indexer: Indexer, db: Database): {
+    name: string;
+    description: string;
+    inputSchema: {
+        type: "object";
+        properties: {
+            query: {
+                type: string;
+                description: string;
+            };
+            files: {
+                type: string;
+                items: {
+                    type: string;
+                };
+                description: string;
+            };
+            file_pattern: {
+                type: string;
+                description: string;
+            };
+            limit: {
+                type: string;
+                description: string;
+            };
+        };
+        required: string[];
+    };
+    handler: (params: ProbeParams) => Promise<ProbeResult>;
+};
+//# sourceMappingURL=codetree-probe.d.ts.map

package/dist/server/tools/codetree-probe.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"codetree-probe.d.ts","sourceRoot":"","sources":["../../../src/server/tools/codetree-probe.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,cAAc,EAAE,MAAM,iBAAiB,CAAC;AACtD,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,0BAA0B,CAAC;AACxD,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,2BAA2B,CAAC;AAE1D,MAAM,WAAW,WAAW;IAC1B,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,CAAC,EAAE,MAAM,EAAE,CAAC;IACjB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,WAAW;IAC1B,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,KAAK,CAAC;QAAE,SAAS,EAAE,MAAM,CAAC;QAAC,YAAY,EAAE,MAAM,EAAE,CAAA;KAAE,CAAC,CAAC;IAC3D,YAAY,EAAE,MAAM,CAAC;IACrB,SAAS,EAAE,OAAO,CAAC;CACpB;AAED;;;GAGG;AACH,wBAAgB,eAAe,CAAC,OAAO,EAAE,cAAc,EAAE,OAAO,EAAE,OAAO,EAAE,EAAE,EAAE,QAAQ;;;;;;;;;;;;;;;;;;;;;;;;;;;;sBAiB3D,WAAW,KAAG,OAAO,CAAC,WAAW,CAAC;EAuD7D"}

package/dist/server/tools/codetree-probe.js

@@ -0,0 +1,81 @@
+/**
+ * Cheap presence probe — "does X mention Y?". Returns line numbers only,
+ * NEVER returns line content. Massively cheaper than search/read for triage.
+ */
+export function createProbeTool(_config, indexer, db) {
+    return {
+        name: "codetree_probe",
+        description: "Cheap presence probe. Returns ONLY file paths + line numbers where the query appears. " +
+            "No content snippets. Use to answer 'does file X mention Y?' or 'where is Y referenced?' " +
+            "without paying the token cost of content snippets or full reads.",
+        inputSchema: {
+            type: "object",
+            properties: {
+                query: { type: "string", description: "Substring/identifier to look for (case-insensitive)." },
+                files: { type: "array", items: { type: "string" }, description: "Optional: restrict to these file paths." },
+                file_pattern: { type: "string", description: "Optional: substring pattern on file path." },
+                limit: { type: "number", description: "Max files in response (default 30)." },
+            },
+            required: ["query"],
+        },
+        handler: async (params) => {
+            const limit = params.limit ?? 30;
+            const q = params.query;
+            const qLower = q.toLowerCase();
+            // Candidate file set
+            const MAX_FALLBACK_FILES = 500;
+            let candidatePaths;
+            if (params.files && params.files.length > 0) {
+                candidatePaths = params.files;
+            }
+            else if (q.length >= 3) {
+                const candidates = indexer.filesContainingAny([q]);
+                if (candidates.size === 0) {
+                    // Postings may be cold for non-identifier queries — fall back, but
+                    // bounded to avoid full-corpus scans.
+                    candidatePaths = db.getAllFiles().slice(0, MAX_FALLBACK_FILES).map((f) => f.path);
+                }
+                else {
+                    candidatePaths = Array.from(candidates);
+                }
+            }
+            else {
+                // Too short for postings — bounded scan only.
+                candidatePaths = db.getAllFiles().slice(0, MAX_FALLBACK_FILES).map((f) => f.path);
+            }
+            if (params.file_pattern) {
+                const p = params.file_pattern.toLowerCase();
+                candidatePaths = candidatePaths.filter((fp) => fp.toLowerCase().includes(p));
+            }
+            const hits = [];
+            let filesScanned = 0;
+            let truncated = false;
+            for (const fp of candidatePaths) {
+                if (hits.length >= limit) {
+                    truncated = true;
+                    break;
+                }
+                filesScanned++;
+                const content = indexer.readCached(fp);
+                if (!content)
+                    continue;
+                if (!content.toLowerCase().includes(qLower))
+                    continue;
+                const lines = content.split("\n");
+                const lineNumbers = [];
+                for (let i = 0; i < lines.length; i++) {
+                    if (lines[i].toLowerCase().includes(qLower)) {
+                        lineNumbers.push(i + 1);
+                        if (lineNumbers.length >= 20)
+                            break; // cap per file
+                    }
+                }
+                if (lineNumbers.length > 0) {
+                    hits.push({ file_path: fp, line_numbers: lineNumbers });
+                }
+            }
+            return { query: q, hits, filesScanned, truncated };
+        },
+    };
+}
+//# sourceMappingURL=codetree-probe.js.map

package/dist/server/tools/codetree-probe.js.map

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

package/dist/server/tools/codetree-read.d.ts

@@ -5,20 +5,37 @@ export interface ReadParams {
     file_path: string;
     offset?: number;
     limit?: number;
+    outline_only?: boolean;
+    include_symbols?: boolean;
+    include_content?: boolean;
+    exported_symbols_only?: boolean;
+    symbols_limit?: number;
+    expected_hash?: string;
+    session_id?: string;
+    focus_symbol?: string;
 }
 export interface ReadResult {
-    content: string;
-    source: "memory_cache" | "disk_cache" | "direct_read";
+    content?: string;
+    /** When the file changed and the agent sent expected_hash, this contains a compact diff instead of full content */
+    diff?: string;
+    source: "memory_cache" | "disk_cache" | "direct_read" | "session_unchanged" | "outline" | "diff";
     path: string;
+    hash: string | null;
     lineCount: number;
     size: number;
     language: string | null;
-    symbols: Array<{
+    symbols?: Array<{
         name: string;
         kind: string;
         line: number | null;
         signature: string | null;
     }>;
+    truncated?: boolean;
+    outline_only?: boolean;
+    /** True when the response intentionally omitted the file body (outline_only OR include_content=false OR auto-fallback). */
+    body_omitted?: boolean;
+    unchanged_since_last_read?: boolean;
+    message?: string;
 }
 export declare function createReadTool(config: CodeTreeConfig, indexer: Indexer, db: Database): {
     name: string;
@@ -38,6 +55,38 @@ export declare function createReadTool(config: CodeTreeConfig, indexer: Indexer,
                 type: string;
                 description: string;
             };
+            outline_only: {
+                type: string;
+                description: string;
+            };
+            include_symbols: {
+                type: string;
+                description: string;
+            };
+            include_content: {
+                type: string;
+                description: string;
+            };
+            exported_symbols_only: {
+                type: string;
+                description: string;
+            };
+            symbols_limit: {
+                type: string;
+                description: string;
+            };
+            expected_hash: {
+                type: string;
+                description: string;
+            };
+            session_id: {
+                type: string;
+                description: string;
+            };
+            focus_symbol: {
+                type: string;
+                description: string;
+            };
         };
         required: string[];
     };

package/dist/server/tools/codetree-read.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"codetree-read.d.ts","sourceRoot":"","sources":["../../../src/server/tools/codetree-read.ts"],"names":[],"mappings":"AAEA,OAAO,EAAiB,KAAK,cAAc,EAAE,MAAM,iBAAiB,CAAC;AACrE,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,0BAA0B,CAAC;AACxD,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,2BAA2B,CAAC;AAE1D,MAAM,WAAW,UAAU;IACzB,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,UAAU;IACzB,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,cAAc,GAAG,YAAY,GAAG,aAAa,CAAC;IACtD,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,MAAM,CAAC;IAClB,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,OAAO,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;QAAC,SAAS,EAAE,MAAM,GAAG,IAAI,CAAA;KAAE,CAAC,CAAC;CAC/F;AAED,wBAAgB,cAAc,CAAC,MAAM,EAAE,cAAc,EAAE,OAAO,EAAE,OAAO,EAAE,EAAE,EAAE,QAAQ;;;;;;;;;;;;;;;;;;;;;sBAyBzD,UAAU,KAAG,OAAO,CAAC,UAAU,CAAC;EAyD3D"}
+{"version":3,"file":"codetree-read.d.ts","sourceRoot":"","sources":["../../../src/server/tools/codetree-read.ts"],"names":[],"mappings":"AAEA,OAAO,EAAiB,KAAK,cAAc,EAAE,MAAM,iBAAiB,CAAC;AACrE,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,0BAA0B,CAAC;AACxD,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,2BAA2B,CAAC;AAG1D,MAAM,WAAW,UAAU;IACzB,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,MAAM,CAAC;IAEf,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,eAAe,CAAC,EAAE,OAAO,CAAC;IAC1B,eAAe,CAAC,EAAE,OAAO,CAAC;IAC1B,qBAAqB,CAAC,EAAE,OAAO,CAAC;IAChC,aAAa,CAAC,EAAE,MAAM,CAAC;IAEvB,aAAa,CAAC,EAAE,MAAM,CAAC;IAEvB,UAAU,CAAC,EAAE,MAAM,CAAC;IAGpB,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAED,MAAM,WAAW,UAAU;IACzB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,mHAAmH;IACnH,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,cAAc,GAAG,YAAY,GAAG,aAAa,GAAG,mBAAmB,GAAG,SAAS,GAAG,MAAM,CAAC;IACjG,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IACpB,SAAS,EAAE,MAAM,CAAC;IAClB,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,OAAO,CAAC,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;QAAC,SAAS,EAAE,MAAM,GAAG,IAAI,CAAA;KAAE,CAAC,CAAC;IAC/F,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,2HAA2H;IAC3H,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,yBAAyB,CAAC,EAAE,OAAO,CAAC;IACpC,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,wBAAgB,cAAc,CAAC,MAAM,EAAE,cAAc,EAAE,OAAO,EAAE,OAAO,EAAE,EAAE,EAAE,QAAQ;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;sBA2BzD,UAAU,KAAG,OAAO,CAAC,UAAU,CAAC;EAgR3D"}

package/dist/server/tools/codetree-read.js

@@ -1,35 +1,40 @@
 import { resolve, relative } from "node:path";
-import { readFileSync } from "node:fs";
+import { readFileSync, statSync } from "node:fs";
 import { normalizePath } from "../../config.js";
+import { computeDiff, isDiffWorthSending } from "../../diff.js";
 export function createReadTool(config, indexer, db) {
+    const tk = config.tokenSave.read;
     return {
         name: "codetree_read",
-        description: "Read a file from the CodeTree cache. Much faster and more token-efficient than the native Read tool. " +
-            "Returns the file content along with metadata (symbols, language, line count). " +
-            "Use this instead of Read when CodeTree has cached the file.",
+        description: "Read a file from the CodeTree cache. Token-efficient: returns 'unchanged_since_last_read' " +
+            "when the same session already read the same content (no body re-sent), supports outline_only " +
+            "(symbols/metadata only, no body), and includes the file hash so the agent can avoid re-reads. " +
+            "Use offset/limit to paginate large files. Use outline_only=true for cheap browsing.",
         inputSchema: {
             type: "object",
             properties: {
-                file_path: {
-                    type: "string",
-                    description: "Absolute or project-relative path to the file",
-                },
-                offset: {
-                    type: "number",
-                    description: "Line number to start reading from (0-indexed). Default: 0",
-                },
-                limit: {
-                    type: "number",
-                    description: "Number of lines to read. Default: all lines",
-                },
+                file_path: { type: "string", description: "Absolute or project-relative path." },
+                offset: { type: "number", description: "Line number to start (0-indexed). Default: 0" },
+                limit: { type: "number", description: "Number of lines. Default: all" },
+                outline_only: { type: "boolean", description: "Return symbols + metadata only (no body). Default: false." },
+                include_symbols: { type: "boolean", description: `Include symbol metadata. Default: ${tk.includeSymbolsByDefault}.` },
+                include_content: { type: "boolean", description: "Include file content. Default: true. Set false for cheap probes." },
+                exported_symbols_only: { type: "boolean", description: `Return only exported symbols. Default: ${tk.exportedSymbolsOnlyByDefault}.` },
+                symbols_limit: { type: "number", description: `Cap symbols returned. Default: ${tk.maxSymbols}.` },
+                expected_hash: { type: "string", description: "If provided and matches current hash, returns unchanged with no body. If hash differs, returns a compact diff instead of full content." },
+                session_id: { type: "string", description: "If set, enables 'unchanged since you last read it' short-circuit." },
+                focus_symbol: { type: "string", description: "Auto-narrow to lines containing this symbol (function/class name). Returns only the symbol body + context. Huge token savings on large files." },
             },
             required: ["file_path"],
         },
         handler: async (params) => {
-            // Resolve the path
+            if (!params.file_path) {
+                throw new Error("file_path is required. Use file_path (not file) to specify the file to read.");
+            }
+            // Resolve path
             let absPath;
             let relPath;
-            if (params.file_path.startsWith("/") || params.file_path.match(/^[A-Za-z]:/)) {
+            if (params.file_path.startsWith("/") || /^[A-Za-z]:/.test(params.file_path)) {
                 absPath = resolve(params.file_path);
                 relPath = normalizePath(relative(config.projectRoot, absPath));
             }
@@ -37,44 +42,250 @@ export function createReadTool(config, indexer, db) {
                 relPath = normalizePath(params.file_path);
                 absPath = resolve(config.projectRoot, relPath);
             }
-            // Try cache first
+            const fileRecord = db.getFile(relPath);
+            const includeSymbols = params.include_symbols ?? tk.includeSymbolsByDefault;
+            const includeContent = params.include_content ?? true;
+            const exportedOnly = params.exported_symbols_only ?? tk.exportedSymbolsOnlyByDefault;
+            const symbolsCap = params.symbols_limit ?? tk.maxSymbols;
+            const outlineOnly = params.outline_only === true;
+            // Helper to fetch + trim symbols
+            const buildSymbols = (rangeStart, rangeEnd) => {
+                if (!includeSymbols)
+                    return undefined;
+                let symbols = db.getSymbolsForFile(relPath);
+                if (exportedOnly)
+                    symbols = symbols.filter((s) => s.exported);
+                if (rangeStart !== undefined && rangeEnd !== undefined) {
+                    symbols = symbols.filter((s) => s.line_start !== null && s.line_start >= rangeStart + 1 && s.line_start <= rangeEnd);
+                }
+                if (symbolsCap > 0 && symbols.length > symbolsCap)
+                    symbols = symbols.slice(0, symbolsCap);
+                return symbols.map((s) => ({
+                    name: s.name,
+                    kind: s.kind,
+                    line: s.line_start,
+                    signature: s.signature,
+                }));
+            };
+            // ── Unchanged-since-last-read short-circuit (token-saver) ────
+            if (tk.unchangedShortCircuit &&
+                fileRecord &&
+                params.session_id &&
+                !outlineOnly && includeContent) {
+                try {
+                    const lastReadAt = db.getLastSessionReadAt(params.session_id, relPath);
+                    if (lastReadAt > 0 && lastReadAt >= fileRecord.mtime_ms) {
+                        // Verify file still exists on disk and the mtime really matches what
+                        // we have in the index — guards against stale fileRecord (e.g. file
+                        // deleted or modified between watcher trigger and this call).
+                        let stillValid = false;
+                        try {
+                            const st = statSync(absPath);
+                            stillValid = Math.floor(st.mtimeMs) === fileRecord.mtime_ms;
+                        }
+                        catch {
+                            stillValid = false;
+                        }
+                        if (stillValid) {
+                            return {
+                                source: "session_unchanged",
+                                path: relPath,
+                                hash: fileRecord.hash,
+                                lineCount: fileRecord.line_count,
+                                size: fileRecord.size,
+                                language: fileRecord.language,
+                                symbols: buildSymbols(),
+                                unchanged_since_last_read: true,
+                                message: "Unchanged since you last read it this session. Use prior content; no re-read needed.",
+                            };
+                        }
+                        // Otherwise, fall through to a real read (will re-index as needed)
+                    }
+                }
+                catch { /* ignore */ }
+            }
+            // ── expected_hash short-circuit ───────────────────────────────
+            if (fileRecord && params.expected_hash && params.expected_hash === fileRecord.hash) {
+                return {
+                    source: "session_unchanged",
+                    path: relPath,
+                    hash: fileRecord.hash,
+                    lineCount: fileRecord.line_count,
+                    size: fileRecord.size,
+                    language: fileRecord.language,
+                    symbols: buildSymbols(),
+                    unchanged_since_last_read: true,
+                    message: "Hash matches expected_hash; content unchanged.",
+                };
+            }
+            // ── Diff-based read: file changed but agent has prior version ──
+            if (fileRecord &&
+                params.expected_hash &&
+                params.expected_hash !== fileRecord.hash &&
+                includeContent && !outlineOnly) {
+                // Agent sent a hash that doesn't match — file changed.
+                // Try to return a diff instead of the full content.
+                const newContent = indexer.readCached(relPath) || (() => {
+                    try {
+                        return readFileSync(absPath, "utf-8");
+                    }
+                    catch {
+                        return null;
+                    }
+                })();
+                if (newContent) {
+                    // We need the old content to compute diff.
+                    // Look up old content from the content cache by hash.
+                    // If we can't get old content, fall through to full read.
+                    const oldContent = db.getCachedContentByHash(params.expected_hash);
+                    if (oldContent) {
+                        const diffResult = computeDiff(oldContent, newContent);
+                        const newBytes = Buffer.byteLength(newContent, "utf-8");
+                        if (isDiffWorthSending(diffResult, newBytes)) {
+                            // Log read for session memory
+                            try {
+                                const sid = params.session_id || db.getRecentSessions(1)[0]?.id;
+                                if (sid)
+                                    db.logSessionRead(sid, relPath, "codetree_read");
+                            }
+                            catch { /* ignore */ }
+                            const diffBytes = Buffer.byteLength(diffResult.compactDiff, "utf-8");
+                            const pctSmaller = newBytes > 0
+                                ? Math.max(0, Math.round((1 - diffBytes / newBytes) * 100))
+                                : 0;
+                            return {
+                                diff: diffResult.compactDiff,
+                                source: "diff",
+                                path: relPath,
+                                hash: fileRecord.hash,
+                                lineCount: fileRecord.line_count,
+                                size: fileRecord.size,
+                                language: fileRecord.language,
+                                symbols: buildSymbols(),
+                                message: `File changed (${diffResult.totalChanged} lines). Diff sent instead of full content (${pctSmaller}% smaller).`,
+                            };
+                        }
+                    }
+                }
+                // Fall through to full content read if diff isn't possible/worth it
+            }
+            // ── Outline-only path: return metadata + symbols, no body ───
+            if (outlineOnly || !includeContent) {
+                const symbols = buildSymbols();
+                // Log the read for session memory
+                try {
+                    const sid = params.session_id || db.getRecentSessions(1)[0]?.id;
+                    if (sid)
+                        db.logSessionRead(sid, relPath, "codetree_read");
+                }
+                catch { /* ignore */ }
+                return {
+                    source: "outline",
+                    path: relPath,
+                    hash: fileRecord?.hash ?? null,
+                    lineCount: fileRecord?.line_count ?? 0,
+                    size: fileRecord?.size ?? 0,
+                    language: fileRecord?.language ?? null,
+                    symbols,
+                    // Only echo `outline_only` when the caller actually asked for it.
+                    // Always set body_omitted so agents have one stable field to check.
+                    outline_only: outlineOnly ? true : undefined,
+                    body_omitted: true,
+                };
+            }
+            // ── Get content (cache → disk) ───────────────────────────────
             let content = indexer.readCached(relPath);
             let source = "memory_cache";
             if (!content) {
-                // Direct read as fallback
                 try {
                     content = readFileSync(absPath, "utf-8");
                     source = "direct_read";
-                    // Trigger background indexing of this file
                     indexer.indexFile(absPath);
                 }
-                catch (err) {
+                catch {
                     throw new Error(`Failed to read file: ${absPath}`);
                 }
             }
-            // Apply offset/limit
-            if (params.offset !== undefined || params.limit !== undefined) {
+            // ── focus_symbol: auto-narrow to a specific symbol's body ──
+            if (params.focus_symbol && !params.offset && !params.limit) {
+                const allSymbols = db.getSymbolsForFile(relPath);
+                const target = allSymbols.find((s) => s.name === params.focus_symbol || s.name.endsWith(`.${params.focus_symbol}`));
+                if (target && target.line_start !== null) {
+                    const lines = content.split("\n");
+                    const contextLines = 3;
+                    const start = Math.max(0, target.line_start - 1 - contextLines);
+                    const end = Math.min(lines.length, (target.line_end ?? target.line_start + 20) + contextLines);
+                    const focused = lines.slice(start, end).join("\n");
+                    // Log read
+                    try {
+                        const sid = params.session_id || db.getRecentSessions(1)[0]?.id;
+                        if (sid)
+                            db.logSessionRead(sid, relPath, "codetree_read", start, end);
+                    }
+                    catch { /* ignore */ }
+                    return {
+                        content: focused,
+                        source,
+                        path: relPath,
+                        hash: fileRecord?.hash ?? null,
+                        lineCount: end - start,
+                        size: Buffer.byteLength(focused, "utf-8"),
+                        language: fileRecord?.language ?? null,
+                        symbols: [target].map((s) => ({
+                            name: s.name, kind: s.kind, line: s.line_start, signature: s.signature,
+                        })),
+                        message: `Focused on ${target.kind} "${target.name}" (lines ${start + 1}-${end}). Full file: ${fileRecord?.line_count ?? lines.length} lines.`,
+                    };
+                }
+            }
+            const hasRange = params.offset !== undefined || params.limit !== undefined;
+            let rangeStart = 0;
+            let rangeEnd = Infinity;
+            if (hasRange) {
                 const lines = content.split("\n");
-                const start = params.offset ?? 0;
-                const end = params.limit ? start + params.limit : lines.length;
-                content = lines.slice(start, end).join("\n");
+                rangeStart = Math.max(0, params.offset ?? 0);
+                // Cap any single-call slice so a runaway `limit` (e.g. 999_999) on a
+                // huge file can't bypass the outline-fallback budget.
+                const MAX_LINES_PER_CALL = 5000;
+                const requestedLimit = params.limit ?? (lines.length - rangeStart);
+                const safeLimit = Math.min(requestedLimit, MAX_LINES_PER_CALL);
+                rangeEnd = rangeStart + safeLimit;
+                content = lines.slice(rangeStart, rangeEnd).join("\n");
             }
-            // Get metadata
-            const fileRecord = db.getFile(relPath);
-            const symbols = db.getSymbolsForFile(relPath);
+            // Log read for session memory
+            try {
+                const sid = params.session_id || db.getRecentSessions(1)[0]?.id;
+                if (sid) {
+                    db.logSessionRead(sid, relPath, "codetree_read", rangeStart || undefined, hasRange ? rangeEnd : undefined);
+                }
+            }
+            catch { /* ignore */ }
+            const slicedSize = Buffer.byteLength(content, "utf-8");
+            // ── Auto-degrade to outline if content is huge and no range ─
+            if (!hasRange && slicedSize > tk.outlineFallbackBytes) {
+                const symbols = buildSymbols();
+                return {
+                    source: "outline",
+                    path: relPath,
+                    hash: fileRecord?.hash ?? null,
+                    lineCount: fileRecord?.line_count ?? content.split("\n").length,
+                    size: fileRecord?.size ?? slicedSize,
+                    language: fileRecord?.language ?? null,
+                    symbols,
+                    body_omitted: true,
+                    message: `[outline auto: file is ${(slicedSize / 1024).toFixed(0)}KB; pass offset/limit for content]`,
+                };
+            }
+            const slicedLineCount = content.split("\n").length;
             return {
                 content,
                 source,
                 path: relPath,
-                lineCount: fileRecord?.line_count ?? content.split("\n").length,
-                size: fileRecord?.size ?? Buffer.byteLength(content, "utf-8"),
+                hash: fileRecord?.hash ?? null,
+                lineCount: hasRange ? slicedLineCount : (fileRecord?.line_count ?? slicedLineCount),
+                size: hasRange ? slicedSize : (fileRecord?.size ?? slicedSize),
                 language: fileRecord?.language ?? null,
-                symbols: symbols.map((s) => ({
-                    name: s.name,
-                    kind: s.kind,
-                    line: s.line_start,
-                    signature: s.signature,
-                })),
+                symbols: buildSymbols(rangeStart, rangeEnd === Infinity ? undefined : rangeEnd),
             };
         },
     };

package/dist/server/tools/codetree-read.js.map

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

package/dist/server/tools/codetree-search.d.ts

@@ -7,6 +7,8 @@ export interface SearchParams {
     file_pattern?: string;
     limit?: number;
     content_search?: boolean;
+    include_signature?: boolean;
+    cursor?: number;
 }
 export interface SearchResult {
     symbols: Array<{
@@ -14,7 +16,7 @@ export interface SearchResult {
         kind: string;
         file_path: string;
         line_start: number | null;
-        signature: string | null;
+        signature?: string | null;
         exported: boolean;
     }>;
     content_matches?: Array<{
@@ -24,6 +26,8 @@ export interface SearchResult {
     }>;
     totalResults: number;
     source: "index";
+    next_cursor?: number;
+    truncated?: boolean;
 }
 export declare function createSearchTool(config: CodeTreeConfig, indexer: Indexer, db: Database): {
     name: string;
@@ -51,6 +55,14 @@ export declare function createSearchTool(config: CodeTreeConfig, indexer: Indexe
                 type: string;
                 description: string;
             };
+            include_signature: {
+                type: string;
+                description: string;
+            };
+            cursor: {
+                type: string;
+                description: string;
+            };
         };
         required: string[];
     };

package/dist/server/tools/codetree-search.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"codetree-search.d.ts","sourceRoot":"","sources":["../../../src/server/tools/codetree-search.ts"],"names":[],"mappings":"AAAA,OAAO,EAAiB,KAAK,cAAc,EAAE,MAAM,iBAAiB,CAAC;AACrE,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,0BAA0B,CAAC;AACxD,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,2BAA2B,CAAC;AAE1D,MAAM,WAAW,YAAY;IAC3B,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,cAAc,CAAC,EAAE,OAAO,CAAC;CAC1B;AAED,MAAM,WAAW,YAAY;IAC3B,OAAO,EAAE,KAAK,CAAC;QACb,IAAI,EAAE,MAAM,CAAC;QACb,IAAI,EAAE,MAAM,CAAC;QACb,SAAS,EAAE,MAAM,CAAC;QAClB,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;QAC1B,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;QACzB,QAAQ,EAAE,OAAO,CAAC;KACnB,CAAC,CAAC;IACH,eAAe,CAAC,EAAE,KAAK,CAAC;QACtB,SAAS,EAAE,MAAM,CAAC;QAClB,WAAW,EAAE,MAAM,CAAC;QACpB,YAAY,EAAE,MAAM,CAAC;KACtB,CAAC,CAAC;IACH,YAAY,EAAE,MAAM,CAAC;IACrB,MAAM,EAAE,OAAO,CAAC;CACjB;AAED,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,cAAc,EAAE,OAAO,EAAE,OAAO,EAAE,EAAE,EAAE,QAAQ;;;;;;;;;;;;;;;;;;;;;;;;;;;;;sBAiC3D,YAAY,KAAG,OAAO,CAAC,YAAY,CAAC;EA+D/D"}
+{"version":3,"file":"codetree-search.d.ts","sourceRoot":"","sources":["../../../src/server/tools/codetree-search.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,cAAc,EAAE,MAAM,iBAAiB,CAAC;AACtD,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,0BAA0B,CAAC;AACxD,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,2BAA2B,CAAC;AAG1D,MAAM,WAAW,YAAY;IAC3B,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB,iBAAiB,CAAC,EAAE,OAAO,CAAC;IAC5B,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,YAAY;IAC3B,OAAO,EAAE,KAAK,CAAC;QACb,IAAI,EAAE,MAAM,CAAC;QACb,IAAI,EAAE,MAAM,CAAC;QACb,SAAS,EAAE,MAAM,CAAC;QAClB,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;QAC1B,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;QAC1B,QAAQ,EAAE,OAAO,CAAC;KACnB,CAAC,CAAC;IACH,eAAe,CAAC,EAAE,KAAK,CAAC;QACtB,SAAS,EAAE,MAAM,CAAC;QAClB,WAAW,EAAE,MAAM,CAAC;QACpB,YAAY,EAAE,MAAM,CAAC;KACtB,CAAC,CAAC;IACH,YAAY,EAAE,MAAM,CAAC;IACrB,MAAM,EAAE,OAAO,CAAC;IAChB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,SAAS,CAAC,EAAE,OAAO,CAAC;CACrB;AAED,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,cAAc,EAAE,OAAO,EAAE,OAAO,EAAE,EAAE,EAAE,QAAQ;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;sBAsB3D,YAAY,KAAG,OAAO,CAAC,YAAY,CAAC;EA8G/D"}