@phuetz/code-buddy 0.1.25 → 0.2.0

package/dist/commands/lessons.js

@@ -0,0 +1,129 @@
+/**
+ * `buddy lessons` CLI command
+ *
+ * Manages the persistent lessons.md self-improvement loop.
+ * Lessons are automatically injected before every LLM turn (before the
+ * todo suffix) so the agent internalises learned patterns across sessions.
+ *
+ * Subcommands: list, add, search, clear
+ */
+import { Command } from 'commander';
+import { getLessonsTracker } from '../agent/lessons-tracker.js';
+const VALID_CATEGORIES = ['PATTERN', 'RULE', 'CONTEXT', 'INSIGHT'];
+export function createLessonsCommand() {
+    const cmd = new Command('lessons');
+    cmd.description('Manage lessons learned (self-improvement loop) — injected into every agent turn');
+    // ---- list ----------------------------------------------------------------
+    cmd
+        .command('list')
+        .alias('ls')
+        .description('List all lessons, optionally filtered by category')
+        .option('-c, --category <cat>', `Filter by category: ${VALID_CATEGORIES.join('|')}`)
+        .action((opts) => {
+        const cat = opts.category?.toUpperCase();
+        if (cat && !VALID_CATEGORIES.includes(cat)) {
+            console.error(`Invalid category: ${cat}. Must be one of: ${VALID_CATEGORIES.join(', ')}`);
+            process.exit(1);
+        }
+        const tracker = getLessonsTracker(process.cwd());
+        const items = tracker.list(cat);
+        if (items.length === 0) {
+            console.log('No lessons recorded yet.');
+            return;
+        }
+        // Group by category for readability
+        const grouped = new Map();
+        for (const item of items) {
+            const arr = grouped.get(item.category) ?? [];
+            arr.push(item);
+            grouped.set(item.category, arr);
+        }
+        for (const category of VALID_CATEGORIES) {
+            const catItems = grouped.get(category);
+            if (!catItems || catItems.length === 0)
+                continue;
+            console.log(`\n## ${category}`);
+            for (const item of catItems) {
+                const ctx = item.context ? ` (${item.context})` : '';
+                const date = new Date(item.createdAt).toISOString().slice(0, 10);
+                console.log(`  [${item.id}]${ctx} ${item.content}  — ${date} ${item.source}`);
+            }
+        }
+    });
+    // ---- add -----------------------------------------------------------------
+    cmd
+        .command('add <content>')
+        .description('Add a new lesson')
+        .option('-c, --category <cat>', `Category: ${VALID_CATEGORIES.join('|')}`, 'INSIGHT')
+        .option('--context <ctx>', 'Optional domain context (e.g. TypeScript, React)')
+        .action((content, opts) => {
+        const cat = opts.category.toUpperCase();
+        if (!VALID_CATEGORIES.includes(cat)) {
+            console.error(`Invalid category: ${cat}. Must be one of: ${VALID_CATEGORIES.join(', ')}`);
+            process.exit(1);
+        }
+        const tracker = getLessonsTracker(process.cwd());
+        const item = tracker.add(cat, content, 'manual', opts.context);
+        console.log(`Added [${item.id}] (${item.category}): ${item.content}`);
+    });
+    // ---- search --------------------------------------------------------------
+    cmd
+        .command('search <query>')
+        .description('Search lessons by keyword')
+        .option('-c, --category <cat>', `Filter by category: ${VALID_CATEGORIES.join('|')}`)
+        .option('-n, --limit <n>', 'Max results', '10')
+        .action((query, opts) => {
+        const cat = opts.category?.toUpperCase();
+        if (cat && !VALID_CATEGORIES.includes(cat)) {
+            console.error(`Invalid category: ${cat}`);
+            process.exit(1);
+        }
+        const limit = parseInt(opts.limit, 10) || 10;
+        const tracker = getLessonsTracker(process.cwd());
+        const results = tracker.search(query, cat).slice(0, limit);
+        if (results.length === 0) {
+            console.log(`No lessons found matching "${query}".`);
+            return;
+        }
+        console.log(`Found ${results.length} lesson(s) matching "${query}":\n`);
+        for (const item of results) {
+            const ctx = item.context ? ` (${item.context})` : '';
+            console.log(`  [${item.id}] ${item.category}${ctx}: ${item.content}`);
+        }
+    });
+    // ---- clear ---------------------------------------------------------------
+    cmd
+        .command('clear')
+        .description('Remove lessons (all or by category)')
+        .option('-c, --category <cat>', `Remove only this category: ${VALID_CATEGORIES.join('|')}`)
+        .option('-y, --yes', 'Skip confirmation prompt')
+        .action((opts) => {
+        const cat = opts.category?.toUpperCase();
+        if (cat && !VALID_CATEGORIES.includes(cat)) {
+            console.error(`Invalid category: ${cat}`);
+            process.exit(1);
+        }
+        if (!opts.yes) {
+            const target = cat ? `category ${cat}` : 'ALL lessons';
+            console.log(`This will remove ${target}. Pass --yes to confirm.`);
+            return;
+        }
+        const tracker = getLessonsTracker(process.cwd());
+        const n = tracker.clearByCategory(cat);
+        console.log(`Cleared ${n} lesson(s)${cat ? ` in category ${cat}` : ''}.`);
+    });
+    // ---- context (preview) ---------------------------------------------------
+    cmd
+        .command('context')
+        .description('Preview the lessons context block injected into each agent turn')
+        .action(() => {
+        const tracker = getLessonsTracker(process.cwd());
+        const block = tracker.buildContextBlock();
+        if (!block)
+            console.log('No lessons — nothing to inject.');
+        else
+            console.log(block);
+    });
+    return cmd;
+}
+//# sourceMappingURL=lessons.js.map

package/dist/commands/lessons.js.map

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

package/dist/commands/pairing.d.ts

@@ -0,0 +1,14 @@
+/**
+ * buddy pairing – DM Pairing CLI commands
+ *
+ * Subcommands:
+ *   buddy pairing status           – show pairing mode status
+ *   buddy pairing list             – list approved senders
+ *   buddy pairing pending          – list pending pairing requests
+ *   buddy pairing approve <code>   – approve a pending request by code
+ *   buddy pairing revoke <id>      – revoke an approved sender
+ *   buddy pairing enable           – enable pairing mode
+ *   buddy pairing disable          – disable pairing mode
+ */
+import { Command } from 'commander';
+export declare function createPairingCommand(): Command;

package/dist/commands/pairing.js

@@ -0,0 +1,132 @@
+/**
+ * buddy pairing – DM Pairing CLI commands
+ *
+ * Subcommands:
+ *   buddy pairing status           – show pairing mode status
+ *   buddy pairing list             – list approved senders
+ *   buddy pairing pending          – list pending pairing requests
+ *   buddy pairing approve <code>   – approve a pending request by code
+ *   buddy pairing revoke <id>      – revoke an approved sender
+ *   buddy pairing enable           – enable pairing mode
+ *   buddy pairing disable          – disable pairing mode
+ */
+import { Command } from 'commander';
+import { getDMPairing } from '../channels/dm-pairing.js';
+export function createPairingCommand() {
+    const cmd = new Command('pairing')
+        .description('Manage DM pairing security (allowlist unknown senders on messaging channels)');
+    cmd
+        .command('status')
+        .description('Show pairing mode configuration and statistics')
+        .action(() => {
+        const pairing = getDMPairing();
+        const stats = pairing.getStats();
+        console.log('\nDM Pairing Status');
+        console.log('─'.repeat(40));
+        console.log(`Enabled:         ${stats.enabled ? '✅ yes' : '❌ no'}`);
+        console.log(`Approved senders: ${stats.totalApproved}`);
+        console.log(`Pending requests: ${stats.totalPending}`);
+        console.log(`Blocked senders:  ${stats.totalBlocked}`);
+        if (Object.keys(stats.approvedByChannel).length > 0) {
+            console.log('\nApproved by channel:');
+            for (const [ch, count] of Object.entries(stats.approvedByChannel)) {
+                console.log(`  ${ch}: ${count}`);
+            }
+        }
+    });
+    cmd
+        .command('list')
+        .description('List approved senders')
+        .option('-c, --channel <channel>', 'Filter by channel type')
+        .action(async (opts) => {
+        const pairing = getDMPairing();
+        await pairing.loadAllowlist();
+        const senders = opts.channel
+            ? pairing.listApprovedForChannel(opts.channel)
+            : pairing.listApproved();
+        if (senders.length === 0) {
+            console.log('No approved senders.');
+            return;
+        }
+        console.log(`\nApproved senders (${senders.length}):`);
+        console.log('─'.repeat(60));
+        for (const s of senders) {
+            const when = new Date(s.approvedAt).toLocaleDateString();
+            const name = s.displayName ? ` (${s.displayName})` : '';
+            console.log(`  [${s.channelType}] ${s.senderId}${name}  — approved ${when} by ${s.approvedBy}`);
+        }
+    });
+    cmd
+        .command('pending')
+        .description('List pending pairing requests')
+        .action(() => {
+        const pairing = getDMPairing();
+        const requests = pairing.listPending();
+        if (requests.length === 0) {
+            console.log('No pending pairing requests.');
+            return;
+        }
+        console.log(`\nPending pairing requests (${requests.length}):`);
+        console.log('─'.repeat(60));
+        for (const r of requests) {
+            const exp = new Date(r.expiresAt).toLocaleTimeString();
+            const name = r.displayName ? ` (${r.displayName})` : '';
+            console.log(`  [${r.channelType}] ${r.senderId}${name}`);
+            console.log(`    Code: ${r.code}   Attempts: ${r.attempts}   Expires: ${exp}`);
+            if (r.messageExcerpt) {
+                console.log(`    Message: "${r.messageExcerpt}"`);
+            }
+        }
+    });
+    cmd
+        .command('approve <code>')
+        .description('Approve a pending pairing request by code')
+        .requiredOption('-c, --channel <channel>', 'Channel type (telegram, discord, slack, etc.)')
+        .action((code, opts) => {
+        const pairing = getDMPairing();
+        const sender = pairing.approve(opts.channel, code.toUpperCase());
+        if (!sender) {
+            console.error(`❌ No pending request found for code "${code}" on channel "${opts.channel}".`);
+            console.error('   The code may have expired. Ask the user to send a new message to generate a fresh code.');
+            process.exit(1);
+        }
+        const name = sender.displayName ? ` (${sender.displayName})` : '';
+        console.log(`✅ Approved: [${sender.channelType}] ${sender.senderId}${name}`);
+    });
+    cmd
+        .command('add <senderId>')
+        .description('Directly approve a sender without a pairing code')
+        .requiredOption('-c, --channel <channel>', 'Channel type')
+        .option('-n, --name <name>', 'Display name for this sender')
+        .action(async (senderId, opts) => {
+        const pairing = getDMPairing();
+        const sender = pairing.approveDirectly(opts.channel, senderId, 'owner-cli', opts.name);
+        console.log(`✅ Added: [${sender.channelType}] ${sender.senderId}`);
+        await pairing.persistAllowlist();
+    });
+    cmd
+        .command('revoke <senderId>')
+        .description('Revoke approval for a sender')
+        .requiredOption('-c, --channel <channel>', 'Channel type')
+        .action(async (senderId, opts) => {
+        const pairing = getDMPairing();
+        await pairing.loadAllowlist();
+        const ok = pairing.revoke(opts.channel, senderId);
+        if (!ok) {
+            console.error(`❌ Sender "${senderId}" not found in allowlist for channel "${opts.channel}".`);
+            process.exit(1);
+        }
+        console.log(`✅ Revoked: [${opts.channel}] ${senderId}`);
+    });
+    cmd
+        .command('enable')
+        .description('Enable DM pairing mode (requires restart of channel adapters)')
+        .action(() => {
+        console.log('⚠️  Pairing mode must be enabled via config or environment:');
+        console.log('   Set DM_PAIRING_ENABLED=true in your .env, then restart.');
+        console.log('');
+        console.log('   Or in code: getDMPairing({ enabled: true })');
+    });
+    return cmd;
+}
+//# sourceMappingURL=pairing.js.map

package/dist/commands/pairing.js.map

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

package/dist/commands/research/index.d.ts

@@ -0,0 +1,13 @@
+/**
+ * buddy research – Wide Research CLI command
+ *
+ * Spawns N parallel agent workers to research independent subtopics,
+ * then synthesizes a comprehensive report.
+ *
+ * Usage:
+ *   buddy research "quantum computing breakthroughs in 2025"
+ *   buddy research "best practices for TypeScript monorepos" --workers 8
+ *   buddy research "competitor analysis for Manus AI" --workers 5 --output report.md
+ */
+import { Command } from 'commander';
+export declare function createResearchCommand(): Command;

package/dist/commands/research/index.js

@@ -0,0 +1,91 @@
+/**
+ * buddy research – Wide Research CLI command
+ *
+ * Spawns N parallel agent workers to research independent subtopics,
+ * then synthesizes a comprehensive report.
+ *
+ * Usage:
+ *   buddy research "quantum computing breakthroughs in 2025"
+ *   buddy research "best practices for TypeScript monorepos" --workers 8
+ *   buddy research "competitor analysis for Manus AI" --workers 5 --output report.md
+ */
+import { Command } from 'commander';
+import { WideResearchOrchestrator } from '../../agent/wide-research.js';
+import * as fs from 'fs/promises';
+export function createResearchCommand() {
+    const cmd = new Command('research')
+        .description('Wide Research: spawn parallel agent workers to research a topic comprehensively')
+        .argument('<topic>', 'The topic to research')
+        .option('-w, --workers <n>', 'Number of parallel research workers (default: 5, max: 20)', '5')
+        .option('-r, --rounds <n>', 'Max tool rounds per worker (default: 15)', '15')
+        .option('-o, --output <file>', 'Save the report to a Markdown file')
+        .option('--context <text>', 'Additional context injected into each worker')
+        .action(async (topic, opts) => {
+        const apiKey = process.env.GROK_API_KEY || process.env.ANTHROPIC_API_KEY || '';
+        if (!apiKey) {
+            console.error('❌ No API key found. Set GROK_API_KEY or ANTHROPIC_API_KEY.');
+            process.exit(1);
+        }
+        const workers = Math.min(parseInt(opts.workers, 10) || 5, 20);
+        const maxRoundsPerWorker = parseInt(opts.rounds, 10) || 15;
+        console.log(`\n🔬 Wide Research: "${topic}"`);
+        console.log(`   Workers: ${workers}  |  Max rounds per worker: ${maxRoundsPerWorker}`);
+        console.log('─'.repeat(60));
+        const orchestrator = new WideResearchOrchestrator({
+            workers,
+            maxRoundsPerWorker,
+            context: opts.context,
+        });
+        // Stream progress events
+        orchestrator.on('progress', (event) => {
+            switch (event.type) {
+                case 'decomposed':
+                    console.log(`\n📋 Subtopics (${event.subtopics?.length}):`);
+                    event.subtopics?.forEach((s, i) => console.log(`  ${i + 1}. ${s}`));
+                    console.log('');
+                    break;
+                case 'worker_start':
+                    console.log(`  ▶ [${event.workerIndex + 1}] Starting: ${event.subtopic}`);
+                    break;
+                case 'worker_done':
+                    const icon = event.success ? '✅' : '❌';
+                    console.log(`  ${icon} [${event.workerIndex + 1}] Done: ${event.subtopic}`);
+                    break;
+                case 'aggregating':
+                    console.log('\n🔗 Aggregating results into final report...');
+                    break;
+            }
+        });
+        try {
+            const result = await orchestrator.research(topic, apiKey);
+            console.log('\n' + '─'.repeat(60));
+            console.log(`✅ Research complete!`);
+            console.log(`   Workers succeeded: ${result.successCount}/${result.subtopics.length}`);
+            console.log(`   Duration: ${(result.durationMs / 1000).toFixed(1)}s`);
+            if (opts.output) {
+                const reportContent = [
+                    `# Research Report: ${topic}`,
+                    ``,
+                    `Generated: ${new Date().toISOString()}`,
+                    `Workers: ${result.successCount}/${result.subtopics.length} succeeded`,
+                    `Duration: ${(result.durationMs / 1000).toFixed(1)}s`,
+                    ``,
+                    `---`,
+                    ``,
+                    result.report,
+                ].join('\n');
+                await fs.writeFile(opts.output, reportContent, 'utf-8');
+                console.log(`\n📄 Report saved: ${opts.output}`);
+            }
+            else {
+                console.log('\n' + result.report);
+            }
+        }
+        catch (err) {
+            console.error(`\n❌ Research failed: ${err instanceof Error ? err.message : String(err)}`);
+            process.exit(1);
+        }
+    });
+    return cmd;
+}
+//# sourceMappingURL=index.js.map

package/dist/commands/research/index.js.map

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

package/dist/commands/run-cli/index.d.ts

@@ -0,0 +1,11 @@
+/**
+ * buddy run — observability commands for RunStore runs
+ *
+ * Subcommands:
+ *   buddy run list [--limit N]    → list recent runs
+ *   buddy run show <runId>        → full timeline + metrics + artifacts
+ *   buddy run tail <runId>        → live-stream events (follow mode)
+ *   buddy run replay <runId>      → show timeline + re-execute test steps
+ */
+import type { Command } from 'commander';
+export declare function registerRunCommands(program: Command): void;

package/dist/commands/run-cli/index.js

@@ -0,0 +1,49 @@
+/**
+ * buddy run — observability commands for RunStore runs
+ *
+ * Subcommands:
+ *   buddy run list [--limit N]    → list recent runs
+ *   buddy run show <runId>        → full timeline + metrics + artifacts
+ *   buddy run tail <runId>        → live-stream events (follow mode)
+ *   buddy run replay <runId>      → show timeline + re-execute test steps
+ */
+export function registerRunCommands(program) {
+    const run = program
+        .command('run')
+        .description('Inspect and replay agent runs (observability)');
+    // ── buddy run list ─────────────────────────────────────────────
+    run
+        .command('list')
+        .description('List recent runs')
+        .option('-n, --limit <n>', 'number of runs to show', '20')
+        .action(async (opts) => {
+        const { listRuns } = await import('../../observability/run-viewer.js');
+        listRuns(parseInt(opts.limit, 10));
+    });
+    // ── buddy run show ─────────────────────────────────────────────
+    run
+        .command('show <runId>')
+        .description('Show complete timeline, metrics, and artifacts for a run')
+        .action(async (runId) => {
+        const { showRun } = await import('../../observability/run-viewer.js');
+        await showRun(runId);
+    });
+    // ── buddy run tail ─────────────────────────────────────────────
+    run
+        .command('tail <runId>')
+        .description('Stream run events in real-time (follow mode)')
+        .action(async (runId) => {
+        const { tailRun } = await import('../../observability/run-viewer.js');
+        await tailRun(runId);
+    });
+    // ── buddy run replay ───────────────────────────────────────────
+    run
+        .command('replay <runId>')
+        .description('Show timeline and re-execute test steps')
+        .option('--no-rerun', 'only show timeline, do not re-run tests')
+        .action(async (runId, opts) => {
+        const { replayRun } = await import('../../observability/run-viewer.js');
+        await replayRun(runId, opts.rerun !== false);
+    });
+}
+//# sourceMappingURL=index.js.map

package/dist/commands/run-cli/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/commands/run-cli/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAIH,MAAM,UAAU,mBAAmB,CAAC,OAAgB;IAClD,MAAM,GAAG,GAAG,OAAO;SAChB,OAAO,CAAC,KAAK,CAAC;SACd,WAAW,CAAC,+CAA+C,CAAC,CAAC;IAEhE,kEAAkE;IAClE,GAAG;SACA,OAAO,CAAC,MAAM,CAAC;SACf,WAAW,CAAC,kBAAkB,CAAC;SAC/B,MAAM,CAAC,iBAAiB,EAAE,wBAAwB,EAAE,IAAI,CAAC;SACzD,MAAM,CAAC,KAAK,EAAE,IAAuB,EAAE,EAAE;QACxC,MAAM,EAAE,QAAQ,EAAE,GAAG,MAAM,MAAM,CAAC,mCAAmC,CAAC,CAAC;QACvE,QAAQ,CAAC,QAAQ,CAAC,IAAI,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC,CAAC;IACrC,CAAC,CAAC,CAAC;IAEL,kEAAkE;IAClE,GAAG;SACA,OAAO,CAAC,cAAc,CAAC;SACvB,WAAW,CAAC,0DAA0D,CAAC;SACvE,MAAM,CAAC,KAAK,EAAE,KAAa,EAAE,EAAE;QAC9B,MAAM,EAAE,OAAO,EAAE,GAAG,MAAM,MAAM,CAAC,mCAAmC,CAAC,CAAC;QACtE,MAAM,OAAO,CAAC,KAAK,CAAC,CAAC;IACvB,CAAC,CAAC,CAAC;IAEL,kEAAkE;IAClE,GAAG;SACA,OAAO,CAAC,cAAc,CAAC;SACvB,WAAW,CAAC,8CAA8C,CAAC;SAC3D,MAAM,CAAC,KAAK,EAAE,KAAa,EAAE,EAAE;QAC9B,MAAM,EAAE,OAAO,EAAE,GAAG,MAAM,MAAM,CAAC,mCAAmC,CAAC,CAAC;QACtE,MAAM,OAAO,CAAC,KAAK,CAAC,CAAC;IACvB,CAAC,CAAC,CAAC;IAEL,kEAAkE;IAClE,GAAG;SACA,OAAO,CAAC,gBAAgB,CAAC;SACzB,WAAW,CAAC,yCAAyC,CAAC;SACtD,MAAM,CAAC,YAAY,EAAE,yCAAyC,CAAC;SAC/D,MAAM,CAAC,KAAK,EAAE,KAAa,EAAE,IAAwB,EAAE,EAAE;QACxD,MAAM,EAAE,SAAS,EAAE,GAAG,MAAM,MAAM,CAAC,mCAAmC,CAAC,CAAC;QACxE,MAAM,SAAS,CAAC,KAAK,EAAE,IAAI,CAAC,KAAK,KAAK,KAAK,CAAC,CAAC;IAC/C,CAAC,CAAC,CAAC;AACP,CAAC"}

package/dist/commands/slash/builtin-commands.js

@@ -871,6 +871,72 @@ const workflowCommands = [
     }
 ];
 // ============================================================================
+// Agent Control Commands
+// ============================================================================
+const agentControlCommands = [
+    {
+        name: 'think',
+        description: 'Set reasoning depth for this session (off|minimal|low|medium|high|xhigh)',
+        prompt: '__THINK__',
+        filePath: '',
+        isBuiltin: true,
+        arguments: [
+            { name: 'level', description: 'off, minimal, low, medium, high, xhigh', required: false }
+        ]
+    },
+    {
+        name: 'queue',
+        description: 'Set message queue mode (collect|steer|followup|steer-backlog|interrupt)',
+        prompt: '__QUEUE_MODE__',
+        filePath: '',
+        isBuiltin: true,
+        arguments: [
+            { name: 'mode', description: 'collect (default), steer, followup, steer-backlog, interrupt', required: false }
+        ]
+    },
+    {
+        name: 'subagents',
+        description: 'List, inspect, or stop running sub-agents',
+        prompt: '__SUBAGENTS__',
+        filePath: '',
+        isBuiltin: true,
+        arguments: [
+            { name: 'action', description: 'list (default), stop <id>, log <id>, inspect <id>', required: false }
+        ]
+    },
+    {
+        name: 'new',
+        description: 'Start a fresh session — clears all context and message history',
+        prompt: '__NEW_SESSION__',
+        filePath: '',
+        isBuiltin: true
+    },
+    {
+        name: 'reset',
+        description: 'Hard reset: drop all messages and context, keep system prompt and settings',
+        prompt: '__RESET_CONTEXT__',
+        filePath: '',
+        isBuiltin: true
+    },
+    {
+        name: 'status',
+        description: 'Show session status: model, tokens used, session cost, active tools, queue mode',
+        prompt: '__SESSION_STATUS__',
+        filePath: '',
+        isBuiltin: true
+    },
+    {
+        name: 'verbose',
+        description: 'Toggle verbose output (show tool call details, timings, token counts)',
+        prompt: '__VERBOSE__',
+        filePath: '',
+        isBuiltin: true,
+        arguments: [
+            { name: 'action', description: 'on, off, or toggle (default)', required: false }
+        ]
+    }
+];
+// ============================================================================
 // All Built-in Commands (Combined)
 // ============================================================================
 /**
@@ -894,7 +960,8 @@ export const builtinCommands = [
     ...voiceCommands,
     ...themeCommands,
     ...searchCommands,
-    ...workflowCommands
+    ...workflowCommands,
+    ...agentControlCommands
 ];
 /**
  * Get builtin commands by category.
@@ -917,7 +984,8 @@ export function getCommandsByCategory() {
         voice: voiceCommands,
         theme: themeCommands,
         search: searchCommands,
-        workflow: workflowCommands
+        workflow: workflowCommands,
+        agentControl: agentControlCommands
     };
 }
 //# sourceMappingURL=builtin-commands.js.map