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

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;

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/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

@@ -376,6 +376,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

@@ -358,6 +358,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/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/tiny/title-client.d.ts

@@ -50,6 +50,16 @@ export declare class TinyTitleClient {
     #private;
     constructor(spawnWorker?: () => RefCountedWorkerHandle<TinyTitleWorkerInbound, TinyTitleWorkerOutbound>);
     onProgress(listener: (event: TinyTitleProgressEvent) => void): () => void;
+    /**
+     * Spawn the tiny-model worker ahead of first use without loading any model.
+     * Called from idle TUI startup so the first {@link generate} reuses a live,
+     * unref'd subprocess instead of paying subprocess-spawn latency on the submit
+     * hot path (issue #6462). No-ops for online / non-local keys and for models
+     * already marked failed. A no-op `ping` round-trips the transport to fault in
+     * the worker's module graph; no pending request is registered, so
+     * {@link #syncWorkerRef} leaves the worker unref'd and idle sessions still exit.
+     */
+    prewarm(modelKey: string): void;
     generate(modelKey: string, message: string, signal?: AbortSignal): Promise<string | null>;
     generate(modelKey: string, message: string, options?: TinyTitleGenerateOptions): Promise<string | null>;
     complete(modelKey: string, prompt: string, options?: {

package/dist/types/tools/builtin-names.d.ts

@@ -1,4 +1,4 @@
-export declare const BUILTIN_TOOL_NAMES: readonly ["read", "bash", "edit", "ast_grep", "ast_edit", "ask", "debug", "eval", "github", "glob", "grep", "lsp", "inspect_image", "browser", "checkpoint", "rewind", "task", "hub", "todo", "web_search", "write", "memory_edit", "retain", "recall", "reflect", "learn", "manage_skill"];
+export declare const BUILTIN_TOOL_NAMES: readonly ["read", "bash", "edit", "ast_grep", "ast_edit", "ask", "debug", "eval", "github", "glob", "grep", "lsp", "inspect_image", "browser", "computer", "checkpoint", "rewind", "task", "hub", "todo", "web_search", "write", "memory_edit", "retain", "recall", "reflect", "learn", "manage_skill"];
 export type BuiltinToolName = (typeof BUILTIN_TOOL_NAMES)[number];
 /** Hidden built-ins: constructible and `--tools`-addressable, but never part of the default active set. */
 export declare const HIDDEN_TOOL_NAMES: readonly ["yield", "goal"];

package/dist/types/tools/computer/protocol.d.ts

@@ -0,0 +1,43 @@
+import type { DesktopAction, DesktopCapabilities, DesktopCapture, DesktopSessionOptions } from "@oh-my-pi/pi-natives";
+export declare const COMPUTER_WORKER_ARG = "__omp_worker_computer";
+export type ComputerWorkerInbound = {
+    type: "ping";
+    id: string;
+} | {
+    type: "init";
+    options: DesktopSessionOptions;
+} | {
+    type: "execute";
+    id: string;
+    actions: DesktopAction[];
+} | {
+    type: "close";
+};
+export type ComputerWorkerOutbound = {
+    type: "pong";
+    id: string;
+} | {
+    type: "ready";
+    capabilities: DesktopCapabilities;
+} | {
+    type: "result";
+    id: string;
+    capture: DesktopCapture;
+    capabilities: DesktopCapabilities;
+} | {
+    type: "error";
+    id?: string;
+    error: ComputerWorkerError;
+} | {
+    type: "closed";
+};
+export interface ComputerWorkerError {
+    name: string;
+    message: string;
+    stack?: string;
+}
+export interface ComputerWorkerTransport {
+    send(message: ComputerWorkerOutbound, transfer?: Bun.Transferable[]): void;
+    onMessage(handler: (message: ComputerWorkerInbound) => void): () => void;
+    close(): void;
+}

package/dist/types/tools/computer/supervisor.d.ts

@@ -0,0 +1,32 @@
+import type { DesktopAction, DesktopCapabilities, DesktopCapture, DesktopSessionOptions } from "@oh-my-pi/pi-natives";
+import { type ComputerWorkerInbound, type ComputerWorkerOutbound } from "./protocol.js";
+export interface ComputerController {
+    readonly capabilities: DesktopCapabilities | undefined;
+    execute(actions: DesktopAction[], signal?: AbortSignal): Promise<DesktopCapture>;
+    close(): Promise<void>;
+}
+export interface ComputerWorkerHandle {
+    send(message: ComputerWorkerInbound): void;
+    onMessage(handler: (message: ComputerWorkerOutbound) => void): () => void;
+    onError(handler: (error: Error) => void): () => void;
+    terminate(): Promise<void>;
+}
+export interface ComputerSupervisorTimeouts {
+    startMs: number;
+    closeMs: number;
+}
+export type ComputerWorkerFactory = () => ComputerWorkerHandle;
+export declare function spawnComputerWorker(): ComputerWorkerHandle;
+export declare class ComputerSupervisor implements ComputerController {
+    #private;
+    private readonly options;
+    private readonly createWorker;
+    private readonly timeouts;
+    constructor(options: DesktopSessionOptions, createWorker?: ComputerWorkerFactory, timeouts?: ComputerSupervisorTimeouts);
+    get capabilities(): DesktopCapabilities | undefined;
+    execute(actions: DesktopAction[], signal?: AbortSignal): Promise<DesktopCapture>;
+    close(): Promise<void>;
+}
+export declare function registerComputerController(ownerId: string | undefined, controller: ComputerController): () => void;
+export declare function releaseComputerSessionsForOwner(ownerId: string | undefined): Promise<void>;
+export declare function smokeTestComputerWorker(timeoutMs?: number): Promise<void>;

package/dist/types/tools/computer/worker-entry.d.ts

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

package/dist/types/tools/computer/worker.d.ts

@@ -0,0 +1,15 @@
+import { type DesktopAction, type DesktopCapture, DesktopSession, type DesktopSessionOptions } from "@oh-my-pi/pi-natives";
+import type { ComputerWorkerTransport } from "./protocol.js";
+export interface NativeDesktopSession {
+    readonly capabilities: DesktopSession["capabilities"];
+    capture(): Promise<DesktopCapture>;
+    execute(actions: DesktopAction[]): Promise<DesktopCapture>;
+    close(): Promise<void>;
+}
+export type NativeDesktopSessionFactory = (options: DesktopSessionOptions) => NativeDesktopSession;
+export declare class ComputerWorkerCore {
+    #private;
+    private readonly transport;
+    private readonly createSession;
+    constructor(transport: ComputerWorkerTransport, createSession?: NativeDesktopSessionFactory);
+}

package/dist/types/tools/computer-renderer.d.ts

@@ -0,0 +1,22 @@
+import type { Component } from "@oh-my-pi/pi-tui";
+import type { RenderResultOptions } from "../extensibility/custom-tools/types.js";
+import type { Theme } from "../modes/theme/theme.js";
+interface ComputerRenderArgs {
+    actions?: Array<{
+        type?: unknown;
+    }>;
+}
+interface ComputerRenderResult {
+    content: Array<{
+        type: string;
+        text?: string;
+    }>;
+    details?: unknown;
+    isError?: boolean;
+}
+export declare const computerToolRenderer: {
+    mergeCallAndResult: boolean;
+    renderCall(args: ComputerRenderArgs, _options: RenderResultOptions, theme: Theme): Component;
+    renderResult(result: ComputerRenderResult, options: RenderResultOptions, theme: Theme, args?: ComputerRenderArgs): Component;
+};
+export {};