@epoch-agent/server 0.17.0 → 0.18.0

package/dist/index.d.ts

@@ -1996,6 +1996,16 @@ declare class SessionHub {
      *   而那一行**本来就在列表里**（列表的另一半来自 DB）。列表没变，不该发。
      */
     notifySessionsChanged(sessionId: string): void;
+    /**
+     * 广播「插件那张表变了」（2026-09-24）。语义和「为什么不带 `sessionId`」全在
+     * protocol 的 `plugins-changed` 上。
+     *
+     * 唯一的调用方是 `index.ts` 里那条对 `runtime.plugins.onChange` 的订阅 ——
+     * 同 {@link notifyTasksChanged}，Hub 不认识插件表，它在这条链上只负责发帧。
+     *
+     * ⚠️ **它不发给旁听者**（`observe()` 那一路），判据在 {@link publish} 上。
+     */
+    notifyPluginsChanged(): void;
     /**
      * 收摊：撤掉倒计时、放弃所有挂起的审批、中止所有在跑的回合。
      *
@@ -2929,6 +2939,9 @@ interface PluginEntryView {
     marketplace?: string;
     active: boolean;
     counts?: CountsView;
+    /** 宿主给不给这两枚（2026-09-24）。**runtime 算好的**，这一层原样投影 */
+    updateAllowed: boolean;
+    uninstallAllowed: boolean;
 }
 /** `PluginSearchHit`（runtime）的镜像 */
 interface PluginHitView {
@@ -2972,6 +2985,14 @@ interface PluginHitView {
     };
     sourceType?: WirePluginSourceType;
     installable: boolean;
+    /** 宿主给不给「安装」（2026-09-24）。和 `installable` 是两格，判据在 wire 那一格上 */
+    installAllowed: boolean;
+    /** 卡片菜单（2026-09-24）。runtime 已经收过一遍，`danger` 可缺省 → 这一层补成布尔 */
+    menu: readonly {
+        id: string;
+        label: string;
+        danger?: boolean;
+    }[];
 }
 /** `InstallPreview`（core，经 runtime 原样透出）的镜像 —— 「将安装什么」那一屏的内容 */
 interface PluginPreviewView {
@@ -3212,6 +3233,16 @@ interface PluginControlView {
      * 口径逐字同 {@link uploadEnabled}。
      */
     readonly refreshEnabled: boolean;
+    /**
+     * 「添加」那一枚画不画（2026-09-24）。**runtime 算好的结论**，口径同 {@link uploadEnabled}
+     */
+    readonly localInstallEnabled: boolean;
+    /**
+     * 插件那张表变了就叫一声（2026-09-24）。**这个文件不调它** —— 订阅在 `index.ts`，
+     * 转成一帧 `plugins-changed`（判据在 protocol 那一帧上）。镜像上有它是因为
+     * `ApiContext.runtime.plugins` 就是这份镜像，而那条订阅要从它上面拿。
+     */
+    onChange(listener: () => void): () => void;
     /**
      * 一个压缩包 → 一条已经验过的插件目录路径（2026-09-11，落区那一条）。
      *

package/dist/index.js

@@ -597,6 +597,10 @@ var SessionHub = class {
     if (this.closed) return;
     this.publish(sessionId, { type: "sessions-changed" });
   }
+  notifyPluginsChanged() {
+    if (this.closed) return;
+    this.publish(void 0, { type: "plugins-changed" });
+  }
   shutdown() {
     if (this.closed) return;
     this.closed = true;
@@ -607,10 +611,15 @@ var SessionHub = class {
     this.counted.clear();
   }
   publish(sessionId, event) {
-    const frame = { seq: ++this.seq, sessionId, ts: this.clock(), event };
+    const frame = {
+      seq: ++this.seq,
+      ...sessionId === void 0 ? {} : { sessionId },
+      ts: this.clock(),
+      event
+    };
     this.ring.push(frame);
     for (const sink of this.sinks) sink(frame);
-    for (const sink of this.observers) sink(frame);
+    if (sessionId !== void 0) for (const sink of this.observers) sink(frame);
     return frame;
   }
   connectionFrame(event) {
@@ -2745,7 +2754,9 @@ function toWirePluginEntry(entry, displayNames) {
     installedAt: entry.installedAt,
     marketplace: entry.marketplace ?? null,
     active: entry.active,
-    counts: entry.counts ? toWireCounts(entry.counts) : null
+    counts: entry.counts ? toWireCounts(entry.counts) : null,
+    updateAllowed: entry.updateAllowed,
+    uninstallAllowed: entry.uninstallAllowed
   };
 }
 function toWirePluginHit(hit, installed) {
@@ -2771,7 +2782,14 @@ function toWirePluginHit(hit, installed) {
     homepage: hit.entry.homepage ?? null,
     visibility: hit.entry.visibility ?? null,
     status: hit.entry.status ?? null,
-    updateAvailable: mine !== void 0 && !mine.linked && hit.entry.version !== void 0 && hit.entry.version !== mine.version
+    updateAvailable: mine !== void 0 && !mine.linked && hit.entry.version !== void 0 && hit.entry.version !== mine.version,
+    installAllowed: hit.installAllowed,
+    updateAllowed: mine?.updateAllowed ?? false,
+    menu: hit.menu.map((item) => ({
+      id: item.id,
+      label: item.label,
+      danger: item.danger === true
+    }))
   };
 }
 function toWireMarketplace(market) {
@@ -2856,7 +2874,10 @@ function listPlugins(ctx, res, lang) {
 function pluginsPayload(control) {
   const installed = control.list();
   const installedMap = new Map(
-    installed.map((p) => [p.name, { version: p.version, linked: p.linked }])
+    installed.map((p) => [
+      p.name,
+      { version: p.version, linked: p.linked, updateAllowed: p.updateAllowed }
+    ])
   );
   const shown = displayNamesOf(control);
   return {
@@ -2866,7 +2887,8 @@ function pluginsPayload(control) {
     pendingRestart: control.pendingRestart,
     uploadEnabled: control.uploadEnabled,
     uploadOptions: control.uploadOptions,
-    refreshEnabled: control.refreshEnabled
+    refreshEnabled: control.refreshEnabled,
+    localInstallEnabled: control.localInstallEnabled
   };
 }
 function sendPreview(res, outcome) {
@@ -5270,6 +5292,7 @@ async function createWebServer(opts) {
   const unsubscribeTasks = observeBackgroundTasks((sessionId) => {
     hub.notifyTasksChanged(sessionId);
   });
+  const unsubscribePlugins = opts.runtime.plugins?.onChange(() => hub.notifyPluginsChanged()) ?? (() => void 0);
   let handle = null;
   const server = createServer((req, res) => {
     if (handle) return handle(req, res);
@@ -5280,6 +5303,7 @@ async function createWebServer(opts) {
   const listened = await listen(server, binding.host, binding.port);
   if (!listened.ok) {
     unsubscribeTasks();
+    unsubscribePlugins();
     return listened;
   }
   handle = buildHandler(opts, hub, binding, listened.port, webRoot);
@@ -5293,7 +5317,7 @@ async function createWebServer(opts) {
       ...webRoot === void 0 ? {} : { webRoot },
       observe: (sink, opts2) => hub.observe(sink, opts2 ?? {}),
       snapshot: () => hub.listSessions(),
-      close: makeCloser(server, hub, opts.runtime, unsubscribeTasks)
+      close: makeCloser(server, hub, opts.runtime, unsubscribeTasks, unsubscribePlugins)
     }
   };
 }
@@ -5345,11 +5369,12 @@ function describeListenError(err, host, port) {
   }
   return t("web.listen_failed", { host, port, reason: err.message }, void 0);
 }
-function makeCloser(server, hub, runtime, unsubscribeTasks) {
+function makeCloser(server, hub, runtime, unsubscribeTasks, unsubscribePlugins) {
   let closing = null;
   return () => {
     closing ??= (async () => {
       unsubscribeTasks();
+      unsubscribePlugins();
       hub.shutdown();
       server.closeAllConnections();
       await new Promise((resolve4) => server.close(() => resolve4()));