@bmhall2/skylight-mcp 1.1.7

package/dist/tools/rewards.js

@@ -0,0 +1,338 @@
+import { z } from "zod";
+import { getRewards, getRewardPoints, createReward, updateReward, deleteReward, redeemReward, unredeemReward, } from "../api/endpoints/rewards.js";
+import { findCategoryByName } from "../api/endpoints/categories.js";
+import { formatErrorForMcp } from "../utils/errors.js";
+export function registerRewardTools(server) {
+    // get_rewards tool
+    server.tool("get_rewards", `Get available rewards that can be redeemed with reward points.
+
+For family gamification - shows rewards that family members can earn.
+
+Use this to answer:
+- "What rewards can we redeem?"
+- "What can the kids earn?"
+- "Show available rewards"`, {
+        redeemedSince: z
+            .string()
+            .optional()
+            .describe("Filter to rewards redeemed after this date (ISO datetime)"),
+    }, async ({ redeemedSince }) => {
+        try {
+            const rewards = await getRewards({
+                redeemedAtMin: redeemedSince,
+            });
+            if (rewards.length === 0) {
+                return {
+                    content: [
+                        {
+                            type: "text",
+                            text: "No rewards found.",
+                        },
+                    ],
+                };
+            }
+            const rewardList = rewards
+                .map((reward) => {
+                const parts = [`- Reward (ID: ${reward.id})`];
+                const attrs = reward.attributes;
+                for (const [key, value] of Object.entries(attrs)) {
+                    if (value !== null && value !== undefined) {
+                        parts.push(`  ${key}: ${value}`);
+                    }
+                }
+                return parts.join("\n");
+            })
+                .join("\n\n");
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: `Available rewards:\n\n${rewardList}`,
+                    },
+                ],
+            };
+        }
+        catch (error) {
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: formatErrorForMcp(error),
+                    },
+                ],
+                isError: true,
+            };
+        }
+    });
+    // get_reward_points tool
+    server.tool("get_reward_points", `Get reward points balance for family members.
+
+Shows how many reward points each family member has earned.
+
+Use this to answer:
+- "How many points does [name] have?"
+- "Show reward points balance"
+- "Who has the most points?"`, {}, async () => {
+        try {
+            const points = await getRewardPoints();
+            if (points.length === 0) {
+                return {
+                    content: [
+                        {
+                            type: "text",
+                            text: "No reward points found.",
+                        },
+                    ],
+                };
+            }
+            const pointsList = points
+                .map((point) => {
+                const parts = [`- Points (ID: ${point.id})`];
+                const attrs = point.attributes;
+                for (const [key, value] of Object.entries(attrs)) {
+                    if (value !== null && value !== undefined) {
+                        parts.push(`  ${key}: ${value}`);
+                    }
+                }
+                return parts.join("\n");
+            })
+                .join("\n\n");
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: `Reward points:\n\n${pointsList}`,
+                    },
+                ],
+            };
+        }
+        catch (error) {
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: formatErrorForMcp(error),
+                    },
+                ],
+                isError: true,
+            };
+        }
+    });
+    // create_reward tool
+    server.tool("create_reward", `Create a new reward that can be redeemed with points (Plus subscription required).
+
+Use this when:
+- Adding a new reward: "Create a reward for 30 minutes of screen time"
+- Setting up family incentives: "Add a pizza night reward worth 100 points"
+
+Parameters:
+- name (required): Reward name (e.g., "30 min Screen Time")
+- pointValue (required): Points needed to redeem this reward
+- description: Additional details about the reward
+- emojiIcon: Emoji to display with the reward
+- assignee: Family member name to assign this reward to
+- respawnOnRedemption: If true, reward can be redeemed multiple times
+
+Returns: The created reward details.`, {
+        name: z.string().describe("Reward name (e.g., '30 min Screen Time')"),
+        pointValue: z.number().describe("Points needed to redeem this reward"),
+        description: z.string().optional().describe("Additional details about the reward"),
+        emojiIcon: z.string().optional().describe("Emoji for the reward (e.g., '🎮')"),
+        assignee: z.string().optional().describe("Family member to assign this reward to"),
+        respawnOnRedemption: z.boolean().optional().default(false).describe("Can be redeemed multiple times"),
+    }, async ({ name, pointValue, description, emojiIcon, assignee, respawnOnRedemption }) => {
+        try {
+            let categoryIds;
+            if (assignee) {
+                const category = await findCategoryByName(assignee);
+                if (!category) {
+                    return {
+                        content: [{ type: "text", text: `Could not find family member "${assignee}"` }],
+                        isError: true,
+                    };
+                }
+                categoryIds = [category.id];
+            }
+            const reward = await createReward({
+                name,
+                pointValue,
+                description,
+                emojiIcon,
+                categoryIds,
+                respawnOnRedemption,
+            });
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: `Created reward "${name}" worth ${pointValue} points (ID: ${reward.id})`,
+                    },
+                ],
+            };
+        }
+        catch (error) {
+            return {
+                content: [{ type: "text", text: formatErrorForMcp(error) }],
+                isError: true,
+            };
+        }
+    });
+    // update_reward tool
+    server.tool("update_reward", `Update an existing reward (Plus subscription required).
+
+Use this when:
+- Changing point value: "Make the screen time reward cost 50 points"
+- Updating reward details: "Add a description to the pizza reward"
+
+Parameters:
+- rewardId (required): ID of the reward (from get_rewards)
+- name: New reward name
+- pointValue: New point cost
+- description: Updated description
+- emojiIcon: Updated emoji
+
+Returns: The updated reward details.`, {
+        rewardId: z.string().describe("ID of the reward to update"),
+        name: z.string().optional().describe("New reward name"),
+        pointValue: z.number().optional().describe("New point cost"),
+        description: z.string().nullable().optional().describe("Updated description (null to clear)"),
+        emojiIcon: z.string().nullable().optional().describe("Updated emoji (null to clear)"),
+        respawnOnRedemption: z.boolean().optional().describe("Can be redeemed multiple times"),
+    }, async ({ rewardId, name, pointValue, description, emojiIcon, respawnOnRedemption }) => {
+        try {
+            const updates = {};
+            if (name !== undefined)
+                updates.name = name;
+            if (pointValue !== undefined)
+                updates.pointValue = pointValue;
+            if (description !== undefined)
+                updates.description = description;
+            if (emojiIcon !== undefined)
+                updates.emojiIcon = emojiIcon;
+            if (respawnOnRedemption !== undefined)
+                updates.respawnOnRedemption = respawnOnRedemption;
+            const reward = await updateReward(rewardId, updates);
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: `Updated reward (ID: ${reward.id})`,
+                    },
+                ],
+            };
+        }
+        catch (error) {
+            return {
+                content: [{ type: "text", text: formatErrorForMcp(error) }],
+                isError: true,
+            };
+        }
+    });
+    // delete_reward tool
+    server.tool("delete_reward", `Delete a reward (Plus subscription required).
+
+Use this when:
+- Removing an old reward
+- Cleaning up unused rewards
+
+Parameters:
+- rewardId (required): ID of the reward to delete (from get_rewards)
+
+Note: This permanently removes the reward.`, {
+        rewardId: z.string().describe("ID of the reward to delete"),
+    }, async ({ rewardId }) => {
+        try {
+            await deleteReward(rewardId);
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: `Deleted reward (ID: ${rewardId})`,
+                    },
+                ],
+            };
+        }
+        catch (error) {
+            return {
+                content: [{ type: "text", text: formatErrorForMcp(error) }],
+                isError: true,
+            };
+        }
+    });
+    // redeem_reward tool
+    server.tool("redeem_reward", `Redeem a reward using points (Plus subscription required).
+
+Use this when:
+- A family member wants to cash in points: "Redeem the screen time reward for Johnny"
+- Claiming an earned reward
+
+Parameters:
+- rewardId (required): ID of the reward to redeem (from get_rewards)
+- assignee: Family member redeeming the reward (uses their points)
+
+Returns: The redeemed reward details.`, {
+        rewardId: z.string().describe("ID of the reward to redeem"),
+        assignee: z.string().optional().describe("Family member redeeming the reward"),
+    }, async ({ rewardId, assignee }) => {
+        try {
+            let categoryId;
+            if (assignee) {
+                const category = await findCategoryByName(assignee);
+                if (!category) {
+                    return {
+                        content: [{ type: "text", text: `Could not find family member "${assignee}"` }],
+                        isError: true,
+                    };
+                }
+                categoryId = category.id;
+            }
+            const reward = await redeemReward(rewardId, categoryId);
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: `Redeemed reward (ID: ${reward.id})${assignee ? ` for ${assignee}` : ""}`,
+                    },
+                ],
+            };
+        }
+        catch (error) {
+            return {
+                content: [{ type: "text", text: formatErrorForMcp(error) }],
+                isError: true,
+            };
+        }
+    });
+    // unredeem_reward tool
+    server.tool("unredeem_reward", `Cancel a reward redemption (Plus subscription required).
+
+Use this when:
+- A redemption was made by mistake
+- Undoing a reward claim
+
+Parameters:
+- rewardId (required): ID of the reward to unredeem
+
+Returns: The unredeemed reward details.`, {
+        rewardId: z.string().describe("ID of the reward to unredeem"),
+    }, async ({ rewardId }) => {
+        try {
+            const reward = await unredeemReward(rewardId);
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: `Unredeemed reward (ID: ${reward.id})`,
+                    },
+                ],
+            };
+        }
+        catch (error) {
+            return {
+                content: [{ type: "text", text: formatErrorForMcp(error) }],
+                isError: true,
+            };
+        }
+    });
+}
+//# sourceMappingURL=rewards.js.map

package/dist/tools/rewards.js.map

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

package/dist/tools/tasks.d.ts

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

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

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

package/dist/tools/tasks.js

@@ -0,0 +1,68 @@
+import { z } from "zod";
+import { createTaskBoxItem } from "../api/endpoints/taskbox.js";
+import { formatErrorForMcp } from "../utils/errors.js";
+export function registerTaskTools(server) {
+    // create_task tool
+    server.tool("create_task", `Add a task to the Skylight task box.
+
+The task box holds unscheduled tasks that can later be assigned to specific dates.
+
+Use this when the user says:
+- "Add XYZ to my task list"
+- "Remind me to do ABC" (without a specific date)
+- "Put 'clean garage' on the task box"
+
+The task will appear on the Skylight display in the task box.`, {
+        summary: z.string().describe("Task description"),
+        emoji: z
+            .string()
+            .optional()
+            .describe("Emoji icon for the task (e.g., '🧹', '📞')"),
+        rewardPoints: z
+            .number()
+            .optional()
+            .describe("Reward points for completing this task (for gamification)"),
+        routine: z
+            .boolean()
+            .optional()
+            .default(false)
+            .describe("Is this a routine task?"),
+    }, async ({ summary, emoji, rewardPoints, routine }) => {
+        try {
+            const task = await createTaskBoxItem({
+                summary,
+                emojiIcon: emoji,
+                rewardPoints,
+                routine: routine ?? false,
+            });
+            const parts = [`Created task: "${task.attributes.summary}"`];
+            if (task.attributes.emoji_icon) {
+                parts.push(`Emoji: ${task.attributes.emoji_icon}`);
+            }
+            if (task.attributes.reward_points) {
+                parts.push(`Reward points: ${task.attributes.reward_points}`);
+            }
+            parts.push(`\nThe task has been added to the Skylight task box.`);
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: parts.join("\n"),
+                    },
+                ],
+            };
+        }
+        catch (error) {
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: formatErrorForMcp(error),
+                    },
+                ],
+                isError: true,
+            };
+        }
+    });
+}
+//# sourceMappingURL=tasks.js.map

package/dist/tools/tasks.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tasks.js","sourceRoot":"","sources":["../../src/tools/tasks.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAGxB,OAAO,EAAE,iBAAiB,EAAE,MAAM,6BAA6B,CAAC;AAChE,OAAO,EAAE,iBAAiB,EAAE,MAAM,oBAAoB,CAAC;AAEvD,MAAM,UAAU,iBAAiB,CAAC,MAAiB;IACjD,mBAAmB;IACnB,MAAM,CAAC,IAAI,CACT,aAAa,EACb;;;;;;;;;8DAS0D,EAC1D;QACE,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,kBAAkB,CAAC;QAChD,KAAK,EAAE,CAAC;aACL,MAAM,EAAE;aACR,QAAQ,EAAE;aACV,QAAQ,CAAC,4CAA4C,CAAC;QACzD,YAAY,EAAE,CAAC;aACZ,MAAM,EAAE;aACR,QAAQ,EAAE;aACV,QAAQ,CAAC,2DAA2D,CAAC;QACxE,OAAO,EAAE,CAAC;aACP,OAAO,EAAE;aACT,QAAQ,EAAE;aACV,OAAO,CAAC,KAAK,CAAC;aACd,QAAQ,CAAC,yBAAyB,CAAC;KACvC,EACD,KAAK,EAAE,EAAE,OAAO,EAAE,KAAK,EAAE,YAAY,EAAE,OAAO,EAAE,EAAE,EAAE;QAClD,IAAI,CAAC;YACH,MAAM,IAAI,GAAG,MAAM,iBAAiB,CAAC;gBACnC,OAAO;gBACP,SAAS,EAAE,KAAK;gBAChB,YAAY;gBACZ,OAAO,EAAE,OAAO,IAAI,KAAK;aAC1B,CAAC,CAAC;YAEH,MAAM,KAAK,GAAG,CAAC,kBAAkB,IAAI,CAAC,UAAU,CAAC,OAAO,GAAG,CAAC,CAAC;YAE7D,IAAI,IAAI,CAAC,UAAU,CAAC,UAAU,EAAE,CAAC;gBAC/B,KAAK,CAAC,IAAI,CAAC,UAAU,IAAI,CAAC,UAAU,CAAC,UAAU,EAAE,CAAC,CAAC;YACrD,CAAC;YAED,IAAI,IAAI,CAAC,UAAU,CAAC,aAAa,EAAE,CAAC;gBAClC,KAAK,CAAC,IAAI,CAAC,kBAAkB,IAAI,CAAC,UAAU,CAAC,aAAa,EAAE,CAAC,CAAC;YAChE,CAAC;YAED,KAAK,CAAC,IAAI,CAAC,qDAAqD,CAAC,CAAC;YAElE,OAAO;gBACL,OAAO,EAAE;oBACP;wBACE,IAAI,EAAE,MAAe;wBACrB,IAAI,EAAE,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC;qBACvB;iBACF;aACF,CAAC;QACJ,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,OAAO;gBACL,OAAO,EAAE;oBACP;wBACE,IAAI,EAAE,MAAe;wBACrB,IAAI,EAAE,iBAAiB,CAAC,KAAK,CAAC;qBAC/B;iBACF;gBACD,OAAO,EAAE,IAAI;aACd,CAAC;QACJ,CAAC;IACH,CAAC,CACF,CAAC;AACJ,CAAC"}

package/dist/utils/dates.d.ts

@@ -0,0 +1,26 @@
+/**
+ * Date utility functions for Skylight MCP
+ */
+/**
+ * Get today's date in YYYY-MM-DD format
+ */
+export declare function getTodayDate(timezone?: string): string;
+/**
+ * Get a date N days from today in YYYY-MM-DD format
+ */
+export declare function getDateOffset(days: number, timezone?: string): string;
+/**
+ * Parse a date string to YYYY-MM-DD format
+ * Accepts: YYYY-MM-DD, MM/DD/YYYY, or natural language like "today", "tomorrow"
+ */
+export declare function parseDate(input: string, timezone?: string): string;
+/**
+ * Parse a time string to HH:MM format (24-hour)
+ * Accepts: "10:00", "10:00 AM", "2:30 PM", "14:30"
+ */
+export declare function parseTime(input: string): string;
+/**
+ * Format a date for display
+ */
+export declare function formatDateForDisplay(dateStr: string): string;
+//# sourceMappingURL=dates.d.ts.map

package/dist/utils/dates.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dates.d.ts","sourceRoot":"","sources":["../../src/utils/dates.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH;;GAEG;AACH,wBAAgB,YAAY,CAAC,QAAQ,CAAC,EAAE,MAAM,GAAG,MAAM,CAMtD;AAED;;GAEG;AACH,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,MAAM,GAAG,MAAM,CAOrE;AAED;;;GAGG;AACH,wBAAgB,SAAS,CAAC,KAAK,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,MAAM,GAAG,MAAM,CA+ClE;AAED;;;GAGG;AACH,wBAAgB,SAAS,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAwB/C;AAED;;GAEG;AACH,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAO5D"}

package/dist/utils/dates.js

@@ -0,0 +1,109 @@
+/**
+ * Date utility functions for Skylight MCP
+ */
+/**
+ * Get today's date in YYYY-MM-DD format
+ */
+export function getTodayDate(timezone) {
+    const date = new Date();
+    if (timezone) {
+        return date.toLocaleDateString("en-CA", { timeZone: timezone });
+    }
+    return date.toISOString().split("T")[0];
+}
+/**
+ * Get a date N days from today in YYYY-MM-DD format
+ */
+export function getDateOffset(days, timezone) {
+    const date = new Date();
+    date.setDate(date.getDate() + days);
+    if (timezone) {
+        return date.toLocaleDateString("en-CA", { timeZone: timezone });
+    }
+    return date.toISOString().split("T")[0];
+}
+/**
+ * Parse a date string to YYYY-MM-DD format
+ * Accepts: YYYY-MM-DD, MM/DD/YYYY, or natural language like "today", "tomorrow"
+ */
+export function parseDate(input, timezone) {
+    const lower = input.toLowerCase().trim();
+    // Handle natural language
+    if (lower === "today") {
+        return getTodayDate(timezone);
+    }
+    if (lower === "tomorrow") {
+        return getDateOffset(1, timezone);
+    }
+    if (lower === "yesterday") {
+        return getDateOffset(-1, timezone);
+    }
+    // Handle day of week (next occurrence)
+    const days = ["sunday", "monday", "tuesday", "wednesday", "thursday", "friday", "saturday"];
+    const dayIndex = days.indexOf(lower);
+    if (dayIndex !== -1) {
+        const today = new Date();
+        const todayDay = today.getDay();
+        let daysUntil = dayIndex - todayDay;
+        if (daysUntil <= 0) {
+            daysUntil += 7; // Next week if today or past
+        }
+        return getDateOffset(daysUntil, timezone);
+    }
+    // Already in YYYY-MM-DD format
+    if (/^\d{4}-\d{2}-\d{2}$/.test(input)) {
+        return input;
+    }
+    // MM/DD/YYYY format
+    const usMatch = input.match(/^(\d{1,2})\/(\d{1,2})\/(\d{4})$/);
+    if (usMatch) {
+        const [, month, day, year] = usMatch;
+        return `${year}-${month.padStart(2, "0")}-${day.padStart(2, "0")}`;
+    }
+    // Try parsing as a date
+    const parsed = new Date(input);
+    if (!isNaN(parsed.getTime())) {
+        return parsed.toISOString().split("T")[0];
+    }
+    // Return as-is if we can't parse it
+    return input;
+}
+/**
+ * Parse a time string to HH:MM format (24-hour)
+ * Accepts: "10:00", "10:00 AM", "2:30 PM", "14:30"
+ */
+export function parseTime(input) {
+    const trimmed = input.trim();
+    // Already in HH:MM format (24-hour)
+    if (/^\d{1,2}:\d{2}$/.test(trimmed)) {
+        const [hours, minutes] = trimmed.split(":");
+        return `${hours.padStart(2, "0")}:${minutes}`;
+    }
+    // 12-hour format with AM/PM
+    const match = trimmed.match(/^(\d{1,2}):(\d{2})\s*(AM|PM)$/i);
+    if (match) {
+        const [, hours, minutes, period] = match;
+        let h = parseInt(hours, 10);
+        if (period.toUpperCase() === "PM" && h !== 12) {
+            h += 12;
+        }
+        else if (period.toUpperCase() === "AM" && h === 12) {
+            h = 0;
+        }
+        return `${h.toString().padStart(2, "0")}:${minutes}`;
+    }
+    // Return as-is
+    return trimmed;
+}
+/**
+ * Format a date for display
+ */
+export function formatDateForDisplay(dateStr) {
+    const date = new Date(dateStr + "T00:00:00");
+    return date.toLocaleDateString("en-US", {
+        weekday: "short",
+        month: "short",
+        day: "numeric",
+    });
+}
+//# sourceMappingURL=dates.js.map

package/dist/utils/dates.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"dates.js","sourceRoot":"","sources":["../../src/utils/dates.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH;;GAEG;AACH,MAAM,UAAU,YAAY,CAAC,QAAiB;IAC5C,MAAM,IAAI,GAAG,IAAI,IAAI,EAAE,CAAC;IACxB,IAAI,QAAQ,EAAE,CAAC;QACb,OAAO,IAAI,CAAC,kBAAkB,CAAC,OAAO,EAAE,EAAE,QAAQ,EAAE,QAAQ,EAAE,CAAC,CAAC;IAClE,CAAC;IACD,OAAO,IAAI,CAAC,WAAW,EAAE,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC;AAC1C,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,aAAa,CAAC,IAAY,EAAE,QAAiB;IAC3D,MAAM,IAAI,GAAG,IAAI,IAAI,EAAE,CAAC;IACxB,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,OAAO,EAAE,GAAG,IAAI,CAAC,CAAC;IACpC,IAAI,QAAQ,EAAE,CAAC;QACb,OAAO,IAAI,CAAC,kBAAkB,CAAC,OAAO,EAAE,EAAE,QAAQ,EAAE,QAAQ,EAAE,CAAC,CAAC;IAClE,CAAC;IACD,OAAO,IAAI,CAAC,WAAW,EAAE,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC;AAC1C,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,SAAS,CAAC,KAAa,EAAE,QAAiB;IACxD,MAAM,KAAK,GAAG,KAAK,CAAC,WAAW,EAAE,CAAC,IAAI,EAAE,CAAC;IAEzC,0BAA0B;IAC1B,IAAI,KAAK,KAAK,OAAO,EAAE,CAAC;QACtB,OAAO,YAAY,CAAC,QAAQ,CAAC,CAAC;IAChC,CAAC;IACD,IAAI,KAAK,KAAK,UAAU,EAAE,CAAC;QACzB,OAAO,aAAa,CAAC,CAAC,EAAE,QAAQ,CAAC,CAAC;IACpC,CAAC;IACD,IAAI,KAAK,KAAK,WAAW,EAAE,CAAC;QAC1B,OAAO,aAAa,CAAC,CAAC,CAAC,EAAE,QAAQ,CAAC,CAAC;IACrC,CAAC;IAED,uCAAuC;IACvC,MAAM,IAAI,GAAG,CAAC,QAAQ,EAAE,QAAQ,EAAE,SAAS,EAAE,WAAW,EAAE,UAAU,EAAE,QAAQ,EAAE,UAAU,CAAC,CAAC;IAC5F,MAAM,QAAQ,GAAG,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;IACrC,IAAI,QAAQ,KAAK,CAAC,CAAC,EAAE,CAAC;QACpB,MAAM,KAAK,GAAG,IAAI,IAAI,EAAE,CAAC;QACzB,MAAM,QAAQ,GAAG,KAAK,CAAC,MAAM,EAAE,CAAC;QAChC,IAAI,SAAS,GAAG,QAAQ,GAAG,QAAQ,CAAC;QACpC,IAAI,SAAS,IAAI,CAAC,EAAE,CAAC;YACnB,SAAS,IAAI,CAAC,CAAC,CAAC,6BAA6B;QAC/C,CAAC;QACD,OAAO,aAAa,CAAC,SAAS,EAAE,QAAQ,CAAC,CAAC;IAC5C,CAAC;IAED,+BAA+B;IAC/B,IAAI,qBAAqB,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC;QACtC,OAAO,KAAK,CAAC;IACf,CAAC;IAED,oBAAoB;IACpB,MAAM,OAAO,GAAG,KAAK,CAAC,KAAK,CAAC,iCAAiC,CAAC,CAAC;IAC/D,IAAI,OAAO,EAAE,CAAC;QACZ,MAAM,CAAC,EAAE,KAAK,EAAE,GAAG,EAAE,IAAI,CAAC,GAAG,OAAO,CAAC;QACrC,OAAO,GAAG,IAAI,IAAI,KAAK,CAAC,QAAQ,CAAC,CAAC,EAAE,GAAG,CAAC,IAAI,GAAG,CAAC,QAAQ,CAAC,CAAC,EAAE,GAAG,CAAC,EAAE,CAAC;IACrE,CAAC;IAED,wBAAwB;IACxB,MAAM,MAAM,GAAG,IAAI,IAAI,CAAC,KAAK,CAAC,CAAC;IAC/B,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC,EAAE,CAAC;QAC7B,OAAO,MAAM,CAAC,WAAW,EAAE,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC;IAC5C,CAAC;IAED,oCAAoC;IACpC,OAAO,KAAK,CAAC;AACf,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,SAAS,CAAC,KAAa;IACrC,MAAM,OAAO,GAAG,KAAK,CAAC,IAAI,EAAE,CAAC;IAE7B,oCAAoC;IACpC,IAAI,iBAAiB,CAAC,IAAI,CAAC,OAAO,CAAC,EAAE,CAAC;QACpC,MAAM,CAAC,KAAK,EAAE,OAAO,CAAC,GAAG,OAAO,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;QAC5C,OAAO,GAAG,KAAK,CAAC,QAAQ,CAAC,CAAC,EAAE,GAAG,CAAC,IAAI,OAAO,EAAE,CAAC;IAChD,CAAC;IAED,4BAA4B;IAC5B,MAAM,KAAK,GAAG,OAAO,CAAC,KAAK,CAAC,gCAAgC,CAAC,CAAC;IAC9D,IAAI,KAAK,EAAE,CAAC;QACV,MAAM,CAAC,EAAE,KAAK,EAAE,OAAO,EAAE,MAAM,CAAC,GAAG,KAAK,CAAC;QACzC,IAAI,CAAC,GAAG,QAAQ,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC;QAC5B,IAAI,MAAM,CAAC,WAAW,EAAE,KAAK,IAAI,IAAI,CAAC,KAAK,EAAE,EAAE,CAAC;YAC9C,CAAC,IAAI,EAAE,CAAC;QACV,CAAC;aAAM,IAAI,MAAM,CAAC,WAAW,EAAE,KAAK,IAAI,IAAI,CAAC,KAAK,EAAE,EAAE,CAAC;YACrD,CAAC,GAAG,CAAC,CAAC;QACR,CAAC;QACD,OAAO,GAAG,CAAC,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,CAAC,EAAE,GAAG,CAAC,IAAI,OAAO,EAAE,CAAC;IACvD,CAAC;IAED,eAAe;IACf,OAAO,OAAO,CAAC;AACjB,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,oBAAoB,CAAC,OAAe;IAClD,MAAM,IAAI,GAAG,IAAI,IAAI,CAAC,OAAO,GAAG,WAAW,CAAC,CAAC;IAC7C,OAAO,IAAI,CAAC,kBAAkB,CAAC,OAAO,EAAE;QACtC,OAAO,EAAE,OAAO;QAChB,KAAK,EAAE,OAAO;QACd,GAAG,EAAE,SAAS;KACf,CAAC,CAAC;AACL,CAAC"}

package/dist/utils/errors.d.ts

@@ -0,0 +1,45 @@
+/**
+ * Base error class for Skylight API errors
+ */
+export declare class SkylightError extends Error {
+    code: string;
+    statusCode?: number | undefined;
+    recoverable: boolean;
+    constructor(message: string, code: string, statusCode?: number | undefined, recoverable?: boolean);
+}
+/**
+ * Authentication failed - token may be expired or invalid
+ */
+export declare class AuthenticationError extends SkylightError {
+    constructor(message?: string);
+}
+/**
+ * Configuration error - missing or invalid settings
+ */
+export declare class ConfigurationError extends SkylightError {
+    constructor(message: string);
+}
+/**
+ * Resource not found
+ */
+export declare class NotFoundError extends SkylightError {
+    constructor(resource: string);
+}
+/**
+ * Rate limited by the API
+ */
+export declare class RateLimitError extends SkylightError {
+    constructor(retryAfter?: number);
+}
+/**
+ * API returned an unexpected response format
+ */
+export declare class ParseError extends SkylightError {
+    constructor(message?: string);
+}
+/**
+ * Format an error for MCP tool response
+ * Accepts unknown to handle any value from catch blocks safely
+ */
+export declare function formatErrorForMcp(error: unknown): string;
+//# sourceMappingURL=errors.d.ts.map

package/dist/utils/errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../src/utils/errors.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,qBAAa,aAAc,SAAQ,KAAK;IAG7B,IAAI,EAAE,MAAM;IACZ,UAAU,CAAC,EAAE,MAAM;IACnB,WAAW,EAAE,OAAO;gBAH3B,OAAO,EAAE,MAAM,EACR,IAAI,EAAE,MAAM,EACZ,UAAU,CAAC,EAAE,MAAM,YAAA,EACnB,WAAW,GAAE,OAAe;CAKtC;AAED;;GAEG;AACH,qBAAa,mBAAoB,SAAQ,aAAa;gBACxC,OAAO,GAAE,MAAuE;CAI7F;AAED;;GAEG;AACH,qBAAa,kBAAmB,SAAQ,aAAa;gBACvC,OAAO,EAAE,MAAM;CAI5B;AAED;;GAEG;AACH,qBAAa,aAAc,SAAQ,aAAa;gBAClC,QAAQ,EAAE,MAAM;CAI7B;AAED;;GAEG;AACH,qBAAa,cAAe,SAAQ,aAAa;gBACnC,UAAU,CAAC,EAAE,MAAM;CAShC;AAED;;GAEG;AACH,qBAAa,UAAW,SAAQ,aAAa;gBAC/B,OAAO,GAAE,MAAyC;CAI/D;AAED;;;GAGG;AACH,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CA0CxD"}