Appearance
Integration
Director is a thin client. It calls a small, fixed set of system actors and projects the responses. This section enumerates every consumed actor, its consumed ops, the payload Director sends, and the timeout used.
All adapter calls go through RequestReply.execute(context, mount, op, payload, { timeoutMs, targetRoot }). targetRoot is the runtime root resolved by DirectorTopology. timeoutMs is per-call.
Pages
- system.runtimes — physical runtime inventory.
- system.registry — logical mount claims (the canonical source for the catalog).
- system.catalog — read projection of registry + runtime inventory.
- system.gateway.http — Director's relationship to the gateway (it consumes bootstrap, not actor ops).
- system.devices — what Director does (and doesn't) do with the device facade.
- agent-platform actors —
system.agents,system.observability.*,system.scheduler,system.budget, and the cognition compat aliases.
Cross-cutting fallback strategy
Several services exist as canonical + compat pairs. Director uses invokeFirst (defined in DirectorRuntimeAdapter.ts:146-173 and DirectorDataAdapter.ts:21-44) to walk the candidate list and accept the first responder. The result is tagged with backend mode (canonical / compat) so the UI can warn operators when the deployment hasn't migrated.
Default timeouts
| Op | Timeout | Source line |
|---|---|---|
system.registry registry.list | 5_000 | DirectorRuntimeAdapter.ts:243 |
system.runtimes runtimes.registered | 5_000 | DirectorRuntimeAdapter.ts:219 |
system.bindings bindings.children/roots/tree | 5_000 | DirectorRuntimeAdapter.ts:300, 318, 337 |
system.catalog catalog.list | 5_000 | DirectorRuntimeAdapter.ts:393 |
<actor> $introspect | 5_000 | DirectorRuntimeAdapter.ts:445, 459 |
tracing.query/search | 8_000 | DirectorRuntimeAdapter.ts:591, 599 |
system.agents $prompt (Director sessions tab) | 90_000 | DirectorDataAdapter.ts:103 |
system.agents $sessionList | 5_000 (default) | DirectorDataAdapter.ts:147 |
memory.searchTier | 2_000 | DirectorDataAdapter.ts:71 |
Source:
projects/matrix-3/packages/director/src/services/. The integration pages below quote each call site for the curious.