Skip to main content

Valhalla Control Surface

The Valhalla suite is the Valkyr product stack working as one system:

Valhalla Suite system poster

For subsystem relationship charts, code anchors, and breakout maps, see the Valhalla Suite Atlas.

Print and reference assets:

  • Print-ready PDF, 36 x 24 in

  • Editable SVG source

  • High-resolution PNG, 3600 x 2400

  • Valhalla api-0 is the suite backend platform for generated APIs, RBAC, billing, admin/control surfaces, deployments, GrayMatter control, and SWARM coordination.

  • ValkyrAI is the workflow engine for tasks, ExecModules, agentic orchestration, and reviewable automation.

  • GrayMatter is the durable memory and RBAC-scoped object-graph layer.

  • ValorIDE is the agentic coding and application-generation client. It is both a GrayMatter client and a SWARM agent.

  • Valor is the agentic chat/work interface that can advise, create workflows, navigate the web app, operate against system inputs, and coordinate agents.

  • SwarmOps is the live agent registration, discovery, command, graph, and telemetry layer. It is not the GrayMatter memory primitive.

  • Gridheim Runes are OpenAPI extension-defined calculated fields generated by ThorAPI as @Rune model fields and evaluated by ValkyrAI/OpenXLS with no calculated-value persistence.

  • Sheetster Grid is the workbook/table UX for operating generated objects, cells, formulas, charts, and actions.

Runtime Discovery​

Current Valhalla api-0 exposes a GrayMatter control document for clients and agents:

GET /v1/graymatter/control
GET /v1/graymatter/admin/control

The response describes the authenticated principal's GrayMatter contract:

SectionPurpose
suiteNames the Valhalla suite and the participating products.
memoryLists memory primitives, entry types, entitlements, usage, and admin actions.
semanticReports semantic index health and reindex guidance.
objectGraphDeclares that the full RBAC-visible api-0 schema is the object graph.
swarmPoints to SwarmOps registration and graph endpoints, with coordination-only policy.
clientsProfiles ValorIDE, Valor, CODEX, OpenClaw, Claude, Sheetster Grid, and other SWARM clients.
endpointsProvides the canonical endpoint map for memory, schema, SwarmOps, Agent, and GrayMatter surfaces.

Clients should load this document before falling back to direct /v1/api-docs capability inference.

Boundary Rules​

GrayMatter memory operations use these primitives:

  • MemoryEntry
  • GrayMatter
  • SemanticIndexEntry

The live object graph may include any RBAC-visible api-0 model, including Agent, Workflow, Task, Application, Workbook, Customer, Opportunity, Product, FileRecord, and other generated ThorAPI entities. Gridheim Runes attach formula rules to generated object properties; Sheetster Grid presents the workbook/table operating surface over them.

SwarmOps is intentionally separate:

  • Use POST /v1/swarm-ops/register to register or refresh a live agent instance.
  • Use /v1/swarm-ops/discover, /v1/swarm-ops/agents, and /v1/swarm-ops/graph for presence and coordination views.
  • Do not treat SwarmOps rows or graph snapshots as durable GrayMatter memory entries.

Agent Startup Pattern​

Agentic clients should follow this order:

  1. Authenticate against api-0.
  2. Load /v1/graymatter/control.
  3. Create or refresh a durable Agent record when required.
  4. Register live presence through /v1/swarm-ops/register.
  5. Sync /v1/api-docs and use it as the RBAC-scoped object graph.
  6. Query GrayMatter memory before meaningful work.
  7. Write only durable decisions, preferences, todos, artifacts, configuration, or compact context.
  8. Publish SWARM events for coordination, acknowledgements, task state, and audit proof.

Related: