@oh-my-pi/pi-tui 18.2.10 → 18.3.0

package/CHANGELOG.md

@@ -2,6 +2,38 @@
 
 ## [Unreleased]
 
+## [18.3.0] - 2026-09-24
+
+### Added
+
+- Added proc:// and agent:// URI support for interacting with processes and agents.
+- Added support for xd:// documentation topic URLs.
+- Added rendering for background job state and peer-to-peer messages from the wait tool.
+- Added supervised bash service rendering with status, readiness, and output information.
+- Added a fullscreen annotation overlay for diffs and text, including multi-line notes, editing, deletion, and undo ([#12601](https://github.com/can1357/oh-my-pi/pull/12601) by [@anatoli-tsinovoy](https://github.com/anatoli-tsinovoy)).
+- Added Daybreak-enabled account listings to the usage dashboard.
+
+### Changed
+
+- Mermaid flowcharts and state diagrams now automatically choose a layout that best fits the available terminal width and reflow when the terminal is resized.
+- Plan Review annotations now support multi-line editing, deletion, and undo ([#12601](https://github.com/can1357/oh-my-pi/pull/12601) by [@anatoli-tsinovoy](https://github.com/anatoli-tsinovoy)).
+
+### Fixed
+
+- Fixed AltGr characters, including `[`, `]`, `{`, and `}`, being dropped in Windows Terminal when using the kitty keyboard protocol on Hungarian and other international keyboard layouts ([#12984](https://github.com/can1357/oh-my-pi/pull/12984) by [@H4vC](https://github.com/H4vC)).
+
+## [18.2.11] - 2026-09-23
+
+### Added
+
+- Added a Skills section to the settings.
+- Enabled OSC 8 hyperlinks in rio.
+
+### Fixed
+
+- Fixed scrolling startup release notes without requiring an initial Escape keypress.
+- Improved usage quota display so names remain distinguishable and readable in narrow and multi-column dashboards.
+
 ## [18.2.10] - 2026-09-22
 
 ### Changed

package/THIRD-PARTY-NOTICES.txt

@@ -293,7 +293,7 @@ MIT License
 Copyright (c) 2026 Sander Land
   (measured tokenizer vocabulary data, reconstruction model, and reference
   implementation: https://github.com/sanderland/ctok)
-Copyright (c) 2026 Can Bölük and the Oh My Pi contributors
+Copyright (c) 2026 Can Bölük and the omp contributors
 Copyright (c) 2026 Stencil Labs, Inc.
   (Rust implementation and the compact binary vocabulary encoding in
   crates/pi-natives/src/utok/claude)

package/dist/types/apps/ps-data.d.ts

@@ -1,4 +1,4 @@
-import type { DaemonSnapshot, DaemonSpec, DaemonState } from "../tools/hub.js";
+import type { DaemonSnapshot, DaemonSpec, DaemonState } from "../tools/daemon.js";
 /** One broker scope: a project runtime dir or a machine-global service dir. */
 export interface PsScope {
     kind: "project" | "global";

package/dist/types/apps/ps-top.d.ts

@@ -1,5 +1,5 @@
 import { type Component, TUI } from "../tui.js";
-import type { DaemonSnapshot, DaemonSpec } from "../tools/hub.js";
+import type { DaemonSnapshot, DaemonSpec } from "../tools/daemon.js";
 import { type PsScope, type PsScopeReport, type PsTarget } from "./ps-data.js";
 /** Options accepted by the interactive monitor: scope selection from the list flags. */
 export interface PsTopOptions extends PsTarget {

package/dist/types/chat/chat-transcript-builder.d.ts

@@ -5,7 +5,7 @@
  * viewer ({@link AgentTranscriptViewer}) to render a parked subagent / advisor /
  * collab-guest transcript that has no live session.
  *
- * Unlike the old incremental hub sync, {@link ChatTranscriptBuilder.rebuild}
+ * Unlike incremental transcript sync, {@link ChatTranscriptBuilder.rebuild}
  * always discards prior components and rebuilds the whole transcript from the
  * supplied entries. Re-rendering a growing transcript is therefore O(n) in the
  * entry count, but it cannot duplicate or misorder rows the way incremental

package/dist/types/overlays/annotation-overlay.d.ts

@@ -0,0 +1,30 @@
+import { type Component, type TUI } from "../index.js";
+import { type KeybindingsManager } from "../app-keybindings.js";
+import { type Theme } from "../theme/theme.js";
+import type { CodeReviewAnnotation, CodeReviewOverlayResult, ReviewDiffFile, TextReviewAnnotation, TextReviewOverlayResult, TextReviewSource } from "./annotation-types.js";
+export declare const CONTINUE_CODE_REVIEW_ACTION = "Continue with LLM review";
+export declare const PASTE_CODE_REVIEW_ACTION = "Paste annotations into prompt";
+export interface AnnotationOverlayCallbacks {
+    onComplete(result: CodeReviewOverlayResult | TextReviewOverlayResult | undefined): void;
+    onWarning?(message: string): void;
+    /** Open the draft in the host's editor and invoke `commit` with its result. */
+    onAnnotationExternalEditor?(draft: string, commit: (text: string | null) => void): void | Promise<void>;
+}
+export interface CodeReviewOverlayCallbacks extends AnnotationOverlayCallbacks {
+    onComplete(result: CodeReviewOverlayResult | undefined): void;
+}
+export interface TextReviewOverlayCallbacks extends AnnotationOverlayCallbacks {
+    onComplete(result: TextReviewOverlayResult | undefined): void;
+}
+/** A fullscreen, annotated diff picker that only relies on public OMP APIs. */
+export declare class AnnotationOverlay implements Component {
+    #private;
+    constructor(tui: TUI, theme: Theme, keybindings: KeybindingsManager, files: readonly ReviewDiffFile[], mode: string, callbacks: CodeReviewOverlayCallbacks);
+    constructor(tui: TUI, theme: Theme, keybindings: KeybindingsManager, source: TextReviewSource, callbacks: TextReviewOverlayCallbacks);
+    invalidate(): void;
+    dispose(): void;
+    getAnnotations(): CodeReviewAnnotation[];
+    getTextAnnotations(): TextReviewAnnotation[];
+    handleInput(data: string): void;
+    render(width: number): readonly string[];
+}

package/dist/types/overlays/annotation-types.d.ts

@@ -0,0 +1,84 @@
+export type ReviewSourceRowKind = "context" | "added" | "removed";
+export interface ReviewSourceRow {
+    kind: ReviewSourceRowKind;
+    raw: string;
+    content: string;
+    oldLine?: number;
+    newLine?: number;
+    hunkHeader: string;
+}
+export type ReviewDiffRow = ReviewSourceRow | {
+    kind: "hunk";
+    raw: string;
+    hunkHeader: string;
+} | {
+    kind: "no-newline";
+    raw: string;
+    hunkHeader: string;
+};
+export interface ReviewDiffFile {
+    path: string;
+    oldPath?: string;
+    newPath?: string;
+    occurrence: number;
+    rawDiff: string;
+    rows: ReviewDiffRow[];
+    linesAdded: number;
+    linesRemoved: number;
+    isBinary: boolean;
+}
+export interface CodeReviewAnnotationBase {
+    path: string;
+    oldPath?: string;
+    newPath?: string;
+    occurrence: number;
+    note: string;
+}
+export type CodeReviewAnnotation = (CodeReviewAnnotationBase & {
+    scope: "file";
+}) | (CodeReviewAnnotationBase & {
+    scope: "line";
+    hunkHeader: string;
+    oldLine?: number;
+    newLine?: number;
+    rawLine: string;
+});
+export interface CodeReviewOverlayResult {
+    action: "review" | "paste";
+    annotations: CodeReviewAnnotation[];
+}
+export type TextReviewSourceProvenance = {
+    kind: "latest-assistant";
+    entryId: string;
+} | {
+    kind: "session";
+    entryId: string;
+} | {
+    kind: "file";
+    path: string;
+} | {
+    kind: "prompt";
+};
+export interface TextReviewSource {
+    /** Identifies the source within this annotation run. */
+    id: string;
+    kind: "message" | "code" | "quote" | "command" | "file" | "prompt";
+    label: string;
+    text: string;
+    /** Identifies the active session entry that supplied this source, when applicable. */
+    provenance?: TextReviewSourceProvenance;
+    sessionId?: string;
+}
+export type TextReviewAnnotation = {
+    scope: "text";
+    note: string;
+} | {
+    scope: "line";
+    line: number;
+    quote: string;
+    note: string;
+};
+export interface TextReviewOverlayResult {
+    action: "paste";
+    annotations: TextReviewAnnotation[];
+}

package/dist/types/overlays/copy-selector.d.ts

@@ -29,12 +29,40 @@ export interface CopySelectorDeps {
     proseOnlyThinking?: () => boolean;
     linkTargets?: ReadonlyMap<string, string>;
     requestRender: () => void;
-    /** The outlined content was chosen — copy it. `label` feeds the status line. */
-    onPick: (content: string, label: string) => void;
+    /** Replaces the "Copy" header when the picker is reused for another purpose. */
+    title?: string;
+    /** Verb shown for the pick action in hints and block controls (default "copy"). */
+    actionLabel?: string;
+    /**
+     * The outlined content was chosen — copy it. `label` feeds the status line;
+     * `source` names the transcript entry (and inner block, when descended) it came from.
+     */
+    onPick: (content: string, label: string, source: CopyPickSource) => void;
     /** `o` on a link block — open `href` with the system opener. Absent: `o` is ignored. */
     onOpen?: (href: string, label: string) => void;
     onCancel: () => void;
 }
+/** Where picked content came from in the transcript. */
+export interface CopyPickSource {
+    entry: TranscriptEntry;
+    /** The inner block, when the pick happened in the descended block view. */
+    block?: CopyBlock;
+}
+/** One copyable inner block of a transcript turn. */
+export interface CopyBlock {
+    /** Short kind label ("code · ts", "bash command", "read result", …). */
+    label: string;
+    /** Exact text placed on the clipboard. */
+    content: string;
+    /** Transcript entry that produced this block. */
+    entry: TranscriptEntry;
+    /** Markdown code/quote block, or a bash/eval tool-call command. */
+    kind?: "code" | "quote" | "command";
+    /** Highlight language for the block preview. */
+    language?: string;
+    /** Set for link blocks: the URL `o` opens. `content` is the same URL. */
+    href?: string;
+}
 export declare class CopySelectorComponent implements Component {
     #private;
     private readonly deps;

package/dist/types/overlays/copy-targets.d.ts

@@ -61,3 +61,5 @@ export declare function extractLastLink(messages: readonly AgentMessage[]): Link
 export declare function commandFromToolCall(tc: ToolCall): LastCommand | undefined;
 /** Walk the transcript backwards for the most recent bash command or eval code. */
 export declare function extractLastCommand(messages: readonly AgentMessage[]): LastCommand | undefined;
+/** Concatenated visible text of an assistant message, verbatim; undefined when blank. */
+export declare function assistantText(msg: AgentMessage): string | undefined;

package/dist/types/overlays/model-hub.d.ts

@@ -1,4 +1,4 @@
-import type { Model } from "@oh-my-pi/pi-ai";
+import type { KeysApi, Model } from "@oh-my-pi/pi-ai";
 import type { Component, TUI } from "../tui.js";
 import type { ModelBrowserSource, ModelBrowserRegistry } from "./model-browser.js";
 import { type ConfiguredThinkingLevel } from "../thinking.js";
@@ -15,7 +15,7 @@ export interface ModelHubSource extends ModelBrowserSource {
 /** Catalog capabilities required by the model hub. */
 export interface ModelHubRegistry extends ModelBrowserRegistry {
     readonly authStorage: {
-        hasAuth(provider: string): boolean;
+        readonly keys: Pick<KeysApi, "source">;
     };
     getDiscoverableProviders(): string[];
     getProviderDiscoveryState(provider: string): {

package/dist/types/overlays/oauth-selector.d.ts

@@ -1,13 +1,10 @@
+import type { CredentialsApi, KeysApi } from "@oh-my-pi/pi-ai";
 import { type SgrMouseEvent } from "../index.js";
 import { OverlayPanel } from "../chrome/overlay-box.js";
 /** Credential presence and provenance needed by the provider picker. */
 export interface OAuthSelectorAuthSource {
-    has(providerId: string): boolean;
-    hasAuth(providerId: string): boolean;
-    getCredentialOrigin(providerId: string): {
-        kind: "runtime" | "config" | "oauth" | "api_key" | "env" | "fallback";
-        envVar?: string;
-    } | undefined;
+    readonly credentials: Pick<CredentialsApi, "has">;
+    readonly keys: Pick<KeysApi, "source">;
 }
 /**
  * Component that renders an OAuth provider selector.

package/dist/types/overlays/usage-dashboard.d.ts

@@ -38,6 +38,8 @@ export interface ProviderCard {
         soonestExpiryMs?: number;
         unavailableReasons: string[];
     };
+    /** Labels of accounts with verified Daybreak access. */
+    daybreakAccounts?: string[];
 }
 /**
  * Collapse usage reports into one compact card per provider: limits grouped by

package/dist/types/prompt/image-source.d.ts

@@ -1,16 +1,17 @@
 /**
- * Original filesystem source carried on image attachments that entered from a
- * file on disk: path-pasted/drag-and-dropped images and generated video
- * contact-sheet previews. Symbol metadata stays out of serialized/model-bound
- * image data while traveling with the draft object, until AgentSession creates
- * the hidden companion message that tells the model the path (and link
- * materialization prefers it over a blob copy).
+ * File source carried on image attachments backed by a file on disk:
+ * path-pasted/drag-and-dropped images, clipboard images the coding agent commits
+ * to the session's `local://` root, and generated video contact-sheet previews.
+ * Symbol metadata stays out of serialized/model-bound image data while traveling
+ * with the draft object, until AgentSession creates the hidden companion message
+ * that tells the model the path (and link materialization prefers it over a blob copy).
  */
 import type { ImageContent } from "@oh-my-pi/pi-ai";
 /** How an image attachment's backing file entered the session. */
 export type ImageAttachmentSourceKind = "image" | "video";
-/** Original local file backing an image attachment. */
+/** Local file backing an image attachment. */
 export interface ImageAttachmentSource {
+    /** Absolute filesystem path, or a session-relative `local://` URL for images committed to the session. */
     readonly path: string;
     readonly kind: ImageAttachmentSourceKind;
 }
@@ -21,6 +22,6 @@ export type SourceTaggedImage = ImageContent & {
 };
 /** Create a model-ready image tagged with the local file it was loaded from. */
 export declare function tagImageAttachmentSource(image: ImageContent, path: string, kind: ImageAttachmentSourceKind): SourceTaggedImage;
-/** Return the original local source of an image attachment, or undefined for payloads with no source file (clipboard bitmaps). */
+/** Return the local file backing an image attachment, or undefined for payloads with no file on disk. */
 export declare function imageAttachmentSource(image: ImageContent): ImageAttachmentSource | undefined;
 export {};

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

@@ -96,6 +96,8 @@ export declare const TRUNCATE_LENGTHS: {
 };
 /** Human-readable key currently bound to tool-output expansion, e.g. `Ctrl+O`. */
 export declare function expandKeyHint(): string;
+/** Keep both ends of a single-line label without splitting wide characters. */
+export declare function truncateMiddleToWidth(text: string, maxWidth: number): string;
 /** Select a leading line window and count the lines hidden after it. */
 export declare function cappedHeadLines(lines: readonly string[], max: number): {
     lines: readonly string[];

package/dist/types/status-line/context-usage.d.ts

@@ -7,7 +7,7 @@ interface ContextSkill {
     readonly description?: string;
     readonly hide?: boolean;
 }
-type ContextTool = Pick<AiTool, "name" | "description" | "parameters">;
+type ContextTool = Pick<AiTool, "name" | "description" | "parameters" | "examples">;
 /** Savings computed by the host's inline-image planner, not by the renderer. */
 export interface ContextSavingsEstimate {
     visionCapable: boolean;
@@ -100,6 +100,8 @@ export interface NonMessageTokenSource {
         };
     };
     readonly skills?: readonly ContextSkill[];
+    /** Provider-facing, session-frozen descriptions when available. */
+    readonly renderedSkills?: readonly ContextSkill[];
 }
 /** Shared empty system-prompt part list, avoiding an allocation per render. */
 export declare const EMPTY_STRING_PARTS: string[];

package/dist/types/theme/mermaid-cache.d.ts

@@ -6,12 +6,10 @@ import type { MermaidRenderOptions } from "@oh-my-pi/pi-natives";
  */
 export interface MermaidResolveOptions extends MermaidRenderOptions {
     /**
-     * Maximum display width (terminal columns) the diagram should occupy. A
-     * layout that overflows this width is re-rendered in the perpendicular
-     * orientation — a wide horizontal chain collapses to a tall vertical column
-     * (which the terminal can scroll), and a wide vertical fan-out collapses to a
-     * tall horizontal column. Omit to keep the source's own layout regardless of
-     * width.
+     * Maximum display width (terminal columns) the diagram should occupy.
+     * Flowcharts are also rendered top-down and left-to-right. A resize picks
+     * the shortest variant that fits; if none fit, the narrowest, which the
+     * caller may still clip. Omit to keep the source's own layout.
      */
     maxWidth?: number;
 }

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

@@ -19,6 +19,13 @@ export interface BashToolDetails {
     timedOut?: boolean;
     /** Live ACP update only; completed results refer to released terminals. */
     terminalId?: string;
+    service?: {
+        name: string;
+        state: string;
+        ready: boolean;
+        timedOut: boolean;
+        pid?: number;
+    };
     async?: {
         state: "running" | "completed" | "failed";
         jobId: string;

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

@@ -0,0 +1,46 @@
+/** Launch-broker daemon types shared by services, `proc://`, and `omp ps`. */
+/** Stable lifecycle states exposed by the launch broker. */
+export type DaemonState = "starting" | "running" | "ready" | "restarting" | "stopping" | "exited" | "failed";
+/** Restart behavior applied after an unexpected daemon exit. */
+export type DaemonRestartPolicy = "no" | "on-failure" | "always";
+/** Readiness conditions; every configured condition must pass. */
+export interface DaemonReadySpec {
+    log?: string;
+    port?: number;
+    host?: string;
+    timeoutMs: number;
+}
+/** Immutable launch specification retained for restart and inspection. */
+export interface DaemonSpec {
+    name: string;
+    application: string;
+    args: string[];
+    env: Record<string, string>;
+    cwd: string;
+    pty: boolean;
+    ready?: DaemonReadySpec;
+    restart: DaemonRestartPolicy;
+    persist: boolean;
+    detached: boolean;
+}
+/** Serializable daemon state visible to every client in one broker scope. */
+export interface DaemonSnapshot {
+    name: string;
+    id: string;
+    state: DaemonState;
+    pid?: number;
+    createdAt: number;
+    startedAt: number;
+    readyAt?: number;
+    exitedAt?: number;
+    exitCode?: number;
+    exitReason?: string;
+    restartCount: number;
+    outputBytes: number;
+    owner?: string;
+    readyMatch?: string;
+    /** Readiness conditions still unmet while `state` is `starting`; absent once ready or without a ready spec. */
+    readyPending?: ("log" | "port")[];
+    persist: boolean;
+    detached: boolean;
+}

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

@@ -0,0 +1,30 @@
+/** Peer-message types and roster constants shared by messaging, `wait`, and child prompts. */
+/** Maximum live peer rows embedded in child prompts. */
+export declare const DEFAULT_PEER_ROSTER_LIMIT = 32;
+/** Serializable peer message retained in coordination result snapshots. */
+export interface IrcMessage {
+    id: string;
+    /** Sender agent id. */
+    from: string;
+    /** Recipient agent id (resolved; "all" is expanded by the tool, not stored). */
+    to: string;
+    body: string;
+    ts: number;
+    /** Message id being answered. */
+    replyTo?: string;
+    /**
+     * Automated wake-turn relay of a woken subagent's stop output (task executor
+     * `relayWakeTurnOutput`). Relays are answers, never wake sources: the
+     * recipient's own wake-turn relay must skip them or two idle peers
+     * ping-pong forever.
+     */
+    wakeRelay?: boolean;
+}
+/** Delivery outcome for one peer recipient. */
+export interface IrcDeliveryReceipt {
+    to: string;
+    outcome: "injected" | "woken" | "revived" | "failed";
+    error?: string;
+}
+/** Status ordering for peer rosters in child prompts. */
+export declare const LIST_STATUS_ORDER: Record<string, number>;

package/dist/types/tools/line-ranges.d.ts

@@ -11,7 +11,7 @@ export declare const LINE_RANGE_CHUNK_SOURCE: string;
 /** Parse a single `N`, `N-M`, `N-`, `N+K`, or `..`-aliased (`N..M`, `N..`) chunk. Throws via {@link ToolError} on invalid bounds. */
 export declare function parseLineRangeChunk(sel: string): LineRange | null;
 /**
- * Parse a comma-separated list of line ranges (e.g. `5-16,960-973`). Returns
+ * Parse a comma-separated list of line ranges (e.g. `5-16,960-973` or `19,59`). Returns
  * the ranges in ascending order with overlapping/adjacent ranges merged so
  * downstream consumers can stream the file in a single forward pass per range.
  */

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

@@ -0,0 +1,34 @@
+import type { Component } from "../tui.js";
+import type { Theme } from "../theme/theme.js";
+import type { RenderResultOptions } from "./renderer.js";
+import type { AgentActivitySnapshot, CoordinationDetails, JobSnapshot } from "./wait.js";
+import type { DaemonSnapshot } from "./daemon.js";
+export interface ProcReadDetails {
+    jobs?: JobSnapshot[];
+    agents?: AgentActivitySnapshot[];
+    daemons?: DaemonSnapshot[];
+    job?: JobSnapshot;
+    daemon?: DaemonSnapshot;
+    log?: string;
+    terminalRows?: string[];
+}
+export type ProcWriteDetails = CoordinationDetails | {
+    action: "stop" | "stdin" | "mode";
+    daemon: DaemonSnapshot;
+    input?: string;
+    mode?: string;
+};
+/** Process operation selected by a write URL, independent of its content. */
+export type ProcWriteAction = "stdin" | "mode" | "kill";
+interface ToolResult {
+    content: Array<{
+        type: string;
+        text?: string;
+    }>;
+    isError?: boolean;
+}
+export declare function renderAgentWrite(to: string, body: string, result: ToolResult | undefined, details: CoordinationDetails | undefined, options: RenderResultOptions, theme: Theme): Component;
+/** Render live and completed process writes with the URL-selected operation. */
+export declare function renderProcWrite(id: string, action: ProcWriteAction, content: string | undefined, result: ToolResult | undefined, details: ProcWriteDetails | undefined, options: RenderResultOptions, theme: Theme): Component;
+export declare function renderProcRead(id: string, result: ToolResult | undefined, details: ProcReadDetails | undefined, options: RenderResultOptions, theme: Theme): Component;
+export {};

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

@@ -1,14 +1,16 @@
 import type { SummaryResult } from "@oh-my-pi/pi-natives";
 import type { Component } from "../tui.js";
-import type { RenderResultOptions } from "./renderer.js";
+import type { RenderResultOptions, ToolActivityContext, ToolActivitySummary } from "./renderer.js";
 import type { Theme } from "../theme/theme.js";
 import type { OutputMeta } from "./output-meta.js";
 import type { TruncationResult } from "./streaming-output.js";
+import { type ProcReadDetails } from "./proc-render.js";
 /** Read result metadata retains truncation statistics, not a second copy of the body. */
 export type ReadTruncationStats = Omit<TruncationResult, "content">;
 /** Display metadata for file and URL reads. */
 export interface ReadToolDetails {
     kind?: "file" | "url";
+    proc?: ProcReadDetails;
     /** Filesystem hyperlink target resolved by the executing tool. */
     displayTarget?: string;
     truncation?: ReadTruncationStats;
@@ -96,6 +98,7 @@ export interface ReadRenderArgs {
 export declare function readSourceFsPath(details: ReadToolDetails | undefined): string | undefined;
 /** Render file, image, and URL reads in the transcript. */
 export declare const readToolRenderer: {
+    activitySummary(args: unknown, _context: ToolActivityContext): ToolActivitySummary;
     renderCall(args: ReadRenderArgs, _options: RenderResultOptions, uiTheme: Theme): Component;
     renderResult(result: {
         content: Array<{

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

@@ -237,6 +237,8 @@ export interface AgentProgress {
     resolvedThinkingLevel?: ConfiguredThinkingLevel;
     /** True when {@link resolvedModel} is the target of an active retry fallback (not the originally configured model). Lets observer-only UIs (collab guests, Agent Hub rows with no live session) flag the fallback and keep the provider. */
     resolvedModelIsFallback?: boolean;
+    /** Extension routing note (e.g. model-pools) explaining why {@link resolvedModel} was chosen. */
+    resolvedModelRoute?: string;
     /** True when a live advisor was attached to this run's session, not merely enabled in settings. */
     advisor?: boolean;
     /** Data extracted by registered subprocess tool handlers (keyed by tool name) */
@@ -313,6 +315,8 @@ export interface SingleResult {
     resolvedThinkingLevel?: ConfiguredThinkingLevel;
     /** True when {@link resolvedModel} is the target of an active retry fallback. Mirrors {@link AgentProgress.resolvedModelIsFallback} onto the settled result. */
     resolvedModelIsFallback?: boolean;
+    /** Mirrors {@link AgentProgress.resolvedModelRoute} onto the settled result. */
+    resolvedModelRoute?: string;
     /** Retains {@link AgentProgress.advisor} after the advised session is disposed. */
     advisor?: boolean;
     error?: string;