@zykeco/sync-server 0.5.0 → 0.7.0

package/dist/mcp/oauth.js

@@ -0,0 +1,149 @@
+import { createHash, createHmac, randomBytes, timingSafeEqual } from 'node:crypto';
+const PAYLOAD_RANDOM_BYTES = 16;
+const PAYLOAD_EXPIRY_BYTES = 8;
+const PAYLOAD_BYTES = PAYLOAD_RANDOM_BYTES + PAYLOAD_EXPIRY_BYTES;
+const SIG_HEX_LEN = 64; // sha256 hex = 64 chars
+function sign(payload, secret) {
+    return createHmac('sha256', secret).update(payload).digest('hex');
+}
+function b64urlEncode(buf) {
+    return buf.toString('base64').replace(/\+/g, '-').replace(/\//g, '_').replace(/=+$/, '');
+}
+function b64urlDecode(s) {
+    try {
+        const pad = s.length % 4 === 0 ? '' : '='.repeat(4 - (s.length % 4));
+        return Buffer.from(s.replace(/-/g, '+').replace(/_/g, '/') + pad, 'base64');
+    }
+    catch {
+        return null;
+    }
+}
+/**
+ * Issue an opaque, HMAC-signed bearer token.
+ *
+ * Token layout: `${b64url(payload)}.${hex(hmac_sha256(payload, secret))}`
+ * where `payload = random(16) || expiryUnixSeconds(uint64BE)`.
+ *
+ * Stateless — verification needs only the signing secret.
+ */
+export function issueToken(env, nowMs = Date.now()) {
+    const expiresAt = Math.floor(nowMs / 1000) + env.tokenTtlSeconds;
+    const payload = Buffer.alloc(PAYLOAD_BYTES);
+    randomBytes(PAYLOAD_RANDOM_BYTES).copy(payload, 0);
+    payload.writeBigUInt64BE(BigInt(expiresAt), PAYLOAD_RANDOM_BYTES);
+    const sig = sign(payload, env.tokenSecret);
+    return {
+        accessToken: `${b64urlEncode(payload)}.${sig}`,
+        expiresIn: env.tokenTtlSeconds,
+    };
+}
+export function verifyToken(token, env, nowMs = Date.now()) {
+    const dot = token.indexOf('.');
+    if (dot <= 0)
+        return { ok: false, reason: 'malformed' };
+    const payloadB64 = token.slice(0, dot);
+    const sigHex = token.slice(dot + 1);
+    if (sigHex.length !== SIG_HEX_LEN)
+        return { ok: false, reason: 'malformed' };
+    const payload = b64urlDecode(payloadB64);
+    if (!payload || payload.length !== PAYLOAD_BYTES)
+        return { ok: false, reason: 'malformed' };
+    const expectedSigHex = sign(payload, env.tokenSecret);
+    const a = Buffer.from(sigHex, 'hex');
+    const b = Buffer.from(expectedSigHex, 'hex');
+    if (a.length !== b.length || !timingSafeEqual(a, b)) {
+        return { ok: false, reason: 'bad_signature' };
+    }
+    const expiresAt = Number(payload.readBigUInt64BE(PAYLOAD_RANDOM_BYTES));
+    if (Math.floor(nowMs / 1000) >= expiresAt) {
+        return { ok: false, reason: 'expired' };
+    }
+    return { ok: true, expiresAt };
+}
+/**
+ * Validate a client_credentials grant request against the configured MCP env
+ * + the read secret. Returns the access token on success.
+ */
+export function grantClientCredentials(req, env, readSecret, nowMs = Date.now()) {
+    if (req.grantType !== 'client_credentials') {
+        return {
+            ok: false,
+            status: 400,
+            error: 'unsupported_grant_type',
+            description: 'only client_credentials is supported',
+        };
+    }
+    if (!req.clientId || !req.clientSecret) {
+        return { ok: false, status: 400, error: 'invalid_request', description: 'missing credentials' };
+    }
+    const cidA = Buffer.from(req.clientId);
+    const cidB = Buffer.from(env.clientId);
+    const secA = Buffer.from(req.clientSecret);
+    const secB = Buffer.from(readSecret);
+    const cidOk = cidA.length === cidB.length && timingSafeEqual(cidA, cidB);
+    const secOk = secA.length === secB.length && timingSafeEqual(secA, secB);
+    if (!cidOk || !secOk) {
+        return { ok: false, status: 401, error: 'invalid_client' };
+    }
+    return { ok: true, token: issueToken(env, nowMs) };
+}
+/**
+ * Compute the PKCE S256 code challenge for a verifier.
+ *
+ * RFC 7636 §4.2: `BASE64URL(SHA256(ASCII(verifier)))`.
+ */
+export function pkceS256Challenge(verifier) {
+    return b64urlEncode(createHash('sha256').update(verifier).digest());
+}
+function timingSafeEqualStr(a, b) {
+    if (a.length !== b.length)
+        return false;
+    return timingSafeEqual(Buffer.from(a), Buffer.from(b));
+}
+/**
+ * Validate an authorization_code grant + PKCE verifier and exchange it for a
+ * bearer token. The code is single-use — `consumeCode` deletes it regardless
+ * of validation outcome past the lookup.
+ */
+export function grantAuthorizationCode(req, env, store, nowMs = Date.now()) {
+    if (req.grantType !== 'authorization_code') {
+        return {
+            ok: false,
+            status: 400,
+            error: 'unsupported_grant_type',
+        };
+    }
+    if (!req.code || !req.clientId || !req.codeVerifier || !req.redirectUri) {
+        return { ok: false, status: 400, error: 'invalid_request', description: 'missing parameter' };
+    }
+    // RFC 7636: verifier is 43-128 chars of [A-Z a-z 0-9 - . _ ~]
+    if (!/^[A-Za-z0-9._~-]{43,128}$/.test(req.codeVerifier)) {
+        return {
+            ok: false,
+            status: 400,
+            error: 'invalid_grant',
+            description: 'malformed code_verifier',
+        };
+    }
+    const rec = store.consumeCode(req.code, nowMs);
+    if (!rec) {
+        return {
+            ok: false,
+            status: 400,
+            error: 'invalid_grant',
+            description: 'code unknown or expired',
+        };
+    }
+    if (rec.clientId !== req.clientId) {
+        return { ok: false, status: 400, error: 'invalid_grant', description: 'client_id mismatch' };
+    }
+    if (rec.redirectUri !== req.redirectUri) {
+        return { ok: false, status: 400, error: 'invalid_grant', description: 'redirect_uri mismatch' };
+    }
+    const expected = pkceS256Challenge(req.codeVerifier);
+    if (!timingSafeEqualStr(expected, rec.codeChallenge)) {
+        return { ok: false, status: 400, error: 'invalid_grant', description: 'pkce mismatch' };
+    }
+    return { ok: true, token: issueToken(env, nowMs) };
+}
+//# sourceMappingURL=oauth.js.map

package/dist/mcp/oauth.js.map

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

package/dist/mcp/server.d.ts

@@ -0,0 +1,35 @@
+import type { TSchema } from '@sinclair/typebox';
+export interface ToolDefinition {
+    name: string;
+    description: string;
+    inputSchema: TSchema;
+    handler: (args: any) => Promise<unknown> | unknown;
+}
+export interface JsonRpcRequest {
+    jsonrpc: '2.0';
+    id?: string | number | null;
+    method: string;
+    params?: unknown;
+}
+export interface JsonRpcSuccess {
+    jsonrpc: '2.0';
+    id: string | number | null;
+    result: unknown;
+}
+export interface JsonRpcError {
+    jsonrpc: '2.0';
+    id: string | number | null;
+    error: {
+        code: number;
+        message: string;
+        data?: unknown;
+    };
+}
+export type JsonRpcResponse = JsonRpcSuccess | JsonRpcError;
+export declare const MCP_PROTOCOL_VERSION = "2025-06-18";
+export declare const MCP_SERVER_NAME = "zyke-sync";
+export interface McpServer {
+    handle(req: unknown): Promise<JsonRpcResponse>;
+    listToolNames(): string[];
+}
+export declare function createMcpServer(tools: ToolDefinition[]): McpServer;

package/dist/mcp/server.js

@@ -0,0 +1,94 @@
+import { Value } from '@sinclair/typebox/value';
+export const MCP_PROTOCOL_VERSION = '2025-06-18';
+export const MCP_SERVER_NAME = 'zyke-sync';
+const ERR_PARSE = -32700;
+const ERR_INVALID_REQUEST = -32600;
+const ERR_METHOD_NOT_FOUND = -32601;
+const ERR_INVALID_PARAMS = -32602;
+const ERR_INTERNAL = -32603;
+function errorResponse(id, code, message, data) {
+    const err = { code, message };
+    if (data !== undefined)
+        err.data = data;
+    return { jsonrpc: '2.0', id, error: err };
+}
+function successResponse(id, result) {
+    return { jsonrpc: '2.0', id, result };
+}
+export function createMcpServer(tools) {
+    const toolMap = new Map(tools.map((t) => [t.name, t]));
+    async function dispatch(req) {
+        const id = req.id ?? null;
+        switch (req.method) {
+            case 'initialize':
+                return successResponse(id, {
+                    protocolVersion: MCP_PROTOCOL_VERSION,
+                    capabilities: { tools: { listChanged: false } },
+                    serverInfo: { name: MCP_SERVER_NAME, version: '1.0.0' },
+                });
+            case 'notifications/initialized':
+            case 'ping':
+                return successResponse(id, {});
+            case 'tools/list':
+                return successResponse(id, {
+                    tools: tools.map((t) => ({
+                        name: t.name,
+                        description: t.description,
+                        inputSchema: t.inputSchema,
+                    })),
+                });
+            case 'tools/call': {
+                const params = req.params;
+                if (!params || typeof params.name !== 'string') {
+                    return errorResponse(id, ERR_INVALID_PARAMS, 'missing tool name');
+                }
+                const tool = toolMap.get(params.name);
+                if (!tool)
+                    return errorResponse(id, ERR_METHOD_NOT_FOUND, `unknown tool: ${params.name}`);
+                const args = params.arguments ?? {};
+                if (!Value.Check(tool.inputSchema, args)) {
+                    const first = [...Value.Errors(tool.inputSchema, args)][0];
+                    const detail = first ? `${first.path} ${first.message}`.trim() : 'invalid arguments';
+                    return errorResponse(id, ERR_INVALID_PARAMS, detail);
+                }
+                try {
+                    const result = await tool.handler(args);
+                    return successResponse(id, {
+                        content: [{ type: 'text', text: JSON.stringify(result) }],
+                        structuredContent: result,
+                        isError: false,
+                    });
+                }
+                catch (err) {
+                    const message = err instanceof Error ? err.message : String(err);
+                    return successResponse(id, {
+                        content: [{ type: 'text', text: `tool error: ${message}` }],
+                        isError: true,
+                    });
+                }
+            }
+            default:
+                return errorResponse(id, ERR_METHOD_NOT_FOUND, `unknown method: ${req.method}`);
+        }
+    }
+    return {
+        listToolNames: () => tools.map((t) => t.name),
+        async handle(raw) {
+            if (!raw || typeof raw !== 'object') {
+                return errorResponse(null, ERR_PARSE, 'request must be a JSON object');
+            }
+            const req = raw;
+            if (req.jsonrpc !== '2.0' || typeof req.method !== 'string') {
+                return errorResponse(req.id ?? null, ERR_INVALID_REQUEST, 'malformed JSON-RPC request');
+            }
+            try {
+                return await dispatch(req);
+            }
+            catch (err) {
+                const message = err instanceof Error ? err.message : String(err);
+                return errorResponse(req.id ?? null, ERR_INTERNAL, message);
+            }
+        },
+    };
+}
+//# sourceMappingURL=server.js.map

package/dist/mcp/server.js.map

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

package/dist/mcp/timezones.d.ts

@@ -0,0 +1,17 @@
+import type { Db } from '../db/client.js';
+export interface TimezoneRow {
+    timezone: string;
+    utcOffsetMinutes: number;
+    effectiveFrom: number;
+}
+export interface TimezoneResolver {
+    /** Returns the timezone active at the given UTC ms, or null if none. */
+    resolveAt(utcMs: number): TimezoneRow | null;
+    /** Force-reload from DB. Called between requests if needed. */
+    reload(): Promise<void>;
+}
+/**
+ * Cache the (small) user_timezones table in memory, sorted by effectiveFrom
+ * descending. Lookups are O(log n) via binary search on the sorted list.
+ */
+export declare function createTimezoneResolver(db: Db): TimezoneResolver;

package/dist/mcp/timezones.js

@@ -0,0 +1,32 @@
+import { desc } from 'drizzle-orm';
+import { userTimezones } from '../db/schema.js';
+/**
+ * Cache the (small) user_timezones table in memory, sorted by effectiveFrom
+ * descending. Lookups are O(log n) via binary search on the sorted list.
+ */
+export function createTimezoneResolver(db) {
+    let cache = [];
+    async function reload() {
+        const rows = await db
+            .select({
+            timezone: userTimezones.timezone,
+            utcOffsetMinutes: userTimezones.utcOffsetMinutes,
+            effectiveFrom: userTimezones.effectiveFrom,
+        })
+            .from(userTimezones)
+            .orderBy(desc(userTimezones.effectiveFrom));
+        cache = rows;
+    }
+    function resolveAt(utcMs) {
+        if (!Number.isFinite(utcMs))
+            return null;
+        // cache is sorted descending by effectiveFrom; first row whose effectiveFrom <= utcMs wins.
+        for (const row of cache) {
+            if (row.effectiveFrom <= utcMs)
+                return row;
+        }
+        return null;
+    }
+    return { resolveAt, reload };
+}
+//# sourceMappingURL=timezones.js.map

package/dist/mcp/timezones.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"timezones.js","sourceRoot":"","sources":["../../src/mcp/timezones.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,MAAM,aAAa,CAAC;AAGnC,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAehD;;;GAGG;AACH,MAAM,UAAU,sBAAsB,CAAC,EAAM;IAC3C,IAAI,KAAK,GAAkB,EAAE,CAAC;IAE9B,KAAK,UAAU,MAAM;QACnB,MAAM,IAAI,GAAG,MAAM,EAAE;aAClB,MAAM,CAAC;YACN,QAAQ,EAAE,aAAa,CAAC,QAAQ;YAChC,gBAAgB,EAAE,aAAa,CAAC,gBAAgB;YAChD,aAAa,EAAE,aAAa,CAAC,aAAa;SAC3C,CAAC;aACD,IAAI,CAAC,aAAa,CAAC;aACnB,OAAO,CAAC,IAAI,CAAC,aAAa,CAAC,aAAa,CAAC,CAAC,CAAC;QAC9C,KAAK,GAAG,IAAI,CAAC;IACf,CAAC;IAED,SAAS,SAAS,CAAC,KAAa;QAC9B,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC;YAAE,OAAO,IAAI,CAAC;QACzC,4FAA4F;QAC5F,KAAK,MAAM,GAAG,IAAI,KAAK,EAAE,CAAC;YACxB,IAAI,GAAG,CAAC,aAAa,IAAI,KAAK;gBAAE,OAAO,GAAG,CAAC;QAC7C,CAAC;QACD,OAAO,IAAI,CAAC;IACd,CAAC;IAED,OAAO,EAAE,SAAS,EAAE,MAAM,EAAE,CAAC;AAC/B,CAAC"}

package/dist/mcp/tools.d.ts

@@ -0,0 +1,4 @@
+import type { Db } from '../db/client.js';
+import type { ToolDefinition } from './server.js';
+import type { TimezoneResolver } from './timezones.js';
+export declare function buildTools(db: Db, tz: TimezoneResolver): ToolDefinition[];

package/dist/mcp/tools.js

@@ -0,0 +1,236 @@
+import { Type } from '@sinclair/typebox';
+import { and, asc, desc, eq, gt, gte, lte } from 'drizzle-orm';
+import { dailyMetrics, dailyStressBurden, heartRateMinute, hrZoneHistory, sleepSessions, userProfile, userTimezones, weeklyMetrics, } from '../db/schema.js';
+import { inferValueType } from './metric-types.js';
+import { formatHmsFromSeconds, formatTzIso } from './transforms.js';
+const Limit = Type.Optional(Type.Integer({ minimum: 1, maximum: 500, default: 100 }));
+const IsoDate = Type.String({ pattern: '^\\d{4}-\\d{2}-\\d{2}$' });
+const UnixMs = Type.Integer({ minimum: 0 });
+function tzIso(resolver, utcMs) {
+    const row = resolver.resolveAt(utcMs);
+    if (!row)
+        return null;
+    return formatTzIso(utcMs, row.utcOffsetMinutes);
+}
+function applyLimit(n) {
+    if (n === undefined)
+        return 100;
+    return Math.min(Math.max(1, n), 500);
+}
+function and$(...parts) {
+    const filtered = parts.filter((p) => p !== undefined);
+    if (filtered.length === 0)
+        return undefined;
+    if (filtered.length === 1)
+        return filtered[0];
+    return and(...filtered);
+}
+export function buildTools(db, tz) {
+    return [
+        {
+            name: 'list_user_timezones',
+            description: 'List user timezone history entries (initial / travel / DST). Each row records the timezone that became active at `effectiveFrom` (UTC ms).',
+            inputSchema: Type.Object({
+                since: Type.Optional(UnixMs),
+                until: Type.Optional(UnixMs),
+                limit: Limit,
+            }, { additionalProperties: false }),
+            async handler(args) {
+                await tz.reload();
+                const where = and$(args.since !== undefined ? gte(userTimezones.effectiveFrom, args.since) : undefined, args.until !== undefined ? lte(userTimezones.effectiveFrom, args.until) : undefined);
+                const q = db.select().from(userTimezones).limit(applyLimit(args.limit));
+                const rows = where
+                    ? await q.where(where).orderBy(desc(userTimezones.effectiveFrom))
+                    : await q.orderBy(desc(userTimezones.effectiveFrom));
+                return { rows };
+            },
+        },
+        {
+            name: 'get_user_profile',
+            description: 'Return the singleton user profile row, or null if none has been synced.',
+            inputSchema: Type.Object({}, { additionalProperties: false }),
+            async handler() {
+                const rows = await db.select().from(userProfile).where(eq(userProfile.id, 1)).limit(1);
+                return { profile: rows[0] ?? null };
+            },
+        },
+        {
+            name: 'list_daily_metrics',
+            description: 'List daily metrics with a `valueType` annotation inferred from the metric key (e.g. sleep_optimum_s → seconds).',
+            inputSchema: Type.Object({
+                isoDateFrom: Type.Optional(IsoDate),
+                isoDateTo: Type.Optional(IsoDate),
+                metricKey: Type.Optional(Type.String({ minLength: 1, maxLength: 64 })),
+                limit: Limit,
+            }, { additionalProperties: false }),
+            async handler(args) {
+                const where = and$(args.isoDateFrom ? gte(dailyMetrics.isoDate, args.isoDateFrom) : undefined, args.isoDateTo ? lte(dailyMetrics.isoDate, args.isoDateTo) : undefined, args.metricKey ? eq(dailyMetrics.metricKey, args.metricKey) : undefined);
+                const q = db
+                    .select()
+                    .from(dailyMetrics)
+                    .orderBy(desc(dailyMetrics.isoDate), asc(dailyMetrics.metricKey))
+                    .limit(applyLimit(args.limit));
+                const rows = where ? await q.where(where) : await q;
+                return {
+                    rows: rows.map((r) => ({ ...r, valueType: inferValueType(r.metricKey) })),
+                };
+            },
+        },
+        {
+            name: 'list_weekly_metrics',
+            description: 'List weekly metrics with `valueType` annotations.',
+            inputSchema: Type.Object({
+                weekStartFrom: Type.Optional(IsoDate),
+                weekStartTo: Type.Optional(IsoDate),
+                metricKey: Type.Optional(Type.String({ minLength: 1, maxLength: 64 })),
+                limit: Limit,
+            }, { additionalProperties: false }),
+            async handler(args) {
+                const where = and$(args.weekStartFrom ? gte(weeklyMetrics.weekStartIsoDate, args.weekStartFrom) : undefined, args.weekStartTo ? lte(weeklyMetrics.weekStartIsoDate, args.weekStartTo) : undefined, args.metricKey ? eq(weeklyMetrics.metricKey, args.metricKey) : undefined);
+                const q = db
+                    .select()
+                    .from(weeklyMetrics)
+                    .orderBy(desc(weeklyMetrics.weekStartIsoDate), asc(weeklyMetrics.metricKey))
+                    .limit(applyLimit(args.limit));
+                const rows = where ? await q.where(where) : await q;
+                return {
+                    rows: rows.map((r) => ({ ...r, valueType: inferValueType(r.metricKey) })),
+                };
+            },
+        },
+        {
+            name: 'list_daily_stress_burden',
+            description: 'List daily stress burden summaries. `peakScoreTz` is the offset-aware ISO string of `peakScoreUtc`.',
+            inputSchema: Type.Object({
+                isoDateFrom: Type.Optional(IsoDate),
+                isoDateTo: Type.Optional(IsoDate),
+                limit: Limit,
+            }, { additionalProperties: false }),
+            async handler(args) {
+                await tz.reload();
+                const where = and$(args.isoDateFrom ? gte(dailyStressBurden.isoDate, args.isoDateFrom) : undefined, args.isoDateTo ? lte(dailyStressBurden.isoDate, args.isoDateTo) : undefined);
+                const q = db
+                    .select()
+                    .from(dailyStressBurden)
+                    .orderBy(desc(dailyStressBurden.isoDate))
+                    .limit(applyLimit(args.limit));
+                const rows = where ? await q.where(where) : await q;
+                return {
+                    rows: rows.map((r) => ({ ...r, peakScoreTz: tzIso(tz, r.peakScoreUtc) })),
+                };
+            },
+        },
+        {
+            name: 'list_heart_rate_minute',
+            description: 'List minute-aggregated heart rate rows. `minuteStartTz` is the offset-aware ISO string of `minuteStartUtc`. Use cursor pagination for large windows.',
+            inputSchema: Type.Object({
+                fromUtcMs: Type.Optional(UnixMs),
+                toUtcMs: Type.Optional(UnixMs),
+                deviceId: Type.Optional(Type.Integer()),
+                cursor: Type.Optional(UnixMs),
+                limit: Limit,
+            }, { additionalProperties: false }),
+            async handler(args) {
+                await tz.reload();
+                const lim = applyLimit(args.limit);
+                const where = and$(args.fromUtcMs !== undefined
+                    ? gte(heartRateMinute.minuteStartUtc, args.fromUtcMs)
+                    : undefined, args.toUtcMs !== undefined
+                    ? lte(heartRateMinute.minuteStartUtc, args.toUtcMs)
+                    : undefined, args.deviceId !== undefined ? eq(heartRateMinute.deviceId, args.deviceId) : undefined, args.cursor !== undefined ? gt(heartRateMinute.minuteStartUtc, args.cursor) : undefined);
+                const q = db
+                    .select()
+                    .from(heartRateMinute)
+                    .orderBy(asc(heartRateMinute.minuteStartUtc))
+                    .limit(lim);
+                const rows = where ? await q.where(where) : await q;
+                const decorated = rows.map((r) => ({ ...r, minuteStartTz: tzIso(tz, r.minuteStartUtc) }));
+                const last = rows[rows.length - 1];
+                const nextCursor = rows.length === lim && last ? last.minuteStartUtc : null;
+                return { rows: decorated, nextCursor };
+            },
+        },
+        {
+            name: 'list_sleep_sessions',
+            description: 'List sleep sessions with timezone-aware timestamps (sleepOnsetTz, wakeTimeTz, cycle startTz/endTz) and human-readable durations (wasoR, restorativeSleepR, sleepDeficitR as hh:mm:ss).',
+            inputSchema: Type.Object({
+                isoDateFrom: Type.Optional(IsoDate),
+                isoDateTo: Type.Optional(IsoDate),
+                limit: Limit,
+            }, { additionalProperties: false }),
+            async handler(args) {
+                await tz.reload();
+                const where = and$(args.isoDateFrom ? gte(sleepSessions.isoDate, args.isoDateFrom) : undefined, args.isoDateTo ? lte(sleepSessions.isoDate, args.isoDateTo) : undefined);
+                const q = db
+                    .select()
+                    .from(sleepSessions)
+                    .orderBy(desc(sleepSessions.isoDate))
+                    .limit(applyLimit(args.limit));
+                const rows = where ? await q.where(where) : await q;
+                return { rows: rows.map((r) => decorateSleepSession(r, tz)) };
+            },
+        },
+        {
+            name: 'list_hr_zone_history',
+            description: 'List HR zone boundary history. Each row records the bpm lower bounds for zones 1..5 effective from `effectiveFromIsoDate`.',
+            inputSchema: Type.Object({
+                effectiveFromDate: Type.Optional(IsoDate),
+                limit: Limit,
+            }, { additionalProperties: false }),
+            async handler(args) {
+                const where = args.effectiveFromDate
+                    ? gte(hrZoneHistory.effectiveFromIsoDate, args.effectiveFromDate)
+                    : undefined;
+                const q = db
+                    .select()
+                    .from(hrZoneHistory)
+                    .orderBy(desc(hrZoneHistory.effectiveFromIsoDate))
+                    .limit(applyLimit(args.limit));
+                const rows = where ? await q.where(where) : await q;
+                return { rows };
+            },
+        },
+    ];
+}
+/**
+ * Decorate a sleep session row with timezone-aware timestamps and
+ * human-readable duration strings. The mobile schema deliberately stores the
+ * domain shape as opaque JSON, so we narrow defensively per field.
+ */
+function decorateSleepSession(row, tz) {
+    const payload = row.payload ?? {};
+    const decoratedPayload = { ...payload };
+    const sleepOnsetS = numberOrNull(payload.sleepOnsetS);
+    const wakeTimeS = numberOrNull(payload.wakeTimeS);
+    const wasoS = numberOrNull(payload.wasoS);
+    const restorativeSleepS = numberOrNull(payload.restorativeSleepS);
+    const sleepDeficitS = numberOrNull(payload.sleepDeficitS);
+    if (sleepOnsetS !== null)
+        decoratedPayload.sleepOnsetTz = tzIso(tz, sleepOnsetS * 1000);
+    if (wakeTimeS !== null)
+        decoratedPayload.wakeTimeTz = tzIso(tz, wakeTimeS * 1000);
+    if (wasoS !== null)
+        decoratedPayload.wasoR = formatHmsFromSeconds(wasoS);
+    if (restorativeSleepS !== null)
+        decoratedPayload.restorativeSleepR = formatHmsFromSeconds(restorativeSleepS);
+    if (sleepDeficitS !== null)
+        decoratedPayload.sleepDeficitR = formatHmsFromSeconds(sleepDeficitS);
+    const cycles = Array.isArray(payload.cycles) ? payload.cycles : [];
+    decoratedPayload.cycles = cycles.map((c) => {
+        if (!c || typeof c !== 'object')
+            return c;
+        const cycle = c;
+        const startS = numberOrNull(cycle.startS);
+        const endS = numberOrNull(cycle.endS);
+        return {
+            ...cycle,
+            ...(startS !== null ? { startTz: tzIso(tz, startS * 1000) } : {}),
+            ...(endS !== null ? { endTz: tzIso(tz, endS * 1000) } : {}),
+        };
+    });
+    return { ...row, payload: decoratedPayload };
+}
+function numberOrNull(v) {
+    return typeof v === 'number' && Number.isFinite(v) ? v : null;
+}
+//# sourceMappingURL=tools.js.map

package/dist/mcp/tools.js.map

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

package/dist/mcp/transforms.d.ts

@@ -0,0 +1,14 @@
+/**
+ * Format a UTC instant as an ISO 8601 string with a timezone offset attached.
+ *
+ *   formatTzIso(1716115262000, 120) === '2024-05-19T12:01:02+02:00'
+ *
+ * Seconds precision only — sub-second is intentionally dropped because none of
+ * the source timestamps carry it meaningfully.
+ */
+export declare function formatTzIso(utcMs: number, offsetMinutes: number): string;
+/**
+ * Format a signed duration in seconds as `hh:mm:ss` (or `-hh:mm:ss`). Supports
+ * durations larger than 24h — hours are not modulo'd.
+ */
+export declare function formatHmsFromSeconds(totalSeconds: number): string;