@cotal-ai/connector-opencode 0.69.0 → 0.70.0

package/dist/extension.d.ts

@@ -1,7 +1,7 @@
 import { type Connector } from "@cotal-ai/core";
 /**
  * The OpenCode connector: launches a watchable `opencode` TUI bound to the agent's session, using
- * OpenCode's client/server split (see serve.ts). The Cotal mesh bridge runs as an in-process plugin
+ * OpenCode's client/server split (see launch.ts). The Cotal mesh bridge runs as an in-process plugin
  * inside a headless `opencode serve`: it holds the {@link MeshAgent}, registers the cotal_* tools
  * natively (from the shared specs, at parity with Claude Code), reports presence off the event bus,
  * and owns ONE session it drives — injecting each incoming peer batch through the authenticated

package/dist/index.js

@@ -14,7 +14,10 @@ import { registry as registry3 } from "@cotal-ai/core";
 import { DEFAULT_SERVER, DEV_OWNER, LAUNCH_MATERIAL_ENV, discardLaunchMaterial, assertLifecycleToken, assertValidChannel, channelInAllow, credsClaims, eventChannel, idFromCreds, isConcreteChannel, loadAgentFile, parseJoinLink, readLaunchMaterial, resolveReadAcl } from "@cotal-ai/core";
 
 // ../connector-core/dist/agent.js
-import { normalizeMentions, RUN_LAUNCH_DEADLINE_MS, subjectMatches, isConcreteChannel as isConcreteChannel2, assertValidChannel as assertValidChannel2, channelInAllow as channelInAllow2, resolvePeer as resolvePeerInRoster, CotalEndpoint, BASELINE_LIFECYCLE_ENDPOINT as BASELINE_LIFECYCLE_ENDPOINT2, BIND_SPLIT_REISSUES, assertLifecycleToken as assertLifecycleToken3, EpEnvelopeError, isPublishPermissionDenied, unansweredRequest, renderLifecycleBlocked, bearerCommandFailure, partsToText, routeToken } from "@cotal-ai/core";
+import { normalizeMentions, RUN_LAUNCH_DEADLINE_MS, subjectMatches, isConcreteChannel as isConcreteChannel2, assertValidChannel as assertValidChannel2, channelInAllow as channelInAllow2, resolvePeer as resolvePeerInRoster, peerLabel as peerLabel2, CotalEndpoint, BASELINE_LIFECYCLE_ENDPOINT as BASELINE_LIFECYCLE_ENDPOINT2, BIND_SPLIT_REISSUES, assertLifecycleToken as assertLifecycleToken3, EpEnvelopeError, isPublishPermissionDenied, unansweredRequest, renderLifecycleBlocked, controlReplyFrom, bearerCommandFailure, partsToText, routeToken } from "@cotal-ai/core";
+
+// ../connector-core/dist/framing.js
+import { peerLabel } from "@cotal-ai/core";
 
 // ../connector-core/dist/manager-call.js
 import { BASELINE_LIFECYCLE_ENDPOINT, assertLifecycleToken as assertLifecycleToken2, dialerFor, invokeCommand, isPermissionDenied, issuedUserCaller, replyRefusedBeforeEffect, resolveService, standaloneConnectOpts } from "@cotal-ai/core";
@@ -14855,7 +14858,10 @@ function date4(params) {
 config(en_default());
 
 // ../connector-core/dist/tool-specs.js
-import { isConcreteChannel as isConcreteChannel3, channelInAllow as channelInAllow3, AmbiguousPeerError, assertLifecycleToken as assertLifecycleToken4, isPermissionDenied as isPermissionDenied2, renderLifecycleBlocked as renderLifecycleBlocked2, LANG_PROBLEM_DETAIL_KIND, formatAge, presenceAges } from "@cotal-ai/core";
+import { isConcreteChannel as isConcreteChannel3, channelInAllow as channelInAllow3, AmbiguousPeerError, peerLabel as peerLabel4, assertLifecycleToken as assertLifecycleToken4, isPermissionDenied as isPermissionDenied2, renderLifecycleBlocked as renderLifecycleBlocked2, LANG_PROBLEM_DETAIL_KIND, formatAge, presenceAges } from "@cotal-ai/core";
+
+// ../connector-core/dist/orientation.js
+import { peerLabel as peerLabel3 } from "@cotal-ai/core";
 
 // ../connector-core/dist/docs.js
 var STOP = new Set("a an and are as at be by do for from has how in is it of on or that the this to use using was what when where which who with you your".split(" "));

package/dist/launch.d.ts

@@ -0,0 +1,14 @@
+export declare const BIN: string;
+/** The foreground TUI's argv, built from the server it attaches to. Its env carries the server's
+ *  basic-auth credentials, so the argv never needs the secret. */
+export type TuiArgv = (server: {
+    url: string;
+    session: string;
+    line: 1 | 2;
+}) => [command: string, ...args: string[]];
+/** Extra env for the server, built from inputs the caller writes into the agent's home. It runs only
+ *  once no seat of this name is running, so a refused launch never rewrites files a running seat's
+ *  server still reads. */
+export type ServeEnv = (agentHome: string) => NodeJS.ProcessEnv;
+export declare function launch(tuiArgv: TuiArgv, serveEnv?: ServeEnv): Promise<void>;
+//# sourceMappingURL=launch.d.ts.map

package/dist/launch.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"launch.d.ts","sourceRoot":"","sources":["../src/launch.ts"],"names":[],"mappings":"AAgDA,eAAO,MAAM,GAAG,QAAuB,CAAC;AAqExC;kEACkE;AAClE,MAAM,MAAM,OAAO,GAAG,CAAC,MAAM,EAAE;IAAE,GAAG,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,CAAC,GAAG,CAAC,CAAA;CAAE,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,IAAI,EAAE,MAAM,EAAE,CAAC,CAAC;AAEtH;;0BAE0B;AAC1B,MAAM,MAAM,QAAQ,GAAG,CAAC,SAAS,EAAE,MAAM,KAAK,MAAM,CAAC,UAAU,CAAC;AAEhE,wBAAsB,MAAM,CAAC,OAAO,EAAE,OAAO,EAAE,QAAQ,CAAC,EAAE,QAAQ,GAAG,OAAO,CAAC,IAAI,CAAC,CA+IjF"}

package/dist/launch.js

@@ -0,0 +1,195 @@
+// src/launch.ts
+import { execFileSync, spawn } from "node:child_process";
+import { createServer } from "node:net";
+import { once } from "node:events";
+import { randomBytes } from "node:crypto";
+import { existsSync, mkdirSync, readFileSync, rmSync, writeFileSync } from "node:fs";
+import { delimiter, join } from "node:path";
+
+// src/opencode-line.ts
+function opencodeLine(raw, bin) {
+  const m = raw.match(/(?:^|v)(\d+)\.\d+/);
+  const major = m ? Number(m[1]) : NaN;
+  if (major === 1 || major === 2) return major;
+  throw new Error(
+    `opencode connector: unsupported OpenCode version "${raw}" from ${bin}; this connector supports the 1.x (opencode-ai) and 2.x (@opencode/cli) lines`
+  );
+}
+
+// src/launch.ts
+function resolveOpencodeBin() {
+  const override = process.env.COTAL_OPENCODE_BIN?.trim() || process.env.COTAL_OPENCODE_RESOLVED_BIN?.trim();
+  if (override) return override;
+  if (process.platform !== "win32") return "opencode";
+  for (const dir of (process.env.PATH ?? "").split(delimiter)) {
+    if (!dir) continue;
+    for (const exe of [join(dir, "opencode.exe"), join(dir, "node_modules", "opencode-ai", "bin", "opencode.exe")]) {
+      if (existsSync(exe)) return exe;
+    }
+  }
+  return "opencode";
+}
+var BIN = resolveOpencodeBin();
+var USERNAME = "opencode";
+var SECRET = process.env.OPENCODE_SERVER_PASSWORD || randomBytes(24).toString("hex");
+async function freePort() {
+  const srv = createServer();
+  srv.listen(0, "127.0.0.1");
+  await once(srv, "listening");
+  const port = srv.address().port;
+  await new Promise((r) => srv.close(() => r()));
+  return port;
+}
+async function terminate(child) {
+  if (child.exitCode !== null || child.signalCode !== null) return;
+  child.kill("SIGTERM");
+  const dead = await Promise.race([
+    once(child, "exit").then(() => true),
+    new Promise((r) => setTimeout(() => r(false), 3e3))
+  ]);
+  if (!dead) {
+    child.kill("SIGKILL");
+    await once(child, "exit");
+  }
+}
+function processCommand(pid) {
+  try {
+    if (process.platform === "win32") {
+      return execFileSync("powershell.exe", [
+        "-NoProfile",
+        "-NonInteractive",
+        "-Command",
+        `(Get-CimInstance Win32_Process -Filter 'ProcessId = ${pid}').CommandLine`
+      ], { encoding: "utf8", stdio: ["ignore", "pipe", "ignore"] }).trim();
+    }
+    return execFileSync("ps", ["-p", String(pid), "-o", "command="], {
+      encoding: "utf8",
+      stdio: ["ignore", "pipe", "ignore"]
+    }).trim();
+  } catch {
+    return void 0;
+  }
+}
+function isLiveOpencodeServe(pid) {
+  if (!Number.isInteger(pid) || pid <= 0) return false;
+  try {
+    process.kill(pid, 0);
+  } catch {
+    return false;
+  }
+  const cmd = processCommand(pid);
+  if (!cmd) return true;
+  return /\bserve\b/.test(cmd) && (/(?:^|[\\/\s])opencode(?:\.exe)?(?:\s|$)/i.test(cmd) || /--hostname\s+127\.0\.0\.1\b/.test(cmd) && /--port\s+\d+\b/.test(cmd));
+}
+async function launch(tuiArgv, serveEnv) {
+  const port = process.env.COTAL_OPENCODE_PORT?.trim() || String(await freePort());
+  const url = `http://127.0.0.1:${port}`;
+  const name = process.env.COTAL_NAME?.trim() || "agent";
+  const dataRoot = process.env.COTAL_OPENCODE_HOME?.trim();
+  if (!dataRoot) throw new Error("COTAL_OPENCODE_HOME is not set \u2014 the connector must pin the agent's data root");
+  const agentHome = join(dataRoot, ".cotal", "opencode", name);
+  const dbPath = join(agentHome, "opencode.db");
+  const pidFile = join(agentHome, "serve.pid");
+  let recorded;
+  try {
+    recorded = readFileSync(pidFile, "utf8");
+  } catch (e) {
+    if (e.code !== "ENOENT") throw e;
+  }
+  if (recorded !== void 0) {
+    const pid = Number(recorded);
+    if (isLiveOpencodeServe(pid))
+      throw new Error(`agent "${name}" is already running (opencode serve pid ${pid}) \u2014 kill it first`);
+    rmSync(pidFile, { force: true });
+  }
+  const versionRaw = execFileSync(BIN, ["--version"], { encoding: "utf8" }).trim();
+  const line = opencodeLine(versionRaw, BIN);
+  mkdirSync(agentHome, { recursive: true });
+  const serve = spawn(BIN, ["serve", "--hostname", "127.0.0.1", "--port", port], {
+    env: {
+      ...process.env,
+      ...serveEnv?.(agentHome),
+      COTAL_OPENCODE_SERVER_URL: url,
+      COTAL_OPENCODE_LINE: String(line),
+      OPENCODE_SERVER_USERNAME: USERNAME,
+      OPENCODE_SERVER_PASSWORD: SECRET,
+      OPENCODE_DB: dbPath
+    },
+    stdio: ["ignore", "pipe", "pipe"]
+  });
+  writeFileSync(pidFile, String(serve.pid));
+  serve.on("exit", () => rmSync(pidFile, { force: true }));
+  let sessionId;
+  let attached = false;
+  let onSession;
+  const scan = (d) => {
+    if (!attached) process.stderr.write(d);
+    if (!sessionId) {
+      const m = d.toString().match(/\[cotal-session\] (\S+)/);
+      if (m) {
+        sessionId = m[1];
+        onSession?.(sessionId);
+      }
+    }
+  };
+  serve.stdout?.on("data", scan);
+  serve.stderr?.on("data", scan);
+  serve.on("exit", (code, signal) => {
+    if (!attached) process.exit(code ?? (signal ? 1 : 0));
+  });
+  const auth = `Basic ${Buffer.from(`${USERNAME}:${SECRET}`).toString("base64")}`;
+  const pokePath = line === 2 ? "/api/config" : "/session";
+  void (async () => {
+    for (let i = 0; i < 300 && !sessionId; i++) {
+      try {
+        await fetch(`${url}${pokePath}`, { headers: { authorization: auth }, signal: AbortSignal.timeout(1500) });
+      } catch {
+      }
+      await new Promise((r) => setTimeout(r, 200));
+    }
+  })();
+  const id = await new Promise((resolve) => {
+    if (sessionId) return resolve(sessionId);
+    onSession = resolve;
+    setTimeout(() => resolve(sessionId), 6e4);
+  });
+  if (!id) {
+    process.stderr.write(
+      `[cotal-connector] serve: agent session never came up (~60s) \u2014 aborting. Check the boot log above for plugin/mesh errors (OPENCODE_DB=${dbPath})
+`
+    );
+    await terminate(serve);
+    process.exit(1);
+  }
+  if (process.env.COTAL_SERVE_HEADLESS?.trim() === "1") {
+    process.stdout.write(`[cotal-serve] ${JSON.stringify({ port: Number(port), session: id })}
+`);
+    for (const sig of ["SIGINT", "SIGTERM"])
+      process.on(sig, () => void terminate(serve).then(() => process.exit(0)));
+    return;
+  }
+  const tuiEnv = {
+    ...process.env,
+    OPENCODE_SERVER_USERNAME: USERNAME,
+    OPENCODE_SERVER_PASSWORD: SECRET,
+    OPENCODE_DB: dbPath
+  };
+  delete tuiEnv.OPENCODE_CONFIG_CONTENT;
+  for (const k of Object.keys(tuiEnv)) if (k.startsWith("COTAL_")) delete tuiEnv[k];
+  attached = true;
+  const [command, ...args] = tuiArgv({ url, session: id, line });
+  const tui = spawn(command, args, { env: tuiEnv, stdio: "inherit" });
+  for (const sig of ["SIGINT", "SIGTERM"])
+    process.on(sig, () => {
+      tui.kill(sig);
+      serve.kill(sig);
+    });
+  serve.on("exit", () => void terminate(tui));
+  tui.on("exit", (code, signal) => {
+    void terminate(serve).then(() => process.exit(code ?? (signal ? 1 : 0)));
+  });
+}
+export {
+  BIN,
+  launch
+};

package/dist/opencode-line.d.ts

@@ -1,5 +1,5 @@
 /** Parses `opencode --version` output into the major protocol line: 1 (opencode-ai) or 2
- *  (@opencode/cli). Pure so both serve.ts (the launcher) and extension.ts (the model catalog) can
+ *  (@opencode/cli). Pure so both launch.ts (the launcher) and extension.ts (the model catalog) can
  *  detect the line from the same rule with no fallback for anything else. */
 export declare function opencodeLine(raw: string, bin: string): 1 | 2;
 //# sourceMappingURL=opencode-line.d.ts.map