agent-nuvira 1.14.0

package/dist/cli/federation.js

@@ -0,0 +1,387 @@
+/**
+ * Federation command — Connect to and manage remote agent instances.
+ *
+ * Usage:
+ *   buff federation status                — Show connection status and info
+ *   buff federation start                 — Start the federation server
+ *   buff federation start --port 8374     — Start on a specific port
+ *   buff federation start --daemon        — Run in background (detached)
+ *   buff federation connect <host>        — Connect to a remote server
+ *   buff federation connect <host> --port 8374
+ *   buff federation connect <host> --secret mykey
+ *   buff federation disconnect            — Disconnect from remote server
+ *   buff federation run <goal>            — Run a task on the remote server
+ *   buff federation run <goal> --agent writer
+ *   buff federation health                — Check remote server health
+ */
+import { Command } from 'commander';
+import { homedir, hostname } from 'node:os';
+import { existsSync, writeFileSync, readFileSync, mkdirSync } from 'node:fs';
+import { join } from 'node:path';
+import inquirer from 'inquirer';
+import { BaseCommand } from './commands.js';
+import { logger } from '../utils/logger.js';
+import { startFederationServer } from '../federation/server.js';
+import { FederationClient } from '../federation/client.js';
+import { DEFAULT_FEDERATION_CONFIG, DEFAULT_FEDERATION_PORT, } from '../federation/protocol.js';
+// ─── Constants ──────────────────────────────────────────────────────────────
+const FEDERATION_CONFIG_PATH = join(homedir(), '.buff', 'federation.json');
+// ─── Helpers ────────────────────────────────────────────────────────────────
+function loadConfig() {
+    try {
+        if (existsSync(FEDERATION_CONFIG_PATH)) {
+            const raw = readFileSync(FEDERATION_CONFIG_PATH, 'utf-8');
+            return { ...DEFAULT_FEDERATION_CONFIG, ...JSON.parse(raw) };
+        }
+    }
+    catch {
+        // Fall through to default
+    }
+    return { ...DEFAULT_FEDERATION_CONFIG };
+}
+function saveConfig(config) {
+    try {
+        const dir = join(homedir(), '.buff');
+        if (!existsSync(dir))
+            mkdirSync(dir, { recursive: true });
+        writeFileSync(FEDERATION_CONFIG_PATH, JSON.stringify(config, null, 2), 'utf-8');
+    }
+    catch {
+        // Non-critical
+    }
+}
+// ─── FederationCommand ──────────────────────────────────────────────────────
+export class FederationCommand extends BaseCommand {
+    client = null;
+    create() {
+        const command = new Command('federation')
+            .description('Connect to and manage remote agent instances');
+        // ── status ────────────────────────────────────────────────────────────
+        command
+            .command('status')
+            .description('Show federation connection status and configuration')
+            .action(async () => {
+            await this.showStatus();
+        });
+        // ── start ─────────────────────────────────────────────────────────────
+        command
+            .command('start')
+            .description('Start the federation server (listens for incoming connections)')
+            .option('-p, --port <port>', 'Port to listen on', parseInt, DEFAULT_FEDERATION_PORT)
+            .option('-s, --secret <secret>', 'Pre-shared authentication key')
+            .option('--host <host>', 'Host to bind to', DEFAULT_FEDERATION_CONFIG.host)
+            .option('--daemon', 'Run in background (detached process)', false)
+            .action(async (options) => {
+            await this.startServer(options || {});
+        });
+        // ── connect ───────────────────────────────────────────────────────────
+        command
+            .command('connect')
+            .description('Connect to a remote federation server')
+            .argument('<host>', 'Remote server hostname or IP address')
+            .option('-p, --port <port>', 'Remote server port', parseInt, DEFAULT_FEDERATION_PORT)
+            .option('-s, --secret <secret>', 'Pre-shared authentication key')
+            .action(async (host, options) => {
+            await this.connectToServer(host, options || {});
+        });
+        // ── disconnect ────────────────────────────────────────────────────────
+        command
+            .command('disconnect')
+            .description('Disconnect from the remote federation server')
+            .action(async () => {
+            await this.disconnectFromServer();
+        });
+        // ── run ───────────────────────────────────────────────────────────────
+        command
+            .command('run')
+            .description('Run a task on the remote federation server')
+            .argument('<goal>', 'The task goal to execute remotely')
+            .option('-a, --agent <agent>', 'Agent type to run', 'writer')
+            .option('-p, --provider <provider>', 'Provider override')
+            .option('-m, --model <model>', 'Model override')
+            .option('--timeout <ms>', 'Task timeout in ms', parseInt)
+            .option('--no-stream', 'Disable progress streaming')
+            .action(async (goal, options) => {
+            await this.runRemoteTask(goal, options || {});
+        });
+        // ── health ────────────────────────────────────────────────────────────
+        command
+            .command('health')
+            .description('Check the health of the remote federation server')
+            .action(async () => {
+            await this.checkHealth();
+        });
+        // ── config ────────────────────────────────────────────────────────────
+        command
+            .command('config')
+            .description('Show or update federation configuration')
+            .option('--show', 'Show current config', true)
+            .option('--set-secret <secret>', 'Set federation secret')
+            .option('--set-port <port>', 'Set federation port', parseInt)
+            .action(async (options) => {
+            await this.manageConfig(options || {});
+        });
+        return command;
+    }
+    // ── Action Handlers ──────────────────────────────────────────────────────
+    async showStatus() {
+        const config = loadConfig();
+        logger.highlight('═'.repeat(60));
+        logger.highlight('  🌐  Federation Status');
+        logger.highlight('═'.repeat(60));
+        console.log(`\n  Mode: ${config.enabled ? '✅ Enabled' : '⏸️ Disabled'}`);
+        console.log(`  Node ID: ${config.nodeId}`);
+        if (config.secret) {
+            console.log(`  Secret: ${'•'.repeat(Math.min(config.secret.length, 12))}`);
+        }
+        else {
+            console.log('  Secret: ⚠️ Not set');
+        }
+        console.log(`\n  📡 Server:`);
+        console.log(`     Host: ${config.host}`);
+        console.log(`     Port: ${config.port}`);
+        console.log(`\n  🎯 Capabilities:`);
+        for (const cap of config.capabilities) {
+            console.log(`     • ${cap}`);
+        }
+        console.log(`\n  ⚙️  Settings:`);
+        console.log(`     Max concurrent tasks: ${config.maxConcurrentTasks}`);
+        console.log(`     Task timeout: ${(config.taskTimeoutMs / 1000 / 60).toFixed(0)} min`);
+        if (this.client) {
+            console.log(`\n  🔗 Remote Connection:`);
+            console.log(`     Status: ${this.client.isConnected() ? '✅ Connected' : '❌ Disconnected'}`);
+            if (this.client.getServerId()) {
+                console.log(`     Remote server: ${this.client.getServerId()}`);
+            }
+        }
+        console.log('');
+    }
+    async startServer(options) {
+        const config = loadConfig();
+        const port = options.port || config.port;
+        const secret = options.secret || config.secret || process.env.FEDERATION_SECRET || '';
+        const host = options.host || config.host;
+        if (!secret) {
+            logger.error('Federation secret is required.');
+            logger.info('Set it with: buff federation config --set-secret <your-secret>');
+            logger.info('Or via: export FEDERATION_SECRET=your-secret');
+            return;
+        }
+        logger.info(`Starting federation server on ${host}:${port}...`);
+        const updatedConfig = {
+            ...config,
+            enabled: true,
+            port,
+            secret,
+            host,
+        };
+        saveConfig(updatedConfig);
+        try {
+            const server = await startFederationServer({
+                port,
+                secret,
+                host,
+                nodeId: hostname(),
+                capabilities: config.capabilities,
+            });
+            logger.success(`Federation server running on ${host}:${port}`);
+            logger.info('  Press Ctrl+C to stop the server.');
+            process.on('SIGINT', () => {
+                logger.info('\nShutting down federation server...');
+                server.close(() => {
+                    logger.success('Federation server stopped.');
+                    process.exit(0);
+                });
+            });
+            process.on('SIGTERM', () => {
+                server.close(() => process.exit(0));
+            });
+            await new Promise(() => { });
+        }
+        catch (err) {
+            logger.error(`Failed to start federation server: ${err instanceof Error ? err.message : String(err)}`);
+        }
+    }
+    async connectToServer(host, options) {
+        const config = loadConfig();
+        let secret = options.secret || config.secret || process.env.FEDERATION_SECRET || '';
+        if (!secret) {
+            const answer = await inquirer.prompt([
+                {
+                    type: 'password',
+                    name: 'secret',
+                    message: 'Enter federation secret:',
+                    validate: (input) => input.length > 0 || 'Secret is required',
+                },
+            ]);
+            secret = answer.secret;
+        }
+        logger.info(`Connecting to ${host}:${options.port || config.port}...`);
+        this.client = new FederationClient({
+            host,
+            port: options.port || config.port,
+            secret,
+            nodeId: hostname(),
+        });
+        this.client.on('connected', () => {
+            logger.success('Connected to federation server.');
+        });
+        this.client.on('error', (err) => {
+            logger.error(`Federation error: ${err.message}`);
+        });
+        this.client.on('task-progress', (event) => {
+            if (event.progress !== undefined) {
+                logger.info(`  Progress: ${event.progress}% — ${event.message || ''}`);
+            }
+        });
+        try {
+            const handshake = await this.client.connect();
+            logger.success(`Connected to server: ${handshake.serverId}`);
+            console.log(`  Session expires: ${new Date(handshake.expiresAt).toLocaleString()}`);
+            console.log(`  Server capabilities: ${handshake.capabilities.join(', ')}`);
+            saveConfig({
+                ...config,
+                enabled: true,
+                host,
+                port: options.port || config.port,
+                secret,
+            });
+        }
+        catch (err) {
+            logger.error(`Failed to connect: ${err instanceof Error ? err.message : String(err)}`);
+            this.client = null;
+        }
+    }
+    async disconnectFromServer() {
+        if (this.client) {
+            this.client.disconnect();
+            this.client = null;
+            logger.success('Disconnected from federation server.');
+        }
+        else {
+            logger.info('Not currently connected to any federation server.');
+        }
+    }
+    async runRemoteTask(goal, options) {
+        if (!this.client || !this.client.isConnected()) {
+            logger.error('Not connected to a federation server.');
+            logger.info('Connect first: buff federation connect <host>');
+            return;
+        }
+        const agentType = options.agent || 'writer';
+        logger.info(`Delegating task to remote server: ${agentType}: ${goal.slice(0, 80)}...`);
+        console.log('');
+        try {
+            const result = await this.client.delegateTask(goal, agentType, {
+                provider: options.provider,
+                model: options.model,
+                timeoutMs: options.timeout,
+                streamProgress: options.stream !== false,
+            });
+            console.log('');
+            if (result.success) {
+                logger.success('Task completed successfully on remote server.');
+            }
+            else {
+                logger.error('Task failed on remote server.');
+            }
+            console.log(`  Summary: ${result.summary}`);
+            if (result.details) {
+                console.log(`  Details: ${result.details.slice(0, 500)}`);
+            }
+            if (result.error) {
+                console.log(`  Error: ${result.error}`);
+            }
+            console.log(`  Duration: ${(result.durationMs / 1000).toFixed(1)}s`);
+            if (result.costUsd) {
+                console.log(`  Cost: $${result.costUsd.toFixed(6)}`);
+            }
+            console.log('');
+        }
+        catch (err) {
+            logger.error(`Remote task failed: ${err instanceof Error ? err.message : String(err)}`);
+        }
+    }
+    async checkHealth() {
+        if (this.client && this.client.isConnected()) {
+            try {
+                const healthData = await this.client.getHealth();
+                this.renderHealth(healthData);
+                return;
+            }
+            catch {
+                // Fall through to unauthenticated health check
+            }
+        }
+        // Try unauthenticated health check
+        const config = loadConfig();
+        try {
+            const response = await fetch(`http://${config.host}:${config.port}/federation/health`);
+            const data = await response.json();
+            // Unwrap envelope if present
+            const healthData = (data?.type === 'response' ? data.payload : data);
+            this.renderHealth({
+                status: (healthData.status || 'unknown'),
+                uptime: healthData.uptime || 0,
+                activeTasks: healthData.activeTasks || 0,
+                completedTasks: healthData.completedTasks || 0,
+                failedTasks: healthData.failedTasks || 0,
+                version: healthData.version || 'unknown',
+                loadAverage: healthData.loadAverage,
+            });
+        }
+        catch {
+            logger.error('Could not connect to federation server.');
+            logger.info('Is the server running? Start it with: buff federation start');
+        }
+    }
+    renderHealth(health) {
+        const statusEmoji = health.status === 'ok' ? '✅' : health.status === 'degraded' ? '⚠️' : '❌';
+        const uptimeMinutes = Math.floor(health.uptime / 1000 / 60);
+        logger.highlight('═'.repeat(60));
+        logger.highlight(`  🌐  Federation Server Health — ${statusEmoji} ${health.status}`);
+        logger.highlight('═'.repeat(60));
+        console.log(`\n  Status: ${health.status}`);
+        console.log(`  Uptime: ${uptimeMinutes} minutes`);
+        console.log(`  Version: ${health.version}`);
+        console.log(`  Active tasks: ${health.activeTasks}`);
+        console.log(`  Completed: ${health.completedTasks}`);
+        console.log(`  Failed: ${health.failedTasks}`);
+        if (health.loadAverage) {
+            console.log(`  Load: ${health.loadAverage.map((l) => l.toFixed(2)).join(', ')}`);
+        }
+        console.log('');
+    }
+    async manageConfig(options) {
+        const config = loadConfig();
+        if (options.setSecret) {
+            config.secret = options.setSecret;
+            saveConfig(config);
+            logger.success('Federation secret updated.');
+        }
+        if (options.setPort) {
+            config.port = options.setPort;
+            saveConfig(config);
+            logger.success(`Federation port updated to ${options.setPort}.`);
+        }
+        if (options.show || (!options.setSecret && !options.setPort)) {
+            logger.highlight('═'.repeat(60));
+            logger.highlight('  ⚙️  Federation Configuration');
+            logger.highlight('═'.repeat(60));
+            console.log(`\n  Enabled: ${config.enabled}`);
+            console.log(`  Host: ${config.host}`);
+            console.log(`  Port: ${config.port}`);
+            console.log(`  Secret: ${config.secret ? '•'.repeat(Math.min(config.secret.length, 12)) : '⚠️ Not set'}`);
+            console.log(`  Node ID: ${config.nodeId}`);
+            console.log(`  Max tasks: ${config.maxConcurrentTasks}`);
+            console.log(`  Task timeout: ${(config.taskTimeoutMs / 1000 / 60).toFixed(0)} min`);
+            console.log(`  Capabilities: ${config.capabilities.join(', ')}`);
+            console.log('');
+            console.log('  Set a value:');
+            console.log('    buff federation config --set-secret <your-secret>');
+            console.log('    buff federation config --set-port <port>');
+            console.log('');
+        }
+    }
+}
+//# sourceMappingURL=federation.js.map

package/dist/cli/federation.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"federation.js","sourceRoot":"","sources":["../../src/cli/federation.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAEH,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,EAAE,OAAO,EAAE,QAAQ,EAAE,MAAM,SAAS,CAAC;AAC5C,OAAO,EAAE,UAAU,EAAE,aAAa,EAAE,YAAY,EAAE,SAAS,EAAE,MAAM,SAAS,CAAC;AAC7E,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACjC,OAAO,QAAQ,MAAM,UAAU,CAAC;AAEhC,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAC5C,OAAO,EAAE,MAAM,EAAE,MAAM,oBAAoB,CAAC;AAC5C,OAAO,EAAE,qBAAqB,EAAE,MAAM,yBAAyB,CAAC;AAChE,OAAO,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAE3D,OAAO,EACL,yBAAyB,EACzB,uBAAuB,GACxB,MAAM,2BAA2B,CAAC;AAEnC,+EAA+E;AAE/E,MAAM,sBAAsB,GAAG,IAAI,CAAC,OAAO,EAAE,EAAE,OAAO,EAAE,iBAAiB,CAAC,CAAC;AAE3E,+EAA+E;AAE/E,SAAS,UAAU;IACjB,IAAI,CAAC;QACH,IAAI,UAAU,CAAC,sBAAsB,CAAC,EAAE,CAAC;YACvC,MAAM,GAAG,GAAG,YAAY,CAAC,sBAAsB,EAAE,OAAO,CAAC,CAAC;YAC1D,OAAO,EAAE,GAAG,yBAAyB,EAAE,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,EAAE,CAAC;QAC9D,CAAC;IACH,CAAC;IAAC,MAAM,CAAC;QACP,0BAA0B;IAC5B,CAAC;IACD,OAAO,EAAE,GAAG,yBAAyB,EAAE,CAAC;AAC1C,CAAC;AAED,SAAS,UAAU,CAAC,MAAwB;IAC1C,IAAI,CAAC;QACH,MAAM,GAAG,GAAG,IAAI,CAAC,OAAO,EAAE,EAAE,OAAO,CAAC,CAAC;QACrC,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC;YAAE,SAAS,CAAC,GAAG,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;QAC1D,aAAa,CAAC,sBAAsB,EAAE,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,EAAE,OAAO,CAAC,CAAC;IAClF,CAAC;IAAC,MAAM,CAAC;QACP,eAAe;IACjB,CAAC;AACH,CAAC;AAED,+EAA+E;AAE/E,MAAM,OAAO,iBAAkB,SAAQ,WAAW;IACxC,MAAM,GAA4B,IAAI,CAAC;IAE/C,MAAM;QACJ,MAAM,OAAO,GAAG,IAAI,OAAO,CAAC,YAAY,CAAC;aACtC,WAAW,CAAC,8CAA8C,CAAC,CAAC;QAE/D,yEAAyE;QACzE,OAAO;aACJ,OAAO,CAAC,QAAQ,CAAC;aACjB,WAAW,CAAC,qDAAqD,CAAC;aAClE,MAAM,CAAC,KAAK,IAAI,EAAE;YACjB,MAAM,IAAI,CAAC,UAAU,EAAE,CAAC;QAC1B,CAAC,CAAC,CAAC;QAEL,yEAAyE;QACzE,OAAO;aACJ,OAAO,CAAC,OAAO,CAAC;aAChB,WAAW,CAAC,gEAAgE,CAAC;aAC7E,MAAM,CAAC,mBAAmB,EAAE,mBAAmB,EAAE,QAAQ,EAAE,uBAAuB,CAAC;aACnF,MAAM,CAAC,uBAAuB,EAAE,+BAA+B,CAAC;aAChE,MAAM,CAAC,eAAe,EAAE,iBAAiB,EAAE,yBAAyB,CAAC,IAAI,CAAC;aAC1E,MAAM,CAAC,UAAU,EAAE,sCAAsC,EAAE,KAAK,CAAC;aACjE,MAAM,CAAC,KAAK,EAAE,OAKd,EAAE,EAAE;YACH,MAAM,IAAI,CAAC,WAAW,CAAC,OAAO,IAAI,EAAE,CAAC,CAAC;QACxC,CAAC,CAAC,CAAC;QAEL,yEAAyE;QACzE,OAAO;aACJ,OAAO,CAAC,SAAS,CAAC;aAClB,WAAW,CAAC,uCAAuC,CAAC;aACpD,QAAQ,CAAC,QAAQ,EAAE,sCAAsC,CAAC;aAC1D,MAAM,CAAC,mBAAmB,EAAE,oBAAoB,EAAE,QAAQ,EAAE,uBAAuB,CAAC;aACpF,MAAM,CAAC,uBAAuB,EAAE,+BAA+B,CAAC;aAChE,MAAM,CAAC,KAAK,EAAE,IAAY,EAAE,OAA4C,EAAE,EAAE;YAC3E,MAAM,IAAI,CAAC,eAAe,CAAC,IAAI,EAAE,OAAO,IAAI,EAAE,CAAC,CAAC;QAClD,CAAC,CAAC,CAAC;QAEL,yEAAyE;QACzE,OAAO;aACJ,OAAO,CAAC,YAAY,CAAC;aACrB,WAAW,CAAC,8CAA8C,CAAC;aAC3D,MAAM,CAAC,KAAK,IAAI,EAAE;YACjB,MAAM,IAAI,CAAC,oBAAoB,EAAE,CAAC;QACpC,CAAC,CAAC,CAAC;QAEL,yEAAyE;QACzE,OAAO;aACJ,OAAO,CAAC,KAAK,CAAC;aACd,WAAW,CAAC,4CAA4C,CAAC;aACzD,QAAQ,CAAC,QAAQ,EAAE,mCAAmC,CAAC;aACvD,MAAM,CAAC,qBAAqB,EAAE,mBAAmB,EAAE,QAAQ,CAAC;aAC5D,MAAM,CAAC,2BAA2B,EAAE,mBAAmB,CAAC;aACxD,MAAM,CAAC,qBAAqB,EAAE,gBAAgB,CAAC;aAC/C,MAAM,CAAC,gBAAgB,EAAE,oBAAoB,EAAE,QAAQ,CAAC;aACxD,MAAM,CAAC,aAAa,EAAE,4BAA4B,CAAC;aACnD,MAAM,CAAC,KAAK,EAAE,IAAY,EAAE,OAM5B,EAAE,EAAE;YACH,MAAM,IAAI,CAAC,aAAa,CAAC,IAAI,EAAE,OAAO,IAAI,EAAE,CAAC,CAAC;QAChD,CAAC,CAAC,CAAC;QAEL,yEAAyE;QACzE,OAAO;aACJ,OAAO,CAAC,QAAQ,CAAC;aACjB,WAAW,CAAC,kDAAkD,CAAC;aAC/D,MAAM,CAAC,KAAK,IAAI,EAAE;YACjB,MAAM,IAAI,CAAC,WAAW,EAAE,CAAC;QAC3B,CAAC,CAAC,CAAC;QAEL,yEAAyE;QACzE,OAAO;aACJ,OAAO,CAAC,QAAQ,CAAC;aACjB,WAAW,CAAC,yCAAyC,CAAC;aACtD,MAAM,CAAC,QAAQ,EAAE,qBAAqB,EAAE,IAAI,CAAC;aAC7C,MAAM,CAAC,uBAAuB,EAAE,uBAAuB,CAAC;aACxD,MAAM,CAAC,mBAAmB,EAAE,qBAAqB,EAAE,QAAQ,CAAC;aAC5D,MAAM,CAAC,KAAK,EAAE,OAAkE,EAAE,EAAE;YACnF,MAAM,IAAI,CAAC,YAAY,CAAC,OAAO,IAAI,EAAE,CAAC,CAAC;QACzC,CAAC,CAAC,CAAC;QAEL,OAAO,OAAO,CAAC;IACjB,CAAC;IAED,4EAA4E;IAEpE,KAAK,CAAC,UAAU;QACtB,MAAM,MAAM,GAAG,UAAU,EAAE,CAAC;QAE5B,MAAM,CAAC,SAAS,CAAC,GAAG,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC,CAAC;QACjC,MAAM,CAAC,SAAS,CAAC,yBAAyB,CAAC,CAAC;QAC5C,MAAM,CAAC,SAAS,CAAC,GAAG,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC,CAAC;QAEjC,OAAO,CAAC,GAAG,CAAC,aAAa,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,aAAa,EAAE,CAAC,CAAC;QACzE,OAAO,CAAC,GAAG,CAAC,cAAc,MAAM,CAAC,MAAM,EAAE,CAAC,CAAC;QAC3C,IAAI,MAAM,CAAC,MAAM,EAAE,CAAC;YAClB,OAAO,CAAC,GAAG,CAAC,aAAa,GAAG,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,MAAM,CAAC,MAAM,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,EAAE,CAAC,CAAC;QAC7E,CAAC;aAAM,CAAC;YACN,OAAO,CAAC,GAAG,CAAC,sBAAsB,CAAC,CAAC;QACtC,CAAC;QAED,OAAO,CAAC,GAAG,CAAC,gBAAgB,CAAC,CAAC;QAC9B,OAAO,CAAC,GAAG,CAAC,cAAc,MAAM,CAAC,IAAI,EAAE,CAAC,CAAC;QACzC,OAAO,CAAC,GAAG,CAAC,cAAc,MAAM,CAAC,IAAI,EAAE,CAAC,CAAC;QAEzC,OAAO,CAAC,GAAG,CAAC,sBAAsB,CAAC,CAAC;QACpC,KAAK,MAAM,GAAG,IAAI,MAAM,CAAC,YAAY,EAAE,CAAC;YACtC,OAAO,CAAC,GAAG,CAAC,UAAU,GAAG,EAAE,CAAC,CAAC;QAC/B,CAAC;QAED,OAAO,CAAC,GAAG,CAAC,mBAAmB,CAAC,CAAC;QACjC,OAAO,CAAC,GAAG,CAAC,8BAA8B,MAAM,CAAC,kBAAkB,EAAE,CAAC,CAAC;QACvE,OAAO,CAAC,GAAG,CAAC,sBAAsB,CAAC,MAAM,CAAC,aAAa,GAAG,IAAI,GAAG,EAAE,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC;QAEvF,IAAI,IAAI,CAAC,MAAM,EAAE,CAAC;YAChB,OAAO,CAAC,GAAG,CAAC,2BAA2B,CAAC,CAAC;YACzC,OAAO,CAAC,GAAG,CAAC,gBAAgB,IAAI,CAAC,MAAM,CAAC,WAAW,EAAE,CAAC,CAAC,CAAC,aAAa,CAAC,CAAC,CAAC,gBAAgB,EAAE,CAAC,CAAC;YAC5F,IAAI,IAAI,CAAC,MAAM,CAAC,WAAW,EAAE,EAAE,CAAC;gBAC9B,OAAO,CAAC,GAAG,CAAC,uBAAuB,IAAI,CAAC,MAAM,CAAC,WAAW,EAAE,EAAE,CAAC,CAAC;YAClE,CAAC;QACH,CAAC;QAED,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;IAClB,CAAC;IAEO,KAAK,CAAC,WAAW,CAAC,OAKzB;QACC,MAAM,MAAM,GAAG,UAAU,EAAE,CAAC;QAC5B,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,IAAI,MAAM,CAAC,IAAI,CAAC;QACzC,MAAM,MAAM,GAAG,OAAO,CAAC,MAAM,IAAI,MAAM,CAAC,MAAM,IAAI,OAAO,CAAC,GAAG,CAAC,iBAAiB,IAAI,EAAE,CAAC;QACtF,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,IAAI,MAAM,CAAC,IAAI,CAAC;QAEzC,IAAI,CAAC,MAAM,EAAE,CAAC;YACZ,MAAM,CAAC,KAAK,CAAC,gCAAgC,CAAC,CAAC;YAC/C,MAAM,CAAC,IAAI,CAAC,gEAAgE,CAAC,CAAC;YAC9E,MAAM,CAAC,IAAI,CAAC,8CAA8C,CAAC,CAAC;YAC5D,OAAO;QACT,CAAC;QAED,MAAM,CAAC,IAAI,CAAC,iCAAiC,IAAI,IAAI,IAAI,KAAK,CAAC,CAAC;QAEhE,MAAM,aAAa,GAAqB;YACtC,GAAG,MAAM;YACT,OAAO,EAAE,IAAI;YACb,IAAI;YACJ,MAAM;YACN,IAAI;SACL,CAAC;QACF,UAAU,CAAC,aAAa,CAAC,CAAC;QAE1B,IAAI,CAAC;YACH,MAAM,MAAM,GAAG,MAAM,qBAAqB,CAAC;gBACzC,IAAI;gBACJ,MAAM;gBACN,IAAI;gBACJ,MAAM,EAAE,QAAQ,EAAE;gBAClB,YAAY,EAAE,MAAM,CAAC,YAAY;aAClC,CAAC,CAAC;YAEH,MAAM,CAAC,OAAO,CAAC,gCAAgC,IAAI,IAAI,IAAI,EAAE,CAAC,CAAC;YAC/D,MAAM,CAAC,IAAI,CAAC,oCAAoC,CAAC,CAAC;YAElD,OAAO,CAAC,EAAE,CAAC,QAAQ,EAAE,GAAG,EAAE;gBACxB,MAAM,CAAC,IAAI,CAAC,sCAAsC,CAAC,CAAC;gBACpD,MAAM,CAAC,KAAK,CAAC,GAAG,EAAE;oBAChB,MAAM,CAAC,OAAO,CAAC,4BAA4B,CAAC,CAAC;oBAC7C,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;gBAClB,CAAC,CAAC,CAAC;YACL,CAAC,CAAC,CAAC;YACH,OAAO,CAAC,EAAE,CAAC,SAAS,EAAE,GAAG,EAAE;gBACzB,MAAM,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC;YACtC,CAAC,CAAC,CAAC;YAEH,MAAM,IAAI,OAAO,CAAO,GAAG,EAAE,GAAE,CAAC,CAAC,CAAC;QACpC,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,MAAM,CAAC,KAAK,CAAC,sCAAsC,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;QACzG,CAAC;IACH,CAAC;IAEO,KAAK,CAAC,eAAe,CAC3B,IAAY,EACZ,OAA2C;QAE3C,MAAM,MAAM,GAAG,UAAU,EAAE,CAAC;QAC5B,IAAI,MAAM,GAAG,OAAO,CAAC,MAAM,IAAI,MAAM,CAAC,MAAM,IAAI,OAAO,CAAC,GAAG,CAAC,iBAAiB,IAAI,EAAE,CAAC;QAEpF,IAAI,CAAC,MAAM,EAAE,CAAC;YACZ,MAAM,MAAM,GAAG,MAAM,QAAQ,CAAC,MAAM,CAAqB;gBACvD;oBACE,IAAI,EAAE,UAAU;oBAChB,IAAI,EAAE,QAAQ;oBACd,OAAO,EAAE,0BAA0B;oBACnC,QAAQ,EAAE,CAAC,KAAa,EAAE,EAAE,CAAC,KAAK,CAAC,MAAM,GAAG,CAAC,IAAI,oBAAoB;iBACtE;aACF,CAAC,CAAC;YACH,MAAM,GAAG,MAAM,CAAC,MAAM,CAAC;QACzB,CAAC;QAED,MAAM,CAAC,IAAI,CAAC,iBAAiB,IAAI,IAAI,OAAO,CAAC,IAAI,IAAI,MAAM,CAAC,IAAI,KAAK,CAAC,CAAC;QAEvE,IAAI,CAAC,MAAM,GAAG,IAAI,gBAAgB,CAAC;YACjC,IAAI;YACJ,IAAI,EAAE,OAAO,CAAC,IAAI,IAAI,MAAM,CAAC,IAAI;YACjC,MAAM;YACN,MAAM,EAAE,QAAQ,EAAE;SACnB,CAAC,CAAC;QAEH,IAAI,CAAC,MAAM,CAAC,EAAE,CAAC,WAAW,EAAE,GAAG,EAAE;YAC/B,MAAM,CAAC,OAAO,CAAC,iCAAiC,CAAC,CAAC;QACpD,CAAC,CAAC,CAAC;QAEH,IAAI,CAAC,MAAM,CAAC,EAAE,CAAC,OAAO,EAAE,CAAC,GAAU,EAAE,EAAE;YACrC,MAAM,CAAC,KAAK,CAAC,qBAAqB,GAAG,CAAC,OAAO,EAAE,CAAC,CAAC;QACnD,CAAC,CAAC,CAAC;QAEH,IAAI,CAAC,MAAM,CAAC,EAAE,CAAC,eAAe,EAAE,CAAC,KAAU,EAAE,EAAE;YAC7C,IAAI,KAAK,CAAC,QAAQ,KAAK,SAAS,EAAE,CAAC;gBACjC,MAAM,CAAC,IAAI,CAAC,eAAe,KAAK,CAAC,QAAQ,OAAO,KAAK,CAAC,OAAO,IAAI,EAAE,EAAE,CAAC,CAAC;YACzE,CAAC;QACH,CAAC,CAAC,CAAC;QAEH,IAAI,CAAC;YACH,MAAM,SAAS,GAAG,MAAM,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC;YAC9C,MAAM,CAAC,OAAO,CAAC,wBAAwB,SAAS,CAAC,QAAQ,EAAE,CAAC,CAAC;YAC7D,OAAO,CAAC,GAAG,CAAC,sBAAsB,IAAI,IAAI,CAAC,SAAS,CAAC,SAAS,CAAC,CAAC,cAAc,EAAE,EAAE,CAAC,CAAC;YACpF,OAAO,CAAC,GAAG,CAAC,0BAA0B,SAAS,CAAC,YAAY,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;YAE3E,UAAU,CAAC;gBACT,GAAG,MAAM;gBACT,OAAO,EAAE,IAAI;gBACb,IAAI;gBACJ,IAAI,EAAE,OAAO,CAAC,IAAI,IAAI,MAAM,CAAC,IAAI;gBACjC,MAAM;aACP,CAAC,CAAC;QACL,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,MAAM,CAAC,KAAK,CAAC,sBAAsB,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;YACvF,IAAI,CAAC,MAAM,GAAG,IAAI,CAAC;QACrB,CAAC;IACH,CAAC;IAEO,KAAK,CAAC,oBAAoB;QAChC,IAAI,IAAI,CAAC,MAAM,EAAE,CAAC;YAChB,IAAI,CAAC,MAAM,CAAC,UAAU,EAAE,CAAC;YACzB,IAAI,CAAC,MAAM,GAAG,IAAI,CAAC;YACnB,MAAM,CAAC,OAAO,CAAC,sCAAsC,CAAC,CAAC;QACzD,CAAC;aAAM,CAAC;YACN,MAAM,CAAC,IAAI,CAAC,mDAAmD,CAAC,CAAC;QACnE,CAAC;IACH,CAAC;IAEO,KAAK,CAAC,aAAa,CACzB,IAAY,EACZ,OAMC;QAED,IAAI,CAAC,IAAI,CAAC,MAAM,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,WAAW,EAAE,EAAE,CAAC;YAC/C,MAAM,CAAC,KAAK,CAAC,uCAAuC,CAAC,CAAC;YACtD,MAAM,CAAC,IAAI,CAAC,+CAA+C,CAAC,CAAC;YAC7D,OAAO;QACT,CAAC;QAED,MAAM,SAAS,GAAG,OAAO,CAAC,KAAK,IAAI,QAAQ,CAAC;QAC5C,MAAM,CAAC,IAAI,CAAC,qCAAqC,SAAS,KAAK,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,KAAK,CAAC,CAAC;QACvF,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;QAEhB,IAAI,CAAC;YACH,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,MAAM,CAAC,YAAY,CAAC,IAAI,EAAE,SAAS,EAAE;gBAC7D,QAAQ,EAAE,OAAO,CAAC,QAAQ;gBAC1B,KAAK,EAAE,OAAO,CAAC,KAAK;gBACpB,SAAS,EAAE,OAAO,CAAC,OAAO;gBAC1B,cAAc,EAAE,OAAO,CAAC,MAAM,KAAK,KAAK;aACzC,CAAC,CAAC;YAEH,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;YAChB,IAAI,MAAM,CAAC,OAAO,EAAE,CAAC;gBACnB,MAAM,CAAC,OAAO,CAAC,+CAA+C,CAAC,CAAC;YAClE,CAAC;iBAAM,CAAC;gBACN,MAAM,CAAC,KAAK,CAAC,+BAA+B,CAAC,CAAC;YAChD,CAAC;YAED,OAAO,CAAC,GAAG,CAAC,cAAc,MAAM,CAAC,OAAO,EAAE,CAAC,CAAC;YAC5C,IAAI,MAAM,CAAC,OAAO,EAAE,CAAC;gBACnB,OAAO,CAAC,GAAG,CAAC,cAAc,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC,EAAE,CAAC,CAAC;YAC5D,CAAC;YACD,IAAI,MAAM,CAAC,KAAK,EAAE,CAAC;gBACjB,OAAO,CAAC,GAAG,CAAC,YAAY,MAAM,CAAC,KAAK,EAAE,CAAC,CAAC;YAC1C,CAAC;YACD,OAAO,CAAC,GAAG,CAAC,eAAe,CAAC,MAAM,CAAC,UAAU,GAAG,IAAI,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC;YACrE,IAAI,MAAM,CAAC,OAAO,EAAE,CAAC;gBACnB,OAAO,CAAC,GAAG,CAAC,YAAY,MAAM,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;YACvD,CAAC;YACD,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;QAClB,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,MAAM,CAAC,KAAK,CAAC,uBAAuB,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;QAC1F,CAAC;IACH,CAAC;IAEO,KAAK,CAAC,WAAW;QACvB,IAAI,IAAI,CAAC,MAAM,IAAI,IAAI,CAAC,MAAM,CAAC,WAAW,EAAE,EAAE,CAAC;YAC7C,IAAI,CAAC;gBACH,MAAM,UAAU,GAAG,MAAM,IAAI,CAAC,MAAM,CAAC,SAAS,EAAE,CAAC;gBACjD,IAAI,CAAC,YAAY,CAAC,UAAU,CAAC,CAAC;gBAC9B,OAAO;YACT,CAAC;YAAC,MAAM,CAAC;gBACP,+CAA+C;YACjD,CAAC;QACH,CAAC;QAED,mCAAmC;QACnC,MAAM,MAAM,GAAG,UAAU,EAAE,CAAC;QAC5B,IAAI,CAAC;YACH,MAAM,QAAQ,GAAG,MAAM,KAAK,CAC1B,UAAU,MAAM,CAAC,IAAI,IAAI,MAAM,CAAC,IAAI,oBAAoB,CACzD,CAAC;YACF,MAAM,IAAI,GAAG,MAAM,QAAQ,CAAC,IAAI,EAA6B,CAAC;YAC9D,6BAA6B;YAC7B,MAAM,UAAU,GAAG,CAAC,IAAI,EAAE,IAAI,KAAK,UAAU,CAAC,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC,IAAI,CAQlE,CAAC;YACF,IAAI,CAAC,YAAY,CAAC;gBAChB,MAAM,EAAE,CAAC,UAAU,CAAC,MAAM,IAAI,SAAS,CAAQ;gBAC/C,MAAM,EAAE,UAAU,CAAC,MAAM,IAAI,CAAC;gBAC9B,WAAW,EAAE,UAAU,CAAC,WAAW,IAAI,CAAC;gBACxC,cAAc,EAAE,UAAU,CAAC,cAAc,IAAI,CAAC;gBAC9C,WAAW,EAAE,UAAU,CAAC,WAAW,IAAI,CAAC;gBACxC,OAAO,EAAE,UAAU,CAAC,OAAO,IAAI,SAAS;gBACxC,WAAW,EAAE,UAAU,CAAC,WAAW;aACpC,CAAC,CAAC;QACL,CAAC;QAAC,MAAM,CAAC;YACP,MAAM,CAAC,KAAK,CAAC,yCAAyC,CAAC,CAAC;YACxD,MAAM,CAAC,IAAI,CAAC,6DAA6D,CAAC,CAAC;QAC7E,CAAC;IACH,CAAC;IAEO,YAAY,CAAC,MAQpB;QACC,MAAM,WAAW,GAAG,MAAM,CAAC,MAAM,KAAK,IAAI,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,MAAM,CAAC,MAAM,KAAK,UAAU,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,GAAG,CAAC;QAC7F,MAAM,aAAa,GAAG,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,MAAM,GAAG,IAAI,GAAG,EAAE,CAAC,CAAC;QAE5D,MAAM,CAAC,SAAS,CAAC,GAAG,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC,CAAC;QACjC,MAAM,CAAC,SAAS,CAAC,oCAAoC,WAAW,IAAI,MAAM,CAAC,MAAM,EAAE,CAAC,CAAC;QACrF,MAAM,CAAC,SAAS,CAAC,GAAG,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC,CAAC;QAEjC,OAAO,CAAC,GAAG,CAAC,eAAe,MAAM,CAAC,MAAM,EAAE,CAAC,CAAC;QAC5C,OAAO,CAAC,GAAG,CAAC,aAAa,aAAa,UAAU,CAAC,CAAC;QAClD,OAAO,CAAC,GAAG,CAAC,cAAc,MAAM,CAAC,OAAO,EAAE,CAAC,CAAC;QAC5C,OAAO,CAAC,GAAG,CAAC,mBAAmB,MAAM,CAAC,WAAW,EAAE,CAAC,CAAC;QACrD,OAAO,CAAC,GAAG,CAAC,gBAAgB,MAAM,CAAC,cAAc,EAAE,CAAC,CAAC;QACrD,OAAO,CAAC,GAAG,CAAC,aAAa,MAAM,CAAC,WAAW,EAAE,CAAC,CAAC;QAC/C,IAAI,MAAM,CAAC,WAAW,EAAE,CAAC;YACvB,OAAO,CAAC,GAAG,CAAC,WAAW,MAAM,CAAC,WAAW,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QACnF,CAAC;QACD,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;IAClB,CAAC;IAEO,KAAK,CAAC,YAAY,CAAC,OAI1B;QACC,MAAM,MAAM,GAAG,UAAU,EAAE,CAAC;QAE5B,IAAI,OAAO,CAAC,SAAS,EAAE,CAAC;YACtB,MAAM,CAAC,MAAM,GAAG,OAAO,CAAC,SAAS,CAAC;YAClC,UAAU,CAAC,MAAM,CAAC,CAAC;YACnB,MAAM,CAAC,OAAO,CAAC,4BAA4B,CAAC,CAAC;QAC/C,CAAC;QAED,IAAI,OAAO,CAAC,OAAO,EAAE,CAAC;YACpB,MAAM,CAAC,IAAI,GAAG,OAAO,CAAC,OAAO,CAAC;YAC9B,UAAU,CAAC,MAAM,CAAC,CAAC;YACnB,MAAM,CAAC,OAAO,CAAC,8BAA8B,OAAO,CAAC,OAAO,GAAG,CAAC,CAAC;QACnE,CAAC;QAED,IAAI,OAAO,CAAC,IAAI,IAAI,CAAC,CAAC,OAAO,CAAC,SAAS,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,EAAE,CAAC;YAC7D,MAAM,CAAC,SAAS,CAAC,GAAG,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC,CAAC;YACjC,MAAM,CAAC,SAAS,CAAC,gCAAgC,CAAC,CAAC;YACnD,MAAM,CAAC,SAAS,CAAC,GAAG,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC,CAAC;YACjC,OAAO,CAAC,GAAG,CAAC,gBAAgB,MAAM,CAAC,OAAO,EAAE,CAAC,CAAC;YAC9C,OAAO,CAAC,GAAG,CAAC,WAAW,MAAM,CAAC,IAAI,EAAE,CAAC,CAAC;YACtC,OAAO,CAAC,GAAG,CAAC,WAAW,MAAM,CAAC,IAAI,EAAE,CAAC,CAAC;YACtC,OAAO,CAAC,GAAG,CAAC,aAAa,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,GAAG,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,MAAM,CAAC,MAAM,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,YAAY,EAAE,CAAC,CAAC;YAC1G,OAAO,CAAC,GAAG,CAAC,cAAc,MAAM,CAAC,MAAM,EAAE,CAAC,CAAC;YAC3C,OAAO,CAAC,GAAG,CAAC,gBAAgB,MAAM,CAAC,kBAAkB,EAAE,CAAC,CAAC;YACzD,OAAO,CAAC,GAAG,CAAC,mBAAmB,CAAC,MAAM,CAAC,aAAa,GAAG,IAAI,GAAG,EAAE,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC;YACpF,OAAO,CAAC,GAAG,CAAC,mBAAmB,MAAM,CAAC,YAAY,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;YACjE,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;YAChB,OAAO,CAAC,GAAG,CAAC,gBAAgB,CAAC,CAAC;YAC9B,OAAO,CAAC,GAAG,CAAC,uDAAuD,CAAC,CAAC;YACrE,OAAO,CAAC,GAAG,CAAC,8CAA8C,CAAC,CAAC;YAC5D,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;QAClB,CAAC;IACH,CAAC;CACF"}

package/dist/cli/history.d.ts

@@ -0,0 +1,22 @@
+/**
+ * History command — Browse and search conversation history.
+ *
+ * Usage:
+ *   buff history              — Show recent conversations
+ *   buff history list         — Show all saved conversations
+ *   buff history search <q>   — Search conversations by keyword
+ *   buff history show <id>    — Show a specific conversation
+ *   buff history clear        — Clear all history
+ *   buff history prune        — Remove conversations older than 30 days
+ */
+import { Command } from 'commander';
+import { BaseCommand } from './commands.js';
+export declare class HistoryCommand extends BaseCommand {
+    create(): Command;
+    private listHistory;
+    private searchHistory;
+    private showSession;
+    private clearHistory;
+    private pruneHistory;
+}
+//# sourceMappingURL=history.d.ts.map

package/dist/cli/history.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"history.d.ts","sourceRoot":"","sources":["../../src/cli/history.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAEpC,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAI5C,qBAAa,cAAe,SAAQ,WAAW;IAC7C,MAAM,IAAI,OAAO;IAyDjB,OAAO,CAAC,WAAW;IAqBnB,OAAO,CAAC,aAAa;IAoBrB,OAAO,CAAC,WAAW;IAwCnB,OAAO,CAAC,YAAY;IAKpB,OAAO,CAAC,YAAY;CAKrB"}

package/dist/cli/history.js

@@ -0,0 +1,140 @@
+/**
+ * History command — Browse and search conversation history.
+ *
+ * Usage:
+ *   buff history              — Show recent conversations
+ *   buff history list         — Show all saved conversations
+ *   buff history search <q>   — Search conversations by keyword
+ *   buff history show <id>    — Show a specific conversation
+ *   buff history clear        — Clear all history
+ *   buff history prune        — Remove conversations older than 30 days
+ */
+import { Command } from 'commander';
+import { BaseCommand } from './commands.js';
+import { getChatHistory } from '../context/history.js';
+import { logger } from '../utils/logger.js';
+export class HistoryCommand extends BaseCommand {
+    create() {
+        const command = new Command('history')
+            .description('Browse and search conversation history');
+        // ── list ─────────────────────────────────────────────────────────────
+        command
+            .command('list')
+            .description('Show all saved conversations')
+            .option('-l, --limit <number>', 'Maximum results to show', parseInt, 20)
+            .action((options) => {
+            this.listHistory(options?.limit || 20);
+        });
+        // ── search ───────────────────────────────────────────────────────────
+        command
+            .command('search')
+            .description('Search conversations by keyword')
+            .argument('<query>', 'Search keyword or phrase')
+            .option('-l, --limit <number>', 'Maximum results', parseInt, 10)
+            .action((query, options) => {
+            this.searchHistory(query, options?.limit || 10);
+        });
+        // ── show ─────────────────────────────────────────────────────────────
+        command
+            .command('show')
+            .description('Show a specific conversation')
+            .argument('<id>', 'Session ID (e.g., session-1712345678-abc123)')
+            .action((id) => {
+            this.showSession(id);
+        });
+        // ── clear ────────────────────────────────────────────────────────────
+        command
+            .command('clear')
+            .description('Clear all conversation history')
+            .action(() => {
+            this.clearHistory();
+        });
+        // ── prune ────────────────────────────────────────────────────────────
+        command
+            .command('prune')
+            .description('Remove conversations older than the retention period')
+            .option('-d, --days <number>', 'Retention period in days', parseInt, 30)
+            .action((options) => {
+            this.pruneHistory(options?.days || 30);
+        });
+        // Default: show recent conversations
+        command.action(() => {
+            this.listHistory(15);
+        });
+        return command;
+    }
+    listHistory(limit) {
+        const history = getChatHistory();
+        const sessions = history.getAllSessions(limit);
+        if (sessions.length === 0) {
+            logger.info('No conversation history found.');
+            return;
+        }
+        logger.highlight(`${'═'.repeat(60)}`);
+        logger.highlight(`  📝  Conversation History (${history.count()} total)`);
+        logger.highlight(`${'═'.repeat(60)}`);
+        console.log('');
+        for (const session of sessions) {
+            console.log(history.formatSessionSummary(session));
+        }
+        console.log(`\n  Show a conversation: buff history show <session-id>`);
+        console.log('');
+    }
+    searchHistory(query, limit) {
+        const history = getChatHistory();
+        const results = history.search(query, limit);
+        if (results.length === 0) {
+            logger.info(`No conversations found matching "${query}".`);
+            return;
+        }
+        logger.highlight(`${'═'.repeat(60)}`);
+        logger.highlight(`  🔍  Search Results: "${query}" (${results.length} found)`);
+        logger.highlight(`${'═'.repeat(60)}`);
+        console.log('');
+        for (const session of results) {
+            console.log(history.formatSessionSummary(session));
+        }
+        console.log('');
+    }
+    showSession(id) {
+        const history = getChatHistory();
+        // Support partial ID matching
+        const sessions = history.getAllSessions(100);
+        const match = sessions.find((s) => s.id === id || s.id.startsWith(id) || s.id.includes(id));
+        if (!match) {
+            logger.error(`Session not found: ${id}`);
+            logger.info('Use `buff history list` to see available sessions.');
+            return;
+        }
+        const date = new Date(match.startedAt).toLocaleString();
+        const tags = match.tags.length > 0 ? ` [${match.tags.join(', ')}]` : '';
+        logger.highlight(`${'═'.repeat(60)}`);
+        logger.highlight(`  💬  Conversation: ${match.summary.slice(0, 50)}`);
+        logger.highlight(`${'═'.repeat(60)}`);
+        console.log(`  Provider: ${match.provider}  |  Model: ${match.model}  |  Date: ${date}${tags}`);
+        console.log(`  ${match.messages.length} messages`);
+        console.log('');
+        // Show messages (truncate long outputs)
+        for (const msg of match.messages) {
+            const prefix = msg.role === 'user' ? '👤 You:' : '🤖 AI:';
+            const content = msg.content.length > 500
+                ? msg.content.slice(0, 500) + '...\n  (truncated, use buff history show <id> to see full)'
+                : msg.content;
+            console.log(`  ${prefix}`);
+            console.log(`  ${content}`);
+            console.log('');
+        }
+        logger.highlight(`${'═'.repeat(60)}`);
+        console.log('');
+    }
+    clearHistory() {
+        getChatHistory().clear();
+        logger.success('Conversation history cleared.');
+    }
+    pruneHistory(days) {
+        const history = getChatHistory();
+        const removed = history.prune(days);
+        logger.success(`Removed ${removed} old conversation(s) older than ${days} days.`);
+    }
+}
+//# sourceMappingURL=history.js.map

package/dist/cli/history.js.map

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

package/dist/cli/init.d.ts

@@ -0,0 +1,49 @@
+/**
+ * Init command — Scaffold new projects from templates.
+ *
+ * Usage:
+ *   buff init                    — Interactive prompt for project name and template
+ *   buff init my-app             — Create project 'my-app' with interactive template picker
+ *   buff init my-app --template node-cli  — Create from a specific template
+ *   buff init my-app --list      — List available templates
+ *   buff init my-app --template custom --template-dir ~/my-templates
+ *
+ * Templates are stored in ~/.buff/templates/ and can be custom.
+ * Built-in templates ship with the CLI.
+ */
+import { Command } from 'commander';
+import { BaseCommand } from './commands.js';
+export interface InitTemplate {
+    /** Template identifier */
+    id: string;
+    /** Human-readable name */
+    name: string;
+    /** Short description */
+    description: string;
+    /** Files to create (key = path, value = content or generator function) */
+    files: Record<string, string | ((projectName: string) => string)>;
+    /** Dependencies to add (npm packages, etc.) */
+    dependencies?: string[];
+    /** Dev dependencies */
+    devDependencies?: string[];
+    /** Post-creation instructions */
+    postInstall?: string[];
+}
+export declare class InitCommand extends BaseCommand {
+    create(): Command;
+    private execute;
+    private listTemplates;
+    /**
+     * Get all available templates (built-in + custom from ~/.buff/templates/).
+     */
+    private getAllTemplates;
+    /**
+     * Find a template by ID (searches built-in first, then custom).
+     */
+    private findTemplate;
+    /**
+     * Print the project structure recursively.
+     */
+    private printStructure;
+}
+//# sourceMappingURL=init.d.ts.map

package/dist/cli/init.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"init.d.ts","sourceRoot":"","sources":["../../src/cli/init.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAMpC,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAM5C,MAAM,WAAW,YAAY;IAC3B,0BAA0B;IAC1B,EAAE,EAAE,MAAM,CAAC;IACX,0BAA0B;IAC1B,IAAI,EAAE,MAAM,CAAC;IACb,wBAAwB;IACxB,WAAW,EAAE,MAAM,CAAC;IACpB,0EAA0E;IAC1E,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,CAAC,CAAC,WAAW,EAAE,MAAM,KAAK,MAAM,CAAC,CAAC,CAAC;IAClE,+CAA+C;IAC/C,YAAY,CAAC,EAAE,MAAM,EAAE,CAAC;IACxB,uBAAuB;IACvB,eAAe,CAAC,EAAE,MAAM,EAAE,CAAC;IAC3B,iCAAiC;IACjC,WAAW,CAAC,EAAE,MAAM,EAAE,CAAC;CACxB;AAoLD,qBAAa,WAAY,SAAQ,WAAW;IAC1C,MAAM,IAAI,OAAO;YAsBH,OAAO;IAiKrB,OAAO,CAAC,aAAa;IAuBrB;;OAEG;IACH,OAAO,CAAC,eAAe;IA0BvB;;OAEG;IACH,OAAO,CAAC,YAAY;IAKpB;;OAEG;IACH,OAAO,CAAC,cAAc;CAavB"}