Admin integration

The admin / operator integration with system.agents is the set of $-prefixed accepts on AgentsRoot. Today there is no dedicated admin webapp for agents — operators use matrix invoke directly, or the Admin tab in matrix-web (which surfaces a generic actor inspector that can call any accept).

Admin accepts on `AgentsRoot`

From AgentsRoot.ts:93-107:

Op	Purpose
`$status`	Package health + storage stats
`$metrics`	Counters: total activations, total prompts, active sessions, etc.
`$children`	List child actors (memory, embeddings, plus per-target `AgentActor` children)
`$sessionList`	List sessions, optionally for a `targetKey`
`$sessionDelete`	Delete one session by id
`$sessionClearAll`	Delete every session, every message, every state row, and tear down active children
`$sessionSeed`	Seed a synthetic transcript (test/admin)
`$traceQuery`	Return activity frames for `(sessionId, requestId)`

CLI invocations

bash

# Health check
matrix invoke system.agents '$status' '{}'

# What sessions exist?
matrix invoke system.agents '$sessionList' '{}'

# Sessions for one target
matrix invoke system.agents '$sessionList' '{ "targetKey": "system.registry" }'

# Drop a single session
matrix invoke system.agents '$sessionDelete' '{ "sessionId": "ses_…" }'

# Wipe all sessions (destructive — does NOT touch memories/plans)
matrix invoke system.agents '$sessionClearAll' '{}'

# Read frames for one request
matrix invoke system.agents '$traceQuery' '{ "sessionId": "ses_…", "requestId": "req_…" }'

What `$sessionClearAll` does NOT touch

Memories in memories and memory_embeddings. Memory is durable and outlives session resets. Drop the SQLite file to wipe memory.
Plans in plans and plan_steps.
Audit trail in memory_access_log.
Embedding cache in embedding_cache.

This separation is intentional: clearing sessions resets the chat history but preserves what the agent has learned.

Memory operator surface

MemoryActor (system.agents.memory) exposes a parallel set of admin-friendly ops:

Op	Purpose
`memory.audit-trail`	Return cross-actor access log for a target mount
`memory.searchTier`	Return active search tier (`hybrid`/`fts5`/`like`)
`memory.history`	Return recent memories for a mount

There is no admin op to bulk-delete memories. Operator-level memory cleanup is "drop the SQLite file" today.

Where this surfaces in `matrix-web`

The Admin tab in matrix-web (/apps/web/) shows a generic actor inspector. Selecting system.agents shows the accepts list; an admin can paste a payload and invoke any op. This is not agent-specific UX — it's the generic system-admin tool.

Target state

A dedicated agent-platform admin panel would consolidate:

A session table view with delete/select-all.
A "memories by target" inventory view.
Live $status / $metrics strip.
A "wipe and reseed" workflow that respects the memory-vs-session split.

None of that exists today. WORKSTREAMS/loose-ends/items/P1.12-cognitive-readiness-panel.md is the closest filed item but its scope is health, not maintenance.

Admin integration ​

Admin accepts on AgentsRoot ​

CLI invocations ​

What $sessionClearAll does NOT touch ​

Memory operator surface ​

Where this surfaces in matrix-web ​

Target state ​

See also ​