@compilr-dev/cli 0.4.0 → 0.5.1

package/dist/commands-v2/handlers/context.js

@@ -0,0 +1,533 @@
+/**
+ * Context Commands for REPL V2
+ *
+ * Commands for context management: compact, context, tokens, status, todos, export
+ */
+import * as fs from 'fs';
+import * as path from 'path';
+import pc from 'picocolors';
+import { getCompactMode } from '../../settings/index.js';
+import { renderProgressBar, formatTokens, truncate } from '../../ui/base/index.js';
+import { getStyles } from '../../themes/index.js';
+/**
+ * Print compaction results for a single agent
+ */
+function printCompactResult(ctx, result, beforeHistory, label) {
+    if (!result.success) {
+        const prefix = label ? `${label}: ` : '';
+        ctx.ui.print({ type: 'warning', message: `${prefix}Compaction not available` });
+        return;
+    }
+    const prefix = label ? `${label}: ` : '';
+    const statusParts = [];
+    // Token reduction
+    const originalTokens = result.originalTokens ?? 0;
+    const summaryTokens = result.summaryTokens ?? 0;
+    const reduction = originalTokens > 0 ? Math.round((1 - summaryTokens / originalTokens) * 100) : 0;
+    statusParts.push(`${prefix}Compacted: ${originalTokens.toLocaleString()} → ${summaryTokens.toLocaleString()} tokens (-${String(reduction)}%)`);
+    // Category actions
+    if (result.categoryStats) {
+        const actions = [];
+        if (result.categoryStats.toolResults.action === 'compacted') {
+            actions.push('tool results → files');
+        }
+        if (result.categoryStats.history.action === 'summarized') {
+            actions.push('history → summary');
+        }
+        if (actions.length > 0) {
+            statusParts.push(`${prefix}Actions: ${actions.join(', ')}`);
+        }
+    }
+    // Files created
+    if (result.filesCreated && result.filesCreated.length > 0) {
+        statusParts.push(`${prefix}Files created: ${String(result.filesCreated.length)}`);
+    }
+    // Restoration hints
+    if (result.restorationHintsInjected) {
+        statusParts.push(`${prefix}File tracking hints injected`);
+    }
+    // Tool results repaired
+    if (result.toolResultsRepaired && result.toolResultsRepaired > 0) {
+        statusParts.push(`${prefix}Orphaned tool results removed: ${String(result.toolResultsRepaired)}`);
+    }
+    for (const part of statusParts) {
+        ctx.ui.print({ type: 'success', message: part });
+    }
+}
+export const compactCommand = {
+    name: 'compact',
+    description: 'Summarize old messages to free context',
+    details: 'When context is running low, use this to summarize older messages. Supports: /compact (default mode), /compact all, /compact auto, /compact $agentId',
+    examples: [
+        { code: '/compact', description: 'Use default compact mode from settings' },
+        { code: '/compact all', description: 'Compact all initialized agents' },
+        { code: '/compact auto', description: 'Compact agents above 70% utilization' },
+        { code: '/compact $pm', description: 'Compact a specific agent' },
+    ],
+    async execute(args, ctx) {
+        const trimmed = args.trim();
+        if (!trimmed) {
+            // Use default from settings
+            const mode = getCompactMode();
+            return compactByMode(mode, ctx);
+        }
+        if (trimmed === 'all') {
+            return compactByMode('all', ctx);
+        }
+        if (trimmed === 'auto') {
+            return compactByMode('auto', ctx);
+        }
+        if (trimmed.startsWith('$')) {
+            const agentId = trimmed.slice(1);
+            return compactSpecificAgent(agentId, ctx);
+        }
+        ctx.ui.print({ type: 'error', message: 'Usage: /compact [all|auto|$agentId]' });
+        return true;
+    },
+};
+async function compactByMode(mode, ctx) {
+    const team = ctx.team;
+    switch (mode) {
+        case 'active':
+            return compactActiveAgent(ctx);
+        case 'all': {
+            if (!team || team.size <= 1) {
+                return compactActiveAgent(ctx);
+            }
+            let compacted = 0;
+            for (const teamAgent of team.getAll()) {
+                if (!teamAgent.isInitialized)
+                    continue;
+                const agent = teamAgent.agent;
+                if (!agent)
+                    continue;
+                const state = agent.serialize();
+                if (state.messages.length === 0)
+                    continue;
+                ctx.ui.print({ type: 'info', message: `Compacting $${teamAgent.id}...` });
+                try {
+                    const result = (await agent.compact());
+                    printCompactResult(ctx, result, state.messages, `$${teamAgent.id}`);
+                    if (result.success)
+                        compacted++;
+                }
+                catch (error) {
+                    ctx.ui.print({ type: 'error', message: `$${teamAgent.id}: ${error.message}` });
+                }
+            }
+            if (compacted === 0) {
+                ctx.ui.print({ type: 'info', message: 'No agents needed compaction' });
+            }
+            return true;
+        }
+        case 'auto': {
+            if (!team || team.size <= 1) {
+                return compactActiveAgent(ctx);
+            }
+            const provider = (ctx.provider ?? 'claude');
+            let compacted = 0;
+            for (const teamAgent of team.getAll()) {
+                if (!teamAgent.isInitialized)
+                    continue;
+                const agent = teamAgent.agent;
+                if (!agent)
+                    continue;
+                const stats = teamAgent.getContextStats(provider);
+                const utilization = stats.maxTokens > 0 ? stats.estimatedTokens / stats.maxTokens : 0;
+                if (utilization <= 0.7)
+                    continue;
+                const pct = (utilization * 100).toFixed(1);
+                ctx.ui.print({ type: 'info', message: `Compacting $${teamAgent.id} (${pct}% utilized)...` });
+                try {
+                    const state = agent.serialize();
+                    const result = (await agent.compact());
+                    printCompactResult(ctx, result, state.messages, `$${teamAgent.id}`);
+                    if (result.success)
+                        compacted++;
+                }
+                catch (error) {
+                    ctx.ui.print({ type: 'error', message: `$${teamAgent.id}: ${error.message}` });
+                }
+            }
+            if (compacted === 0) {
+                ctx.ui.print({ type: 'info', message: 'No agents above 70% utilization' });
+            }
+            return true;
+        }
+    }
+}
+async function compactActiveAgent(ctx) {
+    if (!ctx.agent) {
+        ctx.ui.print({ type: 'warning', message: 'Agent not available for compaction' });
+        return true;
+    }
+    const contextManager = ctx.getContextManager?.();
+    if (!contextManager) {
+        ctx.ui.print({ type: 'warning', message: 'Context manager not available' });
+        return true;
+    }
+    const history = ctx.getHistory?.() ?? [];
+    if (history.length === 0) {
+        ctx.ui.print({ type: 'info', message: 'No conversation history to compact' });
+        return true;
+    }
+    // Show current stats
+    const stats = contextManager.getStats(history.length);
+    const pct = (stats.utilization * 100).toFixed(1);
+    ctx.ui.print({
+        type: 'info',
+        message: `Current: ${stats.currentTokens.toLocaleString()} tokens (${pct}%), ${String(history.length)} messages`,
+    });
+    ctx.ui.print({ type: 'info', message: 'Compacting context...' });
+    try {
+        const result = (await ctx.agent.compact());
+        printCompactResult(ctx, result, history);
+    }
+    catch (error) {
+        ctx.ui.print({ type: 'error', message: `Compaction failed: ${error.message}` });
+    }
+    return true;
+}
+async function compactSpecificAgent(agentId, ctx) {
+    const team = ctx.team;
+    if (!team) {
+        ctx.ui.print({ type: 'warning', message: 'No team available' });
+        return true;
+    }
+    const teamAgent = team.get(agentId);
+    if (!teamAgent) {
+        ctx.ui.print({ type: 'error', message: `Agent '$${agentId}' not found` });
+        return true;
+    }
+    if (!teamAgent.isInitialized || !teamAgent.agent) {
+        ctx.ui.print({ type: 'warning', message: `Agent '$${agentId}' is not initialized` });
+        return true;
+    }
+    const agent = teamAgent.agent;
+    const state = agent.serialize();
+    if (state.messages.length === 0) {
+        ctx.ui.print({ type: 'info', message: `Agent '$${agentId}' has no conversation history` });
+        return true;
+    }
+    ctx.ui.print({ type: 'info', message: `Compacting $${agentId}...` });
+    try {
+        const result = (await agent.compact());
+        printCompactResult(ctx, result, state.messages, `$${agentId}`);
+    }
+    catch (error) {
+        ctx.ui.print({ type: 'error', message: `$${agentId}: ${error.message}` });
+    }
+    return true;
+}
+// =============================================================================
+// Context Command
+// =============================================================================
+export const contextCommand = {
+    name: 'context',
+    description: 'Show context window usage',
+    details: 'Displays current context window utilization including token count, percentage used, and number of messages. Shows breakdown by agent when team has multiple agents.',
+    examples: [{ code: '/context' }],
+    execute(_args, ctx) {
+        const lines = [];
+        lines.push('');
+        const s = getStyles();
+        lines.push(pc.bold('Context Usage'));
+        lines.push(pc.dim('─'.repeat(40)));
+        const team = ctx.team;
+        const contextManager = ctx.getContextManager?.();
+        const history = ctx.getHistory?.() ?? [];
+        if (contextManager) {
+            const stats = contextManager.getStats(history.length);
+            const pct = (stats.utilization * 100).toFixed(1);
+            const bar = renderProgressBar(stats.utilization, 20, s);
+            // Show which agent this is for (when team is active)
+            if (team) {
+                const active = team.getActive();
+                lines.push(`  Agent:    ${pc.cyan(`${active.mascot} $${active.id}`)}`);
+            }
+            lines.push(`  Usage:    ${bar} ${pct}%`);
+            lines.push(`  Tokens:   ${pc.cyan(stats.currentTokens.toLocaleString())} / ${pc.dim(stats.maxTokens.toLocaleString())}`);
+            lines.push(`  Messages: ${pc.cyan(String(stats.messageCount))}`);
+            lines.push(`  Turns:    ${pc.cyan(String(stats.turnCount))}`);
+        }
+        else {
+            // Fallback to session tracking
+            const inputTokens = ctx.sessionInputTokens ?? 0;
+            const outputTokens = ctx.sessionOutputTokens ?? 0;
+            const total = inputTokens + outputTokens;
+            const maxTokens = 200000;
+            const utilization = total / maxTokens;
+            const pct = (utilization * 100).toFixed(1);
+            const bar = renderProgressBar(utilization, 20, s);
+            lines.push(`  Usage:    ${bar} ${pct}%`);
+            lines.push(`  Tokens:   ${pc.cyan(total.toLocaleString())} / ${pc.dim(maxTokens.toLocaleString())}`);
+            lines.push(`  Input:    ${pc.cyan(inputTokens.toLocaleString())}`);
+            lines.push(`  Output:   ${pc.cyan(outputTokens.toLocaleString())}`);
+            lines.push(`  Messages: ${pc.cyan(String(history.length))}`);
+        }
+        // Show breakdown by agent if team has multiple agents
+        if (team && team.size > 1) {
+            lines.push('');
+            lines.push(pc.bold('By Agent'));
+            lines.push(pc.dim('─'.repeat(40)));
+            const agents = team.getAll();
+            const provider = (ctx.provider ?? 'claude');
+            let totalTokens = 0;
+            for (const agent of agents) {
+                const stats = agent.getContextStats(provider);
+                const isActive = agent.id === team.activeAgentId;
+                const prefix = isActive ? pc.green('●') : pc.dim('○');
+                const label = `${agent.mascot} $${agent.id}`;
+                // Use per-agent maxTokens from model-specific context window
+                const utilization = stats.maxTokens > 0 ? stats.estimatedTokens / stats.maxTokens : 0;
+                const bar = renderProgressBar(utilization, 10, s);
+                const pct = (utilization * 100).toFixed(1);
+                const maxDisplay = formatTokens(stats.maxTokens);
+                lines.push(`  ${prefix} ${label.padEnd(18)} ${bar} ${pct.padStart(5)}%  ${pc.dim(maxDisplay)}  (${String(stats.messageCount)} msgs)`);
+                totalTokens += stats.estimatedTokens;
+            }
+            // Total row
+            lines.push(pc.dim('  ' + '─'.repeat(38)));
+            lines.push(`  Total: ${pc.cyan(totalTokens.toLocaleString())} tokens across ${pc.cyan(String(agents.length))} agents`);
+        }
+        lines.push('');
+        ctx.ui.print({ type: 'raw-lines', lines });
+        return Promise.resolve(true);
+    },
+};
+// =============================================================================
+// Tokens Command
+// =============================================================================
+export const tokensCommand = {
+    name: 'tokens',
+    description: 'Show token usage',
+    details: 'Displays token usage statistics for the current session including input/output tokens. Shows breakdown by agent when team has multiple agents.',
+    examples: [{ code: '/tokens' }],
+    execute(_args, ctx) {
+        const lines = [];
+        lines.push('');
+        lines.push(pc.bold('Token Usage'));
+        lines.push(pc.dim('─'.repeat(40)));
+        const inputTokens = ctx.sessionInputTokens ?? 0;
+        const outputTokens = ctx.sessionOutputTokens ?? 0;
+        const total = inputTokens + outputTokens;
+        lines.push(`  Input:    ${pc.cyan(inputTokens.toLocaleString())} tokens`);
+        lines.push(`  Output:   ${pc.cyan(outputTokens.toLocaleString())} tokens`);
+        lines.push(pc.dim('  ─'.repeat(20)));
+        lines.push(`  Total:    ${pc.bold(pc.cyan(total.toLocaleString()))} tokens`);
+        // Show breakdown by agent if team has multiple agents
+        const team = ctx.team;
+        if (team && team.size > 1) {
+            lines.push('');
+            lines.push(pc.bold('By Agent'));
+            lines.push(pc.dim('─'.repeat(40)));
+            const agents = team.getAll();
+            for (const agent of agents) {
+                const usage = agent.tokenUsage;
+                const agentTotal = usage.input + usage.output;
+                const isActive = agent.id === team.activeAgentId;
+                const prefix = isActive ? pc.green('●') : pc.dim('○');
+                const label = `${agent.mascot} $${agent.id}`;
+                // Show all agents, display 0 for unused ones
+                const tokenDisplay = agentTotal > 0
+                    ? pc.cyan(agentTotal.toLocaleString().padStart(10))
+                    : pc.dim('0'.padStart(10));
+                lines.push(`  ${prefix} ${label.padEnd(20)} ${tokenDisplay} tokens`);
+            }
+        }
+        lines.push('');
+        ctx.ui.print({ type: 'raw-lines', lines });
+        return Promise.resolve(true);
+    },
+};
+// =============================================================================
+// Status Command
+// =============================================================================
+export const statusCommand = {
+    name: 'status',
+    description: 'Show session status',
+    details: 'Displays current session status including CLI version, active model, mode, and context usage.',
+    examples: [{ code: '/status' }],
+    execute(_args, ctx) {
+        const lines = [];
+        lines.push('');
+        lines.push(pc.bold('Status'));
+        lines.push(pc.dim('─'.repeat(40)));
+        lines.push(`  Version:  ${pc.cyan(ctx.version)}`);
+        lines.push(`  Model:    ${pc.cyan(ctx.model ?? 'not set')}`);
+        lines.push(`  Provider: ${pc.cyan(ctx.provider ?? 'not set')}`);
+        const s = getStyles();
+        const contextManager = ctx.getContextManager?.();
+        const history = ctx.getHistory?.() ?? [];
+        if (contextManager) {
+            const stats = contextManager.getStats(history.length);
+            const pct = (stats.utilization * 100).toFixed(1);
+            const bar = renderProgressBar(stats.utilization, 20, s);
+            lines.push(`  Context:  ${bar} ${pct}%`);
+            lines.push(`  Messages: ${pc.cyan(String(stats.messageCount))}`);
+        }
+        else {
+            const inputTokens = ctx.sessionInputTokens ?? 0;
+            const outputTokens = ctx.sessionOutputTokens ?? 0;
+            const total = inputTokens + outputTokens;
+            lines.push(`  Tokens:   ${pc.cyan(total.toLocaleString())}`);
+            lines.push(`  Messages: ${pc.cyan(String(history.length))}`);
+        }
+        lines.push(`  Requests: ${pc.cyan(String(ctx.sessionRequests ?? 0))}`);
+        lines.push('');
+        ctx.ui.print({ type: 'raw-lines', lines });
+        return Promise.resolve(true);
+    },
+};
+// =============================================================================
+// Todos Command
+// =============================================================================
+export const todosCommand = {
+    name: 'todos',
+    description: 'Show current todo list',
+    details: 'Shows the current todo list that the agent uses to track work in progress.',
+    examples: [{ code: '/todos' }],
+    execute(_args, ctx) {
+        const todos = ctx.ui.getTodos();
+        const lines = [];
+        lines.push('');
+        if (todos.length === 0) {
+            lines.push(pc.dim('No todos. The agent will create todos when working on tasks.'));
+            lines.push('');
+            ctx.ui.print({ type: 'raw-lines', lines });
+            return Promise.resolve(true);
+        }
+        lines.push(pc.bold('Todos'));
+        lines.push(pc.dim('─'.repeat(40)));
+        for (const todo of todos) {
+            let icon;
+            let style;
+            switch (todo.status) {
+                case 'completed':
+                    icon = pc.green('✓');
+                    style = pc.strikethrough;
+                    break;
+                case 'in_progress':
+                    icon = pc.yellow('●');
+                    style = pc.bold;
+                    break;
+                default:
+                    icon = pc.dim('○');
+                    style = (s) => s;
+            }
+            lines.push(`  ${icon} ${style(todo.content)}`);
+        }
+        lines.push('');
+        ctx.ui.print({ type: 'raw-lines', lines });
+        return Promise.resolve(true);
+    },
+};
+// =============================================================================
+// Export Command
+// =============================================================================
+export const exportCommand = {
+    name: 'export',
+    description: 'Export conversation to file',
+    details: 'Export the current conversation to a markdown file for later reference. Optionally specify a filename.',
+    examples: [
+        { code: '/export', description: 'Auto-generated filename' },
+        { code: '/export notes.md', description: 'Custom filename' },
+    ],
+    execute(args, ctx) {
+        const history = ctx.getHistory?.() ?? [];
+        if (history.length === 0) {
+            ctx.ui.print({ type: 'warning', message: 'No conversation to export' });
+            return Promise.resolve(true);
+        }
+        // Format conversation as markdown
+        const markdown = formatConversationAsMarkdown(history, ctx.model ?? 'unknown');
+        // Determine filename
+        let filename;
+        if (args.trim()) {
+            filename = args.trim();
+        }
+        else {
+            // Default: conversation-YYYY-MM-DD-HHMMSS.md
+            const timestamp = new Date().toISOString().replace(/[:.]/g, '-').slice(0, 19);
+            filename = `conversation-${timestamp}.md`;
+        }
+        const filepath = path.isAbsolute(filename) ? filename : path.join(process.cwd(), filename);
+        try {
+            fs.writeFileSync(filepath, markdown, 'utf-8');
+            ctx.ui.print({ type: 'success', message: `Exported ${String(history.length)} messages to ${filepath}` });
+        }
+        catch (error) {
+            ctx.ui.print({ type: 'error', message: `Failed to export: ${error.message}` });
+        }
+        return Promise.resolve(true);
+    },
+};
+// =============================================================================
+// Helper: Format Conversation as Markdown
+// =============================================================================
+function formatConversationAsMarkdown(history, model) {
+    const lines = [];
+    const timestamp = new Date().toISOString().split('T')[0];
+    lines.push(`# Conversation Export`);
+    lines.push('');
+    lines.push(`**Model:** ${model}`);
+    lines.push(`**Date:** ${timestamp}`);
+    lines.push(`**Messages:** ${String(history.length)}`);
+    lines.push('');
+    lines.push('---');
+    lines.push('');
+    for (const msg of history) {
+        const role = msg.role === 'user' ? '👤 User' : '🤖 Assistant';
+        lines.push(`## ${role}`);
+        lines.push('');
+        if (typeof msg.content === 'string') {
+            lines.push(msg.content);
+        }
+        else if (Array.isArray(msg.content)) {
+            // Handle content blocks (tool calls, etc.)
+            for (const block of msg.content) {
+                if (typeof block === 'object' && block !== null) {
+                    const b = block;
+                    if (b.type === 'text' && typeof b.text === 'string') {
+                        lines.push(b.text);
+                    }
+                    else if (b.type === 'tool_use') {
+                        const toolName = typeof b.name === 'string' ? b.name : String(b.name);
+                        lines.push(`**Tool:** \`${toolName}\``);
+                        if (b.input) {
+                            lines.push('```json');
+                            lines.push(JSON.stringify(b.input, null, 2));
+                            lines.push('```');
+                        }
+                    }
+                    else if (b.type === 'tool_result') {
+                        lines.push(`**Tool Result:**`);
+                        if (typeof b.content === 'string') {
+                            lines.push('```');
+                            lines.push(truncate(b.content, 500));
+                            lines.push('```');
+                        }
+                    }
+                }
+            }
+        }
+        else if (msg.content !== null && typeof msg.content === 'object') {
+            lines.push('```json');
+            lines.push(JSON.stringify(msg.content, null, 2));
+            lines.push('```');
+        }
+        lines.push('');
+    }
+    return lines.join('\n');
+}
+// =============================================================================
+// Export All Context Commands
+// =============================================================================
+export const contextCommands = [
+    compactCommand,
+    contextCommand,
+    tokensCommand,
+    statusCommand,
+    todosCommand,
+    exportCommand,
+];

package/dist/commands-v2/handlers/core.d.ts

@@ -0,0 +1,14 @@
+/**
+ * Core Commands for REPL V2
+ *
+ * Essential commands: exit, clear, help
+ */
+import type { CommandHandlerV2 } from '../types.js';
+export declare const exitCommand: CommandHandlerV2;
+export declare const clearCommand: CommandHandlerV2;
+export declare const helpCommand: CommandHandlerV2;
+export declare const tutorialCommand: CommandHandlerV2;
+export declare const changelogCommand: CommandHandlerV2;
+export declare const commandsCommand: CommandHandlerV2;
+export declare const menuCommand: CommandHandlerV2;
+export declare const coreCommands: CommandHandlerV2[];