How jakezimconnections/incident-trawlers works
Incident-Trawlers is a FastAPI harness for running named LangGraph workflows through one shared Claude agent loop. A client lists workflows or submits a run; the API resolves the workflow, which builds and streams the graph, returns the final answer, and records a trace. The default workflow provides project-inspection tools; the ZIM workflow defines incident-investigation state and currently uses file and shell tools. The graph shows documented wiring only; Cognito, Stripe, and Kibana integrations are described as future tools, not implemented capabilities.
Main entry points: default.py Default workflow · zim_incident.py ZIM incident workflow · workflow.py Workflow runner · runs.py Run endpoint
Components 20
HTTP API
- FastAPI app
app/main.py - API router
app/api/v1/api.py - Run endpoint
app/api/v1/runs.py - Workflow listing
app/api/v1/workflows.py - Run contracts
app/schemas/run.py
Workflow orchestration
- Workflow registry
app/workflows/__init__.py - Default workflow
app/workflows/default.py - ZIM incident workflow
app/workflows/zim_incident.py - Workflow runner
app/core/langgraph/workflow.py - Agent state
app/schemas/graph.py
Agent runtime
- Agent graph
app/core/langgraph/graph.py - File tools
app/core/langgraph/tools/read_file.py - Shell tool
app/core/langgraph/tools/run_shell.py - Write tool
app/core/langgraph/tools/write_file.py - Claude model
app/services/llm.py
Run observability
- Trace logger
app/services/trace_logger.py - Trace files
- Application settings
app/core/config.py
Other components
- API client
- Anthropic API
Connections 26
- API client → FastAPI app: sends HTTP
README.md - FastAPI app → API router: mounts routes
app/main.py - API router → Run endpoint: registers
app/api/v1/api.py - API router → Workflow listing: registers
app/api/v1/api.py - Run endpoint → Workflow registry: looks up
app/api/v1/runs.py - Workflow listing → Workflow registry: lists
app/api/v1/workflows.py - Run endpoint → Run contracts: validates and returns
app/api/v1/runs.py - Workflow registry → Default workflow: registers
app/workflows/__init__.py - Workflow registry → ZIM incident workflow: registers
app/workflows/__init__.py - Run endpoint → Workflow runner: runs workflow
app/api/v1/runs.py - Default workflow → Workflow runner: configures
app/workflows/default.py - ZIM incident workflow → Workflow runner: configures
app/workflows/zim_incident.py - Default workflow → Agent state: selects state
app/workflows/default.py - ZIM incident workflow → Agent state: selects state
app/workflows/zim_incident.py - Workflow runner → Agent graph: builds and streams
app/core/langgraph/workflow.py - Default workflow → File tools: supplies tools
app/workflows/default.py - Default workflow → Shell tool: supplies tools
app/workflows/default.py - Default workflow → Write tool: supplies tools
app/workflows/default.py - ZIM incident workflow → File tools: supplies tools
app/workflows/zim_incident.py - ZIM incident workflow → Shell tool: supplies tools
app/workflows/zim_incident.py - Agent graph → Claude model: creates model via
app/core/langgraph/graph.py - Claude model → Application settings: reads defaults
app/services/llm.py - Claude model → Anthropic API: calls model
app/services/llm.py - Workflow runner → Trace logger: records run
app/core/langgraph/workflow.py - Trace logger → Trace files: writes traces
app/services/trace_logger.py - Trace logger → Application settings: reads trace config
app/services/trace_logger.py