2807f5afbc
- Add isHeartbeat to AgentRunContext to track heartbeat runs - Pass isHeartbeat flag through agent runner execution - Suppress webchat broadcast (deltas + final) for heartbeat runs when showOk is false - Webchat uses channels.defaults.heartbeat settings (no per-channel config) - Default behavior: hide HEARTBEAT_OK from webchat (matches other channels) This allows users to control whether heartbeat responses appear in the webchat UI via channels.defaults.heartbeat.showOk (defaults to false).
74 lines
2.5 KiB
TypeScript
74 lines
2.5 KiB
TypeScript
import type { ClawdbotConfig } from "../config/config.js";
|
|
import type { ChannelHeartbeatVisibilityConfig } from "../config/types.channels.js";
|
|
import type { DeliverableMessageChannel, GatewayMessageChannel } from "../utils/message-channel.js";
|
|
|
|
export type ResolvedHeartbeatVisibility = {
|
|
showOk: boolean;
|
|
showAlerts: boolean;
|
|
useIndicator: boolean;
|
|
};
|
|
|
|
const DEFAULT_VISIBILITY: ResolvedHeartbeatVisibility = {
|
|
showOk: false, // Silent by default
|
|
showAlerts: true, // Show content messages
|
|
useIndicator: true, // Emit indicator events
|
|
};
|
|
|
|
/**
|
|
* Resolve heartbeat visibility settings for a channel.
|
|
* Supports both deliverable channels (telegram, signal, etc.) and webchat.
|
|
* For webchat, uses channels.defaults.heartbeat since webchat doesn't have per-channel config.
|
|
*/
|
|
export function resolveHeartbeatVisibility(params: {
|
|
cfg: ClawdbotConfig;
|
|
channel: GatewayMessageChannel;
|
|
accountId?: string;
|
|
}): ResolvedHeartbeatVisibility {
|
|
const { cfg, channel, accountId } = params;
|
|
|
|
// Webchat uses channel defaults only (no per-channel or per-account config)
|
|
if (channel === "webchat") {
|
|
const channelDefaults = cfg.channels?.defaults?.heartbeat;
|
|
return {
|
|
showOk: channelDefaults?.showOk ?? DEFAULT_VISIBILITY.showOk,
|
|
showAlerts: channelDefaults?.showAlerts ?? DEFAULT_VISIBILITY.showAlerts,
|
|
useIndicator: channelDefaults?.useIndicator ?? DEFAULT_VISIBILITY.useIndicator,
|
|
};
|
|
}
|
|
|
|
// Layer 1: Global channel defaults
|
|
const channelDefaults = cfg.channels?.defaults?.heartbeat;
|
|
|
|
// Layer 2: Per-channel config (at channel root level)
|
|
const channelCfg = cfg.channels?.[channel] as
|
|
| {
|
|
heartbeat?: ChannelHeartbeatVisibilityConfig;
|
|
accounts?: Record<string, { heartbeat?: ChannelHeartbeatVisibilityConfig }>;
|
|
}
|
|
| undefined;
|
|
const perChannel = channelCfg?.heartbeat;
|
|
|
|
// Layer 3: Per-account config (most specific)
|
|
const accountCfg = accountId ? channelCfg?.accounts?.[accountId] : undefined;
|
|
const perAccount = accountCfg?.heartbeat;
|
|
|
|
// Precedence: per-account > per-channel > channel-defaults > global defaults
|
|
return {
|
|
showOk:
|
|
perAccount?.showOk ??
|
|
perChannel?.showOk ??
|
|
channelDefaults?.showOk ??
|
|
DEFAULT_VISIBILITY.showOk,
|
|
showAlerts:
|
|
perAccount?.showAlerts ??
|
|
perChannel?.showAlerts ??
|
|
channelDefaults?.showAlerts ??
|
|
DEFAULT_VISIBILITY.showAlerts,
|
|
useIndicator:
|
|
perAccount?.useIndicator ??
|
|
perChannel?.useIndicator ??
|
|
channelDefaults?.useIndicator ??
|
|
DEFAULT_VISIBILITY.useIndicator,
|
|
};
|
|
}
|