@cotal-ai/connector-opencode 0.68.0 → 0.70.0

package/dist/agui-map.d.ts

@@ -20,7 +20,7 @@
  * holds no per-part state to drop: a part arrives once, complete, and is mapped in one shot. So the
  * divergence log is the source's, and there is nothing here for a revert to invalidate.
  */
-import { type AguiEvent, type RecordMapper } from "@cotal-ai/connector-core";
+import { type RecordMapper } from "@cotal-ai/connector-core";
 import type { OpenCodeRecord } from "./agui-source.js";
 export interface OpenCodeMapperOptions {
     /** The native session id. It is the `threadId` on every event and nothing else may claim it. */
@@ -34,25 +34,12 @@ export interface OpenCodeMapperOptions {
 }
 export interface OpenCodeMapper {
     map: RecordMapper<OpenCodeRecord>;
-    /**
-     * Close the open run at a boundary the record stream cannot see: `session.idle`, which §3.2 makes
-     * the flush boundary. Returns `null` when nothing is open, so calling it twice cannot manufacture
-     * a second `RUN_FINISHED` for the bracket machine to refuse.
-     */
-    closeOpenRun: (timestamp: number, stopReason?: string) => {
-        runId: string;
-        events: AguiEvent[];
-    } | null;
-    /** The run currently open, or `null`. */
-    openRun: () => string | null;
     /**
      * Forget a run the emitter closed out of band. KEYED ON THE ID: the report can arrive after this
      * mapper has already opened a newer run, and clearing unconditionally would orphan that one, whose
      * events would then emit under no run at all and halt a session that had done nothing wrong.
      */
     forgetOpenRun: (runId: string) => void;
-    /** Why this session opened no runs, or `null` once one has. A silent refusal is the defect. */
-    diagnose: () => string | null;
 }
 export declare function createOpenCodeMapper(opts: OpenCodeMapperOptions): OpenCodeMapper;
 //# sourceMappingURL=agui-map.d.ts.map

package/dist/agui-map.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"agui-map.d.ts","sourceRoot":"","sources":["../src/agui-map.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,OAAO,EACL,KAAK,SAAS,EACd,KAAK,YAAY,EAalB,MAAM,0BAA0B,CAAC;AAClC,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAEvD,MAAM,WAAW,qBAAqB;IACpC,gGAAgG;IAChG,QAAQ,EAAE,MAAM,CAAC;IACjB,oGAAoG;IACpG,SAAS,EAAE,MAAM,MAAM,CAAC;IACxB,sEAAsE;IACtE,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,kGAAkG;IAClG,GAAG,CAAC,EAAE,MAAM,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,cAAc;IAC7B,GAAG,EAAE,YAAY,CAAC,cAAc,CAAC,CAAC;IAClC;;;;OAIG;IACH,YAAY,EAAE,CAAC,SAAS,EAAE,MAAM,EAAE,UAAU,CAAC,EAAE,MAAM,KAAK;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,SAAS,EAAE,CAAA;KAAE,GAAG,IAAI,CAAC;IACxG,yCAAyC;IACzC,OAAO,EAAE,MAAM,MAAM,GAAG,IAAI,CAAC;IAC7B;;;;OAIG;IACH,aAAa,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC;IACvC,+FAA+F;IAC/F,QAAQ,EAAE,MAAM,MAAM,GAAG,IAAI,CAAC;CAC/B;AAkDD,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,qBAAqB,GAAG,cAAc,CA4HhF"}
+{"version":3,"file":"agui-map.d.ts","sourceRoot":"","sources":["../src/agui-map.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,OAAO,EAEL,KAAK,YAAY,EAalB,MAAM,0BAA0B,CAAC;AAClC,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAEvD,MAAM,WAAW,qBAAqB;IACpC,gGAAgG;IAChG,QAAQ,EAAE,MAAM,CAAC;IACjB,oGAAoG;IACpG,SAAS,EAAE,MAAM,MAAM,CAAC;IACxB,sEAAsE;IACtE,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,kGAAkG;IAClG,GAAG,CAAC,EAAE,MAAM,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,cAAc;IAC7B,GAAG,EAAE,YAAY,CAAC,cAAc,CAAC,CAAC;IAClC;;;;OAIG;IACH,aAAa,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC;CACxC;AAkDD,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,qBAAqB,GAAG,cAAc,CAuGhF"}

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

@@ -11,10 +11,13 @@ import { resolve } from "node:path";
 import { registry as registry3 } from "@cotal-ai/core";
 
 // ../connector-core/dist/config.js
-import { DEFAULT_SERVER, DEV_OWNER, LAUNCH_MATERIAL_ENV, discardLaunchMaterial, assertLifecycleToken, assertValidChannel, channelInAllow, credsClaims, eventChannel, idFromCreds, isConcreteChannel, loadAgentFile, parseJoinLink, readLaunchMaterial } 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";
@@ -178,14 +181,11 @@ function materialEnv(opts) {
 // ../connector-core/dist/agui.js
 import { AGUI_FRAME_KIND, AGUI_EVENT_TYPE, isAguiFramePart } from "@cotal-ai/core";
 import { AGUI_FRAME_KIND as AGUI_FRAME_KIND2, AGUI_EVENT_TYPE as AGUI_EVENT_TYPE2, isAguiFramePart as isAguiFramePart2 } from "@cotal-ai/core";
-import { isCasLoss, principalKey as principalKey2 } from "@cotal-ai/core";
 var TRUNCATABLE_FIELDS = [
   { type: AGUI_EVENT_TYPE2.TOOL_CALL_ARGS, field: "delta" },
   { type: AGUI_EVENT_TYPE2.TOOL_CALL_RESULT, field: "content" },
   { type: AGUI_EVENT_TYPE2.TEXT_MESSAGE_CONTENT, field: "delta" }
 ];
-var SIZING_ID = "S".repeat(64);
-var SIZING_EXPECTATION = Number.MAX_SAFE_INTEGER;
 var EGRESS_FORBIDDEN_TYPES = /* @__PURE__ */ new Set([
   AGUI_EVENT_TYPE2.TOOL_CALL_ARGS,
   AGUI_EVENT_TYPE2.TOOL_CALL_RESULT
@@ -208,6 +208,11 @@ var KNOWN_EVENT_KEYS_BY_TYPE = /* @__PURE__ */ new Map([
   [AGUI_EVENT_TYPE2.CUSTOM, /* @__PURE__ */ new Set(["type", "timestamp", "rawEvent", "name", "value", "cotal"])]
 ]);
 
+// ../connector-core/dist/agui-emitter.js
+import { isAguiFramePart as isAguiFramePart3, isCasLoss, principalKey as principalKey2 } from "@cotal-ai/core";
+var SIZING_ID = "S".repeat(64);
+var SIZING_EXPECTATION = Number.MAX_SAFE_INTEGER;
+
 // ../connector-core/dist/event-wal.js
 import { assertIdToken } from "@cotal-ai/core";
 
@@ -215,7 +220,7 @@ import { assertIdToken } from "@cotal-ai/core";
 import { ensureDirNoSymlink } from "@cotal-ai/core";
 
 // ../connector-core/dist/agui-render.js
-import { AGUI_EVENT_TYPE as AGUI_EVENT_TYPE3, AGUI_FRAME_KIND as AGUI_FRAME_KIND3, isAguiFramePart as isAguiFramePart3, registry } from "@cotal-ai/core";
+import { AGUI_EVENT_TYPE as AGUI_EVENT_TYPE3, AGUI_FRAME_KIND as AGUI_FRAME_KIND3, isAguiFramePart as isAguiFramePart4, registry } from "@cotal-ai/core";
 var str = (v) => typeof v === "string" ? v : void 0;
 var CONT = "  \xB7 ";
 var TEXT_PREFIX = "\xBB ";
@@ -322,7 +327,7 @@ var aguiFramePartRenderer = Object.freeze({
   kind: "part-renderer",
   name: AGUI_FRAME_KIND3,
   render(part) {
-    if (!isAguiFramePart3(part))
+    if (!isAguiFramePart4(part))
       return `[not an AG-UI frame]`;
     const events = part.events;
     if (!Array.isArray(events) || events.length === 0)
@@ -14853,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 } 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