@hermespilot/link 0.7.7 → 0.7.8

package/dist/{chunk-JQYZZDVU.js → chunk-7JPQICDK.js}

@@ -5,7 +5,7 @@ import Router from "@koa/router";
 // src/conversations/conversation-service.ts
 import { EventEmitter } from "events";
 import { createHash as createHash6, randomUUID as randomUUID11 } from "crypto";
-import path24 from "path";
+import path25 from "path";
 
 // src/database/link-database.ts
 import { mkdir } from "fs/promises";
@@ -2032,6 +2032,13 @@ function translateChineseKnownErrorToEnglish(message) {
   if (restartFailed?.groups) {
     return `Hermes Gateway restart failed.${restartFailed.groups.detail}`;
   }
+  if (message.startsWith("Hermes Link \u5DF2\u8FDE\u63A5\uFF0C\u4F46\u672C\u673A\u6267\u884C\u9762\u4E0D\u53EF\u7528\uFF1A")) {
+    return [
+      "Hermes Link is reachable, but the local Hermes execution backend is unavailable because the background service cannot find the `hermes` command.",
+      "First run `hermeslink restart` on this computer to try to recover. If that fixes the App, run `hermeslink autostart on` afterwards to refresh the boot autostart environment so this does not happen again after the next reboot.",
+      "If it still fails, run `hermeslink doctor` for diagnostics. If Hermes Agent is installed in a custom location, set HERMES_BIN to the full path of the `hermes` executable."
+    ].join("\n");
+  }
   const cliMissing = /^没有找到可用的 Hermes Agent CLI。请先安装 Hermes Agent，或设置 HERMES_BIN。(?<detail>.*)$/u.exec(message);
   if (cliMissing?.groups) {
     return `No usable Hermes Agent CLI was found. Install Hermes Agent or set HERMES_BIN.${cliMissing.groups.detail}`;
@@ -6547,7 +6554,7 @@ async function listCronOutputFiles(profileName, jobId) {
       orderTimeMs: fileStat.mtimeMs
     });
   }
-  return files.sort((left, right) => left.orderTimeMs - right.orderTimeMs).map(({ path: path34, mtime }) => ({ path: path34, mtime }));
+  return files.sort((left, right) => left.orderTimeMs - right.orderTimeMs).map(({ path: path35, mtime }) => ({ path: path35, mtime }));
 }
 function readCronOutputTimestamp(fileName) {
   const match = fileName.match(
@@ -6636,7 +6643,7 @@ function isConversationMissingError(error) {
 }
 
 // src/constants.ts
-var LINK_VERSION = "0.7.7";
+var LINK_VERSION = "0.7.8";
 var LINK_COMMAND = "hermeslink";
 var LINK_DEFAULT_PORT = 52379;
 var LINK_RUNTIME_DIR_NAME = ".hermeslink";
@@ -6669,6 +6676,7 @@ function resolveRuntimePaths(homeDir = resolveRuntimeHome()) {
 var defaultLinkConfig = {
   port: LINK_DEFAULT_PORT,
   lanHost: null,
+  hermesBin: null,
   serverBaseUrl: "https://hermes-server.clawpilot.me",
   relayBaseUrl: "https://hermes-relay.clawpilot.me",
   appConnectTokenIssuer: "https://hermes-server.clawpilot.me",
@@ -6680,6 +6688,7 @@ async function loadConfig(paths = resolveRuntimePaths()) {
   const existing = await readJsonFile(paths.configFile);
   const language = normalizeConfiguredLanguage(existing?.language);
   const lanHost = normalizeLanHost(existing?.lanHost);
+  const hermesBin = normalizeHermesBin(existing?.hermesBin);
   const logLevel = normalizeLogLevel(
     existing?.logLevel ?? process.env.HERMESLINK_LOG_LEVEL
   );
@@ -6688,6 +6697,7 @@ async function loadConfig(paths = resolveRuntimePaths()) {
     ...existing ?? {},
     language,
     lanHost,
+    hermesBin,
     logLevel
   };
 }
@@ -6696,6 +6706,7 @@ async function saveConfig(patch, paths = resolveRuntimePaths()) {
   const next = {
     ...current,
     ...patch,
+    hermesBin: patch.hermesBin === void 0 ? current.hermesBin : normalizeHermesBin(patch.hermesBin),
     logLevel: patch.logLevel === void 0 ? current.logLevel : normalizeLogLevel(patch.logLevel)
   };
   await writeJsonFile(paths.configFile, next);
@@ -6735,6 +6746,16 @@ function normalizeLanHost(value) {
   }
   return host;
 }
+function normalizeHermesBin(value) {
+  if (value === null || value === void 0) {
+    return null;
+  }
+  if (typeof value !== "string") {
+    return null;
+  }
+  const trimmed = value.trim();
+  return trimmed || null;
+}
 function isUsableLanIpv4(value) {
   const parts = value.split(".").map((part) => Number.parseInt(part, 10));
   if (parts.length !== 4 || parts.some((part) => !Number.isInteger(part) || part < 0 || part > 255)) {
@@ -6904,9 +6925,8 @@ function readErrorMessage(payload) {
 
 // src/hermes/gateway.ts
 import { execFile as execFile2, spawn } from "child_process";
-import { constants as fsConstants } from "fs";
-import { access, readFile as readFile5, realpath, stat as stat4 } from "fs/promises";
-import path7 from "path";
+import { access, readFile as readFile5, stat as stat4 } from "fs/promises";
+import path8 from "path";
 import { setTimeout as delay2 } from "timers/promises";
 import { promisify as promisify2 } from "util";
 
@@ -7287,6 +7307,15 @@ function rotatedLogFile(filePath, index) {
 
 // src/hermes/cli.ts
 import { execFile } from "child_process";
+import {
+  accessSync,
+  constants as fsConstants,
+  readFileSync,
+  realpathSync,
+  statSync
+} from "fs";
+import os4 from "os";
+import path7 from "path";
 import { promisify } from "util";
 var execFileAsync = promisify(execFile);
 async function deleteHermesSession(sessionId, profileName = "default") {
@@ -7379,7 +7408,158 @@ async function renameHermesSession(sessionId, title, profileName = "default") {
   }
 }
 function resolveHermesBin() {
-  return process.env.HERMES_BIN?.trim() || "hermes";
+  return resolveHermesBinResolution().bin;
+}
+function resolveHermesBinResolution(paths = resolveRuntimePaths()) {
+  const envHermesBin = process.env.HERMES_BIN?.trim();
+  if (envHermesBin) {
+    return { bin: envHermesBin, source: "env" };
+  }
+  const configuredHermesBin = readConfiguredHermesBin(paths);
+  if (configuredHermesBin) {
+    const resolved = resolveExecutablePathSync(configuredHermesBin);
+    if (resolved) {
+      return { bin: resolved, source: "config" };
+    }
+  }
+  const pathHermesBin = resolveExecutablePathSync("hermes", { pathOnly: true });
+  if (pathHermesBin) {
+    return { bin: pathHermesBin, source: "path" };
+  }
+  const commonHermesBin = commonHermesBinCandidates().map((candidate) => resolveExecutablePathSync(candidate)).find((candidate) => Boolean(candidate));
+  if (commonHermesBin) {
+    return { bin: commonHermesBin, source: "common" };
+  }
+  return { bin: "hermes", source: "fallback" };
+}
+async function rememberResolvedHermesBin(hermesBin, paths = resolveRuntimePaths()) {
+  const resolved = resolveExecutablePathSync(hermesBin);
+  if (!resolved || !path7.isAbsolute(resolved)) {
+    return null;
+  }
+  if (readConfiguredHermesBin(paths) === resolved) {
+    return resolved;
+  }
+  await saveConfig({ hermesBin: resolved }, paths);
+  return resolved;
+}
+function resolveExecutablePathSync(command, options = {}) {
+  const candidates = executablePathCandidates(command, options);
+  for (const candidate of candidates) {
+    if (!isExecutableFile(candidate)) {
+      continue;
+    }
+    try {
+      return realpathSync(candidate);
+    } catch {
+      return candidate;
+    }
+  }
+  return null;
+}
+function isHermesExecutableMissingError(error) {
+  if (typeof error === "object" && error !== null && "code" in error) {
+    const code = error.code;
+    if (code === "ENOENT") {
+      return true;
+    }
+  }
+  const message = error instanceof Error ? error.message : String(error);
+  return /\bspawn\b[\s\S]*\bENOENT\b/u.test(message);
+}
+function createHermesCliMissingError(error, language = "zh-CN") {
+  return new LinkHttpError(
+    503,
+    "hermes_agent_cli_missing",
+    buildHermesCliMissingMessage(resolveHermesBin(), error, language)
+  );
+}
+function buildHermesCliMissingMessage(hermesBin, error, language = "zh-CN") {
+  if (language === "en") {
+    return buildEnglishHermesCliMissingMessage(hermesBin, error);
+  }
+  const detail = path7.isAbsolute(hermesBin) ? `\u914D\u7F6E\u7684 Hermes CLI \u8DEF\u5F84\u4E0D\u53EF\u7528\uFF1A${hermesBin}` : `\u540E\u53F0\u73AF\u5883\u627E\u4E0D\u5230 Hermes Agent \u7684 \`${hermesBin}\` \u547D\u4EE4`;
+  const originalHint = isHermesExecutableMissingError(error) ? "" : formatHermesCliErrorHint(error);
+  return [
+    `Hermes Link \u5DF2\u8FDE\u63A5\uFF0C\u4F46\u672C\u673A\u6267\u884C\u9762\u4E0D\u53EF\u7528\uFF1A${detail}\uFF0C\u56E0\u6B64\u65E0\u6CD5\u542F\u52A8 Hermes Agent \u804A\u5929\u8FDB\u7A0B\u3002`,
+    "\u8BF7\u5148\u5728\u8FD9\u53F0\u7535\u8111\u7684\u7EC8\u7AEF\u8FD0\u884C `hermeslink restart` \u5C1D\u8BD5\u6062\u590D\u3002\u82E5\u91CD\u542F\u540E\u6062\u590D\u6B63\u5E38\uFF0C\u8BF7\u518D\u8FD0\u884C `hermeslink autostart on` \u5237\u65B0\u5F00\u673A\u81EA\u542F\u73AF\u5883\uFF0C\u907F\u514D\u4E0B\u6B21\u91CD\u542F\u7535\u8111\u540E\u518D\u6B21\u53D1\u751F\u3002",
+    "\u5982\u679C\u4ECD\u7136\u5931\u8D25\uFF0C\u8BF7\u8FD0\u884C `hermeslink doctor` \u67E5\u770B\u8BCA\u65AD\uFF1B\u82E5 Hermes Agent \u5B89\u88C5\u5728\u81EA\u5B9A\u4E49\u8DEF\u5F84\uFF0C\u8BF7\u5C06 HERMES_BIN \u8BBE\u7F6E\u4E3A `hermes` \u53EF\u6267\u884C\u6587\u4EF6\u7684\u5B8C\u6574\u8DEF\u5F84\u3002",
+    originalHint
+  ].filter(Boolean).join("\n");
+}
+function buildEnglishHermesCliMissingMessage(hermesBin, error) {
+  const detail = path7.isAbsolute(hermesBin) ? `the configured Hermes CLI path is not usable: ${hermesBin}` : `the background environment cannot find the \`${hermesBin}\` command`;
+  const originalHint = isHermesExecutableMissingError(error) ? "" : formatHermesCliErrorHint(error, "en");
+  return [
+    `Hermes Link is reachable, but the local Hermes execution backend is unavailable because ${detail}. Hermes Link cannot start the Hermes Agent chat process.`,
+    "First run `hermeslink restart` on this computer to try to recover. If that fixes the App, run `hermeslink autostart on` afterwards to refresh the boot autostart environment so this does not happen again after the next reboot.",
+    "If it still fails, run `hermeslink doctor` for diagnostics. If Hermes Agent is installed in a custom location, set HERMES_BIN to the full path of the `hermes` executable.",
+    originalHint
+  ].filter(Boolean).join("\n");
+}
+function formatHermesCliErrorHint(error, language = "zh-CN") {
+  if (error === void 0 || error === null) {
+    return "";
+  }
+  const message = error instanceof Error ? error.message : String(error);
+  if (!message.trim()) {
+    return "";
+  }
+  return language === "en" ? `Raw diagnostic: ${message}` : `\u539F\u59CB\u8BCA\u65AD\uFF1A${message}`;
+}
+function readConfiguredHermesBin(paths) {
+  try {
+    const raw = readFileSync(paths.configFile, "utf8");
+    const payload = JSON.parse(raw);
+    return normalizeHermesBin(payload.hermesBin);
+  } catch {
+    return null;
+  }
+}
+function executablePathCandidates(command, options) {
+  const normalized = command.trim();
+  if (!normalized) {
+    return [];
+  }
+  if (/[\\/]/u.test(normalized)) {
+    return options.pathOnly ? [] : withWindowsExecutableExtensions(normalized);
+  }
+  const pathEntries = (process.env.PATH ?? "").split(path7.delimiter).filter(Boolean);
+  return pathEntries.flatMap(
+    (entry) => withWindowsExecutableExtensions(path7.join(entry, normalized))
+  );
+}
+function commonHermesBinCandidates() {
+  const home = os4.homedir();
+  return [
+    path7.join(home, ".hermes", "hermes-agent", "venv", "bin", "hermes"),
+    path7.join(home, ".local", "bin", "hermes"),
+    ...process.platform === "win32" ? [] : [
+      "/opt/homebrew/bin/hermes",
+      "/usr/local/bin/hermes",
+      "/usr/bin/hermes",
+      "/bin/hermes"
+    ]
+  ];
+}
+function withWindowsExecutableExtensions(filePath) {
+  if (process.platform !== "win32" || path7.extname(filePath)) {
+    return [filePath];
+  }
+  const extensions = (process.env.PATHEXT ?? ".EXE;.CMD;.BAT;.COM").split(";").filter(Boolean);
+  return [filePath, ...extensions.map((extension) => `${filePath}${extension}`)];
+}
+function isExecutableFile(filePath) {
+  try {
+    const stats = statSync(filePath);
+    if (!stats.isFile()) {
+      return false;
+    }
+    accessSync(filePath, fsConstants.X_OK);
+    return true;
+  } catch {
+    return false;
+  }
 }
 function readSessionDeleteStatus(stdout, stderr) {
   const output = `${stdout.toString()}
@@ -7486,7 +7666,8 @@ async function ensureHermesApiServerAvailable(options = {}) {
   const start = await startHermesGatewayOnce(
     options.paths ?? resolveRuntimePaths(),
     profileName,
-    options.logger
+    options.logger,
+    options.language
   );
   health = await waitForHermesApiHealth(
     configResult.apiServer,
@@ -7512,7 +7693,8 @@ async function ensureHermesApiServerAvailable(options = {}) {
     const repairedStart = await startHermesGatewayOnce(
       options.paths ?? resolveRuntimePaths(),
       profileName,
-      options.logger
+      options.logger,
+      options.language
     );
     health = await waitForHermesApiHealth(
       repairedConfigResult.apiServer,
@@ -7673,7 +7855,7 @@ async function execHermesVersion(hermesBin, logger) {
   throw new Error(summary);
 }
 async function readHermesPythonMetadataVersion(hermesBin, timeoutMs) {
-  const hermesPath = await resolveExecutablePath(hermesBin);
+  const hermesPath = resolveExecutablePathSync(hermesBin);
   if (!hermesPath) {
     return null;
   }
@@ -7865,22 +8047,25 @@ function assertHermesRunsApiSupported(version, status, endpoint = "/v1/runs", la
     language === "en" ? `${versionText}The current Hermes Agent API Server does not support the ${endpoint} endpoint required by HermesPilot. Run \`hermes update\` to upgrade Hermes Agent.` : `${versionText}\u5F53\u524D Hermes Agent API Server \u4E0D\u652F\u6301 HermesPilot \u9700\u8981\u7684 ${endpoint} \u63A5\u53E3\uFF0C\u8BF7\u5148\u8FD0\u884C \`hermes update\` \u5347\u7EA7 Hermes Agent\u3002`
   );
 }
-async function startHermesGatewayOnce(paths, profileName, logger) {
+async function startHermesGatewayOnce(paths, profileName, logger, language = "zh-CN") {
   if (!gatewayStartInFlightByProfile.has(profileName)) {
     gatewayStartInFlightByProfile.set(
       profileName,
-      startHermesGateway(paths, profileName, logger).finally(() => {
+      startHermesGateway(paths, profileName, logger, language).finally(() => {
         gatewayStartInFlightByProfile.delete(profileName);
       })
     );
   }
   return await gatewayStartInFlightByProfile.get(profileName);
 }
-async function startHermesGateway(paths, profileName, logger) {
+async function startHermesGateway(paths, profileName, logger, language = "zh-CN") {
   const version = await readHermesVersion({ logger }).catch((error) => {
     void logger?.error("gateway_hermes_cli_unavailable", {
       error: error instanceof Error ? error.message : String(error)
     });
+    if (isHermesExecutableMissingError(error)) {
+      throw createHermesCliMissingError(error, language);
+    }
     throw new LinkHttpError(
       503,
       "hermes_agent_not_available",
@@ -7899,11 +8084,12 @@ async function startHermesGateway(paths, profileName, logger) {
   }
   const gatewayLog = createRotatingTextLogWriter({
     paths,
-    fileName: path7.basename(getGatewayRuntimeLogFile(paths))
+    fileName: path8.basename(getGatewayRuntimeLogFile(paths))
   });
   const logPath = gatewayLog.filePath;
   try {
-    const child = spawn(resolveHermesBin(), gatewayRunArgs(profileName), {
+    const hermesBin = resolveHermesBin();
+    const child = spawn(hermesBin, gatewayRunArgs(profileName), {
       detached: true,
       env: buildHermesGatewayChildEnv(),
       stdio: ["ignore", "pipe", "pipe"],
@@ -7934,7 +8120,20 @@ async function startHermesGateway(paths, profileName, logger) {
         callback();
       };
       child.once("spawn", () => finish(resolve));
-      child.once("error", (error) => finish(() => reject(error)));
+      child.once(
+        "error",
+        (error) => finish(() => {
+          if (isHermesExecutableMissingError(error)) {
+            void logger?.error("gateway_hermes_cli_spawn_missing", {
+              hermes_bin: hermesBin,
+              error: error.message
+            });
+            reject(createHermesCliMissingError(error, language));
+            return;
+          }
+          reject(error);
+        })
+      );
     });
     unrefDetachedGatewayProcess(child);
     void logger?.info("gateway_process_spawned", {
@@ -7969,7 +8168,7 @@ async function restartHermesGatewayServiceIfAvailable(options) {
   if (!home) {
     return null;
   }
-  const launchdPlistPath = path7.join(
+  const launchdPlistPath = path8.join(
     home,
     "Library",
     "LaunchAgents",
@@ -7988,13 +8187,16 @@ async function restartHermesGatewayServiceIfAvailable(options) {
     void options.logger?.error("gateway_service_restart_failed", {
       error: error instanceof Error ? error.message : String(error)
     });
+    if (isHermesExecutableMissingError(error)) {
+      throw createHermesCliMissingError(error, options.language);
+    }
     throw new LinkHttpError(
       503,
       "hermes_gateway_restart_failed",
       `Hermes Gateway \u670D\u52A1\u91CD\u542F\u5931\u8D25\u3002${formatErrorSuffix(error)}`
     );
   }
-  const logPath = path7.join(home, ".hermes", "logs", "gateway.error.log");
+  const logPath = path8.join(home, ".hermes", "logs", "gateway.error.log");
   const logHint = await readRecentGatewayLogHint(logPath);
   return {
     pid: null,
@@ -8414,6 +8616,12 @@ async function readHermesDashboardVersion(options = {}) {
 async function probeHermesVersion(hermesBin, options) {
   try {
     const { stdout } = await execHermesVersion(hermesBin, options.logger);
+    await rememberResolvedHermesBin(hermesBin).catch((error) => {
+      void options.logger?.debug("hermes_bin_remember_failed", {
+        hermes_bin: hermesBin,
+        error: error instanceof Error ? error.message : String(error)
+      });
+    });
     const raw = stdout.trim();
     const version = parseHermesVersion(raw);
     return buildHermesVersionInfo(raw, version);
@@ -8523,37 +8731,6 @@ function readExecErrorDetails(error, message) {
 function truncateVersionLogOutput(value) {
   return value.length > MAX_VERSION_LOG_OUTPUT_LENGTH ? `${value.slice(0, MAX_VERSION_LOG_OUTPUT_LENGTH)}...` : value;
 }
-async function resolveExecutablePath(command) {
-  const candidates = executablePathCandidates(command);
-  for (const candidate of candidates) {
-    try {
-      await access(candidate, fsConstants.X_OK);
-      return await realpath(candidate).catch(() => candidate);
-    } catch {
-    }
-  }
-  return null;
-}
-function executablePathCandidates(command) {
-  const normalized = command.trim();
-  if (!normalized) {
-    return [];
-  }
-  if (/[\\/]/u.test(normalized)) {
-    return withWindowsExecutableExtensions(normalized);
-  }
-  const pathEntries = (process.env.PATH ?? "").split(path7.delimiter).filter(Boolean);
-  return pathEntries.flatMap(
-    (entry) => withWindowsExecutableExtensions(path7.join(entry, normalized))
-  );
-}
-function withWindowsExecutableExtensions(filePath) {
-  if (process.platform !== "win32" || path7.extname(filePath)) {
-    return [filePath];
-  }
-  const extensions = (process.env.PATHEXT ?? ".EXE;.CMD;.BAT;.COM").split(";").filter(Boolean);
-  return [filePath, ...extensions.map((extension) => `${filePath}${extension}`)];
-}
 async function readFirstLine(filePath) {
   const raw = await readFile5(filePath, "utf8");
   return raw.split(/\r?\n/u, 1)[0] ?? "";
@@ -8566,7 +8743,7 @@ function parsePythonShebang(line) {
   if (parts.length === 0) {
     return null;
   }
-  const commandName = path7.basename(parts[0] ?? "").toLowerCase();
+  const commandName = path8.basename(parts[0] ?? "").toLowerCase();
   if (commandName === "env") {
     const args = expandEnvShebangArgs(parts.slice(1));
     const pythonIndex = args.findIndex((part) => isPythonCommandName(part));
@@ -8587,7 +8764,7 @@ function parsePythonShebang(line) {
   };
 }
 function isPythonCommandName(command) {
-  return /^python(?:\d+(?:\.\d+)?)?$/iu.test(path7.basename(command));
+  return /^python(?:\d+(?:\.\d+)?)?$/iu.test(path8.basename(command));
 }
 function expandEnvShebangArgs(args) {
   const expanded = [];
@@ -8631,11 +8808,12 @@ import { spawn as spawn2 } from "child_process";
 import { randomBytes as randomBytes2 } from "crypto";
 import { readFile as readFile6, stat as stat5 } from "fs/promises";
 import net2 from "net";
-import path8 from "path";
+import path9 from "path";
 import { setTimeout as delay3 } from "timers/promises";
 import WebSocket from "ws";
 var CONNECT_TIMEOUT_MS = 15e3;
 var REQUEST_TIMEOUT_MS = 12e4;
+var USAGE_REQUEST_TIMEOUT_MS = 1e4;
 var PROMPT_SUBMIT_TIMEOUT_MS = 0;
 var READY_TIMEOUT_MS = 1e4;
 var BACKEND_START_TIMEOUT_MS = 45e3;
@@ -8656,19 +8834,31 @@ async function streamTuiGatewayRun(input) {
     profileName,
     paths: input.paths,
     logger: input.logger,
-    signal: input.signal
+    signal: input.signal,
+    language: input.language
   });
   const started = await ensureRpcSession(client, {
     ...input,
     profileName
   });
   await client.waitForSessionDrain(started.runtimeSessionId, input.signal);
+  const usageBaseline = await client.readSessionUsage(started.runtimeSessionId).catch((error) => {
+    void input.logger?.debug("tui_gateway_usage_baseline_read_failed", {
+      profile: profileName,
+      session_id: started.runtimeSessionId,
+      error: error instanceof Error ? error.message : String(error)
+    });
+    return started.resumed ? null : {};
+  });
   const events = client.submitPrompt({
     sessionId: started.runtimeSessionId,
     text: buildTuiGatewayPromptText(input),
     signal: input.signal
   });
-  return { started, events };
+  return {
+    started,
+    events: normalizeTuiGatewayRunUsageDeltas(events, usageBaseline)
+  };
 }
 function buildTuiGatewayPromptText(input) {
   return input.input;
@@ -8949,9 +9139,10 @@ async function startTuiGatewayBackend(input) {
   ];
   const logWriter = createRotatingTextLogWriter({
     paths,
-    fileName: path8.basename(getGatewayRuntimeLogFile(paths))
+    fileName: path9.basename(getGatewayRuntimeLogFile(paths))
   });
-  const child = spawn2(resolveHermesBin(), args, {
+  const hermesBin = resolveHermesBin();
+  const child = spawn2(hermesBin, args, {
     env: {
       ...process.env,
       HERMES_DASHBOARD_SESSION_TOKEN: token
@@ -8976,7 +9167,13 @@ async function startTuiGatewayBackend(input) {
       signal
     });
   });
-  await waitForChildSpawn(child, input.signal);
+  await waitForChildSpawn(
+    child,
+    input.signal,
+    input.logger,
+    hermesBin,
+    input.language
+  );
   const baseUrl = `http://127.0.0.1:${port}`;
   const wsUrl = `ws://127.0.0.1:${port}/api/ws?token=${encodeURIComponent(token)}`;
   try {
@@ -9180,6 +9377,13 @@ var TuiGatewayClient = class {
     queue.closed.finally(cleanup).catch(() => void 0);
     return queue;
   }
+  async readSessionUsage(sessionId) {
+    return await this.request(
+      "session.usage",
+      { session_id: sessionId },
+      USAGE_REQUEST_TIMEOUT_MS
+    );
+  }
   async interruptSession(sessionId) {
     const queue = new GatewayEventQueue(sessionId);
     this.eventQueues.add(queue);
@@ -9477,6 +9681,94 @@ var GatewayEventQueue = class {
     });
   }
 };
+async function* normalizeTuiGatewayRunUsageDeltas(events, baseline) {
+  for await (const event of events) {
+    yield normalizeTuiGatewayRunUsageDelta(event, baseline);
+  }
+}
+function normalizeTuiGatewayRunUsageDelta(event, baseline) {
+  if (baseline === null || event.payloadType !== "run.completed" && event.payloadType !== "run.failed" && event.payloadType !== "run.cancelled") {
+    return event;
+  }
+  const usage = normalizeTuiGatewayUsageDelta(event.payload.usage, baseline);
+  if (!usage) {
+    return event;
+  }
+  return {
+    ...event,
+    payload: {
+      ...event.payload,
+      usage
+    }
+  };
+}
+function normalizeTuiGatewayUsageDelta(usageValue, baseline) {
+  const usage = toRecord3(usageValue);
+  if (Object.keys(usage).length === 0) {
+    return null;
+  }
+  const inputTokens = usageDelta(usage, baseline, [
+    "input",
+    "input_tokens",
+    "prompt",
+    "prompt_tokens"
+  ]);
+  const outputTokens = usageDelta(usage, baseline, [
+    "output",
+    "output_tokens",
+    "completion",
+    "completion_tokens"
+  ]);
+  const totalTokens = totalUsageDelta(
+    usage,
+    baseline,
+    inputTokens,
+    outputTokens
+  );
+  const contextTokens = readNumber2(usage, "context_used") ?? readNumber2(usage, "context_tokens") ?? readNumber2(usage, "current_context_tokens") ?? readNumber2(usage, "last_prompt_tokens");
+  const contextWindow = readNumber2(usage, "context_max") ?? readNumber2(usage, "context_window") ?? readNumber2(usage, "context_length");
+  const usagePercent = readNumber2(usage, "context_percent") ?? readNumber2(usage, "usage_percent");
+  if (inputTokens === void 0 && outputTokens === void 0 && totalTokens === void 0 && contextTokens === void 0) {
+    return null;
+  }
+  return {
+    ...usage,
+    ...inputTokens !== void 0 ? { input_tokens: inputTokens } : {},
+    ...outputTokens !== void 0 ? { output_tokens: outputTokens } : {},
+    ...totalTokens !== void 0 ? { total_tokens: totalTokens } : {},
+    ...contextTokens !== void 0 ? { context_tokens: contextTokens } : {},
+    ...contextWindow !== void 0 ? { context_window: contextWindow } : {},
+    ...usagePercent !== void 0 ? { usage_percent: usagePercent } : {}
+  };
+}
+function usageDelta(current, baseline, keys) {
+  const currentValue = readFirstNumber(current, keys);
+  if (currentValue === void 0) {
+    return void 0;
+  }
+  const baselineValue = readFirstNumber(baseline, keys) ?? 0;
+  return Math.max(0, currentValue - baselineValue);
+}
+function totalUsageDelta(current, baseline, inputTokens, outputTokens) {
+  const currentTotal = readFirstNumber(current, ["total", "total_tokens"]);
+  const baselineTotal = readFirstNumber(baseline, ["total", "total_tokens"]);
+  if (currentTotal !== void 0 && (baselineTotal !== void 0 || Object.keys(baseline).length === 0)) {
+    return Math.max(0, currentTotal - (baselineTotal ?? 0));
+  }
+  if (inputTokens !== void 0 || outputTokens !== void 0) {
+    return (inputTokens ?? 0) + (outputTokens ?? 0);
+  }
+  return void 0;
+}
+function readFirstNumber(payload, keys) {
+  for (const key of keys) {
+    const value = readNumber2(payload, key);
+    if (value !== void 0) {
+      return value;
+    }
+  }
+  return void 0;
+}
 function normalizeGatewayEvent(event) {
   const payload = toRecord3(event.payload);
   const base = {
@@ -9657,7 +9949,7 @@ async function readLogTailSummary(logPath) {
     return "";
   }
 }
-async function waitForChildSpawn(child, signal) {
+async function waitForChildSpawn(child, signal, logger, hermesBin = resolveHermesBin(), language = "zh-CN") {
   await new Promise((resolve, reject) => {
     const abort = () => {
       child.kill();
@@ -9680,6 +9972,14 @@ async function waitForChildSpawn(child, signal) {
     };
     const onError = (error) => {
       cleanup();
+      if (isHermesExecutableMissingError(error)) {
+        void logger?.error("tui_gateway_hermes_cli_spawn_missing", {
+          hermes_bin: hermesBin,
+          error: error.message
+        });
+        reject(createHermesCliMissingError(error, language));
+        return;
+      }
       reject(error);
     };
     signal?.addEventListener("abort", abort, { once: true });
@@ -9762,7 +10062,14 @@ function readString5(payload, key) {
 }
 function readNumber2(payload, key) {
   const value = payload[key];
-  return typeof value === "number" && Number.isFinite(value) ? value : null;
+  if (typeof value === "number" && Number.isFinite(value)) {
+    return Math.max(0, Math.floor(value));
+  }
+  if (typeof value === "string" && value.trim()) {
+    const parsed = Number.parseInt(value.replaceAll(",", ""), 10);
+    return Number.isFinite(parsed) ? Math.max(0, parsed) : void 0;
+  }
+  return void 0;
 }
 function readText(payload, key) {
   const value = payload[key];
@@ -9996,6 +10303,25 @@ function latestUsageRun(snapshot) {
   }
   return void 0;
 }
+function latestContextUsageRun(snapshot) {
+  let latestEstimatedRun;
+  let latestUsageRun2;
+  for (const run of [...snapshot.runs].reverse()) {
+    if (!isAgentRun(run) || !run.usage) {
+      continue;
+    }
+    latestUsageRun2 ??= run;
+    if (run.usage.context_tokens === void 0) {
+      continue;
+    }
+    if (run.usage.context_source === "estimated") {
+      latestEstimatedRun ??= run;
+      continue;
+    }
+    return run;
+  }
+  return latestEstimatedRun ?? latestUsageRun2;
+}
 function latestRuntimeRun(snapshot) {
   for (const run of [...snapshot.runs].reverse()) {
     if (isAgentRun(run) && (run.model || run.profile_uid || run.profile_name_snapshot || run.profile || run.usage)) {
@@ -10319,11 +10645,11 @@ function workspaceNotFound() {
 // src/conversations/blob-store.ts
 import { randomUUID as randomUUID5 } from "crypto";
 import { mkdir as mkdir6, readFile as readFile7, readdir as readdir4, rm as rm3, stat as stat6, writeFile } from "fs/promises";
-import path10 from "path";
+import path11 from "path";
 
 // src/conversations/media.ts
 import { createHash as createHash2 } from "crypto";
-import path9 from "path";
+import path10 from "path";
 
 // src/conversations/delivery-contract.ts
 var HERMES_LINK_DELIVERY_TAG_PATTERN = /<hermes_link_delivery>\s*(\{[\s\S]*?\})\s*<\/hermes_link_delivery>/giu;
@@ -10413,7 +10739,7 @@ function cleanMessageTextParts(message) {
   }
 }
 function inferMimeType(filePath) {
-  const extension = path9.extname(filePath).toLowerCase();
+  const extension = path10.extname(filePath).toLowerCase();
   return {
     ".png": "image/png",
     ".jpg": "image/jpeg",
@@ -10537,7 +10863,7 @@ function mediaSourceKey(sourcePath) {
   return createHash2("sha256").update(resolveMediaSourcePath(sourcePath)).digest("hex").slice(0, 32);
 }
 function sanitizeFilename(value, fallback) {
-  const base = path9.basename((value ?? "").replace(/[\r\n\t]/gu, " ").trim());
+  const base = path10.basename((value ?? "").replace(/[\r\n\t]/gu, " ").trim());
   const safe = base.replace(/[/:\\]/gu, "_").slice(0, 200).trim();
   return safe || fallback;
 }
@@ -10566,9 +10892,9 @@ function isBlobReferencedByMessages(snapshot, blobId) {
 }
 function resolveMediaSourcePath(sourcePath) {
   const trimmed = sourcePath.trim();
-  const expanded = trimmed.startsWith("~/") ? path9.join(process.env.HOME ?? "", trimmed.slice(2)) : trimmed;
-  const resolved = path9.resolve(expanded);
-  if (!path9.isAbsolute(expanded)) {
+  const expanded = trimmed.startsWith("~/") ? path10.join(process.env.HOME ?? "", trimmed.slice(2)) : trimmed;
+  const resolved = path10.resolve(expanded);
+  if (!path10.isAbsolute(expanded)) {
     throw new LinkHttpError(
       400,
       "media_source_path_not_absolute",
@@ -10763,7 +11089,7 @@ function normalizeConversationIds(conversationIds) {
 }
 function blobPath(paths, blobId) {
   assertValidBlobId(blobId);
-  return path10.join(paths.blobsDir, `${blobId}.bin`);
+  return path11.join(paths.blobsDir, `${blobId}.bin`);
 }
 async function writeConversationBlob(paths, conversationId, input, options) {
   assertValidConversationId(conversationId);
@@ -10772,7 +11098,7 @@ async function writeConversationBlob(paths, conversationId, input, options) {
   }
   const id = `blob_${randomUUID5().replaceAll("-", "")}`;
   const filePath = blobPath(paths, id);
-  await mkdir6(path10.dirname(filePath), { recursive: true, mode: 448 });
+  await mkdir6(path11.dirname(filePath), { recursive: true, mode: 448 });
   await writeFile(filePath, input.bytes, { mode: 384 });
   const blob = {
     id,
@@ -10848,7 +11174,7 @@ async function materializeConversationBlob(paths, conversationId, blobId, manife
     }
   }
   const targetDir = conversationAttachmentsDir(paths, conversationId);
-  const targetPath = path10.join(
+  const targetPath = path11.join(
     targetDir,
     materializedAttachmentFilename(blobId, manifest.filename ?? blobId)
   );
@@ -10901,7 +11227,7 @@ async function listConversationBlobIds(paths, conversationId) {
       continue;
     }
     const manifest = await readJsonFile(
-      path10.join(paths.blobsDir, entry.name)
+      path11.join(paths.blobsDir, entry.name)
     ).catch(() => null);
     if (manifest?.conversation_ids?.includes(conversationId)) {
       blobIds.push(blobId);
@@ -10911,7 +11237,7 @@ async function listConversationBlobIds(paths, conversationId) {
 }
 function conversationAttachmentsDir(paths, conversationId) {
   assertValidConversationId(conversationId);
-  return path10.join(paths.conversationsDir, conversationId, "attachments");
+  return path11.join(paths.conversationsDir, conversationId, "attachments");
 }
 function isNodeError6(error, code) {
   return typeof error === "object" && error !== null && "code" in error && error.code === code;
@@ -10991,7 +11317,7 @@ async function readConversationProfileSummary(paths, manifest) {
 }
 async function buildConversationRuntimeMetadata(paths, manifest, snapshot) {
   const current = await readCurrentConversationRuntime(paths, manifest);
-  const usageRun = latestUsageRun(snapshot);
+  const usageRun = latestContextUsageRun(snapshot);
   const profileUid = current.profileUid;
   const profileName = current.profileName;
   const profilePresentation = {
@@ -11946,7 +12272,7 @@ function commandText(language, zh, en) {
 
 // src/conversations/delivery-staging.ts
 import { mkdir as mkdir7, rm as rm4 } from "fs/promises";
-import path11 from "path";
+import path12 from "path";
 async function prepareDeliveryStagingRunDir(paths, conversationId, runId) {
   const directory = deliveryStagingRunDir(paths, conversationId, runId);
   await mkdir7(directory, { recursive: true, mode: 448 });
@@ -11959,14 +12285,14 @@ async function removeConversationDeliveryStaging(paths, conversationId) {
   });
 }
 function deliveryStagingRunDir(paths, conversationId, runId) {
-  return path11.join(
+  return path12.join(
     deliveryStagingConversationDir(paths, conversationId),
     safePathSegment(runId, "run")
   );
 }
 function deliveryStagingConversationDir(paths, conversationId) {
   assertValidConversationId(conversationId);
-  return path11.join(paths.conversationsDir, conversationId, "delivery-staging");
+  return path12.join(paths.conversationsDir, conversationId, "delivery-staging");
 }
 function safePathSegment(value, fallback) {
   const safe = value.trim().replaceAll(/[^a-zA-Z0-9._-]/gu, "_");
@@ -11976,7 +12302,7 @@ function safePathSegment(value, fallback) {
 // src/conversations/conversation-archive-plans.ts
 import { randomUUID as randomUUID7 } from "crypto";
 import { mkdir as mkdir8 } from "fs/promises";
-import path12 from "path";
+import path13 from "path";
 var PLAN_ID_PATTERN = /^archive_[a-f0-9]{32}$/u;
 var ConversationArchivePlanStore = class {
   constructor(paths) {
@@ -12019,10 +12345,10 @@ var ConversationArchivePlanStore = class {
     await writeJsonFile(this.planPath(normalizedPlanId), plan);
   }
   plansDir() {
-    return path12.join(this.paths.indexesDir, "conversation-archive-plans");
+    return path13.join(this.paths.indexesDir, "conversation-archive-plans");
   }
   planPath(planId) {
-    return path12.join(this.plansDir(), `${planId}.json`);
+    return path13.join(this.plansDir(), `${planId}.json`);
   }
 };
 function normalizePlanId(planId) {
@@ -12040,7 +12366,7 @@ function normalizePlanId(planId) {
 // src/conversations/conversation-clear-plans.ts
 import { randomUUID as randomUUID8 } from "crypto";
 import { mkdir as mkdir9 } from "fs/promises";
-import path13 from "path";
+import path14 from "path";
 var PLAN_ID_PATTERN2 = /^clear_[a-f0-9]{32}$/u;
 var ConversationClearPlanStore = class {
   constructor(paths) {
@@ -12084,10 +12410,10 @@ var ConversationClearPlanStore = class {
     await writeJsonFile(this.planPath(normalizedPlanId), plan);
   }
   plansDir() {
-    return path13.join(this.paths.indexesDir, "conversation-clear-plans");
+    return path14.join(this.paths.indexesDir, "conversation-clear-plans");
   }
   planPath(planId) {
-    return path13.join(this.plansDir(), `${planId}.json`);
+    return path14.join(this.plansDir(), `${planId}.json`);
   }
 };
 function normalizePlanId2(planId) {
@@ -12926,14 +13252,14 @@ function readAttachmentWaveform(attachment) {
 
 // src/hermes/session-title.ts
 import { stat as stat8 } from "fs/promises";
-import path14 from "path";
+import path15 from "path";
 async function readHermesSessionTitle(sessionId, paths, profileName) {
   const trimmedSessionId = sessionId.trim();
   if (!trimmedSessionId) {
     return void 0;
   }
   const resolvedProfileName = isValidProfileName(profileName) ? profileName : "default";
-  const dbPath = path14.join(
+  const dbPath = path15.join(
     resolveHermesProfileDir(resolvedProfileName),
     "state.db"
   );
@@ -12954,7 +13280,7 @@ async function readHermesCompressionTip(sessionId, paths, profileName) {
     return void 0;
   }
   const resolvedProfileName = isValidProfileName(profileName) ? profileName : "default";
-  const dbPath = path14.join(
+  const dbPath = path15.join(
     resolveHermesProfileDir(resolvedProfileName),
     "state.db"
   );
@@ -13730,10 +14056,15 @@ var ConversationOrchestrationCoordinator = class {
         return;
       }
       try {
+        const failureMessage = await this.formatRunWorkerFailureMessage(
+          conversationId,
+          runId,
+          error
+        );
         await this.deps.runLifecycle.failRun(
           conversationId,
           runId,
-          error instanceof Error ? error.message : String(error)
+          failureMessage
         );
       } catch (failError) {
         if (isConversationNotFoundError(failError)) {
@@ -13760,6 +14091,26 @@ var ConversationOrchestrationCoordinator = class {
       });
     });
   }
+  async formatRunWorkerFailureMessage(conversationId, runId, error) {
+    if (error instanceof LinkHttpError && error.code === "hermes_agent_cli_missing") {
+      return createHermesCliMissingError(
+        void 0,
+        await this.readRunLanguage(conversationId, runId)
+      ).message;
+    }
+    if (isHermesExecutableMissingError(error)) {
+      return createHermesCliMissingError(
+        error,
+        await this.readRunLanguage(conversationId, runId)
+      ).message;
+    }
+    return error instanceof Error ? error.message : String(error);
+  }
+  async readRunLanguage(conversationId, runId) {
+    const snapshot = await this.deps.store.readSnapshot(conversationId).catch(() => null);
+    const run = snapshot?.runs.find((item) => item.id === runId);
+    return normalizeLanguage(run?.language);
+  }
   async startNextQueuedRunLocked(conversationId) {
     const manifest = await this.deps.store.readRunnableManifest(conversationId);
     const snapshot = await this.deps.store.readSnapshot(conversationId);
@@ -15297,7 +15648,7 @@ import {
   rm as rm5,
   writeFile as writeFile2
 } from "fs/promises";
-import path15 from "path";
+import path16 from "path";
 var ConversationStore = class {
   constructor(paths) {
     this.paths = paths;
@@ -15428,23 +15779,23 @@ var ConversationStore = class {
     return manifest != null && manifest.status !== "deleted_soft";
   }
   removeConversationAttachments(conversationId) {
-    return rm5(path15.join(this.conversationDir(conversationId), "attachments"), {
+    return rm5(path16.join(this.conversationDir(conversationId), "attachments"), {
       recursive: true,
       force: true
     });
   }
   conversationDir(conversationId) {
     assertValidConversationId(conversationId);
-    return path15.join(this.paths.conversationsDir, conversationId);
+    return path16.join(this.paths.conversationsDir, conversationId);
   }
   manifestPath(conversationId) {
-    return path15.join(this.conversationDir(conversationId), "manifest.json");
+    return path16.join(this.conversationDir(conversationId), "manifest.json");
   }
   snapshotPath(conversationId) {
-    return path15.join(this.conversationDir(conversationId), "snapshot.json");
+    return path16.join(this.conversationDir(conversationId), "snapshot.json");
   }
   eventsPath(conversationId) {
-    return path15.join(this.conversationDir(conversationId), "events.ndjson");
+    return path16.join(this.conversationDir(conversationId), "events.ndjson");
   }
 };
 function createEmptySnapshot2() {
@@ -15457,11 +15808,11 @@ function isNodeError9(error, code) {
 // src/conversations/hermes-session-sync.ts
 import { randomUUID as randomUUID10 } from "crypto";
 import { readdir as readdir7, readFile as readFile10, stat as stat10 } from "fs/promises";
-import path17 from "path";
+import path18 from "path";
 
 // src/conversations/delivery-import.ts
 import { lstat as lstat2, readFile as readFile9, readdir as readdir6, stat as stat9 } from "fs/promises";
-import path16 from "path";
+import path17 from "path";
 var MAX_IMPORTED_BLOB_BYTES = 100 * 1024 * 1024;
 var MAX_MEDIA_IMPORT_FAILURES = 20;
 var MAX_DELIVERY_FILES = 50;
@@ -15532,16 +15883,16 @@ var SUPPORTED_DELIVERY_EXTENSIONS = /* @__PURE__ */ new Set([
   ".m4a"
 ]);
 function resolveDeliveryStagingTarget(paths, stagingDir) {
-  const resolvedDir = path16.resolve(stagingDir);
-  const relative = path16.relative(path16.resolve(paths.conversationsDir), resolvedDir);
-  if (!relative || relative.startsWith("..") || path16.isAbsolute(relative)) {
+  const resolvedDir = path17.resolve(stagingDir);
+  const relative = path17.relative(path17.resolve(paths.conversationsDir), resolvedDir);
+  if (!relative || relative.startsWith("..") || path17.isAbsolute(relative)) {
     throw new LinkHttpError(
       400,
       "delivery_staging_invalid",
       "delivery staging directory must be inside Hermes Link conversations"
     );
   }
-  const segments = relative.split(path16.sep);
+  const segments = relative.split(path17.sep);
   if (segments.length !== 3 || segments[1] !== DELIVERY_STAGING_SEGMENT || !segments[0] || !segments[2]) {
     throw new LinkHttpError(
       400,
@@ -15577,7 +15928,7 @@ async function collectStagedDeliveryReferences(stagingDir) {
   return entries.filter((entry) => entry.isFile() && !entry.name.startsWith(".")).filter((entry) => isSupportedDeliveryFilename(entry.name)).sort(
     (left, right) => left.name.localeCompare(right.name, "en", { numeric: true })
   ).slice(0, MAX_DELIVERY_FILES).map((entry) => {
-    const sourcePath = path16.join(stagingDir, entry.name);
+    const sourcePath = path17.join(stagingDir, entry.name);
     const mime = inferMimeType(sourcePath);
     return {
       path: sourcePath,
@@ -15763,7 +16114,7 @@ async function writeBlobFromFile(deps, conversationId, source) {
   }
   return deps.writeBlob(conversationId, {
     bytes: await readFile9(sourcePath),
-    filename: path16.basename(sourcePath),
+    filename: path17.basename(sourcePath),
     mime: source.mime ?? inferMimeType(sourcePath)
   });
 }
@@ -15776,7 +16127,7 @@ function describeMediaImportFailure(reference, sourceKey, error) {
   };
 }
 function isSupportedDeliveryFilename(filename) {
-  return SUPPORTED_DELIVERY_EXTENSIONS.has(path16.extname(filename).toLowerCase());
+  return SUPPORTED_DELIVERY_EXTENSIONS.has(path17.extname(filename).toLowerCase());
 }
 function readString9(payload, key) {
   const value = payload[key];
@@ -15834,7 +16185,7 @@ async function syncHermesSessionsIntoConversations(paths, logger, options = {})
   const candidates = [];
   for (const profileName of profileNames) {
     const profileDir = resolveHermesProfileDir(profileName);
-    const dbPath = path17.join(profileDir, "state.db");
+    const dbPath = path18.join(profileDir, "state.db");
     const sessions = await listProfileSessions(dbPath).catch((error) => {
       result.errors.push({
         profile: profileName,
@@ -15950,7 +16301,7 @@ async function syncHermesCronSessionIntoConversations(paths, logger, input) {
   const knownHermesSessions = await readKnownHermesSessions(store);
   const profileName = input.profileName.trim() || DEFAULT_PROFILE_NAME;
   const profileDir = resolveHermesProfileDir(profileName);
-  const dbPath = path17.join(profileDir, "state.db");
+  const dbPath = path18.join(profileDir, "state.db");
   const sessions = await listProfileSessionsByIdPrefix(
     dbPath,
     `cron_${jobId}_`
@@ -17261,8 +17612,8 @@ async function readJsonlMessages(profileName, sessionId) {
     return [];
   }
   const profileDir = resolveHermesProfileDir(profileName);
-  const sessionsDir = await readHermesSessionsDir(profileName).then((value) => value.sessionsDir).catch(() => path17.join(profileDir, "sessions"));
-  const transcriptPath = path17.join(sessionsDir, `${sessionId}.jsonl`);
+  const sessionsDir = await readHermesSessionsDir(profileName).then((value) => value.sessionsDir).catch(() => path18.join(profileDir, "sessions"));
+  const transcriptPath = path18.join(sessionsDir, `${sessionId}.jsonl`);
   const raw = await readFile10(transcriptPath, "utf8").catch((error) => {
     if (isNodeError11(error, "ENOENT")) {
       return "";
@@ -17632,7 +17983,7 @@ function isNodeError11(error, code) {
 
 // src/conversations/delivery-context.ts
 import { copyFile, mkdir as mkdir11, stat as stat11 } from "fs/promises";
-import path18 from "path";
+import path19 from "path";
 var ACTIVE_CONTEXTS = /* @__PURE__ */ new Map();
 var CONTEXT_TTL_MS = 2 * 60 * 60 * 1e3;
 var MAX_DELIVERY_TOOL_FILES = 50;
@@ -17704,10 +18055,10 @@ function findDeliveryContext(input) {
   );
 }
 async function copyFilesIntoDeliveryContext(paths, context, files) {
-  const stagingDir = path18.resolve(context.stagingDir);
-  const conversationsRoot = path18.resolve(paths.conversationsDir);
-  const relative = path18.relative(conversationsRoot, stagingDir);
-  if (!relative || relative.startsWith("..") || path18.isAbsolute(relative)) {
+  const stagingDir = path19.resolve(context.stagingDir);
+  const conversationsRoot = path19.resolve(paths.conversationsDir);
+  const relative = path19.relative(conversationsRoot, stagingDir);
+  if (!relative || relative.startsWith("..") || path19.isAbsolute(relative)) {
     throw new LinkHttpError(
       400,
       "delivery_staging_invalid",
@@ -17718,13 +18069,13 @@ async function copyFilesIntoDeliveryContext(paths, context, files) {
   const result = { staged: [], skipped: [] };
   const usedNames = /* @__PURE__ */ new Set();
   for (const [index, file] of files.slice(0, MAX_DELIVERY_TOOL_FILES).entries()) {
-    const sourcePath = path18.resolve(file.path);
+    const sourcePath = path19.resolve(file.path);
     let baseName = sanitizeFilename(
-      file.caption || path18.basename(sourcePath),
+      file.caption || path19.basename(sourcePath),
       `attachment-${index + 1}`
     );
-    const sourceExtension = path18.extname(sourcePath);
-    if (!path18.extname(baseName) && sourceExtension) {
+    const sourceExtension = path19.extname(sourcePath);
+    if (!path19.extname(baseName) && sourceExtension) {
       baseName = `${baseName}${sourceExtension}`;
     }
     const filename = uniqueStagingFilename(
@@ -17751,7 +18102,7 @@ async function copyFilesIntoDeliveryContext(paths, context, files) {
       });
       continue;
     }
-    const targetPath = path18.join(stagingDir, filename);
+    const targetPath = path19.join(stagingDir, filename);
     await copyFile(sourcePath, targetPath);
     result.staged.push({
       source_path: sourcePath,
@@ -17794,7 +18145,7 @@ function normalizeDeliveryFileInputs(value) {
   });
 }
 function uniqueStagingFilename(filename, usedNames) {
-  const extension = path18.extname(filename);
+  const extension = path19.extname(filename);
   const stem = filename.slice(0, filename.length - extension.length);
   let candidate = filename;
   let suffix = 2;
@@ -18291,10 +18642,10 @@ function parseHermesApiCapabilities(payload) {
     sessionKeyHeader: readString12(features, "session_key_header")
   };
 }
-async function callHermesApi(path34, init, options) {
+async function callHermesApi(path35, init, options) {
   const method = init.method ?? "GET";
   const startedAt = Date.now();
-  void options.logger?.debug("hermes_api_request_started", { method, path: path34 });
+  void options.logger?.debug("hermes_api_request_started", { method, path: path35 });
   const availability = await ensureHermesApiServerAvailable({
     fetchImpl: options.fetchImpl,
     logger: options.logger,
@@ -18303,7 +18654,7 @@ async function callHermesApi(path34, init, options) {
   });
   let config = availability.configResult.apiServer;
   const fetcher = options.fetchImpl ?? fetch;
-  const request = () => fetchHermesApi(fetcher, config, path34, init, options);
+  const request = () => fetchHermesApi(fetcher, config, path35, init, options);
   let response;
   try {
     response = await request();
@@ -18311,7 +18662,7 @@ async function callHermesApi(path34, init, options) {
     logHermesApiError(
       options.logger,
       method,
-      path34,
+      path35,
       options.profileName,
       startedAt,
       error
@@ -18322,7 +18673,7 @@ async function callHermesApi(path34, init, options) {
     logHermesApiResponse(
       options.logger,
       method,
-      path34,
+      path35,
       options.profileName,
       startedAt,
       response
@@ -18331,7 +18682,7 @@ async function callHermesApi(path34, init, options) {
   }
   void options.logger?.warn("hermes_api_request_retrying_after_401", {
     method,
-    path: path34,
+    path: path35,
     profile: options.profileName ?? "default",
     port: config.port ?? null,
     duration_ms: Date.now() - startedAt
@@ -18350,7 +18701,7 @@ async function callHermesApi(path34, init, options) {
     logHermesApiError(
       options.logger,
       method,
-      path34,
+      path35,
       options.profileName,
       startedAt,
       error
@@ -18360,7 +18711,7 @@ async function callHermesApi(path34, init, options) {
   logHermesApiResponse(
     options.logger,
     method,
-    path34,
+    path35,
     options.profileName,
     startedAt,
     response
@@ -18370,7 +18721,7 @@ async function callHermesApi(path34, init, options) {
   }
   void options.logger?.warn("hermes_api_request_repairing_after_401", {
     method,
-    path: path34,
+    path: path35,
     profile: options.profileName ?? "default",
     port: config.port ?? null,
     duration_ms: Date.now() - startedAt
@@ -18391,7 +18742,7 @@ async function callHermesApi(path34, init, options) {
     logHermesApiError(
       options.logger,
       method,
-      path34,
+      path35,
       options.profileName,
       startedAt,
       error
@@ -18401,21 +18752,21 @@ async function callHermesApi(path34, init, options) {
   logHermesApiResponse(
     options.logger,
     method,
-    path34,
+    path35,
     options.profileName,
     startedAt,
     response
   );
   return response;
 }
-async function fetchHermesApi(fetcher, config, path34, init, options) {
+async function fetchHermesApi(fetcher, config, path35, 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}${path34}`, {
+  return await fetcher(`http://127.0.0.1:${config.port}${path35}`, {
     ...init,
     headers
   }).catch((error) => {
@@ -18424,10 +18775,10 @@ async function fetchHermesApi(fetcher, config, path34, init, options) {
     }
     void options.logger?.warn("hermes_api_server_connect_failed", {
       method: String(init.method ?? "GET").toUpperCase(),
-      path: path34,
+      path: path35,
       profile: options.profileName ?? "default",
       port: config.port ?? null,
-      url: `http://127.0.0.1:${config.port}${path34}`,
+      url: `http://127.0.0.1:${config.port}${path35}`,
       error: error instanceof Error ? error.message : String(error)
     });
     throw new LinkHttpError(
@@ -18437,10 +18788,10 @@ async function fetchHermesApi(fetcher, config, path34, init, options) {
     );
   });
 }
-function logHermesApiResponse(logger, method, path34, profileName, startedAt, response) {
+function logHermesApiResponse(logger, method, path35, profileName, startedAt, response) {
   const fields = {
     method,
-    path: path34,
+    path: path35,
     profile: profileName ?? "default",
     status: response.status,
     duration_ms: Date.now() - startedAt
@@ -18461,10 +18812,10 @@ async function logHermesApiFailureResponse(logger, fields, response) {
     ...upstreamError ? { upstream_error: upstreamError } : {}
   });
 }
-function logHermesApiError(logger, method, path34, profileName, startedAt, error) {
+function logHermesApiError(logger, method, path35, profileName, startedAt, error) {
   void logger?.warn("hermes_api_request_failed", {
     method,
-    path: path34,
+    path: path35,
     profile: profileName ?? "default",
     duration_ms: Date.now() - startedAt,
     ...error instanceof LinkHttpError ? { status: error.status, code: error.code } : {},
@@ -18532,7 +18883,7 @@ function readBoolean2(payload, key) {
 
 // src/conversations/history-builder.ts
 import { readFile as readFile11, stat as stat12 } from "fs/promises";
-import path19 from "path";
+import path20 from "path";
 var HISTORY_ROLES = /* @__PURE__ */ new Set(["user", "assistant"]);
 var HERMES_HISTORY_COLUMNS = [
   "role",
@@ -18604,13 +18955,13 @@ async function readHermesTranscriptHistory(sessionId, profileName) {
   }
   const normalizedProfileName = isValidProfileName2(profileName) ? profileName : "default";
   const profileDir = resolveHermesProfileDir(normalizedProfileName);
-  const dbPath = path19.join(profileDir, "state.db");
+  const dbPath = path20.join(profileDir, "state.db");
   const sessionsDirConfig = await readHermesSessionsDir(normalizedProfileName).then((value) => ({
     sessionsDir: value.sessionsDir,
     configured: value.configured,
     configError: false
   })).catch(() => ({
-    sessionsDir: path19.join(profileDir, "sessions"),
+    sessionsDir: path20.join(profileDir, "sessions"),
     configured: false,
     configError: true
   }));
@@ -18786,8 +19137,8 @@ async function readFirstExistingFile(paths) {
 }
 function candidateTranscriptPaths(sessionsDir, sessionId, extension) {
   return [
-    path19.join(sessionsDir, `session_${sessionId}.${extension}`),
-    path19.join(sessionsDir, `${sessionId}.${extension}`)
+    path20.join(sessionsDir, `session_${sessionId}.${extension}`),
+    path20.join(sessionsDir, `${sessionId}.${extension}`)
   ];
 }
 function readHistoryRows(dbPath, sessionId) {
@@ -19006,8 +19357,8 @@ function normalizeProfileForCompare(value) {
 // src/hermes/stt.ts
 import { execFile as execFile3 } from "child_process";
 import { access as access2, readFile as readFile12, stat as stat13 } from "fs/promises";
-import os4 from "os";
-import path20 from "path";
+import os5 from "os";
+import path21 from "path";
 import { promisify as promisify3 } from "util";
 var execFileAsync3 = promisify3(execFile3);
 var STT_RESULT_PREFIX = "__HERMES_LINK_STT__";
@@ -19102,7 +19453,7 @@ async function buildHermesSttEnv(profileName, hermesSourceRoot) {
   };
   const sourceRoot = hermesSourceRoot ?? await findDevHermesAgentSource();
   if (sourceRoot) {
-    env.PYTHONPATH = [sourceRoot, env.PYTHONPATH].filter(Boolean).join(path20.delimiter);
+    env.PYTHONPATH = [sourceRoot, env.PYTHONPATH].filter(Boolean).join(path21.delimiter);
   }
   return env;
 }
@@ -19139,7 +19490,7 @@ async function resolveHermesPythonRuntime() {
       sourceRoot: await findExplicitHermesSourceRoot() ?? await findHermesSourceRoot(explicit)
     };
   }
-  const hermesBin = await resolveExecutablePath2(resolveHermesBin());
+  const hermesBin = await resolveExecutablePath(resolveHermesBin());
   let shebangRuntime = null;
   if (hermesBin) {
     const launcherTarget = await readHermesLauncherTarget(hermesBin);
@@ -19196,23 +19547,23 @@ async function resolveHermesPythonRuntime() {
     sourceRoot: await findExplicitHermesSourceRoot() ?? await findDevHermesAgentSource()
   };
 }
-async function resolveExecutablePath2(command) {
-  if (path20.isAbsolute(command)) {
-    return await isExecutableFile(command) ? command : null;
+async function resolveExecutablePath(command) {
+  if (path21.isAbsolute(command)) {
+    return await isExecutableFile2(command) ? command : null;
   }
   const pathEnv = process.env.PATH ?? "";
   const extensions = process.platform === "win32" ? (process.env.PATHEXT ?? ".EXE;.CMD;.BAT").split(";") : [""];
-  for (const dir of pathEnv.split(path20.delimiter)) {
+  for (const dir of pathEnv.split(path21.delimiter)) {
     for (const extension of extensions) {
-      const candidate = path20.join(dir, `${command}${extension}`);
-      if (await isExecutableFile(candidate)) {
+      const candidate = path21.join(dir, `${command}${extension}`);
+      if (await isExecutableFile2(candidate)) {
         return candidate;
       }
     }
   }
   return null;
 }
-async function isExecutableFile(filePath) {
+async function isExecutableFile2(filePath) {
   try {
     const info = await stat13(filePath);
     if (!info.isFile()) {
@@ -19226,14 +19577,14 @@ async function isExecutableFile(filePath) {
 }
 async function findHermesVenvPython(sourceRoot) {
   const candidates = process.platform === "win32" ? [
-    path20.join(sourceRoot, "venv", "Scripts", "python.exe"),
-    path20.join(sourceRoot, ".venv", "Scripts", "python.exe")
+    path21.join(sourceRoot, "venv", "Scripts", "python.exe"),
+    path21.join(sourceRoot, ".venv", "Scripts", "python.exe")
   ] : [
-    path20.join(sourceRoot, "venv", "bin", "python"),
-    path20.join(sourceRoot, ".venv", "bin", "python")
+    path21.join(sourceRoot, "venv", "bin", "python"),
+    path21.join(sourceRoot, ".venv", "bin", "python")
   ];
   for (const candidate of candidates) {
-    if (await isExecutableFile(candidate)) {
+    if (await isExecutableFile2(candidate)) {
       return candidate;
     }
   }
@@ -19259,8 +19610,8 @@ function shebangToPythonCommand(shebang) {
 }
 async function findDevHermesAgentSource() {
   const candidates = [
-    path20.resolve(process.cwd(), "reference/hermes-agent"),
-    path20.resolve(process.cwd(), "../../reference/hermes-agent")
+    path21.resolve(process.cwd(), "reference/hermes-agent"),
+    path21.resolve(process.cwd(), "../../reference/hermes-agent")
   ];
   for (const candidate of candidates) {
     if (await isHermesAgentSourceRoot(candidate)) {
@@ -19276,10 +19627,10 @@ async function readHermesLauncherTarget(filePath) {
       line
     );
     const rawTarget = quoted?.groups?.target ?? /^\s*exec\s+(?<target>\S+)\s+(?:"\$@"|'\$@')/.exec(line)?.groups?.target;
-    if (!rawTarget || !path20.isAbsolute(rawTarget)) {
+    if (!rawTarget || !path21.isAbsolute(rawTarget)) {
       continue;
     }
-    if (await isExecutableFile(rawTarget)) {
+    if (await isExecutableFile2(rawTarget)) {
       return rawTarget;
     }
   }
@@ -19306,12 +19657,12 @@ async function resolveHermesEntrypointRuntime(entrypointPath) {
   return null;
 }
 async function findHermesSourceRoot(executablePath) {
-  let cursor = path20.dirname(path20.resolve(executablePath));
+  let cursor = path21.dirname(path21.resolve(executablePath));
   for (let index = 0; index < 6; index += 1) {
     if (await isHermesAgentSourceRoot(cursor)) {
       return cursor;
     }
-    const parent = path20.dirname(cursor);
+    const parent = path21.dirname(cursor);
     if (parent === cursor) {
       break;
     }
@@ -19322,14 +19673,14 @@ async function findHermesSourceRoot(executablePath) {
 function hermesSourceRootCandidates() {
   const candidates = [
     process.env.HERMES_PYTHON_SRC_ROOT?.trim(),
-    path20.join(os4.homedir(), ".hermes", "hermes-agent"),
+    path21.join(os5.homedir(), ".hermes", "hermes-agent"),
     "/usr/local/lib/hermes-agent",
     "/opt/hermes"
   ].filter((candidate) => Boolean(candidate));
   if (process.platform === "win32") {
     const localAppData = process.env.LOCALAPPDATA?.trim();
     if (localAppData) {
-      candidates.unshift(path20.join(localAppData, "hermes", "hermes-agent"));
+      candidates.unshift(path21.join(localAppData, "hermes", "hermes-agent"));
     }
   }
   return candidates;
@@ -19339,7 +19690,7 @@ async function findExplicitHermesSourceRoot() {
   return explicit && await isHermesAgentSourceRoot(explicit) ? explicit : null;
 }
 async function isHermesAgentSourceRoot(candidate) {
-  return await isDirectory(candidate) && await isDirectory(path20.join(candidate, "tools")) && await isDirectory(path20.join(candidate, "hermes_cli"));
+  return await isDirectory(candidate) && await isDirectory(path21.join(candidate, "tools")) && await isDirectory(path21.join(candidate, "hermes_cli"));
 }
 async function isDirectory(candidate) {
   return stat13(candidate).then((info) => info.isDirectory()).catch(() => false);
@@ -19351,13 +19702,13 @@ function compactProcessOutput(value) {
 
 // src/hermes/usage-probe.ts
 import { open as open3, readFile as readFile14, rm as rm6, stat as stat15 } from "fs/promises";
-import path22 from "path";
+import path23 from "path";
 import YAML3 from "yaml";
 
 // src/hermes/profiles.ts
 import { execFile as execFile4 } from "child_process";
 import { readdir as readdir8, readFile as readFile13, rename as rename3, stat as stat14 } from "fs/promises";
-import path21 from "path";
+import path22 from "path";
 import { setTimeout as delay4 } from "timers/promises";
 import { promisify as promisify4 } from "util";
 import YAML2 from "yaml";
@@ -19500,7 +19851,7 @@ async function readHermesProfileCapabilities(name) {
   return {
     defaultModel: listedModels?.defaultModel ?? null,
     modelCount: listedModels?.models.length ?? 0,
-    skillCount: await countSkills(path21.join(profileDir, "skills")).catch(
+    skillCount: await countSkills(path22.join(profileDir, "skills")).catch(
       () => 0
     ),
     toolCount: await countConfiguredTools(name).catch(() => 0)
@@ -19561,7 +19912,7 @@ async function hasDefaultProfileConfigSource() {
   if (!profileStat?.isDirectory()) {
     return false;
   }
-  return await pathExists(resolveHermesConfigPath(DEFAULT_PROFILE)) || await pathExists(path21.join(profilePath, ".env"));
+  return await pathExists(resolveHermesConfigPath(DEFAULT_PROFILE)) || await pathExists(path22.join(profilePath, ".env"));
 }
 async function deleteHermesProfileWithCli(name) {
   try {
@@ -19731,7 +20082,7 @@ async function countSkills(root) {
   );
   let count = 0;
   for (const entry of entries) {
-    const entryPath = path21.join(root, entry.name);
+    const entryPath = path22.join(root, entry.name);
     if (entry.name === ".git" || entry.name === ".hub") {
       continue;
     }
@@ -19824,7 +20175,7 @@ async function ensureHermesUsageProbeForProfile(profileName, options = {}) {
   const normalizedProfile = normalizeProfileName4(profileName);
   const profilePath = resolveHermesProfileDir(normalizedProfile);
   const configPath = resolveHermesConfigPath(normalizedProfile);
-  const pluginPath = path22.join(
+  const pluginPath = path23.join(
     profilePath,
     "plugins",
     HERMES_USAGE_PROBE_PLUGIN_KEY
@@ -19850,7 +20201,7 @@ async function ensureHermesUsageProbeForProfile(profileName, options = {}) {
     return { ...base(), skipped: true };
   }
   try {
-    await ensureDirectoryWithInheritedMetadata(path22.dirname(eventsPath), 448);
+    await ensureDirectoryWithInheritedMetadata(path23.dirname(eventsPath), 448);
     const state = await readUsageProbeState(paths);
     const pluginState = state.profiles[normalizedProfile];
     const currentConfig = await readUsageProbeConfigStatus({
@@ -19983,7 +20334,7 @@ async function findHermesUsageProbeEventForRun(input) {
   return aggregateUsageProbeEvents(events.sort(compareUsageProbeEventsByTime));
 }
 function resolveUsageProbeEventsPath(paths = resolveRuntimePaths(), profileName = "default") {
-  return path22.join(
+  return path23.join(
     paths.homeDir,
     USAGE_PROBE_DIR,
     safeProfileSegment(profileName),
@@ -20007,8 +20358,8 @@ function summarizeUsageProbeEnsure(result) {
   };
 }
 async function writeUsageProbePlugin(input) {
-  const manifestPath = path22.join(input.pluginPath, "plugin.yaml");
-  const initPath = path22.join(input.pluginPath, "__init__.py");
+  const manifestPath = path23.join(input.pluginPath, "plugin.yaml");
+  const initPath = path23.join(input.pluginPath, "__init__.py");
   const manifest = usageProbeManifest();
   const source = usageProbePythonSource(
     input.profileName,
@@ -20355,9 +20706,9 @@ async function disableUsageProbeAfterActivationFailure(input) {
   });
 }
 async function cleanupLegacyUsageProbePlugin(profilePath) {
-  const legacyPath = path22.join(profilePath, "plugins", LEGACY_PLUGIN_KEY);
+  const legacyPath = path23.join(profilePath, "plugins", LEGACY_PLUGIN_KEY);
   const [manifest, init] = await Promise.all([
-    readFile14(path22.join(legacyPath, "plugin.yaml"), "utf8").catch(
+    readFile14(path23.join(legacyPath, "plugin.yaml"), "utf8").catch(
       (error) => {
         if (isNodeError15(error, "ENOENT")) {
           return null;
@@ -20365,7 +20716,7 @@ async function cleanupLegacyUsageProbePlugin(profilePath) {
         throw error;
       }
     ),
-    readFile14(path22.join(legacyPath, "__init__.py"), "utf8").catch(
+    readFile14(path23.join(legacyPath, "__init__.py"), "utf8").catch(
       (error) => {
         if (isNodeError15(error, "ENOENT")) {
           return null;
@@ -20414,7 +20765,7 @@ async function rememberUsageProbeState(paths, profileName, patch) {
   }));
 }
 function usageProbeStatePath(paths) {
-  return path22.join(paths.homeDir, USAGE_PROBE_DIR, USAGE_PROBE_STATE_FILE);
+  return path23.join(paths.homeDir, USAGE_PROBE_DIR, USAGE_PROBE_STATE_FILE);
 }
 async function readHermesConfigDocument2(configPath, language) {
   const existingRaw = await readFile14(configPath, "utf8").catch(
@@ -21017,7 +21368,7 @@ function isRunToolResultCompensationEnabled(env = process.env) {
 
 // src/conversations/run-transcript-enrichment.ts
 import { readFile as readFile15, stat as stat16 } from "fs/promises";
-import path23 from "path";
+import path24 from "path";
 var MESSAGE_COLUMNS2 = [
   "id",
   "session_id",
@@ -21093,8 +21444,8 @@ async function readRunFinalAssistantText(input) {
 }
 async function readHermesTranscriptRows(profileName, sessionId) {
   const profileDir = resolveHermesProfileDir(profileName);
-  const dbPath = path23.join(profileDir, "state.db");
-  const sessionsDir = await readHermesSessionsDir(profileName).then((value) => value.sessionsDir).catch(() => path23.join(profileDir, "sessions"));
+  const dbPath = path24.join(profileDir, "state.db");
+  const sessionsDir = await readHermesSessionsDir(profileName).then((value) => value.sessionsDir).catch(() => path24.join(profileDir, "sessions"));
   const [dbRows, jsonlRows] = await Promise.all([
     readStateDbMessages2(dbPath, sessionId),
     readJsonlMessages2(sessionsDir, sessionId)
@@ -21157,7 +21508,7 @@ async function readJsonlMessages2(sessionsDir, sessionId) {
   if (!/^[A-Za-z0-9._:-]{1,160}$/u.test(sessionId)) {
     return [];
   }
-  const transcriptPath = path23.join(sessionsDir, `${sessionId}.jsonl`);
+  const transcriptPath = path24.join(sessionsDir, `${sessionId}.jsonl`);
   const raw = await readFile15(transcriptPath, "utf8").catch((error) => {
     if (isNodeError16(error, "ENOENT")) {
       return "";
@@ -22150,6 +22501,7 @@ var ConversationRunLifecycle = class {
           profileName: run.profile,
           signal: controller.signal,
           logger: this.deps.logger,
+          language: run.language === "en" ? "en" : "zh-CN",
           paths: this.deps.paths
         });
         await this.updateRun(conversationId, runId, {
@@ -23489,7 +23841,7 @@ ${details.join("\n")}` : localizedEmptyHermesResponseMessage(language);
         payload: { message: assistant }
       });
     }
-    const contextUsage = contextUsagePayload(run);
+    const contextUsage = contextUsagePayloadForSnapshot(snapshot);
     await this.deps.appendEvent(conversationId, {
       type: "run.completed",
       message_id: assistant?.id,
@@ -23557,7 +23909,7 @@ ${details.join("\n")}` : localizedEmptyHermesResponseMessage(language);
       assistant?.id,
       expiredApprovals
     );
-    const contextUsage = contextUsagePayload(run);
+    const contextUsage = contextUsagePayloadForSnapshot(snapshot);
     await this.deps.appendEvent(conversationId, {
       type: "run.failed",
       message_id: assistant?.id,
@@ -23760,11 +24112,16 @@ ${details.join("\n")}` : localizedEmptyHermesResponseMessage(language);
         payload: { message: assistant, cancelled: true }
       });
     }
+    const contextUsage = contextUsagePayloadForSnapshot(snapshot);
     const event = await this.deps.appendEvent(conversationId, {
       type: "run.cancelled",
       message_id: assistant?.id,
       run_id: runId,
-      payload: { run, reason: options.reason }
+      payload: {
+        run,
+        reason: options.reason,
+        ...contextUsage ? { context: contextUsage } : {}
+      }
     });
     await this.deps.persistConversationStats(conversationId, snapshot);
     void this.deps.logger.info("conversation_run_cancelled", {
@@ -24126,6 +24483,10 @@ function appendAgentEventBlock2(message, event, updatedAt) {
   }
   message.blocks = blocks;
 }
+function contextUsagePayloadForSnapshot(snapshot) {
+  const run = latestContextUsageRun(snapshot);
+  return run ? contextUsagePayload(run) : null;
+}
 function contextUsagePayload(run) {
   const usage = run.usage;
   const runtimeContext = resolveRuntimeContextUsage({
@@ -25612,7 +25973,7 @@ var ConversationService = class {
     }
   }
   hermesArchiveStateSyncMarkerPath() {
-    return path24.join(this.paths.indexesDir, "hermes-archive-state-sync.json");
+    return path25.join(this.paths.indexesDir, "hermes-archive-state-sync.json");
   }
   prepareClearAllConversationPlan(targetStatus) {
     return this.maintenance.prepareClearAllConversationPlan(targetStatus);
@@ -27498,11 +27859,11 @@ function isSseRequestContext(ctx) {
   }
   return isSseRequestPath(ctx.path) || isActiveSseSocket(ctx.req.socket);
 }
-function isSseRequestPath(path34) {
-  if (!path34) {
+function isSseRequestPath(path35) {
+  if (!path35) {
     return false;
   }
-  return path34 === "/api/v1/conversations/events" || path34 === "/api/v1/profile-creation/events" || path34 === "/api/v1/hermes/update/events" || path34 === "/api/v1/link/update/events" || /^\/api\/v1\/conversations\/[^/]+\/events$/u.test(path34) || /^\/api\/v1\/runs\/[^/]+\/events$/u.test(path34);
+  return path35 === "/api/v1/conversations/events" || path35 === "/api/v1/profile-creation/events" || path35 === "/api/v1/hermes/update/events" || path35 === "/api/v1/link/update/events" || /^\/api\/v1\/conversations\/[^/]+\/events$/u.test(path35) || /^\/api\/v1\/runs\/[^/]+\/events$/u.test(path35);
 }
 function isExpectedClientDisconnectError2(error, options = {}) {
   if (!(error instanceof Error)) {
@@ -28334,7 +28695,7 @@ function errorMessage3(error) {
 
 // src/hermes/profile-identity.ts
 import { readFile as readFile16, stat as stat17 } from "fs/promises";
-import path25 from "path";
+import path26 from "path";
 var MAX_SOUL_MD_LENGTH = 2e4;
 async function readHermesProfileIdentity(profileName, paths) {
   await assertProfileExists3(profileName, paths);
@@ -28391,7 +28752,7 @@ async function assertProfileExists3(profileName, paths) {
   }
 }
 function resolveSoulPath(profileName) {
-  return path25.join(resolveHermesProfileDir(profileName), "SOUL.md");
+  return path26.join(resolveHermesProfileDir(profileName), "SOUL.md");
 }
 function isNodeError18(error, code) {
   return error instanceof Error && "code" in error && error.code === code;
@@ -28407,13 +28768,13 @@ import {
   rm as rm7,
   stat as stat19
 } from "fs/promises";
-import path27 from "path";
+import path28 from "path";
 import YAML5 from "yaml";
 
 // src/hermes/link-skill.ts
 import { readFile as readFile17, stat as stat18 } from "fs/promises";
-import os5 from "os";
-import path26 from "path";
+import os6 from "os";
+import path27 from "path";
 import YAML4 from "yaml";
 var HERMES_LINK_SKILL_ROOT_DIR = "hermes-skills";
 var HERMES_LINK_SKILL_DIR = "hermes-link";
@@ -28498,7 +28859,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 = path26.join(
+  const skillPath = path27.join(
     externalDir,
     HERMES_LINK_SKILL_DIR,
     HERMES_LINK_SKILL_FILE
@@ -28580,7 +28941,7 @@ function withDefaultProfilePlaceholder2(profiles) {
   ];
 }
 function resolveHermesLinkSkillExternalDir(paths = resolveRuntimePaths()) {
-  return path26.join(paths.homeDir, HERMES_LINK_SKILL_ROOT_DIR);
+  return path27.join(paths.homeDir, HERMES_LINK_SKILL_ROOT_DIR);
 }
 async function writeHermesLinkSkill(skillPath) {
   const existing = await readFile17(skillPath, "utf8").catch((error) => {
@@ -28675,11 +29036,11 @@ function appendExternalDir(current, externalDir, hermesHome) {
   const seen = new Set(
     entries.map((entry) => resolveExternalDirEntry(entry, hermesHome))
   );
-  const normalizedExternalDir = path26.resolve(externalDir);
+  const normalizedExternalDir = path27.resolve(externalDir);
   return seen.has(normalizedExternalDir) ? entries : [...entries, normalizedExternalDir];
 }
 function externalDirsInclude(current, externalDir, hermesHome) {
-  const normalizedExternalDir = path26.resolve(externalDir);
+  const normalizedExternalDir = path27.resolve(externalDir);
   return readExternalDirEntries(current).some(
     (entry) => resolveExternalDirEntry(entry, hermesHome) === normalizedExternalDir
   );
@@ -28690,14 +29051,14 @@ function readExternalDirEntries(value) {
 }
 function resolveExternalDirEntry(entry, hermesHome) {
   const expanded = expandHome(expandEnvVars(entry));
-  return path26.resolve(path26.isAbsolute(expanded) ? expanded : path26.join(hermesHome, expanded));
+  return path27.resolve(path27.isAbsolute(expanded) ? expanded : path27.join(hermesHome, expanded));
 }
 function expandHome(value) {
   if (value === "~") {
-    return os5.homedir();
+    return os6.homedir();
   }
-  if (value.startsWith(`~${path26.sep}`) || value.startsWith("~/")) {
-    return path26.join(os5.homedir(), value.slice(2));
+  if (value.startsWith(`~${path27.sep}`) || value.startsWith("~/")) {
+    return path27.join(os6.homedir(), value.slice(2));
   }
   return value;
 }
@@ -29249,7 +29610,7 @@ function collectEnvKeys(value, keys = /* @__PURE__ */ new Set()) {
   return keys;
 }
 async function writeEnvValues(profileName, values) {
-  const envPath = path27.join(resolveHermesProfileDir(profileName), ".env");
+  const envPath = path28.join(resolveHermesProfileDir(profileName), ".env");
   const existingRaw = await readFile18(envPath, "utf8").catch((error) => {
     if (isNodeError20(error, "ENOENT")) {
       return "";
@@ -29286,8 +29647,8 @@ async function writeEnvValues(profileName, values) {
   await atomicWriteFilePreservingMetadata(envPath, nextRaw);
 }
 async function copySkills(sourceProfile, targetProfile) {
-  const sourceSkills = path27.join(resolveHermesProfileDir(sourceProfile), "skills");
-  const targetSkills = path27.join(resolveHermesProfileDir(targetProfile), "skills");
+  const sourceSkills = path28.join(resolveHermesProfileDir(sourceProfile), "skills");
+  const targetSkills = path28.join(resolveHermesProfileDir(targetProfile), "skills");
   if (!await pathExists2(sourceSkills)) {
     return;
   }
@@ -29382,10 +29743,10 @@ async function readProfileCreationLogLines(paths) {
   );
 }
 function profileCreationStatePath(paths) {
-  return path27.join(paths.runDir, "profile-create-state.json");
+  return path28.join(paths.runDir, "profile-create-state.json");
 }
 function profileCreationLogPath(paths) {
-  return path27.join(paths.logsDir, PROFILE_CREATE_LOG_FILE);
+  return path28.join(paths.logsDir, PROFILE_CREATE_LOG_FILE);
 }
 async function clearProfileCreationLogFiles(paths) {
   const primary = profileCreationLogPath(paths);
@@ -29674,7 +30035,7 @@ import {
   readFile as readFile19,
   stat as stat20
 } from "fs/promises";
-import path28 from "path";
+import path29 from "path";
 import YAML6 from "yaml";
 var ENTRY_DELIMITER = "\n\xA7\n";
 var DEFAULT_MEMORY_LIMIT = 2200;
@@ -30005,7 +30366,7 @@ async function saveProviderSettings(profileName, provider, patch) {
     });
     await patchJsonProviderConfig(
       profileName,
-      path28.join("hindsight", "config.json"),
+      path29.join("hindsight", "config.json"),
       {
         mode: patch.mode,
         api_url: patch.apiUrl,
@@ -30208,7 +30569,7 @@ async function patchHermesMemoryLimits(profileName, patch) {
   await atomicWriteFilePreservingMetadata(configPath, document.toString());
 }
 function resolveMemoryDir(profileName) {
-  return path28.join(resolveHermesProfileDir(profileName), "memories");
+  return path29.join(resolveHermesProfileDir(profileName), "memories");
 }
 async function readMemoryStore(profileName, target, limits) {
   const filePath = memoryFilePath(profileName, target);
@@ -30269,7 +30630,7 @@ async function writeMemoryEntries(profileName, target, entries) {
   );
 }
 function memoryFilePath(profileName, target) {
-  return path28.join(
+  return path29.join(
     resolveMemoryDir(profileName),
     target === "user" ? "USER.md" : "MEMORY.md"
   );
@@ -30329,7 +30690,7 @@ async function readCustomProviderSetupSummary(profileName) {
     configurable: true,
     configured: true,
     configurationIssue: null,
-    providerConfigPath: path28.join(
+    providerConfigPath: path29.join(
       resolveHermesProfileDir(profileName),
       "<provider>.json"
     ),
@@ -30723,7 +31084,7 @@ async function readProviderSettings(profileName, provider) {
       stringSetting(
         "dbPath",
         "SQLite \u6570\u636E\u5E93\u8DEF\u5F84",
-        config.db_path ?? path28.join(resolveHermesProfileDir(profileName), "memory_store.db")
+        config.db_path ?? path29.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),
@@ -30759,7 +31120,7 @@ async function readProviderSettings(profileName, provider) {
       stringSetting(
         "workingDirectory",
         "\u5DE5\u4F5C\u76EE\u5F55",
-        path28.join(resolveHermesProfileDir(profileName), "byterover"),
+        path29.join(resolveHermesProfileDir(profileName), "byterover"),
         false
       )
     ];
@@ -30768,16 +31129,16 @@ async function readProviderSettings(profileName, provider) {
 }
 function memoryProviderConfigPath(profileName, provider) {
   if (provider === "honcho") {
-    return path28.join(resolveHermesProfileDir(profileName), "honcho.json");
+    return path29.join(resolveHermesProfileDir(profileName), "honcho.json");
   }
   if (provider === "mem0") {
-    return path28.join(resolveHermesProfileDir(profileName), "mem0.json");
+    return path29.join(resolveHermesProfileDir(profileName), "mem0.json");
   }
   if (provider === "supermemory") {
-    return path28.join(resolveHermesProfileDir(profileName), "supermemory.json");
+    return path29.join(resolveHermesProfileDir(profileName), "supermemory.json");
   }
   if (provider === "hindsight") {
-    return path28.join(
+    return path29.join(
       resolveHermesProfileDir(profileName),
       "hindsight",
       "config.json"
@@ -30786,13 +31147,13 @@ function memoryProviderConfigPath(profileName, provider) {
   return null;
 }
 function customProviderConfigPath(profileName, provider) {
-  return path28.join(
+  return path29.join(
     resolveHermesProfileDir(profileName),
     `${normalizeCustomProviderId(provider)}.json`
   );
 }
 function customProviderRegistryPath(profileName) {
-  return path28.join(
+  return path29.join(
     resolveHermesProfileDir(profileName),
     CUSTOM_PROVIDER_REGISTRY_FILE
   );
@@ -30844,7 +31205,7 @@ async function saveCustomProviderRegistryEntry(profileName, provider) {
   );
 }
 async function discoverUserMemoryProviderDescriptors(profileName) {
-  const pluginsDir = path28.join(resolveHermesProfileDir(profileName), "plugins");
+  const pluginsDir = path29.join(resolveHermesProfileDir(profileName), "plugins");
   const entries = await readdir10(pluginsDir, { withFileTypes: true }).catch(
     (error) => {
       if (isNodeError21(error, "ENOENT")) {
@@ -30864,7 +31225,7 @@ async function discoverUserMemoryProviderDescriptors(profileName) {
     } catch {
       continue;
     }
-    const providerDir = path28.join(pluginsDir, entry.name);
+    const providerDir = path29.join(pluginsDir, entry.name);
     if (!await isMemoryProviderPluginDir(providerDir)) {
       continue;
     }
@@ -30878,7 +31239,7 @@ async function discoverUserMemoryProviderDescriptors(profileName) {
   return descriptors;
 }
 async function isUserMemoryProviderInstalled(profileName, provider) {
-  const providerDir = path28.join(
+  const providerDir = path29.join(
     resolveHermesProfileDir(profileName),
     "plugins",
     normalizeCustomProviderId(provider)
@@ -30886,7 +31247,7 @@ async function isUserMemoryProviderInstalled(profileName, provider) {
   return isMemoryProviderPluginDir(providerDir);
 }
 async function isMemoryProviderPluginDir(providerDir) {
-  const source = await readFile19(path28.join(providerDir, "__init__.py"), "utf8").catch(
+  const source = await readFile19(path29.join(providerDir, "__init__.py"), "utf8").catch(
     (error) => {
       if (isNodeError21(error, "ENOENT")) {
         return "";
@@ -30898,7 +31259,7 @@ async function isMemoryProviderPluginDir(providerDir) {
   return sample.includes("register_memory_provider") || sample.includes("MemoryProvider");
 }
 async function readPluginMetadata(providerDir) {
-  const raw = await readFile19(path28.join(providerDir, "plugin.yaml"), "utf8").catch(
+  const raw = await readFile19(path29.join(providerDir, "plugin.yaml"), "utf8").catch(
     (error) => {
       if (isNodeError21(error, "ENOENT")) {
         return "";
@@ -30910,10 +31271,10 @@ async function readPluginMetadata(providerDir) {
 }
 async function resolveByteRoverCli() {
   const candidates = [
-    ...(process.env.PATH ?? "").split(path28.delimiter).filter(Boolean).map((dir) => path28.join(dir, "brv")),
-    path28.join(process.env.HOME ?? "", ".brv-cli", "bin", "brv"),
+    ...(process.env.PATH ?? "").split(path29.delimiter).filter(Boolean).map((dir) => path29.join(dir, "brv")),
+    path29.join(process.env.HOME ?? "", ".brv-cli", "bin", "brv"),
     "/usr/local/bin/brv",
-    path28.join(process.env.HOME ?? "", ".npm-global", "bin", "brv")
+    path29.join(process.env.HOME ?? "", ".npm-global", "bin", "brv")
   ].filter(Boolean);
   for (const candidate of candidates) {
     const found = await access3(candidate).then(() => true).catch(() => false);
@@ -30974,7 +31335,7 @@ async function patchHermesMemoryEnv(profileName, patch) {
   if (entries.length === 0) {
     return;
   }
-  const envPath = path28.join(resolveHermesProfileDir(profileName), ".env");
+  const envPath = path29.join(resolveHermesProfileDir(profileName), ".env");
   const existingRaw = await readFile19(envPath, "utf8").catch((error) => {
     if (isNodeError21(error, "ENOENT")) {
       return "";
@@ -31145,7 +31506,7 @@ async function readActiveMemoryProvider(profileName) {
   return provider;
 }
 async function patchJsonProviderConfig(profileName, relativePath, patch) {
-  const configPath = path28.join(
+  const configPath = path29.join(
     resolveHermesProfileDir(profileName),
     relativePath
   );
@@ -31174,7 +31535,7 @@ async function readJsonObject(filePath) {
   } catch {
     throw new HermesMemoryError(
       "memory_provider_config_invalid",
-      `${path28.basename(filePath)} \u4E0D\u662F\u6709\u6548\u7684 JSON \u914D\u7F6E\u6587\u4EF6\u3002`
+      `${path29.basename(filePath)} \u4E0D\u662F\u6709\u6548\u7684 JSON \u914D\u7F6E\u6587\u4EF6\u3002`
     );
   }
 }
@@ -31798,7 +32159,7 @@ function toMemoryHttpError(error) {
 
 // src/hermes/skills.ts
 import { readFile as readFile20, readdir as readdir11 } from "fs/promises";
-import path29 from "path";
+import path30 from "path";
 import YAML7 from "yaml";
 var HermesSkillNotFoundError = class extends Error {
   constructor(skillName) {
@@ -31812,7 +32173,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 = path29.join(profileDir, "skills");
+  const skillsRoot = path30.join(profileDir, "skills");
   const [skillFiles, disabled, provenance] = await Promise.all([
     findSkillFiles(skillsRoot),
     readDisabledSkillNames(resolveHermesConfigPath(profile.name)),
@@ -31903,7 +32264,7 @@ async function collectSkillFiles(directory, results) {
     if (EXCLUDED_SKILL_DIRS.has(entry.name)) {
       continue;
     }
-    const entryPath = path29.join(directory, entry.name);
+    const entryPath = path30.join(directory, entry.name);
     if (entry.isDirectory()) {
       await collectSkillFiles(entryPath, results);
       continue;
@@ -31925,10 +32286,10 @@ async function readSkillMetadata(input) {
   if (raw === null) {
     return null;
   }
-  const skillDir = path29.dirname(input.skillFile);
+  const skillDir = path30.dirname(input.skillFile);
   const { frontmatter, body } = parseSkillDocument(raw.slice(0, 4e3));
   const name = normalizeSkillName(
-    readString21(frontmatter.name) ?? path29.basename(skillDir)
+    readString21(frontmatter.name) ?? path30.basename(skillDir)
   );
   if (!name) {
     return null;
@@ -31947,7 +32308,7 @@ async function readSkillMetadata(input) {
     enabled: !input.disabled.has(name),
     source: provenance.source,
     trust: provenance.trust,
-    relativePath: path29.relative(input.skillsRoot, skillDir)
+    relativePath: path30.relative(input.skillsRoot, skillDir)
   };
 }
 function parseSkillDocument(raw) {
@@ -31968,8 +32329,8 @@ function parseSkillDocument(raw) {
   }
 }
 function categoryFromPath(skillsRoot, skillFile) {
-  const relative = path29.relative(skillsRoot, skillFile);
-  const parts = relative.split(path29.sep).filter(Boolean);
+  const relative = path30.relative(skillsRoot, skillFile);
+  const parts = relative.split(path30.sep).filter(Boolean);
   return parts.length >= 3 ? parts[0] : null;
 }
 function firstBodyDescription(body) {
@@ -32016,7 +32377,7 @@ async function readSkillProvenance(root) {
   return provenance;
 }
 async function readBundledSkillNames(root) {
-  const raw = await readFile20(path29.join(root, ".bundled_manifest"), "utf8").catch(
+  const raw = await readFile20(path30.join(root, ".bundled_manifest"), "utf8").catch(
     (error) => {
       if (isNodeError22(error, "ENOENT")) {
         return "";
@@ -32039,7 +32400,7 @@ async function readBundledSkillNames(root) {
   return names;
 }
 async function readHubInstalledSkills(root) {
-  const raw = await readFile20(path29.join(root, ".hub", "lock.json"), "utf8").catch(
+  const raw = await readFile20(path30.join(root, ".hub", "lock.json"), "utf8").catch(
     (error) => {
       if (isNodeError22(error, "ENOENT")) {
         return "";
@@ -32516,6 +32877,7 @@ function registerRunRoutes(router, options) {
   const { paths, logger, conversations } = options;
   router.post("/api/v1/runs", async (ctx) => {
     await authenticateRequest(ctx, paths);
+    const language = readPreferredLanguage(ctx);
     const body = await readJsonBody(ctx.req);
     const input = readString19(body, "input");
     if (!input) {
@@ -32532,14 +32894,16 @@ function registerRunRoutes(router, options) {
         session_id: readString19(body, "session_id") ?? readString19(body, "sessionId") ?? void 0,
         session_key: readString19(body, "session_key") ?? readString19(body, "sessionKey") ?? void 0
       },
-      { logger, profileName: readOptionalProfileName(body) }
+      { logger, profileName: readOptionalProfileName(body), language }
     );
   });
   router.get("/api/v1/runs/:runId/events", async (ctx) => {
     await authenticateRequest(ctx, paths);
+    const language = readPreferredLanguage(ctx);
     const response = await streamHermesRunEvents(ctx.params.runId, {
       logger,
-      profileName: readQueryString(ctx.query.profile)
+      profileName: readQueryString(ctx.query.profile),
+      language
     });
     ctx.status = response.status;
     for (const [key, value] of response.headers.entries()) {
@@ -32561,6 +32925,7 @@ function registerRunRoutes(router, options) {
   });
   router.post("/api/v1/runs/:runId/cancel", async (ctx) => {
     await authenticateRequest(ctx, paths);
+    const language = readPreferredLanguage(ctx);
     try {
       ctx.body = {
         ok: true,
@@ -32572,7 +32937,8 @@ function registerRunRoutes(router, options) {
       }
       await cancelHermesRun(ctx.params.runId, {
         logger,
-        profileName: readQueryString(ctx.query.profile)
+        profileName: readQueryString(ctx.query.profile),
+        language
       });
       ctx.body = { ok: true };
     }
@@ -32702,7 +33068,7 @@ function readModelList(payload) {
 import { EventEmitter as EventEmitter3 } from "events";
 import { spawn as spawn4 } from "child_process";
 import { mkdir as mkdir13, readFile as readFile21, rm as rm8 } from "fs/promises";
-import path30 from "path";
+import path31 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;
@@ -32980,13 +33346,13 @@ async function readUpdateLogLines(paths) {
   );
 }
 function releaseCachePath(paths) {
-  return path30.join(paths.indexesDir, "hermes-release-check.json");
+  return path31.join(paths.indexesDir, "hermes-release-check.json");
 }
 function updateStatePath(paths) {
-  return path30.join(paths.runDir, "hermes-update-state.json");
+  return path31.join(paths.runDir, "hermes-update-state.json");
 }
 function updateLogPath(paths) {
-  return path30.join(paths.logsDir, UPDATE_LOG_FILE);
+  return path31.join(paths.logsDir, UPDATE_LOG_FILE);
 }
 async function clearUpdateLogFiles(paths) {
   const primary = updateLogPath(paths);
@@ -33087,12 +33453,12 @@ function readString22(payload, key) {
 import { spawn as spawn6 } from "child_process";
 import { EventEmitter as EventEmitter4 } from "events";
 import { mkdir as mkdir16, readFile as readFile23, rm as rm11 } from "fs/promises";
-import path32 from "path";
+import path33 from "path";
 
 // src/daemon/process.ts
 import { spawn as spawn5 } from "child_process";
 import { mkdir as mkdir15, readFile as readFile22, rm as rm10, writeFile as writeFile4 } from "fs/promises";
-import path31 from "path";
+import path32 from "path";
 
 // src/daemon/service.ts
 import { createServer } from "http";
@@ -33768,8 +34134,8 @@ function normalizeMessage(value) {
 
 // src/runtime/system-info.ts
 import { execFileSync } from "child_process";
-import { readFileSync } from "fs";
-import os6 from "os";
+import { readFileSync as readFileSync2 } from "fs";
+import os7 from "os";
 function readLinkSystemInfo() {
   const platform = process.platform;
   const hostname = readHostname(platform);
@@ -33808,7 +34174,7 @@ function readHostname(platform) {
       return computerName;
     }
   }
-  return normalizeText(os6.hostname());
+  return normalizeText(os7.hostname());
 }
 function readOsLabel(platform) {
   if (platform === "darwin") {
@@ -33816,17 +34182,17 @@ function readOsLabel(platform) {
     return version ? `macOS ${version}` : "macOS";
   }
   if (platform === "linux") {
-    return readLinuxOsRelease() ?? `Linux ${os6.release()}`;
+    return readLinuxOsRelease() ?? `Linux ${os7.release()}`;
   }
   if (platform === "win32") {
-    return `Windows ${os6.release()}`;
+    return `Windows ${os7.release()}`;
   }
-  return `${os6.type()} ${os6.release()}`.trim();
+  return `${os7.type()} ${os7.release()}`.trim();
 }
 function readLinuxOsRelease() {
   for (const file of ["/etc/os-release", "/usr/lib/os-release"]) {
     try {
-      return parseLinuxOsRelease(readFileSync(file, "utf8"));
+      return parseLinuxOsRelease(readFileSync2(file, "utf8"));
     } catch {
     }
   }
@@ -33868,11 +34234,11 @@ function truncateText(value, maxLength) {
 }
 
 // src/topology/network.ts
-import os8 from "os";
+import os9 from "os";
 
 // src/topology/environment.ts
-import { existsSync, readFileSync as readFileSync2 } from "fs";
-import os7 from "os";
+import { existsSync, readFileSync as readFileSync3 } from "fs";
+import os8 from "os";
 function detectRuntimeEnvironment(env = process.env) {
   if (isWsl(env)) {
     return {
@@ -33901,7 +34267,7 @@ function isWsl(env) {
   if (env.WSL_DISTRO_NAME || env.WSL_INTEROP) {
     return true;
   }
-  const release = os7.release().toLowerCase();
+  const release = os8.release().toLowerCase();
   return release.includes("microsoft") || release.includes("wsl");
 }
 function isContainer(env) {
@@ -33912,7 +34278,7 @@ function isContainer(env) {
     return true;
   }
   try {
-    const cgroup = readFileSync2("/proc/1/cgroup", "utf8").toLowerCase();
+    const cgroup = readFileSync3("/proc/1/cgroup", "utf8").toLowerCase();
     return /docker|containerd|kubepods|libpod|podman/u.test(cgroup);
   } catch {
     return false;
@@ -33946,7 +34312,7 @@ async function discoverRouteCandidates(options) {
   };
 }
 function discoverLanIps() {
-  return discoverLanIpsFromInterfaces(os8.networkInterfaces());
+  return discoverLanIpsFromInterfaces(os9.networkInterfaces());
 }
 function discoverLanIpsFromInterfaces(interfaces) {
   const result = /* @__PURE__ */ new Set();
@@ -35039,7 +35405,7 @@ async function runDaemonSupervisor(paths = resolveRuntimePaths()) {
   await mkdir15(paths.logsDir, { recursive: true, mode: 448 });
   const log = createRotatingTextLogWriter({
     paths,
-    fileName: path31.basename(daemonLogFile(paths))
+    fileName: path32.basename(daemonLogFile(paths))
   });
   const scriptPath = currentCliScriptPath();
   const write = (chunk) => {
@@ -35337,7 +35703,7 @@ function terminateChild(child, previousForceKillTimer) {
   }
 }
 function supervisorStopIntentPath(paths) {
-  return path31.join(paths.runDir, "supervisor-stop-intent.json");
+  return path32.join(paths.runDir, "supervisor-stop-intent.json");
 }
 async function writeSupervisorStopIntent(paths, pid) {
   await mkdir15(paths.runDir, { recursive: true, mode: 448 });
@@ -35900,7 +36266,7 @@ async function buildOfficialInstallCommand(options, targetVersion) {
   };
 }
 function buildUnixInstallCommand(installerUrl) {
-  const nodeBinDir = path32.dirname(process.execPath);
+  const nodeBinDir = path33.dirname(process.execPath);
   const fetchScript = [
     quoteShellToken(process.execPath),
     "--input-type=module",
@@ -36170,10 +36536,10 @@ async function readUpdateLogLines2(paths) {
   );
 }
 function updateStatePath2(paths) {
-  return path32.join(paths.runDir, "link-update-state.json");
+  return path33.join(paths.runDir, "link-update-state.json");
 }
 function updateLogPath2(paths) {
-  return path32.join(paths.logsDir, UPDATE_LOG_FILE2);
+  return path33.join(paths.logsDir, UPDATE_LOG_FILE2);
 }
 async function clearUpdateLogFiles2(paths) {
   const primary = updateLogPath2(paths);
@@ -36257,7 +36623,7 @@ function readString23(payload, key) {
 }
 
 // src/pairing/pairing.ts
-import path33 from "path";
+import path34 from "path";
 import { rm as rm12 } from "fs/promises";
 
 // src/relay/bootstrap.ts
@@ -36597,10 +36963,10 @@ async function loadRequiredIdentity2(paths) {
   }
   return identity;
 }
-async function postServerJson(serverBaseUrl, path34, body, options) {
+async function postServerJson(serverBaseUrl, path35, body, options) {
   let response;
   try {
-    response = await fetch(`${serverBaseUrl.replace(/\/+$/u, "")}${path34}`, {
+    response = await fetch(`${serverBaseUrl.replace(/\/+$/u, "")}${path35}`, {
       method: "POST",
       headers: {
         accept: "application/json",
@@ -36648,10 +37014,10 @@ function pairingErrorSnapshot(stage, error) {
     occurred_at: (/* @__PURE__ */ new Date()).toISOString()
   };
 }
-async function patchServerJson(serverBaseUrl, path34, token, body, options) {
+async function patchServerJson(serverBaseUrl, path35, token, body, options) {
   let response;
   try {
-    response = await fetch(`${serverBaseUrl.replace(/\/+$/u, "")}${path34}`, {
+    response = await fetch(`${serverBaseUrl.replace(/\/+$/u, "")}${path35}`, {
       method: "PATCH",
       headers: {
         accept: "application/json",
@@ -36699,10 +37065,10 @@ function createPairingNetworkError(input) {
   );
 }
 function pairingClaimPath(sessionId, paths) {
-  return path33.join(paths.pairingDir, `${Buffer.from(sessionId).toString("base64url")}.claimed.json`);
+  return path34.join(paths.pairingDir, `${Buffer.from(sessionId).toString("base64url")}.claimed.json`);
 }
 function pairingSessionPath(sessionId, paths) {
-  return path33.join(paths.pairingDir, `${Buffer.from(sessionId).toString("base64url")}.json`);
+  return path34.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);
@@ -38029,6 +38395,7 @@ export {
   getGatewayLogFiles,
   readRecentGatewayLogEntries,
   flushLogFiles,
+  resolveHermesBin,
   HermesApiServerUnavailableError,
   ensureHermesApiServerAvailable,
   readHermesVersion,