agent-nuvira 1.14.0

package/dist/cli/sdk.js

@@ -0,0 +1,204 @@
+/**
+ * SDK Command — Create and manage custom agents with the Agent-Baba-D SDK.
+ *
+ * Usage:
+ *   buff sdk scaffold <outDir> <agentName> [description]  — Generate a new agent project
+ *   buff sdk scaffold --template basic-agent ...            — Use a minimal template
+ *   buff sdk scaffold --template agent-pack ...             — Multi-agent package template
+ *   buff sdk templates                                     — List available templates
+ *   buff sdk info                                          — Show SDK package info
+ *
+ * The scaffold subcommand creates a complete, ready-to-extend agent package with:
+ * - TypeScript configuration
+ * - A custom agent class extending Agent
+ * - Unit tests using the SDK testing utilities
+ * - Package.json with build/test scripts
+ */
+import { Command } from 'commander';
+import { join } from 'node:path';
+import { existsSync } from 'node:fs';
+import { BaseCommand } from './commands.js';
+import { logger } from '../utils/logger.js';
+import { scaffold, listTemplates } from '../agent-sdk/src/scaffold.js';
+import { registerAgent, unregisterAgent } from '../agent-sdk/src/register.js';
+// ─── SDKCommand ─────────────────────────────────────────────────────────────
+export class SDKCommand extends BaseCommand {
+    create() {
+        const command = new Command('sdk')
+            .description('Create and manage custom agents with the Agent-Baba-D SDK');
+        // ── scaffold subcommand ─────────────────────────────────────────────
+        const scaffoldCmd = new Command('scaffold')
+            .description('Generate a new custom agent project')
+            .argument('<outDir>', 'Output directory for the new agent project')
+            .argument('<agentName>', 'Agent class name in PascalCase (e.g. CodeFormatter)')
+            .argument('[description]', 'Description of what the agent does', 'A custom agent')
+            .option('-t, --template <template>', 'Template type: basic-agent, full-agent, or agent-pack', 'full-agent')
+            .option('--agent-type <type>', 'Agent type identifier for task plans (default: kebab-case of name)')
+            .action(async (outDir, agentName, description, options) => {
+            await this.handleScaffold(outDir, agentName, description, options);
+        });
+        command.addCommand(scaffoldCmd);
+        // ── templates subcommand ────────────────────────────────────────────
+        const templatesCmd = new Command('templates')
+            .description('List available scaffold templates')
+            .action(() => {
+            this.handleListTemplates();
+        });
+        command.addCommand(templatesCmd);
+        // ── info subcommand ────────────────────────────────────────────
+        const infoCmd = new Command('info')
+            .description('Show SDK package info and version')
+            .action(() => {
+            this.handleInfo();
+        });
+        command.addCommand(infoCmd);
+        // ── register subcommand ─────────────────────────────────────────
+        const registerCmd = new Command('register')
+            .description('Register a custom agent with the orchestrator')
+            .argument('<className>', 'Exported class name (e.g. CodeFormatter)')
+            .argument('<agentType>', 'Agent type for task plans (e.g. code-formatter)')
+            .argument('<sourceModule>', 'Import module path relative to orchestrator.ts (e.g. ./agents/my-agent.js)')
+            .option('-i, --icon <emoji>', 'Emoji icon for the agent (default: 🧩)', '🧩')
+            .option('--orchestrator-path <path>', 'Path to orchestrator.ts (auto-detected if not set)')
+            .action(async (className, agentType, sourceModule, options) => {
+            await this.handleRegister(className, agentType, sourceModule, options);
+        });
+        command.addCommand(registerCmd);
+        // ── unregister subcommand ───────────────────────────────────────
+        const unregisterCmd = new Command('unregister')
+            .description('Remove a custom agent from the orchestrator')
+            .argument('<agentType>', 'Agent type to remove (e.g. code-formatter)')
+            .option('--orchestrator-path <path>', 'Path to orchestrator.ts (auto-detected if not set)')
+            .action(async (agentType, options) => {
+            await this.handleUnregister(agentType, options);
+        });
+        command.addCommand(unregisterCmd);
+        return command;
+    }
+    // ─── Handlers ─────────────────────────────────────────────────────────
+    async handleScaffold(outDir, agentName, description, options) {
+        const resolvedDir = join(process.cwd(), outDir);
+        // Validate template
+        const validTemplates = listTemplates().map((t) => t.name);
+        const template = options.template || 'full-agent';
+        if (!validTemplates.includes(template)) {
+            logger.error(`Unknown template: "${template}". Valid templates: ${validTemplates.join(', ')}`);
+            return;
+        }
+        // Validate agent name
+        if (!agentName.match(/^[A-Z][a-zA-Z0-9]*$/)) {
+            logger.error(`Invalid agent name "${agentName}". Must be in PascalCase (e.g. "CodeFormatter", "MyAgent").`);
+            return;
+        }
+        if (existsSync(resolvedDir)) {
+            logger.error(`Output directory already exists: ${resolvedDir}`);
+            return;
+        }
+        logger.info(`Generating ${template} agent: ${agentName}...`);
+        try {
+            const files = scaffold({
+                outDir: resolvedDir,
+                agentName,
+                description: description || 'A custom agent',
+                template: template,
+                agentType: options.agentType,
+            });
+            logger.success(`Created ${files.length} files in ${outDir}/`);
+            console.log('');
+            for (const file of files) {
+                const relativePath = file.replace(resolvedDir, '').replace(/^\//, '');
+                console.log(`   📄 ${relativePath}`);
+            }
+            console.log('');
+            logger.success('Next steps:');
+            console.log('');
+            console.log(`   cd ${outDir}`);
+            console.log('   npm install');
+            console.log('   npm run build');
+            console.log('   npm test');
+            console.log('');
+            logger.info('To register this agent with the orchestrator, add it to the createAgent() switch in src/agents/orchestrator.ts');
+        }
+        catch (err) {
+            const msg = err instanceof Error ? err.message : String(err);
+            logger.error(`Failed to scaffold agent: ${msg}`);
+        }
+    }
+    handleListTemplates() {
+        const templates = listTemplates();
+        logger.highlight('Available scaffold templates:');
+        console.log('');
+        for (const t of templates) {
+            console.log(`   ${t.name}`);
+            console.log(`      ${t.description}`);
+            console.log('');
+        }
+        logger.info('Use: buff sdk scaffold <outDir> <agentName> [description] --template <name>');
+    }
+    handleInfo() {
+        logger.highlight('@agent-baba-d/sdk');
+        console.log('');
+        console.log('   Build custom agents for the Agent-Baba-D multi-agent system.');
+        console.log('');
+        console.log('   Subcommands:');
+        console.log('     scaffold    Generate a new custom agent project');
+        console.log('     templates   List available scaffold templates');
+        console.log('     info        Show this information');
+        console.log('');
+        console.log('   Entry points:');
+        console.log('     @agent-baba-d/sdk              Base Agent class + core types');
+        console.log('     @agent-baba-d/sdk/testing      Testing utilities');
+        console.log('');
+        console.log('   API Docs: https://github.com/imdheerajKube/agent-baba-d');
+    }
+    async handleRegister(className, agentType, sourceModule, options) {
+        // Validate className (must be PascalCase)
+        if (!className.match(/^[A-Z][a-zA-Z0-9]*$/)) {
+            logger.error(`Invalid class name "${className}". Must be in PascalCase (e.g. "CodeFormatter").`);
+            return;
+        }
+        // Validate agentType (must be kebab-case)
+        if (!agentType.match(/^[a-z][a-z0-9-]*$/)) {
+            logger.error(`Invalid agent type "${agentType}". Must be kebab-case (e.g. "code-formatter").`);
+            return;
+        }
+        logger.info(`Registering agent '${agentType}' (${className}) from ${sourceModule}...`);
+        const result = registerAgent({
+            sourceModule,
+            className,
+            agentType,
+            icon: options.icon,
+            orchestratorPath: options.orchestratorPath,
+        });
+        if (result.success) {
+            logger.success(result.message);
+            if (result.modifiedFiles.length > 0) {
+                console.log('');
+                logger.success('Next steps:');
+                console.log('');
+                console.log('   Add the agent to a task plan in your workflow or CLI command:');
+                console.log(`     { agentType: '${agentType}', description: '...', dependsOn: [] }`);
+                console.log('');
+                console.log('   Or use it directly in a goal:');
+                console.log(`     buff execute "Run ${agentType} on the project"`);
+            }
+        }
+        else {
+            logger.error(result.message);
+        }
+    }
+    async handleUnregister(agentType, options) {
+        logger.info(`Unregistering agent '${agentType}'...`);
+        const result = unregisterAgent({
+            agentType,
+            orchestratorPath: options.orchestratorPath,
+        });
+        if (result.success) {
+            logger.success(result.message);
+        }
+        else {
+            logger.error(result.message);
+        }
+    }
+}
+//# sourceMappingURL=sdk.js.map

package/dist/cli/sdk.js.map

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

package/dist/cli/stats.d.ts

@@ -0,0 +1,18 @@
+/**
+ * Stats command — View usage statistics and cost tracking.
+ *
+ * Usage:
+ *   buff stats              — Show all stats summary
+ *   buff stats cost         — Show cost tracking details
+ *   buff stats cost --clear — Reset cost tracking data
+ *   buff stats history      — Show conversation history stats
+ */
+import { Command } from 'commander';
+import { BaseCommand } from './commands.js';
+export declare class StatsCommand extends BaseCommand {
+    create(): Command;
+    private showCost;
+    private showHistoryStats;
+    private showAllStats;
+}
+//# sourceMappingURL=stats.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"stats.d.ts","sourceRoot":"","sources":["../../src/cli/stats.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAEpC,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAK5C,qBAAa,YAAa,SAAQ,WAAW;IAC3C,MAAM,IAAI,OAAO;YA+BH,QAAQ;IAWtB,OAAO,CAAC,gBAAgB;IAsBxB,OAAO,CAAC,YAAY;CAYrB"}

package/dist/cli/stats.js

@@ -0,0 +1,78 @@
+/**
+ * Stats command — View usage statistics and cost tracking.
+ *
+ * Usage:
+ *   buff stats              — Show all stats summary
+ *   buff stats cost         — Show cost tracking details
+ *   buff stats cost --clear — Reset cost tracking data
+ *   buff stats history      — Show conversation history stats
+ */
+import { Command } from 'commander';
+import { BaseCommand } from './commands.js';
+import { getCostTracker } from '../learning/cost-tracker.js';
+import { getChatHistory } from '../context/history.js';
+import { logger } from '../utils/logger.js';
+export class StatsCommand extends BaseCommand {
+    create() {
+        const command = new Command('stats')
+            .description('View usage statistics and cost tracking');
+        // ── cost ─────────────────────────────────────────────────────────────
+        const costCmd = new Command('cost')
+            .description('Show API cost tracking details')
+            .option('--clear', 'Reset all cost tracking data')
+            .action(async (options) => {
+            await this.showCost(options);
+        });
+        command.addCommand(costCmd);
+        // ── history ──────────────────────────────────────────────────────────
+        const historyCmd = new Command('history')
+            .description('Show conversation history statistics')
+            .action(() => {
+            this.showHistoryStats();
+        });
+        command.addCommand(historyCmd);
+        // Default: show all stats
+        command.action(() => {
+            this.showAllStats();
+        });
+        return command;
+    }
+    async showCost(options) {
+        if (options?.clear) {
+            getCostTracker().clear();
+            logger.success('Cost tracking data cleared.');
+            return;
+        }
+        const tracker = getCostTracker();
+        console.log(`\n${tracker.formatSummary()}`);
+    }
+    showHistoryStats() {
+        const history = getChatHistory();
+        const total = history.count();
+        const recent = history.getRecentSessions(7);
+        logger.highlight(`${'═'.repeat(60)}`);
+        logger.highlight('  📝  Conversation History');
+        logger.highlight(`${'═'.repeat(60)}`);
+        console.log(`\n  Total sessions: ${total}`);
+        console.log(`  Recent (7 days): ${recent.length}`);
+        if (recent.length > 0) {
+            console.log(`\n  Recent sessions:`);
+            for (const session of recent.slice(0, 10)) {
+                console.log(history.formatSessionSummary(session));
+            }
+        }
+        console.log('');
+    }
+    showAllStats() {
+        this.showHistoryStats();
+        const tracker = getCostTracker();
+        const summary = tracker.getSummary();
+        if (summary.totalRequests > 0) {
+            console.log(`\n${tracker.formatSummary()}`);
+        }
+        else {
+            logger.info('No cost data yet. Start using providers to track costs.');
+        }
+    }
+}
+//# sourceMappingURL=stats.js.map

package/dist/cli/stats.js.map

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

package/dist/cli/team.d.ts

@@ -0,0 +1,42 @@
+/**
+ * Team command — Team collaboration with shared memory, config, and review workflow.
+ *
+ * Usage:
+ *   buff team init [name]                       — Initialize team config in working directory
+ *   buff team init --repo <url>                 — Init with remote team repository
+ *   buff team join <repo-url>                   — Clone and join an existing team repo
+ *   buff team sync                              — Sync team memory with remote (pull + push)
+ *   buff team status                            — Show team configuration and memory status
+ *   buff team share                             — Share local trajectories with team
+ *   buff team review list                       — List all review bundles
+ *   buff team review show <id>                  — Show a specific review bundle
+ *   buff team review approve <id>               — Approve a review
+ *   buff team review reject <id> [reason]       — Reject a review
+ *   buff team review merge <id>                 — Merge an approved review into working dir
+ *   buff team review create <title> <goal>      — Create a review bundle from files
+ *
+ * The team system enables multiple developers to:
+ *   - Share agent execution trajectories via git
+ *   - Use project-level .buffconfig.json for shared provider defaults
+ *   - Review agent-generated changes before applying them
+ *   - Collaborate on workflow templates and coding patterns
+ */
+import { Command } from 'commander';
+import { BaseCommand } from './commands.js';
+export declare class TeamCommand extends BaseCommand {
+    create(): Command;
+    private handleInit;
+    private handleJoin;
+    private handleSync;
+    private handleStatus;
+    private handleShare;
+    private handleReviewList;
+    private handleReviewShow;
+    private handleReviewApprove;
+    private handleReviewRequestChanges;
+    private handleReviewReject;
+    private handleReviewMerge;
+    private handleReviewCreate;
+    private reviewStatusIcon;
+}
+//# sourceMappingURL=team.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"team.d.ts","sourceRoot":"","sources":["../../src/cli/team.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;GAsBG;AAEH,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAIpC,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AA4B5C,qBAAa,WAAY,SAAQ,WAAW;IAC1C,MAAM,IAAI,OAAO;YAuHH,UAAU;YAqDV,UAAU;YAkCV,UAAU;YAwCV,YAAY;YA0EZ,WAAW;YAqBX,gBAAgB;YA0BhB,gBAAgB;YAgDhB,mBAAmB;YAmBnB,0BAA0B;YAe1B,kBAAkB;YAQlB,iBAAiB;YAQjB,kBAAkB;IAsDhC,OAAO,CAAC,gBAAgB;CAUzB"}