Authoring control plane, shared tenant state, the conversation runtimes, and the telephony edge that feeds them
Guided views
Explore this system
Step through curated paths without changing the source diagram.
Beat
Next
ReadyChapter 01 / 01
Guided chapter
Diagram guideExplore this system
Inspecting compiled semantics
E ExportT ThemeS Style0 Reset+ Zoom in- Zoom outEsc Close
Find a node
⌕/
No matching nodes
Semantic passport
Verified source
Authored reach
Route probeChoose a start node
Pick two semantic nodes on the diagram
Choose the source, then the destination. Direction matters.
Semantic lensCompare system roles
Choose up to two semantic kinds. One reveals its real traffic; two compare only direct authored relationships.
Choose a kind to inspect its nodes and touching relationships.
Semantic radar
Building overview
Click nodeDrag to pan
Two Authoring Doorways
• Browser editors autosave through collab-gateway, which flushes config back to ai-manager and keeps durable Yjs state in collab_documents
• The Yjs converters are a fixed allow-list, so an unlisted top-level config key is silently dropped on every flush
• External clients use versioned REST and stateless MCP with fine-grained management scopes, never the platform-admin bypass
AI Authoring Is Sandboxed
• Generate with AI and the editor Assistant both run a scoped CLI inside workspace-agent-runner
• The sandbox writes only through the generation MCP endpoint using a per-job token bound to one target
• Validation is two tiers: structural JSON Schema in Studio, buildability preflight in ai-orchestrator
Publish Is A Database Fact
• Runtimes resolve the published agent_versions row themselves; Studio pushes no config to them
• Tenant isolation is Postgres RLS, while Authentik groups stay authoritative for membership and platform admin
• Not drawn: MinIO catalog bundles, CRM embeds, OTLP telemetry
Telephony Edge
• Inbound CCaaS is default-deny: ari-controller rejects calls without an enabled ccaas_pipeline_integrations row
• SIP calls land on Kamailio/Asterisk; ari-controller allocates media-proxy legs that stream gRPC audio to ai-orchestrator
• Janus, rtpengine, and coturn (WebRTC/TURN media plane) are folded into the SIP edge here
Architecture diagram • Built with Archify • Create yours ↗ • Hover to trace • R route • Click to focus • +/− zoom • M radar • [/] views • P play story • T theme • E export