@farazirfan/costar-server-executor 1.0.0

package/dist/infra/node-pairing.js

@@ -0,0 +1,229 @@
+import { randomUUID } from "node:crypto";
+import fs from "node:fs/promises";
+import path from "node:path";
+import { resolveStateDir } from "../config/paths.js";
+const PENDING_TTL_MS = 5 * 60 * 1000;
+function resolvePaths(baseDir) {
+    const root = baseDir ?? resolveStateDir();
+    const dir = path.join(root, "nodes");
+    return {
+        dir,
+        pendingPath: path.join(dir, "pending.json"),
+        pairedPath: path.join(dir, "paired.json"),
+    };
+}
+async function readJSON(filePath) {
+    try {
+        const raw = await fs.readFile(filePath, "utf8");
+        return JSON.parse(raw);
+    }
+    catch {
+        return null;
+    }
+}
+async function writeJSONAtomic(filePath, value) {
+    const dir = path.dirname(filePath);
+    await fs.mkdir(dir, { recursive: true });
+    const tmp = `${filePath}.${randomUUID()}.tmp`;
+    await fs.writeFile(tmp, JSON.stringify(value, null, 2), "utf8");
+    try {
+        await fs.chmod(tmp, 0o600);
+    }
+    catch {
+        // best-effort; ignore on platforms without chmod
+    }
+    await fs.rename(tmp, filePath);
+    try {
+        await fs.chmod(filePath, 0o600);
+    }
+    catch {
+        // best-effort; ignore on platforms without chmod
+    }
+}
+function pruneExpiredPending(pendingById, nowMs) {
+    for (const [id, req] of Object.entries(pendingById)) {
+        if (nowMs - req.ts > PENDING_TTL_MS) {
+            delete pendingById[id];
+        }
+    }
+}
+let lock = Promise.resolve();
+async function withLock(fn) {
+    const prev = lock;
+    let release;
+    lock = new Promise((resolve) => {
+        release = resolve;
+    });
+    await prev;
+    try {
+        return await fn();
+    }
+    finally {
+        release?.();
+    }
+}
+async function loadState(baseDir) {
+    const { pendingPath, pairedPath } = resolvePaths(baseDir);
+    const [pending, paired] = await Promise.all([
+        readJSON(pendingPath),
+        readJSON(pairedPath),
+    ]);
+    const state = {
+        pendingById: pending ?? {},
+        pairedByNodeId: paired ?? {},
+    };
+    pruneExpiredPending(state.pendingById, Date.now());
+    return state;
+}
+async function persistState(state, baseDir) {
+    const { pendingPath, pairedPath } = resolvePaths(baseDir);
+    await Promise.all([
+        writeJSONAtomic(pendingPath, state.pendingById),
+        writeJSONAtomic(pairedPath, state.pairedByNodeId),
+    ]);
+}
+function normalizeNodeId(nodeId) {
+    return nodeId.trim();
+}
+function newToken() {
+    return randomUUID().replaceAll("-", "");
+}
+export async function listNodePairing(baseDir) {
+    const state = await loadState(baseDir);
+    const pending = Object.values(state.pendingById).sort((a, b) => b.ts - a.ts);
+    const paired = Object.values(state.pairedByNodeId).sort((a, b) => b.approvedAtMs - a.approvedAtMs);
+    return { pending, paired };
+}
+export async function getPairedNode(nodeId, baseDir) {
+    const state = await loadState(baseDir);
+    return state.pairedByNodeId[normalizeNodeId(nodeId)] ?? null;
+}
+export async function requestNodePairing(req, baseDir) {
+    return await withLock(async () => {
+        const state = await loadState(baseDir);
+        const nodeId = normalizeNodeId(req.nodeId);
+        if (!nodeId) {
+            throw new Error("nodeId required");
+        }
+        const existing = Object.values(state.pendingById).find((p) => p.nodeId === nodeId);
+        if (existing) {
+            return { status: "pending", request: existing, created: false };
+        }
+        const isRepair = Boolean(state.pairedByNodeId[nodeId]);
+        const request = {
+            requestId: randomUUID(),
+            nodeId,
+            displayName: req.displayName,
+            platform: req.platform,
+            version: req.version,
+            coreVersion: req.coreVersion,
+            uiVersion: req.uiVersion,
+            deviceFamily: req.deviceFamily,
+            modelIdentifier: req.modelIdentifier,
+            caps: req.caps,
+            commands: req.commands,
+            permissions: req.permissions,
+            remoteIp: req.remoteIp,
+            silent: req.silent,
+            isRepair,
+            ts: Date.now(),
+        };
+        state.pendingById[request.requestId] = request;
+        await persistState(state, baseDir);
+        return { status: "pending", request, created: true };
+    });
+}
+export async function approveNodePairing(requestId, baseDir) {
+    return await withLock(async () => {
+        const state = await loadState(baseDir);
+        const pending = state.pendingById[requestId];
+        if (!pending)
+            return null;
+        const now = Date.now();
+        const existing = state.pairedByNodeId[pending.nodeId];
+        const node = {
+            nodeId: pending.nodeId,
+            token: newToken(),
+            displayName: pending.displayName,
+            platform: pending.platform,
+            version: pending.version,
+            coreVersion: pending.coreVersion,
+            uiVersion: pending.uiVersion,
+            deviceFamily: pending.deviceFamily,
+            modelIdentifier: pending.modelIdentifier,
+            caps: pending.caps,
+            commands: pending.commands,
+            permissions: pending.permissions,
+            remoteIp: pending.remoteIp,
+            createdAtMs: existing?.createdAtMs ?? now,
+            approvedAtMs: now,
+        };
+        delete state.pendingById[requestId];
+        state.pairedByNodeId[pending.nodeId] = node;
+        await persistState(state, baseDir);
+        return { requestId, node };
+    });
+}
+export async function rejectNodePairing(requestId, baseDir) {
+    return await withLock(async () => {
+        const state = await loadState(baseDir);
+        const pending = state.pendingById[requestId];
+        if (!pending)
+            return null;
+        delete state.pendingById[requestId];
+        await persistState(state, baseDir);
+        return { requestId, nodeId: pending.nodeId };
+    });
+}
+export async function verifyNodeToken(nodeId, token, baseDir) {
+    const state = await loadState(baseDir);
+    const normalized = normalizeNodeId(nodeId);
+    const node = state.pairedByNodeId[normalized];
+    if (!node)
+        return { ok: false };
+    return node.token === token ? { ok: true, node } : { ok: false };
+}
+export async function updatePairedNodeMetadata(nodeId, patch, baseDir) {
+    await withLock(async () => {
+        const state = await loadState(baseDir);
+        const normalized = normalizeNodeId(nodeId);
+        const existing = state.pairedByNodeId[normalized];
+        if (!existing)
+            return;
+        const next = {
+            ...existing,
+            displayName: patch.displayName ?? existing.displayName,
+            platform: patch.platform ?? existing.platform,
+            version: patch.version ?? existing.version,
+            coreVersion: patch.coreVersion ?? existing.coreVersion,
+            uiVersion: patch.uiVersion ?? existing.uiVersion,
+            deviceFamily: patch.deviceFamily ?? existing.deviceFamily,
+            modelIdentifier: patch.modelIdentifier ?? existing.modelIdentifier,
+            remoteIp: patch.remoteIp ?? existing.remoteIp,
+            caps: patch.caps ?? existing.caps,
+            commands: patch.commands ?? existing.commands,
+            bins: patch.bins ?? existing.bins,
+            permissions: patch.permissions ?? existing.permissions,
+            lastConnectedAtMs: patch.lastConnectedAtMs ?? existing.lastConnectedAtMs,
+        };
+        state.pairedByNodeId[normalized] = next;
+        await persistState(state, baseDir);
+    });
+}
+export async function renamePairedNode(nodeId, displayName, baseDir) {
+    return await withLock(async () => {
+        const state = await loadState(baseDir);
+        const normalized = normalizeNodeId(nodeId);
+        const existing = state.pairedByNodeId[normalized];
+        if (!existing)
+            return null;
+        const trimmed = displayName.trim();
+        if (!trimmed)
+            throw new Error("displayName required");
+        const next = { ...existing, displayName: trimmed };
+        state.pairedByNodeId[normalized] = next;
+        await persistState(state, baseDir);
+        return next;
+    });
+}
+//# sourceMappingURL=node-pairing.js.map

package/dist/infra/node-pairing.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"node-pairing.js","sourceRoot":"","sources":["../../src/infra/node-pairing.ts"],"names":[],"mappings":"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"}

package/dist/infra/node-shell.d.ts

@@ -0,0 +1,2 @@
+export declare function buildNodeShellCommand(command: string, platform?: string | null): string[];
+//# sourceMappingURL=node-shell.d.ts.map

package/dist/infra/node-shell.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"node-shell.d.ts","sourceRoot":"","sources":["../../src/infra/node-shell.ts"],"names":[],"mappings":"AAAA,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,MAAM,GAAG,IAAI,YAQ9E"}

package/dist/infra/node-shell.js

@@ -0,0 +1,10 @@
+export function buildNodeShellCommand(command, platform) {
+    const normalized = String(platform ?? "")
+        .trim()
+        .toLowerCase();
+    if (normalized.startsWith("win")) {
+        return ["cmd.exe", "/d", "/s", "/c", command];
+    }
+    return ["/bin/sh", "-lc", command];
+}
+//# sourceMappingURL=node-shell.js.map

package/dist/infra/node-shell.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"node-shell.js","sourceRoot":"","sources":["../../src/infra/node-shell.ts"],"names":[],"mappings":"AAAA,MAAM,UAAU,qBAAqB,CAAC,OAAe,EAAE,QAAwB;IAC7E,MAAM,UAAU,GAAG,MAAM,CAAC,QAAQ,IAAI,EAAE,CAAC;SACtC,IAAI,EAAE;SACN,WAAW,EAAE,CAAC;IACjB,IAAI,UAAU,CAAC,UAAU,CAAC,KAAK,CAAC,EAAE,CAAC;QACjC,OAAO,CAAC,SAAS,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,OAAO,CAAC,CAAC;IAChD,CAAC;IACD,OAAO,CAAC,SAAS,EAAE,KAAK,EAAE,OAAO,CAAC,CAAC;AACrC,CAAC"}

package/dist/infra/openclaw-root.d.ts

@@ -0,0 +1,6 @@
+export declare function resolveOpenClawPackageRoot(opts: {
+    cwd?: string;
+    argv1?: string;
+    moduleUrl?: string;
+}): Promise<string | null>;
+//# sourceMappingURL=openclaw-root.d.ts.map

package/dist/infra/openclaw-root.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"openclaw-root.d.ts","sourceRoot":"","sources":["../../src/infra/openclaw-root.ts"],"names":[],"mappings":"AAyCA,wBAAsB,0BAA0B,CAAC,IAAI,EAAE;IACrD,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAmBzB"}

package/dist/infra/openclaw-root.js

@@ -0,0 +1,58 @@
+import fs from "node:fs/promises";
+import path from "node:path";
+import { fileURLToPath } from "node:url";
+const CORE_PACKAGE_NAMES = new Set(["openclaw"]);
+async function readPackageName(dir) {
+    try {
+        const raw = await fs.readFile(path.join(dir, "package.json"), "utf-8");
+        const parsed = JSON.parse(raw);
+        return typeof parsed.name === "string" ? parsed.name : null;
+    }
+    catch {
+        return null;
+    }
+}
+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))
+            return current;
+        const parent = path.dirname(current);
+        if (parent === current)
+            break;
+        current = parent;
+    }
+    return null;
+}
+function candidateDirsFromArgv1(argv1) {
+    const normalized = path.resolve(argv1);
+    const candidates = [path.dirname(normalized)];
+    const parts = normalized.split(path.sep);
+    const binIndex = parts.lastIndexOf(".bin");
+    if (binIndex > 0 && parts[binIndex - 1] === "node_modules") {
+        const binName = path.basename(normalized);
+        const nodeModulesDir = parts.slice(0, binIndex).join(path.sep);
+        candidates.push(path.join(nodeModulesDir, binName));
+    }
+    return candidates;
+}
+export async function resolveOpenClawPackageRoot(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) {
+        const found = await findPackageRoot(candidate);
+        if (found)
+            return found;
+    }
+    return null;
+}
+//# sourceMappingURL=openclaw-root.js.map

package/dist/infra/openclaw-root.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"openclaw-root.js","sourceRoot":"","sources":["../../src/infra/openclaw-root.ts"],"names":[],"mappings":"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"}

package/dist/infra/os-summary.d.ts

@@ -0,0 +1,8 @@
+export type OsSummary = {
+    platform: NodeJS.Platform;
+    arch: string;
+    release: string;
+    label: string;
+};
+export declare function resolveOsSummary(): OsSummary;
+//# sourceMappingURL=os-summary.d.ts.map

package/dist/infra/os-summary.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"os-summary.d.ts","sourceRoot":"","sources":["../../src/infra/os-summary.ts"],"names":[],"mappings":"AAGA,MAAM,MAAM,SAAS,GAAG;IACtB,QAAQ,EAAE,MAAM,CAAC,QAAQ,CAAC;IAC1B,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,MAAM,CAAC;CACf,CAAC;AAYF,wBAAgB,gBAAgB,IAAI,SAAS,CAU5C"}

package/dist/infra/os-summary.js

@@ -0,0 +1,24 @@
+import { spawnSync } from "node:child_process";
+import os from "node:os";
+function safeTrim(value) {
+    return typeof value === "string" ? value.trim() : "";
+}
+function macosVersion() {
+    const res = spawnSync("sw_vers", ["-productVersion"], { encoding: "utf-8" });
+    const out = safeTrim(res.stdout);
+    return out || os.release();
+}
+export function resolveOsSummary() {
+    const platform = os.platform();
+    const release = os.release();
+    const arch = os.arch();
+    const label = (() => {
+        if (platform === "darwin")
+            return `macos ${macosVersion()} (${arch})`;
+        if (platform === "win32")
+            return `windows ${release} (${arch})`;
+        return `${platform} ${release} (${arch})`;
+    })();
+    return { platform, arch, release, label };
+}
+//# sourceMappingURL=os-summary.js.map

package/dist/infra/os-summary.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"os-summary.js","sourceRoot":"","sources":["../../src/infra/os-summary.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,oBAAoB,CAAC;AAC/C,OAAO,EAAE,MAAM,SAAS,CAAC;AASzB,SAAS,QAAQ,CAAC,KAAc;IAC9B,OAAO,OAAO,KAAK,KAAK,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;AACvD,CAAC;AAED,SAAS,YAAY;IACnB,MAAM,GAAG,GAAG,SAAS,CAAC,SAAS,EAAE,CAAC,iBAAiB,CAAC,EAAE,EAAE,QAAQ,EAAE,OAAO,EAAE,CAAC,CAAC;IAC7E,MAAM,GAAG,GAAG,QAAQ,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;IACjC,OAAO,GAAG,IAAI,EAAE,CAAC,OAAO,EAAE,CAAC;AAC7B,CAAC;AAED,MAAM,UAAU,gBAAgB;IAC9B,MAAM,QAAQ,GAAG,EAAE,CAAC,QAAQ,EAAE,CAAC;IAC/B,MAAM,OAAO,GAAG,EAAE,CAAC,OAAO,EAAE,CAAC;IAC7B,MAAM,IAAI,GAAG,EAAE,CAAC,IAAI,EAAE,CAAC;IACvB,MAAM,KAAK,GAAG,CAAC,GAAG,EAAE;QAClB,IAAI,QAAQ,KAAK,QAAQ;YAAE,OAAO,SAAS,YAAY,EAAE,KAAK,IAAI,GAAG,CAAC;QACtE,IAAI,QAAQ,KAAK,OAAO;YAAE,OAAO,WAAW,OAAO,KAAK,IAAI,GAAG,CAAC;QAChE,OAAO,GAAG,QAAQ,IAAI,OAAO,KAAK,IAAI,GAAG,CAAC;IAC5C,CAAC,CAAC,EAAE,CAAC;IACL,OAAO,EAAE,QAAQ,EAAE,IAAI,EAAE,OAAO,EAAE,KAAK,EAAE,CAAC;AAC5C,CAAC"}

package/dist/infra/path-env.d.ts

@@ -0,0 +1,14 @@
+type EnsureOpenClawPathOpts = {
+    execPath?: string;
+    cwd?: string;
+    homeDir?: string;
+    platform?: NodeJS.Platform;
+    pathEnv?: string;
+};
+/**
+ * Best-effort PATH bootstrap so skills that require the `openclaw` CLI can run
+ * under launchd/minimal environments (and inside the macOS app bundle).
+ */
+export declare function ensureOpenClawCliOnPath(opts?: EnsureOpenClawPathOpts): void;
+export {};
+//# sourceMappingURL=path-env.d.ts.map

package/dist/infra/path-env.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"path-env.d.ts","sourceRoot":"","sources":["../../src/infra/path-env.ts"],"names":[],"mappings":"AAOA,KAAK,sBAAsB,GAAG;IAC5B,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,QAAQ,CAAC,EAAE,MAAM,CAAC,QAAQ,CAAC;IAC3B,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB,CAAC;AA+EF;;;GAGG;AACH,wBAAgB,uBAAuB,CAAC,IAAI,GAAE,sBAA2B,QAYxE"}

package/dist/infra/path-env.js

@@ -0,0 +1,95 @@
+import fs from "node:fs";
+import os from "node:os";
+import path from "node:path";
+import { isTruthyEnvValue } from "./env.js";
+import { resolveBrewPathDirs } from "./brew.js";
+function isExecutable(filePath) {
+    try {
+        fs.accessSync(filePath, fs.constants.X_OK);
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+function isDirectory(dirPath) {
+    try {
+        return fs.statSync(dirPath).isDirectory();
+    }
+    catch {
+        return false;
+    }
+}
+function mergePath(params) {
+    const partsExisting = params.existing
+        .split(path.delimiter)
+        .map((part) => part.trim())
+        .filter(Boolean);
+    const partsPrepend = params.prepend.map((part) => part.trim()).filter(Boolean);
+    const seen = new Set();
+    const merged = [];
+    for (const part of [...partsPrepend, ...partsExisting]) {
+        if (!seen.has(part)) {
+            seen.add(part);
+            merged.push(part);
+        }
+    }
+    return merged.join(path.delimiter);
+}
+function candidateBinDirs(opts) {
+    const execPath = opts.execPath ?? process.execPath;
+    const cwd = opts.cwd ?? process.cwd();
+    const homeDir = opts.homeDir ?? os.homedir();
+    const platform = opts.platform ?? process.platform;
+    const candidates = [];
+    // Bundled macOS app: `openclaw` lives next to the executable (process.execPath).
+    try {
+        const execDir = path.dirname(execPath);
+        const siblingCli = path.join(execDir, "openclaw");
+        if (isExecutable(siblingCli))
+            candidates.push(execDir);
+    }
+    catch {
+        // ignore
+    }
+    // Project-local installs (best effort): if a `node_modules/.bin/openclaw` exists near cwd,
+    // include it. This helps when running under launchd or other minimal PATH environments.
+    const localBinDir = path.join(cwd, "node_modules", ".bin");
+    if (isExecutable(path.join(localBinDir, "openclaw")))
+        candidates.push(localBinDir);
+    const miseDataDir = process.env.MISE_DATA_DIR ?? path.join(homeDir, ".local", "share", "mise");
+    const miseShims = path.join(miseDataDir, "shims");
+    if (isDirectory(miseShims))
+        candidates.push(miseShims);
+    candidates.push(...resolveBrewPathDirs({ homeDir }));
+    // Common global install locations (macOS first).
+    if (platform === "darwin") {
+        candidates.push(path.join(homeDir, "Library", "pnpm"));
+    }
+    if (process.env.XDG_BIN_HOME)
+        candidates.push(process.env.XDG_BIN_HOME);
+    candidates.push(path.join(homeDir, ".local", "bin"));
+    candidates.push(path.join(homeDir, ".local", "share", "pnpm"));
+    candidates.push(path.join(homeDir, ".bun", "bin"));
+    candidates.push(path.join(homeDir, ".yarn", "bin"));
+    candidates.push("/opt/homebrew/bin", "/usr/local/bin", "/usr/bin", "/bin");
+    return candidates.filter(isDirectory);
+}
+/**
+ * Best-effort PATH bootstrap so skills that require the `openclaw` CLI can run
+ * under launchd/minimal environments (and inside the macOS app bundle).
+ */
+export function ensureOpenClawCliOnPath(opts = {}) {
+    if (isTruthyEnvValue(process.env.OPENCLAW_PATH_BOOTSTRAPPED)) {
+        return;
+    }
+    process.env.OPENCLAW_PATH_BOOTSTRAPPED = "1";
+    const existing = opts.pathEnv ?? process.env.PATH ?? "";
+    const prepend = candidateBinDirs(opts);
+    if (prepend.length === 0)
+        return;
+    const merged = mergePath({ existing, prepend });
+    if (merged)
+        process.env.PATH = merged;
+}
+//# sourceMappingURL=path-env.js.map

package/dist/infra/path-env.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"path-env.js","sourceRoot":"","sources":["../../src/infra/path-env.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,SAAS,CAAC;AACzB,OAAO,EAAE,MAAM,SAAS,CAAC;AACzB,OAAO,IAAI,MAAM,WAAW,CAAC;AAC7B,OAAO,EAAE,gBAAgB,EAAE,MAAM,UAAU,CAAC;AAE5C,OAAO,EAAE,mBAAmB,EAAE,MAAM,WAAW,CAAC;AAUhD,SAAS,YAAY,CAAC,QAAgB;IACpC,IAAI,CAAC;QACH,EAAE,CAAC,UAAU,CAAC,QAAQ,EAAE,EAAE,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC;QAC3C,OAAO,IAAI,CAAC;IACd,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,KAAK,CAAC;IACf,CAAC;AACH,CAAC;AAED,SAAS,WAAW,CAAC,OAAe;IAClC,IAAI,CAAC;QACH,OAAO,EAAE,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC,WAAW,EAAE,CAAC;IAC5C,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,KAAK,CAAC;IACf,CAAC;AACH,CAAC;AAED,SAAS,SAAS,CAAC,MAA+C;IAChE,MAAM,aAAa,GAAG,MAAM,CAAC,QAAQ;SAClC,KAAK,CAAC,IAAI,CAAC,SAAS,CAAC;SACrB,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC;SAC1B,MAAM,CAAC,OAAO,CAAC,CAAC;IACnB,MAAM,YAAY,GAAG,MAAM,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;IAE/E,MAAM,IAAI,GAAG,IAAI,GAAG,EAAU,CAAC;IAC/B,MAAM,MAAM,GAAa,EAAE,CAAC;IAC5B,KAAK,MAAM,IAAI,IAAI,CAAC,GAAG,YAAY,EAAE,GAAG,aAAa,CAAC,EAAE,CAAC;QACvD,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC;YACpB,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;YACf,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACpB,CAAC;IACH,CAAC;IACD,OAAO,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;AACrC,CAAC;AAED,SAAS,gBAAgB,CAAC,IAA4B;IACpD,MAAM,QAAQ,GAAG,IAAI,CAAC,QAAQ,IAAI,OAAO,CAAC,QAAQ,CAAC;IACnD,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,IAAI,OAAO,CAAC,GAAG,EAAE,CAAC;IACtC,MAAM,OAAO,GAAG,IAAI,CAAC,OAAO,IAAI,EAAE,CAAC,OAAO,EAAE,CAAC;IAC7C,MAAM,QAAQ,GAAG,IAAI,CAAC,QAAQ,IAAI,OAAO,CAAC,QAAQ,CAAC;IAEnD,MAAM,UAAU,GAAa,EAAE,CAAC;IAEhC,iFAAiF;IACjF,IAAI,CAAC;QACH,MAAM,OAAO,GAAG,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC;QACvC,MAAM,UAAU,GAAG,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,UAAU,CAAC,CAAC;QAClD,IAAI,YAAY,CAAC,UAAU,CAAC;YAAE,UAAU,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;IACzD,CAAC;IAAC,MAAM,CAAC;QACP,SAAS;IACX,CAAC;IAED,2FAA2F;IAC3F,wFAAwF;IACxF,MAAM,WAAW,GAAG,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,cAAc,EAAE,MAAM,CAAC,CAAC;IAC3D,IAAI,YAAY,CAAC,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,UAAU,CAAC,CAAC;QAAE,UAAU,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC;IAEnF,MAAM,WAAW,GAAG,OAAO,CAAC,GAAG,CAAC,aAAa,IAAI,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,QAAQ,EAAE,OAAO,EAAE,MAAM,CAAC,CAAC;IAC/F,MAAM,SAAS,GAAG,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,OAAO,CAAC,CAAC;IAClD,IAAI,WAAW,CAAC,SAAS,CAAC;QAAE,UAAU,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;IAEvD,UAAU,CAAC,IAAI,CAAC,GAAG,mBAAmB,CAAC,EAAE,OAAO,EAAE,CAAC,CAAC,CAAC;IAErD,iDAAiD;IACjD,IAAI,QAAQ,KAAK,QAAQ,EAAE,CAAC;QAC1B,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,SAAS,EAAE,MAAM,CAAC,CAAC,CAAC;IACzD,CAAC;IACD,IAAI,OAAO,CAAC,GAAG,CAAC,YAAY;QAAE,UAAU,CAAC,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,YAAY,CAAC,CAAC;IACxE,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,QAAQ,EAAE,KAAK,CAAC,CAAC,CAAC;IACrD,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,QAAQ,EAAE,OAAO,EAAE,MAAM,CAAC,CAAC,CAAC;IAC/D,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,CAAC,CAAC,CAAC;IACnD,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,OAAO,EAAE,KAAK,CAAC,CAAC,CAAC;IACpD,UAAU,CAAC,IAAI,CAAC,mBAAmB,EAAE,gBAAgB,EAAE,UAAU,EAAE,MAAM,CAAC,CAAC;IAE3E,OAAO,UAAU,CAAC,MAAM,CAAC,WAAW,CAAC,CAAC;AACxC,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,uBAAuB,CAAC,OAA+B,EAAE;IACvE,IAAI,gBAAgB,CAAC,OAAO,CAAC,GAAG,CAAC,0BAA0B,CAAC,EAAE,CAAC;QAC7D,OAAO;IACT,CAAC;IACD,OAAO,CAAC,GAAG,CAAC,0BAA0B,GAAG,GAAG,CAAC;IAE7C,MAAM,QAAQ,GAAG,IAAI,CAAC,OAAO,IAAI,OAAO,CAAC,GAAG,CAAC,IAAI,IAAI,EAAE,CAAC;IACxD,MAAM,OAAO,GAAG,gBAAgB,CAAC,IAAI,CAAC,CAAC;IACvC,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO;IAEjC,MAAM,MAAM,GAAG,SAAS,CAAC,EAAE,QAAQ,EAAE,OAAO,EAAE,CAAC,CAAC;IAChD,IAAI,MAAM;QAAE,OAAO,CAAC,GAAG,CAAC,IAAI,GAAG,MAAM,CAAC;AACxC,CAAC"}

package/dist/infra/ports-format.d.ts

@@ -0,0 +1,6 @@
+import type { PortListener, PortListenerKind, PortUsage } from "./ports-types.js";
+export declare function classifyPortListener(listener: PortListener, port: number): PortListenerKind;
+export declare function buildPortHints(listeners: PortListener[], port: number): string[];
+export declare function formatPortListener(listener: PortListener): string;
+export declare function formatPortDiagnostics(diagnostics: PortUsage): string[];
+//# sourceMappingURL=ports-format.d.ts.map

package/dist/infra/ports-format.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ports-format.d.ts","sourceRoot":"","sources":["../../src/infra/ports-format.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,YAAY,EAAE,gBAAgB,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAElF,wBAAgB,oBAAoB,CAAC,QAAQ,EAAE,YAAY,EAAE,IAAI,EAAE,MAAM,GAAG,gBAAgB,CAc3F;AAED,wBAAgB,cAAc,CAAC,SAAS,EAAE,YAAY,EAAE,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,EAAE,CAuBhF;AAED,wBAAgB,kBAAkB,CAAC,QAAQ,EAAE,YAAY,GAAG,MAAM,CAMjE;AAED,wBAAgB,qBAAqB,CAAC,WAAW,EAAE,SAAS,GAAG,MAAM,EAAE,CAYtE"}

package/dist/infra/ports-format.js

@@ -0,0 +1,55 @@
+import { formatCliCommand } from "../cli/command-format.js";
+export function classifyPortListener(listener, port) {
+    const raw = `${listener.commandLine ?? ""} ${listener.command ?? ""}`.trim().toLowerCase();
+    if (raw.includes("openclaw")) {
+        return "gateway";
+    }
+    if (raw.includes("ssh")) {
+        const portToken = String(port);
+        const tunnelPattern = new RegExp(`-(l|r)\\s*${portToken}\\b|-(l|r)${portToken}\\b|:${portToken}\\b`);
+        if (!raw || tunnelPattern.test(raw))
+            return "ssh";
+        return "ssh";
+    }
+    return "unknown";
+}
+export function buildPortHints(listeners, port) {
+    if (listeners.length === 0)
+        return [];
+    const kinds = new Set(listeners.map((listener) => classifyPortListener(listener, port)));
+    const hints = [];
+    if (kinds.has("gateway")) {
+        hints.push(`Gateway already running locally. Stop it (${formatCliCommand("openclaw gateway stop")}) or use a different port.`);
+    }
+    if (kinds.has("ssh")) {
+        hints.push("SSH tunnel already bound to this port. Close the tunnel or use a different local port in -L.");
+    }
+    if (kinds.has("unknown")) {
+        hints.push("Another process is listening on this port.");
+    }
+    if (listeners.length > 1) {
+        hints.push("Multiple listeners detected; ensure only one gateway/tunnel per port unless intentionally running isolated profiles.");
+    }
+    return hints;
+}
+export function formatPortListener(listener) {
+    const pid = listener.pid ? `pid ${listener.pid}` : "pid ?";
+    const user = listener.user ? ` ${listener.user}` : "";
+    const command = listener.commandLine || listener.command || "unknown";
+    const address = listener.address ? ` (${listener.address})` : "";
+    return `${pid}${user}: ${command}${address}`;
+}
+export function formatPortDiagnostics(diagnostics) {
+    if (diagnostics.status !== "busy") {
+        return [`Port ${diagnostics.port} is free.`];
+    }
+    const lines = [`Port ${diagnostics.port} is already in use.`];
+    for (const listener of diagnostics.listeners) {
+        lines.push(`- ${formatPortListener(listener)}`);
+    }
+    for (const hint of diagnostics.hints) {
+        lines.push(`- ${hint}`);
+    }
+    return lines;
+}
+//# sourceMappingURL=ports-format.js.map

package/dist/infra/ports-format.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ports-format.js","sourceRoot":"","sources":["../../src/infra/ports-format.ts"],"names":[],"mappings":"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"}

package/dist/infra/ports-inspect.d.ts

@@ -0,0 +1,3 @@
+import type { PortUsage } from "./ports-types.js";
+export declare function inspectPortUsage(port: number): Promise<PortUsage>;
+//# sourceMappingURL=ports-inspect.d.ts.map

package/dist/infra/ports-inspect.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ports-inspect.d.ts","sourceRoot":"","sources":["../../src/infra/ports-inspect.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAgB,SAAS,EAAmB,MAAM,kBAAkB,CAAC;AAgNjF,wBAAsB,gBAAgB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,SAAS,CAAC,CA2BvE"}