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

package/dist/tools/factory.js

@@ -0,0 +1,137 @@
+/**
+ * `createAnalyticsTools` — assemble the 6 wrapped AI SDK tools into
+ * a single map ready to hand to `streamText({ tools })` / `generateText`.
+ *
+ * Wires:
+ *   - rate limiter   (or `null` if `rateLimit: false`)
+ *   - authorize hook (default `familyScopeAuthorize`, optionally with
+ *                     an injected `familyMembersProvider`)
+ *   - audit writer   (batched, optional)
+ *   - output budget  (default 4096 bytes / 100 rows)
+ *
+ * Per-request context threading: the AI SDK's `execute(input)` has no
+ * ctx arg. We hold a mutable `currentCtx` container and expose
+ * `setContext(ctx)`. Consumers (zivaone_app) call `setContext` before
+ * each LLM turn — matching how `@mongrov/ai`'s `AIProvider` threads
+ * per-request scopes. This design keeps rate-limiter buckets + audit
+ * writer state shared across requests rather than rebuilding the
+ * whole tool map per turn.
+ */
+import { createAuditWriter } from './audit';
+import { familyScopeAuthorize } from './authorize';
+import { createRateLimiter } from './rate-limit';
+import { DEFAULT_OUTPUT_BUDGET, DEFAULT_RATE_LIMIT, } from './types';
+import { makeTool } from './wrap';
+import { getActivityTotal, getActivityTotalInputSchema, } from './impls/activity';
+import { detectAnomaly, detectAnomalyInputSchema, } from './impls/anomaly';
+import { compareTrend, compareTrendInputSchema, } from './impls/compare';
+import { getHRV, getHRVInputSchema } from './impls/hrv';
+import { getInsights, getInsightsInputSchema, } from './impls/insights';
+import { getSleepSummary, getSleepSummaryInputSchema, } from './impls/sleep';
+const DESCRIPTIONS = {
+    getHRV: 'Return the requester\'s or a family member\'s average HRV per day '
+        + 'over the last N days (1..90). Args: userId, days.',
+    getSleepSummary: 'Return nightly sleep duration and efficiency for a user '
+        + 'over the last N days (1..30). Args: userId, days.',
+    getActivityTotal: 'Return total steps and active minutes per day for a user '
+        + 'over the last N days (1..30). Args: userId, days.',
+    compareTrend: 'Compare a user\'s metric average across two windows. Args: '
+        + 'userId, metric (hrv_ms|sleep_total_minutes|activity_steps), '
+        + 'currentWindowDays, priorWindowDays (each 1..30).',
+    detectAnomaly: 'Flag statistical outliers (>= stddevThreshold from baseline) '
+        + 'in a user\'s metric over the last lookbackDays. Args: userId, metric '
+        + '(hrv_ms|sleep_total_minutes|activity_steps), lookbackDays (7..90), '
+        + 'stddevThreshold (1..4, default 2).',
+    getInsights: 'Return recent AI-generated insights for a user. Args: userId, '
+        + 'days (1..30, default 7), optional severity (info|warn|critical).',
+};
+export function createAnalyticsTools(config) {
+    const budget = {
+        ...DEFAULT_OUTPUT_BUDGET,
+        ...(config.outputBudget ?? {}),
+    };
+    const rateLimiter = config.rateLimit === false
+        ? null
+        : createRateLimiter({
+            config: config.rateLimit ?? DEFAULT_RATE_LIMIT,
+            clock: config.clock,
+        });
+    const authorize = config.authorize
+        ?? familyScopeAuthorize(config.analytics, {
+            familyMembersProvider: config.familyMembersProvider,
+        });
+    const audit = createAuditWriter({
+        analytics: config.analytics,
+        enabled: config.audit?.enabled ?? true,
+        batchSize: config.audit?.batchSize,
+        flushIntervalMs: config.audit?.flushIntervalMs,
+        logger: config.logger,
+    });
+    let currentCtx = null;
+    const ctxProvider = () => currentCtx;
+    const shared = {
+        analytics: config.analytics,
+        authorize,
+        rateLimiter,
+        audit,
+        budget,
+        logger: config.logger,
+        ctxProvider,
+        clock: config.clock,
+    };
+    const tools = {
+        getHRV: makeTool({
+            ...shared,
+            name: 'getHRV',
+            description: DESCRIPTIONS.getHRV,
+            inputSchema: getHRVInputSchema,
+            impl: getHRV,
+        }),
+        getSleepSummary: makeTool({
+            ...shared,
+            name: 'getSleepSummary',
+            description: DESCRIPTIONS.getSleepSummary,
+            inputSchema: getSleepSummaryInputSchema,
+            impl: getSleepSummary,
+        }),
+        getActivityTotal: makeTool({
+            ...shared,
+            name: 'getActivityTotal',
+            description: DESCRIPTIONS.getActivityTotal,
+            inputSchema: getActivityTotalInputSchema,
+            impl: getActivityTotal,
+        }),
+        compareTrend: makeTool({
+            ...shared,
+            name: 'compareTrend',
+            description: DESCRIPTIONS.compareTrend,
+            inputSchema: compareTrendInputSchema,
+            impl: compareTrend,
+        }),
+        detectAnomaly: makeTool({
+            ...shared,
+            name: 'detectAnomaly',
+            description: DESCRIPTIONS.detectAnomaly,
+            inputSchema: detectAnomalyInputSchema,
+            impl: detectAnomaly,
+        }),
+        getInsights: makeTool({
+            ...shared,
+            name: 'getInsights',
+            description: DESCRIPTIONS.getInsights,
+            inputSchema: getInsightsInputSchema,
+            impl: getInsights,
+        }),
+    };
+    return {
+        tools,
+        setContext(ctx) {
+            currentCtx = ctx;
+        },
+        auditWriter: audit,
+        async close() {
+            await audit.close();
+        },
+    };
+}
+//# sourceMappingURL=factory.js.map

package/dist/tools/factory.js.map

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

package/dist/tools/formatters.d.ts

@@ -0,0 +1,17 @@
+/**
+ * Shared string helpers for tool output formatting.
+ *
+ * No I/O; safe to import from any impl. Used to compute the `bytes`
+ * field of `ToolResult` and to render deltas consistently across
+ * tools.
+ */
+export declare function formatBytes(s: string): number;
+/**
+ * Format a signed percentage delta between two numbers. Returns `n/a`
+ * when the prior baseline is zero (avoids Infinity / NaN in tool
+ * output).
+ */
+export declare function deltaPct(current: number, prior: number): string;
+/** Population stddev; returns 0 when the sample is empty. */
+export declare function popStddev(values: number[]): number;
+//# sourceMappingURL=formatters.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"formatters.d.ts","sourceRoot":"","sources":["../../src/tools/formatters.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,wBAAgB,WAAW,CAAC,CAAC,EAAE,MAAM,GAAG,MAAM,CAE7C;AAED;;;;GAIG;AACH,wBAAgB,QAAQ,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,CAI/D;AAED,6DAA6D;AAC7D,wBAAgB,SAAS,CAAC,MAAM,EAAE,MAAM,EAAE,GAAG,MAAM,CAMlD"}

package/dist/tools/formatters.js

@@ -0,0 +1,30 @@
+/**
+ * Shared string helpers for tool output formatting.
+ *
+ * No I/O; safe to import from any impl. Used to compute the `bytes`
+ * field of `ToolResult` and to render deltas consistently across
+ * tools.
+ */
+export function formatBytes(s) {
+    return new TextEncoder().encode(s).byteLength;
+}
+/**
+ * Format a signed percentage delta between two numbers. Returns `n/a`
+ * when the prior baseline is zero (avoids Infinity / NaN in tool
+ * output).
+ */
+export function deltaPct(current, prior) {
+    if (prior === 0)
+        return 'n/a';
+    const pct = ((current - prior) / prior) * 100;
+    return `${pct >= 0 ? '+' : ''}${pct.toFixed(1)}%`;
+}
+/** Population stddev; returns 0 when the sample is empty. */
+export function popStddev(values) {
+    if (values.length === 0)
+        return 0;
+    const mean = values.reduce((a, v) => a + v, 0) / values.length;
+    const variance = values.reduce((a, v) => a + (v - mean) ** 2, 0) / values.length;
+    return Math.sqrt(variance);
+}
+//# sourceMappingURL=formatters.js.map

package/dist/tools/formatters.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"formatters.js","sourceRoot":"","sources":["../../src/tools/formatters.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,MAAM,UAAU,WAAW,CAAC,CAAS;IACnC,OAAO,IAAI,WAAW,EAAE,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,UAAU,CAAA;AAC/C,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,QAAQ,CAAC,OAAe,EAAE,KAAa;IACrD,IAAI,KAAK,KAAK,CAAC;QAAE,OAAO,KAAK,CAAA;IAC7B,MAAM,GAAG,GAAG,CAAC,CAAC,OAAO,GAAG,KAAK,CAAC,GAAG,KAAK,CAAC,GAAG,GAAG,CAAA;IAC7C,OAAO,GAAG,GAAG,IAAI,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,GAAG,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,GAAG,CAAA;AACnD,CAAC;AAED,6DAA6D;AAC7D,MAAM,UAAU,SAAS,CAAC,MAAgB;IACxC,IAAI,MAAM,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,CAAC,CAAA;IACjC,MAAM,IAAI,GAAG,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,GAAG,MAAM,CAAC,MAAM,CAAA;IAC9D,MAAM,QAAQ,GACV,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,GAAG,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC,GAAG,MAAM,CAAC,MAAM,CAAA;IACnE,OAAO,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAA;AAC5B,CAAC"}

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

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

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"}