@sleep2agi/agent-network 2.3.0-preview.155 → 2.3.0-preview.157

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

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

package/dist/src/posix-codex-copresence.d.ts

@@ -15,8 +15,6 @@ export declare function probePosixOwnedLoopbackConnection(rootPid: number, port:
  * 每 intervalMs 探一次,直到:探到(connected)/ TUI 退了(tui-exited,不再白等)/ 到点(deadline)。
  * 判据本身不变:仍是 probePosixOwnedLoopbackConnection 的 fail-closed 归属,只是不再只给一次机会。
  */
-/** 与 Windows 路径的 TUI_HEALTH_MS 同一个预算(cli.ts):TUI 活着却 25 s 都没连上,才判失败。 */
-export declare const POSIX_TUI_ATTRIBUTION_MS = 25000;
 export type PosixAttributionResult = {
     outcome: "connected" | "tui-exited" | "deadline";
     probes: number;

package/dist/src/shared/reserved-env.d.ts

@@ -0,0 +1,3 @@
+export declare const RESERVED_ENV_KEYS_EXACT: Set<string>;
+export declare const RESERVED_ENV_PREFIXES: ReadonlyArray<string>;
+export declare function isReservedEnvKey(k: string): boolean;

package/dist/src/start-resource-gate.d.ts

@@ -0,0 +1,146 @@
+export declare const START_GATE_DEFAULT_MIN_MEM_MB = 4096;
+export declare const START_GATE_DEFAULT_MEM_FRACTION = 0.15;
+export declare const START_GATE_DEFAULT_MAX_LOAD_PER_CPU = 4;
+export declare const START_GATE_DEFAULT_MAX_WAIT_SEC = 600;
+export declare const START_GATE_DEFAULT_MAX_CONCURRENT = 2;
+export declare const START_GATE_SINGLE_LANE_CONCURRENT = 1;
+export declare const START_GATE_RECHECK_MS = 15000;
+/** Jitter added to each re-check while still inside the max wait: uniform [0, RECHECK_JITTER_MS). */
+export declare const START_GATE_RECHECK_JITTER_MS = 5000;
+export declare const START_GATE_WAITING_MEMORY_STATUS = "\u7B49\u5F85\u5185\u5B58";
+export declare const START_GATE_WAITING_LOAD_STATUS = "\u7B49\u5F85\u8D1F\u8F7D";
+export declare const START_GATE_WAITING_BOTH_STATUS = "\u7B49\u5F85\u5185\u5B58\u548C\u8D1F\u8F7D";
+export declare const START_GATE_WAITING_PROBE_STATUS = "\u7B49\u5F85\u8D44\u6E90\u63A2\u6D4B";
+/** #686 compatibility alias for callers that used the original memory-only status. */
+export declare const START_GATE_WAITING_STATUS = "\u7B49\u5F85\u5185\u5B58";
+export declare const START_GATE_SINGLE_LANE_STATUS = "\u5DF2\u8D85\u65F6\uFF0C\u6309\u5355\u8DEF\u653E\u884C";
+/** Logged when one waiter atomically replaces a stuck lease. The wait cap must not admit without this. */
+export declare const START_GATE_TAKEOVER_STATUS = "\u63A5\u7BA1\u5361\u6B7B\u79DF\u7EA6";
+/** Startup leases older than this are not live. ANET_START_LEASE_TTL_SEC overrides it. */
+export declare const START_GATE_LEASE_TTL_MS: number;
+/** A healthy holder renews well before the default lease expiry. */
+export declare const START_GATE_LEASE_HEARTBEAT_MS = 30000;
+/** An empty or unreadable lock younger than this is still being published, not dead. */
+export declare const START_GATE_LOCK_STALE_MS = 30000;
+/**
+ * A live matching lock is an orphan when the monotonic timestamp stored in
+ * the lock is older than this. Legacy locks with no stamp still use wall
+ * mtime, which a clock step can age out. The critical section only renames
+ * and writes a few files, so a live holder past this window is stuck.
+ */
+export declare const START_GATE_LOCK_ORPHAN_MS = 60000;
+export interface StartGateDeps {
+    env?: NodeJS.ProcessEnv;
+    platform?: string;
+    /** Returns file contents, or null when unreadable. */
+    readFile?: (path: string) => string | null;
+    cpuCount?: () => number;
+    sleep?: (ms: number) => Promise<void>;
+    now?: () => number;
+    random?: () => number;
+    log?: (msg: string) => void;
+    warn?: (msg: string) => void;
+    /** Hub/task text. Errors are swallowed so a report failure cannot block a start. */
+    report?: (text: string) => void;
+    /** Host lease directory. Tests must inject this; the default is ~/.anet/run/start-slots. */
+    slotsDir?: string;
+    /** Lease key. Alias is not unique across workspaces; pass the node id. */
+    nodeId?: string;
+    /** Pid written into the lease. Default: this process. */
+    holderPid?: number;
+    /** ESRCH = dead, EPERM = alive. Injected so tests never signal a real pid. */
+    isPidAlive?: (pid: number) => boolean;
+    /** /proc/<pid>/stat field 22. null means unknown — do not treat that as a mismatch. */
+    readProcessStartTicks?: (pid: number) => string | null;
+    /** Override the 15s re-check. With jitterMs 0 the single-lane retry uses this as-is. */
+    recheckMs?: number;
+    /** Override the 0–5s jitter span. 0 keeps the sleep exactly recheckMs. */
+    jitterMs?: number;
+    /** Lease lifetime. Default 10 minutes, or ANET_START_LEASE_TTL_SEC. */
+    leaseTtlMs?: number;
+    /** @internal deterministic short-TTL seam. Defaults to min(30s, TTL/3). */
+    leaseHeartbeatMs?: number;
+    /** Empty/unreadable locks younger than this are held, not dead. */
+    lockStaleMs?: number;
+    /** A live matching lock older than this is an orphan. Default 60s. */
+    lockOrphanMs?: number;
+    /**
+     * Monotonic milliseconds shared by every process on this host.
+     * Default reads /proc/uptime. null means unknown: a stamped lock is kept.
+     */
+    monotonicNow?: () => number | null;
+}
+export type StartGateOutcome = "disabled" | "unsupported" | "ok" | "waited" | "single-lane";
+export interface StartGateResult {
+    outcome: StartGateOutcome;
+    waitedMs: number;
+    checks: number;
+    /** Always callable and idempotent. Drops the lease only if this call created it. */
+    release: () => void;
+}
+export interface HostSample {
+    /** Effective free MiB: min(MemAvailable, cgroup free) when a real cgroup limit exists. */
+    memAvailableMb: number;
+    /** /proc MemAvailable, before the cgroup min. */
+    procAvailableMb: number;
+    /** Cgroup free MiB, or null when there is no real limit. */
+    cgroupFreeMb: number | null;
+    /** Cgroup limit MiB, or null when there is no real limit. The floor uses this, not the host alone. */
+    cgroupLimitMb: number | null;
+    /** 0 when MemTotal could not be read (the floor then falls back to 4096). */
+    memTotalMb: number;
+    load1: number;
+    cpuCount: number;
+}
+export interface StartGateStatusSnapshot {
+    status: string;
+    task?: string;
+}
+/** True only for blocked text owned by this gate, including single-lane wait. */
+export declare function isStartGateBlockedStatus(task: string | undefined): boolean;
+/**
+ * Once admission returns, restore the pre-gate status only if the live status
+ * is still ours. A concurrent task/status update must win over stale restore.
+ */
+export declare function startGateStatusToRestore(live: StartGateStatusSnapshot, previous: StartGateStatusSnapshot): StartGateStatusSnapshot | null;
+/** MemAvailable in MiB from /proc/meminfo text, or null. */
+export declare function parseMemAvailableMb(meminfo: string): number | null;
+/** MemTotal in MiB from /proc/meminfo text, or null. */
+export declare function parseMemTotalMb(meminfo: string): number | null;
+/** 1-minute load average from /proc/loadavg text, or null. */
+export declare function parseLoad1(loadavg: string): number | null;
+/**
+ * Field 22 of /proc/<pid>/stat (starttime, clock ticks since boot).
+ * The comm field is in parentheses and may contain spaces; everything after the
+ * last ")" is field 3 onward, so field 22 is index 19 of that tail.
+ */
+export declare function parseProcStartTicks(statText: string): string | null;
+/**
+ * Default free-memory floor. A fixed 4 GiB is too high for a small machine
+ * or a small container, so the floor is min(4 GiB, 15% of the effective total).
+ * The effective total is min(MemTotal, cgroup limit) when a real cgroup limit
+ * exists — a container must not be judged against the host's MemTotal.
+ * Missing/invalid numbers fall back to 4 GiB. ANET_START_MIN_MEM_MB replaces
+ * this when set.
+ */
+export declare function defaultStartMinMemMb(memTotalMb: number, cgroupLimitMb?: number | null): number;
+/** Reasons the host is too busy to start, empty when it is fine. */
+export declare function startGateReasons(s: HostSample, minMemMb: number, maxLoadPerCpu: number): string[];
+/** User-facing blocked status. Keep this structured instead of parsing the diagnostic reasons. */
+export declare function startGateWaitingStatus(s: HostSample | null, minMemMb: number, maxLoadPerCpu: number): string | null;
+/**
+ * Free MiB inside a real cgroup limit, or null when the limit is missing/unlimited.
+ * `memory.current` counts page cache; inactive_file (v1: total_inactive_file) is subtracted.
+ * statText null keeps the old arithmetic so existing fixtures stay valid.
+ */
+export declare function cgroupFreeMb(maxText: string, currentText: string, memTotalMb: number, statText?: string | null, v1?: boolean): number | null;
+/** Real cgroup limit in MiB, or null when the limit is missing/unlimited. */
+export declare function cgroupLimitMb(maxText: string, memTotalMb: number): number | null;
+/**
+ * Block until this host may start one heavy process.
+ * Returns a release() the caller must invoke once that process is up or has failed.
+ * Never throws (except when the injected sleep rejects — tests use that to stop a wait).
+ */
+export declare function waitForStartResources(label: string, deps?: StartGateDeps): Promise<StartGateResult>;
+/** Run `fn` while holding one start lease. Release runs on success and on failure. */
+export declare function withHeavyStartAdmission<T>(label: string, deps: StartGateDeps, fn: () => Promise<T>): Promise<T>;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@sleep2agi/agent-network",
-  "version": "2.3.0-preview.155",
+  "version": "2.3.0-preview.157",
   "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",
@@ -72,12 +72,14 @@
     "@inquirer/prompts": "^8.4.3",
     "@larksuiteoapi/node-sdk": "^1.42.0",
     "markdown-it": "^14.1.0",
-    "puppeteer-core": "^24.10.2"
+    "puppeteer-core": "^24.10.2",
+    "ws": "^8.22.0"
   },
   "devDependencies": {
     "@modelcontextprotocol/sdk": "1.32.0",
     "@types/markdown-it": "^14.1.2",
     "@types/node": "^25.0.0",
+    "@types/ws": "^8.18.2",
     "javascript-obfuscator": "^5.4.1",
     "node-pty": "^1.1.0",
     "typescript": "^5.0.0"