feat(awooop): add AI alert card delivery readback
This commit is contained in:
ogt
@@ -86,6 +86,9 @@ _ADR100_GATE5_PROJECTION_TRIGGER = "adr100_runtime_replay_gate5"
|
||||
_CALLBACK_REPLY_CACHE_TTL_SECONDS = int(
|
||||
os.getenv("AWOOOP_CALLBACK_REPLY_CACHE_TTL_SECONDS", "20")
|
||||
)
|
||||
_AI_ALERT_CARD_CACHE_TTL_SECONDS = int(
|
||||
os.getenv("AWOOOP_AI_ALERT_CARD_CACHE_TTL_SECONDS", "20")
|
||||
)
|
||||
_INCIDENT_ID_RE = re.compile(r"\bINC-\d{8}-[A-Z0-9]{4,}\b")
|
||||
_REMEDIATION_STATUS_FILTERS = {
|
||||
"mcp_observed",
|
||||
@@ -1271,6 +1274,247 @@ async def list_callback_replies(
|
||||
)
|
||||
|
||||
|
||||
async def list_ai_alert_card_delivery_readback(
|
||||
*,
|
||||
project_id: str | None = None,
|
||||
event_type: str | None = None,
|
||||
lane: str | None = None,
|
||||
page: int = 1,
|
||||
per_page: int = 20,
|
||||
refresh: bool = False,
|
||||
) -> dict[str, Any]:
|
||||
"""Read-only AwoooP delivery readback for AI automation alert cards."""
|
||||
normalized_project_id = project_id or "awoooi"
|
||||
normalized_event_type = str(event_type or "").strip()
|
||||
normalized_lane = str(lane or "").strip()
|
||||
normalized_page = max(int(page or 1), 1)
|
||||
normalized_per_page = min(max(int(per_page or 20), 1), _MAX_PER_PAGE)
|
||||
|
||||
cache_key = {
|
||||
"project_id": normalized_project_id,
|
||||
"event_type": normalized_event_type,
|
||||
"lane": normalized_lane,
|
||||
"page": normalized_page,
|
||||
"per_page": normalized_per_page,
|
||||
}
|
||||
if not refresh:
|
||||
cached_response = await get_cached_operator_summary_async(
|
||||
"ai_alert_card_delivery_readback",
|
||||
cache_key,
|
||||
ttl_seconds=_AI_ALERT_CARD_CACHE_TTL_SECONDS,
|
||||
)
|
||||
if cached_response is not None:
|
||||
logger.info(
|
||||
"operator_ai_alert_card_delivery_readback_cache_hit",
|
||||
project_id=normalized_project_id,
|
||||
event_type=normalized_event_type,
|
||||
lane=normalized_lane,
|
||||
page=normalized_page,
|
||||
per_page=normalized_per_page,
|
||||
ttl_seconds=_AI_ALERT_CARD_CACHE_TTL_SECONDS,
|
||||
)
|
||||
return cached_response
|
||||
|
||||
where_clauses = [
|
||||
"m.project_id = :project_id",
|
||||
"m.channel_type = 'telegram'",
|
||||
"m.source_envelope ? 'ai_automation_alert_card'",
|
||||
]
|
||||
params: dict[str, Any] = {
|
||||
"project_id": normalized_project_id,
|
||||
"limit": normalized_per_page,
|
||||
"offset": (normalized_page - 1) * normalized_per_page,
|
||||
}
|
||||
if normalized_event_type:
|
||||
where_clauses.append(
|
||||
"m.source_envelope #>> '{ai_automation_alert_card,event_type}' = :event_type"
|
||||
)
|
||||
params["event_type"] = normalized_event_type
|
||||
if normalized_lane:
|
||||
where_clauses.append(
|
||||
"m.source_envelope #>> '{ai_automation_alert_card,lane}' = :lane"
|
||||
)
|
||||
params["lane"] = normalized_lane
|
||||
|
||||
where_sql = " AND ".join(where_clauses)
|
||||
summary_sql = text(f"""
|
||||
SELECT
|
||||
COUNT(*) AS total,
|
||||
COUNT(*) FILTER (WHERE m.send_status = 'sent') AS sent_total,
|
||||
COUNT(*) FILTER (WHERE m.send_status = 'failed') AS failed_total,
|
||||
COUNT(*) FILTER (WHERE m.send_status = 'pending') AS pending_total,
|
||||
COUNT(*) FILTER (WHERE m.send_status = 'shadow') AS shadow_total,
|
||||
COUNT(*) FILTER (
|
||||
WHERE COALESCE(
|
||||
m.source_envelope #>>
|
||||
'{{ai_automation_alert_card,delivery_receipt_readback_required}}',
|
||||
''
|
||||
) = 'true'
|
||||
) AS delivery_receipt_required_total,
|
||||
COUNT(*) FILTER (
|
||||
WHERE COALESCE(
|
||||
m.source_envelope #>>
|
||||
'{{ai_automation_alert_card,runtime_write_gate_count}}',
|
||||
'0'
|
||||
) <> '0'
|
||||
) AS runtime_write_gate_open_count,
|
||||
MAX(m.sent_at) AS latest_sent_at,
|
||||
MAX(m.queued_at) AS latest_queued_at
|
||||
FROM awooop_outbound_message m
|
||||
WHERE {where_sql}
|
||||
""")
|
||||
list_sql = text(f"""
|
||||
SELECT
|
||||
m.message_id,
|
||||
m.project_id,
|
||||
m.run_id,
|
||||
m.channel_type,
|
||||
m.message_type,
|
||||
m.provider_message_id,
|
||||
m.send_status,
|
||||
m.send_error,
|
||||
m.queued_at,
|
||||
m.sent_at,
|
||||
m.triggered_by_state,
|
||||
m.source_envelope -> 'ai_automation_alert_card' AS alert_card,
|
||||
m.source_envelope -> 'source_refs' AS source_refs,
|
||||
r.agent_id,
|
||||
r.state AS run_state,
|
||||
r.created_at AS run_created_at
|
||||
FROM awooop_outbound_message m
|
||||
LEFT JOIN awooop_run_state r
|
||||
ON r.project_id = m.project_id
|
||||
AND r.run_id = m.run_id
|
||||
WHERE {where_sql}
|
||||
ORDER BY COALESCE(m.sent_at, m.queued_at) DESC, m.message_id DESC
|
||||
LIMIT :limit OFFSET :offset
|
||||
""")
|
||||
|
||||
async with get_db_context(normalized_project_id) as db:
|
||||
summary_result = await db.execute(summary_sql, params)
|
||||
summary_row = summary_result.mappings().first() or {}
|
||||
rows_result = await db.execute(list_sql, params)
|
||||
rows = list(rows_result.mappings().all())
|
||||
|
||||
summary = _ai_alert_card_delivery_summary_from_row(
|
||||
summary_row,
|
||||
project_id=normalized_project_id,
|
||||
event_type=normalized_event_type or None,
|
||||
lane=normalized_lane or None,
|
||||
)
|
||||
response = {
|
||||
"items": [_ai_alert_card_delivery_item(row) for row in rows],
|
||||
"total": summary["total"],
|
||||
"page": normalized_page,
|
||||
"per_page": normalized_per_page,
|
||||
"summary": summary,
|
||||
}
|
||||
logger.info(
|
||||
"operator_ai_alert_card_delivery_readback_fetched",
|
||||
project_id=normalized_project_id,
|
||||
event_type=normalized_event_type,
|
||||
lane=normalized_lane,
|
||||
page=normalized_page,
|
||||
per_page=normalized_per_page,
|
||||
total=summary["total"],
|
||||
cache_status="miss",
|
||||
cache_ttl_seconds=_AI_ALERT_CARD_CACHE_TTL_SECONDS,
|
||||
)
|
||||
return await store_operator_summary_async(
|
||||
"ai_alert_card_delivery_readback",
|
||||
cache_key,
|
||||
response,
|
||||
ttl_seconds=_AI_ALERT_CARD_CACHE_TTL_SECONDS,
|
||||
)
|
||||
|
||||
|
||||
def _ai_alert_card_delivery_summary_from_row(
|
||||
row: Mapping[str, Any],
|
||||
*,
|
||||
project_id: str,
|
||||
event_type: str | None,
|
||||
lane: str | None,
|
||||
) -> dict[str, Any]:
|
||||
"""Normalize AI alert card delivery summary counts."""
|
||||
total = _safe_int(row.get("total"))
|
||||
sent_total = _safe_int(row.get("sent_total"))
|
||||
failed_total = _safe_int(row.get("failed_total"))
|
||||
pending_total = _safe_int(row.get("pending_total"))
|
||||
shadow_total = _safe_int(row.get("shadow_total"))
|
||||
runtime_write_gate_open_count = _safe_int(
|
||||
row.get("runtime_write_gate_open_count")
|
||||
)
|
||||
status_value = "no_delivery_receipt" if total == 0 else "observed"
|
||||
if failed_total > 0:
|
||||
status_value = "delivery_failure_observed"
|
||||
elif pending_total > 0:
|
||||
status_value = "delivery_pending_observed"
|
||||
|
||||
return {
|
||||
"schema_version": "awooop_ai_alert_card_delivery_readback_v1",
|
||||
"project_id": project_id,
|
||||
"event_type": event_type,
|
||||
"lane": lane,
|
||||
"status": status_value,
|
||||
"total": total,
|
||||
"sent_total": sent_total,
|
||||
"failed_total": failed_total,
|
||||
"pending_total": pending_total,
|
||||
"shadow_total": shadow_total,
|
||||
"delivery_receipt_required_total": _safe_int(
|
||||
row.get("delivery_receipt_required_total")
|
||||
),
|
||||
"runtime_write_gate_open_count": runtime_write_gate_open_count,
|
||||
"runtime_write_allowed": runtime_write_gate_open_count > 0,
|
||||
"latest_sent_at": row.get("latest_sent_at"),
|
||||
"latest_queued_at": row.get("latest_queued_at"),
|
||||
"production_write_count": 0,
|
||||
}
|
||||
|
||||
|
||||
def _ai_alert_card_delivery_item(row: Mapping[str, Any]) -> dict[str, Any]:
|
||||
"""Convert one AI alert-card outbound mirror row into delivery evidence."""
|
||||
alert_card = _as_dict(row.get("alert_card"))
|
||||
source_refs = _as_dict(row.get("source_refs"))
|
||||
run_id = row.get("run_id")
|
||||
project_id = str(row.get("project_id") or "")
|
||||
runtime_write_gate_count = _safe_int(
|
||||
alert_card.get("runtime_write_gate_count")
|
||||
)
|
||||
event_at = row.get("sent_at") or row.get("queued_at")
|
||||
return {
|
||||
"message_id": row.get("message_id"),
|
||||
"run_id": run_id,
|
||||
"project_id": project_id,
|
||||
"event_at": event_at,
|
||||
"channel_type": row.get("channel_type"),
|
||||
"message_type": row.get("message_type"),
|
||||
"send_status": row.get("send_status"),
|
||||
"send_error": row.get("send_error"),
|
||||
"provider_message_id": row.get("provider_message_id"),
|
||||
"triggered_by_state": row.get("triggered_by_state"),
|
||||
"event_type": str(alert_card.get("event_type") or ""),
|
||||
"lane": str(alert_card.get("lane") or ""),
|
||||
"target": str(alert_card.get("target") or ""),
|
||||
"gates": alert_card.get("gates") if isinstance(alert_card.get("gates"), list) else [],
|
||||
"runtime_write_gate_count": runtime_write_gate_count,
|
||||
"runtime_write_allowed": runtime_write_gate_count > 0,
|
||||
"candidate_only": bool(alert_card.get("candidate_only")),
|
||||
"delivery_receipt_readback_required": bool(
|
||||
alert_card.get("delivery_receipt_readback_required")
|
||||
),
|
||||
"source_refs": source_refs,
|
||||
"run_state": row.get("run_state"),
|
||||
"agent_id": row.get("agent_id"),
|
||||
"run_created_at": row.get("run_created_at"),
|
||||
"run_detail_href": (
|
||||
f"/awooop/runs/{run_id}?project_id={project_id}"
|
||||
if run_id and project_id
|
||||
else None
|
||||
),
|
||||
}
|
||||
|
||||
|
||||
async def _fetch_callback_reply_audit_summary(
|
||||
db: Any,
|
||||
*,
|
||||
|
||||
Reference in New Issue
Block a user