@tangle-network/sandbox-ui 2.0.17 → 2.0.18

package/dist/hooks.d.ts

@@ -1,141 +1,4 @@
 import { n as UsePtySessionReturn, r as usePtySession, t as UsePtySessionOptions } from "./use-pty-session-DSgtQyYX.js";
-import { t as Session } from "./sidecar-CNP4zXop.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 { 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";
-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, useDropdownMenu, useLiveTime, usePtySession, useRealtimeSession, useRunCollapseState, useRunGroups, useSSEStream, useSdkSession, useSessionStream, useSidecarAuth, useToolCallStream };
+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 };

package/dist/hooks.js

@@ -1,5 +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 * 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";
@@ -230,4 +231,4 @@ function useRenameSession(apiUrl, token) {
 		}
 	});
 }
-export { RealtimeSessionRegistry, SESSION_STREAM_RECONNECT_DELAY_MS, SessionStreamError, createAuthFetcher, useApiKey, useAuth, useAutoScroll, useCreateSession, useDeleteSession, useDropdownMenu, useLiveTime, usePtySession, useRealtimeSession, useRenameSession, useRunCollapseState, useRunGroups, useSSEStream, useSandboxMetrics, useSdkSession, useSessionStream, useSessions, useSidecarAuth, useToolCallStream };
+export { RealtimeSessionRegistry, SESSION_STREAM_RECONNECT_DELAY_MS, SessionStreamError, createAuthFetcher, useApiKey, useAuth, useAutoScroll, useCreateSession, useDeleteSession, useDocument, useDropdownMenu, useLiveTime, usePtySession, useRealtimeSession, useRenameSession, useRunCollapseState, useRunGroups, useSSEStream, useSandboxMetrics, useSdkSession, useSessionStream, useSessions, useSidecarAuth, useToolCallStream };

package/dist/{index-BtR5Sc3u.d.ts → index-BnaVprN6.d.ts}

@@ -1,7 +1,8 @@
 import { l as AgentGraphNode, u as AgentGraphProps$1 } from "./AgentGraph-P7l-jZwo.js";
+import { t as AgentStreamOpener } from "./agent-stream-CBZ2fXJ2.js";
 import "./index-DRLVHl-o.js";
 import { ReactNode } from "react";
-import { ApprovalCard, ApprovalCardProps, ApprovalDiffFile, ApprovalDiffSummary, ApprovalPlanStep, ExpandedToolDetail as ExpandedToolDetail$1, ExpandedToolDetailProps, FeedSegment, InlineThinkingItem as InlineThinkingItem$1, InlineThinkingItemProps, InlineToolItem, InlineToolItemProps, LiveDuration, RunGroup, RunGroupProps, RunPhase, RunPhaseList, RunRowShell as RunRowShell$1, RunRowShellProps, RunRowStatus, RunRowStatusDot, RunStatus, RunStatusIcon as RunStatusIcon$1, RunStatusIconProps, StatusMeta, TaskList, TaskListItem, TaskListProps, TaskStatus, ToolCallData, ToolCallData as ToolCallData$1, ToolCallFeed, ToolCallFeedProps, ToolCallStatus, ToolCallType, parseToolEvent, runStatus as runStatus$1, showsTaskPriority, statusMeta as statusMeta$1, taskProgress, taskStatus } from "@tangle-network/ui/run";
+import { ApprovalCard, ApprovalCardProps, ApprovalDiffFile, ApprovalDiffSummary, ApprovalPlanStep, ExpandedToolDetail as ExpandedToolDetail$1, ExpandedToolDetailProps, FeedSegment, InlineThinkingItem as InlineThinkingItem$1, InlineThinkingItemProps, InlineToolItem, InlineToolItemProps, LiveDuration, RunGroup, RunGroupProps, RunPhase, RunPhaseList, RunRowShell as RunRowShell$1, RunRowShellProps, RunRowStatus, RunRowStatusDot, RunStatus, RunStatusIcon as RunStatusIcon$1, RunStatusIconProps, StatusMeta, TaskList, TaskListItem, TaskListProps, TaskStatus, ToolCallData as ToolCallData$1, ToolCallFeed, ToolCallFeedProps, ToolCallStatus, ToolCallType, parseToolEvent, runStatus as runStatus$1, showsTaskPriority, statusMeta as statusMeta$1, taskProgress, taskStatus } from "@tangle-network/ui/run";
 import { FlowWaterfallProps } from "@tangle-network/charts/react";
 import { LatestEvents, LatestEventsProps } from "@tangle-network/charts/react/agent-graph";
 import { FlowMarker, FlowSpan, FlowTrace } from "@tangle-network/charts";
@@ -14,70 +15,6 @@ type TraceWaterfallProps = FlowWaterfallProps;
  * `traces convert` contract. Import `@tangle-network/charts/react/flow-waterfall.css` once.
  */
 declare function TraceWaterfall({ renderIcon, ...props }: TraceWaterfallProps): import("react").JSX.Element;
-/** Host-owned authenticated streams keep their own reconnect and session lifecycle. */
-interface AgentStreamSource {
-  addEventListener(type: string, listener: (event: MessageEvent<string>) => void): void;
-  close(): void;
-}
-type AgentStreamOpener = (url: string, onLiveChange?: (live: boolean) => void) => AgentStreamSource;
-/** One row of an agent's message stream (tangle-tools `/api/discovery/runs/<run>/agents/<agent>/stream`). */
-interface AgentStreamRow {
-  seq: number;
-  /** ISO time the event happened. */
-  at: string;
-  stream?: string;
-  attempt?: number;
-  event: {
-    kind: "text" | "reasoning" | "tool-call" | "tool-result" | "user" | "notice" | (string & {});
-    text?: string;
-    /** A notice's origin: the agent's `delegated-input`, its `recorded-result`, or a capture fact such as `capture-unavailable`. */
-    provenance?: string;
-    toolCallId?: string;
-    toolName?: string;
-    args?: unknown;
-    result?: unknown;
-  };
-}
-/** A transcript entry with the time it began, so a time cursor can show the conversation as of any moment. */
-type AgentTranscriptEntry = {
-  id: string;
-  at: number;
-  kind: "message";
-  role: "assistant" | "user";
-  content: string;
-  sealed?: true;
-} | {
-  id: string;
-  at: number;
-  kind: "reasoning";
-  text: string;
-} | {
-  id: string;
-  at: number;
-  kind: "tool";
-  call: ToolCallData;
-} | {
-  id: string;
-  at: number;
-  kind: "notice";
-  text: string;
-};
-interface AgentStreamState {
-  generation?: string | number;
-  entries: AgentTranscriptEntry[];
-  lastSeq: number;
-  /** The agent is still producing output. */
-  alive: boolean;
-  /** Why the stream shows nothing new; a reconnect that delivers rows clears it. */
-  error?: string;
-}
-/** Fold stream rows into transcript entries: text of one turn merges, a tool call becomes a row its result completes. */
-declare function foldAgentRows(entries: AgentTranscriptEntry[], rows: readonly AgentStreamRow[]): AgentTranscriptEntry[];
-/**
- * Follow one agent's message stream over Server-Sent Events: `rows`, `reset` and `end` events, reconnecting with
- * `?after=<lastSeq>` when the server closes the connection, so a long turn streams without gaps or repeats.
- */
-declare function useAgentStream(url: string | undefined, openEventSource?: AgentStreamOpener): AgentStreamState;
 /** A moment on the run's event track: a release, a check verdict, a spawn, a crash or a steer. */
 interface TraceEvent extends FlowMarker {}
 interface TraceWorkspaceProps extends Omit<TraceWaterfallProps, "trace" | "markers" | "onSelect" | "onTimeChange" | "selectedId" | "onDeselect" | "graph" | "latestEvents"> {
@@ -119,4 +56,4 @@ interface TraceWorkspaceProps extends Omit<TraceWaterfallProps, "trace" | "marke
  * every panel shows what was true at the cursor, and the conversation shows what had been said by then.
  */
 declare function TraceWorkspace({ trace, streamUrl, openEventSource, events, onTimeChange, files, scoreboard, selectedAgentId, conversationOpen, onSelectAgent, agentCards, agentGraph, className, ...waterfall }: TraceWorkspaceProps): import("react").JSX.Element;
-export { TraceWaterfall as $, ToolCallData$1 as A, taskStatus as B, RunStatusIcon$1 as C, TaskListItem as D, TaskList as E, parseToolEvent as F, TraceWorkspaceProps as G, LatestEventsProps as H, runStatus$1 as I, AgentStreamSource as J, AgentStreamOpener as K, showsTaskPriority as L, ToolCallFeedProps as M, ToolCallStatus as N, TaskListProps as O, ToolCallType as P, useAgentStream as Q, statusMeta$1 as R, RunStatus as S, StatusMeta as T, TraceEvent as U, LatestEvents as V, TraceWorkspace as W, AgentTranscriptEntry as X, AgentStreamState as Y, foldAgentRows as Z, RunPhaseList as _, ApprovalPlanStep as a, RunRowStatus as b, FeedSegment as c, InlineToolItem as d, TraceWaterfallProps as et, InlineToolItemProps as f, RunPhase as g, RunGroupProps as h, ApprovalDiffSummary as i, ToolCallFeed as j, TaskStatus as k, InlineThinkingItem$1 as l, RunGroup as m, ApprovalCardProps as n, ExpandedToolDetail$1 as o, LiveDuration as p, AgentStreamRow as q, ApprovalDiffFile as r, ExpandedToolDetailProps as s, ApprovalCard as t, traceSpanMark as tt, InlineThinkingItemProps as u, RunRowShell$1 as v, RunStatusIconProps as w, RunRowStatusDot as x, RunRowShellProps as y, taskProgress as z };
+export { ToolCallData$1 as A, taskStatus as B, RunStatusIcon$1 as C, TaskListItem as D, TaskList as E, parseToolEvent as F, TraceWorkspaceProps as G, LatestEventsProps as H, runStatus$1 as I, traceSpanMark as J, TraceWaterfall as K, showsTaskPriority as L, ToolCallFeedProps as M, ToolCallStatus as N, TaskListProps as O, ToolCallType as P, statusMeta$1 as R, RunStatus as S, StatusMeta as T, TraceEvent as U, LatestEvents as V, TraceWorkspace as W, RunPhaseList as _, ApprovalPlanStep as a, RunRowStatus as b, FeedSegment as c, InlineToolItem as d, InlineToolItemProps as f, RunPhase as g, RunGroupProps as h, ApprovalDiffSummary as i, ToolCallFeed as j, TaskStatus as k, InlineThinkingItem$1 as l, RunGroup as m, ApprovalCardProps as n, ExpandedToolDetail$1 as o, LiveDuration as p, TraceWaterfallProps as q, ApprovalDiffFile as r, ExpandedToolDetailProps as s, ApprovalCard as t, InlineThinkingItemProps as u, RunRowShell$1 as v, RunStatusIconProps as w, RunRowStatusDot as x, RunRowShellProps as y, taskProgress as z };

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

@@ -0,0 +1,155 @@
+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 };

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";
@@ -16,7 +16,8 @@ import { C as ChangedFile, D as SandboxArtifactTerminal, E as SandboxArtifactPan
 import { n as DiffViewProps, t as DiffView } from "./diff-view-DDHWtR6X.js";
 import { a as PreviewReadiness, i as PreviewAccess, n as EmbeddedAppView, r as EmbeddedAppViewProps, t as EmbeddedApp } from "./embedded-app-view-Ta5GI4hx.js";
 import { OPENUI_NODE_JSON_SCHEMA, OPENUI_NODE_TYPES, OpenUIAction, OpenUIActionsNode, OpenUIArtifactRenderer, OpenUIArtifactRendererProps, OpenUIBadgeNode, OpenUICardNode, OpenUICodeNode, OpenUIComponentNode, OpenUIGridNode, OpenUIHeadingNode, OpenUIKeyValueNode, OpenUIMarkdownNode, OpenUIPrimitive, OpenUISchemaIssue, OpenUISchemaValidation, OpenUISeparatorNode, OpenUIStackNode, OpenUIStatNode, OpenUITableNode, OpenUITextNode, findUnsupportedOpenUINode, validateOpenUIJsonArtifact, validateOpenUIJsonNode } from "./openui.js";
-import { $ as TraceWaterfall, A as ToolCallData, B as taskStatus, C as RunStatusIcon, D as TaskListItem, E as TaskList, F as parseToolEvent, G as TraceWorkspaceProps, H as LatestEventsProps, I as runStatus, J as AgentStreamSource, K as AgentStreamOpener, L as showsTaskPriority, M as ToolCallFeedProps, N as ToolCallStatus, O as TaskListProps, P as ToolCallType, Q as useAgentStream, R as statusMeta, S as RunStatus, T as StatusMeta, U as TraceEvent, V as LatestEvents, W as TraceWorkspace, X as AgentTranscriptEntry, Y as AgentStreamState, Z as foldAgentRows, _ as RunPhaseList, a as ApprovalPlanStep, b as RunRowStatus, c as FeedSegment, d as InlineToolItem, et as TraceWaterfallProps, f as InlineToolItemProps, g as RunPhase, h as RunGroupProps, i as ApprovalDiffSummary, j as ToolCallFeed, k as TaskStatus, l as InlineThinkingItem, m as RunGroup, n as ApprovalCardProps, o as ExpandedToolDetail, p as LiveDuration, q as AgentStreamRow, r as ApprovalDiffFile, s as ExpandedToolDetailProps, t as ApprovalCard, tt as traceSpanMark, u as InlineThinkingItemProps, v as RunRowShell, w as RunStatusIconProps, x as RunRowStatusDot, y as RunRowShellProps, z as taskProgress } from "./index-BtR5Sc3u.js";
+import { A as ToolCallData, B as taskStatus, C as RunStatusIcon, D as TaskListItem, E as TaskList, F as parseToolEvent, G as TraceWorkspaceProps, H as LatestEventsProps, I as runStatus, J as traceSpanMark, K as TraceWaterfall, L as showsTaskPriority, M as ToolCallFeedProps, N as ToolCallStatus, O as TaskListProps, P as ToolCallType, R as statusMeta, S as RunStatus, T as StatusMeta, U as TraceEvent, V as LatestEvents, W as TraceWorkspace, _ as RunPhaseList, a as ApprovalPlanStep, b as RunRowStatus, c as FeedSegment, d as InlineToolItem, f as InlineToolItemProps, g as RunPhase, h as RunGroupProps, i as ApprovalDiffSummary, j as ToolCallFeed, k as TaskStatus, l as InlineThinkingItem, m as RunGroup, n as ApprovalCardProps, o as ExpandedToolDetail, p as LiveDuration, q as TraceWaterfallProps, r as ApprovalDiffFile, s as ExpandedToolDetailProps, t as ApprovalCard, u as InlineThinkingItemProps, v as RunRowShell, w as RunStatusIconProps, x as RunRowStatusDot, y as RunRowShellProps, z as taskProgress } from "./index-BnaVprN6.js";
+import { a as AgentTranscriptEntry, i as AgentStreamState, n as AgentStreamRow, o as foldAgentRows, r as AgentStreamSource, s as useAgentStream, t as AgentStreamOpener } from "./agent-stream-CBZ2fXJ2.js";
 import { a as EventFlag, c as indexRecord, d as ConversationNode, f as ConversationRecord, i as ConversationProps, l as model_d_exports, n as withPrompts, o as RecordIndex, r as Conversation, s as ToolCall, t as VirtualList, u as ConversationEvent } from "./index-DRLVHl-o.js";
 import { n as filterFileNodes, t as fileTreeFromPaths } from "./index-CrN4d8gd.js";
 import { ActiveProjectActivity, ActiveSessionActivityOptions, ActiveSessionConnectionOptions, ActiveSessionConnectionState, ActiveSessionReconnectState, ActiveSessionRecord, ActiveSessionStatus, ActiveSessionTransportMode, ActiveSessionsState, ChatSession, RegisterActiveSessionOptions, SessionProjectKey, activeSessionsAtom, addMessage, addParts, bumpActiveSessionActivity, clearChat, connectSession, disconnectSession, getActiveSession, getAllActiveSessions, getAllProjectActivity, getSessionsByActivity, getSessionsForNavbar, getSessionsForProject, getTotalRunningSessionCount, hasBackgroundRunningSessions, isStreamingAtom, messagesAtom, partMapAtom, registerActiveSession, resetActiveSessions, sessionAtom, setActiveSessionAttention, setActiveSessionConnection, setActiveSessionError, setActiveSessionRunning, setForegroundActiveSession, unregisterActiveSession, updateActiveSessionMeta, updatePart, useActiveSession, useActiveSessions, useActiveSessionsState, useHasBackgroundRunningSessions, useNavbarSessions, useProjectActivity, useProjectSessions, useSessionsByActivity, useTotalRunningSessions } from "./stores.js";

package/dist/index.js

@@ -1,19 +1,22 @@
 import { $ as ContextMenuShortcut, $n as TabsContent, $t as Popover, A as Card, An as SheetHeader, Ar as seriesAreaPath, At as DropdownMenuSubTrigger, B as CollapsibleContent, Bn as StatCard, Br as TangleKnot, Bt as HoverCardHeader, C as BreadcrumbLink, Cn as SettingsRow, Cr as fieldMessageId, Ct as DropdownMenuPortal, D as Button, Dn as SheetContent, Dr as normalizeSeries, Dt as DropdownMenuShortcut, E as BreadcrumbSeparator, En as SheetClose, Er as localToday, Et as DropdownMenuSeparator, F as CardTitle, Fn as SidebarDropZone, Fr as toneFor, Ft as Heading, G as ContextMenuContent, Gn as TableBody, Gt as Input, H as ComplianceBadge, Hn as Switch, Ht as HoverCardTrigger, I as Checkbox, In as Skeleton, Ir as useTheme, It as HelpText, J as ContextMenuLabel, Jn as TableFooter, Jt as MetricChart, K as ContextMenuGroup, Kn as TableCaption, Kt as Label, L as Chip, Ln as SkeletonCard, Lr as useToast, Lt as HoverCard, M as CardDescription, Mn as SheetPortal, Mr as seriesLinePath, Mt as EmptyState, N as CardFooter, Nn as SheetTitle, Nr as seriesMean, Nt as Field, O as CATEGORY_TONES, On as SheetDescription, Or as parseCalendarDate, Ot as DropdownMenuSub, P as CardHeader, Pn as SheetTrigger, Pr as seriesScale, Pt as FilterField, Q as ContextMenuSeparator, Qn as Tabs, Qt as Pagination, R as CodeBlock, Rn as SkeletonTable, Rr as SectionTitle, Rt as HoverCardContent, S as BreadcrumbItem, Sn as SettingsNote, Sr as buttonVariants, St as DropdownMenuLabel, T as BreadcrumbPage, Tn as Sheet, Tr as initialsOf, Tt as DropdownMenuRadioItem, U as ContextMenu, Un as TONE_CLASSES, Ut as IconTile, V as CollapsibleTrigger, Vn as StatusPill, Vt as HoverCardTitle, W as ContextMenuCheckboxItem, Wn as Table, Wt as InlineCode, X as ContextMenuRadioGroup, Xn as TableHeader, Xt as PageHeader, Y as ContextMenuPortal, Yn as TableHead, Yt as MetricStrip, Z as ContextMenuRadioItem, Zn as TableRow, Zt as PageShell, _ as AvatarFallback, _n as SelectValue, _r as TooltipTrigger, _t as DropdownMenu, a as AlertDialogCancel, an as RadioGroup, ar as TerminalInput, at as DatePicker, b as Breadcrumb, bn as SettingsList, br as WizardStep, bt as DropdownMenuGroup, c as AlertDialogFooter, cn as Select, cr as Textarea, ct as DialogContent, d as AlertDialogPortal, dn as SelectItem, dr as ToastContainer, dt as DialogHeader, en as PopoverAnchor, er as TabsList, et as ContextMenuSub, f as AlertDialogTitle, fn as SelectLabel, fr as ToastProvider, ft as DialogOverlay, g as Avatar, gn as SelectTrigger, gr as TooltipProvider, gt as DropZone, h as ArtifactPane, hn as SelectSeparator, hr as TooltipContent, ht as DialogTrigger, i as AlertDialogAction, in as Progress, ir as TerminalDisplay, it as CopyButton, j as CardContent, jn as SheetOverlay, jr as seriesExtent, jt as DropdownMenuTrigger, k as Calendar, kn as SheetFooter, kr as periodDelta, kt as DropdownMenuSubContent, l as AlertDialogHeader, ln as SelectContent, lr as ThemeToggle, lt as DialogDescription, m as AlertTitle, mn as SelectScrollUpButton, mr as Tooltip, mt as DialogTitle, n as AlertDescription, nn as PopoverContent, nr as Tag, nt as ContextMenuSubTrigger, o as AlertDialogContent, on as RadioGroupItem, or as TerminalLine, ot as Dialog, p as AlertDialogTrigger, pn as SelectScrollDownButton, pr as Toolbar, pt as DialogPortal, q as ContextMenuItem, qn as TableCell, qt as Metric, r as AlertDialog, rn as PopoverTrigger, rr as TerminalCursor, rt as ContextMenuTrigger, s as AlertDialogDescription, sn as SegmentedControl, sr as TextShimmer, st as DialogClose, t as Alert, tn as PopoverClose, tr as TabsTrigger, tt as ContextMenuSubContent, u as AlertDialogOverlay, un as SelectGroup, ur as TimeSelect, ut as DialogFooter, v as AvatarImage, vn as Separator, vr as UploadProgress, vt as DropdownMenuCheckboxItem, w as BreadcrumbList, wn as SettingsSection, wr as formatCalendarDate, wt as DropdownMenuRadioGroup, x as BreadcrumbEllipsis, xn as SettingsListItem, xr as badgeVariants, xt as DropdownMenuItem, y as Badge, yn as SeriesSparkline, yr as Wizard, yt as DropdownMenuContent, z as Collapsible, zn as Slider, zr as Logo, zt as HoverCardDescription } from "./primitives-znfPK9NP.js";
 import { i as WorkspacePaneHeader, n as SHELL_INSET_GUTTER, r as ShellHeader, t as SHELL_HEADER_HEIGHT } from "./shell-header-CwqDzC4I.js";
-import { C as WorkspaceSurfaceTitle, S as WorkspaceSurfaceFrame, _ as StatusBar, a as TaskBoard, b as WorkspaceLayout, c as createShellShouldRevalidate, d as SESSION_CREATED_EVENT, f as dispatchSessionCreated, g as TerminalPanel, h as RuntimePane, i as CalendarView, l as shellShouldRevalidate, m as formatRelativeAge, n as WorkspaceFilesPane, o as SandboxWorkbench, p as useOptimisticSessionItems, r as ApprovalQueue, s as WorkspaceArtifactView, u as SessionSidebar, v as StatusBanner, x as WorkspaceSurface, y as DirectoryPane } from "./workspace-CJnBqCqj.js";
+import { S as WorkspaceSurfaceTitle, _ as StatusBanner, a as SandboxWorkbench, b as WorkspaceSurface, c as shellShouldRevalidate, d as dispatchSessionCreated, f as useOptimisticSessionItems, g as StatusBar, h as TerminalPanel, i as TaskBoard, l as SessionSidebar, m as RuntimePane, n as ApprovalQueue, o as WorkspaceArtifactView, p as formatRelativeAge, r as CalendarView, s as createShellShouldRevalidate, u as SESSION_CREATED_EVENT, v as DirectoryPane, x as WorkspaceSurfaceFrame, y as WorkspaceLayout } from "./workspace-CzikYt_y.js";
 import { i as VaultTree, n as filterFileNodes, r as VAULT_TREE_CHILD_PAGE, t as fileTreeFromPaths } from "./tree-data-C8CNt4WE.js";
+import { t as WorkspaceFilesPane } from "./workspace-files-pane-DB9Nvwh4.js";
 import { $ as useSidebar, A as parseInsufficientBalance, B as SidebarPanel, C as SandboxStatusPill, D as ResourceMeter, E as ResourceSnapshot, F as RailHeader, G as SidebarRailNav, H as SidebarPanelHeader, I as RailModeButton, J as SIDEBAR_PANEL_WIDTH, K as RailTooltip, L as RailSeparator, M as RailButton, N as RailExpandable, O as INSUFFICIENT_BALANCE_CODE, P as RailFlyout, Q as SidebarProvider, R as Sidebar, S as SANDBOX_STATUS, T as ActivityFeed, U as SidebarRail, V as SidebarPanelContent, W as SidebarRailFooter, X as SIDEBAR_RAIL_WIDTH, Y as SIDEBAR_RAIL_LABELED_WIDTH, Z as SIDEBAR_TOTAL_WIDTH, _ as BackendSelector, a as PortsList, b as SandboxCard, c as SystemLogsViewer, d as DashboardLayout, f as HARNESS_OPTIONS, g as HarnessLogo, h as HARNESS_BRAND, i as TemplateCard, j as ProfileAvatar, k as OutOfCreditsModal, l as MetricAreaChart, m as chatCapableHarnesses, n as SnapshotList, o as GitPanel, p as HarnessPicker, q as SIDEBAR_MOBILE_WIDTH, r as ProcessList, s as UsageSummary, t as PromoBanner, u as SidebarLayout, v as SandboxTable, w as sandboxStatus, x as canAdminSandbox, y as NewSandboxCard, z as SidebarContent } from "./dashboard-exTS8tta.js";
 import { i as modelBrandFor, n as ProviderMark, r as canonicalModelId, t as ModelBrandStack } from "./model-brand-BQlarCIo.js";
 import { a as formatPrice, i as PricingPage, n as SandboxPageShell, o as BillingDashboard, r as UsageChart, t as DashboardPageHeader } from "./page-layout-CuOpvZys.js";
 import { t as usePtySession } from "./use-pty-session-BHVQlSs-.js";
-import { a as DiffStatsBadge, c as PillTabs, i as FileBreadcrumb, n as SandboxArtifactPane, o as GitStatusBadge, r as CodeView, s as PanelHeader, t as ChangesPane } from "./workbench-BozOdGCX.js";
+import { a as PanelHeader, i as GitStatusBadge, n as SandboxArtifactPane, o as PillTabs, r as DiffStatsBadge, t as ChangesPane } from "./workbench-Z9wbei53.js";
 import { CSV_PREVIEW_ROW_LIMIT, FileArtifactPane, FileCard, FileList, FilePreview, FileTabs, FileTree, PdfViewer, RichFileTree, configurePdfViewer, detectFileFormat, fileExtension, filterFileTree, getCodeLanguage, getFormatLabel, getSyntaxLanguage, parseCsv, resolveFilePreviewKind } from "./files.js";
 import { a as CodeSurface, i as CODE_THEME, n as buildUnifiedPatch, r as computeDiffStats, t as DiffView } from "./diff-view-B9mNeTLF.js";
+import { n as FileBreadcrumb, t as CodeView } from "./code-view-BlhCS1SD.js";
 import { n as PreviewView, t as EmbeddedAppView } from "./embedded-app-view-DXsoPale.js";
 import { OPENUI_NODE_JSON_SCHEMA, OPENUI_NODE_TYPES, OpenUIArtifactRenderer, findUnsupportedOpenUINode, validateOpenUIJsonArtifact, validateOpenUIJsonNode } from "./openui.js";
 import { S as ReasoningLevelPicker, _ as modelProvider, a as ChatMessage, b as DEFAULT_REASONING_LEVEL_OPTIONS, c as SpeakerHeader, d as UserMessage, f as agentTimelineStepKind, g as ArtifactAgentDock, h as partitionBySpeaker, i as ChatContainer, l as TRANSCRIPT_TEXT, m as isViewerMessage, n as AgentTimelineColumn, o as MessageAuthor, p as foldSummary, r as AgentTimelineStep, s as MessageList, t as AgentTimeline, u as ThinkingIndicator, v as snapHarnessToModel, x as HARNESS_REASONING_OPTIONS, y as AgentProfilePicker } from "./chat-BU39pb2j.js";
-import { C as useAgentStream, S as foldAgentRows, T as traceSpanMark, _ as statusMeta, a as InlineToolItem, b as TraceWorkspace, c as RunPhaseList, d as RunStatusIcon, f as TaskList, g as showsTaskPriority, h as runStatus, i as InlineThinkingItem, l as RunRowShell, m as parseToolEvent, n as ApprovalDiffSummary, o as LiveDuration, p as ToolCallFeed, r as ExpandedToolDetail, s as RunGroup, t as ApprovalCard, u as RunRowStatusDot, v as taskProgress, w as TraceWaterfall, x as LatestEvents, y as taskStatus } from "./run-CJ48hJz0.js";
+import { a as TraceWaterfall, i as useAgentStream, n as LatestEvents, o as traceSpanMark, r as foldAgentRows, t as TraceWorkspace } from "./trace-workspace-C8dHRBDV.js";
 import { a as VirtualList, i as model_exports, n as Conversation, r as indexRecord, t as withPrompts } from "./record-Bqt1kE_Q.js";
+import { ApprovalCard, ApprovalDiffSummary, ExpandedToolDetail, InlineThinkingItem, InlineToolItem, LiveDuration, RunGroup, RunPhaseList, RunRowShell, RunRowStatusDot, RunStatusIcon, TaskList, ToolCallFeed, parseToolEvent, runStatus, showsTaskPriority, statusMeta, taskProgress, taskStatus } from "./run.js";
 import "./vault-tree.js";
 import { a as TangleLoginButton, i as UserMenu, n as GitHubLoginButton, r as LoginLayout, t as AuthHeader } from "./auth-BDpoZ_2f.js";
 import { t as AgentMessagingConnection } from "./connections-DymjzHe_.js";

package/dist/run/live.d.ts

@@ -0,0 +1,10 @@
+import { t as AgentStreamOpener } from "../agent-stream-CBZ2fXJ2.js";
+export interface LiveRunTransport {
+  fetch?: typeof globalThis.fetch;
+  openEventSource?: AgentStreamOpener;
+}
+/** Both the Discovery host and agent-runtime-top mount this same stream consumer and shared run workspace. */
+export declare function LiveRun(props: {
+  api: string;
+  transport?: LiveRunTransport;
+}): import("react").JSX.Element;