@opengeni/react 0.13.0 → 0.15.0

package/dist/index.d.ts

@@ -1,10 +1,10 @@
-import { C as ClientOverride, S as SessionClientLike } from './machines-CnlMb7E-.js';
-export { a as CONNECTION_STATUS_META, b as ConnectionDot, c as ConnectionDotProps, d as ConnectionStatus, e as ConnectionStatusMeta, f as ConnectionStatusPill, g as ConnectionStatusPillProps, D as DeviceFlowPhase, E as EnrollmentConsent, h as EnrollmentConsentMachine, i as EnrollmentConsentPhase, j as EnrollmentConsentProps, k as EnrollmentDeviceFlow, l as EnrollmentDeviceFlowProps, M as MACHINE_STATE_BADGE_META, m as MachineCard, n as MachineCardProps, o as MachineDockBar, p as MachineDockBarProps, q as MachineMetrics, r as MachineMetricsProps, s as MachineStateBadgeMeta, t as MachineStatusPill, u as MachineStatusPillProps, v as MachinesClientLike, w as MachinesDashboard, x as MachinesDashboardProps, O as OpenGeniContextValue, y as OpenGeniProvider, z as OpenGeniProviderProps, A as SharedMachineDisclosure, B as SharedMachineDisclosureProps, U as UseMachinesOptions, F as UseMachinesResult, G as connectionStatusForState, H as useMachines, I as useOpenGeni, J as useOpenGeniClient } from './machines-CnlMb7E-.js';
-import { SessionEvent, Session, ResourceRef, ToolRef, SessionStatus as SessionStatus$1, GitFileDiff, StreamConnectionState, SendMessageInput, FileAsset, FileResourceRef, SessionQueueSnapshot, SessionTurn, SessionGoal, ScheduledTask, SessionLineageResponse, VariableSet, CreateVariableSetRequest, UpdateVariableSetRequest, VariableSetVariableMetadata, RigChange, Rig, UpdateRigRequest, RigVersion, ProposeRigChangeRequest, CreateRigRequest, CapabilityPack, PackInstallation, RegisterCapabilityPackRequest, WorkspaceRegisteredPack, EnablePackRequest, Workspace, CreateWorkspaceRequest, UpdateWorkspaceRequest, BillingBalance, UsageEvent, ClientModel, SessionCapabilities, DesktopStreamCapability, DesktopConnectionState, DesktopRfbFactory, TerminalCapability, FsReadResponse, FsWriteResponse, WorkspaceCaptureManifest, WorkspaceCaptureDegradedReason, MachineState, Permission, CapabilityUnavailableReason, MachineView, CodexAccountsResponse, CodexAccount, CodexRotationSettings } from '@opengeni/sdk';
+import { C as ClientOverride, S as SessionClientLike } from './machines-BpdwuQcD.js';
+export { a as CONNECTION_STATUS_META, b as ConnectionDot, c as ConnectionDotProps, d as ConnectionStatus, e as ConnectionStatusMeta, f as ConnectionStatusPill, g as ConnectionStatusPillProps, D as DeviceFlowPhase, E as EnrollmentConsent, h as EnrollmentConsentMachine, i as EnrollmentConsentPhase, j as EnrollmentConsentProps, k as EnrollmentDeviceFlow, l as EnrollmentDeviceFlowProps, H as HEALTH_TOKEN, m as HealthLevel, n as HealthVerdict, M as MACHINE_STATE_BADGE_META, o as METRICS, p as METRIC_WINDOWS, q as MachineCard, r as MachineCardProps, s as MachineDetail, t as MachineDetailProps, u as MachineDockBar, v as MachineDockBarProps, w as MachineHealthPill, x as MachineHealthPillProps, y as MachineMetrics, z as MachineMetricsProps, A as MachineStateBadgeMeta, B as MachineStatusPill, F as MachineStatusPillProps, G as MachinesClientLike, I as MachinesDashboard, J as MachinesDashboardProps, K as MetricDef, L as MetricHistoryChart, N as MetricHistoryChartProps, O as MetricKey, P as MetricSparkline, Q as MetricSparklineProps, R as MetricWindow, T as OpenGeniContextValue, U as OpenGeniProvider, V as OpenGeniProviderProps, W as SeriesPoint, X as SharedMachineDisclosure, Y as SharedMachineDisclosureProps, Z as UseMachinesOptions, _ as UseMachinesResult, $ as WINDOW_LABEL, a0 as connectionStatusForState, a1 as deriveHealth, a2 as healthPulses, a3 as pointsFor, a4 as useMachines, a5 as useOpenGeni, a6 as useOpenGeniClient } from './machines-BpdwuQcD.js';
+import { SessionEvent, Session, ResourceRef, ToolRef, SessionStatus as SessionStatus$1, GitFileDiff, StreamConnectionState, EffectiveControlResumeOption, ComposerDraft, SendMessageInput, EffectiveSessionControl, FileAsset, FileResourceRef, SessionQueueSnapshot, SessionTurn, Permission, ClientModel, SessionGoal, SessionControlResponse, ScheduledTask, SessionLineageResponse, VariableSet, CreateVariableSetRequest, UpdateVariableSetRequest, VariableSetVariableMetadata, RigChange, Rig, UpdateRigRequest, RigVersion, ProposeRigChangeRequest, CreateRigRequest, CapabilityPack, PackInstallation, RegisterCapabilityPackRequest, WorkspaceRegisteredPack, EnablePackRequest, Workspace, CreateWorkspaceRequest, UpdateWorkspaceRequest, BillingBalance, UsageEvent, SessionCapabilities, DesktopStreamCapability, DesktopConnectionState, DesktopRfbFactory, TerminalCapability, FsReadResponse, FsWriteResponse, WorkspaceCaptureManifest, WorkspaceCaptureDegradedReason, MachineState, CapabilityUnavailableReason, MachineView, CodexAccountsResponse, CodexAccount, CodexRotationSettings } from '@opengeni/sdk';
 export { MachineKind, MachineMetricsSeriesResponse, MachineState, MachineView, MachinesResponse, MetricSample } from '@opengeni/sdk';
-import * as react from 'react';
-import { ComponentType, ReactNode, RefObject, KeyboardEvent, ClipboardEvent } from 'react';
 import * as react_jsx_runtime from 'react/jsx-runtime';
+import * as react from 'react';
+import { ComponentType, ReactNode, KeyboardEvent, ClipboardEvent, RefObject } from 'react';
 import { ClassValue } from 'clsx';
 
 type SessionEventFeedOptions = {
@@ -638,12 +638,7 @@ type UseSessionEventsResult = {
 declare function useSessionEvents(sessionId: string | null | undefined, options?: UseSessionEventsOptions): UseSessionEventsResult;
 
 type ComposerSendExtras = Omit<SendMessageInput, "text" | "clientEventId">;
-/**
- * Enter appends a prompt; Cmd/Ctrl+Enter steers it to the head and supersedes
- * the current inference.
- */
-type ComposerMode = "queue" | "steer";
-type UseComposerOptions = ClientOverride & {
+type UseComposerOptions = ClientOverride & SessionEventFeedOptions & {
     /** Called with the accepted text after a successful send. */
     onSent?: ((text: string) => void) | undefined;
     /**
@@ -652,19 +647,37 @@ type UseComposerOptions = ClientOverride & {
      * surrounding UI state (attachment pickers, model selectors, ...).
      */
     sendExtras?: ComposerSendExtras | (() => ComposerSendExtras) | undefined;
+    /** Latest server-derived workstream control; bound into Send/Steer OCC. */
+    effectiveControl?: EffectiveSessionControl | null | undefined;
+    /** Apply durable model/tool/reasoning settings in the host's controlled UI. */
+    onDraftApplied?: ((draft: ComposerDraft) => void) | undefined;
 };
 type ComposerState = {
     value: string;
     setValue: (value: string) => void;
-    /** Send the draft (or explicit text). Queue is the default; steer is explicit. */
-    send: (text?: string, mode?: ComposerMode) => Promise<boolean>;
+    /** Append the draft behind prompts already visible in the queue. */
+    send: (text?: string) => Promise<boolean>;
+    /** Supersede current direction with the draft. */
+    steer: (text?: string) => Promise<boolean>;
     sending: boolean;
     canSend: boolean;
     /** Pause the session without deleting its prompt queue. */
     pause: (reason?: string) => Promise<void>;
     pausing: boolean;
     resume: (reason?: string) => Promise<void>;
+    resumeScope: (option: EffectiveControlResumeOption) => Promise<void>;
     resuming: boolean;
+    draft: ComposerDraft | null;
+    draftRevision: number;
+    draftLoading: boolean;
+    draftSaving: boolean;
+    draftConflict: Error | null;
+    /** Apply an atomic queue Edit checkout without a second read. */
+    applyDraft: (draft: ComposerDraft) => void;
+    reloadDraft: () => Promise<void>;
+    resolveDraftConflict: (choice: "keep_mine" | "use_remote") => Promise<void>;
+    restoredResources: ResourceRef[];
+    removeRestoredResource: (index: number) => void;
     error: Error | null;
     clearError: () => void;
 };
@@ -686,7 +699,7 @@ declare const FILE_ONLY_MESSAGE_TEXT = "(see attached files)";
  * Merge the draft text + idempotency key with caller-provided extras. The
  * text and clientEventId always win over extras. Exported for tests.
  */
-declare function composeSendInput(text: string, clientEventId: string, extras: ComposerSendExtras | (() => ComposerSendExtras) | undefined): SendMessageInput;
+declare function composeSendInput(text: string, clientEventId: string, extras: ComposerSendExtras | (() => ComposerSendExtras) | undefined, bound?: Partial<SendMessageInput>): SendMessageInput;
 /** Submit on plain Enter; Shift+Enter inserts a newline. Exported for tests. */
 declare function shouldSubmitOnKey(event: {
     key: string;
@@ -697,6 +710,11 @@ declare function shouldSubmitOnKey(event: {
         isComposing?: boolean;
     };
 }): boolean;
+/** Cmd/Ctrl+Enter steers; ordinary Enter appends to the queue. */
+declare function shouldSteerOnKey(event: {
+    metaKey?: boolean;
+    ctrlKey?: boolean;
+}): boolean;
 
 type UseFileAttachmentsOptions = ClientOverride & {
     /**
@@ -756,8 +774,9 @@ type UseFileAttachmentsResult = {
  */
 declare function useFileAttachments(options?: UseFileAttachmentsOptions): UseFileAttachmentsResult;
 
-/** Events that can change the authoritative prompt queue or its pause gates. */
+/** Events that can change the authoritative prompt queue or effective control. */
 declare function isTurnQueueEvent(event: Pick<SessionEvent, "type">): boolean;
+type QueueMutationKind = "move" | "edit" | "steer" | "delete";
 type UseTurnQueueOptions = ClientOverride & SessionEventFeedOptions & {
     pollIntervalMs?: number | undefined;
 };
@@ -765,26 +784,269 @@ type UseTurnQueueResult = {
     snapshot: SessionQueueSnapshot | null;
     /** Human/API prompts exactly in server execution order. Never client-sorted. */
     queue: SessionTurn[];
-    controlState: SessionQueueSnapshot["controlState"] | null;
-    controlGeneration: number | null;
-    workspaceInferenceState: SessionQueueSnapshot["workspaceInferenceState"] | null;
-    workspaceInferenceGeneration: number | null;
-    workspaceRunExceptionGeneration: number | null;
+    effectiveControl: EffectiveSessionControl | null;
     loading: boolean;
     error: Error | null;
     refresh: () => Promise<void>;
-    /** Delete a waiting prompt before the worker claims it. */
+    moveTurn: (turnId: string, beforeTurnId: string | null) => Promise<boolean>;
+    /** Atomically withdraw a waiting prompt into the private durable composer draft. */
+    editTurn: (turnId: string, options: {
+        expectedDraftRevision: number;
+        replaceDraft: boolean;
+    }) => Promise<ComposerDraft | null>;
+    /** Advance the same durable waiting prompt; no duplicate prompt is created. */
+    steerTurn: (turnId: string) => Promise<boolean>;
     removeTurn: (turnId: string) => Promise<boolean>;
+    pendingByTurn: Readonly<Record<string, QueueMutationKind>>;
+    mutationFor: (turnId: string) => QueueMutationKind | null;
     mutating: boolean;
     mutationError: Error | null;
     clearMutationError: () => void;
 };
 /**
- * The single authoritative waiting-prompt queue. The server owns ordering; the
- * client renders the returned array verbatim and supports deletion only.
+ * The one authoritative human prompt queue. Every mutation carries the exact
+ * server versions the operator saw and accepts only monotonic snapshots. A
+ * conflict immediately reloads server truth; the client never invents order.
  */
 declare function useTurnQueue(sessionId: string | null | undefined, options?: UseTurnQueueOptions): UseTurnQueueResult;
 
+/** The sole human prompt queue: compact above Goal, Agents, and composer. */
+type QueueSurfaceProps = {
+    queue: UseTurnQueueResult;
+    composer: ComposerState;
+    readOnly?: false | undefined;
+} | {
+    queue: UseTurnQueueResult;
+    composer?: undefined;
+    readOnly: true;
+};
+declare function QueueSurface({ queue, composer, readOnly }: QueueSurfaceProps): react_jsx_runtime.JSX.Element | null;
+
+/**
+ * The slash-command registry. A command is a SESSION / OPERATOR control — an
+ * action on the session or the UI (clear, compact, pause the goal, show help) —
+ * NOT a structured way to talk to the agent. The human↔agent channel stays
+ * plain chat; the palette only recognizes a leading "/" and never sends a
+ * command to the model.
+ *
+ * Two kinds, modeled by where the handler does its work:
+ *  - CLIENT commands touch only the local UI (e.g. /help, /clear-view).
+ *  - SERVER commands call the API through the SDK (e.g. /clear, /compact,
+ *    /goal).
+ * Both are just `run(args, ctx)`; `ctx` exposes the client for server commands
+ * and the UI affordances (notice, openHelp, clearView, confirm) for both.
+ */
+/** A positional argument a command accepts after its name. */
+type SlashArg = {
+    name: string;
+    /** Enter runs only once every required arg is present; otherwise autocompletes. */
+    required?: boolean;
+    /** Closed value set (rendered as a hint; validated by the command itself). */
+    oneOf?: readonly string[];
+    description?: string;
+};
+/** Transient feedback surfaced in the composer (generalized error line). */
+type Notice = {
+    tone: "ok" | "error";
+    message: string;
+};
+/** Everything a command handler can reach. Assembled by the composer. */
+type CommandContext = {
+    /** SDK-shaped client for server commands. */
+    client: SessionClientLike;
+    workspaceId: string;
+    /** Null before a session exists (server commands should guard on this). */
+    sessionId: string | null;
+    status: SessionStatus$1 | null;
+    /** The operator's permissions on this workspace (gates command visibility). */
+    permissions: Permission[];
+    /** Surface a transient ok/error notice in the composer. */
+    notice: (notice: Notice) => void;
+    /** Open the in-composer /help panel (rendered from the registry). */
+    openHelp: () => void;
+    /**
+     * Reset only the LOCAL timeline view — no server call. Returns whether a
+     * view-reset affordance was actually wired (and thus had an effect): the host
+     * surface supplies one via the composer's `onClearView` prop, and consoles
+     * that don't (no resettable local timeline) get `false`. The /clear-view
+     * command uses this to avoid reporting a false "cleared" success on a no-op.
+     */
+    clearView: () => boolean;
+    /** Show the danger confirm bar; resolves true once the operator confirms. */
+    confirm: () => Promise<boolean>;
+};
+type CommandResult = {
+    status: "ok" | "error";
+    message?: string;
+    /**
+     * Keep the composer draft instead of clearing it on an ok result. Used when a
+     * command resolves to a no-op the operator may want to retry — e.g. canceling
+     * the /clear confirm bar returns ok (no error) but must NOT wipe the typed
+     * "/clear" draft. Default false: a successful command clears the draft.
+     */
+    keepDraft?: boolean;
+};
+type SlashCommand = {
+    /** Primary token after the slash (no leading "/"). */
+    name: string;
+    /** Alternate tokens that resolve to this command. */
+    aliases?: readonly string[];
+    description: string;
+    args?: readonly SlashArg[];
+    /** Required permission; the command is hidden from the palette without it. */
+    permission?: Permission;
+    /** Destructive — the palette shows a confirm bar before running. */
+    danger?: boolean;
+    /**
+     * Dynamic availability beyond the permission gate (e.g. hide a server command
+     * until a session exists). Returning false hides the command.
+     */
+    available?: (ctx: Pick<CommandContext, "sessionId" | "status" | "permissions">) => boolean;
+    /** Execute the command. Throwing is caught and surfaced as an error notice. */
+    run: (args: string[], ctx: CommandContext) => Promise<CommandResult> | CommandResult;
+};
+
+/**
+ * Context the composer supplies for command execution and visibility. The
+ * composer owns the UI affordances (notice/openHelp/clearView/confirm), so they
+ * are NOT part of this slice — the hook closes over them via `handlers`.
+ */
+type SlashCommandContext = Pick<CommandContext, "client" | "workspaceId" | "sessionId" | "status" | "permissions">;
+/**
+ * UI affordances the composer supplies. `confirm` differs from the registry-
+ * facing {@link CommandContext.confirm} (which takes no args): the composer's
+ * confirm receives the command being run so the confirm bar renders from that
+ * exact command's identity. The hook bridges the two in {@link buildContext}.
+ */
+type SlashCommandHandlers = Pick<CommandContext, "notice" | "openHelp" | "clearView"> & {
+    confirm: (command: SlashCommand) => Promise<boolean>;
+};
+type ConfirmState = {
+    command: SlashCommand;
+    /** Resolve the pending confirm() promise. */
+    resolve: (confirmed: boolean) => void;
+} | null;
+type UseSlashCommandsOptions = {
+    commands: readonly SlashCommand[];
+    context: SlashCommandContext | undefined;
+    handlers: SlashCommandHandlers;
+    /** The current composer draft. */
+    value: string;
+    /** Replace the composer draft (autocomplete writes through this). */
+    setValue: (value: string) => void;
+};
+type UseSlashCommandsResult = {
+    /** Whether the palette is open (a command token is being typed). */
+    open: boolean;
+    /**
+     * Whether the draft is a slash-command attempt (matches a registered command)
+     * — true even after Escape dismisses the popover. The composer blocks its send
+     * path while this holds so a command can't be delivered to the agent as chat.
+     */
+    isCommandDraft: boolean;
+    /** Commands shown for the current token + context, in display order. */
+    items: SlashCommand[];
+    /** Index into `items` of the highlighted row. */
+    highlight: number;
+    setHighlight: (index: number) => void;
+    /** The matched command once the name is closed by a space (arg-hint mode). */
+    activeCommand: SlashCommand | null;
+    /** The arg hint string for the active command (footer), or "". */
+    activeArgHint: string;
+    /**
+     * Key handler for the textarea. Returns true when it consumed the event
+     * (the composer must then NOT run its send path). Only consumes while open.
+     */
+    onKeyDown: (event: KeyboardEvent<HTMLTextAreaElement>) => boolean;
+    /** Run the highlighted command (or the active command in arg-hint mode). */
+    runHighlighted: () => Promise<void>;
+    /**
+     * Run the command at an explicitly chosen index (a pointer click on a row).
+     * Bypasses the exact-match token heuristic that runHighlighted uses for
+     * keyboard Enter, so an explicit click always runs the clicked command.
+     */
+    runAt: (index: number) => Promise<void>;
+    /** Autocomplete the highlighted command name + a trailing space. */
+    autocompleteHighlighted: () => void;
+};
+declare function useSlashCommands(options: UseSlashCommandsOptions): UseSlashCommandsResult;
+
+type ChatComposerProps = {
+    composer: ComposerState;
+    /** Canonical workstream control, separate from lifecycle status. */
+    effectiveControl?: EffectiveSessionControl | null | undefined;
+    /** Waiting prompts already ahead of a normal Send. */
+    queuedAheadCount?: number | undefined;
+    /** Whether broader Workspace Resume is authorized for this viewer. */
+    canControlWorkspace?: boolean | undefined;
+    /** Optional host routes used to navigate from effective Pause blockers. */
+    controlLinks?: {
+        workspaceHref?: string | undefined;
+        sessionHref?: ((sessionId: string) => string) | undefined;
+    } | undefined;
+    placeholder?: string | undefined;
+    disabled?: boolean | undefined;
+    autoFocus?: boolean | undefined;
+    /** Replaces the default keyboard hint under the field. */
+    hint?: string | undefined;
+    /** App controls (model picker, attach button, ...) in the footer row, replacing the hint. */
+    controlsStart?: ReactNode | undefined;
+    /** Content rendered above the textarea, inside the field chrome (e.g. attachment chips). */
+    header?: ReactNode | undefined;
+    /** Paste hook on the textarea (e.g. paste-image-to-attach). */
+    onPaste?: ((event: ClipboardEvent<HTMLTextAreaElement>) => void) | undefined;
+    /**
+     * Opt-in file attachments. When supplied (e.g. from {@link useFileAttachments}),
+     * the composer renders a built-in attach button (prepended to `controlsStart`),
+     * an attachment-chips strip (above the textarea, before any host `header`),
+     * routes paste through `addFromPaste` (image/* filter lives in the hook), and
+     * gates send while `uploading` so a message never departs without its files.
+     * Absent → no attachment UI renders and the composer behaves exactly as before.
+     */
+    attachments?: UseFileAttachmentsResult | undefined;
+    /**
+     * Opt-in model picker. When supplied (e.g. from {@link useAvailableModels}),
+     * the composer renders a {@link ModelPicker} at the start of `controlsStart`
+     * so the operator can choose which host-exposed model serves the next message.
+     * The host owns the selection (`selectedModel`/`onSelectModel`) and is
+     * responsible for threading it into the composer's `sendExtras` (typically
+     * `useComposer({ sendExtras: () => ({ model }) })`) so `composeSendInput`
+     * carries it. Absent → no picker renders and the composer behaves as before.
+     */
+    models?: ClientModel[] | undefined;
+    /** The currently selected model id (the picker's controlled value). */
+    selectedModel?: string | undefined;
+    /** Called with the chosen model id when the operator picks one. */
+    onSelectModel?: ((modelId: string) => void) | undefined;
+    className?: string | undefined;
+    /**
+     * Slash-command palette. Defaults to the built-in {@link defaultCommands};
+     * apps concat their own. Backward-compatible: when `commandContext` is absent
+     * the palette is inert and behavior is identical to before.
+     */
+    commands?: readonly SlashCommand[] | undefined;
+    /**
+     * Wiring the palette needs to run server commands and gate visibility. The
+     * composer supplies notice/openHelp/clearView/confirm internally.
+     */
+    commandContext?: SlashCommandContext | undefined;
+    /** Reset the local timeline view (the /clear-view command target). */
+    onClearView?: (() => void) | undefined;
+};
+declare const OPEN_WORKSTREAM_CONTROL_EVENT = "opengeni:open-workstream-control";
+/**
+ * The chat composer — the only human-to-agent input surface. Plain chat in,
+ * everything else is the agent's job. Enter sends, Shift+Enter breaks the
+ * line, and the stop control appears while a turn is running (sending while
+ * running is legitimate steering, so send stays available too).
+ *
+ * Typing a leading "/" opens the slash-command palette — SESSION/OPERATOR
+ * controls (clear, compact, pause goal, help), never a structured channel to
+ * the agent. The palette is purely additive: with no `commandContext` it is
+ * inert and the composer behaves exactly as before.
+ */
+declare function ChatComposer({ composer, effectiveControl, queuedAheadCount, canControlWorkspace, controlLinks, placeholder, disabled, autoFocus, hint, controlsStart, header, onPaste, attachments, models, selectedModel, onSelectModel, className, commands, commandContext, onClearView, }: ChatComposerProps): react_jsx_runtime.JSX.Element;
+
 /** Event types that change the session goal (set/updated/completed/paused/...). */
 declare function isGoalEvent(event: Pick<SessionEvent, "type">): boolean;
 type UseGoalOptions = ClientOverride & SessionEventFeedOptions & {
@@ -824,8 +1086,8 @@ declare function useGoal(sessionId: string | null | undefined, options?: UseGoal
 
 type UseSessionControlOptions = ClientOverride;
 type UseSessionControlResult = {
-    pause: (reason?: string) => Promise<SessionEvent | null>;
-    resume: (reason?: string) => Promise<SessionEvent | null>;
+    pause: (reason?: string) => Promise<SessionControlResponse | null>;
+    resume: (reason?: string) => Promise<SessionControlResponse | null>;
     controlling: boolean;
     /** Approve a pending `requires_action` approval. */
     approve: (approvalId: string, message?: string) => Promise<SessionEvent | null>;
@@ -1710,90 +1972,6 @@ declare function approvalsFromRequiresAction(payload: unknown): PendingApproval[
 /** The approvals still awaiting a decision after replaying `events` in order. */
 declare function projectPendingApprovals(events: SessionEvent[]): PendingApproval[];
 
-/**
- * The slash-command registry. A command is a SESSION / OPERATOR control — an
- * action on the session or the UI (clear, compact, pause the goal, show help) —
- * NOT a structured way to talk to the agent. The human↔agent channel stays
- * plain chat; the palette only recognizes a leading "/" and never sends a
- * command to the model.
- *
- * Two kinds, modeled by where the handler does its work:
- *  - CLIENT commands touch only the local UI (e.g. /help, /clear-view).
- *  - SERVER commands call the API through the SDK (e.g. /clear, /compact,
- *    /goal).
- * Both are just `run(args, ctx)`; `ctx` exposes the client for server commands
- * and the UI affordances (notice, openHelp, clearView, confirm) for both.
- */
-/** A positional argument a command accepts after its name. */
-type SlashArg = {
-    name: string;
-    /** Enter runs only once every required arg is present; otherwise autocompletes. */
-    required?: boolean;
-    /** Closed value set (rendered as a hint; validated by the command itself). */
-    oneOf?: readonly string[];
-    description?: string;
-};
-/** Transient feedback surfaced in the composer (generalized error line). */
-type Notice = {
-    tone: "ok" | "error";
-    message: string;
-};
-/** Everything a command handler can reach. Assembled by the composer. */
-type CommandContext = {
-    /** SDK-shaped client for server commands. */
-    client: SessionClientLike;
-    workspaceId: string;
-    /** Null before a session exists (server commands should guard on this). */
-    sessionId: string | null;
-    status: SessionStatus$1 | null;
-    /** The operator's permissions on this workspace (gates command visibility). */
-    permissions: Permission[];
-    /** Surface a transient ok/error notice in the composer. */
-    notice: (notice: Notice) => void;
-    /** Open the in-composer /help panel (rendered from the registry). */
-    openHelp: () => void;
-    /**
-     * Reset only the LOCAL timeline view — no server call. Returns whether a
-     * view-reset affordance was actually wired (and thus had an effect): the host
-     * surface supplies one via the composer's `onClearView` prop, and consoles
-     * that don't (no resettable local timeline) get `false`. The /clear-view
-     * command uses this to avoid reporting a false "cleared" success on a no-op.
-     */
-    clearView: () => boolean;
-    /** Show the danger confirm bar; resolves true once the operator confirms. */
-    confirm: () => Promise<boolean>;
-};
-type CommandResult = {
-    status: "ok" | "error";
-    message?: string;
-    /**
-     * Keep the composer draft instead of clearing it on an ok result. Used when a
-     * command resolves to a no-op the operator may want to retry — e.g. canceling
-     * the /clear confirm bar returns ok (no error) but must NOT wipe the typed
-     * "/clear" draft. Default false: a successful command clears the draft.
-     */
-    keepDraft?: boolean;
-};
-type SlashCommand = {
-    /** Primary token after the slash (no leading "/"). */
-    name: string;
-    /** Alternate tokens that resolve to this command. */
-    aliases?: readonly string[];
-    description: string;
-    args?: readonly SlashArg[];
-    /** Required permission; the command is hidden from the palette without it. */
-    permission?: Permission;
-    /** Destructive — the palette shows a confirm bar before running. */
-    danger?: boolean;
-    /**
-     * Dynamic availability beyond the permission gate (e.g. hide a server command
-     * until a session exists). Returning false hides the command.
-     */
-    available?: (ctx: Pick<CommandContext, "sessionId" | "status" | "permissions">) => boolean;
-    /** Execute the command. Throwing is caught and surfaced as an error notice. */
-    run: (args: string[], ctx: CommandContext) => Promise<CommandResult> | CommandResult;
-};
-
 /**
  * Parse a composer value into a command name + the rest. A command is
  * recognized ONLY when the value's first character is "/" (the start token);
@@ -1833,71 +2011,6 @@ declare function firstMissingRequiredArg(command: SlashCommand, args: string[]):
  */
 declare const defaultCommands: readonly SlashCommand[];
 
-/**
- * Context the composer supplies for command execution and visibility. The
- * composer owns the UI affordances (notice/openHelp/clearView/confirm), so they
- * are NOT part of this slice — the hook closes over them via `handlers`.
- */
-type SlashCommandContext = Pick<CommandContext, "client" | "workspaceId" | "sessionId" | "status" | "permissions">;
-/**
- * UI affordances the composer supplies. `confirm` differs from the registry-
- * facing {@link CommandContext.confirm} (which takes no args): the composer's
- * confirm receives the command being run so the confirm bar renders from that
- * exact command's identity. The hook bridges the two in {@link buildContext}.
- */
-type SlashCommandHandlers = Pick<CommandContext, "notice" | "openHelp" | "clearView"> & {
-    confirm: (command: SlashCommand) => Promise<boolean>;
-};
-type ConfirmState = {
-    command: SlashCommand;
-    /** Resolve the pending confirm() promise. */
-    resolve: (confirmed: boolean) => void;
-} | null;
-type UseSlashCommandsOptions = {
-    commands: readonly SlashCommand[];
-    context: SlashCommandContext | undefined;
-    handlers: SlashCommandHandlers;
-    /** The current composer draft. */
-    value: string;
-    /** Replace the composer draft (autocomplete writes through this). */
-    setValue: (value: string) => void;
-};
-type UseSlashCommandsResult = {
-    /** Whether the palette is open (a command token is being typed). */
-    open: boolean;
-    /**
-     * Whether the draft is a slash-command attempt (matches a registered command)
-     * — true even after Escape dismisses the popover. The composer blocks its send
-     * path while this holds so a command can't be delivered to the agent as chat.
-     */
-    isCommandDraft: boolean;
-    /** Commands shown for the current token + context, in display order. */
-    items: SlashCommand[];
-    /** Index into `items` of the highlighted row. */
-    highlight: number;
-    setHighlight: (index: number) => void;
-    /** The matched command once the name is closed by a space (arg-hint mode). */
-    activeCommand: SlashCommand | null;
-    /** The arg hint string for the active command (footer), or "". */
-    activeArgHint: string;
-    /**
-     * Key handler for the textarea. Returns true when it consumed the event
-     * (the composer must then NOT run its send path). Only consumes while open.
-     */
-    onKeyDown: (event: KeyboardEvent<HTMLTextAreaElement>) => boolean;
-    /** Run the highlighted command (or the active command in arg-hint mode). */
-    runHighlighted: () => Promise<void>;
-    /**
-     * Run the command at an explicitly chosen index (a pointer click on a row).
-     * Bypasses the exact-match token heuristic that runHighlighted uses for
-     * keyboard Enter, so an explicit click always runs the clicked command.
-     */
-    runAt: (index: number) => Promise<void>;
-    /** Autocomplete the highlighted command name + a trailing space. */
-    autocompleteHighlighted: () => void;
-};
-declare function useSlashCommands(options: UseSlashCommandsOptions): UseSlashCommandsResult;
-
 type CommandPaletteProps = {
     open: boolean;
     items: SlashCommand[];
@@ -1919,72 +2032,6 @@ type CommandPaletteProps = {
  */
 declare function CommandPalette({ open, items, highlight, onHighlight, onRun, argHintText, listboxId, }: CommandPaletteProps): react_jsx_runtime.JSX.Element;
 
-type ChatComposerProps = {
-    composer: ComposerState;
-    /** Current session status; shows the stop control while a turn runs. */
-    status?: SessionStatus$1 | null | undefined;
-    placeholder?: string | undefined;
-    disabled?: boolean | undefined;
-    autoFocus?: boolean | undefined;
-    /** Replaces the default keyboard hint under the field. */
-    hint?: string | undefined;
-    /** App controls (model picker, attach button, ...) in the footer row, replacing the hint. */
-    controlsStart?: ReactNode | undefined;
-    /** Content rendered above the textarea, inside the field chrome (e.g. attachment chips). */
-    header?: ReactNode | undefined;
-    /** Paste hook on the textarea (e.g. paste-image-to-attach). */
-    onPaste?: ((event: ClipboardEvent<HTMLTextAreaElement>) => void) | undefined;
-    /**
-     * Opt-in file attachments. When supplied (e.g. from {@link useFileAttachments}),
-     * the composer renders a built-in attach button (prepended to `controlsStart`),
-     * an attachment-chips strip (above the textarea, before any host `header`),
-     * routes paste through `addFromPaste` (image/* filter lives in the hook), and
-     * gates send while `uploading` so a message never departs without its files.
-     * Absent → no attachment UI renders and the composer behaves exactly as before.
-     */
-    attachments?: UseFileAttachmentsResult | undefined;
-    /**
-     * Opt-in model picker. When supplied (e.g. from {@link useAvailableModels}),
-     * the composer renders a {@link ModelPicker} at the start of `controlsStart`
-     * so the operator can choose which host-exposed model serves the next message.
-     * The host owns the selection (`selectedModel`/`onSelectModel`) and is
-     * responsible for threading it into the composer's `sendExtras` (typically
-     * `useComposer({ sendExtras: () => ({ model }) })`) so `composeSendInput`
-     * carries it. Absent → no picker renders and the composer behaves as before.
-     */
-    models?: ClientModel[] | undefined;
-    /** The currently selected model id (the picker's controlled value). */
-    selectedModel?: string | undefined;
-    /** Called with the chosen model id when the operator picks one. */
-    onSelectModel?: ((modelId: string) => void) | undefined;
-    className?: string | undefined;
-    /**
-     * Slash-command palette. Defaults to the built-in {@link defaultCommands};
-     * apps concat their own. Backward-compatible: when `commandContext` is absent
-     * the palette is inert and behavior is identical to before.
-     */
-    commands?: readonly SlashCommand[] | undefined;
-    /**
-     * Wiring the palette needs to run server commands and gate visibility. The
-     * composer supplies notice/openHelp/clearView/confirm internally.
-     */
-    commandContext?: SlashCommandContext | undefined;
-    /** Reset the local timeline view (the /clear-view command target). */
-    onClearView?: (() => void) | undefined;
-};
-/**
- * The chat composer — the only human-to-agent input surface. Plain chat in,
- * everything else is the agent's job. Enter sends, Shift+Enter breaks the
- * line, and the stop control appears while a turn is running (sending while
- * running is legitimate steering, so send stays available too).
- *
- * Typing a leading "/" opens the slash-command palette — SESSION/OPERATOR
- * controls (clear, compact, pause goal, help), never a structured channel to
- * the agent. The palette is purely additive: with no `commandContext` it is
- * inert and the composer behaves exactly as before.
- */
-declare function ChatComposer({ composer, status, placeholder, disabled, autoFocus, hint, controlsStart, header, onPaste, attachments, models, selectedModel, onSelectModel, className, commands, commandContext, onClearView, }: ChatComposerProps): react_jsx_runtime.JSX.Element;
-
 type ModelPickerProps = {
     /** The host-exposed models to choose from (typically {@link useAvailableModels}). */
     models: ClientModel[];
@@ -2466,6 +2513,14 @@ type SandboxFilesProps = {
      *  dock warms the box on this so the save lands fast; opening/reading never fires
      *  it. Browsing the tree/diff must not warm a box. */
     onEditIntent?: (() => void) | undefined;
+    /** A guarded diff path routed here by the parent workspace. */
+    requestedPath?: string | undefined;
+    /** Identity for one guarded-file request. Increment this when the same path is
+     *  deliberately requested again; it also lets a pending request be consumed
+     *  without overriding later manual tree navigation. Defaults to the path. */
+    requestedPathRequestId?: string | number | undefined;
+    /** False while the parent is waking a cold sandbox for `requestedPath`. */
+    requestedPathReady?: boolean | undefined;
     themeType?: "dark" | "light" | undefined;
     className?: string | undefined;
 };
@@ -2476,7 +2531,7 @@ type SandboxFilesProps = {
  * surface deliberately does NOT replicate the changed-files list, and does not
  * diff here — one job per tab). The agent commits; the human reviews.
  */
-declare function SandboxFiles({ files, git, fileSystemAvailable, usePierre, editable, onEditIntent, themeType, className, }: SandboxFilesProps): react_jsx_runtime.JSX.Element;
+declare function SandboxFiles({ files, git, fileSystemAvailable, usePierre, editable, onEditIntent, requestedPath, requestedPathRequestId, requestedPathReady, themeType, className, }: SandboxFilesProps): react_jsx_runtime.JSX.Element;
 
 type DesktopViewerProps = {
     /** The desktop cell of the negotiated capabilities (`capabilities.DesktopStream`). */
@@ -2610,11 +2665,9 @@ declare const WORKBENCH_TAB_FILES = "files";
  * "changes exist → Changes, else Files" needs zero machine round-trips. A host
  * `override` (e.g. a landing "run" tab) wins when supplied.
  *
- * NOTE: the dock no longer uses this for its default tab — `<SandboxWorkspace>`
- * now derives the default from its OWN capture fetch (`useWorkspaceCapture`'s
- * `fileCount`), so a pure embedder needs no events-at-mount contract (Refinement
- * 2). This remains exported as a standalone helper for hosts that already hold
- * the event log and want the same decision without the capture fetch.
+ * `<SandboxWorkspace>` uses this only as an optional early hint after its own
+ * capture GET reports no durable capture. A pure embedder needs no events-at-mount
+ * contract: it falls through to authoritative live Git instead.
  */
 declare function initialWorkspaceTab(events: SessionEvent[] | undefined, override?: string | null): string;
 type WorkspaceMachine = {
@@ -2631,21 +2684,27 @@ type UseSandboxWorkspaceTabsOptions = ClientOverride & {
     sessionId: string;
     /** Live event log (usually `useSessionEvents().events`). */
     events: SessionEvent[];
-    /** Override the capture-driven default tab (e.g. a host landing tab id). When
-     *  omitted the workbench picks Changes-vs-Files from its own capture fetch. */
+    /** Override the source-driven default tab (e.g. a host landing tab id). When
+     *  omitted the workbench picks Changes-vs-Files from capture or live Git. */
     initialTab?: string | null | undefined;
     /** Host-routed notifications (mutation errors, desktop-consent failures). The
      *  package never imports a toast library — the host decides how to surface. */
     onNotify?: ((notification: WorkspaceNotification) => void) | undefined;
+    /** File requested by a Changes guard. The Files surface defers the read until
+     *  the sandbox is live, then reveals this path. */
+    requestedFilePath?: string | null | undefined;
+    /** Unique identity for `requestedFilePath`, including repeated requests for the
+     *  same path. */
+    requestedFileRequestId?: string | number | null | undefined;
+    /** Route a guarded diff into the host's Files tab. */
+    onOpenFile?: ((path: string) => void) | undefined;
 };
 type UseSandboxWorkspaceTabsResult = {
     /** Changes | Files | Terminal | Desktop (capability-gated where noted). */
     tabs: WorkspaceTab[];
-    /** The capture-driven default tab: Changes when the session has changes, else
-     *  Files (a host `initialTab` overrides). null during the brief window before the
-     *  capture GET first resolves (and no host override was given) — consumers render
-     *  their dock's own first-tab fallback until it latches, which it does ONCE, so it
-     *  never causes a post-render switch. */
+    /** The source-driven default tab: Changes when the first authoritative capture
+     *  or live Git result has changes, else Files (a host `initialTab` overrides).
+     *  null while that source resolves; the choice latches once. */
     defaultTab: string | null;
     /** The machine-state model for the dock-header chip. */
     machine: WorkspaceMachine;
@@ -2667,7 +2726,7 @@ type SandboxWorkspaceProps = ClientOverride & {
     /** Host tabs injected AFTER the workbench tabs (e.g. a "Debug" tab). */
     trailingTabs?: WorkspaceTab[] | undefined;
     /** Override the pre-paint default tab (e.g. a host landing tab id). When
-     *  omitted the workbench decides Changes-vs-Files from local capture stats. */
+     *  omitted the workbench decides from capture, then live Git when no capture exists. */
     initialTab?: string | undefined;
     /** Host-routed notifications (no toast dependency in the package). */
     onNotify?: ((notification: WorkspaceNotification) => void) | undefined;
@@ -2823,4 +2882,4 @@ declare function isCreditExhaustion(input: {
  */
 declare function humanizeFailureReason(reason: string | null): string | null;
 
-export { ActivityDisclosure, type ActivityDisclosureProps, type ActivityItem, ActivityRail, type ActivityRailProps, type AgentMessageItem, type ApplyPatchOperation, type AuthNeededItem, BodyNote, CREDIT_EXHAUSTION_MESSAGE, ChatComposer, type ChatComposerProps, ClientOverride, CodeEditor, type CodeEditorProps, type CodexAccountsClientLike, type CommandContext, CommandPalette, type CommandPaletteProps, type CommandResult, type ComposerMode, type ComposerSendExtras, type ComposerState, type ConfirmState, type CreateToolRegistryOptions, type DeriveMachineChipInput, DesktopViewer, type DesktopViewerProps, type DesktopWebSocketFactory, type DesktopWebSocketLike, type DiffTheme, DiffView, type DiffViewProps, type DisclosureChip, DisclosureDefaultsProvider, FILE_ONLY_MESSAGE_TEXT, type FileAttachment, FileBrowser, type FileBrowserProps, type FileTreeNode, type FileTreeStatus, FleetTile, type FleetTileProps, type GoalItem, LightboxProvider, type MachineChip, type MachineChipState, Markdown, type MarkdownProps, MediaEmpty, MediaSkeleton, MessageTimeline, type MessageTimelineProps, ModelPicker, type ModelPickerProps, type Notice, type NoticeItem, type ParsedCommandLine, PayloadBlock, type PendingApproval, PierreDiff, type PierreDiffProps, PierreFile, type PierreFileProps, type ReasoningItem, SESSION_STATUS_META, SandboxFiles, type SandboxFilesProps, type SandboxItem, SandboxTerminal, type SandboxTerminalProps, SandboxWorkspace, type SandboxWorkspaceProps, ScreenshotFigure, type SessionCapabilitiesState, SessionClientLike, type SessionEventsConnectionState, SessionStatus, type SessionStatusItem, type SessionStatusMeta, type SessionStatusProps, type SlashArg, type SlashCommand, type SlashCommandContext, type SlashCommandHandlers, StatusDot, type StatusDotProps, TermBlock, type TerminalChunk, type TerminalStreamStatus, Thumbnail, type TimelineGroup, type TimelineItem, TimelineRow, type ToolCallItem, type ToolRegistry, type ToolRegistryEntry, type ToolRenderer, type ToolRendererProps, type TurnEndItem, type TurnOutcome, TurnSummary, type TurnSummaryProps, type UseAvailableModelsOptions, type UseAvailableModelsResult, type UseBillingUsageOptions, type UseBillingUsageResult, type UseCodexAccountsOptions, type UseCodexAccountsResult, type UseComposerOptions, type UseDesktopStreamOptions, type UseDesktopStreamResult, type UseEnvironmentsOptions, type UseEnvironmentsResult, type UseFileAttachmentsOptions, type UseFileAttachmentsResult, type UseGoalOptions, type UseGoalResult, type UseMachineChipOptions, type UsePacksOptions, type UsePacksResult, type UseRelayFrameStreamOptions, type UseRelayFrameStreamResult, type UseRigChangesOptions, type UseRigChangesResult, type UseRigOptions, type UseRigResult, type UseRigVersionsOptions, type UseRigVersionsResult, type UseRigsOptions, type UseRigsResult, type UseSandboxFilesOptions, type UseSandboxFilesResult, type UseSandboxGitOptions, type UseSandboxGitResult, type UseSandboxTerminalOptions, type UseSandboxTerminalResult, type UseSandboxWorkspaceTabsOptions, type UseSandboxWorkspaceTabsResult, type UseScheduledTasksOptions, type UseScheduledTasksResult, type UseSessionCapabilitiesOptions, type UseSessionCapabilitiesResult, type UseSessionControlOptions, type UseSessionControlResult, type UseSessionEventsOptions, type UseSessionEventsResult, type UseSessionLineageOptions, type UseSessionLineageResult, type UseSessionOptions, type UseSessionResult, type UseSlashCommandsOptions, type UseSlashCommandsResult, type UseTerminalStreamOptions, type UseTerminalStreamResult, type UseTurnQueueOptions, type UseTurnQueueResult, type UseVariableSetsOptions, type UseVariableSetsResult, type UseWorkspaceCaptureOptions, type UseWorkspaceCaptureResult, type UseWorkspaceEditOptions, type UseWorkspaceEditResult, type UseWorkspaceSessionsOptions, type UseWorkspaceSessionsResult, type UseWorkspacesOptions, type UseWorkspacesResult, type UserMessageItem, WORKBENCH_TAB_CHANGES, WORKBENCH_TAB_FILES, type WorkerItem, WorkspaceDock, type WorkspaceDockProps, type WorkspaceEditConflict, type WorkspaceEditState, type WorkspaceMachine, type WorkspaceNotification, type WorkspaceTab, type XtermTheme, applyPatchOps, approvalsFromRequiresAction, argHint, buildTimeline, cn, composeSendInput, controlCaret, createDefaultToolRegistry, createToolRegistry, creditExhaustedFromEvents, defaultCommands, defaultToolRegistry, deriveMachineChip, execTruncated, extractSessionRef, filterCommands, firstMissingRequiredArg, formatAsOf, formatBytes, formatRelativeTime, gitFileDiffToPatch, groupTimeline, hasPermission, humanizeFailureReason, initialWorkspaceTab, isApplyPatch, isCodexAccountEvent, isCreditExhaustion, isExecSessionLostBanner, isGoalEvent, isLineageRefreshEvent, isTitleEvent, isTurnQueueEvent, languageForPath, looksBinary, matchCommand, parseCommandLine, parseExecBannerSessionId, parseToolArgs, projectPendingApprovals, rawTypeOf, redactSecrets, sandboxCommandExitCode, sessionDisplayTitle, sessionStatusFromEvents, shouldSubmitOnKey, stringifyPayload, stripExecBanner, tailPeek, toolDisplayName, truncate, tryParseJson, unwrapMcpOutput, useAvailableModels, useBillingUsage, useCodexAccounts, useComposer, useDesktopStream, useEnvironments, useFileAttachments, useGoal, useLightbox, useLightboxOptional, useMachineChip, usePacks, useRelayFrameStream, useRig, useRigChanges, useRigVersions, useRigs, useSandboxFiles, useSandboxGit, useSandboxTerminal, useSandboxWorkspaceTabs, useScheduledTasks, useSession, useSessionCapabilities, useSessionControl, useSessionEvents, useSessionLineage, useSlashCommands, useTerminalStream, useTurnQueue, useVariableSets, useWorkspaceCapture, useWorkspaceEdit, useWorkspaceSessions, useWorkspaces, v4aToGitFileDiff, xtermThemeFromTokens };
+export { ActivityDisclosure, type ActivityDisclosureProps, type ActivityItem, ActivityRail, type ActivityRailProps, type AgentMessageItem, type ApplyPatchOperation, type AuthNeededItem, BodyNote, CREDIT_EXHAUSTION_MESSAGE, ChatComposer, type ChatComposerProps, ClientOverride, CodeEditor, type CodeEditorProps, type CodexAccountsClientLike, type CommandContext, CommandPalette, type CommandPaletteProps, type CommandResult, type ComposerSendExtras, type ComposerState, type ConfirmState, type CreateToolRegistryOptions, type DeriveMachineChipInput, DesktopViewer, type DesktopViewerProps, type DesktopWebSocketFactory, type DesktopWebSocketLike, type DiffTheme, DiffView, type DiffViewProps, type DisclosureChip, DisclosureDefaultsProvider, FILE_ONLY_MESSAGE_TEXT, type FileAttachment, FileBrowser, type FileBrowserProps, type FileTreeNode, type FileTreeStatus, FleetTile, type FleetTileProps, type GoalItem, LightboxProvider, type MachineChip, type MachineChipState, Markdown, type MarkdownProps, MediaEmpty, MediaSkeleton, MessageTimeline, type MessageTimelineProps, ModelPicker, type ModelPickerProps, type Notice, type NoticeItem, OPEN_WORKSTREAM_CONTROL_EVENT, type ParsedCommandLine, PayloadBlock, type PendingApproval, PierreDiff, type PierreDiffProps, PierreFile, type PierreFileProps, type QueueMutationKind, QueueSurface, type QueueSurfaceProps, type ReasoningItem, SESSION_STATUS_META, SandboxFiles, type SandboxFilesProps, type SandboxItem, SandboxTerminal, type SandboxTerminalProps, SandboxWorkspace, type SandboxWorkspaceProps, ScreenshotFigure, type SessionCapabilitiesState, SessionClientLike, type SessionEventsConnectionState, SessionStatus, type SessionStatusItem, type SessionStatusMeta, type SessionStatusProps, type SlashArg, type SlashCommand, type SlashCommandContext, type SlashCommandHandlers, StatusDot, type StatusDotProps, TermBlock, type TerminalChunk, type TerminalStreamStatus, Thumbnail, type TimelineGroup, type TimelineItem, TimelineRow, type ToolCallItem, type ToolRegistry, type ToolRegistryEntry, type ToolRenderer, type ToolRendererProps, type TurnEndItem, type TurnOutcome, TurnSummary, type TurnSummaryProps, type UseAvailableModelsOptions, type UseAvailableModelsResult, type UseBillingUsageOptions, type UseBillingUsageResult, type UseCodexAccountsOptions, type UseCodexAccountsResult, type UseComposerOptions, type UseDesktopStreamOptions, type UseDesktopStreamResult, type UseEnvironmentsOptions, type UseEnvironmentsResult, type UseFileAttachmentsOptions, type UseFileAttachmentsResult, type UseGoalOptions, type UseGoalResult, type UseMachineChipOptions, type UsePacksOptions, type UsePacksResult, type UseRelayFrameStreamOptions, type UseRelayFrameStreamResult, type UseRigChangesOptions, type UseRigChangesResult, type UseRigOptions, type UseRigResult, type UseRigVersionsOptions, type UseRigVersionsResult, type UseRigsOptions, type UseRigsResult, type UseSandboxFilesOptions, type UseSandboxFilesResult, type UseSandboxGitOptions, type UseSandboxGitResult, type UseSandboxTerminalOptions, type UseSandboxTerminalResult, type UseSandboxWorkspaceTabsOptions, type UseSandboxWorkspaceTabsResult, type UseScheduledTasksOptions, type UseScheduledTasksResult, type UseSessionCapabilitiesOptions, type UseSessionCapabilitiesResult, type UseSessionControlOptions, type UseSessionControlResult, type UseSessionEventsOptions, type UseSessionEventsResult, type UseSessionLineageOptions, type UseSessionLineageResult, type UseSessionOptions, type UseSessionResult, type UseSlashCommandsOptions, type UseSlashCommandsResult, type UseTerminalStreamOptions, type UseTerminalStreamResult, type UseTurnQueueOptions, type UseTurnQueueResult, type UseVariableSetsOptions, type UseVariableSetsResult, type UseWorkspaceCaptureOptions, type UseWorkspaceCaptureResult, type UseWorkspaceEditOptions, type UseWorkspaceEditResult, type UseWorkspaceSessionsOptions, type UseWorkspaceSessionsResult, type UseWorkspacesOptions, type UseWorkspacesResult, type UserMessageItem, WORKBENCH_TAB_CHANGES, WORKBENCH_TAB_FILES, type WorkerItem, WorkspaceDock, type WorkspaceDockProps, type WorkspaceEditConflict, type WorkspaceEditState, type WorkspaceMachine, type WorkspaceNotification, type WorkspaceTab, type XtermTheme, applyPatchOps, approvalsFromRequiresAction, argHint, buildTimeline, cn, composeSendInput, controlCaret, createDefaultToolRegistry, createToolRegistry, creditExhaustedFromEvents, defaultCommands, defaultToolRegistry, deriveMachineChip, execTruncated, extractSessionRef, filterCommands, firstMissingRequiredArg, formatAsOf, formatBytes, formatRelativeTime, gitFileDiffToPatch, groupTimeline, hasPermission, humanizeFailureReason, initialWorkspaceTab, isApplyPatch, isCodexAccountEvent, isCreditExhaustion, isExecSessionLostBanner, isGoalEvent, isLineageRefreshEvent, isTitleEvent, isTurnQueueEvent, languageForPath, looksBinary, matchCommand, parseCommandLine, parseExecBannerSessionId, parseToolArgs, projectPendingApprovals, rawTypeOf, redactSecrets, sandboxCommandExitCode, sessionDisplayTitle, sessionStatusFromEvents, shouldSteerOnKey, shouldSubmitOnKey, stringifyPayload, stripExecBanner, tailPeek, toolDisplayName, truncate, tryParseJson, unwrapMcpOutput, useAvailableModels, useBillingUsage, useCodexAccounts, useComposer, useDesktopStream, useEnvironments, useFileAttachments, useGoal, useLightbox, useLightboxOptional, useMachineChip, usePacks, useRelayFrameStream, useRig, useRigChanges, useRigVersions, useRigs, useSandboxFiles, useSandboxGit, useSandboxTerminal, useSandboxWorkspaceTabs, useScheduledTasks, useSession, useSessionCapabilities, useSessionControl, useSessionEvents, useSessionLineage, useSlashCommands, useTerminalStream, useTurnQueue, useVariableSets, useWorkspaceCapture, useWorkspaceEdit, useWorkspaceSessions, useWorkspaces, v4aToGitFileDiff, xtermThemeFromTokens };