dexto 1.3.0 → 1.4.0

package/dist/cli/commands/interactive-commands/documentation-commands.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"documentation-commands.d.ts","sourceRoot":"","sources":["../../../../src/cli/commands/interactive-commands/documentation-commands.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAIH,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AAG7D;;GAEG;AACH,eAAO,MAAM,qBAAqB,EAAE,iBAAiB,EA8BpD,CAAC"}
+{"version":3,"file":"documentation-commands.d.ts","sourceRoot":"","sources":["../../../../src/cli/commands/interactive-commands/documentation-commands.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAGH,OAAO,KAAK,EAAE,iBAAiB,EAAkB,MAAM,qBAAqB,CAAC;AAG7E;;GAEG;AACH,eAAO,MAAM,qBAAqB,EAAE,iBAAiB,EAkCpD,CAAC"}

package/dist/cli/commands/interactive-commands/documentation-commands.js

@@ -7,7 +7,6 @@
  * Available Documentation Commands:
  * - /docs, /doc - Open Dexto documentation in browser
  */
-import chalk from 'chalk';
 import { CommandOutputHelper } from './utils/command-output.js';
 /**
  * Documentation commands
@@ -19,11 +18,10 @@ export const documentationCommands = [
         usage: '/docs',
         category: 'Documentation',
         aliases: ['doc'],
-        handler: async (_args, _agent) => {
+        handler: async (_args, _agent, _ctx) => {
             const docsUrl = 'https://docs.dexto.ai/docs/category/getting-started';
             try {
                 const { spawn } = await import('child_process');
-                console.log(chalk.blue(`🌐 Opening Dexto documentation: ${docsUrl}`));
                 // Cross-platform browser opening
                 const command = process.platform === 'darwin'
                     ? 'open'
@@ -31,11 +29,10 @@ export const documentationCommands = [
                         ? 'start'
                         : 'xdg-open';
                 spawn(command, [docsUrl], { detached: true, stdio: 'ignore' });
-                return CommandOutputHelper.success('✅ Documentation opened in browser');
+                return true; // Silent success
             }
-            catch (error) {
-                console.log(chalk.yellow(`💡 You can manually visit: ${docsUrl}`));
-                return CommandOutputHelper.error(error, 'Failed to open documentation');
+            catch {
+                return CommandOutputHelper.error(new Error(`Could not open browser. Visit: ${docsUrl}`), 'Failed to open documentation');
             }
         },
     },

package/dist/cli/commands/interactive-commands/general-commands.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"general-commands.d.ts","sourceRoot":"","sources":["../../../../src/cli/commands/interactive-commands/general-commands.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAIH,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AAI7D;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,cAAc,EAAE,MAAM,iBAAiB,EAAE,GAAG,iBAAiB,CA0I9F;AAED;;;GAGG;AACH,eAAO,MAAM,eAAe,EAAE,iBAAiB,EAkC9C,CAAC"}
+{"version":3,"file":"general-commands.d.ts","sourceRoot":"","sources":["../../../../src/cli/commands/interactive-commands/general-commands.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAIH,OAAO,KAAK,EAAE,iBAAiB,EAAwC,MAAM,qBAAqB,CAAC;AAMnG;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,cAAc,EAAE,MAAM,iBAAiB,EAAE,GAAG,iBAAiB,CAgC9F;AAED;;;GAGG;AACH,eAAO,MAAM,eAAe,EAAE,iBAAiB,EAiM9C,CAAC"}

package/dist/cli/commands/interactive-commands/general-commands.js

@@ -10,9 +10,9 @@
  * - /clear, /reset - Clear conversation history
  */
 import chalk from 'chalk';
-import { logger } from '@dexto/core';
-import { displayAllCommands, formatCommandHelp } from './command-parser.js';
 import { formatForInkCli } from './utils/format-output.js';
+import { CommandOutputHelper } from './utils/command-output.js';
+import { writeToClipboard } from '../../ink-cli/utils/clipboardUtils.js';
 /**
  * Creates the help command with access to all commands for display
  */
@@ -20,113 +20,25 @@ export function createHelpCommand(getAllCommands) {
     return {
         name: 'help',
         description: 'Show help information',
-        usage: '/help [command]',
+        usage: '/help',
         category: 'General',
         aliases: ['h', '?'],
-        handler: async (args, _agent) => {
+        handler: async (_args, _agent, _ctx) => {
             const allCommands = getAllCommands();
-            if (args.length === 0) {
-                // Build output string for ink-cli
-                const outputLines = ['\n📋 Available Commands:\n'];
-                // Define category order for consistent display
-                const categoryOrder = [
-                    'General',
-                    'MCP Management',
-                    'Tool Management',
-                    'Prompt Management',
-                    'System',
-                    'Documentation',
-                ];
-                const categories = {};
-                // Initialize categories
-                for (const category of categoryOrder) {
-                    categories[category] = [];
-                }
-                // Categorize commands using metadata
-                for (const cmd of allCommands) {
-                    const category = cmd.category || 'General';
-                    if (!categories[category]) {
-                        categories[category] = [];
-                    }
-                    categories[category].push(cmd);
-                }
-                // Build output by category in order
-                for (const category of categoryOrder) {
-                    const cmds = categories[category];
-                    if (cmds && cmds.length > 0) {
-                        outputLines.push(`${category}:`);
-                        for (const cmd of cmds) {
-                            const help = formatCommandHelp(cmd, false);
-                            outputLines.push('  ' + formatForInkCli(help));
-                        }
-                        outputLines.push('');
-                    }
-                }
-                // Display any uncategorized commands (fallback)
-                for (const [category, cmds] of Object.entries(categories)) {
-                    if (!categoryOrder.includes(category) && cmds.length > 0) {
-                        outputLines.push(`${category}:`);
-                        for (const cmd of cmds) {
-                            const help = formatCommandHelp(cmd, false);
-                            outputLines.push('  ' + formatForInkCli(help));
-                        }
-                        outputLines.push('');
-                    }
-                }
-                outputLines.push('💡 Tips:');
-                outputLines.push('   • Type your message normally (without /) to chat with the AI');
-                outputLines.push('   • Use /<prompt-name> to execute any listed prompt directly');
-                outputLines.push('   • Use /clear to start a new session (preserves old)');
-                outputLines.push('   • Press Ctrl+M to switch models, Ctrl+R to switch sessions');
-                outputLines.push('   • Use /search <query> to search across all sessions\n');
-                const output = outputLines.join('\n');
-                // Log for regular CLI (with chalk formatting)
-                displayAllCommands(allCommands);
-                return formatForInkCli(output);
-            }
-            const commandName = args[0];
-            if (!commandName) {
-                const output = '❌ No command specified';
-                console.log(chalk.red(output));
-                return formatForInkCli(output);
-            }
-            // Find the specific command to show detailed help
-            const cmd = allCommands.find((c) => c.name === commandName || (c.aliases && c.aliases.includes(commandName)));
-            if (cmd) {
-                const helpText = formatCommandHelp(cmd, true);
-                console.log(helpText);
-                return formatForInkCli(helpText);
-            }
-            // Redirect to contextual help for commands that have their own help subcommands
-            let output;
-            if (commandName === 'session') {
-                output =
-                    '💡 For detailed session help, use:\n   /session help\n\n   This shows all session subcommands with examples and tips.';
-                console.log(chalk.blue('💡 For detailed session help, use:'));
-                console.log(`   ${chalk.cyan('/session help')}`);
-                console.log(chalk.dim('\n   This shows all session subcommands with examples and tips.'));
-                return formatForInkCli(output);
-            }
-            if (commandName === 'model' || commandName === 'm') {
-                output =
-                    '💡 For detailed model help, use:\n   /model help\n\n   This shows all model subcommands with examples and usage.';
-                console.log(chalk.blue('💡 For detailed model help, use:'));
-                console.log(`   ${chalk.cyan('/model help')}`);
-                console.log(chalk.dim('\n   This shows all model subcommands with examples and usage.'));
-                return formatForInkCli(output);
-            }
-            if (commandName === 'mcp') {
-                output =
-                    '💡 For detailed MCP help, use:\n   /mcp help\n\n   This shows all MCP subcommands with examples and usage.';
-                console.log(chalk.blue('💡 For detailed MCP help, use:'));
-                console.log(`   ${chalk.cyan('/mcp help')}`);
-                console.log(chalk.dim('\n   This shows all MCP subcommands with examples and usage.'));
-                return formatForInkCli(output);
+            // Build styled data for help
+            const styledData = {
+                commands: allCommands.map((cmd) => ({
+                    name: cmd.name,
+                    description: cmd.description,
+                    category: cmd.category || 'General',
+                })),
+            };
+            // Build fallback text
+            const fallbackLines = ['Available Commands:'];
+            for (const cmd of allCommands) {
+                fallbackLines.push(`  /${cmd.name} - ${cmd.description}`);
             }
-            output = `❓ No help available for: ${commandName}\nUse /help to see all available commands`;
-            console.log(chalk.yellow(`❓ No help available for: ${commandName}`));
-            console.log(chalk.dim('Use /help to see all available commands'));
-            return formatForInkCli(output);
+            return CommandOutputHelper.styled('help', styledData, fallbackLines.join('\n'));
         },
     };
 }
@@ -141,31 +53,161 @@ export const generalCommands = [
         usage: '/exit',
         category: 'General',
         aliases: ['quit', 'q'],
-        handler: async (_args, _agent) => {
-            logger.warn('Exiting AI CLI. Goodbye!');
+        handler: async (_args, _agent, _ctx) => {
+            console.log(chalk.yellow('Exiting AI CLI. Goodbye!'));
             process.exit(0);
         },
     },
     {
         name: 'clear',
-        description: 'Start a new session (clears viewable history without deleting)',
+        description: 'Clear context window (history preserved in DB, not sent to LLM)',
         usage: '/clear',
         category: 'General',
         aliases: ['new'],
-        handler: async (_args, agent) => {
+        handler: async (_args, agent, ctx) => {
             try {
-                // Create a new session instead of deleting history
-                // This clears the viewable conversation without deleting the old session
-                const newSession = await agent.createSession();
-                const output = `🔄 Started new session: ${newSession.id.slice(0, 8)}\n💡 Previous session preserved. Use /resume to switch back.`;
-                console.log(chalk.green(output));
-                return formatForInkCli(output);
+                const { sessionId } = ctx;
+                if (!sessionId) {
+                    return formatForInkCli('⚠️  No active session to clear');
+                }
+                // Clear context window - adds a marker so filterCompacted skips prior messages
+                // History stays in DB for review, but LLM won't see it
+                await agent.clearContext(sessionId);
+                return formatForInkCli('🔄 Context cleared\n💡 Previous messages preserved in history but not sent to LLM.');
             }
             catch (error) {
-                const errorMsg = `Failed to start new session: ${error instanceof Error ? error.message : String(error)}`;
-                logger.error(errorMsg);
+                const errorMsg = `Failed to clear context: ${error instanceof Error ? error.message : String(error)}`;
+                agent.logger.error(errorMsg);
                 return formatForInkCli(`❌ ${errorMsg}`);
             }
         },
     },
+    {
+        name: 'copy',
+        description: 'Copy the last assistant response to clipboard',
+        usage: '/copy',
+        category: 'General',
+        aliases: ['cp'],
+        handler: async (_args, agent, ctx) => {
+            try {
+                const { sessionId } = ctx;
+                if (!sessionId) {
+                    return formatForInkCli('❌ No active session');
+                }
+                // Get session history
+                const history = await agent.getSessionHistory(sessionId);
+                if (!history || history.length === 0) {
+                    return formatForInkCli('❌ No messages in current session');
+                }
+                // Find the last assistant message
+                const lastAssistantMessage = [...history]
+                    .reverse()
+                    .find((msg) => msg.role === 'assistant');
+                if (!lastAssistantMessage) {
+                    return formatForInkCli('❌ No assistant response to copy');
+                }
+                // Extract text content from the message
+                let textContent = '';
+                if (typeof lastAssistantMessage.content === 'string') {
+                    textContent = lastAssistantMessage.content;
+                }
+                else if (Array.isArray(lastAssistantMessage.content)) {
+                    // Handle multi-part content
+                    textContent = lastAssistantMessage.content
+                        .filter((part) => part.type === 'text')
+                        .map((part) => part.text)
+                        .join('\n');
+                }
+                if (!textContent) {
+                    return formatForInkCli('❌ No text content to copy');
+                }
+                // Copy to clipboard
+                const success = await writeToClipboard(textContent);
+                if (success) {
+                    const preview = textContent.length > 50
+                        ? textContent.substring(0, 50) + '...'
+                        : textContent;
+                    return formatForInkCli(`📋 Copied to clipboard (${textContent.length} chars)\n${preview.replace(/\n/g, ' ')}`);
+                }
+                else {
+                    return formatForInkCli('❌ Failed to copy to clipboard');
+                }
+            }
+            catch (error) {
+                const errorMsg = `Failed to copy: ${error instanceof Error ? error.message : String(error)}`;
+                agent.logger.error(errorMsg);
+                return formatForInkCli(`❌ ${errorMsg}`);
+            }
+        },
+    },
+    {
+        name: 'shortcuts',
+        description: 'Show keyboard shortcuts',
+        usage: '/shortcuts',
+        category: 'General',
+        aliases: ['keys', 'hotkeys'],
+        handler: async (_args, _agent, _ctx) => {
+            const styledData = {
+                categories: [
+                    {
+                        name: 'Global',
+                        shortcuts: [
+                            { keys: 'Ctrl+C', description: 'Clear input, then exit (press twice)' },
+                            { keys: 'Escape', description: 'Cancel processing / close overlay' },
+                        ],
+                    },
+                    {
+                        name: 'Input',
+                        shortcuts: [
+                            { keys: 'Enter', description: 'Submit message' },
+                            { keys: 'Shift+Enter', description: 'New line (multi-line input)' },
+                            { keys: 'Up/Down', description: 'Navigate input history' },
+                            { keys: 'Ctrl+R', description: 'Search history (enter search mode)' },
+                            { keys: 'Tab', description: 'Autocomplete command' },
+                            { keys: 'Ctrl+U', description: 'Clear input line' },
+                            { keys: 'Ctrl+W', description: 'Delete word before cursor' },
+                            { keys: 'Ctrl+A', description: 'Move cursor to start' },
+                            { keys: 'Ctrl+E', description: 'Move cursor to end' },
+                        ],
+                    },
+                    {
+                        name: 'History Search (after Ctrl+R)',
+                        shortcuts: [
+                            { keys: 'Ctrl+R', description: 'Next older match' },
+                            { keys: 'Ctrl+E', description: 'Next newer match' },
+                            { keys: 'Enter', description: 'Accept and exit search' },
+                            { keys: 'Escape', description: 'Cancel search' },
+                        ],
+                    },
+                    {
+                        name: 'Autocomplete & Selectors',
+                        shortcuts: [
+                            { keys: 'Up/Down', description: 'Navigate options' },
+                            { keys: 'Enter', description: 'Select / execute' },
+                            { keys: 'Tab', description: 'Load command into input' },
+                            { keys: 'Escape', description: 'Close overlay' },
+                        ],
+                    },
+                    {
+                        name: 'Tool Approval',
+                        shortcuts: [
+                            { keys: 'y', description: 'Allow once' },
+                            { keys: 'a', description: 'Allow for session' },
+                            { keys: 'n', description: 'Deny' },
+                            { keys: 'Escape', description: 'Cancel' },
+                        ],
+                    },
+                ],
+            };
+            // Build fallback text
+            const fallbackLines = ['Keyboard Shortcuts:'];
+            for (const category of styledData.categories) {
+                fallbackLines.push(`\n${category.name}:`);
+                for (const shortcut of category.shortcuts) {
+                    fallbackLines.push(`  ${shortcut.keys.padEnd(14)} ${shortcut.description}`);
+                }
+            }
+            return CommandOutputHelper.styled('shortcuts', styledData, fallbackLines.join('\n'));
+        },
+    },
 ];

package/dist/cli/commands/interactive-commands/mcp/index.d.ts

@@ -1,7 +1,13 @@
 /**
- * MCP Commands Index
+ * MCP Commands Module
  *
- * Exports MCP command definitions for integration with the CLI system.
+ * In interactive CLI, /mcp always shows the interactive MCP server list overlay.
+ * This command definition exists for autocomplete and help display.
  */
-export { mcpCommands } from './mcp-commands.js';
+import type { CommandDefinition } from '../command-parser.js';
+/**
+ * MCP management command definition
+ * Always shows the interactive MCP server list overlay (handled by ALWAYS_OVERLAY)
+ */
+export declare const mcpCommands: CommandDefinition;
 //# sourceMappingURL=index.d.ts.map

package/dist/cli/commands/interactive-commands/mcp/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../src/cli/commands/interactive-commands/mcp/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../src/cli/commands/interactive-commands/mcp/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,KAAK,EAAE,iBAAiB,EAAwC,MAAM,sBAAsB,CAAC;AAEpG;;;GAGG;AACH,eAAO,MAAM,WAAW,EAAE,iBAczB,CAAC"}

package/dist/cli/commands/interactive-commands/mcp/index.js

@@ -1,6 +1,21 @@
 /**
- * MCP Commands Index
+ * MCP Commands Module
  *
- * Exports MCP command definitions for integration with the CLI system.
+ * In interactive CLI, /mcp always shows the interactive MCP server list overlay.
+ * This command definition exists for autocomplete and help display.
  */
-export { mcpCommands } from './mcp-commands.js';
+/**
+ * MCP management command definition
+ * Always shows the interactive MCP server list overlay (handled by ALWAYS_OVERLAY)
+ */
+export const mcpCommands = {
+    name: 'mcp',
+    description: 'Manage MCP servers (interactive)',
+    usage: '/mcp',
+    category: 'MCP Management',
+    handler: async (_args, _agent, _ctx) => {
+        // This handler is never called - mcp is in ALWAYS_OVERLAY
+        // which intercepts and shows the MCP server list overlay instead
+        return true;
+    },
+};

package/dist/cli/commands/interactive-commands/model/index.d.ts

@@ -1,11 +1,13 @@
 /**
  * Model Commands Module
  *
- * This module provides centralized access to all model-related commands and utilities.
- * It serves as the main entry point for model management functionality in the CLI.
- *
- * Exports:
- * - modelCommands: Complete model command definition with all subcommands
+ * In interactive CLI, /model always shows the interactive model selector overlay.
+ * This command definition exists for autocomplete and help display.
+ */
+import type { CommandDefinition } from '../command-parser.js';
+/**
+ * Model management command definition
+ * Always shows the interactive model selector overlay (handled by ALWAYS_OVERLAY)
  */
-export { modelCommands } from './model-commands.js';
+export declare const modelCommands: CommandDefinition;
 //# sourceMappingURL=index.d.ts.map

package/dist/cli/commands/interactive-commands/model/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../src/cli/commands/interactive-commands/model/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../src/cli/commands/interactive-commands/model/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,iBAAiB,EAAwB,MAAM,sBAAsB,CAAC;AAEpF;;;GAGG;AACH,eAAO,MAAM,aAAa,EAAE,iBAW3B,CAAC"}

package/dist/cli/commands/interactive-commands/model/index.js

@@ -1,10 +1,22 @@
 /**
  * Model Commands Module
  *
- * This module provides centralized access to all model-related commands and utilities.
- * It serves as the main entry point for model management functionality in the CLI.
- *
- * Exports:
- * - modelCommands: Complete model command definition with all subcommands
+ * In interactive CLI, /model always shows the interactive model selector overlay.
+ * This command definition exists for autocomplete and help display.
+ */
+/**
+ * Model management command definition
+ * Always shows the interactive model selector overlay (handled by ALWAYS_OVERLAY)
  */
-export { modelCommands } from './model-commands.js';
+export const modelCommands = {
+    name: 'model',
+    description: 'Switch AI model (interactive selector)',
+    usage: '/model',
+    category: 'General',
+    aliases: ['m'],
+    handler: async () => {
+        // This handler is never called - model is in ALWAYS_OVERLAY
+        // which intercepts and shows the model selector overlay instead
+        return true;
+    },
+};

package/dist/cli/commands/interactive-commands/prompt-commands.d.ts

@@ -9,14 +9,15 @@
  * - /prompts - List all available prompts (MCP + internal)
  * - /<prompt-name> [args] - Direct prompt execution (auto-generated for each prompt)
  */
-import { type DextoAgent } from '@dexto/core';
+import type { DextoAgent } from '@dexto/core';
 import type { CommandDefinition } from './command-parser.js';
 /**
  * Prompt management commands
  */
 export declare const promptCommands: CommandDefinition[];
 /**
- * Get all dynamic prompt commands based on available prompts
+ * Get all dynamic prompt commands based on available prompts.
+ * Handles displayName collisions by prefixing with source (e.g., config:review).
  */
 export declare function getDynamicPromptCommands(agent: DextoAgent): Promise<CommandDefinition[]>;
 //# sourceMappingURL=prompt-commands.d.ts.map

package/dist/cli/commands/interactive-commands/prompt-commands.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"prompt-commands.d.ts","sourceRoot":"","sources":["../../../../src/cli/commands/interactive-commands/prompt-commands.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAGH,OAAO,EAAU,KAAK,UAAU,EAAE,MAAM,aAAa,CAAC;AAEtD,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AAK7D;;GAEG;AACH,eAAO,MAAM,cAAc,EAAE,iBAAiB,EAiL7C,CAAC;AAqFF;;GAEG;AACH,wBAAsB,wBAAwB,CAAC,KAAK,EAAE,UAAU,GAAG,OAAO,CAAC,iBAAiB,EAAE,CAAC,CAU9F"}
+{"version":3,"file":"prompt-commands.d.ts","sourceRoot":"","sources":["../../../../src/cli/commands/interactive-commands/prompt-commands.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAGH,OAAO,KAAK,EAAE,UAAU,EAAc,MAAM,aAAa,CAAC;AAC1D,OAAO,KAAK,EAAE,iBAAiB,EAAwC,MAAM,qBAAqB,CAAC;AAKnG;;GAEG;AACH,eAAO,MAAM,cAAc,EAAE,iBAAiB,EA8L7C,CAAC;AAwFF;;;GAGG;AACH,wBAAsB,wBAAwB,CAAC,KAAK,EAAE,UAAU,GAAG,OAAO,CAAC,iBAAiB,EAAE,CAAC,CAwB9F"}