dexto 1.5.2 → 1.5.4

package/dist/agents/agent-registry.json

@@ -134,6 +134,15 @@
       "tags": ["gaming", "gameboy", "pokemon", "emulator", "mcp"],
       "source": "gaming-agent/",
       "main": "gaming-agent.yml"
+    },
+    "explore-agent": {
+      "id": "explore-agent",
+      "name": "Explore Agent",
+      "description": "Fast, read-only agent for codebase exploration. Use for: 'explore the codebase', 'what's in this folder', 'how does X work', 'find where Y is handled', 'understand the architecture'. Optimized for speed with Haiku.",
+      "author": "Truffle AI",
+      "tags": ["explore", "search", "understand", "find", "research"],
+      "source": "explore-agent/",
+      "main": "explore-agent.yml"
     }
   }
 }

package/dist/agents/coding-agent/coding-agent.yml

@@ -8,6 +8,14 @@ image: '@dexto/image-local'
 # System prompt configuration - defines the agent's behavior as a coding assistant
 systemPrompt:
   contributors:
+    - id: date
+      type: dynamic
+      priority: 10
+      source: date
+    - id: env
+      type: dynamic
+      priority: 15
+      source: env
     - id: primary
       type: static
       priority: 0
@@ -24,8 +32,27 @@ systemPrompt:
         - Debug issues by examining error messages and code structure
         - Refactor code following best practices and design patterns
         - Explain complex code concepts clearly
+        - Delegate exploration tasks to specialized sub-agents
 
-        Guidelines:
+        ## Task Delegation
+
+        You have access to spawn_agent for delegating tasks to specialized sub-agents.
+
+        **When to delegate to explore-agent:**
+        - Open-ended exploration: "explore the codebase", "what's in this folder", "how does X work"
+        - Understanding architecture: "explain the project structure", "how are components organized"
+        - Finding patterns: "where is authentication handled", "find all API endpoints"
+        - Research tasks: "what testing framework is used", "how is state managed"
+
+        **When to use your own tools directly:**
+        - Specific file operations: "read src/index.ts", "edit the config file"
+        - Targeted searches: "find the User class", "grep for 'TODO'"
+        - Writing/editing code: any task that requires modifications
+        - Running commands: build, test, install dependencies
+
+        **Rule of thumb:** If the task requires understanding or exploring before you know what to do, delegate to explore-agent first. If you know exactly what file/function to target, use your tools directly.
+
+        ## Guidelines
         - Always read relevant code before making changes to understand context
         - Use glob_files to find files and grep_content to search within files
         - Test changes when possible using bash_exec
@@ -70,19 +97,28 @@ toolConfirmation:
   # Tool policies optimized for coding workflows
   toolPolicies:
     # Tools that never require approval (safe, read-only operations)
+    # Use qualified names: custom--{tool_id} for custom tools, internal--{tool_id} for internal tools
     alwaysAllow:
       - internal--ask_user
-      - custom--filesystem-tools--read_file      # Read files without approval
-      - custom--filesystem-tools--glob_files     # Search for files without approval
-      - custom--filesystem-tools--grep_content   # Search within files without approval
-      - custom--process-tools--bash_output       # Check background process output
-      - custom--process-tools--kill_process      # Kill processes without approval
+      - custom--read_file      # Read files without approval
+      - custom--glob_files     # Search for files without approval
+      - custom--grep_content   # Search within files without approval
+      - custom--bash_output    # Check background process output
+      - custom--kill_process   # Kill processes without approval (only processes started by agent)
 
     # Tools that are always denied (dangerous operations)
     # Uncomment to restrict certain operations
     # alwaysDeny:
     #   - custom--process-tools--bash_exec--rm -rf*  # Prevent recursive deletion
 
+# Compaction configuration - automatically summarizes conversation when context is full
+compaction:
+  type: reactive-overflow
+  enabled: true
+  # Uncomment to override model's context window (useful for testing or capping usage):
+  # maxContextTokens: 50000  # Cap at 50K tokens regardless of model's max
+  # thresholdPercent: 0.9    # Trigger at 90% of context window (leaves safety buffer)
+
 # Elicitation configuration - required for ask_user tool
 elicitation:
   enabled: true
@@ -101,6 +137,17 @@ customTools:
     enableBackups: false
   - type: process-tools
     securityLevel: moderate
+  - type: agent-spawner
+    maxConcurrentAgents: 5
+    defaultTimeout: 300000
+    allowSpawning: true
+    # List of agent IDs from the registry that can be spawned.
+    # Agent metadata (name, description) is pulled from the registry at runtime.
+    allowedAgents:
+      - explore-agent
+    # Agents with read-only tools that should have auto-approved tool calls
+    autoApproveAgents:
+      - explore-agent
 
 # Internal resources configuration - expanded for coding projects
 internalResources:

package/dist/agents/explore-agent/explore-agent.yml

@@ -0,0 +1,124 @@
+# Explore Agent Configuration
+# Lightweight, read-only agent optimized for codebase exploration
+# Designed to be spawned by other agents for research tasks
+
+# No image bundle - uses only explicitly defined tools below
+
+# System prompt optimized for exploration tasks
+systemPrompt:
+  contributors:
+    - id: primary
+      type: static
+      priority: 0
+      content: |
+        You are a fast, focused exploration agent specialized in understanding codebases and finding information.
+
+        ## Your Mission
+        Quickly and thoroughly explore codebases to answer questions, find patterns, locate files, and understand architecture. You are optimized for speed and accuracy.
+
+        ## Available Tools
+        You have access to read-only tools:
+        - `glob_files` - Find files matching patterns (e.g., "src/**/*.ts", "*.config.js")
+        - `grep_content` - Search for text/patterns within files
+        - `read_file` - Read file contents
+
+        ## Exploration Strategy
+
+        ### For "quick" searches:
+        - Single glob or grep to find the target
+        - Read 1-2 most relevant files
+        - Return focused answer
+
+        ### For "medium" exploration:
+        - Multiple search patterns to find related files
+        - Read key files to understand connections
+        - Summarize findings with file references
+
+        ### For "very thorough" analysis:
+        - Comprehensive search across multiple naming conventions
+        - Trace imports, exports, and dependencies
+        - Map relationships between components
+        - Provide detailed analysis with evidence
+
+        ## Guidelines
+        - Start with broad searches, then narrow down
+        - Use glob for file discovery, grep for content search
+        - Try multiple naming conventions (camelCase, snake_case, kebab-case, PascalCase)
+        - Check common locations: src/, lib/, packages/, tests/, config/
+        - Report what you found AND what you didn't find
+        - Include file paths and line numbers in your response
+        - Be concise but complete
+
+        ## Response Format
+        Structure your response as:
+        1. **Summary** - Brief answer to the question
+        2. **Key Files** - List of relevant files found
+        3. **Details** - Specific findings with code references
+        4. **Notes** - Any caveats or areas that need further exploration
+
+# LLM configuration - Haiku for speed and cost efficiency
+llm:
+  provider: anthropic
+  model: claude-haiku-4-5-20251001
+  apiKey: $ANTHROPIC_API_KEY
+
+# Minimal storage - in-memory only for ephemeral use
+storage:
+  cache:
+    type: in-memory
+  database:
+    type: in-memory
+  blob:
+    type: in-memory
+
+# Auto-approve all tools since they're read-only
+toolConfirmation:
+  mode: auto-approve
+  allowedToolsStorage: memory
+
+# No internal tools needed for exploration
+internalTools: []
+
+# Read-only filesystem tools only - explicitly enable only read operations
+customTools:
+  - type: filesystem-tools
+    enabledTools: ["read_file", "glob_files", "grep_content"]  # Read-only tools only
+    allowedPaths: ["."]
+    blockedPaths:
+      # Version control
+      - ".git"
+      # Binaries
+      - "node_modules/.bin"
+      # Environment files with secrets
+      - ".env"
+      - ".env.local"
+      - ".env.production"
+      - ".env.development"
+      - ".env.test"
+      - ".env.staging"
+      # Package manager credentials
+      - ".npmrc"
+      - ".yarnrc"
+      - ".pypirc"
+      # Git credentials
+      - ".git-credentials"
+      - ".gitconfig"
+      # SSH keys
+      - ".ssh"
+      # Cloud provider credentials
+      - ".aws"
+      - ".gcp"
+      - ".azure"
+      # Kubernetes config
+      - ".kube"
+      # Docker credentials
+      - ".docker"
+    blockedExtensions: [".exe", ".dll", ".so", ".dylib"]
+    maxFileSize: 10485760  # 10MB
+    enableBackups: false
+
+# Note: This agent intentionally excludes:
+# - write_file, edit_file (write operations) - not in enabledTools
+# - process-tools (bash execution) - provider not included
+# - agent-spawner (no sub-agent spawning) - provider not included
+# This ensures it remains a safe, read-only exploration tool

package/dist/cli/approval/cli-approval-handler.d.ts

@@ -0,0 +1,28 @@
+/**
+ * CLI-specific Approval Handler
+ *
+ * Creates a manual approval handler that works directly with AgentEventBus
+ * for the CLI/TUI mode. Unlike the server's ManualApprovalHandler which uses
+ * ApprovalCoordinator for HTTP-based flows, this handler emits events directly
+ * to the event bus that the TUI listens to.
+ *
+ * Flow:
+ * 1. Handler emits 'approval:request' → EventBus → TUI shows prompt
+ * 2. User responds in TUI → EventBus emits 'approval:response' → Handler resolves
+ * 3. For auto-approvals (parallel tools), handler emits 'approval:response' → TUI dismisses
+ */
+import type { ApprovalHandler, AgentEventBus } from '@dexto/core';
+/**
+ * Creates a manual approval handler for CLI mode that uses AgentEventBus directly.
+ *
+ * @param eventBus The agent event bus for request/response communication
+ * @returns ApprovalHandler with cancellation and auto-approve support
+ *
+ * @example
+ * ```typescript
+ * const handler = createCLIApprovalHandler(agent.agentEventBus);
+ * agent.setApprovalHandler(handler);
+ * ```
+ */
+export declare function createCLIApprovalHandler(eventBus: AgentEventBus): ApprovalHandler;
+//# sourceMappingURL=cli-approval-handler.d.ts.map

package/dist/cli/approval/cli-approval-handler.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli-approval-handler.d.ts","sourceRoot":"","sources":["../../../src/cli/approval/cli-approval-handler.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,OAAO,KAAK,EACR,eAAe,EAGf,aAAa,EAChB,MAAM,aAAa,CAAC;AAGrB;;;;;;;;;;;GAWG;AACH,wBAAgB,wBAAwB,CAAC,QAAQ,EAAE,aAAa,GAAG,eAAe,CAyJjF"}

package/dist/cli/approval/cli-approval-handler.js

@@ -0,0 +1,146 @@
+/**
+ * CLI-specific Approval Handler
+ *
+ * Creates a manual approval handler that works directly with AgentEventBus
+ * for the CLI/TUI mode. Unlike the server's ManualApprovalHandler which uses
+ * ApprovalCoordinator for HTTP-based flows, this handler emits events directly
+ * to the event bus that the TUI listens to.
+ *
+ * Flow:
+ * 1. Handler emits 'approval:request' → EventBus → TUI shows prompt
+ * 2. User responds in TUI → EventBus emits 'approval:response' → Handler resolves
+ * 3. For auto-approvals (parallel tools), handler emits 'approval:response' → TUI dismisses
+ */
+import { ApprovalStatus, DenialReason } from '@dexto/core';
+/**
+ * Creates a manual approval handler for CLI mode that uses AgentEventBus directly.
+ *
+ * @param eventBus The agent event bus for request/response communication
+ * @returns ApprovalHandler with cancellation and auto-approve support
+ *
+ * @example
+ * ```typescript
+ * const handler = createCLIApprovalHandler(agent.agentEventBus);
+ * agent.setApprovalHandler(handler);
+ * ```
+ */
+export function createCLIApprovalHandler(eventBus) {
+    // Track pending approvals for cancellation support
+    const pendingApprovals = new Map();
+    const handleApproval = (request) => {
+        return new Promise((resolve) => {
+            // Use per-request timeout (optional - undefined means no timeout)
+            const effectiveTimeout = request.timeout;
+            // Set timeout timer ONLY if timeout is specified
+            let timer;
+            if (effectiveTimeout !== undefined) {
+                timer = setTimeout(() => {
+                    cleanup();
+                    pendingApprovals.delete(request.approvalId);
+                    // Create timeout response
+                    const timeoutResponse = {
+                        approvalId: request.approvalId,
+                        status: ApprovalStatus.CANCELLED,
+                        sessionId: request.sessionId,
+                        reason: DenialReason.TIMEOUT,
+                        message: `Approval request timed out after ${effectiveTimeout}ms`,
+                        timeoutMs: effectiveTimeout,
+                    };
+                    // Emit timeout response so TUI can dismiss the prompt
+                    eventBus.emit('approval:response', timeoutResponse);
+                    resolve(timeoutResponse);
+                }, effectiveTimeout);
+            }
+            // Cleanup function to remove listener and clear timeout
+            const controller = new AbortController();
+            const cleanup = () => {
+                if (timer !== undefined) {
+                    clearTimeout(timer);
+                }
+                controller.abort();
+            };
+            // Listen for approval:response events
+            const listener = (res) => {
+                // Only handle responses for this specific approval
+                if (res.approvalId === request.approvalId) {
+                    cleanup();
+                    pendingApprovals.delete(request.approvalId);
+                    resolve(res);
+                }
+            };
+            // Register listener with abort signal for cleanup
+            eventBus.on('approval:response', listener, { signal: controller.signal });
+            // Store for cancellation support
+            pendingApprovals.set(request.approvalId, {
+                cleanup,
+                resolve,
+                request,
+            });
+            // Emit the approval:request event for TUI to receive
+            eventBus.emit('approval:request', request);
+        });
+    };
+    const handler = Object.assign(handleApproval, {
+        cancel: (approvalId) => {
+            const pending = pendingApprovals.get(approvalId);
+            if (pending) {
+                pending.cleanup();
+                pendingApprovals.delete(approvalId);
+                // Create cancellation response
+                const cancelResponse = {
+                    approvalId,
+                    status: ApprovalStatus.CANCELLED,
+                    sessionId: pending.request.sessionId,
+                    reason: DenialReason.SYSTEM_CANCELLED,
+                    message: 'Approval request was cancelled',
+                };
+                // Emit cancellation event so TUI can dismiss the prompt
+                eventBus.emit('approval:response', cancelResponse);
+                // Resolve with CANCELLED response
+                pending.resolve(cancelResponse);
+            }
+        },
+        cancelAll: () => {
+            for (const [approvalId] of pendingApprovals) {
+                handler.cancel?.(approvalId);
+            }
+        },
+        getPending: () => {
+            return Array.from(pendingApprovals.keys());
+        },
+        getPendingRequests: () => {
+            return Array.from(pendingApprovals.values()).map((p) => p.request);
+        },
+        /**
+         * Auto-approve pending requests that match a predicate.
+         * Used when a pattern is remembered to auto-approve other parallel requests
+         * that would now match the same pattern.
+         */
+        autoApprovePending: (predicate, responseData) => {
+            let count = 0;
+            // Find all pending approvals that match the predicate
+            for (const [approvalId, pending] of pendingApprovals) {
+                if (predicate(pending.request)) {
+                    // Clean up the pending state
+                    pending.cleanup();
+                    pendingApprovals.delete(approvalId);
+                    // Create auto-approval response
+                    const autoApproveResponse = {
+                        approvalId,
+                        status: ApprovalStatus.APPROVED,
+                        sessionId: pending.request.sessionId,
+                        message: 'Auto-approved due to matching remembered pattern',
+                        data: responseData,
+                    };
+                    // Emit response so TUI can dismiss the prompt
+                    eventBus.emit('approval:response', autoApproveResponse);
+                    // Resolve the pending promise
+                    pending.resolve(autoApproveResponse);
+                    count++;
+                }
+            }
+            return count;
+        },
+    });
+    return handler;
+}

package/dist/cli/approval/index.d.ts

@@ -0,0 +1,7 @@
+/**
+ * CLI Approval Module
+ *
+ * Provides CLI-specific approval handling that works directly with AgentEventBus.
+ */
+export { createCLIApprovalHandler } from './cli-approval-handler.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/cli/approval/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/cli/approval/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,wBAAwB,EAAE,MAAM,2BAA2B,CAAC"}

package/dist/cli/approval/index.js

@@ -0,0 +1,6 @@
+/**
+ * CLI Approval Module
+ *
+ * Provides CLI-specific approval handling that works directly with AgentEventBus.
+ */
+export { createCLIApprovalHandler } from './cli-approval-handler.js';

package/dist/cli/cli-subscriber.d.ts

@@ -8,7 +8,7 @@
 import { DextoAgent } from '@dexto/core';
 import { EventSubscriber } from '@dexto/server';
 import { AgentEventBus } from '@dexto/core';
-import type { SanitizedToolResult } from '@dexto/core';
+import type { SanitizedToolResult, AgentEventMap } from '@dexto/core';
 /**
  * Event subscriber for CLI headless mode
  * Implements the standard EventSubscriber pattern used throughout the codebase
@@ -30,6 +30,9 @@ export declare class CLISubscriber implements EventSubscriber {
     onResponse(text: string): void;
     onError(error: Error): void;
     onConversationReset(): void;
+    onContextCompacting(payload: AgentEventMap['context:compacting']): void;
+    onContextCompacted(payload: AgentEventMap['context:compacted']): void;
+    onSessionContinued(payload: AgentEventMap['session:continued']): void;
     /**
      * Capture LLM token usage analytics
      */

package/dist/cli/cli-subscriber.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"cli-subscriber.d.ts","sourceRoot":"","sources":["../../src/cli/cli-subscriber.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAU,UAAU,EAAE,MAAM,aAAa,CAAC;AACjD,OAAO,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AAChD,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAC5C,OAAO,KAAK,EAAE,mBAAmB,EAAiB,MAAM,aAAa,CAAC;AAGtE;;;GAGG;AACH,qBAAa,aAAc,YAAW,eAAe;IACjD,OAAO,CAAC,gBAAgB,CAAc;IACtC,OAAO,CAAC,iBAAiB,CAAC,CAAa;IACvC,OAAO,CAAC,gBAAgB,CAAC,CAAyB;IAElD,SAAS,CAAC,QAAQ,EAAE,aAAa,GAAG,IAAI;IA6BxC;;;OAGG;IACH,OAAO,IAAI,IAAI;IAcf,UAAU,IAAI,IAAI;IAIlB,OAAO,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI;IAM3B,UAAU,CAAC,QAAQ,EAAE,MAAM,EAAE,KAAK,EAAE,GAAG,GAAG,IAAI;IAK9C,YAAY,CACR,QAAQ,EAAE,MAAM,EAChB,SAAS,EAAE,mBAAmB,EAC9B,SAAS,CAAC,EAAE,OAAO,EACnB,OAAO,CAAC,EAAE,OAAO,GAClB,IAAI;IAMP,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI;IA0B9B,OAAO,CAAC,KAAK,EAAE,KAAK,GAAG,IAAI;IAyC3B,mBAAmB,IAAI,IAAI;IAM3B;;OAEG;IACH,OAAO,CAAC,iBAAiB;IAoBzB;;;OAGG;IACG,UAAU,CAAC,KAAK,EAAE,UAAU,EAAE,MAAM,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;CAsBxF"}
+{"version":3,"file":"cli-subscriber.d.ts","sourceRoot":"","sources":["../../src/cli/cli-subscriber.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAU,UAAU,EAAE,MAAM,aAAa,CAAC;AACjD,OAAO,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AAChD,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAC5C,OAAO,KAAK,EAAE,mBAAmB,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAGtE;;;GAGG;AACH,qBAAa,aAAc,YAAW,eAAe;IACjD,OAAO,CAAC,gBAAgB,CAAc;IACtC,OAAO,CAAC,iBAAiB,CAAC,CAAa;IACvC,OAAO,CAAC,gBAAgB,CAAC,CAAyB;IAElD,SAAS,CAAC,QAAQ,EAAE,aAAa,GAAG,IAAI;IAgCxC;;;OAGG;IACH,OAAO,IAAI,IAAI;IAcf,UAAU,IAAI,IAAI;IAIlB,OAAO,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI;IAM3B,UAAU,CAAC,QAAQ,EAAE,MAAM,EAAE,KAAK,EAAE,GAAG,GAAG,IAAI;IAK9C,YAAY,CACR,QAAQ,EAAE,MAAM,EAChB,SAAS,EAAE,mBAAmB,EAC9B,SAAS,CAAC,EAAE,OAAO,EACnB,OAAO,CAAC,EAAE,OAAO,GAClB,IAAI;IAMP,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI;IA0B9B,OAAO,CAAC,KAAK,EAAE,KAAK,GAAG,IAAI;IAyC3B,mBAAmB,IAAI,IAAI;IAM3B,mBAAmB,CAAC,OAAO,EAAE,aAAa,CAAC,oBAAoB,CAAC,GAAG,IAAI;IAOvE,kBAAkB,CAAC,OAAO,EAAE,aAAa,CAAC,mBAAmB,CAAC,GAAG,IAAI;IAcrE,kBAAkB,CAAC,OAAO,EAAE,aAAa,CAAC,mBAAmB,CAAC,GAAG,IAAI;IAWrE;;OAEG;IACH,OAAO,CAAC,iBAAiB;IA6BzB;;;OAGG;IACG,UAAU,CAAC,KAAK,EAAE,UAAU,EAAE,MAAM,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;CAsBxF"}

package/dist/cli/cli-subscriber.js

@@ -37,6 +37,9 @@ export class CLISubscriber {
         });
         eventBus.on('llm:error', (payload) => this.onError(payload.error));
         eventBus.on('session:reset', this.onConversationReset.bind(this));
+        eventBus.on('context:compacting', this.onContextCompacting.bind(this));
+        eventBus.on('context:compacted', this.onContextCompacted.bind(this));
+        eventBus.on('session:continued', this.onSessionContinued.bind(this));
     }
     /**
      * Clean up internal state
@@ -134,14 +137,39 @@ export class CLISubscriber {
         this.streamingContent = '';
         logger.info('🔄 Conversation history cleared.', null, 'blue');
     }
+    onContextCompacting(payload) {
+        // Output to stderr (doesn't interfere with stdout response stream)
+        process.stderr.write(`[📦 Compacting context (~${payload.estimatedTokens.toLocaleString()} tokens)...]\n`);
+    }
+    onContextCompacted(payload) {
+        const { originalTokens, compactedTokens, originalMessages, compactedMessages, reason } = payload;
+        const reductionPercent = originalTokens > 0
+            ? Math.round(((originalTokens - compactedTokens) / originalTokens) * 100)
+            : 0;
+        // Output to stderr (doesn't interfere with stdout response stream)
+        process.stderr.write(`[📦 Context compacted (${reason}): ${originalTokens.toLocaleString()} → ~${compactedTokens.toLocaleString()} tokens (${reductionPercent}% reduction), ${originalMessages} → ${compactedMessages} messages]\n`);
+    }
+    onSessionContinued(payload) {
+        const { previousSessionId, newSessionId, summaryTokens, originalMessages, reason } = payload;
+        // Output to stderr (doesn't interfere with stdout response stream)
+        process.stderr.write(`[📦 Context compacted → Continuing in new session\n` +
+            `   ${previousSessionId.slice(0, 8)}... → ${newSessionId.slice(0, 8)}...\n` +
+            `   ${originalMessages} messages → ~${summaryTokens.toLocaleString()} token summary (${reason})]\n`);
+    }
     /**
      * Capture LLM token usage analytics
      */
     captureTokenUsage(payload) {
-        const { tokenUsage, provider, model, sessionId } = payload;
+        const { tokenUsage, provider, model, sessionId, estimatedInputTokens } = payload;
         if (!tokenUsage || (!tokenUsage.inputTokens && !tokenUsage.outputTokens)) {
             return;
         }
+        // Calculate estimate accuracy if both estimate and actual are available
+        let estimateAccuracyPercent;
+        if (estimatedInputTokens !== undefined && tokenUsage.inputTokens) {
+            const diff = estimatedInputTokens - tokenUsage.inputTokens;
+            estimateAccuracyPercent = Math.round((diff / tokenUsage.inputTokens) * 100);
+        }
         capture('dexto_llm_tokens_consumed', {
             source: 'cli',
             sessionId,
@@ -153,6 +181,8 @@ export class CLISubscriber {
             totalTokens: tokenUsage.totalTokens,
             cacheReadTokens: tokenUsage.cacheReadTokens,
             cacheWriteTokens: tokenUsage.cacheWriteTokens,
+            estimatedInputTokens,
+            estimateAccuracyPercent,
         });
     }
     /**

package/dist/cli/commands/interactive-commands/commands.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"commands.d.ts","sourceRoot":"","sources":["../../../../src/cli/commands/interactive-commands/commands.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AAEH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAC9C,OAAO,KAAK,EAAE,iBAAiB,EAAE,oBAAoB,EAAE,MAAM,qBAAqB,CAAC;AAYnF;;;;;;;;;;;;;;GAcG;AACH,eAAO,MAAM,YAAY,EAAE,iBAAiB,EAAO,CAAC;AAqCpD;;;;;GAKG;AACH,wBAAsB,cAAc,CAChC,OAAO,EAAE,MAAM,EACf,IAAI,EAAE,MAAM,EAAE,EACd,KAAK,EAAE,UAAU,EACjB,SAAS,CAAC,EAAE,MAAM,GACnB,OAAO,CAAC,oBAAoB,CAAC,CAyD/B;AAED;;;GAGG;AACH,wBAAgB,cAAc,IAAI,iBAAiB,EAAE,CAEpD"}
+{"version":3,"file":"commands.d.ts","sourceRoot":"","sources":["../../../../src/cli/commands/interactive-commands/commands.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AAEH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAC9C,OAAO,KAAK,EAAE,iBAAiB,EAAE,oBAAoB,EAAE,MAAM,qBAAqB,CAAC;AAYnF;;;;;;;;;;;;;;GAcG;AACH,eAAO,MAAM,YAAY,EAAE,iBAAiB,EAAO,CAAC;AAsCpD;;;;;GAKG;AACH,wBAAsB,cAAc,CAChC,OAAO,EAAE,MAAM,EACf,IAAI,EAAE,MAAM,EAAE,EACd,KAAK,EAAE,UAAU,EACjB,SAAS,CAAC,EAAE,MAAM,GACnB,OAAO,CAAC,oBAAoB,CAAC,CAyD/B;AAED;;;GAGG;AACH,wBAAgB,cAAc,IAAI,iBAAiB,EAAE,CAEpD"}

package/dist/cli/commands/interactive-commands/commands.js

@@ -20,7 +20,7 @@
  */
 // Import modular command definitions
 import { generalCommands, createHelpCommand } from './general-commands.js';
-import { searchCommand, resumeCommand } from './session/index.js';
+import { searchCommand, resumeCommand, renameCommand } from './session/index.js';
 import { modelCommands } from './model/index.js';
 import { mcpCommands } from './mcp/index.js';
 import { systemCommands } from './system/index.js';
@@ -51,6 +51,7 @@ const baseCommands = [
     // Session management
     searchCommand, // /search - opens search overlay
     resumeCommand, // /resume - opens session selector overlay
+    renameCommand, // /rename <title> - rename current session
     // Model management
     modelCommands, // /model - opens model selector overlay
     // MCP server management

package/dist/cli/commands/interactive-commands/general-commands.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"general-commands.d.ts","sourceRoot":"","sources":["../../../../src/cli/commands/interactive-commands/general-commands.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAKH,OAAO,KAAK,EAAE,iBAAiB,EAAwC,MAAM,qBAAqB,CAAC;AAiDnG;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,cAAc,EAAE,MAAM,iBAAiB,EAAE,GAAG,iBAAiB,CAgC9F;AAED;;;GAGG;AACH,eAAO,MAAM,eAAe,EAAE,iBAAiB,EAyO9C,CAAC"}
+{"version":3,"file":"general-commands.d.ts","sourceRoot":"","sources":["../../../../src/cli/commands/interactive-commands/general-commands.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAKH,OAAO,KAAK,EAAE,iBAAiB,EAAwC,MAAM,qBAAqB,CAAC;AAgGnG;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,cAAc,EAAE,MAAM,iBAAiB,EAAE,GAAG,iBAAiB,CAgC9F;AAED;;;GAGG;AACH,eAAO,MAAM,eAAe,EAAE,iBAAiB,EA8X9C,CAAC"}