import type { ClawdbotConfig } from "../../config/config.js"; import type { SessionEntry } from "../../config/sessions.js"; import type { DeliverableMessageProvider, GatewayMessageProvider, } from "../../utils/message-provider.js"; import { isWhatsAppGroupJid, normalizeE164, normalizeWhatsAppTarget, } from "../../utils.js"; export type OutboundProvider = DeliverableMessageProvider | "none"; export type HeartbeatTarget = OutboundProvider | "last"; export type OutboundTarget = { provider: OutboundProvider; to?: string; reason?: string; }; export type OutboundTargetResolution = | { ok: true; to: string } | { ok: false; error: Error }; export function resolveOutboundTarget(params: { provider: GatewayMessageProvider; to?: string; allowFrom?: string[]; }): OutboundTargetResolution { const trimmed = params.to?.trim() || ""; if (params.provider === "whatsapp") { if (trimmed) { const normalized = normalizeWhatsAppTarget(trimmed); if (!normalized) { return { ok: false, error: new Error( "Delivering to WhatsApp requires --to or whatsapp.allowFrom[0]", ), }; } return { ok: true, to: normalized }; } const fallback = params.allowFrom?.[0]?.trim(); if (fallback) { const normalized = normalizeWhatsAppTarget(fallback); if (normalized) { return { ok: true, to: normalized }; } } return { ok: false, error: new Error( "Delivering to WhatsApp requires --to or whatsapp.allowFrom[0]", ), }; } if (params.provider === "telegram") { if (!trimmed) { return { ok: false, error: new Error("Delivering to Telegram requires --to "), }; } return { ok: true, to: trimmed }; } if (params.provider === "discord") { if (!trimmed) { return { ok: false, error: new Error( "Delivering to Discord requires --to ", ), }; } return { ok: true, to: trimmed }; } if (params.provider === "slack") { if (!trimmed) { return { ok: false, error: new Error( "Delivering to Slack requires --to ", ), }; } return { ok: true, to: trimmed }; } if (params.provider === "signal") { if (!trimmed) { return { ok: false, error: new Error( "Delivering to Signal requires --to ", ), }; } return { ok: true, to: trimmed }; } if (params.provider === "imessage") { if (!trimmed) { return { ok: false, error: new Error( "Delivering to iMessage requires --to ", ), }; } return { ok: true, to: trimmed }; } if (params.provider === "msteams") { if (!trimmed) { return { ok: false, error: new Error( "Delivering to MS Teams requires --to ", ), }; } return { ok: true, to: trimmed }; } return { ok: false, error: new Error( "Delivering to WebChat is not supported via `clawdbot agent`; use WhatsApp/Telegram or run with --deliver=false.", ), }; } export function resolveHeartbeatDeliveryTarget(params: { cfg: ClawdbotConfig; entry?: SessionEntry; }): OutboundTarget { const { cfg, entry } = params; const rawTarget = cfg.agents?.defaults?.heartbeat?.target; const target: HeartbeatTarget = rawTarget === "whatsapp" || rawTarget === "telegram" || rawTarget === "discord" || rawTarget === "slack" || rawTarget === "signal" || rawTarget === "imessage" || rawTarget === "msteams" || rawTarget === "none" || rawTarget === "last" ? rawTarget : "last"; if (target === "none") { return { provider: "none", reason: "target-none" }; } const explicitTo = typeof cfg.agents?.defaults?.heartbeat?.to === "string" && cfg.agents.defaults.heartbeat.to.trim() ? cfg.agents.defaults.heartbeat.to.trim() : undefined; const lastProvider = entry?.lastProvider && entry.lastProvider !== "webchat" ? entry.lastProvider : undefined; const lastTo = typeof entry?.lastTo === "string" ? entry.lastTo.trim() : ""; const provider: | "whatsapp" | "telegram" | "discord" | "slack" | "signal" | "imessage" | "msteams" | undefined = target === "last" ? lastProvider : target === "whatsapp" || target === "telegram" || target === "discord" || target === "slack" || target === "signal" || target === "imessage" || target === "msteams" ? target : undefined; const to = explicitTo || (provider && lastProvider === provider ? lastTo : undefined) || (target === "last" ? lastTo : undefined); if (!provider || !to) { return { provider: "none", reason: "no-target" }; } if (provider !== "whatsapp") { const resolved = resolveOutboundTarget({ provider, to }); return resolved.ok ? { provider, to: resolved.to } : { provider: "none", reason: "no-target" }; } const rawAllow = cfg.whatsapp?.allowFrom ?? []; const resolved = resolveOutboundTarget({ provider: "whatsapp", to, allowFrom: rawAllow, }); if (!resolved.ok) { return { provider: "none", reason: "no-target" }; } if (rawAllow.includes("*")) return { provider, to: resolved.to }; if (isWhatsAppGroupJid(resolved.to)) return { provider, to: resolved.to }; const allowFrom = rawAllow .map((val) => normalizeE164(val)) .filter((val) => val.length > 1); if (allowFrom.length === 0) return { provider, to: resolved.to }; if (allowFrom.includes(resolved.to)) return { provider, to: resolved.to }; return { provider, to: allowFrom[0], reason: "allowFrom-fallback" }; }