memory_status

Category: diagnostics
Access: read
Audience: ordinary (an ordinary user normally calls this directly)

Purpose

Lightweight operational snapshot for the caller's own view. Call it at session start to see live counts and which profile you are on.

Arguments

Takes no arguments.

Result

Object with product, version, backend, database, profile, caller, role, visibility (self or global), caller-filtered counts, tools_total, and tools_debate.

Boundaries

Counts are filtered to caller visibility: star sees global with an explicit global marker, others see only granted projects; debates count via owned bindings and inbox/wake numbers are star-only, so no metadata leaks across scopes.

Lifecycle / side effects

Pure read; zero writes by construction.

Errors

Takes no arguments; backend failures surface as transport errors.

Example

{}

Result shape:

{
  "backend": "mariadb",
  "counts": {
    "entities": 12,
    "tasks_live": 5
  },
  "product": "saphira-memory",
  "visibility": "self"
}