token-pilot 0.30.5 → 0.32.0

package/dist/server/tool-definitions.d.ts

@@ -977,6 +977,71 @@ export declare const TOOL_DEFINITIONS: ({
         };
         required?: undefined;
     };
+} | {
+    name: string;
+    description: string;
+    inputSchema: {
+        type: "object";
+        properties: {
+            symbol: {
+                type: string;
+                description: string;
+            };
+            depth: {
+                type: string;
+                description: string;
+            };
+            path?: undefined;
+            show_imports?: undefined;
+            show_docs?: undefined;
+            scope?: undefined;
+            max_tokens?: undefined;
+            session_id?: undefined;
+            force?: undefined;
+            context_before?: undefined;
+            context_after?: undefined;
+            show?: undefined;
+            include_edit_context?: undefined;
+            symbols?: undefined;
+            start_line?: undefined;
+            end_line?: undefined;
+            heading?: undefined;
+            context_lines?: undefined;
+            line?: undefined;
+            context?: undefined;
+            include_callers?: undefined;
+            include_tests?: undefined;
+            include_changes?: undefined;
+            section?: undefined;
+            paths?: undefined;
+            kind?: undefined;
+            limit?: undefined;
+            lang?: undefined;
+            mode?: undefined;
+            include?: undefined;
+            recursive?: undefined;
+            max_depth?: undefined;
+            verbose?: undefined;
+            module?: undefined;
+            export_only?: undefined;
+            check?: undefined;
+            pattern?: undefined;
+            name?: undefined;
+            ref?: undefined;
+            count?: undefined;
+            command?: undefined;
+            runner?: undefined;
+            timeout?: undefined;
+            goal?: undefined;
+            decisions?: undefined;
+            confirmed?: undefined;
+            files?: undefined;
+            blocked?: undefined;
+            next?: undefined;
+            sessionId?: undefined;
+        };
+        required: string[];
+    };
 } | {
     name: string;
     description: string;

package/dist/server/tool-definitions.js

@@ -502,6 +502,24 @@ export const TOOL_DEFINITIONS = [
         },
     },
     // --- Analysis ---
+    {
+        name: "call_tree",
+        description: "Recursive depth-N call hierarchy for a function. Shows who calls who transitively — complements find_usages (flat one-level refs) by revealing full chains from leaf helpers to entry points. Use for debugging, refactor impact, and verifying reachability.",
+        inputSchema: {
+            type: "object",
+            properties: {
+                symbol: {
+                    type: "string",
+                    description: "Function / method name, unqualified (e.g. `fetchUser`).",
+                },
+                depth: {
+                    type: "number",
+                    description: "Walk-up depth. Default 3, max 6.",
+                },
+            },
+            required: ["symbol"],
+        },
+    },
     {
         name: "find_unused",
         description: "Find dead code — functions, classes, and variables with no references across the project. Use for cleanup and refactoring.",

package/dist/server.js

@@ -28,6 +28,7 @@ import { handleSmartReadMany } from "./handlers/smart-read-many.js";
 import { handleProjectOverview } from "./handlers/project-overview.js";
 import { handleNonCodeRead, isNonCodeStructured } from "./handlers/non-code.js";
 import { handleFindUnused } from "./handlers/find-unused.js";
+import { handleCallTree } from "./handlers/call-tree.js";
 import { handleReadForEdit } from "./handlers/read-for-edit.js";
 import { handleRelatedFiles } from "./handlers/related-files.js";
 import { handleOutline } from "./handlers/outline.js";
@@ -49,7 +50,7 @@ import { getMcpInstructions, TOOL_DEFINITIONS, } from "./server/tool-definitions
 import { filterToolsByProfile, parseProfileEnv, } from "./server/tool-profiles.js";
 import { STRICT_SMART_READ_MAX_TOKENS, STRICT_EXPLORE_AREA_INCLUDE, } from "./server/enforcement-mode.js";
 import { createTokenEstimates } from "./server/token-estimates.js";
-import { validateSmartReadArgs, validateReadSymbolArgs, validateReadSymbolsArgs, validateReadRangeArgs, validateReadDiffArgs, validateFindUsagesArgs, validateSmartReadManyArgs, validateReadForEditArgs, validateRelatedFilesArgs, validateOutlineArgs, validateFindUnusedArgs, validateCodeAuditArgs, validateProjectOverviewArgs, validateModuleInfoArgs, validateSmartDiffArgs, validateExploreAreaArgs, validateSmartLogArgs, validateTestSummaryArgs, validateReadSectionArgs, } from "./core/validation.js";
+import { validateSmartReadArgs, validateReadSymbolArgs, validateReadSymbolsArgs, validateReadRangeArgs, validateReadDiffArgs, validateFindUsagesArgs, validateSmartReadManyArgs, validateReadForEditArgs, validateRelatedFilesArgs, validateOutlineArgs, validateFindUnusedArgs, validateCallTreeArgs, validateCodeAuditArgs, validateProjectOverviewArgs, validateModuleInfoArgs, validateSmartDiffArgs, validateExploreAreaArgs, validateSmartLogArgs, validateTestSummaryArgs, validateReadSectionArgs, } from "./core/validation.js";
 export async function createServer(projectRoot, options) {
     const mode = options?.enforcementMode ?? "deny";
     const config = await loadConfig(projectRoot);
@@ -726,6 +727,40 @@ export async function createServer(projectRoot, options) {
                         ],
                     };
                 }
+                case "call_tree": {
+                    const callTreeArgs = validateCallTreeArgs(args);
+                    const cachedTree = sessionCache?.get("call_tree", callTreeArgs);
+                    if (cachedTree) {
+                        recordWithTrace({
+                            tool: "call_tree",
+                            path: callTreeArgs.symbol,
+                            tokensReturned: cachedTree.tokenEstimate,
+                            tokensWouldBe: cachedTree.tokensWouldBe ?? cachedTree.tokenEstimate,
+                            timestamp: Date.now(),
+                            sessionCacheHit: true,
+                            savingsCategory: "cache",
+                            args: callTreeArgs,
+                        });
+                        return cachedTree.result;
+                    }
+                    const treeResult = await handleCallTree(callTreeArgs, astIndex);
+                    const treeText = treeResult.content[0]?.text ?? "";
+                    const treeTokens = estimateTokens(treeText);
+                    // No good "wouldBe" baseline for call_tree (you'd otherwise
+                    // run find_usages in a loop). Use a conservative N× multiplier.
+                    const treeWouldBe = treeTokens * 3;
+                    sessionCache?.set("call_tree", callTreeArgs, treeResult, { dependsOnAst: true }, treeTokens, treeWouldBe);
+                    recordWithTrace({
+                        tool: "call_tree",
+                        path: callTreeArgs.symbol,
+                        tokensReturned: treeTokens,
+                        tokensWouldBe: treeWouldBe,
+                        timestamp: Date.now(),
+                        savingsCategory: "compression",
+                        args: callTreeArgs,
+                    });
+                    return treeResult;
+                }
                 case "find_unused": {
                     const unusedArgs = validateFindUnusedArgs(args);
                     const cachedUnused = sessionCache?.get("find_unused", unusedArgs);

package/hooks/hooks.json

@@ -45,6 +45,15 @@
             "command": "node ${CLAUDE_PLUGIN_ROOT}/dist/index.js hook-pre-grep"
           }
         ]
+      },
+      {
+        "matcher": "Task",
+        "hooks": [
+          {
+            "type": "command",
+            "command": "node ${CLAUDE_PLUGIN_ROOT}/dist/index.js hook-pre-task"
+          }
+        ]
       }
     ],
     "SessionStart": [

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "token-pilot",
-  "version": "0.30.5",
+  "version": "0.32.0",
   "description": "Save up to 80% tokens when AI reads code — MCP server for token-efficient code navigation, AST-aware structural reading instead of dumping full files into context window",
   "type": "module",
   "main": "dist/index.js",