agent-rev 0.2.9 → 0.3.1

package/dist/commands/repl.js

@@ -7,7 +7,7 @@ import chalk from 'chalk';
 import { execSync } from 'child_process';
 import { CLI_REGISTRY } from '../types.js';
 import { writeJson, ensureDir, readJson, listDir, fileExists } from '../utils/fs.js';
-import { loadAuth, saveAuth, loadCliConfig, saveCliConfig, loadProjectConfig } from '../utils/config.js';
+import { loadAuth, saveAuth, loadCliConfig, saveCliConfig, loadProjectConfig, PKG_NAME } from '../utils/config.js';
 import { log } from '../utils/logger.js';
 import { AgentEngine, ExitError } from '../core/engine.js';
 import { qwenAuthStatus, QWEN_AGENT_HOME, fetchQwenModels } from '../utils/qwen-auth.js';
@@ -716,10 +716,12 @@ function cmdHelp(fi) {
         { key: '/setup explorer', value: 'Reconfigure explorer only' },
         { key: '/config-multi', value: 'Reconfigure all agents at once' },
         { key: '/status', value: 'Show current configuration and tasks' },
+        { key: '/explorer <task>', value: 'Run explorer agent on a task/question' },
         { key: '/run <task>', value: 'Full cycle: orchestrator → implementor → reviewer' },
         { key: '/run orch <task>', value: 'Run only orchestrator' },
         { key: '/run impl <id>', value: 'Run only implementor' },
         { key: '/run rev <id>', value: 'Run only reviewer' },
+        { key: '/run explorer <task>', value: 'Run only explorer' },
         { key: '/models', value: 'List models for all installed CLIs' },
         { key: '/models <cli>', value: 'List models for a specific CLI' },
         { key: '/login', value: 'Login (Qwen OAuth or CLI auth)' },
@@ -1035,6 +1037,12 @@ export async function runRepl(resumeSession) {
                     const progress = await readJson(path.join(taskDir, 'progress.json'));
                     await engine.runReviewer(taskId, plan, progress);
                 }
+                else if (args[0] === 'explorer' || args[0] === 'exp') {
+                    const task = args.slice(1).join(' ') || undefined;
+                    const engine = new AgentEngine(config, dir, gCoordinatorCmd, rl, fi, handleCmd);
+                    const result = await engine.runExplorer(task);
+                    fi.println(result);
+                }
                 else {
                     const task = args.join(' ');
                     const engine = new AgentEngine(config, dir, gCoordinatorCmd, rl, fi, handleCmd);
@@ -1042,6 +1050,20 @@ export async function runRepl(resumeSession) {
                 }
                 break;
             }
+            case 'explorer': {
+                const task = args.join(' ') || undefined;
+                try {
+                    const dir = process.cwd();
+                    const config = await loadProjectConfig(dir);
+                    const engine = new AgentEngine(config, dir, gCoordinatorCmd, rl, fi, handleCmd);
+                    const result = await engine.runExplorer(task);
+                    fi.println(result);
+                }
+                catch (err) {
+                    fi.println(chalk.red(`  Explorer error: ${err.message}`));
+                }
+                break;
+            }
             case 'models':
             case 'model':
                 await withRl((rl) => cmdModels(args[0], fi, rl));
@@ -1203,6 +1225,21 @@ export async function runRole(role, arg, model) {
                 await engine.runReviewer(arg, plan, progress);
                 break;
             }
+            case 'explorer':
+            case 'exp': {
+                const explorerCli = config.roles.explorer?.cli;
+                if (explorerCli && explorerCli === PKG_NAME) {
+                    // This binary IS the configured explorer CLI — avoid recursion.
+                    // Call Qwen API directly using own credentials.
+                    const result = await engine.runExplorerDirect(arg || undefined);
+                    console.log(result);
+                }
+                else {
+                    const result = await engine.runExplorer(arg || undefined);
+                    console.log(result);
+                }
+                break;
+            }
             case 'coordinator':
             case 'coord': {
                 console.log(chalk.yellow('  Coordinator mode requires interactive REPL.'));
@@ -1210,7 +1247,7 @@ export async function runRole(role, arg, model) {
                 process.exit(1);
             }
             default:
-                console.log(chalk.red(`  Unknown role: ${role}. Use: orchestrator, implementor, reviewer`));
+                console.log(chalk.red(`  Unknown role: ${role}. Use: orchestrator, implementor, reviewer, explorer`));
                 process.exit(1);
         }
     }

package/dist/core/engine.d.ts

@@ -38,5 +38,9 @@ export declare class AgentEngine {
     runReviewer(taskId: string, plan: TaskPlan, progress: TaskProgress): Promise<{
         verdict: string;
     }>;
+    runExplorer(task?: string): Promise<string>;
+    /** Called when the current binary IS the configured explorer CLI (prevents recursion).
+     *  Builds the full exploration prompt and calls Qwen API using own credentials. */
+    runExplorerDirect(task?: string): Promise<string>;
     runFullCycle(task: string): Promise<void>;
 }

package/dist/core/engine.js

@@ -6,8 +6,7 @@ import { CLI_REGISTRY } from '../types.js';
 import { writeJson, readJson, fileExists, writeFile, readFile } from '../utils/fs.js';
 import { log } from '../utils/logger.js';
 import chalk from 'chalk';
-import { QWEN_AGENT_HOME } from '../utils/qwen-auth.js';
-import { callQwenAPI } from '../utils/qwen-auth.js';
+import { QWEN_AGENT_HOME, callQwenAPI } from '../utils/qwen-auth.js';
 import * as fs from 'fs/promises';
 /** Thrown when a slash command inside a conversation requests exit */
 export class ExitError extends Error {
@@ -346,6 +345,7 @@ INSTRUCCIONES:
             orchestrator: 'orchestrator',
             implementor: 'implementor',
             reviewer: 'reviewer',
+            explorer: 'explorer',
         };
         const key = roleMap[roleName];
         const role = this.config.roles[key];
@@ -446,15 +446,24 @@ INSTRUCCIONES:
                 }
             }
         };
+        // Role binaries (agent-orch, agent-impl, etc.) are wrappers, not AI CLIs.
+        // runExplorer handles them separately by spawning with the short task.
+        // For orch/impl/rev the full cycle never spawns role binaries via runWithFallback.
+        const ROLE_BINARIES = new Set(['agent-orch', 'agent-impl', 'agent-rev', 'agent-explorer']);
         // Try primary
         log.info(`Launching ${roleName}: ${role.cli} (${role.model})`);
-        const primaryResult = await tryWithAutoRepair(role.cli, role.model, role.cmd);
-        if (primaryResult !== null) {
-            trackTokens(primaryResult, role.cli, role.model);
-            return primaryResult;
+        if (ROLE_BINARIES.has(role.cli)) {
+            log.warn(`${role.cli} is a role binary — skipping to fallback`);
+        }
+        else {
+            const primaryResult = await tryWithAutoRepair(role.cli, role.model, role.cmd);
+            if (primaryResult !== null) {
+                trackTokens(primaryResult, role.cli, role.model);
+                return primaryResult;
+            }
         }
         // Try individual fallback
-        if (role.fallback) {
+        if (role.fallback && !ROLE_BINARIES.has(role.fallback.cli)) {
             log.warn(`Trying individual fallback for ${roleName}: ${role.fallback.cli} (${role.fallback.model})`);
             const fallbackResult = await tryWithAutoRepair(role.fallback.cli, role.fallback.model, role.fallback.cmd);
             if (fallbackResult !== null) {
@@ -489,6 +498,10 @@ REGLA: Al terminar, responde SOLO con el JSON de progreso indicado.`,
 REGLA: Usa tus herramientas (read_file, grep_search, etc.) para leer los archivos y verificar criterios.
 REGLA: NO modifiques archivos. NO implementes correcciones.
 REGLA: Al terminar, responde SOLO con el JSON de resultado indicado.`,
+            explorer: `ROL: EXPLORER — solo explora y reporta, nunca modifica archivos.
+REGLA: Usa tus herramientas (read_file, grep_search, list_directory, etc.) para explorar el proyecto.
+REGLA: NO modifiques archivos. NO ejecutes comandos que cambien estado.
+REGLA: Al terminar, reporta todo lo que encontraste de forma clara y estructurada.`,
         };
         const preamble = preambles[roleName] || '';
         return preamble ? `${preamble}\n\n${taskPrompt}` : taskPrompt;
@@ -726,6 +739,119 @@ INSTRUCCIONES:
         log.verdict(verdict);
         return { verdict };
     }
+    async runExplorer(task) {
+        if (!this.config.roles.explorer) {
+            if (!this.config.fallback_global) {
+                throw new Error('Explorer not configured and no fallback available. Run /setup explorer first.');
+            }
+            log.warn(`Explorer role not configured — using fallback: ${this.config.fallback_global.cli} (${this.config.fallback_global.model})`);
+            this.config.roles.explorer = { ...this.config.fallback_global };
+        }
+        log.phase(0, 'Exploracion', this.config.roles.explorer.cli, this.config.roles.explorer.model);
+        // Ensure .agent/ structure exists
+        const agentDir = path.join(this.projectDir, '.agent');
+        const contextDir = path.join(agentDir, 'context');
+        await fs.mkdir(contextDir, { recursive: true });
+        await fs.mkdir(path.join(agentDir, 'rules'), { recursive: true });
+        // Read existing architecture doc if any
+        const archPath = path.join(contextDir, 'architecture.md');
+        let existingArch = '';
+        try {
+            existingArch = await readFile(archPath);
+        }
+        catch { /* new project */ }
+        const effectiveTask = task || 'Explorar y documentar todas las aplicaciones y servicios del proyecto';
+        const prompt = `TAREA DE EXPLORACION: ${effectiveTask}
+DIRECTORIO_TRABAJO: ${this.projectDir}
+PROYECTO: ${this.config.project}
+STACK: ${this.config.stack}
+
+${existingArch ? `DOCUMENTACION EXISTENTE (actualizar si hay cambios):\n${existingArch.slice(0, 3000)}\n` : 'DOCUMENTACION EXISTENTE: ninguna — crear desde cero.\n'}
+INSTRUCCIONES:
+1. Lista el directorio raiz para identificar todos los servicios/aplicaciones.
+2. Para cada servicio/app: lee su package.json / requirements.txt / pyproject.toml para obtener nombre, stack y dependencias clave.
+3. Explora src/ o app/ de cada servicio: identifica entry point, modulos principales, rutas/endpoints expuestos, puerto configurado.
+4. Identifica dependencias ENTRE servicios (llamadas HTTP, variables de entorno compartidas, bases de datos comunes).
+5. Crea o actualiza el archivo ${archPath} con:
+   - Tabla resumen: | Servicio | Stack | Puerto | Proposito | Entry Point |
+   - Por cada servicio: modulos principales, rutas API clave, dependencias externas
+   - Mapa de dependencias entre servicios
+6. Crea o actualiza archivos individuales en ${contextDir}/<servicio>/architecture.md para cada servicio.
+7. Al terminar lista todos los archivos creados/actualizados.
+
+REGLAS:
+- NO modifiques archivos de aplicacion (solo .agent/context/)
+- NO ejecutes comandos que cambien estado (npm install, migraciones, etc.)
+- Si un directorio esta en node_modules, dist, .git: ignoralo`;
+        const ROLE_BINS = new Set(['agent-orch', 'agent-impl', 'agent-rev', 'agent-explorer']);
+        let res;
+        if (ROLE_BINS.has(this.config.roles.explorer.cli)) {
+            // Spawn the role binary as a separate process with its own credentials.
+            // Pass only the short task — the binary builds its own full prompt internally.
+            const explorerRole = this.config.roles.explorer;
+            const spawnCmd = `${explorerRole.cli} --model ${explorerRole.model}`;
+            log.info(`Spawning ${explorerRole.cli} (${explorerRole.model}) as separate process`);
+            const result = await runCli(spawnCmd, effectiveTask);
+            if (result.exitCode !== 0) {
+                log.warn(`${explorerRole.cli} exited with code ${result.exitCode} — trying fallback`);
+                res = await this.runWithFallback('explorer', prompt, 'Exploracion');
+            }
+            else {
+                res = result.output;
+            }
+        }
+        else {
+            res = await this.runWithFallback('explorer', prompt, 'Exploracion');
+        }
+        const text = extractCliText(res);
+        // Always save a timestamped explorer report
+        try {
+            const ts = new Date().toISOString().replace(/[:.]/g, '-').slice(0, 19);
+            await writeFile(path.join(contextDir, `explorer-${ts}.md`), `# Explorer Report\n\nTask: ${effectiveTask}\nDate: ${new Date().toISOString()}\n\n${text}\n`);
+            log.ok(`Saved to .agent/context/explorer-${ts}.md`);
+        }
+        catch { /* don't fail if save fails */ }
+        return text;
+    }
+    /** Called when the current binary IS the configured explorer CLI (prevents recursion).
+     *  Builds the full exploration prompt and calls Qwen API using own credentials. */
+    async runExplorerDirect(task) {
+        const role = this.config.roles.explorer;
+        if (!role)
+            throw new Error('Explorer role not configured.');
+        const agentDir = path.join(this.projectDir, '.agent');
+        const contextDir = path.join(agentDir, 'context');
+        await fs.mkdir(contextDir, { recursive: true });
+        const archPath = path.join(contextDir, 'architecture.md');
+        let existingArch = '';
+        try {
+            existingArch = await readFile(archPath);
+        }
+        catch { /* new */ }
+        const effectiveTask = task || 'Explorar y documentar todas las aplicaciones y servicios del proyecto';
+        const context = await this.buildOrchestratorContext();
+        const prompt = this.buildRolePrompt('explorer', `TAREA DE EXPLORACION: ${effectiveTask}
+DIRECTORIO_TRABAJO: ${this.projectDir}
+PROYECTO: ${this.config.project}
+
+${existingArch ? `DOCUMENTACION EXISTENTE:\n${existingArch.slice(0, 3000)}\n` : 'Sin documentacion previa.\n'}
+CONTEXTO: ${context.slice(0, 2000)}
+
+INSTRUCCIONES:
+1. Lista el directorio raiz e identifica todos los servicios/apps.
+2. Para cada uno: lee package.json/requirements.txt, explora src/, identifica entry point, rutas/endpoints, puerto.
+3. Identifica dependencias entre servicios.
+4. Crea/actualiza ${archPath} con tabla resumen y detalle por servicio.
+5. Crea/actualiza ${contextDir}/<servicio>/architecture.md para cada servicio.`);
+        const result = await callQwenAPI(prompt, role.model);
+        try {
+            const ts = new Date().toISOString().replace(/[:.]/g, '-').slice(0, 19);
+            await writeFile(path.join(contextDir, `explorer-${ts}.md`), `# Explorer Report\n\nTask: ${effectiveTask}\n\n${result}\n`);
+            log.ok(`Saved to .agent/context/explorer-${ts}.md`);
+        }
+        catch { /* ignore */ }
+        return result;
+    }
     async runFullCycle(task) {
         // Header is now shown by the REPL before the first user message
         // ══════════════════════════════════════════════════

package/dist/utils/qwen-auth.d.ts

@@ -11,3 +11,5 @@ export declare function qwenAuthStatus(): Promise<{
 export declare function fetchQwenModels(): Promise<string[]>;
 export declare function getQwenAccessToken(): Promise<string | null>;
 export declare function callQwenAPI(prompt: string, model?: string): Promise<string>;
+/** Call Qwen API using credentials from a specific file path (for role binaries) */
+export declare function callQwenAPIFromCreds(prompt: string, model: string, credsPath: string): Promise<string>;

package/dist/utils/qwen-auth.js

@@ -237,12 +237,7 @@ export async function getQwenAccessToken() {
     const token = await loadToken();
     return token?.accessToken || null;
 }
-export async function callQwenAPI(prompt, model = 'coder-model') {
-    const token = await loadToken();
-    if (!token) {
-        throw new Error('No hay token de Qwen. Ejecutá /login primero.');
-    }
-    // Qwen OAuth tokens work with chat.qwen.ai API
+async function callQwenAPIWithToken(token, prompt, model) {
     const baseUrl = 'https://chat.qwen.ai/api/v1';
     const response = await fetch(`${baseUrl}/chat/completions`, {
         method: 'POST',
@@ -253,7 +248,6 @@ export async function callQwenAPI(prompt, model = 'coder-model') {
         body: JSON.stringify({
             model: model || 'coder-model',
             messages: [
-                { role: 'system', content: 'Sos el COORDINADOR de un equipo multi-agente de desarrollo. Tu trabajo es ENTENDER lo que el programador necesita haciendo PREGUNTAS si es necesario. Habla de forma NATURAL, como un compañero de equipo. Sé breve y directo.' },
                 { role: 'user', content: prompt },
             ],
         }),
@@ -265,3 +259,39 @@ export async function callQwenAPI(prompt, model = 'coder-model') {
     const data = await response.json();
     return data.choices?.[0]?.message?.content || '';
 }
+export async function callQwenAPI(prompt, model = 'coder-model') {
+    const token = await loadToken();
+    if (!token) {
+        throw new Error('No hay token de Qwen. Ejecutá /login primero.');
+    }
+    return callQwenAPIWithToken(token, prompt, model);
+}
+/** Call Qwen API using credentials from a specific file path (for role binaries) */
+export async function callQwenAPIFromCreds(prompt, model, credsPath) {
+    let raw;
+    try {
+        raw = JSON.parse(await fs.readFile(credsPath, 'utf-8'));
+    }
+    catch {
+        throw new Error(`No credentials found at ${credsPath}. Run the role binary with --login first.`);
+    }
+    let token = {
+        accessToken: raw.accessToken || raw.access_token || '',
+        refreshToken: raw.refreshToken || raw.refresh_token || '',
+        expiresAt: raw.expiresAt || raw.expiry_date || 0,
+        idToken: raw.idToken || raw.id_token,
+        resourceUrl: raw.resourceUrl || raw.resource_url,
+    };
+    if (!token.accessToken) {
+        throw new Error(`Invalid credentials at ${credsPath}. Run the role binary with --login first.`);
+    }
+    // Refresh if expired
+    if (token.expiresAt <= Date.now() && token.refreshToken) {
+        const refreshed = await refreshAccessToken(token.refreshToken);
+        if (refreshed) {
+            token = refreshed;
+            await fs.writeFile(credsPath, JSON.stringify(token, null, 2), 'utf-8');
+        }
+    }
+    return callQwenAPIWithToken(token, prompt, model);
+}

package/package.json

@@ -1 +1 @@
-{"name":"agent-rev","version":"0.2.9","description":"agent-rev agent","type":"module","main":"./dist/index.js","files":["dist/"],"bin":{"agent-rev":"dist/index.js"},"scripts":{"build":"tsc && echo '#!/usr/bin/env node' | cat - dist/index.js > dist/index.tmp && mv dist/index.tmp dist/index.js && chmod +x dist/index.js","dev":"tsx src/index.ts","prepublishOnly":"npm run build"},"keywords":["ai","agent","cli"],"license":"MIT","dependencies":{"@anthropic-ai/sdk":"^0.39.0","@google/generative-ai":"^0.24.0","chalk":"^5.4.1","commander":"^13.1.0","open":"^11.0.0","openai":"^4.91.0"},"devDependencies":{"@types/node":"^22.13.0","@types/open":"^6.1.0","tsx":"^4.19.3","typescript":"^5.7.3"},"engines":{"node":">=18.0.0"}}
+{"name":"agent-rev","version":"0.3.1","description":"agent-rev agent","type":"module","main":"./dist/index.js","files":["dist/"],"bin":{"agent-rev":"dist/index.js"},"scripts":{"build":"tsc"},"keywords":["ai","agent","cli"],"license":"MIT","dependencies":{"@anthropic-ai/sdk":"^0.39.0","@google/generative-ai":"^0.24.0","chalk":"^5.4.1","commander":"^13.1.0","open":"^11.0.0","openai":"^4.91.0"},"engines":{"node":">=18.0.0"}}