@alexeiled/pi-fusion 0.6.0 → 0.6.2

package/README.md

@@ -177,7 +177,7 @@ Requirements:
 
 - Pi
 - Node.js 22.19+
-- `pi-subagents`
+- `pi-subagents` 0.43.0 or later
 
 ```bash
 pi install npm:pi-subagents
@@ -210,7 +210,7 @@ For commands, config, and troubleshooting details, see [`docs/user-guide.md`](./
 - Fusion sends your prompt and any inspected snippets to every panel model, and to the judge, through `pi-subagents`.
 - Reports include available per-panel and judge time, aggregate model time, usage, estimated cost, and model failure details. Missing provider usage is shown as unknown. `$0.0000` is a known zero cost.
 - `Model` is lifecycle metadata. `Configured model` is the profile request. Both appear when the run differs from the request.
-- `stopWhenPanelAgrees` is an opt-in profile setting. It requires matching high-confidence decision records with no request for more evidence, stops only unfinished panelists, and still runs the judge.
+- `stopWhenPanelAgrees` is an opt-in profile setting. It requires matching high-confidence decision records with no request for more evidence, evaluates panelists in pairs so it can avoid starting later work, records skipped panelists in the report, and still runs the judge.
 - Panel answers reach the judge in an order seeded from the run id, not in config order. A fixed order advantages the same member on every run, because judges favour whichever candidate they see first or last.
 - Panelists can search the web by opting in to the `fusion-panelist-web` agent, which requires `pi-web-providers`. Defaults stay local-only on purpose: tool names are a strict allowlist, so an agent declaring a tool whose extension is missing fails every task that uses it.
 - `synthesis: "merge"` switches from picking the best answer to merging answers that covered different facets, using the `fusion-composer` agent. Panel members get facets through their optional `question` field. See the user guide.

package/docs/user-guide.md

@@ -29,7 +29,7 @@ prompts, or both. **Mixing models is the main lever.** The config that
 `/fusion init` writes sets no `model`. By default you therefore get one model in
 three roles. Give each member its own `model` to get the real benefit.
 
-Older runs created as a single `pi-subagents` chain remain supported when restored.
+Fusion launches new panels through `pi-subagents` `workflowScript`; the panel and judge remain separate durable runs. Older runs created as a single `pi-subagents` chain remain supported when restored.
 
 The base Pi session stays in control. Fusion is a tool for decisions, not a replacement for normal coding.
 
@@ -149,7 +149,7 @@ Profile:
 
 - `panel`: one or more panel members
 - `judge`: judge agent config
-- `concurrency`: max parallel panelists
+- `concurrency`: max parallel panelists. When `stopWhenPanelAgrees` is on, Fusion evaluates the first two panelists before launching another batch so it can avoid work after strong agreement.
 - `timeoutMs`: async subagent timeout in milliseconds
 - `context`: `fresh` or `fork`
 - `stopWhenPanelAgrees`: optional boolean, default `false`. When it is on, Fusion can stop the panelists that have not finished yet. All four conditions must hold: two or more finished panelists give the same normalized recommendation, every one of them reports `high` confidence, none of them asks for more evidence, and work remains. The judge still runs over the answers already collected. This policy is fixed on purpose. There is no threshold to tune.
@@ -451,10 +451,16 @@ For an economical mixed panel, give each member a fast or inexpensive frontier,
 
 `pi-subagents RPC is unavailable`
 
-- install `pi-subagents`
+- install or update `pi-subagents` to 0.43.0 or later
 - reload Pi
 - retry `/fusion status`
 
+`RPC spawn no longer accepts top-level chain or parallel inputs; use workflowScript.`
+
+- update `pi-fusion` to 0.6.1 or later
+- reload Pi so it loads the updated extension
+- retry `/fusion`; do not change your Fusion profile
+
 `Unknown fusion profile`
 
 - verify `defaultProfile`

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@alexeiled/pi-fusion",
-  "version": "0.6.0",
+  "version": "0.6.2",
   "description": "Stronger answers for hard Pi questions via a parallel model panel + judge, built on pi-subagents",
   "type": "module",
   "main": "./src/index.ts",

package/src/orchestrator.ts

@@ -51,6 +51,7 @@ import type { SubagentsTargetParams } from "./subagents-rpc.js";
 export const SUBAGENT_ASYNC_COMPLETE_EVENT = "subagent:async-complete";
 
 const RECONCILE_INTERVAL_MS = 2_000;
+const WORKFLOW_RESULT_ARTIFACT_GRACE_MS = 5_000;
 
 export type FusionNotifyType = "info" | "warning" | "error";
 
@@ -105,6 +106,7 @@ interface RunLifecycleSnapshot {
   statusPayload?: unknown;
   resultPayload?: unknown;
   resultIsTerminal: boolean;
+  resultArtifactPending?: boolean;
 }
 
 export class FusionOrchestrator {
@@ -556,6 +558,7 @@ export class FusionOrchestrator {
       ...(active.chainAsyncDir ? { asyncDir: active.chainAsyncDir } : {}),
       eventPayload: payload,
     });
+    if (snapshot.resultArtifactPending) return { status: "ignored" };
     const terminalPayload =
       snapshot.resultPayload ?? snapshot.statusPayload ?? payload;
     if (
@@ -655,8 +658,12 @@ export class FusionOrchestrator {
           : {}),
       eventPayload: payload,
     });
+    if (snapshot.resultArtifactPending) return { status: "ignored" };
 
-    if (!active.panelStopReason) {
+    const panelIsTerminal =
+      snapshot.resultIsTerminal ||
+      isTerminalSubagentState(extractSubagentState(snapshot.statusPayload));
+    if (!active.panelStopReason && !panelIsTerminal) {
       const partial = extractPanelResults(snapshot.statusPayload, {
         panel: profile.panel,
         completedOnly: true,
@@ -689,12 +696,16 @@ export class FusionOrchestrator {
       return this.failActiveRun(lifecycleError);
     }
 
+    const workflowStoppedIndices = extractWorkflowStoppedPanelIndices(
+      lifecyclePayload,
+    );
+    const stoppedPanelIndices =
+      active.panelStoppedIndices ??
+      (workflowStoppedIndices.length > 0 ? workflowStoppedIndices : undefined);
     const extracted = extractPanelResults(lifecyclePayload, {
       panel: profile.panel,
       limit: profile.panel.length,
-      ...(active.panelStoppedIndices
-        ? { stoppedPanelIndices: active.panelStoppedIndices }
-        : {}),
+      ...(stoppedPanelIndices ? { stoppedPanelIndices } : {}),
     });
     if (!extracted.ok) {
       return this.failActiveRun(
@@ -707,11 +718,18 @@ export class FusionOrchestrator {
       snapshot.statusPayload,
       profile,
     );
-    const updated = this.storePanelResults(
+    const stored = this.storePanelResults(
       active.id,
       observedPanels.outputs,
       observedPanels.failures,
     );
+    const updated =
+      workflowStoppedIndices.length > 0 && !active.panelStopReason
+        ? this.runStore.updateRun(stored.id, {
+            panelStopReason: "agreement",
+            panelStoppedIndices: workflowStoppedIndices,
+          })
+        : stored;
 
     return this.finishPanelCompletion(
       updated,
@@ -840,6 +858,7 @@ export class FusionOrchestrator {
       ...(active.judgeAsyncDir ? { asyncDir: active.judgeAsyncDir } : {}),
       eventPayload: payload,
     });
+    if (snapshot.resultArtifactPending) return { status: "ignored" };
     const terminalPayload =
       snapshot.resultPayload ?? snapshot.statusPayload ?? payload;
     if (
@@ -952,6 +971,17 @@ export class FusionOrchestrator {
       };
     }
 
+    if (
+      statusIsTerminal &&
+      isWorkflowResultArtifactPending(statusPayload)
+    ) {
+      return {
+        statusPayload,
+        resultIsTerminal: false,
+        resultArtifactPending: true,
+      };
+    }
+
     if (hasResultsArray(statusPayload)) {
       return {
         statusPayload,
@@ -1608,10 +1638,46 @@ function isTerminalSubagentState(state: string | undefined): boolean {
   );
 }
 
+function isWorkflowResultArtifactPending(payload: unknown): boolean {
+  if (!isRecord(payload)) return false;
+  const details = isRecord(payload.details) ? payload.details : undefined;
+  const mode = firstString(payload.mode, details?.mode);
+  const endedAtValue = payload.endedAt ?? details?.endedAt;
+  if (mode === "workflow" && typeof endedAtValue === "number") {
+    return Date.now() - endedAtValue < WORKFLOW_RESULT_ARTIFACT_GRACE_MS;
+  }
+  return isRecord(payload.data)
+    ? isWorkflowResultArtifactPending(payload.data)
+    : false;
+}
+
 function hasLifecycleResults(payload: unknown): boolean {
   return hasResultsArray(payload) || findStepsArray(payload).length > 0;
 }
 
+function extractWorkflowStoppedPanelIndices(payload: unknown): number[] {
+  if (!isRecord(payload)) return [];
+  const emits = isRecord(payload.workflow)
+    ? unknownArray(payload.workflow.emits)
+    : undefined;
+  const indices = new Set<number>();
+  for (const emit of emits ?? []) {
+    if (!isRecord(emit) || emit.type !== "pi-fusion-panel-stop") continue;
+    for (const index of unknownArray(emit.indices) ?? []) {
+      if (typeof index === "number" && Number.isInteger(index) && index >= 0) {
+        indices.add(index);
+      }
+    }
+  }
+  if (indices.size > 0) return [...indices].sort((left, right) => left - right);
+  if (isRecord(payload.details)) {
+    const nested = extractWorkflowStoppedPanelIndices(payload.details);
+    if (nested.length > 0) return nested;
+  }
+  if (isRecord(payload.data)) return extractWorkflowStoppedPanelIndices(payload.data);
+  return [];
+}
+
 function extractSubagentFailure(payload: unknown): string | undefined {
   if (!isRecord(payload)) return undefined;
   const direct = firstNonBlankString(payload.error, payload.errorMessage);

package/src/result-extract.ts

@@ -75,6 +75,20 @@ export function extractPanelResults(
     else failures.push(child.failure);
   }
 
+  for (const index of options.stoppedPanelIndices ?? []) {
+    if (index < results.length || index >= (options.limit ?? Infinity)) continue;
+    const child = normalizeChildResult(
+      {
+        success: false,
+        error: "Stopped after strong panel agreement.",
+      },
+      index,
+      options,
+    );
+    if (!child.ok) return child;
+    if (child.status === "failed") failures.push(child.failure);
+  }
+
   const runId = firstString(container.payload.runId, container.payload.id);
   return {
     ok: true,
@@ -197,7 +211,7 @@ function normalizeChildResult(
   }
 
   const member = options.panel?.[index];
-  const agent = firstString(rawResult.agent, member?.agent);
+  const agent = firstString(member?.agent, rawResult.agent);
   if (!agent) {
     return error(
       "missing-result-field",

package/src/run-builder.ts

@@ -36,17 +36,13 @@ export interface PanelSubagentTaskParams {
   model?: string;
 }
 
-export interface PanelChainTaskParams extends PanelSubagentTaskParams {
-  as: string;
-  label: string;
-  phase: "Panel";
+export interface PanelWorkflowTaskParams extends PanelSubagentTaskParams {
+  key: string;
 }
 
 export interface PanelSpawnParams {
-  tasks: PanelSubagentTaskParams[];
+  workflowScript: string;
   async: true;
-  clarify: false;
-  concurrency: number;
   context: "fresh" | "fork";
   output: true;
   outputMode: "inline";
@@ -54,50 +50,26 @@ export interface PanelSpawnParams {
   timeoutMs?: number;
 }
 
-export interface FusionChainParallelStepParams {
-  parallel: PanelChainTaskParams[];
-  concurrency: number;
-  failFast: false;
-}
-
-export interface FusionChainJudgeStepParams {
+export interface JudgeWorkflowTaskParams {
   agent: string;
   task: string;
-  label: "Judge";
-  phase: "Judge";
   output: true;
   outputMode: "inline";
   skill: false;
   acceptance: FusionAcceptanceDisabled;
   model?: string;
-}
-
-export interface FusionChainSpawnParams {
-  chain: [FusionChainParallelStepParams, FusionChainJudgeStepParams];
-  task: string;
-  async: true;
-  clarify: false;
-  context: "fresh" | "fork";
-  output: true;
-  outputMode: "inline";
-  acceptance: FusionAcceptanceDisabled;
-  timeoutMs?: number;
+  /** Per-task cap on judge tool calls; see `FusionProfile.judgeToolBudget`. */
+  toolBudget?: ToolBudget;
 }
 
 export interface JudgeSpawnParams {
-  agent: string;
-  task: string;
+  workflowScript: string;
   async: true;
-  clarify: false;
   context: "fresh" | "fork";
   output: true;
   outputMode: "inline";
-  skill: false;
   acceptance: FusionAcceptanceDisabled;
-  model?: string;
   timeoutMs?: number;
-  /** Per-task cap on judge tool calls; see `FusionProfile.judgeToolBudget`. */
-  toolBudget?: ToolBudget;
 }
 
 export type { FailedPanelSummary, PanelOutput } from "./types.js";
@@ -181,59 +153,25 @@ export function buildPanelSpawnParams(
   profile: FusionProfile,
   prompt: string,
 ): PanelSpawnParams {
-  return {
-    tasks: profile.panel.map((member) =>
-      buildPanelTaskParams(
+  const concurrency = profile.concurrency ?? profile.panel.length;
+  const tasks: PanelWorkflowTaskParams[] = profile.panel.map(
+    (member, index) => ({
+      key: `panel-${index + 1}`,
+      ...buildPanelTaskParams(
         member,
         prompt,
         profile.stopWhenPanelAgrees === true,
       ),
-    ),
-    async: true,
-    clarify: false,
-    concurrency: profile.concurrency ?? profile.panel.length,
-    context: profile.context ?? "fresh",
-    output: true,
-    outputMode: "inline",
-    acceptance: FUSION_ACCEPTANCE_DISABLED,
-    ...(profile.timeoutMs !== undefined
-      ? { timeoutMs: profile.timeoutMs }
-      : {}),
-  };
-}
-
-export function buildFusionChainSpawnParams(
-  profile: FusionProfile,
-  prompt: string,
-): FusionChainSpawnParams {
-  const model = appendThinkingSuffix(
-    profile.judge.model,
-    profile.judge.thinking,
+    }),
   );
+
   return {
-    chain: [
-      {
-        parallel: profile.panel.map((member, index) =>
-          buildPanelChainTaskParams(member, index),
-        ),
-        concurrency: profile.concurrency ?? profile.panel.length,
-        failFast: false,
-      },
-      {
-        agent: profile.judge.agent,
-        task: buildChainJudgeTask(profile.panel),
-        label: "Judge",
-        phase: "Judge",
-        output: true,
-        outputMode: "inline",
-        skill: false,
-        acceptance: FUSION_ACCEPTANCE_DISABLED,
-        ...(model ? { model } : {}),
-      },
-    ],
-    task: prompt.trim(),
+    workflowScript: buildPanelWorkflowScript(
+      tasks,
+      concurrency,
+      profile.stopWhenPanelAgrees === true,
+    ),
     async: true,
-    clarify: false,
     context: profile.context ?? "fresh",
     output: true,
     outputMode: "inline",
@@ -251,12 +189,9 @@ export function buildJudgeSpawnParams(
     input.profile.judge.model,
     input.profile.judge.thinking,
   );
-  return {
+  const task: JudgeWorkflowTaskParams = {
     agent: resolveSynthesisAgent(input.profile),
     task: buildJudgeTask(input),
-    async: true,
-    clarify: false,
-    context: input.profile.context ?? "fresh",
     output: true,
     outputMode: "inline",
     skill: false,
@@ -265,12 +200,66 @@ export function buildJudgeSpawnParams(
     ...(input.profile.judgeToolBudget
       ? { toolBudget: input.profile.judgeToolBudget }
       : {}),
+  };
+
+  return {
+    workflowScript: `return runs.run("judge", ${JSON.stringify(task)});`,
+    async: true,
+    context: input.profile.context ?? "fresh",
+    output: true,
+    outputMode: "inline",
+    acceptance: FUSION_ACCEPTANCE_DISABLED,
     ...(input.profile.timeoutMs !== undefined
       ? { timeoutMs: input.profile.timeoutMs }
       : {}),
   };
 }
 
+function buildPanelWorkflowScript(
+  tasks: readonly PanelWorkflowTaskParams[],
+  concurrency: number,
+  stopWhenAgrees: boolean,
+): string {
+  const serializedTasks = JSON.stringify(tasks);
+  const effectiveConcurrency = stopWhenAgrees
+    ? Math.min(concurrency, 2)
+    : concurrency;
+  const stopLogic = stopWhenAgrees
+    ? [
+        "const decisions = results",
+        "  .filter((result) => result && result.ok === true)",
+        "  .map((result) => {",
+        "    const text = typeof result.output === \"string\" ? result.output : \"\";",
+        "    const match = text.match(/<fusion-panel-decision>([\\s\\S]*?)<\\/fusion-panel-decision>\\s*$/);",
+        "    if (!match) return undefined;",
+        "    try { return JSON.parse(match[1]); } catch { return undefined; }",
+        "  })",
+        "  .filter((decision) => decision && typeof decision.recommendation === \"string\" && decision.confidence === \"high\" && decision.needsMoreEvidence === false);",
+        "if (decisions.length >= 2 && results.length < tasks.length) {",
+        "  const recommendation = decisions[0].recommendation.trim().toLocaleLowerCase().replace(/[^\\p{L}\\p{N}]+/gu, \" \" ).trim(),",
+        "    agrees = recommendation && decisions.every((decision) => decision.recommendation.trim().toLocaleLowerCase().replace(/[^\\p{L}\\p{N}]+/gu, \" \" ).trim() === recommendation);",
+        "  if (agrees) {",
+        "    emit({ type: \"pi-fusion-panel-stop\", indices: tasks.slice(results.length).map((_, index) => results.length + index) });",
+        "    return results;",
+        "  }",
+        "}",
+      ].join("\n")
+    : "";
+
+  return [
+    `const tasks = ${serializedTasks};`,
+    `const concurrency = ${effectiveConcurrency};`,
+    "const results = [];",
+    "for (let index = 0; index < tasks.length; index += concurrency) {",
+    "  results.push(...await runs.all(tasks.slice(index, index + concurrency)));",
+    stopWhenAgrees ? "  " + stopLogic.replaceAll("\n", "\n  ") : "",
+    "}",
+    "return results;",
+  ]
+    .filter(Boolean)
+    .join("\n");
+}
+
 function buildPanelTaskParams(
   member: PanelMemberConfig,
   prompt: string,
@@ -289,26 +278,6 @@ function buildPanelTaskParams(
   };
 }
 
-function buildPanelChainTaskParams(
-  member: PanelMemberConfig,
-  index: number,
-): PanelChainTaskParams {
-  const model = appendThinkingSuffix(member.model, member.thinking);
-  return {
-    agent: member.agent,
-    task: buildPanelTask(member, "{task}", false),
-    as: chainOutputName(member, index),
-    label: memberLabel(member),
-    phase: "Panel",
-    output: true,
-    outputMode: "inline",
-    progress: true,
-    skill: false,
-    acceptance: FUSION_ACCEPTANCE_DISABLED,
-    ...(model ? { model } : {}),
-  };
-}
-
 function buildPanelTask(
   member: PanelMemberConfig,
   prompt: string,
@@ -461,30 +430,6 @@ function formatFacetAssignments(
   });
 }
 
-function buildChainJudgeTask(panel: readonly PanelMemberConfig[]): string {
-  return [
-    "You are the fusion judge.",
-    "Read-only synthesis only. Leave files, git state, and the workspace untouched. Do not ask other agents. Do not run subagents.",
-    "Synthesize the panel results. Preserve disagreement instead of forcing consensus.",
-    "",
-    "Original task:",
-    "{task}",
-    "",
-    "All listed panelists completed successfully.",
-    "",
-    "Panel outputs:",
-    ...panel.flatMap((member, index) => [
-      `## ${memberLabel(member)} (${member.id})`,
-      `Agent: ${member.agent}`,
-      "",
-      `{outputs.${chainOutputName(member, index)}}`,
-      "",
-    ]),
-    "Output contract:",
-    ...JUDGE_OUTPUT_CONTRACT,
-  ].join("\n");
-}
-
 function formatPanelStatus(
   outputs: readonly PanelOutput[],
   failures: readonly FailedPanelSummary[],
@@ -625,12 +570,6 @@ function firstLine(value: string): string {
   return value.split(/\r?\n/, 1)[0]?.trim() || "unknown failure";
 }
 
-function chainOutputName(member: PanelMemberConfig, index: number): string {
-  return /^[A-Za-z_][A-Za-z0-9_]*$/.test(member.id)
-    ? member.id
-    : `panel_${index + 1}`;
-}
-
 function hasThinkingSuffix(model: string): boolean {
   const colonIndex = model.lastIndexOf(":");
   if (colonIndex === -1) return false;