@gguf/claw
Version:
WhatsApp gateway CLI (Baileys web) with Pi RPC agent
1,308 lines (1,305 loc) • 53.1 kB
JavaScript
import { D as colorize, O as isRich, k as theme, n as isTruthyEnvValue, o as createSubsystemLogger, p as defaultRuntime, y as info } from "./entry.js";
import { c as normalizeAgentId, m as toAgentStoreSessionKey, u as resolveAgentIdFromSessionKey } from "./session-key-CZkcvAtx.js";
import { t as runCommandWithTimeout } from "./exec-B8JKbXKW.js";
import { n as resolveOpenClawPackageRootSync, t as resolveOpenClawPackageRoot } from "./openclaw-root-9ILYSmJ9.js";
import { c as resolveDefaultAgentId, m as DEFAULT_HEARTBEAT_FILENAME, n as resolveAgentConfig, s as resolveAgentWorkspaceDir } from "./agent-scope-C9VjJXEK.js";
import { h as parseDurationMs, i as loadConfig } from "./config-CKLedg5Y.js";
import { n as formatErrorMessage } from "./errors-CZ9opC6L.js";
import { n as callGateway, t as buildGatewayConnectionDetails } from "./call-90HgQQ8o.js";
import { f as resolvePreferredAccountId, n as listChannelPlugins, t as getChannelPlugin, u as buildChannelAccountBindings } from "./plugins-BUPpq5aS.js";
import { A as resolveHeartbeatVisibility, Jn as setHeartbeatWakeHandler, Kn as peekSystemEvents, P as resolveIndicatorType, V as getReplyFromConfig, _r as isHeartbeatContentEffectivelyEmpty, dr as CommandLane, gr as DEFAULT_HEARTBEAT_EVERY, hr as DEFAULT_HEARTBEAT_ACK_MAX_CHARS, j as emitHeartbeatEvent, kr as resolveEffectiveMessagesConfig, lr as getQueueSize, qn as requestHeartbeatNow, vn as resolveHeartbeatDeliveryTarget, vr as resolveHeartbeatPrompt$1, wr as resolveUserTimezone, yn as resolveHeartbeatSenderContext, yr as stripHeartbeatToken } from "./loader-_Pj-TZS2.js";
import { n as withProgress } from "./progress-Da1ehW-x.js";
import { t as resolveChannelDefaultAccountId } from "./helpers-D66_XoIz.js";
import { o as resolveStorePath } from "./paths-CTg8F3AE.js";
import { O as HEARTBEAT_TOKEN, t as deliverOutboundPayloads } from "./deliver-Cau4HL7W.js";
import { N as canonicalizeMainSessionAlias, P as resolveAgentMainSessionKey, d as loadSessionStore, g as updateSessionStore, m as saveSessionStore } from "./sandbox-DuqLKN5J.js";
import path from "node:path";
import fs from "node:fs";
import fs$1 from "node:fs/promises";
import { fileURLToPath } from "node:url";
//#region src/infra/heartbeat-runner.ts
const log = createSubsystemLogger("gateway/heartbeat");
let heartbeatsEnabled = true;
function setHeartbeatsEnabled(enabled) {
heartbeatsEnabled = enabled;
}
const DEFAULT_HEARTBEAT_TARGET = "last";
const ACTIVE_HOURS_TIME_PATTERN = /^([01]\d|2[0-3]|24):([0-5]\d)$/;
const EXEC_EVENT_PROMPT = "An async command you ran earlier has completed. The result is shown in the system messages above. Please relay the command output to the user in a helpful way. If the command succeeded, share the relevant output. If it failed, explain what went wrong.";
function resolveActiveHoursTimezone(cfg, raw) {
const trimmed = raw?.trim();
if (!trimmed || trimmed === "user") return resolveUserTimezone(cfg.agents?.defaults?.userTimezone);
if (trimmed === "local") return Intl.DateTimeFormat().resolvedOptions().timeZone?.trim() || "UTC";
try {
new Intl.DateTimeFormat("en-US", { timeZone: trimmed }).format(/* @__PURE__ */ new Date());
return trimmed;
} catch {
return resolveUserTimezone(cfg.agents?.defaults?.userTimezone);
}
}
function parseActiveHoursTime(opts, raw) {
if (!raw || !ACTIVE_HOURS_TIME_PATTERN.test(raw)) return null;
const [hourStr, minuteStr] = raw.split(":");
const hour = Number(hourStr);
const minute = Number(minuteStr);
if (!Number.isFinite(hour) || !Number.isFinite(minute)) return null;
if (hour === 24) {
if (!opts.allow24 || minute !== 0) return null;
return 1440;
}
return hour * 60 + minute;
}
function resolveMinutesInTimeZone(nowMs, timeZone) {
try {
const parts = new Intl.DateTimeFormat("en-US", {
timeZone,
hour: "2-digit",
minute: "2-digit",
hourCycle: "h23"
}).formatToParts(new Date(nowMs));
const map = {};
for (const part of parts) if (part.type !== "literal") map[part.type] = part.value;
const hour = Number(map.hour);
const minute = Number(map.minute);
if (!Number.isFinite(hour) || !Number.isFinite(minute)) return null;
return hour * 60 + minute;
} catch {
return null;
}
}
function isWithinActiveHours(cfg, heartbeat, nowMs) {
const active = heartbeat?.activeHours;
if (!active) return true;
const startMin = parseActiveHoursTime({ allow24: false }, active.start);
const endMin = parseActiveHoursTime({ allow24: true }, active.end);
if (startMin === null || endMin === null) return true;
if (startMin === endMin) return true;
const timeZone = resolveActiveHoursTimezone(cfg, active.timezone);
const currentMin = resolveMinutesInTimeZone(nowMs ?? Date.now(), timeZone);
if (currentMin === null) return true;
if (endMin > startMin) return currentMin >= startMin && currentMin < endMin;
return currentMin >= startMin || currentMin < endMin;
}
function hasExplicitHeartbeatAgents(cfg) {
return (cfg.agents?.list ?? []).some((entry) => Boolean(entry?.heartbeat));
}
function isHeartbeatEnabledForAgent(cfg, agentId) {
const resolvedAgentId = normalizeAgentId(agentId ?? resolveDefaultAgentId(cfg));
const list = cfg.agents?.list ?? [];
if (hasExplicitHeartbeatAgents(cfg)) return list.some((entry) => Boolean(entry?.heartbeat) && normalizeAgentId(entry?.id) === resolvedAgentId);
return resolvedAgentId === resolveDefaultAgentId(cfg);
}
function resolveHeartbeatConfig(cfg, agentId) {
const defaults = cfg.agents?.defaults?.heartbeat;
if (!agentId) return defaults;
const overrides = resolveAgentConfig(cfg, agentId)?.heartbeat;
if (!defaults && !overrides) return overrides;
return {
...defaults,
...overrides
};
}
function resolveHeartbeatSummaryForAgent(cfg, agentId) {
const defaults = cfg.agents?.defaults?.heartbeat;
const overrides = agentId ? resolveAgentConfig(cfg, agentId)?.heartbeat : void 0;
if (!isHeartbeatEnabledForAgent(cfg, agentId)) return {
enabled: false,
every: "disabled",
everyMs: null,
prompt: resolveHeartbeatPrompt$1(defaults?.prompt),
target: defaults?.target ?? DEFAULT_HEARTBEAT_TARGET,
model: defaults?.model,
ackMaxChars: Math.max(0, defaults?.ackMaxChars ?? DEFAULT_HEARTBEAT_ACK_MAX_CHARS)
};
const merged = defaults || overrides ? {
...defaults,
...overrides
} : void 0;
return {
enabled: true,
every: merged?.every ?? defaults?.every ?? overrides?.every ?? DEFAULT_HEARTBEAT_EVERY,
everyMs: resolveHeartbeatIntervalMs(cfg, void 0, merged),
prompt: resolveHeartbeatPrompt$1(merged?.prompt ?? defaults?.prompt ?? overrides?.prompt),
target: merged?.target ?? defaults?.target ?? overrides?.target ?? DEFAULT_HEARTBEAT_TARGET,
model: merged?.model ?? defaults?.model ?? overrides?.model,
ackMaxChars: Math.max(0, merged?.ackMaxChars ?? defaults?.ackMaxChars ?? overrides?.ackMaxChars ?? DEFAULT_HEARTBEAT_ACK_MAX_CHARS)
};
}
function resolveHeartbeatAgents(cfg) {
const list = cfg.agents?.list ?? [];
if (hasExplicitHeartbeatAgents(cfg)) return list.filter((entry) => entry?.heartbeat).map((entry) => {
const id = normalizeAgentId(entry.id);
return {
agentId: id,
heartbeat: resolveHeartbeatConfig(cfg, id)
};
}).filter((entry) => entry.agentId);
const fallbackId = resolveDefaultAgentId(cfg);
return [{
agentId: fallbackId,
heartbeat: resolveHeartbeatConfig(cfg, fallbackId)
}];
}
function resolveHeartbeatIntervalMs(cfg, overrideEvery, heartbeat) {
const raw = overrideEvery ?? heartbeat?.every ?? cfg.agents?.defaults?.heartbeat?.every ?? DEFAULT_HEARTBEAT_EVERY;
if (!raw) return null;
const trimmed = String(raw).trim();
if (!trimmed) return null;
let ms;
try {
ms = parseDurationMs(trimmed, { defaultUnit: "m" });
} catch {
return null;
}
if (ms <= 0) return null;
return ms;
}
function resolveHeartbeatPrompt(cfg, heartbeat) {
return resolveHeartbeatPrompt$1(heartbeat?.prompt ?? cfg.agents?.defaults?.heartbeat?.prompt);
}
function resolveHeartbeatAckMaxChars(cfg, heartbeat) {
return Math.max(0, heartbeat?.ackMaxChars ?? cfg.agents?.defaults?.heartbeat?.ackMaxChars ?? DEFAULT_HEARTBEAT_ACK_MAX_CHARS);
}
function resolveHeartbeatSession(cfg, agentId, heartbeat) {
const sessionCfg = cfg.session;
const scope = sessionCfg?.scope ?? "per-sender";
const resolvedAgentId = normalizeAgentId(agentId ?? resolveDefaultAgentId(cfg));
const mainSessionKey = scope === "global" ? "global" : resolveAgentMainSessionKey({
cfg,
agentId: resolvedAgentId
});
const storeAgentId = scope === "global" ? resolveDefaultAgentId(cfg) : resolvedAgentId;
const storePath = resolveStorePath(sessionCfg?.store, { agentId: storeAgentId });
const store = loadSessionStore(storePath);
const mainEntry = store[mainSessionKey];
if (scope === "global") return {
sessionKey: mainSessionKey,
storePath,
store,
entry: mainEntry
};
const trimmed = heartbeat?.session?.trim() ?? "";
if (!trimmed) return {
sessionKey: mainSessionKey,
storePath,
store,
entry: mainEntry
};
const normalized = trimmed.toLowerCase();
if (normalized === "main" || normalized === "global") return {
sessionKey: mainSessionKey,
storePath,
store,
entry: mainEntry
};
const canonical = canonicalizeMainSessionAlias({
cfg,
agentId: resolvedAgentId,
sessionKey: toAgentStoreSessionKey({
agentId: resolvedAgentId,
requestKey: trimmed,
mainKey: cfg.session?.mainKey
})
});
if (canonical !== "global") {
if (resolveAgentIdFromSessionKey(canonical) === normalizeAgentId(resolvedAgentId)) return {
sessionKey: canonical,
storePath,
store,
entry: store[canonical]
};
}
return {
sessionKey: mainSessionKey,
storePath,
store,
entry: mainEntry
};
}
function resolveHeartbeatReplyPayload(replyResult) {
if (!replyResult) return;
if (!Array.isArray(replyResult)) return replyResult;
for (let idx = replyResult.length - 1; idx >= 0; idx -= 1) {
const payload = replyResult[idx];
if (!payload) continue;
if (payload.text || payload.mediaUrl || payload.mediaUrls && payload.mediaUrls.length > 0) return payload;
}
}
function resolveHeartbeatReasoningPayloads(replyResult) {
return (Array.isArray(replyResult) ? replyResult : replyResult ? [replyResult] : []).filter((payload) => {
return (typeof payload.text === "string" ? payload.text : "").trimStart().startsWith("Reasoning:");
});
}
async function restoreHeartbeatUpdatedAt(params) {
const { storePath, sessionKey, updatedAt } = params;
if (typeof updatedAt !== "number") return;
const entry = loadSessionStore(storePath)[sessionKey];
if (!entry) return;
const nextUpdatedAt = Math.max(entry.updatedAt ?? 0, updatedAt);
if (entry.updatedAt === nextUpdatedAt) return;
await updateSessionStore(storePath, (nextStore) => {
const nextEntry = nextStore[sessionKey] ?? entry;
if (!nextEntry) return;
const resolvedUpdatedAt = Math.max(nextEntry.updatedAt ?? 0, updatedAt);
if (nextEntry.updatedAt === resolvedUpdatedAt) return;
nextStore[sessionKey] = {
...nextEntry,
updatedAt: resolvedUpdatedAt
};
});
}
function normalizeHeartbeatReply(payload, responsePrefix, ackMaxChars) {
const stripped = stripHeartbeatToken(payload.text, {
mode: "heartbeat",
maxAckChars: ackMaxChars
});
const hasMedia = Boolean(payload.mediaUrl || (payload.mediaUrls?.length ?? 0) > 0);
if (stripped.shouldSkip && !hasMedia) return {
shouldSkip: true,
text: "",
hasMedia
};
let finalText = stripped.text;
if (responsePrefix && finalText && !finalText.startsWith(responsePrefix)) finalText = `${responsePrefix} ${finalText}`;
return {
shouldSkip: false,
text: finalText,
hasMedia
};
}
async function runHeartbeatOnce(opts) {
const cfg = opts.cfg ?? loadConfig();
const agentId = normalizeAgentId(opts.agentId ?? resolveDefaultAgentId(cfg));
const heartbeat = opts.heartbeat ?? resolveHeartbeatConfig(cfg, agentId);
if (!heartbeatsEnabled) return {
status: "skipped",
reason: "disabled"
};
if (!isHeartbeatEnabledForAgent(cfg, agentId)) return {
status: "skipped",
reason: "disabled"
};
if (!resolveHeartbeatIntervalMs(cfg, void 0, heartbeat)) return {
status: "skipped",
reason: "disabled"
};
const startedAt = opts.deps?.nowMs?.() ?? Date.now();
if (!isWithinActiveHours(cfg, heartbeat, startedAt)) return {
status: "skipped",
reason: "quiet-hours"
};
if ((opts.deps?.getQueueSize ?? getQueueSize)(CommandLane.Main) > 0) return {
status: "skipped",
reason: "requests-in-flight"
};
const isExecEventReason = opts.reason === "exec-event";
const workspaceDir = resolveAgentWorkspaceDir(cfg, agentId);
const heartbeatFilePath = path.join(workspaceDir, DEFAULT_HEARTBEAT_FILENAME);
try {
if (isHeartbeatContentEffectivelyEmpty(await fs$1.readFile(heartbeatFilePath, "utf-8")) && !isExecEventReason) {
emitHeartbeatEvent({
status: "skipped",
reason: "empty-heartbeat-file",
durationMs: Date.now() - startedAt
});
return {
status: "skipped",
reason: "empty-heartbeat-file"
};
}
} catch {}
const { entry, sessionKey, storePath } = resolveHeartbeatSession(cfg, agentId, heartbeat);
const previousUpdatedAt = entry?.updatedAt;
const delivery = resolveHeartbeatDeliveryTarget({
cfg,
entry,
heartbeat
});
const heartbeatAccountId = heartbeat?.accountId?.trim();
if (delivery.reason === "unknown-account") log.warn("heartbeat: unknown accountId", {
accountId: delivery.accountId ?? heartbeatAccountId ?? null,
target: heartbeat?.target ?? "last"
});
else if (heartbeatAccountId) log.info("heartbeat: using explicit accountId", {
accountId: delivery.accountId ?? heartbeatAccountId,
target: heartbeat?.target ?? "last",
channel: delivery.channel
});
const visibility = delivery.channel !== "none" ? resolveHeartbeatVisibility({
cfg,
channel: delivery.channel,
accountId: delivery.accountId
}) : {
showOk: false,
showAlerts: true,
useIndicator: true
};
const { sender } = resolveHeartbeatSenderContext({
cfg,
entry,
delivery
});
const responsePrefix = resolveEffectiveMessagesConfig(cfg, agentId, {
channel: delivery.channel !== "none" ? delivery.channel : void 0,
accountId: delivery.accountId
}).responsePrefix;
const hasExecCompletion = (opts.reason === "exec-event" ? peekSystemEvents(sessionKey) : []).some((evt) => evt.includes("Exec finished"));
const ctx = {
Body: hasExecCompletion ? EXEC_EVENT_PROMPT : resolveHeartbeatPrompt(cfg, heartbeat),
From: sender,
To: sender,
Provider: hasExecCompletion ? "exec-event" : "heartbeat",
SessionKey: sessionKey
};
if (!visibility.showAlerts && !visibility.showOk && !visibility.useIndicator) {
emitHeartbeatEvent({
status: "skipped",
reason: "alerts-disabled",
durationMs: Date.now() - startedAt,
channel: delivery.channel !== "none" ? delivery.channel : void 0,
accountId: delivery.accountId
});
return {
status: "skipped",
reason: "alerts-disabled"
};
}
const heartbeatOkText = responsePrefix ? `${responsePrefix} ${HEARTBEAT_TOKEN}` : HEARTBEAT_TOKEN;
const canAttemptHeartbeatOk = Boolean(visibility.showOk && delivery.channel !== "none" && delivery.to);
const maybeSendHeartbeatOk = async () => {
if (!canAttemptHeartbeatOk || delivery.channel === "none" || !delivery.to) return false;
const heartbeatPlugin = getChannelPlugin(delivery.channel);
if (heartbeatPlugin?.heartbeat?.checkReady) {
if (!(await heartbeatPlugin.heartbeat.checkReady({
cfg,
accountId: delivery.accountId,
deps: opts.deps
})).ok) return false;
}
await deliverOutboundPayloads({
cfg,
channel: delivery.channel,
to: delivery.to,
accountId: delivery.accountId,
payloads: [{ text: heartbeatOkText }],
deps: opts.deps
});
return true;
};
try {
const replyResult = await getReplyFromConfig(ctx, { isHeartbeat: true }, cfg);
const replyPayload = resolveHeartbeatReplyPayload(replyResult);
const reasoningPayloads = heartbeat?.includeReasoning === true ? resolveHeartbeatReasoningPayloads(replyResult).filter((payload) => payload !== replyPayload) : [];
if (!replyPayload || !replyPayload.text && !replyPayload.mediaUrl && !replyPayload.mediaUrls?.length) {
await restoreHeartbeatUpdatedAt({
storePath,
sessionKey,
updatedAt: previousUpdatedAt
});
const okSent = await maybeSendHeartbeatOk();
emitHeartbeatEvent({
status: "ok-empty",
reason: opts.reason,
durationMs: Date.now() - startedAt,
channel: delivery.channel !== "none" ? delivery.channel : void 0,
accountId: delivery.accountId,
silent: !okSent,
indicatorType: visibility.useIndicator ? resolveIndicatorType("ok-empty") : void 0
});
return {
status: "ran",
durationMs: Date.now() - startedAt
};
}
const normalized = normalizeHeartbeatReply(replyPayload, responsePrefix, resolveHeartbeatAckMaxChars(cfg, heartbeat));
const execFallbackText = hasExecCompletion && !normalized.text.trim() && replyPayload.text?.trim() ? replyPayload.text.trim() : null;
if (execFallbackText) {
normalized.text = execFallbackText;
normalized.shouldSkip = false;
}
const shouldSkipMain = normalized.shouldSkip && !normalized.hasMedia && !hasExecCompletion;
if (shouldSkipMain && reasoningPayloads.length === 0) {
await restoreHeartbeatUpdatedAt({
storePath,
sessionKey,
updatedAt: previousUpdatedAt
});
const okSent = await maybeSendHeartbeatOk();
emitHeartbeatEvent({
status: "ok-token",
reason: opts.reason,
durationMs: Date.now() - startedAt,
channel: delivery.channel !== "none" ? delivery.channel : void 0,
accountId: delivery.accountId,
silent: !okSent,
indicatorType: visibility.useIndicator ? resolveIndicatorType("ok-token") : void 0
});
return {
status: "ran",
durationMs: Date.now() - startedAt
};
}
const mediaUrls = replyPayload.mediaUrls ?? (replyPayload.mediaUrl ? [replyPayload.mediaUrl] : []);
const prevHeartbeatText = typeof entry?.lastHeartbeatText === "string" ? entry.lastHeartbeatText : "";
const prevHeartbeatAt = typeof entry?.lastHeartbeatSentAt === "number" ? entry.lastHeartbeatSentAt : void 0;
if (!shouldSkipMain && !mediaUrls.length && Boolean(prevHeartbeatText.trim()) && normalized.text.trim() === prevHeartbeatText.trim() && typeof prevHeartbeatAt === "number" && startedAt - prevHeartbeatAt < 1440 * 60 * 1e3) {
await restoreHeartbeatUpdatedAt({
storePath,
sessionKey,
updatedAt: previousUpdatedAt
});
emitHeartbeatEvent({
status: "skipped",
reason: "duplicate",
preview: normalized.text.slice(0, 200),
durationMs: Date.now() - startedAt,
hasMedia: false,
channel: delivery.channel !== "none" ? delivery.channel : void 0,
accountId: delivery.accountId
});
return {
status: "ran",
durationMs: Date.now() - startedAt
};
}
const previewText = shouldSkipMain ? reasoningPayloads.map((payload) => payload.text).filter((text) => Boolean(text?.trim())).join("\n") : normalized.text;
if (delivery.channel === "none" || !delivery.to) {
emitHeartbeatEvent({
status: "skipped",
reason: delivery.reason ?? "no-target",
preview: previewText?.slice(0, 200),
durationMs: Date.now() - startedAt,
hasMedia: mediaUrls.length > 0,
accountId: delivery.accountId
});
return {
status: "ran",
durationMs: Date.now() - startedAt
};
}
if (!visibility.showAlerts) {
await restoreHeartbeatUpdatedAt({
storePath,
sessionKey,
updatedAt: previousUpdatedAt
});
emitHeartbeatEvent({
status: "skipped",
reason: "alerts-disabled",
preview: previewText?.slice(0, 200),
durationMs: Date.now() - startedAt,
channel: delivery.channel,
hasMedia: mediaUrls.length > 0,
accountId: delivery.accountId,
indicatorType: visibility.useIndicator ? resolveIndicatorType("sent") : void 0
});
return {
status: "ran",
durationMs: Date.now() - startedAt
};
}
const deliveryAccountId = delivery.accountId;
const heartbeatPlugin = getChannelPlugin(delivery.channel);
if (heartbeatPlugin?.heartbeat?.checkReady) {
const readiness = await heartbeatPlugin.heartbeat.checkReady({
cfg,
accountId: deliveryAccountId,
deps: opts.deps
});
if (!readiness.ok) {
emitHeartbeatEvent({
status: "skipped",
reason: readiness.reason,
preview: previewText?.slice(0, 200),
durationMs: Date.now() - startedAt,
hasMedia: mediaUrls.length > 0,
channel: delivery.channel,
accountId: delivery.accountId
});
log.info("heartbeat: channel not ready", {
channel: delivery.channel,
reason: readiness.reason
});
return {
status: "skipped",
reason: readiness.reason
};
}
}
await deliverOutboundPayloads({
cfg,
channel: delivery.channel,
to: delivery.to,
accountId: deliveryAccountId,
payloads: [...reasoningPayloads, ...shouldSkipMain ? [] : [{
text: normalized.text,
mediaUrls
}]],
deps: opts.deps
});
if (!shouldSkipMain && normalized.text.trim()) {
const store = loadSessionStore(storePath);
const current = store[sessionKey];
if (current) {
store[sessionKey] = {
...current,
lastHeartbeatText: normalized.text,
lastHeartbeatSentAt: startedAt
};
await saveSessionStore(storePath, store);
}
}
emitHeartbeatEvent({
status: "sent",
to: delivery.to,
preview: previewText?.slice(0, 200),
durationMs: Date.now() - startedAt,
hasMedia: mediaUrls.length > 0,
channel: delivery.channel,
accountId: delivery.accountId,
indicatorType: visibility.useIndicator ? resolveIndicatorType("sent") : void 0
});
return {
status: "ran",
durationMs: Date.now() - startedAt
};
} catch (err) {
const reason = formatErrorMessage(err);
emitHeartbeatEvent({
status: "failed",
reason,
durationMs: Date.now() - startedAt,
channel: delivery.channel !== "none" ? delivery.channel : void 0,
accountId: delivery.accountId,
indicatorType: visibility.useIndicator ? resolveIndicatorType("failed") : void 0
});
log.error(`heartbeat failed: ${reason}`, { error: reason });
return {
status: "failed",
reason
};
}
}
function startHeartbeatRunner(opts) {
const runtime = opts.runtime ?? defaultRuntime;
const runOnce = opts.runOnce ?? runHeartbeatOnce;
const state = {
cfg: opts.cfg ?? loadConfig(),
runtime,
agents: /* @__PURE__ */ new Map(),
timer: null,
stopped: false
};
let initialized = false;
const resolveNextDue = (now, intervalMs, prevState) => {
if (typeof prevState?.lastRunMs === "number") return prevState.lastRunMs + intervalMs;
if (prevState && prevState.intervalMs === intervalMs && prevState.nextDueMs > now) return prevState.nextDueMs;
return now + intervalMs;
};
const scheduleNext = () => {
if (state.stopped) return;
if (state.timer) {
clearTimeout(state.timer);
state.timer = null;
}
if (state.agents.size === 0) return;
const now = Date.now();
let nextDue = Number.POSITIVE_INFINITY;
for (const agent of state.agents.values()) if (agent.nextDueMs < nextDue) nextDue = agent.nextDueMs;
if (!Number.isFinite(nextDue)) return;
const delay = Math.max(0, nextDue - now);
state.timer = setTimeout(() => {
requestHeartbeatNow({
reason: "interval",
coalesceMs: 0
});
}, delay);
state.timer.unref?.();
};
const updateConfig = (cfg) => {
if (state.stopped) return;
const now = Date.now();
const prevAgents = state.agents;
const prevEnabled = prevAgents.size > 0;
const nextAgents = /* @__PURE__ */ new Map();
const intervals = [];
for (const agent of resolveHeartbeatAgents(cfg)) {
const intervalMs = resolveHeartbeatIntervalMs(cfg, void 0, agent.heartbeat);
if (!intervalMs) continue;
intervals.push(intervalMs);
const prevState = prevAgents.get(agent.agentId);
const nextDueMs = resolveNextDue(now, intervalMs, prevState);
nextAgents.set(agent.agentId, {
agentId: agent.agentId,
heartbeat: agent.heartbeat,
intervalMs,
lastRunMs: prevState?.lastRunMs,
nextDueMs
});
}
state.cfg = cfg;
state.agents = nextAgents;
const nextEnabled = nextAgents.size > 0;
if (!initialized) {
if (!nextEnabled) log.info("heartbeat: disabled", { enabled: false });
else log.info("heartbeat: started", { intervalMs: Math.min(...intervals) });
initialized = true;
} else if (prevEnabled !== nextEnabled) if (!nextEnabled) log.info("heartbeat: disabled", { enabled: false });
else log.info("heartbeat: started", { intervalMs: Math.min(...intervals) });
scheduleNext();
};
const run = async (params) => {
if (!heartbeatsEnabled) return {
status: "skipped",
reason: "disabled"
};
if (state.agents.size === 0) return {
status: "skipped",
reason: "disabled"
};
const reason = params?.reason;
const isInterval = reason === "interval";
const startedAt = Date.now();
const now = startedAt;
let ran = false;
for (const agent of state.agents.values()) {
if (isInterval && now < agent.nextDueMs) continue;
const res = await runOnce({
cfg: state.cfg,
agentId: agent.agentId,
heartbeat: agent.heartbeat,
reason,
deps: { runtime: state.runtime }
});
if (res.status === "skipped" && res.reason === "requests-in-flight") return res;
if (res.status !== "skipped" || res.reason !== "disabled") {
agent.lastRunMs = now;
agent.nextDueMs = now + agent.intervalMs;
}
if (res.status === "ran") ran = true;
}
scheduleNext();
if (ran) return {
status: "ran",
durationMs: Date.now() - startedAt
};
return {
status: "skipped",
reason: isInterval ? "not-due" : "disabled"
};
};
setHeartbeatWakeHandler(async (params) => run({ reason: params.reason }));
updateConfig(state.cfg);
const cleanup = () => {
state.stopped = true;
setHeartbeatWakeHandler(null);
if (state.timer) clearTimeout(state.timer);
state.timer = null;
};
opts.abortSignal?.addEventListener("abort", cleanup, { once: true });
return {
stop: cleanup,
updateConfig
};
}
//#endregion
//#region src/commands/health.ts
const DEFAULT_TIMEOUT_MS = 1e4;
const debugHealth = (...args) => {
if (isTruthyEnvValue(process.env.OPENCLAW_DEBUG_HEALTH)) console.warn("[health:debug]", ...args);
};
const formatDurationParts = (ms) => {
if (!Number.isFinite(ms)) return "unknown";
if (ms < 1e3) return `${Math.max(0, Math.round(ms))}ms`;
const units = [
{
label: "w",
size: 10080 * 60 * 1e3
},
{
label: "d",
size: 1440 * 60 * 1e3
},
{
label: "h",
size: 3600 * 1e3
},
{
label: "m",
size: 60 * 1e3
},
{
label: "s",
size: 1e3
}
];
let remaining = Math.max(0, Math.floor(ms));
const parts = [];
for (const unit of units) {
const value = Math.floor(remaining / unit.size);
if (value > 0) {
parts.push(`${value}${unit.label}`);
remaining -= value * unit.size;
}
}
if (parts.length === 0) return "0s";
return parts.join(" ");
};
const resolveHeartbeatSummary = (cfg, agentId) => resolveHeartbeatSummaryForAgent(cfg, agentId);
const resolveAgentOrder = (cfg) => {
const defaultAgentId = resolveDefaultAgentId(cfg);
const entries = Array.isArray(cfg.agents?.list) ? cfg.agents.list : [];
const seen = /* @__PURE__ */ new Set();
const ordered = [];
for (const entry of entries) {
if (!entry || typeof entry !== "object") continue;
if (typeof entry.id !== "string" || !entry.id.trim()) continue;
const id = normalizeAgentId(entry.id);
if (!id || seen.has(id)) continue;
seen.add(id);
ordered.push({
id,
name: typeof entry.name === "string" ? entry.name : void 0
});
}
if (!seen.has(defaultAgentId)) ordered.unshift({ id: defaultAgentId });
if (ordered.length === 0) ordered.push({ id: defaultAgentId });
return {
defaultAgentId,
ordered
};
};
const buildSessionSummary = (storePath) => {
const store = loadSessionStore(storePath);
const sessions = Object.entries(store).filter(([key]) => key !== "global" && key !== "unknown").map(([key, entry]) => ({
key,
updatedAt: entry?.updatedAt ?? 0
})).toSorted((a, b) => b.updatedAt - a.updatedAt);
const recent = sessions.slice(0, 5).map((s) => ({
key: s.key,
updatedAt: s.updatedAt || null,
age: s.updatedAt ? Date.now() - s.updatedAt : null
}));
return {
path: storePath,
count: sessions.length,
recent
};
};
const isAccountEnabled = (account) => {
if (!account || typeof account !== "object") return true;
return account.enabled !== false;
};
const asRecord = (value) => value && typeof value === "object" ? value : null;
const formatProbeLine = (probe, opts = {}) => {
const record = asRecord(probe);
if (!record) return null;
const ok = typeof record.ok === "boolean" ? record.ok : void 0;
if (ok === void 0) return null;
const elapsedMs = typeof record.elapsedMs === "number" ? record.elapsedMs : null;
const status = typeof record.status === "number" ? record.status : null;
const error = typeof record.error === "string" ? record.error : null;
const bot = asRecord(record.bot);
const botUsername = bot && typeof bot.username === "string" ? bot.username : null;
const webhook = asRecord(record.webhook);
const webhookUrl = webhook && typeof webhook.url === "string" ? webhook.url : null;
const usernames = /* @__PURE__ */ new Set();
if (botUsername) usernames.add(botUsername);
for (const extra of opts.botUsernames ?? []) if (extra) usernames.add(extra);
if (ok) {
let label = "ok";
if (usernames.size > 0) label += ` (@${Array.from(usernames).join(", @")})`;
if (elapsedMs != null) label += ` (${elapsedMs}ms)`;
if (webhookUrl) label += ` - webhook ${webhookUrl}`;
return label;
}
let label = `failed (${status ?? "unknown"})`;
if (error) label += ` - ${error}`;
return label;
};
const formatAccountProbeTiming = (summary) => {
const probe = asRecord(summary.probe);
if (!probe) return null;
const elapsedMs = typeof probe.elapsedMs === "number" ? Math.round(probe.elapsedMs) : null;
const ok = typeof probe.ok === "boolean" ? probe.ok : null;
if (elapsedMs == null && ok !== true) return null;
const accountId = summary.accountId || "default";
const botRecord = asRecord(probe.bot);
const botUsername = botRecord && typeof botRecord.username === "string" ? botRecord.username : null;
return `${botUsername ? `@${botUsername}` : accountId}:${accountId}:${elapsedMs != null ? `${elapsedMs}ms` : "ok"}`;
};
const isProbeFailure = (summary) => {
const probe = asRecord(summary.probe);
if (!probe) return false;
return (typeof probe.ok === "boolean" ? probe.ok : null) === false;
};
function styleHealthChannelLine(line) {
const colon = line.indexOf(":");
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")) return applyPrefix("failed", theme.error);
if (normalized.startsWith("ok")) return applyPrefix("ok", theme.success);
if (normalized.startsWith("linked")) return applyPrefix("linked", theme.success);
if (normalized.startsWith("configured")) return applyPrefix("configured", theme.success);
if (normalized.startsWith("not linked")) return applyPrefix("not linked", theme.warn);
if (normalized.startsWith("not configured")) return applyPrefix("not configured", theme.muted);
if (normalized.startsWith("unknown")) return applyPrefix("unknown", theme.warn);
return line;
}
const formatHealthChannelLines = (summary, opts = {}) => {
const channels = summary.channels ?? {};
const channelOrder = summary.channelOrder?.length > 0 ? summary.channelOrder : Object.keys(channels);
const accountMode = opts.accountMode ?? "default";
const lines = [];
for (const channelId of channelOrder) {
const channelSummary = channels[channelId];
if (!channelSummary) continue;
const plugin = getChannelPlugin(channelId);
const label = summary.channelLabels?.[channelId] ?? plugin?.meta.label ?? channelId;
const accountSummaries = channelSummary.accounts ?? {};
const accountIds = opts.accountIdsByChannel?.[channelId];
const filteredSummaries = accountIds && accountIds.length > 0 ? accountIds.map((accountId) => accountSummaries[accountId]).filter((entry) => Boolean(entry)) : void 0;
const listSummaries = accountMode === "all" ? Object.values(accountSummaries) : filteredSummaries ?? (channelSummary.accounts ? Object.values(accountSummaries) : []);
const baseSummary = filteredSummaries && filteredSummaries.length > 0 ? filteredSummaries[0] : channelSummary;
const botUsernames = listSummaries ? listSummaries.map((account) => {
const probeRecord = asRecord(account.probe);
const bot = probeRecord ? asRecord(probeRecord.bot) : null;
return bot && typeof bot.username === "string" ? bot.username : null;
}).filter((value) => Boolean(value)) : [];
const linked = typeof baseSummary.linked === "boolean" ? baseSummary.linked : null;
if (linked !== null) {
if (linked) {
const authAgeMs = typeof baseSummary.authAgeMs === "number" ? baseSummary.authAgeMs : null;
const authLabel = authAgeMs != null ? ` (auth age ${Math.round(authAgeMs / 6e4)}m)` : "";
lines.push(`${label}: linked${authLabel}`);
} else lines.push(`${label}: not linked`);
continue;
}
const configured = typeof baseSummary.configured === "boolean" ? baseSummary.configured : null;
if (configured === false) {
lines.push(`${label}: not configured`);
continue;
}
const accountTimings = accountMode === "all" ? listSummaries.map((account) => formatAccountProbeTiming(account)).filter((value) => Boolean(value)) : [];
const failedSummary = listSummaries.find((summary) => isProbeFailure(summary));
if (failedSummary) {
const failureLine = formatProbeLine(failedSummary.probe, { botUsernames });
if (failureLine) {
lines.push(`${label}: ${failureLine}`);
continue;
}
}
if (accountTimings.length > 0) {
lines.push(`${label}: ok (${accountTimings.join(", ")})`);
continue;
}
const probeLine = formatProbeLine(baseSummary.probe, { botUsernames });
if (probeLine) {
lines.push(`${label}: ${probeLine}`);
continue;
}
if (configured === true) {
lines.push(`${label}: configured`);
continue;
}
lines.push(`${label}: unknown`);
}
return lines;
};
async function getHealthSnapshot(params) {
const timeoutMs = params?.timeoutMs;
const cfg = loadConfig();
const { defaultAgentId, ordered } = resolveAgentOrder(cfg);
const channelBindings = buildChannelAccountBindings(cfg);
const sessionCache = /* @__PURE__ */ new Map();
const agents = ordered.map((entry) => {
const storePath = resolveStorePath(cfg.session?.store, { agentId: entry.id });
const sessions = sessionCache.get(storePath) ?? buildSessionSummary(storePath);
sessionCache.set(storePath, sessions);
return {
agentId: entry.id,
name: entry.name,
isDefault: entry.id === defaultAgentId,
heartbeat: resolveHeartbeatSummary(cfg, entry.id),
sessions
};
});
const defaultAgent = agents.find((agent) => agent.isDefault) ?? agents[0];
const heartbeatSeconds = defaultAgent?.heartbeat.everyMs ? Math.round(defaultAgent.heartbeat.everyMs / 1e3) : 0;
const sessions = defaultAgent?.sessions ?? buildSessionSummary(resolveStorePath(cfg.session?.store, { agentId: defaultAgentId }));
const start = Date.now();
const cappedTimeout = Math.max(1e3, timeoutMs ?? DEFAULT_TIMEOUT_MS);
const doProbe = params?.probe !== false;
const channels = {};
const channelOrder = listChannelPlugins().map((plugin) => plugin.id);
const channelLabels = {};
for (const plugin of listChannelPlugins()) {
channelLabels[plugin.id] = plugin.meta.label ?? plugin.id;
const accountIds = plugin.config.listAccountIds(cfg);
const defaultAccountId = resolveChannelDefaultAccountId({
plugin,
cfg,
accountIds
});
const boundAccounts = channelBindings.get(plugin.id)?.get(defaultAgentId) ?? [];
const preferredAccountId = resolvePreferredAccountId({
accountIds,
defaultAccountId,
boundAccounts
});
const boundAccountIdsAll = Array.from(new Set(Array.from(channelBindings.get(plugin.id)?.values() ?? []).flatMap((ids) => ids)));
const accountIdsToProbe = Array.from(new Set([
preferredAccountId,
defaultAccountId,
...accountIds,
...boundAccountIdsAll
].filter((value) => value && value.trim())));
debugHealth("channel", {
id: plugin.id,
accountIds,
defaultAccountId,
boundAccounts,
preferredAccountId,
accountIdsToProbe
});
const accountSummaries = {};
for (const accountId of accountIdsToProbe) {
const account = plugin.config.resolveAccount(cfg, accountId);
const enabled = plugin.config.isEnabled ? plugin.config.isEnabled(account, cfg) : isAccountEnabled(account);
const configured = plugin.config.isConfigured ? await plugin.config.isConfigured(account, cfg) : true;
let probe;
let lastProbeAt = null;
if (enabled && configured && doProbe && plugin.status?.probeAccount) try {
probe = await plugin.status.probeAccount({
account,
timeoutMs: cappedTimeout,
cfg
});
lastProbeAt = Date.now();
} catch (err) {
probe = {
ok: false,
error: formatErrorMessage(err)
};
lastProbeAt = Date.now();
}
const probeRecord = probe && typeof probe === "object" ? probe : null;
const bot = probeRecord && typeof probeRecord.bot === "object" ? probeRecord.bot : null;
if (bot?.username) debugHealth("probe.bot", {
channel: plugin.id,
accountId,
username: bot.username
});
const snapshot = {
accountId,
enabled,
configured
};
if (probe !== void 0) snapshot.probe = probe;
if (lastProbeAt) snapshot.lastProbeAt = lastProbeAt;
const summary = plugin.status?.buildChannelSummary ? await plugin.status.buildChannelSummary({
account,
cfg,
defaultAccountId: accountId,
snapshot
}) : void 0;
const record = summary && typeof summary === "object" ? summary : {
accountId,
configured,
probe,
lastProbeAt
};
if (record.configured === void 0) record.configured = configured;
if (record.lastProbeAt === void 0 && lastProbeAt) record.lastProbeAt = lastProbeAt;
record.accountId = accountId;
accountSummaries[accountId] = record;
}
const fallbackSummary = accountSummaries[preferredAccountId] ?? accountSummaries[defaultAccountId] ?? accountSummaries[accountIdsToProbe[0] ?? preferredAccountId] ?? accountSummaries[Object.keys(accountSummaries)[0]];
if (fallbackSummary) channels[plugin.id] = {
...fallbackSummary,
accounts: accountSummaries
};
}
return {
ok: true,
ts: Date.now(),
durationMs: Date.now() - start,
channels,
channelOrder,
channelLabels,
heartbeatSeconds,
defaultAgentId,
agents,
sessions: {
path: sessions.path,
count: sessions.count,
recent: sessions.recent
}
};
}
async function healthCommand(opts, runtime) {
const cfg = opts.config ?? loadConfig();
const summary = await withProgress({
label: "Checking gateway health…",
indeterminate: true,
enabled: opts.json !== true
}, async () => await callGateway({
method: "health",
params: opts.verbose ? { probe: true } : void 0,
timeoutMs: opts.timeoutMs,
config: cfg
}));
if (opts.json) runtime.log(JSON.stringify(summary, null, 2));
else {
const debugEnabled = isTruthyEnvValue(process.env.OPENCLAW_DEBUG_HEALTH);
if (opts.verbose) {
const details = buildGatewayConnectionDetails({ config: cfg });
runtime.log(info("Gateway connection:"));
for (const line of details.message.split("\n")) runtime.log(` ${line}`);
}
const localAgents = resolveAgentOrder(cfg);
const defaultAgentId = summary.defaultAgentId ?? localAgents.defaultAgentId;
const agents = Array.isArray(summary.agents) ? summary.agents : [];
const fallbackAgents = localAgents.ordered.map((entry) => {
const storePath = resolveStorePath(cfg.session?.store, { agentId: entry.id });
return {
agentId: entry.id,
name: entry.name,
isDefault: entry.id === localAgents.defaultAgentId,
heartbeat: resolveHeartbeatSummary(cfg, entry.id),
sessions: buildSessionSummary(storePath)
};
});
const resolvedAgents = agents.length > 0 ? agents : fallbackAgents;
const displayAgents = opts.verbose ? resolvedAgents : resolvedAgents.filter((agent) => agent.agentId === defaultAgentId);
const channelBindings = buildChannelAccountBindings(cfg);
if (debugEnabled) {
runtime.log(info("[debug] local channel accounts"));
for (const plugin of listChannelPlugins()) {
const accountIds = plugin.config.listAccountIds(cfg);
const defaultAccountId = resolveChannelDefaultAccountId({
plugin,
cfg,
accountIds
});
runtime.log(` ${plugin.id}: accounts=${accountIds.join(", ") || "(none)"} default=${defaultAccountId}`);
for (const accountId of accountIds) {
const account = plugin.config.resolveAccount(cfg, accountId);
const record = asRecord(account);
const tokenSource = record && typeof record.tokenSource === "string" ? record.tokenSource : void 0;
const configured = plugin.config.isConfigured ? await plugin.config.isConfigured(account, cfg) : true;
runtime.log(` - ${accountId}: configured=${configured}${tokenSource ? ` tokenSource=${tokenSource}` : ""}`);
}
}
runtime.log(info("[debug] bindings map"));
for (const [channelId, byAgent] of channelBindings.entries()) {
const entries = Array.from(byAgent.entries()).map(([agentId, ids]) => `${agentId}=[${ids.join(", ")}]`);
runtime.log(` ${channelId}: ${entries.join(" ")}`);
}
runtime.log(info("[debug] gateway channel probes"));
for (const [channelId, channelSummary] of Object.entries(summary.channels ?? {})) {
const accounts = channelSummary.accounts ?? {};
const probes = Object.entries(accounts).map(([accountId, accountSummary]) => {
const probe = asRecord(accountSummary.probe);
const bot = probe ? asRecord(probe.bot) : null;
return `${accountId}=${(bot && typeof bot.username === "string" ? bot.username : null) ?? "(no bot)"}`;
});
runtime.log(` ${channelId}: ${probes.join(", ") || "(none)"}`);
}
}
const channelAccountFallbacks = Object.fromEntries(listChannelPlugins().map((plugin) => {
const accountIds = plugin.config.listAccountIds(cfg);
const preferred = resolvePreferredAccountId({
accountIds,
defaultAccountId: resolveChannelDefaultAccountId({
plugin,
cfg,
accountIds
}),
boundAccounts: channelBindings.get(plugin.id)?.get(defaultAgentId) ?? []
});
return [plugin.id, [preferred]];
}));
const accountIdsByChannel = (() => {
const entries = displayAgents.length > 0 ? displayAgents : resolvedAgents;
const byChannel = {};
for (const [channelId, byAgent] of channelBindings.entries()) {
const accountIds = [];
for (const agent of entries) {
const ids = byAgent.get(agent.agentId) ?? [];
for (const id of ids) if (!accountIds.includes(id)) accountIds.push(id);
}
if (accountIds.length > 0) byChannel[channelId] = accountIds;
}
for (const [channelId, fallbackIds] of Object.entries(channelAccountFallbacks)) if (!byChannel[channelId] || byChannel[channelId].length === 0) byChannel[channelId] = fallbackIds;
return byChannel;
})();
const channelLines = Object.keys(accountIdsByChannel).length > 0 ? formatHealthChannelLines(summary, {
accountMode: opts.verbose ? "all" : "default",
accountIdsByChannel
}) : formatHealthChannelLines(summary, { accountMode: opts.verbose ? "all" : "default" });
for (const line of channelLines) runtime.log(styleHealthChannelLine(line));
for (const plugin of listChannelPlugins()) {
const channelSummary = summary.channels?.[plugin.id];
if (!channelSummary || channelSummary.linked !== true) continue;
if (!plugin.status?.logSelfId) continue;
const boundAccounts = channelBindings.get(plugin.id)?.get(defaultAgentId) ?? [];
const accountIds = plugin.config.listAccountIds(cfg);
const accountId = resolvePreferredAccountId({
accountIds,
defaultAccountId: resolveChannelDefaultAccountId({
plugin,
cfg,
accountIds
}),
boundAccounts
});
const account = plugin.config.resolveAccount(cfg, accountId);
plugin.status.logSelfId({
account,
cfg,
runtime,
includeChannelPrefix: true
});
}
if (resolvedAgents.length > 0) {
const agentLabels = resolvedAgents.map((agent) => agent.isDefault ? `${agent.agentId} (default)` : agent.agentId);
runtime.log(info(`Agents: ${agentLabels.join(", ")}`));
}
const heartbeatParts = displayAgents.map((agent) => {
const everyMs = agent.heartbeat?.everyMs;
return `${everyMs ? formatDurationParts(everyMs) : "disabled"} (${agent.agentId})`;
}).filter(Boolean);
if (heartbeatParts.length > 0) runtime.log(info(`Heartbeat interval: ${heartbeatParts.join(", ")}`));
if (displayAgents.length === 0) {
runtime.log(info(`Session store: ${summary.sessions.path} (${summary.sessions.count} entries)`));
if (summary.sessions.recent.length > 0) for (const r of summary.sessions.recent) runtime.log(`- ${r.key} (${r.updatedAt ? `${Math.round((Date.now() - r.updatedAt) / 6e4)}m ago` : "no activity"})`);
} else for (const agent of displayAgents) {
runtime.log(info(`Session store (${agent.agentId}): ${agent.sessions.path} (${agent.sessions.count} entries)`));
if (agent.sessions.recent.length > 0) for (const r of agent.sessions.recent) runtime.log(`- ${r.key} (${r.updatedAt ? `${Math.round((Date.now() - r.updatedAt) / 6e4)}m ago` : "no activity"})`);
}
}
}
//#endregion
//#region src/infra/control-ui-assets.ts
const CONTROL_UI_DIST_PATH_SEGMENTS = [
"dist",
"control-ui",
"index.html"
];
function resolveControlUiDistIndexPathForRoot(root) {
return path.join(root, ...CONTROL_UI_DIST_PATH_SEGMENTS);
}
async function resolveControlUiDistIndexHealth(opts = {}) {
const indexPath = opts.root ? resolveControlUiDistIndexPathForRoot(opts.root) : await resolveControlUiDistIndexPath(opts.argv1 ?? process.argv[1]);
return {
indexPath,
exists: Boolean(indexPath && fs.existsSync(indexPath))
};
}
function resolveControlUiRepoRoot(argv1 = process.argv[1]) {
if (!argv1) return null;
const normalized = path.resolve(argv1);
const parts = normalized.split(path.sep);
const srcIndex = parts.lastIndexOf("src");
if (srcIndex !== -1) {
const root = parts.slice(0, srcIndex).join(path.sep);
if (fs.existsSync(path.join(root, "ui", "vite.config.ts"))) return root;
}
let dir = path.dirname(normalized);
for (let i = 0; i < 8; i++) {
if (fs.existsSync(path.join(dir, "package.json")) && fs.existsSync(path.join(dir, "ui", "vite.config.ts"))) return dir;
const parent = path.dirname(dir);
if (parent === dir) break;
dir = parent;
}
return null;
}
async function resolveControlUiDistIndexPath(argv1 = process.argv[1]) {
if (!argv1) return null;
const normalized = path.resolve(argv1);
const distDir = path.dirname(normalized);
if (path.basename(distDir) === "dist") return path.join(distDir, "control-ui", "index.html");
const packageRoot = await resolveOpenClawPackageRoot({ argv1: normalized });
if (packageRoot) return path.join(packageRoot, "dist", "control-ui", "index.html");
let dir = path.dirname(normalized);
for (let i = 0; i < 8; i++) {
const pkgJsonPath = path.join(dir, "package.json");
const indexPath = path.join(dir, "dist", "control-ui", "index.html");
if (fs.existsSync(pkgJsonPath) && fs.existsSync(indexPath)) try {
const raw = fs.readFileSync(pkgJsonPath, "utf-8");
if (JSON.parse(raw).name === "openclaw") return indexPath;
} catch {}
const parent = path.dirname(dir);
if (parent === dir) break;
dir = parent;
}
return null;
}
function addCandidate(candidates, value) {
if (!value) return;
candidates.add(path.resolve(value));
}
function resolveControlUiRootOverrideSync(rootOverride) {
const resolved = path.resolve(rootOverride);
try {
const stats = fs.statSync(resolved);
if (stats.isFile()) return path.basename(resolved) === "index.html" ? path.dirname(resolved) : null;
if (stats.isDirectory()) {
const indexPath = path.join(resolved, "index.html");
return fs.existsSync(indexPath) ? resolved : null;
}
} catch {
return null;
}
return null;
}
function resolveControlUiRootSync(opts = {}) {
const candidates = /* @__PURE__ */ new Set();
const argv1 = opts.argv1 ?? process.argv[1];
const cwd = opts.cwd ?? process.cwd();
const moduleDir = opts.moduleUrl ? path.dirname(fileURLToPath(opts.moduleUrl)) : null;
const argv1Dir = argv1 ? path.dirname(path.resolve(argv1)) : null;
const execDir = (() => {
try {
const execPath = opts.execPath ?? process.execPath;
return path.dirname(fs.realpathSync(execPath));
} catch {
return null;
}
})();
const packageRoot = resolveOpenClawPackageRootSync({
argv1,
moduleUrl: opts.moduleUrl,
cwd
});
addCandidate(candidates, execDir ? path.join(execDir, "control-ui") : null);
if (moduleDir) {
addCandidate(candidates, path.join(moduleDir, "control-ui"));
addCandidate(candidates, path.join(moduleDir, "../control-ui"));
addCandidate(candidates, path.join(moduleDir, "../../dist/control-ui"));
}
if (argv1Dir) {
addCandidate(candidates, path.join(argv1Dir, "dist", "control-ui"));
addCandidate(candidates, path.join(argv1Dir, "control-ui"));
}
if (packageRoot) addCandidate(candidates, path.join(packageRoot, "dist", "control-ui"));
addCandidate(candidates, path.join(cwd, "dist", "control-ui"));
for (const dir of candidates) {
const indexPath = path.join(dir, "index.html");
if (fs.existsSync(indexPath)) return dir;
}
return null;
}
function summarizeCommandOutput(text) {
const lines = text.split(/\r?\n/g).map((l) => l.trim()).filter(Boolean);
if (!lines.length) return;
const last = lines.at(-1);
if (!last) return;
return last.length > 240 ? `${last.slice(0, 239)}…` : last;
}
async function ensureControlUiAssetsBuilt(runtime = defaultRuntime, opts) {
cons