@adverant-nexus/cli 2.0.0

package/dist/core/react-handler.js

@@ -0,0 +1,296 @@
+/**
+ * ReAct Event Handler
+ *
+ * Processes and displays ReAct loop events (thought-action-observation cycles)
+ * Handles user approval prompts and progress tracking
+ */
+import ora from 'ora';
+import chalk from 'chalk';
+import inquirer from 'inquirer';
+/**
+ * Handle a stream of ReAct events
+ * Returns the final agent result
+ */
+export async function handleReActStream(stream, options = {}) {
+    let spinner = null;
+    let currentIteration = 0;
+    let result = null;
+    console.log(chalk.bold.cyan('\n🤖 Autonomous Agent Starting...\n'));
+    try {
+        for await (const event of stream) {
+            currentIteration = Math.max(currentIteration, event.iteration);
+            switch (event.type) {
+                case 'thought':
+                    if (spinner)
+                        spinner.stop();
+                    displayThought(event, currentIteration);
+                    if (options.onThought) {
+                        options.onThought({
+                            iteration: event.iteration,
+                            content: event.content,
+                            reasoning: event.metadata?.reasoning,
+                            timestamp: event.timestamp,
+                        });
+                    }
+                    break;
+                case 'action':
+                    if (spinner)
+                        spinner.stop();
+                    const shouldExecute = await displayAction(event, currentIteration, options);
+                    if (!shouldExecute) {
+                        throw new Error('Action denied by user');
+                    }
+                    spinner = ora({
+                        text: chalk.gray('Executing action...'),
+                        color: 'yellow',
+                    }).start();
+                    break;
+                case 'observation':
+                    if (spinner)
+                        spinner.stop();
+                    displayObservation(event, currentIteration);
+                    if (options.onObservation) {
+                        options.onObservation({
+                            iteration: event.iteration,
+                            content: event.content,
+                            success: event.metadata?.success ?? true,
+                            error: event.metadata?.error,
+                            data: event.metadata?.data,
+                            timestamp: event.timestamp,
+                        });
+                    }
+                    break;
+                case 'approval-required':
+                    if (spinner)
+                        spinner.stop();
+                    const approval = await handleApprovalRequest(event);
+                    // Approval is sent back via the client
+                    break;
+                case 'complete':
+                    if (spinner)
+                        spinner.stop();
+                    result = event.metadata;
+                    displayCompletion(event, result);
+                    if (options.onComplete) {
+                        options.onComplete(result);
+                    }
+                    break;
+                case 'error':
+                    if (spinner)
+                        spinner.stop();
+                    displayError(event);
+                    if (options.onError) {
+                        options.onError(new Error(event.content));
+                    }
+                    throw new Error(event.content);
+            }
+        }
+        if (!result) {
+            throw new Error('Agent stream ended without completion event');
+        }
+        return result;
+    }
+    finally {
+        if (spinner)
+            spinner.stop();
+    }
+}
+/**
+ * Display a thought event
+ */
+function displayThought(event, iteration) {
+    console.log(chalk.magenta(`\n💭 [Iteration ${iteration}] Thought:`));
+    console.log(chalk.gray('   ' + event.content));
+    if (event.metadata?.reasoning) {
+        console.log(chalk.gray('   Reasoning: ' + event.metadata.reasoning));
+    }
+}
+/**
+ * Display an action event and handle approval if needed
+ */
+async function displayAction(event, iteration, options) {
+    console.log(chalk.blue(`\n⚡ [Iteration ${iteration}] Action:`));
+    console.log(chalk.gray('   ' + event.content));
+    if (event.metadata?.tool) {
+        console.log(chalk.gray(`   Tool: ${event.metadata.tool}`));
+    }
+    if (event.metadata?.params) {
+        console.log(chalk.gray(`   Params: ${JSON.stringify(event.metadata.params, null, 2).split('\n').join('\n   ')}`));
+    }
+    // Check if approval is required
+    if (event.metadata?.requiresApproval && !options.approveCommands) {
+        const approval = {
+            action: {
+                iteration: event.iteration,
+                action: event.content,
+                tool: event.metadata.tool,
+                params: event.metadata.params,
+                requiresApproval: true,
+                timestamp: event.timestamp,
+            },
+            command: event.content,
+            safetyLevel: event.metadata.safetyLevel || 'moderate',
+            reason: event.metadata.reason,
+        };
+        const result = await promptForApproval(approval);
+        if (options.onAction) {
+            return await options.onAction(approval.action);
+        }
+        return result.approved;
+    }
+    // Auto-approve if configured
+    if (options.approveCommands || !event.metadata?.requiresApproval) {
+        if (options.onAction) {
+            return await options.onAction({
+                iteration: event.iteration,
+                action: event.content,
+                tool: event.metadata?.tool,
+                params: event.metadata?.params,
+                timestamp: event.timestamp,
+            });
+        }
+        return true;
+    }
+    return true;
+}
+/**
+ * Display an observation event
+ */
+function displayObservation(event, iteration) {
+    const success = event.metadata?.success !== false;
+    const icon = success ? '👁️' : '❌';
+    const color = success ? 'green' : 'red';
+    console.log(chalk[color](`\n${icon} [Iteration ${iteration}] Observation:`));
+    console.log(chalk.gray('   ' + event.content));
+    if (event.metadata?.error) {
+        console.log(chalk.red('   Error: ' + event.metadata.error));
+    }
+}
+/**
+ * Display completion event
+ */
+function displayCompletion(event, result) {
+    console.log(chalk.bold.green('\n✅ Task Completed!\n'));
+    console.log(chalk.bold('Summary:'));
+    console.log(chalk.gray('   ' + result.summary));
+    if (result.iterations) {
+        console.log(chalk.gray(`   Iterations: ${result.iterations}`));
+    }
+    if (result.duration) {
+        console.log(chalk.gray(`   Duration: ${(result.duration / 1000).toFixed(2)}s`));
+    }
+    if (result.cost) {
+        console.log(chalk.gray(`   Cost: $${result.cost.toFixed(4)}`));
+    }
+    if (result.artifacts && result.artifacts.length > 0) {
+        console.log(chalk.bold('\nArtifacts:'));
+        result.artifacts.forEach(artifact => {
+            console.log(chalk.gray(`   - ${artifact.name} (${artifact.type})`));
+        });
+    }
+    if (result.learnings && result.learnings.length > 0) {
+        console.log(chalk.bold('\nLearnings:'));
+        result.learnings.forEach(learning => {
+            console.log(chalk.gray(`   - ${learning}`));
+        });
+    }
+}
+/**
+ * Display error event
+ */
+function displayError(event) {
+    console.log(chalk.bold.red('\n❌ Agent Error:\n'));
+    console.log(chalk.red(event.content));
+    if (event.metadata?.stack) {
+        console.log(chalk.gray('\nStack trace:'));
+        console.log(chalk.gray(event.metadata.stack));
+    }
+}
+/**
+ * Handle approval request event
+ */
+async function handleApprovalRequest(event) {
+    const approval = {
+        action: {
+            iteration: event.iteration,
+            action: event.content,
+            timestamp: event.timestamp,
+        },
+        command: event.content,
+        safetyLevel: event.metadata?.safetyLevel || 'moderate',
+        reason: event.metadata?.reason,
+    };
+    return await promptForApproval(approval);
+}
+/**
+ * Prompt user for approval
+ */
+async function promptForApproval(approval) {
+    console.log(chalk.yellow('\n⚠️  Approval Required\n'));
+    console.log(chalk.bold('Command:'), approval.command);
+    console.log(chalk.bold('Safety Level:'), getSafetyLevelDisplay(approval.safetyLevel));
+    if (approval.reason) {
+        console.log(chalk.bold('Reason:'), approval.reason);
+    }
+    const answer = await inquirer.prompt([
+        {
+            type: 'list',
+            name: 'decision',
+            message: 'Do you want to approve this action?',
+            choices: [
+                { name: 'Approve', value: 'approve' },
+                { name: 'Modify and approve', value: 'modify' },
+                { name: 'Deny', value: 'deny' },
+                { name: 'Abort task', value: 'abort' },
+            ],
+        },
+    ]);
+    switch (answer.decision) {
+        case 'approve':
+            return { approved: true };
+        case 'modify':
+            const modifiedAnswer = await inquirer.prompt([
+                {
+                    type: 'input',
+                    name: 'command',
+                    message: 'Enter modified command:',
+                    default: approval.command,
+                },
+            ]);
+            return {
+                approved: true,
+                modifiedCommand: modifiedAnswer.command,
+            };
+        case 'deny':
+            return { approved: false, reason: 'User denied' };
+        case 'abort':
+            throw new Error('Task aborted by user');
+        default:
+            return { approved: false };
+    }
+}
+/**
+ * Get safety level display with color
+ */
+function getSafetyLevelDisplay(level) {
+    switch (level) {
+        case 'safe':
+            return chalk.green('Safe');
+        case 'moderate':
+            return chalk.yellow('Moderate');
+        case 'dangerous':
+            return chalk.red('Dangerous');
+        default:
+            return chalk.gray('Unknown');
+    }
+}
+/**
+ * Display progress bar for iterations
+ */
+export function displayProgress(current, total) {
+    const percentage = Math.round((current / total) * 100);
+    const filled = Math.round((current / total) * 20);
+    const bar = '█'.repeat(filled) + '░'.repeat(20 - filled);
+    console.log(chalk.cyan(`\nProgress: [${bar}] ${percentage}% (${current}/${total} iterations)`));
+}
+//# sourceMappingURL=react-handler.js.map

package/dist/core/react-handler.js.map

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

package/dist/core/router/command-registry.d.ts

@@ -0,0 +1,61 @@
+/**
+ * Command Registry
+ *
+ * Central registry for all CLI commands
+ */
+import type { Command, CommandRegistry as ICommandRegistry, DynamicCommandSource } from '../../types/command.js';
+export declare class CommandRegistry implements ICommandRegistry {
+    private commands;
+    private dynamicSources;
+    /**
+     * Register a command
+     */
+    register(command: Command): void;
+    /**
+     * Register multiple commands
+     */
+    registerMany(commands: Command[]): void;
+    /**
+     * Unregister a command
+     */
+    unregister(name: string, namespace?: string): void;
+    /**
+     * Get a command by name and namespace
+     */
+    get(name: string, namespace?: string): Command | undefined;
+    /**
+     * Check if command exists
+     */
+    has(name: string, namespace?: string): boolean;
+    /**
+     * List all commands, optionally filtered by namespace
+     */
+    list(namespace?: string): Command[];
+    /**
+     * List all namespaces
+     */
+    listNamespaces(): string[];
+    /**
+     * Register a dynamic command source
+     */
+    registerDynamicSource(source: DynamicCommandSource): void;
+    /**
+     * Discover and register commands from all dynamic sources
+     */
+    discoverDynamicCommands(): Promise<void>;
+    /**
+     * Refresh commands from dynamic sources
+     */
+    refresh(): Promise<void>;
+    /**
+     * Get command by full name (namespace:command or just command)
+     */
+    resolve(fullName: string): Command | undefined;
+    /**
+     * Search commands by keyword
+     */
+    search(keyword: string): Command[];
+    private getCommandKey;
+}
+export declare function createCommandRegistry(): CommandRegistry;
+//# sourceMappingURL=command-registry.d.ts.map

package/dist/core/router/command-registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"command-registry.d.ts","sourceRoot":"","sources":["../../../src/core/router/command-registry.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EACV,OAAO,EACP,eAAe,IAAI,gBAAgB,EACnC,oBAAoB,EACrB,MAAM,wBAAwB,CAAC;AAEhC,qBAAa,eAAgB,YAAW,gBAAgB;IACtD,OAAO,CAAC,QAAQ,CAAmC;IACnD,OAAO,CAAC,cAAc,CAAgD;IAEtE;;OAEG;IACH,QAAQ,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI;IAUhC;;OAEG;IACH,YAAY,CAAC,QAAQ,EAAE,OAAO,EAAE,GAAG,IAAI;IAMvC;;OAEG;IACH,UAAU,CAAC,IAAI,EAAE,MAAM,EAAE,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI;IAKlD;;OAEG;IACH,GAAG,CAAC,IAAI,EAAE,MAAM,EAAE,SAAS,CAAC,EAAE,MAAM,GAAG,OAAO,GAAG,SAAS;IAK1D;;OAEG;IACH,GAAG,CAAC,IAAI,EAAE,MAAM,EAAE,SAAS,CAAC,EAAE,MAAM,GAAG,OAAO;IAK9C;;OAEG;IACH,IAAI,CAAC,SAAS,CAAC,EAAE,MAAM,GAAG,OAAO,EAAE;IAUnC;;OAEG;IACH,cAAc,IAAI,MAAM,EAAE;IAY1B;;OAEG;IACH,qBAAqB,CAAC,MAAM,EAAE,oBAAoB,GAAG,IAAI;IAIzD;;OAEG;IACG,uBAAuB,IAAI,OAAO,CAAC,IAAI,CAAC;IAW9C;;OAEG;IACG,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;IAoB9B;;OAEG;IACH,OAAO,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,GAAG,SAAS;IAU9C;;OAEG;IACH,MAAM,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,EAAE;IAUlC,OAAO,CAAC,aAAa;CAGtB;AAED,wBAAgB,qBAAqB,IAAI,eAAe,CAEvD"}

package/dist/core/router/command-registry.js

@@ -0,0 +1,138 @@
+/**
+ * Command Registry
+ *
+ * Central registry for all CLI commands
+ */
+export class CommandRegistry {
+    commands = new Map();
+    dynamicSources = new Map();
+    /**
+     * Register a command
+     */
+    register(command) {
+        const key = this.getCommandKey(command.name, command.namespace);
+        if (this.commands.has(key)) {
+            console.warn(`Command ${key} is already registered, overwriting`);
+        }
+        this.commands.set(key, command);
+    }
+    /**
+     * Register multiple commands
+     */
+    registerMany(commands) {
+        for (const command of commands) {
+            this.register(command);
+        }
+    }
+    /**
+     * Unregister a command
+     */
+    unregister(name, namespace) {
+        const key = this.getCommandKey(name, namespace);
+        this.commands.delete(key);
+    }
+    /**
+     * Get a command by name and namespace
+     */
+    get(name, namespace) {
+        const key = this.getCommandKey(name, namespace);
+        return this.commands.get(key);
+    }
+    /**
+     * Check if command exists
+     */
+    has(name, namespace) {
+        const key = this.getCommandKey(name, namespace);
+        return this.commands.has(key);
+    }
+    /**
+     * List all commands, optionally filtered by namespace
+     */
+    list(namespace) {
+        const commands = Array.from(this.commands.values());
+        if (namespace) {
+            return commands.filter((cmd) => cmd.namespace === namespace);
+        }
+        return commands;
+    }
+    /**
+     * List all namespaces
+     */
+    listNamespaces() {
+        const namespaces = new Set();
+        for (const command of this.commands.values()) {
+            if (command.namespace) {
+                namespaces.add(command.namespace);
+            }
+        }
+        return Array.from(namespaces).sort();
+    }
+    /**
+     * Register a dynamic command source
+     */
+    registerDynamicSource(source) {
+        this.dynamicSources.set(source.namespace, source);
+    }
+    /**
+     * Discover and register commands from all dynamic sources
+     */
+    async discoverDynamicCommands() {
+        for (const source of this.dynamicSources.values()) {
+            try {
+                const commands = await source.discover();
+                this.registerMany(commands);
+            }
+            catch (error) {
+                console.error(`Failed to discover commands from ${source.namespace}:`, error);
+            }
+        }
+    }
+    /**
+     * Refresh commands from dynamic sources
+     */
+    async refresh() {
+        for (const source of this.dynamicSources.values()) {
+            try {
+                await source.refresh();
+                const commands = await source.discover();
+                // Remove old commands from this namespace
+                const existing = this.list(source.namespace);
+                for (const cmd of existing) {
+                    this.unregister(cmd.name, cmd.namespace);
+                }
+                // Register new commands
+                this.registerMany(commands);
+            }
+            catch (error) {
+                console.error(`Failed to refresh commands from ${source.namespace}:`, error);
+            }
+        }
+    }
+    /**
+     * Get command by full name (namespace:command or just command)
+     */
+    resolve(fullName) {
+        if (fullName.includes(':')) {
+            const [namespace, name] = fullName.split(':', 2);
+            return this.get(name, namespace);
+        }
+        // Try to find command without namespace
+        return this.get(fullName);
+    }
+    /**
+     * Search commands by keyword
+     */
+    search(keyword) {
+        const lowerKeyword = keyword.toLowerCase();
+        return Array.from(this.commands.values()).filter((cmd) => cmd.name.toLowerCase().includes(lowerKeyword) ||
+            cmd.description.toLowerCase().includes(lowerKeyword) ||
+            cmd.namespace?.toLowerCase().includes(lowerKeyword));
+    }
+    getCommandKey(name, namespace) {
+        return namespace ? `${namespace}:${name}` : name;
+    }
+}
+export function createCommandRegistry() {
+    return new CommandRegistry();
+}
+//# sourceMappingURL=command-registry.js.map

package/dist/core/router/command-registry.js.map

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

package/dist/core/router/command-router.d.ts

@@ -0,0 +1,33 @@
+/**
+ * Command Router
+ *
+ * Routes commands to appropriate handlers
+ */
+import type { Command, CommandArgs, CommandContext, CommandResult } from '../../types/command.js';
+import { CommandRegistry } from './command-registry.js';
+export declare class CommandRouter {
+    private registry;
+    constructor(registry: CommandRegistry);
+    /**
+     * Route and execute a command
+     */
+    route(commandName: string, args: CommandArgs, context: CommandContext): Promise<CommandResult>;
+    /**
+     * Find command by name, trying multiple resolution strategies
+     */
+    private findCommand;
+    /**
+     * Get all available commands
+     */
+    listCommands(namespace?: string): Command[];
+    /**
+     * Get all namespaces
+     */
+    listNamespaces(): string[];
+    /**
+     * Search commands
+     */
+    searchCommands(keyword: string): Command[];
+}
+export declare function createCommandRouter(registry: CommandRegistry): CommandRouter;
+//# sourceMappingURL=command-router.d.ts.map

package/dist/core/router/command-router.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"command-router.d.ts","sourceRoot":"","sources":["../../../src/core/router/command-router.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EACV,OAAO,EACP,WAAW,EACX,cAAc,EACd,aAAa,EACd,MAAM,wBAAwB,CAAC;AAChC,OAAO,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AAExD,qBAAa,aAAa;IACZ,OAAO,CAAC,QAAQ;gBAAR,QAAQ,EAAE,eAAe;IAE7C;;OAEG;IACG,KAAK,CACT,WAAW,EAAE,MAAM,EACnB,IAAI,EAAE,WAAW,EACjB,OAAO,EAAE,cAAc,GACtB,OAAO,CAAC,aAAa,CAAC;IAgDzB;;OAEG;IACH,OAAO,CAAC,WAAW;IA8BnB;;OAEG;IACH,YAAY,CAAC,SAAS,CAAC,EAAE,MAAM,GAAG,OAAO,EAAE;IAI3C;;OAEG;IACH,cAAc,IAAI,MAAM,EAAE;IAI1B;;OAEG;IACH,cAAc,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,EAAE;CAG3C;AAED,wBAAgB,mBAAmB,CAAC,QAAQ,EAAE,eAAe,GAAG,aAAa,CAE5E"}

package/dist/core/router/command-router.js

@@ -0,0 +1,111 @@
+/**
+ * Command Router
+ *
+ * Routes commands to appropriate handlers
+ */
+export class CommandRouter {
+    registry;
+    constructor(registry) {
+        this.registry = registry;
+    }
+    /**
+     * Route and execute a command
+     */
+    async route(commandName, args, context) {
+        // Try to find command
+        const command = this.findCommand(commandName);
+        if (!command) {
+            return {
+                success: false,
+                error: `Command '${commandName}' not found. Use 'nexus --help' to see available commands.`,
+            };
+        }
+        // Validate arguments if validator exists
+        if (command.validator) {
+            const validation = await command.validator(args, context);
+            if (!validation.valid) {
+                const errors = validation.errors?.map((e) => e.message).join(', ');
+                return {
+                    success: false,
+                    error: `Validation failed: ${errors}`,
+                };
+            }
+        }
+        // Execute command handler
+        try {
+            const startTime = Date.now();
+            const result = await command.handler(args, context);
+            const duration = Date.now() - startTime;
+            return {
+                ...result,
+                metadata: {
+                    ...result.metadata,
+                    duration,
+                    service: command.namespace,
+                },
+            };
+        }
+        catch (error) {
+            return {
+                success: false,
+                error: error.message || 'Command execution failed',
+                metadata: {
+                    service: command.namespace,
+                },
+            };
+        }
+    }
+    /**
+     * Find command by name, trying multiple resolution strategies
+     */
+    findCommand(commandName) {
+        // Strategy 1: Direct lookup
+        let command = this.registry.resolve(commandName);
+        if (command)
+            return command;
+        // Strategy 2: Try with namespace prefix (e.g., "graphrag:query")
+        if (commandName.includes(':')) {
+            const [namespace, name] = commandName.split(':', 2);
+            command = this.registry.get(name, namespace);
+            if (command)
+                return command;
+        }
+        // Strategy 3: Try common namespaces
+        const commonNamespaces = ['services', 'graphrag', 'mageagent', 'sandbox', 'nexus'];
+        for (const namespace of commonNamespaces) {
+            command = this.registry.get(commandName, namespace);
+            if (command)
+                return command;
+        }
+        // Strategy 4: Try aliases
+        const allCommands = this.registry.list();
+        for (const cmd of allCommands) {
+            if (cmd.aliases?.includes(commandName)) {
+                return cmd;
+            }
+        }
+        return undefined;
+    }
+    /**
+     * Get all available commands
+     */
+    listCommands(namespace) {
+        return this.registry.list(namespace);
+    }
+    /**
+     * Get all namespaces
+     */
+    listNamespaces() {
+        return this.registry.listNamespaces();
+    }
+    /**
+     * Search commands
+     */
+    searchCommands(keyword) {
+        return this.registry.search(keyword);
+    }
+}
+export function createCommandRouter(registry) {
+    return new CommandRouter(registry);
+}
+//# sourceMappingURL=command-router.js.map