@compass-ai/nova 1.0.73 → 1.0.74

package/dist/commands/tokens.js

@@ -0,0 +1,245 @@
+/**
+ * Tokens command implementation for viewing token usage statistics,
+ * detailed breakdowns, and exporting usage history.
+ *
+ * This module provides the external CLI command for token usage management,
+ * allowing users to view their API usage statistics, cost estimates,
+ * and export usage data for analysis or record-keeping.
+ */
+import { Command } from 'commander';
+import chalk from 'chalk';
+import { getTokenTracker } from '../services/token-tracker.js';
+import { logger } from '../utils/logger.js';
+import { formatTokenCount, formatCost, formatDate, formatDuration } from '../utils/format.js';
+import { safeWriteFile } from '../utils/file-system.js';
+/**
+ * Formats token metrics for console display
+ */
+function displayTokenMetrics(stats, title) {
+    console.log('');
+    console.log(chalk.bold.white(`📊 ${title}`));
+    console.log(chalk.dim('─'.repeat(50)));
+    // Main statistics
+    console.log(`  ${chalk.gray('Total API Calls:')}    ${chalk.white(stats.totalCalls.toLocaleString())}`);
+    console.log(`  ${chalk.gray('Total Tokens:')}       ${chalk.bold.white(formatTokenCount(stats.totalTokens))}`);
+    console.log(`  ${chalk.gray('Total Cost:')}         ${chalk.bold.green(formatCost(stats.totalCost))}`);
+    console.log('');
+    console.log(chalk.bold.white('  Averages per Call:'));
+    console.log(`    ${chalk.gray('Input:')}  ${formatTokenCount(stats.averageInputTokens)} tokens`);
+    console.log(`    ${chalk.gray('Output:')} ${formatTokenCount(stats.averageOutputTokens)} tokens`);
+    console.log('');
+    console.log(chalk.bold.white('  Peak Usage:'));
+    console.log(`    ${chalk.gray('Input:')}  ${formatTokenCount(stats.peakInputTokens)} tokens`);
+    console.log(`    ${chalk.gray('Output:')} ${formatTokenCount(stats.peakOutputTokens)} tokens`);
+    console.log('');
+}
+/**
+ * Displays current session token usage
+ */
+function displaySessionUsage(sessionUsage) {
+    console.log('');
+    console.log(chalk.bold.white('📊 Current Session Token Usage'));
+    console.log(chalk.dim('─'.repeat(50)));
+    console.log(`  ${chalk.gray('Session ID:')}     ${sessionUsage.sessionId.slice(0, 8)}...`);
+    console.log(`  ${chalk.gray('Started:')}        ${formatDate(sessionUsage.startTime)}`);
+    if (sessionUsage.endTime) {
+        console.log(`  ${chalk.gray('Ended:')}          ${formatDate(sessionUsage.endTime)}`);
+        const duration = new Date(sessionUsage.endTime).getTime() - new Date(sessionUsage.startTime).getTime();
+        console.log(`  ${chalk.gray('Duration:')}       ${formatDuration(duration)}`);
+    }
+    console.log('');
+    console.log(chalk.bold.white('  Token Usage:'));
+    console.log(`    ${chalk.gray('API Calls:')}     ${sessionUsage.calls.length}`);
+    console.log(`    ${chalk.gray('Input Tokens:')}  ${formatTokenCount(sessionUsage.totals.inputTokens)}`);
+    console.log(`    ${chalk.gray('Output Tokens:')} ${formatTokenCount(sessionUsage.totals.outputTokens)}`);
+    console.log(`    ${chalk.gray('Total Tokens:')}  ${chalk.bold(formatTokenCount(sessionUsage.totals.totalTokens))}`);
+    // Display cache usage if available
+    if (sessionUsage.totals.cacheCreationInputTokens || sessionUsage.totals.cacheReadInputTokens) {
+        console.log('');
+        console.log(chalk.bold.white('  Cache Usage:'));
+        if (sessionUsage.totals.cacheCreationInputTokens) {
+            console.log(`    ${chalk.gray('Cache Created:')} ${formatTokenCount(sessionUsage.totals.cacheCreationInputTokens)}`);
+        }
+        if (sessionUsage.totals.cacheReadInputTokens) {
+            console.log(`    ${chalk.gray('Cache Read:')}    ${chalk.cyan(formatTokenCount(sessionUsage.totals.cacheReadInputTokens))}`);
+        }
+    }
+    console.log('');
+    console.log(chalk.bold.white('  Cost Estimate:'));
+    console.log(`    ${chalk.gray('Input Cost:')}    ${formatCost(sessionUsage.estimatedCost.inputCost)}`);
+    console.log(`    ${chalk.gray('Output Cost:')}   ${formatCost(sessionUsage.estimatedCost.outputCost)}`);
+    console.log(`    ${chalk.gray('Total Cost:')}    ${chalk.bold.green(formatCost(sessionUsage.estimatedCost.totalCost))}`);
+    console.log('');
+}
+/**
+ * Displays detailed breakdown of API calls
+ */
+function displayDetailedBreakdown(sessionUsage) {
+    console.log('');
+    console.log(chalk.bold.white('📋 Detailed API Call Breakdown'));
+    console.log(chalk.dim('─'.repeat(50)));
+    if (sessionUsage.calls.length === 0) {
+        console.log(chalk.gray('  No API calls recorded in this session.'));
+        console.log('');
+        return;
+    }
+    // Display last 10 calls
+    const recentCalls = sessionUsage.calls.slice(-10);
+    const showingPartial = sessionUsage.calls.length > 10;
+    if (showingPartial) {
+        console.log(chalk.gray(`  Showing last 10 of ${sessionUsage.calls.length} calls:`));
+        console.log('');
+    }
+    for (const call of recentCalls) {
+        const timestamp = formatDate(call.timestamp);
+        console.log(`  ${chalk.cyan('●')} ${chalk.gray(timestamp)}`);
+        console.log(`    ${chalk.gray('Model:')}  ${call.model}`);
+        console.log(`    ${chalk.gray('Input:')}  ${formatTokenCount(call.usage.inputTokens)} tokens`);
+        console.log(`    ${chalk.gray('Output:')} ${formatTokenCount(call.usage.outputTokens)} tokens`);
+        console.log(`    ${chalk.gray('Cost:')}   ${formatCost(call.cost.totalCost)}`);
+        if (call.purpose) {
+            console.log(`    ${chalk.gray('Purpose:')} ${call.purpose}`);
+        }
+        console.log('');
+    }
+}
+/**
+ * Creates the tokens command for the CLI
+ */
+export function createTokensCommand() {
+    const command = new Command('tokens');
+    command
+        .description('View token usage statistics, detailed breakdowns, and export usage history')
+        .option('-e, --export [file]', 'Export usage data as JSON (optionally specify output file)')
+        .option('-s, --session', 'Show current session usage only')
+        .option('-d, --detailed', 'Show detailed breakdown of API calls')
+        .option('-a, --all', 'Show all-time statistics')
+        .option('--json', 'Output in JSON format')
+        .action(async (options) => {
+        try {
+            const tracker = await getTokenTracker();
+            // Handle JSON export
+            if (options.export !== undefined) {
+                const data = await tracker.exportUsage();
+                const jsonOutput = JSON.stringify(data, null, 2);
+                if (typeof options.export === 'string' && options.export.length > 0) {
+                    // Export to file
+                    await safeWriteFile(options.export, jsonOutput);
+                    console.log(chalk.green(`✅ Token usage data exported to ${options.export}`));
+                }
+                else {
+                    // Output to stdout
+                    console.log(jsonOutput);
+                }
+                return;
+            }
+            // Handle JSON output format
+            if (options.json) {
+                const sessionUsage = tracker.getCurrentSessionUsage();
+                const allTimeStats = tracker.getAllTimeStats();
+                const output = {
+                    currentSession: sessionUsage,
+                    allTime: allTimeStats,
+                };
+                console.log(JSON.stringify(output, null, 2));
+                return;
+            }
+            // Handle session-only view
+            if (options.session) {
+                const sessionUsage = tracker.getCurrentSessionUsage();
+                if (!sessionUsage) {
+                    console.log('');
+                    console.log(chalk.yellow('⚠️  No active session found.'));
+                    console.log(chalk.gray('   Start an interactive session with "compass" to track usage.'));
+                    console.log('');
+                    return;
+                }
+                displaySessionUsage(sessionUsage);
+                if (options.detailed) {
+                    displayDetailedBreakdown(sessionUsage);
+                }
+                return;
+            }
+            // Handle detailed view
+            if (options.detailed) {
+                const sessionUsage = tracker.getCurrentSessionUsage();
+                if (!sessionUsage) {
+                    console.log('');
+                    console.log(chalk.yellow('⚠️  No active session found for detailed breakdown.'));
+                    console.log(chalk.gray('   Start an interactive session with "compass" to track usage.'));
+                    console.log('');
+                }
+                else {
+                    displaySessionUsage(sessionUsage);
+                    displayDetailedBreakdown(sessionUsage);
+                }
+                // Also show all-time stats
+                const allTimeStats = tracker.getAllTimeStats();
+                if (allTimeStats.totalCalls > 0) {
+                    displayTokenMetrics(allTimeStats, 'All-Time Statistics');
+                }
+                return;
+            }
+            // Default: show all-time statistics (or current session if --all not specified)
+            const allTimeStats = tracker.getAllTimeStats();
+            const sessionUsage = tracker.getCurrentSessionUsage();
+            if (allTimeStats.totalCalls === 0 && !sessionUsage) {
+                console.log('');
+                console.log(chalk.gray('📊 No token usage data recorded yet.'));
+                console.log(chalk.gray('   Start an interactive session with "compass" to begin tracking.'));
+                console.log('');
+                return;
+            }
+            // Show current session if available
+            if (sessionUsage && !options.all) {
+                displaySessionUsage(sessionUsage);
+            }
+            // Show all-time statistics
+            if (allTimeStats.totalCalls > 0) {
+                displayTokenMetrics(allTimeStats, 'All-Time Token Usage Statistics');
+            }
+            // Show helpful tips
+            console.log(chalk.dim('─'.repeat(50)));
+            console.log(chalk.gray('Tips:'));
+            console.log(chalk.gray('  • Use --session to view current session only'));
+            console.log(chalk.gray('  • Use --detailed to see individual API calls'));
+            console.log(chalk.gray('  • Use --export to save usage data as JSON'));
+            console.log(chalk.gray('  • Use /tokens in interactive mode for quick stats'));
+            console.log('');
+        }
+        catch (error) {
+            logger.error('Tokens command failed', error);
+            console.error(chalk.red('❌ Failed to retrieve token usage statistics'));
+            if (error instanceof Error) {
+                console.error(chalk.red(`   ${error.message}`));
+            }
+            process.exit(1);
+        }
+    });
+    return command;
+}
+/**
+ * Tokens command action handler for direct invocation
+ * This function can be used when integrating with the main CLI
+ */
+export async function tokensAction(options) {
+    const command = createTokensCommand();
+    const args = ['tokens'];
+    if (options.export) {
+        args.push('--export');
+        if (typeof options.export === 'string') {
+            args.push(options.export);
+        }
+    }
+    if (options.session)
+        args.push('--session');
+    if (options.detailed)
+        args.push('--detailed');
+    if (options.all)
+        args.push('--all');
+    if (options.json)
+        args.push('--json');
+    await command.parseAsync(args, { from: 'user' });
+}
+export default createTokensCommand;
+//# sourceMappingURL=tokens.js.map

package/dist/commands/tokens.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tokens.js","sourceRoot":"","sources":["../../src/commands/tokens.ts"],"names":[],"mappings":"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"}

package/dist/constants/builtin-agents.d.ts

@@ -0,0 +1,27 @@
+/**
+ * Built-in default agents shipped with Compass CLI.
+ *
+ * These agents are available out-of-the-box and can be overridden by
+ * user or project-level agents with the same name.
+ *
+ * Built-in agents have the lowest priority:
+ * 1. Project agents (.compass/agents/) - highest
+ * 2. CLI agents (--agents flag)
+ * 3. User agents (~/.compass/agents/)
+ * 4. Built-in agents - lowest
+ */
+import type { AgentDefinition } from '../types/agent.js';
+/**
+ * All built-in agents available in Compass CLI.
+ */
+export declare const BUILTIN_AGENTS: AgentDefinition[];
+/**
+ * Get a built-in agent by name.
+ */
+export declare function getBuiltinAgent(name: string): AgentDefinition | undefined;
+/**
+ * Get all built-in agent names.
+ */
+export declare function getBuiltinAgentNames(): string[];
+export default BUILTIN_AGENTS;
+//# sourceMappingURL=builtin-agents.d.ts.map

package/dist/constants/builtin-agents.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"builtin-agents.d.ts","sourceRoot":"","sources":["../../src/constants/builtin-agents.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AAyqBzD;;GAEG;AACH,eAAO,MAAM,cAAc,EAAE,eAAe,EAM3C,CAAC;AAEF;;GAEG;AACH,wBAAgB,eAAe,CAAC,IAAI,EAAE,MAAM,GAAG,eAAe,GAAG,SAAS,CAEzE;AAED;;GAEG;AACH,wBAAgB,oBAAoB,IAAI,MAAM,EAAE,CAE/C;AAED,eAAe,cAAc,CAAC"}