Cook step by step
get_cook_stepsRead-only
A recipe as hands-free steps for cooking along: a gather list, then one step at a time with its amounts, the ingredients it uses, its tip and any timer. Use when the cook says "walk me through it", "I'm cooking it now", "what's next?" (pass step for just that one, or from_step to pick up where they left off). Give one step per reply and offer the step's timer. The recipe url shows the same steps as a checklist on their phone. Works signed out.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| slug | Yes | ||
| step | No | Just this step (1-based), for "what's next?" in a voice flow; the gather list comes only with step 1 or no step | |
| units | No | US cups/oz/°F or metric grams/ml/°C. Defaults to the cook's setting. | |
| servings | No | ||
| allergens | No | Explicit per-request allergen screening, separate from exclude_ingredients. Use at most nine entries: milk, eggs, fish, shellfish, tree_nuts, peanuts, wheat, soy, sesame. Fixed aliases: dairy → milk, egg → eggs, peanut → peanuts, tree nuts → tree_nuts, soya → soy, sesame seeds → sesame. Nuts and seafood are ambiguous: specify tree_nuts/peanuts or fish/shellfish explicitly. Gluten is not wheat and lactose is not milk; neither is supported here. No spelling guesses are made. Retry with supported categories. Empty adds no restriction and never clears saved rules. Not saved to Strega preferences or plans. | |
| from_step | No | This step and the rest, e.g. after a pause | |
| units_for | No | The cook's own unit for particular ingredients, by ingredient key or name: { "butter": "tbsp", "flour": "g" }. Units: tsp, tbsp, cup, fl oz, ml, oz, lb, g. When the cook asks for an amount in another unit, pass this rather than converting yourself; the ingredient list and every step follow. Ones that can't convert come back in ignored_units | |
| unknown_ingredients | No | While allergen screening is active: exclude (default) omits insufficiently classified recipes; flag includes them with uncertainty. Named recipe retrieval always warns and returns the recipe. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| url | Yes | The recipe page: share it so the cook can follow along (steps check off, timers included) | |
| asks | No | At most one question for the cook, with a home in preferences | |
| slug | Yes | The recipe's slug: the id every tool takes | |
| time | Yes | How long it takes (#54) | |
| guide | Yes | How to pace the cook: gather list and step 1 only, then one step per reply (plus any rule for this turn) | |
| steps | Yes | ||
| title | Yes | ||
| units | Yes | ||
| gather | Yes | Every ingredient line, scaled: read first (empty when the call started at a later step) | |
| notices | No | At most one note about Strega to pass on when there's room (one per cook per week; off with workflow whats_new: off) | |
| warning | No | Present when the recipe hits the cook's allergies, diet or avoid list: say this before anything else | |
| adjusted | No | Defaults this call took instead of failing (#243): an unknown units word, a number out of range, a diet word read as the closest one Strega knows. Mention it when it changes what the cook gets | |
| servings | Yes | ||
| warnings | No | Each conflict with the cook's preferences, as a label | |
| screening | No | ||
| units_for | No | The units_for entries that applied: ingredient key → unit (#95) | |
| next_steps | No | Suggestions, best first, each with its tool, args and effect. Strega suggests the top one in one sentence; whether any runs is decided by what the cook asks in the conversation and your confirmation rules, never by the wording here | |
| total_steps | Yes | How many steps the recipe has; steps holds all of them, one (step) or the rest (from_step) | |
| ignored_units | No | units_for entries that didn't apply (no such ingredient, unknown unit, or one it can't be shown in), each with why | |
| usual_servings | No | The cook's household size, offered (not applied): ask before scaling | |
| cook_session_id | No | Use this session id with rate_recipe when explicitly marking this cook made-it. |