@oh-my-pi/pi-tui 18.2.11 → 18.3.1

package/dist/types/tools/cfg-render.d.ts

@@ -0,0 +1,37 @@
+/**
+ * Transcript renderers for `cfg://` settings reads and writes.
+ *
+ * Reads show the YAML-ish settings listing the model received, highlighted as
+ * YAML. Writes show the `previous → value` change, its scope (session or
+ * saved), and whether the user approved it.
+ */
+import type { Component } from "../tui.js";
+import { type Theme } from "../theme/theme.js";
+import type { RenderResultOptions } from "./renderer.js";
+import { type CardToolResult } from "./result-card.js";
+/** Summary of a `cfg://` read, attached to read tool details. */
+export interface CfgReadDetails {
+    /** Dotted setting path or namespace that was read; empty for the whole tree. */
+    path: string;
+    /** Settings in the listing. */
+    count: number;
+    /** Listed settings whose effective value differs from the schema default. */
+    modified: number;
+}
+/** How a `cfg://` write ended. */
+export type CfgWriteOutcome = "applied" | "declined" | "unchanged";
+/** A `cfg://` write, attached to write tool details. Values are display-formatted (credentials redacted). */
+export interface CfgWriteDetails {
+    path: string;
+    /** Persisted to config.yml rather than scoped to the session. */
+    save: boolean;
+    previous: string;
+    value: string;
+    outcome: CfgWriteOutcome;
+    /** Effective value after saving when a higher-precedence layer still shadows the saved one. */
+    effective?: string;
+}
+/** Render `read cfg://…`: pending header, or the highlighted listing with counts. */
+export declare function renderCfgRead(url: string, result: CardToolResult | undefined, details: CfgReadDetails | undefined, options: RenderResultOptions, theme: Theme): Component;
+/** Render `write cfg://…[/save]`: the proposed value while pending, then the approved/declined change. */
+export declare function renderCfgWrite(url: string, content: string | undefined, result: CardToolResult | undefined, details: CfgWriteDetails | undefined, options: RenderResultOptions, theme: Theme): Component;

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

@@ -0,0 +1,16 @@
+/** Canonical prefix for settings URLs. */
+export declare const CFG_URL_PREFIX = "cfg://";
+/** Trailing write segment that persists a `cfg://` change instead of scoping it to the session. */
+export declare const CFG_SAVE_SEGMENT = "save";
+/** Setting addressed by a `cfg://` URL. */
+export interface CfgTarget {
+    /** Setting path segments; empty for the root. `/` and `.` both separate segments. */
+    segments: string[];
+    /** Whether the URL ends in the `/save` suffix, which is removed from {@link segments}. */
+    save: boolean;
+}
+/**
+ * Parse a `cfg://` URL (`cfg://advisor/enabled`, `cfg://advisor.enabled/save`).
+ * Returns `null` for other schemes; query and fragment are ignored.
+ */
+export declare function parseCfgUrl(input: string): CfgTarget | null;

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

@@ -0,0 +1,46 @@
+/** Launch-broker daemon types shared by services, `proc://`, and `omp ps`. */
+/** Stable lifecycle states exposed by the launch broker. */
+export type DaemonState = "starting" | "running" | "ready" | "restarting" | "stopping" | "exited" | "failed";
+/** Restart behavior applied after an unexpected daemon exit. */
+export type DaemonRestartPolicy = "no" | "on-failure" | "always";
+/** Readiness conditions; every configured condition must pass. */
+export interface DaemonReadySpec {
+    log?: string;
+    port?: number;
+    host?: string;
+    timeoutMs: number;
+}
+/** Immutable launch specification retained for restart and inspection. */
+export interface DaemonSpec {
+    name: string;
+    application: string;
+    args: string[];
+    env: Record<string, string>;
+    cwd: string;
+    pty: boolean;
+    ready?: DaemonReadySpec;
+    restart: DaemonRestartPolicy;
+    persist: boolean;
+    detached: boolean;
+}
+/** Serializable daemon state visible to every client in one broker scope. */
+export interface DaemonSnapshot {
+    name: string;
+    id: string;
+    state: DaemonState;
+    pid?: number;
+    createdAt: number;
+    startedAt: number;
+    readyAt?: number;
+    exitedAt?: number;
+    exitCode?: number;
+    exitReason?: string;
+    restartCount: number;
+    outputBytes: number;
+    owner?: string;
+    readyMatch?: string;
+    /** Readiness conditions still unmet while `state` is `starting`; absent once ready or without a ready spec. */
+    readyPending?: ("log" | "port")[];
+    persist: boolean;
+    detached: boolean;
+}

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

@@ -11,7 +11,7 @@ export interface FindRange {
 }
 /** A file whose verified passages cleared the threshold; `ranges` are merged positive spans, strongest first. */
 export interface FindHit {
-    /** Display path relative to {@link FindToolDetails.cwd}, or an `omp://` doc URL for docs scopes. */
+    /** Display path relative to {@link FindToolDetails.cwd}, or an internal URL under URL scopes. */
     rel: string;
     /** Filename judgment, when the name batch answered. */
     nameScore?: number;
@@ -55,7 +55,7 @@ export interface FindToolDetails {
     elapsedMs: number;
     /** Session cwd; hit paths are relative to it. */
     cwd: string;
-    /** Display form of the searched directory when narrower than cwd. */
+    /** Display form of the searched directory or file when narrower than cwd. */
     scopePath?: string;
     meta?: OutputMeta;
 }

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

@@ -0,0 +1,30 @@
+/** Peer-message types and roster constants shared by messaging, `wait`, and child prompts. */
+/** Maximum live peer rows embedded in child prompts. */
+export declare const DEFAULT_PEER_ROSTER_LIMIT = 32;
+/** Serializable peer message retained in coordination result snapshots. */
+export interface IrcMessage {
+    id: string;
+    /** Sender agent id. */
+    from: string;
+    /** Recipient agent id (resolved; "all" is expanded by the tool, not stored). */
+    to: string;
+    body: string;
+    ts: number;
+    /** Message id being answered. */
+    replyTo?: string;
+    /**
+     * Automated wake-turn relay of a woken subagent's stop output (task executor
+     * `relayWakeTurnOutput`). Relays are answers, never wake sources: the
+     * recipient's own wake-turn relay must skip them or two idle peers
+     * ping-pong forever.
+     */
+    wakeRelay?: boolean;
+}
+/** Delivery outcome for one peer recipient. */
+export interface IrcDeliveryReceipt {
+    to: string;
+    outcome: "injected" | "woken" | "revived" | "failed";
+    error?: string;
+}
+/** Status ordering for peer rosters in child prompts. */
+export declare const LIST_STATUS_ORDER: Record<string, number>;

package/dist/types/tools/line-ranges.d.ts

@@ -11,7 +11,7 @@ export declare const LINE_RANGE_CHUNK_SOURCE: string;
 /** Parse a single `N`, `N-M`, `N-`, `N+K`, or `..`-aliased (`N..M`, `N..`) chunk. Throws via {@link ToolError} on invalid bounds. */
 export declare function parseLineRangeChunk(sel: string): LineRange | null;
 /**
- * Parse a comma-separated list of line ranges (e.g. `5-16,960-973`). Returns
+ * Parse a comma-separated list of line ranges (e.g. `5-16,960-973` or `19,59`). Returns
  * the ranges in ascending order with overlapping/adjacent ranges merged so
  * downstream consumers can stream the file in a single forward pass per range.
  */

package/dist/types/tools/output-meta.d.ts

@@ -96,6 +96,8 @@ export interface OutputMeta {
     /** Capture failure of this output itself; aggregate reports keep source failures on their entries. */
     artifactError?: OutputArtifactError;
     source?: SourceMeta;
+    /** The output is a bounded page of session artifact storage its `source` re-reads with line selectors; spill-to-artifact skips it. */
+    pagedSource?: true;
     diagnostics?: DiagnosticMeta;
     limits?: LimitsMeta;
 }

package/dist/types/tools/proc-render.d.ts

@@ -0,0 +1,27 @@
+import type { Component } from "../tui.js";
+import type { Theme } from "../theme/theme.js";
+import type { RenderResultOptions } from "./renderer.js";
+import type { AgentActivitySnapshot, CoordinationDetails, JobSnapshot } from "./wait.js";
+import type { DaemonSnapshot } from "./daemon.js";
+import { type CardToolResult as ToolResult } from "./result-card.js";
+export interface ProcReadDetails {
+    jobs?: JobSnapshot[];
+    agents?: AgentActivitySnapshot[];
+    daemons?: DaemonSnapshot[];
+    job?: JobSnapshot;
+    daemon?: DaemonSnapshot;
+    log?: string;
+    terminalRows?: string[];
+}
+export type ProcWriteDetails = CoordinationDetails | {
+    action: "stop" | "stdin" | "mode";
+    daemon: DaemonSnapshot;
+    input?: string;
+    mode?: string;
+};
+/** Process operation selected by a write URL, independent of its content. */
+export type ProcWriteAction = "stdin" | "mode" | "kill";
+export declare function renderAgentWrite(to: string, body: string, result: ToolResult | undefined, details: CoordinationDetails | undefined, options: RenderResultOptions, theme: Theme): Component;
+/** Render live and completed process writes with the URL-selected operation. */
+export declare function renderProcWrite(id: string, action: ProcWriteAction, content: string | undefined, result: ToolResult | undefined, details: ProcWriteDetails | undefined, options: RenderResultOptions, theme: Theme): Component;
+export declare function renderProcRead(id: string, result: ToolResult | undefined, details: ProcReadDetails | undefined, options: RenderResultOptions, theme: Theme): Component;

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

@@ -1,14 +1,19 @@
 import type { SummaryResult } from "@oh-my-pi/pi-natives";
 import type { Component } from "../tui.js";
-import type { RenderResultOptions } from "./renderer.js";
+import type { RenderResultOptions, ToolActivityContext, ToolActivitySummary } from "./renderer.js";
 import type { Theme } from "../theme/theme.js";
 import type { OutputMeta } from "./output-meta.js";
 import type { TruncationResult } from "./streaming-output.js";
+import { type ProcReadDetails } from "./proc-render.js";
+import { type CfgReadDetails } from "./cfg-render.js";
+import { type InternalUrlSchemeSpec } from "./url-scheme-host.js";
 /** Read result metadata retains truncation statistics, not a second copy of the body. */
 export type ReadTruncationStats = Omit<TruncationResult, "content">;
 /** Display metadata for file and URL reads. */
 export interface ReadToolDetails {
     kind?: "file" | "url";
+    proc?: ProcReadDetails;
+    cfg?: CfgReadDetails;
     /** Filesystem hyperlink target resolved by the executing tool. */
     displayTarget?: string;
     truncation?: ReadTruncationStats;
@@ -69,12 +74,16 @@ export declare function splitPathAndSel(rawPath: string): {
  * This function iteratively peels selector-shaped chunks (well-formed plus
  * common malformed shapes like `:-N-M`) so the rest of the read tool can pass a
  * clean URL to the protocol handler and surface selector errors via parseSel
- * instead of as misleading "host invalid" errors from the handler. Schemes
- * whose resource URIs may legitimately contain colons (`mcp://`) are skipped.
+ * instead of as misleading "host invalid" errors from the handler.
+ *
+ * Only schemes whose spec declares `lines` selectors peel; server-defined URIs
+ * (`opaque`), selector-free schemes, and unregistered schemes pass through
+ * verbatim. `specOf` defaults to the installed scheme host, so nothing peels
+ * before a host is installed.
  *
  * Falls back to the input unchanged when nothing matches.
  */
-export declare function splitInternalUrlSel(rawPath: string): {
+export declare function splitInternalUrlSel(rawPath: string, specOf?: (scheme: string) => InternalUrlSchemeSpec | undefined): {
     path: string;
     sel?: string;
 };
@@ -89,6 +98,10 @@ export interface ReadRenderArgs {
     limit?: number;
     raw?: boolean;
 }
+/** Local file a pending read/write input points at, before the tool resolves it:
+ * expands `~` and drops archive-member / SQLite-row selectors so the link opens
+ * the containing file. */
+export declare function pendingFileLinkPath(inputPath: string): string;
 /** Absolute fs path the read result actually resolved to, used as the OSC 8 link
  * target when the structured `resolvedPath` isn't set (the common plain-file and
  * image reads only record the path in `meta.source`). URL/internal sources are
@@ -96,6 +109,7 @@ export interface ReadRenderArgs {
 export declare function readSourceFsPath(details: ReadToolDetails | undefined): string | undefined;
 /** Render file, image, and URL reads in the transcript. */
 export declare const readToolRenderer: {
+    activitySummary(args: unknown, _context: ToolActivityContext): ToolActivitySummary;
     renderCall(args: ReadRenderArgs, _options: RenderResultOptions, uiTheme: Theme): Component;
     renderResult(result: {
         content: Array<{

package/dist/types/tools/result-card.d.ts

@@ -0,0 +1,20 @@
+/**
+ * Line-based status cards shared by the internal-URL renderers (`proc://`,
+ * `agent://`, `cfg://`): a header plus sanitized, width-truncated body lines.
+ */
+import type { Component } from "../tui.js";
+import type { RenderResultOptions } from "./renderer.js";
+/** Tool result fields the card renderers read. */
+export interface CardToolResult {
+    content: Array<{
+        type: string;
+        text?: string;
+    }>;
+    isError?: boolean;
+}
+/** First text block of a tool result, or `""`. */
+export declare function firstText(result: CardToolResult): string;
+/** Sanitize one display line: tabs become spaces, carriage returns are dropped. */
+export declare function safe(value: string): string;
+/** Padded card whose lines are sanitized and truncated, re-rendered when the expanded state flips. */
+export declare function card(lines: (width: number, expanded: boolean) => string[], options: RenderResultOptions): Component;

package/dist/types/tools/url-scheme-host.d.ts

@@ -0,0 +1,29 @@
+/**
+ * Scheme facts supplied by the internal URL host. pi-tui cannot import the
+ * coding-agent router, so the router installs this bridge when it loads;
+ * selector peeling and transcript renderers consult it instead of hardcoding
+ * scheme names.
+ */
+/** Renderer-relevant subset of a registered scheme's declared spec. */
+export interface InternalUrlSchemeSpec {
+    /** `lines`: a trailing `:<selector>` chain is a read selector; `none`/`opaque`: never peel. */
+    readonly selectors: "lines" | "none" | "opaque";
+    /** A trailing `:N` with no path after the authority is a port, not a selector (ssh://host:2222). */
+    readonly portAuthority?: boolean;
+    /** Read cards collapse into the compact read group like plain files instead of expanding. */
+    readonly compactTranscript?: boolean;
+}
+/** Scheme registry capabilities installed by the internal URL host. */
+export interface InternalUrlSchemeHost {
+    /** Declared spec of a registered scheme (case-insensitive); undefined when unregistered. */
+    spec(scheme: string): InternalUrlSchemeSpec | undefined;
+}
+/** Install the scheme registry. Until one is installed, no URL counts as an internal scheme. */
+export declare function setInternalUrlSchemeHost(host: InternalUrlSchemeHost): void;
+/** Declared spec of `scheme`; undefined when it is unregistered or no host is installed. */
+export declare function internalUrlSchemeSpec(scheme: string): InternalUrlSchemeSpec | undefined;
+/** Split a hierarchical `scheme://rest` URL into its lowercased scheme and the text after `://`. */
+export declare function splitUrlScheme(input: string): {
+    scheme: string;
+    rest: string;
+} | undefined;

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,9 @@
 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 CfgWriteDetails } from "./cfg-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 +19,9 @@ export interface WriteToolDetails {
     resolvedPath?: string;
     /** Set when the write dispatched an `xd://` tool device; drives renderer delegation. */
     xdev?: XdevRenderDispatch;
+    message?: CoordinationDetails;
+    proc?: ProcWriteDetails;
+    cfg?: CfgWriteDetails;
 }
 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/tools/xdev.d.ts

@@ -9,10 +9,18 @@ export interface XdevMountedRenderer {
     renderResult?(...args: Parameters<ToolRenderer["renderResult"]>): unknown;
     mergeCallAndResult?: boolean;
 }
-/** Mounted tool presentation state supplied by the host's canonical tool map. */
+/** Tool presentation state supplied by the host's canonical tool map. */
 export interface XdevMountedState {
     readonly mountedNames: ReadonlySet<string>;
     readonly tools: ReadonlyMap<string, XdevMountedRenderer>;
+    /**
+     * Canonical renderer for a device name, supplied by the host with the same
+     * predicate as dispatch (`resolveXdevTool`: mounted devices plus active
+     * top-level tools, which the `write` transport also accepts). The TUI keeps
+     * no predicate copy of its own — a second copy is what dropped a top-level
+     * dispatch to the generic card.
+     */
+    readonly resolve?: (name: string) => XdevMountedRenderer | undefined;
 }
 /** Result metadata consumed by delegated device rendering. */
 export interface XdevRenderDispatch {

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.11",
+	"version": "18.3.1",
 	"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.11",
-		"@oh-my-pi/pi-agent-core": "18.2.11",
-		"@oh-my-pi/pi-ai": "18.2.11",
-		"@oh-my-pi/pi-catalog": "18.2.11",
-		"@oh-my-pi/pi-natives": "18.2.11",
-		"@oh-my-pi/pi-utils": "18.2.11",
-		"@oh-my-pi/pi-wire": "18.2.11",
-		"@oh-my-pi/snapcompact": "18.2.11"
+		"@oh-my-pi/omptype": "18.3.1",
+		"@oh-my-pi/pi-agent-core": "18.3.1",
+		"@oh-my-pi/pi-ai": "18.3.1",
+		"@oh-my-pi/pi-catalog": "18.3.1",
+		"@oh-my-pi/pi-natives": "18.3.1",
+		"@oh-my-pi/pi-utils": "18.3.1",
+		"@oh-my-pi/pi-wire": "18.3.1",
+		"@oh-my-pi/snapcompact": "18.3.1"
 	},
 	"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,