Kraut

Add a product to a list by name. For a generic name ("Butter", "milk") it adds the matching product the user buys most, from their purchase history, and says which; otherwise the product they already have with that name, or a new one. Pass the product name as the user would say it, with the brand when it matters ("Kerrygold Butter"); exact: true only when the user wants a new or differently named product. Use list name or id.

add_item

Add several products to one list in a single call, e.g. a recipe's ingredients or "eggs, milk and bread". Use this instead of repeated add_item calls whenever there is more than one product. Each item works like add_item: a generic name adds the matching product the user buys most, a brand narrows it ("Kerrygold Butter"), exact: true adds the name as given. Returns one line per item.

add_items

Create a new shopping list with the given name.

create_list

Look up the items on a list for your own use: to answer a question about the list, or to find an item before removing or checking it off. Not for displaying the list: when the user asks to see, show or look at a list, call show_list instead. Use list name or id (from get_lists; "today" works). Each item comes with its category emoji and, where Kraut has one, the URL of Kraut's own product photo.

get_list_items

When, how much, where (shop name and address) and by whom products were bought. Use for questions like "when did I last buy milk and where?" or "what did I buy at Rewe last month?". Pass product to search names, brands and categories (German or English, e.g. "Milch" or "milk"); store to filter by chain across all its branches ("Rewe", "Edeka", "Whole Foods"); since for a start date. Omit both product and store for the latest purchases. Dates are ISO 8601 in UTC.

get_purchase_history

List all of the user's lists with item counts. Marks the user's TODAY list (the one the Kraut app shows as today's shopping list), saved lists and the purchase history. Call this first to resolve list names.

get_lists

Used by the Kraut list card: details of one item (photo, who added it, recent purchases with shop and buyer, product page).

get_item_details

Mark an item as purchased: records the purchase and adds it to purchase history. Use the list and item name; add the brand when several items share a name. If a name fits several different items nothing is changed and the answer lists them.

purchase_item

Used by the Kraut list card: one page of a list's items ("Show more"), and the first page again after a change.

get_list_page

First step for removing several items from a list, or emptying it ("remove all items", "empty my shopping list"): shows what would be removed and returns a confirmation code. Removes nothing. Show the preview to the user and ask them to confirm, then call remove_items with the same arguments and the code. For a single item use remove_item.

preview_remove_items