dexto 1.1.10 → 1.2.0

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

@@ -5,18 +5,21 @@
  * These commands provide functionality for viewing and managing system prompts.
  *
  * Available Prompt Commands:
- * - /prompt - Display the current system prompt
+ * - /sysprompt - Display the current system prompt
+ * - /prompts - List all available prompts (MCP + internal)
+ * - /<prompt-name> [args] - Direct prompt execution (auto-generated for each prompt)
  */
 import chalk from 'chalk';
-import { logger } from '@dexto/core';
+import { logger, flattenPromptResult } from '@dexto/core';
+// Avoid depending on core types to keep CLI typecheck independent of build
 /**
  * Prompt management commands
  */
 export const promptCommands = [
     {
-        name: 'prompt',
+        name: 'sysprompt',
         description: 'Display the current system prompt',
-        usage: '/prompt',
+        usage: '/sysprompt',
         category: 'Prompt Management',
         handler: async (args, agent) => {
             try {
@@ -33,4 +36,249 @@ export const promptCommands = [
             return true;
         },
     },
+    {
+        name: 'prompts',
+        description: 'List all available prompts (MCP + internal)',
+        usage: '/prompts',
+        category: 'Prompt Management',
+        handler: async (_args, agent) => {
+            try {
+                const prompts = await agent.listPrompts();
+                const promptNames = Object.keys(prompts || {});
+                if (promptNames.length === 0) {
+                    console.log(chalk.yellow('\n⚠️  No prompts available'));
+                    return true;
+                }
+                console.log(chalk.bold.green('\n📝 Available Prompts:\n'));
+                // Group by source
+                const mcpPrompts = [];
+                const filePrompts = [];
+                const starterPrompts = [];
+                const customPrompts = [];
+                for (const [name, info] of Object.entries(prompts)) {
+                    if (info.source === 'mcp') {
+                        mcpPrompts.push(name);
+                    }
+                    else if (info.source === 'file') {
+                        filePrompts.push(name);
+                    }
+                    else if (info.source === 'starter') {
+                        starterPrompts.push(name);
+                    }
+                    else if (info.source === 'custom') {
+                        customPrompts.push(name);
+                    }
+                }
+                if (mcpPrompts.length > 0) {
+                    console.log(chalk.cyan('🔗 MCP Prompts:'));
+                    mcpPrompts.forEach((name) => {
+                        const info = prompts[name];
+                        if (info) {
+                            // Only show title if it's different from name
+                            const title = info.title && info.title !== name ? ` (${info.title})` : '';
+                            const desc = info.description ? ` - ${info.description}` : '';
+                            const args = info.arguments && info.arguments.length > 0
+                                ? ` [args: ${info.arguments
+                                    .map((a) => `${a.name}${a.required ? '*' : ''}`)
+                                    .join(', ')}]`
+                                : '';
+                            console.log(`  ${chalk.blue(name)}${chalk.yellow(title)}${chalk.dim(desc)}${chalk.gray(args)}`);
+                        }
+                    });
+                    console.log();
+                }
+                if (filePrompts.length > 0) {
+                    console.log(chalk.magenta('📁 File Prompts:'));
+                    filePrompts.forEach((name) => {
+                        const info = prompts[name];
+                        if (info) {
+                            // Only show title if it's different from name
+                            const title = info.title && info.title !== name ? ` (${info.title})` : '';
+                            const desc = info.description ? ` - ${info.description}` : '';
+                            console.log(`  ${chalk.blue(name)}${chalk.yellow(title)}${chalk.dim(desc)}`);
+                        }
+                    });
+                    console.log();
+                }
+                if (starterPrompts.length > 0) {
+                    console.log(chalk.green('⭐ Starter Prompts:'));
+                    starterPrompts.forEach((name) => {
+                        const info = prompts[name];
+                        if (info) {
+                            // Only show title if it's different from name
+                            const title = info.title && info.title !== name ? ` (${info.title})` : '';
+                            const desc = info.description ? ` - ${info.description}` : '';
+                            console.log(`  ${chalk.blue(name)}${chalk.yellow(title)}${chalk.dim(desc)}`);
+                        }
+                    });
+                    console.log();
+                }
+                if (customPrompts.length > 0) {
+                    console.log(chalk.greenBright('✨ Custom Prompts:'));
+                    customPrompts.forEach((name) => {
+                        const info = prompts[name];
+                        if (info) {
+                            // Only show title if it's different from name
+                            const title = info.title && info.title !== name ? ` (${info.title})` : '';
+                            const desc = info.description ? ` - ${info.description}` : '';
+                            console.log(`  ${chalk.blue(name)}${chalk.yellow(title)}${chalk.dim(desc)}`);
+                        }
+                    });
+                    console.log();
+                }
+                console.log(chalk.dim(`Total: ${promptNames.length} prompts`));
+                return true;
+            }
+            catch (error) {
+                console.error(chalk.red(`Error listing prompts: ${error instanceof Error ? error.message : String(error)}`));
+                return false;
+            }
+        },
+    },
+    {
+        // TODO: (355) USER TO CHECK: Nit: rename to 'use prompt'?
+        // https://github.com/truffle-ai/dexto/pull/355#discussion_r2412938399
+        name: 'use',
+        description: 'Use a specific prompt with optional arguments',
+        usage: '/<prompt-name> [args]',
+        category: 'Prompt Management',
+        handler: async (args, agent) => {
+            try {
+                if (args.length === 0) {
+                    console.log(chalk.red('❌ Please specify a prompt name'));
+                    console.log(chalk.dim('Usage: /<prompt-name> [args]'));
+                    console.log(chalk.dim('Example: /code-review language=javascript code="console.log(\'hello\')"'));
+                    return true;
+                }
+                const promptName = args[0];
+                const promptArgs = args.slice(1);
+                // Check if prompt exists
+                if (!promptName || !(await agent.hasPrompt(promptName))) {
+                    console.log(chalk.red(`❌ Prompt '${promptName}' not found`));
+                    console.log(chalk.dim('Use /prompts to see available prompts'));
+                    return true;
+                }
+                const { argMap, context } = splitPromptArguments(promptArgs);
+                console.log(chalk.cyan(`🤖 Using prompt: ${promptName}`));
+                if (Object.keys(argMap).length > 0) {
+                    console.log(chalk.dim(`Arguments: ${JSON.stringify(argMap)}`));
+                }
+                if (context) {
+                    console.log(chalk.dim(`Context: ${context}`));
+                }
+                const result = await agent.getPrompt(promptName, argMap);
+                const flattened = flattenPromptResult(result);
+                if (flattened.resourceUris.length > 0) {
+                    console.log(chalk.dim(`Resources: ${flattened.resourceUris.map((uri) => `@<${uri}>`).join(', ')}`));
+                }
+                const finalText = appendContext(flattened.text, context);
+                if (finalText.trim()) {
+                    await agent.run(finalText.trim());
+                }
+                else {
+                    console.log(chalk.yellow(`⚠️  Prompt '${promptName}' returned no content`));
+                }
+                return true;
+            }
+            catch (error) {
+                const errorMessage = error instanceof Error ? error.message : String(error);
+                logger.error(`Failed to use prompt: ${errorMessage}`);
+                if (errorMessage.includes('not found')) {
+                    console.log(chalk.red(`❌ Prompt not found. Try running /prompts to see available prompts.`));
+                }
+                else {
+                    console.log(chalk.red(`❌ Error: ${errorMessage}`));
+                }
+                return true;
+            }
+        },
+    },
 ];
+/**
+ * Create a dynamic command definition from a prompt
+ */
+function createPromptCommand(promptInfo) {
+    return {
+        name: promptInfo.name,
+        description: promptInfo.description || `Execute ${promptInfo.name} prompt`,
+        usage: `/${promptInfo.name} [context]`,
+        category: 'Dynamic Prompts',
+        handler: async (args, agent) => {
+            try {
+                const { argMap, context: contextString } = splitPromptArguments(args);
+                if (Object.keys(argMap).length > 0) {
+                    console.log(chalk.cyan(`🤖 Executing prompt: ${promptInfo.name}`));
+                    console.log(chalk.dim(`Explicit arguments: ${JSON.stringify(argMap)}`));
+                }
+                else if (contextString) {
+                    console.log(chalk.cyan(`🤖 Executing prompt: ${promptInfo.name}`));
+                    console.log(chalk.dim(`Context: ${contextString} (LLM will extrapolate template variables)`));
+                }
+                else {
+                    console.log(chalk.cyan(`🤖 Executing prompt: ${promptInfo.name}`));
+                    console.log(chalk.dim('No arguments provided - LLM will extrapolate from context'));
+                }
+                const result = await agent.getPrompt(promptInfo.name, argMap);
+                const flattened = flattenPromptResult(result);
+                if (flattened.resourceUris.length > 0) {
+                    console.log(chalk.dim(`Resources: ${flattened.resourceUris.map((uri) => `@<${uri}>`).join(', ')}`));
+                }
+                const finalText = appendContext(flattened.text, contextString);
+                if (finalText.trim()) {
+                    await agent.run(finalText.trim());
+                }
+                else {
+                    console.log(chalk.yellow(`⚠️  Prompt '${promptInfo.name}' returned no content`));
+                }
+                return true;
+            }
+            catch (error) {
+                const errorMessage = error instanceof Error ? error.message : String(error);
+                logger.error(`Failed to execute prompt command '${promptInfo.name}': ${errorMessage}`);
+                console.log(chalk.red(`❌ Error executing prompt '${promptInfo.name}': ${errorMessage}`));
+                return true;
+            }
+        },
+    };
+}
+/**
+ * Get all dynamic prompt commands based on available prompts
+ */
+export async function getDynamicPromptCommands(agent) {
+    try {
+        const prompts = await agent.listPrompts();
+        return Object.values(prompts).map(createPromptCommand);
+    }
+    catch (error) {
+        logger.error(`Failed to get dynamic prompt commands: ${error instanceof Error ? error.message : String(error)}`);
+        return [];
+    }
+}
+function splitPromptArguments(args) {
+    const map = {};
+    const contextParts = [];
+    for (const arg of args) {
+        const equalsIndex = arg.indexOf('=');
+        if (equalsIndex > 0) {
+            const key = arg.slice(0, equalsIndex).trim();
+            const value = arg.slice(equalsIndex + 1);
+            if (key.length > 0) {
+                map[key] = value;
+            }
+        }
+        else if (arg.trim().length > 0) {
+            contextParts.push(arg);
+        }
+    }
+    const context = contextParts.length > 0 ? contextParts.join(' ') : undefined;
+    return { argMap: map, context };
+}
+function appendContext(text, context) {
+    if (!context || context.trim().length === 0) {
+        return text ?? '';
+    }
+    if (!text || text.trim().length === 0) {
+        return context;
+    }
+    return `${text.trim()}\n\n${context}`;
+}

package/dist/cli/commands/list-agents.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"list-agents.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/list-agents.ts"],"names":[],"mappings":"AAMA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AASxB,QAAA,MAAM,uBAAuB;;;;;;;;;;;;EAMhB,CAAC;AAEd,MAAM,MAAM,wBAAwB,GAAG,CAAC,CAAC,MAAM,CAAC,OAAO,uBAAuB,CAAC,CAAC;AAChF,MAAM,MAAM,6BAA6B,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,uBAAuB,CAAC,CAAC;AAwHpF;;GAEG;AACH,wBAAsB,uBAAuB,CACzC,OAAO,EAAE,6BAA6B,GACvC,OAAO,CAAC,IAAI,CAAC,CA6Gf"}
+{"version":3,"file":"list-agents.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/list-agents.ts"],"names":[],"mappings":"AAMA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AASxB,QAAA,MAAM,uBAAuB;;;;;;;;;;;;EAMhB,CAAC;AAEd,MAAM,MAAM,wBAAwB,GAAG,CAAC,CAAC,MAAM,CAAC,OAAO,uBAAuB,CAAC,CAAC;AAChF,MAAM,MAAM,6BAA6B,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,uBAAuB,CAAC,CAAC;AA0HpF;;GAEG;AACH,wBAAsB,uBAAuB,CACzC,OAAO,EAAE,6BAA6B,GACvC,OAAO,CAAC,IAAI,CAAC,CAiIf"}

package/dist/cli/commands/list-agents.js

@@ -93,6 +93,7 @@ function getAvailableAgents() {
         description: data.description,
         author: data.author,
         tags: data.tags,
+        type: data.type,
     }))
         .sort((a, b) => a.name.localeCompare(b.name));
 }
@@ -150,9 +151,27 @@ export async function handleListAgentsCommand(options) {
     // Show available agents (not installed)
     if (showAvailable) {
         const availableNotInstalled = availableAgents.filter((available) => !installedAgents.some((installed) => installed.name === available.name));
-        if (availableNotInstalled.length > 0) {
-            console.log(chalk.blue('📋 Available to Install:'));
-            for (const agent of availableNotInstalled) {
+        const builtinAgents = availableNotInstalled.filter((a) => a.type === 'builtin');
+        const customAgents = availableNotInstalled.filter((a) => a.type === 'custom');
+        if (builtinAgents.length > 0) {
+            console.log(chalk.blue('📋 Builtin Agents Available to Install:'));
+            for (const agent of builtinAgents) {
+                if (validated.verbose) {
+                    console.log(`  ${chalk.bold(agent.name)}`);
+                    console.log(`    ${chalk.gray(agent.description)}`);
+                    console.log(`    ${chalk.gray('Author:')} ${agent.author}`);
+                    console.log(`    ${chalk.gray('Tags:')} ${agent.tags.join(', ')}`);
+                    console.log();
+                }
+                else {
+                    console.log(`  • ${chalk.bold(agent.name)} - ${agent.description}`);
+                }
+            }
+            console.log();
+        }
+        if (customAgents.length > 0) {
+            console.log(chalk.magenta('🔧 Custom Agents Available:'));
+            for (const agent of customAgents) {
                 if (validated.verbose) {
                     console.log(`  ${chalk.bold(agent.name)}`);
                     console.log(`    ${chalk.gray(agent.description)}`);

package/dist/cli/commands/setup.d.ts

@@ -7,28 +7,28 @@ declare const SetupCommandSchema: z.ZodEffects<z.ZodObject<{
     force: z.ZodDefault<z.ZodBoolean>;
 }, "strict", z.ZodTypeAny, {
     interactive: boolean;
-    defaultAgent: string;
     force: boolean;
+    defaultAgent: string;
     model?: string | undefined;
     provider?: "openai" | "openai-compatible" | "anthropic" | "google" | "groq" | "xai" | "cohere" | undefined;
 }, {
     interactive?: boolean | undefined;
     model?: string | undefined;
     provider?: "openai" | "openai-compatible" | "anthropic" | "google" | "groq" | "xai" | "cohere" | undefined;
-    defaultAgent?: string | undefined;
     force?: boolean | undefined;
+    defaultAgent?: string | undefined;
 }>, {
     interactive: boolean;
-    defaultAgent: string;
     force: boolean;
+    defaultAgent: string;
     model?: string | undefined;
     provider?: "openai" | "openai-compatible" | "anthropic" | "google" | "groq" | "xai" | "cohere" | undefined;
 }, {
     interactive?: boolean | undefined;
     model?: string | undefined;
     provider?: "openai" | "openai-compatible" | "anthropic" | "google" | "groq" | "xai" | "cohere" | undefined;
-    defaultAgent?: string | undefined;
     force?: boolean | undefined;
+    defaultAgent?: string | undefined;
 }>;
 export type CLISetupOptions = z.output<typeof SetupCommandSchema>;
 export type CLISetupOptionsInput = z.input<typeof SetupCommandSchema>;

package/dist/cli/commands/uninstall.d.ts

@@ -4,8 +4,8 @@ declare const UninstallCommandSchema: z.ZodObject<{
     all: z.ZodDefault<z.ZodBoolean>;
     force: z.ZodDefault<z.ZodBoolean>;
 }, "strict", z.ZodTypeAny, {
-    agents: string[];
     force: boolean;
+    agents: string[];
     all: boolean;
 }, {
     agents: string[];

package/dist/cli/tool-confirmation/cli-confirmation-handler.d.ts

@@ -1,24 +1,53 @@
 import { AgentEventBus } from '@dexto/core';
 import { EventSubscriber } from '../../api/types.js';
 /**
- * CLI-specific subscriber for tool confirmation events
- * Implements EventSubscriber pattern to listen to AgentEventBus for tool confirmation requests
+ * CLI-specific subscriber for approval events
+ * Implements EventSubscriber pattern to listen to AgentEventBus for approval requests
  */
 export declare class CLIToolConfirmationSubscriber implements EventSubscriber {
     private agentEventBus?;
     constructor();
     /**
-     * Subscribe to tool confirmation events on the AgentEventBus
+     * Subscribe to approval events on the AgentEventBus
      */
     subscribe(eventBus: AgentEventBus): void;
     /**
-     * Handle tool confirmation request events from the AgentEventBus
+     * Handle approval request events from the AgentEventBus
      */
-    private handleConfirmationRequest;
+    private handleApprovalRequest;
     /**
-     * Send confirmation response via AgentEventBus
+     * Handle tool confirmation approval
      */
-    private sendConfirmationResponse;
+    private handleToolConfirmation;
+    /**
+     * Handle elicitation approval (form-based input from MCP servers)
+     */
+    private handleElicitation;
+    /**
+     * Collect form data based on JSON Schema
+     * Returns null if user cancels
+     */
+    private collectFormData;
+    /**
+     * Collect string input from user
+     */
+    private collectStringInput;
+    /**
+     * Collect boolean input from user (yes/no)
+     */
+    private collectBooleanInput;
+    /**
+     * Collect number input from user
+     */
+    private collectNumberInput;
+    /**
+     * Collect enum input from user (select from list)
+     */
+    private collectEnumInput;
+    /**
+     * Send approval response via AgentEventBus
+     */
+    private sendApprovalResponse;
     /**
      * Collect user input with arrow key navigation
      * @returns Promise resolving to boolean (true for approve, false for deny)

package/dist/cli/tool-confirmation/cli-confirmation-handler.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"cli-confirmation-handler.d.ts","sourceRoot":"","sources":["../../../src/cli/tool-confirmation/cli-confirmation-handler.ts"],"names":[],"mappings":"AAIA,OAAO,EAGH,aAAa,EAChB,MAAM,aAAa,CAAC;AACrB,OAAO,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AAErD;;;GAGG;AACH,qBAAa,6BAA8B,YAAW,eAAe;IACjE,OAAO,CAAC,aAAa,CAAC,CAAgB;;IAMtC;;OAEG;IACH,SAAS,CAAC,QAAQ,EAAE,aAAa,GAAG,IAAI;IAQxC;;OAEG;YACW,yBAAyB;IAoCvC;;OAEG;IACH,OAAO,CAAC,wBAAwB;IAWhC;;;OAGG;IACH,OAAO,CAAC,oBAAoB;IA2F5B;;;OAGG;IACH,OAAO,CAAC,eAAe;IAevB;;OAEG;IACH,OAAO,IAAI,IAAI;CAKlB"}
+{"version":3,"file":"cli-confirmation-handler.d.ts","sourceRoot":"","sources":["../../../src/cli/tool-confirmation/cli-confirmation-handler.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAC5C,OAAO,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AAErD;;;GAGG;AACH,qBAAa,6BAA8B,YAAW,eAAe;IACjE,OAAO,CAAC,aAAa,CAAC,CAAgB;;IAMtC;;OAEG;IACH,SAAS,CAAC,QAAQ,EAAE,aAAa,GAAG,IAAI;IAKxC;;OAEG;YACW,qBAAqB;IAoCnC;;OAEG;YACW,sBAAsB;IA+CpC;;OAEG;YACW,iBAAiB;IAwE/B;;;OAGG;YACW,eAAe;IAuD7B;;OAEG;IACH,OAAO,CAAC,kBAAkB;IAuC1B;;OAEG;IACH,OAAO,CAAC,mBAAmB;IAgD3B;;OAEG;IACH,OAAO,CAAC,kBAAkB;IAsD1B;;OAEG;IACH,OAAO,CAAC,gBAAgB;IA4DxB;;OAEG;IACH,OAAO,CAAC,oBAAoB;IAgB5B;;;OAGG;IACH,OAAO,CAAC,oBAAoB;IA2F5B;;;OAGG;IACH,OAAO,CAAC,eAAe;IAevB;;OAEG;IACH,OAAO,IAAI,IAAI;CAKlB"}