token-pilot 0.42.2 → 0.43.0

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

@@ -92,6 +92,13 @@ export declare const TOOL_DEFINITIONS: ({
             check?: undefined;
             pattern?: undefined;
             name?: undefined;
+            from?: undefined;
+            to?: undefined;
+            all?: undefined;
+            maxPaths?: undefined;
+            maxDepth?: undefined;
+            viaKind?: undefined;
+            format?: undefined;
             ref?: undefined;
             count?: undefined;
             command?: undefined;
@@ -176,6 +183,13 @@ export declare const TOOL_DEFINITIONS: ({
             check?: undefined;
             pattern?: undefined;
             name?: undefined;
+            from?: undefined;
+            to?: undefined;
+            all?: undefined;
+            maxPaths?: undefined;
+            maxDepth?: undefined;
+            viaKind?: undefined;
+            format?: undefined;
             ref?: undefined;
             count?: undefined;
             command?: undefined;
@@ -254,6 +268,13 @@ export declare const TOOL_DEFINITIONS: ({
             check?: undefined;
             pattern?: undefined;
             name?: undefined;
+            from?: undefined;
+            to?: undefined;
+            all?: undefined;
+            maxPaths?: undefined;
+            maxDepth?: undefined;
+            viaKind?: undefined;
+            format?: undefined;
             ref?: undefined;
             count?: undefined;
             command?: undefined;
@@ -328,6 +349,13 @@ export declare const TOOL_DEFINITIONS: ({
             check?: undefined;
             pattern?: undefined;
             name?: undefined;
+            from?: undefined;
+            to?: undefined;
+            all?: undefined;
+            maxPaths?: undefined;
+            maxDepth?: undefined;
+            viaKind?: undefined;
+            format?: undefined;
             ref?: undefined;
             count?: undefined;
             command?: undefined;
@@ -393,6 +421,13 @@ export declare const TOOL_DEFINITIONS: ({
             check?: undefined;
             pattern?: undefined;
             name?: undefined;
+            from?: undefined;
+            to?: undefined;
+            all?: undefined;
+            maxPaths?: undefined;
+            maxDepth?: undefined;
+            viaKind?: undefined;
+            format?: undefined;
             ref?: undefined;
             count?: undefined;
             command?: undefined;
@@ -458,6 +493,13 @@ export declare const TOOL_DEFINITIONS: ({
             check?: undefined;
             pattern?: undefined;
             name?: undefined;
+            from?: undefined;
+            to?: undefined;
+            all?: undefined;
+            maxPaths?: undefined;
+            maxDepth?: undefined;
+            viaKind?: undefined;
+            format?: undefined;
             ref?: undefined;
             count?: undefined;
             command?: undefined;
@@ -547,6 +589,13 @@ export declare const TOOL_DEFINITIONS: ({
             check?: undefined;
             pattern?: undefined;
             name?: undefined;
+            from?: undefined;
+            to?: undefined;
+            all?: undefined;
+            maxPaths?: undefined;
+            maxDepth?: undefined;
+            viaKind?: undefined;
+            format?: undefined;
             ref?: undefined;
             count?: undefined;
             command?: undefined;
@@ -621,6 +670,13 @@ export declare const TOOL_DEFINITIONS: ({
             check?: undefined;
             pattern?: undefined;
             name?: undefined;
+            from?: undefined;
+            to?: undefined;
+            all?: undefined;
+            maxPaths?: undefined;
+            maxDepth?: undefined;
+            viaKind?: undefined;
+            format?: undefined;
             ref?: undefined;
             count?: undefined;
             command?: undefined;
@@ -704,6 +760,13 @@ export declare const TOOL_DEFINITIONS: ({
             check?: undefined;
             pattern?: undefined;
             name?: undefined;
+            from?: undefined;
+            to?: undefined;
+            all?: undefined;
+            maxPaths?: undefined;
+            maxDepth?: undefined;
+            viaKind?: undefined;
+            format?: undefined;
             ref?: undefined;
             count?: undefined;
             command?: undefined;
@@ -770,6 +833,13 @@ export declare const TOOL_DEFINITIONS: ({
             check?: undefined;
             pattern?: undefined;
             name?: undefined;
+            from?: undefined;
+            to?: undefined;
+            all?: undefined;
+            maxPaths?: undefined;
+            maxDepth?: undefined;
+            viaKind?: undefined;
+            format?: undefined;
             ref?: undefined;
             count?: undefined;
             command?: undefined;
@@ -832,6 +902,13 @@ export declare const TOOL_DEFINITIONS: ({
             check?: undefined;
             pattern?: undefined;
             name?: undefined;
+            from?: undefined;
+            to?: undefined;
+            all?: undefined;
+            maxPaths?: undefined;
+            maxDepth?: undefined;
+            viaKind?: undefined;
+            format?: undefined;
             ref?: undefined;
             count?: undefined;
             command?: undefined;
@@ -900,6 +977,13 @@ export declare const TOOL_DEFINITIONS: ({
             check?: undefined;
             pattern?: undefined;
             name?: undefined;
+            from?: undefined;
+            to?: undefined;
+            all?: undefined;
+            maxPaths?: undefined;
+            maxDepth?: undefined;
+            viaKind?: undefined;
+            format?: undefined;
             ref?: undefined;
             count?: undefined;
             command?: undefined;
@@ -962,6 +1046,13 @@ export declare const TOOL_DEFINITIONS: ({
             check?: undefined;
             pattern?: undefined;
             name?: undefined;
+            from?: undefined;
+            to?: undefined;
+            all?: undefined;
+            maxPaths?: undefined;
+            maxDepth?: undefined;
+            viaKind?: undefined;
+            format?: undefined;
             ref?: undefined;
             count?: undefined;
             command?: undefined;
@@ -1027,6 +1118,13 @@ export declare const TOOL_DEFINITIONS: ({
             check?: undefined;
             pattern?: undefined;
             name?: undefined;
+            from?: undefined;
+            to?: undefined;
+            all?: undefined;
+            maxPaths?: undefined;
+            maxDepth?: undefined;
+            viaKind?: undefined;
+            format?: undefined;
             ref?: undefined;
             count?: undefined;
             command?: undefined;
@@ -1095,6 +1193,13 @@ export declare const TOOL_DEFINITIONS: ({
             check?: undefined;
             pattern?: undefined;
             name?: undefined;
+            from?: undefined;
+            to?: undefined;
+            all?: undefined;
+            maxPaths?: undefined;
+            maxDepth?: undefined;
+            viaKind?: undefined;
+            format?: undefined;
             ref?: undefined;
             count?: undefined;
             command?: undefined;
@@ -1170,6 +1275,13 @@ export declare const TOOL_DEFINITIONS: ({
             verbose?: undefined;
             module?: undefined;
             export_only?: undefined;
+            from?: undefined;
+            to?: undefined;
+            all?: undefined;
+            maxPaths?: undefined;
+            maxDepth?: undefined;
+            viaKind?: undefined;
+            format?: undefined;
             ref?: undefined;
             count?: undefined;
             command?: undefined;
@@ -1236,6 +1348,102 @@ export declare const TOOL_DEFINITIONS: ({
             export_only?: undefined;
             pattern?: undefined;
             name?: undefined;
+            from?: undefined;
+            to?: undefined;
+            all?: undefined;
+            maxPaths?: undefined;
+            maxDepth?: undefined;
+            viaKind?: undefined;
+            format?: 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;
+    inputSchema: {
+        type: "object";
+        properties: {
+            from: {
+                type: string;
+                description: string;
+            };
+            to: {
+                type: string;
+                description: string;
+            };
+            all: {
+                type: string;
+                description: string;
+            };
+            maxPaths: {
+                type: string;
+                description: string;
+            };
+            maxDepth: {
+                type: string;
+                description: string;
+            };
+            viaKind: {
+                type: string;
+                enum: string[];
+                description: string;
+            };
+            format: {
+                type: string;
+                enum: string[];
+                description: string;
+            };
+            path?: undefined;
+            show_imports?: undefined;
+            show_docs?: undefined;
+            depth?: undefined;
+            scope?: undefined;
+            max_tokens?: undefined;
+            session_id?: undefined;
+            force?: undefined;
+            symbol?: 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;
@@ -1306,6 +1514,13 @@ export declare const TOOL_DEFINITIONS: ({
             check?: undefined;
             pattern?: undefined;
             name?: undefined;
+            from?: undefined;
+            to?: undefined;
+            all?: undefined;
+            maxPaths?: undefined;
+            maxDepth?: undefined;
+            viaKind?: undefined;
+            format?: undefined;
             count?: undefined;
             command?: undefined;
             runner?: undefined;
@@ -1374,6 +1589,13 @@ export declare const TOOL_DEFINITIONS: ({
             check?: undefined;
             pattern?: undefined;
             name?: undefined;
+            from?: undefined;
+            to?: undefined;
+            all?: undefined;
+            maxPaths?: undefined;
+            maxDepth?: undefined;
+            viaKind?: undefined;
+            format?: undefined;
             ref?: undefined;
             count?: undefined;
             command?: undefined;
@@ -1444,6 +1666,13 @@ export declare const TOOL_DEFINITIONS: ({
             check?: undefined;
             pattern?: undefined;
             name?: undefined;
+            from?: undefined;
+            to?: undefined;
+            all?: undefined;
+            maxPaths?: undefined;
+            maxDepth?: undefined;
+            viaKind?: undefined;
+            format?: undefined;
             command?: undefined;
             runner?: undefined;
             timeout?: undefined;
@@ -1514,6 +1743,13 @@ export declare const TOOL_DEFINITIONS: ({
             check?: undefined;
             pattern?: undefined;
             name?: undefined;
+            from?: undefined;
+            to?: undefined;
+            all?: undefined;
+            maxPaths?: undefined;
+            maxDepth?: undefined;
+            viaKind?: undefined;
+            format?: undefined;
             ref?: undefined;
             count?: undefined;
             goal?: undefined;
@@ -1603,6 +1839,13 @@ export declare const TOOL_DEFINITIONS: ({
             check?: undefined;
             pattern?: undefined;
             name?: undefined;
+            from?: undefined;
+            to?: undefined;
+            all?: undefined;
+            maxPaths?: undefined;
+            maxDepth?: undefined;
+            viaKind?: undefined;
+            format?: undefined;
             ref?: undefined;
             count?: undefined;
             command?: undefined;
@@ -1660,6 +1903,13 @@ export declare const TOOL_DEFINITIONS: ({
             check?: undefined;
             pattern?: undefined;
             name?: undefined;
+            from?: undefined;
+            to?: undefined;
+            all?: undefined;
+            maxPaths?: undefined;
+            maxDepth?: undefined;
+            viaKind?: undefined;
+            format?: undefined;
             ref?: undefined;
             count?: undefined;
             command?: undefined;

package/dist/server/tool-definitions.js

@@ -585,6 +585,46 @@ export const TOOL_DEFINITIONS = [
             required: ["module"],
         },
     },
+    {
+        name: "module_route",
+        description: "Show the transitive dependency path(s) between two modules — how module A reaches module B through the import graph. Use to answer 'how does X depend on Y?', trace coupling, or generate a dependency diagram. format='mermaid'/'dot' emits a diagram; default text lists the hops.",
+        inputSchema: {
+            type: "object",
+            properties: {
+                from: {
+                    type: "string",
+                    description: 'Source module — the one whose dependencies are followed (name or path, e.g. "auth", "apps/api")',
+                },
+                to: {
+                    type: "string",
+                    description: "Target module to reach",
+                },
+                all: {
+                    type: "boolean",
+                    description: "Show all simple paths instead of just the shortest (default: false)",
+                },
+                maxPaths: {
+                    type: "number",
+                    description: "Cap on number of paths returned (default: 50, max: 200)",
+                },
+                maxDepth: {
+                    type: "number",
+                    description: "Cap on path length in hops (default: 20, max: 50)",
+                },
+                viaKind: {
+                    type: "string",
+                    enum: ["api", "implementation", "all"],
+                    description: 'Restrict traversal to a dependency kind (default: "all")',
+                },
+                format: {
+                    type: "string",
+                    enum: ["text", "json", "mermaid", "dot"],
+                    description: 'Output format: "text" (default, hop listing), "json", "mermaid" or "dot" (dependency diagram)',
+                },
+            },
+            required: ["from", "to"],
+        },
+    },
     // --- Diff & exploration ---
     {
         name: "smart_diff",

package/dist/server.js

@@ -34,6 +34,7 @@ import { handleRelatedFiles } from "./handlers/related-files.js";
 import { handleOutline } from "./handlers/outline.js";
 import { handleCodeAudit } from "./handlers/code-audit.js";
 import { handleModuleInfo } from "./handlers/module-info.js";
+import { handleModuleRoute } from "./handlers/module-route.js";
 import { handleSmartDiff } from "./handlers/smart-diff.js";
 import { handleExploreArea } from "./handlers/explore-area.js";
 import { handleSmartLog } from "./handlers/smart-log.js";
@@ -50,9 +51,17 @@ 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, validateCallTreeArgs, 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, validateModuleRouteArgs, validateSmartDiffArgs, validateExploreAreaArgs, validateSmartLogArgs, validateTestSummaryArgs, validateReadSectionArgs, } from "./core/validation.js";
 export async function createServer(projectRoot, options) {
     const mode = options?.enforcementMode ?? "deny";
+    // v0.43.0 — the real Claude Code session id. CC exports it to every
+    // child process (MCP server, hooks, Bash) via CLAUDE_CODE_SESSION_ID —
+    // verified against the 2.1.167 bundle, and it is the exact same value
+    // the PreToolUse hooks receive and the statusline payload carries.
+    // Stamping it on each tool-call row lets the statusline badge attribute
+    // MCP-tool savings to the current session; before this the rows carried
+    // an empty session_id and the badge ignored them, undercounting savings.
+    const ccSessionId = process.env.CLAUDE_CODE_SESSION_ID ?? "";
     const config = await loadConfig(projectRoot);
     const astIndex = new AstIndexClient(projectRoot, config.astIndex.timeout, {
         binaryPath: config.astIndex.binaryPath,
@@ -323,7 +332,7 @@ export async function createServer(projectRoot, options) {
         // future prune/fix decision.
         void appendToolCall(projectRoot, {
             ts: rest.timestamp,
-            session_id: call.sessionId ?? "",
+            session_id: call.sessionId ?? ccSessionId,
             tool: rest.tool,
             path: rest.path,
             tokensReturned: rest.tokensReturned,
@@ -857,6 +866,37 @@ export async function createServer(projectRoot, options) {
                     });
                     return moduleResult;
                 }
+                case "module_route": {
+                    const routeArgs = validateModuleRouteArgs(args);
+                    const cachedRoute = sessionCache?.get("module_route", routeArgs);
+                    if (cachedRoute) {
+                        recordWithTrace({
+                            tool: "module_route",
+                            path: `${routeArgs.from}→${routeArgs.to}`,
+                            tokensReturned: cachedRoute.tokenEstimate,
+                            tokensWouldBe: cachedRoute.tokensWouldBe ?? cachedRoute.tokenEstimate,
+                            timestamp: Date.now(),
+                            sessionCacheHit: true,
+                            savingsCategory: "cache",
+                            args: routeArgs,
+                        });
+                        return cachedRoute.result;
+                    }
+                    const routeResult = await handleModuleRoute(routeArgs, projectRoot, astIndex);
+                    const routeText = routeResult.content[0]?.text ?? "";
+                    const routeTokens = estimateTokens(routeText);
+                    sessionCache?.set("module_route", routeArgs, routeResult, { dependsOnAst: true }, routeTokens, routeTokens);
+                    recordWithTrace({
+                        tool: "module_route",
+                        path: `${routeArgs.from}→${routeArgs.to}`,
+                        tokensReturned: routeTokens,
+                        tokensWouldBe: routeTokens,
+                        timestamp: Date.now(),
+                        savingsCategory: "compression",
+                        args: routeArgs,
+                    });
+                    return routeResult;
+                }
                 case "smart_diff": {
                     const sdArgs = validateSmartDiffArgs(args);
                     const sdResult = await handleSmartDiff(sdArgs, projectRoot, astIndex);

package/docs/tools.md

@@ -1,6 +1,6 @@
 # MCP Tools Reference
 
-Token Pilot exposes 22 MCP tools. All handlers remain active regardless of [tool profile](configuration.md#tool-profiles) — the profile only trims what appears in `tools/list` at session start.
+Token Pilot exposes 23 MCP tools. All handlers remain active regardless of [tool profile](configuration.md#tool-profiles) — the profile only trims what appears in `tools/list` at session start.
 
 ## Reading
 
@@ -26,6 +26,7 @@ Token Pilot exposes 22 MCP tools. All handlers remain active regardless of [tool
 | `find_unused` | manual | Dead code detection — unreferenced exported symbols |
 | `code_audit` | multiple `Grep` | TODOs, deprecated symbols, structural patterns |
 | `module_info` | manual | Deps, dependents, public API, unused deps |
+| `module_route` | manual | Transitive dependency path(s) between two modules; `format=mermaid`/`dot` emits a diagram |
 | `smart_diff` | raw `git diff` | Structural diff with symbol mapping |
 | `explore_area` | 3–5 calls | Structure + imports + tests + recent changes in one call |
 | `smart_log` | raw `git log` | Structured commits with category detection |

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "token-pilot",
-  "version": "0.42.2",
+  "version": "0.43.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",

package/skills/guide/SKILL.md

@@ -3,6 +3,10 @@ name: guide
 description: Show a quick-reference guide for all Token Pilot tools — when to use each one
 command: guide
 user_invocable: true
+# v0.43.0 — effort (Claude Code 2.1.16x) overrides model effort while
+# this skill runs. The guide just renders a static Markdown reference —
+# it needs no reasoning, so `low` keeps it fast and cheap.
+effort: low
 # v0.36.0 — disallowed-tools is a Claude Code 2.1.152+ field that
 # strips the listed tools from the model's surface while this skill
 # is active. The guide just renders Markdown; it never needs Edit /

package/skills/install/SKILL.md

@@ -3,6 +3,10 @@ name: install
 description: Install or check ast-index binary (auto-downloads if missing)
 command: install
 user_invocable: true
+# v0.43.0 — effort (Claude Code 2.1.16x). install drives one
+# `npx token-pilot install-ast-index` Bash call; no reasoning needed,
+# so `low` keeps it fast and cheap.
+effort: low
 # v0.36.0 — disallowed-tools (Claude Code 2.1.152+). The install
 # skill drives one `npx token-pilot install-ast-index` Bash command;
 # nothing else. Keep Bash, block all write/edit/delegation tools so

package/skills/stats/SKILL.md

@@ -3,6 +3,9 @@ name: stats
 description: Show Token Pilot session analytics — token savings, per-tool breakdown, top files, per-agent grouping
 command: stats
 user_invocable: true
+# v0.43.0 — effort (Claude Code 2.1.16x). stats reads the events log and
+# runs `token-pilot stats` variants — no reasoning, so `low` is enough.
+effort: low
 # v0.36.0 — disallowed-tools (Claude Code 2.1.152+). stats only reads
 # the events log and runs `token-pilot stats` variants. No
 # Edit/Write/Task ever — block them defensively.