@oh-my-pi/pi-coding-agent 16.0.3 → 16.0.5

package/dist/types/advisor/advise-tool.d.ts

@@ -39,6 +39,12 @@ export declare function formatAdvisorBatchContent(notes: readonly AdvisorNote[])
 export declare function isInterruptingSeverity(severity: AdvisorSeverity | undefined): boolean;
 /** How an advisor note is routed to the primary. */
 export type AdvisorDeliveryChannel = "aside" | "steer" | "preserve";
+/** Half-open turn-count fence for the post-interrupt cooldown. */
+export declare function isAdvisorInterruptImmuneTurnActive(opts: {
+    completedTurns: number;
+    immuneTurnStart: number | undefined;
+    immuneTurns: number;
+}): boolean;
 /**
  * Decide how one advisor note reaches the primary agent.
  *
@@ -54,12 +60,15 @@ export type AdvisorDeliveryChannel = "aside" | "steer" | "preserve";
  *   auto-resume anything, so it is delivered live. Parking it during an active
  *   run instead strands it (it never reaches the running agent) and the withheld
  *   notes dump as one burst at the next user prompt — the bug this guards.
+ * - During the post-interrupt immune-turn window, further `concern`/`blocker`
+ *   notes are downgraded to asides; suppression preservation still wins.
  */
 export declare function resolveAdvisorDeliveryChannel(opts: {
     severity: AdvisorSeverity | undefined;
     autoResumeSuppressed: boolean;
     streaming: boolean;
     aborting: boolean;
+    interruptImmuneTurnActive?: boolean;
 }): AdvisorDeliveryChannel;
 /**
  * Side-effect-free investigation tools handed to the advisor agent so it can

package/dist/types/cli/args.d.ts

@@ -14,11 +14,13 @@ export interface Args {
     smol?: string;
     slow?: string;
     plan?: string;
+    maxTime?: number;
     apiKey?: string;
     systemPrompt?: string;
     appendSystemPrompt?: string;
     thinking?: Effort;
     hideThinking?: boolean;
+    advisor?: boolean;
     continue?: boolean;
     resume?: string | true;
     help?: boolean;

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

@@ -73,6 +73,12 @@ export interface BenchDependencies {
     now?: () => number;
     stdoutIsTTY?: boolean;
 }
+/**
+ * Tokens/s over the generation window (duration minus TTFT) so queue/prefill
+ * latency does not dilute throughput. Falls back to total duration when the
+ * response arrived as a single chunk (TTFT ~ duration).
+ */
+export declare function computeTokensPerSecond(outputTokens: number, durationMs: number, ttftMs: number, deltaChunkCount: number): number;
 export declare function formatBenchTable(summary: BenchSummary): string;
 export declare function runBenchCommand(command: BenchCommandArgs, deps?: BenchDependencies): Promise<BenchSummary>;
 export {};

package/dist/types/commands/launch.d.ts

@@ -97,6 +97,9 @@ export default class Index extends Command {
         "hide-thinking": import("@oh-my-pi/pi-utils/cli").FlagDescriptor<"boolean"> & {
             description: string;
         };
+        advisor: import("@oh-my-pi/pi-utils/cli").FlagDescriptor<"boolean"> & {
+            description: string;
+        };
         hook: import("@oh-my-pi/pi-utils/cli").FlagDescriptor<"string"> & {
             description: string;
             multiple: true;
@@ -124,6 +127,9 @@ export default class Index extends Command {
         "no-title": import("@oh-my-pi/pi-utils/cli").FlagDescriptor<"boolean"> & {
             description: string;
         };
+        "max-time": import("@oh-my-pi/pi-utils/cli").FlagDescriptor<"string"> & {
+            description: string;
+        };
         "auto-approve": import("@oh-my-pi/pi-utils/cli").FlagDescriptor<"boolean"> & {
             aliases: string[];
             description: string;

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

@@ -209,10 +209,51 @@ export declare const SETTINGS_SCHEMA: {
             readonly description: "Pause the main agent for up to 30 seconds if the advisor falls behind by this many turns. Off disables catch-up delays.";
         };
     };
+    readonly "advisor.immuneTurns": {
+        readonly type: "number";
+        readonly default: 1;
+        readonly ui: {
+            readonly tab: "model";
+            readonly group: "Advisor";
+            readonly label: "Advisor Immune Turns";
+            readonly description: "After an advisor concern or blocker interrupts, route further concerns/blockers non-interruptingly for this many primary turns.";
+            readonly options: readonly [{
+                readonly value: "0";
+                readonly label: "0 turns";
+                readonly description: "Allow every concern/blocker to interrupt.";
+            }, {
+                readonly value: "1";
+                readonly label: "1 turn";
+                readonly description: "Default.";
+            }, {
+                readonly value: "2";
+                readonly label: "2 turns";
+            }, {
+                readonly value: "3";
+                readonly label: "3 turns";
+            }, {
+                readonly value: "4";
+                readonly label: "4 turns";
+            }, {
+                readonly value: "5";
+                readonly label: "5 turns";
+            }];
+        };
+    };
     readonly shellPath: {
         readonly type: "string";
         readonly default: undefined;
     };
+    readonly "git.enabled": {
+        readonly type: "boolean";
+        readonly default: true;
+        readonly ui: {
+            readonly tab: "interaction";
+            readonly group: "Git";
+            readonly label: "Enable Git Integration";
+            readonly description: "Show git branch, status, and PR information in the TUI and watch repository metadata.";
+        };
+    };
     readonly extensions: {
         readonly type: "array";
         readonly default: string[];
@@ -678,6 +719,16 @@ export declare const SETTINGS_SCHEMA: {
             readonly description: "Prevent images from being sent to LLM providers";
         };
     };
+    readonly "images.describeForTextModels": {
+        readonly type: "boolean";
+        readonly default: true;
+        readonly ui: {
+            readonly tab: "model";
+            readonly group: "Vision";
+            readonly label: "Describe Images for Text Models";
+            readonly description: "When an image is attached to a model without vision support, save it under local:// and inject a description from a vision-capable model instead of dropping it";
+        };
+    };
     readonly "tui.maxInlineImageColumns": {
         readonly type: "number";
         readonly default: 100;
@@ -714,6 +765,16 @@ export declare const SETTINGS_SCHEMA: {
             readonly description: "Wrap paths and URLs in OSC 8 hyperlinks for terminal-native click-to-open (auto: detect support; off: never; always: unconditional)";
         };
     };
+    readonly "tui.tight": {
+        readonly type: "boolean";
+        readonly default: false;
+        readonly ui: {
+            readonly tab: "appearance";
+            readonly group: "Display";
+            readonly label: "Tight Layout";
+            readonly description: "Remove the 1-character horizontal padding from the left and right of the terminal output";
+        };
+    };
     readonly "display.tabWidth": {
         readonly type: "number";
         readonly default: 3;
@@ -1550,7 +1611,7 @@ export declare const SETTINGS_SCHEMA: {
     };
     readonly "contextPromotion.enabled": {
         readonly type: "boolean";
-        readonly default: true;
+        readonly default: false;
         readonly ui: {
             readonly tab: "context";
             readonly group: "General";
@@ -1875,7 +1936,7 @@ export declare const SETTINGS_SCHEMA: {
     };
     readonly "tools.format": {
         readonly type: "enum";
-        readonly values: readonly ["auto", "native", "glm", "hermes", "kimi", "xml", "anthropic", "deepseek", "harmony", "pi", "qwen3", "gemini", "gemma"];
+        readonly values: readonly ["auto", "native", "glm", "hermes", "kimi", "xml", "anthropic", "deepseek", "harmony", "pi", "qwen3", "gemini", "gemma", "minimax"];
         readonly default: "auto";
         readonly ui: {
             readonly tab: "context";
@@ -1934,6 +1995,10 @@ export declare const SETTINGS_SCHEMA: {
                 readonly value: "gemma";
                 readonly label: "Gemma";
                 readonly description: "Use the Gemma owned dialect.";
+            }, {
+                readonly value: "minimax";
+                readonly label: "MiniMax";
+                readonly description: "Use the MiniMax owned dialect.";
             }];
         };
     };
@@ -2846,7 +2911,7 @@ export declare const SETTINGS_SCHEMA: {
             readonly tab: "files";
             readonly group: "Read Summaries";
             readonly label: "Read Summary Unfold Ceiling";
-            readonly description: "Hard ceiling on summary size while BFS-unfolding. An unfold that would exceed this is reverted and unfolding stops.";
+            readonly description: "Hard ceiling on summary size while BFS-unfolding. An unfold whose revealed lines would exceed this is skipped (that span stays folded) and unfolding continues with the remaining spans.";
         };
     };
     readonly "read.toolResultPreview": {
@@ -4132,6 +4197,30 @@ export declare const SETTINGS_SCHEMA: {
             readonly description: "Providers that web_search should never use, even as fallbacks";
         };
     };
+    readonly "providers.antigravityEndpoint": {
+        readonly type: "enum";
+        readonly values: readonly ["auto", "production", "sandbox"];
+        readonly default: "auto";
+        readonly ui: {
+            readonly tab: "providers";
+            readonly group: "Services";
+            readonly label: "Antigravity Endpoint Mode";
+            readonly description: "Endpoint routing strategy for google-antigravity providers (chat, search, image, discovery)";
+            readonly options: readonly [{
+                readonly value: "auto";
+                readonly label: "Auto";
+                readonly description: "Try production endpoint, fail over to sandbox on 5xx/429";
+            }, {
+                readonly value: "production";
+                readonly label: "Production Only";
+                readonly description: "Force production endpoint only";
+            }, {
+                readonly value: "sandbox";
+                readonly label: "Sandbox Only";
+                readonly description: "Force sandbox endpoint only";
+            }];
+        };
+    };
     readonly "providers.image": {
         readonly type: "enum";
         readonly values: readonly ["auto", "openai", "antigravity", "xai", "gemini", "openrouter"];

package/dist/types/edit/file-snapshot-store.d.ts

@@ -52,6 +52,8 @@ export declare function recordFileSnapshot(session: FileSnapshotStoreOwner, abso
  * the elided interior was never shown, so editing inside it must be rejected.
  */
 export declare function parseSeenLinesFromHashlineBody(body: string): number[];
+/** Merge explicit 1-indexed displayed lines into a recorded hashline snapshot. */
+export declare function recordSeenLines(session: FileSnapshotStoreOwner, absolutePath: string, tag: string, lines: readonly number[]): void;
 /**
  * Attach the lines a read displayed to the snapshot it minted, so the patcher
  * can reject edits anchored on lines the model never saw. Best-effort: a no-op

package/dist/types/extensibility/extensions/runner.d.ts

@@ -8,7 +8,7 @@ import type { ModelRegistry } from "../../config/model-registry";
 import type { Settings } from "../../config/settings";
 import type { MemoryRuntimeContext } from "../../memory-backend";
 import type { SessionManager } from "../../session/session-manager";
-import type { AfterProviderResponseEvent, AssistantThinkingRenderer, BeforeAgentStartEvent, BeforeAgentStartEventResult, BeforeProviderRequestEvent, BeforeProviderRequestEventResult, ContextEvent, Extension, ExtensionActions, ExtensionCommandContext, ExtensionCommandContextActions, ExtensionContext, ExtensionContextActions, ExtensionError, ExtensionEvent, ExtensionFlag, ExtensionRuntime, ExtensionShortcut, ExtensionUIContext, InputEvent, InputEventResult, MessageRenderer, RegisteredCommand, RegisteredTool, ResourcesDiscoverEvent, SessionBeforeBranchResult, SessionBeforeCompactResult, SessionBeforeSwitchResult, SessionBeforeTreeResult, SessionCompactingResult, ToolCallEvent, ToolCallEventResult, ToolResultEvent, ToolResultEventResult, UserBashEvent, UserBashEventResult, UserPythonEvent, UserPythonEventResult } from "./types";
+import type { AfterProviderResponseEvent, AssistantThinkingRenderer, BeforeAgentStartEvent, BeforeAgentStartEventResult, BeforeProviderRequestEvent, BeforeProviderRequestEventResult, ContextEvent, Extension, ExtensionActions, ExtensionCommandContext, ExtensionCommandContextActions, ExtensionContext, ExtensionContextActions, ExtensionError, ExtensionEvent, ExtensionFlag, ExtensionRuntime, ExtensionShortcut, ExtensionUIContext, InputEvent, InputEventResult, MessageRenderer, RegisteredCommand, RegisteredTool, ResourcesDiscoverEvent, SessionBeforeBranchResult, SessionBeforeCompactResult, SessionBeforeSwitchResult, SessionBeforeTreeResult, SessionCompactingResult, SessionStopEvent, SessionStopEventResult, ToolCallEvent, ToolCallEventResult, ToolResultEvent, ToolResultEventResult, UserBashEvent, UserBashEventResult, UserPythonEvent, UserPythonEventResult } from "./types";
 /** Combined result from all before_agent_start handlers */
 interface BeforeAgentStartCombinedResult {
     messages?: NonNullable<BeforeAgentStartEventResult["message"]>[];
@@ -43,7 +43,9 @@ type RunnerEmitResult<TEvent extends RunnerEmitEvent> = TEvent extends {
     type: "session_before_tree";
 } ? SessionBeforeTreeResult | undefined : TEvent extends {
     type: "session.compacting";
-} ? SessionCompactingResult | undefined : undefined;
+} ? SessionCompactingResult | undefined : TEvent extends {
+    type: "session_stop";
+} ? SessionStopEventResult | undefined : undefined;
 export type NewSessionHandler = (options?: {
     parentSession?: string;
     setup?: (sessionManager: SessionManager) => Promise<void>;
@@ -92,6 +94,7 @@ export declare class ExtensionRunner {
      * {@link onError} via {@link emit}'s normal isolation.
      */
     emitCredentialDisabled(event: CredentialDisabledEvent): Promise<void>;
+    emitSessionStop(event: Omit<SessionStopEvent, "type">): Promise<SessionStopEventResult | undefined>;
     getUIContext(): ExtensionUIContext;
     hasUI(): boolean;
     getExtensionPaths(): string[];

package/dist/types/extensibility/extensions/types.d.ts

@@ -29,7 +29,7 @@ import type { ReadonlySessionManager, SessionManager } from "../../session/sessi
 import type { BashToolDetails, BashToolInput, FindToolDetails, FindToolInput, ReadToolDetails, ReadToolInput, SearchToolDetails, SearchToolInput, WriteToolInput } from "../../tools";
 import type { ApprovalMode } from "../../tools/approval";
 import type { EventBus } from "../../utils/event-bus";
-import type { AgentEndEvent, AgentStartEvent, AutoCompactionEndEvent, AutoCompactionStartEvent, AutoRetryEndEvent, AutoRetryStartEvent, ContextEvent, GoalUpdatedEvent, SessionBeforeBranchEvent, SessionBeforeBranchResult, SessionBeforeCompactEvent, SessionBeforeCompactResult, SessionBeforeSwitchEvent, SessionBeforeSwitchResult, SessionBeforeTreeEvent, SessionBeforeTreeResult, SessionBranchEvent, SessionCompactEvent, SessionCompactingEvent, SessionCompactingResult, SessionEvent, SessionShutdownEvent, SessionStartEvent, SessionSwitchEvent, SessionTreeEvent, TodoReminderEvent, ToolCallEventResult, ToolResultEventResult, TtsrTriggeredEvent, TurnEndEvent, TurnStartEvent } from "../shared-events";
+import type { AgentEndEvent, AgentStartEvent, AutoCompactionEndEvent, AutoCompactionStartEvent, AutoRetryEndEvent, AutoRetryStartEvent, ContextEvent, GoalUpdatedEvent, SessionBeforeBranchEvent, SessionBeforeBranchResult, SessionBeforeCompactEvent, SessionBeforeCompactResult, SessionBeforeSwitchEvent, SessionBeforeSwitchResult, SessionBeforeTreeEvent, SessionBeforeTreeResult, SessionBranchEvent, SessionCompactEvent, SessionCompactingEvent, SessionCompactingResult, SessionEvent, SessionShutdownEvent, SessionStartEvent, SessionStopEvent, SessionStopEventResult, SessionSwitchEvent, SessionTreeEvent, TodoReminderEvent, ToolCallEventResult, ToolResultEventResult, TtsrTriggeredEvent, TurnEndEvent, TurnStartEvent } from "../shared-events";
 import type { SlashCommandInfo } from "../slash-commands";
 import type * as TypeBox from "../typebox";
 export type { AppKeybinding, KeybindingsManager } from "../../config/keybindings";
@@ -161,11 +161,11 @@ export interface ExtensionUIContext {
     setToolsExpanded(expanded: boolean): void;
 }
 export interface ContextUsage {
-    /** Estimated context tokens, or null if unknown (e.g. right after compaction, before next LLM response). */
-    tokens: number | null;
+    /** Estimated context tokens. */
+    tokens: number;
     contextWindow: number;
-    /** Context usage as percentage of context window, or null if tokens is unknown. */
-    percent: number | null;
+    /** Context usage as percentage of context window. */
+    percent: number;
 }
 export interface CompactOptions {
     onComplete?: (result: CompactionResult) => void;
@@ -347,7 +347,7 @@ export interface BeforeAgentStartEvent {
     images?: ImageContent[];
     systemPrompt: string[];
 }
-export type { AgentEndEvent, AgentStartEvent, TurnEndEvent, TurnStartEvent } from "../shared-events";
+export type { AgentEndEvent, AgentStartEvent, SessionStopEvent, SessionStopEventResult, TurnEndEvent, TurnStartEvent, } from "../shared-events";
 /** Fired when a message starts (user, assistant, or toolResult) */
 export interface MessageStartEvent {
     type: "message_start";
@@ -542,7 +542,7 @@ export declare function isToolCallEventType<TName extends string, TInput extends
     input: TInput;
 };
 /** Union of all event types */
-export type ExtensionEvent = ResourcesDiscoverEvent | SessionEvent | ContextEvent | BeforeProviderRequestEvent | AfterProviderResponseEvent | BeforeAgentStartEvent | AgentStartEvent | AgentEndEvent | TurnStartEvent | TurnEndEvent | MessageStartEvent | MessageUpdateEvent | MessageEndEvent | ToolExecutionStartEvent | ToolExecutionUpdateEvent | ToolExecutionEndEvent | AutoCompactionStartEvent | AutoCompactionEndEvent | AutoRetryStartEvent | AutoRetryEndEvent | TtsrTriggeredEvent | TodoReminderEvent | GoalUpdatedEvent | CredentialDisabledEvent | UserBashEvent | UserPythonEvent | InputEvent | ToolCallEvent | ToolResultEvent | ToolApprovalRequestedEvent | ToolApprovalResolvedEvent;
+export type ExtensionEvent = ResourcesDiscoverEvent | SessionEvent | ContextEvent | BeforeProviderRequestEvent | AfterProviderResponseEvent | BeforeAgentStartEvent | AgentStartEvent | AgentEndEvent | SessionStopEvent | TurnStartEvent | TurnEndEvent | MessageStartEvent | MessageUpdateEvent | MessageEndEvent | ToolExecutionStartEvent | ToolExecutionUpdateEvent | ToolExecutionEndEvent | AutoCompactionStartEvent | AutoCompactionEndEvent | AutoRetryStartEvent | AutoRetryEndEvent | TtsrTriggeredEvent | TodoReminderEvent | GoalUpdatedEvent | CredentialDisabledEvent | UserBashEvent | UserPythonEvent | InputEvent | ToolCallEvent | ToolResultEvent | ToolApprovalRequestedEvent | ToolApprovalResolvedEvent;
 export interface ContextEventResult {
     messages?: AgentMessage[];
 }
@@ -623,6 +623,7 @@ export interface ExtensionAPI {
     on(event: "before_agent_start", handler: ExtensionHandler<BeforeAgentStartEvent, BeforeAgentStartEventResult>): void;
     on(event: "agent_start", handler: ExtensionHandler<AgentStartEvent>): void;
     on(event: "agent_end", handler: ExtensionHandler<AgentEndEvent>): void;
+    on(event: "session_stop", handler: ExtensionHandler<SessionStopEvent, SessionStopEventResult>): void;
     on(event: "turn_start", handler: ExtensionHandler<TurnStartEvent>): void;
     on(event: "turn_end", handler: ExtensionHandler<TurnEndEvent>): void;
     on(event: "message_start", handler: ExtensionHandler<MessageStartEvent>): void;

package/dist/types/extensibility/shared-events.d.ts

@@ -79,6 +79,16 @@ export interface SessionCompactEvent {
 export interface SessionShutdownEvent {
     type: "session_shutdown";
 }
+/** Fired when a main-agent turn is about to settle; handlers may request one continuation turn. */
+export interface SessionStopEvent {
+    type: "session_stop";
+    messages: AgentMessage[];
+    turn_id: number;
+    last_assistant_message?: AgentMessage;
+    session_id: string;
+    session_file?: string;
+    stop_hook_active: boolean;
+}
 /** Preparation data for tree navigation (used by session_before_tree event) */
 export interface TreePreparation {
     /** Node being switched to */
@@ -118,7 +128,7 @@ export interface GoalUpdatedEvent {
     goal: Goal | null;
     state?: GoalModeState;
 }
-export type SessionEvent = SessionStartEvent | SessionBeforeSwitchEvent | SessionSwitchEvent | SessionBeforeBranchEvent | SessionBranchEvent | SessionBeforeCompactEvent | SessionCompactingEvent | SessionCompactEvent | SessionShutdownEvent | SessionBeforeTreeEvent | SessionTreeEvent | GoalUpdatedEvent;
+export type SessionEvent = SessionStartEvent | SessionBeforeSwitchEvent | SessionSwitchEvent | SessionBeforeBranchEvent | SessionBranchEvent | SessionBeforeCompactEvent | SessionCompactingEvent | SessionCompactEvent | SessionStopEvent | SessionShutdownEvent | SessionBeforeTreeEvent | SessionTreeEvent | GoalUpdatedEvent;
 /**
  * Fired before each LLM call.
  *
@@ -264,6 +274,17 @@ export interface SessionCompactingResult {
     /** Custom data to store in compaction entry */
     preserveData?: Record<string, unknown>;
 }
+/** Return type for `session_stop` handlers */
+export interface SessionStopEventResult {
+    /** Continue the main session with additional context before settling */
+    continue?: boolean;
+    /** OMP-native model-visible context for the continuation */
+    additionalContext?: string;
+    /** Claude/Codex-compatible block decision; maps to a continuation */
+    decision?: "block";
+    /** Claude/Codex-compatible model-visible continuation reason */
+    reason?: string;
+}
 /** Return type for `session_before_tree` handlers */
 export interface SessionBeforeTreeResult {
     /** If true, cancel the navigation entirely */

package/dist/types/main.d.ts

@@ -10,6 +10,7 @@ import type { AuthStorage } from "./session/auth-storage";
 import { type SessionInfo } from "./session/session-listing";
 import { SessionManager } from "./session/session-manager";
 type RunAcpMode = (createSession: AcpSessionFactory) => Promise<never>;
+export declare function writeStartupNotice(parsedArgs: Pick<Args, "mode">, text: string): void;
 export interface InteractiveModeNotify {
     kind: "warn" | "error" | "info";
     message: string;

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

@@ -50,7 +50,7 @@ export declare class StatusLineComponent implements Component {
      * for unit tests and the collab host's state broadcast.
      */
     getCachedContextBreakdown(): {
-        usedTokens: number | null;
+        usedTokens: number;
         contextWindow: number;
     };
     getTopBorder(width: number): {

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

@@ -4,7 +4,6 @@ export declare function getContextUsageLevel(contextPercent: number, contextWind
 /**
  * Format context usage as `<percent>%/<window>` (e.g. `5.1%/1M`), matching the
  * status line's context gauge so subagent and footer renderers stay in sync.
- * A `null`/`undefined` percent (unknown, e.g. right after compaction) renders as `?`.
  */
 export declare function formatContextUsage(contextPercent: number | null | undefined, contextWindow: number): string;
 export declare function getContextUsageThemeColor(level: ContextUsageLevel): ThemeColor;

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

@@ -188,7 +188,7 @@ export interface RpcSessionState {
         parameters: unknown;
         examples?: readonly ToolExample[];
     }>;
-    /** Current context window usage. Null tokens/percent when unknown (e.g. right after compaction). */
+    /** Current context window usage. */
     contextUsage?: ContextUsage;
 }
 export interface RpcAvailableSlashCommand {

package/dist/types/modes/utils/context-usage.d.ts

@@ -37,6 +37,18 @@ export declare function estimateToolSchemaTokens(tools: ReadonlyArray<Pick<Tool,
  * messages walked incrementally as new entries append.
  */
 export declare function computeNonMessageTokens(session: AgentSession): number;
+/**
+ * Shared helper for the four non-message token totals used by
+ * `computeContextBreakdown` (/context panel). Keep this category split stable:
+ * the status-line fast path intentionally uses the equivalent collapsed total
+ * in `computeNonMessageTokens`.
+ */
+export declare function computeNonMessageBreakdown(session: AgentSession): {
+    skillsTokens: number;
+    toolsTokens: number;
+    systemContextTokens: number;
+    systemPromptTokens: number;
+};
 /**
  * Compute a breakdown of estimated context usage by category for the active
  * session and model.

package/dist/types/sdk.d.ts

@@ -55,6 +55,8 @@ export interface CreateAgentSessionOptions {
     providerSessionId?: string;
     /** Optional provider-facing prompt cache key, distinct from request lineage. */
     providerPromptCacheKey?: string;
+    /** Absolute wall-clock deadline in Unix epoch milliseconds. */
+    deadline?: number;
     /** Custom tools to register (in addition to built-in tools). Accepts both CustomTool and ToolDefinition. */
     customTools?: (CustomTool | ToolDefinition)[];
     /** Inline extensions (merged with discovery). */
@@ -193,7 +195,7 @@ export interface CreateAgentSessionResult {
     eventBus: EventBus;
 }
 export type DialectFormat = "auto" | "native" | Dialect;
-export declare function resolveDialect(format: DialectFormat, model: Pick<Model, "supportsTools"> | undefined): Dialect | undefined;
+export declare function resolveDialect(format: DialectFormat, model: (Pick<Model, "supportsTools"> & Partial<Pick<Model, "id">>) | undefined): Dialect | undefined;
 export type { PromptTemplate } from "./config/prompt-templates";
 export { Settings, type SkillsSettings } from "./config/settings";
 export type { CustomCommand, CustomCommandFactory } from "./extensibility/custom-commands/types";

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

@@ -297,6 +297,16 @@ export interface RoleModelCycle {
     models: ResolvedRoleModel[];
     currentIndex: number;
 }
+export interface ContextUsageBreakdown {
+    contextWindow: number;
+    anchored: boolean;
+    usedTokens: number;
+    systemPromptTokens: number;
+    systemToolsTokens: number;
+    systemContextTokens: number;
+    skillsTokens: number;
+    messagesTokens: number;
+}
 /** Session statistics for /session command */
 export interface SessionStats {
     sessionFile: string | undefined;
@@ -1102,9 +1112,19 @@ export declare class AgentSession {
      * Uses the last assistant message's usage data when available,
      * otherwise estimates tokens for all messages.
      */
+    getContextBreakdown(options?: {
+        contextWindow?: number;
+        pendingMessages?: AgentMessage[];
+    }): ContextUsageBreakdown | undefined;
     getContextUsage(options?: {
         contextWindow?: number;
     }): ContextUsage | undefined;
+    /**
+     * Monotonic counter that changes whenever the in-flight pending context
+     * snapshot is set or cleared. Status-line context memoization keys on this so
+     * a value computed mid-turn cannot persist after the turn ends/aborts.
+     */
+    get contextUsageRevision(): number;
     fetchUsageReports(signal?: AbortSignal): Promise<UsageReport[] | null>;
     /**
      * Redeem one saved Codex rate-limit reset for a specific account, injecting

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

@@ -5,4 +5,8 @@ export declare function isImageBlock(value: unknown): value is {
     data: string;
     mimeType?: string;
 };
+export declare function isImageDataPayload(value: unknown): value is {
+    data: string;
+    mimeType?: string;
+};
 export declare function prepareEntryForPersistence(entry: FileEntry, blobStore: BlobStore): FileEntry;

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

@@ -31,6 +31,7 @@ export interface ReadToolDetails {
     displayContent?: {
         text: string;
         startLine: number;
+        lineNumbers?: Array<number | null>;
     };
     summary?: {
         lines: number;

package/dist/types/tui/code-cell.d.ts

@@ -19,6 +19,8 @@ export interface CodeCellOptions {
     codeTail?: boolean;
     expanded?: boolean;
     width: number;
+    codeStartLine?: number;
+    codeLineNumbers?: Array<number | null>;
 }
 export declare function renderCodeCell(options: CodeCellOptions, theme: Theme): string[];
 export interface MarkdownCellOptions {

package/dist/types/utils/image-vision-fallback.d.ts

@@ -0,0 +1,28 @@
+import { type AgentTelemetryConfig } from "@oh-my-pi/pi-agent-core";
+import type { Api, completeSimple, ImageContent, Model, TextContent } from "@oh-my-pi/pi-ai";
+import type { ModelRegistry } from "../config/model-registry";
+import type { Settings } from "../config/settings";
+import { type LocalProtocolOptions } from "../internal-urls";
+/** Registry surface needed to resolve a vision model and authorize requests. */
+export type VisionFallbackRegistry = Pick<ModelRegistry, "getAvailable" | "getApiKey" | "resolver"> & Partial<Pick<ModelRegistry, "resolveCanonicalModel" | "getCanonicalVariants" | "getCanonicalId">>;
+export interface DescribeAttachedImagesDeps {
+    /** Active (text-only) model the prompt is destined for. */
+    activeModel: Model<Api>;
+    modelRegistry: VisionFallbackRegistry;
+    settings: Settings;
+    /** Inputs for resolving the session-scoped `local://` root. */
+    localProtocolOptions: LocalProtocolOptions;
+    /** `provider/id` of the active model; a last-resort vision-model candidate (filtered to image-capable). */
+    activeModelString?: string;
+    telemetryConfig?: AgentTelemetryConfig;
+    sessionId?: string;
+    /** Test seam: overrides the underlying completeSimple call. */
+    completeImpl?: typeof completeSimple;
+}
+/**
+ * Save each attached image under `local://` and replace it with a descriptive
+ * text block. Returns one {@link TextContent} per input image, in order. Never
+ * throws for an individual image: a failed description falls back to a note while
+ * the saved-path block is still emitted.
+ */
+export declare function describeAttachedImagesForTextModel(images: readonly ImageContent[], deps: DescribeAttachedImagesDeps, signal?: AbortSignal): Promise<TextContent[]>;

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

@@ -50,6 +50,7 @@ export interface SearchParams {
      * caller's agent session when available; otherwise omit.
      */
     sessionId?: string;
+    antigravityEndpointMode?: "auto" | "production" | "sandbox";
 }
 /** Base class for web search providers. */
 export declare abstract class SearchProvider {

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

@@ -31,6 +31,7 @@ export interface GeminiSearchParams extends GeminiToolParams {
     authStorage: AuthStorage;
     sessionId?: string;
     fetch?: FetchImpl;
+    antigravityEndpointMode?: "auto" | "production" | "sandbox";
 }
 export declare function buildGeminiRequestTools(params: GeminiToolParams): Array<Record<string, Record<string, unknown>>>;
 /** First configured Gemini OAuth provider plus its pre-resolved access. */

package/package.json

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