Files
openclaw/src/plugin-sdk/status-helpers.ts
2026-02-23 21:25:28 +00:00

122 lines
3.0 KiB
TypeScript

import type { ChannelStatusIssue } from "../channels/plugins/types.js";
type RuntimeLifecycleSnapshot = {
running?: boolean | null;
lastStartAt?: number | null;
lastStopAt?: number | null;
lastError?: string | null;
lastInboundAt?: number | null;
lastOutboundAt?: number | null;
};
export function createDefaultChannelRuntimeState<T extends Record<string, unknown>>(
accountId: string,
extra?: T,
): {
accountId: string;
running: false;
lastStartAt: null;
lastStopAt: null;
lastError: null;
} & T {
return {
accountId,
running: false,
lastStartAt: null,
lastStopAt: null,
lastError: null,
...(extra ?? ({} as T)),
};
}
export function buildBaseChannelStatusSummary(snapshot: {
configured?: boolean | null;
running?: boolean | null;
lastStartAt?: number | null;
lastStopAt?: number | null;
lastError?: string | null;
}) {
return {
configured: snapshot.configured ?? false,
running: snapshot.running ?? false,
lastStartAt: snapshot.lastStartAt ?? null,
lastStopAt: snapshot.lastStopAt ?? null,
lastError: snapshot.lastError ?? null,
};
}
export function buildBaseAccountStatusSnapshot(params: {
account: {
accountId: string;
name?: string;
enabled?: boolean;
configured?: boolean;
};
runtime?: RuntimeLifecycleSnapshot | null;
probe?: unknown;
}) {
const { account, runtime, probe } = params;
return {
accountId: account.accountId,
name: account.name,
enabled: account.enabled,
configured: account.configured,
running: runtime?.running ?? false,
lastStartAt: runtime?.lastStartAt ?? null,
lastStopAt: runtime?.lastStopAt ?? null,
lastError: runtime?.lastError ?? null,
probe,
lastInboundAt: runtime?.lastInboundAt ?? null,
lastOutboundAt: runtime?.lastOutboundAt ?? null,
};
}
export function buildTokenChannelStatusSummary(
snapshot: {
configured?: boolean | null;
tokenSource?: string | null;
running?: boolean | null;
mode?: string | null;
lastStartAt?: number | null;
lastStopAt?: number | null;
lastError?: string | null;
probe?: unknown;
lastProbeAt?: number | null;
},
opts?: { includeMode?: boolean },
) {
const base = {
...buildBaseChannelStatusSummary(snapshot),
tokenSource: snapshot.tokenSource ?? "none",
probe: snapshot.probe,
lastProbeAt: snapshot.lastProbeAt ?? null,
};
if (opts?.includeMode === false) {
return base;
}
return {
...base,
mode: snapshot.mode ?? null,
};
}
export function collectStatusIssuesFromLastError(
channel: string,
accounts: Array<{ accountId: string; lastError?: unknown }>,
): ChannelStatusIssue[] {
return accounts.flatMap((account) => {
const lastError = typeof account.lastError === "string" ? account.lastError.trim() : "";
if (!lastError) {
return [];
}
return [
{
channel,
accountId: account.accountId,
kind: "runtime",
message: `Channel error: ${lastError}`,
},
];
});
}