First commit

apps/channel_gateway/app/adapters/base.py

@@ -0,0 +1,9 @@
+from __future__ import annotations
+
+from typing import Protocol
+from app.schemas import GatewayRequest
+
+
+class ChannelAdapter(Protocol):
+    name: str
+    async def to_gateway_request(self, payload) -> GatewayRequest: ...

apps/channel_gateway/app/adapters/voice.py

@@ -0,0 +1,45 @@
+from __future__ import annotations
+
+from app.schemas import BusinessContext, GatewayRequest, VoiceTranscript
+from app.settings import settings
+
+
+class VoiceAdapter:
+    name = 'voice'
+
+    async def to_gateway_request(self, payload: VoiceTranscript) -> GatewayRequest:
+        session_id = payload.session_id or payload.call_id
+        message_id = payload.message_id or (f'{payload.call_id}-turn-1' if payload.call_id else None)
+        bc = BusinessContext(
+            customer_key=payload.customer_key or payload.caller,
+            contract_key=payload.contract_key,
+            interaction_key=payload.interaction_key or payload.call_id,
+            session_key=session_id,
+            metadata={
+                'source_channel': 'voice',
+                'confidence': payload.confidence,
+                'language': payload.language,
+                **(payload.metadata or {}),
+            },
+        )
+        data = {
+            'message': payload.transcript,
+            'session_id': session_id,
+            'user_id': payload.caller,
+            'message_id': message_id,
+            'customer_key': bc.customer_key,
+            'contract_key': bc.contract_key,
+            'interaction_key': bc.interaction_key,
+            'session_key': bc.session_key,
+            'business_context': bc.model_dump(exclude_none=True),
+            'metadata': {
+                **(payload.metadata or {}),
+                'external_gateway': settings.APP_NAME,
+                'source_channel': 'voice',
+                'call_id': payload.call_id,
+                'confidence': payload.confidence,
+                'language': payload.language,
+                'contract_version': 'gateway-request-v1',
+            },
+        }
+        return GatewayRequest(channel='voice', tenant_id=settings.DEFAULT_TENANT_ID, agent_id=settings.DEFAULT_AGENT_ID, payload=data)

apps/channel_gateway/app/adapters/web.py

@@ -0,0 +1,35 @@
+from __future__ import annotations
+
+from app.schemas import BusinessContext, GatewayRequest, WebMessage
+from app.settings import settings
+
+
+class WebAdapter:
+    name = 'web'
+
+    async def to_gateway_request(self, payload: WebMessage) -> GatewayRequest:
+        bc = payload.business_context or BusinessContext(
+            customer_key=payload.customer_key,
+            contract_key=payload.contract_key,
+            interaction_key=payload.interaction_key,
+            account_key=payload.account_key,
+            resource_key=payload.resource_key,
+            session_key=payload.session_key or payload.session_id,
+            metadata={'source_channel': 'web', **(payload.metadata or {})},
+        )
+        data = payload.model_dump(exclude_none=True)
+        data['business_context'] = bc.model_dump(exclude_none=True)
+        data.setdefault('session_key', payload.session_key or payload.session_id)
+        data.setdefault('metadata', {})
+        data['metadata'] = {
+            **(data.get('metadata') or {}),
+            'external_gateway': settings.APP_NAME,
+            'source_channel': 'web',
+            'contract_version': 'gateway-request-v1',
+        }
+        return GatewayRequest(
+            channel='web',
+            tenant_id=settings.DEFAULT_TENANT_ID,
+            agent_id=settings.DEFAULT_AGENT_ID,
+            payload=data,
+        )

apps/channel_gateway/app/adapters/whatsapp.py

@@ -0,0 +1,42 @@
+from __future__ import annotations
+
+from app.schemas import BusinessContext, GatewayRequest, WhatsAppWebhook
+from app.settings import settings
+
+
+class WhatsAppAdapter:
+    name = 'whatsapp'
+
+    async def to_gateway_request(self, payload: WhatsAppWebhook) -> GatewayRequest:
+        user_id = payload.wa_id or payload.from_
+        text = payload.message or payload.text or payload.interactive_title or payload.interactive_id
+        if not text:
+            raise ValueError('INVALID_WHATSAPP_PAYLOAD: message/text/interactive_title is required')
+        session_id = payload.session_id or user_id
+        message_id = payload.message_id or payload.interaction_key
+        bc = BusinessContext(
+            customer_key=payload.customer_key or user_id,
+            contract_key=payload.contract_key,
+            interaction_key=payload.interaction_key or message_id,
+            session_key=session_id,
+            metadata={'source_channel': 'whatsapp', **(payload.metadata or {})},
+        )
+        data = {
+            'message': text,
+            'session_id': session_id,
+            'user_id': user_id,
+            'message_id': message_id,
+            'customer_key': bc.customer_key,
+            'contract_key': bc.contract_key,
+            'interaction_key': bc.interaction_key,
+            'session_key': bc.session_key,
+            'business_context': bc.model_dump(exclude_none=True),
+            'metadata': {
+                **(payload.metadata or {}),
+                'external_gateway': settings.APP_NAME,
+                'source_channel': 'whatsapp',
+                'interactive_id': payload.interactive_id,
+                'contract_version': 'gateway-request-v1',
+            },
+        }
+        return GatewayRequest(channel='whatsapp', tenant_id=settings.DEFAULT_TENANT_ID, agent_id=settings.DEFAULT_AGENT_ID, payload=data)