Architecture

Every view. A real diagram for each.

Not marketing boxes — these diagrams are drawn from the actual deployed system: the control plane, the bot-node fleet, the data stores, the connector runtime, and the security controls that are really running. Jump to any view.

System architecture

Components and how work flows through them.

Work flows down from a surface to the controller, fans out to bot nodes, reaches outside systems only through brokered connectors, and lands in isolated data. Results flow back up.

The same diagram appears on the Platform page alongside the eight-layer breakdown.

Production & deployment

The real running topology.

This is the actual deployment: a Cloudflare tunnel for ingress, one control-plane container, a fleet of bot-node containers each consuming its own Redis stream, five data stores, plus Vault for secrets and Headscale for remote nodes.

Drawn from the live container set: one oshal-local-api control plane and ~26 bot-node containers, each on its own Redis stream. Today this runs on Docker Compose; the same images target Kubernetes.

Runtime & system routing

How one request travels the system.

From the edge, through the auth gate, onto the mesh, to a bot that runs the model, and back — with cost captured on the way out.

Each bot consumes only its own stream, so lanes scale independently. Token and dollar cost is captured once, centrally, on the way out.

Integration architecture

How a bot safely reaches an outside system.

A bot never holds a raw credential. A tool call passes a per-agent auth gate, runs on the shared connector runtime, and pulls a scoped token from the broker before it touches an external API.

Live signed connectors (commerce, travel, media, finance) are a curated subset; the marketplace catalog is the broader, importable set. More on Platform → Connectors.

Workflow flows

The ticket lifecycle.

Every unit of work is a ticket on a queue. Build, ticket, and video pipelines are first-class shapes of this same flow.

The build / ticket / video pipelines are on Platform → Workflows.

Security architecture & scanning

Two layers: what's enforced, and what's watched.

Preventive controls stop a bad action before it happens; the Security Center is the detective layer that scans the platform itself and triages findings into tickets.

Tenant RLS and least-privilege DB roles are shipped and enforced. The Security Center and fail-closed execution are built and rolling out; some findings are open work, tracked as tickets. See Platform → Security.

Want a walk-through?

Happy to go through any layer in depth — the real deployment, the routing, the isolation, or the security model.