@compilr-dev/cli 0.5.2 → 0.5.4

package/dist/tools.d.ts

@@ -14,11 +14,16 @@
  * Tool names are defined in tool-names.ts (a dependency-free module).
  * This file re-exports them for convenience. Import from here or tool-names.ts.
  */
-export { TOOL_NAMES, type ToolName, DIRECT_TOOL_NAMES, META_TOOL_NAMES, META_REGISTRY_TOOL_NAMES, getAllToolNames, } from './tool-names.js';
+export { TOOL_NAMES, type ToolName, DIRECT_TOOL_NAMES, HOT_TOOL_NAMES, WARM_TOOL_NAMES, META_TOOL_NAMES, META_REGISTRY_TOOL_NAMES, getAllToolNames, } from './tool-names.js';
 import { TodoStore, type Tool } from '@compilr-dev/sdk';
 export declare const todoStore: TodoStore;
 import { setMetaToolFilter, getRegisteredMetaTools } from './tools/meta-tools.js';
 export { setMetaToolFilter, getRegisteredMetaTools };
+/**
+ * Check if a tool in the meta-registry is marked as silent.
+ * Used by the repl to suppress output for warm tools like todo_write/todo_read.
+ */
+export declare function isMetaToolSilent(name: string): boolean;
 /**
  * Creates the tool registry with all available tools.
  * Returns tools as-is - the Agent.registerTools() method handles typing.
@@ -32,9 +37,10 @@ export declare function createToolRegistry(): unknown[];
 export declare function createMinimalToolRegistry(): unknown[];
 /**
  * Get direct tools that are always available.
- * These are declared normally and can be called by name.
+ * When hotOnly is true, returns only hot tools (7 tools, ~2.1K tokens).
+ * When false/undefined, returns all direct tools (18 tools, ~5.4K tokens).
  */
-export declare function getDirectTools(): Tool[];
+export declare function getDirectTools(hotOnly?: boolean): Tool[];
 /**
  * Get meta-tools for agent registration.
  * Only get_tool_info is kept as a direct tool — use_tool and list_tools
@@ -47,11 +53,18 @@ export declare function getMetaTools(): Tool[];
  * checks the meta-registry and executes it transparently.
  */
 export declare function createToolFallback(): (name: string, input: Record<string, unknown>) => Promise<import('@compilr-dev/sdk').ToolExecutionResult | null>;
+/**
+ * Check if hot-tools mode is active.
+ * When true, only hot tools are declared as direct schemas; warm tools are in meta-registry.
+ */
+export declare function isHotToolsMode(): boolean;
 /**
  * Initialize the meta-tool registry with specialized tools.
+ * When includeWarmTools is true, warm tools are also added to the meta-registry
+ * (enabling hot-tools mode where only 7 core tools are declared directly).
  * Call this once at startup.
  */
-export declare function initializeMetaTools(): void;
+export declare function initializeMetaTools(includeWarmTools?: boolean): void;
 /**
  * Get the tool index for the system prompt.
  * This lists all meta-registry tools with their signatures.
@@ -71,6 +84,8 @@ export declare function isMetaToolsEnabled(): boolean;
  */
 export declare function getToolStats(): {
     directTools: number;
+    hotTools: number;
+    warmTools: number;
     metaRegistryTools: number;
     totalTools: number;
     estimatedDirectTokens: number;

package/dist/tools.js

@@ -16,7 +16,7 @@
  */
 // Re-export tool names from the dependency-free module
 // This breaks circular dependencies while maintaining a single source of truth
-export { TOOL_NAMES, DIRECT_TOOL_NAMES, META_TOOL_NAMES, META_REGISTRY_TOOL_NAMES, getAllToolNames, } from './tool-names.js';
+export { TOOL_NAMES, DIRECT_TOOL_NAMES, HOT_TOOL_NAMES, WARM_TOOL_NAMES, META_TOOL_NAMES, META_REGISTRY_TOOL_NAMES, getAllToolNames, } from './tool-names.js';
 // =============================================================================
 // TOOL IMPORTS
 // =============================================================================
@@ -132,33 +132,49 @@ import { allDbTools, allFactoryTools } from './tools/db-tools.js';
 import { initializeMetaToolRegistry, generateToolIndex, getMetaToolCount, META_TOOLS_SYSTEM_PROMPT_PREFIX, setMetaToolFilter, getRegisteredMetaTools, createMetaToolFallback, getToolInfoTool, } from './tools/meta-tools.js';
 // Re-export for use in agent.ts
 export { setMetaToolFilter, getRegisteredMetaTools };
+/**
+ * Check if a tool in the meta-registry is marked as silent.
+ * Used by the repl to suppress output for warm tools like todo_write/todo_read.
+ */
+export function isMetaToolSilent(name) {
+    const tools = getRegisteredMetaTools();
+    const tool = tools.find((t) => t.definition.name === name);
+    return tool?.silent === true;
+}
 // =============================================================================
 // DIRECT TOOLS - Always available, called by name
 // =============================================================================
 /**
- * Direct tools are the most frequently used tools.
- * These are always available and can be called directly by name.
- * Estimated: ~3,500 tokens for definitions
+ * Hot tools — used in >50% of turns. Always declared as direct schemas.
+ * Estimated: ~2,100 tokens for definitions
  */
-const DIRECT_TOOLS = [
+const HOT_TOOLS = [
     // File operations (most common)
     readFileTool,
     writeFileTool,
     editTool,
     // Shell (very common)
     bashTool,
-    bashOutputTool,
-    killShellTool,
     // Search (very common)
     globTool,
     grepTool,
-    // Task tracking (always needed)
+    // User interaction (always needed)
+    askUserTool,
+];
+/**
+ * Warm tools — used occasionally. In hot-tools mode these move to meta-registry.
+ * Estimated: ~3,300 tokens for definitions
+ */
+const WARM_TOOLS = [
+    // Shell management
+    bashOutputTool,
+    killShellTool,
+    // Task tracking
     todoWriteTool,
     todoReadTool,
     todoClaimTool,
     todoHandoffTool,
-    // User interaction (always needed)
-    askUserTool,
+    // User interaction (simple variant)
     askUserSimpleTool,
     // Delegation (coordinator only)
     delegateTool,
@@ -166,9 +182,14 @@ const DIRECT_TOOLS = [
     delegateBackgroundTool,
     // Handoff (specialist-to-specialist)
     handoffTool,
-    // CLI documentation (always available)
+    // CLI documentation
     guideTool,
 ];
+/**
+ * All direct tools combined (hot + warm).
+ * Used in legacy mode (no meta-tools) and for backwards compatibility.
+ */
+const DIRECT_TOOLS = [...HOT_TOOLS, ...WARM_TOOLS];
 // =============================================================================
 // META-REGISTRY TOOLS - Available via use_tool()
 // =============================================================================
@@ -248,9 +269,12 @@ export function createMinimalToolRegistry() {
 // =============================================================================
 /**
  * Get direct tools that are always available.
- * These are declared normally and can be called by name.
+ * When hotOnly is true, returns only hot tools (7 tools, ~2.1K tokens).
+ * When false/undefined, returns all direct tools (18 tools, ~5.4K tokens).
  */
-export function getDirectTools() {
+export function getDirectTools(hotOnly) {
+    if (hotOnly)
+        return HOT_TOOLS;
     return DIRECT_TOOLS;
 }
 /**
@@ -269,12 +293,29 @@ export function getMetaTools() {
 export function createToolFallback() {
     return createMetaToolFallback();
 }
+/** Whether hot-tools mode is active (warm tools in meta-registry) */
+let hotToolsModeActive = false;
+/**
+ * Check if hot-tools mode is active.
+ * When true, only hot tools are declared as direct schemas; warm tools are in meta-registry.
+ */
+export function isHotToolsMode() {
+    return hotToolsModeActive;
+}
 /**
  * Initialize the meta-tool registry with specialized tools.
+ * When includeWarmTools is true, warm tools are also added to the meta-registry
+ * (enabling hot-tools mode where only 7 core tools are declared directly).
  * Call this once at startup.
  */
-export function initializeMetaTools() {
-    initializeMetaToolRegistry(META_REGISTRY_TOOLS);
+export function initializeMetaTools(includeWarmTools) {
+    const tools = includeWarmTools
+        ? [...WARM_TOOLS, ...META_REGISTRY_TOOLS]
+        : META_REGISTRY_TOOLS;
+    initializeMetaToolRegistry(tools);
+    if (includeWarmTools) {
+        hotToolsModeActive = true;
+    }
 }
 /**
  * Get the tool index for the system prompt.
@@ -303,16 +344,22 @@ export function isMetaToolsEnabled() {
  * Get tool statistics for debugging/display.
  */
 export function getToolStats() {
-    const directCount = DIRECT_TOOLS.length;
-    const metaCount = META_REGISTRY_TOOLS.length;
-    const totalCount = directCount + metaCount;
+    const hotCount = HOT_TOOLS.length;
+    const warmCount = WARM_TOOLS.length;
+    const directCount = hotToolsModeActive ? hotCount : hotCount + warmCount;
+    const metaCount = hotToolsModeActive
+        ? META_REGISTRY_TOOLS.length + warmCount
+        : META_REGISTRY_TOOLS.length;
+    const totalCount = hotCount + warmCount + META_REGISTRY_TOOLS.length;
     // Rough estimates: ~300 tokens per tool definition
     const tokensPerTool = 300;
     const estimatedDirectTokens = directCount * tokensPerTool;
-    const estimatedMetaTokens = 800; // Tool index + meta-tool definitions
+    const estimatedMetaTokens = 1000; // Tool index + meta-tool definitions
     const estimatedLegacyTokens = totalCount * tokensPerTool;
     return {
         directTools: directCount,
+        hotTools: hotCount,
+        warmTools: warmCount,
         metaRegistryTools: metaCount,
         totalTools: totalCount,
         estimatedDirectTokens,

package/dist/ui/terminal-ui.d.ts

@@ -103,12 +103,12 @@ export declare class TerminalUI extends EventEmitter {
      * Add input/output tokens for live display
      * @param thinkingTokens - Optional thinking tokens (Gemini 2.5+ models)
      * @param cacheReadTokens - Optional cache read tokens (Anthropic/Gemini)
-     * @param debugPayload - Optional debug payload sizes (char counts)
+     * @param debugPayload - Optional debug payload sizes (token estimates)
      */
     addTokens(inputTokens: number, outputTokens: number, thinkingTokens?: number, cacheReadTokens?: number, debugPayload?: {
-        systemChars: number;
-        contentsChars: number;
-        toolsChars: number;
+        systemTokens: number;
+        contentsTokens: number;
+        toolsTokens: number;
     }): void;
     /**
      * Increment tool call counter
@@ -134,9 +134,9 @@ export declare class TerminalUI extends EventEmitter {
         toolCalls: number;
         apiCalls: number;
         debugPayload?: {
-            systemChars: number;
-            contentsChars: number;
-            toolsChars: number;
+            systemTokens: number;
+            contentsTokens: number;
+            toolsTokens: number;
         };
     };
     setMode(mode: AgentMode): void;

package/dist/ui/terminal-ui.js

@@ -339,7 +339,7 @@ export class TerminalUI extends EventEmitter {
      * Add input/output tokens for live display
      * @param thinkingTokens - Optional thinking tokens (Gemini 2.5+ models)
      * @param cacheReadTokens - Optional cache read tokens (Anthropic/Gemini)
-     * @param debugPayload - Optional debug payload sizes (char counts)
+     * @param debugPayload - Optional debug payload sizes (token estimates)
      */
     addTokens(inputTokens, outputTokens, thinkingTokens, cacheReadTokens, debugPayload) {
         this.turnMetrics.addTokens(inputTokens, outputTokens, thinkingTokens, cacheReadTokens, debugPayload);

package/dist/ui/turn-metrics.d.ts

@@ -13,9 +13,9 @@ export interface TurnMetricsSnapshot {
     toolCalls: number;
     apiCalls: number;
     debugPayload?: {
-        systemChars: number;
-        contentsChars: number;
-        toolsChars: number;
+        systemTokens: number;
+        contentsTokens: number;
+        toolsTokens: number;
     };
 }
 export declare class TurnMetrics {
@@ -24,9 +24,9 @@ export declare class TurnMetrics {
     thinkingTokens: number;
     cacheReadTokens: number;
     debugPayload?: {
-        systemChars: number;
-        contentsChars: number;
-        toolsChars: number;
+        systemTokens: number;
+        contentsTokens: number;
+        toolsTokens: number;
     };
     startTime: number;
     toolCalls: number;
@@ -36,12 +36,12 @@ export declare class TurnMetrics {
      * Add input/output tokens for live display.
      * @param thinkingTokens - Optional thinking tokens (Gemini 2.5+ models)
      * @param cacheReadTokens - Optional cache read tokens (Anthropic/Gemini)
-     * @param debugPayload - Optional debug payload sizes (char counts)
+     * @param debugPayload - Optional debug payload sizes (token estimates)
      */
     addTokens(inputTokens: number, outputTokens: number, thinkingTokens?: number, cacheReadTokens?: number, debugPayload?: {
-        systemChars: number;
-        contentsChars: number;
-        toolsChars: number;
+        systemTokens: number;
+        contentsTokens: number;
+        toolsTokens: number;
     }): void;
     incrementToolCalls(): void;
     incrementApiCalls(): void;

package/dist/ui/turn-metrics.js

@@ -18,7 +18,7 @@ export class TurnMetrics {
      * Add input/output tokens for live display.
      * @param thinkingTokens - Optional thinking tokens (Gemini 2.5+ models)
      * @param cacheReadTokens - Optional cache read tokens (Anthropic/Gemini)
-     * @param debugPayload - Optional debug payload sizes (char counts)
+     * @param debugPayload - Optional debug payload sizes (token estimates)
      */
     addTokens(inputTokens, outputTokens, thinkingTokens, cacheReadTokens, debugPayload) {
         this.inputTokens += inputTokens;
@@ -31,11 +31,11 @@ export class TurnMetrics {
         }
         if (debugPayload) {
             if (!this.debugPayload) {
-                this.debugPayload = { systemChars: 0, contentsChars: 0, toolsChars: 0 };
+                this.debugPayload = { systemTokens: 0, contentsTokens: 0, toolsTokens: 0 };
             }
-            this.debugPayload.systemChars += debugPayload.systemChars;
-            this.debugPayload.contentsChars += debugPayload.contentsChars;
-            this.debugPayload.toolsChars += debugPayload.toolsChars;
+            this.debugPayload.systemTokens += debugPayload.systemTokens;
+            this.debugPayload.contentsTokens += debugPayload.contentsTokens;
+            this.debugPayload.toolsTokens += debugPayload.toolsTokens;
         }
     }
     incrementToolCalls() {

package/dist/ui/types.d.ts

@@ -53,11 +53,11 @@ export interface TurnMetrics {
     subagentOutputTokens: number;
     toolCalls: number;
     durationMs: number;
-    /** Debug payload info - char counts sent to provider (for debugging token discrepancies) */
+    /** Debug payload info - token estimates sent to provider */
     debugPayload?: {
-        systemChars: number;
-        contentsChars: number;
-        toolsChars: number;
+        systemTokens: number;
+        contentsTokens: number;
+        toolsTokens: number;
     };
 }
 export interface CommandOption {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@compilr-dev/cli",
-  "version": "0.5.2",
+  "version": "0.5.4",
   "description": "AI-powered coding assistant CLI using @compilr-dev/agents",
   "type": "module",
   "main": "dist/index.js",
@@ -54,11 +54,11 @@
   },
   "dependencies": {
     "@anthropic-ai/sdk": "^0.74.0",
-    "@compilr-dev/agents": "^0.3.20",
-    "@compilr-dev/agents-coding": "^1.0.2",
+    "@compilr-dev/agents": "^0.3.23",
+    "@compilr-dev/agents-coding": "^1.0.4",
     "@compilr-dev/editor-core": "^0.0.2",
-    "@compilr-dev/factory": "^0.1.4",
-    "@compilr-dev/sdk": "^0.1.16",
+    "@compilr-dev/factory": "^0.1.12",
+    "@compilr-dev/sdk": "^0.1.20",
     "@compilr-dev/ui-core": "^0.0.1",
     "@modelcontextprotocol/sdk": "^1.23.0",
     "better-sqlite3": "^12.5.0",