npm - @log0u7/opencode-mesh - Versions diffs - 0.5.1 → 0.7.0 - Mend

@log0u7/opencode-mesh 0.5.1 → 0.7.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (12) hide show

package/CHANGELOG.md CHANGED Viewed

@@ -5,6 +5,26 @@ All notable changes to this project are documented in this file.
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/),
 and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
+## [0.7.0] - 2026-11-06
+### Added
+- Themed mesh sidebar: bold header and muted peer lines using the active
+  theme's text colors.
+- Sidebar collapse: the `/mesh` toggle keybind persists its state in durable
+  storage, so the collapsed sidebar survives TUI restarts.
+- Event refresh: the sidebar refreshes immediately (debounced) on server
+  events, with the 15s polling as fallback.
+- `/mesh` now opens a dialog with the full snapshot instead of a toast.
+## [0.6.0] - 2026-11-06
+### Added
+- Live mesh sidebar: the TUI part polls a `mesh.snapshot` RPC (registered
+  server-side) every 15s and renders the node, one line per paired peer and
+  the active lock count. Hidden on v1 hosts and while the server is down.
 ## [0.5.1] - 2026-11-06
 ### Fixed

package/README.md CHANGED Viewed

@@ -12,6 +12,34 @@ Each node advertises itself over mDNS, pairs with explicit operator approval (pe
 `mesh_lock` is **local to your machine**: it is enforced between OpenCode sessions sharing this host's data directory (`~/.local/share/opencode-mesh/`). Locks are not part of the wire protocol, so a peer on another node does not see or respect them. Remote nodes coordinate through messages (`mesh_send`), not locks.
+## Why
+One OpenCode instance is one brain. When a task outgrows a single session, or you want to parallelise across machines, sessions need to talk to each other, claim files without stepping on each other, and workers you can spawn and reap. opencode-mesh adds that layer:
+- **Same machine:** sessions coordinate through a local registry - messages (`mesh_send` / `mesh_inbox`) and exclusive file claims (`mesh_lock`).
+- **Across the room:** nodes advertise over mDNS and pair with explicit operator approval (per-peer bearer tokens, deny by default). Tailscale IPs are picked up automatically for cross-subnet pools.
+- **Headless workers:** `mesh_spawn` starts an isolated OpenCode worktree per worker, tracks its lifecycle, captures its logs, and cleans up on dispose.
+```mermaid
+flowchart LR
+    subgraph lan["LAN or Tailscale tailnet"]
+        N1["Node A - OpenCode + mesh"]
+        N2["Node B - OpenCode + mesh"]
+        N3["Node C - OpenCode + mesh"]
+    end
+    N1 <-- "mDNS discovery (node id + fingerprint only)" --> N2
+    N1 <-- "HTTP + per-peer bearer tokens (mesh_send / mesh_inbox)" --> N2
+    N2 <-- "mDNS + HTTP" --> N3
+    N1 <-- "mDNS + HTTP" --> N3
+```
+## Highlights
+- **Spawn headless workers in one call.** `mesh_spawn(task, name)` starts an isolated OpenCode worktree per worker; `mesh_workers`, `mesh_worker_logs`, `mesh_worker_stop` and `mesh_worker_remove` track and reap them. A pool of N workers costs N worktrees, not N mesh nodes.
+- **Deny by default.** Every endpoint requires a per-peer bearer token; pairing offers expire after 5 minutes; both sides must run `mesh_pair`; every mail carries an Ed25519 proof, so a leaked offer cannot install or rotate a live credential.
+- **File claims between sessions.** `mesh_lock` gives exclusive claims on paths, enforced between sessions on the same machine, so two agents never edit the same file.
+- **Deliberately simple wire protocol.** mDNS for discovery, bearer tokens for auth, two HTTP routes (`/mail`, `/status`), plain HTTP over loopback and trusted networks.
 ## Install
 Register the plugin in `opencode.json` (project or global `~/.config/opencode/opencode.json`):
@@ -26,7 +54,7 @@ Restart OpenCode. The package is installed automatically at startup into opencod
 ```json
 {
-  "plugin": ["@log0u7/opencode-mesh@0.4.1"]
+  "plugin": ["@log0u7/opencode-mesh@0.5.1"]
 }
 ```
@@ -75,7 +103,7 @@ mesh_unlock(path="src/api.ts")
 | Tool | Args | Description |
 |---|---|---|
-| `mesh_status` | : local session registry, own address, paired peers, active locks. |
+| `mesh_status` | | Local session registry, own address, paired peers, active locks. |
 | `mesh_pair` | `node_id?`, `token?`, `address?` | No args: emit a pairing offer (5 min ttl). With args: complete the peer's offer. |
 | `mesh_send` | `peer`, `subject`, `body` | Deliver a message to a peer's mailbox. |
 | `mesh_inbox` | `ack?` | Fetch unread messages; ack marks them read. |
@@ -86,6 +114,17 @@ mesh_unlock(path="src/api.ts")
 Spawn headless workers in isolated opencode worktrees (native worktree API), track them, and clean up:
+```mermaid
+flowchart TB
+    O["Orchestrator session"]
+    subgraph workers["Headless workers, one worktree each"]
+        W1["Worker parser"]
+        W2["Worker tests"]
+    end
+    O -- "mesh_spawn(task, name)" --> workers
+    workers -- "mesh_workers / mesh_worker_logs / mesh_worker_stop / mesh_worker_remove" --> O
+```
 ```
 mesh_spawn(task="implement the parser", name="parser")     # -> worker_id, worktree, branch
 mesh_workers()                                             # lifecycle states, session ids
@@ -110,6 +149,22 @@ The plugin ships a TUI part (auto-loaded by OpenCode): a toast on load, a `/mesh
 - Tailnet addresses are surfaced by `mesh_status` when `tailscale` runs, for cross-subnet pools.
 - Messages travel over plain HTTP: there is no TLS layer. Loopback and trusted networks only.
+The pairing handshake (both sides must run `mesh_pair`; a leaked offer alone installs nothing):
+```mermaid
+sequenceDiagram
+    autonumber
+    participant A as Node A
+    participant B as Node B
+    A->>A: mesh_pair() emits an offer (5 min TTL)
+    Note over A,B: The operator relays the offer out of band (chat, not the mesh)
+    B->>A: mesh_pair(node_id, token, address, pk) completes the offer
+    B->>B: mesh_pair() emits its own offer
+    Note over A,B: Relayed out of band again
+    A->>B: mesh_pair(node_id, token, address, pk) completes it
+    Note over A,B: Pairing complete: per-peer bearer tokens on both sides
+```
 ## Development
 Requires Node >= 22.5 (`mise install`) and pnpm (corepack).

package/dist/plugin-v2.d.ts.map CHANGED Viewed

	@@ -1 +1 @@
1	- {"version":3,"file":"plugin-v2.d.ts","sourceRoot":"","sources":["../src/plugin-v2.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,kBAAkB,CAAC;~~AA2B1C~~,eAAO,MAAM,MAAM,~~eA6EjB~~,CAAC"}
1	+ {"version":3,"file":"plugin-v2.d.ts","sourceRoot":"","sources":["../src/plugin-v2.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,kBAAkB,CAAC;AA6B1C,eAAO,MAAM,MAAM,eAyFjB,CAAC"}

package/dist/plugin-v2.js CHANGED Viewed

@@ -2,12 +2,14 @@ import { Plugin } from "@opencode/plugin";
 import { Bonjour } from "bonjour-service";
 import { openMeshDb } from "./lib/db.js";
 import { advertiseMesh, browseMesh } from "./lib/discovery.js";
-import { upsertDiscoveredPeer } from "./lib/peers.js";
+import { listLocks } from "./lib/locks.js";
+import { listPeers, upsertDiscoveredPeer } from "./lib/peers.js";
 import { loadOrCreateIdentity } from "./lib/identity.js";
 import { nodeSpawn, stopAllWorkers } from "./lib/spawn.js";
 import { v2WorktreeDomainClient } from "./lib/worktree.js";
 import { reconcileWorkers } from "./lib/workers.js";
 import { startMeshServer } from "./lib/serve.js";
+import { MeshRpc, snapshotFromMesh } from "./rpc.js";
 import { buildToolSpecs } from "./tools.js";
 import { defaultDataDir, parseOptions } from "./options.js";
 const DEFAULT_PORT = 4399;
@@ -83,10 +85,20 @@ export const MeshV2 = Plugin.define({
                 });
             }
         });
+        // Live snapshot for the TUI sidebar: one compact read over the mesh state.
+        const rpc = await ctx.rpc.register(MeshRpc, {
+            snapshot: async () => snapshotFromMesh({
+                identity,
+                peers: listPeers(db),
+                locks: listLocks(db, { now: Date.now() }),
+                server: `${address}:${port}`,
+            }),
+        });
         const cleanup = async () => {
             stopAllWorkers(db);
             advertiseHandle?.close();
             browseHandle?.close();
+            rpc.dispose();
             await new Promise((resolve) => server.close(() => resolve()));
             db.close();
         };

package/dist/plugin-v2.js.map CHANGED Viewed

	@@ -1 +1 @@
1	- {"version":3,"file":"plugin-v2.js","sourceRoot":"","sources":["../src/plugin-v2.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,kBAAkB,CAAC;AAC1C,OAAO,EAAE,OAAO,EAAE,MAAM,iBAAiB,CAAC;AAE1C,OAAO,EAAE,UAAU,EAAe,MAAM,aAAa,CAAC;AACtD,OAAO,EAAE,aAAa,EAAE,UAAU,EAAwB,MAAM,oBAAoB,CAAC;AACrF,OAAO,EAAE,oBAAoB,EAAE,MAAM,gBAAgB,CAAC;~~AACtD~~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"}
1	+ {"version":3,"file":"plugin-v2.js","sourceRoot":"","sources":["../src/plugin-v2.ts"],"names":[],"mappings":"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"}

package/dist/rpc.d.ts ADDED Viewed

@@ -0,0 +1,79 @@
+export type MeshSnapshot = {
+    node_id: string;
+    hostname: string;
+    /** Paired peers only: discovery alone never makes a peer sendable. */
+    peers: Array<{
+        node_id: string;
+        hostname: string;
+    }>;
+    active_locks: number;
+};
+/** Structural input: the mesh context (identity, listPeers, listLocks) satisfies this. */
+export type SnapshotInput = {
+    identity: {
+        node_id: string;
+        hostname: string;
+    };
+    peers: ReadonlyArray<{
+        node_id: string;
+        hostname: string;
+        paired: boolean;
+    }>;
+    locks: ReadonlyArray<unknown>;
+    server: string;
+};
+export declare function snapshotFromMesh(data: SnapshotInput): MeshSnapshot;
+/** Sidebar lines: the node, one line per paired peer, the active lock count. */
+export declare function formatMeshLines(s: MeshSnapshot): string[];
+/** Collapsible sidebar: when collapsed, one header line with the peer count (plus locks). */
+export declare function formatMeshSidebar(s: MeshSnapshot, collapsed: boolean): string[];
+export declare const MeshRpc: {
+    readonly id: "mesh";
+    readonly methods: {
+        readonly snapshot: {
+            readonly input: {
+                readonly type: "object";
+                readonly properties: {};
+                readonly additionalProperties: false;
+            };
+            readonly output: {
+                readonly type: "object";
+                readonly properties: {
+                    readonly node_id: {
+                        readonly type: "string";
+                        readonly description: "This node's id";
+                    };
+                    readonly hostname: {
+                        readonly type: "string";
+                        readonly description: "This node's hostname";
+                    };
+                    readonly peers: {
+                        readonly type: "array";
+                        readonly items: {
+                            readonly type: "object";
+                            readonly properties: {
+                                readonly node_id: {
+                                    readonly type: "string";
+                                };
+                                readonly hostname: {
+                                    readonly type: "string";
+                                };
+                            };
+                            readonly required: readonly ["node_id", "hostname"];
+                            readonly additionalProperties: false;
+                        };
+                        readonly description: "Paired peers";
+                    };
+                    readonly active_locks: {
+                        readonly type: "number";
+                        readonly description: "Active local file locks";
+                    };
+                };
+                readonly required: readonly ["node_id", "hostname", "peers", "active_locks"];
+                readonly additionalProperties: false;
+            };
+        };
+    };
+    readonly events: {};
+};
+//# sourceMappingURL=rpc.d.ts.map

package/dist/rpc.d.ts.map ADDED Viewed

@@ -0,0 +1 @@

+ {"version":3,"file":"rpc.d.ts","sourceRoot":"","sources":["../src/rpc.ts"],"names":[],"mappings":"AAMA,MAAM,MAAM,YAAY,GAAG;IACzB,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,MAAM,CAAC;IACjB,sEAAsE;IACtE,KAAK,EAAE,KAAK,CAAC;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IACpD,YAAY,EAAE,MAAM,CAAC;CACtB,CAAC;AAEF,0FAA0F;AAC1F,MAAM,MAAM,aAAa,GAAG;IAC1B,QAAQ,EAAE;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAA;KAAE,CAAC;IAChD,KAAK,EAAE,aAAa,CAAC;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,OAAO,CAAA;KAAE,CAAC,CAAC;IAC7E,KAAK,EAAE,aAAa,CAAC,OAAO,CAAC,CAAC;IAC9B,MAAM,EAAE,MAAM,CAAC;CAChB,CAAC;AAEF,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,aAAa,GAAG,YAAY,CASlE;AAED,gFAAgF;AAChF,wBAAgB,eAAe,CAAC,CAAC,EAAE,YAAY,GAAG,MAAM,EAAE,CAczD;AAED,6FAA6F;AAC7F,wBAAgB,iBAAiB,CAAC,CAAC,EAAE,YAAY,EAAE,SAAS,EAAE,OAAO,GAAG,MAAM,EAAE,CAU/E;AAED,eAAO,MAAM,OAAO;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA+BlB,CAAC"}

package/dist/rpc.js ADDED Viewed

@@ -0,0 +1,73 @@
+import { Rpc } from "@opencode/plugin/rpc";
+export function snapshotFromMesh(data) {
+    return {
+        node_id: data.identity.node_id,
+        hostname: data.identity.hostname,
+        peers: data.peers
+            .filter((p) => p.paired)
+            .map((p) => ({ node_id: p.node_id, hostname: p.hostname })),
+        active_locks: data.locks.length,
+    };
+}
+/** Sidebar lines: the node, one line per paired peer, the active lock count. */
+export function formatMeshLines(s) {
+    const self = s.hostname.length > 0 ? s.hostname : s.node_id;
+    const lines = [`mesh: ${self}`];
+    if (s.peers.length === 0) {
+        lines.push("no paired peers");
+    }
+    else {
+        for (const peer of s.peers) {
+            lines.push(`↔ ${peer.hostname.length > 0 ? peer.hostname : peer.node_id}`);
+        }
+    }
+    if (s.active_locks > 0) {
+        lines.push(`${s.active_locks} active lock(s)`);
+    }
+    return lines;
+}
+/** Collapsible sidebar: when collapsed, one header line with the peer count (plus locks). */
+export function formatMeshSidebar(s, collapsed) {
+    if (!collapsed) {
+        return formatMeshLines(s);
+    }
+    const self = s.hostname.length > 0 ? s.hostname : s.node_id;
+    const lines = [`mesh: ${self} (${s.peers.length} peers)`];
+    if (s.active_locks > 0) {
+        lines.push(`${s.active_locks} active lock(s)`);
+    }
+    return lines;
+}
+export const MeshRpc = Rpc.define({
+    id: "mesh",
+    methods: {
+        snapshot: {
+            input: { type: "object", properties: {}, additionalProperties: false },
+            output: {
+                type: "object",
+                properties: {
+                    node_id: { type: "string", description: "This node's id" },
+                    hostname: { type: "string", description: "This node's hostname" },
+                    peers: {
+                        type: "array",
+                        items: {
+                            type: "object",
+                            properties: {
+                                node_id: { type: "string" },
+                                hostname: { type: "string" },
+                            },
+                            required: ["node_id", "hostname"],
+                            additionalProperties: false,
+                        },
+                        description: "Paired peers",
+                    },
+                    active_locks: { type: "number", description: "Active local file locks" },
+                },
+                required: ["node_id", "hostname", "peers", "active_locks"],
+                additionalProperties: false,
+            },
+        },
+    },
+    events: {},
+});
+//# sourceMappingURL=rpc.js.map

package/dist/rpc.js.map ADDED Viewed

@@ -0,0 +1 @@

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

package/dist/tui.js CHANGED Viewed

@@ -1,14 +1,149 @@
+import { memo as _$memo } from "@opentui/solid";
+import { createTextNode as _$createTextNode } from "@opentui/solid";
+import { insertNode as _$insertNode } from "@opentui/solid";
+import { effect as _$effect } from "@opentui/solid";
+import { setProp as _$setProp } from "@opentui/solid";
+import { insert as _$insert } from "@opentui/solid";
+import { createElement as _$createElement } from "@opentui/solid";
+import { createComponent as _$createComponent } from "@opentui/solid";
 /** @jsxImportSource @opentui/solid */
 import { Plugin } from "@opencode/plugin/tui";
+import { For, Show, createSignal } from "solid-js";
+import { MeshRpc, formatMeshSidebar } from "./rpc.js";
+const REFRESH_MS = 15_000;
+/** quota-style event refresh: debounced immediate refresh after activity. */
+const EVENT_DEBOUNCE_MS = 150;
+function themedSidebar(theme, lines) {
+  return _$createComponent(Show, {
+    get when() {
+      return lines();
+    },
+    keyed: true,
+    children: current => (() => {
+      var _el$ = _$createElement("box");
+      _$insert(_el$, _$createComponent(For, {
+        each: current,
+        children: (line, index) => (() => {
+          var _el$2 = _$createElement("text");
+          _$setProp(_el$2, "wrapMode", "none");
+          _$insert(_el$2, line);
+          _$effect(_$p => _$setProp(_el$2, "fg", index() === 0 ? theme.text.base : theme.text.muted, _$p));
+          return _el$2;
+        })()
+      }));
+      return _el$;
+    })()
+  });
+}
+function dialogBody(theme, snapshot) {
+  const self = snapshot.hostname.length > 0 ? snapshot.hostname : snapshot.node_id;
+  const peers = snapshot.peers.map(p => p.hostname.length > 0 ? p.hostname : p.node_id);
+  return (() => {
+    var _el$3 = _$createElement("box"),
+      _el$4 = _$createElement("text"),
+      _el$5 = _$createElement("b"),
+      _el$7 = _$createElement("text"),
+      _el$8 = _$createTextNode(`Node: `),
+      _el$9 = _$createElement("text"),
+      _el$0 = _$createTextNode(`Paired peers: `),
+      _el$1 = _$createElement("text"),
+      _el$10 = _$createTextNode(`Active locks: `);
+    _$insertNode(_el$3, _el$4);
+    _$insertNode(_el$3, _el$7);
+    _$insertNode(_el$3, _el$9);
+    _$insertNode(_el$3, _el$1);
+    _$setProp(_el$3, "gap", 1);
+    _$setProp(_el$3, "paddingLeft", 2);
+    _$setProp(_el$3, "paddingRight", 2);
+    _$setProp(_el$3, "paddingBottom", 1);
+    _$insertNode(_el$4, _el$5);
+    _$insertNode(_el$5, _$createTextNode(`Mesh — coordination`));
+    _$insertNode(_el$7, _el$8);
+    _$insert(_el$7, self, null);
+    _$insertNode(_el$9, _el$0);
+    _$insert(_el$9, (() => {
+      var _c$ = _$memo(() => peers.length === 0);
+      return () => _c$() ? "none" : peers.join(", ");
+    })(), null);
+    _$insertNode(_el$1, _el$10);
+    _$insert(_el$1, () => snapshot.active_locks, null);
+    _$effect(_p$ => {
+      var _v$ = theme.text.base,
+        _v$2 = theme.text.muted,
+        _v$3 = theme.text.muted,
+        _v$4 = theme.text.muted;
+      _v$ !== _p$.e && (_p$.e = _$setProp(_el$4, "fg", _v$, _p$.e));
+      _v$2 !== _p$.t && (_p$.t = _$setProp(_el$7, "fg", _v$2, _p$.t));
+      _v$3 !== _p$.a && (_p$.a = _$setProp(_el$9, "fg", _v$3, _p$.a));
+      _v$4 !== _p$.o && (_p$.o = _$setProp(_el$1, "fg", _v$4, _p$.o));
+      return _p$;
+    }, {
+      e: undefined,
+      t: undefined,
+      a: undefined,
+      o: undefined
+    });
+    return _el$3;
+  })();
+}
 export default Plugin.define({
   id: "@log0u7/opencode-mesh.tui",
   setup(context) {
+    const theme = context.theme;
     context.ui.toast.show({
       message: "opencode-mesh loaded",
       variant: "info",
       duration: 2000
     });
+    // Durable collapse state: persisted to disk, survives restarts and hot reloads.
+    const [store, mutate] = context.storage.store("mesh-sidebar", {
+      initial: {
+        collapsed: false
+      }
+    });
+    const [snapshot, setSnapshot] = createSignal(null);
+    const [lines, setLines] = createSignal(null);
+    // Live sidebar: poll the server-side snapshot over RPC. On a v1 host (no
+    // RPC) or while the server is unreachable, the slot stays hidden.
+    const mesh = context.client.rpc(MeshRpc);
+    const refresh = async () => {
+      try {
+        const snap = await mesh.snapshot({});
+        setSnapshot(snap);
+        setLines(formatMeshSidebar(snap, store.collapsed));
+      } catch {
+        setLines(null);
+      }
+    };
+    void refresh();
+    const timer = setInterval(() => void refresh(), REFRESH_MS);
+    // quota-style event refresh: debounced immediate refresh after activity.
+    let debounce;
+    const schedule = () => {
+      if (debounce) clearTimeout(debounce);
+      debounce = setTimeout(() => void refresh(), EVENT_DEBOUNCE_MS);
+    };
+    // context.client.event is an AsyncIterable of V2Event, not an EventEmitter.
+    const events = context.client.event.subscribe();
+    void (async () => {
+      try {
+        for await (const _event of events) {
+          schedule();
+        }
+      } catch {
+        // stream ended or errored: polling fallback stays active.
+      }
+    })();
+    const unregister = context.ui.slot({
+      append: "sidebar.content",
+      render: () => themedSidebar(theme, lines)
+    });
+    // Keymap layers are disposed with the plugin; no manual disposer here.
     context.keymap.layer(() => ({
       mode: "global",
       commands: [{
@@ -20,17 +155,37 @@ export default Plugin.define({
         },
         palette: true,
         run: async () => {
-          context.ui.toast.show({
-            title: "Mesh",
-            message: "Multi-session coordination available",
-            variant: "info"
+          await refresh();
+          const current = snapshot();
+          if (!current) {
+            context.ui.toast.show({
+              title: "Mesh",
+              message: "Server unreachable",
+              variant: "info"
+            });
+            return;
+          }
+          context.ui.dialog.show(() => dialogBody(theme, current));
+          context.ui.dialog.set({
+            size: "medium"
           });
         }
+      }, {
+        id: "mesh.toggleSidebar",
+        title: "Toggle mesh sidebar",
+        group: "Mesh",
+        run: async () => {
+          await mutate(draft => {
+            draft.collapsed = !draft.collapsed;
+          });
+          void refresh();
+        }
       }]
     }));
-    return context.ui.slot({
-      append: "sidebar.content",
-      render: () => null
-    });
+    return () => {
+      clearTimeout(debounce);
+      clearInterval(timer);
+      unregister();
+    };
   }
 });

package/dist/tui.tsx CHANGED Viewed

@@ -1,12 +1,105 @@
 /** @jsxImportSource @opentui/solid */
 import { Plugin } from "@opencode/plugin/tui";
+import type { JSX } from "@opentui/solid";
+import { For, Show, createSignal } from "solid-js";
+type Context = Plugin.Context;
+type Theme = Context["theme"];
+import { MeshRpc, formatMeshSidebar, type MeshSnapshot } from "./rpc.js";
+const REFRESH_MS = 15_000;
+/** quota-style event refresh: debounced immediate refresh after activity. */
+const EVENT_DEBOUNCE_MS = 150;
+function themedSidebar(theme: Theme, lines: () => string[] | null): JSX.Element {
+  return (
+    <Show when={lines()} keyed>
+      {(current) => (
+        <box>
+          <For each={current}>
+            {(line, index) => (
+              <text fg={index() === 0 ? theme.text.base : theme.text.muted} wrapMode="none">
+                {line}
+              </text>
+            )}
+          </For>
+        </box>
+      )}
+    </Show>
+  );
+}
+function dialogBody(theme: Theme, snapshot: MeshSnapshot): JSX.Element {
+  const self = snapshot.hostname.length > 0 ? snapshot.hostname : snapshot.node_id;
+  const peers = snapshot.peers.map((p) => (p.hostname.length > 0 ? p.hostname : p.node_id));
+  return (
+    <box gap={1} paddingLeft={2} paddingRight={2} paddingBottom={1}>
+      <text fg={theme.text.base}>
+        <b>Mesh — coordination</b>
+      </text>
+      <text fg={theme.text.muted}>Node: {self}</text>
+      <text fg={theme.text.muted}>
+        Paired peers: {peers.length === 0 ? "none" : peers.join(", ")}
+      </text>
+      <text fg={theme.text.muted}>Active locks: {snapshot.active_locks}</text>
+    </box>
+  );
+}
 export default Plugin.define({
   id: "@log0u7/opencode-mesh.tui",
-  setup(context) {
+  setup(context: Context) {
+    const theme = context.theme;
     context.ui.toast.show({ message: "opencode-mesh loaded", variant: "info", duration: 2000 });
+    // Durable collapse state: persisted to disk, survives restarts and hot reloads.
+    const [store, mutate] = context.storage.store("mesh-sidebar", {
+      initial: { collapsed: false },
+    });
+    const [snapshot, setSnapshot] = createSignal<MeshSnapshot | null>(null);
+    const [lines, setLines] = createSignal<string[] | null>(null);
+    // Live sidebar: poll the server-side snapshot over RPC. On a v1 host (no
+    // RPC) or while the server is unreachable, the slot stays hidden.
+    const mesh = context.client.rpc(MeshRpc);
+    const refresh = async () => {
+      try {
+        const snap = (await mesh.snapshot({})) as MeshSnapshot;
+        setSnapshot(snap);
+        setLines(formatMeshSidebar(snap, store.collapsed));
+      } catch {
+        setLines(null);
+      }
+    };
+    void refresh();
+    const timer = setInterval(() => void refresh(), REFRESH_MS);
+    // quota-style event refresh: debounced immediate refresh after activity.
+    let debounce: ReturnType<typeof setTimeout> | undefined;
+    const schedule = () => {
+      if (debounce) clearTimeout(debounce);
+      debounce = setTimeout(() => void refresh(), EVENT_DEBOUNCE_MS);
+    };
+    // context.client.event is an AsyncIterable of V2Event, not an EventEmitter.
+    const events = context.client.event.subscribe();
+    void (async () => {
+      try {
+        for await (const _event of events) {
+          schedule();
+        }
+      } catch {
+        // stream ended or errored: polling fallback stays active.
+      }
+    })();
+    const unregister = context.ui.slot({
+      append: "sidebar.content",
+      render: () => themedSidebar(theme, lines),
+    });
+    // Keymap layers are disposed with the plugin; no manual disposer here.
     context.keymap.layer(() => ({
       mode: "global",
       commands: [
@@ -17,19 +110,38 @@ export default Plugin.define({
           slash: { name: "mesh" },
           palette: true,
           run: async () => {
-            context.ui.toast.show({
-              title: "Mesh",
-              message: "Multi-session coordination available",
-              variant: "info",
+            await refresh();
+            const current = snapshot();
+            if (!current) {
+              context.ui.toast.show({
+                title: "Mesh",
+                message: "Server unreachable",
+                variant: "info",
+              });
+              return;
+            }
+            context.ui.dialog.show(() => dialogBody(theme, current));
+            context.ui.dialog.set({ size: "medium" });
+          },
+        },
+        {
+          id: "mesh.toggleSidebar",
+          title: "Toggle mesh sidebar",
+          group: "Mesh",
+          run: async () => {
+            await mutate((draft) => {
+              draft.collapsed = !draft.collapsed;
             });
+            void refresh();
           },
         },
       ],
     }));
-    return context.ui.slot({
-      append: "sidebar.content",
-      render: () => null,
-    });
+    return () => {
+      clearTimeout(debounce);
+      clearInterval(timer);
+      unregister();
+    };
   },
 });

package/package.json CHANGED Viewed

@@ -1,6 +1,6 @@
 {
   "name": "@log0u7/opencode-mesh",
-  "version": "0.5.1",
+  "version": "0.7.0",
   "description": "Multi-session coordination for OpenCode: session coordination on one machine and a peer pool across LAN or Tailscale, with pairing, mailbox, and worktree locks.",
   "type": "module",
   "license": "Apache-2.0",