larkin 0.2.70

package/dist/agent/reminder-routes.cjs

@@ -0,0 +1,192 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createReminderRoutes = createReminderRoutes;
+const ReminderStore = __importStar(require("./reminder-store.cjs"));
+function versionOf(reminder) {
+    return Number(reminder.version || 0);
+}
+function createReminderRoutes(options) {
+    const now = options.now ?? Date.now;
+    const timeZone = options.timeZone ?? (() => Intl.DateTimeFormat().resolvedOptions().timeZone);
+    const handle = ({ path, pathNoQuery, method, body }) => {
+        if (!options.stateFile)
+            return { ok: false, status: 500, error: "state dir 未配置，无法持久化 reminder" };
+        const match = pathNoQuery.match(/\/reminders\/([^/]+)(\/(snooze|log))?$/);
+        const reminderId = match ? decodeURIComponent(match[1]) : null;
+        const subroute = match ? match[3] || null : null;
+        const find = (store) => store.reminders.find((record) => record.reminderId === reminderId);
+        if (method === "POST" && !reminderId) {
+            const title = String(body.title || "").trim();
+            if (!title)
+                return { ok: false, status: 400, error: "title 不能为空" };
+            const current = now();
+            const tz = typeof body.tz === "string" && body.tz ? body.tz : timeZone();
+            let recurrence = null;
+            if (body.repeat !== undefined) {
+                recurrence = ReminderStore.parseRepeat(body.repeat, tz);
+                if ("error" in recurrence)
+                    return { ok: false, status: 400, error: recurrence.error };
+            }
+            let fireAtMs = null;
+            let warning = null;
+            if (body.delaySeconds != null)
+                fireAtMs = current + Number(body.delaySeconds) * 1_000;
+            else if (body.fireAt !== undefined) {
+                fireAtMs = Date.parse(String(body.fireAt));
+                if (Number.isNaN(fireAtMs))
+                    return { ok: false, status: 400, error: `fireAt 不是合法时间：${String(body.fireAt)}` };
+                if (fireAtMs <= current)
+                    warning = "fireAt 已是过去时间，将立即触发";
+            }
+            else if (recurrence && !("error" in recurrence))
+                fireAtMs = recurrence.next(current);
+            if (!fireAtMs)
+                return { ok: false, status: 400, error: "无法确定首次触发时间" };
+            const reminder = {
+                reminderId: ReminderStore.newId(), ownerAgentId: options.agentId, title,
+                fireAt: ReminderStore.nowIso(fireAtMs), firedAt: null, createdAt: ReminderStore.nowIso(current),
+                status: "scheduled", msgRef: body.msgId ?? null, msgPermalink: null,
+                repeat: body.repeat ?? null, tz: body.repeat !== undefined ? tz : null,
+                channel: body.channel ?? null, payload: body.payload ?? null,
+                version: 1, events: [],
+            };
+            ReminderStore.appendEvent(reminder, "scheduled", "agent", options.agentId, reminder.fireAt, current);
+            ReminderStore.mutate(options.stateFile, (store) => store.reminders.push(reminder));
+            options.log(`reminder 已建 #${reminder.reminderId.slice(0, 8)} fireAt=${reminder.fireAt}${reminder.repeat ? ` repeat=${String(reminder.repeat)}` : ""}`);
+            return { ok: true, status: 200, data: { reminder: ReminderStore.toSummary(reminder), ...(warning ? { warning } : {}) } };
+        }
+        if (method === "GET" && !reminderId) {
+            const store = ReminderStore.load(options.stateFile);
+            const all = options.query(path, "all") === "true";
+            const statuses = (options.query(path, "status") || "scheduled,fired").split(",").map((status) => status.trim());
+            return { ok: true, status: 200, data: { reminders: store.reminders.filter((record) => all || statuses.includes(record.status)).map(ReminderStore.toSummary) } };
+        }
+        if (!reminderId)
+            return { ok: false, status: 404, error: "unknown reminders route" };
+        if (method === "GET" && subroute === "log") {
+            const reminder = find(ReminderStore.load(options.stateFile));
+            if (!reminder)
+                return { ok: false, status: 404, error: `reminder 不存在：${reminderId}` };
+            return { ok: true, status: 200, data: { events: reminder.events || [] } };
+        }
+        if (method === "POST" && subroute === "snooze") {
+            const delay = Number(body.delaySeconds);
+            if (!Number.isFinite(delay) || delay <= 0)
+                return { ok: false, status: 400, error: "delaySeconds 必须为正数" };
+            const output = ReminderStore.mutate(options.stateFile, (store) => {
+                const reminder = find(store);
+                if (!reminder)
+                    return null;
+                const current = now();
+                reminder.fireAt = ReminderStore.nowIso(current + delay * 1_000);
+                reminder.status = "scheduled";
+                reminder.version = versionOf(reminder) + 1;
+                ReminderStore.appendEvent(reminder, "snoozed", "agent", options.agentId, reminder.fireAt, current);
+                return ReminderStore.toSummary(reminder);
+            });
+            return output
+                ? { ok: true, status: 200, data: { reminder: output } }
+                : { ok: false, status: 404, error: `reminder 不存在：${reminderId}` };
+        }
+        if (method === "PATCH" && !subroute) {
+            let warning = null;
+            if (body.fireAt !== undefined && Number.isNaN(Date.parse(String(body.fireAt)))) {
+                return { ok: false, status: 400, error: `fireAt 不是合法时间：${String(body.fireAt)}` };
+            }
+            const patchTz = typeof body.tz === "string" && body.tz ? body.tz : timeZone();
+            if (body.repeat !== undefined) {
+                const recurrence = ReminderStore.parseRepeat(body.repeat, patchTz);
+                if ("error" in recurrence)
+                    return { ok: false, status: 400, error: recurrence.error };
+            }
+            const output = ReminderStore.mutate(options.stateFile, (store) => {
+                const reminder = find(store);
+                if (!reminder)
+                    return null;
+                const current = now();
+                if (body.title !== undefined)
+                    reminder.title = String(body.title);
+                if (body.delaySeconds != null) {
+                    reminder.fireAt = ReminderStore.nowIso(current + Number(body.delaySeconds) * 1_000);
+                    reminder.status = "scheduled";
+                }
+                if (body.fireAt !== undefined) {
+                    const parsed = Date.parse(String(body.fireAt));
+                    if (parsed <= current)
+                        warning = "fireAt 已是过去时间，将立即触发";
+                    reminder.fireAt = ReminderStore.nowIso(parsed);
+                    reminder.status = "scheduled";
+                }
+                if (body.repeat !== undefined) {
+                    const tz = (typeof body.tz === "string" && body.tz) || reminder.tz || patchTz;
+                    reminder.repeat = body.repeat;
+                    reminder.tz = tz;
+                    reminder.status = "scheduled";
+                    const recurrence = ReminderStore.parseRepeat(body.repeat, tz);
+                    if (!("error" in recurrence) && Date.parse(reminder.fireAt) <= current) {
+                        const next = recurrence.next(current, Date.parse(reminder.fireAt));
+                        if (next)
+                            reminder.fireAt = ReminderStore.nowIso(next);
+                    }
+                }
+                reminder.version = versionOf(reminder) + 1;
+                ReminderStore.appendEvent(reminder, "updated", "agent", options.agentId, reminder.status === "scheduled" ? reminder.fireAt : null, current);
+                return ReminderStore.toSummary(reminder);
+            });
+            return output
+                ? { ok: true, status: 200, data: { reminder: output, ...(warning ? { warning } : {}) } }
+                : { ok: false, status: 404, error: `reminder 不存在：${reminderId}` };
+        }
+        if (method === "DELETE" && !subroute) {
+            const output = ReminderStore.mutate(options.stateFile, (store) => {
+                const reminder = find(store);
+                if (!reminder)
+                    return null;
+                const current = now();
+                reminder.status = "canceled";
+                reminder.version = versionOf(reminder) + 1;
+                ReminderStore.appendEvent(reminder, "canceled", "agent", options.agentId, null, current);
+                return ReminderStore.toSummary(reminder);
+            });
+            if (!output)
+                return { ok: false, status: 404, error: `reminder 不存在：${reminderId}` };
+            options.log(`reminder 已取消 #${reminderId.slice(0, 8)}`);
+            return { ok: true, status: 200, data: { reminder: output } };
+        }
+        return { ok: false, status: 404, error: `unknown reminders route: ${method} ${pathNoQuery}` };
+    };
+    return { handle };
+}

package/dist/agent/reminder-routes.mjs

@@ -0,0 +1,156 @@
+import * as ReminderStore from "./reminder-store.mjs";
+function versionOf(reminder) {
+    return Number(reminder.version || 0);
+}
+export function createReminderRoutes(options) {
+    const now = options.now ?? Date.now;
+    const timeZone = options.timeZone ?? (() => Intl.DateTimeFormat().resolvedOptions().timeZone);
+    const handle = ({ path, pathNoQuery, method, body }) => {
+        if (!options.stateFile)
+            return { ok: false, status: 500, error: "state dir 未配置，无法持久化 reminder" };
+        const match = pathNoQuery.match(/\/reminders\/([^/]+)(\/(snooze|log))?$/);
+        const reminderId = match ? decodeURIComponent(match[1]) : null;
+        const subroute = match ? match[3] || null : null;
+        const find = (store) => store.reminders.find((record) => record.reminderId === reminderId);
+        if (method === "POST" && !reminderId) {
+            const title = String(body.title || "").trim();
+            if (!title)
+                return { ok: false, status: 400, error: "title 不能为空" };
+            const current = now();
+            const tz = typeof body.tz === "string" && body.tz ? body.tz : timeZone();
+            let recurrence = null;
+            if (body.repeat !== undefined) {
+                recurrence = ReminderStore.parseRepeat(body.repeat, tz);
+                if ("error" in recurrence)
+                    return { ok: false, status: 400, error: recurrence.error };
+            }
+            let fireAtMs = null;
+            let warning = null;
+            if (body.delaySeconds != null)
+                fireAtMs = current + Number(body.delaySeconds) * 1_000;
+            else if (body.fireAt !== undefined) {
+                fireAtMs = Date.parse(String(body.fireAt));
+                if (Number.isNaN(fireAtMs))
+                    return { ok: false, status: 400, error: `fireAt 不是合法时间：${String(body.fireAt)}` };
+                if (fireAtMs <= current)
+                    warning = "fireAt 已是过去时间，将立即触发";
+            }
+            else if (recurrence && !("error" in recurrence))
+                fireAtMs = recurrence.next(current);
+            if (!fireAtMs)
+                return { ok: false, status: 400, error: "无法确定首次触发时间" };
+            const reminder = {
+                reminderId: ReminderStore.newId(), ownerAgentId: options.agentId, title,
+                fireAt: ReminderStore.nowIso(fireAtMs), firedAt: null, createdAt: ReminderStore.nowIso(current),
+                status: "scheduled", msgRef: body.msgId ?? null, msgPermalink: null,
+                repeat: body.repeat ?? null, tz: body.repeat !== undefined ? tz : null,
+                channel: body.channel ?? null, payload: body.payload ?? null,
+                version: 1, events: [],
+            };
+            ReminderStore.appendEvent(reminder, "scheduled", "agent", options.agentId, reminder.fireAt, current);
+            ReminderStore.mutate(options.stateFile, (store) => store.reminders.push(reminder));
+            options.log(`reminder 已建 #${reminder.reminderId.slice(0, 8)} fireAt=${reminder.fireAt}${reminder.repeat ? ` repeat=${String(reminder.repeat)}` : ""}`);
+            return { ok: true, status: 200, data: { reminder: ReminderStore.toSummary(reminder), ...(warning ? { warning } : {}) } };
+        }
+        if (method === "GET" && !reminderId) {
+            const store = ReminderStore.load(options.stateFile);
+            const all = options.query(path, "all") === "true";
+            const statuses = (options.query(path, "status") || "scheduled,fired").split(",").map((status) => status.trim());
+            return { ok: true, status: 200, data: { reminders: store.reminders.filter((record) => all || statuses.includes(record.status)).map(ReminderStore.toSummary) } };
+        }
+        if (!reminderId)
+            return { ok: false, status: 404, error: "unknown reminders route" };
+        if (method === "GET" && subroute === "log") {
+            const reminder = find(ReminderStore.load(options.stateFile));
+            if (!reminder)
+                return { ok: false, status: 404, error: `reminder 不存在：${reminderId}` };
+            return { ok: true, status: 200, data: { events: reminder.events || [] } };
+        }
+        if (method === "POST" && subroute === "snooze") {
+            const delay = Number(body.delaySeconds);
+            if (!Number.isFinite(delay) || delay <= 0)
+                return { ok: false, status: 400, error: "delaySeconds 必须为正数" };
+            const output = ReminderStore.mutate(options.stateFile, (store) => {
+                const reminder = find(store);
+                if (!reminder)
+                    return null;
+                const current = now();
+                reminder.fireAt = ReminderStore.nowIso(current + delay * 1_000);
+                reminder.status = "scheduled";
+                reminder.version = versionOf(reminder) + 1;
+                ReminderStore.appendEvent(reminder, "snoozed", "agent", options.agentId, reminder.fireAt, current);
+                return ReminderStore.toSummary(reminder);
+            });
+            return output
+                ? { ok: true, status: 200, data: { reminder: output } }
+                : { ok: false, status: 404, error: `reminder 不存在：${reminderId}` };
+        }
+        if (method === "PATCH" && !subroute) {
+            let warning = null;
+            if (body.fireAt !== undefined && Number.isNaN(Date.parse(String(body.fireAt)))) {
+                return { ok: false, status: 400, error: `fireAt 不是合法时间：${String(body.fireAt)}` };
+            }
+            const patchTz = typeof body.tz === "string" && body.tz ? body.tz : timeZone();
+            if (body.repeat !== undefined) {
+                const recurrence = ReminderStore.parseRepeat(body.repeat, patchTz);
+                if ("error" in recurrence)
+                    return { ok: false, status: 400, error: recurrence.error };
+            }
+            const output = ReminderStore.mutate(options.stateFile, (store) => {
+                const reminder = find(store);
+                if (!reminder)
+                    return null;
+                const current = now();
+                if (body.title !== undefined)
+                    reminder.title = String(body.title);
+                if (body.delaySeconds != null) {
+                    reminder.fireAt = ReminderStore.nowIso(current + Number(body.delaySeconds) * 1_000);
+                    reminder.status = "scheduled";
+                }
+                if (body.fireAt !== undefined) {
+                    const parsed = Date.parse(String(body.fireAt));
+                    if (parsed <= current)
+                        warning = "fireAt 已是过去时间，将立即触发";
+                    reminder.fireAt = ReminderStore.nowIso(parsed);
+                    reminder.status = "scheduled";
+                }
+                if (body.repeat !== undefined) {
+                    const tz = (typeof body.tz === "string" && body.tz) || reminder.tz || patchTz;
+                    reminder.repeat = body.repeat;
+                    reminder.tz = tz;
+                    reminder.status = "scheduled";
+                    const recurrence = ReminderStore.parseRepeat(body.repeat, tz);
+                    if (!("error" in recurrence) && Date.parse(reminder.fireAt) <= current) {
+                        const next = recurrence.next(current, Date.parse(reminder.fireAt));
+                        if (next)
+                            reminder.fireAt = ReminderStore.nowIso(next);
+                    }
+                }
+                reminder.version = versionOf(reminder) + 1;
+                ReminderStore.appendEvent(reminder, "updated", "agent", options.agentId, reminder.status === "scheduled" ? reminder.fireAt : null, current);
+                return ReminderStore.toSummary(reminder);
+            });
+            return output
+                ? { ok: true, status: 200, data: { reminder: output, ...(warning ? { warning } : {}) } }
+                : { ok: false, status: 404, error: `reminder 不存在：${reminderId}` };
+        }
+        if (method === "DELETE" && !subroute) {
+            const output = ReminderStore.mutate(options.stateFile, (store) => {
+                const reminder = find(store);
+                if (!reminder)
+                    return null;
+                const current = now();
+                reminder.status = "canceled";
+                reminder.version = versionOf(reminder) + 1;
+                ReminderStore.appendEvent(reminder, "canceled", "agent", options.agentId, null, current);
+                return ReminderStore.toSummary(reminder);
+            });
+            if (!output)
+                return { ok: false, status: 404, error: `reminder 不存在：${reminderId}` };
+            options.log(`reminder 已取消 #${reminderId.slice(0, 8)}`);
+            return { ok: true, status: 200, data: { reminder: output } };
+        }
+        return { ok: false, status: 404, error: `unknown reminders route: ${method} ${pathNoQuery}` };
+    };
+    return { handle };
+}

package/dist/agent/reminder-store.cjs

@@ -0,0 +1,220 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.newId = exports.nowIso = void 0;
+exports.withLock = withLock;
+exports.load = load;
+exports.save = save;
+exports.mutate = mutate;
+exports.parseRepeat = parseRepeat;
+exports.toSummary = toSummary;
+exports.appendEvent = appendEvent;
+const node_crypto_1 = __importDefault(require("node:crypto"));
+const node_fs_1 = __importDefault(require("node:fs"));
+const nowIso = (ms) => new Date(ms ?? Date.now()).toISOString();
+exports.nowIso = nowIso;
+const newId = () => node_crypto_1.default.randomUUID().replace(/-/g, "");
+exports.newId = newId;
+// Host and Agent transport are separate processes. mkdir is the cross-process mutex;
+// the timeout and stale-lock ages intentionally preserve the established production contract.
+function withLock(file, fn, timeoutMs = 2_000) {
+    const lockDir = `${file}.lock`;
+    const deadline = Date.now() + timeoutMs;
+    for (;;) {
+        try {
+            node_fs_1.default.mkdirSync(lockDir);
+            break;
+        }
+        catch (error) {
+            if (error.code !== "EEXIST")
+                throw error;
+            try {
+                if (Date.now() - node_fs_1.default.statSync(lockDir).mtimeMs > 10_000) {
+                    node_fs_1.default.rmdirSync(lockDir);
+                    continue;
+                }
+            }
+            catch { /* another process may be reclaiming the same stale directory */ }
+            if (Date.now() > deadline)
+                throw new Error("reminders.json 锁等待超时");
+            const until = Date.now() + 15;
+            while (Date.now() < until) { /* preserve the existing short synchronous critical section */ }
+        }
+    }
+    try {
+        return fn();
+    }
+    finally {
+        try {
+            node_fs_1.default.rmdirSync(lockDir);
+        }
+        catch { /* best effort: preserve existing crash-recovery semantics */ }
+    }
+}
+function load(file) {
+    try {
+        const parsed = JSON.parse(node_fs_1.default.readFileSync(file, "utf8"));
+        if (parsed && Array.isArray(parsed.reminders))
+            return parsed;
+    }
+    catch { /* missing and damaged stores both project to an empty store */ }
+    return { reminders: [] };
+}
+function save(file, store) {
+    const temporary = `${file}.tmp`;
+    node_fs_1.default.writeFileSync(temporary, `${JSON.stringify(store, null, 2)}\n`);
+    node_fs_1.default.renameSync(temporary, file);
+}
+function mutate(file, fn, lockTimeoutMs = 2_000) {
+    return withLock(file, () => {
+        const store = load(file);
+        const result = fn(store);
+        save(file, store);
+        return result;
+    }, lockTimeoutMs);
+}
+const WEEKDAYS = ["sun", "mon", "tue", "wed", "thu", "fri", "sat"];
+function validTz(tz) {
+    try {
+        new Intl.DateTimeFormat("en-US", { timeZone: tz });
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+function wallParts(ms, tz) {
+    const formatter = new Intl.DateTimeFormat("en-US", {
+        timeZone: tz,
+        year: "numeric",
+        month: "2-digit",
+        day: "2-digit",
+        hour: "2-digit",
+        minute: "2-digit",
+        second: "2-digit",
+        weekday: "short",
+        hour12: false,
+    });
+    const parts = {};
+    for (const part of formatter.formatToParts(ms))
+        parts[part.type] = part.value;
+    return {
+        y: Number(parts.year),
+        mo: Number(parts.month),
+        d: Number(parts.day),
+        hh: parts.hour === "24" ? 0 : Number(parts.hour),
+        mm: Number(parts.minute),
+        ss: Number(parts.second),
+        wd: ["Sun", "Mon", "Tue", "Wed", "Thu", "Fri", "Sat"].indexOf(parts.weekday),
+    };
+}
+function utcOffsetMs(ms, tz) {
+    const wall = wallParts(ms, tz);
+    return Date.UTC(wall.y, wall.mo - 1, wall.d, wall.hh, wall.mm, wall.ss) - Math.floor(ms / 1_000) * 1_000;
+}
+function wallToUtc(y, mo, d, hh, mm, tz) {
+    const firstGuess = Date.UTC(y, mo - 1, d, hh, mm);
+    const secondGuess = firstGuess - utcOffsetMs(firstGuess, tz);
+    return firstGuess - utcOffsetMs(secondGuess, tz);
+}
+function parseRepeat(rule, tz) {
+    const normalized = String(rule || "").trim();
+    const normalizedTz = tz || undefined;
+    const zone = validTz(normalizedTz) ? normalizedTz : Intl.DateTimeFormat().resolvedOptions().timeZone;
+    let match = normalized.match(/^every:(\d+)(s|m|h|d)$/);
+    if (match) {
+        const multipliers = { s: 1_000, m: 60_000, h: 3_600_000, d: 86_400_000 };
+        const unit = match[2];
+        const period = Number(match[1]) * multipliers[unit];
+        if (period < 60_000)
+            return { error: "间隔太短：every 至少 1 分钟（如 every:15m）" };
+        return {
+            kind: "interval",
+            description: `every ${match[1]}${unit}`,
+            next: (afterMs, anchorMs) => {
+                const base = Number.isFinite(anchorMs) ? Number(anchorMs) : afterMs;
+                const count = Math.max(1, Math.floor((afterMs - base) / period) + 1);
+                return base + count * period;
+            },
+        };
+    }
+    match = normalized.match(/^daily@(\d{1,2}):(\d{2})$/);
+    if (match) {
+        const [hours, minutes] = [Number(match[1]), Number(match[2])];
+        if (hours > 23 || minutes > 59)
+            return { error: `无效时间 ${match[1]}:${match[2]}` };
+        return {
+            kind: "daily",
+            description: `daily@${String(hours).padStart(2, "0")}:${match[2]} (${zone})`,
+            next: (afterMs) => {
+                const wall = wallParts(afterMs, zone);
+                for (let offset = 0; offset <= 2; offset += 1) {
+                    const candidate = wallToUtc(wall.y, wall.mo, wall.d + offset, hours, minutes, zone);
+                    if (candidate > afterMs)
+                        return candidate;
+                }
+                return null;
+            },
+        };
+    }
+    match = normalized.match(/^weekly:([a-z,]+)@(\d{1,2}):(\d{2})$/);
+    if (match) {
+        const days = match[1].split(",").map((day) => WEEKDAYS.indexOf(day.trim()));
+        const [hours, minutes] = [Number(match[2]), Number(match[3])];
+        if (days.some((day) => day < 0))
+            return { error: `无效星期（可用: ${WEEKDAYS.join(",")}）：${match[1]}` };
+        if (hours > 23 || minutes > 59)
+            return { error: `无效时间 ${match[2]}:${match[3]}` };
+        return {
+            kind: "weekly",
+            description: `weekly:${match[1]}@${String(hours).padStart(2, "0")}:${match[3]} (${zone})`,
+            next: (afterMs) => {
+                const wall = wallParts(afterMs, zone);
+                for (let offset = 0; offset <= 8; offset += 1) {
+                    const candidate = wallToUtc(wall.y, wall.mo, wall.d + offset, hours, minutes, zone);
+                    if (candidate > afterMs && days.includes(wallParts(candidate, zone).wd))
+                        return candidate;
+                }
+                return null;
+            },
+        };
+    }
+    return { error: `无法识别的 repeat 规则：${JSON.stringify(normalized)}。支持 every:<N><s|m|h|d>、daily@HH:MM、weekly:mon,fri@HH:MM` };
+}
+function toSummary(reminder) {
+    let recurrence = null;
+    if (reminder.repeat) {
+        const parsed = parseRepeat(reminder.repeat, reminder.tz || undefined);
+        recurrence = "error" in parsed
+            ? { kind: "unsupported", description: String(reminder.repeat) }
+            : { kind: parsed.kind, description: parsed.description };
+    }
+    return {
+        reminderId: reminder.reminderId,
+        ownerAgentId: reminder.ownerAgentId,
+        title: reminder.title,
+        fireAt: reminder.fireAt,
+        firedAt: reminder.firedAt ?? null,
+        createdAt: reminder.createdAt,
+        status: reminder.status,
+        msgRef: reminder.msgRef ?? null,
+        msgPermalink: reminder.msgPermalink ?? null,
+        recurrence,
+    };
+}
+function appendEvent(reminder, eventType, actorType, actorId, nextFireAt, ms) {
+    if (!Array.isArray(reminder.events))
+        reminder.events = [];
+    reminder.events.push({
+        eventId: (0, exports.newId)(),
+        reminderId: reminder.reminderId,
+        eventType,
+        actorType,
+        actorId: actorId ?? null,
+        occurredAt: (0, exports.nowIso)(ms),
+        nextFireAt: nextFireAt ?? null,
+        metadata: null,
+    });
+}