@mongrov/analytics 0.1.0-alpha.8 → 0.1.0-beta.0

package/dist/tools/authorize.js

@@ -0,0 +1,87 @@
+/**
+ * Authorize hooks for analytics tools.
+ *
+ * `familyScopeAuthorize` — grants access iff `args.userId` is either
+ * the requester themselves or another member of the requester's
+ * family. When `config.familyMembersProvider` is supplied (the
+ * factory path since T-11), membership resolves via that provider;
+ * otherwise the legacy SQL path against a `family_member` table is
+ * used (kept for standalone hook usage and backwards compat).
+ *
+ * Both hooks fail closed on any error — provider throws, engine
+ * throws, missing/malformed args — return `false` rather than
+ * surfacing the error to the LLM.
+ */
+export function familyScopeAuthorize(analytics, config = {}) {
+    return async (_toolName, args, ctx) => {
+        const targetUserId = args.userId;
+        if (typeof targetUserId !== 'string' || targetUserId.length === 0) {
+            return false;
+        }
+        if (targetUserId === ctx.requesterUserId) {
+            return true;
+        }
+        if (config.familyMembersProvider) {
+            try {
+                const members = await config.familyMembersProvider({
+                    brand: ctx.brand,
+                    familyId: ctx.familyId,
+                });
+                return members.includes(targetUserId);
+            }
+            catch {
+                return false;
+            }
+        }
+        try {
+            const rows = await analytics.execute('SELECT 1 AS one FROM family_member '
+                + 'WHERE family_id = $familyId AND user_id = $userId LIMIT 1', { familyId: ctx.familyId, userId: targetUserId });
+            return rows.length > 0;
+        }
+        catch {
+            return false;
+        }
+    };
+}
+/**
+ * `orgScopeAuthorize` — parity with family scope but against an
+ * `org_member` table. Orgs are not first-class in v0.1.0; the ctx
+ * `familyId` is treated as the org id until org membership is wired
+ * through `RequestContext`.
+ *
+ * When `familyMembersProvider` is supplied, the same provider is
+ * consulted (v0.1.0 shim — a dedicated `orgMembersProvider` will
+ * split out once orgs land).
+ */
+export function orgScopeAuthorize(analytics, config = {}) {
+    return async (_toolName, args, ctx) => {
+        const targetUserId = args.userId;
+        if (typeof targetUserId !== 'string' || targetUserId.length === 0) {
+            return false;
+        }
+        if (targetUserId === ctx.requesterUserId) {
+            return true;
+        }
+        if (config.familyMembersProvider) {
+            try {
+                const members = await config.familyMembersProvider({
+                    brand: ctx.brand,
+                    familyId: ctx.familyId,
+                });
+                return members.includes(targetUserId);
+            }
+            catch {
+                return false;
+            }
+        }
+        try {
+            const rows = await analytics.execute('SELECT 1 AS one FROM org_member '
+                + 'WHERE org_id = $orgId AND user_id = $userId LIMIT 1', { orgId: ctx.familyId, userId: targetUserId });
+            return rows.length > 0;
+        }
+        catch {
+            return false;
+        }
+    };
+}
+//# sourceMappingURL=authorize.js.map

package/dist/tools/authorize.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"authorize.js","sourceRoot":"","sources":["../../src/tools/authorize.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAaH,MAAM,UAAU,oBAAoB,CAClC,SAA0B,EAC1B,SAA0B,EAAE;IAE5B,OAAO,KAAK,EAAE,SAAS,EAAE,IAAI,EAAE,GAAG,EAAE,EAAE;QACpC,MAAM,YAAY,GAAG,IAAI,CAAC,MAAM,CAAA;QAChC,IAAI,OAAO,YAAY,KAAK,QAAQ,IAAI,YAAY,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YAClE,OAAO,KAAK,CAAA;QACd,CAAC;QACD,IAAI,YAAY,KAAK,GAAG,CAAC,eAAe,EAAE,CAAC;YACzC,OAAO,IAAI,CAAA;QACb,CAAC;QAED,IAAI,MAAM,CAAC,qBAAqB,EAAE,CAAC;YACjC,IAAI,CAAC;gBACH,MAAM,OAAO,GAAG,MAAM,MAAM,CAAC,qBAAqB,CAAC;oBACjD,KAAK,EAAE,GAAG,CAAC,KAAK;oBAChB,QAAQ,EAAE,GAAG,CAAC,QAAQ;iBACvB,CAAC,CAAA;gBACF,OAAO,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAC,CAAA;YACvC,CAAC;YACD,MAAM,CAAC;gBACL,OAAO,KAAK,CAAA;YACd,CAAC;QACH,CAAC;QAED,IAAI,CAAC;YACH,MAAM,IAAI,GAAG,MAAM,SAAS,CAAC,OAAO,CAClC,qCAAqC;kBACnC,2DAA2D,EAC7D,EAAE,QAAQ,EAAE,GAAG,CAAC,QAAQ,EAAE,MAAM,EAAE,YAAY,EAAE,CACjD,CAAA;YACD,OAAO,IAAI,CAAC,MAAM,GAAG,CAAC,CAAA;QACxB,CAAC;QACD,MAAM,CAAC;YACL,OAAO,KAAK,CAAA;QACd,CAAC;IACH,CAAC,CAAA;AACH,CAAC;AAED;;;;;;;;;GASG;AACH,MAAM,UAAU,iBAAiB,CAC/B,SAA0B,EAC1B,SAA0B,EAAE;IAE5B,OAAO,KAAK,EAAE,SAAS,EAAE,IAAI,EAAE,GAAG,EAAE,EAAE;QACpC,MAAM,YAAY,GAAG,IAAI,CAAC,MAAM,CAAA;QAChC,IAAI,OAAO,YAAY,KAAK,QAAQ,IAAI,YAAY,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YAClE,OAAO,KAAK,CAAA;QACd,CAAC;QACD,IAAI,YAAY,KAAK,GAAG,CAAC,eAAe,EAAE,CAAC;YACzC,OAAO,IAAI,CAAA;QACb,CAAC;QAED,IAAI,MAAM,CAAC,qBAAqB,EAAE,CAAC;YACjC,IAAI,CAAC;gBACH,MAAM,OAAO,GAAG,MAAM,MAAM,CAAC,qBAAqB,CAAC;oBACjD,KAAK,EAAE,GAAG,CAAC,KAAK;oBAChB,QAAQ,EAAE,GAAG,CAAC,QAAQ;iBACvB,CAAC,CAAA;gBACF,OAAO,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAC,CAAA;YACvC,CAAC;YACD,MAAM,CAAC;gBACL,OAAO,KAAK,CAAA;YACd,CAAC;QACH,CAAC;QAED,IAAI,CAAC;YACH,MAAM,IAAI,GAAG,MAAM,SAAS,CAAC,OAAO,CAClC,kCAAkC;kBAChC,qDAAqD,EACvD,EAAE,KAAK,EAAE,GAAG,CAAC,QAAQ,EAAE,MAAM,EAAE,YAAY,EAAE,CAC9C,CAAA;YACD,OAAO,IAAI,CAAC,MAAM,GAAG,CAAC,CAAA;QACxB,CAAC;QACD,MAAM,CAAC;YACL,OAAO,KAAK,CAAA;QACd,CAAC;IACH,CAAC,CAAA;AACH,CAAC"}

package/dist/tools/budget.d.ts

@@ -0,0 +1,15 @@
+/**
+ * Output budget enforcement for tool results.
+ *
+ * `applyOutputBudget` truncates `ToolResult.text` when its UTF-8
+ * byte size exceeds `budget.maxBytes`, appending a `\n[truncated]`
+ * suffix. Truncation is UTF-8-safe: bytes are sliced and re-decoded
+ * with `fatal: false` so any partial multi-byte codepoint at the
+ * boundary is dropped rather than emitting invalid sequences.
+ *
+ * `budget.maxRows` is informational — tool impls limit row count
+ * via SQL LIMIT. This helper does not attempt row-level truncation.
+ */
+import type { OutputBudget, ToolResult } from './types';
+export declare function applyOutputBudget(result: ToolResult, budget: OutputBudget): ToolResult;
+//# sourceMappingURL=budget.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"budget.d.ts","sourceRoot":"","sources":["../../src/tools/budget.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,UAAU,EAAE,MAAM,SAAS,CAAA;AAIvD,wBAAgB,iBAAiB,CAC/B,MAAM,EAAE,UAAU,EAClB,MAAM,EAAE,YAAY,GACnB,UAAU,CAiBZ"}

package/dist/tools/budget.js

@@ -0,0 +1,64 @@
+/**
+ * Output budget enforcement for tool results.
+ *
+ * `applyOutputBudget` truncates `ToolResult.text` when its UTF-8
+ * byte size exceeds `budget.maxBytes`, appending a `\n[truncated]`
+ * suffix. Truncation is UTF-8-safe: bytes are sliced and re-decoded
+ * with `fatal: false` so any partial multi-byte codepoint at the
+ * boundary is dropped rather than emitting invalid sequences.
+ *
+ * `budget.maxRows` is informational — tool impls limit row count
+ * via SQL LIMIT. This helper does not attempt row-level truncation.
+ */
+const TRUNCATE_SUFFIX = '\n[truncated]';
+export function applyOutputBudget(result, budget) {
+    if (result.bytes <= budget.maxBytes)
+        return result;
+    const encoder = new TextEncoder();
+    const suffixBytes = encoder.encode(TRUNCATE_SUFFIX).byteLength;
+    const targetBytes = Math.max(0, budget.maxBytes - suffixBytes);
+    const encoded = encoder.encode(result.text);
+    const safeEnd = utf8SafeBoundary(encoded, Math.min(targetBytes, encoded.byteLength));
+    const decoded = new TextDecoder('utf-8').decode(encoded.slice(0, safeEnd));
+    const truncated = `${decoded}${TRUNCATE_SUFFIX}`;
+    return {
+        text: truncated,
+        rowCount: result.rowCount,
+        bytes: encoder.encode(truncated).byteLength,
+    };
+}
+/**
+ * Walk `end` backward until it points to a valid UTF-8 codepoint
+ * boundary — i.e. either past-the-end of the array or at a byte
+ * whose top bits are not `10` (continuation). This guarantees that
+ * `bytes.slice(0, boundary)` decodes without emitting replacement
+ * characters for a partial trailing multibyte sequence.
+ */
+function utf8SafeBoundary(bytes, end) {
+    let boundary = end;
+    // A continuation byte matches 10xxxxxx (0x80..0xBF).
+    while (boundary > 0 && (bytes[boundary] & 0xC0) === 0x80) {
+        boundary -= 1;
+    }
+    // If boundary now points to a lead byte (top bit set), check
+    // whether the full sequence fits inside `end`. If not, drop the
+    // lead byte as well.
+    if (boundary > 0 && boundary < bytes.byteLength) {
+        const lead = bytes[boundary];
+        let seqLen = 0;
+        if ((lead & 0x80) === 0x00)
+            seqLen = 1;
+        else if ((lead & 0xE0) === 0xC0)
+            seqLen = 2;
+        else if ((lead & 0xF0) === 0xE0)
+            seqLen = 3;
+        else if ((lead & 0xF8) === 0xF0)
+            seqLen = 4;
+        if (seqLen > 1 && boundary + seqLen > end) {
+            // Partial sequence — drop lead byte.
+            return boundary;
+        }
+    }
+    return boundary;
+}
+//# sourceMappingURL=budget.js.map

package/dist/tools/budget.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"budget.js","sourceRoot":"","sources":["../../src/tools/budget.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAIH,MAAM,eAAe,GAAG,eAAe,CAAA;AAEvC,MAAM,UAAU,iBAAiB,CAC/B,MAAkB,EAClB,MAAoB;IAEpB,IAAI,MAAM,CAAC,KAAK,IAAI,MAAM,CAAC,QAAQ;QAAE,OAAO,MAAM,CAAA;IAElD,MAAM,OAAO,GAAG,IAAI,WAAW,EAAE,CAAA;IACjC,MAAM,WAAW,GAAG,OAAO,CAAC,MAAM,CAAC,eAAe,CAAC,CAAC,UAAU,CAAA;IAC9D,MAAM,WAAW,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,MAAM,CAAC,QAAQ,GAAG,WAAW,CAAC,CAAA;IAE9D,MAAM,OAAO,GAAG,OAAO,CAAC,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,CAAA;IAC3C,MAAM,OAAO,GAAG,gBAAgB,CAAC,OAAO,EAAE,IAAI,CAAC,GAAG,CAAC,WAAW,EAAE,OAAO,CAAC,UAAU,CAAC,CAAC,CAAA;IACpF,MAAM,OAAO,GAAG,IAAI,WAAW,CAAC,OAAO,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,EAAE,OAAO,CAAC,CAAC,CAAA;IAC1E,MAAM,SAAS,GAAG,GAAG,OAAO,GAAG,eAAe,EAAE,CAAA;IAEhD,OAAO;QACL,IAAI,EAAE,SAAS;QACf,QAAQ,EAAE,MAAM,CAAC,QAAQ;QACzB,KAAK,EAAE,OAAO,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC,UAAU;KAC5C,CAAA;AACH,CAAC;AAED;;;;;;GAMG;AACH,SAAS,gBAAgB,CAAC,KAAiB,EAAE,GAAW;IACtD,IAAI,QAAQ,GAAG,GAAG,CAAA;IAClB,qDAAqD;IACrD,OAAO,QAAQ,GAAG,CAAC,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC,GAAG,IAAI,CAAC,KAAK,IAAI,EAAE,CAAC;QACzD,QAAQ,IAAI,CAAC,CAAA;IACf,CAAC;IACD,6DAA6D;IAC7D,gEAAgE;IAChE,qBAAqB;IACrB,IAAI,QAAQ,GAAG,CAAC,IAAI,QAAQ,GAAG,KAAK,CAAC,UAAU,EAAE,CAAC;QAChD,MAAM,IAAI,GAAG,KAAK,CAAC,QAAQ,CAAC,CAAA;QAC5B,IAAI,MAAM,GAAG,CAAC,CAAA;QACd,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC,KAAK,IAAI;YAAE,MAAM,GAAG,CAAC,CAAA;aACjC,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC,KAAK,IAAI;YAAE,MAAM,GAAG,CAAC,CAAA;aACtC,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC,KAAK,IAAI;YAAE,MAAM,GAAG,CAAC,CAAA;aACtC,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC,KAAK,IAAI;YAAE,MAAM,GAAG,CAAC,CAAA;QAC3C,IAAI,MAAM,GAAG,CAAC,IAAI,QAAQ,GAAG,MAAM,GAAG,GAAG,EAAE,CAAC;YAC1C,qCAAqC;YACrC,OAAO,QAAQ,CAAA;QACjB,CAAC;IACH,CAAC;IACD,OAAO,QAAQ,CAAA;AACjB,CAAC"}

package/dist/tools/factory.d.ts

@@ -0,0 +1,43 @@
+/**
+ * `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 type { AnalyticsToolsConfig, AuditWriter, ToolContext } from './types';
+import { makeTool } from './wrap';
+import { type GetActivityTotalInput } from './impls/activity';
+import { type DetectAnomalyInput } from './impls/anomaly';
+import { type CompareTrendInput } from './impls/compare';
+import { type GetHRVInput } from './impls/hrv';
+import { type GetInsightsInput } from './impls/insights';
+import { type GetSleepSummaryInput } from './impls/sleep';
+export interface AnalyticsToolMap {
+    getHRV: ReturnType<typeof makeTool<GetHRVInput>>;
+    getSleepSummary: ReturnType<typeof makeTool<GetSleepSummaryInput>>;
+    getActivityTotal: ReturnType<typeof makeTool<GetActivityTotalInput>>;
+    compareTrend: ReturnType<typeof makeTool<CompareTrendInput>>;
+    detectAnomaly: ReturnType<typeof makeTool<DetectAnomalyInput>>;
+    getInsights: ReturnType<typeof makeTool<GetInsightsInput>>;
+}
+export interface AnalyticsToolsHandle {
+    tools: AnalyticsToolMap;
+    setContext: (ctx: ToolContext | null) => void;
+    auditWriter: AuditWriter;
+    close: () => Promise<void>;
+}
+export declare function createAnalyticsTools(config: AnalyticsToolsConfig): AnalyticsToolsHandle;
+//# sourceMappingURL=factory.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"factory.d.ts","sourceRoot":"","sources":["../../src/tools/factory.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AASH,OAAO,KAAK,EACV,oBAAoB,EACpB,WAAW,EAEX,WAAW,EACZ,MAAM,SAAS,CAAA;AAChB,OAAO,EAAE,QAAQ,EAAE,MAAM,QAAQ,CAAA;AAEjC,OAAO,EAGL,KAAK,qBAAqB,EAC3B,MAAM,kBAAkB,CAAA;AACzB,OAAO,EAGL,KAAK,kBAAkB,EACxB,MAAM,iBAAiB,CAAA;AACxB,OAAO,EAGL,KAAK,iBAAiB,EACvB,MAAM,iBAAiB,CAAA;AACxB,OAAO,EAA6B,KAAK,WAAW,EAAE,MAAM,aAAa,CAAA;AACzE,OAAO,EAGL,KAAK,gBAAgB,EACtB,MAAM,kBAAkB,CAAA;AACzB,OAAO,EAGL,KAAK,oBAAoB,EAC1B,MAAM,eAAe,CAAA;AAoBtB,MAAM,WAAW,gBAAgB;IAC/B,MAAM,EAAE,UAAU,CAAC,OAAO,QAAQ,CAAC,WAAW,CAAC,CAAC,CAAA;IAChD,eAAe,EAAE,UAAU,CAAC,OAAO,QAAQ,CAAC,oBAAoB,CAAC,CAAC,CAAA;IAClE,gBAAgB,EAAE,UAAU,CAAC,OAAO,QAAQ,CAAC,qBAAqB,CAAC,CAAC,CAAA;IACpE,YAAY,EAAE,UAAU,CAAC,OAAO,QAAQ,CAAC,iBAAiB,CAAC,CAAC,CAAA;IAC5D,aAAa,EAAE,UAAU,CAAC,OAAO,QAAQ,CAAC,kBAAkB,CAAC,CAAC,CAAA;IAC9D,WAAW,EAAE,UAAU,CAAC,OAAO,QAAQ,CAAC,gBAAgB,CAAC,CAAC,CAAA;CAC3D;AAED,MAAM,WAAW,oBAAoB;IACnC,KAAK,EAAE,gBAAgB,CAAA;IACvB,UAAU,EAAE,CAAC,GAAG,EAAE,WAAW,GAAG,IAAI,KAAK,IAAI,CAAA;IAC7C,WAAW,EAAE,WAAW,CAAA;IACxB,KAAK,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAA;CAC3B;AAED,wBAAgB,oBAAoB,CAClC,MAAM,EAAE,oBAAoB,GAC3B,oBAAoB,CAiGtB"}

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":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAEH,OAAO,EAAE,iBAAiB,EAAE,MAAM,SAAS,CAAA;AAC3C,OAAO,EAAE,oBAAoB,EAAE,MAAM,aAAa,CAAA;AAClD,OAAO,EAAE,iBAAiB,EAAoB,MAAM,cAAc,CAAA;AAClE,OAAO,EACL,qBAAqB,EACrB,kBAAkB,GACnB,MAAM,SAAS,CAAA;AAOhB,OAAO,EAAE,QAAQ,EAAE,MAAM,QAAQ,CAAA;AAEjC,OAAO,EACL,gBAAgB,EAChB,2BAA2B,GAE5B,MAAM,kBAAkB,CAAA;AACzB,OAAO,EACL,aAAa,EACb,wBAAwB,GAEzB,MAAM,iBAAiB,CAAA;AACxB,OAAO,EACL,YAAY,EACZ,uBAAuB,GAExB,MAAM,iBAAiB,CAAA;AACxB,OAAO,EAAE,MAAM,EAAE,iBAAiB,EAAoB,MAAM,aAAa,CAAA;AACzE,OAAO,EACL,WAAW,EACX,sBAAsB,GAEvB,MAAM,kBAAkB,CAAA;AACzB,OAAO,EACL,eAAe,EACf,0BAA0B,GAE3B,MAAM,eAAe,CAAA;AAEtB,MAAM,YAAY,GAAG;IACnB,MAAM,EAAE,oEAAoE;UACxE,mDAAmD;IACvD,eAAe,EAAE,0DAA0D;UACvE,mDAAmD;IACvD,gBAAgB,EAAE,2DAA2D;UACzE,mDAAmD;IACvD,YAAY,EAAE,6DAA6D;UACvE,8DAA8D;UAC9D,kDAAkD;IACtD,aAAa,EAAE,+DAA+D;UAC1E,uEAAuE;UACvE,qEAAqE;UACrE,oCAAoC;IACxC,WAAW,EAAE,gEAAgE;UACzE,kEAAkE;CAC9D,CAAA;AAkBV,MAAM,UAAU,oBAAoB,CAClC,MAA4B;IAE5B,MAAM,MAAM,GAAiB;QAC3B,GAAG,qBAAqB;QACxB,GAAG,CAAC,MAAM,CAAC,YAAY,IAAI,EAAE,CAAC;KAC/B,CAAA;IAED,MAAM,WAAW,GACb,MAAM,CAAC,SAAS,KAAK,KAAK;QAC1B,CAAC,CAAC,IAAI;QACN,CAAC,CAAC,iBAAiB,CAAC;YAChB,MAAM,EAAE,MAAM,CAAC,SAAS,IAAI,kBAAkB;YAC9C,KAAK,EAAE,MAAM,CAAC,KAAK;SACpB,CAAC,CAAA;IAER,MAAM,SAAS,GACX,MAAM,CAAC,SAAS;WACf,oBAAoB,CAAC,MAAM,CAAC,SAAS,EAAE;YACxC,qBAAqB,EAAE,MAAM,CAAC,qBAAqB;SACpD,CAAC,CAAA;IAEJ,MAAM,KAAK,GAAG,iBAAiB,CAAC;QAC9B,SAAS,EAAE,MAAM,CAAC,SAAS;QAC3B,OAAO,EAAE,MAAM,CAAC,KAAK,EAAE,OAAO,IAAI,IAAI;QACtC,SAAS,EAAE,MAAM,CAAC,KAAK,EAAE,SAAS;QAClC,eAAe,EAAE,MAAM,CAAC,KAAK,EAAE,eAAe;QAC9C,MAAM,EAAE,MAAM,CAAC,MAAM;KACtB,CAAC,CAAA;IAEF,IAAI,UAAU,GAAuB,IAAI,CAAA;IACzC,MAAM,WAAW,GAAG,GAAuB,EAAE,CAAC,UAAU,CAAA;IAExD,MAAM,MAAM,GAAG;QACb,SAAS,EAAE,MAAM,CAAC,SAAS;QAC3B,SAAS;QACT,WAAW;QACX,KAAK;QACL,MAAM;QACN,MAAM,EAAE,MAAM,CAAC,MAAM;QACrB,WAAW;QACX,KAAK,EAAE,MAAM,CAAC,KAAK;KACpB,CAAA;IAED,MAAM,KAAK,GAAqB;QAC9B,MAAM,EAAE,QAAQ,CAAC;YACf,GAAG,MAAM;YACT,IAAI,EAAE,QAAQ;YACd,WAAW,EAAE,YAAY,CAAC,MAAM;YAChC,WAAW,EAAE,iBAAiB;YAC9B,IAAI,EAAE,MAAM;SACb,CAAC;QACF,eAAe,EAAE,QAAQ,CAAC;YACxB,GAAG,MAAM;YACT,IAAI,EAAE,iBAAiB;YACvB,WAAW,EAAE,YAAY,CAAC,eAAe;YACzC,WAAW,EAAE,0BAA0B;YACvC,IAAI,EAAE,eAAe;SACtB,CAAC;QACF,gBAAgB,EAAE,QAAQ,CAAC;YACzB,GAAG,MAAM;YACT,IAAI,EAAE,kBAAkB;YACxB,WAAW,EAAE,YAAY,CAAC,gBAAgB;YAC1C,WAAW,EAAE,2BAA2B;YACxC,IAAI,EAAE,gBAAgB;SACvB,CAAC;QACF,YAAY,EAAE,QAAQ,CAAC;YACrB,GAAG,MAAM;YACT,IAAI,EAAE,cAAc;YACpB,WAAW,EAAE,YAAY,CAAC,YAAY;YACtC,WAAW,EAAE,uBAAuB;YACpC,IAAI,EAAE,YAAY;SACnB,CAAC;QACF,aAAa,EAAE,QAAQ,CAAC;YACtB,GAAG,MAAM;YACT,IAAI,EAAE,eAAe;YACrB,WAAW,EAAE,YAAY,CAAC,aAAa;YACvC,WAAW,EAAE,wBAAwB;YACrC,IAAI,EAAE,aAAa;SACpB,CAAC;QACF,WAAW,EAAE,QAAQ,CAAC;YACpB,GAAG,MAAM;YACT,IAAI,EAAE,aAAa;YACnB,WAAW,EAAE,YAAY,CAAC,WAAW;YACrC,WAAW,EAAE,sBAAsB;YACnC,IAAI,EAAE,WAAW;SAClB,CAAC;KACH,CAAA;IAED,OAAO;QACL,KAAK;QACL,UAAU,CAAC,GAAG;YACZ,UAAU,GAAG,GAAG,CAAA;QAClB,CAAC;QACD,WAAW,EAAE,KAAK;QAClB,KAAK,CAAC,KAAK;YACT,MAAM,KAAK,CAAC,KAAK,EAAE,CAAA;QACrB,CAAC;KACF,CAAA;AACH,CAAC"}

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