@workerdeck/ui 0.12.0 → 0.15.0

package/build/{SessionPanel-Dy9lQrOV.d.mts → SessionPanel-J2U8v88q.d.mts}

@@ -2,7 +2,7 @@ import * as _$react from "react";
 import { ReactNode } from "react";
 import { LucideIcon } from "lucide-react";
 import { ModelOption, PermissionMode } from "@workerdeck/protocol";
-import { ConnectionState, TranscriptState } from "@workerdeck/react";
+import { ConnectionState, TranscriptState, UseToolCallHostOptions } from "@workerdeck/react";
 import { WorkerDeckClient } from "@workerdeck/client";
 
 //#region src/components/agent/PermissionModeSelect.d.ts
@@ -127,6 +127,19 @@ declare function TranscriptDensityProvider({
   children: ReactNode;
 }): _$react.JSX.Element;
 declare function useTranscriptDensity(): TranscriptDensity;
+/**
+ * The typeface the panel runs in.
+ *
+ * `sans` is the host's UI font; `mono` repoints the sans token at the mono stack
+ * for the panel's subtree (see the `[data-agent-font='mono']` rule in
+ * `theme.css`), so the transcript reads as part of a terminal rather than as a
+ * web app beside one.
+ *
+ * No context and no hook, unlike variant and density: nothing branches on it in
+ * JS. It is one attribute on the panel root and the cascade does the rest, which
+ * is also what keeps it from leaking past the panel.
+ */
+type TranscriptFont = 'sans' | 'mono';
 //#endregion
 //#region src/components/agent/SessionPanel.d.ts
 interface SessionPanelProps {
@@ -172,6 +185,17 @@ interface SessionPanelProps {
    * take the menu, or it has nowhere left to go.
    */
   statusSurface?: 'internal' | 'external';
+  /**
+   * Which end of the panel the status bar sits at. Default `top`.
+   *
+   * `bottom` is the editor convention — VS Code's status bar runs along the
+   * foot of the window — and suits a host where the panel *is* the editor area
+   * and the chrome above it already belongs to the app. Placement only; the bar
+   * is the same bar, with the same `⋯` menu in its trailing slot, so this
+   * composes with {@link statusSurface} rather than competing with it (external
+   * still means "there isn't one").
+   */
+  statusPlacement?: 'top' | 'bottom';
   /** Where `panelSurface: 'external'` routes opens. Absent = the affordances
    * (status-bar clicks, `/mcp`) become inert rather than half-working. */
   onOpenPanel?: (panel: SessionSurfacePanel) => void;
@@ -194,18 +218,36 @@ interface SessionPanelProps {
    * dock is allowed to be roomy.
    */
   transcriptDensity?: TranscriptDensity;
+  /**
+   * The panel's typeface — `'sans'` (default, the host's UI font) or `'mono'`,
+   * which repoints the sans token at the mono stack **for this subtree only**.
+   *
+   * The third reader preference beside variant and density, and the same kind of
+   * thing: how a transcript should read is a property of the person reading it.
+   * Scoped to the panel because that is the whole claim — a monospace agent view
+   * next to an ordinary app, not a monospace app.
+   */
+  transcriptFont?: TranscriptFont;
   /**
    * Where the session's own controls — model and permission mode — live.
    * `'internal'` (default) draws them in the composer's toolbar row.
-   * `'external'` draws neither, and the composer collapses to a single line
-   * with its attach/send buttons beside the field: the embedder renders the
-   * pickers in its own chrome (VS Code's status bar, where a click opens a
-   * QuickPick) and drives them through {@link onControls}.
+   * `'status'` draws them in the panel's OWN status bar, beside the readings
+   * they act on; the composer collapses to a single line either way. That is
+   * VS Code's arrangement without VS Code — a host whose panel carries a status
+   * bar of its own (`statusPlacement: 'bottom'`) gets the same streamlined
+   * shape without having to host the pickers itself.
+   * `'external'` draws neither: the embedder renders the pickers in its own
+   * chrome (VS Code's window status bar, where a click opens a QuickPick) and
+   * drives them through {@link onControls}.
+   *
+   * `'status'` needs a status bar to put them in — with
+   * `statusSurface: 'external'` there is none, and the two together would hide
+   * the controls entirely, so that combination falls back to the composer.
    *
    * The options themselves ride {@link SessionVitals} — an embedder must not
    * attach a second time to learn what the models are.
    */
-  controlsSurface?: 'internal' | 'external';
+  controlsSurface?: 'internal' | 'external' | 'status';
   /**
    * Handed the session's setters once the panel is live, and `undefined` on
    * unmount. The counterpart to `controlsSurface: 'external'`: vitals carry the
@@ -238,6 +280,38 @@ interface SessionPanelProps {
     itemCount: number;
     since?: number;
   };
+  /**
+   * A viewer, not a seat at the session: transcript, status bar and panels as
+   * usual, but no composer and no approval prompts.
+   *
+   * For a surface that is *about* a run rather than in it — the dashboard's job
+   * detail, where the session belongs to the queue and typing into it would be a
+   * second operator arriving mid-run. Deliberately not "disabled controls": a
+   * greyed-out composer says the session is busy, an absent one says this screen
+   * does not drive it. The attach is still live and read paths are untouched,
+   * so the transcript streams and the file tree browses.
+   *
+   * It does **not** claim to be an authorization boundary. Anything holding this
+   * client can still send; what it removes is the affordance, and the honest
+   * enforcement lives on the gateway.
+   */
+  readOnly?: boolean;
+  /**
+   * Options for the browser tool host this panel runs on its own attach — or
+   * `false` to run none at all.
+   *
+   * The panel hosts server-bridged tool calls itself, because the bridge asks
+   * the *first attached client* and the panel owns the session's one attach: an
+   * embedder subscribing to the same handle separately would find this host
+   * already answering, and refusing, anything outside its allow-list. So the
+   * options come through here.
+   *
+   * Merged over the defaults, which host `eval_script` alone. Widening `tools`
+   * is a real grant — this tab will execute what the gateway asks it to for
+   * every name in the list — so it names them explicitly rather than accepting
+   * a wildcard.
+   */
+  toolHost?: UseToolCallHostOptions | false;
   className?: string;
 }
 /** What an embedder needs to *change* a session it doesn't own the attach for. */
@@ -304,16 +378,20 @@ declare function SessionPanel({
   header,
   panelSurface,
   statusSurface,
+  statusPlacement,
   onOpenPanel,
   onVitals,
   transcriptVariant,
   transcriptDensity,
+  transcriptFont,
   controlsSurface,
   onControls,
   focusComposerOnClick,
   unseen,
+  readOnly,
+  toolHost,
   className
 }: SessionPanelProps): _$react.JSX.Element;
 //#endregion
-export { permissionModeChoices as _, SessionVitals as a, TranscriptVariant as c, useTranscriptVariant as d, PERMISSION_MODES as f, PermissionModeSelectProps as g, PermissionModeSelect as h, SessionSurfacePanel as i, TranscriptVariantProvider as l, PermissionModeMeta as m, SessionPanel as n, TranscriptDensity as o, PermissionModeChoice as p, SessionPanelProps as r, TranscriptDensityProvider as s, SessionControls as t, useTranscriptDensity as u, permissionModeMeta as v };
-//# sourceMappingURL=SessionPanel-Dy9lQrOV.d.mts.map
+export { PermissionModeSelectProps as _, SessionVitals as a, TranscriptFont as c, useTranscriptDensity as d, useTranscriptVariant as f, PermissionModeSelect as g, PermissionModeMeta as h, SessionSurfacePanel as i, TranscriptVariant as l, PermissionModeChoice as m, SessionPanel as n, TranscriptDensity as o, PERMISSION_MODES as p, SessionPanelProps as r, TranscriptDensityProvider as s, SessionControls as t, TranscriptVariantProvider as u, permissionModeChoices as v, permissionModeMeta as y };
+//# sourceMappingURL=SessionPanel-J2U8v88q.d.mts.map

package/build/index.d.mts

@@ -1,5 +1,5 @@
 import { a as formatDuration, c as formatRelativeTime, d as rateLimitWindowSeconds, f as toolInputPreview, i as formatCountdown, l as formatTokens, n as formatBytes, o as formatRateLimitWindow, r as formatCost, s as formatRateLimitWindowLong, t as formatAgoPrecise, u as friendlyModel } from "./format-ljc3lKpA.mjs";
-import { _ as permissionModeChoices, a as SessionVitals, c as TranscriptVariant, d as useTranscriptVariant, f as PERMISSION_MODES, g as PermissionModeSelectProps, h as PermissionModeSelect, i as SessionSurfacePanel, l as TranscriptVariantProvider, m as PermissionModeMeta, n as SessionPanel, o as TranscriptDensity, p as PermissionModeChoice, r as SessionPanelProps, s as TranscriptDensityProvider, t as SessionControls, u as useTranscriptDensity, v as permissionModeMeta } from "./SessionPanel-Dy9lQrOV.mjs";
+import { _ as PermissionModeSelectProps, a as SessionVitals, c as TranscriptFont, d as useTranscriptDensity, f as useTranscriptVariant, g as PermissionModeSelect, h as PermissionModeMeta, i as SessionSurfacePanel, l as TranscriptVariant, m as PermissionModeChoice, n as SessionPanel, o as TranscriptDensity, p as PERMISSION_MODES, r as SessionPanelProps, s as TranscriptDensityProvider, t as SessionControls, u as TranscriptVariantProvider, v as permissionModeChoices, y as permissionModeMeta } from "./SessionPanel-J2U8v88q.mjs";
 import * as _$react from "react";
 import { ButtonHTMLAttributes, FunctionComponent, HTMLAttributes, InputHTMLAttributes, ReactElement, ReactNode, Ref, RefObject, TextareaHTMLAttributes } from "react";
 import { VariantProps } from "class-variance-authority";
@@ -22,7 +22,7 @@ import { WorkerDeckClient } from "@workerdeck/client";
 
 //#region src/components/ui/Button.d.ts
 declare const buttonVariants: (props?: ({
-  variant?: "default" | "link" | "outline" | "secondary" | "ghost" | "destructive" | null | undefined;
+  variant?: "default" | "outline" | "secondary" | "ghost" | "destructive" | "link" | null | undefined;
   size?: "default" | "xs" | "sm" | "lg" | "icon" | "icon-sm" | null | undefined;
 } & _$class_variance_authority_types0.ClassProp) | undefined) => string;
 interface ButtonProps extends ButtonHTMLAttributes<HTMLButtonElement>, VariantProps<typeof buttonVariants> {}
@@ -218,6 +218,12 @@ interface SplitterProps {
   max: number;
   /** Keyboard step. */
   step?: number;
+  /**
+   * Size to snap back to on a double-click — the convention every pane divider
+   * that can be dragged is expected to honour. Omit and a double-click does
+   * nothing, which is the honest behaviour when there is no default to mean.
+   */
+  defaultValue?: number;
   /** Set when dragging the splitter *away* from the origin should shrink the
    * controlled pane — i.e. the pane is on the right or the bottom. */
   inverted?: boolean;
@@ -249,11 +255,49 @@ declare function Splitter({
   min,
   max,
   step,
+  defaultValue,
   inverted,
   'aria-label': label,
   className
 }: SplitterProps): _$react.JSX.Element;
 //#endregion
+//#region src/components/ui/Empty.d.ts
+/**
+ * A view with nothing in it: icon, title, description, and at most one action.
+ *
+ * Centered and given room, because an empty view is the first thing a new
+ * install shows and a flush-left sentence in the top corner reads like a bug
+ * report. It lives here rather than in one client because every panel that can
+ * be empty should be empty the same way — the extension's views and the
+ * dashboard's four sidebars are the same shape of thing.
+ *
+ * **At most one action, and never one the view header already offers.** Creating
+ * a session and adding a gateway are the `+` in the native title bar, exclusively
+ * — so those empty states point at it in words rather than growing a second
+ * button that does the same thing two inches lower. A button here is for the way
+ * out of a state the header has no answer to: clearing a filter, widening a
+ * scope.
+ */
+declare function Empty({
+  icon,
+  title,
+  description,
+  action,
+  onAction
+}: {
+  icon: ReactNode;
+  title: string;
+  description?: ReactNode;
+  action?: string;
+  onAction?: () => void;
+}): _$react.JSX.Element;
+/** A key or icon named inline in an empty state's description — "use the + above". */
+declare function EmptyKey({
+  children
+}: {
+  children: ReactNode;
+}): _$react.JSX.Element;
+//#endregion
 //#region src/components/ui/ProgressRing.d.ts
 interface ProgressRingProps {
   /** Filled share, 0–100 (clamped). */
@@ -815,9 +859,12 @@ interface MessageProps extends HTMLAttributes<HTMLDivElement> {
 /**
  * One chat turn row.
  *
- * `cards`: user messages sit right in a bubble; assistant content is flat,
- * full-width (the AI-chat convention — assistant output is the page, user input
- * is quoted).
+ * `cards`: user messages sit in a bubble, assistant content is flat and
+ * full-width. Both are **left-aligned**: the transcript is a log read top to
+ * bottom, and an editor-shaped host (a full-width session view beside a sessions
+ * rail) has no right edge to anchor to — a bubble drifting right in a 1600px
+ * column separates a prompt from the reply it produced. The bubble alone is
+ * enough to say who spoke.
  *
  * `lines`: both are left-aligned full-width line items behind a gutter glyph —
  * `❯` for what was typed, `●` for what the model said. No bubble: a prompt is
@@ -1144,8 +1191,18 @@ interface StatusBarProps {
   onOpenStatus?: () => void;
   onOpenContext?: () => void;
   onOpenUsage?: () => void;
-  /** Trailing slot — the session-actions menu, in the panel's top-right. */
+  /**
+   * The session's own controls (model, permission mode), for
+   * `controlsSurface: 'status'`. They sit at the end of the readings cluster —
+   * status, context, usage, then what you can *change* — rather than out by the
+   * actions menu, because they belong with the session facts they act on.
+   */
+  controls?: ReactNode;
+  /** Trailing slot — the session-actions menu, at the bar's trailing edge. */
   actions?: ReactNode;
+  /** Which edge the bar sits on, so its separating rule goes on the other side.
+   * Placement is the panel's decision; this only styles it. */
+  placement?: 'top' | 'bottom';
   className?: string;
 }
 declare function StatusBar({
@@ -1155,7 +1212,9 @@ declare function StatusBar({
   onOpenStatus,
   onOpenContext,
   onOpenUsage,
+  controls,
   actions,
+  placement,
   className
 }: StatusBarProps): _$react.JSX.Element;
 //#endregion
@@ -1394,8 +1453,37 @@ interface SessionBrowserProps {
   onRename?: (row: SessionRow, title: string) => void;
   /** Rendered when nothing at all exists (as opposed to nothing matching). */
   emptyState?: React.ReactNode;
+  /**
+   * Whether the search + facet bar is shown. Defaults to `true` — a list that
+   * *is* the screen shows its controls.
+   *
+   * A host with somewhere better to put the toggle (a view title bar) passes
+   * `false` and owns the boolean itself, the way the VS Code extension does: the
+   * key lives where the commands do. Two rules come with it, and they are why
+   * this hides only the bar and nothing else — **closing the bar never clears
+   * the filters**, and the subset line below it renders either way, so a list
+   * filtered by a control you can't currently see still says so.
+   */
+  showControls?: boolean;
   className?: string;
 }
+/**
+ * How a list row is drawn, in one place, so `SidebarRow` in `web` matches this
+ * exactly rather than approximating it — the dashboard's other three sidebars
+ * are that component, and a sessions list that hovered differently from the
+ * gateways list beside it would read as a different product.
+ *
+ * Two rules are load-bearing:
+ *
+ * - **Fill means hover, and only hover.** It stays on the row whether or not
+ *   the row is selected, because a selected row still has to answer the
+ *   pointer. Selection gets the gutter instead.
+ * - **`ml-0` on the selected row is not cosmetic.** It hands the accent border
+ *   the 4px the margin was holding, so the text does not shift sideways as a
+ *   row becomes the selected one. The squared left corners are what let the bar
+ *   sit flush against the sidebar edge.
+ */
+declare function rowShapeClass(active: boolean): string;
 declare function SessionBrowser({
   rows,
   config,
@@ -1406,8 +1494,31 @@ declare function SessionBrowser({
   onDelete,
   onRename,
   emptyState,
+  showControls,
   className
 }: SessionBrowserProps): _$react.JSX.Element;
+/**
+ * State as one glyph on the right edge — a ringing bell when it wants a human, a
+ * spinner while it works, a moon when it is only sleeping. Replaces the text
+ * badge: in a sidebar the word costs more room than it earns, and the states
+ * that matter are the two you can recognise without reading.
+ */
+declare function SessionStatusIcon({
+  row
+}: {
+  row: SessionRow;
+}): _$react.JSX.Element;
+//#endregion
+//#region src/components/agent/EngineIcon.d.ts
+declare function EngineIcon({
+  engine,
+  model,
+  className
+}: {
+  engine: string;
+  model?: string;
+  className?: string;
+}): _$react.JSX.Element;
 //#endregion
 //#region src/components/agent/SessionEmptyState.d.ts
 interface SessionEmptyStateProps {
@@ -1511,5 +1622,5 @@ declare function toolIcon(toolName: string): LucideIcon;
  */
 declare function isMutatingTool(toolName: string): boolean;
 //#endregion
-export { AlertDialog, AlertDialogClose, AlertDialogContent, AlertDialogDescription, AlertDialogTitle, AlertDialogTrigger, Badge, type BadgeProps, Button, type ButtonProps, Card, CardContent, CardHeader, CardTitle, type ChipSegment, CodeBlock, type CodeBlockProps, Composer, type ComposerFileMatch, type ComposerHandle, type ComposerProps, ContextDialog, type ContextDialogProps, Conversation, ConversationContent, type ConversationProps, ConversationScrollButton, CopyButton, type CopyButtonProps, Dialog, DialogBody, DialogClose, DialogContent, DialogHeader, DialogRow, DialogTrigger, FileCard, type FileCardProps, type FileDeliveredItem, HostFilesDialog, type HostFilesDialogProps, Input, Loader, McpDialog, type McpDialogProps, Menu, MenuContent, MenuItem, MenuSeparator, MenuTrigger, Message, MessageContent, type MessageProps, ModelSelect, type ModelSelectProps, PERMISSION_MODES, type PermissionModeChoice, type PermissionModeMeta, PermissionModeSelect, type PermissionModeSelectProps, PermissionPrompt, type PermissionPromptProps, ProgressRing, type ProgressRingProps, PromptArea, type PromptAreaHandle, type PromptAreaProps, PromptTokenText, QUESTION_BEHAVIORS, type QuestionBehaviorMeta, QuestionPrompt, type QuestionPromptProps, Reasoning, type ReasoningProps, Response, type ResponseProps, STATUS_META, type Segment, Select, SelectContent, SelectItem, SelectItemText, SelectTrigger, SelectValue, SessionBrowser, type SessionBrowserProps, type SessionControls, SessionEmptyState, type SessionEmptyStateProps, SessionInfoDialog, type SessionInfoDialogProps, SessionList, SessionListItem, type SessionListItemProps, type SessionListProps, SessionPanel, type SessionPanelProps, type SessionSurfacePanel, type SessionVitals, SkillsDialog, type SkillsDialogProps, Spinner, Splitter, type SplitterProps, StatusBar, type StatusBarProps, type TextSegment, Textarea, Tip, Toaster, ToolCallCard, type ToolCallCardProps, type ToolCallItem, TooltipContent, TooltipProvider, Transcript, type TranscriptDensity, TranscriptDensityProvider, type TranscriptProps, type TranscriptVariant, TranscriptVariantProvider, type TriggerConfig, type TriggerSuggestion, UsageDialog, type UsageDialogProps, badgeVariants, buttonVariants, cn, commandTrigger, copyText, formatAgoPrecise, formatBytes, formatCost, formatCountdown, formatDuration, formatRateLimitWindow, formatRateLimitWindowLong, formatRelativeTime, formatTokens, friendlyModel, getChipsByTrigger, hashtagTrigger, isMutatingTool, isSegmentsEmpty, mentionTrigger, parseUserQuestions, permissionModeChoices, permissionModeMeta, plainTextToSegments, rateLimitWindowSeconds, segmentsToPlainText, skillPrompt, toast, toolIcon, toolInputPreview, usePromptAreaState, useTranscriptDensity, useTranscriptVariant };
+export { AlertDialog, AlertDialogClose, AlertDialogContent, AlertDialogDescription, AlertDialogTitle, AlertDialogTrigger, Badge, type BadgeProps, Button, type ButtonProps, Card, CardContent, CardHeader, CardTitle, type ChipSegment, CodeBlock, type CodeBlockProps, Composer, type ComposerFileMatch, type ComposerHandle, type ComposerProps, ContextDialog, type ContextDialogProps, Conversation, ConversationContent, type ConversationProps, ConversationScrollButton, CopyButton, type CopyButtonProps, Dialog, DialogBody, DialogClose, DialogContent, DialogHeader, DialogRow, DialogTrigger, Empty, EmptyKey, EngineIcon, FileCard, type FileCardProps, type FileDeliveredItem, HostFilesDialog, type HostFilesDialogProps, Input, Loader, McpDialog, type McpDialogProps, Menu, MenuContent, MenuItem, MenuSeparator, MenuTrigger, Message, MessageContent, type MessageProps, ModelSelect, type ModelSelectProps, PERMISSION_MODES, type PermissionModeChoice, type PermissionModeMeta, PermissionModeSelect, type PermissionModeSelectProps, PermissionPrompt, type PermissionPromptProps, ProgressRing, type ProgressRingProps, PromptArea, type PromptAreaHandle, type PromptAreaProps, PromptTokenText, QUESTION_BEHAVIORS, type QuestionBehaviorMeta, QuestionPrompt, type QuestionPromptProps, Reasoning, type ReasoningProps, Response, type ResponseProps, STATUS_META, type Segment, Select, SelectContent, SelectItem, SelectItemText, SelectTrigger, SelectValue, SessionBrowser, type SessionBrowserProps, type SessionControls, SessionEmptyState, type SessionEmptyStateProps, SessionInfoDialog, type SessionInfoDialogProps, SessionList, SessionListItem, type SessionListItemProps, type SessionListProps, SessionPanel, type SessionPanelProps, SessionStatusIcon, type SessionSurfacePanel, type SessionVitals, SkillsDialog, type SkillsDialogProps, Spinner, Splitter, type SplitterProps, StatusBar, type StatusBarProps, type TextSegment, Textarea, Tip, Toaster, ToolCallCard, type ToolCallCardProps, type ToolCallItem, TooltipContent, TooltipProvider, Transcript, type TranscriptDensity, TranscriptDensityProvider, type TranscriptFont, type TranscriptProps, type TranscriptVariant, TranscriptVariantProvider, type TriggerConfig, type TriggerSuggestion, UsageDialog, type UsageDialogProps, badgeVariants, buttonVariants, cn, commandTrigger, copyText, formatAgoPrecise, formatBytes, formatCost, formatCountdown, formatDuration, formatRateLimitWindow, formatRateLimitWindowLong, formatRelativeTime, formatTokens, friendlyModel, getChipsByTrigger, hashtagTrigger, isMutatingTool, isSegmentsEmpty, mentionTrigger, parseUserQuestions, permissionModeChoices, permissionModeMeta, plainTextToSegments, rateLimitWindowSeconds, rowShapeClass, segmentsToPlainText, skillPrompt, toast, toolIcon, toolInputPreview, usePromptAreaState, useTranscriptDensity, useTranscriptVariant };
 //# sourceMappingURL=index.d.mts.map