agent-nuvira 1.14.0

package/dist/cli/dashboard.d.ts

@@ -0,0 +1,34 @@
+/**
+ * Dashboard command — Launch the Agent-Baba-D Web UI Dashboard.
+ *
+ * Usage:
+ *   buff dashboard                  — Start dashboard on default port (3030)
+ *   buff dashboard --port 8080      — Start on a specific port
+ *   buff dashboard --host 0.0.0.0   — Listen on all interfaces
+ *   buff dashboard --build           — Build the dashboard (npm run build:dashboard) before starting
+ *   buff dashboard --no-open        — Don't auto-open browser
+ *
+ * The dashboard provides:
+ * - Real-time system overview with stats
+ * - Cost tracking visualization (by provider/model)
+ * - Conversation history browser
+ * - Model benchmark results
+ * - Memory store statistics
+ * - System health monitoring
+ *
+ * Data refreshes automatically via Server-Sent Events every 10 seconds.
+ * The server runs entirely on Node.js built-in modules (no Express, no WebSocket packages).
+ */
+import { Command } from 'commander';
+import { BaseCommand } from './commands.js';
+export declare class DashboardCommand extends BaseCommand {
+    private server;
+    create(): Command;
+    private launchDashboard;
+    /**
+     * Open the browser to the dashboard URL.
+     * Uses the platform-specific command (open, xdg-open, start).
+     */
+    private openBrowser;
+}
+//# sourceMappingURL=dashboard.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"dashboard.d.ts","sourceRoot":"","sources":["../../src/cli/dashboard.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AAEH,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAKpC,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAM5C,qBAAa,gBAAiB,SAAQ,WAAW;IAC/C,OAAO,CAAC,MAAM,CAAyD;IAEvE,MAAM,IAAI,OAAO;YAgBH,eAAe;IA2E7B;;;OAGG;IACH,OAAO,CAAC,WAAW;CAcpB"}

package/dist/cli/dashboard.js

@@ -0,0 +1,126 @@
+/**
+ * Dashboard command — Launch the Agent-Baba-D Web UI Dashboard.
+ *
+ * Usage:
+ *   buff dashboard                  — Start dashboard on default port (3030)
+ *   buff dashboard --port 8080      — Start on a specific port
+ *   buff dashboard --host 0.0.0.0   — Listen on all interfaces
+ *   buff dashboard --build           — Build the dashboard (npm run build:dashboard) before starting
+ *   buff dashboard --no-open        — Don't auto-open browser
+ *
+ * The dashboard provides:
+ * - Real-time system overview with stats
+ * - Cost tracking visualization (by provider/model)
+ * - Conversation history browser
+ * - Model benchmark results
+ * - Memory store statistics
+ * - System health monitoring
+ *
+ * Data refreshes automatically via Server-Sent Events every 10 seconds.
+ * The server runs entirely on Node.js built-in modules (no Express, no WebSocket packages).
+ */
+import { Command } from 'commander';
+import { spawn, execSync } from 'node:child_process';
+import { join, dirname } from 'node:path';
+import { fileURLToPath } from 'node:url';
+import { BaseCommand } from './commands.js';
+import { createDashboardServer } from '../web-dashboard/server.js';
+import { logger } from '../utils/logger.js';
+// ─── DashboardCommand ───────────────────────────────────────────────────────
+export class DashboardCommand extends BaseCommand {
+    server = null;
+    create() {
+        const command = new Command('dashboard')
+            .description('Launch the web-based dashboard for visualizing agent execution and system status');
+        command
+            .option('-p, --port <port>', 'Port to listen on', parseInt, 3030)
+            .option('--host <host>', 'Host to bind to', '127.0.0.1')
+            .option('--no-open', 'Do not auto-open the browser')
+            .option('--build', 'Build the dashboard (npm run build:dashboard) before starting')
+            .action(async (options) => {
+            await this.launchDashboard(options || {});
+        });
+        return command;
+    }
+    async launchDashboard(options) {
+        const port = options.port || 3030;
+        const host = options.host || '127.0.0.1';
+        const shouldOpen = options.open !== false;
+        const shouldBuild = options.build === true;
+        // ── Build the dashboard if requested ────────────────────────────────
+        if (shouldBuild) {
+            logger.info('Building dashboard...');
+            const projectRoot = join(dirname(fileURLToPath(import.meta.url)), '..', '..');
+            try {
+                execSync('npm run build:dashboard', {
+                    cwd: projectRoot,
+                    stdio: 'inherit',
+                    timeout: 120_000, // 2 minutes
+                });
+                logger.success('Dashboard built successfully');
+                console.log('');
+            }
+            catch (err) {
+                const msg = err instanceof Error ? err.message : String(err);
+                logger.error(`Dashboard build failed: ${msg}`);
+                return;
+            }
+        }
+        // Set environment variables for the server
+        process.env.BUFF_DASHBOARD_PORT = String(port);
+        process.env.BUFF_DASHBOARD_HOST = host;
+        logger.highlight('═'.repeat(60));
+        logger.highlight('  🌐  Starting Agent-Baba-D Dashboard');
+        logger.highlight('═'.repeat(60));
+        console.log('');
+        // Start the server directly in-process (no subprocess needed)
+        // Uses only Node.js built-in modules — tsx not required at runtime
+        try {
+            this.server = createDashboardServer();
+            const url = `http://localhost:${port}`;
+            logger.success(`Dashboard running at: ${url}`);
+            console.log('  Press Ctrl+C to stop the dashboard.\n');
+            // Auto-open browser
+            if (shouldOpen) {
+                this.openBrowser(url);
+            }
+            // Keep the process alive until Ctrl+C
+            await new Promise((resolve) => {
+                const shutdown = () => {
+                    logger.info('\nShutting down dashboard...');
+                    if (this.server) {
+                        this.server.server.close();
+                        this.server = null;
+                    }
+                    resolve();
+                    process.exit(0);
+                };
+                process.on('SIGINT', shutdown);
+                process.on('SIGTERM', shutdown);
+            });
+        }
+        catch (err) {
+            logger.error(`Failed to start dashboard: ${err instanceof Error ? err.message : String(err)}`);
+            logger.info('Make sure the dashboard module is available.');
+        }
+    }
+    /**
+     * Open the browser to the dashboard URL.
+     * Uses the platform-specific command (open, xdg-open, start).
+     */
+    openBrowser(url) {
+        const platform = process.platform;
+        const cmd = platform === 'win32' ? 'start' : platform === 'darwin' ? 'open' : 'xdg-open';
+        try {
+            const child = spawn(cmd, [url], {
+                stdio: 'ignore',
+                detached: true,
+            });
+            child.unref();
+        }
+        catch {
+            logger.warn(`Could not auto-open browser. Open manually: ${url}`);
+        }
+    }
+}
+//# sourceMappingURL=dashboard.js.map

package/dist/cli/dashboard.js.map

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

package/dist/cli/doctor.d.ts

@@ -0,0 +1,68 @@
+/**
+ * Doctor command — One-command diagnosis of all provider configurations.
+ *
+ * Usage:
+ *   buff doctor                           — Run full health check on all providers
+ *   buff doctor --provider groq           — Check only a specific provider
+ *   buff doctor --watch                   — Continuous monitoring mode (refreshes every 30s)
+ *   buff doctor --verbose                 — Show detailed diagnostic info
+ *   buff doctor --fix                     — Attempt auto-fix for common issues (create ~/.buff dirs, etc.)
+ *
+ * The health check runs all provider tests in parallel with timeouts:
+ *   1. API Key presence check
+ *   2. Endpoint reachability check
+ *   3. Provider availability check (isAvailable())
+ *   4. Model listing check
+ *   5. Quick generation test (optional, with --verbose)
+ *
+ * Each test returns a status: ✅ PASS, ⚠️  WARN, ❌ FAIL
+ * With fix suggestions for common failure modes.
+ */
+import { Command } from 'commander';
+import { BaseCommand } from './commands.js';
+export type HealthStatus = 'pass' | 'warn' | 'fail';
+export interface CheckResult {
+    name: string;
+    status: HealthStatus;
+    message: string;
+    detail?: string;
+    fix?: string;
+}
+export interface ProviderHealth {
+    providerType: string;
+    displayName: string;
+    configured: boolean;
+    checks: CheckResult[];
+    overallStatus: HealthStatus;
+}
+export interface DoctorReport {
+    timestamp: number;
+    system: CheckResult[];
+    providers: ProviderHealth[];
+    durationMs: number;
+}
+export declare class DoctorCommand extends BaseCommand {
+    create(): Command;
+    private runDiagnosis;
+    private runWatchMode;
+    private runSystemChecks;
+    private checkDocker;
+    private checkConnectivity;
+    private checkProvider;
+    private renderSystemSection;
+    private renderProviderSection;
+    private renderSummary;
+    private autoFix;
+    private statusIcon;
+    private hasApiKey;
+    private createProvider;
+    private getEnvVarName;
+    private getDefaultModel;
+    private getFixSuggestion;
+    private getEndpointFailureDetail;
+    private getEndpointFix;
+    private getGenerationFix;
+    private calculateOverallStatus;
+    private withTimeout;
+}
+//# sourceMappingURL=doctor.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"doctor.d.ts","sourceRoot":"","sources":["../../src/cli/doctor.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AAEH,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAKpC,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAQ5C,MAAM,MAAM,YAAY,GAAG,MAAM,GAAG,MAAM,GAAG,MAAM,CAAC;AAEpD,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,YAAY,CAAC;IACrB,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,GAAG,CAAC,EAAE,MAAM,CAAC;CACd;AAED,MAAM,WAAW,cAAc;IAC7B,YAAY,EAAE,MAAM,CAAC;IACrB,WAAW,EAAE,MAAM,CAAC;IACpB,UAAU,EAAE,OAAO,CAAC;IACpB,MAAM,EAAE,WAAW,EAAE,CAAC;IACtB,aAAa,EAAE,YAAY,CAAC;CAC7B;AAED,MAAM,WAAW,YAAY;IAC3B,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,WAAW,EAAE,CAAC;IACtB,SAAS,EAAE,cAAc,EAAE,CAAC;IAC5B,UAAU,EAAE,MAAM,CAAC;CACpB;AAmBD,qBAAa,aAAc,SAAQ,WAAW;IAC5C,MAAM,IAAI,OAAO;YA2BH,YAAY;YAoEZ,YAAY;YA4BZ,eAAe;YAwEf,WAAW;YAyBX,iBAAiB;YAiCjB,aAAa;IAmL3B,OAAO,CAAC,mBAAmB;IAY3B,OAAO,CAAC,qBAAqB;IA8B7B,OAAO,CAAC,aAAa;YA6BP,OAAO;IAiDrB,OAAO,CAAC,UAAU;IASlB,OAAO,CAAC,SAAS;IAIjB,OAAO,CAAC,cAAc;IAiBtB,OAAO,CAAC,aAAa;IAUrB,OAAO,CAAC,eAAe;IAKvB,OAAO,CAAC,gBAAgB;IAKxB,OAAO,CAAC,wBAAwB;IAWhC,OAAO,CAAC,cAAc;IAWtB,OAAO,CAAC,gBAAgB;IAUxB,OAAO,CAAC,sBAAsB;YAMhB,WAAW;CAW1B"}