@automagik/omni 2.260803.2 → 2.260804.1

package/dist/server/index.js

@@ -23514,7 +23514,7 @@ var CHANNEL_TYPES, CONTENT_TYPES, DEBOUNCE_MODES, SPLIT_DELAY_MODES, RULE_TYPES;
 var init_channel = __esm(() => {
   CHANNEL_TYPES = [
     "whatsapp-baileys",
-    "whatsapp-cloud",
+    "whatsapp-business",
     "discord",
     "slack",
     "telegram",
@@ -24289,9 +24289,9 @@ var init_person = __esm(() => {
   });
 });
 
-// ../core/src/schemas/whatsapp-cloud.ts
-var MetaTemplateCategorySchema, MetaTemplateStatusSchema, MetaTemplateQualityScoreSchema, MetaTemplateHeaderComponentSchema, MetaTemplateBodyComponentSchema, MetaTemplateFooterComponentSchema, MetaTemplateButtonSchema, MetaTemplateButtonsComponentSchema, WhatsAppTemplateComponentSchema, InboundContextSchema, InboundMediaSchema, MetaInboundTextMessageSchema, MetaInboundMediaMessageSchema, MetaInboundLocationMessageSchema, MetaInboundContactsMessageSchema, MetaInboundReactionMessageSchema, MetaInboundInteractiveMessageSchema, MetaInboundButtonMessageSchema, MetaInboundMessageSchema, MetaWebhookStatusEntrySchema, MetaTemplateStatusUpdateSchema, MetaWebhookValueSchema, MetaWebhookChangeSchema, MetaWebhookEntrySchema, MetaWebhookPayloadSchema, EmbeddedSignupExchangeRequestSchema, EmbeddedSignupExchangeResponseSchema, WhatsAppCloudConnectRequestSchema, WhatsAppFlowSendSchema, WhatsAppCloudRegisterRequestSchema, SendTemplateRequestSchema;
-var init_whatsapp_cloud = __esm(() => {
+// ../core/src/schemas/whatsapp-business.ts
+var MetaTemplateCategorySchema, MetaTemplateStatusSchema, MetaTemplateQualityScoreSchema, MetaTemplateHeaderComponentSchema, MetaTemplateBodyComponentSchema, MetaTemplateFooterComponentSchema, MetaTemplateButtonSchema, MetaTemplateButtonsComponentSchema, WhatsAppTemplateComponentSchema, InboundContextSchema, InboundMediaSchema, MetaInboundTextMessageSchema, MetaInboundMediaMessageSchema, MetaInboundLocationMessageSchema, MetaInboundContactsMessageSchema, MetaInboundReactionMessageSchema, MetaInboundInteractiveMessageSchema, MetaInboundButtonMessageSchema, MetaInboundMessageSchema, MetaWebhookStatusEntrySchema, MetaTemplateStatusUpdateSchema, MetaWebhookValueSchema, MetaWebhookChangeSchema, MetaWebhookEntrySchema, MetaWebhookPayloadSchema, EmbeddedSignupExchangeRequestSchema, EmbeddedSignupExchangeResponseSchema, WhatsAppBusinessConnectRequestSchema, WhatsAppFlowSendSchema, WhatsAppBusinessRegisterRequestSchema, SendTemplateRequestSchema;
+var init_whatsapp_business = __esm(() => {
   init_zod();
   init_common();
   MetaTemplateCategorySchema = exports_external.enum(["MARKETING", "UTILITY", "AUTHENTICATION"]);
@@ -24510,7 +24510,7 @@ var init_whatsapp_cloud = __esm(() => {
       quality_rating: exports_external.string().optional()
     }))
   });
-  WhatsAppCloudConnectRequestSchema = exports_external.object({
+  WhatsAppBusinessConnectRequestSchema = exports_external.object({
     accessToken: exports_external.string().min(1).optional(),
     exchangeHandle: exports_external.string().min(1).optional(),
     phoneNumberId: exports_external.string().min(1),
@@ -24537,7 +24537,7 @@ var init_whatsapp_cloud = __esm(() => {
     message: "Provide exactly one of flowId or flowName",
     path: ["flowId"]
   });
-  WhatsAppCloudRegisterRequestSchema = exports_external.object({
+  WhatsAppBusinessRegisterRequestSchema = exports_external.object({
     pin: exports_external.string().regex(/^\d{6}$/, "PIN must be exactly 6 digits").optional()
   });
   SendTemplateRequestSchema = exports_external.object({
@@ -24730,7 +24730,7 @@ var init_whatsapp_flows = __esm(() => {
 var HermesContactSchema, HermesWebhookPayloadSchema;
 var init_hermes = __esm(() => {
   init_zod();
-  init_whatsapp_cloud();
+  init_whatsapp_business();
   HermesContactSchema = exports_external.object({
     profile: exports_external.object({ name: exports_external.string().optional() }).optional(),
     wa_id: exports_external.string().optional()
@@ -24757,14 +24757,14 @@ var init_schemas = __esm(() => {
   init_instance();
   init_message();
   init_person();
-  init_whatsapp_cloud();
+  init_whatsapp_business();
   init_whatsapp_flows();
   init_hermes();
 });
 
-// ../core/src/types/whatsapp-cloud.ts
+// ../core/src/types/whatsapp-business.ts
 var META_TEMPLATE_CATEGORIES, META_TEMPLATE_STATUSES, META_TEMPLATE_QUALITY_SCORES;
-var init_whatsapp_cloud2 = __esm(() => {
+var init_whatsapp_business2 = __esm(() => {
   META_TEMPLATE_CATEGORIES = ["MARKETING", "UTILITY", "AUTHENTICATION"];
   META_TEMPLATE_STATUSES = ["APPROVED", "PENDING", "REJECTED", "PAUSED", "DELETED"];
   META_TEMPLATE_QUALITY_SCORES = ["GREEN", "YELLOW", "RED", "UNKNOWN"];
@@ -24781,7 +24781,7 @@ var SETTING_VALUE_TYPES;
 var init_types5 = __esm(() => {
   init_channel();
   init_agent();
-  init_whatsapp_cloud2();
+  init_whatsapp_business2();
   SETTING_VALUE_TYPES = ["string", "integer", "boolean", "json", "secret"];
 });
 
@@ -30853,13 +30853,13 @@ var MESSAGING_WINDOW_MS, DEFAULT_TYPING_INDICATOR_MS = 2500, CHANNELS_WITH_MESSA
 var init_capabilities2 = __esm(() => {
   MESSAGING_WINDOW_MS = 24 * 60 * 60 * 1000;
   CHANNELS_WITH_MESSAGING_WINDOW = new Set([
-    "whatsapp-cloud",
+    "whatsapp-business",
     "hermes",
     "twilio-whatsapp"
   ]);
   CHANNELS_WITH_TYPING_INDICATOR = new Set([
     "whatsapp-baileys",
-    "whatsapp-cloud",
+    "whatsapp-business",
     "twilio-whatsapp",
     "discord",
     "slack",
@@ -36050,8 +36050,8 @@ __export(exports_src, {
   agentStateKey: () => agentStateKey,
   WhatsAppTemplateComponentSchema: () => WhatsAppTemplateComponentSchema,
   WhatsAppFlowSendSchema: () => WhatsAppFlowSendSchema,
-  WhatsAppCloudRegisterRequestSchema: () => WhatsAppCloudRegisterRequestSchema,
-  WhatsAppCloudConnectRequestSchema: () => WhatsAppCloudConnectRequestSchema,
+  WhatsAppBusinessRegisterRequestSchema: () => WhatsAppBusinessRegisterRequestSchema,
+  WhatsAppBusinessConnectRequestSchema: () => WhatsAppBusinessConnectRequestSchema,
   WebhookAgentProvider: () => WebhookAgentProvider,
   ValidationError: () => ValidationError2,
   UuidSchema: () => UuidSchema,
@@ -36803,11 +36803,11 @@ function startAck(plugin2, ackProvider, instanceId, chatId, messageId, channel2,
   let removed = false;
   if (ackProvider) {
     ackProvider.ack(instanceId, chatId, messageId, emoji).catch(() => {
-      if ((channel2 === "whatsapp" || channel2 === "whatsapp-baileys" || channel2 === "whatsapp-cloud") && plugin2?.sendTyping) {
+      if ((channel2 === "whatsapp" || channel2 === "whatsapp-baileys" || channel2 === "whatsapp-business") && plugin2?.sendTyping) {
         plugin2.sendTyping(instanceId, chatId, timeoutMs).catch(() => {});
       }
     });
-  } else if ((channel2 === "whatsapp" || channel2 === "whatsapp-baileys" || channel2 === "whatsapp-cloud") && plugin2?.sendTyping) {
+  } else if ((channel2 === "whatsapp" || channel2 === "whatsapp-baileys" || channel2 === "whatsapp-business") && plugin2?.sendTyping) {
     plugin2.sendTyping(instanceId, chatId, timeoutMs).catch(() => {});
   }
   const timer = setTimeout(() => {
@@ -158277,11 +158277,11 @@ var init_audio_converter = __esm(() => {
   };
 });
 
-// ../channel-whatsapp-cloud/src/capabilities.ts
-var WHATSAPP_CLOUD_CAPABILITIES;
+// ../channel-whatsapp-business/src/capabilities.ts
+var WHATSAPP_BUSINESS_CAPABILITIES;
 var init_capabilities3 = __esm(() => {
   init_src2();
-  WHATSAPP_CLOUD_CAPABILITIES = {
+  WHATSAPP_BUSINESS_CAPABILITIES = {
     ...DEFAULT_CAPABILITIES,
     canSendText: true,
     canSendMedia: true,
@@ -158333,7 +158333,7 @@ var init_capabilities3 = __esm(() => {
   };
 });
 
-// ../channel-whatsapp-cloud/src/utils/errors.ts
+// ../channel-whatsapp-business/src/utils/errors.ts
 function isRetryable6(error) {
   return error instanceof MetaApiError && error.retryable;
 }
@@ -158391,7 +158391,7 @@ var init_errors3 = __esm(() => {
   MetaApiError = class MetaApiError extends ChannelError {
     channelCode;
     constructor(code, message2, context2 = {}) {
-      super(CORE_CODE_MAP6[code] ?? ERROR_CODES.UNKNOWN, message2, "whatsapp-cloud", undefined, {
+      super(CORE_CODE_MAP6[code] ?? ERROR_CODES.UNKNOWN, message2, "whatsapp-business", undefined, {
         recoverable: RETRYABLE_CODES2.has(code),
         context: { ...context2 }
       });
@@ -158410,7 +158410,7 @@ var init_errors3 = __esm(() => {
   OUTSIDE_24H_WINDOW_CODES = new Set([131047, 131051]);
 });
 
-// ../channel-whatsapp-cloud/src/client.ts
+// ../channel-whatsapp-business/src/client.ts
 function buildHeaderComponent(headerMedia) {
   return { type: "header", parameters: [buildHeaderParameter(headerMedia)] };
 }
@@ -158661,7 +158661,7 @@ var init_client3 = __esm(() => {
   init_errors3();
 });
 
-// ../channel-whatsapp-cloud/src/flows/resolver.ts
+// ../channel-whatsapp-business/src/flows/resolver.ts
 function buildFlowToken(flowRef) {
   return `${FLOW_TOKEN_PREFIX}.${flowRef}.${crypto.randomUUID()}`;
 }
@@ -158704,7 +158704,7 @@ function errorScreenResponse(ctx, message2) {
 }
 var FLOW_TOKEN_PREFIX = "omni";
 
-// ../channel-whatsapp-cloud/src/utils/flow-crypto.ts
+// ../channel-whatsapp-business/src/utils/flow-crypto.ts
 function pemToDer(pem) {
   const base64 = pem.replace(/-----(BEGIN|END)[A-Z ]+-----/g, "").replace(/\s+/g, "");
   return b64decode(base64);
@@ -158781,7 +158781,7 @@ var init_flow_crypto = __esm(() => {
   };
 });
 
-// ../channel-whatsapp-cloud/src/utils/signature.ts
+// ../channel-whatsapp-business/src/utils/signature.ts
 async function verifyMetaSignature(body, signatureHeader, appSecret) {
   if (!signatureHeader || !appSecret)
     return false;
@@ -158828,7 +158828,7 @@ function timingSafeEqualHex(a, b2) {
 }
 var SIGNATURE_PREFIX = "sha256=";
 
-// ../channel-whatsapp-cloud/src/handlers/flow-data.ts
+// ../channel-whatsapp-business/src/handlers/flow-data.ts
 function isEncryptedBody(parsed) {
   return typeof parsed.encrypted_flow_data === "string" && typeof parsed.encrypted_aes_key === "string" && typeof parsed.initial_vector === "string";
 }
@@ -158836,7 +158836,7 @@ async function intake(request, ctx) {
   const rawBody = await request.text();
   const signature = request.headers.get("x-hub-signature-256");
   if (!ctx.appSecret || !signature || !await verifyMetaSignature(rawBody, signature, ctx.appSecret)) {
-    ctx.logger.warn("[whatsapp-cloud] flow data request failed signature verification", {
+    ctx.logger.warn("[whatsapp-business] flow data request failed signature verification", {
       instanceId: ctx.instanceId,
       hasSignature: Boolean(signature)
     });
@@ -158858,7 +158858,7 @@ async function intake(request, ctx) {
     const privateKey = await importFlowPrivateKey(ctx.privateKeyPem);
     return { decrypted: await decryptFlowRequest(parsed, privateKey) };
   } catch (err2) {
-    ctx.logger.warn("[whatsapp-cloud] flow data decrypt failed \u2014 responding 421", {
+    ctx.logger.warn("[whatsapp-business] flow data decrypt failed \u2014 responding 421", {
       instanceId: ctx.instanceId,
       error: err2 instanceof FlowDecryptError ? err2.message : String(err2)
     });
@@ -158868,7 +158868,7 @@ async function intake(request, ctx) {
 async function resolveScreen(ctx, resolveCtx) {
   const resolver = ctx.registry.lookup(resolveCtx);
   if (!resolver) {
-    ctx.logger.warn("[whatsapp-cloud] no flow resolver registered \u2014 responding with error screen", {
+    ctx.logger.warn("[whatsapp-business] no flow resolver registered \u2014 responding with error screen", {
       instanceId: ctx.instanceId,
       flowRef: resolveCtx.flowRef
     });
@@ -158880,7 +158880,7 @@ async function resolveScreen(ctx, resolveCtx) {
       new Promise((_2, reject) => setTimeout(() => reject(new Error(`flow resolver timed out after ${RESOLVE_TIMEOUT_MS}ms`)), RESOLVE_TIMEOUT_MS))
     ]);
   } catch (err2) {
-    ctx.logger.error("[whatsapp-cloud] flow resolver failed", {
+    ctx.logger.error("[whatsapp-business] flow resolver failed", {
       instanceId: ctx.instanceId,
       flowRef: resolveCtx.flowRef,
       action: resolveCtx.action,
@@ -158903,7 +158903,7 @@ async function publishExchangeEvent(ctx, resolveCtx, responseScreen, durationMs)
       durationMs
     });
   } catch (err2) {
-    ctx.logger.warn("[whatsapp-cloud] flow.data_exchange event publish failed", {
+    ctx.logger.warn("[whatsapp-business] flow.data_exchange event publish failed", {
       instanceId: ctx.instanceId,
       error: err2 instanceof Error ? err2.message : String(err2)
     });
@@ -158923,7 +158923,7 @@ async function handleFlowDataRequest(request, ctx) {
   }
   const dataBag = payload.data ?? {};
   if (dataBag.error != null || dataBag.error_message != null) {
-    ctx.logger.warn("[whatsapp-cloud] flow client error notification", {
+    ctx.logger.warn("[whatsapp-business] flow client error notification", {
       instanceId: ctx.instanceId,
       flowToken: payload.flow_token,
       error: dataBag.error,
@@ -158945,7 +158945,7 @@ async function handleFlowDataRequest(request, ctx) {
   const startedAt = performance.now();
   const screenResponse = await resolveScreen(ctx, resolveCtx);
   const durationMs = Math.round(performance.now() - startedAt);
-  ctx.logger.info("[whatsapp-cloud] flow data exchange resolved", {
+  ctx.logger.info("[whatsapp-business] flow data exchange resolved", {
     instanceId: ctx.instanceId,
     flowRef: resolveCtx.flowRef,
     action: resolveCtx.action,
@@ -164370,7 +164370,7 @@ var init_schema2 = __esm(() => {
   init_pg_core();
   channelTypes = [
     "whatsapp-baileys",
-    "whatsapp-cloud",
+    "whatsapp-business",
     "discord",
     "slack",
     "telegram",
@@ -170060,7 +170060,7 @@ var init_src5 = __esm(() => {
   init_schema2();
 });
 
-// ../channel-whatsapp-cloud/src/templates.ts
+// ../channel-whatsapp-business/src/templates.ts
 var exports_templates = {};
 __export(exports_templates, {
   uploadHeaderMedia: () => uploadHeaderMedia,
@@ -170300,7 +170300,7 @@ var init_templates2 = __esm(() => {
   TEMPLATE_NAME_RE = /^[a-z0-9_]+$/;
 });
 
-// ../channel-whatsapp-cloud/src/handlers/webhook.ts
+// ../channel-whatsapp-business/src/handlers/webhook.ts
 function handleVerifyChallenge(request, verifyToken) {
   const url = new URL(request.url);
   const mode = url.searchParams.get("hub.mode");
@@ -170323,17 +170323,17 @@ async function handleMetaWebhook(request, plugin8, appSecret, verifyToken) {
   try {
     body = await request.text();
   } catch (err2) {
-    logger6.warn("[whatsapp-cloud] failed to read webhook body", { err: String(err2) });
+    logger6.warn("[whatsapp-business] failed to read webhook body", { err: String(err2) });
     return new Response("OK", { status: 200 });
   }
   if (body.length > MAX_BODY_BYTES2) {
-    logger6.warn("[whatsapp-cloud] oversized webhook body rejected", { size: body.length });
+    logger6.warn("[whatsapp-business] oversized webhook body rejected", { size: body.length });
     return new Response("OK", { status: 200 });
   }
   const signature = request.headers.get("x-hub-signature-256");
   const valid = await verifyMetaSignature(body, signature, appSecret);
   if (!valid) {
-    logger6.warn("[whatsapp-cloud] invalid X-Hub-Signature-256 \u2014 rejecting webhook", {
+    logger6.warn("[whatsapp-business] invalid X-Hub-Signature-256 \u2014 rejecting webhook", {
       hasHeader: signature !== null
     });
     return new Response("Unauthorized", { status: 401 });
@@ -170342,12 +170342,12 @@ async function handleMetaWebhook(request, plugin8, appSecret, verifyToken) {
   try {
     parsedJson = JSON.parse(body);
   } catch {
-    logger6.warn("[whatsapp-cloud] webhook body is not valid JSON");
+    logger6.warn("[whatsapp-business] webhook body is not valid JSON");
     return new Response("OK", { status: 200 });
   }
   const validated = MetaWebhookPayloadSchema.safeParse(parsedJson);
   if (!validated.success) {
-    logger6.warn("[whatsapp-cloud] webhook payload failed schema validation", {
+    logger6.warn("[whatsapp-business] webhook payload failed schema validation", {
       issues: validated.error.issues.slice(0, 5)
     });
     return new Response("OK", { status: 200 });
@@ -170373,7 +170373,7 @@ async function processChange(plugin8, change, entryId, logger6) {
     return;
   }
   if (change.field !== "messages") {
-    logger6.debug("[whatsapp-cloud] ignoring unsupported webhook field", { field: change.field });
+    logger6.debug("[whatsapp-business] ignoring unsupported webhook field", { field: change.field });
     return;
   }
   await processMessagesChange(plugin8, change, logger6);
@@ -170382,7 +170382,7 @@ async function processChannelAlert(plugin8, change, entryId, logger6) {
   const value = change.value ?? {};
   const matches = plugin8.findInstancesByWabaId(entryId);
   if (matches.length === 0) {
-    logger6.debug("[whatsapp-cloud] channel alert arrived with no matching WABA", {
+    logger6.debug("[whatsapp-business] channel alert arrived with no matching WABA", {
       field: change.field,
       wabaId: entryId
     });
@@ -170390,7 +170390,7 @@ async function processChannelAlert(plugin8, change, entryId, logger6) {
   }
   const alertType = change.field;
   await Promise.all(matches.map(([instanceId]) => plugin8.handleChannelAlert(instanceId, alertType, value).catch((err2) => {
-    logger6.warn("[whatsapp-cloud] failed to emit channel.alert", {
+    logger6.warn("[whatsapp-business] failed to emit channel.alert", {
       instanceId,
       field: change.field,
       err: String(err2)
@@ -170400,7 +170400,7 @@ async function processChannelAlert(plugin8, change, entryId, logger6) {
 async function processTemplateStatusUpdate(plugin8, change, logger6) {
   const parsed = MetaTemplateStatusUpdateSchema.safeParse(change.value);
   if (!parsed.success) {
-    logger6.warn("[whatsapp-cloud] template_status_update payload invalid", {
+    logger6.warn("[whatsapp-business] template_status_update payload invalid", {
       issues: parsed.error.issues.slice(0, 3)
     });
     return;
@@ -170410,7 +170410,7 @@ async function processTemplateStatusUpdate(plugin8, change, logger6) {
   try {
     await handleTemplateStatusUpdate2(getDb2(), parsed.data, plugin8);
   } catch (err2) {
-    logger6.warn("[whatsapp-cloud] failed to handle template status update", {
+    logger6.warn("[whatsapp-business] failed to handle template status update", {
       metaTemplateId: parsed.data.message_template_id,
       err: String(err2)
     });
@@ -170421,12 +170421,12 @@ async function processMessagesChange(plugin8, change, logger6) {
   const metadata = value.metadata;
   const phoneNumberId = metadata?.phone_number_id;
   if (!phoneNumberId) {
-    logger6.warn("[whatsapp-cloud] webhook change missing metadata.phone_number_id");
+    logger6.warn("[whatsapp-business] webhook change missing metadata.phone_number_id");
     return;
   }
   const resolved = plugin8.findInstanceByPhoneNumberId(phoneNumberId);
   if (!resolved) {
-    logger6.warn("[whatsapp-cloud] no instance for phone_number_id \u2014 dropping change", {
+    logger6.warn("[whatsapp-business] no instance for phone_number_id \u2014 dropping change", {
       phoneNumberId
     });
     return;
@@ -170446,7 +170446,7 @@ async function emitInboundMessages(plugin8, instanceId, messages4, contacts, ded
         continue;
       await plugin8.handleInboundMessage(instanceId, msg, contacts, dedupeCache);
     } catch (err2) {
-      logger6.warn("[whatsapp-cloud] failed to emit inbound message", {
+      logger6.warn("[whatsapp-business] failed to emit inbound message", {
         instanceId,
         err: String(err2)
       });
@@ -170461,7 +170461,7 @@ async function emitStatusUpdates(plugin8, instanceId, statuses, logger6) {
         continue;
       await plugin8.handleStatusUpdate(instanceId, status);
     } catch (err2) {
-      logger6.warn("[whatsapp-cloud] failed to emit status event", {
+      logger6.warn("[whatsapp-business] failed to emit status event", {
         instanceId,
         err: String(err2)
       });
@@ -170480,7 +170480,7 @@ var init_webhook = __esm(() => {
   ]);
 });
 
-// ../channel-whatsapp-cloud/src/utils/identity.ts
+// ../channel-whatsapp-business/src/utils/identity.ts
 function toMetaPhone(input) {
   if (!input)
     return "";
@@ -170495,7 +170495,7 @@ function phonesEqual(a, b3) {
   return toMetaPhone(a) === toMetaPhone(b3);
 }
 
-// ../channel-whatsapp-cloud/src/senders/text.ts
+// ../channel-whatsapp-business/src/senders/text.ts
 async function sendText3(client, to, text3, replyTo) {
   const payload = {
     messaging_product: "whatsapp",
@@ -170510,7 +170510,7 @@ async function sendText3(client, to, text3, replyTo) {
 }
 var init_text2 = () => {};
 
-// ../channel-whatsapp-cloud/src/senders/media.ts
+// ../channel-whatsapp-business/src/senders/media.ts
 function resolveMetaMediaType(mimeType) {
   if (!mimeType)
     return "document";
@@ -170546,7 +170546,7 @@ async function sendMedia3(client, to, mediaUrl, mimeType, caption, filename, rep
 }
 var init_media = () => {};
 
-// ../channel-whatsapp-cloud/src/senders/location.ts
+// ../channel-whatsapp-business/src/senders/location.ts
 async function sendLocation4(client, to, latitude, longitude, name, address, replyTo) {
   const payload = {
     messaging_product: "whatsapp",
@@ -170566,7 +170566,7 @@ async function sendLocation4(client, to, latitude, longitude, name, address, rep
 }
 var init_location = () => {};
 
-// ../channel-whatsapp-cloud/src/senders/contact.ts
+// ../channel-whatsapp-business/src/senders/contact.ts
 function buildContactRecord2(input) {
   const record = {
     name: { formatted_name: input.name, first_name: input.name }
@@ -170599,7 +170599,7 @@ async function sendContact3(client, to, contacts, replyTo) {
 }
 var init_contact = () => {};
 
-// ../channel-whatsapp-cloud/src/senders/reaction.ts
+// ../channel-whatsapp-business/src/senders/reaction.ts
 async function sendReaction3(client, to, messageId, emoji) {
   if (!messageId) {
     throw new MetaApiError(MetaErrorCode.INVALID_REQUEST, "sendReaction requires a target messageId (wamid)", {
@@ -170619,7 +170619,7 @@ var init_reaction = __esm(() => {
   init_errors3();
 });
 
-// ../channel-whatsapp-cloud/src/senders/interactive.ts
+// ../channel-whatsapp-business/src/senders/interactive.ts
 function buttonId(btn, index2) {
   return (btn.data ?? btn.text ?? `btn_${index2}`).slice(0, MAX_ID);
 }
@@ -170731,7 +170731,7 @@ async function sendInteractive(client, to, bodyText, buttons, replyTo, listButto
 var MAX_REPLY_BUTTONS = 3, MAX_LIST_ROWS = 10, MAX_BUTTON_TITLE = 20, MAX_ROW_TITLE = 24, MAX_ROW_DESCRIPTION = 72, MAX_SECTION_TITLE = 24, MAX_ID = 256, truncate2 = (s, max) => s.length <= max ? s : `${s.slice(0, max - 1)}\u2026`;
 var init_interactive = () => {};
 
-// ../channel-whatsapp-cloud/src/senders/flow.ts
+// ../channel-whatsapp-business/src/senders/flow.ts
 async function sendFlow(client, to, flow, replyTo) {
   const flowRef = flow.flowId ?? flow.flowName ?? "unknown";
   const flowToken = flow.flowToken ?? buildFlowToken(flowRef);
@@ -170769,7 +170769,7 @@ async function sendFlow(client, to, flow, replyTo) {
 }
 var init_flow = () => {};
 
-// ../channel-whatsapp-cloud/src/senders/template.ts
+// ../channel-whatsapp-business/src/senders/template.ts
 async function sendTemplate2(client, to, templateName, language, bodyParameters, headerMedia, buttonParameters, replyTo) {
   const template = client.buildTemplatePayload({
     name: templateName,
@@ -170791,7 +170791,7 @@ async function sendTemplate2(client, to, templateName, language, bodyParameters,
 }
 var init_template = () => {};
 
-// ../channel-whatsapp-cloud/src/senders/index.ts
+// ../channel-whatsapp-business/src/senders/index.ts
 var init_senders = __esm(() => {
   init_text2();
   init_media();
@@ -170803,7 +170803,7 @@ var init_senders = __esm(() => {
   init_template();
 });
 
-// ../channel-whatsapp-cloud/src/plugin.ts
+// ../channel-whatsapp-business/src/plugin.ts
 async function dispatchOutbound2(client, message2, logger6) {
   const { content, to, replyTo } = message2;
   if (content.type === "text") {
@@ -170841,7 +170841,7 @@ async function dispatchOutbound2(client, message2, logger6) {
   if (content.type === "flow") {
     return dispatchOutboundFlow(client, message2);
   }
-  return { ok: false, error: `Unsupported content.type=${content.type} for whatsapp-cloud` };
+  return { ok: false, error: `Unsupported content.type=${content.type} for whatsapp-business` };
 }
 async function dispatchOutboundFlow(client, message2) {
   const parsed = WhatsAppFlowSendSchema.safeParse(message2.metadata?.flow);
@@ -170864,7 +170864,7 @@ async function dispatchOutboundText(client, message2, logger6) {
   }
   const { response, droppedRows } = await sendInteractive(client, to, formatted, content.buttons, replyTo, content.list?.buttonLabel, { sectionTitle: content.list?.sectionTitle, forceList: content.list?.forceList });
   if (droppedRows > 0) {
-    logger6?.warn("[whatsapp-cloud] interactive list capped at 10 rows \u2014 extra buttons dropped", { to, droppedRows });
+    logger6?.warn("[whatsapp-business] interactive list capped at 10 rows \u2014 extra buttons dropped", { to, droppedRows });
   }
   return response;
 }
@@ -171028,7 +171028,7 @@ function mapTemplateEventToStatus(event) {
       return "PAUSED";
   }
 }
-var META_MEDIA_TYPES, downloadGuard7, MAX_TYPING_WAMID_CHATS = 1000, WhatsAppCloudPlugin, MEDIA_TYPE_MAP2;
+var META_MEDIA_TYPES, downloadGuard7, MAX_TYPING_WAMID_CHATS = 1000, WhatsAppBusinessPlugin, MEDIA_TYPE_MAP2;
 var init_plugin = __esm(() => {
   init_src2();
   init_src();
@@ -171041,22 +171041,22 @@ var init_plugin = __esm(() => {
   init_errors3();
   META_MEDIA_TYPES = new Set(["image", "audio", "video", "document", "sticker"]);
   downloadGuard7 = createDownloadGuard();
-  WhatsAppCloudPlugin = class WhatsAppCloudPlugin extends BaseChannelPlugin {
-    id = "whatsapp-cloud";
-    name = "WhatsApp (Meta Cloud API)";
+  WhatsAppBusinessPlugin = class WhatsAppBusinessPlugin extends BaseChannelPlugin {
+    id = "whatsapp-business";
+    name = "WhatsApp Business API (Meta)";
     version = "1.0.0";
-    capabilities = WHATSAPP_CLOUD_CAPABILITIES;
-    waCloudInstances = new Map;
+    capabilities = WHATSAPP_BUSINESS_CAPABILITIES;
+    waInstances = new Map;
     byPhoneNumberId = new Map;
     byWabaId = new Map;
     async onInitialize(_context) {
       this.logger.info("WhatsApp Cloud plugin initialized");
     }
     async onDestroy() {
-      for (const [, state] of this.waCloudInstances) {
+      for (const [, state] of this.waInstances) {
         state.dedupeCache.dispose();
       }
-      this.waCloudInstances.clear();
+      this.waInstances.clear();
       this.byPhoneNumberId.clear();
       this.byWabaId.clear();
       this.logger.info("WhatsApp Cloud plugin destroyed");
@@ -171068,13 +171068,13 @@ var init_plugin = __esm(() => {
       const phoneNumberId = creds.metaPhoneNumberId ?? opts.metaPhoneNumberId;
       const wabaId = creds.metaWabaId ?? opts.metaWabaId;
       if (!accessToken) {
-        throw new MetaApiError(MetaErrorCode.AUTH_FAILED, "metaAccessToken is required to connect a whatsapp-cloud instance");
+        throw new MetaApiError(MetaErrorCode.AUTH_FAILED, "metaAccessToken is required to connect a whatsapp-business instance");
       }
       if (!phoneNumberId) {
-        throw new MetaApiError(MetaErrorCode.PHONE_NOT_FOUND, "metaPhoneNumberId is required to connect a whatsapp-cloud instance");
+        throw new MetaApiError(MetaErrorCode.PHONE_NOT_FOUND, "metaPhoneNumberId is required to connect a whatsapp-business instance");
       }
       if (!wabaId) {
-        throw new MetaApiError(MetaErrorCode.INVALID_REQUEST, "metaWabaId is required to connect a whatsapp-cloud instance");
+        throw new MetaApiError(MetaErrorCode.INVALID_REQUEST, "metaWabaId is required to connect a whatsapp-business instance");
       }
       const apiVersion = creds.metaApiVersion ?? opts.metaApiVersion ?? "v25.0";
       const appId = creds.metaAppId ?? opts.metaAppId;
@@ -171091,7 +171091,7 @@ var init_plugin = __esm(() => {
       if (!reachable) {
         throw new MetaApiError(MetaErrorCode.AUTH_FAILED, "Meta access token rejected or phone_number_id unreachable \u2014 check credentials", { operation: "connect" });
       }
-      const cloudConfig = {
+      const businessConfig = {
         accessToken,
         phoneNumberId,
         wabaId,
@@ -171103,7 +171103,7 @@ var init_plugin = __esm(() => {
       };
       const dedupeCache = createInboundDedupeCache();
       const lastInboundWamid = new Map;
-      this.waCloudInstances.set(instanceId, { client, config: cloudConfig, dedupeCache, lastInboundWamid });
+      this.waInstances.set(instanceId, { client, config: businessConfig, dedupeCache, lastInboundWamid });
       this.byPhoneNumberId.set(phoneNumberId, instanceId);
       let wabaSet = this.byWabaId.get(wabaId);
       if (!wabaSet) {
@@ -171114,7 +171114,7 @@ var init_plugin = __esm(() => {
       await this.updateInstanceStatus(instanceId, config2, {
         state: "connected",
         since: new Date,
-        message: `Connected via Meta Cloud API (${connectionMethod})`
+        message: `Connected via WhatsApp Business API (${connectionMethod})`
       });
       await this.emitInstanceConnected(instanceId, {
         profileName: displayPhoneNumber ?? "WhatsApp Cloud",
@@ -171124,10 +171124,10 @@ var init_plugin = __esm(() => {
     }
     async disconnect(instanceId) {
       this.logger.info("Disconnecting WhatsApp Cloud instance", { instanceId });
-      const state = this.waCloudInstances.get(instanceId);
+      const state = this.waInstances.get(instanceId);
       if (state) {
         state.dedupeCache.dispose();
-        this.waCloudInstances.delete(instanceId);
+        this.waInstances.delete(instanceId);
         this.byPhoneNumberId.delete(state.config.phoneNumberId);
         const wabaSet = this.byWabaId.get(state.config.wabaId);
         if (wabaSet) {
@@ -171144,7 +171144,7 @@ var init_plugin = __esm(() => {
       await this.emitInstanceDisconnected(instanceId, "Manual disconnect");
     }
     async sendMessage(instanceId, message2) {
-      const state = this.waCloudInstances.get(instanceId);
+      const state = this.waInstances.get(instanceId);
       if (!state) {
         return {
           success: false,
@@ -171234,12 +171234,12 @@ var init_plugin = __esm(() => {
     }
     async getHealth(instanceId) {
       const checks2 = [];
-      const single = instanceId ? this.waCloudInstances.get(instanceId) : undefined;
-      const states = instanceId ? single ? [[instanceId, single]] : [] : Array.from(this.waCloudInstances.entries());
+      const single = instanceId ? this.waInstances.get(instanceId) : undefined;
+      const states = instanceId ? single ? [[instanceId, single]] : [] : Array.from(this.waInstances.entries());
       for (const [id, state] of states) {
         const ok2 = await state.client.ping();
         checks2.push({
-          name: `whatsapp-cloud:${id}`,
+          name: `whatsapp-business:${id}`,
           status: ok2 ? "pass" : "fail",
           message: ok2 ? `Phone ${state.config.phoneNumberId} reachable` : `Phone ${state.config.phoneNumberId} unreachable \u2014 token rejected or network error`
         });
@@ -171264,12 +171264,12 @@ var init_plugin = __esm(() => {
     async sendTyping(instanceId, chatId, duration) {
       if (duration === 0)
         return;
-      const state = this.waCloudInstances.get(instanceId);
+      const state = this.waInstances.get(instanceId);
       if (!state)
         return;
       const wamid = state.lastInboundWamid.get(toMetaPhone(chatId));
       if (!wamid) {
-        this.logger.debug("[whatsapp-cloud] sendTyping skipped \u2014 no inbound wamid remembered for chat", {
+        this.logger.debug("[whatsapp-business] sendTyping skipped \u2014 no inbound wamid remembered for chat", {
           instanceId,
           chatId
         });
@@ -171278,7 +171278,7 @@ var init_plugin = __esm(() => {
       try {
         await state.client.sendTypingIndicator(wamid);
       } catch (err2) {
-        this.logger.debug("[whatsapp-cloud] sendTyping failed (best-effort, ignored)", {
+        this.logger.debug("[whatsapp-business] sendTyping failed (best-effort, ignored)", {
           instanceId,
           chatId,
           err: String(err2)
@@ -171286,7 +171286,7 @@ var init_plugin = __esm(() => {
       }
     }
     rememberInboundWamid(instanceId, from, wamid) {
-      const state = this.waCloudInstances.get(instanceId);
+      const state = this.waInstances.get(instanceId);
       if (!state)
         return;
       const chatKey = toMetaPhone(from);
@@ -171305,14 +171305,14 @@ var init_plugin = __esm(() => {
         downloadGuard7.checkSize(media.file_size, this.logger, {
           instanceId,
           url: media.url,
-          channel: "whatsapp-cloud"
+          channel: "whatsapp-business"
         });
       }
       const bytes2 = await state.client.downloadMedia(media.url);
       return { buffer: Buffer.from(bytes2), mimeType: media.mime_type };
     }
     requireInstanceState(instanceId, operation) {
-      const state = this.waCloudInstances.get(instanceId);
+      const state = this.waInstances.get(instanceId);
       if (!state) {
         throw new MetaApiError(MetaErrorCode.NOT_CONNECTED, "WhatsApp Cloud instance not connected", {
           operation
@@ -171321,16 +171321,16 @@ var init_plugin = __esm(() => {
       return state;
     }
     getInstanceState(instanceId) {
-      return this.waCloudInstances.get(instanceId);
+      return this.waInstances.get(instanceId);
     }
     getConnectedInstanceIds() {
-      return Array.from(this.waCloudInstances.keys());
+      return Array.from(this.waInstances.keys());
     }
     findInstanceByPhoneNumberId(phoneNumberId) {
       const id = this.byPhoneNumberId.get(phoneNumberId);
       if (!id)
         return;
-      const state = this.waCloudInstances.get(id);
+      const state = this.waInstances.get(id);
       return state ? [id, state] : undefined;
     }
     findInstancesByWabaId(wabaId) {
@@ -171339,7 +171339,7 @@ var init_plugin = __esm(() => {
         return [];
       const matches = [];
       for (const id of ids2) {
-        const state = this.waCloudInstances.get(id);
+        const state = this.waInstances.get(id);
         if (state)
           matches.push([id, state]);
       }
@@ -171350,8 +171350,8 @@ var init_plugin = __esm(() => {
     }
     async handleInboundMessage(instanceId, msg, contacts, dedupeCache) {
       const wamid = msg.id;
-      if (dedupeCache.isDuplicate(instanceId, wamid, "whatsapp-cloud", this.logger)) {
-        this.logger.debug("[whatsapp-cloud] duplicate inbound dropped", { instanceId, wamid });
+      if (dedupeCache.isDuplicate(instanceId, wamid, "whatsapp-business", this.logger)) {
+        this.logger.debug("[whatsapp-business] duplicate inbound dropped", { instanceId, wamid });
         return false;
       }
       if (msg.type === "reaction") {
@@ -171361,7 +171361,7 @@ var init_plugin = __esm(() => {
       this.rememberInboundWamid(instanceId, msg.from, wamid);
       const content = extractInboundContent2(msg);
       if (!content) {
-        this.logger.warn("[whatsapp-cloud] inbound message has no extractable content", {
+        this.logger.warn("[whatsapp-business] inbound message has no extractable content", {
           instanceId,
           wamid,
           type: msg.type
@@ -171430,7 +171430,7 @@ var init_plugin = __esm(() => {
           continue;
         const sanitized = sanitizeMessage(value, this.logger, { instanceId, messageId: wamid });
         if (!sanitized.ok) {
-          this.logger.warn("[whatsapp-cloud] inbound text rejected by sanitizer", {
+          this.logger.warn("[whatsapp-business] inbound text rejected by sanitizer", {
             instanceId,
             wamid,
             field,
@@ -171506,7 +171506,7 @@ var init_plugin = __esm(() => {
     async handleTemplateStatusChanged(instanceId, update2, extras) {
       const newStatus = mapTemplateEventToStatus(update2.event);
       if (!newStatus) {
-        this.logger.debug("[whatsapp-cloud] unmapped template lifecycle event", {
+        this.logger.debug("[whatsapp-business] unmapped template lifecycle event", {
           instanceId,
           event: update2.event,
           metaTemplateId: update2.message_template_id
@@ -171539,7 +171539,7 @@ var init_plugin = __esm(() => {
   };
 });
 
-// ../channel-whatsapp-cloud/src/flows/demo-resolver.ts
+// ../channel-whatsapp-business/src/flows/demo-resolver.ts
 function createDemoFlowResolver() {
   return {
     resolve(ctx) {
@@ -171566,7 +171566,7 @@ function createDemoFlowResolver() {
   };
 }
 
-// ../channel-whatsapp-cloud/src/oauth.ts
+// ../channel-whatsapp-business/src/oauth.ts
 function graphBase(apiVersion = DEFAULT_META_API_VERSION) {
   return `https://graph.facebook.com/${apiVersion}`;
 }
@@ -171781,7 +171781,7 @@ var init_oauth = __esm(() => {
   init_errors3();
 });
 
-// ../channel-whatsapp-cloud/src/index.ts
+// ../channel-whatsapp-business/src/index.ts
 var exports_src4 = {};
 __export(exports_src4, {
   uploadHeaderMedia: () => uploadHeaderMedia,
@@ -171807,8 +171807,8 @@ __export(exports_src4, {
   createTemplate: () => createTemplate,
   createDemoFlowResolver: () => createDemoFlowResolver,
   buildFlowToken: () => buildFlowToken,
-  WhatsAppCloudPlugin: () => WhatsAppCloudPlugin,
-  WHATSAPP_CLOUD_CAPABILITIES: () => WHATSAPP_CLOUD_CAPABILITIES,
+  WhatsAppBusinessPlugin: () => WhatsAppBusinessPlugin,
+  WHATSAPP_BUSINESS_CAPABILITIES: () => WHATSAPP_BUSINESS_CAPABILITIES,
   MetaWhatsAppClient: () => MetaWhatsAppClient,
   MetaErrorCode: () => MetaErrorCode,
   MetaApiError: () => MetaApiError,
@@ -171826,7 +171826,7 @@ var init_src6 = __esm(() => {
   init_flow_crypto();
   init_oauth();
   init_errors3();
-  plugin8 = new WhatsAppCloudPlugin;
+  plugin8 = new WhatsAppBusinessPlugin;
   src_default8 = plugin8;
 });
 
@@ -242831,7 +242831,7 @@ var init_sentry_scrub = __esm(() => {
 var require_package7 = __commonJS((exports, module) => {
   module.exports = {
     name: "@omni/api",
-    version: "2.260803.2",
+    version: "2.260804.1",
     type: "module",
     exports: {
       ".": {
@@ -242864,7 +242864,7 @@ var require_package7 = __commonJS((exports, module) => {
       "@hono/swagger-ui": "^0.4.1",
       "@hono/zod-validator": "^0.4.3",
       "@omni/channel-sdk": "workspace:*",
-      "@omni/channel-whatsapp-cloud": "workspace:*",
+      "@omni/channel-whatsapp-business": "workspace:*",
       "@omni/core": "workspace:*",
       "@omni/db": "workspace:*",
       "@omni/media-processing": "workspace:*",
@@ -293781,17 +293781,17 @@ var init_scopes = __esm(() => {
     "POST /voice/leave": "voice:write",
     "GET /voice/sessions": "voice:read",
     "GET /voice/sessions/:id": "voice:read",
-    "POST /instances/:id/whatsapp-cloud/oauth/exchange": "instances:write",
-    "POST /instances/:id/whatsapp-cloud/connect": "instances:write",
-    "POST /instances/:id/whatsapp-cloud/register": "instances:write",
-    "POST /instances/:id/whatsapp-cloud/subscribe-app": "instances:write",
-    "GET /instances/:id/whatsapp-cloud/connection": "instances:read",
-    "DELETE /instances/:id/whatsapp-cloud/connection": "instances:write",
-    "GET /instances/:id/whatsapp-cloud/quality": "instances:read",
-    "GET /instances/:id/whatsapp-cloud/analytics": "instances:read",
-    "GET /instances/:id/whatsapp-cloud/profile": "instances:read",
-    "PUT /instances/:id/whatsapp-cloud/profile": "instances:write",
-    "POST /instances/:id/whatsapp-cloud/profile/photo": "instances:write",
+    "POST /instances/:id/whatsapp-business/oauth/exchange": "instances:write",
+    "POST /instances/:id/whatsapp-business/connect": "instances:write",
+    "POST /instances/:id/whatsapp-business/register": "instances:write",
+    "POST /instances/:id/whatsapp-business/subscribe-app": "instances:write",
+    "GET /instances/:id/whatsapp-business/connection": "instances:read",
+    "DELETE /instances/:id/whatsapp-business/connection": "instances:write",
+    "GET /instances/:id/whatsapp-business/quality": "instances:read",
+    "GET /instances/:id/whatsapp-business/analytics": "instances:read",
+    "GET /instances/:id/whatsapp-business/profile": "instances:read",
+    "PUT /instances/:id/whatsapp-business/profile": "instances:write",
+    "POST /instances/:id/whatsapp-business/profile/photo": "instances:write",
     "GET /instances/:id/whatsapp-flows": "instances:read",
     "POST /instances/:id/whatsapp-flows": "instances:write",
     "GET /instances/:id/whatsapp-flows/keys": "instances:read",
@@ -294310,19 +294310,39 @@ var init_route_ownership = __esm(() => {
       justification: "Hermes (Mutant) gateway callback. Auth-exempt for Mutant's servers, which send no credential and no " + "signature \u2014 the Hermes API has no HMAC mechanism at all. Authenticity rests on two factors the handler " + "enforces: the per-instance path (an unguessable instance UUID, the Gupshup precedent) and a cross-check " + "of the payload media_id (the Hermes UUID of the WhatsApp line) against the hermes_media_id stored " + "server-side on that instance \u2014 a mismatch is dropped with a warn log. The tenant comes from the " + "server-side instance record addressed by the path, never from a body or header claim. Responses are " + "fixed 200 acks with no row data."
     },
     {
-      route: "GET /api/v2/channels/whatsapp-cloud/webhook",
+      route: "GET /api/v2/channels/whatsapp-business/webhook",
       class: "public-by-contract",
       justification: "Meta webhook verification challenge. Auth-exempt because Meta's servers send no credential; the handler " + "compares hub.verify_token against the server-held META_VERIFY_TOKEN and echoes back the hub.challenge " + "nonce Meta itself supplied. It reads no rows and reveals only whether the deployment-level verify token " + "matched \u2014 a configuration fact, not tenant data."
     },
     {
-      route: "POST /api/v2/channels/whatsapp-cloud/webhook",
+      route: "POST /api/v2/channels/whatsapp-business/webhook",
       class: "public-by-contract",
       justification: "Meta Cloud API callback. Auth-exempt for Meta's servers; authenticity is the X-Hub-Signature-256 HMAC the " + "plugin verifies against the server-held META_APP_SECRET over the raw body. The URL is global by Meta design " + "(one callback per app, no :instanceId segment) \u2014 the instance, and therefore the tenant, is resolved from " + "the server-side instance record matching the payload phone_number_id, never from a body or header tenant " + "claim. Responses are fixed acks (200/401) and carry no row data; unknown phone_number_id still acks 200 " + "so the surface is not a resource-existence oracle."
     },
     {
-      route: "POST /api/v2/channels/whatsapp-cloud/flows/data/:instanceId",
+      route: "POST /api/v2/channels/whatsapp-business/flows/data/:instanceId",
       class: "public-by-contract",
       justification: "WhatsApp Flows data-exchange endpoint. Auth-exempt for Meta's servers; authenticity is double: the " + "X-Hub-Signature-256 HMAC verified against the server-held META_APP_SECRET over the raw body (432 on " + "mismatch), and RSA-OAEP payload encryption \u2014 only the private key registered for the :instanceId row can " + "decrypt the request (421 otherwise), so a forged path yields nothing. The tenant comes from the " + "server-side instance record addressed by the path (the Gupshup/Twilio per-instance precedent); the " + "private key is unsealed server-side via openCredentialField under that record\u2019s tenant. Responses are " + "AES-GCM-encrypted screen payloads readable only by the requesting WhatsApp client, or bare status codes " + "(404/421/427/432) that reveal no row data."
+    },
+    {
+      route: "GET /api/v2/channels/whatsapp-cloud/webhook",
+      class: "public-by-contract",
+      justification: "Frozen legacy alias of GET /api/v2/channels/whatsapp-business/webhook (same handler reference, zero added " + "surface). See the canonical entry for the full contract justification."
+    },
+    {
+      route: "POST /api/v2/channels/whatsapp-cloud/webhook",
+      class: "public-by-contract",
+      justification: "Frozen legacy alias of POST /api/v2/channels/whatsapp-business/webhook (same handler reference, zero added " + "surface). See the canonical entry for the full contract justification."
+    },
+    {
+      route: "POST /api/v2/channels/whatsapp-cloud/flows/data/:instanceId",
+      class: "public-by-contract",
+      justification: "Frozen legacy alias of POST /api/v2/channels/whatsapp-business/flows/data/:instanceId (same handler " + "reference, zero added surface). Pre-rename flows carry this path in their Meta-side endpoint_uri."
+    },
+    {
+      route: "ALL /api/v2/instances/:instanceId/whatsapp-cloud/*",
+      class: "public-by-contract",
+      justification: "Legacy REST alias: rewrites the path segment to /whatsapp-business/ and re-dispatches through the full " + "pipeline \u2014 the INNER canonical route enforces auth, scopes and ownership; this catch-all only rewrites the " + "URL and can serve nothing by itself. Kept permanently for pre-rename API consumers."
     }
   ];
   PLATFORM_ADMIN_JUSTIFICATION = "ADR-0005 platform tenant lifecycle. Requires a platform-class credential; a tenant-class credential " + "cannot reach this surface at all, and per-tenant data access from it goes through the same forced-RLS " + "boundary bound to ONE audited target tenant (platform-target-tenant.ts).";
@@ -294356,7 +294376,7 @@ var init_route_ownership = __esm(() => {
     "DELETE /api/v2/instances/:id/block",
     "DELETE /api/v2/instances/:id/guilds/:guildId/config",
     "DELETE /api/v2/instances/:id/profile/picture",
-    "DELETE /api/v2/instances/:id/whatsapp-cloud/connection",
+    "DELETE /api/v2/instances/:id/whatsapp-business/connection",
     "DELETE /api/v2/instances/:id/whatsapp-templates/:templateId",
     "DELETE /api/v2/instances/:instanceId/routes/:id",
     "DELETE /api/v2/messages/:id",
@@ -294437,10 +294457,10 @@ var init_route_ownership = __esm(() => {
     "GET /api/v2/instances/:id/sync",
     "GET /api/v2/instances/:id/sync/:jobId",
     "GET /api/v2/instances/:id/users/:userId/profile",
-    "GET /api/v2/instances/:id/whatsapp-cloud/analytics",
-    "GET /api/v2/instances/:id/whatsapp-cloud/connection",
-    "GET /api/v2/instances/:id/whatsapp-cloud/profile",
-    "GET /api/v2/instances/:id/whatsapp-cloud/quality",
+    "GET /api/v2/instances/:id/whatsapp-business/analytics",
+    "GET /api/v2/instances/:id/whatsapp-business/connection",
+    "GET /api/v2/instances/:id/whatsapp-business/profile",
+    "GET /api/v2/instances/:id/whatsapp-business/quality",
     "GET /api/v2/instances/:id/whatsapp-flows",
     "GET /api/v2/instances/:id/whatsapp-flows/:flowId",
     "GET /api/v2/instances/:id/whatsapp-flows/:flowId/preview",
@@ -294570,11 +294590,11 @@ var init_route_ownership = __esm(() => {
     "POST /api/v2/instances/:id/resync",
     "POST /api/v2/instances/:id/sync",
     "POST /api/v2/instances/:id/sync/profile",
-    "POST /api/v2/instances/:id/whatsapp-cloud/connect",
-    "POST /api/v2/instances/:id/whatsapp-cloud/oauth/exchange",
-    "POST /api/v2/instances/:id/whatsapp-cloud/profile/photo",
-    "POST /api/v2/instances/:id/whatsapp-cloud/register",
-    "POST /api/v2/instances/:id/whatsapp-cloud/subscribe-app",
+    "POST /api/v2/instances/:id/whatsapp-business/connect",
+    "POST /api/v2/instances/:id/whatsapp-business/oauth/exchange",
+    "POST /api/v2/instances/:id/whatsapp-business/profile/photo",
+    "POST /api/v2/instances/:id/whatsapp-business/register",
+    "POST /api/v2/instances/:id/whatsapp-business/subscribe-app",
     "POST /api/v2/instances/:id/whatsapp-flows",
     "POST /api/v2/instances/:id/whatsapp-flows/:flowId/deprecate",
     "POST /api/v2/instances/:id/whatsapp-flows/:flowId/publish",
@@ -294636,7 +294656,7 @@ var init_route_ownership = __esm(() => {
     "PUT /api/v2/instances/:id/presence",
     "PUT /api/v2/instances/:id/profile/name",
     "PUT /api/v2/instances/:id/profile/picture",
-    "PUT /api/v2/instances/:id/whatsapp-cloud/profile",
+    "PUT /api/v2/instances/:id/whatsapp-business/profile",
     "PUT /api/v2/instances/:id/whatsapp-flows/:flowId",
     "PUT /api/v2/instances/:id/profile/status",
     "PUT /api/v2/payload-config/:eventType",
@@ -347453,7 +347473,7 @@ function channelToKhalSessionSegment(channel5) {
     return;
   if (channel5 === "whatsapp-gupshup")
     return "gupshup";
-  if (channel5 === "whatsapp-cloud")
+  if (channel5 === "whatsapp-business")
     return "whatsapp";
   if (channel5 === "whatsapp-baileys")
     return "whatsapp";
@@ -349246,7 +349266,7 @@ function whatsappChatType(chatId) {
   return "dm";
 }
 function determineChatType(chatId, channel5, rawPayload) {
-  if (channel5 === "whatsapp" || channel5 === "whatsapp-baileys" || channel5 === "whatsapp-cloud" || channel5 === "twilio-whatsapp") {
+  if (channel5 === "whatsapp" || channel5 === "whatsapp-baileys" || channel5 === "whatsapp-business" || channel5 === "twilio-whatsapp") {
     return whatsappChatType(chatId);
   }
   if (channel5 === "telegram") {
@@ -352290,7 +352310,7 @@ var init_agent_dispatcher = __esm(() => {
   CHANNEL_MESSAGE_LIMITS = {
     discord: 2000,
     "whatsapp-baileys": 65536,
-    "whatsapp-cloud": 65536,
+    "whatsapp-business": 65536,
     "twilio-whatsapp": 1600,
     slack: 40000,
     telegram: 4096
@@ -361143,7 +361163,7 @@ function registerWhatsappFlowsSchemas(registry4) {
         }
       },
       400: {
-        description: "Not a whatsapp-cloud instance / not connected",
+        description: "Not a whatsapp-business instance / not connected",
         content: { "application/json": { schema: ErrorSchema } }
       }
     }
@@ -365951,6 +365971,18 @@ function applyTwilioWhatsAppConnectionOptions(options, input) {
     options.twilioValidateSignature = input.twilioValidateSignature;
   }
 }
+function applyHermesConnectionOptions(options, input) {
+  if (input.hermesBaseUrl)
+    options.hermesBaseUrl = input.hermesBaseUrl;
+  if (input.hermesUsername)
+    options.hermesUsername = input.hermesUsername;
+  if (input.hermesPassword)
+    options.hermesPassword = input.hermesPassword;
+  if (input.hermesMediaId)
+    options.hermesMediaId = input.hermesMediaId;
+  if (input.hermesTemplateNamespace)
+    options.hermesTemplateNamespace = input.hermesTemplateNamespace;
+}
 function applyChannelSpecificConnectionOptions(options, input) {
   switch (input.channel) {
     case "telegram":
@@ -365965,6 +365997,9 @@ function applyChannelSpecificConnectionOptions(options, input) {
     case "twilio-whatsapp":
       applyTwilioWhatsAppConnectionOptions(options, input);
       return;
+    case "hermes":
+      applyHermesConnectionOptions(options, input);
+      return;
   }
 }
 function buildInstanceConnectionOptions(input) {
@@ -366093,7 +366128,12 @@ function buildConnectConnectionOptions(instance4, body, forceNewQr) {
     twilioMessagingServiceSid: body.twilioMessagingServiceSid ?? instance4.twilioMessagingServiceSid,
     twilioStatusCallbackUrl: body.twilioStatusCallbackUrl ?? instance4.twilioStatusCallbackUrl,
     twilioWebhookUrl: body.twilioWebhookUrl ?? instance4.twilioWebhookUrl,
-    twilioValidateSignature: body.twilioValidateSignature ?? instance4.twilioValidateSignature
+    twilioValidateSignature: body.twilioValidateSignature ?? instance4.twilioValidateSignature,
+    hermesBaseUrl: body.hermesBaseUrl ?? instance4.hermesBaseUrl,
+    hermesUsername: body.hermesUsername ?? instance4.hermesUsername,
+    hermesPassword: body.hermesPassword ?? instance4.hermesPassword,
+    hermesMediaId: body.hermesMediaId ?? instance4.hermesMediaId,
+    hermesTemplateNamespace: body.hermesTemplateNamespace ?? instance4.hermesTemplateNamespace
   });
 }
 function hydrateConnectionOptionsForInstance(plugin10, instance4, options) {
@@ -366115,17 +366155,28 @@ function buildConnectPersistUpdates(instance4, body) {
     isActive: true,
     ...buildTokenPersistUpdates(instance4.channel, body)
   };
-  if (instance4.channel !== "twilio-whatsapp")
-    return updates;
-  return {
-    ...updates,
-    twilioAccountSid: body.twilioAccountSid ?? instance4.twilioAccountSid,
-    twilioFrom: body.twilioFrom ?? instance4.twilioFrom,
-    twilioMessagingServiceSid: body.twilioMessagingServiceSid ?? instance4.twilioMessagingServiceSid,
-    twilioStatusCallbackUrl: body.twilioStatusCallbackUrl ?? instance4.twilioStatusCallbackUrl,
-    twilioWebhookUrl: body.twilioWebhookUrl ?? instance4.twilioWebhookUrl,
-    twilioValidateSignature: body.twilioValidateSignature ?? instance4.twilioValidateSignature
-  };
+  if (instance4.channel === "twilio-whatsapp") {
+    return {
+      ...updates,
+      twilioAccountSid: body.twilioAccountSid ?? instance4.twilioAccountSid,
+      twilioFrom: body.twilioFrom ?? instance4.twilioFrom,
+      twilioMessagingServiceSid: body.twilioMessagingServiceSid ?? instance4.twilioMessagingServiceSid,
+      twilioStatusCallbackUrl: body.twilioStatusCallbackUrl ?? instance4.twilioStatusCallbackUrl,
+      twilioWebhookUrl: body.twilioWebhookUrl ?? instance4.twilioWebhookUrl,
+      twilioValidateSignature: body.twilioValidateSignature ?? instance4.twilioValidateSignature
+    };
+  }
+  if (instance4.channel === "hermes") {
+    return {
+      ...updates,
+      hermesBaseUrl: body.hermesBaseUrl ?? instance4.hermesBaseUrl,
+      hermesUsername: body.hermesUsername ?? instance4.hermesUsername,
+      hermesPassword: body.hermesPassword ?? instance4.hermesPassword,
+      hermesMediaId: body.hermesMediaId ?? instance4.hermesMediaId,
+      hermesTemplateNamespace: body.hermesTemplateNamespace ?? instance4.hermesTemplateNamespace
+    };
+  }
+  return updates;
 }
 async function validateMessageSyncPreconditions(services, instanceId, channel5, type, chatJids) {
   if (chatJids?.length && !channel5.startsWith("whatsapp")) {
@@ -366304,6 +366355,11 @@ var init_instances3 = __esm(() => {
     twilioStatusCallbackUrl: exports_external.string().optional().nullable().describe("Twilio outbound status callback URL"),
     twilioWebhookUrl: exports_external.string().optional().nullable().describe("Public Twilio inbound webhook URL for signature validation"),
     twilioValidateSignature: exports_external.boolean().default(true).describe("Validate X-Twilio-Signature on webhooks"),
+    hermesBaseUrl: exports_external.string().optional().nullable().describe("Hermes API base URL (e.g. https://waap-api.h3rmes.com)"),
+    hermesUsername: exports_external.string().optional().nullable().describe("Hermes account username"),
+    hermesPassword: exports_external.string().optional().nullable().describe("Hermes account password"),
+    hermesMediaId: exports_external.string().optional().nullable().describe("Hermes line UUID (media_id) \u2014 required on every send"),
+    hermesTemplateNamespace: exports_external.string().optional().nullable().describe("Meta template namespace for HSM sends"),
     readReceipts: exports_external.enum(["on", "off", "exclude-self"]).default("on").describe("Read receipt mode: on (default), off, or exclude-self (skip receipts for the instance own number)"),
     groupHistorySize: exports_external.number().int().min(0).max(200).default(50).describe("Number of context messages to include when dispatching to agent. Groups use the full value; DMs are capped at 20. (0 = disabled, max 200)"),
     markOnlineOnConnect: exports_external.boolean().default(true).describe("Mark the instance as online when connecting to WhatsApp (default: true). Set to false to preserve phone push notifications."),
@@ -366361,7 +366417,8 @@ var init_instances3 = __esm(() => {
     "slackSigningSecret",
     "gupshupAuthToken",
     "webhookVerifyToken",
-    "twilioAuthToken"
+    "twilioAuthToken",
+    "hermesPassword"
   ];
   instancesRoutes.get("/", zValidator("query", listQuerySchema12), async (c) => {
     const { channel: channel5, status, limit: limit2, cursor } = c.req.valid("query");
@@ -366391,7 +366448,7 @@ var init_instances3 = __esm(() => {
     const loadedIds = new Set(loadedPlugins.map((p2) => p2.id));
     const staticChannels = [
       {
-        id: "whatsapp-cloud",
+        id: "whatsapp-business",
         name: "WhatsApp Business Cloud",
         description: "Official WhatsApp Business API",
         loaded: false
@@ -366459,7 +366516,12 @@ var init_instances3 = __esm(() => {
       twilioMessagingServiceSid: instance4.twilioMessagingServiceSid,
       twilioStatusCallbackUrl: instance4.twilioStatusCallbackUrl,
       twilioWebhookUrl: instance4.twilioWebhookUrl,
-      twilioValidateSignature: instance4.twilioValidateSignature
+      twilioValidateSignature: instance4.twilioValidateSignature,
+      hermesBaseUrl: instance4.hermesBaseUrl,
+      hermesUsername: instance4.hermesUsername,
+      hermesPassword: instance4.hermesPassword,
+      hermesMediaId: instance4.hermesMediaId,
+      hermesTemplateNamespace: instance4.hermesTemplateNamespace
     });
     const createPlugin = getPluginFromRegistry(channelRegistry2, data.channel);
     if (createPlugin && "loadGuildConfigs" in createPlugin && instance4.guildConfigOverrides) {
@@ -366638,6 +366700,11 @@ var init_instances3 = __esm(() => {
     twilioStatusCallbackUrl: exports_external.string().optional().describe("Twilio outbound status callback URL"),
     twilioWebhookUrl: exports_external.string().optional().describe("Public Twilio inbound webhook URL for signature validation"),
     twilioValidateSignature: exports_external.boolean().optional().describe("Validate X-Twilio-Signature on webhooks"),
+    hermesBaseUrl: exports_external.string().optional().describe("Hermes API base URL"),
+    hermesUsername: exports_external.string().optional().describe("Hermes account username"),
+    hermesPassword: exports_external.string().optional().describe("Hermes account password"),
+    hermesMediaId: exports_external.string().optional().describe("Hermes line UUID (media_id)"),
+    hermesTemplateNamespace: exports_external.string().optional().describe("Meta template namespace for HSM sends"),
     whatsapp: exports_external.object({
       syncFullHistory: exports_external.boolean().optional().describe("Sync full message history on connect (default: true)")
     }).optional().describe("WhatsApp-specific connection options")
@@ -372214,7 +372281,7 @@ var init_templates3 = __esm(() => {
       });
       return c.json({ data: persisted.row }, persisted.created ? 201 : 200);
     } catch (dbErr) {
-      log118.error("[whatsapp-cloud] local template mirror failed after Meta create", {
+      log118.error("[whatsapp-business] local template mirror failed after Meta create", {
         instanceId,
         metaTemplateId: result.id,
         name: body.name,
@@ -372844,7 +372911,7 @@ var init_oauth_token_cache = __esm(() => {
   store = new Map;
 });
 
-// ../api/src/routes/v2/whatsapp-cloud.ts
+// ../api/src/routes/v2/whatsapp-business.ts
 function readMetaAppEnv() {
   return {
     appId: process.env.META_APP_ID,
@@ -372852,14 +372919,14 @@ function readMetaAppEnv() {
     apiVersion: process.env.META_GRAPH_API_VERSION ?? "v25.0"
   };
 }
-function ensureWhatsAppCloud(instance4) {
-  if (instance4.channel !== "whatsapp-cloud") {
+function ensureWhatsAppBusiness(instance4) {
+  if (instance4.channel !== "whatsapp-business") {
     return {
       ok: false,
       payload: {
         error: {
           code: "WRONG_CHANNEL",
-          message: `Instance channel is "${instance4.channel}", expected "whatsapp-cloud"`
+          message: `Instance channel is "${instance4.channel}", expected "whatsapp-business"`
         }
       }
     };
@@ -372895,8 +372962,8 @@ async function readProfilePhotoUpload(c) {
     fileType: blob.type || "image/jpeg"
   };
 }
-var log119, whatsappCloudRoutes, instanceAccess4, analyticsQuerySchema2, updateProfileSchema;
-var init_whatsapp_cloud3 = __esm(() => {
+var log119, whatsappBusinessRoutes, instanceAccess4, analyticsQuerySchema2, updateProfileSchema;
+var init_whatsapp_business3 = __esm(() => {
   init_dist6();
   init_src6();
   init_src();
@@ -372905,11 +372972,11 @@ var init_whatsapp_cloud3 = __esm(() => {
   init_zod();
   init_oauth_token_cache();
   init_auth();
-  log119 = createLogger("api:whatsapp-cloud");
-  whatsappCloudRoutes = new Hono2;
+  log119 = createLogger("api:whatsapp-business");
+  whatsappBusinessRoutes = new Hono2;
   instanceAccess4 = requireInstanceAccess((c) => c.req.param("id") ?? "");
-  whatsappCloudRoutes.use("/:id/whatsapp-cloud/*", instanceAccess4);
-  whatsappCloudRoutes.post("/:id/whatsapp-cloud/oauth/exchange", zValidator("json", EmbeddedSignupExchangeRequestSchema), async (c) => {
+  whatsappBusinessRoutes.use("/:id/whatsapp-business/*", instanceAccess4);
+  whatsappBusinessRoutes.post("/:id/whatsapp-business/oauth/exchange", zValidator("json", EmbeddedSignupExchangeRequestSchema), async (c) => {
     const { code } = c.req.valid("json");
     const { appId, appSecret, apiVersion } = readMetaAppEnv();
     if (!appId || !appSecret) {
@@ -372935,14 +373002,14 @@ var init_whatsapp_cloud3 = __esm(() => {
       return c.json({ error: { code: "OAUTH_EXCHANGE_FAILED", message: message2 } }, 400);
     }
   });
-  whatsappCloudRoutes.post("/:id/whatsapp-cloud/connect", zValidator("json", WhatsAppCloudConnectRequestSchema), async (c) => {
+  whatsappBusinessRoutes.post("/:id/whatsapp-business/connect", zValidator("json", WhatsAppBusinessConnectRequestSchema), async (c) => {
     const id = c.req.param("id");
     const body = c.req.valid("json");
     const services = c.get("services");
     const channelRegistry2 = c.get("channelRegistry");
     const { apiVersion } = readMetaAppEnv();
     const instance4 = await services.instances.getById(id);
-    const guard = ensureWhatsAppCloud(instance4);
+    const guard = ensureWhatsAppBusiness(instance4);
     if (!guard.ok)
       return c.json(guard.payload, 400);
     let accessToken;
@@ -372996,9 +373063,9 @@ var init_whatsapp_cloud3 = __esm(() => {
         error: err2 instanceof Error ? err2.message : String(err2)
       });
     }
-    const plugin10 = channelRegistry2?.get("whatsapp-cloud");
+    const plugin10 = channelRegistry2?.get("whatsapp-business");
     if (!plugin10) {
-      return c.json({ error: { code: "PLUGIN_NOT_FOUND", message: "whatsapp-cloud plugin not registered" } }, 500);
+      return c.json({ error: { code: "PLUGIN_NOT_FOUND", message: "whatsapp-business plugin not registered" } }, 500);
     }
     try {
       await plugin10.connect(id, {
@@ -373017,7 +373084,7 @@ var init_whatsapp_cloud3 = __esm(() => {
       });
     } catch (err2) {
       const message2 = err2 instanceof Error ? err2.message : "Unknown error";
-      log119.error("plugin.connect failed for whatsapp-cloud", { instanceId: id, error: message2 });
+      log119.error("plugin.connect failed for whatsapp-business", { instanceId: id, error: message2 });
       return c.json({ error: { code: "CONNECT_FAILED", message: message2 } }, 500);
     }
     return c.json({
@@ -373029,12 +373096,12 @@ var init_whatsapp_cloud3 = __esm(() => {
       }
     });
   });
-  whatsappCloudRoutes.post("/:id/whatsapp-cloud/register", zValidator("json", WhatsAppCloudRegisterRequestSchema), async (c) => {
+  whatsappBusinessRoutes.post("/:id/whatsapp-business/register", zValidator("json", WhatsAppBusinessRegisterRequestSchema), async (c) => {
     const id = c.req.param("id");
     const services = c.get("services");
     const { pin } = c.req.valid("json");
     const instance4 = await services.instances.getById(id);
-    const guard = ensureWhatsAppCloud(instance4);
+    const guard = ensureWhatsAppBusiness(instance4);
     if (!guard.ok)
       return c.json(guard.payload, 400);
     if (!instance4.metaAccessToken || !instance4.metaPhoneNumberId) {
@@ -373049,11 +373116,11 @@ var init_whatsapp_cloud3 = __esm(() => {
       return c.json({ error: { code: "REGISTER_FAILED", message: message2 } }, 500);
     }
   });
-  whatsappCloudRoutes.post("/:id/whatsapp-cloud/subscribe-app", async (c) => {
+  whatsappBusinessRoutes.post("/:id/whatsapp-business/subscribe-app", async (c) => {
     const id = c.req.param("id");
     const services = c.get("services");
     const instance4 = await services.instances.getById(id);
-    const guard = ensureWhatsAppCloud(instance4);
+    const guard = ensureWhatsAppBusiness(instance4);
     if (!guard.ok)
       return c.json(guard.payload, 400);
     if (!instance4.metaAccessToken || !instance4.metaWabaId) {
@@ -373068,11 +373135,11 @@ var init_whatsapp_cloud3 = __esm(() => {
       return c.json({ error: { code: "SUBSCRIBE_FAILED", message: message2 } }, 500);
     }
   });
-  whatsappCloudRoutes.get("/:id/whatsapp-cloud/connection", async (c) => {
+  whatsappBusinessRoutes.get("/:id/whatsapp-business/connection", async (c) => {
     const id = c.req.param("id");
     const services = c.get("services");
     const instance4 = await services.instances.getById(id);
-    const guard = ensureWhatsAppCloud(instance4);
+    const guard = ensureWhatsAppBusiness(instance4);
     if (!guard.ok)
       return c.json(guard.payload, 400);
     return c.json({
@@ -373089,15 +373156,15 @@ var init_whatsapp_cloud3 = __esm(() => {
       }
     });
   });
-  whatsappCloudRoutes.delete("/:id/whatsapp-cloud/connection", async (c) => {
+  whatsappBusinessRoutes.delete("/:id/whatsapp-business/connection", async (c) => {
     const id = c.req.param("id");
     const services = c.get("services");
     const channelRegistry2 = c.get("channelRegistry");
     const instance4 = await services.instances.getById(id);
-    const guard = ensureWhatsAppCloud(instance4);
+    const guard = ensureWhatsAppBusiness(instance4);
     if (!guard.ok)
       return c.json(guard.payload, 400);
-    const plugin10 = channelRegistry2?.get("whatsapp-cloud");
+    const plugin10 = channelRegistry2?.get("whatsapp-business");
     if (plugin10) {
       try {
         await plugin10.disconnect(id);
@@ -373122,11 +373189,11 @@ var init_whatsapp_cloud3 = __esm(() => {
     });
     return c.json({ success: true });
   });
-  whatsappCloudRoutes.get("/:id/whatsapp-cloud/quality", async (c) => {
+  whatsappBusinessRoutes.get("/:id/whatsapp-business/quality", async (c) => {
     const id = c.req.param("id");
     const services = c.get("services");
     const instance4 = await services.instances.getById(id);
-    const guard = ensureWhatsAppCloud(instance4);
+    const guard = ensureWhatsAppBusiness(instance4);
     if (!guard.ok)
       return c.json(guard.payload, 400);
     const client = buildClientFromInstance(instance4);
@@ -373145,12 +373212,12 @@ var init_whatsapp_cloud3 = __esm(() => {
     end: exports_external.coerce.number().int().optional().describe("Unix timestamp (seconds) \u2014 end of range"),
     granularity: exports_external.enum(["HALF_HOUR", "DAY", "MONTH"]).default("DAY")
   });
-  whatsappCloudRoutes.get("/:id/whatsapp-cloud/analytics", zValidator("query", analyticsQuerySchema2), async (c) => {
+  whatsappBusinessRoutes.get("/:id/whatsapp-business/analytics", zValidator("query", analyticsQuerySchema2), async (c) => {
     const id = c.req.param("id");
     const services = c.get("services");
     const { start, end, granularity } = c.req.valid("query");
     const instance4 = await services.instances.getById(id);
-    const guard = ensureWhatsAppCloud(instance4);
+    const guard = ensureWhatsAppBusiness(instance4);
     if (!guard.ok)
       return c.json(guard.payload, 400);
     if (!instance4.metaAccessToken || !instance4.metaWabaId) {
@@ -373183,11 +373250,11 @@ var init_whatsapp_cloud3 = __esm(() => {
       return c.json({ error: { code: "ANALYTICS_FETCH_FAILED", message: message2 } }, 500);
     }
   });
-  whatsappCloudRoutes.get("/:id/whatsapp-cloud/profile", async (c) => {
+  whatsappBusinessRoutes.get("/:id/whatsapp-business/profile", async (c) => {
     const id = c.req.param("id");
     const services = c.get("services");
     const instance4 = await services.instances.getById(id);
-    const guard = ensureWhatsAppCloud(instance4);
+    const guard = ensureWhatsAppBusiness(instance4);
     if (!guard.ok)
       return c.json(guard.payload, 400);
     const client = buildClientFromInstance(instance4);
@@ -373209,12 +373276,12 @@ var init_whatsapp_cloud3 = __esm(() => {
     vertical: exports_external.string().optional(),
     websites: exports_external.array(exports_external.string().url()).max(2).optional()
   });
-  whatsappCloudRoutes.put("/:id/whatsapp-cloud/profile", zValidator("json", updateProfileSchema), async (c) => {
+  whatsappBusinessRoutes.put("/:id/whatsapp-business/profile", zValidator("json", updateProfileSchema), async (c) => {
     const id = c.req.param("id");
     const services = c.get("services");
     const body = c.req.valid("json");
     const instance4 = await services.instances.getById(id);
-    const guard = ensureWhatsAppCloud(instance4);
+    const guard = ensureWhatsAppBusiness(instance4);
     if (!guard.ok)
       return c.json(guard.payload, 400);
     const client = buildClientFromInstance(instance4);
@@ -373228,12 +373295,12 @@ var init_whatsapp_cloud3 = __esm(() => {
       return c.json({ error: { code: "PROFILE_UPDATE_FAILED", message: message2 } }, 500);
     }
   });
-  whatsappCloudRoutes.post("/:id/whatsapp-cloud/profile/photo", async (c) => {
+  whatsappBusinessRoutes.post("/:id/whatsapp-business/profile/photo", async (c) => {
     const id = c.req.param("id");
     const services = c.get("services");
     const { appId: envAppId } = readMetaAppEnv();
     const instance4 = await services.instances.getById(id);
-    const guard = ensureWhatsAppCloud(instance4);
+    const guard = ensureWhatsAppBusiness(instance4);
     if (!guard.ok)
       return c.json(guard.payload, 400);
     if (!instance4.metaAccessToken || !instance4.metaPhoneNumberId) {
@@ -373290,7 +373357,7 @@ function readMetaConfig2(instance4) {
 }
 async function resolveFlowsClient(services, instanceId) {
   const instance4 = await services.instances.getById(instanceId);
-  const guard = ensureWhatsAppCloud(instance4);
+  const guard = ensureWhatsAppBusiness(instance4);
   if (!guard.ok)
     return guard;
   const cfg = readMetaConfig2(instance4);
@@ -373304,7 +373371,7 @@ function flowsDataEndpointUri(instanceId) {
   const base2 = process.env.META_FLOWS_PUBLIC_BASE_URL?.replace(/\/+$/, "");
   if (!base2)
     return null;
-  return `${base2}/api/v2/channels/whatsapp-cloud/flows/data/${instanceId}`;
+  return `${base2}/api/v2/channels/whatsapp-business/flows/data/${instanceId}`;
 }
 function flowJsonInvalid(issues) {
   return {
@@ -373327,7 +373394,7 @@ var init_whatsapp_flows3 = __esm(() => {
   init_zod();
   init_auth();
   init_sealed_credentials();
-  init_whatsapp_cloud3();
+  init_whatsapp_business3();
   log120 = createLogger("routes:whatsapp-flows");
   whatsappFlowsRoutes = new Hono2;
   instanceAccess5 = requireInstanceAccess((c) => c.req.param("id") ?? "");
@@ -373557,12 +373624,12 @@ var init_whatsapp_flows3 = __esm(() => {
     const services = c.get("services");
     const channelRegistry2 = c.get("channelRegistry");
     const instance4 = await services.instances.getById(instanceId);
-    const guard = ensureWhatsAppCloud(instance4);
+    const guard = ensureWhatsAppBusiness(instance4);
     if (!guard.ok)
       return c.json(guard.payload, 400);
-    const plugin10 = channelRegistry2?.get("whatsapp-cloud");
+    const plugin10 = channelRegistry2?.get("whatsapp-business");
     if (!plugin10) {
-      return c.json(jsonError2("whatsapp-cloud plugin not registered", "PLUGIN_NOT_FOUND"), 500);
+      return c.json(jsonError2("whatsapp-business plugin not registered", "PLUGIN_NOT_FOUND"), 500);
     }
     const flowToken = flow.flowToken ?? buildFlowToken(flow.flowId ?? flow.flowName ?? "unknown");
     const result = await plugin10.sendMessage(instanceId, {
@@ -373616,7 +373683,7 @@ var init_v2 = __esm(() => {
   init_turns2();
   init_voice2();
   init_webhooks3();
-  init_whatsapp_cloud3();
+  init_whatsapp_business3();
   init_whatsapp_flows3();
   v2Routes = new Hono2;
   v2Routes.route("/a2a", a2aRoutes);
@@ -373648,7 +373715,7 @@ var init_v2 = __esm(() => {
   v2Routes.route("/voice", voiceRoutes);
   v2Routes.route("/follow-up", followUpRoutes);
   v2Routes.route("/handoffs", handoffsRoutes);
-  v2Routes.route("/instances", whatsappCloudRoutes);
+  v2Routes.route("/instances", whatsappBusinessRoutes);
   v2Routes.route("/", templatesRoutes);
   v2Routes.route("/", whatsappFlowsRoutes);
   v2Routes.route("/", payloadsRoutes);
@@ -374018,41 +374085,34 @@ function createApp(db2, eventBus = null, channelRegistry2 = null) {
     }
     return plugin10.handleWebhook(c.req.raw);
   });
-  app.get("/api/v2/channels/whatsapp-cloud/webhook", async (c) => {
+  const handleWhatsAppBusinessWebhook = async (c) => {
     const channelRegistry3 = c.get("channelRegistry");
     if (!channelRegistry3) {
       return c.json({ error: { code: "NO_REGISTRY", message: "Channel registry not available" } }, 503);
     }
-    const plugin10 = channelRegistry3.get("whatsapp-cloud");
+    const plugin10 = channelRegistry3.get("whatsapp-business");
     if (!plugin10?.handleWebhook) {
-      return c.json({ error: { code: "PLUGIN_NOT_FOUND", message: "WhatsApp Cloud plugin not loaded" } }, 503);
+      return c.json({ error: { code: "PLUGIN_NOT_FOUND", message: "WhatsApp Business plugin not loaded" } }, 503);
     }
     return plugin10.handleWebhook(c.req.raw);
-  });
-  app.post("/api/v2/channels/whatsapp-cloud/webhook", async (c) => {
-    const channelRegistry3 = c.get("channelRegistry");
-    if (!channelRegistry3) {
-      return c.json({ error: { code: "NO_REGISTRY", message: "Channel registry not available" } }, 503);
-    }
-    const plugin10 = channelRegistry3.get("whatsapp-cloud");
-    if (!plugin10?.handleWebhook) {
-      return c.json({ error: { code: "PLUGIN_NOT_FOUND", message: "WhatsApp Cloud plugin not loaded" } }, 503);
-    }
-    return plugin10.handleWebhook(c.req.raw);
-  });
-  app.post("/api/v2/channels/whatsapp-cloud/flows/data/:instanceId", async (c) => {
+  };
+  app.get("/api/v2/channels/whatsapp-business/webhook", handleWhatsAppBusinessWebhook);
+  app.post("/api/v2/channels/whatsapp-business/webhook", handleWhatsAppBusinessWebhook);
+  app.get("/api/v2/channels/whatsapp-cloud/webhook", handleWhatsAppBusinessWebhook);
+  app.post("/api/v2/channels/whatsapp-cloud/webhook", handleWhatsAppBusinessWebhook);
+  const handleWhatsAppFlowsData = async (c) => {
     const channelRegistry3 = c.get("channelRegistry");
     if (!channelRegistry3) {
       return c.json({ error: { code: "NO_REGISTRY", message: "Channel registry not available" } }, 503);
     }
-    const plugin10 = channelRegistry3.get("whatsapp-cloud");
+    const plugin10 = channelRegistry3.get("whatsapp-business");
     if (!plugin10?.handleFlowData) {
-      return c.json({ error: { code: "PLUGIN_NOT_FOUND", message: "WhatsApp Cloud plugin not loaded" } }, 503);
+      return c.json({ error: { code: "PLUGIN_NOT_FOUND", message: "WhatsApp Business plugin not loaded" } }, 503);
     }
-    const instanceId = c.req.param("instanceId");
+    const instanceId = c.req.param("instanceId") ?? "";
     const services2 = c.get("services");
     const instance4 = await services2.instances.getById(instanceId).catch(() => null);
-    if (!instance4 || instance4.channel !== "whatsapp-cloud") {
+    if (!instance4 || instance4.channel !== "whatsapp-business") {
       return c.json({ error: { code: "NOT_FOUND", message: "Unknown instance" } }, 404);
     }
     const db3 = c.get("db");
@@ -374063,6 +374123,13 @@ function createApp(db2, eventBus = null, channelRegistry2 = null) {
       return c.body(null, 421);
     }
     return plugin10.handleFlowData(c.req.raw, { instanceId, privateKeyPem });
+  };
+  app.post("/api/v2/channels/whatsapp-business/flows/data/:instanceId", handleWhatsAppFlowsData);
+  app.post("/api/v2/channels/whatsapp-cloud/flows/data/:instanceId", handleWhatsAppFlowsData);
+  app.all("/api/v2/instances/:instanceId/whatsapp-cloud/*", (c) => {
+    const url = new URL(c.req.url);
+    url.pathname = url.pathname.replace("/whatsapp-cloud/", "/whatsapp-business/");
+    return app.fetch(new Request(url.toString(), c.req.raw), c.env);
   });
   app.post("/api/v2/channels/twilio-whatsapp/:instanceId/webhook", async (c) => {
     const channelRegistry3 = c.get("channelRegistry");
@@ -376120,12 +376187,27 @@ function buildInstanceConnectOptions(instance4) {
   if (instance4.channel === "twilio-whatsapp") {
     applyTwilioWhatsAppOptions(options, instance4);
   }
-  if (instance4.channel === "whatsapp-cloud") {
-    applyWhatsAppCloudOptions(options, instance4);
+  if (instance4.channel === "whatsapp-business") {
+    applyWhatsAppBusinessOptions(options, instance4);
+  }
+  if (instance4.channel === "hermes") {
+    applyHermesOptions(options, instance4);
   }
   return options;
 }
-function applyWhatsAppCloudOptions(options, instance4) {
+function applyHermesOptions(options, instance4) {
+  if (instance4.hermesBaseUrl)
+    options.hermesBaseUrl = instance4.hermesBaseUrl;
+  if (instance4.hermesUsername)
+    options.hermesUsername = instance4.hermesUsername;
+  if (instance4.hermesPassword)
+    options.hermesPassword = instance4.hermesPassword;
+  if (instance4.hermesMediaId)
+    options.hermesMediaId = instance4.hermesMediaId;
+  if (instance4.hermesTemplateNamespace)
+    options.hermesTemplateNamespace = instance4.hermesTemplateNamespace;
+}
+function applyWhatsAppBusinessOptions(options, instance4) {
   if (instance4.metaAccessToken)
     options.metaAccessToken = instance4.metaAccessToken;
   if (instance4.metaPhoneNumberId)
@@ -377659,7 +377741,7 @@ async function initializeChannelPlugins(db3, eventBus) {
   }
   const flowsDemoInstance = process.env.META_FLOWS_DEMO_INSTANCE;
   if (flowsDemoInstance) {
-    const waCloud = result.registry.get("whatsapp-cloud");
+    const waCloud = result.registry.get("whatsapp-business");
     if (waCloud && "flowResolvers" in waCloud) {
       const { createDemoFlowResolver: createDemoFlowResolver2 } = await Promise.resolve().then(() => (init_src6(), exports_src4));
       waCloud.flowResolvers.registerInstanceDefault(flowsDemoInstance, createDemoFlowResolver2());