agents.dev 1.0.3 → 1.0.5

package/README.md

@@ -35,7 +35,14 @@ agents-install
    ```
 
 ### First Run
-Running the tool will start the **Wizard**:
+Run the **init** command to start the configuration Wizard:
+```bash
+agents.dev init
+# OR with npx
+npx agents.dev init
+```
+
+The Wizard will guide you through:
 1.  **Select OS**: Windows or Unix.
 2.  **Select Targets**: Choose formats to build (Gemini, Roo, etc.).
 3.  **Docs Auto-Gen**: It automatically creates `docs/` and a workflow guide.

package/dist/generators/agents.js

@@ -3,6 +3,7 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
     return (mod && mod.__esModule) ? mod : { "default": mod };
 };
 Object.defineProperty(exports, "__esModule", { value: true });
+exports.getAvailableAgents = getAvailableAgents;
 exports.generateAgents = generateAgents;
 const fs_extra_1 = __importDefault(require("fs-extra"));
 const path_1 = __importDefault(require("path"));
@@ -14,14 +15,67 @@ const roo_1 = require("../transformers/roo");
 const kilo_1 = require("../transformers/kilo");
 const opencode_1 = require("../transformers/opencode");
 const markdown_1 = require("../parsers/markdown");
-async function generateAgents(definitionsDir, outDir, selectedTargets) {
+async function getAvailableAgents(definitionsDir) {
+    if (!(await fs_extra_1.default.pathExists(definitionsDir))) {
+        return [];
+    }
+    const agents = [];
+    let files = [];
+    let baseDir = definitionsDir;
+    const stats = await fs_extra_1.default.stat(definitionsDir);
+    if (stats.isFile()) {
+        baseDir = path_1.default.dirname(definitionsDir);
+        files = [path_1.default.basename(definitionsDir)];
+    }
+    else {
+        files = await fs_extra_1.default.readdir(definitionsDir);
+    }
+    for (const file of files) {
+        const filePath = path_1.default.join(baseDir, file);
+        if (file.endsWith('.yaml') || file.endsWith('.yml')) {
+            try {
+                const content = await fs_extra_1.default.readFile(filePath, 'utf-8');
+                const rawAgent = yaml_1.default.parse(content);
+                const parseResult = types_1.AgentSchema.safeParse(rawAgent);
+                if (parseResult.success) {
+                    const slug = file.replace(/\.(yaml|yml)$/, '');
+                    agents.push({
+                        name: parseResult.data.name,
+                        slug: slug,
+                        description: parseResult.data.description
+                    });
+                }
+            }
+            catch (e) { }
+        }
+        else if (file.endsWith('.md')) {
+            try {
+                const content = await fs_extra_1.default.readFile(filePath, 'utf-8');
+                const parsedAgents = (0, markdown_1.parseMarkdownAgents)(content);
+                for (const agent of parsedAgents) {
+                    const parseResult = types_1.AgentSchema.safeParse(agent);
+                    if (parseResult.success) {
+                        agents.push({
+                            name: parseResult.data.name,
+                            slug: toSlug(parseResult.data.name),
+                            description: parseResult.data.description
+                        });
+                    }
+                }
+            }
+            catch (e) { }
+        }
+    }
+    return agents.sort((a, b) => a.name.localeCompare(b.name));
+}
+async function generateAgents(definitionsDir, outDir, selectedTargets, agentWhitelist) {
     console.log(chalk_1.default.blue(`\n📦 Building agents from ${definitionsDir}...`));
     try {
         if (outDir !== process.cwd()) {
             await fs_extra_1.default.ensureDir(outDir);
         }
         // Check if input exists
-        if (!await fs_extra_1.default.pathExists(definitionsDir)) {
+        if (!(await fs_extra_1.default.pathExists(definitionsDir))) {
             console.error(chalk_1.default.red(`Input not found: ${definitionsDir}`));
             return;
         }
@@ -49,6 +103,9 @@ async function generateAgents(definitionsDir, outDir, selectedTargets) {
                     }
                     // Use filename as slug for YAML (backward compatibility)
                     const slug = file.replace(/\.(yaml|yml)$/, '');
+                    if (agentWhitelist && !agentWhitelist.includes(slug)) {
+                        continue;
+                    }
                     await buildAgentArtifacts(parseResult.data, slug, outDir, selectedTargets);
                 }
                 catch (e) {
@@ -71,6 +128,9 @@ async function generateAgents(definitionsDir, outDir, selectedTargets) {
                     }
                     // Use agent name as slug for Markdown
                     const slug = toSlug(agent.name);
+                    if (agentWhitelist && !agentWhitelist.includes(slug)) {
+                        continue;
+                    }
                     await buildAgentArtifacts(agent, slug, outDir, selectedTargets);
                 }
             }
@@ -113,7 +173,7 @@ async function buildAgentArtifacts(agent, slug, outDir, selectedTargets) {
             name: `${slug}.md`
         }
     ];
-    const targetsToBuild = allTargets.filter(t => selectedTargets.includes(t.id));
+    const targetsToBuild = allTargets.filter((t) => selectedTargets.includes(t.id));
     for (const target of targetsToBuild) {
         const targetDir = path_1.default.join(outDir, target.subDir);
         await fs_extra_1.default.ensureDir(targetDir);
@@ -128,7 +188,8 @@ function logValidationErrors(source, error) {
     });
 }
 function toSlug(name) {
-    return name.toLowerCase()
+    return name
+        .toLowerCase()
         .replace(/[^\w\s-]/g, '') // remove non-word chars
         .replace(/[\s_-]+/g, '-') // collapse whitespace/underscores to hyphens
         .replace(/^-+|-+$/g, ''); // trim hyphens

package/dist/index.js

@@ -15,75 +15,146 @@ const program = new commander_1.Command();
 program
     .name('agents')
     .description('Agent Installer CLI')
-    .version('1.0.0')
+    .version('1.0.4');
+program.command('init')
+    .description('Initialize agents configuration interactively')
     .option('-o, --out <dir>', 'Output directory', '.')
     .option('-i, --input <path>', 'Input file or directory (default: definitions/ or agents.md)')
     .option('-t, --target <targets>', 'Comma-separated target formats (gemini, roo, kilo, opencode)')
     .action(async (options) => {
-    console.log(chalk_1.default.bold.blue('\n🚀 Agents.dev Installer Wizard\n'));
-    // --- STEP 1: INITIALIZATION (Docs & Shell) ---
-    const docsDir = path_1.default.join(process.cwd(), 'docs');
-    // Check if docs directory exists
-    if (!await fs_extra_1.default.pathExists(docsDir)) {
-        console.log(chalk_1.default.yellow('ℹ️  Project documentation structure not found.'));
-        const initAnswers = await inquirer_1.default.prompt([
-            {
-                type: 'list',
-                name: 'shell',
-                message: 'Initialize validation: Which shell do you use?',
-                choices: [
-                    { name: 'Windows (CMD/PowerShell)', value: 'win32' },
-                    { name: 'Unix-like (Bash/Zsh/Ubuntu)', value: 'unix' }
-                ]
-            }
-        ]);
-        await (0, docs_1.generateWorkflowGuide)(docsDir, initAnswers.shell);
-    }
-    else {
-        console.log(chalk_1.default.gray('✅ "docs/" directory already exists.\n'));
+    // Safety check for non-interactive environments (CI/CD)
+    if (!process.stdout.isTTY || process.env.CI === 'true' || process.env.CI === '1') {
+        console.log(chalk_1.default.yellow('Skipping interactive installer (non-interactive environment detected).'));
+        console.log(chalk_1.default.gray('Run "npx agents.dev" manually to configure your agents.'));
+        return;
     }
-    // --- STEP 2: BUILD AGENTS ---
-    let inputPath = options.input ? path_1.default.resolve(options.input) : path_1.default.join(process.cwd(), 'definitions');
-    // If default definitions dir doesn't exist and no input specified, try agents.md
-    if (!options.input && !await fs_extra_1.default.pathExists(inputPath)) {
-        const localAgentsMd = path_1.default.join(process.cwd(), 'agents.md');
-        if (await fs_extra_1.default.pathExists(localAgentsMd)) {
-            inputPath = localAgentsMd;
-            console.log(chalk_1.default.gray(`ℹ️  Using 'agents.md' found in root.`));
+    try {
+        console.log(chalk_1.default.bold.blue('\n🚀 Agents.dev Installer Wizard\n'));
+        // --- STEP 1: INITIALIZATION (Docs & Shell) ---
+        const docsDir = path_1.default.join(process.cwd(), 'docs');
+        // Check if docs directory exists
+        if (!(await fs_extra_1.default.pathExists(docsDir))) {
+            console.log(chalk_1.default.yellow('ℹ️  Project documentation structure not found.'));
+            const initAnswers = await inquirer_1.default.prompt([
+                {
+                    type: 'list',
+                    name: 'shell',
+                    message: 'Initialize validation: Which shell do you use?',
+                    choices: [
+                        { name: 'Windows (CMD/PowerShell)', value: 'win32' },
+                        { name: 'Unix-like (Bash/Zsh/Ubuntu)', value: 'unix' }
+                    ]
+                }
+            ]);
+            await (0, docs_1.generateWorkflowGuide)(docsDir, initAnswers.shell);
         }
-    }
-    const outDir = path_1.default.resolve(options.out);
-    // Determine targets
-    let selectedTargets = [];
-    if (options.target) {
-        selectedTargets = options.target.split(',').map((t) => t.trim().toLowerCase());
-    }
-    else {
-        const buildAnswers = await inquirer_1.default.prompt([
-            {
-                type: 'checkbox',
-                name: 'targets',
-                message: 'Select target formats to build:',
-                choices: [
-                    { name: 'Gemini CLI', value: 'gemini', checked: true },
-                    { name: 'Roo Code', value: 'roo', checked: false },
-                    { name: 'Kilo Code', value: 'kilo', checked: false },
-                    { name: 'OpenCode', value: 'opencode', checked: false }
-                ],
-                validate: (answer) => {
-                    if (answer.length < 1) {
-                        return 'You must choose at least one target.';
+        else {
+            console.log(chalk_1.default.gray('✅ "docs/" directory already exists.\n'));
+        }
+        // --- STEP 2: BUILD AGENTS ---
+        let inputPath = options.input ? path_1.default.resolve(options.input) : path_1.default.join(process.cwd(), 'definitions');
+        // If default definitions dir doesn't exist and no input specified, try agents.md
+        if (!options.input && !(await fs_extra_1.default.pathExists(inputPath))) {
+            const localAgentsMd = path_1.default.join(process.cwd(), 'agents.md');
+            if (await fs_extra_1.default.pathExists(localAgentsMd)) {
+                inputPath = localAgentsMd;
+                console.log(chalk_1.default.gray(`ℹ️  Using 'agents.md' found in root.`));
+            }
+            else {
+                // Fallback: Check if we are running from the installed package and definitions exist there
+                const packageDefinitions = path_1.default.join(__dirname, '../definitions');
+                if (await fs_extra_1.default.pathExists(packageDefinitions)) {
+                    inputPath = packageDefinitions;
+                    // console.log(chalk.gray(`ℹ️  Using default definitions from package.`));
+                }
+            }
+        }
+        const outDir = path_1.default.resolve(options.out);
+        // Determine targets
+        let selectedTargets = [];
+        if (options.target) {
+            selectedTargets = options.target.split(',').map((t) => t.trim().toLowerCase());
+        }
+        else {
+            const buildAnswers = await inquirer_1.default.prompt([
+                {
+                    type: 'checkbox',
+                    name: 'targets',
+                    message: 'Select target formats to build:',
+                    choices: [
+                        { name: 'Gemini CLI', value: 'gemini', checked: true },
+                        { name: 'Roo Code', value: 'roo', checked: false },
+                        { name: 'Kilo Code', value: 'kilo', checked: false },
+                        { name: 'OpenCode', value: 'opencode', checked: false }
+                    ],
+                    validate: (answer) => {
+                        if (answer.length < 1) {
+                            return 'You must choose at least one target.';
+                        }
+                        return true;
+                    }
+                }
+            ]);
+            selectedTargets = buildAnswers.targets;
+        }
+        if (selectedTargets.length === 0) {
+            console.log(chalk_1.default.yellow('No targets selected. Exiting.'));
+            return;
+        }
+        // --- STEP 3: SELECT AGENTS ---
+        let selectedAgents = undefined;
+        const availableAgents = await (0, agents_1.getAvailableAgents)(inputPath);
+        if (availableAgents.length > 0) {
+            const agentSelection = await inquirer_1.default.prompt([
+                {
+                    type: 'list',
+                    name: 'mode',
+                    message: 'How do you want to install agents?',
+                    choices: [
+                        { name: 'Install All Standard Agents (Recommended)', value: 'all' },
+                        { name: 'Custom Selection', value: 'custom' }
+                    ]
+                },
+                {
+                    type: 'checkbox',
+                    name: 'agents',
+                    message: 'Select agents to install:',
+                    choices: availableAgents.map((a) => ({
+                        name: a.description ? `${a.name} - ${chalk_1.default.gray(a.description)}` : a.name,
+                        value: a.slug,
+                        checked: true
+                    })),
+                    when: (answers) => answers.mode === 'custom',
+                    validate: (answer) => {
+                        if (answer.length < 1) {
+                            return 'You must choose at least one agent.';
+                        }
+                        return true;
                     }
-                    return true;
                 }
+            ]);
+            if (agentSelection.mode === 'custom') {
+                selectedAgents = agentSelection.agents;
             }
-        ]);
-        selectedTargets = buildAnswers.targets;
+        }
+        await (0, agents_1.generateAgents)(inputPath, outDir, selectedTargets, selectedAgents);
     }
-    if (selectedTargets.length === 0) {
-        console.log(chalk_1.default.yellow('No targets selected. Exiting.'));
-        return;
+    catch (error) {
+        if (error.isTtyError) {
+            console.log(chalk_1.default.yellow('Interactive prompt not supported in this environment.'));
+        }
+        else if (error.message.includes('User force closed')) {
+            console.log(chalk_1.default.yellow('\nInstallation cancelled by user.'));
+        }
+        else {
+            console.error(chalk_1.default.red('\nAn error occurred during installation:'), error.message);
+        }
+        // Always exit with 0 to prevent npm install from failing loudly
+        process.exit(0);
     }
-    await (0, agents_1.generateAgents)(inputPath, outDir, selectedTargets);
+});
+// Default command (show help if no command)
+program.action(() => {
+    program.help();
 });
 program.parse(process.argv);

package/dist/types.js

@@ -5,6 +5,7 @@ const zod_1 = require("zod");
 exports.AgentSchema = zod_1.z.object({
     name: zod_1.z.string().min(1, "Name is required"),
     role: zod_1.z.string().min(1, "Role is required"),
+    description: zod_1.z.string().optional(),
     emoji: zod_1.z.string().optional(),
     systemPrompt: zod_1.z.string().min(10, "System prompt must be at least 10 characters"),
     rules: zod_1.z.array(zod_1.z.string()).optional(),

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "agents.dev",
-  "version": "1.0.3",
+  "version": "1.0.5",
   "description": "",
   "main": "dist/index.js",
   "bin": {