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

@log0u7/opencode-mesh 0.5.1 → 0.6.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,14 @@ 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.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,77 @@
+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[];
+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,eAAO,MAAM,OAAO;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA+BlB,CAAC"}

package/dist/rpc.js ADDED Viewed

@@ -0,0 +1,61 @@
+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;
+}
+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":"AAAA,OAAO,EAAE,GAAG,EAAE,MAAM,sBAAsB,CAAC;AAsB3C,MAAM,UAAU,gBAAgB,CAAC,IAAmB;IAClD,OAAO;QACL,OAAO,EAAE,IAAI,CAAC,QAAQ,CAAC,OAAO;QAC9B,QAAQ,EAAE,IAAI,CAAC,QAAQ,CAAC,QAAQ;QAChC,KAAK,EAAE,IAAI,CAAC,KAAK;aACd,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,CAAC;aACvB,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,EAAE,OAAO,EAAE,CAAC,CAAC,OAAO,EAAE,QAAQ,EAAE,CAAC,CAAC,QAAQ,EAAE,CAAC,CAAC;QAC7D,YAAY,EAAE,IAAI,CAAC,KAAK,CAAC,MAAM;KAChC,CAAC;AACJ,CAAC;AAED,gFAAgF;AAChF,MAAM,UAAU,eAAe,CAAC,CAAe;IAC7C,MAAM,IAAI,GAAG,CAAC,CAAC,QAAQ,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC;IAC5D,MAAM,KAAK,GAAG,CAAC,SAAS,IAAI,EAAE,CAAC,CAAC;IAChC,IAAI,CAAC,CAAC,KAAK,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACzB,KAAK,CAAC,IAAI,CAAC,iBAAiB,CAAC,CAAC;IAChC,CAAC;SAAM,CAAC;QACN,KAAK,MAAM,IAAI,IAAI,CAAC,CAAC,KAAK,EAAE,CAAC;YAC3B,KAAK,CAAC,IAAI,CAAC,KAAK,IAAI,CAAC,QAAQ,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,OAAO,EAAE,CAAC,CAAC;QAC7E,CAAC;IACH,CAAC;IACD,IAAI,CAAC,CAAC,YAAY,GAAG,CAAC,EAAE,CAAC;QACvB,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,YAAY,iBAAiB,CAAC,CAAC;IACjD,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC;AAED,MAAM,CAAC,MAAM,OAAO,GAAG,GAAG,CAAC,MAAM,CAAC;IAChC,EAAE,EAAE,MAAM;IACV,OAAO,EAAE;QACP,QAAQ,EAAE;YACR,KAAK,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,UAAU,EAAE,EAAE,EAAE,oBAAoB,EAAE,KAAK,EAAE;YACtE,MAAM,EAAE;gBACN,IAAI,EAAE,QAAQ;gBACd,UAAU,EAAE;oBACV,OAAO,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,gBAAgB,EAAE;oBAC1D,QAAQ,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,sBAAsB,EAAE;oBACjE,KAAK,EAAE;wBACL,IAAI,EAAE,OAAO;wBACb,KAAK,EAAE;4BACL,IAAI,EAAE,QAAQ;4BACd,UAAU,EAAE;gCACV,OAAO,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;gCAC3B,QAAQ,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;6BAC7B;4BACD,QAAQ,EAAE,CAAC,SAAS,EAAE,UAAU,CAAC;4BACjC,oBAAoB,EAAE,KAAK;yBAC5B;wBACD,WAAW,EAAE,cAAc;qBAC5B;oBACD,YAAY,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,yBAAyB,EAAE;iBACzE;gBACD,QAAQ,EAAE,CAAC,SAAS,EAAE,UAAU,EAAE,OAAO,EAAE,cAAc,CAAC;gBAC1D,oBAAoB,EAAE,KAAK;aAC5B;SACF;KACF;IACD,MAAM,EAAE,EAAE;CACX,CAAC,CAAC"}

package/dist/tui.js CHANGED Viewed

@@ -1,6 +1,12 @@
+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, formatMeshLines } from "./rpc.js";
+const REFRESH_MS = 15_000;
 export default Plugin.define({
   id: "@log0u7/opencode-mesh.tui",
   setup(context) {
@@ -28,9 +34,45 @@ export default Plugin.define({
         }
       }]
     }));
-    return context.ui.slot({
+    // 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 [lines, setLines] = createSignal(null);
+    const mesh = context.client.rpc(MeshRpc);
+    const refresh = async () => {
+      try {
+        const snap = await mesh.snapshot({});
+        setLines(formatMeshLines(snap));
+      } catch {
+        setLines(null);
+      }
+    };
+    void refresh();
+    const timer = setInterval(() => void refresh(), REFRESH_MS);
+    const unregister = context.ui.slot({
       append: "sidebar.content",
-      render: () => null
+      render: () => _$createComponent(Show, {
+        get when() {
+          return lines();
+        },
+        keyed: true,
+        children: current => (() => {
+          var _el$ = _$createElement("box");
+          _$insert(_el$, _$createComponent(For, {
+            each: current,
+            children: line => (() => {
+              var _el$2 = _$createElement("text");
+              _$insert(_el$2, line);
+              return _el$2;
+            })()
+          }));
+          return _el$;
+        })()
+      })
     });
+    return () => {
+      clearInterval(timer);
+      unregister();
+    };
   }
 });

package/dist/tui.tsx CHANGED Viewed

@@ -1,6 +1,10 @@
 /** @jsxImportSource @opentui/solid */
 import { Plugin } from "@opencode/plugin/tui";
+import { For, Show, createSignal } from "solid-js";
+import { MeshRpc, formatMeshLines, type MeshSnapshot } from "./rpc.js";
+const REFRESH_MS = 15_000;
 export default Plugin.define({
   id: "@log0u7/opencode-mesh.tui",
@@ -27,9 +31,37 @@ export default Plugin.define({
       ],
     }));
-    return context.ui.slot({
+    // 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 [lines, setLines] = createSignal<string[] | null>(null);
+    const mesh = context.client.rpc(MeshRpc);
+    const refresh = async () => {
+      try {
+        const snap = (await mesh.snapshot({})) as MeshSnapshot;
+        setLines(formatMeshLines(snap));
+      } catch {
+        setLines(null);
+      }
+    };
+    void refresh();
+    const timer = setInterval(() => void refresh(), REFRESH_MS);
+    const unregister = context.ui.slot({
       append: "sidebar.content",
-      render: () => null,
+      render: () => (
+        <Show when={lines()} keyed>
+          {(current) => (
+            <box>
+              <For each={current}>{(line) => <text>{line}</text>}</For>
+            </box>
+          )}
+        </Show>
+      ),
     });
+    return () => {
+      clearInterval(timer);
+      unregister();
+    };
   },
 });

package/package.json CHANGED Viewed

@@ -1,6 +1,6 @@
 {
   "name": "@log0u7/opencode-mesh",
-  "version": "0.5.1",
+  "version": "0.6.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",