palabre 0.6.0 → 0.6.1

package/README.md

@@ -50,6 +50,7 @@ palabre -s "Compare ces deux approches" -t 2
 palabre codex-claude "Relis cette architecture" --context src docs
 palabre claude-ollama "Critique ce fichier" --files README.md
 palabre codex-claude "Preview" --context src --show-prompt
+palabre context scan src docs --json
 ```
 
 ### Agents supportés
@@ -63,10 +64,22 @@ palabre codex-claude "Preview" --context src --show-prompt
 
 PALABRE ne liste pas les modèles : ils changent souvent et dépendent de chaque CLI ou compte utilisateur. `--model-a`, `--model-b` et `--summary-model` transmettent simplement la valeur brute à l'agent concerné.
 
+### Intégrations
+
+PALABRE expose des sorties JSON versionnées pour les clients externes :
+
+- `palabre presets --json` pour lire les paires d'agents disponibles ;
+- `palabre context scan --json` pour prévisualiser le contexte que `--context` retiendrait ;
+- `--renderer ndjson` ou `--json` pour suivre un débat événement par événement.
+
+Le flux NDJSON v1 est traité comme une API publique d'intégration. Les ajouts compatibles se font sans casser v1 ; les changements cassants doivent changer le champ `v`.
+
 ### Confidentialité
 
 PALABRE tourne localement et n'envoie aucune donnée à un serveur appartenant à PALABRE. Les données envoyées aux agents dépendent des outils que vous utilisez : vérifiez les politiques de confidentialité de Claude Code, Codex CLI, Gemini CLI, Antigravity CLI, OpenCode, Ollama ou de tout autre agent configuré.
 
+Si un agent échoue pendant le débat ou la synthèse, PALABRE conserve l'export Markdown partiel avec une section d'interruption quand c'est possible.
+
 ### Développement local
 
 ```bash
@@ -97,7 +110,7 @@ It does not replace your tools: it drives them. You keep your subscriptions, def
 - https://palab.re
 - https://palabre.netlify.app
 
-Useful pages: [Installation](https://palab.re/fr/get-started/installation), [Configuration](https://palab.re/fr/get-started/configuration), [First debate](https://palab.re/fr/get-started/first-debate), [CLI reference](https://palab.re/fr/reference/cli), [Troubleshooting](https://palab.re/fr/troubleshooting), [Roadmap](https://palab.re/fr/roadmap).
+Useful pages: [Installation](https://palab.re/en/get-started/installation), [Configuration](https://palab.re/en/get-started/configuration), [First debate](https://palab.re/en/get-started/first-debate), [CLI reference](https://palab.re/en/reference/cli), [Troubleshooting](https://palab.re/en/troubleshooting), [Roadmap](https://palab.re/en/roadmap).
 
 ### Installation
 
@@ -125,6 +138,7 @@ palabre -s "Compare these two approaches" -t 2
 palabre codex-claude "Review this architecture" --context src docs
 palabre claude-ollama "Review this file" --files README.md
 palabre codex-claude "Preview" --context src --show-prompt
+palabre context scan src docs --json
 ```
 
 ### Supported Agents
@@ -138,10 +152,22 @@ palabre codex-claude "Preview" --context src --show-prompt
 
 PALABRE does not list models: they change often and depend on each CLI or user account. `--model-a`, `--model-b`, and `--summary-model` simply pass the raw value to the selected agent.
 
+### Integrations
+
+PALABRE exposes versioned JSON outputs for external clients:
+
+- `palabre presets --json` to read available agent pairs;
+- `palabre context scan --json` to preview the context `--context` would retain;
+- `--renderer ndjson` or `--json` to follow a debate event by event.
+
+The NDJSON v1 stream is treated as a public integration API. Compatible additions do not break v1; breaking changes must change the `v` field.
+
 ### Privacy
 
 PALABRE runs locally and does not send data to a PALABRE-owned server. Data sent to agents depends on the tools you use: check the privacy policies of Claude Code, Codex CLI, Gemini CLI, Antigravity CLI, OpenCode, Ollama, or any custom agent you configure.
 
+If an agent fails during the debate or final summary, PALABRE keeps the partial Markdown export with an interruption section whenever possible.
+
 ### Local Development
 
 ```bash

package/dist/adapters/cli-pty.js

@@ -4,6 +4,7 @@ import path from "node:path";
 import { AdapterError } from "../errors.js";
 import { formatAgentPrompt } from "../prompt.js";
 import { cleanTerminalOutput } from "./terminal.js";
+const DEFAULT_MAX_OUTPUT_BYTES = 50 * 1024 * 1024;
 /**
  * Adapter pour les CLIs qui exigent un vrai terminal.
  * Contrairement à `CliAdapter`, stdout/stderr sont fusionnés dans le flux PTY.
@@ -45,11 +46,13 @@ export class CliPtyAdapter {
             : baseArgs;
         return new Promise((resolve, reject) => {
             let output = "";
+            let outputBytes = 0;
             let settled = false;
             let hardTimer;
             let term;
             let dataSubscription;
             let exitSubscription;
+            const maxOutputBytes = this.config.maxOutputBytes ?? DEFAULT_MAX_OUTPUT_BYTES;
             const finish = (error, exitCode, kill = true) => {
                 if (settled)
                     return;
@@ -109,6 +112,14 @@ export class CliPtyAdapter {
                 }));
             }, this.config.timeoutMs ?? 180_000);
             dataSubscription = term.onData((chunk) => {
+                outputBytes += Buffer.byteLength(chunk, "utf8");
+                if (outputBytes > maxOutputBytes) {
+                    finish(new AdapterError("output-too-large", this.name, `${this.name} produced more than ${maxOutputBytes} bytes of PTY output`, {
+                        maxOutputBytes,
+                        outputBytes
+                    }));
+                    return;
+                }
                 output += chunk;
             });
             exitSubscription = term.onExit(({ exitCode }) => {

package/dist/adapters/cli.js

@@ -2,6 +2,7 @@ import { spawn } from "node:child_process";
 import { AdapterError } from "../errors.js";
 import { formatAgentPrompt } from "../prompt.js";
 import { cleanTerminalOutput } from "./terminal.js";
+const DEFAULT_MAX_OUTPUT_BYTES = 50 * 1024 * 1024;
 /**
  * Adapter pour les CLIs batch (Codex, Claude, Gemini…).
  * Lance un sous-processus, injecte le prompt via stdin ou argument, capture stdout.
@@ -50,8 +51,10 @@ export class CliAdapter {
             let stdout = "";
             let stderr = "";
             let settled = false;
+            let outputBytes = 0;
             let hardTimer;
             let idleTimer;
+            const maxOutputBytes = this.config.maxOutputBytes ?? DEFAULT_MAX_OUTPUT_BYTES;
             const finish = (error) => {
                 if (settled)
                     return;
@@ -94,10 +97,28 @@ export class CliAdapter {
             };
             bumpIdleTimer();
             child.stdout.on("data", (chunk) => {
+                outputBytes += chunk.length;
+                if (outputBytes > maxOutputBytes) {
+                    child.kill();
+                    finish(new AdapterError("output-too-large", this.name, `${this.name} produced more than ${maxOutputBytes} bytes of output`, {
+                        maxOutputBytes,
+                        outputBytes
+                    }));
+                    return;
+                }
                 stdout += chunk.toString("utf8");
                 bumpIdleTimer();
             });
             child.stderr.on("data", (chunk) => {
+                outputBytes += chunk.length;
+                if (outputBytes > maxOutputBytes) {
+                    child.kill();
+                    finish(new AdapterError("output-too-large", this.name, `${this.name} produced more than ${maxOutputBytes} bytes of output`, {
+                        maxOutputBytes,
+                        outputBytes
+                    }));
+                    return;
+                }
                 stderr += chunk.toString("utf8");
                 bumpIdleTimer();
             });

package/dist/contextScan.js

@@ -0,0 +1,48 @@
+import path from "node:path";
+import { loadProjectInputs } from "./context.js";
+import { createTranslator } from "./i18n.js";
+/**
+ * Builds the machine-readable context preview used by integrations.
+ *
+ * The scan intentionally reuses the same tolerant loader as `--context`, so
+ * the returned files are the files Palabre would actually inject into a debate.
+ */
+export async function buildContextScan(scanPaths, cwd = process.cwd(), messages = createTranslator("fr")) {
+    const effectiveScanPaths = scanPaths.length > 0 ? scanPaths : ["."];
+    const result = await loadProjectInputs([], effectiveScanPaths, cwd, messages);
+    const files = result.files.map((file) => ({
+        kind: "file",
+        path: file.path,
+        absolutePath: file.absolutePath,
+        sizeBytes: file.sizeBytes
+    }));
+    const folders = collectContextFolders(files.map((file) => file.path), cwd);
+    return {
+        v: 1,
+        root: cwd,
+        scanned: effectiveScanPaths,
+        items: [...folders, ...files],
+        warnings: result.warnings
+    };
+}
+function collectContextFolders(filePaths, cwd) {
+    const counts = new Map();
+    if (filePaths.length > 0) {
+        counts.set(".", filePaths.length);
+    }
+    for (const filePath of filePaths) {
+        const parts = filePath.split("/").filter(Boolean);
+        for (let index = 1; index < parts.length; index += 1) {
+            const folder = parts.slice(0, index).join("/");
+            counts.set(folder, (counts.get(folder) ?? 0) + 1);
+        }
+    }
+    return [...counts.entries()]
+        .sort(([left], [right]) => left === "." ? -1 : right === "." ? 1 : left.localeCompare(right))
+        .map(([folder, filesCount]) => ({
+        kind: "folder",
+        path: folder,
+        absolutePath: path.resolve(cwd, folder),
+        filesCount
+    }));
+}

package/dist/index.js

@@ -4,6 +4,7 @@ import path from "node:path";
 import { fileURLToPath } from "node:url";
 import { configExists, createConfigFromDiscovery, DEFAULT_CONFIG_PATH, GLOBAL_CONFIG_PATH, loadConfig, resolveDefaultConfigPath, resolveOutputDir, writeExampleConfig } from "./config.js";
 import { loadProjectInputs } from "./context.js";
+import { buildContextScan } from "./contextScan.js";
 import { discoverLocalTools } from "./discovery.js";
 import { runDoctor } from "./doctor.js";
 import { AdapterError, formatAdapterError } from "./errors.js";
@@ -51,6 +52,10 @@ async function main() {
         await runPresetsCommand(parsed.flags);
         return;
     }
+    if (parsed.command === "context") {
+        await runContextCommand(parsed.flags, parsed.positionals);
+        return;
+    }
     if (parsed.command === "update") {
         const info = await getUpdateInfo(await getPackageVersion());
         const updateConfigPath = optionalString(parsed.flags.config) ?? await resolveDefaultConfigPath();
@@ -168,8 +173,11 @@ async function main() {
     const renderer = createRendererFromFlags(parsed.flags, options.plainOutput, messages);
     context.warnings.forEach((warning) => renderer.warning(warning));
     const result = await runDebate(config, options, renderer, messages);
-    const outputPath = await writeDebateMarkdown(resolveOutputDir(config.outputDir), result.options, result.messages, result.summary, result.stopReason, messages);
+    const outputPath = await writeDebateMarkdown(resolveOutputDir(config.outputDir), result.options, result.messages, result.summary, result.stopReason, messages, result.failure);
     renderer.done(outputPath);
+    if (result.failure) {
+        process.exitCode = 1;
+    }
 }
 /**
  * Exécute la commande `agents` : charge la config et affiche les agents déclarés avec leur état de détection.
@@ -436,6 +444,31 @@ async function runPresetsCommand(flags) {
     console.log("");
     console.log(messages.presets.total(presets.length));
 }
+async function runContextCommand(flags, positionals) {
+    const language = resolveLanguage({ explicitLanguage: optionalString(flags.language) });
+    const messages = createTranslator(language);
+    const subcommand = positionals[0] ?? "scan";
+    if (subcommand !== "scan") {
+        throw new Error(messages.common.unknownCommand(`context ${subcommand}`, "context scan"));
+    }
+    const paths = positionals.slice(1);
+    const result = await buildContextScan(paths, process.cwd(), messages);
+    const folders = result.items.filter((item) => item.kind === "folder");
+    const files = result.items.filter((item) => item.kind === "file");
+    if (flags.json) {
+        console.log(JSON.stringify(result, null, 2));
+        return;
+    }
+    for (const folder of folders) {
+        console.log(`[folder] ${folder.path}`);
+    }
+    for (const file of files) {
+        console.log(`[file] ${file.path} (${file.sizeBytes} bytes)`);
+    }
+    for (const warning of result.warnings) {
+        console.error(`${messages.renderers.warningPrefix} ${warning}`);
+    }
+}
 /**
  * Parse `process.argv` en une structure typée `ParsedArgs`.
  * Gère les flags courts (-h, -v, -s, -t, -a), les flags longs (--topic, --agent-a…),
@@ -448,7 +481,7 @@ function parseArgs(args, messages) {
     let command = "run";
     let commandExplicit = false;
     const positionals = [];
-    const commands = new Set(["run", "new", "init", "setup", "help", "version", "update", "doctor", "config", "agent", "agents", "preset", "presets"]);
+    const commands = new Set(["run", "new", "init", "setup", "help", "version", "update", "doctor", "config", "agent", "agents", "preset", "presets", "context"]);
     const presets = new Set(listPresetNames());
     for (let index = 0; index < args.length; index += 1) {
         const value = args[index];
@@ -545,7 +578,7 @@ function parseArgs(args, messages) {
     if (command === "run") {
         applyRunPositionals(positionals, flags, presets, commandExplicit, commands, messages);
     }
-    return { command, commandExplicit, flags };
+    return { command, commandExplicit, positionals, flags };
 }
 /**
  * Détecte si une valeur ressemble à une faute de frappe d'une commande connue

package/dist/messages/adapter-errors.js

@@ -3,6 +3,7 @@ const frHints = {
     "spawn-failed": "Sur Windows, essaye le wrapper .cmd ou active \"shell\": true dans la config agent.",
     timeout: "Augmente timeoutMs ou teste la commande directement dans le terminal.",
     "idle-timeout": "Desactive idleTimeoutMs pour les CLIs IA qui restent silencieuses pendant la generation.",
+    "output-too-large": "Reduis le contexte, le nombre de tours ou configure maxOutputBytes pour cet agent si ce volume est attendu.",
     "empty-output": "Teste la commande en dehors de Palabre et verifie que le prompt est bien lu via stdin ou argument.",
     "usage-limit": "Attends la fenetre indiquee par la CLI, change de modele ou relance avec un autre agent/preset disponible.",
     "non-zero-exit": "Teste la commande directement, puis ajuste args, permissions, modele ou authentification de la CLI.",
@@ -16,6 +17,7 @@ const enHints = {
     "spawn-failed": "On Windows, try the .cmd wrapper or enable \"shell\": true in the agent config.",
     timeout: "Increase timeoutMs or test the command directly in the terminal.",
     "idle-timeout": "Disable idleTimeoutMs for AI CLIs that stay silent while generating.",
+    "output-too-large": "Reduce context, turn count, or configure maxOutputBytes for this agent if this volume is expected.",
     "empty-output": "Test the command outside Palabre and check that the prompt is read through stdin or an argument.",
     "usage-limit": "Wait for the window indicated by the CLI, change model, or run again with another available agent/preset.",
     "non-zero-exit": "Test the command directly, then adjust args, permissions, model, or CLI authentication.",

package/dist/messages/help.js

@@ -29,6 +29,16 @@ Usage:
 Flags:
   --json               sortie structuree pour integrations
   --config <path>      chemin de config explicite
+`,
+    context: `
+Scanne le contexte projet avec les memes regles que --context.
+
+Usage:
+  palabre context scan [paths...] [flags]
+
+Flags:
+  --json               sortie structuree pour integrations
+  --language <fr|en>   force la langue des avertissements
 `,
     config: `
 Configure les agents par defaut, la synthese, le nombre de reponses et la langue.
@@ -124,6 +134,16 @@ Usage:
 Flags:
   --json               structured output for integrations
   --config <path>      explicit config path
+`,
+    context: `
+Scans project context with the same rules as --context.
+
+Usage:
+  palabre context scan [paths...] [flags]
+
+Flags:
+  --json               structured output for integrations
+  --language <fr|en>   forces warning language
 `,
     config: `
 Configures default agents, summary, response count, and language.
@@ -212,6 +232,7 @@ Commandes:
   new        Assistant interactif de debat
   agents     Lister les agents configures
   presets    Lister les presets disponibles
+  context    Scanner le contexte projet
   config     Modifier les parametres par defaut
   doctor     Verifier la config et les outils locaux
   update     Afficher ou appliquer les etapes de mise a jour
@@ -256,6 +277,7 @@ Commands:
   new        Interactive debate assistant
   agents     List configured agents
   presets    List available presets
+  context    Scan project context
   config     Edit default settings
   doctor     Check config and local tools
   update     Show or apply update steps

package/dist/messages/output.js

@@ -3,6 +3,7 @@ export const outputMessages = {
         title: "# PALABRE Debate",
         contextTitle: "## Contexte",
         exchangesTitle: "## Echanges",
+        failureTitle: "## Interruption",
         finalSummaryTitle: "## Synthese finale",
         tableField: "Champ",
         tableValue: "Valeur",
@@ -27,13 +28,19 @@ export const outputMessages = {
             sessionStartedAt: "Session demarree a",
             agent: "Agent",
             role: "Role",
-            date: "Date"
+            date: "Date",
+            failurePhase: "Phase",
+            failureAgent: "Agent",
+            failureTurn: "Tour",
+            failureKind: "Type d'erreur",
+            failureMessage: "Message"
         }
     },
     en: {
         title: "# PALABRE Debate",
         contextTitle: "## Context",
         exchangesTitle: "## Exchanges",
+        failureTitle: "## Interruption",
         finalSummaryTitle: "## Final summary",
         tableField: "Field",
         tableValue: "Value",
@@ -58,7 +65,12 @@ export const outputMessages = {
             sessionStartedAt: "Session started at",
             agent: "Agent",
             role: "Role",
-            date: "Date"
+            date: "Date",
+            failurePhase: "Phase",
+            failureAgent: "Agent",
+            failureTurn: "Turn",
+            failureKind: "Error kind",
+            failureMessage: "Message"
         }
     }
 };

package/dist/orchestrator.js

@@ -1,4 +1,5 @@
 import { createAgent } from "./adapters/index.js";
+import { AdapterError } from "./errors.js";
 import { createTranslator } from "./i18n.js";
 /**
  * Point d'entrée de l'orchestration.
@@ -36,18 +37,39 @@ export async function runDebate(config, options, renderer, messages = createTran
         const turn = index + 1;
         renderer?.turnStart(turn, options.turns, current.name, current.role);
         renderer?.thinkingStart(current.name, current.role);
-        const response = await current.generate({
-            topic: options.topic,
-            turn,
-            totalTurns: options.turns,
-            selfName: current.name,
-            peerName: peer.name,
-            selfRole: current.role,
-            language: options.language,
-            session: options.session,
-            files: options.files,
-            transcript
-        }).finally(() => renderer?.thinkingEnd());
+        let response;
+        try {
+            response = await current.generate({
+                topic: options.topic,
+                turn,
+                totalTurns: options.turns,
+                selfName: current.name,
+                peerName: peer.name,
+                selfRole: current.role,
+                language: options.language,
+                session: options.session,
+                files: options.files,
+                transcript
+            });
+        }
+        catch (error) {
+            const failure = toDebateFailure(error, {
+                phase: "debate",
+                agent: current.name,
+                role: current.role,
+                turn
+            });
+            renderer?.error(failure);
+            return {
+                options,
+                messages: transcript,
+                stopReason,
+                failure
+            };
+        }
+        finally {
+            renderer?.thinkingEnd();
+        }
         const message = {
             agent: current.name,
             role: current.role,
@@ -62,14 +84,27 @@ export async function runDebate(config, options, renderer, messages = createTran
             break;
         }
     }
-    const summary = options.summaryEnabled
-        ? await generateSummary(config, options, transcript, renderer, messages)
-        : undefined;
+    let summary;
+    let failure;
+    if (options.summaryEnabled) {
+        try {
+            summary = await generateSummary(config, options, transcript, renderer, messages);
+        }
+        catch (error) {
+            failure = toDebateFailure(error, {
+                phase: "summary",
+                agent: options.summaryAgent ?? options.agentB,
+                turn: transcript.length + 1
+            });
+            renderer?.error(failure);
+        }
+    }
     return {
         options,
         messages: transcript,
         summary,
-        stopReason
+        stopReason,
+        failure
     };
 }
 /**
@@ -164,6 +199,27 @@ async function generateSummary(config, options, transcript, renderer, messages =
     renderer?.message(summary.content);
     return summary;
 }
+function toDebateFailure(error, context) {
+    if (error instanceof AdapterError) {
+        return {
+            phase: context.phase,
+            agent: context.agent ?? error.adapterName,
+            role: context.role,
+            turn: context.turn,
+            kind: error.kind,
+            message: error.message,
+            details: error.details
+        };
+    }
+    return {
+        phase: context.phase,
+        agent: context.agent,
+        role: context.role,
+        turn: context.turn,
+        kind: "unknown",
+        message: error instanceof Error ? error.message : String(error)
+    };
+}
 /** Résout le model override pour un agent donné. Retourne `undefined` si l'agent n'est ni A ni B. */
 function modelForAgent(options, agent) {
     if (agent === options.agentA) {

package/dist/output.js

@@ -5,12 +5,12 @@ import { createTranslator } from "./i18n.js";
  * Écrit le débat au format Markdown dans `outputDir`.
  * Crée le répertoire si absent. Retourne le chemin absolu du fichier créé.
  */
-export async function writeDebateMarkdown(outputDir, options, debateMessages, summary, stopReason, messages = createTranslator("fr")) {
+export async function writeDebateMarkdown(outputDir, options, debateMessages, summary, stopReason, messages = createTranslator("fr"), failure) {
     const safeDate = new Date().toISOString().replace(/[:.]/g, "-");
     const fileName = `palabre-${slugifyTopic(options.topic)}-${safeDate}.debate.md`;
     const filePath = path.resolve(outputDir, fileName);
     await mkdir(path.dirname(filePath), { recursive: true });
-    await writeFile(filePath, renderDebateMarkdown(options, debateMessages, summary, stopReason, messages), "utf8");
+    await writeFile(filePath, renderDebateMarkdown(options, debateMessages, summary, stopReason, messages, failure), "utf8");
     return filePath;
 }
 function slugifyTopic(topic) {
@@ -28,7 +28,7 @@ function slugifyTopic(topic) {
  * Produit la représentation Markdown complète du débat.
  * Fonction pure : aucun effet de bord sur le filesystem.
  */
-export function renderDebateMarkdown(options, debateMessages, summary, stopReason, messages = createTranslator("fr")) {
+export function renderDebateMarkdown(options, debateMessages, summary, stopReason, messages = createTranslator("fr"), failure) {
     const lines = [
         messages.output.title,
         "",
@@ -44,6 +44,9 @@ export function renderDebateMarkdown(options, debateMessages, summary, stopReaso
     for (const message of debateMessages) {
         lines.push(`### ${message.agent} (${message.role})`, "", normalizeMarkdownForWindowsPreview(message.content.trim()), "");
     }
+    if (failure) {
+        lines.push("---", "", messages.output.failureTitle, "", ...renderFailureBlock(failure, messages), "");
+    }
     lines.push("---", "", messages.output.finalSummaryTitle, "", ...renderSummaryBlock(options, summary, messages));
     return `${lines.join("\n")}\n`;
 }
@@ -67,6 +70,20 @@ function renderSummaryBlock(options, summary, messages) {
         ""
     ];
 }
+function renderFailureBlock(failure, messages) {
+    const rows = [
+        [messages.output.fields.failurePhase, failure.phase],
+        [messages.output.fields.failureAgent, failure.agent ?? messages.output.no],
+        [messages.output.fields.failureTurn, failure.turn === undefined ? messages.output.no : String(failure.turn)],
+        [messages.output.fields.failureKind, failure.kind],
+        [messages.output.fields.failureMessage, failure.message]
+    ];
+    return [
+        `| ${messages.output.tableField} | ${messages.output.tableValue} |`,
+        "| --- | --- |",
+        ...rows.map(([label, value]) => `| ${escapeTableCell(label)} | ${escapeTableCell(value)} |`)
+    ];
+}
 function normalizeMarkdownForWindowsPreview(content) {
     return content.replace(/:\*\*/g, ":**");
 }

package/dist/renderers/console.js

@@ -99,6 +99,10 @@ class PrettyConsoleRenderer {
             ""
         ].join("\n"));
     }
+    error(failure) {
+        this.thinkingEnd();
+        process.stderr.write(`\n${this.c("red", this.messages.common.errorPrefix)} ${formatFailureLocation(failure, this.messages)}: ${failure.message}\n`);
+    }
     /** Affiche le chemin du fichier de sortie en vert à la fin du débat. */
     done(outputPath) {
         process.stdout.write(`\n\n${this.c("green", this.messages.renderers.exported(outputPath))}\n\n`);
@@ -175,6 +179,9 @@ class PlainConsoleRenderer {
     summaryStart(agent, role) {
         process.stdout.write(`\n[${this.messages.renderers.summaryTitle}] ${agent} (${role})...\n`);
     }
+    error(failure) {
+        process.stderr.write(`\n${this.messages.common.errorPrefix}: ${formatFailureLocation(failure, this.messages)}: ${failure.message}\n`);
+    }
     /** Affiche le chemin du fichier de sortie à la fin du débat. */
     done(outputPath) {
         process.stdout.write(`\n${this.messages.renderers.exported(outputPath)}\n`);
@@ -220,6 +227,13 @@ function formatContext(options, messages) {
     }
     return messages.renderers.injectedFiles(count);
 }
+function formatFailureLocation(failure, messages) {
+    if (failure.phase === "summary") {
+        return messages.renderers.summaryTitle;
+    }
+    const turn = failure.turn === undefined ? "" : `, turn ${failure.turn}`;
+    return `${failure.agent ?? "?"} (${failure.role ?? "?"}${turn})`;
+}
 /** Codes d'échappement ANSI utilisés par `PrettyConsoleRenderer`. */
 const codes = {
     reset: "\u001b[0m",
@@ -228,6 +242,7 @@ const codes = {
     cyan: "\u001b[36m",
     green: "\u001b[32m",
     magenta: "\u001b[35m",
+    red: "\u001b[31m",
     yellow: "\u001b[33m",
     orange: "\u001b[38;5;208m",
     pink: "\u001b[38;5;205m"

package/dist/renderers/ndjson.js

@@ -101,6 +101,10 @@ export class NdjsonRenderer {
         this.currentRole = role;
         this.emit({ type: "summary-start", agent, role });
     }
+    /** Émet une erreur runtime structurée. */
+    error(failure) {
+        this.emit({ type: "error", ...failure });
+    }
     /** Émet `done` avec le chemin du `.debate.md` écrit. */
     done(outputPath) {
         this.emit({ type: "done", outputPath });

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "palabre",
-  "version": "0.6.0",
+  "version": "0.6.1",
   "description": "Orchestrateur de debat entre agents IA locaux, CLIs et Ollama.",
   "license": "MIT",
   "type": "module",