token-pilot 0.15.0 → 0.16.1

package/dist/server.js

@@ -19,6 +19,7 @@ const execFilePromise = promisify(execFile);
 import { FileWatcher } from './git/file-watcher.js';
 import { handleSmartRead } from './handlers/smart-read.js';
 import { handleReadSymbol } from './handlers/read-symbol.js';
+import { handleReadSymbols } from './handlers/read-symbols.js';
 import { handleReadRange } from './handlers/read-range.js';
 import { handleReadDiff } from './handlers/read-diff.js';
 import { handleFindUsages } from './handlers/find-usages.js';
@@ -40,7 +41,7 @@ import { estimateTokens } from './core/token-estimator.js';
 import { checkPolicy, isFullReadTool } from './core/policy-engine.js';
 import { MCP_INSTRUCTIONS, TOOL_DEFINITIONS } from './server/tool-definitions.js';
 import { createTokenEstimates } from './server/token-estimates.js';
-import { validateSmartReadArgs, validateReadSymbolArgs, validateReadRangeArgs, validateReadDiffArgs, validateFindUsagesArgs, validateSmartReadManyArgs, validateReadForEditArgs, validateRelatedFilesArgs, validateOutlineArgs, validateFindUnusedArgs, validateCodeAuditArgs, validateProjectOverviewArgs, validateModuleInfoArgs, validateSmartDiffArgs, validateExploreAreaArgs, validateSmartLogArgs, validateTestSummaryArgs, } from './core/validation.js';
+import { validateSmartReadArgs, validateReadSymbolArgs, validateReadSymbolsArgs, validateReadRangeArgs, validateReadDiffArgs, validateFindUsagesArgs, validateSmartReadManyArgs, validateReadForEditArgs, validateRelatedFilesArgs, validateOutlineArgs, validateFindUnusedArgs, validateCodeAuditArgs, validateProjectOverviewArgs, validateModuleInfoArgs, validateSmartDiffArgs, validateExploreAreaArgs, validateSmartLogArgs, validateTestSummaryArgs, } from './core/validation.js';
 export async function createServer(projectRoot, options) {
     const config = await loadConfig(projectRoot);
     const astIndex = new AstIndexClient(projectRoot, config.astIndex.timeout, {
@@ -145,6 +146,7 @@ export async function createServer(projectRoot, options) {
     }
     // Session analytics
     const analytics = new SessionAnalytics();
+    analytics.setProjectRoot(projectRoot);
     // Session cache (tool-result-level caching, invalidated by file/AST/git changes)
     const sessionCache = config.sessionCache.enabled
         ? new SessionCache(config.sessionCache.maxEntries)
@@ -288,6 +290,15 @@ export async function createServer(projectRoot, options) {
                     recordWithTrace({ tool: 'read_symbol', path: symArgs.path, tokensReturned: symTokens, tokensWouldBe: fullTokensSym || symTokens, timestamp: Date.now(), savingsCategory: detectSavingsCategory(symText), absPath: resolve(projectRoot, symArgs.path), args: symArgs });
                     return symResult;
                 }
+                case 'read_symbols': {
+                    const rsArgs = validateReadSymbolsArgs(args);
+                    const rsResult = await handleReadSymbols(rsArgs, projectRoot, symbolResolver, fileCache, contextRegistry, astIndex, config.smartRead.advisoryReminders);
+                    const rsText = rsResult.content[0]?.text ?? '';
+                    const rsTokens = estimateTokens(rsText);
+                    const fullTokensRs = await fullFileTokens(rsArgs.path);
+                    recordWithTrace({ tool: 'read_symbols', path: rsArgs.path, tokensReturned: rsTokens, tokensWouldBe: fullTokensRs || rsTokens, timestamp: Date.now(), savingsCategory: 'compression', absPath: resolve(projectRoot, rsArgs.path), args: rsArgs });
+                    return rsResult;
+                }
                 case 'read_range': {
                     const rangeArgs = validateReadRangeArgs(args);
                     const rangeResult = await handleReadRange(rangeArgs, projectRoot, fileCache, contextRegistry, config.smartRead.advisoryReminders);
@@ -343,7 +354,7 @@ export async function createServer(projectRoot, options) {
                         recordWithTrace({ tool: 'find_usages', path: usagesArgs.symbol, tokensReturned: cachedUsages.tokenEstimate, tokensWouldBe: cachedUsages.tokensWouldBe ?? cachedUsages.tokenEstimate, timestamp: Date.now(), sessionCacheHit: true, savingsCategory: 'cache', args: usagesArgs });
                         return cachedUsages.result;
                     }
-                    const usagesResult = await handleFindUsages(usagesArgs, astIndex);
+                    const usagesResult = await handleFindUsages(usagesArgs, astIndex, projectRoot);
                     const usagesText = usagesResult.content[0]?.text ?? '';
                     const usagesTokens = estimateTokens(usagesText);
                     const usagesWouldBe = await estimateFindUsagesWorkflowTokens(usagesResult.meta.files);
@@ -447,8 +458,10 @@ export async function createServer(projectRoot, options) {
                     });
                     return outlineResult;
                 }
-                case 'session_analytics':
-                    return { content: [{ type: 'text', text: `TOKEN PILOT v${pkgVersion}\n\n${analytics.report()}` }] };
+                case 'session_analytics': {
+                    const verbose = args?.verbose === true;
+                    return { content: [{ type: 'text', text: `TOKEN PILOT v${pkgVersion}\n\n${analytics.report(verbose)}` }] };
+                }
                 case 'find_unused': {
                     const unusedArgs = validateFindUnusedArgs(args);
                     const cachedUnused = sessionCache?.get('find_unused', unusedArgs);

package/package.json

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