@opencode-cockpit/shell 0.1.5 → 0.2.1

package/dist/tui/{dock.js → components/dock.js}

@@ -10,9 +10,9 @@ import { createElement as _$createElement } from "@opentui/solid";
 
 import { useTerminalDimensions } from "@opentui/solid";
 import { createMemo, For, Show } from "solid-js";
+import { displayCommand, kindColor, kindOf, statusDetail, tailLines, tailRuns, truncate, watchColor, watchLabel } from "../lib/view.js";
+import { useScreen } from "../state/store.js";
 import { Badge } from "./badge.js";
-import { useScreen } from "./store.js";
-import { displayCommand, kindColor, kindOf, statusDetail, tailLines, truncate } from "./view.js";
 /** Split pane under the chat: status tabs for shells and the selected shell's live screen. */
 export function Dock(props) {
   const theme = () => props.api.theme.current;
@@ -25,7 +25,9 @@ export function Dock(props) {
   const tabLimit = () => Math.max(1, Math.floor((dims().width - 26) / 30));
   const tabs = createMemo(() => (props.store.showAll() ? props.store.shells() : props.store.visible()).slice(0, tabLimit()));
   const overflow = createMemo(() => props.store.shells().length - tabs().length);
-  const body = createMemo(() => tailLines(screen()?.text, bodyRows(), Math.max(10, dims().width - 4)));
+  const bodyCols = () => Math.max(10, dims().width - 4);
+  const body = createMemo(() => tailLines(screen()?.text, bodyRows(), bodyCols()));
+  const bodyRuns = createMemo(() => props.colors === false ? [] : tailRuns(screen()?.styled, bodyRows(), bodyCols()));
   return (() => {
     var _el$ = _$createElement("box"),
       _el$2 = _$createElement("box"),
@@ -139,18 +141,59 @@ export function Dock(props) {
         return props.store.selected();
       },
       children: shell => [(() => {
-        var _el$13 = _$createElement("box"),
-          _el$14 = _$createElement("text");
-        _$insertNode(_el$13, _el$14);
+        var _el$13 = _$createElement("box");
         _$setProp(_el$13, "flexGrow", 1);
         _$setProp(_el$13, "paddingLeft", 2);
         _$setProp(_el$13, "paddingRight", 1);
         _$setProp(_el$13, "minHeight", 0);
         _$setProp(_el$13, "overflow", "hidden");
         _$setProp(_el$13, "onMouseUp", () => props.onOpenConsole(shell().id));
-        _$setProp(_el$14, "wrapMode", "none");
-        _$insert(_el$14, () => body() || " ");
-        _$effect(_$p => _$setProp(_el$14, "fg", theme().text, _$p));
+        _$insert(_el$13, _$createComponent(Show, {
+          get when() {
+            return bodyRuns().length > 0;
+          },
+          get fallback() {
+            return (() => {
+              var _el$19 = _$createElement("text");
+              _$setProp(_el$19, "wrapMode", "none");
+              _$insert(_el$19, () => body() || " ");
+              _$effect(_$p => _$setProp(_el$19, "fg", theme().text, _$p));
+              return _el$19;
+            })();
+          },
+          get children() {
+            var _el$14 = _$createElement("box");
+            _$setProp(_el$14, "flexDirection", "column");
+            _$insert(_el$14, _$createComponent(For, {
+              get each() {
+                return bodyRuns();
+              },
+              children: row => (() => {
+                var _el$20 = _$createElement("text"),
+                  _el$21 = _$createTextNode(` `);
+                _$insertNode(_el$20, _el$21);
+                _$setProp(_el$20, "wrapMode", "none");
+                _$insert(_el$20, _$createComponent(For, {
+                  each: row,
+                  children: run => (() => {
+                    var _el$22 = _$createElement("span");
+                    _$insert(_el$22, () => run.text);
+                    _$effect(_$p => _$setProp(_el$22, "style", {
+                      fg: run.fg,
+                      bg: run.bg,
+                      bold: run.bold,
+                      italic: run.italic
+                    }, _$p));
+                    return _el$22;
+                  })()
+                }), _el$21);
+                _$effect(_$p => _$setProp(_el$20, "fg", theme().text, _$p));
+                return _el$20;
+              })()
+            }));
+            return _el$14;
+          }
+        }));
         return _el$13;
       })(), (() => {
         var _el$15 = _$createElement("box"),
@@ -165,25 +208,38 @@ export function Dock(props) {
         _$setProp(_el$16, "wrapMode", "none");
         _$setProp(_el$16, "flexShrink", 0);
         _$insert(_el$16, () => statusDetail(shell(), props.store.now()));
+        _$insert(_el$15, _$createComponent(Show, {
+          get when() {
+            return watchLabel(shell());
+          },
+          get children() {
+            var _el$17 = _$createElement("text");
+            _$setProp(_el$17, "wrapMode", "none");
+            _$setProp(_el$17, "flexShrink", 0);
+            _$insert(_el$17, () => watchLabel(shell()));
+            _$effect(_$p => _$setProp(_el$17, "fg", watchColor(theme(), shell()), _$p));
+            return _el$17;
+          }
+        }), null);
         _$insert(_el$15, _$createComponent(Show, {
           get when() {
             return _$memo(() => kindOf(shell()) === "fail")() && shell().summary;
           },
           get fallback() {
             return (() => {
-              var _el$18 = _$createElement("text");
-              _$setProp(_el$18, "wrapMode", "none");
-              _$insert(_el$18, () => truncate(`$ ${displayCommand(shell())}`, Math.max(20, dims().width - 40)));
-              _$effect(_$p => _$setProp(_el$18, "fg", theme().textMuted, _$p));
-              return _el$18;
+              var _el$23 = _$createElement("text");
+              _$setProp(_el$23, "wrapMode", "none");
+              _$insert(_el$23, () => truncate(`$ ${displayCommand(shell())}`, Math.max(20, dims().width - 40)));
+              _$effect(_$p => _$setProp(_el$23, "fg", theme().textMuted, _$p));
+              return _el$23;
             })();
           },
           get children() {
-            var _el$17 = _$createElement("text");
-            _$setProp(_el$17, "wrapMode", "none");
-            _$insert(_el$17, () => truncate(`${shell().summary}`, Math.max(20, dims().width - 40)));
-            _$effect(_$p => _$setProp(_el$17, "fg", theme().error, _$p));
-            return _el$17;
+            var _el$18 = _$createElement("text");
+            _$setProp(_el$18, "wrapMode", "none");
+            _$insert(_el$18, () => truncate(`${shell().summary}`, Math.max(20, dims().width - 40)));
+            _$effect(_$p => _$setProp(_el$18, "fg", theme().error, _$p));
+            return _el$18;
           }
         }), null);
         _$effect(_$p => _$setProp(_el$16, "fg", kindColor(theme(), kindOf(shell())), _$p));

package/dist/tui/{sidebar.js → components/sidebar.js}

@@ -9,8 +9,8 @@ import { createElement as _$createElement } from "@opentui/solid";
 /** @jsxImportSource @opentui/solid */
 
 import { createMemo, For, Show } from "solid-js";
+import { kindOf, shortDetail, truncate, watchColor, watchLabel } from "../lib/view.js";
 import { Badge } from "./badge.js";
-import { kindOf, shortDetail, truncate } from "./view.js";
 export function SidebarShells(props) {
   const theme = () => props.api.theme.current;
   const limit = () => Math.max(1, props.store.showAll() ? props.expandedRows ?? 12 : props.rows ?? 5);
@@ -72,6 +72,21 @@ export function SidebarShells(props) {
           _$setProp(_el$9, "wrapMode", "none");
           _$insert(_el$9, () => truncate(shell.title, 20), _el$1);
           _$insert(_el$10, () => shortDetail(shell, props.store.now()));
+          _$insert(_el$9, _$createComponent(Show, {
+            get when() {
+              return watchLabel(shell);
+            },
+            get children() {
+              var _el$11 = _$createElement("span"),
+                _el$12 = _$createTextNode(` `);
+              _$insertNode(_el$11, _el$12);
+              _$insert(_el$11, () => watchLabel(shell), null);
+              _$effect(_$p => _$setProp(_el$11, "style", {
+                fg: watchColor(theme(), shell)
+              }, _$p));
+              return _el$11;
+            }
+          }), null);
           _$effect(_p$ => {
             var _v$3 = theme().text,
               _v$4 = {

package/dist/tui/dialogs.js

@@ -0,0 +1,163 @@
+import { createComponent as _$createComponent } from "@opentui/solid";
+/** @jsxImportSource @opentui/solid */
+
+import { rmSync } from "node:fs";
+import pkg from "../../package.json" with { type: "json" };
+import { cacheDirFor, fetchLatestVersion, isNewer, shouldCheck } from "./lib/update.js";
+import { BADGE_LABEL, displayCommand, kindOf, order } from "./lib/view.js";
+const PACKAGE_NAME = pkg.name;
+
+/** One quiet registry check a day; a newer release is announced once per version. */
+export async function announceUpdate(api, meta, current) {
+  if (meta.source !== "npm") return;
+  const now = Date.now();
+  if (!shouldCheck(api.kv.get("cockpit.update.checkedAt", undefined), now)) return;
+  api.kv.set("cockpit.update.checkedAt", now);
+  const latest = await fetchLatestVersion(PACKAGE_NAME);
+  if (!latest || !isNewer(latest, current)) return;
+  if (api.kv.get("cockpit.update.announced", "") === latest) return;
+  api.kv.set("cockpit.update.announced", latest);
+  api.ui.toast({
+    variant: "info",
+    title: "opencode-cockpit",
+    message: `${latest} is available (you have ${current}). Run /cockpit-update.`,
+    duration: 10_000
+  });
+}
+
+/** Clears this plugin's cache entry so the next OpenCode start installs the newer release. */
+export function offerUpdate(api, meta, current) {
+  const dir = cacheDirFor(meta.target, meta.source);
+  if (!dir) {
+    api.ui.toast({
+      variant: "info",
+      title: "opencode-cockpit",
+      message: meta.source === "file" ? `Running from ${meta.target} — update it with git, not npm.` : "This install is not managed by OpenCode's plugin installer."
+    });
+    return;
+  }
+  void fetchLatestVersion(PACKAGE_NAME).then(latest => {
+    if (latest && !isNewer(latest, current)) {
+      api.ui.toast({
+        variant: "success",
+        title: "opencode-cockpit",
+        message: `${current} is the latest release.`
+      });
+      return;
+    }
+    const DialogConfirm = api.ui.DialogConfirm;
+    api.ui.dialog.replace(() => _$createComponent(DialogConfirm, {
+      title: latest ? `Update to ${latest}?` : "Reinstall this plugin?",
+      message: `Removes the cached copy in ${dir}. OpenCode installs the new version the next time it starts, so restart it afterwards.`,
+      onConfirm: () => {
+        api.ui.dialog.clear();
+        try {
+          rmSync(dir, {
+            recursive: true,
+            force: true
+          });
+          api.ui.toast({
+            variant: "success",
+            title: "opencode-cockpit",
+            message: `Cached ${current} removed — restart OpenCode to install ${latest ?? "the latest release"}.`,
+            duration: 10_000
+          });
+        } catch (err) {
+          api.ui.toast({
+            variant: "error",
+            title: "opencode-cockpit",
+            message: String(err)
+          });
+        }
+      },
+      onCancel: () => api.ui.dialog.clear()
+    }));
+  });
+}
+export function newShell(api, store, open) {
+  const DialogPrompt = api.ui.DialogPrompt;
+  api.ui.dialog.replace(() => _$createComponent(DialogPrompt, {
+    title: "New background shell",
+    placeholder: "npm run dev",
+    onConfirm: value => {
+      const command = value.trim();
+      if (!command) return api.ui.dialog.clear();
+      const shell = process.env.SHELL && /(bash|zsh|fish|sh)$/.test(process.env.SHELL) ? process.env.SHELL : "/bin/bash";
+      store.client.call("shell.start", {
+        command: shell,
+        args: ["-c", command],
+        cwd: store.project(),
+        title: command.slice(0, 60),
+        owner: {
+          project: store.project()
+        },
+        reuse: true
+      }).then(info => {
+        void store.refresh();
+        open(info.id);
+      }).catch(err => {
+        api.ui.dialog.clear();
+        api.ui.toast({
+          variant: "error",
+          title: "Shell",
+          message: err instanceof Error ? err.message : String(err)
+        });
+      });
+    },
+    onCancel: () => api.ui.dialog.clear()
+  }));
+}
+export function restartDaemon(api, store) {
+  const running = store.shells().filter(s => s.status === "running").length;
+  const restart = force => {
+    api.ui.dialog.clear();
+    store.client.restartDaemon({
+      force
+    }).then(ok => {
+      void store.refresh();
+      api.ui.toast({
+        variant: ok ? "success" : "warning",
+        title: "Shells",
+        message: ok ? "Shell daemon restarted" : "Shells are running; restart was not forced"
+      });
+    }).catch(err => api.ui.toast({
+      variant: "error",
+      title: "Shells",
+      message: String(err)
+    }));
+  };
+  if (running === 0) return restart(false);
+  const DialogConfirm = api.ui.DialogConfirm;
+  api.ui.dialog.replace(() => _$createComponent(DialogConfirm, {
+    title: "Restart shell daemon?",
+    message: `${running} running shell${running === 1 ? "" : "s"} will be stopped.`,
+    onConfirm: () => restart(true),
+    onCancel: () => api.ui.dialog.clear()
+  }));
+}
+export function pickShell(api, store, open) {
+  const DialogSelect = api.ui.DialogSelect;
+  const shells = order(store.shells());
+  if (shells.length === 0) {
+    api.ui.toast({
+      variant: "info",
+      title: "Shells",
+      message: "No shells in this project yet"
+    });
+    return;
+  }
+  api.ui.dialog.replace(() => _$createComponent(DialogSelect, {
+    title: "Shells",
+    get current() {
+      return store.selected()?.id;
+    },
+    get options() {
+      return shells.map(s => ({
+        title: s.title,
+        value: s.id,
+        description: `${BADGE_LABEL[kindOf(s)]} · ${displayCommand(s).slice(0, 60)}`
+      }));
+    },
+    onSelect: option => open(option.value)
+  }));
+}

package/dist/tui/index.js

@@ -1,20 +1,27 @@
 import { memo as _$memo } from "@opentui/solid";
 import { createComponent as _$createComponent } from "@opentui/solid";
 /** @jsxImportSource @opentui/solid */
+
 import { createBindingLookup } from "@opencode-ai/plugin/tui";
 import { claimFeature, duplicateFeatureMessage } from "@opencode-cockpit/client";
 import { createSignal } from "solid-js";
+import pkg from "../../package.json" with { type: "json" };
 import { createClient } from "../connect.js";
-import { Console } from "./console.js";
-import { Dock } from "./dock.js";
-import { SidebarShells } from "./sidebar.js";
-import { createShellStore } from "./store.js";
-import { BADGE_LABEL, displayCommand, kindOf, order } from "./view.js";
+import { loadConfig } from "../core/config.js";
+import { Console } from "./components/console.js";
+import { Dock } from "./components/dock.js";
+import { SidebarShells } from "./components/sidebar.js";
+import { announceUpdate, newShell, offerUpdate, pickShell, restartDaemon } from "./dialogs.js";
+import { createShellStore } from "./state/store.js";
 const DEFAULT_KEYS = {
   "cockpit.shells.dock": "<leader>o",
   "cockpit.shells.console": "<leader>i"
 };
+
+/** Interface settings; the `ui` section of the config file (see core/config.ts). */
+
 const SHELL_PACKAGE = "@opencode-cockpit/shell";
+const _PACKAGE_NAME = pkg.name;
 
 /** Shell's TUI half as a factory, so bundles such as `opencode-cockpit` can include it. */
 export function createShellTui({
@@ -36,8 +43,10 @@ export function createShellTui({
     await shellTui(api, rawOptions, meta);
   };
 }
-const shellTui = async (api, rawOptions) => {
-  const options = rawOptions ?? {};
+const shellTui = async (api, rawOptions, meta) => {
+  // Settings come from the shared config file; plugin-entry options still win, flat or under "ui".
+  const config = loadConfig(api.state.path.directory, rawOptions);
+  const options = config.ui ?? {};
   const client = createClient("opencode-cockpit/tui");
   const store = createShellStore(api, client, {
     historyMinutes: options.historyMinutes
@@ -65,6 +74,12 @@ const shellTui = async (api, rawOptions) => {
       api: api,
       store: store,
       typing: typing,
+      get colors() {
+        return options.colors;
+      },
+      get defaultView() {
+        return options.defaultView;
+      },
       onClose: () => api.ui.dialog.clear(),
       onNewShell: () => newShell(api, store, openConsole)
     }), () => {});
@@ -109,6 +124,13 @@ const shellTui = async (api, rawOptions) => {
           message: String(err)
         }));
       }
+    }, {
+      name: "cockpit.shells.update",
+      title: "Update opencode-cockpit",
+      category: "Shells",
+      namespace: "palette",
+      slashName: "cockpit-update",
+      run: () => offerUpdate(api, meta, pkg.version)
     }, {
       name: "cockpit.shells.restartDaemon",
       title: "Restart shell daemon",
@@ -136,6 +158,9 @@ const shellTui = async (api, rawOptions) => {
           get height() {
             return height();
           },
+          get colors() {
+            return options.colors;
+          },
           hint: () => `${shortcut("cockpit.shells.console")} console · ${shortcut("cockpit.shells.dock")} hide`,
           onOpenConsole: id => openConsole(id)
         }) : null);
@@ -154,6 +179,9 @@ const shellTui = async (api, rawOptions) => {
     }
   });
 
+  // OpenCode never re-resolves an installed plugin spec, so check for a newer release ourselves.
+  if (options.updateCheck !== false) void announceUpdate(api, meta, pkg.version);
+
   // A daemon from older plugin code is kept only while it runs shells; say so once.
   const offOutdated = client.onOutdated(info => {
     if (!info) return;
@@ -170,93 +198,6 @@ const shellTui = async (api, rawOptions) => {
     client.close();
   });
 };
-function newShell(api, store, open) {
-  const DialogPrompt = api.ui.DialogPrompt;
-  api.ui.dialog.replace(() => _$createComponent(DialogPrompt, {
-    title: "New background shell",
-    placeholder: "npm run dev",
-    onConfirm: value => {
-      const command = value.trim();
-      if (!command) return api.ui.dialog.clear();
-      const shell = process.env.SHELL && /(bash|zsh|fish|sh)$/.test(process.env.SHELL) ? process.env.SHELL : "/bin/bash";
-      store.client.call("shell.start", {
-        command: shell,
-        args: ["-c", command],
-        cwd: store.project(),
-        title: command.slice(0, 60),
-        owner: {
-          project: store.project()
-        },
-        reuse: true
-      }).then(info => {
-        void store.refresh();
-        open(info.id);
-      }).catch(err => {
-        api.ui.dialog.clear();
-        api.ui.toast({
-          variant: "error",
-          title: "Shell",
-          message: err instanceof Error ? err.message : String(err)
-        });
-      });
-    },
-    onCancel: () => api.ui.dialog.clear()
-  }));
-}
-function restartDaemon(api, store) {
-  const running = store.shells().filter(s => s.status === "running").length;
-  const restart = force => {
-    api.ui.dialog.clear();
-    store.client.restartDaemon({
-      force
-    }).then(ok => {
-      void store.refresh();
-      api.ui.toast({
-        variant: ok ? "success" : "warning",
-        title: "Shells",
-        message: ok ? "Shell daemon restarted" : "Shells are running; restart was not forced"
-      });
-    }).catch(err => api.ui.toast({
-      variant: "error",
-      title: "Shells",
-      message: String(err)
-    }));
-  };
-  if (running === 0) return restart(false);
-  const DialogConfirm = api.ui.DialogConfirm;
-  api.ui.dialog.replace(() => _$createComponent(DialogConfirm, {
-    title: "Restart shell daemon?",
-    message: `${running} running shell${running === 1 ? "" : "s"} will be stopped.`,
-    onConfirm: () => restart(true),
-    onCancel: () => api.ui.dialog.clear()
-  }));
-}
-function pickShell(api, store, open) {
-  const DialogSelect = api.ui.DialogSelect;
-  const shells = order(store.shells());
-  if (shells.length === 0) {
-    api.ui.toast({
-      variant: "info",
-      title: "Shells",
-      message: "No shells in this project yet"
-    });
-    return;
-  }
-  api.ui.dialog.replace(() => _$createComponent(DialogSelect, {
-    title: "Shells",
-    get current() {
-      return store.selected()?.id;
-    },
-    get options() {
-      return shells.map(s => ({
-        title: s.title,
-        value: s.id,
-        description: `${BADGE_LABEL[kindOf(s)]} · ${displayCommand(s).slice(0, 60)}`
-      }));
-    },
-    onSelect: option => open(option.value)
-  }));
-}
 const plugin = {
   id: "opencode-cockpit.shell",
   tui: createShellTui()

package/dist/tui/lib/details.js

@@ -0,0 +1,23 @@
+import { kindOfShell } from "../../core/kind.js";
+import { displayCommand, statusDetail, truncate, wrapText } from "./view.js";
+
+/** Everything known about one shell, for the console's details view. */
+export function detailRows(s, now, cols) {
+  const width = Math.max(10, cols - 11);
+  const rows = [];
+  for (const [i, line] of wrapText(displayCommand(s), width, 12).entries()) rows.push([i === 0 ? "command" : "", line]);
+  rows.push(["kind", kindOfShell(s)]);
+  rows.push(["folder", s.cwd]);
+  rows.push(["status", `${s.status}${s.exitCode !== undefined ? ` (exit ${s.exitCode})` : ""}${s.signal ? ` (${s.signal})` : ""}`]);
+  rows.push(["timing", statusDetail(s, now)]);
+  rows.push(["started", new Date(s.startedAt).toLocaleString()]);
+  if (s.summary) rows.push(["summary", truncate(s.summary, width)]);
+  rows.push(["id", `${s.id} · run ${s.run}${s.pid ? ` · pid ${s.pid}` : ""}`]);
+  rows.push(["owner", s.owner.session ? `agent session ${s.owner.session}` : "you"]);
+  if (s.watch) {
+    rows.push(["watch", `${s.watch.preset ?? "custom rule"} · ${s.watch.status} · ${s.watch.runs} run${s.watch.runs === 1 ? "" : "s"}${s.watch.summary ? ` · ${truncate(s.watch.summary, width - 30)}` : ""}`]);
+  }
+  rows.push(["output", `${s.lines.last} lines · ${Math.round(s.bytes / 1024)} KiB`]);
+  if (s.logFile) rows.push(["log file", s.logFile]);
+  return rows;
+}

package/dist/tui/lib/search.js

@@ -0,0 +1,39 @@
+/** Log search helpers: what matched, and how failures should read. */
+export function splitMatches(text, query) {
+  if (!query) return [{
+    text,
+    match: false
+  }];
+  const parts = [];
+  const haystack = text.toLowerCase();
+  const needle = query.toLowerCase();
+  let from = 0;
+  for (let at = haystack.indexOf(needle, from); at !== -1; at = haystack.indexOf(needle, from)) {
+    if (at > from) parts.push({
+      text: text.slice(from, at),
+      match: false
+    });
+    parts.push({
+      text: text.slice(at, at + needle.length),
+      match: true
+    });
+    from = at + needle.length;
+  }
+  if (from < text.length) parts.push({
+    text: text.slice(from),
+    match: false
+  });
+  return parts.length > 0 ? parts : [{
+    text,
+    match: false
+  }];
+}
+
+/** Daemon errors name ids and internal states; say what happened instead. */
+export function friendlyError(err) {
+  const message = err instanceof Error ? err.message : String(err);
+  if (/is (exited|killed|failed)$/.test(message)) return "the shell is no longer running";
+  if (/not found$/.test(message)) return "that shell was already removed";
+  if (/connection|not running|did not start/.test(message)) return "lost connection to cockpitd, retrying";
+  return message;
+}

package/dist/tui/lib/update.js

@@ -0,0 +1,58 @@
+/**
+ * Update notice.
+ *
+ * OpenCode resolves an unpinned plugin spec (`@latest`) once and then reuses its cached copy, so
+ * an install never moves forward on its own. The plugin therefore checks the registry itself, at
+ * most once a day, and offers to clear its own cache entry so the next start installs the newer
+ * version.
+ */
+
+const DAY_MS = 24 * 60 * 60 * 1000;
+export function shouldCheck(lastCheckedAt, now, everyMs = DAY_MS) {
+  return lastCheckedAt === undefined || now - lastCheckedAt >= everyMs;
+}
+
+/** True when `latest` is a higher release than `current`. Pre-releases never look newer. */
+export function isNewer(latest, current) {
+  const parse = v => {
+    const match = /^(\d+)\.(\d+)\.(\d+)(?:-([\w.]+))?$/.exec(v.trim());
+    return match ? {
+      nums: [Number(match[1]), Number(match[2]), Number(match[3])],
+      pre: match[4]
+    } : undefined;
+  };
+  const a = parse(latest);
+  const b = parse(current);
+  if (!a || !b) return false;
+  for (let i = 0; i < 3; i++) {
+    const diff = a.nums[i] - b.nums[i];
+    if (diff !== 0) return diff > 0;
+  }
+  // Same numbers: a release beats the pre-release of that version, never the other way round.
+  return a.pre === undefined && b.pre !== undefined;
+}
+
+/**
+ * The directory OpenCode installed this plugin into, given the resolved module path. Removing it
+ * makes the next start reinstall from the registry. Undefined for anything but an npm install.
+ */
+export function cacheDirFor(target, source) {
+  if (source !== "npm" || !target) return undefined;
+  const [dir] = target.split(`${"/"}node_modules${"/"}`);
+  return dir && dir !== target ? dir : undefined;
+}
+export async function fetchLatestVersion(pkg, timeoutMs = 3000) {
+  try {
+    const response = await fetch(`https://registry.npmjs.org/${pkg}/latest`, {
+      signal: AbortSignal.timeout(timeoutMs),
+      headers: {
+        accept: "application/vnd.npm.install-v1+json"
+      }
+    });
+    if (!response.ok) return undefined;
+    const body = await response.json();
+    return body.version;
+  } catch {
+    return undefined; // offline, rate limited, private registry: never worth bothering the user
+  }
+}