loopable / api /assistant_feed.py
fsanyoto's picture
Deploy AIOS web (React glide grid + FastAPI slice)
82f0f29 verified
Raw History Blame Contribute Delete
7.94 kB
"""C5 notifications enter the recipient's durable Assistant conversation."""
import copy
import logging
import re
import threading
from urllib.parse import urlencode
import ai_enrich
import assistant_log
import ping_doors
from core import account_rows, alerts
CUTOVER_KEY = "assistant_notice_cutover"
INBOX_KEYS = ("type", "request_id", "sender", "target", "text", "actions", "state")
_LOCK = threading.RLock()
_LOG = logging.getLogger(__name__)
def _target(item):
if isinstance(item.get("target"), dict):
return copy.deepcopy(item["target"])
topic, key = str(item.get("topic") or ""), str(item.get("alertId") or "")
if topic == "inbox":
return None # A C6 target arrives as a dict above. A question may have none.
view = str(item.get("viewId") or "")
if topic == "automation" and key:
return {"module": "automation", "id": key, "tab": "runs"}
if topic == "share" and key:
if key not in {"customer_data", "product_data"} and not re.fullmatch(r"ut_[A-Za-z0-9_]+", key):
return None
view = str(item.get("rowId") or "")
return {"module": "database", "id": key, **({"tab": view} if view else {})}
database = {"customer": "customer_data", "product": "product_data"}.get(topic)
if topic.startswith("ut_"):
database = topic
return {"module": "database", "id": database,
**({"tab": view} if view else {})} if database else None
def _link(target):
if not target:
return ""
module, ident = target.get("module"), target.get("id")
if module == "database":
params = {"database": ident}
if target.get("tab"):
params["view"] = target["tab"]
return "#/data?" + urlencode(params)
if module == "automation":
params = {"agent": ident}
if target.get("tab"):
params["tab"] = target["tab"]
return "#/automation?" + urlencode(params)
if isinstance(module, str) and module.startswith("ut_"):
return "#/data?" + urlencode({"database": module, "record": ident})
return ""
def _inbox_link(target):
"""The deep link of a C6 target `{kind, key, label}`, or "" when it has no address."""
if not isinstance(target, dict):
return ""
kind, key = target.get("kind"), str(target.get("key") or "")
pair = re.split(r"[/:]", key, maxsplit=1)
if not key:
return ""
if kind == "database":
return "#/data?" + urlencode({"database": key})
if kind == "view":
if len(pair) == 2 and all(pair):
return "#/data?" + urlencode({"database": pair[0], "view": pair[1]})
return "#/data?" + urlencode({"view": key})
if kind == "sheet":
return "#/sheet?" + urlencode({"wb": key})
if kind == "app" and len(pair) == 2 and all(pair):
# An app opens inside its database: `#/app?database=<db>&application=<id>`.
return "#/app?" + urlencode({"database": pair[0], "application": pair[1]})
return ""
def _inbox_payload(inbox, subject, body):
"""Exactly the C6 keys, plus title, body, link and source for the external door."""
payload = {key: copy.deepcopy(inbox.get(key)) for key in INBOX_KEYS}
sender = payload.get("sender")
if isinstance(sender, dict):
sender["name"] = ai_enrich.no_dashes(" ".join(str(sender.get("name") or "").split()))
payload.update(title=subject, body=body, link=_inbox_link(payload.get("target")),
source="inbox")
return payload
def _inside_window(rt, username):
"""True when the recipient has a WhatsApp phone inside the 24-hour window."""
try:
import telnyx_whatsapp
from core import users
record = dict(users._tenant_accounts(assistant_log._tenant_of(rt))).get(username)
whatsapp = record.get("whatsapp") if isinstance(record, dict) else None
phone = whatsapp.get("phone") if isinstance(whatsapp, dict) else None
return bool(phone) and bool(telnyx_whatsapp.within_window(phone))
except Exception as exc: # noqa: BLE001
_LOG.warning("WhatsApp window was not read: %s", type(exc).__name__)
return False
def _internal_only(rt, item):
"""Bulk alerts and retired Once outcomes have only internal destinations."""
if item.get("kind") == "alert":
return True
if item.get("topic") == "automation" and not item.get("rowId") and item.get("alertId"):
import automation_engine
row = (rt.get(automation_engine.STORE_KEY) or {}).get(str(item["alertId"])) or {}
status = row.get("status") or {}
completion = f"{status.get('state')}: {status.get('lastSummary') or ''}"[:300]
return bool(row.get("retiredOnceAt")) and item.get("label") == completion
return False
def post(rt, username, item):
"""Append one notice, perform cutover once, and fan out eligible deliveries."""
if item.get("topic") == "ticket":
return None # Ticket pings already enter through ping_doors.deliver_new.
# Validate the tenant and recipient before cutover changes their store.
assistant_log._hash(rt, username)
subject = ai_enrich.no_dashes(item.get("alertLabel") or item.get("label") or "Notice")
body = ai_enrich.no_dashes(item.get("label") or "")
source = str(item.get("topic") or "alert")
fallback = {"automation": "Automation", "share": "A teammate"}.get(source, "Alerts")
sender = ai_enrich.no_dashes(item.get("actor") or fallback)
target = _target(item)
inbox = item.get("inbox") if isinstance(item.get("inbox"), dict) else None
if inbox is not None:
payload = _inbox_payload(inbox, subject, body)
else:
payload = {"title": subject, "subject": subject, "body": body, "sender": sender,
"target": target, "link": _link(target), "source": source,
"notificationId": item.get("id"), "alertId": item.get("alertId"),
"viewId": item.get("viewId"), "rowId": item.get("rowId")}
if item.get("kind") == "alert":
payload.update(kind="alert", count=item.get("count"), label=body)
turn = {"role": "system", "door": "wake", "kind": "notice", "text": body,
"payload": payload, "at": item.get("at") or alerts._now_iso()}
with _LOCK:
row_mode = bool(account_rows.records_backend(rt))
cutover_key = CUTOVER_KEY + ':' + str(username).encode('utf-8').hex() if row_mode else CUTOVER_KEY
if not (rt.get(cutover_key) or {}).get("purged"):
if not row_mode:
def purge(data):
return {}
rt.update(alerts.NOTIFICATIONS_KEY, purge, flush="sync")
rt.update(cutover_key, lambda _data: {"version": 2 if row_mode else 1, "purged": True}, flush="sync")
turn_id = assistant_log.append(rt, username, turn)
turn["id"] = turn_id
if _internal_only(rt, item):
return turn_id
if getattr(rt, "preview_only", False):
rt.deferred_notices.append({"username": username, "turn": copy.deepcopy(turn),
"inside_window_only": inbox is not None})
return turn_id
deliver_external(rt, username, turn, inside_window_only=inbox is not None)
return turn_id
def deliver_external(rt, username, turn, *, inside_window_only=False):
"""Deliver an already committed notice, including a notice held by an Assistant preview."""
external = getattr(ping_doors, "notify_external", None)
if inside_window_only and not _inside_window(rt, username):
# R108(l): an agent message reaches WhatsApp only inside the window, never as a template.
external = None
if callable(external):
try:
external(rt, username, copy.deepcopy(turn))
except Exception as exc:
_LOG.warning("External notice was not delivered: %s", type(exc).__name__)
alerts.set_sink(post)