@oh-my-pi/pi-tui 18.13.1 → 18.13.2

package/CHANGELOG.md

@@ -2,12 +2,31 @@
 
 ## [Unreleased]
 
+## [18.13.2] - 2026-10-27
+
+### Added
+
+- Added a frame-write listener (`TUI.addFrameWriteListener`) for terminal integrations that need to react to emitted ANSI output, including resize paints ([#17145](https://github.com/can1357/oh-my-pi/issues/17145))
+- `HookInputComponent` (`showHookInput`) now accepts `{ secret: true }` to mask typed characters as bullets (`•`) in input overlays ([#17080](https://github.com/can1357/oh-my-pi/pull/17080) by [@GTanger](https://github.com/GTanger))
+- Added an ANSI and native `/context` viewer with category navigation, content inspection, token-usage and compaction estimates, and keyboard/mouse controls that adapt across Tern and other terminals ([#16160](https://github.com/can1357/oh-my-pi/pull/16160) by [@C-W-Z](https://github.com/C-W-Z)).
+
+### Fixed
+
+- Fixed `AskDialogComponent`'s draft input guard holding the keyboard until the draft was cleared; Up/Down (or a pointer action) now release it so the question can be answered with the draft parked, and `syncPresentation` receives the effective blocked state ([#17215](https://github.com/can1357/oh-my-pi/pull/17215) by [@H4vC](https://github.com/H4vC))
+- Fixed the prompt editor's autocomplete popup (e.g. emoji suggestions after `:D`) staying open and following the cursor after Shift/Ctrl/Alt+Enter inserted a newline, so the next Enter submitted past a stale list; newlines and cursor motion (arrows, Home/End, word jumps, character jumps) now close it ([#17215](https://github.com/can1357/oh-my-pi/pull/17215) by [@H4vC](https://github.com/H4vC))
+- Fixed `run_watch` failed-job rows hiding why a job's logs are unavailable; multiline `gh` errors now stay on one row ([#17173](https://github.com/can1357/oh-my-pi/pull/17173) by [@alphastorm](https://github.com/alphastorm))
+
+### Removed
+
+- Removed the static context usage report (`ContextUsageView`, `renderContextUsage`, `describeContextUsage`), `contextUsageHead()`, and the `glyph` and `color` fields of `ContextBreakdown` categories; use `ContextViewer` ([#16160](https://github.com/can1357/oh-my-pi/pull/16160) by [@C-W-Z](https://github.com/C-W-Z)).
+- Fixed Markdown tables inside list items disappearing from the terminal transcript ([#17165](https://github.com/can1357/oh-my-pi/issues/17165)).
+
 ## [18.13.1] - 2026-10-27
 
 ### Added
 
 - ANSI and TSP `/pause` screens show unsettled turns and jobs, hide settled counters, and preserve counts and resume controls on short terminals ([#17073](https://github.com/can1357/oh-my-pi/pull/17073) by [@anatoli-tsinovoy](https://github.com/anatoli-tsinovoy)).
-- Added `noteOption` to `ExtensionAskDialogResultItem` and `QuestionResult`: the label of the option an ask note is on (unset for a note on the custom answer) ([#17126](https://github.com/can1357/oh-my-pi/pull/17126) by [@H4vC](https://github.com/H4vC))
+- Added `noteOption` to `ExtensionAskDialogResultItem`, `QuestionResult`, and single-question `AskToolDetails`: the label of the option an ask note is on (unset for a note on the custom answer) ([#17126](https://github.com/can1357/oh-my-pi/pull/17126) by [@H4vC](https://github.com/H4vC))
 
 ### Changed
 

package/dist/types/chrome/context-map.d.ts

@@ -0,0 +1,15 @@
+/** Pure occupancy calculations for contiguous token segments, independent of themes and renderers. */
+export interface ContextMapSegment<T> {
+    readonly id: T;
+    readonly tokens: number;
+}
+export interface ContextMapCell<T> {
+    readonly id: T;
+    readonly full: boolean;
+}
+/**
+ * Lays `segments` out in order over a `columns` × `rows` grid representing `windowTokens`; each cell takes the
+ * segment covering most of it and is `full` at 70% coverage or more. Returns `[]` when the window or grid
+ * size is unusable, and omits cells no segment touches.
+ */
+export declare function planContextMap<T>(segments: readonly ContextMapSegment<T>[], windowTokens: number, columns: number, rows: number): ContextMapCell<T>[];

package/dist/types/chrome/context-presentation.d.ts

@@ -0,0 +1,48 @@
+import type { ContextCategoryId } from "./context-view-model.js";
+export declare const CONTEXT_PRESENTATION: {
+    readonly "system-prompt": {
+        readonly color: "accent";
+        readonly symbol: "context.content";
+    };
+    readonly skills: {
+        readonly color: "success";
+        readonly symbol: "context.content";
+    };
+    readonly "built-in-tools": {
+        readonly color: "warning";
+        readonly symbol: "context.content";
+    };
+    readonly "custom-tools": {
+        readonly color: "customMessageLabel";
+        readonly symbol: "context.content";
+    };
+    readonly "user-messages": {
+        readonly color: "accent";
+        readonly symbol: "context.messages";
+    };
+    readonly "assistant-messages": {
+        readonly color: "userMessageText";
+        readonly symbol: "context.messages";
+    };
+    readonly "assistant-thinking": {
+        readonly color: "customMessageLabel";
+        readonly symbol: "context.content";
+    };
+    readonly "tool-calls": {
+        readonly color: "warning";
+        readonly symbol: "context.content";
+    };
+    readonly "tool-output": {
+        readonly color: "muted";
+        readonly symbol: "context.messages";
+    };
+    readonly buffer: {
+        readonly color: "warning";
+        readonly symbol: "context.buffer";
+    };
+    readonly free: {
+        readonly color: "dim";
+        readonly symbol: "context.free";
+    };
+};
+export type ContextPresentationId = ContextCategoryId | "buffer" | "free";

package/dist/types/chrome/context-view-model.d.ts

@@ -0,0 +1,77 @@
+/** Context snapshot shapes shared by the session snapshot builder and the context viewer. */
+import type { ContextBreakdown } from "../status-line/context-usage.js";
+interface ContextCategoryDescriptor {
+    readonly id: string;
+    readonly label: string;
+    /** Overview row label when the Overview weight differs from the category's content. */
+    readonly overviewLabel?: string;
+    /** Listed with its weight but never opened. */
+    readonly openable?: false;
+}
+/** Context categories in display order. */
+export declare const CONTEXT_CATEGORIES: readonly [{
+    readonly id: "system-prompt";
+    readonly label: "System Prompt";
+    readonly overviewLabel: "System Prompt (excluding Skills)";
+}, {
+    readonly id: "skills";
+    readonly label: "Skills";
+    readonly openable: false;
+}, {
+    readonly id: "built-in-tools";
+    readonly label: "Built-in Tools";
+}, {
+    readonly id: "custom-tools";
+    readonly label: "Custom Tools";
+}, {
+    readonly id: "user-messages";
+    readonly label: "User / Developer Messages";
+}, {
+    readonly id: "assistant-messages";
+    readonly label: "Assistant Messages";
+}, {
+    readonly id: "assistant-thinking";
+    readonly label: "Assistant Thinking";
+}, {
+    readonly id: "tool-calls";
+    readonly label: "Tool Calls";
+}, {
+    readonly id: "tool-output";
+    readonly label: "Tool Output";
+}];
+export type ContextCategoryId = (typeof CONTEXT_CATEGORIES)[number]["id"];
+/** Descriptor of a category id: its label, optional Overview label, and whether it can be opened. */
+export declare function contextCategoryDescriptor(id: ContextCategoryId): ContextCategoryDescriptor;
+export interface ContextThinkingGroup {
+    readonly id: string;
+    readonly label: string;
+    readonly tokens: number;
+    readonly interrupted?: boolean;
+}
+export interface ContextViewEntry {
+    readonly id: string;
+    readonly label: string;
+    readonly text: string;
+    /** Aggregation weight for the unscaled replay estimate; shared blocks contribute through their group. */
+    readonly tokens: number;
+    readonly interrupted?: boolean;
+    readonly thinkingGroup?: ContextThinkingGroup;
+    readonly path?: string;
+    readonly info?: string;
+    readonly timestamp?: number;
+    readonly callId?: string;
+}
+export interface ContextViewCategory {
+    id: ContextCategoryId;
+    key?: string;
+    label: string;
+    /** Overview attribution weight, not reported usage; may differ from the entry sum (e.g. Skills subtraction). */
+    tokens: number;
+    entries: ContextViewEntry[];
+    children?: ContextViewCategory[];
+}
+export interface ContextViewData {
+    readonly breakdown: ContextBreakdown;
+    readonly categories: readonly ContextViewCategory[];
+}
+export {};

package/dist/types/overlays/advisor-config.d.ts

@@ -22,8 +22,10 @@ import { type ModelBrowserSource } from "./model-browser.js";
 import type { DescribeContext, NativeNode, NativeUiEvent } from "../native/node.js";
 export declare const ADVISOR_REVIEW_MODES: readonly ["turn", "agent-end"];
 export declare const ADVISOR_SYNC_BACKLOG_MODES: readonly ["off", "1", "3", "5", "strict"];
+export declare const ADVISOR_SESSION_SCOPES: readonly ["main", "subagent", "all"];
 export type AdvisorReviewMode = (typeof ADVISOR_REVIEW_MODES)[number];
 export type AdvisorSyncBacklog = (typeof ADVISOR_SYNC_BACKLOG_MODES)[number];
+export type AdvisorSessionScope = (typeof ADVISOR_SESSION_SCOPES)[number];
 /** One advisor declared in `WATCHDOG.yml`; its instructions specialize the shared baseline. */
 export interface AdvisorConfig {
     name: string;
@@ -39,6 +41,10 @@ export interface AdvisorConfig {
     reviewMode?: AdvisorReviewMode;
     reviewInterval?: number;
     syncBacklog?: AdvisorSyncBacklog;
+    /** Which session kinds this advisor attaches to (`main`, `subagent`, or `all`; defaults to `all`). */
+    scope?: AdvisorSessionScope;
+    /** Whether primary assistant thinking blocks are included in updates sent to this advisor (defaults to `true`). */
+    includeReasoning?: boolean;
 }
 /** Which level a `WATCHDOG.yml` lives at: the project root or the user agent dir. */
 export type AdvisorConfigScope = "project" | "user";

package/dist/types/overlays/ask-dialog.d.ts

@@ -61,14 +61,21 @@ interface AskDialogCallbacks {
     /** Prompt that accepts pasted images; without it, prompts use `onPrompt`. */
     onImagePrompt?(prompt: AskDialogPrompt, prefill: AskDialogPromptValue | undefined): Promise<AskDialogPromptValue | undefined>;
 }
+/**
+ * Routes typing to a composer draft that was in progress when the dialog
+ * opened, so in-flight keystrokes never answer by accident. The up/down select
+ * keys are the explicit hand-off: they release the guard for the rest of the
+ * dialog's life and the draft stays parked (intact) beneath it.
+ */
 interface AskDialogInputGuard {
     isBlocked(): boolean;
     handleInput(keyData: string): void;
+    /** Shown after the release keys while the guard holds input. */
     hint: string;
     /** Mirror the guard's blocked state onto the proxied draft surface each
      *  render, so a draft that owns input shows a visible insertion cursor even
-     *  though this dialog holds TUI focus. */
-    syncPresentation?(): void;
+     *  though this dialog holds TUI focus, and drops it once the dialog takes over. */
+    syncPresentation?(blocked: boolean): void;
 }
 interface AskDialogOptions {
     timeout?: number;

package/dist/types/overlays/context-viewer-format.d.ts

@@ -0,0 +1,42 @@
+import type { TspSpan } from "@oh-my-pi/pi-wire";
+import type { ContextCategoryId, ContextThinkingGroup, ContextViewEntry } from "../chrome/context-view-model.js";
+/** Normalized newlines, control characters removed, tabs expanded. */
+export declare function safeContent(value: string): string;
+/** {@link safeContent} with embedded home paths shortened, for labels and metadata. */
+export declare function safeText(value: string): string;
+/** {@link safeText} collapsed to one row. */
+export declare function safeLine(value: string): string;
+/** Token label of an entry or group: `—` for a grouped entry, `N/A · Interrupted`, else `N token(s)` (unscaled estimate). */
+export declare function tokenEstimate(item: ContextViewEntry | ContextThinkingGroup): string;
+/** `[label] N tokens` as ANSI. */
+export declare function entryHeaderLine(entry: ContextViewEntry, category: ContextCategoryId): string;
+/** `[label] N tokens` as spans. */
+export declare function entryHeaderSpans(entry: ContextViewEntry, category: ContextCategoryId): TspSpan[];
+/** Heading for a shared thinking group: label plus its token estimate. */
+export declare function groupHeaderLine(group: ContextThinkingGroup, category: ContextCategoryId): string;
+/** Truncation marker under a preview; the selected preview also advertises the open key. */
+export declare function previewHint(selected: boolean): string;
+/**
+ * Metadata rows: info and path, call id, timestamp. The full-content view also
+ * lists the thinking group, which previews show as a shared heading instead.
+ */
+export declare function entryMetadata(entry: ContextViewEntry, options: {
+    hour12: boolean | undefined;
+    withGroup: boolean;
+}): string[];
+/** Preview row budget for a list of `height` rows: room for the entry heading, hint, and group heading. */
+export declare function previewRows(entry: ContextViewEntry, height: number): number;
+export interface EntryPreviewOptions {
+    /** Wrap width of preview rows. */
+    readonly width: number;
+    /** Maximum preview rows. */
+    readonly rows: number;
+    /** Viewport width; bounds the source read to `sourceWidth × rows × 2` characters before sanitizing and wrapping. */
+    readonly sourceWidth: number;
+    readonly hour12: boolean | undefined;
+}
+/** Dim metadata rows, then the indented body, cut to `rows`; `complete` is false when anything was omitted. */
+export declare function entryPreview(entry: ContextViewEntry, options: EntryPreviewOptions): {
+    lines: string[];
+    complete: boolean;
+};

package/dist/types/overlays/context-viewer-overview.d.ts

@@ -0,0 +1,70 @@
+import type { TspSpan } from "@oh-my-pi/pi-wire";
+import type { ContextBreakdown } from "../status-line/context-usage.js";
+import { type ContextMapCell } from "../chrome/context-map.js";
+import { type ContextPresentationId } from "../chrome/context-presentation.js";
+import type { NativeNode } from "../native/node.js";
+import type { ThemeColor } from "../theme/index.js";
+import { type ContextViewCategory, type ContextViewData } from "../chrome/context-view-model.js";
+/** Columns between the map and the legend. */
+export declare const MAP_LEGEND_GAP = 3;
+export interface OverviewRow {
+    readonly key: string;
+    readonly id: ContextPresentationId;
+    readonly label: string;
+    /** Attributed usage; undefined when the weights cannot scale current usage. */
+    readonly tokens: number | undefined;
+    /** Category opened on confirm; undefined rows are listed but not selectable. */
+    readonly category?: ContextViewCategory;
+    readonly child?: boolean;
+    /** Right-aligned token column. */
+    readonly tokenColumn: string;
+    /** Right-aligned share column, including its leading separator. */
+    readonly shareColumn: string;
+}
+export interface MapGeometry {
+    readonly columns: number;
+    readonly rows: number;
+    readonly cellWidth: number;
+    readonly gap: string;
+    readonly width: number;
+}
+/**
+ * Attribute current usage to categories by weight, then each category's share to its children.
+ * Attributed values are not entry sums: entries keep their unscaled content/replay estimates.
+ * Undefined when the top-level weights cannot scale; unscalable children stay unattributed.
+ */
+export declare function allocateUsage(categories: readonly ContextViewCategory[], usage: number): Map<ContextViewCategory, number> | undefined;
+/** Overview row label for a category: its Overview-specific label when the weight differs from its content. */
+export declare function overviewLabel(category: ContextViewCategory): string;
+/** Category and child rows, then buffer and free space, with aligned token and share columns. */
+export declare function buildOverviewRows(data: ContextViewData, allocation: ReadonlyMap<ContextViewCategory, number> | undefined): OverviewRow[];
+/** ANSI legend row: cursor, swatch, label padded to `width`, token and share columns. */
+export declare function legendLine(row: OverviewRow, selected: boolean, width: number): string;
+/** Native legend item; `meterGlyphs` swaps map glyphs for the meter's bar glyphs. */
+export declare function legendItem(row: OverviewRow, selected: boolean, meterGlyphs: boolean, window: number): NativeNode;
+/** Map size beside a legend in a `width` × `height` body; undefined when either would not fit. */
+export declare function mapGeometry(width: number, height: number): MapGeometry | undefined;
+/** Map cells per row, in window order: categories, free space, then buffer. */
+export declare function planMapRows(data: ContextViewData, allocation: ReadonlyMap<ContextViewCategory, number>, geometry: MapGeometry): ContextMapCell<ContextPresentationId>[][];
+/** ANSI map row; partially filled cells are dim. */
+export declare function mapRowLine(cells: readonly ContextMapCell<ContextPresentationId>[], geometry: MapGeometry): string;
+/** Native map row; partially filled cells are dim. */
+export declare function mapRowSpans(cells: readonly ContextMapCell<ContextPresentationId>[], geometry: MapGeometry): TspSpan[];
+/** Snapcompact savings lines of the Overview; empty when no snapcompact setting is on. */
+export declare function contextSnapcompactLines(breakdown: ContextBreakdown): string[];
+interface ContextMeterData extends Pick<ContextBreakdown, "contextWindow" | "usedTokens" | "freeTokens" | "autoCompactBufferTokens" | "thresholdTokens"> {
+    categories: readonly {
+        label: string;
+        tokens: number;
+        color: ThemeColor;
+    }[];
+}
+/** Shared usage and compaction labels for ANSI and native context views. */
+export declare function contextUsageSummary(breakdown: Pick<ContextBreakdown, "contextWindow" | "usedTokens" | "freeTokens" | "thresholdTokens">): {
+    used: string;
+    detail: string;
+    room: string;
+};
+/** Native usage summary and stacked bar; callers provide the category list. */
+export declare function describeContextMeter(breakdown: ContextMeterData): [NativeNode, NativeNode];
+export {};

package/dist/types/overlays/context-viewer.d.ts

@@ -0,0 +1,25 @@
+import type { ContextViewData } from "../chrome/context-view-model.js";
+import type { DescribeContext, NativeNode, NativeUiEvent } from "../native/node.js";
+import type { Component } from "../tui.js";
+/**
+ * Read-only context snapshot with three states: Overview → category previews → full entry content.
+ * Navigation state is shared; `render` (ANSI) and `describe` (native) each draw every state,
+ * via `#render<State>` and `#describe<State>` respectively.
+ */
+export declare class ContextViewer implements Component {
+    #private;
+    constructor(data: ContextViewData, options: {
+        onClose: () => void;
+        requestRender: () => void;
+        getRows: () => number;
+    });
+    invalidate(): void;
+    dispose(): void;
+    get nativeOverlay(): NonNullable<Component["nativeOverlay"]>;
+    /** Capture only handled navigation keys; the focus path consumes other modal input. */
+    capturesInput(data: string): boolean;
+    handleInput(data: string): void;
+    handleNativeEvent(event: NativeUiEvent): void;
+    render(width: number): readonly string[];
+    describe(cx: DescribeContext): NativeNode;
+}

package/dist/types/overlays/hook-input.d.ts

@@ -8,6 +8,7 @@ export interface HookInputOptions {
     tui?: TUI;
     timeout?: number;
     onTimeout?: () => void;
+    secret?: boolean;
 }
 export declare class HookInputComponent extends OverlayPanel {
     #private;

package/dist/types/overlays/running-subagent-badge.d.ts

@@ -1,6 +1,12 @@
-import type { AgentHubRegistry } from "./agent-hub-types.js";
+import { type AgentHubRegistry } from "./agent-hub-types.js";
 export interface RunningSubagentRegistrySource<T extends AgentHubRegistry = AgentHubRegistry> {
     agentRegistry: T;
 }
 export declare function getRunningSubagentBadgeRegistry<T extends AgentHubRegistry>(collabGuest: RunningSubagentRegistrySource<T> | undefined, localRegistry: T): T;
 export declare function getRunningSubagentBadgeAgentIds(registry: AgentHubRegistry): string[];
+/**
+ * Agents the Agent Hub roster can show (every registry ref but the main
+ * session), whatever their status: finished, parked and killed subagents
+ * stay inspectable after the last one stops running.
+ */
+export declare function getInspectableSubagentCount(registry: AgentHubRegistry): number;

package/dist/types/status-line/context-usage.d.ts

@@ -1,10 +1,6 @@
 import type { AgentMessage, Tokenizer } from "@oh-my-pi/pi-agent-core";
 import type { CompactionSettings } from "@oh-my-pi/pi-agent-core/compaction";
 import type { Tool as AiTool, Model } from "@oh-my-pi/pi-ai";
-import type { Theme } from "../theme/index.js";
-import { Container } from "../tui.js";
-import type { TspText } from "@oh-my-pi/pi-wire";
-import type { DescribeContext, NativeNode } from "../native/node.js";
 interface ContextSkill {
     readonly name: string;
     readonly description?: string;
@@ -63,8 +59,6 @@ interface CategoryInfo {
     id: CategoryId;
     label: string;
     tokens: number;
-    color: "accent" | "warning" | "success" | "userMessageText" | "customMessageLabel";
-    glyph: string;
 }
 export interface ContextBreakdown {
     model: Model | undefined;
@@ -128,6 +122,21 @@ export declare function getToolSchemaMetadataRevision(tools: ToolSchemaSource):
  * discovered-agent metadata changes).
  */
 export declare function invalidateToolSchemaMetadata(tools: ToolSchemaSource): void;
+/** Provider-visible text of one tool definition, in wire order. */
+export interface ToolSchemaFragments {
+    /** Name, description, wire schema JSON, then rendered examples; fields that cannot be serialized are omitted. */
+    readonly fragments: string[];
+    /** `fragments` with the schema JSON indented for reading; present only when a display indent was requested. */
+    readonly display?: string[];
+    /** Why serialization stopped; the schema or examples after that point are missing from `fragments`. */
+    readonly schemaError?: string;
+}
+/**
+ * Provider-visible text of one tool definition. `displayIndent` additionally
+ * returns `display`, the same fragments with the schema JSON indented, from
+ * the same schema conversion.
+ */
+export declare function toolSchemaFragments(tool: ContextTool, displayIndent?: number): ToolSchemaFragments;
 /**
  * Estimate provider-visible tool-schema tokens.
  *
@@ -158,28 +167,4 @@ export declare function computeNonMessageBreakdown(session: NonMessageTokenSourc
  * session and model.
  */
 export declare function computeContextBreakdown(session: ContextUsageSession, options: ContextUsageOptions): ContextBreakdown;
-/** The `/context` title: the model once one is selected (the body leads with its window). */
-export declare function contextUsageHead(breakdown: ContextBreakdown): TspText;
-/**
- * Native context-usage panel for terminals without `meter`: the cell grid as
- * unwrapped styled rows beside the legend. The terminal places the legend
- * beside the grid, or below it when narrow.
- */
-export declare function describeContextUsage(breakdown: ContextBreakdown): NativeNode;
-/**
- * The `/context` report body, without a frame or title of its own (the panel
- * showing it is titled {@link contextUsageHead}): ANSI renders the cell grid
- * beside the legend; natively it is drawn with `meter`s where the terminal has
- * them and as the glyph grid otherwise.
- */
-export declare class ContextUsageView extends Container {
-    #private;
-    constructor(breakdown: ContextBreakdown, theme: Theme);
-    describe(cx: DescribeContext): NativeNode;
-}
-/**
- * Render a colorful context-usage panel as ANSI text. Output is a series of
- * lines pairing the grid (left) with the legend (right).
- */
-export declare function renderContextUsage(breakdown: ContextBreakdown, theme: Theme): string;
 export {};

package/dist/types/theme/symbols.d.ts

@@ -2,7 +2,7 @@ export type SymbolPreset = "unicode" | "nerd" | "ascii";
 /**
  * All available symbol keys organized by category.
  */
-export type SymbolKey = "status.success" | "status.error" | "status.warning" | "status.info" | "status.pending" | "status.disabled" | "status.enabled" | "status.running" | "status.shadowed" | "status.aborted" | "status.done" | "nav.cursor" | "nav.selected" | "nav.expand" | "nav.collapse" | "nav.back" | "tree.branch" | "tree.last" | "tree.vertical" | "tree.horizontal" | "tree.hook" | "progress.filled" | "progress.empty" | "context.speculation" | "context.compaction" | "boxRound.topLeft" | "boxRound.topRight" | "boxRound.bottomLeft" | "boxRound.bottomRight" | "boxRound.horizontal" | "boxRound.vertical" | "boxDotted.horizontal" | "boxDotted.vertical" | "boxSharp.topLeft" | "boxSharp.topRight" | "boxSharp.bottomLeft" | "boxSharp.bottomRight" | "boxSharp.horizontal" | "boxSharp.vertical" | "boxSharp.cross" | "boxSharp.teeDown" | "boxSharp.teeUp" | "boxSharp.teeRight" | "boxSharp.teeLeft" | "sep.powerline" | "sep.powerlineThin" | "sep.powerlineLeft" | "sep.powerlineRight" | "sep.powerlineThinLeft" | "sep.powerlineThinRight" | "sep.powerlineCapLeft" | "sep.block" | "sep.space" | "sep.asciiLeft" | "sep.asciiRight" | "sep.dot" | "sep.slash" | "sep.pipe" | "icon.model" | "icon.plan" | "icon.prewalk" | "icon.goal" | "icon.pause" | "icon.loop" | "icon.folder" | "icon.worktree" | "icon.search" | "icon.scratchFolder" | "icon.file" | "icon.git" | "icon.branch" | "icon.pr" | "icon.pin" | "icon.tokens" | "icon.context" | "icon.cost" | "icon.subscription" | "icon.advisor" | "icon.advisorClosed" | "icon.time" | "icon.omp" | "icon.ghost" | "icon.agents" | "icon.job" | "icon.cache" | "icon.cacheMiss" | "icon.input" | "icon.output" | "icon.throughput" | "icon.intelligence" | "icon.host" | "icon.session" | "icon.package" | "icon.warning" | "icon.rewind" | "icon.auto" | "icon.fast" | "icon.extensionSkill" | "icon.extensionTool" | "icon.extensionSlashCommand" | "icon.extensionMcp" | "icon.extensionRule" | "icon.extensionHook" | "icon.extensionPrompt" | "icon.extensionContextFile" | "icon.extensionInstruction" | "icon.vimNormal" | "icon.vimInsert" | "icon.vimVisual" | "icon.vimVisualLine" | "icon.vimReplace" | "cmd.action" | "cmd.prompt" | "cmd.extension" | "cmd.settings" | "cmd.gear" | "cmd.shield" | "cmd.wave" | "cmd.compass" | "cmd.inbox" | "cmd.swap" | "cmd.expand" | "cmd.computer" | "cmd.eye" | "cmd.todo" | "cmd.stats" | "cmd.news" | "cmd.keyboard" | "cmd.export" | "cmd.clipboard" | "cmd.share" | "cmd.broadcast" | "cmd.globe" | "cmd.copy" | "cmd.plus" | "cmd.restart" | "cmd.eraser" | "cmd.trash" | "cmd.compress" | "cmd.vibrate" | "cmd.handoff" | "cmd.history" | "cmd.question" | "cmd.rocket" | "cmd.stethoscope" | "cmd.redo" | "cmd.bug" | "cmd.memory" | "cmd.pencil" | "cmd.folderMove" | "cmd.folderPlus" | "cmd.folderMinus" | "cmd.hammer" | "cmd.power" | "cmd.cart" | "icon.mic" | "icon.camera" | "thinking.minimal" | "thinking.low" | "thinking.medium" | "thinking.high" | "thinking.xhigh" | "thinking.max" | "thinking.autoPending" | "checkbox.checked" | "checkbox.unchecked" | "radio.selected" | "radio.unselected" | "format.bullet" | "format.dash" | "format.bracketLeft" | "format.bracketRight" | "md.quoteBorder" | "md.hrChar" | "md.bullet" | "md.colorSwatch" | "advisor.rail" | "skill.rail" | "lang.default" | "lang.typescript" | "lang.javascript" | "lang.python" | "lang.rust" | "lang.go" | "lang.java" | "lang.c" | "lang.cpp" | "lang.csharp" | "lang.ruby" | "lang.julia" | "lang.php" | "lang.swift" | "lang.kotlin" | "lang.shell" | "lang.html" | "lang.css" | "lang.json" | "lang.yaml" | "lang.markdown" | "lang.sql" | "lang.docker" | "lang.lua" | "lang.text" | "lang.env" | "lang.toml" | "lang.xml" | "lang.ini" | "lang.conf" | "lang.log" | "lang.csv" | "lang.tsv" | "lang.image" | "lang.pdf" | "lang.archive" | "lang.binary" | "chip.image" | "chip.video" | "chip.paste" | "tab.appearance" | "tab.model" | "tab.interaction" | "tab.context" | "tab.files" | "tab.shell" | "tab.tools" | "tab.memory" | "tab.tasks" | "tab.providers" | "tool.write" | "tool.edit" | "tool.bash" | "tool.ssh" | "tool.lsp" | "tool.gh" | "tool.webSearch" | "tool.exa" | "tool.browser" | "tool.eval" | "tool.debug" | "tool.mcp" | "tool.job" | "tool.launch" | "tool.task" | "tool.todo" | "tool.memory" | "tool.ask" | "tool.resolve" | "tool.review" | "tool.goal" | "tool.irc" | "tool.delete" | "tool.move" | "key.ctrl" | "key.ctrlMac" | "key.shift" | "key.alt" | "key.altMac" | "key.super" | "key.superMac" | "key.joiner" | "key.enter" | "key.esc" | "key.tab" | "key.backspace" | "key.delete" | "key.space" | "key.up" | "key.down" | "key.left" | "key.right";
+export type SymbolKey = "status.success" | "status.error" | "status.warning" | "status.info" | "status.pending" | "status.disabled" | "status.enabled" | "status.running" | "status.shadowed" | "status.aborted" | "status.done" | "nav.cursor" | "nav.selected" | "nav.expand" | "nav.collapse" | "nav.back" | "tree.branch" | "tree.last" | "tree.vertical" | "tree.horizontal" | "tree.hook" | "progress.filled" | "progress.empty" | "context.speculation" | "context.compaction" | "context.content" | "context.messages" | "context.buffer" | "context.free" | "boxRound.topLeft" | "boxRound.topRight" | "boxRound.bottomLeft" | "boxRound.bottomRight" | "boxRound.horizontal" | "boxRound.vertical" | "boxDotted.horizontal" | "boxDotted.vertical" | "boxSharp.topLeft" | "boxSharp.topRight" | "boxSharp.bottomLeft" | "boxSharp.bottomRight" | "boxSharp.horizontal" | "boxSharp.vertical" | "boxSharp.cross" | "boxSharp.teeDown" | "boxSharp.teeUp" | "boxSharp.teeRight" | "boxSharp.teeLeft" | "sep.powerline" | "sep.powerlineThin" | "sep.powerlineLeft" | "sep.powerlineRight" | "sep.powerlineThinLeft" | "sep.powerlineThinRight" | "sep.powerlineCapLeft" | "sep.block" | "sep.space" | "sep.asciiLeft" | "sep.asciiRight" | "sep.dot" | "sep.slash" | "sep.pipe" | "icon.model" | "icon.plan" | "icon.prewalk" | "icon.goal" | "icon.pause" | "icon.loop" | "icon.folder" | "icon.worktree" | "icon.search" | "icon.scratchFolder" | "icon.file" | "icon.git" | "icon.branch" | "icon.pr" | "icon.pin" | "icon.tokens" | "icon.context" | "icon.cost" | "icon.subscription" | "icon.advisor" | "icon.advisorClosed" | "icon.time" | "icon.omp" | "icon.ghost" | "icon.agents" | "icon.job" | "icon.cache" | "icon.cacheMiss" | "icon.input" | "icon.output" | "icon.throughput" | "icon.intelligence" | "icon.host" | "icon.session" | "icon.package" | "icon.warning" | "icon.rewind" | "icon.auto" | "icon.fast" | "icon.extensionSkill" | "icon.extensionTool" | "icon.extensionSlashCommand" | "icon.extensionMcp" | "icon.extensionRule" | "icon.extensionHook" | "icon.extensionPrompt" | "icon.extensionContextFile" | "icon.extensionInstruction" | "icon.vimNormal" | "icon.vimInsert" | "icon.vimVisual" | "icon.vimVisualLine" | "icon.vimReplace" | "cmd.action" | "cmd.prompt" | "cmd.extension" | "cmd.settings" | "cmd.gear" | "cmd.shield" | "cmd.wave" | "cmd.compass" | "cmd.inbox" | "cmd.swap" | "cmd.expand" | "cmd.computer" | "cmd.eye" | "cmd.todo" | "cmd.stats" | "cmd.news" | "cmd.keyboard" | "cmd.export" | "cmd.clipboard" | "cmd.share" | "cmd.broadcast" | "cmd.globe" | "cmd.copy" | "cmd.plus" | "cmd.restart" | "cmd.eraser" | "cmd.trash" | "cmd.compress" | "cmd.vibrate" | "cmd.handoff" | "cmd.history" | "cmd.question" | "cmd.rocket" | "cmd.stethoscope" | "cmd.redo" | "cmd.bug" | "cmd.memory" | "cmd.pencil" | "cmd.folderMove" | "cmd.folderPlus" | "cmd.folderMinus" | "cmd.hammer" | "cmd.power" | "cmd.cart" | "icon.mic" | "icon.camera" | "thinking.minimal" | "thinking.low" | "thinking.medium" | "thinking.high" | "thinking.xhigh" | "thinking.max" | "thinking.autoPending" | "checkbox.checked" | "checkbox.unchecked" | "radio.selected" | "radio.unselected" | "format.bullet" | "format.dash" | "format.bracketLeft" | "format.bracketRight" | "md.quoteBorder" | "md.hrChar" | "md.bullet" | "md.colorSwatch" | "advisor.rail" | "skill.rail" | "lang.default" | "lang.typescript" | "lang.javascript" | "lang.python" | "lang.rust" | "lang.go" | "lang.java" | "lang.c" | "lang.cpp" | "lang.csharp" | "lang.ruby" | "lang.julia" | "lang.php" | "lang.swift" | "lang.kotlin" | "lang.shell" | "lang.html" | "lang.css" | "lang.json" | "lang.yaml" | "lang.markdown" | "lang.sql" | "lang.docker" | "lang.lua" | "lang.text" | "lang.env" | "lang.toml" | "lang.xml" | "lang.ini" | "lang.conf" | "lang.log" | "lang.csv" | "lang.tsv" | "lang.image" | "lang.pdf" | "lang.archive" | "lang.binary" | "chip.image" | "chip.video" | "chip.paste" | "tab.appearance" | "tab.model" | "tab.interaction" | "tab.context" | "tab.files" | "tab.shell" | "tab.tools" | "tab.memory" | "tab.tasks" | "tab.providers" | "tool.write" | "tool.edit" | "tool.bash" | "tool.ssh" | "tool.lsp" | "tool.gh" | "tool.webSearch" | "tool.exa" | "tool.browser" | "tool.eval" | "tool.debug" | "tool.mcp" | "tool.job" | "tool.launch" | "tool.task" | "tool.todo" | "tool.memory" | "tool.ask" | "tool.resolve" | "tool.review" | "tool.goal" | "tool.irc" | "tool.delete" | "tool.move" | "key.ctrl" | "key.ctrlMac" | "key.shift" | "key.alt" | "key.altMac" | "key.super" | "key.superMac" | "key.joiner" | "key.enter" | "key.esc" | "key.tab" | "key.backspace" | "key.delete" | "key.space" | "key.up" | "key.down" | "key.left" | "key.right";
 export type SymbolMap = Record<SymbolKey, string>;
 /**
  * Icon vocabulary for slash-command autocomplete type indicators. Each name

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

@@ -26,6 +26,8 @@ export interface AskToolDetails {
     customInput?: string;
     /** Optional note attached to the selected answer in the rich ask dialog. */
     note?: string;
+    /** Label of the option the note is on; unset when it is on the custom answer. */
+    noteOption?: string;
     /** True when the answer was auto-selected because the dialog timed out. */
     timedOut?: boolean;
     /** Multi-part question mode */

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

@@ -9,6 +9,7 @@ export interface ReadUrlToolDetails {
     finalUrl: string;
     contentType: string;
     method: string;
+    raw?: boolean;
     truncated: boolean;
     notes: string[];
     meta?: OutputMeta;

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

@@ -85,6 +85,7 @@ export interface GhRunWatchFailedLogDetails {
     conclusion?: string;
     tail?: string;
     available: boolean;
+    unavailableReason?: string;
 }
 /** Live workflow watcher display snapshot. */
 export interface GhRunWatchViewDetails {
@@ -130,6 +131,8 @@ export interface GhFailedJobLog {
     full?: string;
     tail?: string;
     available: boolean;
+    unavailableReason?: string;
+    truncated?: boolean;
 }
 /** Choose the terminal conclusion or current job state. */
 export declare function formatJobState(job: GhRunJobSnapshot): string;

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

@@ -29,7 +29,10 @@ export interface ReadToolDetails {
     suffixResolution?: {
         from: string;
         to: string;
+        raw?: boolean;
     };
+    /** Raw source output keeps descriptive diagnostics in details, not in the body. */
+    raw?: boolean;
     url?: string;
     finalUrl?: string;
     contentType?: string;

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

@@ -55,6 +55,12 @@ export interface JobSnapshot {
      * on collision, else the job id itself. See {@link AsyncJob.agentId}.
      */
     agentUrlId?: string;
+    /**
+     * Whether this job's turn published `<agentUrlId>.md`. False where the job
+     * body reported that it wrote none, so `agent://` still holds an earlier
+     * turn's output; undefined where the body does not report it.
+     */
+    agentOutputPublished?: boolean;
 }
 /** Outcome of cancelling one background job. */
 export type CancelStatus = "cancelled" | "not_found" | "already_completed";

package/dist/types/tui.d.ts

@@ -363,6 +363,8 @@ export declare class TUI extends Container {
      * observers (live stream publisher, session recorder) coexist.
      */
     addPaintListener(listener: PaintListener): () => void;
+    /** Observe actual ANSI frame writes, including transient resize paints; returns the unsubscribe. */
+    addFrameWriteListener(listener: (data: string) => void): () => void;
     /** Install the product-owned bounded frame provider. */
     setFrameProvider(provider: TerminalFrameProvider | undefined): void;
     get fullRedraws(): number;

package/package.json

@@ -1,7 +1,7 @@
 {
 	"type": "module",
 	"name": "@oh-my-pi/pi-tui",
-	"version": "18.13.1",
+	"version": "18.13.2",
 	"description": "Terminal User Interface library with differential rendering for efficient text-based applications",
 	"homepage": "https://omp.sh",
 	"author": {
@@ -41,14 +41,14 @@
 		"gen:glyphs": "bun scripts/gen-glyphs.ts"
 	},
 	"dependencies": {
-		"@oh-my-pi/omptype": "18.13.1",
-		"@oh-my-pi/pi-agent-core": "18.13.1",
-		"@oh-my-pi/pi-ai": "18.13.1",
-		"@oh-my-pi/pi-catalog": "18.13.1",
-		"@oh-my-pi/pi-natives": "18.13.1",
-		"@oh-my-pi/pi-utils": "18.13.1",
-		"@oh-my-pi/pi-wire": "18.13.1",
-		"@oh-my-pi/snapcompact": "18.13.1"
+		"@oh-my-pi/omptype": "18.13.2",
+		"@oh-my-pi/pi-agent-core": "18.13.2",
+		"@oh-my-pi/pi-ai": "18.13.2",
+		"@oh-my-pi/pi-catalog": "18.13.2",
+		"@oh-my-pi/pi-natives": "18.13.2",
+		"@oh-my-pi/pi-utils": "18.13.2",
+		"@oh-my-pi/pi-wire": "18.13.2",
+		"@oh-my-pi/snapcompact": "18.13.2"
 	},
 	"devDependencies": {
 		"kitty-vt-wasm": "^0.2.0"