agent-relay 4.0.30 → 4.0.32

package/dist/index.cjs

@@ -4779,7 +4779,7 @@ var require_has_flag = __commonJS({
 var require_supports_color = __commonJS({
   "node_modules/supports-color/index.js"(exports2, module2) {
     "use strict";
-    var os11 = require("os");
+    var os12 = require("os");
     var tty = require("tty");
     var hasFlag = require_has_flag();
     var { env } = process;
@@ -4827,7 +4827,7 @@ var require_supports_color = __commonJS({
         return min;
       }
       if (process.platform === "win32") {
-        const osRelease = os11.release().split(".");
+        const osRelease = os12.release().split(".");
         if (Number(osRelease[0]) >= 10 && Number(osRelease[2]) >= 10586) {
           return Number(osRelease[2]) >= 14931 ? 3 : 2;
         }
@@ -13391,11 +13391,11 @@ __export(base_exports, {
   setCwd: () => setCwd,
   synchronizedOutput: () => synchronizedOutput
 });
-var import_node_process, import_node_os9, ESC, OSC, BEL, SEP, isTerminalApp, isWindows2, isTmux, cwdFunction, wrapOsc, cursorTo, cursorMove, cursorUp, cursorDown, cursorForward, cursorBackward, cursorLeft, cursorSavePosition, cursorRestorePosition, cursorGetPosition, cursorNextLine, cursorPrevLine, cursorHide, cursorShow, eraseLines, eraseEndLine, eraseStartLine, eraseLine, eraseDown, eraseUp, eraseScreen, scrollUp, scrollDown, clearScreen, clearViewport, isOldWindows, clearTerminal, enterAlternativeScreen, exitAlternativeScreen, beginSynchronizedOutput, endSynchronizedOutput, synchronizedOutput, beep, link, image, iTerm, ConEmu, setCwd;
+var import_node_process, import_node_os10, ESC, OSC, BEL, SEP, isTerminalApp, isWindows2, isTmux, cwdFunction, wrapOsc, cursorTo, cursorMove, cursorUp, cursorDown, cursorForward, cursorBackward, cursorLeft, cursorSavePosition, cursorRestorePosition, cursorGetPosition, cursorNextLine, cursorPrevLine, cursorHide, cursorShow, eraseLines, eraseEndLine, eraseStartLine, eraseLine, eraseDown, eraseUp, eraseScreen, scrollUp, scrollDown, clearScreen, clearViewport, isOldWindows, clearTerminal, enterAlternativeScreen, exitAlternativeScreen, beginSynchronizedOutput, endSynchronizedOutput, synchronizedOutput, beep, link, image, iTerm, ConEmu, setCwd;
 var init_base = __esm({
   "node_modules/ansi-escapes/base.js"() {
     import_node_process = __toESM(require("node:process"), 1);
-    import_node_os9 = __toESM(require("node:os"), 1);
+    import_node_os10 = __toESM(require("node:os"), 1);
     init_environment();
     ESC = "\x1B[";
     OSC = "\x1B]";
@@ -13475,7 +13475,7 @@ var init_base = __esm({
       if (isBrowser || !isWindows2) {
         return false;
       }
-      const parts = import_node_os9.default.release().split(".");
+      const parts = import_node_os10.default.release().split(".");
       const major = Number(parts[0]);
       const build = Number(parts[2] ?? 0);
       if (major < 10) {
@@ -16708,7 +16708,7 @@ function delay2(time3) {
     setTimeout(resolve4, time3);
   });
 }
-var import_node_util3, import_util6, import_os, import_string_decoder, import_stream2, import_rfdc, import_crypto2, ANSI_ESCAPE2, ANSI_ESCAPE_CODES, ListrEnvironmentVariables, ListrErrorTypes, ListrEventType, ListrRendererSelection, ListrTaskEventType, ListrTaskState, EventManager, BaseEventMap, CLEAR_LINE_REGEX, BELL_REGEX, color, FIGURES_MAIN, FIGURES_FALLBACK, figures, ListrLogLevels, LISTR_LOGGER_STYLE, LISTR_LOGGER_STDERR_LEVELS, ListrLogger, ProcessOutputBuffer, ProcessOutputStream, ProcessOutput, ListrPromptAdapter, Spinner, ListrDefaultRendererLogLevels, LISTR_DEFAULT_RENDERER_STYLE, PRESET_TIMER, PRESET_TIMESTAMP, DefaultRenderer, SilentRenderer, SimpleRenderer, TestRendererSerializer, TestRenderer, VerboseRenderer, RENDERERS, clone2, Concurrency, ListrError, ListrRendererError, PromptError, TaskWrapper, ListrTaskEventManager, Task, ListrEventManager, Listr;
+var import_node_util3, import_util6, import_os, import_string_decoder, import_stream2, import_rfdc, import_crypto3, ANSI_ESCAPE2, ANSI_ESCAPE_CODES, ListrEnvironmentVariables, ListrErrorTypes, ListrEventType, ListrRendererSelection, ListrTaskEventType, ListrTaskState, EventManager, BaseEventMap, CLEAR_LINE_REGEX, BELL_REGEX, color, FIGURES_MAIN, FIGURES_FALLBACK, figures, ListrLogLevels, LISTR_LOGGER_STYLE, LISTR_LOGGER_STDERR_LEVELS, ListrLogger, ProcessOutputBuffer, ProcessOutputStream, ProcessOutput, ListrPromptAdapter, Spinner, ListrDefaultRendererLogLevels, LISTR_DEFAULT_RENDERER_STYLE, PRESET_TIMER, PRESET_TIMESTAMP, DefaultRenderer, SilentRenderer, SimpleRenderer, TestRendererSerializer, TestRenderer, VerboseRenderer, RENDERERS, clone2, Concurrency, ListrError, ListrRendererError, PromptError, TaskWrapper, ListrTaskEventManager, Task, ListrEventManager, Listr;
 var init_dist = __esm({
   "node_modules/listr2/dist/index.mjs"() {
     init_eventemitter3();
@@ -16718,7 +16718,7 @@ var init_dist = __esm({
     import_string_decoder = require("string_decoder");
     import_stream2 = require("stream");
     import_rfdc = __toESM(require_rfdc(), 1);
-    import_crypto2 = require("crypto");
+    import_crypto3 = require("crypto");
     ANSI_ESCAPE2 = "\x1B[";
     ANSI_ESCAPE_CODES = {
       CURSOR_HIDE: ANSI_ESCAPE2 + "?25l",
@@ -18049,7 +18049,7 @@ var init_dist = __esm({
     };
     Task = class extends ListrTaskEventManager {
       /** Unique id per task, can be used for identifying a Task. */
-      id = (0, import_crypto2.randomUUID)();
+      id = (0, import_crypto3.randomUUID)();
       /** The current state of the task. */
       state = ListrTaskState.WAITING;
       /** Subtasks of the current task. */
@@ -27314,7 +27314,7 @@ var DefaultModels = {
 };
 
 // node_modules/@relaycast/sdk/dist/version.js
-var SDK_VERSION = "1.1.2";
+var SDK_VERSION = "1.1.3";
 
 // node_modules/@relaycast/sdk/node_modules/zod/v4/classic/external.js
 var external_exports2 = {};
@@ -43582,6 +43582,7 @@ var AgentRelay = class {
   onDeliveryUpdate = null;
   onAgentExitRequested = null;
   onAgentIdle = null;
+  onAgentActivityChanged = null;
   onChannelSubscribed = null;
   onChannelUnsubscribed = null;
   // ── Public accessors ────────────────────────────────────────────────────
@@ -43617,6 +43618,7 @@ var AgentRelay = class {
   exitedAgents = /* @__PURE__ */ new Set();
   idleAgents = /* @__PURE__ */ new Set();
   deliveryStates = /* @__PURE__ */ new Map();
+  agentActivityStates = /* @__PURE__ */ new Map();
   outputListeners = /* @__PURE__ */ new Map();
   exitResolvers = /* @__PURE__ */ new Map();
   exitResolverSeq = 0;
@@ -44154,6 +44156,7 @@ var AgentRelay = class {
     this.exitedAgents.clear();
     this.idleAgents.clear();
     this.deliveryStates.clear();
+    this.agentActivityStates.clear();
     this.outputListeners.clear();
     for (const entry of this.exitResolvers.values()) {
       entry.resolve("released");
@@ -44177,6 +44180,68 @@ var AgentRelay = class {
   updateDeliveryState(eventId, to2, status, updatedAt) {
     this.deliveryStates.set(eventId, { eventId, to: to2, status, updatedAt });
   }
+  ensureAgentActivityState(name) {
+    const existing = this.agentActivityStates.get(name);
+    if (existing) {
+      return existing;
+    }
+    const state = {
+      active: false,
+      pendingDeliveries: /* @__PURE__ */ new Map()
+    };
+    this.agentActivityStates.set(name, state);
+    return state;
+  }
+  getDeliveryActivityKey(deliveryId, eventId) {
+    return deliveryId || eventId;
+  }
+  markAgentDeliveryPending(name, deliveryId, eventId, reason) {
+    const state = this.ensureAgentActivityState(name);
+    state.pendingDeliveries.set(this.getDeliveryActivityKey(deliveryId, eventId), eventId);
+    this.setAgentActivity(name, state, state.pendingDeliveries.size > 0, reason, eventId);
+  }
+  closeAgentDelivery(name, reason, eventId, deliveryId) {
+    const state = this.agentActivityStates.get(name);
+    if (!state)
+      return;
+    const key = deliveryId && eventId ? this.getDeliveryActivityKey(deliveryId, eventId) : void 0;
+    if (key) {
+      state.pendingDeliveries.delete(key);
+    } else if (eventId) {
+      const matchingEntry = Array.from(state.pendingDeliveries.entries()).find(([, pendingEventId]) => {
+        return pendingEventId === eventId;
+      });
+      if (matchingEntry) {
+        state.pendingDeliveries.delete(matchingEntry[0]);
+      } else {
+        const oldestKey = state.pendingDeliveries.keys().next().value;
+        if (oldestKey) {
+          state.pendingDeliveries.delete(oldestKey);
+        }
+      }
+    }
+    this.setAgentActivity(name, state, state.pendingDeliveries.size > 0, reason, eventId);
+  }
+  clearAgentDeliveries(name, reason, eventId) {
+    const state = this.agentActivityStates.get(name);
+    if (!state)
+      return;
+    state.pendingDeliveries.clear();
+    this.setAgentActivity(name, state, false, reason, eventId);
+  }
+  setAgentActivity(name, state, active, reason, eventId) {
+    if (state.active === active) {
+      return;
+    }
+    state.active = active;
+    this.onAgentActivityChanged?.({
+      name,
+      active,
+      pendingDeliveries: state.pendingDeliveries.size,
+      reason,
+      eventId
+    });
+  }
   resolveEventTimestamp(candidate) {
     return typeof candidate === "number" ? candidate : Date.now();
   }
@@ -44321,10 +44386,12 @@ var AgentRelay = class {
     this.unsubEvent = client.onEvent((event) => {
       switch (event.kind) {
         case "relay_inbound": {
+          this.closeAgentDelivery(event.from, "relay_inbound", event.event_id);
           if (this.knownAgents.has(event.from)) {
             this.messageReadyAgents.add(event.from);
             this.exitedAgents.delete(event.from);
           }
+          this.clearAgentDeliveries(event.from, "relay_inbound", event.event_id);
           const msg = {
             eventId: event.event_id,
             from: event.from,
@@ -44347,6 +44414,7 @@ var AgentRelay = class {
         }
         case "agent_released": {
           const agent = this.knownAgents.get(event.name) ?? this.ensureAgentHandle(event.name, "pty", []);
+          this.clearAgentDeliveries(event.name, "agent_released");
           this.exitedAgents.add(event.name);
           this.readyAgents.delete(event.name);
           this.messageReadyAgents.delete(event.name);
@@ -44362,6 +44430,7 @@ var AgentRelay = class {
         }
         case "agent_exited": {
           const agent = this.knownAgents.get(event.name) ?? this.ensureAgentHandle(event.name, "pty", []);
+          this.clearAgentDeliveries(event.name, "agent_exited");
           this.exitedAgents.add(event.name);
           this.readyAgents.delete(event.name);
           this.messageReadyAgents.delete(event.name);
@@ -44402,14 +44471,17 @@ var AgentRelay = class {
           break;
         }
         case "delivery_queued": {
+          this.markAgentDeliveryPending(event.name, event.delivery_id, event.event_id, "delivery_queued");
           this.updateDeliveryState(event.event_id, event.name, "queued", this.resolveEventTimestamp(event.timestamp));
           break;
         }
         case "delivery_injected": {
+          this.markAgentDeliveryPending(event.name, event.delivery_id, event.event_id, "delivery_injected");
           this.updateDeliveryState(event.event_id, event.name, "injected", this.resolveEventTimestamp(event.timestamp));
           break;
         }
         case "delivery_active": {
+          this.markAgentDeliveryPending(event.name, event.delivery_id, event.event_id, "delivery_active");
           this.updateDeliveryState(event.event_id, event.name, "active", this.resolveEventTimestamp());
           break;
         }
@@ -44417,7 +44489,11 @@ var AgentRelay = class {
           this.updateDeliveryState(event.event_id, event.name, "verified", this.resolveEventTimestamp());
           break;
         }
+        case "delivery_ack": {
+          break;
+        }
         case "delivery_failed": {
+          this.closeAgentDelivery(event.name, "delivery_failed", event.event_id, event.delivery_id);
           this.updateDeliveryState(event.event_id, event.name, "failed", this.resolveEventTimestamp());
           break;
         }
@@ -44432,6 +44508,7 @@ var AgentRelay = class {
           break;
         }
         case "agent_idle": {
+          this.clearAgentDeliveries(event.name, "agent_idle");
           this.idleAgents.add(event.name);
           this.onAgentIdle?.({
             name: event.name,
@@ -44717,6 +44794,7 @@ var AgentRelay = class {
     this.messageReadyAgents.delete(name);
     this.exitedAgents.delete(name);
     this.idleAgents.delete(name);
+    this.agentActivityStates.delete(name);
   }
   normalizeReleaseOptions(reasonOrOptions) {
     if (typeof reasonOrOptions === "string" || reasonOrOptions === void 0) {
@@ -53135,9 +53213,10 @@ function delay(ms2) {
 // packages/sdk/dist/workflows/trajectory.js
 var import_node_path27 = require("node:path");
 
-// node_modules/agent-trajectories/dist/chunk-2XT3DOJC.js
+// node_modules/agent-trajectories/dist/chunk-27AQPWHK.js
 var import_module = require("module");
 var import_crypto = require("crypto");
+var import_crypto2 = require("crypto");
 var import_fs5 = require("fs");
 var import_promises7 = require("fs/promises");
 var import_path4 = require("path");
@@ -53689,6 +53768,16 @@ function expandPath(path24) {
   }
   return path24;
 }
+var indexLocks = /* @__PURE__ */ new Map();
+function withIndexLock(path24, task) {
+  const prev = indexLocks.get(path24) ?? Promise.resolve();
+  const next = prev.then(task, task);
+  indexLocks.set(
+    path24,
+    next.catch(() => void 0)
+  );
+  return next;
+}
 var FileStorage = class {
   baseDir;
   trajectoriesDir;
@@ -53715,10 +53804,10 @@ var FileStorage = class {
     await (0, import_promises7.mkdir)(this.activeDir, { recursive: true });
     await (0, import_promises7.mkdir)(this.completedDir, { recursive: true });
     if (!(0, import_fs5.existsSync)(this.indexPath)) {
-      await this.saveIndex({
-        version: 1,
-        lastUpdated: (/* @__PURE__ */ new Date()).toISOString(),
-        trajectories: {}
+      await withIndexLock(this.indexPath, async () => {
+        if (!(0, import_fs5.existsSync)(this.indexPath)) {
+          await this.saveIndex(this.emptyIndex());
+        }
       });
     }
     await this.reconcileIndex();
@@ -53746,49 +53835,51 @@ var FileStorage = class {
       skippedSchemaViolation: 0,
       skippedIoError: 0
     };
-    const index = await this.loadIndex();
-    const before = Object.keys(index.trajectories).length;
-    const discovered = [];
-    try {
-      const activeFiles = await (0, import_promises7.readdir)(this.activeDir);
-      for (const file2 of activeFiles) {
-        if (!file2.endsWith(".json")) continue;
-        discovered.push((0, import_path4.join)(this.activeDir, file2));
-      }
-    } catch (error48) {
-      if (error48.code !== "ENOENT") throw error48;
-    }
-    await this.walkJsonFilesInto(this.completedDir, discovered);
-    for (const filePath of discovered) {
-      summary.scanned += 1;
-      const result = await this.readTrajectoryFile(filePath);
-      if (!result.ok) {
-        if (result.reason === "malformed_json") {
-          summary.skippedMalformedJson += 1;
-        } else if (result.reason === "schema_violation") {
-          summary.skippedSchemaViolation += 1;
-        } else {
-          summary.skippedIoError += 1;
+    await withIndexLock(this.indexPath, async () => {
+      const index = await this.loadIndex();
+      const before = Object.keys(index.trajectories).length;
+      const discovered = [];
+      try {
+        const activeFiles = await (0, import_promises7.readdir)(this.activeDir);
+        for (const file2 of activeFiles) {
+          if (!file2.endsWith(".json")) continue;
+          discovered.push((0, import_path4.join)(this.activeDir, file2));
         }
-        continue;
+      } catch (error48) {
+        if (error48.code !== "ENOENT") throw error48;
+      }
+      await this.walkJsonFilesInto(this.completedDir, discovered);
+      for (const filePath of discovered) {
+        summary.scanned += 1;
+        const result = await this.readTrajectoryFile(filePath);
+        if (!result.ok) {
+          if (result.reason === "malformed_json") {
+            summary.skippedMalformedJson += 1;
+          } else if (result.reason === "schema_violation") {
+            summary.skippedSchemaViolation += 1;
+          } else {
+            summary.skippedIoError += 1;
+          }
+          continue;
+        }
+        const trajectory2 = result.trajectory;
+        if (index.trajectories[trajectory2.id]) {
+          summary.alreadyIndexed += 1;
+          continue;
+        }
+        index.trajectories[trajectory2.id] = {
+          title: trajectory2.task.title,
+          status: trajectory2.status,
+          startedAt: trajectory2.startedAt,
+          completedAt: trajectory2.completedAt,
+          path: filePath
+        };
+        summary.added += 1;
       }
-      const trajectory2 = result.trajectory;
-      if (index.trajectories[trajectory2.id]) {
-        summary.alreadyIndexed += 1;
-        continue;
+      if (Object.keys(index.trajectories).length !== before) {
+        await this.saveIndex(index);
       }
-      index.trajectories[trajectory2.id] = {
-        title: trajectory2.task.title,
-        status: trajectory2.status,
-        startedAt: trajectory2.startedAt,
-        completedAt: trajectory2.completedAt,
-        path: filePath
-      };
-      summary.added += 1;
-    }
-    if (Object.keys(index.trajectories).length !== before) {
-      await this.saveIndex(index);
-    }
+    });
     const hadSkips = summary.skippedMalformedJson + summary.skippedSchemaViolation + summary.skippedIoError > 0;
     if (summary.added > 0 || hadSkips) {
       const parts = [`reconciled ${summary.added}/${summary.scanned}`];
@@ -53991,17 +54082,19 @@ var FileStorage = class {
     if ((0, import_fs5.existsSync)(activePath)) {
       await (0, import_promises7.unlink)(activePath);
     }
-    const index = await this.loadIndex();
-    const entry = index.trajectories[id];
-    if (entry?.path && (0, import_fs5.existsSync)(entry.path)) {
-      await (0, import_promises7.unlink)(entry.path);
-      const mdPath = entry.path.replace(".json", ".md");
-      if ((0, import_fs5.existsSync)(mdPath)) {
-        await (0, import_promises7.unlink)(mdPath);
+    await withIndexLock(this.indexPath, async () => {
+      const index = await this.loadIndex();
+      const entry = index.trajectories[id];
+      if (entry?.path && (0, import_fs5.existsSync)(entry.path)) {
+        await (0, import_promises7.unlink)(entry.path);
+        const mdPath = entry.path.replace(".json", ".md");
+        if ((0, import_fs5.existsSync)(mdPath)) {
+          await (0, import_promises7.unlink)(mdPath);
+        }
       }
-    }
-    delete index.trajectories[id];
-    await this.saveIndex(index);
+      delete index.trajectories[id];
+      await this.saveIndex(index);
+    });
   }
   /**
    * Search trajectories by text
@@ -54079,10 +54172,23 @@ var FileStorage = class {
     const result = await this.readTrajectoryFile(path24);
     return result.ok ? result.trajectory : null;
   }
+  /**
+   * Read and parse the on-disk index.
+   *
+   * Tolerances (belt-and-braces against the read/write race):
+   *   - ENOENT: first-run, return an empty index silently.
+   *   - Empty file: a concurrent writer truncated index.json in "w" mode
+   *     right before we read. Return an empty index silently — this is
+   *     not a real corruption, just an interleaving the mutex + atomic
+   *     rename should already prevent. Logging here would be noise.
+   *   - Non-empty but malformed JSON: genuinely corrupted on disk (hand
+   *     edit, disk error, etc). Log it and return an empty index so the
+   *     caller can recover, but keep the log so the problem is visible.
+   */
   async loadIndex() {
+    let content;
     try {
-      const content = await (0, import_promises7.readFile)(this.indexPath, "utf-8");
-      return JSON.parse(content);
+      content = await (0, import_promises7.readFile)(this.indexPath, "utf-8");
     } catch (error48) {
       if (error48.code !== "ENOENT") {
         console.error(
@@ -54090,27 +54196,56 @@ var FileStorage = class {
           error48
         );
       }
-      return {
-        version: 1,
-        lastUpdated: (/* @__PURE__ */ new Date()).toISOString(),
-        trajectories: {}
-      };
+      return this.emptyIndex();
+    }
+    if (content.length === 0) {
+      return this.emptyIndex();
+    }
+    try {
+      return JSON.parse(content);
+    } catch (error48) {
+      console.error(
+        "Error loading trajectory index, using empty index:",
+        error48
+      );
+      return this.emptyIndex();
     }
   }
+  emptyIndex() {
+    return {
+      version: 1,
+      lastUpdated: (/* @__PURE__ */ new Date()).toISOString(),
+      trajectories: {}
+    };
+  }
+  /**
+   * Atomic write: stage into a process-unique temp path in the same directory
+   * and then rename over the live file. `rename` is atomic on POSIX, so
+   * concurrent readers in any process either see the old complete file or
+   * the new complete file — never a half-written / zero-byte state.
+   *
+   * Callers MUST hold `withIndexLock(this.indexPath, ...)` so the in-process
+   * read-modify-write cycle stays serialized; the unique temp name also keeps
+   * parallel writers in other processes from colliding on a shared tmp path.
+   */
   async saveIndex(index) {
     index.lastUpdated = (/* @__PURE__ */ new Date()).toISOString();
-    await (0, import_promises7.writeFile)(this.indexPath, JSON.stringify(index, null, 2), "utf-8");
+    const tmpPath = `${this.indexPath}.${process.pid}.${(0, import_crypto2.randomUUID)()}.tmp`;
+    await (0, import_promises7.writeFile)(tmpPath, JSON.stringify(index, null, 2), "utf-8");
+    await (0, import_promises7.rename)(tmpPath, this.indexPath);
   }
   async updateIndex(trajectory2, filePath) {
-    const index = await this.loadIndex();
-    index.trajectories[trajectory2.id] = {
-      title: trajectory2.task.title,
-      status: trajectory2.status,
-      startedAt: trajectory2.startedAt,
-      completedAt: trajectory2.completedAt,
-      path: filePath
-    };
-    await this.saveIndex(index);
+    await withIndexLock(this.indexPath, async () => {
+      const index = await this.loadIndex();
+      index.trajectories[trajectory2.id] = {
+        title: trajectory2.task.title,
+        status: trajectory2.status,
+        startedAt: trajectory2.startedAt,
+        completedAt: trajectory2.completedAt,
+        path: filePath
+      };
+      await this.saveIndex(index);
+    });
   }
 };
 var require22 = (0, import_module.createRequire)(import_meta_url);
@@ -59612,26 +59747,38 @@ ${preview}
 
 // packages/sdk/dist/workflows/file-db.js
 var import_node_fs21 = require("node:fs");
+var import_node_os9 = __toESM(require("node:os"), 1);
 var import_node_path29 = __toESM(require("node:path"), 1);
-var JsonFileWorkflowDb = class {
+var JsonFileWorkflowDb = class _JsonFileWorkflowDb {
   filePath;
-  /** Whether the storage directory is writable. False = silent no-op mode. */
+  /** Whether persistence is active. False = in-memory-only mode. */
   writable;
   appendFailedOnce = false;
-  constructor(filePath) {
-    this.filePath = filePath;
-    let writable = false;
-    try {
-      (0, import_node_fs21.mkdirSync)(import_node_path29.default.dirname(filePath), { recursive: true });
-      writable = true;
-    } catch {
-    }
+  onWriteFailure;
+  /**
+   * Authoritative in-memory mirror. Every mutation updates this; reads
+   * return from here. The jsonl file is only consulted at construction
+   * (to replay prior state for `--resume`) and is otherwise write-only.
+   */
+  cache;
+  constructor(filePathOrOptions) {
+    const options = typeof filePathOrOptions === "string" ? { filePath: filePathOrOptions } : filePathOrOptions;
+    this.onWriteFailure = options.onWriteFailure;
+    const requestedPath = options.filePath ?? import_node_path29.default.join(".agent-relay", "workflow-runs.jsonl");
+    const homeFallback = options.homeFallback ?? false;
+    const { resolvedPath, writable } = _JsonFileWorkflowDb.resolveStoragePath(requestedPath, homeFallback);
+    this.filePath = resolvedPath;
     this.writable = writable;
+    this.cache = _JsonFileWorkflowDb.loadSnapshot(this.filePath);
   }
-  /** Returns false if the storage directory could not be created (permission error). */
+  /** Returns false if persistence is not active (in-memory-only mode). */
   isWritable() {
     return this.writable;
   }
+  /** Resolved path on disk. For tests + diagnostics. */
+  getStoragePath() {
+    return this.filePath;
+  }
   hasStepOutputs(runId) {
     try {
       const dir = import_node_path29.default.join(import_node_path29.default.dirname(this.filePath), "step-outputs", runId);
@@ -59641,25 +59788,35 @@ var JsonFileWorkflowDb = class {
     }
   }
   // ── Private helpers ─────────────────────────────────────────────────────
-  append(entry) {
-    if (!this.writable)
-      return;
-    try {
-      (0, import_node_fs21.appendFileSync)(this.filePath, JSON.stringify(entry) + "\n", "utf8");
-    } catch (err) {
-      if (!this.appendFailedOnce) {
-        this.appendFailedOnce = true;
-        console.warn("[workflow] warning: failed to write run state to " + this.filePath + " \u2014 --resume will not be available for this run. Use --start-from instead. Error: " + (err instanceof Error ? err.message : String(err)));
+  static resolveStoragePath(requestedPath, homeFallback) {
+    const candidates = [requestedPath];
+    if (homeFallback) {
+      const base = import_node_path29.default.basename(requestedPath) || "workflow-runs.jsonl";
+      candidates.push(import_node_path29.default.join(import_node_os9.default.homedir(), ".agent-relay", `workflow-runs-${base}`));
+    }
+    for (let i = 0; i < candidates.length; i++) {
+      const candidate = candidates[i];
+      const isLastCandidate = i === candidates.length - 1;
+      try {
+        (0, import_node_fs21.mkdirSync)(import_node_path29.default.dirname(candidate), { recursive: true });
+        if (!isLastCandidate) {
+          (0, import_node_fs21.accessSync)(import_node_path29.default.dirname(candidate), import_node_fs21.constants.W_OK);
+          if ((0, import_node_fs21.existsSync)(candidate)) {
+            (0, import_node_fs21.accessSync)(candidate, import_node_fs21.constants.W_OK);
+          }
+        }
+        return { resolvedPath: candidate, writable: true };
+      } catch {
       }
     }
+    return { resolvedPath: requestedPath, writable: false };
   }
-  /** Read all lines and build the latest snapshot for each ID. */
-  snapshot() {
+  static loadSnapshot(filePath) {
     const runs = /* @__PURE__ */ new Map();
     const steps = /* @__PURE__ */ new Map();
     let raw = "";
     try {
-      raw = (0, import_node_fs21.readFileSync)(this.filePath, "utf8");
+      raw = (0, import_node_fs21.readFileSync)(filePath, "utf8");
     } catch {
       return { runs, steps };
     }
@@ -59679,34 +59836,57 @@ var JsonFileWorkflowDb = class {
     }
     return { runs, steps };
   }
+  append(entry) {
+    if (!this.writable)
+      return;
+    try {
+      (0, import_node_fs21.appendFileSync)(this.filePath, JSON.stringify(entry) + "\n", "utf8");
+    } catch (err) {
+      this.onWriteFailure?.(err, this.filePath);
+      if (!this.appendFailedOnce) {
+        this.appendFailedOnce = true;
+        console.warn("[workflow] warning: failed to write run state to " + this.filePath + " \u2014 --resume will not be available for this run. Use --start-from instead. Error: " + (err instanceof Error ? err.message : String(err)));
+      }
+    }
+  }
   // ── WorkflowDb interface ─────────────────────────────────────────────────
   async insertRun(run) {
+    this.cache.runs.set(run.id, { ...run });
     this.append({ kind: "run", row: run });
   }
   async updateRun(id, patch) {
-    const { runs } = this.snapshot();
-    const existing = runs.get(id);
+    const existing = this.cache.runs.get(id);
     if (!existing)
       return;
-    this.append({ kind: "run", row: { ...existing, ...patch, updatedAt: (/* @__PURE__ */ new Date()).toISOString() } });
+    const updated = {
+      ...existing,
+      ...patch,
+      updatedAt: (/* @__PURE__ */ new Date()).toISOString()
+    };
+    this.cache.runs.set(id, updated);
+    this.append({ kind: "run", row: updated });
   }
   async getRun(id) {
-    const { runs } = this.snapshot();
-    return runs.get(id) ?? null;
+    return this.cache.runs.get(id) ?? null;
   }
   async insertStep(step) {
+    this.cache.steps.set(step.id, { ...step });
     this.append({ kind: "step", row: step });
   }
   async updateStep(id, patch) {
-    const { steps } = this.snapshot();
-    const existing = steps.get(id);
+    const existing = this.cache.steps.get(id);
     if (!existing)
       return;
-    this.append({ kind: "step", row: { ...existing, ...patch, updatedAt: (/* @__PURE__ */ new Date()).toISOString() } });
+    const updated = {
+      ...existing,
+      ...patch,
+      updatedAt: (/* @__PURE__ */ new Date()).toISOString()
+    };
+    this.cache.steps.set(id, updated);
+    this.append({ kind: "step", row: updated });
   }
   async getStepsByRunId(runId) {
-    const { steps } = this.snapshot();
-    return Array.from(steps.values()).filter((s3) => s3.runId === runId);
+    return Array.from(this.cache.steps.values()).filter((s3) => s3.runId === runId);
   }
 };
 
@@ -62090,13 +62270,13 @@ function getRepoFullNameFromPath(workingDirectory) {
 var import_node_fs25 = __toESM(require("node:fs"), 1);
 var import_node_path33 = __toESM(require("node:path"), 1);
 var import_node_https2 = __toESM(require("node:https"), 1);
-var import_node_os10 = __toESM(require("node:os"), 1);
+var import_node_os11 = __toESM(require("node:os"), 1);
 var import_compare_versions = __toESM(require_umd(), 1);
 var PACKAGE_NAME = "agent-relay";
 var CHECK_INTERVAL_MS = 60 * 60 * 1e3;
 var NPM_REGISTRY_URL = `https://registry.npmjs.org/${PACKAGE_NAME}/latest`;
 function getCachePath() {
-  const cacheDir = import_node_path33.default.join(import_node_os10.default.homedir(), ".agent-relay");
+  const cacheDir = import_node_path33.default.join(import_node_os11.default.homedir(), ".agent-relay");
   return import_node_path33.default.join(cacheDir, "update-cache.json");
 }
 function readCache() {
@@ -62397,7 +62577,7 @@ function validateModelForCli(cli, model) {
 
 // packages/utils/dist/relay-pty-path.js
 var import_node_fs26 = __toESM(require("node:fs"), 1);
-var import_node_os11 = __toESM(require("node:os"), 1);
+var import_node_os12 = __toESM(require("node:os"), 1);
 var import_node_path34 = __toESM(require("node:path"), 1);
 var SUPPORTED_PLATFORMS = {
   darwin: {
@@ -62410,20 +62590,20 @@ var SUPPORTED_PLATFORMS = {
   }
 };
 function getPlatformBinaryName() {
-  const platform2 = import_node_os11.default.platform();
-  const arch = import_node_os11.default.arch();
+  const platform2 = import_node_os12.default.platform();
+  const arch = import_node_os12.default.arch();
   return SUPPORTED_PLATFORMS[platform2]?.[arch] ?? null;
 }
 function isPlatformSupported() {
-  const platform2 = import_node_os11.default.platform();
-  const arch = import_node_os11.default.arch();
+  const platform2 = import_node_os12.default.platform();
+  const arch = import_node_os12.default.arch();
   return SUPPORTED_PLATFORMS[platform2]?.[arch] !== void 0;
 }
 function getSupportedPlatforms() {
   const platforms = [];
-  for (const [os11, archs] of Object.entries(SUPPORTED_PLATFORMS)) {
+  for (const [os12, archs] of Object.entries(SUPPORTED_PLATFORMS)) {
     for (const arch of Object.keys(archs)) {
-      platforms.push(`${os11}-${arch}`);
+      platforms.push(`${os12}-${arch}`);
     }
   }
   return platforms.join(", ");
@@ -62536,7 +62716,7 @@ function isPlatformCompatibleBinary(filePath) {
       return false;
     }
     const magic = header.readUInt32BE(0);
-    const platform2 = import_node_os11.default.platform();
+    const platform2 = import_node_os12.default.platform();
     if (platform2 === "darwin") {
       return isMachOBinary(magic);
     }
@@ -63171,7 +63351,7 @@ var import_node_child_process10 = require("node:child_process");
 var import_node_crypto15 = __toESM(require("node:crypto"), 1);
 var import_node_path35 = __toESM(require("node:path"), 1);
 var import_node_fs27 = __toESM(require("node:fs"), 1);
-var import_node_os12 = __toESM(require("node:os"), 1);
+var import_node_os13 = __toESM(require("node:os"), 1);
 function getGlobalBaseDir2() {
   if (process.env.AGENT_RELAY_DATA_DIR) {
     return process.env.AGENT_RELAY_DATA_DIR;
@@ -63180,7 +63360,7 @@ function getGlobalBaseDir2() {
   if (xdgDataHome) {
     return import_node_path35.default.join(xdgDataHome, "agent-relay");
   }
-  return import_node_path35.default.join(import_node_os12.default.homedir(), ".agent-relay");
+  return import_node_path35.default.join(import_node_os13.default.homedir(), ".agent-relay");
 }
 var GLOBAL_BASE_DIR2 = getGlobalBaseDir2();
 var PROJECT_DATA_DIR = ".agent-relay";
@@ -63223,10 +63403,10 @@ function getProjectPaths2(projectRoot) {
 // packages/config/dist/trajectory-config.js
 var import_node_fs28 = require("node:fs");
 var import_node_path36 = require("node:path");
-var import_node_os13 = require("node:os");
+var import_node_os14 = require("node:os");
 var import_node_crypto16 = require("node:crypto");
 function getAgentRelayConfigDir() {
-  return process.env.AGENT_RELAY_CONFIG_DIR ?? (0, import_node_path36.join)((0, import_node_os13.homedir)(), ".config", "agent-relay");
+  return process.env.AGENT_RELAY_CONFIG_DIR ?? (0, import_node_path36.join)((0, import_node_os14.homedir)(), ".config", "agent-relay");
 }
 var configCache = null;
 function getRelayConfigPath(_projectRoot) {
@@ -63270,7 +63450,7 @@ function getProjectHash(projectRoot) {
 }
 function getUserTrajectoriesDir(projectRoot) {
   const projectHash = getProjectHash(projectRoot);
-  const configDir = process.env.XDG_CONFIG_HOME || (0, import_node_path36.join)((0, import_node_os13.homedir)(), ".config");
+  const configDir = process.env.XDG_CONFIG_HOME || (0, import_node_path36.join)((0, import_node_os14.homedir)(), ".config");
   return (0, import_node_path36.join)(configDir, "agent-relay", "trajectories", projectHash);
 }
 function getRepoTrajectoriesDir(projectRoot) {