@geminixiang/mikan 1.0.0-beta.39 → 1.0.0-beta.40

package/dist/events.js

@@ -1,13 +1,13 @@
 import { Cron } from "croner";
-import { existsSync, readdirSync, readFileSync, statSync, unlinkSync, watch, } from "fs";
-import { readFile } from "fs/promises";
-import { join } from "path";
+import { existsSync, readdirSync, readFileSync, statSync, unlinkSync, watch, } from "node:fs";
+import { readFile } from "node:fs/promises";
+import { join } from "node:path";
 import { createConversationEvent } from "./adapter.js";
 import { parseEventPayload } from "./harness/event-format.js";
 import { ensureDirExists } from "./utils/file-guards.js";
 import * as log from "./log.js";
 import { reportUserFacingError } from "./observability/sentry.js";
-import { inferConversationKind } from "./sessions/policy.js";
+import { inferConversationKind } from "./sessions/session-key.js";
 const DEBOUNCE_MS = 100;
 const MAX_RETRIES = 3;
 const RETRY_BASE_MS = 100;
@@ -232,8 +232,9 @@ export class EventsWatcher {
             }
             return platform;
         }
-        if (availablePlatforms.length === 1) {
-            return availablePlatforms[0];
+        const only = availablePlatforms.length === 1 ? availablePlatforms[0] : undefined;
+        if (only !== undefined) {
+            return only;
         }
         throw new Error(`Missing required field 'platform' in ${filename}. Available platforms: ${availablePlatforms.join(", ")}`);
     }

package/dist/events.js.map

@@ -1 +1 @@
-{"version":3,"file":"events.js","sourceRoot":"","sources":["../src/events.ts"],"names":[],"mappings":"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","sourcesContent":["import { 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 { createConversationEvent } from \"./adapter.js\";\nimport type { MessagingBot, ConversationKind } from \"./adapter.js\";\nimport { parseEventPayload } from \"./harness/event-format.js\";\nimport { ensureDirExists } from \"./utils/file-guards.js\";\nimport * as log from \"./log.js\";\nimport { reportUserFacingError } from \"./observability/sentry.js\";\nimport { inferConversationKind } from \"./sessions/policy.js\";\n\nexport type {\n  ImmediateEvent,\n  MikanEvent,\n  OneShotEvent,\n  PeriodicEvent,\n  PeriodicEventInfo,\n} from \"./types.js\";\nimport type { ImmediateEvent, MikanEvent, OneShotEvent, PeriodicEvent } from \"./types.js\";\n\nimport type { PeriodicEventInfo } from \"./types.js\";\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 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, MessagingBot>,\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\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 new Promise((resolve) => setTimeout(resolve, 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.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    }\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 new Promise((resolve) => setTimeout(resolve, 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 {\n    // Format validation (shape, per-type fields, channelId alias) is owned by\n    // the event-format module; this watcher only resolves what needs runtime\n    // context: the target platform and the conversation kind.\n    const payload = parseEventPayload(content, filename);\n    const platform = this.resolvePlatform(payload.platform, filename);\n    const conversationKind = this.resolveConversationKind(\n      platform,\n      payload.conversationId,\n      payload.conversationKind,\n    );\n    return { ...payload, platform, conversationKind };\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      log.logInfo(`Executing one-shot event: ${filename}`);\n      this.execute(filename, event);\n    }, delay);\n\n    this.timers.set(filename, timer);\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      this.reportEventDeliveryFailure(filename, event, deleteAfter, \"missing_bot\");\n      if (deleteAfter) {\n        this.deleteFile(filename, \"missing-bot\");\n      }\n      return;\n    }\n\n    const eventId = filename.replace(/\\.json$/i, \"\");\n    const botEvent = createConversationEvent({\n      platform: event.platform as import(\"./adapter.js\").PlatformName,\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      this.reportEventDeliveryFailure(filename, event, deleteAfter, \"queue_full\");\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 reportEventDeliveryFailure(\n    filename: string,\n    event: MikanEvent,\n    deleteAfter: boolean,\n    failure: \"missing_bot\" | \"queue_full\",\n  ): void {\n    const reason = failure === \"missing_bot\" ? \"missing bot\" : \"queue full\";\n    reportUserFacingError(new Error(`Scheduled event delivery failed: ${reason}`), {\n      domain: \"events\",\n      surface: \"event_delivery\",\n      operation: \"event_execute\",\n      severity: \"error\",\n      platform: event.platform,\n      context: {\n        failure,\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  }\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"]}
+{"version":3,"file":"events.js","sourceRoot":"","sources":["../src/events.ts"],"names":[],"mappings":"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","sourcesContent":["import { Cron } from \"croner\";\nimport {\n  existsSync,\n  type FSWatcher,\n  readdirSync,\n  readFileSync,\n  statSync,\n  unlinkSync,\n  watch,\n} from \"node:fs\";\nimport { readFile } from \"node:fs/promises\";\nimport { join } from \"node:path\";\nimport { createConversationEvent } from \"./adapter.js\";\nimport type { ConversationKind, MessagingBot, PlatformName } from \"./adapter.js\";\nimport { parseEventPayload } from \"./harness/event-format.js\";\nimport { ensureDirExists } from \"./utils/file-guards.js\";\nimport * as log from \"./log.js\";\nimport { reportUserFacingError } from \"./observability/sentry.js\";\nimport { inferConversationKind } from \"./sessions/session-key.js\";\n\nexport type {\n  ImmediateEvent,\n  MikanEvent,\n  OneShotEvent,\n  PeriodicEvent,\n  PeriodicEventInfo,\n} from \"./types.js\";\nimport type { ImmediateEvent, MikanEvent, OneShotEvent, PeriodicEvent } from \"./types.js\";\n\nimport type { PeriodicEventInfo } from \"./types.js\";\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 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, MessagingBot>,\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\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 new Promise((resolve) => setTimeout(resolve, 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.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    }\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 new Promise((resolve) => setTimeout(resolve, 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 {\n    // Format validation (shape, per-type fields, channelId alias) is owned by\n    // the event-format module; this watcher only resolves what needs runtime\n    // context: the target platform and the conversation kind.\n    const payload = parseEventPayload(content, filename);\n    const platform = this.resolvePlatform(payload.platform, filename);\n    const conversationKind = this.resolveConversationKind(\n      platform,\n      payload.conversationId,\n      payload.conversationKind,\n    );\n    return { ...payload, platform, conversationKind };\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    const only = availablePlatforms.length === 1 ? availablePlatforms[0] : undefined;\n    if (only !== undefined) {\n      return only;\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      log.logInfo(`Executing one-shot event: ${filename}`);\n      this.execute(filename, event);\n    }, delay);\n\n    this.timers.set(filename, timer);\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      this.reportEventDeliveryFailure(filename, event, deleteAfter, \"missing_bot\");\n      if (deleteAfter) {\n        this.deleteFile(filename, \"missing-bot\");\n      }\n      return;\n    }\n\n    const eventId = filename.replace(/\\.json$/i, \"\");\n    const botEvent = createConversationEvent({\n      platform: event.platform as PlatformName,\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      this.reportEventDeliveryFailure(filename, event, deleteAfter, \"queue_full\");\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 reportEventDeliveryFailure(\n    filename: string,\n    event: MikanEvent,\n    deleteAfter: boolean,\n    failure: \"missing_bot\" | \"queue_full\",\n  ): void {\n    const reason = failure === \"missing_bot\" ? \"missing bot\" : \"queue full\";\n    reportUserFacingError(new Error(`Scheduled event delivery failed: ${reason}`), {\n      domain: \"events\",\n      surface: \"event_delivery\",\n      operation: \"event_execute\",\n      severity: \"error\",\n      platform: event.platform,\n      context: {\n        failure,\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  }\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"]}

package/dist/execution-resolver.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"execution-resolver.d.ts","sourceRoot":"","sources":["../src/execution-resolver.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAU,SAAS,EAAE,MAAM,mBAAmB,CAAC;AAG3D,OAAO,EAAE,sBAAsB,EAAuB,MAAM,kBAAkB,CAAC;AAC/E,OAAO,EAIL,KAAK,QAAQ,EACb,KAAK,aAAa,EACnB,MAAM,oBAAoB,CAAC;AAE5B,OAAO,EAA4B,KAAK,YAAY,EAAE,MAAM,kBAAkB,CAAC;AAW/E,YAAY,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAC/C,OAAO,KAAK,EAAE,YAAY,EAAiB,MAAM,YAAY,CAAC;AAE9D,qBAAa,sBAAsB;IAE/B,OAAO,CAAC,UAAU;IAClB,OAAO,CAAC,YAAY;IACpB,OAAO,CAAC,WAAW;IACnB,OAAO,CAAC,SAAS;IAJnB,YACU,UAAU,EAAE,aAAa,EACzB,YAAY,EAAE,YAAY,EAC1B,WAAW,EAAE,sBAAsB,GAAG,SAAS,EAC/C,SAAS,EAAE,SAAS,EAC1B;IAEE,OAAO,CAAC,OAAO,EAAE,YAAY,GAAG,OAAO,CAAC,QAAQ,CAAC,CAOtD;IAED,OAAO,CAAC,WAAW;IAsCnB,OAAO,CAAC,wBAAwB;IAuBhC,OAAO,CAAC,oBAAoB;IAuB5B,OAAO,CAAC,wBAAwB;IA0ChC,OAAO,CAAC,aAAa;CAiCtB"}
+{"version":3,"file":"execution-resolver.d.ts","sourceRoot":"","sources":["../src/execution-resolver.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAU,SAAS,EAAE,MAAM,mBAAmB,CAAC;AAG3D,OAAO,EAAE,sBAAsB,EAAuB,MAAM,kBAAkB,CAAC;AAC/E,OAAO,EAIL,KAAK,QAAQ,EACb,KAAK,aAAa,EACnB,MAAM,oBAAoB,CAAC;AAE5B,OAAO,EAA4B,KAAK,YAAY,EAAE,MAAM,kBAAkB,CAAC;AAU/E,YAAY,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAC/C,OAAO,KAAK,EAAE,YAAY,EAAiB,MAAM,YAAY,CAAC;AAE9D,qBAAa,sBAAsB;IAE/B,OAAO,CAAC,UAAU;IAClB,OAAO,CAAC,YAAY;IACpB,OAAO,CAAC,WAAW;IACnB,OAAO,CAAC,SAAS;IAJnB,YACU,UAAU,EAAE,aAAa,EACzB,YAAY,EAAE,YAAY,EAC1B,WAAW,EAAE,sBAAsB,GAAG,SAAS,EAC/C,SAAS,EAAE,SAAS,EAC1B;IAEE,OAAO,CAAC,OAAO,EAAE,YAAY,GAAG,OAAO,CAAC,QAAQ,CAAC,CAOtD;IAED,OAAO,CAAC,WAAW;IAsCnB,OAAO,CAAC,wBAAwB;IAuBhC,OAAO,CAAC,oBAAoB;IAuB5B,OAAO,CAAC,wBAAwB;IA0ChC,OAAO,CAAC,aAAa;CAkCtB"}

package/dist/execution-resolver.js

@@ -5,8 +5,7 @@ import { DockerContainerManager } from "./provisioner.js";
 import { createExecutor, getSandboxCredentialCapabilities, getSandboxWorkspaceCapabilities, } from "./sandbox/index.js";
 import { reportUserFacingError } from "./observability/sentry.js";
 import { normalizeSharedVaultName } from "./vault/index.js";
-import { resolveVaultInjection } from "./vault/injection.js";
-import { allowsAmbientDefaultSharedVault } from "./vault/policy.js";
+import { allowsAmbientDefaultSharedVault, resolveVaultInjection } from "./vault/index.js";
 import { credentialAuthorizationKey, legacyExactCredentialAuthorizationKey, runtimeResourceKey, scopeCloudflareSandboxId, } from "./sandbox/identity.js";
 import { resolveWorkspaceProjection } from "./workspace-projection/index.js";
 export class ActorExecutionResolver {
@@ -139,6 +138,8 @@ export class ActorExecutionResolver {
         const protectedMounts = [...workspaceMounts, ...packageMounts];
         for (let index = 0; index < vaultMounts.length; index += 1) {
             const vaultMount = vaultMounts[index];
+            if (vaultMount === undefined)
+                continue;
             const workspaceCollision = protectedMounts.find((protectedMount) => targetsOverlap(protectedMount.target, vaultMount.target));
             if (workspaceCollision) {
                 throw new Error(`Vault mount target "${vaultMount.target}" overlaps protected workspace target "${workspaceCollision.target}"`);

package/dist/execution-resolver.js.map

@@ -1 +1 @@
-{"version":3,"file":"execution-resolver.js","sourceRoot":"","sources":["../src/execution-resolver.ts"],"names":[],"mappings":"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","sourcesContent":["import { posix } from \"node:path\";\nimport type { Office, Workspace } from \"./office/index.js\";\nimport { conversationPackageSkillMounts } from \"./packages/index.js\";\nimport { loadGlobalSettings } from \"./config.js\";\nimport { DockerContainerManager, type ContainerMount } from \"./provisioner.js\";\nimport {\n  createExecutor,\n  getSandboxCredentialCapabilities,\n  getSandboxWorkspaceCapabilities,\n  type Executor,\n  type SandboxConfig,\n} from \"./sandbox/index.js\";\nimport { reportUserFacingError } from \"./observability/sentry.js\";\nimport { normalizeSharedVaultName, type VaultManager } from \"./vault/index.js\";\nimport { resolveVaultInjection } from \"./vault/injection.js\";\nimport { allowsAmbientDefaultSharedVault } from \"./vault/policy.js\";\nimport {\n  credentialAuthorizationKey,\n  legacyExactCredentialAuthorizationKey,\n  runtimeResourceKey,\n  scopeCloudflareSandboxId,\n} from \"./sandbox/identity.js\";\nimport { resolveWorkspaceProjection } from \"./workspace-projection/index.js\";\n\nexport type { ActorContext } from \"./types.js\";\nimport type { ActorContext, ExecutionPlan } from \"./types.js\";\n\nexport class ActorExecutionResolver {\n  constructor(\n    private baseConfig: SandboxConfig,\n    private vaultManager: VaultManager,\n    private provisioner: DockerContainerManager | undefined,\n    private workspace: Workspace,\n  ) {}\n\n  async resolve(context: ActorContext): Promise<Executor> {\n    const plan = this.resolvePlan(context);\n    return createExecutor(\n      plan.sandboxConfig,\n      plan.env,\n      this.buildEnsureReadyCallback(plan, context.address.conversationId),\n    );\n  }\n\n  private resolvePlan(context: ActorContext): ExecutionPlan {\n    const scope = { userId: context.userId, address: context.address };\n    const credentialKey = credentialAuthorizationKey(this.baseConfig, scope);\n    const legacyCredentialKey = legacyExactCredentialAuthorizationKey(this.baseConfig, scope);\n    const resourceKey = runtimeResourceKey(this.baseConfig, {\n      userId: context.userId,\n      conversationId: context.address.conversationId,\n    });\n    this.ensureDefaultSharedVault(credentialKey, legacyCredentialKey, context.trustModel);\n\n    const vault =\n      this.vaultManager.resolve(credentialKey) ??\n      (legacyCredentialKey ? this.vaultManager.resolve(legacyCredentialKey) : undefined);\n    const capabilities = getSandboxCredentialCapabilities(this.baseConfig.type);\n    const workspaceCapabilities = getSandboxWorkspaceCapabilities(this.baseConfig.type);\n    const office = this.workspace.office(context.address);\n    const workspaceProjection = resolveWorkspaceProjection(office);\n    const injection = resolveVaultInjection({\n      vault,\n      capabilities,\n      sandboxType: this.baseConfig.type,\n      address: office.address,\n    });\n    const mounts = this.resolveMounts(office, injection.mounts, workspaceProjection);\n    if (workspaceProjection.doorPolicy === \"isolated\" && !workspaceCapabilities.managedProjection) {\n      throw new Error(\n        `Sandbox '${this.baseConfig.type}' cannot provide an isolated conversation office; use image:* or gondolin:default, or explicitly choose trusted workspace policy`,\n      );\n    }\n    return {\n      credentialKey,\n      resourceKey,\n      sandboxConfig: this.resolveSandboxConfig(resourceKey, mounts),\n      env: injection.env,\n      mounts,\n    };\n  }\n\n  private ensureDefaultSharedVault(\n    credentialKey: string,\n    legacyCredentialKey: string | undefined,\n    trustModel: ActorContext[\"trustModel\"],\n  ): void {\n    if (!allowsAmbientDefaultSharedVault({ trustModel, sandboxType: this.baseConfig.type })) return;\n    if (\n      this.vaultManager.hasEntry(credentialKey) ||\n      (legacyCredentialKey && this.vaultManager.hasEntry(legacyCredentialKey))\n    ) {\n      return;\n    }\n\n    let profile: string | undefined;\n    try {\n      profile = loadGlobalSettings().sandbox?.defaultSharedVault;\n    } catch {\n      return;\n    }\n    if (!profile || normalizeSharedVaultName(profile) !== profile) return;\n    this.vaultManager.copySharedVaultTo(profile, credentialKey);\n  }\n\n  private resolveSandboxConfig(resourceKey: string, mounts: ContainerMount[]): SandboxConfig {\n    if (this.baseConfig.type === \"cloudflare\") {\n      return {\n        type: \"cloudflare\",\n        sandboxId: scopeCloudflareSandboxId(this.baseConfig.sandboxId, resourceKey),\n      };\n    }\n    if (this.baseConfig.type === \"gondolin\") {\n      return {\n        ...this.baseConfig,\n        workspacePath: this.workspace.root,\n        mounts,\n        instanceId: resourceKey,\n        resourceKey,\n      };\n    }\n    if (this.baseConfig.type !== \"image\") return this.baseConfig;\n    return {\n      type: \"container\",\n      container: DockerContainerManager.containerName(resourceKey),\n    };\n  }\n\n  private buildEnsureReadyCallback(\n    plan: ExecutionPlan,\n    conversationId: string,\n  ): (() => Promise<void>) | undefined {\n    if (this.baseConfig.type !== \"image\" || plan.sandboxConfig.type !== \"container\") {\n      return undefined;\n    }\n\n    return async () => {\n      const expected = plan.sandboxConfig.type === \"container\" ? plan.sandboxConfig.container : \"\";\n      let actual: string | undefined;\n      try {\n        actual = await this.provisioner?.provision(plan.resourceKey, {\n          containerName: expected,\n          mounts: plan.mounts,\n          conversationId,\n        });\n      } catch (err) {\n        reportUserFacingError(err, {\n          domain: \"sandbox\",\n          surface: \"sandbox_provision\",\n          operation: \"ensure_image_container_ready\",\n          severity: \"error\",\n          context: {\n            sandboxType: \"image\",\n            conversationId,\n            credentialKey: plan.credentialKey,\n            resourceKey: plan.resourceKey,\n            expectedContainer: expected,\n            hasVault: Boolean(plan.env || plan.mounts.length > 0),\n          },\n        });\n        throw err;\n      }\n      if (actual && actual !== expected) {\n        throw new Error(\n          `Provisioner returned container \"${actual}\" for resource key \"${plan.resourceKey}\", expected \"${expected}\"`,\n        );\n      }\n    };\n  }\n\n  private resolveMounts(\n    office: Office,\n    vaultMounts: ContainerMount[],\n    projection: ReturnType<typeof resolveWorkspaceProjection>,\n  ): ContainerMount[] {\n    const workspaceMounts = projection.mounts;\n    // Package skills mount outside /workspace, so they cannot collide with the\n    // workspace projection; they are still checked against vault mounts below,\n    // which are administrator-chosen targets and could be aimed anywhere.\n    const packageMounts = conversationPackageSkillMounts({ office });\n    const protectedMounts = [...workspaceMounts, ...packageMounts];\n    for (let index = 0; index < vaultMounts.length; index += 1) {\n      const vaultMount = vaultMounts[index];\n      const workspaceCollision = protectedMounts.find((protectedMount) =>\n        targetsOverlap(protectedMount.target, vaultMount.target),\n      );\n      if (workspaceCollision) {\n        throw new Error(\n          `Vault mount target \"${vaultMount.target}\" overlaps protected workspace target \"${workspaceCollision.target}\"`,\n        );\n      }\n\n      const vaultCollision = vaultMounts\n        .slice(0, index)\n        .find((other) => targetsOverlap(other.target, vaultMount.target));\n      if (vaultCollision) {\n        throw new Error(\n          `Vault mount target \"${vaultMount.target}\" overlaps vault target \"${vaultCollision.target}\"`,\n        );\n      }\n    }\n    return [...protectedMounts, ...vaultMounts];\n  }\n}\n\nfunction targetsOverlap(left: string, right: string): boolean {\n  const a = normalizeMountTarget(left);\n  const b = normalizeMountTarget(right);\n  return a === b || a.startsWith(`${b}/`) || b.startsWith(`${a}/`);\n}\n\nfunction normalizeMountTarget(value: string): string {\n  const normalized = posix.normalize(value);\n  return normalized.replace(/\\/+$/, \"\") || \"/\";\n}\n"]}
+{"version":3,"file":"execution-resolver.js","sourceRoot":"","sources":["../src/execution-resolver.ts"],"names":[],"mappings":"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","sourcesContent":["import { posix } from \"node:path\";\nimport type { Office, Workspace } from \"./office/index.js\";\nimport { conversationPackageSkillMounts } from \"./packages/index.js\";\nimport { loadGlobalSettings } from \"./config.js\";\nimport { DockerContainerManager, type ContainerMount } from \"./provisioner.js\";\nimport {\n  createExecutor,\n  getSandboxCredentialCapabilities,\n  getSandboxWorkspaceCapabilities,\n  type Executor,\n  type SandboxConfig,\n} from \"./sandbox/index.js\";\nimport { reportUserFacingError } from \"./observability/sentry.js\";\nimport { normalizeSharedVaultName, type VaultManager } from \"./vault/index.js\";\nimport { allowsAmbientDefaultSharedVault, resolveVaultInjection } from \"./vault/index.js\";\nimport {\n  credentialAuthorizationKey,\n  legacyExactCredentialAuthorizationKey,\n  runtimeResourceKey,\n  scopeCloudflareSandboxId,\n} from \"./sandbox/identity.js\";\nimport { resolveWorkspaceProjection } from \"./workspace-projection/index.js\";\n\nexport type { ActorContext } from \"./types.js\";\nimport type { ActorContext, ExecutionPlan } from \"./types.js\";\n\nexport class ActorExecutionResolver {\n  constructor(\n    private baseConfig: SandboxConfig,\n    private vaultManager: VaultManager,\n    private provisioner: DockerContainerManager | undefined,\n    private workspace: Workspace,\n  ) {}\n\n  async resolve(context: ActorContext): Promise<Executor> {\n    const plan = this.resolvePlan(context);\n    return createExecutor(\n      plan.sandboxConfig,\n      plan.env,\n      this.buildEnsureReadyCallback(plan, context.address.conversationId),\n    );\n  }\n\n  private resolvePlan(context: ActorContext): ExecutionPlan {\n    const scope = { userId: context.userId, address: context.address };\n    const credentialKey = credentialAuthorizationKey(this.baseConfig, scope);\n    const legacyCredentialKey = legacyExactCredentialAuthorizationKey(this.baseConfig, scope);\n    const resourceKey = runtimeResourceKey(this.baseConfig, {\n      userId: context.userId,\n      conversationId: context.address.conversationId,\n    });\n    this.ensureDefaultSharedVault(credentialKey, legacyCredentialKey, context.trustModel);\n\n    const vault =\n      this.vaultManager.resolve(credentialKey) ??\n      (legacyCredentialKey ? this.vaultManager.resolve(legacyCredentialKey) : undefined);\n    const capabilities = getSandboxCredentialCapabilities(this.baseConfig.type);\n    const workspaceCapabilities = getSandboxWorkspaceCapabilities(this.baseConfig.type);\n    const office = this.workspace.office(context.address);\n    const workspaceProjection = resolveWorkspaceProjection(office);\n    const injection = resolveVaultInjection({\n      vault,\n      capabilities,\n      sandboxType: this.baseConfig.type,\n      address: office.address,\n    });\n    const mounts = this.resolveMounts(office, injection.mounts, workspaceProjection);\n    if (workspaceProjection.doorPolicy === \"isolated\" && !workspaceCapabilities.managedProjection) {\n      throw new Error(\n        `Sandbox '${this.baseConfig.type}' cannot provide an isolated conversation office; use image:* or gondolin:default, or explicitly choose trusted workspace policy`,\n      );\n    }\n    return {\n      credentialKey,\n      resourceKey,\n      sandboxConfig: this.resolveSandboxConfig(resourceKey, mounts),\n      env: injection.env,\n      mounts,\n    };\n  }\n\n  private ensureDefaultSharedVault(\n    credentialKey: string,\n    legacyCredentialKey: string | undefined,\n    trustModel: ActorContext[\"trustModel\"],\n  ): void {\n    if (!allowsAmbientDefaultSharedVault({ trustModel, sandboxType: this.baseConfig.type })) return;\n    if (\n      this.vaultManager.hasEntry(credentialKey) ||\n      (legacyCredentialKey && this.vaultManager.hasEntry(legacyCredentialKey))\n    ) {\n      return;\n    }\n\n    let profile: string | undefined;\n    try {\n      profile = loadGlobalSettings().sandbox?.defaultSharedVault;\n    } catch {\n      return;\n    }\n    if (!profile || normalizeSharedVaultName(profile) !== profile) return;\n    this.vaultManager.copySharedVaultTo(profile, credentialKey);\n  }\n\n  private resolveSandboxConfig(resourceKey: string, mounts: ContainerMount[]): SandboxConfig {\n    if (this.baseConfig.type === \"cloudflare\") {\n      return {\n        type: \"cloudflare\",\n        sandboxId: scopeCloudflareSandboxId(this.baseConfig.sandboxId, resourceKey),\n      };\n    }\n    if (this.baseConfig.type === \"gondolin\") {\n      return {\n        ...this.baseConfig,\n        workspacePath: this.workspace.root,\n        mounts,\n        instanceId: resourceKey,\n        resourceKey,\n      };\n    }\n    if (this.baseConfig.type !== \"image\") return this.baseConfig;\n    return {\n      type: \"container\",\n      container: DockerContainerManager.containerName(resourceKey),\n    };\n  }\n\n  private buildEnsureReadyCallback(\n    plan: ExecutionPlan,\n    conversationId: string,\n  ): (() => Promise<void>) | undefined {\n    if (this.baseConfig.type !== \"image\" || plan.sandboxConfig.type !== \"container\") {\n      return undefined;\n    }\n\n    return async () => {\n      const expected = plan.sandboxConfig.type === \"container\" ? plan.sandboxConfig.container : \"\";\n      let actual: string | undefined;\n      try {\n        actual = await this.provisioner?.provision(plan.resourceKey, {\n          containerName: expected,\n          mounts: plan.mounts,\n          conversationId,\n        });\n      } catch (err) {\n        reportUserFacingError(err, {\n          domain: \"sandbox\",\n          surface: \"sandbox_provision\",\n          operation: \"ensure_image_container_ready\",\n          severity: \"error\",\n          context: {\n            sandboxType: \"image\",\n            conversationId,\n            credentialKey: plan.credentialKey,\n            resourceKey: plan.resourceKey,\n            expectedContainer: expected,\n            hasVault: Boolean(plan.env || plan.mounts.length > 0),\n          },\n        });\n        throw err;\n      }\n      if (actual && actual !== expected) {\n        throw new Error(\n          `Provisioner returned container \"${actual}\" for resource key \"${plan.resourceKey}\", expected \"${expected}\"`,\n        );\n      }\n    };\n  }\n\n  private resolveMounts(\n    office: Office,\n    vaultMounts: ContainerMount[],\n    projection: ReturnType<typeof resolveWorkspaceProjection>,\n  ): ContainerMount[] {\n    const workspaceMounts = projection.mounts;\n    // Package skills mount outside /workspace, so they cannot collide with the\n    // workspace projection; they are still checked against vault mounts below,\n    // which are administrator-chosen targets and could be aimed anywhere.\n    const packageMounts = conversationPackageSkillMounts({ office });\n    const protectedMounts = [...workspaceMounts, ...packageMounts];\n    for (let index = 0; index < vaultMounts.length; index += 1) {\n      const vaultMount = vaultMounts[index];\n      if (vaultMount === undefined) continue;\n      const workspaceCollision = protectedMounts.find((protectedMount) =>\n        targetsOverlap(protectedMount.target, vaultMount.target),\n      );\n      if (workspaceCollision) {\n        throw new Error(\n          `Vault mount target \"${vaultMount.target}\" overlaps protected workspace target \"${workspaceCollision.target}\"`,\n        );\n      }\n\n      const vaultCollision = vaultMounts\n        .slice(0, index)\n        .find((other) => targetsOverlap(other.target, vaultMount.target));\n      if (vaultCollision) {\n        throw new Error(\n          `Vault mount target \"${vaultMount.target}\" overlaps vault target \"${vaultCollision.target}\"`,\n        );\n      }\n    }\n    return [...protectedMounts, ...vaultMounts];\n  }\n}\n\nfunction targetsOverlap(left: string, right: string): boolean {\n  const a = normalizeMountTarget(left);\n  const b = normalizeMountTarget(right);\n  return a === b || a.startsWith(`${b}/`) || b.startsWith(`${a}/`);\n}\n\nfunction normalizeMountTarget(value: string): string {\n  const normalized = posix.normalize(value);\n  return normalized.replace(/\\/+$/, \"\") || \"/\";\n}\n"]}

package/dist/extension-schedules.d.ts

@@ -0,0 +1,31 @@
+import type { ExtensionCallbackScheduleSpec, ExtensionScheduleCallbackFire, ExtensionScheduleEngine, ExtensionScheduleInfo } from "./harness/index.js";
+import type { OfficeAddress } from "./types.js";
+export declare class ExtensionCallbackScheduler implements ExtensionScheduleEngine {
+    private options;
+    /** Armed croner instances keyed by schedule file path. */
+    private crons;
+    constructor(options: {
+        stateDir: string;
+        /** Resolves false when no handler is registered for the fire. */
+        dispatch: (fire: ExtensionScheduleCallbackFire) => Promise<boolean>;
+    });
+    /** Arm every persisted schedule. Call once after the runtime is ready. */
+    start(): void;
+    /** Disarm everything (shutdown). Persisted files re-arm on next start. */
+    stop(): void;
+    upsert(address: OfficeAddress, slug: string, name: string, spec: ExtensionCallbackScheduleSpec): Promise<void>;
+    delete(address: OfficeAddress, slug: string, name: string): Promise<boolean>;
+    list(address: OfficeAddress, slug: string): Promise<ExtensionScheduleInfo[]>;
+    private filePath;
+    private readRecord;
+    private armFromDisk;
+    /**
+     * Replace the armed cron for one schedule file. Throws on an invalid cron
+     * pattern or timezone BEFORE touching the existing arm, so a failed upsert
+     * leaves the previous schedule running.
+     */
+    private arm;
+    private disarm;
+    private fire;
+}
+//# sourceMappingURL=extension-schedules.d.ts.map

package/dist/extension-schedules.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"extension-schedules.d.ts","sourceRoot":"","sources":["../src/extension-schedules.ts"],"names":[],"mappings":"AAsBA,OAAO,KAAK,EACV,6BAA6B,EAC7B,6BAA6B,EAC7B,uBAAuB,EACvB,qBAAqB,EACtB,MAAM,oBAAoB,CAAC;AAG5B,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAwChD,qBAAa,0BAA2B,YAAW,uBAAuB;IAKtE,OAAO,CAAC,OAAO;IAJjB,0DAA0D;IAC1D,OAAO,CAAC,KAAK,CAA2B;IAExC,YACU,OAAO,EAAE;QACf,QAAQ,EAAE,MAAM,CAAC;QACjB,iEAAiE;QACjE,QAAQ,EAAE,CAAC,IAAI,EAAE,6BAA6B,KAAK,OAAO,CAAC,OAAO,CAAC,CAAC;KACrE,EACC;IAEJ,0EAA0E;IAC1E,KAAK,IAAI,IAAI,CAaZ;IAED,0EAA0E;IAC1E,IAAI,IAAI,IAAI,CAGX;IAEK,MAAM,CACV,OAAO,EAAE,aAAa,EACtB,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,6BAA6B,GAClC,OAAO,CAAC,IAAI,CAAC,CA8Bf;IAEK,MAAM,CAAC,OAAO,EAAE,aAAa,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAMjF;IAEK,IAAI,CAAC,OAAO,EAAE,aAAa,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,qBAAqB,EAAE,CAAC,CAajF;IAED,OAAO,CAAC,QAAQ;YAQF,UAAU;IAiBxB,OAAO,CAAC,WAAW;IAmBnB;;;;OAIG;IACH,OAAO,CAAC,GAAG;IAyBX,OAAO,CAAC,MAAM;YAQA,IAAI;CA2BnB"}

package/dist/extension-schedules.js

@@ -0,0 +1,229 @@
+/**
+ * Host-authoritative store + scheduler for extension callback schedules.
+ *
+ * `api.schedules` callback specs fire trusted host-side handlers, so unlike
+ * the agent-writable workspace event bus (`events/`, watched by
+ * EventsWatcher), these schedules persist under the host-only state dir:
+ * `<stateDir>/conversations/<officeKey>/extension-schedules/<slug>.<name>.json`.
+ * A sandboxed agent can neither create nor edit them — the file is written
+ * exclusively by extension code running in the mikan process.
+ *
+ * One process-wide scheduler arms every schedule with croner (periodic cron
+ * or a one-shot ISO date), survives restarts via a boot scan, and dispatches
+ * fires to the conversation runtime, which materializes the conversation's
+ * harness and runs the registered `onCallback` handler — no agent run, no
+ * model call.
+ */
+import { Cron } from "croner";
+import { existsSync, readdirSync, readFileSync, rmSync } from "node:fs";
+import { readFile } from "node:fs/promises";
+import { join } from "node:path";
+import { Type } from "@sinclair/typebox";
+import { isValidIsoTimestampWithOffset } from "./harness/event-format.js";
+import * as log from "./log.js";
+import { officeStateDir } from "./office/index.js";
+import { atomicWritePrivateFile, ensureDirExists, parseJsonSchemaValue, } from "./utils/file-guards.js";
+const SCHEDULES_DIRNAME = "extension-schedules";
+/** On-disk record: the fire payload plus the schedule's timing fields. */
+const CallbackScheduleFileSchema = Type.Object({
+    platform: Type.String(),
+    conversationId: Type.String(),
+    slug: Type.String(),
+    name: Type.String(),
+    type: Type.Union([Type.Literal("periodic"), Type.Literal("one-shot")]),
+    schedule: Type.Optional(Type.String()),
+    timezone: Type.Optional(Type.String()),
+    at: Type.Optional(Type.String()),
+    callback: Type.String(),
+    args: Type.Optional(Type.Unknown()),
+});
+function specFromRecord(record) {
+    const action = {
+        callback: record.callback,
+        ...(record.args !== undefined ? { args: record.args } : {}),
+    };
+    return record.type === "periodic"
+        ? {
+            type: "periodic",
+            schedule: record.schedule ?? "",
+            timezone: record.timezone ?? "",
+            ...action,
+        }
+        : { type: "one-shot", at: record.at ?? "", ...action };
+}
+export class ExtensionCallbackScheduler {
+    constructor(options) {
+        this.options = options;
+        /** Armed croner instances keyed by schedule file path. */
+        this.crons = new Map();
+    }
+    /** Arm every persisted schedule. Call once after the runtime is ready. */
+    start() {
+        const conversationsDir = join(this.options.stateDir, "conversations");
+        if (!existsSync(conversationsDir))
+            return;
+        let armed = 0;
+        for (const officeDir of readdirSync(conversationsDir)) {
+            const schedulesDir = join(conversationsDir, officeDir, SCHEDULES_DIRNAME);
+            if (!existsSync(schedulesDir))
+                continue;
+            for (const filename of readdirSync(schedulesDir)) {
+                if (!filename.endsWith(".json"))
+                    continue;
+                if (this.armFromDisk(join(schedulesDir, filename)))
+                    armed++;
+            }
+        }
+        if (armed > 0)
+            log.logInfo(`Extension callback schedules armed: ${armed}`);
+    }
+    /** Disarm everything (shutdown). Persisted files re-arm on next start. */
+    stop() {
+        for (const cron of this.crons.values())
+            cron.stop();
+        this.crons.clear();
+    }
+    async upsert(address, slug, name, spec) {
+        if (spec.type === "one-shot") {
+            if (!isValidIsoTimestampWithOffset(spec.at)) {
+                throw new Error("`at` must be a valid ISO 8601 timestamp with UTC offset");
+            }
+            if (new Date(spec.at).getTime() <= Date.now()) {
+                throw new Error("`at` must be in the future");
+            }
+        }
+        const record = {
+            platform: address.platform,
+            conversationId: address.conversationId,
+            slug,
+            name,
+            type: spec.type,
+            ...(spec.type === "periodic" ? { schedule: spec.schedule, timezone: spec.timezone } : {}),
+            ...(spec.type === "one-shot" ? { at: spec.at } : {}),
+            callback: spec.callback,
+            // Round-tripped through JSON so what fires later is exactly what
+            // persisting kept (functions and other non-JSON values never survive).
+            ...(spec.args !== undefined
+                ? { args: JSON.parse(JSON.stringify(spec.args)) }
+                : {}),
+        };
+        const filePath = this.filePath(address, slug, name);
+        // Validate by arming first: an invalid cron pattern or timezone throws
+        // here, before anything is persisted or replaced.
+        this.arm(filePath, record);
+        ensureDirExists(join(officeStateDir(this.options.stateDir, address), SCHEDULES_DIRNAME));
+        atomicWritePrivateFile(filePath, JSON.stringify(record, null, 2));
+    }
+    async delete(address, slug, name) {
+        const filePath = this.filePath(address, slug, name);
+        this.disarm(filePath);
+        if (!existsSync(filePath))
+            return false;
+        rmSync(filePath, { force: true });
+        return true;
+    }
+    async list(address, slug) {
+        const schedulesDir = join(officeStateDir(this.options.stateDir, address), SCHEDULES_DIRNAME);
+        if (!existsSync(schedulesDir))
+            return [];
+        const prefix = `${slug}.`;
+        const infos = [];
+        for (const filename of readdirSync(schedulesDir).toSorted()) {
+            if (!filename.startsWith(prefix) || !filename.endsWith(".json"))
+                continue;
+            const record = await this.readRecord(join(schedulesDir, filename));
+            if (record && record.slug === slug) {
+                infos.push({ name: record.name, spec: specFromRecord(record) });
+            }
+        }
+        return infos;
+    }
+    filePath(address, slug, name) {
+        return join(officeStateDir(this.options.stateDir, address), SCHEDULES_DIRNAME, `${slug}.${name}.json`);
+    }
+    async readRecord(filePath) {
+        try {
+            const content = await readFile(filePath, "utf-8");
+            return parseJsonSchemaValue(content, CallbackScheduleFileSchema, (detail) => `Malformed extension schedule ${filePath}: ${detail}`);
+        }
+        catch (err) {
+            log.logWarning(`Skipping unreadable extension schedule: ${filePath}`, err instanceof Error ? err.message : String(err));
+            return undefined;
+        }
+    }
+    armFromDisk(filePath) {
+        try {
+            const record = parseJsonSchemaValue(readFileSync(filePath, "utf-8"), CallbackScheduleFileSchema, (detail) => `Malformed extension schedule ${filePath}: ${detail}`);
+            this.arm(filePath, record);
+            return this.crons.has(filePath);
+        }
+        catch (err) {
+            // Never delete on parse failure: a code bug must not destroy schedules.
+            log.logWarning(`Skipping invalid extension schedule: ${filePath}`, err instanceof Error ? err.message : String(err));
+            return false;
+        }
+    }
+    /**
+     * Replace the armed cron for one schedule file. Throws on an invalid cron
+     * pattern or timezone BEFORE touching the existing arm, so a failed upsert
+     * leaves the previous schedule running.
+     */
+    arm(filePath, record) {
+        const fire = () => void this.fire(filePath, record);
+        let cron;
+        if (record.type === "periodic") {
+            if (!record.schedule || !record.timezone) {
+                throw new Error("`schedule` and `timezone` are required for periodic schedules");
+            }
+            cron = new Cron(record.schedule, { timezone: record.timezone }, fire);
+        }
+        else {
+            if (!record.at)
+                throw new Error("`at` is required for one-shot schedules");
+            const at = new Date(record.at);
+            if (at.getTime() <= Date.now()) {
+                // Fired while we were down (or was written in the past): drop it,
+                // mirroring the event watcher's stale one-shot handling. Only the
+                // boot scan reaches here — upsert rejects past timestamps.
+                log.logInfo(`Extension schedule in the past, deleting: ${filePath}`);
+                rmSync(filePath, { force: true });
+            }
+            else {
+                cron = new Cron(at, fire);
+            }
+        }
+        this.disarm(filePath);
+        if (cron)
+            this.crons.set(filePath, cron);
+    }
+    disarm(filePath) {
+        const cron = this.crons.get(filePath);
+        if (cron) {
+            cron.stop();
+            this.crons.delete(filePath);
+        }
+    }
+    async fire(filePath, record) {
+        if (record.type === "one-shot") {
+            this.disarm(filePath);
+            rmSync(filePath, { force: true });
+        }
+        try {
+            const consumed = await this.options.dispatch({
+                platform: record.platform,
+                conversationId: record.conversationId,
+                slug: record.slug,
+                scheduleName: record.name,
+                callback: record.callback,
+                ...(record.args !== undefined ? { args: record.args } : {}),
+            });
+            if (!consumed) {
+                log.logWarning(`Extension schedule callback has no registered handler: ${record.slug}.${record.name} → ${record.callback}`, filePath);
+            }
+        }
+        catch (err) {
+            log.logWarning(`Extension schedule dispatch failed: ${record.slug}.${record.name}`, err instanceof Error ? err.message : String(err));
+        }
+    }
+}
+//# sourceMappingURL=extension-schedules.js.map

package/dist/extension-schedules.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"extension-schedules.js","sourceRoot":"","sources":["../src/extension-schedules.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * Host-authoritative store + scheduler for extension callback schedules.\n *\n * `api.schedules` callback specs fire trusted host-side handlers, so unlike\n * the agent-writable workspace event bus (`events/`, watched by\n * EventsWatcher), these schedules persist under the host-only state dir:\n * `<stateDir>/conversations/<officeKey>/extension-schedules/<slug>.<name>.json`.\n * A sandboxed agent can neither create nor edit them — the file is written\n * exclusively by extension code running in the mikan process.\n *\n * One process-wide scheduler arms every schedule with croner (periodic cron\n * or a one-shot ISO date), survives restarts via a boot scan, and dispatches\n * fires to the conversation runtime, which materializes the conversation's\n * harness and runs the registered `onCallback` handler — no agent run, no\n * model call.\n */\nimport { Cron } from \"croner\";\nimport { existsSync, readdirSync, readFileSync, rmSync } from \"node:fs\";\nimport { readFile } from \"node:fs/promises\";\nimport { join } from \"node:path\";\nimport { Type, type Static } from \"@sinclair/typebox\";\nimport { isValidIsoTimestampWithOffset } from \"./harness/event-format.js\";\nimport type {\n  ExtensionCallbackScheduleSpec,\n  ExtensionScheduleCallbackFire,\n  ExtensionScheduleEngine,\n  ExtensionScheduleInfo,\n} from \"./harness/index.js\";\nimport * as log from \"./log.js\";\nimport { officeStateDir } from \"./office/index.js\";\nimport type { OfficeAddress } from \"./types.js\";\nimport {\n  atomicWritePrivateFile,\n  ensureDirExists,\n  parseJsonSchemaValue,\n} from \"./utils/file-guards.js\";\n\nconst SCHEDULES_DIRNAME = \"extension-schedules\";\n\n/** On-disk record: the fire payload plus the schedule's timing fields. */\nconst CallbackScheduleFileSchema = Type.Object({\n  platform: Type.String(),\n  conversationId: Type.String(),\n  slug: Type.String(),\n  name: Type.String(),\n  type: Type.Union([Type.Literal(\"periodic\"), Type.Literal(\"one-shot\")]),\n  schedule: Type.Optional(Type.String()),\n  timezone: Type.Optional(Type.String()),\n  at: Type.Optional(Type.String()),\n  callback: Type.String(),\n  args: Type.Optional(Type.Unknown()),\n});\n\ntype CallbackScheduleRecord = Static<typeof CallbackScheduleFileSchema>;\n\nfunction specFromRecord(record: CallbackScheduleRecord): ExtensionCallbackScheduleSpec {\n  const action = {\n    callback: record.callback,\n    ...(record.args !== undefined ? { args: record.args } : {}),\n  };\n  return record.type === \"periodic\"\n    ? {\n        type: \"periodic\",\n        schedule: record.schedule ?? \"\",\n        timezone: record.timezone ?? \"\",\n        ...action,\n      }\n    : { type: \"one-shot\", at: record.at ?? \"\", ...action };\n}\n\nexport class ExtensionCallbackScheduler implements ExtensionScheduleEngine {\n  /** Armed croner instances keyed by schedule file path. */\n  private crons = new Map<string, Cron>();\n\n  constructor(\n    private options: {\n      stateDir: string;\n      /** Resolves false when no handler is registered for the fire. */\n      dispatch: (fire: ExtensionScheduleCallbackFire) => Promise<boolean>;\n    },\n  ) {}\n\n  /** Arm every persisted schedule. Call once after the runtime is ready. */\n  start(): void {\n    const conversationsDir = join(this.options.stateDir, \"conversations\");\n    if (!existsSync(conversationsDir)) return;\n    let armed = 0;\n    for (const officeDir of readdirSync(conversationsDir)) {\n      const schedulesDir = join(conversationsDir, officeDir, SCHEDULES_DIRNAME);\n      if (!existsSync(schedulesDir)) continue;\n      for (const filename of readdirSync(schedulesDir)) {\n        if (!filename.endsWith(\".json\")) continue;\n        if (this.armFromDisk(join(schedulesDir, filename))) armed++;\n      }\n    }\n    if (armed > 0) log.logInfo(`Extension callback schedules armed: ${armed}`);\n  }\n\n  /** Disarm everything (shutdown). Persisted files re-arm on next start. */\n  stop(): void {\n    for (const cron of this.crons.values()) cron.stop();\n    this.crons.clear();\n  }\n\n  async upsert(\n    address: OfficeAddress,\n    slug: string,\n    name: string,\n    spec: ExtensionCallbackScheduleSpec,\n  ): Promise<void> {\n    if (spec.type === \"one-shot\") {\n      if (!isValidIsoTimestampWithOffset(spec.at)) {\n        throw new Error(\"`at` must be a valid ISO 8601 timestamp with UTC offset\");\n      }\n      if (new Date(spec.at).getTime() <= Date.now()) {\n        throw new Error(\"`at` must be in the future\");\n      }\n    }\n    const record: CallbackScheduleRecord = {\n      platform: address.platform,\n      conversationId: address.conversationId,\n      slug,\n      name,\n      type: spec.type,\n      ...(spec.type === \"periodic\" ? { schedule: spec.schedule, timezone: spec.timezone } : {}),\n      ...(spec.type === \"one-shot\" ? { at: spec.at } : {}),\n      callback: spec.callback,\n      // Round-tripped through JSON so what fires later is exactly what\n      // persisting kept (functions and other non-JSON values never survive).\n      ...(spec.args !== undefined\n        ? { args: JSON.parse(JSON.stringify(spec.args)) as unknown }\n        : {}),\n    };\n    const filePath = this.filePath(address, slug, name);\n    // Validate by arming first: an invalid cron pattern or timezone throws\n    // here, before anything is persisted or replaced.\n    this.arm(filePath, record);\n    ensureDirExists(join(officeStateDir(this.options.stateDir, address), SCHEDULES_DIRNAME));\n    atomicWritePrivateFile(filePath, JSON.stringify(record, null, 2));\n  }\n\n  async delete(address: OfficeAddress, slug: string, name: string): Promise<boolean> {\n    const filePath = this.filePath(address, slug, name);\n    this.disarm(filePath);\n    if (!existsSync(filePath)) return false;\n    rmSync(filePath, { force: true });\n    return true;\n  }\n\n  async list(address: OfficeAddress, slug: string): Promise<ExtensionScheduleInfo[]> {\n    const schedulesDir = join(officeStateDir(this.options.stateDir, address), SCHEDULES_DIRNAME);\n    if (!existsSync(schedulesDir)) return [];\n    const prefix = `${slug}.`;\n    const infos: ExtensionScheduleInfo[] = [];\n    for (const filename of readdirSync(schedulesDir).toSorted()) {\n      if (!filename.startsWith(prefix) || !filename.endsWith(\".json\")) continue;\n      const record = await this.readRecord(join(schedulesDir, filename));\n      if (record && record.slug === slug) {\n        infos.push({ name: record.name, spec: specFromRecord(record) });\n      }\n    }\n    return infos;\n  }\n\n  private filePath(address: OfficeAddress, slug: string, name: string): string {\n    return join(\n      officeStateDir(this.options.stateDir, address),\n      SCHEDULES_DIRNAME,\n      `${slug}.${name}.json`,\n    );\n  }\n\n  private async readRecord(filePath: string): Promise<CallbackScheduleRecord | undefined> {\n    try {\n      const content = await readFile(filePath, \"utf-8\");\n      return parseJsonSchemaValue(\n        content,\n        CallbackScheduleFileSchema,\n        (detail) => `Malformed extension schedule ${filePath}: ${detail}`,\n      );\n    } catch (err) {\n      log.logWarning(\n        `Skipping unreadable extension schedule: ${filePath}`,\n        err instanceof Error ? err.message : String(err),\n      );\n      return undefined;\n    }\n  }\n\n  private armFromDisk(filePath: string): boolean {\n    try {\n      const record = parseJsonSchemaValue(\n        readFileSync(filePath, \"utf-8\"),\n        CallbackScheduleFileSchema,\n        (detail) => `Malformed extension schedule ${filePath}: ${detail}`,\n      );\n      this.arm(filePath, record);\n      return this.crons.has(filePath);\n    } catch (err) {\n      // Never delete on parse failure: a code bug must not destroy schedules.\n      log.logWarning(\n        `Skipping invalid extension schedule: ${filePath}`,\n        err instanceof Error ? err.message : String(err),\n      );\n      return false;\n    }\n  }\n\n  /**\n   * Replace the armed cron for one schedule file. Throws on an invalid cron\n   * pattern or timezone BEFORE touching the existing arm, so a failed upsert\n   * leaves the previous schedule running.\n   */\n  private arm(filePath: string, record: CallbackScheduleRecord): void {\n    const fire = () => void this.fire(filePath, record);\n    let cron: Cron | undefined;\n    if (record.type === \"periodic\") {\n      if (!record.schedule || !record.timezone) {\n        throw new Error(\"`schedule` and `timezone` are required for periodic schedules\");\n      }\n      cron = new Cron(record.schedule, { timezone: record.timezone }, fire);\n    } else {\n      if (!record.at) throw new Error(\"`at` is required for one-shot schedules\");\n      const at = new Date(record.at);\n      if (at.getTime() <= Date.now()) {\n        // Fired while we were down (or was written in the past): drop it,\n        // mirroring the event watcher's stale one-shot handling. Only the\n        // boot scan reaches here — upsert rejects past timestamps.\n        log.logInfo(`Extension schedule in the past, deleting: ${filePath}`);\n        rmSync(filePath, { force: true });\n      } else {\n        cron = new Cron(at, fire);\n      }\n    }\n    this.disarm(filePath);\n    if (cron) this.crons.set(filePath, cron);\n  }\n\n  private disarm(filePath: string): void {\n    const cron = this.crons.get(filePath);\n    if (cron) {\n      cron.stop();\n      this.crons.delete(filePath);\n    }\n  }\n\n  private async fire(filePath: string, record: CallbackScheduleRecord): Promise<void> {\n    if (record.type === \"one-shot\") {\n      this.disarm(filePath);\n      rmSync(filePath, { force: true });\n    }\n    try {\n      const consumed = await this.options.dispatch({\n        platform: record.platform,\n        conversationId: record.conversationId,\n        slug: record.slug,\n        scheduleName: record.name,\n        callback: record.callback,\n        ...(record.args !== undefined ? { args: record.args } : {}),\n      });\n      if (!consumed) {\n        log.logWarning(\n          `Extension schedule callback has no registered handler: ${record.slug}.${record.name} → ${record.callback}`,\n          filePath,\n        );\n      }\n    } catch (err) {\n      log.logWarning(\n        `Extension schedule dispatch failed: ${record.slug}.${record.name}`,\n        err instanceof Error ? err.message : String(err),\n      );\n    }\n  }\n}\n"]}

package/dist/harness/auth.js

@@ -9,11 +9,11 @@
  * provider within the process. mikan runs as a single process, so no
  * cross-process file lock is taken.
  */
-import { existsSync, readFileSync } from "fs";
-import { mkdirSync } from "fs";
-import { homedir } from "os";
-import { dirname, join } from "path";
-import { atomicWritePrivateFile } from "../utils/fs-atomic.js";
+import { existsSync, readFileSync } from "node:fs";
+import { mkdirSync } from "node:fs";
+import { homedir } from "node:os";
+import { dirname, join } from "node:path";
+import { atomicWritePrivateFile } from "../utils/file-guards.js";
 import * as log from "../log.js";
 /** Default location of mikan's credential file. */
 export function defaultAuthPath() {