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

package/dist/types/lsp/format-options.d.ts

@@ -0,0 +1,32 @@
+/** Subset of the LSP `FormattingOptions` we send. */
+export interface LspFormattingOptions {
+    tabSize: number;
+    insertSpaces: boolean;
+    trimTrailingWhitespace: boolean;
+    insertFinalNewline: boolean;
+    trimFinalNewlines: boolean;
+}
+interface DetectedIndent {
+    tabSize?: number;
+    insertSpaces?: boolean;
+}
+/**
+ * Sniff `insertSpaces` and the indent unit from `content`.
+ *
+ * Walks the buffer once: the first indented line decides spaces vs tabs; for
+ * space indents, the GCD of all space-indent widths gives the stride (so a
+ * 2/4/6 file reports `2`, a 4/8 file reports `4`). Returns `undefined` for any
+ * field the content does not pin so a higher-precedence override (editorconfig)
+ * can win without being overwritten by sniffing noise.
+ */
+export declare function detectIndentFromContent(content: string): DetectedIndent;
+/**
+ * Resolve the `FormattingOptions` payload for a `textDocument/formatting` request
+ * targeting `filePath` with `content`.
+ *
+ * The two fields that actually affect on-disk bytes (`tabSize`, `insertSpaces`)
+ * are layered: editorconfig wins, then content sniffing, then the fallback.
+ * Trim/final-newline flags are static.
+ */
+export declare function resolveFormatOptions(filePath: string, content: string): LspFormattingOptions;
+export {};

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/mnemopi/state.d.ts

@@ -75,7 +75,35 @@ export declare class MnemopiSessionState {
     }>, sourceId: string): Promise<void>;
     attachSessionListeners(): void;
     maybeRecallOnAgentStart(): Promise<void>;
-    dispose(): void;
+    /**
+     * Drain in-flight fact extraction and run beam consolidation on every owned
+     * bank, after capturing the current transcript. Mirrors the manual
+     * `/memory enqueue` slash command, but stops short of closing the DBs so
+     * callers can keep using the state. {@link dispose} composes this with the
+     * close step so normal session shutdown promotes working memory to
+     * episodic/gists/graph automatically (see issue #2320).
+     *
+     * Aliased subagent states share `scoped` (and therefore the actual SQLite
+     * banks) with their parent. `consolidate()` deliberately does NOT
+     * short-circuit on `aliasOf`: `forceRetainCurrentSession` already guards
+     * itself, and an explicit `/memory enqueue` invoked from within a subagent
+     * still needs to flush extractions and sleep the parent's shared banks —
+     * otherwise enqueue would report success while leaving the subagent's
+     * retained memories unconsolidated until the parent eventually shuts down
+     * (PR #2327 review).
+     */
+    consolidate(): Promise<void>;
+    /**
+     * Release the per-session resources. Defaults to running {@link consolidate}
+     * before closing handles so normal session shutdown promotes working memory
+     * into long-term storage. Callers that are about to delete the DB files —
+     * e.g. `mnemopiBackend.clear` — pass `{ consolidate: false }` to skip the
+     * extraction/sleep pass, since spending tokens on memories that will be
+     * wiped on the next line is wasted work (PR #2327 review).
+     */
+    dispose(options?: {
+        consolidate?: boolean;
+    }): Promise<void>;
 }
 export declare function getMnemopiScopedDbPaths(config: MnemopiBackendConfig): readonly string[];
 export declare function getMnemopiScopedBanks(config: MnemopiBackendConfig): readonly string[];

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/path-utils.d.ts

@@ -135,7 +135,7 @@ export declare function parseSearchPath(filePath: string): ParsedSearchPath;
 export declare function parseSearchPathPreferringLiteral(filePath: string, cwd: string): Promise<ParsedSearchPath>;
 export declare function parseFindPattern(pattern: string): ParsedFindPattern;
 export declare function combineSearchGlobs(prefixGlob?: string, suffixGlob?: string): string | undefined;
-export declare function resolveExplicitSearchPaths(pathItems: string[], cwd: string, suffixGlob?: string): Promise<ResolvedMultiSearchPath | undefined>;
+export declare function resolveExplicitSearchPaths(pathItems: string[], cwd: string, suffixGlob?: string, fanOutFileItems?: boolean): Promise<ResolvedMultiSearchPath | undefined>;
 export declare function resolveExplicitFindPatterns(patternItems: string[], cwd: string): Promise<ResolvedMultiFindPattern | undefined>;
 /**
  * Result of partitioning a list of user-supplied paths/globs into entries whose
@@ -176,6 +176,10 @@ export interface ToolScopeOptions {
     trackImmutableSources?: boolean;
     /** Honor `exactFilePaths` from {@link resolveExplicitSearchPaths} (search-only). */
     surfaceExactFilePaths?: boolean;
+    /** Fan plain-file entries out into per-target scans instead of folding them
+     * into a directory walk's glob union (search-only: the caller must dedupe
+     * matches from overlapping targets). */
+    fanOutFileTargets?: boolean;
     /** Extra hint appended to "Path not found" when stat fails and the user supplied multiple paths. */
     multipathStatHint?: string;
     /** Calling session's settings — forwarded to the internal-URL router so caller-aware handlers (issue://, pr://) honor it. */

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/git.d.ts

@@ -177,7 +177,7 @@ export declare const stage: {
 };
 /** Create a commit with the given message (passed via stdin). */
 export declare function commit(cwd: string, message: string, options?: CommitOptions): Promise<GitCommandResult>;
-/** Push the current branch. */
+/** Push the current branch (branch-scoped: never follows tags). */
 export declare function push(cwd: string, options?: PushOptions): Promise<void>;
 /** Checkout a ref. */
 export declare function checkout(cwd: string, ref: string, signal?: AbortSignal): Promise<void>;

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