How echotrigger/centaeris-workspace works
Centaeris is a hosted agent workspace: users interact through the web client, the Django control plane manages workspace and AgentRun operations, and the Rust runtime coordinates durable jobs and managed execution. Document/material processing and plugin management are additional product capabilities. The sampled excerpts show frontend stream handling, runtime-client calls, worker job handling, and material storage; other links reflect the README and module boundaries, so uncertain internal wiring is omitted.
Main entry points: main.rs Agent run runtime · main.tsx Workspace UI · ninja_api.py API control plane · api.ts Web API client
Components 23
Web client
- Workspace UI
packages/web/src/main.tsx - Chat stream
packages/web/src/chat/workspaceChatController.ts - Transcript view
packages/web/src/chat/workspaceTranscriptController.ts - Web API client
packages/web/src/api.ts
Django control plane
- API control plane
packages/api/api/ninja_api.py - Agent endpoints
packages/api/app_core/http/agents.py - Runtime client
packages/api/app_core/runtime_client.py - Workspace records
packages/api/app_core/models.py - Job worker
packages/worker/worker.py
Runtime services
- Agent run runtime
packages/runtime_server/src/main.rs - Model adapter client
packages/runtime_server/src/api_model_client.rs - Runtime job store
packages/runtime_server/src/postgres_store.rs - Transcript protocol
packages/runtime_server/src/transcript_protocol.rs
Managed execution
- Docker execution host
packages/runtime_server/src/docker_execution_host.rs - Docker engine
packages/runtime_server/src/docker_engine.rs - Execution agent
packages/hosted_execution/src/bin/execution_agent.rs
Materials and plugins
- Material endpoints
packages/api/app_core/http/library.py - Material processing
packages/api/app_core/material_processor.py - Material storage
packages/api/app_core/material_storage.py - Plugin lifecycle
packages/api/app_core/plugin_lifecycle.py
Other components
- Workspace user
- Model provider
- Configured object storage
Connections 24
- Workspace user → Workspace UI: uses
- Workspace UI → Web API client: requests
- Web API client → API control plane: calls API
- Workspace UI → Chat stream: starts chat
- Chat stream → Web API client: loads stream
- Workspace UI → Transcript view: opens transcript
- Transcript view → Web API client: loads transcript
- API control plane → Agent endpoints: routes requests
- Agent endpoints → Runtime client: schedules runs
- Runtime client → Agent run runtime: calls internal API
- Agent endpoints → Workspace records: reads and writes
- Job worker → Agent run runtime: claims jobs
- Agent run runtime → Runtime job store: persists jobs
- Agent run runtime → Model adapter client: requests inference
- Model adapter client → Model provider: sends model requests
- Agent run runtime → Transcript protocol: emits transcript events
- Agent run runtime → Docker execution host: dispatches execution
- Docker execution host → Docker engine: manages containers
- Docker execution host → Execution agent: runs agent
- API control plane → Material endpoints: routes material requests
- Material endpoints → Material processing: processes materials
- Material endpoints → Material storage: reads and commits
- Material storage → Configured object storage: reads and writes
- API control plane → Plugin lifecycle: manages plugins