@oh-my-pi/pi-coding-agent 17.0.7 → 17.0.9

package/dist/types/config/__tests__/model-registry.test.d.ts

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

package/dist/types/config/model-registry.d.ts

@@ -44,7 +44,7 @@ interface ProviderOverride {
  * See `xiaomi-tp-discovery-merge.test.ts` and the `refresh()` baseUrl-override
  * regression in `model-registry.test.ts`.
  */
-export declare function mergeDiscoveredModel<TApi extends Api>(model: Model<TApi>, existing: Model<Api> | undefined, providerOverride?: Pick<ProviderOverride, "baseUrl" | "headers" | "remoteCompaction" | "transport">): Model<TApi>;
+export declare function mergeDiscoveredModel<TApi extends Api>(model: Model<TApi>, existing: Model<Api> | undefined, providerOverride?: Pick<ProviderOverride, "baseUrl" | "compat" | "headers" | "remoteCompaction" | "transport">): Model<TApi>;
 export type ProviderDiscoveryStatus = "idle" | "ok" | "empty" | "cached" | "unavailable" | "unauthenticated";
 export interface ProviderDiscoveryState {
     provider: string;
@@ -78,6 +78,23 @@ export declare class ModelRegistry {
      */
     refresh(strategy?: ModelRefreshStrategy): Promise<void>;
     refreshInBackground(strategy?: ModelRefreshStrategy): void;
+    /**
+     * Wait for any in-flight background model discovery to settle.
+     *
+     * Background discovery started by {@link refreshInBackground} is
+     * fire-and-forget; RPC consumers (e.g. `get_available_models`,
+     * `set_model`) and deferred `--model` resolution that read the registry
+     * immediately after session creation can otherwise observe a partial
+     * catalog before discovery-backed providers have populated `#models`.
+     * Awaiting the tracked promise ensures the response reflects every
+     * configured provider once the initial background refresh resolves.
+     *
+     * No-op when no refresh is in flight (`#backgroundRefresh` cleared in the
+     * `finally` of `refreshInBackground` on completion). Resolves immediately
+     * in that case so already-warm sessions are unaffected. Discovery errors
+     * remain swallowed by `refreshInBackground`'s existing `.catch`.
+     */
+    awaitBackgroundRefresh(): Promise<void>;
     refreshProvider(providerId: string, strategy?: ModelRefreshStrategy): Promise<void>;
     /**
      * Refresh dynamic metadata that can appear only after a local model loads.
@@ -132,6 +149,16 @@ export declare class ModelRegistry {
      */
     hasCommandBackedApiKey(provider: string): boolean;
     getDiscoverableProviders(): string[];
+    /**
+     * Whether `providerId` is known to the registry: it has at least one live
+     * model, or it is configured for dynamic discovery (models.yml `discovery:`
+     * or a runtime extension provider) and is not disabled. Discovery-only
+     * providers can hold zero models at startup — cached rows never persist
+     * live auth headers (#5780), so a provider whose discovered models all
+     * carry config headers (`authHeader: true`) only materializes models after
+     * the online refresh completes.
+     */
+    hasProvider(providerId: string): boolean;
     getProviderDiscoveryState(provider: string): ProviderDiscoveryState | undefined;
     /**
      * Find a model by provider and ID.

package/dist/types/config/model-resolver.d.ts

@@ -265,8 +265,10 @@ export declare function resolveAllowedModels(modelRegistry: Pick<ModelRegistry,
 export declare function filterAvailableModelsByEnabledPatterns(available: Model<Api>[], patterns: readonly string[], settings?: Settings): Model<Api>[];
 export interface ResolveCliModelResult {
     model: Model<Api> | undefined;
-    /** configuredPatterns is the full configured fallback chain when the selector resolves through a role. */
+    /** configuredPatterns contains the role's ordered primary candidates. */
     configuredPatterns?: string[];
+    /** configuredRole identifies the role expanded into configuredPatterns. */
+    configuredRole?: string;
     /** configuredPatternIndex identifies the configured role pattern that matched an available model. */
     configuredPatternIndex?: number;
     selector?: string;
@@ -283,6 +285,8 @@ export declare function resolveCliModel(options: {
     cliProvider?: string;
     cliModel?: string;
     modelRegistry: CliModelRegistry;
+    /** Authenticated models to prefer for unqualified selectors; omit to preserve catalog-order behavior. */
+    availableModels?: Model<Api>[];
     settings?: Settings;
     preferences?: ModelMatchPreferences;
 }): ResolveCliModelResult;

package/dist/types/config/settings-schema.d.ts

@@ -62,6 +62,8 @@ interface UiNumber extends UiBase {
     options?: ReadonlyArray<SubmenuOption>;
 }
 interface UiString extends UiBase {
+    /** Mask the value in both the settings row and text editor. */
+    secret?: boolean;
     /**
      * Submenu options.
      *  - Array  → submenu with these choices.
@@ -73,6 +75,7 @@ interface UiString extends UiBase {
 /** Wide ui shape exposed to consumers that walk the schema generically. */
 export type AnyUiMetadata = UiBase & {
     options?: ReadonlyArray<SubmenuOption> | "runtime";
+    secret?: boolean;
 };
 interface BooleanDef {
     type: "boolean";
@@ -2839,6 +2842,14 @@ export declare const SETTINGS_SCHEMA: {
     readonly "hindsight.apiToken": {
         readonly type: "string";
         readonly default: undefined;
+        readonly ui: {
+            readonly tab: "memory";
+            readonly group: "Hindsight";
+            readonly label: "Hindsight API Token";
+            readonly description: "Bearer token for authenticated Hindsight servers";
+            readonly condition: "hindsightActive";
+            readonly secret: true;
+        };
     };
     readonly "hindsight.bankId": {
         readonly type: "string";
@@ -2968,6 +2979,22 @@ export declare const SETTINGS_SCHEMA: {
         readonly type: "boolean";
         readonly default: false;
     };
+    readonly "hindsight.requestTimeoutMs": {
+        readonly type: "number";
+        readonly default: 30000;
+    };
+    readonly "hindsight.reflectTimeoutMs": {
+        readonly type: "number";
+        readonly default: 120000;
+    };
+    readonly "hindsight.recallTimeoutMs": {
+        readonly type: "number";
+        readonly default: 30000;
+    };
+    readonly "hindsight.retainTimeoutMs": {
+        readonly type: "number";
+        readonly default: 60000;
+    };
     readonly "hindsight.mentalModelsEnabled": {
         readonly type: "boolean";
         readonly default: true;
@@ -4034,6 +4061,16 @@ export declare const SETTINGS_SCHEMA: {
             readonly description: "Load .mcp.json/mcp.json from project root";
         };
     };
+    readonly "mcp.renderMarkdownResults": {
+        readonly type: "boolean";
+        readonly default: true;
+        readonly ui: {
+            readonly tab: "tools";
+            readonly group: "Discovery & MCP";
+            readonly label: "MCP Markdown Results";
+            readonly description: "Render non-JSON MCP text results as Markdown in the transcript";
+        };
+    };
     readonly "mcp.notifications": {
         readonly type: "boolean";
         readonly default: false;
@@ -4167,6 +4204,16 @@ export declare const SETTINGS_SCHEMA: {
             }];
         };
     };
+    readonly "task.isolation.apply": {
+        readonly type: "boolean";
+        readonly default: true;
+        readonly ui: {
+            readonly tab: "tasks";
+            readonly group: "Isolation";
+            readonly label: "Apply Isolated Changes";
+            readonly description: "Automatically apply successful isolated task changes to the parent checkout; disable to retain patch or branch artifacts";
+        };
+    };
     readonly "task.isolation.merge": {
         readonly type: "enum";
         readonly values: readonly ["patch", "branch"];
@@ -4632,7 +4679,7 @@ export declare const SETTINGS_SCHEMA: {
             }, {
                 readonly value: "firecrawl";
                 readonly label: "Firecrawl";
-                readonly description: "Requires FIRECRAWL_API_KEY";
+                readonly description: "Uses Firecrawl API when FIRECRAWL_API_KEY is set; falls back to keyless mode";
             }, {
                 readonly value: "brave";
                 readonly label: "Brave";
@@ -5470,12 +5517,12 @@ export declare const SETTINGS_SCHEMA: {
     };
     readonly "dev.autoqa": {
         readonly type: "boolean";
-        readonly default: false;
+        readonly default: true;
         readonly ui: {
             readonly tab: "tools";
             readonly group: "Developer";
             readonly label: "Auto QA";
-            readonly description: "Enable automated tool issue reporting (report_tool_issue) for all agents";
+            readonly description: "Automated tool issue reporting (xd://report_issue). On by default; the first report asks for consent, and denying it disables reporting until re-enabled explicitly";
         };
     };
     readonly "dev.autoqaPush.endpoint": {

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

@@ -53,4 +53,23 @@ export declare class DapClient {
     sendResponse(request: DapRequestMessage, success: boolean, body?: unknown, message?: string): Promise<void>;
     dispose(): Promise<void>;
 }
+/**
+ * Give the adapter a chance to announce it is listening on `port` before the
+ * first connect. vscode-js-debug prints `Debug server listening at HOST:PORT`
+ * to stdout from inside its `listen()` callback; waiting for the port to appear
+ * there means we only connect once the child genuinely owns the reserved port,
+ * which closes the WSL2-mirrored ghost-accept window (issue #6055) at its root.
+ *
+ * Best-effort: resolves on the banner, on process exit, or on timeout — the
+ * subsequent connect loop and `proc.exitCode` checks surface real failures, so
+ * an adapter that never prints a banner still proceeds (just without the gate).
+ * Also drains stdout for the wait's duration: in tcp mode the DAP protocol
+ * flows over the socket, so nothing else consumes the adapter's stdout.
+ *
+ * Exported so tests can drive the gate deterministically with a synthetic stdout.
+ */
+export declare function waitForTcpServerListening(proc: {
+    stdout: ReadableStream<Uint8Array>;
+    exitCode: number | null;
+}, port: number, timeoutMs: number): Promise<void>;
 export {};

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

@@ -54,8 +54,10 @@ export type SwitchSessionHandler = (sessionPath: string) => Promise<{
 }>;
 export type ShutdownHandler = () => void;
 /**
- * Helper function to emit session_shutdown event to extensions.
- * Returns true if the event was emitted, false if there were no handlers.
+ * Emit `session_shutdown` and clear timers owned by an extension runner.
+ *
+ * Returns whether any shutdown handlers were present. Timer cleanup runs even
+ * when a handler fails so extension background work cannot outlive its host.
  */
 export declare function emitSessionShutdownEvent(extensionRunner: ExtensionRunner | undefined): Promise<boolean>;
 export declare class ExtensionRunner {

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

@@ -398,6 +398,9 @@ export interface ToolDefinition<TParams extends TSchema = TSchema, TDetails = un
     /** Tool approval tier. Defaults to `"exec"` when omitted.
      *  `"read"`: read-only operations. `"write"`: mutations. `"exec"`: code execution. */
     approval?: ToolApproval;
+    /** Structured-output strict grammar opt-in/out. `false` is meaningful: OpenAI-family
+     *  serializers preserve an explicit `strict: false` on the wire (#4336/#4340). */
+    strict?: boolean;
     /** MCP server name for discovery/search metadata when this tool fronts an MCP server. */
     mcpServerName?: string;
     /** Original MCP tool name for discovery/search metadata. */

package/dist/types/extensibility/legacy-pi-coding-agent-shim.d.ts

@@ -371,4 +371,5 @@ export { getProjectDir } from "@oh-my-pi/pi-utils";
 export declare function getPackageDir(): string;
 export * from "../index.js";
 export { formatBytes as formatSize } from "../tools/render-utils.js";
+export { copyToClipboard } from "../utils/clipboard.js";
 export { Type } from "./typebox.js";

package/dist/types/extensibility/legacy-pi-tui-shim.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Compatibility shim for legacy extensions importing the package root of
+ * `@earendil-works/pi-tui` or `@mariozechner/pi-tui`.
+ *
+ * The historical root exported `decodeKittyPrintable`; the canonical TUI now
+ * exposes the equivalent, broader `decodePrintableKey` helper. Keep the legacy
+ * name available without reintroducing it into the canonical package surface.
+ */
+export * from "@oh-my-pi/pi-tui";
+export { decodePrintableKey as decodeKittyPrintable } from "@oh-my-pi/pi-tui";

package/dist/types/extensibility/plugins/legacy-pi-compat.d.ts

@@ -57,7 +57,7 @@ export declare function __validateLegacyPiPackageRootOverrides(candidates: Recor
  */
 export declare function __buildLegacyPiPackageRootOverrides(isCompiled: boolean, bundledModuleKeys?: Iterable<string>): Record<string, string>;
 /** Test seam for compiled-binary legacy extension source rewriting. */
-export declare function __rewriteLegacyExtensionSourceForTests(source: string, importerPath: string, mtimeTag?: string | null): Promise<string>;
+export declare function __rewriteLegacyExtensionSourceForTests(source: string, importerPath: string, mtimeTag?: string | null, resolvedImportMtimeTag?: string | null): Promise<string>;
 /**
  * Load a legacy Pi extension module from its real on-disk location.
  *

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

@@ -33,6 +33,8 @@ export type TOptional<_E extends ArkSchema> = ArkSchema;
 export type TUnion<_T extends readonly ArkSchema[] = readonly ArkSchema[]> = ArkSchema;
 export type TEnum<_T extends readonly (string | number)[] = readonly (string | number)[]> = ArkSchema;
 export type TRecord<_K extends ArkSchema, _V extends ArkSchema> = ArkSchema;
+/** TypeBox-compatible wrapper for raw JSON Schema documents. */
+export type TUnsafe<_T = unknown> = ArkSchema;
 declare const VALIDATION_FAILURE: unique symbol;
 interface ValidationFailure {
     message: string;
@@ -126,6 +128,7 @@ export declare const Type: {
     readonly Null: typeof tNull;
     readonly Any: typeof tAny;
     readonly Unknown: typeof tUnknown;
+    readonly Unsafe: <T = unknown>(jsonSchema?: Record<string, unknown>) => TUnsafe<T>;
     readonly Never: typeof tNever;
     readonly Literal: typeof tLiteral;
     readonly Union: typeof tUnion;
@@ -155,6 +158,7 @@ declare const _default: {
         readonly Null: typeof tNull;
         readonly Any: typeof tAny;
         readonly Unknown: typeof tUnknown;
+        readonly Unsafe: <T = unknown>(jsonSchema?: Record<string, unknown>) => TUnsafe<T>;
         readonly Never: typeof tNever;
         readonly Literal: typeof tLiteral;
         readonly Union: typeof tUnion;

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

@@ -12,10 +12,20 @@ export type Budget = "low" | "mid" | "high" | string;
 export type TagsMatch = "any" | "all" | "any_strict" | "all_strict";
 export type UpdateMode = "replace" | "append";
 export type ConsolidationState = "failed" | "pending" | "done";
+/** Per-operation request deadlines (ms). Each falls back to a built-in default. */
+export interface HindsightTimeouts {
+    /** Default deadline for ops without a specific override. */
+    request?: number;
+    reflect?: number;
+    recall?: number;
+    retain?: number;
+}
 export interface HindsightApiOptions {
     baseUrl: string;
     apiKey?: string;
     userAgent?: string;
+    /** Per-op deadlines; unset entries fall back to built-in defaults. */
+    timeouts?: HindsightTimeouts;
 }
 /** Caller cancellation shared by Hindsight request option bags. */
 export interface HindsightRequestOptions {

package/dist/types/hindsight/config.d.ts

@@ -32,6 +32,14 @@ export interface HindsightConfig {
     recallMaxQueryChars: number;
     recallPromptPreamble: string;
     debug: boolean;
+    /** Default per-request client deadline (ms) for ops without a specific override. */
+    requestTimeoutMs: number;
+    /** Client deadline (ms) for reflect (agentic synthesis; costlier than a metadata fetch). */
+    reflectTimeoutMs: number;
+    /** Client deadline (ms) for recall. */
+    recallTimeoutMs: number;
+    /** Client deadline (ms) for retain / retainBatch. */
+    retainTimeoutMs: number;
     mentalModelsEnabled: boolean;
     mentalModelAutoSeed: boolean;
     mentalModelRefreshIntervalMs: number;

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

@@ -31,3 +31,14 @@ export declare function artifactsDirsFromRegistry(): string[];
  * multiple dirs, the first hit wins (registry dirs are scanned first).
  */
 export declare function sessionFilesFromDisk(): Promise<Map<string, string>>;
+/**
+ * Availability half of the `history://` resolution semantics: true when a
+ * transcript for `agentId` can be served from a registered ref's live session
+ * or retained session file, or from an on-disk `.jsonl` under a known
+ * artifacts dir. Hint surfaces use this so they only advertise
+ * `history://<agentId>` links that `HistoryProtocolHandler` can actually
+ * resolve. A retained sessionFile path is verified on disk before it counts,
+ * and probing never throws: a stale path or unreadable artifacts subtree
+ * reads as unavailable instead of disturbing the caller's delivery path.
+ */
+export declare function hasResolvableTranscript(agentId: string): Promise<boolean>;

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.

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/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/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") */
@@ -59,6 +63,13 @@ export declare class MCPTool implements CustomTool<TSchema, MCPToolDetails> {
     readonly approval: "write";
     /** Render completed MCP calls with the result header replacing the pending call header. */
     readonly mergeCallAndResult = true;
+    /**
+     * MCP-backed tools opt out of strict structured-output grammar. The server
+     * owns validation, and strict mode makes OpenAI-family models over-fill
+     * mutually exclusive optional fields (#4336/#4340). Serializers preserve an
+     * explicit `false`; an omitted flag would leave nothing to preserve.
+     */
+    readonly strict: false;
     /** Create MCPTool instances for all tools from an MCP server connection */
     static fromTools(connection: MCPServerConnection, tools: MCPToolDefinition[], reconnect?: MCPReconnect): MCPTool[];
     constructor(connection: MCPServerConnection, tool: MCPToolDefinition, reconnect?: MCPReconnect | undefined);
@@ -86,6 +97,8 @@ export declare class DeferredMCPTool implements CustomTool<TSchema, MCPToolDetai
     readonly approval: "write";
     /** Render completed MCP calls with the result header replacing the pending call header. */
     readonly mergeCallAndResult = true;
+    /** See {@link MCPTool.strict}: MCP servers own validation, so stay non-strict. */
+    readonly strict: false;
     /** Create DeferredMCPTool instances for all tools from an MCP server */
     static fromTools(serverName: string, tools: MCPToolDefinition[], getConnection: () => Promise<MCPServerConnection>, source?: SourceMeta, reconnect?: MCPReconnect): DeferredMCPTool[];
     constructor(serverName: string, tool: MCPToolDefinition, getConnection: () => Promise<MCPServerConnection>, source?: SourceMeta, reconnect?: MCPReconnect | undefined);

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/mnemopi/state.d.ts

@@ -74,6 +74,7 @@ export interface MnemopiSessionStateOptions {
     hasRecalledForFirstTurn?: boolean;
 }
 export declare class MnemopiSessionState {
+    #private;
     sessionId: string;
     readonly config: MnemopiBackendConfig;
     readonly session: AgentSession;
@@ -124,6 +125,7 @@ export declare class MnemopiSessionState {
         content: string;
     }>, sourceId: string, options?: {
         extract?: boolean;
+        retainedThroughUserTurn?: number;
     }): Promise<void>;
     attachSessionListeners(): void;
     maybeRecallOnAgentStart(): Promise<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/settings-defs.d.ts

@@ -40,6 +40,7 @@ export interface SubmenuSettingDef extends BaseSettingDef {
 }
 export interface TextInputSettingDef extends BaseSettingDef {
     type: "text";
+    secret: boolean;
 }
 export interface ProviderLimitsSettingDef extends BaseSettingDef {
     type: "providerLimits";

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

@@ -1,4 +1,4 @@
-import { Container } from "@oh-my-pi/pi-tui";
+import { type Component, Container } from "@oh-my-pi/pi-tui";
 /**
  * Component that renders a user message
  */
@@ -7,3 +7,27 @@ export declare class UserMessageComponent extends Container {
     constructor(text: string, synthetic?: boolean, imageLinks?: readonly (string | undefined)[]);
     render(width: number): readonly string[];
 }
+/**
+ * Collapsed placeholder for a synthetic (agent-attributed) user input in the
+ * file/remote-backed transcript viewer — chiefly the advisor's `Session update`
+ * replay dumps, which can each be hundreds of KiB of Markdown and, on cold open,
+ * blocked the TUI for tens of seconds while every historical body was laid out
+ * before the viewport clip (issue #6308).
+ *
+ * Collapsed by default: renders one dim summary row (label · size · line count ·
+ * expand hint) and builds NO Markdown. The heavy {@link UserMessageComponent} is
+ * constructed lazily only when expanded via `ctrl+o`, so blocks above the
+ * viewport never pay layout cost until the reader asks to see them. The raw
+ * observability data stays intact in `__advisor.jsonl`.
+ */
+export declare class CollapsedSyntheticMessageComponent implements Component {
+    #private;
+    private readonly text;
+    private readonly imageLinks?;
+    constructor(text: string, imageLinks?: readonly (string | undefined)[] | undefined);
+    /** ctrl+o toggle: reveal/hide the full Markdown body. */
+    setExpanded(expanded: boolean): void;
+    invalidate(): void;
+    dispose(): void;
+    render(width: number): readonly string[];
+}

package/dist/types/modes/controllers/extension-ui-controller.d.ts

@@ -12,6 +12,14 @@ export declare class ExtensionUiController {
      * Initialize the hook system with TUI-based UI context.
      */
     initHooksAndCustomTools(): Promise<void>;
+    /**
+     * The `ExtensionUIContext` built in `initHooksAndCustomTools()` — the same
+     * picker/dialog primitives passed as `context.ui` for every live tool
+     * call. `/tree` `ask` re-answer (issue #5642) reuses this to drive a
+     * standalone `AskTool.execute()` call outside a normal agent turn.
+     * `undefined` before hooks have initialized.
+     */
+    getToolUIContext(): ExtensionUIContext | undefined;
     setHookWidget(key: string, content: ExtensionWidgetContent, options?: ExtensionWidgetOptions): void;
     initializeHookRunner(uiContext: ExtensionUIContext, _hasUI: boolean): 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

@@ -128,6 +128,7 @@ export declare class InteractiveMode implements InteractiveModeContext {
     proseOnlyThinking: boolean;
     compactionQueuedMessages: CompactionQueuedMessage[];
     pendingTools: Map<string, ToolExecutionHandle>;
+    transcriptMessageComponents: WeakMap<AgentMessage, Component>;
     pendingBashComponents: BashExecutionComponent[];
     bashComponent: BashExecutionComponent | undefined;
     pendingPythonComponents: EvalExecutionComponent[];
@@ -228,7 +229,9 @@ export declare class InteractiveMode implements InteractiveModeContext {
     syncRunningSubagentBadge(options?: {
         requestRender?: boolean;
     }): void;
-    rebuildChatFromMessages(): void;
+    rebuildChatFromMessages(options?: {
+        reuseSettledComponents?: boolean;
+    }): void;
     /**
      * Render the ctrl+p model-role cycle chip track into its own anchored
      * container (just above the editor), mirroring the todo HUD: the container is
@@ -301,10 +304,12 @@ export declare class InteractiveMode implements InteractiveModeContext {
     addMessageToChat(message: AgentMessage, options?: {
         populateHistory?: boolean;
         imageLinks?: readonly (string | undefined)[];
+        reuseSettledComponent?: boolean;
     }): Component[];
     renderSessionContext(sessionContext: SessionContext, options?: {
         updateFooter?: boolean;
         populateHistory?: boolean;
+        reuseSettledComponents?: boolean;
     }): void;
     renderInitialMessages(options?: {
         preserveExistingChat?: boolean;
@@ -399,6 +404,7 @@ export declare class InteractiveMode implements InteractiveModeContext {
     openExternalEditor(): void;
     registerExtensionShortcuts(): void;
     initHooksAndCustomTools(): Promise<void>;
+    getToolUIContext(): ExtensionUIContext | undefined;
     emitCustomToolSessionEvent(reason: "start" | "switch" | "branch" | "tree" | "shutdown", previousSessionFile?: string): Promise<void>;
     setHookWidget(key: string, content: ExtensionWidgetContent, options?: ExtensionWidgetOptions): void;
     setHookStatus(key: string, text: string | undefined): void;