How horizon-sky/agentops works
AgentOps is a user-facing engineering-ticket automation agent. A user submits a request in the workspace; the API starts a stateful run, which classifies and plans work, retrieves cited knowledge, invokes tools, pauses for approval before writes, and returns an answer. The workspace also supports document ingestion, ticket management, trace replay, and evaluation reporting. The graph retains README-documented capabilities whose implementation was not sampled; those relationships are omitted where no excerpt or documented connection establishes them.
Main entry points: main.py FastAPI app · models.py Postgres pgvector · route.ts Web API proxy · nodes Agent stages
Components 34
Workspace
- Workspace UI
apps/web/app/(workspace)/page.tsx - Run stream UI
apps/web/lib/useRun.ts - Approval card
apps/web/components/ApprovalCard.tsx - Document ingest UI
apps/web/components/DocumentIngest.tsx - Ticket overview
apps/web/app/(workspace)/tickets/page.tsx - Trace replay UI
apps/web/app/(workspace)/traces/page.tsx - Evaluation dashboard
apps/web/app/(workspace)/evals/page.tsx
API and identity
- Web API proxy
apps/web/app/api/[...path]/route.ts - FastAPI app
apps/api/src/main.py - Account routes
apps/api/src/routers/auth.py - Run routes
apps/api/src/routers/runs.py - Ingest route
apps/api/src/routers/ingest.py - Ticket routes
apps/api/src/routers/tickets.py - Trace routes
apps/api/src/routers/traces.py - Evaluation route
apps/api/src/routers/eval.py - Identity services
src/auth.py
Agent execution
- Agent state graph
src/agent/graph.py - Agent stages
src/agent/nodes - Run context
src/agent/context.py - Event emission
src/agent/emit.py - Model access
src/agent/model.py - Tool registry
src/tools/registry.py - Built-in tools
src/tools/builtin.py - MCP servers
services
Knowledge retrieval
- Document processing
src/rag/ingest.py - Hybrid search
src/rag/hybrid_search.py - Retrieval stage
src/agent/nodes/retrieve.py
Persistence and insight
- Postgres pgvector
src/db/models.py - Database sessions
src/db/session.py - Cache
src/db/cache.py - Trace recorder
src/agent/tracing.py - Evaluation runner
evals/runner.py - Runtime settings
src/config.py
Other components
- Engineer
Connections 42
- Engineer → Workspace UI: submits request
- Workspace UI → Web API proxy: calls API
- Web API proxy → FastAPI app: proxies REST
apps/web/app/api/[...path]/route.ts - FastAPI app → Run routes: registers routes
apps/api/src/main.py - FastAPI app → Ingest route: registers routes
apps/api/src/main.py - FastAPI app → Account routes: registers routes
apps/api/src/main.py - FastAPI app → Ticket routes: registers routes
apps/api/src/main.py - FastAPI app → Trace routes: registers routes
apps/api/src/main.py - FastAPI app → Evaluation route: registers routes
apps/api/src/main.py - Run stream UI → Web API proxy: streams runs
- Run routes → Agent state graph: starts or resumes
- Agent state graph → Agent stages: dispatches stages
- Agent stages → Retrieval stage: includes retrieval
- Retrieval stage → Hybrid search: searches evidence
src/agent/nodes/retrieve.py - Hybrid search → Postgres pgvector: queries chunks
src/rag/hybrid_search.py - Hybrid search → Model access: builds embedder
src/rag/hybrid_search.py - Retrieval stage → Event emission: emits retrieval event
src/agent/nodes/retrieve.py - Agent stages → Tool registry: invokes tools
- Tool registry → Built-in tools: dispatches tools
src/tools/registry.py - Built-in tools → Postgres pgvector: persists approved ticket
src/tools/builtin.py - Tool registry → MCP servers: offers MCP tools
- Approval card → Run routes: confirms writes
- Ingest route → Document processing: ingests document
apps/api/src/routers/ingest.py - Document processing → Postgres pgvector: stores chunks
src/rag/ingest.py - Document processing → Database sessions: opens session
src/rag/ingest.py - Document processing → Model access: embeds text
src/rag/ingest.py - Document ingest UI → Web API proxy: uploads document
- Ticket routes → Postgres pgvector: manages tickets
- Ticket overview → Web API proxy: manages tickets
- Trace routes → Postgres pgvector: serves spans
- Trace recorder → Postgres pgvector: records spans
src/agent/tracing.py - Trace replay UI → Web API proxy: loads trace
- Evaluation dashboard → Web API proxy: loads report
- Evaluation route → Evaluation runner: serves report
- Evaluation runner → Agent state graph: runs agent
evals/runner.py - Account routes → Identity services: authenticates users
apps/api/src/routers/auth.py - Identity services → Postgres pgvector: checks sessions
src/auth.py - FastAPI app → Cache: reports cache health
apps/api/src/main.py - Agent stages → Run context: uses run context
src/agent/nodes/retrieve.py - Agent stages → Model access: uses model
src/agent/nodes/review.py - FastAPI app → Database sessions: initializes database
apps/api/src/main.py - Database sessions → Postgres pgvector: connects to
src/db/session.py