@oh-my-pi/pi-tui 18.2.10 → 18.3.0

package/dist/types/tools/wait.d.ts

@@ -0,0 +1,131 @@
+import type { Component } from "../tui.js";
+import type { Theme } from "../theme/theme.js";
+import { type OutputMeta } from "./output-meta.js";
+import { type ConfiguredThinkingLevel } from "../render/render-utils.js";
+import type { StructuredSubagentOutput } from "./task.js";
+import type { RenderResultOptions, ToolActivitySummary } from "./renderer.js";
+import type { IrcDeliveryReceipt, IrcMessage } from "./irc.js";
+/** Whether a wait snapshot contains only running jobs and no cancellations. */
+export declare function isWaitingPollDetails(details: unknown): boolean;
+/** Coordination details retained by wait and background job operations. */
+export type CoordinationOp = "send" | "wait" | "jobs" | "cancel";
+/** Background-job row surfaced by `wait`/`cancel`/`jobs` results. */
+export interface JobSnapshot {
+    id: string;
+    type: "bash" | "task" | "eval";
+    status: "running" | "completed" | "failed" | "cancelled";
+    label: string;
+    durationMs: number;
+    /** Process exit status when the job reports one. */
+    exitCode?: number;
+    /** Effective task model selector, including an explicit reasoning suffix when configured. */
+    resolvedModel?: string;
+    /** Provider/id including routing, with no added thinking suffix. */
+    resolvedModelIdentity?: string;
+    /** Explicit thinking metadata, independent of the model identity. */
+    resolvedThinkingLevel?: ConfiguredThinkingLevel;
+    /** True when the task progress reports an attached live advisor. */
+    advisor?: boolean;
+    resultText?: string;
+    errorText?: string;
+    /** Source-output metadata retained for per-job warnings and persisted row rendering. */
+    meta?: OutputMeta;
+    /** Capture error in historical snapshots; new snapshots store source metadata in `meta`. */
+    artifactError?: OutputMeta["artifactError"];
+    structured?: StructuredSubagentOutput;
+    /**
+     * `agent://<id>` handle backing this job's artifacts — the job-row's
+     * registry `agentId` when the manager disambiguated a requested job id
+     * on collision, else the job id itself. See {@link AsyncJob.agentId}.
+     */
+    agentUrlId?: string;
+}
+/** Outcome of cancelling one background job. */
+export type CancelStatus = "cancelled" | "not_found" | "already_completed";
+/** Cancellation outcome and its model-facing explanation. */
+export interface CancelOutcome {
+    id: string;
+    status: CancelStatus;
+    message: string;
+}
+/**
+ * A live subagent from the AgentRegistry that has no backing job in the
+ * AsyncJobManager — e.g. an idle agent woken (or a parked agent revived) via
+ * a peer message, or a spawn owned by another agent. Surfaced by background
+ * snapshots so the displayed picture matches the UI's running-agent
+ * count.
+ */
+export interface AgentActivitySnapshot {
+    id: string;
+    parentId?: string;
+    /** Latest activity gist recorded by the registry (display-only). */
+    activity?: string;
+    /** Time since the agent was registered. */
+    ageMs: number;
+    /**
+     * Whether an attached session corroborates the `running` claim. False marks
+     * a ref that says `running` with no turn in flight — either a spawn still
+     * wiring up or a stale registration that an explicit cancellation clears (#8634).
+     */
+    live: boolean;
+    /**
+     * Acceptance time of the agent's final result, when the registry recorded
+     * one. With `live: false` this is an accepted run the parent may cancel
+     * instead of waiting on (#11079).
+     */
+    acceptedAt?: number;
+}
+/** Details shared by messaging receipts and job/wait results. */
+export interface CoordinationDetails {
+    meta?: OutputMeta;
+    op: CoordinationOp;
+    from?: string;
+    to?: string;
+    receipts?: IrcDeliveryReceipt[];
+    /** Message consumed by `wait`. */
+    waited?: IrcMessage | null;
+    jobs?: JobSnapshot[];
+    cancelled?: {
+        id: string;
+        status: CancelStatus;
+    }[];
+    /** Running subagents not represented by a job row in this result. */
+    agents?: AgentActivitySnapshot[];
+    /** `wait` was cut short by steering, a peer message, or a completion notice that injects next. */
+    interrupted?: boolean;
+}
+/** Pending wait frame. */
+declare function waitRenderCall(_args: object, _options: RenderResultOptions, uiTheme: Theme): Component;
+/**
+ * Display-only transcript card for live IRC traffic: `irc:incoming` DMs
+ * delivered to this session, `irc:autoreply` side-channel replies sent on
+ * this session's behalf, and `irc:relay` observations of agent↔agent
+ * traffic. Shares the tool renderer's glyph + quote-border conventions so
+ * cards and peer-message output look identical in the transcript.
+ */
+export declare function createIrcMessageCard(card: {
+    kind: "incoming" | "autoreply" | "relay" | "workpool";
+    from?: string;
+    to?: string;
+    body?: string;
+    replyTo?: string;
+    timestamp?: number;
+    pool?: string;
+    mode?: string;
+}, getExpanded: () => boolean, uiTheme: Theme): Component;
+/** Render either a received message or a background-job snapshot. */
+export declare const waitToolRenderer: {
+    inline: true;
+    mergeCallAndResult: true;
+    activitySummary(): ToolActivitySummary;
+    renderCall: typeof waitRenderCall;
+    renderResult(result: {
+        content: Array<{
+            type: string;
+            text?: string;
+        }>;
+        details?: CoordinationDetails;
+        isError?: boolean;
+    }, options: RenderResultOptions, uiTheme: Theme): Component;
+};
+export {};

package/dist/types/tools/write.d.ts

@@ -1,6 +1,8 @@
 import type { HighlightStream } from "@oh-my-pi/pi-natives";
 import type { Component } from "../tui.js";
 import { type Theme } from "../theme/theme.js";
+import type { CoordinationDetails } from "./wait.js";
+import { type ProcWriteDetails } from "./proc-render.js";
 import type { FileDiagnosticsResult } from "./lsp.js";
 import type { OutputMeta } from "./output-meta.js";
 import type { RenderResultOptions, ToolActivityContext, ToolActivitySummary } from "./renderer.js";
@@ -16,6 +18,8 @@ export interface WriteToolDetails {
     resolvedPath?: string;
     /** Set when the write dispatched an `xd://` tool device; drives renderer delegation. */
     xdev?: XdevRenderDispatch;
+    message?: CoordinationDetails;
+    proc?: ProcWriteDetails;
 }
 interface WriteRenderArgs {
     path?: unknown;

package/dist/types/tools/xd-url.d.ts

@@ -9,5 +9,13 @@ export declare function stripXdUrlPrefix(name: string): string;
 export declare function parseXdUrl(input: string): {
     name: string | null;
 } | null;
+/**
+ * Parse a read-only `xd://<tool>/<topic>` documentation URL.
+ * Returns `null` for anything else, including bare device URLs.
+ */
+export declare function parseXdTopicUrl(input: string): {
+    name: string;
+    topic: string;
+} | null;
 /** Whether a streaming path prefix could still become an `xd://` URL. */
 export declare function couldBecomeXdUrl(partialPath: string): boolean;

package/dist/types/windows-altgr.d.ts

@@ -0,0 +1,54 @@
+/**
+ * Recover AltGr text that Windows console hosts drop under the kitty keyboard protocol.
+ *
+ * The kitty encoder shipped in Windows Terminal / OpenConsole before
+ * microsoft/terminal#20052 reports AltGr+key as Alt (or Ctrl+Alt) plus the
+ * layout's *unmodified* base key, without the produced text: Hungarian
+ * AltGr+F arrives as `CSI 102;3u` instead of `[`. The byte stream is then
+ * indistinguishable from a real Alt+F shortcut, so the character is lost and
+ * the chord fires `alt+f` bindings instead.
+ *
+ * Recovery reads two pieces of local state the bytes lack:
+ *  - whether Right Alt (AltGr) is physically held, via `GetAsyncKeyState`;
+ *  - what the active keyboard layout's AltGr layer produces for the base key,
+ *    via `ToUnicodeEx`.
+ *
+ * Layouts without an AltGr layer (US, UK, ...) resolve to an empty table once and
+ * short-circuit every later event. The per-layout table is built once and cached;
+ * it is rebuilt only when the foreground window reports a different layout handle.
+ *
+ * Known limitation: AltGr keys that produce a dead key on the active layout have no
+ * table entry (`ToUnicodeEx` reports them as pending composition, not text), so those
+ * chords keep reaching Alt bindings.
+ */
+import { type Pointer } from "bun:ffi";
+/** Keyboard layout handle (`HKL`) as `bun:ffi` surfaces pointer-sized values. */
+export type KeyboardLayoutHandle = Pointer | bigint;
+/**
+ * AltGr layer of an explicit layout handle (`HKL`), keyed `"<baseCodepoint>:<shift 0|1>"`.
+ * Test seam: lets a harness inspect a loaded layout without making it the active one.
+ */
+export declare function readAltGrLayer(hkl: KeyboardLayoutHandle): ReadonlyMap<string, string>;
+/** Local keyboard state the translator reads; injectable so tests need no live desktop. */
+export interface AltGrHost {
+    /** AltGr layer of the layout that produced the keystroke, keyed like {@link readAltGrLayer}. */
+    activeLayer(): ReadonlyMap<string, string>;
+    /** Whether Right Alt (AltGr) is held, or was within the last {@link RIGHT_ALT_LATCH_MS}. */
+    isRightAltDown(): boolean;
+}
+/**
+ * How long an observed Right Alt press keeps counting as held. Key state is sampled
+ * at processing time, and one stdin read can carry several queued AltGr repeats that
+ * are dispatched synchronously after the key is released; the latch keeps that tail
+ * typing text. Far shorter than any release-then-Left-Alt chord a person can press.
+ */
+export declare const RIGHT_ALT_LATCH_MS = 30;
+/** Wrap a raw Right Alt probe so a press stays observed for {@link RIGHT_ALT_LATCH_MS}. */
+export declare function createRightAltLatch(isDownNow: () => boolean, now: () => number): () => boolean;
+/**
+ * Translate a kitty CSI-u Alt/Ctrl+Alt chord into the text AltGr produced, or
+ * `undefined` when the sequence is not an AltGr keystroke on the active layout.
+ *
+ * Only call this on native Windows ConPTY hosts with the kitty protocol active.
+ */
+export declare function translateWindowsAltGrSequence(data: string, host?: AltGrHost): string | undefined;

package/package.json

@@ -1,10 +1,13 @@
 {
 	"type": "module",
 	"name": "@oh-my-pi/pi-tui",
-	"version": "18.2.10",
+	"version": "18.3.0",
 	"description": "Terminal User Interface library with differential rendering for efficient text-based applications",
 	"homepage": "https://omp.sh",
-	"author": "Stencil Labs, Inc.",
+	"author": {
+		"name": "Stencil Labs, Inc.",
+		"url": "https://stencil.so"
+	},
 	"contributors": [
 		"Mario Zechner"
 	],
@@ -37,14 +40,14 @@
 		"fmt": "oxfmt --no-error-on-unmatched-pattern 'src/**/*.{ts,tsx}' '{test,bench,examples,scripts}/**/*.ts' '*.ts'"
 	},
 	"dependencies": {
-		"@oh-my-pi/omptype": "18.2.10",
-		"@oh-my-pi/pi-agent-core": "18.2.10",
-		"@oh-my-pi/pi-ai": "18.2.10",
-		"@oh-my-pi/pi-catalog": "18.2.10",
-		"@oh-my-pi/pi-natives": "18.2.10",
-		"@oh-my-pi/pi-utils": "18.2.10",
-		"@oh-my-pi/pi-wire": "18.2.10",
-		"@oh-my-pi/snapcompact": "18.2.10"
+		"@oh-my-pi/omptype": "18.3.0",
+		"@oh-my-pi/pi-agent-core": "18.3.0",
+		"@oh-my-pi/pi-ai": "18.3.0",
+		"@oh-my-pi/pi-catalog": "18.3.0",
+		"@oh-my-pi/pi-natives": "18.3.0",
+		"@oh-my-pi/pi-utils": "18.3.0",
+		"@oh-my-pi/pi-wire": "18.3.0",
+		"@oh-my-pi/snapcompact": "18.3.0"
 	},
 	"devDependencies": {
 		"kitty-vt-wasm": "^0.2.0"

package/src/apps/debug/protocol-probe.ts

@@ -217,7 +217,7 @@ export class ProtocolProbeComponent extends Container {
 			new Text(
 				[
 					`${theme.fg("muted", "Hyperlinks (OSC 8)")} — ${yesNo(hyperlinksOn)}`,
-					`  \x1b]8;;https://github.com/can1357/oh-my-pi\x07oh-my-pi repo\x1b]8;;\x07`,
+					`  \x1b]8;;https://github.com/can1357/oh-my-pi\x07omp repo\x1b]8;;\x07`,
 				].join("\n"),
 				1,
 				0,

package/src/apps/ps-data.ts

@@ -1,7 +1,7 @@
 import * as path from "node:path";
 import { formatDuration } from "@oh-my-pi/pi-utils";
 import chalk from "@oh-my-pi/pi-utils/chalk";
-import type { DaemonSnapshot, DaemonSpec, DaemonState } from "../tools/hub";
+import type { DaemonSnapshot, DaemonSpec, DaemonState } from "../tools/daemon";
 
 /** One broker scope: a project runtime dir or a machine-global service dir. */
 export interface PsScope {

package/src/apps/ps-top.ts

@@ -15,7 +15,7 @@ import { type Component, TUI } from "../tui";
 import { truncateToWidth } from "../utils";
 import { formatDuration } from "@oh-my-pi/pi-utils";
 import chalk from "@oh-my-pi/pi-utils/chalk";
-import type { DaemonSnapshot, DaemonSpec } from "../tools/hub";
+import type { DaemonSnapshot, DaemonSpec } from "../tools/daemon";
 import {
 	collapseCommand,
 	daemonLabel,

package/src/chat/chat-transcript-builder.ts

@@ -5,7 +5,7 @@
  * viewer ({@link AgentTranscriptViewer}) to render a parked subagent / advisor /
  * collab-guest transcript that has no live session.
  *
- * Unlike the old incremental hub sync, {@link ChatTranscriptBuilder.rebuild}
+ * Unlike incremental transcript sync, {@link ChatTranscriptBuilder.rebuild}
  * always discards prior components and rebuilds the whole transcript from the
  * supplied entries. Re-rendering a growing transcript is therefore O(n) in the
  * entry count, but it cannot duplicate or misorder rows the way incremental
@@ -184,12 +184,12 @@ export class ChatTranscriptBuilder {
 		this.#expandables.push(component);
 	}
 
-	/** A `hub` wait showing all-running is displaced by the next `hub` call. */
+	/** A `wait` showing all-running is displaced by the next `wait` call. */
 	#resolveWaitingPoll(nextToolName?: string): void {
 		const previous = this.#waitingPoll;
 		if (!previous) return;
 		this.#waitingPoll = null;
-		if (nextToolName === "hub" && previous.isDisplaceableBlock() && this.container.canRemoveBlock(previous)) {
+		if (nextToolName === "wait" && previous.isDisplaceableBlock() && this.container.canRemoveBlock(previous)) {
 			this.container.removeChild(previous);
 		}
 		previous.seal();
@@ -517,7 +517,7 @@ export class ChatTranscriptBuilder {
 		if (!pending) return;
 		pending.updateResult(message, false, message.toolCallId);
 		this.#pendingTools.delete(message.toolCallId);
-		if (message.toolName === "hub" && pending instanceof ToolExecutionComponent && pending.isDisplaceableBlock()) {
+		if (message.toolName === "wait" && pending instanceof ToolExecutionComponent && pending.isDisplaceableBlock()) {
 			this.#waitingPoll = pending;
 		} else if (
 			message.toolName === "todo" &&

package/src/chat/tool-execution.ts

@@ -22,7 +22,7 @@ import { type EditMode, type PerFileDiffPreview, renderStreamingFallback } from
 import { EVAL_DEFAULT_PREVIEW_LINES } from "../tools/eval";
 import { taskCardAgentIds } from "../tools/task";
 import { TODO_STRIKE_TOTAL_FRAMES, type TodoToolDetails } from "../tools/todo";
-import { isWaitingPollDetails } from "../tools/hub";
+import { isWaitingPollDetails } from "../tools/wait";
 import { formatStatusIcon, replaceTabs, resolveImageOptions } from "../render/render-utils";
 import type { XdevMountedState } from "../tools/xdev";
 import { isFramedBlockComponent, markFramedBlockComponent, renderStatusLine, WidthAwareText } from "../render/index";
@@ -35,7 +35,7 @@ import { type AnimationFrame, trimBlankEdges } from "../chrome/transcript-contai
 export function toolRenderName(wireName: string, tool: AgentTool | undefined): string {
 	return tool?.name ?? wireName;
 }
-type DisplaceableToolName = "hub" | "todo";
+type DisplaceableToolName = "wait" | "todo";
 
 function isTodoToolDetails(details: unknown): details is TodoToolDetails {
 	return (
@@ -67,7 +67,7 @@ function displaceableToolName(
 	isPartial: boolean,
 ): DisplaceableToolName | undefined {
 	if (result.isError === true) return undefined;
-	if (toolName === "hub" && isWaitingPollDetails(result.details)) return "hub";
+	if (toolName === "wait" && isWaitingPollDetails(result.details)) return "wait";
 	if (toolName === "todo" && !isPartial && isTodoToolDetails(result.details)) return "todo";
 	return undefined;
 }
@@ -311,7 +311,7 @@ export class ToolExecutionComponent extends Container {
 	// late result can update its streaming preview.
 	#sealed = false;
 	// Tool result snapshots that may be superseded by a later same-tool call
-	// while still in the mutable viewport. `hub` uses this for repeated all-running polls; `todo` uses
+	// while still in the mutable viewport. `wait` uses this for repeated all-running polls; `todo` uses
 	// it for per-turn state snapshots so only the latest list remains visible.
 	#displaceableByToolName: DisplaceableToolName | undefined;
 	// Execution start on the presentation clock (performance.now domain, the
@@ -605,7 +605,7 @@ export class ToolExecutionComponent extends Container {
 			this.#toolName !== "todo" &&
 			!isBackgroundAsyncRunning &&
 			(pendingCallConsumesSpinner || partialResultConsumesSpinner);
-		const needsSpinner = isStreamingArgs || isLivePartialTool || this.#displaceableByToolName === "hub";
+		const needsSpinner = isStreamingArgs || isLivePartialTool || this.#displaceableByToolName === "wait";
 		if (needsSpinner && !this.#spinnerActive) {
 			const frameCount = theme.spinnerFrames.length;
 			const frame = sharedSpinnerFrame(frameCount);
@@ -845,8 +845,8 @@ export class ToolExecutionComponent extends Container {
 		if (this.#allocation < 3) {
 			// A squeezed allocation degrades only blocks that genuinely overflow it.
 			// The allocator measures blocks by trimmed height and never squeezes one
-			// below that, so inline tools whose real content is 1-2 rows (hub
-			// receipts, one-line results) keep that content instead of an equally
+			// below that, so inline tools whose real content is 1-2 rows (wait
+			// results, one-line receipts) keep that content instead of an equally
 			// tall but contentless frame.
 			const trimmed = trimBlankEdges(lines);
 			if (trimmed.length > this.#allocation) return this.#renderCompact(width);
@@ -891,7 +891,7 @@ export class ToolExecutionComponent extends Container {
 		});
 		if (summary !== undefined) {
 			if (summary.detail) return summary;
-			// A detail-less custom summary (e.g. hub before its streamed args
+			// A detail-less custom summary (e.g. wait before its result
 			// parse) must not fold to a bare `╭─ Label` frame under viewport
 			// pressure — keep the generic liveness hint for in-flight calls.
 			return this.#isRunning() ? { ...summary, detail: "running" } : summary;

package/src/chat/transcript-render-helpers.ts

@@ -7,10 +7,10 @@
 import type { AgentMessage } from "@oh-my-pi/pi-agent-core";
 import { type Component } from "../tui";
 import { formatBytes, formatDuration } from "@oh-my-pi/pi-utils";
-import type { JobSnapshot } from "../tools/hub";
-import type { DaemonSnapshot } from "../tools/hub";
+import type { JobSnapshot } from "../tools/wait";
+import type { DaemonSnapshot } from "../tools/daemon";
 import { type CustomMessage, type FileMentionMessage, resolveAbortLabel, shouldRenderAbortReason } from "./messages";
-import { createIrcMessageCard } from "../tools/hub";
+import { createIrcMessageCard } from "../tools/wait";
 import { formatArtifactErrorNotice, type OutputMeta } from "../tools/output-meta";
 import { replaceTabs, TRUNCATE_LENGTHS, truncateToWidth } from "../render/render-utils";
 import { canonicalizeMessage } from "./thinking-display";

package/src/components/markdown.ts

@@ -2955,7 +2955,7 @@ export class Markdown implements Component {
 				// resolver. The art is preformatted, so clip each row to the content
 				// width: the later wrap pass would otherwise fragment the box-drawing
 				// canvas. truncateToWidth is ANSI- and wide-char-aware, and the
-				// resolver already re-fits over-wide horizontal graphs top-down.
+				// resolver picks the shortest orientation that fits this width.
 				if (token.lang === "mermaid" && this.#theme.resolveMermaidAscii) {
 					const ascii = this.#theme.resolveMermaidAscii(token.text, width);
 					if (ascii) {

package/src/desktop-notify.ts

@@ -26,7 +26,7 @@ import { $which } from "@oh-my-pi/pi-utils";
 import type { TerminalId, TerminalNotification } from "./terminal-capabilities";
 
 /** Application name surfaced as the notification source. */
-const APP_NAME = "Oh My Pi";
+const APP_NAME = "omp";
 
 /** Resolved notifier binary used to fan a notification out to D-Bus. */
 export type DesktopNotifierKind = "notify-send" | "gdbus";