trainbud 0.5.0

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

@@ -0,0 +1 @@
+{"version":3,"file":"trainingInsights.d.ts","sourceRoot":"","sources":["../../src/tools/trainingInsights.ts"],"names":[],"mappings":"AAOA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AACrD,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,eAAe,CAAC;AAC7D,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAEjD;;;;;GAKG;AACH,wBAAgB,0BAA0B,CACxC,OAAO,EAAE,uBAAuB,EAChC,SAAS,EAAE,MAAM,EACjB,YAAY,EAAE,MAAM,EACpB,UAAU,EAAE,MAAM,GACjB,MAAM,CA2BR;AAED,wBAAsB,mBAAmB,CACvC,KAAK,EAAE;IAAE,IAAI,CAAC,EAAE,MAAM,CAAA;CAAE,GACvB,OAAO,CAAC,UAAU,CAAC,uBAAuB,CAAC,CAAC,CA6B9C;AAED,eAAO,MAAM,+BAA+B,EAAE,cAAc,EAa3D,CAAC"}

package/dist/tools/trainingInsights.js

@@ -0,0 +1,79 @@
+import { filterActivitiesByRange } from "../utils/helpers.js";
+import { DateTime } from "luxon";
+import { getActivitiesPool, formatActivitySummary } from "./activities.js";
+import { getProfile } from "../profile.js";
+import { getSleepDataTool } from "./sleep.js";
+import { getRecoveryStatus } from "./recovery.js";
+import { getStressLevels } from "./stress.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 function renderTrainingInsightsText(payload, sleepText, recoveryText, stressText) {
+    const activityLines = payload.activities.length > 0
+        ? payload.activities.map((activity, index) => {
+            return `${index + 1}. ${activity.name} (${activity.type}) — ${activity.startTimeLocal}`;
+        })
+        : [`No activities found between ${payload.startDate} and ${payload.endDate}.`];
+    return [
+        "Training insights summary",
+        `Period: ${payload.startDate} to ${payload.endDate}`,
+        "",
+        "## Latest activity",
+        payload.latest ? formatActivitySummary(payload.latest, getProfile().units) : "No activities found.",
+        "",
+        "## Activities in period",
+        ...activityLines,
+        "",
+        "## Sleep",
+        sleepText,
+        "",
+        "## Recovery",
+        recoveryText,
+        "",
+        "## Stress",
+        stressText,
+    ].join("\n");
+}
+export async function getTrainingInsights(input) {
+    const days = input.days ?? 7;
+    const endDate = DateTime.now().toISODate() ?? "";
+    const startDate = DateTime.now().minus({ days }).toISODate() ?? "";
+    const { activities: pool } = await getActivitiesPool();
+    const ranged = filterActivitiesByRange(pool, startDate, endDate);
+    const [sleep, recovery, stress] = await Promise.all([
+        getSleepDataTool({ nights: days }),
+        getRecoveryStatus({}),
+        getStressLevels({ days }),
+    ]);
+    const payload = {
+        startDate,
+        endDate,
+        latest: pool[0] ?? null,
+        activities: ranged,
+        sleep: sleep.data ?? null,
+        recovery: recovery.data ?? null,
+        stress: stress.data ?? null,
+    };
+    return {
+        type: "text",
+        text: renderTrainingInsightsText(payload, sleep.text, recovery.text, stress.text),
+        data: payload,
+    };
+}
+export const trainingInsightsToolDefinitions = [
+    {
+        name: "get_training_insights",
+        description: "Returns a combined weekly training summary: latest activity, recent workouts, sleep, recovery, and stress.",
+        inputSchema: {
+            days: {
+                type: "number",
+                description: "Number of days to summarize. Defaults to 7.",
+            },
+        },
+        handler: getTrainingInsights,
+    },
+];
+//# sourceMappingURL=trainingInsights.js.map

package/dist/tools/trainingInsights.js.map

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

package/dist/tools/types.d.ts

@@ -0,0 +1,12 @@
+import type { ToolResult } from "../garmin/types.js";
+export interface ToolInputSchema {
+    type: string;
+    description: string;
+}
+export interface ToolDefinition {
+    name: string;
+    description: string;
+    inputSchema: Record<string, ToolInputSchema> | Record<string, never>;
+    handler: (input: Record<string, unknown>) => Promise<ToolResult<unknown>>;
+}
+//# sourceMappingURL=types.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/tools/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AAErD,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,eAAe,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,KAAK,CAAC,CAAC;IACrE,OAAO,EAAE,CAAC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,OAAO,CAAC,UAAU,CAAC,OAAO,CAAC,CAAC,CAAC;CAC3E"}

package/dist/tools/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/tools/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/tools/types.ts"],"names":[],"mappings":""}

package/dist/tools/vo2Max.d.ts

@@ -0,0 +1,11 @@
+import { type Vo2MaxEntry } from "../garmin/rawApi.js";
+import type { ToolResult } from "../garmin/types.js";
+import type { Vo2MaxPayload, StoredProvenance } from "./payloads.js";
+import type { ToolDefinition } from "./types.js";
+export declare function buildVo2MaxPayload(entries: Vo2MaxEntry[], requestedDays: number, unreachableDays?: number, stored?: StoredProvenance): Vo2MaxPayload;
+export declare function renderVo2MaxText(payload: Vo2MaxPayload): string;
+export declare function getVo2MaxTrends(input: {
+    days?: number;
+}): Promise<ToolResult<Vo2MaxPayload>>;
+export declare const vo2MaxToolDefinitions: ToolDefinition[];
+//# sourceMappingURL=vo2Max.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"vo2Max.d.ts","sourceRoot":"","sources":["../../src/tools/vo2Max.ts"],"names":[],"mappings":"AAIA,OAAO,EAAiB,KAAK,WAAW,EAAE,MAAM,qBAAqB,CAAC;AACtE,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;AA4CjD,wBAAgB,kBAAkB,CAChC,OAAO,EAAE,WAAW,EAAE,EACtB,aAAa,EAAE,MAAM,EACrB,eAAe,SAAI,EACnB,MAAM,GAAE,gBAIP,GACA,aAAa,CAiBf;AAED,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,aAAa,GAAG,MAAM,CAsC/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/vo2Max.js

@@ -0,0 +1,110 @@
+import { appConfig } from "../config.js";
+import { buildToolCacheKey, withCache } from "../garmin/cache.js";
+import { withGarminClient } from "../garmin/client.js";
+import { fetchVo2MaxDay } from "../garmin/daily.js";
+import { mapMaxMetrics } from "../garmin/rawApi.js";
+import { fetchEachDay } from "../garmin/partial.js";
+import { fetchDaysOrStore, isPartialOrStored, storedFetchNote, } from "../history/fallback.js";
+import { calculateTrend, getDateRange } from "../utils/helpers.js";
+async function fetchVo2MaxDays(days) {
+    const dates = getDateRange(days);
+    // `dateOf` returns the date the reading was TAKEN, not the date asked about:
+    // `maxmet/latest/<date>` ignores its date and answers with the current
+    // measurement, so the same reading arrives once per day requested. Keying the
+    // merge on the measured date is what collapses those duplicates -- and it
+    // does the same job for a stored entry, which is why this tool needs no
+    // dedupe pass of its own any more.
+    return fetchDaysOrStore({
+        dates,
+        source: "vo2max",
+        live: () => withGarminClient(async (client) => fetchEachDay(dates, async (date) => (await fetchVo2MaxDay(client, date)).mapped, "vo2max")),
+        fromRaw: (date, payload) => mapMaxMetrics(date, payload),
+        fromMetrics: (date, metrics) => {
+            const vo2Max = metrics.get("vo2max") ?? null;
+            const vo2MaxCycling = metrics.get("vo2max_cycling") ?? null;
+            if (vo2Max === null && vo2MaxCycling === null) {
+                return null;
+            }
+            return { date, vo2Max, vo2MaxCycling };
+        },
+        dateOf: (entry) => entry.date,
+    });
+}
+export function buildVo2MaxPayload(entries, requestedDays, unreachableDays = 0, stored = {
+    storedDays: 0,
+    storedThrough: null,
+    storedWindowMoved: false,
+}) {
+    const values = entries
+        .map((entry) => entry.vo2Max)
+        .filter((value) => value !== null);
+    return {
+        requestedDays,
+        recordedDays: entries.length,
+        unreachableDays,
+        current: entries[0]?.vo2Max ?? null,
+        oldest: entries.at(-1)?.vo2Max ?? null,
+        trend: calculateTrend(values, false),
+        entries,
+        storedDays: stored.storedDays,
+        storedThrough: stored.storedThrough,
+        storedWindowMoved: stored.storedWindowMoved,
+    };
+}
+export function renderVo2MaxText(payload) {
+    const note = storedFetchNote({
+        values: payload.entries,
+        unreachableDays: payload.unreachableDays,
+        requestedDays: payload.requestedDays,
+        storedDays: payload.storedDays,
+        storedThrough: payload.storedThrough,
+        storedWindowMoved: payload.storedWindowMoved,
+    }, "days");
+    if (payload.recordedDays === 0) {
+        return note || `No VO2 max data found for the last ${payload.requestedDays} days.`;
+    }
+    const measuredEntries = payload.entries.filter((entry) => entry.vo2Max !== null).length;
+    const lines = payload.entries.slice(0, 10).map((entry) => {
+        const cycling = entry.vo2MaxCycling !== null ? `, cycling ${entry.vo2MaxCycling}` : "";
+        return `${entry.date}: VO2 max ${entry.vo2Max ?? "n/a"}${cycling}`;
+    });
+    return [
+        note,
+        `VO2 max trends over ${payload.recordedDays} recorded days:`,
+        payload.current !== null ? `Current VO2 max: ${payload.current}` : "",
+        payload.oldest !== null && payload.recordedDays > 1
+            ? `Oldest in range: ${payload.oldest}`
+            : "",
+        measuredEntries > 1 ? `Trend: ${payload.trend}` : "",
+        "",
+        "Recent entries:",
+        ...lines,
+    ]
+        .filter(Boolean)
+        .join("\n");
+}
+export async function getVo2MaxTrends(input) {
+    const days = input.days ?? 30;
+    const cacheKey = buildToolCacheKey("get_vo2_max_trends", { days });
+    const fetched = await withCache(cacheKey, appConfig.cacheTtlStats, async () => fetchVo2MaxDays(days), { isPartial: isPartialOrStored });
+    const payload = buildVo2MaxPayload(fetched.values, days, fetched.unreachableDays, fetched);
+    return {
+        type: "text",
+        text: renderVo2MaxText(payload),
+        data: payload,
+    };
+}
+export const vo2MaxToolDefinitions = [
+    {
+        name: "get_vo2_max_trends",
+        description: "Returns VO2 max fitness trends over time from Garmin Connect.",
+        inputSchema: {
+            days: {
+                type: "number",
+                description: "Number of days to analyze. Defaults to 30.",
+            },
+        },
+        handler: getVo2MaxTrends,
+    },
+];
+//# sourceMappingURL=vo2Max.js.map

package/dist/tools/vo2Max.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"vo2Max.js","sourceRoot":"","sources":["../../src/tools/vo2Max.ts"],"names":[],"mappings":"AAAA,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;AACvD,OAAO,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AACpD,OAAO,EAAE,aAAa,EAAoB,MAAM,qBAAqB,CAAC;AAItE,OAAO,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAC;AACpD,OAAO,EACL,gBAAgB,EAChB,iBAAiB,EACjB,eAAe,GAEhB,MAAM,wBAAwB,CAAC;AAChC,OAAO,EAAE,cAAc,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AAEnE,KAAK,UAAU,eAAe,CAAC,IAAY;IACzC,MAAM,KAAK,GAAG,YAAY,CAAC,IAAI,CAAC,CAAC;IAEjC,6EAA6E;IAC7E,uEAAuE;IACvE,8EAA8E;IAC9E,0EAA0E;IAC1E,wEAAwE;IACxE,mCAAmC;IACnC,OAAO,gBAAgB,CAAC;QACtB,KAAK;QACL,MAAM,EAAE,QAAQ;QAChB,IAAI,EAAE,GAAG,EAAE,CACT,gBAAgB,CAAC,KAAK,EAAE,MAAM,EAAE,EAAE,CAChC,YAAY,CACV,KAAK,EACL,KAAK,EAAE,IAAI,EAAE,EAAE,CAAC,CAAC,MAAM,cAAc,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC,CAAC,MAAM,EAC3D,QAAQ,CACT,CACF;QACH,OAAO,EAAE,CAAC,IAAI,EAAE,OAAO,EAAE,EAAE,CAAC,aAAa,CAAC,IAAI,EAAE,OAAO,CAAC;QACxD,WAAW,EAAE,CAAC,IAAI,EAAE,OAAO,EAAE,EAAE;YAC7B,MAAM,MAAM,GAAG,OAAO,CAAC,GAAG,CAAC,QAAQ,CAAC,IAAI,IAAI,CAAC;YAC7C,MAAM,aAAa,GAAG,OAAO,CAAC,GAAG,CAAC,gBAAgB,CAAC,IAAI,IAAI,CAAC;YAC5D,IAAI,MAAM,KAAK,IAAI,IAAI,aAAa,KAAK,IAAI,EAAE,CAAC;gBAC9C,OAAO,IAAI,CAAC;YACd,CAAC;YAED,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,aAAa,EAAE,CAAC;QACzC,CAAC;QACD,MAAM,EAAE,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,IAAI;KAC9B,CAAC,CAAC;AACL,CAAC;AAED,MAAM,UAAU,kBAAkB,CAChC,OAAsB,EACtB,aAAqB,EACrB,eAAe,GAAG,CAAC,EACnB,SAA2B;IACzB,UAAU,EAAE,CAAC;IACb,aAAa,EAAE,IAAI;IACnB,iBAAiB,EAAE,KAAK;CACzB;IAED,MAAM,MAAM,GAAG,OAAO;SACnB,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,MAAM,CAAC;SAC5B,MAAM,CAAC,CAAC,KAAK,EAAmB,EAAE,CAAC,KAAK,KAAK,IAAI,CAAC,CAAC;IAEtD,OAAO;QACL,aAAa;QACb,YAAY,EAAE,OAAO,CAAC,MAAM;QAC5B,eAAe;QACf,OAAO,EAAE,OAAO,CAAC,CAAC,CAAC,EAAE,MAAM,IAAI,IAAI;QACnC,MAAM,EAAE,OAAO,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,EAAE,MAAM,IAAI,IAAI;QACtC,KAAK,EAAE,cAAc,CAAC,MAAM,EAAE,KAAK,CAAC;QACpC,OAAO;QACP,UAAU,EAAE,MAAM,CAAC,UAAU;QAC7B,aAAa,EAAE,MAAM,CAAC,aAAa;QACnC,iBAAiB,EAAE,MAAM,CAAC,iBAAiB;KAC5C,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,gBAAgB,CAAC,OAAsB;IACrD,MAAM,IAAI,GAAG,eAAe,CAC1B;QACE,MAAM,EAAE,OAAO,CAAC,OAAO;QACvB,eAAe,EAAE,OAAO,CAAC,eAAe;QACxC,aAAa,EAAE,OAAO,CAAC,aAAa;QACpC,UAAU,EAAE,OAAO,CAAC,UAAU;QAC9B,aAAa,EAAE,OAAO,CAAC,aAAa;QACpC,iBAAiB,EAAE,OAAO,CAAC,iBAAiB;KAC7C,EACD,MAAM,CACP,CAAC;IAEF,IAAI,OAAO,CAAC,YAAY,KAAK,CAAC,EAAE,CAAC;QAC/B,OAAO,IAAI,IAAI,sCAAsC,OAAO,CAAC,aAAa,QAAQ,CAAC;IACrF,CAAC;IAED,MAAM,eAAe,GAAG,OAAO,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,MAAM,KAAK,IAAI,CAAC,CAAC,MAAM,CAAC;IAExF,MAAM,KAAK,GAAG,OAAO,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE;QACvD,MAAM,OAAO,GAAG,KAAK,CAAC,aAAa,KAAK,IAAI,CAAC,CAAC,CAAC,aAAa,KAAK,CAAC,aAAa,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QACvF,OAAO,GAAG,KAAK,CAAC,IAAI,aAAa,KAAK,CAAC,MAAM,IAAI,KAAK,GAAG,OAAO,EAAE,CAAC;IACrE,CAAC,CAAC,CAAC;IAEH,OAAO;QACL,IAAI;QACJ,uBAAuB,OAAO,CAAC,YAAY,iBAAiB;QAC5D,OAAO,CAAC,OAAO,KAAK,IAAI,CAAC,CAAC,CAAC,oBAAoB,OAAO,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC,EAAE;QACrE,OAAO,CAAC,MAAM,KAAK,IAAI,IAAI,OAAO,CAAC,YAAY,GAAG,CAAC;YACjD,CAAC,CAAC,oBAAoB,OAAO,CAAC,MAAM,EAAE;YACtC,CAAC,CAAC,EAAE;QACN,eAAe,GAAG,CAAC,CAAC,CAAC,CAAC,UAAU,OAAO,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC,EAAE;QACpD,EAAE;QACF,iBAAiB;QACjB,GAAG,KAAK;KACT;SACE,MAAM,CAAC,OAAO,CAAC;SACf,IAAI,CAAC,IAAI,CAAC,CAAC;AAChB,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,eAAe,CACnC,KAAwB;IAExB,MAAM,IAAI,GAAG,KAAK,CAAC,IAAI,IAAI,EAAE,CAAC;IAC9B,MAAM,QAAQ,GAAG,iBAAiB,CAAC,oBAAoB,EAAE,EAAE,IAAI,EAAE,CAAC,CAAC;IAEnE,MAAM,OAAO,GAAG,MAAM,SAAS,CAC7B,QAAQ,EACR,SAAS,CAAC,aAAa,EACvB,KAAK,IAAI,EAAE,CAAC,eAAe,CAAC,IAAI,CAAC,EACjC,EAAE,SAAS,EAAE,iBAAiB,EAAE,CACjC,CAAC;IAEF,MAAM,OAAO,GAAG,kBAAkB,CAAC,OAAO,CAAC,MAAM,EAAE,IAAI,EAAE,OAAO,CAAC,eAAe,EAAE,OAAO,CAAC,CAAC;IAE3F,OAAO;QACL,IAAI,EAAE,MAAM;QACZ,IAAI,EAAE,gBAAgB,CAAC,OAAO,CAAC;QAC/B,IAAI,EAAE,OAAO;KACd,CAAC;AACJ,CAAC;AAED,MAAM,CAAC,MAAM,qBAAqB,GAAqB;IACrD;QACE,IAAI,EAAE,oBAAoB;QAC1B,WAAW,EAAE,+DAA+D;QAC5E,WAAW,EAAE;YACX,IAAI,EAAE;gBACJ,IAAI,EAAE,QAAQ;gBACd,WAAW,EAAE,4CAA4C;aAC1D;SACF;QACD,OAAO,EAAE,eAAe;KACzB;CACF,CAAC"}

package/dist/tools/week.d.ts

@@ -0,0 +1,12 @@
+import { type WeekReview } from "../detect/week.js";
+import { type RaceCountdown } from "../detect/countdown.js";
+import type { ToolResult } from "../garmin/types.js";
+import type { ToolDefinition } from "./types.js";
+export interface WeekPayload {
+    review: WeekReview;
+    race: RaceCountdown | null;
+}
+export declare function renderWeekText(payload: WeekPayload): string;
+export declare function getWeekReview(): Promise<ToolResult<WeekPayload>>;
+export declare const weekToolDefinitions: ToolDefinition[];
+//# sourceMappingURL=week.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"week.d.ts","sourceRoot":"","sources":["../../src/tools/week.ts"],"names":[],"mappings":"AAEA,OAAO,EAAmB,KAAK,UAAU,EAAE,MAAM,mBAAmB,CAAC;AACrE,OAAO,EAA0B,KAAK,aAAa,EAAE,MAAM,wBAAwB,CAAC;AAEpF,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AACrD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAcjD,MAAM,WAAW,WAAW;IAC1B,MAAM,EAAE,UAAU,CAAC;IACnB,IAAI,EAAE,aAAa,GAAG,IAAI,CAAC;CAC5B;AAmBD,wBAAgB,cAAc,CAAC,OAAO,EAAE,WAAW,GAAG,MAAM,CA+C3D;AAED,wBAAsB,aAAa,IAAI,OAAO,CAAC,UAAU,CAAC,WAAW,CAAC,CAAC,CAYtE;AAED,eAAO,MAAM,mBAAmB,EAAE,cAAc,EAQ/C,CAAC"}

package/dist/tools/week.js

@@ -0,0 +1,74 @@
+import { DateTime } from "luxon";
+import { buildDetectorInput } from "../detect/index.js";
+import { buildWeekReview } from "../detect/week.js";
+import { nextRace, describeRace } from "../detect/countdown.js";
+import { activeContext, upcomingContext } from "../history/context.js";
+function formatMetric(metric) {
+    if (metric.current === null) {
+        return `${metric.label}: not recorded this week`;
+    }
+    const unit = metric.unit ? metric.unit : "";
+    const current = `${metric.current}${unit}`;
+    if (metric.previous === null) {
+        return `${metric.label}: ${current} (no comparable week before it)`;
+    }
+    const delta = metric.delta ?? 0;
+    const sign = delta > 0 ? "+" : "";
+    return `${metric.label}: ${current} vs ${metric.previous}${unit} (${sign}${delta}${unit})`;
+}
+export function renderWeekText(payload) {
+    const { review, race } = payload;
+    if (!review.ready) {
+        return [
+            review.headline,
+            "Run `trainbud backfill` to pull what Garmin already holds.",
+        ].join("\n");
+    }
+    const lines = [
+        `Week of ${review.start} to ${review.end}`,
+        "",
+        review.headline,
+        "",
+        `Sessions: ${review.sessions} (${review.movingMinutes} min) vs ${review.previousSessions} (${review.previousMovingMinutes} min) last week`,
+        "",
+        ...review.metrics.map(formatMetric),
+    ];
+    if (review.forecast.verdict !== "unknown") {
+        lines.push("", `Next week: ${review.forecast.summary}`);
+        if (review.forecast.weeklyLoadAdjustment !== null) {
+            const adjustment = review.forecast.weeklyLoadAdjustment;
+            lines.push(adjustment < 0
+                ? `To stay inside the band, this week's load would need to come down by about ${Math.abs(adjustment)} TRIMP.`
+                : `To stay inside the band, this week's load would need to come up by about ${adjustment} TRIMP.`);
+        }
+    }
+    if (review.sleep.habitualHours !== null) {
+        lines.push("", `Sleep: ${review.sleep.summary}`);
+    }
+    const raceLine = describeRace(race);
+    if (raceLine) {
+        lines.push("", raceLine);
+    }
+    lines.push("", "These are measurements against the user's own baselines, not diagnoses.");
+    return lines.join("\n");
+}
+export async function getWeekReview() {
+    const today = DateTime.local().toISODate() ?? "";
+    const review = buildWeekReview(buildDetectorInput());
+    const race = nextRace([...activeContext(today), ...upcomingContext(today)], today);
+    const payload = { review, race };
+    return {
+        type: "text",
+        text: renderWeekText(payload),
+        data: payload,
+    };
+}
+export const weekToolDefinitions = [
+    {
+        name: "get_week_review",
+        description: "Returns this training week against the previous one — sessions, training load, sleep, resting heart rate, HRV and stress — plus where the acute:chronic load ratio lands if next week repeats this one, a sleep debt and consistency read against the user's own baseline, and the next race on record. Prefer this over reading individual metrics when asked how the week or the block is going, whether to back off, or what to do next week.",
+        inputSchema: {},
+        handler: getWeekReview,
+    },
+];
+//# sourceMappingURL=week.js.map

package/dist/tools/week.js.map

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

package/dist/usage.d.ts

@@ -0,0 +1,104 @@
+export type AiUsageKind = "ask" | "insight";
+export type UsageSource = "watch" | "dashboard" | "cli" | "mcp" | "server";
+export interface TokenCounts {
+    inputTokens: number;
+    outputTokens: number;
+    cacheReadTokens?: number;
+    cacheWriteTokens?: number;
+}
+export interface AiUsageInput extends TokenCounts {
+    kind: AiUsageKind;
+    model: string;
+    source: UsageSource;
+    /** Unix seconds. Defaults to now; present so tests can place a call in time. */
+    at?: number;
+}
+export interface AiUsageRow extends AiUsageInput {
+    at: number;
+    costUsd: number | null;
+}
+export interface AiSpend {
+    calls: number;
+    inputTokens: number;
+    outputTokens: number;
+    costUsd: number;
+    /** Calls whose model had no published price here. */
+    unpricedCalls: number;
+}
+export interface BudgetState {
+    capUsd: number | null;
+    spentUsd: number;
+    remainingUsd: number | null;
+    exceeded: boolean;
+    /** True when unpriced calls make `spentUsd` a floor rather than a total. */
+    incomplete: boolean;
+}
+/** Cost in USD, or null when this model has no price here. */
+export declare function priceOf(model: string, tokens: TokenCounts): number | null;
+export declare function recordAiUsage(input: AiUsageInput): AiUsageRow;
+export declare function aiSpendSince(sinceUnixSeconds: number): AiSpend;
+/**
+ * Spend since the first of the current month, in the user's own local time.
+ *
+ * A rolling thirty days would be a different and worse number: a monthly cap
+ * that resets on a sliding window never resets, and the user compares this
+ * against a bill that runs calendar months.
+ */
+export declare function monthToDateSpend(): AiSpend;
+export declare function budgetState(): BudgetState;
+/** Thrown when a request is refused because the user's own cap is reached. */
+export declare class BudgetExceededError extends Error {
+    constructor(state: BudgetState);
+}
+/** Throws when a cap is set and already reached. No cap means never throws. */
+export declare function assertWithinBudget(): void;
+export interface AiUsageEntry {
+    at: number;
+    kind: string;
+    model: string;
+    source: string;
+    inputTokens: number;
+    outputTokens: number;
+    costUsd: number | null;
+}
+/** The most recent calls, newest first — the ledger behind the total. */
+export declare function recentAiUsage(limit?: number): AiUsageEntry[];
+export interface DailySpend {
+    day: string;
+    costUsd: number;
+    calls: number;
+}
+/**
+ * Cost per day for the last `days` days, including the days that cost nothing.
+ *
+ * The zero days are the point. A chart built only from rows that exist draws a
+ * continuous line through a week the user never opened the app, which reads as
+ * steady daily spend rather than as the four days it actually was.
+ */
+export declare function dailyAiSpend(days?: number): DailySpend[];
+export interface FeatureCount {
+    name: string;
+    count: number;
+}
+/**
+ * Count one use of one feature, today.
+ *
+ * Everything about this is best-effort. It is called from render paths and
+ * request handlers that have real work to do, and a counter that can throw is
+ * a counter that takes down the feature it was measuring.
+ */
+export declare function recordFeature(name: string): void;
+export declare function featureCounts(days?: number): FeatureCount[];
+/**
+ * Delete every stored feature counter.
+ *
+ * Offered because "stop counting" and "forget what you counted" are different
+ * requests, and a privacy control that only does the first is the kind that
+ * gets described as a privacy control and is not one. AI spend is deliberately
+ * NOT cleared here: that is the user's own billing record against a cap they
+ * set, and losing it would make the cap wrong for the rest of the month.
+ */
+export declare function clearFeatureUsage(): void;
+/** Tests only. */
+export declare function __clearUsageForTests(): void;
+//# sourceMappingURL=usage.d.ts.map

package/dist/usage.d.ts.map

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