Prod findings (2026-09-22): a backend retry sweep failed 1,001 bookings in
60s; the agent called each a "coverage gap" because GEORADIUS found a miler
in the geo index (last seen in June), then sent 1,001 ops_alert tasks to
CUSTOMER_AGENT, which has no such handler.
- _find_zone filters GEORADIUS candidates by the backend's miler_status:<id>
key; only status=Available counts. Facts now carry
nearest_available_miler_within_km plus milers_in_geo_index_within_30km so
the decision can separate "no riders here" from "riders exist, none on duty".
- Rate limit per zone per day: after the first alert, further failures only
bump the counter (no LLM call); a summary re-alert goes out every
DISPATCH_REALERT_EVERY (default 100).
- _ops_alert / _escalate_dispatch send EXCEPTION_DETECTED to JARVIS (the path
that is actually handled); customer delay notice uses CUSTOMER_AGENT's real
send_notification contract.
- JARVIS: escalation inbox (_escalations, pending_escalations()) and
human_review/ops_alert task types are recorded instead of dropped.
- ExceptionAgent pull loops: also catch asyncio.TimeoutError (distinct from
nats.errors.TimeoutError on 3.11) and log the exception type — the blank
"pull loop error:" lines.
- Prompt + eval cases updated for the renamed facts; new case for the
observed index-full/nobody-on-duty pattern. Tests for liveness filtering,
burst suppression, fallback heuristic, sinks, and the JARVIS inbox.
Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_012AJLYcbTHCe45fyFnMfEin
New agent that owns the DoormileExpress dispatch flow. The normal B2C booking
flow is untouched; this handles express orders that a console operator has let
accumulate batch by batch, then dispatches in one go.
Triggered by express.dispatch_requested (the console's manual dispatch action).
For the tenant it: reads the pending bookings and the tenant's available riders
(Go internal API), distributes them across riders by proximity + load with a
radius guard, asks routes.workolik.com (Valhalla) for each rider's stop order,
and writes the assignments back through the Go internal API — which stays the
single writer of assignment state; the agent only decides who and what order.
- agents/express_dispatch_agent.py: the agent (mirrors DispatchAgent's NATS
binding; pure consumer of the backend-owned EXPRESS stream).
- config/system_config.py: ROUTE_OPTIMIZER_URL.
- registered under JARVIS in main.py / agents package.
- tests: distribution (radius, load, cap, no-GPS fallback) and sequencing
(single-stop, remap, optimizer-down, unknown-id) — deterministic, no network.
Gated off by default on the backend (EXPRESS_AGENT_ENABLED); EXPRESS_AGENT_
AUTONOMOUS=false runs it observe-only (logs the plan, writes nothing).
Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
