@oh-my-pi/pi-coding-agent 15.10.9 → 15.10.11

package/dist/types/extensibility/extensions/types.d.ts

@@ -9,7 +9,7 @@
  */
 import type { AgentMessage, AgentToolResult, AgentToolUpdateCallback, ThinkingLevel, ToolApproval } from "@oh-my-pi/pi-agent-core";
 import type { CompactionResult } from "@oh-my-pi/pi-agent-core/compaction";
-import type { Api, AssistantMessageEvent, AssistantMessageEventStream, Context, ImageContent, Model, ProviderResponseMetadata, SimpleStreamOptions, Static, TextContent, TSchema } from "@oh-my-pi/pi-ai";
+import type { Api, AssistantMessageEvent, AssistantMessageEventStream, Context, ImageContent, Model, ModelSpec, ProviderResponseMetadata, SimpleStreamOptions, Static, TextContent, TSchema } from "@oh-my-pi/pi-ai";
 import type { OAuthCredentials, OAuthLoginCallbacks } from "@oh-my-pi/pi-ai/oauth/types";
 import type * as piCodingAgent from "@oh-my-pi/pi-coding-agent";
 import type { AutocompleteItem, Component, EditorTheme, KeyId, TUI } from "@oh-my-pi/pi-tui";
@@ -680,7 +680,7 @@ export interface ExtensionAPI {
      *       id: "claude-sonnet-4@20250514",
      *       name: "Claude Sonnet 4 (Vertex)",
      *       reasoning: true,
-     *       thinking: { mode: "anthropic-adaptive", minLevel: "minimal", maxLevel: "high" },
+     *       thinking: { mode: "anthropic-adaptive", efforts: ["minimal", "low", "medium", "high"] },
      *       input: ["text", "image"],
      *       cost: { input: 3, output: 15, cacheRead: 0.3, cacheWrite: 3.75 },
      *       contextWindow: 200000,
@@ -765,7 +765,7 @@ export interface ProviderModelConfig {
     /** Custom headers for this model. */
     headers?: Record<string, string>;
     /** OpenAI compatibility settings. */
-    compat?: Model<Api>["compat"];
+    compat?: ModelSpec<Api>["compat"];
 }
 /** Extension factory function type. Supports both sync and async initialization. */
 export type ExtensionFactory = (pi: ExtensionAPI) => void | Promise<void>;

package/dist/types/hindsight/mental-models.d.ts

@@ -26,8 +26,10 @@
  * retain side to emit them.
  *
  * Seed tags are baked from `seeds.json` plus, for `projectTagged: true`
- * entries, the active scope's `retainTags` (i.e. `project:<cwd>`). Untagged
- * seeds (e.g. `user-preferences`) read every memory in the bank — the
+ * entries, the active scope's `retainTags` (i.e. `project:<cwd>`). In
+ * `per-project-tagged`, those project seeds also get project-suffixed ids so
+ * each tag can own its conventions/decisions models in the shared bank.
+ * Untagged seeds (e.g. `user-preferences`) read every memory in the bank — the
  * reflect call applies no tag filter when `tags` is empty.
  *
  * Seed lifecycle is **create-only**: changes to `source_query`, `tags`,
@@ -58,12 +60,16 @@ export interface MentalModelSeed {
     sourceQuery: string;
     tags: string[];
     maxTokens?: number;
+    /** Legacy unqualified seed ids accepted as already-present when tags match. */
+    legacyIds?: string[];
     trigger?: MentalModelTrigger;
 }
 /**
  * Resolve the seed list that applies to the active bank scope. Per-project
  * seeds are skipped in `global` mode (where there is no project axis) and
- * `projectTagged` seeds inherit the scope's `retainTags`.
+ * `projectTagged` seeds inherit the scope's `retainTags`. In shared tagged
+ * banks, project seeds use project-suffixed ids and accept matching legacy
+ * bare ids as already present.
  */
 export declare function resolveSeedsForScope(scope: BankScope, scoping: HindsightScoping): MentalModelSeed[];
 /**
@@ -75,6 +81,8 @@ export declare function resolveSeedsForScope(scope: BankScope, scoping: Hindsigh
  * Existing models are NEVER modified. See module docstring.
  */
 export declare function ensureMentalModels(client: HindsightApi, bankId: string, seeds: MentalModelSeed[], debug: boolean): Promise<void>;
+/** Return whether a seed is already represented by current bank metadata. */
+export declare function seedAlreadyExists(seed: MentalModelSeed, models: readonly MentalModelSummary[]): boolean;
 /**
  * Default character budget for the rendered `<mental_models>` block. Mental
  * models are injected on every prompt rebuild; an unbounded block can crowd
@@ -93,12 +101,13 @@ export declare const MENTAL_MODEL_RENDER_BUDGET_CHARS_DEFAULT = 16000;
  * reflect for a freshly-seeded model hasn't completed yet).
  *
  * The rendered block is bounded by `budgetChars` (default
- * MENTAL_MODEL_RENDER_BUDGET_CHARS_DEFAULT). Per-model content is truncated
- * before assembly; if assembly still exceeds the budget, trailing models are
- * dropped. A budget overflow leaves a `…` marker so the LLM can tell the
- * snapshot is truncated.
+ * MENTAL_MODEL_RENDER_BUDGET_CHARS_DEFAULT). When `visibleTags` is supplied,
+ * tagged models must match at least one active tag; untagged models remain
+ * visible in every scope. Per-model content is truncated before assembly; if
+ * assembly still exceeds the budget, trailing models are dropped. A budget
+ * overflow leaves a `…` marker so the LLM can tell the snapshot is truncated.
  */
-export declare function loadMentalModelsBlock(client: HindsightApi, bankId: string, budgetChars?: number): Promise<string | undefined>;
+export declare function loadMentalModelsBlock(client: HindsightApi, bankId: string, budgetChars?: number, visibleTags?: readonly string[]): Promise<string | undefined>;
 export declare function renderMentalModelsBlock(models: MentalModelSummary[], budgetChars: number): string;
 /** Inventory line used by the `/memory mm list` command. */
 export declare function summarizeMentalModel(model: MentalModelSummary): string;

package/dist/types/internal-urls/artifact-protocol.d.ts

@@ -1,7 +1,7 @@
-import type { InternalResource, InternalUrl, ProtocolHandler, UrlCompletion } from "./types";
+import type { InternalResource, InternalUrl, ProtocolHandler, ResolveContext, UrlCompletion } from "./types";
 export declare class ArtifactProtocolHandler implements ProtocolHandler {
     readonly scheme = "artifact";
     readonly immutable = true;
-    resolve(url: InternalUrl): Promise<InternalResource>;
+    resolve(url: InternalUrl, context?: ResolveContext): Promise<InternalResource>;
     complete(): Promise<UrlCompletion[]>;
 }

package/dist/types/internal-urls/types.d.ts

@@ -1,7 +1,7 @@
 /**
  * Types for the internal URL routing system.
  *
- * Internal URLs (agent://, artifact://, memory://, skill://, rule://, mcp://, omp://, local://) are resolved by tools like read,
+ * Internal URLs (`agent://`, `artifact://`, `issue://`, `local://`, `mcp://`, `memory://`, `omp://`, `pr://`, `rule://`, `skill://`, and `vault://`) are resolved by tools like read,
  * providing access to agent outputs and server resources without exposing filesystem paths.
  */
 import type { LocalProtocolOptions } from "./local-protocol";

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

@@ -6,6 +6,13 @@ import type { Range, TextEdit, WorkspaceEdit } from "./types";
 export declare function applyTextEditsToString(content: string, edits: TextEdit[]): string;
 /** True when two ranges overlap (share any position other than a touching boundary). */
 export declare function rangesOverlap(a: Range, b: Range): boolean;
+/**
+ * Sort edits bottom-to-top for in-place application and reject overlaps.
+ * Equal start positions tiebreak by original array index descending so that,
+ * applied bottom-up, inserts at the same position land in array order
+ * (LSP spec: the order of edits in the array defines the order in the result).
+ */
+export declare function sortAndValidateTextEdits(edits: TextEdit[]): TextEdit[];
 /**
  * Flatten a WorkspaceEdit's text edits into a Map<uri, TextEdit[]>.
  * Resource operations (create/rename/delete) are ignored — callers handle them separately.
@@ -18,6 +25,8 @@ export declare function flattenWorkspaceTextEdits(edit: WorkspaceEdit): Map<stri
 export declare function applyTextEdits(filePath: string, edits: TextEdit[]): Promise<void>;
 /**
  * Apply a workspace edit (collection of file changes).
+ * All text-edit batches are overlap-validated before anything is written so a
+ * conflict throws without leaving the workspace half-applied.
  * Returns array of applied change descriptions.
  */
 export declare function applyWorkspaceEdit(edit: WorkspaceEdit, cwd: string): Promise<string[]>;

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

@@ -14,7 +14,7 @@ export type { LspToolDetails } from "./types";
 export declare const LSP_READONLY_ACTIONS: ReadonlySet<string>;
 export interface LspStartupServerInfo {
     name: string;
-    status: "connecting" | "ready" | "error";
+    status: "connecting" | "ready" | "error" | "available";
     fileTypes: string[];
     error?: string;
 }
@@ -29,7 +29,7 @@ export interface LspWarmupOptions {
     /** Called when starting to connect to servers */
     onConnecting?: (serverNames: string[]) => void;
 }
-export declare function discoverStartupLspServers(cwd: string): LspStartupServerInfo[];
+export declare function discoverStartupLspServers(cwd: string, status?: LspStartupServerInfo["status"]): LspStartupServerInfo[];
 /**
  * Warm up LSP servers for a directory by connecting to all detected servers.
  * This should be called at startup to avoid cold-start delays.

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

@@ -278,6 +278,8 @@ export interface LspClient {
     pendingRequests: Map<number, PendingRequest>;
     messageBuffer: Uint8Array;
     isReading: boolean;
+    /** Lifecycle state: "connecting" until initialize completes, then "ready"; "error" on init failure or reader death. */
+    status: "connecting" | "ready" | "error";
     serverCapabilities?: LspServerCapabilities;
     lastActivity: number;
     /** Serializes outbound JSON-RPC writes to the server process. */

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

@@ -3,11 +3,14 @@ import type { CodeAction, Command, Diagnostic, DiagnosticSeverity, DocumentSymbo
 export { detectLanguageId } from "../utils/lang-from-path";
 /**
  * Convert a file path to a file:// URI.
+ * Uses the URL machinery so special characters (`%`, `#`, `?`, spaces) are
+ * percent-encoded; plain concatenation produced URIs that broke round-trips.
  * Handles Windows drive letters correctly.
  */
 export declare function fileToUri(filePath: string): string;
 /**
  * Convert a file:// URI to a file path.
+ * Tolerates both percent-encoded URIs and lax servers that send raw paths.
  * Handles Windows drive letters correctly.
  */
 export declare function uriToFile(uri: string): string;

package/dist/types/mcp/json-rpc.d.ts

@@ -1,3 +1,8 @@
+/**
+ * Redact credential-bearing query params (e.g. `exaApiKey`) so failed
+ * requests never write secrets to the persistent log file.
+ */
+export declare function redactUrlForLog(url: string): string;
 /** Parse SSE response format (lines starting with "data: ") */
 export declare function parseSSE(text: string): unknown;
 /** JSON-RPC 2.0 response structure */

package/dist/types/mnemopi/state.d.ts

@@ -1,7 +1,17 @@
 import type { AgentMessage } from "@oh-my-pi/pi-agent-core";
-import { Mnemopi, type RecallResult } from "@oh-my-pi/pi-mnemopi";
+import type * as MnemopiNs from "@oh-my-pi/pi-mnemopi";
+import type { Mnemopi, RecallResult } from "@oh-my-pi/pi-mnemopi";
+import type * as MnemopiCoreNs from "@oh-my-pi/pi-mnemopi/core";
 import type { AgentSession } from "../session/agent-session";
 import type { MnemopiBackendConfig } from "./config";
+/** Lazily load `@oh-my-pi/pi-mnemopi` (memoized). */
+export declare function loadMnemopi(): Promise<typeof MnemopiNs>;
+/** Lazily load `@oh-my-pi/pi-mnemopi/core` (memoized). */
+export declare function loadMnemopiCore(): Promise<typeof MnemopiCoreNs>;
+/** Sync access for code below an async boundary that already awaited {@link loadMnemopi}. */
+export declare function requireMnemopi(): typeof MnemopiNs;
+/** Sync access for code below an async boundary that already awaited {@link loadMnemopiCore}. */
+export declare function requireMnemopiCore(): typeof MnemopiCoreNs;
 interface MnemopiScopedMemory {
     bank: string;
     memory: Mnemopi;

package/dist/types/modes/components/agent-dashboard.d.ts

@@ -16,7 +16,7 @@ export declare class AgentDashboard extends Container {
     onRequestRender?: () => void;
     private constructor();
     static create(cwd: string, settings?: Settings | null, terminalHeight?: number, modelContext?: AgentDashboardModelContext): Promise<AgentDashboard>;
-    render(width: number): string[];
+    render(width: number): readonly string[];
     handleInput(data: string): void;
 }
 export {};

package/dist/types/modes/components/assistant-message.d.ts

@@ -22,5 +22,7 @@ export declare class AssistantMessageComponent extends Container {
     markTranscriptBlockFinalized(): void;
     setToolResultImages(toolCallId: string, images: ImageContent[]): void;
     setUsageInfo(usage: Usage): void;
-    updateContent(message: AssistantMessage): void;
+    updateContent(message: AssistantMessage, opts?: {
+        transient?: boolean;
+    }): void;
 }

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

@@ -17,7 +17,7 @@ export declare class BashExecutionComponent extends Container {
         output?: string;
         truncation?: TruncationMeta;
     }): void;
-    render(width: number): string[];
+    render(width: number): readonly string[];
     /**
      * Get the raw output for creating BashExecutionMessage.
      */

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

@@ -18,5 +18,5 @@ export declare class CopySelectorComponent implements Component {
     constructor(roots: CopyTarget[], callbacks: CopySelectorCallbacks);
     invalidate(): void;
     handleInput(keyData: string): void;
-    render(width: number): string[];
+    render(width: number): readonly string[];
 }

package/dist/types/modes/components/dynamic-border.d.ts

@@ -10,5 +10,5 @@ export declare class DynamicBorder implements Component {
     #private;
     constructor(color?: (str: string) => string);
     invalidate(): void;
-    render(width: number): string[];
+    render(width: number): readonly string[];
 }

package/dist/types/modes/components/extensions/extension-dashboard.d.ts

@@ -22,6 +22,6 @@ export declare class ExtensionDashboard extends Container {
     onRequestRender?: () => void;
     private constructor();
     static create(cwd: string, settings?: Settings | null, terminalHeight?: number): Promise<ExtensionDashboard>;
-    render(width: number): string[];
+    render(width: number): readonly string[];
     handleInput(data: string): void;
 }

package/dist/types/modes/components/extensions/extension-list.d.ts

@@ -34,6 +34,6 @@ export declare class ExtensionList implements Component {
     setSearchQuery(query: string): void;
     clearSearch(): void;
     invalidate(): void;
-    render(width: number): string[];
+    render(width: number): readonly string[];
     handleInput(data: string): void;
 }

package/dist/types/modes/components/extensions/inspector-panel.d.ts

@@ -4,5 +4,5 @@ export declare class InspectorPanel implements Component {
     #private;
     setExtension(extension: Extension | null): void;
     invalidate(): void;
-    render(width: number): string[];
+    render(width: number): readonly string[];
 }

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

@@ -26,5 +26,5 @@ export declare class FooterComponent implements Component {
      */
     dispose(): void;
     invalidate(): void;
-    render(width: number): string[];
+    render(width: number): readonly string[];
 }

package/dist/types/modes/components/hook-editor.d.ts

@@ -15,4 +15,9 @@ export declare class HookEditorComponent extends Container {
     #private;
     constructor(tui: TUI, title: string, prefill: string | undefined, onSubmit: (value: string) => void, onCancel: () => void, options?: HookEditorOptions);
     handleInput(keyData: string): void;
+    /** Route non-bracketed paste transports (e.g. kitty's OSC 5522 enhanced clipboard)
+     *  into the inner editor, mirroring bracketed-paste semantics. Without this hook,
+     *  enhanced-paste routing falls back to the main prompt editor hidden behind the
+     *  dialog (#2127 routing contract). */
+    pasteText(text: string): void;
 }

package/dist/types/modes/components/hook-input.d.ts

@@ -11,5 +11,9 @@ export declare class HookInputComponent extends Container {
     #private;
     constructor(title: string, _placeholder: string | undefined, onSubmit: (value: string) => void, onCancel: () => void, opts?: HookInputOptions);
     handleInput(keyData: string): void;
+    /** Route non-bracketed paste transports (e.g. kitty's OSC 5522 enhanced clipboard)
+     *  into the inner input, mirroring bracketed-paste semantics. Pasting counts as
+     *  interaction, so the timeout countdown resets like any keystroke. */
+    pasteText(text: string): void;
     dispose(): void;
 }

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

@@ -65,6 +65,6 @@ export declare class HookSelectorComponent extends Container {
     #private;
     constructor(title: string, options: HookSelectorOptionInput[], onSelect: (option: string) => void, onCancel: () => void, opts?: HookSelectorOptions);
     handleInput(keyData: string): void;
-    render(width: number): string[];
+    render(width: number): readonly string[];
     dispose(): void;
 }

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

@@ -1,4 +1,4 @@
-import { type Model } from "@oh-my-pi/pi-ai";
+import type { Model } from "@oh-my-pi/pi-ai";
 import { Container, Input, type TUI } from "@oh-my-pi/pi-tui";
 import type { ModelRegistry } from "../../config/model-registry";
 import type { Settings } from "../../config/settings";

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

@@ -55,5 +55,5 @@ export declare class PlanReviewOverlay implements Component {
      *  `onPlanEdited` (the editor round-trip already persisted the file). */
     setPlanContent(planContent: string): void;
     handleInput(keyData: string): void;
-    render(width: number): string[];
+    render(width: number): readonly string[];
 }

package/dist/types/modes/components/session-observer-overlay.d.ts

@@ -4,7 +4,7 @@ import type { SessionObserverRegistry } from "../session-observer-registry";
 export declare class SessionObserverOverlayComponent extends Container {
     #private;
     constructor(registry: SessionObserverRegistry, onDone: () => void, observeKeys: KeyId[]);
-    render(width: number): string[];
+    render(width: number): readonly string[];
     /** Rebuild content from live registry data */
     refreshFromRegistry(): void;
     handleInput(keyData: string): void;

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

@@ -40,7 +40,7 @@ declare class SessionList implements Component {
     setSessions(sessions: SessionInfo[], showCwd: boolean): void;
     removeSession(sessionPath: string): void;
     invalidate(): void;
-    render(width: number): string[];
+    render(width: number): readonly string[];
     handleInput(keyData: string): void;
 }
 export interface SessionSelectorOptions {

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

@@ -45,5 +45,5 @@ export declare class StatusLineComponent implements Component {
         content: string;
         width: number;
     };
-    render(width: number): string[];
+    render(width: number): readonly string[];
 }

package/dist/types/modes/components/tiny-title-download-progress.d.ts

@@ -7,5 +7,5 @@ export declare class TinyTitleDownloadProgressComponent implements Component {
     update(event: TinyTitleProgressEvent): void;
     isComplete(): boolean;
     invalidate(): void;
-    render(width: number): string[];
+    render(width: number): readonly string[];
 }

package/dist/types/modes/components/transcript-container.d.ts

@@ -1,40 +1,45 @@
-import { Container, type NativeScrollbackLiveRegion } from "@oh-my-pi/pi-tui";
+import { type Component, Container, type NativeScrollbackLiveRegion, type RenderStablePrefix } from "@oh-my-pi/pi-tui";
 /**
- * Transcript container that freezes the rendered output of every block except
- * the bottom-most (live) one on terminals where committed native scrollback is
- * immutable.
+ * Transcript container that renders every block's current content each frame
+ * and reports the live-region seam (`NativeScrollbackLiveRegion`) that gates
+ * the engine's append-only scrollback commits.
  *
- * On ED3-risk terminals with an unobservable viewport (ghostty/kitty/iTerm2/…)
- * the renderer cannot clear saved lines (`\x1b[3J` may yank a reader) or query
- * whether the user has scrolled, so any block that re-lays-out *after* it has
- * scrolled past the viewport leaves a stale duplicate above the live region
- * (a finalized assistant message re-wrapping, a tool preview collapsing to its
- * compact result, a late async tool completion). The renderer's only safe move
- * for such an offscreen edit is to not repaint — which is correct only if the
- * committed region never changes underneath it.
+ * The engine never rewrites committed history: rows above the seam that have
+ * entered the tape keep whatever bytes they were committed with ("let the
+ * history be"), while the visible window always repaints from each block's
+ * latest render — a late tool result, a post-finalize error pin, or an expand
+ * toggle is always reflected on screen. Blocks that are still mutating (an
+ * unfinalized tool, a streaming assistant message) stay below the seam so
+ * their rows do not enter history while they can still change; a streaming
+ * block whose render grows append-only deepens the seam through its settled
+ * head so a long reply's scrolled-off rows still reach scrollback mid-stream.
  *
- * This container provides that guarantee: a block's render is snapshotted while
- * it is the live (bottom-most) block, and once a newer block is appended it
- * replays the snapshot instead of recomputing. Mutations after a block leaves
- * live are intentionally deferred until the next checkpoint {@link thaw} (prompt
- * submit → native-scrollback rebuild), where the whole transcript is replayed
- * and any drift reconciles safely. On terminals that can rebuild history this
- * freezing is unnecessary, so it renders every block live for full fidelity.
+ * Assembly is incremental: the returned array is persistent and mutated in
+ * place. Each block's render is still called every frame, but a block whose
+ * render returned the same array reference at an unchanged offset reuses its
+ * previously assembled rows; the array is truncated and re-pushed only from
+ * the first divergent block. The leading byte-identical row count is reported
+ * through {@link RenderStablePrefix} so the engine can skip marker scanning,
+ * line preparation, and the committed-prefix audit for those rows.
  */
-export declare class TranscriptContainer extends Container implements NativeScrollbackLiveRegion {
+export declare class TranscriptContainer extends Container implements NativeScrollbackLiveRegion, RenderStablePrefix {
     #private;
     invalidate(): void;
     clear(): void;
+    getRenderStablePrefixRows(): number;
     getNativeScrollbackLiveRegionStart(): number | undefined;
     getNativeScrollbackCommitSafeEnd(): number | undefined;
     /**
-     * Retire all frozen snapshots so the next render reflects each block's current
-     * state. Call at reconciliation checkpoints (prompt submit) where the whole
-     * transcript is replayed into native scrollback and any drift a frozen block
-     * accumulated is reconciled.
+     * Whether `component` sits below a still-mutating block — i.e. inside the
+     * live region, where its rows cannot have been committed to native
+     * scrollback yet (commits are prefix-only and stop at the first
+     * still-live block). Callers that retract ephemeral blocks (IRC cards)
+     * must check this: removing a block whose rows may already be in history
+     * is an interior deletion of the committed prefix, which the engine can
+     * only repair by recommitting everything below it — duplication.
      */
-    thaw(): void;
-    render(width: number): string[];
+    isWithinLiveRegion(component: Component): boolean;
+    render(width: number): readonly string[];
 }
 /**
  * Groups a run of sibling rows (an IRC card's header + body, a file-mention

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

@@ -15,7 +15,7 @@ declare class TreeList implements Component {
     getSearchQuery(): string;
     getSelectedNode(): SessionTreeNode | undefined;
     updateNodeLabel(entryId: string, label: string | undefined): void;
-    render(width: number): string[];
+    render(width: number): readonly string[];
     handleInput(keyData: string): void;
 }
 /**

package/dist/types/modes/components/user-message-selector.d.ts

@@ -14,7 +14,7 @@ declare class UserMessageList implements Component {
     onCancel?: () => void;
     constructor(messages: UserMessageItem[]);
     invalidate(): void;
-    render(width: number): string[];
+    render(width: number): readonly string[];
     handleInput(keyData: string): void;
 }
 /**

package/dist/types/modes/components/user-message.d.ts

@@ -3,6 +3,7 @@ import { Container } from "@oh-my-pi/pi-tui";
  * Component that renders a user message
  */
 export declare class UserMessageComponent extends Container {
+    #private;
     constructor(text: string, synthetic?: boolean, imageLinks?: readonly (string | undefined)[]);
-    render(width: number): string[];
+    render(width: number): readonly string[];
 }

package/dist/types/modes/components/visual-truncate.d.ts

@@ -1,6 +1,6 @@
 export interface VisualTruncateResult {
     /** The visual lines to display */
-    visualLines: string[];
+    visualLines: readonly string[];
     /** Number of visual lines that were skipped (hidden) */
     skippedCount: number;
 }

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

@@ -1,4 +1,14 @@
 import { type Component } from "@oh-my-pi/pi-tui";
+/**
+ * Fixed number of session rows in the welcome box so its height doesn't shift
+ * between the pre-TUI splash (loading placeholder) and the loaded state.
+ */
+export declare const WELCOME_SESSION_SLOTS = 4;
+/**
+ * Fixed number of LSP-server rows, for the same reason. Overflow is sliced so
+ * the box height is constant regardless of how many servers a project has.
+ */
+export declare const WELCOME_LSP_SLOTS = 4;
 export declare function renderWelcomeTip(tip: string, boxWidth: number): string[];
 export interface RecentSession {
     name: string;
@@ -6,7 +16,7 @@ export interface RecentSession {
 }
 export interface LspServerInfo {
     name: string;
-    status: "ready" | "error" | "connecting";
+    status: "ready" | "error" | "connecting" | "available";
     fileTypes: string[];
 }
 /**
@@ -19,8 +29,14 @@ export declare class WelcomeComponent implements Component {
     private providerName;
     private recentSessions;
     private lspServers;
-    constructor(version: string, modelName: string, providerName: string, recentSessions?: RecentSession[], lspServers?: LspServerInfo[]);
+    constructor(version: string, modelName: string, providerName: string, recentSessions?: RecentSession[] | null, lspServers?: LspServerInfo[]);
     invalidate(): void;
+    /**
+     * Freeze the logo on the intro animation's first frame. The pre-TUI startup
+     * splash uses this so the in-TUI intro — which starts at that exact frame —
+     * picks up seamlessly from the splash's static box.
+     */
+    holdIntroFirstFrame(): void;
     /**
      * Play a one-shot intro that sweeps the gradient through every phase
      * before settling on the resting frame. Safe to call multiple times —
@@ -30,7 +46,7 @@ export declare class WelcomeComponent implements Component {
     setModel(modelName: string, providerName: string): void;
     setRecentSessions(sessions: RecentSession[]): void;
     setLspServers(servers: LspServerInfo[]): void;
-    render(termWidth: number): string[];
+    render(termWidth: number): readonly string[];
 }
 export declare const PI_LOGO: string[];
 export interface ShineConfig {

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

@@ -5,7 +5,7 @@ export declare class MCPAuthorizationLinkPrompt implements Component {
     #private;
     constructor(url: string);
     invalidate(): void;
-    render(_width: number): string[];
+    render(_width: number): readonly string[];
 }
 export declare class MCPCommandController {
     #private;

package/dist/types/modes/controllers/streaming-reveal.d.ts

@@ -10,7 +10,7 @@ type StreamingRevealControllerOptions = {
     requestRender(): void;
 };
 export declare function visibleUnits(message: AssistantMessage, hideThinking: boolean): number;
-export declare function buildDisplayMessage(target: AssistantMessage, revealed: number, hideThinking: boolean): AssistantMessage;
+export declare function buildDisplayMessage(target: AssistantMessage, revealed: number, hideThinking: boolean, countOf?: (index: number, text: string) => number): AssistantMessage;
 export declare function nextStep(backlog: number): number;
 export declare class StreamingRevealController {
     #private;

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

@@ -1,6 +1,6 @@
 import { type Agent, type AgentMessage } from "@oh-my-pi/pi-agent-core";
 import type { CompactionOutcome } from "@oh-my-pi/pi-agent-core/compaction";
-import { type AssistantMessage, type ImageContent, type Message, type UsageReport } from "@oh-my-pi/pi-ai";
+import type { AssistantMessage, ImageContent, Message, UsageReport } from "@oh-my-pi/pi-ai";
 import type { Component, EditorTheme } from "@oh-my-pi/pi-tui";
 import { Container, Loader, Spacer, Text, TUI } from "@oh-my-pi/pi-tui";
 import { KeybindingsManager } from "../config/keybindings";

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

@@ -15,5 +15,5 @@ export declare class SignInTab implements SetupTab {
     dispose(): void;
     invalidate(): void;
     handleInput(data: string): void;
-    render(width: number): string[];
+    render(width: number): readonly string[];
 }

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

@@ -27,7 +27,7 @@ export interface SetupTab {
      * login). The parent scene MUST NOT switch tabs or finish while modal.
      */
     readonly modal: boolean;
-    render(width: number): string[];
+    render(width: 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

@@ -16,5 +16,5 @@ export declare class WebSearchTab implements SetupTab {
     handleInput(data: string): void;
     invalidate(): void;
     dispose(): void;
-    render(width: number): string[];
+    render(width: number): readonly string[];
 }

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

@@ -10,5 +10,5 @@ export declare class SetupWizardComponent implements Component {
     dispose(): void;
     invalidate(): void;
     handleInput(data: string): void;
-    render(width: number): string[];
+    render(width: number): readonly string[];
 }