@poolzin/pool-bot 2026.2.21 → 2026.2.22

package/dist/infra/poolbot-root.js

@@ -27,11 +27,13 @@ async function findPackageRoot(startDir, maxDepth = 12) {
     let current = path.resolve(startDir);
     for (let i = 0; i < maxDepth; i += 1) {
         const name = await readPackageName(current);
-        if (name && CORE_PACKAGE_NAMES.has(name))
+        if (name && CORE_PACKAGE_NAMES.has(name)) {
             return current;
+        }
         const parent = path.dirname(current);
-        if (parent === current)
+        if (parent === current) {
             break;
+        }
         current = parent;
     }
     return null;
@@ -40,11 +42,13 @@ function findPackageRootSync(startDir, maxDepth = 12) {
     let current = path.resolve(startDir);
     for (let i = 0; i < maxDepth; i += 1) {
         const name = readPackageNameSync(current);
-        if (name && CORE_PACKAGE_NAMES.has(name))
+        if (name && CORE_PACKAGE_NAMES.has(name)) {
             return current;
+        }
         const parent = path.dirname(current);
-        if (parent === current)
+        if (parent === current) {
             break;
+        }
         current = parent;
     }
     return null;
@@ -52,6 +56,17 @@ function findPackageRootSync(startDir, maxDepth = 12) {
 function candidateDirsFromArgv1(argv1) {
     const normalized = path.resolve(argv1);
     const candidates = [path.dirname(normalized)];
+    // Resolve symlinks for version managers (nvm, fnm, n, Homebrew/Linuxbrew)
+    // that create symlinks in bin/ pointing to the real package location.
+    try {
+        const resolved = fsSync.realpathSync(normalized);
+        if (resolved !== normalized) {
+            candidates.push(path.dirname(resolved));
+        }
+    }
+    catch {
+        // realpathSync throws if path doesn't exist; keep original candidates
+    }
     const parts = normalized.split(path.sep);
     const binIndex = parts.lastIndexOf(".bin");
     if (binIndex > 0 && parts[binIndex - 1] === "node_modules") {
@@ -62,24 +77,24 @@ function candidateDirsFromArgv1(argv1) {
     return candidates;
 }
 export async function resolvePoolBotPackageRoot(opts) {
-    const candidates = [];
-    if (opts.moduleUrl) {
-        candidates.push(path.dirname(fileURLToPath(opts.moduleUrl)));
-    }
-    if (opts.argv1) {
-        candidates.push(...candidateDirsFromArgv1(opts.argv1));
-    }
-    if (opts.cwd) {
-        candidates.push(opts.cwd);
-    }
-    for (const candidate of candidates) {
+    for (const candidate of buildCandidates(opts)) {
         const found = await findPackageRoot(candidate);
-        if (found)
+        if (found) {
             return found;
+        }
     }
     return null;
 }
 export function resolvePoolBotPackageRootSync(opts) {
+    for (const candidate of buildCandidates(opts)) {
+        const found = findPackageRootSync(candidate);
+        if (found) {
+            return found;
+        }
+    }
+    return null;
+}
+function buildCandidates(opts) {
     const candidates = [];
     if (opts.moduleUrl) {
         candidates.push(path.dirname(fileURLToPath(opts.moduleUrl)));
@@ -90,10 +105,5 @@ export function resolvePoolBotPackageRootSync(opts) {
     if (opts.cwd) {
         candidates.push(opts.cwd);
     }
-    for (const candidate of candidates) {
-        const found = findPackageRootSync(candidate);
-        if (found)
-            return found;
-    }
-    return null;
+    return candidates;
 }

package/dist/infra/ports.js

@@ -2,6 +2,7 @@ import net from "node:net";
 import { danger, info, shouldLogVerbose, warn } from "../globals.js";
 import { logDebug } from "../logger.js";
 import { defaultRuntime } from "../runtime.js";
+import { isErrno } from "./errors.js";
 import { formatPortDiagnostics } from "./ports-format.js";
 import { inspectPortUsage } from "./ports-inspect.js";
 class PortInUseError extends Error {
@@ -14,13 +15,11 @@ class PortInUseError extends Error {
         this.details = details;
     }
 }
-function isErrno(err) {
-    return Boolean(err && typeof err === "object" && "code" in err);
-}
 export async function describePortOwner(port) {
     const diagnostics = await inspectPortUsage(port);
-    if (diagnostics.listeners.length === 0)
+    if (diagnostics.listeners.length === 0) {
         return undefined;
+    }
     return formatPortDiagnostics(diagnostics).join("\n");
 }
 export async function ensurePortAvailable(port) {
@@ -38,8 +37,7 @@ export async function ensurePortAvailable(port) {
     }
     catch (err) {
         if (isErrno(err) && err.code === "EADDRINUSE") {
-            const details = await describePortOwner(port);
-            throw new PortInUseError(port, details);
+            throw new PortInUseError(port);
         }
         throw err;
     }
@@ -47,13 +45,15 @@ export async function ensurePortAvailable(port) {
 export async function handlePortError(err, port, context, runtime = defaultRuntime) {
     // Uniform messaging for EADDRINUSE with optional owner details.
     if (err instanceof PortInUseError || (isErrno(err) && err.code === "EADDRINUSE")) {
-        const details = err instanceof PortInUseError ? err.details : await describePortOwner(port);
+        const details = err instanceof PortInUseError
+            ? (err.details ?? (await describePortOwner(port)))
+            : await describePortOwner(port);
         runtime.error(danger(`${context} failed: port ${port} is already in use.`));
         if (details) {
             runtime.error(info("Port listener details:"));
             runtime.error(details);
             if (/poolbot|src\/index\.ts|dist\/index\.js/.test(details)) {
-                runtime.error(warn("It looks like another poolbot instance is already running. Stop it or pick a different port."));
+                runtime.error(warn("It looks like another Pool Bot instance is already running. Stop it or pick a different port."));
             }
         }
         runtime.error(info("Resolve by stopping the process using the port or passing --port <free-port>."));
@@ -63,12 +63,15 @@ export async function handlePortError(err, port, context, runtime = defaultRunti
     if (shouldLogVerbose()) {
         const stdout = err?.stdout;
         const stderr = err?.stderr;
-        if (stdout?.trim())
+        if (stdout?.trim()) {
             logDebug(`stdout: ${stdout.trim()}`);
-        if (stderr?.trim())
+        }
+        if (stderr?.trim()) {
             logDebug(`stderr: ${stderr.trim()}`);
+        }
     }
-    return runtime.exit(1);
+    runtime.exit(1);
+    throw new Error("unreachable");
 }
 export { PortInUseError };
 export { buildPortHints, classifyPortListener, formatPortDiagnostics } from "./ports-format.js";

package/dist/infra/skills-remote.js

@@ -1,8 +1,8 @@
 import { loadWorkspaceSkillEntries } from "../agents/skills.js";
-import { resolveAgentWorkspaceDir, resolveDefaultAgentId } from "../agents/agent-scope.js";
-import { listNodePairing, updatePairedNodeMetadata } from "./node-pairing.js";
-import { createSubsystemLogger } from "../logging/subsystem.js";
 import { bumpSkillsSnapshotVersion } from "../agents/skills/refresh.js";
+import { listAgentWorkspaceDirs } from "../agents/workspace-dirs.js";
+import { createSubsystemLogger } from "../logging/subsystem.js";
+import { listNodePairing, updatePairedNodeMetadata } from "./node-pairing.js";
 const log = createSubsystemLogger("gateway/skills-remote");
 const remoteNodes = new Map();
 let remoteRegistry = null;
@@ -14,12 +14,15 @@ function describeNode(nodeId) {
     return ip ? `${base} @ ${ip}` : base;
 }
 function extractErrorMessage(err) {
-    if (!err)
+    if (!err) {
         return undefined;
-    if (typeof err === "string")
+    }
+    if (typeof err === "string") {
         return err;
-    if (err instanceof Error)
+    }
+    if (err instanceof Error) {
         return err.message;
+    }
     if (typeof err === "object" && "message" in err && typeof err.message === "string") {
         return err.message;
     }
@@ -61,12 +64,15 @@ function isMacPlatform(platform, deviceFamily) {
     const familyNorm = String(deviceFamily ?? "")
         .trim()
         .toLowerCase();
-    if (platformNorm.includes("mac"))
+    if (platformNorm.includes("mac")) {
         return true;
-    if (platformNorm.includes("darwin"))
+    }
+    if (platformNorm.includes("darwin")) {
         return true;
-    if (familyNorm === "mac")
+    }
+    if (familyNorm === "mac") {
         return true;
+    }
     return false;
 }
 function supportsSystemRun(commands) {
@@ -123,34 +129,27 @@ export function recordRemoteNodeInfo(node) {
 export function recordRemoteNodeBins(nodeId, bins) {
     upsertNode({ nodeId, bins });
 }
-function listWorkspaceDirs(cfg) {
-    const dirs = new Set();
-    const list = cfg.agents?.list;
-    if (Array.isArray(list)) {
-        for (const entry of list) {
-            if (entry && typeof entry === "object" && typeof entry.id === "string") {
-                dirs.add(resolveAgentWorkspaceDir(cfg, entry.id));
-            }
-        }
-    }
-    dirs.add(resolveAgentWorkspaceDir(cfg, resolveDefaultAgentId(cfg)));
-    return [...dirs];
+export function removeRemoteNodeInfo(nodeId) {
+    remoteNodes.delete(nodeId);
 }
 function collectRequiredBins(entries, targetPlatform) {
     const bins = new Set();
     for (const entry of entries) {
         const os = entry.metadata?.os ?? [];
-        if (os.length > 0 && !os.includes(targetPlatform))
+        if (os.length > 0 && !os.includes(targetPlatform)) {
             continue;
+        }
         const required = entry.metadata?.requires?.bins ?? [];
         const anyBins = entry.metadata?.requires?.anyBins ?? [];
         for (const bin of required) {
-            if (bin.trim())
+            if (bin.trim()) {
                 bins.add(bin.trim());
+            }
         }
         for (const bin of anyBins) {
-            if (bin.trim())
+            if (bin.trim()) {
                 bins.add(bin.trim());
+            }
         }
     }
     return [...bins];
@@ -160,8 +159,9 @@ function buildBinProbeScript(bins) {
     return `for b in ${escaped}; do if command -v "$b" >/dev/null 2>&1; then echo "$b"; fi; done`;
 }
 function parseBinProbePayload(payloadJSON, payload) {
-    if (!payloadJSON && !payload)
+    if (!payloadJSON && !payload) {
         return [];
+    }
     try {
         const parsed = payloadJSON
             ? JSON.parse(payloadJSON)
@@ -182,26 +182,32 @@ function parseBinProbePayload(payloadJSON, payload) {
     return [];
 }
 function areBinSetsEqual(a, b) {
-    if (!a)
+    if (!a) {
         return false;
-    if (a.size !== b.size)
+    }
+    if (a.size !== b.size) {
         return false;
+    }
     for (const bin of b) {
-        if (!a.has(bin))
+        if (!a.has(bin)) {
             return false;
+        }
     }
     return true;
 }
 export async function refreshRemoteNodeBins(params) {
-    if (!remoteRegistry)
+    if (!remoteRegistry) {
         return;
-    if (!isMacPlatform(params.platform, params.deviceFamily))
+    }
+    if (!isMacPlatform(params.platform, params.deviceFamily)) {
         return;
+    }
     const canWhich = supportsSystemWhich(params.commands);
     const canRun = supportsSystemRun(params.commands);
-    if (!canWhich && !canRun)
+    if (!canWhich && !canRun) {
         return;
-    const workspaceDirs = listWorkspaceDirs(params.cfg);
+    }
+    const workspaceDirs = listAgentWorkspaceDirs(params.cfg);
     const requiredBins = new Set();
     for (const workspaceDir of workspaceDirs) {
         const entries = loadWorkspaceSkillEntries(workspaceDir, { config: params.cfg });
@@ -209,8 +215,9 @@ export async function refreshRemoteNodeBins(params) {
             requiredBins.add(bin);
         }
     }
-    if (requiredBins.size === 0)
+    if (requiredBins.size === 0) {
         return;
+    }
     try {
         const binsList = [...requiredBins];
         const res = await remoteRegistry.invoke(canWhich
@@ -237,8 +244,9 @@ export async function refreshRemoteNodeBins(params) {
         const nextBins = new Set(bins);
         const hasChanged = !areBinSetsEqual(existingBins, nextBins);
         recordRemoteNodeBins(params.nodeId, bins);
-        if (!hasChanged)
+        if (!hasChanged) {
             return;
+        }
         await updatePairedNodeMetadata(params.nodeId, { bins });
         bumpSkillsSnapshotVersion({ reason: "remote-node" });
     }
@@ -248,12 +256,14 @@ export async function refreshRemoteNodeBins(params) {
 }
 export function getRemoteSkillEligibility() {
     const macNodes = [...remoteNodes.values()].filter((node) => isMacPlatform(node.platform, node.deviceFamily) && supportsSystemRun(node.commands));
-    if (macNodes.length === 0)
+    if (macNodes.length === 0) {
         return undefined;
+    }
     const bins = new Set();
     for (const node of macNodes) {
-        for (const bin of node.bins)
+        for (const bin of node.bins) {
             bins.add(bin);
+        }
     }
     const labels = macNodes.map((node) => node.displayName ?? node.nodeId).filter(Boolean);
     const note = labels.length > 0
@@ -267,8 +277,9 @@ export function getRemoteSkillEligibility() {
     };
 }
 export async function refreshRemoteBinsForConnectedNodes(cfg) {
-    if (!remoteRegistry)
+    if (!remoteRegistry) {
         return;
+    }
     const connected = remoteRegistry.listConnected();
     for (const node of connected) {
         await refreshRemoteNodeBins({

package/dist/infra/system-events.js

@@ -11,11 +11,13 @@ function requireSessionKey(key) {
     return trimmed;
 }
 function normalizeContextKey(key) {
-    if (!key)
+    if (!key) {
         return null;
+    }
     const trimmed = key.trim();
-    if (!trimmed)
+    if (!trimmed) {
         return null;
+    }
     return trimmed.toLowerCase();
 }
 export function isSystemEventContextChanged(sessionKey, contextKey) {
@@ -37,21 +39,30 @@ export function enqueueSystemEvent(text, options) {
             return created;
         })();
     const cleaned = text.trim();
-    if (!cleaned)
+    if (!cleaned) {
+        return;
+    }
+    const normalizedContextKey = normalizeContextKey(options?.contextKey);
+    entry.lastContextKey = normalizedContextKey;
+    if (entry.lastText === cleaned) {
         return;
-    entry.lastContextKey = normalizeContextKey(options?.contextKey);
-    if (entry.lastText === cleaned)
-        return; // skip consecutive duplicates
+    } // skip consecutive duplicates
     entry.lastText = cleaned;
-    entry.queue.push({ text: cleaned, ts: Date.now() });
-    if (entry.queue.length > MAX_EVENTS)
+    entry.queue.push({
+        text: cleaned,
+        ts: Date.now(),
+        contextKey: normalizedContextKey,
+    });
+    if (entry.queue.length > MAX_EVENTS) {
         entry.queue.shift();
+    }
 }
 export function drainSystemEventEntries(sessionKey) {
     const key = requireSessionKey(sessionKey);
     const entry = queues.get(key);
-    if (!entry || entry.queue.length === 0)
+    if (!entry || entry.queue.length === 0) {
         return [];
+    }
     const out = entry.queue.slice();
     entry.queue.length = 0;
     entry.lastText = null;
@@ -62,9 +73,12 @@ export function drainSystemEventEntries(sessionKey) {
 export function drainSystemEvents(sessionKey) {
     return drainSystemEventEntries(sessionKey).map((event) => event.text);
 }
-export function peekSystemEvents(sessionKey) {
+export function peekSystemEventEntries(sessionKey) {
     const key = requireSessionKey(sessionKey);
-    return queues.get(key)?.queue.map((e) => e.text) ?? [];
+    return queues.get(key)?.queue.map((event) => ({ ...event })) ?? [];
+}
+export function peekSystemEvents(sessionKey) {
+    return peekSystemEventEntries(sessionKey).map((event) => event.text);
 }
 export function hasSystemEvents(sessionKey) {
     const key = requireSessionKey(sessionKey);

package/dist/infra/system-presence.js

@@ -1,42 +1,27 @@
 import { spawnSync } from "node:child_process";
 import os from "node:os";
+import { pickPrimaryLanIPv4 } from "../gateway/net.js";
+import { resolveRuntimeServiceVersion } from "../version.js";
 const entries = new Map();
 const TTL_MS = 5 * 60 * 1000; // 5 minutes
 const MAX_ENTRIES = 200;
 function normalizePresenceKey(key) {
-    if (!key)
+    if (!key) {
         return undefined;
+    }
     const trimmed = key.trim();
-    if (!trimmed)
+    if (!trimmed) {
         return undefined;
+    }
     return trimmed.toLowerCase();
 }
 function resolvePrimaryIPv4() {
-    const nets = os.networkInterfaces();
-    const prefer = ["en0", "eth0"];
-    const pick = (names) => {
-        for (const name of names) {
-            const list = nets[name];
-            const entry = list?.find((n) => n.family === "IPv4" && !n.internal);
-            if (entry?.address)
-                return entry.address;
-        }
-        for (const list of Object.values(nets)) {
-            const entry = list?.find((n) => n.family === "IPv4" && !n.internal);
-            if (entry?.address)
-                return entry.address;
-        }
-        return undefined;
-    };
-    return pick(prefer) ?? os.hostname();
+    return pickPrimaryLanIPv4() ?? os.hostname();
 }
 function initSelfPresence() {
     const host = os.hostname();
     const ip = resolvePrimaryIPv4() ?? undefined;
-    const version = process.env.POOLBOT_VERSION ??
-        process.env.CLAWDBOT_VERSION ??
-        process.env.npm_package_version ??
-        "unknown";
+    const version = resolveRuntimeServiceVersion(process.env, "unknown");
     const modelIdentifier = (() => {
         const p = os.platform();
         if (p === "darwin") {
@@ -58,20 +43,25 @@ function initSelfPresence() {
     const platform = (() => {
         const p = os.platform();
         const rel = os.release();
-        if (p === "darwin")
+        if (p === "darwin") {
             return `macos ${macOSVersion()}`;
-        if (p === "win32")
+        }
+        if (p === "win32") {
             return `windows ${rel}`;
+        }
         return `${p} ${rel}`;
     })();
     const deviceFamily = (() => {
         const p = os.platform();
-        if (p === "darwin")
+        if (p === "darwin") {
             return "Mac";
-        if (p === "win32")
+        }
+        if (p === "win32") {
             return "Windows";
-        if (p === "linux")
+        }
+        if (p === "linux") {
             return "Linux";
+        }
         return p;
     })();
     const text = `Gateway: ${host}${ip ? ` (${ip})` : ""} · app ${version} · mode gateway · reason self`;
@@ -134,12 +124,14 @@ function parsePresence(text) {
 function mergeStringList(...values) {
     const out = new Set();
     for (const list of values) {
-        if (!Array.isArray(list))
+        if (!Array.isArray(list)) {
             continue;
+        }
         for (const item of list) {
             const trimmed = String(item).trim();
-            if (trimmed)
+            if (trimmed) {
                 out.add(trimmed);
+            }
         }
     }
     return out.size > 0 ? [...out] : undefined;
@@ -218,17 +210,18 @@ export function listSystemPresence() {
     // prune expired
     const now = Date.now();
     for (const [k, v] of entries) {
-        if (now - v.ts > TTL_MS)
+        if (now - v.ts > TTL_MS) {
             entries.delete(k);
+        }
     }
     // enforce max size (LRU by ts)
     if (entries.size > MAX_ENTRIES) {
-        const sorted = [...entries.entries()].sort((a, b) => a[1].ts - b[1].ts);
+        const sorted = [...entries.entries()].toSorted((a, b) => a[1].ts - b[1].ts);
         const toDrop = entries.size - MAX_ENTRIES;
         for (let i = 0; i < toDrop; i++) {
             entries.delete(sorted[i][0]);
         }
     }
     touchSelfPresence();
-    return [...entries.values()].sort((a, b) => b.ts - a.ts);
+    return [...entries.values()].toSorted((a, b) => b.ts - a.ts);
 }

package/dist/infra/tmp-poolbot-dir.js

@@ -1,2 +1,81 @@
-// Re-export from the canonical file (rebrand alias)
-export * from "./tmp-openclaw-dir.js";
+import fs from "node:fs";
+import os from "node:os";
+import path from "node:path";
+export const POSIX_POOLBOT_TMP_DIR = "/tmp/poolbot";
+function isNodeErrorWithCode(err, code) {
+    return (typeof err === "object" &&
+        err !== null &&
+        "code" in err &&
+        err.code === code);
+}
+export function resolvePreferredPoolbotTmpDir(options = {}) {
+    const accessSync = options.accessSync ?? fs.accessSync;
+    const lstatSync = options.lstatSync ?? fs.lstatSync;
+    const mkdirSync = options.mkdirSync ?? fs.mkdirSync;
+    const getuid = options.getuid ??
+        (() => {
+            try {
+                return typeof process.getuid === "function" ? process.getuid() : undefined;
+            }
+            catch {
+                return undefined;
+            }
+        });
+    const tmpdir = options.tmpdir ?? os.tmpdir;
+    const uid = getuid();
+    const isSecureDirForUser = (st) => {
+        if (uid === undefined) {
+            return true;
+        }
+        if (typeof st.uid === "number" && st.uid !== uid) {
+            return false;
+        }
+        // Avoid group/other writable dirs when running on multi-user hosts.
+        if (typeof st.mode === "number" && (st.mode & 0o022) !== 0) {
+            return false;
+        }
+        return true;
+    };
+    const fallback = () => {
+        const base = tmpdir();
+        const suffix = uid === undefined ? "poolbot" : `poolbot-${uid}`;
+        return path.join(base, suffix);
+    };
+    try {
+        const preferred = lstatSync(POSIX_POOLBOT_TMP_DIR);
+        if (!preferred.isDirectory() || preferred.isSymbolicLink()) {
+            return fallback();
+        }
+        accessSync(POSIX_POOLBOT_TMP_DIR, fs.constants.W_OK | fs.constants.X_OK);
+        if (!isSecureDirForUser(preferred)) {
+            return fallback();
+        }
+        return POSIX_POOLBOT_TMP_DIR;
+    }
+    catch (err) {
+        if (!isNodeErrorWithCode(err, "ENOENT")) {
+            return fallback();
+        }
+    }
+    try {
+        accessSync("/tmp", fs.constants.W_OK | fs.constants.X_OK);
+        // Create with a safe default; subsequent callers expect it exists.
+        mkdirSync(POSIX_POOLBOT_TMP_DIR, { recursive: true, mode: 0o700 });
+        try {
+            const preferred = lstatSync(POSIX_POOLBOT_TMP_DIR);
+            if (!preferred.isDirectory() || preferred.isSymbolicLink()) {
+                return fallback();
+            }
+            if (!isSecureDirForUser(preferred)) {
+                return fallback();
+            }
+        }
+        catch {
+            return fallback();
+        }
+        return POSIX_POOLBOT_TMP_DIR;
+    }
+    catch {
+        return fallback();
+    }
+}

package/dist/infra/wsl.js

@@ -1,3 +1,4 @@
+import { readFileSync } from "node:fs";
 import fs from "node:fs/promises";
 let wslCached = null;
 export function isWSLEnv() {
@@ -6,9 +7,44 @@ export function isWSLEnv() {
     }
     return false;
 }
+/**
+ * Synchronously check if running in WSL.
+ * Checks env vars first, then /proc/version.
+ */
+export function isWSLSync() {
+    if (process.platform !== "linux") {
+        return false;
+    }
+    if (isWSLEnv()) {
+        return true;
+    }
+    try {
+        const release = readFileSync("/proc/version", "utf8").toLowerCase();
+        return release.includes("microsoft") || release.includes("wsl");
+    }
+    catch {
+        return false;
+    }
+}
+/**
+ * Synchronously check if running in WSL2.
+ */
+export function isWSL2Sync() {
+    if (!isWSLSync()) {
+        return false;
+    }
+    try {
+        const version = readFileSync("/proc/version", "utf8").toLowerCase();
+        return version.includes("wsl2") || version.includes("microsoft-standard");
+    }
+    catch {
+        return false;
+    }
+}
 export async function isWSL() {
-    if (wslCached !== null)
+    if (wslCached !== null) {
         return wslCached;
+    }
     if (isWSLEnv()) {
         wslCached = true;
         return wslCached;