@mongrov/analytics 0.1.0-alpha.7 → 0.1.0-alpha.9

package/dist/tools/impls/activity.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"activity.d.ts","sourceRoot":"","sources":["../../../src/tools/impls/activity.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AAEvB,OAAO,KAAK,EAAE,QAAQ,EAAc,MAAM,UAAU,CAAA;AAEpD,eAAO,MAAM,2BAA2B;;;;;;;;;EAGtC,CAAA;AAEF,MAAM,MAAM,qBAAqB,GAAG,CAAC,CAAC,KAAK,CACzC,OAAO,2BAA2B,CACnC,CAAA;AAaD,eAAO,MAAM,gBAAgB,EAAE,QAAQ,CAAC,qBAAqB,CAiE5D,CAAA"}

package/dist/tools/impls/activity.js

@@ -0,0 +1,61 @@
+import { z } from 'zod';
+import { formatBytes } from '../formatters';
+export const getActivityTotalInputSchema = z.object({
+    userId: z.string(),
+    days: z.number().int().min(1).max(90),
+});
+export const getActivityTotal = async (input, ctx) => {
+    const params = {
+        userId: input.userId,
+        brand: ctx.brand,
+        familyId: ctx.familyId,
+        days: input.days,
+    };
+    const steps = await ctx.analytics.execute(`SELECT date_trunc('day', ts)::VARCHAR AS day, SUM(steps)::INTEGER AS steps
+     FROM activity
+     WHERE user_id = $userId AND brand = $brand AND family_id = $familyId
+       AND ts >= now() - INTERVAL ($days) DAY
+     GROUP BY 1 ORDER BY 1`, params);
+    const buckets = await ctx.analytics.execute(`SELECT date_trunc('day', ts)::VARCHAR AS day,
+            SUM(calories)::DOUBLE AS calories,
+            SUM(distance_km)::DOUBLE AS distance_km
+     FROM activity_bucket
+     WHERE user_id = $userId AND brand = $brand AND family_id = $familyId
+       AND ts >= now() - INTERVAL ($days) DAY
+     GROUP BY 1 ORDER BY 1`, params);
+    if (steps.length === 0 && buckets.length === 0) {
+        return finalize('No activity data for the requested window.', 0);
+    }
+    const bucketByDay = new Map(buckets.map(b => [b.day, b]));
+    const days = new Set([
+        ...steps.map(s => s.day),
+        ...buckets.map(b => b.day),
+    ]);
+    const orderedDays = Array.from(days).sort();
+    let totalSteps = 0;
+    let totalCalories = 0;
+    let totalDistance = 0;
+    const perDay = [];
+    for (const day of orderedDays) {
+        const s = steps.find(r => r.day === day)?.steps ?? 0;
+        const b = bucketByDay.get(day);
+        totalSteps += s;
+        totalCalories += b?.calories ?? 0;
+        totalDistance += b?.distance_km ?? 0;
+        const parts = [`${s} steps`];
+        if (b?.calories != null)
+            parts.push(`${b.calories.toFixed(0)} kcal`);
+        if (b?.distance_km != null)
+            parts.push(`${b.distance_km.toFixed(2)} km`);
+        perDay.push(`  ${day}: ${parts.join(', ')}`);
+    }
+    const text = `Activity, last ${input.days} days:\n${perDay.join('\n')}\n`
+        + `  Totals: ${totalSteps} steps, `
+        + `${totalCalories.toFixed(0)} kcal, `
+        + `${totalDistance.toFixed(2)} km`;
+    return finalize(text, orderedDays.length);
+};
+function finalize(text, rowCount) {
+    return { text, rowCount, bytes: formatBytes(text) };
+}
+//# sourceMappingURL=activity.js.map

package/dist/tools/impls/activity.js.map

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

package/dist/tools/impls/anomaly.d.ts

@@ -0,0 +1,21 @@
+import { z } from 'zod';
+import type { ToolImpl } from '../types';
+export declare const detectAnomalyInputSchema: z.ZodObject<{
+    userId: z.ZodString;
+    metric: z.ZodEnum<["hrv_ms", "sleep_total_minutes", "activity_steps"]>;
+    lookbackDays: z.ZodNumber;
+    stddevThreshold: z.ZodDefault<z.ZodNumber>;
+}, "strip", z.ZodTypeAny, {
+    metric: "hrv_ms" | "activity_steps" | "sleep_total_minutes";
+    userId: string;
+    lookbackDays: number;
+    stddevThreshold: number;
+}, {
+    metric: "hrv_ms" | "activity_steps" | "sleep_total_minutes";
+    userId: string;
+    lookbackDays: number;
+    stddevThreshold?: number | undefined;
+}>;
+export type DetectAnomalyInput = z.infer<typeof detectAnomalyInputSchema>;
+export declare const detectAnomaly: ToolImpl<DetectAnomalyInput>;
+//# sourceMappingURL=anomaly.d.ts.map

package/dist/tools/impls/anomaly.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"anomaly.d.ts","sourceRoot":"","sources":["../../../src/tools/impls/anomaly.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AAEvB,OAAO,KAAK,EAAE,QAAQ,EAAc,MAAM,UAAU,CAAA;AAEpD,eAAO,MAAM,wBAAwB;;;;;;;;;;;;;;;EAKnC,CAAA;AAEF,MAAM,MAAM,kBAAkB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,wBAAwB,CAAC,CAAA;AA+CzE,eAAO,MAAM,aAAa,EAAE,QAAQ,CAAC,kBAAkB,CA4CtD,CAAA"}

package/dist/tools/impls/anomaly.js

@@ -0,0 +1,70 @@
+import { z } from 'zod';
+import { formatBytes, popStddev } from '../formatters';
+export const detectAnomalyInputSchema = z.object({
+    userId: z.string(),
+    metric: z.enum(['hrv_ms', 'sleep_total_minutes', 'activity_steps']),
+    lookbackDays: z.number().int().min(7).max(90),
+    stddevThreshold: z.number().min(1).max(4).default(2),
+});
+const METRIC_SPECS = {
+    hrv_ms: {
+        sql: lookbackDays => `SELECT date_trunc('day', ts)::VARCHAR AS day, AVG(hrv_ms)::DOUBLE AS value
+       FROM hrv
+       WHERE user_id = $userId AND brand = $brand AND family_id = $familyId
+         AND hrv_ms IS NOT NULL
+         AND ts >= now() - INTERVAL (${lookbackDays}) DAY
+       GROUP BY 1 ORDER BY 1`,
+        unit: 'ms',
+        label: 'HRV',
+    },
+    sleep_total_minutes: {
+        sql: lookbackDays => `SELECT night_of::VARCHAR AS day, SUM(total_minutes)::DOUBLE AS value
+       FROM sleep_session
+       WHERE user_id = $userId AND brand = $brand AND family_id = $familyId
+         AND ts_start >= now() - INTERVAL (${lookbackDays}) DAY
+       GROUP BY night_of ORDER BY night_of`,
+        unit: 'min',
+        label: 'sleep total',
+    },
+    activity_steps: {
+        sql: lookbackDays => `SELECT date_trunc('day', ts)::VARCHAR AS day, SUM(steps)::DOUBLE AS value
+       FROM activity
+       WHERE user_id = $userId AND brand = $brand AND family_id = $familyId
+         AND ts >= now() - INTERVAL (${lookbackDays}) DAY
+       GROUP BY 1 ORDER BY 1`,
+        unit: 'steps',
+        label: 'activity',
+    },
+};
+export const detectAnomaly = async (input, ctx) => {
+    const spec = METRIC_SPECS[input.metric];
+    const rows = await ctx.analytics.execute(spec.sql(input.lookbackDays), {
+        userId: input.userId,
+        brand: ctx.brand,
+        familyId: ctx.familyId,
+    });
+    if (rows.length === 0) {
+        return finalize(`No ${spec.label} data for the last ${input.lookbackDays} days.`, 0);
+    }
+    const values = rows.map(r => r.value);
+    const mean = values.reduce((a, v) => a + v, 0) / values.length;
+    const stddev = popStddev(values);
+    const gate = input.stddevThreshold * stddev;
+    const outliers = rows.filter(r => Math.abs(r.value - mean) > gate);
+    const outlierText = outliers.length === 0
+        ? '  No outliers detected.'
+        : outliers
+            .map(r => `  ${r.day}: ${r.value.toFixed(1)}${spec.unit} `
+            + `(${(r.value - mean).toFixed(1)}${spec.unit} from mean)`)
+            .join('\n');
+    const text = `${spec.label} anomalies (last ${input.lookbackDays}d, `
+        + `threshold ${input.stddevThreshold}σ):\n`
+        + `  baseline: mean ${mean.toFixed(1)}${spec.unit}, `
+        + `stddev ${stddev.toFixed(1)}${spec.unit}\n`
+        + `${outlierText}`;
+    return finalize(text, outliers.length);
+};
+function finalize(text, rowCount) {
+    return { text, rowCount, bytes: formatBytes(text) };
+}
+//# sourceMappingURL=anomaly.js.map

package/dist/tools/impls/anomaly.js.map

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

package/dist/tools/impls/compare.d.ts

@@ -0,0 +1,21 @@
+import { z } from 'zod';
+import type { ToolImpl } from '../types';
+export declare const compareTrendInputSchema: z.ZodObject<{
+    userId: z.ZodString;
+    metric: z.ZodEnum<["hrv_ms", "sleep_total_minutes", "activity_steps"]>;
+    currentWindowDays: z.ZodNumber;
+    priorWindowDays: z.ZodNumber;
+}, "strip", z.ZodTypeAny, {
+    metric: "hrv_ms" | "activity_steps" | "sleep_total_minutes";
+    userId: string;
+    currentWindowDays: number;
+    priorWindowDays: number;
+}, {
+    metric: "hrv_ms" | "activity_steps" | "sleep_total_minutes";
+    userId: string;
+    currentWindowDays: number;
+    priorWindowDays: number;
+}>;
+export type CompareTrendInput = z.infer<typeof compareTrendInputSchema>;
+export declare const compareTrend: ToolImpl<CompareTrendInput>;
+//# sourceMappingURL=compare.d.ts.map

package/dist/tools/impls/compare.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"compare.d.ts","sourceRoot":"","sources":["../../../src/tools/impls/compare.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AAEvB,OAAO,KAAK,EAAE,QAAQ,EAAc,MAAM,UAAU,CAAA;AAEpD,eAAO,MAAM,uBAAuB;;;;;;;;;;;;;;;EAKlC,CAAA;AAEF,MAAM,MAAM,iBAAiB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,uBAAuB,CAAC,CAAA;AAiDvE,eAAO,MAAM,YAAY,EAAE,QAAQ,CAAC,iBAAiB,CAuCpD,CAAA"}

package/dist/tools/impls/compare.js

@@ -0,0 +1,68 @@
+import { z } from 'zod';
+import { deltaPct, formatBytes } from '../formatters';
+export const compareTrendInputSchema = z.object({
+    userId: z.string(),
+    metric: z.enum(['hrv_ms', 'sleep_total_minutes', 'activity_steps']),
+    currentWindowDays: z.number().int().min(1).max(30),
+    priorWindowDays: z.number().int().min(1).max(30),
+});
+const METRIC_SPECS = {
+    hrv_ms: {
+        sql: (windowDays, offsetDays) => `SELECT AVG(hrv_ms)::DOUBLE AS value
+       FROM hrv
+       WHERE user_id = $userId AND brand = $brand AND family_id = $familyId
+         AND hrv_ms IS NOT NULL
+         AND ts >= now() - INTERVAL (${windowDays + offsetDays}) DAY
+         AND ts <  now() - INTERVAL (${offsetDays}) DAY`,
+        unit: 'ms',
+        label: 'HRV',
+    },
+    sleep_total_minutes: {
+        sql: (windowDays, offsetDays) => `SELECT AVG(total_minutes)::DOUBLE AS value
+       FROM sleep_session
+       WHERE user_id = $userId AND brand = $brand AND family_id = $familyId
+         AND ts_start >= now() - INTERVAL (${windowDays + offsetDays}) DAY
+         AND ts_start <  now() - INTERVAL (${offsetDays}) DAY`,
+        unit: 'min',
+        label: 'sleep total',
+    },
+    activity_steps: {
+        sql: (windowDays, offsetDays) => `SELECT AVG(daily_steps)::DOUBLE AS value FROM (
+         SELECT date_trunc('day', ts) AS day, SUM(steps) AS daily_steps
+         FROM activity
+         WHERE user_id = $userId AND brand = $brand AND family_id = $familyId
+           AND ts >= now() - INTERVAL (${windowDays + offsetDays}) DAY
+           AND ts <  now() - INTERVAL (${offsetDays}) DAY
+         GROUP BY 1
+       )`,
+        unit: 'steps/day',
+        label: 'activity',
+    },
+};
+export const compareTrend = async (input, ctx) => {
+    const spec = METRIC_SPECS[input.metric];
+    const params = {
+        userId: input.userId,
+        brand: ctx.brand,
+        familyId: ctx.familyId,
+    };
+    const currentRows = await ctx.analytics.execute(spec.sql(input.currentWindowDays, 0), params);
+    const priorRows = await ctx.analytics.execute(spec.sql(input.priorWindowDays, input.currentWindowDays), params);
+    const current = currentRows[0]?.value ?? null;
+    const prior = priorRows[0]?.value ?? null;
+    if (current == null && prior == null) {
+        return finalize(`Insufficient ${spec.label} data to compare the requested windows.`, 0);
+    }
+    const text = `${spec.label} trend (${input.metric}):\n`
+        + `  current ${input.currentWindowDays}d: ${fmt(current)}${spec.unit}\n`
+        + `  prior ${input.priorWindowDays}d:   ${fmt(prior)}${spec.unit}\n`
+        + `  delta: ${current != null && prior != null ? deltaPct(current, prior) : 'n/a'}`;
+    return finalize(text, (current == null ? 0 : 1) + (prior == null ? 0 : 1));
+};
+function fmt(v) {
+    return v == null ? 'n/a' : v.toFixed(1);
+}
+function finalize(text, rowCount) {
+    return { text, rowCount, bytes: formatBytes(text) };
+}
+//# sourceMappingURL=compare.js.map

package/dist/tools/impls/compare.js.map

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

package/dist/tools/impls/hrv.d.ts

@@ -0,0 +1,15 @@
+import { z } from 'zod';
+import type { ToolImpl } from '../types';
+export declare const getHRVInputSchema: z.ZodObject<{
+    userId: z.ZodString;
+    days: z.ZodNumber;
+}, "strip", z.ZodTypeAny, {
+    days: number;
+    userId: string;
+}, {
+    days: number;
+    userId: string;
+}>;
+export type GetHRVInput = z.infer<typeof getHRVInputSchema>;
+export declare const getHRV: ToolImpl<GetHRVInput>;
+//# sourceMappingURL=hrv.d.ts.map

package/dist/tools/impls/hrv.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"hrv.d.ts","sourceRoot":"","sources":["../../../src/tools/impls/hrv.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AAEvB,OAAO,KAAK,EAAE,QAAQ,EAAc,MAAM,UAAU,CAAA;AAEpD,eAAO,MAAM,iBAAiB;;;;;;;;;EAG5B,CAAA;AAEF,MAAM,MAAM,WAAW,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,iBAAiB,CAAC,CAAA;AAO3D,eAAO,MAAM,MAAM,EAAE,QAAQ,CAAC,WAAW,CAiCxC,CAAA"}

package/dist/tools/impls/hrv.js

@@ -0,0 +1,36 @@
+import { z } from 'zod';
+import { deltaPct, formatBytes } from '../formatters';
+export const getHRVInputSchema = z.object({
+    userId: z.string(),
+    days: z.number().int().min(1).max(90),
+});
+export const getHRV = async (input, ctx) => {
+    const rows = await ctx.analytics.execute(`SELECT date_trunc('day', ts)::VARCHAR AS day, AVG(hrv_ms)::DOUBLE AS avg_hrv
+     FROM hrv
+     WHERE user_id = $userId AND brand = $brand AND family_id = $familyId
+       AND ts >= now() - INTERVAL ($days) DAY
+       AND hrv_ms IS NOT NULL
+     GROUP BY 1 ORDER BY 1`, {
+        userId: input.userId,
+        brand: ctx.brand,
+        familyId: ctx.familyId,
+        days: input.days,
+    });
+    if (rows.length === 0) {
+        return finalize('No HRV data for the requested window.', 0);
+    }
+    const values = rows.map(r => r.avg_hrv);
+    const baseline = values.reduce((a, v) => a + v, 0) / values.length;
+    const latest = values[values.length - 1];
+    const daily = rows
+        .map(r => `  ${r.day}: ${r.avg_hrv.toFixed(1)}ms`)
+        .join('\n');
+    const text = `HRV, last ${input.days} days:\n${daily}\n`
+        + `  ${input.days}-day avg: ${baseline.toFixed(1)}ms `
+        + `(latest ${latest.toFixed(1)}ms, ${deltaPct(latest, baseline)} vs avg)`;
+    return finalize(text, rows.length);
+};
+function finalize(text, rowCount) {
+    return { text, rowCount, bytes: formatBytes(text) };
+}
+//# sourceMappingURL=hrv.js.map

package/dist/tools/impls/hrv.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"hrv.js","sourceRoot":"","sources":["../../../src/tools/impls/hrv.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AACvB,OAAO,EAAE,QAAQ,EAAE,WAAW,EAAE,MAAM,eAAe,CAAA;AAGrD,MAAM,CAAC,MAAM,iBAAiB,GAAG,CAAC,CAAC,MAAM,CAAC;IACxC,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE;IAClB,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,EAAE,CAAC;CACtC,CAAC,CAAA;AASF,MAAM,CAAC,MAAM,MAAM,GAA0B,KAAK,EAAE,KAAK,EAAE,GAAG,EAAE,EAAE;IAChE,MAAM,IAAI,GAAG,MAAM,GAAG,CAAC,SAAS,CAAC,OAAO,CACtC;;;;;2BAKuB,EACvB;QACE,MAAM,EAAE,KAAK,CAAC,MAAM;QACpB,KAAK,EAAE,GAAG,CAAC,KAAK;QAChB,QAAQ,EAAE,GAAG,CAAC,QAAQ;QACtB,IAAI,EAAE,KAAK,CAAC,IAAI;KACjB,CACF,CAAA;IAED,IAAI,IAAI,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACtB,OAAO,QAAQ,CAAC,uCAAuC,EAAE,CAAC,CAAC,CAAA;IAC7D,CAAC;IAED,MAAM,MAAM,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC,CAAA;IACvC,MAAM,QAAQ,GAAG,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,GAAG,MAAM,CAAC,MAAM,CAAA;IAClE,MAAM,MAAM,GAAG,MAAM,CAAC,MAAM,CAAC,MAAM,GAAG,CAAC,CAAC,CAAA;IACxC,MAAM,KAAK,GAAG,IAAI;SACf,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,KAAK,CAAC,CAAC,GAAG,KAAK,CAAC,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC,CAAC,IAAI,CAAC;SACjD,IAAI,CAAC,IAAI,CAAC,CAAA;IAEb,MAAM,IAAI,GACN,aAAa,KAAK,CAAC,IAAI,WAAW,KAAK,IAAI;UAC3C,KAAK,KAAK,CAAC,IAAI,aAAa,QAAQ,CAAC,OAAO,CAAC,CAAC,CAAC,KAAK;UACpD,WAAW,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,OAAO,QAAQ,CAAC,MAAM,EAAE,QAAQ,CAAC,UAAU,CAAA;IAE3E,OAAO,QAAQ,CAAC,IAAI,EAAE,IAAI,CAAC,MAAM,CAAC,CAAA;AACpC,CAAC,CAAA;AAED,SAAS,QAAQ,CAAC,IAAY,EAAE,QAAgB;IAC9C,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAE,KAAK,EAAE,WAAW,CAAC,IAAI,CAAC,EAAE,CAAA;AACrD,CAAC"}

package/dist/tools/impls/insights.d.ts

@@ -0,0 +1,18 @@
+import { z } from 'zod';
+import type { ToolImpl } from '../types';
+export declare const getInsightsInputSchema: z.ZodObject<{
+    userId: z.ZodString;
+    days: z.ZodDefault<z.ZodNumber>;
+    severity: z.ZodOptional<z.ZodEnum<["info", "warn", "critical"]>>;
+}, "strip", z.ZodTypeAny, {
+    days: number;
+    userId: string;
+    severity?: "info" | "warn" | "critical" | undefined;
+}, {
+    userId: string;
+    days?: number | undefined;
+    severity?: "info" | "warn" | "critical" | undefined;
+}>;
+export type GetInsightsInput = z.infer<typeof getInsightsInputSchema>;
+export declare const getInsights: ToolImpl<GetInsightsInput>;
+//# sourceMappingURL=insights.d.ts.map

package/dist/tools/impls/insights.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"insights.d.ts","sourceRoot":"","sources":["../../../src/tools/impls/insights.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AAEvB,OAAO,KAAK,EAAE,QAAQ,EAAc,MAAM,UAAU,CAAA;AAEpD,eAAO,MAAM,sBAAsB;;;;;;;;;;;;EAIjC,CAAA;AAEF,MAAM,MAAM,gBAAgB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,sBAAsB,CAAC,CAAA;AAUrE,eAAO,MAAM,WAAW,EAAE,QAAQ,CAAC,gBAAgB,CAuClD,CAAA"}

package/dist/tools/impls/insights.js

@@ -0,0 +1,41 @@
+import { z } from 'zod';
+import { formatBytes } from '../formatters';
+export const getInsightsInputSchema = z.object({
+    userId: z.string(),
+    days: z.number().int().min(1).max(30).default(7),
+    severity: z.enum(['info', 'warn', 'critical']).optional(),
+});
+export const getInsights = async (input, ctx) => {
+    const params = {
+        userId: input.userId,
+        brand: ctx.brand,
+        familyId: ctx.familyId,
+        days: input.days,
+    };
+    let severityClause = '';
+    if (input.severity) {
+        severityClause = ' AND severity = $severity';
+        params.severity = input.severity;
+    }
+    const rows = await ctx.analytics.execute(`SELECT id, ts::VARCHAR AS ts, severity, title, body
+     FROM insight
+     WHERE user_id = $userId AND brand = $brand AND family_id = $familyId
+       AND ts >= now() - INTERVAL ($days) DAY${severityClause}
+     ORDER BY ts DESC`, params);
+    if (rows.length === 0) {
+        const scope = input.severity ? ` (${input.severity})` : '';
+        return finalize(`No insights${scope} in the last ${input.days} days.`, 0);
+    }
+    const bullets = rows
+        .map((r) => {
+        const body = r.body ? ` — ${r.body}` : '';
+        return `  [${r.severity}] ${r.ts}: ${r.title}${body}`;
+    })
+        .join('\n');
+    const text = `Insights, last ${input.days} days:\n${bullets}`;
+    return finalize(text, rows.length);
+};
+function finalize(text, rowCount) {
+    return { text, rowCount, bytes: formatBytes(text) };
+}
+//# sourceMappingURL=insights.js.map

package/dist/tools/impls/insights.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"insights.js","sourceRoot":"","sources":["../../../src/tools/impls/insights.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AACvB,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAA;AAG3C,MAAM,CAAC,MAAM,sBAAsB,GAAG,CAAC,CAAC,MAAM,CAAC;IAC7C,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE;IAClB,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC;IAChD,QAAQ,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,MAAM,EAAE,MAAM,EAAE,UAAU,CAAC,CAAC,CAAC,QAAQ,EAAE;CAC1D,CAAC,CAAA;AAYF,MAAM,CAAC,MAAM,WAAW,GAA+B,KAAK,EAAE,KAAK,EAAE,GAAG,EAAE,EAAE;IAC1E,MAAM,MAAM,GAA4B;QACtC,MAAM,EAAE,KAAK,CAAC,MAAM;QACpB,KAAK,EAAE,GAAG,CAAC,KAAK;QAChB,QAAQ,EAAE,GAAG,CAAC,QAAQ;QACtB,IAAI,EAAE,KAAK,CAAC,IAAI;KACjB,CAAA;IACD,IAAI,cAAc,GAAG,EAAE,CAAA;IACvB,IAAI,KAAK,CAAC,QAAQ,EAAE,CAAC;QACnB,cAAc,GAAG,2BAA2B,CAAA;QAC5C,MAAM,CAAC,QAAQ,GAAG,KAAK,CAAC,QAAQ,CAAA;IAClC,CAAC;IAED,MAAM,IAAI,GAAG,MAAM,GAAG,CAAC,SAAS,CAAC,OAAO,CACtC;;;+CAG2C,cAAc;sBACvC,EAClB,MAAM,CACP,CAAA;IAED,IAAI,IAAI,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACtB,MAAM,KAAK,GAAG,KAAK,CAAC,QAAQ,CAAC,CAAC,CAAC,KAAK,KAAK,CAAC,QAAQ,GAAG,CAAC,CAAC,CAAC,EAAE,CAAA;QAC1D,OAAO,QAAQ,CACb,cAAc,KAAK,gBAAgB,KAAK,CAAC,IAAI,QAAQ,EACrD,CAAC,CACF,CAAA;IACH,CAAC;IAED,MAAM,OAAO,GAAG,IAAI;SACjB,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE;QACT,MAAM,IAAI,GAAG,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,CAAA;QACzC,OAAO,MAAM,CAAC,CAAC,QAAQ,KAAK,CAAC,CAAC,EAAE,KAAK,CAAC,CAAC,KAAK,GAAG,IAAI,EAAE,CAAA;IACvD,CAAC,CAAC;SACD,IAAI,CAAC,IAAI,CAAC,CAAA;IAEb,MAAM,IAAI,GAAG,kBAAkB,KAAK,CAAC,IAAI,WAAW,OAAO,EAAE,CAAA;IAC7D,OAAO,QAAQ,CAAC,IAAI,EAAE,IAAI,CAAC,MAAM,CAAC,CAAA;AACpC,CAAC,CAAA;AAED,SAAS,QAAQ,CAAC,IAAY,EAAE,QAAgB;IAC9C,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAE,KAAK,EAAE,WAAW,CAAC,IAAI,CAAC,EAAE,CAAA;AACrD,CAAC"}

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

@@ -0,0 +1,15 @@
+import { z } from 'zod';
+import type { ToolImpl } from '../types';
+export declare const getSleepSummaryInputSchema: z.ZodObject<{
+    userId: z.ZodString;
+    days: z.ZodNumber;
+}, "strip", z.ZodTypeAny, {
+    days: number;
+    userId: string;
+}, {
+    days: number;
+    userId: string;
+}>;
+export type GetSleepSummaryInput = z.infer<typeof getSleepSummaryInputSchema>;
+export declare const getSleepSummary: ToolImpl<GetSleepSummaryInput>;
+//# sourceMappingURL=sleep.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"sleep.d.ts","sourceRoot":"","sources":["../../../src/tools/impls/sleep.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AAEvB,OAAO,KAAK,EAAE,QAAQ,EAAc,MAAM,UAAU,CAAA;AAEpD,eAAO,MAAM,0BAA0B;;;;;;;;;EAGrC,CAAA;AAEF,MAAM,MAAM,oBAAoB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,0BAA0B,CAAC,CAAA;AAU7E,eAAO,MAAM,eAAe,EAAE,QAAQ,CAAC,oBAAoB,CA0C1D,CAAA"}

package/dist/tools/impls/sleep.js

@@ -0,0 +1,43 @@
+import { z } from 'zod';
+import { formatBytes } from '../formatters';
+export const getSleepSummaryInputSchema = z.object({
+    userId: z.string(),
+    days: z.number().int().min(1).max(90),
+});
+export const getSleepSummary = async (input, ctx) => {
+    const rows = await ctx.analytics.execute(`SELECT night_of::VARCHAR AS night_of,
+            SUM(total_minutes)::INTEGER AS total_minutes,
+            SUM(deep_minutes)::INTEGER AS deep_minutes,
+            SUM(rem_minutes)::INTEGER AS rem_minutes,
+            SUM(light_minutes)::INTEGER AS light_minutes
+     FROM sleep_session
+     WHERE user_id = $userId AND brand = $brand AND family_id = $familyId
+       AND ts_start >= now() - INTERVAL ($days) DAY
+     GROUP BY night_of ORDER BY night_of`, {
+        userId: input.userId,
+        brand: ctx.brand,
+        familyId: ctx.familyId,
+        days: input.days,
+    });
+    if (rows.length === 0) {
+        return finalize('No sleep sessions for the requested window.', 0);
+    }
+    const totalMean = rows.reduce((a, r) => a + r.total_minutes, 0) / rows.length;
+    const perNight = rows
+        .map((r) => {
+        const parts = [`${r.total_minutes}m total`];
+        if (r.deep_minutes != null)
+            parts.push(`${r.deep_minutes}m deep`);
+        if (r.rem_minutes != null)
+            parts.push(`${r.rem_minutes}m REM`);
+        return `  ${r.night_of}: ${parts.join(', ')}`;
+    })
+        .join('\n');
+    const text = `Sleep, last ${input.days} days:\n${perNight}\n`
+        + `  ${rows.length}-night avg total: ${totalMean.toFixed(0)}m`;
+    return finalize(text, rows.length);
+};
+function finalize(text, rowCount) {
+    return { text, rowCount, bytes: formatBytes(text) };
+}
+//# sourceMappingURL=sleep.js.map

package/dist/tools/impls/sleep.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sleep.js","sourceRoot":"","sources":["../../../src/tools/impls/sleep.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AACvB,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAA;AAG3C,MAAM,CAAC,MAAM,0BAA0B,GAAG,CAAC,CAAC,MAAM,CAAC;IACjD,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE;IAClB,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,EAAE,CAAC;CACtC,CAAC,CAAA;AAYF,MAAM,CAAC,MAAM,eAAe,GAAmC,KAAK,EAClE,KAAK,EACL,GAAG,EACH,EAAE;IACF,MAAM,IAAI,GAAG,MAAM,GAAG,CAAC,SAAS,CAAC,OAAO,CACtC;;;;;;;;yCAQqC,EACrC;QACE,MAAM,EAAE,KAAK,CAAC,MAAM;QACpB,KAAK,EAAE,GAAG,CAAC,KAAK;QAChB,QAAQ,EAAE,GAAG,CAAC,QAAQ;QACtB,IAAI,EAAE,KAAK,CAAC,IAAI;KACjB,CACF,CAAA;IAED,IAAI,IAAI,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACtB,OAAO,QAAQ,CAAC,6CAA6C,EAAE,CAAC,CAAC,CAAA;IACnE,CAAC;IAED,MAAM,SAAS,GACX,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,aAAa,EAAE,CAAC,CAAC,GAAG,IAAI,CAAC,MAAM,CAAA;IAC/D,MAAM,QAAQ,GAAG,IAAI;SAClB,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE;QACT,MAAM,KAAK,GAAa,CAAC,GAAG,CAAC,CAAC,aAAa,SAAS,CAAC,CAAA;QACrD,IAAI,CAAC,CAAC,YAAY,IAAI,IAAI;YAAE,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,YAAY,QAAQ,CAAC,CAAA;QACjE,IAAI,CAAC,CAAC,WAAW,IAAI,IAAI;YAAE,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,WAAW,OAAO,CAAC,CAAA;QAC9D,OAAO,KAAK,CAAC,CAAC,QAAQ,KAAK,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAA;IAC/C,CAAC,CAAC;SACD,IAAI,CAAC,IAAI,CAAC,CAAA;IAEb,MAAM,IAAI,GACN,eAAe,KAAK,CAAC,IAAI,WAAW,QAAQ,IAAI;UAChD,KAAK,IAAI,CAAC,MAAM,qBAAqB,SAAS,CAAC,OAAO,CAAC,CAAC,CAAC,GAAG,CAAA;IAEhE,OAAO,QAAQ,CAAC,IAAI,EAAE,IAAI,CAAC,MAAM,CAAC,CAAA;AACpC,CAAC,CAAA;AAED,SAAS,QAAQ,CAAC,IAAY,EAAE,QAAgB;IAC9C,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAE,KAAK,EAAE,WAAW,CAAC,IAAI,CAAC,EAAE,CAAA;AACrD,CAAC"}

package/dist/tools/index.d.ts

@@ -1,2 +1,14 @@
-export {};
+export * from './audit';
+export * from './authorize';
+export * from './budget';
+export * from './factory';
+export * from './rate-limit';
+export * from './types';
+export * from './wrap';
+export { getHRV, getHRVInputSchema, type GetHRVInput, } from './impls/hrv';
+export { getSleepSummary, getSleepSummaryInputSchema, type GetSleepSummaryInput, } from './impls/sleep';
+export { getActivityTotal, getActivityTotalInputSchema, type GetActivityTotalInput, } from './impls/activity';
+export { compareTrend, compareTrendInputSchema, type CompareTrendInput, } from './impls/compare';
+export { detectAnomaly, detectAnomalyInputSchema, type DetectAnomalyInput, } from './impls/anomaly';
+export { getInsights, getInsightsInputSchema, type GetInsightsInput, } from './impls/insights';
 //# sourceMappingURL=index.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/tools/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/tools/index.ts"],"names":[],"mappings":"AASA,cAAc,SAAS,CAAA;AACvB,cAAc,aAAa,CAAA;AAC3B,cAAc,UAAU,CAAA;AACxB,cAAc,WAAW,CAAA;AACzB,cAAc,cAAc,CAAA;AAC5B,cAAc,SAAS,CAAA;AACvB,cAAc,QAAQ,CAAA;AAEtB,OAAO,EACL,MAAM,EACN,iBAAiB,EACjB,KAAK,WAAW,GACjB,MAAM,aAAa,CAAA;AACpB,OAAO,EACL,eAAe,EACf,0BAA0B,EAC1B,KAAK,oBAAoB,GAC1B,MAAM,eAAe,CAAA;AACtB,OAAO,EACL,gBAAgB,EAChB,2BAA2B,EAC3B,KAAK,qBAAqB,GAC3B,MAAM,kBAAkB,CAAA;AACzB,OAAO,EACL,YAAY,EACZ,uBAAuB,EACvB,KAAK,iBAAiB,GACvB,MAAM,iBAAiB,CAAA;AACxB,OAAO,EACL,aAAa,EACb,wBAAwB,EACxB,KAAK,kBAAkB,GACxB,MAAM,iBAAiB,CAAA;AACxB,OAAO,EACL,WAAW,EACX,sBAAsB,EACtB,KAAK,gBAAgB,GACtB,MAAM,kBAAkB,CAAA"}

package/dist/tools/index.js

@@ -1,2 +1,22 @@
-export {};
+// @mongrov/analytics/tools — typed AI SDK tools + MCP.
+//
+// v0.1.0-alpha (T-01..T-12 landed): tool impls, formatters, rate
+// limiter, authorize hooks (with optional familyMembersProvider),
+// batched `tool_call_audit` writer, output-budget helper, `makeTool`
+// wrapper composing rate → auth → execute → budget → audit, and the
+// `createAnalyticsTools` factory returning an AI SDK tool map.
+// MCP subpath (T-13/T-14) still pending.
+export * from './audit';
+export * from './authorize';
+export * from './budget';
+export * from './factory';
+export * from './rate-limit';
+export * from './types';
+export * from './wrap';
+export { getHRV, getHRVInputSchema, } from './impls/hrv';
+export { getSleepSummary, getSleepSummaryInputSchema, } from './impls/sleep';
+export { getActivityTotal, getActivityTotalInputSchema, } from './impls/activity';
+export { compareTrend, compareTrendInputSchema, } from './impls/compare';
+export { detectAnomaly, detectAnomalyInputSchema, } from './impls/anomaly';
+export { getInsights, getInsightsInputSchema, } from './impls/insights';
 //# sourceMappingURL=index.js.map

package/dist/tools/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/tools/index.ts"],"names":[],"mappings":""}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/tools/index.ts"],"names":[],"mappings":"AAAA,uDAAuD;AACvD,EAAE;AACF,iEAAiE;AACjE,kEAAkE;AAClE,qEAAqE;AACrE,oEAAoE;AACpE,+DAA+D;AAC/D,yCAAyC;AAEzC,cAAc,SAAS,CAAA;AACvB,cAAc,aAAa,CAAA;AAC3B,cAAc,UAAU,CAAA;AACxB,cAAc,WAAW,CAAA;AACzB,cAAc,cAAc,CAAA;AAC5B,cAAc,SAAS,CAAA;AACvB,cAAc,QAAQ,CAAA;AAEtB,OAAO,EACL,MAAM,EACN,iBAAiB,GAElB,MAAM,aAAa,CAAA;AACpB,OAAO,EACL,eAAe,EACf,0BAA0B,GAE3B,MAAM,eAAe,CAAA;AACtB,OAAO,EACL,gBAAgB,EAChB,2BAA2B,GAE5B,MAAM,kBAAkB,CAAA;AACzB,OAAO,EACL,YAAY,EACZ,uBAAuB,GAExB,MAAM,iBAAiB,CAAA;AACxB,OAAO,EACL,aAAa,EACb,wBAAwB,GAEzB,MAAM,iBAAiB,CAAA;AACxB,OAAO,EACL,WAAW,EACX,sBAAsB,GAEvB,MAAM,kBAAkB,CAAA"}

package/dist/tools/rate-limit.d.ts

@@ -0,0 +1,26 @@
+/**
+ * In-memory token-bucket rate limiter for analytics tools.
+ *
+ * Three independent buckets per `(toolName, userId)`:
+ *   - per-tool-per-minute
+ *   - per-tool-per-hour
+ *   - per-user-per-minute (across all tools)
+ *
+ * `check(toolName, userId)` refills every bucket by elapsed time,
+ * then attempts to spend one token from all three. If any lacks a
+ * token, returns `false` **without** spending from the others.
+ * Otherwise deducts one from each and returns `true`.
+ *
+ * Persistence is out of scope for v0.1.0 — process restart resets
+ * buckets. Audit persistence (T-09) handles the durable trail.
+ */
+import { type RateLimitConfig } from './types';
+export interface RateLimiter {
+    check: (toolName: string, userId: string) => boolean;
+}
+export interface CreateRateLimiterConfig {
+    config?: RateLimitConfig;
+    clock?: () => number;
+}
+export declare function createRateLimiter(cfg?: CreateRateLimiterConfig): RateLimiter;
+//# sourceMappingURL=rate-limit.d.ts.map

package/dist/tools/rate-limit.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"rate-limit.d.ts","sourceRoot":"","sources":["../../src/tools/rate-limit.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAEH,OAAO,EAAsB,KAAK,eAAe,EAAE,MAAM,SAAS,CAAA;AAUlE,MAAM,WAAW,WAAW;IAC1B,KAAK,EAAE,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,KAAK,OAAO,CAAA;CACrD;AAED,MAAM,WAAW,uBAAuB;IACtC,MAAM,CAAC,EAAE,eAAe,CAAA;IACxB,KAAK,CAAC,EAAE,MAAM,MAAM,CAAA;CACrB;AAKD,wBAAgB,iBAAiB,CAC/B,GAAG,GAAE,uBAA4B,GAChC,WAAW,CA6Eb"}

package/dist/tools/rate-limit.js

@@ -0,0 +1,67 @@
+/**
+ * In-memory token-bucket rate limiter for analytics tools.
+ *
+ * Three independent buckets per `(toolName, userId)`:
+ *   - per-tool-per-minute
+ *   - per-tool-per-hour
+ *   - per-user-per-minute (across all tools)
+ *
+ * `check(toolName, userId)` refills every bucket by elapsed time,
+ * then attempts to spend one token from all three. If any lacks a
+ * token, returns `false` **without** spending from the others.
+ * Otherwise deducts one from each and returns `true`.
+ *
+ * Persistence is out of scope for v0.1.0 — process restart resets
+ * buckets. Audit persistence (T-09) handles the durable trail.
+ */
+import { DEFAULT_RATE_LIMIT } from './types';
+const MS_PER_MINUTE = 60000;
+const MS_PER_HOUR = 3600000;
+export function createRateLimiter(cfg = {}) {
+    const rl = cfg.config ?? DEFAULT_RATE_LIMIT;
+    const clock = cfg.clock ?? Date.now;
+    const perToolMinute = new Map();
+    const perToolHour = new Map();
+    const perUserMinute = new Map();
+    function getOrCreate(map, key, capacity, windowMs, now) {
+        let b = map.get(key);
+        if (!b) {
+            b = {
+                tokens: capacity,
+                lastRefillMs: now,
+                capacity,
+                refillPerMs: capacity / windowMs,
+            };
+            map.set(key, b);
+        }
+        return b;
+    }
+    function refill(b, now) {
+        const elapsed = now - b.lastRefillMs;
+        if (elapsed <= 0)
+            return;
+        b.tokens = Math.min(b.capacity, b.tokens + elapsed * b.refillPerMs);
+        b.lastRefillMs = now;
+    }
+    return {
+        check(toolName, userId) {
+            const now = clock();
+            const toolKey = `${toolName}:${userId}`;
+            const userKey = userId;
+            const tm = getOrCreate(perToolMinute, toolKey, rl.perToolPerMinute, MS_PER_MINUTE, now);
+            const th = getOrCreate(perToolHour, toolKey, rl.perToolPerHour, MS_PER_HOUR, now);
+            const um = getOrCreate(perUserMinute, userKey, rl.perUserPerMinute, MS_PER_MINUTE, now);
+            refill(tm, now);
+            refill(th, now);
+            refill(um, now);
+            if (tm.tokens < 1 || th.tokens < 1 || um.tokens < 1) {
+                return false;
+            }
+            tm.tokens -= 1;
+            th.tokens -= 1;
+            um.tokens -= 1;
+            return true;
+        },
+    };
+}
+//# sourceMappingURL=rate-limit.js.map