zidane 7.2.5 → 8.0.4

package/dist/tui.d.ts

@@ -1,10 +1,19 @@
-import { $l as Theme, Bu as InlineAutocompleteProvider, Bv as SkillConfig, Em as accentColor, Ep as PlanRequest, Fd as SessionMeta, Hf as ModelInfo, Id as Settings, Jv as SessionData, Ku as CompletionState, Ld as StreamEvent, Lf as ProviderAuth, Qo as ExtensionRegistry, Qu as CompletionReference, Rf as ProviderKey, U_ as SessionTurn, Uf as ModelOption, Z_ as ThinkingLevel, Zu as CompletionProvider, ac as StoredExtensionConfigItem, bf as ModelChainEntry, eu as ThemeColors, jo as ExtensionDefinition, km as ContextSegment, ko as ExtensionCustomRenderer, om as RingBufferSink, qs as ExtensionConfigCategory, us as ExtensionToolRendererEntry, v_ as JsonValue, vp as InteractionRequest, vs as LoadedExtension, x_ as McpToolSchema, y_ as McpServerConfig, ym as AgentRegistry, yp as InteractionResponse, ys as LoadedPluginRecord } from "./index-BgN1T3lk.js";
-import { Bt as Hint, Ht as hintsLength, Tt as KeyBindings, Ut as truncateTrailing, Vt as clipHintsToWidth, Y as ResolvedConfig, _ as DiscoveredMcp, f as DiscoveredPlugin, i as SessionExportFormat, k as PreferredCredentialTarget, l as EnabledAllowlistKey, lt as marginTopFor, n as computeTurnAnchors, q as ChatOptions, t as TranscriptItem, v as DiscoveryError } from "./transcript-anchors-BeudMbXx.js";
-import { H as ApprovalRequest, T as SessionHistoryMatch, V as ApprovalDecision, X as DaemonHealth, a as formatToolCall, c as splitPromptSegments, ft as isEditErrorResult, h as MarkdownSegment, ht as isVisible, i as displayNameFor, l as CatalogEntry, n as ToolDisplayMeta, o as PromptSegment, pt as isTurnHighlighted, r as ToolFormatLine, s as PromptSegmentRef, t as TOOL_DISPLAY, v as splitMarkdownCodeBlocks, xt as turnSelectionOwnership, yt as selectableTurnIds } from "./tool-formatters-DoRLnfuD.js";
+import { Bp as Settings, Bs as LoadedPluginRecord, Cy as McpToolSchema, Ed as InlineAutocompleteProvider, Fd as CompletionProvider, Gh as ProviderAuth, Gy as SessionTurn, Id as CompletionReference, Iu as Theme, Kh as ProviderKey, Lm as ModelChainEntry, Lu as ThemeColors, Oc as StoredExtensionConfigItem, Qb as SessionData, Uc as BadgeTarget, Uo as ExtensionDefinition, Vo as ExtensionCustomRenderer, Vp as StreamEvent, Vs as SessionBadgeEntry, Wb as SkillConfig, Xh as ModelInfo, Zh as ModelOption, _f as InteractionResponse, _s as ExtensionRegistry, bg as accentColor, by as JsonValue, eb as ThinkingLevel, gc as ExtensionConfigCategory, gf as InteractionRequest, gh as EnvironmentActionSummary, gp as AgentRegistry, hh as EnvironmentActionResult, ip as RingBufferSink, js as ExtensionToolRendererEntry, md as PanelFocus, wf as PlanRequest, xg as ContextSegment, xy as McpServerConfig, zp as SessionMeta, zs as LoadedExtension } from "./index-BGe1fQT7.js";
+import { $r as EnabledAllowlistKey, Ai as PreferredCredentialTarget, Ma as KeyBindings, N as SettingsCategory, Qi as ResolvedConfig, So as truncateTrailing, U as SessionExportFormat, Xi as ChatOptions, bo as clipHintsToWidth, ma as marginTopFor, n as computeTurnAnchors, pi as DiscoveredPlugin, qs as CompletionState, t as TranscriptItem, vi as DiscoveredMcp, xo as hintsLength, yi as DiscoveryError, yo as Hint } from "./index-CHABJd-L.js";
+import { Ai as DaemonHealth, G as PromptSegmentRef, J as splitPromptSegments, Ki as isEditErrorResult, Ot as splitMarkdownCodeBlocks, Si as ApprovalRequest, Tt as MarkdownSegment, W as PromptSegment, Yi as isVisible, c as ToolFormatLine, ea as selectableTurnIds, l as displayNameFor, mr as SessionHistoryMatch, na as turnSelectionOwnership, o as TOOL_DISPLAY, qi as isTurnHighlighted, s as ToolDisplayMeta, tt as CatalogEntry, u as formatToolCall, xi as ApprovalDecision } from "./turn-operations-DQX5ZZni.js";
+import { t as HostConnectionStatus } from "./connection-Dr-Js4yZ.js";
+import "./index-BVQsIKGn.js";
+import { t as IpcClient } from "./client-core-BQSyDALT.js";
 import { Buffer } from "node:buffer";
-import { ReactNode } from "react";
+import { Dispatch, ReactNode, SetStateAction } from "react";
 import { RGBA, SyntaxStyle } from "@opentui/core";
-
+//#region src/tui/host-target.d.ts
+interface RemoteHost {
+  /** `wss://` (or `ws://` on loopback). */
+  url: string;
+  token?: string;
+}
+//#endregion
 //#region src/tui/agent-picker.d.ts
 /**
  * Modal that lists the registered {@link AgentProfile}s and lets the user
@@ -17,11 +26,7 @@ import { RGBA, SyntaxStyle } from "@opentui/core";
  * Used by `App` (Ctrl+A binding) and exported for hosts that want to drive
  * agent switching from elsewhere in their own composition.
  */
-declare function AgentPickerModal({
-  agents,
-  currentAgentId,
-  onPick
-}: {
+declare function AgentPickerModal({ agents, currentAgentId, onPick }: {
   agents: AgentRegistry;
   currentAgentId: string;
   onPick: (id: string) => void;
@@ -36,9 +41,7 @@ declare function AgentPickerModal({
  * mount `<App config={resolveConfig(...)} />` themselves inside a renderer
  * they already own.
  */
-declare function App({
-  config
-}: {
+declare function App({ config }: {
   config: ResolvedConfig;
 }): import("react").ReactNode;
 //#endregion
@@ -69,14 +72,101 @@ declare function App({
  * the picker title still reads as "this is the X provider" without
  * carrying the chip pill's heavy visual weight.
  */
-declare function CompletionPopup({
-  state,
-  /** Cap on visible rows. 6 keeps the popover compact even with long catalogs. */visibleRows
-}: {
+declare function CompletionPopup({ state, visibleRows }: {
   state: CompletionState<unknown>;
   visibleRows?: number;
 }): ReactNode;
 //#endregion
+//#region src/tui/status-spinner.d.ts
+declare function Spinner({ label }: {
+  label?: string;
+}): import("react").ReactNode;
+/**
+ * Bar spinner painted in a caller-chosen color: the session-title status
+ * icon and the folded-exchange marker. Five cells wide.
+ */
+declare function StatusSpinner({ color }: {
+  color: string;
+}): import("react").ReactNode;
+//#endregion
+//#region src/tui/transcript/transcript.d.ts
+/**
+ * Transcript rows are keyed by array index on purpose.
+ *
+ * Identity keys look more correct and are worse here: the streaming tail event
+ * is a *new object* on every ~16ms drain tick (coalescing copies the accumulated
+ * text into fresh state), so keying by identity hands the hot row a new key
+ * every tick and remounts its whole `<markdown>` subtree — measured as the
+ * markdown renderable id incrementing once per tick, versus staying put with
+ * index keys.
+ *
+ * The cost of index keys is that `revealEarlierTranscriptEvents` prepends a
+ * page, shifting every index and remounting the list once. That is a rare,
+ * user-initiated action; the streaming tail is 60 times a second. Fixing both
+ * needs a stable id on `StreamEvent` itself, which is a data-model change
+ * rather than a rendering one.
+ */
+declare function Transcript({ events, settings, selectedTurnId, busy, searchQuery, searchPending, interactionPending, onLoadEarlier, onReachBottom, onSelectTurn, onOpenTurn, onOpenSessionEvent, onResume, pinSeq }: {
+  events: StreamEvent[];
+  settings: Settings;
+  /** Continue / Retry on the run that stopped early: sends `text` as a prompt. */
+  onResume?: (text: string) => void;
+  /**
+   * Bumped each time you send: the view jumps back to the bottom and follows
+   * again, so what you just sent is on screen wherever you were reading.
+   */
+  pinSeq?: number;
+  /**
+   * True while an interaction (question wizard / plan picker) owns the screen.
+   * Releases the `pageup` / `pagedown` bindings to that surface, which binds the
+   * same keys for its own scrollbox — see `onTranscriptScroll`.
+   */
+  interactionPending?: boolean;
+  /**
+   * Turn id whose events should render with the selection accent bar. `null`
+   * leaves every event unhighlighted (normal mode). Events without a turnId
+   * (synthetic markers) are never highlighted.
+   */
+  selectedTurnId?: string | null;
+  /**
+   * True while a run is streaming. Drives the inline working throbber that
+   * appears at the tail of the transcript while the assistant is preparing
+   * a reply (thinking, or otherwise busy before content/tool calls land).
+   * Matches Crush's `AssistantMessageItem.isSpinning()` semantics: the
+   * throbber hides as soon as the active turn produces visible output.
+   */
+  busy?: boolean;
+  /** Optional filter query. Rich rows render normally; matching text ranges use the search background. */
+  searchQuery?: string;
+  /** Suppress the empty-result label while async filtering is still running. */
+  searchPending?: boolean;
+  /**
+   * Reveal one older persisted-history page. Called automatically once the
+   * viewport nears the top marker; returns false when no page was loaded.
+   */
+  onLoadEarlier?: () => boolean;
+  /**
+   * Fired once each time the viewport returns to the bottom after being
+   * scrolled away — the host ends a history-reveal hold here.
+   */
+  onReachBottom?: () => void;
+  /**
+   * Mouse companion to select-turn navigation: hovering an event row
+   * moves the selection cursor to its owning turn. Only consulted while
+   * a selection exists (`selectedTurnId != null`) — i.e. select-turn or
+   * transcript-search mode — so normal reading never hijacks the cursor.
+   * The host validates the id against its navigable candidates and
+   * returns `false` for a rejected move (void/`true` = accepted) — the
+   * Transcript uses that to avoid arming its mouse-selection flag for a
+   * change that will never land.
+   */
+  onSelectTurn?: (turnId: string) => boolean | void;
+  /** Click companion — open the turn (same action as `↵` on the selection). Same return contract. */
+  onOpenTurn?: (turnId: string) => boolean | void;
+  /** Click a `session-event` row — switch to the worker session it reports on. */
+  onOpenSessionEvent?: (sessionId: string) => void;
+}): import("react").ReactNode;
+//#endregion
 //#region src/tui/components.d.ts
 /**
  * `@opentui/react` extends `React.JSX.IntrinsicElements`, so `onSubmit` on `<input>`
@@ -106,22 +196,12 @@ interface FooterUsage {
  * enough, otherwise stacks the context indicator beneath the hint row.
  * Width tiering is driven by plain-text length estimates — close enough
  * since the segments are ASCII-heavy.
+ *
+ * Memoized: AppShell re-renders on every stream drain tick, and the footer's
+ * props settle between ticks (its clocks run on its own 1s tickers).
  */
-declare function Footer({
-  hints,
-  context,
-  cost,
-  status,
-  compactionTokens,
-  compactionStartedAt,
-  retry,
-  contextKey,
-  usage,
-  usageKey,
-  daemonHealth,
-  streaming,
-  costEstimated
-}: {
+declare const Footer: import("react").MemoExoticComponent<typeof FooterView>;
+declare function FooterView({ hints, context, cost, status, compactionTokens, compactionStartedAt, retry, contextKey, usage, usageKey, daemonHealth, hostLabel, streaming, run, costEstimated }: {
   hints: Hint[];
   context: ContextUsage | null;
   /**
@@ -143,10 +223,20 @@ declare function Footer({
    * or zero tokens leaves the bare spinner.
    */
   streaming?: {
+    turnId?: string;
     outputTokens: number;
     estimated: boolean;
     elapsedMs: number;
   } | null;
+  /**
+   * The run in flight: when it started and the output its settled turns
+   * produced. With `streaming` it drives the busy readout, `1m 15s · ↓1.2k ·
+   * 41 tok/s`. `null` falls back to the streaming turn's count alone.
+   */
+  run?: {
+    startedAt: number;
+    settledOutputTokens: number;
+  } | null;
   /**
    * Active run status, surfaced as a small glyph at the right edge of
    * the hints (left) section. Replaces the spinner that used to live in
@@ -162,6 +252,7 @@ declare function Footer({
   retry?: {
     attempt: number;
     max: number;
+    source?: string;
   } | null;
   /**
    * Rough token estimate of the in-flight compaction summary. Rendered
@@ -169,7 +260,8 @@ declare function Footer({
    * the stream making progress instead of an opaque spinner. Ignored
    * unless `status === 'compacting'`.
    */
-  compactionTokens?: number | null; /** Wall-clock start of the in-flight compaction — drives the elapsed suffix. */
+  compactionTokens?: number | null;
+  /** Wall-clock start of the in-flight compaction — drives the elapsed suffix. */
   compactionStartedAt?: number | null;
   /**
    * Keybinding spec (e.g. `ctrl+shift+g`) that opens the context-usage
@@ -200,6 +292,8 @@ declare function Footer({
    * no trace of a feature that is switched off.
    */
   daemonHealth?: DaemonHealth | null;
+  /** The remote host's name beside the dot (`host: <name>`); `null` (not on a remote host) hides it. */
+  hostLabel?: string | null;
 }): ReactNode;
 /**
  * Pure renderer for a list of {@link Hint}s as colored spans —
@@ -211,9 +305,9 @@ declare function Footer({
  * prompt-box overlay wraps it with leading + trailing spaces so the
  * outermost cells punch through the border like a native title would.
  *
- * Pattern matches `renderRefSpans` below — pure function over an opaque
- * `ThemeColors`, no internal hook calls so it composes inside any
- * `<text>` regardless of where the parent grabbed its palette.
+ * Pure function over an opaque `ThemeColors`, no internal hook calls so it
+ * composes inside any `<text>` regardless of where the parent grabbed its
+ * palette.
  */
 declare function renderHintSpans(hints: readonly Hint[], COLOR: ThemeColors): ReactNode;
 /**
@@ -278,19 +372,14 @@ interface MetaSegment {
  *   />
  * </box>
  * ```
+ *
+ * Memoized for the same reason as {@link Footer}: the chat header's props
+ * hold still while a reply streams.
  */
-declare function TitleOverlay({
-  title,
-  meta,
-  titleColor,
-  bg,
-  parentWidth,
-  statusIcon,
-  statusIconCells,
-  clickKey,
-  action
-}: {
-  title: string; /** Optional right-aligned secondary segment. Dropped first when space runs out. */
+declare const TitleOverlay: import("react").MemoExoticComponent<typeof TitleOverlayView>;
+declare function TitleOverlayView({ title, meta, titleColor, bg, parentWidth, statusIcon, statusIconCells, clickKey, action }: {
+  title: string;
+  /** Optional right-aligned secondary segment. Dropped first when space runs out. */
   meta?: string | readonly MetaSegment[] | null;
   /**
    * Optional clickable glyph chip sitting just LEFT of `meta` on the border
@@ -299,7 +388,8 @@ declare function TitleOverlay({
    * `active` paints it in the brand color, hover in the accent. Counted in
    * the meta budget so it never collides with the title.
    */
-  action?: TitleOverlayAction | null; /** Defaults to `COLOR.brand`. */
+  action?: TitleOverlayAction | null;
+  /** Defaults to `COLOR.brand`. */
   titleColor?: string;
   /**
    * Background painted behind every overlay cell. MUST match the surface
@@ -324,8 +414,9 @@ declare function TitleOverlay({
    *
    * Sized as `statusIconCells` cells + one leading space when present,
    * so the title budget reserves the right number of extra columns.
-   * Pass a {@link StatusSpinner} or any other 1-cell `<span>`; `null`
-   * (the default) takes no space.
+   * Pass a 1-cell `<span>`, or a {@link StatusSpinner} with
+   * `statusIconCells={5}` (its bar is five cells); `null` (the default)
+   * takes no space.
    *
    * Render order is `title <space> icon`. The leading title slot reads
    * naturally — eye lands on the name first, then catches the activity
@@ -360,101 +451,9 @@ interface TitleOverlayAction {
   /** Optional count rendered after the glyph when > 0. */
   count?: number;
 }
-declare function Spinner({
-  label
-}: {
-  label?: string;
-}): ReactNode;
-/**
- * Glyph-only spinner painted in a caller-chosen color. Used as the
- * status icon prefixed to the chat screen's session title — a single
- * cell wide so it slots in front of the title text without disturbing
- * the existing `TITLE_OVERLAY_WRAP` budget math.
- */
-declare function StatusSpinner({
-  color
-}: {
-  color: string;
-}): ReactNode;
-/**
- * Transcript rows are keyed by array index on purpose.
- *
- * Identity keys look more correct and are worse here: the streaming tail event
- * is a *new object* on every ~16ms drain tick (coalescing copies the accumulated
- * text into fresh state), so keying by identity hands the hot row a new key
- * every tick and remounts its whole `<markdown>` subtree — measured as the
- * markdown renderable id incrementing once per tick, versus staying put with
- * index keys.
- *
- * The cost of index keys is that `revealEarlierTranscriptEvents` prepends a
- * page, shifting every index and remounting the list once. That is a rare,
- * user-initiated action; the streaming tail is 60 times a second. Fixing both
- * needs a stable id on `StreamEvent` itself, which is a data-model change
- * rather than a rendering one.
- */
-declare function Transcript({
-  events,
-  settings,
-  selectedTurnId,
-  busy,
-  searchQuery,
-  searchPending,
-  interactionPending,
-  onLoadEarlier,
-  onSelectTurn,
-  onOpenTurn,
-  onOpenSessionEvent
-}: {
-  events: StreamEvent[];
-  settings: Settings;
-  /**
-   * True while an interaction (question wizard / plan picker) owns the screen.
-   * Releases the `pageup` / `pagedown` bindings to that surface, which binds the
-   * same keys for its own scrollbox — see `onTranscriptScroll`.
-   */
-  interactionPending?: boolean;
-  /**
-   * Turn id whose events should render with the selection accent bar. `null`
-   * leaves every event unhighlighted (normal mode). Events without a turnId
-   * (synthetic markers) are never highlighted.
-   */
-  selectedTurnId?: string | null;
-  /**
-   * True while a run is streaming. Drives the inline working throbber that
-   * appears at the tail of the transcript while the assistant is preparing
-   * a reply (thinking, or otherwise busy before content/tool calls land).
-   * Matches Crush's `AssistantMessageItem.isSpinning()` semantics: the
-   * throbber hides as soon as the active turn produces visible output.
-   */
-  busy?: boolean; /** Optional filter query. Rich rows render normally; matching text ranges use the search background. */
-  searchQuery?: string; /** Suppress the empty-result label while async filtering is still running. */
-  searchPending?: boolean;
-  /**
-   * Reveal one older persisted-history page. Called automatically once the
-   * viewport nears the top marker; returns false when no page was loaded.
-   */
-  onLoadEarlier?: () => boolean;
-  /**
-   * Mouse companion to select-turn navigation: hovering an event row
-   * moves the selection cursor to its owning turn. Only consulted while
-   * a selection exists (`selectedTurnId != null`) — i.e. select-turn or
-   * transcript-search mode — so normal reading never hijacks the cursor.
-   * The host validates the id against its navigable candidates and
-   * returns `false` for a rejected move (void/`true` = accepted) — the
-   * Transcript uses that to avoid arming its mouse-selection flag for a
-   * change that will never land.
-   */
-  onSelectTurn?: (turnId: string) => boolean | void; /** Click companion — open the turn (same action as `↵` on the selection). Same return contract. */
-  onOpenTurn?: (turnId: string) => boolean | void; /** Click a `session-event` row — switch to the worker session it reports on. */
-  onOpenSessionEvent?: (sessionId: string) => void;
-}): ReactNode;
 //#endregion
 //#region src/tui/effort-picker.d.ts
-declare function EffortPickerModal({
-  current,
-  supportsAdaptive,
-  onPick
-}: {
+declare function EffortPickerModal({ current, supportsAdaptive, onPick }: {
   current: ThinkingLevel | undefined;
   supportsAdaptive: boolean;
   onPick: (effort: ThinkingLevel) => void;
@@ -482,10 +481,7 @@ declare function useExtensionRenderers(): ExtensionRenderers;
  * enabled set actually change, so transcript re-renders stay scoped to
  * real swaps.
  */
-declare function ExtensionRenderersProvider({
-  registry,
-  children
-}: {
+declare function ExtensionRenderersProvider({ registry, children }: {
   registry: ExtensionRegistry;
   children: ReactNode;
 }): ReactNode;
@@ -535,25 +531,21 @@ declare function useRowVisible(margin?: number): boolean;
  * Enabled state lives in `settings.enabledExtensions` (mirrors
  * `enabledSkills` / `enabledMcps`). Toggling OFF filters the live
  * registry immediately; toggling ON an extension that boot skipped
- * hot-reloads the registry (see "Hot-load on enable" in app.tsx), so
+ * hot-reloads the registry (see "Hot-load on enable" in `extensions/use-extension-auto-reload.ts`), so
  * its `setup()` runs and its settings appear without a restart.
  * Agent-side contributions (tools / hooks) apply on the next run.
  */
-declare function ExtensionsSettingsModal({
-  catalog,
-  inactive
-}: {
-  /** Successfully-loaded + currently-active extensions. */catalog: readonly LoadedExtension[]; /** Inactive entries — disabled-via-allowlist + load failures. */
+declare function ExtensionsSettingsModal({ catalog, inactive }: {
+  /** Successfully-loaded + currently-active extensions. */
+  catalog: readonly LoadedExtension[];
+  /** Inactive entries — disabled-via-allowlist + load failures. */
   inactive?: readonly LoadedExtension[];
 }): import("react").ReactNode;
 //#endregion
 //#region src/tui/interaction-block.d.ts
-declare function InteractionBlock({
-  request,
-  onResolve,
-  abortHint
-}: {
-  request: InteractionRequest; /** Submit the user's response to the head of the queue. */
+declare function InteractionBlock({ request, onResolve, abortHint }: {
+  request: InteractionRequest;
+  /** Submit the user's response to the head of the queue. */
   onResolve: (response: InteractionResponse) => void;
   /**
    * Display chord of the `abortRun` binding for the title hint (e.g.
@@ -571,9 +563,7 @@ declare function InteractionBlock({
  * scrollbox, no preview/collapse state. Hosts embedding these standalone
  * must mount BOTH — the picker alone shows a plan the user cannot read.
  */
-declare function PlanReviewPanel({
-  request
-}: {
+declare function PlanReviewPanel({ request }: {
   request: PlanRequest;
 }): ReactNode;
 //#endregion
@@ -582,11 +572,14 @@ declare function PlanReviewPanel({
  * MCP server picker. Hierarchical: each server is one row, and an
  * expanded server reveals one row per advertised tool. The full surface:
  *
- *     ▼ [✓] linear             stdio · npx -y mcp-remote …    (5/7) ✓ authed
- *           [✓] create_issue   Create a new Linear issue
- *           [✓] list_issues    Query issues by status / assignee
- *           [ ] update_issue   Update fields on an existing issue
- *     ▶ [✓] chrome-devtools    stdio · npx -y chrome-devtools-mcp@latest
+ *     ▶ linear  stdio · npx -y mcp-remote … (5/7) Signed in        ━━● ▼
+ *           create_issue  Create a new Linear issue                ━━●
+ *           list_issues  Query issues by status / assignee         ━━●
+ *           update_issue  Update fields on an existing issue       ●──
+ *       chrome-devtools  stdio · npx -y chrome-devtools-mcp@latest ━━● ◀
+ *
+ * `▶` marks the cursor row; the chevron after the switch says whether a
+ * server is open (`▼`) or closed (`◀`).
  *
  * Keybindings:
  *
@@ -596,8 +589,8 @@ declare function PlanReviewPanel({
  *                      back to the parent server
  *   enter / space      toggle — server toggles `enabledMcps`; tool toggles
  *                      `disabledMcpTools[serverName]`
- *   l                  login (server rows only — needs-auth / error)
- *   o                  logout (server rows only — authed / error /
+ *   l                  sign in (server rows only — needs-auth / error)
+ *   o                  sign out (server rows only — authed / error /
  *                      authorizing)
  *   r                  refresh discovery
  *   esc                close — also cancels an in-flight `authorizing`
@@ -605,10 +598,13 @@ declare function PlanReviewPanel({
  *
  * Status badge legend (server row only):
  *
- *   ✓ authed         tokens stored + bootstrap connected
- *   ! needs login    bootstrap needs OAuth, no tokens
- *   … authorizing    interactive login in flight
- *   ✗ <error>        login attempt failed
+ *   (the shared `MCP_STATUS_LABEL` words, same as the desktop app)
+ *   Signed in         tokens stored + bootstrap connected
+ *   Needs sign-in     OAuth wanted, or the server refused the connection
+ *   Signing in…       interactive sign-in in flight
+ *   Sign-in failed    the last sign-in attempt failed
+ *   Couldn't connect  failed for another reason
+ *   Key refused       refused the key in its headers
  *
  * The (N/M) chip on a server header counts ENABLED / TOTAL advertised
  * tools, drawn only when the tool catalog has loaded. Without a catalog
@@ -619,15 +615,7 @@ declare function PlanReviewPanel({
  * Errors (`DiscoveryError[]`) surface in a warn-colored preamble so a
  * broken `mcps.json` is loud rather than invisible.
  */
-declare function McpsSettingsModal({
-  catalog,
-  errors,
-  toolsByServer,
-  onLogin,
-  onLogout,
-  onCancelLogin,
-  onRefresh
-}: {
+declare function McpsSettingsModal({ catalog, errors, toolsByServer, onLogin, onLogout, onCancelLogin, onRefresh }: {
   catalog: readonly DiscoveredMcp[];
   errors?: readonly DiscoveryError[];
   /**
@@ -668,9 +656,7 @@ interface ModalApi {
   unlockEscape: () => void;
   isOpen: boolean;
 }
-declare function ModalRoot({
-  children
-}: {
+declare function ModalRoot({ children }: {
   children: ReactNode;
 }): ReactNode;
 declare function useModal(): ModalApi;
@@ -758,35 +744,19 @@ interface ModalProps {
  *
  * Uses `useTerminalDimensions()` so it reflows on `SIGWINCH` without remount.
  */
-declare function Modal({
-  title,
-  bottomTitle,
-  rightTitle,
-  onClose,
-  disableEscape,
-  children,
-  maxWidth,
-  minWidth,
-  maxHeight,
-  horizontalMargin,
-  verticalMargin,
-  fullscreen
-}: ModalProps): ReactNode;
+declare function Modal({ title, bottomTitle, rightTitle, onClose, disableEscape, children, maxWidth, minWidth, maxHeight, horizontalMargin, verticalMargin, fullscreen }: ModalProps): ReactNode;
 //#endregion
 //#region src/tui/model-options-picker.d.ts
-declare function ModelOptionsPickerModal({
-  supportsReasoning,
-  supportsAdaptive,
-  currentEffort,
-  options,
-  enabled,
-  onPickEffort,
-  onToggleOption
-}: {
-  /** Whether to render the reasoning-effort section. */supportsReasoning: boolean; /** Whether the active provider can express the `adaptive` level. */
-  supportsAdaptive: boolean; /** Currently-selected effort (for the `●` marker). */
-  currentEffort: ThinkingLevel | undefined; /** Feature options the model declares. */
-  options: readonly ModelOption[]; /** Enabled option ids. */
+declare function ModelOptionsPickerModal({ supportsReasoning, supportsAdaptive, currentEffort, options, enabled, onPickEffort, onToggleOption }: {
+  /** Whether to render the reasoning-effort section. */
+  supportsReasoning: boolean;
+  /** Whether the active provider can express the `adaptive` level. */
+  supportsAdaptive: boolean;
+  /** Currently-selected effort (for the trailing check). */
+  currentEffort: ThinkingLevel | undefined;
+  /** Feature options the model declares. */
+  options: readonly ModelOption[];
+  /** Enabled option ids. */
   enabled: Record<string, boolean> | undefined;
   onPickEffort: (effort: ThinkingLevel) => void;
   onToggleOption: (optionId: string) => void;
@@ -797,17 +767,14 @@ interface PickedModel {
   providerKey: ProviderKey;
   modelId: string;
 }
-declare function ModelPickerModal({
-  providers,
-  modelsFor,
-  current,
-  onPick,
-  chain,
-  onApplyChain
-}: {
-  /** Authed providers — the catalog is unioned across these. */providers: readonly ProviderAuth[]; /** Resolver from `ResolvedConfig.modelsFor`. */
-  modelsFor: (key: ProviderKey) => readonly ModelInfo[]; /** Currently active selection. Promoted to top of its provider section + pre-highlighted. */
-  current: PickedModel; /** Single-pick commit — ↵ picks the highlighted row. Ignored when `onApplyChain` is set. */
+declare function ModelPickerModal({ providers, modelsFor, current, onPick, chain, onApplyChain }: {
+  /** Authed providers — the catalog is unioned across these. */
+  providers: readonly ProviderAuth[];
+  /** Resolver from `ResolvedConfig.modelsFor`. */
+  modelsFor: (key: ProviderKey) => readonly ModelInfo[];
+  /** Currently active selection. Promoted to top of its provider section + pre-highlighted. */
+  current: PickedModel;
+  /** Single-pick commit — ↵ picks the highlighted row. Ignored when `onApplyChain` is set. */
   onPick?: (picked: PickedModel) => void;
   /**
    * Seed chain for the ordered multi-select (entry 0 = current primary,
@@ -824,7 +791,18 @@ declare function ModelPickerModal({
   onApplyChain?: (chain: ModelChainEntry[]) => void;
 }): import("react").ReactNode;
 //#endregion
-//#region src/tui/screens.d.ts
+//#region src/tui/auth/auth-screen.d.ts
+declare function AuthScreen({ onPick, initialConfigureKey }: {
+  onPick: (p: ProviderAuth) => void;
+  /**
+   * Open straight into a SPECIFIC provider's wizard (skip the auth list and
+   * the wizard's provider picker). Set when the user picked a provider row in
+   * Settings → Authentication to (re)configure it.
+   */
+  initialConfigureKey?: string;
+}): import("react").ReactNode;
+//#endregion
+//#region src/tui/prompt/paste.d.ts
 /**
  * Prompt-level attachment captured by the textarea's paste pipeline.
  * Lives only in the TUI layer — converted to {@link PromptPart}s at
@@ -837,165 +815,54 @@ interface Attachment {
   content: Buffer;
   mediaType: string;
 }
-declare function AuthScreen({
-  onPick,
-  initialConfigureKey
-}: {
-  onPick: (p: ProviderAuth) => void;
-  /**
-   * Open straight into a SPECIFIC provider's wizard (skip the auth list and
-   * the wizard's provider picker). Set when the user picked a provider row in
-   * Settings → Authentication to (re)configure it.
-   */
-  initialConfigureKey?: string;
-}): ReactNode;
+//#endregion
+//#region src/tui/queue/queued-messages-block.d.ts
 /**
- * Live per-session presence, structurally mirrored from `zidane/ipc`'s
- * `SessionPresence` — declared locally so this presentation module never
- * imports the IPC layer.
+ * One entry in the queued-messages preview list shown above the prompt
+ * input. Only the displayable text + the user-provided ref spans are
+ * surfaced — the `references` carry-through happens entirely in the
+ * App layer (see `messageQueueRef`); this view doesn't need to know
+ * about them.
  */
-interface SessionPresenceInfo {
-  windows: number;
-  running: boolean;
-  attention: boolean;
-}
-declare function SessionsScreen({
-  sessions,
-  currentId,
-  focusedSessionId,
-  onPick,
-  onCreate,
-  onFocusChange,
-  contentMatches,
-  contentSearching,
-  contentSearchProgress,
-  onSearchQueryChange,
-  showAllProjects,
-  scopeLabel,
-  presence,
-  showArtifacts,
-  onToggleScope,
-  currentProjectRoot,
-  mainSessionId,
-  notice
-}: {
-  sessions: SessionMeta[];
-  /**
-   * Identity of the row the parent considers focused. Drives the row
-   * cursor so the highlight follows the SESSION (not its slot) when the
-   * list reorders. `null` lands the cursor on the first session row, or
-   * on "+ new" if there are no sessions yet.
-   */
-  focusedSessionId: string | null;
-  currentId: string | null;
-  onPick: (id: string) => void;
-  onCreate: () => void;
-  /**
-   * Notified as the user navigates between rows. Receives the session id
-   * of the focused row, or `null` when "+ new" is focused (no session to
-   * act on). Parents use this to wire `openSessionDetails` against the live focus.
-   */
-  onFocusChange?: (id: string | null) => void; /** Async full-history matches keyed by session id. */
-  contentMatches?: ReadonlyMap<string, SessionHistoryMatch>;
-  contentSearching?: boolean;
-  contentSearchProgress?: {
-    done: number;
-    total: number;
-  }; /** Called whenever the local conversation-filter query changes. */
-  onSearchQueryChange?: (query: string) => void;
-  /**
-   * When `true`, render each session's project label under the title.
-   * Off by default — when the list is already filtered to one project
-   * the label would just repeat that project on every row.
-   */
-  showAllProjects?: boolean; /** `Settings.artifacts` — off hides the `N artifacts` badge on rows. */
-  showArtifacts?: boolean;
-  /**
-   * Fired on `tab` — cycles the list scope (current project / all
-   * projects / active windows). The parent owns the scope state (it
-   * drives the store query), so this is a plain notification.
-   */
-  onToggleScope?: () => void;
-  /**
-   * Scope label for the title overlay when a non-project scope is on
-   * ("all projects", "active windows"). Falls back to "all projects"
-   * when `showAllProjects` is set without a label.
-   */
-  scopeLabel?: string;
-  /**
-   * Live presence per session id (daemon mode) — drives the per-row
-   * status glyph: running, awaiting input, or attached-idle.
-   */
-  presence?: ReadonlyMap<string, SessionPresenceInfo>;
-  /**
-   * Current project root, used to label "current project" on rows that
-   * belong to it when `showAllProjects` is on. Untagged (legacy)
-   * sessions render as "untagged".
-   */
-  currentProjectRoot?: string;
+interface QueuedPreview {
+  /** Raw prompt text the user typed (no `❯` prefix). */
+  text: string;
   /**
-   * Id of the resolved "Main" orchestration session, or `null` when
-   * orchestration is off/ungated or none has been resolved yet (the
-   * `openMainSession` chord creates it lazily — this screen never fabricates
-   * a row for one that doesn't exist). When set and present in `sessions`,
-   * its row is pinned first with a `◆ Main` badge.
+   * Optional chip spans from the original prompt (`@files`, `/skills`)
+   * — passed through so the queued entry highlights skill / file names
+   * the same way the echoed user-prompt event does once it lands in
+   * the transcript.
    */
-  mainSessionId?: string | null;
+  refs?: readonly {
+    start: number;
+    end: number;
+    providerId: string;
+  }[];
   /**
-   * One-line warning under the list (e.g. "a run is in progress — abort
-   * first"). Replaces the search spinner slot while set.
+   * How many attachments were captured with the prompt. A COUNT rather than the
+   * attachments themselves: the row only needs to say they exist, and holding
+   * the payloads in a render prop would keep every queued file's bytes alive
+   * for as long as the queue is on screen.
+   *
+   * Absent or `0` renders no badge, so unattached rows look exactly as before.
    */
-  notice?: string | null;
-}): ReactNode;
-declare function ChatScreen({
-  cwd,
-  events,
-  busy,
-  compacting,
-  queuedMessages,
-  queueSelectionIndex,
-  queueShortcuts,
-  onEnterQueueFromEmptyPrompt,
-  settings,
-  onSubmit,
-  session,
-  pending,
-  onApproval,
-  pendingInteraction,
-  onInteraction,
-  completionProviders,
-  inlineAutocompleteProviders,
-  onCompletionTab,
-  enterSelectsCompletion,
-  onPopupOpenChange,
-  selectedTurnId,
-  onSelectTurn,
-  onOpenTurn,
-  onOpenSessionEvent,
-  transcriptSearchMode,
-  transcriptSearchQuery,
-  transcriptSearchEvents,
-  transcriptSearchSearching,
-  onTranscriptSearchModeChange,
-  onTranscriptSearchQueryChange,
-  onTranscriptSearchNavigate,
-  onTranscriptSearchOpen,
-  onLoadEarlierTranscript,
-  promptTriggerHints,
-  attachImageBinding,
-  editorBinding,
-  abortBinding,
-  sessionDetailsBinding,
-  frameWidth,
-  artifactsAction,
-  onDraftChange,
-  remoteDraft,
-  onDraftAttachmentsChange,
-  remoteDraftAttachments,
-  remoteSearchQuery,
-  remoteSuggest,
-  resolveGhostRemote
-}: {
+  attachments?: number;
+}
+/**
+ * Resolved keybinding specs the queue UI surfaces to the user. Each
+ * field is the literal string from `keybindings.json` ("ctrl+return",
+ * "backspace" — or whatever the user has configured) formatted for
+ * display via {@link formatBindingForDisplay} at render time so any
+ * customization (e.g. `"cmd+up"`, `"delete"`) shows the actual key.
+ */
+interface QueueShortcuts {
+  enter: string;
+  push: string;
+  drop: string;
+}
+//#endregion
+//#region src/tui/chat/chat-screen.d.ts
+interface ChatScreenProps {
   cwd: string;
   events: StreamEvent[];
   busy: boolean;
@@ -1042,9 +909,13 @@ declare function ChatScreen({
    * referenced skill before `agent.run()`), and any attachments captured
    * by the textarea's paste pipeline.
    */
-  onSubmit: (prompt: string, references: readonly CompletionReference<unknown>[], attachments: readonly Attachment[]) => void;
-  session: SessionMeta | null; /** Head of the safe-mode approval queue, or `null` when nothing is pending. */
-  pending: ApprovalRequest | null; /** Resolve the active prompt with the user's pick. */
+  onSubmit: (prompt: string, references: readonly CompletionReference<unknown>[], attachments: readonly Attachment[], opts?: {
+    fromComposer?: boolean;
+  }) => void;
+  session: SessionMeta | null;
+  /** Head of the safe-mode approval queue, or `null` when nothing is pending. */
+  pending: ApprovalRequest | null;
+  /** Resolve the active prompt with the user's pick. */
   onApproval: (decision: ApprovalDecision) => void;
   /**
    * Head of the interactions queue (plan approval / Q&A). When set,
@@ -1052,7 +923,8 @@ declare function ChatScreen({
    * mounted but hidden, preserving its draft and attachments. Works the same
    * for live and resumed interactions; the App only swaps the resolver.
    */
-  pendingInteraction: InteractionRequest | null; /** Submit the user's response to the head of the interactions queue. */
+  pendingInteraction: InteractionRequest | null;
+  /** Submit the user's response to the head of the interactions queue. */
   onInteraction: (response: InteractionResponse) => void;
   /**
    * Optional autocomplete providers. When passed, `PromptBlock` shows a
@@ -1066,21 +938,9 @@ declare function ChatScreen({
    * extension-registered). Gated by the `inlineAutocomplete` setting
    * inside `PromptBlock`; Tab accepts the visible ghost.
    */
-  inlineAutocompleteProviders?: readonly InlineAutocompleteProvider[]; /** Optional provider-specific Tab override while the completion popup is open. */
+  inlineAutocompleteProviders?: readonly InlineAutocompleteProvider[];
+  /** Optional provider-specific Tab override while the completion popup is open. */
   onCompletionTab?: (providerId: string) => boolean;
-  /**
-   * Providers whose popup keeps `↵` as the SELECT key (e.g. `chats`,
-   * whose tab is the scope toggle). Everywhere else `↵` submits the
-   * prompt and `tab` is the only select key.
-   *
-   * COUPLED with `onCompletionTab`: any provider whose tab is consumed by
-   * `onCompletionTab` (returns `true`) MUST also be claimed here, or its
-   * popup becomes unselectable — tab does something else and ↵ submits.
-   * The two are separate props (a host may want ↵-select without a tab
-   * override, e.g. a plain list), so the coupling is the caller's to
-   * honor; see `<App>` where both name `chats`.
-   */
-  enterSelectsCompletion?: (providerId: string) => boolean;
   /**
    * Notified whenever the popup opens / closes. The App uses this to gate
    * the esc-abort handler so esc dismisses the popup instead of aborting
@@ -1092,9 +952,12 @@ declare function ChatScreen({
    * filtered-result highlight while the textarea remains focused for query
    * input.
    */
-  selectedTurnId?: string | null; /** Hover-to-move-cursor while select-turn / search selection is active. `false` = move rejected. See `Transcript`. */
-  onSelectTurn?: (turnId: string) => boolean | void; /** Click-to-open a hovered turn — same action as `↵` on the selection. Same return contract. */
-  onOpenTurn?: (turnId: string) => boolean | void; /** Click a `session-event` row — switch to the worker session it reports on. */
+  selectedTurnId?: string | null;
+  /** Hover-to-move-cursor while select-turn / search selection is active. `false` = move rejected. See `Transcript`. */
+  onSelectTurn?: (turnId: string) => boolean | void;
+  /** Click-to-open a hovered turn — same action as `↵` on the selection. Same return contract. */
+  onOpenTurn?: (turnId: string) => boolean | void;
+  /** Click a `session-event` row — switch to the worker session it reports on. */
   onOpenSessionEvent?: (sessionId: string) => void;
   transcriptSearchMode?: boolean;
   transcriptSearchQuery?: string;
@@ -1103,8 +966,13 @@ declare function ChatScreen({
   onTranscriptSearchModeChange?: (enabled: boolean) => void;
   onTranscriptSearchQueryChange?: (query: string) => void;
   onTranscriptSearchNavigate?: (delta: -1 | 1) => void;
-  onTranscriptSearchOpen?: () => void; /** Reveal another persisted transcript page when the scrollbox nears top. */
+  onTranscriptSearchOpen?: () => void;
+  /** Reveal another persisted transcript page when the scrollbox nears top. */
   onLoadEarlierTranscript?: () => boolean;
+  /** The transcript viewport returned to the bottom (see Transcript `onReachBottom`). */
+  onTranscriptReachBottom?: () => void;
+  /** Whole-session prompt count for the title meta (the displayed events are capped). */
+  userMessageCount?: number;
   /**
    * Optional trigger affordances (e.g. `@ files`, `/ skills`) appended
    * to the prompt-box overlay's hint row when there's room. Caller
@@ -1112,13 +980,15 @@ declare function ChatScreen({
    * skills catalog is empty, etc.) — the prompt overlay drops the
    * triggers entirely on narrow terminals.
    */
-  promptTriggerHints?: readonly Hint[]; /** App-native text/image clipboard binding threaded into {@link PromptBlock}. */
+  promptTriggerHints?: readonly Hint[];
+  /** App-native text/image clipboard binding threaded into {@link PromptBlock}. */
   attachImageBinding?: string;
   /**
    * Resolved keybinding spec for "edit prompt in $EDITOR", threaded into
    * {@link PromptBlock}. Absent when the `externalEditor` setting is off.
    */
-  editorBinding?: string; /** Resolved `abortRun` spec, shown in the prompt's busy hint row. */
+  editorBinding?: string;
+  /** Resolved `abortRun` spec, shown in the prompt's busy hint row. */
   abortBinding?: string;
   /**
    * Resolved keybinding spec for `openSessionDetails`, rendered in the
@@ -1138,7 +1008,8 @@ declare function ChatScreen({
    * dispatches `clickKey` (the `openArtifacts` binding) to toggle the rail;
    * absent when `Settings.artifacts` is off.
    */
-  artifactsAction?: TitleOverlayAction | null; /** Draft-sync taps — see the `PromptBlock` props of the same names. */
+  artifactsAction?: TitleOverlayAction | null;
+  /** Draft-sync taps — see the `PromptBlock` props of the same names. */
   onDraftChange?: (text: string, shell?: boolean) => void;
   remoteDraft?: {
     seq: number;
@@ -1150,70 +1021,193 @@ declare function ChatScreen({
    * action (paste, drop, remove, submit-clear). Not called for
    * `remoteDraftAttachments` applies.
    */
-  onDraftAttachmentsChange?: (attachments: readonly Attachment[]) => void; /** Remote composing attachments to mirror, keyed on `seq` like `remoteDraft`. */
+  onDraftAttachmentsChange?: (attachments: readonly Attachment[]) => void;
+  /** Remote composing attachments to mirror, keyed on `seq` like `remoteDraft`. */
   remoteDraftAttachments?: {
     seq: number;
     attachments: Attachment[];
-  } | null; /** Remote search-query mirror — see the PromptBlock prop of the same name. */
+  } | null;
+  /** A badge's "Add to prompt", held until the prompt applies it. */
+  promptInsert?: {
+    seq: number;
+    text: string;
+  } | null;
+  onPromptInsertApplied?: (seq: number) => void;
+  /** Remote search-query mirror — see the PromptBlock prop of the same name. */
   remoteSearchQuery?: {
     seq: number;
     query: string;
-  } | null; /** Remote inline-suggest mirror — see the PromptBlock prop of the same name. */
+  } | null;
+  /** Remote inline-suggest mirror — see the PromptBlock prop of the same name. */
   remoteSuggest?: {
     seq: number;
     basis: string;
     caret: number;
     suggestion: string | null;
     candidates?: string[];
-  } | null; /** Daemon-side ghost resolver — see the PromptBlock prop of the same name. */
+  } | null;
+  /** Daemon-side ghost resolver — see the PromptBlock prop of the same name. */
   resolveGhostRemote?: (text: string, cursor: number) => Promise<{
     suggestion: string | null;
     candidates?: string[];
   } | null>;
-}): ReactNode;
+}
+declare function ChatScreen({ cwd, events, busy, compacting, queuedMessages, queueSelectionIndex, queueShortcuts, onEnterQueueFromEmptyPrompt, settings, onSubmit, session, pending, onApproval, pendingInteraction, onInteraction, completionProviders, inlineAutocompleteProviders, onCompletionTab, onPopupOpenChange, selectedTurnId, onSelectTurn, onOpenTurn, onOpenSessionEvent, transcriptSearchMode, transcriptSearchQuery, transcriptSearchEvents, transcriptSearchSearching, onTranscriptSearchModeChange, onTranscriptSearchQueryChange, onTranscriptSearchNavigate, onTranscriptSearchOpen, onLoadEarlierTranscript, onTranscriptReachBottom, userMessageCount: userMessageCountProp, promptTriggerHints, attachImageBinding, editorBinding, abortBinding, sessionDetailsBinding, frameWidth, artifactsAction: artifactsActionProp, onDraftChange, remoteDraft, onDraftAttachmentsChange, remoteDraftAttachments, promptInsert, onPromptInsertApplied, remoteSearchQuery, remoteSuggest, resolveGhostRemote }: ChatScreenProps): import("react").ReactNode;
+//#endregion
+//#region src/tui/sessions/session-row.d.ts
 /**
- * One entry in the queued-messages preview list shown above the prompt
- * input. Only the displayable text + the user-provided ref spans are
- * surfaced — the `references` carry-through happens entirely in the
- * App layer (see `messageQueueRef`); this view doesn't need to know
- * about them.
+ * Live per-session presence, structurally mirrored from `zidane/ipc`'s
+ * `SessionPresence` — declared locally so this presentation module never
+ * imports the IPC layer.
  */
-interface QueuedPreview {
-  /** Raw prompt text the user typed (no `❯` prefix). */
-  text: string;
+interface SessionPresenceInfo {
+  windows: number;
+  running: boolean;
+  attention: boolean;
+}
+//#endregion
+//#region src/tui/runtime/transport.d.ts
+interface HostConnectOptions {
+  appVersion?: string;
+  /** The connection dropped (daemon exit, socket error, host shutdown). Not called for `close()`. */
+  onClose?: () => void;
   /**
-   * Optional chip spans from the original prompt (`@files`, `/skills`)
-   * — passed through so the queued entry highlights skill / file names
-   * the same way the echoed user-prompt event does once it lands in
-   * the transcript.
+   * A watcher that must never retire a mismatched daemon (the presence
+   * client): it connects to whatever is running and degrades instead.
+   * Session controllers are active: a stale daemon is drained and respawned.
+   * Meaningless in-process, where client and host are one build.
    */
-  refs?: readonly {
-    start: number;
-    end: number;
-    providerId: string;
-  }[];
+  passive?: boolean;
+  /** Give up before connecting once aborted (the attempt was superseded). */
+  signal?: AbortSignal;
+}
+interface HostTransport {
+  connect: (options?: HostConnectOptions) => Promise<IpcClient>;
+}
+//#endregion
+//#region src/tui/host/host-directory.d.ts
+type DirectoryHostKind = 'in-process' | 'daemon' | 'server';
+interface DirectoryHost {
+  readonly key: string;
+  kind: DirectoryHostKind;
+  /** What the user calls it: "This computer", the saved name, or the server's. */
+  name: string;
+  /** Servers. */
+  url?: string;
+  /** `--host`: not saved, not removable. */
+  adHoc?: boolean;
+  transport: HostTransport;
+  /** The app-lifetime client; `null` while (re)connecting or offline. */
+  client: IpcClient | null;
+  status: HostConnectionStatus;
+  /** Why the last connect failed. */
+  error?: string;
+  serverName?: string;
+  serverVersion?: string;
+}
+//#endregion
+//#region src/tui/sessions/hosted-sessions.d.ts
+/** A host's header in the grouped list. */
+interface SessionHostGroup {
+  key: string;
+  name: string;
+  kind: DirectoryHost['kind'];
+  status: HostConnectionStatus;
+  /** Rows shown from the last good list (the host is not connected). */
+  stale: boolean;
+}
+//#endregion
+//#region src/tui/sessions/sessions-screen.d.ts
+interface SessionsScreenProps {
+  sessions: SessionMeta[];
   /**
-   * How many attachments were captured with the prompt. A COUNT rather than the
-   * attachments themselves: the row only needs to say they exist, and holding
-   * the payloads in a render prop would keep every queued file's bytes alive
-   * for as long as the queue is on screen.
-   *
-   * Absent or `0` renders no badge, so unattached rows look exactly as before.
+   * Identity of the row the parent considers focused. Drives the row
+   * cursor so the highlight follows the SESSION (not its slot) when the
+   * list reorders. `null` lands the cursor on the first session row, or
+   * on "+ new" if there are no sessions yet.
    */
-  attachments?: number;
-}
-/**
- * Resolved keybinding specs the queue UI surfaces to the user. Each
- * field is the literal string from `keybindings.json` ("ctrl+return",
- * "backspace" — or whatever the user has configured) formatted for
- * display via {@link formatBindingForDisplay} at render time so any
- * customization (e.g. `"cmd+up"`, `"delete"`) shows the actual key.
- */
-interface QueueShortcuts {
-  enter: string;
-  push: string;
-  drop: string;
+  focusedSessionId: string | null;
+  currentId: string | null;
+  onPick: (id: string) => void;
+  onCreate: () => void;
+  /**
+   * Notified as the user navigates between rows. Receives the session id
+   * of the focused row, or `null` when "+ new" is focused (no session to
+   * act on). Parents use this to wire `openSessionDetails` against the live focus.
+   */
+  onFocusChange?: (id: string | null) => void;
+  /** Async full-history matches keyed by session id. */
+  contentMatches?: ReadonlyMap<string, SessionHistoryMatch>;
+  contentSearching?: boolean;
+  contentSearchProgress?: {
+    done: number;
+    total: number;
+  };
+  /** Called whenever the local conversation-filter query changes. */
+  onSearchQueryChange?: (query: string) => void;
+  /**
+   * When `true`, render each session's project label under the title.
+   * Off by default — when the list is already filtered to one project
+   * the label would just repeat that project on every row.
+   */
+  showAllProjects?: boolean;
+  /** `Settings.artifacts` — off hides the `N artifacts` badge and the badge line on rows. */
+  showArtifacts?: boolean;
+  /** A session's badges (commits, pull requests, extension kinds): the line under its stats. */
+  loadBadges?: (sessionId: string) => Promise<readonly SessionBadgeEntry[]>;
+  /** Ctrl-click on a badge that stands for one thing (a URL or a path). */
+  onOpenHref?: (href: string) => void;
+  /** Click on a badge: open that chat (by row id) with the rail on `panelId` (default Artifacts), focused on the badge. */
+  onOpenBadge?: (rowId: string, panelId: string | undefined, focus: PanelFocus) => void;
+  /** Right-click on a badge: its actions modal. */
+  onBadgeMenu?: (target: BadgeTarget) => void;
+  /**
+   * Fired on `tab` — cycles the list scope (current project / all
+   * projects / active windows). The parent owns the scope state (it
+   * drives the store query), so this is a plain notification.
+   */
+  onToggleScope?: () => void;
+  /**
+   * Scope label for the title overlay when a non-project scope is on
+   * ("all projects", "active windows"). Falls back to "all projects"
+   * when `showAllProjects` is set without a label.
+   */
+  scopeLabel?: string;
+  /**
+   * Live presence per session ROW id (`sessionRowId`: host + id; daemon mode) — drives the per-row
+   * status glyph: running, awaiting input, or attached-idle.
+   */
+  presence?: ReadonlyMap<string, SessionPresenceInfo>;
+  /**
+   * Current project root, used to label "current project" on rows that
+   * belong to it when `showAllProjects` is on. Untagged (legacy)
+   * sessions render as "untagged".
+   */
+  currentProjectRoot?: string;
+  /**
+   * Id of the resolved "Main" orchestration session, or `null` when
+   * orchestration is off/ungated or none has been resolved yet (the
+   * `openMainSession` chord creates it lazily — this screen never fabricates
+   * a row for one that doesn't exist). When set and present in `sessions`,
+   * its row is pinned first with a `◆ Main` badge.
+   */
+  mainSessionId?: string | null;
+  /**
+   * One-line warning under the list (e.g. "a run is in progress — abort
+   * first"). Replaces the search spinner slot while set.
+   */
+  notice?: string | null;
+  /** `ctrl+r` on a row whose environment failed — provision it again. */
+  onRetryEnvironment?: (id: string) => void;
+  /**
+   * Several hosts (remote hosts on): one header per host, This computer
+   * first. `null` / absent: one host, no headers (the list as it always was).
+   */
+  hostGroups?: readonly SessionHostGroup[] | null;
+  /** The host that listed a session (a `hostGroups` key). */
+  hostOfSession?: (id: string) => string | undefined;
 }
+declare function SessionsScreen({ sessions, currentId, focusedSessionId, onPick, onCreate, onFocusChange, contentMatches, contentSearching, contentSearchProgress, onSearchQueryChange, showAllProjects, scopeLabel, presence, showArtifacts, loadBadges, onOpenHref, onOpenBadge, onBadgeMenu, onToggleScope, currentProjectRoot, mainSessionId, notice, onRetryEnvironment, hostGroups, hostOfSession }: SessionsScreenProps): import("react").ReactNode;
 //#endregion
 //#region src/tui/session-details-modal.d.ts
 /** Result handed back by the host's export handler — drives the success footer. */
@@ -1223,7 +1217,14 @@ interface SessionExportResult {
   /** Format that was written — used to label the success banner. */
   format: SessionExportFormat;
 }
+/** The session environment's own commands (push, open PR) — see `EnvironmentAction`. */
+interface SessionEnvironmentActions {
+  list: (sessionId: string) => Promise<EnvironmentActionSummary[]>;
+  run: (sessionId: string, actionId: string) => Promise<EnvironmentActionResult>;
+}
 interface SessionDetailsModalActions {
+  /** Environment commands, run with `1`–`9`. Omit when the host can't run them. */
+  environment?: SessionEnvironmentActions;
   /** Delete the entire session from the store. Parent handles teardown / navigation. */
   onDelete: (sessionId: string) => void | Promise<void>;
   /**
@@ -1317,13 +1318,7 @@ interface SessionCompactResult {
    */
   effectiveTokens: number;
 }
-declare function SessionDetailsModal({
-  session,
-  title,
-  isCurrent,
-  actions,
-  keybindings
-}: {
+declare function SessionDetailsModal({ session, title, isCurrent, actions, keybindings }: {
   session: SessionData;
   /**
    * Display title for the session. Falls back to the first user turn's
@@ -1331,13 +1326,15 @@ declare function SessionDetailsModal({
    * title and threads it through so the modal header matches what the
    * sessions list / chat title bar are showing.
    */
-  title?: string; /** True when this is the actively-mounted session — gates the "active" tag in the header. */
+  title?: string;
+  /** True when this is the actively-mounted session — gates the "active" tag in the header. */
   isCurrent: boolean;
-  actions: SessionDetailsModalActions; /** Effective keybindings — the modal-internal letter actions resolve through this. */
+  actions: SessionDetailsModalActions;
+  /** Effective keybindings — the modal-internal letter actions resolve through this. */
   keybindings: KeyBindings;
 }): import("react").ReactNode;
 //#endregion
-//#region src/tui/settings-modal.d.ts
+//#region src/tui/settings/settings-actions.d.ts
 interface SettingsActions {
   /**
    * Generic "open the auth flow" — only used as a FALLBACK action row on the
@@ -1379,6 +1376,12 @@ interface SettingsActions {
    * Closes the modal as a side effect — the picker owns the modal slot.
    */
   onPickCompactionModel?: () => void;
+  /**
+   * Open Settings → Environments (`environments-settings.tsx`): the default
+   * environment for new sessions and each kind's options. Replaces the
+   * settings modal in the single modal slot.
+   */
+  onOpenEnvironments?: () => void;
   /**
    * Open the "Import from Claude Code" flow (sessions / MCP servers /
    * skills — see `claude-import.ts`). Hosts wire it only when a
@@ -1488,9 +1491,10 @@ interface SettingsActions {
    * panel always shows the freshest tool list. Hosts that don't
    * want the auto-refresh (no live agent yet, no MCP credentials
    * wired) can omit the action — the panel then degrades to
-   * whatever the on-disk cache last captured.
+   * whatever the on-disk cache last captured. With `name`, tests that
+   * one server only (`ctrl+t` on a server row).
    */
-  onRefreshMcpTools?: () => Promise<void> | void;
+  onRefreshMcpTools?: (name?: string) => Promise<void> | void;
   /**
    * Open an "edit extension" session rooted at `dir` (`ctrl+e` on a
    * focused extension row). The host chdir's into the dir, opens a fresh
@@ -1533,7 +1537,8 @@ interface SettingsActions {
     catalog: readonly LoadedExtension[];
     inactive: readonly LoadedExtension[];
     configCategories: Readonly<Record<string, ExtensionConfigCategory>>;
-    configItems: Readonly<Record<string, Readonly<Record<string, StoredExtensionConfigItem>>>>; /** Plugins the rebuilt registry's extensions loaded. */
+    configItems: Readonly<Record<string, Readonly<Record<string, StoredExtensionConfigItem>>>>;
+    /** Plugins the rebuilt registry's extensions loaded. */
     plugins: readonly LoadedPluginRecord[];
     /**
      * Skills the registry contributes, ALREADY filtered by
@@ -1619,27 +1624,20 @@ interface AuthenticationView {
   /** Detected providers from `detectAuth` — used to render the list with credential badges. */
   providers?: readonly ProviderAuth[];
 }
-declare function SettingsModal({
-  skillsCatalog: skillsCatalogProp,
-  mcpsCatalog: mcpsCatalogProp,
-  mcpsErrors: mcpsErrorsProp,
-  keybindings,
-  keybindingsPath,
-  extensionKeybindings,
-  extensionThemes: extensionThemesProp,
-  extensionsCatalog: extensionsCatalogProp,
-  extensionsInactive: extensionsInactiveProp,
-  pluginsCatalog,
-  pluginsFromExtensions,
-  extensionContributedSkills,
-  extensionConfigCategories: extensionConfigCategoriesProp,
-  extensionConfigItems: extensionConfigItemsProp,
-  modelCatalog,
-  logs,
-  authentication,
-  actions,
-  version
-}?: {
+//#endregion
+//#region src/tui/settings/shared.d.ts
+type TabId = 'authentication' | 'extensions' | 'instructions' | 'keybindings' | 'logs' | 'mcps' | 'skills' | PanelTabId | SettingsCategory;
+/**
+ * Tabs whose body is a self-contained panel (it owns its keys and layout)
+ * instead of a row list: the Hosts page, and a server's stand-ins for the
+ * Authentication / Skills / MCP / Extensions tabs while the Settings modal
+ * edits that server (`host-settings-scope`).
+ */
+type PanelTabId = 'hosts' | 'host-auth' | 'host-skills' | 'host-mcps' | 'host-extensions';
+//#endregion
+//#region src/tui/settings/settings-modal-props.d.ts
+/** Props of `<SettingsModal>` (see `settings-modal.tsx`). */
+interface SettingsModalProps {
   /**
    * Embedder fallback — discovered skills when no `<DiscoveryProvider>`
    * is mounted. In the in-app flow this is ignored; the modal reads
@@ -1652,8 +1650,10 @@ declare function SettingsModal({
    * modal's bottom border as `zidane v…`. Omitted → no version chip.
    */
   version?: string;
-  skillsCatalog?: readonly SkillConfig[]; /** Embedder fallback — discovered MCP servers; superseded by context when present. */
-  mcpsCatalog?: readonly DiscoveredMcp[]; /** Embedder fallback — `mcps.json` parse errors; superseded by context when present. */
+  skillsCatalog?: readonly SkillConfig[];
+  /** Embedder fallback — discovered MCP servers; superseded by context when present. */
+  mcpsCatalog?: readonly DiscoveredMcp[];
+  /** Embedder fallback — `mcps.json` parse errors; superseded by context when present. */
   mcpsErrors?: readonly DiscoveryError[];
   /**
    * Merged keybinding map. When provided, a "Keybindings" tab appears
@@ -1661,7 +1661,8 @@ declare function SettingsModal({
    * `actions.onOpenKeybindings`. The UI-tab action row for the same
    * affordance is dropped when this is set (no duplicate entry points).
    */
-  keybindings?: KeyBindings; /** Absolute path to `keybindings.json`. Surfaced on the pinned edit-file button. */
+  keybindings?: KeyBindings;
+  /** Absolute path to `keybindings.json`. Surfaced on the pinned edit-file button. */
   keybindingsPath?: string;
   /**
    * Extension-contributed keybindings, already resolved against the
@@ -1692,7 +1693,7 @@ declare function SettingsModal({
    * directly from there. Toggling OFF filters contributions live;
    * toggling ON hot-loads the extension (the host rebuilds the registry,
    * so its settings appear immediately — see "Hot-load on enable" in
-   * app.tsx). Agent-side contributions apply on the next run.
+   * `extensions/use-extension-auto-reload.ts`). Agent-side contributions apply on the next run.
    */
   extensionsCatalog?: readonly LoadedExtension[];
   /**
@@ -1760,7 +1761,30 @@ declare function SettingsModal({
    */
   authentication?: AuthenticationView;
   actions?: SettingsActions;
-}): ReactNode;
+  /** Panel tabs (`PanelTabId`): the Hosts page, a server's stand-in tabs. Absent ids are not shown. */
+  panels?: Partial<Record<PanelTabId, SettingsPanel>>;
+  /** Built-in tabs to leave out (a server's settings have no local catalogs to show). */
+  hiddenTabs?: readonly TabId[];
+  /** Replaces "settings" in the title (e.g. `settings · box`). */
+  title?: string;
+}
+/** A panel tab's body. Mounted while its tab is active; it owns its keys except ←/→ (unless it captures input). */
+interface SettingsPanel {
+  render: (props: SettingsPanelRenderProps) => ReactNode;
+}
+interface SettingsPanelRenderProps {
+  /** The modal's search text. */
+  query: string;
+  /**
+   * The panel is editing (a text field, a confirmation): every key and esc
+   * go to it, the search input lets go. `false` hands them back.
+   */
+  setCaptured: (captured: boolean) => void;
+  contentCols: number;
+}
+//#endregion
+//#region src/tui/settings-modal.d.ts
+declare function SettingsModal(props?: SettingsModalProps): import("react").ReactNode;
 //#endregion
 //#region src/tui/skills-settings.d.ts
 /**
@@ -1773,10 +1797,7 @@ declare function SettingsModal({
  * `<SettingsModal>` which exposes the same affordance via its own
  * `SettingsActions.onRefreshSkills` plumbing.
  */
-declare function SkillsSettingsModal({
-  catalog,
-  onRefresh
-}: {
+declare function SkillsSettingsModal({ catalog, onRefresh }: {
   catalog: readonly SkillConfig[];
   onRefresh?: () => Promise<void> | void;
 }): import("react").ReactNode;
@@ -1813,7 +1834,6 @@ declare function buildMdStyle(theme: Theme, overrides?: Record<string, Partial<S
  * colors (headings, bold, code) paint at full brightness and the block
  * doesn't look dim at all. Italic is preserved (it carries no color).
  */
-
 flattenFg?: RGBA): SyntaxStyle;
 /**
  * Active markdown / syntax-highlighting style. Returns a single shared
@@ -1850,23 +1870,17 @@ declare function useMdStyle(opts?: {
  * (chat layer) — a GUI shell can build its own toggle list against the
  * same hook without pulling OpenTUI.
  */
-declare function ToggleListModal<T>({
-  catalog,
-  keyOf,
-  settingKey,
-  gcKeys,
-  title,
-  renderDetail,
-  emptyState,
-  preamble,
-  onRefresh
-}: {
+declare function ToggleListModal<T>({ catalog, keyOf, settingKey, gcKeys, title, renderDetail, emptyState, preamble, onRefresh }: {
   catalog: readonly T[];
   keyOf: (entry: T) => string;
-  settingKey: EnabledAllowlistKey; /** Forwarded to `useEnabledToggleSet` — names that survive allowlist GC beyond the catalog. */
-  gcKeys?: readonly string[]; /** Modal title stem — rendered as `${title} · N / M enabled` in non-empty mode. */
-  title: string; /** Mute-colored trailing copy for each row (description, transport, …). */
-  renderDetail?: (entry: T) => ReactNode; /** What to render when `catalog` is empty (hint about where to drop config). */
+  settingKey: EnabledAllowlistKey;
+  /** Forwarded to `useEnabledToggleSet` — names that survive allowlist GC beyond the catalog. */
+  gcKeys?: readonly string[];
+  /** Modal title stem — rendered as `${title} · N / M enabled` in non-empty mode. */
+  title: string;
+  /** Mute-colored trailing copy for each row (description, transport, …). */
+  renderDetail?: (entry: T) => ReactNode;
+  /** What to render when `catalog` is empty (hint about where to drop config). */
   emptyState: ReactNode;
   /**
    * Optional content rendered ABOVE the list (or the empty state). Used to
@@ -1893,21 +1907,18 @@ interface TurnDetailsModalActions {
   /** Edit the text content of this turn. */
   onEdit: (turnId: string, newText: string) => void;
 }
-declare function TurnDetailsModal({
-  turn,
-  toolResultTurns,
-  searchQuery,
-  index,
-  total,
-  actions,
-  keybindings
-}: {
-  turn: SessionTurn; /** Tool-result turns owned by tool calls in `turn`. */
-  toolResultTurns?: SessionTurn[]; /** Active conversation-search query used to highlight preview matches. */
-  searchQuery?: string; /** 1-based position of this turn in the session, for the header. */
-  index: number; /** Total turn count, for the `n / N` header. */
+declare function TurnDetailsModal({ turn, toolResultTurns, searchQuery, index, total, actions, keybindings }: {
+  turn: SessionTurn;
+  /** Tool-result turns owned by tool calls in `turn`. */
+  toolResultTurns?: SessionTurn[];
+  /** Active conversation-search query used to highlight preview matches. */
+  searchQuery?: string;
+  /** 1-based position of this turn in the session, for the header. */
+  index: number;
+  /** Total turn count, for the `n / N` header. */
   total: number;
-  actions: TurnDetailsModalActions; /** Effective keybindings — the modal-internal letter actions resolve through this. */
+  actions: TurnDetailsModalActions;
+  /** Effective keybindings — the modal-internal letter actions resolve through this. */
   keybindings: KeyBindings;
 }): import("react").ReactNode;
 //#endregion
@@ -1938,6 +1949,12 @@ interface RunTuiOptions extends Partial<ChatOptions> {
    * while disabled disk extensions are never imported at all.
    */
   extensions?: readonly ExtensionDefinition[];
+  /**
+   * Run every session on this remote zidane-server instead of a local host
+   * (`zidane --host <wss-url> --token <t>`): the whole window, multi-process
+   * semantics. Ignored under `ZIDANE_NO_REMOTE=1` (see `./host-target`).
+   */
+  remoteHost?: RemoteHost;
 }
 /**
  * Boot a full chat TUI with sensible defaults. **Does not return** under