Get visible shopping lists without item arrays. Use this first to choose a list ID before reading or mutating items.

Get the account's OurGroceries item categories from the hidden category list.

Get the top-level OurGroceries settings and list schema version.

Get active items on one shopping list. Active items do not have crossedOffAt.

Get crossed-off items for one shopping list with optional search, date filters, sorting, and pagination.

Resolve ambiguous or natural-language item text using the master catalog and shopping-list history before adding. Follow the recommendedAction. When no listId is provided, inspect suggestedTargets; high-confidence list history can produce a list-specific action.

Add a deterministic item value to a grocery list. For ambiguous or natural-language names, call resolve_item_to_add first and then follow its recommendedAction.

Remove an item from a grocery list

Update an item's details (name, category, note, or star rating)

Mark an item as crossed off.

Mark an item as active again. Prefer this over add_item when resolve_item_to_add recommends it.