@runfusion/fusion 0.23.0 → 0.24.0

package/dist/plugins/fusion-plugin-droid-runtime/manifest.json

@@ -0,0 +1,13 @@
+{
+  "id": "fusion-plugin-droid-runtime",
+  "name": "Droid Runtime Plugin",
+  "version": "0.1.0",
+  "description": "Droid runtime plugin for Fusion",
+  "author": "Fusion Team",
+  "runtime": {
+    "runtimeId": "droid",
+    "name": "Droid Runtime",
+    "description": "Drives the Droid CLI for Fusion agents",
+    "version": "0.1.0"
+  }
+}

package/dist/plugins/fusion-plugin-droid-runtime/mcp-schema-server.cjs

@@ -0,0 +1,49 @@
+#!/usr/bin/env node
+// Schema-only MCP server. Reads tool schemas from a JSON file.
+// Only implements initialize + tools/list. tools/call is never reached
+// because the parent process kills the Claude subprocess at message_stop
+// before tool execution (break-early pattern).
+"use strict";
+
+const fs = require("fs");
+const readline = require("readline");
+
+const schemaPath = process.argv[2];
+if (!schemaPath) {
+  process.exit(1);
+}
+
+let tools = [];
+try {
+  tools = JSON.parse(fs.readFileSync(schemaPath, "utf-8"));
+} catch {
+  process.exit(1);
+}
+
+const rl = readline.createInterface({ input: process.stdin });
+rl.on("line", (line) => {
+  let msg;
+  try {
+    msg = JSON.parse(line);
+  } catch {
+    return;
+  }
+
+  if (msg.method === "initialize") {
+    const resp = {
+      jsonrpc: "2.0",
+      id: msg.id,
+      result: {
+        protocolVersion: "2024-11-05",
+        capabilities: { tools: {} },
+        serverInfo: { name: "custom-tools", version: "1.0.0" },
+      },
+    };
+    process.stdout.write(JSON.stringify(resp) + "\n");
+  } else if (msg.method === "tools/list") {
+    const resp = { jsonrpc: "2.0", id: msg.id, result: { tools } };
+    process.stdout.write(JSON.stringify(resp) + "\n");
+  }
+  // notifications/initialized: no response needed (notification)
+  // tools/call: never reached (break-early kills subprocess first)
+});

package/dist/plugins/fusion-plugin-droid-runtime/package.json

@@ -0,0 +1,11 @@
+{
+  "name": "@fusion-plugin-examples/droid-runtime",
+  "version": "0.1.8",
+  "type": "module",
+  "exports": {
+    ".": {
+      "import": "./bundled.js"
+    }
+  },
+  "private": true
+}

package/dist/plugins/fusion-plugin-hermes-runtime/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@fusion-plugin-examples/hermes-runtime",
-  "version": "0.2.31",
+  "version": "0.2.32",
   "type": "module",
   "exports": {
     ".": {

package/dist/plugins/fusion-plugin-openclaw-runtime/bundled.js

@@ -6,6 +6,7 @@ function definePlugin(plugin2) {
 // ../../plugins/fusion-plugin-openclaw-runtime/dist/pi-module.js
 import { spawn } from "node:child_process";
 import { randomUUID } from "node:crypto";
+import { readFile } from "node:fs/promises";
 var DEFAULT_BINARY = "openclaw";
 var DEFAULT_AGENT_ID = "main";
 var DEFAULT_THINKING = "off";
@@ -46,12 +47,16 @@ function resolveCliConfig(settings) {
     useGateway: asBool(settings?.useGateway) ?? asBool(process.env.OPENCLAW_USE_GATEWAY) ?? false
   };
 }
-function buildOpenClawArgs(config, sessionId, message) {
-  const args = ["--no-color", "agent"];
+function buildOpenClawArgs(config, session, message) {
+  const args = ["--no-color"];
+  if (session.mcpProfile) {
+    args.push("--profile", session.mcpProfile);
+  }
+  args.push("agent");
   if (!config.useGateway)
     args.push("--local");
   args.push("--json");
-  args.push("--session-id", sessionId);
+  args.push("--session-id", session.sessionId);
   args.push("--message", message);
   args.push("--agent", config.agentId);
   if (config.model) {
@@ -78,11 +83,33 @@ function createCliSession(opts) {
     messages: [{ role: "developer", content: opts.systemPrompt }],
     lastModelDescription: `openclaw/${opts.agentId ?? DEFAULT_AGENT_ID}`,
     lastUsage: void 0,
-    callbacks: opts.callbacks
+    callbacks: opts.callbacks,
+    mcpProfile: opts.mcpProfile,
+    mcpConfigPath: opts.mcpConfigPath
   };
 }
+async function configureOpenClawMcpServer(opts) {
+  const serverValue = await readFile(opts.serverConfigPath, "utf-8");
+  await new Promise((resolve, reject) => {
+    const child = spawn(opts.binaryPath, ["--no-color", "--profile", opts.profile, "mcp", "set", opts.serverName, serverValue], {
+      stdio: ["ignore", "pipe", "pipe"]
+    });
+    let stderr = "";
+    child.stderr?.on("data", (chunk) => {
+      stderr += chunk.toString("utf-8");
+    });
+    child.on("error", (err) => reject(new Error(`openclaw: failed to configure MCP server \u2014 ${err.message}`)));
+    child.on("close", (code) => {
+      if (code === 0) {
+        resolve();
+        return;
+      }
+      reject(new Error(`openclaw: mcp set failed (${String(code)}): ${extractStderrError(stderr)}`));
+    });
+  });
+}
 async function promptCli(session, message, config, callbacks, signal) {
-  const args = buildOpenClawArgs(config, session.sessionId, message);
+  const args = buildOpenClawArgs(config, session, message);
   const cb = { ...session.callbacks, ...callbacks };
   cb.onToolStart?.("openclaw.agent", { sessionId: session.sessionId });
   return new Promise((resolve, reject) => {
@@ -186,7 +213,44 @@ function describeCliModel(session) {
   return session.lastModelDescription || `openclaw/${session.agentId}`;
 }
 
+// ../../plugins/fusion-plugin-openclaw-runtime/dist/mcp-config.js
+import { writeFileSync } from "node:fs";
+import { tmpdir } from "node:os";
+import { join } from "node:path";
+import { fileURLToPath } from "node:url";
+import { dirname } from "node:path";
+var BUILT_IN_TOOL_NAMES = /* @__PURE__ */ new Set(["read", "write", "edit", "bash", "grep", "find"]);
+function toolsToMcpToolDefs(tools) {
+  if (!Array.isArray(tools))
+    return [];
+  return tools.filter((tool) => tool && typeof tool.name === "string" && !BUILT_IN_TOOL_NAMES.has(tool.name)).map((tool) => ({
+    name: tool.name,
+    description: typeof tool.description === "string" ? tool.description : "",
+    inputSchema: tool.parameters ?? { type: "object", properties: {} }
+  }));
+}
+function writeOpenClawMcpBridgeFiles(toolDefs, cacheKey) {
+  const suffix = cacheKey ? `${process.pid}-${cacheKey}` : `${process.pid}`;
+  const schemaPath = join(tmpdir(), `openclaw-runtime-mcp-schemas-${suffix}.json`);
+  writeFileSync(schemaPath, JSON.stringify(toolDefs));
+  const __filename = fileURLToPath(import.meta.url);
+  const __dirname = dirname(__filename);
+  const serverPath = join(__dirname, "mcp-schema-server.cjs");
+  const serverConfig = {
+    command: "node",
+    args: [serverPath, schemaPath]
+  };
+  const serverConfigPath = join(tmpdir(), `openclaw-runtime-mcp-server-${suffix}.json`);
+  writeFileSync(serverConfigPath, JSON.stringify(serverConfig));
+  return {
+    schemaPath,
+    serverConfigPath,
+    serverName: "fusion-custom-tools"
+  };
+}
+
 // ../../plugins/fusion-plugin-openclaw-runtime/dist/runtime-adapter.js
+import { randomUUID as randomUUID2 } from "node:crypto";
 var OpenClawRuntimeAdapter = class {
   id = "openclaw";
   name = "OpenClaw Runtime";
@@ -195,9 +259,29 @@ var OpenClawRuntimeAdapter = class {
     this.config = resolveCliConfig(settings);
   }
   async createSession(options) {
+    const contextTools = [
+      ...Array.isArray(options.tools) ? options.tools : [],
+      ...Array.isArray(options.customTools) ? options.customTools : []
+    ];
+    const toolDefs = toolsToMcpToolDefs(contextTools);
+    let mcpProfile;
+    let mcpConfigPath;
+    if (toolDefs.length > 0) {
+      const bridge = writeOpenClawMcpBridgeFiles(toolDefs, randomUUID2());
+      mcpProfile = `fusion-${randomUUID2()}`;
+      mcpConfigPath = bridge.serverConfigPath;
+      await configureOpenClawMcpServer({
+        binaryPath: this.config.binaryPath,
+        profile: mcpProfile,
+        serverName: bridge.serverName,
+        serverConfigPath: bridge.serverConfigPath
+      });
+    }
     const session = createCliSession({
       systemPrompt: options.systemPrompt,
       agentId: this.config.agentId,
+      mcpProfile,
+      mcpConfigPath,
       callbacks: {
         onText: options.onText,
         onThinking: options.onThinking,
@@ -357,6 +441,7 @@ export {
   OPENCLAW_RUNTIME_ID,
   OpenClawRuntimeAdapter,
   buildOpenClawArgs,
+  configureOpenClawMcpServer,
   createCliSession,
   index_default as default,
   describeCliModel,
@@ -365,5 +450,7 @@ export {
   openclawRuntimeMetadata,
   probeOpenClawBinary,
   promptCli,
-  resolveCliConfig
+  resolveCliConfig,
+  toolsToMcpToolDefs,
+  writeOpenClawMcpBridgeFiles
 };

package/dist/plugins/fusion-plugin-openclaw-runtime/mcp-schema-server.cjs

@@ -0,0 +1,59 @@
+"use strict";
+
+const fs = require("fs");
+const readline = require("readline");
+
+const schemaPath = process.argv[2];
+if (!schemaPath) process.exit(1);
+
+let tools = [];
+try {
+  tools = JSON.parse(fs.readFileSync(schemaPath, "utf-8"));
+} catch {
+  process.exit(1);
+}
+
+const rl = readline.createInterface({ input: process.stdin });
+rl.on("line", (line) => {
+  let msg;
+  try {
+    msg = JSON.parse(line);
+  } catch {
+    return;
+  }
+
+  if (msg.method === "initialize") {
+    process.stdout.write(
+      JSON.stringify({
+        jsonrpc: "2.0",
+        id: msg.id,
+        result: {
+          protocolVersion: "2024-11-05",
+          capabilities: { tools: {} },
+          serverInfo: { name: "fusion-custom-tools", version: "1.0.0" },
+        },
+      }) + "\n",
+    );
+    return;
+  }
+
+  if (msg.method === "tools/list") {
+    process.stdout.write(
+      JSON.stringify({ jsonrpc: "2.0", id: msg.id, result: { tools } }) + "\n",
+    );
+    return;
+  }
+
+  if (msg.method === "tools/call") {
+    process.stdout.write(
+      JSON.stringify({
+        jsonrpc: "2.0",
+        id: msg.id,
+        result: {
+          content: [{ type: "text", text: "Tool execution is handled by Fusion runtime." }],
+          isError: true,
+        },
+      }) + "\n",
+    );
+  }
+});

package/dist/plugins/fusion-plugin-openclaw-runtime/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@fusion-plugin-examples/openclaw-runtime",
-  "version": "0.2.31",
+  "version": "0.2.32",
   "type": "module",
   "exports": {
     ".": {

package/dist/plugins/fusion-plugin-paperclip-runtime/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@fusion-plugin-examples/paperclip-runtime",
-  "version": "0.2.31",
+  "version": "0.2.32",
   "type": "module",
   "exports": {
     ".": {

package/dist/plugins/fusion-plugin-reports/manifest.json

@@ -0,0 +1,33 @@
+{
+  "id": "fusion-plugin-reports",
+  "name": "Reports",
+  "version": "0.1.0",
+  "description": "Generates beautiful HTML system-activity reports with multi-agent review.",
+  "author": "Fusion Team",
+  "fusionVersion": ">=0.1.0",
+  "settingsSchema": {
+    "dailyEnabled": { "type": "boolean", "label": "Enable Daily Reports", "description": "Generate daily reports on schedule.", "group": "Schedules", "defaultValue": true },
+    "dailyCron": { "type": "string", "label": "Daily Schedule (cron)", "description": "Cron expression for daily report generation.", "group": "Schedules", "required": true, "defaultValue": "0 8 * * *" },
+    "weeklyEnabled": { "type": "boolean", "label": "Enable Weekly Reports", "description": "Generate weekly reports on schedule.", "group": "Schedules", "defaultValue": true },
+    "weeklyCron": { "type": "string", "label": "Weekly Schedule (cron)", "description": "Cron expression for weekly report generation.", "group": "Schedules", "required": true, "defaultValue": "0 8 * * 1" },
+    "timezone": { "type": "string", "label": "Timezone", "description": "IANA timezone used for schedule evaluation.", "group": "Schedules", "required": true, "defaultValue": "UTC" },
+    "generationPromptDaily": { "type": "string", "multiline": true, "label": "Daily Generation Prompt", "description": "Prompt template used to generate daily reports.", "group": "Prompts", "required": true, "defaultValue": "Summarize today's system activity with clear wins, highlights, lowlights, and proposals." },
+    "generationPromptWeekly": { "type": "string", "multiline": true, "label": "Weekly Generation Prompt", "description": "Prompt template used to generate weekly reports.", "group": "Prompts", "required": true, "defaultValue": "Summarize this week's system activity trends, major outcomes, and actionable proposals." },
+    "reviewPrompt": { "type": "string", "multiline": true, "label": "Review Prompt", "description": "Prompt template used by reviewer agents.", "group": "Prompts", "required": true, "defaultValue": "Review this report for factual accuracy, clarity, and actionability. Provide concrete revision suggestions." },
+    "reviewPanelAgentIds": { "type": "array", "itemType": "string", "label": "Reviewer Agent IDs", "description": "Agent IDs allowed to review generated reports.", "group": "Review Panel", "defaultValue": [] },
+    "reviewMinApprovals": { "type": "number", "label": "Minimum Approvals", "description": "How many approvals are required from the review panel.", "group": "Review Panel", "defaultValue": 1 },
+    "reviewBlockingMode": { "type": "enum", "enumValues": ["block", "advisory"], "label": "Review Blocking Mode", "description": "Choose whether failed review blocks publication.", "group": "Review Panel", "defaultValue": "advisory" },
+    "sectionOrder": { "type": "array", "itemType": "string", "label": "Section Order", "description": "Ordered section IDs for report rendering.", "group": "Sections", "defaultValue": ["wins", "highlights", "lowlights", "proposals", "deep-dives", "per-agent"] },
+    "enabledSections": { "type": "array", "itemType": "string", "label": "Enabled Sections", "description": "Section IDs enabled for output.", "group": "Sections", "defaultValue": ["wins", "highlights", "lowlights", "proposals", "deep-dives", "per-agent"] },
+    "includeSystemSummary": { "type": "boolean", "label": "Include System Summary", "description": "Include top-level system summary in report output.", "group": "Sections", "defaultValue": true },
+    "includePerAgentSections": { "type": "boolean", "label": "Include Per-Agent Sections", "description": "Include per-agent detail sections.", "group": "Sections", "defaultValue": true },
+    "brandTitle": { "type": "string", "label": "Report Title", "description": "Primary report title for branding.", "group": "Branding", "required": true, "defaultValue": "Fusion Activity Report" },
+    "brandLogoUrl": { "type": "string", "label": "Logo URL", "description": "Optional URL to a brand logo image.", "group": "Branding" },
+    "themeMode": { "type": "enum", "enumValues": ["light", "dark", "auto"], "label": "Theme Mode", "description": "Theme style for generated reports.", "group": "Branding", "defaultValue": "auto" },
+    "accentColor": { "type": "string", "label": "Accent Color", "description": "Accent color used in report styling.", "group": "Branding", "defaultValue": "#5B8DEF" },
+    "approvalRequired": { "type": "boolean", "label": "Require Approval", "description": "Require explicit approval before publishing.", "group": "Approval Flow", "defaultValue": false },
+    "autoPublishOnApproval": { "type": "boolean", "label": "Auto Publish on Approval", "description": "Publish automatically after approval threshold is met.", "group": "Approval Flow", "defaultValue": true },
+    "approverAgentIds": { "type": "array", "itemType": "string", "label": "Approver Agent IDs", "description": "Agent IDs permitted to approve final publish.", "group": "Approval Flow", "defaultValue": [] },
+    "publishTargets": { "type": "array", "itemType": "string", "label": "Publish Targets", "description": "Destinations to publish reports to (for example dashboard, html-export).", "group": "Approval Flow", "defaultValue": [] }
+  }
+}

package/dist/plugins/fusion-plugin-reports/package.json

@@ -0,0 +1,26 @@
+{
+  "name": "@fusion-plugin-examples/reports",
+  "version": "0.1.1",
+  "type": "module",
+  "description": "Reports plugin for Fusion",
+  "private": true,
+  "exports": {
+    ".": {
+      "types": "./src/index.ts",
+      "import": "./src/index.ts"
+    }
+  },
+  "scripts": {
+    "build": "tsc",
+    "test": "vitest run --silent=passed-only --reporter=dot"
+  },
+  "dependencies": {
+    "@fusion/core": "workspace:*",
+    "@fusion/plugin-sdk": "workspace:*"
+  },
+  "devDependencies": {
+    "@types/node": "^25.5.2",
+    "typescript": "^5.7.0",
+    "vitest": "^3.2.4"
+  }
+}

package/dist/plugins/fusion-plugin-reports/src/__tests__/manifest.test.ts

@@ -0,0 +1,51 @@
+import { describe, expect, it } from "vitest";
+import manifest from "../../manifest.json";
+import plugin from "../index.js";
+
+const expectedKeys = [
+  "dailyEnabled",
+  "dailyCron",
+  "weeklyEnabled",
+  "weeklyCron",
+  "timezone",
+  "generationPromptDaily",
+  "generationPromptWeekly",
+  "reviewPrompt",
+  "reviewPanelAgentIds",
+  "reviewMinApprovals",
+  "reviewBlockingMode",
+  "sectionOrder",
+  "enabledSections",
+  "includeSystemSummary",
+  "includePerAgentSections",
+  "brandTitle",
+  "brandLogoUrl",
+  "themeMode",
+  "accentColor",
+  "approvalRequired",
+  "autoPublishOnApproval",
+  "approverAgentIds",
+  "publishTargets",
+] as const;
+
+describe("reports plugin manifest", () => {
+  it("exports expected plugin id", () => {
+    expect(plugin.manifest.id).toBe("fusion-plugin-reports");
+  });
+
+  it("keeps runtime manifest metadata aligned with manifest.json", () => {
+    expect(plugin.manifest.id).toBe(manifest.id);
+    expect(plugin.manifest.name).toBe(manifest.name);
+    expect(plugin.manifest.version).toBe(manifest.version);
+    expect(plugin.manifest.description).toBe(manifest.description);
+    expect(plugin.manifest.author).toBe(manifest.author);
+    expect(plugin.manifest.fusionVersion).toBe(manifest.fusionVersion);
+  });
+
+  it("includes full settings schema", () => {
+    expect(plugin.manifest.settingsSchema).toBeDefined();
+    for (const key of expectedKeys) {
+      expect(plugin.manifest.settingsSchema).toHaveProperty(key);
+    }
+  });
+});

package/dist/plugins/fusion-plugin-reports/src/__tests__/review-panel.test.ts

@@ -0,0 +1,166 @@
+import { afterEach, describe, expect, it, vi } from "vitest";
+import type { CreateAiSessionFactory, PluginContext } from "@fusion/core";
+import { __setCreateAiSessionFactory, combineReviews, runReviewPanel } from "../review-panel.js";
+import type { ReviewPanelMember } from "../review-types.js";
+import { ReviewPanelError } from "../review-types.js";
+
+function createContext(createAiSession?: CreateAiSessionFactory): PluginContext {
+  return {
+    pluginId: "fusion-plugin-reports",
+    taskStore: {} as PluginContext["taskStore"],
+    settings: {},
+    logger: { info: vi.fn(), warn: vi.fn(), error: vi.fn(), debug: vi.fn() },
+    emitEvent: vi.fn(),
+    createAiSession,
+  };
+}
+
+const panel: ReviewPanelMember[] = [
+  { id: "qa", name: "QA", perspective: "Quality" },
+  { id: "ops", name: "Ops", perspective: "Operations" },
+  { id: "pm", name: "PM", perspective: "Product" },
+];
+
+afterEach(() => {
+  __setCreateAiSessionFactory(undefined);
+  vi.restoreAllMocks();
+  vi.useRealTimers();
+});
+
+describe("runReviewPanel", () => {
+  it("returns individual and combined reviews for a 3-member panel", async () => {
+    const createAiSession = vi.fn(async ({ systemPrompt }) => ({
+      session: {
+        prompt: vi.fn(async () => {}),
+        state: {
+          messages: [{ role: "assistant", content: JSON.stringify({ verdict: "approve", summary: systemPrompt, highlights: ["A"], lowlights: ["B"], suggestions: ["C"] }) }],
+        },
+        dispose: vi.fn(),
+      },
+    }));
+
+    const result = await runReviewPanel({
+      reportDraft: "draft",
+      reportMetadata: { reportId: "r-1", cadence: "daily", periodStart: "2026-01-01", periodEnd: "2026-01-02" },
+      panel,
+      cwd: "/tmp",
+    }, createContext(createAiSession));
+
+    expect(result.individual).toHaveLength(3);
+    expect(result.failures).toEqual([]);
+    expect(result.overallVerdict).toBe("approve");
+    expect(result.consensusSummary).toContain("Quality:");
+  });
+
+  it("deduplicates merged arrays in first-seen order", () => {
+    const merged = combineReviews([
+      { memberId: "a", memberName: "A", perspective: "P1", verdict: "approve", summary: "ok", highlights: [" Alpha ", "Beta"], lowlights: ["Lag"], suggestions: ["Fix docs"], rawText: "", durationMs: 1 },
+      { memberId: "b", memberName: "B", perspective: "P2", verdict: "approve", summary: "ok", highlights: ["alpha", "Gamma"], lowlights: [" lag "], suggestions: ["fix docs", "Add tests"], rawText: "", durationMs: 1 },
+    ], []);
+
+    expect(merged.mergedHighlights).toEqual(["Alpha", "Beta", "Gamma"]);
+    expect(merged.mergedLowlights).toEqual(["Lag"]);
+    expect(merged.mergedSuggestions).toEqual(["Fix docs", "Add tests"]);
+  });
+
+  it("applies verdict precedence", () => {
+    const revise = combineReviews([
+      { memberId: "a", memberName: "A", perspective: "P1", verdict: "approve", summary: "ok", highlights: [], lowlights: [], suggestions: [], rawText: "", durationMs: 1 },
+      { memberId: "b", memberName: "B", perspective: "P2", verdict: "revise", summary: "rev", highlights: [], lowlights: [], suggestions: [], rawText: "", durationMs: 1 },
+    ], []);
+    expect(revise.overallVerdict).toBe("revise");
+
+    const reject = combineReviews([
+      { memberId: "a", memberName: "A", perspective: "P1", verdict: "approve", summary: "ok", highlights: [], lowlights: [], suggestions: [], rawText: "", durationMs: 1 },
+      { memberId: "b", memberName: "B", perspective: "P2", verdict: "reject", summary: "no", highlights: [], lowlights: [], suggestions: [], rawText: "", durationMs: 1 },
+    ], []);
+    expect(reject.overallVerdict).toBe("reject");
+  });
+
+  it("records timeout failure without aborting other reviewers", async () => {
+    vi.useFakeTimers();
+    const createAiSession = vi.fn(async ({ systemPrompt }) => {
+      if (systemPrompt.includes("Operations")) {
+        return {
+          session: {
+            prompt: vi.fn(async () => new Promise(() => {})),
+            state: { messages: [] },
+            dispose: vi.fn(),
+          },
+        };
+      }
+      return {
+        session: {
+          prompt: vi.fn(async () => {}),
+          state: { messages: [{ role: "assistant", content: JSON.stringify({ verdict: "approve", summary: "ok", highlights: [], lowlights: [], suggestions: [] }) }] },
+          dispose: vi.fn(),
+        },
+      };
+    });
+
+    const promise = runReviewPanel({
+      reportDraft: "draft",
+      reportMetadata: { reportId: "r-1", cadence: "daily", periodStart: "2026-01-01", periodEnd: "2026-01-02" },
+      panel,
+      cwd: "/tmp",
+    }, createContext(createAiSession));
+
+    await vi.advanceTimersByTimeAsync(120_000);
+    const result = await promise;
+
+    expect(result.individual).toHaveLength(2);
+    expect(result.failures).toHaveLength(1);
+    expect(result.failures[0]?.reason).toBe("timeout");
+  });
+
+  it("retries malformed JSON once then reports parse_error", async () => {
+    const prompt = vi.fn(async () => {});
+    const createAiSession = vi.fn(async () => ({
+      session: {
+        prompt,
+        state: { messages: [{ role: "assistant", content: "not-json" }] },
+        dispose: vi.fn(),
+      },
+    }));
+
+    const result = await runReviewPanel({
+      reportDraft: "draft",
+      reportMetadata: { reportId: "r-1", cadence: "daily", periodStart: "2026-01-01", periodEnd: "2026-01-02" },
+      panel: [panel[0]],
+      cwd: "/tmp",
+    }, createContext(createAiSession));
+
+    expect(prompt).toHaveBeenCalledTimes(2);
+    expect(result.individual).toEqual([]);
+    expect(result.failures).toHaveLength(1);
+    expect(result.failures[0]?.reason).toBe("parse_error");
+  });
+
+  it("throws ReviewPanelError when createAiSession is unavailable", async () => {
+    await expect(runReviewPanel({
+      reportDraft: "draft",
+      reportMetadata: { reportId: "r-1", cadence: "daily", periodStart: "2026-01-01", periodEnd: "2026-01-02" },
+      panel,
+      cwd: "/tmp",
+    }, createContext(undefined))).rejects.toBeInstanceOf(ReviewPanelError);
+  });
+
+  it("forwards provider/modelId to createAiSession per member", async () => {
+    const createAiSession = vi.fn(async () => ({
+      session: {
+        prompt: vi.fn(async () => {}),
+        state: { messages: [{ role: "assistant", content: JSON.stringify({ verdict: "approve", summary: "ok", highlights: [], lowlights: [], suggestions: [] }) }] },
+        dispose: vi.fn(),
+      },
+    }));
+
+    await runReviewPanel({
+      reportDraft: "draft",
+      reportMetadata: { reportId: "r-1", cadence: "daily", periodStart: "2026-01-01", periodEnd: "2026-01-02" },
+      panel: [{ id: "m1", name: "M1", perspective: "P", provider: "anthropic", modelId: "claude" }],
+      cwd: "/tmp",
+    }, createContext(createAiSession));
+
+    expect(createAiSession).toHaveBeenCalledWith(expect.objectContaining({ defaultProvider: "anthropic", defaultModelId: "claude" }));
+  });
+});