@geminixiang/mama 0.2.0-beta.1 → 0.2.0-beta.11

package/dist/events.js

@@ -1,8 +1,10 @@
 import { Cron } from "croner";
-import { existsSync, mkdirSync, readdirSync, readFileSync, statSync, unlinkSync, watch, } from "fs";
+import { existsSync, readdirSync, readFileSync, statSync, unlinkSync, watch, } from "fs";
 import { readFile } from "fs/promises";
 import { join } from "path";
+import { ensureDirExists, isRecord, parseJsonValue } from "./file-guards.js";
 import * as log from "./log.js";
+import { inferConversationKind } from "./session-policy.js";
 // ============================================================================
 // EventsWatcher
 // ============================================================================
@@ -14,6 +16,7 @@ export class EventsWatcher {
         this.eventsDir = eventsDir;
         this.botsByPlatform = botsByPlatform;
         this.timers = new Map();
+        this.timerEventTypes = new Map();
         this.crons = new Map();
         this.debounceTimers = new Map();
         this.watcher = null;
@@ -25,16 +28,15 @@ export class EventsWatcher {
      */
     start() {
         // Ensure events directory exists
-        if (!existsSync(this.eventsDir)) {
-            mkdirSync(this.eventsDir, { recursive: true });
-        }
+        ensureDirExists(this.eventsDir);
         log.logInfo(`Events watcher starting, dir: ${this.eventsDir}`);
         // Scan existing files
         this.scanExisting();
         // Watch for changes
-        this.watcher = watch(this.eventsDir, (_eventType, filename) => {
+        this.watcher = watch(this.eventsDir, (eventType, filename) => {
             if (!filename || !filename.endsWith(".json"))
                 return;
+            log.logInfo(`Events watcher fs event: ${String(eventType)} ${filename} (exists=${existsSync(join(this.eventsDir, filename))})`);
             this.debounce(filename, () => this.handleFileChange(filename));
         });
         log.logInfo(`Events watcher started, tracking ${this.knownFiles.size} files`);
@@ -58,6 +60,7 @@ export class EventsWatcher {
             clearTimeout(timer);
         }
         this.timers.clear();
+        this.timerEventTypes.clear();
         // Cancel all cron jobs
         for (const cron of this.crons.values()) {
             cron.stop();
@@ -83,7 +86,8 @@ export class EventsWatcher {
                 results.push({
                     filename,
                     platform: data.platform,
-                    channelId: data.channelId,
+                    conversationId: data.conversationId,
+                    conversationKind: data.conversationKind,
                     text: data.text,
                     schedule: data.schedule,
                     timezone: data.timezone,
@@ -121,34 +125,54 @@ export class EventsWatcher {
     }
     handleFileChange(filename) {
         const filePath = join(this.eventsDir, filename);
-        if (!existsSync(filePath)) {
-            // File was deleted
-            this.handleDelete(filename);
-        }
-        else if (this.knownFiles.has(filename)) {
+        const exists = existsSync(filePath);
+        const known = this.knownFiles.has(filename);
+        log.logInfo(`Handling event file change: ${filename} (exists=${exists}, known=${known})`);
+        if (!exists) {
+            // fs.watch can briefly report a file as missing during create/rename churn.
+            // Confirm deletion before canceling scheduled events.
+            void this.handleDelete(filename);
+        }
+        else if (known) {
             // File was modified - cancel existing and re-schedule
-            this.cancelScheduled(filename);
-            this.handleFile(filename);
+            this.cancelScheduled(filename, "file-modified");
+            void this.handleFile(filename);
         }
         else {
             // New file
-            this.handleFile(filename);
+            void this.handleFile(filename);
         }
     }
-    handleDelete(filename) {
+    async handleDelete(filename) {
         if (!this.knownFiles.has(filename))
             return;
+        const filePath = join(this.eventsDir, filename);
+        for (let i = 0; i < MAX_RETRIES; i++) {
+            const delay = RETRY_BASE_MS * 2 ** i;
+            await this.sleep(delay);
+            const exists = existsSync(filePath);
+            log.logInfo(`Confirming event deletion: ${filename} after ${delay}ms (exists=${exists})`);
+            if (exists) {
+                return;
+            }
+        }
+        if (this.timerEventTypes.get(filename) === "one-shot" && this.timers.has(filename)) {
+            log.logInfo(`Ignoring deleted one-shot file after scheduling: ${filename} (timer remains active)`);
+            return;
+        }
         log.logInfo(`Event file deleted: ${filename}`);
-        this.cancelScheduled(filename);
+        this.cancelScheduled(filename, "confirmed-delete");
         this.knownFiles.delete(filename);
     }
-    cancelScheduled(filename) {
+    cancelScheduled(filename, reason = "unspecified") {
         const timer = this.timers.get(filename);
+        const cron = this.crons.get(filename);
+        log.logInfo(`Canceling scheduled event: ${filename} (reason=${reason}, timer=${Boolean(timer)}, cron=${Boolean(cron)})`);
         if (timer) {
             clearTimeout(timer);
             this.timers.delete(filename);
+            this.timerEventTypes.delete(filename);
         }
-        const cron = this.crons.get(filename);
         if (cron) {
             cron.stop();
             this.crons.delete(filename);
@@ -156,6 +180,7 @@ export class EventsWatcher {
     }
     async handleFile(filename) {
         const filePath = join(this.eventsDir, filename);
+        log.logInfo(`Loading event file: ${filename} from ${filePath}`);
         // Parse with retries
         let event = null;
         let lastError = null;
@@ -174,10 +199,11 @@ export class EventsWatcher {
         }
         if (!event) {
             log.logWarning(`Failed to parse event file after ${MAX_RETRIES} retries: ${filename}`, lastError?.message);
-            this.deleteFile(filename);
+            this.deleteFile(filename, "parse-failed");
             return;
         }
         this.knownFiles.add(filename);
+        log.logInfo(`Parsed event file: ${filename} (${event.type} for ${event.platform}/${event.conversationId})`);
         // Schedule based on type
         switch (event.type) {
             case "immediate":
@@ -192,51 +218,62 @@ export class EventsWatcher {
         }
     }
     parseEvent(content, filename) {
-        const data = JSON.parse(content);
-        if (!data.type || !data.channelId || !data.text) {
-            throw new Error(`Missing required fields (type, channelId, text) in ${filename}`);
+        const data = parseJsonValue(content, isRecord, (detail) => detail === "unexpected JSON shape" ? `Expected top-level JSON object in ${filename}` : detail);
+        const conversationId = typeof data.conversationId === "string"
+            ? data.conversationId
+            : typeof data.channelId === "string"
+                ? data.channelId
+                : undefined;
+        const type = typeof data.type === "string" ? data.type : undefined;
+        const text = typeof data.text === "string" ? data.text : undefined;
+        if (!type || !conversationId || !text) {
+            throw new Error(`Missing required fields (type, conversationId, text) in ${filename}`);
         }
         const platform = this.resolvePlatform(data.platform, filename);
+        const conversationKind = this.resolveConversationKind(platform, conversationId, data.conversationKind);
         const userId = typeof data.userId === "string" ? data.userId : undefined;
-        switch (data.type) {
+        switch (type) {
             case "immediate":
                 return {
                     type: "immediate",
                     platform,
-                    channelId: data.channelId,
+                    conversationId,
+                    conversationKind,
                     userId,
-                    text: data.text,
+                    text,
                 };
             case "one-shot":
-                if (!data.at) {
+                if (typeof data.at !== "string" || data.at.length === 0) {
                     throw new Error(`Missing 'at' field for one-shot event in ${filename}`);
                 }
                 return {
                     type: "one-shot",
                     platform,
-                    channelId: data.channelId,
+                    conversationId,
+                    conversationKind,
                     userId,
-                    text: data.text,
+                    text,
                     at: data.at,
                 };
             case "periodic":
-                if (!data.schedule) {
+                if (typeof data.schedule !== "string" || data.schedule.length === 0) {
                     throw new Error(`Missing 'schedule' field for periodic event in ${filename}`);
                 }
-                if (!data.timezone) {
+                if (typeof data.timezone !== "string" || data.timezone.length === 0) {
                     throw new Error(`Missing 'timezone' field for periodic event in ${filename}`);
                 }
                 return {
                     type: "periodic",
                     platform,
-                    channelId: data.channelId,
+                    conversationId,
+                    conversationKind,
                     userId,
-                    text: data.text,
+                    text,
                     schedule: data.schedule,
                     timezone: data.timezone,
                 };
             default:
-                throw new Error(`Unknown event type '${data.type}' in ${filename}`);
+                throw new Error(`Unknown event type '${type}' in ${filename}`);
         }
     }
     resolvePlatform(platformValue, filename) {
@@ -253,6 +290,12 @@ export class EventsWatcher {
         }
         throw new Error(`Missing required field 'platform' in ${filename}. Available platforms: ${availablePlatforms.join(", ")}`);
     }
+    resolveConversationKind(platform, conversationId, conversationKindValue) {
+        if (conversationKindValue === "direct" || conversationKindValue === "shared") {
+            return conversationKindValue;
+        }
+        return inferConversationKind(platform, conversationId);
+    }
     handleImmediate(filename, event) {
         const filePath = join(this.eventsDir, filename);
         // Check if stale (created before harness started)
@@ -260,7 +303,7 @@ export class EventsWatcher {
             const stat = statSync(filePath);
             if (stat.mtimeMs < this.startTime) {
                 log.logInfo(`Stale immediate event, deleting: ${filename}`);
-                this.deleteFile(filename);
+                this.deleteFile(filename, "stale-immediate");
                 return;
             }
         }
@@ -277,17 +320,20 @@ export class EventsWatcher {
         if (atTime <= now) {
             // Past - delete without executing
             log.logInfo(`One-shot event in the past, deleting: ${filename}`);
-            this.deleteFile(filename);
+            this.deleteFile(filename, "one-shot-in-past");
             return;
         }
         const delay = atTime - now;
-        log.logInfo(`Scheduling one-shot event: ${filename} in ${Math.round(delay / 1000)}s`);
+        log.logInfo(`Scheduling one-shot event: ${filename} in ${Math.round(delay / 1000)}s (at=${event.at}, now=${new Date(now).toISOString()})`);
         const timer = setTimeout(() => {
             this.timers.delete(filename);
+            this.timerEventTypes.delete(filename);
             log.logInfo(`Executing one-shot event: ${filename}`);
             this.execute(filename, event);
         }, delay);
         this.timers.set(filename, timer);
+        this.timerEventTypes.set(filename, "one-shot");
+        log.logInfo(`Stored one-shot timer: ${filename} (active timers=${this.timers.size})`);
     }
     handlePeriodic(filename, event) {
         try {
@@ -301,62 +347,70 @@ export class EventsWatcher {
         }
         catch (err) {
             log.logWarning(`Invalid cron schedule for ${filename}: ${event.schedule}`, String(err));
-            this.deleteFile(filename);
+            this.deleteFile(filename, "invalid-cron");
         }
     }
     execute(filename, event, deleteAfter = true) {
-        // Format the message
-        let scheduleInfo;
-        switch (event.type) {
-            case "immediate":
-                scheduleInfo = "immediate";
-                break;
-            case "one-shot":
-                scheduleInfo = event.at;
-                break;
-            case "periodic":
-                scheduleInfo = event.schedule;
-                break;
-        }
-        const message = `[EVENT:${filename}:${event.type}:${scheduleInfo}] ${event.text}`;
+        const message = this.buildEventPrompt(event);
         const bot = this.botsByPlatform[event.platform];
         if (!bot) {
             log.logWarning(`No bot configured for event platform '${event.platform}'`, filename);
             if (deleteAfter) {
-                this.deleteFile(filename);
+                this.deleteFile(filename, "missing-bot");
             }
             return;
         }
-        // Create synthetic BotEvent. Keep a stable channel session key so recurring
-        // reminders share context, but use a unique synthetic message id because
-        // some adapters treat `ts`/message id as a reply target.
-        // `user` falls back to "EVENT" when the event file omits a creator; vault
-        // routing then resolves to an empty auto-created entry or shared container vault
-        // with no credentials configured yet.
+        const eventId = filename.replace(/\.json$/i, "");
         const syntheticEvent = {
             type: "mention",
-            conversationId: event.channelId,
+            conversationId: event.conversationId,
+            conversationKind: event.conversationKind,
             user: event.userId ?? "EVENT",
             text: message,
-            ts: `event:${filename}`,
-            sessionKey: event.channelId,
+            ts: `event:${eventId}`,
         };
         // Enqueue for processing
         const enqueued = bot.enqueueEvent(syntheticEvent);
         if (enqueued && deleteAfter) {
             // Delete file after successful enqueue (immediate and one-shot)
-            this.deleteFile(filename);
+            this.deleteFile(filename, "executed-and-enqueued");
         }
         else if (!enqueued) {
             log.logWarning(`Event queue full, discarded: ${filename}`);
             // Still delete immediate/one-shot even if discarded
             if (deleteAfter) {
-                this.deleteFile(filename);
+                this.deleteFile(filename, "queue-full-discarded");
             }
         }
     }
-    deleteFile(filename) {
+    buildEventPrompt(event) {
+        switch (event.type) {
+            case "one-shot":
+                return [
+                    "Please deliver the following reminder to the user in a short, natural way.",
+                    "Do not greet, do not introduce yourself, and do not ask generic follow-up questions.",
+                    "",
+                    `Reminder: ${event.text}`,
+                ].join("\n");
+            case "periodic":
+                return [
+                    "Handle the following recurring task.",
+                    "Respond concisely. If there is nothing actionable to report, reply with [SILENT].",
+                    "",
+                    `Task: ${event.text}`,
+                ].join("\n");
+            case "immediate":
+                return [
+                    "Handle the following event/update in a concise, context-appropriate way.",
+                    "If it reads like a reminder or follow-up, deliver it directly without greeting or generic offers to help.",
+                    "",
+                    `Event: ${event.text}`,
+                ].join("\n");
+        }
+    }
+    deleteFile(filename, reason = "unspecified") {
         const filePath = join(this.eventsDir, filename);
+        log.logInfo(`Deleting event file: ${filename} (reason=${reason})`);
         try {
             unlinkSync(filePath);
         }

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  mkdirSync,\n  readdirSync,\n  readFileSync,\n  statSync,\n  unlinkSync,\n  watch,\n} from \"fs\";\nimport { readFile } from \"fs/promises\";\nimport { join } from \"path\";\nimport type { Bot, BotEvent } from \"./adapter.js\";\nimport * as log from \"./log.js\";\n\n// ============================================================================\n// Event Types\n// ============================================================================\n\nexport interface ImmediateEvent {\n  type: \"immediate\";\n  platform: string;\n  channelId: string;\n  /** Creator userId — routes tool execution to the sandbox's vault selection for that user when fired. */\n  userId?: string;\n  text: string;\n}\n\nexport interface OneShotEvent {\n  type: \"one-shot\";\n  platform: string;\n  channelId: string;\n  userId?: string;\n  text: string;\n  at: string; // ISO 8601 with timezone offset\n}\n\nexport interface PeriodicEvent {\n  type: \"periodic\";\n  platform: string;\n  channelId: string;\n  userId?: string;\n  text: string;\n  schedule: string; // cron syntax\n  timezone: string; // IANA timezone\n}\n\nexport type MamaEvent = ImmediateEvent | OneShotEvent | PeriodicEvent;\n\nexport interface PeriodicEventInfo {\n  filename: string;\n  platform: string;\n  channelId: string;\n  text: string;\n  schedule: string;\n  timezone: string;\n  nextRun: string | null; // ISO 8601\n}\n\n// ============================================================================\n// EventsWatcher\n// ============================================================================\n\nconst DEBOUNCE_MS = 100;\nconst MAX_RETRIES = 3;\nconst RETRY_BASE_MS = 100;\n\nexport class EventsWatcher {\n  private timers: Map<string, NodeJS.Timeout> = new Map();\n  private crons: Map<string, Cron> = new Map();\n  private debounceTimers: Map<string, NodeJS.Timeout> = new Map();\n  private startTime: number;\n  private watcher: FSWatcher | null = null;\n  private knownFiles: Set<string> = new Set();\n\n  constructor(\n    private eventsDir: string,\n    private botsByPlatform: Record<string, Bot>,\n  ) {\n    this.startTime = Date.now();\n  }\n\n  /**\n   * Start watching for events. Call this after platform bots are initialized.\n   */\n  start(): void {\n    // Ensure events directory exists\n    if (!existsSync(this.eventsDir)) {\n      mkdirSync(this.eventsDir, { recursive: true });\n    }\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      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          channelId: data.channelId,\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\n    if (!existsSync(filePath)) {\n      // File was deleted\n      this.handleDelete(filename);\n    } else if (this.knownFiles.has(filename)) {\n      // File was modified - cancel existing and re-schedule\n      this.cancelScheduled(filename);\n      this.handleFile(filename);\n    } else {\n      // New file\n      this.handleFile(filename);\n    }\n  }\n\n  private handleDelete(filename: string): void {\n    if (!this.knownFiles.has(filename)) return;\n\n    log.logInfo(`Event file deleted: ${filename}`);\n    this.cancelScheduled(filename);\n    this.knownFiles.delete(filename);\n  }\n\n  private cancelScheduled(filename: string): void {\n    const timer = this.timers.get(filename);\n    if (timer) {\n      clearTimeout(timer);\n      this.timers.delete(filename);\n    }\n\n    const cron = this.crons.get(filename);\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\n    // Parse with retries\n    let event: MamaEvent | null = null;\n    let lastError: Error | null = null;\n\n    for (let i = 0; i < MAX_RETRIES; i++) {\n      try {\n        const content = await readFile(filePath, \"utf-8\");\n        event = this.parseEvent(content, filename);\n        break;\n      } catch (err) {\n        lastError = err instanceof Error ? err : new Error(String(err));\n        if (i < MAX_RETRIES - 1) {\n          await this.sleep(RETRY_BASE_MS * 2 ** i);\n        }\n      }\n    }\n\n    if (!event) {\n      log.logWarning(\n        `Failed to parse event file after ${MAX_RETRIES} retries: ${filename}`,\n        lastError?.message,\n      );\n      this.deleteFile(filename);\n      return;\n    }\n\n    this.knownFiles.add(filename);\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): MamaEvent | null {\n    const data = JSON.parse(content);\n\n    if (!data.type || !data.channelId || !data.text) {\n      throw new Error(`Missing required fields (type, channelId, text) in ${filename}`);\n    }\n\n    const platform = this.resolvePlatform(data.platform, filename);\n\n    const userId = typeof data.userId === \"string\" ? data.userId : undefined;\n\n    switch (data.type) {\n      case \"immediate\":\n        return {\n          type: \"immediate\",\n          platform,\n          channelId: data.channelId,\n          userId,\n          text: data.text,\n        };\n\n      case \"one-shot\":\n        if (!data.at) {\n          throw new Error(`Missing 'at' field for one-shot event in ${filename}`);\n        }\n        return {\n          type: \"one-shot\",\n          platform,\n          channelId: data.channelId,\n          userId,\n          text: data.text,\n          at: data.at,\n        };\n\n      case \"periodic\":\n        if (!data.schedule) {\n          throw new Error(`Missing 'schedule' field for periodic event in ${filename}`);\n        }\n        if (!data.timezone) {\n          throw new Error(`Missing 'timezone' field for periodic event in ${filename}`);\n        }\n        return {\n          type: \"periodic\",\n          platform,\n          channelId: data.channelId,\n          userId,\n          text: data.text,\n          schedule: data.schedule,\n          timezone: data.timezone,\n        };\n\n      default:\n        throw new Error(`Unknown event type '${data.type}' in ${filename}`);\n    }\n  }\n\n  private resolvePlatform(platformValue: unknown, filename: string): string {\n    const availablePlatforms = Object.keys(this.botsByPlatform);\n\n    if (typeof platformValue === \"string\" && platformValue.trim().length > 0) {\n      const platform = platformValue.trim().toLowerCase();\n      if (!this.botsByPlatform[platform]) {\n        throw new Error(\n          `Unknown platform '${platformValue}' in ${filename}. Expected one of: ${availablePlatforms.join(\", \")}`,\n        );\n      }\n      return platform;\n    }\n\n    if (availablePlatforms.length === 1) {\n      return availablePlatforms[0];\n    }\n\n    throw new Error(\n      `Missing required field 'platform' in ${filename}. Available platforms: ${availablePlatforms.join(\", \")}`,\n    );\n  }\n\n  private 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);\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);\n      return;\n    }\n\n    const delay = atTime - now;\n    log.logInfo(`Scheduling one-shot event: ${filename} in ${Math.round(delay / 1000)}s`);\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  }\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);\n    }\n  }\n\n  private execute(filename: string, event: MamaEvent, deleteAfter: boolean = true): void {\n    // Format the message\n    let scheduleInfo: string;\n    switch (event.type) {\n      case \"immediate\":\n        scheduleInfo = \"immediate\";\n        break;\n      case \"one-shot\":\n        scheduleInfo = event.at;\n        break;\n      case \"periodic\":\n        scheduleInfo = event.schedule;\n        break;\n    }\n\n    const message = `[EVENT:${filename}:${event.type}:${scheduleInfo}] ${event.text}`;\n    const bot = this.botsByPlatform[event.platform];\n\n    if (!bot) {\n      log.logWarning(`No bot configured for event platform '${event.platform}'`, filename);\n      if (deleteAfter) {\n        this.deleteFile(filename);\n      }\n      return;\n    }\n\n    // Create synthetic BotEvent. Keep a stable channel session key so recurring\n    // reminders share context, but use a unique synthetic message id because\n    // some adapters treat `ts`/message id as a reply target.\n    // `user` falls back to \"EVENT\" when the event file omits a creator; vault\n    // routing then resolves to an empty auto-created entry or shared container vault\n    // with no credentials configured yet.\n    const syntheticEvent: BotEvent = {\n      type: \"mention\",\n      conversationId: event.channelId,\n      user: event.userId ?? \"EVENT\",\n      text: message,\n      ts: `event:${filename}`,\n      sessionKey: event.channelId,\n    };\n\n    // Enqueue for processing\n    const enqueued = bot.enqueueEvent(syntheticEvent);\n\n    if (enqueued && deleteAfter) {\n      // Delete file after successful enqueue (immediate and one-shot)\n      this.deleteFile(filename);\n    } else if (!enqueued) {\n      log.logWarning(`Event queue full, discarded: ${filename}`);\n      // Still delete immediate/one-shot even if discarded\n      if (deleteAfter) {\n        this.deleteFile(filename);\n      }\n    }\n  }\n\n  private deleteFile(filename: string): void {\n    const filePath = join(this.eventsDir, filename);\n    try {\n      unlinkSync(filePath);\n    } catch (err) {\n      // ENOENT is fine (file already deleted), other errors are warnings\n      if (err instanceof Error && \"code\" in err && err.code !== \"ENOENT\") {\n        log.logWarning(`Failed to delete event file: ${filename}`, String(err));\n      }\n    }\n    this.knownFiles.delete(filename);\n  }\n\n  private sleep(ms: number): Promise<void> {\n    return new Promise((resolve) => setTimeout(resolve, ms));\n  }\n}\n\n/**\n * Create an events watcher for all configured platforms.\n */\nexport function createEventsWatcher(\n  workspaceDir: string,\n  botsByPlatform: Record<string, Bot>,\n): EventsWatcher {\n  const eventsDir = join(workspaceDir, \"events\");\n  return new EventsWatcher(eventsDir, botsByPlatform);\n}\n"]}
+{"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 type { Bot, BotEvent, ConversationKind } from \"./adapter.js\";\nimport { ensureDirExists, isRecord, parseJsonValue } from \"./file-guards.js\";\nimport * as log from \"./log.js\";\nimport { inferConversationKind } from \"./session-policy.js\";\n\n// ============================================================================\n// Event Types\n// ============================================================================\n\nexport interface ImmediateEvent {\n  type: \"immediate\";\n  platform: string;\n  conversationId: string;\n  conversationKind: ConversationKind;\n  /** Creator userId — routes tool execution to that user's vault selection when fired. */\n  userId?: string;\n  text: string;\n}\n\nexport interface OneShotEvent {\n  type: \"one-shot\";\n  platform: string;\n  conversationId: string;\n  conversationKind: ConversationKind;\n  userId?: string;\n  text: string;\n  at: string; // ISO 8601 with timezone offset\n  // No sessionKey or threadTs: reminders fire as top-level messages regardless of where they were created.\n}\n\nexport interface PeriodicEvent {\n  type: \"periodic\";\n  platform: string;\n  conversationId: string;\n  conversationKind: ConversationKind;\n  userId?: string;\n  text: string;\n  schedule: string; // cron syntax\n  timezone: string; // IANA timezone\n}\n\nexport type MamaEvent = ImmediateEvent | OneShotEvent | PeriodicEvent;\n\nexport interface PeriodicEventInfo {\n  filename: string;\n  platform: string;\n  conversationId: string;\n  conversationKind: ConversationKind;\n  text: string;\n  schedule: string;\n  timezone: string;\n  nextRun: string | null; // ISO 8601\n}\n\n// ============================================================================\n// EventsWatcher\n// ============================================================================\n\nconst DEBOUNCE_MS = 100;\nconst MAX_RETRIES = 3;\nconst RETRY_BASE_MS = 100;\n\nexport class EventsWatcher {\n  private timers: Map<string, NodeJS.Timeout> = new Map();\n  private timerEventTypes: Map<string, \"one-shot\"> = new Map();\n  private crons: Map<string, Cron> = new Map();\n  private debounceTimers: Map<string, NodeJS.Timeout> = new Map();\n  private startTime: number;\n  private watcher: FSWatcher | null = null;\n  private knownFiles: Set<string> = new Set();\n\n  constructor(\n    private eventsDir: string,\n    private botsByPlatform: Record<string, Bot>,\n  ) {\n    this.startTime = Date.now();\n  }\n\n  /**\n   * Start watching for events. Call this after platform bots are initialized.\n   */\n  start(): void {\n    // Ensure events directory exists\n    ensureDirExists(this.eventsDir);\n\n    log.logInfo(`Events watcher starting, dir: ${this.eventsDir}`);\n\n    // Scan existing files\n    this.scanExisting();\n\n    // Watch for changes\n    this.watcher = watch(this.eventsDir, (eventType, filename) => {\n      if (!filename || !filename.endsWith(\".json\")) return;\n      log.logInfo(\n        `Events watcher fs event: ${String(eventType)} ${filename} (exists=${existsSync(join(this.eventsDir, filename))})`,\n      );\n      this.debounce(filename, () => this.handleFileChange(filename));\n    });\n\n    log.logInfo(`Events watcher started, tracking ${this.knownFiles.size} files`);\n  }\n\n  /**\n   * Stop watching and cancel all scheduled events.\n   */\n  stop(): void {\n    // Stop fs watcher\n    if (this.watcher) {\n      this.watcher.close();\n      this.watcher = null;\n    }\n\n    // Cancel all debounce timers\n    for (const timer of this.debounceTimers.values()) {\n      clearTimeout(timer);\n    }\n    this.debounceTimers.clear();\n\n    // Cancel all scheduled timers\n    for (const timer of this.timers.values()) {\n      clearTimeout(timer);\n    }\n    this.timers.clear();\n    this.timerEventTypes.clear();\n\n    // Cancel all cron jobs\n    for (const cron of this.crons.values()) {\n      cron.stop();\n    }\n    this.crons.clear();\n\n    this.knownFiles.clear();\n    log.logInfo(\"Events watcher stopped\");\n  }\n\n  /**\n   * Return all active periodic (cron) events with their next run time.\n   */\n  getPeriodicEvents(): PeriodicEventInfo[] {\n    const results: PeriodicEventInfo[] = [];\n    for (const [filename, cron] of this.crons) {\n      const filePath = join(this.eventsDir, filename);\n      try {\n        const content = readFileSync(filePath, \"utf-8\");\n        const data = this.parseEvent(content, filename);\n        if (!data || data.type !== \"periodic\") {\n          continue;\n        }\n        const next = cron.nextRun();\n        results.push({\n          filename,\n          platform: data.platform,\n          conversationId: data.conversationId,\n          conversationKind: data.conversationKind,\n          text: data.text,\n          schedule: data.schedule,\n          timezone: data.timezone,\n          nextRun: next?.toISOString() ?? null,\n        });\n      } catch {\n        // File may have been deleted or corrupted, skip\n      }\n    }\n    return results;\n  }\n\n  private debounce(filename: string, fn: () => void): void {\n    const existing = this.debounceTimers.get(filename);\n    if (existing) {\n      clearTimeout(existing);\n    }\n    this.debounceTimers.set(\n      filename,\n      setTimeout(() => {\n        this.debounceTimers.delete(filename);\n        fn();\n      }, DEBOUNCE_MS),\n    );\n  }\n\n  private scanExisting(): void {\n    let files: string[];\n    try {\n      files = readdirSync(this.eventsDir).filter((f) => f.endsWith(\".json\"));\n    } catch (err) {\n      log.logWarning(\"Failed to read events directory\", String(err));\n      return;\n    }\n\n    for (const filename of files) {\n      this.handleFile(filename);\n    }\n  }\n\n  private handleFileChange(filename: string): void {\n    const filePath = join(this.eventsDir, filename);\n    const exists = existsSync(filePath);\n    const known = this.knownFiles.has(filename);\n    log.logInfo(`Handling event file change: ${filename} (exists=${exists}, known=${known})`);\n\n    if (!exists) {\n      // fs.watch can briefly report a file as missing during create/rename churn.\n      // Confirm deletion before canceling scheduled events.\n      void this.handleDelete(filename);\n    } else if (known) {\n      // File was modified - cancel existing and re-schedule\n      this.cancelScheduled(filename, \"file-modified\");\n      void this.handleFile(filename);\n    } else {\n      // New file\n      void this.handleFile(filename);\n    }\n  }\n\n  private async handleDelete(filename: string): Promise<void> {\n    if (!this.knownFiles.has(filename)) return;\n\n    const filePath = join(this.eventsDir, filename);\n    for (let i = 0; i < MAX_RETRIES; i++) {\n      const delay = RETRY_BASE_MS * 2 ** i;\n      await this.sleep(delay);\n      const exists = existsSync(filePath);\n      log.logInfo(`Confirming event deletion: ${filename} after ${delay}ms (exists=${exists})`);\n      if (exists) {\n        return;\n      }\n    }\n\n    if (this.timerEventTypes.get(filename) === \"one-shot\" && this.timers.has(filename)) {\n      log.logInfo(\n        `Ignoring deleted one-shot file after scheduling: ${filename} (timer remains active)`,\n      );\n      return;\n    }\n\n    log.logInfo(`Event file deleted: ${filename}`);\n    this.cancelScheduled(filename, \"confirmed-delete\");\n    this.knownFiles.delete(filename);\n  }\n\n  private cancelScheduled(filename: string, reason = \"unspecified\"): void {\n    const timer = this.timers.get(filename);\n    const cron = this.crons.get(filename);\n    log.logInfo(\n      `Canceling scheduled event: ${filename} (reason=${reason}, timer=${Boolean(timer)}, cron=${Boolean(cron)})`,\n    );\n    if (timer) {\n      clearTimeout(timer);\n      this.timers.delete(filename);\n      this.timerEventTypes.delete(filename);\n    }\n\n    if (cron) {\n      cron.stop();\n      this.crons.delete(filename);\n    }\n  }\n\n  private async handleFile(filename: string): Promise<void> {\n    const filePath = join(this.eventsDir, filename);\n    log.logInfo(`Loading event file: ${filename} from ${filePath}`);\n\n    // Parse with retries\n    let event: MamaEvent | null = null;\n    let lastError: Error | null = null;\n\n    for (let i = 0; i < MAX_RETRIES; i++) {\n      try {\n        const content = await readFile(filePath, \"utf-8\");\n        event = this.parseEvent(content, filename);\n        break;\n      } catch (err) {\n        lastError = err instanceof Error ? err : new Error(String(err));\n        if (i < MAX_RETRIES - 1) {\n          await this.sleep(RETRY_BASE_MS * 2 ** i);\n        }\n      }\n    }\n\n    if (!event) {\n      log.logWarning(\n        `Failed to parse event file after ${MAX_RETRIES} retries: ${filename}`,\n        lastError?.message,\n      );\n      this.deleteFile(filename, \"parse-failed\");\n      return;\n    }\n\n    this.knownFiles.add(filename);\n    log.logInfo(\n      `Parsed event file: ${filename} (${event.type} for ${event.platform}/${event.conversationId})`,\n    );\n\n    // Schedule based on type\n    switch (event.type) {\n      case \"immediate\":\n        this.handleImmediate(filename, event);\n        break;\n      case \"one-shot\":\n        this.handleOneShot(filename, event);\n        break;\n      case \"periodic\":\n        this.handlePeriodic(filename, event);\n        break;\n    }\n  }\n\n  private parseEvent(content: string, filename: string): MamaEvent | null {\n    const data = parseJsonValue(content, isRecord, (detail) =>\n      detail === \"unexpected JSON shape\" ? `Expected top-level JSON object in ${filename}` : detail,\n    );\n    const conversationId =\n      typeof data.conversationId === \"string\"\n        ? data.conversationId\n        : typeof data.channelId === \"string\"\n          ? data.channelId\n          : undefined;\n    const type = typeof data.type === \"string\" ? data.type : undefined;\n    const text = typeof data.text === \"string\" ? data.text : undefined;\n\n    if (!type || !conversationId || !text) {\n      throw new Error(`Missing required fields (type, conversationId, text) in ${filename}`);\n    }\n\n    const platform = this.resolvePlatform(data.platform, filename);\n    const conversationKind = this.resolveConversationKind(\n      platform,\n      conversationId,\n      data.conversationKind,\n    );\n    const userId = typeof data.userId === \"string\" ? data.userId : undefined;\n    switch (type) {\n      case \"immediate\":\n        return {\n          type: \"immediate\",\n          platform,\n          conversationId,\n          conversationKind,\n          userId,\n          text,\n        };\n\n      case \"one-shot\":\n        if (typeof data.at !== \"string\" || data.at.length === 0) {\n          throw new Error(`Missing 'at' field for one-shot event in ${filename}`);\n        }\n        return {\n          type: \"one-shot\",\n          platform,\n          conversationId,\n          conversationKind,\n          userId,\n          text,\n          at: data.at,\n        };\n\n      case \"periodic\":\n        if (typeof data.schedule !== \"string\" || data.schedule.length === 0) {\n          throw new Error(`Missing 'schedule' field for periodic event in ${filename}`);\n        }\n        if (typeof data.timezone !== \"string\" || data.timezone.length === 0) {\n          throw new Error(`Missing 'timezone' field for periodic event in ${filename}`);\n        }\n        return {\n          type: \"periodic\",\n          platform,\n          conversationId,\n          conversationKind,\n          userId,\n          text,\n          schedule: data.schedule,\n          timezone: data.timezone,\n        };\n\n      default:\n        throw new Error(`Unknown event type '${type}' in ${filename}`);\n    }\n  }\n\n  private resolvePlatform(platformValue: unknown, filename: string): string {\n    const availablePlatforms = Object.keys(this.botsByPlatform);\n\n    if (typeof platformValue === \"string\" && platformValue.trim().length > 0) {\n      const platform = platformValue.trim().toLowerCase();\n      if (!this.botsByPlatform[platform]) {\n        throw new Error(\n          `Unknown platform '${platformValue}' in ${filename}. Expected one of: ${availablePlatforms.join(\", \")}`,\n        );\n      }\n      return platform;\n    }\n\n    if (availablePlatforms.length === 1) {\n      return availablePlatforms[0];\n    }\n\n    throw new Error(\n      `Missing required field 'platform' in ${filename}. Available platforms: ${availablePlatforms.join(\", \")}`,\n    );\n  }\n\n  private resolveConversationKind(\n    platform: string,\n    conversationId: string,\n    conversationKindValue: unknown,\n  ): ConversationKind {\n    if (conversationKindValue === \"direct\" || conversationKindValue === \"shared\") {\n      return conversationKindValue;\n    }\n\n    return inferConversationKind(platform, conversationId);\n  }\n\n  private handleImmediate(filename: string, event: ImmediateEvent): void {\n    const filePath = join(this.eventsDir, filename);\n\n    // Check if stale (created before harness started)\n    try {\n      const stat = statSync(filePath);\n      if (stat.mtimeMs < this.startTime) {\n        log.logInfo(`Stale immediate event, deleting: ${filename}`);\n        this.deleteFile(filename, \"stale-immediate\");\n        return;\n      }\n    } catch {\n      // File may have been deleted\n      return;\n    }\n\n    log.logInfo(`Executing immediate event: ${filename}`);\n    this.execute(filename, event);\n  }\n\n  private handleOneShot(filename: string, event: OneShotEvent): void {\n    const atTime = new Date(event.at).getTime();\n    const now = Date.now();\n\n    if (atTime <= now) {\n      // Past - delete without executing\n      log.logInfo(`One-shot event in the past, deleting: ${filename}`);\n      this.deleteFile(filename, \"one-shot-in-past\");\n      return;\n    }\n\n    const delay = atTime - now;\n    log.logInfo(\n      `Scheduling one-shot event: ${filename} in ${Math.round(delay / 1000)}s (at=${event.at}, now=${new Date(now).toISOString()})`,\n    );\n\n    const timer = setTimeout(() => {\n      this.timers.delete(filename);\n      this.timerEventTypes.delete(filename);\n      log.logInfo(`Executing one-shot event: ${filename}`);\n      this.execute(filename, event);\n    }, delay);\n\n    this.timers.set(filename, timer);\n    this.timerEventTypes.set(filename, \"one-shot\");\n    log.logInfo(`Stored one-shot timer: ${filename} (active timers=${this.timers.size})`);\n  }\n\n  private handlePeriodic(filename: string, event: PeriodicEvent): void {\n    try {\n      const cron = new Cron(event.schedule, { timezone: event.timezone }, () => {\n        log.logInfo(`Executing periodic event: ${filename}`);\n        this.execute(filename, event, false); // Don't delete periodic events\n      });\n\n      this.crons.set(filename, cron);\n\n      const next = cron.nextRun();\n      log.logInfo(\n        `Scheduled periodic event: ${filename}, next run: ${next?.toISOString() ?? \"unknown\"}`,\n      );\n    } catch (err) {\n      log.logWarning(`Invalid cron schedule for ${filename}: ${event.schedule}`, String(err));\n      this.deleteFile(filename, \"invalid-cron\");\n    }\n  }\n\n  private execute(filename: string, event: MamaEvent, 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      if (deleteAfter) {\n        this.deleteFile(filename, \"missing-bot\");\n      }\n      return;\n    }\n\n    const eventId = filename.replace(/\\.json$/i, \"\");\n    const syntheticEvent: BotEvent = {\n      type: \"mention\",\n      conversationId: event.conversationId,\n      conversationKind: event.conversationKind,\n      user: event.userId ?? \"EVENT\",\n      text: message,\n      ts: `event:${eventId}`,\n    };\n\n    // Enqueue for processing\n    const enqueued = bot.enqueueEvent(syntheticEvent);\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      // Still delete immediate/one-shot even if discarded\n      if (deleteAfter) {\n        this.deleteFile(filename, \"queue-full-discarded\");\n      }\n    }\n  }\n\n  private buildEventPrompt(event: MamaEvent): string {\n    switch (event.type) {\n      case \"one-shot\":\n        return [\n          \"Please deliver the following reminder to the user in a short, natural way.\",\n          \"Do not greet, do not introduce yourself, and do not ask generic follow-up questions.\",\n          \"\",\n          `Reminder: ${event.text}`,\n        ].join(\"\\n\");\n      case \"periodic\":\n        return [\n          \"Handle the following recurring task.\",\n          \"Respond concisely. If there is nothing actionable to report, reply with [SILENT].\",\n          \"\",\n          `Task: ${event.text}`,\n        ].join(\"\\n\");\n      case \"immediate\":\n        return [\n          \"Handle the following event/update in a concise, context-appropriate way.\",\n          \"If it reads like a reminder or follow-up, deliver it directly without greeting or generic offers to help.\",\n          \"\",\n          `Event: ${event.text}`,\n        ].join(\"\\n\");\n    }\n  }\n\n  private deleteFile(filename: string, reason = \"unspecified\"): void {\n    const filePath = join(this.eventsDir, filename);\n    log.logInfo(`Deleting event file: ${filename} (reason=${reason})`);\n    try {\n      unlinkSync(filePath);\n    } catch (err) {\n      // ENOENT is fine (file already deleted), other errors are warnings\n      if (err instanceof Error && \"code\" in err && err.code !== \"ENOENT\") {\n        log.logWarning(`Failed to delete event file: ${filename}`, String(err));\n      }\n    }\n    this.knownFiles.delete(filename);\n  }\n\n  private sleep(ms: number): Promise<void> {\n    return new Promise((resolve) => setTimeout(resolve, ms));\n  }\n}\n\n/**\n * Create an events watcher for all configured platforms.\n */\nexport function createEventsWatcher(\n  workspaceDir: string,\n  botsByPlatform: Record<string, Bot>,\n): EventsWatcher {\n  const eventsDir = join(workspaceDir, \"events\");\n  return new EventsWatcher(eventsDir, botsByPlatform);\n}\n"]}

package/dist/execution-resolver.d.ts

@@ -1,20 +1,24 @@
-import type { UserBindingStore } from "./bindings.js";
 import { DockerContainerManager } from "./provisioner.js";
 import { type Executor, type SandboxConfig } from "./sandbox.js";
 import type { VaultManager } from "./vault.js";
 export interface ActorContext {
     platform: string;
     userId: string;
+    conversationId: string;
 }
+export type ImageWorkspaceMountMode = "private" | "full";
+export declare function readConversationWorkspaceMountMode(workspaceDir: string | undefined, conversationId: string): ImageWorkspaceMountMode;
 export declare class ActorExecutionResolver {
     private baseConfig;
     private vaultManager;
-    private bindingStore?;
     private provisioner?;
-    constructor(baseConfig: SandboxConfig, vaultManager: VaultManager, bindingStore?: UserBindingStore | undefined, provisioner?: DockerContainerManager | undefined);
-    refresh(): void;
+    private workspaceDir?;
+    private readonly ensuredConversationDirs;
+    constructor(baseConfig: SandboxConfig, vaultManager: VaultManager, provisioner?: DockerContainerManager | undefined, workspaceDir?: string | undefined);
     resolve(context: ActorContext): Promise<Executor>;
-    private getEnsureReady;
+    private resolveSandboxConfig;
+    private buildEnsureReadyCallback;
     private resolveMounts;
+    private buildImageSandboxMounts;
 }
 //# sourceMappingURL=execution-resolver.d.ts.map

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,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAC;AACtD,OAAO,EAAE,sBAAsB,EAAuB,MAAM,kBAAkB,CAAC;AAC/E,OAAO,EAAkB,KAAK,QAAQ,EAAE,KAAK,aAAa,EAAE,MAAM,cAAc,CAAC;AACjF,OAAO,KAAK,EAAiB,YAAY,EAAE,MAAM,YAAY,CAAC;AAG9D,MAAM,WAAW,YAAY;IAC3B,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,qBAAa,sBAAsB;IAE/B,OAAO,CAAC,UAAU;IAClB,OAAO,CAAC,YAAY;IACpB,OAAO,CAAC,YAAY,CAAC;IACrB,OAAO,CAAC,WAAW,CAAC;IAJtB,YACU,UAAU,EAAE,aAAa,EACzB,YAAY,EAAE,YAAY,EAC1B,YAAY,CAAC,EAAE,gBAAgB,YAAA,EAC/B,WAAW,CAAC,EAAE,sBAAsB,YAAA,EAC1C;IAEJ,OAAO,IAAI,IAAI,CAGd;IAEK,OAAO,CAAC,OAAO,EAAE,YAAY,GAAG,OAAO,CAAC,QAAQ,CAAC,CAoBtD;IAED,OAAO,CAAC,cAAc;IAuBtB,OAAO,CAAC,aAAa;CAUtB","sourcesContent":["import { existsSync } from \"fs\";\nimport type { UserBindingStore } from \"./bindings.js\";\nimport { DockerContainerManager, type ContainerMount } from \"./provisioner.js\";\nimport { createExecutor, type Executor, type SandboxConfig } from \"./sandbox.js\";\nimport type { ResolvedVault, VaultManager } from \"./vault.js\";\nimport { ensureSandboxVaultEntry, resolveActorVaultKey } from \"./vault-routing.js\";\n\nexport interface ActorContext {\n  platform: string;\n  userId: string;\n}\n\nexport class ActorExecutionResolver {\n  constructor(\n    private baseConfig: SandboxConfig,\n    private vaultManager: VaultManager,\n    private bindingStore?: UserBindingStore,\n    private provisioner?: DockerContainerManager,\n  ) {}\n\n  refresh(): void {\n    this.vaultManager.reload();\n    this.bindingStore?.reload();\n  }\n\n  async resolve(context: ActorContext): Promise<Executor> {\n    const vaultKey = resolveActorVaultKey(\n      this.baseConfig,\n      this.vaultManager,\n      this.bindingStore,\n      context.platform,\n      context.userId,\n    );\n    ensureSandboxVaultEntry(\n      this.baseConfig,\n      this.vaultManager,\n      context.platform,\n      context.userId,\n      vaultKey,\n    );\n    const vault = this.vaultManager.resolve(vaultKey);\n\n    const config = this.vaultManager.getSandboxConfig(vaultKey, this.baseConfig);\n    const env = vault && Object.keys(vault.env).length > 0 ? vault.env : undefined;\n    return createExecutor(config, env, this.getEnsureReady(vaultKey, config, vault));\n  }\n\n  private getEnsureReady(\n    vaultKey: string,\n    config: SandboxConfig,\n    vault?: ResolvedVault,\n  ): (() => Promise<void>) | undefined {\n    if (this.baseConfig.type !== \"image\" || config.type !== \"container\") {\n      return undefined;\n    }\n\n    return async () => {\n      const expected = config.container || DockerContainerManager.containerName(vaultKey);\n      const actual = await this.provisioner?.provision(vaultKey, {\n        containerName: expected,\n        mounts: vault ? this.resolveMounts(vault) : [],\n      });\n      if (actual && actual !== expected) {\n        throw new Error(\n          `Provisioner returned container \"${actual}\" for vault \"${vaultKey}\", expected \"${expected}\"`,\n        );\n      }\n    };\n  }\n\n  private resolveMounts(vault: ResolvedVault): ContainerMount[] {\n    // Last-write-wins by target so stale legacy entries don't fail container\n    // startup with duplicate bind mounts pointing at the same path.\n    const mountsByTarget = new Map<string, ContainerMount>();\n    for (const mount of vault.mounts) {\n      if (!existsSync(mount.source)) continue;\n      mountsByTarget.set(mount.target, { source: mount.source, target: mount.target });\n    }\n    return [...mountsByTarget.values()];\n  }\n}\n"]}
+{"version":3,"file":"execution-resolver.d.ts","sourceRoot":"","sources":["../src/execution-resolver.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,sBAAsB,EAAuB,MAAM,kBAAkB,CAAC;AAC/E,OAAO,EAAkB,KAAK,QAAQ,EAAE,KAAK,aAAa,EAAE,MAAM,cAAc,CAAC;AACjF,OAAO,KAAK,EAAiB,YAAY,EAAE,MAAM,YAAY,CAAC;AAG9D,MAAM,WAAW,YAAY;IAC3B,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,MAAM,CAAC;IACf,cAAc,EAAE,MAAM,CAAC;CACxB;AAED,MAAM,MAAM,uBAAuB,GAAG,SAAS,GAAG,MAAM,CAAC;AAEzD,wBAAgB,kCAAkC,CAChD,YAAY,EAAE,MAAM,GAAG,SAAS,EAChC,cAAc,EAAE,MAAM,GACrB,uBAAuB,CAgBzB;AAyBD,qBAAa,sBAAsB;IAI/B,OAAO,CAAC,UAAU;IAClB,OAAO,CAAC,YAAY;IACpB,OAAO,CAAC,WAAW,CAAC;IACpB,OAAO,CAAC,YAAY,CAAC;IANvB,OAAO,CAAC,QAAQ,CAAC,uBAAuB,CAAqB;IAE7D,YACU,UAAU,EAAE,aAAa,EACzB,YAAY,EAAE,YAAY,EAC1B,WAAW,CAAC,EAAE,sBAAsB,YAAA,EACpC,YAAY,CAAC,EAAE,MAAM,YAAA,EAC3B;IAEE,OAAO,CAAC,OAAO,EAAE,YAAY,GAAG,OAAO,CAAC,QAAQ,CAAC,CAYtD;IAED,OAAO,CAAC,oBAAoB;IAgB5B,OAAO,CAAC,wBAAwB;IAyBhC,OAAO,CAAC,aAAa;IAYrB,OAAO,CAAC,uBAAuB;CAsBhC","sourcesContent":["import { existsSync } from \"fs\";\nimport { join } from \"path\";\nimport { loadAgentConfig, loadAgentConfigForConversation } from \"./config.js\";\nimport { ensureDirExists, isRecord, readJsonFileIfExists } from \"./file-guards.js\";\nimport { DockerContainerManager, type ContainerMount } from \"./provisioner.js\";\nimport { createExecutor, type Executor, type SandboxConfig } from \"./sandbox.js\";\nimport type { ResolvedVault, VaultManager } from \"./vault.js\";\nimport { resolveActorVaultKey } from \"./vault-routing.js\";\n\nexport interface ActorContext {\n  platform: string;\n  userId: string;\n  conversationId: string;\n}\n\nexport type ImageWorkspaceMountMode = \"private\" | \"full\";\n\nexport function readConversationWorkspaceMountMode(\n  workspaceDir: string | undefined,\n  conversationId: string,\n): ImageWorkspaceMountMode {\n  const globalDefault = readGlobalWorkspaceMountMode();\n  if (!workspaceDir) {\n    return globalDefault;\n  }\n\n  const conversationDir = join(workspaceDir, conversationId);\n  try {\n    return (\n      loadAgentConfigForConversation(conversationDir).sandboxImageWorkspaceMount ?? globalDefault\n    );\n  } catch {\n    const conversationSettingsPath = join(conversationDir, \"settings.json\");\n    const raw = readConversationSettingsFallback(conversationSettingsPath);\n    return raw?.sandbox?.image?.workspaceMount ?? globalDefault;\n  }\n}\n\nfunction readGlobalWorkspaceMountMode(): ImageWorkspaceMountMode {\n  try {\n    return loadAgentConfig().sandboxImageWorkspaceMount ?? \"private\";\n  } catch {\n    return \"private\";\n  }\n}\n\nfunction readConversationSettingsFallback(\n  settingsPath: string,\n): { sandbox?: { image?: { workspaceMount?: ImageWorkspaceMountMode } } } | undefined {\n  try {\n    return readJsonFileIfExists(\n      settingsPath,\n      (value): value is { sandbox?: { image?: { workspaceMount?: ImageWorkspaceMountMode } } } =>\n        isRecord(value),\n      () => \"Ignoring malformed conversation settings file while resolving workspace mount\",\n    );\n  } catch {\n    return undefined;\n  }\n}\n\nexport class ActorExecutionResolver {\n  private readonly ensuredConversationDirs = new Set<string>();\n\n  constructor(\n    private baseConfig: SandboxConfig,\n    private vaultManager: VaultManager,\n    private provisioner?: DockerContainerManager,\n    private workspaceDir?: string,\n  ) {}\n\n  async resolve(context: ActorContext): Promise<Executor> {\n    const vaultKey = resolveActorVaultKey(this.baseConfig, context.userId, context.conversationId);\n\n    const vault = this.vaultManager.resolve(vaultKey);\n    const config = this.resolveSandboxConfig(vaultKey);\n    const env =\n      config.type !== \"host\" && vault && Object.keys(vault.env).length > 0 ? vault.env : undefined;\n    return createExecutor(\n      config,\n      env,\n      this.buildEnsureReadyCallback(vaultKey, context.conversationId, config, vault),\n    );\n  }\n\n  private resolveSandboxConfig(vaultKey: string): SandboxConfig {\n    const config = this.vaultManager.getSandboxConfig(vaultKey, this.baseConfig);\n    if (this.baseConfig.type !== \"image\") {\n      return config;\n    }\n\n    if (config.type === \"container\") {\n      return config;\n    }\n\n    return {\n      type: \"container\",\n      container: DockerContainerManager.containerName(vaultKey),\n    };\n  }\n\n  private buildEnsureReadyCallback(\n    vaultKey: string,\n    conversationId: string,\n    config: SandboxConfig,\n    vault?: ResolvedVault,\n  ): (() => Promise<void>) | undefined {\n    if (this.baseConfig.type !== \"image\" || config.type !== \"container\") {\n      return undefined;\n    }\n\n    return async () => {\n      const expected = config.container || DockerContainerManager.containerName(vaultKey);\n      const actual = await this.provisioner?.provision(vaultKey, {\n        containerName: expected,\n        mounts: this.resolveMounts(conversationId, vault),\n        conversationId,\n      });\n      if (actual && actual !== expected) {\n        throw new Error(\n          `Provisioner returned container \"${actual}\" for container key \"${vaultKey}\", expected \"${expected}\"`,\n        );\n      }\n    };\n  }\n\n  private resolveMounts(conversationId: string, vault?: ResolvedVault): ContainerMount[] {\n    const mountsByTarget = new Map<string, ContainerMount>();\n    for (const mount of this.buildImageSandboxMounts(conversationId)) {\n      mountsByTarget.set(mount.target, mount);\n    }\n    for (const mount of vault?.mounts ?? []) {\n      if (!existsSync(mount.source)) continue;\n      mountsByTarget.set(mount.target, { source: mount.source, target: mount.target });\n    }\n    return [...mountsByTarget.values()];\n  }\n\n  private buildImageSandboxMounts(conversationId: string): ContainerMount[] {\n    if (!this.workspaceDir) {\n      return [];\n    }\n\n    if (readConversationWorkspaceMountMode(this.workspaceDir, conversationId) === \"full\") {\n      return [{ source: this.workspaceDir, target: \"/workspace\" }];\n    }\n\n    const conversationDir = join(this.workspaceDir, conversationId);\n    if (!this.ensuredConversationDirs.has(conversationId)) {\n      ensureDirExists(conversationDir);\n      this.ensuredConversationDirs.add(conversationId);\n    }\n\n    return [\n      { source: join(this.workspaceDir, \"MEMORY.md\"), target: \"/workspace/MEMORY.md\" },\n      { source: join(this.workspaceDir, \"skills\"), target: \"/workspace/skills\" },\n      { source: join(this.workspaceDir, \"events\"), target: \"/workspace/events\" },\n      { source: conversationDir, target: `/workspace/${conversationId}` },\n    ];\n  }\n}\n"]}