@oh-my-pi/pi-coding-agent 17.0.8 → 17.1.0

package/dist/types/live/visualizer.d.ts

@@ -0,0 +1,33 @@
+import { type Component } from "@oh-my-pi/pi-tui";
+/** Distinct states of a realtime call connection. */
+export type LivePhase = "connecting" | "listening" | "working" | "speaking" | "muted" | "error";
+/** A transcribed turn in the realtime call. */
+export interface LiveTranscript {
+    role: "user" | "assistant";
+    text: string;
+}
+/** Configuration callbacks for user interactions in the visualizer. */
+export interface LiveVisualizerOptions {
+    onStop(): void;
+    onToggleMute(): void;
+}
+/** A compact, fixed-height terminal component for displaying a realtime call. */
+export declare class LiveVisualizer implements Component {
+    #private;
+    readonly wantsKeyRelease = false;
+    constructor(options: LiveVisualizerOptions);
+    /** Updates the current call phase. */
+    setPhase(phase: LivePhase): void;
+    /** Updates the current input and output volume levels (0..1). */
+    setLevels(input: number, output: number): void;
+    /** Updates the latest transcript fragment. */
+    setTranscript(transcript: LiveTranscript | undefined): void;
+    /** Updates the animation frame for spinners and waveforms. */
+    setFrame(frame: number): void;
+    /** Processes user keypresses. */
+    handleInput(data: string): void;
+    /** Clears the render cache. */
+    invalidate(): void;
+    /** Renders the visualizer into a fixed array of rows at the given width. */
+    render(width: number): readonly string[];
+}

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

@@ -30,6 +30,8 @@ export declare const WARMUP_TIMEOUT_MS = 5000;
  *   timeout/cancel instead of falling back to the internal 30s default.
  */
 export declare function getOrCreateClient(config: ServerConfig, cwd: string, initTimeoutMs?: number, signal?: AbortSignal): Promise<LspClient>;
+/** Return an active or already-starting client without starting a language server. */
+export declare function getActiveOrPendingClient(config: ServerConfig, cwd: string, signal?: AbortSignal): Promise<LspClient | undefined>;
 /**
  * Ensure a file is opened in the LSP client.
  * Sends didOpen notification if the file is not already tracked.
@@ -67,10 +69,25 @@ export declare function notifyWorkspaceWatchedFiles(cwd: string, changes: readon
  * Increments version, sends didChange and didSave notifications.
  */
 export declare function refreshFile(client: LspClient, filePath: string, signal?: AbortSignal): Promise<void>;
+/**
+ * Tear down a specific client instance using the LSP shutdown/exit handshake.
+ *
+ * Removes the client from the registry by identity first (never evicting a
+ * newer client already republished under the same key), then performs a bounded
+ * graceful shutdown, force-killing and awaiting confirmed process exit.
+ *
+ * @returns `true` once the process is confirmed exited, `false` if it outlived
+ * the shutdown budget — callers reporting a restart must treat `false` as a
+ * failed teardown, not a completed restart.
+ */
+export declare function shutdownClientInstance(client: LspClient): Promise<boolean>;
 /**
  * Shutdown a specific client by key.
+ *
+ * @returns `true` when the client is gone (already absent or confirmed exited),
+ * `false` if a live process outlived the shutdown budget.
  */
-export declare function shutdownClient(key: string): Promise<void>;
+export declare function shutdownClient(key: string): Promise<boolean>;
 /**
  * Send an LSP request and wait for response.
  *

package/dist/types/mcp/config-writer.test.d.ts

@@ -0,0 +1 @@
+export {};

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

@@ -5,7 +5,7 @@ import { type AuthStorage } from "../session/auth-storage.js";
 import type { McpConnectionStatusEvent } from "./startup-events.js";
 import type { MCPToolDetails } from "./tool-bridge.js";
 import type { MCPToolCache } from "./tool-cache.js";
-import type { MCPGetPromptResult, MCPPrompt, MCPRequestOptions, MCPResource, MCPResourceReadResult, MCPResourceTemplate, MCPServerConfig, MCPServerConnection } from "./types.js";
+import type { MCPAuthChallenge, MCPGetPromptResult, MCPPrompt, MCPRequestOptions, MCPResource, MCPResourceReadResult, MCPResourceTemplate, MCPServerConfig, MCPServerConnection } from "./types.js";
 /**
  * Stable, total ordering on MCP tools by name.
  *
@@ -42,6 +42,8 @@ export interface MCPDiscoverOptions {
     /** Called when MCP server connection state changes. */
     onStatus?: (event: McpConnectionStatusEvent) => void;
 }
+/** Handles an MCP `WWW-Authenticate` challenge and returns refreshed config. */
+export type MCPAuthHandler = (serverName: string, challenge: MCPAuthChallenge) => Promise<MCPServerConfig | undefined>;
 /**
  * MCP Server Manager.
  *
@@ -79,6 +81,8 @@ export declare class MCPManager {
      * Set the auth storage for resolving OAuth credentials.
      */
     setAuthStorage(authStorage: AuthStorage): void;
+    /** Set the callback used to complete OAuth after a tool-level auth challenge. */
+    setAuthHandler(handler: MCPAuthHandler | undefined): void;
     /**
      * Discover and connect to all MCP servers from .mcp.json files.
      * Returns tools and any connection errors.
@@ -149,7 +153,6 @@ export declare class MCPManager {
      * the same server share one reconnection attempt. Returns the new
      * connection, or `null` if reconnection failed or the per-server crash
      * burst limit (see {@link RECONNECT_BURST_LIMIT}) is exceeded.
-     *
      * @param options.manual - When `true`, resets the crash-burst window so a
      *   user-driven retry (e.g. `/mcp reconnect`) is never blocked by an
      *   earlier storm. Defaults to `false`; the transport `onClose` callback
@@ -157,6 +160,7 @@ export declare class MCPManager {
      */
     reconnectServer(name: string, options?: {
         manual?: boolean;
+        authChallenge?: MCPAuthChallenge;
     }): Promise<MCPServerConnection | null>;
     /**
      * Refresh tools from a specific server.

package/dist/types/mcp/oauth-discovery.d.ts

@@ -55,6 +55,7 @@ export declare function analyzeAuthError(error: Error, serverUrl?: string): Auth
  */
 export declare function fetchResourceMetadataScopes(resourceMetadataUrl: string, opts?: {
     fetch?: FetchImpl;
+    signal?: AbortSignal;
 }): Promise<string | undefined>;
 /**
  * Try to discover OAuth endpoints by querying the server's well-known endpoints.
@@ -64,4 +65,5 @@ export declare function discoverOAuthEndpoints(serverUrl: string, authServerUrl?
     fetch?: FetchImpl;
     protectedResource?: string;
     protectedScopes?: string;
+    signal?: AbortSignal;
 }): Promise<OAuthEndpoints | null>;

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

@@ -4,9 +4,9 @@
  * Provides structured display of MCP tool calls and results,
  * showing args and output in JSON tree format similar to task tool.
  */
-import type { Component } from "@oh-my-pi/pi-tui";
+import { type Component } from "@oh-my-pi/pi-tui";
 import type { RenderResultOptions } from "../extensibility/custom-tools/types.js";
-import type { Theme } from "../modes/theme/theme.js";
+import { type Theme } from "../modes/theme/theme.js";
 import type { MCPToolDetails } from "./tool-bridge.js";
 /**
  * Render MCP tool call.

package/dist/types/mcp/smithery-auth.d.ts

@@ -2,7 +2,7 @@ type SmitheryCliAuthSession = {
     sessionId: string;
     authUrl: string;
 };
-type SmitheryCliPollResponse = {
+export type SmitheryCliPollResponse = {
     status: "pending" | "success" | "error";
     apiKey?: string;
     message?: string;

package/dist/types/mcp/smithery-auth.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/types/mcp/tool-bridge.d.ts

@@ -9,9 +9,11 @@ import type { SourceMeta } from "../capability/types.js";
 import type { CustomTool, CustomToolContext, CustomToolResult, RenderResultOptions } from "../extensibility/custom-tools/types.js";
 import type { Theme } from "../modes/theme/theme.js";
 import type { OutputMeta } from "../tools/output-meta.js";
-import type { MCPContent, MCPServerConnection, MCPToolDefinition } from "./types.js";
-/** Reconnect callback: tears down stale connection, returns new one or null. */
-export type MCPReconnect = () => Promise<MCPServerConnection | null>;
+import type { MCPAuthChallenge, MCPContent, MCPServerConnection, MCPToolDefinition } from "./types.js";
+/** Reconnect callback: tears down a stale connection, optionally authorizing first. */
+export type MCPReconnect = (options?: {
+    authChallenge?: MCPAuthChallenge;
+}) => Promise<MCPServerConnection | null>;
 export declare function isRetriableConnectionError(error: unknown): boolean;
 /** Details included in MCP tool results for rendering */
 export interface MCPToolDetails {
@@ -23,6 +25,8 @@ export interface MCPToolDetails {
     isError?: boolean;
     /** Raw content from MCP response */
     rawContent?: MCPContent[];
+    /** Structured metadata from the MCP response */
+    mcpMeta?: Record<string, unknown>;
     /** Provider ID (e.g., "claude", "mcp-json") */
     provider?: string;
     /** Provider display name (e.g., "Claude Code", "MCP Config") */

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

@@ -175,10 +175,16 @@ export interface MCPResourceContent {
     };
 }
 export type MCPContent = MCPTextContent | MCPImageContent | MCPResourceContent;
+/** Structured authentication challenge returned in a tool result. */
+export interface MCPAuthChallenge {
+    /** Values from `_meta["mcp/www_authenticate"]`. */
+    readonly wwwAuthenticate: readonly string[];
+}
 /** tools/call response */
 export interface MCPToolCallResult {
     content: MCPContent[];
     isError?: boolean;
+    _meta?: Record<string, unknown>;
 }
 export interface MCPRequestOptions {
     /** Abort signal (e.g. Escape-to-interrupt) */

package/dist/types/memory-backend/tool-names.d.ts

@@ -0,0 +1,2 @@
+/** Built-in tools whose availability depends on the selected memory backend. */
+export declare const MEMORY_BACKEND_TOOL_NAMES: readonly ["retain", "recall", "reflect", "memory_edit", "learn"];

package/dist/types/modes/components/login-dialog.d.ts

@@ -15,8 +15,8 @@ export declare class LoginDialogComponent extends Container {
      * is offered as an additional local shortcut so narrow local terminals still
      * have a truncation-safe copy target (viewport clipping on a long authorize
      * URL silently drops trailing OAuth query parameters — e.g.
-     * `code_challenge_method=S256`). The OSC 8 hyperlink carries the full URL
-     * for terminals that support click-through.
+     * `code_challenge_method=S256`). Every physical URL row carries its own OSC 8
+     * link to the full URL, so clicking any wrapped fragment opens the same target.
      */
     showAuth(url: string, instructions?: string, launchUrl?: string): void;
     /**

package/dist/types/modes/components/oauth-selector.d.ts

@@ -10,6 +10,14 @@ export declare class OAuthSelectorComponent extends Container {
         requestRender?: () => void;
     });
     stopValidation(): void;
+    /**
+     * Fit the selector into `lines` rendered rows by shrinking the visible list
+     * window (the window is centered on the selection, so the selected row is
+     * always visible at any height). Prefers keeping the full chrome — borders,
+     * spacers, title, search status — but sacrifices the trailing spacer/border
+     * (clipped by the host) before dropping below three visible rows.
+     */
+    setMaxHeight(lines: number): void;
     handleInput(keyData: string): void;
     /** Move the selection one step for a wheel notch (clamped, no wrap). */
     handleWheel(delta: -1 | 1): void;

package/dist/types/modes/components/plan-review-overlay.d.ts

@@ -18,6 +18,28 @@
  */
 import { type Component } from "@oh-my-pi/pi-tui";
 import type { HookSelectorSlider } from "./hook-selector.js";
+/** Serializable annotations retained by the plan-review owner between overlays. */
+export interface PlanReviewAnnotationState {
+    annotations: Array<{
+        section: {
+            index: number;
+            title: string;
+            /** Heading ancestry from the document root, when emitted by this overlay. */
+            path?: string[];
+            /** Hash of the section source, used to reject ambiguous moved headings. */
+            contentHash?: string;
+        };
+        target: {
+            kind: "section";
+        } | {
+            kind: "line";
+            row: number;
+            context: string;
+            contextTruncated?: boolean;
+        };
+        note: string;
+    }>;
+}
 export interface PlanReviewOverlayCallbacks {
     /** Invoked with the chosen option label (never a disabled one). */
     onPick: (label: string) => void;
@@ -33,6 +55,8 @@ export interface PlanReviewOverlayCallbacks {
     onPlanEdited?: (content: string) => void;
     /** Invoked with the Refine feedback markdown whenever annotations change. */
     onFeedbackChange?: (feedback: string) => void;
+    /** Invoked with a serializable annotation snapshot whenever annotations change. */
+    onAnnotationStateChange?: (state: PlanReviewAnnotationState) => void;
 }
 export interface PlanReviewOverlayOptions {
     /** Prompt rendered above the options (e.g. "Plan mode - next step"). */
@@ -48,6 +72,8 @@ export interface PlanReviewOverlayOptions {
     slider?: HookSelectorSlider;
     /** Display label for the external-editor key, surfaced in the footer help. */
     externalEditorLabel?: string;
+    /** Serializable annotations restored into this overlay instance. */
+    annotationState?: PlanReviewAnnotationState;
 }
 export declare class PlanReviewOverlay implements Component {
     #private;

package/dist/types/modes/components/settings-defs.d.ts

@@ -40,11 +40,18 @@ export interface SubmenuSettingDef extends BaseSettingDef {
 }
 export interface TextInputSettingDef extends BaseSettingDef {
     type: "text";
+    secret: boolean;
 }
 export interface ProviderLimitsSettingDef extends BaseSettingDef {
     type: "providerLimits";
 }
-export type SettingDef = BooleanSettingDef | EnumSettingDef | SubmenuSettingDef | TextInputSettingDef | ProviderLimitsSettingDef;
+/** Array-of-enum setting edited as a toggle list; `ordered` lists render positions and support reordering. */
+export interface MultiSelectSettingDef extends BaseSettingDef {
+    type: "multiselect";
+    options: OptionList;
+    ordered: boolean;
+}
+export type SettingDef = BooleanSettingDef | EnumSettingDef | SubmenuSettingDef | TextInputSettingDef | ProviderLimitsSettingDef | MultiSelectSettingDef;
 /** Get all setting definitions with UI */
 export declare function getAllSettingDefs(): SettingDef[];
 /**

package/dist/types/modes/components/status-line/component.jj-cache.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/types/modes/components/tool-execution.d.ts

@@ -92,7 +92,15 @@ export declare class ToolExecutionComponent extends Container implements NativeS
      * immutable native scrollback before the result replaces them.
      */
     getNativeScrollbackLiveRegionStart(): number | undefined;
-    /** Keeps the in-flight `vibe_wait` TV wall out of immutable native scrollback. */
+    /**
+     * Keeps in-flight TV-wall frames out of immutable native scrollback: the
+     * `vibe_wait` wall and displaceable snapshots (`hub` waiting polls, `todo`
+     * lists). Their frames replace each other rather than append, and their
+     * rows mutate every spinner tick — an unpinned commit records a per-tick
+     * frozen snapshot AND force-seals the block (see TranscriptContainer's
+     * committed-snapshot seal), so the next poll stacks a new frame instead of
+     * displacing this one.
+     */
     isNativeScrollbackLiveRegionPinned(): boolean;
     /**
      * Whether this block has reached a terminal state for transcript freezing.

package/dist/types/modes/controllers/command-controller.d.ts

@@ -60,4 +60,4 @@ export declare function renderProviderSection(details: ProviderDetails, uiTheme:
  * Example output: `Quota: 7d window · 67% used · resets in 3.2d`
  */
 export declare function formatCompactQuota(provider: string, reports: UsageReport[], nowMs: number, activeAccount?: OAuthAccountIdentity): string | null;
-export declare function renderUsageReports(reports: UsageReport[], uiTheme: typeof theme, nowMs: number, availableWidth: number, resolveActiveAccount?: (provider: string) => OAuthAccountIdentity | undefined): string;
+export declare function renderUsageReports(reports: UsageReport[], uiTheme: typeof theme, nowMs: number, availableWidth: number, resolveActiveAccount?: (provider: string) => OAuthAccountIdentity | undefined, usageModelSelectors?: readonly string[]): string;

package/dist/types/modes/controllers/event-controller.d.ts

@@ -24,5 +24,10 @@ export declare class EventController {
      * Drops the candidate when it is no longer a displaceable todo.
      */
     inheritDisplaceableTodo(component: ToolExecutionComponent | null | undefined): void;
-    sendCompletionNotification(): void;
+    sendErrorNotification(event: Extract<AgentSessionEvent, {
+        type: "agent_end";
+    }>): void;
+    sendCompletionNotification(event: Extract<AgentSessionEvent, {
+        type: "agent_end";
+    }>): void;
 }

package/dist/types/modes/controllers/live-command-controller.d.ts

@@ -0,0 +1,14 @@
+import type { InteractiveModeContext } from "../types.js";
+/** Owns the editor-replacing visualizer and realtime session lifecycle for `/live`. */
+export declare class LiveCommandController {
+    #private;
+    constructor(ctx: InteractiveModeContext);
+    /** Whether a live session is connected, connecting, or closing. */
+    get active(): boolean;
+    /** Start live mode, or stop the currently active session. */
+    handleCommand(): Promise<void>;
+    /** Stop the active live session and restore the editor. */
+    stop(): Promise<void>;
+    /** Release UI resources during synchronous InteractiveMode teardown. */
+    dispose(): void;
+}

package/dist/types/modes/controllers/mcp-command-controller.d.ts

@@ -1,4 +1,5 @@
 import { type Component } from "@oh-my-pi/pi-tui";
+import type { MCPAuthChallenge, MCPServerConfig } from "../../mcp/types.js";
 import type { InteractiveModeContext } from "../types.js";
 /**
  * Renders the MCP OAuth fallback URL. Always shows the full authorization URL
@@ -41,4 +42,6 @@ export declare class MCPCommandController {
      * Handle /mcp command and route to subcommands
      */
     handle(text: string): Promise<void>;
+    /** Reauthorize a server after a tool-level OAuth challenge. */
+    handleMCPAuthChallenge(name: string, challenge: MCPAuthChallenge): Promise<MCPServerConfig | undefined>;
 }

package/dist/types/modes/interactive-mode.d.ts

@@ -27,6 +27,7 @@ import type { EvalExecutionComponent } from "./components/eval-execution.js";
 import type { HookEditorComponent } from "./components/hook-editor.js";
 import type { HookInputComponent } from "./components/hook-input.js";
 import type { HookSelectorComponent, HookSelectorSlider } from "./components/hook-selector.js";
+import { type PlanReviewAnnotationState } from "./components/plan-review-overlay.js";
 import { StatusLineComponent } from "./components/status-line/index.js";
 import type { ToolExecutionHandle } from "./components/tool-execution.js";
 import { TranscriptContainer } from "./components/transcript-container.js";
@@ -247,6 +248,8 @@ export declare class InteractiveMode implements InteractiveModeContext {
         onExternalEditor?: () => void;
         onPlanEdited?: (content: string) => void;
         onFeedbackChange?: (feedback: string) => void;
+        annotationState?: PlanReviewAnnotationState;
+        onAnnotationStateChange?: (state: PlanReviewAnnotationState) => void;
         initialIndex?: number;
     }, extra?: {
         slider?: HookSelectorSlider;
@@ -340,6 +343,8 @@ export declare class InteractiveMode implements InteractiveModeContext {
     handleRenameCommand(title: string): Promise<void>;
     handleMemoryCommand(text: string): Promise<void>;
     handleSTTToggle(): Promise<void>;
+    /** Start or stop the Codex-backed realtime voice surface. */
+    handleLiveCommand(): Promise<void>;
     showDebugSelector(): Promise<void>;
     showAgentHub(options?: {
         requireContent?: boolean;

package/dist/types/modes/rpc/rpc-client.d.ts

@@ -8,6 +8,7 @@ import type { CompactionResult } from "@oh-my-pi/pi-agent-core/compaction";
 import type { ImageContent, Model } from "@oh-my-pi/pi-ai";
 import type { BashResult } from "../../exec/bash-executor.js";
 import type { AgentSessionEvent, SessionStats } from "../../session/agent-session.js";
+import { type RpcMessagesPage, type RpcMessagesPageOptions } from "./rpc-messages.js";
 import type { RpcAvailableSlashCommand, RpcHandoffResult, RpcHostToolDefinition, RpcSessionState, RpcSubagentEventFrame, RpcSubagentLifecycleFrame, RpcSubagentMessagesResult, RpcSubagentProgressFrame, RpcSubagentSnapshot, RpcSubagentSubscriptionLevel } from "./rpc-types.js";
 export interface RpcClientOptions {
     /** Path to the CLI entry point (default: searches for dist/cli.js) */
@@ -45,6 +46,12 @@ export interface RpcClientCustomTool<TParams extends Record<string, unknown> = R
     execute(params: TParams, context: RpcClientToolContext<TDetails>): Promise<RpcClientToolResult<TDetails>> | RpcClientToolResult<TDetails>;
 }
 export declare function defineRpcClientTool<TParams extends Record<string, unknown> = Record<string, unknown>, TDetails = unknown>(tool: RpcClientCustomTool<TParams, TDetails>): RpcClientCustomTool<TParams, TDetails>;
+/** Failed RPC command; `code` mirrors the server's machine-readable error code when present. */
+export declare class RpcCommandError extends Error {
+    readonly command: string;
+    readonly code?: string | undefined;
+    constructor(message: string, command: string, code?: string | undefined);
+}
 export declare class RpcClient {
     #private;
     private options;
@@ -254,8 +261,10 @@ export declare class RpcClient {
      */
     getLastAssistantText(): Promise<string | null>;
     /**
-     * Get all messages in the session.
+     * Get one stable, byte-bounded message page.
      */
+    getMessagesPage(options?: RpcMessagesPageOptions): Promise<RpcMessagesPage>;
+    /** Get all messages, draining stable pages when protocol v2 is available. */
     getMessages(): Promise<AgentMessage[]>;
     /**
      * Get list of OAuth providers available for login, with their current authentication status.

package/dist/types/modes/rpc/rpc-frame.d.ts

@@ -1,9 +1,25 @@
 /** Maximum UTF-8 size of one newline-delimited RPC frame, including the newline. */
 export declare const MAX_RPC_FRAME_BYTES: number;
+/** Maximum UTF-8 size of one logical frame reassembled by protocol v2. */
+export declare const MAX_RPC_REASSEMBLED_BYTES: number;
+export type RpcProtocolVersion = 1 | 2;
+/** Reassemble protocol v2 chunk frames after each JSONL line has been parsed. */
+export declare class RpcFrameDecoder {
+    #private;
+    push(value: unknown): object | undefined;
+}
 /** Serialize a complete JSONL frame while enforcing the transport byte ceiling. */
 export declare function encodeRpcFrame(frame: object, streamedMessageCount?: number, streamedMessages?: readonly unknown[]): string;
 /** Stateful encoder that tracks which messages a client has already received. */
 export declare class RpcFrameEncoder {
     #private;
+    setProtocolVersion(version: number): void;
+    /**
+     * Encode one logical frame into physical JSONL lines. Encoder bookkeeping runs
+     * eagerly; only chunk emission is lazy, so a chunked result can be streamed to
+     * stdout with backpressure without holding the whole transport in memory. The
+     * returned iterable MUST be fully consumed exactly once.
+     */
+    encodeFrames(frame: object): Iterable<string>;
     encode(frame: object): string;
 }

package/dist/types/modes/rpc/rpc-messages.d.ts

@@ -0,0 +1,26 @@
+import type { AgentMessage } from "@oh-my-pi/pi-agent-core";
+export declare const RPC_MESSAGES_PAGE_BUSY_ERROR = "Cannot page messages while the session is changing";
+export declare const RPC_MESSAGES_PAGE_STALE_ERROR = "RPC message cursor is stale";
+/** Machine-readable reasons a `get_messages_page` request can fail; carried as `code` on the error response. */
+export type RpcMessagesPageErrorCode = "session_busy" | "stale_cursor";
+/** Paging failure that maps to a structured wire `code`, so clients can react without matching message text. */
+export declare class RpcMessagesPageError extends Error {
+    readonly code: RpcMessagesPageErrorCode;
+    constructor(message: string, code: RpcMessagesPageErrorCode);
+}
+export interface RpcMessageSnapshot {
+    sessionId: string;
+    leafId: string | null;
+    messageCount: number;
+}
+export interface RpcMessagesPage {
+    messages: AgentMessage[];
+    nextCursor?: string;
+    totalMessages: number;
+}
+export interface RpcMessagesPageOptions {
+    cursor?: string;
+    limit?: number;
+}
+/** Page one stable in-memory message snapshot without crossing the v1 frame budget. */
+export declare function pageRpcMessages(messages: readonly AgentMessage[], snapshot: RpcMessageSnapshot, options?: RpcMessagesPageOptions): RpcMessagesPage;

package/dist/types/modes/rpc/rpc-types.d.ts

@@ -14,7 +14,12 @@ import type { FileEntry } from "../../session/session-entries.js";
 import type { AvailableSlashCommandSource } from "../../slash-commands/available-commands.js";
 import type { AgentProgress, SubagentEventPayload, SubagentLifecyclePayload, SubagentProgressPayload } from "../../task/index.js";
 import type { TodoPhase } from "../../tools/todo.js";
+import type { RpcMessagesPage } from "./rpc-messages.js";
 export type RpcCommand = {
+    id?: string;
+    type: "negotiate_protocol";
+    protocolVersion: number;
+} | {
     id?: string;
     type: "prompt";
     message: string;
@@ -157,6 +162,11 @@ export type RpcCommand = {
 } | {
     id?: string;
     type: "get_messages";
+} | {
+    id?: string;
+    type: "get_messages_page";
+    cursor?: string;
+    limit?: number;
 } | {
     id?: string;
     type: "get_login_providers";
@@ -214,6 +224,21 @@ export interface RpcPromptResultFrame {
     id?: string;
     agentInvoked: boolean;
 }
+export interface RpcReadyFrame {
+    type: "ready";
+    protocolVersion: 1;
+    supportedProtocolVersions: [1, 2];
+    maxFrameBytes: number;
+    maxReassembledFrameBytes: number;
+}
+export interface RpcChunkFrame {
+    type: "rpc_chunk";
+    chunkId: string;
+    index: number;
+    count: number;
+    byteLength: number;
+    data: string;
+}
 export interface RpcHandoffResult {
     savedPath?: string;
 }
@@ -241,6 +266,14 @@ export interface RpcSubagentMessagesResult {
     messages: AgentMessage[];
 }
 export type RpcResponse = {
+    id?: string;
+    type: "response";
+    command: "negotiate_protocol";
+    success: true;
+    data: {
+        protocolVersion: 2;
+    };
+} | {
     id?: string;
     type: "response";
     command: "prompt";
@@ -489,6 +522,12 @@ export type RpcResponse = {
     data: {
         messages: AgentMessage[];
     };
+} | {
+    id?: string;
+    type: "response";
+    command: "get_messages_page";
+    success: true;
+    data: RpcMessagesPage;
 } | {
     id?: string;
     type: "response";
@@ -516,6 +555,7 @@ export type RpcResponse = {
     command: string;
     success: false;
     error: string;
+    code?: string;
 };
 export interface RpcSubagentLifecycleFrame {
     type: "subagent_lifecycle";

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

@@ -18,5 +18,5 @@ export declare class SignInTab implements SetupTab {
     handleInput(data: string): void;
     /** Forward mouse to the provider selector; pointer is inert during an active login or code prompt. */
     routeMouse(event: SgrMouseEvent, line: number, col: number): void;
-    render(width: number): readonly string[];
+    render(width: number, maxLines?: number): readonly string[];
 }

package/dist/types/modes/setup-wizard/scenes/types.d.ts

@@ -14,6 +14,13 @@ export interface SetupSceneController extends Component {
     onMount?(): void | Promise<void>;
     onUnmount?(): void;
     dispose?(): void;
+    /**
+     * Render the scene body. `maxLines` is the number of body rows the wizard
+     * will actually display (header and footer already subtracted); scenes
+     * shrink list windows and drop decorative chrome so the selected row stays
+     * inside the budget. Overflow beyond `maxLines` is clipped by the wizard.
+     */
+    render(width: number, maxLines?: number): readonly string[];
     /**
      * Route an SGR mouse report (tracking is on while the wizard holds the
      * alternate screen). `line`/`col` are 0-based within this controller's
@@ -34,7 +41,8 @@ export interface SetupTab {
      * login). The parent scene MUST NOT switch tabs or finish while modal.
      */
     readonly modal: boolean;
-    render(width: number): readonly string[];
+    /** See {@link SetupSceneController.render}: `maxLines` is the tab-local row budget. */
+    render(width: number, maxLines?: number): readonly string[];
     handleInput(data: string): void;
     invalidate(): void;
     /** Called when the tab becomes active (including initial mount). */

package/dist/types/modes/setup-wizard/scenes/web-search.d.ts

@@ -19,5 +19,5 @@ export declare class WebSearchTab implements SetupTab {
     routeMouse(event: SgrMouseEvent, line: number, _col: number): void;
     invalidate(): void;
     dispose(): void;
-    render(width: number): readonly string[];
+    render(width: number, maxLines?: number): readonly string[];
 }

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

@@ -1,7 +1,7 @@
 import type { ThinkingLevel } from "@oh-my-pi/pi-agent-core";
 import type { Effort } from "@oh-my-pi/pi-ai";
 import type { EditorTheme, MarkdownTheme, SelectListTheme, SettingsListTheme, SymbolTheme } from "@oh-my-pi/pi-tui";
-export { getLanguageFromPath } from "../../utils/lang-from-path.js";
+export { getLanguageFromPath, isMarkdownPath } from "../../utils/lang-from-path.js";
 export type SymbolPreset = "unicode" | "nerd" | "ascii";
 /**
  * All available symbol keys organized by category.

package/dist/types/modes/types.d.ts

@@ -61,7 +61,7 @@ export type SubmittedUserInput = {
     cancelled: boolean;
     started: boolean;
 };
-export type TodoStatus = "pending" | "in_progress" | "completed" | "abandoned";
+export type TodoStatus = "pending" | "in_progress" | "completed" | "abandoned" | "blocked";
 export type TodoItem = {
     content: string;
     status: TodoStatus;
@@ -334,6 +334,8 @@ export interface InteractiveModeContext {
     handleRenameCommand(title: string): Promise<void>;
     handleMemoryCommand(text: string): Promise<void>;
     handleSTTToggle(): Promise<void>;
+    /** Start or stop the Codex-backed realtime voice session. */
+    handleLiveCommand(): Promise<void>;
     executeCompaction(customInstructionsOrOptions?: string | CompactOptions, isAuto?: boolean): Promise<CompactionOutcome>;
     openInBrowser(urlOrPath: string): void;
     refreshSlashCommandState(cwd?: string): Promise<void>;