@oh-my-pi/pi-coding-agent 17.1.7 → 17.2.0

package/dist/types/modes/components/codex-reset-fireworks.d.ts

@@ -0,0 +1,51 @@
+import { type Component, type OverlayHandle, type OverlayOptions } from "@oh-my-pi/pi-tui";
+/** The active Codex account fields retained between status refreshes. */
+export interface CodexResetUsageSnapshot {
+    /** When this usage report was observed, if supplied by the provider. */
+    observedAt?: number;
+    /** Weekly usage, its quota identity, and its previously scheduled reset deadline. */
+    sevenDay?: {
+        percent: number;
+        resetsAt?: number;
+        tier?: string;
+        plan?: string;
+    };
+    savedResets?: number;
+}
+/** A detected Codex quota event that can trigger the fireworks presentation. */
+export type CodexResetFireworksEvent = {
+    kind: "unscheduled-weekly-reset";
+} | {
+    kind: "saved-reset-banked";
+    added: number;
+    available: number;
+};
+interface CodexResetFireworksHost {
+    ui: {
+        showOverlay(component: Component, options?: OverlayOptions): OverlayHandle;
+        setFocus(component: Component): void;
+        requestRender(): void;
+        readonly terminal: {
+            readonly rows: number;
+        };
+    };
+}
+/**
+ * Compare consecutive reports for one Codex account. A saved-reset grant takes
+ * precedence when both changes arrive in the same report. A verified decrease,
+ * or a prior positive balance becoming unavailable, suppresses the weekly event
+ * because the user may have redeemed a credit. Other weekly usage drops are
+ * celebrated only before the previously scheduled reset deadline.
+ */
+export declare function detectCodexResetFireworks(previous: CodexResetUsageSnapshot, current: CodexResetUsageSnapshot): CodexResetFireworksEvent | undefined;
+/** Owns the at-most-one modal celebration lifecycle for an interactive session. */
+export declare class CodexResetFireworksController {
+    #private;
+    private readonly host;
+    constructor(host: CodexResetFireworksHost);
+    /** Present a celebration unless another one already owns the modal overlay. */
+    show(event: CodexResetFireworksEvent): boolean;
+    /** Stop the active celebration and release its overlay, if present. */
+    dispose(): void;
+}
+export {};

package/dist/types/modes/components/read-tool-group.d.ts

@@ -1,3 +1,4 @@
+import type { AssistantMessage, Usage } from "@oh-my-pi/pi-ai";
 import type { Component } from "@oh-my-pi/pi-tui";
 import { Container } from "@oh-my-pi/pi-tui";
 import type { ToolExecutionHandle } from "./tool-execution.js";
@@ -10,6 +11,12 @@ export declare function readArgsHaveTarget(args: unknown): boolean;
  * they list devices/docs and read better in the compact grouped view.
  */
 export declare function readArgsCollapseIntoGroup(args: unknown): boolean;
+/**
+ * Return the collapsed read calls that can own a turn's usage row. Mixed-tool
+ * turns and visible content after a read keep the standalone row so request
+ * metrics retain their transcript ordering.
+ */
+export declare function groupedReadUsageCallIds(message: AssistantMessage): string[] | undefined;
 type ReadRenderArgs = {
     path?: string;
     file_path?: string;
@@ -37,6 +44,11 @@ export declare class ReadToolGroupComponent extends Container implements ToolExe
         details?: unknown;
         isError?: boolean;
     }, isPartial?: boolean, toolCallId?: string): void;
+    /**
+     * Nest one request's usage beneath the last visible read call from that
+     * request. Parallel reads share one row rather than duplicating request totals.
+     */
+    attachUsage(toolCallIds: readonly string[], usage: Usage, durationMs?: number, ttftMs?: number, timestamp?: number): boolean;
     setArgsComplete(_toolCallId?: string): void;
     setExpanded(expanded: boolean): void;
     getComponent(): Component;

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

@@ -63,6 +63,12 @@ export interface SessionSelectorOptions {
     loadAllSessions?: () => Promise<SessionInfo[]>;
     /** Preloaded all-projects list; cached so the first Tab toggle is instant. */
     allSessions?: SessionInfo[];
+    /** Picker heading; defaults to "Resume Session". */
+    title?: string;
+    /** Fixed scope label, or false to omit the scope suffix. */
+    scopeLabel?: string | false;
+    /** Show each session's working directory in the list. */
+    showCwd?: boolean;
     /**
      * Reads the live terminal height so the visible window fits the viewport.
      * Omitted only in tests; defaults to a conservative 24 rows.

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

@@ -1,5 +1,6 @@
 import { type Component } from "@oh-my-pi/pi-tui";
 import type { AgentSession } from "../../../session/agent-session.js";
+import { type CodexResetFireworksEvent } from "../codex-reset-fireworks.js";
 import { type SegmentContext } from "./segments.js";
 import type { CollabStatus, EffectiveStatusLineSettings, StatusLineSettings } from "./types.js";
 export declare class StatusLineComponent implements Component {
@@ -73,10 +74,32 @@ export declare class StatusLineComponent implements Component {
      */
     setVibeWorkerTokenRateProvider(provider: (() => number | null) | undefined): void;
     setCollabStatus(status: CollabStatus | null): void;
+    /** Set the callback that presents detected Codex reset celebrations, or clear it with `undefined`. */
+    setCodexResetFireworksHandler(handler: ((event: CodexResetFireworksEvent) => void) | undefined): void;
     setHookStatus(key: string, text: string | undefined): void;
     watchBranch(onBranchChange: () => void): void;
     dispose(): void;
     invalidate(): void;
+    /**
+     * Explicit Git/repository cache invalidation. Aborts any in-flight
+     * reftable HEAD/PR resolve, bumps the stale-result generation, and drops
+     * the branch/PR/jj caches so the next render refetches from disk. Called
+     * by the git watcher on a HEAD move and by {@link applyCwdChange} on a
+     * repo/cwd switch. Generic repaints use {@link invalidate} instead and
+     * must never reach this path.
+     */
+    invalidateGitCaches(): void;
+    /**
+     * Re-point the status line's VCS watcher and caches at a new cwd/repository.
+     * Atomically retires the old watcher/listeners, invalidates VCS caches and
+     * in-flight controllers, then runs watcher setup for the new cwd and requests
+     * a repaint. Called by {@link InteractiveMode.applyCwdChange} after the
+     * SessionManager's cwd has moved — the watcher ownership always follows the
+     * effective cwd/repo, so a stale watcher for the previous repo can never
+     * invalidate the new one. Generic repaints use {@link invalidate} and must
+     * never retire the watcher or abort a live resolve.
+     */
+    applyCwdChange(): void;
     /**
      * Startup redraws only arm a short-delayed task; timeout releases the render
      * cadence while a late successful fetch can still refresh the cached segment.

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

@@ -1,4 +1,4 @@
-import type { SnapshotStore } from "@oh-my-pi/hashline";
+import type { Clipboard, SnapshotStore } from "@oh-my-pi/hashline";
 import type { AgentTool } from "@oh-my-pi/pi-agent-core";
 import { type Component, Container, type NativeScrollbackLiveRegion, type TUI } from "@oh-my-pi/pi-tui";
 /**
@@ -8,6 +8,13 @@ import { type Component, Container, type NativeScrollbackLiveRegion, type TUI }
  */
 export interface TranscriptLiveRegionProbe {
     isBlockInLiveRegion(component: Component): boolean;
+    /**
+     * Whether none of the block's rows have entered native scrollback (see
+     * `TranscriptContainer.isBlockUncommitted`). Optional: standalone hosts
+     * without commit tracking omit it, and blocks treat their rows as
+     * uncommitted.
+     */
+    isBlockUncommitted?(component: Component): boolean;
 }
 /** Minimal TUI surface ToolExecutionComponent uses to schedule repaints and share image budget. */
 export interface ToolExecutionUi {
@@ -18,6 +25,8 @@ export interface ToolExecutionUi {
 }
 export interface ToolExecutionOptions {
     snapshots?: SnapshotStore;
+    /** Session-persistent edit clipboard register, forked per preview frame. */
+    clipboard?: Clipboard;
     showImages?: boolean;
     editFuzzyThreshold?: number;
     editAllowFuzzy?: boolean;
@@ -94,12 +103,12 @@ export declare class ToolExecutionComponent extends Container implements NativeS
     getNativeScrollbackLiveRegionStart(): number | undefined;
     /**
      * Keeps in-flight TV-wall frames out of immutable native scrollback: the
-     * `vibe_wait` wall and displaceable snapshots (`hub` waiting polls, `todo`
-     * lists). Their frames replace each other rather than append, and their
-     * rows mutate every spinner tick — an unpinned commit records a per-tick
-     * frozen snapshot AND force-seals the block (see TranscriptContainer's
-     * committed-snapshot seal), so the next poll stacks a new frame instead of
-     * displacing this one.
+     * `vibe_wait` wall, displaceable snapshots (`hub` waiting polls, `todo`
+     * lists), and live `task` calls. Their frames replace each other rather
+     * than append — task progress rows rewrite in place on every snapshot —
+     * so an unpinned commit records a per-tick frozen snapshot (and for
+     * displaceable blocks force-seals them, stacking the next poll below).
+     * The finalized frame commits exactly once when the pin lifts.
      */
     isNativeScrollbackLiveRegionPinned(): boolean;
     /**

package/dist/types/modes/components/usage-row.d.ts

@@ -1,3 +1,5 @@
 import type { Usage } from "@oh-my-pi/pi-ai";
 import { Container } from "@oh-my-pi/pi-tui";
+/** Format the metrics shared by standalone usage blocks and compact tool groups. */
+export declare function formatUsageRow(usage: Usage, durationMs?: number, ttftMs?: number, timestamp?: number): string;
 export declare function createUsageRowBlock(usage: Usage, durationMs?: number, ttftMs?: number, timestamp?: number): Container;

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

@@ -1,5 +1,5 @@
 import { type Component } from "@oh-my-pi/pi-tui";
-import type { MCPAuthChallenge, MCPServerConfig } from "../../mcp/types.js";
+import type { MCPAuthChallenge, MCPConfigFile, MCPServerConfig } from "../../mcp/types.js";
 import type { InteractiveModeContext } from "../types.js";
 /**
  * Renders the MCP OAuth fallback URL. Always shows the full authorization URL
@@ -34,6 +34,31 @@ export declare class MCPAuthorizationLinkPrompt implements Component {
 export declare class MCPOAuthCancelledError extends Error {
     constructor(message?: string);
 }
+/**
+ * Collect the de-duplicated union of every MCP server name we know about:
+ * user config, project config, and any runtime-discovered servers not
+ * already present in either config (`ctx.mcpManager.getAllServerNames()`
+ * covers connections, pending connections, and discovered-but-not-yet-
+ * connected sources).
+ *
+ * `includeDisabledOnly` controls names found only in
+ * `userConfig.disabledServers`, while `includeDisabledConfigured` controls
+ * config entries whose `enabled` flag is false. Both default to true because
+ * callers such as `/mcp list` need the complete union. Autocomplete callers
+ * must disable the categories their target operation cannot accept.
+ *
+ * This is the single source of truth for "every known server name": both
+ * `MCPCommandController#handleList()` and the `/mcp` slash-command argument
+ * completer (server-name autocomplete for `enable`/`disable`/`test`/etc.)
+ * call this instead of re-deriving the union themselves.
+ *
+ * `preloaded` lets a caller that already read both config files (e.g.
+ * `#handleList()`) pass them in and skip the redundant re-read.
+ */
+export declare function collectMcpServerNames(ctx: InteractiveModeContext, preloaded?: {
+    userConfig: MCPConfigFile;
+    projectConfig: MCPConfigFile;
+}, includeDisabledOnly?: boolean, includeDisabledConfigured?: boolean): Promise<string[]>;
 export declare class MCPCommandController {
     #private;
     private ctx;

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

@@ -1,5 +1,6 @@
 import type { Component } from "@oh-my-pi/pi-tui";
 import type { InteractiveModeContext } from "../../modes/types.js";
+import type { ForeignSessionSource } from "../../session/foreign-session-store.js";
 import type { SessionObserverRegistry } from "../session-observer-registry.js";
 export declare class SelectorController {
     #private;
@@ -49,7 +50,7 @@ export declare class SelectorController {
     showUserMessageSelector(): void;
     showCopySelector(): void;
     showTreeSelector(): void;
-    showSessionSelector(): Promise<void>;
+    showSessionSelector(source?: ForeignSessionSource): Promise<void>;
     handleResumeSession(sessionPath: string, options?: {
         settingsFlushed?: boolean;
     }): Promise<boolean>;

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

@@ -14,11 +14,13 @@ import type { MCPManager } from "../mcp/index.js";
 import { type PlanApprovalDetails } from "../plan-mode/approved-plan.js";
 import { type AgentSession } from "../session/agent-session.js";
 import type { CompactMode } from "../session/compact-modes.js";
+import type { ForeignSessionSource } from "../session/foreign-session-store.js";
 import { HistoryStorage } from "../session/history-storage.js";
 import type { SessionContext } from "../session/session-context.js";
 import type { SessionManager } from "../session/session-manager.js";
 import type { ShakeMode } from "../session/shake-types.js";
 import type { LspStartupServerInfo } from "../tools/index.js";
+import { type StartupChangelogSelection } from "../utils/changelog.js";
 import type { EventBus } from "../utils/event-bus.js";
 import type { AssistantMessageComponent } from "./components/assistant-message.js";
 import type { BashExecutionComponent } from "./components/bash-execution.js";
@@ -174,7 +176,7 @@ export declare class InteractiveMode implements InteractiveModeContext {
     focusParentSession(): Promise<void>;
     unfocusSession(): Promise<void>;
     clearTransientSessionUi(): void;
-    constructor(session: AgentSession, version: string, changelogMarkdown?: string | undefined, setToolUIContext?: (uiContext: ExtensionUIContext, hasUI: boolean) => void, lspServers?: LspStartupServerInfo[] | undefined, mcpManager?: MCPManager, eventBus?: EventBus);
+    constructor(session: AgentSession, version: string, startupChangelog?: StartupChangelogSelection | undefined, setToolUIContext?: (uiContext: ExtensionUIContext, hasUI: boolean) => void, lspServers?: LspStartupServerInfo[] | undefined, mcpManager?: MCPManager, eventBus?: EventBus);
     playWelcomeIntro(): void;
     init(options?: InteractiveModeInitOptions): Promise<void>;
     /** Reload the title-generation system prompt override for the provided working
@@ -257,9 +259,10 @@ export declare class InteractiveMode implements InteractiveModeContext {
     handlePlanModeCommand(initialPrompt?: string): Promise<void>;
     /**
      * `/vibe` toggle. Entering installs the ephemeral vibe tools, strips the
-     * active toolset down to `read` plus those tools, and injects the director
-     * context. Exiting unregisters them, restores the previous toolset, and kills
-     * every worker session so workers cannot outlive the mode that directs them.
+     * active toolset down to `read`, optional parent-owned `todo`, plus those
+     * tools, and injects the director context. Exiting unregisters them, restores
+     * the previous toolset, and kills every worker session so workers cannot
+     * outlive the mode that directs them.
      */
     handleVibeModeCommand(initialPrompt?: string): Promise<void>;
     handleGoalModeCommand(rest?: string): Promise<void>;
@@ -368,7 +371,7 @@ export declare class InteractiveMode implements InteractiveModeContext {
     showUserMessageSelector(): void;
     showCopySelector(): void;
     showTreeSelector(): void;
-    showSessionSelector(): void;
+    showSessionSelector(source?: ForeignSessionSource): void;
     handleResumeSession(sessionPath: string): Promise<void>;
     handleSessionDeleteCommand(): Promise<void>;
     showOAuthSelector(mode: "login" | "logout", providerId?: string): Promise<void>;

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

@@ -135,6 +135,13 @@ export declare class RpcClient {
      * Get current session state.
      */
     getState(): Promise<RpcSessionState>;
+    /**
+     * Enable or disable fast mode for the active model family.
+     */
+    setFastMode(enabled: boolean): Promise<{
+        enabled: boolean;
+        active: boolean;
+    }>;
     /**
      * Configure subagent frames emitted by the RPC server. Servers default to "off".
      * "progress" emits lifecycle/progress frames; "events" additionally emits raw subagent session events.

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

@@ -50,6 +50,10 @@ export type RpcCommand = {
 } | {
     id?: string;
     type: "get_state";
+} | {
+    id?: string;
+    type: "set_fast_mode";
+    enabled: boolean;
 } | {
     id?: string;
     type: "get_available_commands";
@@ -187,6 +191,9 @@ export interface RpcSessionState {
     sessionId: string;
     sessionName?: string;
     autoCompactionEnabled: boolean;
+    fastModeEnabled: boolean;
+    fastModeActive: boolean;
+    tokensPerSecond: number | null;
     messageCount: number;
     queuedMessageCount: number;
     todoPhases: TodoPhase[];
@@ -315,6 +322,15 @@ export type RpcResponse = {
     command: "get_state";
     success: true;
     data: RpcSessionState;
+} | {
+    id?: string;
+    type: "response";
+    command: "set_fast_mode";
+    success: true;
+    data: {
+        enabled: boolean;
+        active: boolean;
+    };
 } | {
     id?: string;
     type: "response";

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

@@ -1,6 +1,6 @@
 import type { ThinkingLevel } from "@oh-my-pi/pi-agent-core";
 import type { Effort } from "@oh-my-pi/pi-ai";
-import type { EditorTheme, MarkdownTheme, SelectListTheme, SettingsListTheme, SymbolTheme } from "@oh-my-pi/pi-tui";
+import type { EditorTheme, MarkdownTheme, SelectListTheme, SettingsListTheme, SymbolTheme, Terminal } from "@oh-my-pi/pi-tui";
 export { getLanguageFromPath, isMarkdownPath } from "../../utils/lang-from-path.js";
 export type SymbolPreset = "unicode" | "nerd" | "ascii";
 /**
@@ -328,6 +328,17 @@ export declare function getAvailableSymbolPresets(): SymbolPreset[];
  * Check if a string is a valid symbol preset.
  */
 export declare function isValidSymbolPreset(preset: string): preset is SymbolPreset;
+type MacOSAppearanceReprobeTerminal = Pick<Terminal, "appearance" | "onAppearanceChange" | "onAppearanceReport" | "onPrivateModeReport" | "refreshAppearance">;
+/**
+ * Fall back to native macOS appearance notifications when the terminal
+ * explicitly confirms that Mode 2031 notifications are unsupported.
+ *
+ * Native notifications provisionally repaint from the host appearance and
+ * synchronously trigger an OSC 11 probe, followed by a bounded burst of six
+ * retries. A changed terminal classification cancels the sequence; otherwise
+ * a confirmed terminal classification is restored at the validation deadline.
+ */
+export declare function startMacOSAppearanceReprobeFallback(terminal: MacOSAppearanceReprobeTerminal): () => void;
 export declare function stopThemeWatcher(): void;
 /**
  * Get resolved theme colors as CSS-compatible hex strings.

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

@@ -13,6 +13,7 @@ import type { MCPManager } from "../mcp/index.js";
 import type { PlanApprovalDetails } from "../plan-mode/approved-plan.js";
 import type { AgentSession } from "../session/agent-session.js";
 import type { CompactMode } from "../session/compact-modes.js";
+import type { ForeignSessionSource } from "../session/foreign-session-store.js";
 import type { HistoryStorage } from "../session/history-storage.js";
 import type { SessionContext } from "../session/session-context.js";
 import type { SessionManager } from "../session/session-manager.js";
@@ -357,7 +358,7 @@ export interface InteractiveModeContext {
     showUserMessageSelector(): void;
     showCopySelector(): void;
     showTreeSelector(): void;
-    showSessionSelector(): void;
+    showSessionSelector(source?: ForeignSessionSource): void;
     handleResumeSession(sessionPath: string): Promise<void>;
     handleSessionDeleteCommand(): Promise<void>;
     showOAuthSelector(mode: "login" | "logout", providerId?: string): Promise<void>;

package/dist/types/sdk.d.ts

@@ -270,6 +270,7 @@ export type * from "./extensibility/extensions/index.js";
 export type { Skill } from "./extensibility/skills.js";
 export type { FileSlashCommand } from "./extensibility/slash-commands.js";
 export type { MCPManager, MCPServerConfig, MCPServerConnection, MCPToolsLoadResult } from "./mcp/index.js";
+export { type AgentRef, AgentRegistry, MAIN_AGENT_ID } from "./registry/agent-registry.js";
 export type { Tool } from "./tools/index.js";
 export { buildDirectoryTree, buildWorkspaceTree, type DirectoryTree, type WorkspaceTree } from "./workspace-tree.js";
 export { BashTool, BUILTIN_TOOLS, createTools, EditTool, EvalTool, GlobTool, GrepTool, HIDDEN_TOOLS, ReadTool, type ToolSession, WebSearchTool, WriteTool, };

package/dist/types/session/agent-session-events.d.ts

@@ -50,6 +50,8 @@ export type AgentSessionEvent = Exclude<AgentEvent, {
     type: "retry_fallback_succeeded";
     model: string;
     role: string;
+} | {
+    type: "model_changed";
 } | {
     type: "ttsr_triggered";
     rules: Rule[];

package/dist/types/session/agent-session-types.d.ts

@@ -1,4 +1,4 @@
-import type { Agent, AgentMessage, AgentTool, StreamFn, ThinkingLevel } from "@oh-my-pi/pi-agent-core";
+import type { Agent, AgentMessage, AgentTool, AgentToolContext, StreamFn, ThinkingLevel } from "@oh-my-pi/pi-agent-core";
 import type { Context, Effort, ImageContent, Message, MessageAttribution, Model, OAuthAccountSummary, ServiceTierByFamily, SimpleStreamOptions, ToolChoice } from "@oh-my-pi/pi-ai";
 import type { postmortem } from "@oh-my-pi/pi-utils";
 import type { AdvisorConfig } from "../advisor/index.js";
@@ -6,6 +6,7 @@ import type { AsyncJob, AsyncJobDeliveryState, AsyncJobManager } from "../async/
 import type { ModelRegistry } from "../config/model-registry.js";
 import type { PromptTemplate } from "../config/prompt-templates.js";
 import type { Settings, SkillsSettings } from "../config/settings.js";
+import type { CursorMcpResourceAdapter } from "../cursor.js";
 import type { RawSseDebugBuffer } from "../debug/raw-sse-buffer.js";
 import type { TtsrManager } from "../export/ttsr.js";
 import type { LoadedCustomCommand } from "../extensibility/custom-commands/index.js";
@@ -143,6 +144,8 @@ export interface AgentSessionConfig {
     sideStreamFn?: StreamFn;
     /** Stream wrapper for advisor requests. */
     advisorStreamFn?: StreamFn;
+    /** Advisor spend already recorded for the session being opened, restored on resume. */
+    initialAdvisorCosts?: ReadonlyMap<string, number>;
     /** Prefer websocket transport for OpenAI Codex requests when supported. */
     preferWebsockets?: boolean;
     /** Provider payload hook used by the active session request path. */
@@ -194,6 +197,38 @@ export interface AgentSessionConfig {
     providerPromptCacheKeySource?: "explicit" | "fork";
     /** Full advisor toolset built against an advisor-scoped tool session. */
     advisorTools?: AgentTool[];
+    /**
+     * Build a `grep` honoring a Cursor `pi_grep` frame's own context width and
+     * match cap, against the advisor-scoped tool session. Without it an advisor
+     * running on Cursor silently drops both fields.
+     */
+    advisorCreateGrepTool?(options: {
+        context?: number;
+        totalMatchLimit?: number;
+    }): AgentTool | undefined;
+    /**
+     * Build the `replace`-mode `edit` a Cursor `pi_edit` frame needs, against the
+     * advisor-scoped tool session. The advisor's ordinary instance follows the
+     * configured `edit.mode` and rejects the frame's `old_text`/`new_text` pairs.
+     */
+    advisorCreateEditTool?(): AgentTool | undefined;
+    /**
+     * The execute-time context the advisor's bridge tools resolve approval from.
+     *
+     * `ExtensionToolWrapper` reads `tools.approvalMode`, per-tool
+     * `tools.approval.<tool>` policies and `autoApprove` only from this context;
+     * with none it defaults to `yolo` with empty policies, so a bridge tool would
+     * run a native frame the user configured `ask` or `deny` for.
+     */
+    advisorGetToolContext?: () => AgentToolContext | undefined;
+    /**
+     * The live MCP connections the advisor's Cursor resource frames answer from.
+     *
+     * Advisors share the session's connections and may be granted tools from
+     * those same servers; without this their `list_mcp_resources` reports an
+     * empty catalog and every `read_mcp_resource` a `not_found`.
+     */
+    advisorMcpResources?: CursorMcpResourceAdapter;
     /** Preloaded watchdog prompt content for the advisor. */
     advisorWatchdogPrompt?: string;
     /** Shared advisor instructions loaded from WATCHDOG.yml. */

package/dist/types/session/agent-session.d.ts

@@ -12,12 +12,12 @@
  *
  * Modes use this class and add their own I/O layer on top.
  */
-import type { InMemorySnapshotStore } from "@oh-my-pi/hashline";
+import type { Clipboard, InMemorySnapshotStore } from "@oh-my-pi/hashline";
 import { type Agent, type AgentMessage, type AgentState, type AgentTool, type AgentToolContext, type AgentToolResult, type ThinkingLevel, type ToolChoiceDirective } from "@oh-my-pi/pi-agent-core";
 import { type CompactionResult, type ShakeConfig } from "@oh-my-pi/pi-agent-core/compaction";
 import type { AssistantMessage, ImageContent, Message, Model, ProviderSessionState, ResetCreditAccountStatus, ResetCreditRedeemOutcome, ResetCreditTarget, ServiceTier, ServiceTierByFamily, ServiceTierFamily, SimpleStreamOptions, TextContent, UsageReport } from "@oh-my-pi/pi-ai";
 import { type Effort } from "@oh-my-pi/pi-ai";
-import type { AdvisorConfig, AdvisorRuntimeStatus } from "../advisor/index.js";
+import { type AdvisorConfig, type AdvisorRuntimeStatus } from "../advisor/index.js";
 import { AsyncJobManager } from "../async/index.js";
 import type { ModelRegistry } from "../config/model-registry.js";
 import { type ResolvedModelRoleValue } from "../config/model-resolver.js";
@@ -75,6 +75,8 @@ export declare class AgentSession {
     }>;
     readonly yieldQueue: YieldQueue;
     fileSnapshotStore?: InMemorySnapshotStore;
+    /** Per-session `CUT`/`PASTE` clipboard register shared across edit calls. */
+    editClipboard?: Clipboard;
     readonly configWarnings: string[];
     readonly rawSseDebugBuffer: RawSseDebugBuffer;
     /**

package/dist/types/session/async-job-delivery.d.ts

@@ -14,6 +14,14 @@ export interface AsyncResultEntry {
     result: string;
     job: AsyncJob | undefined;
     durationMs: number | undefined;
+    /**
+     * Owning session's async-delivery generation at enqueue time. A session
+     * transition (`/new`, switch, handoff) bumps the generation, so an entry
+     * whose generation no longer matches belongs to a replaced transcript and
+     * is dropped at flush — even after its job id has been reused, which clears
+     * the manager's per-id suppression marker.
+     */
+    epoch: number;
 }
 type AsyncResultJobDetails = {
     jobId: string;

package/dist/types/session/claude-session-store.d.ts

@@ -0,0 +1,13 @@
+import type { ForeignSessionInfo, ForeignSessionStore } from "./foreign-session-store.js";
+import { SessionManager } from "./session-manager.js";
+/** Imports Claude Code JSONL sessions into non-persistent OMP session managers. */
+export declare class ClaudeSessionStore implements ForeignSessionStore {
+    #private;
+    readonly source = "claude";
+    /** Creates a store rooted at Claude's data directory, or at a fixture root when supplied. */
+    constructor(root?: string);
+    /** Lists indexed Claude sessions without reading transcript bodies. */
+    list(): Promise<ForeignSessionInfo[]>;
+    /** Loads and converts a Claude transcript while preserving its source tree and timestamps. */
+    load(info: ForeignSessionInfo): Promise<SessionManager>;
+}

package/dist/types/session/codex-session-store.d.ts

@@ -0,0 +1,14 @@
+import type { ForeignSessionInfo, ForeignSessionStore } from "./foreign-session-store.js";
+import { SessionManager } from "./session-manager.js";
+/** Imports locally stored OpenAI Codex sessions into OMP's in-memory session format. */
+export declare class CodexSessionStore implements ForeignSessionStore {
+    #private;
+    /** Foreign-session source discriminator. */
+    readonly source = "codex";
+    /** Uses the supplied Codex data root, or ~/.codex by default. */
+    constructor(rootDirectory?: string);
+    /** Lists Codex sessions from its state index without reading transcript bodies. */
+    list(): Promise<ForeignSessionInfo[]>;
+    /** Converts one Codex rollout into a non-persistent OMP session. */
+    load(info: ForeignSessionInfo): Promise<SessionManager>;
+}

package/dist/types/session/credential-pin.d.ts

@@ -0,0 +1,58 @@
+/**
+ * Session-file persistence of the OAuth account that served a session.
+ *
+ * Provider prompt caches are account-scoped (Anthropic bills a full cache
+ * re-write after an account flip), and the auth store's session-sticky routing
+ * is process-local when a remote auth broker is configured — the broker
+ * store's KV cache is in-memory, so sticky rows die with the CLI process.
+ * Resuming a session in a fresh process then re-ranks accounts by usage
+ * headroom, which is biased *away* from the account that just served the
+ * session (it has the highest recent burn), cold-missing the entire prefix.
+ *
+ * These helpers close the loop through the session file itself: after each
+ * assistant turn the serving account is recorded as a `credential_pin` entry,
+ * and on session adoption the pin is matched against the stored accounts and
+ * seeded back into the auth store with the session's effective last-use
+ * timestamp, so the provider's warm-window semantics still decide whether to
+ * stick or re-rank.
+ */
+import type { AuthStorage } from "./auth-storage.js";
+import type { SessionManager } from "./session-manager.js";
+/** Account fields shared by `OAuthAccountIdentity` and `OAuthAccountSummary`. */
+interface CredentialPinIdentity {
+    accountId?: string;
+    email?: string;
+    projectId?: string;
+    orgId?: string;
+}
+/**
+ * Stable identifier for a provider account within its billing scope. The
+ * digest covers the full scope tuple — the same account in two orgs (Anthropic
+ * multi-subscription) or projects (Gemini) is two distinct cache domains and
+ * must produce two distinct pins. The digest input is the persisted contract
+ * for `CredentialPinEntry.hash` — changing it orphans every recorded pin.
+ *
+ * Hashing avoids embedding raw emails/uuids in session files, but an unsalted
+ * digest of a guessable email is still linkable — treat exported sessions
+ * accordingly.
+ *
+ * Returns `undefined` when the identity carries no account key at all.
+ */
+export declare function credentialPinHash(provider: string, identity: CredentialPinIdentity): string | undefined;
+/**
+ * Record the account that served the latest assistant turn for `provider`.
+ * Appends a `credential_pin` entry only when the account differs from the
+ * branch's latest pin, so steady-state sessions add a single entry; the
+ * effective last-use time is derived from later assistant turns on read
+ * (see `SessionManager.getCredentialPins`).
+ */
+export declare function recordCredentialPin(authStorage: AuthStorage, sessionManager: SessionManager, sessionId: string, provider: string): void;
+/**
+ * Re-pin the accounts recorded in the session file onto the auth store's
+ * session stickiness. No-op per provider when the account is gone (logged out)
+ * or when a live sticky already exists (same-process branch/session switches
+ * must not clobber fresher routing). Seeds with the session's effective
+ * last-use time so stale resumes still fall through to usage ranking.
+ */
+export declare function seedCredentialPins(authStorage: AuthStorage, sessionManager: SessionManager, sessionId: string): void;
+export {};

package/dist/types/session/foreign-session-import.d.ts

@@ -0,0 +1,15 @@
+import type { ForeignSessionInfo, ForeignSessionSource, ForeignSessionStore } from "./foreign-session-store.js";
+import type { SessionInfo } from "./session-listing.js";
+import type { SessionManager } from "./session-manager.js";
+/** Construct the importer for a supported foreign session source. */
+export declare function createForeignSessionStore(source: ForeignSessionSource): ForeignSessionStore;
+/** Display name for a supported foreign session source. */
+export declare function foreignSessionSourceName(source: ForeignSessionSource): string;
+/** Convert lightweight foreign metadata for the existing session picker. */
+export declare function foreignSessionInfoToSessionInfo(info: ForeignSessionInfo): SessionInfo;
+/** Import and persist one foreign session under a fresh OMP session identity. */
+export declare function persistForeignSession(store: ForeignSessionStore, info: ForeignSessionInfo, options?: {
+    fallbackCwd?: string;
+    sessionDir?: string;
+    suppressBreadcrumb?: boolean;
+}): Promise<SessionManager>;

package/dist/types/session/foreign-session-jsonl.d.ts

@@ -0,0 +1,9 @@
+/** One readable object record from a foreign JSONL transcript. */
+export interface ForeignJsonRecord {
+    readonly value: Record<string, unknown>;
+    readonly line: number;
+}
+/** Stream valid object records while tolerating malformed or truncated lines. */
+export declare function readForeignJsonRecords(filePath: string): AsyncGenerator<ForeignJsonRecord>;
+/** Read every valid object record from a foreign JSONL transcript. */
+export declare function collectForeignJsonRecords(filePath: string): Promise<ForeignJsonRecord[]>;