@cotal-ai/connector-opencode 0.1.1

package/dist/plugin.d.ts

@@ -0,0 +1,3 @@
+import type { Plugin } from "@opencode-ai/plugin";
+export declare const cotal: Plugin;
+//# sourceMappingURL=plugin.d.ts.map

package/dist/plugin.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"plugin.d.ts","sourceRoot":"","sources":["../src/plugin.ts"],"names":[],"mappings":"AA6BA,OAAO,KAAK,EAAE,MAAM,EAAS,MAAM,qBAAqB,CAAC;AAazD,eAAO,MAAM,KAAK,EAAE,MA+NnB,CAAC"}

package/dist/plugin.js

@@ -0,0 +1,278 @@
+/**
+ * The Cotal OpenCode plugin — loaded in-process by `opencode serve` (via the inline config the
+ * connector sets). The serve shim attaches a foreground `opencode` TUI to the session this plugin
+ * owns, so the human watches (and can type into) the exact session the agent drives. It turns the
+ * session into a first-class mesh peer, at parity with the Claude Code connector:
+ *
+ *  • 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;
+ *  • 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
+ *    attached TUI renders it live), acking ON TURN COMPLETION (so a crash/error redelivers).
+ *    Delivery is **attention-aware** (open/dnd/focus) and never interrupts a running turn — a
+ *    message that arrives mid-turn waits for the turn to end (matching Claude's no-interrupt
+ *    behavior), then drives.
+ *
+ * Identity comes from COTAL_* env (the plugin runs in the opencode process and inherits it).
+ * No identity → inert, so an operator's own `opencode` never joins as a stray peer.
+ */
+import { loadAgentFile } from "@cotal-ai/core";
+import { configFromEnv, hasIdentity, MeshAgent, formatInjection, fmtFrom, } from "@cotal-ai/connector-core";
+import { buildCotalTools } from "./tools.js";
+function log(msg) {
+    process.stderr.write(`[cotal-connector] ${msg}\n`);
+}
+/** Process-global guard: opencode loads the plugin once per app/worktree scope, so the function
+ *  can run more than once in a single process. We want exactly one mesh endpoint — so the first
+ *  call wires up the agent, and every call returns the *same* hooks (the same tools, bound to that
+ *  one agent), whichever scope opencode ends up using. */
+const guard = globalThis;
+export const cotal = async ({ client }) => {
+    // No identity → a plain `opencode`, not a launcher-spawned agent. Stay inert.
+    if (!hasIdentity()) {
+        log("no COTAL_NAME — not a managed session; staying off the mesh");
+        return {};
+    }
+    if (guard.__cotalOpencodeHooks)
+        return guard.__cotalOpencodeHooks; // one agent; reuse the hooks
+    const config = configFromEnv();
+    const agent = new MeshAgent(config);
+    agent.start(); // background connect with retry — never blocks startup
+    const def = process.env.COTAL_AGENT_FILE?.trim() ? loadAgentFile(process.env.COTAL_AGENT_FILE.trim()) : undefined;
+    const persona = def?.persona;
+    // This agent OWNS one session, created at boot. The serve shim attaches the foreground TUI to it
+    // (`opencode attach --session <id>`), so what the human watches IS the session we drive — no
+    // phantom home-screen, no stale-session guessing. Used to match our turn-end (idle) vs subagent idles.
+    let sessionID;
+    let busy = false; // a turn is running → don't prompt: opencode would COALESCE onto it (no reject)
+    let driving = false; // re-entrancy guard around an in-flight promptAsync
+    let primed = false; // persona is prepended to the first turn's text once
+    let briefed = false; // the boot channel briefing is prepended once, on the first turn
+    let surfaced = []; // ids surfaced into the current turn, acked on completion (by id, not count)
+    let awaitingTurnEnd = false; // a turn is in flight → ignore a duplicate idle that isn't its end
+    const safeStatus = async (status, activity) => {
+        try {
+            if (agent.connected)
+                await agent.setStatus(status, activity);
+        }
+        catch {
+            /* presence is best-effort — never throw into opencode */
+        }
+    };
+    /** Create the session this agent owns and announce its id to the serve shim, which attaches the
+     *  foreground TUI to it. The handshake line on stderr (`[cotal-session] <id>`) is how the shim
+     *  learns *which* session to open — by exact id, so a stale same-titled session from a prior run
+     *  can't be picked. Awaited by ensureSession before the first drive. */
+    const sessionReady = (async () => {
+        try {
+            const res = await client.session.create({ body: { title: `cotal:${config.space}:${config.name}` } });
+            sessionID = res.data?.id;
+            if (sessionID)
+                process.stderr.write(`[cotal-session] ${sessionID}\n`);
+            else
+                log("session.create returned no id");
+        }
+        catch (e) {
+            log(`session.create failed: ${e.message}`);
+        }
+        return sessionID;
+    })();
+    /** The session to drive — the one we created and the TUI is attached to. */
+    async function ensureSession() {
+        return sessionID ?? (await sessionReady);
+    }
+    /** Drive a turn carrying the current inbox batch (and the boot briefing once) into the visible
+     *  session via the prompt API — server-side, so it can't race like the TUI input box, and the TUI
+     *  renders it live (it subscribes to that session's events). Surfaces the items but does NOT ack
+     *  them — ackSurfaced runs on turn completion, so a crash/error redelivers. `override` replaces
+     *  the body (a bare nudge, e.g. a focus @mention pull) and surfaces nothing to ack. Self-guards
+     *  re-entrancy and never prompts into a running turn (opencode would COALESCE onto it). */
+    async function drive(override) {
+        if (driving || busy)
+            return;
+        driving = true;
+        try {
+            const id = await ensureSession();
+            if (!id)
+                return; // no visible session yet — retry on the next event/wake
+            const parts = [];
+            let ids = [];
+            if (override) {
+                parts.push({ type: "text", text: override });
+            }
+            else {
+                const items = agent.peekInbox();
+                if (items.length === 0)
+                    return;
+                ids = items.map((i) => i.id);
+                const inj = formatInjection(items);
+                if (inj)
+                    parts.push({ type: "text", text: inj });
+            }
+            if (!briefed) {
+                briefed = true;
+                const brief = agent.channelBriefing();
+                if (brief)
+                    parts.unshift({ type: "text", text: brief });
+            }
+            if (parts.length === 0)
+                return;
+            const body = { parts };
+            if (!primed && persona)
+                body.system = persona; // persona once, as system (no --append-system-prompt)
+            busy = true;
+            surfaced = ids;
+            // Arm BEFORE the await: a turn-end signal can land before promptAsync resolves, and
+            // completeTurn bails unless armed — arming after would drop it and wedge the agent.
+            awaitingTurnEnd = true;
+            await client.session.promptAsync({ path: { id }, body });
+            primed = true;
+        }
+        catch (e) {
+            busy = false;
+            surfaced = [];
+            awaitingTurnEnd = false;
+            log(`drive failed: ${e.message}`);
+        }
+        finally {
+            driving = false;
+        }
+    }
+    /** Ack the surfaced batch — but only the leading run STILL at the front of the inbox, matched by
+     *  id. MeshAgent evicts from the FRONT at MAX_INBOX, so a long turn on a chatty channel can shift
+     *  our surfaced prefix out; matching by id (not a raw count) means we never ack the wrong, newer
+     *  messages. Evicted items were already acked by the overflow; any surfaced survivor that no
+     *  longer leads is left unacked → redelivered (re-answered, never lost). */
+    function ackSurfaced() {
+        if (surfaced.length === 0)
+            return;
+        const front = agent.peekInbox();
+        let n = 0;
+        while (n < surfaced.length && n < front.length && front[n].id === surfaced[n])
+            n++;
+        if (n > 0)
+            agent.drainInbox(n);
+        surfaced = [];
+    }
+    /** A turn ended (the sole ack site). Ignore a stray/duplicate idle that isn't our turn's end. Ack
+     *  what the turn consumed, then drive the next batch — mode-aware, so bare ambient (dnd/focus)
+     *  doesn't self-wake a turn (it rides the next directed turn or a human turn). */
+    function completeTurn() {
+        if (!awaitingTurnEnd)
+            return;
+        awaitingTurnEnd = false;
+        busy = false;
+        ackSurfaced();
+        const pending = agent.attention === "open" ? agent.inboxCount() : agent.directedPendingCount();
+        if (pending > 0)
+            void drive();
+    }
+    // Inbound mesh → drive (never interrupt a running turn — matches Claude). A directed message
+    // (DM / anycast / @mention) drives when idle; ambient channel chatter drives only in `open` while
+    // idle (dnd/focus hold it for the next turn). In `focus`, ambient/@mentions never reach "incoming"
+    // (acked-and-dropped at ingest); a focus @mention wakes us to PULL via "mention-wake" below.
+    agent.on("incoming", (item) => {
+        if (busy)
+            return; // buffer; completeTurn drives at turn end
+        const directed = item.kind !== "channel" || item.mentionsMe;
+        if (directed || agent.attention === "open")
+            void drive();
+    });
+    agent.on("mention-wake", (item) => {
+        // Focus: the @mention body was acked-and-dropped at ingest — wake a turn to PULL it (recall).
+        if (!busy)
+            void drive(`📨 You were mentioned by ${fmtFrom(item)} on #${item.channel ?? "?"} — read it with cotal_inbox.`);
+    });
+    agent.on("wake", () => {
+        if (!busy)
+            void drive();
+    });
+    /** Match an event's session against the one we drive. Adopt the first session id we see (a fresh
+     *  spawn has exactly one — the visible session our first submit creates), then filter to it. */
+    const ours = (id) => {
+        if (!id)
+            return !sessionID; // a session-less event counts as ours only before we've adopted one
+        if (!sessionID)
+            sessionID = id;
+        return id === sessionID;
+    };
+    const hooks = {
+        tool: buildCotalTools(agent, config),
+        event: async ({ event }) => {
+            // The server emits `permission.asked` (the SDK's `permission.updated` type ships but never
+            // fires — #11616), so match the real runtime name out of band. With permission:"allow" this
+            // rarely triggers, but it keeps presence correct if the posture tightens.
+            if (event.type === "permission.asked") {
+                const p = event.properties;
+                if (!p.sessionID || ours(p.sessionID))
+                    await safeStatus("waiting", p.title);
+                return;
+            }
+            switch (event.type) {
+                case "session.created":
+                    // Adopt the visible (top-level) session as soon as it's born; ignore subagent children.
+                    if (!event.properties.info.parentID)
+                        ours(event.properties.info.id);
+                    break;
+                case "session.idle":
+                    if (!ours(event.properties.sessionID))
+                        return;
+                    await safeStatus("idle");
+                    completeTurn(); // the sole turn-end site: ack-on-surface + drive the next batch
+                    break;
+                case "session.status": {
+                    if (!ours(event.properties.sessionID))
+                        return;
+                    const s = event.properties.status;
+                    // Presence only — session.idle owns ack + drive (so a duplicate idle can't mis-ack).
+                    if (s.type === "busy") {
+                        busy = true;
+                        await safeStatus("working");
+                    }
+                    else if (s.type === "idle") {
+                        await safeStatus("idle");
+                    }
+                    else if (s.type === "retry") {
+                        await safeStatus("working", `retrying: ${s.message}`);
+                    }
+                    break;
+                }
+                case "session.error":
+                    // session.error's sessionID is OPTIONAL; skip only a DIFFERENT session's error — a
+                    // session-less one (id undefined) during our in-flight turn must still complete it, else
+                    // the surfaced batch is never acked and `busy` stays stuck.
+                    if (event.properties.sessionID && !ours(event.properties.sessionID))
+                        return;
+                    if (!awaitingTurnEnd)
+                        return; // no in-flight turn to fail
+                    awaitingTurnEnd = false;
+                    busy = false;
+                    ackSurfaced(); // turn surfaced the batch but failed — ack (don't retry-loop) and move on
+                    await safeStatus("idle");
+                    void drive();
+                    break;
+                case "session.deleted":
+                    if (!ours(event.properties.info.id))
+                        return;
+                    await safeStatus("offline");
+                    break;
+            }
+        },
+        // Surface the running tool as presence activity (parity with Claude's PreToolUse).
+        "tool.execute.before": async (input) => {
+            if (!ours(input.sessionID))
+                return;
+            await safeStatus("working", input.tool);
+        },
+        dispose: async () => {
+            await safeStatus("offline");
+            await agent.stop();
+        },
+    };
+    guard.__cotalOpencodeHooks = hooks;
+    log(`opencode plugin ready — space="${config.space}" name="${config.name}"${config.role ? ` role="${config.role}"` : ""}`);
+    return hooks;
+};
+//# sourceMappingURL=plugin.js.map

package/dist/plugin.js.map

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

package/dist/serve.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=serve.d.ts.map

package/dist/serve.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"serve.d.ts","sourceRoot":"","sources":["../src/serve.ts"],"names":[],"mappings":""}

package/dist/serve.js

@@ -0,0 +1,115 @@
+/**
+ * Launcher shim for the OpenCode connector — gives a spawned agent a *watchable* TUI bound to the
+ * exact session it drives, using OpenCode's own client/server split:
+ *
+ *   1. start `opencode serve` (headless) on a free port, with the Cotal plugin loaded inline;
+ *   2. poke it once so the lazily-loaded plugin initializes (joins the mesh, creates ONE session);
+ *   3. the plugin announces that session's id on stderr (`[cotal-session] <id>`);
+ *   4. launch a foreground `opencode attach <url> --session <id>` — the TUI opens straight onto the
+ *      agent's session, and every turn the plugin drives (via `session.promptAsync`) renders live.
+ *
+ * The attach TUI is a pure viewer (it connects to the running server); its env strips the plugin
+ * config + COTAL_* so it never loads a *second* mesh endpoint.
+ *
+ * SECURITY: `opencode serve` is UNAUTHENTICATED by default — the CVE-2026-22812 surface (any local
+ * process, or a malicious site via DNS-rebind, can drive the session: arbitrary code execution as
+ * this user + full mesh-identity takeover via the ungated cotal_* tools). So we set a random
+ * per-launch `OPENCODE_SERVER_PASSWORD` in the child env; the poke and the attach TUI present it as
+ * HTTP basic auth. Bind stays loopback; no CORS / mDNS.
+ */
+import { spawn } from "node:child_process";
+import { createServer } from "node:net";
+import { once } from "node:events";
+import { randomBytes } from "node:crypto";
+const BIN = process.env.COTAL_OPENCODE_BIN?.trim() || "opencode";
+/** Per-launch secret gating the spawned server's HTTP API (see SECURITY above). */
+const SECRET = randomBytes(24).toString("hex");
+/** Ask the OS for a free port (bind :0, read it, release) so co-located peers don't collide. */
+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 main() {
+    const port = process.env.COTAL_OPENCODE_PORT?.trim() || String(await freePort());
+    const url = `http://127.0.0.1:${port}`;
+    const serve = spawn(BIN, ["serve", "--hostname", "127.0.0.1", "--port", port], {
+        env: { ...process.env, OPENCODE_SERVER_PASSWORD: SECRET },
+        stdio: ["ignore", "pipe", "pipe"],
+    });
+    // Scan the server's output for the plugin's session handshake; forward boot logs to our stderr
+    // until the TUI takes over the terminal (after that, drop them so they can't corrupt its display).
+    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)); // died before the TUI came up
+    });
+    // Poke the server (lazy plugin load → mesh join + session create). Polling — not a one-shot keyed
+    // off a log banner — means a slow start can't leave the agent silently un-joined.
+    const auth = `Basic ${Buffer.from(`opencode:${SECRET}`).toString("base64")}`;
+    void (async () => {
+        for (let i = 0; i < 50; i++) {
+            try {
+                const res = await fetch(`${url}/session`, { headers: { authorization: auth } });
+                if (res.ok)
+                    return;
+            }
+            catch {
+                /* not up yet — retry */
+            }
+            await new Promise((r) => setTimeout(r, 200));
+        }
+        process.stderr.write("[cotal-connector] serve: no 2xx from the poke after ~10s — plugin may not have loaded\n");
+    })();
+    // Wait for the agent's session, then attach a foreground TUI to it.
+    const id = await new Promise((resolve) => {
+        if (sessionId)
+            return resolve(sessionId);
+        onSession = resolve;
+        setTimeout(() => resolve(sessionId), 20_000);
+    });
+    if (!id) {
+        process.stderr.write("[cotal-connector] serve: agent session never came up (~20s) — aborting\n");
+        serve.kill("SIGTERM");
+        process.exit(1);
+    }
+    const tuiEnv = { ...process.env, OPENCODE_SERVER_PASSWORD: SECRET };
+    delete tuiEnv.OPENCODE_CONFIG_CONTENT; // a viewer, not a peer — must NOT load the plugin again
+    for (const k of Object.keys(tuiEnv))
+        if (k.startsWith("COTAL_"))
+            delete tuiEnv[k];
+    attached = true;
+    const tui = spawn(BIN, ["attach", url, "--session", id, "--password", SECRET], {
+        env: tuiEnv,
+        stdio: "inherit",
+    });
+    for (const sig of ["SIGINT", "SIGTERM"])
+        process.on(sig, () => {
+            tui.kill(sig);
+            serve.kill(sig);
+        });
+    tui.on("exit", (code, signal) => {
+        serve.kill("SIGTERM"); // TUI closed → tear down the server
+        process.exit(code ?? (signal ? 1 : 0));
+    });
+}
+void main();
+//# sourceMappingURL=serve.js.map

package/dist/serve.js.map

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

package/dist/tools.d.ts

@@ -0,0 +1,15 @@
+/**
+ * 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
+ * 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).
+ *
+ * The one OpenCode-specific tool is `cotal_inbox`: this connector DRIVES delivery (it surfaces
+ * each batch into a turn and acks on completion), so the agent's inbox tool is READ-ONLY — it
+ * peeks (never drains), or it would race the connector's ack. It still honors focus-mode recall.
+ */
+import { type ToolDefinition } from "@opencode-ai/plugin";
+import { type MeshAgent, type AgentConfig } from "@cotal-ai/connector-core";
+/** Build the cotal_* tool map wired to one mesh agent, rendered from the shared specs. */
+export declare function buildCotalTools(agent: MeshAgent, config: AgentConfig): Record<string, ToolDefinition>;
+//# sourceMappingURL=tools.d.ts.map

package/dist/tools.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tools.d.ts","sourceRoot":"","sources":["../src/tools.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AACH,OAAO,EAAQ,KAAK,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAChE,OAAO,EAAkB,KAAK,SAAS,EAAE,KAAK,WAAW,EAAE,MAAM,0BAA0B,CAAC;AAE5F,0FAA0F;AAC1F,wBAAgB,eAAe,CAAC,KAAK,EAAE,SAAS,EAAE,MAAM,EAAE,WAAW,GAAG,MAAM,CAAC,MAAM,EAAE,cAAc,CAAC,CA4BrG"}

package/dist/tools.js

@@ -0,0 +1,42 @@
+/**
+ * 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
+ * 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).
+ *
+ * The one OpenCode-specific tool is `cotal_inbox`: this connector DRIVES delivery (it surfaces
+ * each batch into a turn and acks on completion), so the agent's inbox tool is READ-ONLY — it
+ * peeks (never drains), or it would race the connector's ack. It still honors focus-mode recall.
+ */
+import { tool } from "@opencode-ai/plugin";
+import { cotalToolSpecs } from "@cotal-ai/connector-core";
+/** Build the cotal_* tool map wired to one mesh agent, rendered from the shared specs. */
+export function buildCotalTools(agent, config) {
+    const tools = {};
+    for (const spec of cotalToolSpecs(config)) {
+        if (spec.name === "cotal_inbox") {
+            // Read-only: this connector delivers + acks each turn, so the tool must never drain. Force
+            // peek (still surfaces focus-mode recall), and reframe push-primary / pull-secondary. (norman)
+            tools.cotal_inbox = tool({
+                description: "Show the peer messages currently waiting for you (incl. focus-mode recall). You don't normally need this — the connector delivers peer messages into your turns automatically; use it to re-check what's pending mid-task. Read-only: it never consumes them.",
+                args: {},
+                async execute() {
+                    const r = await spec.run(agent, config, { peek: true });
+                    return r.isError ? `⚠ ${r.text}` : r.text;
+                },
+            });
+            continue;
+        }
+        tools[spec.name] = tool({
+            description: spec.description,
+            // The shared spec carries a Zod raw shape; OpenCode's tool() takes the same (zod via tool.schema).
+            args: (spec.schema ?? {}),
+            async execute(args) {
+                const r = await spec.run(agent, config, (args ?? {}));
+                return r.isError ? `⚠ ${r.text}` : r.text;
+            },
+        });
+    }
+    return tools;
+}
+//# sourceMappingURL=tools.js.map

package/dist/tools.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tools.js","sourceRoot":"","sources":["../src/tools.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AACH,OAAO,EAAE,IAAI,EAAuB,MAAM,qBAAqB,CAAC;AAChE,OAAO,EAAE,cAAc,EAAoC,MAAM,0BAA0B,CAAC;AAE5F,0FAA0F;AAC1F,MAAM,UAAU,eAAe,CAAC,KAAgB,EAAE,MAAmB;IACnE,MAAM,KAAK,GAAmC,EAAE,CAAC;IACjD,KAAK,MAAM,IAAI,IAAI,cAAc,CAAC,MAAM,CAAC,EAAE,CAAC;QAC1C,IAAI,IAAI,CAAC,IAAI,KAAK,aAAa,EAAE,CAAC;YAChC,2FAA2F;YAC3F,+FAA+F;YAC/F,KAAK,CAAC,WAAW,GAAG,IAAI,CAAC;gBACvB,WAAW,EACT,+PAA+P;gBACjQ,IAAI,EAAE,EAAE;gBACR,KAAK,CAAC,OAAO;oBACX,MAAM,CAAC,GAAG,MAAM,IAAI,CAAC,GAAG,CAAC,KAAK,EAAE,MAAM,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC;oBACxD,OAAO,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;gBAC5C,CAAC;aACF,CAAC,CAAC;YACH,SAAS;QACX,CAAC;QACD,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC;YACtB,WAAW,EAAE,IAAI,CAAC,WAAW;YAC7B,mGAAmG;YACnG,IAAI,EAAE,CAAC,IAAI,CAAC,MAAM,IAAI,EAAE,CAA0B;YAClD,KAAK,CAAC,OAAO,CAAC,IAAa;gBACzB,MAAM,CAAC,GAAG,MAAM,IAAI,CAAC,GAAG,CAAC,KAAK,EAAE,MAAM,EAAE,CAAC,IAAI,IAAI,EAAE,CAAQ,CAAC,CAAC;gBAC7D,OAAO,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;YAC5C,CAAC;SACF,CAAC,CAAC;IACL,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC"}

package/package.json

@@ -0,0 +1,45 @@
+{
+  "name": "@cotal-ai/connector-opencode",
+  "version": "0.1.1",
+  "license": "Apache-2.0",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/Cotal-AI/Cotal.git",
+    "directory": "extensions/connector-opencode"
+  },
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    }
+  },
+  "dependencies": {
+    "@cotal-ai/connector-core": "0.1.3"
+  },
+  "peerDependencies": {
+    "@opencode-ai/plugin": "^1.16.2",
+    "@opencode-ai/sdk": "^1.16.2",
+    "@cotal-ai/core": "0.1.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.2"
+  },
+  "files": [
+    "dist"
+  ],
+  "publishConfig": {
+    "access": "public"
+  },
+  "scripts": {
+    "typecheck": "tsc -p tsconfig.json --noEmit",
+    "build": "tsc -p tsconfig.json && pnpm run bundle",
+    "bundle": "esbuild src/plugin.ts --bundle --platform=node --format=esm --target=node20 --outfile=dist/plugin.bundle.js --external:@opencode-ai/plugin --external:@opencode-ai/sdk"
+  }
+}