import type { ClawdbotConfig } from "../../config/config.js"; import type { SessionEntry } from "../../config/sessions.js"; import { normalizeE164 } from "../../utils.js"; export type OutboundProvider = | "whatsapp" | "telegram" | "discord" | "slack" | "signal" | "imessage" | "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: | "whatsapp" | "telegram" | "discord" | "slack" | "signal" | "imessage" | "webchat"; to?: string; allowFrom?: string[]; }): OutboundTargetResolution { const trimmed = params.to?.trim() || ""; if (params.provider === "whatsapp") { if (trimmed) { return { ok: true, to: normalizeE164(trimmed) }; } const fallback = params.allowFrom?.[0]?.trim(); if (fallback) { return { ok: true, to: fallback }; } 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 }; } 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.agent?.heartbeat?.target; const target: HeartbeatTarget = rawTarget === "whatsapp" || rawTarget === "telegram" || rawTarget === "discord" || rawTarget === "slack" || rawTarget === "signal" || rawTarget === "imessage" || rawTarget === "none" || rawTarget === "last" ? rawTarget : "last"; if (target === "none") { return { provider: "none", reason: "target-none" }; } const explicitTo = typeof cfg.agent?.heartbeat?.to === "string" && cfg.agent.heartbeat.to.trim() ? cfg.agent.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" | undefined = target === "last" ? lastProvider : target === "whatsapp" || target === "telegram" || target === "discord" || target === "slack" || target === "signal" || target === "imessage" ? 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") { return { provider, to }; } const rawAllow = cfg.whatsapp?.allowFrom ?? []; if (rawAllow.includes("*")) return { provider, to }; const allowFrom = rawAllow .map((val) => normalizeE164(val)) .filter((val) => val.length > 1); if (allowFrom.length === 0) return { provider, to }; const normalized = normalizeE164(to); if (allowFrom.includes(normalized)) return { provider, to: normalized }; return { provider, to: allowFrom[0], reason: "allowFrom-fallback" }; }