ac-framework 1.9.5 → 1.9.7

package/framework/web_development/.iflow/commands/ac.md

@@ -98,6 +98,45 @@ acfm memory stats
 
 **User communication:** "Memory saved: [brief description]" when auto-saving occurs.
 
+### SynapseGrid Collaborative MCP Protocol (Optional)
+
+If SynapseGrid is enabled in `acfm init`, AC Framework installs the collaborative MCP server automatically for detected assistants.
+
+**Session-start requirement when collaboration is enabled:**
+1. Prefer the available SynapseGrid MCP tools for collaborative session control before falling back to direct CLI.
+2. Use shared session state and transcript as the source of truth for role-by-role collaboration.
+3. If collaborative MCP is unavailable, use CLI fallback commands and keep behavior equivalent.
+
+**How to use SynapseGrid collaboration:**
+```text
+Preferred: use SynapseGrid MCP tools (ac-framework-collab) for start/status/step/resume/stop.
+Fallback: use AC Framework agents CLI commands directly.
+```
+```bash
+# Install/update collaborative MCP server integrations
+acfm agents install-mcps
+
+# Start collaborative runtime with visible 4-pane tmux war-room
+acfm agents start --task "design and implement feature X" --attach --model-coder provider/model
+
+# If already running in background, attach to panes and inspect logs
+acfm agents live
+acfm agents logs --role all --lines 120
+
+# Resume/list/export operations
+acfm agents resume
+acfm agents list
+acfm agents export --format md --out synapse-session.md
+
+# Fast diagnostics for OpenCode resolution errors
+acfm agents setup
+```
+
+**Troubleshooting notes:**
+- If transcript shows `Agent failed: spawn opencode ENOENT`, run `acfm agents setup` and restart/resume session.
+- If session exists but panes are not visible, use `acfm agents live` (or `acfm agents attach`) or `tmux attach -t <session-name>`.
+- For MCP-first flows, ensure session start enables worker spawning so tmux panes are created.
+- Per-role models can be set at start (`--model-planner`, `--model-critic`, `--model-coder`, `--model-reviewer`) or persisted via `acfm agents model set`.
 
 ### OpenSpec Skills (The heart of the framework)
 

package/framework/web_development/.kilocode/workflows/ac.md

@@ -98,6 +98,45 @@ acfm memory stats
 
 **User communication:** "Memory saved: [brief description]" when auto-saving occurs.
 
+### SynapseGrid Collaborative MCP Protocol (Optional)
+
+If SynapseGrid is enabled in `acfm init`, AC Framework installs the collaborative MCP server automatically for detected assistants.
+
+**Session-start requirement when collaboration is enabled:**
+1. Prefer the available SynapseGrid MCP tools for collaborative session control before falling back to direct CLI.
+2. Use shared session state and transcript as the source of truth for role-by-role collaboration.
+3. If collaborative MCP is unavailable, use CLI fallback commands and keep behavior equivalent.
+
+**How to use SynapseGrid collaboration:**
+```text
+Preferred: use SynapseGrid MCP tools (ac-framework-collab) for start/status/step/resume/stop.
+Fallback: use AC Framework agents CLI commands directly.
+```
+```bash
+# Install/update collaborative MCP server integrations
+acfm agents install-mcps
+
+# Start collaborative runtime with visible 4-pane tmux war-room
+acfm agents start --task "design and implement feature X" --attach --model-coder provider/model
+
+# If already running in background, attach to panes and inspect logs
+acfm agents live
+acfm agents logs --role all --lines 120
+
+# Resume/list/export operations
+acfm agents resume
+acfm agents list
+acfm agents export --format md --out synapse-session.md
+
+# Fast diagnostics for OpenCode resolution errors
+acfm agents setup
+```
+
+**Troubleshooting notes:**
+- If transcript shows `Agent failed: spawn opencode ENOENT`, run `acfm agents setup` and restart/resume session.
+- If session exists but panes are not visible, use `acfm agents live` (or `acfm agents attach`) or `tmux attach -t <session-name>`.
+- For MCP-first flows, ensure session start enables worker spawning so tmux panes are created.
+- Per-role models can be set at start (`--model-planner`, `--model-critic`, `--model-coder`, `--model-reviewer`) or persisted via `acfm agents model set`.
 
 ### OpenSpec Skills (The heart of the framework)
 

package/framework/web_development/.kimi/workflows/ac.md

@@ -98,6 +98,45 @@ acfm memory stats
 
 **User communication:** "Memory saved: [brief description]" when auto-saving occurs.
 
+### SynapseGrid Collaborative MCP Protocol (Optional)
+
+If SynapseGrid is enabled in `acfm init`, AC Framework installs the collaborative MCP server automatically for detected assistants.
+
+**Session-start requirement when collaboration is enabled:**
+1. Prefer the available SynapseGrid MCP tools for collaborative session control before falling back to direct CLI.
+2. Use shared session state and transcript as the source of truth for role-by-role collaboration.
+3. If collaborative MCP is unavailable, use CLI fallback commands and keep behavior equivalent.
+
+**How to use SynapseGrid collaboration:**
+```text
+Preferred: use SynapseGrid MCP tools (ac-framework-collab) for start/status/step/resume/stop.
+Fallback: use AC Framework agents CLI commands directly.
+```
+```bash
+# Install/update collaborative MCP server integrations
+acfm agents install-mcps
+
+# Start collaborative runtime with visible 4-pane tmux war-room
+acfm agents start --task "design and implement feature X" --attach --model-coder provider/model
+
+# If already running in background, attach to panes and inspect logs
+acfm agents live
+acfm agents logs --role all --lines 120
+
+# Resume/list/export operations
+acfm agents resume
+acfm agents list
+acfm agents export --format md --out synapse-session.md
+
+# Fast diagnostics for OpenCode resolution errors
+acfm agents setup
+```
+
+**Troubleshooting notes:**
+- If transcript shows `Agent failed: spawn opencode ENOENT`, run `acfm agents setup` and restart/resume session.
+- If session exists but panes are not visible, use `acfm agents live` (or `acfm agents attach`) or `tmux attach -t <session-name>`.
+- For MCP-first flows, ensure session start enables worker spawning so tmux panes are created.
+- Per-role models can be set at start (`--model-planner`, `--model-critic`, `--model-coder`, `--model-reviewer`) or persisted via `acfm agents model set`.
 
 ### OpenSpec Skills (The heart of the framework)
 

package/framework/web_development/.opencode/command/ac.md

@@ -109,22 +109,34 @@ If SynapseGrid is enabled in `acfm init`, AC Framework installs the collaborativ
 
 **How to use SynapseGrid collaboration:**
 ```text
-Preferred: use SynapseGrid MCP tools (ac-framework-collab) for session start/status/step/stop.
+Preferred: use SynapseGrid MCP tools (ac-framework-collab) for start/status/step/resume/stop.
 Fallback: use AC Framework agents CLI commands directly.
 ```
 ```bash
-# Optional install/reinstall of collaborative MCP servers
+# Install/update collaborative MCP server integrations
 acfm agents install-mcps
 
-# Start collaborative runtime manually
-acfm agents start --task "design and implement feature X"
+# Start collaborative runtime with visible 4-pane tmux war-room
+acfm agents start --task "design and implement feature X" --attach --model-coder provider/model
+
+# If already running in background, attach to panes and inspect logs
+acfm agents live
+acfm agents logs --role all --lines 120
 
 # Resume/list/export operations
 acfm agents resume
 acfm agents list
 acfm agents export --format md --out synapse-session.md
+
+# Fast diagnostics for OpenCode resolution errors
+acfm agents setup
 ```
 
+**Troubleshooting notes:**
+- If transcript shows `Agent failed: spawn opencode ENOENT`, run `acfm agents setup` and restart/resume session.
+- If session exists but panes are not visible, use `acfm agents live` (or `acfm agents attach`) or `tmux attach -t <session-name>`.
+- For MCP-first flows, ensure session start enables worker spawning so tmux panes are created.
+- Per-role models can be set at start (`--model-planner`, `--model-critic`, `--model-coder`, `--model-reviewer`) or persisted via `acfm agents model set`.
 
 ### OpenSpec Skills (The heart of the framework)
 

package/framework/web_development/.qoder/commands/opsx/ac.md

@@ -98,6 +98,45 @@ acfm memory stats
 
 **User communication:** "Memory saved: [brief description]" when auto-saving occurs.
 
+### SynapseGrid Collaborative MCP Protocol (Optional)
+
+If SynapseGrid is enabled in `acfm init`, AC Framework installs the collaborative MCP server automatically for detected assistants.
+
+**Session-start requirement when collaboration is enabled:**
+1. Prefer the available SynapseGrid MCP tools for collaborative session control before falling back to direct CLI.
+2. Use shared session state and transcript as the source of truth for role-by-role collaboration.
+3. If collaborative MCP is unavailable, use CLI fallback commands and keep behavior equivalent.
+
+**How to use SynapseGrid collaboration:**
+```text
+Preferred: use SynapseGrid MCP tools (ac-framework-collab) for start/status/step/resume/stop.
+Fallback: use AC Framework agents CLI commands directly.
+```
+```bash
+# Install/update collaborative MCP server integrations
+acfm agents install-mcps
+
+# Start collaborative runtime with visible 4-pane tmux war-room
+acfm agents start --task "design and implement feature X" --attach --model-coder provider/model
+
+# If already running in background, attach to panes and inspect logs
+acfm agents live
+acfm agents logs --role all --lines 120
+
+# Resume/list/export operations
+acfm agents resume
+acfm agents list
+acfm agents export --format md --out synapse-session.md
+
+# Fast diagnostics for OpenCode resolution errors
+acfm agents setup
+```
+
+**Troubleshooting notes:**
+- If transcript shows `Agent failed: spawn opencode ENOENT`, run `acfm agents setup` and restart/resume session.
+- If session exists but panes are not visible, use `acfm agents live` (or `acfm agents attach`) or `tmux attach -t <session-name>`.
+- For MCP-first flows, ensure session start enables worker spawning so tmux panes are created.
+- Per-role models can be set at start (`--model-planner`, `--model-critic`, `--model-coder`, `--model-reviewer`) or persisted via `acfm agents model set`.
 
 ### OpenSpec Skills (The heart of the framework)
 

package/framework/web_development/.qwen/commands/ac.md

@@ -98,6 +98,45 @@ acfm memory stats
 
 **User communication:** "Memory saved: [brief description]" when auto-saving occurs.
 
+### SynapseGrid Collaborative MCP Protocol (Optional)
+
+If SynapseGrid is enabled in `acfm init`, AC Framework installs the collaborative MCP server automatically for detected assistants.
+
+**Session-start requirement when collaboration is enabled:**
+1. Prefer the available SynapseGrid MCP tools for collaborative session control before falling back to direct CLI.
+2. Use shared session state and transcript as the source of truth for role-by-role collaboration.
+3. If collaborative MCP is unavailable, use CLI fallback commands and keep behavior equivalent.
+
+**How to use SynapseGrid collaboration:**
+```text
+Preferred: use SynapseGrid MCP tools (ac-framework-collab) for start/status/step/resume/stop.
+Fallback: use AC Framework agents CLI commands directly.
+```
+```bash
+# Install/update collaborative MCP server integrations
+acfm agents install-mcps
+
+# Start collaborative runtime with visible 4-pane tmux war-room
+acfm agents start --task "design and implement feature X" --attach --model-coder provider/model
+
+# If already running in background, attach to panes and inspect logs
+acfm agents live
+acfm agents logs --role all --lines 120
+
+# Resume/list/export operations
+acfm agents resume
+acfm agents list
+acfm agents export --format md --out synapse-session.md
+
+# Fast diagnostics for OpenCode resolution errors
+acfm agents setup
+```
+
+**Troubleshooting notes:**
+- If transcript shows `Agent failed: spawn opencode ENOENT`, run `acfm agents setup` and restart/resume session.
+- If session exists but panes are not visible, use `acfm agents live` (or `acfm agents attach`) or `tmux attach -t <session-name>`.
+- For MCP-first flows, ensure session start enables worker spawning so tmux panes are created.
+- Per-role models can be set at start (`--model-planner`, `--model-critic`, `--model-coder`, `--model-reviewer`) or persisted via `acfm agents model set`.
 
 ### OpenSpec Skills (The heart of the framework)
 

package/framework/web_development/.roo/commands/ac.md

@@ -98,6 +98,45 @@ acfm memory stats
 
 **User communication:** "Memory saved: [brief description]" when auto-saving occurs.
 
+### SynapseGrid Collaborative MCP Protocol (Optional)
+
+If SynapseGrid is enabled in `acfm init`, AC Framework installs the collaborative MCP server automatically for detected assistants.
+
+**Session-start requirement when collaboration is enabled:**
+1. Prefer the available SynapseGrid MCP tools for collaborative session control before falling back to direct CLI.
+2. Use shared session state and transcript as the source of truth for role-by-role collaboration.
+3. If collaborative MCP is unavailable, use CLI fallback commands and keep behavior equivalent.
+
+**How to use SynapseGrid collaboration:**
+```text
+Preferred: use SynapseGrid MCP tools (ac-framework-collab) for start/status/step/resume/stop.
+Fallback: use AC Framework agents CLI commands directly.
+```
+```bash
+# Install/update collaborative MCP server integrations
+acfm agents install-mcps
+
+# Start collaborative runtime with visible 4-pane tmux war-room
+acfm agents start --task "design and implement feature X" --attach --model-coder provider/model
+
+# If already running in background, attach to panes and inspect logs
+acfm agents live
+acfm agents logs --role all --lines 120
+
+# Resume/list/export operations
+acfm agents resume
+acfm agents list
+acfm agents export --format md --out synapse-session.md
+
+# Fast diagnostics for OpenCode resolution errors
+acfm agents setup
+```
+
+**Troubleshooting notes:**
+- If transcript shows `Agent failed: spawn opencode ENOENT`, run `acfm agents setup` and restart/resume session.
+- If session exists but panes are not visible, use `acfm agents live` (or `acfm agents attach`) or `tmux attach -t <session-name>`.
+- For MCP-first flows, ensure session start enables worker spawning so tmux panes are created.
+- Per-role models can be set at start (`--model-planner`, `--model-critic`, `--model-coder`, `--model-reviewer`) or persisted via `acfm agents model set`.
 
 ### OpenSpec Skills (The heart of the framework)
 

package/framework/web_development/.windsurf/workflows/ac.md

@@ -98,6 +98,45 @@ acfm memory stats
 
 **User communication:** "Memory saved: [brief description]" when auto-saving occurs.
 
+### SynapseGrid Collaborative MCP Protocol (Optional)
+
+If SynapseGrid is enabled in `acfm init`, AC Framework installs the collaborative MCP server automatically for detected assistants.
+
+**Session-start requirement when collaboration is enabled:**
+1. Prefer the available SynapseGrid MCP tools for collaborative session control before falling back to direct CLI.
+2. Use shared session state and transcript as the source of truth for role-by-role collaboration.
+3. If collaborative MCP is unavailable, use CLI fallback commands and keep behavior equivalent.
+
+**How to use SynapseGrid collaboration:**
+```text
+Preferred: use SynapseGrid MCP tools (ac-framework-collab) for start/status/step/resume/stop.
+Fallback: use AC Framework agents CLI commands directly.
+```
+```bash
+# Install/update collaborative MCP server integrations
+acfm agents install-mcps
+
+# Start collaborative runtime with visible 4-pane tmux war-room
+acfm agents start --task "design and implement feature X" --attach --model-coder provider/model
+
+# If already running in background, attach to panes and inspect logs
+acfm agents live
+acfm agents logs --role all --lines 120
+
+# Resume/list/export operations
+acfm agents resume
+acfm agents list
+acfm agents export --format md --out synapse-session.md
+
+# Fast diagnostics for OpenCode resolution errors
+acfm agents setup
+```
+
+**Troubleshooting notes:**
+- If transcript shows `Agent failed: spawn opencode ENOENT`, run `acfm agents setup` and restart/resume session.
+- If session exists but panes are not visible, use `acfm agents live` (or `acfm agents attach`) or `tmux attach -t <session-name>`.
+- For MCP-first flows, ensure session start enables worker spawning so tmux panes are created.
+- Per-role models can be set at start (`--model-planner`, `--model-critic`, `--model-coder`, `--model-reviewer`) or persisted via `acfm agents model set`.
 
 ### OpenSpec Skills (The heart of the framework)
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "ac-framework",
-  "version": "1.9.5",
+  "version": "1.9.7",
   "description": "Agentic Coding Framework - Multi-assistant configuration system with OpenSpec workflows",
   "main": "src/index.js",
   "exports": {

package/src/agents/config-store.js

@@ -0,0 +1,49 @@
+import { existsSync } from 'node:fs';
+import { mkdir, readFile, writeFile } from 'node:fs/promises';
+import { homedir } from 'node:os';
+import { join } from 'node:path';
+import { DEFAULT_SYNAPSE_MODEL } from './constants.js';
+import { sanitizeRoleModels, normalizeModelId } from './model-selection.js';
+
+const ACFM_DIR = join(homedir(), '.acfm');
+const CONFIG_PATH = join(ACFM_DIR, 'config.json');
+
+function normalizeConfig(raw) {
+  const agents = raw?.agents && typeof raw.agents === 'object' ? raw.agents : {};
+  return {
+    agents: {
+      defaultModel: normalizeModelId(agents.defaultModel) || DEFAULT_SYNAPSE_MODEL,
+      defaultRoleModels: sanitizeRoleModels(agents.defaultRoleModels),
+    },
+  };
+}
+
+export async function loadAgentsConfig() {
+  if (!existsSync(CONFIG_PATH)) {
+    return normalizeConfig({});
+  }
+
+  try {
+    const raw = JSON.parse(await readFile(CONFIG_PATH, 'utf8'));
+    return normalizeConfig(raw);
+  } catch {
+    return normalizeConfig({});
+  }
+}
+
+export async function saveAgentsConfig(config) {
+  const normalized = normalizeConfig(config);
+  await mkdir(ACFM_DIR, { recursive: true });
+  await writeFile(CONFIG_PATH, JSON.stringify(normalized, null, 2) + '\n', 'utf8');
+  return normalized;
+}
+
+export async function updateAgentsConfig(mutator) {
+  const current = await loadAgentsConfig();
+  const next = await mutator(current);
+  return saveAgentsConfig(next);
+}
+
+export function getAgentsConfigPath() {
+  return CONFIG_PATH;
+}

package/src/agents/constants.js

@@ -4,5 +4,6 @@ import { join } from 'node:path';
 export const COLLAB_SYSTEM_NAME = 'SynapseGrid';
 export const COLLAB_ROLES = ['planner', 'critic', 'coder', 'reviewer'];
 export const DEFAULT_MAX_ROUNDS = 3;
+export const DEFAULT_SYNAPSE_MODEL = 'opencode/minimax-m2.5-free';
 export const SESSION_ROOT_DIR = join(homedir(), '.acfm', 'synapsegrid');
 export const CURRENT_SESSION_FILE = join(SESSION_ROOT_DIR, 'current-session.json');

package/src/agents/model-selection.js

@@ -0,0 +1,38 @@
+import { COLLAB_ROLES } from './constants.js';
+
+export function normalizeModelId(value) {
+  if (typeof value !== 'string') return null;
+  const trimmed = value.trim();
+  return trimmed.length > 0 ? trimmed : null;
+}
+
+export function isValidModelId(value) {
+  const normalized = normalizeModelId(value);
+  if (!normalized) return false;
+  return normalized.includes('/');
+}
+
+export function sanitizeRoleModels(input) {
+  const out = {};
+  if (!input || typeof input !== 'object') return out;
+  for (const role of COLLAB_ROLES) {
+    const normalized = normalizeModelId(input[role]);
+    if (normalized) out[role] = normalized;
+  }
+  return out;
+}
+
+export function resolveRoleModel(state, role, fallbackModel = null) {
+  const roleModels = sanitizeRoleModels(state?.roleModels);
+  const roleModel = roleModels[role] || null;
+  const globalModel = normalizeModelId(state?.model) || normalizeModelId(fallbackModel);
+  return roleModel || globalModel || null;
+}
+
+export function buildEffectiveRoleModels(state, fallbackModel = null) {
+  const effective = {};
+  for (const role of COLLAB_ROLES) {
+    effective[role] = resolveRoleModel(state, role, fallbackModel);
+  }
+  return effective;
+}

package/src/agents/opencode-client.js

@@ -1,9 +1,29 @@
-import { execFile } from 'node:child_process';
-import { promisify } from 'node:util';
-
-const execFileAsync = promisify(execFile);
+import { spawn } from 'node:child_process';
 
 function parseOpenCodeRunOutput(stdout) {
+  const ndjsonLines = stdout
+    .split('\n')
+    .map((line) => line.trim())
+    .filter(Boolean);
+
+  if (ndjsonLines.length > 0) {
+    const textChunks = [];
+    for (const line of ndjsonLines) {
+      try {
+        const event = JSON.parse(line);
+        const text = event?.part?.text;
+        if (typeof text === 'string' && text.trim()) {
+          textChunks.push(text.trim());
+        }
+      } catch {
+        // ignore malformed lines and continue
+      }
+    }
+    if (textChunks.length > 0) {
+      return textChunks.join('\n\n');
+    }
+  }
+
   try {
     const parsed = JSON.parse(stdout);
     if (Array.isArray(parsed)) {
@@ -22,7 +42,8 @@ function parseOpenCodeRunOutput(stdout) {
   return stdout.trim();
 }
 
-export async function runOpenCodePrompt({ prompt, cwd, model, agent, timeoutMs = 180000 }) {
+export async function runOpenCodePrompt({ prompt, cwd, model, agent, timeoutMs = 180000, binaryPath }) {
+  const binary = binaryPath || process.env.ACFM_OPENCODE_BIN || 'opencode';
   const args = ['run', '--format', 'json'];
   if (model) {
     args.push('--model', model);
@@ -32,10 +53,48 @@ export async function runOpenCodePrompt({ prompt, cwd, model, agent, timeoutMs =
   }
   args.push('--', prompt);
 
-  const { stdout, stderr } = await execFileAsync('opencode', args, {
-    cwd,
-    timeout: timeoutMs,
-    maxBuffer: 10 * 1024 * 1024,
+  const { stdout, stderr } = await new Promise((resolvePromise, rejectPromise) => {
+    const child = spawn(binary, args, {
+      cwd,
+      env: process.env,
+      stdio: ['ignore', 'pipe', 'pipe'],
+    });
+
+    let out = '';
+    let err = '';
+    let timedOut = false;
+
+    const timer = setTimeout(() => {
+      timedOut = true;
+      child.kill('SIGTERM');
+      setTimeout(() => child.kill('SIGKILL'), 1500).unref();
+    }, timeoutMs);
+
+    child.stdout.on('data', (chunk) => {
+      out += chunk.toString();
+    });
+    child.stderr.on('data', (chunk) => {
+      err += chunk.toString();
+    });
+
+    child.on('error', (error) => {
+      clearTimeout(timer);
+      rejectPromise(error);
+    });
+
+    child.on('close', (code, signal) => {
+      clearTimeout(timer);
+      if (timedOut) {
+        rejectPromise(new Error(`opencode timed out after ${timeoutMs}ms`));
+        return;
+      }
+      if (code !== 0) {
+        const details = [err.trim(), out.trim()].filter(Boolean).join(' | ');
+        rejectPromise(new Error(details || `opencode exited with code ${code}${signal ? ` (${signal})` : ''}`));
+        return;
+      }
+      resolvePromise({ stdout: out, stderr: err });
+    });
   });
 
   const parsed = parseOpenCodeRunOutput(stdout);

package/src/agents/orchestrator.js

@@ -1,6 +1,7 @@
 import { buildAgentPrompt, ROLE_SYSTEM_PROMPTS } from './role-prompts.js';
 import { runOpenCodePrompt } from './opencode-client.js';
 import { nextRole, shouldStop } from './scheduler.js';
+import { resolveRoleModel } from './model-selection.js';
 import {
   addAgentMessage,
   loadSessionState,
@@ -42,11 +43,13 @@ export async function runTurn(sessionId, options = {}) {
     const prompt = buildRuntimePrompt({ state, role: scheduled.role });
     let content;
     try {
+      const effectiveModel = resolveRoleModel(state, scheduled.role, options.model);
       content = await runOpenCodePrompt({
         prompt,
         cwd: options.cwd || process.cwd(),
-        model: options.model,
+        model: effectiveModel,
         agent: options.agent,
+        binaryPath: options.opencodeBin,
         timeoutMs: options.timeoutMs,
       });
     } catch (error) {
@@ -105,11 +108,13 @@ export async function executeActiveTurn(sessionId, role, options = {}) {
     const prompt = buildRuntimePrompt({ state, role });
     let content;
     try {
+      const effectiveModel = resolveRoleModel(state, role, options.model);
       content = await runOpenCodePrompt({
         prompt,
         cwd: options.cwd || process.cwd(),
-        model: options.model,
+        model: effectiveModel,
         agent: options.agent,
+        binaryPath: options.opencodeBin,
         timeoutMs: options.timeoutMs,
       });
     } catch (error) {
@@ -153,11 +158,13 @@ export async function runWorkerIteration(sessionId, role, options = {}) {
     const prompt = buildRuntimePrompt({ state, role });
     let content;
     try {
+      const effectiveModel = resolveRoleModel(state, role, options.model);
       content = await runOpenCodePrompt({
         prompt,
         cwd: options.cwd || process.cwd(),
-        model: options.model,
+        model: effectiveModel,
         agent: options.agent,
+        binaryPath: options.opencodeBin,
         timeoutMs: options.timeoutMs,
       });
     } catch (error) {