@hermespilot/link 0.7.5 → 0.7.7-beta.0

package/dist/cli/index.js

@@ -7,6 +7,7 @@ import {
   LINK_VERSION,
   LinkHttpError,
   clearPairingClaim,
+  closeTuiGatewayBackends,
   connectRelayControl,
   createFileLogger,
   currentCliScriptPath,
@@ -38,10 +39,10 @@ import {
   readHermesVersion,
   readPairingClaim,
   readRecentGatewayLogEntries,
-  readRecentLogEntries,
-  readRecentTextLogEntries,
   readRelayStatusSnapshot,
+  readTuiGatewayStatus,
   reportLinkStatusToServer,
+  resolveConversationRunBackend,
   resolveHermesConfigPath,
   resolveHermesProfileDir,
   resolveLanguage,
@@ -53,15 +54,17 @@ import {
   stopDaemonProcess,
   summarizeUsageProbeEnsure,
   translate
-} from "../chunk-MVKOUAVA.js";
+} from "../chunk-RFZ4SQV4.js";
 
 // src/cli/index.ts
 import { Command } from "commander";
+import { execFile as execFile2 } from "child_process";
 import { realpathSync as realpathSync2, unwatchFile, watchFile } from "fs";
 import { open, readFile as readFile2, stat as stat2 } from "fs/promises";
 import path4 from "path";
 import { createInterface } from "readline/promises";
 import { pathToFileURL } from "url";
+import { promisify as promisify2 } from "util";
 import qrcode from "qrcode-terminal";
 
 // src/autostart/autostart.ts
@@ -503,6 +506,26 @@ async function assertPairingPreflightReady(options = {}) {
       options.language
     );
   }
+  if (options.requireApiServer === false) {
+    return {
+      profileName,
+      hermesHome,
+      configPath,
+      envPath,
+      apiServer: {
+        available: true,
+        started: false,
+        host: null,
+        port: null
+      },
+      notice: null,
+      backupPath: null,
+      hermesVersion: {
+        raw: hermesVersion.raw,
+        version: hermesVersion.version
+      }
+    };
+  }
   options.onProgress?.("hermes_api_server");
   try {
     const ensureAvailable = options.ensureApiServerAvailable ?? ensureHermesApiServerAvailable;
@@ -781,6 +804,8 @@ function quoteShellToken(value, platform) {
 }
 
 // src/cli/index.ts
+var execFileAsync2 = promisify2(execFile2);
+var MIN_TUI_GATEWAY_RPC_VERSION = "0.11.0";
 var program = new Command();
 var helpLanguage = detectSystemLanguage();
 var helpText = translate.bind(null, helpLanguage);
@@ -790,11 +815,25 @@ program.command("status").option("--json", helpText("status.json")).description(
   const [identity, config] = await Promise.all([loadIdentity(paths), loadConfig(paths)]);
   const language = resolveLanguage(config.language);
   const t = translate.bind(null, language);
-  const [daemonStatus, relayStatus, recentError] = await Promise.all([
+  const [daemonStatus, relayStatus] = await Promise.all([
     getDaemonStatus(paths),
-    readRelayStatusSnapshot(paths).catch(() => null),
-    readMostRecentError(paths).catch(() => null)
+    readRelayStatusSnapshot(paths).catch(() => null)
   ]);
+  const conversationBackend = resolveConversationRunBackend();
+  const tuiGatewayCompatibility = conversationBackend === "tui_gateway" ? await readTuiGatewayCompatibility() : null;
+  const tuiGatewayRead = await readDaemonTuiGatewayStatus(config.port).then((status) => ({ status, source: "daemon" })).catch(async () => ({
+    status: await readTuiGatewayStatus({
+      paths,
+      connect: false
+    }).catch((error) => ({
+      available: false,
+      profile: "default",
+      state: "error",
+      error: error instanceof Error ? error.message : String(error)
+    })),
+    source: "cli"
+  }));
+  const tuiGatewayDiagnostics = options.json ? await readTuiGatewayDiagnostics(paths).catch(() => null) : null;
   const serviceProbe = daemonStatus.running ? await probeLocalLinkService({
     port: config.port,
     linkId: identity?.link_id ?? void 0,
@@ -825,7 +864,11 @@ program.command("status").option("--json", helpText("status.json")).description(
     environment: detectRuntimeEnvironment(),
     identity: identity ? getIdentityStatus(identity) : null,
     relay,
-    recentError
+    conversationBackend,
+    tuiGateway: tuiGatewayRead.status,
+    tuiGatewayStatusSource: tuiGatewayRead.source,
+    tuiGatewayCompatibility,
+    tuiGatewayDiagnostics
   };
   if (options.json) {
     console.log(JSON.stringify(payload, null, 2));
@@ -844,8 +887,28 @@ program.command("status").option("--json", helpText("status.json")).description(
     console.log(t("status.environmentWarning", { message: environmentWarning }));
   }
   console.log(t("status.linkId", { value: payload.identity?.linkId ?? t("status.notPaired") }));
+  console.log(
+    t("status.conversationBackend", {
+      value: payload.conversationBackend
+    })
+  );
+  console.log(
+    t("status.tuiGateway", {
+      value: formatTuiGatewayStatus(
+        payload.tuiGateway,
+        payload.tuiGatewayStatusSource,
+        t
+      )
+    })
+  );
+  const tuiGatewayUpgradeRequired = formatTuiGatewayUpgradeRequired(
+    payload.tuiGatewayCompatibility,
+    t
+  );
+  if (tuiGatewayUpgradeRequired) {
+    console.log(tuiGatewayUpgradeRequired);
+  }
   console.log(t("status.relay", { value: formatRelayStatus(payload.relay, t, language) }));
-  console.log(t("status.recentError", { value: formatRecentError(payload.recentError, t, language) }));
 });
 var configCommand = program.command("config").description(helpText("config.description"));
 configCommand.command("set").argument("<key>").argument("<value>").description(helpText("config.set.description")).action(async (key, value) => {
@@ -993,9 +1056,11 @@ program.command("pair").description(helpText("pair.description")).action(async (
   if (environmentWarning) {
     console.log(t("doctor.networkWarning", { message: environmentWarning }));
   }
+  const conversationBackend = resolveConversationRunBackend();
   const preflight = await assertPairingPreflightReady({
     paths,
     language,
+    requireApiServer: conversationBackend !== "tui_gateway",
     onProgress: (stage) => {
       console.log(t(pairingPreflightProgressKey(stage)));
     }
@@ -1006,6 +1071,45 @@ program.command("pair").description(helpText("pair.description")).action(async (
       console.log(t("config.backup", { path: preflight.backupPath }));
     }
   }
+  if (conversationBackend === "tui_gateway") {
+    console.log(t("pair.preflight.tuiGateway"));
+    const tuiGatewayCompatibility = tuiGatewayCompatibilityFromVersion(
+      preflight.hermesVersion
+    );
+    const upgradeRequired = formatTuiGatewayUpgradeRequired(
+      tuiGatewayCompatibility,
+      t
+    );
+    if (upgradeRequired) {
+      throw new Error(upgradeRequired);
+    }
+    try {
+      const rpcStatus = await readTuiGatewayStatus({
+        paths,
+        connect: true
+      });
+      if (!rpcStatus.available) {
+        throw new Error(formatTuiGatewayStatus(rpcStatus, "cli", t));
+      }
+      console.log(
+        t("pair.tuiGatewayReady", {
+          value: formatTuiGatewayStatus(rpcStatus, "cli", t)
+        })
+      );
+    } finally {
+      closeTuiGatewayBackends();
+    }
+    try {
+      const availability = await ensureHermesApiServerAvailable({
+        timeoutMs: 3e3,
+        language,
+        autoStart: false
+      });
+      console.log(t(availability.started ? "doctor.apiStarted" : "doctor.apiReady"));
+    } catch (error) {
+      console.log(formatHermesApiServerUnavailable(error, language));
+    }
+  }
   console.log(t("pair.preparing"));
   await ensureIdentity(paths);
   const hadActiveDevices = await hasActiveDevices(paths);
@@ -1217,6 +1321,31 @@ program.command("doctor").option("--install", helpText("doctor.installOnly")).op
   } catch (error) {
     console.log(formatHermesApiServerUnavailable(error, language));
   }
+  if (resolveConversationRunBackend() === "tui_gateway") {
+    console.log(t("doctor.tuiGatewayChecking"));
+    const tuiGatewayCompatibility = await readTuiGatewayCompatibility();
+    const upgradeRequired = formatTuiGatewayUpgradeRequired(
+      tuiGatewayCompatibility,
+      t
+    );
+    if (upgradeRequired) {
+      console.log(upgradeRequired);
+    } else {
+      try {
+        const rpcStatus = await readTuiGatewayStatus({
+          paths,
+          connect: true
+        });
+        console.log(
+          t("doctor.tuiGateway", {
+            value: formatTuiGatewayStatus(rpcStatus, "cli", t)
+          })
+        );
+      } finally {
+        closeTuiGatewayBackends();
+      }
+    }
+  }
   const usageProbe = await ensureUsageProbeFromCli(paths, t, language, true, "cli_doctor");
   if (options.profiles !== false) {
     await printProfileDiagnostics(t, usageProbe.profiles);
@@ -1409,6 +1538,29 @@ function formatDaemonStatus(daemon, t) {
     { pid }
   );
 }
+async function readTuiGatewayCompatibility() {
+  const version = await readHermesVersion().catch(() => null);
+  return tuiGatewayCompatibilityFromVersion(version);
+}
+function tuiGatewayCompatibilityFromVersion(version) {
+  if (!version) {
+    return null;
+  }
+  return {
+    version: version.version,
+    raw: version.raw,
+    upgradeRequired: version.version ? compareSemver(version.version, MIN_TUI_GATEWAY_RPC_VERSION) < 0 : false
+  };
+}
+function formatTuiGatewayUpgradeRequired(compatibility, t) {
+  if (!compatibility?.upgradeRequired) {
+    return null;
+  }
+  return t("tuiGateway.upgradeRequired", {
+    version: compatibility.version ?? compatibility.raw ?? t("status.unknown"),
+    minimum: MIN_TUI_GATEWAY_RPC_VERSION
+  });
+}
 function formatRelayStatus(relay, t, language) {
   if (relay.state === "not_paired") {
     return t("status.relay.notPaired");
@@ -1472,65 +1624,120 @@ function formatRelayState(state, t) {
       return t("status.relay.state.failed");
   }
 }
-async function readMostRecentError(paths) {
-  const [service, daemon, gateway] = await Promise.all([
-    readRecentLogEntries({ paths, limit: 120 }).catch(() => []),
-    readRecentTextLogEntries({
-      paths,
-      filePaths: [daemonLogFile(paths)],
-      limit: 120
-    }).catch(() => []),
-    readRecentGatewayLogEntries({ paths, limit: 120 }).catch(() => [])
-  ]);
-  const errors = [
-    ...service.map((entry) => toStatusRecentError("service", entry)),
-    ...daemon.map((entry) => toStatusRecentError("daemon", entry)),
-    ...gateway.map((entry) => toStatusRecentError("gateway", entry))
-  ].filter((item) => item !== null);
-  errors.sort((left, right) => readTimestampMs(right.ts) - readTimestampMs(left.ts));
-  return errors[0] ?? null;
-}
-function toStatusRecentError(source, entry) {
-  if (!isActionableStatusError(source, entry)) {
-    return null;
+function formatTuiGatewayStatus(status, source, t) {
+  const sourceLabel = t(
+    source === "daemon" ? "status.tuiGateway.source.daemon" : "status.tuiGateway.source.cli"
+  );
+  if (status.available) {
+    const endpoint = status.baseUrl ?? t("status.unknown");
+    const pid = status.pid ?? t("status.unknown");
+    return t("status.tuiGateway.available", {
+      profile: status.profile,
+      endpoint,
+      pid,
+      source: sourceLabel
+    });
+  }
+  if (status.error) {
+    return t("status.tuiGateway.error", {
+      profile: status.profile,
+      state: status.state,
+      message: status.error,
+      source: sourceLabel
+    });
+  }
+  if (status.state === "closed" && status.backend_state === "stopped") {
+    return t("status.tuiGateway.idle", {
+      profile: status.profile,
+      source: sourceLabel
+    });
+  }
+  return t("status.tuiGateway.unavailable", {
+    profile: status.profile,
+    state: status.state,
+    source: sourceLabel
+  });
+}
+async function readDaemonTuiGatewayStatus(port) {
+  const response = await fetch(`http://127.0.0.1:${port}/internal/status`, {
+    headers: { accept: "application/json" },
+    signal: AbortSignal.timeout(500)
+  });
+  if (!response.ok) {
+    throw new Error(`Hermes Link internal status returned HTTP ${response.status}`);
+  }
+  const body = await response.json();
+  const status = toRecord(body?.tui_gateway);
+  if (!status) {
+    throw new Error("Hermes Link internal status did not include tui_gateway");
   }
-  const errorDetail = typeof entry.fields?.error === "string" ? entry.fields.error : null;
-  const message = errorDetail && errorDetail !== entry.message ? `${entry.message}: ${errorDetail}` : entry.message;
   return {
-    source,
-    ts: entry.ts,
-    message
+    available: readBooleanValue(status.available) ?? false,
+    profile: readStringValue(status.profile) ?? "default",
+    state: readTuiGatewayState(status.state),
+    ...readStringValue(status.baseUrl) ? { baseUrl: readStringValue(status.baseUrl) } : {},
+    ...readNumberValue(status.pid) !== void 0 ? { pid: readNumberValue(status.pid) } : status.pid === null ? { pid: null } : {},
+    ...readTuiGatewayBackendState(status.backend_state) ? { backend_state: readTuiGatewayBackendState(status.backend_state) } : {},
+    ...readStringValue(status.last_active_at) ? { last_active_at: readStringValue(status.last_active_at) } : {},
+    ...readStringValue(status.log_path) ? { log_path: readStringValue(status.log_path) } : {},
+    ...readStringValue(status.error) ? { error: readStringValue(status.error) } : {}
   };
 }
-function isActionableStatusError(source, entry) {
-  if (source === "service") {
-    return entry.level === "error";
-  }
-  if (entry.level !== "error") {
-    return false;
+function readTuiGatewayState(value) {
+  if (value === "open" || value === "closed" || value === "connecting" || value === "error") {
+    return value;
   }
-  return /(^|[\s[])(error|fatal)([\]\s:]|$)|\b(traceback|exception|failed|failure|unhandledRejection|uncaughtException)\b/iu.test(
-    entry.message
-  );
+  return "error";
 }
-function formatRecentError(error, t, language) {
-  if (!error) {
-    return t("status.recentError.none");
+function readTuiGatewayBackendState(value) {
+  if (value === "running" || value === "stopped") {
+    return value;
   }
-  return t("status.recentError.format", {
-    time: error.ts ? formatTimestamp(error.ts, language) : t("status.timeUnknown"),
-    source: formatLogSourceLabel(error.source, t),
-    message: error.message
-  });
+  return void 0;
+}
+function toRecord(value) {
+  return value && typeof value === "object" ? value : null;
+}
+function readStringValue(value) {
+  return typeof value === "string" && value.trim() ? value.trim() : void 0;
+}
+function readNumberValue(value) {
+  return typeof value === "number" && Number.isFinite(value) ? value : void 0;
 }
-function formatLogSourceLabel(source, t) {
-  switch (source) {
-    case "service":
-      return t("status.logSource.service");
-    case "daemon":
-      return t("status.logSource.daemon");
-    case "gateway":
-      return t("status.logSource.gateway");
+function readBooleanValue(value) {
+  return typeof value === "boolean" ? value : void 0;
+}
+async function readTuiGatewayDiagnostics(paths) {
+  const [dashboardProcesses, logEntries] = await Promise.all([
+    listHermesDashboardProcesses(),
+    readRecentGatewayLogEntries({ paths, limit: 40 }).catch(() => [])
+  ]);
+  const recentLogLines = logEntries.map((entry) => entry.message).filter(
+    (message) => /HERMES_DASHBOARD_READY|Building web UI|Web UI built|dashboard|tui_gateway|Traceback|Error|failed/iu.test(
+      message
+    )
+  ).slice(-6);
+  return {
+    dashboardProcesses,
+    recentLogLines,
+    logFiles: getGatewayLogFiles(paths)
+  };
+}
+async function listHermesDashboardProcesses() {
+  try {
+    const { stdout } = await execFileAsync2("ps", ["axo", "pid=,command="], {
+      timeout: 2e3,
+      windowsHide: true
+    });
+    return stdout.split(/\r?\n/u).map((line) => line.trim()).filter((line) => /\bhermes\b.*\bdashboard\b/u.test(line)).map((line) => {
+      const match = line.match(/^(\d+)\s+(.*)$/u);
+      return {
+        pid: match ? Number(match[1]) : null,
+        command: match?.[2] ?? line
+      };
+    });
+  } catch {
+    return [];
   }
 }
 function formatRuntimeEnvironmentWarning(environment, t) {
@@ -1556,16 +1763,20 @@ function formatTimestamp(value, language) {
     hour12: false
   }).format(new Date(timestamp));
 }
-function readTimestampMs(value) {
-  if (!value) {
-    return 0;
-  }
-  const timestamp = Date.parse(value);
-  return Number.isFinite(timestamp) ? timestamp : 0;
-}
 function formatHermesVersion(version) {
   return version.version ?? version.raw;
 }
+function compareSemver(left, right) {
+  const leftParts = left.split(".").map((part) => Number.parseInt(part, 10));
+  const rightParts = right.split(".").map((part) => Number.parseInt(part, 10));
+  for (let index = 0; index < 3; index += 1) {
+    const diff = (leftParts[index] || 0) - (rightParts[index] || 0);
+    if (diff !== 0) {
+      return diff;
+    }
+  }
+  return 0;
+}
 function printInstallDiagnostics(info, t, verbose) {
   if (!verbose && !hasInstallPathIssue(info)) {
     return;

package/dist/http/app.d.ts

@@ -15,6 +15,7 @@ interface ConversationSummary {
     created_at: string;
     updated_at: string;
     last_event_seq: number;
+    event_stream?: ConversationEventStreamState;
     usage: {
         input_tokens: number;
         output_tokens: number;
@@ -254,8 +255,10 @@ interface LinkRun {
     queue_mode?: 'guided_interrupt';
     queue_promoted_at?: string;
     guided_after_run_id?: string;
+    hermes_backend?: 'tui_gateway' | 'responses' | 'runs';
     hermes_run_id?: string;
     hermes_response_id?: string;
+    hermes_rpc_session_id?: string;
     previous_response_id?: string;
     conversation_id: string;
     trigger_message_id: string;

package/dist/http/app.js

@@ -1,6 +1,6 @@
 import {
   createApp
-} from "../chunk-MVKOUAVA.js";
+} from "../chunk-RFZ4SQV4.js";
 export {
   createApp
 };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@hermespilot/link",
-  "version": "0.7.5",
+  "version": "0.7.7-beta.0",
   "private": false,
   "description": "Hermes Link companion service and CLI for connecting hermes-agent through HermesPilot",
   "license": "MIT",