orcastrator 0.2.3 → 0.2.5

package/README.md

@@ -82,10 +82,30 @@ export default {
     onTaskComplete: "echo task done: $ORCA_TASK_NAME",
     onComplete: "echo run complete",
     onError: "echo run failed"
+  },
+  codex: {
+    model: "gpt-5.3-codex",       // override the codex model
+    multiAgent: true,              // enable codex multi-agent (see below)
   }
 };
 ```
 
+### Multi-agent mode
+
+Codex supports experimental [multi-agent workflows](https://developers.openai.com/codex/multi-agent) where it can spawn parallel sub-agents for complex tasks.
+
+To enable it in orca, set `codex.multiAgent: true` in your config:
+
+```js
+export default {
+  codex: { multiAgent: true }
+};
+```
+
+When enabled, orca adds `multi_agent = true` to your global `~/.codex/config.toml`. If you already have multi-agent enabled in your Codex config, it will work automatically without setting anything in orca.
+
+> **Note:** Multi-agent is off by default because enabling it modifies your global Codex configuration. It is currently an experimental Codex feature.
+
 ## Reference
 
 ### Flags

package/dist/cli/commands/run.js

@@ -4,6 +4,7 @@ import os from "node:os";
 import path from "node:path";
 import { randomUUID } from "node:crypto";
 import { createCodexSession } from "../../agents/codex/session.js";
+import { ensureCodexMultiAgent } from "../../core/codex-config.js";
 import { resolveConfig } from "../../core/config-loader.js";
 import { runPlanner } from "../../core/planner.js";
 import { runTaskRunner } from "../../core/task-runner.js";
@@ -124,6 +125,10 @@ export async function runCommandHandler(options) {
             await dispatcher.dispatch(event);
         };
         const cwd = process.cwd();
+        const multiAgentResult = await ensureCodexMultiAgent(orcaConfig ?? undefined);
+        if (multiAgentResult.action === "created" || multiAgentResult.action === "appended") {
+            console.log(`Multi-agent: enabled (updated ${multiAgentResult.path})`);
+        }
         const codexSession = await createCodexSession(cwd, orcaConfig ?? undefined);
         try {
             // Phase 4: Codex consults the task graph before execution begins.

package/dist/core/codex-config.js

@@ -0,0 +1,58 @@
+import { constants as fsConstants } from "node:fs";
+import { access, mkdir, readFile, writeFile } from "node:fs/promises";
+import os from "node:os";
+import path from "node:path";
+const CODEX_HOME = path.join(os.homedir(), ".codex");
+const GLOBAL_CONFIG_FILE = path.join(CODEX_HOME, "config.toml");
+const ORCA_MULTI_AGENT_BLOCK = `# Added by orca — remove or set multi_agent = false to disable
+[features]
+multi_agent = true
+`;
+function isMultiAgentEnabled(config) {
+    // Default: off. Only enable if explicitly set to true.
+    return config?.codex?.multiAgent === true;
+}
+function containsMultiAgentSetting(content) {
+    return /multi_agent\s*=/.test(content);
+}
+/**
+ * Ensures `~/.codex/config.toml` has `multi_agent = true` set.
+ *
+ * Uses the global config (not project-scoped) to avoid the "trusted projects"
+ * restriction that prevents project-level config from being loaded headlessly.
+ *
+ * - If the file doesn't exist: creates it with the multi_agent block.
+ * - If the file exists and already has `multi_agent`: leaves it alone.
+ * - If the file exists but has no `multi_agent`: appends the feature block.
+ * - If `multiAgent` is false in orca config: skips entirely.
+ *
+ * @param config - Orca config (checks codex.multiAgent flag)
+ * @param _configFile - Override config file path (for testing only)
+ */
+export async function ensureCodexMultiAgent(config, _configFile) {
+    const configFile = _configFile ?? GLOBAL_CONFIG_FILE;
+    if (!isMultiAgentEnabled(config)) {
+        return { action: "skipped", path: configFile };
+    }
+    let existingContent = null;
+    try {
+        await access(configFile, fsConstants.R_OK);
+        existingContent = await readFile(configFile, "utf8");
+    }
+    catch (err) {
+        if (err.code !== "ENOENT") {
+            throw err;
+        }
+    }
+    if (existingContent === null) {
+        await mkdir(path.dirname(configFile), { recursive: true });
+        await writeFile(configFile, ORCA_MULTI_AGENT_BLOCK, "utf8");
+        return { action: "created", path: configFile };
+    }
+    if (containsMultiAgentSetting(existingContent)) {
+        return { action: "already-set", path: configFile };
+    }
+    const separator = existingContent.endsWith("\n") ? "\n" : "\n\n";
+    await writeFile(configFile, `${existingContent}${separator}${ORCA_MULTI_AGENT_BLOCK}`, "utf8");
+    return { action: "appended", path: configFile };
+}

package/dist/utils/gh.js

@@ -1,16 +1,33 @@
-function decodeStream(stream) {
-    if (!stream) {
-        return Promise.resolve("");
+import { spawn as nodeSpawn } from "node:child_process";
+function spawnProcess(cmd, args) {
+    // Use Bun.spawn when available, fall back to Node.js child_process
+    if (typeof globalThis.Bun !== "undefined") {
+        return (async () => {
+            const proc = globalThis.Bun.spawn([cmd, ...args], {
+                stdout: "pipe",
+                stderr: "pipe"
+            });
+            const [stdout, stderr, exitCode] = await Promise.all([
+                new Response(proc.stdout).text(),
+                new Response(proc.stderr).text(),
+                proc.exited
+            ]);
+            return { stdout, stderr, exitCode };
+        })();
     }
-    return new Response(stream).text();
+    return new Promise((resolve) => {
+        let stdout = "";
+        let stderr = "";
+        const child = nodeSpawn(cmd, args, { stdio: ["ignore", "pipe", "pipe"] });
+        child.stdout?.on("data", (d) => { stdout += d.toString(); });
+        child.stderr?.on("data", (d) => { stderr += d.toString(); });
+        child.on("close", (code) => resolve({ stdout, stderr, exitCode: code ?? 1 }));
+        child.on("error", () => resolve({ stdout, stderr, exitCode: 1 }));
+    });
 }
 export async function checkGhCli() {
     try {
-        const proc = Bun.spawn(["which", "gh"], {
-            stdout: "pipe",
-            stderr: "pipe"
-        });
-        const exitCode = await proc.exited;
+        const { exitCode } = await spawnProcess("which", ["gh"]);
         return exitCode === 0;
     }
     catch {
@@ -18,18 +35,5 @@ export async function checkGhCli() {
     }
 }
 export async function runGh(args) {
-    const proc = Bun.spawn(["gh", ...args], {
-        stdout: "pipe",
-        stderr: "pipe"
-    });
-    const [stdout, stderr, exitCode] = await Promise.all([
-        decodeStream(proc.stdout),
-        decodeStream(proc.stderr),
-        proc.exited
-    ]);
-    return {
-        stdout,
-        stderr,
-        exitCode
-    };
+    return spawnProcess("gh", args);
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "orcastrator",
-  "version": "0.2.3",
+  "version": "0.2.5",
   "type": "module",
   "bin": {
     "orca": "dist/cli/index.js"