@cotal-ai/herdr 0.0.0 → 0.19.0

package/dist/runtime.js

@@ -0,0 +1,230 @@
+import { mkdtempSync, rmSync, statSync } from "node:fs";
+import { join } from "node:path";
+import { tmpdir } from "node:os";
+import { hardenPrivate, registry, writeSecretFile, } from "@cotal-ai/core";
+import * as herdr from "./driver.js";
+const GRACE_MS = 2_000;
+const CONFIRM_INTERVAL_MS = 1_000;
+const MAX_CONFIRMS = 5;
+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-herdr-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`;
+}
+/** The connector-declared env (identity, creds, control token) must never appear on herdr's
+ *  command line or in the server's pane records, so it rides an owner-only (0o600) launcher
+ *  script in a private temp dir; herdr only ever sees `node <script>`. The script removes its
+ *  own directory as soon as it has loaded. */
+export function privateLauncher(spec, cwd) {
+    // Prefix is specifically `cotal-herdr-launch-`, not `cotal-herdr-`: the smoke counts launcher
+    // dirs to prove failed spawns clean up after themselves, and a shorter prefix would also match
+    // the driver's own `cotal-herdr-srv-` scratch, making that count wider than the claim it tests.
+    const dir = mkdtempSync(join(tmpdir(), "cotal-herdr-launch-"));
+    hardenPrivate(dir, "dir");
+    const script = join(dir, "launch.mjs");
+    writeSecretFile(script, launcherSource({ cwd, command: spec.command, args: spec.args, env: spec.env ?? {} }));
+    return { argv: [process.execPath, script], dir, script };
+}
+/** How spawned agents are laid out in the session: `tab` (default) gives each agent its own
+ *  name-labeled tab; `split` shares one tab, splitting it per agent.
+ *  Selected per manager process via COTAL_HERDR_LAYOUT; an unknown value fails loud. */
+function layoutFromEnv() {
+    const raw = process.env.COTAL_HERDR_LAYOUT ?? "tab";
+    if (raw === "tab" || raw === "split")
+        return raw;
+    throw new Error(`herdr runtime: unknown COTAL_HERDR_LAYOUT ${JSON.stringify(raw)} (expected "tab" or "split")`);
+}
+function isDirectory(path) {
+    try {
+        return statSync(path).isDirectory();
+    }
+    catch {
+        return false;
+    }
+}
+function cleanupLauncher(launcher) {
+    try {
+        rmSync(launcher.dir, { recursive: true, force: true });
+    }
+    catch {
+        /* the launcher also removes itself after loading */
+    }
+}
+/**
+ * Spawns each managed agent into a pane of a DEDICATED named herdr session (`cotal-<space>`,
+ * from the manager) with its own server and socket — never the operator's default session, so
+ * no Cotal operation can inspect or kill unrelated panes. Panes are owned by the herdr server,
+ * so agents survive the manager's terminal going away; watch them with
+ * `herdr session attach <session>`. Lifecycle is keyed off the globally-unique `terminal_id`;
+ * the workspace-scoped public `pane_id` is re-resolved before every pane-scoped call (a pane
+ * move changes it) and never trusted from cache.
+ */
+export class HerdrRuntime {
+    session;
+    kind = "herdr";
+    constructor(session) {
+        this.session = session;
+    }
+    spawn(name, spec, cwd) {
+        if (!/^[A-Za-z0-9_.-]+$/.test(name))
+            throw new Error(`herdr runtime: unsafe agent name ${JSON.stringify(name)} (allowed: letters, digits, _ . -)`);
+        if (!herdr.available()) {
+            const found = herdr.versionText();
+            throw new Error(`herdr runtime: no usable herdr on PATH - needs >= ${herdr.MIN_HERDR.join(".")}` +
+                (found ? ` (found "${found}")` : " (herdr not installed or not on PATH)"));
+        }
+        // herdr silently substitutes $HOME for a bad --cwd; validate here so a bad workspace
+        // fails loud at spawn instead of the agent starting somewhere else entirely (a non-directory
+        // would otherwise die later, invisibly, at the launcher's chdir).
+        if (!isDirectory(cwd))
+            throw new Error(`herdr runtime: cwd ${JSON.stringify(cwd)} is not a directory`);
+        const layout = layoutFromEnv(); // before any side effects, so a bad value spawns nothing
+        herdr.ensureServer(this.session);
+        // `split` shares a tab, so the tab set has to be sampled BEFORE this agent adds its own.
+        const tabsBefore = layout === "split" ? herdr.tabIds(this.session) : [];
+        const launcher = privateLauncher(spec, cwd);
+        let agent;
+        let startedTerminalId;
+        try {
+            // agentStart lands the agent in its own workspace + name-labeled tab, so the default
+            // layout needs no move at all.
+            agent = herdr.agentStart(this.session, name, cwd, launcher.argv);
+            startedTerminalId = agent.terminalId;
+            // `split`: fold this agent into a pre-existing tab. With none (the first agent) there is
+            // nothing to share and it stays where it is — that is the layout's meaning, not a fallback.
+            // The move changes the public pane id — keep the returned, terminal-pinned record.
+            if (layout === "split" && tabsBefore.length > 0)
+                agent = herdr.paneMoveIntoTab(this.session, agent.paneId, tabsBefore[0], startedTerminalId);
+            // Cosmetic but part of the spawn contract: fail loud, and don't leave the started pane behind.
+            herdr.reportMetadata(this.session, agent.paneId, "cotal", { cotal: this.session });
+        }
+        catch (err) {
+            if (startedTerminalId) {
+                // A move may have already changed the public pane id when the failure hit — never
+                // close whichever pane record happened to assign; re-resolve off the stable terminal.
+                try {
+                    const current = herdr.agentInfo(this.session, startedTerminalId);
+                    if (current)
+                        herdr.closePane(this.session, current.paneId);
+                }
+                catch {
+                    /* best-effort teardown of the half-spawned pane */
+                }
+            }
+            cleanupLauncher(launcher);
+            throw err;
+        }
+        const { terminalId } = agent;
+        const session = this.session;
+        /** The CURRENT pane id for this terminal — resolved fresh for every pane-scoped op, never
+         *  the (possibly stale) id from spawn time. Gone terminal → HerdrCliError(pane_not_found). */
+        const currentPane = () => {
+            const info = herdr.agentInfo(session, terminalId);
+            if (!info)
+                throw new herdr.HerdrCliError("pane_not_found", `terminal ${terminalId} is gone`);
+            return info.paneId;
+        };
+        if (spec.confirm) {
+            for (let i = 1; i <= MAX_CONFIRMS; i++) {
+                setTimeout(() => {
+                    try {
+                        herdr.sendKeys(session, currentPane(), "enter");
+                    }
+                    catch {
+                        /* pane may already be gone */
+                    }
+                }, i * CONFIRM_INTERVAL_MS);
+            }
+        }
+        return {
+            name,
+            kind: "herdr",
+            // terminalState throws on any failed inventory (fail closed); for the status probe that
+            // uncertainty must read as "running" — preserving, like tmux — never as a false exit.
+            status: () => {
+                try {
+                    return herdr.terminalState(session, terminalId);
+                }
+                catch {
+                    return "running";
+                }
+            },
+            stop: (opts) => {
+                if (opts?.graceful === false) {
+                    try {
+                        herdr.closePane(session, currentPane());
+                    }
+                    catch (err) {
+                        if (!(err instanceof herdr.HerdrCliError && err.code === "pane_not_found"))
+                            throw err;
+                    }
+                    finally {
+                        cleanupLauncher(launcher);
+                    }
+                    return;
+                }
+                // Graceful: type `/exit` so the agent session shuts down cleanly (its lifecycle hook
+                // leaves the mesh), then close the now-idle pane regardless. Both calls are pane-scoped,
+                // so resolve the pane ONCE — re-resolving between them would let the id move underneath.
+                try {
+                    const pane = currentPane();
+                    herdr.sendText(session, pane, "/exit");
+                    herdr.sendKeys(session, pane, "enter");
+                }
+                catch {
+                    /* terminal already gone — still ensure the pane closes below */
+                }
+                // Deferred: a throw here would be uncaught in a timer and crash the manager — guard it.
+                setTimeout(() => {
+                    try {
+                        herdr.closePane(session, currentPane());
+                    }
+                    catch (err) {
+                        if (err instanceof herdr.HerdrCliError && err.code === "pane_not_found")
+                            return;
+                        console.error(`herdr runtime: failed to close pane for "${name}":`, err);
+                    }
+                    finally {
+                        cleanupLauncher(launcher);
+                    }
+                }, GRACE_MS);
+            },
+            waitForExit: () => herdr.waitForTerminalExit(session, terminalId),
+            interrupt: () => {
+                try {
+                    herdr.sendKeys(session, currentPane(), "ctrl+c");
+                }
+                catch (err) {
+                    if (err instanceof herdr.HerdrCliError && err.code === "pane_not_found")
+                        return;
+                    throw err;
+                }
+            },
+            attach: () => {
+                // NOT `agent attach`: herdr reserves its agent registry for recognized kinds, and a pane
+                // started by this runtime never joins it — that command would report the agent as missing.
+                throw new Error(`herdr runtime: attach natively - \`herdr session attach ${session}\`, ` +
+                    `then select the "${name}" tab (terminal ${terminalId})`);
+            },
+        };
+    }
+}
+/** Self-registering runtime provider — `import "@cotal-ai/herdr"` makes the manager's `herdr`
+ *  runtime available without the manager depending on this package. */
+export const herdrRuntimeProvider = {
+    kind: "runtime",
+    name: "herdr",
+    available: () => herdr.available(),
+    create: (opts) => new HerdrRuntime(opts.session),
+};
+registry.register(herdrRuntimeProvider);
+//# sourceMappingURL=runtime.js.map

package/dist/runtime.js.map

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

package/package.json

@@ -1,15 +1,37 @@
 {
   "name": "@cotal-ai/herdr",
-  "version": "0.0.0",
-  "description": "Placeholder for the Cotal Herdr runtime integration. Reserves the name so GitHub Actions trusted publishing (OIDC) can be configured; the real package publishes from the Cotal repo.",
+  "description": "Cotal Herdr integration: a Herdr Runtime provider for spawning agents into panes of a dedicated Herdr session.",
+  "version": "0.19.0",
   "license": "Apache-2.0",
   "repository": {
     "type": "git",
     "url": "https://github.com/Cotal-AI/Cotal.git",
     "directory": "extensions/herdr"
   },
-  "homepage": "https://github.com/Cotal-AI/Cotal/tree/main/extensions/herdr",
-  "keywords": ["cotal", "herdr", "agents", "runtime", "placeholder"],
-  "publishConfig": { "access": "public" },
-  "files": ["README.md"]
-}
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    }
+  },
+  "peerDependencies": {
+    "@cotal-ai/core": "*"
+  },
+  "devDependencies": {
+    "tsx": "^4.22.4",
+    "@cotal-ai/core": "0.19.0"
+  },
+  "files": [
+    "dist"
+  ],
+  "publishConfig": {
+    "access": "public"
+  },
+  "scripts": {
+    "typecheck": "tsc -p tsconfig.json --noEmit",
+    "build": "tsc -p tsconfig.json"
+  }
+}