@workerdeck/ui 2.15.0 → 3.1.0

package/README.md

@@ -160,7 +160,7 @@ lose by forgetting a second mount isn't one.
 - **The panel owns the session's one attach.** External chrome reads live values through
   `onVitals` and changes them through `onControls`; opening a second attach to render a status bar
   means the tool bridge may ask the wrong client.
-- **`transcriptVariant` and `transcriptDensity` ride context, not props.** A row component composed
+- **`transcriptVariant` rides context, not a prop.** A row component composed
   by hand still gets the right treatment; restyling `data-slot`s from outside is not the seam.
 - **`statusSurface: 'external'` takes the `⋯` menu's only home with it.** Combining it with
   `panelSurface: 'internal'` needs a *function* `header` to receive the menu, or those panels
@@ -173,9 +173,9 @@ lose by forgetting a second mount isn't one.
   prompts and the composer each establish their own cell, because each sits in a different part of
   the flex column. `terminalMetrics` is one prop for exactly that reason: hand two of them
   different numbers and the caret lands on a different column from the text above it.
-- **`transcriptDensity` and `transcriptFont` reach `cards` only.** A terminal has one line height
-  and is monospace by construction. Under `terminal` both are inert rather than broken - a host
-  offering them as settings should say so, or hide them (the dashboard hides them).
+- **`transcriptFont` reaches `cards` only.** A terminal has one line height
+  and is monospace by construction. Under `terminal` it is inert rather than broken - a host
+  offering it as a setting should say so, or hide it (the dashboard hides it).
 - **`unseen` is catch-up mode's whole switch.** Passing a watermark draws the boundary, fades what
   was already read and offers the "N new rows since you were last here" bar; passing `undefined`
   draws none of it. The mark is frozen at mount, so it never walks down the transcript under the
@@ -227,7 +227,8 @@ lose by forgetting a second mount isn't one.
   would be authoritative-looking and wrong. A patch whose hunks all start at 0 (an approval, where
   the edit has not happened yet) renders *without* a number column rather than a column of zeroes.
 - **Affordances cost no layout, which is what makes `false` a real option.** The hover fill is a
-  background and the copy actions are absolutely-positioned overlays one line tall, so
+  background and the action buttons are absolutely-positioned overlays one line tall, in the blank
+  line under their block, so
   `affordances={false}` changes no glyph's position - it is the pure article, not a degraded mode.
 - **Keep `monaco-editor` unreachable from `src/index.ts`.** Tree-shaking does not cover it: Vite
   resolves Monaco's worker `new URL(...)`s while *transforming* the module, before shaking, and

package/build/{SessionPanel-BVKqPs_3.d.mts → SessionPanel-BNNc8grK.d.mts}

@@ -91,17 +91,24 @@ declare function PermissionModeSelect({ mode, onModeChange, modes, canBypass, va
 type TerminalAffordances = {
   hover?: boolean;
   actions?: boolean;
+  labels?: boolean;
 };
 declare function useAffordances(): Required<TerminalAffordances>;
-declare function WithActions({ actions, children, className }: {
+type ActionPlacement = 'below' | 'inline';
+declare function WithActions({ actions, children, className, placement }: {
   actions: ReactNode;
   children: ReactNode;
   className?: string;
+  placement?: ActionPlacement;
 }): import("react").JSX.Element;
 declare function CopyAction({ text, label }: {
   text: string;
   label?: string;
 }): import("react").JSX.Element;
+declare function AgentWriteIcon({ granted, className }: {
+  granted: boolean;
+  className?: string;
+}): import("react").JSX.Element;
 //#endregion
 //#region src/components/terminal/file-link.d.ts
 type FileLinkOpener = (path: string, line?: number) => void;
@@ -115,6 +122,13 @@ declare function FileLinkProvider({ value, children }: {
 }): import("react").JSX.Element;
 declare function useFileLinks(): FileLinkHandle | undefined;
 //#endregion
+//#region src/components/agent/ApprovalPrompts.d.ts
+interface ApprovalPromptProps {
+  request: PermissionRequest;
+  onApprove: (requestId: string, updatedInput?: Record<string, unknown>) => void;
+  onDeny: (requestId: string, message?: string, interrupt?: boolean) => void;
+}
+//#endregion
 //#region src/components/agent/transcript-variant.d.ts
 type TranscriptVariant = 'cards' | 'terminal';
 declare function TranscriptVariantProvider({ value, children }: {
@@ -122,12 +136,6 @@ declare function TranscriptVariantProvider({ value, children }: {
   children: ReactNode;
 }): import("react").JSX.Element;
 declare function useTranscriptVariant(): TranscriptVariant;
-type TranscriptDensity = 'comfortable' | 'compact';
-declare function TranscriptDensityProvider({ value, children }: {
-  value: TranscriptDensity;
-  children: ReactNode;
-}): import("react").JSX.Element;
-declare function useTranscriptDensity(): TranscriptDensity;
 type TranscriptFont = 'sans' | 'mono';
 //#endregion
 //#region src/components/agent/SessionPanel.d.ts
@@ -135,11 +143,6 @@ type TerminalMetrics = {
   fontSize?: number;
   lineHeight?: number;
 };
-interface ApprovalPromptProps {
-  request: PermissionRequest;
-  onApprove: (requestId: string, updatedInput?: Record<string, unknown>) => void;
-  onDeny: (requestId: string, message?: string, interrupt?: boolean) => void;
-}
 interface SessionPanelProps {
   client: WorkerDeckClient;
   sessionId: string | undefined;
@@ -176,7 +179,6 @@ interface SessionPanelProps {
   subagents?: SubagentInfo[];
   shells?: ShellInfo[];
   stickyPrompt?: boolean;
-  transcriptDensity?: TranscriptDensity;
   transcriptFont?: TranscriptFont;
   controlsSurface?: 'internal' | 'external' | 'status';
   onControls?: (controls: SessionControls | undefined) => void;
@@ -222,7 +224,7 @@ type SessionVitals = {
   itemCount: number;
   totalCostUsd: number;
 };
-declare function SessionPanel({ client, sessionId, header, panelSurface, statusSurface, statusPlacement, onOpenPanel, onVitals, transcriptVariant, transcriptDensity, transcriptFont, affordances, terminalMetrics, scrubber, bookmarks, peerMentions, onToggleBookmark, reveal, subagents, shells, openSubagent, onSubagentChange, openShell, onShellChange, stickyPrompt, controlsSurface, onControls, focusComposerOnClick, unseen, readOnly, approvalPrompts, toolHost, clientTools, cacheTranscript, emptyState, onLinkClick, onOpenFile, fontSize, className }: SessionPanelProps): import("react").JSX.Element;
+declare function SessionPanel({ client, sessionId, header, panelSurface, statusSurface, statusPlacement, onOpenPanel, onVitals, transcriptVariant, transcriptFont, affordances, terminalMetrics, scrubber, bookmarks, peerMentions, onToggleBookmark, reveal, subagents, shells, openSubagent, onSubagentChange, openShell, onShellChange, stickyPrompt, controlsSurface, onControls, focusComposerOnClick, unseen, readOnly, approvalPrompts, toolHost, clientTools, cacheTranscript, emptyState, onLinkClick, onOpenFile, fontSize, className }: SessionPanelProps): import("react").JSX.Element;
 //#endregion
-export { ClientCommand as A, PERMISSION_MODES as C, PermissionModeSelectProps as D, PermissionModeSelect as E, rankPeerSessions as F, skillPrompt as I, matchClientCommand as M, mergeComposerRows as N, permissionModeChoices as O, rankComposerRows as P, useAffordances as S, PermissionModeMeta as T, FileLinkProvider as _, SessionSurfacePanel as a, TerminalAffordances as b, TranscriptDensity as c, TranscriptVariant as d, TranscriptVariantProvider as f, FileLinkOpener as g, FileLinkHandle as h, SessionPanelProps as i, ComposerRow as j, permissionModeMeta as k, TranscriptDensityProvider as l, useTranscriptVariant as m, SessionControls as n, SessionVitals as o, useTranscriptDensity as p, SessionPanel as r, TerminalMetrics as s, ApprovalPromptProps as t, TranscriptFont as u, useFileLinks as v, PermissionModeChoice as w, WithActions as x, CopyAction as y };
-//# sourceMappingURL=SessionPanel-BVKqPs_3.d.mts.map
+export { ComposerRow as A, PermissionModeChoice as C, permissionModeChoices as D, PermissionModeSelectProps as E, skillPrompt as F, mergeComposerRows as M, rankComposerRows as N, permissionModeMeta as O, rankPeerSessions as P, PERMISSION_MODES as S, PermissionModeSelect as T, AgentWriteIcon as _, SessionVitals as a, WithActions as b, TranscriptVariant as c, ApprovalPromptProps as d, FileLinkHandle as f, ActionPlacement as g, useFileLinks as h, SessionSurfacePanel as i, matchClientCommand as j, ClientCommand as k, TranscriptVariantProvider as l, FileLinkProvider as m, SessionPanel as n, TerminalMetrics as o, FileLinkOpener as p, SessionPanelProps as r, TranscriptFont as s, SessionControls as t, useTranscriptVariant as u, CopyAction as v, PermissionModeMeta as w, useAffordances as x, TerminalAffordances as y };
+//# sourceMappingURL=SessionPanel-BNNc8grK.d.mts.map

package/build/index.d.mts

@@ -1,5 +1,5 @@
 import { a as formatCost, c as formatRateLimitWindow, d as formatTokens, f as friendlyModel, i as formatBytes, l as formatRateLimitWindowLong, m as toolInputPreview, o as formatCountdown, p as rateLimitWindowSeconds, r as formatAgoPrecise, s as formatDuration, u as formatRelativeTime } from "./format-eS_oUry-.mjs";
-import { A as ClientCommand, C as PERMISSION_MODES, D as PermissionModeSelectProps, E as PermissionModeSelect, F as rankPeerSessions, I as skillPrompt, M as matchClientCommand, N as mergeComposerRows, O as permissionModeChoices, P as rankComposerRows, S as useAffordances, T as PermissionModeMeta, _ as FileLinkProvider, a as SessionSurfacePanel, b as TerminalAffordances, c as TranscriptDensity, d as TranscriptVariant, f as TranscriptVariantProvider, g as FileLinkOpener, h as FileLinkHandle, i as SessionPanelProps, j as ComposerRow, k as permissionModeMeta, l as TranscriptDensityProvider, m as useTranscriptVariant, n as SessionControls, o as SessionVitals, p as useTranscriptDensity, r as SessionPanel, s as TerminalMetrics, t as ApprovalPromptProps, u as TranscriptFont, v as useFileLinks, w as PermissionModeChoice, x as WithActions, y as CopyAction } from "./SessionPanel-BVKqPs_3.mjs";
+import { A as ComposerRow, C as PermissionModeChoice, D as permissionModeChoices, E as PermissionModeSelectProps, F as skillPrompt, M as mergeComposerRows, N as rankComposerRows, O as permissionModeMeta, P as rankPeerSessions, S as PERMISSION_MODES, T as PermissionModeSelect, _ as AgentWriteIcon, a as SessionVitals, b as WithActions, c as TranscriptVariant, d as ApprovalPromptProps, f as FileLinkHandle, g as ActionPlacement, h as useFileLinks, i as SessionSurfacePanel, j as matchClientCommand, k as ClientCommand, l as TranscriptVariantProvider, m as FileLinkProvider, n as SessionPanel, o as TerminalMetrics, p as FileLinkOpener, r as SessionPanelProps, s as TranscriptFont, t as SessionControls, u as useTranscriptVariant, v as CopyAction, w as PermissionModeMeta, x as useAffordances, y as TerminalAffordances } from "./SessionPanel-BNNc8grK.mjs";
 import { ButtonHTMLAttributes, FunctionComponent, HTMLAttributes, InputHTMLAttributes, ReactElement, ReactNode, Ref, RefObject, TextareaHTMLAttributes } from "react";
 import { VariantProps } from "class-variance-authority";
 import { ClassValue } from "clsx";
@@ -7,10 +7,11 @@ import { Select as Select$1 } from "@base-ui/react/select";
 import { LucideIcon } from "lucide-react";
 import { AlertDialog as AlertDialog$1 } from "@base-ui/react/alert-dialog";
 import { Menu as Menu$1 } from "@base-ui/react/menu";
+import { Popover as Popover$1 } from "@base-ui/react/popover";
 import { Dialog as Dialog$1 } from "@base-ui/react/dialog";
 import { Tooltip } from "@base-ui/react/tooltip";
 import { toast } from "sonner";
-import { ByModel, ContextReading, ContextUsage, FilePatch, ModelOption, PermissionRequest, PricingTable, ProfileEngine, ProfileSpend, ProjectIcon as ProjectIcon$1, QuestionBehavior, RateLimitInfo, SessionInfo, SessionRow, SessionStatus, SessionTask, ShellInfo, SkillInfo, SlashCommandInfo, SubagentDisplay, UsageWindowRow, ViewConfig, WorkspaceScope, parseUserQuestions } from "@workerdeck/protocol";
+import { ByModel, ContextReading, ContextUsage, FilePatch, McpServerActionRequest, McpServerStatusInfo, McpServerToolInfo, ModelOption, PermissionRequest, PricingTable, ProfileEngine, ProfileSpend, ProjectIcon as ProjectIcon$1, QuestionBehavior, RateLimitInfo, SessionInfo, SessionRow, SessionStatus, SessionTask, ShellInfo, SkillInfo, SlashCommandInfo, StepDisplay, SubagentDisplay, UsageWindowRow, ViewConfig, WorkspaceScope, parseUserQuestions } from "@workerdeck/protocol";
 import { ConnectionState, PeerSessionOption, TranscriptItem, TranscriptState, UseAttachmentsResult } from "@workerdeck/react";
 import { WorkerDeckClient } from "@workerdeck/client";
 //#region src/components/ui/Button.d.ts
@@ -50,6 +51,17 @@ declare const SelectItemText: import("react").NamedExoticComponent<Omit<import("
 declare const SelectTrigger: FunctionComponent<Select$1.Trigger.Props>;
 declare const SelectContent: FunctionComponent<Select$1.Popup.Props & Pick<Select$1.Positioner.Props, 'align' | 'alignItemWithTrigger' | 'side' | 'sideOffset'>>;
 declare const SelectItem: FunctionComponent<Select$1.Item.Props>;
+interface OptionSelectProps<T extends string> {
+  label: string;
+  value: T;
+  options: readonly {
+    value: T;
+    label: string;
+  }[];
+  onChange: (value: T) => void;
+  className?: string;
+}
+declare function OptionSelect<T extends string>({ label, value, options, onChange, className }: OptionSelectProps<T>): import("react").JSX.Element;
 //#endregion
 //#region src/components/ui/AlertDialog.d.ts
 declare const AlertDialog: typeof AlertDialog$1.Root;
@@ -68,6 +80,11 @@ declare const MenuItem: FunctionComponent<Menu$1.Item.Props & {
 }>;
 declare const MenuSeparator: FunctionComponent<Menu$1.Separator.Props>;
 //#endregion
+//#region src/components/ui/Popover.d.ts
+declare const Popover: typeof Popover$1.Root;
+declare const PopoverTrigger: Popover$1.Trigger;
+declare const PopoverContent: FunctionComponent<Popover$1.Popup.Props & Pick<Popover$1.Positioner.Props, 'align' | 'side' | 'sideOffset'>>;
+//#endregion
 //#region src/components/ui/Dialog.d.ts
 declare const Dialog: <Payload>(props: Dialog$1.Root.Props<Payload>) => import("react").JSX.Element;
 declare const DialogTrigger: Dialog$1.Trigger;
@@ -686,7 +703,6 @@ interface TranscriptProps {
   canBrowseFiles?: boolean;
   hostImage?: (path: string) => Promise<string | undefined>;
   variant?: TranscriptVariant;
-  density?: TranscriptDensity;
   fontSize?: number;
   lineHeight?: number;
   affordances?: TerminalAffordances | boolean;
@@ -712,7 +728,16 @@ interface TranscriptProps {
   emptyState?: ReactNode;
   className?: string;
 }
-declare function Transcript({ state, fileUrl, attachmentUrl, canBrowseFiles, hostImage, variant, density, fontSize, lineHeight, affordances, stickyPrompt, scrubber, bookmarks, sessionNames, replaying, catchUp, jumpToRecapRef, repinRef, reveal, frame, onOpenSubagent, emptyState, className }: TranscriptProps): import("react").JSX.Element;
+declare function Transcript({ state, fileUrl, attachmentUrl, canBrowseFiles, hostImage, variant, fontSize, lineHeight, affordances, stickyPrompt, scrubber, bookmarks, sessionNames, replaying, catchUp, jumpToRecapRef, repinRef, reveal, frame, onOpenSubagent, emptyState, className }: TranscriptProps): import("react").JSX.Element;
+interface TerminalTranscriptProps {
+  state: TranscriptState;
+  fileUrl?: (path: string) => string;
+  fontSize?: number;
+  lineHeight?: number;
+  affordances?: TerminalAffordances | boolean;
+  className?: string;
+}
+declare function TerminalTranscript(props: TerminalTranscriptProps): import("react").JSX.Element;
 //#endregion
 //#region src/components/terminal/surface.d.ts
 interface TerminalSurfaceProps extends HTMLAttributes<HTMLDivElement> {
@@ -724,19 +749,11 @@ interface TerminalSurfaceProps extends HTMLAttributes<HTMLDivElement> {
 declare function TerminalSurface({ fontSize, lineHeight, bleed, affordances, className, style, children, ...props }: TerminalSurfaceProps): import("react").JSX.Element;
 //#endregion
 //#region src/components/terminal/TerminalTranscript.d.ts
-interface TerminalTranscriptProps {
-  state: TranscriptState;
-  fileUrl?: (path: string) => string;
-  fontSize?: number;
-  lineHeight?: number;
-  affordances?: TerminalAffordances | boolean;
-  className?: string;
-}
-declare function TerminalItemView({ item, fileUrl }: {
+declare function TerminalItemView({ item, fileUrl, attachmentUrl }: {
   item: TranscriptItem;
   fileUrl?: (path: string) => string;
+  attachmentUrl?: (attachmentId: string) => string;
 }): import("react").JSX.Element | null;
-declare function TerminalTranscript({ state, fileUrl, fontSize, lineHeight, affordances, className }: TerminalTranscriptProps): import("react").JSX.Element;
 //#endregion
 //#region src/components/terminal/StatusLine.d.ts
 interface TerminalStatusLineProps {
@@ -870,13 +887,16 @@ interface LoaderProps {
 }
 declare function Loader({ label, className }: LoaderProps): import("react").JSX.Element;
 //#endregion
+//#region src/components/agent/tool-result-image.d.ts
+type HostImageLoader = (path: string) => Promise<string | undefined>;
+//#endregion
 //#region src/components/agent/ToolCallCard.d.ts
 type ToolCallItem = Extract<TranscriptItem, {
   kind: 'tool_call';
 }>;
 interface ToolCallCardProps {
   item: ToolCallItem;
-  hostImage?: (path: string) => Promise<string | undefined>;
+  hostImage?: HostImageLoader;
   className?: string;
 }
 declare function ToolCallCard({ item, hostImage, className }: ToolCallCardProps): import("react").JSX.Element;
@@ -888,6 +908,27 @@ declare function ToolTitleProvider({ value, children }: {
 }): import("react").JSX.Element;
 declare function useToolTitle(name: string): string | undefined;
 //#endregion
+//#region src/components/agent/image-viewer.d.ts
+type ViewedImage = {
+  src: string;
+  name: string;
+};
+type OpenImage = (image: ViewedImage) => void;
+declare function useOpenImage(): OpenImage | undefined;
+declare function ImageViewerProvider({ children }: {
+  children: ReactNode;
+}): import("react").JSX.Element;
+declare function ViewableImage({ image, className, children }: {
+  image: ViewedImage;
+  className?: string;
+  children: ReactNode;
+}): import("react").JSX.Element;
+declare function ImageViewer({ image, onClose, className }: {
+  image: ViewedImage;
+  onClose: () => void;
+  className?: string;
+}): import("react").JSX.Element;
+//#endregion
 //#region src/components/agent/FileCard.d.ts
 type FileDeliveredItem = Extract<TranscriptItem, {
   kind: 'file_delivered';
@@ -1000,7 +1041,12 @@ interface ContextDialogProps {
   onOpenChange: (open: boolean) => void;
   className?: string;
 }
+interface ContextPanelProps {
+  usage?: ContextUsage;
+  engine?: ProfileEngine;
+}
 declare function ContextDialog({ usage, engine, open, onOpenChange, className }: ContextDialogProps): import("react").JSX.Element;
+declare function ContextPanel({ usage, engine }: ContextPanelProps): import("react").JSX.Element;
 //#endregion
 //#region src/components/agent/UsageDialog.d.ts
 interface UsageDialogProps {
@@ -1057,7 +1103,14 @@ interface SessionInfoDialogProps {
   open: boolean;
   onOpenChange: (open: boolean) => void;
 }
+interface SessionInfoPanelProps {
+  state: TranscriptState;
+  client: WorkerDeckClient;
+  sessionId: string | undefined;
+  active?: boolean;
+}
 declare function SessionInfoDialog({ state, client, sessionId, open, onOpenChange }: SessionInfoDialogProps): import("react").JSX.Element;
+declare function SessionInfoPanel({ state, client, sessionId, active }: SessionInfoPanelProps): import("react").JSX.Element;
 //#endregion
 //#region src/components/agent/McpDialog.d.ts
 interface McpDialogProps {
@@ -1068,7 +1121,31 @@ interface McpDialogProps {
   canManageServers?: boolean;
   className?: string;
 }
+interface McpPanelModel {
+  servers: McpServerStatusInfo[] | undefined;
+  server: McpServerStatusInfo | undefined;
+  tool: McpServerToolInfo | undefined;
+  loading: boolean;
+  busyServer: string | undefined;
+  error: string | undefined;
+  title: string;
+  description: string | undefined;
+  selectServer: (name: string | undefined) => void;
+  selectTool: (name: string | undefined) => void;
+  back: (() => void) | undefined;
+  reload: () => void;
+  act: (name: string, action: McpServerActionRequest['action']) => Promise<void>;
+}
+interface McpPanelProps {
+  model: McpPanelModel;
+  canManageServers?: boolean;
+}
 declare function McpDialog({ client, sessionId, open, onOpenChange, canManageServers, className }: McpDialogProps): import("react").JSX.Element;
+declare function useMcpPanel(client: WorkerDeckClient | undefined, sessionId: string | undefined, active?: boolean): McpPanelModel;
+declare function McpPanelActions({ model }: {
+  model: McpPanelModel;
+}): import("react").JSX.Element;
+declare function McpPanel({ model, canManageServers }: McpPanelProps): import("react").JSX.Element;
 //#endregion
 //#region src/components/agent/SkillsDialog.d.ts
 interface SkillsDialogProps {
@@ -1108,6 +1185,39 @@ interface SessionListProps {
 }
 declare function SessionList({ sessions, activeId, onSelect, onDelete, emptyText, className }: SessionListProps): import("react").JSX.Element;
 //#endregion
+//#region src/components/agent/SessionItem.d.ts
+type SelectModifiers = {
+  meta: boolean;
+  ctrl: boolean;
+  alt: boolean;
+};
+interface SessionItemProps {
+  row: SessionRow;
+  active?: boolean;
+  activeStepKey?: string;
+  showGateway?: boolean;
+  showProject?: boolean;
+  projectIcons?: Record<string, string>;
+  subagents?: SubagentDisplay;
+  shells?: StepDisplay;
+  tasks?: StepDisplay;
+  onSelect?: (modifiers: SelectModifiers) => void;
+  onSelectSubagent?: (toolUseId: string) => void;
+  onSelectTask?: (task: SessionTask) => void;
+  onStopTask?: (toolUseId: string) => void;
+  onSelectShell?: (shellId: string) => void;
+  onKillShell?: (shellId: string) => void;
+  onShellAgentWrite?: (shellId: string, enabled: boolean) => void;
+  now?: number;
+  onRename?: (title: string) => void;
+  renameOn?: 'doubleClick' | 'external';
+  editing?: boolean;
+  onEditingChange?: (editing: boolean) => void;
+  actions?: ReactNode;
+  className?: string;
+}
+declare function SessionItem({ row, active, activeStepKey, showGateway, showProject, projectIcons, subagents, shells, tasks, onSelect, onSelectSubagent, onSelectTask, onStopTask, onSelectShell, onKillShell, onShellAgentWrite, now, onRename, renameOn, editing, onEditingChange, actions, className }: SessionItemProps): import("react").JSX.Element;
+//#endregion
 //#region src/components/agent/SessionStatusIcon.d.ts
 declare function SessionStatusIcon({ row, className }: {
   row: SessionRow;
@@ -1124,48 +1234,64 @@ interface SessionBrowserProps {
   activeSubagentId?: string;
   activeShellId?: string;
   now?: number;
-  onSelect?: (row: SessionRow) => void;
+  isActive?: (row: SessionRow) => boolean;
+  rowActions?: (row: SessionRow) => ReactNode;
+  gatewayCount?: number;
+  showSubset?: boolean;
+  onSelect?: (row: SessionRow, modifiers: SelectModifiers) => void;
   onDelete?: (row: SessionRow) => void;
   onRename?: (row: SessionRow, title: string) => void;
   onClearContext?: (row: SessionRow) => void;
   onSelectSubagent?: (row: SessionRow, toolUseId: string) => void;
+  onSelectTask?: (row: SessionRow, task: SessionTask) => void;
+  onStopTask?: (row: SessionRow, toolUseId: string) => void;
   onSelectShell?: (row: SessionRow, shellId: string) => void;
   onKillShell?: (row: SessionRow, shellId: string) => void;
-  emptyState?: React.ReactNode;
+  onShellAgentWrite?: (row: SessionRow, shellId: string, enabled: boolean) => void;
+  emptyState?: ReactNode;
   showControls?: boolean;
+  showSearch?: boolean;
+  autoFocusSearch?: boolean;
   projectIcons?: Record<string, string>;
   className?: string;
 }
 declare function rowShapeClass(active: boolean): string;
-declare function SessionBrowser({ rows, config, onConfigChange, scope, activeId, activeSubagentId, activeShellId, now, onSelect, onDelete, onRename, onClearContext, onSelectSubagent, onSelectShell, onKillShell, emptyState, showControls, projectIcons, className }: SessionBrowserProps): import("react").JSX.Element;
+declare function SessionBrowser({ rows, config, onConfigChange, scope, activeId, activeSubagentId, activeShellId, now, isActive, rowActions, gatewayCount, showSubset, onSelect, onDelete, onRename, onClearContext, onSelectSubagent, onSelectTask, onStopTask, onSelectShell, onKillShell, onShellAgentWrite, emptyState, showControls, showSearch, autoFocusSearch, projectIcons, className }: SessionBrowserProps): import("react").JSX.Element;
+declare function SessionSearch({ value, onChange, autoFocus, className, inputClassName }: {
+  value: string;
+  onChange: (value: string) => void;
+  autoFocus?: boolean;
+  className?: string;
+  inputClassName?: string;
+}): import("react").JSX.Element;
 //#endregion
-//#region src/components/agent/SessionItem.d.ts
-type SelectModifiers = {
-  meta: boolean;
-  ctrl: boolean;
-  alt: boolean;
-};
-interface SessionItemProps {
-  row: SessionRow;
-  active?: boolean;
-  activeStepKey?: string;
-  showGateway?: boolean;
-  showProject?: boolean;
-  projectIcons?: Record<string, string>;
-  subagents?: SubagentDisplay;
-  onSelect?: (modifiers: SelectModifiers) => void;
-  onSelectSubagent?: (toolUseId: string) => void;
-  onSelectShell?: (shellId: string) => void;
-  onKillShell?: (shellId: string) => void;
-  now?: number;
-  onRename?: (title: string) => void;
-  renameOn?: 'doubleClick' | 'external';
-  editing?: boolean;
-  onEditingChange?: (editing: boolean) => void;
-  actions?: ReactNode;
+//#region src/components/agent/SessionFilters.d.ts
+type SessionFiltersProps = {
+  config: ViewConfig;
+  onConfigChange: (config: ViewConfig) => void;
+  rows: readonly SessionRow[];
+  scope?: WorkspaceScope;
+  gateways?: readonly {
+    id: string;
+    name: string;
+  }[];
   className?: string;
-}
-declare function SessionItem({ row, active, activeStepKey, showGateway, showProject, projectIcons, subagents, onSelect, onSelectSubagent, onSelectShell, onKillShell, now, onRename, renameOn, editing, onEditingChange, actions, className }: SessionItemProps): import("react").JSX.Element;
+};
+declare const STEP_DISPLAY_OPTIONS: readonly {
+  value: StepDisplay;
+  label: string;
+}[];
+declare function SessionFilters({ config, onConfigChange, rows, scope, gateways: gatewaysProp, className }: SessionFiltersProps): import("react").JSX.Element;
+type SessionFiltersButtonProps = SessionFiltersProps & {
+  open?: boolean;
+  onOpenChange?: (open: boolean) => void;
+};
+declare function SessionFiltersButton({ open, onOpenChange, className, ...props }: SessionFiltersButtonProps): import("react").JSX.Element;
+declare function StepDisplayControl({ label, value, onChange }: {
+  label: string;
+  value: StepDisplay;
+  onChange: (value: StepDisplay) => void;
+}): import("react").JSX.Element;
 //#endregion
 //#region src/components/agent/EngineIcon.d.ts
 declare function engineMark(engine: string, model?: string): string | undefined;
@@ -1178,24 +1304,38 @@ declare function EngineIcon({ engine, model, className }: {
 }): import("react").JSX.Element;
 //#endregion
 //#region src/components/agent/SessionSteps.d.ts
-type StepKind = 'agent' | 'shell';
+type StepKind = 'agent' | 'shell' | 'task';
 type Step = {
   key: string;
   kind: StepKind;
   label: string;
   noun: string;
-  state: 'done' | 'running' | 'failed';
+  state: 'done' | 'running' | 'failed' | 'pending';
   detail?: string;
   title: string;
   onSelect: () => void;
   onKill?: () => void;
+  killLabel?: string;
+  agentWrite?: {
+    granted: boolean;
+    label: string;
+    toggle: () => void;
+  };
 };
 type ShellStepOptions = {
   now: number;
+  show?: StepDisplay;
   onSelect: (shellId: string) => void;
   onKill?: (shellId: string) => void;
+  onAgentWrite?: (shellId: string, enabled: boolean) => void;
+};
+type TaskStepOptions = {
+  show: StepDisplay;
+  live: boolean;
+  onSelect: (task: SessionTask) => void;
+  onStop?: (toolUseId: string) => void;
 };
-declare function sessionSteps(info: SessionInfo, onSelect: (toolUseId: string) => void, show?: SubagentDisplay, shells?: ShellStepOptions): Step[];
+declare function sessionSteps(info: SessionInfo, onSelect: (toolUseId: string) => void, show?: SubagentDisplay, shells?: ShellStepOptions, tasks?: TaskStepOptions): Step[];
 declare function StepRow({ step, active, onSelect }: {
   step: Step;
   active?: boolean;
@@ -1237,11 +1377,12 @@ interface ShellStripProps {
   cols?: number;
   onBack: () => void;
   onKill?: () => void;
+  onAgentWrite?: (enabled: boolean) => void;
   terminal: boolean;
   fontSize?: number;
   lineHeight?: number;
 }
-declare function ShellStrip({ shell, label, cols, onBack, onKill, terminal, fontSize, lineHeight }: ShellStripProps): import("react").JSX.Element;
+declare function ShellStrip({ shell, label, cols, onBack, onKill, onAgentWrite, terminal, fontSize, lineHeight }: ShellStripProps): import("react").JSX.Element;
 //#endregion
 //#region src/components/agent/use-shell-frame.d.ts
 type ShellFrameOptions = {
@@ -1278,6 +1419,7 @@ type ShellActions = {
   verify: (shellId: string) => Promise<boolean>;
   kill: (shellId: string) => Promise<boolean>;
   open?: (shellId: string) => void;
+  agentWrite?: (shellId: string, enabled: boolean) => Promise<boolean>;
 };
 declare function ShellActionsProvider({ value, children }: {
   value: ShellActions | undefined;
@@ -1288,6 +1430,9 @@ declare function useShellActions(): ShellActions;
 //#region src/components/terminal/shell-row.d.ts
 declare const SHELL_GLYPH = "$";
 declare const SHELL_KILL_GLYPH = "✕";
+declare const SHELL_AGENT_WRITE_NOTE = "agent may type";
+declare function shellGrantable(shell: ShellInfo): boolean;
+declare function shellAgentWriteLabel(shell: ShellInfo): string;
 declare function shellInfoLabel(shell: ShellInfo): string;
 declare function shellTitle(shell: ShellInfo): string;
 declare function shellInfoFailed(shell: ShellInfo): boolean;
@@ -1350,5 +1495,5 @@ declare function copyText(value: string): Promise<boolean>;
 declare function toolIcon(toolName: string): LucideIcon;
 declare function isMutatingTool(toolName: string): boolean;
 //#endregion
-export { AlertDialog, AlertDialogClose, AlertDialogContent, AlertDialogDescription, AlertDialogTitle, AlertDialogTrigger, type ApprovalPromptProps, Badge, type BadgeProps, Band, Blank, Button, type ButtonProps, Card, CardContent, CardHeader, CardTitle, type ChipSegment, type ClientCommand, CodeBlock, type CodeBlockProps, Composer, type ComposerFileMatch, type ComposerHandle, type ComposerProps, type ComposerRow, ContextDialog, type ContextDialogProps, ContextRing, Conversation, ConversationContent, type ConversationProps, ConversationScrollButton, CopyAction, CopyButton, type CopyButtonProps, Dialog, DialogBody, DialogClose, DialogContent, DialogHeader, DialogRow, DialogTrigger, Empty, EmptyKey, EngineIcon, FileCard, type FileCardProps, type FileDeliveredItem, type FileLink, type FileLinkHandle, type FileLinkOpener, FileLinkProvider, HostFilesDialog, type HostFilesDialogProps, Ink, Input, Loader, McpDialog, type McpDialogProps, Menu, MenuContent, MenuItem, MenuSeparator, MenuTrigger, Message, MessageContent, type MessageProps, ModelSelect, type ModelSelectProps, PERMISSION_MODES, type PathHit, type PathMatch, type PermissionModeChoice, type PermissionModeMeta, PermissionModeSelect, type PermissionModeSelectProps, PermissionPrompt, type PermissionPromptProps, ProgressRing, type ProgressRingProps, ProjectIcon, PromptArea, type PromptAreaHandle, type PromptAreaProps, PromptTokenText, QUESTION_BEHAVIORS, type QuestionBehaviorMeta, QuestionPrompt, type QuestionPromptProps, Reasoning, type ReasoningProps, Response, type ResponseProps, Row, type RowProps, SHELL_GLYPH, SHELL_KILL_GLYPH, STATUS_META, SUBAGENT_DISPLAY_META, SUBAGENT_DISPLAY_ORDER, type Segment, Select, SelectContent, SelectItem, SelectItemText, type SelectModifiers, SelectTrigger, SelectValue, SessionBrowser, type SessionBrowserProps, type SessionControls, SessionEmptyState, type SessionEmptyStateProps, SessionInfoDialog, type SessionInfoDialogProps, SessionItem, type SessionItemProps, SessionList, SessionListItem, type SessionListItemProps, type SessionListProps, SessionNamesProvider, SessionPanel, type SessionPanelProps, SessionStatusIcon, type SessionSurfacePanel, type SessionVitals, type ShellActions, ShellActionsProvider, type ShellFrame, type ShellFrameOptions, type ShellStepOptions, ShellStrip, type ShellStripProps, SkillNamesProvider, SkillsDialog, type SkillsDialogProps, Spinner, Splitter, type SplitterProps, StatusBar, type StatusBarProps, type Step, type StepKind, StepRow, SubagentDisplayIcon, SubagentStrip, SubagentToggle, type SubagentToggleProps, TaskList, type TaskListProps, TasksDialog, type TasksDialogProps, type TerminalAffordances, TerminalDiff, TerminalItemView, TerminalMarkdown, type TerminalMarkdownProps, type TerminalMetrics, TerminalPermissionPrompt, type TerminalPermissionPromptProps, TerminalQuestionPrompt, type TerminalQuestionPromptProps, TerminalStatusLine, type TerminalStatusLineProps, TerminalSurface, type TerminalSurfaceProps, TerminalTranscript, type TerminalTranscriptProps, type TextSegment, Textarea, Tip, Toaster, type Tone, ToolCallCard, type ToolCallCardProps, type ToolCallItem, ToolTitleProvider, TooltipContent, TooltipProvider, Transcript, type TranscriptDensity, TranscriptDensityProvider, type TranscriptFont, type TranscriptProps, type TranscriptVariant, TranscriptVariantProvider, type TriggerConfig, type TriggerSuggestion, UsageDialog, type UsageDialogProps, UsageMeters, WithActions, badgeVariants, buttonVariants, cn, commandTrigger, copyText, engineMark, formatAgoPrecise, formatBytes, formatCost, formatCountdown, formatDuration, formatRateLimitWindow, formatRateLimitWindowLong, formatRelativeTime, formatTokens, friendlyModel, getChipsByTrigger, hashtagTrigger, isMutatingTool, isSegmentsEmpty, launchTrigger, matchClientCommand, matchPath, mentionTrigger, mergeComposerRows, parseFileLink, parseUserQuestions, permissionModeChoices, permissionModeMeta, plainTextToSegments, previewPatch, rankComposerRows, rankPeerSessions, rateLimitWindowSeconds, resolveAgainstCwd, rowShapeClass, segmentsToPlainText, sessionSteps, shellInfoFailed, shellInfoLabel, shellInfoStatusText, shellTitle, skillPrompt, toast, toolIcon, toolInputPreview, useAffordances, useFileLinks, useMinuteClock, usePathLinks, usePromptAreaState, useShellActions, useShellFrame, useToolTitle, useTranscriptDensity, useTranscriptVariant, vendorMarkClass, vendorTextClass };
+export { type ActionPlacement, AgentWriteIcon, AlertDialog, AlertDialogClose, AlertDialogContent, AlertDialogDescription, AlertDialogTitle, AlertDialogTrigger, type ApprovalPromptProps, Badge, type BadgeProps, Band, Blank, Button, type ButtonProps, Card, CardContent, CardHeader, CardTitle, type ChipSegment, type ClientCommand, CodeBlock, type CodeBlockProps, Composer, type ComposerFileMatch, type ComposerHandle, type ComposerProps, type ComposerRow, ContextDialog, type ContextDialogProps, ContextPanel, type ContextPanelProps, ContextRing, Conversation, ConversationContent, type ConversationProps, ConversationScrollButton, CopyAction, CopyButton, type CopyButtonProps, Dialog, DialogBody, DialogClose, DialogContent, DialogHeader, DialogRow, DialogTrigger, Empty, EmptyKey, EngineIcon, FileCard, type FileCardProps, type FileDeliveredItem, type FileLink, type FileLinkHandle, type FileLinkOpener, FileLinkProvider, HostFilesDialog, type HostFilesDialogProps, ImageViewer, ImageViewerProvider, Ink, Input, Loader, McpDialog, type McpDialogProps, McpPanel, McpPanelActions, type McpPanelModel, type McpPanelProps, Menu, MenuContent, MenuItem, MenuSeparator, MenuTrigger, Message, MessageContent, type MessageProps, ModelSelect, type ModelSelectProps, type OpenImage, OptionSelect, type OptionSelectProps, PERMISSION_MODES, type PathHit, type PathMatch, type PermissionModeChoice, type PermissionModeMeta, PermissionModeSelect, type PermissionModeSelectProps, PermissionPrompt, type PermissionPromptProps, Popover, PopoverContent, PopoverTrigger, ProgressRing, type ProgressRingProps, ProjectIcon, PromptArea, type PromptAreaHandle, type PromptAreaProps, PromptTokenText, QUESTION_BEHAVIORS, type QuestionBehaviorMeta, QuestionPrompt, type QuestionPromptProps, Reasoning, type ReasoningProps, Response, type ResponseProps, Row, type RowProps, SHELL_AGENT_WRITE_NOTE, SHELL_GLYPH, SHELL_KILL_GLYPH, STATUS_META, STEP_DISPLAY_OPTIONS, SUBAGENT_DISPLAY_META, SUBAGENT_DISPLAY_ORDER, type Segment, Select, SelectContent, SelectItem, SelectItemText, type SelectModifiers, SelectTrigger, SelectValue, SessionBrowser, type SessionBrowserProps, type SessionControls, SessionEmptyState, type SessionEmptyStateProps, SessionFilters, SessionFiltersButton, type SessionFiltersButtonProps, type SessionFiltersProps, SessionInfoDialog, type SessionInfoDialogProps, SessionInfoPanel, type SessionInfoPanelProps, SessionItem, type SessionItemProps, SessionList, SessionListItem, type SessionListItemProps, type SessionListProps, SessionNamesProvider, SessionPanel, type SessionPanelProps, SessionSearch, SessionStatusIcon, type SessionSurfacePanel, type SessionVitals, type ShellActions, ShellActionsProvider, type ShellFrame, type ShellFrameOptions, type ShellStepOptions, ShellStrip, type ShellStripProps, SkillNamesProvider, SkillsDialog, type SkillsDialogProps, Spinner, Splitter, type SplitterProps, StatusBar, type StatusBarProps, type Step, StepDisplayControl, type StepKind, StepRow, SubagentDisplayIcon, SubagentStrip, SubagentToggle, type SubagentToggleProps, TaskList, type TaskListProps, type TaskStepOptions, TasksDialog, type TasksDialogProps, type TerminalAffordances, TerminalDiff, TerminalItemView, TerminalMarkdown, type TerminalMarkdownProps, type TerminalMetrics, TerminalPermissionPrompt, type TerminalPermissionPromptProps, TerminalQuestionPrompt, type TerminalQuestionPromptProps, TerminalStatusLine, type TerminalStatusLineProps, TerminalSurface, type TerminalSurfaceProps, TerminalTranscript, type TerminalTranscriptProps, type TextSegment, Textarea, Tip, Toaster, type Tone, ToolCallCard, type ToolCallCardProps, type ToolCallItem, ToolTitleProvider, TooltipContent, TooltipProvider, Transcript, type TranscriptFont, type TranscriptProps, type TranscriptVariant, TranscriptVariantProvider, type TriggerConfig, type TriggerSuggestion, UsageDialog, type UsageDialogProps, UsageMeters, ViewableImage, type ViewedImage, WithActions, badgeVariants, buttonVariants, cn, commandTrigger, copyText, engineMark, formatAgoPrecise, formatBytes, formatCost, formatCountdown, formatDuration, formatRateLimitWindow, formatRateLimitWindowLong, formatRelativeTime, formatTokens, friendlyModel, getChipsByTrigger, hashtagTrigger, isMutatingTool, isSegmentsEmpty, launchTrigger, matchClientCommand, matchPath, mentionTrigger, mergeComposerRows, parseFileLink, parseUserQuestions, permissionModeChoices, permissionModeMeta, plainTextToSegments, previewPatch, rankComposerRows, rankPeerSessions, rateLimitWindowSeconds, resolveAgainstCwd, rowShapeClass, segmentsToPlainText, sessionSteps, shellAgentWriteLabel, shellGrantable, shellInfoFailed, shellInfoLabel, shellInfoStatusText, shellTitle, skillPrompt, toast, toolIcon, toolInputPreview, useAffordances, useFileLinks, useMcpPanel, useMinuteClock, useOpenImage, usePathLinks, usePromptAreaState, useShellActions, useShellFrame, useToolTitle, useTranscriptVariant, vendorMarkClass, vendorTextClass };
 //# sourceMappingURL=index.d.mts.map