Skip to content

Agent actor ops

Every accept this package exposes, sourced from the static accepts declarations.

AgentsRoot (system.agents)

From AgentsRoot.ts:93-107:

OpDescriptionRequired args
$promptCreate or continue an agent session for a caller mount(caller-supplied prompt + correlation IDs)
$evalEvaluate omega-lisp in the persistent agents REPL sessionsource code
$childrenList child actors in this package
$statusPackage health + storage stats
$sessionListList sessions for a target keytargetKey?: string
$sessionDeleteDelete a session by IDsessionId: string
$sessionClearAllDelete all persisted sessions and active child agents
$sessionSeedSeed a session transcript for tests/tools(transcript)
$metricsReturn system.agents metrics
$traceQueryReturn activity frames for a session/requestsessionId: string, requestId?: string
session.createCreate or ensure an agent session recordsessionId: string, targetKey: string, principalId?: string
session_state.upsertPersist JSON session state by keysessionId: string, key: string, data: unknown
session_state.readLoad session history for a session IDsessionId: string

AgentsRoot.isPromptRouter = true exempts the root from the standard $prompt seal.

MemoryActor (system.agents.memory)

From MemoryActor.ts:86-102:

OpDescription
memory.saveSave a memory record for an actor (mount, content, tags?, targetKey?, profileKey?, scope?)
memory.getGet a specific memory by ID (id: number)
memory.searchSearch memories — hybrid: vector + FTS5, degrades gracefully (mount, query, limit?, minScore?, askSources?, targetRef?, targetKey?, profileKey?, sessionId?)
memory.historyRecent memory records for a mount (mount, limit?)
memory.searchTierWhich search tier is active (hybrid / fts5 / like)
memory.consultAsk the actor to answer from its own memory context (question, context?, maxTokens?)
plan.createCreate a plan (mount, name, steps)
plan.updateUpdate a plan step (planId, stepIndex, status)
plan.activeActive plan for a mount (mount)
plan.completeMark a plan complete (planId)
plan.historyPlan history for a mount (mount, limit?)
memory.audit-trailMemory access log for a mount (mount, limit?)
plan.executeStart step execution (planId, stepIndex, ownerMount)
plan.execution-completeMark step execution result (executionId, status, output?)
plan.executionsActive executions for a plan (planId)

EmbeddingService (system.agents.embeddings)

From matrix.json and the service source:

OpDescription
embed.generateGenerate an embedding for given text
embed.batchGenerate embeddings for an array of texts
embed.searchVector search — given a query embedding, return ranked memory IDs
embed.providersList configured embedding providers (OpenAI, Gemini, local)
embed.statusActive provider + cache statistics

Manifest summary

json
// projects/matrix-3/packages/agents/matrix.json
"exports": ["memory", "embeddings"],
"storage": { "sqlite": { "domain": "agents", "schema": "schema.sql", "version": 2 } },
"permissions": { "fsPolicy": "project-readwrite", "network": true, "subprocess": false, "env": false }

See also

Source: All op rows are read verbatim from static accepts in the corresponding actor source files. The package manifest is projects/matrix-3/packages/agents/matrix.json.