@geminixiang/mikan 0.3.2 → 0.4.0

package/dist/sessions/types.d.ts

@@ -0,0 +1,76 @@
+import type { ConversationKind } from "../adapter.js";
+export interface MikanSessionHeader {
+    type?: string;
+    version?: number;
+    id?: string;
+    timestamp?: string;
+    cwd?: string;
+    parentSession?: string;
+    source?: {
+        kind?: string;
+        file?: string;
+        recentDays?: number;
+    };
+}
+export interface ResolveSessionKeyOptions {
+    conversationId: string;
+    conversationKind: ConversationKind;
+    messageId: string;
+    threadTs?: string;
+    persistentTopLevel?: boolean;
+    scopeDirectThreads?: boolean;
+}
+export interface ThreadRootMessage {
+    text?: string;
+    userName?: string;
+    user?: string;
+    loggedAt?: number;
+    isBot?: boolean;
+}
+export interface ResolvedSessionScope {
+    sessionDir: string;
+    contextFile: string;
+    threadRootMessage: ThreadRootMessage | null;
+}
+export interface ChatSessionManagerOptions {
+    recentDays?: number;
+    maxTopLevelMessages?: number;
+    now?: () => Date;
+}
+export interface ResolveChatSessionScopeOptions {
+    conversationDir: string;
+    sessionKey: string;
+    cwd?: string;
+    /** The triggering platform message ID. Excluded from bootstrap to avoid duplicate user turns. */
+    currentMessageId?: string;
+}
+export interface SyncChatSessionManagerOptions {
+    conversationDir: string;
+    sessionKey: string;
+    sessionManager: import("@earendil-works/pi-coding-agent").SessionManager;
+    /** The triggering platform message ID. Excluded from sync to avoid duplicate user turns. */
+    currentMessageId?: string;
+}
+export interface ResetChatSessionOptions {
+    conversationDir: string;
+    sessionKey: string;
+    cwd?: string;
+}
+export interface RegisterThreadSessionOptions {
+    conversationDir: string;
+    sessionKey: string;
+    cwd?: string;
+}
+export interface HasMaterializedSessionOptions {
+    conversationDir: string;
+    sessionKey: string;
+}
+export interface ThreadBootstrapWaitOptions {
+    parentSessionKey: string;
+    sessionKey: string;
+    hasThreadSession: () => boolean;
+    isParentRunning: () => boolean;
+    sleep?: (ms: number) => Promise<void>;
+    pollMs?: number;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/sessions/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/sessions/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAC;AAItD,MAAM,WAAW,kBAAkB;IACjC,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,MAAM,CAAC,EAAE;QACP,IAAI,CAAC,EAAE,MAAM,CAAC;QACd,IAAI,CAAC,EAAE,MAAM,CAAC;QACd,UAAU,CAAC,EAAE,MAAM,CAAC;KACrB,CAAC;CACH;AAID,MAAM,WAAW,wBAAwB;IACvC,cAAc,EAAE,MAAM,CAAC;IACvB,gBAAgB,EAAE,gBAAgB,CAAC;IACnC,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,kBAAkB,CAAC,EAAE,OAAO,CAAC;IAC7B,kBAAkB,CAAC,EAAE,OAAO,CAAC;CAC9B;AAID,MAAM,WAAW,iBAAiB;IAChC,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,KAAK,CAAC,EAAE,OAAO,CAAC;CACjB;AAED,MAAM,WAAW,oBAAoB;IACnC,UAAU,EAAE,MAAM,CAAC;IACnB,WAAW,EAAE,MAAM,CAAC;IACpB,iBAAiB,EAAE,iBAAiB,GAAG,IAAI,CAAC;CAC7C;AAID,MAAM,WAAW,yBAAyB;IACxC,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,mBAAmB,CAAC,EAAE,MAAM,CAAC;IAC7B,GAAG,CAAC,EAAE,MAAM,IAAI,CAAC;CAClB;AAED,MAAM,WAAW,8BAA8B;IAC7C,eAAe,EAAE,MAAM,CAAC;IACxB,UAAU,EAAE,MAAM,CAAC;IACnB,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,iGAAiG;IACjG,gBAAgB,CAAC,EAAE,MAAM,CAAC;CAC3B;AAED,MAAM,WAAW,6BAA6B;IAC5C,eAAe,EAAE,MAAM,CAAC;IACxB,UAAU,EAAE,MAAM,CAAC;IACnB,cAAc,EAAE,OAAO,iCAAiC,EAAE,cAAc,CAAC;IACzE,4FAA4F;IAC5F,gBAAgB,CAAC,EAAE,MAAM,CAAC;CAC3B;AAED,MAAM,WAAW,uBAAuB;IACtC,eAAe,EAAE,MAAM,CAAC;IACxB,UAAU,EAAE,MAAM,CAAC;IACnB,GAAG,CAAC,EAAE,MAAM,CAAC;CACd;AAED,MAAM,WAAW,4BAA4B;IAC3C,eAAe,EAAE,MAAM,CAAC;IACxB,UAAU,EAAE,MAAM,CAAC;IACnB,GAAG,CAAC,EAAE,MAAM,CAAC;CACd;AAED,MAAM,WAAW,6BAA6B;IAC5C,eAAe,EAAE,MAAM,CAAC;IACxB,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,0BAA0B;IACzC,gBAAgB,EAAE,MAAM,CAAC;IACzB,UAAU,EAAE,MAAM,CAAC;IACnB,gBAAgB,EAAE,MAAM,OAAO,CAAC;IAChC,eAAe,EAAE,MAAM,OAAO,CAAC;IAC/B,KAAK,CAAC,EAAE,CAAC,EAAE,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IACtC,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB","sourcesContent":["import type { ConversationKind } from \"../adapter.js\";\n\n// ── session metadata ─────────────────────────────────────────────────────────\n\nexport interface MikanSessionHeader {\n  type?: string;\n  version?: number;\n  id?: string;\n  timestamp?: string;\n  cwd?: string;\n  parentSession?: string;\n  source?: {\n    kind?: string;\n    file?: string;\n    recentDays?: number;\n  };\n}\n\n// ── session policy ───────────────────────────────────────────────────────────\n\nexport interface ResolveSessionKeyOptions {\n  conversationId: string;\n  conversationKind: ConversationKind;\n  messageId: string;\n  threadTs?: string;\n  persistentTopLevel?: boolean;\n  scopeDirectThreads?: boolean;\n}\n\n// ── session store ────────────────────────────────────────────────────────────\n\nexport interface ThreadRootMessage {\n  text?: string;\n  userName?: string;\n  user?: string;\n  loggedAt?: number;\n  isBot?: boolean;\n}\n\nexport interface ResolvedSessionScope {\n  sessionDir: string;\n  contextFile: string;\n  threadRootMessage: ThreadRootMessage | null;\n}\n\n// ── chat session manager ─────────────────────────────────────────────────────\n\nexport interface ChatSessionManagerOptions {\n  recentDays?: number;\n  maxTopLevelMessages?: number;\n  now?: () => Date;\n}\n\nexport interface ResolveChatSessionScopeOptions {\n  conversationDir: string;\n  sessionKey: string;\n  cwd?: string;\n  /** The triggering platform message ID. Excluded from bootstrap to avoid duplicate user turns. */\n  currentMessageId?: string;\n}\n\nexport interface SyncChatSessionManagerOptions {\n  conversationDir: string;\n  sessionKey: string;\n  sessionManager: import(\"@earendil-works/pi-coding-agent\").SessionManager;\n  /** The triggering platform message ID. Excluded from sync to avoid duplicate user turns. */\n  currentMessageId?: string;\n}\n\nexport interface ResetChatSessionOptions {\n  conversationDir: string;\n  sessionKey: string;\n  cwd?: string;\n}\n\nexport interface RegisterThreadSessionOptions {\n  conversationDir: string;\n  sessionKey: string;\n  cwd?: string;\n}\n\nexport interface HasMaterializedSessionOptions {\n  conversationDir: string;\n  sessionKey: string;\n}\n\nexport interface ThreadBootstrapWaitOptions {\n  parentSessionKey: string;\n  sessionKey: string;\n  hasThreadSession: () => boolean;\n  isParentRunning: () => boolean;\n  sleep?: (ms: number) => Promise<void>;\n  pollMs?: number;\n}\n"]}

package/dist/sessions/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/sessions/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/sessions/types.ts"],"names":[],"mappings":"","sourcesContent":["import type { ConversationKind } from \"../adapter.js\";\n\n// ── session metadata ─────────────────────────────────────────────────────────\n\nexport interface MikanSessionHeader {\n  type?: string;\n  version?: number;\n  id?: string;\n  timestamp?: string;\n  cwd?: string;\n  parentSession?: string;\n  source?: {\n    kind?: string;\n    file?: string;\n    recentDays?: number;\n  };\n}\n\n// ── session policy ───────────────────────────────────────────────────────────\n\nexport interface ResolveSessionKeyOptions {\n  conversationId: string;\n  conversationKind: ConversationKind;\n  messageId: string;\n  threadTs?: string;\n  persistentTopLevel?: boolean;\n  scopeDirectThreads?: boolean;\n}\n\n// ── session store ────────────────────────────────────────────────────────────\n\nexport interface ThreadRootMessage {\n  text?: string;\n  userName?: string;\n  user?: string;\n  loggedAt?: number;\n  isBot?: boolean;\n}\n\nexport interface ResolvedSessionScope {\n  sessionDir: string;\n  contextFile: string;\n  threadRootMessage: ThreadRootMessage | null;\n}\n\n// ── chat session manager ─────────────────────────────────────────────────────\n\nexport interface ChatSessionManagerOptions {\n  recentDays?: number;\n  maxTopLevelMessages?: number;\n  now?: () => Date;\n}\n\nexport interface ResolveChatSessionScopeOptions {\n  conversationDir: string;\n  sessionKey: string;\n  cwd?: string;\n  /** The triggering platform message ID. Excluded from bootstrap to avoid duplicate user turns. */\n  currentMessageId?: string;\n}\n\nexport interface SyncChatSessionManagerOptions {\n  conversationDir: string;\n  sessionKey: string;\n  sessionManager: import(\"@earendil-works/pi-coding-agent\").SessionManager;\n  /** The triggering platform message ID. Excluded from sync to avoid duplicate user turns. */\n  currentMessageId?: string;\n}\n\nexport interface ResetChatSessionOptions {\n  conversationDir: string;\n  sessionKey: string;\n  cwd?: string;\n}\n\nexport interface RegisterThreadSessionOptions {\n  conversationDir: string;\n  sessionKey: string;\n  cwd?: string;\n}\n\nexport interface HasMaterializedSessionOptions {\n  conversationDir: string;\n  sessionKey: string;\n}\n\nexport interface ThreadBootstrapWaitOptions {\n  parentSessionKey: string;\n  sessionKey: string;\n  hasThreadSession: () => boolean;\n  isParentRunning: () => boolean;\n  sleep?: (ms: number) => Promise<void>;\n  pollMs?: number;\n}\n"]}

package/dist/store.d.ts

@@ -1,22 +1,5 @@
-export interface Attachment {
-    original: string;
-    localPath: string;
-}
-export interface LoggedMessage {
-    date: string;
-    ts: string;
-    user: string;
-    userName?: string;
-    displayName?: string;
-    text: string;
-    attachments: Attachment[];
-    isBot: boolean;
-    threadTs?: string;
-}
-export interface ChannelStoreConfig {
-    workingDir: string;
-    botToken: string;
-}
+export type { Attachment, ChannelStoreConfig, LoggedMessage } from "./types.js";
+import type { Attachment, ChannelStoreConfig, LoggedMessage } from "./types.js";
 export declare class ChannelStore {
     private workingDir;
     private botToken;

package/dist/store.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"store.d.ts","sourceRoot":"","sources":["../src/store.ts"],"names":[],"mappings":"AAKA,MAAM,WAAW,UAAU;IACzB,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,MAAM,CAAC;IACb,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,UAAU,EAAE,CAAC;IAC1B,KAAK,EAAE,OAAO,CAAC;IACf,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,kBAAkB;IACjC,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,MAAM,CAAC;CAClB;AAgBD,qBAAa,YAAY;IACvB,OAAO,CAAC,UAAU,CAAS;IAC3B,OAAO,CAAC,QAAQ,CAAS;IAGzB,OAAO,CAAC,cAAc,CAA6B;IAEnD,YAAY,MAAM,EAAE,kBAAkB,EAMrC;IAED;;OAEG;IACH,aAAa,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,CAIvC;IAED;;OAEG;IACH,qBAAqB,CAAC,YAAY,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,MAAM,CAMrE;IAED;;;OAGG;IACG,kBAAkB,CACtB,SAAS,EAAE,MAAM,EACjB,KAAK,EAAE,KAAK,CAAC;QAAE,IAAI,CAAC,EAAE,MAAM,CAAC;QAAC,oBAAoB,CAAC,EAAE,MAAM,CAAC;QAAC,WAAW,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC,EACpF,SAAS,EAAE,MAAM,GAChB,OAAO,CAAC,UAAU,EAAE,CAAC,CA8BvB;IAED;;;OAGG;IACG,UAAU,CAAC,SAAS,EAAE,MAAM,EAAE,OAAO,EAAE,aAAa,GAAG,OAAO,CAAC,OAAO,CAAC,CA+B5E;IAED;;OAEG;IACG,cAAc,CAAC,SAAS,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAS/E;IAED;;;OAGG;IACH,gBAAgB,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAsBjD;YAKa,2BAA2B;YAQ3B,kBAAkB;CAuBjC","sourcesContent":["import { appendFile, writeFile } from \"fs/promises\";\nimport { join } from \"path\";\nimport { ensureDirExists, isRecord, parseJsonValue, readTextFileIfExists } from \"./file-guards.js\";\nimport { withRetry } from \"./adapters/shared.js\";\n\nexport interface Attachment {\n  original: string; // original filename from uploader\n  localPath: string; // path relative to working dir (e.g., \"C12345/attachments/1732531234567_file.png\")\n}\n\nexport interface LoggedMessage {\n  date: string; // ISO 8601 date (e.g., \"2025-11-26T10:44:00.000Z\") for easy grepping\n  ts: string; // slack timestamp or epoch ms\n  user: string; // user ID (or \"bot\" for bot responses)\n  userName?: string; // handle (e.g., \"mario\")\n  displayName?: string; // display name (e.g., \"Mario Zechner\")\n  text: string;\n  attachments: Attachment[];\n  isBot: boolean;\n  threadTs?: string; // slack thread timestamp (root message ts)\n}\n\nexport interface ChannelStoreConfig {\n  workingDir: string;\n  botToken: string; // needed for authenticated file downloads\n}\n\nclass AttachmentDownloadHttpError extends Error {\n  constructor(\n    message: string,\n    readonly status: number,\n  ) {\n    super(message);\n  }\n}\n\nfunction isRetryableAttachmentDownloadError(error: unknown): boolean {\n  if (!(error instanceof AttachmentDownloadHttpError)) return true;\n  return error.status === 408 || error.status === 429 || error.status >= 500;\n}\n\nexport class ChannelStore {\n  private workingDir: string;\n  private botToken: string;\n  // Track recently logged message timestamps to prevent duplicates\n  // Key: \"channelId:ts\", automatically cleaned up after 60 seconds\n  private recentlyLogged = new Map<string, number>();\n\n  constructor(config: ChannelStoreConfig) {\n    this.workingDir = config.workingDir;\n    this.botToken = config.botToken;\n\n    // Ensure working directory exists\n    ensureDirExists(this.workingDir);\n  }\n\n  /**\n   * Get or create the directory for a channel/DM\n   */\n  getChannelDir(channelId: string): string {\n    const channelDir = join(this.workingDir, channelId);\n    ensureDirExists(channelDir);\n    return channelDir;\n  }\n\n  /**\n   * Generate a unique local filename for an attachment\n   */\n  generateLocalFilename(originalName: string, timestamp: string): string {\n    // Convert slack timestamp (1234567890.123456) to milliseconds\n    const ts = Math.floor(parseFloat(timestamp) * 1000);\n    // Sanitize original name (remove problematic characters)\n    const sanitized = originalName.replace(/[^a-zA-Z0-9._-]/g, \"_\");\n    return `${ts}_${sanitized}`;\n  }\n\n  /**\n   * Process attachments from a Slack message event.\n   * Downloads files before returning so callers only receive readable paths.\n   */\n  async processAttachments(\n    channelId: string,\n    files: Array<{ name?: string; url_private_download?: string; url_private?: string }>,\n    timestamp: string,\n  ): Promise<Attachment[]> {\n    const downloads: Array<Promise<Attachment>> = [];\n\n    for (const file of files) {\n      const url = file.url_private_download || file.url_private;\n      if (!url) continue;\n      if (!file.name) {\n        throw new Error(`Attachment missing name for URL: ${url}`);\n      }\n\n      const filename = this.generateLocalFilename(file.name, timestamp);\n      const localPath = `${channelId}/attachments/${filename}`;\n      const attachment: Attachment = {\n        original: file.name,\n        localPath,\n      };\n\n      downloads.push(\n        this.downloadAttachmentWithRetry(localPath, url)\n          .then(() => attachment)\n          .catch((error) => {\n            const errorMsg = error instanceof Error ? error.message : String(error);\n            throw new Error(`Failed to download attachment ${localPath}: ${errorMsg}`, {\n              cause: error,\n            });\n          }),\n      );\n    }\n\n    return Promise.all(downloads);\n  }\n\n  /**\n   * Log a message to the channel's log.jsonl\n   * Returns false if message was already logged (duplicate)\n   */\n  async logMessage(channelId: string, message: LoggedMessage): Promise<boolean> {\n    // Check for duplicate (same channel + timestamp)\n    const dedupeKey = `${channelId}:${message.ts}`;\n    if (this.recentlyLogged.has(dedupeKey)) {\n      return false; // Already logged\n    }\n\n    const logPath = join(this.getChannelDir(channelId), \"log.jsonl\");\n\n    // Ensure message has a date field\n    if (!message.date) {\n      // Parse timestamp to get date\n      let date: Date;\n      if (message.ts.includes(\".\")) {\n        // Slack timestamp format (1234567890.123456)\n        date = new Date(parseFloat(message.ts) * 1000);\n      } else {\n        // Epoch milliseconds\n        date = new Date(parseInt(message.ts, 10));\n      }\n      message.date = date.toISOString();\n    }\n\n    const line = `${JSON.stringify(message)}\\n`;\n    await appendFile(logPath, line, \"utf-8\");\n\n    // Mark as logged only after the append succeeds. Otherwise a transient\n    // write failure can make retries look like duplicates and drop messages.\n    this.recentlyLogged.set(dedupeKey, Date.now());\n    setTimeout(() => this.recentlyLogged.delete(dedupeKey), 60000);\n    return true;\n  }\n\n  /**\n   * Log a bot response\n   */\n  async logBotResponse(channelId: string, text: string, ts: string): Promise<void> {\n    await this.logMessage(channelId, {\n      date: new Date().toISOString(),\n      ts,\n      user: \"bot\",\n      text,\n      attachments: [],\n      isBot: true,\n    });\n  }\n\n  /**\n   * Get the timestamp of the last logged message for a channel\n   * Returns null if no log exists\n   */\n  getLastTimestamp(channelId: string): string | null {\n    const logPath = join(this.workingDir, channelId, \"log.jsonl\");\n    const content = readTextFileIfExists(logPath);\n    if (content === undefined) {\n      return null;\n    }\n\n    try {\n      const lines = content.trim().split(\"\\n\");\n      if (lines.length === 0 || lines[0] === \"\") {\n        return null;\n      }\n      const lastLine = lines[lines.length - 1];\n      const message = parseJsonValue(\n        lastLine,\n        (value): value is LoggedMessage => isRecord(value) && typeof value.ts === \"string\",\n        (detail) => (detail === \"unexpected JSON shape\" ? \"log entry missing timestamp\" : detail),\n      );\n      return message.ts;\n    } catch {\n      return null;\n    }\n  }\n\n  /**\n   * Download a single attachment\n   */\n  private async downloadAttachmentWithRetry(localPath: string, url: string): Promise<void> {\n    await withRetry(() => this.downloadAttachment(localPath, url), {\n      maxAttempts: 3,\n      baseDelayMs: 250,\n      isRateLimited: isRetryableAttachmentDownloadError,\n    });\n  }\n\n  private async downloadAttachment(localPath: string, url: string): Promise<void> {\n    const filePath = join(this.workingDir, localPath);\n\n    // Ensure directory exists\n    const parentDir = join(this.workingDir, localPath.substring(0, localPath.lastIndexOf(\"/\")));\n    ensureDirExists(parentDir);\n\n    const response = await fetch(url, {\n      headers: {\n        Authorization: `Bearer ${this.botToken}`,\n      },\n    });\n\n    if (!response.ok) {\n      throw new AttachmentDownloadHttpError(\n        `HTTP ${response.status}: ${response.statusText}`,\n        response.status,\n      );\n    }\n\n    const buffer = await response.arrayBuffer();\n    await writeFile(filePath, Buffer.from(buffer));\n  }\n}\n"]}
+{"version":3,"file":"store.d.ts","sourceRoot":"","sources":["../src/store.ts"],"names":[],"mappings":"AAUA,YAAY,EAAE,UAAU,EAAE,kBAAkB,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAChF,OAAO,KAAK,EAAE,UAAU,EAAE,kBAAkB,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAgBhF,qBAAa,YAAY;IACvB,OAAO,CAAC,UAAU,CAAS;IAC3B,OAAO,CAAC,QAAQ,CAAS;IAGzB,OAAO,CAAC,cAAc,CAA6B;IAEnD,YAAY,MAAM,EAAE,kBAAkB,EAMrC;IAED;;OAEG;IACH,aAAa,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,CAIvC;IAED;;OAEG;IACH,qBAAqB,CAAC,YAAY,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,MAAM,CAMrE;IAED;;;OAGG;IACG,kBAAkB,CACtB,SAAS,EAAE,MAAM,EACjB,KAAK,EAAE,KAAK,CAAC;QAAE,IAAI,CAAC,EAAE,MAAM,CAAC;QAAC,oBAAoB,CAAC,EAAE,MAAM,CAAC;QAAC,WAAW,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC,EACpF,SAAS,EAAE,MAAM,GAChB,OAAO,CAAC,UAAU,EAAE,CAAC,CA8BvB;IAED;;;OAGG;IACG,UAAU,CAAC,SAAS,EAAE,MAAM,EAAE,OAAO,EAAE,aAAa,GAAG,OAAO,CAAC,OAAO,CAAC,CA+B5E;IAED;;OAEG;IACG,cAAc,CAAC,SAAS,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAS/E;IAED;;;OAGG;IACH,gBAAgB,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAsBjD;YAKa,2BAA2B;YAQ3B,kBAAkB;CAuBjC","sourcesContent":["import { appendFile, writeFile } from \"fs/promises\";\nimport { join } from \"path\";\nimport {\n  ensureDirExists,\n  isRecord,\n  parseJsonValue,\n  readTextFileIfExists,\n} from \"./utils/file-guards.js\";\nimport { withRetry } from \"./adapters/shared.js\";\n\nexport type { Attachment, ChannelStoreConfig, LoggedMessage } from \"./types.js\";\nimport type { Attachment, ChannelStoreConfig, LoggedMessage } from \"./types.js\";\n\nclass AttachmentDownloadHttpError extends Error {\n  constructor(\n    message: string,\n    readonly status: number,\n  ) {\n    super(message);\n  }\n}\n\nfunction isRetryableAttachmentDownloadError(error: unknown): boolean {\n  if (!(error instanceof AttachmentDownloadHttpError)) return true;\n  return error.status === 408 || error.status === 429 || error.status >= 500;\n}\n\nexport class ChannelStore {\n  private workingDir: string;\n  private botToken: string;\n  // Track recently logged message timestamps to prevent duplicates\n  // Key: \"channelId:ts\", automatically cleaned up after 60 seconds\n  private recentlyLogged = new Map<string, number>();\n\n  constructor(config: ChannelStoreConfig) {\n    this.workingDir = config.workingDir;\n    this.botToken = config.botToken;\n\n    // Ensure working directory exists\n    ensureDirExists(this.workingDir);\n  }\n\n  /**\n   * Get or create the directory for a channel/DM\n   */\n  getChannelDir(channelId: string): string {\n    const channelDir = join(this.workingDir, channelId);\n    ensureDirExists(channelDir);\n    return channelDir;\n  }\n\n  /**\n   * Generate a unique local filename for an attachment\n   */\n  generateLocalFilename(originalName: string, timestamp: string): string {\n    // Convert slack timestamp (1234567890.123456) to milliseconds\n    const ts = Math.floor(parseFloat(timestamp) * 1000);\n    // Sanitize original name (remove problematic characters)\n    const sanitized = originalName.replace(/[^a-zA-Z0-9._-]/g, \"_\");\n    return `${ts}_${sanitized}`;\n  }\n\n  /**\n   * Process attachments from a Slack message event.\n   * Downloads files before returning so callers only receive readable paths.\n   */\n  async processAttachments(\n    channelId: string,\n    files: Array<{ name?: string; url_private_download?: string; url_private?: string }>,\n    timestamp: string,\n  ): Promise<Attachment[]> {\n    const downloads: Array<Promise<Attachment>> = [];\n\n    for (const file of files) {\n      const url = file.url_private_download || file.url_private;\n      if (!url) continue;\n      if (!file.name) {\n        throw new Error(`Attachment missing name for URL: ${url}`);\n      }\n\n      const filename = this.generateLocalFilename(file.name, timestamp);\n      const localPath = `${channelId}/attachments/${filename}`;\n      const attachment: Attachment = {\n        original: file.name,\n        localPath,\n      };\n\n      downloads.push(\n        this.downloadAttachmentWithRetry(localPath, url)\n          .then(() => attachment)\n          .catch((error) => {\n            const errorMsg = error instanceof Error ? error.message : String(error);\n            throw new Error(`Failed to download attachment ${localPath}: ${errorMsg}`, {\n              cause: error,\n            });\n          }),\n      );\n    }\n\n    return Promise.all(downloads);\n  }\n\n  /**\n   * Log a message to the channel's log.jsonl\n   * Returns false if message was already logged (duplicate)\n   */\n  async logMessage(channelId: string, message: LoggedMessage): Promise<boolean> {\n    // Check for duplicate (same channel + timestamp)\n    const dedupeKey = `${channelId}:${message.ts}`;\n    if (this.recentlyLogged.has(dedupeKey)) {\n      return false; // Already logged\n    }\n\n    const logPath = join(this.getChannelDir(channelId), \"log.jsonl\");\n\n    // Ensure message has a date field\n    if (!message.date) {\n      // Parse timestamp to get date\n      let date: Date;\n      if (message.ts.includes(\".\")) {\n        // Slack timestamp format (1234567890.123456)\n        date = new Date(parseFloat(message.ts) * 1000);\n      } else {\n        // Epoch milliseconds\n        date = new Date(parseInt(message.ts, 10));\n      }\n      message.date = date.toISOString();\n    }\n\n    const line = `${JSON.stringify(message)}\\n`;\n    await appendFile(logPath, line, \"utf-8\");\n\n    // Mark as logged only after the append succeeds. Otherwise a transient\n    // write failure can make retries look like duplicates and drop messages.\n    this.recentlyLogged.set(dedupeKey, Date.now());\n    setTimeout(() => this.recentlyLogged.delete(dedupeKey), 60000);\n    return true;\n  }\n\n  /**\n   * Log a bot response\n   */\n  async logBotResponse(channelId: string, text: string, ts: string): Promise<void> {\n    await this.logMessage(channelId, {\n      date: new Date().toISOString(),\n      ts,\n      user: \"bot\",\n      text,\n      attachments: [],\n      isBot: true,\n    });\n  }\n\n  /**\n   * Get the timestamp of the last logged message for a channel\n   * Returns null if no log exists\n   */\n  getLastTimestamp(channelId: string): string | null {\n    const logPath = join(this.workingDir, channelId, \"log.jsonl\");\n    const content = readTextFileIfExists(logPath);\n    if (content === undefined) {\n      return null;\n    }\n\n    try {\n      const lines = content.trim().split(\"\\n\");\n      if (lines.length === 0 || lines[0] === \"\") {\n        return null;\n      }\n      const lastLine = lines[lines.length - 1];\n      const message = parseJsonValue(\n        lastLine,\n        (value): value is LoggedMessage => isRecord(value) && typeof value.ts === \"string\",\n        (detail) => (detail === \"unexpected JSON shape\" ? \"log entry missing timestamp\" : detail),\n      );\n      return message.ts;\n    } catch {\n      return null;\n    }\n  }\n\n  /**\n   * Download a single attachment\n   */\n  private async downloadAttachmentWithRetry(localPath: string, url: string): Promise<void> {\n    await withRetry(() => this.downloadAttachment(localPath, url), {\n      maxAttempts: 3,\n      baseDelayMs: 250,\n      isRateLimited: isRetryableAttachmentDownloadError,\n    });\n  }\n\n  private async downloadAttachment(localPath: string, url: string): Promise<void> {\n    const filePath = join(this.workingDir, localPath);\n\n    // Ensure directory exists\n    const parentDir = join(this.workingDir, localPath.substring(0, localPath.lastIndexOf(\"/\")));\n    ensureDirExists(parentDir);\n\n    const response = await fetch(url, {\n      headers: {\n        Authorization: `Bearer ${this.botToken}`,\n      },\n    });\n\n    if (!response.ok) {\n      throw new AttachmentDownloadHttpError(\n        `HTTP ${response.status}: ${response.statusText}`,\n        response.status,\n      );\n    }\n\n    const buffer = await response.arrayBuffer();\n    await writeFile(filePath, Buffer.from(buffer));\n  }\n}\n"]}

package/dist/store.js

@@ -1,6 +1,6 @@
 import { appendFile, writeFile } from "fs/promises";
 import { join } from "path";
-import { ensureDirExists, isRecord, parseJsonValue, readTextFileIfExists } from "./file-guards.js";
+import { ensureDirExists, isRecord, parseJsonValue, readTextFileIfExists, } from "./utils/file-guards.js";
 import { withRetry } from "./adapters/shared.js";
 class AttachmentDownloadHttpError extends Error {
     constructor(message, status) {

package/dist/store.js.map

@@ -1 +1 @@
-{"version":3,"file":"store.js","sourceRoot":"","sources":["../src/store.ts"],"names":[],"mappings":"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","sourcesContent":["import { appendFile, writeFile } from \"fs/promises\";\nimport { join } from \"path\";\nimport { ensureDirExists, isRecord, parseJsonValue, readTextFileIfExists } from \"./file-guards.js\";\nimport { withRetry } from \"./adapters/shared.js\";\n\nexport interface Attachment {\n  original: string; // original filename from uploader\n  localPath: string; // path relative to working dir (e.g., \"C12345/attachments/1732531234567_file.png\")\n}\n\nexport interface LoggedMessage {\n  date: string; // ISO 8601 date (e.g., \"2025-11-26T10:44:00.000Z\") for easy grepping\n  ts: string; // slack timestamp or epoch ms\n  user: string; // user ID (or \"bot\" for bot responses)\n  userName?: string; // handle (e.g., \"mario\")\n  displayName?: string; // display name (e.g., \"Mario Zechner\")\n  text: string;\n  attachments: Attachment[];\n  isBot: boolean;\n  threadTs?: string; // slack thread timestamp (root message ts)\n}\n\nexport interface ChannelStoreConfig {\n  workingDir: string;\n  botToken: string; // needed for authenticated file downloads\n}\n\nclass AttachmentDownloadHttpError extends Error {\n  constructor(\n    message: string,\n    readonly status: number,\n  ) {\n    super(message);\n  }\n}\n\nfunction isRetryableAttachmentDownloadError(error: unknown): boolean {\n  if (!(error instanceof AttachmentDownloadHttpError)) return true;\n  return error.status === 408 || error.status === 429 || error.status >= 500;\n}\n\nexport class ChannelStore {\n  private workingDir: string;\n  private botToken: string;\n  // Track recently logged message timestamps to prevent duplicates\n  // Key: \"channelId:ts\", automatically cleaned up after 60 seconds\n  private recentlyLogged = new Map<string, number>();\n\n  constructor(config: ChannelStoreConfig) {\n    this.workingDir = config.workingDir;\n    this.botToken = config.botToken;\n\n    // Ensure working directory exists\n    ensureDirExists(this.workingDir);\n  }\n\n  /**\n   * Get or create the directory for a channel/DM\n   */\n  getChannelDir(channelId: string): string {\n    const channelDir = join(this.workingDir, channelId);\n    ensureDirExists(channelDir);\n    return channelDir;\n  }\n\n  /**\n   * Generate a unique local filename for an attachment\n   */\n  generateLocalFilename(originalName: string, timestamp: string): string {\n    // Convert slack timestamp (1234567890.123456) to milliseconds\n    const ts = Math.floor(parseFloat(timestamp) * 1000);\n    // Sanitize original name (remove problematic characters)\n    const sanitized = originalName.replace(/[^a-zA-Z0-9._-]/g, \"_\");\n    return `${ts}_${sanitized}`;\n  }\n\n  /**\n   * Process attachments from a Slack message event.\n   * Downloads files before returning so callers only receive readable paths.\n   */\n  async processAttachments(\n    channelId: string,\n    files: Array<{ name?: string; url_private_download?: string; url_private?: string }>,\n    timestamp: string,\n  ): Promise<Attachment[]> {\n    const downloads: Array<Promise<Attachment>> = [];\n\n    for (const file of files) {\n      const url = file.url_private_download || file.url_private;\n      if (!url) continue;\n      if (!file.name) {\n        throw new Error(`Attachment missing name for URL: ${url}`);\n      }\n\n      const filename = this.generateLocalFilename(file.name, timestamp);\n      const localPath = `${channelId}/attachments/${filename}`;\n      const attachment: Attachment = {\n        original: file.name,\n        localPath,\n      };\n\n      downloads.push(\n        this.downloadAttachmentWithRetry(localPath, url)\n          .then(() => attachment)\n          .catch((error) => {\n            const errorMsg = error instanceof Error ? error.message : String(error);\n            throw new Error(`Failed to download attachment ${localPath}: ${errorMsg}`, {\n              cause: error,\n            });\n          }),\n      );\n    }\n\n    return Promise.all(downloads);\n  }\n\n  /**\n   * Log a message to the channel's log.jsonl\n   * Returns false if message was already logged (duplicate)\n   */\n  async logMessage(channelId: string, message: LoggedMessage): Promise<boolean> {\n    // Check for duplicate (same channel + timestamp)\n    const dedupeKey = `${channelId}:${message.ts}`;\n    if (this.recentlyLogged.has(dedupeKey)) {\n      return false; // Already logged\n    }\n\n    const logPath = join(this.getChannelDir(channelId), \"log.jsonl\");\n\n    // Ensure message has a date field\n    if (!message.date) {\n      // Parse timestamp to get date\n      let date: Date;\n      if (message.ts.includes(\".\")) {\n        // Slack timestamp format (1234567890.123456)\n        date = new Date(parseFloat(message.ts) * 1000);\n      } else {\n        // Epoch milliseconds\n        date = new Date(parseInt(message.ts, 10));\n      }\n      message.date = date.toISOString();\n    }\n\n    const line = `${JSON.stringify(message)}\\n`;\n    await appendFile(logPath, line, \"utf-8\");\n\n    // Mark as logged only after the append succeeds. Otherwise a transient\n    // write failure can make retries look like duplicates and drop messages.\n    this.recentlyLogged.set(dedupeKey, Date.now());\n    setTimeout(() => this.recentlyLogged.delete(dedupeKey), 60000);\n    return true;\n  }\n\n  /**\n   * Log a bot response\n   */\n  async logBotResponse(channelId: string, text: string, ts: string): Promise<void> {\n    await this.logMessage(channelId, {\n      date: new Date().toISOString(),\n      ts,\n      user: \"bot\",\n      text,\n      attachments: [],\n      isBot: true,\n    });\n  }\n\n  /**\n   * Get the timestamp of the last logged message for a channel\n   * Returns null if no log exists\n   */\n  getLastTimestamp(channelId: string): string | null {\n    const logPath = join(this.workingDir, channelId, \"log.jsonl\");\n    const content = readTextFileIfExists(logPath);\n    if (content === undefined) {\n      return null;\n    }\n\n    try {\n      const lines = content.trim().split(\"\\n\");\n      if (lines.length === 0 || lines[0] === \"\") {\n        return null;\n      }\n      const lastLine = lines[lines.length - 1];\n      const message = parseJsonValue(\n        lastLine,\n        (value): value is LoggedMessage => isRecord(value) && typeof value.ts === \"string\",\n        (detail) => (detail === \"unexpected JSON shape\" ? \"log entry missing timestamp\" : detail),\n      );\n      return message.ts;\n    } catch {\n      return null;\n    }\n  }\n\n  /**\n   * Download a single attachment\n   */\n  private async downloadAttachmentWithRetry(localPath: string, url: string): Promise<void> {\n    await withRetry(() => this.downloadAttachment(localPath, url), {\n      maxAttempts: 3,\n      baseDelayMs: 250,\n      isRateLimited: isRetryableAttachmentDownloadError,\n    });\n  }\n\n  private async downloadAttachment(localPath: string, url: string): Promise<void> {\n    const filePath = join(this.workingDir, localPath);\n\n    // Ensure directory exists\n    const parentDir = join(this.workingDir, localPath.substring(0, localPath.lastIndexOf(\"/\")));\n    ensureDirExists(parentDir);\n\n    const response = await fetch(url, {\n      headers: {\n        Authorization: `Bearer ${this.botToken}`,\n      },\n    });\n\n    if (!response.ok) {\n      throw new AttachmentDownloadHttpError(\n        `HTTP ${response.status}: ${response.statusText}`,\n        response.status,\n      );\n    }\n\n    const buffer = await response.arrayBuffer();\n    await writeFile(filePath, Buffer.from(buffer));\n  }\n}\n"]}
+{"version":3,"file":"store.js","sourceRoot":"","sources":["../src/store.ts"],"names":[],"mappings":"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","sourcesContent":["import { appendFile, writeFile } from \"fs/promises\";\nimport { join } from \"path\";\nimport {\n  ensureDirExists,\n  isRecord,\n  parseJsonValue,\n  readTextFileIfExists,\n} from \"./utils/file-guards.js\";\nimport { withRetry } from \"./adapters/shared.js\";\n\nexport type { Attachment, ChannelStoreConfig, LoggedMessage } from \"./types.js\";\nimport type { Attachment, ChannelStoreConfig, LoggedMessage } from \"./types.js\";\n\nclass AttachmentDownloadHttpError extends Error {\n  constructor(\n    message: string,\n    readonly status: number,\n  ) {\n    super(message);\n  }\n}\n\nfunction isRetryableAttachmentDownloadError(error: unknown): boolean {\n  if (!(error instanceof AttachmentDownloadHttpError)) return true;\n  return error.status === 408 || error.status === 429 || error.status >= 500;\n}\n\nexport class ChannelStore {\n  private workingDir: string;\n  private botToken: string;\n  // Track recently logged message timestamps to prevent duplicates\n  // Key: \"channelId:ts\", automatically cleaned up after 60 seconds\n  private recentlyLogged = new Map<string, number>();\n\n  constructor(config: ChannelStoreConfig) {\n    this.workingDir = config.workingDir;\n    this.botToken = config.botToken;\n\n    // Ensure working directory exists\n    ensureDirExists(this.workingDir);\n  }\n\n  /**\n   * Get or create the directory for a channel/DM\n   */\n  getChannelDir(channelId: string): string {\n    const channelDir = join(this.workingDir, channelId);\n    ensureDirExists(channelDir);\n    return channelDir;\n  }\n\n  /**\n   * Generate a unique local filename for an attachment\n   */\n  generateLocalFilename(originalName: string, timestamp: string): string {\n    // Convert slack timestamp (1234567890.123456) to milliseconds\n    const ts = Math.floor(parseFloat(timestamp) * 1000);\n    // Sanitize original name (remove problematic characters)\n    const sanitized = originalName.replace(/[^a-zA-Z0-9._-]/g, \"_\");\n    return `${ts}_${sanitized}`;\n  }\n\n  /**\n   * Process attachments from a Slack message event.\n   * Downloads files before returning so callers only receive readable paths.\n   */\n  async processAttachments(\n    channelId: string,\n    files: Array<{ name?: string; url_private_download?: string; url_private?: string }>,\n    timestamp: string,\n  ): Promise<Attachment[]> {\n    const downloads: Array<Promise<Attachment>> = [];\n\n    for (const file of files) {\n      const url = file.url_private_download || file.url_private;\n      if (!url) continue;\n      if (!file.name) {\n        throw new Error(`Attachment missing name for URL: ${url}`);\n      }\n\n      const filename = this.generateLocalFilename(file.name, timestamp);\n      const localPath = `${channelId}/attachments/${filename}`;\n      const attachment: Attachment = {\n        original: file.name,\n        localPath,\n      };\n\n      downloads.push(\n        this.downloadAttachmentWithRetry(localPath, url)\n          .then(() => attachment)\n          .catch((error) => {\n            const errorMsg = error instanceof Error ? error.message : String(error);\n            throw new Error(`Failed to download attachment ${localPath}: ${errorMsg}`, {\n              cause: error,\n            });\n          }),\n      );\n    }\n\n    return Promise.all(downloads);\n  }\n\n  /**\n   * Log a message to the channel's log.jsonl\n   * Returns false if message was already logged (duplicate)\n   */\n  async logMessage(channelId: string, message: LoggedMessage): Promise<boolean> {\n    // Check for duplicate (same channel + timestamp)\n    const dedupeKey = `${channelId}:${message.ts}`;\n    if (this.recentlyLogged.has(dedupeKey)) {\n      return false; // Already logged\n    }\n\n    const logPath = join(this.getChannelDir(channelId), \"log.jsonl\");\n\n    // Ensure message has a date field\n    if (!message.date) {\n      // Parse timestamp to get date\n      let date: Date;\n      if (message.ts.includes(\".\")) {\n        // Slack timestamp format (1234567890.123456)\n        date = new Date(parseFloat(message.ts) * 1000);\n      } else {\n        // Epoch milliseconds\n        date = new Date(parseInt(message.ts, 10));\n      }\n      message.date = date.toISOString();\n    }\n\n    const line = `${JSON.stringify(message)}\\n`;\n    await appendFile(logPath, line, \"utf-8\");\n\n    // Mark as logged only after the append succeeds. Otherwise a transient\n    // write failure can make retries look like duplicates and drop messages.\n    this.recentlyLogged.set(dedupeKey, Date.now());\n    setTimeout(() => this.recentlyLogged.delete(dedupeKey), 60000);\n    return true;\n  }\n\n  /**\n   * Log a bot response\n   */\n  async logBotResponse(channelId: string, text: string, ts: string): Promise<void> {\n    await this.logMessage(channelId, {\n      date: new Date().toISOString(),\n      ts,\n      user: \"bot\",\n      text,\n      attachments: [],\n      isBot: true,\n    });\n  }\n\n  /**\n   * Get the timestamp of the last logged message for a channel\n   * Returns null if no log exists\n   */\n  getLastTimestamp(channelId: string): string | null {\n    const logPath = join(this.workingDir, channelId, \"log.jsonl\");\n    const content = readTextFileIfExists(logPath);\n    if (content === undefined) {\n      return null;\n    }\n\n    try {\n      const lines = content.trim().split(\"\\n\");\n      if (lines.length === 0 || lines[0] === \"\") {\n        return null;\n      }\n      const lastLine = lines[lines.length - 1];\n      const message = parseJsonValue(\n        lastLine,\n        (value): value is LoggedMessage => isRecord(value) && typeof value.ts === \"string\",\n        (detail) => (detail === \"unexpected JSON shape\" ? \"log entry missing timestamp\" : detail),\n      );\n      return message.ts;\n    } catch {\n      return null;\n    }\n  }\n\n  /**\n   * Download a single attachment\n   */\n  private async downloadAttachmentWithRetry(localPath: string, url: string): Promise<void> {\n    await withRetry(() => this.downloadAttachment(localPath, url), {\n      maxAttempts: 3,\n      baseDelayMs: 250,\n      isRateLimited: isRetryableAttachmentDownloadError,\n    });\n  }\n\n  private async downloadAttachment(localPath: string, url: string): Promise<void> {\n    const filePath = join(this.workingDir, localPath);\n\n    // Ensure directory exists\n    const parentDir = join(this.workingDir, localPath.substring(0, localPath.lastIndexOf(\"/\")));\n    ensureDirExists(parentDir);\n\n    const response = await fetch(url, {\n      headers: {\n        Authorization: `Bearer ${this.botToken}`,\n      },\n    });\n\n    if (!response.ok) {\n      throw new AttachmentDownloadHttpError(\n        `HTTP ${response.status}: ${response.statusText}`,\n        response.status,\n      );\n    }\n\n    const buffer = await response.arrayBuffer();\n    await writeFile(filePath, Buffer.from(buffer));\n  }\n}\n"]}

package/dist/tools/event.d.ts

@@ -1,8 +1,12 @@
 import type { AgentTool } from "@earendil-works/pi-agent-core";
+import type { ConversationKind } from "../adapter.js";
 declare const eventSchema: import("@sinclair/typebox").TObject<{
-    label: import("@sinclair/typebox").TString;
-    type: import("@sinclair/typebox").TUnion<[import("@sinclair/typebox").TLiteral<"immediate">, import("@sinclair/typebox").TLiteral<"one-shot">, import("@sinclair/typebox").TLiteral<"periodic">]>;
-    text: import("@sinclair/typebox").TString;
+    action: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TUnion<[import("@sinclair/typebox").TLiteral<"create">, import("@sinclair/typebox").TLiteral<"list">, import("@sinclair/typebox").TLiteral<"read">, import("@sinclair/typebox").TLiteral<"update">, import("@sinclair/typebox").TLiteral<"delete">]>>;
+    filename: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
+    scope: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TUnion<[import("@sinclair/typebox").TLiteral<"conversation">, import("@sinclair/typebox").TLiteral<"all">]>>;
+    label: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
+    type: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TUnion<[import("@sinclair/typebox").TLiteral<"immediate">, import("@sinclair/typebox").TLiteral<"one-shot">, import("@sinclair/typebox").TLiteral<"periodic">]>>;
+    text: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
     at: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
     schedule: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
     timezone: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
@@ -11,40 +15,11 @@ declare const eventSchema: import("@sinclair/typebox").TObject<{
 interface EventToolContext {
     platform: string;
     conversationId: string;
-    conversationKind: "direct" | "shared";
+    conversationKind: ConversationKind;
     userId: string;
 }
-export type EventPayload = {
-    type: "immediate";
-    platform: string;
-    conversationId: string;
-    conversationKind: "direct" | "shared";
-    userId: string;
-    text: string;
-} | {
-    type: "one-shot";
-    platform: string;
-    conversationId: string;
-    conversationKind: "direct" | "shared";
-    userId: string;
-    text: string;
-    at: string;
-} | {
-    type: "periodic";
-    platform: string;
-    conversationId: string;
-    conversationKind: "direct" | "shared";
-    userId: string;
-    text: string;
-    schedule: string;
-    timezone: string;
-};
-export interface EventStore {
-    write(filename: string, payload: EventPayload): Promise<{
-        path: string;
-        size: number;
-    }>;
-}
+export type { EventPayload, EventStore } from "./types.js";
+import type { EventPayload, EventStore } from "./types.js";
 export declare class HostEventStore implements EventStore {
     private readonly eventsDir;
     constructor(eventsDir: string);
@@ -53,10 +28,29 @@ export declare class HostEventStore implements EventStore {
         path: string;
         size: number;
     }>;
+    list(): Promise<Array<{
+        filename: string;
+        payload: EventPayload;
+        size: number;
+        mtimeMs: number;
+    }>>;
+    read(filename: string): Promise<{
+        filename: string;
+        payload: EventPayload;
+        size: number;
+        mtimeMs: number;
+    }>;
+    update(filename: string, payload: EventPayload): Promise<{
+        path: string;
+        size: number;
+    }>;
+    delete(filename: string): Promise<{
+        deleted: boolean;
+    }>;
+    private writePayload;
 }
 export declare function createEventTool(eventStore: EventStore): {
     tool: AgentTool<typeof eventSchema>;
     setEventContext: (context: EventToolContext) => void;
 };
-export {};
 //# sourceMappingURL=event.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"event.d.ts","sourceRoot":"","sources":["../../src/tools/event.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,+BAA+B,CAAC;AAI/D,QAAA,MAAM,WAAW;;;;;;;;EA6Bf,CAAC;AAEH,UAAU,gBAAgB;IACxB,QAAQ,EAAE,MAAM,CAAC;IACjB,cAAc,EAAE,MAAM,CAAC;IACvB,gBAAgB,EAAE,QAAQ,GAAG,QAAQ,CAAC;IACtC,MAAM,EAAE,MAAM,CAAC;CAChB;AAYD,MAAM,MAAM,YAAY,GACpB;IACE,IAAI,EAAE,WAAW,CAAC;IAClB,QAAQ,EAAE,MAAM,CAAC;IACjB,cAAc,EAAE,MAAM,CAAC;IACvB,gBAAgB,EAAE,QAAQ,GAAG,QAAQ,CAAC;IACtC,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;CACd,GACD;IACE,IAAI,EAAE,UAAU,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;IACjB,cAAc,EAAE,MAAM,CAAC;IACvB,gBAAgB,EAAE,QAAQ,GAAG,QAAQ,CAAC;IACtC,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;IACb,EAAE,EAAE,MAAM,CAAC;CACZ,GACD;IACE,IAAI,EAAE,UAAU,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;IACjB,cAAc,EAAE,MAAM,CAAC;IACvB,gBAAgB,EAAE,QAAQ,GAAG,QAAQ,CAAC;IACtC,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;CAClB,CAAC;AAEN,MAAM,WAAW,UAAU;IACzB,KAAK,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,YAAY,GAAG,OAAO,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;CACzF;AAED,qBAAa,cAAe,YAAW,UAAU;IACnC,OAAO,CAAC,QAAQ,CAAC,SAAS;IAAtC,YAA6B,SAAS,EAAE,MAAM,EAAI;IAElD,MAAM,CAAC,gBAAgB,CAAC,YAAY,EAAE,MAAM,GAAG,cAAc,CAE5D;IAEK,KAAK,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,YAAY,GAAG,OAAO,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC,CAM5F;CACF;AAED,wBAAgB,eAAe,CAAC,UAAU,EAAE,UAAU,GAAG;IACvD,IAAI,EAAE,SAAS,CAAC,OAAO,WAAW,CAAC,CAAC;IACpC,eAAe,EAAE,CAAC,OAAO,EAAE,gBAAgB,KAAK,IAAI,CAAC;CACtD,CA8DA","sourcesContent":["import { mkdir, stat, writeFile } from \"node:fs/promises\";\nimport { join } from \"node:path\";\nimport type { AgentTool } from \"@earendil-works/pi-agent-core\";\nimport { Type } from \"@sinclair/typebox\";\nimport * as log from \"../log.js\";\n\nconst eventSchema = Type.Object({\n  label: Type.String({\n    description: \"Brief description of the event you're scheduling (shown to user)\",\n  }),\n  type: Type.Union([Type.Literal(\"immediate\"), Type.Literal(\"one-shot\"), Type.Literal(\"periodic\")]),\n  text: Type.String({\n    description:\n      \"A self-contained task for the future run. Include the necessary context, tone, and constraints in the text itself because events do not inherit normal conversation history.\",\n  }),\n  at: Type.Optional(\n    Type.String({\n      description: \"ISO 8601 timestamp with offset, required for one-shot events\",\n    }),\n  ),\n  schedule: Type.Optional(\n    Type.String({\n      description: \"Cron schedule, required for periodic events\",\n    }),\n  ),\n  timezone: Type.Optional(\n    Type.String({\n      description: \"IANA timezone, required for periodic events\",\n    }),\n  ),\n  filenamePrefix: Type.Optional(\n    Type.String({\n      description: \"Optional filename prefix for the event file\",\n    }),\n  ),\n});\n\ninterface EventToolContext {\n  platform: string;\n  conversationId: string;\n  conversationKind: \"direct\" | \"shared\";\n  userId: string;\n}\n\ntype EventToolParams = {\n  label: string;\n  type: \"immediate\" | \"one-shot\" | \"periodic\";\n  text: string;\n  at?: string;\n  schedule?: string;\n  timezone?: string;\n  filenamePrefix?: string;\n};\n\nexport type EventPayload =\n  | {\n      type: \"immediate\";\n      platform: string;\n      conversationId: string;\n      conversationKind: \"direct\" | \"shared\";\n      userId: string;\n      text: string;\n    }\n  | {\n      type: \"one-shot\";\n      platform: string;\n      conversationId: string;\n      conversationKind: \"direct\" | \"shared\";\n      userId: string;\n      text: string;\n      at: string;\n    }\n  | {\n      type: \"periodic\";\n      platform: string;\n      conversationId: string;\n      conversationKind: \"direct\" | \"shared\";\n      userId: string;\n      text: string;\n      schedule: string;\n      timezone: string;\n    };\n\nexport interface EventStore {\n  write(filename: string, payload: EventPayload): Promise<{ path: string; size: number }>;\n}\n\nexport class HostEventStore implements EventStore {\n  constructor(private readonly eventsDir: string) {}\n\n  static fromWorkspaceDir(workspaceDir: string): HostEventStore {\n    return new HostEventStore(join(workspaceDir, \"events\"));\n  }\n\n  async write(filename: string, payload: EventPayload): Promise<{ path: string; size: number }> {\n    await mkdir(this.eventsDir, { recursive: true });\n    const filePath = join(this.eventsDir, filename);\n    await writeFile(filePath, JSON.stringify(payload) + \"\\n\", \"utf-8\");\n    const fileStat = await stat(filePath);\n    return { path: filePath, size: fileStat.size };\n  }\n}\n\nexport function createEventTool(eventStore: EventStore): {\n  tool: AgentTool<typeof eventSchema>;\n  setEventContext: (context: EventToolContext) => void;\n} {\n  let eventContext: EventToolContext | null = null;\n\n  const tool: AgentTool<typeof eventSchema> = {\n    name: \"event\",\n    label: \"event\",\n    description:\n      \"Schedule an immediate, one-shot, or periodic event for the current conversation. Write text as a self-contained task with any needed context, tone, or constraints because events do not inherit normal conversation history. This automatically writes to the correct events directory and fills the current platform, conversation, conversation kind, and requester userId.\",\n    parameters: eventSchema,\n    execute: async (_toolCallId: string, params: EventToolParams, signal?: AbortSignal) => {\n      if (signal?.aborted) {\n        throw new Error(\"Operation aborted\");\n      }\n\n      if (!eventContext) {\n        throw new Error(\"Event context not configured\");\n      }\n\n      const payload = buildEventPayload(params, eventContext);\n      const prefix = sanitizeFileSegment(params.filenamePrefix || payload.type || \"event\");\n      const filename = `${prefix}-${Date.now()}.json`;\n\n      log.logInfo(\n        `Writing event file via control plane store: ${filename} (type=${payload.type}, platform=${payload.platform}, conversation=${payload.conversationId})`,\n      );\n\n      try {\n        const result = await eventStore.write(filename, payload);\n        log.logInfo(\n          `Wrote event file via control plane store: ${result.path} (${result.size} bytes)`,\n        );\n      } catch (err) {\n        log.logWarning(\n          `Failed to write event file via control plane store: ${filename}`,\n          String(err),\n        );\n        throw err;\n      }\n\n      return {\n        content: [\n          {\n            type: \"text\",\n            text:\n              payload.type === \"periodic\"\n                ? `Scheduled periodic event ${filename} for ${payload.platform}/${payload.conversationId} (${payload.schedule} ${payload.timezone})`\n                : payload.type === \"one-shot\"\n                  ? `Scheduled one-shot event ${filename} for ${payload.platform}/${payload.conversationId} at ${payload.at}`\n                  : `Queued immediate event ${filename} for ${payload.platform}/${payload.conversationId}`,\n          },\n        ],\n        details: undefined,\n      };\n    },\n  };\n\n  return {\n    tool,\n    setEventContext: (context: EventToolContext) => {\n      eventContext = context;\n    },\n  };\n}\n\nfunction buildEventPayload(params: EventToolParams, context: EventToolContext): EventPayload {\n  const base = {\n    platform: context.platform,\n    conversationId: context.conversationId,\n    conversationKind: context.conversationKind,\n    userId: context.userId,\n    text: params.text,\n  };\n\n  if (params.type === \"immediate\") {\n    return {\n      ...base,\n      type: \"immediate\",\n    };\n  }\n\n  if (params.type === \"one-shot\") {\n    if (!params.at) {\n      throw new Error(\"`at` is required for one-shot events\");\n    }\n\n    const atTime = new Date(params.at).getTime();\n    if (Number.isNaN(atTime)) {\n      throw new Error(\"`at` must be a valid ISO 8601 timestamp with UTC offset\");\n    }\n    if (atTime <= Date.now()) {\n      throw new Error(\n        `\\`at\\` must be in the future; got ${params.at} (now=${new Date().toISOString()}). Check the timezone offset.`,\n      );\n    }\n\n    // No sessionKey or threadTs: reminders should fire as top-level messages, not buried in old threads\n    return { ...base, type: \"one-shot\", at: params.at };\n  }\n\n  if (!params.schedule) {\n    throw new Error(\"`schedule` is required for periodic events\");\n  }\n  if (!params.timezone) {\n    throw new Error(\"`timezone` is required for periodic events\");\n  }\n  return {\n    ...base,\n    type: \"periodic\",\n    schedule: params.schedule,\n    timezone: params.timezone,\n  };\n}\n\nfunction sanitizeFileSegment(value: string): string {\n  const sanitized = value\n    .trim()\n    .toLowerCase()\n    .replace(/[^a-z0-9._-]+/g, \"-\")\n    .replace(/^-+|-+$/g, \"\");\n  return sanitized || \"event\";\n}\n"]}
+{"version":3,"file":"event.d.ts","sourceRoot":"","sources":["../../src/tools/event.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,+BAA+B,CAAC;AAE/D,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAC;AAGtD,QAAA,MAAM,WAAW;;;;;;;;;;;EA0Df,CAAC;AAEH,UAAU,gBAAgB;IACxB,QAAQ,EAAE,MAAM,CAAC;IACjB,cAAc,EAAE,MAAM,CAAC;IACvB,gBAAgB,EAAE,gBAAgB,CAAC;IACnC,MAAM,EAAE,MAAM,CAAC;CAChB;AAeD,YAAY,EAAE,YAAY,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAC3D,OAAO,KAAK,EAAE,YAAY,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAE3D,qBAAa,cAAe,YAAW,UAAU;IACnC,OAAO,CAAC,QAAQ,CAAC,SAAS;IAAtC,YAA6B,SAAS,EAAE,MAAM,EAAI;IAElD,MAAM,CAAC,gBAAgB,CAAC,YAAY,EAAE,MAAM,GAAG,cAAc,CAE5D;IAEK,KAAK,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,YAAY,GAAG,OAAO,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC,CAE5F;IAEK,IAAI,IAAI,OAAO,CACnB,KAAK,CAAC;QAAE,QAAQ,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,YAAY,CAAC;QAAC,IAAI,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC,CAClF,CASA;IAEK,IAAI,CACR,QAAQ,EAAE,MAAM,GACf,OAAO,CAAC;QAAE,QAAQ,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,YAAY,CAAC;QAAC,IAAI,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC,CAWrF;IAEK,MAAM,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,YAAY,GAAG,OAAO,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC,CAE7F;IAEK,MAAM,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC;QAAE,OAAO,EAAE,OAAO,CAAA;KAAE,CAAC,CAI5D;YAEa,YAAY;CAiB3B;AAED,wBAAgB,eAAe,CAAC,UAAU,EAAE,UAAU,GAAG;IACvD,IAAI,EAAE,SAAS,CAAC,OAAO,WAAW,CAAC,CAAC;IACpC,eAAe,EAAE,CAAC,OAAO,EAAE,gBAAgB,KAAK,IAAI,CAAC;CACtD,CAuGA","sourcesContent":["import { constants } from \"node:fs\";\nimport { mkdir, open, readdir, readFile, rm, stat, writeFile } from \"node:fs/promises\";\nimport { basename, join } from \"node:path\";\nimport type { AgentTool } from \"@earendil-works/pi-agent-core\";\nimport { Type } from \"@sinclair/typebox\";\nimport type { ConversationKind } from \"../adapter.js\";\nimport * as log from \"../log.js\";\n\nconst eventSchema = Type.Object({\n  action: Type.Optional(\n    Type.Union(\n      [\n        Type.Literal(\"create\"),\n        Type.Literal(\"list\"),\n        Type.Literal(\"read\"),\n        Type.Literal(\"update\"),\n        Type.Literal(\"delete\"),\n      ],\n      { description: \"CRUD action. Defaults to create for backward compatibility.\" },\n    ),\n  ),\n  filename: Type.Optional(\n    Type.String({\n      description: \"Event filename for read, update, or delete actions\",\n    }),\n  ),\n  scope: Type.Optional(\n    Type.Union([Type.Literal(\"conversation\"), Type.Literal(\"all\")], {\n      description:\n        \"List scope. Defaults to conversation, which only shows events for the current conversation. Use all only when the user explicitly asks for all events.\",\n    }),\n  ),\n  label: Type.Optional(\n    Type.String({\n      description: \"Brief description of the event you're scheduling (shown to user)\",\n    }),\n  ),\n  type: Type.Optional(\n    Type.Union([Type.Literal(\"immediate\"), Type.Literal(\"one-shot\"), Type.Literal(\"periodic\")]),\n  ),\n  text: Type.Optional(\n    Type.String({\n      description:\n        \"A self-contained task for the future run. Include the necessary context, tone, and constraints in the text itself because events do not inherit normal conversation history.\",\n    }),\n  ),\n  at: Type.Optional(\n    Type.String({\n      description: \"ISO 8601 timestamp with offset, required for one-shot events\",\n    }),\n  ),\n  schedule: Type.Optional(\n    Type.String({\n      description: \"Cron schedule, required for periodic events\",\n    }),\n  ),\n  timezone: Type.Optional(\n    Type.String({\n      description: \"IANA timezone, required for periodic events\",\n    }),\n  ),\n  filenamePrefix: Type.Optional(\n    Type.String({\n      description: \"Optional filename prefix for the event file\",\n    }),\n  ),\n});\n\ninterface EventToolContext {\n  platform: string;\n  conversationId: string;\n  conversationKind: ConversationKind;\n  userId: string;\n}\n\ntype EventToolParams = {\n  action?: \"create\" | \"list\" | \"read\" | \"update\" | \"delete\";\n  filename?: string;\n  scope?: \"conversation\" | \"all\";\n  label?: string;\n  type?: \"immediate\" | \"one-shot\" | \"periodic\";\n  text?: string;\n  at?: string;\n  schedule?: string;\n  timezone?: string;\n  filenamePrefix?: string;\n};\n\nexport type { EventPayload, EventStore } from \"./types.js\";\nimport type { EventPayload, EventStore } from \"./types.js\";\n\nexport class HostEventStore implements EventStore {\n  constructor(private readonly eventsDir: string) {}\n\n  static fromWorkspaceDir(workspaceDir: string): HostEventStore {\n    return new HostEventStore(join(workspaceDir, \"events\"));\n  }\n\n  async write(filename: string, payload: EventPayload): Promise<{ path: string; size: number }> {\n    return this.writePayload(filename, payload);\n  }\n\n  async list(): Promise<\n    Array<{ filename: string; payload: EventPayload; size: number; mtimeMs: number }>\n  > {\n    await mkdir(this.eventsDir, { recursive: true });\n    const entries = await readdir(this.eventsDir, { withFileTypes: true });\n    const events = await Promise.all(\n      entries\n        .filter((entry) => entry.isFile() && entry.name.endsWith(\".json\"))\n        .map(async (entry) => this.read(entry.name)),\n    );\n    return events.toSorted((a, b) => a.filename.localeCompare(b.filename));\n  }\n\n  async read(\n    filename: string,\n  ): Promise<{ filename: string; payload: EventPayload; size: number; mtimeMs: number }> {\n    const safeFilename = validateEventFilename(filename);\n    const filePath = join(this.eventsDir, safeFilename);\n    const [raw, fileStat] = await Promise.all([readFile(filePath, \"utf-8\"), stat(filePath)]);\n    const parsed = JSON.parse(raw) as EventPayload;\n    return {\n      filename: safeFilename,\n      payload: parsed,\n      size: fileStat.size,\n      mtimeMs: fileStat.mtimeMs,\n    };\n  }\n\n  async update(filename: string, payload: EventPayload): Promise<{ path: string; size: number }> {\n    return this.writePayload(filename, payload, constants.O_WRONLY | constants.O_TRUNC);\n  }\n\n  async delete(filename: string): Promise<{ deleted: boolean }> {\n    const safeFilename = validateEventFilename(filename);\n    await rm(join(this.eventsDir, safeFilename), { force: true });\n    return { deleted: true };\n  }\n\n  private async writePayload(\n    filename: string,\n    payload: EventPayload,\n    flag?: string | number,\n  ): Promise<{ path: string; size: number }> {\n    await mkdir(this.eventsDir, { recursive: true });\n    const safeFilename = validateEventFilename(filename);\n    const filePath = join(this.eventsDir, safeFilename);\n    if (flag === undefined) {\n      await writeFile(filePath, JSON.stringify(payload) + \"\\n\", \"utf-8\");\n    } else {\n      await using file = await open(filePath, flag);\n      await file.writeFile(JSON.stringify(payload) + \"\\n\", \"utf-8\");\n    }\n    const fileStat = await stat(filePath);\n    return { path: filePath, size: fileStat.size };\n  }\n}\n\nexport function createEventTool(eventStore: EventStore): {\n  tool: AgentTool<typeof eventSchema>;\n  setEventContext: (context: EventToolContext) => void;\n} {\n  let eventContext: EventToolContext | null = null;\n\n  const tool: AgentTool<typeof eventSchema> = {\n    name: \"event\",\n    label: \"event\",\n    description:\n      \"CRUD tool for scheduled events. Create immediate, one-shot, or periodic events for the current conversation. List defaults to events for the current conversation only; use scope=all only when the user explicitly asks to list all events. Event text must be self-contained because events do not inherit normal conversation history.\",\n    parameters: eventSchema,\n    execute: async (_toolCallId: string, params: EventToolParams, signal?: AbortSignal) => {\n      if (signal?.aborted) {\n        throw new Error(\"Operation aborted\");\n      }\n\n      if (!eventContext) {\n        throw new Error(\"Event context not configured\");\n      }\n\n      const action = params.action ?? \"create\";\n\n      if (action === \"list\") {\n        const events = await eventStore.list();\n        const conversationId = eventContext.conversationId;\n        const scopedEvents =\n          params.scope === \"all\"\n            ? events\n            : events.filter((event) => event.payload.conversationId === conversationId);\n        return {\n          content: [\n            {\n              type: \"text\",\n              text: JSON.stringify(\n                {\n                  scope: params.scope ?? \"conversation\",\n                  conversationId: params.scope === \"all\" ? undefined : conversationId,\n                  events: scopedEvents,\n                },\n                null,\n                2,\n              ),\n            },\n          ],\n          details: undefined,\n        };\n      }\n\n      if (action === \"read\") {\n        const filename = requireFilename(params);\n        const event = await eventStore.read(filename);\n        return {\n          content: [{ type: \"text\", text: JSON.stringify(event, null, 2) }],\n          details: undefined,\n        };\n      }\n\n      if (action === \"delete\") {\n        const filename = requireFilename(params);\n        await eventStore.delete(filename);\n        return {\n          content: [{ type: \"text\", text: `Deleted event ${filename}` }],\n          details: undefined,\n        };\n      }\n\n      const payload = buildEventPayload(params, eventContext);\n      const filename =\n        action === \"update\"\n          ? requireFilename(params)\n          : `${sanitizeFileSegment(params.filenamePrefix || payload.type || \"event\")}-${Date.now()}.json`;\n\n      log.logInfo(\n        `${action === \"update\" ? \"Updating\" : \"Writing\"} event file via control plane store: ${filename} (type=${payload.type}, platform=${payload.platform}, conversation=${payload.conversationId})`,\n      );\n\n      try {\n        const result =\n          action === \"update\"\n            ? await eventStore.update(filename, payload)\n            : await eventStore.write(filename, payload);\n        log.logInfo(\n          `${action === \"update\" ? \"Updated\" : \"Wrote\"} event file via control plane store: ${result.path} (${result.size} bytes)`,\n        );\n      } catch (err) {\n        log.logWarning(\n          `Failed to ${action === \"update\" ? \"update\" : \"write\"} event file via control plane store: ${filename}`,\n          String(err),\n        );\n        throw err;\n      }\n\n      return {\n        content: [{ type: \"text\", text: formatEventWriteResult(action, filename, payload) }],\n        details: undefined,\n      };\n    },\n  };\n\n  return {\n    tool,\n    setEventContext: (context: EventToolContext) => {\n      eventContext = context;\n    },\n  };\n}\n\nfunction buildEventPayload(params: EventToolParams, context: EventToolContext): EventPayload {\n  if (!params.type) {\n    throw new Error(\"`type` is required for create and update actions\");\n  }\n  if (!params.text) {\n    throw new Error(\"`text` is required for create and update actions\");\n  }\n\n  const base = {\n    platform: context.platform,\n    conversationId: context.conversationId,\n    conversationKind: context.conversationKind,\n    userId: context.userId,\n    text: params.text,\n  };\n\n  if (params.type === \"immediate\") {\n    return {\n      ...base,\n      type: \"immediate\",\n    };\n  }\n\n  if (params.type === \"one-shot\") {\n    if (!params.at) {\n      throw new Error(\"`at` is required for one-shot events\");\n    }\n\n    const atTime = new Date(params.at).getTime();\n    if (Number.isNaN(atTime)) {\n      throw new Error(\"`at` must be a valid ISO 8601 timestamp with UTC offset\");\n    }\n    if (atTime <= Date.now()) {\n      throw new Error(\n        `\\`at\\` must be in the future; got ${params.at} (now=${new Date().toISOString()}). Check the timezone offset.`,\n      );\n    }\n\n    // No sessionKey or threadTs: reminders should fire as top-level messages, not buried in old threads\n    return { ...base, type: \"one-shot\", at: params.at };\n  }\n\n  if (!params.schedule) {\n    throw new Error(\"`schedule` is required for periodic events\");\n  }\n  if (!params.timezone) {\n    throw new Error(\"`timezone` is required for periodic events\");\n  }\n  return {\n    ...base,\n    type: \"periodic\",\n    schedule: params.schedule,\n    timezone: params.timezone,\n  };\n}\n\nfunction formatEventWriteResult(\n  action: \"create\" | \"update\",\n  filename: string,\n  payload: EventPayload,\n): string {\n  const scheduledVerb = action === \"update\" ? \"Updated\" : \"Scheduled\";\n  const immediateVerb = action === \"update\" ? \"Updated\" : \"Queued\";\n  switch (payload.type) {\n    case \"periodic\":\n      return `${scheduledVerb} periodic event ${filename} for ${payload.platform}/${payload.conversationId} (${payload.schedule} ${payload.timezone})`;\n    case \"one-shot\":\n      return `${scheduledVerb} one-shot event ${filename} for ${payload.platform}/${payload.conversationId} at ${payload.at}`;\n    case \"immediate\":\n      return `${immediateVerb} immediate event ${filename} for ${payload.platform}/${payload.conversationId}`;\n  }\n}\n\nfunction requireFilename(params: EventToolParams): string {\n  if (!params.filename) {\n    throw new Error(\"`filename` is required for read, update, and delete actions\");\n  }\n  return validateEventFilename(params.filename);\n}\n\nfunction validateEventFilename(filename: string): string {\n  const trimmed = filename.trim();\n  if (\n    !trimmed ||\n    trimmed !== basename(trimmed) ||\n    trimmed.includes(\"..\") ||\n    !trimmed.endsWith(\".json\")\n  ) {\n    throw new Error(\"Invalid event filename\");\n  }\n  return trimmed;\n}\n\nfunction sanitizeFileSegment(value: string): string {\n  const sanitized = value\n    .trim()\n    .toLowerCase()\n    .replace(/[^a-z0-9._-]+/g, \"-\")\n    .replace(/^-+|-+$/g, \"\");\n  return sanitized || \"event\";\n}\n"]}