How alihon20807-debug/forgeai-hackathon works
ClaimGuard is a voice-first FNOL agent: a caller’s speech is transcribed and redacted, the agent proposes claim and dispatch actions, deterministic safeguards govern consequential actions and responses, and verified state and traces support live supervision. The README documents the supervisor console and PRISM diagnostics; sampled source confirms key service, redaction, tool, enforcement, retrieval, storage, and tracing relationships. Some UI wiring and unsampled subsystem details are documented but not verified in source excerpts.
Main entry points: server.py FastAPI Service · runner.py Agent Runner · database.py SQLite Records · tools.py Agent Tools
Components 21
Caller & Console
- Live Console
frontend/app.js - Phone UI
frontend/phone.js
Conversation Processing
- FastAPI Service
app/server.py - Development Server
app/dev_server.py - Voice Transcriber
app/voice/transcriber.py - Agent Runner
app/agent/runner.py - Agent Prompts
app/agent/prompts.py - Agent Tools
app/agent/tools.py - Runtime Config
app/config.py
Deterministic Safeguards
- PII Shield
app/security/pii_shield.py - Commit Window
app/enforcement/commit_window.py - Outbound Veto
app/enforcement/outbound_veto.py - Policy Latch
app/db/schema.sql
Records & Policy
- SQLite Records
app/db/database.py - Policy Retriever
app/rag/retriever.py - Policy Corpus
app/rag/corpus.py
Observability
- PRISM Tracer
app/observability/prism_tracer.py
Other components
- Caller
- Supervisor
- LLM Service
- PRISM Service
Connections 28
- Caller → Phone UI: speaks to
README.md - Phone UI → FastAPI Service: sends turns
- FastAPI Service → Voice Transcriber: routes audio
app/server.py - Voice Transcriber → PII Shield: redacts with
app/voice/transcriber.py - FastAPI Service → PII Shield: redacts with
app/server.py - FastAPI Service → Agent Runner: processes turns
app/server.py - Agent Runner → Agent Prompts: uses prompts
app/agent/runner.py - Agent Runner → LLM Service: requests generation
- Agent Runner → Agent Tools: dispatches tools
app/agent/runner.py - Agent Tools → SQLite Records: reads and writes
app/agent/tools.py - Agent Tools → Commit Window: stages actions
app/agent/tools.py - Agent Tools → Policy Retriever: searches policies
app/agent/tools.py - Policy Retriever → Policy Corpus: searches chunks
app/rag/retriever.py - Agent Runner → Commit Window: uses window
app/agent/runner.py - Agent Runner → Outbound Veto: filters response
app/agent/runner.py - Commit Window → SQLite Records: persists transitions
app/enforcement/commit_window.py - SQLite Records → Policy Latch: enforces triggers
- FastAPI Service → SQLite Records: looks up policy
app/server.py - FastAPI Service → Commit Window: clears session
app/server.py - FastAPI Service → PRISM Tracer: traces turns
app/server.py - PRISM Tracer → PRISM Service: ingests spans
app/observability/prism_tracer.py - FastAPI Service → Live Console: broadcasts updates
- Supervisor → Live Console: monitors calls
README.md - Development Server → Voice Transcriber: uses transcription
app/dev_server.py - Development Server → PII Shield: uses redaction
app/dev_server.py - Agent Runner → Runtime Config: uses settings
app/agent/runner.py - SQLite Records → Runtime Config: reads database path
app/db/database.py - PRISM Tracer → Runtime Config: reads telemetry settings
app/observability/prism_tracer.py