Management tools

4 tools for inspecting Galaxy structure and managing records, plus orion_session_end.

These tools let agents inspect the Galaxy's structure and manage individual records directly — useful before writing stardust to a specific location or cleaning up incorrect writes.

planet.list

List all Planets and their Biomes in the Galaxy, including any not yet reflected in the Sun's planet_registry. Use this to discover the full routing namespace before writing stardust.

No parameters.

Response:

{
  "planets": [
    {
      "name": "Engineering",
      "biomes": ["Backend API", "Database", "Auth Refactor"]
    }
  ]
}

biome.list

List all Biomes, optionally scoped to one Planet. Use when you need valid biome names before writing stardust to a specific location.

planet  string, optional   Scope to one Planet

stardust.get

Fetch a specific stardust record by ID. Use to verify what was written or to read a record before superseding it with brain.think.

stardust_id  string, required

stardust.delete

Permanently delete a stardust record by ID. Use to remove incorrect or test writes.

stardust_id  string, required

Irreversible. Deletion removes the record from PostgreSQL, ChromaDB, and the entity backlink index. Use brain.think with supersedes instead when you want to replace a record while preserving history.

orion_session_end

Explicitly end the current session and receive a usage summary. Call this at the end of a session to flush session statistics cleanly.

summary     string, optional   Free-text session summary
agent_name  string, optional   Agent identifier (inferred from active session if omitted)

Response:

{
  "status": "session_ended",
  "agent": "my-agent",
  "tools_called": 14,
  "duration_seconds": 312
}

Sessions also expire automatically after 5 minutes of idle time — orion_session_end is optional but gives you a clean summary and immediately frees the session slot.