Integrations

lib/plugins/ holds inngest-client.ts, redis-client.ts, resend-client.ts, and sqs-client.ts. HubSpot HTTP clients live in lib/plugins/hubspot/ (HubSpotClient plus feature clients such as HubSpotListsClient; pyb.ts wraps @payability/pyb-hubspot). Retell has its own folder (lib/retellai/) because it carries types, agent config and the post-call analysis schema alongside the client.

RetellClient wraps SDK failures in RetellError; the calling service converts them to RetellCallError or a CallSkipReason. A provider’s error shape never reaches a route handler.

Carriers are entries in EXTERNAL_PROVIDER_CONFIGS, models in AI_GATEWAY_MODELS, CRM event types in CRM_EVENT_TYPES. Adding one is a single-entry change.

Realtime broadcast logs a warning and returns when Supabase keys are absent; Svix verification is skipped when the Resend secret is unset; SQS publishers return false when a queue URL is missing. The two exceptions that fail closed are verifyInternalSecret() and HubSpot signature verification, because both guard write paths.

Activity logging, HubSpot engagement logging and CRM publishing are wrapped in try/catch that warns and continues. The comment // best-effort marks them in the source.