Gifts

Read Gifts: search gifts newest first by recipient (personId), occasion, status or direction, one gift by id with its full notes, type 'occasion' for occasions (one by id with its progress), or type 'profile' with personId for a person's gift profile. ALWAYS pass from/to (on the given date, or the occasion date) when the question concerns a period: 'what did I give Mom last year' is personId + from/to.

Note: personId with from/to answers 'what did I give Mom last year'; a person named alone also returns their gift profile.

{
  "personId": "person_mom",
  "from": "2025-01-01",
  "to": "2025-12-31"
}

Add a gift (a title; recipients, occasion, status, price and link when the user gives them), an occasion (type 'occasion': a title, date, kind) or a person's gift profile (type 'profile', personId). To change a gift already on file (its status: bought, wrapped, given), use gifts_change. Never invent a price or status.

{
  "record": {
    "title": "Le Creuset dutch oven",
    "recipientPersonIds": [
      "person_mom"
    ],
    "occasion": "Mom's birthday",
    "status": "idea",
    "priceCents": 38000,
    "currency": "USD"
  }
}

Change a gift by record.id: a new status moves it along the pipeline (idea → planned → purchased → wrapped → given, or skipped; purchased and given stamp their date), other sent fields merge. type 'occasion' or 'profile' edits those. Resolve the id with gifts_find first.

Note: interests, favoriteBrands, avoid and recipientPersonIds replace the stored lists; read first and send the full list.

{
  "record": {
    "id": "gift_dutch_oven",
    "status": "purchased"
  }
}

Permanently delete a gift, or (type 'occasion') an occasion, whose gifts are kept with their occasion link cleared. Only for explicit removal requests; resolve the id with gifts_find first.

Note: type 'occasion' deletes an occasion; its gifts are kept.