Search memory for anything about the user/past/project. recall(query, top_k=5). Returns results + auto-attached lessons (read & FOLLOW them) + project_context. Trust results with score>0.2 as the user's recorded reality.

One-call full context for a NAMED project at the start of work. project_overview(name) → lessons (rules to follow), decisions, open goals, recent activity, related entities.

READ-FIRST bundle at the start of work on a known project. prepare(message=<the user's message>) returns project_context, surfaced lessons (each with surface_id - FOLLOW them, then mark_lesson_followed), recent_activity and open_goals in one ~10ms call. Replaces several recall() calls.

Upsert a mutable personal attribute. record_keyed_fact(subject, attribute, value) - e.g. user/city/Tampa. A new value SUPERSEDES the old under one canonical key instead of piling up.

Standalone 'what procedural rules apply to X'. find_lessons(query, project?) → lessons with surface_id; project scope excludes explicit lessons from other projects while retaining generic rules. FOLLOW them, then mark_lesson_followed.

Report whether a surfaced lesson changed your behaviour. mark_lesson_followed(surface_id, followed=True|False, note='...', applicable=True|False). Use applicable=False when the lesson was irrelevant, not followed=False. Call after acting on a lesson - powers the self-improvement loop.

Re-orient after YOUR context compacted. session_brief() → what THIS session decided/built. Don't re-ask the user.

⚡ PREFERRED for any message with multiple memories - stores N atomic items in ONE call (each ~3-5s of agent thinking saved vs separate record_* calls). items: list of dicts, each with a type: fact{content,importance} | fact_tree{main,subfacts[],importance} | lesson{content,project?} | goal{title,status,due_at} | plan{title} (future intent) | activity{content,kind} | milestone{chain_name,title,state}. ONE record_batch per turn; use ABSOLUTE dates.

Move a goal's status/progress. update_goal(goal_ulid, status='in_progress'|'done', progress=0-100, note='...'). Records a goal_update event so the goal's history is preserved.

List open goals. list_goals(status='in_progress'). For 'what are my goals/what's in flight'.