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

package/dist/types/cli/bench-cli.d.ts

@@ -21,6 +21,7 @@ export interface BenchCommandArgs {
 }
 export interface BenchModelRegistry {
     getAll(): Model<Api>[];
+    getAvailable(): Model<Api>[];
     getApiKey(model: Model<Api>, sessionId?: string): Promise<string | undefined>;
     resolver(model: ApiKeyResolverModel, sessionId?: string): ApiKeyResolver;
     hasConfiguredAuth?(model: Model<Api>): boolean;

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

@@ -78,7 +78,7 @@ export interface ModelMatchPreferences {
     deprioritizeProviders?: string[];
 }
 export type ModelLookupRegistry = Pick<ModelRegistry, "getAvailable">;
-type CliModelRegistry = Pick<ModelRegistry, "getAll">;
+type CliModelRegistry = Pick<ModelRegistry, "getAll" | "getAvailable">;
 type InitialModelRegistry = Pick<ModelRegistry, "getAvailable" | "find">;
 type RestorableModelRegistry = Pick<ModelRegistry, "getAvailable" | "find" | "getApiKey">;
 export declare function getModelMatchPreferences(settings?: Partial<Pick<Settings, "get" | "getStorage">>): ModelMatchPreferences;
@@ -279,13 +279,16 @@ export interface ResolveCliModelResult {
 /**
  * Resolve a single model from CLI flags.
  *
- * Exact model names take precedence over configured role names.
+ * Explicit `provider/id` references and authenticated bare ids take precedence
+ * over configured role names, which in turn take precedence over an
+ * unauthenticated catalog-only id (so a bundled `cursor/default` never shadows a
+ * configured `modelRoles.default`).
  */
 export declare function resolveCliModel(options: {
     cliProvider?: string;
     cliModel?: string;
     modelRegistry: CliModelRegistry;
-    /** Authenticated models to prefer for unqualified selectors; omit to preserve catalog-order behavior. */
+    /** Authenticated models to prefer for unqualified selectors; defaults to the registry's authenticated set. */
     availableModels?: Model<Api>[];
     settings?: Settings;
     preferences?: ModelMatchPreferences;

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

@@ -3934,6 +3934,64 @@ export declare const SETTINGS_SCHEMA: {
             readonly description: "Enable the inspect_image tool, delegating image understanding to a vision-capable model";
         };
     };
+    readonly "computer.enabled": {
+        readonly type: "boolean";
+        readonly default: false;
+        readonly ui: {
+            readonly tab: "tools";
+            readonly group: "Available Tools";
+            readonly label: "Computer";
+            readonly description: "Enable native host-desktop screenshots and input for OpenAI computer use";
+        };
+    };
+    readonly "computer.backend": {
+        readonly type: "enum";
+        readonly values: readonly ["auto", "native"];
+        readonly default: "auto";
+        readonly ui: {
+            readonly tab: "tools";
+            readonly group: "Computer";
+            readonly label: "Computer Backend";
+            readonly description: "Select automatic or explicit platform-native desktop capture and input";
+            readonly options: readonly [{
+                readonly value: "auto";
+                readonly label: "Auto";
+            }, {
+                readonly value: "native";
+                readonly label: "Native";
+            }];
+        };
+    };
+    readonly "computer.display": {
+        readonly type: "string";
+        readonly default: "all";
+        readonly ui: {
+            readonly tab: "tools";
+            readonly group: "Computer";
+            readonly label: "Computer Display";
+            readonly description: "Composite all displays or select a native display id";
+        };
+    };
+    readonly "computer.maxWidth": {
+        readonly type: "number";
+        readonly default: 1920;
+        readonly ui: {
+            readonly tab: "tools";
+            readonly group: "Computer";
+            readonly label: "Computer Screenshot Width";
+            readonly description: "Maximum composite screenshot width in pixels";
+        };
+    };
+    readonly "computer.maxHeight": {
+        readonly type: "number";
+        readonly default: 1200;
+        readonly ui: {
+            readonly tab: "tools";
+            readonly group: "Computer";
+            readonly label: "Computer Screenshot Height";
+            readonly description: "Maximum composite screenshot height in pixels";
+        };
+    };
     readonly "checkpoint.enabled": {
         readonly type: "boolean";
         readonly default: false;
@@ -5753,6 +5811,10 @@ export declare const SETTINGS_SCHEMA: {
         readonly type: "string";
         readonly default: undefined;
     };
+    readonly "searxng.engines": {
+        readonly type: "string";
+        readonly default: undefined;
+    };
     readonly "searxng.language": {
         readonly type: "string";
         readonly default: undefined;

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

@@ -12,6 +12,7 @@
  * the same module identity as a direct `@oh-my-pi/pi-coding-agent` import.
  */
 import { type AuthCredential, type TSchema } from "@oh-my-pi/pi-ai";
+import { type Keybinding } from "@oh-my-pi/pi-tui";
 import type { PromptTemplate } from "../config/prompt-templates.js";
 import { Settings } from "../config/settings.js";
 import type { CreateAgentSessionOptions, CreateAgentSessionResult, LoadExtensionsResult } from "../sdk.js";
@@ -75,6 +76,8 @@ export interface LsOperations {
 export interface LsToolOptions {
     operations?: LsOperations;
 }
+/** Format the active shortcut for legacy extensions that render keybinding hints. */
+export declare function keyText(action: Keybinding): string;
 /** Parse frontmatter using the historical Pi package-root helper. */
 export interface ParsedFrontmatter<T extends Record<string, unknown> = Record<string, unknown>> {
     frontmatter: T;

package/dist/types/launch/broker-list-order.test.d.ts

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

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

@@ -0,0 +1,2 @@
+/** Generates the Codex DeviceCheck attestation envelope sent as `x-oai-attestation` on ChatGPT-OAuth requests. */
+export declare function generateCodexAttestation(): Promise<string | undefined>;

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

@@ -1,6 +1,14 @@
 import type { AssistantMessage } from "@oh-my-pi/pi-ai";
 import type { AgentSession } from "../session/agent-session.js";
-import type { LivePhase, LiveTranscript } from "./visualizer.js";
+import type { LivePhase } from "./visualizer.js";
+/** Incremental or final transcript for one realtime conversational turn. */
+export interface LiveTranscript {
+    role: "user" | "assistant";
+    text: string;
+    /** Monotonic role-local turn number used to coalesce streaming updates. */
+    turn: number;
+    final: boolean;
+}
 /** UI notifications emitted during a live session. */
 export interface LiveSessionCallbacks {
     /** Reports connection and activity phase changes. */
@@ -20,7 +28,7 @@ export interface LiveSessionControllerOptions {
     callbacks: LiveSessionCallbacks;
     /** Extracts visible assistant text using the caller's normal UI rules. */
     extractAssistantText(message: AssistantMessage): string;
-    /** Realtime output voice, defaulting to marin. */
+    /** Realtime output voice, defaulting to sol. */
     voice?: string;
 }
 /** Coordinates the realtime conversational surface with normal AgentSession turns. */

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

@@ -1,5 +1,5 @@
 /** Frameless Bidi model used by Codex Desktop live calls. */
-export declare const LIVE_MODEL: "gpt-live-1-boulder-alpha";
+export declare const LIVE_MODEL: "gpt-live-1-codex";
 /** Maximum UTF-8 payload size accepted by each context append. */
 export declare const CONTEXT_CHUNK_BYTES = 500;
 /** Semantic stream selected for appended Frameless Bidi context. */

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

@@ -1,17 +1,5 @@
 import { type AuthStorage } from "@oh-my-pi/pi-ai";
 import { type LiveClientMessage, type LiveServerEvent } from "./protocol.js";
-type BrowserLiveApi = {
-    start(workletSource: string): Promise<string>;
-    acceptAnswer(sdp: string): Promise<void>;
-    waitForOpen(): Promise<void>;
-    send(payload: string): void;
-    pushAudio(payload: string): void;
-    setMuted(muted: boolean): void;
-    close(): Promise<void>;
-};
-declare global {
-    var ompCodexLive: BrowserLiveApi;
-}
 /** Callbacks emitted by the live WebRTC transport. */
 export interface LiveTransportCallbacks {
     onEvent(event: LiveServerEvent): void;
@@ -26,23 +14,22 @@ export interface LiveTransportOptions {
     callbacks: LiveTransportCallbacks;
     signal?: AbortSignal;
 }
-/** Extracts the server-assigned `rtc_<uuid>` call ID from a signaling Location header. */
+/** Extracts the server-assigned `rtc_*` call ID from a signaling Location header. */
 export declare function parseLiveCallId(location: string | null): string | undefined;
 /** Builds the Frameless Bidi sideband WebSocket URL for an accepted Codex call. */
 export declare function buildLiveSidebandUrl(callId: string): string;
-/** Headless-Chromium WebRTC transport for a Codex Frameless Bidi live session. */
+/** Native WebRTC transport for a Codex Frameless Bidi live session. */
 export declare class CodexLiveTransport {
     #private;
     constructor(options: LiveTransportOptions);
-    /** Establish the browser peer, perform Codex signaling, and wait for the data channel. */
+    /** Establish the native peer, perform Codex signaling, and wait for the data channel. */
     connect(): Promise<void>;
     /** Serialize one Frameless Bidi control message onto the call's sideband WebSocket. */
     send(message: LiveClientMessage): Promise<void>;
-    /** Queue 16 kHz mono Float32 PCM for continuous browser-side resampling and playback. */
+    /** Queue 16 kHz mono Float32 PCM for native Opus transmission. */
     pushAudio(samples: Float32Array): void;
-    /** Enable or disable the browser audio source and discard queued input when muted. */
+    /** Enable or disable the native audio source and discard partial input when muted. */
     setMuted(muted: boolean): Promise<void>;
-    /** Stop audio, WebRTC, the page, and Chromium. Safe to call repeatedly. */
+    /** Stop sideband signaling and the native WebRTC media peer. Safe to call repeatedly. */
     close(): Promise<void>;
 }
-export {};

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

@@ -1,11 +1,6 @@
 import { type Component } from "@oh-my-pi/pi-tui";
 /** Distinct states of a realtime call connection. */
 export type LivePhase = "connecting" | "listening" | "working" | "speaking" | "muted" | "error";
-/** A transcribed turn in the realtime call. */
-export interface LiveTranscript {
-    role: "user" | "assistant";
-    text: string;
-}
 /** Configuration callbacks for user interactions in the visualizer. */
 export interface LiveVisualizerOptions {
     onStop(): void;
@@ -18,16 +13,18 @@ export declare class LiveVisualizer implements Component {
     constructor(options: LiveVisualizerOptions);
     /** Updates the current call phase. */
     setPhase(phase: LivePhase): void;
-    /** Updates the current input and output volume levels (0..1). */
-    setLevels(input: number, output: number): void;
-    /** Updates the latest transcript fragment. */
-    setTranscript(transcript: LiveTranscript | undefined): void;
-    /** Updates the animation frame for spinners and waveforms. */
+    /** Updates the microphone volume level (0..1). */
+    setInputLevel(level: number): void;
+    /** Advances the spectrum animation and its peak decay. */
     setFrame(frame: number): void;
+    /** Updates the user's streaming voice transcript. */
+    setTranscript(text: string): void;
+    /** Clears the user's voice transcript row. */
+    clearTranscript(): void;
     /** Processes user keypresses. */
     handleInput(data: string): void;
     /** Clears the render cache. */
     invalidate(): void;
-    /** Renders the visualizer into a fixed array of rows at the given width. */
+    /** Renders the microphone spectrum into a compact fixed-height panel. */
     render(width: number): readonly string[];
 }

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

@@ -14,6 +14,7 @@ export declare class AssistantMessageComponent extends Container {
     private readonly thinkingRenderers;
     private readonly imageBudget?;
     private proseOnlyThinking;
+    setTextColorTransform(transform?: (text: string) => string): void;
     constructor(message?: AssistantMessage, hideThinkingBlock?: boolean, onImageUpdate?: (() => void) | undefined, thinkingRenderers?: readonly AssistantThinkingRenderer[], imageBudget?: ImageBudget | undefined, proseOnlyThinking?: boolean);
     /**
      * Show or clear the slim cache-invalidation divider above this turn. Set at

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

@@ -1,6 +1,6 @@
 import { Container } from "@oh-my-pi/pi-tui";
 import type { MessageRenderer } from "../../extensibility/extensions/types.js";
-import type { CustomMessage } from "../../session/messages.js";
+import { type CustomMessage } from "../../session/messages.js";
 /**
  * Component that renders a custom message entry from extensions.
  * Uses distinct styling to differentiate from user messages.

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

@@ -9,7 +9,7 @@
  */
 import type { TextContent } from "@oh-my-pi/pi-ai";
 import type { Box, Component } from "@oh-my-pi/pi-tui";
-import { type Theme } from "../../modes/theme/theme.js";
+import { type Theme, type ThemeColor } from "../../modes/theme/theme.js";
 /** Message shape consumed by the shared frame. */
 export interface FramedMessage {
     customType: string;
@@ -31,14 +31,18 @@ export interface RebuildFrameOptions<M extends FramedMessage> {
     expanded: boolean;
     /** Icon glyph shown before the customType in the default header (e.g. a hook/extension icon). */
     icon?: string;
+    /** Hide the default type header while retaining the message body. */
+    hideHeader?: boolean;
+    /** Semantic color for the outline, defaulting to the muted border. */
+    borderColor?: ThemeColor;
     /** Collapse the markdown body to this many lines when `expanded` is false. Omit to never collapse. */
     collapseAfterLines?: number;
     customRenderer?: FramedRenderer<M>;
 }
 /**
  * Attempt the custom renderer; on failure or undefined return, populate `box`
- * with the default outlined card — an `icon customType` header + markdown body —
- * and return undefined. When the custom renderer succeeds, return its Component
- * so the caller can mount it and skip the default box.
+ * with the configured outline, optional type header, and markdown body. When
+ * the custom renderer succeeds, return its Component so the caller can mount
+ * it and skip the default box.
  */
 export declare function renderFramedMessage<M extends FramedMessage>(opts: RebuildFrameOptions<M>): Component | undefined;

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

@@ -0,0 +1,11 @@
+import { Container, type SgrMouseEvent } from "@oh-my-pi/pi-tui";
+import type { SessionPinAccount } from "../../slash-commands/helpers/session-pin.js";
+/** Account picker opened by `/session pin` for the current model provider. */
+export declare class SessionAccountSelectorComponent extends Container {
+    #private;
+    constructor(providerName: string, accounts: readonly SessionPinAccount[], onSelect: (account: SessionPinAccount) => void, onCancel: () => void);
+    /** Forward keyboard navigation and cancellation when the wrapper owns focus. */
+    handleInput(keyData: string): void;
+    /** Route mouse selection through the title rows into the account list. */
+    routeMouse(event: SgrMouseEvent, line: number, col: number): void;
+}

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

@@ -55,6 +55,7 @@ export declare class SelectorController {
     }): Promise<boolean>;
     handleSessionDeleteCommand(): Promise<void>;
     showOAuthSelector(mode: "login" | "logout", providerId?: string): Promise<void>;
+    showSessionPinSelector(): Promise<void>;
     showResetUsageSelector(): Promise<void>;
     showDebugSelector(): Promise<void>;
     showAgentHub(observers: SessionObserverRegistry, options?: {

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

@@ -36,7 +36,7 @@ import { type LoopLimitRuntime } from "./loop-limit.js";
 import { OAuthManualInputManager } from "./oauth-manual-input.js";
 import { type ObservableSession } from "./session-observer-registry.js";
 import type { Theme } from "./theme/theme.js";
-import type { CompactionQueuedMessage, InteractiveModeContext, InteractiveModeInitOptions, InteractiveSelectorDialogOptions, SubmittedUserInput, TodoItem, TodoPhase } from "./types.js";
+import type { CompactionQueuedMessage, InteractiveModeContext, InteractiveModeInitOptions, InteractiveSelectorDialogOptions, RenderSessionContextOptions, SubmittedUserInput, TodoItem, TodoPhase } from "./types.js";
 /**
  * Editor max-height cap for a terminal of `terminalRows` rows.
  *
@@ -309,11 +309,7 @@ export declare class InteractiveMode implements InteractiveModeContext {
         imageLinks?: readonly (string | undefined)[];
         reuseSettledComponent?: boolean;
     }): Component[];
-    renderSessionContext(sessionContext: SessionContext, options?: {
-        updateFooter?: boolean;
-        populateHistory?: boolean;
-        reuseSettledComponents?: boolean;
-    }): void;
+    renderSessionContext(sessionContext: SessionContext, options?: RenderSessionContextOptions): void;
     renderInitialMessages(options?: {
         preserveExistingChat?: boolean;
         clearTerminalHistory?: boolean;
@@ -376,6 +372,7 @@ export declare class InteractiveMode implements InteractiveModeContext {
     handleResumeSession(sessionPath: string): Promise<void>;
     handleSessionDeleteCommand(): Promise<void>;
     showOAuthSelector(mode: "login" | "logout", providerId?: string): Promise<void>;
+    showSessionPinSelector(): Promise<void>;
     showResetUsageSelector(): Promise<void>;
     showProviderSetup(): Promise<void>;
     showHookConfirm(title: string, message: string): Promise<boolean>;

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

@@ -77,6 +77,13 @@ export interface InteractiveModeInitOptions {
     clearInitialTerminalHistory?: boolean;
 }
 export type InteractiveSelectorDialogOptions = ExtensionUIDialogOptions & Pick<HookSelectorOptions, "disabledIndices">;
+export interface RenderSessionContextOptions {
+    updateFooter?: boolean;
+    populateHistory?: boolean;
+    reuseSettledComponents?: boolean;
+    /** Tool calls whose existing live component remains the sole render owner across a rebuild. */
+    preservedLiveToolCallIds?: ReadonlySet<string>;
+}
 export interface InteractiveModeContext {
     ui: TUI;
     chatContainer: TranscriptContainer;
@@ -284,11 +291,7 @@ export interface InteractiveModeContext {
         imageLinks?: readonly (string | undefined)[];
         reuseSettledComponent?: boolean;
     }): Component[];
-    renderSessionContext(sessionContext: SessionContext, options?: {
-        updateFooter?: boolean;
-        populateHistory?: boolean;
-        reuseSettledComponents?: boolean;
-    }): void;
+    renderSessionContext(sessionContext: SessionContext, options?: RenderSessionContextOptions): void;
     renderInitialMessages(options?: {
         preserveExistingChat?: boolean;
         clearTerminalHistory?: boolean;
@@ -358,6 +361,7 @@ export interface InteractiveModeContext {
     handleResumeSession(sessionPath: string): Promise<void>;
     handleSessionDeleteCommand(): Promise<void>;
     showOAuthSelector(mode: "login" | "logout", providerId?: string): Promise<void>;
+    showSessionPinSelector(): Promise<void>;
     showResetUsageSelector(): Promise<void>;
     showProviderSetup(): Promise<void>;
     showHookConfirm(title: string, message: string): Promise<boolean>;

package/dist/types/modes/utils/ui-helpers.d.ts

@@ -1,7 +1,7 @@
 import type { AgentMessage } from "@oh-my-pi/pi-agent-core";
 import type { AssistantMessage, ImageContent, Message } from "@oh-my-pi/pi-ai";
 import { type Component } from "@oh-my-pi/pi-tui";
-import type { InteractiveModeContext } from "../../modes/types.js";
+import type { InteractiveModeContext, RenderSessionContextOptions } from "../../modes/types.js";
 import type { SessionContext } from "../../session/session-context.js";
 interface RenderInitialMessagesOptions {
     preserveExistingChat?: boolean;
@@ -12,11 +12,6 @@ type AddMessageOptions = {
     imageLinks?: readonly (string | undefined)[];
     reuseSettledComponent?: boolean;
 };
-type RenderSessionContextOptions = {
-    updateFooter?: boolean;
-    populateHistory?: boolean;
-    reuseSettledComponents?: boolean;
-};
 export declare class UiHelpers {
     #private;
     private ctx;

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

@@ -1,5 +1,5 @@
 import type { Agent, AgentMessage, AgentTool, StreamFn, ThinkingLevel } from "@oh-my-pi/pi-agent-core";
-import type { Context, ImageContent, Message, MessageAttribution, Model, ServiceTierByFamily, SimpleStreamOptions, ToolChoice } from "@oh-my-pi/pi-ai";
+import type { Context, 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";
 import type { AsyncJob, AsyncJobDeliveryState, AsyncJobManager } from "../async/index.js";
@@ -117,6 +117,8 @@ export interface AgentSessionConfig {
     memoryTaskDepth?: number;
     /** Creates built-in memory tools for the current backend. */
     createMemoryTools?: () => Promise<AgentTool[]>;
+    /** Creates the built-in `computer` tool for session-scoped runtime enablement (see {@link AgentSession.setComputerToolEnabled}). */
+    createComputerTool?: () => Promise<AgentTool | null>;
     /** Model registry for API key resolution and model discovery. */
     modelRegistry: ModelRegistry;
     /** Tool registry for LSP and settings. */
@@ -301,6 +303,11 @@ export interface SessionStats {
     cost: number;
     contextUsage?: ContextUsage;
 }
+/** Stored OAuth accounts available to the current model provider. */
+export interface SessionOAuthAccountList {
+    provider: string;
+    accounts: OAuthAccountSummary[];
+}
 /** IDs for a newly created session and the session it replaced. */
 export interface FreshSessionResult {
     previousSessionId: string;

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

@@ -48,7 +48,7 @@ import { type PlanProposalHandler } from "../tools/resolve.js";
 import type { TodoPhase } from "../tools/todo.js";
 import type { VibeModeState } from "../vibe/state.js";
 import type { AgentSessionEventListener } from "./agent-session-events.js";
-import type { AgentSessionConfig, AgentSessionDisposeOptions, AsyncJobSnapshot, CommandMetadataChangedListener, ContextUsageBreakdown, FollowUpOptions, FreshSessionResult, HandoffResult, ModelCycleResult, Prewalk, PromptOptions, ResolvedRoleModel, RestoredQueuedMessage, RoleModelCycle, RoleModelCycleResult, SessionHandoffOptions, SessionStats, UsageFallbackConfirmation } from "./agent-session-types.js";
+import type { AgentSessionConfig, AgentSessionDisposeOptions, AsyncJobSnapshot, CommandMetadataChangedListener, ContextUsageBreakdown, FollowUpOptions, FreshSessionResult, HandoffResult, ModelCycleResult, Prewalk, PromptOptions, ResolvedRoleModel, RestoredQueuedMessage, RoleModelCycle, RoleModelCycleResult, SessionHandoffOptions, SessionOAuthAccountList, SessionStats, UsageFallbackConfirmation } from "./agent-session-types.js";
 import type { ClientBridge } from "./client-bridge.js";
 import { type CustomMessage, type CustomMessagePayload } from "./messages.js";
 import { type AdvisorStats } from "./session-advisors.js";
@@ -272,6 +272,17 @@ export declare class AgentSession {
     setActiveToolsByName(toolNames: string[]): Promise<void>;
     /** Restores an exact top-level versus `xd://` tool partition. */
     setActiveToolPresentation(toolNames: string[], mountedToolNames: string[]): Promise<void>;
+    /**
+     * Session-scoped enable/disable for the settings-gated `computer` tool.
+     *
+     * Enabling builds the tool through {@link AgentSessionConfig.createComputerTool}
+     * on first use and activates it; disabling drops it from the active set while
+     * keeping the registry entry so repeated toggles reuse one desktop controller.
+     *
+     * @returns false when enabling was requested but this session cannot build the
+     * tool (e.g. restricted child sessions have no factory).
+     */
+    setComputerToolEnabled(enabled: boolean): Promise<boolean>;
     /** Cancels the local rollout-memory startup owned by this session. */
     cancelLocalMemoryStartup(): void;
     /** Starts a new local rollout-memory generation and cancels its predecessor. */
@@ -352,6 +363,7 @@ export declare class AgentSession {
     /** Current session ID */
     get sessionId(): string;
     getEvalSessionId(): string | null;
+    getEvalKernelOwnerId(): string;
     /** Current session display name, if set */
     get sessionName(): string | undefined;
     /** Scoped models for cycling (from --models flag) */
@@ -864,6 +876,13 @@ export declare class AgentSession {
     fetchUsageReports(signal?: AbortSignal): Promise<UsageReport[] | null>;
     /** Models whose live `/usage` reports map to a quantitative provider scope. */
     getUsageReportingModelSelectors(reports: readonly UsageReport[]): string[];
+    /** List stored OAuth accounts for the current model provider and mark this session's active account. */
+    listCurrentProviderOAuthAccounts(): Promise<SessionOAuthAccountList | undefined>;
+    /**
+     * Pin a stored OAuth account to the current model provider for this session.
+     * Returns false while streaming or when the credential is no longer available.
+     */
+    pinCurrentProviderOAuthAccount(credentialId: number): boolean;
     /**
      * Redeem one saved Codex rate-limit reset for a specific account, injecting
      * the provider base URL like {@link AgentSession.fetchUsageReports}. Powers

package/dist/types/session/auth-storage.d.ts

@@ -2,6 +2,6 @@
  * Re-exports from @oh-my-pi/pi-ai.
  * All credential storage types and the AuthStorage class now live in the ai package.
  */
-export type { ApiKeyCredential, AuthCredential, AuthCredentialEntry, AuthCredentialStore, AuthStorageData, AuthStorageOptions, CredentialOrigin, CredentialOriginKind, OAuthAccountIdentity, OAuthCredential, ResetCreditAccountStatus, ResetCreditRedeemOutcome, ResetCreditTarget, SerializedAuthStorage, StoredAuthCredential, } from "@oh-my-pi/pi-ai";
+export type { ApiKeyCredential, AuthCredential, AuthCredentialEntry, AuthCredentialStore, AuthStorageData, AuthStorageOptions, CredentialOrigin, CredentialOriginKind, OAuthAccountIdentity, OAuthAccountSummary, OAuthCredential, ResetCreditAccountStatus, ResetCreditRedeemOutcome, ResetCreditTarget, SerializedAuthStorage, StoredAuthCredential, } from "@oh-my-pi/pi-ai";
 export { AuthStorage, REMOTE_REFRESH_SENTINEL, SqliteAuthCredentialStore } from "@oh-my-pi/pi-ai";
 export type { SnapshotResponse } from "@oh-my-pi/pi-ai/auth-broker/types";

package/dist/types/session/eval-runner.d.ts

@@ -38,6 +38,8 @@ export declare class EvalRunner {
     get isRunning(): boolean;
     /** Whether Python results are waiting for a safe persistence boundary. */
     get hasPendingMessages(): boolean;
+    /** Returns the stable owner shared by eval and session-owned tools. */
+    getKernelOwnerId(): string;
     /** Returns the eval session shared with the Python backend. */
     getSessionId(): string | null;
     /** Flushes deferred Python results into agent state and persistence. */

package/dist/types/session/messages.d.ts

@@ -36,6 +36,8 @@ export declare function buildReplanTitleContext(messages: AgentMessage[]): strin
 export declare function didSessionMessagesChange(previousMessages: AgentMessage[], nextMessages: AgentMessage[]): boolean;
 /** Fallback type for extension-injected messages that omit a custom type. */
 export declare const DEFAULT_CUSTOM_MESSAGE_TYPE = "custom-message";
+/** Custom message carrying a coding request delegated by the live voice model. */
+export declare const LIVE_DELEGATION_MESSAGE_TYPE = "live-delegation";
 /** Content shape accepted for extension-injected messages. */
 export type CustomMessageContent = string | (TextContent | ImageContent)[];
 /** Public input accepted by `pi.sendMessage` and `AgentSession.sendCustomMessage`. */

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

@@ -38,6 +38,7 @@ interface SessionToolsOptions {
     autoApprove?: boolean;
     toolRegistry?: Map<string, AgentTool>;
     createVibeTools?: () => AgentTool[];
+    createComputerTool?: () => Promise<AgentTool | null>;
     builtInToolNames?: Iterable<string>;
     presentationPinnedToolNames?: ReadonlySet<string>;
     ensureWriteRegistered?: () => Promise<boolean>;
@@ -126,6 +127,20 @@ export declare class SessionTools {
     setActiveToolPresentation(toolNames: string[], mountedToolNames: string[]): Promise<void>;
     /** Replaces memory-backend tools while preserving unrelated selections. */
     replaceMemoryTools(tools: AgentTool[]): Promise<void>;
+    /**
+     * Session-scoped enable/disable for the settings-gated `computer` tool.
+     *
+     * `createTools` derives the built-in slate once at session start, so a runtime
+     * `computer.enabled` override alone never changes the active tools. Enabling
+     * builds the tool through the config factory on first use (later toggles reuse
+     * the registry entry, so only one desktop controller is ever registered) and
+     * activates it; disabling drops it from the active set while keeping the
+     * registry entry. Takes effect before the next model call.
+     *
+     * @returns false when enabling was requested but this session cannot build the
+     * tool (e.g. restricted child sessions have no factory).
+     */
+    setComputerToolEnabled(enabled: boolean): Promise<boolean>;
     /** Rebuilds the stable base prompt for the current tools and model. */
     refreshBaseSystemPrompt(): Promise<void>;
     /** Applies one-turn memory prompt injection before an agent run. */

package/dist/types/session/streaming-output.d.ts

@@ -213,6 +213,14 @@ export declare class OutputSink {
      */
     replace(text: string): void;
     dump(notice?: string): Promise<OutputSummary>;
+    /**
+     * Release the artifact spill descriptor on an exit path that skips
+     * {@link dump} — a thrown error or abort. Idempotent and safe in a
+     * `finally`: if {@link dump} already ran this is a no-op, otherwise it
+     * flushes the capped tail and closes the sink so the descriptor is not
+     * leaked until a later unrelated read hits `EMFILE` (issue #6463).
+     */
+    dispose(): Promise<void>;
 }
 /**
  * Format a truncation notice for tail-truncated output (bash, python, ssh).

package/dist/types/slash-commands/helpers/session-pin.d.ts

@@ -0,0 +1,9 @@
+import type { OAuthAccountSummary } from "../../session/auth-storage.js";
+/** Stored OAuth account rendered and matched by `/session pin`. */
+export interface SessionPinAccount extends OAuthAccountSummary {
+    label: string;
+}
+/** Add stable user-facing labels to provider account summaries. */
+export declare function toSessionPinAccounts(accounts: readonly OAuthAccountSummary[]): SessionPinAccount[];
+/** Match a `/session pin` selector by 1-based position or exact account identity. */
+export declare function matchSessionPinAccounts(accounts: readonly SessionPinAccount[], selector: string): SessionPinAccount[];

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

@@ -4,5 +4,3 @@ export * from "./downloader.js";
 export * from "./models.js";
 export * from "./stt-controller.js";
 export * from "./submit-trigger.js";
-export * from "./transcriber.js";
-export * from "./wav.js";

package/dist/types/stt/stt-controller.d.ts

@@ -15,8 +15,15 @@ interface Editor {
     submit(): void;
     deleteBeforeCursor(count: number): void;
 }
+interface CaptureHandle {
+    stop(): void;
+}
+type CaptureFactory = (onAudio: (error: Error | null, samples: Float32Array) => void) => CaptureHandle;
+/** Coordinates native microphone capture with incremental local transcription. */
 export declare class STTController {
     #private;
+    /** Creates a controller; tests may replace the hardware capture boundary. */
+    constructor(createCapture?: CaptureFactory);
     get state(): SttState;
     toggle(editor: Editor, options: ToggleOptions): Promise<void>;
     dispose(): void;

package/dist/types/task/executor.d.ts

@@ -21,7 +21,7 @@ import { type AgentReviver } from "../registry/agent-lifecycle.js";
 import type { AgentSession } from "../session/agent-session.js";
 import type { ArtifactManager } from "../session/artifacts.js";
 import type { AuthStorage } from "../session/auth-storage.js";
-import type { ConfiguredThinkingLevel } from "../thinking.js";
+import { type ConfiguredThinkingLevel, type TaskEffort } from "../thinking.js";
 import type { ContextFileEntry } from "../tools/index.js";
 import type { EventBus } from "../utils/event-bus.js";
 import type { WorkspaceTree } from "../workspace-tree.js";
@@ -81,6 +81,8 @@ export interface ExecutorOptions {
      */
     parentActiveModelPattern?: string;
     thinkingLevel?: ConfiguredThinkingLevel;
+    /** Caller-requested coarse effort (`lo`/`med`/`hi`); maps onto the resolved model's supported thinking range and wins over {@link thinkingLevel}. */
+    effort?: TaskEffort;
     /** Schema used to validate the final structured completion. */
     outputSchema?: unknown;
     /** Enforcement policy for {@link outputSchema}; defaults to legacy permissive behavior. */