@prometheus-ai/agent 0.5.3 → 0.5.8

package/dist/types/modes/session-observer-registry.d.ts

@@ -8,6 +8,15 @@ export interface ObservableSession {
     description?: string;
     status: "active" | "completed" | "failed" | "aborted";
     sessionFile?: string;
+    parentToolCallId?: string;
+    /**
+     * Spawn runs as a detached background job (parent turn not blocked on it).
+     * The anchored subagent HUD only lists detached spawns: sync task spawns
+     * and eval `agent()` spawns are already rendered live by their own inline
+     * tool block / eval cell.
+     */
+    detached?: boolean;
+    index?: number;
     lastUpdate: number;
     /** Latest progress snapshot from the subagent executor */
     progress?: AgentProgress;

package/dist/types/modes/setup-version.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Setup version the wizard advances a fresh install to. Bump it whenever a new
+ * setup scene lands (or an existing scene raises its `minVersion`).
+ *
+ * Kept in its own dependency-free module so the cold-launch gate in `main.ts`
+ * can answer "is the stored setup version stale?" without statically importing
+ * the full wizard — every scene (sign-in/OAuth, web search, theme previews) plus
+ * the overlay component and their TUI deps. MUST equal `max(scene.minVersion)`
+ * across `ALL_SCENES`; the `setup-wizard` barrel and test suite guard it.
+ */
+export declare const CURRENT_SETUP_VERSION = 1;

package/dist/types/modes/setup-wizard/index.d.ts

@@ -1,9 +1,10 @@
 import type { Settings } from "../../config/settings";
+import { CURRENT_SETUP_VERSION } from "../setup-version";
 import type { InteractiveModeContext } from "../types";
 import type { SetupScene } from "./scenes/types";
 export type { SetupScene, SetupSceneController, SetupSceneHost, SetupSceneResult } from "./scenes/types";
+export { CURRENT_SETUP_VERSION };
 export declare const ALL_SCENES: readonly [SetupScene, SetupScene, SetupScene];
-export declare const CURRENT_SETUP_VERSION: number;
 export interface SetupSceneSelectionOptions {
     resuming?: boolean;
     isTTY?: boolean;
@@ -13,4 +14,8 @@ export interface SetupSceneSelectionOptions {
 }
 export declare function selectSetupScenes(storedVersion: number, scenes: readonly SetupScene[], ctx?: InteractiveModeContext, options?: SetupSceneSelectionOptions): Promise<SetupScene[]>;
 export declare function markSetupWizardComplete(settings: Settings, version?: number): Promise<void>;
-export declare function runSetupWizard(ctx: InteractiveModeContext, scenes?: readonly SetupScene[]): Promise<void>;
+export interface RunSetupWizardOptions {
+    markComplete?: boolean;
+    playWelcomeIntro?: boolean;
+}
+export declare function runSetupWizard(ctx: InteractiveModeContext, scenes?: readonly SetupScene[], options?: RunSetupWizardOptions): Promise<void>;

package/dist/types/modes/setup-wizard/lazy.d.ts

@@ -0,0 +1,2 @@
+import type { InteractiveModeContext } from "../types";
+export declare function runProviderSetupWizard(ctx: InteractiveModeContext): Promise<void>;

package/dist/types/modes/setup-wizard/scenes/sign-in.d.ts

@@ -1,3 +1,4 @@
+import { type SgrMouseEvent } from "@prometheus-ai/tui";
 import type { SetupSceneHost, SetupTab } from "./types";
 /**
  * "Sign in" panel: lets the user authenticate one or more model providers via
@@ -15,5 +16,7 @@ export declare class SignInTab implements SetupTab {
     dispose(): void;
     invalidate(): void;
     handleInput(data: string): void;
-    render(width: number): string[];
+    /** Forward mouse to the provider selector; pointer is inert during an active login or code prompt. */
+    routeMouse(event: SgrMouseEvent, line: number, col: number): void;
+    render(width: number): readonly string[];
 }

package/dist/types/modes/setup-wizard/scenes/types.d.ts

@@ -1,4 +1,4 @@
-import type { Component } from "@prometheus-ai/tui";
+import type { Component, SgrMouseEvent } from "@prometheus-ai/tui";
 import type { InteractiveModeContext } from "../../types";
 export type SetupSceneResult = "done" | "skipped";
 export interface SetupSceneHost {
@@ -14,6 +14,13 @@ export interface SetupSceneController extends Component {
     onMount?(): void | Promise<void>;
     onUnmount?(): void;
     dispose?(): void;
+    /**
+     * Route an SGR mouse report (tracking is on while the wizard holds the
+     * alternate screen). `line`/`col` are 0-based within this controller's
+     * last rendered output. When absent, the wizard falls back to synthesizing
+     * arrow keys from wheel notches.
+     */
+    routeMouse?(event: SgrMouseEvent, line: number, col: number): void;
 }
 /**
  * A single panel inside a tabbed setup scene. The host scene owns the tab bar
@@ -27,11 +34,13 @@ export interface SetupTab {
      * login). The parent scene MUST NOT switch tabs or finish while modal.
      */
     readonly modal: boolean;
-    render(width: number): string[];
+    render(width: number): readonly string[];
     handleInput(data: string): void;
     invalidate(): void;
     /** Called when the tab becomes active (including initial mount). */
     onActivate?(): void;
+    /** Mouse routing at tab-local coordinates; see {@link SetupSceneController.routeMouse}. */
+    routeMouse?(event: SgrMouseEvent, line: number, col: number): void;
     dispose(): void;
 }
 export interface SetupScene {

package/dist/types/modes/setup-wizard/scenes/web-search.d.ts

@@ -1,8 +1,10 @@
+import { type SgrMouseEvent } from "@prometheus-ai/tui";
 import type { SetupSceneHost, SetupTab } from "./types";
 /**
  * "Web search" panel: picks the provider the web_search tool should prefer and
  * reports whether the highlighted provider is ready to use given current
- * credentials (env keys or OAuth sign-ins from the Sign in tab).
+ * credentials (env keys or OAuth sign-ins from the Sign in tab) or an
+ * unauthenticated fallback.
  */
 export declare class WebSearchTab implements SetupTab {
     #private;
@@ -13,7 +15,9 @@ export declare class WebSearchTab implements SetupTab {
     constructor(host: SetupSceneHost);
     onActivate(): void;
     handleInput(data: string): void;
+    /** Wheel moves the highlight; hover lights the row under the pointer; click confirms it. */
+    routeMouse(event: SgrMouseEvent, line: number, _col: number): void;
     invalidate(): void;
     dispose(): void;
-    render(width: number): string[];
+    render(width: number): readonly string[];
 }

package/dist/types/modes/setup-wizard/wizard-overlay.d.ts

@@ -10,5 +10,5 @@ export declare class SetupWizardComponent implements Component {
     dispose(): void;
     invalidate(): void;
     handleInput(data: string): void;
-    render(width: number): string[];
+    render(width: number): readonly string[];
 }

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

@@ -1,12 +1,12 @@
 import type { ThinkingLevel } from "@prometheus-ai/agent-core";
 import type { Effort } from "@prometheus-ai/ai";
-import type { EditorTheme, MarkdownTheme, SelectListTheme, SymbolTheme } from "@prometheus-ai/tui";
+import type { EditorTheme, MarkdownTheme, SelectListTheme, SettingsListTheme, SymbolTheme } from "@prometheus-ai/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" | "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.scratchFolder" | "icon.file" | "icon.git" | "icon.branch" | "icon.pr" | "icon.tokens" | "icon.context" | "icon.cost" | "icon.time" | "icon.prometheus" | "icon.agents" | "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" | "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" | "tab.channels";
+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.prometheus" | "icon.ghost" | "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;
@@ -80,6 +100,7 @@ export declare class Theme {
         running: string;
         shadowed: string;
         aborted: string;
+        done: string;
     };
     get nav(): {
         cursor: string;
@@ -147,8 +168,10 @@ export declare class Theme {
         context: string;
         cost: string;
         time: string;
-        prometheus: string;
+        pi: string;
+        ghost: string;
         agents: string;
+        job: string;
         cache: string;
         input: string;
         output: string;
@@ -169,6 +192,7 @@ export declare class Theme {
         extensionContextFile: string;
         extensionInstruction: string;
         mic: string;
+        camera: string;
     };
     get thinking(): {
         minimal: string;
@@ -222,6 +246,8 @@ export declare function getThemeByName(name: string): Promise<Theme | undefined>
 export declare var theme: Theme;
 /** Get the name of the currently active theme. */
 export declare function getCurrentThemeName(): string | undefined;
+/** Returns unstyled `text` before `initTheme()` assigns the global theme; use only for early-render paths. */
+export declare function fgOrPlain(color: ThemeColor, text: string, styledText?: string): string;
 export declare function initTheme(enableWatcher?: boolean, symbolPreset?: SymbolPreset, colorBlindMode?: boolean, darkTheme?: string, lightTheme?: string): Promise<void>;
 export declare function setTheme(name: string, enableWatcher?: boolean): Promise<{
     success: boolean;
@@ -265,6 +291,14 @@ export declare function setColorBlindMode(enabled: boolean): Promise<void>;
  */
 export declare function getColorBlindMode(): boolean;
 export declare function onThemeChange(callback: () => void): void;
+/**
+ * Monotonic counter bumped on any theme-affecting change that should invalidate
+ * cached renders: theme swaps and reloads (including the invalid-theme dark
+ * fallback), theme previews, symbol-preset changes, and color-blind-mode
+ * changes — everything that routes through {@link notifyThemeChange}. Consumers
+ * key cached renders on it so the next render re-shapes their output.
+ */
+export declare function getThemeEpoch(): number;
 /**
  * Get available symbol presets.
  */
@@ -280,8 +314,9 @@ export declare function stopThemeWatcher(): void;
  */
 export declare function getResolvedThemeColors(themeName?: string): Promise<Record<string, string>>;
 /**
- * Check if a theme is a "light" theme by analyzing its background color luminance.
- * Loads theme JSON synchronously (built-in or custom file) and resolves userMessageBg.
+ * Check if a theme is a "light" theme by analyzing its status-line background
+ * luminance. Loads theme JSON synchronously (built-in or custom file on disk)
+ * for callers in synchronous flows (settings migration, setup wizard).
  */
 export declare function isLightTheme(themeName?: string): boolean;
 /**
@@ -297,9 +332,9 @@ export declare function getThemeExportColors(themeName?: string): Promise<{
  * Highlight code with syntax coloring based on file extension or language.
  * Returns array of highlighted lines.
  */
-export declare function highlightCode(code: string, lang?: string): string[];
+export declare function highlightCode(code: string, lang?: string, highlightTheme?: Theme): string[];
 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("@prometheus-ai/tui").SettingsListTheme;
+export declare function getSettingsListTheme(): SettingsListTheme;

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

@@ -2,17 +2,21 @@ import type { AgentMessage } from "@prometheus-ai/agent-core";
 import type { CompactionOutcome } from "@prometheus-ai/agent-core/compaction";
 import type { AssistantMessage, ImageContent, Message, UsageReport } from "@prometheus-ai/ai";
 import type { Component, Container, EditorTheme, Loader, Spacer, Text, TUI } from "@prometheus-ai/tui";
+import type { CollabGuestLink } from "../collab/guest";
+import type { CollabHost } from "../collab/host";
 import type { KeybindingsManager } from "../config/keybindings";
 import type { Settings } from "../config/settings";
 import type { ExtensionUIContext, ExtensionUIDialogOptions, ExtensionUISelectItem, ExtensionWidgetContent, ExtensionWidgetOptions } from "../extensibility/extensions";
 import type { CompactOptions } from "../extensibility/extensions/types";
 import type { MCPManager } from "../mcp";
 import type { PlanApprovalDetails } from "../plan-mode/approved-plan";
-import type { AgentSession, AgentSessionEvent } from "../session/agent-session";
+import type { AgentSession } from "../session/agent-session";
 import type { HistoryStorage } from "../session/history-storage";
-import type { SessionContext, SessionManager } from "../session/session-manager";
+import type { SessionContext } from "../session/session-context";
+import type { SessionManager } from "../session/session-manager";
 import type { ShakeMode } from "../session/shake-types";
 import type { LspStartupServerInfo } from "../tools";
+import type { EventBus } from "../utils/event-bus";
 import type { AssistantMessageComponent } from "./components/assistant-message";
 import type { BashExecutionComponent } from "./components/bash-execution";
 import type { CustomEditor } from "./components/custom-editor";
@@ -22,18 +26,25 @@ import type { HookInputComponent } from "./components/hook-input";
 import type { HookSelectorComponent, HookSelectorOptions } from "./components/hook-selector";
 import type { StatusLineComponent } from "./components/status-line";
 import type { ToolExecutionHandle } from "./components/tool-execution";
+import type { TranscriptContainer } from "./components/transcript-container";
+import type { EventController } from "./controllers/event-controller";
 import type { LoopLimitRuntime } from "./loop-limit";
 import type { OAuthManualInputManager } from "./oauth-manual-input";
 import type { Theme } from "./theme/theme";
 export type CompactionQueuedMessage = {
     text: string;
     mode: "steer" | "followUp";
+    images?: ImageContent[];
 };
 export type SubmittedUserInput = {
     text: string;
     images?: ImageContent[];
     imageLinks?: (string | undefined)[];
     customType?: string;
+    /** Route through `session.prompt(text, { synthetic: true })` so the text lands
+     *  as a hidden agent-authored `developer` message rather than a visible user
+     *  turn. Used by the `c`/`.` continue shortcut. */
+    synthetic?: boolean;
     display?: boolean;
     cancelled: boolean;
     started: boolean;
@@ -51,17 +62,20 @@ export type TodoPhase = {
 };
 export interface InteractiveModeInitOptions {
     suppressWelcomeIntro?: boolean;
+    clearInitialTerminalHistory?: boolean;
 }
 export type InteractiveSelectorDialogOptions = ExtensionUIDialogOptions & Pick<HookSelectorOptions, "disabledIndices">;
 export interface InteractiveModeContext {
     ui: TUI;
-    chatContainer: Container;
+    chatContainer: TranscriptContainer;
     pendingMessagesContainer: Container;
     statusContainer: Container;
     todoContainer: Container;
+    subagentContainer: Container;
     btwContainer: Container;
     omfgContainer: Container;
     errorBannerContainer: Container;
+    modelCycleContainer: Container;
     editor: CustomEditor;
     editorContainer: Container;
     hookWidgetContainerAbove: Container;
@@ -69,14 +83,30 @@ export interface InteractiveModeContext {
     statusLine: StatusLineComponent;
     session: AgentSession;
     sessionManager: SessionManager;
+    /** Session the transcript/editor/status are attached to: the focused agent's, else `session`. */
+    readonly viewSession: AgentSession;
+    /** Id of the focused agent, undefined when the main session is attached. */
+    readonly focusedAgentId: string | undefined;
+    /** Focus the main view on an agent's live session (delegates to SessionFocusController.focusAgent). */
+    focusAgentSession(id: string): Promise<void>;
+    /** Focus the focused agent's parent session, falling back to main (delegates to focusParent). */
+    focusParentSession(): Promise<void>;
+    /** Return the view to the main session (delegates to SessionFocusController.unfocus). */
+    unfocusSession(): Promise<void>;
+    /** Clear loader, status/pending containers, streaming state, and pending tools. */
+    clearTransientSessionUi(): void;
     settings: Settings;
     keybindings: KeybindingsManager;
     agent: AgentSession["agent"];
     historyStorage?: HistoryStorage;
     mcpManager?: MCPManager;
     lspServers?: LspStartupServerInfo[];
+    titleSystemPrompt?: string;
+    collabHost?: CollabHost;
+    collabGuest?: CollabGuestLink;
+    eventController: EventController;
+    eventBus?: EventBus;
     isInitialized: boolean;
-    isBackgrounded: boolean;
     isBashMode: boolean;
     toolOutputExpanded: boolean;
     todoExpanded: boolean;
@@ -102,14 +132,13 @@ export interface InteractiveModeContext {
     loadingAnimation: Loader | undefined;
     autoCompactionLoader: Loader | undefined;
     retryLoader: Loader | undefined;
-    autoCompactionEscapeHandler?: () => void;
-    retryEscapeHandler?: () => void;
     unsubscribe?: () => void;
     onInputCallback?: (input: SubmittedUserInput) => void;
     optimisticUserMessageSignature: string | undefined;
     locallySubmittedUserSignatures: Set<string>;
     lastSigintTime: number;
     lastEscapeTime: number;
+    lastLeftTapTime: number;
     shutdownRequested: boolean;
     hookSelector: HookSelectorComponent | undefined;
     hookInput: HookInputComponent | undefined;
@@ -126,12 +155,25 @@ export interface InteractiveModeContext {
     checkShutdownRequested(): Promise<void>;
     setToolUIContext(uiContext: ExtensionUIContext, hasUI: boolean): void;
     initializeHookRunner(uiContext: ExtensionUIContext, hasUI: boolean): void;
-    createBackgroundUiContext(): ExtensionUIContext;
     setEditorComponent(factory: ((tui: TUI, theme: EditorTheme, keybindings: KeybindingsManager) => CustomEditor) | undefined): void;
-    handleBackgroundEvent(event: AgentSessionEvent): Promise<void>;
+    /**
+     * Mount transcript content and repaint once. The single sink for "show this in
+     * chat": producers build and return a `Component` (or a `ChatBlock` carrying
+     * its own lifecycle) and hand it here instead of touching `chatContainer` /
+     * `ui.requestRender()` directly. `ChatBlock`s are mounted (their `onMount`
+     * runs) so their timers/subscriptions start.
+     */
+    present(content: Component | readonly Component[]): void;
+    /**
+     * Dispose every live block in the transcript (stopping timers/subscriptions)
+     * and clear it. Used before a full rebuild so animated/streaming blocks do not
+     * leak.
+     */
+    resetTranscript(): void;
     showStatus(message: string, options?: {
         dim?: boolean;
     }): void;
+    showModelCycleTrack(track: string): void;
     showError(message: string): void;
     showPinnedError(message: string): void;
     clearPinnedError(): void;
@@ -139,7 +181,7 @@ export interface InteractiveModeContext {
     showNewVersionNotification(newVersion: string): void;
     clearEditor(): void;
     updatePendingMessagesDisplay(): void;
-    queueCompactionMessage(text: string, mode: "steer" | "followUp"): void;
+    queueCompactionMessage(text: string, mode: "steer" | "followUp", images?: ImageContent[]): void;
     flushCompactionQueue(options?: {
         willRetry?: boolean;
     }): Promise<void>;
@@ -182,7 +224,7 @@ export interface InteractiveModeContext {
         updateFooter?: boolean;
         populateHistory?: boolean;
     }): void;
-    renderInitialMessages(prebuiltContext?: SessionContext, options?: {
+    renderInitialMessages(options?: {
         preserveExistingChat?: boolean;
         clearTerminalHistory?: boolean;
     }): void;
@@ -208,6 +250,7 @@ export interface InteractiveModeContext {
     handleDumpCommand(): void;
     handleDebugTranscriptCommand(): Promise<void>;
     handleClearCommand(): Promise<void>;
+    handleFreshCommand(): Promise<void>;
     handleDropCommand(): Promise<void>;
     handleForkCommand(): Promise<void>;
     handleBashCommand(command: string, excludeFromContext?: boolean): Promise<void>;
@@ -240,17 +283,21 @@ export interface InteractiveModeContext {
     handleResumeSession(sessionPath: string): Promise<void>;
     handleSessionDeleteCommand(): Promise<void>;
     showOAuthSelector(mode: "login" | "logout", providerId?: string): Promise<void>;
+    showResetUsageSelector(): Promise<void>;
+    showProviderSetup(): Promise<void>;
     showHookConfirm(title: string, message: string): Promise<boolean>;
-    showDebugSelector(): void;
-    showSessionObserver(): void;
+    showDebugSelector(): Promise<void>;
+    showAgentHub(options?: {
+        requireContent?: boolean;
+    }): void;
     resetObserverRegistry(): void;
     handleCtrlC(): void;
     handleCtrlD(): void;
     handleCtrlZ(): void;
     handleDequeue(): void;
-    handleBackgroundCommand(): void;
     handleImagePaste(): Promise<boolean>;
     handleBtwCommand(question: string): Promise<void>;
+    handleTanCommand(work: string): Promise<void>;
     hasActiveBtw(): boolean;
     handleBtwEscape(): boolean;
     handleOmfgCommand(complaint: string): Promise<void>;
@@ -265,10 +312,12 @@ export interface InteractiveModeContext {
     registerExtensionShortcuts(): void;
     handlePlanModeCommand(initialPrompt?: string): Promise<void>;
     handleGoalModeCommand(rest?: string): Promise<void>;
+    handleGuidedGoalCommand(rest?: string): Promise<void>;
     handleLoopCommand(args?: string): Promise<void>;
     disableLoopMode(): void;
     pauseLoop(): void;
     handlePlanApproval(details: PlanApprovalDetails): Promise<void>;
+    openPlanReview(): Promise<void>;
     initHooksAndCustomTools(): Promise<void>;
     emitCustomToolSessionEvent(reason: "start" | "switch" | "branch" | "tree" | "shutdown", previousSessionFile?: string): Promise<void>;
     setHookWidget(key: string, content: ExtensionWidgetContent, options?: ExtensionWidgetOptions): void;

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

@@ -1,6 +1,7 @@
 import type { Model } from "@prometheus-ai/ai";
 import type { Skill } from "../../extensibility/skills";
 import type { AgentSession } from "../../session/agent-session";
+import { type SnapcompactSavingsEstimate } from "../../session/snapcompact-inline";
 import type { Tool } from "../../tools";
 import type { theme as Theme } from "../theme/theme";
 type CategoryId = "systemPrompt" | "systemContext" | "systemTools" | "skills" | "messages";
@@ -18,6 +19,8 @@ export interface ContextBreakdown {
     usedTokens: number;
     autoCompactBufferTokens: number;
     freeTokens: number;
+    /** Estimated snapcompact wire savings; set when requested and a snapcompact.* setting is enabled. */
+    snapcompact?: SnapcompactSavingsEstimate;
 }
 export declare function estimateSkillsTokens(skills: readonly Skill[]): number;
 export declare function estimateToolSchemaTokens(tools: ReadonlyArray<Pick<Tool, "name" | "description" | "parameters">>): number;
@@ -38,7 +41,9 @@ export declare function computeNonMessageTokens(session: AgentSession): number;
  * Compute a breakdown of estimated context usage by category for the active
  * session and model.
  */
-export declare function computeContextBreakdown(session: AgentSession): ContextBreakdown;
+export declare function computeContextBreakdown(session: AgentSession, options?: {
+    snapcompactSavings?: boolean;
+}): ContextBreakdown;
 /**
  * Render a colorful context-usage panel as ANSI text. Output is a series of
  * lines pairing the grid (left) with the legend (right).

package/dist/types/modes/utils/copy-targets.d.ts

@@ -6,6 +6,17 @@ export interface CodeBlock {
     /** Block body with the trailing newline stripped. */
     code: string;
 }
+/** A blockquote block: a maximal run of `>`-prefixed lines from markdown. */
+export interface QuoteBlock {
+    /** Block body with each line's `>` marker (and one optional space) removed. */
+    text: string;
+}
+/** A drillable block within an assistant message, in document order. */
+export type MessageBlock = ({
+    kind: "code";
+} & CodeBlock) | ({
+    kind: "quote";
+} & QuoteBlock);
 /** A runnable command found in the transcript. */
 export interface LastCommand {
     kind: "bash" | "eval";
@@ -19,7 +30,7 @@ export interface LastCommand {
  * `children` to drill into.
  */
 export interface CopyTarget {
-    /** Stable identifier (e.g. "msg:1", "msg:1:code:0", "msg:1:all", "cmd:1"). */
+    /** Stable id (e.g. "msg:1", "msg:1:code:0", "msg:1:quote:0", "msg:1:all", "cmd:1"). */
     id: string;
     label: string;
     /** Dim annotation: line/block counts, language, or tool name. */
@@ -40,8 +51,17 @@ export interface CopySource {
     readonly messages: readonly AgentMessage[];
     getLastVisibleHandoffText(): string | undefined;
 }
+/**
+ * Split assistant markdown into drillable blocks — fenced code and `>`-quoted
+ * runs — in document order. Fences mask their bodies, so a `>` line inside a
+ * code block is never mistaken for a quote. An unclosed fence is treated as
+ * ordinary text, matching the fenced-block grammar.
+ */
+export declare function extractBlocks(text: string): MessageBlock[];
 /** Extract fenced code blocks from assistant markdown, in document order. */
 export declare function extractCodeBlocks(text: string): CodeBlock[];
+/** Extract `>`-quoted blocks from assistant markdown, in document order. */
+export declare function extractQuoteBlocks(text: string): QuoteBlock[];
 /** Walk the transcript backwards for the most recent bash command or eval code. */
 export declare function extractLastCommand(messages: readonly AgentMessage[]): LastCommand | undefined;
 /**

package/dist/types/modes/utils/ui-helpers.d.ts

@@ -1,8 +1,8 @@
 import type { AgentMessage } from "@prometheus-ai/agent-core";
-import type { AssistantMessage, Message } from "@prometheus-ai/ai";
+import type { AssistantMessage, ImageContent, Message } from "@prometheus-ai/ai";
 import { type Component } from "@prometheus-ai/tui";
 import type { InteractiveModeContext } from "../../modes/types";
-import type { SessionContext } from "../../session/session-manager";
+import type { SessionContext } from "../../session/session-context";
 interface RenderInitialMessagesOptions {
     preserveExistingChat?: boolean;
     clearTerminalHistory?: boolean;
@@ -36,13 +36,13 @@ export declare class UiHelpers {
         updateFooter?: boolean;
         populateHistory?: boolean;
     }): void;
-    renderInitialMessages(prebuiltContext?: SessionContext, options?: RenderInitialMessagesOptions): void;
+    renderInitialMessages(options?: RenderInitialMessagesOptions): void;
     clearEditor(): void;
     showError(errorMessage: string): void;
     showWarning(warningMessage: string): void;
     showNewVersionNotification(newVersion: string): void;
     updatePendingMessagesDisplay(): void;
-    queueCompactionMessage(text: string, mode: "steer" | "followUp"): void;
+    queueCompactionMessage(text: string, mode: "steer" | "followUp", images?: ImageContent[]): void;
     isKnownSlashCommand(text: string): boolean;
     flushCompactionQueue(options?: {
         willRetry?: boolean;

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

@@ -1,14 +1,14 @@
 import { type KeywordHighlighter } from "./gradient-highlight";
-/** Hidden system notice appended after a user message that mentions "workflow". */
+/** Hidden system notice appended after a user message that mentions "workflowz". */
 export declare const WORKFLOW_NOTICE: string;
 /**
- * Whether `text` contains the standalone keyword "workflow"/"workflows"
+ * Whether `text` contains the standalone keyword "workflowz"
  * (lowercase, whitespace-delimited) in prose — never inside a code block, inline
  * code span, or XML/HTML section.
  */
 export declare function containsWorkflow(text: string): boolean;
 /**
- * Highlight every standalone "workflow"/"workflows" in `text` for editor display
+ * Highlight every standalone "workflowz" in `text` for editor display
  * with a warm amber→green gradient (hue 30..150), visually distinct from
  * ultrathink's rainbow and orchestrate's teal→violet.
  */