How iii-hq/iii works
iii is a composable runtime for registering workers, routing triggers to functions, and observing the resulting activity. The principal workflow is to define or add workers through Compose, have them join the live engine catalog, invoke their functions through triggers, and inspect traces, logs, queues, and state in the Console. The graph preserves documented queue, cron, HTTP, state, stream, SDK, and sandbox capabilities. Several subsystem links are based on README descriptions because their implementation files were not sampled.
Main entry points: trigger.rs Trigger routing · traces.tsx Developer console · cli.rs Compose CLI · packages Worker processes
Components 18
Worker composition
- Compose CLI
crates/iii-compose/src/cli.rs - Compose configuration
crates/iii-compose/src/config.rs - Managed engine lifecycle
crates/iii-compose/src/managed_engine.rs
Engine runtime
- Worker processes
sdk/packages - Language SDKs
sdk/packages - Engine runtime
engine/src/engine/mod.rs - Worker and function catalog
engine/src/workers/registry.rs - Trigger routing
engine/src/trigger.rs - Function invocation
engine/src/invocation/http_invoker.rs
Runtime capabilities
- HTTP and cron triggers
engine/src/workers/http_functions/mod.rs - Queue subscriptions
engine/src/workers/queue/queue.rs - State and streams
engine/src/workers/stream/stream.rs - Logs traces metrics
engine/src/workers/observability/mod.rs - Sandbox workers
crates/iii-worker/src/sandbox_daemon/mod.rs
Operations and console
- Developer console
console/packages/console-frontend/src/routes/traces.tsx - Console server and proxy
console/packages/console-rust/src/server.rs
Other components
- Developer or agent
- External engine services
Connections 21
- Developer or agent → Compose CLI: defines workers
README.md - Developer or agent → Language SDKs: registers functions
README.md - Compose CLI → Compose configuration: loads configuration
crates/iii-compose/src/config.rs - Compose CLI → Managed engine lifecycle: starts engine
crates/iii-compose/src/managed_engine.rs - Managed engine lifecycle → Engine runtime: launches runtime
- Worker processes → Engine runtime: registers with
README.md - Language SDKs → Worker processes: connects worker
README.md - Engine runtime → Worker and function catalog: maintains catalog
README.md - Trigger routing → Function invocation: dispatches call
README.md - Worker processes → Trigger routing: declares triggers
README.md - HTTP and cron triggers → Trigger routing: routes events
README.md - Queue subscriptions → Trigger routing: delivers messages
README.md - State and streams → Trigger routing: emits changes
README.md - Function invocation → Logs traces metrics: records activity
README.md - External engine services → Console server and proxy: serves engine API
console/packages/console-rust/src/server.rs - Developer console → Console server and proxy: requests console API
- Console server and proxy → External engine services: proxies requests
console/packages/console-rust/src/server.rs - Developer console → Logs traces metrics: inspects traces logs
README.md - Developer console → Queue subscriptions: inspects queues
README.md - Developer console → State and streams: inspects live state
README.md - Developer or agent → Sandbox workers: adds sandbox worker