@farazirfan/costar-server-executor 1.0.0

package/dist/infra/restart.js

@@ -0,0 +1,172 @@
+import { spawnSync } from "node:child_process";
+import { resolveGatewayLaunchAgentLabel, resolveGatewaySystemdServiceName, } from "../daemon/constants.js";
+const SPAWN_TIMEOUT_MS = 2000;
+const SIGUSR1_AUTH_GRACE_MS = 5000;
+let sigusr1AuthorizedCount = 0;
+let sigusr1AuthorizedUntil = 0;
+let sigusr1ExternalAllowed = false;
+function resetSigusr1AuthorizationIfExpired(now = Date.now()) {
+    if (sigusr1AuthorizedCount <= 0)
+        return;
+    if (now <= sigusr1AuthorizedUntil)
+        return;
+    sigusr1AuthorizedCount = 0;
+    sigusr1AuthorizedUntil = 0;
+}
+export function setGatewaySigusr1RestartPolicy(opts) {
+    sigusr1ExternalAllowed = opts?.allowExternal === true;
+}
+export function isGatewaySigusr1RestartExternallyAllowed() {
+    return sigusr1ExternalAllowed;
+}
+export function authorizeGatewaySigusr1Restart(delayMs = 0) {
+    const delay = Math.max(0, Math.floor(delayMs));
+    const expiresAt = Date.now() + delay + SIGUSR1_AUTH_GRACE_MS;
+    sigusr1AuthorizedCount += 1;
+    if (expiresAt > sigusr1AuthorizedUntil) {
+        sigusr1AuthorizedUntil = expiresAt;
+    }
+}
+export function consumeGatewaySigusr1RestartAuthorization() {
+    resetSigusr1AuthorizationIfExpired();
+    if (sigusr1AuthorizedCount <= 0)
+        return false;
+    sigusr1AuthorizedCount -= 1;
+    if (sigusr1AuthorizedCount <= 0) {
+        sigusr1AuthorizedUntil = 0;
+    }
+    return true;
+}
+function formatSpawnDetail(result) {
+    const clean = (value) => {
+        const text = typeof value === "string" ? value : value ? value.toString() : "";
+        return text.replace(/\s+/g, " ").trim();
+    };
+    if (result.error) {
+        if (result.error instanceof Error)
+            return result.error.message;
+        if (typeof result.error === "string")
+            return result.error;
+        try {
+            return JSON.stringify(result.error);
+        }
+        catch {
+            return "unknown error";
+        }
+    }
+    const stderr = clean(result.stderr);
+    if (stderr)
+        return stderr;
+    const stdout = clean(result.stdout);
+    if (stdout)
+        return stdout;
+    if (typeof result.status === "number")
+        return `exit ${result.status}`;
+    return "unknown error";
+}
+function normalizeSystemdUnit(raw, profile) {
+    const unit = raw?.trim();
+    if (!unit) {
+        return `${resolveGatewaySystemdServiceName(profile)}.service`;
+    }
+    return unit.endsWith(".service") ? unit : `${unit}.service`;
+}
+export function triggerOpenClawRestart() {
+    if (process.env.VITEST || process.env.NODE_ENV === "test") {
+        return { ok: true, method: "supervisor", detail: "test mode" };
+    }
+    const tried = [];
+    if (process.platform !== "darwin") {
+        if (process.platform === "linux") {
+            const unit = normalizeSystemdUnit(process.env.OPENCLAW_SYSTEMD_UNIT, process.env.OPENCLAW_PROFILE);
+            const userArgs = ["--user", "restart", unit];
+            tried.push(`systemctl ${userArgs.join(" ")}`);
+            const userRestart = spawnSync("systemctl", userArgs, {
+                encoding: "utf8",
+                timeout: SPAWN_TIMEOUT_MS,
+            });
+            if (!userRestart.error && userRestart.status === 0) {
+                return { ok: true, method: "systemd", tried };
+            }
+            const systemArgs = ["restart", unit];
+            tried.push(`systemctl ${systemArgs.join(" ")}`);
+            const systemRestart = spawnSync("systemctl", systemArgs, {
+                encoding: "utf8",
+                timeout: SPAWN_TIMEOUT_MS,
+            });
+            if (!systemRestart.error && systemRestart.status === 0) {
+                return { ok: true, method: "systemd", tried };
+            }
+            const detail = [
+                `user: ${formatSpawnDetail(userRestart)}`,
+                `system: ${formatSpawnDetail(systemRestart)}`,
+            ].join("; ");
+            return { ok: false, method: "systemd", detail, tried };
+        }
+        return {
+            ok: false,
+            method: "supervisor",
+            detail: "unsupported platform restart",
+        };
+    }
+    const label = process.env.OPENCLAW_LAUNCHD_LABEL ||
+        resolveGatewayLaunchAgentLabel(process.env.OPENCLAW_PROFILE);
+    const uid = typeof process.getuid === "function" ? process.getuid() : undefined;
+    const target = uid !== undefined ? `gui/${uid}/${label}` : label;
+    const args = ["kickstart", "-k", target];
+    tried.push(`launchctl ${args.join(" ")}`);
+    const res = spawnSync("launchctl", args, {
+        encoding: "utf8",
+        timeout: SPAWN_TIMEOUT_MS,
+    });
+    if (!res.error && res.status === 0) {
+        return { ok: true, method: "launchctl", tried };
+    }
+    return {
+        ok: false,
+        method: "launchctl",
+        detail: formatSpawnDetail(res),
+        tried,
+    };
+}
+export function scheduleGatewaySigusr1Restart(opts) {
+    const delayMsRaw = typeof opts?.delayMs === "number" && Number.isFinite(opts.delayMs)
+        ? Math.floor(opts.delayMs)
+        : 2000;
+    const delayMs = Math.min(Math.max(delayMsRaw, 0), 60_000);
+    const reason = typeof opts?.reason === "string" && opts.reason.trim()
+        ? opts.reason.trim().slice(0, 200)
+        : undefined;
+    authorizeGatewaySigusr1Restart(delayMs);
+    const pid = process.pid;
+    const hasListener = process.listenerCount("SIGUSR1") > 0;
+    setTimeout(() => {
+        try {
+            if (hasListener) {
+                process.emit("SIGUSR1");
+            }
+            else {
+                process.kill(pid, "SIGUSR1");
+            }
+        }
+        catch {
+            /* ignore */
+        }
+    }, delayMs);
+    return {
+        ok: true,
+        pid,
+        signal: "SIGUSR1",
+        delayMs,
+        reason,
+        mode: hasListener ? "emit" : "signal",
+    };
+}
+export const __testing = {
+    resetSigusr1State() {
+        sigusr1AuthorizedCount = 0;
+        sigusr1AuthorizedUntil = 0;
+        sigusr1ExternalAllowed = false;
+    },
+};
+//# sourceMappingURL=restart.js.map

package/dist/infra/restart.js.map

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

package/dist/infra/retry-policy.d.ts

@@ -0,0 +1,26 @@
+import { type RetryConfig } from "./retry.js";
+export type RetryRunner = <T>(fn: () => Promise<T>, label?: string) => Promise<T>;
+export declare const DISCORD_RETRY_DEFAULTS: {
+    attempts: number;
+    minDelayMs: number;
+    maxDelayMs: number;
+    jitter: number;
+};
+export declare const TELEGRAM_RETRY_DEFAULTS: {
+    attempts: number;
+    minDelayMs: number;
+    maxDelayMs: number;
+    jitter: number;
+};
+export declare function createDiscordRetryRunner(params: {
+    retry?: RetryConfig;
+    configRetry?: RetryConfig;
+    verbose?: boolean;
+}): RetryRunner;
+export declare function createTelegramRetryRunner(params: {
+    retry?: RetryConfig;
+    configRetry?: RetryConfig;
+    verbose?: boolean;
+    shouldRetry?: (err: unknown) => boolean;
+}): RetryRunner;
+//# sourceMappingURL=retry-policy.d.ts.map

package/dist/infra/retry-policy.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"retry-policy.d.ts","sourceRoot":"","sources":["../../src/infra/retry-policy.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,KAAK,WAAW,EAAkC,MAAM,YAAY,CAAC;AAE9E,MAAM,MAAM,WAAW,GAAG,CAAC,CAAC,EAAE,EAAE,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,EAAE,KAAK,CAAC,EAAE,MAAM,KAAK,OAAO,CAAC,CAAC,CAAC,CAAC;AAElF,eAAO,MAAM,sBAAsB;;;;;CAKlC,CAAC;AAEF,eAAO,MAAM,uBAAuB;;;;;CAKnC,CAAC;AAwBF,wBAAgB,wBAAwB,CAAC,MAAM,EAAE;IAC/C,KAAK,CAAC,EAAE,WAAW,CAAC;IACpB,WAAW,CAAC,EAAE,WAAW,CAAC;IAC1B,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB,GAAG,WAAW,CAqBd;AAED,wBAAgB,yBAAyB,CAAC,MAAM,EAAE;IAChD,KAAK,CAAC,EAAE,WAAW,CAAC;IACpB,WAAW,CAAC,EAAE,WAAW,CAAC;IAC1B,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,WAAW,CAAC,EAAE,CAAC,GAAG,EAAE,OAAO,KAAK,OAAO,CAAC;CACzC,GAAG,WAAW,CAwBd"}

package/dist/infra/retry-policy.js

@@ -0,0 +1,72 @@
+import { RateLimitError } from "@buape/carbon";
+import { formatErrorMessage } from "./errors.js";
+import { resolveRetryConfig, retryAsync } from "./retry.js";
+export const DISCORD_RETRY_DEFAULTS = {
+    attempts: 3,
+    minDelayMs: 500,
+    maxDelayMs: 30_000,
+    jitter: 0.1,
+};
+export const TELEGRAM_RETRY_DEFAULTS = {
+    attempts: 3,
+    minDelayMs: 400,
+    maxDelayMs: 30_000,
+    jitter: 0.1,
+};
+const TELEGRAM_RETRY_RE = /429|timeout|connect|reset|closed|unavailable|temporarily/i;
+function getTelegramRetryAfterMs(err) {
+    if (!err || typeof err !== "object")
+        return undefined;
+    const candidate = "parameters" in err && err.parameters && typeof err.parameters === "object"
+        ? err.parameters.retry_after
+        : "response" in err &&
+            err.response &&
+            typeof err.response === "object" &&
+            "parameters" in err.response
+            ? err.response.parameters?.retry_after
+            : "error" in err && err.error && typeof err.error === "object" && "parameters" in err.error
+                ? err.error.parameters?.retry_after
+                : undefined;
+    return typeof candidate === "number" && Number.isFinite(candidate) ? candidate * 1000 : undefined;
+}
+export function createDiscordRetryRunner(params) {
+    const retryConfig = resolveRetryConfig(DISCORD_RETRY_DEFAULTS, {
+        ...params.configRetry,
+        ...params.retry,
+    });
+    return (fn, label) => retryAsync(fn, {
+        ...retryConfig,
+        label,
+        shouldRetry: (err) => err instanceof RateLimitError,
+        retryAfterMs: (err) => (err instanceof RateLimitError ? err.retryAfter * 1000 : undefined),
+        onRetry: params.verbose
+            ? (info) => {
+                const labelText = info.label ?? "request";
+                const maxRetries = Math.max(1, info.maxAttempts - 1);
+                console.warn(`discord ${labelText} rate limited, retry ${info.attempt}/${maxRetries} in ${info.delayMs}ms`);
+            }
+            : undefined,
+    });
+}
+export function createTelegramRetryRunner(params) {
+    const retryConfig = resolveRetryConfig(TELEGRAM_RETRY_DEFAULTS, {
+        ...params.configRetry,
+        ...params.retry,
+    });
+    const shouldRetry = params.shouldRetry
+        ? (err) => params.shouldRetry?.(err) || TELEGRAM_RETRY_RE.test(formatErrorMessage(err))
+        : (err) => TELEGRAM_RETRY_RE.test(formatErrorMessage(err));
+    return (fn, label) => retryAsync(fn, {
+        ...retryConfig,
+        label,
+        shouldRetry,
+        retryAfterMs: getTelegramRetryAfterMs,
+        onRetry: params.verbose
+            ? (info) => {
+                const maxRetries = Math.max(1, info.maxAttempts - 1);
+                console.warn(`telegram send retry ${info.attempt}/${maxRetries} for ${info.label ?? label ?? "request"} in ${info.delayMs}ms: ${formatErrorMessage(info.err)}`);
+            }
+            : undefined,
+    });
+}
+//# sourceMappingURL=retry-policy.js.map

package/dist/infra/retry-policy.js.map

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

package/dist/infra/retry.d.ts

@@ -0,0 +1,22 @@
+export type RetryConfig = {
+    attempts?: number;
+    minDelayMs?: number;
+    maxDelayMs?: number;
+    jitter?: number;
+};
+export type RetryInfo = {
+    attempt: number;
+    maxAttempts: number;
+    delayMs: number;
+    err: unknown;
+    label?: string;
+};
+export type RetryOptions = RetryConfig & {
+    label?: string;
+    shouldRetry?: (err: unknown, attempt: number) => boolean;
+    retryAfterMs?: (err: unknown) => number | undefined;
+    onRetry?: (info: RetryInfo) => void;
+};
+export declare function resolveRetryConfig(defaults?: Required<RetryConfig>, overrides?: RetryConfig): Required<RetryConfig>;
+export declare function retryAsync<T>(fn: () => Promise<T>, attemptsOrOptions?: number | RetryOptions, initialDelayMs?: number): Promise<T>;
+//# sourceMappingURL=retry.d.ts.map

package/dist/infra/retry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"retry.d.ts","sourceRoot":"","sources":["../../src/infra/retry.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,WAAW,GAAG;IACxB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB,CAAC;AAEF,MAAM,MAAM,SAAS,GAAG;IACtB,OAAO,EAAE,MAAM,CAAC;IAChB,WAAW,EAAE,MAAM,CAAC;IACpB,OAAO,EAAE,MAAM,CAAC;IAChB,GAAG,EAAE,OAAO,CAAC;IACb,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB,CAAC;AAEF,MAAM,MAAM,YAAY,GAAG,WAAW,GAAG;IACvC,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,WAAW,CAAC,EAAE,CAAC,GAAG,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,KAAK,OAAO,CAAC;IACzD,YAAY,CAAC,EAAE,CAAC,GAAG,EAAE,OAAO,KAAK,MAAM,GAAG,SAAS,CAAC;IACpD,OAAO,CAAC,EAAE,CAAC,IAAI,EAAE,SAAS,KAAK,IAAI,CAAC;CACrC,CAAC;AAsBF,wBAAgB,kBAAkB,CAChC,QAAQ,GAAE,QAAQ,CAAC,WAAW,CAAwB,EACtD,SAAS,CAAC,EAAE,WAAW,GACtB,QAAQ,CAAC,WAAW,CAAC,CAYvB;AAQD,wBAAsB,UAAU,CAAC,CAAC,EAChC,EAAE,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,EACpB,iBAAiB,GAAE,MAAM,GAAG,YAAgB,EAC5C,cAAc,SAAM,GACnB,OAAO,CAAC,CAAC,CAAC,CA0DZ"}

package/dist/infra/retry.js

@@ -0,0 +1,86 @@
+const DEFAULT_RETRY_CONFIG = {
+    attempts: 3,
+    minDelayMs: 300,
+    maxDelayMs: 30_000,
+    jitter: 0,
+};
+const sleep = (ms) => new Promise((r) => setTimeout(r, ms));
+const asFiniteNumber = (value) => typeof value === "number" && Number.isFinite(value) ? value : undefined;
+const clampNumber = (value, fallback, min, max) => {
+    const next = asFiniteNumber(value);
+    if (next === undefined)
+        return fallback;
+    const floor = typeof min === "number" ? min : Number.NEGATIVE_INFINITY;
+    const ceiling = typeof max === "number" ? max : Number.POSITIVE_INFINITY;
+    return Math.min(Math.max(next, floor), ceiling);
+};
+export function resolveRetryConfig(defaults = DEFAULT_RETRY_CONFIG, overrides) {
+    const attempts = Math.max(1, Math.round(clampNumber(overrides?.attempts, defaults.attempts, 1)));
+    const minDelayMs = Math.max(0, Math.round(clampNumber(overrides?.minDelayMs, defaults.minDelayMs, 0)));
+    const maxDelayMs = Math.max(minDelayMs, Math.round(clampNumber(overrides?.maxDelayMs, defaults.maxDelayMs, 0)));
+    const jitter = clampNumber(overrides?.jitter, defaults.jitter, 0, 1);
+    return { attempts, minDelayMs, maxDelayMs, jitter };
+}
+function applyJitter(delayMs, jitter) {
+    if (jitter <= 0)
+        return delayMs;
+    const offset = (Math.random() * 2 - 1) * jitter;
+    return Math.max(0, Math.round(delayMs * (1 + offset)));
+}
+export async function retryAsync(fn, attemptsOrOptions = 3, initialDelayMs = 300) {
+    if (typeof attemptsOrOptions === "number") {
+        const attempts = Math.max(1, Math.round(attemptsOrOptions));
+        let lastErr;
+        for (let i = 0; i < attempts; i += 1) {
+            try {
+                return await fn();
+            }
+            catch (err) {
+                lastErr = err;
+                if (i === attempts - 1)
+                    break;
+                const delay = initialDelayMs * 2 ** i;
+                await sleep(delay);
+            }
+        }
+        throw lastErr ?? new Error("Retry failed");
+    }
+    const options = attemptsOrOptions;
+    const resolved = resolveRetryConfig(DEFAULT_RETRY_CONFIG, options);
+    const maxAttempts = resolved.attempts;
+    const minDelayMs = resolved.minDelayMs;
+    const maxDelayMs = Number.isFinite(resolved.maxDelayMs) && resolved.maxDelayMs > 0
+        ? resolved.maxDelayMs
+        : Number.POSITIVE_INFINITY;
+    const jitter = resolved.jitter;
+    const shouldRetry = options.shouldRetry ?? (() => true);
+    let lastErr;
+    for (let attempt = 1; attempt <= maxAttempts; attempt += 1) {
+        try {
+            return await fn();
+        }
+        catch (err) {
+            lastErr = err;
+            if (attempt >= maxAttempts || !shouldRetry(err, attempt))
+                break;
+            const retryAfterMs = options.retryAfterMs?.(err);
+            const hasRetryAfter = typeof retryAfterMs === "number" && Number.isFinite(retryAfterMs);
+            const baseDelay = hasRetryAfter
+                ? Math.max(retryAfterMs, minDelayMs)
+                : minDelayMs * 2 ** (attempt - 1);
+            let delay = Math.min(baseDelay, maxDelayMs);
+            delay = applyJitter(delay, jitter);
+            delay = Math.min(Math.max(delay, minDelayMs), maxDelayMs);
+            options.onRetry?.({
+                attempt,
+                maxAttempts,
+                delayMs: delay,
+                err,
+                label: options.label,
+            });
+            await sleep(delay);
+        }
+    }
+    throw lastErr ?? new Error("Retry failed");
+}
+//# sourceMappingURL=retry.js.map

package/dist/infra/retry.js.map

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

package/dist/infra/runtime-guard.d.ts

@@ -0,0 +1,21 @@
+import { type RuntimeEnv } from "../runtime.js";
+export type RuntimeKind = "node" | "unknown";
+type Semver = {
+    major: number;
+    minor: number;
+    patch: number;
+};
+export type RuntimeDetails = {
+    kind: RuntimeKind;
+    version: string | null;
+    execPath: string | null;
+    pathEnv: string;
+};
+export declare function parseSemver(version: string | null): Semver | null;
+export declare function isAtLeast(version: Semver | null, minimum: Semver): boolean;
+export declare function detectRuntime(): RuntimeDetails;
+export declare function runtimeSatisfies(details: RuntimeDetails): boolean;
+export declare function isSupportedNodeVersion(version: string | null): boolean;
+export declare function assertSupportedRuntime(runtime?: RuntimeEnv, details?: RuntimeDetails): void;
+export {};
+//# sourceMappingURL=runtime-guard.d.ts.map

package/dist/infra/runtime-guard.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"runtime-guard.d.ts","sourceRoot":"","sources":["../../src/infra/runtime-guard.ts"],"names":[],"mappings":"AAEA,OAAO,EAAkB,KAAK,UAAU,EAAE,MAAM,eAAe,CAAC;AAEhE,MAAM,MAAM,WAAW,GAAG,MAAM,GAAG,SAAS,CAAC;AAE7C,KAAK,MAAM,GAAG;IACZ,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;CACf,CAAC;AAIF,MAAM,MAAM,cAAc,GAAG;IAC3B,IAAI,EAAE,WAAW,CAAC;IAClB,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IACvB,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,OAAO,EAAE,MAAM,CAAC;CACjB,CAAC;AAIF,wBAAgB,WAAW,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,GAAG,MAAM,GAAG,IAAI,CAUjE;AAED,wBAAgB,SAAS,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAK1E;AAED,wBAAgB,aAAa,IAAI,cAAc,CAU9C;AAED,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,cAAc,GAAG,OAAO,CAIjE;AAED,wBAAgB,sBAAsB,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,GAAG,OAAO,CAEtE;AAED,wBAAgB,sBAAsB,CACpC,OAAO,GAAE,UAA2B,EACpC,OAAO,GAAE,cAAgC,GACxC,IAAI,CAkBN"}

package/dist/infra/runtime-guard.js

@@ -0,0 +1,61 @@
+import process from "node:process";
+import { defaultRuntime } from "../runtime.js";
+const MIN_NODE = { major: 22, minor: 0, patch: 0 };
+const SEMVER_RE = /(\d+)\.(\d+)\.(\d+)/;
+export function parseSemver(version) {
+    if (!version)
+        return null;
+    const match = version.match(SEMVER_RE);
+    if (!match)
+        return null;
+    const [, major, minor, patch] = match;
+    return {
+        major: Number.parseInt(major, 10),
+        minor: Number.parseInt(minor, 10),
+        patch: Number.parseInt(patch, 10),
+    };
+}
+export function isAtLeast(version, minimum) {
+    if (!version)
+        return false;
+    if (version.major !== minimum.major)
+        return version.major > minimum.major;
+    if (version.minor !== minimum.minor)
+        return version.minor > minimum.minor;
+    return version.patch >= minimum.patch;
+}
+export function detectRuntime() {
+    const kind = process.versions?.node ? "node" : "unknown";
+    const version = process.versions?.node ?? null;
+    return {
+        kind,
+        version,
+        execPath: process.execPath ?? null,
+        pathEnv: process.env.PATH ?? "(not set)",
+    };
+}
+export function runtimeSatisfies(details) {
+    const parsed = parseSemver(details.version);
+    if (details.kind === "node")
+        return isAtLeast(parsed, MIN_NODE);
+    return false;
+}
+export function isSupportedNodeVersion(version) {
+    return isAtLeast(parseSemver(version), MIN_NODE);
+}
+export function assertSupportedRuntime(runtime = defaultRuntime, details = detectRuntime()) {
+    if (runtimeSatisfies(details))
+        return;
+    const versionLabel = details.version ?? "unknown";
+    const runtimeLabel = details.kind === "unknown" ? "unknown runtime" : `${details.kind} ${versionLabel}`;
+    const execLabel = details.execPath ?? "unknown";
+    runtime.error([
+        "openclaw requires Node >=22.0.0.",
+        `Detected: ${runtimeLabel} (exec: ${execLabel}).`,
+        `PATH searched: ${details.pathEnv}`,
+        "Install Node: https://nodejs.org/en/download",
+        "Upgrade Node and re-run openclaw.",
+    ].join("\n"));
+    runtime.exit(1);
+}
+//# sourceMappingURL=runtime-guard.js.map

package/dist/infra/runtime-guard.js.map

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

package/dist/infra/session-cost-usage.d.ts

@@ -0,0 +1,37 @@
+import type { OpenClawConfig } from "../config/config.js";
+import type { SessionEntry } from "../config/sessions/types.js";
+export type CostUsageTotals = {
+    input: number;
+    output: number;
+    cacheRead: number;
+    cacheWrite: number;
+    totalTokens: number;
+    totalCost: number;
+    missingCostEntries: number;
+};
+export type CostUsageDailyEntry = CostUsageTotals & {
+    date: string;
+};
+export type CostUsageSummary = {
+    updatedAt: number;
+    days: number;
+    daily: CostUsageDailyEntry[];
+    totals: CostUsageTotals;
+};
+export type SessionCostSummary = CostUsageTotals & {
+    sessionId?: string;
+    sessionFile?: string;
+    lastActivity?: number;
+};
+export declare function loadCostUsageSummary(params?: {
+    days?: number;
+    config?: OpenClawConfig;
+    agentId?: string;
+}): Promise<CostUsageSummary>;
+export declare function loadSessionCostSummary(params: {
+    sessionId?: string;
+    sessionEntry?: SessionEntry;
+    sessionFile?: string;
+    config?: OpenClawConfig;
+}): Promise<SessionCostSummary | null>;
+//# sourceMappingURL=session-cost-usage.d.ts.map

package/dist/infra/session-cost-usage.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"session-cost-usage.d.ts","sourceRoot":"","sources":["../../src/infra/session-cost-usage.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAC1D,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,6BAA6B,CAAC;AAehE,MAAM,MAAM,eAAe,GAAG;IAC5B,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE,MAAM,CAAC;IACnB,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,EAAE,MAAM,CAAC;IAClB,kBAAkB,EAAE,MAAM,CAAC;CAC5B,CAAC;AAEF,MAAM,MAAM,mBAAmB,GAAG,eAAe,GAAG;IAClD,IAAI,EAAE,MAAM,CAAC;CACd,CAAC;AAEF,MAAM,MAAM,gBAAgB,GAAG;IAC7B,SAAS,EAAE,MAAM,CAAC;IAClB,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,mBAAmB,EAAE,CAAC;IAC7B,MAAM,EAAE,eAAe,CAAC;CACzB,CAAC;AAEF,MAAM,MAAM,kBAAkB,GAAG,eAAe,GAAG;IACjD,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB,CAAC;AA2HF,wBAAsB,oBAAoB,CAAC,MAAM,CAAC,EAAE;IAClD,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,MAAM,CAAC,EAAE,cAAc,CAAC;IACxB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB,GAAG,OAAO,CAAC,gBAAgB,CAAC,CAuD5B;AAED,wBAAsB,sBAAsB,CAAC,MAAM,EAAE;IACnD,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,YAAY,CAAC,EAAE,YAAY,CAAC;IAC5B,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,MAAM,CAAC,EAAE,cAAc,CAAC;CACzB,GAAG,OAAO,CAAC,kBAAkB,GAAG,IAAI,CAAC,CA4BrC"}