add_calendar_custom_meals
ChatGPTAdd named meals such as Ordering out or Leftovers on explicit local YYYY-MM-DD dates, with optional meal notes, period codes and ordering anchors. Pair non-null beforeEntryId with expectedBeforeRevision. A label creates no recipe, groceries or cooked inventory. Sign-in and edit access required. Use current revisions and full linked acknowledgments. One requestKey per atomic call; after uncertainty read get_meal_calendar_operation or retry identical arguments/key. Never truncate linked groups to fit limits.
add_calendar_recipe_meals
ChatGPTAdd recipe meals on explicit local YYYY-MM-DD dates, with optional mealPeriod codes and ordering anchors. Pair non-null beforeEntryId with expectedBeforeRevision. Use recipeId from recipe results and explicit servings for an unknown yield. Before placing your private recipe on a shared Calendar, explain that current collaborators can read/cook it. No groceries are created. Sign-in and edit access required. Use current revisions and full linked acknowledgments. One requestKey per atomic call; after uncertainty read get_meal_calendar_operation or retry identical arguments/key. Never truncate linked groups to fit limits.
add_to_basket
ChatGPTAdd one thing to a basket: a published bundle (bundleId, copied as a group of its recipes), a recipe (recipeId, at its designed servings unless servings is given), an ingredient item (ingredient: a catalog name from search_ingredient_names and an amount), a product item (product: a reference from search_products, and packages) or a sent basket to shop again (reopenBasketId, signed in). Give exactly one. Adding what is already in the basket returns the existing entry; anotherCopy true with the basket's revision adds a second copy of a recipe on purpose. It goes to the current basket, or to basketId. newBasket starts a new named basket for a separate trip (signed in, with basketId and revision from the latest summary; a repeat of the same request returns the basket already made); a shopper may keep a limited number of open baskets. Without sign-in, the first bundle or recipe creates the guest basket and returns its basketHandle; items and a product need a basket that exists. A guest has one basket. Combine bundles and recipes that share products, then items for the rest; suggest_for_basket use_unused_portions finds recipes that use up unused product portions. Every result says whether the change was applied, already in effect or not applied, and returns the basket summary.
choose_checkout_brand
ChatGPTImmediately remember an explicitly selected available checkoutBannerKey in the signed-in shopper’s account. Changes only that preference: creates no review, sends no groceries and changes no products, quantities, estimates or stores. Physical stores and captured reviews keep their own retailer. Pass accountContext from the signed-in get_checkout_brand result to reject a changed account before writing. Use get_checkout_brand to read availability first, and prepare_kroger_send only when the shopper requests a review.
choose_kroger_store
ChatGPTSet the Kroger store one basket is priced at (storeHandle from find_kroger_stores), for the current basket or basketId. Only that basket starts checking prices and availability at the store, and a different store is also remembered as the shopper's store. recheck true, or naming the basket's own store, checks again a basket that was matched at another store or whose checks could not finish. Nothing is sent to Kroger. The result is the basket summary; it never waits for the checks, so read it again with get_basket while it says checking. A guest needs a basket first.
choose_recipe_product
ChatGPTChoose a catalog product for one private ingredient occurrence on the user's behalf. Community suggestions require this explicit choice. Pass productRef from a product search or recipe result, or null to clear the explicit choice. An optional packageCount authorizes buying packages without claiming a culinary conversion. Choices are remembered for the complete declared purchasing intent by default. This choice is attributed to the agent and is never promoted to a system AI approval. Use the latest contentRevision as expectedRevision. Then add the recipeId to a basket to see prices, availability and any remaining quantity gaps at the chosen store.
copy_calendar_day_notes
ChatGPTCopy current day notes to explicit local YYYY-MM-DD dates, replacing an existing target note when its current ID/revision is provided. Use the source note ID/revision. A new target uses targetExpectedRevision 0 without dayNoteId only after a complete target-date read confirms absence. Meal notes are not copied. Sign-in and edit access required. Use current revisions and full linked acknowledgments. One requestKey per atomic call; after uncertainty read get_meal_calendar_operation or retry identical arguments/key. Never truncate linked groups to fit limits.
copy_calendar_meals
ChatGPTCopy meals to explicit local YYYY-MM-DD dates. Each occurrence contains one complete linked source graph with each source entry used once; repeat the graph on several dates using separate occurrences in this one atomic call. Read current linked context and acknowledge all related entries. Copies add meals and preserve originals; no automatic future scheduling or day-note copying. Sign-in and edit access required. Use current revisions and full linked acknowledgments. One requestKey per atomic call; after uncertainty read get_meal_calendar_operation or retry identical arguments/key. Never truncate linked groups to fit limits.
create_meal_calendar
ChatGPTExplicitly create your one personal meal Calendar, or recover the same Calendar if it already exists. Needs sign-in. This schedules no meals and changes no sharing.
create_recipe_box_folder
ChatGPTCreate an empty Recipe Box folder with a name for the signed-in user. If they already have a folder with that name (ignoring case and extra spaces), that folder is returned and nothing is created. Returns the folderRef.
edit_calendar_meals
ChatGPTReplace current meal components/servings, labels, meal notes or period codes. Include a changed detail. Each component needs componentId or recipeId. A null note clears it; retained componentId without recipeId preserves the existing recipe and omitted quantity. Period-only edits preserve ordering. Use move_calendar_meals for dates/order. Read complete linked context and acknowledge every related entry, including note-only edits; detachConsumers is an explicit decision. Sign-in and edit access required. Use current revisions and full linked acknowledgments. One requestKey per atomic call; after uncertainty read get_meal_calendar_operation or retry identical arguments/key. Never truncate linked groups to fit limits.
find_kroger_stores
ChatGPTSearch for Kroger-family stores near a ZIP code or a location. Changes nothing in the user's account. Returns storeHandle values for choose_kroger_store. Without sign-in, pass the basketHandle of your guest basket (a store search is charged to it).
get_basket
ChatGPTRead one PlumTally basket: its recipes and items, the store and whether prices are the store's or catalog estimates, the total, utilization, the meals covered when people is given, problems with ready fixes, the largest unused product portions and what is ready to send. Signed in, it also lists the shopper's open and sending baskets (id, name, state, store, entries); name one by basketId or read the current basket. Without sign-in, pass the basketHandle from your last basket result; with no handle there is no basket yet and nothing is created. account true asks for the baskets saved in a PlumTally account and gives the sign-in challenge to a caller who is not signed in. fullList true adds every shopping-list line with its reference, packages, price, availability and why it is there, and the saved exclusions. A read starts no store check and never moves a guest basket into an account.
get_basket_history
ChatGPTRead the signed-in shopper's sent, partly sent and not sent baskets and the sends still under way, quick sends included, newest first, 20 a page. A send under way carries the reviewHandle that continues it with send_to_kroger. Pass a basketId from a row to read that send in full (its items and what happened to each). To shop a sent basket again, call add_to_basket with reopenBasketId set to its id. Needs sign-in.
get_checkout_brand
ChatGPTRead the checkout retailer for one basket, recipe or published bundle before preparing its groceries. Returns public availability and the effective retailer; a physical store fixes its retailer. Signed-out reads never expose account preferences. Creates no review and changes nothing.
get_kroger_send_status
ChatGPTRead a Kroger review's status, progress and cart link; never sends. After retryable:false, sending does not authorize retry; wait for a new user request.
get_meal_bundle
ChatGPTRead one published PlumTally meal bundle: its meals, servings, typical grocery cost and the ingredients it assumes you already have.
get_meal_calendar
ChatGPTRead a Calendar range using explicit YYYY-MM-DD local startDate/endDate (inclusive, at most 93 days), or pass entryId instead to read that meal and its complete linked preparation context, including dates outside the range. Needs sign-in and current access. Each range page returns nextCursor; do not call a partial page the complete Calendar. Reads never create or schedule. For cooking a scheduled private recipe use get_recipe with this calendarRef and entryId. Create a missing Calendar with create_meal_calendar.
get_meal_calendar_operation
ChatGPTRecover an accepted Calendar change by calendarRef and exact requestKey. Changes nothing. Receipt 404 does not prove an uncertain write failed; retry only unchanged arguments/key, never a new key.
get_meal_calendars
ChatGPTDiscover your personal meal Calendar and Calendars already shared with you, with current permissions and supported meal-period codes. Needs sign-in. Changes nothing and never creates a Calendar. Follow nextCursor for more shared Calendars.
get_recipe
ChatGPTRead one PlumTally recipe: ingredients, steps, servings and times.
get_recipe_box
ChatGPTRead the signed-in user's Recipe Box: their folders of saved recipes and bundles (their own, and ones shared with them to edit). Without folder or folderRef it lists the folders, each with a folderRef. With one of them it lists what that folder holds, newest first; searchTerm keeps only the recipes and bundles whose name contains that exact text, ignoring case (not each word separately). Name the folder with folder (matched ignoring case and extra spaces), or pass a folderRef from an earlier result. When several folders share a name, nothing is read: every match is listed and you choose by folderRef. Changes nothing.
get_recipe_submission_status
ChatGPTRead your private submission. Show clarification, limits and corrections; poll while processing. Saved recipeId opens from Recipe Box.
move_calendar_meals
ChatGPTMove/reorder selected meals as one group to explicit local YYYY-MM-DD dates, optionally changing components/servings or period codes. Each component needs componentId or recipeId. Pair non-null beforeEntryId with expectedBeforeRevision. A missing/null beforeEntryId appends at the destination, including on the same date. Meal notes move with meals; day notes stay on their dates. Preserve the complete linked graph and acknowledge related entries; detaching consumers requires explicit detachConsumers. Sign-in and edit access required. Use current revisions and full linked acknowledgments. One requestKey per atomic call; after uncertainty read get_meal_calendar_operation or retry identical arguments/key. Never truncate linked groups to fit limits.
place_calendar_bundle_meals
ChatGPTAdd selected recipes from published bundles to explicit local YYYY-MM-DD dates, with explicit servings and optional meal-period codes. Use bundleId, sourceRevision and authorityVersion from current get_meal_bundle calendarSource and a recipeId from that bundle. A stale source is refused. This adds alongside existing meals and changes no basket or shopping choices. Sign-in and edit access required. Use current revisions and full linked acknowledgments. One requestKey per atomic call; after uncertainty read get_meal_calendar_operation or retry identical arguments/key. Never truncate linked groups to fit limits.
plan_meals
ChatGPTPlan recipes that share groceries for the people, days and meal periods asked for, within a grocery budget, a cooking time and a diet, and set them as the basket's "Your plan" group at each recipe's designed servings. Works without sign-in. days times mealPeriods is the number of meals, at most 35. people is servings per meal (signed in, it defaults to the profile household size); a recipe is picked only if it feeds that many people at one meal, and its extra servings are planned as leftover meals later in the plan (the result marks them). Running it again replaces the earlier plan in that basket; keepBoth true (with the basket's revision) keeps both plans. It goes to the current basket, to basketId, or, signed in, into a new named basket (newBasket, with basketId and revision from the latest summary). budgetUsd, maxMinutes, diet and exclude are hard limits: when no set of recipes meets them, outcome is infeasible (or refused, timed_out) with the reason, nothing is changed and nothing is relaxed. exclude.primaryProteins removes recipes whose reviewed main protein is one of those codes (and recipes whose main protein cannot be verified); it proves nothing about other ingredients and is not an allergen guarantee. exclude.ingredients removes recipes that call for a catalog ingredient of that exact name; use names from search_ingredient_names or that the user typed. An unknown name is refused, never guessed. Foods the user already asked to exclude apply to every plan, swap and suggestion; the plan's exclude entries are added to that saved list once the plan is saved (the result says remembered), so do not repeat them. To take an entry off the saved list use update_basket exclusions.remove. avoid lists other foods to avoid; they are not checked and come back in notHonoured. Prices are PlumTally's catalog estimate until a Kroger store is chosen for the basket. Without sign-in the first plan creates the guest basket and returns a basketHandle; pass it on every later basket call.
prepare_kroger_send
ChatGPTPrepare (without sending) the user's basket for their Kroger cart: creates a review in their PlumTally account. Needs sign-in; a guest basket moves into the account here, and the result says so before the user confirms. It reviews the current basket or basketId, or, for a quick send that writes nothing to any basket, one recipeId or bundleId priced at the remembered store. Returns the items and estimated total for the user to confirm, and a reviewHandle for send_to_kroger. An unchanged basket returns the review already prepared, a changed one gets a new review, and a basket that is already being sent returns that send. Problems on the basket never block sending. priceBasis planning_estimate means the prices are PlumTally's catalog estimate saved with the review: they can differ from the basket's store prices, and Kroger confirms the final prices.
remove_calendar_meals
ChatGPTRemove selected current Calendar meals together. Include the complete linked preparation graph to remove it without detaching consumers, or explicitly choose detachConsumers where required. Read full linked context and acknowledge every related entry. For a replacement, add/place the replacement first; remove the original only after that succeeds. Sign-in and edit access required. Use current revisions and full linked acknowledgments. One requestKey per atomic call; after uncertainty read get_meal_calendar_operation or retry identical arguments/key. Never truncate linked groups to fit limits.
remove_from_basket
ChatGPTRemove something from a basket: an entry (entry: its ref from the summary; a bundle group, a loose recipe or an item), one recipe inside a group (recipe: its ref), or, only when the shopper asks, a whole open basket (deleteBasket true with its basketId, never the current basket by default). Deleting a basket is permanent and is not kept in history. Removing something already gone returns the current summary. Give exactly one of entry, recipe or deleteBasket.
remove_from_recipe_box
ChatGPTRemove a recipe (recipeId) or a bundle (bundleId) from a Recipe Box folder of the signed-in user. The recipe or bundle itself is not deleted and stays in the user's other folders. The folder must already exist: this never creates one. If several folders share the name, nothing is removed and the matches are listed; choose by folderRef.
save_private_recipe
ChatGPTCreate, upload as JSON, import or edit your own private recipe. No PlumTally AI calls are started. Accepts structured recipe JSON, a PlumTally recipe export, or schema.org Recipe JSON. You may extract uploaded text yourself; this tool does not fetch URLs or read images/PDFs. Structured format: {title, description?, servings?, ingredients:[{text, lineId?, ingredientId?, quantity?, unitId?, optional?, purchasingIntent?, profileRef?}], instructions:[string], source?:{url?,attribution?}}. Preserve raw ingredient text and unknown amounts. Quantities accept exact fraction strings. Use search_recipe_ingredients to bind catalog ingredients/units and select an applicable complete purchasing-intent profile. A profile must capture all recipe-context restrictions; the same ingredient name alone does not establish compatibility. Omit recipeId to create. To edit the same recipe, pass its latest contentRevision as expectedRevision and keep lineId for each retained occurrence, including duplicates. A multi-recipe upload returns selection indexes. Only the selected base recipe is imported. Saves to My Recipes unless folderRef names your own folder. Missing matches, units or quantities do not block saving. Follow returned problems and use search_recipe_products/choose_recipe_product to repair shopping coverage.
save_to_recipe_box
ChatGPTSave a recipe (recipeId) or a bundle (bundleId) to a Recipe Box folder of the signed-in user. Name the folder with folder, matched ignoring case and extra spaces; when the user has no folder with that name, one is created in the same call and the result says so. Or pass a folderRef from an earlier result to use that exact folder. Saving a bundle to a folder is how a user keeps or follows it. Saving something the folder already holds changes nothing. The result names the folder used.
search_ingredient_names
ChatGPTLook up the exact PlumTally ingredient names that contain a word, for plan_meals exclude.ingredients. term matches whole words: "pork" finds "ground pork" and "pork chops", not "porcini". Query any words the user's food might go by (bacon, ham, sausage, ground). Returns names only; submit a name exactly as returned.
search_meal_bundles
ChatGPTFind published PlumTally meal bundles: sets of recipes planned together so they share groceries. Without a query, returns the newest bundles. Returns bundle ids for get_meal_bundle. To find bundles that use most of what a shopper buys, pass sort "highest_utilization" (utilizationPercent is the share of the estimated grocery total that the meals use) and optionally minUtilizationPercent; sort "lowest_cost", "lowest_cost_per_serving", "most_servings" or "shortest_time" rank by those. maxTotalUsd, maxPerServingUsd, minServings, maxServings, maxTotalMinutes, maxMinutesPerMeal, minMeals, maxMeals, diet and exclude are hard filters. A bundle whose estimate is incomplete has null utilizationPercent, cost and time: it sorts after bundles with a value and never matches a filter on that value. Prices and utilization are PlumTally catalog estimates computed at estimatedAsOf, not a store's prices; estimateState says whether a recompute is pending. The shopper's saved exclusions apply by default, together with any exclude you pass, and the result says how many were applied. Signed in they come from the account; without sign-in pass basketHandle. exclude works as in plan_meals and is not an allergen guarantee. Use the same cursor only with the same sort and filters.
search_products
ChatGPTSearch Kroger's product catalog by words, with no store and no basket, to find a product to add as a product item (add_to_basket product). This is a different tool from the earlier search_products that searched one grocery list's store for extras; that behaviour is gone. Results carry a product reference and no store price; prices and availability appear once the basket has a store. Signed in, or with the basketHandle of a guest basket; with neither there is nothing to charge the search to and it returns no products.
search_recipe_ingredients
ChatGPTFind existing catalog ingredients and measurement units for a private recipe. Purchasing-intent profiles come only from public recipes or your own recipes. Select a profile only when its complete preparation, form, state, measurement meaning, dietary restrictions and context requirements fit this occurrence; an agent selection is not a new PlumTally AI approval.
search_recipe_products
ChatGPTSearch our database or the provider catalog for a private ingredient occurrence, even when it has no ingredient binding or match. The search is store independent unless storeLocationId is explicitly supplied. Results are catalog suggestions, not semantic approvals. Choose one using choose_recipe_product.
search_recipes
ChatGPTSearch PlumTally recipes by name, ingredient, cuisine, meal or diet words. Returns recipe ids for get_recipe. Optional filters narrow the results, and every filter given must hold: diet (every listed diet; only a recipe's main version is matched), maxTotalMinutes (longest total time; a recipe with no recorded time is not excluded), mealPeriods (any one of them), maxTotalUsd (most the recipe's groceries may cost, a catalog estimate) and exclude.ingredients (catalog ingredient names no recipe may call for; use names from search_ingredient_names or that the user typed; an unknown name is refused, never guessed). exclude.ingredients does not exclude by main protein and is not an allergen guarantee: use search_meal_bundles or plan_meals to exclude a main protein. Use the same cursor only with the same query and filters.
send_feedback
ChatGPTSubmit feedback to PlumTally only when the user explicitly asks you to send it. Never call automatically, invite feedback at session end, or conceal the submission. Send the requested user feedback or requested agent observations, marked by source; do not invent a human rating. Omit secrets and unrelated personal details. Stored: the text, source, optional rating/tool, category, host, Agent Guide version, UTC day and originating session link. New feedback expires after 180 UTC days. Signed-in feedback is linked to the account through its session and deleted on account deletion; Muse feedback is also deleted when its connection ends, including replacement. Signed-out feedback has no account link and is removed only by expiry.
send_to_kroger
ChatGPTAdd reviewed groceries to the user's Kroger cart (reviewHandle from prepare_kroger_send), only after confirmation of items and total. sent includes the cart link; sending resumes with the same reviewHandle unless retryable:false: stop even if status is sending; retry only on a later user request after resolution. changed: prepare again; kroger_link_required: follow its instructions. Kroger has one cart per account; sends add up before checkout.
set_calendar_day_notes
ChatGPTSet, replace or clear notes on explicit local YYYY-MM-DD dates; null clears a note. Creating uses expectedRevision 0 without dayNoteId only after a complete current date read confirms no note. Editing/clearing an existing note requires its ID and positive current revision. Day notes stay on dates, separate from meal notes. Sign-in and edit access required. Use current revisions and full linked acknowledgments. One requestKey per atomic call; after uncertainty read get_meal_calendar_operation or retry identical arguments/key. Never truncate linked groups to fit limits.
submit_recipe_text
ChatGPTComplete and review one pasted recipe, then save privately. Sign-in required. Retry with the same requestKey; poll get_recipe_submission_status. Daily UTC limits apply. Structured saves without AI: save_private_recipe.
suggest_for_basket
ChatGPTSuggestions over a whole basket, computed only when asked and never added or changed by themselves; figures are catalog estimates. kind use_unused_portions finds recipes that use up the basket's unused product portions (product narrows it to one); swap_recipe finds replacements for one recipe (recipe: its ref); cheaper finds replacements that cost less per serving; swap_product finds other products for one shopping-list line (line: its ref from get_basket with fullList). They never conflict with the shopper's saved exclusions. Each suggestion carries the call that applies it.
update_basket
ChatGPTChange a basket to a target state; each change says whether it was applied, already in effect or not applied, and the result is the basket summary. servings sets a recipe's whole servings (recipe is its ref from the summary); amounts sets an item's amount (entry is its ref); alreadyHave marks a shopping-list line (ref from get_basket with fullList) as already have this time, or back to buy; products picks a product for a line (product from search_products or a swap list); always saves "I always have" or "I always need" for the line's ingredient to the pantry (have, need or none; signed in; applies to every basket): alreadyHave for this trip, always for a staple the shopper keeps. exclusions.add and exclusions.remove change the shopper's saved exclusions one named entry at a time, which apply to bundle search, plans and suggestions; adding one never drops another. rename renames the basket (a guest may rename its one basket); makeCurrent true makes a basket the current one (signed in; only an open basket can be current). swap replaces one recipe with another in place (recipe ref, replaceWith recipe id, and the basket's revision); do it in its own call. Several shoppers' changes in one call apply in order.