Diminuendo is the client-facing gateway for Fabric. It authenticates users, serves the web/API surface, manages sessions, projects runtime events into client state, and selectively brokers calls to Podium, Ensemble, Unison, and other services.
The important correction: Diminuendo is no longer best described as "the ACP gateway." ACP is one optional edge adapter. The first-party product path is Fabric.
What It Does
- Authenticates users with Auth0 JWTs and development API-token paths where explicitly enabled.
- Serves the public gateway routes for Fabric RPC, WebSocket, REST app APIs, health, metrics, voice realtime, and webhooks.
- Manages tenants, projects, sessions, messages, approvals, files, skills, integrations, and audit records.
- Projects runtime and inference events into client-friendly conversation, stream, and presentation state.
- Brokers selected calls to Podium for runtime work, Ensemble for inference/model data, and Unison for configuration/resources.
- Hosts optional ACP, MCP, A2A, and AG-UI sidecars under the protocol adapter layer.
Current Client Surfaces
| Client | Path | Notes |
|---|---|---|
| Web | diminuendo/clients/web | Public static bundle for fabric.dev.aws.igent.ai |
| Desktop | diminuendo/clients/desktop | Tauri desktop app |
| Codex TUI | diminuendo/clients/codex-tui | Rust terminal client |
Older client experiments should be treated as historical unless they are reintroduced in the workspace.
Public Routes
On the dev host, https://fabric.dev.aws.igent.ai serves the static web app and proxies these routes to Diminuendo on 127.0.0.1:8001:
| Route | Purpose |
|---|---|
/rpc | Fabric JSON-RPC |
/ws | Gateway WebSocket |
/voice/realtime | Voice realtime surface |
/api/* | Product REST APIs |
/health | Health check |
/metrics | Prometheus metrics |
/webhooks/* | Webhook ingress |
/explorer/ is proxied to the Unison Explorer service, not to Diminuendo.
Runtime
| Aspect | Current shape |
|---|---|
| Runtime | Bun |
| Local port | 127.0.0.1:8001 in the root PM2 stack |
| Env source | diminuendo/.env, then diminuendo/.env.local |
| Public auth | Auth0 tenant diminuendo-dev.eu.auth0.com |
| Observability | OpenTelemetry, Prometheus metrics, service health probes |
For public web deploys, DEV_MODE=true is a production outage. Public fabric.dev.aws.igent.ai targets must run with DEV_MODE=false.