@sleep2agi/agent-network 2.3.0-preview.67 → 2.3.0-preview.69

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

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

package/dist/src/stale-socket.d.ts

@@ -0,0 +1,118 @@
+export interface StaleSocketProbes {
+    /** 读 /proc/net/unix 全文;读不到就 throw(调用方按 fail-closed 处理)。 */
+    procNetUnix(): string;
+    /** 路径不存在返回 null。 */
+    lstat(path: string): {
+        dev: number;
+        ino: number;
+        uid: number;
+        isSocket: boolean;
+    } | null;
+    unlink(path: string): void;
+    /** 当前进程 uid —— 只回收自己拥有的 socket。 */
+    currentUid(): number;
+}
+export interface ReapScope {
+    /**
+     * 只允许回收这个目录**之下**的路径。
+     * 🔴 这一格防的不是文件系统竞态,是**被污染的 identity**:socket 路径来自
+     *    profile,如果 profile 被写坏成 `/run/systemd/private` 之类,前面所有
+     *    "无监听者"检查都会照常通过,然后 unlink 掉一个不属于这个节点的东西。
+     *    删除不可逆,所以范围校验必须在**所有**其它检查之前。
+     */
+    allowedRoot: string;
+}
+export type ReapOutcome = 
+/** 路径已经不在了 —— 正常的成功拆卸,无事可做。 */
+{
+    kind: "absent";
+}
+/** 确认无人引用,已删除。 */
+ | {
+    kind: "removed";
+}
+/** /proc/net/unix 里仍能找到这个路径 ⇒ 有人在用,**不删**,调用方应判红。 */
+ | {
+    kind: "in-use";
+}
+/** /proc/net/unix 读不到 ⇒ fail-closed,不删。 */
+ | {
+    kind: "unreadable";
+    detail: string;
+}
+/** 检查与删除之间文件身份变了(dev/ino/uid),或已不是 socket ⇒ 不删。 */
+ | {
+    kind: "changed";
+}
+/** 路径不在该节点自己的 runtime 目录之下 ⇒ 一律不删。 */
+ | {
+    kind: "out-of-scope";
+    detail: string;
+};
+/**
+ * `/proc/net/unix` 的每一行以路径结尾(没有绑定路径的行就没有这一列)。
+ * 这里只问「这个路径出现过没有」,不解释 flags/type/state。
+ */
+export declare function unixSocketPathInUse(procNetUnix: string, path: string): boolean;
+/**
+ * 属主进程**已被证明消失之后**,回收一个陈旧的 socket 路径名。
+ * 任何一种不确定都不删 —— 删文件不可逆,而留下一个 socket 只是让 stop 判红,
+ * 那正是本函数之前的行为。
+ */
+export declare function reapStaleSocket(path: string, probes: StaleSocketProbes, scope: ReapScope): ReapOutcome;
+/**
+ * 从「本次 stop 看到的残留路径」里挑出**允许回收**的那些。
+ *
+ * 🔴 判据是「与重新算出来的规范路径**完全相等**」,不是前缀、不是包含。
+ *    profile 里存的 socket 路径是**被写坏就会跟着坏**的数据;
+ *    grokCopresenceSocketPaths 是纯函数,同样的 nodeId + home 永远算出同一个值。
+ *    所以这里不问「这条路径看起来对不对」,只问「它是不是我自己算出来的那两个之一」。
+ *    ——一个被污染的 profile 因此一条都带不进来。
+ */
+export declare function planReapableSockets(canonical: {
+    leaderSocket: string;
+    attachSocket: string;
+}, residualPaths: readonly (string | undefined)[]): string[];
+export interface CanonicalSocketProfile {
+    node_id?: string;
+    grokLeaderSocket?: string;
+    grokAttachSocket?: string;
+}
+export type CanonicalSocketsOutcome = {
+    kind: "ok";
+    leaderSocket: string;
+    attachSocket: string;
+}
+/** profile 里没有 node_id —— 算不出来,不动手。 */
+ | {
+    kind: "no-node-id";
+}
+/** 重新算出来的与 profile 存的不一致 —— profile 被写坏、HOME 变了、或**调用方喂错了 id**。 */
+ | {
+    kind: "mismatch";
+    recomputedLeader: string;
+    storedLeader: string;
+}
+/** 路径算不出来(grokCopresenceSocketPaths 抛错)—— 不动手,但也不该把 stop 整个弄失败。 */
+ | {
+    kind: "uncomputable";
+    detail: string;
+};
+/**
+ * 从 profile 推出规范 socket 路径,并**与 profile 里存的那份交叉校验**。
+ *
+ * 🔴 这个交叉校验是一次真实缺陷催生的,不是补全性写的:
+ *    我第一版在 cli.ts 里写的是 `grokCopresenceSocketPaths(resolved.id)`,而
+ *    `resolveNodeRef` 返回的 `id` 是**目录名(别名)**,socket 路径却是
+ *    `anet node create` 用 **node_id** 算的。两者哈希不同 ⇒ 算出的路径永远对不上 ⇒
+ *    可回收集合恒为空 ⇒ **一条都回收不了,而且完全静默**(循环体一次都不进)。
+ *    12 轮验收里 4 次红、0 次回收,红话与修复前逐字相同 —— 从外面看,
+ *    「守卫拒绝了一切」和「这个修复不存在」是同一个样子。
+ *
+ *    所以判据不能只是「算一个路径出来」,必须是「算出来的和存着的对得上」。
+ *    对不上就说出来,别静默跳过。
+ */
+export declare function canonicalSocketsForProfile(profile: CanonicalSocketProfile, compute: (nodeId: string) => {
+    leaderSocket: string;
+    attachSocket: string;
+}): CanonicalSocketsOutcome;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@sleep2agi/agent-network",
-  "version": "2.3.0-preview.67",
+  "version": "2.3.0-preview.69",
   "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",