garmin-bud 0.2.0

package/dist/promptApi.js

@@ -0,0 +1,102 @@
+import Anthropic from "@anthropic-ai/sdk";
+import { randomBytes } from "node:crypto";
+import { createPromptJob, getPromptJob, updatePromptJob } from "./appDb.js";
+import { appConfig } from "./config.js";
+import { buildWatchSummary } from "./watchApi.js";
+import { logger } from "./utils/logger.js";
+// SECTION: Prompt API — Claude integration
+const MODEL = "claude-haiku-4-5-20251001";
+const MAX_TOKENS = 300;
+function buildJobId() {
+    return randomBytes(12).toString("hex");
+}
+function formatHealthContext(summary) {
+    const lines = ["Current health snapshot:"];
+    if (summary.recovery) {
+        lines.push(`- Recovery: ${summary.recovery.score}/100 (${summary.recovery.label})`);
+    }
+    if (summary.sleep) {
+        lines.push(`- Sleep last night: ${summary.sleep.hours}h${summary.sleep.score ? `, score ${summary.sleep.score}` : ""} (${summary.sleep.label})`);
+    }
+    if (summary.stress) {
+        lines.push(`- Avg stress (7d): ${summary.stress.avg} (${summary.stress.label})`);
+    }
+    if (summary.vo2max) {
+        lines.push(`- VO2 Max: ${summary.vo2max.value} (${summary.vo2max.trend})`);
+    }
+    if (summary.heart_rate) {
+        lines.push(`- Resting HR: ${summary.heart_rate.resting} bpm`);
+    }
+    if (summary.activity) {
+        lines.push(`- Last activity: ${summary.activity.name}${summary.activity.duration_min ? `, ${summary.activity.duration_min}min` : ""}${summary.activity.distance_km ? `, ${summary.activity.distance_km}km` : ""}`);
+    }
+    return lines.join("\n");
+}
+async function callClaude(prompt, healthContext) {
+    const apiKey = appConfig.anthropicApiKey;
+    if (!apiKey) {
+        throw new Error("ANTHROPIC_API_KEY not configured. Set it in the dashboard or .env file.");
+    }
+    const client = new Anthropic({ apiKey });
+    const message = await client.messages.create({
+        model: MODEL,
+        max_tokens: MAX_TOKENS,
+        system: `You are a concise fitness coach assistant integrated into a Garmin smartwatch.
+Answer in 2-3 short sentences maximum. Be direct and actionable. No markdown formatting.
+${healthContext}`,
+        messages: [{ role: "user", content: prompt }],
+    });
+    const block = message.content[0];
+    if (block?.type !== "text") {
+        throw new Error("Unexpected response type from Claude");
+    }
+    return block.text.trim();
+}
+export function submitPrompt(prompt) {
+    const id = buildJobId();
+    createPromptJob(id, prompt);
+    // Fire-and-forget — process asynchronously
+    processPromptJob(id, prompt).catch((err) => {
+        logger.error({ err, id }, "Prompt job processing failed unexpectedly");
+    });
+    return { job_id: id };
+}
+async function processPromptJob(id, prompt) {
+    updatePromptJob(id, { status: "running" });
+    try {
+        const summary = await buildWatchSummary();
+        const healthContext = formatHealthContext(summary);
+        const result = await callClaude(prompt, healthContext);
+        updatePromptJob(id, { status: "done", result });
+    }
+    catch (err) {
+        const message = err instanceof Error ? err.message : String(err);
+        logger.error({ err, id }, "Prompt job failed");
+        updatePromptJob(id, { status: "error", error: message });
+    }
+}
+export function getPromptStatus(id) {
+    const job = getPromptJob(id);
+    if (!job)
+        return null;
+    return {
+        status: job.status,
+        result: job.result ?? undefined,
+        error: job.error ?? undefined,
+    };
+}
+export async function generateDailyInsight(summary) {
+    const apiKey = appConfig.anthropicApiKey;
+    if (!apiKey)
+        return null;
+    try {
+        const healthContext = formatHealthContext(summary);
+        const result = await callClaude("Give me one sentence of actionable advice for today based on my health data.", healthContext);
+        return result;
+    }
+    catch (err) {
+        logger.warn({ err }, "Daily insight generation failed");
+        return null;
+    }
+}
+//# sourceMappingURL=promptApi.js.map

package/dist/promptApi.js.map

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

package/dist/server.d.ts

@@ -0,0 +1,10 @@
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+export { formatToolError } from "./toolErrors.js";
+export interface GarminMcpServer {
+    start: () => Promise<void>;
+    close: () => Promise<void>;
+}
+export declare function registerGarminTools(mcpServer: McpServer): void;
+export declare function createMcpServerInstance(): McpServer;
+export declare function createMcpServer(): GarminMcpServer;
+//# sourceMappingURL=server.d.ts.map

package/dist/server.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../src/server.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AASpE,OAAO,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAC;AAElD,MAAM,WAAW,eAAe;IAC9B,KAAK,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;IAC3B,KAAK,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;CAC5B;AAED,wBAAgB,mBAAmB,CAAC,SAAS,EAAE,SAAS,GAAG,IAAI,CAuC9D;AAED,wBAAgB,uBAAuB,IAAI,SAAS,CAQnD;AAED,wBAAgB,eAAe,IAAI,eAAe,CAgBjD"}

package/dist/server.js

@@ -0,0 +1,67 @@
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
+import { executeTool, toolRegistry, toolSchemas } from "./tools/index.js";
+import { logger } from "./utils/logger.js";
+import { packageVersion } from "./version.js";
+import { formatToolError } from "./toolErrors.js";
+// SECTION: MCP Server
+export { formatToolError } from "./toolErrors.js";
+export function registerGarminTools(mcpServer) {
+    for (const tool of toolRegistry) {
+        const schema = toolSchemas[tool.name];
+        mcpServer.registerTool(tool.name, {
+            description: tool.description,
+            inputSchema: schema,
+        }, async (args) => {
+            try {
+                const result = await executeTool(tool.name, args);
+                return {
+                    content: [
+                        {
+                            type: "text",
+                            text: result.text,
+                        },
+                    ],
+                };
+            }
+            catch (error) {
+                logger.error({ error, tool: tool.name }, "Tool execution failed");
+                const message = formatToolError(error);
+                return {
+                    isError: true,
+                    content: [
+                        {
+                            type: "text",
+                            text: message,
+                        },
+                    ],
+                };
+            }
+        });
+    }
+}
+export function createMcpServerInstance() {
+    const mcpServer = new McpServer({
+        name: "garmin-bud",
+        version: packageVersion,
+    });
+    registerGarminTools(mcpServer);
+    return mcpServer;
+}
+export function createMcpServer() {
+    let mcpServer = createMcpServerInstance();
+    let transport = null;
+    return {
+        async start() {
+            mcpServer = createMcpServerInstance();
+            transport = new StdioServerTransport();
+            await mcpServer.connect(transport);
+            logger.info("GarminBud server started on stdio transport");
+        },
+        async close() {
+            await mcpServer.close();
+            transport = null;
+        },
+    };
+}
+//# sourceMappingURL=server.js.map

package/dist/server.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"server.js","sourceRoot":"","sources":["../src/server.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AACpE,OAAO,EAAE,oBAAoB,EAAE,MAAM,2CAA2C,CAAC;AACjF,OAAO,EAAE,WAAW,EAAE,YAAY,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAC1E,OAAO,EAAE,MAAM,EAAE,MAAM,mBAAmB,CAAC;AAC3C,OAAO,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAC9C,OAAO,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAC;AAElD,sBAAsB;AAEtB,OAAO,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAC;AAOlD,MAAM,UAAU,mBAAmB,CAAC,SAAoB;IACtD,KAAK,MAAM,IAAI,IAAI,YAAY,EAAE,CAAC;QAChC,MAAM,MAAM,GAAG,WAAW,CAAC,IAAI,CAAC,IAAgC,CAAC,CAAC;QAElE,SAAS,CAAC,YAAY,CACpB,IAAI,CAAC,IAAI,EACT;YACE,WAAW,EAAE,IAAI,CAAC,WAAW;YAC7B,WAAW,EAAE,MAAM;SACpB,EACD,KAAK,EAAE,IAA6B,EAAE,EAAE;YACtC,IAAI,CAAC;gBACH,MAAM,MAAM,GAAG,MAAM,WAAW,CAAC,IAAI,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;gBAElD,OAAO;oBACL,OAAO,EAAE;wBACP;4BACE,IAAI,EAAE,MAAe;4BACrB,IAAI,EAAE,MAAM,CAAC,IAAI;yBAClB;qBACF;iBACF,CAAC;YACJ,CAAC;YAAC,OAAO,KAAK,EAAE,CAAC;gBACf,MAAM,CAAC,KAAK,CAAC,EAAE,KAAK,EAAE,IAAI,EAAE,IAAI,CAAC,IAAI,EAAE,EAAE,uBAAuB,CAAC,CAAC;gBAElE,MAAM,OAAO,GAAG,eAAe,CAAC,KAAK,CAAC,CAAC;gBACvC,OAAO;oBACL,OAAO,EAAE,IAAI;oBACb,OAAO,EAAE;wBACP;4BACE,IAAI,EAAE,MAAe;4BACrB,IAAI,EAAE,OAAO;yBACd;qBACF;iBACF,CAAC;YACJ,CAAC;QACH,CAAC,CACF,CAAC;IACJ,CAAC;AACH,CAAC;AAED,MAAM,UAAU,uBAAuB;IACrC,MAAM,SAAS,GAAG,IAAI,SAAS,CAAC;QAC9B,IAAI,EAAE,YAAY;QAClB,OAAO,EAAE,cAAc;KACxB,CAAC,CAAC;IAEH,mBAAmB,CAAC,SAAS,CAAC,CAAC;IAC/B,OAAO,SAAS,CAAC;AACnB,CAAC;AAED,MAAM,UAAU,eAAe;IAC7B,IAAI,SAAS,GAAG,uBAAuB,EAAE,CAAC;IAC1C,IAAI,SAAS,GAAgC,IAAI,CAAC;IAElD,OAAO;QACL,KAAK,CAAC,KAAK;YACT,SAAS,GAAG,uBAAuB,EAAE,CAAC;YACtC,SAAS,GAAG,IAAI,oBAAoB,EAAE,CAAC;YACvC,MAAM,SAAS,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;YACnC,MAAM,CAAC,IAAI,CAAC,6CAA6C,CAAC,CAAC;QAC7D,CAAC;QACD,KAAK,CAAC,KAAK;YACT,MAAM,SAAS,CAAC,KAAK,EAAE,CAAC;YACxB,SAAS,GAAG,IAAI,CAAC;QACnB,CAAC;KACF,CAAC;AACJ,CAAC"}

package/dist/setup.d.ts

@@ -0,0 +1,2 @@
+export declare function runSetup(): Promise<void>;
+//# sourceMappingURL=setup.d.ts.map

package/dist/setup.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"setup.d.ts","sourceRoot":"","sources":["../src/setup.ts"],"names":[],"mappings":"AA4KA,wBAAsB,QAAQ,IAAI,OAAO,CAAC,IAAI,CAAC,CAsE9C"}

package/dist/setup.js

@@ -0,0 +1,194 @@
+import { createInterface } from "node:readline/promises";
+import { stdin as input, stdout as output } from "node:process";
+import fs from "node:fs";
+import { authenticateGarmin, clearStoredSession } from "./garmin/auth.js";
+import { resetGarminClient } from "./garmin/client.js";
+import { assertGarminCredentials, getDistIndexPath, writeEnvFile, appConfig, } from "./config.js";
+import { configureLogger } from "./utils/logger.js";
+import { configureGarminBudForClient, detectMcpClients, } from "./mcpConfig.js";
+import { printLiveCheckResults, runLiveCheck } from "./check.js";
+// SECTION: Interactive Setup
+async function promptLine(rl, question) {
+    const answer = (await rl.question(question)).trim();
+    return answer;
+}
+async function promptSecret(question) {
+    return new Promise((resolve) => {
+        output.write(question);
+        if (!input.isTTY || typeof input.setRawMode !== "function") {
+            void (async () => {
+                const rl = createInterface({ input, output });
+                const answer = (await rl.question("")).trim();
+                rl.close();
+                resolve(answer);
+            })();
+            return;
+        }
+        input.resume();
+        input.setRawMode(true);
+        input.setEncoding("utf8");
+        let password = "";
+        const onData = (chunk) => {
+            const char = chunk;
+            if (char === "\n" || char === "\r" || char === "\u0004") {
+                input.setRawMode(false);
+                input.removeListener("data", onData);
+                output.write("\n");
+                resolve(password);
+                return;
+            }
+            if (char === "\u0003") {
+                process.exit(130);
+            }
+            if (char === "\u007F" || char === "\b") {
+                password = password.slice(0, -1);
+                return;
+            }
+            password += char;
+            output.write("*");
+        };
+        input.on("data", onData);
+    });
+}
+function isValidEmail(value) {
+    return /^[^\s@]+@[^\s@]+\.[^\s@]+$/.test(value);
+}
+async function promptCredentials() {
+    const rl = createInterface({ input, output });
+    try {
+        output.write("\nGarminBud setup\n");
+        output.write("This wizard will save credentials locally, authenticate with Garmin Connect,\n");
+        output.write("and optionally connect GarminBud to Cursor or Claude Desktop.\n\n");
+        output.write("Note: MFA must be disabled on your Garmin Connect account.\n\n");
+        let email = "";
+        while (!email) {
+            const value = await promptLine(rl, "Garmin Connect email: ");
+            if (!value) {
+                output.write("Email is required.\n");
+                continue;
+            }
+            if (!isValidEmail(value)) {
+                output.write("Enter a valid email address.\n");
+                continue;
+            }
+            email = value;
+        }
+        rl.close();
+        let password = "";
+        while (!password) {
+            password = await promptSecret("Garmin Connect password: ");
+            if (!password) {
+                output.write("Password is required.\n");
+            }
+        }
+        return { email, password };
+    }
+    finally {
+        rl.close();
+    }
+}
+async function promptMcpClients(clients) {
+    if (clients.length === 0) {
+        output.write("\nNo supported MCP clients were detected on this machine.\n");
+        output.write("You can add GarminBud manually later using QUICKSTART.md.\n");
+        return [];
+    }
+    const rl = createInterface({ input, output });
+    try {
+        output.write("\nDetected MCP clients:\n");
+        clients.forEach((client, index) => {
+            output.write(`  ${index + 1}. ${client.label} (${client.configPath})\n`);
+        });
+        output.write("  A. All detected clients\n");
+        output.write("  S. Skip MCP client setup\n\n");
+        while (true) {
+            const answer = (await rl.question("Configure which client? [1/A/S]: ")).trim().toLowerCase();
+            if (answer === "s" || answer === "skip" || answer === "") {
+                return [];
+            }
+            if (answer === "a" || answer === "all") {
+                return clients;
+            }
+            const index = Number.parseInt(answer, 10);
+            if (Number.isFinite(index) && index >= 1 && index <= clients.length) {
+                return [clients[index - 1]];
+            }
+            output.write("Enter a number from the list, A for all, or S to skip.\n");
+        }
+    }
+    finally {
+        rl.close();
+    }
+}
+async function promptRunLiveCheck() {
+    const rl = createInterface({ input, output });
+    try {
+        const answer = (await rl.question("\nRun a live Garmin API check now? [Y/n]: ")).trim().toLowerCase();
+        return answer === "" || answer === "y" || answer === "yes";
+    }
+    finally {
+        rl.close();
+    }
+}
+export async function runSetup() {
+    const credentials = await promptCredentials();
+    const envPath = writeEnvFile(credentials);
+    output.write(`\nSaved credentials to ${envPath}\n`);
+    output.write("Authenticating with Garmin Connect...\n");
+    configureLogger(appConfig.logPath);
+    clearStoredSession();
+    resetGarminClient();
+    try {
+        await authenticateGarmin(true);
+    }
+    catch (error) {
+        const message = error instanceof Error ? error.message : "Authentication failed";
+        output.write(`\nAuthentication failed.\n${message}\n`);
+        output.write("\nCommon fixes:\n");
+        output.write("- Verify your email and password\n");
+        output.write("- Disable MFA at connect.garmin.com → Account Settings → Security\n");
+        output.write("- Run `garmin-bud setup` again after fixing credentials\n");
+        process.exitCode = 1;
+        return;
+    }
+    output.write("Garmin authentication successful. Session saved.\n");
+    const distIndexPath = getDistIndexPath();
+    if (!fs.existsSync(distIndexPath)) {
+        output.write(`\nWarning: ${distIndexPath} was not found. Run \`npm run build\` before starting the MCP server.\n`);
+    }
+    const detectedClients = detectMcpClients();
+    const selectedClients = await promptMcpClients(detectedClients);
+    for (const client of selectedClients) {
+        configureGarminBudForClient(client, {
+            email: credentials.email,
+            password: credentials.password,
+            distIndexPath,
+        });
+        output.write(`Configured GarminBud in ${client.label} (${client.configPath})\n`);
+    }
+    output.write("\nSetup complete.\n");
+    output.write("\nWeb AI connector (claude.ai, ChatGPT):\n");
+    output.write(`- API key saved to .env as GARMIN_MCP_API_KEY\n`);
+    output.write(`- Run: garmin-bud serve\n`);
+    output.write(`- See docs/WEB-MCP.md for Cloudflare Tunnel + claude.ai setup\n`);
+    output.write(`- Your API key: ${appConfig.mcpApiKey}\n`);
+    if (selectedClients.length > 0) {
+        output.write("\nNext steps:\n");
+        output.write("- Restart your MCP client completely so it picks up the new server\n");
+        output.write("- Ask things like \"What was my last workout?\" or \"How did I sleep this week?\"\n");
+    }
+    else {
+        output.write("\nNext steps:\n");
+        output.write("- Run `garmin-bud start` for manual MCP usage, or follow QUICKSTART.md to connect a client\n");
+    }
+    if (await promptRunLiveCheck()) {
+        assertGarminCredentials();
+        const results = await runLiveCheck();
+        output.write("\n");
+        printLiveCheckResults(results);
+        if (results.some((result) => !result.ok)) {
+            process.exitCode = 1;
+        }
+    }
+}
+//# sourceMappingURL=setup.js.map

package/dist/setup.js.map

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

package/dist/toolErrors.d.ts

@@ -0,0 +1,2 @@
+export declare function formatToolError(error: unknown): string;
+//# sourceMappingURL=toolErrors.d.ts.map

package/dist/toolErrors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"toolErrors.d.ts","sourceRoot":"","sources":["../src/toolErrors.ts"],"names":[],"mappings":"AAGA,wBAAgB,eAAe,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CAiBtD"}

package/dist/toolErrors.js

@@ -0,0 +1,18 @@
+import { GarminApiError } from "./garmin/types.js";
+import { sanitizeErrorMessage } from "./utils/helpers.js";
+export function formatToolError(error) {
+    if (error instanceof GarminApiError) {
+        if (error.statusCode === 429) {
+            return `${error.message} Retry in ${error.retryAfterSeconds ?? 60} seconds.`;
+        }
+        return sanitizeErrorMessage(error.message);
+    }
+    if (error instanceof Error) {
+        if (error.message.toLowerCase().includes("authentication")) {
+            return `${sanitizeErrorMessage(error.message)} Run "garmin-bud auth" to re-authenticate.`;
+        }
+        return sanitizeErrorMessage(error.message);
+    }
+    return "An unexpected error occurred while executing the Garmin tool.";
+}
+//# sourceMappingURL=toolErrors.js.map

package/dist/toolErrors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"toolErrors.js","sourceRoot":"","sources":["../src/toolErrors.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AACnD,OAAO,EAAE,oBAAoB,EAAE,MAAM,oBAAoB,CAAC;AAE1D,MAAM,UAAU,eAAe,CAAC,KAAc;IAC5C,IAAI,KAAK,YAAY,cAAc,EAAE,CAAC;QACpC,IAAI,KAAK,CAAC,UAAU,KAAK,GAAG,EAAE,CAAC;YAC7B,OAAO,GAAG,KAAK,CAAC,OAAO,aAAa,KAAK,CAAC,iBAAiB,IAAI,EAAE,WAAW,CAAC;QAC/E,CAAC;QACD,OAAO,oBAAoB,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;IAC7C,CAAC;IAED,IAAI,KAAK,YAAY,KAAK,EAAE,CAAC;QAC3B,IAAI,KAAK,CAAC,OAAO,CAAC,WAAW,EAAE,CAAC,QAAQ,CAAC,gBAAgB,CAAC,EAAE,CAAC;YAC3D,OAAO,GAAG,oBAAoB,CAAC,KAAK,CAAC,OAAO,CAAC,4CAA4C,CAAC;QAC5F,CAAC;QAED,OAAO,oBAAoB,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;IAC7C,CAAC;IAED,OAAO,+DAA+D,CAAC;AACzE,CAAC"}

package/dist/tools/activities.d.ts

@@ -0,0 +1,11 @@
+import type { ActivitySummary, ToolTextResult } from "../garmin/types.js";
+import type { ToolDefinition } from "./types.js";
+export declare function formatActivitySummary(activity: ActivitySummary): string;
+export declare function getActivitiesPool(): Promise<{
+    activities: ActivitySummary[];
+    truncated: boolean;
+}>;
+export declare function getLatestActivity(): Promise<ToolTextResult>;
+export declare function getActivitiesRange(input: Record<string, unknown>): Promise<ToolTextResult>;
+export declare const activityToolDefinitions: ToolDefinition[];
+//# sourceMappingURL=activities.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"activities.d.ts","sourceRoot":"","sources":["../../src/tools/activities.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,eAAe,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AAC1E,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AA+BjD,wBAAgB,qBAAqB,CAAC,QAAQ,EAAE,eAAe,GAAG,MAAM,CAavE;AAkCD,wBAAsB,iBAAiB,IAAI,OAAO,CAAC;IAAE,UAAU,EAAE,eAAe,EAAE,CAAC;IAAC,SAAS,EAAE,OAAO,CAAA;CAAE,CAAC,CAIxG;AAID,wBAAsB,iBAAiB,IAAI,OAAO,CAAC,cAAc,CAAC,CAmBjE;AAED,wBAAsB,kBAAkB,CAAC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,CAAC,cAAc,CAAC,CAgChG;AAED,eAAO,MAAM,uBAAuB,EAAE,cAAc,EAsBnD,CAAC"}

package/dist/tools/activities.js

@@ -0,0 +1,134 @@
+import { appConfig } from "../config.js";
+import { buildToolCacheKey, withCache } from "../garmin/cache.js";
+import { withGarminClient } from "../garmin/client.js";
+import { filterActivitiesByRange, formatDistanceMeters, formatDuration, formatIsoDate, formatPaceMetersPerSecond, parseActivityLocalDateTime, } from "../utils/helpers.js";
+const ACTIVITIES_PAGE_SIZE = 100;
+const MAX_ACTIVITIES_FETCH = 500;
+// SECTION: Activity Mapping
+function mapActivity(activity) {
+    return {
+        activityId: activity.activityId,
+        name: activity.activityName,
+        type: activity.activityType.typeKey,
+        startTimeLocal: activity.startTimeLocal,
+        distanceMeters: activity.distance,
+        durationSeconds: activity.duration,
+        averageHeartRate: activity.averageHR ?? null,
+        maxHeartRate: activity.maxHR ?? null,
+        elevationGainMeters: activity.elevationGain,
+        calories: activity.calories,
+        averageSpeedMps: activity.averageSpeed,
+    };
+}
+export function formatActivitySummary(activity) {
+    return [
+        `Activity: ${activity.name}`,
+        `Type: ${activity.type}`,
+        `Date: ${activity.startTimeLocal}`,
+        `Distance: ${formatDistanceMeters(activity.distanceMeters)}`,
+        `Duration: ${formatDuration(activity.durationSeconds)}`,
+        `Pace: ${formatPaceMetersPerSecond(activity.averageSpeedMps)}`,
+        `Avg HR: ${activity.averageHeartRate ?? "n/a"} bpm`,
+        `Max HR: ${activity.maxHeartRate ?? "n/a"} bpm`,
+        `Elevation gain: ${activity.elevationGainMeters.toFixed(0)} m`,
+        `Calories: ${activity.calories}`,
+    ].join("\n");
+}
+async function fetchActivitiesPage(start, limit) {
+    return withGarminClient(async (client) => {
+        const activities = await client.getActivities(start, limit);
+        return activities.map(mapActivity);
+    });
+}
+async function fetchActivitiesPool() {
+    const all = [];
+    let start = 0;
+    while (all.length < MAX_ACTIVITIES_FETCH) {
+        const page = await fetchActivitiesPage(start, ACTIVITIES_PAGE_SIZE);
+        if (page.length === 0) {
+            break;
+        }
+        all.push(...page);
+        if (page.length < ACTIVITIES_PAGE_SIZE) {
+            break;
+        }
+        start += ACTIVITIES_PAGE_SIZE;
+    }
+    return {
+        activities: all,
+        truncated: all.length >= MAX_ACTIVITIES_FETCH,
+    };
+}
+export async function getActivitiesPool() {
+    const cacheKey = buildToolCacheKey("activities_pool", {});
+    return withCache(cacheKey, appConfig.cacheTtlActivities, fetchActivitiesPool);
+}
+// SECTION: Tool Handlers
+export async function getLatestActivity() {
+    const cacheKey = buildToolCacheKey("get_latest_activity", {});
+    const activity = await withCache(cacheKey, appConfig.cacheTtlActivities, async () => {
+        const { activities } = await getActivitiesPool();
+        return activities[0] ?? null;
+    });
+    if (!activity) {
+        return {
+            type: "text",
+            text: "No activities found in your Garmin Connect account.",
+        };
+    }
+    return {
+        type: "text",
+        text: formatActivitySummary(activity),
+    };
+}
+export async function getActivitiesRange(input) {
+    const start_date = input.start_date;
+    const end_date = input.end_date;
+    const { activities: pool, truncated } = await getActivitiesPool();
+    const activities = filterActivitiesByRange(pool, start_date, end_date);
+    if (activities.length === 0) {
+        return {
+            type: "text",
+            text: `No activities found between ${start_date} and ${end_date}.`,
+        };
+    }
+    const lines = activities.map((activity, index) => {
+        const activityDate = parseActivityLocalDateTime(activity.startTimeLocal).toISODate() ??
+            formatIsoDate(new Date(activity.startTimeLocal));
+        return [
+            `${index + 1}. ${activity.name} (${activity.type})`,
+            `   ${activityDate} | ${formatDistanceMeters(activity.distanceMeters)} | ${formatDuration(activity.durationSeconds)}`,
+        ].join("\n");
+    });
+    const warning = truncated
+        ? "\n\nNote: Results may be incomplete — only the most recent 500 activities were scanned."
+        : "";
+    return {
+        type: "text",
+        text: [`Found ${activities.length} activities:`, "", ...lines].join("\n") + warning,
+    };
+}
+export const activityToolDefinitions = [
+    {
+        name: "get_latest_activity",
+        description: "Returns the most recent Garmin activity with distance, duration, pace, and heart rate stats.",
+        inputSchema: {},
+        handler: getLatestActivity,
+    },
+    {
+        name: "get_activities_range",
+        description: "Returns Garmin activities within an ISO 8601 date range.",
+        inputSchema: {
+            start_date: {
+                type: "string",
+                description: "Start date in ISO 8601 format, e.g. 2026-06-01",
+            },
+            end_date: {
+                type: "string",
+                description: "End date in ISO 8601 format, e.g. 2026-06-07",
+            },
+        },
+        handler: getActivitiesRange,
+    },
+];
+//# sourceMappingURL=activities.js.map

package/dist/tools/activities.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"activities.js","sourceRoot":"","sources":["../../src/tools/activities.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AACzC,OAAO,EAAE,iBAAiB,EAAE,SAAS,EAAE,MAAM,oBAAoB,CAAC;AAClE,OAAO,EAAE,gBAAgB,EAAE,MAAM,qBAAqB,CAAC;AAGvD,OAAO,EACL,uBAAuB,EACvB,oBAAoB,EACpB,cAAc,EACd,aAAa,EACb,yBAAyB,EACzB,0BAA0B,GAC3B,MAAM,qBAAqB,CAAC;AAE7B,MAAM,oBAAoB,GAAG,GAAG,CAAC;AACjC,MAAM,oBAAoB,GAAG,GAAG,CAAC;AAEjC,4BAA4B;AAE5B,SAAS,WAAW,CAAC,QAAmB;IACtC,OAAO;QACL,UAAU,EAAE,QAAQ,CAAC,UAAU;QAC/B,IAAI,EAAE,QAAQ,CAAC,YAAY;QAC3B,IAAI,EAAE,QAAQ,CAAC,YAAY,CAAC,OAAO;QACnC,cAAc,EAAE,QAAQ,CAAC,cAAc;QACvC,cAAc,EAAE,QAAQ,CAAC,QAAQ;QACjC,eAAe,EAAE,QAAQ,CAAC,QAAQ;QAClC,gBAAgB,EAAE,QAAQ,CAAC,SAAS,IAAI,IAAI;QAC5C,YAAY,EAAE,QAAQ,CAAC,KAAK,IAAI,IAAI;QACpC,mBAAmB,EAAE,QAAQ,CAAC,aAAa;QAC3C,QAAQ,EAAE,QAAQ,CAAC,QAAQ;QAC3B,eAAe,EAAE,QAAQ,CAAC,YAAY;KACvC,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,qBAAqB,CAAC,QAAyB;IAC7D,OAAO;QACL,aAAa,QAAQ,CAAC,IAAI,EAAE;QAC5B,SAAS,QAAQ,CAAC,IAAI,EAAE;QACxB,SAAS,QAAQ,CAAC,cAAc,EAAE;QAClC,aAAa,oBAAoB,CAAC,QAAQ,CAAC,cAAc,CAAC,EAAE;QAC5D,aAAa,cAAc,CAAC,QAAQ,CAAC,eAAe,CAAC,EAAE;QACvD,SAAS,yBAAyB,CAAC,QAAQ,CAAC,eAAe,CAAC,EAAE;QAC9D,WAAW,QAAQ,CAAC,gBAAgB,IAAI,KAAK,MAAM;QACnD,WAAW,QAAQ,CAAC,YAAY,IAAI,KAAK,MAAM;QAC/C,mBAAmB,QAAQ,CAAC,mBAAmB,CAAC,OAAO,CAAC,CAAC,CAAC,IAAI;QAC9D,aAAa,QAAQ,CAAC,QAAQ,EAAE;KACjC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AACf,CAAC;AAED,KAAK,UAAU,mBAAmB,CAAC,KAAa,EAAE,KAAa;IAC7D,OAAO,gBAAgB,CAAC,KAAK,EAAE,MAAM,EAAE,EAAE;QACvC,MAAM,UAAU,GAAG,MAAM,MAAM,CAAC,aAAa,CAAC,KAAK,EAAE,KAAK,CAAC,CAAC;QAC5D,OAAO,UAAU,CAAC,GAAG,CAAC,WAAW,CAAC,CAAC;IACrC,CAAC,CAAC,CAAC;AACL,CAAC;AAED,KAAK,UAAU,mBAAmB;IAChC,MAAM,GAAG,GAAsB,EAAE,CAAC;IAClC,IAAI,KAAK,GAAG,CAAC,CAAC;IAEd,OAAO,GAAG,CAAC,MAAM,GAAG,oBAAoB,EAAE,CAAC;QACzC,MAAM,IAAI,GAAG,MAAM,mBAAmB,CAAC,KAAK,EAAE,oBAAoB,CAAC,CAAC;QACpE,IAAI,IAAI,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YACtB,MAAM;QACR,CAAC;QAED,GAAG,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC,CAAC;QAElB,IAAI,IAAI,CAAC,MAAM,GAAG,oBAAoB,EAAE,CAAC;YACvC,MAAM;QACR,CAAC;QAED,KAAK,IAAI,oBAAoB,CAAC;IAChC,CAAC;IAED,OAAO;QACL,UAAU,EAAE,GAAG;QACf,SAAS,EAAE,GAAG,CAAC,MAAM,IAAI,oBAAoB;KAC9C,CAAC;AACJ,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,iBAAiB;IACrC,MAAM,QAAQ,GAAG,iBAAiB,CAAC,iBAAiB,EAAE,EAAE,CAAC,CAAC;IAE1D,OAAO,SAAS,CAAC,QAAQ,EAAE,SAAS,CAAC,kBAAkB,EAAE,mBAAmB,CAAC,CAAC;AAChF,CAAC;AAED,yBAAyB;AAEzB,MAAM,CAAC,KAAK,UAAU,iBAAiB;IACrC,MAAM,QAAQ,GAAG,iBAAiB,CAAC,qBAAqB,EAAE,EAAE,CAAC,CAAC;IAE9D,MAAM,QAAQ,GAAG,MAAM,SAAS,CAAC,QAAQ,EAAE,SAAS,CAAC,kBAAkB,EAAE,KAAK,IAAI,EAAE;QAClF,MAAM,EAAE,UAAU,EAAE,GAAG,MAAM,iBAAiB,EAAE,CAAC;QACjD,OAAO,UAAU,CAAC,CAAC,CAAC,IAAI,IAAI,CAAC;IAC/B,CAAC,CAAC,CAAC;IAEH,IAAI,CAAC,QAAQ,EAAE,CAAC;QACd,OAAO;YACL,IAAI,EAAE,MAAM;YACZ,IAAI,EAAE,qDAAqD;SAC5D,CAAC;IACJ,CAAC;IAED,OAAO;QACL,IAAI,EAAE,MAAM;QACZ,IAAI,EAAE,qBAAqB,CAAC,QAAQ,CAAC;KACtC,CAAC;AACJ,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,kBAAkB,CAAC,KAA8B;IACrE,MAAM,UAAU,GAAG,KAAK,CAAC,UAAoB,CAAC;IAC9C,MAAM,QAAQ,GAAG,KAAK,CAAC,QAAkB,CAAC;IAC1C,MAAM,EAAE,UAAU,EAAE,IAAI,EAAE,SAAS,EAAE,GAAG,MAAM,iBAAiB,EAAE,CAAC;IAClE,MAAM,UAAU,GAAG,uBAAuB,CAAC,IAAI,EAAE,UAAU,EAAE,QAAQ,CAAC,CAAC;IAEvE,IAAI,UAAU,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC5B,OAAO;YACL,IAAI,EAAE,MAAM;YACZ,IAAI,EAAE,+BAA+B,UAAU,QAAQ,QAAQ,GAAG;SACnE,CAAC;IACJ,CAAC;IAED,MAAM,KAAK,GAAG,UAAU,CAAC,GAAG,CAAC,CAAC,QAAQ,EAAE,KAAK,EAAE,EAAE;QAC/C,MAAM,YAAY,GAChB,0BAA0B,CAAC,QAAQ,CAAC,cAAc,CAAC,CAAC,SAAS,EAAE;YAC/D,aAAa,CAAC,IAAI,IAAI,CAAC,QAAQ,CAAC,cAAc,CAAC,CAAC,CAAC;QAEnD,OAAO;YACL,GAAG,KAAK,GAAG,CAAC,KAAK,QAAQ,CAAC,IAAI,KAAK,QAAQ,CAAC,IAAI,GAAG;YACnD,MAAM,YAAY,MAAM,oBAAoB,CAAC,QAAQ,CAAC,cAAc,CAAC,MAAM,cAAc,CAAC,QAAQ,CAAC,eAAe,CAAC,EAAE;SACtH,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACf,CAAC,CAAC,CAAC;IAEH,MAAM,OAAO,GAAG,SAAS;QACvB,CAAC,CAAC,yFAAyF;QAC3F,CAAC,CAAC,EAAE,CAAC;IAEP,OAAO;QACL,IAAI,EAAE,MAAM;QACZ,IAAI,EAAE,CAAC,SAAS,UAAU,CAAC,MAAM,cAAc,EAAE,EAAE,EAAE,GAAG,KAAK,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,OAAO;KACpF,CAAC;AACJ,CAAC;AAED,MAAM,CAAC,MAAM,uBAAuB,GAAqB;IACvD;QACE,IAAI,EAAE,qBAAqB;QAC3B,WAAW,EAAE,8FAA8F;QAC3G,WAAW,EAAE,EAAE;QACf,OAAO,EAAE,iBAAiB;KAC3B;IACD;QACE,IAAI,EAAE,sBAAsB;QAC5B,WAAW,EAAE,0DAA0D;QACvE,WAAW,EAAE;YACX,UAAU,EAAE;gBACV,IAAI,EAAE,QAAQ;gBACd,WAAW,EAAE,gDAAgD;aAC9D;YACD,QAAQ,EAAE;gBACR,IAAI,EAAE,QAAQ;gBACd,WAAW,EAAE,8CAA8C;aAC5D;SACF;QACD,OAAO,EAAE,kBAAkB;KAC5B;CACF,CAAC"}

package/dist/tools/bodyComposition.d.ts

@@ -0,0 +1,7 @@
+import type { ToolTextResult } from "../garmin/types.js";
+import type { ToolDefinition } from "./types.js";
+export declare function getBodyComposition(input: {
+    days?: number;
+}): Promise<ToolTextResult>;
+export declare const bodyCompositionToolDefinitions: ToolDefinition[];
+//# sourceMappingURL=bodyComposition.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"bodyComposition.d.ts","sourceRoot":"","sources":["../../src/tools/bodyComposition.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAwB,cAAc,EAAE,MAAM,oBAAoB,CAAC;AAC/E,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAwCjD,wBAAsB,kBAAkB,CAAC,KAAK,EAAE;IAAE,IAAI,CAAC,EAAE,MAAM,CAAA;CAAE,GAAG,OAAO,CAAC,cAAc,CAAC,CA0E1F;AAED,eAAO,MAAM,8BAA8B,EAAE,cAAc,EAY1D,CAAC"}