herdr-remote 0.2.32 → 0.2.34

package/README.md

@@ -7,11 +7,13 @@ Web terminal client for [Herdr](https://herdr.dev) workspaces. Mobile-friendly U
 ## Installation & Usage
 
 ```bash
-npm install -g herdr-remote
+npm install -g https://github.com/dibin666/herdr-remote/releases/latest/download/herdr-remote.tgz
 herdr-remote
 ```
 
 Running `herdr-remote` without arguments launches the setup wizard and configuration TUI.
+Releases go to [GitHub Releases](https://github.com/dibin666/herdr-remote/releases) first and to
+npm as a fallback (`npm install -g herdr-remote`); `herdr-remote update` follows the same order.
 
 Native Windows 10/11 is supported with Node.js 22+; install Herdr from PowerShell with
 `powershell -ExecutionPolicy Bypass -c "irm https://herdr.dev/install.ps1 | iex"`.

package/README.zh-CN.md

@@ -7,11 +7,12 @@
 ## 安装与运行
 
 ```bash
-npm install -g herdr-remote
+npm install -g https://github.com/dibin666/herdr-remote/releases/latest/download/herdr-remote.tgz
 herdr-remote
 ```
 
 直接运行 `herdr-remote` 即可启动向导并进入配置 TUI。
+新版本先发布到 [GitHub Releases](https://github.com/dibin666/herdr-remote/releases)，npm 作为备用渠道（`npm install -g herdr-remote`）；`herdr-remote update` 按同样的顺序更新。
 
 已支持 Windows 10/11 原生运行（需 Node.js 22+），请在 PowerShell 中执行
 `powershell -ExecutionPolicy Bypass -c "irm https://herdr.dev/install.ps1 | iex"` 安装 Herdr。

package/dist/connector/agent-watch.js

@@ -19,7 +19,10 @@ const AGENT_STATUS_SUBSCRIPTIONS = [
  *
  * A long-lived subscription provides fast refreshes on pane and workspace
  * focus changes; the five-second poll still repairs missed events and a
- * restarted Herdr server. Both paths only read the side-channel snapshot.
+ * restarted Herdr server. Both paths only read the side-channel snapshot, and
+ * events only invalidate it: Herdr's snapshots and events share no sequence,
+ * so each (re)started subscription and each event mid-read asks for a fresh
+ * read rather than patching the last one.
  */
 export class AgentWatch {
     socketPath;
@@ -30,6 +33,7 @@ export class AgentWatch {
     debounceTimer = null;
     subscription = null;
     pending = false;
+    stale = false;
     lastSummary = null;
     constructor(options, send) {
         this.socketPath = options.socketPath;
@@ -43,7 +47,7 @@ export class AgentWatch {
         this.pollTimer = setInterval(() => this.read(), AGENT_STATUS_POLL_MS);
         this.pollTimer.unref?.();
         try {
-            this.subscription = this.subscribe(this.socketPath, AGENT_STATUS_SUBSCRIPTIONS, () => this.scheduleRead());
+            this.subscription = this.subscribe(this.socketPath, AGENT_STATUS_SUBSCRIPTIONS, () => this.scheduleRead(), { onStarted: () => this.scheduleRead() });
         }
         catch {
             // A missing or restarting Herdr server leaves the regular poll in place.
@@ -63,6 +67,7 @@ export class AgentWatch {
             this.subscription.close();
             this.subscription = null;
         }
+        this.stale = false;
         this.lastSummary = null;
     }
     scheduleRead() {
@@ -84,9 +89,14 @@ export class AgentWatch {
      * Herdr's server not running is an ordinary state, not news.
      */
     async read() {
-        if (this.pending || !this.pollTimer)
+        if (!this.pollTimer)
+            return;
+        if (this.pending) {
+            this.stale = true;
             return;
+        }
         this.pending = true;
+        this.stale = false;
         let snapshot;
         try {
             const result = await this.request(this.socketPath, 'session.snapshot', {});
@@ -97,6 +107,9 @@ export class AgentWatch {
         }
         finally {
             this.pending = false;
+            // Something changed while this answer was in flight; it may predate it.
+            if (this.stale)
+                this.scheduleRead();
         }
         // Stopped while the answer was in flight; the browser it was for is gone.
         if (!this.pollTimer)

package/dist/connector/herdr-prefix-keys.js

@@ -0,0 +1,28 @@
+// The keys that put this workstation's Herdr into prefix mode. A browser has
+// to tell a Herdr command from typed text, and only Herdr's own config file
+// says which key starts one, so the host reads it and reports it in its hello.
+import fs from 'node:fs';
+import { sanitizeHerdrPrefixKeys } from 'herdr-remote-relay/protocol';
+import { herdrConfigPath } from '../socket-discovery.js';
+import { parseTomlSubset } from '../terminal-font/formats.js';
+/** What Herdr uses when `keys.prefix` is absent or names nothing it can read. */
+const DEFAULT_PREFIX_KEYS = ['ctrl+b'];
+/**
+ * `keys.prefix` from the Herdr config the connector's Herdr reads: one key or
+ * a list, each a combo like `ctrl+space`. Always at least one key, because
+ * Herdr itself falls back to `ctrl+b` when the file, the key or every entry
+ * is unusable.
+ */
+export function readHerdrPrefixKeys(env = process.env, platform = process.platform) {
+    let text;
+    try {
+        text = fs.readFileSync(herdrConfigPath(env, platform), 'utf8');
+    }
+    catch {
+        // No readable config file means Herdr runs on its defaults.
+        return [...DEFAULT_PREFIX_KEYS];
+    }
+    const configured = parseTomlSubset(text)['keys.prefix'];
+    const entries = typeof configured === 'string' ? [configured] : configured;
+    return sanitizeHerdrPrefixKeys(entries) ?? [...DEFAULT_PREFIX_KEYS];
+}

package/dist/connector/host-connector.js

@@ -3,7 +3,7 @@
 // message to the part of the connector that owns it.
 import os from 'node:os';
 import path from 'node:path';
-import { CAPABILITY, PROTOCOL_VERSION, unpackStreamFrame, } from 'herdr-remote-relay/protocol';
+import { unpackStreamFrame } from 'herdr-remote-relay/protocol';
 import { WebSocket } from 'ws';
 import { loadConfig } from '../config.js';
 import { EXIT_AUTH_FAILED, EXIT_REPLACED } from '../exit-codes.js';
@@ -16,6 +16,7 @@ import { randomToken } from 'herdr-remote-relay/state';
 import { openAdminTabFor } from './admin-tab.js';
 import { AgentWatch } from './agent-watch.js';
 import { FontServer } from './font-server.js';
+import { hostHello } from './host-hello.js';
 import { acquireHostLock, releaseHostLock } from './lock.js';
 import { Sessions } from './sessions.js';
 import { UpdateReport } from './update-report.js';
@@ -178,29 +179,14 @@ export class HostConnector {
             }
             ws.isAlive = true;
             this.authFailure = false;
-            sendJson(ws, {
-                type: 'host_hello',
-                protocol: PROTOCOL_VERSION,
+            sendJson(ws, hostHello({
                 hostId: this.hostId,
                 token: this.hostToken,
-                password: this.relayPassword || null,
-                hostname: os.hostname(),
-                platform: process.platform,
-                ...(process.platform === 'win32' &&
-                    (process.env.MSYSTEM || /(?:^|[\\/])(?:bash|sh)(?:\.exe)?$/i.test(process.env.SHELL || ''))
-                    ? { shellProfile: 'git-bash' }
-                    : {}),
-                arch: process.arch,
+                password: this.relayPassword,
                 version: this.updates.runningVersion,
-                terminalPalette: this.terminalPalette || null,
+                terminalPalette: this.terminalPalette,
                 terminalFont: this.font.publicFont(),
-                capabilities: [
-                    CAPABILITY.hostHandoff,
-                    CAPABILITY.idleHeartbeat,
-                    CAPABILITY.binaryFrameV2,
-                    ...(process.platform === 'win32' ? [CAPABILITY.adminTabs] : []),
-                ],
-            });
+            }));
             // The relay sends host_ready with the current browser count. No business
             // heartbeat is started until that message says somebody is watching.
         });

package/dist/connector/host-hello.js

@@ -0,0 +1,32 @@
+// The first message a workstation sends the relay: who it is, what it runs,
+// and the facts about its terminal and Herdr that a browser cannot learn itself.
+import os from 'node:os';
+import { CAPABILITY, PROTOCOL_VERSION } from 'herdr-remote-relay/protocol';
+import { readHerdrPrefixKeys } from './herdr-prefix-keys.js';
+/** Built afresh for each connection, so a reconnect reports the config as it is now. */
+export function hostHello(identity) {
+    return {
+        type: 'host_hello',
+        protocol: PROTOCOL_VERSION,
+        hostId: identity.hostId,
+        token: identity.token,
+        password: identity.password || null,
+        hostname: os.hostname(),
+        platform: process.platform,
+        ...(process.platform === 'win32' &&
+            (process.env.MSYSTEM || /(?:^|[\\/])(?:bash|sh)(?:\.exe)?$/i.test(process.env.SHELL || ''))
+            ? { shellProfile: 'git-bash' }
+            : {}),
+        arch: process.arch,
+        version: identity.version,
+        terminalPalette: identity.terminalPalette || null,
+        terminalFont: identity.terminalFont,
+        herdrPrefixKeys: readHerdrPrefixKeys(),
+        capabilities: [
+            CAPABILITY.hostHandoff,
+            CAPABILITY.idleHeartbeat,
+            CAPABILITY.binaryFrameV2,
+            ...(process.platform === 'win32' ? [CAPABILITY.adminTabs] : []),
+        ],
+    };
+}

package/dist/herdr-api.js

@@ -122,9 +122,14 @@ function requestHerdr(socketPath, method, params = {}, options = {}) {
  * They share a socket, but are separate NDJSON messages. A subscription never
  * starts or writes to a terminal, so an unavailable socket is only a reason to
  * retry this side channel.
+ *
+ * Events are not replayed across connections, and from Herdr 0.9.2 a reader
+ * that falls behind gets an `events_lost` error carrying the request id and a
+ * closed socket. Both end in a reconnect, and `onStarted` fires on every
+ * acknowledgement so the caller can re-read what it may have missed.
  */
 function subscribeHerdr(socketPath, subscriptions, onEvent, options = {}) {
-    const { connect = net.connect, retryBaseMs = SUBSCRIBE_RETRY_BASE_MS, retryMaxMs = SUBSCRIBE_RETRY_MAX_MS, } = options;
+    const { connect = net.connect, retryBaseMs = SUBSCRIBE_RETRY_BASE_MS, retryMaxMs = SUBSCRIBE_RETRY_MAX_MS, onStarted, } = options;
     let socket = null;
     let reconnectTimer = null;
     let handshakeTimer = null;
@@ -203,6 +208,7 @@ function subscribeHerdr(socketPath, subscriptions, onEvent, options = {}) {
                     }
                     acknowledged = true;
                     retryCount = 0;
+                    onStarted?.();
                 }
                 else if (acknowledged &&
                     typeof message?.event === 'string' &&

package/dist/herdr-command.js

@@ -29,8 +29,13 @@ const COMMAND_NAME = 'herdr';
  * machine in the background stops resizing somebody else's focused pane, and a
  * large paste no longer disconnects the client — and pasting is how an image
  * reaches an agent from a phone.
+ *
+ * 0.9.3 because a browser types through escape sequences: 0.9.2 stopped a tap
+ * on a pane from sending a stray Escape to a working agent and stopped mouse
+ * reports split across reads from leaking into the shell, and it also broke
+ * Escape followed by a key — Alt+B, Alt+F, Alt+Backspace — which 0.9.3 mends.
  */
-const MIN_HERDR_VERSION = '0.9.1';
+const MIN_HERDR_VERSION = '0.9.3';
 /** Where a user-level install lands, in the order we trust it. */
 const FALLBACK_DIRECTORIES = [
     '~/.local/bin',
@@ -224,7 +229,7 @@ function herdrVersion({ command, timeout = 10_000, ...lookup } = {}) {
 /** The one line that tells a user why an older Herdr is a problem here. */
 function herdrOutdatedMessage(version) {
     return (`Herdr ${version} is older than ${MIN_HERDR_VERSION}, which herdr-remote is written against. ` +
-        'Run "herdr update" — window titles, background machine activation and large pastes all ' +
+        'Run "herdr update" — window titles, large pastes, taps on a pane and Alt shortcuts all ' +
         'misbehave in browser windows before that release.');
 }
 /** The one message a user needs to fix a missing install themselves. */

package/dist/i18n/en.js

@@ -163,7 +163,7 @@ const en = {
     'herdr.autoStartHint': 'Off: Herdr starts only when you run it, or when you confirm it from a browser. On: herdr-remote also starts it every time it starts, at boot included. Takes effect the next time herdr-remote starts.',
     'herdr.cliMissing': 'Command herdr not found. Set HERDR_BIN_PATH to its full path.',
     'herdr.version': 'Herdr version',
-    'herdr.versionOutdated': 'Herdr {version} is older than {minimum}. Run "herdr update": window titles, background machine activation and large pastes misbehave in browser windows before that release.',
+    'herdr.versionOutdated': 'Herdr {version} is older than {minimum}. Run "herdr update": window titles, large pastes, taps on a pane and Alt shortcuts misbehave in browser windows before that release.',
     'about.title': 'Language & about',
     'about.language': 'Interface language',
     'about.languageAuto': 'Follow system ({detected})',
@@ -229,16 +229,16 @@ const en = {
     'update.title': 'Updates',
     'update.banner': 'herdr-remote {latest} is out (running {current}). Press 7 and Enter on the update row to install.',
     'update.check': 'Check for updates',
-    'update.checking': 'Checking npm…',
+    'update.checking': 'Checking GitHub Releases and npm…',
     'update.upToDate': 'Up to date ({version})',
     'update.available': 'Update {version} available (press Enter to install)',
     'update.updating': 'Installing {version}…',
     'update.updatingRetry': 'Installing {version}… (npm has not caught up yet, attempt {attempt})',
     'update.done': 'Updated to {version}',
     'update.restartHint': 'Update installed. Restart herdr-remote to apply.',
-    'update.errorNetwork': 'Could not reach any npm registry',
-    'update.errorNetworkDetail': 'No registry answered: {message}',
-    'update.errorFailed': 'Update failed. Run: npm install -g herdr-remote@{version} --prefer-online',
+    'update.errorNetwork': 'Could not reach GitHub Releases or any npm registry',
+    'update.errorNetworkDetail': 'Nothing answered: {message}',
+    'update.errorFailed': 'Update failed. Run: npm install -g {url}',
     'update.errorFailedDetail': 'npm: {message}',
     'update.errorNotYetPublished': 'npm has not caught up with {version} yet (common in the first minutes after a release). Press Enter to try again shortly.',
     'update.errorNotApplied': 'npm reported success, but {installed} is still installed',
@@ -253,18 +253,5 @@ const en = {
     'update.brokerRestartFailed': 'The admin terminal broker did not start again. Sign out of Windows and back in, or run herdr-remote admin-broker restart.',
     'update.brokerBusy': 'An admin terminal is open, so the broker keeps running the previous release. Close admin terminals, then run herdr-remote admin-broker restart.',
     'update.errorBusy': "A process still holds the herdr-remote folder; an admin terminal broker set up by an older release does. In an administrator PowerShell run: Get-ScheduledTask -TaskName 'HerdrRemoteAdminBroker-*' | Stop-ScheduledTask. Then run herdr-remote update again here, and afterwards herdr-remote admin-broker install as administrator.",
-    'relayUpdate.check': 'Relay {version}: check for updates',
-    'relayUpdate.checking': 'Relay: checking npm…',
-    'relayUpdate.upToDate': 'Relay up to date ({version})',
-    'relayUpdate.available': 'Relay {latest} available, installed {installed} (press Enter to install)',
-    'relayUpdate.needsCli': 'Relay {latest} needs a newer herdr-remote: update herdr-remote first',
-    'relayUpdate.updating': 'Installing relay {version}…',
-    'relayUpdate.updatingRetry': 'Installing relay {version}… (npm has not caught up yet, attempt {attempt})',
-    'relayUpdate.restart': 'Relay {version} installed, {running} still running (press Enter to restart)',
-    'relayUpdate.restarting': 'Restarting herdr-remote…',
-    'relayUpdate.restarted': 'herdr-remote restarted; the relay now runs {version}.',
-    'relayUpdate.done': 'Relay updated to {version}',
-    'relayUpdate.errorNotApplied': 'npm finished, but relay {installed} is still installed',
-    'relayUpdate.banner': 'Relay {latest} is out (installed {current}). Press 7 and Enter on the relay row to install.',
 };
 export default en;

package/dist/i18n/zh.js

@@ -162,7 +162,7 @@ const zh = {
     'herdr.autoStartHint': '关：Herdr 只在你手动运行，或在浏览器里确认后才启动。开：herdr-remote 每次启动（包括开机）时一并启动 Herdr。下次 herdr-remote 启动时生效。',
     'herdr.cliMissing': '未找到 herdr 命令，可将 HERDR_BIN_PATH 设为其完整路径。',
     'herdr.version': 'Herdr 版本',
-    'herdr.versionOutdated': 'Herdr {version} 低于 {minimum}，请运行 “herdr update”：在该版本之前，浏览器窗口的标题、后台机器激活与大段粘贴都会出问题。',
+    'herdr.versionOutdated': 'Herdr {version} 低于 {minimum}，请运行 “herdr update”：在该版本之前，浏览器窗口的标题、大段粘贴、点按窗格与 Alt 快捷键都会出问题。',
     'about.title': '语言与关于',
     'about.language': '界面语言',
     'about.languageAuto': '跟随系统（{detected}）',
@@ -228,16 +228,16 @@ const zh = {
     'update.title': '更新',
     'update.banner': 'herdr-remote {latest} 已发布（当前 {current}），按 7 进入「语言与关于」，在更新一行按 Enter 安装。',
     'update.check': '检查更新',
-    'update.checking': '查询 npm 中…',
+    'update.checking': '查询 GitHub Releases 与 npm 中…',
     'update.upToDate': '已是最新（{version}）',
     'update.available': '新版本 {version} 可用（按 Enter 安装）',
     'update.updating': '安装 {version} 中…',
     'update.updatingRetry': '安装 {version} 中…（npm 尚未同步，第 {attempt} 次尝试）',
     'update.done': '已更新至 {version}',
     'update.restartHint': '更新已安装，重启 herdr-remote 生效。',
-    'update.errorNetwork': '所有 npm registry 均无法连接',
-    'update.errorNetworkDetail': '无 registry 应答：{message}',
-    'update.errorFailed': '更新失败，可手动执行：npm install -g herdr-remote@{version} --prefer-online',
+    'update.errorNetwork': 'GitHub Releases 与所有 npm registry 均无法连接',
+    'update.errorNetworkDetail': '均无应答：{message}',
+    'update.errorFailed': '更新失败，可手动执行：npm install -g {url}',
     'update.errorFailedDetail': 'npm：{message}',
     'update.errorNotYetPublished': 'npm 还没同步到 {version}（刚发布的几分钟内常见），稍后按 Enter 重试。',
     'update.errorNotApplied': 'npm 报告成功，但安装的仍是 {installed}',
@@ -252,18 +252,5 @@ const zh = {
     'update.brokerRestartFailed': '管理员终端 broker 没有重新启动。重新登录 Windows，或运行 herdr-remote admin-broker restart。',
     'update.brokerBusy': '有管理员终端开着，broker 继续运行旧版本。关闭所有管理员终端后运行 herdr-remote admin-broker restart。',
     'update.errorBusy': "仍有进程占用 herdr-remote 的安装目录，旧版本设置的管理员终端 broker 会这样。先在管理员 PowerShell 中执行：Get-ScheduledTask -TaskName 'HerdrRemoteAdminBroker-*' | Stop-ScheduledTask，再回到这里重新运行 herdr-remote update，最后以管理员身份运行 herdr-remote admin-broker install。",
-    'relayUpdate.check': 'Relay {version}：检查更新',
-    'relayUpdate.checking': 'Relay：查询 npm 中…',
-    'relayUpdate.upToDate': 'Relay 已是最新（{version}）',
-    'relayUpdate.available': 'Relay 新版本 {latest} 可用，当前 {installed}（按 Enter 安装）',
-    'relayUpdate.needsCli': 'Relay {latest} 需要更新 herdr-remote，请先更新上一行',
-    'relayUpdate.updating': '安装 relay {version} 中…',
-    'relayUpdate.updatingRetry': '安装 relay {version} 中…（npm 尚未同步，第 {attempt} 次尝试）',
-    'relayUpdate.restart': 'Relay {version} 已安装，运行中的仍是 {running}（按 Enter 重启生效）',
-    'relayUpdate.restarting': '正在重启 herdr-remote…',
-    'relayUpdate.restarted': 'herdr-remote 已重启，relay 现在运行 {version}。',
-    'relayUpdate.done': 'Relay 已更新至 {version}',
-    'relayUpdate.errorNotApplied': 'npm 已完成，但安装的仍是 relay {installed}',
-    'relayUpdate.banner': 'Relay {latest} 已发布（当前 {current}），按 7 进入「语言与关于」，在 Relay 一行按 Enter 安装。',
 };
 export default zh;

package/dist/pty-session.js

@@ -1,5 +1,28 @@
 import os from 'node:os';
 import { nodePty } from './node-pty-loader.js';
+/**
+ * Variables that name the terminal this process was started from. The Herdr
+ * client's outer terminal is the browser's xterm.js, and from Herdr 0.9.2 the
+ * client reads these to pick image transports: one that believes it runs in
+ * Ghostty, kitty or WezTerm hands images over as local file paths no browser
+ * can open. Herdr strips the same list from its own panes.
+ */
+const OUTER_TERMINAL_ENV = [
+    'TERM_PROGRAM',
+    'TERM_PROGRAM_VERSION',
+    'ITERM_SESSION_ID',
+    'LC_TERMINAL',
+    'LC_TERMINAL_VERSION',
+    'WEZTERM_PANE',
+    'KITTY_WINDOW_ID',
+    'WT_SESSION',
+    'TMUX',
+    'TMUX_PANE',
+    'STY',
+    'ZELLIJ',
+    'ZELLIJ_SESSION_NAME',
+    'ZELLIJ_PANE_ID',
+];
 class PtySession {
     static DEFAULT_COLS = 100;
     static DEFAULT_ROWS = 30;
@@ -29,12 +52,14 @@ class PtySession {
         this.terminal = null;
         this.startedAt = null;
     }
-    static childEnv(socketPath) {
-        const env = { ...process.env };
+    static childEnv(socketPath, source = process.env) {
+        const env = { ...source };
         for (const key of Object.keys(env)) {
             if (key.startsWith('HERDR_'))
                 delete env[key];
         }
+        for (const key of OUTER_TERMINAL_ENV)
+            delete env[key];
         if (socketPath)
             env.HERDR_SOCKET_PATH = socketPath;
         env.TERM = 'xterm-256color';

package/dist/socket-discovery.js

@@ -1,18 +1,28 @@
 import fs from 'node:fs';
 import os from 'node:os';
 import path from 'node:path';
-function defaultSocketPath(env = process.env, platform = process.platform) {
-    if (env.HERDR_SOCKET_PATH)
-        return env.HERDR_SOCKET_PATH;
+/**
+ * Herdr's own config directory, resolved as Herdr does (`XDG_CONFIG_HOME`
+ * first on every platform, then the platform's home for it), so the socket
+ * and `config.toml` are found wherever Herdr put them.
+ */
+function herdrConfigDir(env = process.env, platform = process.platform) {
     if (platform === 'win32') {
         const configHome = env.XDG_CONFIG_HOME ||
             env.APPDATA ||
             (env.USERPROFILE && path.join(env.USERPROFILE, 'AppData', 'Roaming')) ||
             path.join(os.homedir(), 'AppData', 'Roaming');
-        return path.join(configHome, 'herdr', 'herdr.sock');
+        return path.join(configHome, 'herdr');
     }
     const configHome = env.XDG_CONFIG_HOME || path.join(os.homedir(), '.config');
-    return path.join(configHome, 'herdr', 'herdr.sock');
+    return path.join(configHome, 'herdr');
+}
+function defaultSocketPath(env = process.env, platform = process.platform) {
+    return env.HERDR_SOCKET_PATH || path.join(herdrConfigDir(env, platform), 'herdr.sock');
+}
+/** The `config.toml` Herdr reads; `HERDR_CONFIG_PATH` names it outright. */
+function herdrConfigPath(env = process.env, platform = process.platform) {
+    return env.HERDR_CONFIG_PATH || path.join(herdrConfigDir(env, platform), 'config.toml');
 }
 /**
  * On Windows, Herdr uses this path itself as the GenericNamespaced pipe name;
@@ -57,4 +67,4 @@ function inspectSocket(socketPath, options = {}) {
         };
     }
 }
-export { defaultSocketPath, herdrEndpoint, resolveSocketPath, inspectSocket };
+export { defaultSocketPath, herdrConfigPath, herdrEndpoint, resolveSocketPath, inspectSocket };

package/dist/terminal-font/formats.js

@@ -193,10 +193,28 @@ export function parseJsonc(text) {
         return null;
     }
 }
+/** `line` up to a `#` that starts a comment, not one inside a string. */
+function withoutTomlComment(line) {
+    let quote = '';
+    for (let i = 0; i < line.length; i += 1) {
+        const char = line[i];
+        if (quote) {
+            if (char === '\\' && quote === '"')
+                i += 1;
+            else if (char === quote)
+                quote = '';
+        }
+        else if (char === '"' || char === "'")
+            quote = char;
+        else if (char === '#')
+            return line.slice(0, i);
+    }
+    return line;
+}
 /**
- * Just enough TOML for Alacritty's font keys: tables, dotted keys, strings,
- * numbers, inline tables and (possibly multi-line) string arrays. Returns a
- * flat `dotted.key → value` map.
+ * Just enough TOML for Alacritty's font keys and Herdr's `keys.prefix`:
+ * tables, dotted keys, strings, numbers, inline tables and (possibly
+ * multi-line) string arrays. Returns a flat `dotted.key → value` map.
  */
 export function parseTomlSubset(text) {
     const values = {};
@@ -253,11 +271,13 @@ export function parseTomlSubset(text) {
         if (equals === -1)
             continue;
         let rawValue = line.slice(equals + 1);
-        // An array may span lines; gather it before assigning.
-        if (rawValue.trim().startsWith('[') && !rawValue.includes(']')) {
+        if (rawValue.trim().startsWith('[')) {
+            // A comment inside an array may hold quotes or a `]` of its own.
+            rawValue = withoutTomlComment(rawValue);
+            // An array may span lines; gather it before assigning.
             while (index + 1 < lines.length && !rawValue.includes(']')) {
                 index += 1;
-                rawValue += ` ${lines[index].trim()}`;
+                rawValue += ` ${withoutTomlComment(lines[index]).trim()}`;
             }
         }
         assign(table, line.slice(0, equals), rawValue);

package/dist/terminal-font/terminals.js

@@ -19,6 +19,15 @@ const TERMINAL_PROCESSES = [
     [/^xterm$/, 'xterm'],
     [/^(urxvt|urxvtd|rxvt)$/, 'urxvt'],
 ];
+/** macOS app bundle ids, which every process an app starts inherits. */
+const BUNDLE_TERMINALS = {
+    'com.apple.Terminal': 'apple-terminal',
+    'com.googlecode.iterm2': 'iterm2',
+    'com.microsoft.VSCode': 'vscode',
+    'com.mitchellh.ghostty': 'ghostty',
+    'com.github.wez.wezterm': 'wezterm',
+    'net.kovidgoyal.kitty': 'kitty',
+};
 /**
  * The emulator a process runs under, from its own ancestry first.
  *
@@ -37,10 +46,15 @@ export function identifyTerminal({ env = process.env, ancestry = [], } = {}) {
                 return id;
         }
     }
+    // From Herdr 0.9.2 a pane says TERM_PROGRAM=herdr and loses the terminal's
+    // session markers, so a start from inside Herdr falls through to markers
+    // Herdr leaves alone: macOS's app bundle id, ITERM_PROFILE, KITTY_PID,
+    // WT_PROFILE_ID.
     const program = env.TERM_PROGRAM || '';
+    const bundle = env.__CFBundleIdentifier || '';
     if (program === 'vscode')
         return 'vscode';
-    if (program === 'iTerm.app' || env.ITERM_SESSION_ID)
+    if (program === 'iTerm.app' || env.ITERM_SESSION_ID || env.ITERM_PROFILE)
         return 'iterm2';
     if (program === 'Apple_Terminal')
         return 'apple-terminal';
@@ -48,7 +62,7 @@ export function identifyTerminal({ env = process.env, ancestry = [], } = {}) {
         return 'wezterm';
     if (program === 'ghostty' || env.GHOSTTY_RESOURCES_DIR)
         return 'ghostty';
-    if (env.KITTY_WINDOW_ID || env.TERM === 'xterm-kitty')
+    if (env.KITTY_WINDOW_ID || env.KITTY_PID || env.TERM === 'xterm-kitty')
         return 'kitty';
     if (env.ALACRITTY_SOCKET || env.ALACRITTY_WINDOW_ID || env.ALACRITTY_LOG)
         return 'alacritty';
@@ -64,8 +78,10 @@ export function identifyTerminal({ env = process.env, ancestry = [], } = {}) {
         return 'gnome-terminal';
     if (/^rxvt-unicode/.test(env.TERM || ''))
         return 'urxvt';
+    if (Object.hasOwn(BUNDLE_TERMINALS, bundle))
+        return BUNDLE_TERMINALS[bundle];
     // WT_SESSION is inherited by nested terminals, so specific terminal markers win first.
-    if (env.WT_SESSION)
+    if (env.WT_SESSION || env.WT_PROFILE_ID)
         return 'windows-terminal';
     // Last: a terminal started from xterm inherits this too.
     if (env.XTERM_VERSION)

package/dist/tui/App.js

@@ -3,7 +3,7 @@ import { useCallback, useEffect, useMemo, useRef, useState } from 'react';
 import { Box, Text, useApp, useInput } from 'ink';
 import { useMouse, useMouseTarget } from './mouse/index.js';
 import { theme } from './theme.js';
-import { checkForRelayUpdate, checkForUpdate, createDraft, createTranslator, detectLocale, ensureRuntime, fullStatus, loadConfig, requiresRestart, runsLocalRelay, updateChecksEnabled, } from './api.js';
+import { checkForUpdate, createDraft, createTranslator, detectLocale, ensureRuntime, fullStatus, loadConfig, requiresRestart, updateChecksEnabled, } from './api.js';
 import { Overview } from './screens/Overview.js';
 import { PairScreen } from './screens/Pair.js';
 import { Services } from './screens/Services.js';
@@ -30,7 +30,7 @@ function Tab({ label, active, onSelect, }) {
 function Footer({ hints }) {
     return (_jsx(Box, { marginTop: 1, paddingX: 1, children: _jsx(Text, { color: theme.muted, children: hints.join('  ·  ') }) }));
 }
-export function App({ initialLanguage, needsWizard, updateChecker = updateChecksEnabled() ? checkForUpdate : null, relayUpdateChecker = updateChecksEnabled() ? checkForRelayUpdate : null, }) {
+export function App({ initialLanguage, needsWizard, updateChecker = updateChecksEnabled() ? checkForUpdate : null, }) {
     const { exit } = useApp();
     const mouse = useMouse();
     const [config, setConfig] = useState(() => loadConfig());
@@ -43,8 +43,6 @@ export function App({ initialLanguage, needsWizard, updateChecker = updateChecks
     const [editingId, setEditingId] = useState(null);
     const [wizardDone, setWizardDone] = useState(!needsWizard);
     const [updateCheck, setUpdateCheck] = useState(null);
-    const [relayUpdateCheck, setRelayUpdateCheck] = useState(null);
-    const localRelay = runsLocalRelay(config);
     // Every time the TUI opens: that is when someone is here to act on it.
     // Failure says nothing; the About tab can still be asked by hand.
     useEffect(() => {
@@ -61,21 +59,6 @@ export function App({ initialLanguage, needsWizard, updateChecker = updateChecks
             cancelled = true;
         };
     }, [updateChecker]);
-    // A relay somewhere else is somebody else's to update.
-    useEffect(() => {
-        if (!relayUpdateChecker || !localRelay)
-            return undefined;
-        let cancelled = false;
-        relayUpdateChecker()
-            .then((result) => {
-            if (!cancelled && result?.ok)
-                setRelayUpdateCheck(result);
-        })
-            .catch(() => { });
-        return () => {
-            cancelled = true;
-        };
-    }, [relayUpdateChecker, localRelay]);
     const locale = useMemo(() => detectLocale({ preference: initialLanguage ?? draft.ui.language }), [initialLanguage, draft.ui.language]);
     const t = useMemo(() => createTranslator(locale), [locale]);
     const dirty = useMemo(() => JSON.stringify(config) !== JSON.stringify(draft), [config, draft]);
@@ -153,8 +136,6 @@ export function App({ initialLanguage, needsWizard, updateChecker = updateChecks
         message,
         updateCheck,
         setUpdateCheck,
-        relayUpdateCheck,
-        setRelayUpdateCheck,
     };
     useInput((input, key) => {
         if (key.ctrl && input === 'c') {
@@ -214,8 +195,5 @@ export function App({ initialLanguage, needsWizard, updateChecker = updateChecks
             : t('hint.mouseUnsupported'),
         t('hint.quit'),
     ].filter(Boolean);
-    return (_jsxs(Box, { flexDirection: "column", paddingX: 1, paddingY: 1, children: [_jsxs(Box, { marginBottom: 1, flexDirection: "column", children: [_jsxs(Box, { children: [_jsx(Text, { bold: true, children: t('app.name') }), _jsx(Text, { color: theme.muted, children: `  ${t('app.tagline')}` })] }), updateCheck?.updateAvailable ? (_jsx(Text, { color: theme.warn, children: t('update.banner', { latest: updateCheck.latest ?? '', current: updateCheck.current }) })) : null, localRelay && relayUpdateCheck?.updateAvailable ? (_jsx(Text, { color: theme.warn, children: t('relayUpdate.banner', {
-                            latest: relayUpdateCheck.latest ?? '',
-                            current: relayUpdateCheck.current,
-                        }) })) : null] }), _jsx(Box, { marginBottom: 1, children: TABS.map((entry, entryIndex) => (_jsx(Tab, { label: `${entryIndex + 1} ${t(entry.labelKey)}`, active: entry.id === tab, onSelect: () => setTab(entry.id) }, entry.id))) }), tab === 'overview' ? _jsx(Overview, { ctx: context }) : null, tab === 'pair' ? _jsx(PairScreen, { ctx: context }) : null, tab === 'services' ? _jsx(Services, { ctx: context }) : null, tab === 'relay' ? _jsx(RelayScreen, { ctx: context }) : null, tab === 'keepalive' ? _jsx(Keepalive, { ctx: context }) : null, tab === 'herdr' ? _jsx(HerdrScreen, { ctx: context }) : null, tab === 'about' ? _jsx(About, { ctx: context }) : null, restartPending ? (_jsx(Box, { marginTop: 1, children: _jsx(Text, { color: theme.warn, children: t('hint.restartRequired') }) })) : null, _jsx(Footer, { hints: hints })] }));
+    return (_jsxs(Box, { flexDirection: "column", paddingX: 1, paddingY: 1, children: [_jsxs(Box, { marginBottom: 1, flexDirection: "column", children: [_jsxs(Box, { children: [_jsx(Text, { bold: true, children: t('app.name') }), _jsx(Text, { color: theme.muted, children: `  ${t('app.tagline')}` })] }), updateCheck?.updateAvailable ? (_jsx(Text, { color: theme.warn, children: t('update.banner', { latest: updateCheck.latest ?? '', current: updateCheck.current }) })) : null] }), _jsx(Box, { marginBottom: 1, children: TABS.map((entry, entryIndex) => (_jsx(Tab, { label: `${entryIndex + 1} ${t(entry.labelKey)}`, active: entry.id === tab, onSelect: () => setTab(entry.id) }, entry.id))) }), tab === 'overview' ? _jsx(Overview, { ctx: context }) : null, tab === 'pair' ? _jsx(PairScreen, { ctx: context }) : null, tab === 'services' ? _jsx(Services, { ctx: context }) : null, tab === 'relay' ? _jsx(RelayScreen, { ctx: context }) : null, tab === 'keepalive' ? _jsx(Keepalive, { ctx: context }) : null, tab === 'herdr' ? _jsx(HerdrScreen, { ctx: context }) : null, tab === 'about' ? _jsx(About, { ctx: context }) : null, restartPending ? (_jsx(Box, { marginTop: 1, children: _jsx(Text, { color: theme.warn, children: t('hint.restartRequired') }) })) : null, _jsx(Footer, { hints: hints })] }));
 }

package/dist/tui/api.js

@@ -16,9 +16,9 @@ import { ensureRuntime, regenerateHostIdentity, setRelayPassword } from '../runt
 import { pair, readLogTail } from '../service.js';
 import { fullStatus, restartAll, startAll, stopAll, whileServicesStopped } from '../lifecycle.js';
 import * as keepalive from '../keepalive/index.js';
-import { canSelfUpdate, checkForUpdate, compareVersions, currentVersion, updateChecksEnabled, installKind, performUpdate, } from '../updater.js';
-import { checkForRelayUpdate, installedRelayVersion, performRelayUpdate, } from '../relay-updater.js';
-export { detectLocale, listReachableAddresses, MIN_HERDR_VERSION, OFFICIAL_RELAY_URL, isOfficialRelay, selectedMode, canSelfUpdate, checkForUpdate, compareVersions, currentVersion, updateChecksEnabled, installKind, performUpdate, checkForRelayUpdate, installedRelayVersion, performRelayUpdate, runsLocalRelay, bindAddress, configExists, configPath, createDraft, createTranslator, ensureRuntime, extractPairingCode, fieldsForMode, fullStatus, getField, getFieldPlaceholder, herdrVersion, keepalive, loadConfig, pair, readLogTail, regenerateHostIdentity, requiresRestart, restartAll, saveDraft, setField, setRelayPassword, startAll, stateDir, stopAll, whileServicesStopped, };
+import { canSelfUpdate, checkForUpdate, currentVersion, updateChecksEnabled, installKind, installedRelayVersion, performUpdate, } from '../updater.js';
+export { cliTarballUrl } from 'herdr-remote-relay/protocol';
+export { detectLocale, listReachableAddresses, MIN_HERDR_VERSION, OFFICIAL_RELAY_URL, isOfficialRelay, selectedMode, canSelfUpdate, checkForUpdate, currentVersion, updateChecksEnabled, installKind, performUpdate, installedRelayVersion, runsLocalRelay, bindAddress, configExists, configPath, createDraft, createTranslator, ensureRuntime, extractPairingCode, fieldsForMode, fullStatus, getField, getFieldPlaceholder, herdrVersion, keepalive, loadConfig, pair, readLogTail, regenerateHostIdentity, requiresRestart, restartAll, saveDraft, setField, setRelayPassword, startAll, stateDir, stopAll, whileServicesStopped, };
 export async function adminBrokerStatus({ waitForStart = false } = {}) {
     if (process.platform !== 'win32')
         return false;