palabre 0.6.4 → 0.8.0

package/dist/orchestrator.js

@@ -1,6 +1,7 @@
 import { createAgent } from "./adapters/index.js";
 import { AdapterError } from "./errors.js";
 import { createTranslator } from "./i18n.js";
+export const MAX_ASK_AGENTS = 4;
 /**
  * Point d'entrée de l'orchestration.
  * Lance le ping-pong entre `agentA` et `agentB` pendant `options.turns` tours,
@@ -32,6 +33,19 @@ export async function runDebate(config, options, renderer, messages = createTran
     const transcript = [];
     let stopReason;
     for (let index = 0; index < options.turns; index += 1) {
+        const cancellation = cancellationFailureIfAborted(options, messages, {
+            phase: "debate",
+            turn: index + 1
+        });
+        if (cancellation) {
+            renderer?.error(cancellation);
+            return {
+                options,
+                messages: transcript,
+                stopReason,
+                failure: cancellation
+            };
+        }
         const current = agents[index % agents.length];
         const peer = agents[(index + 1) % agents.length];
         const turn = index + 1;
@@ -49,7 +63,8 @@ export async function runDebate(config, options, renderer, messages = createTran
                 language: options.language,
                 session: options.session,
                 files: options.files,
-                transcript
+                transcript,
+                signal: options.signal
             });
         }
         catch (error) {
@@ -88,12 +103,26 @@ export async function runDebate(config, options, renderer, messages = createTran
     let failure;
     if (options.summaryEnabled) {
         try {
+            const cancellation = cancellationFailureIfAborted(options, messages, {
+                phase: "summary",
+                agent: resolveSummaryAgentName(options),
+                turn: transcript.length + 1
+            });
+            if (cancellation) {
+                renderer?.error(cancellation);
+                return {
+                    options,
+                    messages: transcript,
+                    stopReason,
+                    failure: cancellation
+                };
+            }
             summary = await generateSummary(config, options, transcript, renderer, messages);
         }
         catch (error) {
             failure = toDebateFailure(error, {
                 phase: "summary",
-                agent: options.summaryAgent ?? options.agentB,
+                agent: resolveSummaryAgentName(options),
                 turn: transcript.length + 1
             });
             renderer?.error(failure);
@@ -107,6 +136,141 @@ export async function runDebate(config, options, renderer, messages = createTran
         failure
     };
 }
+/**
+ * Lance le mode ask : plusieurs agents répondent indépendamment au même sujet,
+ * puis un agent de synthèse résume fidèlement chaque réponse et les compare.
+ */
+export async function runAsk(config, options, renderer, messages = createTranslator("fr")) {
+    const askAgentNames = resolveAskAgentNames(options);
+    if (askAgentNames.length === 0) {
+        throw new Error(messages.common.noAgentDefined("ask agent"));
+    }
+    if (askAgentNames.length > MAX_ASK_AGENTS) {
+        throw new Error(messages.common.tooManyAskAgents(MAX_ASK_AGENTS));
+    }
+    const agentEntries = askAgentNames.map((name) => {
+        const agentConfig = withRuntimeOverrides(config.agents[name], modelForAgent(options, name), options.pullModels);
+        if (!agentConfig) {
+            throw new Error(messages.common.unknownAgent(name));
+        }
+        return [name, agentConfig];
+    });
+    warnIfOllamaHasNoContext(options, agentEntries.map(([name, agentConfig]) => [name, agentConfig]), renderer, messages);
+    renderer?.start(options, agentEntries.map(([name, agentConfig]) => ({
+        name,
+        role: agentConfig.role,
+        type: agentConfig.type
+    })));
+    const agents = agentEntries.map(([name, agentConfig]) => createAgent(name, agentConfig));
+    const transcript = [];
+    for (let index = 0; index < agents.length; index += 1) {
+        const current = agents[index];
+        const response = index + 1;
+        const cancellation = cancellationFailureIfAborted(options, messages, {
+            phase: "ask",
+            agent: current.name,
+            role: current.role,
+            turn: response
+        });
+        if (cancellation) {
+            renderer?.error(cancellation);
+            return {
+                options,
+                messages: transcript,
+                failure: cancellation
+            };
+        }
+        if (renderer?.askResponseStart) {
+            renderer.askResponseStart(response, agents.length, current.name, current.role);
+        }
+        else {
+            renderer?.turnStart(response, agents.length, current.name, current.role);
+        }
+        renderer?.thinkingStart(current.name, current.role);
+        let agentResponse;
+        try {
+            agentResponse = await current.generate({
+                topic: options.topic,
+                turn: response,
+                totalTurns: agents.length,
+                selfName: current.name,
+                peerName: "independent-agents",
+                selfRole: current.role,
+                mode: "ask",
+                language: options.language,
+                session: options.session,
+                files: options.files,
+                transcript: [],
+                signal: options.signal
+            });
+        }
+        catch (error) {
+            const failure = toDebateFailure(error, {
+                phase: "ask",
+                agent: current.name,
+                role: current.role,
+                turn: response
+            });
+            renderer?.error(failure);
+            return {
+                options,
+                messages: transcript,
+                failure
+            };
+        }
+        finally {
+            renderer?.thinkingEnd();
+        }
+        const message = {
+            agent: current.name,
+            role: current.role,
+            content: agentResponse.content,
+            createdAt: new Date().toISOString()
+        };
+        transcript.push(message);
+        if (renderer?.askResponseMessage) {
+            renderer.askResponseMessage(message.content);
+        }
+        else {
+            renderer?.message(message.content);
+        }
+    }
+    let summary;
+    let failure;
+    if (options.summaryEnabled) {
+        try {
+            const summaryAgentName = resolveSummaryAgentName(options);
+            const cancellation = cancellationFailureIfAborted(options, messages, {
+                phase: "summary",
+                agent: summaryAgentName,
+                turn: transcript.length + 1
+            });
+            if (cancellation) {
+                renderer?.error(cancellation);
+                return {
+                    options,
+                    messages: transcript,
+                    failure: cancellation
+                };
+            }
+            summary = await generateSummary(config, options, transcript, renderer, messages);
+        }
+        catch (error) {
+            failure = toDebateFailure(error, {
+                phase: "summary",
+                agent: resolveSummaryAgentName(options),
+                turn: transcript.length + 1
+            });
+            renderer?.error(failure);
+        }
+    }
+    return {
+        options,
+        messages: transcript,
+        summary,
+        failure
+    };
+}
 /**
  * Heuristique d'arrêt sur accord explicite.
  * Ne s'active qu'après un tour complet (nombre pair de messages) pour éviter les faux positifs.
@@ -161,7 +325,7 @@ function warnIfOllamaHasNoContext(options, agents, renderer, messages = createTr
  * @throws {Error} si l'agent de synthèse est absent de `config.agents`.
  */
 async function generateSummary(config, options, transcript, renderer, messages = createTranslator("fr")) {
-    const summaryAgentName = options.summaryAgent ?? options.agentB;
+    const summaryAgentName = resolveSummaryAgentName(options);
     const summaryModel = options.summaryModel ?? modelForAgent(options, summaryAgentName);
     const summaryConfig = withRuntimeOverrides(config.agents[summaryAgentName], summaryModel, options.pullModels);
     if (!summaryConfig) {
@@ -173,15 +337,16 @@ async function generateSummary(config, options, transcript, renderer, messages =
     const response = await summaryAgent.generate({
         topic: options.topic,
         turn: transcript.length + 1,
-        totalTurns: options.turns,
+        totalTurns: options.mode === "ask" ? transcript.length : options.turns,
         selfName: summaryAgent.name,
-        peerName: "transcript",
+        peerName: options.mode === "ask" ? "ask-responses" : "transcript",
         selfRole: summaryAgent.role,
         mode: "summary",
         language: options.language,
         session: options.session,
         files: options.files,
-        transcript
+        transcript,
+        signal: options.signal
     }).finally(() => renderer?.thinkingEnd());
     const summary = {
         agent: summaryAgent.name,
@@ -192,6 +357,34 @@ async function generateSummary(config, options, transcript, renderer, messages =
     renderer?.message(summary.content);
     return summary;
 }
+function cancellationFailureIfAborted(options, messages, context) {
+    if (!options.signal?.aborted) {
+        return undefined;
+    }
+    return {
+        phase: context.phase,
+        agent: context.agent,
+        role: context.role,
+        turn: context.turn,
+        kind: "cancelled",
+        message: messages.orchestrator.cancelled
+    };
+}
+function resolveAskAgentNames(options) {
+    const agents = options.askAgents && options.askAgents.length > 0
+        ? options.askAgents
+        : [options.agentA, options.agentB];
+    return agents.filter((agent, index) => Boolean(agent) && agents.indexOf(agent) === index);
+}
+function resolveSummaryAgentName(options) {
+    if (options.summaryAgent) {
+        return options.summaryAgent;
+    }
+    if (options.mode === "ask" && options.askAgents && options.askAgents.length > 0) {
+        return options.askAgents[options.askAgents.length - 1] ?? options.agentB;
+    }
+    return options.agentB;
+}
 function toDebateFailure(error, context) {
     if (error instanceof AdapterError) {
         return {

package/dist/output.js

@@ -7,7 +7,8 @@ import { createTranslator } from "./i18n.js";
  */
 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 extension = options.mode === "ask" ? "ask" : "debate";
+    const fileName = `palabre-${slugifyTopic(options.topic)}-${safeDate}.${extension}.md`;
     const filePath = path.resolve(outputDir, fileName);
     await mkdir(path.dirname(filePath), { recursive: true });
     await writeFile(filePath, renderDebateMarkdown(options, debateMessages, summary, stopReason, messages, failure), "utf8");
@@ -30,7 +31,7 @@ function slugifyTopic(topic) {
  */
 export function renderDebateMarkdown(options, debateMessages, summary, stopReason, messages = createTranslator("fr"), failure) {
     const lines = [
-        messages.output.title,
+        options.mode === "ask" ? messages.output.askTitle : messages.output.title,
         "",
         ...renderSessionHeader(options, debateMessages, stopReason, messages),
         "",
@@ -38,7 +39,7 @@ export function renderDebateMarkdown(options, debateMessages, summary, stopReaso
         "",
         ...renderFileList(options.files, messages),
         "",
-        messages.output.exchangesTitle,
+        options.mode === "ask" ? messages.output.askResponsesTitle : messages.output.exchangesTitle,
         ""
     ];
     for (const message of debateMessages) {
@@ -90,12 +91,19 @@ function normalizeMarkdownForWindowsPreview(content) {
 function renderSessionHeader(options, debateMessages, stopReason, messages) {
     const rows = [
         [messages.output.fields.subject, options.topic],
-        [messages.output.fields.agents, `${options.agentA} <-> ${options.agentB}`],
+        [messages.output.fields.mode, options.mode],
+        [messages.output.fields.agents, formatAgentsForHeader(options)],
         [messages.output.fields.autoPullOllama, options.pullModels ? messages.output.yes : messages.output.no],
-        [messages.output.fields.summary, options.summaryEnabled ? options.summaryAgent ?? options.agentB : messages.output.disabled],
-        [messages.output.fields.requestedTurns, String(options.turns)],
-        [messages.output.fields.playedTurns, String(debateMessages.length)],
-        [messages.output.fields.earlyStop, stopReason ?? messages.output.no],
+        [messages.output.fields.summary, options.summaryEnabled ? formatSummaryAgent(options) : messages.output.disabled],
+        [
+            options.mode === "ask" ? messages.output.fields.requestedResponses : messages.output.fields.requestedTurns,
+            String(options.mode === "ask" ? options.askAgents?.length ?? debateMessages.length : options.turns)
+        ],
+        [
+            options.mode === "ask" ? messages.output.fields.receivedResponses : messages.output.fields.playedTurns,
+            String(debateMessages.length)
+        ],
+        [messages.output.fields.earlyStop, options.mode === "debate" ? stopReason ?? messages.output.no : messages.output.no],
         [messages.output.fields.localDate, options.session.localDate],
         [messages.output.fields.timeZone, options.session.timeZone],
         [messages.output.fields.cwd, options.session.cwd],
@@ -116,3 +124,18 @@ function renderFileList(files, messages) {
     }
     return files.map((file) => `- \`${file.path}\` (${file.sizeBytes} ${messages.output.fileSizeUnit})`);
 }
+function formatSummaryAgent(options) {
+    if (options.summaryAgent) {
+        return options.summaryAgent;
+    }
+    if (options.mode === "ask" && options.askAgents && options.askAgents.length > 0) {
+        return options.askAgents[options.askAgents.length - 1] ?? options.agentB;
+    }
+    return options.agentB;
+}
+function formatAgentsForHeader(options) {
+    if (options.mode === "ask") {
+        return (options.askAgents && options.askAgents.length > 0 ? options.askAgents : [options.agentA, options.agentB]).join(", ");
+    }
+    return `${options.agentA} <-> ${options.agentB}`;
+}

package/dist/presets.js

@@ -16,6 +16,14 @@ const presets = {
         agentA: "opencode",
         agentB: "codex"
     },
+    "codex-vibe": {
+        agentA: "codex",
+        agentB: "vibe"
+    },
+    "vibe-codex": {
+        agentA: "vibe",
+        agentB: "codex"
+    },
     "codex-antigravity": {
         agentA: "codex",
         agentB: "antigravity"
@@ -32,6 +40,14 @@ const presets = {
         agentA: "opencode",
         agentB: "claude"
     },
+    "claude-vibe": {
+        agentA: "claude",
+        agentB: "vibe"
+    },
+    "vibe-claude": {
+        agentA: "vibe",
+        agentB: "claude"
+    },
     "claude-antigravity": {
         agentA: "claude",
         agentB: "antigravity"
@@ -48,6 +64,14 @@ const presets = {
         agentA: "opencode",
         agentB: "gemini"
     },
+    "gemini-vibe": {
+        agentA: "gemini",
+        agentB: "vibe"
+    },
+    "vibe-gemini": {
+        agentA: "vibe",
+        agentB: "gemini"
+    },
     "gemini-antigravity": {
         agentA: "gemini",
         agentB: "antigravity"
@@ -64,6 +88,22 @@ const presets = {
         agentA: "antigravity",
         agentB: "opencode"
     },
+    "opencode-vibe": {
+        agentA: "opencode",
+        agentB: "vibe"
+    },
+    "vibe-opencode": {
+        agentA: "vibe",
+        agentB: "opencode"
+    },
+    "antigravity-vibe": {
+        agentA: "antigravity",
+        agentB: "vibe"
+    },
+    "vibe-antigravity": {
+        agentA: "vibe",
+        agentB: "antigravity"
+    },
     "opencode-ollama": {
         agentA: "opencode",
         agentB: "ollama-local"
@@ -72,6 +112,14 @@ const presets = {
         agentA: "ollama-local",
         agentB: "opencode"
     },
+    "vibe-ollama": {
+        agentA: "vibe",
+        agentB: "ollama-local"
+    },
+    "ollama-vibe": {
+        agentA: "ollama-local",
+        agentB: "vibe"
+    },
     "codex-ollama": {
         agentA: "codex",
         agentB: "ollama-local"

package/dist/prompt.js

@@ -1,13 +1,16 @@
 import { createTranslator } from "./i18n.js";
 /**
  * Formate le prompt complet transmis à l'adapter.
- * Dispatche vers le format de synthèse si `input.mode === "summary"`, sinon construit le prompt de débat standard.
+ * Dispatche vers le format ask ou synthèse si demandé, sinon construit le prompt de débat standard.
  */
 export function formatAgentPrompt(input) {
     const messages = createTranslator(input.language ?? "fr").prompt;
     if (input.mode === "summary") {
         return formatSummaryPrompt(input, messages);
     }
+    if (input.mode === "ask") {
+        return formatAskPrompt(input, messages);
+    }
     const transcript = formatTranscript(input.transcript);
     return [
         messages.subject(input.topic),
@@ -41,13 +44,43 @@ export function formatAgentPrompt(input) {
         .filter(Boolean)
         .join("\n");
 }
+/** Formate le prompt d'une réponse indépendante en mode ask. */
+function formatAskPrompt(input, messages) {
+    return [
+        messages.subject(input.topic),
+        "",
+        messages.askIntro(input.selfName),
+        messages.role(input.selfName, input.selfRole),
+        messages.roleInstruction(input.selfRole),
+        "",
+        messages.sessionTitle,
+        messages.sessionSource,
+        messages.localDate(input.session.localDate),
+        messages.timeZone(input.session.timeZone),
+        messages.cwd(input.session.cwd),
+        messages.sessionStartedAt(input.session.startedAt),
+        "",
+        messages.responseLanguageInstruction,
+        "",
+        messages.objectiveTitle,
+        ...messages.askObjectives,
+        "",
+        input.files.length > 0 ? messages.fileContextTitle : "",
+        formatFileContext(input.files),
+        input.files.length > 0 ? "" : "",
+        messages.answerTitle
+    ]
+        .filter(Boolean)
+        .join("\n");
+}
 /** Formate le prompt de synthèse finale. Impose un format structuré : Consensus / Désaccords / Actions / Conclusion. */
 function formatSummaryPrompt(input, messages) {
     const transcript = formatTranscript(input.transcript);
+    const isAskSummary = input.peerName === "ask-responses";
     return [
         messages.subject(input.topic),
         "",
-        messages.summaryIntro(input.selfName),
+        isAskSummary ? messages.askSummaryIntro(input.selfName) : messages.summaryIntro(input.selfName),
         messages.role(input.selfName, input.selfRole),
         messages.roleInstruction("summarizer"),
         "",
@@ -61,29 +94,47 @@ function formatSummaryPrompt(input, messages) {
         messages.responseLanguageInstruction,
         "",
         messages.objectiveTitle,
-        ...messages.summaryObjectives,
+        ...(isAskSummary ? messages.askSummaryObjectives : messages.summaryObjectives),
         "",
         input.files.length > 0 ? messages.fileContextTitle : "",
         formatFileContext(input.files),
         input.files.length > 0 ? "" : "",
-        messages.transcriptTitle,
+        isAskSummary ? messages.askResponsesTitle : messages.transcriptTitle,
         transcript || messages.noMessage,
         "",
         messages.expectedFormatTitle,
+        ...(isAskSummary ? askSummaryHeadings(messages) : debateSummaryHeadings(messages)),
+        "",
+        isAskSummary ? messages.askFinalProseInstruction : messages.finalProseInstruction,
+        "",
+        messages.summaryAnswerTitle
+    ]
+        .filter(Boolean)
+        .join("\n");
+}
+function debateSummaryHeadings(messages) {
+    return [
         messages.consensusHeading,
         "",
         messages.disagreementsHeading,
         "",
         messages.actionsHeading,
         "",
-        messages.conclusionHeading,
+        messages.conclusionHeading
+    ];
+}
+function askSummaryHeadings(messages) {
+    return [
+        messages.askAgentSummariesHeading,
         "",
-        messages.finalProseInstruction,
+        messages.askComparisonHeading,
         "",
-        messages.summaryAnswerTitle
-    ]
-        .filter(Boolean)
-        .join("\n");
+        messages.askWatchpointsHeading,
+        "",
+        messages.actionsHeading,
+        "",
+        messages.conclusionHeading
+    ];
 }
 /** Formate les fichiers projet en blocs de code annotés pour l'injection dans le prompt. */
 function formatFileContext(files) {

package/dist/renderers/console.js

@@ -33,7 +33,7 @@ class PrettyConsoleRenderer {
             this.c("cyan", `┌─ ${title} ${"─".repeat(Math.max(1, 54 - title.length))}`),
             this.c("cyan", `│`) + ` ${this.messages.renderers.subject(options.topic)}`,
             this.c("cyan", `│`) + ` ${this.messages.renderers.agents(formatAgentPair(options, agents))}`,
-            this.c("cyan", `│`) + ` ${this.messages.renderers.responsesSummary(options.turns, formatSummary(options, this.messages))}`,
+            this.c("cyan", `│`) + ` ${this.messages.renderers.responsesSummary(formatResponseCount(options), formatSummary(options, this.messages))}`,
             this.c("cyan", `│`) + ` ${this.messages.renderers.context(formatContext(options, this.messages))}`,
             this.c("cyan", `│`) + ` ${this.messages.renderers.options(options.earlyStopOnAgreement, options.pullModels)}`,
             this.c("cyan", `└${"─".repeat(57)}`),
@@ -58,6 +58,15 @@ class PrettyConsoleRenderer {
             ""
         ].join("\n"));
     }
+    askResponseStart(response, totalResponses, agent, role) {
+        this.renderingSummary = false;
+        process.stdout.write([
+            "",
+            this.c("orange", `◆ ${agent}`) + this.dim(` · ${role} · réponse ${response}/${totalResponses}`),
+            this.dim("─".repeat(60)),
+            ""
+        ].join("\n"));
+    }
     /** Démarre le spinner de réflexion (ou affiche une ligne fixe si non interactif). */
     thinkingStart(agent, role) {
         this.thinkingEnd();
@@ -89,6 +98,9 @@ class PrettyConsoleRenderer {
         const trimmed = content.trim();
         process.stdout.write(`${this.renderingSummary ? this.formatSummaryMessage(trimmed) : trimmed}\n`);
     }
+    askResponseMessage(content) {
+        this.message(content);
+    }
     /** Affiche l'en-tête de section synthèse et active le mode formatage de résumé. */
     summaryStart(agent, role) {
         this.renderingSummary = true;
@@ -153,7 +165,7 @@ class PlainConsoleRenderer {
     start(options, agents = []) {
         process.stdout.write(this.messages.renderers.subject(options.topic) + "\n");
         process.stdout.write(this.messages.renderers.agents(formatAgentPair(options, agents)) + "\n");
-        process.stdout.write(this.messages.renderers.responsesSummaryContext(options.turns, formatSummary(options, this.messages), formatContext(options, this.messages)) + "\n");
+        process.stdout.write(this.messages.renderers.responsesSummaryContext(formatResponseCount(options), formatSummary(options, this.messages), formatContext(options, this.messages)) + "\n");
     }
     /** Écrit un avertissement sur `stderr`. */
     warning(message) {
@@ -167,6 +179,9 @@ class PlainConsoleRenderer {
     turnStart(turn, totalTurns, agent, role) {
         process.stdout.write(`\n[${turn}/${totalTurns}] ${agent} (${role})...\n`);
     }
+    askResponseStart(response, totalResponses, agent, role) {
+        process.stdout.write(`\n[${response}/${totalResponses}] ${agent} (${role})...\n`);
+    }
     /** No-op : pas de spinner en mode plain. */
     thinkingStart(_agent, _role) { }
     /** No-op : pas de spinner à arrêter en mode plain. */
@@ -175,6 +190,9 @@ class PlainConsoleRenderer {
     message(content) {
         process.stdout.write(`${content.trim()}\n`);
     }
+    askResponseMessage(content) {
+        this.message(content);
+    }
     /** Affiche l'en-tête de la section synthèse en texte brut. */
     summaryStart(agent, role) {
         process.stdout.write(`\n[${this.messages.renderers.summaryTitle}] ${agent} (${role})...\n`);
@@ -194,6 +212,12 @@ class PlainConsoleRenderer {
  * @param agents - Infos de démarrage des agents (type, rôle, nom).
  */
 function formatAgentPair(options, agents) {
+    if (options.mode === "ask") {
+        if (agents.length > 0) {
+            return agents.map(formatAgentLabel).join(", ");
+        }
+        return (options.askAgents ?? [options.agentA, options.agentB]).join(", ");
+    }
     if (agents.length >= 2) {
         return `${formatAgentLabel(agents[0])} <-> ${formatAgentLabel(agents[1])}`;
     }
@@ -214,7 +238,19 @@ function formatAgentLabel(agent) {
  * @param options - Options du débat.
  */
 function formatSummary(options, messages) {
-    return options.summaryEnabled ? options.summaryAgent ?? options.agentB : messages.renderers.disabled;
+    if (!options.summaryEnabled) {
+        return messages.renderers.disabled;
+    }
+    if (options.summaryAgent) {
+        return options.summaryAgent;
+    }
+    if (options.mode === "ask" && options.askAgents && options.askAgents.length > 0) {
+        return options.askAgents[options.askAgents.length - 1] ?? options.agentB;
+    }
+    return options.agentB;
+}
+function formatResponseCount(options) {
+    return options.mode === "ask" ? options.askAgents?.length ?? 2 : options.turns;
 }
 /**
  * Renvoie un résumé du contexte injecté (nombre de fichiers ou mention d'absence).