trainbud 0.5.0

package/dist/tools/activities.js

@@ -0,0 +1,182 @@
+import { appConfig } from "../config.js";
+import { buildToolCacheKey, withCache } from "../garmin/cache.js";
+import { withGarminClient } from "../garmin/client.js";
+import { mapActivity } from "../garmin/daily.js";
+import { storedActivitiesBetween } from "../history/fallback.js";
+import { logger } from "../utils/logger.js";
+import { DateTime } from "luxon";
+import { filterActivitiesByRange, formatDistanceMeters, formatDuration, formatIsoDate, formatPaceMetersPerSecond, parseActivityLocalDateTime, } from "../utils/helpers.js";
+import { getProfile } from "../profile.js";
+const ACTIVITIES_PAGE_SIZE = 100;
+const MAX_ACTIVITIES_FETCH = 500;
+// SECTION: Activity Mapping
+export function formatActivitySummary(activity, units = "metric") {
+    return [
+        `Activity: ${activity.name}`,
+        `Type: ${activity.type}`,
+        `Date: ${activity.startTimeLocal}`,
+        `Distance: ${formatDistanceMeters(activity.distanceMeters, units)}`,
+        `Duration: ${formatDuration(activity.durationSeconds)}`,
+        `Pace: ${formatPaceMetersPerSecond(activity.averageSpeedMps, units)}`,
+        `Avg HR: ${activity.averageHeartRate ?? "n/a"} bpm`,
+        `Max HR: ${activity.maxHeartRate ?? "n/a"} bpm`,
+        `Elevation gain: ${activity.elevationGainMeters === null ? "n/a" : `${activity.elevationGainMeters.toFixed(0)} m`}`,
+        `Calories: ${activity.calories ?? "n/a"}`,
+    ].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,
+    };
+}
+/**
+ * How far back the stored activity table is read when Connect will not answer.
+ * Two years covers every window any tool here asks for; the table is small
+ * enough that the bound is about intent rather than cost.
+ */
+const STORED_POOL_DAYS = 730;
+/**
+ * Activities are a paged list upstream rather than a per-date fetch, so they do
+ * not go through `fetchDaysOrStore`. The rule is the same one: a failed request
+ * is not an absence of training. `get_latest_activity` used to answer "No
+ * activities found in your Garmin Connect account" whenever the session had
+ * expired, which is a statement about the user's life made out of a login
+ * error, with 23 activities sitting in the store.
+ */
+async function fetchActivityPool() {
+    try {
+        const live = await fetchActivitiesPool();
+        return { ...live, fromStore: false };
+    }
+    catch (error) {
+        logger.info({ err: error }, "Activity fetch failed; answering from the stored history");
+        const today = DateTime.local().startOf("day");
+        const activities = storedActivitiesBetween(today.minus({ days: STORED_POOL_DAYS }).toISODate() ?? "", today.toISODate() ?? "");
+        return { activities, truncated: false, fromStore: true };
+    }
+}
+export async function getActivitiesPool() {
+    const cacheKey = buildToolCacheKey("activities_pool", {});
+    return withCache(cacheKey, appConfig.cacheTtlActivities, fetchActivityPool, {
+        // A stored pool is cached briefly so a restored connection is picked up,
+        // rather than being frozen in for the full activities TTL.
+        isPartial: (pool) => pool.fromStore,
+    });
+}
+// SECTION: Tool Handlers
+export function renderLatestActivityText(payload, units = "metric") {
+    if (!payload.activity) {
+        return payload.fromStore
+            ? "Garmin could not be reached just now, and TrainBud's stored history holds no activities either."
+            : "No activities found in your Garmin Connect account.";
+    }
+    const note = payload.fromStore
+        ? [
+            "Garmin could not be reached just now, so this comes from TrainBud's own stored history.",
+            "It is a real activity previously fetched from Connect; anything recorded since is not here yet.",
+            "",
+            "",
+        ].join("\n")
+        : "";
+    return note + formatActivitySummary(payload.activity, units);
+}
+export async function getLatestActivity() {
+    const cacheKey = buildToolCacheKey("get_latest_activity", {});
+    const latest = await withCache(cacheKey, appConfig.cacheTtlActivities, async () => {
+        const { activities, fromStore } = await getActivitiesPool();
+        return { activity: activities[0] ?? null, fromStore };
+    }, { isPartial: (value) => value.fromStore });
+    const payload = latest;
+    return {
+        type: "text",
+        text: renderLatestActivityText(payload, getProfile().units),
+        data: payload,
+    };
+}
+export function buildActivitiesRangePayload(activities, startDate, endDate, truncated, fromStore = false) {
+    return { startDate, endDate, truncated, activities, fromStore };
+}
+export function renderActivitiesRangeText(payload, units = "metric") {
+    const storedNote = payload.fromStore
+        ? [
+            "Garmin could not be reached just now, so these come from TrainBud's own stored history rather than from Connect.",
+            "They are real activities previously fetched; anything recorded since is not here yet.",
+            "",
+            "",
+        ].join("\n")
+        : "";
+    if (payload.activities.length === 0) {
+        return payload.fromStore
+            ? `Garmin could not be reached, and TrainBud's stored history holds no activities between ${payload.startDate} and ${payload.endDate}.`
+            : `No activities found between ${payload.startDate} and ${payload.endDate}.`;
+    }
+    const lines = payload.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, units)} | ${formatDuration(activity.durationSeconds)}`,
+        ].join("\n");
+    });
+    const warning = payload.truncated
+        ? "\n\nNote: Results may be incomplete — only the most recent 500 activities were scanned."
+        : "";
+    return (storedNote +
+        [`Found ${payload.activities.length} activities:`, "", ...lines].join("\n") +
+        warning);
+}
+export async function getActivitiesRange(input) {
+    const start_date = input.start_date;
+    const end_date = input.end_date;
+    const { activities: pool, truncated, fromStore } = await getActivitiesPool();
+    const payload = buildActivitiesRangePayload(filterActivitiesByRange(pool, start_date, end_date), start_date, end_date, truncated, fromStore);
+    return {
+        type: "text",
+        text: renderActivitiesRangeText(payload, getProfile().units),
+        data: payload,
+    };
+}
+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":"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"}

package/dist/tools/bodyComposition.d.ts

@@ -0,0 +1,10 @@
+import type { BodyCompositionEntry, ToolResult } from "../garmin/types.js";
+import type { BodyCompositionPayload, StoredProvenance } from "./payloads.js";
+import type { ToolDefinition } from "./types.js";
+export declare function buildBodyCompositionPayload(entries: BodyCompositionEntry[], requestedDays: number, stored?: StoredProvenance): BodyCompositionPayload;
+export declare function renderBodyCompositionText(payload: BodyCompositionPayload): string;
+export declare function getBodyComposition(input: {
+    days?: number;
+}): Promise<ToolResult<BodyCompositionPayload>>;
+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":"AAKA,OAAO,KAAK,EAAE,oBAAoB,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AAC3E,OAAO,KAAK,EAAE,sBAAsB,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAC;AAC9E,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAoEjD,wBAAgB,2BAA2B,CACzC,OAAO,EAAE,oBAAoB,EAAE,EAC/B,aAAa,EAAE,MAAM,EACrB,MAAM,GAAE,gBAIP,GACA,sBAAsB,CAwBxB;AAED,wBAAgB,yBAAyB,CAAC,OAAO,EAAE,sBAAsB,GAAG,MAAM,CAuCjF;AAED,wBAAsB,kBAAkB,CACtC,KAAK,EAAE;IAAE,IAAI,CAAC,EAAE,MAAM,CAAA;CAAE,GACvB,OAAO,CAAC,UAAU,CAAC,sBAAsB,CAAC,CAAC,CAkB7C;AAED,eAAO,MAAM,8BAA8B,EAAE,cAAc,EAY1D,CAAC"}

package/dist/tools/bodyComposition.js

@@ -0,0 +1,139 @@
+import { appConfig } from "../config.js";
+import { buildToolCacheKey, withCache } from "../garmin/cache.js";
+import { withGarminClient } from "../garmin/client.js";
+import { fetchBodyCompositionDay, mapWeightData } from "../garmin/daily.js";
+import { mapInBatches } from "../utils/batch.js";
+import { fetchDaysOrStore, isPartialOrStored, storedFetchNote } from "../history/fallback.js";
+import { calculateTrend, getDateRange } from "../utils/helpers.js";
+// SECTION: Body Composition Mapping
+/**
+ * A weight response covers a whole day and may carry several readings, so this
+ * flattens to one entry per date rather than one per request -- but it still
+ * goes through the same fallback as every other metric, because a scale reading
+ * that was fetched last week is still the user's weight when Connect will not
+ * answer today.
+ */
+async function fetchBodyComposition(days) {
+    const dates = getDateRange(days);
+    const result = await fetchDaysOrStore({
+        dates,
+        source: "body_composition",
+        live: async () => {
+            const batches = await withGarminClient(async (client) => mapInBatches(dates, async (date) => (await fetchBodyCompositionDay(client, date)).mapped ?? []));
+            return { values: batches.flat(), unreachableDays: 0, requestedDays: dates.length };
+        },
+        fromRaw: (date, payload) => mapWeightData(date, payload)[0] ?? null,
+        fromMetrics: (date, metrics) => {
+            const weightKg = metrics.get("weight_kg") ?? null;
+            const bodyFatPercent = metrics.get("body_fat_pct") ?? null;
+            const muscleMassKg = metrics.get("muscle_mass_kg") ?? null;
+            if (weightKg === null && bodyFatPercent === null && muscleMassKg === null) {
+                return null;
+            }
+            return { date, weightKg, bodyFatPercent, muscleMassKg, bmi: null };
+        },
+        dateOf: (entry) => entry.date,
+    });
+    return {
+        entries: result.values,
+        storedDays: result.storedDays,
+        storedThrough: result.storedThrough,
+        storedWindowMoved: result.storedWindowMoved,
+        unreachableDays: result.unreachableDays,
+    };
+}
+// SECTION: Tool Handler
+function delta(current, baseline) {
+    if (current === null || current === undefined) {
+        return null;
+    }
+    if (baseline === null || baseline === undefined) {
+        return null;
+    }
+    return current - baseline;
+}
+export function buildBodyCompositionPayload(entries, requestedDays, stored = {
+    storedDays: 0,
+    storedThrough: null,
+    storedWindowMoved: false,
+}) {
+    // Entries are sorted newest first, so the last one in the range is the
+    // baseline the deltas are measured against.
+    const current = entries[0] ?? null;
+    const baseline = entries[entries.length - 1] ?? null;
+    const measured = (select) => entries.map(select).filter((value) => value !== null);
+    return {
+        requestedDays,
+        recordedDays: entries.length,
+        current,
+        baseline,
+        weightDeltaKg: delta(current?.weightKg, baseline?.weightKg),
+        bodyFatDeltaPercent: delta(current?.bodyFatPercent, baseline?.bodyFatPercent),
+        weightTrend: calculateTrend(measured((entry) => entry.weightKg), true),
+        bodyFatTrend: calculateTrend(measured((entry) => entry.bodyFatPercent), true),
+        muscleTrend: calculateTrend(measured((entry) => entry.muscleMassKg), false),
+        entries,
+        storedDays: stored.storedDays,
+        storedThrough: stored.storedThrough,
+        storedWindowMoved: stored.storedWindowMoved,
+    };
+}
+export function renderBodyCompositionText(payload) {
+    const note = storedFetchNote({
+        values: payload.entries,
+        unreachableDays: 0,
+        requestedDays: payload.requestedDays,
+        storedDays: payload.storedDays,
+        storedThrough: payload.storedThrough,
+        storedWindowMoved: payload.storedWindowMoved,
+    }, "days");
+    if (payload.recordedDays === 0) {
+        return note || `No body composition data found for the last ${payload.requestedDays} days.`;
+    }
+    const lines = payload.entries.slice(0, 10).map((entry) => {
+        return `${entry.date}: ${entry.weightKg?.toFixed(1) ?? "n/a"} kg | body fat ${entry.bodyFatPercent?.toFixed(1) ?? "n/a"}% | muscle ${entry.muscleMassKg?.toFixed(1) ?? "n/a"} kg`;
+    });
+    // Prepended rather than filtered into the list: the blank line before
+    // "Recent entries:" is deliberate, so a `.filter(Boolean)` here would drop the
+    // separator along with the empty note.
+    return [
+        ...(note ? [note, ""] : []),
+        `Body composition over ${payload.recordedDays} recorded days:`,
+        `Current weight: ${payload.current?.weightKg?.toFixed(1) ?? "n/a"} kg`,
+        `Current body fat: ${payload.current?.bodyFatPercent?.toFixed(1) ?? "n/a"}%`,
+        `Current muscle mass: ${payload.current?.muscleMassKg?.toFixed(1) ?? "n/a"} kg`,
+        `Weight change from baseline: ${payload.weightDeltaKg !== null ? `${payload.weightDeltaKg.toFixed(1)} kg` : "n/a"}`,
+        `Body fat change from baseline: ${payload.bodyFatDeltaPercent !== null ? `${payload.bodyFatDeltaPercent.toFixed(1)}%` : "n/a"}`,
+        `Weight trend: ${payload.weightTrend}`,
+        `Body fat trend: ${payload.bodyFatTrend}`,
+        `Muscle trend: ${payload.muscleTrend}`,
+        "",
+        "Recent entries:",
+        ...lines,
+    ].join("\n");
+}
+export async function getBodyComposition(input) {
+    const days = input.days ?? 30;
+    const cacheKey = buildToolCacheKey("get_body_composition", { days });
+    const fetched = await withCache(cacheKey, appConfig.cacheTtlStats, async () => fetchBodyComposition(days), { isPartial: isPartialOrStored });
+    const payload = buildBodyCompositionPayload(fetched.entries, days, fetched);
+    return {
+        type: "text",
+        text: renderBodyCompositionText(payload),
+        data: payload,
+    };
+}
+export const bodyCompositionToolDefinitions = [
+    {
+        name: "get_body_composition",
+        description: "Returns weight, body fat, and muscle mass trends over a time period.",
+        inputSchema: {
+            days: {
+                type: "number",
+                description: "Number of days to analyze. Defaults to 30.",
+            },
+        },
+        handler: getBodyComposition,
+    },
+];
+//# sourceMappingURL=bodyComposition.js.map

package/dist/tools/bodyComposition.js.map

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

package/dist/tools/context.d.ts

@@ -0,0 +1,8 @@
+import type { ToolResult } from "../garmin/types.js";
+import type { ContextListPayload, RememberContextPayload, SubjectivePayload } from "./payloads.js";
+import type { ToolDefinition } from "./types.js";
+export declare function rememberContext(input: Record<string, unknown>): Promise<ToolResult<RememberContextPayload>>;
+export declare function getUserContext(input: Record<string, unknown>): Promise<ToolResult<ContextListPayload>>;
+export declare function logSubjectiveEntry(input: Record<string, unknown>): Promise<ToolResult<SubjectivePayload>>;
+export declare const contextToolDefinitions: ToolDefinition[];
+//# sourceMappingURL=context.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"context.d.ts","sourceRoot":"","sources":["../../src/tools/context.ts"],"names":[],"mappings":"AAeA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AACrD,OAAO,KAAK,EACV,kBAAkB,EAClB,sBAAsB,EACtB,iBAAiB,EAClB,MAAM,eAAe,CAAC;AACvB,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAkCjD,wBAAsB,eAAe,CACnC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC7B,OAAO,CAAC,UAAU,CAAC,sBAAsB,CAAC,CAAC,CAgB7C;AAED,wBAAsB,cAAc,CAClC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC7B,OAAO,CAAC,UAAU,CAAC,kBAAkB,CAAC,CAAC,CAyBzC;AAED,wBAAsB,kBAAkB,CACtC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC7B,OAAO,CAAC,UAAU,CAAC,iBAAiB,CAAC,CAAC,CAyBxC;AAED,eAAO,MAAM,sBAAsB,EAAE,cAAc,EAiElD,CAAC"}

package/dist/tools/context.js

@@ -0,0 +1,148 @@
+import { DateTime } from "luxon";
+import { activeContext, addContextEntry, allContext, logSubjective, subjectiveSeries, } from "../history/context.js";
+import { CONTEXT_KINDS, SUBJECTIVE_KINDS, } from "../history/schema.js";
+// SECTION: Context tools
+//
+// The richest input a user will ever give is a sentence they were already
+// typing. "Half marathon on October 12, left achilles grumbling since Tuesday"
+// becomes two records with no UI at all, which is why these exist before any
+// form does.
+function parseKind(value, valid, label) {
+    if (typeof value === "string" && valid.includes(value)) {
+        return value;
+    }
+    throw new Error(`Unknown ${label} "${String(value)}". Choose one of: ${valid.join(", ")}.`);
+}
+function optionalDate(value, label) {
+    if (value === undefined || value === null || value === "") {
+        return undefined;
+    }
+    if (typeof value !== "string" || !DateTime.fromISO(value).isValid) {
+        throw new Error(`${label} must be an ISO date such as 2026-10-12.`);
+    }
+    return value;
+}
+function describeEntry(entry) {
+    const until = entry.effectiveTo ? ` until ${entry.effectiveTo}` : "";
+    return `${entry.kind}: ${entry.text} (from ${entry.effectiveFrom}${until})`;
+}
+export async function rememberContext(input) {
+    const kind = parseKind(input.kind, CONTEXT_KINDS, "context kind");
+    const text = typeof input.text === "string" ? input.text : "";
+    const entry = addContextEntry(kind, text, {
+        effectiveFrom: optionalDate(input.effective_from, "effective_from"),
+        effectiveTo: optionalDate(input.effective_to, "effective_to"),
+    });
+    const payload = { entry };
+    return {
+        type: "text",
+        text: `Recorded ${describeEntry(entry)}`,
+        data: payload,
+    };
+}
+export async function getUserContext(input) {
+    const includeClosed = input.include_closed === true;
+    const onDate = optionalDate(input.on_date, "on_date") ?? DateTime.local().toISODate() ?? "";
+    const entries = includeClosed ? allContext() : activeContext(onDate);
+    const payload = { onDate, includeClosed, entries };
+    if (entries.length === 0) {
+        return {
+            type: "text",
+            text: includeClosed
+                ? "Nothing has been recorded yet. Use remember_context to add a goal, race, injury or note."
+                : `Nothing on record as of ${onDate}. Use remember_context to add a goal, race, injury or note.`,
+            data: payload,
+        };
+    }
+    return {
+        type: "text",
+        text: [
+            includeClosed ? "Everything on record:" : `On record as of ${onDate}:`,
+            ...entries.map((entry) => `- ${describeEntry(entry)}`),
+        ].join("\n"),
+        data: payload,
+    };
+}
+export async function logSubjectiveEntry(input) {
+    const kind = parseKind(input.kind, SUBJECTIVE_KINDS, "rating kind");
+    const value = typeof input.value === "number" ? input.value : Number.NaN;
+    const date = optionalDate(input.date, "date") ?? DateTime.local().toISODate() ?? "";
+    const note = typeof input.note === "string" ? input.note : undefined;
+    logSubjective(date, kind, value, note);
+    const payload = {
+        date,
+        kind,
+        value,
+        note: note?.trim() || null,
+        recent: subjectiveSeries(kind, DateTime.fromISO(date).minus({ days: 30 }).toISODate() ?? date, date),
+    };
+    return {
+        type: "text",
+        text: `Recorded ${kind} ${value}/10 for ${date}${note ? ` — ${note.trim()}` : ""}`,
+        data: payload,
+    };
+}
+export const contextToolDefinitions = [
+    {
+        name: "remember_context",
+        description: "Records something about the user that Garmin does not know: a goal, a race and its date, an injury, or a free-form note. Use this whenever the user mentions one in passing.",
+        inputSchema: {
+            kind: {
+                type: "string",
+                description: `One of: ${CONTEXT_KINDS.join(", ")}.`,
+            },
+            text: {
+                type: "string",
+                description: "What to remember, in the user's own words where possible.",
+            },
+            effective_from: {
+                type: "string",
+                description: "ISO date this became true. Defaults to today.",
+            },
+            effective_to: {
+                type: "string",
+                description: "ISO date this stops being true, for a race date or a healed injury.",
+            },
+        },
+        handler: rememberContext,
+    },
+    {
+        name: "get_user_context",
+        description: "Returns the goals, races, injuries and notes on record for the user. Read this before giving training advice.",
+        inputSchema: {
+            on_date: {
+                type: "string",
+                description: "ISO date to evaluate against. Defaults to today.",
+            },
+            include_closed: {
+                type: "boolean",
+                description: "Include entries that have since ended. Defaults to false.",
+            },
+        },
+        handler: getUserContext,
+    },
+    {
+        name: "log_subjective",
+        description: "Records how a day or session actually felt, rated 1-10: perceived effort (rpe), soreness, or mood. Garmin has no equivalent.",
+        inputSchema: {
+            kind: {
+                type: "string",
+                description: `One of: ${SUBJECTIVE_KINDS.join(", ")}.`,
+            },
+            value: {
+                type: "number",
+                description: "A rating from 1 to 10.",
+            },
+            date: {
+                type: "string",
+                description: "ISO date the rating is for. Defaults to today.",
+            },
+            note: {
+                type: "string",
+                description: "Optional free-text detail.",
+            },
+        },
+        handler: logSubjectiveEntry,
+    },
+];
+//# sourceMappingURL=context.js.map

package/dist/tools/context.js.map

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

package/dist/tools/findings.d.ts

@@ -0,0 +1,7 @@
+import type { ToolResult } from "../garmin/types.js";
+import type { FindingsPayload } from "./payloads.js";
+import type { ToolDefinition } from "./types.js";
+export declare function renderFindingsText(payload: FindingsPayload): string;
+export declare function getFindings(): Promise<ToolResult<FindingsPayload>>;
+export declare const findingsToolDefinitions: ToolDefinition[];
+//# sourceMappingURL=findings.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"findings.d.ts","sourceRoot":"","sources":["../../src/tools/findings.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AACrD,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AACrD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAYjD,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,eAAe,GAAG,MAAM,CAuBnE;AAED,wBAAsB,WAAW,IAAI,OAAO,CAAC,UAAU,CAAC,eAAe,CAAC,CAAC,CAYxE;AAED,eAAO,MAAM,uBAAuB,EAAE,cAAc,EAQnD,CAAC"}

package/dist/tools/findings.js

@@ -0,0 +1,51 @@
+import { describeFindingsCoverage, runDetectors } from "../detect/index.js";
+// SECTION: Findings tool
+//
+// The one tool that answers a question Connect cannot: not "what is my resting
+// heart rate" but "is anything unusual about it, for me".
+//
+// It is also the only tool that reads the local store rather than Garmin, which
+// makes it the one thing an AI client can still learn about the user when the
+// connection is down -- so what it says when `ready` is false matters more here
+// than anywhere else in the app.
+export function renderFindingsText(payload) {
+    // Cold start is a different answer from a clean bill of health, and a record
+    // that stops three weeks ago is a third thing again: it has plenty to say and
+    // none of it is about this week. Reporting any of the three as another is the
+    // failure that matters here.
+    if (!payload.coverage.ready) {
+        const coverage = describeFindingsCoverage(payload.coverage);
+        return [coverage.detail, coverage.fix].filter(Boolean).join("\n");
+    }
+    if (payload.findings.length === 0) {
+        return `Nothing stands out against the user's own baselines, across ${payload.coverage.days} days of history.`;
+    }
+    return [
+        `${payload.findings.length} finding(s) across ${payload.coverage.days} days of history:`,
+        "",
+        ...payload.findings.map((finding) => [`[${finding.severity}] ${finding.headline}`, `  ${finding.detail}`].join("\n")),
+        "",
+        "These describe measurements against the user's own baseline. They are not diagnoses.",
+    ].join("\n");
+}
+export async function getFindings() {
+    const result = runDetectors();
+    const payload = {
+        findings: result.findings,
+        coverage: result.coverage,
+    };
+    return {
+        type: "text",
+        text: renderFindingsText(payload),
+        data: payload,
+    };
+}
+export const findingsToolDefinitions = [
+    {
+        name: "get_findings",
+        description: "Returns what stands out in the user's stored history against their own 28-day baselines: resting heart rate elevation, sleep debt, HRV trend breaks, and training load ratio. Prefer this over reading raw metrics when asked how things are going.",
+        inputSchema: {},
+        handler: getFindings,
+    },
+];
+//# sourceMappingURL=findings.js.map

package/dist/tools/findings.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"findings.js","sourceRoot":"","sources":["../../src/tools/findings.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,wBAAwB,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAK5E,yBAAyB;AACzB,EAAE;AACF,+EAA+E;AAC/E,0DAA0D;AAC1D,EAAE;AACF,gFAAgF;AAChF,8EAA8E;AAC9E,gFAAgF;AAChF,iCAAiC;AAEjC,MAAM,UAAU,kBAAkB,CAAC,OAAwB;IACzD,6EAA6E;IAC7E,8EAA8E;IAC9E,8EAA8E;IAC9E,6BAA6B;IAC7B,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,KAAK,EAAE,CAAC;QAC5B,MAAM,QAAQ,GAAG,wBAAwB,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC;QAC5D,OAAO,CAAC,QAAQ,CAAC,MAAM,EAAE,QAAQ,CAAC,GAAG,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACpE,CAAC;IAED,IAAI,OAAO,CAAC,QAAQ,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAClC,OAAO,+DAA+D,OAAO,CAAC,QAAQ,CAAC,IAAI,mBAAmB,CAAC;IACjH,CAAC;IAED,OAAO;QACL,GAAG,OAAO,CAAC,QAAQ,CAAC,MAAM,sBAAsB,OAAO,CAAC,QAAQ,CAAC,IAAI,mBAAmB;QACxF,EAAE;QACF,GAAG,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,OAAO,EAAE,EAAE,CAClC,CAAC,IAAI,OAAO,CAAC,QAAQ,KAAK,OAAO,CAAC,QAAQ,EAAE,EAAE,KAAK,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAChF;QACD,EAAE;QACF,sFAAsF;KACvF,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AACf,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,WAAW;IAC/B,MAAM,MAAM,GAAG,YAAY,EAAE,CAAC;IAC9B,MAAM,OAAO,GAAoB;QAC/B,QAAQ,EAAE,MAAM,CAAC,QAAQ;QACzB,QAAQ,EAAE,MAAM,CAAC,QAAQ;KAC1B,CAAC;IAEF,OAAO;QACL,IAAI,EAAE,MAAM;QACZ,IAAI,EAAE,kBAAkB,CAAC,OAAO,CAAC;QACjC,IAAI,EAAE,OAAO;KACd,CAAC;AACJ,CAAC;AAED,MAAM,CAAC,MAAM,uBAAuB,GAAqB;IACvD;QACE,IAAI,EAAE,cAAc;QACpB,WAAW,EACT,qPAAqP;QACvP,WAAW,EAAE,EAAE;QACf,OAAO,EAAE,WAAW;KACrB;CACF,CAAC"}

package/dist/tools/heartRate.d.ts

@@ -0,0 +1,10 @@
+import type { HeartRateDaySummary, ToolResult } from "../garmin/types.js";
+import type { HeartRatePayload, StoredProvenance } from "./payloads.js";
+import type { ToolDefinition } from "./types.js";
+export declare function buildHeartRatePayload(days: HeartRateDaySummary[], requestedDays: number, unreachableDays?: number, stored?: StoredProvenance): HeartRatePayload;
+export declare function renderHeartRateText(payload: HeartRatePayload): string;
+export declare function getHeartRateTrends(input: {
+    days?: number;
+}): Promise<ToolResult<HeartRatePayload>>;
+export declare const heartRateToolDefinitions: ToolDefinition[];
+//# sourceMappingURL=heartRate.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"heartRate.d.ts","sourceRoot":"","sources":["../../src/tools/heartRate.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,mBAAmB,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AAC1E,OAAO,KAAK,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAC;AACxE,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AA6CjD,wBAAgB,qBAAqB,CACnC,IAAI,EAAE,mBAAmB,EAAE,EAC3B,aAAa,EAAE,MAAM,EACrB,eAAe,SAAI,EACnB,MAAM,GAAE,gBAIP,GACA,gBAAgB,CAoBlB;AAED,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,gBAAgB,GAAG,MAAM,CAgCrE;AAED,wBAAsB,kBAAkB,CACtC,KAAK,EAAE;IAAE,IAAI,CAAC,EAAE,MAAM,CAAA;CAAE,GACvB,OAAO,CAAC,UAAU,CAAC,gBAAgB,CAAC,CAAC,CAkBvC;AAED,eAAO,MAAM,wBAAwB,EAAE,cAAc,EAYpD,CAAC"}