@geminixiang/mikan 0.2.0

package/dist/conversation-history.js

@@ -0,0 +1,144 @@
+import { randomUUID } from "crypto";
+import { mkdirSync, statSync } from "fs";
+import { join } from "path";
+import { isRecord, parseJsonValue, readTextFileIfExists } from "./file-guards.js";
+import { atomicWritePrivateFile } from "./fs-atomic.js";
+import * as log from "./log.js";
+const DEFAULT_RECENT_DAYS = 14;
+const DEFAULT_MAX_MESSAGES = 200;
+export function resolveUsableTopLevelHistorySession(options) {
+    if (options.existingSessionFile && isSessionFreshForTopLevelHistory(options)) {
+        return options.existingSessionFile;
+    }
+    return materializeTopLevelHistorySession(options);
+}
+export function materializeTopLevelHistorySession(options) {
+    const messages = readTopLevelHistoryMessages(options);
+    if (messages.length === 0)
+        return null;
+    mkdirSync(options.sessionDir, { recursive: true });
+    const now = options.now ?? new Date();
+    const sessionId = randomUUID();
+    const filename = `${now.toISOString().replace(/[:.]/g, "-")}_${sessionId.slice(0, 8)}_history.jsonl`;
+    const sessionFile = join(options.sessionDir, filename);
+    const header = {
+        type: "session",
+        version: 3,
+        id: sessionId,
+        timestamp: now.toISOString(),
+        cwd: options.cwd,
+        source: {
+            kind: "platform-history",
+            file: "log.jsonl",
+            recentDays: options.recentDays ?? DEFAULT_RECENT_DAYS,
+        },
+    };
+    const entries = messages.map((message) => ({
+        type: "message",
+        id: randomUUID().slice(0, 8),
+        parentId: null,
+        timestamp: new Date(message.date ?? now.toISOString()).toISOString(),
+        message: buildHistorySessionMessage(message),
+    }));
+    const content = [header, ...entries].map((entry) => JSON.stringify(entry)).join("\n");
+    atomicWritePrivateFile(sessionFile, `${content}\n`);
+    atomicWritePrivateFile(join(options.sessionDir, "current"), filename);
+    return sessionFile;
+}
+export function latestTopLevelHistoryTime(options) {
+    const messages = readTopLevelHistoryMessages({ ...options, maxMessages: 1 });
+    const latest = messages.at(-1);
+    if (!latest?.date)
+        return null;
+    const ms = new Date(latest.date).getTime();
+    return Number.isFinite(ms) ? ms : null;
+}
+export function readTopLevelHistoryMessages(options) {
+    const logFile = join(options.conversationDir, "log.jsonl");
+    const raw = readTextFileIfExists(logFile);
+    if (raw === undefined)
+        return [];
+    const nowMs = (options.now ?? new Date()).getTime();
+    const sinceMs = nowMs - (options.recentDays ?? DEFAULT_RECENT_DAYS) * 24 * 60 * 60 * 1000;
+    const messages = [];
+    const lines = raw.trim().split("\n").filter(Boolean);
+    for (let i = 0; i < lines.length; i++) {
+        try {
+            const entry = parseJsonValue(lines[i], (value) => isRecord(value), (detail) => (detail === "unexpected JSON shape" ? "expected a JSON object" : detail));
+            if (entry.threadTs)
+                continue;
+            if (!entry.text?.trim())
+                continue;
+            if (entry.date) {
+                const dateMs = new Date(entry.date).getTime();
+                if (Number.isFinite(dateMs) && dateMs < sinceMs)
+                    continue;
+            }
+            messages.push(entry);
+        }
+        catch (err) {
+            log.logWarning(`Skipping malformed log entry at ${logFile}:${i + 1}`, err instanceof Error ? err.message : String(err));
+        }
+    }
+    return messages.slice(-(options.maxMessages ?? DEFAULT_MAX_MESSAGES));
+}
+function isSessionFreshForTopLevelHistory(options) {
+    if (!options.existingSessionFile)
+        return false;
+    const latestHistoryMs = latestTopLevelHistoryTime(options);
+    if (latestHistoryMs === null)
+        return true;
+    try {
+        return statSync(options.existingSessionFile).mtimeMs >= latestHistoryMs;
+    }
+    catch {
+        return false;
+    }
+}
+function buildHistorySessionMessage(message) {
+    const base = {
+        role: message.isBot ? "assistant" : "user",
+        content: [{ type: "text", text: formatHistoryMessage(message) }],
+        ...(message.date ? { timestamp: new Date(message.date).getTime() } : {}),
+    };
+    if (!message.isBot)
+        return base;
+    return {
+        ...base,
+        api: "platform-history",
+        provider: "platform-history",
+        model: "platform-history",
+        usage: zeroUsage(),
+        stopReason: "stop",
+    };
+}
+function zeroUsage() {
+    return {
+        input: 0,
+        output: 0,
+        cacheRead: 0,
+        cacheWrite: 0,
+        totalTokens: 0,
+        cost: { input: 0, output: 0, cacheRead: 0, cacheWrite: 0, total: 0 },
+    };
+}
+function formatHistoryMessage(message) {
+    const text = message.text?.trim() ?? "";
+    if (message.isBot)
+        return text;
+    const userLabel = message.userName || message.user || "unknown";
+    const timestamp = message.date ? formatLocalTimestamp(new Date(message.date)) : null;
+    return timestamp ? `[${timestamp}] [${userLabel}]: ${text}` : `[${userLabel}]: ${text}`;
+}
+function formatLocalTimestamp(date) {
+    const offset = -date.getTimezoneOffset();
+    const sign = offset >= 0 ? "+" : "-";
+    const abs = Math.abs(offset);
+    return (`${date.getFullYear()}-${pad(date.getMonth() + 1)}-${pad(date.getDate())} ` +
+        `${pad(date.getHours())}:${pad(date.getMinutes())}:${pad(date.getSeconds())}` +
+        `${sign}${pad(Math.floor(abs / 60))}:${pad(abs % 60)}`);
+}
+function pad(n) {
+    return n.toString().padStart(2, "0");
+}
+//# sourceMappingURL=conversation-history.js.map

package/dist/conversation-history.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"conversation-history.js","sourceRoot":"","sources":["../src/conversation-history.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,QAAQ,CAAC;AACpC,OAAO,EAAE,SAAS,EAAE,QAAQ,EAAE,MAAM,IAAI,CAAC;AACzC,OAAO,EAAE,IAAI,EAAE,MAAM,MAAM,CAAC;AAC5B,OAAO,EAAE,QAAQ,EAAE,cAAc,EAAE,oBAAoB,EAAE,MAAM,kBAAkB,CAAC;AAClF,OAAO,EAAE,sBAAsB,EAAE,MAAM,gBAAgB,CAAC;AAExD,OAAO,KAAK,GAAG,MAAM,UAAU,CAAC;AAWhC,MAAM,mBAAmB,GAAG,EAAE,CAAC;AAC/B,MAAM,oBAAoB,GAAG,GAAG,CAAC;AAEjC,MAAM,UAAU,mCAAmC,CACjD,OAAmF;IAEnF,IAAI,OAAO,CAAC,mBAAmB,IAAI,gCAAgC,CAAC,OAAO,CAAC,EAAE,CAAC;QAC7E,OAAO,OAAO,CAAC,mBAAmB,CAAC;IACrC,CAAC;IACD,OAAO,iCAAiC,CAAC,OAAO,CAAC,CAAC;AACpD,CAAC;AAED,MAAM,UAAU,iCAAiC,CAC/C,OAA0C;IAE1C,MAAM,QAAQ,GAAG,2BAA2B,CAAC,OAAO,CAAC,CAAC;IACtD,IAAI,QAAQ,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,IAAI,CAAC;IAEvC,SAAS,CAAC,OAAO,CAAC,UAAU,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IACnD,MAAM,GAAG,GAAG,OAAO,CAAC,GAAG,IAAI,IAAI,IAAI,EAAE,CAAC;IACtC,MAAM,SAAS,GAAG,UAAU,EAAE,CAAC;IAC/B,MAAM,QAAQ,GAAG,GAAG,GAAG,CAAC,WAAW,EAAE,CAAC,OAAO,CAAC,OAAO,EAAE,GAAG,CAAC,IAAI,SAAS,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,gBAAgB,CAAC;IACrG,MAAM,WAAW,GAAG,IAAI,CAAC,OAAO,CAAC,UAAU,EAAE,QAAQ,CAAC,CAAC;IACvD,MAAM,MAAM,GAAG;QACb,IAAI,EAAE,SAAS;QACf,OAAO,EAAE,CAAC;QACV,EAAE,EAAE,SAAS;QACb,SAAS,EAAE,GAAG,CAAC,WAAW,EAAE;QAC5B,GAAG,EAAE,OAAO,CAAC,GAAG;QAChB,MAAM,EAAE;YACN,IAAI,EAAE,kBAAkB;YACxB,IAAI,EAAE,WAAW;YACjB,UAAU,EAAE,OAAO,CAAC,UAAU,IAAI,mBAAmB;SACtD;KACF,CAAC;IACF,MAAM,OAAO,GAAG,QAAQ,CAAC,GAAG,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC;QACzC,IAAI,EAAE,SAAS;QACf,EAAE,EAAE,UAAU,EAAE,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC;QAC5B,QAAQ,EAAE,IAAI;QACd,SAAS,EAAE,IAAI,IAAI,CAAC,OAAO,CAAC,IAAI,IAAI,GAAG,CAAC,WAAW,EAAE,CAAC,CAAC,WAAW,EAAE;QACpE,OAAO,EAAE,0BAA0B,CAAC,OAAO,CAAC;KAC7C,CAAC,CAAC,CAAC;IAEJ,MAAM,OAAO,GAAG,CAAC,MAAM,EAAE,GAAG,OAAO,CAAC,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACtF,sBAAsB,CAAC,WAAW,EAAE,GAAG,OAAO,IAAI,CAAC,CAAC;IACpD,sBAAsB,CAAC,IAAI,CAAC,OAAO,CAAC,UAAU,EAAE,SAAS,CAAC,EAAE,QAAQ,CAAC,CAAC;IACtE,OAAO,WAAW,CAAC;AACrB,CAAC;AAED,MAAM,UAAU,yBAAyB,CACvC,OAAsE;IAEtE,MAAM,QAAQ,GAAG,2BAA2B,CAAC,EAAE,GAAG,OAAO,EAAE,WAAW,EAAE,CAAC,EAAE,CAAC,CAAC;IAC7E,MAAM,MAAM,GAAG,QAAQ,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC;IAC/B,IAAI,CAAC,MAAM,EAAE,IAAI;QAAE,OAAO,IAAI,CAAC;IAC/B,MAAM,EAAE,GAAG,IAAI,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,OAAO,EAAE,CAAC;IAC3C,OAAO,MAAM,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC;AACzC,CAAC;AAED,MAAM,UAAU,2BAA2B,CACzC,OAAsE;IAEtE,MAAM,OAAO,GAAG,IAAI,CAAC,OAAO,CAAC,eAAe,EAAE,WAAW,CAAC,CAAC;IAC3D,MAAM,GAAG,GAAG,oBAAoB,CAAC,OAAO,CAAC,CAAC;IAC1C,IAAI,GAAG,KAAK,SAAS;QAAE,OAAO,EAAE,CAAC;IAEjC,MAAM,KAAK,GAAG,CAAC,OAAO,CAAC,GAAG,IAAI,IAAI,IAAI,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC;IACpD,MAAM,OAAO,GAAG,KAAK,GAAG,CAAC,OAAO,CAAC,UAAU,IAAI,mBAAmB,CAAC,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,IAAI,CAAC;IAC1F,MAAM,QAAQ,GAA6B,EAAE,CAAC;IAC9C,MAAM,KAAK,GAAG,GAAG,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;IAErD,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,KAAK,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;QACtC,IAAI,CAAC;YACH,MAAM,KAAK,GAAG,cAAc,CAC1B,KAAK,CAAC,CAAC,CAAC,EACR,CAAC,KAAK,EAAmC,EAAE,CAAC,QAAQ,CAAC,KAAK,CAAC,EAC3D,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,MAAM,KAAK,uBAAuB,CAAC,CAAC,CAAC,wBAAwB,CAAC,CAAC,CAAC,MAAM,CAAC,CACrF,CAAC;YACF,IAAI,KAAK,CAAC,QAAQ;gBAAE,SAAS;YAC7B,IAAI,CAAC,KAAK,CAAC,IAAI,EAAE,IAAI,EAAE;gBAAE,SAAS;YAClC,IAAI,KAAK,CAAC,IAAI,EAAE,CAAC;gBACf,MAAM,MAAM,GAAG,IAAI,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,OAAO,EAAE,CAAC;gBAC9C,IAAI,MAAM,CAAC,QAAQ,CAAC,MAAM,CAAC,IAAI,MAAM,GAAG,OAAO;oBAAE,SAAS;YAC5D,CAAC;YACD,QAAQ,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QACvB,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,GAAG,CAAC,UAAU,CACZ,mCAAmC,OAAO,IAAI,CAAC,GAAG,CAAC,EAAE,EACrD,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CACjD,CAAC;QACJ,CAAC;IACH,CAAC;IAED,OAAO,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAC,OAAO,CAAC,WAAW,IAAI,oBAAoB,CAAC,CAAC,CAAC;AACxE,CAAC;AAED,SAAS,gCAAgC,CACvC,OAAmF;IAEnF,IAAI,CAAC,OAAO,CAAC,mBAAmB;QAAE,OAAO,KAAK,CAAC;IAC/C,MAAM,eAAe,GAAG,yBAAyB,CAAC,OAAO,CAAC,CAAC;IAC3D,IAAI,eAAe,KAAK,IAAI;QAAE,OAAO,IAAI,CAAC;IAE1C,IAAI,CAAC;QACH,OAAO,QAAQ,CAAC,OAAO,CAAC,mBAAmB,CAAC,CAAC,OAAO,IAAI,eAAe,CAAC;IAC1E,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,KAAK,CAAC;IACf,CAAC;AACH,CAAC;AAED,SAAS,0BAA0B,CAAC,OAA+B;IACjE,MAAM,IAAI,GAAG;QACX,IAAI,EAAE,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,MAAM;QAC1C,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,oBAAoB,CAAC,OAAO,CAAC,EAAE,CAAC;QAChE,GAAG,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,SAAS,EAAE,IAAI,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;KACzE,CAAC;IACF,IAAI,CAAC,OAAO,CAAC,KAAK;QAAE,OAAO,IAAI,CAAC;IAEhC,OAAO;QACL,GAAG,IAAI;QACP,GAAG,EAAE,kBAAkB;QACvB,QAAQ,EAAE,kBAAkB;QAC5B,KAAK,EAAE,kBAAkB;QACzB,KAAK,EAAE,SAAS,EAAE;QAClB,UAAU,EAAE,MAAM;KACnB,CAAC;AACJ,CAAC;AAED,SAAS,SAAS;IAChB,OAAO;QACL,KAAK,EAAE,CAAC;QACR,MAAM,EAAE,CAAC;QACT,SAAS,EAAE,CAAC;QACZ,UAAU,EAAE,CAAC;QACb,WAAW,EAAE,CAAC;QACd,IAAI,EAAE,EAAE,KAAK,EAAE,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,SAAS,EAAE,CAAC,EAAE,UAAU,EAAE,CAAC,EAAE,KAAK,EAAE,CAAC,EAAE;KACrE,CAAC;AACJ,CAAC;AAED,SAAS,oBAAoB,CAAC,OAA+B;IAC3D,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC;IACxC,IAAI,OAAO,CAAC,KAAK;QAAE,OAAO,IAAI,CAAC;IAC/B,MAAM,SAAS,GAAG,OAAO,CAAC,QAAQ,IAAI,OAAO,CAAC,IAAI,IAAI,SAAS,CAAC;IAChE,MAAM,SAAS,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,oBAAoB,CAAC,IAAI,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;IACrF,OAAO,SAAS,CAAC,CAAC,CAAC,IAAI,SAAS,MAAM,SAAS,MAAM,IAAI,EAAE,CAAC,CAAC,CAAC,IAAI,SAAS,MAAM,IAAI,EAAE,CAAC;AAC1F,CAAC;AAED,SAAS,oBAAoB,CAAC,IAAU;IACtC,MAAM,MAAM,GAAG,CAAC,IAAI,CAAC,iBAAiB,EAAE,CAAC;IACzC,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,CAAC;IACrC,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;IAC7B,OAAO,CACL,GAAG,IAAI,CAAC,WAAW,EAAE,IAAI,GAAG,CAAC,IAAI,CAAC,QAAQ,EAAE,GAAG,CAAC,CAAC,IAAI,GAAG,CAAC,IAAI,CAAC,OAAO,EAAE,CAAC,GAAG;QAC3E,GAAG,GAAG,CAAC,IAAI,CAAC,QAAQ,EAAE,CAAC,IAAI,GAAG,CAAC,IAAI,CAAC,UAAU,EAAE,CAAC,IAAI,GAAG,CAAC,IAAI,CAAC,UAAU,EAAE,CAAC,EAAE;QAC7E,GAAG,IAAI,GAAG,GAAG,CAAC,IAAI,CAAC,KAAK,CAAC,GAAG,GAAG,EAAE,CAAC,CAAC,IAAI,GAAG,CAAC,GAAG,GAAG,EAAE,CAAC,EAAE,CACvD,CAAC;AACJ,CAAC;AAED,SAAS,GAAG,CAAC,CAAS;IACpB,OAAO,CAAC,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC;AACvC,CAAC","sourcesContent":["import { randomUUID } from \"crypto\";\nimport { mkdirSync, statSync } from \"fs\";\nimport { join } from \"path\";\nimport { isRecord, parseJsonValue, readTextFileIfExists } from \"./file-guards.js\";\nimport { atomicWritePrivateFile } from \"./fs-atomic.js\";\nimport type { ConversationLogMessage } from \"./context.js\";\nimport * as log from \"./log.js\";\n\nexport interface MaterializeTopLevelHistoryOptions {\n  conversationDir: string;\n  sessionDir: string;\n  cwd: string;\n  recentDays?: number;\n  maxMessages?: number;\n  now?: Date;\n}\n\nconst DEFAULT_RECENT_DAYS = 14;\nconst DEFAULT_MAX_MESSAGES = 200;\n\nexport function resolveUsableTopLevelHistorySession(\n  options: MaterializeTopLevelHistoryOptions & { existingSessionFile: string | null },\n): string | null {\n  if (options.existingSessionFile && isSessionFreshForTopLevelHistory(options)) {\n    return options.existingSessionFile;\n  }\n  return materializeTopLevelHistorySession(options);\n}\n\nexport function materializeTopLevelHistorySession(\n  options: MaterializeTopLevelHistoryOptions,\n): string | null {\n  const messages = readTopLevelHistoryMessages(options);\n  if (messages.length === 0) return null;\n\n  mkdirSync(options.sessionDir, { recursive: true });\n  const now = options.now ?? new Date();\n  const sessionId = randomUUID();\n  const filename = `${now.toISOString().replace(/[:.]/g, \"-\")}_${sessionId.slice(0, 8)}_history.jsonl`;\n  const sessionFile = join(options.sessionDir, filename);\n  const header = {\n    type: \"session\",\n    version: 3,\n    id: sessionId,\n    timestamp: now.toISOString(),\n    cwd: options.cwd,\n    source: {\n      kind: \"platform-history\",\n      file: \"log.jsonl\",\n      recentDays: options.recentDays ?? DEFAULT_RECENT_DAYS,\n    },\n  };\n  const entries = messages.map((message) => ({\n    type: \"message\",\n    id: randomUUID().slice(0, 8),\n    parentId: null,\n    timestamp: new Date(message.date ?? now.toISOString()).toISOString(),\n    message: buildHistorySessionMessage(message),\n  }));\n\n  const content = [header, ...entries].map((entry) => JSON.stringify(entry)).join(\"\\n\");\n  atomicWritePrivateFile(sessionFile, `${content}\\n`);\n  atomicWritePrivateFile(join(options.sessionDir, \"current\"), filename);\n  return sessionFile;\n}\n\nexport function latestTopLevelHistoryTime(\n  options: Omit<MaterializeTopLevelHistoryOptions, \"sessionDir\" | \"cwd\">,\n): number | null {\n  const messages = readTopLevelHistoryMessages({ ...options, maxMessages: 1 });\n  const latest = messages.at(-1);\n  if (!latest?.date) return null;\n  const ms = new Date(latest.date).getTime();\n  return Number.isFinite(ms) ? ms : null;\n}\n\nexport function readTopLevelHistoryMessages(\n  options: Omit<MaterializeTopLevelHistoryOptions, \"sessionDir\" | \"cwd\">,\n): ConversationLogMessage[] {\n  const logFile = join(options.conversationDir, \"log.jsonl\");\n  const raw = readTextFileIfExists(logFile);\n  if (raw === undefined) return [];\n\n  const nowMs = (options.now ?? new Date()).getTime();\n  const sinceMs = nowMs - (options.recentDays ?? DEFAULT_RECENT_DAYS) * 24 * 60 * 60 * 1000;\n  const messages: ConversationLogMessage[] = [];\n  const lines = raw.trim().split(\"\\n\").filter(Boolean);\n\n  for (let i = 0; i < lines.length; i++) {\n    try {\n      const entry = parseJsonValue(\n        lines[i],\n        (value): value is ConversationLogMessage => isRecord(value),\n        (detail) => (detail === \"unexpected JSON shape\" ? \"expected a JSON object\" : detail),\n      );\n      if (entry.threadTs) continue;\n      if (!entry.text?.trim()) continue;\n      if (entry.date) {\n        const dateMs = new Date(entry.date).getTime();\n        if (Number.isFinite(dateMs) && dateMs < sinceMs) continue;\n      }\n      messages.push(entry);\n    } catch (err) {\n      log.logWarning(\n        `Skipping malformed log entry at ${logFile}:${i + 1}`,\n        err instanceof Error ? err.message : String(err),\n      );\n    }\n  }\n\n  return messages.slice(-(options.maxMessages ?? DEFAULT_MAX_MESSAGES));\n}\n\nfunction isSessionFreshForTopLevelHistory(\n  options: MaterializeTopLevelHistoryOptions & { existingSessionFile: string | null },\n): boolean {\n  if (!options.existingSessionFile) return false;\n  const latestHistoryMs = latestTopLevelHistoryTime(options);\n  if (latestHistoryMs === null) return true;\n\n  try {\n    return statSync(options.existingSessionFile).mtimeMs >= latestHistoryMs;\n  } catch {\n    return false;\n  }\n}\n\nfunction buildHistorySessionMessage(message: ConversationLogMessage): object {\n  const base = {\n    role: message.isBot ? \"assistant\" : \"user\",\n    content: [{ type: \"text\", text: formatHistoryMessage(message) }],\n    ...(message.date ? { timestamp: new Date(message.date).getTime() } : {}),\n  };\n  if (!message.isBot) return base;\n\n  return {\n    ...base,\n    api: \"platform-history\",\n    provider: \"platform-history\",\n    model: \"platform-history\",\n    usage: zeroUsage(),\n    stopReason: \"stop\",\n  };\n}\n\nfunction zeroUsage(): object {\n  return {\n    input: 0,\n    output: 0,\n    cacheRead: 0,\n    cacheWrite: 0,\n    totalTokens: 0,\n    cost: { input: 0, output: 0, cacheRead: 0, cacheWrite: 0, total: 0 },\n  };\n}\n\nfunction formatHistoryMessage(message: ConversationLogMessage): string {\n  const text = message.text?.trim() ?? \"\";\n  if (message.isBot) return text;\n  const userLabel = message.userName || message.user || \"unknown\";\n  const timestamp = message.date ? formatLocalTimestamp(new Date(message.date)) : null;\n  return timestamp ? `[${timestamp}] [${userLabel}]: ${text}` : `[${userLabel}]: ${text}`;\n}\n\nfunction formatLocalTimestamp(date: Date): string {\n  const offset = -date.getTimezoneOffset();\n  const sign = offset >= 0 ? \"+\" : \"-\";\n  const abs = Math.abs(offset);\n  return (\n    `${date.getFullYear()}-${pad(date.getMonth() + 1)}-${pad(date.getDate())} ` +\n    `${pad(date.getHours())}:${pad(date.getMinutes())}:${pad(date.getSeconds())}` +\n    `${sign}${pad(Math.floor(abs / 60))}:${pad(abs % 60)}`\n  );\n}\n\nfunction pad(n: number): string {\n  return n.toString().padStart(2, \"0\");\n}\n"]}

package/dist/download.d.ts

@@ -0,0 +1,2 @@
+export declare function downloadChannel(channelId: string, botToken: string): Promise<void>;
+//# sourceMappingURL=download.d.ts.map

package/dist/download.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"download.d.ts","sourceRoot":"","sources":["../src/download.ts"],"names":[],"mappings":"AA6BA,wBAAsB,eAAe,CAAC,SAAS,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAuFxF","sourcesContent":["import { LogLevel, WebClient } from \"@slack/web-api\";\n\ninterface Message {\n  ts: string;\n  user?: string;\n  text?: string;\n  thread_ts?: string;\n  reply_count?: number;\n  files?: Array<{ name: string; url_private?: string }>;\n}\n\nfunction formatTs(ts: string): string {\n  const date = new Date(parseFloat(ts) * 1000);\n  return date\n    .toISOString()\n    .replace(\"T\", \" \")\n    .replace(/\\.\\d+Z$/, \"\");\n}\n\nfunction formatMessage(ts: string, user: string, text: string, indent = \"\"): string {\n  const prefix = `[${formatTs(ts)}] ${user}: `;\n  const lines = text.split(\"\\n\");\n  const firstLine = `${indent}${prefix}${lines[0]}`;\n  if (lines.length === 1) return firstLine;\n  // All continuation lines get same indent as content start\n  const contentIndent = indent + \" \".repeat(prefix.length);\n  return [firstLine, ...lines.slice(1).map((l) => contentIndent + l)].join(\"\\n\");\n}\n\nexport async function downloadChannel(channelId: string, botToken: string): Promise<void> {\n  const client = new WebClient(botToken, { logLevel: LogLevel.ERROR });\n\n  console.error(`Fetching channel info for ${channelId}...`);\n\n  // Get channel info\n  let channelName = channelId;\n  try {\n    const info = await client.conversations.info({ channel: channelId });\n    channelName = typeof info.channel?.name === \"string\" ? info.channel.name : channelId;\n  } catch {\n    // DM channels don't have names, that's fine\n  }\n\n  console.error(`Downloading history for #${channelName} (${channelId})...`);\n\n  // Fetch all messages\n  const messages: Message[] = [];\n  let cursor: string | undefined;\n\n  do {\n    const response = await client.conversations.history({\n      channel: channelId,\n      limit: 200,\n      cursor,\n    });\n\n    if (response.messages) {\n      messages.push(...(response.messages as Message[]));\n    }\n\n    cursor = response.response_metadata?.next_cursor;\n    console.error(`  Fetched ${messages.length} messages...`);\n  } while (cursor);\n\n  // Reverse to chronological order\n  messages.reverse();\n\n  // Build map of thread replies\n  const threadReplies = new Map<string, Message[]>();\n  const threadsToFetch = messages.filter((m) => m.reply_count && m.reply_count > 0);\n\n  console.error(`Fetching ${threadsToFetch.length} threads...`);\n\n  for (let i = 0; i < threadsToFetch.length; i++) {\n    const parent = threadsToFetch[i];\n    console.error(`  Thread ${i + 1}/${threadsToFetch.length} (${parent.reply_count} replies)...`);\n\n    const replies: Message[] = [];\n    let threadCursor: string | undefined;\n\n    do {\n      const response = await client.conversations.replies({\n        channel: channelId,\n        ts: parent.ts,\n        limit: 200,\n        cursor: threadCursor,\n      });\n\n      if (response.messages) {\n        // Skip the first message (it's the parent)\n        replies.push(...(response.messages as Message[]).slice(1));\n      }\n\n      threadCursor = response.response_metadata?.next_cursor;\n    } while (threadCursor);\n\n    threadReplies.set(parent.ts, replies);\n  }\n\n  // Output messages with thread replies interleaved\n  let totalReplies = 0;\n  for (const msg of messages) {\n    // Output the message\n    console.log(formatMessage(msg.ts, msg.user || \"unknown\", msg.text || \"\"));\n\n    // Output thread replies right after parent (indented)\n    const replies = threadReplies.get(msg.ts);\n    if (replies) {\n      for (const reply of replies) {\n        console.log(formatMessage(reply.ts, reply.user || \"unknown\", reply.text || \"\", \"  \"));\n        totalReplies++;\n      }\n    }\n  }\n\n  console.error(`Done! ${messages.length} messages, ${totalReplies} thread replies`);\n}\n"]}

package/dist/download.js

@@ -0,0 +1,89 @@
+import { LogLevel, WebClient } from "@slack/web-api";
+function formatTs(ts) {
+    const date = new Date(parseFloat(ts) * 1000);
+    return date
+        .toISOString()
+        .replace("T", " ")
+        .replace(/\.\d+Z$/, "");
+}
+function formatMessage(ts, user, text, indent = "") {
+    const prefix = `[${formatTs(ts)}] ${user}: `;
+    const lines = text.split("\n");
+    const firstLine = `${indent}${prefix}${lines[0]}`;
+    if (lines.length === 1)
+        return firstLine;
+    // All continuation lines get same indent as content start
+    const contentIndent = indent + " ".repeat(prefix.length);
+    return [firstLine, ...lines.slice(1).map((l) => contentIndent + l)].join("\n");
+}
+export async function downloadChannel(channelId, botToken) {
+    const client = new WebClient(botToken, { logLevel: LogLevel.ERROR });
+    console.error(`Fetching channel info for ${channelId}...`);
+    // Get channel info
+    let channelName = channelId;
+    try {
+        const info = await client.conversations.info({ channel: channelId });
+        channelName = typeof info.channel?.name === "string" ? info.channel.name : channelId;
+    }
+    catch {
+        // DM channels don't have names, that's fine
+    }
+    console.error(`Downloading history for #${channelName} (${channelId})...`);
+    // Fetch all messages
+    const messages = [];
+    let cursor;
+    do {
+        const response = await client.conversations.history({
+            channel: channelId,
+            limit: 200,
+            cursor,
+        });
+        if (response.messages) {
+            messages.push(...response.messages);
+        }
+        cursor = response.response_metadata?.next_cursor;
+        console.error(`  Fetched ${messages.length} messages...`);
+    } while (cursor);
+    // Reverse to chronological order
+    messages.reverse();
+    // Build map of thread replies
+    const threadReplies = new Map();
+    const threadsToFetch = messages.filter((m) => m.reply_count && m.reply_count > 0);
+    console.error(`Fetching ${threadsToFetch.length} threads...`);
+    for (let i = 0; i < threadsToFetch.length; i++) {
+        const parent = threadsToFetch[i];
+        console.error(`  Thread ${i + 1}/${threadsToFetch.length} (${parent.reply_count} replies)...`);
+        const replies = [];
+        let threadCursor;
+        do {
+            const response = await client.conversations.replies({
+                channel: channelId,
+                ts: parent.ts,
+                limit: 200,
+                cursor: threadCursor,
+            });
+            if (response.messages) {
+                // Skip the first message (it's the parent)
+                replies.push(...response.messages.slice(1));
+            }
+            threadCursor = response.response_metadata?.next_cursor;
+        } while (threadCursor);
+        threadReplies.set(parent.ts, replies);
+    }
+    // Output messages with thread replies interleaved
+    let totalReplies = 0;
+    for (const msg of messages) {
+        // Output the message
+        console.log(formatMessage(msg.ts, msg.user || "unknown", msg.text || ""));
+        // Output thread replies right after parent (indented)
+        const replies = threadReplies.get(msg.ts);
+        if (replies) {
+            for (const reply of replies) {
+                console.log(formatMessage(reply.ts, reply.user || "unknown", reply.text || "", "  "));
+                totalReplies++;
+            }
+        }
+    }
+    console.error(`Done! ${messages.length} messages, ${totalReplies} thread replies`);
+}
+//# sourceMappingURL=download.js.map

package/dist/download.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"download.js","sourceRoot":"","sources":["../src/download.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAWrD,SAAS,QAAQ,CAAC,EAAU;IAC1B,MAAM,IAAI,GAAG,IAAI,IAAI,CAAC,UAAU,CAAC,EAAE,CAAC,GAAG,IAAI,CAAC,CAAC;IAC7C,OAAO,IAAI;SACR,WAAW,EAAE;SACb,OAAO,CAAC,GAAG,EAAE,GAAG,CAAC;SACjB,OAAO,CAAC,SAAS,EAAE,EAAE,CAAC,CAAC;AAC5B,CAAC;AAED,SAAS,aAAa,CAAC,EAAU,EAAE,IAAY,EAAE,IAAY,EAAE,MAAM,GAAG,EAAE;IACxE,MAAM,MAAM,GAAG,IAAI,QAAQ,CAAC,EAAE,CAAC,KAAK,IAAI,IAAI,CAAC;IAC7C,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;IAC/B,MAAM,SAAS,GAAG,GAAG,MAAM,GAAG,MAAM,GAAG,KAAK,CAAC,CAAC,CAAC,EAAE,CAAC;IAClD,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,SAAS,CAAC;IACzC,0DAA0D;IAC1D,MAAM,aAAa,GAAG,MAAM,GAAG,GAAG,CAAC,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;IACzD,OAAO,CAAC,SAAS,EAAE,GAAG,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,aAAa,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AACjF,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,eAAe,CAAC,SAAiB,EAAE,QAAgB;IACvE,MAAM,MAAM,GAAG,IAAI,SAAS,CAAC,QAAQ,EAAE,EAAE,QAAQ,EAAE,QAAQ,CAAC,KAAK,EAAE,CAAC,CAAC;IAErE,OAAO,CAAC,KAAK,CAAC,6BAA6B,SAAS,KAAK,CAAC,CAAC;IAE3D,mBAAmB;IACnB,IAAI,WAAW,GAAG,SAAS,CAAC;IAC5B,IAAI,CAAC;QACH,MAAM,IAAI,GAAG,MAAM,MAAM,CAAC,aAAa,CAAC,IAAI,CAAC,EAAE,OAAO,EAAE,SAAS,EAAE,CAAC,CAAC;QACrE,WAAW,GAAG,OAAO,IAAI,CAAC,OAAO,EAAE,IAAI,KAAK,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,SAAS,CAAC;IACvF,CAAC;IAAC,MAAM,CAAC;QACP,4CAA4C;IAC9C,CAAC;IAED,OAAO,CAAC,KAAK,CAAC,4BAA4B,WAAW,KAAK,SAAS,MAAM,CAAC,CAAC;IAE3E,qBAAqB;IACrB,MAAM,QAAQ,GAAc,EAAE,CAAC;IAC/B,IAAI,MAA0B,CAAC;IAE/B,GAAG,CAAC;QACF,MAAM,QAAQ,GAAG,MAAM,MAAM,CAAC,aAAa,CAAC,OAAO,CAAC;YAClD,OAAO,EAAE,SAAS;YAClB,KAAK,EAAE,GAAG;YACV,MAAM;SACP,CAAC,CAAC;QAEH,IAAI,QAAQ,CAAC,QAAQ,EAAE,CAAC;YACtB,QAAQ,CAAC,IAAI,CAAC,GAAI,QAAQ,CAAC,QAAsB,CAAC,CAAC;QACrD,CAAC;QAED,MAAM,GAAG,QAAQ,CAAC,iBAAiB,EAAE,WAAW,CAAC;QACjD,OAAO,CAAC,KAAK,CAAC,aAAa,QAAQ,CAAC,MAAM,cAAc,CAAC,CAAC;IAC5D,CAAC,QAAQ,MAAM,EAAE;IAEjB,iCAAiC;IACjC,QAAQ,CAAC,OAAO,EAAE,CAAC;IAEnB,8BAA8B;IAC9B,MAAM,aAAa,GAAG,IAAI,GAAG,EAAqB,CAAC;IACnD,MAAM,cAAc,GAAG,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,WAAW,IAAI,CAAC,CAAC,WAAW,GAAG,CAAC,CAAC,CAAC;IAElF,OAAO,CAAC,KAAK,CAAC,YAAY,cAAc,CAAC,MAAM,aAAa,CAAC,CAAC;IAE9D,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,cAAc,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;QAC/C,MAAM,MAAM,GAAG,cAAc,CAAC,CAAC,CAAC,CAAC;QACjC,OAAO,CAAC,KAAK,CAAC,YAAY,CAAC,GAAG,CAAC,IAAI,cAAc,CAAC,MAAM,KAAK,MAAM,CAAC,WAAW,cAAc,CAAC,CAAC;QAE/F,MAAM,OAAO,GAAc,EAAE,CAAC;QAC9B,IAAI,YAAgC,CAAC;QAErC,GAAG,CAAC;YACF,MAAM,QAAQ,GAAG,MAAM,MAAM,CAAC,aAAa,CAAC,OAAO,CAAC;gBAClD,OAAO,EAAE,SAAS;gBAClB,EAAE,EAAE,MAAM,CAAC,EAAE;gBACb,KAAK,EAAE,GAAG;gBACV,MAAM,EAAE,YAAY;aACrB,CAAC,CAAC;YAEH,IAAI,QAAQ,CAAC,QAAQ,EAAE,CAAC;gBACtB,2CAA2C;gBAC3C,OAAO,CAAC,IAAI,CAAC,GAAI,QAAQ,CAAC,QAAsB,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC;YAC7D,CAAC;YAED,YAAY,GAAG,QAAQ,CAAC,iBAAiB,EAAE,WAAW,CAAC;QACzD,CAAC,QAAQ,YAAY,EAAE;QAEvB,aAAa,CAAC,GAAG,CAAC,MAAM,CAAC,EAAE,EAAE,OAAO,CAAC,CAAC;IACxC,CAAC;IAED,kDAAkD;IAClD,IAAI,YAAY,GAAG,CAAC,CAAC;IACrB,KAAK,MAAM,GAAG,IAAI,QAAQ,EAAE,CAAC;QAC3B,qBAAqB;QACrB,OAAO,CAAC,GAAG,CAAC,aAAa,CAAC,GAAG,CAAC,EAAE,EAAE,GAAG,CAAC,IAAI,IAAI,SAAS,EAAE,GAAG,CAAC,IAAI,IAAI,EAAE,CAAC,CAAC,CAAC;QAE1E,sDAAsD;QACtD,MAAM,OAAO,GAAG,aAAa,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;QAC1C,IAAI,OAAO,EAAE,CAAC;YACZ,KAAK,MAAM,KAAK,IAAI,OAAO,EAAE,CAAC;gBAC5B,OAAO,CAAC,GAAG,CAAC,aAAa,CAAC,KAAK,CAAC,EAAE,EAAE,KAAK,CAAC,IAAI,IAAI,SAAS,EAAE,KAAK,CAAC,IAAI,IAAI,EAAE,EAAE,IAAI,CAAC,CAAC,CAAC;gBACtF,YAAY,EAAE,CAAC;YACjB,CAAC;QACH,CAAC;IACH,CAAC;IAED,OAAO,CAAC,KAAK,CAAC,SAAS,QAAQ,CAAC,MAAM,cAAc,YAAY,iBAAiB,CAAC,CAAC;AACrF,CAAC","sourcesContent":["import { LogLevel, WebClient } from \"@slack/web-api\";\n\ninterface Message {\n  ts: string;\n  user?: string;\n  text?: string;\n  thread_ts?: string;\n  reply_count?: number;\n  files?: Array<{ name: string; url_private?: string }>;\n}\n\nfunction formatTs(ts: string): string {\n  const date = new Date(parseFloat(ts) * 1000);\n  return date\n    .toISOString()\n    .replace(\"T\", \" \")\n    .replace(/\\.\\d+Z$/, \"\");\n}\n\nfunction formatMessage(ts: string, user: string, text: string, indent = \"\"): string {\n  const prefix = `[${formatTs(ts)}] ${user}: `;\n  const lines = text.split(\"\\n\");\n  const firstLine = `${indent}${prefix}${lines[0]}`;\n  if (lines.length === 1) return firstLine;\n  // All continuation lines get same indent as content start\n  const contentIndent = indent + \" \".repeat(prefix.length);\n  return [firstLine, ...lines.slice(1).map((l) => contentIndent + l)].join(\"\\n\");\n}\n\nexport async function downloadChannel(channelId: string, botToken: string): Promise<void> {\n  const client = new WebClient(botToken, { logLevel: LogLevel.ERROR });\n\n  console.error(`Fetching channel info for ${channelId}...`);\n\n  // Get channel info\n  let channelName = channelId;\n  try {\n    const info = await client.conversations.info({ channel: channelId });\n    channelName = typeof info.channel?.name === \"string\" ? info.channel.name : channelId;\n  } catch {\n    // DM channels don't have names, that's fine\n  }\n\n  console.error(`Downloading history for #${channelName} (${channelId})...`);\n\n  // Fetch all messages\n  const messages: Message[] = [];\n  let cursor: string | undefined;\n\n  do {\n    const response = await client.conversations.history({\n      channel: channelId,\n      limit: 200,\n      cursor,\n    });\n\n    if (response.messages) {\n      messages.push(...(response.messages as Message[]));\n    }\n\n    cursor = response.response_metadata?.next_cursor;\n    console.error(`  Fetched ${messages.length} messages...`);\n  } while (cursor);\n\n  // Reverse to chronological order\n  messages.reverse();\n\n  // Build map of thread replies\n  const threadReplies = new Map<string, Message[]>();\n  const threadsToFetch = messages.filter((m) => m.reply_count && m.reply_count > 0);\n\n  console.error(`Fetching ${threadsToFetch.length} threads...`);\n\n  for (let i = 0; i < threadsToFetch.length; i++) {\n    const parent = threadsToFetch[i];\n    console.error(`  Thread ${i + 1}/${threadsToFetch.length} (${parent.reply_count} replies)...`);\n\n    const replies: Message[] = [];\n    let threadCursor: string | undefined;\n\n    do {\n      const response = await client.conversations.replies({\n        channel: channelId,\n        ts: parent.ts,\n        limit: 200,\n        cursor: threadCursor,\n      });\n\n      if (response.messages) {\n        // Skip the first message (it's the parent)\n        replies.push(...(response.messages as Message[]).slice(1));\n      }\n\n      threadCursor = response.response_metadata?.next_cursor;\n    } while (threadCursor);\n\n    threadReplies.set(parent.ts, replies);\n  }\n\n  // Output messages with thread replies interleaved\n  let totalReplies = 0;\n  for (const msg of messages) {\n    // Output the message\n    console.log(formatMessage(msg.ts, msg.user || \"unknown\", msg.text || \"\"));\n\n    // Output thread replies right after parent (indented)\n    const replies = threadReplies.get(msg.ts);\n    if (replies) {\n      for (const reply of replies) {\n        console.log(formatMessage(reply.ts, reply.user || \"unknown\", reply.text || \"\", \"  \"));\n        totalReplies++;\n      }\n    }\n  }\n\n  console.error(`Done! ${messages.length} messages, ${totalReplies} thread replies`);\n}\n"]}

package/dist/env.d.ts

@@ -0,0 +1,3 @@
+export declare function readEnv(name: string): string | undefined;
+export declare function setEnvAliases(name: string, value: string): void;
+//# sourceMappingURL=env.d.ts.map

package/dist/env.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"env.d.ts","sourceRoot":"","sources":["../src/env.ts"],"names":[],"mappings":"AAAA,wBAAgB,OAAO,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAMxD;AAED,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI,CAG/D","sourcesContent":["export function readEnv(name: string): string | undefined {\n  const raw = process.env[name]?.trim();\n  if (raw) return raw;\n\n  const prefixed = process.env[`MIKAN_${name}`]?.trim();\n  return prefixed || undefined;\n}\n\nexport function setEnvAliases(name: string, value: string): void {\n  process.env[name] = value;\n  process.env[`MIKAN_${name}`] = value;\n}\n"]}

package/dist/env.js

@@ -0,0 +1,12 @@
+export function readEnv(name) {
+    const raw = process.env[name]?.trim();
+    if (raw)
+        return raw;
+    const prefixed = process.env[`MIKAN_${name}`]?.trim();
+    return prefixed || undefined;
+}
+export function setEnvAliases(name, value) {
+    process.env[name] = value;
+    process.env[`MIKAN_${name}`] = value;
+}
+//# sourceMappingURL=env.js.map

package/dist/env.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"env.js","sourceRoot":"","sources":["../src/env.ts"],"names":[],"mappings":"AAAA,MAAM,UAAU,OAAO,CAAC,IAAY;IAClC,MAAM,GAAG,GAAG,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,CAAC;IACtC,IAAI,GAAG;QAAE,OAAO,GAAG,CAAC;IAEpB,MAAM,QAAQ,GAAG,OAAO,CAAC,GAAG,CAAC,SAAS,IAAI,EAAE,CAAC,EAAE,IAAI,EAAE,CAAC;IACtD,OAAO,QAAQ,IAAI,SAAS,CAAC;AAC/B,CAAC;AAED,MAAM,UAAU,aAAa,CAAC,IAAY,EAAE,KAAa;IACvD,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,GAAG,KAAK,CAAC;IAC1B,OAAO,CAAC,GAAG,CAAC,SAAS,IAAI,EAAE,CAAC,GAAG,KAAK,CAAC;AACvC,CAAC","sourcesContent":["export function readEnv(name: string): string | undefined {\n  const raw = process.env[name]?.trim();\n  if (raw) return raw;\n\n  const prefixed = process.env[`MIKAN_${name}`]?.trim();\n  return prefixed || undefined;\n}\n\nexport function setEnvAliases(name: string, value: string): void {\n  process.env[name] = value;\n  process.env[`MIKAN_${name}`] = value;\n}\n"]}

package/dist/events.d.ts

@@ -0,0 +1,85 @@
+import type { Bot, ConversationKind } from "./adapter.js";
+export interface ImmediateEvent {
+    type: "immediate";
+    platform: string;
+    conversationId: string;
+    conversationKind: ConversationKind;
+    /** Creator userId — routes tool execution to that user's vault selection when fired. */
+    userId?: string;
+    text: string;
+}
+export interface OneShotEvent {
+    type: "one-shot";
+    platform: string;
+    conversationId: string;
+    conversationKind: ConversationKind;
+    userId?: string;
+    text: string;
+    at: string;
+}
+export interface PeriodicEvent {
+    type: "periodic";
+    platform: string;
+    conversationId: string;
+    conversationKind: ConversationKind;
+    userId?: string;
+    text: string;
+    schedule: string;
+    timezone: string;
+}
+export type MikanEvent = ImmediateEvent | OneShotEvent | PeriodicEvent;
+export interface PeriodicEventInfo {
+    filename: string;
+    platform: string;
+    conversationId: string;
+    conversationKind: ConversationKind;
+    text: string;
+    schedule: string;
+    timezone: string;
+    nextRun: string | null;
+}
+export declare class EventsWatcher {
+    private eventsDir;
+    private botsByPlatform;
+    private timers;
+    private timerEventTypes;
+    private crons;
+    private debounceTimers;
+    private startTime;
+    private watcher;
+    private knownFiles;
+    constructor(eventsDir: string, botsByPlatform: Record<string, Bot>);
+    /**
+     * Start watching for events. Call this after platform bots are initialized.
+     */
+    start(): void;
+    /**
+     * Stop watching and cancel all scheduled events.
+     */
+    stop(): void;
+    /**
+     * Return all active periodic (cron) events with their next run time.
+     */
+    getPeriodicEvents(): PeriodicEventInfo[];
+    private debounce;
+    private scanExisting;
+    private handleFileChange;
+    private handleDelete;
+    private cancelScheduled;
+    private handleFile;
+    private parseEvent;
+    private resolvePlatform;
+    private resolveConversationKind;
+    private handleImmediate;
+    private handleOneShot;
+    private handlePeriodic;
+    private execute;
+    private buildEventPrompt;
+    private deleteFile;
+    private sleep;
+}
+/**
+ * Create an events watcher for all configured platforms.
+ */
+export declare function createEventsWatcher(workspaceDir: string, botsByPlatform: Record<string, Bot>): EventsWatcher;
+//# sourceMappingURL=events.d.ts.map

package/dist/events.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"events.d.ts","sourceRoot":"","sources":["../src/events.ts"],"names":[],"mappings":"AAaA,OAAO,KAAK,EAAE,GAAG,EAAY,gBAAgB,EAAE,MAAM,cAAc,CAAC;AAMpE,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,WAAW,CAAC;IAClB,QAAQ,EAAE,MAAM,CAAC;IACjB,cAAc,EAAE,MAAM,CAAC;IACvB,gBAAgB,EAAE,gBAAgB,CAAC;IACnC,wFAAwF;IACxF,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,MAAM,CAAC;CACd;AAED,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,UAAU,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;IACjB,cAAc,EAAE,MAAM,CAAC;IACvB,gBAAgB,EAAE,gBAAgB,CAAC;IACnC,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,MAAM,CAAC;IACb,EAAE,EAAE,MAAM,CAAC;CAEZ;AAED,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,UAAU,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;IACjB,cAAc,EAAE,MAAM,CAAC;IACvB,gBAAgB,EAAE,gBAAgB,CAAC;IACnC,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,MAAM,UAAU,GAAG,cAAc,GAAG,YAAY,GAAG,aAAa,CAAC;AAmBvE,MAAM,WAAW,iBAAiB;IAChC,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;IACjB,cAAc,EAAE,MAAM,CAAC;IACvB,gBAAgB,EAAE,gBAAgB,CAAC;IACnC,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;CACxB;AAMD,qBAAa,aAAa;IAUtB,OAAO,CAAC,SAAS;IACjB,OAAO,CAAC,cAAc;IAVxB,OAAO,CAAC,MAAM,CAA0C;IACxD,OAAO,CAAC,eAAe,CAAsC;IAC7D,OAAO,CAAC,KAAK,CAAgC;IAC7C,OAAO,CAAC,cAAc,CAA0C;IAChE,OAAO,CAAC,SAAS,CAAS;IAC1B,OAAO,CAAC,OAAO,CAA0B;IACzC,OAAO,CAAC,UAAU,CAA0B;IAE5C,YACU,SAAS,EAAE,MAAM,EACjB,cAAc,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,EAG5C;IAED;;OAEG;IACH,KAAK,IAAI,IAAI,CAmBZ;IAED;;OAEG;IACH,IAAI,IAAI,IAAI,CA4BX;IAED;;OAEG;IACH,iBAAiB,IAAI,iBAAiB,EAAE,CA0BvC;IAED,OAAO,CAAC,QAAQ;IAchB,OAAO,CAAC,YAAY;IAcpB,OAAO,CAAC,gBAAgB;YAoBV,YAAY;IA0B1B,OAAO,CAAC,eAAe;YAkBT,UAAU;IAiDxB,OAAO,CAAC,UAAU;IA0ElB,OAAO,CAAC,eAAe;IAsBvB,OAAO,CAAC,uBAAuB;IAY/B,OAAO,CAAC,eAAe;IAoBvB,OAAO,CAAC,aAAa;IA4BrB,OAAO,CAAC,cAAc;IAmBtB,OAAO,CAAC,OAAO;IAuEf,OAAO,CAAC,gBAAgB;IA0BxB,OAAO,CAAC,UAAU;IAclB,OAAO,CAAC,KAAK;CAGd;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CACjC,YAAY,EAAE,MAAM,EACpB,cAAc,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAClC,aAAa,CAGf","sourcesContent":["import { Type, type Static } from \"@sinclair/typebox\";\nimport { Cron } from \"croner\";\nimport {\n  existsSync,\n  type FSWatcher,\n  readdirSync,\n  readFileSync,\n  statSync,\n  unlinkSync,\n  watch,\n} from \"fs\";\nimport { readFile } from \"fs/promises\";\nimport { join } from \"path\";\nimport type { Bot, BotEvent, ConversationKind } from \"./adapter.js\";\nimport { ensureDirExists, parseJsonSchemaValue } from \"./file-guards.js\";\nimport * as log from \"./log.js\";\nimport { reportUserFacingError } from \"./sentry.js\";\nimport { inferConversationKind } from \"./sessions/policy.js\";\n\nexport interface ImmediateEvent {\n  type: \"immediate\";\n  platform: string;\n  conversationId: string;\n  conversationKind: ConversationKind;\n  /** Creator userId — routes tool execution to that user's vault selection when fired. */\n  userId?: string;\n  text: string;\n}\n\nexport interface OneShotEvent {\n  type: \"one-shot\";\n  platform: string;\n  conversationId: string;\n  conversationKind: ConversationKind;\n  userId?: string;\n  text: string;\n  at: string; // ISO 8601 with timezone offset\n  // No sessionKey or threadTs: reminders fire as top-level messages regardless of where they were created.\n}\n\nexport interface PeriodicEvent {\n  type: \"periodic\";\n  platform: string;\n  conversationId: string;\n  conversationKind: ConversationKind;\n  userId?: string;\n  text: string;\n  schedule: string; // cron syntax\n  timezone: string; // IANA timezone\n}\n\nexport type MikanEvent = ImmediateEvent | OneShotEvent | PeriodicEvent;\n\nconst EventFileSchema = Type.Object({\n  type: Type.Optional(\n    Type.Union([Type.Literal(\"immediate\"), Type.Literal(\"one-shot\"), Type.Literal(\"periodic\")]),\n  ),\n  platform: Type.Optional(Type.String()),\n  conversationId: Type.Optional(Type.String()),\n  channelId: Type.Optional(Type.String()),\n  conversationKind: Type.Optional(Type.Union([Type.Literal(\"direct\"), Type.Literal(\"shared\")])),\n  userId: Type.Optional(Type.String()),\n  text: Type.Optional(Type.String()),\n  at: Type.Optional(Type.String()),\n  schedule: Type.Optional(Type.String()),\n  timezone: Type.Optional(Type.String()),\n});\n\ntype EventFileData = Static<typeof EventFileSchema>;\n\nexport interface PeriodicEventInfo {\n  filename: string;\n  platform: string;\n  conversationId: string;\n  conversationKind: ConversationKind;\n  text: string;\n  schedule: string;\n  timezone: string;\n  nextRun: string | null; // ISO 8601\n}\n\nconst DEBOUNCE_MS = 100;\nconst MAX_RETRIES = 3;\nconst RETRY_BASE_MS = 100;\n\nexport class EventsWatcher {\n  private timers: Map<string, NodeJS.Timeout> = new Map();\n  private timerEventTypes: Map<string, \"one-shot\"> = new Map();\n  private crons: Map<string, Cron> = new Map();\n  private debounceTimers: Map<string, NodeJS.Timeout> = new Map();\n  private startTime: number;\n  private watcher: FSWatcher | null = null;\n  private knownFiles: Set<string> = new Set();\n\n  constructor(\n    private eventsDir: string,\n    private botsByPlatform: Record<string, Bot>,\n  ) {\n    this.startTime = Date.now();\n  }\n\n  /**\n   * Start watching for events. Call this after platform bots are initialized.\n   */\n  start(): void {\n    // Ensure events directory exists\n    ensureDirExists(this.eventsDir);\n\n    log.logInfo(`Events watcher starting, dir: ${this.eventsDir}`);\n\n    // Scan existing files\n    this.scanExisting();\n\n    // Watch for changes\n    this.watcher = watch(this.eventsDir, (eventType, filename) => {\n      if (!filename || !filename.endsWith(\".json\")) return;\n      log.logInfo(\n        `Events watcher fs event: ${String(eventType)} ${filename} (exists=${existsSync(join(this.eventsDir, filename))})`,\n      );\n      this.debounce(filename, () => this.handleFileChange(filename));\n    });\n\n    log.logInfo(`Events watcher started, tracking ${this.knownFiles.size} files`);\n  }\n\n  /**\n   * Stop watching and cancel all scheduled events.\n   */\n  stop(): void {\n    // Stop fs watcher\n    if (this.watcher) {\n      this.watcher.close();\n      this.watcher = null;\n    }\n\n    // Cancel all debounce timers\n    for (const timer of this.debounceTimers.values()) {\n      clearTimeout(timer);\n    }\n    this.debounceTimers.clear();\n\n    // Cancel all scheduled timers\n    for (const timer of this.timers.values()) {\n      clearTimeout(timer);\n    }\n    this.timers.clear();\n    this.timerEventTypes.clear();\n\n    // Cancel all cron jobs\n    for (const cron of this.crons.values()) {\n      cron.stop();\n    }\n    this.crons.clear();\n\n    this.knownFiles.clear();\n    log.logInfo(\"Events watcher stopped\");\n  }\n\n  /**\n   * Return all active periodic (cron) events with their next run time.\n   */\n  getPeriodicEvents(): PeriodicEventInfo[] {\n    const results: PeriodicEventInfo[] = [];\n    for (const [filename, cron] of this.crons) {\n      const filePath = join(this.eventsDir, filename);\n      try {\n        const content = readFileSync(filePath, \"utf-8\");\n        const data = this.parseEvent(content, filename);\n        if (!data || data.type !== \"periodic\") {\n          continue;\n        }\n        const next = cron.nextRun();\n        results.push({\n          filename,\n          platform: data.platform,\n          conversationId: data.conversationId,\n          conversationKind: data.conversationKind,\n          text: data.text,\n          schedule: data.schedule,\n          timezone: data.timezone,\n          nextRun: next?.toISOString() ?? null,\n        });\n      } catch {\n        // File may have been deleted or corrupted, skip\n      }\n    }\n    return results;\n  }\n\n  private debounce(filename: string, fn: () => void): void {\n    const existing = this.debounceTimers.get(filename);\n    if (existing) {\n      clearTimeout(existing);\n    }\n    this.debounceTimers.set(\n      filename,\n      setTimeout(() => {\n        this.debounceTimers.delete(filename);\n        fn();\n      }, DEBOUNCE_MS),\n    );\n  }\n\n  private scanExisting(): void {\n    let files: string[];\n    try {\n      files = readdirSync(this.eventsDir).filter((f) => f.endsWith(\".json\"));\n    } catch (err) {\n      log.logWarning(\"Failed to read events directory\", String(err));\n      return;\n    }\n\n    for (const filename of files) {\n      this.handleFile(filename);\n    }\n  }\n\n  private handleFileChange(filename: string): void {\n    const filePath = join(this.eventsDir, filename);\n    const exists = existsSync(filePath);\n    const known = this.knownFiles.has(filename);\n    log.logInfo(`Handling event file change: ${filename} (exists=${exists}, known=${known})`);\n\n    if (!exists) {\n      // fs.watch can briefly report a file as missing during create/rename churn.\n      // Confirm deletion before canceling scheduled events.\n      void this.handleDelete(filename);\n    } else if (known) {\n      // File was modified - cancel existing and re-schedule\n      this.cancelScheduled(filename, \"file-modified\");\n      void this.handleFile(filename);\n    } else {\n      // New file\n      void this.handleFile(filename);\n    }\n  }\n\n  private async handleDelete(filename: string): Promise<void> {\n    if (!this.knownFiles.has(filename)) return;\n\n    const filePath = join(this.eventsDir, filename);\n    for (let i = 0; i < MAX_RETRIES; i++) {\n      const delay = RETRY_BASE_MS * 2 ** i;\n      await this.sleep(delay);\n      const exists = existsSync(filePath);\n      log.logInfo(`Confirming event deletion: ${filename} after ${delay}ms (exists=${exists})`);\n      if (exists) {\n        return;\n      }\n    }\n\n    if (this.timerEventTypes.get(filename) === \"one-shot\" && this.timers.has(filename)) {\n      log.logInfo(\n        `Ignoring deleted one-shot file after scheduling: ${filename} (timer remains active)`,\n      );\n      return;\n    }\n\n    log.logInfo(`Event file deleted: ${filename}`);\n    this.cancelScheduled(filename, \"confirmed-delete\");\n    this.knownFiles.delete(filename);\n  }\n\n  private cancelScheduled(filename: string, reason = \"unspecified\"): void {\n    const timer = this.timers.get(filename);\n    const cron = this.crons.get(filename);\n    log.logInfo(\n      `Canceling scheduled event: ${filename} (reason=${reason}, timer=${Boolean(timer)}, cron=${Boolean(cron)})`,\n    );\n    if (timer) {\n      clearTimeout(timer);\n      this.timers.delete(filename);\n      this.timerEventTypes.delete(filename);\n    }\n\n    if (cron) {\n      cron.stop();\n      this.crons.delete(filename);\n    }\n  }\n\n  private async handleFile(filename: string): Promise<void> {\n    const filePath = join(this.eventsDir, filename);\n    log.logInfo(`Loading event file: ${filename} from ${filePath}`);\n\n    // Parse with retries\n    let event: MikanEvent | null = null;\n    let lastError: Error | null = null;\n\n    for (let i = 0; i < MAX_RETRIES; i++) {\n      try {\n        const content = await readFile(filePath, \"utf-8\");\n        event = this.parseEvent(content, filename);\n        break;\n      } catch (err) {\n        lastError = err instanceof Error ? err : new Error(String(err));\n        if (i < MAX_RETRIES - 1) {\n          await this.sleep(RETRY_BASE_MS * 2 ** i);\n        }\n      }\n    }\n\n    if (!event) {\n      log.logWarning(\n        `Failed to parse event file after ${MAX_RETRIES} retries: ${filename}`,\n        lastError?.message,\n      );\n      this.deleteFile(filename, \"parse-failed\");\n      return;\n    }\n\n    this.knownFiles.add(filename);\n    log.logInfo(\n      `Parsed event file: ${filename} (${event.type} for ${event.platform}/${event.conversationId})`,\n    );\n\n    // Schedule based on type\n    switch (event.type) {\n      case \"immediate\":\n        this.handleImmediate(filename, event);\n        break;\n      case \"one-shot\":\n        this.handleOneShot(filename, event);\n        break;\n      case \"periodic\":\n        this.handlePeriodic(filename, event);\n        break;\n    }\n  }\n\n  private parseEvent(content: string, filename: string): MikanEvent | null {\n    const data: EventFileData = parseJsonSchemaValue(content, EventFileSchema, (detail) =>\n      detail === \"unexpected JSON shape\"\n        ? `Expected top-level JSON object in ${filename}`\n        : `Malformed event file ${filename}: ${detail}`,\n    );\n    const conversationId =\n      typeof data.conversationId === \"string\"\n        ? data.conversationId\n        : typeof data.channelId === \"string\"\n          ? data.channelId\n          : undefined;\n    const type = typeof data.type === \"string\" ? data.type : undefined;\n    const text = typeof data.text === \"string\" ? data.text : undefined;\n\n    if (!type || !conversationId || !text) {\n      throw new Error(`Missing required fields (type, conversationId, text) in ${filename}`);\n    }\n\n    const platform = this.resolvePlatform(data.platform, filename);\n    const conversationKind = this.resolveConversationKind(\n      platform,\n      conversationId,\n      data.conversationKind,\n    );\n    const userId = typeof data.userId === \"string\" ? data.userId : undefined;\n    switch (type) {\n      case \"immediate\":\n        return {\n          type: \"immediate\",\n          platform,\n          conversationId,\n          conversationKind,\n          userId,\n          text,\n        };\n\n      case \"one-shot\":\n        if (typeof data.at !== \"string\" || data.at.length === 0) {\n          throw new Error(`Missing 'at' field for one-shot event in ${filename}`);\n        }\n        return {\n          type: \"one-shot\",\n          platform,\n          conversationId,\n          conversationKind,\n          userId,\n          text,\n          at: data.at,\n        };\n\n      case \"periodic\":\n        if (typeof data.schedule !== \"string\" || data.schedule.length === 0) {\n          throw new Error(`Missing 'schedule' field for periodic event in ${filename}`);\n        }\n        if (typeof data.timezone !== \"string\" || data.timezone.length === 0) {\n          throw new Error(`Missing 'timezone' field for periodic event in ${filename}`);\n        }\n        return {\n          type: \"periodic\",\n          platform,\n          conversationId,\n          conversationKind,\n          userId,\n          text,\n          schedule: data.schedule,\n          timezone: data.timezone,\n        };\n\n      default:\n        throw new Error(`Unknown event type '${type}' in ${filename}`);\n    }\n  }\n\n  private resolvePlatform(platformValue: unknown, filename: string): string {\n    const availablePlatforms = Object.keys(this.botsByPlatform);\n\n    if (typeof platformValue === \"string\" && platformValue.trim().length > 0) {\n      const platform = platformValue.trim().toLowerCase();\n      if (!this.botsByPlatform[platform]) {\n        throw new Error(\n          `Unknown platform '${platformValue}' in ${filename}. Expected one of: ${availablePlatforms.join(\", \")}`,\n        );\n      }\n      return platform;\n    }\n\n    if (availablePlatforms.length === 1) {\n      return availablePlatforms[0];\n    }\n\n    throw new Error(\n      `Missing required field 'platform' in ${filename}. Available platforms: ${availablePlatforms.join(\", \")}`,\n    );\n  }\n\n  private resolveConversationKind(\n    platform: string,\n    conversationId: string,\n    conversationKindValue: unknown,\n  ): ConversationKind {\n    if (conversationKindValue === \"direct\" || conversationKindValue === \"shared\") {\n      return conversationKindValue;\n    }\n\n    return inferConversationKind(platform, conversationId);\n  }\n\n  private handleImmediate(filename: string, event: ImmediateEvent): void {\n    const filePath = join(this.eventsDir, filename);\n\n    // Check if stale (created before harness started)\n    try {\n      const stat = statSync(filePath);\n      if (stat.mtimeMs < this.startTime) {\n        log.logInfo(`Stale immediate event, deleting: ${filename}`);\n        this.deleteFile(filename, \"stale-immediate\");\n        return;\n      }\n    } catch {\n      // File may have been deleted\n      return;\n    }\n\n    log.logInfo(`Executing immediate event: ${filename}`);\n    this.execute(filename, event);\n  }\n\n  private handleOneShot(filename: string, event: OneShotEvent): void {\n    const atTime = new Date(event.at).getTime();\n    const now = Date.now();\n\n    if (atTime <= now) {\n      // Past - delete without executing\n      log.logInfo(`One-shot event in the past, deleting: ${filename}`);\n      this.deleteFile(filename, \"one-shot-in-past\");\n      return;\n    }\n\n    const delay = atTime - now;\n    log.logInfo(\n      `Scheduling one-shot event: ${filename} in ${Math.round(delay / 1000)}s (at=${event.at}, now=${new Date(now).toISOString()})`,\n    );\n\n    const timer = setTimeout(() => {\n      this.timers.delete(filename);\n      this.timerEventTypes.delete(filename);\n      log.logInfo(`Executing one-shot event: ${filename}`);\n      this.execute(filename, event);\n    }, delay);\n\n    this.timers.set(filename, timer);\n    this.timerEventTypes.set(filename, \"one-shot\");\n    log.logInfo(`Stored one-shot timer: ${filename} (active timers=${this.timers.size})`);\n  }\n\n  private handlePeriodic(filename: string, event: PeriodicEvent): void {\n    try {\n      const cron = new Cron(event.schedule, { timezone: event.timezone }, () => {\n        log.logInfo(`Executing periodic event: ${filename}`);\n        this.execute(filename, event, false); // Don't delete periodic events\n      });\n\n      this.crons.set(filename, cron);\n\n      const next = cron.nextRun();\n      log.logInfo(\n        `Scheduled periodic event: ${filename}, next run: ${next?.toISOString() ?? \"unknown\"}`,\n      );\n    } catch (err) {\n      log.logWarning(`Invalid cron schedule for ${filename}: ${event.schedule}`, String(err));\n      this.deleteFile(filename, \"invalid-cron\");\n    }\n  }\n\n  private execute(filename: string, event: MikanEvent, deleteAfter: boolean = true): void {\n    const message = this.buildEventPrompt(event);\n    const bot = this.botsByPlatform[event.platform];\n\n    if (!bot) {\n      log.logWarning(`No bot configured for event platform '${event.platform}'`, filename);\n      reportUserFacingError(new Error(\"Scheduled event delivery failed: missing bot\"), {\n        domain: \"events\",\n        surface: \"event_delivery\",\n        operation: \"event_execute\",\n        severity: \"error\",\n        platform: event.platform,\n        context: {\n          failure: \"missing_bot\",\n          filename,\n          eventType: event.type,\n          conversationId: event.conversationId,\n          conversationKind: event.conversationKind,\n          deleteAfter,\n          triggeredByEventFile: true,\n          textLength: event.text.length,\n        },\n      });\n      if (deleteAfter) {\n        this.deleteFile(filename, \"missing-bot\");\n      }\n      return;\n    }\n\n    const eventId = filename.replace(/\\.json$/i, \"\");\n    const botEvent: BotEvent = {\n      type: \"mention\",\n      conversationId: event.conversationId,\n      conversationKind: event.conversationKind,\n      user: event.userId ?? \"EVENT\",\n      text: message,\n      ts: `event:${eventId}`,\n    };\n\n    // Enqueue for processing\n    const enqueued = bot.enqueueEvent(botEvent);\n\n    if (enqueued && deleteAfter) {\n      // Delete file after successful enqueue (immediate and one-shot)\n      this.deleteFile(filename, \"executed-and-enqueued\");\n    } else if (!enqueued) {\n      log.logWarning(`Event queue full, discarded: ${filename}`);\n      reportUserFacingError(new Error(\"Scheduled event delivery failed: queue full\"), {\n        domain: \"events\",\n        surface: \"event_delivery\",\n        operation: \"event_execute\",\n        severity: \"error\",\n        platform: event.platform,\n        context: {\n          failure: \"queue_full\",\n          filename,\n          eventType: event.type,\n          conversationId: event.conversationId,\n          conversationKind: event.conversationKind,\n          deleteAfter,\n          triggeredByEventFile: true,\n          textLength: event.text.length,\n        },\n      });\n      // Still delete immediate/one-shot even if discarded\n      if (deleteAfter) {\n        this.deleteFile(filename, \"queue-full-discarded\");\n      }\n    }\n  }\n\n  private buildEventPrompt(event: MikanEvent): string {\n    switch (event.type) {\n      case \"one-shot\":\n        return [\n          \"Please deliver the following reminder to the user in a short, natural way.\",\n          \"Do not greet, do not introduce yourself, and do not ask generic follow-up questions.\",\n          \"\",\n          `Reminder: ${event.text}`,\n        ].join(\"\\n\");\n      case \"periodic\":\n        return [\n          \"Handle the following recurring task.\",\n          \"Respond concisely. If there is nothing actionable to report, reply with [SILENT].\",\n          \"\",\n          `Task: ${event.text}`,\n        ].join(\"\\n\");\n      case \"immediate\":\n        return [\n          \"Handle the following event/update in a concise, context-appropriate way.\",\n          \"If it reads like a reminder or follow-up, deliver it directly without greeting or generic offers to help.\",\n          \"\",\n          `Event: ${event.text}`,\n        ].join(\"\\n\");\n    }\n  }\n\n  private deleteFile(filename: string, reason = \"unspecified\"): void {\n    const filePath = join(this.eventsDir, filename);\n    log.logInfo(`Deleting event file: ${filename} (reason=${reason})`);\n    try {\n      unlinkSync(filePath);\n    } catch (err) {\n      // ENOENT is fine (file already deleted), other errors are warnings\n      if (err instanceof Error && \"code\" in err && err.code !== \"ENOENT\") {\n        log.logWarning(`Failed to delete event file: ${filename}`, String(err));\n      }\n    }\n    this.knownFiles.delete(filename);\n  }\n\n  private sleep(ms: number): Promise<void> {\n    return new Promise((resolve) => setTimeout(resolve, ms));\n  }\n}\n\n/**\n * Create an events watcher for all configured platforms.\n */\nexport function createEventsWatcher(\n  workspaceDir: string,\n  botsByPlatform: Record<string, Bot>,\n): EventsWatcher {\n  const eventsDir = join(workspaceDir, \"events\");\n  return new EventsWatcher(eventsDir, botsByPlatform);\n}\n"]}