@cotal-ai/connector-opencode 0.2.0 → 0.3.1

package/dist/extension.d.ts

@@ -3,13 +3,13 @@ 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
  * inside a headless `opencode serve`: it holds the {@link MeshAgent}, registers the cotal_* tools
- * natively (from the shared specs, at parity with Claude/Codex), reports presence off the event bus,
+ * 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 as a turn via the prompt API
  * (`session.promptAsync`, server-side, so it can't race the TUI input box). The shim then attaches a
  * foreground TUI to that session, so a human watching sees the agent work and can type into it.
  *
  * Config rides in `OPENCODE_CONFIG_CONTENT` (inline JSON, the highest merge layer), so the
- * operator's `~/.config/opencode` is never written — the Codex `-c` trick in JSON.
+ * operator's `~/.config/opencode` is never written.
  * `permission:"allow"` keeps a supervised agent from stalling on a tool approval the human may not
  * be at the keyboard to grant. Self-registers on import; the manager resolves it by type "opencode".
  */

package/dist/extension.js

@@ -13,13 +13,13 @@ const SERVE_SHIM = fileURLToPath(new URL("./serve.js", import.meta.url));
  * 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
  * inside a headless `opencode serve`: it holds the {@link MeshAgent}, registers the cotal_* tools
- * natively (from the shared specs, at parity with Claude/Codex), reports presence off the event bus,
+ * 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 as a turn via the prompt API
  * (`session.promptAsync`, server-side, so it can't race the TUI input box). The shim then attaches a
  * foreground TUI to that session, so a human watching sees the agent work and can type into it.
  *
  * Config rides in `OPENCODE_CONFIG_CONTENT` (inline JSON, the highest merge layer), so the
- * operator's `~/.config/opencode` is never written — the Codex `-c` trick in JSON.
+ * operator's `~/.config/opencode` is never written.
  * `permission:"allow"` keeps a supervised agent from stalling on a tool approval the human may not
  * be at the keyboard to grant. Self-registers on import; the manager resolves it by type "opencode".
  */
@@ -28,7 +28,7 @@ export const opencodeConnector = {
     name: "opencode",
     buildLaunch(opts) {
         // Identity rides the process env: the plugin runs in the opencode process and inherits it
-        // (unlike the Codex/Claude MCP servers, which get none of the parent env).
+        // (unlike the Claude Code MCP server, which gets none of the parent env).
         const env = { COTAL_SPACE: opts.space, COTAL_NAME: opts.name };
         if (opts.role)
             env.COTAL_ROLE = opts.role;

package/dist/extension.js.map

@@ -1 +1 @@
-{"version":3,"file":"extension.js","sourceRoot":"","sources":["../src/extension.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AACzC,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,EAAE,aAAa,EAAE,QAAQ,EAAoD,MAAM,gBAAgB,CAAC;AAE3G;;;oCAGoC;AACpC,MAAM,YAAY,GAAG,aAAa,CAAC,IAAI,GAAG,CAAC,oBAAoB,EAAE,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC;AAEnF;uFACuF;AACvF,MAAM,UAAU,GAAG,aAAa,CAAC,IAAI,GAAG,CAAC,YAAY,EAAE,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC;AAEzE;;;;;;;;;;;;;GAaG;AACH,MAAM,CAAC,MAAM,iBAAiB,GAAc;IAC1C,IAAI,EAAE,WAAW;IACjB,IAAI,EAAE,UAAU;IAChB,WAAW,CAAC,IAAgB;QAC1B,0FAA0F;QAC1F,2EAA2E;QAC3E,MAAM,GAAG,GAA2B,EAAE,WAAW,EAAE,IAAI,CAAC,KAAK,EAAE,UAAU,EAAE,IAAI,CAAC,IAAI,EAAE,CAAC;QACvF,IAAI,IAAI,CAAC,IAAI;YAAE,GAAG,CAAC,UAAU,GAAG,IAAI,CAAC,IAAI,CAAC;QAC1C,IAAI,IAAI,CAAC,EAAE;YAAE,GAAG,CAAC,QAAQ,GAAG,IAAI,CAAC,EAAE,CAAC;QACpC,IAAI,IAAI,CAAC,KAAK;YAAE,GAAG,CAAC,WAAW,GAAG,IAAI,CAAC,KAAK,CAAC;QAC7C,IAAI,IAAI,CAAC,OAAO;YAAE,GAAG,CAAC,aAAa,GAAG,IAAI,CAAC,OAAO,CAAC;QAEnD,MAAM,MAAM,GAA4B;YACtC,OAAO,EAAE,iCAAiC;YAC1C,UAAU,EAAE,OAAO;YACnB,MAAM,EAAE,CAAC,YAAY,CAAC;SACvB,CAAC;QAEF,8FAA8F;QAC9F,8FAA8F;QAC9F,+EAA+E;QAC/E,IAAI,IAAI,CAAC,UAAU,EAAE,CAAC;YACpB,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;YACtC,GAAG,CAAC,gBAAgB,GAAG,IAAI,CAAC,CAAC,+BAA+B;YAC5D,MAAM,GAAG,GAAG,aAAa,CAAC,IAAI,CAAC,CAAC;YAChC,IAAI,GAAG,CAAC,KAAK;gBAAE,MAAM,CAAC,KAAK,GAAG,GAAG,CAAC,KAAK,CAAC;YACxC,MAAM,IAAI,GAAG,GAAG,CAAC,IAAI,EAAE,IAAI,CAAC;YAC5B,IAAI,IAAI;gBAAE,GAAG,CAAC,kBAAkB,GAAG,IAAI,CAAC,CAAC,yCAAyC;QACpF,CAAC;QAED,GAAG,CAAC,uBAAuB,GAAG,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC;QAErD,oFAAoF;QACpF,OAAO;YACL,OAAO,EAAE,OAAO,CAAC,QAAQ;YACzB,IAAI,EAAE,CAAC,UAAU,CAAC;YAClB,GAAG;SACJ,CAAC;IACJ,CAAC;CACF,CAAC;AAEF,QAAQ,CAAC,QAAQ,CAAC,iBAAiB,CAAC,CAAC"}
+{"version":3,"file":"extension.js","sourceRoot":"","sources":["../src/extension.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AACzC,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,EAAE,aAAa,EAAE,QAAQ,EAAoD,MAAM,gBAAgB,CAAC;AAE3G;;;oCAGoC;AACpC,MAAM,YAAY,GAAG,aAAa,CAAC,IAAI,GAAG,CAAC,oBAAoB,EAAE,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC;AAEnF;uFACuF;AACvF,MAAM,UAAU,GAAG,aAAa,CAAC,IAAI,GAAG,CAAC,YAAY,EAAE,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC;AAEzE;;;;;;;;;;;;;GAaG;AACH,MAAM,CAAC,MAAM,iBAAiB,GAAc;IAC1C,IAAI,EAAE,WAAW;IACjB,IAAI,EAAE,UAAU;IAChB,WAAW,CAAC,IAAgB;QAC1B,0FAA0F;QAC1F,0EAA0E;QAC1E,MAAM,GAAG,GAA2B,EAAE,WAAW,EAAE,IAAI,CAAC,KAAK,EAAE,UAAU,EAAE,IAAI,CAAC,IAAI,EAAE,CAAC;QACvF,IAAI,IAAI,CAAC,IAAI;YAAE,GAAG,CAAC,UAAU,GAAG,IAAI,CAAC,IAAI,CAAC;QAC1C,IAAI,IAAI,CAAC,EAAE;YAAE,GAAG,CAAC,QAAQ,GAAG,IAAI,CAAC,EAAE,CAAC;QACpC,IAAI,IAAI,CAAC,KAAK;YAAE,GAAG,CAAC,WAAW,GAAG,IAAI,CAAC,KAAK,CAAC;QAC7C,IAAI,IAAI,CAAC,OAAO;YAAE,GAAG,CAAC,aAAa,GAAG,IAAI,CAAC,OAAO,CAAC;QAEnD,MAAM,MAAM,GAA4B;YACtC,OAAO,EAAE,iCAAiC;YAC1C,UAAU,EAAE,OAAO;YACnB,MAAM,EAAE,CAAC,YAAY,CAAC;SACvB,CAAC;QAEF,8FAA8F;QAC9F,8FAA8F;QAC9F,+EAA+E;QAC/E,IAAI,IAAI,CAAC,UAAU,EAAE,CAAC;YACpB,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;YACtC,GAAG,CAAC,gBAAgB,GAAG,IAAI,CAAC,CAAC,+BAA+B;YAC5D,MAAM,GAAG,GAAG,aAAa,CAAC,IAAI,CAAC,CAAC;YAChC,IAAI,GAAG,CAAC,KAAK;gBAAE,MAAM,CAAC,KAAK,GAAG,GAAG,CAAC,KAAK,CAAC;YACxC,MAAM,IAAI,GAAG,GAAG,CAAC,IAAI,EAAE,IAAI,CAAC;YAC5B,IAAI,IAAI;gBAAE,GAAG,CAAC,kBAAkB,GAAG,IAAI,CAAC,CAAC,yCAAyC;QACpF,CAAC;QAED,GAAG,CAAC,uBAAuB,GAAG,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC;QAErD,oFAAoF;QACpF,OAAO;YACL,OAAO,EAAE,OAAO,CAAC,QAAQ;YACzB,IAAI,EAAE,CAAC,UAAU,CAAC;YAClB,GAAG;SACJ,CAAC;IACJ,CAAC;CACF,CAAC;AAEF,QAAQ,CAAC,QAAQ,CAAC,iBAAiB,CAAC,CAAC"}

package/dist/plugin.bundle.js

@@ -16898,7 +16898,8 @@ var CotalEndpoint = class extends EventEmitter {
   async requestControl(service, req, timeoutMs = 5e3) {
     if (!this.nc)
       throw new Error("endpoint not started");
-    const m = await this.nc.request(controlServiceSubject(this.space, service, this.card.id), JSON.stringify({ ...req, from: req.from ?? this.ref() }), { timeout: timeoutMs });
+    const body = { ...req, from: req.from ?? this.ref() };
+    const m = await this.nc.request(controlServiceSubject(this.space, service, this.card.id), JSON.stringify(body), { timeout: timeoutMs });
     return m.json();
   }
   // ---- presence ------------------------------------------------------------
@@ -17921,6 +17922,15 @@ var MeshAgent = class extends EventEmitter2 {
       args: { name, graceful: opts?.graceful ?? true }
     });
   }
+  /** Ask the manager to purge the space's retained chat backlog (its `purge` op). Cleanup only —
+   *  it doesn't touch live agents or the anycast work queue. `includeDms` also clears DM history. */
+  async purgeHistory(opts) {
+    this.assertConnected();
+    return this.ep.requestControl("manager", {
+      op: "purge",
+      args: { includeDms: opts?.includeDms ?? false }
+    });
+  }
   /** Define a persona and persist it as config (the manager's `definePersona` op writes
    *  .cotal/agents/<name>.md). On success, announce it on the channel — the "send it out"
    *  half — so peers see the new persona; `spawn(name)` then launches an agent wearing it. */
@@ -32872,6 +32882,27 @@ ${info}${caught}`);
         }
       }
     },
+    {
+      name: "cotal_purge",
+      title: "Cotal: clear chat history",
+      description: "Ask the manager to purge this space's retained chat backlog (channel history). Set includeDms to also clear direct-message history. Cleanup only \u2014 it does not affect live agents or the anycast work queue. Irreversible.",
+      schema: {
+        includeDms: external_exports.boolean().optional().describe("Default false: channel history only. true = also purge DM history.")
+      },
+      async run(agent, _config, { includeDms }) {
+        try {
+          const reply = await agent.purgeHistory({ includeDms });
+          if (!reply.ok)
+            return err(`Couldn't purge history: ${reply.error ?? "manager refused"}`);
+          const d = reply.data;
+          const chat = d?.chat ?? 0;
+          const dm = d?.dm;
+          return ok(`Cleared ${chat} channel message${chat === 1 ? "" : "s"}${dm === void 0 ? "" : ` and ${dm} DM${dm === 1 ? "" : "s"}`} from "${_config.space}".`);
+        } catch (e) {
+          return err(`Couldn't purge history: no manager reachable (${e.message}). Is the manager running?`);
+        }
+      }
+    },
     {
       name: "cotal_persona",
       title: "Cotal: define a persona",

package/dist/plugin.js

@@ -6,7 +6,7 @@
  *
  *  • holds the {@link MeshAgent} (NATS endpoint, inbox, presence) for the server's lifetime;
  *  • registers the cotal_* tools natively, rendered from the SHARED {@link cotalToolSpecs}
- *    (`./tools.ts`) — same surface as Claude/Codex, incl. channels / join / leave / channel_info;
+ *    (`./tools.ts`) — same surface as Claude Code, incl. channels / join / leave / channel_info;
  *  • maps OpenCode bus events to presence (idle | working | waiting | offline);
  *  • owns ONE session (created at boot) and drives it: it injects each inbox batch as a turn via the
  *    prompt API (`session.promptAsync` — server-side, so it can't race the TUI input box; the

package/dist/tools.d.ts

@@ -1,6 +1,6 @@
 /**
  * The Cotal tool surface for OpenCode, rendered from the **shared** {@link cotalToolSpecs}
- * (the same source the Claude Code / Codex MCP connectors render) as OpenCode-native plugin
+ * (the same source the Claude Code MCP connector renders) as OpenCode-native plugin
  * tools (the `tool()` helper). One source of truth → the cotal_* surface can't drift across
  * adapters: an OpenCode peer gets the same tools (incl. channels / join / leave / channel_info).
  *

package/dist/tools.js

@@ -1,6 +1,6 @@
 /**
  * The Cotal tool surface for OpenCode, rendered from the **shared** {@link cotalToolSpecs}
- * (the same source the Claude Code / Codex MCP connectors render) as OpenCode-native plugin
+ * (the same source the Claude Code MCP connector renders) as OpenCode-native plugin
  * tools (the `tool()` helper). One source of truth → the cotal_* surface can't drift across
  * adapters: an OpenCode peer gets the same tools (incl. channels / join / leave / channel_info).
  *

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@cotal-ai/connector-opencode",
-  "version": "0.2.0",
+  "version": "0.3.1",
   "license": "Apache-2.0",
   "repository": {
     "type": "git",
@@ -17,19 +17,19 @@
     }
   },
   "dependencies": {
-    "@cotal-ai/connector-core": "0.2.0"
+    "@cotal-ai/connector-core": "0.3.1"
   },
   "peerDependencies": {
+    "@cotal-ai/core": ">=0.1.0",
     "@opencode-ai/plugin": "^1.16.2",
-    "@opencode-ai/sdk": "^1.16.2",
-    "@cotal-ai/core": "0.1.3"
+    "@opencode-ai/sdk": "^1.16.2"
   },
   "devDependencies": {
     "@opencode-ai/plugin": "^1.16.2",
     "@opencode-ai/sdk": "^1.16.2",
     "esbuild": "^0.28.0",
     "tsx": "^4.22.4",
-    "@cotal-ai/core": "0.1.3"
+    "@cotal-ai/core": "0.3.1"
   },
   "files": [
     "dist"