agent-nuvira 1.14.0

package/dist/cli/models.js

@@ -0,0 +1,132 @@
+import { Command } from 'commander';
+import ora from 'ora';
+import { BaseCommand } from './commands.js';
+import { resolveProvider } from './router.js';
+import { logger } from '../utils/logger.js';
+/**
+ * Models command — list available models from providers
+ * agent-baba-d models [--provider nim]
+ */
+export class ModelsCommand extends BaseCommand {
+    create() {
+        const command = new Command('models')
+            .description('List available models from inference providers')
+            .option('-p, --provider <provider>', 'Only show models from this provider (nim, gemini, openrouter, groq, local)')
+            .option('-s, --search <keyword>', 'Search/filter models by keyword')
+            .option('--all', 'Show all models (including unconfigured providers)', false)
+            .option('--verify', 'Verify API keys and show configuration status for all providers', false)
+            .action(async (options) => {
+            await this.execute(options || {});
+        });
+        return command;
+    }
+    async execute(options) {
+        const providersToCheck = options?.provider
+            ? [options.provider]
+            : ['nim', 'gemini', 'openrouter', 'groq', 'local'];
+        // If --verify, show API key/configuration status and then list models
+        if (options?.verify) {
+            console.log();
+            logger.highlight('🔑 Provider Configuration Status\n');
+            for (const providerType of providersToCheck) {
+                const { provider } = resolveProvider(this.configManager, providerType);
+                const available = await provider.isAvailable();
+                const config = this.configManager.getProviderConfig(providerType).config;
+                const hasKey = !!config.apiKey;
+                const keyPreview = hasKey
+                    ? `${config.apiKey.slice(0, 8)}...${config.apiKey.slice(-4)}`
+                    : 'Not set';
+                if (available) {
+                    logger.success(`  ✅ ${provider.name}`);
+                }
+                else {
+                    logger.info(`  ⛔ ${provider.name}`);
+                }
+                console.log(`       API Key: ${keyPreview}`);
+                console.log(`       Model: ${config.model || 'default'}`);
+                console.log();
+            }
+        }
+        const allResults = [];
+        for (const providerType of providersToCheck) {
+            const { provider } = resolveProvider(this.configManager, providerType);
+            const available = await provider.isAvailable();
+            if (!available && !options?.all) {
+                logger.debug(`${provider.name} not configured — skipping`);
+                continue;
+            }
+            const s = ora(`Fetching models from ${provider.name}...`).start();
+            try {
+                const models = await provider.listModels();
+                s.stop();
+                if (models.length === 0) {
+                    if (available) {
+                        logger.info(`${provider.name}: No models found or API not reachable`);
+                    }
+                    else {
+                        logger.info(`${provider.name}: Not configured`);
+                    }
+                    continue;
+                }
+                for (const model of models) {
+                    allResults.push({
+                        provider: provider.name,
+                        name: model.name,
+                        id: model.id,
+                        owner: model.owner,
+                        description: model.description,
+                    });
+                }
+                logger.success(`${provider.name}: ${models.length} models found`);
+            }
+            catch (err) {
+                s.stop();
+                logger.error(`${provider.name}: Failed to fetch models — ${String(err)}`);
+            }
+        }
+        // Filter by search keyword if provided
+        const filtered = options?.search
+            ? allResults.filter((m) => m.name.toLowerCase().includes(options.search.toLowerCase()) ||
+                m.id.toLowerCase().includes(options.search.toLowerCase()) ||
+                (m.owner || '').toLowerCase().includes(options.search.toLowerCase()))
+            : allResults;
+        if (filtered.length === 0) {
+            if (options?.search) {
+                logger.info(`No models found matching "${options.search}"`);
+            }
+            else {
+                logger.info('No models found. Configure a provider first with: agent-baba-d config set');
+            }
+            return;
+        }
+        // Display results
+        console.log(`\n${'='.repeat(60)}`);
+        logger.highlight(`📋 Available Models (${filtered.length})`);
+        console.log(`${'='.repeat(60)}`);
+        const grouped = {};
+        for (const m of filtered) {
+            if (!grouped[m.provider])
+                grouped[m.provider] = [];
+            grouped[m.provider].push(m);
+        }
+        for (const [providerName, models] of Object.entries(grouped)) {
+            console.log(`\n${providerName}:`);
+            console.log('-'.repeat(40));
+            for (const m of models.slice(0, 30)) { // show max 30 per provider
+                const owner = m.owner ? ` [${m.owner}]` : '';
+                const desc = m.description ? ` — ${m.description.slice(0, 60)}` : '';
+                console.log(`  ${m.name}${owner}${desc}`);
+            }
+            if (models.length > 30) {
+                console.log(`  ... and ${models.length - 30} more`);
+            }
+        }
+        console.log(`\n${'='.repeat(60)}`);
+        if (allResults.length > 0) {
+            logger.info('\nUse a model by specifying it with --model:');
+            console.log('  agent-baba-d chat --provider nim --model <model-id>');
+            console.log('  agent-baba-d edit file.js --provider openrouter --model <model-id>');
+        }
+    }
+}
+//# sourceMappingURL=models.js.map

package/dist/cli/models.js.map

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

package/dist/cli/plan.d.ts

@@ -0,0 +1,11 @@
+import { Command } from 'commander';
+import { BaseCommand } from './commands.js';
+/**
+ * Plan command — generate implementation plans for code changes
+ * buff plan <directory> [--provider openrouter] [--task "add user auth"]
+ */
+export declare class PlanCommand extends BaseCommand {
+    create(): Command;
+    private execute;
+}
+//# sourceMappingURL=plan.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"plan.d.ts","sourceRoot":"","sources":["../../src/cli/plan.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAGpC,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAI5C;;;GAGG;AACH,qBAAa,WAAY,SAAQ,WAAW;IAC1C,MAAM,IAAI,OAAO;YAeH,OAAO;CA6EtB"}

package/dist/cli/plan.js

@@ -0,0 +1,94 @@
+import { Command } from 'commander';
+import { existsSync, statSync } from 'node:fs';
+import ora from 'ora';
+import { BaseCommand } from './commands.js';
+import { ContextParser } from '../context/parser.js';
+import { logger } from '../utils/logger.js';
+/**
+ * Plan command — generate implementation plans for code changes
+ * buff plan <directory> [--provider openrouter] [--task "add user auth"]
+ */
+export class PlanCommand extends BaseCommand {
+    create() {
+        const command = new Command('plan')
+            .description('Generate an implementation plan for a codebase task')
+            .argument('[target]', 'File or directory to plan for', '.')
+            .option('-t, --task <text>', 'Description of the task to plan')
+            .option('-p, --provider <provider>', 'Inference provider')
+            .option('-m, --model <model>', 'Model to use')
+            .option('-v, --verbose', 'Show full context being sent to the model')
+            .action(async (target, options) => {
+            await this.execute(target, options || {});
+        });
+        return command;
+    }
+    async execute(target, options) {
+        const { type, provider } = await this.getProvider(options || {});
+        const available = await provider.isAvailable();
+        if (!available) {
+            logger.error(`${provider.name} is not available. Check your configuration.`);
+            return;
+        }
+        const task = options?.task || 'Analyze the codebase and suggest improvements';
+        const parser = new ContextParser({
+            maxTokens: 4096,
+            priorityPatterns: ['package.json', 'tsconfig.json', 'index.ts', 'main.ts', 'README.md'],
+        });
+        let contextStr;
+        const spinner = ora('Analyzing codebase...').start();
+        try {
+            if (existsSync(target) && statSync(target).isDirectory()) {
+                const context = await parser.parseFromDirectory(target);
+                contextStr = ContextParser.formatContext(context);
+            }
+            else if (existsSync(target)) {
+                const context = parser.parseFromFiles([target]);
+                contextStr = ContextParser.formatContext(context);
+            }
+            else {
+                spinner.stop();
+                logger.error(`Target not found: ${target}`);
+                return;
+            }
+            if (options?.verbose) {
+                spinner.stop();
+                logger.highlight('\n--- Context Sent to Model ---\n');
+                console.log(contextStr.slice(0, 2000) + (contextStr.length > 2000 ? '\n\n[...truncated...]' : ''));
+                logger.highlight('\n--- End Context ---\n');
+                spinner.start('Generating plan...');
+            }
+            const prompt = `You are a senior software engineer. Given the following codebase context, create a detailed implementation plan for this task:
+
+## Task
+${task}
+
+## Codebase Context
+${contextStr}
+
+## Plan Requirements
+Please provide:
+1. **Summary** — Brief overview of the task
+2. **Files to Modify** — List each file with specific changes needed
+3. **Architecture Changes** — Any new files, modules, or structural changes
+4. **Implementation Steps** — Ordered step-by-step guide
+5. **Potential Risks** — Edge cases, breaking changes, or considerations
+6. **Testing Strategy** — How to verify the changes work
+
+Use clear markdown formatting.`;
+            spinner.text = 'Generating plan...';
+            const result = await provider.generate(prompt, options);
+            spinner.stop();
+            console.log(`\n${'='.repeat(60)}`);
+            logger.highlight(`📋 Implementation Plan`);
+            console.log(`${'='.repeat(60)}\n`);
+            console.log(result);
+            console.log(`\n${'='.repeat(60)}`);
+            logger.info(`Generated by ${provider.name}`);
+        }
+        catch (err) {
+            spinner.fail('Planning failed');
+            logger.error(String(err));
+        }
+    }
+}
+//# sourceMappingURL=plan.js.map

package/dist/cli/plan.js.map

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

package/dist/cli/plugins.d.ts

@@ -0,0 +1,15 @@
+/**
+ * Plugins command — Lists and manages agent plugins and workflow templates.
+ *
+ * Usage:
+ *   buff plugins list          — Show discovered plugins and workflow templates
+ *   buff plugins scan          — Force re-scan of ~/.buff/agents/ and ~/.buff/workflows/
+ */
+import { Command } from 'commander';
+import { BaseCommand } from './commands.js';
+export declare class PluginsCommand extends BaseCommand {
+    create(): Command;
+    private listPlugins;
+    private scanPlugins;
+}
+//# sourceMappingURL=plugins.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"plugins.d.ts","sourceRoot":"","sources":["../../src/cli/plugins.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAEpC,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAM5C,qBAAa,cAAe,SAAQ,WAAW;IAC7C,MAAM,IAAI,OAAO;YAmBH,WAAW;YAoEX,WAAW;CA+B1B"}

package/dist/cli/plugins.js

@@ -0,0 +1,123 @@
+/**
+ * Plugins command — Lists and manages agent plugins and workflow templates.
+ *
+ * Usage:
+ *   buff plugins list          — Show discovered plugins and workflow templates
+ *   buff plugins scan          — Force re-scan of ~/.buff/agents/ and ~/.buff/workflows/
+ */
+import { Command } from 'commander';
+import { BaseCommand } from './commands.js';
+import { getPluginStats, discoverAgentPlugins, discoverWorkflowPlugins, runAutoDiscovery } from '../plugins/agent-plugin.js';
+import { getPluginRegistry } from '../plugins/registry.js';
+import { logger } from '../utils/logger.js';
+import { getWorkflowTemplates } from '../workflow/templates.js';
+export class PluginsCommand extends BaseCommand {
+    create() {
+        const command = new Command('plugins')
+            .description('Manage provider plugins, agent plugins, and workflow templates');
+        // ── list ──────────────────────────────────────────────────────────────
+        command
+            .command('list')
+            .description('List all discovered plugins and workflows')
+            .action(() => this.listPlugins());
+        // ── scan ──────────────────────────────────────────────────────────────
+        command
+            .command('scan')
+            .description('Force re-scan all plugin directories')
+            .action(() => this.scanPlugins());
+        return command;
+    }
+    async listPlugins() {
+        const stats = getPluginStats();
+        const registry = getPluginRegistry();
+        logger.highlight(`${'═'.repeat(60)}`);
+        logger.highlight('  🔌  Plugin System');
+        logger.highlight(`${'═'.repeat(60)}`);
+        // ── Provider plugins (from ~/.buff/plugins/) ─────────────────────────
+        const registeredPlugins = registry.getAllPlugins();
+        console.log(`\n  🔗 Provider Plugins: ${stats.providerPlugins} discovered, ${registeredPlugins.length} registered`);
+        if (registeredPlugins.length > 0) {
+            for (const p of registeredPlugins) {
+                console.log(`    🔌 ${p.getProviderType()}: ${p.metadata.name} v${p.metadata.version}`);
+                if (p.metadata.description) {
+                    console.log(`       ${p.metadata.description}`);
+                }
+            }
+        }
+        else {
+            console.log('    (no provider plugins found in ~/.buff/plugins/)');
+            console.log('    Tip: Drop a .js file exporting a ProviderPlugin into ~/.buff/plugins/');
+        }
+        // ── Built-in workflow templates ──────────────────────────────────────
+        const builtinWorkflows = getWorkflowTemplates();
+        console.log(`\n  📋 Built-in Workflow Templates: ${builtinWorkflows.length}`);
+        for (const w of builtinWorkflows) {
+            console.log(`    ${w.id}: ${w.name} (${w.steps.length} steps)`);
+        }
+        // ── Discovered agent plugins ──────────────────────────────────────────
+        console.log(`\n  🤖 Agent Plugins: ${stats.agentPlugins} discovered`);
+        if (stats.agentPlugins > 0) {
+            try {
+                const plugins = await discoverAgentPlugins();
+                for (const [type, plugin] of plugins) {
+                    console.log(`    📦 ${type}: ${plugin.metadata.name} v${plugin.metadata.version}`);
+                }
+            }
+            catch {
+                console.log('    (run `buff plugins scan` to reload)');
+            }
+        }
+        else {
+            console.log('    (no agent plugins found in ~/.buff/agents/)');
+        }
+        // ── Discovered workflow plugins ──────────────────────────────────────
+        console.log(`\n  📄 Workflow Plugins: ${stats.workflowPlugins} discovered`);
+        if (stats.workflowPlugins > 0) {
+            try {
+                const workflows = discoverWorkflowPlugins();
+                for (const w of workflows) {
+                    console.log(`    📄 ${w.id}: ${w.name} (${w.steps.length} steps)`);
+                }
+            }
+            catch {
+                console.log('    (run `buff plugins scan` to reload)');
+            }
+        }
+        else {
+            console.log('    (no workflow plugins found in ~/.buff/workflows/)');
+        }
+        // ── Plugin directories ──────────────────────────────────────────────
+        console.log(`\n  📁 Plugin Directories:`);
+        console.log(`    Provider plugins: ~/.buff/plugins/`);
+        console.log(`    Agent plugins: ~/.buff/agents/`);
+        console.log(`    Workflow templates: ~/.buff/workflows/`);
+        console.log('');
+    }
+    async scanPlugins() {
+        logger.info('Scanning for plugins...');
+        const result = await runAutoDiscovery();
+        const registry = getPluginRegistry();
+        const registeredPlugins = registry.getAllPlugins();
+        console.log(`\n  ✅ Scan complete`);
+        console.log(`  Provider plugins: ${result.providerPlugins} discovered (${registeredPlugins.length} registered)`);
+        console.log(`  Agent plugins: ${result.agentPlugins} discovered`);
+        console.log(`  Workflow plugins: ${result.workflowPlugins} discovered`);
+        console.log('');
+        // Show what was discovered
+        for (const p of registeredPlugins) {
+            logger.success(`  Provider: ${p.getProviderType()} ← ${p.metadata.name} v${p.metadata.version}`);
+        }
+        const agentPlugins = await discoverAgentPlugins();
+        for (const [type, plugin] of agentPlugins) {
+            logger.success(`  Agent: ${type} ← ${plugin.metadata.name} v${plugin.metadata.version}`);
+        }
+        const workflowPlugins = discoverWorkflowPlugins();
+        for (const w of workflowPlugins) {
+            logger.success(`  Workflow: ${w.id} ← ${w.name}`);
+        }
+        if (registeredPlugins.length === 0 && agentPlugins.size === 0 && workflowPlugins.length === 0) {
+            console.log('  Tip: Place .js provider files in ~/.buff/plugins/, .js agent files in ~/.buff/agents/,\n        or .json workflow files in ~/.buff/workflows/');
+        }
+    }
+}
+//# sourceMappingURL=plugins.js.map

package/dist/cli/plugins.js.map

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

package/dist/cli/router.d.ts

@@ -0,0 +1,20 @@
+import { Command } from 'commander';
+import { ConfigManager } from '../config/manager.js';
+import { InferenceProvider } from '../inference/interface.js';
+/**
+ * Create and configure the CLI program
+ */
+export declare function createCLI(): Command;
+/**
+ * Resolve the inference provider from CLI options.
+ *
+ * Supports both built-in providers (local, nim, gemini, openrouter, groq)
+ * and auto-discovered plugin providers from ~/.buff/plugins/.
+ *
+ * For plugin providers, the type string returned is the plugin's provider type.
+ */
+export declare function resolveProvider(configManager: ConfigManager, providerOption?: string): {
+    type: string;
+    provider: InferenceProvider;
+};
+//# sourceMappingURL=router.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"router.d.ts","sourceRoot":"","sources":["../../src/cli/router.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AAKrD,OAAO,EAAE,iBAAiB,EAAE,MAAM,2BAA2B,CAAC;AA4B9D;;GAEG;AACH,wBAAgB,SAAS,IAAI,OAAO,CAwFnC;AASD;;;;;;;GAOG;AACH,wBAAgB,eAAe,CAC7B,aAAa,EAAE,aAAa,EAC5B,cAAc,CAAC,EAAE,MAAM,GACtB;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,iBAAiB,CAAA;CAAE,CA4B/C"}

package/dist/cli/router.js

@@ -0,0 +1,142 @@
+import { readFileSync } from 'node:fs';
+import { fileURLToPath } from 'node:url';
+import { Command } from 'commander';
+/** Read version from package.json at build time */
+const pkg = JSON.parse(readFileSync(fileURLToPath(new URL('../../package.json', import.meta.url)), 'utf-8'));
+import { ProviderFactory } from '../inference/factory.js';
+import { getPluginRegistry } from '../plugins/registry.js';
+import { ChatCommand } from './chat.js';
+import { EditCommand } from './edit.js';
+import { PlanCommand } from './plan.js';
+import { ConfigCommand } from './config.js';
+import { CacheCommand } from './cache.js';
+import { ModelsCommand } from './models.js';
+import { ExecuteCommand } from './execute.js';
+import { RunCommand } from './run.js';
+import { WorkflowCommand } from './workflow.js';
+import { PluginsCommand } from './plugins.js';
+import { LearnCommand } from './learn.js';
+import { InitCommand } from './init.js';
+import { StatsCommand } from './stats.js';
+import { HistoryCommand } from './history.js';
+import { BenchmarkCommand } from './benchmark.js';
+import { SandboxCommand } from './sandbox.js';
+import { DoctorCommand } from './doctor.js';
+import { MemoryCommand } from './memory.js';
+import { DashboardCommand } from './dashboard.js';
+import { AgentCommand } from './agent.js';
+import { FederationCommand } from './federation.js';
+import { TeamCommand } from './team.js';
+import { SDKCommand } from './sdk.js';
+import { logger } from '../utils/logger.js';
+/**
+ * Create and configure the CLI program
+ */
+export function createCLI() {
+    const program = new Command();
+    program
+        .name('buff')
+        .description('Flexible AI inference CLI tool — local models & cloud APIs')
+        .version(pkg.version);
+    // Global options
+    program
+        .option('-d, --debug', 'Enable debug logging');
+    // Register commands
+    const chatCmd = new ChatCommand();
+    const editCmd = new EditCommand();
+    const planCmd = new PlanCommand();
+    const configCmd = new ConfigCommand();
+    const cacheCmd = new CacheCommand();
+    const modelsCmd = new ModelsCommand();
+    const executeCmd = new ExecuteCommand();
+    program.addCommand(chatCmd.create());
+    program.addCommand(editCmd.create());
+    program.addCommand(planCmd.create());
+    program.addCommand(configCmd.create());
+    program.addCommand(cacheCmd.create());
+    program.addCommand(modelsCmd.create());
+    program.addCommand(executeCmd.create());
+    const runCmd = new RunCommand();
+    program.addCommand(runCmd.create());
+    const workflowCmd = new WorkflowCommand();
+    program.addCommand(workflowCmd.create());
+    const pluginsCmd = new PluginsCommand();
+    program.addCommand(pluginsCmd.create());
+    const learnCmd = new LearnCommand();
+    program.addCommand(learnCmd.create());
+    // Register new Phase 1 commands
+    const initCmd = new InitCommand();
+    program.addCommand(initCmd.create());
+    const statsCmd = new StatsCommand();
+    program.addCommand(statsCmd.create());
+    const historyCmd = new HistoryCommand();
+    program.addCommand(historyCmd.create());
+    // Register Phase 2 commands
+    const benchmarkCmd = new BenchmarkCommand();
+    program.addCommand(benchmarkCmd.create());
+    const sandboxCmd = new SandboxCommand();
+    program.addCommand(sandboxCmd.create());
+    // Register Phase 2.5 new commands
+    const doctorCmd = new DoctorCommand();
+    program.addCommand(doctorCmd.create());
+    const memoryCmd = new MemoryCommand();
+    program.addCommand(memoryCmd.create());
+    // Register Phase 3.3 new commands
+    const dashboardCmd = new DashboardCommand();
+    program.addCommand(dashboardCmd.create());
+    const agentCmd = new AgentCommand();
+    program.addCommand(agentCmd.create());
+    const federationCmd = new FederationCommand();
+    program.addCommand(federationCmd.create());
+    const teamCmd = new TeamCommand();
+    program.addCommand(teamCmd.create());
+    // Register Phase 3.6 commands
+    const sdkCmd = new SDKCommand();
+    program.addCommand(sdkCmd.create());
+    // Default action: show help
+    program.action(() => {
+        program.help();
+    });
+    return program;
+}
+/**
+ * Check if a provider type is one of the built-in types.
+ */
+function isBuiltInProvider(type) {
+    return ['local', 'nim', 'gemini', 'openrouter', 'groq'].includes(type);
+}
+/**
+ * Resolve the inference provider from CLI options.
+ *
+ * Supports both built-in providers (local, nim, gemini, openrouter, groq)
+ * and auto-discovered plugin providers from ~/.buff/plugins/.
+ *
+ * For plugin providers, the type string returned is the plugin's provider type.
+ */
+export function resolveProvider(configManager, providerOption) {
+    const rawType = providerOption || configManager.getAll().defaultProvider;
+    // Check if it's a built-in provider
+    if (isBuiltInProvider(rawType)) {
+        const { config } = configManager.getProviderConfig(rawType);
+        const provider = ProviderFactory.createProvider(rawType, config);
+        logger.debug(`Resolved provider: ${rawType} (${provider.name})`);
+        return { type: rawType, provider };
+    }
+    // Check plugin registry for auto-discovered providers
+    const registry = getPluginRegistry();
+    if (registry.hasPlugin(rawType)) {
+        const plugin = registry.getPlugin(rawType);
+        const config = configManager.getAll().providers[rawType] || {};
+        const provider = plugin.createProvider(config);
+        logger.debug(`Resolved plugin provider: ${rawType} (${plugin.metadata.name})`);
+        return { type: rawType, provider };
+    }
+    // Unknown provider — warn and fall back to default
+    logger.warn(`Unknown provider '${rawType}'. Falling back to '${configManager.getAll().defaultProvider}'`);
+    const fallbackType = configManager.getAll().defaultProvider;
+    const { config } = configManager.getProviderConfig(fallbackType);
+    const provider = ProviderFactory.createProvider(fallbackType, config);
+    logger.debug(`Resolved provider (fallback): ${fallbackType} (${provider.name})`);
+    return { type: fallbackType, provider };
+}
+//# sourceMappingURL=router.js.map

package/dist/cli/router.js.map

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

package/dist/cli/run.d.ts

@@ -0,0 +1,22 @@
+/**
+ * Run command — Execute a shell command directly using the RunnerAgent.
+ *
+ * This is a lightweight shortcut that bypasses the multi-agent pipeline
+ * and runs a command immediately, showing stdout/stderr output.
+ *
+ * Usage:
+ *   buff run "echo hello world"
+ *   buff run "npm test" --verbose
+ *   buff run "python hello.py" --timeout 30000
+ *   buff run "node index.js" --provider groq --model "llama-3.1-8b-instant"
+ */
+import { Command } from 'commander';
+import { BaseCommand } from './commands.js';
+/**
+ * Run command — lightweight shell command execution via RunnerAgent.
+ */
+export declare class RunCommand extends BaseCommand {
+    create(): Command;
+    private execute;
+}
+//# sourceMappingURL=run.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"run.d.ts","sourceRoot":"","sources":["../../src/cli/run.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAEpC,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAK5C;;GAEG;AACH,qBAAa,UAAW,SAAQ,WAAW;IACzC,MAAM,IAAI,OAAO;YAkBH,OAAO;CAqGtB"}