@hermespilot/link 0.8.2 → 0.8.4

package/dist/{chunk-SQ2VMFNE.js → chunk-VVHNBT4E.js}

@@ -5,7 +5,7 @@ import Router from "@koa/router";
 // src/conversations/conversation-service.ts
 import { EventEmitter } from "events";
 import { createHash as createHash9, randomUUID as randomUUID13 } from "crypto";
-import path27 from "path";
+import path28 from "path";
 
 // src/database/link-database.ts
 import { mkdir } from "fs/promises";
@@ -7632,7 +7632,7 @@ async function listCronOutputFiles(profileName, jobId) {
       orderTimeMs: fileStat.mtimeMs
     });
   }
-  return files.sort((left, right) => left.orderTimeMs - right.orderTimeMs).map(({ path: path38, mtime }) => ({ path: path38, mtime }));
+  return files.sort((left, right) => left.orderTimeMs - right.orderTimeMs).map(({ path: path39, mtime }) => ({ path: path39, mtime }));
 }
 function readCronOutputTimestamp(fileName) {
   const match = fileName.match(
@@ -7721,7 +7721,7 @@ function isConversationMissingError(error) {
 }
 
 // src/constants.ts
-var LINK_VERSION = "0.8.2";
+var LINK_VERSION = "0.8.4";
 var LINK_COMMAND = "hermeslink";
 var LINK_DEFAULT_PORT = 52379;
 var LINK_RUNTIME_DIR_NAME = ".hermeslink";
@@ -14803,6 +14803,8 @@ function toSummary(manifest, snapshot, profile) {
     id: manifest.id,
     title: manifest.title,
     title_source: manifest.title_source,
+    category: manifestHasCronSignal(manifest, snapshot) ? "cron" : "chat",
+    is_cron: manifestHasCronSignal(manifest, snapshot),
     workspace_id: manifest.workspace_id ?? null,
     created_at: manifest.created_at,
     updated_at: manifest.updated_at,
@@ -14823,6 +14825,34 @@ function toSummary(manifest, snapshot, profile) {
     } : null
   };
 }
+function manifestHasCronSignal(manifest, snapshot) {
+  const sessionIds = [
+    manifest.hermes_session_id,
+    ...manifest.hermes_session_ids ?? [],
+    manifest.hermes_lineage?.root_session_id,
+    manifest.hermes_lineage?.current_session_id,
+    ...manifest.hermes_lineage?.session_ids ?? []
+  ].map((value) => value?.trim()).filter((value) => Boolean(value));
+  if (sessionIds.some((sessionId) => sessionId.startsWith("cron_"))) {
+    return true;
+  }
+  if (snapshot?.messages.some((message) => {
+    const raw = message.raw;
+    if (raw && typeof raw === "object" && !Array.isArray(raw)) {
+      const format = raw.format;
+      if (format === "hermes-link-cron-delivery") {
+        return true;
+      }
+    }
+    return Boolean(message.hermes?.cron_job_id || message.hermes?.cron_output_path);
+  })) {
+    return true;
+  }
+  return normalizeTitle(manifest.title) === "HermesLink \u5B9A\u65F6\u4EFB\u52A1";
+}
+function normalizeTitle(value) {
+  return value.trim();
+}
 function isDefaultConversationTitle(title) {
   const normalized = title.trim().toLowerCase();
   return !normalized || normalized === "untitled" || normalized === "new chat" || normalized === DEFAULT_CONVERSATION_TITLE.toLowerCase();
@@ -19735,14 +19765,16 @@ var ConversationQueryCoordinator = class {
         status,
         limit,
         cursor,
-        workspace: options.workspace
+        workspace: options.workspace,
+        category: options.category
       }),
       listPage: (pageCursor) => listConversationStatsPage(this.deps.paths, {
         status,
         limit,
         cursor: pageCursor,
         workspace: options.workspace
-      })
+      }),
+      category: options.category
     });
   }
   async searchConversationPage(options = {}) {
@@ -19790,7 +19822,8 @@ var ConversationQueryCoordinator = class {
       usedIndex = true;
       const summaries = await this.summarizeIndexedConversations(
         input.status,
-        indexedPage.records
+        indexedPage.records,
+        input.category
       );
       for (const summary of summaries) {
         if (!seenConversationIds.add(summary.id)) {
@@ -19830,15 +19863,18 @@ var ConversationQueryCoordinator = class {
       }
     };
   }
-  async listConversationsFromStore(status = "active", workspace) {
+  async listConversationsFromStore(status = "active", options = {}) {
     const summaries = [];
     for (const conversationId of await this.deps.store.listConversationIds()) {
       const manifest = await this.deps.store.readManifest(conversationId).catch(() => null);
-      if (!manifest || manifest.status !== status || !matchesWorkspaceFilter(manifest, workspace)) {
+      if (!manifest || manifest.status !== status || !matchesWorkspaceFilter(manifest, options.workspace)) {
         continue;
       }
       const snapshot = await this.deps.store.readSnapshot(conversationId).catch(() => emptySnapshot2());
       const refreshed = await this.deps.metadata.refreshTitleFromHermes(manifest, { snapshot }).catch(() => manifest);
+      if (!matchesConversationCategory(refreshed, snapshot, options.category)) {
+        continue;
+      }
       summaries.push(await this.summarizeConversation(refreshed, snapshot));
     }
     return summaries.sort(
@@ -19846,10 +19882,10 @@ var ConversationQueryCoordinator = class {
     );
   }
   async listConversationPageFromStore(input) {
-    const all = await this.listConversationsFromStore(
-      input.status,
-      input.workspace
-    );
+    const all = await this.listConversationsFromStore(input.status, {
+      workspace: input.workspace,
+      category: input.category
+    });
     const startIndex = input.cursor ? all.findIndex(
       (summary) => isAfterConversationListCursor(summary, input.cursor)
     ) : 0;
@@ -19868,7 +19904,7 @@ var ConversationQueryCoordinator = class {
       }
     };
   }
-  async summarizeIndexedConversations(status, records) {
+  async summarizeIndexedConversations(status, records, category = "all") {
     const summaries = [];
     for (const record of records) {
       const manifest = await this.deps.store.readManifest(record.conversationId).catch(() => null);
@@ -19877,6 +19913,9 @@ var ConversationQueryCoordinator = class {
       }
       const snapshot = await this.deps.store.readSnapshot(record.conversationId).catch(() => emptySnapshot2());
       const refreshed = await this.deps.metadata.refreshTitleFromHermes(manifest, { snapshot }).catch(() => manifest);
+      if (!matchesConversationCategory(refreshed, snapshot, category)) {
+        continue;
+      }
       summaries.push(await this.summarizeConversation(refreshed, snapshot));
     }
     return summaries;
@@ -20145,6 +20184,13 @@ function matchesWorkspaceFilter(manifest, filter) {
   }
   return workspaceId === filter.workspaceId;
 }
+function matchesConversationCategory(manifest, snapshot, category = "all") {
+  if (category === "all") {
+    return true;
+  }
+  const isCron = manifestHasCronSignal(manifest, snapshot);
+  return category === "cron" ? isCron : !isCron;
+}
 function isAfterConversationListCursor(summary, cursor) {
   return summary.updated_at < cursor.updatedAt || summary.updated_at === cursor.updatedAt && summary.id < cursor.conversationId;
 }
@@ -21380,6 +21426,7 @@ var MESSAGE_COLUMNS = [
   "reasoning_details",
   "codex_reasoning_items"
 ];
+var HERMES_ROW_SESSION_POSITION = /* @__PURE__ */ Symbol("hermesRowSessionPosition");
 async function syncHermesSessionsIntoConversations(paths, logger, options = {}) {
   const maxImports = options.maxImports ?? MAX_IMPORTABLE_SESSIONS;
   const store = new ConversationStore(paths);
@@ -21391,6 +21438,7 @@ async function syncHermesSessionsIntoConversations(paths, logger, options = {})
     eligible_sessions: 0,
     imported_count: 0,
     reprojected_count: 0,
+    hermes_archived_count: 0,
     skipped_existing: 0,
     skipped_hidden: 0,
     skipped_empty_transcript: 0,
@@ -21416,6 +21464,21 @@ async function syncHermesSessionsIntoConversations(paths, logger, options = {})
         continue;
       }
       if (isHiddenSession(session)) {
+        if (isArchivedSession(session)) {
+          const candidate = { profileName, profileDir, dbPath, session };
+          result.hermes_archived_count += await archiveKnownHermesConversation({
+            paths,
+            store,
+            knownHermesSessions,
+            candidate
+          }).catch((error) => {
+            result.errors.push({
+              profile: profileName,
+              message: error instanceof Error ? error.message : String(error)
+            });
+            return 0;
+          });
+        }
         result.skipped_hidden += 1;
         continue;
       }
@@ -21501,7 +21564,7 @@ async function syncHermesSessionsIntoConversations(paths, logger, options = {})
       }
     }
   }
-  if (result.imported_count > 0 || result.reprojected_count > 0 || result.errors.length > 0) {
+  if (result.imported_count > 0 || result.reprojected_count > 0 || result.hermes_archived_count > 0 || result.errors.length > 0) {
     void logger.info("hermes_session_sync_completed", { ...result });
   } else {
     void logger.debug("hermes_session_sync_completed", { ...result });
@@ -21585,7 +21648,7 @@ async function syncHermesCronSessionIntoConversations(paths, logger, input) {
 async function syncHermesConversationMessages(paths, logger, input) {
   const store = input.store ?? new ConversationStore(paths);
   const manifest = await store.readActiveManifest(input.conversationId);
-  const snapshot = await store.readSnapshot(input.conversationId);
+  let snapshot = await store.readSnapshot(input.conversationId);
   const targets = collectHermesSessionDeleteTargets(manifest, snapshot);
   const result = {
     conversation_id: input.conversationId,
@@ -21597,8 +21660,15 @@ async function syncHermesConversationMessages(paths, logger, input) {
   if (targets.length === 0) {
     return result;
   }
+  const duplicateCleanup = pruneStrictImportedDuplicateMessages(paths, snapshot);
+  if (duplicateCleanup.removedCount > 0) {
+    snapshot = duplicateCleanup.snapshot;
+    result.removed_duplicate_count = duplicateCleanup.removedCount;
+    result.changed = true;
+  }
   const candidates = await collectConversationSyncCandidates(targets);
   const knownExactKeys = collectKnownHermesRowKeys(snapshot);
+  const representedRows = collectRepresentedHermesRows(paths, snapshot);
   const representedMessages = collectRepresentedMessageSignatures(snapshot);
   const projectedMessages = [];
   const candidateProfiles = /* @__PURE__ */ new Map();
@@ -21608,6 +21678,12 @@ async function syncHermesConversationMessages(paths, logger, input) {
       if (candidateMessages.length === 0) {
         continue;
       }
+      const missingCandidateMessages = candidateMessages.filter(
+        (message, index) => !isRepresentedHermesRow(representedRows, message, index)
+      );
+      if (missingCandidateMessages.length === 0) {
+        continue;
+      }
       const profile = await resolveConversationProfileTarget(
         paths,
         candidate.profileName
@@ -21624,7 +21700,7 @@ async function syncHermesConversationMessages(paths, logger, input) {
           profileUid: profile.profileUid,
           profileDisplayName: profile.profileDisplayName,
           sessionId: candidate.session.id,
-          messages: candidateMessages
+          messages: missingCandidateMessages
         })
       );
     } catch (error) {
@@ -21650,6 +21726,14 @@ async function syncHermesConversationMessages(paths, logger, input) {
     exactKeys.forEach((key) => knownExactKeys.add(key));
   }
   if (appendedMessages.length === 0) {
+    if (duplicateCleanup.removedCount > 0) {
+      await store.writeSnapshot(input.conversationId, snapshot);
+      const currentManifest = await store.readManifest(input.conversationId);
+      const stats2 = buildConversationStats(currentManifest, snapshot);
+      const nextManifest2 = { ...currentManifest, stats: stats2 };
+      await store.writeManifest(nextManifest2);
+      await upsertConversationStats(paths, toStatsIndexRecord(nextManifest2, stats2));
+    }
     return result;
   }
   await store.writeSnapshot(input.conversationId, {
@@ -21747,7 +21831,7 @@ async function importHermesSession(input) {
     id: conversationId,
     schema_version: 1,
     kind: "direct",
-    title: normalizeTitle(title),
+    title: normalizeTitle2(title),
     title_source: title ? "hermes" : "default",
     status: "active",
     hermes_session_id: sessionId,
@@ -22019,6 +22103,293 @@ function collectKnownHermesRowKeys(snapshot) {
   }
   return keys;
 }
+function collectRepresentedHermesRows(paths, snapshot) {
+  const rows = {
+    syntheticUserTexts: /* @__PURE__ */ new Set(),
+    toolCallIds: /* @__PURE__ */ new Set(),
+    runWindows: []
+  };
+  for (const run of snapshot.runs) {
+    collectRunHermesMessageWindows(run).forEach(
+      (window) => rows.runWindows.push(window)
+    );
+    const userMessage = snapshot.messages.find(
+      (message) => message.id === run.trigger_message_id
+    );
+    if (userMessage) {
+      collectSyntheticRunInputTexts(paths, userMessage).forEach(
+        (text) => rows.syntheticUserTexts.add(hashText(text))
+      );
+    }
+    const assistantMessage = snapshot.messages.find(
+      (message) => message.id === run.assistant_message_id
+    );
+    if (assistantMessage) {
+      collectAgentEventIds(assistantMessage).forEach(
+        (id) => rows.toolCallIds.add(id)
+      );
+    }
+  }
+  return rows;
+}
+function pruneStrictImportedDuplicateMessages(paths, snapshot) {
+  if (snapshot.runs.length === 0) {
+    return { snapshot, removedCount: 0 };
+  }
+  const messages2 = snapshot.messages.filter(
+    (message) => !isStrictImportedDuplicateRunMessage(paths, snapshot, message)
+  );
+  const removedCount = snapshot.messages.length - messages2.length;
+  return removedCount > 0 ? { snapshot: { ...snapshot, messages: messages2 }, removedCount } : { snapshot, removedCount: 0 };
+}
+function isStrictImportedDuplicateRunMessage(paths, snapshot, message) {
+  if (!isHermesImportedMessage2(message)) {
+    return false;
+  }
+  if (snapshot.runs.some(
+    (run) => run.trigger_message_id === message.id || run.assistant_message_id === message.id
+  )) {
+    return false;
+  }
+  const messageSessionIds = collectMessageHermesSessionIds(message);
+  if (messageSessionIds.size === 0) {
+    return false;
+  }
+  return snapshot.runs.some((run) => {
+    if (!runSessionMatchesMessage(run, messageSessionIds)) {
+      return false;
+    }
+    if (!isMessageInsideRunCleanupWindow(message, run)) {
+      return false;
+    }
+    if (message.role === "user") {
+      const user = snapshot.messages.find(
+        (item) => item.id === run.trigger_message_id
+      );
+      return user ? isDuplicateImportedRunUser(paths, user, message) : false;
+    }
+    if (message.role === "assistant" || message.role === "tool") {
+      const assistant = snapshot.messages.find(
+        (item) => item.id === run.assistant_message_id
+      );
+      return assistant ? isDuplicateImportedRunAssistant(assistant, message) : false;
+    }
+    return false;
+  });
+}
+function isDuplicateImportedRunUser(paths, user, imported) {
+  const importedText = normalizedDuplicateText(imported);
+  if (!importedText) {
+    return false;
+  }
+  if (importedText === normalizedDuplicateText(user)) {
+    return true;
+  }
+  return collectSyntheticRunInputTexts(paths, user).some(
+    (text) => normalizedDuplicateTextValue(text) === importedText
+  );
+}
+function isDuplicateImportedRunAssistant(assistant, imported) {
+  const importedText = normalizedDuplicateText(imported);
+  if (importedText && importedText === normalizedDuplicateText(assistant)) {
+    return true;
+  }
+  const importedToolIds = collectAgentEventIds(imported);
+  if (importedToolIds.size === 0) {
+    return false;
+  }
+  const assistantToolIds = collectAgentEventIds(assistant);
+  return [...importedToolIds].every((id) => assistantToolIds.has(id));
+}
+function collectMessageHermesSessionIds(message) {
+  const sessionIds = /* @__PURE__ */ new Set();
+  const hermes = toRecord12(message.hermes);
+  const sessionId = readString12(hermes, "session_id");
+  if (sessionId) {
+    sessionIds.add(sessionId);
+  }
+  for (const row of readHermesRawMessageRows(message.raw)) {
+    const rowSessionId = readString12(row, "session_id");
+    if (rowSessionId) {
+      sessionIds.add(rowSessionId);
+    }
+  }
+  return sessionIds;
+}
+function runSessionMatchesMessage(run, messageSessionIds) {
+  return collectRunHermesSessionIds(run).some(
+    (sessionId) => messageSessionIds.has(sessionId)
+  );
+}
+function collectRunHermesSessionIds(run) {
+  return normalizeSessionIds([
+    run.hermes_session_id,
+    run.hermes_message_watermark?.before?.session_id,
+    run.hermes_message_watermark?.after?.session_id
+  ]);
+}
+function isMessageInsideRunCleanupWindow(message, run) {
+  if (run.status === "queued" || run.status === "running" || run.status === "unknown") {
+    return false;
+  }
+  const messageAt = parseIsoMillis(message.created_at);
+  const startedAt = parseIsoMillis(run.started_at);
+  const completedAt = run.completed_at ? parseIsoMillis(run.completed_at) : void 0;
+  if (messageAt === void 0 || startedAt === void 0) {
+    return false;
+  }
+  const lowerBound = startedAt - 10 * 60 * 1e3;
+  const upperBound = (completedAt ?? startedAt) + 10 * 60 * 1e3;
+  return messageAt >= lowerBound && messageAt <= upperBound;
+}
+function normalizedDuplicateText(message) {
+  return normalizedDuplicateTextValue(messageText2(message));
+}
+function normalizedDuplicateTextValue(value) {
+  return value.replace(/\r\n/gu, "\n").trim();
+}
+function collectRunHermesMessageWindows(run) {
+  const before = normalizeWatermarkPoint(
+    run.hermes_message_watermark?.before,
+    run.hermes_session_id
+  );
+  if (!before) {
+    return [];
+  }
+  const after = normalizeWatermarkPoint(
+    run.hermes_message_watermark?.after,
+    run.hermes_session_id
+  );
+  const sessionId = before.session_id?.trim() || run.hermes_session_id?.trim();
+  if (!sessionId) {
+    return [];
+  }
+  return [
+    {
+      runId: run.id,
+      sessionId,
+      status: run.status,
+      before,
+      ...after && (after.session_id ?? sessionId) === sessionId ? { after } : {},
+      startedAtMs: parseIsoMillis(run.started_at),
+      completedAtMs: run.completed_at ? parseIsoMillis(run.completed_at) : void 0
+    }
+  ];
+}
+function normalizeWatermarkPoint(point, fallbackSessionId) {
+  if (!point || typeof point.message_count !== "number" || !Number.isFinite(point.message_count)) {
+    return null;
+  }
+  const sessionId = point.session_id?.trim() || fallbackSessionId?.trim();
+  return {
+    source: point.source,
+    ...sessionId ? { session_id: sessionId } : {},
+    message_count: Math.max(0, Math.trunc(point.message_count)),
+    ...typeof point.max_message_id === "number" && Number.isFinite(point.max_message_id) ? { max_message_id: point.max_message_id } : {},
+    ...typeof point.max_timestamp === "number" && Number.isFinite(point.max_timestamp) ? { max_timestamp: point.max_timestamp } : {},
+    captured_at: point.captured_at
+  };
+}
+function collectSyntheticRunInputTexts(paths, message) {
+  if (message.role !== "user") {
+    return [];
+  }
+  const attachmentLines = message.parts.filter((part) => Boolean(part.blob)).filter((part) => !isVoicePart(part)).map((part) => {
+    const label = part.filename ?? part.blob;
+    const mime = part.mime ? `, ${part.mime}` : "";
+    const size = part.size ? `, ${part.size} bytes` : "";
+    return `- ${label}${mime}${size}: ${part.local_path ?? blobPath(paths, part.blob)}`;
+  });
+  if (attachmentLines.length === 0) {
+    return [];
+  }
+  const content = messageText2(message);
+  const prefix = content ? `${content}
+
+` : "";
+  return [
+    `${prefix}Attachments available on this computer:
+${attachmentLines.join("\n")}`
+  ];
+}
+function collectAgentEventIds(message) {
+  const ids = /* @__PURE__ */ new Set();
+  for (const event of message.agent_events ?? []) {
+    if (event.id) {
+      ids.add(event.id);
+    }
+  }
+  for (const block of message.blocks ?? []) {
+    if (block.type !== "agent_events") {
+      continue;
+    }
+    for (const event of block.events) {
+      if (event.id) {
+        ids.add(event.id);
+      }
+    }
+  }
+  return ids;
+}
+function isRepresentedHermesRow(represented, row, index) {
+  const role = normalizeMessageRole(row.role);
+  if (represented.runWindows.some(
+    (window) => isRowInsideRunWindow(window, row, role)
+  )) {
+    return true;
+  }
+  if (role === "user" && represented.syntheticUserTexts.has(hashText(normalizeContent2(row.content)))) {
+    return true;
+  }
+  if (role === "assistant") {
+    const toolCalls = readHermesToolCalls(row);
+    return toolCalls.length > 0 && toolCalls.every(
+      (toolCall) => toolCall.id && represented.toolCallIds.has(toolCall.id)
+    );
+  }
+  if (role === "tool") {
+    const id = readString12(row, "tool_call_id") ?? readString12(row, "tool_id") ?? readString12(row, "call_id");
+    if (id) {
+      return represented.toolCallIds.has(id);
+    }
+    const key = hermesRowKey(row, index);
+    return represented.toolCallIds.has(key);
+  }
+  return false;
+}
+function isRowInsideRunWindow(window, row, role) {
+  if (role === "system") {
+    return false;
+  }
+  if ((readString12(row, "session_id") ?? "") !== window.sessionId) {
+    return false;
+  }
+  const hasClosedAfter = Boolean(window.after);
+  const allowOpenEnded = window.status === "running";
+  const allowTerminalGrace = !hasClosedAfter && (window.status === "cancelled" || window.status === "failed") && window.completedAtMs !== void 0;
+  if (!hasClosedAfter && !allowOpenEnded && !allowTerminalGrace) {
+    return false;
+  }
+  const position = rowSessionPosition(row);
+  if (window.before.source !== "none" && position !== void 0 && position > window.before.message_count && (window.after ? position <= window.after.message_count : allowOpenEnded)) {
+    return true;
+  }
+  const rowId = readNumber3(row.id);
+  if (rowId !== null && window.before.max_message_id !== void 0 && rowId > window.before.max_message_id && (window.after?.max_message_id !== void 0 ? rowId <= window.after.max_message_id : allowOpenEnded)) {
+    return true;
+  }
+  const rowTimeMs = hermesTimestampMillis(row.timestamp);
+  if (rowTimeMs === void 0) {
+    return false;
+  }
+  const beforeTimeMs = hermesTimestampMillis(window.before.max_timestamp);
+  const lowerTimeMs = beforeTimeMs ?? (window.startedAtMs ?? 0) - 5e3;
+  const upperTimeMs = hermesTimestampMillis(window.after?.max_timestamp) ?? (allowTerminalGrace && window.completedAtMs !== void 0 ? window.completedAtMs + 2 * 60 * 1e3 : allowOpenEnded ? Number.POSITIVE_INFINITY : void 0);
+  return upperTimeMs !== void 0 && (beforeTimeMs !== void 0 ? rowTimeMs > lowerTimeMs : rowTimeMs >= lowerTimeMs) && rowTimeMs <= upperTimeMs;
+}
+function isVoicePart(part) {
+  return part.kind === "voice" || part.is_voice_note === true;
+}
 function collectMessageHermesRowKeys(message) {
   const keys = [];
   readHermesRawMessageRows(message.raw).forEach((row, index) => {
@@ -22072,6 +22443,21 @@ function representedMessageSignature(message) {
 function hashText(value) {
   return createHash6("sha256").update(value).digest("hex");
 }
+function rowSessionPosition(row) {
+  const position = row[HERMES_ROW_SESSION_POSITION];
+  return typeof position === "number" && Number.isFinite(position) ? position : void 0;
+}
+function hermesTimestampMillis(value) {
+  const numeric = readNumber3(value);
+  if (numeric === null || numeric <= 0) {
+    return void 0;
+  }
+  return numeric > 1e10 ? numeric : numeric * 1e3;
+}
+function parseIsoMillis(value) {
+  const parsed = Date.parse(value);
+  return Number.isFinite(parsed) ? parsed : void 0;
+}
 function compareLinkMessagesByCreatedAt(left, right) {
   return Date.parse(left.created_at) - Date.parse(right.created_at) || left.id.localeCompare(right.id);
 }
@@ -22165,6 +22551,59 @@ async function readExistingHermesConversations(store, conversationIds) {
   }
   return conversations;
 }
+async function archiveKnownHermesConversation(input) {
+  const conversationIds = findKnownConversationIdsForCandidate(
+    input.knownHermesSessions,
+    input.candidate
+  );
+  if (conversationIds.length === 0) {
+    return 0;
+  }
+  const archivedAt = readString12(input.candidate.session, "archived_at") ?? (/* @__PURE__ */ new Date()).toISOString();
+  let archivedCount = 0;
+  for (const conversation of await readExistingHermesConversations(
+    input.store,
+    conversationIds
+  )) {
+    if (conversation.manifest.status !== "active") {
+      continue;
+    }
+    const nextManifest = {
+      ...conversation.manifest,
+      status: "archived",
+      updated_at: archivedAt,
+      archived_at: archivedAt,
+      hermes_session_ids: normalizeSessionIds([
+        conversation.manifest.hermes_session_id,
+        ...conversation.manifest.hermes_session_ids ?? [],
+        ...conversation.manifest.hermes_lineage?.session_ids ?? [],
+        ...lineageSessionIds(input.candidate)
+      ]),
+      ...lineageManifestPatch(input.candidate)
+    };
+    const stats = buildConversationStats(nextManifest, conversation.snapshot);
+    const archivedManifest = { ...nextManifest, stats };
+    await input.store.writeManifest(archivedManifest);
+    await input.store.appendEvent(conversation.conversationId, {
+      type: "conversation.archived",
+      payload: {
+        archived_at: archivedAt,
+        source: "hermes",
+        hermes_session_id: input.candidate.session.id
+      }
+    });
+    const eventManifest = await input.store.readManifest(conversation.conversationId);
+    const eventStats = buildConversationStats(eventManifest, conversation.snapshot);
+    const indexedManifest = { ...eventManifest, stats: eventStats };
+    await input.store.writeManifest(indexedManifest);
+    await upsertConversationStats(
+      input.paths,
+      toStatsIndexRecord(indexedManifest, eventStats)
+    );
+    archivedCount += 1;
+  }
+  return archivedCount;
+}
 function selectCanonicalHermesConversation(conversations) {
   const ranked = [...conversations].sort((left, right) => {
     const rightScore = canonicalConversationScore(right);
@@ -22277,7 +22716,7 @@ function mergeHermesLineageIntoManifest(input) {
   };
   const title = deriveHermesConversationTitle(input.candidate, input.snapshot);
   if (title && canSyncHermesTitle(input.manifest)) {
-    nextBase.title = normalizeTitle(title);
+    nextBase.title = normalizeTitle2(title);
     nextBase.title_source = "hermes";
   }
   const baseStats = buildConversationStats(nextBase, input.snapshot);
@@ -23066,9 +23505,15 @@ async function readHermesSessionMessages(candidate) {
     readJsonlMessages(candidate.profileName, candidate.session.id)
   ]);
   const selected = jsonlMessages.length > dbMessages.length ? jsonlMessages : dbMessages;
-  return selected.map(
-    (message) => readString12(message, "session_id") ? message : { ...message, session_id: candidate.session.id }
-  );
+  return selected.map((message, index) => {
+    const normalized = readString12(message, "session_id") ? message : { ...message, session_id: candidate.session.id };
+    Object.defineProperty(normalized, HERMES_ROW_SESSION_POSITION, {
+      value: index + 1,
+      enumerable: false,
+      configurable: true
+    });
+    return normalized;
+  });
 }
 async function readStateDbMessages(dbPath, sessionId) {
   if (!await isFile(dbPath)) {
@@ -23310,7 +23755,7 @@ function senderForRole(input) {
 function firstUserText(snapshot) {
   return snapshot.messages.find((message) => message.role === "user")?.parts.find((part) => part.type === "text")?.text?.slice(0, 80);
 }
-function normalizeTitle(value) {
+function normalizeTitle2(value) {
   const normalized = value?.replace(/\s+/gu, " ").trim();
   return normalized || DEFAULT_CONVERSATION_TITLE;
 }
@@ -23423,6 +23868,10 @@ function isHiddenSession(session) {
   const visibility = readString12(session, "visibility")?.toLowerCase();
   return Boolean(source && HIDDEN_SESSION_SOURCES.has(source)) || readBoolean2(session.hidden) || readBoolean2(session.archived) || Boolean(readString12(session, "archived_at")) || status === "hidden" || status === "archived" || visibility === "hidden" || visibility === "hide";
 }
+function isArchivedSession(session) {
+  const status = readString12(session, "status")?.toLowerCase();
+  return readBoolean2(session.archived) || Boolean(readString12(session, "archived_at")) || status === "archived";
+}
 function readTableColumns2(db, tableName) {
   try {
     const rows = db.prepare(`PRAGMA table_info(${quoteIdentifier(tableName)})`).all();
@@ -24181,10 +24630,10 @@ function parseHermesApiCapabilities(payload) {
     sessionKeyHeader: readString14(features, "session_key_header")
   };
 }
-async function callHermesApi(path38, init, options) {
+async function callHermesApi(path39, init, options) {
   const method = init.method ?? "GET";
   const startedAt = Date.now();
-  void options.logger?.debug("hermes_api_request_started", { method, path: path38 });
+  void options.logger?.debug("hermes_api_request_started", { method, path: path39 });
   const availability = await ensureHermesApiServerAvailable({
     fetchImpl: options.fetchImpl,
     logger: options.logger,
@@ -24193,7 +24642,7 @@ async function callHermesApi(path38, init, options) {
   });
   let config = availability.configResult.apiServer;
   const fetcher = options.fetchImpl ?? fetch;
-  const request = () => fetchHermesApi(fetcher, config, path38, init, options);
+  const request = () => fetchHermesApi(fetcher, config, path39, init, options);
   let response;
   try {
     response = await request();
@@ -24201,7 +24650,7 @@ async function callHermesApi(path38, init, options) {
     logHermesApiError(
       options.logger,
       method,
-      path38,
+      path39,
       options.profileName,
       startedAt,
       error
@@ -24212,7 +24661,7 @@ async function callHermesApi(path38, init, options) {
     logHermesApiResponse(
       options.logger,
       method,
-      path38,
+      path39,
       options.profileName,
       startedAt,
       response
@@ -24221,7 +24670,7 @@ async function callHermesApi(path38, init, options) {
   }
   void options.logger?.warn("hermes_api_request_retrying_after_401", {
     method,
-    path: path38,
+    path: path39,
     profile: options.profileName ?? "default",
     port: config.port ?? null,
     duration_ms: Date.now() - startedAt
@@ -24240,7 +24689,7 @@ async function callHermesApi(path38, init, options) {
     logHermesApiError(
       options.logger,
       method,
-      path38,
+      path39,
       options.profileName,
       startedAt,
       error
@@ -24250,7 +24699,7 @@ async function callHermesApi(path38, init, options) {
   logHermesApiResponse(
     options.logger,
     method,
-    path38,
+    path39,
     options.profileName,
     startedAt,
     response
@@ -24260,7 +24709,7 @@ async function callHermesApi(path38, init, options) {
   }
   void options.logger?.warn("hermes_api_request_repairing_after_401", {
     method,
-    path: path38,
+    path: path39,
     profile: options.profileName ?? "default",
     port: config.port ?? null,
     duration_ms: Date.now() - startedAt
@@ -24281,7 +24730,7 @@ async function callHermesApi(path38, init, options) {
     logHermesApiError(
       options.logger,
       method,
-      path38,
+      path39,
       options.profileName,
       startedAt,
       error
@@ -24291,21 +24740,21 @@ async function callHermesApi(path38, init, options) {
   logHermesApiResponse(
     options.logger,
     method,
-    path38,
+    path39,
     options.profileName,
     startedAt,
     response
   );
   return response;
 }
-async function fetchHermesApi(fetcher, config, path38, init, options) {
+async function fetchHermesApi(fetcher, config, path39, init, options) {
   const headers = new Headers(init.headers);
   headers.set("accept", headers.get("accept") ?? "application/json");
   if (config.key) {
     headers.set("x-api-key", config.key);
     headers.set("authorization", `Bearer ${config.key}`);
   }
-  return await fetcher(`http://127.0.0.1:${config.port}${path38}`, {
+  return await fetcher(`http://127.0.0.1:${config.port}${path39}`, {
     ...init,
     headers
   }).catch((error) => {
@@ -24314,10 +24763,10 @@ async function fetchHermesApi(fetcher, config, path38, init, options) {
     }
     void options.logger?.warn("hermes_api_server_connect_failed", {
       method: String(init.method ?? "GET").toUpperCase(),
-      path: path38,
+      path: path39,
       profile: options.profileName ?? "default",
       port: config.port ?? null,
-      url: `http://127.0.0.1:${config.port}${path38}`,
+      url: `http://127.0.0.1:${config.port}${path39}`,
       error: error instanceof Error ? error.message : String(error)
     });
     throw new LinkHttpError(
@@ -24327,10 +24776,10 @@ async function fetchHermesApi(fetcher, config, path38, init, options) {
     );
   });
 }
-function logHermesApiResponse(logger, method, path38, profileName, startedAt, response) {
+function logHermesApiResponse(logger, method, path39, profileName, startedAt, response) {
   const fields = {
     method,
-    path: path38,
+    path: path39,
     profile: profileName ?? "default",
     status: response.status,
     duration_ms: Date.now() - startedAt
@@ -24351,10 +24800,10 @@ async function logHermesApiFailureResponse(logger, fields, response) {
     ...upstreamError ? { upstream_error: upstreamError } : {}
   });
 }
-function logHermesApiError(logger, method, path38, profileName, startedAt, error) {
+function logHermesApiError(logger, method, path39, profileName, startedAt, error) {
   void logger?.warn("hermes_api_request_failed", {
     method,
-    path: path38,
+    path: path39,
     profile: profileName ?? "default",
     duration_ms: Date.now() - startedAt,
     ...error instanceof LinkHttpError ? { status: error.status, code: error.code } : {},
@@ -26790,6 +27239,127 @@ function isNodeError17(error, code) {
   return typeof error === "object" && error !== null && "code" in error && error.code === code;
 }
 
+// src/conversations/hermes-message-watermark.ts
+import { stat as stat18, readFile as readFile16 } from "fs/promises";
+import path27 from "path";
+async function readHermesMessageWatermark(input) {
+  const profileName = input.profileName?.trim() || "default";
+  const sessionId = input.sessionId.trim();
+  const profileDir = resolveHermesProfileDir(profileName);
+  const dbPath = path27.join(profileDir, "state.db");
+  const [dbWatermark, jsonlWatermark] = await Promise.all([
+    readStateDbMessageWatermark(dbPath, sessionId),
+    readJsonlMessageWatermark(profileName, sessionId)
+  ]);
+  const selected = (jsonlWatermark.message_count ?? 0) > (dbWatermark.message_count ?? 0) ? jsonlWatermark : dbWatermark;
+  return {
+    ...selected,
+    session_id: sessionId,
+    captured_at: (/* @__PURE__ */ new Date()).toISOString()
+  };
+}
+async function readStateDbMessageWatermark(dbPath, sessionId) {
+  if (!await isFile3(dbPath)) {
+    return { source: "none", message_count: 0 };
+  }
+  let db = null;
+  try {
+    db = openSqliteDatabase(dbPath, {
+      readonly: true,
+      timeout: 1e3
+    });
+    const columns = readTableColumns4(db, "messages");
+    if (!columns.has("session_id")) {
+      return { source: "none", message_count: 0 };
+    }
+    const idExpression = columns.has("id") ? "MAX(CASE WHEN typeof(id) IN ('integer', 'real') THEN id ELSE NULL END) AS max_message_id" : "NULL AS max_message_id";
+    const timestampExpression = columns.has("timestamp") ? "MAX(timestamp) AS max_timestamp" : "NULL AS max_timestamp";
+    const row = db.prepare(
+      `
+        SELECT COUNT(*) AS message_count, ${idExpression}, ${timestampExpression}
+        FROM messages
+        WHERE session_id = ?
+      `
+    ).get(sessionId);
+    return {
+      source: "state_db",
+      message_count: readNumber5(row.message_count) ?? 0,
+      ...readNumber5(row.max_message_id) !== null ? { max_message_id: readNumber5(row.max_message_id) } : {},
+      ...readNumber5(row.max_timestamp) !== null ? { max_timestamp: readNumber5(row.max_timestamp) } : {}
+    };
+  } catch {
+    return { source: "none", message_count: 0 };
+  } finally {
+    db?.close();
+  }
+}
+async function readJsonlMessageWatermark(profileName, sessionId) {
+  if (!/^[A-Za-z0-9._:-]{1,160}$/u.test(sessionId)) {
+    return { source: "none", message_count: 0 };
+  }
+  const profileDir = resolveHermesProfileDir(profileName);
+  const sessionsDir = await readHermesSessionsDir(profileName).then((value) => value.sessionsDir).catch(() => path27.join(profileDir, "sessions"));
+  const transcriptPath = path27.join(sessionsDir, `${sessionId}.jsonl`);
+  const raw = await readFile16(transcriptPath, "utf8").catch(() => "");
+  if (!raw.trim()) {
+    return { source: "none", message_count: 0 };
+  }
+  let messageCount = 0;
+  let maxMessageId;
+  let maxTimestamp;
+  for (const line of raw.split(/\r?\n/u)) {
+    if (!line.trim()) {
+      continue;
+    }
+    try {
+      const parsed = JSON.parse(line);
+      if (!readString18(parsed, "role")) {
+        continue;
+      }
+      messageCount += 1;
+      const id = readNumber5(parsed.id);
+      const timestamp = readNumber5(parsed.timestamp) ?? readNumber5(parsed.created_at) ?? readNumber5(parsed.createdAt);
+      if (id !== null) {
+        maxMessageId = maxMessageId === void 0 ? id : Math.max(maxMessageId, id);
+      }
+      if (timestamp !== null) {
+        maxTimestamp = maxTimestamp === void 0 ? timestamp : Math.max(maxTimestamp, timestamp);
+      }
+    } catch {
+      continue;
+    }
+  }
+  return {
+    source: messageCount > 0 ? "jsonl" : "none",
+    message_count: messageCount,
+    ...maxMessageId !== void 0 ? { max_message_id: maxMessageId } : {},
+    ...maxTimestamp !== void 0 ? { max_timestamp: maxTimestamp } : {}
+  };
+}
+function readTableColumns4(db, tableName) {
+  try {
+    const rows = db.prepare(`PRAGMA table_info(${quoteIdentifier3(tableName)})`).all();
+    return new Set(
+      rows.map((row) => typeof row.name === "string" ? row.name : "").filter(Boolean)
+    );
+  } catch {
+    return /* @__PURE__ */ new Set();
+  }
+}
+function quoteIdentifier3(value) {
+  return `"${value.replaceAll('"', '""')}"`;
+}
+async function isFile3(filePath) {
+  return stat18(filePath).then((value) => value.isFile()).catch(() => false);
+}
+function readString18(payload, key) {
+  const value = payload[key];
+  return typeof value === "string" && value.trim() ? value.trim() : null;
+}
+function readNumber5(value) {
+  return typeof value === "number" && Number.isFinite(value) ? value : null;
+}
+
 // src/conversations/run-tool-event-ids.ts
 import { createHash as createHash7 } from "crypto";
 var RunToolEventIdCoalescer = class {
@@ -26883,7 +27453,7 @@ var RunToolEventIdCoalescer = class {
   }
 };
 function readToolEventType(event) {
-  const type = readString18(event.payload, "type") ?? readString18(event.payload, "event") ?? event.payloadType;
+  const type = readString19(event.payload, "type") ?? readString19(event.payload, "event") ?? event.payloadType;
   return type.startsWith("tool.") ? type : null;
 }
 function isTerminalToolEvent(type) {
@@ -26894,14 +27464,14 @@ function hasStableToolEventId(payload) {
   const call = toRecord17(payload.tool_call ?? payload.toolCall);
   const fn = toRecord17(call.function ?? payload.function);
   return Boolean(
-    readString18(payload, "tool_call_id") ?? readString18(payload, "toolCallId") ?? readString18(payload, "tool_id") ?? readString18(payload, "call_id") ?? readString18(payload, "id") ?? readString18(tool, "id") ?? readString18(call, "id") ?? readString18(fn, "id")
+    readString19(payload, "tool_call_id") ?? readString19(payload, "toolCallId") ?? readString19(payload, "tool_id") ?? readString19(payload, "call_id") ?? readString19(payload, "id") ?? readString19(tool, "id") ?? readString19(call, "id") ?? readString19(fn, "id")
   );
 }
 function readToolName2(payload) {
   const tool = toRecord17(payload.tool);
   const call = toRecord17(payload.tool_call ?? payload.toolCall);
   const fn = toRecord17(call.function ?? payload.function);
-  return readString18(payload, "tool_name") ?? readString18(payload, "toolName") ?? readString18(payload, "name") ?? readString18(payload, "tool") ?? readString18(tool, "name") ?? readString18(call, "name") ?? readString18(fn, "name") ?? "tool";
+  return readString19(payload, "tool_name") ?? readString19(payload, "toolName") ?? readString19(payload, "name") ?? readString19(payload, "tool") ?? readString19(tool, "name") ?? readString19(call, "name") ?? readString19(fn, "name") ?? "tool";
 }
 function withGeneratedToolEventId(event, id) {
   return {
@@ -26958,7 +27528,7 @@ function stableStringify2(value) {
 function hashStableValue(value) {
   return createHash7("sha256").update(value).digest("hex").slice(0, 16);
 }
-function readString18(payload, key) {
+function readString19(payload, key) {
   const value = payload[key];
   return typeof value === "string" && value.trim() ? value.trim() : null;
 }
@@ -26990,8 +27560,8 @@ function normalizeHermesStreamEvent(event) {
     };
   }
   if (event.eventName === "hermes.tool.progress") {
-    const toolName = readString19(event.payload, "tool") ?? readString19(event.payload, "name") ?? "tool";
-    const preview = readString19(event.payload, "label") ?? readString19(event.payload, "preview") ?? toolName;
+    const toolName = readString20(event.payload, "tool") ?? readString20(event.payload, "name") ?? "tool";
+    const preview = readString20(event.payload, "label") ?? readString20(event.payload, "preview") ?? toolName;
     return {
       ...event,
       payloadType: "tool.started",
@@ -27043,7 +27613,7 @@ function normalizeReasoningEvent(event) {
   if (type !== "tool.progress" && event.eventName !== "hermes.tool.progress") {
     return null;
   }
-  const toolName = readString19(event.payload, "tool_name") ?? readString19(event.payload, "tool") ?? readString19(event.payload, "name");
+  const toolName = readString20(event.payload, "tool_name") ?? readString20(event.payload, "tool") ?? readString20(event.payload, "name");
   if (toolName !== "_thinking") {
     return null;
   }
@@ -27094,7 +27664,7 @@ function normalizeHermesResponseEvent(event) {
 }
 function normalizeResponseCreated(event) {
   const response = toRecord18(event.payload.response ?? event.payload);
-  const responseId = readString19(response, "id") ?? readString19(event.payload, "id");
+  const responseId = readString20(response, "id") ?? readString20(event.payload, "id");
   return responseId ? {
     ...event,
     payloadType: "response.created",
@@ -27107,10 +27677,10 @@ function normalizeResponseCreated(event) {
 }
 function normalizeResponseOutputItemAdded(event) {
   const item = toRecord18(event.payload.item);
-  if (readString19(item, "type") !== "function_call") {
+  if (readString20(item, "type") !== "function_call") {
     return null;
   }
-  const toolName = readString19(item, "name") ?? "tool";
+  const toolName = readString20(item, "name") ?? "tool";
   const argumentsValue = parseJsonValue3(item.arguments) ?? item.arguments;
   return {
     ...event,
@@ -27120,16 +27690,16 @@ function normalizeResponseOutputItemAdded(event) {
       tool: toolName,
       tool_name: toolName,
       name: toolName,
-      tool_call_id: readString19(item, "call_id") ?? readString19(item, "id"),
+      tool_call_id: readString20(item, "call_id") ?? readString20(item, "id"),
       arguments: argumentsValue,
       preview: toolName,
-      response_item_id: readString19(item, "id") ?? void 0
+      response_item_id: readString20(item, "id") ?? void 0
     }
   };
 }
 function normalizeResponseOutputItemDone(event) {
   const item = toRecord18(event.payload.item);
-  if (readString19(item, "type") === "message") {
+  if (readString20(item, "type") === "message") {
     const delta = extractResponseAssistantText({ output: [item] });
     return delta ? {
       ...event,
@@ -27137,7 +27707,7 @@ function normalizeResponseOutputItemDone(event) {
       payload: { type: "message.delta", delta }
     } : null;
   }
-  if (readString19(item, "type") !== "function_call_output") {
+  if (readString20(item, "type") !== "function_call_output") {
     return null;
   }
   const output = readResponseItemOutput(item.output);
@@ -27147,12 +27717,12 @@ function normalizeResponseOutputItemDone(event) {
     payloadType: "tool.completed",
     payload: {
       type: "tool.completed",
-      tool_call_id: readString19(item, "call_id") ?? readString19(item, "id"),
-      status: readString19(item, "status") ?? "completed",
+      tool_call_id: readString20(item, "call_id") ?? readString20(item, "id"),
+      status: readString20(item, "status") ?? "completed",
       output,
       content: output,
       result: parsedOutput ?? output,
-      response_item_id: readString19(item, "id") ?? void 0
+      response_item_id: readString20(item, "id") ?? void 0
     }
   };
 }
@@ -27163,7 +27733,7 @@ function normalizeResponseCompleted(event) {
     payloadType: "run.completed",
     payload: {
       type: "run.completed",
-      response_id: readString19(response, "id") ?? readString19(event.payload, "id"),
+      response_id: readString20(response, "id") ?? readString20(event.payload, "id"),
       usage: toRecord18(response.usage),
       response
     }
@@ -27177,9 +27747,9 @@ function normalizeResponseFailed(event) {
     payloadType: "run.failed",
     payload: {
       type: "run.failed",
-      response_id: readString19(response, "id") ?? readString19(event.payload, "id"),
+      response_id: readString20(response, "id") ?? readString20(event.payload, "id"),
       error: {
-        message: readString19(error, "message") ?? readString19(event.payload, "message") ?? "Hermes run failed"
+        message: readString20(error, "message") ?? readString20(event.payload, "message") ?? "Hermes run failed"
       },
       usage: toRecord18(response.usage),
       response
@@ -27206,7 +27776,7 @@ function readErrorMessage4(payload) {
     return payload.error.trim();
   }
   const error = toRecord18(payload.error);
-  return readString19(error, "message") ?? readString19(payload, "message");
+  return readString20(error, "message") ?? readString20(payload, "message");
 }
 function readDelta(payload) {
   return readText3(payload, "delta") ?? readText3(payload, "text") ?? readText3(payload, "content");
@@ -27253,7 +27823,7 @@ function readChatCompletionDelta(payload) {
 }
 function readChatCompletionFinishReason(payload) {
   const choice = readFirstChoice(payload);
-  return readString19(choice, "finish_reason") ?? readString19(choice, "finishReason");
+  return readString20(choice, "finish_reason") ?? readString20(choice, "finishReason");
 }
 function readChatCompletionUsage(payload) {
   const usage = toRecord18(payload.usage);
@@ -27293,7 +27863,7 @@ function readAssistantTextFromChoices(payload) {
     return null;
   }
   const messages2 = choices.map(toRecord18).map((choice) => toRecord18(choice.message ?? choice.delta)).filter((message) => {
-    const role = readString19(message, "role");
+    const role = readString20(message, "role");
     return !role || role === "assistant";
   }).map(readResponseMessageText).filter((text) => Boolean(text?.trim()));
   return messages2.length > 0 ? messages2.join("\n\n") : null;
@@ -27309,7 +27879,7 @@ function readInteger3(payload, key) {
   }
   return void 0;
 }
-function readString19(payload, key) {
+function readString20(payload, key) {
   const value = payload[key];
   return typeof value === "string" && value.trim() ? value.trim() : null;
 }
@@ -27322,8 +27892,8 @@ function readResponseOutputItemText(value) {
     return value;
   }
   const item = toRecord18(value);
-  const type = readString19(item, "type");
-  const role = readString19(item, "role");
+  const type = readString20(item, "type");
+  const role = readString20(item, "role");
   if (type && type !== "message" && type !== "output_text" && type !== "text") {
     return null;
   }
@@ -27349,7 +27919,7 @@ function readResponseContentText(value) {
       return partValue;
     }
     const part = toRecord18(partValue);
-    const type = readString19(part, "type");
+    const type = readString20(part, "type");
     if (type && !isVisibleResponseTextPart(type)) {
       return null;
     }
@@ -27658,6 +28228,11 @@ var ConversationRunLifecycle = class {
         run.profile ?? "default"
       );
       const reasoningEffort = reasoningEffortForRun(run);
+      await this.recordRunHermesMessageWatermark({
+        conversationId,
+        runId,
+        phase: "before"
+      });
       if (backend === "tui_gateway") {
         const rpcRun = await streamTuiGatewayRun({
           input: resolvedInput,
@@ -27873,13 +28448,7 @@ var ConversationRunLifecycle = class {
       }
     } catch (error) {
       if (controller.signal.aborted) {
-        await this.deps.withConversationLock(
-          conversationId,
-          () => this.cancelRunLocked(conversationId, runId, {
-            abortUpstream: false,
-            reason: "cancelled by app"
-          })
-        );
+        await this.cancelRunAfterAbort(conversationId, runId);
         return { shouldDrainQueue: true };
       }
       if (isTuiGatewaySessionBusyError(error)) {
@@ -28080,16 +28649,27 @@ var ConversationRunLifecycle = class {
     }
   }
   async cancelRun(conversationId, runId, options) {
-    return this.deps.withConversationLock(
+    const result = await this.deps.withConversationLock(
       conversationId,
       () => this.cancelRunLocked(conversationId, runId, options)
     );
+    await this.recordRunHermesMessageWatermark({
+      conversationId,
+      runId,
+      phase: "after"
+    });
+    return result;
   }
   async failRun(conversationId, runId, message, source) {
     await this.refreshRunHermesCompressionTip(conversationId, runId);
+    const afterWatermark = await this.readRunHermesMessageWatermark(
+      conversationId,
+      runId,
+      "after"
+    );
     return this.deps.withConversationLock(
       conversationId,
-      () => this.failRunLocked(conversationId, runId, message, source)
+      () => this.failRunLocked(conversationId, runId, message, source, afterWatermark)
     );
   }
   async findConversationIdForRun(runId) {
@@ -28530,6 +29110,11 @@ var ConversationRunLifecycle = class {
         reason: "cancelled by app"
       })
     );
+    await this.recordRunHermesMessageWatermark({
+      conversationId,
+      runId,
+      phase: "after"
+    });
   }
   async completeCancelledRun(conversationId, runId) {
     await this.deps.withConversationLock(
@@ -28539,6 +29124,11 @@ var ConversationRunLifecycle = class {
         reason: "cancelled by Hermes"
       })
     );
+    await this.recordRunHermesMessageWatermark({
+      conversationId,
+      runId,
+      phase: "after"
+    });
   }
   async recoverRunTerminalEvent(input) {
     const deadline = Date.now() + RUN_STATUS_RECOVERY_TIMEOUT_MS;
@@ -28721,14 +29311,14 @@ var ConversationRunLifecycle = class {
       (message) => message.id === input.run.trigger_message_id
     );
     const prefix = guidedInterruptInputPrefix(input.run);
-    if (!userMessage || !userMessage.parts.some(isVoicePart)) {
+    if (!userMessage || !userMessage.parts.some(isVoicePart2)) {
       return prefix ? `${prefix}
 
 ${input.fallbackInput}` : input.fallbackInput;
     }
     const content = messageText2(userMessage);
     const voiceLines = [];
-    for (const part of userMessage.parts.filter(isVoicePart)) {
+    for (const part of userMessage.parts.filter(isVoicePart2)) {
       const audioPath = part.local_path ?? (part.blob ? blobPath(this.deps.paths, part.blob) : "");
       const result = await transcribeAudioWithHermesProfile({
         audioPath,
@@ -28738,7 +29328,7 @@ ${input.fallbackInput}` : input.fallbackInput;
       const label = part.filename ?? part.blob ?? "voice message";
       voiceLines.push(`- ${label}: ${result.transcript}`);
     }
-    const attachmentLines = userMessage.parts.filter((part) => Boolean(part.blob)).filter((part) => !isVoicePart(part)).map((part) => {
+    const attachmentLines = userMessage.parts.filter((part) => Boolean(part.blob)).filter((part) => !isVoicePart2(part)).map((part) => {
       const label = part.filename ?? part.blob;
       const mime = part.mime ? `, ${part.mime}` : "";
       const size = part.size ? `, ${part.size} bytes` : "";
@@ -28824,6 +29414,47 @@ ${resolved}` : resolved;
     Object.assign(run, patch);
     await this.deps.writeSnapshot(conversationId, snapshot);
   }
+  async recordRunHermesMessageWatermark(input) {
+    const point = await this.readRunHermesMessageWatermark(
+      input.conversationId,
+      input.runId,
+      input.phase
+    );
+    if (!point) {
+      return;
+    }
+    await this.deps.withConversationLock(input.conversationId, async () => {
+      const snapshot = await this.deps.readSnapshot(input.conversationId);
+      const run = snapshot.runs.find((item) => item.id === input.runId);
+      if (!run) {
+        return;
+      }
+      applyRunHermesMessageWatermark(run, input.phase, point);
+      await this.deps.writeSnapshot(input.conversationId, snapshot);
+    });
+  }
+  async readRunHermesMessageWatermark(conversationId, runId, phase) {
+    const snapshot = await this.deps.readSnapshot(conversationId).catch(() => null);
+    const run = snapshot?.runs.find((item) => item.id === runId);
+    const sessionId = run?.hermes_session_id?.trim();
+    if (!run || !sessionId) {
+      return null;
+    }
+    return await readHermesMessageWatermark({
+      profileName: run.profile,
+      sessionId
+    }).catch((error) => {
+      void this.deps.logger.debug("hermes_message_watermark_read_failed", {
+        conversation_id: conversationId,
+        run_id: runId,
+        phase,
+        profile: run.profile ?? "default",
+        hermes_session_id: sessionId,
+        error: error instanceof Error ? error.message : String(error)
+      });
+      return null;
+    });
+  }
   async updateRunUsageFromEvent(conversationId, runId, event) {
     const usage = readUsage(event.payload);
     if (!usage) {
@@ -29217,10 +29848,10 @@ ${details.join("\n")}` : localizedEmptyHermesResponseMessage(language);
     return goalStatus;
   }
   async persistGoalStatusUpdate(conversationId, runId, event) {
-    if (readString20(event.payload, "kind") !== "goal") {
+    if (readString21(event.payload, "kind") !== "goal") {
       return null;
     }
-    const text = readString20(event.payload, "text") ?? readString20(event.payload, "message") ?? readString20(event.payload, "status") ?? "";
+    const text = readString21(event.payload, "text") ?? readString21(event.payload, "message") ?? readString21(event.payload, "status") ?? "";
     const manifest = await this.deps.readRunnableManifest(conversationId);
     const snapshot = await this.deps.readSnapshot(conversationId);
     const run = snapshot.runs.find((item) => item.id === runId);
@@ -29407,7 +30038,7 @@ ${details.join("\n")}` : localizedEmptyHermesResponseMessage(language);
     }
     const textPart = assistant.parts.find((part) => part.type === "text");
     const currentText = textPart?.text ?? "";
-    const pendingDeliveryText = readString20(
+    const pendingDeliveryText = readString21(
       toRecord19(assistant.hermes),
       "pending_media_delivery_text"
     );
@@ -29513,7 +30144,7 @@ ${details.join("\n")}` : localizedEmptyHermesResponseMessage(language);
   }
   reasoningDeltaSegmentId(event) {
     const payload = event.payload;
-    return readString20(payload, "segment_id") ?? readString20(payload, "segmentId") ?? readString20(payload, "id") ?? readString20(payload, "tool_call_id") ?? readString20(payload, "tool_id") ?? null;
+    return readString21(payload, "segment_id") ?? readString21(payload, "segmentId") ?? readString21(payload, "id") ?? readString21(payload, "tool_call_id") ?? readString21(payload, "tool_id") ?? null;
   }
   async runRequestsAppDelivery(conversationId, runId) {
     const snapshot = await this.deps.readSnapshot(conversationId).catch(() => null);
@@ -29525,9 +30156,14 @@ ${details.join("\n")}` : localizedEmptyHermesResponseMessage(language);
   }
   async completeRun(conversationId, runId, source) {
     await this.refreshRunHermesCompressionTip(conversationId, runId);
+    const afterWatermark = await this.readRunHermesMessageWatermark(
+      conversationId,
+      runId,
+      "after"
+    );
     return this.deps.withConversationLock(
       conversationId,
-      () => this.completeRunLocked(conversationId, runId, source)
+      () => this.completeRunLocked(conversationId, runId, source, afterWatermark)
     );
   }
   async refreshRunHermesCompressionTip(conversationId, runId) {
@@ -29564,7 +30200,7 @@ ${details.join("\n")}` : localizedEmptyHermesResponseMessage(language);
     await this.rememberRunHermesSessionId(conversationId, runId, compressionTip);
     return { previousSessionId, nextSessionId: compressionTip };
   }
-  async completeRunLocked(conversationId, runId, source) {
+  async completeRunLocked(conversationId, runId, source, afterWatermark) {
     let snapshot = await this.deps.readSnapshot(conversationId);
     let run = snapshot.runs.find((item) => item.id === runId);
     if (!run || run.status !== "running") {
@@ -29606,6 +30242,9 @@ ${details.join("\n")}` : localizedEmptyHermesResponseMessage(language);
     if (usage) {
       run.usage = mergeRunUsage(run.usage, usage);
     }
+    if (afterWatermark) {
+      applyRunHermesMessageWatermark(run, "after", afterWatermark);
+    }
     const probeEvent = shouldUseHermesUsageProbe(run.hermes_backend) ? await findHermesUsageProbeEventForRun({
       paths: this.deps.paths,
       profileName: run.profile,
@@ -29754,7 +30393,7 @@ ${details.join("\n")}` : localizedEmptyHermesResponseMessage(language);
     await this.deps.writeManifest(nextManifest);
     return goal;
   }
-  async failRunLocked(conversationId, runId, message, source) {
+  async failRunLocked(conversationId, runId, message, source, afterWatermark) {
     const snapshot = await this.deps.readSnapshot(conversationId).catch(() => null);
     if (!snapshot) {
       return;
@@ -29777,6 +30416,9 @@ ${details.join("\n")}` : localizedEmptyHermesResponseMessage(language);
     if (usage) {
       run.usage = mergeRunUsage(run.usage, usage);
     }
+    if (afterWatermark) {
+      applyRunHermesMessageWatermark(run, "after", afterWatermark);
+    }
     const assistant = snapshot.messages.find(
       (item) => item.id === run.assistant_message_id
     );
@@ -30140,7 +30782,7 @@ ${details.join("\n")}` : localizedEmptyHermesResponseMessage(language);
       includeDisabled: true
     });
     return new Set(
-      jobs.map((job) => readString20(job, "id") ?? readString20(job, "job_id")).filter((id) => Boolean(id))
+      jobs.map((job) => readString21(job, "id") ?? readString21(job, "job_id")).filter((id) => Boolean(id))
     );
   }
   async bindNewCronJobsCreatedByRun(input) {
@@ -30240,7 +30882,7 @@ async function readdirWithDirs(directory) {
     throw error;
   });
 }
-function readString20(payload, key) {
+function readString21(payload, key) {
   const value = payload[key];
   return typeof value === "string" && value.trim() ? value.trim() : null;
 }
@@ -30331,11 +30973,11 @@ function contextCompressionGeneration(message) {
   return typeof generation === "number" && Number.isFinite(generation) ? Math.max(0, Math.floor(generation)) : null;
 }
 function readPreviousSessionId(payload) {
-  return readString20(payload, "old_session_id") ?? readString20(payload, "oldSessionId") ?? readString20(payload, "previous_session_id") ?? readString20(payload, "previousSessionId");
+  return readString21(payload, "old_session_id") ?? readString21(payload, "oldSessionId") ?? readString21(payload, "previous_session_id") ?? readString21(payload, "previousSessionId");
 }
 function readNextSessionId(payload) {
   const info = toRecord19(payload.info);
-  return readString20(payload, "session_key") ?? readString20(payload, "sessionKey") ?? readString20(payload, "stored_session_id") ?? readString20(payload, "storedSessionId") ?? readString20(payload, "session_id") ?? readString20(payload, "sessionId") ?? readString20(info, "session_key") ?? readString20(info, "sessionKey");
+  return readString21(payload, "session_key") ?? readString21(payload, "sessionKey") ?? readString21(payload, "stored_session_id") ?? readString21(payload, "storedSessionId") ?? readString21(payload, "session_id") ?? readString21(payload, "sessionId") ?? readString21(info, "session_key") ?? readString21(info, "sessionKey");
 }
 function eventPayloadWithLanguage(payload, language) {
   return { ...payload, language };
@@ -30427,13 +31069,13 @@ function isFileSearchCompletion(payloadType, payload) {
   const toolCall = toRecord19(payload.tool_call ?? payload.toolCall);
   const fn = toRecord19(toolCall.function ?? payload.function);
   const candidates = [
-    readString20(payload, "tool_name"),
-    readString20(payload, "toolName"),
-    readString20(payload, "name"),
-    readString20(payload, "tool"),
-    readString20(tool, "name"),
-    readString20(toolCall, "name"),
-    readString20(fn, "name")
+    readString21(payload, "tool_name"),
+    readString21(payload, "toolName"),
+    readString21(payload, "name"),
+    readString21(payload, "tool"),
+    readString21(tool, "name"),
+    readString21(toolCall, "name"),
+    readString21(fn, "name")
   ].filter((value) => Boolean(value)).map(normalizeToolName);
   return candidates.some(
     (name) => [
@@ -30470,7 +31112,7 @@ function messageRequestsAppDelivery(text) {
   const hasEnglishDeliveryAction = /\b(send|share|attach|deliver|display)\b/u.test(lower) || /\bshow\s+me\b/u.test(lower);
   return hasEnglishDeliverable && hasEnglishDeliveryAction;
 }
-function isVoicePart(part) {
+function isVoicePart2(part) {
   return part.kind === "voice" || part.is_voice_note === true;
 }
 function normalizeToolName(value) {
@@ -30773,13 +31415,13 @@ function readResponseId(payload) {
     return null;
   }
   const response = toRecord19(payload.response);
-  return readString20(payload, "response_id") ?? readString20(response, "id");
+  return readString21(payload, "response_id") ?? readString21(response, "id");
 }
 function readRunId(payload) {
   if (!payload) {
     return null;
   }
-  return readString20(payload, "run_id") ?? readString20(payload, "runId");
+  return readString21(payload, "run_id") ?? readString21(payload, "runId");
 }
 function isCompletedRunStatus(status) {
   return status === "completed" || status === "complete" || status === "succeeded" || status === "success" || status === "done";
@@ -30798,7 +31440,7 @@ function readStatusErrorMessage(value) {
     return value.trim();
   }
   const record = toRecord19(value);
-  return readString20(record, "message") ?? readString20(record, "error");
+  return readString21(record, "message") ?? readString21(record, "error");
 }
 function formatUnknownErrorMessage(error) {
   return error instanceof Error ? error.message : String(error);
@@ -30837,6 +31479,12 @@ function sanitizeLiveSessionForEvent(liveSession) {
     ...liveSession.inflight ? { inflight: liveSession.inflight } : {}
   };
 }
+function applyRunHermesMessageWatermark(run, phase, point) {
+  run.hermes_message_watermark = {
+    ...run.hermes_message_watermark ?? {},
+    [phase]: point
+  };
+}
 function previewText2(message) {
   if (!message) {
     return null;
@@ -31686,7 +32334,7 @@ var ConversationService = class {
         );
       }
       const shouldApplyModelConfig = configuredModel != null && !runtimeMatchesConfiguredModel(currentRuntime, configuredModel);
-      const modelConfigToApply = shouldApplyModelConfig ? configuredModel : void 0;
+      const modelConfigToApply = configuredModel ?? void 0;
       const sessionConfig = await setTuiGatewaySessionModelConfig({
         hermesSessionId: manifest.hermes_session_id,
         profileName: currentRuntime.profile.name,
@@ -32561,7 +33209,7 @@ var ConversationService = class {
     }
   }
   hermesArchiveStateSyncMarkerPath() {
-    return path27.join(this.paths.indexesDir, "hermes-archive-state-sync.json");
+    return path28.join(this.paths.indexesDir, "hermes-archive-state-sync.json");
   }
   prepareClearAllConversationPlan(targetStatus) {
     return this.maintenance.prepareClearAllConversationPlan(targetStatus);
@@ -32843,7 +33491,7 @@ function liveActivityTodoProgressForEvent(event) {
   if (todos) {
     const totalCount2 = todos.length;
     const doneCount2 = todos.filter((item) => {
-      const status = readString21(item, "status")?.toLowerCase();
+      const status = readString22(item, "status")?.toLowerCase();
       return status === "completed" || status === "cancelled" || status === "canceled";
     }).length;
     return {
@@ -32892,11 +33540,11 @@ function liveActivityTitleFromConversationUpdate(event) {
   if (event.type.toLowerCase() !== "conversation.updated") {
     return void 0;
   }
-  const titleSource = readString21(event.payload, "title_source");
+  const titleSource = readString22(event.payload, "title_source");
   if (titleSource === "default" || titleSource === "temporary_fallback") {
     return null;
   }
-  const title = readString21(event.payload, "title");
+  const title = readString22(event.payload, "title");
   return title ? truncateLiveActivityTitle(title, 24) : null;
 }
 function liveActivityTitleFromManifest(manifest) {
@@ -32936,7 +33584,7 @@ function isConversationTitleUpdateEvent(event) {
   if (event.type.toLowerCase() !== "conversation.updated") {
     return false;
   }
-  return Boolean(readString21(event.payload, "title")?.trim());
+  return Boolean(readString22(event.payload, "title")?.trim());
 }
 function resolveLiveActivityTarget(input) {
   if (input.run?.kind === "compression") {
@@ -32958,7 +33606,7 @@ function liveActivityPhaseForEvent(event, run, contextOperation) {
   }
   if (type === "conversation.goal.updated") {
     const goal = readRecord2(event.payload).goal;
-    const status = readString21(goal, "status");
+    const status = readString22(goal, "status");
     return status === "paused" ? "goal_paused" : "goal_running";
   }
   if (isConversationTitleUpdateEvent(event)) {
@@ -33091,7 +33739,7 @@ function readContextCompressionOperation(payload) {
   if (!operation || typeof operation !== "object") {
     return null;
   }
-  const operationId = readString21(operation, "operation_id");
+  const operationId = readString22(operation, "operation_id");
   if (!operationId) {
     return null;
   }
@@ -33099,19 +33747,19 @@ function readContextCompressionOperation(payload) {
   return {
     operation_id: operationId,
     generation: typeof record.generation === "number" ? record.generation : 0,
-    status: readString21(record, "status") === "completed" ? "completed" : readString21(record, "status") === "failed" ? "failed" : readString21(record, "status") === "timed_out" ? "timed_out" : readString21(record, "status") === "cancelled" ? "cancelled" : "compressing",
-    started_at: readString21(record, "started_at") ?? (/* @__PURE__ */ new Date()).toISOString(),
-    source: readString21(record, "source") === "manual" ? "manual" : "auto"
+    status: readString22(record, "status") === "completed" ? "completed" : readString22(record, "status") === "failed" ? "failed" : readString22(record, "status") === "timed_out" ? "timed_out" : readString22(record, "status") === "cancelled" ? "cancelled" : "compressing",
+    started_at: readString22(record, "started_at") ?? (/* @__PURE__ */ new Date()).toISOString(),
+    source: readString22(record, "source") === "manual" ? "manual" : "auto"
   };
 }
 function readToolName3(payload) {
   const record = readRecord2(payload);
-  return readString21(record, "tool_name") ?? readString21(record, "tool") ?? readString21(record, "name") ?? readString21(readRecord2(record.tool), "name");
+  return readString22(record, "tool_name") ?? readString22(record, "tool") ?? readString22(record, "name") ?? readString22(readRecord2(record.tool), "name");
 }
 function readRecord2(value) {
   return typeof value === "object" && value !== null && !Array.isArray(value) ? value : {};
 }
-function readString21(value, key) {
+function readString22(value, key) {
   const raw = readRecord2(value)[key];
   return typeof raw === "string" && raw.trim() ? raw.trim() : null;
 }
@@ -33631,7 +34279,7 @@ async function readRawBody(request, maxBytes) {
   }
   return Buffer.concat(chunks);
 }
-function readString22(body, key) {
+function readString23(body, key) {
   const value = body[key];
   return typeof value === "string" && value.trim() ? value.trim() : null;
 }
@@ -33666,7 +34314,7 @@ function readSupportedLanguage(value) {
   return null;
 }
 function readOptionalProfileName(body) {
-  return readString22(body, "profile") ?? readString22(body, "profile_name") ?? readString22(body, "profileName") ?? void 0;
+  return readString23(body, "profile") ?? readString23(body, "profile_name") ?? readString23(body, "profileName") ?? void 0;
 }
 function readStringArray(body, ...keys) {
   for (const key of keys) {
@@ -34024,7 +34672,8 @@ function registerConversationRoutes(router, options) {
     const result = await conversations.listConversationPage({
       limit: readLimit(ctx.query.limit),
       cursor,
-      workspace: readConversationWorkspaceFilter(ctx.query)
+      workspace: readConversationWorkspaceFilter(ctx.query),
+      category: readConversationCategoryFilter(ctx.query)
     });
     const localized = localizeConversationListPage(result, language);
     ctx.body = {
@@ -34086,7 +34735,7 @@ function registerConversationRoutes(router, options) {
     const language = readPreferredLanguage(ctx);
     const body = await readJsonBody(ctx.req);
     ctx.status = 201;
-    const rawReasoningEffort = readString22(body, "reasoning_effort") ?? readString22(body, "reasoningEffort") ?? readString22(body, "default_reasoning_effort") ?? readString22(body, "defaultReasoningEffort");
+    const rawReasoningEffort = readString23(body, "reasoning_effort") ?? readString23(body, "reasoningEffort") ?? readString23(body, "default_reasoning_effort") ?? readString23(body, "defaultReasoningEffort");
     const reasoningEffort = normalizeReasoningEffort(rawReasoningEffort);
     if (rawReasoningEffort && !reasoningEffort) {
       throw new LinkHttpError(
@@ -34099,15 +34748,15 @@ function registerConversationRoutes(router, options) {
       ok: true,
       conversation: localizeConversationSummary(
         await conversations.createConversation({
-          title: readString22(body, "title") ?? void 0,
+          title: readString23(body, "title") ?? void 0,
           profileName: readOptionalProfileName(body),
           accountId: auth.accountId,
           appInstanceId: auth.appInstanceId,
           workspaceId: readConversationWorkspaceId(body),
-          modelId: readString22(body, "model_id") ?? readString22(body, "modelId") ?? readString22(body, "model") ?? void 0,
-          modelProvider: readString22(body, "model_provider") ?? readString22(body, "modelProvider") ?? readString22(body, "provider") ?? void 0,
-          modelBaseUrl: readString22(body, "model_base_url") ?? readString22(body, "modelBaseUrl") ?? readString22(body, "base_url") ?? readString22(body, "baseUrl") ?? void 0,
-          modelApiMode: readString22(body, "model_api_mode") ?? readString22(body, "modelApiMode") ?? readString22(body, "api_mode") ?? readString22(body, "apiMode") ?? void 0,
+          modelId: readString23(body, "model_id") ?? readString23(body, "modelId") ?? readString23(body, "model") ?? void 0,
+          modelProvider: readString23(body, "model_provider") ?? readString23(body, "modelProvider") ?? readString23(body, "provider") ?? void 0,
+          modelBaseUrl: readString23(body, "model_base_url") ?? readString23(body, "modelBaseUrl") ?? readString23(body, "base_url") ?? readString23(body, "baseUrl") ?? void 0,
+          modelApiMode: readString23(body, "model_api_mode") ?? readString23(body, "modelApiMode") ?? readString23(body, "api_mode") ?? readString23(body, "apiMode") ?? void 0,
           reasoningEffort
         }),
         language
@@ -34185,9 +34834,9 @@ function registerConversationRoutes(router, options) {
     const auth = await authenticateRequest(ctx, paths);
     const language = readPreferredLanguage(ctx);
     const body = await readJsonBody(ctx.req);
-    const content = readString22(body, "content") ?? readString22(body, "text") ?? readString22(body, "input") ?? "";
+    const content = readString23(body, "content") ?? readString23(body, "text") ?? readString23(body, "input") ?? "";
     const attachments = readMessageAttachments(body.attachments ?? body.blobs);
-    const mode = readString22(body, "mode") ?? readString22(body, "send_mode");
+    const mode = readString23(body, "mode") ?? readString23(body, "send_mode");
     if (mode && mode !== "message" && mode !== "goal") {
       throw new LinkHttpError(
         400,
@@ -34210,7 +34859,7 @@ function registerConversationRoutes(router, options) {
           conversationId: ctx.params.conversationId,
           content,
           attachments,
-          clientMessageId: readString22(body, "client_message_id") ?? readString22(body, "clientMessageId") ?? void 0,
+          clientMessageId: readString23(body, "client_message_id") ?? readString23(body, "clientMessageId") ?? void 0,
           idempotencyKey: readHeader(ctx, "idempotency-key") ?? void 0,
           profileName: readOptionalProfileName(body),
           mode: mode === "goal" ? "goal" : "message",
@@ -34277,8 +34926,8 @@ function registerConversationRoutes(router, options) {
         ...localizeConversationResult(
           await conversations.startContextCompression({
             conversationId: ctx.params.conversationId,
-            focus: readString22(body, "focus") ?? readString22(body, "focus_topic") ?? readString22(body, "focusTopic") ?? void 0,
-            clientOperationId: readString22(body, "client_operation_id") ?? readString22(body, "clientOperationId") ?? readHeader(ctx, "idempotency-key") ?? void 0,
+            focus: readString23(body, "focus") ?? readString23(body, "focus_topic") ?? readString23(body, "focusTopic") ?? void 0,
+            clientOperationId: readString23(body, "client_operation_id") ?? readString23(body, "clientOperationId") ?? readHeader(ctx, "idempotency-key") ?? void 0,
             createUserMessage: false,
             accountId: auth.accountId,
             appInstanceId: auth.appInstanceId,
@@ -34292,11 +34941,11 @@ function registerConversationRoutes(router, options) {
   router.patch("/api/v1/conversations/:conversationId/model", async (ctx) => {
     await authenticateRequest(ctx, paths);
     const body = await readJsonBody(ctx.req);
-    const modelId = readString22(body, "model_id") ?? readString22(body, "modelId") ?? readString22(body, "model");
-    const modelProvider = readString22(body, "model_provider") ?? readString22(body, "modelProvider") ?? readString22(body, "provider") ?? void 0;
-    const modelBaseUrl = readString22(body, "model_base_url") ?? readString22(body, "modelBaseUrl") ?? readString22(body, "base_url") ?? readString22(body, "baseUrl") ?? void 0;
-    const modelApiMode = readString22(body, "model_api_mode") ?? readString22(body, "modelApiMode") ?? readString22(body, "api_mode") ?? readString22(body, "apiMode") ?? void 0;
-    const rawReasoningEffort = readString22(body, "reasoning_effort") ?? readString22(body, "reasoningEffort") ?? readString22(body, "default_reasoning_effort") ?? readString22(body, "defaultReasoningEffort");
+    const modelId = readString23(body, "model_id") ?? readString23(body, "modelId") ?? readString23(body, "model");
+    const modelProvider = readString23(body, "model_provider") ?? readString23(body, "modelProvider") ?? readString23(body, "provider") ?? void 0;
+    const modelBaseUrl = readString23(body, "model_base_url") ?? readString23(body, "modelBaseUrl") ?? readString23(body, "base_url") ?? readString23(body, "baseUrl") ?? void 0;
+    const modelApiMode = readString23(body, "model_api_mode") ?? readString23(body, "modelApiMode") ?? readString23(body, "api_mode") ?? readString23(body, "apiMode") ?? void 0;
+    const rawReasoningEffort = readString23(body, "reasoning_effort") ?? readString23(body, "reasoningEffort") ?? readString23(body, "default_reasoning_effort") ?? readString23(body, "defaultReasoningEffort");
     const reasoningEffort = normalizeReasoningEffort(rawReasoningEffort);
     if (rawReasoningEffort && !reasoningEffort) {
       throw new LinkHttpError(
@@ -34346,7 +34995,7 @@ function registerConversationRoutes(router, options) {
     await authenticateRequest(ctx, paths);
     const language = readPreferredLanguage(ctx);
     const body = await readJsonBody(ctx.req);
-    const title = readString22(body, "title") ?? readString22(body, "name") ?? readString22(body, "display_name");
+    const title = readString23(body, "title") ?? readString23(body, "name") ?? readString23(body, "display_name");
     if (!title) {
       throw new LinkHttpError(400, "title_required", "title is required");
     }
@@ -34538,7 +35187,7 @@ function registerConversationRoutes(router, options) {
     async (ctx) => {
       await authenticateRequest(ctx, paths);
       const body = await readJsonBody(ctx.req);
-      const scope = readString22(body, "scope") ?? "always";
+      const scope = readString23(body, "scope") ?? "always";
       ctx.body = {
         ok: true,
         ...await conversations.resolveApproval({
@@ -34588,7 +35237,7 @@ function registerConversationRoutes(router, options) {
           conversationId: ctx.params.conversationId,
           requestId: ctx.params.requestId,
           kind,
-          answer: readString22(body, "answer") ?? void 0,
+          answer: readString23(body, "answer") ?? void 0,
           password: readRawString(body, "password"),
           value: readRawString(body, "value")
         })
@@ -34755,12 +35404,27 @@ function readConversationWorkspaceFilter(query) {
   }
   return { kind: "workspace", workspaceId: workspace };
 }
+function readConversationCategoryFilter(query) {
+  const category = readQueryString(query.category) ?? readQueryString(query.conversation_category) ?? readQueryString(query.conversationCategory);
+  const normalized = category?.trim().toLowerCase();
+  if (!normalized || normalized === "all") {
+    return "all";
+  }
+  if (normalized === "chat" || normalized === "cron") {
+    return normalized;
+  }
+  throw new LinkHttpError(
+    400,
+    "conversation_category_invalid",
+    "conversation category must be all, chat or cron"
+  );
+}
 function readConversationWorkspaceId(body) {
   if (Object.prototype.hasOwnProperty.call(body, "workspace_id") || Object.prototype.hasOwnProperty.call(body, "workspaceId")) {
-    return readString22(body, "workspace_id") ?? readString22(body, "workspaceId");
+    return readString23(body, "workspace_id") ?? readString23(body, "workspaceId");
   }
   if (Object.prototype.hasOwnProperty.call(body, "workspace")) {
-    return readString22(body, "workspace");
+    return readString23(body, "workspace");
   }
   return void 0;
 }
@@ -34854,7 +35518,7 @@ function resolveConversationEventCursor(input) {
   return Math.max(queryAfter, headerAfter);
 }
 function readConversationClearPlanTargetStatus(body) {
-  const raw = readString22(body, "target_status") ?? readString22(body, "targetStatus") ?? "active";
+  const raw = readString23(body, "target_status") ?? readString23(body, "targetStatus") ?? "active";
   if (raw === "active" || raw === "archived") {
     return raw;
   }
@@ -34865,7 +35529,7 @@ function readConversationClearPlanTargetStatus(body) {
   );
 }
 function readInputRequestKind2(body) {
-  const kind = readString22(body, "kind") ?? readString22(body, "type");
+  const kind = readString23(body, "kind") ?? readString23(body, "type");
   if (kind === "clarify" || kind === "sudo" || kind === "secret") {
     return kind;
   }
@@ -34995,11 +35659,11 @@ function isSseRequestContext(ctx) {
   }
   return isSseRequestPath(ctx.path) || isActiveSseSocket(ctx.req.socket);
 }
-function isSseRequestPath(path38) {
-  if (!path38) {
+function isSseRequestPath(path39) {
+  if (!path39) {
     return false;
   }
-  return path38 === "/api/v1/conversations/events" || path38 === "/api/v1/profile-creation/events" || path38 === "/api/v1/hermes/update/events" || path38 === "/api/v1/link/update/events" || /^\/api\/v1\/conversations\/[^/]+\/events$/u.test(path38) || /^\/api\/v1\/runs\/[^/]+\/events$/u.test(path38);
+  return path39 === "/api/v1/conversations/events" || path39 === "/api/v1/profile-creation/events" || path39 === "/api/v1/hermes/update/events" || path39 === "/api/v1/link/update/events" || /^\/api\/v1\/conversations\/[^/]+\/events$/u.test(path39) || /^\/api\/v1\/runs\/[^/]+\/events$/u.test(path39);
 }
 function isExpectedClientDisconnectError2(error, options = {}) {
   if (!(error instanceof Error)) {
@@ -35263,7 +35927,7 @@ function toHermesCronJobInput(input) {
   };
 }
 async function bindAndDecorateCronJobForHermesLink(input) {
-  const jobId = readString22(input.job, "id") ?? readString22(input.job, "job_id");
+  const jobId = readString23(input.job, "id") ?? readString23(input.job, "job_id");
   if (!jobId) {
     return input.job;
   }
@@ -35282,9 +35946,9 @@ async function bindAndDecorateCronJobForHermesLink(input) {
 }
 function readCronJobCreateInput(body) {
   const input = {};
-  const name = readString22(body, "name") ?? readString22(body, "title");
-  const prompt = readString22(body, "prompt") ?? readString22(body, "description") ?? readString22(body, "task");
-  const schedule = readString22(body, "schedule");
+  const name = readString23(body, "name") ?? readString23(body, "title");
+  const prompt = readString23(body, "prompt") ?? readString23(body, "description") ?? readString23(body, "task");
+  const schedule = readString23(body, "schedule");
   if (!name) {
     throw new LinkHttpError(400, "cron_job_name_required", "name is required");
   }
@@ -35305,7 +35969,7 @@ function readCronJobCreateInput(body) {
   input.name = name;
   input.prompt = prompt;
   input.schedule = schedule;
-  input.deliver = readString22(body, "deliver") ?? HERMES_LINK_CRON_DELIVER;
+  input.deliver = readString23(body, "deliver") ?? HERMES_LINK_CRON_DELIVER;
   const skills = readOptionalCronSkills(body);
   if (skills) {
     input.skills = skills;
@@ -35438,7 +36102,7 @@ import { createHash as createHash11 } from "crypto";
 // src/model-catalog/catalog.ts
 import { randomInt } from "crypto";
 import { mkdir as mkdir12 } from "fs/promises";
-import path28 from "path";
+import path29 from "path";
 import { fileURLToPath } from "url";
 var MODEL_CATALOG_CACHE_VERSION = 1;
 var MODEL_CATALOG_FETCH_TIMEOUT_MS = 1e4;
@@ -35642,7 +36306,7 @@ async function readCachedCatalogFile(paths) {
   return cached;
 }
 async function writeCachedCatalog(paths, value) {
-  await mkdir12(path28.dirname(modelCatalogCachePath(paths)), {
+  await mkdir12(path29.dirname(modelCatalogCachePath(paths)), {
     recursive: true,
     mode: 448
   });
@@ -35658,7 +36322,7 @@ async function readFallbackCatalog() {
   throw new Error("model capability fallback catalog was not found");
 }
 function modelCatalogCachePath(paths) {
-  return path28.join(paths.homeDir, "model-capabilities", "catalog-cache.json");
+  return path29.join(paths.homeDir, "model-capabilities", "catalog-cache.json");
 }
 function normalizeModelCapabilityCatalog(value) {
   if (!value || typeof value !== "object") {
@@ -35669,7 +36333,7 @@ function normalizeModelCapabilityCatalog(value) {
   const models = rawModels.map(normalizeModelCapabilityEntry).filter((entry) => entry !== null);
   return {
     schemaVersion: readPositiveInteger3(record.schemaVersion) ?? 1,
-    updatedAt: readString23(record.updatedAt),
+    updatedAt: readString24(record.updatedAt),
     models
   };
 }
@@ -35678,7 +36342,7 @@ function normalizeModelCapabilityEntry(value) {
     return null;
   }
   const record = value;
-  const canonicalId = readString23(record.canonicalId) ?? readString23(record.canonical_id) ?? readString23(record.id);
+  const canonicalId = readString24(record.canonicalId) ?? readString24(record.canonical_id) ?? readString24(record.id);
   if (!canonicalId) {
     return null;
   }
@@ -35706,12 +36370,12 @@ function normalizeModelCapabilityEntry(value) {
     outputModalities: readStringArray2(
       record.outputModalities ?? record.output_modalities
     ),
-    source: readString23(record.source),
-    updatedAt: readString23(record.updatedAt ?? record.updated_at),
-    notes: readString23(record.notes)
+    source: readString24(record.source),
+    updatedAt: readString24(record.updatedAt ?? record.updated_at),
+    notes: readString24(record.notes)
   };
 }
-function readString23(value) {
+function readString24(value) {
   return typeof value === "string" && value.trim() ? value.trim() : null;
 }
 function readStringArray2(value) {
@@ -35721,7 +36385,7 @@ function readStringArray2(value) {
   const seen = /* @__PURE__ */ new Set();
   const values = [];
   for (const item of value) {
-    const text = readString23(item);
+    const text = readString24(item);
     if (!text || seen.has(text)) {
       continue;
     }
@@ -35738,7 +36402,7 @@ function readPositiveInteger3(value) {
   return Math.floor(number);
 }
 function readReasoningSupportPolicy(value) {
-  const normalized = readString23(value)?.toLowerCase();
+  const normalized = readString24(value)?.toLowerCase();
   if (!normalized || normalized === "unknown" || normalized === "auto") {
     return null;
   }
@@ -35769,7 +36433,7 @@ function readNullableBoolean(value) {
   if (typeof value === "boolean") {
     return value;
   }
-  const normalized = readString23(value)?.toLowerCase();
+  const normalized = readString24(value)?.toLowerCase();
   if (!normalized) {
     return null;
   }
@@ -36918,8 +37582,8 @@ function normalizeUrlForIdentity(value) {
   return value.trim().replace(/\/+$/u, "").toLowerCase();
 }
 function readModelProviderConfigInput(body) {
-  const providerName = readString22(body, "display_name") ?? readString22(body, "displayName") ?? readString22(body, "provider_name") ?? readString22(body, "providerName") ?? readString22(body, "name");
-  const baseUrl = readString22(body, "base_url") ?? readString22(body, "baseUrl");
+  const providerName = readString23(body, "display_name") ?? readString23(body, "displayName") ?? readString23(body, "provider_name") ?? readString23(body, "providerName") ?? readString23(body, "name");
+  const baseUrl = readString23(body, "base_url") ?? readString23(body, "baseUrl");
   if (!providerName || !baseUrl) {
     throw new LinkHttpError(
       400,
@@ -36930,15 +37594,15 @@ function readModelProviderConfigInput(body) {
   return {
     providerName,
     baseUrl,
-    apiMode: readString22(body, "api_mode") ?? readString22(body, "apiMode") ?? readString22(body, "transport") ?? void 0,
-    keyEnv: readString22(body, "key_env") ?? readString22(body, "keyEnv") ?? void 0,
-    apiKey: readString22(body, "api_key") ?? readString22(body, "apiKey") ?? void 0
+    apiMode: readString23(body, "api_mode") ?? readString23(body, "apiMode") ?? readString23(body, "transport") ?? void 0,
+    keyEnv: readString23(body, "key_env") ?? readString23(body, "keyEnv") ?? void 0,
+    apiKey: readString23(body, "api_key") ?? readString23(body, "apiKey") ?? void 0
   };
 }
 function readModelConfigInput(body) {
-  const id = readString22(body, "id") ?? readString22(body, "model_id") ?? readString22(body, "modelId");
-  const provider = readString22(body, "provider") ?? readString22(body, "provider_key") ?? readString22(body, "providerKey");
-  const baseUrl = readString22(body, "base_url") ?? readString22(body, "baseUrl");
+  const id = readString23(body, "id") ?? readString23(body, "model_id") ?? readString23(body, "modelId");
+  const provider = readString23(body, "provider") ?? readString23(body, "provider_key") ?? readString23(body, "providerKey");
+  const baseUrl = readString23(body, "base_url") ?? readString23(body, "baseUrl");
   if (!id || !provider || !baseUrl) {
     throw new LinkHttpError(
       400,
@@ -36948,22 +37612,22 @@ function readModelConfigInput(body) {
   }
   return {
     id,
-    originalModelId: readString22(body, "original_model_id") ?? readString22(body, "originalModelId") ?? readString22(body, "original_id") ?? void 0,
-    originalProvider: readString22(body, "original_provider") ?? readString22(body, "originalProvider") ?? readString22(body, "original_provider_key") ?? readString22(body, "originalProviderKey") ?? void 0,
-    originalBaseUrl: readString22(body, "original_base_url") ?? readString22(body, "originalBaseUrl") ?? void 0,
-    originalApiMode: readString22(body, "original_api_mode") ?? readString22(body, "originalApiMode") ?? void 0,
+    originalModelId: readString23(body, "original_model_id") ?? readString23(body, "originalModelId") ?? readString23(body, "original_id") ?? void 0,
+    originalProvider: readString23(body, "original_provider") ?? readString23(body, "originalProvider") ?? readString23(body, "original_provider_key") ?? readString23(body, "originalProviderKey") ?? void 0,
+    originalBaseUrl: readString23(body, "original_base_url") ?? readString23(body, "originalBaseUrl") ?? void 0,
+    originalApiMode: readString23(body, "original_api_mode") ?? readString23(body, "originalApiMode") ?? void 0,
     provider,
-    providerName: readString22(body, "provider_name") ?? readString22(body, "providerName") ?? void 0,
+    providerName: readString23(body, "provider_name") ?? readString23(body, "providerName") ?? void 0,
     baseUrl,
-    apiKey: readString22(body, "api_key") ?? readString22(body, "apiKey") ?? void 0,
-    apiMode: readString22(body, "api_mode") ?? readString22(body, "apiMode") ?? void 0,
+    apiKey: readString23(body, "api_key") ?? readString23(body, "apiKey") ?? void 0,
+    apiMode: readString23(body, "api_mode") ?? readString23(body, "apiMode") ?? void 0,
     contextLength: readPositiveInteger2(
       body.context_length ?? body.contextLength
     ),
-    keyEnv: readString22(body, "key_env") ?? readString22(body, "keyEnv") ?? void 0,
+    keyEnv: readString23(body, "key_env") ?? readString23(body, "keyEnv") ?? void 0,
     setDefault: readBoolean4(body.set_default ?? body.setDefault),
-    reasoningEffort: readString22(body, "reasoning_effort") ?? readString22(body, "reasoningEffort") ?? void 0,
-    reasoningSupportPolicy: readString22(body, "reasoning_support_policy") ?? readString22(body, "reasoningSupportPolicy") ?? readString22(body, "reasoning_support") ?? readString22(body, "reasoningSupport") ?? void 0,
+    reasoningEffort: readString23(body, "reasoning_effort") ?? readString23(body, "reasoningEffort") ?? void 0,
+    reasoningSupportPolicy: readString23(body, "reasoning_support_policy") ?? readString23(body, "reasoningSupportPolicy") ?? readString23(body, "reasoning_support") ?? readString23(body, "reasoningSupport") ?? void 0,
     supportsVision: readNullableBoolean2(
       body.supports_vision ?? body.supportsVision
     )
@@ -36971,28 +37635,28 @@ function readModelConfigInput(body) {
 }
 function readModelDefaultsInput(body) {
   return {
-    taskModelId: readString22(body, "task_model_id") ?? readString22(body, "taskModelId") ?? readString22(body, "default_model_id") ?? readString22(body, "defaultModelId") ?? void 0,
-    taskModelProvider: readString22(body, "task_model_provider") ?? readString22(body, "taskModelProvider") ?? readString22(body, "default_model_provider") ?? readString22(body, "defaultModelProvider") ?? void 0,
-    taskModelBaseUrl: readString22(body, "task_model_base_url") ?? readString22(body, "taskModelBaseUrl") ?? readString22(body, "default_model_base_url") ?? readString22(body, "defaultModelBaseUrl") ?? void 0,
-    taskModelApiMode: readString22(body, "task_model_api_mode") ?? readString22(body, "taskModelApiMode") ?? readString22(body, "default_model_api_mode") ?? readString22(body, "defaultModelApiMode") ?? void 0,
-    compressionModelId: readString22(body, "compression_model_id") ?? readString22(body, "compressionModelId") ?? void 0,
-    compressionModelProvider: readString22(body, "compression_model_provider") ?? readString22(body, "compressionModelProvider") ?? void 0,
-    compressionModelBaseUrl: readString22(body, "compression_model_base_url") ?? readString22(body, "compressionModelBaseUrl") ?? void 0,
-    compressionModelApiMode: readString22(body, "compression_model_api_mode") ?? readString22(body, "compressionModelApiMode") ?? void 0,
-    reasoningEffort: readString22(body, "reasoning_effort") ?? readString22(body, "reasoningEffort") ?? readString22(body, "default_reasoning_effort") ?? readString22(body, "defaultReasoningEffort") ?? void 0,
-    imageInputMode: readString22(body, "image_input_mode") ?? readString22(body, "imageInputMode") ?? void 0
+    taskModelId: readString23(body, "task_model_id") ?? readString23(body, "taskModelId") ?? readString23(body, "default_model_id") ?? readString23(body, "defaultModelId") ?? void 0,
+    taskModelProvider: readString23(body, "task_model_provider") ?? readString23(body, "taskModelProvider") ?? readString23(body, "default_model_provider") ?? readString23(body, "defaultModelProvider") ?? void 0,
+    taskModelBaseUrl: readString23(body, "task_model_base_url") ?? readString23(body, "taskModelBaseUrl") ?? readString23(body, "default_model_base_url") ?? readString23(body, "defaultModelBaseUrl") ?? void 0,
+    taskModelApiMode: readString23(body, "task_model_api_mode") ?? readString23(body, "taskModelApiMode") ?? readString23(body, "default_model_api_mode") ?? readString23(body, "defaultModelApiMode") ?? void 0,
+    compressionModelId: readString23(body, "compression_model_id") ?? readString23(body, "compressionModelId") ?? void 0,
+    compressionModelProvider: readString23(body, "compression_model_provider") ?? readString23(body, "compressionModelProvider") ?? void 0,
+    compressionModelBaseUrl: readString23(body, "compression_model_base_url") ?? readString23(body, "compressionModelBaseUrl") ?? void 0,
+    compressionModelApiMode: readString23(body, "compression_model_api_mode") ?? readString23(body, "compressionModelApiMode") ?? void 0,
+    reasoningEffort: readString23(body, "reasoning_effort") ?? readString23(body, "reasoningEffort") ?? readString23(body, "default_reasoning_effort") ?? readString23(body, "defaultReasoningEffort") ?? void 0,
+    imageInputMode: readString23(body, "image_input_mode") ?? readString23(body, "imageInputMode") ?? void 0
   };
 }
 function readModelDeleteInput(body) {
-  const id = readString22(body, "model_id") ?? readString22(body, "modelId");
+  const id = readString23(body, "model_id") ?? readString23(body, "modelId");
   if (!id) {
     throw new LinkHttpError(400, "model_id_required", "model_id is required");
   }
   return {
     id,
-    provider: readString22(body, "provider") ?? readString22(body, "provider_key") ?? readString22(body, "providerKey") ?? void 0,
-    baseUrl: readString22(body, "base_url") ?? readString22(body, "baseUrl") ?? void 0,
-    apiMode: readString22(body, "api_mode") ?? readString22(body, "apiMode") ?? void 0
+    provider: readString23(body, "provider") ?? readString23(body, "provider_key") ?? readString23(body, "providerKey") ?? void 0,
+    baseUrl: readString23(body, "base_url") ?? readString23(body, "baseUrl") ?? void 0,
+    apiMode: readString23(body, "api_mode") ?? readString23(body, "apiMode") ?? void 0
   };
 }
 function readNullableBoolean2(value) {
@@ -37015,8 +37679,8 @@ function readNullableBoolean2(value) {
   return void 0;
 }
 function readModelConfigImportInput(body) {
-  const sourceProfileName = readString22(body, "source_profile") ?? readString22(body, "sourceProfile") ?? readString22(body, "source_profile_name") ?? readString22(body, "sourceProfileName");
-  const modelId = readString22(body, "model_id") ?? readString22(body, "modelId") ?? readString22(body, "id");
+  const sourceProfileName = readString23(body, "source_profile") ?? readString23(body, "sourceProfile") ?? readString23(body, "source_profile_name") ?? readString23(body, "sourceProfileName");
+  const modelId = readString23(body, "model_id") ?? readString23(body, "modelId") ?? readString23(body, "id");
   if (!sourceProfileName || !modelId) {
     throw new LinkHttpError(
       400,
@@ -37027,9 +37691,9 @@ function readModelConfigImportInput(body) {
   return {
     sourceProfileName,
     modelId,
-    provider: readString22(body, "provider") ?? readString22(body, "provider_key") ?? readString22(body, "providerKey") ?? void 0,
-    baseUrl: readString22(body, "base_url") ?? readString22(body, "baseUrl") ?? void 0,
-    apiMode: readString22(body, "api_mode") ?? readString22(body, "apiMode") ?? void 0,
+    provider: readString23(body, "provider") ?? readString23(body, "provider_key") ?? readString23(body, "providerKey") ?? void 0,
+    baseUrl: readString23(body, "base_url") ?? readString23(body, "baseUrl") ?? void 0,
+    apiMode: readString23(body, "api_mode") ?? readString23(body, "apiMode") ?? void 0,
     setDefault: readBoolean4(body.set_default ?? body.setDefault)
   };
 }
@@ -37136,19 +37800,19 @@ function errorMessage3(error) {
 }
 
 // src/hermes/profile-identity.ts
-import { readFile as readFile16, stat as stat18 } from "fs/promises";
-import path29 from "path";
+import { readFile as readFile17, stat as stat19 } from "fs/promises";
+import path30 from "path";
 var MAX_SOUL_MD_LENGTH = 2e4;
 async function readHermesProfileIdentity(profileName, paths) {
   await assertProfileExists3(profileName, paths);
   const soulPath = resolveSoulPath(profileName);
-  const content = await readFile16(soulPath, "utf8").catch((error) => {
+  const content = await readFile17(soulPath, "utf8").catch((error) => {
     if (isNodeError19(error, "ENOENT")) {
       return null;
     }
     throw error;
   });
-  const fileStat = content === null ? null : await stat18(soulPath).catch((error) => {
+  const fileStat = content === null ? null : await stat19(soulPath).catch((error) => {
     if (isNodeError19(error, "ENOENT")) {
       return null;
     }
@@ -37194,7 +37858,7 @@ async function assertProfileExists3(profileName, paths) {
   }
 }
 function resolveSoulPath(profileName) {
-  return path29.join(resolveHermesProfileDir(profileName), "SOUL.md");
+  return path30.join(resolveHermesProfileDir(profileName), "SOUL.md");
 }
 function isNodeError19(error, code) {
   return error instanceof Error && "code" in error && error.code === code;
@@ -37206,17 +37870,17 @@ import { EventEmitter as EventEmitter2 } from "events";
 import {
   cp,
   mkdir as mkdir13,
-  readFile as readFile18,
+  readFile as readFile19,
   rm as rm7,
-  stat as stat20
+  stat as stat21
 } from "fs/promises";
-import path31 from "path";
+import path32 from "path";
 import YAML5 from "yaml";
 
 // src/hermes/link-skill.ts
-import { readFile as readFile17, stat as stat19 } from "fs/promises";
+import { readFile as readFile18, stat as stat20 } from "fs/promises";
 import os7 from "os";
-import path30 from "path";
+import path31 from "path";
 import YAML4 from "yaml";
 var HERMES_LINK_SKILL_ROOT_DIR = "hermes-skills";
 var HERMES_LINK_SKILL_DIR = "hermes-link";
@@ -37313,7 +37977,7 @@ Do not modify Hermes profiles, delete user data, edit config files, or kill proc
 async function ensureHermesLinkSkillInstalledForProfiles(options = {}) {
   const paths = options.paths ?? resolveRuntimePaths();
   const externalDir = resolveHermesLinkSkillExternalDir(paths);
-  const skillPath = path30.join(
+  const skillPath = path31.join(
     externalDir,
     HERMES_LINK_SKILL_DIR,
     HERMES_LINK_SKILL_FILE
@@ -37395,10 +38059,10 @@ function withDefaultProfilePlaceholder2(profiles) {
   ];
 }
 function resolveHermesLinkSkillExternalDir(paths = resolveRuntimePaths()) {
-  return path30.join(paths.homeDir, HERMES_LINK_SKILL_ROOT_DIR);
+  return path31.join(paths.homeDir, HERMES_LINK_SKILL_ROOT_DIR);
 }
 async function writeHermesLinkSkill(skillPath) {
-  const existing = await readFile17(skillPath, "utf8").catch((error) => {
+  const existing = await readFile18(skillPath, "utf8").catch((error) => {
     if (isNodeError20(error, "ENOENT")) {
       return null;
     }
@@ -37456,7 +38120,7 @@ async function ensureProfileUsesExternalSkillDir(profile, externalDir) {
   };
 }
 async function readHermesConfigDocument3(configPath) {
-  const existingRaw = await readFile17(configPath, "utf8").catch(
+  const existingRaw = await readFile18(configPath, "utf8").catch(
     (error) => {
       if (isNodeError20(error, "ENOENT")) {
         return null;
@@ -37490,11 +38154,11 @@ function appendExternalDir(current, externalDir, hermesHome) {
   const seen = new Set(
     entries.map((entry) => resolveExternalDirEntry(entry, hermesHome))
   );
-  const normalizedExternalDir = path30.resolve(externalDir);
+  const normalizedExternalDir = path31.resolve(externalDir);
   return seen.has(normalizedExternalDir) ? entries : [...entries, normalizedExternalDir];
 }
 function externalDirsInclude(current, externalDir, hermesHome) {
-  const normalizedExternalDir = path30.resolve(externalDir);
+  const normalizedExternalDir = path31.resolve(externalDir);
   return readExternalDirEntries(current).some(
     (entry) => resolveExternalDirEntry(entry, hermesHome) === normalizedExternalDir
   );
@@ -37505,14 +38169,14 @@ function readExternalDirEntries(value) {
 }
 function resolveExternalDirEntry(entry, hermesHome) {
   const expanded = expandHome(expandEnvVars(entry));
-  return path30.resolve(path30.isAbsolute(expanded) ? expanded : path30.join(hermesHome, expanded));
+  return path31.resolve(path31.isAbsolute(expanded) ? expanded : path31.join(hermesHome, expanded));
 }
 function expandHome(value) {
   if (value === "~") {
     return os7.homedir();
   }
-  if (value.startsWith(`~${path30.sep}`) || value.startsWith("~/")) {
-    return path30.join(os7.homedir(), value.slice(2));
+  if (value.startsWith(`~${path31.sep}`) || value.startsWith("~/")) {
+    return path31.join(os7.homedir(), value.slice(2));
   }
   return value;
 }
@@ -37523,7 +38187,7 @@ function expandEnvVars(value) {
   );
 }
 async function pathIsDirectory2(filePath) {
-  return stat19(filePath).then((value) => value.isDirectory()).catch((error) => {
+  return stat20(filePath).then((value) => value.isDirectory()).catch((error) => {
     if (isNodeError20(error, "ENOENT")) {
       return false;
     }
@@ -38064,8 +38728,8 @@ function collectEnvKeys(value, keys = /* @__PURE__ */ new Set()) {
   return keys;
 }
 async function writeEnvValues(profileName, values) {
-  const envPath = path31.join(resolveHermesProfileDir(profileName), ".env");
-  const existingRaw = await readFile18(envPath, "utf8").catch((error) => {
+  const envPath = path32.join(resolveHermesProfileDir(profileName), ".env");
+  const existingRaw = await readFile19(envPath, "utf8").catch((error) => {
     if (isNodeError21(error, "ENOENT")) {
       return "";
     }
@@ -38101,8 +38765,8 @@ async function writeEnvValues(profileName, values) {
   await atomicWriteFilePreservingMetadata(envPath, nextRaw);
 }
 async function copySkills(sourceProfile, targetProfile) {
-  const sourceSkills = path31.join(resolveHermesProfileDir(sourceProfile), "skills");
-  const targetSkills = path31.join(resolveHermesProfileDir(targetProfile), "skills");
+  const sourceSkills = path32.join(resolveHermesProfileDir(sourceProfile), "skills");
+  const targetSkills = path32.join(resolveHermesProfileDir(targetProfile), "skills");
   if (!await pathExists2(sourceSkills)) {
     return;
   }
@@ -38125,7 +38789,7 @@ function copyProperty(source, target, key) {
   }
 }
 async function readYamlConfig(configPath) {
-  const existingRaw = await readFile18(configPath, "utf8").catch(
+  const existingRaw = await readFile19(configPath, "utf8").catch(
     (error) => {
       if (isNodeError21(error, "ENOENT")) {
         return null;
@@ -38188,7 +38852,7 @@ async function writeProfileCreationState(paths, state) {
   await writeJsonFile(profileCreationStatePath(paths), state);
 }
 async function readProfileCreationLogLines(paths) {
-  const raw = await readFile18(profileCreationLogPath(paths), "utf8").catch(() => "");
+  const raw = await readFile19(profileCreationLogPath(paths), "utf8").catch(() => "");
   if (!raw.trim()) {
     return [];
   }
@@ -38197,10 +38861,10 @@ async function readProfileCreationLogLines(paths) {
   );
 }
 function profileCreationStatePath(paths) {
-  return path31.join(paths.runDir, "profile-create-state.json");
+  return path32.join(paths.runDir, "profile-create-state.json");
 }
 function profileCreationLogPath(paths) {
-  return path31.join(paths.logsDir, PROFILE_CREATE_LOG_FILE);
+  return path32.join(paths.logsDir, PROFILE_CREATE_LOG_FILE);
 }
 async function clearProfileCreationLogFiles(paths) {
   const primary = profileCreationLogPath(paths);
@@ -38213,7 +38877,7 @@ async function clearProfileCreationLogFiles(paths) {
   ]);
 }
 async function pathExists2(targetPath) {
-  return await stat20(targetPath).then(() => true).catch((error) => {
+  return await stat21(targetPath).then(() => true).catch((error) => {
     if (isNodeError21(error, "ENOENT")) {
       return false;
     }
@@ -38346,16 +39010,16 @@ function readProfilePermissionsInput(body) {
   const approvals = readOptionalObject(body, "approvals");
   if (approvals) {
     input.approvals = {
-      mode: readString22(approvals, "mode") ?? readString22(approvals, "approval_mode") ?? readString22(approvals, "approvalMode") ?? void 0,
+      mode: readString23(approvals, "mode") ?? readString23(approvals, "approval_mode") ?? readString23(approvals, "approvalMode") ?? void 0,
       timeout: readPositiveInteger2(approvals.timeout),
-      cronMode: readString22(approvals, "cron_mode") ?? readString22(approvals, "cronMode") ?? void 0
+      cronMode: readString23(approvals, "cron_mode") ?? readString23(approvals, "cronMode") ?? void 0
     };
   }
   const terminal = readOptionalObject(body, "terminal");
   if (terminal) {
     input.terminal = {
-      backend: readString22(terminal, "backend") ?? void 0,
-      cwd: readString22(terminal, "cwd") ?? void 0,
+      backend: readString23(terminal, "backend") ?? void 0,
+      cwd: readString23(terminal, "cwd") ?? void 0,
       containerCpu: readPositiveInteger2(
         terminal.container_cpu ?? terminal.containerCpu
       ),
@@ -38486,10 +39150,10 @@ function toProfileToolConfigHttpError(error) {
 import {
   access as access3,
   readdir as readdir10,
-  readFile as readFile19,
-  stat as stat21
+  readFile as readFile20,
+  stat as stat22
 } from "fs/promises";
-import path32 from "path";
+import path33 from "path";
 import YAML6 from "yaml";
 var ENTRY_DELIMITER = "\n\xA7\n";
 var DEFAULT_MEMORY_LIMIT = 2200;
@@ -38686,9 +39350,9 @@ async function testHindsightProviderSettings(profileName, patch) {
   const mode = normalizeHindsightMode(
     patch.mode ?? config.mode ?? env.HINDSIGHT_MODE
   );
-  const apiUrl = readString24(patch.apiUrl) ?? readString24(config.api_url) ?? env.HINDSIGHT_API_URL ?? (mode === "cloud" ? HINDSIGHT_DEFAULT_API_URL : HINDSIGHT_DEFAULT_LOCAL_URL);
-  const bankId = readString24(patch.bankId) ?? readString24(config.bank_id) ?? "hermes";
-  const apiKey = readString24(patch.apiKey) ?? env.HINDSIGHT_API_KEY ?? readString24(config.apiKey) ?? readString24(config.api_key);
+  const apiUrl = readString25(patch.apiUrl) ?? readString25(config.api_url) ?? env.HINDSIGHT_API_URL ?? (mode === "cloud" ? HINDSIGHT_DEFAULT_API_URL : HINDSIGHT_DEFAULT_LOCAL_URL);
+  const bankId = readString25(patch.bankId) ?? readString25(config.bank_id) ?? "hermes";
+  const apiKey = readString25(patch.apiKey) ?? env.HINDSIGHT_API_KEY ?? readString25(config.apiKey) ?? readString25(config.api_key);
   const baseUrl = normalizeHttpUrl2(apiUrl);
   if (!baseUrl) {
     return {
@@ -38820,7 +39484,7 @@ async function saveProviderSettings(profileName, provider, patch) {
     });
     await patchJsonProviderConfig(
       profileName,
-      path32.join("hindsight", "config.json"),
+      path33.join("hindsight", "config.json"),
       {
         mode: patch.mode,
         api_url: patch.apiUrl,
@@ -38968,7 +39632,7 @@ function normalizeCustomProviderId(provider) {
 }
 async function patchHermesMemoryProvider(profileName, provider) {
   const configPath = resolveHermesConfigPath(profileName);
-  const existingRaw = await readFile19(configPath, "utf8").catch(
+  const existingRaw = await readFile20(configPath, "utf8").catch(
     (error) => {
       if (isNodeError22(error, "ENOENT")) {
         return null;
@@ -38992,7 +39656,7 @@ async function patchHermesMemoryProvider(profileName, provider) {
 }
 async function patchHermesMemoryLimits(profileName, patch) {
   const configPath = resolveHermesConfigPath(profileName);
-  const existingRaw = await readFile19(configPath, "utf8").catch(
+  const existingRaw = await readFile20(configPath, "utf8").catch(
     (error) => {
       if (isNodeError22(error, "ENOENT")) {
         return null;
@@ -39023,12 +39687,12 @@ async function patchHermesMemoryLimits(profileName, patch) {
   await atomicWriteFilePreservingMetadata(configPath, document.toString());
 }
 function resolveMemoryDir(profileName) {
-  return path32.join(resolveHermesProfileDir(profileName), "memories");
+  return path33.join(resolveHermesProfileDir(profileName), "memories");
 }
 async function readMemoryStore(profileName, target, limits) {
   const filePath = memoryFilePath(profileName, target);
   const entries = await readMemoryEntries(filePath);
-  const fileStat = await stat21(filePath).catch((error) => {
+  const fileStat = await stat22(filePath).catch((error) => {
     if (isNodeError22(error, "ENOENT")) {
       return null;
     }
@@ -39057,7 +39721,7 @@ async function readMemoryStore(profileName, target, limits) {
   };
 }
 async function readMemoryEntries(filePath) {
-  const raw = await readFile19(filePath, "utf8").catch((error) => {
+  const raw = await readFile20(filePath, "utf8").catch((error) => {
     if (isNodeError22(error, "ENOENT")) {
       return "";
     }
@@ -39084,7 +39748,7 @@ async function writeMemoryEntries(profileName, target, entries) {
   );
 }
 function memoryFilePath(profileName, target) {
-  return path32.join(
+  return path33.join(
     resolveMemoryDir(profileName),
     target === "user" ? "USER.md" : "MEMORY.md"
   );
@@ -39144,7 +39808,7 @@ async function readCustomProviderSetupSummary(profileName) {
     configurable: true,
     configured: true,
     configurationIssue: null,
-    providerConfigPath: path32.join(
+    providerConfigPath: path33.join(
       resolveHermesProfileDir(profileName),
       "<provider>.json"
     ),
@@ -39222,7 +39886,7 @@ async function readProviderConfigurationStatus(profileName, provider) {
     const config2 = await readJsonObject(
       memoryProviderConfigPath(profileName, "honcho") ?? ""
     );
-    return isConfiguredEnvValue(env.HONCHO_API_KEY) || isConfiguredEnvValue(readString24(config2.apiKey)) || isConfiguredEnvValue(readString24(config2.api_key)) || isConfiguredEnvValue(readString24(config2.baseUrl)) ? { configured: true, issue: null } : {
+    return isConfiguredEnvValue(env.HONCHO_API_KEY) || isConfiguredEnvValue(readString25(config2.apiKey)) || isConfiguredEnvValue(readString25(config2.api_key)) || isConfiguredEnvValue(readString25(config2.baseUrl)) ? { configured: true, issue: null } : {
       configured: false,
       issue: "Honcho \u9700\u8981\u5148\u586B\u5199 API Key\uFF0C\u6216\u5728 honcho.json \u914D\u7F6E self-hosted baseUrl\u3002"
     };
@@ -39231,7 +39895,7 @@ async function readProviderConfigurationStatus(profileName, provider) {
     const config2 = await readJsonObject(
       memoryProviderConfigPath(profileName, "mem0") ?? ""
     );
-    return isConfiguredEnvValue(env.MEM0_API_KEY) || isConfiguredEnvValue(readString24(config2.api_key)) ? { configured: true, issue: null } : {
+    return isConfiguredEnvValue(env.MEM0_API_KEY) || isConfiguredEnvValue(readString25(config2.api_key)) ? { configured: true, issue: null } : {
       configured: false,
       issue: "Mem0 \u9700\u8981\u5148\u5728\u672C\u9875\u586B\u5199 API Key\uFF0CLink \u4F1A\u5199\u5165\u5F53\u524D Profile \u7684 .env\u3002"
     };
@@ -39273,7 +39937,7 @@ async function readProviderConfigurationStatus(profileName, provider) {
     memoryProviderConfigPath(profileName, provider) ?? ""
   );
   const mode = normalizeHindsightMode(config.mode ?? env.HINDSIGHT_MODE);
-  const apiKey = readString24(config.apiKey) ?? readString24(config.api_key) ?? env.HINDSIGHT_API_KEY;
+  const apiKey = readString25(config.apiKey) ?? readString25(config.api_key) ?? env.HINDSIGHT_API_KEY;
   if (mode === "cloud") {
     return isConfiguredEnvValue(apiKey) ? { configured: true, issue: null } : {
       configured: false,
@@ -39281,15 +39945,15 @@ async function readProviderConfigurationStatus(profileName, provider) {
     };
   }
   if (mode === "local_external") {
-    const apiUrl = readString24(config.api_url) ?? env.HINDSIGHT_API_URL ?? HINDSIGHT_DEFAULT_LOCAL_URL;
+    const apiUrl = readString25(config.api_url) ?? env.HINDSIGHT_API_URL ?? HINDSIGHT_DEFAULT_LOCAL_URL;
     return isConfiguredEnvValue(apiUrl) ? { configured: true, issue: null } : {
       configured: false,
       issue: "Hindsight local_external \u9700\u8981\u914D\u7F6E\u53EF\u8BBF\u95EE\u7684 API URL\u3002"
     };
   }
   if (mode === "local_embedded") {
-    const llmProvider = readString24(config.llm_provider) ?? "openai";
-    const llmModel = readString24(config.llm_model);
+    const llmProvider = readString25(config.llm_provider) ?? "openai";
+    const llmModel = readString25(config.llm_model);
     if (!llmModel) {
       return {
         configured: false,
@@ -39297,7 +39961,7 @@ async function readProviderConfigurationStatus(profileName, provider) {
       };
     }
     if (llmProvider === "openai_compatible" && !isConfiguredEnvValue(
-      readString24(config.llm_base_url) ?? env.HINDSIGHT_API_LLM_BASE_URL
+      readString25(config.llm_base_url) ?? env.HINDSIGHT_API_LLM_BASE_URL
     )) {
       return {
         configured: false,
@@ -39305,7 +39969,7 @@ async function readProviderConfigurationStatus(profileName, provider) {
       };
     }
     if (!["ollama", "lmstudio", "openai_compatible"].includes(llmProvider) && !isConfiguredEnvValue(
-      readString24(config.llmApiKey) ?? readString24(config.llm_api_key) ?? env.HINDSIGHT_LLM_API_KEY
+      readString25(config.llmApiKey) ?? readString25(config.llm_api_key) ?? env.HINDSIGHT_LLM_API_KEY
     )) {
       return {
         configured: false,
@@ -39361,8 +40025,8 @@ async function readProviderSettings(profileName, provider) {
       secretSetting(
         "apiKey",
         "API Key",
-        env.HONCHO_API_KEY ?? readString24(config.apiKey) ?? readString24(config.api_key),
-        isConfiguredEnvValue(env.HONCHO_API_KEY) || isConfiguredEnvValue(readString24(config.apiKey)) || isConfiguredEnvValue(readString24(config.api_key))
+        env.HONCHO_API_KEY ?? readString25(config.apiKey) ?? readString25(config.api_key),
+        isConfiguredEnvValue(env.HONCHO_API_KEY) || isConfiguredEnvValue(readString25(config.apiKey)) || isConfiguredEnvValue(readString25(config.api_key))
       ),
       stringSetting("workspace", "Workspace", config.workspace ?? "hermes"),
       stringSetting("peerName", "\u7528\u6237 Peer", config.peerName ?? ""),
@@ -39404,8 +40068,8 @@ async function readProviderSettings(profileName, provider) {
       secretSetting(
         "apiKey",
         "API Key",
-        env.MEM0_API_KEY ?? readString24(config.apiKey) ?? readString24(config.api_key),
-        isConfiguredEnvValue(env.MEM0_API_KEY) || isConfiguredEnvValue(readString24(config.apiKey)) || isConfiguredEnvValue(readString24(config.api_key))
+        env.MEM0_API_KEY ?? readString25(config.apiKey) ?? readString25(config.api_key),
+        isConfiguredEnvValue(env.MEM0_API_KEY) || isConfiguredEnvValue(readString25(config.apiKey)) || isConfiguredEnvValue(readString25(config.api_key))
       ),
       stringSetting("userId", "User ID", config.user_id ?? "hermes-user"),
       stringSetting("agentId", "Agent ID", config.agent_id ?? "hermes"),
@@ -39490,8 +40154,8 @@ async function readProviderSettings(profileName, provider) {
       secretSetting(
         "apiKey",
         "Hindsight API Key",
-        env.HINDSIGHT_API_KEY ?? readString24(config.apiKey) ?? readString24(config.api_key),
-        isConfiguredEnvValue(env.HINDSIGHT_API_KEY) || isConfiguredEnvValue(readString24(config.apiKey)) || isConfiguredEnvValue(readString24(config.api_key))
+        env.HINDSIGHT_API_KEY ?? readString25(config.apiKey) ?? readString25(config.api_key),
+        isConfiguredEnvValue(env.HINDSIGHT_API_KEY) || isConfiguredEnvValue(readString25(config.apiKey)) || isConfiguredEnvValue(readString25(config.api_key))
       ),
       stringSetting(
         "bankId",
@@ -39513,8 +40177,8 @@ async function readProviderSettings(profileName, provider) {
       secretSetting(
         "llmApiKey",
         "LLM API Key",
-        env.HINDSIGHT_LLM_API_KEY ?? readString24(config.llmApiKey) ?? readString24(config.llm_api_key),
-        isConfiguredEnvValue(env.HINDSIGHT_LLM_API_KEY) || isConfiguredEnvValue(readString24(config.llmApiKey)) || isConfiguredEnvValue(readString24(config.llm_api_key))
+        env.HINDSIGHT_LLM_API_KEY ?? readString25(config.llmApiKey) ?? readString25(config.llm_api_key),
+        isConfiguredEnvValue(env.HINDSIGHT_LLM_API_KEY) || isConfiguredEnvValue(readString25(config.llmApiKey)) || isConfiguredEnvValue(readString25(config.llm_api_key))
       ),
       booleanSetting("autoRecall", "\u81EA\u52A8\u56DE\u5FC6", config.auto_recall ?? true),
       booleanSetting("autoRetain", "\u81EA\u52A8\u6C89\u6DC0", config.auto_retain ?? true),
@@ -39538,7 +40202,7 @@ async function readProviderSettings(profileName, provider) {
       stringSetting(
         "dbPath",
         "SQLite \u6570\u636E\u5E93\u8DEF\u5F84",
-        config.db_path ?? path32.join(resolveHermesProfileDir(profileName), "memory_store.db")
+        config.db_path ?? path33.join(resolveHermesProfileDir(profileName), "memory_store.db")
       ),
       booleanSetting("autoExtract", "\u4F1A\u8BDD\u7ED3\u675F\u81EA\u52A8\u62BD\u53D6", config.auto_extract ?? false),
       numberSetting("defaultTrust", "\u9ED8\u8BA4\u4FE1\u4EFB\u5206", config.default_trust ?? 0.5),
@@ -39574,7 +40238,7 @@ async function readProviderSettings(profileName, provider) {
       stringSetting(
         "workingDirectory",
         "\u5DE5\u4F5C\u76EE\u5F55",
-        path32.join(resolveHermesProfileDir(profileName), "byterover"),
+        path33.join(resolveHermesProfileDir(profileName), "byterover"),
         false
       )
     ];
@@ -39583,16 +40247,16 @@ async function readProviderSettings(profileName, provider) {
 }
 function memoryProviderConfigPath(profileName, provider) {
   if (provider === "honcho") {
-    return path32.join(resolveHermesProfileDir(profileName), "honcho.json");
+    return path33.join(resolveHermesProfileDir(profileName), "honcho.json");
   }
   if (provider === "mem0") {
-    return path32.join(resolveHermesProfileDir(profileName), "mem0.json");
+    return path33.join(resolveHermesProfileDir(profileName), "mem0.json");
   }
   if (provider === "supermemory") {
-    return path32.join(resolveHermesProfileDir(profileName), "supermemory.json");
+    return path33.join(resolveHermesProfileDir(profileName), "supermemory.json");
   }
   if (provider === "hindsight") {
-    return path32.join(
+    return path33.join(
       resolveHermesProfileDir(profileName),
       "hindsight",
       "config.json"
@@ -39601,19 +40265,19 @@ function memoryProviderConfigPath(profileName, provider) {
   return null;
 }
 function customProviderConfigPath(profileName, provider) {
-  return path32.join(
+  return path33.join(
     resolveHermesProfileDir(profileName),
     `${normalizeCustomProviderId(provider)}.json`
   );
 }
 function customProviderRegistryPath(profileName) {
-  return path32.join(
+  return path33.join(
     resolveHermesProfileDir(profileName),
     CUSTOM_PROVIDER_REGISTRY_FILE
   );
 }
 async function readCustomProviderRegistry(profileName) {
-  const raw = await readFile19(customProviderRegistryPath(profileName), "utf8").catch(
+  const raw = await readFile20(customProviderRegistryPath(profileName), "utf8").catch(
     (error) => {
       if (isNodeError22(error, "ENOENT")) {
         return "";
@@ -39633,11 +40297,11 @@ async function readCustomProviderRegistry(profileName) {
         return { id: id2, label: id2, description: "\u81EA\u5B9A\u4E49 memory provider\u3002" };
       }
       const record = toRecord22(item);
-      const id = normalizeCustomProviderId(readString24(record.id) ?? "");
+      const id = normalizeCustomProviderId(readString25(record.id) ?? "");
       return {
         id,
-        label: readString24(record.label) ?? id,
-        description: readString24(record.description) ?? "\u81EA\u5B9A\u4E49 memory provider\u3002"
+        label: readString25(record.label) ?? id,
+        description: readString25(record.description) ?? "\u81EA\u5B9A\u4E49 memory provider\u3002"
       };
     }).filter((item) => item.id);
   } catch {
@@ -39659,7 +40323,7 @@ async function saveCustomProviderRegistryEntry(profileName, provider) {
   );
 }
 async function discoverUserMemoryProviderDescriptors(profileName) {
-  const pluginsDir = path32.join(resolveHermesProfileDir(profileName), "plugins");
+  const pluginsDir = path33.join(resolveHermesProfileDir(profileName), "plugins");
   const entries = await readdir10(pluginsDir, { withFileTypes: true }).catch(
     (error) => {
       if (isNodeError22(error, "ENOENT")) {
@@ -39679,21 +40343,21 @@ async function discoverUserMemoryProviderDescriptors(profileName) {
     } catch {
       continue;
     }
-    const providerDir = path32.join(pluginsDir, entry.name);
+    const providerDir = path33.join(pluginsDir, entry.name);
     if (!await isMemoryProviderPluginDir(providerDir)) {
       continue;
     }
     const meta = await readPluginMetadata(providerDir);
     descriptors.push({
       id: providerId,
-      label: readString24(meta.name) ?? providerId,
-      description: readString24(meta.description) ?? "\u81EA\u5B9A\u4E49 memory provider\u3002"
+      label: readString25(meta.name) ?? providerId,
+      description: readString25(meta.description) ?? "\u81EA\u5B9A\u4E49 memory provider\u3002"
     });
   }
   return descriptors;
 }
 async function isUserMemoryProviderInstalled(profileName, provider) {
-  const providerDir = path32.join(
+  const providerDir = path33.join(
     resolveHermesProfileDir(profileName),
     "plugins",
     normalizeCustomProviderId(provider)
@@ -39701,7 +40365,7 @@ async function isUserMemoryProviderInstalled(profileName, provider) {
   return isMemoryProviderPluginDir(providerDir);
 }
 async function isMemoryProviderPluginDir(providerDir) {
-  const source = await readFile19(path32.join(providerDir, "__init__.py"), "utf8").catch(
+  const source = await readFile20(path33.join(providerDir, "__init__.py"), "utf8").catch(
     (error) => {
       if (isNodeError22(error, "ENOENT")) {
         return "";
@@ -39713,7 +40377,7 @@ async function isMemoryProviderPluginDir(providerDir) {
   return sample.includes("register_memory_provider") || sample.includes("MemoryProvider");
 }
 async function readPluginMetadata(providerDir) {
-  const raw = await readFile19(path32.join(providerDir, "plugin.yaml"), "utf8").catch(
+  const raw = await readFile20(path33.join(providerDir, "plugin.yaml"), "utf8").catch(
     (error) => {
       if (isNodeError22(error, "ENOENT")) {
         return "";
@@ -39725,10 +40389,10 @@ async function readPluginMetadata(providerDir) {
 }
 async function resolveByteRoverCli() {
   const candidates = [
-    ...(process.env.PATH ?? "").split(path32.delimiter).filter(Boolean).map((dir) => path32.join(dir, "brv")),
-    path32.join(process.env.HOME ?? "", ".brv-cli", "bin", "brv"),
+    ...(process.env.PATH ?? "").split(path33.delimiter).filter(Boolean).map((dir) => path33.join(dir, "brv")),
+    path33.join(process.env.HOME ?? "", ".brv-cli", "bin", "brv"),
     "/usr/local/bin/brv",
-    path32.join(process.env.HOME ?? "", ".npm-global", "bin", "brv")
+    path33.join(process.env.HOME ?? "", ".npm-global", "bin", "brv")
   ].filter(Boolean);
   for (const candidate of candidates) {
     const found = await access3(candidate).then(() => true).catch(() => false);
@@ -39739,7 +40403,7 @@ async function resolveByteRoverCli() {
   return null;
 }
 async function readHolographicProviderConfig(profileName) {
-  const raw = await readFile19(resolveHermesConfigPath(profileName), "utf8").catch(
+  const raw = await readFile20(resolveHermesConfigPath(profileName), "utf8").catch(
     (error) => {
       if (isNodeError22(error, "ENOENT")) {
         return "";
@@ -39753,7 +40417,7 @@ async function readHolographicProviderConfig(profileName) {
 }
 async function patchHolographicProviderConfig(profileName, patch) {
   const configPath = resolveHermesConfigPath(profileName);
-  const existingRaw = await readFile19(configPath, "utf8").catch(
+  const existingRaw = await readFile20(configPath, "utf8").catch(
     (error) => {
       if (isNodeError22(error, "ENOENT")) {
         return null;
@@ -39789,8 +40453,8 @@ async function patchHermesMemoryEnv(profileName, patch) {
   if (entries.length === 0) {
     return;
   }
-  const envPath = path32.join(resolveHermesProfileDir(profileName), ".env");
-  const existingRaw = await readFile19(envPath, "utf8").catch((error) => {
+  const envPath = path33.join(resolveHermesProfileDir(profileName), ".env");
+  const existingRaw = await readFile20(envPath, "utf8").catch((error) => {
     if (isNodeError22(error, "ENOENT")) {
       return "";
     }
@@ -39849,7 +40513,7 @@ function isMemoryEnvKeyWritable(key) {
   ].includes(key);
 }
 function normalizeHindsightMode(value) {
-  const mode = readString24(value) ?? "cloud";
+  const mode = readString25(value) ?? "cloud";
   return mode === "local" ? "local_embedded" : mode;
 }
 function normalizeHttpUrl2(value) {
@@ -39918,31 +40582,31 @@ function parseJsonObject2(text) {
   }
 }
 function readHindsightError(json) {
-  const detail = readString24(json.detail) ?? readString24(json.error);
+  const detail = readString25(json.detail) ?? readString25(json.error);
   return detail ? `\uFF1A${detail}` : "";
 }
 function hindsightSemanticIssue(pathName, json) {
   if (pathName === "/health") {
-    const status = readString24(json.status);
+    const status = readString25(json.status);
     return status && ["healthy", "ok"].includes(status.toLowerCase()) ? null : `\u5065\u5EB7\u72B6\u6001\u5F02\u5E38\uFF1A${status ?? "unknown"}`;
   }
   return null;
 }
 function summarizeHindsightProbe(pathName, json) {
   if (pathName === "/health") {
-    const status = readString24(json.status) ?? "ok";
-    const database = readString24(json.database);
+    const status = readString25(json.status) ?? "ok";
+    const database = readString25(json.database);
     return database ? `${status}, database ${database}` : status;
   }
   if (pathName === "/version") {
-    const version = readString24(json.api_version);
+    const version = readString25(json.api_version);
     return version ? `API ${version}` : "version endpoint reachable";
   }
-  const bankId = readString24(json.bank_id);
+  const bankId = readString25(json.bank_id);
   return bankId ? `bank ${bankId} reachable` : "bank config reachable";
 }
 async function readActiveMemoryProvider(profileName) {
-  const raw = await readFile19(
+  const raw = await readFile20(
     resolveHermesConfigPath(profileName),
     "utf8"
   ).catch((error) => {
@@ -39953,14 +40617,14 @@ async function readActiveMemoryProvider(profileName) {
   });
   const config = raw ? toRecord22(YAML6.parse(raw)) : {};
   const memory = toRecord22(config.memory);
-  const provider = readString24(memory.provider);
+  const provider = readString25(memory.provider);
   if (!provider || provider === "built-in" || provider === "builtin" || provider === "built_in") {
     return null;
   }
   return provider;
 }
 async function patchJsonProviderConfig(profileName, relativePath, patch) {
-  const configPath = path32.join(
+  const configPath = path33.join(
     resolveHermesProfileDir(profileName),
     relativePath
   );
@@ -39978,7 +40642,7 @@ async function patchJsonProviderConfig(profileName, relativePath, patch) {
   );
 }
 async function readJsonObject(filePath) {
-  const raw = await readFile19(filePath, "utf8").catch((error) => {
+  const raw = await readFile20(filePath, "utf8").catch((error) => {
     if (isNodeError22(error, "ENOENT")) {
       return "{}";
     }
@@ -39989,7 +40653,7 @@ async function readJsonObject(filePath) {
   } catch {
     throw new HermesMemoryError(
       "memory_provider_config_invalid",
-      `${path32.basename(filePath)} \u4E0D\u662F\u6709\u6548\u7684 JSON \u914D\u7F6E\u6587\u4EF6\u3002`
+      `${path33.basename(filePath)} \u4E0D\u662F\u6709\u6548\u7684 JSON \u914D\u7F6E\u6587\u4EF6\u3002`
     );
   }
 }
@@ -40010,7 +40674,7 @@ function stringSetting(key, label, value, editable = true) {
   return {
     key,
     label,
-    value: readString24(value) ?? "",
+    value: readString25(value) ?? "",
     editable,
     kind: "string"
   };
@@ -40022,7 +40686,7 @@ function secretSetting(key, label, value, configured) {
     value: "",
     editable: true,
     kind: "secret",
-    configured: configured || isConfiguredEnvValue(readString24(value))
+    configured: configured || isConfiguredEnvValue(readString25(value))
   };
 }
 function textSetting(key, label, value, editable = true) {
@@ -40035,11 +40699,11 @@ function textSetting(key, label, value, editable = true) {
   };
 }
 function selectSetting(key, label, value, options, editable = true) {
-  const stringValue = readString24(value) ?? options[0] ?? null;
+  const stringValue = readString25(value) ?? options[0] ?? null;
   return { key, label, value: stringValue, editable, kind: "select", options };
 }
 async function readMemoryLimits(profileName) {
-  const raw = await readFile19(
+  const raw = await readFile20(
     resolveHermesConfigPath(profileName),
     "utf8"
   ).catch((error) => {
@@ -40108,7 +40772,7 @@ function hashString(value) {
 function toRecord22(value) {
   return typeof value === "object" && value !== null && !Array.isArray(value) ? value : {};
 }
-function readString24(value) {
+function readString25(value) {
   return typeof value === "string" && value.trim() ? value.trim() : null;
 }
 function readPositiveInteger4(value) {
@@ -40267,7 +40931,7 @@ function registerProfileMemoryRoutes(router, options) {
   );
 }
 function readMemoryTarget(body) {
-  const raw = readString22(body, "target");
+  const raw = readString23(body, "target");
   if (raw === "memory" || raw === "user") {
     return raw;
   }
@@ -40278,7 +40942,7 @@ function readMemoryTarget(body) {
   );
 }
 function readMemoryResetTarget(body) {
-  const raw = readString22(body, "target") ?? "all";
+  const raw = readString23(body, "target") ?? "all";
   if (raw === "all" || raw === "memory" || raw === "user") {
     return raw;
   }
@@ -40289,7 +40953,7 @@ function readMemoryResetTarget(body) {
   );
 }
 function readRequiredMemoryContent(body) {
-  const content = readString22(body, "content") ?? readString22(body, "text");
+  const content = readString23(body, "content") ?? readString23(body, "text");
   if (!content) {
     throw new LinkHttpError(
       400,
@@ -40300,7 +40964,7 @@ function readRequiredMemoryContent(body) {
   return content;
 }
 function readRequiredMemoryMatch(body) {
-  const oldText = readString22(body, "old_text") ?? readString22(body, "oldText") ?? readString22(body, "match");
+  const oldText = readString23(body, "old_text") ?? readString23(body, "oldText") ?? readString23(body, "match");
   if (!oldText) {
     throw new LinkHttpError(
       400,
@@ -40311,7 +40975,7 @@ function readRequiredMemoryMatch(body) {
   return oldText;
 }
 function readRequiredMemoryProvider(body) {
-  const provider = readString22(body, "provider") ?? readString22(body, "provider_id") ?? readString22(body, "providerId");
+  const provider = readString23(body, "provider") ?? readString23(body, "provider_id") ?? readString23(body, "providerId");
   if (!provider) {
     throw new LinkHttpError(
       400,
@@ -40341,7 +41005,7 @@ function readMemorySettingsPatch(body, options = {}) {
       input.userCharLimit = userCharLimit;
     }
   }
-  const mode = readString22(body, "mode");
+  const mode = readString23(body, "mode");
   if (mode) {
     input.mode = mode;
   }
@@ -40357,7 +41021,7 @@ function readMemorySettingsPatch(body, options = {}) {
   if (bankId !== void 0) {
     input.bankId = bankId;
   }
-  const llmProvider = readString22(body, "llm_provider") ?? readString22(body, "llmProvider");
+  const llmProvider = readString23(body, "llm_provider") ?? readString23(body, "llmProvider");
   if (llmProvider) {
     input.llmProvider = llmProvider;
   }
@@ -40393,11 +41057,11 @@ function readMemorySettingsPatch(body, options = {}) {
   if (autoRetain !== void 0) {
     input.autoRetain = autoRetain;
   }
-  const memoryMode = readString22(body, "memory_mode") ?? readString22(body, "memoryMode");
+  const memoryMode = readString23(body, "memory_mode") ?? readString23(body, "memoryMode");
   if (memoryMode) {
     input.memoryMode = memoryMode;
   }
-  const recallBudget = readString22(body, "recall_budget") ?? readString22(body, "recallBudget");
+  const recallBudget = readString23(body, "recall_budget") ?? readString23(body, "recallBudget");
   if (recallBudget) {
     input.recallBudget = recallBudget;
   }
@@ -40413,11 +41077,11 @@ function readMemorySettingsPatch(body, options = {}) {
   if (profileFrequency !== void 0) {
     input.profileFrequency = profileFrequency;
   }
-  const captureMode = readString22(body, "capture_mode") ?? readString22(body, "captureMode");
+  const captureMode = readString23(body, "capture_mode") ?? readString23(body, "captureMode");
   if (captureMode) {
     input.captureMode = captureMode;
   }
-  const searchMode = readString22(body, "search_mode") ?? readString22(body, "searchMode");
+  const searchMode = readString23(body, "search_mode") ?? readString23(body, "searchMode");
   if (searchMode) {
     input.searchMode = searchMode;
   }
@@ -40451,11 +41115,11 @@ function readMemorySettingsPatch(body, options = {}) {
   if (aiPeer !== void 0) {
     input.aiPeer = aiPeer;
   }
-  const recallMode = readString22(body, "recall_mode") ?? readString22(body, "recallMode");
+  const recallMode = readString23(body, "recall_mode") ?? readString23(body, "recallMode");
   if (recallMode) {
     input.recallMode = recallMode;
   }
-  const writeFrequency = readString22(body, "write_frequency") ?? readString22(body, "writeFrequency");
+  const writeFrequency = readString23(body, "write_frequency") ?? readString23(body, "writeFrequency");
   if (writeFrequency) {
     input.writeFrequency = writeFrequency;
   }
@@ -40463,7 +41127,7 @@ function readMemorySettingsPatch(body, options = {}) {
   if (saveMessages !== void 0) {
     input.saveMessages = saveMessages;
   }
-  const sessionStrategy = readString22(body, "session_strategy") ?? readString22(body, "sessionStrategy");
+  const sessionStrategy = readString23(body, "session_strategy") ?? readString23(body, "sessionStrategy");
   if (sessionStrategy) {
     input.sessionStrategy = sessionStrategy;
   }
@@ -40612,8 +41276,8 @@ function toMemoryHttpError(error) {
 }
 
 // src/hermes/skills.ts
-import { readFile as readFile20, readdir as readdir11 } from "fs/promises";
-import path33 from "path";
+import { readFile as readFile21, readdir as readdir11 } from "fs/promises";
+import path34 from "path";
 import YAML7 from "yaml";
 var HermesSkillNotFoundError = class extends Error {
   constructor(skillName) {
@@ -40627,7 +41291,7 @@ var EXCLUDED_SKILL_DIRS = /* @__PURE__ */ new Set([".git", ".github", ".hub"]);
 async function listHermesProfileSkills(profileName, paths = resolveRuntimePaths()) {
   const profile = await readExistingProfile(profileName, paths);
   const profileDir = resolveHermesProfileDir(profile.name);
-  const skillsRoot = path33.join(profileDir, "skills");
+  const skillsRoot = path34.join(profileDir, "skills");
   const [skillFiles, disabled, provenance] = await Promise.all([
     findSkillFiles(skillsRoot),
     readDisabledSkillNames(resolveHermesConfigPath(profile.name)),
@@ -40718,7 +41382,7 @@ async function collectSkillFiles(directory, results) {
     if (EXCLUDED_SKILL_DIRS.has(entry.name)) {
       continue;
     }
-    const entryPath = path33.join(directory, entry.name);
+    const entryPath = path34.join(directory, entry.name);
     if (entry.isDirectory()) {
       await collectSkillFiles(entryPath, results);
       continue;
@@ -40729,7 +41393,7 @@ async function collectSkillFiles(directory, results) {
   }
 }
 async function readSkillMetadata(input) {
-  const raw = await readFile20(input.skillFile, "utf8").catch(
+  const raw = await readFile21(input.skillFile, "utf8").catch(
     (error) => {
       if (isNodeError23(error, "ENOENT") || isNodeError23(error, "EACCES")) {
         return null;
@@ -40740,16 +41404,16 @@ async function readSkillMetadata(input) {
   if (raw === null) {
     return null;
   }
-  const skillDir = path33.dirname(input.skillFile);
+  const skillDir = path34.dirname(input.skillFile);
   const { frontmatter, body } = parseSkillDocument(raw.slice(0, 4e3));
   const name = normalizeSkillName(
-    readString25(frontmatter.name) ?? path33.basename(skillDir)
+    readString26(frontmatter.name) ?? path34.basename(skillDir)
   );
   if (!name) {
     return null;
   }
   const description = normalizeDescription(
-    readString25(frontmatter.description) ?? firstBodyDescription(body)
+    readString26(frontmatter.description) ?? firstBodyDescription(body)
   );
   const provenance = input.provenance.get(name) ?? {
     source: "local",
@@ -40762,7 +41426,7 @@ async function readSkillMetadata(input) {
     enabled: !input.disabled.has(name),
     source: provenance.source,
     trust: provenance.trust,
-    relativePath: path33.relative(input.skillsRoot, skillDir)
+    relativePath: path34.relative(input.skillsRoot, skillDir)
   };
 }
 function parseSkillDocument(raw) {
@@ -40783,8 +41447,8 @@ function parseSkillDocument(raw) {
   }
 }
 function categoryFromPath(skillsRoot, skillFile) {
-  const relative = path33.relative(skillsRoot, skillFile);
-  const parts = relative.split(path33.sep).filter(Boolean);
+  const relative = path34.relative(skillsRoot, skillFile);
+  const parts = relative.split(path34.sep).filter(Boolean);
   return parts.length >= 3 ? parts[0] : null;
 }
 function firstBodyDescription(body) {
@@ -40807,7 +41471,7 @@ function normalizeDescription(value) {
   return `${description.slice(0, MAX_DESCRIPTION_LENGTH - 3)}...`;
 }
 async function readDisabledSkillNames(configPath) {
-  const raw = await readFile20(configPath, "utf8").catch((error) => {
+  const raw = await readFile21(configPath, "utf8").catch((error) => {
     if (isNodeError23(error, "ENOENT")) {
       return "";
     }
@@ -40831,7 +41495,7 @@ async function readSkillProvenance(root) {
   return provenance;
 }
 async function readBundledSkillNames(root) {
-  const raw = await readFile20(path33.join(root, ".bundled_manifest"), "utf8").catch(
+  const raw = await readFile21(path34.join(root, ".bundled_manifest"), "utf8").catch(
     (error) => {
       if (isNodeError23(error, "ENOENT")) {
         return "";
@@ -40854,7 +41518,7 @@ async function readBundledSkillNames(root) {
   return names;
 }
 async function readHubInstalledSkills(root) {
-  const raw = await readFile20(path33.join(root, ".hub", "lock.json"), "utf8").catch(
+  const raw = await readFile21(path34.join(root, ".hub", "lock.json"), "utf8").catch(
     (error) => {
       if (isNodeError23(error, "ENOENT")) {
         return "";
@@ -40876,8 +41540,8 @@ async function readHubInstalledSkills(root) {
   for (const [name, rawEntry] of Object.entries(installed2)) {
     const entry = toRecord23(rawEntry);
     result.set(normalizeSkillName(name), {
-      source: readString25(entry.source) ?? "hub",
-      trust: readString25(entry.trust_level) ?? null
+      source: readString26(entry.source) ?? "hub",
+      trust: readString26(entry.trust_level) ?? null
     });
   }
   return result;
@@ -40926,7 +41590,7 @@ function compareCategoryNames(left, right) {
   return left.localeCompare(right);
 }
 async function readHermesConfigDocument4(configPath) {
-  const existingRaw = await readFile20(configPath, "utf8").catch(
+  const existingRaw = await readFile21(configPath, "utf8").catch(
     (error) => {
       if (isNodeError23(error, "ENOENT")) {
         return null;
@@ -40961,7 +41625,7 @@ function readStringList6(value) {
   }
   return value.filter((item) => typeof item === "string").map((item) => item.trim()).filter(Boolean);
 }
-function readString25(value) {
+function readString26(value) {
   return typeof value === "string" && value.trim() ? value.trim() : null;
 }
 function toRecord23(value) {
@@ -41333,7 +41997,7 @@ function registerRunRoutes(router, options) {
     await authenticateRequest(ctx, paths);
     const language = readPreferredLanguage(ctx);
     const body = await readJsonBody(ctx.req);
-    const input = readString22(body, "input");
+    const input = readString23(body, "input");
     if (!input) {
       throw new LinkHttpError(400, "run_input_required", "input is required");
     }
@@ -41341,12 +42005,12 @@ function registerRunRoutes(router, options) {
     ctx.body = await createHermesRun(
       {
         input,
-        instructions: readString22(body, "instructions") ?? void 0,
+        instructions: readString23(body, "instructions") ?? void 0,
         conversation_history: readConversationHistory(
           body.conversation_history ?? body.conversationHistory
         ),
-        session_id: readString22(body, "session_id") ?? readString22(body, "sessionId") ?? void 0,
-        session_key: readString22(body, "session_key") ?? readString22(body, "sessionKey") ?? void 0
+        session_id: readString23(body, "session_id") ?? readString23(body, "sessionId") ?? void 0,
+        session_key: readString23(body, "session_key") ?? readString23(body, "sessionKey") ?? void 0
       },
       { logger, profileName: readOptionalProfileName(body), language }
     );
@@ -41521,8 +42185,8 @@ function readModelList(payload) {
 // src/hermes/updates.ts
 import { EventEmitter as EventEmitter3 } from "events";
 import { spawn as spawn4 } from "child_process";
-import { mkdir as mkdir14, readFile as readFile21, rm as rm8 } from "fs/promises";
-import path34 from "path";
+import { mkdir as mkdir14, readFile as readFile22, rm as rm8 } from "fs/promises";
+import path35 from "path";
 var SERVER_HERMES_RELEASES_LATEST_PATH = "/api/v1/hermes-agent/releases/latest";
 var RELEASE_CACHE_TTL_MS = 6 * 60 * 60 * 1e3;
 var RELEASE_FETCH_TIMEOUT_MS = 5e3;
@@ -41759,20 +42423,20 @@ function normalizeServerReleaseSnapshot(payload) {
   const remote = toNullableRecord(snapshot.remote);
   return {
     remote: remote ? normalizeServerRelease(remote) : null,
-    cacheState: readString26(snapshot, "cache_state") ?? readString26(snapshot, "cacheState"),
-    issue: readString26(snapshot, "issue")
+    cacheState: readString27(snapshot, "cache_state") ?? readString27(snapshot, "cacheState"),
+    issue: readString27(snapshot, "issue")
   };
 }
 function normalizeServerRelease(payload) {
-  const tag = readString26(payload, "tag");
-  const name = readString26(payload, "name");
+  const tag = readString27(payload, "tag");
+  const name = readString27(payload, "name");
   return {
-    version: readString26(payload, "version") ?? extractSemver(name) ?? extractTagSemver(tag),
+    version: readString27(payload, "version") ?? extractSemver(name) ?? extractTagSemver(tag),
     tag,
     name,
-    releaseUrl: readString26(payload, "releaseUrl") ?? readString26(payload, "release_url"),
-    publishedAt: readString26(payload, "publishedAt") ?? readString26(payload, "published_at"),
-    fetchedAt: readString26(payload, "fetchedAt") ?? readString26(payload, "fetched_at") ?? (/* @__PURE__ */ new Date()).toISOString()
+    releaseUrl: readString27(payload, "releaseUrl") ?? readString27(payload, "release_url"),
+    publishedAt: readString27(payload, "publishedAt") ?? readString27(payload, "published_at"),
+    fetchedAt: readString27(payload, "fetchedAt") ?? readString27(payload, "fetched_at") ?? (/* @__PURE__ */ new Date()).toISOString()
   };
 }
 async function readReleaseCache(paths) {
@@ -41791,7 +42455,7 @@ async function writeUpdateState(paths, state) {
   await writeJsonFile(updateStatePath(paths), state);
 }
 async function readUpdateLogLines(paths) {
-  const raw = await readFile21(updateLogPath(paths), "utf8").catch(() => "");
+  const raw = await readFile22(updateLogPath(paths), "utf8").catch(() => "");
   if (!raw.trim()) {
     return [];
   }
@@ -41800,13 +42464,13 @@ async function readUpdateLogLines(paths) {
   );
 }
 function releaseCachePath(paths) {
-  return path34.join(paths.indexesDir, "hermes-release-check.json");
+  return path35.join(paths.indexesDir, "hermes-release-check.json");
 }
 function updateStatePath(paths) {
-  return path34.join(paths.runDir, "hermes-update-state.json");
+  return path35.join(paths.runDir, "hermes-update-state.json");
 }
 function updateLogPath(paths) {
-  return path34.join(paths.logsDir, UPDATE_LOG_FILE);
+  return path35.join(paths.logsDir, UPDATE_LOG_FILE);
 }
 async function clearUpdateLogFiles(paths) {
   const primary = updateLogPath(paths);
@@ -41898,7 +42562,7 @@ function isRecentRunningState2(state) {
   const startedAt = Date.parse(state.started_at);
   return Number.isFinite(startedAt) && Date.now() - startedAt < 3e4;
 }
-function readString26(payload, key) {
+function readString27(payload, key) {
   const value = payload[key];
   return typeof value === "string" && value.trim() ? value.trim() : null;
 }
@@ -41906,13 +42570,13 @@ function readString26(payload, key) {
 // src/link/updates.ts
 import { spawn as spawn6 } from "child_process";
 import { EventEmitter as EventEmitter4 } from "events";
-import { mkdir as mkdir17, readFile as readFile23, rm as rm11 } from "fs/promises";
-import path36 from "path";
+import { mkdir as mkdir17, readFile as readFile24, rm as rm11 } from "fs/promises";
+import path37 from "path";
 
 // src/daemon/process.ts
 import { spawn as spawn5 } from "child_process";
-import { mkdir as mkdir16, readFile as readFile22, rm as rm10, writeFile as writeFile4 } from "fs/promises";
-import path35 from "path";
+import { mkdir as mkdir16, readFile as readFile23, rm as rm10, writeFile as writeFile4 } from "fs/promises";
+import path36 from "path";
 
 // src/daemon/service.ts
 import { createServer } from "http";
@@ -43940,7 +44604,7 @@ async function runDaemonSupervisor(paths = resolveRuntimePaths()) {
   await mkdir16(paths.logsDir, { recursive: true, mode: 448 });
   const log = createRotatingTextLogWriter({
     paths,
-    fileName: path35.basename(daemonLogFile(paths))
+    fileName: path36.basename(daemonLogFile(paths))
   });
   const scriptPath = currentCliScriptPath();
   const write = (chunk) => {
@@ -44120,7 +44784,7 @@ function currentCliScriptPath() {
   return process.argv[1];
 }
 async function readPid(filePath) {
-  const raw = await readFile22(filePath, "utf8").catch(() => null);
+  const raw = await readFile23(filePath, "utf8").catch(() => null);
   if (!raw) {
     return null;
   }
@@ -44239,7 +44903,7 @@ function terminateChild(child, previousForceKillTimer) {
   }
 }
 function supervisorStopIntentPath(paths) {
-  return path35.join(paths.runDir, "supervisor-stop-intent.json");
+  return path36.join(paths.runDir, "supervisor-stop-intent.json");
 }
 async function writeSupervisorStopIntent(paths, pid) {
   await mkdir16(paths.runDir, { recursive: true, mode: 448 });
@@ -44252,7 +44916,7 @@ async function writeSupervisorStopIntent(paths, pid) {
 }
 async function consumeSupervisorStopIntent(paths, pid) {
   const filePath = supervisorStopIntentPath(paths);
-  const raw = await readFile22(filePath, "utf8").catch(() => null);
+  const raw = await readFile23(filePath, "utf8").catch(() => null);
   if (!raw) {
     return false;
   }
@@ -44270,7 +44934,7 @@ async function consumeSupervisorStopIntent(paths, pid) {
 }
 async function clearExpiredSupervisorStopIntent(paths) {
   const filePath = supervisorStopIntentPath(paths);
-  const raw = await readFile22(filePath, "utf8").catch(() => null);
+  const raw = await readFile23(filePath, "utf8").catch(() => null);
   if (!raw) {
     return;
   }
@@ -44719,16 +45383,16 @@ function normalizeServerSnapshot(payload) {
   if (!policy) {
     return {
       remote: null,
-      issue: readString27(snapshot, "issue")
+      issue: readString28(snapshot, "issue")
     };
   }
   const release = toNullableRecord2(snapshot.release);
-  const currentVersion = readString27(policy, "current_version") ?? readString27(policy, "currentVersion");
-  const minSafeVersion = readString27(policy, "min_safe_version") ?? readString27(policy, "minSafeVersion");
+  const currentVersion = readString28(policy, "current_version") ?? readString28(policy, "currentVersion");
+  const minSafeVersion = readString28(policy, "min_safe_version") ?? readString28(policy, "minSafeVersion");
   if (!currentVersion) {
     return {
       remote: null,
-      issue: readString27(snapshot, "issue")
+      issue: readString28(snapshot, "issue")
     };
   }
   return {
@@ -44736,10 +45400,10 @@ function normalizeServerSnapshot(payload) {
       current_version: currentVersion,
       min_safe_version: minSafeVersion,
       target_version: currentVersion,
-      release_url: release ? readString27(release, "release_url") ?? readString27(release, "releaseUrl") : null,
-      published_at: release ? readString27(release, "published_at") ?? readString27(release, "publishedAt") : null
+      release_url: release ? readString28(release, "release_url") ?? readString28(release, "releaseUrl") : null,
+      published_at: release ? readString28(release, "published_at") ?? readString28(release, "publishedAt") : null
     },
-    issue: readString27(snapshot, "issue")
+    issue: readString28(snapshot, "issue")
   };
 }
 async function fetchCurrentLinkReleaseFromServer(options, fetcher, channel) {
@@ -44802,7 +45466,7 @@ async function buildOfficialInstallCommand(options, targetVersion) {
   };
 }
 function buildUnixInstallCommand(installerUrl) {
-  const nodeBinDir = path36.dirname(process.execPath);
+  const nodeBinDir = path37.dirname(process.execPath);
   const fetchScript = [
     quoteShellToken(process.execPath),
     "--input-type=module",
@@ -45063,7 +45727,7 @@ async function writeUpdateState2(paths, state) {
   await writeJsonFile(updateStatePath2(paths), state);
 }
 async function readUpdateLogLines2(paths) {
-  const raw = await readFile23(updateLogPath2(paths), "utf8").catch(() => "");
+  const raw = await readFile24(updateLogPath2(paths), "utf8").catch(() => "");
   if (!raw.trim()) {
     return [];
   }
@@ -45072,10 +45736,10 @@ async function readUpdateLogLines2(paths) {
   );
 }
 function updateStatePath2(paths) {
-  return path36.join(paths.runDir, "link-update-state.json");
+  return path37.join(paths.runDir, "link-update-state.json");
 }
 function updateLogPath2(paths) {
-  return path36.join(paths.logsDir, UPDATE_LOG_FILE2);
+  return path37.join(paths.logsDir, UPDATE_LOG_FILE2);
 }
 async function clearUpdateLogFiles2(paths) {
   const primary = updateLogPath2(paths);
@@ -45153,13 +45817,13 @@ function toRecord26(value) {
 function toNullableRecord2(value) {
   return typeof value === "object" && value !== null ? value : null;
 }
-function readString27(payload, key) {
+function readString28(payload, key) {
   const value = payload[key];
   return typeof value === "string" && value.trim() ? value.trim() : null;
 }
 
 // src/pairing/pairing.ts
-import path37 from "path";
+import path38 from "path";
 import { rm as rm12 } from "fs/promises";
 
 // src/relay/bootstrap.ts
@@ -45499,10 +46163,10 @@ async function loadRequiredIdentity2(paths) {
   }
   return identity;
 }
-async function postServerJson(serverBaseUrl, path38, body, options) {
+async function postServerJson(serverBaseUrl, path39, body, options) {
   let response;
   try {
-    response = await fetch(`${serverBaseUrl.replace(/\/+$/u, "")}${path38}`, {
+    response = await fetch(`${serverBaseUrl.replace(/\/+$/u, "")}${path39}`, {
       method: "POST",
       headers: {
         accept: "application/json",
@@ -45550,10 +46214,10 @@ function pairingErrorSnapshot(stage, error) {
     occurred_at: (/* @__PURE__ */ new Date()).toISOString()
   };
 }
-async function patchServerJson(serverBaseUrl, path38, token, body, options) {
+async function patchServerJson(serverBaseUrl, path39, token, body, options) {
   let response;
   try {
-    response = await fetch(`${serverBaseUrl.replace(/\/+$/u, "")}${path38}`, {
+    response = await fetch(`${serverBaseUrl.replace(/\/+$/u, "")}${path39}`, {
       method: "PATCH",
       headers: {
         accept: "application/json",
@@ -45601,10 +46265,10 @@ function createPairingNetworkError(input) {
   );
 }
 function pairingClaimPath(sessionId, paths) {
-  return path37.join(paths.pairingDir, `${Buffer.from(sessionId).toString("base64url")}.claimed.json`);
+  return path38.join(paths.pairingDir, `${Buffer.from(sessionId).toString("base64url")}.claimed.json`);
 }
 function pairingSessionPath(sessionId, paths) {
-  return path37.join(paths.pairingDir, `${Buffer.from(sessionId).toString("base64url")}.json`);
+  return path38.join(paths.pairingDir, `${Buffer.from(sessionId).toString("base64url")}.json`);
 }
 function qrPreferredUrls(routes) {
   return routes.preferredUrls.filter((url) => !url.includes("/api/v1/relay/links/")).slice(0, 1);
@@ -45677,6 +46341,7 @@ function registerSystemRoutes(router, options) {
         conversation_delete: true,
         conversation_bulk_delete: true,
         conversation_clear_plan: true,
+        conversation_categories: true,
         conversation_cancel: true,
         conversation_queue_controls: true,
         conversation_queue_limit: MAX_CONVERSATION_QUEUED_RUNS,
@@ -45707,8 +46372,8 @@ function registerSystemRoutes(router, options) {
   });
   router.post("/api/v1/pairing/claim", async (ctx) => {
     const body = await readJsonBody(ctx.req);
-    const sessionId = readString22(body, "session_id") ?? readString22(body, "sessionId");
-    const claimToken = readString22(body, "claim_token") ?? readString22(body, "claimToken");
+    const sessionId = readString23(body, "session_id") ?? readString23(body, "sessionId");
+    const claimToken = readString23(body, "claim_token") ?? readString23(body, "claimToken");
     if (!sessionId || !claimToken) {
       throw new LinkHttpError(
         400,
@@ -45719,10 +46384,10 @@ function registerSystemRoutes(router, options) {
     const claimed = await claimPairing({
       sessionId,
       claimToken,
-      deviceLabel: readString22(body, "device_label") ?? readString22(body, "deviceLabel") ?? "HermesPilot App",
-      devicePlatform: readString22(body, "device_platform") ?? readString22(body, "devicePlatform") ?? "unknown",
-      deviceModel: readString22(body, "device_model") ?? readString22(body, "deviceModel"),
-      appInstanceId: readString22(body, "app_instance_id") ?? readString22(body, "appInstanceId"),
+      deviceLabel: readString23(body, "device_label") ?? readString23(body, "deviceLabel") ?? "HermesPilot App",
+      devicePlatform: readString23(body, "device_platform") ?? readString23(body, "devicePlatform") ?? "unknown",
+      deviceModel: readString23(body, "device_model") ?? readString23(body, "deviceModel"),
+      appInstanceId: readString23(body, "app_instance_id") ?? readString23(body, "appInstanceId"),
       paths
     });
     ctx.body = claimed;
@@ -45802,9 +46467,9 @@ function registerSystemRoutes(router, options) {
     const body = await readJsonBody(ctx.req);
     const session = await createDeviceSession(
       {
-        label: readString22(body, "device_label") ?? readString22(body, "deviceLabel") ?? "HermesPilot App",
-        platform: readString22(body, "device_platform") ?? readString22(body, "devicePlatform") ?? "unknown",
-        model: readString22(body, "device_model") ?? readString22(body, "deviceModel"),
+        label: readString23(body, "device_label") ?? readString23(body, "deviceLabel") ?? "HermesPilot App",
+        platform: readString23(body, "device_platform") ?? readString23(body, "devicePlatform") ?? "unknown",
+        model: readString23(body, "device_model") ?? readString23(body, "deviceModel"),
         appInstanceId: auth.appInstanceId
       },
       paths
@@ -45833,7 +46498,7 @@ function registerSystemRoutes(router, options) {
   });
   router.post("/api/v1/auth/refresh", async (ctx) => {
     const body = await readJsonBody(ctx.req);
-    const refreshToken = readString22(body, "refresh_token") ?? readString22(body, "refreshToken");
+    const refreshToken = readString23(body, "refresh_token") ?? readString23(body, "refreshToken");
     if (!refreshToken) {
       throw new LinkHttpError(
         400,
@@ -45844,10 +46509,10 @@ function registerSystemRoutes(router, options) {
     const session = await refreshDeviceSession(
       refreshToken,
       {
-        appInstanceId: readString22(body, "app_instance_id") ?? readString22(body, "appInstanceId"),
-        label: readString22(body, "device_label") ?? readString22(body, "deviceLabel"),
-        platform: readString22(body, "device_platform") ?? readString22(body, "devicePlatform"),
-        model: readString22(body, "device_model") ?? readString22(body, "deviceModel")
+        appInstanceId: readString23(body, "app_instance_id") ?? readString23(body, "appInstanceId"),
+        label: readString23(body, "device_label") ?? readString23(body, "deviceLabel"),
+        platform: readString23(body, "device_platform") ?? readString23(body, "devicePlatform"),
+        model: readString23(body, "device_model") ?? readString23(body, "deviceModel")
       },
       paths
     );
@@ -45866,7 +46531,7 @@ function registerSystemRoutes(router, options) {
   });
   router.post("/api/v1/auth/logout", async (ctx) => {
     const body = await readJsonBody(ctx.req);
-    const refreshToken = readString22(body, "refresh_token") ?? readString22(body, "refreshToken");
+    const refreshToken = readString23(body, "refresh_token") ?? readString23(body, "refreshToken");
     if (refreshToken) {
       await revokeDeviceRefreshToken(refreshToken, paths);
     }
@@ -46107,7 +46772,7 @@ function registerSystemRoutes(router, options) {
   router.patch("/api/v1/devices/:deviceId", async (ctx) => {
     const auth = await authenticateRequest(ctx, paths);
     const body = await readJsonBody(ctx.req);
-    const label = readString22(body, "label") ?? readString22(body, "device_label");
+    const label = readString23(body, "label") ?? readString23(body, "device_label");
     if (!label) {
       throw new LinkHttpError(
         400,
@@ -46151,7 +46816,7 @@ function isActiveCronJob(job) {
   if (!enabled) {
     return false;
   }
-  const state = readString22(job, "state")?.toLowerCase();
+  const state = readString23(job, "state")?.toLowerCase();
   return !["paused", "disabled", "completed", "deleted"].includes(state ?? "");
 }
 function filterLogsWithinHours(logs, hours, now = Date.now()) {
@@ -46195,8 +46860,8 @@ function registerWorkspaceRoutes(router, options) {
     ctx.body = {
       ok: true,
       workspace: await conversations.createWorkspace({
-        name: readString22(body, "name") ?? "",
-        icon: readString22(body, "icon") ?? void 0
+        name: readString23(body, "name") ?? "",
+        icon: readString23(body, "icon") ?? void 0
       })
     };
   });
@@ -46206,8 +46871,8 @@ function registerWorkspaceRoutes(router, options) {
     ctx.body = {
       ok: true,
       workspace: await conversations.renameWorkspace(ctx.params.workspaceId, {
-        name: readString22(body, "name") ?? "",
-        icon: readString22(body, "icon") ?? void 0
+        name: readString23(body, "name") ?? "",
+        icon: readString23(body, "icon") ?? void 0
       })
     };
   });
@@ -46290,8 +46955,8 @@ function registerLinkUpdateRoutes(router, options) {
     ctx.body = await startLinkUpdate({
       paths,
       logger,
-      channel: readString22(body, "channel"),
-      targetVersion: readString22(body, "target_version") ?? readString22(body, "targetVersion")
+      channel: readString23(body, "channel"),
+      targetVersion: readString23(body, "target_version") ?? readString23(body, "targetVersion")
     });
   });
   router.get("/api/v1/link/update/events", async (ctx) => {
@@ -46321,7 +46986,7 @@ import QRCode from "qrcode";
 function registerPairingRoutes(router, options) {
   const { paths } = options;
   router.get("/pair", async (ctx) => {
-    const sessionId = readString22(ctx.query, "session_id");
+    const sessionId = readString23(ctx.query, "session_id");
     if (!sessionId) {
       throw new LinkHttpError(400, "pairing_session_required", "session_id is required");
     }
@@ -46346,7 +47011,7 @@ function registerPairingRoutes(router, options) {
     ctx.body = page;
   });
   router.get("/api/v1/pairing/session", async (ctx) => {
-    const sessionId = readString22(ctx.query, "session_id");
+    const sessionId = readString23(ctx.query, "session_id");
     if (!sessionId) {
       throw new LinkHttpError(400, "pairing_session_required", "session_id is required");
     }
@@ -46816,7 +47481,7 @@ function registerInternalRoutes(router, options) {
   router.post("/internal/deliver", async (ctx) => {
     assertLoopbackRequest(ctx.req);
     const body = await readJsonBody(ctx.req);
-    const stagingDir = readString22(body, "staging_dir") ?? readString22(body, "stagingDir");
+    const stagingDir = readString23(body, "staging_dir") ?? readString23(body, "stagingDir");
     if (!stagingDir) {
       throw new LinkHttpError(
         400,
@@ -46835,9 +47500,9 @@ function registerInternalRoutes(router, options) {
     ctx.body = {
       ok: true,
       ...await options.conversations.deliverFilesFromTool({
-        profile: readString22(body, "profile") ?? readString22(body, "profile_name") ?? readString22(body, "profileName") ?? void 0,
-        taskId: readString22(body, "task_id") ?? readString22(body, "taskId") ?? void 0,
-        sessionId: readString22(body, "session_id") ?? readString22(body, "sessionId") ?? void 0,
+        profile: readString23(body, "profile") ?? readString23(body, "profile_name") ?? readString23(body, "profileName") ?? void 0,
+        taskId: readString23(body, "task_id") ?? readString23(body, "taskId") ?? void 0,
+        sessionId: readString23(body, "session_id") ?? readString23(body, "sessionId") ?? void 0,
         files: body.files ?? body.file ?? body.path
       })
     };
@@ -46898,9 +47563,9 @@ function registerLiveActivityRoutes(router, options) {
     const auth = await authenticateRequest(ctx, paths);
     const body = await readJsonBody(ctx.req);
     const targetKind = readTargetKind(body);
-    const runId = normalizePattern(readString22(body, "run_id") ?? readString22(body, "runId"), RUN_ID_PATTERN);
+    const runId = normalizePattern(readString23(body, "run_id") ?? readString23(body, "runId"), RUN_ID_PATTERN);
     const operationId = normalizePattern(
-      readString22(body, "operation_id") ?? readString22(body, "operationId"),
+      readString23(body, "operation_id") ?? readString23(body, "operationId"),
       OPERATION_ID_PATTERN
     );
     if (targetKind === "run" && !runId) {
@@ -46946,7 +47611,7 @@ function registerLiveActivityRoutes(router, options) {
   });
 }
 function readTargetKind(body) {
-  const value = readString22(body, "target_kind") ?? readString22(body, "targetKind");
+  const value = readString23(body, "target_kind") ?? readString23(body, "targetKind");
   return readTargetKindValue(value);
 }
 function readTargetKindValue(value) {
@@ -46968,21 +47633,21 @@ function readQueryValue(query, key) {
   return readQueryString(query[key]) ?? null;
 }
 function readApnsEnvironment(body) {
-  const value = readString22(body, "apns_environment") ?? readString22(body, "apnsEnvironment");
+  const value = readString23(body, "apns_environment") ?? readString23(body, "apnsEnvironment");
   if (value === "sandbox" || value === "production") {
     return value;
   }
   throw new LinkHttpError(400, "apns_environment_invalid", "apns_environment must be sandbox or production");
 }
 function readLanguage2(body) {
-  const value = readString22(body, "language") ?? readString22(body, "preferred_language") ?? readString22(body, "preferredLanguage");
+  const value = readString23(body, "language") ?? readString23(body, "preferred_language") ?? readString23(body, "preferredLanguage");
   if (!value) {
     return null;
   }
   return value.toLowerCase().startsWith("zh") ? "zh" : "en";
 }
 function readPrivacyLevel(body) {
-  const value = readString22(body, "privacy_level") ?? readString22(body, "privacyLevel");
+  const value = readString23(body, "privacy_level") ?? readString23(body, "privacyLevel");
   if (value === "minimal" || value === "detailed") {
     return value;
   }
@@ -46990,7 +47655,7 @@ function readPrivacyLevel(body) {
 }
 function readRequiredString(body, keys, code) {
   for (const key of keys) {
-    const value = readString22(body, key);
+    const value = readString23(body, key);
     if (value) {
       return value;
     }
@@ -47006,7 +47671,7 @@ function readRequiredPattern(body, keys, pattern, code) {
 }
 function readOptionalString2(body, keys, maxLength) {
   for (const key of keys) {
-    const value = readString22(body, key);
+    const value = readString23(body, key);
     if (value) {
       return value.slice(0, maxLength);
     }
@@ -47018,7 +47683,7 @@ function normalizePattern(value, pattern) {
 }
 function readIso(body, keys) {
   for (const key of keys) {
-    const value = readString22(body, key);
+    const value = readString23(body, key);
     if (!value) {
       continue;
     }