@opengeni/react 0.3.0 → 0.4.0

package/src/index.ts

@@ -46,6 +46,37 @@ export type { UseBillingUsageOptions, UseBillingUsageResult } from "./hooks/use-
 export { useAvailableModels } from "./hooks/use-available-models";
 export type { UseAvailableModelsOptions, UseAvailableModelsResult } from "./hooks/use-available-models";
 
+// Sandbox surfacing (Phase 5): capability negotiation + terminal/files/diff/desktop
+export { useSessionCapabilities } from "./hooks/use-session-capabilities";
+export type {
+  SessionCapabilitiesState,
+  UseSessionCapabilitiesOptions,
+  UseSessionCapabilitiesResult,
+} from "./hooks/use-session-capabilities";
+export { useDesktopStream } from "./hooks/use-desktop-stream";
+export type { UseDesktopStreamOptions, UseDesktopStreamResult } from "./hooks/use-desktop-stream";
+export { useTerminalStream } from "./hooks/use-terminal-stream";
+export type {
+  TerminalStreamStatus,
+  UseTerminalStreamOptions,
+  UseTerminalStreamResult,
+} from "./hooks/use-terminal-stream";
+export { useSandboxTerminal } from "./hooks/use-sandbox-terminal";
+export type {
+  TerminalChunk,
+  UseSandboxTerminalOptions,
+  UseSandboxTerminalResult,
+} from "./hooks/use-sandbox-terminal";
+export { useSandboxFiles } from "./hooks/use-sandbox-files";
+export type {
+  FileTreeNode,
+  FileTreeStatus,
+  UseSandboxFilesOptions,
+  UseSandboxFilesResult,
+} from "./hooks/use-sandbox-files";
+export { useSandboxGit } from "./hooks/use-sandbox-git";
+export type { UseSandboxGitOptions, UseSandboxGitResult } from "./hooks/use-sandbox-git";
+
 // Pending-approvals projection
 export { approvalsFromRequiresAction, projectPendingApprovals } from "./approvals";
 export type { PendingApproval } from "./approvals";
@@ -53,13 +84,13 @@ export type { PendingApproval } from "./approvals";
 // Timeline projection
 export {
   buildTimeline,
-  compactPayloadPreview,
   extractSessionRef,
   groupTimeline,
   sessionStatusFromEvents,
   toolDisplayName,
 } from "./timeline";
 export type {
+  ActivityItem,
   AgentMessageItem,
   GoalItem,
   NoticeItem,
@@ -73,6 +104,60 @@ export type {
   WorkerItem,
 } from "./timeline";
 
+// Tool-renderer registry + the per-tool renderers (the timeline's extension API)
+export { createDefaultToolRegistry, createToolRegistry, defaultToolRegistry, rawTypeOf } from "./timeline";
+export type {
+  CreateToolRegistryOptions,
+  ToolRegistry,
+  ToolRegistryEntry,
+  ToolRenderer,
+  ToolRendererProps,
+} from "./timeline";
+
+// Timeline rendering primitives + the screenshot lightbox (compose custom renderers)
+export {
+  ActivityDisclosure,
+  ActivityRail,
+  BodyNote,
+  DisclosureDefaultsProvider,
+  LightboxProvider,
+  MediaEmpty,
+  MediaSkeleton,
+  PayloadBlock,
+  ScreenshotFigure,
+  TermBlock,
+  Thumbnail,
+  TurnSummary,
+  useLightbox,
+  useLightboxOptional,
+} from "./timeline";
+export type {
+  ActivityDisclosureProps,
+  ActivityRailProps,
+  DisclosureChip,
+  TurnOutcome,
+  TurnSummaryProps,
+} from "./timeline";
+
+// Pure provider-shape parsers (exec banner, V4A diff, secret redaction, …)
+export {
+  applyPatchOps,
+  controlCaret,
+  execTruncated,
+  isApplyPatch,
+  isExecSessionLostBanner,
+  looksBinary,
+  parseExecBannerSessionId,
+  parseToolArgs,
+  redactSecrets,
+  sandboxCommandExitCode,
+  stripExecBanner,
+  tailPeek,
+  unwrapMcpOutput,
+  v4aToGitFileDiff,
+} from "./timeline";
+export type { ApplyPatchOperation } from "./timeline";
+
 // Slash-command palette (registry + UI + hook)
 export {
   argHint,
@@ -107,7 +192,7 @@ export { ChatComposer } from "./components/chat-composer";
 export type { ChatComposerProps } from "./components/chat-composer";
 export { ModelPicker } from "./components/model-picker";
 export type { ModelPickerProps } from "./components/model-picker";
-export { MessageTimeline } from "./components/message-timeline";
+export { MessageTimeline, TimelineRow } from "./components/message-timeline";
 export type { MessageTimelineProps } from "./components/message-timeline";
 export { Markdown } from "./components/markdown";
 export type { MarkdownProps } from "./components/markdown";
@@ -116,6 +201,30 @@ export type { SessionStatusProps, StatusDotProps, SessionStatusMeta } from "./co
 export { FleetTile, sessionDisplayTitle } from "./components/fleet-tile";
 export type { FleetTileProps } from "./components/fleet-tile";
 
+// Sandbox surfacing components (Phase 5)
+export { SandboxTerminal } from "./components/sandbox-terminal";
+export type { SandboxTerminalProps, XtermTheme } from "./components/sandbox-terminal";
+export { FileBrowser } from "./components/file-browser";
+export type { FileBrowserProps } from "./components/file-browser";
+export { DiffView } from "./components/diff-view";
+export type { DiffViewProps, DiffTheme } from "./components/diff-view";
+export { PierreDiff } from "./components/pierre-diff";
+export type { PierreDiffProps } from "./components/pierre-diff";
+export { PierreFile } from "./components/pierre-file";
+export type { PierreFileProps } from "./components/pierre-file";
+export { CodeEditor, languageForPath } from "./components/code-editor";
+export type { CodeEditorProps } from "./components/code-editor";
+export { SandboxFiles } from "./components/sandbox-files";
+export type { SandboxFilesProps } from "./components/sandbox-files";
+export { DesktopViewer } from "./components/desktop-viewer";
+export type { DesktopViewerProps } from "./components/desktop-viewer";
+export { WorkspaceDock } from "./components/workspace-dock";
+export type { WorkspaceDockProps, WorkspaceTab } from "./components/workspace-dock";
+
+// Sandbox helpers
+export { gitFileDiffToPatch } from "./lib/git-patch";
+export { xtermThemeFromTokens } from "./lib/xterm-theme";
+
 // Utilities
 export { cn } from "./lib/cn";
 export { formatBytes, formatRelativeTime, stringifyPayload, truncate, tryParseJson } from "./lib/format";

package/src/lib/cn.ts

@@ -1,5 +1,24 @@
 import { clsx, type ClassValue } from "clsx";
-import { twMerge } from "tailwind-merge";
+import { extendTailwindMerge } from "tailwind-merge";
+
+/* ----------------------------------------------------------------------------
+   tailwind-merge, taught our design tokens.
+
+   Our type scale and color ramp share the `og-` prefix: `text-og-base` is a
+   FONT SIZE, `text-og-fg-muted` is a COLOR. Stock tailwind-merge can't tell
+   them apart — it lumps every `text-og-*` into one `font-size` group and, when
+   two land in the same class list, drops the earlier one. That silently ate the
+   size off rows like `text-og-base text-og-fg-muted`, leaving titles at the
+   browser-default 16px. Register the custom font-size scale so the size and the
+   color live in different conflict groups and both survive a merge.
+   -------------------------------------------------------------------------- */
+const twMerge = extendTailwindMerge({
+  extend: {
+    classGroups: {
+      "font-size": [{ text: ["og-xs", "og-sm", "og-base", "og-md"] }],
+    },
+  },
+});
 
 /** Merge class names with Tailwind-aware conflict resolution. */
 export function cn(...inputs: ClassValue[]): string {

package/src/lib/git-patch.ts

@@ -0,0 +1,37 @@
+import type { GitFileDiff } from "@opengeni/sdk";
+
+/**
+ * Reconstruct a unified-diff patch string for a single `GitFileDiff` so it can
+ * be fed to a generic patch renderer (e.g. Pierre's `PatchDiff`). The hook
+ * already carries per-line old/new numbers and a hunk header, so we emit a
+ * conventional `--- / +++ / @@` patch the parser understands.
+ */
+export function gitFileDiffToPatch(file: GitFileDiff): string {
+  const oldPath = file.oldPath ?? file.path;
+  const newPath = file.path;
+  const lines: string[] = [];
+  lines.push(`diff --git a/${oldPath} b/${newPath}`);
+  if (file.status === "deleted") {
+    lines.push(`--- a/${oldPath}`);
+    lines.push(`+++ /dev/null`);
+  } else if (file.status === "added" || file.status === "untracked") {
+    lines.push(`--- /dev/null`);
+    lines.push(`+++ b/${newPath}`);
+  } else {
+    lines.push(`--- a/${oldPath}`);
+    lines.push(`+++ b/${newPath}`);
+  }
+  for (const hunk of file.hunks) {
+    const header =
+      hunk.header && hunk.header.startsWith("@@")
+        ? hunk.header
+        : `@@ -${hunk.oldStart},${hunk.oldLines} +${hunk.newStart},${hunk.newLines} @@`;
+    lines.push(header);
+    for (const line of hunk.lines) {
+      if (line.type === "meta") continue;
+      const prefix = line.type === "add" ? "+" : line.type === "del" ? "-" : " ";
+      lines.push(`${prefix}${line.text}`);
+    }
+  }
+  return lines.join("\n") + "\n";
+}

package/src/lib/use-theme-type.ts

@@ -0,0 +1,40 @@
+import { useEffect, useState } from "react";
+
+/* ----------------------------------------------------------------------------
+   useThemeType
+
+   Resolve the effective dark/light theme for surfaces (the Pierre/Shiki diff)
+   that render outside the reach of host CSS — they need the theme as a value,
+   not a cascade. An explicit prop always wins; otherwise read the host's
+   `data-og-theme` attribute (set on `<html>` or any ancestor by the same opt-in
+   the tokens use) and default to dark, the first-class theme. A MutationObserver
+   keeps it live across runtime theme flips.
+
+   One detector, shared by every diff surface (the Files tab and the timeline),
+   so the two can never drift onto different themes.
+   -------------------------------------------------------------------------- */
+
+/**
+ * Resolve the diff theme. An explicit `forced` value wins; otherwise auto-detect
+ * from the host `data-og-theme` (defaulting to dark) and track live flips.
+ */
+export function useThemeType(forced: "dark" | "light" | undefined): "dark" | "light" {
+  const [detected, setDetected] = useState<"dark" | "light">("dark");
+  useEffect(() => {
+    if (forced || typeof document === "undefined") return;
+    const read = () => {
+      const el = document.querySelector("[data-og-theme]");
+      const value = el?.getAttribute("data-og-theme");
+      setDetected(value === "light" ? "light" : "dark");
+    };
+    read();
+    const observer = new MutationObserver(read);
+    observer.observe(document.documentElement, {
+      attributes: true,
+      attributeFilter: ["data-og-theme"],
+      subtree: true,
+    });
+    return () => observer.disconnect();
+  }, [forced]);
+  return forced ?? detected;
+}

package/src/lib/xterm-theme.ts

@@ -0,0 +1,34 @@
+import type { XtermTheme } from "../components/sandbox-terminal";
+
+/**
+ * Derive an xterm `ITheme` subset from the live OKLCH `--og-*` token system (or
+ * the app's `--color-*` aliases). Reads the COMPUTED values so xterm — which
+ * paints into a canvas and can't consume CSS vars — gets concrete colors. Call
+ * on mount and re-derive on a `data-og-theme` flip.
+ *
+ * SSR-safe: returns undefined off the DOM (the caller keeps xterm's defaults).
+ */
+export function xtermThemeFromTokens(root?: HTMLElement | null): XtermTheme | undefined {
+  if (typeof window === "undefined" || typeof getComputedStyle === "undefined") return undefined;
+  const el = root ?? document.documentElement;
+  const style = getComputedStyle(el);
+  const read = (names: string[]): string | undefined => {
+    for (const name of names) {
+      const value = style.getPropertyValue(name).trim();
+      if (value) return value;
+    }
+    return undefined;
+  };
+  const bg = read(["--og-color-bg", "--color-bg"]);
+  const fg = read(["--og-color-fg", "--color-fg"]);
+  const accent = read(["--og-color-accent", "--color-brand", "--color-accent"]);
+  const theme: XtermTheme = {};
+  if (bg) theme.background = bg;
+  if (fg) theme.foreground = fg;
+  if (accent) {
+    theme.cursor = accent;
+    theme.selectionBackground = accent;
+  }
+  if (bg) theme.cursorAccent = bg;
+  return Object.keys(theme).length > 0 ? theme : undefined;
+}

package/src/timeline/activity-rail.tsx

@@ -0,0 +1,207 @@
+import { BotIcon, BrainIcon, SquareTerminalIcon } from "lucide-react";
+import { cn } from "../lib/cn";
+import { truncate } from "../lib/format";
+import { defaultToolRegistry } from "./tool-renderers";
+import type { ToolRegistry } from "./registry";
+import { PayloadBlock, ActivityDisclosure } from "./shared";
+import { toolDisplayName } from "./projection";
+import type { ActivityItem, ReasoningItem, SandboxItem, WorkerItem } from "./types";
+
+/* ----------------------------------------------------------------------------
+   Activity rail
+
+   Renders a run of clustered activity items (reasoning, tool calls, workers,
+   sandbox ops) as the left-bordered column between chat messages. Tool calls
+   resolve through the renderer registry; everything else has a first-class row.
+
+   Shared by `MessageTimeline` and the component demo so both draw the exact
+   same rail — no divergence.
+   -------------------------------------------------------------------------- */
+
+export type ActivityRailProps = {
+  items: ActivityItem[];
+  /** Renderer registry for tool calls. Defaults to {@link defaultToolRegistry}. */
+  toolRegistry?: ToolRegistry | undefined;
+  /** Drill into a spawned worker session. */
+  onOpenSession?: ((sessionId: string) => void) | undefined;
+  /** Drop the left rule + indent (used inside a folded turn summary). */
+  bare?: boolean | undefined;
+  className?: string | undefined;
+};
+
+/**
+ * The "family" a row belongs to, for light intra-rail grouping. Consecutive
+ * rows of the same family sit tight; a family change gets a little extra top
+ * margin so a long run reads as clusters rather than one undifferentiated wall.
+ */
+function familyOf(item: ActivityItem): string {
+  if (item.kind === "tool-call") {
+    return item.name === "exec_command" || item.name === "write_stdin" ? "terminal" : item.name;
+  }
+  return item.kind;
+}
+
+export function ActivityRail({ items, toolRegistry = defaultToolRegistry, onOpenSession, bare, className }: ActivityRailProps) {
+  return (
+    <div
+      className={cn(
+        // Rows sit TIGHT by default (gap-0.5) so a same-family run reads as one
+        // calm cluster; a family change opens real breathing room (mt-3) below,
+        // so a long rail reads as a few clusters, not a metronome of rows.
+        "flex flex-col gap-0.5",
+        !bare && "animate-og-enter border-l-2 border-og-border pl-3 sm:pl-4",
+        className,
+      )}
+    >
+      {items.map((item, index) => {
+        const newFamily = index > 0 && familyOf(item) !== familyOf(items[index - 1]!);
+        const row = renderActivity(item, toolRegistry, onOpenSession);
+        return (
+          <div key={item.id} className={cn(newFamily && "mt-3")}>
+            {row}
+          </div>
+        );
+      })}
+    </div>
+  );
+}
+
+/** A never-reachable guard: adding an `ActivityItem` kind is now a compile error. */
+function assertNever(item: never): never {
+  throw new Error(`ActivityRail: unhandled activity item ${JSON.stringify(item)}`);
+}
+
+function renderActivity(
+  item: ActivityItem,
+  toolRegistry: ToolRegistry,
+  onOpenSession: ((sessionId: string) => void) | undefined,
+) {
+  switch (item.kind) {
+    case "reasoning":
+      return <ReasoningRow item={item} />;
+    case "tool-call": {
+      const Renderer = toolRegistry.resolve(item);
+      return <Renderer item={item} />;
+    }
+    case "worker":
+      return <WorkerRow item={item} onOpenSession={onOpenSession} />;
+    case "sandbox":
+      return <SandboxRow item={item} />;
+    default:
+      return assertNever(item);
+  }
+}
+
+function ReasoningRow({ item }: { item: ReasoningItem }) {
+  // Reasoning recedes: a dimmer, lighter-weight title so action rows lead and
+  // thought rows sit a half-step back in the hierarchy.
+  return (
+    <ActivityDisclosure
+      icon={<BrainIcon className="size-3.5" />}
+      iconTone="muted"
+      title={
+        item.streaming ? (
+          "Thinking"
+        ) : (
+          <span className="font-normal italic text-og-fg-subtle">Thought</span>
+        )
+      }
+      running={item.streaming}
+      preview={truncate(item.text, 110)}
+    >
+      <p className="whitespace-pre-wrap text-og-base leading-6 text-og-fg-muted">{item.text}</p>
+    </ActivityDisclosure>
+  );
+}
+
+function SandboxRow({ item }: { item: SandboxItem }) {
+  return (
+    <ActivityDisclosure
+      icon={<SquareTerminalIcon className="size-3.5" />}
+      iconTone={item.status === "failed" ? "failed" : item.status === "running" ? "running" : "muted"}
+      title={toolDisplayName(item.name)}
+      running={item.status === "running"}
+      failed={item.status === "failed"}
+      cancelled={item.status === "cancelled"}
+      preview={item.command ?? undefined}
+    >
+      {item.command ? <PayloadBlock label="Command" value={item.command} /> : null}
+      {item.output ? <PayloadBlock label="Output" value={item.output} /> : null}
+    </ActivityDisclosure>
+  );
+}
+
+/** Spawned/messaged worker sessions get a first-class card, not a tool row. */
+function WorkerRow({ item, onOpenSession }: { item: WorkerItem; onOpenSession?: ((sessionId: string) => void) | undefined }) {
+  const running = item.status === "running";
+  const failed = item.status === "failed";
+  const cancelled = item.status === "cancelled";
+  const title =
+    item.action === "spawn"
+      ? running
+        ? "Spawning worker"
+        : failed
+          ? "Worker spawn failed"
+          : cancelled
+            ? "Worker interrupted"
+            : "Worker spawned"
+      : running
+        ? "Messaging worker"
+        : failed
+          ? "Worker message failed"
+          : cancelled
+            ? "Worker interrupted"
+            : "Worker messaged";
+  return (
+    <div
+      className={cn(
+        "my-0.5 flex items-start gap-3 rounded-og-md border bg-og-surface-1 p-3",
+        failed ? "border-og-status-failed/40" : "border-og-border",
+      )}
+    >
+      <span
+        className={cn(
+          "mt-0.5 inline-flex size-7 shrink-0 items-center justify-center",
+          failed ? "text-og-status-failed" : "text-og-accent",
+        )}
+      >
+        <BotIcon className="size-4" />
+      </span>
+      <div className="min-w-0 flex-1">
+        {/* In-flight state is carried ONLY by the shimmering title (no detached
+            pulse badge), matching every other running row in the rail. */}
+        <span className={cn("text-og-base font-medium", running ? "og-shimmer-text" : failed ? "text-og-status-failed" : "text-og-fg")}>
+          {title}
+        </span>
+        {item.prompt ? <p className="mt-0.5 truncate text-og-sm text-og-fg-muted">{truncate(item.prompt, 140)}</p> : null}
+        {item.workerSessionId ? (
+          <p className="mt-1 font-og-mono text-og-xs text-og-fg-subtle">{item.workerSessionId.slice(0, 8)}</p>
+        ) : null}
+      </div>
+      {/* Right gutter: failed gets a red chip; cancelled gets a calm "interrupted"
+          chip (no dot, no red); a live complete worker shows an "Open session" button. */}
+      {failed ? (
+        <span className="inline-flex shrink-0 self-center items-center gap-1.5 font-og-mono text-og-xs leading-none text-og-status-failed">
+          <span className="size-1.5 rounded-full bg-og-status-failed" />
+          failed
+        </span>
+      ) : cancelled ? (
+        <span className="og-cancelled-chip shrink-0 self-center font-og-mono text-og-xs leading-none text-og-fg-subtle">
+          interrupted
+        </span>
+      ) : item.workerSessionId && onOpenSession ? (
+        <button
+          type="button"
+          onClick={() => item.workerSessionId && onOpenSession(item.workerSessionId)}
+          className={cn(
+            "shrink-0 self-center rounded-og-sm border border-og-border px-2.5 py-1 text-og-sm font-medium text-og-fg-muted",
+            "outline-none transition-colors duration-150 hover:border-og-border-strong hover:text-og-fg",
+            "focus-visible:ring-2 focus-visible:ring-og-accent",
+          )}
+        >
+          Open session
+        </button>
+      ) : null}
+    </div>
+  );
+}

package/src/timeline/disclosure-context.tsx

@@ -0,0 +1,34 @@
+import { createContext, useContext, type ReactNode } from "react";
+
+/* ----------------------------------------------------------------------------
+   Disclosure defaults context
+
+   A tiny, opt-in context that lets an ancestor seed the INITIAL open state of
+   every collapsible in the timeline (ActivityDisclosure rows and TurnSummary
+   chips). Its sole intended use is deterministic screenshot capture: a tool can
+   force every card open so a headless render shows expanded bodies.
+
+   It is fully inert in normal app usage. With no provider, the hook returns
+   `undefined`, every collapsible keeps its own author-chosen default, and there
+   is zero change to how the components look or animate. Mounting the provider
+   only changes the SEED of the initial `open` state — Radix still owns the
+   open/close transition, so animations are untouched.
+   -------------------------------------------------------------------------- */
+
+const DisclosureDefaultsContext = createContext<boolean | undefined>(undefined);
+
+/**
+ * Seed the initial open state of every timeline collapsible below this node.
+ * Intended for screenshot/test instrumentation only; absent by default.
+ */
+export function DisclosureDefaultsProvider({ defaultOpen, children }: { defaultOpen: boolean; children: ReactNode }) {
+  return <DisclosureDefaultsContext.Provider value={defaultOpen}>{children}</DisclosureDefaultsContext.Provider>;
+}
+
+/**
+ * The forced initial-open seed from an ancestor {@link DisclosureDefaultsProvider},
+ * or `undefined` when none is mounted (the inert, app-default case).
+ */
+export function useForcedDefaultOpen(): boolean | undefined {
+  return useContext(DisclosureDefaultsContext);
+}

package/src/timeline/index.ts

@@ -0,0 +1,85 @@
+/* ----------------------------------------------------------------------------
+   @opengeni/react — timeline module
+
+   The session timeline's data + rendering layer:
+     - projection.ts   raw SessionEvents -> renderable TimelineItems (pure)
+     - types.ts        the projected item shapes (the data contract)
+     - registry.ts     the extensible, typed tool-renderer registry
+     - tool-renderers  per-tool React renderers + the default registry
+     - parsers.ts      pure provider-shape parsers (exec banner, V4A diff, …)
+     - shared.tsx      the restraint primitives (ActivityDisclosure, TermBlock, …)
+     - tool-diff.tsx   V4A GitFileDiff -> the real DiffView/PierreDiff stack
+     - screenshot-lightbox.tsx  the app-level screenshot lightbox
+
+   This barrel is the module's public surface. The components here are the
+   single source of truth used by both the live app and the component demo.
+   -------------------------------------------------------------------------- */
+
+// projection
+export { buildTimeline, extractSessionRef, groupTimeline, sessionStatusFromEvents, toolDisplayName } from "./projection";
+
+// item types
+export type {
+  ActivityItem,
+  AgentMessageItem,
+  GoalItem,
+  NoticeItem,
+  ReasoningItem,
+  SandboxItem,
+  SessionStatusItem,
+  TimelineGroup,
+  TimelineItem,
+  ToolCallItem,
+  UserMessageItem,
+  WorkerItem,
+} from "./types";
+
+// renderer registry
+export { createToolRegistry, rawTypeOf } from "./registry";
+export type {
+  CreateToolRegistryOptions,
+  ToolRegistry,
+  ToolRegistryEntry,
+  ToolRenderer,
+  ToolRendererProps,
+} from "./registry";
+
+// default renderers + registry
+export { createDefaultToolRegistry, defaultToolRegistry } from "./tool-renderers";
+
+// the activity rail (the clustered reasoning/tool/worker/sandbox column)
+export { ActivityRail } from "./activity-rail";
+export type { ActivityRailProps } from "./activity-rail";
+
+// shared primitives (extension authors compose these)
+export { ActivityDisclosure, BodyNote, MediaEmpty, MediaSkeleton, PayloadBlock, ScreenshotFigure, TermBlock, Thumbnail } from "./shared";
+export type { ActivityDisclosureProps, DisclosureChip } from "./shared";
+
+// screenshot lightbox
+export { LightboxProvider, useLightbox, useLightboxOptional } from "./screenshot-lightbox";
+
+// disclosure defaults (opt-in initial-open seed; for screenshot/test instrumentation)
+export { DisclosureDefaultsProvider, useForcedDefaultOpen } from "./disclosure-context";
+
+// turn-collapse summary chip
+export { TurnSummary } from "./turn-summary";
+export type { TurnOutcome, TurnSummaryProps } from "./turn-summary";
+
+// parsers (pure, reusable by custom renderers)
+export {
+  applyPatchOps,
+  controlCaret,
+  execTruncated,
+  isApplyPatch,
+  isExecSessionLostBanner,
+  looksBinary,
+  parseExecBannerSessionId,
+  parseToolArgs,
+  redactSecrets,
+  sandboxCommandExitCode,
+  stripExecBanner,
+  tailPeek,
+  unwrapMcpOutput,
+  v4aToGitFileDiff,
+} from "./parsers";
+export type { ApplyPatchOperation } from "./parsers";