agent-mp 0.5.7 → 0.5.9

package/dist/commands/repl.js

@@ -683,6 +683,57 @@ async function cmdAuthStatus(fi) {
         }));
     fi.println(renderSectionBox('Auth Status', rows));
 }
+async function cmdUsage(fi) {
+    const { qwenUsage } = await import('../utils/qwen-auth.js');
+    const { PKG_NAME, getConfigDir } = await import('../utils/config.js');
+    const { loadProjectConfig } = await import('../utils/config.js');
+    fi.println(chalk.bold.cyan('\n  Uso / Quota\n'));
+    // Check each role CLI
+    const dir = await resolveProjectDir(process.cwd());
+    let config;
+    try {
+        config = await loadProjectConfig(dir);
+    }
+    catch {
+        config = null;
+    }
+    const checks = [];
+    // Check main PKG_NAME (this CLI's own credentials)
+    const mainResult = await qwenUsage();
+    const mainLabel = `${PKG_NAME} (${mainResult.token ? 'coder-model' : '?'})`;
+    if (mainResult.ok) {
+        const exp = mainResult.token ? new Date(mainResult.token.expiresAt).toLocaleTimeString() : '?';
+        checks.push({ key: mainLabel, value: chalk.green(`✓ quota OK — expires ${exp}`) });
+    }
+    else {
+        checks.push({ key: mainLabel, value: chalk.red(`✗ ${mainResult.error}`) });
+    }
+    // Check each configured role CLI
+    if (config?.roles) {
+        for (const [roleName, roleCfg] of Object.entries(config.roles)) {
+            const r = roleCfg;
+            if (!r?.cli)
+                continue;
+            const homeDir = path.join(os.homedir(), '.' + r.cli);
+            const credsPath = path.join(homeDir, 'oauth_creds.json');
+            if (await fileExists(credsPath)) {
+                const result = await qwenUsage(credsPath);
+                const exp = result.token ? new Date(result.token.expiresAt).toLocaleTimeString() : '?';
+                if (result.ok) {
+                    checks.push({ key: `${r.cli} (${roleName})`, value: chalk.green(`✓ quota OK — expires ${exp}`) });
+                }
+                else {
+                    checks.push({ key: `${r.cli} (${roleName})`, value: chalk.red(`✗ ${result.error}`) });
+                }
+            }
+            else {
+                checks.push({ key: `${r.cli} (${roleName})`, value: chalk.yellow('not logged in') });
+            }
+        }
+    }
+    fi.println(renderSectionBox('Quota Status', checks));
+    fi.println('');
+}
 function cmdHelp(fi) {
     const commands = [
         { key: '/setup', value: 'Full interactive setup wizard' },
@@ -703,6 +754,7 @@ function cmdHelp(fi) {
         { key: '/login', value: 'Login (Qwen OAuth or CLI auth)' },
         { key: '/logout', value: 'Logout and clear credentials' },
         { key: '/auth-status', value: 'Show authentication status' },
+        { key: '/usage', value: 'Check quota status for all role CLIs' },
         { key: '/tasks', value: 'List all tasks' },
         { key: '/clear', value: 'Clear the screen' },
         { key: '/help', value: 'Show this help' },
@@ -1067,6 +1119,9 @@ export async function runRepl(resumeSession) {
             case 'auth-status':
                 await cmdAuthStatus(fi);
                 break;
+            case 'usage':
+                await cmdUsage(fi);
+                break;
             case 'tasks':
                 await cmdTasks(fi);
                 break;

package/dist/core/engine.js

@@ -985,27 +985,32 @@ INSTRUCCIONES:
         let fsSnapshot = '';
         try {
             const { execSync } = await import('child_process');
-            // Use find but exclude .agent, node_modules, .git, dist, __pycache__, .venv, target, build
             fsSnapshot = execSync(`find "${this.projectDir}" -maxdepth 3 -not -path '*/.agent/*' -not -path '*/node_modules/*' -not -path '*/.git/*' -not -path '*/dist/*' -not -path '*/__pycache__/*' -not -path '*/.venv/*' -not -path '*/target/*' -not -path '*/build/*' -not -name '.git' | sort | head -300`, { encoding: 'utf-8', timeout: 10000 });
         }
         catch { /* ignore */ }
-        // Read existing architecture docs if any
-        const archPath = path.join(contextDir, 'architecture.md');
-        let existingArch = '';
+        // Read existing main architecture doc
+        const mainArchPath = path.join(contextDir, 'architecture.md');
+        let existingMainArch = '';
         try {
-            existingArch = await readFile(archPath);
+            existingMainArch = await readFile(mainArchPath);
         }
-        catch { /* new project */ }
-        // Read existing module docs if any
-        const modulesDir = path.join(contextDir, 'modules');
-        let existingModules = '';
+        catch { /* new */ }
+        // Read existing per-component docs
+        let existingComponentDocs = '';
         try {
-            const modFiles = await fs.readdir(modulesDir);
-            for (const f of modFiles.filter(f => f.endsWith('.md'))) {
-                existingModules += `\n--- ${f} ---\n${await readFile(path.join(modulesDir, f)).then(c => c.slice(0, 2000))}\n`;
+            const ctxEntries = await fs.readdir(contextDir);
+            for (const entry of ctxEntries.filter(e => e !== 'architecture.md' && e !== 'explorer-last.md' && e !== 'modules')) {
+                const entryPath = path.join(contextDir, entry);
+                const stat = await fs.stat(entryPath);
+                if (stat.isDirectory()) {
+                    const compArch = path.join(entryPath, 'architecture.md');
+                    if (await fileExists(compArch)) {
+                        existingComponentDocs += `\n=== EXISTING: ${entry}/architecture.md ===\n${(await readFile(compArch)).slice(0, 1500)}\n`;
+                    }
+                }
             }
         }
-        catch { /* no modules yet */ }
+        catch { /* ignore */ }
         const effectiveTask = task || 'Explorar y documentar todas las aplicaciones y servicios del proyecto';
         const prompt = `TAREA DE EXPLORACION: ${effectiveTask}
 DIRECTORIO_TRABAJO: ${this.projectDir}
@@ -1015,114 +1020,124 @@ STACK: ${this.config.stack}
 ESTRUCTURA DE ARCHIVOS DEL PROYECTO (excluyendo .agent, node_modules, .git, dist, __pycache__, .venv, target, build):
 ${fsSnapshot}
 
-${existingArch ? `--- DOCUMENTACION EXISTENTE: architecture.md ---\n${existingArch.slice(0, 2000)}\n` : ''}
-${existingModules ? `--- DOCUMENTACION EXISTENTE: modules/ ---\n${existingModules.slice(0, 3000)}\n` : ''}
+${existingMainArch ? `=== DOCUMENTACION EXISTENTE: architecture.md (principal) ===\n${existingMainArch.slice(0, 2000)}\n` : ''}
+${existingComponentDocs ? `=== DOCUMENTACION EXISTENTE por componente ===\n${existingComponentDocs.slice(0, 3000)}\n` : ''}
 
 INSTRUCCIONES:
-Analiza la estructura de archivos y genera documentación COMPLETA y ESCALONADA del proyecto.
-Para cada directorio/modulo debes documentar: QUE ES, COMO SE ESTRUCTURA, QUE NECESITA PARA LEVANTAR, y QUE COMANDOS PUEDE EJECUTAR.
+Analiza la estructura de archivos y genera documentación ESCALONADA en DOS NIVELES:
+
+NIVEL 1: architecture.md (raiz de .agent/context/)
+  - Lista TODOS los directorios al nivel del proyecto
+  - Indica si son independientes o conectados entre si (ej: front consume back, dos APIs se consumen entre si)
+  - Prerequisitos generales para levantar el proyecto
+  - Comandos globales de desarrollo
 
-IMPORTANTE: Si un directorio contiene una API o servicio con multiples modulos (rutas, controllers, models, etc.),
-ese directorio debe tener SU PROPIA subcarpeta dentro de modules/ con un index.md y un archivo por cada modulo interno.
+NIVEL 2: Para CADA directorio que sea un servicio/API/app/funcionalidad:
+  - Crea subcarpeta: [nombre-del-directorio]/architecture.md → explica como se estructura internamente
+  - Crea subcarpeta: [nombre-del-directorio]/modules/[modulo].md → detalle de cada modulo interno
+  - Si un directorio es trivial (solo scripts, docs, configs), NO crees subcarpeta, solo mencionarlo en el architecture.md principal
 
-DEVUELVE el contenido de TODOS los archivos a crear en este formato EXACTO (separados por marcadores):
+FORMATO EXACTO de los archivos a devolver (separados por marcadores):
 
-=== ARCHITECTURE.md ===
-# ${this.config.project} — Architecture
+=== architecture.md ===
+# ${this.config.project} — Architecture Overview
 
-Breve descripcion del proyecto y su stack.
+Descripcion general del proyecto.
 
-## Estructura General
+## Componentes del Proyecto
 
-Tabla resumen de todos los directorios al nivel del proyecto:
-| Directorio | Tipo | Stack | Proposito | Entry Point |
+| Componente | Tipo | Stack | Proposito | Entry Point |
+|------------|------|-------|-----------|-------------|
+| datamart-data-access-api | API Backend | NestJS | Acceso a datos | src/main.ts |
+| nexus-core-api | API Backend | NestJS | Core business logic | src/main.ts |
 
-## Como se relacionan los componentes
+## Como se Relacionan los Componentes
 
-Explica como interactuan entre si los directorios/servicios:
-- Dependencias entre componentes
-- Flujo de datos principal
-- Variables de entorno compartidas
-- Bases de datos o servicios externos comunes
+Explica las conexiones entre componentes:
+- Si un front consume un back, explicar como
+- Si dos APIs se consumen entre sí (fetch, HTTP), explicar el flujo
+- Si son independientes, indicar que cada uno funciona por su cuenta
+
+### Diagrama de Flujo (texto)
+\`\`\`
+[Frontend] --fetch--> [API 1] --HTTP--> [API 2]
+[API 1] --> [Database]
+\`\`\`
 
 ## Prerequisitos Generales
-- Que se necesita instalado globalmente (node, python, java, docker, etc.)
-- Versiones requeridas
-- Servicios externos necesarios (BD, cache, etc.)
+- Node.js x.x, Python x.x, Docker, etc.
+- Bases de datos, servicios externos
 
 ## Comandos de Desarrollo Globales
-
 | Comando | Descripcion | Directorio |
 |---------|-------------|------------|
 | ... | ... | ... |
 
-=== modules/[nombre]/index.md ===
-# [nombre] — Estructura Interna
+=== [nombre]/architecture.md ===
+# [nombre] — Arquitectura Interna
 
-Descripcion general de este servicio/API y que problema resuelve.
+Descripcion de este componente y su rol en el proyecto.
 
-## Estructura del Servicio
+## Estructura Interna
 \`\`\`
 src/
-  ├── main.py          # entry point
-  ├── models/          # modelos de datos
-  └── routes/          # endpoints
+  ├── main.ts          # entry point
+  ├── config/          # configuracion
+  ├── controllers/     # endpoints
+  └── services/        # logica de negocio
 \`\`\`
 
 ## Modulos Internos
 | Modulo | Archivo | Descripcion |
 |--------|---------|-------------|
-| auth | auth.md | Autenticacion y tokens |
-| users | users.md | Gestion de usuarios |
+| config | modules/config.md | Configuracion |
+| controller | modules/controller.md | Endpoints |
 
 ## Como Levantar
-- **Dependencias:** instalar con \`npm install\` o \`pip install -r requirements.txt\`
+- **Instalar deps:** comando
 - **Servicios necesarios:** BD, redis, etc.
-- **Variables de entorno:** cuales y para que
-- **Comando para iniciar:** \`npm run dev\` o equivalente
+- **Variables de entorno:** listarlas con su proposito
+- **Comando para iniciar:** \`...\`
 
 ## Comandos Disponibles
-
 | Comando | Que hace |
 |---------|----------|
 | ... | ... |
 
-=== modules/[nombre]/[modulo].md ===
+## Comunicacion con Otros Componentes
+- A que APIs llama o que APIs lo llaman
+- Protocolo (fetch, HTTP, gRPC, etc.)
+
+=== [nombre]/modules/[modulo].md ===
 # [nombre-del-modulo]
 
 ## Funcion
-Que hace este modulo y que parte del servicio cubre.
+Que hace este modulo especifico.
 
 ## Archivo Principal
-- **Ruta:** path relativo al proyecto
-- **Funciones/Clases principales:** listar las mas importantes
+- **Ruta:** path relativo
+- **Funciones/Clases principales**
 
 ## Endpoints / Interfaces Publicas
-Si es un modulo de API:
-- \`GET /endpoint\` — descripcion
-- \`POST /endpoint\` — descripcion
-
-Si es otro tipo de modulo:
-- Funciones publicas exportadas
-- Interfaces que implementa
+Si es un controller/router:
+- \`GET /ruta\` — descripcion
+- \`POST /ruta\` — descripcion
 
 ## Dependencias
-- **Internas:** otros modulos del mismo servicio que usa
-- **Externas:** librerias de terceros especificas de este modulo
-
-## Notas
-Cualquier detalle relevante especifico de este modulo.
+- **Internas:** modulos del mismo componente
+- **Externas:** librerias de terceros
 
 REGLAS:
-- Devuelve UNICAMENTE los archivos separados por === modules/path/file.md ===
-- NO incluyas explicaciones fuera de los archivos
-- Para CADA API/servicio con modulos internos: crea modules/[nombre]/index.md + un archivo por cada modulo
-- Para directorios triviales (solo docs, configs sueltos): documenta en architecture.md sin crear subcarpeta
+- Devuelve UNICAMENTE los archivos separados por === path/file.md ===
+- NO incluyas texto explicativo fuera de los archivos
+- El archivo principal SIEMPRE es === architecture.md ===
+- Para cada componente con modulos internos: === [nombre]/architecture.md === + === [nombre]/modules/[modulo].md ===
+- Para componentes triviales (scripts, docs): solo mencionarlos en architecture.md principal
 - Documenta TODOS los directorios al nivel de DIRECTORIO_TRABAJO (excluyendo .agent)
 - Si hay documentacion existente, actualizala con los cambios detectados`;
         const res = await this.runWithFallback('explorer', prompt, 'Exploracion');
         const text = extractCliText(res);
-        // Parse the response: split by === FILENAME.md === markers
+        // Parse sections separated by === path/file.md === markers
         const sections = text.split(/===\s+(.+?\.md)\s*===/).slice(1);
         let filesWritten = 0;
         for (let i = 0; i < sections.length; i += 2) {
@@ -1133,20 +1148,30 @@ REGLAS:
             // Clean up code fences if present
             content = content.replace(/^```markdown\s*/i, '').replace(/^```\s*$/gm, '').trim();
             try {
-                if (fileName === 'ARCHITECTURE.md') {
-                    await writeFile(archPath, content);
-                    filesWritten++;
+                let targetPath;
+                if (fileName === 'architecture.md' || fileName === 'ARCHITECTURE.md') {
+                    // Main architecture doc
+                    targetPath = mainArchPath;
                 }
-                else if (fileName.toLowerCase().includes('modules/')) {
-                    // Extract the modules/ path from the marker
-                    const modMatch = fileName.match(/modules\/(.+\.md)/i);
-                    if (modMatch) {
-                        const modPath = path.join(contextDir, 'modules', modMatch[1]);
-                        await fs.mkdir(path.dirname(modPath), { recursive: true });
-                        await writeFile(modPath, content);
-                        filesWritten++;
+                else {
+                    // Component doc: [component]/architecture.md or [component]/modules/[mod].md
+                    // fileName could be: "datamart-data-access-api/architecture.md" or "datamart-data-access-api/modules/config.md"
+                    const compMatch = fileName.match(/^(.+?)\/architecture\.md$/i);
+                    const modMatch = fileName.match(/^(.+?)\/modules\/(.+\.md)$/i);
+                    if (compMatch) {
+                        targetPath = path.join(contextDir, compMatch[1], 'architecture.md');
+                    }
+                    else if (modMatch) {
+                        targetPath = path.join(contextDir, modMatch[1], 'modules', modMatch[2]);
+                    }
+                    else {
+                        // Fallback: treat as modules file in legacy modules/ dir
+                        targetPath = path.join(contextDir, 'modules', fileName.replace(/.*\//, ''));
                     }
                 }
+                await fs.mkdir(path.dirname(targetPath), { recursive: true });
+                await writeFile(targetPath, content);
+                filesWritten++;
             }
             catch (err) {
                 log.warn(`Failed to write ${fileName}: ${err.message}`);

package/dist/index.js

@@ -38,6 +38,7 @@ program
     .option('--model [cli]', 'Alias for --models')
     .option('--reset-coordinator', 'Clear coordinator selection (re-pick on next run)')
     .option('--reset-auth', 'Wipe all auth credentials and start fresh')
+    .option('--usage', 'Check quota status for all role CLIs')
     .addHelpText('after', `
 Setup subcommands:
   agent-mp setup init            Full interactive wizard (login + roles + project)
@@ -131,6 +132,22 @@ if (nativeRole) {
         }
         process.exit(0);
     }
+    // --usage: check quota status with test API call
+    if (args.includes('--usage') || args.includes('usage')) {
+        const { qwenUsage, getTokenPath } = await import('./utils/qwen-auth.js');
+        const result = await qwenUsage();
+        const exp = result.token ? new Date(result.token.expiresAt).toLocaleString() : 'N/A';
+        if (result.ok) {
+            console.log(chalk.green(`  ✓ ${PKG_NAME}: quota OK`));
+            console.log(chalk.dim(`  Token expires: ${exp}`));
+            console.log(chalk.dim(`  Model: ${result.model}`));
+        }
+        else {
+            console.log(chalk.red(`  ✗ ${PKG_NAME}: ${result.error}`));
+            console.log(chalk.dim(`  Token expires: ${exp}`));
+        }
+        process.exit(result.ok ? 0 : 1);
+    }
     // Parse --model flag if provided
     const modelIdx = args.findIndex(a => a === '--model' || a === '-m');
     let model;
@@ -150,6 +167,23 @@ if (nativeRole) {
 }
 // ─────────────────────────────────────────────────────────────────────────────
 program.action(async (task, options) => {
+    // --usage: check quota status
+    if (options.usage) {
+        const { qwenUsage } = await import('./utils/qwen-auth.js');
+        const { PKG_NAME } = await import('./utils/config.js');
+        const result = await qwenUsage();
+        const exp = result.token ? new Date(result.token.expiresAt).toLocaleString() : 'N/A';
+        if (result.ok) {
+            console.log(chalk.green(`  ✓ ${PKG_NAME}: quota OK`));
+            console.log(chalk.dim(`  Token expires: ${exp}`));
+            console.log(chalk.dim(`  Model: ${result.model}`));
+        }
+        else {
+            console.log(chalk.red(`  ✗ ${PKG_NAME}: ${result.error}`));
+            console.log(chalk.dim(`  Token expires: ${exp}`));
+        }
+        process.exit(result.ok ? 0 : 1);
+    }
     if (options.resetCoordinator || options.resetAuth) {
         const authFile = path.join(AGENT_HOME, 'auth.json');
         const qwenCreds = path.join(AGENT_HOME, 'oauth_creds.json');

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

@@ -2,6 +2,13 @@
 export declare const QWEN_AGENT_HOME: string;
 /** Dynamic getter (recommended for runtime changes) */
 export declare function getQwenHome(): string;
+interface QwenToken {
+    accessToken: string;
+    refreshToken: string;
+    expiresAt: number;
+    idToken?: string;
+    resourceUrl?: string;
+}
 export declare function getTokenPath(): Promise<string>;
 export declare function qwenLogin(): Promise<boolean>;
 export declare function qwenAuthStatus(): Promise<{
@@ -20,3 +27,11 @@ export declare function callQwenAPI(prompt: string, model?: string, onData?: (ch
  * Calls the Qwen REST API directly — no dependency on any qwen CLI binary.
  */
 export declare function callQwenAPIFromCreds(prompt: string, model: string, credsPath: string, onData?: (chunk: string) => void): Promise<string>;
+/** Check quota status by making a minimal test API call */
+export declare function qwenUsage(credsPath?: string): Promise<{
+    ok: boolean;
+    token: QwenToken | null;
+    error?: string;
+    model?: string;
+}>;
+export {};

package/dist/utils/qwen-auth.js

@@ -286,9 +286,14 @@ async function callQwenAPIWithToken(token, prompt, model, onData) {
     });
     if (!response.ok) {
         const errorText = await response.text();
-        if (response.status === 401 || (response.status === 429 && errorText.includes('insufficient_quota'))) {
+        // 401 = auth error, refresh may help
+        if (response.status === 401) {
             throw new Error(`QWEN_AUTH_EXPIRED: ${errorText}`);
         }
+        // 429 insufficient_quota = daily quota exhausted, refresh won't help
+        if (response.status === 429 && errorText.includes('insufficient_quota')) {
+            throw new Error(`QWEN_QUOTA_EXCEEDED: ${errorText}`);
+        }
         throw new Error(`Qwen API error: ${response.status} - ${errorText}`);
     }
     if (!useStream) {
@@ -342,6 +347,9 @@ export async function callQwenAPI(prompt, model = 'coder-model', onData) {
         return await callQwenAPIWithToken(token, prompt, model, onData);
     }
     catch (err) {
+        // Quota errors: refresh won't help, propagate immediately
+        if (err.message?.startsWith('QWEN_QUOTA_EXCEEDED'))
+            throw err;
         if (!err.message?.startsWith('QWEN_AUTH_EXPIRED'))
             throw err;
         if (token.refreshToken) {
@@ -390,6 +398,9 @@ export async function callQwenAPIFromCreds(prompt, model, credsPath, onData) {
         return await callQwenAPIWithToken(token, prompt, model, onData);
     }
     catch (err) {
+        // Quota errors: refresh won't help, propagate immediately
+        if (err.message?.startsWith('QWEN_QUOTA_EXCEEDED'))
+            throw err;
         if (!err.message?.startsWith('QWEN_AUTH_EXPIRED'))
             throw err;
         if (token.refreshToken) {
@@ -402,3 +413,58 @@ export async function callQwenAPIFromCreds(prompt, model, credsPath, onData) {
         throw new Error(`QWEN_AUTH_EXPIRED: Sesión expirada. Ejecutá: ${cliName} --login`);
     }
 }
+/** Check quota status by making a minimal test API call */
+export async function qwenUsage(credsPath) {
+    let token;
+    if (credsPath) {
+        try {
+            const raw = JSON.parse(await fs.readFile(credsPath, 'utf-8'));
+            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,
+            };
+        }
+        catch {
+            return { ok: false, token: null, error: 'No credentials found' };
+        }
+    }
+    else {
+        token = await loadToken();
+    }
+    if (!token || !token.accessToken) {
+        return { ok: false, token, error: 'No access token — run --login' };
+    }
+    if (token.expiresAt < Date.now()) {
+        // Try refresh
+        if (token.refreshToken) {
+            const refreshed = await doRefreshToken(token.refreshToken);
+            if (refreshed) {
+                token = refreshed;
+                if (!credsPath)
+                    await saveToken(refreshed);
+                else
+                    await fs.writeFile(credsPath, JSON.stringify(refreshed, null, 2), 'utf-8');
+            }
+            else {
+                return { ok: false, token, error: 'Token expired and refresh failed' };
+            }
+        }
+        else {
+            return { ok: false, token, error: 'Token expired, no refresh token' };
+        }
+    }
+    // Make a minimal test call to check quota
+    try {
+        const result = await callQwenAPIWithToken(token, 'ping', 'coder-model');
+        return { ok: true, token, model: 'coder-model' };
+    }
+    catch (err) {
+        if (err.message?.startsWith('QWEN_QUOTA_EXCEEDED')) {
+            return { ok: false, token, error: 'Daily quota exhausted — wait or --login with different account' };
+        }
+        return { ok: false, token, error: err.message };
+    }
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "agent-mp",
-  "version": "0.5.7",
+  "version": "0.5.9",
   "description": "Deterministic multi-agent CLI orchestrator — plan, code, review",
   "type": "module",
   "main": "./dist/index.js",