mcp-grocy 2.2.0 → 2.5.0

package/build/tools/recipes/definitions.js

@@ -1,9 +1,11 @@
 import { config } from '../../config/index.js';
+const RECIPES_COOKING_COMPLETE_TOOL = 'recipes_cooking_complete';
 export const recipeToolDefinitions = [
     // ==================== RECIPE MANAGEMENT ====================
     {
         name: 'recipes_management_get',
-        description: '[RECIPES/MANAGEMENT] Get specific fields for all recipes from your Grocy instance. You must specify which fields to retrieve.',
+        description: '[RECIPES/MANAGEMENT] **List/search many recipes**—you choose which fields (e.g. id+name). For one full recipe by ID use recipes_management_get_by_id.',
+        annotations: { readOnlyHint: true },
         inputSchema: {
             type: 'object',
             properties: {
@@ -11,27 +13,39 @@ export const recipeToolDefinitions = [
                     type: 'array',
                     items: {
                         type: 'string',
-                        enum: ['id', 'name', 'description', 'base_servings', 'desired_servings', 'not_check_shoppinglist', 'type', 'picture_file_name', 'ingredients', 'instructions']
+                        enum: [
+                            'id',
+                            'name',
+                            'description',
+                            'base_servings',
+                            'desired_servings',
+                            'not_check_shoppinglist',
+                            'type',
+                            'picture_file_name',
+                            'ingredients',
+                            'instructions',
+                        ],
                     },
-                    description: 'Array of field names to retrieve. For basic lookup use ["id", "name"]. For recipe planning use ["id", "name", "description", "base_servings"]. Available fields: id, name, description, base_servings, desired_servings, not_check_shoppinglist, type, picture_file_name, ingredients, instructions'
-                }
+                    description: 'Array of field names to retrieve. For basic lookup use ["id", "name"]. For recipe planning use ["id", "name", "description", "base_servings"]. Available fields: id, name, description, base_servings, desired_servings, not_check_shoppinglist, type, picture_file_name, ingredients, instructions',
+                },
             },
-            required: ['fields']
-        }
+            required: ['fields'],
+        },
     },
     {
         name: 'recipes_management_get_by_id',
-        description: '[RECIPES/MANAGEMENT] Get a specific recipe by its ID from your Grocy instance.',
+        description: '[RECIPES/MANAGEMENT] **Single recipe** by recipeId (full record). To scan or filter many recipes use recipes_management_get with a fields list.',
+        annotations: { readOnlyHint: true },
         inputSchema: {
             type: 'object',
             properties: {
                 recipeId: {
                     type: 'number',
-                    description: 'ID of the recipe to retrieve. Use recipes_management_get tool to find the correct recipe ID by name.'
-                }
+                    description: 'ID of the recipe to retrieve. Use recipes_management_get tool to find the correct recipe ID by name.',
+                },
             },
-            required: ['recipeId']
-        }
+            required: ['recipeId'],
+        },
     },
     {
         name: 'recipes_management_create',
@@ -41,24 +55,24 @@ export const recipeToolDefinitions = [
             properties: {
                 name: {
                     type: 'string',
-                    description: 'Name of the recipe'
+                    description: 'Name of the recipe',
                 },
                 description: {
                     type: 'string',
-                    description: 'Description of the recipe (optional)'
+                    description: 'Description of the recipe (optional)',
                 },
                 baseServings: {
                     type: 'number',
                     description: 'Base servings for the recipe (e.g., 4 for a family recipe)',
-                    default: 1
+                    default: 1,
                 },
                 instructions: {
                     type: 'string',
-                    description: 'Recipe instructions (optional)'
-                }
+                    description: 'Recipe instructions (optional)',
+                },
             },
-            required: ['name']
-        }
+            required: ['name'],
+        },
     },
     {
         name: 'recipes_management_print_label',
@@ -68,93 +82,97 @@ export const recipeToolDefinitions = [
             properties: {
                 recipeId: {
                     type: 'number',
-                    description: 'ID of the recipe to print label for. Use recipes_management_get tool to find the correct recipe ID.'
-                }
+                    description: 'ID of the recipe to print label for. Use recipes_management_get tool to find the correct recipe ID.',
+                },
             },
-            required: ['recipeId']
-        }
+            required: ['recipeId'],
+        },
     },
     {
         name: 'recipes_fulfillment_get',
-        description: '[RECIPES/FULFILLMENT] Check fulfillment status for a specific recipe (what ingredients are available vs needed).',
+        description: '[RECIPES/FULFILLMENT] **Single recipe**—can I make this dish? Ingredient coverage vs stock for one recipeId. For an overview of many recipes at once use recipes_fulfillment_get_all.',
+        annotations: { readOnlyHint: true },
         inputSchema: {
             type: 'object',
             properties: {
                 recipeId: {
                     type: 'number',
-                    description: 'ID of the recipe to check fulfillment for. Use recipes_management_get tool to find the correct recipe ID by name.'
+                    description: 'ID of the recipe to check fulfillment for. Use recipes_management_get tool to find the correct recipe ID by name.',
                 },
                 onlyMissing: {
                     type: 'boolean',
                     description: 'If true, only return missing/insufficient ingredients',
-                    default: false
-                }
+                    default: false,
+                },
             },
-            required: ['recipeId']
-        }
+            required: ['recipeId'],
+        },
     },
     {
         name: 'recipes_fulfillment_get_all',
-        description: '[RECIPES/FULFILLMENT] Get fulfillment status for all recipes (overview of which recipes can be made with current stock).',
+        description: '[RECIPES/FULFILLMENT] **All recipes**—batch view of which recipes are makeable with current stock (no recipeId). For one named recipe use recipes_fulfillment_get.',
+        annotations: { readOnlyHint: true },
         inputSchema: {
             type: 'object',
             properties: {},
-            required: []
-        }
+            required: [],
+        },
     },
     // ==================== MEAL PLANNING ====================
     {
         name: 'recipes_mealplan_get',
         description: '[RECIPES/MEALPLAN] Get your meal plan data from Grocy instance with corresponding recipe details. Returns planned meals for the requested date plus surrounding days for context. Use this to find out what recipes/meals are planned for a specific date (e.g., "what\'s for dinner tomorrow", "recipes for today", "meal plan for next week"). The returned data includes the id field (meal plan entry ID) which can be used with recipes_mealplan_delete_entry.',
+        annotations: { readOnlyHint: true },
         inputSchema: {
             type: 'object',
             properties: {
                 date: {
                     type: 'string',
-                    description: 'Date in YYYY-MM-DD format (e.g., "2024-12-25"). The tool will return meal plans for this date plus the previous and next day for better context.'
+                    description: 'Date in YYYY-MM-DD format (e.g., "2024-12-25"). The tool will return meal plans for this date plus the previous and next day for better context.',
                 },
                 weekly: {
                     type: 'boolean',
-                    description: 'If true, returns the entire calendar week containing the specified date.'
-                }
+                    description: 'If true, returns the entire calendar week containing the specified date.',
+                },
             },
-            required: ['date']
-        }
+            required: ['date'],
+        },
     },
     {
         name: 'recipes_mealplan_get_sections',
-        description: '[RECIPES/MEALPLAN] Get all available meal plan sections from your Grocy instance (e.g., Breakfast, Lunch, Dinner, Snacks). Use this to find valid section IDs for recipes_mealplan_add_recipe.',
+        description: '[RECIPES/MEALPLAN] **Read-only:** list meal plan section names/IDs (Breakfast, Dinner, …). Does not return planned meals or dates—use recipes_mealplan_get for the calendar. Needed before recipes_mealplan_add_recipe to pick sectionId.',
+        annotations: { readOnlyHint: true },
         inputSchema: {
             type: 'object',
             properties: {},
-            required: []
-        }
+            required: [],
+        },
     },
     {
         name: 'recipes_mealplan_add_recipe',
-        description: '[RECIPES/MEALPLAN] Add a recipe to the meal plan for a specific date and meal section. Use recipes_management_get to find recipe IDs and recipes_mealplan_get_sections to find valid section IDs and their names.',
+        description: '[RECIPES/MEALPLAN] **Write:** put a recipe on the calendar (date + section + servings). Not for listing sections (recipes_mealplan_get_sections) or viewing the plan (recipes_mealplan_get).',
         inputSchema: {
             type: 'object',
             properties: {
                 recipeId: {
                     type: 'number',
-                    description: 'ID of the recipe to add to the meal plan. Use recipes_management_get tool to find valid recipe IDs and their names.'
+                    description: 'ID of the recipe to add to the meal plan. Use recipes_management_get tool to find valid recipe IDs and their names.',
                 },
                 day: {
                     type: 'string',
-                    description: 'Day to add the recipe to in YYYY-MM-DD format (e.g., "2024-12-25").'
+                    description: 'Day to add the recipe to in YYYY-MM-DD format (e.g., "2024-12-25").',
                 },
                 servings: {
                     type: 'number',
-                    description: 'Number of servings for this meal plan entry (e.g., 2 for a family of two, 4 for a family of four).'
+                    description: 'Number of servings for this meal plan entry (e.g., 2 for a family of two, 4 for a family of four).',
                 },
                 sectionId: {
                     type: 'number',
-                    description: 'ID of the meal plan section that defines when this meal will be consumed (e.g., breakfast, lunch, dinner, snacks). Use recipes_mealplan_get_sections tool to discover what sections are available in your Grocy instance and get their specific IDs and names.'
-                }
+                    description: 'ID of the meal plan section that defines when this meal will be consumed (e.g., breakfast, lunch, dinner, snacks). Use recipes_mealplan_get_sections tool to discover what sections are available in your Grocy instance and get their specific IDs and names.',
+                },
             },
-            required: ['recipeId', 'day', 'servings', 'sectionId']
-        }
+            required: ['recipeId', 'day', 'servings', 'sectionId'],
+        },
     },
     {
         name: 'recipes_mealplan_delete_entry',
@@ -164,11 +182,11 @@ export const recipeToolDefinitions = [
             properties: {
                 mealPlanEntryId: {
                     type: 'number',
-                    description: 'ID of the specific meal plan entry to delete. Use recipes_mealplan_get to find the correct entry ID.'
-                }
+                    description: 'ID of the specific meal plan entry to delete. Use recipes_mealplan_get to find the correct entry ID.',
+                },
             },
-            required: ['mealPlanEntryId']
-        }
+            required: ['mealPlanEntryId'],
+        },
     },
     // ==================== COOKING ====================
     {
@@ -179,50 +197,50 @@ export const recipeToolDefinitions = [
             properties: {
                 recipeId: {
                     type: 'number',
-                    description: 'ID of the recipe to consume. Use recipes_management_get tool to find the correct recipe ID by name.'
+                    description: 'ID of the recipe to consume. Use recipes_management_get tool to find the correct recipe ID by name.',
                 },
                 servings: {
                     type: 'number',
                     description: 'Number of servings to cook (scales ingredient consumption accordingly)',
-                    default: 1
-                }
+                    default: 1,
+                },
             },
-            required: ['recipeId']
-        }
+            required: ['recipeId'],
+        },
     },
     // ==================== SHOPPING INTEGRATION ====================
     {
         name: 'recipes_shopping_add_all_products',
-        description: '[RECIPES/SHOPPING] Add all products from a recipe to the shopping list.',
+        description: '[RECIPES/SHOPPING] Add **every** recipe ingredient to the shopping list (ignores what you already have). For only what you are short on use recipes_shopping_add_missing_products.',
         inputSchema: {
             type: 'object',
             properties: {
                 recipeId: {
                     type: 'number',
-                    description: 'ID of the recipe whose products should be added to shopping list. Use recipes_management_get tool to find the correct recipe ID by name.'
-                }
+                    description: 'ID of the recipe whose products should be added to shopping list. Use recipes_management_get tool to find the correct recipe ID by name.',
+                },
             },
-            required: ['recipeId']
-        }
+            required: ['recipeId'],
+        },
     },
     {
         name: 'recipes_shopping_add_missing_products',
-        description: '[RECIPES/SHOPPING] Add only the missing/insufficient products from a recipe to the shopping list (based on current stock levels).',
+        description: '[RECIPES/SHOPPING] Add **only missing or insufficient** ingredients (compares to stock). To add the full ingredient set regardless of stock use recipes_shopping_add_all_products.',
         inputSchema: {
             type: 'object',
             properties: {
                 recipeId: {
                     type: 'number',
-                    description: 'ID of the recipe to check for missing products. Use recipes_management_get tool to find the correct recipe ID by name.'
-                }
+                    description: 'ID of the recipe to check for missing products. Use recipes_management_get tool to find the correct recipe ID by name.',
+                },
             },
-            required: ['recipeId']
-        }
+            required: ['recipeId'],
+        },
     },
     // ==================== ADVANCED COOKING ====================
     (() => {
         const { toolSubConfigs } = config.parseToolConfiguration();
-        const subConfigs = toolSubConfigs?.get('complete');
+        const subConfigs = toolSubConfigs?.get(RECIPES_COOKING_COMPLETE_TOOL);
         const allowNoMealPlan = subConfigs?.get('allow_no_meal_plan') ?? false;
         const allowAlreadyDone = subConfigs?.get('allow_meal_plan_entry_already_done') ?? false;
         return {
@@ -231,31 +249,30 @@ export const recipeToolDefinitions = [
             inputSchema: {
                 type: 'object',
                 properties: {
-                    ...(allowNoMealPlan ? {
-                        recipeId: {
-                            type: 'number',
-                            description: 'ID of the recipe to cook directly.'
+                    ...(allowNoMealPlan
+                        ? {
+                            recipeId: {
+                                type: 'number',
+                                description: 'ID of the recipe to cook directly.',
+                            },
                         }
-                    } : {
-                        mealPlanEntryId: {
-                            type: 'number',
-                            description: `ID of the meal plan entry.${allowAlreadyDone ? '' : ' Note: This will fail if the meal plan entry is already marked as done (done=1).'}`
-                        }
-                    }),
+                        : {
+                            mealPlanEntryId: {
+                                type: 'number',
+                                description: `ID of the meal plan entry.${allowAlreadyDone ? '' : ' Note: This will fail if the meal plan entry is already marked as done (done=1).'}`,
+                            },
+                        }),
                     stockAmounts: {
                         type: 'array',
                         items: {
                             type: 'number',
-                            minimum: 0.1
+                            minimum: 0.1,
                         },
-                        description: 'Array of serving amounts for each stock entry to create (e.g., [1, 2, 2] for 1 single serving + 2 double servings). Total will be used for ingredient consumption.'
-                    }
+                        description: 'Array of serving amounts for each stock entry to create (e.g., [1, 2, 2] for 1 single serving + 2 double servings). Total will be used for ingredient consumption.',
+                    },
                 },
-                required: [
-                    ...(allowNoMealPlan ? ['recipeId'] : ['mealPlanEntryId']),
-                    'stockAmounts'
-                ]
-            }
+                required: [...(allowNoMealPlan ? ['recipeId'] : ['mealPlanEntryId']), 'stockAmounts'],
+            },
         };
-    })()
+    })(),
 ];

package/build/tools/recipes/handlers.js

@@ -4,6 +4,8 @@
  */
 import { BaseToolHandler } from '../base.js';
 import { InventoryToolHandlers } from '../inventory/handlers.js';
+import { ValidationError } from '../../utils/errors.js';
+const RECIPES_COOKING_COMPLETE_TOOL = 'recipes_cooking_complete';
 export class RecipeToolHandlers extends BaseToolHandler {
     inventoryHandlers = new InventoryToolHandlers();
     /**
@@ -16,8 +18,8 @@ export class RecipeToolHandlers extends BaseToolHandler {
             const dayResult = await this.apiCall(`/objects/meal_plan`, 'GET', undefined, {
                 queryParams: {
                     'query[]': `day=${dayString}`,
-                    order: 'day'
-                }
+                    order: 'day',
+                },
             });
             if (Array.isArray(dayResult)) {
                 allResults.push(...dayResult);
@@ -36,7 +38,7 @@ export class RecipeToolHandlers extends BaseToolHandler {
             const fieldList = this.parseArrayParam(fields, 'fields');
             // Fetch recipes
             const recipes = await this.apiCall('/objects/recipes', 'GET', undefined, {
-                queryParams: { 'query[]': 'type=normal' }
+                queryParams: { 'query[]': 'type=normal' },
             });
             if (!Array.isArray(recipes)) {
                 return this.createSuccess([]);
@@ -81,7 +83,7 @@ export class RecipeToolHandlers extends BaseToolHandler {
             const mealPlanData = {
                 day,
                 type: mealType || 'lunch',
-                recipe_id: id
+                recipe_id: id,
             };
             const result = await this.apiCall('/objects/meal_plan', 'POST', mealPlanData);
             return this.createSuccess(result, 'Recipe added to meal plan successfully');
@@ -101,13 +103,13 @@ export class RecipeToolHandlers extends BaseToolHandler {
             // Cook the recipe
             const cookData = {
                 recipe_id: id,
-                servings: servingCount
+                servings: servingCount,
             };
             const result = await this.apiCall('/recipes/cook', 'POST', cookData);
             return this.createSuccess({
                 recipe: recipe.name,
                 servings: servingCount,
-                result
+                result,
             }, `Recipe "${recipe.name}" cooked successfully`);
         });
     };
@@ -134,7 +136,7 @@ export class RecipeToolHandlers extends BaseToolHandler {
             // Get all recipes and filter locally
             // Note: This could be optimized with server-side search if Grocy supports it
             const recipes = await this.apiCall('/objects/recipes', 'GET', undefined, {
-                queryParams: { 'query[]': 'type=normal' }
+                queryParams: { 'query[]': 'type=normal' },
             });
             if (!Array.isArray(recipes)) {
                 return this.createSuccess([]);
@@ -157,7 +159,7 @@ export class RecipeToolHandlers extends BaseToolHandler {
             this.validateRequired({ date }, ['date']);
             const targetDate = new Date(date);
             if (isNaN(targetDate.getTime())) {
-                throw new Error('Invalid date format. Use YYYY-MM-DD.');
+                throw new ValidationError('Invalid date format. Use YYYY-MM-DD.', 'getMealPlan');
             }
             const datesToQuery = [];
             if (weekly) {
@@ -184,20 +186,22 @@ export class RecipeToolHandlers extends BaseToolHandler {
             const result = await this.getMealPlanForDays(datesToQuery);
             if (result.length === 0) {
                 return this.createSuccess({
-                    message: weekly ? 'No meals planned for the requested week' : 'No meals planned for the requested date',
-                    meal_plan_by_date: {}
+                    message: weekly
+                        ? 'No meals planned for the requested week'
+                        : 'No meals planned for the requested date',
+                    meal_plan_by_date: {},
                 }, 'Meal plan retrieved successfully');
             }
-            // Extract unique recipe IDs 
-            const recipeIds = [...new Set(result.map(entry => entry.recipe_id).filter(id => id))];
+            // Extract unique recipe IDs
+            const recipeIds = [...new Set(result.map((entry) => entry.recipe_id).filter((id) => id))];
             // Fetch recipe details and all sections in parallel
             const [recipeDetails, allSections] = await Promise.all([
-                Promise.all(recipeIds.map(recipeId => this.apiCall(`/objects/recipes/${recipeId}`))),
-                this.apiCall('/objects/meal_plan_sections')
+                Promise.all(recipeIds.map((recipeId) => this.apiCall(`/objects/recipes/${recipeId}`))),
+                this.apiCall('/objects/meal_plan_sections'),
             ]);
             // Simplify meal plan entries - don't merge recipe/section details
             const simplifiedMealPlanByDate = {};
-            result.forEach(entry => {
+            result.forEach((entry) => {
                 const entryDate = entry.day;
                 if (!simplifiedMealPlanByDate[entryDate]) {
                     simplifiedMealPlanByDate[entryDate] = [];
@@ -209,7 +213,7 @@ export class RecipeToolHandlers extends BaseToolHandler {
                     recipe_id: entry.recipe_id,
                     recipe_servings: entry.recipe_servings,
                     note: entry.note,
-                    done: entry.done
+                    done: entry.done,
                 });
             });
             return this.createSuccess({
@@ -219,11 +223,13 @@ export class RecipeToolHandlers extends BaseToolHandler {
                     name: recipe.name,
                     product_id: recipe.product_id,
                 })),
-                sections: Array.isArray(allSections) ? allSections.map((section) => ({
-                    id: section.id,
-                    name: section.name,
-                    time_info: section.time_info
-                })) : []
+                sections: Array.isArray(allSections)
+                    ? allSections.map((section) => ({
+                        id: section.id,
+                        name: section.name,
+                        time_info: section.time_info,
+                    }))
+                    : [],
             }, 'Meal plan retrieved successfully');
         });
     };
@@ -268,7 +274,7 @@ export class RecipeToolHandlers extends BaseToolHandler {
                 description: description || '',
                 base_servings: baseServings || 1,
                 type: 'normal',
-                instructions: instructions || ''
+                instructions: instructions || '',
             };
             const result = await this.apiCall('/objects/recipes', 'POST', recipeData);
             return this.createSuccess(result, `Recipe "${name}" created successfully`);
@@ -296,7 +302,7 @@ export class RecipeToolHandlers extends BaseToolHandler {
             const servingCount = this.parseNumberParam(servings, 'servings', false) || 1;
             const consumeData = {
                 recipe_id: id,
-                servings: servingCount
+                servings: servingCount,
             };
             const result = await this.apiCall('/recipes/consume', 'POST', consumeData);
             return this.createSuccess(result, `Recipe consumed (${servingCount} servings)`);
@@ -337,29 +343,29 @@ export class RecipeToolHandlers extends BaseToolHandler {
             // Get configuration from unified config
             const { config } = await import('../../config/index.js');
             const { toolSubConfigs } = config.parseToolConfiguration();
-            const subConfigs = toolSubConfigs?.get('complete');
+            const subConfigs = toolSubConfigs?.get(RECIPES_COOKING_COMPLETE_TOOL);
             const allowMealPlanEntryAlreadyDone = subConfigs?.get('allow_meal_plan_entry_already_done') ?? false;
             const printLabels = subConfigs?.get('print_labels') ?? true;
             const allowNoMealPlan = subConfigs?.get('allow_no_meal_plan') ?? false;
             // Validate parameters based on configuration
             if (!allowNoMealPlan && !mealPlanEntryId) {
-                throw new Error('mealPlanEntryId is required when allow_no_meal_plan is false.');
+                throw new ValidationError('mealPlanEntryId is required when allow_no_meal_plan is false.', 'recipes_cooking_complete');
             }
             if (allowNoMealPlan && !recipeId) {
-                throw new Error('recipeId is required when allow_no_meal_plan is true.');
+                throw new ValidationError('recipeId is required when allow_no_meal_plan is true.', 'recipes_cooking_complete');
             }
             if (allowNoMealPlan && mealPlanEntryId) {
-                throw new Error('mealPlanEntryId should not be provided when allow_no_meal_plan is true. Use recipeId instead.');
+                throw new ValidationError('mealPlanEntryId should not be provided when allow_no_meal_plan is true. Use recipeId instead.', 'recipes_cooking_complete');
             }
             this.validateRequired({ stockAmounts }, ['stockAmounts']);
             if (!Array.isArray(stockAmounts) || stockAmounts.length === 0) {
-                throw new Error('stockAmounts must be a non-empty array of serving amounts.');
+                throw new ValidationError('stockAmounts must be a non-empty array of serving amounts.', 'recipes_cooking_complete');
             }
             // Validate all stock amounts are positive numbers
             for (let i = 0; i < stockAmounts.length; i++) {
                 const amount = stockAmounts[i];
                 if (typeof amount !== 'number' || amount <= 0) {
-                    throw new Error(`stockAmounts[${i}] must be a positive number, got: ${amount}`);
+                    throw new ValidationError(`stockAmounts[${i}] must be a positive number, got: ${amount}`, 'recipes_cooking_complete');
                 }
             }
             const completedSteps = [];
@@ -379,10 +385,10 @@ export class RecipeToolHandlers extends BaseToolHandler {
                 // Meal plan mode - traditional workflow
                 const mealPlanEntry = await this.apiCall(`/objects/meal_plan/${mealPlanEntryId}`);
                 if (!mealPlanEntry) {
-                    throw new Error(`Meal plan entry ${mealPlanEntryId} not found.`);
+                    throw new ValidationError(`Meal plan entry ${mealPlanEntryId} not found.`, 'recipes_cooking_complete');
                 }
                 if (mealPlanEntry.done == 1 && !allowMealPlanEntryAlreadyDone) {
-                    throw new Error(`Meal plan entry ${mealPlanEntryId} is already marked as done. Cannot mark as cooked again.`);
+                    throw new ValidationError(`Meal plan entry ${mealPlanEntryId} is already marked as done. Cannot mark as cooked again.`, 'recipes_cooking_complete');
                 }
                 actualRecipeId = mealPlanEntry.recipe_id;
                 totalServings = stockAmounts.reduce((sum, amount) => sum + amount, 0);
@@ -391,7 +397,7 @@ export class RecipeToolHandlers extends BaseToolHandler {
                 // Mark the meal plan entry as done and update recipe_servings
                 await this.apiCall(`/objects/meal_plan/${mealPlanEntryId}`, 'PUT', {
                     done: 1,
-                    recipe_servings: totalServings
+                    recipe_servings: totalServings,
                 });
                 completedSteps.push('Meal plan entry marked as done');
             }
@@ -404,10 +410,10 @@ export class RecipeToolHandlers extends BaseToolHandler {
             else {
                 // Query for the mealplan shadow recipe by name
                 const shadowRecipes = await this.apiCall('/objects/recipes', 'GET', undefined, {
-                    queryParams: { 'query[]': `name=${mealplanShadow}` }
+                    queryParams: { 'query[]': `name=${mealplanShadow}` },
                 });
                 if (!Array.isArray(shadowRecipes) || shadowRecipes.length === 0) {
-                    throw new Error(`Mealplan shadow recipe '${mealplanShadow}' not found. Cannot consume ingredients.`);
+                    throw new ValidationError(`Mealplan shadow recipe '${mealplanShadow}' not found. Cannot consume ingredients.`, 'recipes_cooking_complete');
                 }
                 const shadowRecipeId = shadowRecipes[0].id;
                 // Consume ingredients using the shadow recipe ID
@@ -415,15 +421,15 @@ export class RecipeToolHandlers extends BaseToolHandler {
                 completedSteps.push('Recipe consumed via meal plan entry');
             }
             // Handle stock entry splitting and label printing
-            let stockEntries = { splitEntries: [], labelsPrinted: 0 };
+            const stockEntries = { splitEntries: [], labelsPrinted: 0 };
             const recipe = await this.apiCall(`/objects/recipes/${actualRecipeId}`);
             if (recipe && recipe.product_id) {
                 // Get product details and most recent stock entry
                 const [product, entries] = await Promise.all([
                     this.apiCall(`/objects/products/${recipe.product_id}`),
                     this.apiCall(`/stock/products/${recipe.product_id}/entries`, 'GET', undefined, {
-                        queryParams: { order: 'row_created_timestamp:desc', limit: '1' }
-                    })
+                        queryParams: { order: 'row_created_timestamp:desc', limit: '1' },
+                    }),
                 ]);
                 // Get quantity unit info
                 let quantityUnit = null;
@@ -464,7 +470,7 @@ export class RecipeToolHandlers extends BaseToolHandler {
             return this.createSuccess({
                 message: `Recipe ${actualRecipeId} cooked (${totalServings} servings consumed, ${stockEntries.splitEntries.length} stock entries created, ${stockEntries.labelsPrinted} labels printed)`,
                 stockEntries,
-                completedSteps
+                completedSteps,
             });
         });
     };

package/build/tools/recipes/index.js

@@ -24,10 +24,10 @@ export const recipeModule = {
         recipes_cooking_complete: handlers.cookedSomething,
         // Shopping Integration
         recipes_shopping_add_all_products: handlers.addAllProductsToShopping,
-        recipes_shopping_add_missing_products: handlers.addMissingProductsToShopping
+        recipes_shopping_add_missing_products: handlers.addMissingProductsToShopping,
     },
     validators: {
-        recipes_cooking_complete: validateCompleteSubConfigs
-    }
+        recipes_cooking_complete: validateCompleteSubConfigs,
+    },
 };
 export * from './definitions.js';

package/build/tools/recipes/validations.js

@@ -2,6 +2,7 @@
  * Recipe tools sub-configuration validation functions
  */
 import { ValidationHelpers } from '../validation-helpers.js';
+import { ValidationError } from '../../utils/errors.js';
 /**
  * Validation function for complete tool sub-configurations
  */
@@ -15,9 +16,14 @@ export const validateCompleteSubConfigs = (subConfigs) => {
     ValidationHelpers.validateBoolean(printLabels, 'print_labels');
     // Business logic validation
     if (allowNoMealPlan && allowMealPlanEntryAlreadyDone) {
-        throw new Error('allow_no_meal_plan and allow_meal_plan_entry_already_done cannot both be true - they are mutually exclusive modes');
+        throw new ValidationError('allow_no_meal_plan and allow_meal_plan_entry_already_done cannot both be true - they are mutually exclusive modes', 'complete sub-config');
     }
     // Check for unknown options
-    const knownOptions = new Set(['allow_meal_plan_entry_already_done', 'allow_no_meal_plan', 'print_labels', 'ack_token']);
+    const knownOptions = new Set([
+        'allow_meal_plan_entry_already_done',
+        'allow_no_meal_plan',
+        'print_labels',
+        'ack_token',
+    ]);
     ValidationHelpers.validateKnownOptions(subConfigs, knownOptions, 'complete');
 };