cookbook-co-mcp 0.1.0 → 0.2.0

package/README.md

@@ -125,6 +125,7 @@ unsupported-protocol-version error that names the supported version.
 | `COOKBOOK_TOKEN` | Required. The login token copied from the web app. |
 | `COOKBOOK_READ_ONLY` | Set to `1` to register only the read tools. |
 | `COOKBOOK_PORT` | Port for `serve` (or pass it as `serve <port>`). |
+| `COOKBOOK_DEFAULT_SHOPPING_LIST` | Shopping list used when a tool is given none. Default `Shopping List`. |
 | `COOKBOOK_BACKUP_DIR` | Where recipe backups go. Default `~/.local/state/cookbook-mcp/backups`. |
 | `COOKBOOK_BACKUP_KEEP` | Edit backups kept per recipe. Default 20. |
 | `COOKBOOK_EXPORT_DIR` | Where exports go when no path is given. Default `~/Downloads`, else `~/.local/state/cookbook-mcp/exports`. |

package/dist/cookbook-mcp.js

@@ -127978,14 +127978,14 @@ var RecipesApi = class {
   }
 };
 function recipePatch(recipe, tags, fave = recipe.fave) {
-  const { category: _category, instructions, created: _c, changed: _ch, ...rest } = recipe;
+  const { category: _category, instructions: instructions2, created: _c, changed: _ch, ...rest } = recipe;
   return {
     ...rest,
     fave,
     category: tags,
     categoryNames: [],
     // the app writes `directions` with zero-based id/item and a one-based itemId
-    directions: instructions.map((d, i2) => ({
+    directions: instructions2.map((d, i2) => ({
       id: i2,
       item: i2,
       itemId: i2 + 1,
@@ -131900,7 +131900,7 @@ var updateRecipe = defineTool({
     apply: external_exports.boolean().default(false).describe("false previews only; true saves"),
     show_full: external_exports.boolean().default(false).describe("Preview only: also return the full recipe before and after, not just the changes")
   },
-  run: async ({ id, changed, ingredients, instructions, notes, servings, apply: apply2, show_full, ...fields }, { client, backup }) => {
+  run: async ({ id, changed, ingredients, instructions: instructions2, notes, servings, apply: apply2, show_full, ...fields }, { client, backup }) => {
     const recipe = await freshRecipe(client, id);
     if (!recipe) return fail2(`No recipe with id ${id}`);
     const stale = staleError(recipe, changed);
@@ -131908,11 +131908,11 @@ var updateRecipe = defineTool({
     const edits = {
       ...pickBy({ ...fields, serving: servings }, (value) => value !== void 0),
       ...ingredients && { ingredients: toIngredients(ingredients) },
-      ...instructions && { instructions: toInstructions(instructions, recipe.instructions) },
+      ...instructions2 && { instructions: toInstructions(instructions2, recipe.instructions) },
       ...notes !== void 0 && { notes }
     };
     if (isEmpty2(edits)) return fail2("Nothing to change: pass at least one field to edit");
-    const lostPhotos = instructions ? recipe.instructions.filter((s) => s.photo && !instructions.includes(s.text)).length : 0;
+    const lostPhotos = instructions2 ? recipe.instructions.filter((s) => s.photo && !instructions2.includes(s.text)).length : 0;
     const warnings = lostPhotos > 0 ? [`${lostPhotos} step photo(s) will be dropped because their step text changed`] : [];
     if (ingredients && !isDrink(recipe, await client.tags.list())) {
       const unclear = ambiguousOunces(edits.ingredients ?? []);
@@ -132145,12 +132145,19 @@ var aisleOverrides = external_exports.array(
 function overrideMap(entries3) {
   return new Map(entries3.map((e) => [normalizeName(e.item), aisleId(e.aisle)]));
 }
-var list = external_exports.string().optional().describe('List name or id; defaults to "Shopping List"');
+var list = external_exports.string().optional().describe("List name or id; defaults to the default list (marked by list_shopping_lists)");
 var on_hand = external_exports.array(external_exports.string()).default([]).describe("Extra ingredient names assumed on hand and skipped");
 var include_staples = external_exports.boolean().default(false).describe("Also add staples (water, salt, pepper, cooking oil and spray) normally skipped");
 var apply = external_exports.boolean().default(false).describe("false previews only; true makes the change");
-var DEFAULT_LIST = "shopping list";
-async function resolveList(client, ref) {
+var DEFAULT_LIST = "Shopping List";
+function findDefaultList(lists, configured) {
+  const key = (configured ?? DEFAULT_LIST).toLowerCase();
+  const match = lists.find((l) => l.id === configured || l.name.toLowerCase() === key);
+  if (match || configured) return match;
+  const others = lists.filter((l) => l.id !== "common");
+  return others.length === 1 ? others[0] : void 0;
+}
+async function resolveList(client, ref, configured) {
   const lists = await client.shopping.lists();
   const names = lists.map((l) => l.name).join(", ");
   if (ref) {
@@ -132163,11 +132170,9 @@ async function resolveList(client, ref) {
       error: partial2.length === 0 ? `No list "${ref}". Lists: ${names}` : `"${ref}" matches several lists (${partial2.map((l) => l.name).join(", ")}); use the full name`
     };
   }
-  const byName = lists.find((l) => l.name.toLowerCase() === DEFAULT_LIST);
-  if (byName) return byName;
-  const others = lists.filter((l) => l.id !== "common");
-  if (others.length === 1) return others[0];
-  return { error: `No "Shopping List" found; pass \`list\`. Lists: ${names}` };
+  const found = findDefaultList(lists, configured);
+  if (found) return found;
+  return { error: `No "${configured ?? DEFAULT_LIST}" found; pass \`list\`. Lists: ${names}` };
 }
 async function applyPlan(client, listId, plan) {
   await client.shopping.addItems(listId, plan.adds);
@@ -132218,8 +132223,8 @@ var addPlannedMealsToShoppingList = defineTool({
     aisles: aisleOverrides,
     apply
   },
-  run: async ({ from, to, list: ref, on_hand: extra, include_staples: staples, aisles, apply: go }, { client }) => {
-    const found = await resolveList(client, ref);
+  run: async ({ from, to, list: ref, on_hand: extra, include_staples: staples, aisles, apply: go }, { client, config: config2 }) => {
+    const found = await resolveList(client, ref, config2.defaultShoppingList);
     if ("error" in found) return fail2(found.error);
     const [planned, recipes] = await Promise.all([
       client.mealPlan.list(from, to, true),
@@ -132275,8 +132280,8 @@ var addRecipeToShoppingList = defineTool({
     aisles: aisleOverrides,
     apply
   },
-  run: async ({ recipe_id, servings, list: ref, on_hand: extra, include_staples: staples, aisles, apply: go }, { client }) => {
-    const found = await resolveList(client, ref);
+  run: async ({ recipe_id, servings, list: ref, on_hand: extra, include_staples: staples, aisles, apply: go }, { client, config: config2 }) => {
+    const found = await resolveList(client, ref, config2.defaultShoppingList);
     if ("error" in found) return fail2(found.error);
     const recipe = (await client.recipes.list()).find((r) => r.id === recipe_id);
     if (!recipe) return fail2(`No recipe with id ${recipe_id}`);
@@ -132318,8 +132323,8 @@ var addToShoppingList = defineTool({
     ).min(1).describe("Items to add; the same name and unit as an open item adds to its quantity"),
     list
   },
-  run: async ({ items, list: ref }, { client }) => {
-    const found = await resolveList(client, ref);
+  run: async ({ items, list: ref }, { client, config: config2 }) => {
+    const found = await resolveList(client, ref, config2.defaultShoppingList);
     if ("error" in found) return fail2(found.error);
     const lines = items.map((i2) => ({
       name: i2.name.trim(),
@@ -132352,8 +132357,8 @@ function itemActionTool(options2) {
       ),
       list
     },
-    run: async ({ items: queries, list: ref }, { client }) => {
-      const found = await resolveList(client, ref);
+    run: async ({ items: queries, list: ref }, { client, config: config2 }) => {
+      const found = await resolveList(client, ref, config2.defaultShoppingList);
       if ("error" in found) return fail2(found.error);
       const all = await client.shopping.items(found.id);
       const picked = [];
@@ -132393,8 +132398,8 @@ var clearCompleted = defineTool({
   description: "Delete every checked-off item from a shopping list. The open items stay. This cannot be undone.",
   hints: ["destructive", "idempotent"],
   inputSchema: { list },
-  run: async ({ list: ref }, { client }) => {
-    const found = await resolveList(client, ref);
+  run: async ({ list: ref }, { client, config: config2 }) => {
+    const found = await resolveList(client, ref, config2.defaultShoppingList);
     if ("error" in found) return fail2(found.error);
     const done = (await client.shopping.items(found.id)).filter((i2) => i2.complete);
     await client.shopping.deleteItems(
@@ -132430,8 +132435,8 @@ var deleteShoppingList = defineTool({
     name: external_exports.string().describe("The list's current name, to confirm"),
     apply
   },
-  run: async ({ list: ref, name: name5, apply: go }, { client }) => {
-    const found = await resolveList(client, ref);
+  run: async ({ list: ref, name: name5, apply: go }, { client, config: config2 }) => {
+    const found = await resolveList(client, ref, config2.defaultShoppingList);
     if ("error" in found) return fail2(found.error);
     if (found.id === "common") return fail2('The built-in "Regular items" list cannot be deleted');
     if (found.name.toLowerCase() !== name5.toLowerCase()) {
@@ -132465,8 +132470,8 @@ var getShoppingList = defineTool({
     ids: external_exports.boolean().default(false).describe("Return each item as {id, text} instead of text"),
     show_done: external_exports.boolean().default(false).describe("List the checked-off items, not just a count")
   },
-  run: async ({ list: ref, ids, show_done }, { client }) => {
-    const found = await resolveList(client, ref);
+  run: async ({ list: ref, ids, show_done }, { client, config: config2 }) => {
+    const found = await resolveList(client, ref, config2.defaultShoppingList);
     if ("error" in found) return fail2(found.error);
     const items = await client.shopping.items(found.id);
     const order = Object.values(AISLES);
@@ -132506,17 +132511,19 @@ var listLearnedAisles = defineTool({
 // src/tools/shopping/list-shopping-lists.ts
 var listShoppingLists = defineTool({
   name: "list_shopping_lists",
-  description: `List the shopping lists by name with open and done item counts. "Shopping List" is the one normally used; "Regular items" is the app's built-in list of regular groceries.`,
+  description: `List the shopping lists by name with open and done item counts. The default list, used when a tool is given no list, is marked default: true; "Regular items" is the app's built-in list of regular groceries.`,
   hints: ["readOnly"],
   inputSchema: {},
-  run: async (_args, { client }) => {
+  run: async (_args, { client, config: config2 }) => {
     const lists = await client.shopping.lists();
+    const defaultList = findDefaultList(lists, config2.defaultShoppingList);
     return json2(
       await Promise.all(
         lists.map(async (l) => {
           const items = await client.shopping.items(l.id);
           return {
             name: l.name,
+            default: l === defaultList,
             open: items.filter((i2) => !i2.complete).length,
             done: items.filter((i2) => i2.complete).length
           };
@@ -132546,8 +132553,8 @@ var setItemAisle = defineTool({
     list,
     remember: external_exports.boolean().default(true).describe("Also remember this aisle for future adds")
   },
-  run: async ({ items: queries, aisle, list: ref, remember }, { client }) => {
-    const found = await resolveList(client, ref);
+  run: async ({ items: queries, aisle, list: ref, remember }, { client, config: config2 }) => {
+    const found = await resolveList(client, ref, config2.defaultShoppingList);
     if ("error" in found) return fail2(found.error);
     const all = await client.shopping.items(found.id);
     const picked = [];
@@ -132759,6 +132766,7 @@ function loadConfig(env = process.env, home = homedir()) {
     exportDirs: env.COOKBOOK_EXPORT_DIR ? [env.COOKBOOK_EXPORT_DIR] : [join3(home, "Downloads"), join3(state, "exports")],
     backupDir: env.COOKBOOK_BACKUP_DIR ?? join3(state, "backups"),
     backupKeep: Math.max(1, Number(env.COOKBOOK_BACKUP_KEEP ?? 20) || 20),
+    defaultShoppingList: env.COOKBOOK_DEFAULT_SHOPPING_LIST?.trim() || void 0,
     cache: loadCacheSettings(env)
   };
 }
@@ -132799,16 +132807,17 @@ function parseWindow(variable, raw, canBeOff) {
 }
 
 // src/server/instructions.ts
-function serverInstructions(readOnly) {
-  return readOnly ? `${INSTRUCTIONS}
-${READ_ONLY_NOTE}` : INSTRUCTIONS;
+function serverInstructions(config2) {
+  const text2 = instructions(config2.defaultShoppingList ?? DEFAULT_LIST);
+  return config2.readOnly ? `${text2}
+${READ_ONLY_NOTE}` : text2;
 }
 var READ_ONLY_NOTE = "READ-ONLY MODE: only tools that read are available; nothing can be created, changed or deleted.";
-var INSTRUCTIONS = `CookBook recipe manager: the user's personal recipe library, tags and meal planner.
+var instructions = (defaultList) => `CookBook recipe manager: the user's personal recipe library, tags and meal planner.
 Find recipes with search_recipes or get_recent_recipes, then read one with get_recipe.
 scale_recipe shows scaled ingredient amounts without saving anything.
 set_recipe_photo replaces a recipe's main photo from a file path or URL.
-Shopping lists: "Shopping List" is the default list; recipe and planned-meal adds skip staples (water, salt, pepper, cooking oils) and report them, and preview before writing.
+Shopping lists: "${defaultList}" is the default list; recipe and planned-meal adds skip staples (water, salt, pepper, cooking oils) and report them, and preview before writing.
 Aisles for new items come from the app's remembered products, else a crude keyword guess: pass the aisle yourself whenever you know it, and fix a wrong one with set_item_aisle or teach_aisle.
 Cooking and rating are separate: mark_cooked logs a cook (adds to the count, sets the last-cooked date, optional rating and date); rate_recipe only sets the stars.
 Edit tools (set_tags, set_favourite, rate_recipe, rename_recipe, set_recipe_photo, update_recipe) need that recipe's \`changed\` value from get_recipe and refuse if it is stale.
@@ -132830,7 +132839,7 @@ function createServerFactory(log) {
   const create2 = () => {
     const server = new McpServer(
       { name: "cookbook", version: "0.1.0" },
-      { instructions: serverInstructions(config2.readOnly) }
+      { instructions: serverInstructions(config2) }
     );
     registerTools(server, context);
     return server;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "cookbook-co-mcp",
-  "version": "0.1.0",
+  "version": "0.2.0",
   "description": "Unofficial MCP server for CookBook Co.: recipes, tags, meal planner and shopping lists",
   "keywords": [
     "mcp",