Services catalog¶
Status: Current | Last reviewed: 2026-10-20
Every service in the repo, grouped by role. Each entry links to a per-service page with ports, dependencies, and operational notes.
Grouped by role here; grouped by how much a regression costs in Service tiers, which is the page to read before deciding whether a change needs a test.
Voice runtime¶
The pipeline that handles a live call from end-to-end.
| Service | Language | Purpose |
|---|---|---|
| ai-orchestrator | Python (Pipecat) | Real-time STT/LLM/TTS pipeline, gRPC :50051 |
| ai-manager | Node (Next.js) | Admin UI; agent + workflow + integration CRUD |
| agent-host | Python (FastAPI/MCP) | MCP tool host, :8003 |
| async-agent | Python (LangGraph) | Async workflow executor |
| media-proxy | Go | RTP / WebRTC fan-in, codec, mixing |
| ari-controller | Node | Asterisk ARI bridge; call control |
Integrations¶
Per-platform connectors that translate vendor protocols to the internal session/transport.
| Service | Language | Purpose |
|---|---|---|
| genesys-connector-go | Go | Genesys AudioHook BYOC terminator |
| genesys-agent-go | Go | Server-side WebRTC agent for Genesys Cloud |
| webex-connector-go | Go | Webex BYOVA media/control |
| webex-app-manager | Node | OAuth + datasource lifecycle |
| five9-voicestream-connector-go | Go | Five9 VoiceStream real-time export |
| poppy-company | Python (FastAPI) | Reviewed guest Chat Agents over Poppy 0.2, :3036 |
| teams-agent-gateway | Node | Microsoft Teams custom-agent messaging endpoint |
| connect-kvs-connector | Java | Amazon Connect KVS reader |
| connect-scv-translator | Node | Salesforce SCV BYOT bridge |
| salesforce-scv-automation | Apex / Flow | VoiceCall identity, relationships, record type, and CTR link |
| authentik-connect-sync | Python (Lambda) | JIT user provisioning |
Frontend¶
Browser apps and packaged surfaces.
| Service | Language | Purpose |
|---|---|---|
| assistant | Node / React | Separate Ari/OpenMuse Poppy test client, :3035 |
| surface-app | Node (Next.js) | End-user voice/chat surface |
| Assessments / proficiency | Node / React | Behavioral and English assessment, invitation/SSO access, evidence and AI/human review, :3050 |
| crm-dashboard | Node (Next.js) | Optional legacy CRM demo restored from snapshots |
| verizon-demo-app | React Native | Mobile demo |
| crm-api | Node / Python | Optional legacy CRM dashboard BFF restored from snapshots |
| code-server | Node + VS Code | Packaged in-browser IDE |
Knowledge and data¶
Storage-backed services that don't sit on the live media path.
| Service | Language | Purpose |
|---|---|---|
| knowledge-engine | Python (FastAPI) | Optional legacy hybrid search restored from snapshots |
| conversation-api | Python | Session, transcript, event broker |
| catalog-builder | Node | A2UI compile + publish |
| multimodal-service | Node | A2UI rendering |
| collab-gateway | Node (TypeScript) | Presence + Yjs gateway; owns the Y.Doc → Postgres flush |
| payment-vault | Python (FastAPI) | The PCI capture boundary — the only component that sees a card number, :3530 |
Infrastructure services¶
Standalone runtime support — observability, scheduled syncs, sandboxing.
| Service | Language | Purpose |
|---|---|---|
| status-page | Python | Dual-mode K8s/docker health |
| event-publisher | Go | Multi-cloud Postgres NOTIFY fan-out |
| config-sync-service | Python | Agent config replication |
| code-executor | Python | Sandboxed Python runner |
| antigravity-runner | Python | Sandboxed Google Antigravity local-tool runner |
| workspace-agent-runner | Python | Sandboxed Codex CLI and Claude Code Assistant Agent runner |
Lambdas¶
Inbound webhook handlers and bridges that run on AWS Lambda in production. They run as host processes in Vanguard.
| Lambda | Purpose |
|---|---|
| email-ingest-lambda | Inbound email → workflow trigger |
| notification-ingest-lambda | Inbound notification → workflow trigger |
| salesforce-forward-lambda | Salesforce platform event → workflow |
| pagerduty-aws-gateway | PagerDuty webhook → workflow |
| scv-transcript-gate-lambda | Suppresses Contact Lens transcripts while Live Translation owns the call |
| fhir-sfdc-wrapper-lambda | FHIR R4 façade over Salesforce Life Sciences clinical objects (adverse-event capability) |
Telephony stack¶
Configured (not coded) services. Run by image; tuned via mounted config.
| Service | Purpose |
|---|---|
| asterisk | PJSIP realtime, ARI :8087, dialplan |
| kamailio | SIP routing, TLS per city |
| janus | WebRTC gateway; SIP plugin |
| rtpengine | Media proxy; dual-interface for GA |
| coturn | TURN/STUN |
Shared libraries¶
Code shared across services lives outside apps/.
Shared libraries catalogs shared/, libs/, and proto/.