Meals

The Meals domain handles the full loop — from planning to plating. It manages your family's dietary preferences, weekly meal plans, recipes, grocery list generation, grocery ordering, kitchen inventory, and feedback loops. When your assistant uses Fluent, it can work from what you like, what's in the fridge, what your family can eat, and what to order — without asking the same questions twice.

What Meals Knows

• Preferences: Dietary restrictions, household size, cooking style, cuisine preferences
• Meal plans: Weekly plans with per-day and per-meal detail
• Recipes: Your personal recipe library with ingredients, instructions, and metadata
• Inventory: What is currently in your kitchen, with freshness and quantity tracking
• Grocery plans: Generated shopping lists reconciled against current inventory
• Feedback: Meal ratings, notes, and memory of what worked and what did not

Key Workflows

Weekly Meal Planning

The hosted planning loop:

1. Read current context and preferences
2. meals_generate_plan -- Fluent generates a candidate plan
3. Review and adjust the candidate with your assistant
4. meals_accept_plan_candidate -- lock in the plan
5. meals_generate_grocery_plan -- build the shopping list

"Plan my meals for next week"
"I want more vegetarian options this week"
"Replace Thursday's dinner with something quicker"

Recipe Management

Create, update, and browse your personal recipe collection. Recipes are linked to meal plans and grocery list generation.

"Save this recipe for chicken tikka masala"
"What recipes do I have that use lentils?"
"Update the pasta recipe -- I use less salt now"

Grocery, Ordering, and Inventory

Fluent generates grocery plans by diffing what a meal plan needs against what you already have in inventory. When you're ready to order, meals_prepare_order reconciles current inventory into an order-ready artifact that can drive retailer cart automation. Fluent also tracks brand preferences, so your grocery list reflects the brands you actually buy.

"What do I need to buy for next week?"
"Order the groceries for this week's plan"
"I just bought milk and eggs -- update my inventory"
"What's in my pantry right now?"

Feedback and Memory

Log feedback on meals you have cooked. Fluent remembers what you liked, what you would skip, and uses that context in future planning.

"That stir fry was great, log it as a keeper"
"I didn't love the soup -- too bland"
"What meals have I rated highest?"

Meals Tools

Tool	Purpose
meals_get_preferences	Read dietary preferences
meals_update_preferences	Update preferences
meals_get_plan	Get the current or a specific week's plan
meals_list_plan_history	Browse past meal plans
meals_get_day_plan	Single day's meal detail
meals_get_today_context	Today's meals and context
meals_generate_plan	Generate a candidate meal plan
meals_accept_plan_candidate	Accept and lock a generated plan
meals_upsert_plan	Directly create or update a plan
meals_create_recipe	Add a new recipe
meals_patch_recipe	Update an existing recipe
meals_get_recipe	Read a recipe
meals_list_recipes	Browse the recipe library
meals_get_inventory	Full kitchen inventory
meals_get_inventory_summary	Inventory overview
meals_update_inventory	Add or update inventory items
meals_update_inventory_batch	Bulk inventory updates
meals_delete_inventory_item	Remove a stale inventory item
meals_generate_grocery_plan	Build a shopping list for a plan
meals_get_grocery_plan	Read the grocery plan
meals_prepare_order	Reconcile inventory into order-ready list
meals_log_feedback	Rate and comment on a meal
meals_list_feedback	Browse feedback history
meals_mark_meal_cooked	Mark a planned meal as cooked
meals_get_meal_memory	Aggregated meal memory
meals_list_tools	Eager fallback tool directory
meals_record_plan_review	Record a weekly plan review
meals_list_grocery_plan_actions	Read grocery plan action state
meals_upsert_grocery_plan_action	Write pantry confirmations or purchase records
meals_delete_grocery_plan_action	Remove a grocery plan action
meals_list_grocery_intents	Read grocery intents
meals_upsert_grocery_intent	Write a grocery intent
meals_delete_grocery_intent	Remove a grocery intent

Meals Resources

Resource	Purpose
fluent://meals/current-plan	This week's meal plan
fluent://meals/preferences	Dietary preferences
fluent://meals/inventory	Kitchen inventory
fluent://meals/plans/{week_start}	Specific week's plan
fluent://meals/recipes/{recipe_id}	Single recipe
fluent://meals/grocery-plan/{week_start}	Grocery plan for a week
fluent://meals/confirmed-order-sync/{retailer}/{retailer_order_id}	Confirmed order sync

Onboarding

Meals onboarding collects your core preferences:

1. Enable the meals domain
2. Set dietary preferences (restrictions, household size, cooking style)
3. Complete onboarding

The domain moves to ready and the full planning surface is available.

Training-Aware Planning

When the Health domain is also active, Meals can consume Health's trainingSupportSummary to adjust macronutrient targets and portion guidance. Health owns the training structure; Meals owns the food execution.