@oh-my-pi/pi-coding-agent 15.12.3 → 15.13.0

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

@@ -5,6 +5,7 @@ import type { AgentMessage } from "@oh-my-pi/pi-agent-core";
 import type { CredentialDisabledEvent, ImageContent, Model, ProviderResponseMetadata } from "@oh-my-pi/pi-ai";
 import type { KeyId } from "@oh-my-pi/pi-tui";
 import type { ModelRegistry } from "../../config/model-registry";
+import type { Settings } from "../../config/settings";
 import type { MemoryRuntimeContext } from "../../memory-backend";
 import type { SessionManager } from "../../session/session-manager";
 import type { AfterProviderResponseEvent, AssistantThinkingRenderer, BeforeAgentStartEvent, BeforeAgentStartEventResult, BeforeProviderRequestEvent, BeforeProviderRequestEventResult, ContextEvent, Extension, ExtensionActions, ExtensionCommandContext, ExtensionCommandContextActions, ExtensionContext, ExtensionContextActions, ExtensionError, ExtensionEvent, ExtensionFlag, ExtensionRuntime, ExtensionShortcut, ExtensionUIContext, InputEvent, InputEventResult, MessageRenderer, RegisteredCommand, RegisteredTool, ResourcesDiscoverEvent, SessionBeforeBranchResult, SessionBeforeCompactResult, SessionBeforeSwitchResult, SessionBeforeTreeResult, SessionCompactingResult, ToolCallEvent, ToolCallEventResult, ToolResultEvent, ToolResultEventResult, UserBashEvent, UserBashEventResult, UserPythonEvent, UserPythonEventResult } from "./types";
@@ -62,7 +63,8 @@ export declare class ExtensionRunner {
     private readonly cwd;
     private readonly sessionManager;
     private readonly modelRegistry;
-    constructor(extensions: Extension[], runtime: ExtensionRuntime, cwd: string, sessionManager: SessionManager, modelRegistry: ModelRegistry, getMemory?: () => MemoryRuntimeContext | undefined);
+    private readonly settings?;
+    constructor(extensions: Extension[], runtime: ExtensionRuntime, cwd: string, sessionManager: SessionManager, modelRegistry: ModelRegistry, getMemory?: () => MemoryRuntimeContext | undefined, settings?: Settings | undefined);
     initialize(actions: ExtensionActions, contextActions: ExtensionContextActions, commandContextActions?: ExtensionCommandContextActions, uiContext?: ExtensionUIContext): void;
     /**
      * Forward a `credential_disabled` event from `AuthStorage` to extension handlers.

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

@@ -13,7 +13,7 @@ import type { Api, AssistantMessageEvent, AssistantMessageEventStream, Context,
 import type { OAuthCredentials, OAuthLoginCallbacks } from "@oh-my-pi/pi-ai/oauth/types";
 import type { AutocompleteItem, Component, EditorTheme, KeyId, TUI } from "@oh-my-pi/pi-tui";
 import type { logger as PiLogger } from "@oh-my-pi/pi-utils";
-import type * as Zod from "zod/v4";
+import type { z } from "zod/v4";
 import type { KeybindingsManager } from "../../config/keybindings";
 import type { ModelRegistry } from "../../config/model-registry";
 import type { EditToolDetails } from "../../edit";
@@ -27,6 +27,7 @@ import type { Theme } from "../../modes/theme/theme";
 import type { CustomMessage } from "../../session/messages";
 import type { ReadonlySessionManager, SessionManager } from "../../session/session-manager";
 import type { BashToolDetails, BashToolInput, FindToolDetails, FindToolInput, ReadToolDetails, ReadToolInput, SearchToolDetails, SearchToolInput, WriteToolInput } from "../../tools";
+import type { ApprovalMode } from "../../tools/approval";
 import type { EventBus } from "../../utils/event-bus";
 import type { AgentEndEvent, AgentStartEvent, AutoCompactionEndEvent, AutoCompactionStartEvent, AutoRetryEndEvent, AutoRetryStartEvent, ContextEvent, GoalUpdatedEvent, SessionBeforeBranchEvent, SessionBeforeBranchResult, SessionBeforeCompactEvent, SessionBeforeCompactResult, SessionBeforeSwitchEvent, SessionBeforeSwitchResult, SessionBeforeTreeEvent, SessionBeforeTreeResult, SessionBranchEvent, SessionCompactEvent, SessionCompactingEvent, SessionCompactingResult, SessionEvent, SessionShutdownEvent, SessionStartEvent, SessionSwitchEvent, SessionTreeEvent, TodoReminderEvent, ToolCallEventResult, ToolResultEventResult, TtsrTriggeredEvent, TurnEndEvent, TurnStartEvent } from "../shared-events";
 import type { SlashCommandInfo } from "../slash-commands";
@@ -173,6 +174,31 @@ export interface CompactOptions {
 /**
  * Context passed to extension event handlers.
  */
+/**
+ * Read-only model query facade exposed at `ctx.models`. Lets an extension select a
+ * model the same way core does — list authenticated models, read the session model,
+ * resolve a model string or role alias, and compare model families — without reaching
+ * into the mutable registry or re-implementing matching/family heuristics.
+ */
+export interface ExtensionModelQuery {
+    /** Authenticated models available this session (the same set `--model` selection sees). */
+    list(): Model[];
+    /** The current session model, if one is set. */
+    current(): Model | undefined;
+    /**
+     * Resolve a model string (`provider/id`, bare id) or role alias (`pi/slow`, a
+     * configured role) to a Model, using the same settings-backed aliases and match
+     * preferences as core selection. Thinking/routing suffixes are accepted and resolved
+     * to the base model (pass effort separately). Returns undefined when nothing matches.
+     */
+    resolve(spec: string): Model | undefined;
+    /**
+     * Opaque lineage token for "are these the same family?" comparisons — every Claude
+     * point release shares a token, Claude and GPT differ. Backed by catalog canonical
+     * identity. Compare it; do not persist it (the vocabulary tracks new releases).
+     */
+    family(model: Model): string;
+}
 export interface ExtensionContext {
     /** UI methods for user interaction */
     ui: ExtensionUIContext;
@@ -190,6 +216,8 @@ export interface ExtensionContext {
     modelRegistry: ModelRegistry;
     /** Current model (may be undefined) */
     model: Model | undefined;
+    /** Read-only model query facade: list / current / resolve / family. */
+    models: ExtensionModelQuery;
     /** Whether the agent is idle (not streaming) */
     isIdle(): boolean;
     /** Abort the current agent operation */
@@ -396,6 +424,22 @@ export interface InputEvent {
     images?: ImageContent[];
     source: "interactive" | "rpc" | "extension";
 }
+export interface ToolApprovalRequestedEvent {
+    type: "tool_approval_requested";
+    sessionId: string;
+    toolCallId: string;
+    toolName: string;
+    reason?: string;
+    approvalMode: ApprovalMode;
+}
+export interface ToolApprovalResolvedEvent {
+    type: "tool_approval_resolved";
+    sessionId: string;
+    toolCallId: string;
+    toolName: string;
+    approved: boolean;
+    reason?: string;
+}
 interface ToolCallEventBase {
     type: "tool_call";
     toolCallId: string;
@@ -498,7 +542,7 @@ export declare function isToolCallEventType<TName extends string, TInput extends
     input: TInput;
 };
 /** Union of all event types */
-export type ExtensionEvent = ResourcesDiscoverEvent | SessionEvent | ContextEvent | BeforeProviderRequestEvent | AfterProviderResponseEvent | BeforeAgentStartEvent | AgentStartEvent | AgentEndEvent | TurnStartEvent | TurnEndEvent | MessageStartEvent | MessageUpdateEvent | MessageEndEvent | ToolExecutionStartEvent | ToolExecutionUpdateEvent | ToolExecutionEndEvent | AutoCompactionStartEvent | AutoCompactionEndEvent | AutoRetryStartEvent | AutoRetryEndEvent | TtsrTriggeredEvent | TodoReminderEvent | GoalUpdatedEvent | CredentialDisabledEvent | UserBashEvent | UserPythonEvent | InputEvent | ToolCallEvent | ToolResultEvent;
+export type ExtensionEvent = ResourcesDiscoverEvent | SessionEvent | ContextEvent | BeforeProviderRequestEvent | AfterProviderResponseEvent | BeforeAgentStartEvent | AgentStartEvent | AgentEndEvent | TurnStartEvent | TurnEndEvent | MessageStartEvent | MessageUpdateEvent | MessageEndEvent | ToolExecutionStartEvent | ToolExecutionUpdateEvent | ToolExecutionEndEvent | AutoCompactionStartEvent | AutoCompactionEndEvent | AutoRetryStartEvent | AutoRetryEndEvent | TtsrTriggeredEvent | TodoReminderEvent | GoalUpdatedEvent | CredentialDisabledEvent | UserBashEvent | UserPythonEvent | InputEvent | ToolCallEvent | ToolResultEvent | ToolApprovalRequestedEvent | ToolApprovalResolvedEvent;
 export interface ContextEventResult {
     messages?: AgentMessage[];
 }
@@ -558,7 +602,7 @@ export interface ExtensionAPI {
     /** Injected zod-backed typebox shim for legacy `Type.Object(...)` parameter authoring. */
     typebox: typeof TypeBox;
     /** Injected zod module for Zod-authored extension tools (canonical going forward). */
-    zod: typeof Zod;
+    zod: typeof z;
     /** Injected pi-coding-agent exports for accessing SDK utilities */
     pi: typeof PiCodingAgent;
     on(event: "resources_discover", handler: ExtensionHandler<ResourcesDiscoverEvent, ResourcesDiscoverResult>): void;
@@ -596,6 +640,8 @@ export interface ExtensionAPI {
     on(event: "goal_updated", handler: ExtensionHandler<GoalUpdatedEvent>): void;
     on(event: "credential_disabled", handler: ExtensionHandler<CredentialDisabledEvent>): void;
     on(event: "input", handler: ExtensionHandler<InputEvent, InputEventResult>): void;
+    on(event: "tool_approval_requested", handler: ExtensionHandler<ToolApprovalRequestedEvent>): void;
+    on(event: "tool_approval_resolved", handler: ExtensionHandler<ToolApprovalResolvedEvent>): void;
     on(event: "tool_call", handler: ExtensionHandler<ToolCallEvent, ToolCallEventResult>): void;
     on(event: "tool_result", handler: ExtensionHandler<ToolResultEvent, ToolResultEventResult>): void;
     on(event: "user_bash", handler: ExtensionHandler<UserBashEvent, UserBashEventResult>): void;

package/dist/types/extensibility/hooks/index.d.ts

@@ -1,4 +1,5 @@
-export type { ReadonlySessionManager, UsageStatistics } from "../../session/session-manager";
+export type { UsageStatistics } from "../../session/session-entries";
+export type { ReadonlySessionManager } from "../../session/session-manager";
 export * from "./loader";
 export * from "./runner";
 export * from "./tool-wrapper";

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

@@ -1,7 +1,7 @@
 import type { ImageContent, Message, Model, TextContent } from "@oh-my-pi/pi-ai";
 import type { Component, TUI } from "@oh-my-pi/pi-tui";
 import type { logger as PiLogger } from "@oh-my-pi/pi-utils";
-import type * as Zod from "zod/v4";
+import type { z } from "zod/v4";
 import type { ModelRegistry } from "../../config/model-registry";
 import type { EditToolDetails } from "../../edit";
 import type { ExecOptions, ExecResult } from "../../exec/exec";
@@ -420,7 +420,7 @@ export interface HookAPI {
     /** Injected zod-backed typebox shim (legacy/compat — prefer `zod`). */
     typebox: typeof TypeBox;
     /** Injected zod module for Zod-authored hooks. */
-    zod: typeof Zod;
+    zod: typeof z;
     /** Injected pi-coding-agent exports */
     pi: typeof PiCodingAgent;
 }

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

@@ -13,6 +13,15 @@ import * as path from "node:path";
  * Exported for tests; production callers use `BUNFS_PACKAGE_ROOT` below.
  */
 export declare function __computeBunfsPackageRoot(metaDir: string, pathImpl?: typeof path): string;
+/**
+ * Compute the package root for the npm prebuilt `dist/cli.js` bundle.
+ *
+ * `bundle-dist.ts` defines `process.env.PI_BUNDLED="true"`; after bundling,
+ * `import.meta.dir` points at `<package>/dist`. Do not resolve the package via
+ * bare `@oh-my-pi/pi-coding-agent` here: from a global install Bun can pick an
+ * older cache entry, recreating mixed-runtime plugin loading.
+ */
+export declare function __computeBundledSelfPackageRoot(metaDir: string, pathImpl?: typeof path): string;
 /**
  * Drop overrides whose targets are missing on disk so they can fall through to
  * the canonical-resolution path. Exported for the test seam in #2168.

package/dist/types/extensibility/plugins/loader.d.ts

@@ -14,6 +14,17 @@ import type { InstalledPlugin } from "./types";
 export declare function getEnabledPlugins(cwd: string, opts?: {
     home?: string;
 }): Promise<InstalledPlugin[]>;
+/**
+ * Declared manifest entries paired with their resolved file path. Returns one
+ * record per declared entry — base entries first, then enabled-feature entries
+ * — so callers (e.g. install-time validation) can detect manifest entries that
+ * point at missing files instead of silently skipping them like
+ * {@link resolvePluginPaths} does.
+ */
+export declare function resolvePluginManifestEntries(plugin: InstalledPlugin, key: "tools" | "hooks" | "commands" | "extensions"): Array<{
+    entry: string;
+    resolvedPath: string | null;
+}>;
 export declare function resolvePluginToolPaths(plugin: InstalledPlugin): string[];
 export declare function resolvePluginHookPaths(plugin: InstalledPlugin): string[];
 export declare function resolvePluginCommandPaths(plugin: InstalledPlugin): string[];

package/dist/types/extensibility/shared-events.d.ts

@@ -17,7 +17,7 @@ import type { CompactionPreparation, CompactionResult } from "@oh-my-pi/pi-agent
 import type { ImageContent, TextContent, ToolResultMessage } from "@oh-my-pi/pi-ai";
 import type { Rule } from "../capability/rule";
 import type { Goal, GoalModeState } from "../goals/state";
-import type { BranchSummaryEntry, CompactionEntry, SessionEntry } from "../session/session-manager";
+import type { BranchSummaryEntry, CompactionEntry, SessionEntry } from "../session/session-entries";
 import type { TodoItem } from "../tools/todo";
 /** Fired on initial session load */
 export interface SessionStartEvent {

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

@@ -33,6 +33,16 @@ export declare function getActiveSkills(): readonly Skill[];
 export declare function setActiveSkills(value: readonly Skill[]): void;
 /** Reset the active skill snapshot. Test-only. */
 export declare function resetActiveSkillsForTests(): void;
+/**
+ * Whether `name` is already claimed by an active authored (non-managed) skill.
+ *
+ * Managed (auto-learn) skills resolve dead-last in discovery, so an authored
+ * skill of the same name always wins (see `loadSkills`) and a managed skill
+ * written under an authored name is silently dropped — it never surfaces.
+ * `manage_skill` create consults this to refuse the write up front instead of
+ * reporting a false "Created" for a skill that can never appear.
+ */
+export declare function isNameClaimedByAuthoredSkill(name: string): boolean;
 export interface LoadSkillsFromDirOptions {
     /** Directory to scan for skills */
     dir: string;

package/dist/types/goals/guided-setup.d.ts

@@ -0,0 +1,18 @@
+import type { AgentSession } from "../session/agent-session";
+export interface GuidedGoalMessage {
+    role: "user" | "assistant";
+    content: string;
+}
+export type GuidedGoalTurnResult = {
+    kind: "question";
+    question: string;
+    objective?: string;
+} | {
+    kind: "ready";
+    objective: string;
+};
+export interface GuidedGoalTurnOptions {
+    messages: readonly GuidedGoalMessage[];
+    signal?: AbortSignal;
+}
+export declare function runGuidedGoalTurn(session: AgentSession, options: GuidedGoalTurnOptions): Promise<GuidedGoalTurnResult>;

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

@@ -1,4 +1,4 @@
-import type { UsageStatistics } from "../session/session-manager";
+import type { UsageStatistics } from "../session/session-entries";
 export type GoalStatus = "active" | "paused" | "budget-limited" | "complete" | "dropped";
 export interface Goal {
     id: string;

package/dist/types/goals/tools/goal-tool.d.ts

@@ -1,6 +1,6 @@
 import type { AgentTool, AgentToolContext, AgentToolResult, AgentToolUpdateCallback } from "@oh-my-pi/pi-agent-core";
 import type { Component } from "@oh-my-pi/pi-tui";
-import * as z from "zod/v4";
+import { z } from "zod/v4";
 import type { RenderResultOptions } from "../../extensibility/custom-tools/types";
 import type { Theme } from "../../modes/theme/theme";
 import type { ToolSession } from "../../tools";

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

@@ -6,7 +6,7 @@
  * messages, and anything else that isn't a primary conversation turn. Each
  * surviving message's `TextContent` parts are joined with newlines.
  */
-import type { SessionEntry } from "../session/session-manager";
+import type { SessionEntry } from "../session/session-entries";
 import type { HindsightMessage } from "./content";
 export interface ReadonlySessionManagerLike {
     getEntries(): SessionEntry[];

package/dist/types/index.d.ts

@@ -25,8 +25,13 @@ export * from "./session/auth-storage";
 export * from "./session/indexed-session-storage";
 export * from "./session/messages";
 export * from "./session/redis-session-storage";
+export * from "./session/session-context";
 export * from "./session/session-dump-format";
+export * from "./session/session-entries";
+export * from "./session/session-listing";
+export * from "./session/session-loader";
 export * from "./session/session-manager";
+export * from "./session/session-migrations";
 export * from "./session/session-storage";
 export * from "./session/sql-session-storage";
 export * from "./task/executor";

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

@@ -3,8 +3,10 @@ export interface LocalProtocolOptions {
     getArtifactsDir?: () => string | null;
     getSessionId?: () => string | null;
 }
-export declare function resolveLocalRoot(options: LocalProtocolOptions): string;
-export declare function resolveLocalUrlToPath(input: string | InternalUrl, options: LocalProtocolOptions): string;
+/** Resolve the session-scoped local:// root, shortening long Windows artifact paths before writes hit MAX_PATH. */
+export declare function resolveLocalRoot(options: LocalProtocolOptions, platform?: NodeJS.Platform): string;
+/** Resolve a local:// URL to an on-disk path under the active session's local root. */
+export declare function resolveLocalUrlToPath(input: string | InternalUrl, options: LocalProtocolOptions, platform?: NodeJS.Platform): string;
 /**
  * On-disk roots the eval helpers (`read`/`write`/`append`) substitute for
  * internal-URL schemes so e.g. `write("local://x.md")` lands where a later

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

@@ -1,5 +1,5 @@
 import type { ptree } from "@oh-my-pi/pi-utils";
-import * as z from "zod/v4";
+import { z } from "zod/v4";
 export declare const lspSchema: z.ZodObject<{
     action: z.ZodEnum<{
         capabilities: "capabilities";

package/dist/types/main.d.ts

@@ -1,4 +1,4 @@
-import type { Args } from "./cli/args";
+import { type Args } from "./cli/args";
 import { ModelRegistry } from "./config/model-registry";
 import { type ScopedModel } from "./config/model-resolver";
 import { Settings } from "./config/settings";
@@ -7,14 +7,15 @@ import type { SubmittedUserInput } from "./modes/types";
 import { type CreateAgentSessionOptions, type CreateAgentSessionResult, createAgentSession, discoverAuthStorage } from "./sdk";
 import type { AgentSession } from "./session/agent-session";
 import type { AuthStorage } from "./session/auth-storage";
-import { type SessionInfo, SessionManager } from "./session/session-manager";
+import { type SessionInfo } from "./session/session-listing";
+import { SessionManager } from "./session/session-manager";
 type RunAcpMode = (createSession: AcpSessionFactory) => Promise<never>;
 export interface InteractiveModeNotify {
     kind: "warn" | "error" | "info";
     message: string;
 }
 export declare function buildModelScopeNotification(scopedModelsForDisplay: readonly Pick<ScopedModel, "model" | "thinkingLevel" | "explicitThinkingLevel">[], startupQuiet: boolean): InteractiveModeNotify | null;
-export declare function submitInteractiveInput(mode: Pick<InteractiveMode, "markPendingSubmissionStarted" | "finishPendingSubmission" | "showError" | "checkShutdownRequested">, session: Pick<AgentSession, "prompt" | "promptCustomMessage">, input: SubmittedUserInput): Promise<void>;
+export declare function submitInteractiveInput(mode: Pick<InteractiveMode, "markPendingSubmissionStarted" | "finishPendingSubmission" | "showError" | "checkShutdownRequested">, session: Pick<AgentSession, "prompt" | "promptCustomMessage" | "isStreaming">, input: SubmittedUserInput): Promise<void>;
 type AcpSessionFactory = (cwd: string) => Promise<AgentSession>;
 export interface AcpSessionFactoryOptions {
     baseOptions: CreateAgentSessionOptions;

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

@@ -104,6 +104,14 @@ export declare class MCPManager {
      * Get the source metadata for a server.
      */
     getSource(name: string): SourceMeta | undefined;
+    /**
+     * Get the preserved (pre-auth) config for a known server — whether currently
+     * connected or merely discovered (a connect was attempted but may have failed,
+     * e.g. an OAuth server that has not been authorized yet). Mirrors the
+     * reconnect lookup at {@link reconnectServer} so callers like `/mcp reauth`
+     * can recover a discovered server's config without re-reading config files.
+     */
+    getServerConfig(name: string): MCPServerConfig | undefined;
     /**
      * Wait for a connection to complete (or fail).
      */

package/dist/types/mcp/startup-events.d.ts

@@ -0,0 +1,11 @@
+export declare const MCP_CONNECTING_EVENT_CHANNEL = "mcp:connecting";
+export type McpConnectingEvent = {
+    serverNames: string[];
+};
+export declare function formatMCPConnectingMessage(serverNames: string[]): string;
+/**
+ * Runtime validator for the cross-module event payload. The event bus is
+ * untyped at runtime, so the subscriber verifies the shape before formatting
+ * rather than trusting a cast — a malformed emit is ignored instead of throwing.
+ */
+export declare function isMcpConnectingEvent(data: unknown): data is McpConnectingEvent;

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

@@ -1,5 +1,6 @@
 import type { ModelRegistry } from "../config/model-registry";
 import type { Settings } from "../config/settings";
+import type { MemoryBackendSaveInput, MemoryBackendSaveResult } from "../memory-backend/types";
 import type { AgentSession } from "../session/agent-session";
 /**
  * Start the background memory startup pipeline.
@@ -26,3 +27,9 @@ export declare function clearMemoryData(agentDir: string, cwd: string): Promise<
  */
 export declare function enqueueMemoryConsolidation(agentDir: string, cwd: string, sourceUpdatedAt?: number): void;
 export declare function getMemoryRoot(agentDir: string, cwd: string): string;
+/**
+ * Append one lesson to the project's `learned.md` (newest-first, deduped,
+ * capped, secret-redacted, injection-neutralized). The file backs the `learn`
+ * tool when `memory.backend` is `local`.
+ */
+export declare function saveLearnedLesson(agentDir: string, cwd: string, input: MemoryBackendSaveInput): Promise<MemoryBackendSaveResult>;

package/dist/types/memory-backend/local-backend.d.ts

@@ -2,8 +2,9 @@ import type { MemoryBackend } from "./types";
 /**
  * Wraps the existing `memories/` module as a `MemoryBackend`.
  *
- * No behavioural change — every call delegates to the legacy entry points so
- * the local memory pipeline (rollout summarisation → SQLite → memory_summary.md)
- * keeps working exactly as before.
+ * The rollout-summarisation pipeline (rollouts → SQLite → memory_summary.md) is
+ * delegated unchanged. On top of it, `save()` persists `learn`-tool lessons to
+ * `learned.md` (so `status()` reports `writable: true`); structured search is
+ * still unavailable.
  */
 export declare const localBackend: MemoryBackend;

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

@@ -28,4 +28,32 @@ export interface MnemopiBackendConfig {
     llmModel?: string;
 }
 export declare function loadMnemopiConfig(settings: Settings, agentDir: string): MnemopiBackendConfig;
+export interface MnemopiBankScope {
+    baseBank: string;
+    bank: string;
+    globalBank: string;
+    retainBank: string;
+    recallBanks: readonly string[];
+}
+/**
+ * Resolve write/recall banks for a session.
+ *
+ * Mnemopi has no tag-filtered recall, so `per-project-tagged` maps to a
+ * project-local write bank plus a shared recall-visible bank. The project
+ * bank is derived purely from {@link cwd} — see {@link projectBank} for the
+ * stability contract.
+ */
+export declare function computeMnemopiBankScope(configured: string | undefined, cwd: string, scoping: MnemopiScoping): MnemopiBankScope;
+/**
+ * Discover sibling banks under `<dbDir>/banks/` whose `working_memory` rows
+ * all carry the active `cwd` in `metadata_json.$.cwd`, and add those safe
+ * single-cwd banks to the recall set. This rescues memories stranded by a
+ * previous, less-stable bank derivation (#2412) without recalling mixed-cwd
+ * legacy banks wholesale under per-project isolation.
+ *
+ * Robust by design: a missing banks directory, unreadable bank dir, or
+ * corrupt SQLite file is silently skipped. Scanning is capped at
+ * {@link LEGACY_BANK_SCAN_LIMIT} to bound startup cost.
+ */
+export declare function extendRecallWithLegacyBanks(resolved: readonly string[], dbPath: string, cwd: string): readonly string[];
 export declare function truncateApproxTokens(text: string, tokenLimit: number): string;

package/dist/types/modes/acp/acp-agent.d.ts

@@ -1,4 +1,4 @@
-import { type Agent, type AgentSideConnection, type AuthenticateRequest, type AuthenticateResponse, type ClientCapabilities, type CloseSessionRequest, type CloseSessionResponse, type ForkSessionRequest, type ForkSessionResponse, type InitializeRequest, type InitializeResponse, type ListSessionsRequest, type ListSessionsResponse, type LoadSessionRequest, type LoadSessionResponse, type NewSessionRequest, type NewSessionResponse, type PromptRequest, type PromptResponse, type ResumeSessionRequest, type ResumeSessionResponse, type SetSessionConfigOptionRequest, type SetSessionConfigOptionResponse, type SetSessionModelRequest, type SetSessionModelResponse, type SetSessionModeRequest, type SetSessionModeResponse } from "@agentclientprotocol/sdk";
+import { type Agent, type AgentSideConnection, type AuthenticateRequest, type AuthenticateResponse, type ClientCapabilities, type CloseSessionRequest, type CloseSessionResponse, type ForkSessionRequest, type ForkSessionResponse, type InitializeRequest, type InitializeResponse, type ListSessionsRequest, type ListSessionsResponse, type LoadSessionRequest, type LoadSessionResponse, type NewSessionRequest, type NewSessionResponse, type PromptRequest, type PromptResponse, type ResumeSessionRequest, type ResumeSessionResponse, type SetSessionConfigOptionRequest, type SetSessionConfigOptionResponse, type SetSessionModeRequest, type SetSessionModeResponse } from "@agentclientprotocol/sdk";
 import { type ExtensionUIContext } from "../../extensibility/extensions";
 import type { AgentSession } from "../../session/agent-session";
 /**
@@ -42,7 +42,6 @@ export declare class AcpAgent implements Agent {
     closeSession(params: CloseSessionRequest): Promise<CloseSessionResponse>;
     setSessionMode(params: SetSessionModeRequest): Promise<SetSessionModeResponse>;
     setSessionConfigOption(params: SetSessionConfigOptionRequest): Promise<SetSessionConfigOptionResponse>;
-    unstable_setSessionModel(params: SetSessionModelRequest): Promise<SetSessionModelResponse>;
     prompt(params: PromptRequest): Promise<PromptResponse>;
     cancel(params: {
         sessionId: string;

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

@@ -52,6 +52,12 @@ export interface AgentHubDeps {
 export declare class AgentHubOverlayComponent extends Container {
     #private;
     constructor(deps: AgentHubDeps);
+    /**
+     * Whether the table view has no agents to show (every registered agent except
+     * Main, after the persisted-subagent scan in the constructor). The double-←
+     * gesture reads this to stay inert when there is nothing to open.
+     */
+    get isEmpty(): boolean;
     /** Tear down every subscription and timer. Called by the overlay owner on close. */
     dispose(): void;
     render(width: number): readonly string[];

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

@@ -1,4 +1,4 @@
-import type { AssistantMessage, ImageContent, Usage } from "@oh-my-pi/pi-ai";
+import type { AssistantMessage, ImageContent } from "@oh-my-pi/pi-ai";
 import { Container, type ImageBudget } from "@oh-my-pi/pi-tui";
 import type { AssistantThinkingRenderer } from "../../extensibility/extensions/types";
 /**
@@ -22,7 +22,6 @@ export declare class AssistantMessageComponent extends Container {
     getTranscriptBlockVersion(): number;
     markTranscriptBlockFinalized(): void;
     setToolResultImages(toolCallId: string, images: ImageContent[]): void;
-    setUsageInfo(usage: Usage): void;
     updateContent(message: AssistantMessage, opts?: {
         transient?: boolean;
     }): void;

package/dist/types/modes/components/compaction-summary-message.d.ts

@@ -1,5 +1,5 @@
 import { type Component } from "@oh-my-pi/pi-tui";
-import type { CompactionSummaryMessage } from "../../session/messages";
+import type { CompactionSummaryMessage, CustomMessage } from "../../session/messages";
 /**
  * Compaction point in the transcript, rendered as a slim horizontal divider:
  *
@@ -17,3 +17,17 @@ export declare class CompactionSummaryMessageComponent implements Component {
     invalidate(): void;
     render(width: number): readonly string[];
 }
+/**
+ * Handoff is a compaction strategy too, but it is persisted as a custom message
+ * so the LLM sees the handoff-specific developer context. Render it with the
+ * same divider affordance as `/compact` instead of the generic `[handoff]` box.
+ */
+export declare class HandoffSummaryMessageComponent implements Component {
+    #private;
+    private readonly message;
+    constructor(message: CustomMessage<unknown>);
+    setExpanded(expanded: boolean): void;
+    invalidate(): void;
+    render(width: number): readonly string[];
+}
+export declare function createHandoffSummaryMessageComponent(message: CustomMessage<unknown>, expanded: boolean): HandoffSummaryMessageComponent | undefined;

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

@@ -1,6 +1,13 @@
 import { Editor, type KeyId } from "@oh-my-pi/pi-tui";
 import type { AppKeybinding } from "../../config/keybindings";
 type ConfigurableEditorAction = Extract<AppKeybinding, "app.interrupt" | "app.clear" | "app.exit" | "app.suspend" | "app.display.reset" | "app.thinking.cycle" | "app.model.cycleForward" | "app.model.cycleBackward" | "app.model.select" | "app.model.selectTemporary" | "app.tools.expand" | "app.thinking.toggle" | "app.editor.external" | "app.history.search" | "app.message.dequeue" | "app.clipboard.pasteImage" | "app.clipboard.pasteTextRaw" | "app.clipboard.copyPrompt">;
+/** Plain spaces from one auto-repeat run that trigger the space-hold push-to-talk STT gesture.
+ *  Holding the space bar makes the terminal emit a burst of spaces; once more than this many land
+ *  in the editor we treat it as "space held", track them back out, and start recording. */
+export declare const SPACE_HOLD_THRESHOLD = 5;
+/** Idle gap (ms) after the last repeated space that counts as the space bar being released, ending
+ *  the push-to-talk recording. Must comfortably exceed the OS key-repeat interval. */
+export declare const SPACE_HOLD_RELEASE_MS = 250;
 export declare function extractBracketedImagePastePaths(data: string): string[] | undefined;
 export declare function extractBracketedImagePastePath(data: string): string | undefined;
 /**
@@ -12,10 +19,32 @@ export declare class CustomEditor extends Editor {
     /** Treat image/paste markers as indivisible: a stray backspace deletes the whole token
      *  instead of corrupting `[Paste #1, +30 lines]` into plain text. */
     atomicTokenPattern: RegExp;
+    /** Magic-keyword shimmer cadence — drives one editor repaint every 70 ms while
+     *  a keyword is on screen and the prompt is focused. ~14 frames/s is smooth
+     *  without flooding the renderer. */
+    static readonly SHIMMER_FRAME_MS = 70;
+    /** Time for the gradient to sweep one full cycle across each keyword. */
+    static readonly SHIMMER_PERIOD_MS = 1800;
     /** Gradient-highlight the "ultrathink" / "orchestrate" / "workflowz" keywords as the user types
      *  them, skipping any occurrence inside code spans, fenced blocks, or XML sections. Also make
-     *  pasted image placeholders visually distinct and hyperlink them once their blob file exists. */
+     *  pasted image placeholders visually distinct and hyperlink them once their blob file exists.
+     *  When the editor is focused, the buffer contains a magic keyword, and `magicKeywords.enabled`
+     *  is on, the gradient shifts every frame to produce a Claude-Code-style shimmer; each render
+     *  schedules the next frame, so losing focus, deleting the keyword, or flipping the setting
+     *  stops the animation on its own. The static glow itself runs even when shimmering is gated
+     *  off, matching existing behavior for the editor and sent bubbles. */
     decorateText: (text: string) => string;
+    /** Optional test/host override for the magic-keyword shimmer gate. When
+     *  defined, takes precedence over the global `magicKeywords.enabled` setting,
+     *  letting tests assert the gating behaviour without mutating the
+     *  process-wide Settings singleton (which races with parallel test files —
+     *  see issue #2582). Production wires this through the host's Settings
+     *  reader and updates it on the relevant setting change. */
+    magicKeywordsEnabledOverride: boolean | undefined;
+    /** Bind the host's render request callback. Idempotent — the host wires this
+     *  once after construction (and again after `setEditorComponent` swaps the
+     *  editor). Passing `undefined` clears any pending frame. */
+    setShimmerRepaintHandler(handler: (() => void) | undefined): void;
     onEscape?: () => void;
     onClear?: () => void;
     onExit?: () => void;
@@ -44,6 +73,15 @@ export declare class CustomEditor extends Editor {
     onCapsLock?: () => void;
     /** Called when left-arrow is pressed while the editor is empty (cursor necessarily at start). */
     onLeftAtStart?: () => void;
+    /** Fired when a sustained space-bar hold is recognized — the push-to-talk STT start. The
+     *  optimistically-typed spaces have already been deleted by the time this runs. */
+    onSpaceHoldStart?: () => void;
+    /** Fired when the held space bar is released (detected as an idle gap with no further repeated
+     *  spaces) — the push-to-talk STT stop. */
+    onSpaceHoldEnd?: () => void;
+    /** Gate for the space-hold gesture. Returns false to keep the space bar inserting spaces
+     *  normally; wired to `stt.enabled` so disabling STT restores plain space behavior. */
+    sttHoldEnabled?: () => boolean;
     setActionKeys(action: ConfigurableEditorAction, keys: KeyId[]): void;
     /**
      * Register a custom key handler. Extensions use this for shortcuts.

package/dist/types/modes/components/custom-editor.test.d.ts

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

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

@@ -15,6 +15,7 @@ export * from "./hook-message";
 export * from "./hook-selector";
 export * from "./keybinding-hints";
 export * from "./login-dialog";
+export * from "./logout-account-selector";
 export * from "./model-selector";
 export * from "./oauth-selector";
 export * from "./queue-mode-selector";

package/dist/types/modes/components/logout-account-selector.d.ts

@@ -0,0 +1,8 @@
+import { Container } from "@oh-my-pi/pi-tui";
+import type { LogoutAccount } from "../../slash-commands/helpers/logout";
+/** Account picker for `/logout` after the provider has been selected. */
+export declare class LogoutAccountSelectorComponent extends Container {
+    #private;
+    constructor(providerName: string, accounts: LogoutAccount[], onSelect: (account: LogoutAccount) => void, onCancel: () => void);
+    handleInput(keyData: string): void;
+}

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

@@ -1,5 +1,5 @@
 import { type Component, Container } from "@oh-my-pi/pi-tui";
-import type { SessionInfo } from "../../session/session-manager";
+import type { SessionInfo } from "../../session/session-listing";
 /** Returns the IDs of sessions whose recorded prompts match a query, best first. */
 export type SessionHistoryMatcher = (query: string) => string[];
 /**

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

@@ -40,13 +40,17 @@ export declare class StatusLineComponent implements Component {
      */
     refreshUsageInBackground(): void;
     /**
-     * Compute the (cached) used-tokens / context-window totals for the
-     * status-line context% segment. Exposed (non-private) so unit tests can
-     * verify the incremental-cache invariants; not part of any external
-     * API.
+     * Used-tokens / context-window totals for the status-line context% segment,
+     * memoized so the per-event redraw stays O(1) when nothing changed.
+     *
+     * The numerator comes from `session.getContextUsage()`, which anchors on the
+     * last assistant's real prompt-token count — so the bar matches the provider
+     * and the `/context` panel — and reports `null` while that count is unknown
+     * (right after compaction, before the next response). Exposed (non-private)
+     * for unit tests and the collab host's state broadcast.
      */
     getCachedContextBreakdown(): {
-        usedTokens: number;
+        usedTokens: number | null;
         contextWindow: number;
     };
     getTopBorder(width: number): {

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

@@ -70,7 +70,8 @@ export interface SegmentContext {
         cost: number;
         tokensPerSecond: number | null;
     };
-    contextPercent: number;
+    /** Context usage percent, or null when unknown (e.g. right after compaction). */
+    contextPercent: number | null;
     contextWindow: number;
     autoCompactEnabled: boolean;
     subagentCount: number;