Fire one external lifecycle event (session_started, new_message, ...).

Args: event: one of KNOWN_EVENTS (session_started, session_ended, new_message, auto_save_candidate, context_threshold, memory_pressure, post_context_compression). payload: event body. Recognized keys per event: session_ended: {"summary": str}; new_message/auto_save_candidate: {"text": str}; post_context_compression: {"query": str}; session_started: {"text": str?, "budget": int?}. layer: "user" (default) or "agent". user_id: subject user (bound to API key on HTTP transports). ctx: MCP context (injected).

Returns: Handler results dict; unknown event raises ValueError (MCP error).

Universal Primitive: routing thoughts to correct memory layers based on importance and content.

kind: optional declaration hint (one of L4_DECLARABLE_KINDS). A declared thought is authored canon — it bypasses the length/pattern gates straight to L4 (spec S4), rate-limited per user. Without it, behavior is unchanged.

Universal Primitive: Hybrid search across ALL layers (L3, L4, Wiki, Graph) with context construction.

Universal Primitive: context-aware forgetting with Shadow Bin support.

Scope: exact one L4 key; fuzzy a pattern across L4, L3 and the graph; recent everything newer than minutes; episode_ids exactly those episodes.episode_id values; undo puts the archived_ids back where they came from. Every scope reports what it touched, in entries / episodes / graph_nodes / not_found.

dry_run=True matches and writes nothing — the same computation as the real pass, so the preview cannot drift from it. Refused for recent, which has no shadow bin.

undo refuses a purged row, a row whose archived kind is unknown, another owner's id, and a row whose key is already back in the table — each with its reason rather than a bare zero; dry_run=True shows what would return and refuses the same rows. An id that two archived rows share is refused too, unless memory_type names the one you want. The archive is not a backup: restored_items names the fields a restored row could not bring back.

Universal Primitive: update agent personality and triggering evolution.

Universal Primitive: managing project-specific context and file mapping.

Projects are global (keyed by name). Structured data (identity, decisions, artifact map, code index) lives in projects.db; large documents go to the Wiki as project_spec pages.

Wake up (E10, Stage 2-C): one-call memory lift for a fresh session.

Glues memory_recap (continuity pack) and the inject critical set onto a shared token budget: recap takes at most half, inject gets the rest. Returns structured blocks plus a rendered markdown block with a cache:break between the two halves.