Module cognition 

Perpetual cognition runtime for persona swarms.

Phase 0 scope:

• Contract types for personas, thought events, proposals, and snapshots
• In-memory runtime manager for lifecycle + lineage
• Feature-flagged perpetual loop (no external execution side effects)

Modules

beliefs

Shared Belief Store — structured extraction, canonical keys, decay, and confidence policy.

executor

Execution Engine — Capability Leases, Tool Execution, and Decision Receipts.

persistence

Persistence — atomic save/load of cognition state with evidence preservation.

tool_router

FunctionGemma-powered hybrid tool-call router.

Structs

AttentionItem

An item requiring persona attention.

CognitionRuntime

In-memory cognition runtime for perpetual persona swarms.

CognitionRuntimeOptions

Runtime options for cognition manager.

CognitionStatus

Start/stop response status.

CreatePersonaRequest

Request payload for creating a persona.

GlobalWorkspace

The coherent “now” for the entire swarm.

LineageGraph

Lineage graph response.

LineageNode

Lineage node response.

MemorySnapshot

Distilled memory snapshot contract.

PersonaIdentity

Identity contract for a persona.

PersonaPolicy

Policy boundaries for a persona.

PersonaRuntimeState

Full runtime state for a persona.

Proposal

Proposal contract (think first, execute through gates).

ReapPersonaRequest

Request payload for reaping persona(s).

ReapPersonaResponse

Reap response.

SpawnPersonaRequest

Request payload for spawning a child persona.

StartCognitionRequest

Start-control payload for perpetual cognition.

StopCognitionRequest

Stop-control payload for perpetual cognition.

SwarmGovernance

Governance rules for swarm voting.

ThinkerClient

ThinkerConfig

ThinkerOutput

ThoughtEvent

Streamable thought event contract.

Enums

AttentionSource

Source of an attention item.

CandleDevicePreference

PersonaStatus

Persona execution status.

ProposalRisk

Proposal risk level.

ProposalStatus

Proposal status.

ProposalVote

A vote on a proposal.

ThinkerBackend

ThoughtEventType

Thought/event types emitted by the cognition loop.