@poolzin/pool-bot 2026.2.0 → 2026.2.2

package/dist/cli/cron-cli/shared.js

@@ -1,5 +1,6 @@
 import { listChannelPlugins } from "../../channels/plugins/index.js";
 import { parseAbsoluteTimeMs } from "../../cron/parse.js";
+import { formatDurationHuman } from "../../infra/format-time/format-duration.js";
 import { defaultRuntime } from "../../runtime.js";
 import { colorize, isRich, theme } from "../../terminal/theme.js";
 import { callGatewayFromCli } from "../gateway-rpc.js";
@@ -7,8 +8,9 @@ export const getCronChannelOptions = () => ["last", ...listChannelPlugins().map(
 export async function warnIfCronSchedulerDisabled(opts) {
     try {
         const res = (await callGatewayFromCli("cron.status", opts, {}));
-        if (res?.enabled === true)
+        if (res?.enabled === true) {
             return;
+        }
         const store = typeof res?.storePath === "string" ? res.storePath : "";
         defaultRuntime.error([
             "warning: cron scheduler is disabled in the Gateway; jobs are saved but will not run automatically.",
@@ -24,14 +26,17 @@ export async function warnIfCronSchedulerDisabled(opts) {
 }
 export function parseDurationMs(input) {
     const raw = input.trim();
-    if (!raw)
+    if (!raw) {
         return null;
+    }
     const match = raw.match(/^(\d+(?:\.\d+)?)(ms|s|m|h|d)$/i);
-    if (!match)
+    if (!match) {
         return null;
+    }
     const n = Number.parseFloat(match[1] ?? "");
-    if (!Number.isFinite(n) || n <= 0)
+    if (!Number.isFinite(n) || n <= 0) {
         return null;
+    }
     const unit = (match[2] ?? "").toLowerCase();
     const factor = unit === "ms"
         ? 1
@@ -44,16 +49,19 @@ export function parseDurationMs(input) {
                     : 86_400_000;
     return Math.floor(n * factor);
 }
-export function parseAtMs(input) {
+export function parseAt(input) {
     const raw = input.trim();
-    if (!raw)
+    if (!raw) {
         return null;
+    }
     const absolute = parseAbsoluteTimeMs(raw);
-    if (absolute)
-        return absolute;
+    if (absolute !== null) {
+        return new Date(absolute).toISOString();
+    }
     const dur = parseDurationMs(raw);
-    if (dur)
-        return Date.now() + dur;
+    if (dur !== null) {
+        return new Date(Date.now() + dur).toISOString();
+    }
     return null;
 }
 const CRON_ID_PAD = 36;
@@ -66,56 +74,59 @@ const CRON_TARGET_PAD = 9;
 const CRON_AGENT_PAD = 10;
 const pad = (value, width) => value.padEnd(width);
 const truncate = (value, width) => {
-    if (value.length <= width)
+    if (value.length <= width) {
         return value;
-    if (width <= 3)
+    }
+    if (width <= 3) {
         return value.slice(0, width);
+    }
     return `${value.slice(0, width - 3)}...`;
 };
-const formatIsoMinute = (ms) => {
-    const d = new Date(ms);
-    if (Number.isNaN(d.getTime()))
+const formatIsoMinute = (iso) => {
+    const parsed = parseAbsoluteTimeMs(iso);
+    const d = new Date(parsed ?? NaN);
+    if (Number.isNaN(d.getTime())) {
         return "-";
-    const iso = d.toISOString();
-    return `${iso.slice(0, 10)} ${iso.slice(11, 16)}Z`;
-};
-const formatDuration = (ms) => {
-    if (ms < 60_000)
-        return `${Math.max(1, Math.round(ms / 1000))}s`;
-    if (ms < 3_600_000)
-        return `${Math.round(ms / 60_000)}m`;
-    if (ms < 86_400_000)
-        return `${Math.round(ms / 3_600_000)}h`;
-    return `${Math.round(ms / 86_400_000)}d`;
+    }
+    const isoStr = d.toISOString();
+    return `${isoStr.slice(0, 10)} ${isoStr.slice(11, 16)}Z`;
 };
 const formatSpan = (ms) => {
-    if (ms < 60_000)
+    if (ms < 60_000) {
         return "<1m";
-    if (ms < 3_600_000)
+    }
+    if (ms < 3_600_000) {
         return `${Math.round(ms / 60_000)}m`;
-    if (ms < 86_400_000)
+    }
+    if (ms < 86_400_000) {
         return `${Math.round(ms / 3_600_000)}h`;
+    }
     return `${Math.round(ms / 86_400_000)}d`;
 };
 const formatRelative = (ms, nowMs) => {
-    if (!ms)
+    if (!ms) {
         return "-";
+    }
     const delta = ms - nowMs;
     const label = formatSpan(Math.abs(delta));
     return delta >= 0 ? `in ${label}` : `${label} ago`;
 };
 const formatSchedule = (schedule) => {
-    if (schedule.kind === "at")
-        return `at ${formatIsoMinute(schedule.atMs)}`;
-    if (schedule.kind === "every")
-        return `every ${formatDuration(schedule.everyMs)}`;
+    if (schedule.kind === "at") {
+        return `at ${formatIsoMinute(schedule.at)}`;
+    }
+    if (schedule.kind === "every") {
+        return `every ${formatDurationHuman(schedule.everyMs)}`;
+    }
     return schedule.tz ? `cron ${schedule.expr} @ ${schedule.tz}` : `cron ${schedule.expr}`;
 };
 const formatStatus = (job) => {
-    if (!job.enabled)
+    if (!job.enabled) {
         return "disabled";
-    if (job.state.runningAtMs)
+    }
+    if (job.state.runningAtMs) {
         return "running";
+    }
     return job.state.lastStatus ?? "idle";
 };
 export function printCronList(jobs, runtime = defaultRuntime) {
@@ -144,17 +155,21 @@ export function printCronList(jobs, runtime = defaultRuntime) {
         const lastLabel = pad(formatRelative(job.state.lastRunAtMs, now), CRON_LAST_PAD);
         const statusRaw = formatStatus(job);
         const statusLabel = pad(statusRaw, CRON_STATUS_PAD);
-        const targetLabel = pad(job.sessionTarget, CRON_TARGET_PAD);
+        const targetLabel = pad(job.sessionTarget ?? "-", CRON_TARGET_PAD);
         const agentLabel = pad(truncate(job.agentId ?? "default", CRON_AGENT_PAD), CRON_AGENT_PAD);
         const coloredStatus = (() => {
-            if (statusRaw === "ok")
+            if (statusRaw === "ok") {
                 return colorize(rich, theme.success, statusLabel);
-            if (statusRaw === "error")
+            }
+            if (statusRaw === "error") {
                 return colorize(rich, theme.error, statusLabel);
-            if (statusRaw === "running")
+            }
+            if (statusRaw === "running") {
                 return colorize(rich, theme.warn, statusLabel);
-            if (statusRaw === "skipped")
+            }
+            if (statusRaw === "skipped") {
                 return colorize(rich, theme.muted, statusLabel);
+            }
             return colorize(rich, theme.muted, statusLabel);
         })();
         const coloredTarget = job.sessionTarget === "isolated"

package/dist/cli/dns-cli.js

@@ -3,7 +3,7 @@ import fs from "node:fs";
 import path from "node:path";
 import { loadConfig } from "../config/config.js";
 import { pickPrimaryTailnetIPv4, pickPrimaryTailnetIPv6 } from "../infra/tailnet.js";
-import { getWideAreaZonePath, WIDE_AREA_DISCOVERY_DOMAIN } from "../infra/widearea-dns.js";
+import { getWideAreaZonePath, resolveWideAreaDiscoveryDomain } from "../infra/widearea-dns.js";
 import { defaultRuntime } from "../runtime.js";
 import { formatDocsLink } from "../terminal/links.js";
 import { renderTable } from "../terminal/table.js";
@@ -13,8 +13,9 @@ function run(cmd, args, opts) {
         encoding: "utf-8",
         stdio: opts?.inherit ? "inherit" : "pipe",
     });
-    if (res.error)
+    if (res.error) {
         throw res.error;
+    }
     if (!opts?.allowFailure && res.status !== 0) {
         const errText = typeof res.stderr === "string" && res.stderr.trim()
             ? res.stderr.trim()
@@ -39,8 +40,9 @@ function writeFileSudoIfNeeded(filePath, content) {
         encoding: "utf-8",
         stdio: ["pipe", "ignore", "inherit"],
     });
-    if (res.error)
+    if (res.error) {
         throw res.error;
+    }
     if (res.status !== 0) {
         throw new Error(`sudo tee ${filePath} failed: exit ${res.status ?? "unknown"}`);
     }
@@ -59,8 +61,9 @@ function mkdirSudoIfNeeded(dirPath) {
     run("sudo", ["mkdir", "-p", dirPath], { inherit: true });
 }
 function zoneFileNeedsBootstrap(zonePath) {
-    if (!fs.existsSync(zonePath))
+    if (!fs.existsSync(zonePath)) {
         return true;
+    }
     try {
         const content = fs.readFileSync(zonePath, "utf-8");
         return !/\bSOA\b/.test(content) || !/\bNS\b/.test(content);
@@ -72,14 +75,16 @@ function zoneFileNeedsBootstrap(zonePath) {
 function detectBrewPrefix() {
     const out = run("brew", ["--prefix"]);
     const prefix = out.trim();
-    if (!prefix)
+    if (!prefix) {
         throw new Error("failed to resolve Homebrew prefix");
+    }
     return prefix;
 }
 function ensureImportLine(corefilePath, importGlob) {
     const existing = fs.readFileSync(corefilePath, "utf-8");
-    if (existing.includes(importGlob))
+    if (existing.includes(importGlob)) {
         return false;
+    }
     const next = `${existing.replace(/\s*$/, "")}\n\nimport ${importGlob}\n`;
     writeFileSudoIfNeeded(corefilePath, next);
     return true;
@@ -91,13 +96,20 @@ export function registerDnsCli(program) {
         .addHelpText("after", () => `\n${theme.muted("Docs:")} ${formatDocsLink("/cli/dns", "docs.molt.bot/cli/dns")}\n`);
     dns
         .command("setup")
-        .description("Set up CoreDNS to serve poolbot.internal for unicast DNS-SD (Wide-Area Bonjour)")
+        .description("Set up CoreDNS to serve your discovery domain for unicast DNS-SD (Wide-Area Bonjour)")
+        .option("--domain <domain>", "Wide-area discovery domain (e.g. poolbot.internal)")
         .option("--apply", "Install/update CoreDNS config and (re)start the service (requires sudo)", false)
         .action(async (opts) => {
         const cfg = loadConfig();
         const tailnetIPv4 = pickPrimaryTailnetIPv4();
         const tailnetIPv6 = pickPrimaryTailnetIPv6();
-        const zonePath = getWideAreaZonePath();
+        const wideAreaDomain = resolveWideAreaDiscoveryDomain({
+            configDomain: opts.domain ?? cfg.discovery?.wideArea?.domain,
+        });
+        if (!wideAreaDomain) {
+            throw new Error("No wide-area domain configured. Set discovery.wideArea.domain or pass --domain.");
+        }
+        const zonePath = getWideAreaZonePath(wideAreaDomain);
         const tableWidth = Math.max(60, (process.stdout.columns ?? 120) - 1);
         defaultRuntime.log(theme.heading("DNS setup"));
         defaultRuntime.log(renderTable({
@@ -107,7 +119,7 @@ export function registerDnsCli(program) {
                 { key: "Value", header: "Value", minWidth: 24, flex: true },
             ],
             rows: [
-                { Key: "Domain", Value: WIDE_AREA_DISCOVERY_DOMAIN },
+                { Key: "Domain", Value: wideAreaDomain },
                 { Key: "Zone file", Value: zonePath },
                 {
                     Key: "Tailnet IP",
@@ -119,12 +131,12 @@ export function registerDnsCli(program) {
         defaultRuntime.log(theme.heading("Recommended ~/.poolbot/poolbot.json:"));
         defaultRuntime.log(JSON.stringify({
             gateway: { bind: "auto" },
-            discovery: { wideArea: { enabled: true } },
+            discovery: { wideArea: { enabled: true, domain: wideAreaDomain } },
         }, null, 2));
         defaultRuntime.log("");
         defaultRuntime.log(theme.heading("Tailscale admin (DNS → Nameservers):"));
         defaultRuntime.log(theme.muted(`- Add nameserver: ${tailnetIPv4 ?? "<this machine's tailnet IPv4>"}`));
-        defaultRuntime.log(theme.muted("- Restrict to domain (Split DNS): poolbot.internal"));
+        defaultRuntime.log(theme.muted(`- Restrict to domain (Split DNS): ${wideAreaDomain.replace(/\.$/, "")}`));
         if (!opts.apply) {
             defaultRuntime.log("");
             defaultRuntime.log(theme.muted("Run with --apply to install CoreDNS and configure it."));
@@ -141,7 +153,7 @@ export function registerDnsCli(program) {
         const corefilePath = path.join(etcDir, "Corefile");
         const confDir = path.join(etcDir, "conf.d");
         const importGlob = path.join(confDir, "*.server");
-        const serverPath = path.join(confDir, "poolbot.internal.server");
+        const serverPath = path.join(confDir, `${wideAreaDomain.replace(/\.$/, "")}.server`);
         run("brew", ["list", "coredns"], { allowFailure: true });
         run("brew", ["install", "coredns"], {
             inherit: true,
@@ -156,7 +168,7 @@ export function registerDnsCli(program) {
         }
         const bindArgs = [tailnetIPv4, tailnetIPv6].filter((v) => Boolean(v?.trim()));
         const server = [
-            `${WIDE_AREA_DISCOVERY_DOMAIN.replace(/\.$/, "")}:53 {`,
+            `${wideAreaDomain.replace(/\.$/, "")}:53 {`,
             `  bind ${bindArgs.join(" ")}`,
             `  file ${zonePath} {`,
             `    reload 10s`,
@@ -176,7 +188,7 @@ export function registerDnsCli(program) {
             const serial = `${y}${m}${d}01`;
             const zoneLines = [
                 `; created by poolbot dns setup (will be overwritten by the gateway when wide-area discovery is enabled)`,
-                `$ORIGIN ${WIDE_AREA_DISCOVERY_DOMAIN}`,
+                `$ORIGIN ${wideAreaDomain}`,
                 `$TTL 60`,
                 `@ IN SOA ns1 hostmaster ${serial} 7200 3600 1209600 60`,
                 `@ IN NS ns1`,

package/dist/cli/gateway-cli/register.js

@@ -1,41 +1,51 @@
 import { gatewayStatusCommand } from "../../commands/gateway-status.js";
 import { formatHealthChannelLines } from "../../commands/health.js";
+import { loadConfig } from "../../config/config.js";
 import { discoverGatewayBeacons } from "../../infra/bonjour-discovery.js";
-import { WIDE_AREA_DISCOVERY_DOMAIN } from "../../infra/widearea-dns.js";
+import { resolveWideAreaDiscoveryDomain } from "../../infra/widearea-dns.js";
 import { defaultRuntime } from "../../runtime.js";
 import { formatDocsLink } from "../../terminal/links.js";
 import { colorize, isRich, theme } from "../../terminal/theme.js";
 import { formatTokenCount, formatUsd } from "../../utils/usage-format.js";
-import { withProgress } from "../progress.js";
 import { runCommandWithRuntime } from "../cli-utils.js";
 import { runDaemonInstall, runDaemonRestart, runDaemonStart, runDaemonStatus, runDaemonStop, runDaemonUninstall, } from "../daemon-cli.js";
+import { withProgress } from "../progress.js";
 import { callGatewayCli, gatewayCallOpts } from "./call.js";
 import { dedupeBeacons, parseDiscoverTimeoutMs, pickBeaconHost, pickGatewayPort, renderBeaconLines, } from "./discover.js";
 import { addGatewayRunCommand } from "./run.js";
 function styleHealthChannelLine(line, rich) {
-    if (!rich)
+    if (!rich) {
         return line;
+    }
     const colon = line.indexOf(":");
-    if (colon === -1)
+    if (colon === -1) {
         return line;
+    }
     const label = line.slice(0, colon + 1);
     const detail = line.slice(colon + 1).trimStart();
     const normalized = detail.toLowerCase();
     const applyPrefix = (prefix, color) => `${label} ${color(detail.slice(0, prefix.length))}${detail.slice(prefix.length)}`;
-    if (normalized.startsWith("failed"))
+    if (normalized.startsWith("failed")) {
         return applyPrefix("failed", theme.error);
-    if (normalized.startsWith("ok"))
+    }
+    if (normalized.startsWith("ok")) {
         return applyPrefix("ok", theme.success);
-    if (normalized.startsWith("linked"))
+    }
+    if (normalized.startsWith("linked")) {
         return applyPrefix("linked", theme.success);
-    if (normalized.startsWith("configured"))
+    }
+    if (normalized.startsWith("configured")) {
         return applyPrefix("configured", theme.success);
-    if (normalized.startsWith("not linked"))
+    }
+    if (normalized.startsWith("not linked")) {
         return applyPrefix("not linked", theme.warn);
-    if (normalized.startsWith("not configured"))
+    }
+    if (normalized.startsWith("not configured")) {
         return applyPrefix("not configured", theme.muted);
-    if (normalized.startsWith("unknown"))
+    }
+    if (normalized.startsWith("unknown")) {
         return applyPrefix("unknown", theme.warn);
+    }
     return line;
 }
 function runGatewayCommand(action, label) {
@@ -46,12 +56,14 @@ function runGatewayCommand(action, label) {
     });
 }
 function parseDaysOption(raw, fallback = 30) {
-    if (typeof raw === "number" && Number.isFinite(raw))
+    if (typeof raw === "number" && Number.isFinite(raw)) {
         return Math.max(1, Math.floor(raw));
+    }
     if (typeof raw === "string" && raw.trim() !== "") {
         const parsed = Number(raw);
-        if (Number.isFinite(parsed))
+        if (Number.isFinite(parsed)) {
             return Math.max(1, Math.floor(parsed));
+        }
     }
     return fallback;
 }
@@ -213,19 +225,24 @@ export function registerGatewayCli(program) {
     });
     gateway
         .command("discover")
-        .description(`Discover gateways via Bonjour (multicast local. + unicast ${WIDE_AREA_DISCOVERY_DOMAIN})`)
+        .description("Discover gateways via Bonjour (local + wide-area if configured)")
         .option("--timeout <ms>", "Per-command timeout in ms", "2000")
         .option("--json", "Output JSON", false)
         .action(async (opts) => {
         await runGatewayCommand(async () => {
+            const cfg = loadConfig();
+            const wideAreaDomain = resolveWideAreaDiscoveryDomain({
+                configDomain: cfg.discovery?.wideArea?.domain,
+            });
             const timeoutMs = parseDiscoverTimeoutMs(opts.timeout, 2000);
+            const domains = ["local.", ...(wideAreaDomain ? [wideAreaDomain] : [])];
             const beacons = await withProgress({
                 label: "Scanning for gateways…",
                 indeterminate: true,
                 enabled: opts.json !== true,
                 delayMs: 0,
-            }, async () => await discoverGatewayBeacons({ timeoutMs }));
-            const deduped = dedupeBeacons(beacons).sort((a, b) => String(a.displayName || a.instanceName).localeCompare(String(b.displayName || b.instanceName)));
+            }, async () => await discoverGatewayBeacons({ timeoutMs, wideAreaDomain }));
+            const deduped = dedupeBeacons(beacons).toSorted((a, b) => String(a.displayName || a.instanceName).localeCompare(String(b.displayName || b.instanceName)));
             if (opts.json) {
                 const enriched = deduped.map((b) => {
                     const host = pickBeaconHost(b);
@@ -234,7 +251,7 @@ export function registerGatewayCli(program) {
                 });
                 defaultRuntime.log(JSON.stringify({
                     timeoutMs,
-                    domains: ["local.", WIDE_AREA_DISCOVERY_DOMAIN],
+                    domains,
                     count: enriched.length,
                     beacons: enriched,
                 }, null, 2));
@@ -242,9 +259,10 @@ export function registerGatewayCli(program) {
             }
             const rich = isRich();
             defaultRuntime.log(colorize(rich, theme.heading, "Gateway Discovery"));
-            defaultRuntime.log(colorize(rich, theme.muted, `Found ${deduped.length} gateway(s) · domains: local., ${WIDE_AREA_DISCOVERY_DOMAIN}`));
-            if (deduped.length === 0)
+            defaultRuntime.log(colorize(rich, theme.muted, `Found ${deduped.length} gateway(s) · domains: ${domains.join(", ")}`));
+            if (deduped.length === 0) {
                 return;
+            }
             for (const beacon of deduped) {
                 for (const line of renderBeaconLines(beacon, rich)) {
                     defaultRuntime.log(line);

package/dist/cli/memory-cli.js

@@ -161,7 +161,7 @@ export async function runMemoryStatus(opts) {
             getManager: () => getMemorySearchManager({ cfg, agentId }),
             onMissing: (error) => defaultRuntime.log(error ?? "Memory search disabled."),
             onCloseError: (err) => defaultRuntime.error(`Memory manager close failed: ${formatErrorMessage(err)}`),
-            close: (manager) => manager.close(),
+            close: async (manager) => { await manager.close?.(); },
             run: async (manager) => {
                 const deep = Boolean(opts.deep || opts.index);
                 let embeddingProbe;
@@ -182,7 +182,7 @@ export async function runMemoryStatus(opts) {
                             fallback: opts.verbose ? "line" : undefined,
                         }, async (update, progress) => {
                             try {
-                                await manager.sync({
+                                await manager.sync?.({
                                     reason: "cli",
                                     progress: (syncUpdate) => {
                                         update({
@@ -387,7 +387,7 @@ export function registerMemoryCli(program) {
                 getManager: () => getMemorySearchManager({ cfg, agentId }),
                 onMissing: (error) => defaultRuntime.log(error ?? "Memory search disabled."),
                 onCloseError: (err) => defaultRuntime.error(`Memory manager close failed: ${formatErrorMessage(err)}`),
-                close: (manager) => manager.close(),
+                close: async (manager) => { await manager.close?.(); },
                 run: async (manager) => {
                     try {
                         if (opts.verbose) {
@@ -453,7 +453,7 @@ export function registerMemoryCli(program) {
                                 progress.setLabel(buildLabel());
                             }, 1000);
                             try {
-                                await manager.sync({
+                                await manager.sync?.({
                                     reason: "cli",
                                     force: opts.force,
                                     progress: (syncUpdate) => {
@@ -500,7 +500,7 @@ export function registerMemoryCli(program) {
             getManager: () => getMemorySearchManager({ cfg, agentId }),
             onMissing: (error) => defaultRuntime.log(error ?? "Memory search disabled."),
             onCloseError: (err) => defaultRuntime.error(`Memory manager close failed: ${formatErrorMessage(err)}`),
-            close: (manager) => manager.close(),
+            close: async (manager) => { await manager.close?.(); },
             run: async (manager) => {
                 let results;
                 try {

package/dist/cli/parse-bytes.js

@@ -0,0 +1,37 @@
+const UNIT_MULTIPLIERS = {
+    b: 1,
+    kb: 1024,
+    k: 1024,
+    mb: 1024 ** 2,
+    m: 1024 ** 2,
+    gb: 1024 ** 3,
+    g: 1024 ** 3,
+    tb: 1024 ** 4,
+    t: 1024 ** 4,
+};
+export function parseByteSize(raw, opts) {
+    const trimmed = String(raw ?? "")
+        .trim()
+        .toLowerCase();
+    if (!trimmed) {
+        throw new Error("invalid byte size (empty)");
+    }
+    const m = /^(\d+(?:\.\d+)?)([a-z]+)?$/.exec(trimmed);
+    if (!m) {
+        throw new Error(`invalid byte size: ${raw}`);
+    }
+    const value = Number(m[1]);
+    if (!Number.isFinite(value) || value < 0) {
+        throw new Error(`invalid byte size: ${raw}`);
+    }
+    const unit = (m[2] ?? opts?.defaultUnit ?? "b").toLowerCase();
+    const multiplier = UNIT_MULTIPLIERS[unit];
+    if (!multiplier) {
+        throw new Error(`invalid byte size unit: ${raw}`);
+    }
+    const bytes = Math.round(value * multiplier);
+    if (!Number.isFinite(bytes)) {
+        throw new Error(`invalid byte size: ${raw}`);
+    }
+    return bytes;
+}