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

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.0",
+	"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.0",
-		"@oh-my-pi/pi-agent-core": "18.13.0",
-		"@oh-my-pi/pi-ai": "18.13.0",
-		"@oh-my-pi/pi-catalog": "18.13.0",
-		"@oh-my-pi/pi-natives": "18.13.0",
-		"@oh-my-pi/pi-utils": "18.13.0",
-		"@oh-my-pi/pi-wire": "18.13.0",
-		"@oh-my-pi/snapcompact": "18.13.0"
+		"@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"

package/src/chrome/context-map.ts

@@ -0,0 +1,62 @@
+/** 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 function planContextMap<T>(
+	segments: readonly ContextMapSegment<T>[],
+	windowTokens: number,
+	columns: number,
+	rows: number,
+): ContextMapCell<T>[] {
+	if (
+		!Number.isFinite(windowTokens) ||
+		windowTokens <= 0 ||
+		!Number.isInteger(columns) ||
+		!Number.isInteger(rows) ||
+		columns <= 0 ||
+		rows <= 0
+	)
+		return [];
+	const cellCount = columns * rows;
+	const tokensPerCell = windowTokens / cellCount;
+	const ranges: { id: T; start: number; end: number }[] = [];
+	let cursor = 0;
+	for (const segment of segments) {
+		if (!Number.isFinite(segment.tokens) || segment.tokens <= 0) continue;
+		const end = Math.min(windowTokens, cursor + segment.tokens);
+		if (end > cursor) ranges.push({ id: segment.id, start: cursor, end });
+		cursor = end;
+		if (cursor >= windowTokens) break;
+	}
+	const cells: ContextMapCell<T>[] = [];
+	let first = 0;
+	for (let index = 0; index < cellCount; index++) {
+		const start = index * tokensPerCell;
+		const end = (index + 1) * tokensPerCell;
+		while (first < ranges.length && ranges[first]!.end <= start) first++;
+		let winner: T | undefined;
+		let overlap = 0;
+		for (let part = first; part < ranges.length && ranges[part]!.start < end; part++) {
+			const range = ranges[part]!;
+			const covered = Math.min(end, range.end) - Math.max(start, range.start);
+			if (covered > overlap) {
+				overlap = covered;
+				winner = range.id;
+			}
+		}
+		if (winner !== undefined) cells.push({ id: winner, full: overlap / tokensPerCell >= 0.7 });
+	}
+	return cells;
+}

package/src/chrome/context-presentation.ts

@@ -0,0 +1,26 @@
+import type { ThemeColor } from "../theme";
+import type { SymbolKey } from "../theme/symbols";
+import type { ContextCategoryId } from "./context-view-model";
+
+/** Shared category styles for maps and interactive legends; resolve glyphs at render time. */
+const SYSTEM = { color: "accent", symbol: "context.content" } as const;
+const DETAILS = { color: "customMessageLabel", symbol: "context.content" } as const;
+const TOOLS = { color: "warning", symbol: "context.content" } as const;
+const SKILLS = { color: "success", symbol: "context.content" } as const;
+const MESSAGES = { color: "userMessageText", symbol: "context.messages" } as const;
+const OUTPUT = { color: "muted", symbol: "context.messages" } as const;
+export const CONTEXT_PRESENTATION = {
+	"system-prompt": SYSTEM,
+	skills: SKILLS,
+	"built-in-tools": TOOLS,
+	"custom-tools": DETAILS,
+	// Shares the System Prompt color; the message glyph tells them apart in the map.
+	"user-messages": { color: "accent", symbol: "context.messages" },
+	"assistant-messages": MESSAGES,
+	"assistant-thinking": DETAILS,
+	"tool-calls": TOOLS,
+	"tool-output": OUTPUT,
+	buffer: { color: "warning", symbol: "context.buffer" },
+	free: { color: "dim", symbol: "context.free" },
+} as const satisfies Record<ContextPresentationId, { color: ThemeColor; symbol: SymbolKey }>;
+export type ContextPresentationId = ContextCategoryId | "buffer" | "free";

package/src/chrome/context-view-model.ts

@@ -0,0 +1,73 @@
+/** Context snapshot shapes shared by the session snapshot builder and the context viewer. */
+import type { ContextBreakdown } from "../status-line/context-usage";
+
+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 const CONTEXT_CATEGORIES = [
+	// The Overview weight excludes the Skills listing; content views keep complete system blocks.
+	{ id: "system-prompt", label: "System Prompt", overviewLabel: "System Prompt (excluding Skills)" },
+	// An estimate of the prompt's skill listing, without entries of its own.
+	{ id: "skills", label: "Skills", openable: false },
+	{ id: "built-in-tools", label: "Built-in Tools" },
+	{ id: "custom-tools", label: "Custom Tools" },
+	{ id: "user-messages", label: "User / Developer Messages" },
+	{ id: "assistant-messages", label: "Assistant Messages" },
+	{ id: "assistant-thinking", label: "Assistant Thinking" },
+	{ id: "tool-calls", label: "Tool Calls" },
+	{ id: "tool-output", label: "Tool Output" },
+] as const satisfies readonly ContextCategoryDescriptor[];
+
+export type ContextCategoryId = (typeof CONTEXT_CATEGORIES)[number]["id"];
+
+const DESCRIPTORS_BY_ID = new Map<ContextCategoryId, ContextCategoryDescriptor>(
+	CONTEXT_CATEGORIES.map(descriptor => [descriptor.id, descriptor]),
+);
+
+/** Descriptor of a category id: its label, optional Overview label, and whether it can be opened. */
+export function contextCategoryDescriptor(id: ContextCategoryId): ContextCategoryDescriptor {
+	return DESCRIPTORS_BY_ID.get(id)!;
+}
+
+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[];
+}

package/src/components/editor.ts

@@ -2431,10 +2431,12 @@ export class Editor implements Component, Focusable {
 			// Word left
 			this.#resetKillSequence();
 			this.#moveWordBackwards();
+			this.#dismissAutocomplete();
 		} else if (kb.matchesCanonical(canonical, "tui.editor.cursorWordRight")) {
 			// Word right
 			this.#resetKillSequence();
 			this.#moveWordForwards();
+			this.#dismissAutocomplete();
 		}
 		// Arrow keys
 		else if (kb.matchesCanonical(canonical, "tui.editor.cursorUp")) {
@@ -3900,6 +3902,9 @@ export class Editor implements Component, Focusable {
 		const dropSpace = this.#hasProvisionalSpace();
 		this.#historyIndex = -1; // Exit history browsing mode
 		this.#resetKillSequence();
+		// The cursor leaves the trigger token's line, so any open popup is stale:
+		// keeping it would float on the new line and Enter would submit past it.
+		this.#dismissAutocomplete();
 		this.#recordUndoState();
 
 		const currentLine = this.#state.lines[this.#state.cursorLine] || "";
@@ -4201,23 +4206,27 @@ export class Editor implements Component, Focusable {
 
 	#moveToLineStart(): void {
 		this.#resetKillSequence();
+		this.#dismissAutocomplete();
 		this.#setCursorCol(0);
 	}
 
 	#moveToLineEnd(): void {
 		this.#resetKillSequence();
+		this.#dismissAutocomplete();
 		const currentLine = this.#state.lines[this.#state.cursorLine] || "";
 		this.#setCursorCol(currentLine.length);
 	}
 
 	#moveToMessageStart(): void {
 		this.#resetKillSequence();
+		this.#dismissAutocomplete();
 		this.#state.cursorLine = 0;
 		this.#setCursorCol(0);
 	}
 
 	#moveToMessageEnd(): void {
 		this.#resetKillSequence();
+		this.#dismissAutocomplete();
 		this.#state.cursorLine = this.#state.lines.length - 1;
 		const currentLine = this.#state.lines[this.#state.cursorLine] || "";
 		this.#setCursorCol(currentLine.length);
@@ -4697,6 +4706,7 @@ export class Editor implements Component, Focusable {
 
 	#moveCursor(deltaLine: number, deltaCol: number): void {
 		this.#resetKillSequence();
+		this.#dismissAutocomplete();
 		const visualLines = this.#buildVisualLineMap(this.#caretRowWidth);
 		const currentVisualLine = this.#findCurrentVisualLine(visualLines);
 
@@ -4749,6 +4759,7 @@ export class Editor implements Component, Focusable {
 
 	#pageScroll(direction: -1 | 1): void {
 		this.#resetKillSequence();
+		this.#dismissAutocomplete();
 		const visualLines = this.#buildVisualLineMap(this.#caretRowWidth);
 		const currentVisualLine = this.#findCurrentVisualLine(visualLines);
 		const step = this.#getPageScrollStep(visualLines.length);
@@ -4779,6 +4790,7 @@ export class Editor implements Component, Focusable {
 	 */
 	#jumpToChar(char: string, direction: "forward" | "backward"): void {
 		this.#resetKillSequence();
+		this.#dismissAutocomplete();
 		const isForward = direction === "forward";
 		const lines = this.#state.lines;
 
@@ -5195,6 +5207,17 @@ export class Editor implements Component, Focusable {
 		}
 	}
 
+	/**
+	 * Close the popup when the cursor leaves the token it was opened for (newline,
+	 * pure cursor motion). Its prefix no longer matches the text before the cursor,
+	 * so it could neither accept nor refresh and would linger stale.
+	 */
+	#dismissAutocomplete(): void {
+		if (this.#autocompleteState === null) return;
+		this.#cancelAutocomplete();
+		this.onAutocompleteUpdate?.();
+	}
+
 	/**
 	 * Whether an autocomplete popup is on screen. An `@` list narrowed to no match
 	 * while its refresh is pending stays open internally but is hidden, so it does

package/src/components/markdown.ts

@@ -4346,7 +4346,13 @@ export class Markdown implements Component {
 
 			// Process item tokens; nested-list lines arrive structurally tagged and
 			// already carry their own full indent.
-			const itemLines = this.#renderListItem(item.tokens || [], depth, width, styleContext);
+			const itemLines = this.#renderListItem(
+				item.tokens || [],
+				depth,
+				width,
+				Math.max(1, width - visibleWidth(continuationIndent)),
+				styleContext,
+			);
 
 			if (itemLines.length > 0) {
 				const firstLine = itemLines[0]!;
@@ -4398,11 +4404,13 @@ export class Markdown implements Component {
 		tokens: Token[],
 		parentDepth: number,
 		width: number,
+		contentWidth: number,
 		styleContext?: InlineStyleContext,
 	): RenderedListItemLine[] {
 		const lines: RenderedListItemLine[] = [];
 
-		for (const token of tokens) {
+		for (let i = 0; i < tokens.length; i++) {
+			const token = tokens[i]!;
 			if (token.type === "list") {
 				// Nested list - render with one additional indent level
 				// These lines carry their own indent, so tag them for pass-through
@@ -4442,6 +4450,10 @@ export class Markdown implements Component {
 					lines.push({ ...bodyLine, nested: false });
 				}
 				lines.push({ text: this.#theme.codeBlockBorder("```"), nested: false });
+			} else if (token.type === "table") {
+				for (const row of this.#renderTable(token as TableToken, contentWidth, tokens[i + 1]?.type, styleContext)) {
+					lines.push({ text: row, nested: false });
+				}
 			} else if (isMathToken(token)) {
 				// Display math block inside a list item: stack fractions / matrix rows.
 				const apply = styleContext?.applyText ?? ((t: string) => this.#applyDefaultStyle(t));

package/src/overlays/advisor-config.ts

@@ -64,10 +64,11 @@ import { getThinkingLevelMetadata, parseThinkingLevel } from "../thinking";
 
 export const ADVISOR_REVIEW_MODES = ["turn", "agent-end"] as const;
 export const ADVISOR_SYNC_BACKLOG_MODES = ["off", "1", "3", "5", "strict"] as const;
+export const ADVISOR_SESSION_SCOPES = ["main", "subagent", "all"] as const;
 
 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;
@@ -83,6 +84,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. */
@@ -1202,7 +1207,9 @@ export class AdvisorConfigOverlayComponent implements Component {
 			advisor.syncBacklog === undefined &&
 			!advisor.instructions?.trim() &&
 			advisor.enabled !== false &&
-			advisor.maxNotesPerUpdate === undefined
+			advisor.maxNotesPerUpdate === undefined &&
+			advisor.scope === undefined &&
+			advisor.includeReasoning === undefined
 		);
 	}