@hermespilot/link 0.2.7 → 0.2.9

package/dist/cli/index.js

@@ -6,6 +6,7 @@ import {
   clearPairingClaim,
   currentCliScriptPath,
   daemonLogFile,
+  detectRuntimeEnvironment,
   ensureHermesApiServerAvailable,
   ensureHermesApiServerConfig,
   ensureIdentity,
@@ -15,21 +16,25 @@ import {
   hasActiveDevices,
   loadConfig,
   loadIdentity,
+  normalizeLanHost,
   preparePairing,
   probeLocalLinkService,
   readHermesApiServerConfig,
   readPairingClaim,
+  reportLinkStatusToServer,
   resolveHermesConfigPath,
   resolveHermesProfileDir,
   resolveRuntimePaths,
   runDaemonSupervisor,
+  saveConfig,
   startDaemonProcess,
   startLinkService,
   stopDaemonProcess
-} from "../chunk-SSJ7WDD7.js";
+} from "../chunk-VLTX75SY.js";
 
 // src/cli/index.ts
 import { Command } from "commander";
+import { createInterface } from "readline/promises";
 import qrcode from "qrcode-terminal";
 
 // src/autostart/autostart.ts
@@ -221,6 +226,9 @@ var messages = {
     "status.runtime": "Runtime: {value}",
     "status.mode": "Mode: {value}",
     "status.port": "Local port: {value}",
+    "status.lanHost": "Configured LAN host: {value}",
+    "status.notSet": "not set",
+    "status.environmentWarning": "Network note: {message}",
     "status.linkId": "Link ID: {value}",
     "status.notPaired": "not paired",
     "start.description": "Start Hermes Link daemon",
@@ -234,6 +242,15 @@ var messages = {
     "stop.stopped": "Hermes Link stopped.",
     "stop.notRunning": "Hermes Link is not running.",
     "restart.description": "Restart the background Hermes Link daemon",
+    "config.description": "Manage local Hermes Link configuration",
+    "config.set.description": "Set a configuration value",
+    "config.unset.description": "Unset a configuration value",
+    "config.unknownKey": "Unknown config key: {key}",
+    "config.lanHostInvalid": "lan-host must be a private LAN IPv4 address, such as 192.168.1.23.",
+    "config.lanHostSet": "Configured LAN host: {value}",
+    "config.lanHostUnset": "Configured LAN host cleared.",
+    "config.reported": "Updated HermesPilot Server with the latest LAN address.",
+    "config.reportSkippedUnpaired": "Hermes Link is not paired yet. The LAN address will be reported after pairing.",
     "daemon.description": "Run Hermes Link in the foreground",
     "daemon.foreground": "Hermes Link foreground daemon is running. Press Ctrl+C to stop.",
     "logs.description": "Show Hermes Link log paths",
@@ -260,9 +277,13 @@ var messages = {
     "pair.code": "Pairing code: {value}",
     "pair.localApi": "Local API: http://127.0.0.1:{port}",
     "pair.scan": "Open this pairing page in the HermesPilot App or scan the QR code below:",
+    "pair.openBrowserFailed": "Could not open the system browser automatically. You can still scan the QR code below or open this URL manually: {url}",
     "pair.expires": "Pairing expires in 10 minutes. Press Ctrl+C to cancel waiting.",
     "pair.claimed": "Pairing succeeded. Starting Hermes Link in the background...",
     "pair.claimedRunning": "Pairing succeeded. Hermes Link is already running in the background.",
+    "pair.relayOnlyNotice": "Network note: this {kind} environment does not expose a phone-reachable LAN/public direct address by default. The App will connect through Relay.",
+    "pair.relayOnlyLanHostHint": "If you manually expose this Link from Windows or your router, run `hermeslink config set lan-host <Windows LAN IP>` to publish the reachable LAN address.",
+    "pair.relayOnlySafetyHint": "Hermes Link will not automatically change Windows/WSL bridge, firewall, or portproxy settings because those are system-level network exposure choices.",
     "pair.autostartUnchanged": "Existing paired devices found. Boot autostart settings were left unchanged.",
     "pair.autostartFailed": "Pairing succeeded, but boot autostart could not be enabled: {message}",
     "doctor.description": "Run local diagnostics",
@@ -270,6 +291,8 @@ var messages = {
     "doctor.installId": "Install ID: {value}",
     "doctor.linkId": "Link ID: {value}",
     "doctor.notAssigned": "not assigned",
+    "doctor.lanHost": "Configured LAN host: {value}",
+    "doctor.networkWarning": "Network note: {message}",
     "doctor.apiReady": "Hermes API Server: ready",
     "doctor.apiStarted": "Hermes API Server: started and ready",
     "doctor.apiUnavailable": "Hermes API Server: unavailable. {message}",
@@ -290,6 +313,9 @@ var messages = {
     "status.runtime": "\u8FD0\u884C\u76EE\u5F55\uFF1A{value}",
     "status.mode": "\u6A21\u5F0F\uFF1A{value}",
     "status.port": "\u672C\u5730\u7AEF\u53E3\uFF1A{value}",
+    "status.lanHost": "\u5DF2\u914D\u7F6E\u5C40\u57DF\u7F51\u4E3B\u673A\uFF1A{value}",
+    "status.notSet": "\u672A\u8BBE\u7F6E",
+    "status.environmentWarning": "\u7F51\u7EDC\u63D0\u793A\uFF1A{message}",
     "status.linkId": "Link ID\uFF1A{value}",
     "status.notPaired": "\u5C1A\u672A\u914D\u5BF9",
     "start.description": "\u542F\u52A8 Hermes Link \u670D\u52A1",
@@ -303,6 +329,15 @@ var messages = {
     "stop.stopped": "Hermes Link \u5DF2\u505C\u6B62\u3002",
     "stop.notRunning": "Hermes Link \u6CA1\u6709\u5728\u8FD0\u884C\u3002",
     "restart.description": "\u91CD\u542F\u540E\u53F0 Hermes Link \u670D\u52A1",
+    "config.description": "\u7BA1\u7406\u672C\u673A Hermes Link \u914D\u7F6E",
+    "config.set.description": "\u8BBE\u7F6E\u914D\u7F6E\u9879",
+    "config.unset.description": "\u6E05\u9664\u914D\u7F6E\u9879",
+    "config.unknownKey": "\u672A\u77E5\u914D\u7F6E\u9879\uFF1A{key}",
+    "config.lanHostInvalid": "lan-host \u5FC5\u987B\u662F\u5C40\u57DF\u7F51 IPv4 \u5730\u5740\uFF0C\u4F8B\u5982 192.168.1.23\u3002",
+    "config.lanHostSet": "\u5DF2\u914D\u7F6E\u5C40\u57DF\u7F51\u4E3B\u673A\uFF1A{value}",
+    "config.lanHostUnset": "\u5DF2\u6E05\u9664\u5C40\u57DF\u7F51\u4E3B\u673A\u914D\u7F6E\u3002",
+    "config.reported": "\u5DF2\u628A\u6700\u65B0\u5C40\u57DF\u7F51\u5730\u5740\u66F4\u65B0\u5230 HermesPilot Server\u3002",
+    "config.reportSkippedUnpaired": "Hermes Link \u8FD8\u6CA1\u6709\u914D\u5BF9\uFF0C\u5C40\u57DF\u7F51\u5730\u5740\u4F1A\u5728\u914D\u5BF9\u540E\u4E0A\u62A5\u3002",
     "daemon.description": "\u4EE5\u524D\u53F0\u65B9\u5F0F\u8FD0\u884C Hermes Link",
     "daemon.foreground": "Hermes Link \u524D\u53F0\u670D\u52A1\u6B63\u5728\u8FD0\u884C\u3002\u6309 Ctrl+C \u505C\u6B62\u3002",
     "logs.description": "\u663E\u793A Hermes Link \u65E5\u5FD7\u8DEF\u5F84",
@@ -329,9 +364,13 @@ var messages = {
     "pair.code": "\u914D\u5BF9\u7801\uFF1A{value}",
     "pair.localApi": "\u672C\u5730 API\uFF1Ahttp://127.0.0.1:{port}",
     "pair.scan": "\u8BF7\u5728 HermesPilot App \u4E2D\u6253\u5F00\u8FD9\u4E2A\u914D\u5BF9\u9875\uFF0C\u6216\u626B\u63CF\u4E0B\u9762\u7684\u4E8C\u7EF4\u7801\uFF1A",
+    "pair.openBrowserFailed": "\u65E0\u6CD5\u81EA\u52A8\u6253\u5F00\u7CFB\u7EDF\u6D4F\u89C8\u5668\u3002\u4F60\u4ECD\u7136\u53EF\u4EE5\u626B\u63CF\u4E0B\u9762\u7684\u4E8C\u7EF4\u7801\uFF0C\u6216\u624B\u52A8\u6253\u5F00\u8FD9\u4E2A\u94FE\u63A5\uFF1A{url}",
     "pair.expires": "\u914D\u5BF9\u4F1A\u8BDD 10 \u5206\u949F\u540E\u8FC7\u671F\u3002\u6309 Ctrl+C \u9000\u51FA\u7B49\u5F85\u3002",
     "pair.claimed": "\u914D\u5BF9\u5DF2\u6210\u529F\u3002\u6B63\u5728\u628A Hermes Link \u5207\u6362\u5230\u540E\u53F0\u8FD0\u884C...",
     "pair.claimedRunning": "\u914D\u5BF9\u5DF2\u6210\u529F\u3002Hermes Link \u5DF2\u5728\u540E\u53F0\u6301\u7EED\u8FD0\u884C\u3002",
+    "pair.relayOnlyNotice": "\u7F51\u7EDC\u63D0\u793A\uFF1A\u5F53\u524D\u662F {kind} \u73AF\u5883\uFF0C\u9ED8\u8BA4\u4E0D\u4F1A\u66B4\u9732\u624B\u673A\u53EF\u8BBF\u95EE\u7684\u5C40\u57DF\u7F51\u6216\u516C\u7F51\u76F4\u8FDE\u5730\u5740\u3002App \u4F1A\u901A\u8FC7 Relay \u8FDE\u63A5\u3002",
+    "pair.relayOnlyLanHostHint": "\u5982\u679C\u4F60\u5DF2\u7ECF\u5728 Windows \u6216\u8DEF\u7531\u5668\u4FA7\u624B\u52A8\u628A\u8FD9\u4E2A Link \u66B4\u9732\u5230\u5C40\u57DF\u7F51\uFF0C\u53EF\u4EE5\u8FD0\u884C `hermeslink config set lan-host <Windows \u5C40\u57DF\u7F51 IP>` \u66F4\u65B0\u53EF\u8BBF\u95EE\u5730\u5740\u3002",
+    "pair.relayOnlySafetyHint": "Hermes Link \u4E0D\u4F1A\u81EA\u52A8\u4FEE\u6539 Windows/WSL \u6865\u63A5\u3001\u9632\u706B\u5899\u6216\u7AEF\u53E3\u4EE3\u7406\u914D\u7F6E\uFF0C\u56E0\u4E3A\u8FD9\u4E9B\u5C5E\u4E8E\u7CFB\u7EDF\u7EA7\u7F51\u7EDC\u66B4\u9732\u8BBE\u7F6E\u3002",
     "pair.autostartUnchanged": "\u68C0\u6D4B\u5230\u5DF2\u6709\u914D\u5BF9\u8BBE\u5907\uFF0C\u5F00\u673A\u81EA\u542F\u8BBE\u7F6E\u4FDD\u6301\u4E0D\u53D8\u3002",
     "pair.autostartFailed": "\u914D\u5BF9\u5DF2\u6210\u529F\uFF0C\u4F46\u542F\u7528\u5F00\u673A\u81EA\u542F\u5931\u8D25\uFF1A{message}",
     "doctor.description": "\u8FD0\u884C\u672C\u673A\u8BCA\u65AD",
@@ -339,6 +378,8 @@ var messages = {
     "doctor.installId": "Install ID\uFF1A{value}",
     "doctor.linkId": "Link ID\uFF1A{value}",
     "doctor.notAssigned": "\u5C1A\u672A\u5206\u914D",
+    "doctor.lanHost": "\u5DF2\u914D\u7F6E\u5C40\u57DF\u7F51\u4E3B\u673A\uFF1A{value}",
+    "doctor.networkWarning": "\u7F51\u7EDC\u63D0\u793A\uFF1A{message}",
     "doctor.apiReady": "Hermes API Server\uFF1A\u5DF2\u5C31\u7EEA",
     "doctor.apiStarted": "Hermes API Server\uFF1A\u5DF2\u81EA\u52A8\u542F\u52A8\u5E76\u5C31\u7EEA",
     "doctor.apiUnavailable": "Hermes API Server\uFF1A\u4E0D\u53EF\u7528\u3002{message}",
@@ -570,16 +611,29 @@ async function openSystemBrowser(url) {
   return await spawnDetached("xdg-open", [url]);
 }
 async function spawnDetached(command, args) {
-  try {
-    const child = spawn(command, args, {
-      detached: true,
-      stdio: "ignore"
-    });
-    child.unref();
-    return true;
-  } catch {
-    return false;
-  }
+  return await new Promise((resolve) => {
+    let settled = false;
+    const settle = (ok) => {
+      if (settled) {
+        return;
+      }
+      settled = true;
+      resolve(ok);
+    };
+    try {
+      const child = spawn(command, args, {
+        detached: true,
+        stdio: "ignore"
+      });
+      child.once("error", () => settle(false));
+      child.once("spawn", () => {
+        child.unref();
+        settle(true);
+      });
+    } catch {
+      settle(false);
+    }
+  });
 }
 
 // src/cli/index.ts
@@ -598,6 +652,8 @@ program.command("status").option("--json", helpText("status.json")).description(
     paired: Boolean(identity?.link_id),
     mode: identity?.link_id ? "paired" : "local-only",
     port: config.port,
+    lanHost: config.lanHost,
+    environment: detectRuntimeEnvironment(),
     identity: identity ? getIdentityStatus(identity) : null,
     relay: {
       configured: Boolean(config.relayBaseUrl),
@@ -612,8 +668,43 @@ program.command("status").option("--json", helpText("status.json")).description(
   console.log(t("status.runtime", { value: payload.runtimeHome }));
   console.log(t("status.mode", { value: payload.mode }));
   console.log(t("status.port", { value: payload.port }));
+  console.log(t("status.lanHost", { value: payload.lanHost ?? t("status.notSet") }));
+  if (payload.environment.warning) {
+    console.log(t("status.environmentWarning", { message: payload.environment.warning }));
+  }
   console.log(t("status.linkId", { value: payload.identity?.linkId ?? t("status.notPaired") }));
 });
+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) => {
+  const paths = resolveRuntimePaths();
+  const current = await loadConfig(paths);
+  const language = resolveLanguage(current.language);
+  const t = translate.bind(null, language);
+  const normalizedKey = key.trim().toLowerCase();
+  if (normalizedKey !== "lan-host") {
+    throw new Error(t("config.unknownKey", { key }));
+  }
+  const lanHost = normalizeLanHost(value);
+  if (!lanHost) {
+    throw new Error(t("config.lanHostInvalid"));
+  }
+  const next = await saveConfig({ lanHost }, paths);
+  console.log(t("config.lanHostSet", { value: next.lanHost ?? lanHost }));
+  await reportConfigNetworkUpdate(paths, t);
+});
+configCommand.command("unset").argument("<key>").description(helpText("config.unset.description")).action(async (key) => {
+  const paths = resolveRuntimePaths();
+  const current = await loadConfig(paths);
+  const language = resolveLanguage(current.language);
+  const t = translate.bind(null, language);
+  const normalizedKey = key.trim().toLowerCase();
+  if (normalizedKey !== "lan-host") {
+    throw new Error(t("config.unknownKey", { key }));
+  }
+  await saveConfig({ lanHost: null }, paths);
+  console.log(t("config.lanHostUnset"));
+  await reportConfigNetworkUpdate(paths, t);
+});
 program.command("start").description(helpText("start.description")).action(async () => {
   const [config, status] = await Promise.all([loadConfig(), getDaemonStatus()]);
   const language = resolveLanguage(config.language);
@@ -661,11 +752,17 @@ program.command("daemon-supervisor", { hidden: true }).action(async () => {
 });
 program.command("pair").description(helpText("pair.description")).action(async () => {
   const paths = resolveRuntimePaths();
-  const config = await loadConfig(paths);
-  const language = resolveLanguage(config.language);
+  let config = await loadConfig(paths);
+  const languageChoice = await resolvePairingLanguage(paths, config);
+  config = languageChoice.config;
+  const language = languageChoice.language;
   const t = translate.bind(null, language);
   console.log(t("pair.preflight"));
   const preflight = await assertPairingPreflightReady({ paths });
+  const environment = detectRuntimeEnvironment();
+  if (environment.warning) {
+    console.log(t("doctor.networkWarning", { message: environment.warning }));
+  }
   console.log(t("pair.hermesHome", { path: preflight.hermesHome }));
   console.log(t("pair.apiReady", { port: preflight.apiServer.port ?? "unknown" }));
   console.log(t("pair.preparing"));
@@ -695,7 +792,10 @@ program.command("pair").description(helpText("pair.description")).action(async (
   }
   console.log(t("pair.scan"));
   console.log(`Pairing page: ${pairingPageUrl}`);
-  void openSystemBrowser(pairingPageUrl);
+  const browserOpened = await openSystemBrowser(pairingPageUrl);
+  if (!browserOpened) {
+    console.log(t("pair.openBrowserFailed", { url: pairingPageUrl }));
+  }
   qrcode.generate(qrValue, { small: true });
   console.log(t("pair.expires"));
   const result = await waitForPairingOrShutdown(prepared.sessionId, paths);
@@ -705,6 +805,7 @@ program.command("pair").description(helpText("pair.description")).action(async (
   if (result === "claimed") {
     await clearPairingClaim(prepared.sessionId, paths);
     console.log(t(reusedRunningService ? "pair.claimedRunning" : "pair.claimed"));
+    printPostPairingNetworkNotice(prepared.routes.environment, config, t);
     try {
       if (hadActiveDevices) {
         console.log(t("pair.autostartUnchanged"));
@@ -789,6 +890,11 @@ program.command("doctor").description(helpText("doctor.description")).action(asy
   console.log(t("doctor.identityOk"));
   console.log(t("doctor.installId", { value: identity.install_id }));
   console.log(t("doctor.linkId", { value: identity.link_id ?? t("doctor.notAssigned") }));
+  const environment = detectRuntimeEnvironment();
+  if (environment.warning) {
+    console.log(t("doctor.networkWarning", { message: environment.warning }));
+  }
+  console.log(t("doctor.lanHost", { value: config.lanHost ?? t("status.notSet") }));
   if (hermesConfig.notice) {
     console.log(hermesConfig.notice);
     if (hermesConfig.backupPath) {
@@ -811,6 +917,48 @@ async function loadCliLanguage() {
   const config = await loadConfig();
   return resolveLanguage(config.language);
 }
+async function resolvePairingLanguage(paths, config) {
+  if (config.language !== "auto") {
+    return { config, language: resolveLanguage(config.language) };
+  }
+  const selected = await promptForLanguage();
+  if (!selected) {
+    return { config, language: resolveLanguage(config.language) };
+  }
+  const next = await saveConfig({ language: selected }, paths);
+  return { config: next, language: selected };
+}
+async function promptForLanguage() {
+  if (!process.stdin.isTTY || !process.stdout.isTTY) {
+    return null;
+  }
+  const rl = createInterface({
+    input: process.stdin,
+    output: process.stdout
+  });
+  try {
+    for (; ; ) {
+      const answer = await rl.question(
+        [
+          "\u8BF7\u9009\u62E9 Hermes Link \u663E\u793A\u8BED\u8A00 / Choose Hermes Link language:",
+          "  1. \u4E2D\u6587",
+          "  2. English",
+          "\u8F93\u5165 1 \u6216 2 \u540E\u56DE\u8F66 / Enter 1 or 2: "
+        ].join("\n")
+      );
+      const normalized = answer.trim().toLowerCase();
+      if (normalized === "1" || normalized === "zh" || normalized === "zh-cn" || normalized === "\u4E2D\u6587") {
+        return "zh-CN";
+      }
+      if (normalized === "2" || normalized === "en" || normalized === "english") {
+        return "en";
+      }
+      console.log("\u8BF7\u8F93\u5165 1 \u6216 2\u3002 / Please enter 1 or 2.");
+    }
+  } finally {
+    rl.close();
+  }
+}
 async function waitForShutdown(cleanup) {
   await new Promise((resolve) => {
     const stop = () => resolve();
@@ -843,3 +991,20 @@ async function waitForPairingOrShutdown(sessionId, paths) {
 function sleep(ms) {
   return new Promise((resolve) => setTimeout(resolve, ms));
 }
+async function reportConfigNetworkUpdate(paths, t) {
+  const identity = await loadIdentity(paths);
+  if (!identity?.link_id) {
+    console.log(t("config.reportSkippedUnpaired"));
+    return;
+  }
+  await reportLinkStatusToServer({ paths });
+  console.log(t("config.reported"));
+}
+function printPostPairingNetworkNotice(environment, config, t) {
+  if (environment.lanAutoDiscoveryUsable || config.lanHost) {
+    return;
+  }
+  console.log(t("pair.relayOnlyNotice", { kind: environment.kind }));
+  console.log(t("pair.relayOnlyLanHostHint"));
+  console.log(t("pair.relayOnlySafetyHint"));
+}

package/dist/http/app.js

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

package/package.json

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