@davidwoods/skylight-mcp 1.7.0 → 1.8.0

package/dist/tools/lists.js

@@ -27,9 +27,9 @@ async function resolveListId(listId, listName, defaultToGrocery = false) {
 }
 export function registerListTools(server) {
     // get_lists tool
-    server.tool("get_lists", `Get all lists from Skylight (grocery lists, to-do lists, etc.).
-
-Use this to see what lists are available before adding items.
+    server.tool("get_lists", `Get all lists from Skylight (grocery lists, to-do lists, etc.).
+
+Use this to see what lists are available before adding items.
 Returns list names, types (shopping/to_do), and item counts.`, {}, async () => {
         try {
             const lists = await getLists();
@@ -80,13 +80,13 @@ Returns list names, types (shopping/to_do), and item counts.`, {}, async () => {
         }
     });
     // get_list_items tool
-    server.tool("get_list_items", `Get items from a specific Skylight list.
-
-Use this to answer:
-- "What's on the grocery list?"
-- "Show me my to-do list"
-- "What items are on [list name]?"
-
+    server.tool("get_list_items", `Get items from a specific Skylight list.
+
+Use this to answer:
+- "What's on the grocery list?"
+- "Show me my to-do list"
+- "What items are on [list name]?"
+
 Returns items organized by section with their completion status.`, {
         listName: z
             .string()
@@ -219,17 +219,17 @@ Returns items organized by section with their completion status.`, {
         }
     });
     // create_list tool
-    server.tool("create_list", `Create a new list in Skylight.
-
-Use this when:
-- Creating a new shopping/grocery list
-- Creating a new to-do list
-
-Parameters:
-- label (required): Name of the list (e.g., "Vacation Packing", "Weekly Groceries")
-- kind (required): "shopping" for grocery/shopping lists, "to_do" for task lists
-- color: Optional color for the list
-
+    server.tool("create_list", `Create a new list in Skylight.
+
+Use this when:
+- Creating a new shopping/grocery list
+- Creating a new to-do list
+
+Parameters:
+- label (required): Name of the list (e.g., "Vacation Packing", "Weekly Groceries")
+- kind (required): "shopping" for grocery/shopping lists, "to_do" for task lists
+- color: Optional color for the list
+
 Returns: The created list details.`, {
         label: z.string().describe("Name of the list (e.g., 'Vacation Packing')"),
         kind: z.enum(["shopping", "to_do"]).describe("Type of list: 'shopping' or 'to_do'"),
@@ -254,19 +254,19 @@ Returns: The created list details.`, {
         }
     });
     // update_list tool
-    server.tool("update_list", `Update an existing list's name or settings.
-
-Use this when:
-- Renaming a list
-- Changing a list's type or color
-
-Parameters:
-- listId: ID of the list to update (use get_lists to find IDs)
-- listName: Name of the list to update (alternative to listId)
-- label: New name for the list
-- kind: New type ("shopping" or "to_do")
-- color: New color for the list
-
+    server.tool("update_list", `Update an existing list's name or settings.
+
+Use this when:
+- Renaming a list
+- Changing a list's type or color
+
+Parameters:
+- listId: ID of the list to update (use get_lists to find IDs)
+- listName: Name of the list to update (alternative to listId)
+- label: New name for the list
+- kind: New type ("shopping" or "to_do")
+- color: New color for the list
+
 Returns: The updated list details.`, {
         listId: z.string().optional().describe("ID of the list to update"),
         listName: z.string().optional().describe("Name of the list to update (alternative to listId)"),
@@ -307,16 +307,16 @@ Returns: The updated list details.`, {
         }
     });
     // delete_list tool
-    server.tool("delete_list", `Delete a list from Skylight.
-
-Use this when:
-- Removing an old or unused list
-- Deleting a temporary list
-
-Parameters:
-- listId: ID of the list to delete (use get_lists to find IDs)
-- listName: Name of the list to delete (alternative to listId)
-
+    server.tool("delete_list", `Delete a list from Skylight.
+
+Use this when:
+- Removing an old or unused list
+- Deleting a temporary list
+
+Parameters:
+- listId: ID of the list to delete (use get_lists to find IDs)
+- listName: Name of the list to delete (alternative to listId)
+
 Note: This permanently deletes the list and all its items.`, {
         listId: z.string().optional().describe("ID of the list to delete"),
         listName: z.string().optional().describe("Name of the list to delete (alternative to listId)"),
@@ -347,23 +347,23 @@ Note: This permanently deletes the list and all its items.`, {
         }
     });
     // create_list_item tool
-    server.tool("create_list_item", `Add an item to a Skylight list.
-
-Use this when:
-- Adding something to the grocery list: "Add milk to the shopping list"
-- Creating a to-do item: "Put 'call doctor' on my to-do list"
-- Adding items to any list
-
-Parameters:
-- label (required): The item text (e.g., "Milk", "Call doctor")
-- listId: ID of the list to add to
-- listName: Name of the list to add to (e.g., "Grocery List")
-- section: Category within the list (e.g., "Dairy", "Produce")
-
-If no list is specified, adds to the default grocery list.
-
-Returns: Confirmation of the added item.
-
+    server.tool("create_list_item", `Add an item to a Skylight list.
+
+Use this when:
+- Adding something to the grocery list: "Add milk to the shopping list"
+- Creating a to-do item: "Put 'call doctor' on my to-do list"
+- Adding items to any list
+
+Parameters:
+- label (required): The item text (e.g., "Milk", "Call doctor")
+- listId: ID of the list to add to
+- listName: Name of the list to add to (e.g., "Grocery List")
+- section: Category within the list (e.g., "Dairy", "Produce")
+
+If no list is specified, adds to the default grocery list.
+
+Returns: Confirmation of the added item.
+
 Related: Use get_lists to see available lists and their IDs.`, {
         label: z.string().describe("The item text to add (e.g., 'Milk', 'Call doctor')"),
         listId: z.string().optional().describe("ID of the list to add to"),
@@ -397,20 +397,20 @@ Related: Use get_lists to see available lists and their IDs.`, {
         }
     });
     // update_list_item tool
-    server.tool("update_list_item", `Update a list item (mark complete, rename, move to section).
-
-Use this when:
-- Marking an item as complete: "Check off milk from the list"
-- Renaming an item: "Change 'milk' to '2% milk'"
-- Moving an item to a different section
-
-Parameters:
-- itemId (required): ID of the item to update
-- listId (required): ID of the list containing the item
-- label: New text for the item
-- status: "completed" to check off, "pending" to uncheck
-- section: Move to a different section
-
+    server.tool("update_list_item", `Update a list item (mark complete, rename, move to section).
+
+Use this when:
+- Marking an item as complete: "Check off milk from the list"
+- Renaming an item: "Change 'milk' to '2% milk'"
+- Moving an item to a different section
+
+Parameters:
+- itemId (required): ID of the item to update
+- listId (required): ID of the list containing the item
+- label: New text for the item
+- status: "completed" to check off, "pending" to uncheck
+- section: Move to a different section
+
 Returns: The updated item details.`, {
         itemId: z.string().describe("ID of the item to update"),
         listId: z.string().describe("ID of the list containing the item"),
@@ -445,16 +445,16 @@ Returns: The updated item details.`, {
         }
     });
     // delete_list_item tool
-    server.tool("delete_list_item", `Remove an item from a list.
-
-Use this when:
-- Removing an item that was added by mistake
-- Deleting an item instead of marking it complete
-
-Parameters:
-- itemId (required): ID of the item to delete
-- listId (required): ID of the list containing the item
-
+    server.tool("delete_list_item", `Remove an item from a list.
+
+Use this when:
+- Removing an item that was added by mistake
+- Deleting an item instead of marking it complete
+
+Parameters:
+- itemId (required): ID of the item to delete
+- listId (required): ID of the list containing the item
+
 Note: This permanently removes the item. Use update_list_item with status="completed" to check it off instead.`, {
         itemId: z.string().describe("ID of the item to delete"),
         listId: z.string().describe("ID of the list containing the item"),

package/dist/tools/meals.js

@@ -6,12 +6,12 @@ import { formatErrorForMcp } from "../utils/errors.js";
 import { getConfig } from "../config.js";
 export function registerMealTools(server) {
     // get_meal_categories tool
-    server.tool("get_meal_categories", `Get meal categories (Breakfast, Lunch, Dinner, etc.) - Plus subscription required.
-
-Use this when:
-- Finding category IDs for scheduling meals
-- Seeing what meal times are available
-
+    server.tool("get_meal_categories", `Get meal categories (Breakfast, Lunch, Dinner, etc.) - Plus subscription required.
+
+Use this when:
+- Finding category IDs for scheduling meals
+- Seeing what meal times are available
+
 Returns: List of meal categories with IDs.`, {}, async () => {
         try {
             const categories = await getMealCategories();
@@ -35,12 +35,12 @@ Returns: List of meal categories with IDs.`, {}, async () => {
         }
     });
     // get_recipes tool
-    server.tool("get_recipes", `Get all saved recipes - Plus subscription required.
-
-Use this when:
-- Browsing available recipes
-- Finding a recipe ID for meal planning
-
+    server.tool("get_recipes", `Get all saved recipes - Plus subscription required.
+
+Use this when:
+- Browsing available recipes
+- Finding a recipe ID for meal planning
+
 Returns: List of recipes with their details.`, {}, async () => {
         try {
             const recipes = await getRecipes();
@@ -70,11 +70,11 @@ Returns: List of recipes with their details.`, {}, async () => {
         }
     });
     // get_recipe tool
-    server.tool("get_recipe", `Get details for a specific recipe - Plus subscription required.
-
-Parameters:
-- recipeId (required): ID of the recipe
-
+    server.tool("get_recipe", `Get details for a specific recipe - Plus subscription required.
+
+Parameters:
+- recipeId (required): ID of the recipe
+
 Returns: Recipe details including description.`, {
         recipeId: z.string().describe("ID of the recipe"),
     }, async ({ recipeId }) => {
@@ -98,17 +98,17 @@ Returns: Recipe details including description.`, {
         }
     });
     // create_recipe tool
-    server.tool("create_recipe", `Create a new recipe - Plus subscription required.
-
-Use this when:
-- Adding a new family recipe
-- Saving a meal for meal planning
-
-Parameters:
-- summary (required): Recipe name
-- description: Recipe details or instructions
-- mealCategoryId: Category ID (use get_meal_categories)
-
+    server.tool("create_recipe", `Create a new recipe - Plus subscription required.
+
+Use this when:
+- Adding a new family recipe
+- Saving a meal for meal planning
+
+Parameters:
+- summary (required): Recipe name
+- description: Recipe details or instructions
+- mealCategoryId: Category ID (use get_meal_categories)
+
 Returns: The created recipe.`, {
         summary: z.string().describe("Recipe name (e.g., 'Spaghetti Bolognese')"),
         description: z.string().optional().describe("Recipe details or instructions"),
@@ -133,13 +133,13 @@ Returns: The created recipe.`, {
         }
     });
     // update_recipe tool
-    server.tool("update_recipe", `Update an existing recipe - Plus subscription required.
-
-Parameters:
-- recipeId (required): ID of the recipe
-- summary: New name
-- description: New description
-
+    server.tool("update_recipe", `Update an existing recipe - Plus subscription required.
+
+Parameters:
+- recipeId (required): ID of the recipe
+- summary: New name
+- description: New description
+
 Returns: The updated recipe.`, {
         recipeId: z.string().describe("ID of the recipe to update"),
         summary: z.string().optional().describe("New recipe name"),
@@ -169,11 +169,11 @@ Returns: The updated recipe.`, {
         }
     });
     // delete_recipe tool
-    server.tool("delete_recipe", `Delete a recipe - Plus subscription required.
-
-Parameters:
-- recipeId (required): ID of the recipe to delete
-
+    server.tool("delete_recipe", `Delete a recipe - Plus subscription required.
+
+Parameters:
+- recipeId (required): ID of the recipe to delete
+
 Note: This permanently removes the recipe.`, {
         recipeId: z.string().describe("ID of the recipe to delete"),
     }, async ({ recipeId }) => {
@@ -191,15 +191,15 @@ Note: This permanently removes the recipe.`, {
         }
     });
     // add_recipe_to_grocery_list tool
-    server.tool("add_recipe_to_grocery_list", `Add a recipe's ingredients to the grocery list - Plus subscription required.
-
-Use this when:
-- Planning to make a recipe and need to buy ingredients
-- Adding meal ingredients to shopping list
-
-Parameters:
-- recipeId (required): ID of the recipe
-
+    server.tool("add_recipe_to_grocery_list", `Add a recipe's ingredients to the grocery list - Plus subscription required.
+
+Use this when:
+- Planning to make a recipe and need to buy ingredients
+- Adding meal ingredients to shopping list
+
+Parameters:
+- recipeId (required): ID of the recipe
+
 Returns: Confirmation that ingredients were added.`, {
         recipeId: z.string().describe("ID of the recipe"),
     }, async ({ recipeId }) => {
@@ -222,16 +222,16 @@ Returns: Confirmation that ingredients were added.`, {
         }
     });
     // get_meal_sittings tool
-    server.tool("get_meal_sittings", `Get scheduled meals for a date range - Plus subscription required.
-
-Use this when:
-- Viewing the meal plan for the week
-- Checking what's scheduled for dinner
-
-Parameters:
-- date: Start date (defaults to today)
-- dateEnd: End date (defaults to 7 days from start)
-
+    server.tool("get_meal_sittings", `Get scheduled meals for a date range - Plus subscription required.
+
+Use this when:
+- Viewing the meal plan for the week
+- Checking what's scheduled for dinner
+
+Parameters:
+- date: Start date (defaults to today)
+- dateEnd: End date (defaults to 7 days from start)
+
 Returns: List of scheduled meals.`, {
         date: z.string().optional().describe("Start date (YYYY-MM-DD or 'today')"),
         dateEnd: z.string().optional().describe("End date (YYYY-MM-DD)"),
@@ -291,20 +291,20 @@ Returns: List of scheduled meals.`, {
         }
     });
     // create_meal_sitting tool
-    server.tool("create_meal_sitting", `Schedule a meal for a specific date - Plus subscription required.
-
-Use this when:
-- Planning meals for the week
-- Scheduling a recipe for dinner
-
-Parameters:
-- date (required): Date for the meal (YYYY-MM-DD)
-- mealCategoryId (required): Meal category ID (use get_meal_categories to find "Dinner" etc.)
-- summary: What the meal is, as free text, e.g. "Thai green curry". No recipe needed.
-- recipeId: A saved recipe to link instead of, or as well as, a summary.
-
-Give at least one of summary or recipeId.
-
+    server.tool("create_meal_sitting", `Schedule a meal for a specific date - Plus subscription required.
+
+Use this when:
+- Planning meals for the week
+- Scheduling a recipe for dinner
+
+Parameters:
+- date (required): Date for the meal (YYYY-MM-DD)
+- mealCategoryId (required): Meal category ID (use get_meal_categories to find "Dinner" etc.)
+- summary: What the meal is, as free text, e.g. "Thai green curry". No recipe needed.
+- recipeId: A saved recipe to link instead of, or as well as, a summary.
+
+Give at least one of summary or recipeId.
+
 Returns: The created meal sitting.`, {
         date: z.string().describe("Date for the meal (YYYY-MM-DD or 'today', 'tomorrow')"),
         mealCategoryId: z.string().describe("Meal category ID (e.g., ID for 'Dinner')"),
@@ -344,23 +344,23 @@ Returns: The created meal sitting.`, {
         }
     });
     // update_meal_sitting tool
-    server.tool("update_meal_sitting", `Edit or move a scheduled meal - Plus subscription required.
-
-Use this when:
-- Renaming a planned meal, or changing its note or category
-- Moving a meal to another day
-
-Parameters:
-- sittingId (required): from get_meal_sittings
-- date (required): the meal's CURRENT date (YYYY-MM-DD), also from get_meal_sittings
-- newDate: move the meal to this date
-- summary: new meal name
-- note: new note
-- mealCategoryId: move to another meal category (use get_meal_categories)
-
-Give at least one change. Only one-off meals can be edited here; repeating meals
-must be edited in the Skylight app.
-
+    server.tool("update_meal_sitting", `Edit or move a scheduled meal - Plus subscription required.
+
+Use this when:
+- Renaming a planned meal, or changing its note or category
+- Moving a meal to another day
+
+Parameters:
+- sittingId (required): from get_meal_sittings
+- date (required): the meal's CURRENT date (YYYY-MM-DD), also from get_meal_sittings
+- newDate: move the meal to this date
+- summary: new meal name
+- note: new note
+- mealCategoryId: move to another meal category (use get_meal_categories)
+
+Give at least one change. Only one-off meals can be edited here; repeating meals
+must be edited in the Skylight app.
+
 Returns: What changed.`, {
         sittingId: z.string().describe("Sitting ID from get_meal_sittings"),
         date: z.string().describe("The meal's current date (YYYY-MM-DD)"),
@@ -424,18 +424,18 @@ Returns: What changed.`, {
         }
     });
     // delete_meal_sitting tool
-    server.tool("delete_meal_sitting", `Delete a scheduled meal - Plus subscription required. THIS CANNOT BE UNDONE.
-
-Use this when:
-- Removing a meal that was planned by mistake or is no longer happening
-
-Parameters:
-- sittingId (required): from get_meal_sittings
-- date (required): the meal's date (YYYY-MM-DD)
-- confirm: must be true to delete. Without it nothing is deleted and the meal that would be removed is shown.
-
-Only one-off meals can be deleted here; repeating meals must be handled in the Skylight app.
-
+    server.tool("delete_meal_sitting", `Delete a scheduled meal - Plus subscription required. THIS CANNOT BE UNDONE.
+
+Use this when:
+- Removing a meal that was planned by mistake or is no longer happening
+
+Parameters:
+- sittingId (required): from get_meal_sittings
+- date (required): the meal's date (YYYY-MM-DD)
+- confirm: must be true to delete. Without it nothing is deleted and the meal that would be removed is shown.
+
+Only one-off meals can be deleted here; repeating meals must be handled in the Skylight app.
+
 Returns: Confirmation that Skylight removed the meal.`, {
         sittingId: z.string().describe("Sitting ID from get_meal_sittings"),
         date: z.string().describe("The meal's date (YYYY-MM-DD)"),

package/dist/tools/messages.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"messages.d.ts","sourceRoot":"","sources":["../../src/tools/messages.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AASzE,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,SAAS,GAAG,IAAI,CA4L5D"}
+{"version":3,"file":"messages.d.ts","sourceRoot":"","sources":["../../src/tools/messages.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AASzE,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,SAAS,GAAG,IAAI,CA8K5D"}

package/dist/tools/messages.js

@@ -1,18 +1,18 @@
 import { z } from "zod";
 import { assertNudgeId, createNudge, deleteNudge, findNudge, getNudges, updateNudge } from "../api/endpoints/messages.js";
-import { getCategories, findCategoryByName, resolveProfileIds } from "../api/endpoints/categories.js";
+import { getCategories, resolveProfile, resolveProfileIds } from "../api/endpoints/categories.js";
 import { getConfig } from "../config.js";
 import { parseDate, getDateOffset } from "../utils/dates.js";
 import { dateInZone, formatDay, formatTime } from "../utils/schedule.js";
 import { formatErrorForMcp } from "../utils/errors.js";
 export function registerMessageTools(server) {
-    server.tool("get_messages", `Get messages (Skylight calls them "nudges") shown on the family frame.
-
-Use this when:
-- Checking what has already been posted to the frame
-- Avoiding a duplicate before sending a reminder
-
-Returns: Messages grouped by day with time, text, recipients and sender.
+    server.tool("get_messages", `Get messages (Skylight calls them "nudges") shown on the family frame.
+
+Use this when:
+- Checking what has already been posted to the frame
+- Avoiding a duplicate before sending a reminder
+
+Returns: Messages grouped by day with time, text, recipients and sender.
 Defaults to the last 7 days through the next 7 days. Max 31 days.`, {
         date: z.string().optional().describe("Start date (YYYY-MM-DD or 'today'). Default: 7 days ago."),
         dateEnd: z.string().optional().describe("End date, inclusive. Default: 7 days ahead."),
@@ -51,17 +51,17 @@ Defaults to the last 7 days through the next 7 days. Max 31 days.`, {
             return { content: [{ type: "text", text: formatErrorForMcp(error) }], isError: true };
         }
     });
-    server.tool("send_message", `Post a message to the family frame now, on all devices. Shown to everyone unless "to" names profiles.
-
-PERMANENT in practice: the Skylight app has no way to delete a message (delete_message
-is experimental), and it appears on the family frame for the whole
-household immediately.
-
-Two-step by design. Called without confirm it only previews and posts nothing.
-Show the user the exact text and get a clear yes, then call again with confirm: true.
-Never pass confirm: true on the first call, and never invent message text the user
-did not ask for. Read aloud is OFF by default; enable it only if the user asked.
-
+    server.tool("send_message", `Post a message to the family frame now, on all devices. Shown to everyone unless "to" names profiles.
+
+PERMANENT in practice: the Skylight app has no way to delete a message (delete_message
+is experimental), and it appears on the family frame for the whole
+household immediately.
+
+Two-step by design. Called without confirm it only previews and posts nothing.
+Show the user the exact text and get a clear yes, then call again with confirm: true.
+Never pass confirm: true on the first call, and never invent message text the user
+did not ask for. Read aloud is OFF by default; enable it only if the user asked.
+
 Check get_messages first to avoid posting a duplicate.`, {
         body: z.string().min(1).max(300).describe("Message text, up to 300 characters."),
         readAloud: z.boolean().optional().describe("Speak the message on the frame when delivered. Default false."),
@@ -76,14 +76,8 @@ Check get_messages first to avoid posting a duplicate.`, {
             const recipients = to && to.length > 0 ? await resolveProfileIds(to) : undefined;
             const audience = recipients ? recipients.labels.join(", ") : "everyone";
             let senderCategoryId;
-            if (from) {
-                const match = await findCategoryByName(from);
-                if (!match) {
-                    const known = (await getCategories()).map((c) => c.attributes.label).filter(Boolean).join(", ");
-                    throw new Error(`No profile called "${from}". Profiles: ${known}.`);
-                }
-                senderCategoryId = match.id;
-            }
+            if (from)
+                senderCategoryId = (await resolveProfile(from)).id;
             const who = senderCategoryId ? ` from ${from}` : "";
             if (confirm !== true) {
                 return {
@@ -105,11 +99,11 @@ Check get_messages first to avoid posting a duplicate.`, {
             return { content: [{ type: "text", text: formatErrorForMcp(error) }], isError: true };
         }
     });
-    server.tool("update_message", `Edit the text (and optionally the sender) of a message already on the frame.
-
-Only messages sent to everyone on all devices and not repeating can be edited;
-anything else must be edited in the Skylight app. Delivery time and read-aloud
-setting are kept. The edit is visible on the frame immediately. Get the message
+    server.tool("update_message", `Edit the text (and optionally the sender) of a message already on the frame.
+
+Only messages sent to everyone on all devices and not repeating can be edited;
+anything else must be edited in the Skylight app. Delivery time and read-aloud
+setting are kept. The edit is visible on the frame immediately. Get the message
 ID from get_messages (looks within 31 days either side of today).`, {
         messageId: z.string().describe("Numeric message ID from get_messages."),
         body: z.string().min(1).max(300).describe("New message text, up to 300 characters."),
@@ -125,14 +119,8 @@ ID from get_messages (looks within 31 days either side of today).`, {
             if (!existing)
                 throw new Error(`No message with ID ${id} within 31 days of today.`);
             let senderCategoryId;
-            if (from) {
-                const match = await findCategoryByName(from);
-                if (!match) {
-                    const known = (await getCategories()).map((c) => c.attributes.label).filter(Boolean).join(", ");
-                    throw new Error(`No profile called "${from}". Profiles: ${known}.`);
-                }
-                senderCategoryId = match.id;
-            }
+            if (from)
+                senderCategoryId = (await resolveProfile(from)).id;
             await updateNudge({ existing, body: text, senderCategoryId, timeZone: timezone });
             return { content: [{ type: "text", text: `Updated message ${id}: "${text}"` }] };
         }
@@ -140,15 +128,15 @@ ID from get_messages (looks within 31 days either side of today).`, {
             return { content: [{ type: "text", text: formatErrorForMcp(error) }], isError: true };
         }
     });
-    server.tool("delete_message", `EXPERIMENTAL: delete a message from the family frame.
-
-The Skylight app has no delete button for messages. This calls the delete endpoint
-that other Skylight clients use; it is unverified on this account until tested, so a
-failure is expected to be reported plainly, not retried.
-
-Two-step. Without confirm it only previews which message would go. Show the user the
-text and get a clear yes before calling with confirm: true. After deleting it reads the
-message list back and reports whether the message is really gone. Get the ID from
+    server.tool("delete_message", `EXPERIMENTAL: delete a message from the family frame.
+
+The Skylight app has no delete button for messages. This calls the delete endpoint
+that other Skylight clients use; it is unverified on this account until tested, so a
+failure is expected to be reported plainly, not retried.
+
+Two-step. Without confirm it only previews which message would go. Show the user the
+text and get a clear yes before calling with confirm: true. After deleting it reads the
+message list back and reports whether the message is really gone. Get the ID from
 get_messages (looks within 31 days either side of today).`, {
         messageId: z.string().describe("Numeric message ID from get_messages."),
         confirm: z.boolean().optional().describe("Must be true to actually delete. Default false: preview only."),