@davidwoods/skylight-mcp 0.0.0-stage → 1.7.0

package/dist/tools/messages.js

@@ -0,0 +1,195 @@
+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 { 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.
+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."),
+    }, async ({ date, dateEnd }) => {
+        try {
+            const { timezone } = getConfig();
+            const start = date ? parseDate(date, timezone) : getDateOffset(-7, timezone);
+            const end = dateEnd ? parseDate(dateEnd, timezone) : getDateOffset(7, timezone);
+            if (end < start)
+                throw new Error("dateEnd is before date.");
+            const days = (Date.parse(end) - Date.parse(start)) / 86_400_000 + 1;
+            if (days > 31)
+                throw new Error("Range is limited to 31 days.");
+            const [nudges, categories] = await Promise.all([
+                getNudges(start, end, timezone),
+                getCategories().catch(() => []),
+            ]);
+            const names = new Map(categories.map((c) => [c.id, c.attributes.label ?? `profile ${c.id}`]));
+            if (nudges.length === 0) {
+                return { content: [{ type: "text", text: `No messages from ${start} to ${end}.` }] };
+            }
+            const sorted = [...nudges].sort((a, b) => Date.parse(a.attributes.deliver_at ?? "") - Date.parse(b.attributes.deliver_at ?? ""));
+            const byDay = new Map();
+            for (const n of sorted) {
+                const at = Date.parse(n.attributes.deliver_at ?? "");
+                if (Number.isNaN(at))
+                    continue;
+                const day = dateInZone(at, timezone);
+                const line = `- ${formatTime(at, timezone)}: "${n.attributes.body ?? ""}"${describeRoute(n, names)} [message ID: ${n.id}]`;
+                byDay.set(day, [...(byDay.get(day) ?? []), line]);
+            }
+            const text = [...byDay.entries()].map(([d, lines]) => `${formatDay(d)}\n${lines.join("\n")}`).join("\n\n");
+            return { content: [{ type: "text", text: `Messages ${start} to ${end}:\n\n${text}` }] };
+        }
+        catch (error) {
+            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.
+
+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."),
+        from: z.string().optional().describe("Optional sender profile name, e.g. a family member. Omit for no sender."),
+        to: z.array(z.string()).optional().describe("Profile names to send to (see get_family_members), e.g. [\"Jordan\"]. Omit to send to everyone."),
+        confirm: z.boolean().optional().describe("Must be true to actually post. Default false: preview only."),
+    }, async ({ body, readAloud, from, to, confirm }) => {
+        try {
+            const text = body.trim();
+            if (!text)
+                throw new Error("Message is empty.");
+            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;
+            }
+            const who = senderCategoryId ? ` from ${from}` : "";
+            if (confirm !== true) {
+                return {
+                    content: [
+                        {
+                            type: "text",
+                            text: `NOT SENT. Preview: would post to ${audience} on all devices${who}${readAloud ? ", read aloud" : ", silent"}: "${text}"\n\nDeleting a message afterwards is experimental. If the user approves this exact text, call send_message again with confirm: true.`,
+                        },
+                    ],
+                };
+            }
+            const sent = await createNudge({ body: text, readAloud: readAloud === true, senderCategoryId, recipientCategoryIds: recipients?.ids, timeZone: getConfig().timezone });
+            const id = sent?.id ? ` [message ID: ${sent.id}]` : "";
+            return {
+                content: [{ type: "text", text: `Posted to the frame${recipients ? ` for ${audience}` : ""}${who}${readAloud ? " (read aloud)" : ""}: "${text}"${id}` }],
+            };
+        }
+        catch (error) {
+            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
+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."),
+        from: z.string().optional().describe("Optional new sender profile name. Omit to keep the current sender."),
+    }, async ({ messageId, body, from }) => {
+        try {
+            const id = assertNudgeId(messageId.trim());
+            const text = body.trim();
+            if (!text)
+                throw new Error("Message is empty.");
+            const { timezone } = getConfig();
+            const existing = await findNudge(id, timezone);
+            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;
+            }
+            await updateNudge({ existing, body: text, senderCategoryId, timeZone: timezone });
+            return { content: [{ type: "text", text: `Updated message ${id}: "${text}"` }] };
+        }
+        catch (error) {
+            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
+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."),
+    }, async ({ messageId, confirm }) => {
+        try {
+            const id = assertNudgeId(messageId.trim());
+            const { timezone } = getConfig();
+            const existing = await findNudge(id, timezone);
+            if (!existing)
+                throw new Error(`No message with ID ${id} within 31 days of today.`);
+            const text = existing.attributes.body ?? "";
+            if (confirm !== true) {
+                return {
+                    content: [
+                        {
+                            type: "text",
+                            text: `NOT DELETED. This would delete message ${id}: "${text}"${existing.attributes.recurring ? " (it repeats; the whole series would go)" : ""}.\n\nIf the user approves, call delete_message again with confirm: true.`,
+                        },
+                    ],
+                };
+            }
+            await deleteNudge(existing);
+            const still = await findNudge(id, timezone);
+            if (still) {
+                throw new Error(`Skylight accepted the delete call but message ${id} is still listed. Do not assume it is gone; check the app.`);
+            }
+            return { content: [{ type: "text", text: `Deleted message ${id}: "${text}". Confirmed gone from the message list.` }] };
+        }
+        catch (error) {
+            return { content: [{ type: "text", text: formatErrorForMcp(error) }], isError: true };
+        }
+    });
+}
+function describeRoute(n, names) {
+    const a = n.attributes;
+    const rel = n.relationships;
+    const to = a.all_profiles
+        ? "everyone"
+        : (rel?.categories?.data ?? []).map((c) => names.get(c.id) ?? `profile ${c.id}`).join(", ");
+    const from = rel?.sender_category?.data ? names.get(rel.sender_category.data.id) : undefined;
+    const parts = [to ? `to ${to}` : "", from ? `from ${from}` : "", a.recurring ? "recurring" : "", a.all_devices ? "" : "selected devices"].filter(Boolean);
+    return parts.length ? ` (${parts.join(", ")})` : "";
+}
+//# sourceMappingURL=messages.js.map

package/dist/tools/messages.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"messages.js","sourceRoot":"","sources":["../../src/tools/messages.ts"],"names":[],"mappings":"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"}

package/dist/tools/misc.d.ts

@@ -0,0 +1,3 @@
+import type { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+export declare function registerMiscTools(server: McpServer): void;
+//# sourceMappingURL=misc.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"misc.d.ts","sourceRoot":"","sources":["../../src/tools/misc.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAMzE,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,SAAS,GAAG,IAAI,CAgHzD"}

package/dist/tools/misc.js

@@ -0,0 +1,102 @@
+import { getAvatars, getColors } from "../api/endpoints/misc.js";
+import { attributesOf } from "../api/endpoints/shape.js";
+import { formatErrorForMcp } from "../utils/errors.js";
+export function registerMiscTools(server) {
+    // get_avatars tool
+    server.tool("get_avatars", `Get available avatar options for Skylight profiles.
+
+Use this when:
+- Setting up a new family member profile
+- Changing someone's profile picture
+- Exploring available avatar options
+
+Returns: List of available avatars with their IDs and details.`, {}, async () => {
+        try {
+            const avatars = await getAvatars();
+            if (avatars.length === 0) {
+                return {
+                    content: [
+                        {
+                            type: "text",
+                            text: "No avatars found.",
+                        },
+                    ],
+                };
+            }
+            const avatarList = avatars
+                .map((avatar) => {
+                const parts = [`- Avatar (ID: ${avatar.id})`];
+                for (const [key, value] of Object.entries(avatar.attributes)) {
+                    if (value !== null && value !== undefined) {
+                        parts.push(`  ${key}: ${value}`);
+                    }
+                }
+                return parts.join("\n");
+            })
+                .join("\n\n");
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: `Available avatars:\n\n${avatarList}`,
+                    },
+                ],
+            };
+        }
+        catch (error) {
+            return {
+                content: [{ type: "text", text: formatErrorForMcp(error) }],
+                isError: true,
+            };
+        }
+    });
+    // get_colors tool
+    server.tool("get_colors", `Get available color options for Skylight profiles and lists.
+
+Use this when:
+- Choosing a color for a family member profile
+- Setting a list color
+- Exploring available color options
+
+Returns: List of available colors with their IDs and hex values.`, {}, async () => {
+        try {
+            const colors = await getColors();
+            if (colors.length === 0) {
+                return {
+                    content: [
+                        {
+                            type: "text",
+                            text: "No colors found.",
+                        },
+                    ],
+                };
+            }
+            const colorList = colors
+                .map((color) => {
+                const parts = [`- Color (ID: ${color.id})`];
+                for (const [key, value] of Object.entries(attributesOf(color))) {
+                    if (value !== null && value !== undefined) {
+                        parts.push(`  ${key}: ${value}`);
+                    }
+                }
+                return parts.join("\n");
+            })
+                .join("\n\n");
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: `Available colors:\n\n${colorList}`,
+                    },
+                ],
+            };
+        }
+        catch (error) {
+            return {
+                content: [{ type: "text", text: formatErrorForMcp(error) }],
+                isError: true,
+            };
+        }
+    });
+}
+//# sourceMappingURL=misc.js.map

package/dist/tools/misc.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"misc.js","sourceRoot":"","sources":["../../src/tools/misc.ts"],"names":[],"mappings":"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"}

package/dist/tools/photos.d.ts

@@ -0,0 +1,3 @@
+import type { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+export declare function registerPhotoTools(server: McpServer): void;
+//# sourceMappingURL=photos.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"photos.d.ts","sourceRoot":"","sources":["../../src/tools/photos.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAKzE,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,SAAS,GAAG,IAAI,CA6C1D"}

package/dist/tools/photos.js

@@ -0,0 +1,42 @@
+import { getAlbums } from "../api/endpoints/photos.js";
+import { formatErrorForMcp } from "../utils/errors.js";
+export function registerPhotoTools(server) {
+    // get_albums tool
+    server.tool("get_albums", `Get photo albums from Skylight - Plus subscription required.
+
+Use this when:
+- Viewing available photo albums
+- Getting album IDs for photo management
+
+Returns: List of photo albums with their IDs.`, {}, async () => {
+        try {
+            const albums = await getAlbums();
+            if (albums.length === 0) {
+                return {
+                    content: [{ type: "text", text: "No photo albums found." }],
+                };
+            }
+            const list = albums
+                .map((album) => {
+                const parts = [`- ${album.attributes.name ?? "Untitled Album"} (ID: ${album.id})`];
+                for (const [key, value] of Object.entries(album.attributes)) {
+                    if (value !== null && value !== undefined && key !== "name") {
+                        parts.push(`  ${key}: ${value}`);
+                    }
+                }
+                return parts.join("\n");
+            })
+                .join("\n\n");
+            return {
+                content: [{ type: "text", text: `Photo albums:\n\n${list}` }],
+            };
+        }
+        catch (error) {
+            return {
+                content: [{ type: "text", text: formatErrorForMcp(error) }],
+                isError: true,
+            };
+        }
+    });
+}
+//# sourceMappingURL=photos.js.map

package/dist/tools/photos.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"photos.js","sourceRoot":"","sources":["../../src/tools/photos.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,SAAS,EAAE,MAAM,4BAA4B,CAAC;AACvD,OAAO,EAAE,iBAAiB,EAAE,MAAM,oBAAoB,CAAC;AAEvD,MAAM,UAAU,kBAAkB,CAAC,MAAiB;IAClD,kBAAkB;IAClB,MAAM,CAAC,IAAI,CACT,YAAY,EACZ;;;;;;8CAM0C,EAC1C,EAAE,EACF,KAAK,IAAI,EAAE;QACT,IAAI,CAAC;YACH,MAAM,MAAM,GAAG,MAAM,SAAS,EAAE,CAAC;YAEjC,IAAI,MAAM,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;gBACxB,OAAO;oBACL,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAe,EAAE,IAAI,EAAE,wBAAwB,EAAE,CAAC;iBACrE,CAAC;YACJ,CAAC;YAED,MAAM,IAAI,GAAG,MAAM;iBAChB,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE;gBACb,MAAM,KAAK,GAAG,CAAC,KAAK,KAAK,CAAC,UAAU,CAAC,IAAI,IAAI,gBAAgB,SAAS,KAAK,CAAC,EAAE,GAAG,CAAC,CAAC;gBACnF,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,UAAU,CAAC,EAAE,CAAC;oBAC5D,IAAI,KAAK,KAAK,IAAI,IAAI,KAAK,KAAK,SAAS,IAAI,GAAG,KAAK,MAAM,EAAE,CAAC;wBAC5D,KAAK,CAAC,IAAI,CAAC,KAAK,GAAG,KAAK,KAAK,EAAE,CAAC,CAAC;oBACnC,CAAC;gBACH,CAAC;gBACD,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;YAC1B,CAAC,CAAC;iBACD,IAAI,CAAC,MAAM,CAAC,CAAC;YAEhB,OAAO;gBACL,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAe,EAAE,IAAI,EAAE,oBAAoB,IAAI,EAAE,EAAE,CAAC;aACvE,CAAC;QACJ,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,OAAO;gBACL,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAe,EAAE,IAAI,EAAE,iBAAiB,CAAC,KAAK,CAAC,EAAE,CAAC;gBACpE,OAAO,EAAE,IAAI;aACd,CAAC;QACJ,CAAC;IACH,CAAC,CACF,CAAC;AACJ,CAAC"}

package/dist/tools/planning.d.ts

@@ -0,0 +1,15 @@
+/**
+ * Planning tools: the ones a proactive assistant (Claude Duet) needs to
+ * reason about a family week in one or two calls instead of five.
+ *
+ *   get_week_overview  calendar + chores + meals + lists, day by day, compact
+ *   find_conflicts     overlapping timed events
+ *   find_free_slots    gaps of at least N minutes within a daily window
+ *   plan_week_meals    write several meal sittings in one call, with dry run
+ *
+ * Output deliberately omits emails, calendar ids and UIDs: they are noise for
+ * the model and personal data in every transcript.
+ */
+import type { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+export declare function registerPlanningTools(server: McpServer): void;
+//# sourceMappingURL=planning.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"planning.d.ts","sourceRoot":"","sources":["../../src/tools/planning.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAGH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAoEzE,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,SAAS,GAAG,IAAI,CA0P7D"}