@linxiraos/pi-tui 1.1.5 → 1.1.7

package/CHANGELOG.md

@@ -2,9 +2,14 @@
 
 ## [Unreleased]
 
-## [1.1.5] - 2026-08-26
+## [1.1.7] - 2026-09-01
 
-- 同步上游 OMP v18.0.5 / v18.0.6：append-only transcript 声明与稳定行 API、markdown 渲染重构。
+- 同步上游 OMP v18.0.11（`b8ce33a58911c26bed1d84f0db9a5e2e727c49a2`）。
+
+## [1.1.6] - 2026-08-30
+
+- 同步上游 OMP v18.0.10（`33cc6b9a043a`）。
+- 同步上游 OMP v18.0.9（`cc14e04f075d`）。
 
 ## [1.1.3] - 2026-08-25
 

package/dist/types/components/box.d.ts

@@ -19,6 +19,8 @@ export declare class Box implements Component {
     children: Component[];
     setIgnoreTight(ignore: boolean): this;
     constructor(paddingX?: number, paddingY?: number, bgFn?: (text: string) => string, border?: BoxBorder);
+    /** Return container layout and child-count state for debug inspection. */
+    debugState(): Record<string, unknown>;
     addChild(component: Component): void;
     removeChild(component: Component): void;
     clear(): void;

package/dist/types/components/cancellable-loader.d.ts

@@ -16,6 +16,8 @@ export declare class CancellableLoader extends Loader {
     get signal(): AbortSignal;
     /** Whether the loader was aborted */
     get aborted(): boolean;
+    /** Return loader state including whether cancellation was requested. */
+    debugState(): Record<string, unknown>;
     handleInput(data: string): void;
     dispose(): void;
 }

package/dist/types/components/composer/band.d.ts

@@ -0,0 +1,2 @@
+import type { ComposerStyle } from "./types.js";
+export declare const bandComposerStyle: ComposerStyle;

package/dist/types/components/composer/index.d.ts

@@ -1,3 +1,4 @@
+export * from "./band.js";
 export * from "./borderless.js";
 export * from "./box.js";
 export * from "./claude.js";

package/dist/types/components/composer/registry.d.ts

@@ -1,6 +1,13 @@
 import type { ComposerStyle, EditorBorderStyle } from "./types.js";
 /** Whether an id names a composer style shipped by pi-tui. */
 export declare function isBuiltinComposerStyle(id: string): boolean;
+/**
+ * Whether a style paints its own row foreground.
+ *
+ * Extensions registered before `filledSurface` existed received undecorated
+ * row text, so an omitted flag remains filled for extension-owned ids.
+ */
+export declare function isFilledComposerStyle(style: ComposerStyle): boolean;
 /**
  * Register one extension-owned composer style for this process.
  *

package/dist/types/components/composer/types.d.ts

@@ -10,7 +10,7 @@ import type { SymbolTheme } from "../../symbols.js";
 /** Box-drawing glyph set used for composer chrome (the theme's `boxRound`). */
 export type ComposerBox = SymbolTheme["boxRound"];
 /** Built-in composer shape identifiers shipped by pi-tui. */
-export declare const BUILTIN_EDITOR_BORDER_STYLES: readonly ["box", "claude", "pi", "borderless", "rule", "field", "rail"];
+export declare const BUILTIN_EDITOR_BORDER_STYLES: readonly ["box", "band", "claude", "pi", "borderless", "rule", "field", "rail"];
 /** Identifier for a built-in composer shape. */
 export type BuiltinEditorBorderStyle = (typeof BUILTIN_EDITOR_BORDER_STYLES)[number];
 /** Composer shape identifier; extensions may register additional strings. */
@@ -60,14 +60,20 @@ export interface ComposerRowContext extends ComposerChromeContext {
 }
 export interface ComposerStyle {
     readonly id: EditorBorderStyle;
+    /**
+     * True when rows paint their own foreground through `surfaceColor`.
+     * Built-ins default to transparent; registered extensions that omit this
+     * field retain the pre-field behavior and receive undecorated row text.
+     */
+    readonly filledSurface?: boolean;
     /** Content rows carry left/right border glyphs; drives the cursor-reserve
      *  column, IME-safe layout, and the right-border scrollbar. */
     readonly sideBorders: boolean;
     /** Rows consumed by top+bottom chrome (drives maxHeight budgeting). */
     readonly verticalChrome: 0 | 1 | 2;
     /** Where the host should attach the status bar: embedded in the top border,
-     * docked onto a top rule, or detached into a standalone bottom bar. */
-    readonly statusAttachment: "top-border" | "top-rule-chip" | "none";
+     * rendered as a flush soft-capped band above the input, docked onto a top rule, or detached into a standalone bottom bar. */
+    readonly statusAttachment: "top-border" | "top-band" | "top-rule-chip" | "none";
     /** Which segment groups the standalone bottom status bar shows. */
     readonly bottomBar: "none" | "left" | "full";
     /** Insert a blank spacer row between the editor and the standalone bottom

package/dist/types/components/editor.d.ts

@@ -10,6 +10,8 @@ export interface EditorTheme {
     accentColor?: (str: string) => string;
     /** Background fill used by filled composer styles. */
     surfaceColor?: (str: string) => string;
+    /** Foreground used when the composer shape leaves its text surface transparent. */
+    textColor?: (str: string) => string;
     selectList: SelectListTheme;
     symbols: SymbolTheme;
     editorPaddingX?: number;
@@ -92,6 +94,10 @@ export declare class Editor implements Component, Focusable {
     onAutocompleteCancel?: () => void;
     disableSubmit: boolean;
     constructor(theme: EditorTheme);
+    /** Return bounded editor content, cursor, and transient child state for debug inspection. */
+    debugState(): Record<string, unknown>;
+    /** Expose the active autocomplete list to the debug tree walker. */
+    get debugChildren(): readonly Component[];
     setTheme(theme: EditorTheme): void;
     setAutocompleteProvider(provider: AutocompleteProvider): void;
     /** Install prose assistance without changing command/file autocomplete. */

package/dist/types/components/image.d.ts

@@ -157,6 +157,8 @@ export declare class ImageBudget {
 export declare class Image implements Component {
     #private;
     constructor(base64Data: string, mimeType: string, theme: ImageTheme, options?: ImageOptions, dimensions?: ImageDimensions);
+    /** Return source metadata without exposing the encoded image buffer. */
+    debugState(): Record<string, unknown>;
     invalidate(): void;
     render(width: number): readonly string[];
 }

package/dist/types/components/input.d.ts

@@ -13,6 +13,8 @@ export declare class Input implements Component, Focusable {
     /** Focusable interface - set by TUI when focus changes */
     focused: boolean;
     getValue(): string;
+    /** Return bounded input content and cursor state for debug inspection. */
+    debugState(): Record<string, unknown>;
     setValue(value: string): void;
     setUseTerminalCursor(useTerminalCursor: boolean): void;
     getUseTerminalCursor(): boolean;

package/dist/types/components/loader.d.ts

@@ -1,5 +1,7 @@
 import type { TUI } from "../tui.js";
 import { Text } from "./text.js";
+/** Milliseconds between spinner-frame advances; exported so time-derived spinners elsewhere tick at the Loader cadence. */
+export declare const SPINNER_ADVANCE_MS = 80;
 type ColorFn = (str: string) => string;
 /**
  * Styles Loader message fragments without changing their visible text or width.
@@ -15,11 +17,17 @@ export declare class Loader extends Text {
     private messageColorFn;
     private message;
     constructor(ui: TUI, spinnerColorFn: ColorFn, messageColorFn: LoaderMessageColorFn, message?: string | (() => string), spinnerFrames?: string[]);
+    /** Return the current message and animation state for debug inspection. */
+    debugState(): Record<string, unknown>;
     render(width: number): readonly string[];
     start(): void;
     stop(): void;
     /** Lifecycle teardown: stop the animation timer. Idempotent. */
     dispose(): void;
+    /** Install a lazy right-docked suffix for the spinner row (e.g. a styled
+     * session title). Re-evaluated every paint; dropped when the row leaves
+     * less than a two-cell gap. */
+    setTrailer(trailer: (() => string | undefined) | undefined): void;
     setMessage(message: string): void;
 }
 export {};

package/dist/types/components/markdown.d.ts

@@ -1,8 +1,6 @@
 import type { SymbolTheme } from "../symbols.js";
 import type { Component } from "../tui.js";
 /** @internal exported for tests — must stay index-identical to the old regex scan. */
-export declare function mathStartIndex(src: string): number | undefined;
-/** @internal exported for tests — must stay index-identical to the old regex scan. */
 export declare function autolinkSchemeScanIndex(src: string): number | undefined;
 /** @internal exported for tests — must never return false for a src the built-in url regex matches. */
 export declare function urlTokenPossible(src: string): boolean;
@@ -81,6 +79,8 @@ export declare class Markdown implements Component {
     #private;
     setIgnoreTight(ignore: boolean): this;
     constructor(text: string, paddingX: number, paddingY: number, theme: MarkdownTheme, defaultTextStyle?: DefaultTextStyle, codeBlockIndent?: number);
+    /** Return bounded source text and layout state for debug inspection. */
+    debugState(): Record<string, unknown>;
     setText(text: string): boolean;
     invalidate(): void;
     /**

package/dist/types/components/scroll-view.d.ts

@@ -36,6 +36,8 @@ export interface ScrollViewOptions {
 export declare class ScrollView implements Component {
     #private;
     constructor(lines: readonly string[], options: ScrollViewOptions);
+    /** Return viewport, content, and scroll position state for debug inspection. */
+    debugState(): Record<string, unknown>;
     setLines(lines: readonly string[]): void;
     setTotalRows(totalRows: number | undefined): void;
     setHeight(height: number): void;

package/dist/types/components/select-list.d.ts

@@ -58,6 +58,8 @@ export declare class SelectList implements Component, MouseRoutable {
     onCancel?: () => void;
     onSelectionChange?: (item: SelectItem) => void;
     constructor(items: ReadonlyArray<SelectItem>, maxVisible: number, theme: SelectListTheme, layout?: SelectListLayoutOptions);
+    /** Return item, selection, and filter state for debug inspection. */
+    debugState(): Record<string, unknown>;
     /** Refit the visible row budget (hosts clamp the list to available height). */
     setMaxVisible(rows: number): void;
     setFilter(filter: string): void;

package/dist/types/components/settings-list.d.ts

@@ -68,6 +68,10 @@ export declare class SettingsList implements Component {
     /** Fired when the selected item changes (navigation, filtering, or setItems). */
     onSelectionChange?: (item: SettingItem | undefined) => void;
     constructor(items: SettingItem[], maxVisible: number, theme: SettingsListTheme, onChange: (id: string, newValue: string) => void, onCancel: () => void, options?: SettingsListOptions);
+    /** Return item, selection, filter, and submenu state for debug inspection. */
+    debugState(): Record<string, unknown>;
+    /** Expose the active submenu to the debug tree walker. */
+    get debugChildren(): readonly Component[];
     /** The currently selected item, or undefined when empty or on a heading. */
     getSelectedItem(): SettingItem | undefined;
     /** Move selection to the item with `id`. Returns false when it is not visible. */

package/dist/types/components/spacer.d.ts

@@ -5,6 +5,8 @@ import type { Component } from "../tui.js";
 export declare class Spacer implements Component {
     #private;
     constructor(lines?: number);
+    /** Return the spacer height for debug inspection. */
+    debugState(): Record<string, unknown>;
     setLines(lines: number): void;
     invalidate(): void;
     render(_width: number): readonly string[];

package/dist/types/components/tab-bar.d.ts

@@ -45,6 +45,8 @@ export declare class TabBar implements Component {
     /** Render the trailing "(tab to cycle)" hint. Disable when the host folds the hint into its own footer. */
     showHint: boolean;
     constructor(label: string, tabs: Tab[], theme: TabBarTheme, initialIndex?: number);
+    /** Return tab identities and active-tab state for debug inspection. */
+    debugState(): Record<string, unknown>;
     /** Get the currently active tab */
     getActiveTab(): Tab;
     /** Get the index of the currently active tab */

package/dist/types/components/text.d.ts

@@ -12,6 +12,8 @@ export declare class Text implements Component {
     #private;
     setIgnoreTight(ignore: boolean): this;
     constructor(text?: string, paddingX?: number, paddingY?: number, customBgFn?: (text: string) => string);
+    /** Return bounded text and layout state for debug inspection. */
+    debugState(): Record<string, unknown>;
     getText(): string;
     setText(text: string): boolean;
     setCustomBgFn(customBgFn?: (text: string) => string): void;

package/dist/types/components/truncated-text.d.ts

@@ -5,6 +5,8 @@ import type { Component } from "../tui.js";
 export declare class TruncatedText implements Component {
     #private;
     constructor(text: string, paddingX?: number, paddingY?: number);
+    /** Return bounded source text and the last-known truncation state. */
+    debugState(): Record<string, unknown>;
     invalidate(): void;
     render(width: number): readonly string[];
 }

package/dist/types/debug-server.d.ts

@@ -0,0 +1,27 @@
+import { type TUI } from "./tui.js";
+export interface TuiDebugTreeNode {
+    kind: string;
+    id?: string;
+    rect?: [x: number, y: number, w: number, h: number];
+    focused?: boolean;
+    focusable?: boolean;
+    hidden?: boolean;
+    children?: TuiDebugTreeNode[];
+}
+export interface TuiDebugOverlayNode {
+    overlay: number;
+    band?: unknown;
+    hidden?: boolean;
+    root: TuiDebugTreeNode;
+}
+export interface TuiDebugTree {
+    root: TuiDebugTreeNode;
+    overlays: TuiDebugOverlayNode[];
+}
+/** NDJSON debug and input server enabled by the `OMP_TUI_DEBUG` socket path. */
+export declare class TuiDebugServer {
+    #private;
+    constructor(tui: TUI, path: string);
+    start(): void;
+    stop(): void;
+}

package/dist/types/index.d.ts

@@ -14,6 +14,7 @@ export * from "./components/spacer.js";
 export * from "./components/tab-bar.js";
 export * from "./components/text.js";
 export * from "./components/truncated-text.js";
+export * from "./debug-server.js";
 export * from "./deccara.js";
 export * from "./desktop-notify.js";
 export type * from "./editor-component.js";

package/dist/types/latex-to-unicode.d.ts

@@ -1,8 +1,8 @@
 /**
- * Math font command names (`\mathbf`, `\mathbb`, …) whose single brace argument
- * restyles glyphs. Exported for the display block engine (`latex-block`), which
- * re-wraps inline runs inside these commands when their argument contains 2-D
- * layout (fractions, matrices) so styling survives box boundaries.
+ * Math font and text-style command names whose single brace argument
+ * is rendered with the corresponding style. Exported for the display block
+ * engine, which re-wraps inline runs inside these commands when their argument
+ * contains 2-D layout so styling survives box boundaries.
  */
 export declare const MATH_FONT_COMMANDS: ReadonlySet<string>;
 /**
@@ -39,12 +39,3 @@ export declare function isBareMathEnvironment(env: string): boolean;
  * $10" is left untouched.
  */
 export declare function renderMathInText(text: string): string;
-/**
- * Index of the `$` that closes an inline math span opened at `open` (the index
- * of the opening `$`), or -1 when the run is not inline math. Applies pandoc's
- * anti-currency heuristics: the opener must not be followed by whitespace, the
- * closer must not be preceded by whitespace nor followed by a digit, `\$` is a
- * literal dollar, and the span may not span a newline. Shared by
- * `renderMathInText` and the markdown math tokenizer so the rule has one home.
- */
-export declare function inlineMathSpanEnd(text: string, open: number): number;

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

@@ -153,6 +153,23 @@ export declare function shouldEnableHyperlinksByDefault(env?: NodeJS.ProcessEnv,
  * without mutating `process.platform`.
  */
 export declare function resolveWarpImageProtocol(platform?: NodeJS.Platform, env?: NodeJS.ProcessEnv): ImageProtocol | null;
+/**
+ * Paseo (getpaseo/paseo) hardcodes `TERM_PROGRAM=kitty` into every PTY
+ * (`buildTerminalEnvironment`) while its xterm.js renderer implements neither
+ * Kitty graphics nor Unicode placeholders — trusting the advertisement turns
+ * image previews into literal PUA garbage (getpaseo/paseo#3850). Paseo
+ * injects `PASEO_TERMINAL_ID` into every terminal it hosts, which makes a
+ * reliable embedder signal.
+ */
+export declare function isPaseoEmbedder(env?: NodeJS.ProcessEnv): boolean;
+/**
+ * Resolve the image protocol for a non-forced runtime: static per-terminal
+ * support (with Warp's platform carve-out), then the multiplexer fallback,
+ * then the Paseo embedder carve-out. `isTTY` is injectable because the
+ * fallback only fires on a real TTY — a piped subprocess cannot exercise
+ * that path, so regression tests call this directly.
+ */
+export declare function resolveImageProtocol(terminalId: TerminalId, env?: NodeJS.ProcessEnv, isTTY?: boolean): ImageProtocol | null;
 /** Resolve terminal identity from environment markers used by common emulators. */
 export declare function detectTerminalId(env?: NodeJS.ProcessEnv): TerminalId;
 export declare const TERMINAL_ID: TerminalId;
@@ -189,6 +206,15 @@ export declare function setTerminalScreenToScrollback(enabled: boolean): void;
  * capability); tests flip it directly to exercise the scaled-heading path.
  */
 export declare function setTerminalTextSizing(enabled: boolean): void;
+/**
+ * Override OSC 8 hyperlink capability at runtime. The coding-agent calls this
+ * from the `tui.hyperlinks` setting so its resolved policy (`off`/`auto`/`always`)
+ * drives every renderer that gates on {@link TERMINAL}`.hyperlinks` — notably the
+ * Markdown component's `[text](url)`/bare-URL links — consistently with the
+ * path/resource links that already consult the setting directly. Tests flip it
+ * to exercise the OSC 8 and plain-text paths deterministically.
+ */
+export declare function setTerminalHyperlinks(enabled: boolean): void;
 export declare function getTerminalInfo(terminalId: TerminalId, platform?: NodeJS.Platform, env?: NodeJS.ProcessEnv): TerminalInfo;
 export interface CellDimensions {
     widthPx: number;

package/dist/types/terminal.d.ts

@@ -172,11 +172,22 @@ export interface Terminal {
  * single predicate.
  */
 export declare function isConPTYHosted(): boolean;
+/** Construction-time overrides for {@link ProcessTerminal}. */
+export interface ProcessTerminalOptions {
+    /**
+     * Force ConPTY-hosted behavior on or off. Defaults to live detection via
+     * {@link isConPTYHosted}. Tests set this so the kitty-flag and write-chunking
+     * paths stay hermetic regardless of the ambient WSL env (`WSL_DISTRO_NAME` /
+     * `WSL_INTEROP`) — the suite must behave identically on WSL and on CI.
+     */
+    conpty?: boolean;
+}
 /**
  * Real terminal using process.stdin/stdout
  */
 export declare class ProcessTerminal implements Terminal {
     #private;
+    constructor(options?: ProcessTerminalOptions);
     get kittyProtocolActive(): boolean;
     get kittyEnableSequence(): string | null;
     get keyboardEnhancementEnterSequence(): string | null;

package/dist/types/tui.d.ts

@@ -76,6 +76,14 @@ export interface TUIStartOptions {
  * which leading rows survived.
  */
 export interface Component {
+    /** Stable identifier surfaced in the debug tree as kind#id. */
+    debugId?: string;
+    /** Override for the tree node kind (default: constructor.name). */
+    debugKind?: string;
+    /** Widget state for the debug `values`/`tree` ops. JSON-serializable. */
+    debugState?(): Record<string, unknown>;
+    /** Children for the debug tree when not already exposed as a public `children` array. */
+    debugChildren?: readonly Component[];
     /**
      * Render the component to an array of physical rows at the given width.
      * The result is component-owned and `readonly` to the caller; an unchanged
@@ -292,9 +300,31 @@ export declare class TUI extends Container {
      * positive report, disabled on a negative one.
      */
     get synchronizedOutput(): boolean;
+    /**
+     * Cost in milliseconds of the most recently completed frame.
+     *
+     * Animation components use this to apply proportional backpressure after
+     * their render request is asynchronously composed and written.
+     */
+    get lastFrameCostMs(): number;
     setFocus(component: Component | null): void;
     /** Component currently receiving keyboard input, if any. */
     getFocused(): Component | null;
+    /** Last viewport successfully written by the renderer, for debug inspection. */
+    getDebugPaint(): {
+        lines: readonly string[];
+        windowTop: number;
+        altScreen: boolean;
+        cursor?: {
+            x: number;
+            y: number;
+            visible?: boolean;
+        };
+    } | undefined;
+    /** Render the current root document at the live terminal width for debug inspection. */
+    getDebugDocument(): readonly string[];
+    /** Feed debug and test input through the same pipeline as terminal stdin. */
+    injectDebugInput(data: string): void;
     /**
      * Show an overlay component with configurable positioning and sizing.
      * Returns a handle to control the overlay's visibility.

package/package.json

@@ -1,7 +1,7 @@
 {
 	"type": "module",
 	"name": "@linxiraos/pi-tui",
-	"version": "1.1.5",
+	"version": "1.1.7",
 	"description": "Terminal User Interface library with differential rendering for efficient text-based applications",
 	"homepage": "https://linxira-os.github.io/zeta/",
 	"author": "Stencil Labs, Inc.",
@@ -37,8 +37,8 @@
 		"fmt": "biome format --write ."
 	},
 	"dependencies": {
-		"@linxiraos/pi-natives": "1.1.5",
-		"@linxiraos/pi-utils": "1.1.5"
+		"@linxiraos/pi-natives": "1.1.7",
+		"@linxiraos/pi-utils": "1.1.7"
 	},
 	"devDependencies": {
 		"kitty-vt-wasm": "^0.2.0"

package/src/autocomplete.ts

@@ -331,10 +331,19 @@ function buildSlashCommandCompletions(
 				let best: (AutocompleteItem & { score: number; usage: number }) | undefined;
 
 				const isSkillCommand = name.startsWith(SKILL_NAMESPACE);
+				// Skills are matched by their bare name as well as the full
+				// `skill:` name so a broken-out or mid-prompt skill ranks at
+				// prefix strength (`/batch` → `skill:batch`) instead of a weak
+				// full-name fuzzy hit.
 				const nameScore =
 					lowerPrefix.length === 0 && isSkillCommand
 						? 950
-						: scoreCommandTextMatch(lowerPrefix, name.toLowerCase());
+						: isSkillCommand
+							? Math.max(
+									scoreCommandTextMatch(lowerPrefix, name.toLowerCase()),
+									scoreCommandTextMatch(lowerPrefix, name.slice(SKILL_NAMESPACE.length).toLowerCase()),
+								)
+							: scoreCommandTextMatch(lowerPrefix, name.toLowerCase());
 				const lowerDesc = staticDesc.toLowerCase();
 				const descScore =
 					lowerDesc && fuzzyMatch(lowerPrefix, lowerDesc) ? fuzzyScore(lowerPrefix, lowerDesc) * 0.5 : 0;
@@ -391,23 +400,56 @@ function hasPromptTextBeforeSlash(
 
 export const SKILL_NAMESPACE = "skill:";
 
+/**
+ * Match tier used to compare a skill's bare name against non-skill command
+ * names when deciding whether the skill may break out of the collapsed
+ * `skill:` group: exact (1000) > prefix (900) > anything weaker (0). Fuzzy
+ * hits deliberately map to 0 — a fuzzy skill match is never strong enough to
+ * mix skills into the command popup.
+ */
+function skillBreakoutTier(lowerPrefix: string, lowerTarget: string): number {
+	if (lowerPrefix === lowerTarget) return 1000;
+	if (lowerTarget.startsWith(lowerPrefix)) return 900;
+	return 0;
+}
+
 /**
  * Collapse `skill:*` commands into a single `/skill:` namespace row while the
- * typed prefix has not committed to the namespace. Until the prefix starts
- * with `skill:`, individual skills never list — a lone group entry (shown only
- * while the prefix is still a prefix of `skill:`) keeps the `/` popup
- * readable. Accepting the group inserts `/skill:` without a trailing space so
- * the reopened popup expands to the individual skills.
+ * typed prefix has not committed to the namespace. A lone group entry (shown
+ * only while the prefix is still a prefix of `skill:`) keeps the `/` popup
+ * readable. A skill breaks out of the group only when its bare name matches
+ * the prefix at a strictly stronger tier than every non-skill command name
+ * and alias (`/batch` → `skill:batch` while no command prefix-matches
+ * `batch`); a tie keeps the popup command-only, and fuzzy-only skill hits
+ * never surface. Accepting the group inserts `/skill:` without a trailing
+ * space so the reopened popup expands to the individual skills.
  */
 function collapseSkillNamespace(commands: CommandEntry[], lowerPrefix: string): CommandEntry[] {
 	if (lowerPrefix.startsWith(SKILL_NAMESPACE)) return commands;
+	const approachesNamespace = SKILL_NAMESPACE.startsWith(lowerPrefix);
+	let commandTier = 0;
+	if (!approachesNamespace) {
+		for (const cmd of commands) {
+			const name = getCommandName(cmd);
+			if (!name || name.startsWith(SKILL_NAMESPACE)) continue;
+			commandTier = Math.max(commandTier, skillBreakoutTier(lowerPrefix, name.toLowerCase()));
+			for (const alias of getCommandAliases(cmd)) {
+				commandTier = Math.max(commandTier, skillBreakoutTier(lowerPrefix, alias.toLowerCase()));
+			}
+			if (commandTier === 1000) break;
+		}
+	}
 	let skillCount = 0;
 	let skillIcon: string | undefined;
 	const rest = commands.filter(cmd => {
-		if (!getCommandName(cmd)?.startsWith(SKILL_NAMESPACE)) return true;
+		const name = getCommandName(cmd);
+		if (!name?.startsWith(SKILL_NAMESPACE)) return true;
 		skillCount += 1;
 		skillIcon ??= cmd.icon;
-		return false;
+		return (
+			!approachesNamespace &&
+			skillBreakoutTier(lowerPrefix, name.slice(SKILL_NAMESPACE.length).toLowerCase()) > commandTier
+		);
 	});
 	if (skillCount === 0) return commands;
 	if (!SKILL_NAMESPACE.startsWith(lowerPrefix)) return rest;

package/src/components/box.ts

@@ -59,6 +59,16 @@ export class Box implements Component {
 		this.#bgFn = bgFn;
 		this.#border = border;
 	}
+	/** Return container layout and child-count state for debug inspection. */
+	debugState(): Record<string, unknown> {
+		return {
+			childCount: this.children.length,
+			paddingX: this.#paddingX,
+			paddingY: this.#paddingY,
+			bordered: this.#border !== undefined,
+			ignoreTight: this.#ignoreTight,
+		};
+	}
 
 	addChild(component: Component): void {
 		this.children.push(component);

package/src/components/cancellable-loader.ts

@@ -25,6 +25,13 @@ export class CancellableLoader extends Loader {
 	get aborted(): boolean {
 		return this.#abortController.signal.aborted;
 	}
+	/** Return loader state including whether cancellation was requested. */
+	override debugState(): Record<string, unknown> {
+		return {
+			...super.debugState(),
+			cancelled: this.aborted,
+		};
+	}
 
 	handleInput(data: string): void {
 		const kb = getKeybindings();

package/src/components/composer/band.ts

@@ -0,0 +1,42 @@
+/**
+ * Soft status band composer (the rust omp default): the full status line sits
+ * flush against the terminal's left edge as a filled powerline band with a
+ * soft opening cap — no frame, rules, or corners — above an unboxed prompt
+ * anchored by a single curved `╰─ ` cue.
+ */
+import { truncateToWidth } from "../../utils";
+import type { ComposerChromeContext, ComposerRowContext, ComposerStyle } from "./types";
+
+export const bandComposerStyle: ComposerStyle = {
+	id: "band",
+	sideBorders: false,
+	verticalChrome: 1,
+	statusAttachment: "top-band",
+	bottomBar: "none",
+	bottomBarGap: false,
+	defaultPromptGutter: "╰─ ",
+
+	defaultPaddingX(): number {
+		return 0;
+	},
+
+	sideChromeWidth(): number {
+		return 0;
+	},
+
+	renderTop(ctx: ComposerChromeContext): string | undefined {
+		const { topBorder, width } = ctx;
+		if (!topBorder?.content) return undefined;
+		// The band builder already sizes its groups + gauge to the full width;
+		// truncation only guards against a stale provider during resize.
+		return topBorder.width > width ? truncateToWidth(topBorder.content, width) : topBorder.content;
+	},
+
+	renderRow(ctx: ComposerRowContext): string[] {
+		return [(ctx.gutter ? ctx.borderColor(ctx.gutter) : "") + ctx.text + ctx.pad];
+	},
+
+	renderBottom(): undefined {
+		return undefined;
+	},
+};

package/src/components/composer/field.ts

@@ -11,6 +11,7 @@ const RIGHT_CAP = "▌";
 /** One-row filled field with accent caps. */
 export const fieldComposerStyle: ComposerStyle = {
 	id: "field",
+	filledSurface: true,
 	sideBorders: true,
 	verticalChrome: 0,
 	statusAttachment: "none",

package/src/components/composer/index.ts

@@ -1,3 +1,4 @@
+export * from "./band";
 export * from "./borderless";
 export * from "./box";
 export * from "./claude";

package/src/components/composer/rail.ts

@@ -10,6 +10,7 @@ const ACCENT_RAIL = "▎";
 /** Filled composer surface anchored by a single left accent rail. */
 export const railComposerStyle: ComposerStyle = {
 	id: "rail",
+	filledSurface: true,
 	sideBorders: true,
 	verticalChrome: 0,
 	statusAttachment: "none",