@sleep2agi/agent-network 2.3.0-preview.62 → 2.3.0-preview.64

package/dist/src/opencode-agent-node-pair.d.ts

@@ -1,9 +1,9 @@
-export declare const PAIRED_AGENT_NETWORK_VERSION = "2.3.0-preview.62";
-export declare const PAIRED_AGENT_NODE_VERSION = "2.5.0-preview.48";
-export declare const PAIRED_AGENT_NODE_SPEC = "@sleep2agi/agent-node@2.5.0-preview.48";
-export declare const OPENCODE_AGENT_NETWORK_VERSION = "2.3.0-preview.62";
-export declare const OPENCODE_AGENT_NODE_VERSION = "2.5.0-preview.48";
-export declare const OPENCODE_AGENT_NODE_SPEC = "@sleep2agi/agent-node@2.5.0-preview.48";
+export declare const PAIRED_AGENT_NETWORK_VERSION = "2.3.0-preview.64";
+export declare const PAIRED_AGENT_NODE_VERSION = "2.5.0-preview.49";
+export declare const PAIRED_AGENT_NODE_SPEC = "@sleep2agi/agent-node@2.5.0-preview.49";
+export declare const OPENCODE_AGENT_NETWORK_VERSION = "2.3.0-preview.64";
+export declare const OPENCODE_AGENT_NODE_VERSION = "2.5.0-preview.49";
+export declare const OPENCODE_AGENT_NODE_SPEC = "@sleep2agi/agent-node@2.5.0-preview.49";
 export type PairedAgentNodeResolution = {
     spec: string;
     args: string[];

package/dist/src/owned-roots.d.ts

@@ -4,19 +4,36 @@ export interface OwnedRoot {
     birth: string;
     role: OwnedRootRole;
 }
+/** 🔴 #1438 — 发现阶段(`ps`)与后续 `/proc/<pid>/stat` 读之间,pid 可能被回收。
+ *  为让 resolveOwnedRoots 能识别「pid 相同、进程不同」,发现阶段必须在
+ *  **同一次 `ps` 快照**里同时取 pid 与一个稳定的启动时刻签名(lstart),
+ *  并把这个签名一路带进来做比对。同一次 ps 内的 pid 与 lstart 无 TOCTOU。 */
+export interface OwnedRootCandidate {
+    pid: number;
+    /** 发现时刻的 `ps -o lstart=` 字符串(24 字符定宽),用于识别 pid 回收。 */
+    discoveredBirth: string;
+}
 export interface OwnedRootProbes {
-    /** 进程这一代的出生时刻;读不到返回 null(可能已退出,也可能无权限)。 */
+    /** 进程这一代的出生时刻(以「存储格式」返回,通常是 /proc/stat starttime jiffies);
+     *  读不到返回 null(可能已退出,也可能无权限)。用于写进 lifecycle 记录。 */
     birth(pid: number): string | null;
-    /** 🔴 只有**确证**进程不存在时返回 false。无权限等一律视为存在。 */
+    /** 🔴 只有**确证**进程不存在时返回 true。无权限等一律视为存在。 */
     vanished(pid: number): boolean;
+    /** 🔴 #1438 — 返回**当前**pid 的 lstart 签名,和发现阶段同格式。
+     *  用来识别 pid 回收:发现时是 A、现在读回来是 B ⇒ pid 已被复用。
+     *  读不到返回 null(进程已退出,或读 ps 失败)。 */
+    currentBirthSignature(pid: number): string | null;
 }
-/** 把 `ps` 发现的 pid 列表冻结成 owned roots。
+/** 把 `ps` 发现的 (pid, birth) 候选冻结成 owned roots。
  *
- * · 读得到 birth              ⇒ 收下
- * · 读不到、且**确证已消失**  ⇒ 跳过(stop 想要的结果,不是错误)
- * · 读不到、进程仍在          ⇒ throw(权限等真问题,不放过)
+ * · currentBirthSignature 与 discoveredBirth **相等** ⇒ 同一代,收下
+ * · currentBirthSignature 与 discoveredBirth **不等** ⇒ 🔴 #1438 pid 已被复用,
+ *     现在这个 pid 属于另一个进程 B。**跳过**(而不是收下 B 当我们的节点):
+ *     stop 的目的是让 A 没了;B 是无关进程,不能因为它恰好占了 A 的 pid 就被杀。
+ * · currentBirthSignature 为 null、**确证已消失**   ⇒ 跳过(stop 想要的结果)
+ * · currentBirthSignature 为 null、进程仍在        ⇒ throw(权限等真问题)
  */
-export declare function resolveOwnedRoots(pids: number[], probes: OwnedRootProbes): OwnedRoot[];
+export declare function resolveOwnedRoots(candidates: OwnedRootCandidate[], probes: OwnedRootProbes): OwnedRoot[];
 /** 🔴 正向判定「进程确实没了」,而不是「读失败就假设没了」。
  *
  * `kill(pid, 0)` 不送信号,只做存在性与权限探测:
@@ -25,3 +42,17 @@ export declare function resolveOwnedRoots(pids: number[], probes: OwnedRootProbe
  *   · 其他   ⇒ 保守当作存在(判据只在**确证**时放行)
  */
 export declare function processVanished(pid: number, kill?: (p: number, s: number) => void): boolean;
+/** 🔴 #1458 — kill 前的 pid 回收保护:发现阶段捕获的 discoveredBirth 与
+ *  **当前**probeCurrentSignature(pid) 相等 ⇒ 同一代,可以信号。
+ *
+ *  · currentSig === discoveredBirth ⇒ true(同代,可 kill)
+ *  · currentSig !== discoveredBirth ⇒ false(pid 被回收,现在这个 pid 是另一
+ *    个进程 B。**不要 kill** —— B 与我们要 stop 的 agent 无关)
+ *  · currentSig === null            ⇒ false(pid 已消失或读不到;caller 判
+ *    是消失就该 skip,权限问题应额外处理但不该 kill 未知对象)
+ *
+ *  与 resolveOwnedRoots 内嵌的同款比较**在语义上一致**,但在**时间点上不同**:
+ *    resolveOwnedRoots 用于「冻结」时刻(装进 lifecycle owner)
+ *    isSameIncarnation 用于「发信号」前那一瞬(rename 的 kill 循环)
+ *  两个时刻中间可能又有窗口,所以这个检查要**离 process.kill 越近越好**。 */
+export declare function isSameIncarnation(pid: number, discoveredBirth: string, probeCurrentSignature: (pid: number) => string | null): boolean;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@sleep2agi/agent-network",
-  "version": "2.3.0-preview.62",
+  "version": "2.3.0-preview.64",
   "description": "AI Agent Network CLI — Local-first multi-agent orchestration across 6 runtimes (Claude Code CLI / Claude Agent SDK / Codex SDK / Codex app-server / Grok Build ACP / OpenCode CLI) and 8+ LLM providers. Apache 2.0.",
   "type": "module",
   "main": "dist/src/client.js",