@tangle-network/sandbox-ui 2.0.18 → 2.0.19

package/README.md

@@ -530,4 +530,4 @@ Retheming is absolutely supported, but the documentation was thinner than it sho
 
 Apache-2.0
 
-The native Runtime viewer is `LiveRun` from `@tangle-network/sandbox-ui/run/live`. It composes the same trace workspace, selected-agent conversation, retained files and capture coverage. Hosts may supply the existing fetch/EventSource transport for their authenticated session; an API change resets the selected run, while frames on one API preserve selection and the camera. `@tangle-network/sandbox-ui/workspace-viewer.js` is the self-contained browser entry for Runtime's existing asset-directory contract, with `styles.css` beside it. Generic same-origin ETag document reads are shared as `useDocument` from the hooks entry; producers retain their format validation and accounting.
+The native Runtime viewer is `LiveRun` from `@tangle-network/sandbox-ui/run/live`. It composes the same trace workspace, selected-agent conversation, retained files and capture coverage. Hosts may supply the existing fetch/EventSource transport for their authenticated session; an API or authenticated transport change clears the previous view, while frames within one stable transport preserve selection and the camera. Keep the transport object stable for that account. `@tangle-network/sandbox-ui/workspace-viewer.js` is the self-contained browser entry for Runtime's existing asset-directory contract, with `styles.css` beside it. Generic same-origin ETag document reads are shared as `useDocument` from `/hooks/use-document` without unrelated optional peers; producers retain their format validation and accounting.

package/dist/hooks/use-document.d.ts

@@ -0,0 +1,2 @@
+import { t as useDocument } from "../use-document-DCXGpk0q.js";
+export { useDocument };

package/dist/{use-document-D6Z9oFLm.js → hooks/use-document.js}

@@ -13,21 +13,27 @@ const NETWORK_RETRIES = 4;
 function useDocument(url, poll, keepPrevious = false, fetcher = globalThis.fetch) {
 	const [state, setState] = useState({
 		url,
+		fetcher,
 		loading: !!url
 	});
 	const etag = useRef(null);
 	const shown = useRef(void 0);
 	useEffect(() => {
-		if (shown.current !== url) {
-			shown.current = url;
+		const sameAccount = shown.current?.fetcher === fetcher;
+		if (shown.current?.url !== url || !sameAccount) {
+			shown.current = {
+				url,
+				fetcher
+			};
 			etag.current = null;
-			setState((current) => keepPrevious && url && current.data !== void 0 ? {
+			setState((current) => sameAccount && keepPrevious && url && current.data !== void 0 ? {
 				...current,
 				url,
 				loading: true,
 				error: void 0
 			} : {
 				url,
+				fetcher,
 				loading: !!url
 			});
 		}
@@ -44,6 +50,7 @@ function useDocument(url, poll, keepPrevious = false, fetcher = globalThis.fetch
 			try {
 				const response = await fetcher(url, {
 					credentials: "same-origin",
+					cache: "no-store",
 					signal: controller.signal,
 					headers: etag.current ? { "If-None-Match": etag.current } : {}
 				});
@@ -53,8 +60,11 @@ function useDocument(url, poll, keepPrevious = false, fetcher = globalThis.fetch
 				const failing = response.headers.get("X-Workspace-Compose-Error") ?? void 0;
 				if (!stale && (response.ok || response.status === 304)) retries = 0;
 				if (response.status === 304) {
-					setState((current) => current.stale === stale && current.failing === failing ? current : {
+					setState((current) => !current.error && current.stale === stale && current.failing === failing ? current : {
 						...current,
+						loading: false,
+						error: void 0,
+						status: 304,
 						stale,
 						failing
 					});
@@ -66,8 +76,18 @@ function useDocument(url, poll, keepPrevious = false, fetcher = globalThis.fetch
 						const body = await response.json();
 						if (body && typeof body === "object" && typeof body.reason === "string") reason = body.reason;
 					} catch {}
+					if (!alive) return;
+					const refused = [
+						401,
+						403,
+						404
+					].includes(response.status);
+					if (refused) etag.current = null;
 					setState((current) => ({
-						...current,
+						...refused ? {
+							url,
+							fetcher
+						} : current,
 						loading: false,
 						error: reason,
 						status: response.status
@@ -78,6 +98,7 @@ function useDocument(url, poll, keepPrevious = false, fetcher = globalThis.fetch
 				const data = await response.json();
 				if (alive) setState({
 					url,
+					fetcher,
 					data,
 					loading: false,
 					status: response.status,
@@ -112,9 +133,10 @@ function useDocument(url, poll, keepPrevious = false, fetcher = globalThis.fetch
 		poll,
 		fetcher
 	]);
-	return keepPrevious || state.url === url ? state : {
+	return state.fetcher === fetcher && (keepPrevious || state.url === url) ? state : {
 		url,
+		fetcher,
 		loading: !!url
 	};
 }
-export { useDocument as t };
+export { useDocument };

package/dist/hooks.d.ts

@@ -1,4 +1,142 @@
 import { n as UsePtySessionReturn, r as usePtySession, t as UsePtySessionOptions } from "./use-pty-session-DSgtQyYX.js";
-import { $ as UseSandboxMetricsResult, A as useApiKey, B as useToolCallStream, C as UseRunGroupsOptions, D as UseSdkSessionReturn, E as UseSdkSessionOptions, F as useRealtimeSession, G as useSessions, H as useCreateSession, I as useRunCollapseState, J as SandboxMetrics, K as LatencyPercentiles, L as useRunGroups, M as useAutoScroll, N as useDropdownMenu, O as UseToolCallStreamReturn, P as useLiveTime, Q as UseSandboxMetricsOptions, R as useSSEStream, S as UseAuthResult, T as UseSSEStreamResult, U as useDeleteSession, V as useDocument, W as useRenameSession, X as SidecarMetricsPayload, Y as SandboxMetricsSample, Z as SystemMetricsSnapshot, _ as SdkSessionEvent, a as AutomationStreamEvent, b as TerminalStreamEvent, c as CompleteAssistantMessageOptions, d as RealtimeSessionRegistry, et as useSandboxMetrics, f as RealtimeSessionRegistryProps, g as SdkSessionAttachment, h as SSEEvent, i as AuthUser, j as useAuth, k as createAuthFetcher, l as ConnectionState, m as RealtimeSessionTarget, n as AppendUserMessageOptions, o as BeginAssistantMessageOptions, p as RealtimeSessionState, q as SandboxLatencyMetrics, r as ApplySdkEventOptions, s as BotStreamEvent, t as AgentStreamEvent, u as RealtimeSessionOptions, v as SdkSessionSeed, w as UseSSEStreamOptions, x as UseAuthOptions, y as TaskStreamEvent, z as useSdkSession } from "./index-D5Hig-j9.js";
+import { t as Session } from "./sidecar-CNP4zXop.js";
 import { a as SendMessageOptions, c as SessionStreamError, d as useSessionStream, i as SESSION_STREAM_RECONNECT_DELAY_MS, l as UseSessionStreamOptions, n as UseSidecarAuthOptions, o as SessionDegradation, r as useSidecarAuth, s as SessionInfo, t as SidecarAuth, u as UseSessionStreamResult } from "./use-sidecar-auth-CPevSSEj.js";
-export { type AgentStreamEvent, type AppendUserMessageOptions, type ApplySdkEventOptions, type AuthUser, type AutomationStreamEvent, type BeginAssistantMessageOptions, type BotStreamEvent, type CompleteAssistantMessageOptions, type ConnectionState, LatencyPercentiles, type RealtimeSessionOptions, RealtimeSessionRegistry, type RealtimeSessionRegistryProps, type RealtimeSessionState, type RealtimeSessionTarget, SESSION_STREAM_RECONNECT_DELAY_MS, type SSEEvent, SandboxLatencyMetrics, SandboxMetrics, SandboxMetricsSample, type SdkSessionAttachment, type SdkSessionEvent, type SdkSessionSeed, SendMessageOptions, SessionDegradation, SessionInfo, SessionStreamError, SidecarAuth, SidecarMetricsPayload, SystemMetricsSnapshot, type TaskStreamEvent, type TerminalStreamEvent, type UseAuthOptions, type UseAuthResult, UsePtySessionOptions, UsePtySessionReturn, type UseRunGroupsOptions, type UseSSEStreamOptions, type UseSSEStreamResult, UseSandboxMetricsOptions, UseSandboxMetricsResult, type UseSdkSessionOptions, type UseSdkSessionReturn, UseSessionStreamOptions, UseSessionStreamResult, UseSidecarAuthOptions, type UseToolCallStreamReturn, createAuthFetcher, useApiKey, useAuth, useAutoScroll, useCreateSession, useDeleteSession, useDocument, useDropdownMenu, useLiveTime, usePtySession, useRealtimeSession, useRenameSession, useRunCollapseState, useRunGroups, useSSEStream, useSandboxMetrics, useSdkSession, useSessionStream, useSessions, useSidecarAuth, useToolCallStream };
+import { t as useDocument } from "./use-document-DCXGpk0q.js";
+import { AgentStreamEvent, AppendUserMessageOptions, ApplySdkEventOptions, AuthUser, AutomationStreamEvent, BeginAssistantMessageOptions, BotStreamEvent, CompleteAssistantMessageOptions, ConnectionState, RealtimeSessionOptions, RealtimeSessionRegistry, RealtimeSessionRegistryProps, RealtimeSessionState, RealtimeSessionTarget, SSEEvent, SdkSessionAttachment, SdkSessionEvent, SdkSessionSeed, TaskStreamEvent, TerminalStreamEvent, UseAuthOptions, UseAuthResult, UseRunGroupsOptions, UseSSEStreamOptions, UseSSEStreamResult, UseSdkSessionOptions, UseSdkSessionReturn, UseToolCallStreamReturn, createAuthFetcher, useApiKey, useAuth, useAutoScroll, useDropdownMenu, useLiveTime, useRealtimeSession, useRunCollapseState, useRunGroups, useSSEStream, useSdkSession, useToolCallStream } from "@tangle-network/ui/hooks";
+/**
+ * Sandbox-level telemetry collected by the sidecar from cgroup v2
+ * (Docker) or /proc (Firecracker guest). `cpuPercent` is computed
+ * server-side from consecutive samples; sections are null when the
+ * source cannot provide them.
+ */
+export interface SystemMetricsSnapshot {
+  cpuPercent: number | null;
+  cpuCores: number;
+  memory: {
+    usedBytes: number;
+    totalBytes: number;
+  } | null;
+  disk: {
+    usedBytes: number;
+    totalBytes: number;
+    path: string;
+  } | null;
+  source: "cgroup-v2" | "proc";
+}
+export interface LatencyPercentiles {
+  p50: number | null;
+  p95: number | null;
+  sampleCount: number;
+}
+export interface SandboxLatencyMetrics {
+  ttftMs: LatencyPercentiles;
+  firstResponseMs: LatencyPercentiles;
+  runDurationMs: LatencyPercentiles;
+}
+/**
+ * Shape returned by the sidecar `/metrics/json` endpoint. Only the
+ * fields read by this hook are modeled; the sidecar may add more.
+ */
+export interface SidecarMetricsPayload {
+  process?: {
+    memoryBytes?: {
+      rss?: number;
+      heapTotal?: number;
+      heapUsed?: number;
+      external?: number;
+      arrayBuffers?: number;
+    };
+    cpuSeconds?: {
+      user?: number;
+      system?: number;
+    };
+  };
+  system?: SystemMetricsSnapshot | null;
+  latency?: SandboxLatencyMetrics;
+}
+/**
+ * One polled time-series point, sourced from the sandbox-level
+ * `system` section. Null values mean the sidecar could not provide
+ * that reading — charts must render a gap, not a zero.
+ */
+export interface SandboxMetricsSample {
+  /** Wall-clock ms when the sample was committed client-side. */
+  at: number;
+  cpuPercent: number | null;
+  memoryUsedBytes: number | null;
+  memoryTotalBytes: number | null;
+  diskUsedBytes: number | null;
+  diskTotalBytes: number | null;
+}
+export interface SandboxMetrics {
+  /**
+   * CPU% derived from consecutive samples. `null` on the first sample
+   * because a delta is required. Can exceed 100 on multi-core hosts.
+   */
+  cpuPercent: number | null;
+  rssBytes: number;
+  heapUsedBytes: number;
+  heapTotalBytes: number;
+}
+export interface UseSandboxMetricsOptions {
+  /**
+   * Sandbox API base URL, e.g. `https://api.tangle.tools`.
+   * Use an empty string for same-origin requests.
+   */
+  apiBaseUrl: string;
+  /** Sandbox id; when falsy the hook stays idle. */
+  sandboxId?: string | null;
+  /**
+   * Optional bearer token. When omitted the fetch still sends
+   * credentials so a cookie session can authenticate the proxy.
+   */
+  token?: string | null;
+  /** Pause polling when false. Defaults to true. */
+  enabled?: boolean;
+  /** Poll cadence; clamped to a 500ms floor. Defaults to 3000. */
+  intervalMs?: number;
+  /** Max retained history samples for charting. Defaults to 120. */
+  historyLimit?: number;
+}
+export interface UseSandboxMetricsResult {
+  metrics: SandboxMetrics | null;
+  /**
+   * Sandbox-level (container/VM) telemetry. Null until the sidecar
+   * reports a `system` section — older sidecars never will, and
+   * consumers must surface that as "unavailable", not zeros.
+   */
+  system: SystemMetricsSnapshot | null;
+  /** Agent latency percentiles (TTFT, first response, run duration). */
+  latency: SandboxLatencyMetrics | null;
+  /**
+   * Rolling window of system samples (oldest first), capped at
+   * `historyLimit`. Cleared when the target sandbox changes.
+   */
+  history: SandboxMetricsSample[];
+  /**
+   * True while waiting for the first successful metrics response for this
+   * sandbox. Errors clear it so consumers can show the failure state.
+   */
+  loading: boolean;
+  error: Error | null;
+  /** Wall-clock ms of the last successful metrics response, or null. */
+  lastUpdatedAt: number | null;
+}
+/**
+ * Polls the sandbox's sidecar metrics through the API proxy and
+ * derives a CPU% value from consecutive cumulative-CPU samples. Used
+ * by the sandbox overview dashboard to drive live CPU/memory panels.
+ */
+export declare function useSandboxMetrics({ apiBaseUrl, sandboxId, token, enabled, intervalMs, historyLimit }: UseSandboxMetricsOptions): UseSandboxMetricsResult;
+/** List all sessions for a sidecar. */
+export declare function useSessions(apiUrl: string, token: string | null): import("@tanstack/react-query").UseQueryResult<Session[], Error>;
+/** Create a new session. */
+export declare function useCreateSession(apiUrl: string, token: string | null): import("@tanstack/react-query").UseMutationResult<Session, Error, string, unknown>;
+/** Delete a session by ID. */
+export declare function useDeleteSession(apiUrl: string, token: string | null): import("@tanstack/react-query").UseMutationResult<unknown, Error, string, unknown>;
+/** Rename a session. */
+export declare function useRenameSession(apiUrl: string, token: string | null): import("@tanstack/react-query").UseMutationResult<Session, Error, {
+  sessionId: string;
+  title: string;
+}, unknown>;
+export { type AgentStreamEvent, type AppendUserMessageOptions, type ApplySdkEventOptions, type AuthUser, type AutomationStreamEvent, type BeginAssistantMessageOptions, type BotStreamEvent, type CompleteAssistantMessageOptions, type ConnectionState, type RealtimeSessionOptions, RealtimeSessionRegistry, type RealtimeSessionRegistryProps, type RealtimeSessionState, type RealtimeSessionTarget, SESSION_STREAM_RECONNECT_DELAY_MS, type SSEEvent, type SdkSessionAttachment, type SdkSessionEvent, type SdkSessionSeed, SendMessageOptions, SessionDegradation, SessionInfo, SessionStreamError, SidecarAuth, type TaskStreamEvent, type TerminalStreamEvent, type UseAuthOptions, type UseAuthResult, UsePtySessionOptions, UsePtySessionReturn, type UseRunGroupsOptions, type UseSSEStreamOptions, type UseSSEStreamResult, type UseSdkSessionOptions, type UseSdkSessionReturn, UseSessionStreamOptions, UseSessionStreamResult, UseSidecarAuthOptions, type UseToolCallStreamReturn, createAuthFetcher, useApiKey, useAuth, useAutoScroll, useDocument, useDropdownMenu, useLiveTime, usePtySession, useRealtimeSession, useRunCollapseState, useRunGroups, useSSEStream, useSdkSession, useSessionStream, useSidecarAuth, useToolCallStream };

package/dist/hooks.js

@@ -1,6 +1,6 @@
 import { t as usePtySession } from "./use-pty-session-BHVQlSs-.js";
 import { i as useSessionStream, n as SESSION_STREAM_RECONNECT_DELAY_MS, r as SessionStreamError, t as useSidecarAuth } from "./use-sidecar-auth-D9BrWCg1.js";
-import { t as useDocument } from "./use-document-D6Z9oFLm.js";
+import { useDocument } from "./hooks/use-document.js";
 import * as React$1 from "react";
 import { RealtimeSessionRegistry, createAuthFetcher, useApiKey, useAuth, useAutoScroll, useDropdownMenu, useLiveTime, useRealtimeSession, useRunCollapseState, useRunGroups, useSSEStream, useSdkSession, useToolCallStream } from "@tangle-network/ui/hooks";
 import { useMutation, useQuery, useQueryClient } from "@tanstack/react-query";

package/dist/index.d.ts

@@ -6,9 +6,9 @@ import { a as canonicalModelId, i as ProviderMark, n as ModelBrandStack, o as mo
 import { a as PricingPageProps, c as BillingBalance, d as BillingSubscription, f as BillingUsage, i as PricingPage, l as BillingDashboard, n as UsageChartProps, o as PricingTier, r as UsageDataPoint, s as formatPrice, t as UsageChart, u as BillingDashboardProps } from "./usage-chart-BFpdkqNq.js";
 import { A as configurePdfViewer, C as PdfViewerConfig, D as RichFileTreeGitStatus, E as RichFileTreeGitEntry, F as getFormatLabel, I as getSyntaxLanguage, L as parseCsv, M as fileExtension, N as filterFileTree, O as RichFileTreeProps, P as getCodeLanguage, R as resolveFilePreviewKind, S as PdfViewer, T as RichFileTree, _ as FileTabsProps, a as FileCardProps, b as FileTreeVisibilityOptions, c as FileList, d as FileNode, f as FilePreview, g as FileTabs, h as FileTabData, i as FileCard, j as detectFileFormat, k as RichFileTreeThemeVars, l as FileListItem, m as FilePreviewProps, n as FileArtifactPane, o as FileDetails, p as FilePreviewKind, r as FileArtifactPaneProps, s as FileFormat, t as CSV_PREVIEW_ROW_LIMIT, u as FileListProps, v as FileTree, w as PdfViewerProps, x as FileUploader, y as FileTreeProps } from "./index-BZJKLu3k.js";
 import { n as UsePtySessionReturn, r as usePtySession, t as UsePtySessionOptions } from "./use-pty-session-DSgtQyYX.js";
-import { $ as UseSandboxMetricsResult, A as useApiKey, B as useToolCallStream, C as UseRunGroupsOptions, D as UseSdkSessionReturn, E as UseSdkSessionOptions, F as useRealtimeSession, G as useSessions, H as useCreateSession, I as useRunCollapseState, J as SandboxMetrics, L as useRunGroups, M as useAutoScroll, N as useDropdownMenu, O as UseToolCallStreamReturn, P as useLiveTime, Q as UseSandboxMetricsOptions, R as useSSEStream, S as UseAuthResult, T as UseSSEStreamResult, U as useDeleteSession, W as useRenameSession, X as SidecarMetricsPayload, _ as SdkSessionEvent, a as AutomationStreamEvent, b as TerminalStreamEvent, c as CompleteAssistantMessageOptions, d as RealtimeSessionRegistry, et as useSandboxMetrics, f as RealtimeSessionRegistryProps, g as SdkSessionAttachment, h as SSEEvent, i as AuthUser, j as useAuth, k as createAuthFetcher, m as RealtimeSessionTarget, n as AppendUserMessageOptions, o as BeginAssistantMessageOptions, p as RealtimeSessionState, r as ApplySdkEventOptions, s as BotStreamEvent, t as AgentStreamEvent, u as RealtimeSessionOptions, v as SdkSessionSeed, w as UseSSEStreamOptions, x as UseAuthOptions, y as TaskStreamEvent, z as useSdkSession } from "./index-D5Hig-j9.js";
 import { t as Session } from "./sidecar-CNP4zXop.js";
 import { d as useSessionStream, l as UseSessionStreamOptions, n as UseSidecarAuthOptions, o as SessionDegradation, r as useSidecarAuth, s as SessionInfo, t as SidecarAuth, u as UseSessionStreamResult } from "./use-sidecar-auth-CPevSSEj.js";
+import { AgentStreamEvent, AppendUserMessageOptions, ApplySdkEventOptions, AuthUser, AutomationStreamEvent, BeginAssistantMessageOptions, BotStreamEvent, CompleteAssistantMessageOptions, RealtimeSessionOptions, RealtimeSessionRegistry, RealtimeSessionRegistryProps, RealtimeSessionState, RealtimeSessionTarget, SSEEvent, SandboxMetrics, SdkSessionAttachment, SdkSessionEvent, SdkSessionSeed, SidecarMetricsPayload, TaskStreamEvent, TerminalStreamEvent, UseAuthOptions, UseAuthResult, UseRunGroupsOptions, UseSSEStreamOptions, UseSSEStreamResult, UseSandboxMetricsOptions, UseSandboxMetricsResult, UseSdkSessionOptions, UseSdkSessionReturn, UseToolCallStreamReturn, createAuthFetcher, useApiKey, useAuth, useAutoScroll, useCreateSession, useDeleteSession, useDropdownMenu, useLiveTime, useRealtimeSession, useRenameSession, useRunCollapseState, useRunGroups, useSSEStream, useSandboxMetrics, useSdkSession, useSessions, useToolCallStream } from "./hooks.js";
 import { $ as CollapsibleContent, $i as Logo, $n as Separator, $r as TabsContent, $t as FieldProps, A as BreadcrumbPage, Ai as WizardProps, An as PaginationProps, Ar as SidebarDropZone, At as DialogPortal, B as CardDescription, Bi as parseCalendarDate, Bn as SegmentedControl, Br as StatusTone, Bt as DropdownMenuLabel, C as Badge, Ci as TooltipContent, Cn as MetricStrip, Cr as SheetDescription, Ct as Dialog, D as BreadcrumbItem, Di as UploadProgress, Dn as PageShell, Dr as SheetPortal, Dt as DialogFooter, E as BreadcrumbEllipsis, Ei as UploadFile, En as PageHeaderProps, Er as SheetOverlay, Et as DialogDescription, F as Calendar, Fi as fieldMessageId, Fn as PopoverContent, Fr as Slider, Ft as DropdownMenu, G as CategoryTone, Gi as seriesMean, Gn as SelectGroup, Gr as TableCaption, Gt as DropdownMenuShortcut, H as CardHeader, Hi as seriesAreaPath, Hn as SegmentedControlProps, Hr as TONE_CLASSES, Ht as DropdownMenuRadioGroup, I as CalendarDate, Ii as formatCalendarDate, In as PopoverTrigger, Ir as StatCard, It as DropdownMenuCheckboxItem, J as Chip, Ji as useTheme, Jn as SelectScrollDownButton, Jr as TableHead, Jt as DropdownMenuSubTrigger, K as ChartReferenceLine, Ki as seriesScale, Kn as SelectItem, Kr as TableCell, Kt as DropdownMenuSub, L as CalendarProps, Li as initialsOf, Ln as Progress, Lr as StatCardProps, Lt as DropdownMenuContent, M as Button, Mi as WizardStepProps, Mn as Popover, Mr as Skeleton, Mt as DialogTrigger, N as ButtonProps, Ni as badgeVariants, Nn as PopoverAnchor, Nr as SkeletonCard, Nt as DropZone, O as BreadcrumbLink, Oi as UploadProgressProps, On as PageShellProps, Or as SheetTitle, Ot as DialogHeader, P as CATEGORY_TONES, Pi as buttonVariants, Pn as PopoverClose, Pr as SkeletonTable, Pt as DropZoneProps, Q as Collapsible, Qi as SectionTitleProps, Qn as SelectValue, Qr as Tabs, Qt as Field, R as Card, Ri as localToday, Rn as RadioGroup, Rr as StatusPill, Rt as DropdownMenuGroup, S as AvatarProps, Si as Tooltip, Sn as MetricProps, Sr as SheetContent, St as DatePickerProps, T as Breadcrumb, Ti as TooltipTrigger, Tn as PageHeader, Tr as SheetHeader, Tt as DialogContent, U as CardTitle, Ui as seriesExtent, Un as Select, Ur as Table, Ut as DropdownMenuRadioItem, V as CardFooter, Vi as periodDelta, Vn as SegmentedControlOption, Vr as Switch, Vt as DropdownMenuPortal, W as CardTitleProps, Wi as seriesLinePath, Wn as SelectContent, Wr as TableBody, Wt as DropdownMenuSeparator, X as CodeBlock, Xi as HeadingProps, Xn as SelectSeparator, Xr as TableProps, Xt as EmptyState, Y as ChipProps, Yi as useToast, Yn as SelectScrollUpButton, Yr as TableHeader, Yt as DropdownMenuTrigger, Z as CodeBlockProps, Zi as SectionTitle, Zn as SelectTrigger, Zr as TableRow, Zt as EmptyStateProps, _ as ArtifactPane, _i as ToastProvider, _n as InputProps, _r as SettingsRowProps, _t as ContextMenuSubContent, a as AlertDialogCancel, ai as TerminalDisplay, an as HelpTextProps, ar as SeriesSparklineProps, at as ContextMenu, b as AvatarFallback, bi as Toolbar, bn as MetricChart, br as Sheet, bt as CopyButton, c as AlertDialogFooter, ci as TextShimmer, cn as HoverCardDescription, cr as SettingsListColumns, ct as ContextMenuGroup, d as AlertDialogPortal, di as TextareaProps, dn as HoverCardTrigger, dr as SettingsListMenuItem, dt as ContextMenuPortal, ea as LogoProps, ei as TabsList, en as FilterField, er as SeriesExtent, et as CollapsibleTrigger, f as AlertDialogTitle, fi as ThemeToggle, fn as IconTile, fr as SettingsListProps, ft as ContextMenuRadioGroup, g as AlertTone, gi as ToastContainer, gn as Input, gr as SettingsRowLayout, gt as ContextMenuSub, h as AlertTitle, hi as Toast, hn as InlineCodeProps, hr as SettingsRow, ht as ContextMenuShortcut, i as AlertDialogAction, ii as TerminalCursor, in as HelpText, ir as SeriesSparkline, it as ComplianceStatus, j as BreadcrumbSeparator, ji as WizardStep, jn as PeriodDelta, jr as SidebarDropZoneProps, jt as DialogTitle, k as BreadcrumbList, ki as Wizard, kn as Pagination, kr as SheetTrigger, kt as DialogOverlay, l as AlertDialogHeader, li as TextShimmerProps, ln as HoverCardHeader, lr as SettingsListItem, lt as ContextMenuItem, m as AlertProps, mi as TimeSelectProps, mn as InlineCode, mr as SettingsNoteProps, mt as ContextMenuSeparator, n as AlertDescription, ni as Tag, nn as Heading, nr as SeriesPointInput, nt as ComplianceBadgeProps, o as AlertDialogContent, oi as TerminalInput, on as HoverCard, or as SettingsList, ot as ContextMenuCheckboxItem, p as AlertDialogTrigger, pi as TimeSelect, pn as IconTileProps, pr as SettingsNote, pt as ContextMenuRadioItem, q as Checkbox, qi as toneFor, qn as SelectLabel, qr as TableFooter, qt as DropdownMenuSubContent, r as AlertDialog, ri as TagProps, rn as HeadingVariant, rr as SeriesScale, rt as ComplianceProduct, s as AlertDialogDescription, sn as HoverCardContent, sr as SettingsListAction, st as ContextMenuContent, t as Alert, ta as TangleKnot, ti as TabsTrigger, tn as FilterFieldProps, tr as SeriesPoint, tt as ComplianceBadge, u as AlertDialogOverlay, ui as Textarea, un as HoverCardTitle, ur as SettingsListItemProps, ut as ContextMenuLabel, v as ArtifactPaneProps, vi as Tone, vn as Label, vr as SettingsSection, vt as ContextMenuSubTrigger, w as BadgeProps, wi as TooltipProvider, wn as MetricStripProps, wr as SheetFooter, wt as DialogClose, x as AvatarImage, xi as ToolbarProps, xn as MetricChartProps, xr as SheetClose, xt as DatePicker, y as Avatar, yi as ToneClasses, yn as Metric, yr as SettingsSectionProps, yt as ContextMenuTrigger, z as CardContent, zi as normalizeSeries, zn as RadioGroupItem, zr as StatusPillProps, zt as DropdownMenuItem } from "./index-CEtc2U5v.js";
 import { $ as StatusBar, A as createShellShouldRevalidate, B as SessionSidebarVariant, C as SandboxWorkbenchLayoutOptions, D as SandboxWorkbenchSessionProps, E as SandboxWorkbenchProps, F as SessionSidebarFilter, G as dispatchSessionCreated, H as SessionCreatedDetail, I as SessionSidebarGroupBy, J as RuntimePaneProps, K as useOptimisticSessionItems, L as SessionSidebarItem, M as formatRelativeAge, N as SessionSidebar, O as ShellShouldRevalidateArgs, P as SessionSidebarBadge, Q as ContextBadge, R as SessionSidebarLink, S as SandboxWorkbenchFileArtifact, T as SandboxWorkbenchOpenUIArtifact, U as SessionOptimisticController, V as SESSION_CREATED_EVENT, W as UseOptimisticSessionItemsOptions, X as TerminalPanel, Y as TerminalLine, Z as TerminalProps, _ as TaskBoardItem, _t as WorkspaceSurfaceTitle, a as WorkspaceFilesPane, at as DirectoryPaneProps, b as SandboxWorkbenchArtifact, bt as WorkspaceLayoutProps, c as ApprovalConfidenceStat, ct as ShellHeader, d as ApprovalQueueProps, dt as WorkspacePaneHeaderProps, et as StatusBarProps, f as CalendarEvent, ft as WorkspaceSurface, g as TaskBoardColumn, gt as WorkspaceSurfaceProps, h as TaskBoard, ht as WorkspaceSurfaceHeadingLevel, i as WorkspaceArtifactViewProps, it as DirectoryPane, j as shellShouldRevalidate, k as ShellShouldRevalidateOptions, l as ApprovalItem, lt as ShellHeaderProps, m as CalendarViewProps, mt as WorkspaceSurfaceFrameProps, nt as StatusBanner, o as WorkspaceFilesPaneProps, ot as SHELL_HEADER_HEIGHT, p as CalendarView, pt as WorkspaceSurfaceFrame, q as RuntimePane, r as WorkspaceArtifactView, rt as StatusBannerProps, s as WorkspaceFilesPreview, st as SHELL_INSET_GUTTER, tt as BannerType, u as ApprovalQueue, ut as WorkspacePaneHeader, v as TaskBoardProps, vt as WorkspaceSurfaceTitleProps, w as SandboxWorkbenchMarkdownArtifact, x as SandboxWorkbenchCustomArtifact, y as SandboxWorkbench, yt as WorkspaceLayout, z as SessionSidebarProps } from "./index-D2_4ONCz.js";
 import { i as VaultTreeProps, n as VAULT_TREE_CHILD_PAGE, r as VaultTree, t as FileChange } from "./vault-tree-CBS8qGT-.js";

package/dist/run/live.d.ts

@@ -1,4 +1,5 @@
 import { t as AgentStreamOpener } from "../agent-stream-CBZ2fXJ2.js";
+/** Keep one transport identity per authenticated account; changing it discards the previous view. */
 export interface LiveRunTransport {
   fetch?: typeof globalThis.fetch;
   openEventSource?: AgentStreamOpener;

package/dist/run/live.js

@@ -2,9 +2,9 @@ import { t as WorkspaceFilesPane } from "../workspace-files-pane-DB9Nvwh4.js";
 import { t as DiffView } from "../diff-view-B9mNeTLF.js";
 import { t as CodeView } from "../code-view-BlhCS1SD.js";
 import { t as TraceWorkspace } from "../trace-workspace-C8dHRBDV.js";
-import { t as useDocument } from "../use-document-D6Z9oFLm.js";
+import { useDocument } from "../hooks/use-document.js";
 import { Fragment, jsx, jsxs } from "react/jsx-runtime";
-import { useEffect, useMemo, useState } from "react";
+import { useEffect, useMemo, useRef, useState } from "react";
 import { runStatus } from "@tangle-network/ui/run";
 // src/run/live-inspection.tsx
 /** The graph, conversation and files share one selected agent and one product-owned API. */
@@ -12,12 +12,12 @@ function useLiveInspection(url, live, fetcher) {
 	const inventory = useDocument(url ?? null, live ? 3e3 : void 0, false, fetcher);
 	const [selected, select] = useState();
 	const [download, setDownload] = useState();
-	const files = inventory.data?.files?.entries ?? [];
+	const files = inventory.error ? [] : inventory.data?.files?.entries ?? [];
 	const entry = files.find((file) => file.path === selected) ?? files[0];
 	const fileUrl = entry && url ? `${url}/file?path=${encodeURIComponent(entry.path)}` : null;
 	const content = useDocument(fileUrl, live ? 3e3 : void 0, false, fetcher);
 	const file = content.data?.file;
-	const valid = file && entry && file.path === entry.path && file.sha256 === entry.sha256 && file.byteLength === entry.byteLength;
+	const valid = !inventory.error && !content.error && file && entry && file.path === entry.path && file.sha256 === entry.sha256 && file.byteLength === entry.byteLength;
 	const fileKey = valid ? `${entry.path}:${entry.sha256}` : void 0;
 	useEffect(() => {
 		if (!fileKey || !file) return;
@@ -29,7 +29,11 @@ function useLiveInspection(url, live, fetcher) {
 		return () => URL.revokeObjectURL(href);
 	}, [fileKey, file?.content]);
 	const coverage = inventory.data?.coverage;
-	const scoreboard = inventory.status === 404 ? void 0 : coverage ? /* @__PURE__ */ jsxs("details", {
+	const scoreboard = inventory.error ? /* @__PURE__ */ jsxs("p", {
+		className: "ws-status",
+		role: "alert",
+		children: ["Conversation inspection unavailable: ", inventory.error]
+	}) : coverage ? /* @__PURE__ */ jsxs("details", {
 		className: "ws-status",
 		open: coverage.status !== "complete",
 		"data-capture-status": coverage.status,
@@ -42,10 +46,6 @@ function useLiveInspection(url, live, fetcher) {
 			}, `${row.at}:${index}`))] }),
 			inventory.data?.files?.scope === "none" && /* @__PURE__ */ jsx("p", { children: inventory.data.files.reason ?? "No workspace inventory was captured." })
 		]
-	}) : inventory.error ? /* @__PURE__ */ jsxs("p", {
-		className: "ws-status",
-		role: "alert",
-		children: ["Conversation inspection unavailable: ", inventory.error]
 	}) : void 0;
 	return {
 		scoreboard: /* @__PURE__ */ jsxs(Fragment, { children: [scoreboard, inventory.data?.files && !inventory.data.files.complete && /* @__PURE__ */ jsxs("p", {
@@ -88,14 +88,23 @@ function useLiveInspection(url, live, fetcher) {
 				className: "ws-status",
 				children: [
 					/* @__PURE__ */ jsx("summary", { children: "Provenance" }),
-					/* @__PURE__ */ jsx("code", { children: entry.sha256 }),
+					/* @__PURE__ */ jsx("code", {
+						className: "break-all",
+						children: entry.sha256
+					}),
 					file.before && /* @__PURE__ */ jsxs("p", { children: [
 						"Compared with ",
 						file.before.source.kind,
 						" ",
-						/* @__PURE__ */ jsx("code", { children: file.before.source.ref }),
+						/* @__PURE__ */ jsx("code", {
+							className: "break-all",
+							children: file.before.source.ref
+						}),
 						": ",
-						/* @__PURE__ */ jsx("code", { children: file.before.sha256 })
+						/* @__PURE__ */ jsx("code", {
+							className: "break-all",
+							children: file.before.sha256
+						})
 					] }),
 					/* @__PURE__ */ jsx("p", { children: /* @__PURE__ */ jsx("a", {
 						href: download && download.key === fileKey ? download.href : void 0,
@@ -146,7 +155,21 @@ const isOpen = (status) => [
 ].includes(flowStatus(status));
 /** Both the Discovery host and agent-runtime-top mount this same stream consumer and shared run workspace. */
 function LiveRun(props) {
-	return /* @__PURE__ */ jsx(LiveRunView, { ...props }, props.api);
+	const scope = useRef({
+		api: props.api,
+		transport: props.transport,
+		fetcher: props.transport?.fetch,
+		opener: props.transport?.openEventSource,
+		revision: 0
+	});
+	if (scope.current.api !== props.api || scope.current.transport !== props.transport || scope.current.fetcher !== props.transport?.fetch || scope.current.opener !== props.transport?.openEventSource) scope.current = {
+		api: props.api,
+		transport: props.transport,
+		fetcher: props.transport?.fetch,
+		opener: props.transport?.openEventSource,
+		revision: scope.current.revision + 1
+	};
+	return /* @__PURE__ */ jsx(LiveRunView, { ...props }, scope.current.revision);
 }
 function LiveRunView({ api, transport }) {
 	const [snapshots, setSnapshots] = useState([]);

package/dist/use-document-DCXGpk0q.d.ts

@@ -0,0 +1,16 @@
+/**
+ * Same-origin JSON with ETag revalidation. `poll` refetches every `poll` ms while set; turning polling on or off keeps
+ * the document. With `keepPrevious`, a new URL (a record's next digest) keeps showing the previous document until the
+ * new one arrives, so a run being written never blanks between versions. A response marked stale is refetched until it is current.
+ */
+declare function useDocument<T>(url: string | null, poll?: number, keepPrevious?: boolean, fetcher?: typeof fetch): {
+  url: string | null;
+  fetcher: typeof fetcher;
+  data?: T;
+  error?: string;
+  status?: number;
+  loading: boolean;
+  stale?: boolean;
+  failing?: string;
+};
+export { useDocument as t };

package/dist/workspace-viewer.js

@@ -43989,91 +43989,112 @@ function SU({ trace: e, streamUrl: t, openEventSource: n, events: r, onTimeChang
 		]
 	});
 }
-// dist/use-document-D6Z9oFLm.js
+// dist/hooks/use-document.js
 var CU = 2500, wU = 6, TU = 4;
 function EU(e, t, n = !1, r = globalThis.fetch) {
 	let [i, a] = (0, G.useState)({
 		url: e,
+		fetcher: r,
 		loading: !!e
 	}), o = (0, G.useRef)(null), s = (0, G.useRef)(void 0);
 	return (0, G.useEffect)(() => {
-		if (s.current !== e && (s.current = e, o.current = null, a((t) => n && e && t.data !== void 0 ? {
+		let i = s.current?.fetcher === r;
+		if (s.current?.url === e && i || (s.current = {
+			url: e,
+			fetcher: r
+		}, o.current = null, a((t) => i && n && e && t.data !== void 0 ? {
 			...t,
 			url: e,
 			loading: !0,
 			error: void 0
 		} : {
 			url: e,
+			fetcher: r,
 			loading: !!e
 		})), !e) return;
-		let i = !0, c = 0, l = !1, u = 0, d = 0, f = !1, p = new AbortController(), m = async () => {
-			f = !1;
+		let c = !0, l = 0, u = !1, d = 0, f = 0, p = !1, m = new AbortController(), h = async () => {
+			p = !1;
 			try {
 				let t = await r(e, {
 					credentials: "same-origin",
-					signal: p.signal,
+					cache: "no-store",
+					signal: m.signal,
 					headers: o.current ? { "If-None-Match": o.current } : {}
 				});
-				if (!i) return;
-				d = 0, l = t.headers.get("X-Workspace-Stale") === "1";
+				if (!c) return;
+				f = 0, u = t.headers.get("X-Workspace-Stale") === "1";
 				let n = t.headers.get("X-Workspace-Compose-Error") ?? void 0;
-				if (!l && (t.ok || t.status === 304) && (u = 0), t.status === 304) {
-					a((e) => e.stale === l && e.failing === n ? e : {
+				if (!u && (t.ok || t.status === 304) && (d = 0), t.status === 304) {
+					a((e) => !e.error && e.stale === u && e.failing === n ? e : {
 						...e,
-						stale: l,
+						loading: !1,
+						error: void 0,
+						status: 304,
+						stale: u,
 						failing: n
 					});
 					return;
 				}
 				if (!t.ok) {
-					let e = `HTTP ${t.status}`;
+					let n = `HTTP ${t.status}`;
 					try {
-						let n = await t.json();
-						n && typeof n == "object" && typeof n.reason == "string" && (e = n.reason);
+						let e = await t.json();
+						e && typeof e == "object" && typeof e.reason == "string" && (n = e.reason);
 					} catch {}
-					a((n) => ({
-						...n,
+					if (!c) return;
+					let i = [
+						401,
+						403,
+						404
+					].includes(t.status);
+					i && (o.current = null), a((a) => ({
+						...i ? {
+							url: e,
+							fetcher: r
+						} : a,
 						loading: !1,
-						error: e,
+						error: n,
 						status: t.status
 					}));
 					return;
 				}
 				o.current = t.headers.get("ETag");
-				let s = await t.json();
-				i && a({
+				let i = await t.json();
+				c && a({
 					url: e,
-					data: s,
+					fetcher: r,
+					data: i,
 					loading: !1,
 					status: t.status,
-					stale: l,
+					stale: u,
 					failing: n
 				});
 			} catch (e) {
-				i && !p.signal.aborted && d < TU ? f = !0 : i && !p.signal.aborted && a((t) => ({
+				c && !m.signal.aborted && f < TU ? p = !0 : c && !m.signal.aborted && a((t) => ({
 					...t,
 					loading: !1,
 					error: e instanceof Error ? e.message : "Request failed"
 				}));
 			} finally {
-				i && f ? (c = window.setTimeout(m, 1e3 * 2 ** d), d += 1) : i && l && u < wU ? (c = window.setTimeout(m, CU * 1.5 ** u), u += 1) : i && t && (c = window.setTimeout(m, t));
+				c && p ? (l = window.setTimeout(h, 1e3 * 2 ** f), f += 1) : c && u && d < wU ? (l = window.setTimeout(h, CU * 1.5 ** d), d += 1) : c && t && (l = window.setTimeout(h, t));
 			}
 		};
-		return m(), () => {
-			i = !1, p.abort(), window.clearTimeout(c);
+		return h(), () => {
+			c = !1, m.abort(), window.clearTimeout(l);
 		};
 	}, [
 		e,
 		t,
 		r
-	]), n || i.url === e ? i : {
+	]), i.fetcher === r && (n || i.url === e) ? i : {
 		url: e,
+		fetcher: r,
 		loading: !!e
 	};
 }
 // dist/run/live.js
 function DU(e, t, n) {
-	let r = EU(e ?? null, t ? 3e3 : void 0, !1, n), [i, a] = (0, G.useState)(), [o, s] = (0, G.useState)(), c = r.data?.files?.entries ?? [], l = c.find((e) => e.path === i) ?? c[0], u = EU(l && e ? `${e}/file?path=${encodeURIComponent(l.path)}` : null, t ? 3e3 : void 0, !1, n), d = u.data?.file, f = d && l && d.path === l.path && d.sha256 === l.sha256 && d.byteLength === l.byteLength, p = f ? `${l.path}:${l.sha256}` : void 0;
+	let r = EU(e ?? null, t ? 3e3 : void 0, !1, n), [i, a] = (0, G.useState)(), [o, s] = (0, G.useState)(), c = r.error ? [] : r.data?.files?.entries ?? [], l = c.find((e) => e.path === i) ?? c[0], u = EU(l && e ? `${e}/file?path=${encodeURIComponent(l.path)}` : null, t ? 3e3 : void 0, !1, n), d = u.data?.file, f = !r.error && !u.error && d && l && d.path === l.path && d.sha256 === l.sha256 && d.byteLength === l.byteLength, p = f ? `${l.path}:${l.sha256}` : void 0;
 	(0, G.useEffect)(() => {
 		if (!p || !d) return;
 		let e = URL.createObjectURL(new Blob([d.content], { type: "text/plain;charset=utf-8" }));
@@ -44082,7 +44103,11 @@ function DU(e, t, n) {
 			href: e
 		}), () => URL.revokeObjectURL(e);
 	}, [p, d?.content]);
-	let m = r.data?.coverage, h = r.status === 404 ? void 0 : m ? /* @__PURE__ */ (0, q.jsxs)("details", {
+	let m = r.data?.coverage, h = r.error ? /* @__PURE__ */ (0, q.jsxs)("p", {
+		className: "ws-status",
+		role: "alert",
+		children: ["Conversation inspection unavailable: ", r.error]
+	}) : m ? /* @__PURE__ */ (0, q.jsxs)("details", {
 		className: "ws-status",
 		open: m.status !== "complete",
 		"data-capture-status": m.status,
@@ -44095,10 +44120,6 @@ function DU(e, t, n) {
 			}, `${e.at}:${t}`))] }),
 			r.data?.files?.scope === "none" && /* @__PURE__ */ (0, q.jsx)("p", { children: r.data.files.reason ?? "No workspace inventory was captured." })
 		]
-	}) : r.error ? /* @__PURE__ */ (0, q.jsxs)("p", {
-		className: "ws-status",
-		role: "alert",
-		children: ["Conversation inspection unavailable: ", r.error]
 	}) : void 0;
 	return {
 		scoreboard: /* @__PURE__ */ (0, q.jsxs)(q.Fragment, { children: [h, r.data?.files && !r.data.files.complete && /* @__PURE__ */ (0, q.jsxs)("p", {
@@ -44141,14 +44162,23 @@ function DU(e, t, n) {
 				className: "ws-status",
 				children: [
 					/* @__PURE__ */ (0, q.jsx)("summary", { children: "Provenance" }),
-					/* @__PURE__ */ (0, q.jsx)("code", { children: l.sha256 }),
+					/* @__PURE__ */ (0, q.jsx)("code", {
+						className: "break-all",
+						children: l.sha256
+					}),
 					d.before && /* @__PURE__ */ (0, q.jsxs)("p", { children: [
 						"Compared with ",
 						d.before.source.kind,
 						" ",
-						/* @__PURE__ */ (0, q.jsx)("code", { children: d.before.source.ref }),
+						/* @__PURE__ */ (0, q.jsx)("code", {
+							className: "break-all",
+							children: d.before.source.ref
+						}),
 						": ",
-						/* @__PURE__ */ (0, q.jsx)("code", { children: d.before.sha256 })
+						/* @__PURE__ */ (0, q.jsx)("code", {
+							className: "break-all",
+							children: d.before.sha256
+						})
 					] }),
 					/* @__PURE__ */ (0, q.jsx)("p", { children: /* @__PURE__ */ (0, q.jsx)("a", {
 						href: o && o.key === p ? o.href : void 0,
@@ -44191,7 +44221,20 @@ var OU = (e) => {
 	"needs-you"
 ].includes(MU(e));
 function FU(e) {
-	return /* @__PURE__ */ (0, q.jsx)(IU, { ...e }, e.api);
+	let t = (0, G.useRef)({
+		api: e.api,
+		transport: e.transport,
+		fetcher: e.transport?.fetch,
+		opener: e.transport?.openEventSource,
+		revision: 0
+	});
+	return (t.current.api !== e.api || t.current.transport !== e.transport || t.current.fetcher !== e.transport?.fetch || t.current.opener !== e.transport?.openEventSource) && (t.current = {
+		api: e.api,
+		transport: e.transport,
+		fetcher: e.transport?.fetch,
+		opener: e.transport?.openEventSource,
+		revision: t.current.revision + 1
+	}), /* @__PURE__ */ (0, q.jsx)(IU, { ...e }, t.current.revision);
 }
 function IU({ api: e, transport: t }) {
 	let [n, r] = (0, G.useState)([]), [i, a] = (0, G.useState)(null), [o, s] = (0, G.useState)(!1), [c, l] = (0, G.useState)(!1), [u, d] = (0, G.useState)(""), [f, p] = (0, G.useState)(0), [m, h] = (0, G.useState)(), [g, _] = (0, G.useState)(!0);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@tangle-network/sandbox-ui",
-  "version": "2.0.18",
+  "version": "2.0.19",
   "license": "MIT",
   "description": "Unified UI component library for Tangle Sandbox — primitives, chat, dashboard, terminal, editor, and workspace components",
   "repository": {
@@ -99,6 +99,10 @@
       "import": "./dist/pages.js",
       "types": "./dist/pages.d.ts"
     },
+    "./hooks/use-document": {
+      "import": "./dist/hooks/use-document.js",
+      "types": "./dist/hooks/use-document.d.ts"
+    },
     "./hooks": {
       "import": "./dist/hooks.js",
       "types": "./dist/hooks.d.ts"

package/dist/index-D5Hig-j9.d.ts

@@ -1,155 +0,0 @@
-import "./use-pty-session-DSgtQyYX.js";
-import { t as Session } from "./sidecar-CNP4zXop.js";
-import "./use-sidecar-auth-CPevSSEj.js";
-import { AgentStreamEvent, AppendUserMessageOptions, ApplySdkEventOptions, AuthUser, AutomationStreamEvent, BeginAssistantMessageOptions, BotStreamEvent, CompleteAssistantMessageOptions, ConnectionState, RealtimeSessionOptions, RealtimeSessionRegistry, RealtimeSessionRegistryProps, RealtimeSessionState, RealtimeSessionTarget, SSEEvent, SdkSessionAttachment, SdkSessionEvent, SdkSessionSeed, TaskStreamEvent, TerminalStreamEvent, UseAuthOptions, UseAuthResult, UseRunGroupsOptions, UseSSEStreamOptions, UseSSEStreamResult, UseSdkSessionOptions, UseSdkSessionReturn, UseToolCallStreamReturn, createAuthFetcher, useApiKey, useAuth, useAutoScroll, useDropdownMenu, useLiveTime, useRealtimeSession, useRunCollapseState, useRunGroups, useSSEStream, useSdkSession, useToolCallStream } from "@tangle-network/ui/hooks";
-/**
- * Sandbox-level telemetry collected by the sidecar from cgroup v2
- * (Docker) or /proc (Firecracker guest). `cpuPercent` is computed
- * server-side from consecutive samples; sections are null when the
- * source cannot provide them.
- */
-interface SystemMetricsSnapshot {
-  cpuPercent: number | null;
-  cpuCores: number;
-  memory: {
-    usedBytes: number;
-    totalBytes: number;
-  } | null;
-  disk: {
-    usedBytes: number;
-    totalBytes: number;
-    path: string;
-  } | null;
-  source: "cgroup-v2" | "proc";
-}
-interface LatencyPercentiles {
-  p50: number | null;
-  p95: number | null;
-  sampleCount: number;
-}
-interface SandboxLatencyMetrics {
-  ttftMs: LatencyPercentiles;
-  firstResponseMs: LatencyPercentiles;
-  runDurationMs: LatencyPercentiles;
-}
-/**
- * Shape returned by the sidecar `/metrics/json` endpoint. Only the
- * fields read by this hook are modeled; the sidecar may add more.
- */
-interface SidecarMetricsPayload {
-  process?: {
-    memoryBytes?: {
-      rss?: number;
-      heapTotal?: number;
-      heapUsed?: number;
-      external?: number;
-      arrayBuffers?: number;
-    };
-    cpuSeconds?: {
-      user?: number;
-      system?: number;
-    };
-  };
-  system?: SystemMetricsSnapshot | null;
-  latency?: SandboxLatencyMetrics;
-}
-/**
- * One polled time-series point, sourced from the sandbox-level
- * `system` section. Null values mean the sidecar could not provide
- * that reading — charts must render a gap, not a zero.
- */
-interface SandboxMetricsSample {
-  /** Wall-clock ms when the sample was committed client-side. */
-  at: number;
-  cpuPercent: number | null;
-  memoryUsedBytes: number | null;
-  memoryTotalBytes: number | null;
-  diskUsedBytes: number | null;
-  diskTotalBytes: number | null;
-}
-interface SandboxMetrics {
-  /**
-   * CPU% derived from consecutive samples. `null` on the first sample
-   * because a delta is required. Can exceed 100 on multi-core hosts.
-   */
-  cpuPercent: number | null;
-  rssBytes: number;
-  heapUsedBytes: number;
-  heapTotalBytes: number;
-}
-interface UseSandboxMetricsOptions {
-  /**
-   * Sandbox API base URL, e.g. `https://api.tangle.tools`.
-   * Use an empty string for same-origin requests.
-   */
-  apiBaseUrl: string;
-  /** Sandbox id; when falsy the hook stays idle. */
-  sandboxId?: string | null;
-  /**
-   * Optional bearer token. When omitted the fetch still sends
-   * credentials so a cookie session can authenticate the proxy.
-   */
-  token?: string | null;
-  /** Pause polling when false. Defaults to true. */
-  enabled?: boolean;
-  /** Poll cadence; clamped to a 500ms floor. Defaults to 3000. */
-  intervalMs?: number;
-  /** Max retained history samples for charting. Defaults to 120. */
-  historyLimit?: number;
-}
-interface UseSandboxMetricsResult {
-  metrics: SandboxMetrics | null;
-  /**
-   * Sandbox-level (container/VM) telemetry. Null until the sidecar
-   * reports a `system` section — older sidecars never will, and
-   * consumers must surface that as "unavailable", not zeros.
-   */
-  system: SystemMetricsSnapshot | null;
-  /** Agent latency percentiles (TTFT, first response, run duration). */
-  latency: SandboxLatencyMetrics | null;
-  /**
-   * Rolling window of system samples (oldest first), capped at
-   * `historyLimit`. Cleared when the target sandbox changes.
-   */
-  history: SandboxMetricsSample[];
-  /**
-   * True while waiting for the first successful metrics response for this
-   * sandbox. Errors clear it so consumers can show the failure state.
-   */
-  loading: boolean;
-  error: Error | null;
-  /** Wall-clock ms of the last successful metrics response, or null. */
-  lastUpdatedAt: number | null;
-}
-/**
- * Polls the sandbox's sidecar metrics through the API proxy and
- * derives a CPU% value from consecutive cumulative-CPU samples. Used
- * by the sandbox overview dashboard to drive live CPU/memory panels.
- */
-declare function useSandboxMetrics({ apiBaseUrl, sandboxId, token, enabled, intervalMs, historyLimit }: UseSandboxMetricsOptions): UseSandboxMetricsResult;
-/** List all sessions for a sidecar. */
-declare function useSessions(apiUrl: string, token: string | null): import("@tanstack/react-query").UseQueryResult<Session[], Error>;
-/** Create a new session. */
-declare function useCreateSession(apiUrl: string, token: string | null): import("@tanstack/react-query").UseMutationResult<Session, Error, string, unknown>;
-/** Delete a session by ID. */
-declare function useDeleteSession(apiUrl: string, token: string | null): import("@tanstack/react-query").UseMutationResult<unknown, Error, string, unknown>;
-/** Rename a session. */
-declare function useRenameSession(apiUrl: string, token: string | null): import("@tanstack/react-query").UseMutationResult<Session, Error, {
-  sessionId: string;
-  title: string;
-}, unknown>;
-/**
- * Same-origin JSON with ETag revalidation. `poll` refetches every `poll` ms while set; turning polling on or off keeps
- * the document. With `keepPrevious`, a new URL (a record's next digest) keeps showing the previous document until the
- * new one arrives, so a run being written never blanks between versions. A response marked stale is refetched until it is current.
- */
-declare function useDocument<T>(url: string | null, poll?: number, keepPrevious?: boolean, fetcher?: typeof fetch): {
-  url: string | null;
-  data?: T;
-  error?: string;
-  status?: number;
-  loading: boolean;
-  stale?: boolean;
-  failing?: string;
-};
-export { UseSandboxMetricsResult as $, useApiKey as A, useToolCallStream as B, UseRunGroupsOptions as C, UseSdkSessionReturn as D, UseSdkSessionOptions as E, useRealtimeSession as F, useSessions as G, useCreateSession as H, useRunCollapseState as I, SandboxMetrics as J, LatencyPercentiles as K, useRunGroups as L, useAutoScroll as M, useDropdownMenu as N, UseToolCallStreamReturn as O, useLiveTime as P, UseSandboxMetricsOptions as Q, useSSEStream as R, UseAuthResult as S, UseSSEStreamResult as T, useDeleteSession as U, useDocument as V, useRenameSession as W, SidecarMetricsPayload as X, SandboxMetricsSample as Y, SystemMetricsSnapshot as Z, SdkSessionEvent as _, AutomationStreamEvent as a, TerminalStreamEvent as b, CompleteAssistantMessageOptions as c, RealtimeSessionRegistry as d, useSandboxMetrics as et, RealtimeSessionRegistryProps as f, SdkSessionAttachment as g, SSEEvent as h, AuthUser as i, useAuth as j, createAuthFetcher as k, ConnectionState as l, RealtimeSessionTarget as m, AppendUserMessageOptions as n, BeginAssistantMessageOptions as o, RealtimeSessionState as p, SandboxLatencyMetrics as q, ApplySdkEventOptions as r, BotStreamEvent as s, AgentStreamEvent as t, RealtimeSessionOptions as u, SdkSessionSeed as v, UseSSEStreamOptions as w, UseAuthOptions as x, TaskStreamEvent as y, useSdkSession as z };