@parallel-cli/parallel 0.4.3 → 0.4.4

package/dist/config.js

@@ -280,8 +280,38 @@ export function isLocalProvider(p) {
 export function providerNeedsApiKey(p) {
     return p.requiresApiKey !== false && !isLocalProvider(p);
 }
+export function isPlaceholderModel(model) {
+    return !model.trim() || /^your-model-here$/i.test(model.trim());
+}
+export function providerHasUsableModel(p) {
+    return !isPlaceholderModel(p.defaultModel || p.models[0] || '');
+}
 export function providerReady(p) {
-    return !providerNeedsApiKey(p) || p.apiKey.trim().length > 0;
+    return (!providerNeedsApiKey(p) || p.apiKey.trim().length > 0) && providerHasUsableModel(p);
+}
+export async function detectProviderModels(provider, timeoutMs = 2000) {
+    let timeout;
+    try {
+        const controller = new AbortController();
+        timeout = setTimeout(() => controller.abort(), timeoutMs);
+        const resp = await fetch(provider.baseUrl.replace(/\/+$/, '') + '/models', { signal: controller.signal });
+        if (!resp.ok)
+            return null;
+        const data = (await resp.json());
+        const models = [
+            ...(data.data?.map((m) => m.id || m.name).filter(Boolean) ?? []),
+            ...(data.models?.map((m) => m.name).filter(Boolean) ?? []),
+        ];
+        const unique = [...new Set(models.filter((m) => !isPlaceholderModel(m)))];
+        return unique.length > 0 ? { models: unique, defaultModel: unique[0] } : null;
+    }
+    catch {
+        return null;
+    }
+    finally {
+        if (timeout)
+            clearTimeout(timeout);
+    }
 }
 export function getProvider(cfg, name) {
     const n = (name ?? cfg.defaultProvider).toLowerCase();

package/dist/controller.js

@@ -72,6 +72,7 @@ export class Controller extends EventEmitter {
     conversationFiles = new Map();
     /** The session restored at startup (source of /restore conversations). */
     loadedSession = null;
+    sessionOnlyProvider = null;
     constructor(config, projectRoot) {
         super();
         this.config = config;
@@ -108,6 +109,10 @@ export class Controller extends EventEmitter {
     // ---------- providers / models ----------
     /** Provider used by the current session (falls back to the global default). */
     sessionProvider() {
+        if (this.sessionOnlyProvider &&
+            this.session.providerName.toLowerCase() === this.sessionOnlyProvider.name.toLowerCase()) {
+            return this.sessionOnlyProvider;
+        }
         return getProvider(this.config, this.session.providerName || undefined);
     }
     /** Resolve "model" or "provider:model" against the configured providers. */
@@ -115,7 +120,10 @@ export class Controller extends EventEmitter {
         const trimmed = spec.trim();
         const sep = trimmed.indexOf(':');
         if (sep > 0) {
-            const provider = getProvider(this.config, trimmed.slice(0, sep).trim());
+            const left = trimmed.slice(0, sep).trim();
+            const provider = this.sessionOnlyProvider && this.sessionOnlyProvider.name.toLowerCase() === left.toLowerCase()
+                ? this.sessionOnlyProvider
+                : getProvider(this.config, left);
             if (provider)
                 return { provider, model: trimmed.slice(sep + 1).trim() };
         }
@@ -231,7 +239,7 @@ export class Controller extends EventEmitter {
             return;
         const [q] = this.questions.splice(idx, 1);
         this.board.log('', 'system', auto ? t('m.qAuto', { name: q.agentName, answer }) : t('m.qAnswered', { name: q.agentName, answer }));
-        q.resolve(answer);
+        q.resolve({ answer, auto });
         this.emit('update');
     }
     // ---------- agents ----------
@@ -382,7 +390,7 @@ export class Controller extends EventEmitter {
     respawnAgent(name) {
         const sa = this.loadedSession?.agents.find((a) => a.name.toLowerCase() === name.toLowerCase());
         if (!sa)
-            return 'no-conversation';
+            return 'no-agent';
         if (!sa.conversation || !fs.existsSync(sa.conversation))
             return 'no-conversation';
         let history;
@@ -427,7 +435,7 @@ export class Controller extends EventEmitter {
         for (const req of this.approvals.splice(0))
             req.resolve(false);
         for (const q of this.questions.splice(0))
-            q.resolve(q.options[q.recommended] ?? '');
+            q.resolve({ answer: q.options[q.recommended] ?? '', auto: true });
     }
     sendToAgent(name, content) {
         const a = this.findAgent(name);
@@ -438,6 +446,15 @@ export class Controller extends EventEmitter {
     }
     broadcast(content) {
         this.board.addNote('user', 'all', content);
+        let n = 0;
+        for (const [id, agent] of this.agents.entries()) {
+            const info = this.board.agents.get(id);
+            if (!info || ['done', 'error', 'stopped'].includes(info.state))
+                continue;
+            agent.instruct(content);
+            n++;
+        }
+        return n;
     }
     hasRunningAgents() {
         return [...this.board.agents.values()].some((a) => ['working', 'thinking', 'listening', 'waiting', 'paused', 'idle'].includes(a.state));
@@ -464,8 +481,10 @@ export class Controller extends EventEmitter {
                 continue;
             const conflict = this.board.changes.some((c2) => c2.id > c.id && c2.path === c.path && c2.agentId !== info.id);
             try {
-                const abs = path.resolve(this.projectRoot, c.path);
-                if (!abs.startsWith(path.resolve(this.projectRoot)))
+                const root = path.resolve(this.projectRoot);
+                const abs = path.resolve(root, c.path);
+                const rel = path.relative(root, abs);
+                if (rel.startsWith('..') || path.isAbsolute(rel))
                     return 'none';
                 fs.writeFileSync(abs, c.before);
             }
@@ -630,7 +649,7 @@ export class Controller extends EventEmitter {
                 return { file, data: JSON.parse(fs.readFileSync(file, 'utf8')) };
             })
                 .sort((a, b) => (a.data.savedAt < b.data.savedAt ? 1 : -1))
-                .slice(0, 8);
+                .slice(0, 20);
         }
         catch {
             return [];
@@ -671,11 +690,19 @@ export class Controller extends EventEmitter {
         const p = getProvider(this.config, name);
         if (!p)
             return false;
+        this.sessionOnlyProvider = null;
         this.session.providerName = p.name;
         this.session.model = p.defaultModel || p.models[0] || '';
         this.emit('update');
         return true;
     }
+    setSessionProviderConfig(p) {
+        this.sessionOnlyProvider = p;
+        this.session.providerName = p.name;
+        this.session.model = p.defaultModel || p.models[0] || '';
+        this.llmCache.clear();
+        this.emit('update');
+    }
     setSessionApprovalMode(mode) {
         this.session.approvalMode = mode;
         this.emit('update');
@@ -687,6 +714,8 @@ export class Controller extends EventEmitter {
     // ---------- GLOBAL settings (/settings) — persisted ----------
     saveProvider(p) {
         upsertProvider(this.config, p);
+        if (this.sessionOnlyProvider?.name.toLowerCase() === p.name.toLowerCase())
+            this.sessionOnlyProvider = null;
         this.llmCache.clear();
         // if the session points at this provider, refresh its view
         if (this.session.providerName.toLowerCase() === p.name.toLowerCase()) {

package/dist/i18n.js

@@ -105,7 +105,7 @@ const en = {
     'notes.empty': 'No notes exchanged yet.',
     'sessions.title': '📂 SAVED SESSIONS',
     'sessions.empty': 'No saved sessions for this project yet.',
-    'sessions.item': '{date} · {agents} agent(s)',
+    'sessions.item': '{name}{date} · {agents} agent(s)',
     'sessions.hint': 'Restore one with /session <n> or /session latest. New launches start fresh by default.',
     'diff.title': '± LIVE DIFFS — {total} change(s) total (last 4 shown)',
     'diff.empty': 'No file changes yet.',
@@ -121,7 +121,7 @@ const en = {
     'help.l2d': ' for everyone).',
     'help.l3': "Agents see each other's statuses and diffs before every action: they co-edit the same files without blocking and without breaking each other's work.",
     'help.states': 'States: 🔨 working · 👂 listening to other agents (double border) · 🧠 thinking · ✋ waiting for your approval · ⏹ stop. Sounds: 1 beep = agent launched/finished, 2 beeps = approval required (/sound off to mute).',
-    'help.keys': 'Esc: back to agents view · Tab: completion · ↑/↓: suggestions, history, or view scroll · Ctrl+V: paste image',
+    'help.keys': 'Esc: back to agents view · Tab: completion · PgUp/PgDn: hub/focus scroll · ↑/↓: suggestions, history, or view scroll · Ctrl+V: paste image',
     // commands (descriptions)
     'cmd.ask': 'Ask-only agent: answers and advises without editing',
     'cmd.task': 'Task agent: executes, edits, validates, summarizes',
@@ -156,7 +156,7 @@ const en = {
     'cmd.model': 'Show/change the session model ([provider:]model)',
     'cmd.sessions': 'List saved sessions for this project',
     'cmd.session': 'Restore a saved session by number, or latest',
-    'cmd.doctor': 'Check provider/model/API key configuration and repair hints',
+    'cmd.doctor': 'Run local readiness diagnostics',
     'cmd.settings': 'Global settings — providers, API keys, language, defaults (persisted)',
     'cmd.ssettings': 'Session settings — model, approvals, sound (this session only)',
     'cmd.project': 'Change project folder or reopen folder picker',
@@ -175,7 +175,7 @@ const en = {
     'm.usageAsk': 'Usage: /ask [Name:] <question> [--model=m] — advisory only, no edits.',
     'm.usageSpawn': 'Usage: /task [Name:] <task> [--model=m]',
     'm.usageAt': 'Usage: @Agent <message>  (or @all <message>)',
-    'm.broadcast': '✉ Instruction broadcast to all agents.',
+    'm.broadcast': '✉ Instruction sent to {n} active agent(s).',
     'm.sent': '✉ Instruction sent to {target}.',
     'm.notFound': 'Agent not found: {target} (agents: {list})',
     'm.none': 'none',
@@ -206,14 +206,15 @@ const en = {
     'm.focusHint': '🎯 focus {name} · type to talk to it · PgUp/PgDn scroll · Esc to exit',
     'm.usageRestore': 'Usage: /restore <agent> (after loading a session via /session)',
     'm.restored': '⏪ {name} relaunched with its previous conversation.',
+    'm.noRestoredAgent': 'No agent named "{name}" in the restored session.',
     'm.noConversation': 'No saved conversation for "{name}" in the restored session.',
     'm.conflict': '⚠ {path}: repeated collisions between agents — consider arbitrating (@agent or /focus).',
     'status.bar': '⚡ {agents} agent(s) · {active} active · {cost}',
     'cmd.plan': 'Plan agent: presents its plan, edits only after your approval',
-    'cmd.issue': 'spawn an agent on a GitHub issue (needs the gh CLI)',
+    'cmd.issue': 'spawn an agent on a GitHub issue (needs gh, a GitHub repo, and auth)',
     'cmd.undo': "revert the agent's last file change",
-    'cmd.commit': 'git-commit the files touched by an agent (or all)',
-    'cmd.autocommit': 'auto-commit each agent’s files when it finishes',
+    'cmd.commit': 'git-commit only files touched by an agent (or all)',
+    'cmd.autocommit': 'session-only auto-commit of each agent’s files when it finishes',
     'm.usagePlan': 'Usage: /plan [Name:] <task> — the agent presents its plan and waits for your approval before editing.',
     'm.usageIssue': 'Usage: /issue <number> — spawns an agent on this GitHub issue (gh CLI required).',
     'm.ghMissing': '✗ gh CLI not found. Install it (https://cli.github.com) then `gh auth login`.',
@@ -253,14 +254,34 @@ const en = {
     'm.copyNone': 'No completed agent output to copy.',
     'm.copyDone': 'Copied latest result from {name}.',
     'm.unknown': 'Unknown command: {cmd} — type /help',
+    'm.projectActive': 'Active agents are running. Save/stop them first, or rerun with /project [folder] --force.',
+    'm.wizardActive': 'Active agents are running. Save/stop them first, or rerun with /wizard --force.',
     'm.imagesIgnored': 'Note: attached images are only supported when launching a new agent.',
     'm.sessionRestored': '📂 Session from {date} restored.',
     'm.usageSession': 'Usage: /sessions to list, then /session <n> or /session latest',
     'm.sessionLoaded': '📂 Session from {date} loaded.',
+    'm.sessionActive': 'Active agents are running. Save/stop them first, or rerun with /session <n|latest> --force.',
+    'm.sessionRestoreHint': 'Run /restore <agent> to relaunch a saved agent conversation.',
     'm.missingProvider': 'No provider configured. Open /settings → Add a provider, or restart with a first-run config.',
     'm.missingKey': 'Provider {name} has no API key. Use /settings → Providers → API key.',
     'm.missingModel': 'Provider {name} has no default model. Use /settings → Provider models.',
     'm.doctorOk': '✓ Configuration ready: {pm}. Changes: /settings · temporary model: /model [provider:]model',
+    'm.doctorReport': 'Doctor\n{lines}',
+    'm.doctorNoProvider': '✗ No provider configured. Open /settings → Add a provider.',
+    'm.doctorProvider': '• Provider: {provider}:{model}',
+    'm.doctorKeyMissing': '✗ API key missing. Open /settings → Providers → API key.',
+    'm.doctorKeyOk': '✓ API key present.',
+    'm.doctorKeySkipped': '✓ API key not required for this local provider.',
+    'm.doctorModelMissing': '✗ Model missing or still set to placeholder. Choose a real model in /settings or /model.',
+    'm.doctorModelOk': '✓ Model ready: {model}',
+    'm.doctorEndpointOk': '✓ Local endpoint reachable: {url}',
+    'm.doctorEndpointFail': '⚠ Local endpoint not reachable: {url}',
+    'm.doctorAttachOk': '✓ Attach socket is available.',
+    'm.doctorAttachMissing': '⚠ Attach socket is not running yet.',
+    'm.doctorGitOk': '✓ git CLI found.',
+    'm.doctorGitMissing': '⚠ git CLI not found.',
+    'm.doctorGhOk': '✓ gh CLI found for /issue.',
+    'm.doctorGhMissing': '⚠ gh CLI not found; /issue needs gh and GitHub auth.',
     'm.spawnFail': 'Cannot launch the agent: no usable provider/model. Configure one via /settings.',
     // settings panels
     'set.title': '⚙ SETTINGS — global (persisted in ~/.parallel/config.json)',
@@ -277,8 +298,13 @@ const en = {
     'set.sound': 'Default sound: {state}',
     'set.back': '← Back',
     'set.saved': '✓ Saved to ~/.parallel/config.json',
+    'set.sessionProviderReady': '✓ {name} is ready for this session only.',
+    'set.setupScope.title': 'Use {name} only now, or save it globally?',
+    'set.setupScope.session': 'Use this session only',
+    'set.setupScope.global': 'Save globally',
     'set.chooseProvider': 'Choose a provider',
     'set.chooseModel': 'Model ({name}) — pick or type a name from the provider docs',
+    'set.modelPlaceholder': 'Choose or type a real model name first. `your-model-here` is only a placeholder.',
     'sset.model': 'Session model: {pm}',
     'sset.approvals': 'Shell approvals (session): {mode}',
     'sset.sound': 'Sound (session): {state}',
@@ -453,7 +479,7 @@ const fr = {
     'notes.empty': 'Aucune note échangée pour le moment.',
     'sessions.title': '📂 SESSIONS SAUVEGARDÉES',
     'sessions.empty': 'Aucune session sauvegardée pour ce projet.',
-    'sessions.item': '{date} · {agents} agent(s)',
+    'sessions.item': '{name}{date} · {agents} agent(s)',
     'sessions.hint': 'Restaure avec /session <n> ou /session latest. Les nouveaux lancements démarrent vierges par défaut.',
     'diff.title': '± DIFFS EN DIRECT — {total} modification(s) au total (4 dernières affichées)',
     'diff.empty': 'Aucune modification de fichier pour le moment.',
@@ -469,7 +495,7 @@ const fr = {
     'help.l2d': ' pour tous).',
     'help.l3': 'Les agents voient mutuellement leurs statuts et leurs diffs avant chaque action : ils co-éditent les mêmes fichiers sans se bloquer et sans casser le travail des autres.',
     'help.states': "États : 🔨 travaille · 👂 écoute les autres agents (double bordure) · 🧠 réfléchit · ✋ attend ton approbation · ⏹ stop. Sons : 1 bip = agent lancé/terminé, 2 bips = approbation requise (/sound off pour couper).",
-    'help.keys': 'Esc : revenir à la vue agents · Tab : complétion · ↑/↓ : suggestions, historique ou scroll selon la vue · Ctrl+V : coller une image',
+    'help.keys': 'Esc : revenir à la vue agents · Tab : complétion · PgUp/PgDn : scroll hub/focus · ↑/↓ : suggestions, historique ou scroll selon la vue · Ctrl+V : coller une image',
     'cmd.ask': 'Agent ask : répond et conseille sans modifier',
     'cmd.task': 'Agent task : exécute, modifie, valide, résume',
     'cmd.agents': 'Vue panneaux agents (temps réel)',
@@ -503,7 +529,7 @@ const fr = {
     'cmd.model': 'Afficher/changer le modèle de la session ([provider:]modèle)',
     'cmd.sessions': 'Lister les sessions sauvegardées de ce projet',
     'cmd.session': 'Restaurer une session sauvegardée par numéro, ou latest',
-    'cmd.doctor': 'Vérifier provider/modèle/clef API et afficher les corrections',
+    'cmd.doctor': 'Lancer les diagnostics locaux de readiness',
     'cmd.settings': 'Réglages globaux — providers, clefs API, langue, défauts (persistés)',
     'cmd.ssettings': 'Réglages de session — modèle, approbations, son (cette session)',
     'cmd.project': 'Changer de dossier projet ou rouvrir le choix de dossier',
@@ -521,7 +547,7 @@ const fr = {
     'm.usageAsk': 'Usage : /ask [Nom:] <question> [--model=m] — conseil uniquement, aucune modification.',
     'm.usageSpawn': 'Usage : /task [Nom:] <tâche> [--model=m]',
     'm.usageAt': 'Usage : @Agent <message>  (ou @all <message>)',
-    'm.broadcast': '✉ Instruction diffusée à tous les agents.',
+    'm.broadcast': '✉ Instruction envoyée à {n} agent(s) actif(s).',
     'm.sent': '✉ Instruction envoyée à {target}.',
     'm.notFound': 'Agent introuvable : {target} (agents : {list})',
     'm.none': 'aucun',
@@ -552,14 +578,15 @@ const fr = {
     'm.focusHint': '🎯 focus {name} · tapez pour lui parler · PgUp/PgDn défilement · Échap pour sortir',
     'm.usageRestore': 'Usage : /restore <agent> (après avoir chargé une session via /session)',
     'm.restored': '⏪ {name} relancé avec sa conversation précédente.',
+    'm.noRestoredAgent': 'Aucun agent nommé « {name} » dans la session restaurée.',
     'm.noConversation': 'Aucune conversation sauvegardée pour « {name} » dans la session restaurée.',
     'm.conflict': '⚠ {path} : collisions répétées entre agents — pensez à arbitrer (@agent ou /focus).',
     'status.bar': '⚡ {agents} agent(s) · {active} actif(s) · {cost}',
     'cmd.plan': "Agent plan : présente son plan, ne modifie qu'après votre accord",
-    'cmd.issue': 'lance un agent sur une issue GitHub (CLI gh requise)',
+    'cmd.issue': 'lance un agent sur une issue GitHub (gh, repo GitHub et auth requis)',
     'cmd.undo': "annule la dernière modification de fichier de l'agent",
-    'cmd.commit': 'git-commit des fichiers touchés par un agent (ou tous)',
-    'cmd.autocommit': 'commit auto des fichiers de chaque agent quand il termine',
+    'cmd.commit': 'git-commit seulement les fichiers touchés par un agent (ou tous)',
+    'cmd.autocommit': 'commit auto session-only des fichiers de chaque agent quand il termine',
     'm.usagePlan': "Usage : /plan [Nom:] <tâche> — l'agent présente son plan et attend votre accord avant de modifier.",
     'm.usageIssue': 'Usage : /issue <numéro> — lance un agent sur cette issue GitHub (CLI gh requise).',
     'm.ghMissing': '✗ CLI gh introuvable. Installez-la (https://cli.github.com) puis `gh auth login`.',
@@ -599,14 +626,34 @@ const fr = {
     'm.copyNone': "Aucun résultat d'agent à copier.",
     'm.copyDone': 'Dernier résultat de {name} copié.',
     'm.unknown': 'Commande inconnue : {cmd} — tape /help',
+    'm.projectActive': 'Des agents sont actifs. Sauvegarde/arrête-les d’abord, ou relance avec /project [dossier] --force.',
+    'm.wizardActive': 'Des agents sont actifs. Sauvegarde/arrête-les d’abord, ou relance avec /wizard --force.',
     'm.imagesIgnored': "Note : les images jointes ne sont prises en compte qu'au lancement d'un nouvel agent.",
     'm.sessionRestored': '📂 Session du {date} restaurée.',
     'm.usageSession': 'Usage : /sessions pour lister, puis /session <n> ou /session latest',
     'm.sessionLoaded': '📂 Session du {date} chargée.',
+    'm.sessionActive': 'Des agents sont actifs. Sauvegarde/arrête-les d’abord, ou relance avec /session <n|latest> --force.',
+    'm.sessionRestoreHint': 'Lance /restore <agent> pour relancer une conversation agent sauvegardée.',
     'm.missingProvider': 'Aucun provider configuré. Ouvre /settings → Ajouter un provider, ou relance une première config.',
     'm.missingKey': 'Le provider {name} n’a pas de clef API. Utilise /settings → Providers → Clef API.',
     'm.missingModel': 'Le provider {name} n’a pas de modèle par défaut. Utilise /settings → Modèles du provider.',
     'm.doctorOk': '✓ Configuration prête : {pm}. Changements : /settings · modèle temporaire : /model [provider:]modèle',
+    'm.doctorReport': 'Doctor\n{lines}',
+    'm.doctorNoProvider': '✗ Aucun provider configuré. Ouvre /settings → Add a provider.',
+    'm.doctorProvider': '• Provider : {provider}:{model}',
+    'm.doctorKeyMissing': '✗ Clef API manquante. Ouvre /settings → Providers → Clef API.',
+    'm.doctorKeyOk': '✓ Clef API présente.',
+    'm.doctorKeySkipped': '✓ Clef API non requise pour ce provider local.',
+    'm.doctorModelMissing': '✗ Modèle manquant ou encore sur le placeholder. Choisis un vrai modèle dans /settings ou /model.',
+    'm.doctorModelOk': '✓ Modèle prêt : {model}',
+    'm.doctorEndpointOk': '✓ Endpoint local joignable : {url}',
+    'm.doctorEndpointFail': '⚠ Endpoint local non joignable : {url}',
+    'm.doctorAttachOk': '✓ Socket attach disponible.',
+    'm.doctorAttachMissing': '⚠ Socket attach pas encore lancé.',
+    'm.doctorGitOk': '✓ CLI git trouvé.',
+    'm.doctorGitMissing': '⚠ CLI git introuvable.',
+    'm.doctorGhOk': '✓ CLI gh trouvé pour /issue.',
+    'm.doctorGhMissing': '⚠ CLI gh introuvable ; /issue nécessite gh et une auth GitHub.',
     'm.spawnFail': "Impossible de lancer l'agent : aucun provider/modèle utilisable. Configure-en un via /settings.",
     'set.title': '⚙ RÉGLAGES — globaux (persistés dans ~/.parallel/config.json)',
     'sset.title': '⚙ RÉGLAGES DE SESSION — cette session uniquement (globaux : /settings)',
@@ -622,8 +669,13 @@ const fr = {
     'set.sound': 'Son par défaut : {state}',
     'set.back': '← Retour',
     'set.saved': '✓ Enregistré dans ~/.parallel/config.json',
+    'set.sessionProviderReady': '✓ {name} est prêt pour cette session seulement.',
+    'set.setupScope.title': 'Utiliser {name} seulement maintenant, ou le sauvegarder globalement ?',
+    'set.setupScope.session': 'Utiliser pour cette session seulement',
+    'set.setupScope.global': 'Sauvegarder globalement',
     'set.chooseProvider': 'Choisis un provider',
     'set.chooseModel': 'Modèle ({name}) — choisis ou tape un nom selon la doc du provider',
+    'set.modelPlaceholder': 'Choisis ou tape d’abord un vrai nom de modèle. `your-model-here` est seulement un placeholder.',
     'sset.model': 'Modèle de session : {pm}',
     'sset.approvals': 'Approbations shell (session) : {mode}',
     'sset.sound': 'Son (session) : {state}',
@@ -792,7 +844,7 @@ const es = {
     'notes.empty': 'Aún no se han intercambiado notas.',
     'sessions.title': '📂 SESIONES GUARDADAS',
     'sessions.empty': 'Aún no hay sesiones guardadas para este proyecto.',
-    'sessions.item': '{date} · {agents} agente(s)',
+    'sessions.item': '{name}{date} · {agents} agente(s)',
     'sessions.hint': 'Restaura una con /session <n> o /session latest. Los nuevos lanzamientos empiezan vacíos por defecto.',
     'diff.title': '± DIFFS EN VIVO — {total} cambio(s) en total (últimos 4 mostrados)',
     'diff.empty': 'Sin cambios de archivos por ahora.',
@@ -808,7 +860,7 @@ const es = {
     'help.l2d': ' para todos).',
     'help.l3': 'Los agentes ven los estados y diffs de los demás antes de cada acción: co-editan los mismos archivos sin bloquearse y sin romper el trabajo ajeno.',
     'help.states': 'Estados: 🔨 trabajando · 👂 escuchando a otros agentes (borde doble) · 🧠 pensando · ✋ esperando tu aprobación · ⏹ stop. Sonidos: 1 bip = agente lanzado/terminado, 2 bips = aprobación requerida (/sound off para silenciar).',
-    'help.keys': 'Esc: volver a la vista de agentes · Tab: autocompletar · ↑/↓: sugerencias, historial o scroll de vista · Ctrl+V: pegar imagen',
+    'help.keys': 'Esc: volver a la vista de agentes · Tab: autocompletar · PgUp/PgDn: scroll hub/focus · ↑/↓: sugerencias, historial o scroll de vista · Ctrl+V: pegar imagen',
     'cmd.ask': 'Agente ask: responde y aconseja sin editar',
     'cmd.task': 'Agente task: ejecuta, edita, valida y resume',
     'cmd.agents': 'Vista de paneles de agentes (tiempo real)',
@@ -842,7 +894,7 @@ const es = {
     'cmd.model': 'Mostrar/cambiar el modelo de la sesión ([proveedor:]modelo)',
     'cmd.sessions': 'Listar las sesiones guardadas de este proyecto',
     'cmd.session': 'Restaurar una sesión guardada por número, o latest',
-    'cmd.doctor': 'Comprobar proveedor/modelo/clave API y mostrar correcciones',
+    'cmd.doctor': 'Ejecutar diagnósticos locales de readiness',
     'cmd.settings': 'Ajustes globales — proveedores, claves API, idioma, valores por defecto (persistentes)',
     'cmd.ssettings': 'Ajustes de sesión — modelo, aprobaciones, sonido (solo esta sesión)',
     'cmd.project': 'Cambiar carpeta del proyecto o reabrir selector de carpeta',
@@ -860,7 +912,7 @@ const es = {
     'm.usageAsk': 'Uso: /ask [Nombre:] <pregunta> [--model=m] — solo asesoría, sin ediciones.',
     'm.usageSpawn': 'Uso: /task [Nombre:] <tarea> [--model=m]',
     'm.usageAt': 'Uso: @Agente <mensaje>  (o @all <mensaje>)',
-    'm.broadcast': '✉ Instrucción difundida a todos los agentes.',
+    'm.broadcast': '✉ Instrucción enviada a {n} agente(s) activo(s).',
     'm.sent': '✉ Instrucción enviada a {target}.',
     'm.notFound': 'Agente no encontrado: {target} (agentes: {list})',
     'm.none': 'ninguno',
@@ -891,14 +943,15 @@ const es = {
     'm.focusHint': '🎯 foco {name} · escribe para hablarle · PgUp/PgDn desplazamiento · Esc para salir',
     'm.usageRestore': 'Uso: /restore <agente> (tras cargar una sesión con /session)',
     'm.restored': '⏪ {name} relanzado con su conversación anterior.',
+    'm.noRestoredAgent': 'No hay ningún agente llamado "{name}" en la sesión restaurada.',
     'm.noConversation': 'No hay conversación guardada para "{name}" en la sesión restaurada.',
     'm.conflict': '⚠ {path}: colisiones repetidas entre agentes — considera arbitrar (@agente o /focus).',
     'status.bar': '⚡ {agents} agente(s) · {active} activo(s) · {cost}',
     'cmd.plan': 'Agente plan: presenta su plan, solo edita tras tu aprobación',
-    'cmd.issue': 'lanza un agente sobre una issue de GitHub (requiere la CLI gh)',
+    'cmd.issue': 'lanza un agente sobre una issue de GitHub (requiere gh, repo GitHub y auth)',
     'cmd.undo': 'revierte el último cambio de archivo del agente',
-    'cmd.commit': 'git-commit de los archivos tocados por un agente (o todos)',
-    'cmd.autocommit': 'commit automático de los archivos de cada agente al terminar',
+    'cmd.commit': 'git-commit solo de archivos tocados por un agente (o todos)',
+    'cmd.autocommit': 'commit automático session-only de archivos de cada agente al terminar',
     'm.usagePlan': 'Uso: /plan [Nombre:] <tarea> — el agente presenta su plan y espera tu aprobación antes de editar.',
     'm.usageIssue': 'Uso: /issue <número> — lanza un agente sobre esa issue de GitHub (requiere la CLI gh).',
     'm.ghMissing': '✗ CLI gh no encontrada. Instálala (https://cli.github.com) y ejecuta `gh auth login`.',
@@ -938,14 +991,34 @@ const es = {
     'm.copyNone': 'No hay resultado de agente que copiar.',
     'm.copyDone': 'Último resultado de {name} copiado.',
     'm.unknown': 'Comando desconocido: {cmd} — escribe /help',
+    'm.projectActive': 'Hay agentes activos. Guarda/deténlos primero, o vuelve a ejecutar con /project [carpeta] --force.',
+    'm.wizardActive': 'Hay agentes activos. Guarda/deténlos primero, o vuelve a ejecutar con /wizard --force.',
     'm.imagesIgnored': 'Nota: las imágenes adjuntas solo se tienen en cuenta al lanzar un agente nuevo.',
     'm.sessionRestored': '📂 Sesión del {date} restaurada.',
     'm.usageSession': 'Uso: /sessions para listar, luego /session <n> o /session latest',
     'm.sessionLoaded': '📂 Sesión del {date} cargada.',
+    'm.sessionActive': 'Hay agentes activos. Guárdalos/deténlos primero, o vuelve a ejecutar con /session <n|latest> --force.',
+    'm.sessionRestoreHint': 'Ejecuta /restore <agente> para relanzar una conversación guardada.',
     'm.missingProvider': 'No hay proveedor configurado. Abre /settings → Añadir proveedor, o reinicia con configuración inicial.',
     'm.missingKey': 'El proveedor {name} no tiene clave API. Usa /settings → Providers → Clave API.',
     'm.missingModel': 'El proveedor {name} no tiene modelo por defecto. Usa /settings → Modelos del proveedor.',
     'm.doctorOk': '✓ Configuración lista: {pm}. Cambios: /settings · modelo temporal: /model [proveedor:]modelo',
+    'm.doctorReport': 'Doctor\n{lines}',
+    'm.doctorNoProvider': '✗ No hay proveedor configurado. Abre /settings → Add a provider.',
+    'm.doctorProvider': '• Proveedor: {provider}:{model}',
+    'm.doctorKeyMissing': '✗ Falta la clave API. Abre /settings → Providers → Clave API.',
+    'm.doctorKeyOk': '✓ Clave API presente.',
+    'm.doctorKeySkipped': '✓ Este proveedor local no requiere clave API.',
+    'm.doctorModelMissing': '✗ Falta el modelo o sigue usando el placeholder. Elige un modelo real en /settings o /model.',
+    'm.doctorModelOk': '✓ Modelo listo: {model}',
+    'm.doctorEndpointOk': '✓ Endpoint local accesible: {url}',
+    'm.doctorEndpointFail': '⚠ Endpoint local no accesible: {url}',
+    'm.doctorAttachOk': '✓ Socket attach disponible.',
+    'm.doctorAttachMissing': '⚠ Socket attach aún no está activo.',
+    'm.doctorGitOk': '✓ CLI git encontrado.',
+    'm.doctorGitMissing': '⚠ CLI git no encontrado.',
+    'm.doctorGhOk': '✓ CLI gh encontrado para /issue.',
+    'm.doctorGhMissing': '⚠ CLI gh no encontrado; /issue necesita gh y auth de GitHub.',
     'm.spawnFail': 'No se puede lanzar el agente: ningún provider/modelo utilizable. Configura uno con /settings.',
     'set.title': '⚙ AJUSTES — globales (persistentes en ~/.parallel/config.json)',
     'sset.title': '⚙ AJUSTES DE SESIÓN — solo esta sesión (globales: /settings)',
@@ -961,8 +1034,13 @@ const es = {
     'set.sound': 'Sonido por defecto: {state}',
     'set.back': '← Volver',
     'set.saved': '✓ Guardado en ~/.parallel/config.json',
+    'set.sessionProviderReady': '✓ {name} está listo solo para esta sesión.',
+    'set.setupScope.title': '¿Usar {name} solo ahora o guardarlo globalmente?',
+    'set.setupScope.session': 'Usar solo en esta sesión',
+    'set.setupScope.global': 'Guardar globalmente',
     'set.chooseProvider': 'Elige un proveedor',
     'set.chooseModel': 'Modelo ({name}) — elige o escribe un nombre según la doc del proveedor',
+    'set.modelPlaceholder': 'Elige o escribe primero un modelo real. `your-model-here` es solo un placeholder.',
     'sset.model': 'Modelo de sesión: {pm}',
     'sset.approvals': 'Aprobaciones shell (sesión): {mode}',
     'sset.sound': 'Sonido (sesión): {state}',
@@ -1131,7 +1209,7 @@ const zh = {
     'notes.empty': '尚未交换任何便签。',
     'sessions.title': '📂 已保存会话',
     'sessions.empty': '此项目暂无已保存会话。',
-    'sessions.item': '{date} · {agents} 个智能体',
+    'sessions.item': '{name}{date} · {agents} 个智能体',
     'sessions.hint': '用 /session <n> 或 /session latest 恢复。新的启动默认从空会话开始。',
     'diff.title': '± 实时差异 — 共 {total} 处修改（显示最近 4 处）',
     'diff.empty': '暂无文件修改。',
@@ -1147,7 +1225,7 @@ const zh = {
     'help.l2d': ' 发给所有）。',
     'help.l3': '每次行动前，智能体都能看到彼此的状态和差异：它们共同编辑同一批文件，互不阻塞，也不破坏彼此的工作。',
     'help.states': '状态：🔨 工作中 · 👂 倾听其他智能体（双边框）· 🧠 思考中 · ✋ 等待你的批准 · ⏹ 停止。声音：1 声 = 智能体启动/完成，2 声 = 需要批准（/sound off 静音）。',
-    'help.keys': 'Esc：返回智能体视图 · Tab：补全 · ↑/↓：建议、历史或视图滚动 · Ctrl+V：粘贴图片',
+    'help.keys': 'Esc：返回智能体视图 · Tab：补全 · PgUp/PgDn：hub/focus 滚动 · ↑/↓：建议、历史或视图滚动 · Ctrl+V：粘贴图片',
     'cmd.ask': 'Ask 智能体：只回答和建议，不编辑',
     'cmd.task': 'Task 智能体：执行、编辑、验证并总结',
     'cmd.agents': '智能体面板视图（实时）',
@@ -1181,7 +1259,7 @@ const zh = {
     'cmd.model': '显示/更改会话模型（[提供商:]模型）',
     'cmd.sessions': '列出此项目的已保存会话',
     'cmd.session': '按编号或 latest 恢复已保存会话',
-    'cmd.doctor': '检查提供商/模型/API 密钥配置并显示修复提示',
+    'cmd.doctor': '运行本地就绪诊断',
     'cmd.settings': '全局设置 — 提供商、API 密钥、语言、默认值（持久化）',
     'cmd.ssettings': '会话设置 — 模型、批准、声音（仅本会话）',
     'cmd.project': '更改项目文件夹或重新打开文件夹选择器',
@@ -1199,7 +1277,7 @@ const zh = {
     'm.usageAsk': '用法：/ask [名称:] <问题> [--model=m] — 仅建议，不修改。',
     'm.usageSpawn': '用法：/task [名称:] <任务> [--model=m]',
     'm.usageAt': '用法：@智能体 <消息>（或 @all <消息>）',
-    'm.broadcast': '✉ 指令已广播给所有智能体。',
+    'm.broadcast': '✉ 指令已发送给 {n} 个活动智能体。',
     'm.sent': '✉ 指令已发送给 {target}。',
     'm.notFound': '找不到智能体：{target}（现有：{list}）',
     'm.none': '无',
@@ -1230,14 +1308,15 @@ const zh = {
     'm.focusHint': '🎯 聚焦 {name} · 直接输入与它对话 · PgUp/PgDn 滚动 · Esc 退出',
     'm.usageRestore': '用法：/restore <代理>（先用 /session 加载会话）',
     'm.restored': '⏪ {name} 已带着之前的对话重新启动。',
+    'm.noRestoredAgent': '恢复的会话中没有名为「{name}」的代理。',
     'm.noConversation': '恢复的会话中没有「{name}」的已保存对话。',
     'm.conflict': '⚠ {path}：代理之间反复冲突 — 建议你介入仲裁（@代理 或 /focus）。',
     'status.bar': '⚡ {agents} 个代理 · {active} 个活跃 · {cost}',
     'cmd.plan': 'Plan 智能体：先给出计划，你批准后才开始修改',
-    'cmd.issue': '基于 GitHub issue 启动代理（需要 gh CLI）',
+    'cmd.issue': '基于 GitHub issue 启动代理（需要 gh、GitHub 仓库和登录）',
     'cmd.undo': '撤销该代理最近一次文件修改',
-    'cmd.commit': '把某个代理（或全部）改动的文件做 git 提交',
-    'cmd.autocommit': '每个代理完成任务时自动提交其文件',
+    'cmd.commit': '仅提交某个代理（或全部）改动过的文件',
+    'cmd.autocommit': '会话内自动提交每个代理完成时改动过的文件',
     'm.usagePlan': '用法：/plan [名称:] <任务> — 代理先呈现计划，获得你的批准后才开始修改。',
     'm.usageIssue': '用法：/issue <编号> — 基于该 GitHub issue 启动代理（需要 gh CLI）。',
     'm.ghMissing': '✗ 未找到 gh CLI。请安装（https://cli.github.com）并执行 `gh auth login`。',
@@ -1277,14 +1356,34 @@ const zh = {
     'm.copyNone': '没有可复制的已完成智能体输出。',
     'm.copyDone': '已复制 {name} 的最新结果。',
     'm.unknown': '未知命令：{cmd} — 输入 /help',
+    'm.projectActive': '仍有活动智能体。请先保存/停止，或使用 /project [文件夹] --force。',
+    'm.wizardActive': '仍有活动智能体。请先保存/停止，或使用 /wizard --force。',
     'm.imagesIgnored': '注意：附加的图片仅在启动新智能体时生效。',
     'm.sessionRestored': '📂 已恢复 {date} 的会话。',
     'm.usageSession': '用法：先用 /sessions 列出，然后 /session <n> 或 /session latest',
     'm.sessionLoaded': '📂 已加载 {date} 的会话。',
+    'm.sessionActive': '仍有活动代理。请先保存/停止，或使用 /session <n|latest> --force。',
+    'm.sessionRestoreHint': '运行 /restore <代理> 重新启动已保存的代理对话。',
     'm.missingProvider': '未配置提供商。打开 /settings → 添加提供商，或重新进行首次配置。',
     'm.missingKey': '提供商 {name} 没有 API 密钥。使用 /settings → Providers → API 密钥。',
     'm.missingModel': '提供商 {name} 没有默认模型。使用 /settings → 提供商模型。',
     'm.doctorOk': '✓ 配置就绪：{pm}。修改：/settings · 临时模型：/model [提供商:]模型',
+    'm.doctorReport': 'Doctor\n{lines}',
+    'm.doctorNoProvider': '✗ 未配置提供商。打开 /settings → Add a provider。',
+    'm.doctorProvider': '• 提供商：{provider}:{model}',
+    'm.doctorKeyMissing': '✗ 缺少 API 密钥。打开 /settings → Providers → API 密钥。',
+    'm.doctorKeyOk': '✓ API 密钥已设置。',
+    'm.doctorKeySkipped': '✓ 此本地提供商不需要 API 密钥。',
+    'm.doctorModelMissing': '✗ 模型缺失或仍是占位符。请在 /settings 或 /model 选择真实模型。',
+    'm.doctorModelOk': '✓ 模型就绪：{model}',
+    'm.doctorEndpointOk': '✓ 本地端点可访问：{url}',
+    'm.doctorEndpointFail': '⚠ 本地端点不可访问：{url}',
+    'm.doctorAttachOk': '✓ attach socket 可用。',
+    'm.doctorAttachMissing': '⚠ attach socket 尚未运行。',
+    'm.doctorGitOk': '✓ 找到 git CLI。',
+    'm.doctorGitMissing': '⚠ 未找到 git CLI。',
+    'm.doctorGhOk': '✓ 找到 gh CLI，可用于 /issue。',
+    'm.doctorGhMissing': '⚠ 未找到 gh CLI；/issue 需要 gh 和 GitHub 登录。',
     'm.spawnFail': '无法启动智能体：没有可用的 provider/模型。请通过 /settings 配置。',
     'set.title': '⚙ 设置 — 全局（持久化于 ~/.parallel/config.json）',
     'sset.title': '⚙ 会话设置 — 仅本会话（全局设置：/settings）',
@@ -1300,8 +1399,13 @@ const zh = {
     'set.sound': '默认声音:{state}',
     'set.back': '← 返回',
     'set.saved': '✓ 已保存到 ~/.parallel/config.json',
+    'set.sessionProviderReady': '✓ {name} 仅在本会话中可用。',
+    'set.setupScope.title': '仅现在使用 {name}，还是全局保存？',
+    'set.setupScope.session': '仅用于本会话',
+    'set.setupScope.global': '全局保存',
     'set.chooseProvider': '选择提供商',
     'set.chooseModel': '模型（{name}）— 选择或按提供商文档输入名称',
+    'set.modelPlaceholder': '请先选择或输入真实模型名。`your-model-here` 只是占位符。',
     'sset.model': '会话模型:{pm}',
     'sset.approvals': 'Shell 批准（会话）:{mode}',
     'sset.sound': '声音（会话）:{state}',

package/dist/index.js

@@ -44,8 +44,8 @@ Usage:
                           auto-approved commands, summary (or JSON) on stdout — for CI
 
 Environment variables:
-  PARALLEL_API_KEY / DEEPSEEK_API_KEY   API key
-  PARALLEL_MODEL                        Default model (e.g. deepseek-chat)
+  PARALLEL_API_KEY                      API key for the default provider
+  PARALLEL_MODEL                        Default model
   PARALLEL_BASE_URL                     OpenAI-compatible endpoint
   PARALLEL_NO_ALT_SCREEN=1              Disable the alternate terminal screen.
 
@@ -108,7 +108,7 @@ if (headless) {
     ctl.setSessionApprovalMode('yolo');
     const provider = ctl.sessionProvider();
     if (!provider || !providerReady(provider)) {
-        console.error('Headless mode needs a configured provider + API key. Run `parallel` interactively once, or set PARALLEL_API_KEY.');
+        console.error('Headless mode needs a ready provider and model. Run `parallel` interactively once, or set PARALLEL_API_KEY / PARALLEL_MODEL.');
         process.exit(1);
     }
     // Agent questions cannot be asked: auto-answer with the recommended option.