@mirrowel/opencode-openshare 0.1.0 → 0.1.1

package/README.md

@@ -9,7 +9,7 @@ OpenCode v1 and v2, self-hosted on your own worker.
 |---|---|---|
 | `dist/server.js` | package server entry (opencode.json `plugin` array) | all, unless the TUI is registered |
 | `dist/tui.js` | package TUI entry (tui.json `plugin` array) | its presence flips the server to manual |
-| `openshare.js` | single-file, zero-dependency bundle of the same engine (built by `npm run build`) | always all — the CI bundle |
+| `ci/openshare.js` | single-file, zero-dependency bundle of the same engine (committed; rebuilt by `npm run build`) | always all — the CI bundle |
 
 All three are behavior-identical where they overlap — `npm run
 test:regression` proves the single file and the package match the frozen
@@ -17,36 +17,29 @@ original (`reference/openshare.legacy.js`) on the full share lifecycle.
 
 ## Install
 
-Interactive (manual sharing, `/share` command, sidebar chip):
+From the registry (published). **v1 hosts** — the bare package name in
+BOTH config files (no `/tui` suffix; opencode resolves the entrypoints
+itself):
 
 ```jsonc
 // opencode.json
 { "plugin": ["@mirrowel/opencode-openshare"] }
 // tui.json (global ~/.config/opencode/tui.json or project)
-{ "plugin": ["@mirrowel/opencode-openshare/tui"] }
+{ "plugin": ["@mirrowel/opencode-openshare"] }
 ```
 
-CI (share everything, link to a file):
+**v2 hosts** — the CLI writes the config for you:
 
-```jsonc
-// OPENCODE_CONFIG one-file setup
-{
-  "plugin": ["/path/to/openshare.js"]
-  // + openshare.config.json next to the bundle (servers group or the
-  //   legacy env pair), OPENSHARE_URL_FILE collects each share URL
-  //   (also printed to stderr)
-}
+```sh
+opencode plugin add @mirrowel/opencode-openshare
 ```
 
-Then configure (`openshare.config.json` next to the package — see the
-[main README](../README.md#configuration) for all keys):
+Restart opencode; `/share` and `/openshare` appear in the TUI.
 
-```jsonc
-{ "workerUrl": "https://your-worker.workers.dev", "createToken": "…" }
-```
-
-Or the multi-server form (canonical; `workerUrl`/`createToken` above is
-the single-server shorthand):
+Then configure. For an npm install the durable config file is the
+**settings home** (`~/.config/opencode/openshare.config.json` — also
+what `/openshare` writes); "next to the package" only applies to file
+installs (the CI bundle):
 
 ```jsonc
 {
@@ -57,6 +50,15 @@ the single-server shorthand):
 }
 ```
 
+`workerUrl`/`createToken` is the legacy single-server shorthand for the
+same thing — the `servers` form above is canonical.
+
+From a local checkout (developing / tracking main): use the directory
+spec `"file:///…/openshare/share-plugin"` in both config files (run
+`npm run build` first — `dist/` is not committed). The CI bundle needs
+no build at all: [`ci/openshare.js`](ci/README.md), committed ready to
+use.
+
 **With no token the plugin enrolls itself** on first contact: public
 servers (hoster set `AUTH_MODE=public`) take anyone; private ones need
 a `code` from the hoster (activation-budgeted invite). The enrolled
@@ -116,16 +118,15 @@ stays all-mode.
 
 ```bash
 npm install
-npm run build         # tsc -> dist/ + bun bundle -> openshare.js
+npm run build         # tsc -> dist/ + bun bundle -> ci/openshare.js (Bun on PATH)
 npm run typecheck
 npm run test          # full matrix via the parallel driver (~4.5 min)
 npm run test:quick     # everyday gate (~90s): parity + manual core + TUI + v2 + auth
 ```
 
 Suites (shared machinery in `scripts/suite-lib.mjs`; every run is
-watchdogged, port-swept, and drives the real production path — local
-`wrangler dev` worker + real `opencode serve` with a mock OpenAI-compatible
-provider):
+watchdogged, port-swept, and drives real `opencode serve` instances with
+a mock OpenAI-compatible provider — except where noted):
 
 - `test:regression` — parity of legacy / single-file / package across the
   full lifecycle (create → prompt → completed → delete → 404).
@@ -134,18 +135,21 @@ provider):
   gates, undo tombstones, completed debounce, turn-mode drops.
 - `test:tui-flow` — share/unshare flows, config round-trip, connect
   flow (enroll + persist + rotate), admin console round-trip.
-- `test:v2` — the v2 adapter against a scripted mock v2 host (event
+- `test:v2` — the v2 adapter against a **scripted mock v2 host** (event
   classification, message conversion, live re-sync, delete).
-- `test:auth` — server identity contract: enrollment, code burn, rotate,
-  freeze (secret dead too), limits, reassign, public mode (48 checks).
+- `test:auth` — the **server identity contract** exercised over HTTP/WS
+  (no opencode instance): enrollment, code burn, rotate, freeze (secret
+  dead too), limits, reassign, public mode (48 checks).
 - `test:enroll` — the plugin's enrollment lifecycle end to end (code
   enroll, token persistence across processes, revoke → re-enroll,
   blocked path, public zero-config).
 - `test:fanout` — multi-server: v2 bindings, content parity across
   servers, mid-session join with full-history backfill, per-session
   opt-outs.
-- `test:cli` — real `opencode run` end-to-end (single file + package +
-  silenced outputs), on-demand only (uses the default model).
+- `test:cli` — real `opencode run` end to end (single file + package +
+  silenced outputs; mock provider, sandboxed XDG homes) — on demand.
+- `node scripts/npm-e2e.mjs` — the **published** npm package installed
+  by registry spec, end to end — on demand.
 - `test:server-auth` / `test:server-enroll` — the SAME auth/enroll
   suites against the portable Bun backend (`../share-server`): the
   two-backends-one-protocol parity guarantee.
@@ -162,7 +166,9 @@ src/
   commands.ts      /share (toggle + fan-out manager + collision dialog) /openshare
   share-flow.ts    host-agnostic flows: flag, bindings v1/v2, enrollment,
                    rotate/disconnect, admin client, unshare multi-delete
-  settings.ts      settings dialog + servers section + admin console
+  settings.ts      grouped settings tree + servers section + admin console
+  dialogs.tsx      MenuDialog/InfoDialog/PromptDialog + the sizing core (75% budget)
+  ui-prefs.ts      menu size prefs (host kv store)
   sidebar.tsx      sidebar_title slot chip (v1, box-rooted)
   tui-host.ts      host facade interface
   v2-server.ts     v2 setup: event mapping + client adapter + v2->v1 conversion

package/ci/openshare.config.json

@@ -1,5 +1,10 @@
 {
-  "$comment": "Open(code)Share CI bundle config. This file sits NEXT TO openshare.js and is read at load; OPENSHARE_* env vars always win (the CI way). The single-file bundle ALWAYS shares all sessions.",
+  "$comment": "Open(code)Share CI bundle config. This file sits NEXT TO openshare.js and is read at load; OPENSHARE_* env vars always win (the CI way). The single-file bundle ALWAYS shares all sessions. Prefer the servers form below (workerUrl/createToken is the legacy single-server shorthand). Empty string means unset. urlFile/announceStderr control the two URL outputs; 'none' disables the file.",
+  "servers": {
+    "https://your-worker.workers.dev": { "token": "" }
+  },
   "workerUrl": "",
-  "createToken": ""
+  "createToken": "",
+  "urlFile": "",
+  "announceStderr": true
 }

package/ci/openshare.js

@@ -13,12 +13,15 @@
 //    lands in the log and optionally in `urlFile`).
 //  - Interactive opt-in: install the package's TUI part (tui.json) too —
 //    the server detects its presence and switches to manual mode
-//    (`/share`, `/unshare` in the TUI).
+//    (`/share` + `/openshare` in the TUI).
 //
 // Config: env (OPENSHARE_*) > openshare.config.json (next to this file)
-// > code defaults. Keys: workerUrl, createToken, debounceMs, modelLabel,
-// ttlDays, openTasksInNewTab, authLogin, authPassword, spoolDir, urlFile,
-// shareMode ("all" | "manual"; default = TUI presence).
+// > code defaults. Keys: servers (multi-server: url -> {token, code,
+// label, active, adminToken}), workerUrl, createToken (legacy pair),
+// shareMode ("all" | "manual"; default = TUI presence), debounceMs,
+// completedDelayMs, modelLabel, ttlDays, openTasksInNewTab,
+// authLogin, authPassword, spoolDir, urlFile ("none" = off),
+// announceStderr.
 //
 // src/config.ts
 import { existsSync, readFileSync, writeFileSync } from "node:fs";
@@ -117,8 +120,8 @@ function resolveServer(cfg) {
   if (cfg.workerUrl)
     servers[cfg.workerUrl] = { token: cfg.createToken || "", adminToken: cfg.createToken || "", active: true };
   if (cfg.servers)
-    for (const [url2, entry] of Object.entries(cfg.servers))
-      servers[url2] = entry;
+    for (const [url, entry] of Object.entries(cfg.servers))
+      servers[url] = entry;
   const urls = Object.keys(servers);
   if (!urls.length)
     return;
@@ -245,7 +248,9 @@ function specPath(spec) {
 function isOpenShareSpec(spec) {
   if (typeof spec !== "string" || spec.length === 0)
     return false;
-  if (spec === NPM_NAME || spec.startsWith(`${NPM_NAME}@`))
+  if (spec === NPM_NAME)
+    return true;
+  if (spec.startsWith(`${NPM_NAME}@`) || spec.startsWith(`${NPM_NAME}/`))
     return true;
   const path = specPath(spec);
   if (path) {
@@ -568,19 +573,19 @@ function createEngine(deps) {
     if (!raw || typeof raw !== "object")
       return;
     const p = raw;
-    const num2 = (v, d) => {
+    const num = (v, d) => {
       const n = Number(v);
       return Number.isFinite(n) && n >= 0 ? n : d;
     };
     const prev = policyOf(url);
     policyMap.set(url, {
       mode: p.mode === "turn" ? "turn" : "persistent",
-      turnGraceMs: num2(p.turnGraceMs, prev.turnGraceMs),
-      idleDropMs: num2(p.idleDropMs, prev.idleDropMs),
-      finalizeAfterMs: num2(p.finalizeAfterMs, prev.finalizeAfterMs),
-      debounceMinMs: num2(p.debounceMinMs, 0),
-      debounceMaxMs: Math.max(num2(p.debounceMaxMs, Infinity), num2(p.debounceMinMs, 0)),
-      completedDelayMaxMs: num2(p.completedDelayMaxMs, Infinity)
+      turnGraceMs: num(p.turnGraceMs, prev.turnGraceMs),
+      idleDropMs: num(p.idleDropMs, prev.idleDropMs),
+      finalizeAfterMs: num(p.finalizeAfterMs, prev.finalizeAfterMs),
+      debounceMinMs: num(p.debounceMinMs, 0),
+      debounceMaxMs: Math.max(num(p.debounceMaxMs, Infinity), num(p.debounceMinMs, 0)),
+      completedDelayMaxMs: num(p.completedDelayMaxMs, Infinity)
     });
     clampToPolicy();
     if (debugEvents)
@@ -1605,31 +1610,31 @@ function createEngine(deps) {
     const parent = trackChild(sid, info);
     if (mode === "manual") {
       if (parent) {
-        const st3 = sessions.get(parent);
-        if (st3?.activated && !st3.closed) {
-          if (!st3.prefsSent) {
-            st3.prefsSent = true;
-            enqueue(st3, itemFor("prefs", { openTasksInNewTab: cfg.openTasksInNewTab !== false }, sid));
+        const st = sessions.get(parent);
+        if (st?.activated && !st.closed) {
+          if (!st.prefsSent) {
+            st.prefsSent = true;
+            enqueue(st, itemFor("prefs", { openTasksInNewTab: cfg.openTasksInNewTab !== false }, sid));
           }
           if (info)
-            enqueue(st3, itemFor("session", redact(info), sid));
+            enqueue(st, itemFor("session", redact(info), sid));
         }
         return;
       }
       const flag = shareFlag(info);
-      const st2 = sessions.get(sid);
+      const st = sessions.get(sid);
       if (flag.enabled) {
-        if (st2?.activated && !st2.closed) {
+        if (st?.activated && !st.closed) {
           if (flag.opts)
-            st2.opts = flag.opts;
-          if (!st2.prefsSent) {
-            st2.prefsSent = true;
-            enqueue(st2, itemFor("prefs", { openTasksInNewTab: cfg.openTasksInNewTab !== false }, sid));
+            st.opts = flag.opts;
+          if (!st.prefsSent) {
+            st.prefsSent = true;
+            enqueue(st, itemFor("prefs", { openTasksInNewTab: cfg.openTasksInNewTab !== false }, sid));
           }
           if (info)
-            enqueue(st2, itemFor("session", redact(info), sid));
+            enqueue(st, itemFor("session", redact(info), sid));
           if (t === "session.updated")
-            chain = chain.then(() => refreshOptOuts(st2)).catch(() => {});
+            chain = chain.then(() => refreshOptOuts(st)).catch(() => {});
           return;
         }
         activate(sid, flag.opts, info);
@@ -1640,9 +1645,9 @@ function createEngine(deps) {
         }
         return;
       }
-      if (st2?.activated && !st2.closed && t === "session.updated") {
+      if (st?.activated && !st.closed && t === "session.updated") {
         log(`share disabled for ${sid} - removing`);
-        chain = chain.then(() => remove(st2)).catch((e) => logError("remove error", e?.message || e));
+        chain = chain.then(() => remove(st)).catch((e) => logError("remove error", e?.message || e));
         return;
       }
       return;
@@ -1788,16 +1793,16 @@ function createEngine(deps) {
               chain = chain.then(async () => {
                 if (created.closed)
                   return;
-                const info2 = await sessionInfo(created.client, main);
+                const info = await sessionInfo(created.client, main);
                 verifying.delete(main);
                 if (created.closed)
                   return;
-                const flag = shareFlag(info2);
-                const hasBinding = !!info2?.metadata?.[METADATA_KEY];
-                const createdMs = info2?.time?.created;
+                const flag = shareFlag(info);
+                const hasBinding = !!info?.metadata?.[METADATA_KEY];
+                const createdMs = info?.time?.created;
                 const isPreExisting = typeof createdMs === "number" && createdMs < bootTime;
                 if (debugEvents) {
-                  log(`verify ${main}: created=${createdMs} boot=${bootTime} pre=${isPreExisting} flag=${flag.enabled} binding=${hasBinding} infoMissing=${!info2}`);
+                  log(`verify ${main}: created=${createdMs} boot=${bootTime} pre=${isPreExisting} flag=${flag.enabled} binding=${hasBinding} infoMissing=${!info}`);
                 }
                 if (isPreExisting && !flag.enabled && !hasBinding) {
                   preExistingRetired.add(main);
@@ -2259,7 +2264,7 @@ var server_default = {
   setup: createV2ServerSetup()
 };
 export {
-  server_default as default,
+  OpenSharePlugin,
   PLUGIN_ID,
-  OpenSharePlugin
+  server_default as default
 };

package/dist/config.d.ts

@@ -109,7 +109,11 @@ export declare function deleteServerEntry(url: string, target?: string): string
  * never shadows the real config elsewhere. */
 export declare function loadConfig(pluginDir: string, options?: Record<string, unknown>): ShareConfig;
 export declare function spoolDirFor(cfg: ShareConfig): string;
-/** Does this plugin spec (tui.json entry) point at the openshare package? */
+/** Does this plugin spec (tui.json entry) point at the openshare package?
+ * Accepts the bare npm name, name@version, and the /tui (or any) subpath
+ * form — older docs shipped the subpath spec and presence detection must
+ * never silently miss it (all-mode would keep auto-sharing while the user
+ * believes they installed manual mode — live-caught in review). */
 export declare function isOpenShareSpec(spec: unknown): spec is string;
 /** tui.json layers the TUI reads (mirrors the family selfwire path rules,
  * read-only). The walk runs from the session directory up to the worktree

package/dist/config.js

@@ -402,11 +402,18 @@ function specPath(spec) {
         return undefined;
     }
 }
-/** Does this plugin spec (tui.json entry) point at the openshare package? */
+/** Does this plugin spec (tui.json entry) point at the openshare package?
+ * Accepts the bare npm name, name@version, and the /tui (or any) subpath
+ * form — older docs shipped the subpath spec and presence detection must
+ * never silently miss it (all-mode would keep auto-sharing while the user
+ * believes they installed manual mode — live-caught in review). */
 export function isOpenShareSpec(spec) {
     if (typeof spec !== "string" || spec.length === 0)
         return false;
-    if (spec === NPM_NAME || spec.startsWith(`${NPM_NAME}@`))
+    if (spec === NPM_NAME)
+        return true;
+    // name@version, name/tui, name@version/tui
+    if (spec.startsWith(`${NPM_NAME}@`) || spec.startsWith(`${NPM_NAME}/`))
         return true;
     const path = specPath(spec);
     if (path) {

package/dist/share-flow.js

@@ -1,4 +1,4 @@
-// OpenShare share flows — host-agnostic logic behind /share, /unshare and
+// OpenShare share flows — host-agnostic logic behind /share and
 // the settings dialog's "this session" actions. Runs against the
 // ShareHostApi facade (tui-host.ts) and the shared config module, so the
 // same compiled code serves the v1 TUI and the v2 adapter.
@@ -9,7 +9,7 @@
 //             (with per-session opts when present) -> wait for the server
 //             plugin to publish the binding URL into session metadata
 //             (~seconds; worker-down surfaces as a timeout toast) -> copy.
-//  /unshare   resolve root -> confirm -> read binding -> clear flag ->
+//  stop-sharing   resolve root -> confirm -> read binding -> clear flag ->
 //             DELETE the share directly via the worker (belt and braces:
 //             works even if the server plugin never saw the flag event) ->
 //             the server-side flag-removal path cleans up on its own.

package/dist/tui.js

@@ -1,19 +1,15 @@
 // @bun
-var __defProp = Object.defineProperty;
-var __returnValue = (v) => v;
-function __exportSetter(name, newValue) {
-  this[name] = __returnValue.bind(null, newValue);
-}
-var __export = (target, all) => {
-  for (var name in all)
-    __defProp(target, name, {
-      get: all[name],
-      enumerable: true,
-      configurable: true,
-      set: __exportSetter.bind(all, name)
-    });
+var __esm = (fn, res, err) => () => {
+  if (fn)
+    try {
+      res = fn(fn = 0);
+    } catch (e) {
+      err = [e];
+    }
+  if (err)
+    throw err[0];
+  return res;
 };
-var __esm = (fn, res) => () => (fn && (res = fn(fn = 0)), res);
 
 // src/config.ts
 import { existsSync, readFileSync, writeFileSync } from "fs";
@@ -165,8 +161,8 @@ function resolveServer(cfg) {
   if (cfg.workerUrl)
     servers[cfg.workerUrl] = { token: cfg.createToken || "", adminToken: cfg.createToken || "", active: true };
   if (cfg.servers)
-    for (const [url2, entry] of Object.entries(cfg.servers))
-      servers[url2] = entry;
+    for (const [url, entry] of Object.entries(cfg.servers))
+      servers[url] = entry;
   const urls = Object.keys(servers);
   if (!urls.length)
     return;
@@ -467,46 +463,7 @@ var init_sidebar = __esm(() => {
 });
 
 // src/share-flow.ts
-var exports_share_flow = {};
-__export(exports_share_flow, {
-  workerDeleteShare: () => workerDeleteShare,
-  waitForBinding: () => waitForBinding,
-  verifyShare: () => verifyShare,
-  setShareFlag: () => setShareFlag,
-  serverEntries: () => serverEntries,
-  saveServerEntry: () => saveServerEntry,
-  saveConfig: () => saveConfig,
-  runUnshareFlow: () => runUnshareFlow,
-  runShareFlow: () => runShareFlow,
-  rotateAtServer: () => rotateAtServer,
-  resolveRoot: () => resolveRoot,
-  readBindings: () => readBindings,
-  readBinding: () => readBinding,
-  probeWorker: () => probeWorker,
-  probeAuthMode: () => probeAuthMode,
-  pluginConfigPaths: () => pluginConfigPaths,
-  patchSessionBinding: () => patchSessionBinding,
-  normServerUrl: () => normServerUrl,
-  isConfigured: () => isConfigured,
-  hostOf: () => hostOf,
-  enrollAtServer: () => enrollAtServer,
-  disconnectAtServer: () => disconnectAtServer,
-  deleteServerEntry: () => deleteServerEntry,
-  currentConfig: () => currentConfig,
-  confirmShare: () => confirmShare,
-  clearShareFlag: () => clearShareFlag,
-  clearGoneBindingEntries: () => clearGoneBindingEntries,
-  bindingsOf: () => bindingsOf,
-  bindingOf: () => bindingOf,
-  adminTokenFor: () => adminTokenFor,
-  adminClient: () => adminClient,
-  activeServer: () => activeServer,
-  CONSENT_KV_KEY: () => CONSENT_KV_KEY
-});
 import { existsSync as existsSync2, readFileSync as readFileSync2, writeFileSync as writeFileSync2 } from "fs";
-function pluginConfigPaths(baseDir = moduleDir()) {
-  return configPaths(baseDir);
-}
 function currentConfig(baseDir = moduleDir()) {
   return loadConfig(baseDir);
 }
@@ -1169,14 +1126,14 @@ async function editKey(host, cfg, key) {
     });
     if (picked === undefined)
       return;
-    const next2 = { ...cfg };
+    const next = { ...cfg };
     if (key === "shareMode")
-      next2[key] = picked === "auto" ? undefined : picked;
+      next[key] = picked === "auto" ? undefined : picked;
     else if (key === "openTasksInNewTab" || key === "announceStderr")
-      next2[key] = picked === "true";
+      next[key] = picked === "true";
     else
-      next2[key] = picked;
-    return next2;
+      next[key] = picked;
+    return next;
   }
   const raw = await showPrompt(host.ui, {
     title: `${meta.label} \u2014 ${displayValue(key, cfg)}`,
@@ -1681,15 +1638,15 @@ async function adminCodesMenu(host, client, codes) {
         continue;
       const n = Number(raw.trim() === "" ? "1" : raw.trim());
       const activations = Number.isFinite(n) && n >= 1 ? Math.floor(n) : -1;
-      const res2 = await client.createCode(label.trim() || "invite", activations);
-      if (res2.ok && res2.data?.code) {
-        await host.clipboard.write(res2.data.code);
-        await showInfo(host.ui, { title: "Code created", message: `${label.trim() || "invite"}: ${res2.data.code}
+      const res = await client.createCode(label.trim() || "invite", activations);
+      if (res.ok && res.data?.code) {
+        await host.clipboard.write(res.data.code);
+        await showInfo(host.ui, { title: "Code created", message: `${label.trim() || "invite"}: ${res.data.code}
 (${activations === -1 ? "unlimited" : activations} activation${activations === 1 ? "" : "s"})
 
 (copied to clipboard \u2014 shown once)` });
       } else {
-        await showInfo(host.ui, { title: "Create failed", message: res2.error ?? "unknown error" });
+        await showInfo(host.ui, { title: "Create failed", message: res.error ?? "unknown error" });
       }
       continue;
     }
@@ -2215,7 +2172,7 @@ async function showShareManager(host, sessionID) {
       all = all.filter((b) => !gone.some((g) => g.server === b.server));
       const list = gone.map((b) => `\u2022 ${hostOf(b.url || b.server)} \u2014 ${b.url}`).join(`
 `);
-      const choice2 = await host.ui.showMenu({
+      const choice = await host.ui.showMenu({
         title: "Share is gone",
         hint: "The page was removed, expired, or purged on the server \u2014 sharing disabled for it.",
         options: [
@@ -2229,7 +2186,7 @@ Gone:
 ${list}` }
         ]
       });
-      if (choice2 === "again") {
+      if (choice === "again") {
         finish(host, await runShareFlow(host, sid));
         return;
       }
@@ -2266,13 +2223,13 @@ Anyone with the link can read the page (plus the login, if read auth is set).`
         },
         { title: "Cancel", value: "cancel" }
       ]
-    }).then(async (choice2) => {
-      if (choice2 === "copy") {
+    }).then(async (choice) => {
+      if (choice === "copy") {
         const ok = await host.clipboard.write(b.url);
         finish(host, ok ? { ok: true, message: `Share URL copied to clipboard: ${b.url}`, url: b.url } : { ok: false, message: `Could not write the clipboard \u2014 link: ${b.url}`, url: b.url });
         return;
       }
-      if (choice2 === "stop") {
+      if (choice === "stop") {
         const how = await host.ui.showMenu({
           title: "Stop sharing",
           hint: b.url,
@@ -2411,18 +2368,18 @@ ${otherServers.map((s) => `\u2022 ${s.url}`).join(`
     });
     if (!pick || pick === "__cancel")
       return;
-    const { saveServerEntry: saveServerEntry2 } = await Promise.resolve().then(() => (init_share_flow(), exports_share_flow));
+    await Promise.resolve().then(() => init_share_flow());
     for (const s of serverEntries())
       if (s.url !== pick)
-        saveServerEntry2(s.url, { active: undefined });
-    saveServerEntry2(pick, { active: true });
+        saveServerEntry(s.url, { active: undefined });
+    saveServerEntry(pick, { active: true });
     finish(host, { ok: true, message: `${hostOf(pick)} activated \u2014 this session mirrors there within seconds (new sessions share to it too).` });
     return;
   }
   if (choice === "manage") {
     const pick = await host.ui.showMenu({
       title: "Manage server",
-      options: [...all.map((b2) => ({ title: hostOf(b2.url || b2.server), value: b2.server, description: b2.url })), { title: "Cancel", value: "__cancel" }]
+      options: [...all.map((b) => ({ title: hostOf(b.url || b.server), value: b.server, description: b.url })), { title: "Cancel", value: "__cancel" }]
     });
     if (!pick || pick === "__cancel")
       return;
@@ -2952,20 +2909,20 @@ function MenuDialog(props) {
       else
         sections.at(-1)?.lines.push(line);
     }
-    for (const section2 of sections) {
-      while (section2.lines.length && section2.lines.at(-1) === "")
-        section2.lines.pop();
-      while (section2.lines.length && section2.lines[0] === "")
-        section2.lines.shift();
+    for (const section of sections) {
+      while (section.lines.length && section.lines.at(-1) === "")
+        section.lines.pop();
+      while (section.lines.length && section.lines[0] === "")
+        section.lines.shift();
     }
     const contentWidth = dialogContentWidth(props.api) - 2;
-    return sections.filter((section2, index) => index === 0 ? section2.lines.length > 0 : true).map((section2) => ({
-      title: section2.title,
-      lines: preWrap(section2.lines.join(`
+    return sections.filter((section, index) => index === 0 ? section.lines.length > 0 : true).map((section) => ({
+      title: section.title,
+      lines: preWrap(section.lines.join(`
 `), contentWidth)
     }));
   });
-  const infoHeight = createMemo(() => cappedHeight(helpSections().reduce((rows, section2) => rows + section2.lines.length + (section2.title ? 2 : 0), 0) + 1, maxRows(props.api, dimensions().height, 8, 4), 4));
+  const infoHeight = createMemo(() => cappedHeight(helpSections().reduce((rows, section) => rows + section.lines.length + (section.title ? 2 : 0), 0) + 1, maxRows(props.api, dimensions().height, 8, 4), 4));
   const [section, setSection] = createSignal(0);
   const jumpSection = (delta) => {
     const count = helpSections().length;
@@ -4757,6 +4714,6 @@ var tui_default = {
   setup: createV2TuiSetup()
 };
 export {
-  tui_default as default,
-  buildV1HostApi
+  buildV1HostApi,
+  tui_default as default
 };

package/openshare.config.json

@@ -1,5 +1,5 @@
 {
-  "$comment": "Open(code)Share plugin config. Priority: OPENSHARE_* env vars > plugin options > this file > code defaults. Sync cadence keys are clamped into the worker's policy window (see worker SOCKET_POLICY/DEBOUNCE_MIN_MS/DEBOUNCE_MAX_MS/COMPLETED_DELAY_MAX_MS). Keys: workerUrl (your openshare-worker deployment; empty = plugin stays disabled), createToken (legacy: the worker's CREATE_TOKEN — keep OUT of git), servers (multi-server memberships: url -> {token, code, label, active}; the active entry (or the first) receives new sessions; with no token the plugin ENROLLS itself — public servers take anyone, private ones need a code from the hoster; enrolled tokens persist to ~/.config/opencode/openshare.config.json), debounceMs (sync interval: max time between syncs while streaming; default 10000), completedDelayMs (idle this long before the share says completed; default 5000, 0 = immediate), modelLabel ($Provider/$Model placeholders; literal text sends as-is; empty string hides the model), ttlDays (per-share TTL, capped by the worker), openTasksInNewTab (task rows open subagent pages in a new tab), authLogin/authPassword (optional read gate on the share pages; sent on create AND resume; empty on resume removes protection), spoolDir (temporary unacked-frame buffer; default XDG data home), urlFile (write each share URL to this file; empty = default openshare.urls.txt in the session's directory; \"none\" = no URL file), announceStderr (false silences the [openshare] live: / url file: log lines; the share itself is unaffected).",
+  "$comment": "Open(code)Share plugin config. Priority: OPENSHARE_* env vars > plugin options > this file > code defaults. Sync cadence keys are clamped into the worker's policy window (see worker SOCKET_POLICY/DEBOUNCE_MIN_MS/DEBOUNCE_MAX_MS/COMPLETED_DELAY_MAX_MS). Keys: workerUrl (your openshare-worker deployment; empty = plugin stays disabled), createToken (legacy: the worker's CREATE_TOKEN — keep OUT of git), servers (multi-server memberships: url -> {token, code, label, active, adminToken (root token for the TUI admin console)}; the active entry (or the first) receives new sessions; with no token the plugin ENROLLS itself — public servers take anyone, private ones need a code from the hoster; enrolled tokens persist to ~/.config/opencode/openshare.config.json), debounceMs (sync interval: max time between syncs while streaming; default 10000), completedDelayMs (idle this long before the share says completed; default 5000, 0 = immediate), modelLabel ($Provider/$Model placeholders; literal text sends as-is; empty string hides the model), ttlDays (per-share TTL, capped by the worker), openTasksInNewTab (task rows open subagent pages in a new tab), authLogin/authPassword (optional read gate on the share pages; sent on create AND resume; empty on resume removes protection), spoolDir (temporary unacked-frame buffer; default XDG data home), urlFile (write each share URL to this file; empty = default openshare.urls.txt in the session's directory; \"none\" = no URL file), announceStderr (false silences the [openshare] live: / url file: log lines; the share itself is unaffected).",
   "workerUrl": "",
   "createToken": "",
   "servers": {},

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mirrowel/opencode-openshare",
-  "version": "0.1.0",
+  "version": "0.1.1",
   "type": "module",
   "description": "Open(code)Share — re:share: self-hosted session sharing for opencode. Server plugin (single file or package), optional TUI for interactive opt-in sharing.",
   "license": "MIT",
@@ -92,7 +92,7 @@
     "@opentui/solid": "^0.4.1"
   },
   "peerDependencies": {
-    "@opencode-ai/plugin": ">=1.14.0"
+    "@opencode-ai/plugin": ">=1.18.0"
   },
   "engines": {
     "node": ">=20"

package/src/banner.txt

@@ -13,10 +13,13 @@
 //    lands in the log and optionally in `urlFile`).
 //  - Interactive opt-in: install the package's TUI part (tui.json) too —
 //    the server detects its presence and switches to manual mode
-//    (`/share`, `/unshare` in the TUI).
+//    (`/share` + `/openshare` in the TUI).
 //
 // Config: env (OPENSHARE_*) > openshare.config.json (next to this file)
-// > code defaults. Keys: workerUrl, createToken, debounceMs, modelLabel,
-// ttlDays, openTasksInNewTab, authLogin, authPassword, spoolDir, urlFile,
-// shareMode ("all" | "manual"; default = TUI presence).
+// > code defaults. Keys: servers (multi-server: url -> {token, code,
+// label, active, adminToken}), workerUrl, createToken (legacy pair),
+// shareMode ("all" | "manual"; default = TUI presence), debounceMs,
+// completedDelayMs, modelLabel, ttlDays, openTasksInNewTab,
+// authLogin, authPassword, spoolDir, urlFile ("none" = off),
+// announceStderr.
 //

package/src/config.ts

@@ -413,10 +413,16 @@ function specPath(spec: string): string | undefined {
   }
 }
 
-/** Does this plugin spec (tui.json entry) point at the openshare package? */
+/** Does this plugin spec (tui.json entry) point at the openshare package?
+ * Accepts the bare npm name, name@version, and the /tui (or any) subpath
+ * form — older docs shipped the subpath spec and presence detection must
+ * never silently miss it (all-mode would keep auto-sharing while the user
+ * believes they installed manual mode — live-caught in review). */
 export function isOpenShareSpec(spec: unknown): spec is string {
   if (typeof spec !== "string" || spec.length === 0) return false
-  if (spec === NPM_NAME || spec.startsWith(`${NPM_NAME}@`)) return true
+  if (spec === NPM_NAME) return true
+  // name@version, name/tui, name@version/tui
+  if (spec.startsWith(`${NPM_NAME}@`) || spec.startsWith(`${NPM_NAME}/`)) return true
   const path = specPath(spec)
   if (path) {
     if (path.endsWith("/opencode-openshare") || path.endsWith("/share-plugin")) return true

package/src/share-flow.ts

@@ -1,4 +1,4 @@
-// OpenShare share flows — host-agnostic logic behind /share, /unshare and
+// OpenShare share flows — host-agnostic logic behind /share and
 // the settings dialog's "this session" actions. Runs against the
 // ShareHostApi facade (tui-host.ts) and the shared config module, so the
 // same compiled code serves the v1 TUI and the v2 adapter.
@@ -9,7 +9,7 @@
 //             (with per-session opts when present) -> wait for the server
 //             plugin to publish the binding URL into session metadata
 //             (~seconds; worker-down surfaces as a timeout toast) -> copy.
-//  /unshare   resolve root -> confirm -> read binding -> clear flag ->
+//  stop-sharing   resolve root -> confirm -> read binding -> clear flag ->
 //             DELETE the share directly via the worker (belt and braces:
 //             works even if the server plugin never saw the flag event) ->
 //             the server-side flag-removal path cleans up on its own.

package/src/tui.tsx

@@ -2,7 +2,7 @@
 
 // OpenShare TUI plugin entry (OpenCode v1).
 //
-// Registers the /share, /unshare (shadowing the deprecated opncd.ai
+// Registers the /share (toggle + manager, shadowing the deprecated opncd.ai
 // built-ins via a priority keymap layer) and /openshare commands, plus the
 // sidebar_title slot chip. The flows run against the ShareHostApi facade
 // (tui-host.ts); v2 hosts run the same flows through the v2-tui adapter.