Journal

Fetch one journal entry by ID. Use only when the entry ID is already known; otherwise search with queryJournalEntries. Returns a compact summary unless detail is "full"; only shared entries are readable.

Search private journal entries with optional text query and kind/mood/date/tag filters, e.g. the last 10 entries with mood "low". Returns active entries the user shared with AI, sorted by entry date, newest first; deleted entries are never returned. Supports an entry-date range, ALWAYS pass from/to when the question concerns a period (a year, a month, 'recently'). Rows are compact summaries; pass detail 'full' or fetch one entry with journal_getJournalEntry when the user needs the full body. `withheld` counts entries that matched but are not shared with AI.

Journalling cadence for one year, counted server-side over ACTIVE entries only (deleted and archived are excluded, and sharing does not affect the counts): total entries, entries this week, current streak, average mood and energy, plus a per-month breakdown. Prefer this over journal_queryJournalEntries for every how-often/how-many/streak question, it never touches a body.

Create a private journal entry. Only entry.title is required; include entryDate (YYYY-MM-DD), kind, mood, energy (1-5), body, gratitude lines, and tags when the user provides them, e.g. an evening reflection with mood "good" and energy 4.

{
  "entry": {
    "title": "Quiet Saturday",
    "body": "Slow morning, long walk by the lake.",
    "entryDate": "2026-09-26",
    "kind": "daily",
    "mood": "good"
  }
}

Update selected fields of one journal entry, e.g. { entryId, patch: { favorite: true } }. Only include the fields being changed; everything else is preserved.

{
  "entryId": "je_quiet_sat",
  "patch": {
    "mood": "great",
    "favorite": true
  }
}

Delete one journal entry by ID (soft delete). Use only for explicit deletion requests.