@nelsonlongxiang/dsh-open-a2a-net 0.5.13 → 0.5.15

package/README.md

@@ -1,5 +1,9 @@
 # @nelsonlongxiang/dsh-open-a2a-net
 
+English | [中文](README_zh.md)
+
+[![npm](https://img.shields.io/npm/v/@nelsonlongxiang/dsh-open-a2a-net?label=npm)](https://www.npmjs.com/package/@nelsonlongxiang/dsh-open-a2a-net)
+
 Open A2A network plugin for [DeepSeek Harness](https://github.com/deepseek-ai/deepseek-harness) (DSH): turns a DSH
 deployment into one node of a decentralized agent network — no central server, no registry.
 
@@ -16,14 +20,16 @@ node** other hosts can discover and join from the web sidebar.
 ## Install
 
 ```sh
-npx -p @deepseek-ai/dsh dsh plugin --profile <name> add @nelsonlongxiang/dsh-open-a2a-net
+dsh plugin --profile web add @nelsonlongxiang/dsh-open-a2a-net
 ```
 
+Restart `dsh web`, then open the sidebar network panel (footer action).
+
 (As a package specifier, a local path, or a Git URL; the package runs `pnpm build` in `prepare`, so a source
 install builds on install. Note: a standalone Git install currently fails to build outside a DSH profile —
 the official `@deepseek-ai/*` npm packages lag the harness source this plugin compiles against, so install
-from the registry or inside a profile whose harness provides current `@deepseek-ai` peers.) Then restart the
-profile. The plugin composes beside the stock
+from the registry or inside a profile whose harness provides current `@deepseek-ai` peers.) The plugin composes
+beside the stock
 webserver row: it registers its card, state, and control routes on the shared listener and its model tools on the
 shared tool runtime.
 

package/README_zh.md

@@ -2,6 +2,8 @@
 
 [English](README.md) | 中文
 
+[![npm](https://img.shields.io/npm/v/@nelsonlongxiang/dsh-open-a2a-net?label=npm)](https://www.npmjs.com/package/@nelsonlongxiang/dsh-open-a2a-net)
+
 面向 [DeepSeek Harness](https://github.com/deepseek-ai/deepseek-harness)（DSH）的开放 A2A 网络插件：把一个 DSH 部署变成去中心化 agent 网络中的一个节点——没有中心服务器，没有注册中心。
 
 每个节点在 `/.well-known/agent-card.json` 发布**带签名、会过期**的 agent 卡片，通过**种子 URL 与相互引荐**发现 peers（每张卡片列出它认识的节点），通过**区域委托**解析名字（GNUnet GNS 风格：卡片可把一个名字委托给另一个 zone），并**直连**路由到 peer 的团队、在可达半数候选间故障切换。每个主会话还可以作为**会话节点**暴露，供其他宿主从 Web 侧栏发现并加入。
@@ -13,10 +15,12 @@
 ## 安装
 
 ```sh
-npx -p @deepseek-ai/dsh dsh plugin --profile <name> add @nelsonlongxiang/dsh-open-a2a-net
+dsh plugin --profile web add @nelsonlongxiang/dsh-open-a2a-net
 ```
 
-（支持包名、本地路径或 Git URL；包内 `prepare` 会在安装时执行 `pnpm build`。注意：脱离 DSH profile 的独立 Git 安装目前无法构建——官方 `@deepseek-ai/*` npm 快照落后于本插件编译所对照的 harness 源码，请从 registry 安装，或在由 harness 提供当前 `@deepseek-ai` peers 的 profile 内安装。）然后重启 profile。插件组合在标准 webserver 行旁边：在共享监听器上注册卡片、状态与控制路由，在共享工具运行时上注册模型工具。
+重启 `dsh web`，打开侧栏网络面板（底部入口）。
+
+（支持包名、本地路径或 Git URL；包内 `prepare` 会在安装时执行 `pnpm build`。注意：脱离 DSH profile 的独立 Git 安装目前无法构建——官方 `@deepseek-ai/*` npm 快照落后于本插件编译所对照的 harness 源码，请从 registry 安装，或在由 harness 提供当前 `@deepseek-ai` peers 的 profile 内安装。）插件组合在标准 webserver 行旁边：在共享监听器上注册卡片、状态与控制路由，在共享工具运行时上注册模型工具。
 
 ## 你能得到什么
 

package/lib/index.js

@@ -38,6 +38,7 @@ export const Config = s.object({
     dshHome: s.string().default(''),
     sessionNodes: s.boolean().default(true),
     wakeJoinedOnBoot: s.boolean().default(false),
+    wakeBootStaggerMs: s.number().default(3_000),
     cardTtlMs: s.number().default(172_800_000),
     flushTimeoutMs: s.number().default(300_000),
     routeTimeoutMs: s.number().default(1_800_000),
@@ -464,13 +465,31 @@ export function apply(ctx, config) {
                     logger.warn('wakeJoinedOnBoot is on but no api gateway is composed; cold joined sessions stay asleep');
                     return;
                 }
+                // Serial with a configurable pause: one full log replay at a time
+                // keeps the decode from saturating the event loop (concurrent wakes
+                // of several huge logs stalled every request for tens of seconds).
+                // The first wake starts immediately; the re-check drops ids another
+                // path (wake-on-route, a manual open) already materialized.
+                let bootWakeChain = Promise.resolve();
+                let firstBootWake = true;
                 for (const id of joinedSessions.list()) {
                     if (liveRoots.has(id))
                         continue;
                     // The remount listener joins the node the moment the woken agent
                     // publishes; a failed wake keeps the cold row and its intent.
-                    materialize(id)?.catch((error) => {
-                        logger.warn(`boot wake of ${id} failed: ${String(error)}`);
+                    const pauseMs = firstBootWake ? 0 : config.wakeBootStaggerMs;
+                    firstBootWake = false;
+                    bootWakeChain = bootWakeChain.then(async () => {
+                        if (pauseMs > 0)
+                            await new Promise(resolve => setTimeout(resolve, pauseMs));
+                        if (liveRoots.has(id))
+                            return;
+                        try {
+                            await materialize(id);
+                        }
+                        catch (error) {
+                            logger.warn(`boot wake of ${id} failed: ${String(error)}`);
+                        }
                     });
                 }
             };

package/lib/types/index.d.ts

@@ -89,6 +89,15 @@ export interface Config {
      * the sidebar's wake button remain available).
      */
     readonly wakeJoinedOnBoot: boolean;
+    /**
+     * Pause between consecutive boot wakes. Each wake replays a full session
+     * log — the zstd decode yields the event loop only every 500ms — so
+     * unbounded concurrent wakes of several huge logs starve every request
+     * for tens of seconds after a restart. The serial queue with this pause
+     * keeps the preheat while capping decode saturation: the first wake
+     * starts immediately, and wake-on-route never waits on this queue.
+     */
+    readonly wakeBootStaggerMs: number;
     /**
      * `final` reply budget: how long an inbound direct route waits for the
      * session's next assistant message before answering with a timeout

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@nelsonlongxiang/dsh-open-a2a-net",
-  "version": "0.5.13",
+  "version": "0.5.15",
   "description": "Open A2A network plugin for DeepSeek Harness: signed agent cards, decentralized peer/zone discovery, direct routing model tools, and joinable session nodes with a sidebar control",
   "type": "module",
   "main": "lib/index.js",