@cotal-ai/orca 0.11.1

package/README.md

@@ -0,0 +1,49 @@
+# @cotal-ai/orca
+
+The Orca integration: a thin driver over the public `orca` CLI plus a self-registering
+`orca` `Runtime` provider. Importing it registers the runtime with the core `Registry`, so
+the manager can spawn agents into native Orca terminals.
+
+**Tier:** `extensions/`. Depends on [`@cotal-ai/core`](../../packages/core); self-registers on
+import.
+
+## What it does
+
+- Resolves the launch `cwd` to the enclosing Orca worktree with `orca worktree current --json`,
+  then targets that stable worktree id for terminal creation.
+- Runs the agent from the exact launch `cwd`, even though Orca terminals are attached to the
+  worktree.
+- Keeps Cotal launch env and credentials out of the Orca command line by writing a private Node
+  launcher script, passing only `exec '<node>' '<script>'` to Orca, and deleting the launcher after it loads.
+- Forces Orca CLI lifecycle calls to the local runtime by removing ambient remote-runtime selectors.
+- Uses Orca terminal handles for status, interrupt, and close. Watching is native: switch to the
+  Orca tab rather than `cotal attach`.
+- Contributes a `Runtime` only, not a `TerminalLayout` provider for setup layouts.
+
+Orca must open terminals with a POSIX-compatible shell that supports `exec` and single-quoted
+arguments. Driver calls are synchronous because Cotal's `Runtime` lifecycle contract is synchronous;
+short probe caches batch status checks and repeated launches from the same cwd.
+
+## Usage
+
+Install it into the published CLI:
+
+```bash
+cotal ext add @cotal-ai/orca
+cotal supervise --runtime orca
+```
+
+Library composition roots can still import it explicitly:
+
+```ts
+import "@cotal-ai/orca"; // self-registers
+```
+
+The runtime can also be selected with `runtime: orca` in a mesh manifest.
+
+## Testing
+
+`pnpm smoke:orca:live` exercises the driver and runtime directly. `pnpm smoke:orca-e2e:live`
+runs the complete operator journey against live Orca and Claude Code: install this package with
+`cotal ext`, launch a `runtime: orca` manifest, observe the agent through `cotal ps`, then shut down
+and remove the extension.

package/dist/driver.d.ts

@@ -0,0 +1,58 @@
+export interface OrcaWorktree {
+    id: string;
+    path: string;
+    displayName?: string;
+}
+export interface OrcaTerminal {
+    handle: string;
+    ptyId?: string;
+    title?: string;
+    connected?: boolean;
+    writable?: boolean;
+}
+interface OrcaEnvelope<T> {
+    ok?: boolean;
+    result?: T;
+    error?: {
+        code?: string;
+        message?: string;
+    };
+}
+interface TerminalResult {
+    terminal?: OrcaTerminal;
+    handle?: string;
+}
+export declare class OrcaCliError extends Error {
+    readonly code: string;
+    constructor(code: string, message: string);
+}
+/** Orca terminals are a local runtime boundary. Never let ambient remote-runtime selectors
+ * redirect manager lifecycle calls to another Orca environment. */
+export declare function localCliEnv(env?: NodeJS.ProcessEnv): NodeJS.ProcessEnv;
+/** True when an Orca runtime is reachable through the public CLI. */
+export declare function available(): boolean;
+/** Resolve the Orca worktree that encloses `cwd`. Uses `current` first because it is the documented
+ *  cwd-aware selector, then falls back to exact `path:` checks up the parent chain. */
+export declare function resolveWorktree(cwd: string): OrcaWorktree;
+export declare function createTerminal(opts: {
+    worktreeId: string;
+    title: string;
+    command: string;
+}): OrcaTerminal;
+export declare function showTerminal(handle: string): OrcaEnvelope<TerminalResult>;
+/** Resolve the current handle for a terminal. Orca handles are runtime-scoped, while ptyId stays
+ * stable across handle rotation. */
+export declare function currentTerminal(terminal: Pick<OrcaTerminal, "handle" | "ptyId">): OrcaTerminal | undefined;
+export declare function terminalAlive(terminal: Pick<OrcaTerminal, "handle" | "ptyId">): boolean;
+export declare function sendTerminal(handle: string, opts?: {
+    text?: string;
+    enter?: boolean;
+    interrupt?: boolean;
+}): void;
+export declare function closeTerminal(handle: string): boolean;
+/** Close by stable identity. If the handle rotates between resolution and close, refresh by ptyId
+ * and retry once instead of treating a stale handle as a successful stop. */
+export declare function closeManagedTerminal(terminal: Pick<OrcaTerminal, "handle" | "ptyId">): void;
+export declare function terminals(): OrcaTerminal[];
+export {};
+//# sourceMappingURL=driver.d.ts.map

package/dist/driver.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"driver.d.ts","sourceRoot":"","sources":["../src/driver.ts"],"names":[],"mappings":"AAQA,MAAM,WAAW,YAAY;IAC3B,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,WAAW,YAAY;IAC3B,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB;AAED,UAAU,YAAY,CAAC,CAAC;IACtB,EAAE,CAAC,EAAE,OAAO,CAAC;IACb,MAAM,CAAC,EAAE,CAAC,CAAC;IACX,KAAK,CAAC,EAAE;QAAE,IAAI,CAAC,EAAE,MAAM,CAAC;QAAC,OAAO,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;CAC7C;AAMD,UAAU,cAAc;IACtB,QAAQ,CAAC,EAAE,YAAY,CAAC;IACxB,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAaD,qBAAa,YAAa,SAAQ,KAAK;IACzB,QAAQ,CAAC,IAAI,EAAE,MAAM;gBAAZ,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM;CAGnD;AAMD;mEACmE;AACnE,wBAAgB,WAAW,CAAC,GAAG,GAAE,MAAM,CAAC,UAAwB,GAAG,MAAM,CAAC,UAAU,CAMnF;AAuFD,qEAAqE;AACrE,wBAAgB,SAAS,IAAI,OAAO,CAYnC;AAED;uFACuF;AACvF,wBAAgB,eAAe,CAAC,GAAG,EAAE,MAAM,GAAG,YAAY,CA0BzD;AAED,wBAAgB,cAAc,CAAC,IAAI,EAAE;IAAE,UAAU,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,GAAG,YAAY,CAgBzG;AAED,wBAAgB,YAAY,CAAC,MAAM,EAAE,MAAM,GAAG,YAAY,CAAC,cAAc,CAAC,CAEzE;AAED;oCACoC;AACpC,wBAAgB,eAAe,CAAC,QAAQ,EAAE,IAAI,CAAC,YAAY,EAAE,QAAQ,GAAG,OAAO,CAAC,GAAG,YAAY,GAAG,SAAS,CAiB1G;AAED,wBAAgB,aAAa,CAAC,QAAQ,EAAE,IAAI,CAAC,YAAY,EAAE,QAAQ,GAAG,OAAO,CAAC,GAAG,OAAO,CAQvF;AAED,wBAAgB,YAAY,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,GAAE;IAAE,IAAI,CAAC,EAAE,MAAM,CAAC;IAAC,KAAK,CAAC,EAAE,OAAO,CAAC;IAAC,SAAS,CAAC,EAAE,OAAO,CAAA;CAAO,GAAG,IAAI,CAOrH;AAED,wBAAgB,aAAa,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAYrD;AAED;6EAC6E;AAC7E,wBAAgB,oBAAoB,CAAC,QAAQ,EAAE,IAAI,CAAC,YAAY,EAAE,QAAQ,GAAG,OAAO,CAAC,GAAG,IAAI,CAM3F;AAED,wBAAgB,SAAS,IAAI,YAAY,EAAE,CAE1C"}

package/dist/driver.js

@@ -0,0 +1,255 @@
+import { execFileSync } from "node:child_process";
+import { existsSync, realpathSync, statSync } from "node:fs";
+import { dirname, isAbsolute, relative, resolve } from "node:path";
+const MAX_BUFFER = 16 * 1024 * 1024;
+const PROBE_CACHE_MS = 250;
+const MAX_WORKTREE_PARENT_PROBES = 12;
+export class OrcaCliError extends Error {
+    code;
+    constructor(code, message) {
+        super(message);
+        this.code = code;
+    }
+}
+let selectedBin;
+let availableCache;
+let terminalCache;
+/** Orca terminals are a local runtime boundary. Never let ambient remote-runtime selectors
+ * redirect manager lifecycle calls to another Orca environment. */
+export function localCliEnv(env = process.env) {
+    const clean = { ...env };
+    for (const key of Object.keys(clean)) {
+        if (key.toUpperCase() === "ORCA_PAIRING_CODE" || key.toUpperCase() === "ORCA_ENVIRONMENT")
+            delete clean[key];
+    }
+    return clean;
+}
+function candidates() {
+    const explicit = process.env.COTAL_ORCA_BIN?.trim();
+    if (explicit)
+        return [explicit];
+    return process.platform === "linux" ? ["orca-ide", "orca"] : ["orca", "orca-ide"];
+}
+function errorText(err) {
+    const e = err;
+    const stderr = Buffer.isBuffer(e.stderr) ? e.stderr.toString("utf8") : e.stderr;
+    const stdout = Buffer.isBuffer(e.stdout) ? e.stdout.toString("utf8") : e.stdout;
+    return (stderr?.trim() || stdout?.trim() || e.message || String(err)).replace(/\s+/g, " ");
+}
+function execOrca(args, opts = {}) {
+    const tried = [];
+    const explicit = !!process.env.COTAL_ORCA_BIN?.trim();
+    const bins = !explicit && selectedBin ? [selectedBin] : candidates();
+    for (const bin of bins) {
+        tried.push(bin);
+        try {
+            const out = execFileSync(bin, args, {
+                cwd: opts.cwd,
+                env: localCliEnv(),
+                encoding: "utf8",
+                stdio: ["ignore", "pipe", "pipe"],
+                maxBuffer: MAX_BUFFER,
+            });
+            if (!explicit)
+                selectedBin = bin;
+            return out;
+        }
+        catch (err) {
+            const e = err;
+            if (!selectedBin && e.code === "ENOENT" && bin !== bins[bins.length - 1])
+                continue;
+            const stdout = Buffer.isBuffer(e.stdout) ? e.stdout.toString("utf8") : e.stdout;
+            // Orca reports command failures as a JSON envelope on stdout and exits nonzero.
+            // Preserve that envelope so request-level code can handle expected errors by code.
+            if (typeof stdout === "string" && stdout.trim()) {
+                try {
+                    const envelope = JSON.parse(stdout);
+                    if (envelope.ok === false) {
+                        if (!explicit)
+                            selectedBin = bin;
+                        return stdout;
+                    }
+                }
+                catch {
+                    /* fall through to the CLI diagnostic below */
+                }
+            }
+            throw new Error(`orca ${args.join(" ")} failed via ${bin} (exit ${e.status ?? "unknown"}): ${errorText(err)}`);
+        }
+    }
+    throw new Error(`orca CLI not found (tried ${tried.join(", ")}); install/register Orca CLI or set COTAL_ORCA_BIN`);
+}
+function parseEnvelope(stdout, args) {
+    try {
+        return JSON.parse(stdout);
+    }
+    catch (e) {
+        throw new Error(`orca ${args.join(" ")} returned non-JSON output: ${e.message}`);
+    }
+}
+function request(args, opts = {}) {
+    return parseEnvelope(execOrca(args, opts), args);
+}
+function requireOk(args, opts = {}) {
+    const r = request(args, opts);
+    if (r.ok === false) {
+        const code = r.error?.code ?? "unknown_error";
+        const msg = r.error?.message ?? r.error?.code ?? "unknown Orca error";
+        throw new OrcaCliError(code, `orca ${args.join(" ")} failed: ${msg}`);
+    }
+    if (r.result === undefined)
+        throw new Error(`orca ${args.join(" ")} returned no result`);
+    return r.result;
+}
+function isUnder(parent, child) {
+    const rel = relative(parent, child);
+    return rel === "" || (!!rel && !rel.startsWith("..") && !isAbsolute(rel));
+}
+function assertDir(path) {
+    if (!existsSync(path))
+        throw new Error(`orca runtime: cwd does not exist: ${path}`);
+    if (!statSync(path).isDirectory())
+        throw new Error(`orca runtime: cwd is not a directory: ${path}`);
+}
+/** True when an Orca runtime is reachable through the public CLI. */
+export function available() {
+    const cacheable = !process.env.COTAL_ORCA_BIN?.trim();
+    if (cacheable && availableCache && Date.now() - availableCache.at < PROBE_CACHE_MS)
+        return availableCache.value;
+    try {
+        const r = request(["status", "--json"]);
+        const value = r.ok === true && r.result?.runtime?.reachable === true;
+        if (cacheable)
+            availableCache = { at: Date.now(), value };
+        return value;
+    }
+    catch {
+        if (cacheable)
+            availableCache = { at: Date.now(), value: false };
+        return false;
+    }
+}
+/** Resolve the Orca worktree that encloses `cwd`. Uses `current` first because it is the documented
+ *  cwd-aware selector, then falls back to exact `path:` checks up the parent chain. */
+export function resolveWorktree(cwd) {
+    const requested = resolve(cwd);
+    assertDir(requested);
+    const abs = realpathSync(requested);
+    const current = request(["worktree", "current", "--json"], { cwd: abs });
+    if (current.ok !== false && current.result?.worktree?.id && current.result.worktree.path) {
+        const wt = current.result.worktree;
+        if (isUnder(realpathSync(wt.path), abs))
+            return wt;
+    }
+    let probes = 0;
+    for (let dir = abs; probes < MAX_WORKTREE_PARENT_PROBES; probes++) {
+        const shown = request(["worktree", "show", "--worktree", `path:${dir}`, "--json"]);
+        if (shown.ok !== false && shown.result?.worktree?.id && shown.result.worktree.path) {
+            const wt = shown.result.worktree;
+            if (isUnder(realpathSync(wt.path), abs))
+                return wt;
+        }
+        if (shown.ok === false && shown.error?.code && shown.error.code !== "selector_not_found") {
+            throw new Error(`orca worktree lookup failed for ${dir}: ${shown.error.message ?? shown.error.code}`);
+        }
+        const parent = dirname(dir);
+        if (parent === dir)
+            break;
+        dir = parent;
+    }
+    throw new Error(`orca runtime: ${abs} is not inside an Orca-managed worktree; open/register that project in Orca first`);
+}
+export function createTerminal(opts) {
+    const result = requireOk([
+        "terminal",
+        "create",
+        "--worktree",
+        `id:${opts.worktreeId}`,
+        "--title",
+        opts.title,
+        "--command",
+        opts.command,
+        "--json",
+    ]);
+    const terminal = result.terminal ?? (result.handle ? { handle: result.handle } : undefined);
+    if (!terminal?.handle)
+        throw new Error("orca terminal create returned no terminal handle");
+    terminalCache = undefined;
+    return terminal;
+}
+export function showTerminal(handle) {
+    return request(["terminal", "show", "--terminal", handle, "--json"]);
+}
+/** Resolve the current handle for a terminal. Orca handles are runtime-scoped, while ptyId stays
+ * stable across handle rotation. */
+export function currentTerminal(terminal) {
+    if (!terminalCache || Date.now() - terminalCache.at >= PROBE_CACHE_MS) {
+        const listed = requireOk(["terminal", "list", "--json"]).terminals ?? [];
+        terminalCache = { at: Date.now(), terminals: listed };
+    }
+    const listed = terminal.ptyId
+        ? terminalCache.terminals.find((candidate) => candidate.ptyId === terminal.ptyId)
+        : terminalCache.terminals.find((candidate) => candidate.handle === terminal.handle);
+    if (listed)
+        return { ...terminal, ...listed };
+    const shown = showTerminal(terminal.handle);
+    if (shown.ok === false) {
+        const code = shown.error?.code ?? "";
+        if (/not_found|stale|closed/i.test(code))
+            return undefined;
+        throw new OrcaCliError(code, `orca terminal show failed: ${shown.error?.message ?? code}`);
+    }
+    return shown.result?.terminal ?? terminal;
+}
+export function terminalAlive(terminal) {
+    try {
+        const current = currentTerminal(terminal);
+        return current ? current.connected !== false : false;
+    }
+    catch {
+        // Status drives teardown. An unreachable CLI is not positive evidence that the agent exited.
+        return true;
+    }
+}
+export function sendTerminal(handle, opts = {}) {
+    const args = ["terminal", "send", "--terminal", handle];
+    if (opts.text !== undefined)
+        args.push("--text", opts.text);
+    if (opts.enter)
+        args.push("--enter");
+    if (opts.interrupt)
+        args.push("--interrupt");
+    args.push("--json");
+    requireOk(args);
+}
+export function closeTerminal(handle) {
+    try {
+        const r = request(["terminal", "close", "--terminal", handle, "--json"]);
+        if (r.ok === false) {
+            const code = r.error?.code ?? "";
+            if (/not_found|stale|closed/i.test(code))
+                return false;
+            throw new Error(`orca terminal close failed for ${handle}: ${r.error?.message ?? code}`);
+        }
+        return true;
+    }
+    finally {
+        terminalCache = undefined;
+    }
+}
+/** Close by stable identity. If the handle rotates between resolution and close, refresh by ptyId
+ * and retry once instead of treating a stale handle as a successful stop. */
+export function closeManagedTerminal(terminal) {
+    const current = currentTerminal(terminal);
+    if (!current)
+        return;
+    if (closeTerminal(current.handle) || !current.ptyId)
+        return;
+    const rotated = currentTerminal(current);
+    if (rotated && rotated.handle !== current.handle)
+        closeTerminal(rotated.handle);
+}
+export function terminals() {
+    return requireOk(["terminal", "list", "--json"]).terminals ?? [];
+}
+//# sourceMappingURL=driver.js.map

package/dist/driver.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,6 @@
+/** @cotal-ai/orca — the Orca integration: a thin driver over the public Orca CLI plus a
+ *  self-registering `orca` Runtime provider. Importing the package registers it with the core
+ *  Registry, so the manager can spawn agents into the Orca worktree matching each launch cwd. */
+export * as orca from "./driver.js";
+export { OrcaRuntime, orcaRuntimeProvider } from "./runtime.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;iGAEiG;AACjG,OAAO,KAAK,IAAI,MAAM,aAAa,CAAC;AACpC,OAAO,EAAE,WAAW,EAAE,mBAAmB,EAAE,MAAM,cAAc,CAAC"}

package/dist/index.js

@@ -0,0 +1,6 @@
+/** @cotal-ai/orca — the Orca integration: a thin driver over the public Orca CLI plus a
+ *  self-registering `orca` Runtime provider. Importing the package registers it with the core
+ *  Registry, so the manager can spawn agents into the Orca worktree matching each launch cwd. */
+export * as orca from "./driver.js";
+export { OrcaRuntime, orcaRuntimeProvider } from "./runtime.js";
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;iGAEiG;AACjG,OAAO,KAAK,IAAI,MAAM,aAAa,CAAC;AACpC,OAAO,EAAE,WAAW,EAAE,mBAAmB,EAAE,MAAM,cAAc,CAAC"}

package/dist/runtime.d.ts

@@ -0,0 +1,17 @@
+import { type AgentHandle, type LaunchSpec, type Runtime, type RuntimeProvider } from "@cotal-ai/core";
+export interface PrivateLauncher {
+    command: string;
+    dir: string;
+    script: string;
+}
+export declare function privateLauncher(spec: LaunchSpec, cwd: string): PrivateLauncher;
+/** Spawns each managed agent into an Orca terminal in the Orca worktree enclosing the launch cwd. */
+export declare class OrcaRuntime implements Runtime {
+    #private;
+    readonly kind: "orca";
+    spawn(name: string, spec: LaunchSpec, cwd: string): AgentHandle;
+}
+/** Self-registering runtime provider — `import "@cotal-ai/orca"` makes the manager's `orca`
+ *  runtime available without the manager depending on this package. */
+export declare const orcaRuntimeProvider: RuntimeProvider;
+//# sourceMappingURL=runtime.d.ts.map

package/dist/runtime.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"runtime.d.ts","sourceRoot":"","sources":["../src/runtime.ts"],"names":[],"mappings":"AAGA,OAAO,EAIL,KAAK,WAAW,EAChB,KAAK,UAAU,EACf,KAAK,OAAO,EACZ,KAAK,eAAe,EACrB,MAAM,gBAAgB,CAAC;AAexB,MAAM,WAAW,eAAe;IAC9B,OAAO,EAAE,MAAM,CAAC;IAChB,GAAG,EAAE,MAAM,CAAC;IACZ,MAAM,EAAE,MAAM,CAAC;CAChB;AAqBD,wBAAgB,eAAe,CAAC,IAAI,EAAE,UAAU,EAAE,GAAG,EAAE,MAAM,GAAG,eAAe,CAQ9E;AAsBD,qGAAqG;AACrG,qBAAa,WAAY,YAAW,OAAO;;IACzC,QAAQ,CAAC,IAAI,EAAG,MAAM,CAAU;IAShC,KAAK,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,UAAU,EAAE,GAAG,EAAE,MAAM,GAAG,WAAW;CAoFhE;AAED;uEACuE;AACvE,eAAO,MAAM,mBAAmB,EAAE,eAKjC,CAAC"}

package/dist/runtime.js

@@ -0,0 +1,167 @@
+import { mkdtempSync, realpathSync, rmSync } from "node:fs";
+import { join } from "node:path";
+import { tmpdir } from "node:os";
+import { hardenPrivate, registry, writeSecretFile, } from "@cotal-ai/core";
+import * as orca from "./driver.js";
+const GRACE_MS = 2_000;
+const CONFIRM_INTERVAL_MS = 1_000;
+const MAX_CONFIRMS = 5;
+const MAX_WORKTREE_CACHE = 32;
+function shellQuote(s) {
+    return `'${s.replace(/'/g, "'\\''")}'`;
+}
+function launcherSource(payload) {
+    return `import { spawn } from "node:child_process";\n` +
+        `import { rmSync } from "node:fs";\n` +
+        `const launch = ${JSON.stringify(payload)};\n` +
+        `try { rmSync(new URL(".", import.meta.url), { recursive: true, force: true }); } catch {}\n` +
+        `process.chdir(launch.cwd);\n` +
+        `const child = spawn(launch.command, launch.args, { env: launch.env, stdio: "inherit", windowsHide: false });\n` +
+        `let exiting = false;\n` +
+        `const forward = (signal) => { if (!exiting && child.pid) child.kill(signal); };\n` +
+        `process.on("SIGINT", () => forward("SIGINT"));\n` +
+        `process.on("SIGTERM", () => forward("SIGTERM"));\n` +
+        `child.on("error", (err) => { console.error("[cotal-orca-launch] " + launch.command + ": " + err.message); process.exit(127); });\n` +
+        `child.on("exit", (code, signal) => { exiting = true; if (signal) process.exit(128); process.exit(code ?? 0); });\n`;
+}
+export function privateLauncher(spec, cwd) {
+    const dir = mkdtempSync(join(tmpdir(), "cotal-orca-"));
+    hardenPrivate(dir, "dir");
+    const script = join(dir, "launch.mjs");
+    writeSecretFile(script, launcherSource({ cwd, command: spec.command, args: spec.args, env: spec.env ?? {} }));
+    // Orca types --command into an interactive shell. exec makes terminal connectivity track
+    // launcher lifetime, while single-quote escaping prevents shell interpolation in temp paths.
+    return { command: `exec ${shellQuote(process.execPath)} ${shellQuote(script)}`, dir, script };
+}
+function cleanupLauncher(launcher) {
+    try {
+        rmSync(launcher.dir, { recursive: true, force: true });
+    }
+    catch {
+        /* the launcher also removes itself after loading */
+    }
+}
+function scheduleConfirm(handle) {
+    for (let i = 1; i <= MAX_CONFIRMS; i++) {
+        setTimeout(() => {
+            try {
+                orca.sendTerminal(handle(), { enter: true });
+            }
+            catch {
+                /* terminal may already be gone */
+            }
+        }, i * CONFIRM_INTERVAL_MS);
+    }
+}
+/** Spawns each managed agent into an Orca terminal in the Orca worktree enclosing the launch cwd. */
+export class OrcaRuntime {
+    kind = "orca";
+    #worktrees = new Map();
+    #cacheWorktree(cwd, worktree) {
+        this.#worktrees.delete(cwd);
+        this.#worktrees.set(cwd, worktree);
+        if (this.#worktrees.size > MAX_WORKTREE_CACHE)
+            this.#worktrees.delete(this.#worktrees.keys().next().value);
+    }
+    spawn(name, spec, cwd) {
+        if (!/^[A-Za-z0-9_.-]+$/.test(name))
+            throw new Error(`orca runtime: unsafe agent name ${JSON.stringify(name)} (allowed: letters, digits, _ . -)`);
+        if (!orca.available())
+            throw new Error("orca runtime: Orca CLI/runtime is not reachable (run `orca status --json`)");
+        const cwdKey = realpathSync(cwd);
+        let worktree = this.#worktrees.get(cwdKey);
+        const cachedWorktree = !!worktree;
+        if (!worktree) {
+            worktree = orca.resolveWorktree(cwd);
+            this.#cacheWorktree(cwdKey, worktree);
+        }
+        const title = `cotal-${name}`;
+        const launcher = privateLauncher(spec, cwd);
+        let terminal;
+        try {
+            terminal = orca.createTerminal({ worktreeId: worktree.id, title, command: launcher.command });
+        }
+        catch (err) {
+            if (cachedWorktree && err instanceof orca.OrcaCliError && /selector_not_found|worktree.*not_found/i.test(err.code)) {
+                this.#worktrees.delete(cwdKey);
+                worktree = orca.resolveWorktree(cwd);
+                this.#cacheWorktree(cwdKey, worktree);
+                try {
+                    terminal = orca.createTerminal({ worktreeId: worktree.id, title, command: launcher.command });
+                }
+                catch (retryErr) {
+                    cleanupLauncher(launcher);
+                    throw retryErr;
+                }
+            }
+            else {
+                cleanupLauncher(launcher);
+                throw err;
+            }
+        }
+        const current = () => {
+            terminal = orca.currentTerminal(terminal) ?? terminal;
+            return terminal;
+        };
+        if (spec.confirm)
+            scheduleConfirm(() => current().handle);
+        return {
+            name,
+            kind: "orca",
+            status: () => (orca.terminalAlive(terminal) ? "running" : "exited"),
+            stop: (opts) => {
+                if (opts?.graceful === false) {
+                    try {
+                        orca.closeManagedTerminal(terminal);
+                    }
+                    finally {
+                        cleanupLauncher(launcher);
+                    }
+                    return;
+                }
+                try {
+                    orca.sendTerminal(current().handle, { text: "/exit", enter: true });
+                }
+                catch {
+                    /* still ensure it closes below */
+                }
+                setTimeout(() => {
+                    try {
+                        orca.closeManagedTerminal(terminal);
+                    }
+                    catch (err) {
+                        console.error(`orca runtime: failed to close terminal for "${name}":`, err);
+                    }
+                    finally {
+                        cleanupLauncher(launcher);
+                    }
+                }, GRACE_MS);
+            },
+            interrupt: () => {
+                try {
+                    orca.sendTerminal(current().handle, { interrupt: true });
+                }
+                catch (err) {
+                    if (err instanceof orca.OrcaCliError && /not_found|stale|closed|not_writable/i.test(err.code))
+                        return;
+                    throw err;
+                }
+            },
+            attach: () => {
+                throw new Error(`orca runtime: watch this agent in Orca terminal ${current().handle}` +
+                    `${worktree.displayName ? ` (${worktree.displayName})` : ""}; ` +
+                    `run \`orca terminal switch --terminal ${terminal.handle}\` to focus it`);
+            },
+        };
+    }
+}
+/** Self-registering runtime provider — `import "@cotal-ai/orca"` makes the manager's `orca`
+ *  runtime available without the manager depending on this package. */
+export const orcaRuntimeProvider = {
+    kind: "runtime",
+    name: "orca",
+    available: () => orca.available(),
+    create: () => new OrcaRuntime(),
+};
+registry.register(orcaRuntimeProvider);
+//# sourceMappingURL=runtime.js.map

package/dist/runtime.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"runtime.js","sourceRoot":"","sources":["../src/runtime.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,YAAY,EAAE,MAAM,EAAE,MAAM,SAAS,CAAC;AAC5D,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACjC,OAAO,EAAE,MAAM,EAAE,MAAM,SAAS,CAAC;AACjC,OAAO,EACL,aAAa,EACb,QAAQ,EACR,eAAe,GAKhB,MAAM,gBAAgB,CAAC;AACxB,OAAO,KAAK,IAAI,MAAM,aAAa,CAAC;AAEpC,MAAM,QAAQ,GAAG,KAAK,CAAC;AACvB,MAAM,mBAAmB,GAAG,KAAK,CAAC;AAClC,MAAM,YAAY,GAAG,CAAC,CAAC;AACvB,MAAM,kBAAkB,GAAG,EAAE,CAAC;AAe9B,SAAS,UAAU,CAAC,CAAS;IAC3B,OAAO,IAAI,CAAC,CAAC,OAAO,CAAC,IAAI,EAAE,OAAO,CAAC,GAAG,CAAC;AACzC,CAAC;AAED,SAAS,cAAc,CAAC,OAAwB;IAC9C,OAAO,+CAA+C;QACpD,qCAAqC;QACrC,kBAAkB,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,KAAK;QAC9C,6FAA6F;QAC7F,8BAA8B;QAC9B,gHAAgH;QAChH,wBAAwB;QACxB,mFAAmF;QACnF,kDAAkD;QAClD,oDAAoD;QACpD,oIAAoI;QACpI,oHAAoH,CAAC;AACzH,CAAC;AAED,MAAM,UAAU,eAAe,CAAC,IAAgB,EAAE,GAAW;IAC3D,MAAM,GAAG,GAAG,WAAW,CAAC,IAAI,CAAC,MAAM,EAAE,EAAE,aAAa,CAAC,CAAC,CAAC;IACvD,aAAa,CAAC,GAAG,EAAE,KAAK,CAAC,CAAC;IAC1B,MAAM,MAAM,GAAG,IAAI,CAAC,GAAG,EAAE,YAAY,CAAC,CAAC;IACvC,eAAe,CAAC,MAAM,EAAE,cAAc,CAAC,EAAE,GAAG,EAAE,OAAO,EAAE,IAAI,CAAC,OAAO,EAAE,IAAI,EAAE,IAAI,CAAC,IAAI,EAAE,GAAG,EAAE,IAAI,CAAC,GAAG,IAAI,EAAE,EAAE,CAAC,CAAC,CAAC;IAC9G,yFAAyF;IACzF,6FAA6F;IAC7F,OAAO,EAAE,OAAO,EAAE,QAAQ,UAAU,CAAC,OAAO,CAAC,QAAQ,CAAC,IAAI,UAAU,CAAC,MAAM,CAAC,EAAE,EAAE,GAAG,EAAE,MAAM,EAAE,CAAC;AAChG,CAAC;AAED,SAAS,eAAe,CAAC,QAAyB;IAChD,IAAI,CAAC;QACH,MAAM,CAAC,QAAQ,CAAC,GAAG,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC;IACzD,CAAC;IAAC,MAAM,CAAC;QACP,oDAAoD;IACtD,CAAC;AACH,CAAC;AAED,SAAS,eAAe,CAAC,MAAoB;IAC3C,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,IAAI,YAAY,EAAE,CAAC,EAAE,EAAE,CAAC;QACvC,UAAU,CAAC,GAAG,EAAE;YACd,IAAI,CAAC;gBACH,IAAI,CAAC,YAAY,CAAC,MAAM,EAAE,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC;YAC/C,CAAC;YAAC,MAAM,CAAC;gBACP,kCAAkC;YACpC,CAAC;QACH,CAAC,EAAE,CAAC,GAAG,mBAAmB,CAAC,CAAC;IAC9B,CAAC;AACH,CAAC;AAED,qGAAqG;AACrG,MAAM,OAAO,WAAW;IACb,IAAI,GAAG,MAAe,CAAC;IACvB,UAAU,GAAG,IAAI,GAAG,EAA6B,CAAC;IAE3D,cAAc,CAAC,GAAW,EAAE,QAA2B;QACrD,IAAI,CAAC,UAAU,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;QAC5B,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,GAAG,EAAE,QAAQ,CAAC,CAAC;QACnC,IAAI,IAAI,CAAC,UAAU,CAAC,IAAI,GAAG,kBAAkB;YAAE,IAAI,CAAC,UAAU,CAAC,MAAM,CAAC,IAAI,CAAC,UAAU,CAAC,IAAI,EAAE,CAAC,IAAI,EAAE,CAAC,KAAM,CAAC,CAAC;IAC9G,CAAC;IAED,KAAK,CAAC,IAAY,EAAE,IAAgB,EAAE,GAAW;QAC/C,IAAI,CAAC,mBAAmB,CAAC,IAAI,CAAC,IAAI,CAAC;YACjC,MAAM,IAAI,KAAK,CAAC,mCAAmC,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,oCAAoC,CAAC,CAAC;QAC/G,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE;YAAE,MAAM,IAAI,KAAK,CAAC,4EAA4E,CAAC,CAAC;QAErH,MAAM,MAAM,GAAG,YAAY,CAAC,GAAG,CAAC,CAAC;QACjC,IAAI,QAAQ,GAAG,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;QAC3C,MAAM,cAAc,GAAG,CAAC,CAAC,QAAQ,CAAC;QAClC,IAAI,CAAC,QAAQ,EAAE,CAAC;YACd,QAAQ,GAAG,IAAI,CAAC,eAAe,CAAC,GAAG,CAAC,CAAC;YACrC,IAAI,CAAC,cAAc,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAC;QACxC,CAAC;QACD,MAAM,KAAK,GAAG,SAAS,IAAI,EAAE,CAAC;QAC9B,MAAM,QAAQ,GAAG,eAAe,CAAC,IAAI,EAAE,GAAG,CAAC,CAAC;QAC5C,IAAI,QAA2B,CAAC;QAChC,IAAI,CAAC;YACH,QAAQ,GAAG,IAAI,CAAC,cAAc,CAAC,EAAE,UAAU,EAAE,QAAQ,CAAC,EAAE,EAAE,KAAK,EAAE,OAAO,EAAE,QAAQ,CAAC,OAAO,EAAE,CAAC,CAAC;QAChG,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,IAAI,cAAc,IAAI,GAAG,YAAY,IAAI,CAAC,YAAY,IAAI,yCAAyC,CAAC,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC;gBACnH,IAAI,CAAC,UAAU,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;gBAC/B,QAAQ,GAAG,IAAI,CAAC,eAAe,CAAC,GAAG,CAAC,CAAC;gBACrC,IAAI,CAAC,cAAc,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAC;gBACtC,IAAI,CAAC;oBACH,QAAQ,GAAG,IAAI,CAAC,cAAc,CAAC,EAAE,UAAU,EAAE,QAAQ,CAAC,EAAE,EAAE,KAAK,EAAE,OAAO,EAAE,QAAQ,CAAC,OAAO,EAAE,CAAC,CAAC;gBAChG,CAAC;gBAAC,OAAO,QAAQ,EAAE,CAAC;oBAClB,eAAe,CAAC,QAAQ,CAAC,CAAC;oBAC1B,MAAM,QAAQ,CAAC;gBACjB,CAAC;YACH,CAAC;iBAAM,CAAC;gBACN,eAAe,CAAC,QAAQ,CAAC,CAAC;gBAC1B,MAAM,GAAG,CAAC;YACZ,CAAC;QACH,CAAC;QACD,MAAM,OAAO,GAAG,GAAsB,EAAE;YACtC,QAAQ,GAAG,IAAI,CAAC,eAAe,CAAC,QAAQ,CAAC,IAAI,QAAQ,CAAC;YACtD,OAAO,QAAQ,CAAC;QAClB,CAAC,CAAC;QACF,IAAI,IAAI,CAAC,OAAO;YAAE,eAAe,CAAC,GAAG,EAAE,CAAC,OAAO,EAAE,CAAC,MAAM,CAAC,CAAC;QAE1D,OAAO;YACL,IAAI;YACJ,IAAI,EAAE,MAAM;YACZ,MAAM,EAAE,GAAG,EAAE,CAAC,CAAC,IAAI,CAAC,aAAa,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,QAAQ,CAAC;YACnE,IAAI,EAAE,CAAC,IAAI,EAAE,EAAE;gBACb,IAAI,IAAI,EAAE,QAAQ,KAAK,KAAK,EAAE,CAAC;oBAC7B,IAAI,CAAC;wBACH,IAAI,CAAC,oBAAoB,CAAC,QAAQ,CAAC,CAAC;oBACtC,CAAC;4BAAS,CAAC;wBACT,eAAe,CAAC,QAAQ,CAAC,CAAC;oBAC5B,CAAC;oBACD,OAAO;gBACT,CAAC;gBACD,IAAI,CAAC;oBACH,IAAI,CAAC,YAAY,CAAC,OAAO,EAAE,CAAC,MAAM,EAAE,EAAE,IAAI,EAAE,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC;gBACtE,CAAC;gBAAC,MAAM,CAAC;oBACP,kCAAkC;gBACpC,CAAC;gBACD,UAAU,CAAC,GAAG,EAAE;oBACd,IAAI,CAAC;wBACH,IAAI,CAAC,oBAAoB,CAAC,QAAQ,CAAC,CAAC;oBACtC,CAAC;oBAAC,OAAO,GAAG,EAAE,CAAC;wBACb,OAAO,CAAC,KAAK,CAAC,+CAA+C,IAAI,IAAI,EAAE,GAAG,CAAC,CAAC;oBAC9E,CAAC;4BAAS,CAAC;wBACT,eAAe,CAAC,QAAQ,CAAC,CAAC;oBAC5B,CAAC;gBACH,CAAC,EAAE,QAAQ,CAAC,CAAC;YACf,CAAC;YACD,SAAS,EAAE,GAAG,EAAE;gBACd,IAAI,CAAC;oBACH,IAAI,CAAC,YAAY,CAAC,OAAO,EAAE,CAAC,MAAM,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;gBAC3D,CAAC;gBAAC,OAAO,GAAG,EAAE,CAAC;oBACb,IAAI,GAAG,YAAY,IAAI,CAAC,YAAY,IAAI,sCAAsC,CAAC,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC;wBAAE,OAAO;oBACtG,MAAM,GAAG,CAAC;gBACZ,CAAC;YACH,CAAC;YACD,MAAM,EAAE,GAAG,EAAE;gBACX,MAAM,IAAI,KAAK,CACb,mDAAmD,OAAO,EAAE,CAAC,MAAM,EAAE;oBACnE,GAAG,QAAQ,CAAC,WAAW,CAAC,CAAC,CAAC,KAAK,QAAQ,CAAC,WAAW,GAAG,CAAC,CAAC,CAAC,EAAE,IAAI;oBAC/D,yCAAyC,QAAQ,CAAC,MAAM,gBAAgB,CAC3E,CAAC;YACJ,CAAC;SACF,CAAC;IACJ,CAAC;CACF;AAED;uEACuE;AACvE,MAAM,CAAC,MAAM,mBAAmB,GAAoB;IAClD,IAAI,EAAE,SAAS;IACf,IAAI,EAAE,MAAM;IACZ,SAAS,EAAE,GAAG,EAAE,CAAC,IAAI,CAAC,SAAS,EAAE;IACjC,MAAM,EAAE,GAAG,EAAE,CAAC,IAAI,WAAW,EAAE;CAChC,CAAC;AAEF,QAAQ,CAAC,QAAQ,CAAC,mBAAmB,CAAC,CAAC"}

package/package.json

@@ -0,0 +1,38 @@
+{
+  "name": "@cotal-ai/orca",
+  "description": "Cotal Orca integration: an Orca Runtime provider for spawning agents into the right Orca worktree.",
+  "version": "0.11.1",
+  "license": "Apache-2.0",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/Cotal-AI/Cotal.git",
+    "directory": "extensions/orca"
+  },
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    }
+  },
+  "scripts": {
+    "typecheck": "tsc -p tsconfig.json --noEmit",
+    "build": "tsc -p tsconfig.json",
+    "prepublishOnly": "pnpm run build"
+  },
+  "peerDependencies": {
+    "@cotal-ai/core": "*"
+  },
+  "devDependencies": {
+    "@cotal-ai/core": "workspace:*",
+    "tsx": "^4.22.4"
+  },
+  "files": [
+    "dist"
+  ],
+  "publishConfig": {
+    "access": "public"
+  }
+}