File size: 14,895 Bytes
102dd4f 87c0663 6ab175e 102dd4f dc8cb49 cf6d08c 102dd4f fcf2812 102dd4f 87c0663 102dd4f d4f6fe7 102dd4f 0467de1 1cd53ba 102dd4f dc8cb49 0467de1 102dd4f 0467de1 102dd4f 0467de1 102dd4f aa966e0 0467de1 d5e3877 cf6d08c d5e3877 edb038d d5e3877 1cd53ba d5e3877 1cd53ba d5e3877 edb038d d5e3877 fcf2812 aa966e0 cf6d08c aa966e0 c925062 aa966e0 102dd4f 1b62af7 dc8cb49 102dd4f a54f188 102dd4f dc8cb49 aa966e0 102dd4f dc8cb49 102dd4f d4f6fe7 102dd4f 0467de1 102dd4f cf6d08c 102dd4f d4f6fe7 102dd4f 0467de1 102dd4f b10f5a0 102dd4f b10f5a0 102dd4f b10f5a0 102dd4f b10f5a0 102dd4f | 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 99 100 101 102 103 104 105 106 107 108 109 110 111 112 113 114 115 116 117 118 119 120 121 122 123 124 125 126 127 128 129 130 131 132 133 134 135 136 137 138 139 140 141 142 143 144 145 146 147 148 149 150 151 152 153 154 155 156 157 158 159 160 161 162 163 164 165 166 167 168 169 170 171 172 173 174 175 176 177 178 179 180 181 182 183 184 185 186 187 188 189 190 191 192 193 194 195 196 197 198 199 200 201 202 203 204 205 206 207 208 209 210 211 212 213 214 215 216 217 218 219 220 221 222 223 224 225 226 227 228 229 230 231 232 233 234 235 236 237 238 239 240 241 242 243 244 245 246 247 248 249 250 251 252 253 254 255 256 257 258 259 260 261 262 263 264 265 266 267 268 269 270 271 272 273 274 275 276 277 278 279 280 281 282 283 284 285 286 287 288 289 290 291 292 293 294 295 296 297 298 299 300 301 302 303 304 305 306 307 308 309 310 311 312 313 314 315 316 317 318 319 320 321 322 323 324 325 326 327 328 329 330 331 332 333 334 335 336 337 338 339 340 | import logging
from pathlib import Path
from typing import Any
from app.ai.orchestrator import AIOrchestrator
from app.ai.router import LiteLLMOrchestration
from app.ai.tool_schemas import _TOOLS_BY_MODE, get_tool_schemas
from app.config import Settings
from app.database.supabase import SupabaseRepository
from app.models.domain import UserMode, WhatsAppInboundMessage
from app.services.embedding_service import JinaEmbeddingService
from app.services.trip_indexing import unindex_trip
from app.tools.handlers import FalzhToolHandlers, _trip_summary
from app.tools.registry import ToolRegistry
from app.utils.time import now_in_timezone
from app.whatsapp.client import WhatsAppClient
logger = logging.getLogger(__name__)
_PROMPT_PATHS: dict[UserMode, Path] = {
"new_user": Path("prompts/system_new_user.md"),
"driver": Path("prompts/system_driver.md"),
"passenger": Path("prompts/system_passenger.md"),
}
class ConversationService:
def __init__(
self,
*,
repository: SupabaseRepository,
embeddings: JinaEmbeddingService,
whatsapp: WhatsAppClient,
ai: AIOrchestrator | LiteLLMOrchestration,
settings: Settings,
system_prompt_path: Path | None = None,
) -> None:
self.repository = repository
self.embeddings = embeddings
self.whatsapp = whatsapp
self.ai = ai
self.settings = settings
self.system_prompt_path = system_prompt_path
async def handle_inbound_message(self, inbound: WhatsAppInboundMessage) -> str | None:
if await self.repository.message_exists(inbound.message_id):
logger.info("Skipping duplicate WhatsApp message %s", inbound.message_id)
return None
customer = await self.repository.upsert_customer(
remote_jid=inbound.remoteJid,
name=inbound.profile_name,
phone_number=inbound.phone_number,
registered=True,
)
metadata: dict[str, Any] = {
"whatsapp": inbound.raw,
"timestamp": inbound.timestamp,
}
if inbound.context_message_id:
metadata["context_message_id"] = inbound.context_message_id
current_message = await self.repository.create_message(
customer_id=str(customer["id"]),
sender_type="customer",
message=inbound.text,
whatsapp_message_id=inbound.message_id,
metadata=metadata,
)
context = await self.repository.get_recent_context_messages(
customer_id=str(customer["id"]),
current_message_id=str(current_message["id"]),
limit=8,
)
user_mode = _resolve_user_mode(customer)
is_returning_driver = False
if user_mode == "new_user" and customer.get("phone_number"):
existing_driver = await self.repository.get_driver_by_phone_number(
customer["phone_number"],
)
if existing_driver:
is_returning_driver = True
user_mode = "driver"
registry = self._tool_registry(
customer,
remoteJid=inbound.remoteJid,
user_mode=user_mode,
current_message=current_message,
)
if user_mode == "passenger" and inbound.context_message_id:
original = await self.repository.get_message_by_whatsapp_id(inbound.context_message_id)
if original:
orig_meta = original.get("metadata") or {}
if orig_meta.get("type") == "trip_card":
trip_id = orig_meta.get("trip_id")
if trip_id:
handlers = FalzhToolHandlers(
repository=self.repository,
embeddings=self.embeddings,
whatsapp=self.whatsapp,
customer=customer,
remoteJid=inbound.remoteJid,
embedding_model=self.settings.jina_embedding_model,
current_message=current_message,
)
result = await handlers.select_trip(
{"trip_id": trip_id, "requested_seats": 1}
)
if result.ok:
driver_phone = result.data.get("driver_phone")
reply = (
f"يمكنك التواصل مع السائق على الرقم: {driver_phone}"
if driver_phone
else "يمكنك التواصل مع السائق"
)
else:
reply = f"عذراً، لم يتم إرسال الطلب: {result.error}"
await self.whatsapp.send_text(inbound.remoteJid, reply)
await self.repository.create_message(
customer_id=str(customer["id"]),
sender_type="assistant",
message=reply,
metadata={
"provider_flow": "trip_card_reply",
"user_mode": user_mode,
},
)
return reply
if user_mode == "driver" and inbound.context_message_id:
original = await self.repository.get_message_by_whatsapp_id(inbound.context_message_id)
if original:
orig_meta = original.get("metadata") or {}
if orig_meta.get("type") == "driver_trip_card":
trip_id = orig_meta.get("trip_id")
action = orig_meta.get("action")
if trip_id and action:
driver = await self.repository.get_driver_by_remoteJid(inbound.remoteJid)
trip = await self.repository.get_trip_by_id(trip_id)
if driver and trip and str(trip.get("driver_id")) == str(driver["id"]):
if action == "DELETE":
await self.repository.cancel_driver_trip(trip_id)
await unindex_trip(repository=self.repository, trip_id=trip_id)
reply = "تم حذف الرحلة بنجاح"
await self._store_and_send_assistant_reply(
customer,
inbound.remoteJid,
reply,
user_mode="driver",
)
return reply
if action == "MODIFY":
await self.repository.set_customer_session_field(
customer_id=str(customer["id"]),
key="active_edit_trip_id",
value=trip_id,
)
summary = _trip_summary(trip)
route = f"{summary.get('departure')} -> {summary.get('destination')}"
time_label = summary.get("departure_time") or summary.get("departure_time_type")
system_note = (
f"SYSTEM: Driver selected trip {trip_id} ({route}, {time_label}) to modify. "
"Ask them what details they want to change. if there are no details sent"
)
registry = self._tool_registry(
customer,
remoteJid=inbound.remoteJid,
user_mode="driver",
current_message=current_message,
)
context = await self.repository.get_recent_context_messages(
customer_id=str(customer["id"]),
current_message_id=str(current_message["id"]),
limit=8,
)
messages = self._ai_messages(context, user_mode="driver")
messages.append({"role": "system", "content": system_note})
reply = await self.ai.generate_reply(
messages=messages,
tools=get_tool_schemas("driver"),
registry=registry,
)
if reply:
await self._store_and_send_assistant_reply(
customer,
inbound.remoteJid,
reply,
user_mode="driver",
)
return reply
if is_returning_driver:
driver_name = customer.get("name") or ""
system_note = (
f"SYSTEM: This is the first message from driver \"{driver_name}\". "
"They were previously tracked from WhatsApp group trip posts. "
"Welcome them warmly by name. Tell them we have been following their trips "
"in the groups and we are impressed. Explain that we have registered them in "
"FALZH so they can now send trips directly here instead of posting in groups. "
"Show them how: just send the trip details (route, date, time) in chat. "
"Tell them they may write each trip ad in their own preferred style/format, "
"and FALZH will extract the trip details automatically. Tell them personal "
"data such as phone numbers will be removed from public trip ads/cards and "
"shared only after a passenger selects the trip and wants to contact them. "
"Explain the benefits: passengers find their trips via AI search, they get "
"notified immediately when a passenger selects their trip, and registered "
"drivers get priority visibility in search results. Tell them we will no "
"longer add their trips from groups — they are in full control now. "
"Keep it warm, personal, and exciting. Use emojis. Write in Arabic. "
"8-10 lines max. Do NOT call any tools."
)
messages = self._ai_messages(context, user_mode=user_mode)
messages.append({"role": "system", "content": system_note})
reply = await self.ai.generate_reply(
messages=messages,
tools=get_tool_schemas(user_mode),
registry=registry,
)
else:
reply = await self.ai.generate_reply(
messages=self._ai_messages(context, user_mode=user_mode),
tools=get_tool_schemas(user_mode),
registry=registry,
)
if not reply:
return reply
await self.whatsapp.send_text(inbound.remoteJid, reply)
await self.repository.create_message(
customer_id=str(customer["id"]),
sender_type="assistant",
message=reply,
metadata={"provider_flow": "groq_primary_openrouter_fallback", "user_mode": user_mode},
)
if is_returning_driver:
await self.repository.update_customer_user_mode(
customer_id=str(customer["id"]),
user_mode="driver",
)
return reply
async def _store_and_send_assistant_reply(
self,
customer: dict[str, Any],
remoteJid: str,
reply: str,
*,
user_mode: UserMode,
) -> None:
await self.repository.create_message(
customer_id=str(customer["id"]),
sender_type="assistant",
message=reply,
metadata={"provider_flow": "trip_interactive_reply", "user_mode": user_mode},
)
await self.whatsapp.send_text(remoteJid, reply)
def _tool_registry(
self,
customer: dict[str, Any],
*,
remoteJid: str,
user_mode: UserMode,
current_message: dict[str, Any] | None = None,
) -> ToolRegistry:
handlers = FalzhToolHandlers(
repository=self.repository,
embeddings=self.embeddings,
whatsapp=self.whatsapp,
customer=customer,
remoteJid=remoteJid,
embedding_model=self.settings.jina_embedding_model,
current_message=current_message,
)
registry = ToolRegistry()
for tool_name in _TOOLS_BY_MODE[user_mode]:
registry.register(tool_name, getattr(handlers, tool_name))
return registry
def _ai_messages(
self,
context: list[dict[str, Any]],
*,
user_mode: UserMode,
) -> list[dict[str, Any]]:
messages = [
{
"role": "system",
"content": self._system_prompt(user_mode),
}
]
for row in context:
role = _sender_to_ai_role(row.get("sender_type"))
messages.append({"role": role, "content": row.get("message") or ""})
return messages
def _system_prompt(self, user_mode: UserMode) -> str:
base_template = Path("prompts/system.md").read_text(encoding="utf-8")
if self.system_prompt_path is not None:
mode_template = self.system_prompt_path.read_text(encoding="utf-8")
else:
mode_template = _PROMPT_PATHS[user_mode].read_text(encoding="utf-8")
template = base_template + "\n\n" + mode_template
dt = now_in_timezone(self.settings.app_timezone)
current_datetime = dt.isoformat()
day_name = dt.strftime("%A")
return template.format(
current_datetime=current_datetime,
day_name=day_name,
timezone=self.settings.app_timezone,
)
def _resolve_user_mode(customer: dict[str, Any]) -> UserMode:
mode = customer.get("user_mode")
if mode == "driver":
return "driver"
if mode == "passenger":
return "passenger"
return "new_user"
def _sender_to_ai_role(sender_type: str | None) -> str:
if sender_type == "assistant":
return "assistant"
if sender_type == "customer":
return "user"
return "system"
|