Architecture & Hackathon Criteria

How ExceptionOS satisfies the All Things Agentic Hackathon requirements — with honest capability status

User → Next.js (exceptionos-web)
         ↓
     FastAPI (exceptionos-api)
         ↓
     In-Process LocalEventBus  ← hosted demo (event_bus=local)
         ↓
     Exception Orchestrator (deterministic state machine)
    ┌────┴────┬────────────┬──────────────┐
    ↓         ↓            ↓              ↓
ADK Inv.  ADK Res.   Authority      Verification
    ↓         ↓       (deterministic)      ↓
  Tools    Gemini                         Connectors
    ↓                                    ↓
 Firestore ← Evidence Ledger ← Cloud Logging

--- dashed / future ---
Pub/Sub push → /api/events/pubsub
Agent Registry · Memory Bank · Model Armor · Agent Gateway · Agent Identity
Reasoning
Google ADK + Gemini (Vertex AI when live)
State
Firestore + deterministic workflow state machine
Execution
Mock ERP/Inventory/Supplier/Production connectors
Governance
Deterministic authority engine + human approval queue
Evidence
Firestore evidence ledger + SSE stream
Async
In-process LocalEventBus (Pub/Sub ingest optional)

Innovation & Operational Utility

  • ✓Autonomously resolves costly supplier disruption threatening Production Line 3
  • ✓Multi-agent orchestration: Investigator → Resolution → Authority → Execution → Verification
  • ✓Deterministic demo: $87K downtime avoided for $1,240 resolution cost

Architectural Discipline

  • ✓Explicit workflow state machine — LLM cannot invent states
  • ✓Structured Pydantic resolution plans — never trust raw model text for execution
  • ✓Deterministic authority engine — APPROVAL_REQUIRED at $1,000 limit
  • ✓Idempotent tool execution with correlation keys
  • ✓Persistent state in Firestore / in-memory adapter
  • ✓In-process LocalEventBus for hosted demo reliability (event_bus=local on /health)
  • ✓Optional Google Pub/Sub push ingest via POST /api/events/pubsub
  • ✓Supplier API failure retry with exponential backoff

Production Readiness

  • ✓Cloud Run deployment (exceptionos-api, exceptionos-web)
  • ✓Firestore persistence; in-process event bus for demo reliability
  • ✓Structured JSON logging → Google Cloud Logging
  • ✓Health endpoints, reproducible README, pytest E2E suite (25 tests)
  • ✓SSE live agent activity stream
  • ✓Local regex security screener for prompt injection (not Model Armor)

Google Capability Status

Implemented
Google ADKGemini / Vertex AICloud RunFirestoreCloud LoggingArtifact RegistryCloud BuildLocalEventBus
Integrated (partial / local)
Pub/Sub (topics + push ingest)Secret Manager (optional)Agent metadata API (/api/agents)Local security screenerLocal resolution memory
Architecture-ready / Future
Google Agent RegistryAgent Platform RuntimeMemory BankModel ArmorAgent GatewayAgent Identity

Full evidence table: see README.md on GitHub. Verify live status via GET /health on the API.