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"). To REPLACE an item with another variant ("the 5% one"), remove it and add brand plus the distinguishing words ("Fage 5%") without exact, so the variant the user already has is found. Before creating a new product it checks for products of the same brand the user has bought: if there are any, nothing is added and the answer lists them; pick one by its name, or use new_product: true only after the user confirms they want a new one. 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"), and an item whose brand the user already has in other variants is not created but listed (see add_item). 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

Answers QUESTIONS about purchases in text; to SHOW purchases to the user ("show me what I bought on September 19", "show my purchases from last week"), call show_list with the purchase history and since/until instead, which renders a card. 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 and until for a date range (a plain date in until covers that whole day; since and until on the same date = that day). Omit product and store for the latest purchases, or with since/until for everything bought in that range. When the answer says it shows the newest N of more, raise limit or narrow the dates. 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. When the user says where they bought it, pass store (chain plus street, postcode or city); it must be one of their places (a store they bought at or selected in the Kraut app). If the store fits none or several, nothing is changed and the answer lists their stores of that chain with addresses: call again with the right street or postcode (you may know which postcode a district has), or ask the user.

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