dexto 1.3.0 → 1.5.0

package/dist/cli/commands/create-image.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Creates a Dexto image project - a distributable agent harness package
+ * @param name - Optional name of the image project
+ * @returns The absolute path to the created project directory
+ */
+export declare function createImage(name?: string): Promise<string>;
+//# sourceMappingURL=create-image.d.ts.map

package/dist/cli/commands/create-image.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"create-image.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/create-image.ts"],"names":[],"mappings":"AAsBA;;;;GAIG;AACH,wBAAsB,WAAW,CAAC,IAAI,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAkPhE"}

package/dist/cli/commands/create-image.js

@@ -0,0 +1,201 @@
+import path from 'path';
+import * as p from '@clack/prompts';
+import chalk from 'chalk';
+import { selectOrExit, textOrExit, confirmOrExit } from '../utils/prompt-helpers.js';
+import { promptForProjectName, createProjectDirectory, setupGitRepo, createGitignore, initPackageJson, createTsconfigForImage, installDependencies, ensureDirectory, } from '../utils/scaffolding-utils.js';
+import { generateDextoImageFile, generateImageReadme, generateExampleTool, } from '../utils/template-engine.js';
+import fs from 'fs-extra';
+import { getExecutionContext } from '@dexto/agent-management';
+/**
+ * Creates a Dexto image project - a distributable agent harness package
+ * @param name - Optional name of the image project
+ * @returns The absolute path to the created project directory
+ */
+export async function createImage(name) {
+    console.log(chalk.blue('🎨 Creating a Dexto image - a distributable agent harness package\n'));
+    // Step 1: Get project name
+    const projectName = name
+        ? name
+        : await promptForProjectName('my-dexto-image', 'What do you want to name your image?');
+    // Step 2: Get description
+    const description = await textOrExit({
+        message: 'Describe your image:',
+        placeholder: 'Custom agent harness for my organization',
+        defaultValue: 'Custom agent harness for my organization',
+    }, 'Image creation cancelled');
+    // Step 3: Starting point - new base or extend existing
+    const startingPoint = await selectOrExit({
+        message: 'Starting point:',
+        options: [
+            { value: 'base', label: 'New base image (build from scratch)' },
+            { value: 'extend', label: 'Extend existing image (add providers to base)' },
+        ],
+    }, 'Image creation cancelled');
+    let baseImage;
+    if (startingPoint === 'extend') {
+        // Step 4: Which image to extend?
+        const baseImageChoice = await selectOrExit({
+            message: 'Which image to extend?',
+            options: [
+                {
+                    value: '@dexto/image-local',
+                    label: '@dexto/image-local (local development)',
+                },
+                { value: '@dexto/image-cloud', label: '@dexto/image-cloud (cloud production)' },
+                { value: '@dexto/image-edge', label: '@dexto/image-edge (edge/serverless)' },
+                { value: 'custom', label: 'Custom npm package...' },
+            ],
+        }, 'Image creation cancelled');
+        if (baseImageChoice === 'custom') {
+            const customBase = await textOrExit({
+                message: 'Enter the npm package name:',
+                placeholder: '@myorg/image-base',
+                validate: (value) => {
+                    if (!value || value.trim() === '') {
+                        return 'Package name is required';
+                    }
+                    return undefined;
+                },
+            }, 'Image creation cancelled');
+            baseImage = customBase;
+        }
+        else {
+            baseImage = baseImageChoice;
+        }
+    }
+    // Step 5: Target environment
+    const target = await selectOrExit({
+        message: 'Target environment:',
+        options: [
+            { value: 'local-development', label: 'Local development' },
+            { value: 'cloud-production', label: 'Cloud production' },
+            { value: 'edge-serverless', label: 'Edge/serverless' },
+            { value: 'custom', label: 'Custom' },
+        ],
+    }, 'Image creation cancelled');
+    // Step 6: Include example providers?
+    const includeExamples = await confirmOrExit({
+        message: 'Include example tool provider?',
+        initialValue: true,
+    }, 'Image creation cancelled');
+    // Start scaffolding
+    const spinner = p.spinner();
+    let projectPath;
+    try {
+        // Save original cwd before changing directories (for resolving relative paths)
+        const originalCwd = process.cwd();
+        // Create project directory
+        projectPath = await createProjectDirectory(projectName, spinner);
+        // Change to project directory
+        process.chdir(projectPath);
+        spinner.start('Setting up project structure...');
+        // Create convention-based folders
+        await ensureDirectory('tools');
+        await ensureDirectory('blob-store');
+        await ensureDirectory('compression');
+        await ensureDirectory('plugins');
+        // Create .gitkeep files for empty directories
+        await fs.writeFile('blob-store/.gitkeep', '');
+        await fs.writeFile('compression/.gitkeep', '');
+        await fs.writeFile('plugins/.gitkeep', '');
+        // Create example tool if requested
+        if (includeExamples) {
+            await ensureDirectory('tools/example-tool');
+            const exampleToolCode = generateExampleTool('example-tool');
+            await fs.writeFile('tools/example-tool/index.ts', exampleToolCode);
+        }
+        else {
+            await fs.writeFile('tools/.gitkeep', '');
+        }
+        spinner.message('Generating configuration files...');
+        // Create dexto.image.ts
+        const dextoImageContent = generateDextoImageFile({
+            projectName,
+            packageName: projectName,
+            description,
+            imageName: projectName,
+            ...(baseImage ? { baseImage } : {}),
+            target,
+        });
+        await fs.writeFile('dexto.image.ts', dextoImageContent);
+        // Create package.json
+        await initPackageJson(projectPath, projectName, 'image');
+        // Update package.json with build script
+        const packageJsonPath = path.join(projectPath, 'package.json');
+        const packageJson = JSON.parse(await fs.readFile(packageJsonPath, 'utf8'));
+        packageJson.scripts = {
+            build: 'dexto-bundle build',
+            typecheck: 'tsc --noEmit',
+            ...packageJson.scripts,
+        };
+        await fs.writeFile(packageJsonPath, JSON.stringify(packageJson, null, 2));
+        // Create tsconfig.json
+        await createTsconfigForImage(projectPath);
+        // Create README
+        const readmeContent = generateImageReadme({
+            projectName,
+            packageName: projectName,
+            description,
+            imageName: projectName,
+            ...(baseImage ? { baseImage } : {}),
+        });
+        await fs.writeFile('README.md', readmeContent);
+        // Create .gitignore
+        await createGitignore(projectPath, ['*.tsbuildinfo']);
+        // Initialize git
+        spinner.message('Initializing git repository...');
+        await setupGitRepo(projectPath);
+        spinner.message('Installing dependencies...');
+        // Detect if we're in dexto source - use workspace protocol for local development
+        const executionContext = getExecutionContext();
+        const isDextoSource = executionContext === 'dexto-source';
+        const coreVersion = isDextoSource ? 'workspace:*' : '^1.3.0';
+        const bundlerVersion = isDextoSource ? 'workspace:*' : '^1.3.0';
+        // Determine dependencies based on whether extending
+        const dependencies = [`@dexto/core@${coreVersion}`, 'zod'];
+        const devDependencies = [
+            'typescript@^5.0.0',
+            '@types/node@^20.0.0',
+            `@dexto/image-bundler@${bundlerVersion}`,
+        ];
+        if (baseImage) {
+            // Resolve base image path if we're in dexto source
+            let resolvedBaseImage = baseImage;
+            if (isDextoSource && baseImage.startsWith('@dexto/image-')) {
+                // In dexto source, resolve official images to local workspace packages
+                // e.g., @dexto/image-local -> packages/image-local
+                const imagePkgName = baseImage.replace('@dexto/', '');
+                const imagePkgPath = path.resolve(originalCwd, 'packages', imagePkgName);
+                if (await fs.pathExists(imagePkgPath)) {
+                    resolvedBaseImage = imagePkgPath;
+                }
+            }
+            dependencies.push(resolvedBaseImage);
+        }
+        // Install dependencies (use pnpm in dexto source for workspace protocol support)
+        await installDependencies(projectPath, {
+            dependencies,
+            devDependencies,
+        }, isDextoSource ? 'pnpm' : undefined);
+        spinner.stop(chalk.green(`✓ Successfully created image: ${projectName}`));
+        console.log(`\n${chalk.cyan('Next steps:')}`);
+        console.log(`  ${chalk.gray('$')} cd ${projectName}`);
+        console.log(`  ${chalk.gray('$')} pnpm run build`);
+        console.log(`\n${chalk.gray('Add your custom providers to the convention-based folders:')}`);
+        console.log(`  ${chalk.gray('tools/')}       - Custom tool providers`);
+        console.log(`  ${chalk.gray('blob-store/')}  - Blob storage providers`);
+        console.log(`  ${chalk.gray('compression/')} - Compression strategies`);
+        console.log(`  ${chalk.gray('plugins/')}     - Plugin providers`);
+        console.log(`\n${chalk.gray('Learn more:')} https://docs.dexto.ai/docs/guides/images\n`);
+    }
+    catch (error) {
+        if (spinner) {
+            spinner.stop(chalk.red('✗ Failed to create image'));
+        }
+        throw error;
+    }
+    if (!projectPath) {
+        throw new Error('Failed to create project directory');
+    }
+    return projectPath;
+}

package/dist/cli/commands/helpers/formatters.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"formatters.d.ts","sourceRoot":"","sources":["../../../../src/cli/commands/helpers/formatters.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,KAAK,EAAE,eAAe,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAEpE;;GAEG;AACH,wBAAgB,iBAAiB,CAC7B,SAAS,EAAE,MAAM,EACjB,QAAQ,CAAC,EAAE,eAAe,EAC1B,SAAS,GAAE,OAAe,GAC3B,MAAM,CAqBR;AAED;;GAEG;AACH,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,eAAe,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,CA8DpF"}
+{"version":3,"file":"formatters.d.ts","sourceRoot":"","sources":["../../../../src/cli/commands/helpers/formatters.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,KAAK,EAAE,eAAe,EAAE,eAAe,EAAY,MAAM,aAAa,CAAC;AAG9E;;GAEG;AACH,wBAAgB,iBAAiB,CAC7B,SAAS,EAAE,MAAM,EACjB,QAAQ,CAAC,EAAE,eAAe,EAC1B,SAAS,GAAE,OAAe,GAC3B,MAAM,CAqBR;AAED;;GAEG;AACH,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,eAAe,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,CA8DpF"}

package/dist/cli/commands/helpers/formatters.js

@@ -5,6 +5,7 @@
  * Shared between interactive and non-interactive session commands.
  */
 import chalk from 'chalk';
+import { isAssistantMessage } from '@dexto/core';
 /**
  * Helper to format session information consistently
  */
@@ -17,9 +18,9 @@ export function formatSessionInfo(sessionId, metadata, isCurrent = false) {
         const activity = metadata.lastActivity && metadata.lastActivity > 0
             ? new Date(metadata.lastActivity).toLocaleString()
             : 'Never';
-        info += chalk.dim(` (${messages} messages, last: ${activity})`);
+        info += chalk.gray(` (${messages} messages, last: ${activity})`);
         if (isCurrent) {
-            info += chalk.yellow(' [ACTIVE]');
+            info += chalk.rgb(255, 165, 0)(' [ACTIVE]');
         }
     }
     return info;
@@ -31,7 +32,7 @@ export function formatHistoryMessage(message, index) {
     const timestamp = message.timestamp
         ? new Date(message.timestamp).toLocaleTimeString()
         : `#${index + 1}`;
-    let roleColor = chalk.dim;
+    let roleColor = chalk.gray;
     let displayLabel = message.role;
     switch (message.role) {
         case 'user':
@@ -43,11 +44,11 @@ export function formatHistoryMessage(message, index) {
             displayLabel = 'Assistant';
             break;
         case 'system':
-            roleColor = chalk.yellow;
+            roleColor = chalk.rgb(255, 165, 0);
             displayLabel = 'System';
             break;
         case 'tool':
-            roleColor = chalk.magenta;
+            roleColor = chalk.green;
             displayLabel = 'Tool';
             break;
     }
@@ -82,11 +83,11 @@ export function formatHistoryMessage(message, index) {
     }
     // Format tool calls if present
     let toolInfo = '';
-    if (message.toolCalls && message.toolCalls.length > 0) {
+    if (isAssistantMessage(message) && message.toolCalls && message.toolCalls.length > 0) {
         const toolNames = message.toolCalls
             .map((tc) => tc.function?.name || 'unknown')
             .join(', ');
-        toolInfo = chalk.dim(` [Tools: ${toolNames}]`);
+        toolInfo = chalk.gray(` [Tools: ${toolNames}]`);
     }
-    return `  ${chalk.dim(timestamp)} ${roleColor.bold(displayLabel)}: ${content}${toolInfo}`;
+    return `  ${chalk.gray(timestamp)} ${roleColor.bold(displayLabel)}: ${content}${toolInfo}`;
 }

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

@@ -1,4 +1,5 @@
-export { createDextoProject, createTsconfigJson, addDextoScriptsToPackageJson, postCreateDexto, } from './create-app.js';
+export { createDextoProject, type CreateAppOptions } from './create-app.js';
+export { createImage } from './create-image.js';
 export { getUserInputToInitDextoApp, initDexto, postInitDexto } from './init-app.js';
 export { handleSetupCommand, type CLISetupOptions, type CLISetupOptionsInput } from './setup.js';
 export { handleInstallCommand, type InstallCommandOptions } from './install.js';

package/dist/cli/commands/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/index.ts"],"names":[],"mappings":"AAGA,OAAO,EACH,kBAAkB,EAClB,kBAAkB,EAClB,4BAA4B,EAC5B,eAAe,GAClB,MAAM,iBAAiB,CAAC;AAEzB,OAAO,EAAE,0BAA0B,EAAE,SAAS,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC;AAErF,OAAO,EAAE,kBAAkB,EAAE,KAAK,eAAe,EAAE,KAAK,oBAAoB,EAAE,MAAM,YAAY,CAAC;AACjG,OAAO,EAAE,oBAAoB,EAAE,KAAK,qBAAqB,EAAE,MAAM,cAAc,CAAC;AAChF,OAAO,EAAE,sBAAsB,EAAE,KAAK,uBAAuB,EAAE,MAAM,gBAAgB,CAAC;AACtF,OAAO,EACH,uBAAuB,EACvB,KAAK,wBAAwB,EAC7B,KAAK,6BAA6B,GACrC,MAAM,kBAAkB,CAAC;AAC1B,OAAO,EAAE,kBAAkB,EAAE,KAAK,mBAAmB,EAAE,MAAM,YAAY,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/index.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,kBAAkB,EAAE,KAAK,gBAAgB,EAAE,MAAM,iBAAiB,CAAC;AAE5E,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAEhD,OAAO,EAAE,0BAA0B,EAAE,SAAS,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC;AAErF,OAAO,EAAE,kBAAkB,EAAE,KAAK,eAAe,EAAE,KAAK,oBAAoB,EAAE,MAAM,YAAY,CAAC;AACjG,OAAO,EAAE,oBAAoB,EAAE,KAAK,qBAAqB,EAAE,MAAM,cAAc,CAAC;AAChF,OAAO,EAAE,sBAAsB,EAAE,KAAK,uBAAuB,EAAE,MAAM,gBAAgB,CAAC;AACtF,OAAO,EACH,uBAAuB,EACvB,KAAK,wBAAwB,EAC7B,KAAK,6BAA6B,GACrC,MAAM,kBAAkB,CAAC;AAC1B,OAAO,EAAE,kBAAkB,EAAE,KAAK,mBAAmB,EAAE,MAAM,YAAY,CAAC"}

package/dist/cli/commands/index.js

@@ -1,6 +1,7 @@
 // packages/cli/src/cli/commands/index.ts
 // Project setup commands
-export { createDextoProject, createTsconfigJson, addDextoScriptsToPackageJson, postCreateDexto, } from './create-app.js';
+export { createDextoProject } from './create-app.js';
+export { createImage } from './create-image.js';
 export { getUserInputToInitDextoApp, initDexto, postInitDexto } from './init-app.js';
 export { handleSetupCommand } from './setup.js';
 export { handleInstallCommand } from './install.js';

package/dist/cli/commands/init-app.js

@@ -103,7 +103,7 @@ export async function initDexto(directory, createExampleFile = true, llmProvider
                 installError instanceof Error &&
                 /\bERR_PNPM_ADDING_TO_ROOT\b/.test(installError.message)) {
                 spinner.stop(chalk.red('Error: Cannot install in pnpm workspace root'));
-                p.note('You are initializing dexto in a pnpm workspace root. Go to a specific workspace package and run "pnpm add @dexto/core" there.', chalk.yellow('Workspace Error'));
+                p.note('You are initializing dexto in a pnpm workspace root. Go to a specific workspace package and run "pnpm add @dexto/core" there.', chalk.rgb(255, 165, 0)('Workspace Error'));
                 process.exit(1);
             }
             throw installError; // Re-throw other errors
@@ -135,7 +135,7 @@ export async function initDexto(directory, createExampleFile = true, llmProvider
         catch (configError) {
             spinner.stop(chalk.red('Failed to create agent config file'));
             logger.error(`Config creation error: ${configError}`);
-            throw new Error(`Failed to create default-agent.yml: ${configError instanceof Error ? configError.message : String(configError)}`);
+            throw new Error(`Failed to create coding-agent.yml: ${configError instanceof Error ? configError.message : String(configError)}`);
         }
         // update dexto config file based on llmProvider
         if (llmProvider) {
@@ -168,11 +168,11 @@ export async function postInitDexto(directory) {
     const nextSteps = [
         `1. Run the example: ${chalk.cyan(`node --loader ts-node/esm ${path.join(directory, 'dexto', 'dexto-example.ts')}`)}`,
         `2. Add/update your API key(s) in ${chalk.cyan('.env')}`,
-        `3. Check out the agent configuration file ${chalk.cyan(path.join(directory, 'dexto', 'agents', 'default-agent.yml'))}`,
-        `4. Try out different LLMs and MCP servers in the default-agent.yml file`,
+        `3. Check out the agent configuration file ${chalk.cyan(path.join(directory, 'dexto', 'agents', 'coding-agent.yml'))}`,
+        `4. Try out different LLMs and MCP servers in the coding-agent.yml file`,
         `5. Read more about Dexto: ${chalk.cyan('https://github.com/truffle-ai/dexto')}`,
     ].join('\n');
-    p.note(nextSteps, chalk.yellow('Next steps:'));
+    p.note(nextSteps, chalk.rgb(255, 165, 0)('Next steps:'));
 }
 /**
  * Creates the dexto directories (dexto, dexto/agents) in the given directory.
@@ -215,7 +215,7 @@ export async function createDextoConfigFile(directory) {
             throw new Error(`Template file not found at: ${templateConfigSrc}. This indicates a build issue - the template should be included in the package.`);
         }
         // Path to the destination config file
-        const destConfigPath = path.join(directory, 'default-agent.yml');
+        const destConfigPath = path.join(directory, 'coding-agent.yml');
         logger.debug(`Copying template to: ${destConfigPath}`);
         // Copy the config file from the Dexto package
         await fsExtra.copy(templateConfigSrc, destConfigPath);
@@ -235,7 +235,7 @@ export async function createDextoConfigFile(directory) {
 export async function createDextoExampleFile(directory) {
     // Extract the base directory from the given path (e.g., "src" from "src/dexto")
     const baseDir = path.dirname(directory);
-    const configPath = `./${path.posix.join(baseDir, 'dexto/agents/default-agent.yml')}`;
+    const configPath = `./${path.posix.join(baseDir, 'dexto/agents/coding-agent.yml')}`;
     const indexTsLines = [
         "import 'dotenv/config';",
         "import { DextoAgent, loadAgentConfig } from '@dexto/core';",

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

@@ -2,18 +2,15 @@ import { z } from 'zod';
 declare const InstallCommandSchema: z.ZodObject<{
     agents: z.ZodArray<z.ZodString, "many">;
     all: z.ZodDefault<z.ZodBoolean>;
-    injectPreferences: z.ZodDefault<z.ZodBoolean>;
     force: z.ZodDefault<z.ZodBoolean>;
 }, "strict", z.ZodTypeAny, {
     all: boolean;
     agents: string[];
     force: boolean;
-    injectPreferences: boolean;
 }, {
     agents: string[];
     all?: boolean | undefined;
     force?: boolean | undefined;
-    injectPreferences?: boolean | undefined;
 }>;
 export type InstallCommandOptions = z.output<typeof InstallCommandSchema>;
 export declare function handleInstallCommand(agents: string[], options: Partial<InstallCommandOptions>): Promise<void>;

package/dist/cli/commands/install.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"install.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/install.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAOxB,QAAA,MAAM,oBAAoB;;;;;;;;;;;;;;;EAOb,CAAC;AAEd,MAAM,MAAM,qBAAqB,GAAG,CAAC,CAAC,MAAM,CAAC,OAAO,oBAAoB,CAAC,CAAC;AAkL1E,wBAAsB,oBAAoB,CACtC,MAAM,EAAE,MAAM,EAAE,EAChB,OAAO,EAAE,OAAO,CAAC,qBAAqB,CAAC,GACxC,OAAO,CAAC,IAAI,CAAC,CAoNf"}
+{"version":3,"file":"install.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/install.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAQxB,QAAA,MAAM,oBAAoB;;;;;;;;;;;;EAMb,CAAC;AAEd,MAAM,MAAM,qBAAqB,GAAG,CAAC,CAAC,MAAM,CAAC,OAAO,oBAAoB,CAAC,CAAC;AAwK1E,wBAAsB,oBAAoB,CACtC,MAAM,EAAE,MAAM,EAAE,EAChB,OAAO,EAAE,OAAO,CAAC,qBAAqB,CAAC,GACxC,OAAO,CAAC,IAAI,CAAC,CAuKf"}

package/dist/cli/commands/install.js

@@ -3,15 +3,15 @@ import { existsSync, statSync } from 'fs';
 import path from 'path';
 import { z } from 'zod';
 import * as p from '@clack/prompts';
-import { getDextoGlobalPath } from '@dexto/agent-management';
-import { getAgentRegistry } from '@dexto/agent-management';
+import { getDextoGlobalPath, loadBundledRegistryAgents } from '@dexto/agent-management';
+import { textOrExit } from '../utils/prompt-helpers.js';
+import { installBundledAgent, installCustomAgent } from '../../utils/agent-helpers.js';
 import { capture } from '../../analytics/index.js';
 // Zod schema for install command validation
 const InstallCommandSchema = z
     .object({
     agents: z.array(z.string().min(1, 'Agent name cannot be empty')),
     all: z.boolean().default(false),
-    injectPreferences: z.boolean().default(true),
     force: z.boolean().default(false),
 })
     .strict();
@@ -54,7 +54,7 @@ function extractAgentNameFromPath(filePath) {
  */
 async function promptForMetadata(suggestedName) {
     p.intro('📝 Custom Agent Installation');
-    const agentName = (await p.text({
+    const agentName = await textOrExit({
         message: 'Agent name:',
         placeholder: suggestedName,
         defaultValue: suggestedName,
@@ -67,12 +67,8 @@ async function promptForMetadata(suggestedName) {
             }
             return undefined;
         },
-    }));
-    if (p.isCancel(agentName)) {
-        p.cancel('Installation cancelled');
-        process.exit(0);
-    }
-    const description = (await p.text({
+    }, 'Installation cancelled');
+    const description = await textOrExit({
         message: 'Description:',
         placeholder: 'A custom agent for...',
         validate: (value) => {
@@ -81,12 +77,8 @@ async function promptForMetadata(suggestedName) {
             }
             return undefined;
         },
-    }));
-    if (p.isCancel(description)) {
-        p.cancel('Installation cancelled');
-        process.exit(0);
-    }
-    const author = (await p.text({
+    }, 'Installation cancelled');
+    const author = await textOrExit({
         message: 'Author:',
         placeholder: 'Your Name',
         validate: (value) => {
@@ -95,20 +87,12 @@ async function promptForMetadata(suggestedName) {
             }
             return undefined;
         },
-    }));
-    if (p.isCancel(author)) {
-        p.cancel('Installation cancelled');
-        process.exit(0);
-    }
-    const tagsInput = (await p.text({
+    }, 'Installation cancelled');
+    const tagsInput = await textOrExit({
         message: 'Tags (comma-separated):',
         placeholder: 'custom, coding, productivity',
         defaultValue: 'custom',
-    }));
-    if (p.isCancel(tagsInput)) {
-        p.cancel('Installation cancelled');
-        process.exit(0);
-    }
+    }, 'Installation cancelled');
     const tags = tagsInput
         .split(',')
         .map((tag) => tag.trim())
@@ -121,14 +105,13 @@ async function promptForMetadata(suggestedName) {
  * Validate install command arguments with registry-aware validation
  */
 function validateInstallCommand(agents, options) {
-    const registry = getAgentRegistry();
     // Basic structure validation
     const validated = InstallCommandSchema.parse({
         ...options,
         agents,
     });
     // Business logic validation
-    const availableAgents = registry.getAvailableAgents();
+    const availableAgents = loadBundledRegistryAgents();
     if (!validated.all && validated.agents.length === 0) {
         throw new Error(`No agents specified. Use agent names or --all flag.  Available agents: ${Object.keys(availableAgents).join(', ')}`);
     }
@@ -137,7 +120,7 @@ function validateInstallCommand(agents, options) {
         const filePaths = validated.agents.filter(isFilePath);
         const registryNames = validated.agents.filter((agent) => !isFilePath(agent));
         // Validate registry names exist in registry
-        const invalidAgents = registryNames.filter((agent) => !registry.hasAgent(agent));
+        const invalidAgents = registryNames.filter((agent) => !(agent in availableAgents));
         if (invalidAgents.length > 0) {
             throw new Error(`Unknown agents: ${invalidAgents.join(', ')}. ` +
                 `Available agents: ${Object.keys(availableAgents).join(', ')}`);
@@ -156,12 +139,12 @@ function validateInstallCommand(agents, options) {
 export async function handleInstallCommand(agents, options) {
     // Validate command with Zod
     const validated = validateInstallCommand(agents, options);
-    const registry = getAgentRegistry();
     // Determine which agents to install
     let agentsToInstall;
     if (validated.all) {
         // --all flag only works with registry agents, not file paths
-        agentsToInstall = Object.keys(registry.getAvailableAgents());
+        const availableAgents = loadBundledRegistryAgents();
+        agentsToInstall = Object.keys(availableAgents);
         console.log(`📋 Installing all ${agentsToInstall.length} available agents...`);
     }
     else {
@@ -191,35 +174,6 @@ export async function handleInstallCommand(agents, options) {
                     : extractAgentNameFromPath(resolvedPath);
                 // Prompt for metadata
                 const metadata = await promptForMetadata(suggestedName);
-                // Prompt for main field if installing from directory
-                let main;
-                if (isDirectory) {
-                    const mainInput = await p.text({
-                        message: 'Main config file:',
-                        placeholder: 'agent.yml',
-                        defaultValue: 'agent.yml',
-                        validate: (value) => {
-                            if (!value || value.trim().length === 0) {
-                                return 'Main config file is required';
-                            }
-                            // Validate it's a YAML file
-                            if (!value.endsWith('.yml') && !value.endsWith('.yaml')) {
-                                return 'Main file must be a .yml or .yaml file';
-                            }
-                            // Validate that main file exists in source directory
-                            const mainPath = path.join(resolvedPath, value);
-                            if (!existsSync(mainPath)) {
-                                return `File not found: ${value}`;
-                            }
-                            return undefined;
-                        },
-                    });
-                    if (p.isCancel(mainInput)) {
-                        p.cancel('Installation cancelled');
-                        process.exit(0);
-                    }
-                    main = mainInput;
-                }
                 // Check if already installed (unless --force)
                 const globalAgentsDir = getDextoGlobalPath('agents');
                 const installedPath = path.join(globalAgentsDir, metadata.agentName);
@@ -231,17 +185,16 @@ export async function handleInstallCommand(agents, options) {
                         status: 'skipped',
                         reason: 'already_installed',
                         force: validated.force,
-                        injectPreferences: validated.injectPreferences,
                     });
                     continue;
                 }
                 // Install custom agent
-                await registry.installCustomAgentFromPath(metadata.agentName, resolvedPath, {
+                await installCustomAgent(metadata.agentName, resolvedPath, {
+                    name: metadata.agentName,
                     description: metadata.description,
                     author: metadata.author,
                     tags: metadata.tags,
-                    ...(main ? { main } : {}),
-                }, validated.injectPreferences);
+                });
                 successCount++;
                 console.log(`✅ ${metadata.agentName} installed successfully`);
                 installed.push(metadata.agentName);
@@ -250,7 +203,6 @@ export async function handleInstallCommand(agents, options) {
                     agent: metadata.agentName,
                     status: 'installed',
                     force: validated.force,
-                    injectPreferences: validated.injectPreferences,
                 });
             }
             else {
@@ -267,11 +219,10 @@ export async function handleInstallCommand(agents, options) {
                         status: 'skipped',
                         reason: 'already_installed',
                         force: validated.force,
-                        injectPreferences: validated.injectPreferences,
                     });
                     continue;
                 }
-                await registry.installAgent(agentInput, validated.injectPreferences);
+                await installBundledAgent(agentInput);
                 successCount++;
                 console.log(`✅ ${agentInput} installed successfully`);
                 installed.push(agentInput);
@@ -279,7 +230,6 @@ export async function handleInstallCommand(agents, options) {
                     agent: agentInput,
                     status: 'installed',
                     force: validated.force,
-                    injectPreferences: validated.injectPreferences,
                 });
             }
         }
@@ -296,7 +246,6 @@ export async function handleInstallCommand(agents, options) {
                 status: 'failed',
                 error_message: error instanceof Error ? error.message : String(error),
                 force: validated.force,
-                injectPreferences: validated.injectPreferences,
             });
         }
     }

package/dist/cli/commands/interactive-commands/command-parser.d.ts

@@ -1,10 +1,26 @@
 import type { DextoAgent } from '@dexto/core';
+import type { StyledOutput, SendMessageMarker } from '../../ink-cli/services/CommandService.js';
 export interface CommandResult {
     type: 'command' | 'prompt';
     command?: string;
     args?: string[];
     rawInput: string;
 }
+/**
+ * Command handler return type:
+ * - boolean: Command handled (true) or not found (false)
+ * - string: Output text to display
+ * - StyledOutput: Styled output with structured data for rich rendering
+ * - SendMessageMarker: Send text through normal streaming flow (for prompt commands)
+ */
+export type CommandHandlerResult = boolean | string | StyledOutput | SendMessageMarker;
+/**
+ * Context passed to command handlers
+ */
+export interface CommandContext {
+    /** Current session ID, or null if no active session */
+    sessionId: string | null;
+}
 export interface CommandDefinition {
     name: string;
     description: string;
@@ -12,21 +28,8 @@ export interface CommandDefinition {
     category?: string;
     aliases?: string[];
     subcommands?: CommandDefinition[];
-    handler: (args: string[], agent: DextoAgent) => Promise<boolean | string>;
+    handler: (args: string[], agent: DextoAgent, ctx: CommandContext) => Promise<CommandHandlerResult>;
 }
-/**
- * Helper for command handlers to get the current session ID from CLI context.
- * This is set by executeCommand() when invoked from InkCLI.
- *
- * Maintains separation of concerns:
- * - InkCLI state manages current sessionId
- * - executeCommand() stores it temporarily on agent for command access
- * - Commands use this helper instead of removed agent.getCurrentSessionId()
- *
- * @param agent - DextoAgent instance with __cliSessionId set by executeCommand
- * @returns Current session ID from CLI context, or null if not available
- */
-export declare function getCLISessionId(agent: DextoAgent): string | null;
 /**
  * Parses user input to determine if it's a slash command or a regular prompt
  */

package/dist/cli/commands/interactive-commands/command-parser.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"command-parser.d.ts","sourceRoot":"","sources":["../../../../src/cli/commands/interactive-commands/command-parser.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAE9C,MAAM,WAAW,aAAa;IAC1B,IAAI,EAAE,SAAS,GAAG,QAAQ,CAAC;IAC3B,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;IAChB,QAAQ,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,iBAAiB;IAC9B,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;IACnB,WAAW,CAAC,EAAE,iBAAiB,EAAE,CAAC;IAClC,OAAO,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,KAAK,EAAE,UAAU,KAAK,OAAO,CAAC,OAAO,GAAG,MAAM,CAAC,CAAC;CAC7E;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,eAAe,CAAC,KAAK,EAAE,UAAU,GAAG,MAAM,GAAG,IAAI,CAEhE;AA4CD;;GAEG;AACH,wBAAgB,UAAU,CAAC,KAAK,EAAE,MAAM,GAAG,aAAa,CAsBvD;AAED;;GAEG;AACH,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,iBAAiB,EAAE,GAAG,MAAM,EAAE,CAoB9F;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,GAAG,EAAE,iBAAiB,EAAE,QAAQ,GAAE,OAAe,GAAG,MAAM,CAmB3F;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,QAAQ,EAAE,iBAAiB,EAAE,GAAG,IAAI,CAuDtE"}
+{"version":3,"file":"command-parser.d.ts","sourceRoot":"","sources":["../../../../src/cli/commands/interactive-commands/command-parser.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAC9C,OAAO,KAAK,EAAE,YAAY,EAAE,iBAAiB,EAAE,MAAM,0CAA0C,CAAC;AAEhG,MAAM,WAAW,aAAa;IAC1B,IAAI,EAAE,SAAS,GAAG,QAAQ,CAAC;IAC3B,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;IAChB,QAAQ,EAAE,MAAM,CAAC;CACpB;AAED;;;;;;GAMG;AACH,MAAM,MAAM,oBAAoB,GAAG,OAAO,GAAG,MAAM,GAAG,YAAY,GAAG,iBAAiB,CAAC;AAEvF;;GAEG;AACH,MAAM,WAAW,cAAc;IAC3B,uDAAuD;IACvD,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;CAC5B;AAED,MAAM,WAAW,iBAAiB;IAC9B,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;IACnB,WAAW,CAAC,EAAE,iBAAiB,EAAE,CAAC;IAClC,OAAO,EAAE,CACL,IAAI,EAAE,MAAM,EAAE,EACd,KAAK,EAAE,UAAU,EACjB,GAAG,EAAE,cAAc,KAClB,OAAO,CAAC,oBAAoB,CAAC,CAAC;CACtC;AA4CD;;GAEG;AACH,wBAAgB,UAAU,CAAC,KAAK,EAAE,MAAM,GAAG,aAAa,CAsBvD;AAED;;GAEG;AACH,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,iBAAiB,EAAE,GAAG,MAAM,EAAE,CAoB9F;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,GAAG,EAAE,iBAAiB,EAAE,QAAQ,GAAE,OAAe,GAAG,MAAM,CAmB3F;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,QAAQ,EAAE,iBAAiB,EAAE,GAAG,IAAI,CAuDtE"}