@nordbyte/nordrelay 0.3.1 → 0.4.1

package/dist/openclaw-state.js

@@ -0,0 +1,409 @@
+import { spawnSync } from "node:child_process";
+import os from "node:os";
+import path from "node:path";
+export function getDefaultOpenClawHome() {
+    return path.join(os.homedir(), ".openclaw");
+}
+export function resolveOpenClawStateDir(options = {}) {
+    return options.stateDir
+        ?? process.env.OPENCLAW_STATE_DIR
+        ?? options.openClawHome
+        ?? process.env.OPENCLAW_HOME
+        ?? getDefaultOpenClawHome();
+}
+export function listOpenClawSessions(limit = 20, options = {}) {
+    const payload = options.sessionsJson ?? readOpenClawSessionsJson(limit, options);
+    return parseOpenClawSessionsPayload(payload, options)
+        .sort((left, right) => right.updatedAt.getTime() - left.updatedAt.getTime())
+        .slice(0, Math.max(1, limit));
+}
+export function getOpenClawSession(id, options = {}) {
+    const normalized = id.trim();
+    if (!normalized) {
+        return null;
+    }
+    const sessions = listOpenClawSessions(500, options);
+    return sessions.find((record) => record.id === normalized || record.sessionKey === normalized)
+        ?? sessions.find((record) => record.id.startsWith(normalized) || record.sessionKey.startsWith(normalized))
+        ?? null;
+}
+export function listOpenClawWorkspaces(options = {}) {
+    const workspaces = new Set();
+    for (const record of listOpenClawSessions(500, options)) {
+        if (record.cwd) {
+            workspaces.add(record.cwd);
+        }
+    }
+    if (options.workspace) {
+        workspaces.add(options.workspace);
+    }
+    return [...workspaces].sort((left, right) => left.localeCompare(right));
+}
+export function getOpenClawSessionActivity(id, options = {}) {
+    return getOpenClawSessionSnapshot(id, { ...options, maxEvents: 0 })?.activity ?? null;
+}
+export function getOpenClawSessionActivityLog(id, limit = 50, options = {}) {
+    return getOpenClawSessionSnapshot(id, { ...options, maxEvents: Math.max(1, limit) })?.events ?? [];
+}
+export function getOpenClawSessionSnapshot(id, options = {}) {
+    const record = getOpenClawSession(id, options);
+    if (!record) {
+        return null;
+    }
+    const events = parseOpenClawActivityEvents(record, options.afterLine ?? 0);
+    const latestUser = [...events].reverse().find((event) => event.kind === "user");
+    const latestAgent = [...events].reverse().find((event) => event.kind === "agent");
+    const latestTerminal = [...events].reverse().find((event) => event.kind === "task" && event.status && event.status !== "started");
+    const latestTool = [...events].reverse().find((event) => event.kind === "tool" && event.toolName);
+    const latestTimestamp = events.at(-1)?.timestamp ?? record.updatedAt;
+    const staleAfterMs = options.staleAfterMs ?? 5 * 60 * 1000;
+    const nowMs = options.nowMs ?? Date.now();
+    const stale = Boolean(record.active && latestTimestamp && nowMs - latestTimestamp.getTime() > staleAfterMs);
+    const maxEvents = options.maxEvents ?? 50;
+    const lineCount = Math.max(events.length, record.active ? 1 : 0);
+    const returnedEvents = maxEvents <= 0 ? [] : events.slice(-maxEvents);
+    return {
+        agentId: "openclaw",
+        agentLabel: "OpenClaw",
+        threadId: record.id,
+        sourcePath: record.sessionPath ?? sourcePath(options),
+        sourceLabel: "OpenClaw sessions",
+        lineCount,
+        activity: {
+            agentId: "openclaw",
+            agentLabel: "OpenClaw",
+            threadId: record.id,
+            sourcePath: record.sessionPath ?? sourcePath(options),
+            sourceLabel: "OpenClaw sessions",
+            active: record.active && !stale,
+            stale,
+            turnId: latestUser?.turnId ?? latestTerminal?.turnId ?? record.id,
+            startedAt: latestUser?.timestamp ?? (record.active ? record.updatedAt : null),
+            updatedAt: latestTimestamp,
+        },
+        events: returnedEvents,
+        latestAgentMessage: latestAgent?.text ?? null,
+        latestUserMessage: latestUser?.text ?? record.firstUserMessage,
+        latestToolName: latestTool?.toolName ?? null,
+    };
+}
+export function getOpenClawSessionDiagnostics(id, options = {}) {
+    const source = sourcePath(options);
+    if (!id) {
+        return {
+            sourcePath: source,
+            status: "unavailable",
+            reason: "no active OpenClaw session",
+            lineCount: 0,
+            updatedAt: null,
+        };
+    }
+    const snapshot = getOpenClawSessionSnapshot(id, { ...options, maxEvents: 0 });
+    if (!snapshot) {
+        return {
+            sourcePath: source,
+            status: "unavailable",
+            reason: "OpenClaw session not found",
+            lineCount: 0,
+            updatedAt: null,
+        };
+    }
+    const status = snapshot.activity.active ? "active" : snapshot.activity.stale ? "stale" : "idle";
+    const reason = snapshot.activity.active
+        ? "OpenClaw session reports an active run"
+        : snapshot.activity.stale
+            ? "OpenClaw active run exceeded stale timeout"
+            : "OpenClaw session is idle";
+    return {
+        sourcePath: snapshot.sourcePath,
+        status,
+        reason,
+        lineCount: snapshot.lineCount,
+        updatedAt: snapshot.activity.updatedAt,
+    };
+}
+export function parseOpenClawSessionsPayload(payload, options = {}) {
+    const root = objectValue(payload);
+    const storePaths = new Map();
+    for (const store of arrayValue(root?.stores)) {
+        const storeObject = objectValue(store);
+        const agentId = stringValue(storeObject?.agentId) ?? stringValue(storeObject?.agent_id);
+        const storePath = stringValue(storeObject?.path) ?? stringValue(storeObject?.storePath);
+        if (agentId && storePath) {
+            storePaths.set(agentId, storePath);
+        }
+    }
+    const sessions = arrayValue(root?.sessions ?? payload);
+    return sessions
+        .map((entry) => mapOpenClawSession(entry, options, storePaths))
+        .filter((record) => Boolean(record));
+}
+function readOpenClawSessionsJson(limit, options) {
+    const cliPath = options.cliPath ?? process.env.OPENCLAW_CLI_PATH ?? "openclaw";
+    const args = ["sessions", "--all-agents", "--limit", String(Math.max(1, limit)), "--json"];
+    const result = spawnSync(cliPath, args, {
+        encoding: "utf8",
+        timeout: 5000,
+        windowsHide: true,
+        env: process.env,
+    });
+    if (result.error || result.status !== 0) {
+        return { sessions: [] };
+    }
+    try {
+        return JSON.parse(result.stdout.trim() || "{}");
+    }
+    catch {
+        return { sessions: [] };
+    }
+}
+function mapOpenClawSession(raw, options, storePaths) {
+    const object = objectValue(raw);
+    if (!object) {
+        return null;
+    }
+    const key = stringValue(object.key)
+        ?? stringValue(object.sessionKey)
+        ?? stringValue(object.session_key)
+        ?? stringValue(object.id)
+        ?? stringValue(object.sessionId)
+        ?? stringValue(object.session_id);
+    if (!key) {
+        return null;
+    }
+    const id = stringValue(object.id)
+        ?? stringValue(object.sessionId)
+        ?? stringValue(object.session_id)
+        ?? key;
+    const openClawAgentId = stringValue(object.agentId)
+        ?? stringValue(object.agent_id)
+        ?? parseAgentFromSessionKey(key)
+        ?? options.openClawAgentId
+        ?? null;
+    const sessionPath = stringValue(object.path)
+        ?? stringValue(object.storePath)
+        ?? stringValue(object.store_path)
+        ?? (openClawAgentId ? storePaths.get(openClawAgentId) : undefined);
+    const workspace = stringValue(object.workspace)
+        ?? stringValue(object.cwd)
+        ?? workspaceFromSource(stringValue(object.source))
+        ?? options.workspace
+        ?? process.cwd();
+    const createdAt = dateValue(object.createdAt)
+        ?? dateValue(object.created_at)
+        ?? dateValue(object.startedAt)
+        ?? dateValue(object.started_at)
+        ?? new Date();
+    const updatedAt = dateValue(object.updatedAt)
+        ?? dateValue(object.updated_at)
+        ?? dateValue(object.lastActive)
+        ?? dateValue(object.last_active)
+        ?? dateValue(object.endedAt)
+        ?? dateValue(object.ended_at)
+        ?? createdAt;
+    const firstUserMessage = stringValue(object.firstUserMessage)
+        ?? stringValue(object.first_user_message)
+        ?? firstMessageText(object);
+    const status = stringValue(object.status);
+    const active = booleanValue(object.active)
+        ?? booleanValue(object.running)
+        ?? booleanValue(object.inProgress)
+        ?? booleanValue(object.in_progress)
+        ?? booleanValue(object.isRunning)
+        ?? statusIsActive(status);
+    return {
+        id,
+        sessionKey: key,
+        title: stringValue(object.title),
+        cwd: workspace,
+        model: stringValue(object.model),
+        reasoningEffort: stringValue(object.thinking)
+            ?? stringValue(object.thinkingLevel)
+            ?? stringValue(object.thinking_level)
+            ?? stringValue(object.reasoningEffort)
+            ?? stringValue(object.reasoning_effort),
+        createdAt,
+        updatedAt,
+        firstUserMessage,
+        agentId: "openclaw",
+        sessionPath,
+        openClawAgentId,
+        status,
+        active,
+        usage: usageFromSession(object),
+        raw,
+    };
+}
+function parseOpenClawActivityEvents(record, afterLine) {
+    const raw = objectValue(record.raw);
+    const sourceEvents = arrayValue(raw?.events ?? raw?.messages ?? raw?.turns ?? raw?.transcript);
+    const events = [];
+    let lineNumber = 0;
+    if (record.active) {
+        lineNumber += 1;
+        events.push({
+            lineNumber,
+            kind: "task",
+            timestamp: record.updatedAt,
+            type: "run",
+            turnId: record.id,
+            status: "started",
+            text: record.status,
+            toolName: null,
+            phase: null,
+        });
+    }
+    for (const event of sourceEvents) {
+        const object = objectValue(event);
+        if (!object)
+            continue;
+        lineNumber += 1;
+        const parsed = mapActivityObject(object, lineNumber, record.id);
+        if (parsed)
+            events.push(parsed);
+    }
+    if (!record.active && events.some((event) => event.kind === "user") && !events.some((event) => event.kind === "task" && event.status !== "started")) {
+        lineNumber += 1;
+        events.push({
+            lineNumber,
+            kind: "task",
+            timestamp: record.updatedAt,
+            type: "run",
+            turnId: record.id,
+            status: statusIsFailure(record.status) ? "failed" : "completed",
+            text: record.status,
+            toolName: null,
+            phase: null,
+        });
+    }
+    if (events.length === 0 && record.firstUserMessage) {
+        events.push({
+            lineNumber: 1,
+            kind: "user",
+            timestamp: record.createdAt,
+            type: "message",
+            turnId: record.id,
+            status: null,
+            text: record.firstUserMessage,
+            toolName: null,
+            phase: null,
+        });
+    }
+    return events.filter((event) => event.lineNumber > afterLine);
+}
+function mapActivityObject(object, lineNumber, fallbackTurnId) {
+    const role = stringValue(object.role)?.toLowerCase();
+    const type = stringValue(object.type) ?? stringValue(object.event) ?? role ?? "message";
+    const status = stringValue(object.status);
+    const timestamp = dateValue(object.timestamp) ?? dateValue(object.createdAt) ?? dateValue(object.created_at);
+    const text = stringValue(object.text)
+        ?? stringValue(object.content)
+        ?? stringValue(object.message)
+        ?? stringValue(object.summary);
+    const toolName = stringValue(object.toolName)
+        ?? stringValue(object.tool_name)
+        ?? stringValue(object.name)
+        ?? stringValue(object.tool);
+    const turnId = stringValue(object.turnId) ?? stringValue(object.turn_id) ?? stringValue(object.runId) ?? fallbackTurnId;
+    if (role === "user") {
+        return { lineNumber, kind: "user", timestamp, type, turnId, status, text, toolName: null, phase: null };
+    }
+    if (role === "assistant" || role === "agent") {
+        return { lineNumber, kind: "agent", timestamp, type, turnId, status, text, toolName: null, phase: stringValue(object.phase) };
+    }
+    if (role === "tool" || toolName || type.includes("tool")) {
+        return {
+            lineNumber,
+            kind: "tool",
+            timestamp,
+            type,
+            turnId,
+            status: status === "completed" ? "finished" : status ?? (type.includes("start") ? "started" : "finished"),
+            text,
+            toolName: toolName ?? "tool",
+            phase: null,
+        };
+    }
+    if (type.includes("run") || type.includes("task")) {
+        return { lineNumber, kind: "task", timestamp, type, turnId, status, text, toolName: null, phase: null };
+    }
+    return text ? { lineNumber, kind: "agent", timestamp, type, turnId, status, text, toolName: null, phase: null } : null;
+}
+function sourcePath(options) {
+    return path.join(resolveOpenClawStateDir(options), "sessions");
+}
+function parseAgentFromSessionKey(key) {
+    const match = key.match(/^agent:([^:]+):/);
+    return match?.[1] ?? null;
+}
+function workspaceFromSource(source) {
+    if (!source)
+        return null;
+    if (path.isAbsolute(source))
+        return source;
+    const match = source.match(/(?:cwd|workspace)=([^,;]+)/i);
+    return match && path.isAbsolute(match[1]) ? match[1] : null;
+}
+function firstMessageText(object) {
+    for (const entry of arrayValue(object.messages ?? object.transcript ?? object.events)) {
+        const row = objectValue(entry);
+        if (stringValue(row?.role)?.toLowerCase() === "user") {
+            return stringValue(row?.text) ?? stringValue(row?.content) ?? stringValue(row?.message);
+        }
+    }
+    return null;
+}
+function usageFromSession(object) {
+    const usage = objectValue(object.usage) ?? object;
+    const input = numberValue(usage.input) ?? numberValue(usage.inputTokens) ?? numberValue(usage.input_tokens) ?? 0;
+    const output = numberValue(usage.output) ?? numberValue(usage.outputTokens) ?? numberValue(usage.output_tokens) ?? 0;
+    const cacheRead = numberValue(usage.cacheRead) ?? numberValue(usage.cache_read_tokens) ?? 0;
+    const cacheWrite = numberValue(usage.cacheWrite) ?? numberValue(usage.cache_write_tokens) ?? 0;
+    const total = input + output + cacheRead + cacheWrite;
+    if (total <= 0) {
+        return undefined;
+    }
+    return {
+        input,
+        output,
+        cacheRead,
+        cacheWrite,
+        total,
+        cost: numberValue(usage.cost) ?? numberValue(usage.estimated_cost_usd) ?? undefined,
+    };
+}
+function statusIsActive(status) {
+    return Boolean(status && /^(active|running|processing|queued|pending|accepted)$/i.test(status));
+}
+function statusIsFailure(status) {
+    return Boolean(status && /^(failed|error)$/i.test(status));
+}
+function arrayValue(value) {
+    return Array.isArray(value) ? value : [];
+}
+function objectValue(value) {
+    return value && typeof value === "object" && !Array.isArray(value) ? value : null;
+}
+function stringValue(value) {
+    if (typeof value === "string" && value.trim())
+        return value;
+    if (typeof value === "number" && Number.isFinite(value))
+        return String(value);
+    return null;
+}
+function numberValue(value) {
+    return typeof value === "number" && Number.isFinite(value) ? value : null;
+}
+function booleanValue(value) {
+    return typeof value === "boolean" ? value : null;
+}
+function dateValue(value) {
+    if (typeof value === "number" && Number.isFinite(value)) {
+        return new Date(value > 10_000_000_000 ? value : value * 1000);
+    }
+    if (typeof value === "string" && value.trim()) {
+        const parsed = new Date(value);
+        return Number.isNaN(parsed.getTime()) ? null : parsed;
+    }
+    return null;
+}

package/dist/operations.js

@@ -5,11 +5,19 @@ import os from "node:os";
 import path from "node:path";
 import { describeCodexCli, resolveCodexCli } from "./codex-cli.js";
 import { findLatestDatabase } from "./codex-state.js";
+import { describeClaudeCodeCli, resolveClaudeCodeCli } from "./claude-code-cli.js";
+import { describeHermesCli, resolveHermesCli } from "./hermes-cli.js";
+import { describeOpenClawCli, resolveOpenClawCli } from "./openclaw-cli.js";
 import { describePiCli, resolvePiCli } from "./pi-cli.js";
 const APP_NAME = "nordrelay";
 const PACKAGE_NAME = "@nordbyte/nordrelay";
 const CODEX_PACKAGE_NAME = "@openai/codex";
-const PI_PACKAGE_NAME = "@mariozechner/pi-coding-agent";
+const PI_PACKAGE_NAME = "@earendil-works/pi-coding-agent";
+const LEGACY_PI_PACKAGE_NAME = "@mariozechner/pi-coding-agent";
+const HERMES_PACKAGE_NAME = "hermes-agent";
+const OPENCLAW_PACKAGE_NAME = "openclaw";
+const CLAUDE_CODE_PACKAGE_NAME = "@anthropic-ai/claude-code";
+const CLAUDE_CODE_SDK_PACKAGE_NAME = "@anthropic-ai/claude-agent-sdk";
 const DEFAULT_HOME = path.join(os.homedir(), ".nordrelay");
 const SECRET_RE = /(bot|token|api[_-]?key|authorization|bearer|password|secret)(["'=: ]+)([^\s"',]+)/gi;
 const DEFAULT_VERSION_CACHE_TTL_MS = 60 * 60 * 1000;
@@ -25,6 +33,9 @@ export function getConnectorLogPath() {
 export function getUpdateLogPath() {
     return path.join(getConnectorHome(), "update.log");
 }
+export function getAgentUpdateLogPath(home = getConnectorHome()) {
+    return path.join(home, "agent-updates.log");
+}
 export async function readConnectorState() {
     try {
         return JSON.parse(await readFile(getConnectorStatePath(), "utf8"));
@@ -67,6 +78,14 @@ export async function readFormattedLogTail(lines = 80, filePath = getConnectorLo
         };
     }
 }
+export function clearLogFile(filePath = getConnectorLogPath()) {
+    mkdirSync(path.dirname(filePath), { recursive: true });
+    writeFileSync(filePath, "", "utf8");
+    return {
+        filePath,
+        clearedAt: new Date(),
+    };
+}
 export async function getPackageVersion() {
     try {
         const pkg = JSON.parse(await readFile(path.join(getSourceRoot(), "package.json"), "utf8"));
@@ -80,10 +99,22 @@ export async function getVersionChecks(options = {}) {
     const nordrelayVersion = await getPackageVersion();
     const codexCli = resolveCodexCli();
     const piCli = resolvePiCli(process.env, options.piCliPath);
+    const hermesCli = resolveHermesCli(process.env, options.hermesCliPath);
+    const openClawCli = resolveOpenClawCli(process.env, options.openClawCliPath);
+    const claudeCodeCli = resolveClaudeCodeCli(process.env, options.claudeCodeCliPath);
     const codexVersionLabel = codexCli.path
         ? detectCliVersion(codexCli.path)
         : readInstalledPackageVersion(CODEX_PACKAGE_NAME) ?? "not installed";
-    const piVersionLabel = piCli.path ? detectCliVersion(piCli.path) : "not installed";
+    const piVersionLabel = piCli.path
+        ? detectCliVersion(piCli.path)
+        : readInstalledPackageVersion(PI_PACKAGE_NAME) ?? readInstalledPackageVersion(LEGACY_PI_PACKAGE_NAME) ?? "not installed";
+    const legacyPiPackageVersion = readInstalledPackageVersion(LEGACY_PI_PACKAGE_NAME);
+    const hermesVersionLabel = hermesCli.path ? detectCliVersion(hermesCli.path) : "not installed";
+    const openClawVersionLabel = openClawCli.path ? detectCliVersion(openClawCli.path) : "not installed";
+    const claudeCodeVersionLabel = claudeCodeCli.path
+        ? detectCliVersion(claudeCodeCli.path)
+        : readInstalledPackageVersion(CLAUDE_CODE_SDK_PACKAGE_NAME) ?? "bundled";
+    const claudeCodePackageName = claudeCodeCli.path ? CLAUDE_CODE_PACKAGE_NAME : CLAUDE_CODE_SDK_PACKAGE_NAME;
     return {
         nordrelay: buildVersionCheck({
             label: "NordRelay",
@@ -104,16 +135,36 @@ export async function getVersionChecks(options = {}) {
             installedLabel: piVersionLabel,
             installedVersion: extractVersion(piVersionLabel),
             notInstalled: piVersionLabel === "not installed",
+            detail: legacyPiPackageVersion ? `Legacy package ${LEGACY_PI_PACKAGE_NAME} is present; current package is ${PI_PACKAGE_NAME}.` : undefined,
+        }),
+        hermes: buildHermesVersionCheck(hermesVersionLabel),
+        openclaw: buildVersionCheck({
+            label: "OpenClaw",
+            packageName: OPENCLAW_PACKAGE_NAME,
+            installedLabel: openClawVersionLabel,
+            installedVersion: extractVersion(openClawVersionLabel),
+            notInstalled: openClawVersionLabel === "not installed",
+        }),
+        claudeCode: buildVersionCheck({
+            label: "Claude Code",
+            packageName: claudeCodePackageName,
+            installedLabel: claudeCodeVersionLabel,
+            installedVersion: extractVersion(claudeCodeVersionLabel),
+            notInstalled: claudeCodeVersionLabel === "not installed",
         }),
     };
 }
-export async function getConnectorHealth() {
-    const state = await readConnectorState();
+export async function getConnectorHealth(options = {}) {
+    const rawState = await readConnectorState();
     const version = await getPackageVersion();
-    const pidRunning = isProcessRunning(state.pid);
-    const appPidRunning = isProcessRunning(state.appPid);
+    const pidRunning = isProcessRunning(rawState.pid);
+    const appPidRunning = isProcessRunning(rawState.appPid);
+    const state = normalizeConnectorState(rawState, pidRunning, appPidRunning);
     const codexCli = resolveCodexCli();
-    const piCli = resolvePiCli();
+    const piCli = resolvePiCli(process.env, options.piCliPath);
+    const hermesCli = resolveHermesCli(process.env, options.hermesCliPath);
+    const openClawCli = resolveOpenClawCli(process.env, options.openClawCliPath);
+    const claudeCodeCli = resolveClaudeCodeCli(process.env, options.claudeCodeCliPath);
     return {
         version,
         state,
@@ -125,6 +176,17 @@ export async function getConnectorHealth() {
         piCli: describePiCli(piCli),
         piCliPath: piCli.path ?? null,
         piCliVersion: detectCliVersion(piCli.path),
+        hermesCli: describeHermesCli(hermesCli),
+        hermesCliPath: hermesCli.path ?? null,
+        hermesCliVersion: detectCliVersion(hermesCli.path),
+        openClawCli: describeOpenClawCli(openClawCli),
+        openClawCliPath: openClawCli.path ?? null,
+        openClawCliVersion: detectCliVersion(openClawCli.path),
+        claudeCodeCli: describeClaudeCodeCli(claudeCodeCli),
+        claudeCodeCliPath: claudeCodeCli.path ?? null,
+        claudeCodeCliVersion: claudeCodeCli.path
+            ? detectCliVersion(claudeCodeCli.path)
+            : readInstalledPackageVersion(CLAUDE_CODE_SDK_PACKAGE_NAME) ?? "bundled",
         stateFile: getConnectorStatePath(),
         logFile: getConnectorLogPath(),
         databasePath: findLatestDatabase(),
@@ -202,6 +264,13 @@ function isProcessRunning(pid) {
         return false;
     }
 }
+function normalizeConnectorState(state, pidRunning, appPidRunning) {
+    const stoppedSignal = state.signal === "SIGTERM" || state.signal === "SIGINT";
+    if (state.status === "error" && stoppedSignal && !state.error && !pidRunning && !appPidRunning) {
+        return { ...state, status: "stopped" };
+    }
+    return state;
+}
 function redactSecrets(text) {
     return text.replace(SECRET_RE, "$1$2[redacted]");
 }
@@ -249,6 +318,31 @@ function detectCliVersion(commandPath) {
     }
     return output || "unknown";
 }
+function buildHermesVersionCheck(installedLabel) {
+    if (installedLabel === "not installed") {
+        return {
+            label: "Hermes",
+            packageName: HERMES_PACKAGE_NAME,
+            installedLabel: "not installed",
+            installedVersion: null,
+            latestVersion: null,
+            status: "not-installed",
+        };
+    }
+    const lines = installedLabel.split(/\r?\n/).map((line) => line.trim()).filter(Boolean);
+    const versionLine = lines[0] ?? installedLabel;
+    const updateLine = lines.find((line) => /^Update available:/i.test(line));
+    const installedVersion = extractVersion(versionLine);
+    return {
+        label: "Hermes",
+        packageName: HERMES_PACKAGE_NAME,
+        installedLabel: versionLine,
+        installedVersion,
+        latestVersion: updateLine?.replace(/^Update available:\s*/i, "") ?? null,
+        status: updateLine ? "outdated" : installedVersion ? "current" : "unknown",
+        detail: updateLine ?? (installedVersion ? undefined : "Could not parse Hermes version or update status"),
+    };
+}
 function buildVersionCheck(options) {
     if (options.notInstalled) {
         return {
@@ -258,6 +352,18 @@ function buildVersionCheck(options) {
             installedVersion: null,
             latestVersion: null,
             status: "not-installed",
+            detail: options.detail,
+        };
+    }
+    if (options.skipLatest) {
+        return {
+            label: options.label,
+            packageName: options.packageName,
+            installedLabel: options.installedLabel,
+            installedVersion: options.installedVersion,
+            latestVersion: null,
+            status: options.installedVersion ? "unknown" : "unknown",
+            detail: options.detail ?? "Latest-version lookup is not available for this package source",
         };
     }
     const latest = detectLatestNpmVersion(options.packageName);
@@ -269,7 +375,7 @@ function buildVersionCheck(options) {
             installedVersion: options.installedVersion,
             latestVersion: latest.version,
             status: "unknown",
-            detail: latest.error ?? "Could not parse installed version",
+            detail: [options.detail, latest.error ?? "Could not parse installed version"].filter(Boolean).join(" "),
         };
     }
     return {
@@ -279,7 +385,7 @@ function buildVersionCheck(options) {
         installedVersion: options.installedVersion,
         latestVersion: latest.version,
         status: compareVersions(options.installedVersion, latest.version) < 0 ? "outdated" : "current",
-        detail: latest.error,
+        detail: [options.detail, latest.error].filter(Boolean).join(" ") || undefined,
     };
 }
 function detectLatestNpmVersion(packageName) {

package/dist/pi-auth.js

@@ -0,0 +1,59 @@
+const PROVIDER_ENV_KEYS = {
+    anthropic: ["ANTHROPIC_API_KEY", "ANTHROPIC_OAUTH_TOKEN"],
+    "aws-bedrock": ["AWS_BEARER_TOKEN_BEDROCK", "AWS_PROFILE", "AWS_ACCESS_KEY_ID"],
+    azure: ["AZURE_OPENAI_API_KEY"],
+    "azure-openai": ["AZURE_OPENAI_API_KEY"],
+    cerebras: ["CEREBRAS_API_KEY"],
+    cloudflare: ["CLOUDFLARE_API_KEY"],
+    deepseek: ["DEEPSEEK_API_KEY"],
+    fireworks: ["FIREWORKS_API_KEY"],
+    gemini: ["GEMINI_API_KEY"],
+    google: ["GEMINI_API_KEY"],
+    groq: ["GROQ_API_KEY"],
+    kimi: ["KIMI_API_KEY"],
+    minimax: ["MINIMAX_API_KEY"],
+    mistral: ["MISTRAL_API_KEY"],
+    moonshot: ["MOONSHOT_API_KEY"],
+    opencode: ["OPENCODE_API_KEY"],
+    openrouter: ["OPENROUTER_API_KEY"],
+    openai: ["OPENAI_API_KEY"],
+    "openai-codex": ["OPENAI_API_KEY"],
+    xai: ["XAI_API_KEY"],
+    xiaomi: ["XIAOMI_API_KEY", "XIAOMI_TOKEN_PLAN_CN_API_KEY", "XIAOMI_TOKEN_PLAN_AMS_API_KEY", "XIAOMI_TOKEN_PLAN_SGP_API_KEY"],
+    zai: ["ZAI_API_KEY"],
+};
+export function checkPiAuthStatus(model, env = process.env) {
+    const provider = providerFromModel(model);
+    const keys = PROVIDER_ENV_KEYS[provider];
+    if (!keys) {
+        return {
+            authenticated: true,
+            method: "cli",
+            detail: `Pi provider "${provider}" is not verifiable by NordRelay. Run "pi" on the host if auth fails.`,
+        };
+    }
+    const configured = keys.filter((key) => Boolean(env[key]?.trim()));
+    if (configured.length > 0) {
+        return {
+            authenticated: true,
+            method: "api-key",
+            detail: `Pi provider "${provider}" has ${configured.join(" or ")} configured.`,
+        };
+    }
+    return {
+        authenticated: false,
+        method: "none",
+        detail: `Pi provider "${provider}" needs one of: ${keys.join(", ")}.`,
+    };
+}
+function providerFromModel(model) {
+    const trimmed = model?.trim();
+    if (!trimmed) {
+        return "google";
+    }
+    const separator = trimmed.indexOf("/");
+    if (separator === -1) {
+        return "google";
+    }
+    return trimmed.slice(0, separator).toLowerCase();
+}