@enderfga/claw-orchestrator 4.1.2 → 4.4.0

package/dist/src/fanout.js

@@ -0,0 +1,146 @@
+/**
+ * Fan-out — run one task across N engines/models in parallel and collect the
+ * results, with an optional synthesis pass.
+ *
+ * This is the cross-engine "diverse perspectives / best-of-N" primitive: each
+ * agent runs in its own session (any engine) against the shared projectDir and
+ * returns an answer. Unlike `council`, there is no consensus voting, no rounds,
+ * and no git-worktree isolation — so it is intended for analysis/generation
+ * that returns text (review from N angles, best-of-N drafts), NOT parallel file
+ * edits. For isolated parallel editing use `council` (per-agent worktrees).
+ */
+import { randomUUID } from 'node:crypto';
+const DEFAULT_AGENT_TIMEOUT_MS = 600_000;
+const DEFAULT_MAX_TURNS = 30;
+export class Fanout {
+    config;
+    manager;
+    logger;
+    session;
+    _aborted = false;
+    constructor(config, manager, logger) {
+        this.config = config;
+        this.manager = manager;
+        this.logger = logger;
+        this.session = {
+            id: `fanout-${randomUUID().slice(0, 8)}`,
+            status: 'running',
+            task: config.task,
+            agentCount: config.agents.length,
+            startedAt: new Date().toISOString(),
+            results: [],
+        };
+    }
+    init() {
+        return this.session;
+    }
+    getSession() {
+        return this.session;
+    }
+    abort() {
+        this._aborted = true;
+        this.session.status = 'aborted';
+    }
+    async run() {
+        try {
+            // Each agent isolates its own failure (never throws); collect all.
+            this.session.results = await Promise.all(this.config.agents.map((a) => this._runAgent(a)));
+            if (!this._aborted && this.config.synthesize) {
+                const ok = this.session.results.filter((r) => r.ok);
+                if (ok.length >= 2)
+                    this.session.synthesis = await this._synthesize(ok);
+            }
+            if (!this._aborted) {
+                this.session.status = 'done';
+                this.session.finishedAt = new Date().toISOString();
+            }
+        }
+        catch (err) {
+            this.session.status = 'error';
+            this.session.error = err.message;
+            this.session.finishedAt = new Date().toISOString();
+        }
+        return this.session;
+    }
+    async _runAgent(spec) {
+        const engine = spec.engine || 'claude';
+        const sessionName = `${this.session.id}-${spec.name}`;
+        const start = Date.now();
+        try {
+            await this.manager.startSession({
+                name: sessionName,
+                cwd: this.config.projectDir,
+                engine,
+                model: spec.model,
+                baseUrl: spec.baseUrl,
+                permissionMode: spec.permissionMode ?? 'bypassPermissions',
+                maxTurns: this.config.maxTurnsPerAgent ?? DEFAULT_MAX_TURNS,
+                maxBudgetUsd: this.config.maxBudgetUsd,
+                customEngine: spec.customEngine,
+            });
+            const result = await this.manager.sendMessage(sessionName, spec.prompt || this.config.task, {
+                timeout: this.config.agentTimeoutMs ?? DEFAULT_AGENT_TIMEOUT_MS,
+            });
+            return {
+                agent: spec.name,
+                engine,
+                model: spec.model,
+                ok: true,
+                output: result.output,
+                durationMs: Date.now() - start,
+            };
+        }
+        catch (err) {
+            return {
+                agent: spec.name,
+                engine,
+                model: spec.model,
+                ok: false,
+                output: '',
+                error: err.message,
+                durationMs: Date.now() - start,
+            };
+        }
+        finally {
+            await this.manager.stopSession(sessionName).catch(() => {
+                // Best-effort cleanup; a dead session is fine to ignore.
+            });
+        }
+    }
+    async _synthesize(results) {
+        const sessionName = `${this.session.id}-synthesis`;
+        const combined = results
+            .map((r, i) => `### Response ${i + 1} — ${r.agent} (${r.engine}${r.model ? `/${r.model}` : ''})\n\n${r.output}`)
+            .join('\n\n---\n\n');
+        const prompt = `You are synthesizing ${results.length} independent responses to the same task. Produce one ` +
+            `consolidated best answer: reconcile agreements, note meaningful disagreements, and keep the ` +
+            `strongest ideas from each.\n\nTask:\n${this.config.task}\n\nResponses:\n\n${combined}`;
+        try {
+            await this.manager.startSession({
+                name: sessionName,
+                cwd: this.config.projectDir,
+                engine: this.config.synthesisEngine || 'claude',
+                model: this.config.synthesisModel,
+                permissionMode: 'bypassPermissions',
+                maxTurns: this.config.maxTurnsPerAgent ?? DEFAULT_MAX_TURNS,
+                maxBudgetUsd: this.config.maxBudgetUsd,
+            });
+            const result = await this.manager.sendMessage(sessionName, prompt, {
+                timeout: this.config.agentTimeoutMs ?? DEFAULT_AGENT_TIMEOUT_MS,
+            });
+            return result.output;
+        }
+        catch (err) {
+            const msg = err.message;
+            this.session.synthesisError = msg;
+            this.logger?.error?.(`Fanout synthesis failed: ${msg}`);
+            return undefined;
+        }
+        finally {
+            await this.manager.stopSession(sessionName).catch(() => {
+                // Best-effort cleanup.
+            });
+        }
+    }
+}
+//# sourceMappingURL=fanout.js.map

package/dist/src/fanout.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"fanout.js","sourceRoot":"","sources":["../../src/fanout.ts"],"names":[],"mappings":"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"}

package/dist/src/inbox-manager.js

@@ -78,10 +78,15 @@ export class InboxManager {
         this.inboxes.delete(name);
     }
     // ── Private ─────────────────────────────────────────────────────────────
-    async _deliverOrQueue(sessionName, msg, lookup) {
+    async _deliverOrQueue(sessionName, sharedMsg, lookup) {
         const managed = lookup.getSession(sessionName);
         if (!managed)
             return false;
+        // Per-recipient copy: a broadcast passes the SAME message object to every
+        // recipient, so mutating read-state in place would let an idle recipient's
+        // delivery mark a busy recipient's queued copy as already-read (then
+        // deliverInbox filters it out and it's lost).
+        const msg = { ...sharedMsg };
         // If session is idle, deliver directly
         if (!managed.session.isBusy && managed.session.isReady) {
             try {

package/dist/src/inbox-manager.js.map

@@ -1 +1 @@
-{"version":3,"file":"inbox-manager.js","sourceRoot":"","sources":["../../src/inbox-manager.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"inbox-manager.js","sourceRoot":"","sources":["../../src/inbox-manager.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AAYhD,MAAM,OAAO,YAAY;IACf,OAAO,GAAG,IAAI,GAAG,EAA0B,CAAC;IAEpD,MAAM,CAAC,aAAa,CAAC,CAAS;QAC5B,OAAO,CAAC,CAAC,OAAO,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC,OAAO,CAAC,IAAI,EAAE,QAAQ,CAAC,CAAC,OAAO,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC,OAAO,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;IACtG,CAAC;IAED,uBAAuB,CAAC,GAAiB;QACvC,MAAM,GAAG,GAAG,YAAY,CAAC,aAAa,CAAC;QACvC,MAAM,KAAK,GAAG,SAAS,GAAG,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,aAAa,GAAG,CAAC,GAAG,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC;QAC9F,OAAO,0BAA0B,KAAK,MAAM,GAAG,CAAC,IAAI,4BAA4B,CAAC;IACnF,CAAC;IAED;;;OAGG;IACH,KAAK,CAAC,MAAM,CACV,IAAY,EACZ,EAAU,EACV,OAAe,EACf,MAAqB,EACrB,OAAgB,EAChB,gBAAqD;QAErD,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC;YAAE,MAAM,IAAI,KAAK,CAAC,mBAAmB,IAAI,aAAa,CAAC,CAAC;QAChF,IAAI,EAAE,KAAK,GAAG,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,EAAE,CAAC;YAAE,MAAM,IAAI,KAAK,CAAC,mBAAmB,EAAE,aAAa,CAAC,CAAC;QAE1F,MAAM,QAAQ,GAAiB;YAC7B,IAAI;YACJ,IAAI,EAAE,OAAO;YACb,SAAS,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;YACnC,IAAI,EAAE,KAAK;YACX,OAAO;SACR,CAAC;QAEF,YAAY;QACZ,IAAI,EAAE,KAAK,GAAG,EAAE,CAAC;YACf,IAAI,SAAS,GAAG,CAAC,CAAC;YAClB,KAAK,MAAM,IAAI,IAAI,MAAM,CAAC,QAAQ,EAAE,EAAE,CAAC;gBACrC,IAAI,IAAI,KAAK,IAAI;oBAAE,SAAS;gBAC5B,IAAI,CAAC;oBACH,MAAM,EAAE,GAAG,MAAM,IAAI,CAAC,eAAe,CAAC,IAAI,EAAE,QAAQ,EAAE,MAAM,CAAC,CAAC;oBAC9D,IAAI,EAAE;wBAAE,SAAS,EAAE,CAAC;gBACtB,CAAC;gBAAC,OAAO,GAAG,EAAE,CAAC;oBACb,gBAAgB,EAAE,CAAC,IAAI,EAAE,GAAY,CAAC,CAAC;gBACzC,CAAC;YACH,CAAC;YACD,OAAO,EAAE,SAAS,EAAE,SAAS,GAAG,CAAC,EAAE,MAAM,EAAE,SAAS,KAAK,CAAC,EAAE,CAAC;QAC/D,CAAC;QAED,MAAM,SAAS,GAAG,MAAM,IAAI,CAAC,eAAe,CAAC,EAAE,EAAE,QAAQ,EAAE,MAAM,CAAC,CAAC;QACnE,OAAO,EAAE,SAAS,EAAE,MAAM,EAAE,CAAC,SAAS,EAAE,CAAC;IAC3C,CAAC;IAED,yCAAyC;IACzC,KAAK,CAAC,IAAY,EAAE,UAAU,GAAG,IAAI;QACnC,MAAM,GAAG,GAAG,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC;QACzC,OAAO,UAAU,CAAC,CAAC,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC;IACvD,CAAC;IAED,qEAAqE;IACrE,KAAK,CAAC,YAAY,CAAC,IAAY,EAAE,MAAqB;QACpD,MAAM,OAAO,GAAG,MAAM,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC;QACxC,IAAI,CAAC,OAAO;YAAE,MAAM,IAAI,KAAK,CAAC,YAAY,IAAI,aAAa,CAAC,CAAC;QAC7D,MAAM,GAAG,GAAG,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;QACnC,IAAI,CAAC,GAAG,IAAI,GAAG,CAAC,MAAM,KAAK,CAAC;YAAE,OAAO,CAAC,CAAC;QAEvC,MAAM,MAAM,GAAG,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;QAC1C,IAAI,MAAM,CAAC,MAAM,KAAK,CAAC;YAAE,OAAO,CAAC,CAAC;QAElC,MAAM,SAAS,GAAG,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,IAAI,CAAC,uBAAuB,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;QAClF,MAAM,OAAO,CAAC,OAAO,CAAC,IAAI,CAAC,SAAS,EAAE,EAAE,eAAe,EAAE,KAAK,EAAE,CAAC,CAAC;QAClE,KAAK,MAAM,CAAC,IAAI,MAAM;YAAE,CAAC,CAAC,IAAI,GAAG,IAAI,CAAC;QACtC,OAAO,MAAM,CAAC,MAAM,CAAC;IACvB,CAAC;IAED,iCAAiC;IACjC,KAAK,CAAC,IAAY;QAChB,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;IAC5B,CAAC;IAED,2EAA2E;IAEnE,KAAK,CAAC,eAAe,CAAC,WAAmB,EAAE,SAAuB,EAAE,MAAqB;QAC/F,MAAM,OAAO,GAAG,MAAM,CAAC,UAAU,CAAC,WAAW,CAAC,CAAC;QAC/C,IAAI,CAAC,OAAO;YAAE,OAAO,KAAK,CAAC;QAE3B,0EAA0E;QAC1E,2EAA2E;QAC3E,qEAAqE;QACrE,8CAA8C;QAC9C,MAAM,GAAG,GAAiB,EAAE,GAAG,SAAS,EAAE,CAAC;QAE3C,uCAAuC;QACvC,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,MAAM,IAAI,OAAO,CAAC,OAAO,CAAC,OAAO,EAAE,CAAC;YACvD,IAAI,CAAC;gBACH,MAAM,OAAO,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,uBAAuB,CAAC,GAAG,CAAC,EAAE,EAAE,eAAe,EAAE,KAAK,EAAE,CAAC,CAAC;gBAC1F,GAAG,CAAC,IAAI,GAAG,IAAI,CAAC;gBAChB,OAAO,IAAI,CAAC;YACd,CAAC;YAAC,MAAM,CAAC;gBACP,wBAAwB;YAC1B,CAAC;QACH,CAAC;QAED,mEAAmE;QACnE,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,WAAW,CAAC;YAAE,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,WAAW,EAAE,EAAE,CAAC,CAAC;QACtE,MAAM,GAAG,GAAG,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,WAAW,CAAE,CAAC;QAC3C,IAAI,GAAG,CAAC,MAAM,IAAI,cAAc,EAAE,CAAC;YACjC,MAAM,OAAO,GAAG,GAAG,CAAC,SAAS,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;YAC7C,IAAI,OAAO,IAAI,CAAC;gBAAE,GAAG,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC;;gBACpC,GAAG,CAAC,KAAK,EAAE,CAAC,CAAC,oCAAoC;QACxD,CAAC;QACD,GAAG,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;QACd,OAAO,KAAK,CAAC;IACf,CAAC;CACF"}

package/dist/src/index.js

@@ -120,8 +120,13 @@ const plugin = {
                         enum: ['acceptEdits', 'bypassPermissions', 'default', 'delegate', 'dontAsk', 'plan', 'auto'],
                     },
                     effort: { type: 'string', enum: ['low', 'medium', 'high', 'xhigh', 'max', 'auto'] },
-                    allowedTools: { type: 'array', items: { type: 'string' }, description: 'Tools to auto-approve' },
-                    disallowedTools: { type: 'array', items: { type: 'string' }, description: 'Tools to deny' },
+                    allowedTools: {
+                        type: 'array',
+                        maxItems: 200,
+                        items: { type: 'string' },
+                        description: 'Tools to auto-approve',
+                    },
+                    disallowedTools: { type: 'array', maxItems: 200, items: { type: 'string' }, description: 'Tools to deny' },
                     maxTurns: { type: 'number', description: 'Max agent loop turns' },
                     maxBudgetUsd: { type: 'number', description: 'Max API spend (USD)' },
                     systemPrompt: { type: 'string', description: 'Replace system prompt' },
@@ -130,7 +135,11 @@ const plugin = {
                     agent: { type: 'string', description: 'Default agent to use' },
                     bare: { type: 'boolean', description: 'Minimal mode: skip hooks, LSP, auto-memory, CLAUDE.md' },
                     worktree: { type: ['string', 'boolean'], description: 'Run in git worktree' },
-                    fallbackModel: { type: 'string', description: 'Auto fallback when primary overloaded' },
+                    fallbackModel: {
+                        type: ['string', 'array'],
+                        items: { type: 'string' },
+                        description: 'Auto fallback when primary overloaded. String or array (tried in order).',
+                    },
                     jsonSchema: { type: 'string', description: 'JSON Schema for structured output' },
                     mcpConfig: {
                         type: ['string', 'array'],
@@ -138,6 +147,14 @@ const plugin = {
                         description: 'MCP server config file(s)',
                     },
                     settings: { type: 'string', description: 'Settings.json path or inline JSON' },
+                    ultracode: {
+                        type: 'boolean',
+                        description: 'Claude engine only. Enable "ultracode" / dynamic workflows: Claude plans a JS orchestration script per substantive task and fans out to subagents. Injected as the ultracode:true settings key (not a --effort value).',
+                    },
+                    codexProfile: {
+                        type: 'string',
+                        description: 'Codex engine only. Named config profile from ~/.codex/config.toml, passed as `codex exec --profile`. Reasoning effort is mapped from the engine-agnostic `effort` param to `-c model_reasoning_effort` automatically.',
+                    },
                     noSessionPersistence: { type: 'boolean', description: 'Do not save session to disk' },
                     betas: { type: ['string', 'array'], items: { type: 'string' }, description: 'Custom beta headers' },
                     enableAgentTeams: { type: 'boolean', description: 'Enable experimental agent teams' },
@@ -244,7 +261,7 @@ const plugin = {
                             },
                             contextWindow: { type: 'number' },
                             env: { type: 'object', description: 'Extra environment variables' },
-                            sanitizePatterns: { type: 'array', items: { type: 'string' } },
+                            sanitizePatterns: { type: 'array', maxItems: 100, items: { type: 'string' } },
                         },
                         required: ['name', 'bin', 'args'],
                     },
@@ -754,6 +771,184 @@ const plugin = {
                 return await getManager().codexGoalCommand(args.name, 'clear', args.timeout);
             },
         });
+        // ─── Codex app-server v2 RPC tools (codex-app engine, Codex 0.137) ────
+        api.registerTool({
+            name: 'codex_interrupt',
+            description: 'Cancel the in-flight turn on a codex-app session (`turn/interrupt`).',
+            parameters: {
+                type: 'object',
+                properties: { name: { type: 'string', description: 'Session name.' } },
+                required: ['name'],
+            },
+            execute: async (_id, args) => getManager().codexInterrupt(args.name),
+        });
+        api.registerTool({
+            name: 'codex_steer',
+            description: 'Add input to the in-flight turn on a codex-app session without restarting it (`turn/steer`). Falls back to a normal turn when idle.',
+            parameters: {
+                type: 'object',
+                properties: {
+                    name: { type: 'string', description: 'Session name.' },
+                    message: { type: 'string', description: 'Text to steer the turn with.' },
+                },
+                required: ['name', 'message'],
+            },
+            execute: async (_id, args) => getManager().codexSteer(args.name, args.message),
+        });
+        api.registerTool({
+            name: 'codex_fork',
+            description: 'Branch a codex-app thread into a new one (`thread/fork`); returns the forked thread id.',
+            parameters: {
+                type: 'object',
+                properties: { name: { type: 'string', description: 'Session name.' } },
+                required: ['name'],
+            },
+            execute: async (_id, args) => getManager().codexForkThread(args.name),
+        });
+        api.registerTool({
+            name: 'codex_rollback',
+            description: 'Drop the last N turns from a codex-app thread (`thread/rollback`).',
+            parameters: {
+                type: 'object',
+                properties: {
+                    name: { type: 'string', description: 'Session name.' },
+                    numTurns: { type: 'number', minimum: 1, description: 'Number of turns to roll back (>=1).' },
+                },
+                required: ['name', 'numTurns'],
+            },
+            execute: async (_id, args) => getManager().codexRollback(args.name, args.numTurns),
+        });
+        api.registerTool({
+            name: 'codex_models',
+            description: 'List models available to a codex-app session (`model/list`), incl. supported reasoning efforts.',
+            parameters: {
+                type: 'object',
+                properties: { name: { type: 'string', description: 'Session name.' } },
+                required: ['name'],
+            },
+            execute: async (_id, args) => getManager().codexModels(args.name),
+        });
+        api.registerTool({
+            name: 'codex_threads',
+            description: 'List Codex threads visible to a codex-app session (`thread/list`), with optional filters.',
+            parameters: {
+                type: 'object',
+                properties: {
+                    name: { type: 'string', description: 'Session name.' },
+                    searchTerm: { type: 'string', description: 'Filter threads by text.' },
+                    cwd: { type: 'string', description: 'Filter to threads under this directory.' },
+                    archived: { type: 'boolean', description: 'Include archived threads.' },
+                    cursor: { type: 'string', description: 'Pagination cursor (from a prior nextCursor).' },
+                    limit: { type: 'number', description: 'Max threads to return.' },
+                },
+                required: ['name'],
+            },
+            execute: async (_id, args) => getManager().codexThreads(args.name, {
+                searchTerm: args.searchTerm,
+                cwd: args.cwd ? sanitizeCwd(args.cwd) : undefined,
+                archived: args.archived,
+                cursor: args.cursor,
+                limit: args.limit,
+            }),
+        });
+        // ─── Tool: claude_agents_list (Claude CLI 2.1.x, claude engine) ───────
+        api.registerTool({
+            name: 'claude_agents_list',
+            description: 'List Claude Code background agent sessions via `claude agents --json` (state/model/title/progress). One-shot, not tied to a managed session.',
+            parameters: {
+                type: 'object',
+                properties: {
+                    all: { type: 'boolean', description: 'Include completed sessions (`--all`).' },
+                    cwd: { type: 'string', description: 'Scope to sessions started under this directory (`--cwd`).' },
+                },
+            },
+            execute: async (_id, args) => getManager().claudeAgentsList({ all: args.all, cwd: args.cwd }),
+        });
+        // ─── Fan-out tools (parallel multi-engine task, no consensus) ─────────
+        api.registerTool({
+            name: 'fanout_start',
+            description: 'Run one task across N engine/model agents IN PARALLEL and collect their answers (optional synthesis). Cross-engine best-of-N / diverse-perspective primitive. No rounds, votes, or worktrees — use council for isolated parallel edits. Runs in background; poll with fanout_status.',
+            parameters: {
+                type: 'object',
+                properties: {
+                    task: {
+                        type: 'string',
+                        description: 'The shared task/prompt sent to every agent (unless an agent overrides it).',
+                    },
+                    projectDir: { type: 'string', description: 'Working directory all agents run in.' },
+                    agents: {
+                        type: 'array',
+                        maxItems: 16,
+                        description: 'Agent specs: { name, engine?, model?, prompt?, baseUrl?, permissionMode?, customEngine? }.',
+                        items: {
+                            type: 'object',
+                            properties: {
+                                name: { type: 'string', minLength: 1, description: 'Unique label (forms the session name).' },
+                                engine: {
+                                    type: 'string',
+                                    enum: ['claude', 'codex', 'codex-app', 'gemini', 'cursor', 'opencode', 'custom'],
+                                },
+                                model: { type: 'string' },
+                                prompt: { type: 'string' },
+                                baseUrl: { type: 'string' },
+                            },
+                            required: ['name'],
+                        },
+                    },
+                    synthesize: {
+                        type: 'boolean',
+                        description: 'Run a final synthesis pass over the successful results (>=2 needed).',
+                    },
+                    synthesisModel: { type: 'string', description: 'Model for the synthesis pass.' },
+                    synthesisEngine: {
+                        type: 'string',
+                        enum: ['claude', 'codex', 'codex-app', 'gemini', 'cursor', 'opencode', 'custom'],
+                        description: 'Engine for the synthesis pass (default claude).',
+                    },
+                    agentTimeoutMs: { type: 'number', description: 'Per-agent timeout in ms (default 600000).' },
+                    maxTurnsPerAgent: { type: 'number', description: 'Max agent loop turns (default 30).' },
+                    maxBudgetUsd: { type: 'number', description: 'Per-agent spend cap (USD).' },
+                },
+                required: ['task', 'projectDir', 'agents'],
+            },
+            execute: async (_id, args) => {
+                const session = getManager().fanoutStart({
+                    task: args.task,
+                    projectDir: sanitizeCwd(args.projectDir),
+                    agents: args.agents,
+                    synthesize: args.synthesize,
+                    synthesisModel: args.synthesisModel,
+                    synthesisEngine: args.synthesisEngine,
+                    agentTimeoutMs: args.agentTimeoutMs,
+                    maxTurnsPerAgent: args.maxTurnsPerAgent,
+                    maxBudgetUsd: args.maxBudgetUsd,
+                });
+                return { ok: true, ...session, note: 'Fan-out running in background. Poll with fanout_status.' };
+            },
+        });
+        api.registerTool({
+            name: 'fanout_status',
+            description: 'Poll a running or finished fan-out by id; returns per-agent results and any synthesis.',
+            parameters: {
+                type: 'object',
+                properties: { id: { type: 'string', description: 'Fan-out id from fanout_start.' } },
+                required: ['id'],
+            },
+            execute: async (_id, args) => ({ ok: true, ...getManager().fanoutStatus(args.id) }),
+        });
+        api.registerTool({
+            name: 'fanout_abort',
+            description: 'Abort a running fan-out by id (already-started agents finish; synthesis is skipped).',
+            parameters: {
+                type: 'object',
+                properties: { id: { type: 'string', description: 'Fan-out id from fanout_start.' } },
+                required: ['id'],
+            },
+            execute: async (_id, args) => {
+                getManager().fanoutAbort(args.id);
+                return { ok: true };
+            },
+        });
         // ─── Tool: council_start ────────────────────────────────────────────
         api.registerTool({
             name: 'council_start',
@@ -780,6 +975,15 @@ const plugin = {
                                 model: { type: 'string', description: 'Model to use' },
                                 baseUrl: { type: 'string', description: 'Custom API endpoint (for proxy)' },
                                 customEngine: { type: 'object', description: 'Custom engine config (when engine="custom")' },
+                                effort: {
+                                    type: 'string',
+                                    enum: ['low', 'medium', 'high', 'xhigh', 'max', 'auto'],
+                                    description: 'Per-agent reasoning effort.',
+                                },
+                                ultracode: {
+                                    type: 'boolean',
+                                    description: 'Per-agent ultracode / dynamic workflows (claude engine only).',
+                                },
                             },
                             required: ['name', 'emoji', 'persona'],
                         },
@@ -1010,6 +1214,11 @@ const plugin = {
                     maxDurationMinutes: { type: 'number', description: 'Max review duration in minutes (5-25, default 10)' },
                     model: { type: 'string', description: 'Model for reviewers (default: session default)' },
                     focus: { type: 'string', description: 'Review focus area (default: bugs + security + quality)' },
+                    engines: {
+                        type: 'array',
+                        items: { type: 'string', enum: ['claude', 'codex', 'codex-app', 'gemini', 'cursor', 'opencode'] },
+                        description: 'Engines to round-robin reviewers across (default ["claude"]). Reviewers fan out in parallel; per-agent failures are isolated.',
+                    },
                 },
                 required: ['cwd'],
             },
@@ -1019,6 +1228,7 @@ const plugin = {
                     maxDurationMinutes: args.maxDurationMinutes,
                     model: args.model,
                     focus: args.focus,
+                    engines: args.engines,
                 });
                 return { ok: true, ...result, note: 'Ultrareview running in background. Poll with ultrareview_status.' };
             },