dexto 1.4.0 → 1.5.1

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.js

@@ -18,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;
@@ -32,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':
@@ -44,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;
     }
@@ -87,7 +87,7 @@ export function formatHistoryMessage(message, index) {
         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;AAgL1E,wBAAsB,oBAAoB,CACtC,MAAM,EAAE,MAAM,EAAE,EAChB,OAAO,EAAE,OAAO,CAAC,qBAAqB,CAAC,GACxC,OAAO,CAAC,IAAI,CAAC,CAqLf"}
+{"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

@@ -4,6 +4,7 @@ import path from 'path';
 import { z } from 'zod';
 import * as p from '@clack/prompts';
 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
@@ -11,7 +12,6 @@ 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())
@@ -201,7 +185,6 @@ export async function handleInstallCommand(agents, options) {
                         status: 'skipped',
                         reason: 'already_installed',
                         force: validated.force,
-                        injectPreferences: validated.injectPreferences,
                     });
                     continue;
                 }
@@ -211,8 +194,6 @@ export async function handleInstallCommand(agents, options) {
                     description: metadata.description,
                     author: metadata.author,
                     tags: metadata.tags,
-                }, {
-                    injectPreferences: validated.injectPreferences,
                 });
                 successCount++;
                 console.log(`✅ ${metadata.agentName} installed successfully`);
@@ -222,7 +203,6 @@ export async function handleInstallCommand(agents, options) {
                     agent: metadata.agentName,
                     status: 'installed',
                     force: validated.force,
-                    injectPreferences: validated.injectPreferences,
                 });
             }
             else {
@@ -239,13 +219,10 @@ export async function handleInstallCommand(agents, options) {
                         status: 'skipped',
                         reason: 'already_installed',
                         force: validated.force,
-                        injectPreferences: validated.injectPreferences,
                     });
                     continue;
                 }
-                await installBundledAgent(agentInput, {
-                    injectPreferences: validated.injectPreferences,
-                });
+                await installBundledAgent(agentInput);
                 successCount++;
                 console.log(`✅ ${agentInput} installed successfully`);
                 installed.push(agentInput);
@@ -253,7 +230,6 @@ export async function handleInstallCommand(agents, options) {
                     agent: agentInput,
                     status: 'installed',
                     force: validated.force,
-                    injectPreferences: validated.injectPreferences,
                 });
             }
         }
@@ -270,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

@@ -31,7 +31,7 @@ export interface CommandDefinition {
     handler: (args: string[], agent: DextoAgent, ctx: CommandContext) => Promise<CommandHandlerResult>;
 }
 /**
- * Parses user input to determine if it's a slash command or a regular prompt
+ * Parses user input to determine if it's a slash command, shell command, or regular prompt
  */
 export declare function parseInput(input: string): CommandResult;
 /**

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;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"}
+{"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,CAiCvD;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"}

package/dist/cli/commands/interactive-commands/command-parser.js

@@ -41,10 +41,20 @@ function parseQuotedArguments(input) {
     return args.filter((arg) => arg.length > 0);
 }
 /**
- * Parses user input to determine if it's a slash command or a regular prompt
+ * Parses user input to determine if it's a slash command, shell command, or regular prompt
  */
 export function parseInput(input) {
     const trimmed = input.trim();
+    // Check if it's a shell command (! prefix)
+    if (trimmed.startsWith('!')) {
+        const shellCommand = trimmed.slice(1).trim();
+        return {
+            type: 'command',
+            command: 'shell',
+            args: [shellCommand],
+            rawInput: trimmed,
+        };
+    }
     // Check if it's a slash command
     if (trimmed.startsWith('/')) {
         const args = parseQuotedArguments(trimmed.slice(1));
@@ -90,12 +100,12 @@ export function getCommandSuggestions(partial, commands) {
 export function formatCommandHelp(cmd, detailed = false) {
     let help = chalk.cyan(`/${cmd.name}`) + ' - ' + cmd.description;
     if (detailed) {
-        help += '\n' + chalk.dim(`Usage: ${cmd.usage}`);
+        help += '\n' + chalk.gray(`Usage: ${cmd.usage}`);
         if (cmd.aliases && cmd.aliases.length > 0) {
-            help += '\n' + chalk.dim(`Aliases: ${cmd.aliases.map((a) => `/${a}`).join(', ')}`);
+            help += '\n' + chalk.gray(`Aliases: ${cmd.aliases.map((a) => `/${a}`).join(', ')}`);
         }
         if (cmd.subcommands && cmd.subcommands.length > 0) {
-            help += '\n' + chalk.dim('Subcommands:');
+            help += '\n' + chalk.gray('Subcommands:');
             for (const sub of cmd.subcommands) {
                 help += '\n  ' + chalk.cyan(`/${cmd.name} ${sub.name}`) + ' - ' + sub.description;
             }
@@ -135,7 +145,7 @@ export function displayAllCommands(commands) {
     for (const category of categoryOrder) {
         const cmds = categories[category];
         if (cmds && cmds.length > 0) {
-            console.log(chalk.bold.yellow(`${category}:`));
+            console.log(chalk.bold.rgb(255, 165, 0)(`${category}:`));
             for (const cmd of cmds) {
                 console.log('  ' + formatCommandHelp(cmd));
             }
@@ -145,13 +155,13 @@ export function displayAllCommands(commands) {
     // Display any uncategorized commands (fallback)
     for (const [category, cmds] of Object.entries(categories)) {
         if (!categoryOrder.includes(category) && cmds.length > 0) {
-            console.log(chalk.bold.yellow(`${category}:`));
+            console.log(chalk.bold.rgb(255, 165, 0)(`${category}:`));
             for (const cmd of cmds) {
                 console.log('  ' + formatCommandHelp(cmd));
             }
             console.log();
         }
     }
-    console.log(chalk.dim('💡 Tip: Use /help <command> for detailed help on any command'));
-    console.log(chalk.dim('💡 Tip: Type your message normally (without /) to chat with the AI\n'));
+    console.log(chalk.gray('💡 Tip: Use /help <command> for detailed help on any command'));
+    console.log(chalk.gray('💡 Tip: Type your message normally (without /) to chat with the AI\n'));
 }

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,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"}
+{"version":3,"file":"general-commands.d.ts","sourceRoot":"","sources":["../../../../src/cli/commands/interactive-commands/general-commands.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAKH,OAAO,KAAK,EAAE,iBAAiB,EAAwC,MAAM,qBAAqB,CAAC;AAiDnG;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,cAAc,EAAE,MAAM,iBAAiB,EAAE,GAAG,iBAAiB,CAgC9F;AAED;;;GAGG;AACH,eAAO,MAAM,eAAe,EAAE,iBAAiB,EAyO9C,CAAC"}