@runflow-ai/cli 0.2.4 → 0.2.6

package/dist/commands/agents/agents.command.js

@@ -1,35 +1,74 @@
 "use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
 var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
     var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
     if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
     else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
     return c > 3 && r && Object.defineProperty(target, key, r), r;
 };
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
 var __metadata = (this && this.__metadata) || function (k, v) {
     if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
 };
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.AgentsCommand = void 0;
 const nest_commander_1 = require("nest-commander");
-const fs = require("fs");
-const path = require("path");
+const fs = __importStar(require("fs"));
+const path = __importStar(require("path"));
 const child_process_1 = require("child_process");
 const config_1 = require("../../common/config");
 const ui_1 = require("../../common/ui");
 const inquirer = require("inquirer");
 const logger_1 = require("../../common/logger");
 const api_client_1 = require("../../common/api-client");
+const chalk_1 = __importDefault(require("chalk"));
+const validator_1 = require("../../common/validator");
 const SENSITIVE_FILES = ['.env'];
-const IGNORE_DIRS = ['node_modules', 'dist', '.git'];
-const IGNORE_FILES = ['.DS_Store', '*.log', '*.lock', 'package-lock.json', '.runflow'];
+const IGNORE_DIRS = ['node_modules', 'dist', '.git', '.runflow'];
+const IGNORE_FILES = ['.DS_Store', 'package-lock.json'];
+const IGNORE_PATTERNS = [/\.log$/, /\.lock$/, /\.tmp$/];
 async function showAgentActionMenu(agent) {
     const actions = [
-        { name: '📥 Clone repository (download)', value: 'clone' },
-        { name: '🔄 Pull latest changes', value: 'pull' },
-        { name: '🚀 Duplicate agent on server', value: 'duplicate' },
-        { name: '🚢 Deploy agent', value: 'deploy' },
-        { name: '🗑️ Delete agent', value: 'delete' },
-        { name: '❌ Cancel', value: 'cancel' }
+        { name: 'Clone repository (download)', value: 'clone' },
+        { name: 'Pull latest changes', value: 'pull' },
+        { name: 'Duplicate agent on server', value: 'duplicate' },
+        { name: 'Deploy agent', value: 'deploy' },
+        { name: 'Delete agent', value: 'delete' },
+        { name: 'Cancel', value: 'cancel' }
     ];
     const { action } = await inquirer.prompt([
         {
@@ -42,55 +81,75 @@ async function showAgentActionMenu(agent) {
     return action === 'cancel' ? null : action;
 }
 function sanitizeFileName(name) {
-    return name.replace(/[<>:"/\\|?*]/g, '-').replace(/\s+/g, '-').toLowerCase();
+    const sanitized = name
+        .replace(/[<>:"/\\|?*]/g, '-')
+        .replace(/\s+/g, '-')
+        .replace(/-+/g, '-')
+        .replace(/^-|-$/g, '')
+        .toLowerCase();
+    return sanitized || 'agent';
 }
 async function detectAgentFromCurrentDirectory() {
     try {
         const currentDir = process.cwd();
-        (0, logger_1.logVerbose)(`Checking for .runflow file in: ${currentDir}`);
-        const runflowFile = path.join(currentDir, '.runflow');
+        (0, logger_1.logVerbose)(`Checking for .runflow/rf.json in: ${currentDir}`);
+        const runflowDir = path.join(currentDir, '.runflow');
+        const runflowFile = path.join(runflowDir, 'rf.json');
         if (fs.existsSync(runflowFile)) {
-            (0, logger_1.logVerbose)(`Found .runflow file at: ${runflowFile}`);
+            (0, logger_1.logVerbose)(`Found .runflow/rf.json at: ${runflowFile}`);
             const content = fs.readFileSync(runflowFile, 'utf8');
-            (0, logger_1.logVerbose)(`Raw .runflow content: ${content}`);
+            (0, logger_1.logVerbose)(`Raw rf.json content: ${content}`);
             const config = JSON.parse(content);
-            (0, logger_1.logVerbose)(`Parsed .runflow config: ${JSON.stringify(config)}`);
+            (0, logger_1.logVerbose)(`Parsed rf.json config: ${JSON.stringify(config)}`);
             const agentId = config.agentId || null;
             if (agentId) {
-                (0, logger_1.logVerbose)(`Detected agent ${agentId} from .runflow file`);
+                (0, logger_1.logVerbose)(`Detected agent ${agentId} from .runflow/rf.json`);
             }
             else {
-                (0, logger_1.logVerbose)(`No agentId found in .runflow file`);
+                (0, logger_1.logVerbose)(`No agentId found in .runflow/rf.json`);
             }
             return agentId;
         }
-        (0, logger_1.logVerbose)(`No .runflow file found in current directory: ${currentDir}`);
+        const oldRunflowFile = path.join(currentDir, '.runflow');
+        if (fs.existsSync(oldRunflowFile) && fs.statSync(oldRunflowFile).isFile()) {
+            (0, logger_1.logVerbose)(`Found legacy .runflow file at: ${oldRunflowFile}`);
+            const content = fs.readFileSync(oldRunflowFile, 'utf8');
+            const config = JSON.parse(content);
+            const agentId = config.agentId || null;
+            if (agentId) {
+                (0, logger_1.logVerbose)(`Detected agent ${agentId} from legacy .runflow file`);
+            }
+            return agentId;
+        }
+        (0, logger_1.logVerbose)(`No .runflow/rf.json found in current directory: ${currentDir}`);
         return null;
     }
     catch (error) {
-        (0, logger_1.logVerbose)(`Error reading .runflow file: ${error}`);
+        (0, logger_1.logVerbose)(`Error reading .runflow/rf.json: ${error}`);
         return null;
     }
 }
 function dirToTree(dir, base = dir) {
     (0, logger_1.logVerbose)(`📁 Scanning directory: ${dir}`);
     const result = fs.readdirSync(dir, { withFileTypes: true }).reduce((acc, entry) => {
+        const fullPath = path.join(dir, entry.name);
+        const relPath = path.relative(base, fullPath).replace(/\\/g, '/');
         if (IGNORE_DIRS.includes(entry.name) ||
             SENSITIVE_FILES.includes(entry.name) ||
-            IGNORE_FILES.some((pattern) => entry.name.includes(pattern.replace('*', '')))) {
-            (0, logger_1.logVerbose)(`⏭️  Ignoring: ${entry.name} (matches ignore rules)`);
+            IGNORE_FILES.includes(entry.name) ||
+            IGNORE_PATTERNS.some(pattern => pattern.test(entry.name))) {
+            return acc;
+        }
+        if (entry.name === '.runflow') {
             return acc;
         }
-        const fullPath = path.join(dir, entry.name);
         if (entry.isDirectory()) {
-            (0, logger_1.logVerbose)(`📂 Processing directory: ${entry.name}`);
             acc.push(...dirToTree(fullPath, base));
         }
         else if (entry.isFile()) {
             const relPath = path.relative(base, fullPath).replace(/\\/g, '/');
             try {
                 const content = fs.readFileSync(fullPath, 'utf8');
-                (0, logger_1.logVerbose)(`📄 Adding file: ${relPath} (${content.length} chars)`);
                 acc.push({ path: relPath, mode: '100644', type: 'blob', content });
             }
             catch (error) {
@@ -104,14 +163,23 @@ function dirToTree(dir, base = dir) {
 }
 let AgentsCommand = class AgentsCommand extends nest_commander_1.CommandRunner {
     async performDeploy(targetAgentId, apiClient, data) {
+        const validation = (0, validator_1.validateForDeploy)();
+        if (!validation.isValid) {
+            console.error(chalk_1.default.red('\n❌ Deploy validation failed!'));
+            validation.errors.forEach(error => {
+                console.error(chalk_1.default.red(`   • ${error}`));
+            });
+            console.error(chalk_1.default.gray('\n📚 Documentation: https://docs.runflow.ai\n'));
+            return;
+        }
         (0, logger_1.logVerbose)(`Deploying agent ${targetAgentId} with local changes...`);
         (0, logger_1.logVerbose)(`Current directory: ${process.cwd()}`);
         const baseRepo = path.basename(process.cwd());
         const { config } = (0, config_1.getValidatedConfig)();
         const repo = `${config.tenantId}-${baseRepo}`;
         const tree = dirToTree(process.cwd()).filter((item) => Boolean(item.path));
-        const deletedFiles = this.getDeletedFiles();
-        const fullTree = [...tree, ...deletedFiles];
+        const deletedFilesFromGit = this.getDeletedFiles();
+        const fullTree = [...tree, ...deletedFilesFromGit];
         const defaultPayload = {
             repo,
             message: 'deploy with local changes',
@@ -121,32 +189,49 @@ let AgentsCommand = class AgentsCommand extends nest_commander_1.CommandRunner {
         const payload = data
             ? JSON.parse(data)
             : defaultPayload;
-        (0, logger_1.logVerbose)(`📦 Deploy Summary:`);
-        (0, logger_1.logVerbose)(`   Files to send: ${payload.tree.length}`);
-        (0, logger_1.logVerbose)(`   Payload size: ${JSON.stringify(payload).length} bytes`);
-        (0, logger_1.logVerbose)(`   Repository: ${payload.repo}`);
-        (0, logger_1.logVerbose)(`   Branch: ${payload.branch}`);
-        if (payload.tree.length > 0) {
-            const normalFiles = payload.tree.filter(item => !item.deleted);
-            const deletedFiles = payload.tree.filter(item => item.deleted);
-            if (normalFiles.length > 0) {
-                (0, logger_1.logVerbose)(`📋 Files being deployed:`);
-                normalFiles.forEach((item, index) => {
-                    (0, logger_1.logVerbose)(`   ${index + 1}. ${item.path} (${item.content?.length || 0} chars)`);
-                });
-            }
-            if (deletedFiles.length > 0) {
-                (0, logger_1.logVerbose)(`🗑️ Files being deleted:`);
-                deletedFiles.forEach((item, index) => {
-                    (0, logger_1.logVerbose)(`   ${index + 1}. ${item.path} (deleted)`);
-                });
+        const normalFiles = payload.tree.filter(item => !item.deleted);
+        const deletedFiles = payload.tree.filter(item => item.deleted);
+        console.log(chalk_1.default.cyan.bold('\n📦 Deploy Preview:'));
+        console.log(chalk_1.default.gray(`Repository: ${payload.repo}`));
+        console.log(chalk_1.default.gray(`Files: ${normalFiles.length} to deploy, ${deletedFiles.length} to delete`));
+        if (normalFiles.length > 0) {
+            console.log(chalk_1.default.green('\n📄 Files to deploy:'));
+            normalFiles.slice(0, 10).forEach((item, index) => {
+                const size = item.content?.length || 0;
+                const sizeStr = size > 1024 ? `${Math.round(size / 1024)}KB` : `${size}B`;
+                console.log(chalk_1.default.gray(`  ${index + 1}.`), chalk_1.default.white(item.path), chalk_1.default.gray(`(${sizeStr})`));
+            });
+            if (normalFiles.length > 10) {
+                console.log(chalk_1.default.gray(`  ... and ${normalFiles.length - 10} more files`));
             }
         }
-        else {
-            (0, logger_1.logVerbose)(`⚠️  WARNING: No files to deploy!`);
+        if (deletedFiles.length > 0) {
+            console.log(chalk_1.default.red('\n🗑️ Files to delete:'));
+            deletedFiles.forEach((item, index) => {
+                console.log(chalk_1.default.gray(`  ${index + 1}.`), chalk_1.default.white(item.path));
+            });
+        }
+        if (payload.tree.length === 0) {
+            console.log(chalk_1.default.yellow('\n⚠️ No files to deploy!'));
+            return;
         }
+        const { confirm } = await inquirer.prompt([
+            {
+                type: 'confirm',
+                name: 'confirm',
+                message: `Deploy ${normalFiles.length} files to agent ${targetAgentId}?`,
+                default: true
+            }
+        ]);
+        if (!confirm) {
+            console.log(chalk_1.default.yellow('Deploy cancelled'));
+            return;
+        }
+        console.log(chalk_1.default.blue('\n🚀 Deploying...'));
         const res = await apiClient.patch(`/agents/${targetAgentId}/deploy`, payload);
-        (0, logger_1.logSuccess)(`Deployed agent with local changes`);
+        console.log(chalk_1.default.green.bold('\n✅ Deploy Successful!'));
+        console.log(chalk_1.default.gray(`📦 ${normalFiles.length} files deployed`));
+        console.log(chalk_1.default.gray(`🕐 ${new Date().toLocaleTimeString()}`));
         try {
             (0, logger_1.logVerbose)(`Creating commit for deployed changes...`);
             const currentDir = process.cwd();
@@ -202,13 +287,63 @@ let AgentsCommand = class AgentsCommand extends nest_commander_1.CommandRunner {
         const agentName = sanitizeFileName(agent.name || agent.id);
         switch (action) {
             case 'clone': {
-                (0, logger_1.logVerbose)(`Cloning agent ${agentId} repository...`);
+                try {
+                    (0, child_process_1.execSync)('git --version', { stdio: 'pipe', timeout: 3000 });
+                }
+                catch (error) {
+                    console.log(chalk_1.default.red('Git is required for cloning agents'));
+                    console.log(chalk_1.default.gray('Install Git: https://git-scm.com\n'));
+                    return;
+                }
+                console.log(chalk_1.default.blue('Cloning agent repository...'));
                 const res = await apiClient.get(`/agents/${agentId}/clone`);
                 const tree = res.data;
                 (0, logger_1.logVerbose)(`Received ${tree.length} items from API`);
                 const gitFiles = tree.filter(item => item.path.startsWith('.git'));
                 (0, logger_1.logVerbose)(`Found ${gitFiles.length} .git files: ${gitFiles.map(f => f.path).join(', ')}`);
-                const dir = agentName;
+                let dir = agentName;
+                if (fs.existsSync(dir)) {
+                    console.log(chalk_1.default.yellow(`\n⚠ Directory "${dir}" already exists`));
+                    const { action } = await inquirer.prompt([
+                        {
+                            type: 'list',
+                            name: 'action',
+                            message: 'What would you like to do?',
+                            choices: [
+                                { name: 'Overwrite existing directory', value: 'overwrite' },
+                                { name: 'Clone with different name', value: 'rename' },
+                                { name: 'Cancel', value: 'cancel' }
+                            ]
+                        }
+                    ]);
+                    if (action === 'cancel') {
+                        console.log(chalk_1.default.gray('Clone cancelled'));
+                        return;
+                    }
+                    if (action === 'rename') {
+                        const { newName } = await inquirer.prompt([
+                            {
+                                type: 'input',
+                                name: 'newName',
+                                message: 'Enter new directory name:',
+                                default: `${agentName}-copy`,
+                                validate: (input) => {
+                                    if (!input.trim())
+                                        return 'Directory name cannot be empty';
+                                    if (fs.existsSync(input.trim()))
+                                        return `Directory "${input.trim()}" already exists`;
+                                    return true;
+                                }
+                            }
+                        ]);
+                        dir = newName.trim();
+                        console.log(chalk_1.default.blue(`Using directory name: ${dir}`));
+                    }
+                    else if (action === 'overwrite') {
+                        fs.rmSync(dir, { recursive: true, force: true });
+                        console.log(chalk_1.default.blue('Removed existing directory'));
+                    }
+                }
                 fs.mkdirSync(dir, { recursive: true });
                 const gitRefFiles = {};
                 const regularFiles = tree.filter(item => {
@@ -261,20 +396,27 @@ let AgentsCommand = class AgentsCommand extends nest_commander_1.CommandRunner {
                 catch (error) {
                     (0, logger_1.logVerbose)(`❌ Error initializing git: ${error}`);
                 }
-                const runflowPath = path.join(dir, '.runflow');
+                const runflowPath = path.join(dir, '.runflow', 'rf.json');
                 if (fs.existsSync(runflowPath)) {
-                    (0, logger_1.logVerbose)(`✅ .runflow file provided by API for deploy operations`);
+                    (0, logger_1.logVerbose)(`✅ .runflow/rf.json provided by API for deploy operations`);
                 }
                 else {
-                    (0, logger_1.logVerbose)(`⚠️ No .runflow file found - deploy may not work`);
+                    (0, logger_1.logVerbose)(`⚠️ No .runflow/rf.json found - deploy may not work`);
                 }
-                (0, logger_1.logSuccess)(`Repository cloned to ${dir}/`);
+                console.log(chalk_1.default.green.bold(`\n✓ Repository cloned to ${dir}/`));
+                console.log(chalk_1.default.cyan.bold('\nNext Steps:'));
+                console.log(chalk_1.default.gray('1.'), chalk_1.default.white(`cd ${dir}`));
+                console.log(chalk_1.default.gray('2.'), chalk_1.default.white('npm install'));
+                console.log(chalk_1.default.gray('3.'), chalk_1.default.white('rf test'), chalk_1.default.gray('# Start test interface'));
+                console.log(chalk_1.default.gray('4.'), chalk_1.default.white('rf deploy'), chalk_1.default.gray('# Deploy changes back'));
+                console.log(chalk_1.default.cyan.bold('\nQuick Start:'));
+                console.log(chalk_1.default.white(`cd ${dir} && npm install && rf test`));
                 break;
             }
             case 'pull': {
                 const detectedAgentId = await detectAgentFromCurrentDirectory();
                 if (!detectedAgentId) {
-                    (0, logger_1.logError)('❌ Pull requires being in a cloned agent directory with .runflow file.');
+                    (0, logger_1.logError)('❌ Pull requires being in a cloned agent directory with .runflow/rf.json.');
                     (0, logger_1.logError)('💡 Either:');
                     (0, logger_1.logError)('   1. Navigate to a cloned agent directory and try again');
                     (0, logger_1.logError)('   2. Use "Clone repository" first to download the agent');
@@ -357,7 +499,7 @@ let AgentsCommand = class AgentsCommand extends nest_commander_1.CommandRunner {
             case 'deploy': {
                 const detectedAgentId = await detectAgentFromCurrentDirectory();
                 if (!detectedAgentId) {
-                    (0, logger_1.logError)('❌ Deploy from menu requires being in a cloned agent directory with .runflow file.');
+                    (0, logger_1.logError)('❌ Deploy from menu requires being in a cloned agent directory with .runflow/rf.json.');
                     (0, logger_1.logError)('💡 Either:');
                     (0, logger_1.logError)('   1. Navigate to a cloned agent directory and try again');
                     (0, logger_1.logError)('   2. Use "Clone repository" first to download the agent');
@@ -394,6 +536,18 @@ let AgentsCommand = class AgentsCommand extends nest_commander_1.CommandRunner {
     }
     async run(inputs, options) {
         const [action, data] = inputs;
+        if (!action) {
+            console.log(chalk_1.default.cyan.bold('Agents Management'));
+            console.log(chalk_1.default.gray('Manage your AI agents\n'));
+            console.log(chalk_1.default.cyan('Available actions:'));
+            console.log(chalk_1.default.gray('  rf agents list       # List and select agents'));
+            console.log(chalk_1.default.gray('  rf agents clone      # Download agent code'));
+            console.log(chalk_1.default.gray('  rf agents deploy     # Upload your changes'));
+            console.log(chalk_1.default.gray('  rf agents get        # Show current agent'));
+            console.log(chalk_1.default.cyan('\nQuick start:'));
+            console.log(chalk_1.default.white('  rf agents list'));
+            return;
+        }
         const actions = [
             'list',
             'get',
@@ -405,24 +559,6 @@ let AgentsCommand = class AgentsCommand extends nest_commander_1.CommandRunner {
             'duplicate',
             'deploy',
         ];
-        if (!action) {
-            (0, logger_1.log)('\nUsage: rf agents <action> [data]\n');
-            (0, logger_1.log)('Actions:');
-            (0, logger_1.log)('  list                 List agents and select active one');
-            (0, logger_1.log)('  get                  Display active agent');
-            (0, logger_1.log)('  create <json>        Create agent');
-            (0, logger_1.log)('  update <json>        Update active agent');
-            (0, logger_1.log)('  delete               Remove active agent');
-            (0, logger_1.log)('  clone                Clone agent repository (download)');
-            (0, logger_1.log)('  pull                 Pull latest changes (overwrites local)');
-            (0, logger_1.log)('  duplicate            Duplicate agent on server');
-            (0, logger_1.log)('  deploy               Deploy agent with local changes\n');
-            (0, logger_1.log)('Options:');
-            (0, logger_1.log)('  --api-key <key>      API key override');
-            (0, logger_1.log)('  --api <url>          API URL override');
-            (0, logger_1.log)('  --help, -h           Show this help\n');
-            return;
-        }
         if (!actions.includes(action)) {
             (0, logger_1.logError)(config_1.ERROR_MESSAGES.INVALID_ACTION(action, actions));
             return;
@@ -433,14 +569,21 @@ let AgentsCommand = class AgentsCommand extends nest_commander_1.CommandRunner {
             const agentId = config.agentId;
             switch (action) {
                 case 'list': {
-                    (0, logger_1.logVerbose)('Fetching agents...');
+                    console.log(chalk_1.default.blue('Fetching agents...'));
                     const res = await apiClient.get('/agents');
                     const agents = res.data.data ?? res.data;
+                    if (!agents || agents.length === 0) {
+                        console.log(chalk_1.default.yellow('No agents found'));
+                        console.log(chalk_1.default.gray('Create your first agent in the dashboard'));
+                        return;
+                    }
+                    console.log(chalk_1.default.cyan.bold(`\nFound ${agents.length} agents:`));
                     const selected = await (0, ui_1.selectItem)(agents, 'Select an agent:');
                     (0, config_1.saveConfig)({ agentId: selected.id });
+                    console.log(chalk_1.default.green(`\n✓ Selected: ${selected.name}`));
                     const selectedAction = await showAgentActionMenu(selected);
                     if (!selectedAction) {
-                        (0, logger_1.logSuccess)('Operation cancelled');
+                        console.log(chalk_1.default.gray('Operation cancelled'));
                         return;
                     }
                     await this.executeAction(selectedAction, selected, apiClient);
@@ -448,12 +591,19 @@ let AgentsCommand = class AgentsCommand extends nest_commander_1.CommandRunner {
                 }
                 case 'get': {
                     if (!agentId) {
-                        (0, logger_1.logError)(config_1.ERROR_MESSAGES.AGENT_NOT_SELECTED);
+                        console.log(chalk_1.default.red('No agent selected'));
+                        console.log(chalk_1.default.gray('Run: rf agents list'));
                         return;
                     }
-                    (0, logger_1.logVerbose)(`Fetching agent ${agentId}...`);
+                    console.log(chalk_1.default.blue(`Fetching agent details...`));
                     const res = await apiClient.get(`/agents/${agentId}`);
-                    (0, logger_1.logJson)([res.data]);
+                    console.log(chalk_1.default.cyan.bold('\nAgent Details:'));
+                    console.log(chalk_1.default.gray(`Name:     ${res.data.name}`));
+                    console.log(chalk_1.default.gray(`ID:       ${res.data.id}`));
+                    console.log(chalk_1.default.gray(`Status:   ${res.data.status || 'active'}`));
+                    if (res.data.updatedAt) {
+                        console.log(chalk_1.default.gray(`Updated:  ${new Date(res.data.updatedAt).toLocaleString()}`));
+                    }
                     break;
                 }
                 case 'create': {
@@ -497,7 +647,11 @@ let AgentsCommand = class AgentsCommand extends nest_commander_1.CommandRunner {
                     }
                     (0, logger_1.logVerbose)(`Cloning agent ${agentId} repository...`);
                     const agentRes = await apiClient.get(`/agents/${agentId}`);
-                    const agentName = sanitizeFileName(agentRes.data.name || agentId);
+                    const originalName = agentRes.data.name || agentId;
+                    const agentName = sanitizeFileName(originalName);
+                    if (originalName !== agentName) {
+                        console.log(chalk_1.default.gray(`Directory name: "${originalName}" → "${agentName}"`));
+                    }
                     const res = await apiClient.get(`/agents/${agentId}/clone`);
                     const tree = res.data;
                     (0, logger_1.logVerbose)(`Received ${tree.length} items from API`);
@@ -564,6 +718,13 @@ let AgentsCommand = class AgentsCommand extends nest_commander_1.CommandRunner {
                         (0, logger_1.logVerbose)(`⚠️ No .runflow file found - deploy may not work`);
                     }
                     (0, logger_1.logSuccess)(`Repository cloned to ${dir}/`);
+                    console.log(chalk_1.default.cyan.bold('\n🚀 Next Steps:'));
+                    console.log(chalk_1.default.gray('1.'), chalk_1.default.white(`cd ${dir}`));
+                    console.log(chalk_1.default.gray('2.'), chalk_1.default.white('npm install'));
+                    console.log(chalk_1.default.gray('3.'), chalk_1.default.white('rf test'), chalk_1.default.gray('# Start test interface'));
+                    console.log(chalk_1.default.gray('4.'), chalk_1.default.white('rf deploy'), chalk_1.default.gray('# Deploy changes back'));
+                    console.log(chalk_1.default.cyan.bold('\n💡 Quick Start:'));
+                    console.log(chalk_1.default.gray(`cd ${dir} && npm install && rf test`));
                     break;
                 }
                 case 'pull': {
@@ -690,18 +851,8 @@ exports.AgentsCommand = AgentsCommand = __decorate([
     (0, nest_commander_1.Command)({
         name: 'agents',
         aliases: ['agent'],
-        arguments: '<action> [data]',
-        description: 'Manage AI agents.\n' +
-            'Actions:\n' +
-            '  list                 List agents and select active one\n' +
-            '  get                  Display active agent\n' +
-            '  create <json>        Create agent\n' +
-            '  update <json>        Update active agent\n' +
-            '  delete               Remove active agent\n' +
-            '  clone                Clone agent repository (download)\n' +
-            '  pull                 Pull latest changes (overwrites local)\n' +
-            '  duplicate            Duplicate agent on server\n' +
-            '  deploy               Deploy agent with local changes',
+        arguments: '[action] [data]',
+        description: '🤖 Manage AI agents (run without action for help)',
     })
 ], AgentsCommand);
 //# sourceMappingURL=agents.command.js.map