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

package/dist/types/setup/scenes/sign-in.d.ts

@@ -1,10 +1,15 @@
 import { type SgrMouseEvent } from "../../mouse.js";
-import type { NativeNode } from "../../native/node.js";
-import type { SetupScene, SetupSceneController, SetupSceneHost } from "./types.js";
+import type { DescribeContext, NativeNode } from "../../native/node.js";
+import { type SetupScene, type SetupSceneController, type SetupSceneHost } from "./types.js";
 /**
  * "Sign in" scene: lets the user authenticate one or more model providers via
  * OAuth. It never auto-advances the wizard — the user may sign in to several
- * providers and then continue with Esc.
+ * providers and then leave the step with Esc.
+ *
+ * Picking is the provider selector (natively a setup sheet: Skip/Continue on
+ * Esc, Sign in on Enter); signing in is the app's {@link LoginDialogComponent},
+ * driven like `/login` drives it: natively its own sheet over the setup page,
+ * in the cell grid drawn in the wizard body in place of the selector.
  */
 export declare class SignInScene implements SetupSceneController {
     #private;
@@ -14,15 +19,15 @@ export declare class SignInScene implements SetupSceneController {
     dispose(): void;
     invalidate(): void;
     handleInput(data: string): void;
-    /** Forward mouse to the provider selector; pointer is inert during an active login or code prompt. */
+    /** Forward mouse to the provider selector; the login dialog takes keys only. */
     routeMouse(event: SgrMouseEvent, line: number, col: number): void;
     render(width: number, maxLines?: number): readonly string[];
     /**
-     * Picking: intro, the provider selector (describes itself) and the last
-     * outcome. Signing in: a spinner heading, the login link (with the full
-     * URL once, char-wrapped), any code prompt and the flow's progress lines.
+     * Signing in: the login dialog (its own sheet). Picking: the provider
+     * selector, which presents the setup sheet where the terminal draws
+     * pickers; elsewhere it is an inline card under the lead and the outcome.
      */
-    describe(): NativeNode;
+    describe(cx: DescribeContext): NativeNode;
 }
 /** Onboarding scene for provider sign-in. */
 export declare const providersSetupScene: SetupScene;

package/dist/types/setup/scenes/splash.d.ts

@@ -11,9 +11,9 @@ export declare function renderStarfield(width: number, height: number, frame: nu
  */
 export declare function renderSetupSplash(width: number, height: number, elapsedMs: number): string[];
 /**
- * Native splash: the 2x brand mark with a terminal-clocked shimmer, the
- * wordmark, and the skip hint pinned to the bottom. The water and starfield
- * are cell paintings with no semantic counterpart. A click on the splash
- * sends the `skip` action.
+ * Native splash: omp's lockup as the welcome draws it (the builtin mark
+ * drawing on beside the wordmark and version), centered, and a quiet Enter
+ * hint pinned to the bottom. The water and starfield are cell paintings with
+ * no semantic counterpart. A click anywhere sends `skip`.
  */
 export declare function describeSetupSplash(): NativeNode;

package/dist/types/setup/scenes/types.d.ts

@@ -42,7 +42,6 @@ export interface SetupHost extends SetupUiHost {
     saveColorBlindMode(enabled: boolean): void;
     saveTheme(mode: "dark" | "light", name: string): void;
     captureBrowserSession(request: OAuthBrowserSessionRequest, signal?: AbortSignal): Promise<string>;
-    copyToClipboard(text: string): Promise<void>;
     openInBrowser(url: string): void;
     markComplete(version: number): Promise<void>;
     playWelcomeIntro(): void;
@@ -80,11 +79,27 @@ export interface SetupSceneController extends Component {
      */
     routeMouse?(event: SgrMouseEvent, line: number, col: number): void;
 }
+/**
+ * Role of the sheet (`picker` or `overlay`) an interactive scene presents in a
+ * TSP terminal. The terminal's setup stylesheet seats it under the wizard's
+ * brand and stepper instead of floating it over a dimmed page.
+ */
+export declare const SETUP_SHEET_ROLE = "omp.setup.sheet";
+/** Surface role of the setup page (wizard and startup splash) in a TSP terminal. */
+export declare const SETUP_SURFACE_ROLE = "omp.app.setup";
 /** Versioned onboarding scene definition. */
 export interface SetupScene {
     id: string;
     title: string;
+    /** Short label for the wizard's stepper (`Sign in`, `Model`). */
+    step: string;
     minVersion: number;
+    /**
+     * Configures something only the cell-grid renderer draws (glyphs, composer
+     * shape, theme). A TSP terminal draws those itself, so the wizard skips the
+     * scene while a native surface is live.
+     */
+    ansiOnly?: boolean;
     shouldRun?(ctx: SetupHost): boolean | Promise<boolean>;
     mount(host: SetupSceneHost): SetupSceneController;
 }

package/dist/types/setup/startup-splash.d.ts

@@ -1,4 +1,4 @@
-import type { SetupUiHost } from "./scenes/types.js";
+import { type SetupUiHost } from "./scenes/types.js";
 /** Timing controls for the standalone startup animation. */
 export interface RunStartupSplashOptions {
     readonly durationMs?: number;

package/dist/types/setup/wizard-overlay.d.ts

@@ -1,7 +1,9 @@
 import { type Component, type OverlayFocusOwner } from "../tui.js";
-import type { NativeNode, NativeUiEvent } from "../native/node.js";
+import type { DescribeContext, NativeNode, NativeScreen, NativeUiEvent } from "../native/node.js";
 import type { SetupHost } from "./scenes/types.js";
-import type { SetupScene } from "./scenes/types.js";
+import { type SetupScene } from "./scenes/types.js";
+/** Whether `scene` is asked under the current renderer: a TSP surface draws `ansiOnly` settings itself. */
+export declare function setupSceneApplies(scene: SetupScene): boolean;
 /** Fullscreen onboarding presentation with scene focus and mouse routing. */
 export declare class SetupWizardComponent implements Component, OverlayFocusOwner {
     #private;
@@ -14,12 +16,14 @@ export declare class SetupWizardComponent implements Component, OverlayFocusOwne
     ownsOverlayFocusTarget(component: Component): boolean;
     handleInput(data: string): void;
     render(width: number): readonly string[];
+    /** The wizard is a page of its own: a screen surface styled by {@link SETUP_SURFACE_ROLE}. */
+    describeScreen(_cx: DescribeContext): NativeScreen;
     /**
-     * Fullscreen description: splash, the active scene inside the wizard
-     * frame (brand header, step counter, title, footer hints), or the outro.
-     * The splash→scene dissolve is a row effect with no native counterpart, so
-     * a transition describes as the scene.
+     * Fullscreen description: splash, the active scene under the setup
+     * header (brand, stepper, Exit setup), or the outro. The splash→scene
+     * dissolve is a row effect with no native counterpart, so a transition
+     * describes as the scene.
      */
-    describe(): NativeNode;
+    describe(cx: DescribeContext): NativeNode;
     handleNativeEvent(event: NativeUiEvent): void;
 }

package/dist/types/setup/wizard.d.ts

@@ -21,5 +21,9 @@ export interface RunSetupWizardOptions {
     markComplete?: boolean;
     playWelcomeIntro?: boolean;
 }
-/** Own the fullscreen setup overlay until its scenes and outro finish. */
+/**
+ * Own the fullscreen setup overlay until its scenes and outro finish. When
+ * none of `scenes` applies to the current renderer (a TSP surface skips
+ * `ansiOnly` ones) nothing is shown, but completion is still persisted.
+ */
 export declare function runSetupWizard(ctx: SetupHost, scenes?: readonly SetupScene[], options?: RunSetupWizardOptions): Promise<void>;

package/dist/types/status-line/component.d.ts

@@ -111,7 +111,7 @@ export declare class StatusLineComponent<TSession extends StatusLineSession = St
     setRecording(recording: boolean): void;
     /** Set the callback that presents detected Codex reset celebrations, or clear it with `undefined`. */
     setCodexResetFireworksHandler(handler: ((event: CodexResetFireworksEvent) => void) | undefined): void;
-    /** Set the callback that presents the first pool-wide saved-reset expiry warning, or clear it with `undefined`. */
+    /** Set the callback that presents pool-wide saved-reset expiry warnings, or clear it with `undefined`. */
     setResetExpiryNoticeHandler(handler: ((notice: string) => void) | undefined): void;
     setHookStatus(key: string, text: string | undefined): void;
     watchBranch(onBranchChange: () => void): void;

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

@@ -98,6 +98,11 @@ export interface NonMessageTokenSource {
         readonly state?: {
             readonly tools?: readonly ContextTool[];
         };
+        /**
+         * Whether requests to `model` ship description-stripped tool specs because
+         * the catalog rides in the system prompt (`Agent.prunesToolDescriptions`).
+         */
+        prunesToolDescriptions?(model: Model | undefined): boolean;
     };
     readonly skills?: readonly ContextSkill[];
     /** Provider-facing, session-frozen descriptions when available. */
@@ -131,24 +136,41 @@ export interface ToolSchemaFragments {
     /** Why serialization stopped; the schema or examples after that point are missing from `fragments`. */
     readonly schemaError?: string;
 }
+/** How {@link toolSchemaFragments} renders one tool definition. */
+export interface ToolSchemaFragmentOptions {
+    /** Also return `display`: the same fragments with the schema JSON indented by this many spaces. */
+    displayIndent?: number;
+    /**
+     * Mirror `normalizeTools({ pruneDescriptions: true })`: the wire spec is the
+     * name plus the description-stripped schema, with no description or examples.
+     */
+    pruneDescriptions?: boolean;
+}
 /**
  * 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;
+export declare function toolSchemaFragments(tool: ContextTool, options?: ToolSchemaFragmentOptions): ToolSchemaFragments;
+/** Inputs that select which tool-schema estimate applies, beyond the roster and tokenizer. */
+export interface ToolSchemaEstimateOptions {
+    /** Caller settings/source revision; a change invalidates the cached estimate. */
+    sourceRevision?: number;
+    /** Count the description-stripped specs sent when the catalog rides in the system prompt. */
+    pruneDescriptions?: boolean;
+}
 /**
  * Estimate provider-visible tool-schema tokens.
  *
  * Results are cached by roster-array identity, tokenizer identity, the
- * caller-supplied settings/source revision, and the roster's explicit dynamic
- * metadata revision. Callers whose descriptions or schemas are live getters
- * must either advance `sourceRevision` or call
+ * caller-supplied settings/source revision, the prune mode, and the roster's
+ * explicit dynamic metadata revision. Callers whose descriptions or schemas are
+ * live getters must either advance `sourceRevision` or call
  * {@link invalidateToolSchemaMetadata} when those inputs change.
  */
-export declare function estimateToolSchemaTokens(tools: ToolSchemaSource, tokenizer: Tokenizer, sourceRevision?: number): number;
+export declare function estimateToolSchemaTokens(tools: ToolSchemaSource, tokenizer: Tokenizer, options?: ToolSchemaEstimateOptions): number;
 /** Count schemas carried on every request, excluding server-side deferred catalogs. */
-export declare function estimateContextToolSchemaTokens(tools: ToolSchemaSource, tokenizer: Tokenizer, model: Model | undefined, sourceRevision?: number): number;
+export declare function estimateContextToolSchemaTokens(tools: ToolSchemaSource, tokenizer: Tokenizer, model: Model | undefined, options?: ToolSchemaEstimateOptions): number;
 export declare function computeNonMessageTokens(session: NonMessageTokenSource, tokenizer: Tokenizer, sourceRevision?: number): number;
 /**
  * Shared helper for the four non-message token totals used by

package/dist/types/status-line/host.d.ts

@@ -132,8 +132,12 @@ export interface StatusLineHost<TSession extends StatusLineSession = StatusLineS
     calculateTokensPerSecond(messages: readonly AgentMessage[], isStreaming: boolean): number | null;
     limitMatchesActiveAccount(report: UsageReport, limit: UsageLimit, identity: StatusAccountIdentity): boolean;
     classifyResetExpiry?(report: UsageReport, nowMs: number): StatusResetExpiry | undefined;
-    /** One-line warning for saved resets anywhere in the pool that expire within 24 hours. */
-    resetExpiryNotice?(reports: readonly UsageReport[], nowMs: number): string | undefined;
+    /**
+     * One-line warning for saved resets anywhere in the pool that are about to expire.
+     * The host owns deduplication: a returned warning counts as shown, so each saved
+     * reset is warned about once, not once per refresh or conversation.
+     */
+    resetExpiryNotice?(session: TSession, reports: readonly UsageReport[], nowMs: number): string | undefined;
     computeCompactionBoundaries(session: TSession, contextWindow: number, model?: Model): CompactionBoundaries | null;
 }
 export interface FooterHost {

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

@@ -114,29 +114,6 @@ export declare function stopThemeWatcher(): void;
  * Used by HTML export to generate CSS custom properties.
  */
 export declare function getResolvedThemeColors(themeName?: string): Promise<Record<string, string>>;
-/** One appearance variant of {@link NativeThemePalette}: token name → `#rrggbb`. */
-export type NativeThemeVariant = Record<string, string>;
-/** omp's resolved theme for a Tern Surface Protocol terminal (the `t` verb body minus `sf`). */
-export interface NativeThemePalette {
-    dark?: NativeThemeVariant;
-    light?: NativeThemeVariant;
-    name: {
-        dark?: string;
-        light?: string;
-    };
-}
-/**
- * Cheap identity of everything {@link getNativeThemePalette} depends on;
- * recompute the palette only when it changes.
- */
-export declare function getNativeThemePaletteKey(): string;
-/**
- * omp's theme for a native surface: with auto theme, the configured dark and
- * light themes; otherwise (or while the theme selector previews one) the
- * active theme under its own appearance only. Themes without a loadable
- * definition (in-memory instances) contribute nothing.
- */
-export declare function getNativeThemePalette(): NativeThemePalette;
 /**
  * Check if a theme is a "light" theme by analyzing its status-line background
  * luminance. Loads theme JSON synchronously (built-in or custom file on disk)

package/dist/types/tools/bash-interactive.d.ts

@@ -6,6 +6,12 @@ import type { Theme } from "../theme/theme.js";
 export interface BashInteractiveTerminalBackend {
     resize(columns: number, rows: number): void;
 }
+/**
+ * Translates a TUI key event into the bytes a terminal would send to a PTY
+ * child; key releases encode to "". Shared by the agent `pty` console and
+ * `!` commands (`BashExecutionComponent.encodePtyInput`).
+ */
+export declare function normalizeInputForPty(data: string, applicationCursorKeysMode: boolean): string;
 /** Interactive terminal overlay driven by an external PTY controller. */
 export declare class BashInteractiveOverlayComponent implements Component {
     #private;

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

@@ -24,6 +24,8 @@ export interface BashToolDetails {
     exitCode?: number;
     /** True when the command was killed by its timeout deadline (not a failure). */
     timedOut?: boolean;
+    /** Text the command wrote to `out://`, oldest first; transcripts draw each as a reply after the call. */
+    replies?: string[];
     /** Live ACP update only; completed results refer to released terminals. */
     terminalId?: string;
     service?: {

package/dist/types/tools/default-renderer.d.ts

@@ -22,10 +22,12 @@ export interface DefaultToolRenderInput {
 export declare function formatDefaultToolExecution(input: DefaultToolRenderInput, contentWidth: number, uiTheme: Theme): string;
 /**
  * TSP view of the generic fallback card: the tool label with a one-line args
- * summary as the head target; the result as a JSON tree or raw `ansi` output.
- * The complete output goes over the wire — the card-level disclosure clamp the
- * terminal applies is the only bound, so an expanded card keeps every row. JSON
- * the tree's depth, node or scalar caps would cut keeps the raw path instead.
+ * summary as the head target; the result as JSON (the host's `json` viewer,
+ * else a JSON tree) or raw `ansi` output. The complete output goes over the
+ * wire — the card-level disclosure clamp the terminal applies is the only
+ * bound, so an expanded card keeps every row. The `json` viewer never cuts;
+ * JSON the fallback tree's depth, node or scalar caps would cut keeps the raw
+ * path instead.
  */
 export declare function describeDefaultToolExecution(input: DefaultToolRenderInput): NativeToolView;
 /** Render the generic fallback as the state-tinted card used by direct custom tools. */

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

@@ -25,6 +25,12 @@ export interface IrcMessage {
      * the broadcaster, mostly to say the message was not for it.
      */
     broadcast?: boolean;
+    /**
+     * Interim acknowledgement or progress on something the recipient asked
+     * (`agent://<id>?progress`): it neither answers that request nor asks one,
+     * so the recipient's `wait` keeps waiting for the actual reply.
+     */
+    progress?: boolean;
 }
 /** Delivery outcome for one peer recipient. */
 export interface IrcDeliveryReceipt {

package/dist/types/tools/json-tree.d.ts

@@ -12,6 +12,8 @@ export declare const JSON_TREE_MAX_LINES_EXPANDED = 200;
 export declare const JSON_TREE_SCALAR_LEN_COLLAPSED = 60;
 /** Maximum expanded JSON scalar width. */
 export declare const JSON_TREE_SCALAR_LEN_EXPANDED = 2000;
+/** Characters a container's one-line form may take before a JSON tree lists its entries instead. */
+export declare const JSON_TREE_INLINE_LEN = 60;
 /** Sanitization, string summary, and budgeting policy for inline JSON. */
 export interface InlineFormatOptions {
     sanitizeText?: (text: string) => string;
@@ -46,7 +48,8 @@ export interface JsonTreeRenderOptions {
     rootConnectors?: "hooked" | "siblings";
 }
 /**
- * Render a JSON value as bounded tree lines. The positional form remains the
+ * Render a JSON value as bounded tree lines, containers that fit
+ * {@link JSON_TREE_INLINE_LEN} on one row. The positional form remains the
  * public tool-renderer contract; the options form exposes sanitization and root
  * connector policy for specialized adapters such as nested task output.
  */
@@ -74,8 +77,24 @@ export interface JsonTreeDescribeOptions {
     onTruncated?: () => void;
 }
 /**
- * TSP `tree` of a JSON value: containers become expandable nodes labelled with
- * their key and size, scalars become `key: value` leaves styled by type.
- * Bounded by depth, node count and scalar length; no width math.
+ * TSP `tree` of a JSON value: containers that fit {@link JSON_TREE_INLINE_LEN}
+ * become `key: [1, "a"]` leaves, larger ones expandable nodes labelled with
+ * their key and size, scalars `key: value` leaves styled by type. Bounded by
+ * depth, node count and scalar length; no width math.
  */
 export declare function describeJsonTree(value: unknown, options?: JsonTreeDescribeOptions): NativeNode;
+/** Options of {@link describeJsonValue}: the `json` node's own, plus the fallback tree's. */
+export interface JsonValueDescribeOptions extends JsonTreeDescribeOptions {
+    /** The host draws the `json` kind (`cx.supports("json")`). */
+    native?: boolean;
+    /** `json` node: container levels expanded below the top-level entries (default 0). */
+    open?: number;
+}
+/**
+ * A JSON value for a TSP host: the terminal's own `json` viewer when it draws
+ * the kind, which folds and previews containers itself and never cuts (so
+ * `onTruncated` never fires), else {@link describeJsonTree} with the same
+ * options. Root keys the tree would hide are left out of the sent value too;
+ * strings are sanitized like the tree's labels.
+ */
+export declare function describeJsonValue(value: unknown, options?: JsonValueDescribeOptions): NativeNode;

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

@@ -31,6 +31,8 @@ export interface FileDiagnosticsResult {
     summary: string;
     /** Whether there are any errors (severity 1) */
     errored: boolean;
+    /** Servers that sent no fresh report in time: the file is unverified for them, not clean. */
+    unreported?: string[];
     /** Whether the file was formatted */
     formatter?: FileFormatResult;
 }

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

@@ -23,11 +23,12 @@ export declare function renderMCPResult(result: {
     isError?: boolean;
 }, options: RenderResultOptions, theme: Theme, args?: Record<string, unknown>): Component;
 /** Native MCP call view: the head plus the folded args, inline while pending. */
-export declare function describeMCPCall(args: Record<string, unknown>, label: string): NativeToolView;
+export declare function describeMCPCall(args: Record<string, unknown>, label: string, options?: RenderResultOptions): NativeToolView;
 /**
- * Native MCP result view: JSON output as a JSON tree, Markdown when the
- * preference is on, otherwise the raw text as tool output; the folded Args
- * section follows, so the collapsed preview still leads with the output.
+ * Native MCP result view: JSON output as the host's `json` viewer (when it
+ * draws one) or a JSON tree, Markdown when the preference is on, otherwise
+ * the raw text as tool output; the folded Args section follows, so the
+ * collapsed preview still leads with the output.
  */
 export declare function describeMCPResult(result: {
     content: Array<{
@@ -36,7 +37,7 @@ export declare function describeMCPResult(result: {
     }>;
     details?: MCPToolDetails;
     isError?: boolean;
-}, _options: RenderResultOptions, args?: Record<string, unknown>): NativeToolView | undefined;
+}, options: RenderResultOptions, args?: Record<string, unknown>): NativeToolView | undefined;
 import type { OutputMeta } from "./output-meta.js";
 /** Set whether plain MCP text results render as Markdown. */
 export declare function setMcpRenderMarkdownResults(enabled: boolean): void;

package/dist/types/tools/native-view.d.ts

@@ -6,7 +6,7 @@ import { type OutputMeta } from "./output-meta.js";
 import type { NativeToolHead, NativeToolView, ToolRenderResult } from "./renderer.js";
 /** A path for native heads: relative to the working directory when inside it, else `~`-shortened. */
 export declare function displayPath(filePath: string): string;
-/** `file://` link for a head's path target, when the path is absolute. */
+/** Configured file link for a head's path target, when the path is absolute. */
 export declare function fileHref(filePath: string | undefined): string | undefined;
 /** Diff stats as one head `meta` string, `+8 −1` (U+2212 minus), or undefined when nothing changed. */
 export declare function diffStatsMeta(added: number, removed: number): string | undefined;

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

@@ -36,6 +36,8 @@ export interface RenderResultOptions {
     cancelled?: boolean;
     /** The native host shows files by path (`cx.supports("media")`). Native describe hooks only. */
     media?: boolean;
+    /** The native host draws raw JSON values (`cx.supports("json")`). Native describe hooks only. */
+    json?: boolean;
 }
 /** Render options for a result, plus the tool-specific context the transcript threads through. */
 export type RenderResultContextOptions = RenderResultOptions & {

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

@@ -177,6 +177,17 @@ export declare function truncateLineBytes(line: string, maxBytes?: number): {
     text: string;
     wasTruncated: boolean;
 };
+/**
+ * Where `text` shows in `output` written through an {@link OutputSink} with
+ * `maxColumns`, searching from `from`: each of its lines whole, or, where the
+ * cap cut the output line, a head of it and `…` ending that output line.
+ * Only the first line can be cut short of its first 16 characters (after
+ * other text on its output line); such text is not found.
+ */
+export declare function findColumnCapped(output: string, text: string, from?: number): {
+    start: number;
+    end: number;
+} | undefined;
 /** Shared helper to build a no-truncation result. */
 export declare function noTruncResult(content: string, totalLines?: number, totalBytes?: number): TruncationResult;
 /**

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

@@ -106,8 +106,9 @@ export interface TaskItem {
     sourceSession?: string;
     /** Optional model selector override for the historical source session. */
     model?: string | string[];
-    /** The work; required by the schema. */
+    /** Inline instructions; exactly one of task or taskFile is required. */
     task?: string;
+    taskFile?: string;
     /** How open-ended the work is; required by the schema and the child's sole `auto` thinking classification input. */
     solutionSpace?: string;
     /** Per-spawn thinking effort: lowest/middle/highest level the resolved model supports. Overrides the agent's default selector (e.g. `auto`). */
@@ -138,6 +139,8 @@ export interface TaskParams {
     model?: string | string[];
     /** The work (flat form). */
     task?: string;
+    /** Absolute path or local:// URL to a UTF-8 file (flat form), mutually exclusive with task. */
+    taskFile?: string;
     /** How open-ended the work is (flat form); see {@link TaskItem.solutionSpace}. */
     solutionSpace?: string;
     /** Per-spawn thinking effort (flat form): lowest/middle/highest level the resolved model supports. */
@@ -213,6 +216,9 @@ export interface AgentProgress {
     status: "pending" | "running" | "completed" | "failed" | "aborted";
     task: string;
     assignment?: string;
+    taskFile?: string;
+    /** SHA-256 of the exact task file bytes before decoding and trimming. */
+    taskFileSha256?: string;
     description?: string;
     lastIntent?: string;
     currentTool?: string;
@@ -320,6 +326,8 @@ export interface SingleResult {
     agentSource: AgentSource;
     task: string;
     assignment?: string;
+    taskFile?: string;
+    taskFileSha256?: string;
     description?: string;
     lastIntent?: string;
     exitCode: number;

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

@@ -4,6 +4,15 @@
  * selector peeling and transcript renderers consult it instead of hardcoding
  * scheme names.
  */
+/**
+ * Mutation class of a writable scheme; drives plan-mode and device-only `write` gates.
+ * - `workspace`: mutates user/external state; blocked in plan mode and device-only sessions.
+ * - `sandbox`: session scratch space (local://); allowed in plan mode and device-only sessions.
+ * - `coordination`: peer messaging (agent://); always allowed. `SchemeWritePolicy.cancels` grants the same per URL.
+ * - `device`: tool-device dispatch (xd://); always allowed, the device enforces its own policy.
+ * - `reply`: a message to the user (out://); always allowed, and transcripts draw the content as assistant prose.
+ */
+export type SchemeWriteScope = "workspace" | "sandbox" | "coordination" | "device" | "reply";
 /** 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. */
@@ -12,16 +21,24 @@ export interface InternalUrlSchemeSpec {
     readonly portAuthority?: boolean;
     /** Read cards collapse into the compact read group like plain files instead of expanding. */
     readonly compactTranscript?: boolean;
+    /** Write policy; absent on read-only schemes. Transcripts draw `reply`-scoped writes as assistant prose. */
+    readonly write?: {
+        readonly scope: SchemeWriteScope;
+    };
 }
 /** 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;
+    /** Declared specs of every registered scheme, keyed by lowercased scheme. */
+    specs(): ReadonlyMap<string, InternalUrlSchemeSpec>;
 }
 /** 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;
+/** Declared specs of every registered scheme, keyed by lowercased scheme; empty when no host is installed. */
+export declare function internalUrlSchemeSpecs(): ReadonlyMap<string, InternalUrlSchemeSpec>;
 /** Split a hierarchical `scheme://rest` URL into its lowercased scheme and the text after `://`. */
 export declare function splitUrlScheme(input: string): {
     scheme: string;

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

@@ -15,7 +15,7 @@ export declare const yieldToolRenderer: {
     renderCall(args: YieldRenderArgs, options: RenderResultOptions, theme: Theme): Component;
     renderResult(result: ToolRenderResult<YieldItem>, options: RenderResultContextOptions, theme: Theme, args?: YieldRenderArgs): Component;
     describeCall(args: YieldRenderArgs, options: RenderResultOptions): NativeToolView;
-    describeResult(result: ToolRenderResult<YieldItem>, _options: RenderResultContextOptions, args?: YieldRenderArgs): NativeToolView;
+    describeResult(result: ToolRenderResult<YieldItem>, options: RenderResultContextOptions, args?: YieldRenderArgs): NativeToolView;
     mergeCallAndResult: true;
     animatedPendingPreview: true;
 };

package/dist/types/tui.d.ts

@@ -80,7 +80,9 @@ export interface TUIStartOptions {
      * switches to raw input and replays the kernel-buffered keystrokes.
      *
      * A terminal expected to speak TSP needs raw input from the start, so it
-     * gets it; its keystrokes are held instead (TSP events and the cell-size
+     * gets it. Plain typing (printable text, Backspace) still edits the focused
+     * component live, as the kernel echo shows it elsewhere; the first other key
+     * and every key after it are held instead (TSP events and the cell-size
      * reply still apply) until {@link TUI.releaseHeldInput} replays them.
      */
     deferInput?: boolean;
@@ -507,7 +509,10 @@ export declare class TUI extends Container {
      * never come.
      */
     addStartListener(listener: StartListener): () => void;
-    addInputListener(listener: InputListener): () => void;
+    /** Registers a key listener; `prepend` gives a foreground input owner first refusal over global shortcuts. */
+    addInputListener(listener: InputListener, options?: {
+        prepend?: boolean;
+    }): () => void;
     removeInputListener(listener: InputListener): void;
     stop(): void;
     /**

package/package.json

@@ -1,7 +1,7 @@
 {
 	"type": "module",
 	"name": "@oh-my-pi/pi-tui",
-	"version": "18.13.2",
+	"version": "18.14.0",
 	"description": "Terminal User Interface library with differential rendering for efficient text-based applications",
 	"homepage": "https://omp.sh",
 	"author": {
@@ -41,27 +41,26 @@
 		"gen:glyphs": "bun scripts/gen-glyphs.ts"
 	},
 	"dependencies": {
-		"@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"
+		"@oh-my-pi/omptype": "18.14.0",
+		"@oh-my-pi/pi-agent-core": "18.14.0",
+		"@oh-my-pi/pi-ai": "18.14.0",
+		"@oh-my-pi/pi-catalog": "18.14.0",
+		"@oh-my-pi/pi-natives": "18.14.0",
+		"@oh-my-pi/pi-utils": "18.14.0",
+		"@oh-my-pi/pi-wire": "18.14.0",
+		"@oh-my-pi/snapcompact": "18.14.0"
 	},
 	"devDependencies": {
 		"kitty-vt-wasm": "^0.2.0"
 	},
 	"engines": {
-		"bun": ">=1.3.14"
+		"bun": ">=1.4.4"
 	},
 	"files": [
 		"src",
 		"README.md",
 		"CHANGELOG.md",
 		"LICENSE",
-		"THIRD-PARTY-NOTICES.txt",
 		"dist/types"
 	],
 	"exports": {
@@ -73,10 +72,6 @@
 			"types": "./dist/types/theme/index.d.ts",
 			"import": "./src/theme/index.ts"
 		},
-		"./theme/defaults": {
-			"types": "./dist/types/theme/defaults/index.d.ts",
-			"import": "./src/theme/defaults/index.ts"
-		},
 		"./theme/*": {
 			"types": "./dist/types/theme/*.d.ts",
 			"import": "./src/theme/*.ts"