trainbud 0.5.0

package/dist/tools/recovery.js

@@ -0,0 +1,350 @@
+import { storedRawPayload, isPartialOrStored } from "../history/fallback.js";
+import { getMetricsOn } from "../history/store.js";
+import { logger } from "../utils/logger.js";
+import { appConfig } from "../config.js";
+import { buildToolCacheKey, withCache } from "../garmin/cache.js";
+import { withGarminClient } from "../garmin/client.js";
+import { clamp, formatIsoDate, getDateRange, getYesterday } from "../utils/helpers.js";
+// SECTION: Recovery Scoring
+const DEFAULT_WEIGHTS = {
+    hrv: 0.3,
+    sleep: 0.3,
+    stress: 0.2,
+    restingHr: 0.2,
+};
+export function normalizeWeights(weights) {
+    // Spreading the caller's object was wrong: getRecoveryStatus builds
+    // { hrv: input.hrv_weight, ... } from an input that usually carries no
+    // weights at all, so every key is present and explicitly undefined, and a
+    // spread of explicit undefined overwrites the default it was meant to fall
+    // back to. The total then came out NaN; `NaN <= 0` is false, so the guard
+    // below waved it through, every component was multiplied by NaN, and the
+    // score was NaN -- which JSON.stringify writes as null. That is how the
+    // cache, the tool output and the watch all ended up showing
+    // "Recovery score: null/100" with four healthy component scores beneath it.
+    const merged = { ...DEFAULT_WEIGHTS };
+    for (const key of Object.keys(DEFAULT_WEIGHTS)) {
+        const value = weights?.[key];
+        if (typeof value === "number" && Number.isFinite(value) && value > 0) {
+            merged[key] = value;
+        }
+    }
+    const total = merged.hrv + merged.sleep + merged.stress + merged.restingHr;
+    if (!Number.isFinite(total) || total <= 0) {
+        return DEFAULT_WEIGHTS;
+    }
+    return {
+        hrv: merged.hrv / total,
+        sleep: merged.sleep / total,
+        stress: merged.stress / total,
+        restingHr: merged.restingHr / total,
+    };
+}
+export function scoreFromHrv(hrv, status) {
+    if (hrv === null) {
+        if (status === "BALANCED") {
+            return 80;
+        }
+        if (status === "LOW") {
+            return 45;
+        }
+        return 60;
+    }
+    if (hrv >= 60) {
+        return 95;
+    }
+    if (hrv >= 45) {
+        return 80;
+    }
+    if (hrv >= 30) {
+        return 60;
+    }
+    return 40;
+}
+/**
+ * Null when the night was not measured at all.
+ *
+ * The call site passed `sleep?.sleepTimeSeconds ?? 0`, so a night with no sleep
+ * record became zero seconds, fell through every band, and scored 35 out of 100
+ * -- a confident bad-night verdict manufactured out of an unworn watch. An hour
+ * is the floor for "this is a measurement": nobody's real night is shorter, and
+ * Garmin does report tiny durations for naps and for partial wear.
+ */
+export function scoreFromSleep(score, durationSeconds) {
+    if (score !== null) {
+        return clamp(score, 0, 100);
+    }
+    if (durationSeconds < 3600) {
+        return null;
+    }
+    const hours = durationSeconds / 3600;
+    if (hours >= 8) {
+        return 90;
+    }
+    if (hours >= 7) {
+        return 75;
+    }
+    if (hours >= 6) {
+        return 55;
+    }
+    return 35;
+}
+export function scoreFromStress(stress) {
+    if (stress === null) {
+        return 60;
+    }
+    if (stress <= 15) {
+        return 95;
+    }
+    if (stress <= 25) {
+        return 75;
+    }
+    if (stress <= 35) {
+        return 55;
+    }
+    return 35;
+}
+export function scoreFromRestingHr(restingHr, baseline) {
+    if (restingHr === null) {
+        return 60;
+    }
+    if (baseline === null) {
+        if (restingHr <= 50) {
+            return 90;
+        }
+        if (restingHr <= 60) {
+            return 80;
+        }
+        if (restingHr <= 70) {
+            return 65;
+        }
+        return 45;
+    }
+    const delta = restingHr - baseline;
+    if (delta <= -2) {
+        return 90;
+    }
+    if (delta <= 2) {
+        return 75;
+    }
+    if (delta <= 5) {
+        return 55;
+    }
+    return 35;
+}
+export function buildRecoveryStatus(components, weights) {
+    // A component that was never measured is dropped and its weight redistributed
+    // across the rest, rather than being scored as though it had been measured
+    // badly. Scoring an absence is how an unworn night became "fatigued".
+    const parts = [
+        { value: components.hrvScore, weight: weights.hrv },
+        { value: components.stressScore, weight: weights.stress },
+        { value: components.restingHrScore, weight: weights.restingHr },
+    ];
+    if (components.sleepScore !== null) {
+        parts.push({ value: components.sleepScore, weight: weights.sleep });
+    }
+    const totalWeight = parts.reduce((sum, part) => sum + part.weight, 0);
+    const score = totalWeight > 0
+        ? Math.round(parts.reduce((sum, part) => sum + part.value * part.weight, 0) / totalWeight)
+        : 0;
+    let status = "good";
+    let recommendation = "Moderate training is reasonable. Listen to your body during hard efforts.";
+    if (score >= 80) {
+        status = "recovered";
+        recommendation = "You look recovered. Hard training or a quality session is appropriate today.";
+    }
+    else if (score < 60) {
+        status = "fatigued";
+        recommendation = "Recovery looks limited. Favor easy training, mobility, or a rest day.";
+    }
+    return {
+        score,
+        status,
+        recommendation,
+        components,
+    };
+}
+/**
+ * How far back the store is searched for the most recent night with a record.
+ * Past this the answer stops being a recovery score and becomes an anecdote,
+ * and saying nothing is better than scoring it.
+ */
+const STORED_SIGNAL_WINDOW_DAYS = 30;
+/**
+ * The same signals, read out of the store, when Connect will not answer.
+ *
+ * Every component already has an honest null path -- `scoreFromSleep` returns
+ * null for a night that was not measured and the weights renormalise around it
+ * -- so a partial reconstruction degrades rather than inventing. What it must
+ * not do is pretend to be current, which is what `storedThrough` is for: the
+ * renderer names the date and `buildWatchSummary` refuses the card once that
+ * date is old.
+ */
+function storedRecoverySignals() {
+    for (const date of getDateRange(STORED_SIGNAL_WINDOW_DAYS)) {
+        const iso = formatIsoDate(date);
+        const raw = storedRawPayload(iso, "sleep");
+        const metrics = getMetricsOn(iso);
+        if (raw?.dailySleepDTO) {
+            return {
+                sleepData: raw,
+                restingHeartRate: metrics.get("resting_hr") ?? null,
+                baselineRestingHeartRate: null,
+                storedThrough: iso,
+            };
+        }
+        // No archived response, but the derived rows survive pruning forever.
+        const sleepSeconds = metrics.get("sleep_seconds");
+        if (sleepSeconds !== undefined) {
+            return {
+                sleepData: {
+                    dailySleepDTO: {
+                        sleepTimeSeconds: sleepSeconds,
+                        avgSleepStress: metrics.get("sleep_stress") ?? null,
+                        sleepScores: { overall: { value: metrics.get("sleep_score") ?? null } },
+                    },
+                    avgOvernightHrv: metrics.get("hrv_overnight") ?? null,
+                    hrvStatus: null,
+                },
+                restingHeartRate: metrics.get("resting_hr") ?? null,
+                baselineRestingHeartRate: null,
+                storedThrough: iso,
+            };
+        }
+    }
+    return null;
+}
+async function fetchRecoverySignals() {
+    const today = new Date();
+    const candidates = [getYesterday(), ...getDateRange(3).slice(1)];
+    try {
+        return await withGarminClient(async (client) => {
+            let sleepData = { dailySleepDTO: undefined };
+            for (const date of candidates) {
+                const candidate = await client.getSleepData(date);
+                if (candidate.dailySleepDTO) {
+                    sleepData = candidate;
+                    break;
+                }
+            }
+            const heartRate = await client.getHeartRate(today);
+            return {
+                sleepData,
+                restingHeartRate: heartRate.restingHeartRate ?? null,
+                baselineRestingHeartRate: heartRate.lastSevenDaysAvgRestingHeartRate ?? null,
+                storedThrough: null,
+            };
+        });
+    }
+    catch (error) {
+        // A recovery score built on an expired session used to be a thrown tool
+        // error, which an MCP client reports as having no access to the user's
+        // data. The signals are in the store; what changes is the date they
+        // describe, and that is something to say rather than a reason to say
+        // nothing at all.
+        const stored = storedRecoverySignals();
+        if (!stored) {
+            throw error;
+        }
+        logger.info({ err: error, storedThrough: stored.storedThrough }, "Recovery signals came from the stored history");
+        return stored;
+    }
+}
+// SECTION: Tool Handler
+/**
+ * The date is passed in rather than read from the clock here, which is what
+ * keeps this pure and testable -- the handler below supplies it.
+ */
+export function renderRecoveryText(payload) {
+    const { recovery } = payload;
+    const provenance = payload.storedThrough
+        ? [
+            `Garmin could not be reached, so this was computed from TrainBud's stored record for ${payload.storedThrough} rather than from today's figures.`,
+            "It describes that day. Do not present it as current, and do not report it as an absence of data.",
+            "",
+        ]
+        : [];
+    return [
+        ...provenance,
+        `Recovery score: ${recovery.score}/100 (${recovery.status})`,
+        recovery.recommendation,
+        "",
+        "Component scores:",
+        `- HRV: ${recovery.components.hrvScore}`,
+        `- Sleep: ${recovery.components.sleepScore ?? "not measured"}`,
+        `- Stress: ${recovery.components.stressScore}`,
+        `- Resting HR: ${recovery.components.restingHrScore}`,
+        "",
+        `Date: ${payload.date}`,
+    ].join("\n");
+}
+export async function getRecoveryStatus(input) {
+    const weights = normalizeWeights({
+        hrv: input.hrv_weight,
+        sleep: input.sleep_weight,
+        stress: input.stress_weight,
+        restingHr: input.resting_hr_weight,
+    });
+    const cacheKey = buildToolCacheKey("get_recovery_status", {
+        hrv: weights.hrv,
+        sleep: weights.sleep,
+        stress: weights.stress,
+        restingHr: weights.restingHr,
+    });
+    const computed = await withCache(cacheKey, appConfig.cacheTtlStats, async () => {
+        const signals = await fetchRecoverySignals();
+        const sleep = signals.sleepData.dailySleepDTO;
+        const components = {
+            hrvScore: scoreFromHrv(signals.sleepData.avgOvernightHrv ?? null, signals.sleepData.hrvStatus ?? null),
+            sleepScore: scoreFromSleep(sleep?.sleepScores?.overall?.value ?? null, sleep?.sleepTimeSeconds ?? 0),
+            stressScore: scoreFromStress(sleep?.avgSleepStress ?? null),
+            restingHrScore: scoreFromRestingHr(signals.restingHeartRate, signals.baselineRestingHeartRate),
+        };
+        return {
+            recovery: buildRecoveryStatus(components, weights),
+            storedThrough: signals.storedThrough,
+        };
+    }, {
+        isPartial: (value) => isPartialOrStored({ unreachableDays: 0, storedDays: value.storedThrough ? 1 : 0 }),
+    });
+    const payload = {
+        // The day the score describes, which is the stored day when the signals
+        // came from the store. Stamping it with today is how a fortnight-old night
+        // would have been served as this morning's recovery.
+        date: computed.storedThrough ?? formatIsoDate(new Date()),
+        recovery: computed.recovery,
+        storedThrough: computed.storedThrough,
+    };
+    return {
+        type: "text",
+        text: renderRecoveryText(payload),
+        data: payload,
+    };
+}
+export const recoveryToolDefinitions = [
+    {
+        name: "get_recovery_status",
+        description: "Combines HRV, sleep, stress, and resting heart rate into a recovery score and training recommendation.",
+        inputSchema: {
+            hrv_weight: {
+                type: "number",
+                description: "Optional weight for HRV in the recovery score.",
+            },
+            sleep_weight: {
+                type: "number",
+                description: "Optional weight for sleep in the recovery score.",
+            },
+            stress_weight: {
+                type: "number",
+                description: "Optional weight for stress in the recovery score.",
+            },
+            resting_hr_weight: {
+                type: "number",
+                description: "Optional weight for resting heart rate in the recovery score.",
+            },
+        },
+        handler: getRecoveryStatus,
+    },
+];
+//# sourceMappingURL=recovery.js.map

package/dist/tools/recovery.js.map

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

package/dist/tools/sleep.d.ts

@@ -0,0 +1,10 @@
+import type { SleepNightSummary, ToolResult } from "../garmin/types.js";
+import type { SleepPayload, StoredProvenance } from "./payloads.js";
+import type { ToolDefinition } from "./types.js";
+export declare function buildSleepPayload(nights: SleepNightSummary[], requestedNights: number, unreachableNights?: number, stored?: StoredProvenance): SleepPayload;
+export declare function renderSleepText(payload: SleepPayload): string;
+export declare function getSleepDataTool(input: {
+    nights?: number;
+}): Promise<ToolResult<SleepPayload>>;
+export declare const sleepToolDefinitions: ToolDefinition[];
+//# sourceMappingURL=sleep.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"sleep.d.ts","sourceRoot":"","sources":["../../src/tools/sleep.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,iBAAiB,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AACxE,OAAO,KAAK,EAAE,YAAY,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAC;AACpE,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAqEjD,wBAAgB,iBAAiB,CAC/B,MAAM,EAAE,iBAAiB,EAAE,EAC3B,eAAe,EAAE,MAAM,EACvB,iBAAiB,SAAI,EACrB,MAAM,GAAE,gBAIP,GACA,YAAY,CAoBd;AAED,wBAAgB,eAAe,CAAC,OAAO,EAAE,YAAY,GAAG,MAAM,CA0B7D;AAED,wBAAsB,gBAAgB,CACpC,KAAK,EAAE;IAAE,MAAM,CAAC,EAAE,MAAM,CAAA;CAAE,GACzB,OAAO,CAAC,UAAU,CAAC,YAAY,CAAC,CAAC,CAkBnC;AAED,eAAO,MAAM,oBAAoB,EAAE,cAAc,EAYhD,CAAC"}

package/dist/tools/sleep.js

@@ -0,0 +1,124 @@
+import { appConfig } from "../config.js";
+import { buildToolCacheKey, withCache } from "../garmin/cache.js";
+import { withGarminClient } from "../garmin/client.js";
+import { fetchSleepDay, mapSleepData } from "../garmin/daily.js";
+import { fetchEachDay } from "../garmin/partial.js";
+import { fetchDaysOrStore, isPartialOrStored, storedFetchNote, } from "../history/fallback.js";
+import { formatDuration, getDateRange } from "../utils/helpers.js";
+// SECTION: Sleep Mapping
+async function fetchSleepNights(days) {
+    const dates = getDateRange(days);
+    return fetchDaysOrStore({
+        dates,
+        source: "sleep",
+        live: () => withGarminClient(async (client) => fetchEachDay(dates, async (date) => (await fetchSleepDay(client, date)).mapped, "sleep")),
+        // The same mapper the live path uses, re-run over the archived response. A
+        // second mapping here would be a second place for "which field is the sleep
+        // score" to be answered, and this project has already shipped a mapper
+        // reading a field Connect does not send.
+        fromRaw: (date, payload) => mapSleepData(date, payload),
+        fromMetrics: (date, metrics) => {
+            const totalSleepSeconds = metrics.get("sleep_seconds");
+            if (totalSleepSeconds === undefined) {
+                return null;
+            }
+            return {
+                date,
+                totalSleepSeconds,
+                deepSleepSeconds: null,
+                lightSleepSeconds: null,
+                remSleepSeconds: null,
+                awakeCount: null,
+                sleepScore: metrics.get("sleep_score") ?? null,
+                avgSleepStress: metrics.get("sleep_stress") ?? null,
+                avgOvernightHrv: metrics.get("hrv_overnight") ?? null,
+                hrvStatus: null,
+            };
+        },
+        dateOf: (night) => night.date,
+    });
+}
+function formatSleepNight(night) {
+    const stages = night.deepSleepSeconds === null &&
+        night.lightSleepSeconds === null &&
+        night.remSleepSeconds === null
+        ? "  Stages: not kept for this night"
+        : `  Deep: ${formatDuration(night.deepSleepSeconds)} | Light: ${formatDuration(night.lightSleepSeconds)} | REM: ${formatDuration(night.remSleepSeconds)}`;
+    return [
+        `${night.date}:`,
+        `  Total sleep: ${formatDuration(night.totalSleepSeconds)}`,
+        stages,
+        `  Score: ${night.sleepScore ?? "n/a"} | Awakenings: ${night.awakeCount ?? "n/a"}`,
+        `  Avg sleep stress: ${night.avgSleepStress ?? "n/a"}`,
+    ].join("\n");
+}
+// SECTION: Tool Handler
+export function buildSleepPayload(nights, requestedNights, unreachableNights = 0, stored = {
+    storedDays: 0,
+    storedThrough: null,
+    storedWindowMoved: false,
+}) {
+    const scored = nights
+        .map((night) => night.sleepScore)
+        .filter((score) => score !== null);
+    const averageScore = scored.length > 0
+        ? Math.round(scored.reduce((sum, score) => sum + score, 0) / scored.length)
+        : null;
+    return {
+        requestedNights,
+        recordedNights: nights.length,
+        unreachableNights,
+        averageScore,
+        nights,
+        storedNights: stored.storedDays,
+        storedThrough: stored.storedThrough,
+        storedWindowMoved: stored.storedWindowMoved,
+    };
+}
+export function renderSleepText(payload) {
+    const note = storedFetchNote({
+        values: payload.nights,
+        unreachableDays: payload.unreachableNights,
+        requestedDays: payload.requestedNights,
+        storedDays: payload.storedNights,
+        storedThrough: payload.storedThrough,
+        storedWindowMoved: payload.storedWindowMoved,
+    }, "nights");
+    if (payload.recordedNights === 0) {
+        return note || `No sleep data found for the last ${payload.requestedNights} nights.`;
+    }
+    return [
+        note,
+        `Sleep summary for last ${payload.recordedNights} recorded nights:`,
+        payload.averageScore !== null ? `Average sleep score: ${payload.averageScore}` : "",
+        "",
+        ...payload.nights.map(formatSleepNight),
+    ]
+        .filter(Boolean)
+        .join("\n");
+}
+export async function getSleepDataTool(input) {
+    const nights = input.nights ?? 7;
+    const cacheKey = buildToolCacheKey("get_sleep_data", { nights });
+    const fetched = await withCache(cacheKey, appConfig.cacheTtlSleep, async () => fetchSleepNights(nights), { isPartial: isPartialOrStored });
+    const payload = buildSleepPayload(fetched.values, nights, fetched.unreachableDays, fetched);
+    return {
+        type: "text",
+        text: renderSleepText(payload),
+        data: payload,
+    };
+}
+export const sleepToolDefinitions = [
+    {
+        name: "get_sleep_data",
+        description: "Returns sleep duration, quality score, stage breakdown, and interruptions for recent nights.",
+        inputSchema: {
+            nights: {
+                type: "number",
+                description: "Number of recent nights to include. Defaults to 7.",
+            },
+        },
+        handler: getSleepDataTool,
+    },
+];
+//# sourceMappingURL=sleep.js.map

package/dist/tools/sleep.js.map

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

package/dist/tools/stress.d.ts

@@ -0,0 +1,11 @@
+import { type DailyStressSummary } from "../garmin/rawApi.js";
+import type { ToolResult } from "../garmin/types.js";
+import type { StressPayload, StoredProvenance } from "./payloads.js";
+import type { ToolDefinition } from "./types.js";
+export declare function buildStressPayload(days: DailyStressSummary[], requestedDays: number, unreachableDays?: number, stored?: StoredProvenance): StressPayload;
+export declare function renderStressText(payload: StressPayload): string;
+export declare function getStressLevels(input: {
+    days?: number;
+}): Promise<ToolResult<StressPayload>>;
+export declare const stressToolDefinitions: ToolDefinition[];
+//# sourceMappingURL=stress.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"stress.d.ts","sourceRoot":"","sources":["../../src/tools/stress.ts"],"names":[],"mappings":"AAIA,OAAO,EAAkB,KAAK,kBAAkB,EAAE,MAAM,qBAAqB,CAAC;AAC9E,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AACrD,OAAO,KAAK,EAAE,aAAa,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAC;AACrE,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAwCjD,wBAAgB,kBAAkB,CAChC,IAAI,EAAE,kBAAkB,EAAE,EAC1B,aAAa,EAAE,MAAM,EACrB,eAAe,SAAI,EACnB,MAAM,GAAE,gBAIP,GACA,aAAa,CAgBf;AAED,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,aAAa,GAAG,MAAM,CAqC/D;AAED,wBAAsB,eAAe,CACnC,KAAK,EAAE;IAAE,IAAI,CAAC,EAAE,MAAM,CAAA;CAAE,GACvB,OAAO,CAAC,UAAU,CAAC,aAAa,CAAC,CAAC,CAkBpC;AAED,eAAO,MAAM,qBAAqB,EAAE,cAAc,EAYjD,CAAC"}

package/dist/tools/stress.js

@@ -0,0 +1,108 @@
+import { appConfig } from "../config.js";
+import { buildToolCacheKey, withCache } from "../garmin/cache.js";
+import { withGarminClient } from "../garmin/client.js";
+import { fetchStressDay } from "../garmin/daily.js";
+import { mapDailyStress } from "../garmin/rawApi.js";
+import { fetchEachDay } from "../garmin/partial.js";
+import { fetchDaysOrStore, isPartialOrStored, storedFetchNote, } from "../history/fallback.js";
+import { average, calculateTrend, getDateRange } from "../utils/helpers.js";
+async function fetchStressDays(days) {
+    const dates = getDateRange(days);
+    return fetchDaysOrStore({
+        dates,
+        source: "stress",
+        live: () => withGarminClient(async (client) => fetchEachDay(dates, async (date) => (await fetchStressDay(client, date)).mapped, "stress")),
+        fromRaw: (date, payload) => mapDailyStress(date, payload),
+        fromMetrics: (date, metrics) => {
+            const averageStress = metrics.get("stress_avg") ?? null;
+            const maxStress = metrics.get("stress_max") ?? null;
+            if (averageStress === null && maxStress === null) {
+                return null;
+            }
+            return {
+                date,
+                averageStress,
+                maxStress,
+                restStress: null,
+                stressDurationSeconds: null,
+            };
+        },
+        dateOf: (day) => day.date,
+    });
+}
+export function buildStressPayload(days, requestedDays, unreachableDays = 0, stored = {
+    storedDays: 0,
+    storedThrough: null,
+    storedWindowMoved: false,
+}) {
+    const averages = days
+        .map((day) => day.averageStress)
+        .filter((value) => value !== null);
+    return {
+        requestedDays,
+        recordedDays: days.length,
+        unreachableDays,
+        averageStress: averages.length > 0 ? Math.round(average(averages)) : null,
+        trend: calculateTrend(averages, true),
+        days,
+        storedDays: stored.storedDays,
+        storedThrough: stored.storedThrough,
+        storedWindowMoved: stored.storedWindowMoved,
+    };
+}
+export function renderStressText(payload) {
+    const note = storedFetchNote({
+        values: payload.days,
+        unreachableDays: payload.unreachableDays,
+        requestedDays: payload.requestedDays,
+        storedDays: payload.storedDays,
+        storedThrough: payload.storedThrough,
+        storedWindowMoved: payload.storedWindowMoved,
+    }, "days");
+    if (payload.recordedDays === 0) {
+        return note || `No stress data found for the last ${payload.requestedDays} days.`;
+    }
+    // The trend line is conditional on more than one *measured* day, not on more
+    // than one recorded day: Connect returns -1 and -2 as sentinels for days the
+    // watch was not worn, and those are mapped to null rather than averaged in.
+    const measuredDays = payload.days.filter((day) => day.averageStress !== null).length;
+    const lines = payload.days.slice(0, 7).map((day) => {
+        return `${day.date}: avg ${day.averageStress ?? "n/a"}, max ${day.maxStress ?? "n/a"}`;
+    });
+    return [
+        note,
+        `Stress levels over ${payload.recordedDays} recorded days:`,
+        payload.averageStress !== null ? `Average stress: ${payload.averageStress}` : "",
+        measuredDays > 1 ? `Trend: ${payload.trend}` : "",
+        "",
+        "Recent days:",
+        ...lines,
+    ]
+        .filter(Boolean)
+        .join("\n");
+}
+export async function getStressLevels(input) {
+    const days = input.days ?? 7;
+    const cacheKey = buildToolCacheKey("get_stress_levels", { days });
+    const fetched = await withCache(cacheKey, appConfig.cacheTtlStats, async () => fetchStressDays(days), { isPartial: isPartialOrStored });
+    const payload = buildStressPayload(fetched.values, days, fetched.unreachableDays, fetched);
+    return {
+        type: "text",
+        text: renderStressText(payload),
+        data: payload,
+    };
+}
+export const stressToolDefinitions = [
+    {
+        name: "get_stress_levels",
+        description: "Returns daily stress averages and trends from Garmin Connect.",
+        inputSchema: {
+            days: {
+                type: "number",
+                description: "Number of days to analyze. Defaults to 7.",
+            },
+        },
+        handler: getStressLevels,
+    },
+];
+//# sourceMappingURL=stress.js.map

package/dist/tools/stress.js.map

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

package/dist/tools/trainingInsights.d.ts

@@ -0,0 +1,15 @@
+import type { ToolResult } from "../garmin/types.js";
+import type { TrainingInsightsPayload } from "./payloads.js";
+import type { ToolDefinition } from "./types.js";
+/**
+ * The sub-tools' rendered text is passed in rather than re-derived here. This
+ * tool embeds their output verbatim, so calling three renderers from a fourth
+ * would duplicate the composition the handler already does -- and would make
+ * this function impure for no gain.
+ */
+export declare function renderTrainingInsightsText(payload: TrainingInsightsPayload, sleepText: string, recoveryText: string, stressText: string): string;
+export declare function getTrainingInsights(input: {
+    days?: number;
+}): Promise<ToolResult<TrainingInsightsPayload>>;
+export declare const trainingInsightsToolDefinitions: ToolDefinition[];
+//# sourceMappingURL=trainingInsights.d.ts.map