Director

Appearance

Agent-platform actors ​

This page is the comprehensive call list. Every op Director sends to a non-system-runtime actor is here, ordered by destination mount.

system.agents (cognition + sessions) ​

All in DirectorDataAdapter.ts. The _sessionApiMounts() helper returns serviceMounts(DirectorServiceTargets.cognition.sessions), which is ['system.agents'].

$prompt ​

ts
RequestReply.execute(context, 'system.agents', '$prompt', {
  prompt: payload.text,
  sessionId: payload.sessionId,
  blocking: true,
  callerRealm: root,
  callerRoot: root,
  callerMount: payload.mount,
  principalId?: payload.principalId,
  snapshotTree: { mount, tag: 'director', accepts: [], emits: [], cognitiveState: {}, children: [] },
}, { timeoutMs: 90_000, targetRoot: root });

Used by the Sessions tab. The 90s timeout matches the longest-tail provider response.

$sessionList ​

ts
{ principalId?: string }   // returns { sessions: [...] }

Director filters the response client-side via _matchesSessionTargetKey to keep only sessions whose targetKey is consistent with the (root, mount) pair the user is viewing. That filter is necessary because $sessionList is principal-scoped, not target-scoped.

session_state.read ​

ts
{ sessionId: string, key: 'transcript' }

Used to load history when the user resumes a session. The legacy alias would respond identically; the canonical-vs-compat tag goes onto the result so the Sessions tab badge reflects which backend served it.

$traceQuery ​

ts
{ sessionId: string }    // returns { frames: [...] }

Used by the Sessions tab to render activity frames for the selected session. Timeout 10s.

system.agents.memory / system.memory (compat fallback) ​

DirectorServiceTargets.cognition.memory = ['system.agents.memory', 'system.memory'].

ts
{ mount: string, query: string, limit?: number }

Result rows render in the Memory detail tab.

memory.searchTier ​

ts
{}  // returns { tier?: string }

Asked once after a successful memory.search to label the tier badge. Timeout 2s, failure is silent.

system.observability.tracing / system.tracing ​

DirectorRuntimeAdapter.queryOpsFeed, _queryActivityFeed, loadOpsDetail. Timeout 8s.

ts
{
  limit:  number,            // backendLimit (3x display limit)
  kind:   string[],          // e.g. ['rpc', 'log', 'tool-call', 'message', 'inference']
  source?: string,
  text?:   string,
}

trace.search is used when there is text; trace.query otherwise.

trace.activity ​

ts
{ mount: string, windowMs: number, limit: number }

Source mount activity feed. Used directly for the "activity" kind and as a fallback in loadOpsDetail.

trace.request / trace.thread / trace.get ​

For loadOpsDetail fan-out:

ts
trace.request { requestId: string, limit: 80 }
trace.thread  { sessionId: string, limit: 80 }
trace.get     { traceId: string }

First non-empty result wins.

system.observability.logging / system.logging ​

DirectorRuntimeAdapter.queryOpsFeed. Timeout 8s.

ts
{ text?: string, source?: string, limit: number }

logging.search when there is text; logging.query otherwise.

system.observability.health / system.health ​

Used inside loadPackageStatuses (src/services/DirectorRuntimeAdapter.ts:1978-2056). The exact op depends on package family — health.summary, agents.list, etc. — and is determined by _loadPackageStatus.

system.observability.metrics / system.metrics ​

Listed in DirectorServiceTargets but currently not actively consumed in adapter calls. The targets are reserved so a future metrics tab can wire in without changing the targets table.

system.scheduler ​

DirectorServiceTargets.runtime.scheduler = ['system.scheduler']. Used by _loadCompatAgentsStatus to read scheduler summaries when the canonical agents path is unavailable.

system.budget ​

DirectorServiceTargets.runtime.budget = ['system.budget']. Reserved for budget-aware UI; not actively rendered today.

Per-actor $introspect ​

For every actor the user selects in the tree, DirectorRuntimeAdapter.introspectActorCached issues:

ts
RequestReply.execute(context, <localMount>, '$introspect', { depth: 'full' },
  { timeoutMs: 5000, targetRoot: <runtimeWireRoot or root> });

Returns IActorIntrospect (src/types.ts:122-161). The cache layer prevents re-fetching a binding overlay on every click.

See also ​

Source: projects/matrix-3/packages/director/src/services/DirectorDataAdapter.ts (cognition), DirectorRuntimeAdapter.ts:209-757, 417-461, 1978-2206 (catalog, introspect, package statuses, ops feed, ops detail).