@oh-my-pi/pi-coding-agent 15.11.3 → 15.11.4

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

@@ -2,7 +2,7 @@ import type { MnemopiOptions } from "@oh-my-pi/pi-mnemopi";
 import type { Settings } from "../config/settings";
 export type MnemopiLlmMode = "none" | "smol" | "remote";
 export type MnemopiScoping = "global" | "per-project" | "per-project-tagged";
-export type MnemopiProviderOptions = Pick<MnemopiOptions, "noEmbeddings" | "embeddingModel" | "embeddingApiUrl" | "embeddingApiKey" | "llm">;
+export type MnemopiProviderOptions = Pick<MnemopiOptions, "noEmbeddings" | "embeddingModel" | "embeddingApiUrl" | "embeddingApiKey" | "llm" | "debug">;
 export interface MnemopiBackendConfig {
     dbPath: string;
     baseBank?: string;
@@ -13,6 +13,8 @@ export interface MnemopiBackendConfig {
     scoping?: MnemopiScoping;
     autoRecall: boolean;
     autoRetain: boolean;
+    polyphonicRecall: boolean;
+    enhancedRecall: boolean;
     retainEveryNTurns: number;
     recallLimit: number;
     recallContextTurns: number;

package/dist/types/modes/components/settings-defs.d.ts

@@ -4,7 +4,8 @@
  * settings selector.
  *
  * To add a new setting to the UI: declare it in `settings-schema.ts`
- * with a `ui` block. If it needs a submenu, include `options: [...]`
+ * with a `ui` block carrying `tab` and `group` (the group must be listed
+ * in `TAB_GROUPS[tab]`). If it needs a submenu, include `options: [...]`
  * (or `options: "runtime"` for runtime-injected lists like themes).
  */
 import { type SettingPath, type SettingTab, type SubmenuOption } from "../../config/settings-schema";
@@ -14,6 +15,8 @@ interface BaseSettingDef {
     label: string;
     description: string;
     tab: SettingTab;
+    /** Section within the tab; items are ordered by TAB_GROUPS[tab] and rendered under a heading row. */
+    group?: string;
     /**
      * Optional visibility predicate. When supplied and returning false, the
      * setting is hidden from the UI. Applies to every variant — booleans,
@@ -41,7 +44,11 @@ export interface TextInputSettingDef extends BaseSettingDef {
 export type SettingDef = BooleanSettingDef | EnumSettingDef | SubmenuSettingDef | TextInputSettingDef;
 /** Get all setting definitions with UI */
 export declare function getAllSettingDefs(): SettingDef[];
-/** Get settings for a specific tab */
+/**
+ * Get settings for a specific tab, ordered by the tab's group layout
+ * (TAB_GROUPS). Ungrouped settings sort first; within a group, schema
+ * declaration order is preserved.
+ */
 export declare function getSettingsForTab(tab: SettingTab): SettingDef[];
 /** Get a setting definition by path */
 export declare function getSettingDef(path: SettingPath): SettingDef | undefined;

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

@@ -1,9 +1,8 @@
 import type { ThinkingLevel } from "@oh-my-pi/pi-agent-core";
 import type { Effort } from "@oh-my-pi/pi-ai";
-import { Container, SettingsList } from "@oh-my-pi/pi-tui";
+import { type Component } from "@oh-my-pi/pi-tui";
 import { type SettingPath } from "../../config/settings";
 import type { StatusLinePreset, StatusLineSegmentId, StatusLineSeparatorStyle } from "../../config/settings-schema";
-import { PluginSettingsComponent } from "./plugin-settings";
 /**
  * Dynamic context for settings that need runtime data.
  * Some settings (like thinking level) are managed by the session, not Settings.
@@ -45,11 +44,17 @@ export interface SettingsCallbacks {
  * Main tabbed settings selector component.
  * Uses declarative settings definitions from settings-defs.ts.
  */
-export declare class SettingsSelectorComponent extends Container {
+export declare class SettingsSelectorComponent implements Component {
     #private;
     private readonly context;
     private readonly callbacks;
     constructor(context: SettingsRuntimeContext, callbacks: SettingsCallbacks);
-    getFocusComponent(): SettingsList | PluginSettingsComponent;
+    invalidate(): void;
+    /**
+     * Fullscreen frame: title border, tab row, divider, optional search banner,
+     * the active content sized to fill the terminal, the appearance preview,
+     * then a footer hint pinned above the bottom border.
+     */
+    render(width: number): readonly string[];
     handleInput(data: string): void;
 }

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

@@ -1,11 +1,22 @@
 import type { SnapshotStore } from "@oh-my-pi/hashline";
 import type { AgentTool } from "@oh-my-pi/pi-agent-core";
-import { Container, type TUI } from "@oh-my-pi/pi-tui";
+import { type Component, Container, type TUI } from "@oh-my-pi/pi-tui";
+/**
+ * Transcript-side probe telling a block whether it is still inside the live
+ * (repaintable) region. Implemented by `TranscriptContainer`; injected rather
+ * than imported so the component stays decoupled from the transcript.
+ */
+export interface TranscriptLiveRegionProbe {
+    isBlockInLiveRegion(component: Component): boolean;
+}
 export interface ToolExecutionOptions {
     snapshots?: SnapshotStore;
     showImages?: boolean;
     editFuzzyThreshold?: number;
     editAllowFuzzy?: boolean;
+    /** Live-region probe used to settle detached task progress once the block
+     * leaves the repaintable transcript region. */
+    liveRegion?: TranscriptLiveRegionProbe;
 }
 export interface ToolExecutionHandle {
     updateArgs(args: any, toolCallId?: string): void;

package/dist/types/modes/components/transcript-container.d.ts

@@ -40,6 +40,18 @@ export declare class TranscriptContainer extends Container implements NativeScro
      * only repair by recommitting everything below it — duplication.
      */
     isWithinLiveRegion(component: Component): boolean;
+    /**
+     * Whether `component` is inside the live (repaintable) region exactly as
+     * {@link render} computes it: at/after the first still-mutating block, or
+     * the transcript tail when every block has finalized. Unlike
+     * {@link isWithinLiveRegion} (strictly below a still-mutating block, i.e.
+     * guaranteed-uncommitted), this also counts the trailing block that anchors
+     * the live region. Self-animating finalized blocks (a detached task's
+     * shimmering progress rows) poll this to stop animating — and settle on
+     * static bytes — the moment they sit above the seam, where their rows
+     * become commit-eligible native-scrollback history.
+     */
+    isBlockInLiveRegion(component: Component): boolean;
     render(width: number): readonly string[];
 }
 /**

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

@@ -1,9 +1,17 @@
 import type { AutocompleteProvider, SlashCommand } from "@oh-my-pi/pi-tui";
 import type { InteractiveModeContext } from "../../modes/types";
+import { readImageFromClipboard, readTextFromClipboard } from "../../utils/clipboard";
 export declare class InputController {
     #private;
     private ctx;
-    constructor(ctx: InteractiveModeContext);
+    /** Injectable clipboard reads so tests can drive paste flows without a real clipboard. */
+    private clipboard;
+    constructor(ctx: InteractiveModeContext, 
+    /** Injectable clipboard reads so tests can drive paste flows without a real clipboard. */
+    clipboard?: {
+        readImage: typeof readImageFromClipboard;
+        readText: typeof readTextFromClipboard;
+    });
     setupKeyHandlers(): void;
     setupEditorSubmitHandler(): void;
     handleCtrlC(): void;

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

@@ -1,12 +1,12 @@
 import type { ThinkingLevel } from "@oh-my-pi/pi-agent-core";
 import type { Effort } from "@oh-my-pi/pi-ai";
-import type { EditorTheme, MarkdownTheme, SelectListTheme, SymbolTheme } from "@oh-my-pi/pi-tui";
+import type { EditorTheme, MarkdownTheme, SelectListTheme, SettingsListTheme, SymbolTheme } from "@oh-my-pi/pi-tui";
 export { getLanguageFromPath } from "../../utils/lang-from-path";
 export type SymbolPreset = "unicode" | "nerd" | "ascii";
 /**
  * All available symbol keys organized by category.
  */
-export type SymbolKey = "status.success" | "status.error" | "status.warning" | "status.info" | "status.pending" | "status.disabled" | "status.enabled" | "status.running" | "status.shadowed" | "status.aborted" | "status.done" | "nav.cursor" | "nav.selected" | "nav.expand" | "nav.collapse" | "nav.back" | "tree.branch" | "tree.last" | "tree.vertical" | "tree.horizontal" | "tree.hook" | "boxRound.topLeft" | "boxRound.topRight" | "boxRound.bottomLeft" | "boxRound.bottomRight" | "boxRound.horizontal" | "boxRound.vertical" | "boxSharp.topLeft" | "boxSharp.topRight" | "boxSharp.bottomLeft" | "boxSharp.bottomRight" | "boxSharp.horizontal" | "boxSharp.vertical" | "boxSharp.cross" | "boxSharp.teeDown" | "boxSharp.teeUp" | "boxSharp.teeRight" | "boxSharp.teeLeft" | "sep.powerline" | "sep.powerlineThin" | "sep.powerlineLeft" | "sep.powerlineRight" | "sep.powerlineThinLeft" | "sep.powerlineThinRight" | "sep.block" | "sep.space" | "sep.asciiLeft" | "sep.asciiRight" | "sep.dot" | "sep.slash" | "sep.pipe" | "icon.model" | "icon.plan" | "icon.goal" | "icon.pause" | "icon.loop" | "icon.folder" | "icon.search" | "icon.scratchFolder" | "icon.file" | "icon.git" | "icon.branch" | "icon.pr" | "icon.tokens" | "icon.context" | "icon.cost" | "icon.time" | "icon.pi" | "icon.agents" | "icon.job" | "icon.cache" | "icon.input" | "icon.output" | "icon.host" | "icon.session" | "icon.package" | "icon.warning" | "icon.rewind" | "icon.auto" | "icon.fast" | "icon.extensionSkill" | "icon.extensionTool" | "icon.extensionSlashCommand" | "icon.extensionMcp" | "icon.extensionRule" | "icon.extensionHook" | "icon.extensionPrompt" | "icon.extensionContextFile" | "icon.extensionInstruction" | "icon.mic" | "icon.camera" | "thinking.minimal" | "thinking.low" | "thinking.medium" | "thinking.high" | "thinking.xhigh" | "thinking.autoPending" | "checkbox.checked" | "checkbox.unchecked" | "radio.selected" | "radio.unselected" | "format.bullet" | "format.dash" | "format.bracketLeft" | "format.bracketRight" | "md.quoteBorder" | "md.hrChar" | "md.bullet" | "md.colorSwatch" | "lang.default" | "lang.typescript" | "lang.javascript" | "lang.python" | "lang.rust" | "lang.go" | "lang.java" | "lang.c" | "lang.cpp" | "lang.csharp" | "lang.ruby" | "lang.php" | "lang.swift" | "lang.kotlin" | "lang.shell" | "lang.html" | "lang.css" | "lang.json" | "lang.yaml" | "lang.markdown" | "lang.sql" | "lang.docker" | "lang.lua" | "lang.text" | "lang.env" | "lang.toml" | "lang.xml" | "lang.ini" | "lang.conf" | "lang.log" | "lang.csv" | "lang.tsv" | "lang.image" | "lang.pdf" | "lang.archive" | "lang.binary" | "tab.appearance" | "tab.model" | "tab.interaction" | "tab.context" | "tab.editing" | "tab.tools" | "tab.memory" | "tab.tasks" | "tab.providers" | "tool.write" | "tool.edit" | "tool.bash" | "tool.ssh" | "tool.lsp" | "tool.gh" | "tool.webSearch" | "tool.exa" | "tool.browser" | "tool.eval" | "tool.debug" | "tool.mcp" | "tool.job" | "tool.task" | "tool.todo" | "tool.memory" | "tool.ask" | "tool.resolve" | "tool.review" | "tool.inspectImage" | "tool.goal" | "tool.irc";
+export type SymbolKey = "status.success" | "status.error" | "status.warning" | "status.info" | "status.pending" | "status.disabled" | "status.enabled" | "status.running" | "status.shadowed" | "status.aborted" | "status.done" | "nav.cursor" | "nav.selected" | "nav.expand" | "nav.collapse" | "nav.back" | "tree.branch" | "tree.last" | "tree.vertical" | "tree.horizontal" | "tree.hook" | "boxRound.topLeft" | "boxRound.topRight" | "boxRound.bottomLeft" | "boxRound.bottomRight" | "boxRound.horizontal" | "boxRound.vertical" | "boxSharp.topLeft" | "boxSharp.topRight" | "boxSharp.bottomLeft" | "boxSharp.bottomRight" | "boxSharp.horizontal" | "boxSharp.vertical" | "boxSharp.cross" | "boxSharp.teeDown" | "boxSharp.teeUp" | "boxSharp.teeRight" | "boxSharp.teeLeft" | "sep.powerline" | "sep.powerlineThin" | "sep.powerlineLeft" | "sep.powerlineRight" | "sep.powerlineThinLeft" | "sep.powerlineThinRight" | "sep.block" | "sep.space" | "sep.asciiLeft" | "sep.asciiRight" | "sep.dot" | "sep.slash" | "sep.pipe" | "icon.model" | "icon.plan" | "icon.goal" | "icon.pause" | "icon.loop" | "icon.folder" | "icon.search" | "icon.scratchFolder" | "icon.file" | "icon.git" | "icon.branch" | "icon.pr" | "icon.tokens" | "icon.context" | "icon.cost" | "icon.time" | "icon.pi" | "icon.agents" | "icon.job" | "icon.cache" | "icon.input" | "icon.output" | "icon.host" | "icon.session" | "icon.package" | "icon.warning" | "icon.rewind" | "icon.auto" | "icon.fast" | "icon.extensionSkill" | "icon.extensionTool" | "icon.extensionSlashCommand" | "icon.extensionMcp" | "icon.extensionRule" | "icon.extensionHook" | "icon.extensionPrompt" | "icon.extensionContextFile" | "icon.extensionInstruction" | "icon.mic" | "icon.camera" | "thinking.minimal" | "thinking.low" | "thinking.medium" | "thinking.high" | "thinking.xhigh" | "thinking.autoPending" | "checkbox.checked" | "checkbox.unchecked" | "radio.selected" | "radio.unselected" | "format.bullet" | "format.dash" | "format.bracketLeft" | "format.bracketRight" | "md.quoteBorder" | "md.hrChar" | "md.bullet" | "md.colorSwatch" | "lang.default" | "lang.typescript" | "lang.javascript" | "lang.python" | "lang.rust" | "lang.go" | "lang.java" | "lang.c" | "lang.cpp" | "lang.csharp" | "lang.ruby" | "lang.php" | "lang.swift" | "lang.kotlin" | "lang.shell" | "lang.html" | "lang.css" | "lang.json" | "lang.yaml" | "lang.markdown" | "lang.sql" | "lang.docker" | "lang.lua" | "lang.text" | "lang.env" | "lang.toml" | "lang.xml" | "lang.ini" | "lang.conf" | "lang.log" | "lang.csv" | "lang.tsv" | "lang.image" | "lang.pdf" | "lang.archive" | "lang.binary" | "tab.appearance" | "tab.model" | "tab.interaction" | "tab.context" | "tab.files" | "tab.shell" | "tab.tools" | "tab.memory" | "tab.tasks" | "tab.providers" | "tool.write" | "tool.edit" | "tool.bash" | "tool.ssh" | "tool.lsp" | "tool.gh" | "tool.webSearch" | "tool.exa" | "tool.browser" | "tool.eval" | "tool.debug" | "tool.mcp" | "tool.job" | "tool.task" | "tool.todo" | "tool.memory" | "tool.ask" | "tool.resolve" | "tool.review" | "tool.inspectImage" | "tool.goal" | "tool.irc";
 export type SpinnerType = "status" | "activity";
 export type ThemeColor = "accent" | "border" | "borderAccent" | "borderMuted" | "success" | "error" | "warning" | "muted" | "dim" | "text" | "thinkingText" | "userMessageText" | "customMessageText" | "customMessageLabel" | "toolTitle" | "toolOutput" | "mdHeading" | "mdLink" | "mdLinkUrl" | "mdCode" | "mdCodeBlock" | "mdCodeBlockBorder" | "mdQuote" | "mdQuoteBorder" | "mdHr" | "mdListBullet" | "toolDiffAdded" | "toolDiffRemoved" | "toolDiffContext" | "syntaxComment" | "syntaxKeyword" | "syntaxFunction" | "syntaxVariable" | "syntaxString" | "syntaxNumber" | "syntaxType" | "syntaxOperator" | "syntaxPunctuation" | "thinkingOff" | "thinkingMinimal" | "thinkingLow" | "thinkingMedium" | "thinkingHigh" | "thinkingXhigh" | "bashMode" | "pythonMode" | "statusLineSep" | "statusLineModel" | "statusLinePath" | "statusLineGitClean" | "statusLineGitDirty" | "statusLineContext" | "statusLineSpend" | "statusLineStaged" | "statusLineDirty" | "statusLineUntracked" | "statusLineOutput" | "statusLineCost" | "statusLineSubagents";
 /** Check if a string is a valid ThemeColor value */
@@ -33,6 +33,26 @@ export declare class Theme {
      * dark themes so accents stay vivid. Pass straight to `getSessionAccentHex`.
      */
     get accentSurfaceLuminance(): number | undefined;
+    /**
+     * Get the resolved CSS hex string for a foreground theme color.
+     */
+    getColorHex(color: ThemeColor): string;
+    /**
+     * Get all foreground and background theme colors as CSS hex strings.
+     * Skips colors resolved to the default terminal color (unstyled).
+     */
+    getAllThemeColorHexes(): string[];
+    /**
+     * Get the most visually dominant theme colors as CSS hex strings — accent,
+     * border, success, error, warning, heading, link, diff markers, etc.
+     * These are the colors the session accent could visually clash with.
+     * Skips colors resolved to the default terminal color (unstyled).
+     */
+    getMajorThemeColorHexes(): string[];
+    /**
+     * Get the resolved CSS hex string for the theme's accent color.
+     */
+    getAccentColorHex(): string;
     fg(color: ThemeColor, text: string): string;
     bg(color: ThemeBg, text: string): string;
     bold(text: string): string;
@@ -305,4 +325,4 @@ export declare function getSymbolTheme(): SymbolTheme;
 export declare function getMarkdownTheme(): MarkdownTheme;
 export declare function getSelectListTheme(): SelectListTheme;
 export declare function getEditorTheme(): EditorTheme;
-export declare function getSettingsListTheme(): import("@oh-my-pi/pi-tui").SettingsListTheme;
+export declare function getSettingsListTheme(): SettingsListTheme;

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

@@ -300,6 +300,11 @@ export interface FreshSessionResult {
     sessionId: string;
     closedProviderSessions: number;
 }
+/** Entry returned by {@link AgentSession.clearQueue} / {@link AgentSession.popLastQueuedMessage}. */
+export type RestoredQueuedMessage = {
+    text: string;
+    images?: ImageContent[];
+};
 export declare class AgentSession {
     #private;
     readonly agent: Agent;
@@ -610,12 +615,14 @@ export declare class AgentSession {
         deliverAs?: "steer" | "followUp";
     }): Promise<void>;
     /**
-     * Clear queued messages and return them.
-     * Useful for restoring to editor when user aborts.
+     * Clear queued messages and return them (text plus any attached images).
+     * Useful for restoring to editor when user aborts. The internal entry
+     * arrays are handed out as-is — a `tag` (if any) is inert once the record
+     * leaves the queue.
      */
     clearQueue(): {
-        steering: string[];
-        followUp: string[];
+        steering: RestoredQueuedMessage[];
+        followUp: RestoredQueuedMessage[];
     };
     /** Number of pending messages (includes steering, follow-up, and next-turn messages) */
     get queuedMessageCount(): number;
@@ -630,10 +637,10 @@ export declare class AgentSession {
     /**
      * Pop the last queued message (steering first, then follow-up).
      * Used by dequeue keybinding to restore messages to editor one at a time.
-     * Returns the popped entry's `.text`; the tag (if any) dies with the
-     * record — no orphan state can outlive the queue entry.
+     * Returns the popped entry's text and images; the tag (if any) dies with
+     * the record — no orphan state can outlive the queue entry.
      */
-    popLastQueuedMessage(): string | undefined;
+    popLastQueuedMessage(): RestoredQueuedMessage | undefined;
     get skillsSettings(): SkillsSettings | undefined;
     /** Skills loaded by SDK (empty if --no-skills or skills: [] was passed) */
     get skills(): readonly Skill[];

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

@@ -2,5 +2,5 @@
  * 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, OAuthCredential, SerializedAuthStorage, SnapshotResponse, StoredAuthCredential, } from "@oh-my-pi/pi-ai";
+export type { ApiKeyCredential, AuthCredential, AuthCredentialEntry, AuthCredentialStore, AuthStorageData, AuthStorageOptions, CredentialOrigin, CredentialOriginKind, OAuthAccountIdentity, OAuthCredential, SerializedAuthStorage, SnapshotResponse, StoredAuthCredential, } from "@oh-my-pi/pi-ai";
 export { AuthBrokerClient, AuthStorage, DEFAULT_SNAPSHOT_CACHE_TTL_MS, REMOTE_REFRESH_SENTINEL, RemoteAuthCredentialStore, readAuthBrokerSnapshotCache, SqliteAuthCredentialStore, writeAuthBrokerSnapshotCache, } from "@oh-my-pi/pi-ai";

package/dist/types/session/snapcompact-inline.d.ts

@@ -0,0 +1,28 @@
+/**
+ * Snapcompact inline imaging: per-request transform that swaps the system
+ * prompt and/or large historical tool results for dense PNG frames on
+ * vision-capable models.
+ *
+ * Runs inside the agent loop's `transformProviderContext` hook — after the
+ * persisted history is converted to the outgoing `Context`, before the
+ * provider stream call. It only ever builds NEW message objects/arrays; the
+ * input context shares `content` array references with the persisted
+ * `SessionMessageEntry` messages, so mutation would leak rendered images
+ * into session.jsonl.
+ */
+import type { Context, Model } from "@oh-my-pi/pi-ai";
+export interface SnapcompactInlineOptions {
+    renderSystemPrompt: boolean;
+    renderToolResults: boolean;
+}
+/**
+ * Stateless with respect to the model (passed per call, so mid-session model
+ * switches re-resolve shape and budget); stateful only for the render caches,
+ * which live as long as the session's Agent.
+ */
+export declare class SnapcompactInlineTransformer {
+    #private;
+    private readonly options;
+    constructor(options: SnapcompactInlineOptions);
+    transform(context: Context, model: Model): Context;
+}

package/dist/types/slash-commands/helpers/active-oauth-account.d.ts

@@ -0,0 +1,14 @@
+import type { UsageLimit, UsageReport } from "@oh-my-pi/pi-ai";
+import type { OAuthAccountIdentity } from "../../session/auth-storage";
+/**
+ * True when a single usage-limit column belongs to the given OAuth identity.
+ *
+ * Single definition of the matching rules for both `/usage` renderers:
+ * - `accountId` ↔ report metadata `accountId`/`account_id` or `limit.scope.accountId`
+ * - `email`     ↔ report metadata `email`
+ * - `projectId` ↔ report metadata `projectId` or `limit.scope.projectId`
+ *   (Google-style providers key usage on the GCP project, not an account id)
+ */
+export declare function limitMatchesActiveAccount(report: UsageReport, limit: UsageLimit, identity: OAuthAccountIdentity | undefined): boolean;
+/** True when any limit column in `report` belongs to the given OAuth identity. */
+export declare function reportMatchesActiveAccount(report: UsageReport, identity: OAuthAccountIdentity | undefined): boolean;

package/dist/types/system-prompt.d.ts

@@ -2,7 +2,7 @@
  * System prompt construction and project context loading
  */
 import type { AgentTool } from "@oh-my-pi/pi-agent-core";
-import type { SkillsSettings } from "./config/settings";
+import type { Personality, SkillsSettings } from "./config/settings";
 import { type Skill } from "./extensibility/skills";
 import { type WorkspaceTree } from "./workspace-tree";
 interface AlwaysApplyRule {
@@ -88,6 +88,8 @@ export interface BuildSystemPromptOptions {
     memoryRootEnabled?: boolean;
     /** Active model identifier (e.g. "anthropic/claude-opus-4") surfaced to the agent. */
     model?: string;
+    /** Personality preset rendered into the default system prompt. "none" omits the block. Default: "default" */
+    personality?: Personality;
 }
 /** Result of building provider-facing system prompt messages. */
 export interface BuildSystemPromptResult {

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

@@ -2,14 +2,23 @@ import type { Component } from "@oh-my-pi/pi-tui";
 import type { RenderResultOptions } from "../extensibility/custom-tools/types";
 import { type Theme } from "../modes/theme/theme";
 import type { TaskParams, TaskToolDetails } from "./types";
+/** Render context threaded in from `ToolExecutionComponent.#buildRenderContext`. */
+interface TaskRenderContext {
+    hasResult?: boolean;
+    /**
+     * The block left the transcript live region (detached spawn the transcript
+     * has moved past, or a sealed block): progress rows render static gray, so
+     * commit-eligible rows do not repaint after entering native scrollback.
+     */
+    frozen?: boolean;
+}
+type TaskRenderOptions = RenderResultOptions & {
+    renderContext?: TaskRenderContext;
+};
 /**
  * Render the tool call arguments.
  */
-export declare function renderCall(args: TaskParams, options: RenderResultOptions & {
-    renderContext?: {
-        hasResult?: boolean;
-    };
-}, theme: Theme): Component;
+export declare function renderCall(args: TaskParams, options: TaskRenderOptions, theme: Theme): Component;
 /**
  * Render the tool result.
  */
@@ -20,9 +29,10 @@ export declare function renderResult(result: {
     }>;
     details?: TaskToolDetails;
     isError?: boolean;
-}, options: RenderResultOptions, theme: Theme, args?: TaskParams): Component;
+}, options: TaskRenderOptions, theme: Theme, args?: TaskParams): Component;
 export declare const taskToolRenderer: {
     renderCall: typeof renderCall;
     renderResult: typeof renderResult;
     mergeCallAndResult: boolean;
 };
+export {};

package/dist/types/tools/gh.d.ts

@@ -1,9 +1,12 @@
 import type { AgentTool, AgentToolContext, AgentToolResult, AgentToolUpdateCallback, ToolApprovalDecision } from "@oh-my-pi/pi-agent-core";
 import * as z from "zod/v4";
 import type { Settings } from "../config/settings";
+import * as git from "../utils/git";
 import type { ToolSession } from ".";
 import { type CacheStatus } from "./github-cache";
 import type { OutputMeta } from "./output-meta";
+/** Runs `gh --json` for issue data, retrying without optional stateReason on older gh releases. */
+export declare function githubIssueJsonWithStateReasonFallback<T>(cwd: string, args: readonly string[], signal: AbortSignal | undefined, options?: git.GhCommandOptions): Promise<T>;
 declare const githubSchema: z.ZodObject<{
     op: z.ZodEnum<{
         pr_checkout: "pr_checkout";

package/dist/types/tools/render-utils.d.ts

@@ -76,24 +76,16 @@ export declare function formatBadge(label: string, color: ToolUIColor, theme: Th
  * Uses consistent wording pattern.
  */
 export declare function formatMoreItems(remaining: number, itemType: string): string;
+/** Tail-window height for collapsed command/code previews. */
+export declare function previewWindowRows(): number;
 /**
- * Maximum rows a tool's streaming/pending *call* preview may render before it is
- * capped. This is intentionally conservative: the preview still sits inside a
- * transcript that already consumed some viewport rows, and tool blocks carry
- * extra chrome (status/header/border/"more lines"), so a "reasonable" raw code
- * or command preview like 10-12 lines can still overflow and strand its top
- * while the block is volatile. Keeping the live call window short avoids that
- * across terminals without turning the transcript into an interactive scroller.
- */
-export declare const CALL_PREVIEW_MAX_LINES = 6;
-/**
- * Cap a pre-rendered pending/call preview to a bounded window. When truncated,
- * show both the head and the live tail so the user can still see what the tool
- * is currently writing while the volatile block stays short enough not to strand
- * its top above the viewport. `Ctrl+O` widens the bounded window, but does not
- * fully uncap live tool previews for the same reason.
+ * Cap a pre-rendered command preview to a viewport-sized tail window: the end
+ * of the command stays visible (it is the live edge while args stream) behind
+ * an "… N earlier lines" marker on top. The same window applies while
+ * streaming and after completion so the block never jumps; only `expanded`
+ * (ctrl+o) uncaps it.
  *
- * `prefix` (raw, e.g. a dim tree gutter) is prepended to the summary line so
+ * `prefix` (raw, e.g. a dim tree gutter) is prepended to the marker line so
  * nested previews stay aligned.
  */
 export declare function capPreviewLines(lines: string[], theme: Theme, options?: {

package/dist/types/utils/session-color.d.ts

@@ -1,13 +1,25 @@
 /**
- * Derive a stable CSS hex accent color from a session name.
+ * Derive a stable CSS hex accent color from a session name and the active theme.
+ *
+ * Picks a hue from a **dark/light-specific range** so the accent feels natural
+ * for the theme type (warm on dark, cool on light). The session name hash
+ * determines the exact hue within the range. The result is checked against
+ * all theme color hues and shifted if it lands within {@link MIN_HUE_DISTANCE}
+ * of an existing theme hue, but is clamped to the hue band so it never
+ * drifts into an unrelated part of the spectrum.
  *
  * On dark themes (`surfaceLuminance` undefined) the accent is vivid (high
  * saturation, high lightness). On light themes the lightness is reduced until the
  * accent's perceived luminance clears {@link ACCENT_MIN_CONTRAST} against the
  * actual surface it renders on — so it stays legible on near-white *and* mid-light
- * backgrounds — while keeping the same per-session hue.
+ * backgrounds.
+ *
+ * @param name — session name for per-session uniqueness.
+ * @param themeColorHexes — all theme colors to check collision against.
+ * @param surfaceLuminance — undefined on dark themes; WCAG luminance of the
+ *   status-line background on light themes.
  */
-export declare function getSessionAccentHex(name: string, surfaceLuminance?: number): string;
+export declare function getSessionAccentHex(name: string, themeColorHexes: string[], surfaceLuminance?: number): string;
 /**
  * Convert a hex accent color to an ANSI-16m foreground escape sequence.
  * Returns `undefined` if `hex` is nullish or Bun.color conversion fails.

package/dist/types/web/kagi.d.ts

@@ -6,7 +6,7 @@
  * through the shared {@link AuthStorage} broker (Bearer token), and responses
  * are categorized result buckets rather than the legacy flat object array.
  */
-import type { AuthStorage, FetchImpl } from "@oh-my-pi/pi-ai";
+import { type AuthStorage, type FetchImpl } from "@oh-my-pi/pi-ai";
 /** V1 search request body. */
 export interface KagiSearchRequest {
     query: string;
@@ -96,5 +96,4 @@ export interface KagiSearchResult {
     relatedQuestions: string[];
     answer?: string;
 }
-export declare function findKagiApiKey(authStorage: AuthStorage, sessionId?: string, signal?: AbortSignal): Promise<string | null>;
 export declare function searchWithKagi(query: string, options: KagiSearchOptions | undefined, authStorage: AuthStorage): Promise<KagiSearchResult>;

package/dist/types/web/search/providers/codex.d.ts

@@ -1,4 +1,4 @@
-import type { AuthStorage, FetchImpl } from "@oh-my-pi/pi-ai";
+import { type AuthStorage, type FetchImpl } from "@oh-my-pi/pi-ai";
 import type { SearchResponse } from "../../../web/search/types";
 import type { SearchParams } from "./base";
 import { SearchProvider } from "./base";

package/dist/types/web/search/providers/gemini.d.ts

@@ -8,10 +8,12 @@
  * sibling SQLite store and never POSTs the broker sentinel to a Google token
  * endpoint.
  */
-import type { AuthStorage, FetchImpl } from "@oh-my-pi/pi-ai";
+import { type AuthStorage, type FetchImpl, type OAuthAccess } from "@oh-my-pi/pi-ai";
 import type { SearchResponse } from "../../../web/search/types";
 import type { SearchParams } from "./base";
 import { SearchProvider } from "./base";
+declare const GEMINI_PROVIDERS: readonly ["google-gemini-cli", "google-antigravity"];
+type GeminiProviderId = (typeof GEMINI_PROVIDERS)[number];
 interface GeminiToolParams {
     google_search?: Record<string, unknown>;
     code_execution?: Record<string, unknown>;
@@ -31,19 +33,20 @@ export interface GeminiSearchParams extends GeminiToolParams {
     fetch?: FetchImpl;
 }
 export declare function buildGeminiRequestTools(params: GeminiToolParams): Array<Record<string, Record<string, unknown>>>;
-/** Resolved auth for a Gemini API request. */
-interface GeminiAuth {
-    accessToken: string;
+/** First configured Gemini OAuth provider plus its pre-resolved access. */
+interface GeminiAuthSeed {
+    provider: GeminiProviderId;
+    access: OAuthAccess;
     projectId: string;
-    isAntigravity: boolean;
 }
 /**
  * Walks the configured Gemini OAuth providers in deterministic order and
  * returns the first one that yields a usable access token + projectId via
  * {@link AuthStorage.getOAuthAccess}. AuthStorage handles refresh + broker
  * routing internally; this helper never touches refresh tokens directly.
+ * The resolved access seeds `withOAuthAccess` so the happy path resolves once.
  */
-export declare function findGeminiAuth(authStorage: AuthStorage, sessionId: string | undefined, signal: AbortSignal | undefined): Promise<GeminiAuth | null>;
+export declare function findGeminiAuth(authStorage: AuthStorage, sessionId: string | undefined, signal: AbortSignal | undefined): Promise<GeminiAuthSeed | null>;
 /**
  * Executes a web search using Google Gemini with Google Search grounding.
  */

package/package.json

@@ -1,7 +1,7 @@
 {
 	"type": "module",
 	"name": "@oh-my-pi/pi-coding-agent",
-	"version": "15.11.3",
+	"version": "15.11.4",
 	"description": "Coding agent CLI with read, bash, edit, write tools and session management",
 	"homepage": "https://omp.sh",
 	"author": "Can Boluk",
@@ -47,16 +47,16 @@
 		"@agentclientprotocol/sdk": "0.22.1",
 		"@babel/parser": "^7.29.7",
 		"@mozilla/readability": "^0.6.0",
-		"@oh-my-pi/hashline": "15.11.3",
-		"@oh-my-pi/omp-stats": "15.11.3",
-		"@oh-my-pi/pi-agent-core": "15.11.3",
-		"@oh-my-pi/pi-ai": "15.11.3",
-		"@oh-my-pi/pi-catalog": "15.11.3",
-		"@oh-my-pi/pi-mnemopi": "15.11.3",
-		"@oh-my-pi/pi-natives": "15.11.3",
-		"@oh-my-pi/pi-tui": "15.11.3",
-		"@oh-my-pi/pi-utils": "15.11.3",
-		"@oh-my-pi/snapcompact": "15.11.3",
+		"@oh-my-pi/hashline": "15.11.4",
+		"@oh-my-pi/omp-stats": "15.11.4",
+		"@oh-my-pi/pi-agent-core": "15.11.4",
+		"@oh-my-pi/pi-ai": "15.11.4",
+		"@oh-my-pi/pi-catalog": "15.11.4",
+		"@oh-my-pi/pi-mnemopi": "15.11.4",
+		"@oh-my-pi/pi-natives": "15.11.4",
+		"@oh-my-pi/pi-tui": "15.11.4",
+		"@oh-my-pi/pi-utils": "15.11.4",
+		"@oh-my-pi/snapcompact": "15.11.4",
 		"@opentelemetry/api": "^1.9.1",
 		"@opentelemetry/context-async-hooks": "^2.7.1",
 		"@opentelemetry/exporter-trace-otlp-proto": "^0.218.0",

package/src/auto-thinking/classifier.ts

@@ -83,11 +83,7 @@ async function classifyOnline(input: string, deps: ClassifyDifficultyDeps): Prom
 			messages: [{ role: "user", content: input, timestamp: Date.now() }],
 		},
 		{
-			apiKey: deps.registry.resolver(model.provider, {
-				sessionId: deps.sessionId,
-				baseUrl: model.baseUrl,
-				modelId: model.id,
-			}),
+			apiKey: deps.registry.resolver(model, deps.sessionId),
 			maxTokens,
 			disableReasoning: true,
 			metadata,

package/src/commit/model-selection.ts

@@ -48,7 +48,7 @@ export async function resolvePrimaryModel(
 	}
 	return {
 		model,
-		apiKey: modelRegistry.resolver(model.provider, { baseUrl: model.baseUrl, modelId: model.id }),
+		apiKey: modelRegistry.resolver(model),
 		thinkingLevel: resolved?.thinkingLevel,
 	};
 }
@@ -66,10 +66,7 @@ export async function resolveSmolModel(
 		if (apiKey) {
 			return {
 				model: resolvedSmol.model,
-				apiKey: modelRegistry.resolver(resolvedSmol.model.provider, {
-					baseUrl: resolvedSmol.model.baseUrl,
-					modelId: resolvedSmol.model.id,
-				}),
+				apiKey: modelRegistry.resolver(resolvedSmol.model),
 				thinkingLevel: resolvedSmol.thinkingLevel,
 			};
 		}
@@ -83,7 +80,7 @@ export async function resolveSmolModel(
 		if (apiKey) {
 			return {
 				model: candidate,
-				apiKey: modelRegistry.resolver(candidate.provider, { baseUrl: candidate.baseUrl, modelId: candidate.id }),
+				apiKey: modelRegistry.resolver(candidate),
 			};
 		}
 	}

package/src/config/api-key-resolver.ts

@@ -1,4 +1,7 @@
-import type { ApiKeyResolver, AuthStorage } from "@oh-my-pi/pi-ai";
+import type { Api, ApiKeyResolver, AuthStorage, Model } from "@oh-my-pi/pi-ai";
+
+/** Model slice accepted by the model-form `resolver(model, sessionId)` overload. */
+export type ApiKeyResolverModel = Pick<Model<Api>, "provider" | "baseUrl" | "id">;
 
 export interface ApiKeyResolverOptions {
 	/** Session id for credential stickiness; read at resolve time by the caller. */
@@ -26,10 +29,14 @@ export interface ApiKeyResolverRegistry {
 	 * policy: initial → resolve; step (b) → force-refresh same account; step (c)
 	 * → rotate to a sibling credential, then re-resolve.
 	 *
-	 * The resolver is stateless (safe to reuse across requests). Callers that
-	 * need the initial key for a guard can call `resolveApiKeyOnce(resolver)`.
+	 * Two call forms: `resolver(provider, options?)` for provider-scoped keys,
+	 * and `resolver(model, sessionId?)` which derives `baseUrl`/`modelId` from
+	 * the model. The resolver is stateless (safe to reuse across requests).
+	 * Callers that need the initial key for a guard can call
+	 * `resolveApiKeyOnce(resolver)`.
 	 */
 	resolver(provider: string, options?: ApiKeyResolverOptions): ApiKeyResolver;
+	resolver(model: ApiKeyResolverModel, sessionId?: string): ApiKeyResolver;
 }
 
 /**

package/src/config/keybindings.ts

@@ -137,7 +137,7 @@ export const KEYBINDINGS = {
 	},
 	"app.clipboard.pasteImage": {
 		defaultKeys: getDefaultPasteImageKeys(),
-		description: "Paste image from clipboard",
+		description: "Paste image or text from clipboard",
 	},
 	"app.clipboard.pasteTextRaw": {
 		defaultKeys: ["ctrl+shift+v", "alt+shift+v"],