@linxiraos/pi-tui 1.1.24 → 1.1.25

package/CHANGELOG.md

@@ -2,9 +2,9 @@
 
 ## [Unreleased]
 
-## [1.1.24] - 2026-10-03
+## [1.1.25] - 2026-10-03
 
-- 语义角色清扫补全（omp.*→zeta.*，106 文件）；agent-hub 空态提示还原 `omp-dev`；notifications OSC 99 对齐 zeta app id。
+- Hyperlinks (OSC 8) are now emitted when running inside Zetawork workbench panes: the `ZETA_WORKBENCH=1` probe unlocks `fileHyperlink` output, so file links stay clickable and titles update live in the workbench's embedded terminals.
 
 ## [14.9.8] - 2026-05-12
 
@@ -775,6 +775,10 @@ Initial release under @oh-my-pi scope. See previous releases at [badlogic/pi-mon
 
 - Added `getText()` method to Text component for retrieving current text content
 
+## [1.1.24] - 2026-10-03
+
+- 语义角色清扫补全（omp.*→zeta.*，106 文件）；agent-hub 空态提示还原 `omp-dev`；notifications OSC 99 对齐 zeta app id。
+
 ## [1.1.19] - 2026-09-22
 
 - 版本线推进;本版无独立用户可见变化。

package/dist/types/terminal-capabilities.d.ts

@@ -146,6 +146,14 @@ export declare function detectRectangularSgrSupport(terminalId: TerminalId, env?
  * bytes survive — the same reason DECCARA and synchronized output gate on it.
  */
 export declare function detectStyledUnderlineSupport(terminalId: TerminalId, env?: NodeJS.ProcessEnv): boolean;
+/**
+ * True when this process runs inside a Zeta workbench pane. The workbench
+ * injects `ZETA_WORKBENCH=1` into every pane PTY (`termide` set_env); its
+ * terminal simulator renders OSC 8 in its own grid and opens links itself on
+ * Ctrl+click, so — like Herdr — the outer terminal's advertised support does
+ * not matter. Pane-only detection, mirroring `isInsideHerdr`.
+ */
+export declare function isInsideZetaWorkbench(env?: NodeJS.ProcessEnv): boolean;
 /**
  * Resolve an explicit user override for OSC 8 hyperlinks. Returns `false` for
  * an opt-out, `true` for a force-on, or `null` when the user has expressed no
@@ -163,6 +171,10 @@ export declare function hyperlinksUserOverride(env?: NodeJS.ProcessEnv): boolean
  *      terminal (`TERM=xterm-256color`, no `TERM_PROGRAM`), but it renders
  *      OSC 8 in its own grid and opens links itself on Ctrl+click, so the
  *      outer terminal's support does not matter.
+ *   2b. Zeta workbench pane with no nested screen/tmux: on, for the same
+ *      reason — the workbench's terminal simulator renders OSC 8 itself and
+ *      opens links on Ctrl+click (`ZETA_WORKBENCH=1` is injected into every
+ *      pane PTY; the outer terminal is invisible from inside).
  *   3. Static terminal capability — terminals whose {@link TerminalInfo} marks
  *      `hyperlinks: false` (e.g. `base`) stay off unless the user forced on.
  *   4. GNU screen's explicit session marker (`STY`) always off, even if tmux is

package/package.json

@@ -1,7 +1,7 @@
 {
 	"type": "module",
 	"name": "@linxiraos/pi-tui",
-	"version": "1.1.24",
+	"version": "1.1.25",
 	"description": "Terminal User Interface library with differential rendering for efficient text-based applications",
 	"homepage": "https://linxira-os.github.io/zeta/",
 	"author": "Linxira-OS",
@@ -38,14 +38,14 @@
 		"gen:glyphs": "bun scripts/gen-glyphs.ts"
 	},
 	"dependencies": {
-		"@linxiraos/pi-omptype": "1.1.24",
-		"@linxiraos/pi-agent-core": "1.1.24",
-		"@linxiraos/pi-ai": "1.1.24",
-		"@linxiraos/pi-catalog": "1.1.24",
-		"@linxiraos/pi-natives": "1.1.24",
-		"@linxiraos/pi-utils": "1.1.24",
-		"@linxiraos/pi-wire": "1.1.24",
-		"@linxiraos/pi-snapcompact": "1.1.24"
+		"@linxiraos/pi-omptype": "1.1.25",
+		"@linxiraos/pi-agent-core": "1.1.25",
+		"@linxiraos/pi-ai": "1.1.25",
+		"@linxiraos/pi-catalog": "1.1.25",
+		"@linxiraos/pi-natives": "1.1.25",
+		"@linxiraos/pi-utils": "1.1.25",
+		"@linxiraos/pi-wire": "1.1.25",
+		"@linxiraos/pi-snapcompact": "1.1.25"
 	},
 	"devDependencies": {
 		"kitty-vt-wasm": "^0.2.0"

package/src/terminal-capabilities.d.ts

@@ -146,6 +146,14 @@ export declare function detectRectangularSgrSupport(terminalId: TerminalId, env?
  * bytes survive — the same reason DECCARA and synchronized output gate on it.
  */
 export declare function detectStyledUnderlineSupport(terminalId: TerminalId, env?: NodeJS.ProcessEnv): boolean;
+/**
+ * True when this process runs inside a Zeta workbench pane. The workbench
+ * injects `ZETA_WORKBENCH=1` into every pane PTY (`termide` set_env); its
+ * terminal simulator renders OSC 8 in its own grid and opens links itself on
+ * Ctrl+click, so — like Herdr — the outer terminal's advertised support does
+ * not matter. Pane-only detection, mirroring `isInsideHerdr`.
+ */
+export declare function isInsideZetaWorkbench(env?: NodeJS.ProcessEnv): boolean;
 /**
  * Resolve an explicit user override for OSC 8 hyperlinks. Returns `false` for
  * an opt-out, `true` for a force-on, or `null` when the user has expressed no
@@ -163,6 +171,10 @@ export declare function hyperlinksUserOverride(env?: NodeJS.ProcessEnv): boolean
  *      terminal (`TERM=xterm-256color`, no `TERM_PROGRAM`), but it renders
  *      OSC 8 in its own grid and opens links itself on Ctrl+click, so the
  *      outer terminal's support does not matter.
+ *   2b. Zeta workbench pane with no nested screen/tmux: on, for the same
+ *      reason — the workbench's terminal simulator renders OSC 8 itself and
+ *      opens links on Ctrl+click (`ZETA_WORKBENCH=1` is injected into every
+ *      pane PTY; the outer terminal is invisible from inside).
  *   3. Static terminal capability — terminals whose {@link TerminalInfo} marks
  *      `hyperlinks: false` (e.g. `base`) stay off unless the user forced on.
  *   4. GNU screen's explicit session marker (`STY`) always off, even if tmux is

package/src/terminal-capabilities.ts

@@ -494,6 +494,17 @@ export function detectStyledUnderlineSupport(terminalId: TerminalId, env: NodeJS
 			return false;
 	}
 }
+/**
+ * True when this process runs inside a Zeta workbench pane. The workbench
+ * injects `ZETA_WORKBENCH=1` into every pane PTY (`termide` set_env); its
+ * terminal simulator renders OSC 8 in its own grid and opens links itself on
+ * Ctrl+click, so — like Herdr — the outer terminal's advertised support does
+ * not matter. Pane-only detection, mirroring `isInsideHerdr`.
+ */
+export function isInsideZetaWorkbench(env: NodeJS.ProcessEnv = Bun.env): boolean {
+	return env.ZETA_WORKBENCH === "1";
+}
+
 /**
  * Resolve an explicit user override for OSC 8 hyperlinks. Returns `false` for
  * an opt-out, `true` for a force-on, or `null` when the user has expressed no
@@ -527,6 +538,10 @@ function parseTmuxVersionFromEnv(env: NodeJS.ProcessEnv): { major: number; minor
  *      terminal (`TERM=xterm-256color`, no `TERM_PROGRAM`), but it renders
  *      OSC 8 in its own grid and opens links itself on Ctrl+click, so the
  *      outer terminal's support does not matter.
+ *   2b. Zeta workbench pane with no nested screen/tmux: on, for the same
+ *      reason — the workbench's terminal simulator renders OSC 8 itself and
+ *      opens links on Ctrl+click (`ZETA_WORKBENCH=1` is injected into every
+ *      pane PTY; the outer terminal is invisible from inside).
  *   3. Static terminal capability — terminals whose {@link TerminalInfo} marks
  *      `hyperlinks: false` (e.g. `base`) stay off unless the user forced on.
  *   4. GNU screen's explicit session marker (`STY`) always off, even if tmux is
@@ -554,6 +569,8 @@ export function shouldEnableHyperlinksByDefault(
 
 	if (isInsideHerdr(env) && !env.STY && !env.TMUX) return true;
 
+	if (isInsideZetaWorkbench(env) && !env.STY && !env.TMUX) return true;
+
 	if (!getTerminalInfo(terminalId).hyperlinks) return false;
 
 	// STY is GNU screen's explicit session marker. It vetoes tmux enabling when