@tangle-network/sandbox-ui 0.113.6 → 0.114.0

package/dist/hooks.d.ts

@@ -1,46 +1,42 @@
-export { 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';
-import { AgentInteractiveSessionControlClaim } from '@tangle-network/agent-interface';
-import * as _tanstack_react_query from '@tanstack/react-query';
-import { Session } from './types.js';
-export { f as SESSION_STREAM_RECONNECT_DELAY_MS, g as SendMessageOptions, S as SessionDegradation, a as SessionInfo, h as SessionStreamError, b as SidecarAuth, U as UseSessionStreamOptions, c as UseSessionStreamResult, d as UseSidecarAuthOptions, u as useSessionStream, e as useSidecarAuth } from './sdk-hooks-Djkjq4cp.js';
-import '@tangle-network/ui/types';
-import '@tangle-network/ui/stores';
-import '@tangle-network/ui/sdk-hooks';
-
-interface UsePtySessionOptions {
-    /** Base URL of the sidecar (e.g. "http://localhost:9100"). */
-    apiUrl: string;
-    /** Bearer token for authentication. */
-    token: string;
-    /** Called with raw PTY output (may contain ANSI escape codes). */
-    onData: (data: string) => void;
-    /**
-     * Stable id identifying this terminal connection to the sidecar.
-     * Reused on every connect/reconnect so the sidecar restores the same
-     * PTY session (within its reconnect window) instead of spawning a
-     * fresh shell. When omitted, a random id is generated per connect —
-     * so the session does not survive a remount.
-     */
-    connectionId?: string;
-    /**
-     * Exact incarnation issued for an interactive agent session. When present,
-     * it must be sent with `control` on every WebSocket init frame.
-     */
-    incarnationId?: string;
-    /** Write claim for the exact interactive agent session. */
-    control?: AgentInteractiveSessionControlClaim;
+import { t as Session } from "./sidecar-DgH_vQ6m.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-CCTJcrq7.js";
+import { AgentInteractiveSessionControlClaim } from "@tangle-network/agent-interface";
+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";
+//#region src/hooks/use-pty-session.d.ts
+export interface UsePtySessionOptions {
+  /** Base URL of the sidecar (e.g. "http://localhost:9100"). */
+  apiUrl: string;
+  /** Bearer token for authentication. */
+  token: string;
+  /** Called with raw PTY output (may contain ANSI escape codes). */
+  onData: (data: string) => void;
+  /**
+   * Stable id identifying this terminal connection to the sidecar.
+   * Reused on every connect/reconnect so the sidecar restores the same
+   * PTY session (within its reconnect window) instead of spawning a
+   * fresh shell. When omitted, a random id is generated per connect —
+   * so the session does not survive a remount.
+   */
+  connectionId?: string;
+  /**
+   * Exact incarnation issued for an interactive agent session. When present,
+   * it must be sent with `control` on every WebSocket init frame.
+   */
+  incarnationId?: string;
+  /** Write claim for the exact interactive agent session. */
+  control?: AgentInteractiveSessionControlClaim;
 }
-interface UsePtySessionReturn {
-    /** Whether the underlying transport is connected and receiving data. */
-    isConnected: boolean;
-    /** Connection or API error, if any. */
-    error: string | null;
-    /** Send a command to the PTY session. */
-    sendCommand: (command: string) => Promise<void>;
-    /** Safely resize the remote PTY. */
-    resizeTerminal: (cols: number, rows: number) => Promise<void>;
-    /** Tear down and reconnect. */
-    reconnect: () => void;
+export interface UsePtySessionReturn {
+  /** Whether the underlying transport is connected and receiving data. */
+  isConnected: boolean;
+  /** Connection or API error, if any. */
+  error: string | null;
+  /** Send a command to the PTY session. */
+  sendCommand: (command: string) => Promise<void>;
+  /** Safely resize the remote PTY. */
+  resizeTerminal: (cols: number, rows: number) => Promise<void>;
+  /** Tear down and reconnect. */
+  reconnect: () => void;
 }
 /**
  * Manages a PTY session against the sidecar terminal API.
@@ -66,143 +62,145 @@ interface UsePtySessionReturn {
  * preserved as a fallback so the hook keeps working against
  * deployments that have not yet shipped the WS endpoint.
  */
-declare function usePtySession({ apiUrl, token, onData, connectionId: providedConnectionId, incarnationId, control, }: UsePtySessionOptions): UsePtySessionReturn;
-
+export declare function usePtySession({ apiUrl, token, onData, connectionId: providedConnectionId, incarnationId, control }: UsePtySessionOptions): UsePtySessionReturn;
+//#endregion
+//#region src/hooks/use-sandbox-metrics.d.ts
 /**
  * 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";
+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";
 }
-interface LatencyPercentiles {
-    p50: number | null;
-    p95: number | null;
-    sampleCount: number;
+export interface LatencyPercentiles {
+  p50: number | null;
+  p95: number | null;
+  sampleCount: number;
 }
-interface SandboxLatencyMetrics {
-    ttftMs: LatencyPercentiles;
-    firstResponseMs: LatencyPercentiles;
-    runDurationMs: LatencyPercentiles;
+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.
  */
-interface SidecarMetricsPayload {
-    process?: {
-        memoryBytes?: {
-            rss?: number;
-            heapTotal?: number;
-            heapUsed?: number;
-            external?: number;
-            arrayBuffers?: number;
-        };
-        cpuSeconds?: {
-            user?: number;
-            system?: number;
-        };
+export interface SidecarMetricsPayload {
+  process?: {
+    memoryBytes?: {
+      rss?: number;
+      heapTotal?: number;
+      heapUsed?: number;
+      external?: number;
+      arrayBuffers?: number;
     };
-    system?: SystemMetricsSnapshot | null;
-    latency?: SandboxLatencyMetrics;
+    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;
+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;
 }
-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 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`. */
-    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 UseSandboxMetricsOptions {
+  /** Sandbox API base URL, e.g. `https://api.tangle.tools`. */
+  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 only until the first successful sample has arrived (or the
-     * first one after the target `sandboxId` changes). Subsequent polls
-     * do not flip this back to true, so consumers can gate a spinner
-     * on it without it flashing on every cycle.
-     */
-    loading: boolean;
-    error: Error | null;
-    /** Wall-clock ms of the last successful sample, or null. */
-    lastUpdatedAt: number | null;
+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 only until the first successful sample has arrived (or the
+   * first one after the target `sandboxId` changes). Subsequent polls
+   * do not flip this back to true, so consumers can gate a spinner
+   * on it without it flashing on every cycle.
+   */
+  loading: boolean;
+  error: Error | null;
+  /** Wall-clock ms of the last successful sample, 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;
-
+export declare function useSandboxMetrics({ apiBaseUrl, sandboxId, token, enabled, intervalMs, historyLimit }: UseSandboxMetricsOptions): UseSandboxMetricsResult;
+//#endregion
+//#region src/hooks/use-session-crud.d.ts
 /** List all sessions for a sidecar. */
-declare function useSessions(apiUrl: string, token: string | null): _tanstack_react_query.UseQueryResult<NoInfer<Session[]>, Error>;
+export 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): _tanstack_react_query.UseMutationResult<Session, Error, string, unknown>;
+export 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): _tanstack_react_query.UseMutationResult<unknown, Error, string, unknown>;
+export 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): _tanstack_react_query.UseMutationResult<Session, Error, {
-    sessionId: string;
-    title: string;
+export declare function useRenameSession(apiUrl: string, token: string | null): import("@tanstack/react-query").UseMutationResult<Session, Error, {
+  sessionId: string;
+  title: string;
 }, unknown>;
-
-export { type LatencyPercentiles, type SandboxLatencyMetrics, type SandboxMetrics, type SandboxMetricsSample, type SidecarMetricsPayload, type SystemMetricsSnapshot, type UsePtySessionOptions, type UsePtySessionReturn, type UseSandboxMetricsOptions, type UseSandboxMetricsResult, useCreateSession, useDeleteSession, usePtySession, useRenameSession, useSandboxMetrics, useSessions };
+//#endregion
+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, type UseRunGroupsOptions, type UseSSEStreamOptions, type UseSSEStreamResult, type UseSdkSessionOptions, type UseSdkSessionReturn, UseSessionStreamOptions, UseSessionStreamResult, UseSidecarAuthOptions, type UseToolCallStreamReturn, createAuthFetcher, useApiKey, useAuth, useAutoScroll, useDropdownMenu, useLiveTime, useRealtimeSession, useRunCollapseState, useRunGroups, useSSEStream, useSdkSession, useSessionStream, useSidecarAuth, useToolCallStream };

package/dist/hooks.js

@@ -1,55 +1,222 @@
-import {
-  RealtimeSessionRegistry,
-  createAuthFetcher,
-  useApiKey,
-  useAuth,
-  useAutoScroll,
-  useCreateSession,
-  useDeleteSession,
-  useDropdownMenu,
-  useLiveTime,
-  useRealtimeSession,
-  useRenameSession,
-  useRunCollapseState,
-  useRunGroups,
-  useSSEStream,
-  useSandboxMetrics,
-  useSdkSession,
-  useSessions,
-  useToolCallStream
-} from "./chunk-SOKKTB7W.js";
-import {
-  SESSION_STREAM_RECONNECT_DELAY_MS,
-  SessionStreamError,
-  useSessionStream,
-  useSidecarAuth
-} from "./chunk-72UF2H5H.js";
-import {
-  usePtySession
-} from "./chunk-MYZAW4RX.js";
-import "./chunk-CZ7CSFO4.js";
-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
-};
+import { t as usePtySession } from "./use-pty-session-C8cE0adT.js";
+import { i as useSessionStream, n as SESSION_STREAM_RECONNECT_DELAY_MS, r as SessionStreamError, t as useSidecarAuth } from "./use-sidecar-auth-DkdcufOz.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";
+//#region src/hooks/use-sandbox-metrics.ts
+/**
+* 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.
+*/
+function useSandboxMetrics({ apiBaseUrl, sandboxId, token, enabled = true, intervalMs = 3e3, historyLimit = 120 }) {
+	const [metrics, setMetrics] = React$1.useState(null);
+	const [system, setSystem] = React$1.useState(null);
+	const [latency, setLatency] = React$1.useState(null);
+	const [history, setHistory] = React$1.useState([]);
+	const [loading, setLoading] = React$1.useState(false);
+	const [error, setError] = React$1.useState(null);
+	const [lastUpdatedAt, setLastUpdatedAt] = React$1.useState(null);
+	const sampleRef = React$1.useRef(null);
+	const hasLoadedRef = React$1.useRef(false);
+	const prevSandboxIdRef = React$1.useRef(null);
+	React$1.useEffect(() => {
+		const sandboxCleared = !sandboxId || !apiBaseUrl;
+		const sandboxChanged = prevSandboxIdRef.current !== null && prevSandboxIdRef.current !== sandboxId;
+		if (sandboxCleared && prevSandboxIdRef.current !== null || sandboxChanged) {
+			sampleRef.current = null;
+			hasLoadedRef.current = false;
+			setMetrics(null);
+			setSystem(null);
+			setLatency(null);
+			setHistory([]);
+			setLastUpdatedAt(null);
+			setError(null);
+			if (sandboxCleared) setLoading(false);
+		}
+		prevSandboxIdRef.current = sandboxId ?? null;
+		if (!enabled || sandboxCleared) return;
+		const controller = new AbortController();
+		let cancelled = false;
+		let timeoutId = null;
+		const delay = Math.max(intervalMs, 500);
+		const fetchOnce = async () => {
+			if (!hasLoadedRef.current) setLoading(true);
+			try {
+				const headers = {};
+				if (token) headers.Authorization = `Bearer ${token}`;
+				const res = await fetch(`${apiBaseUrl}/v1/sidecar-proxy/${encodeURIComponent(sandboxId)}/metrics/json`, {
+					method: "GET",
+					credentials: "include",
+					headers,
+					signal: controller.signal
+				});
+				if (!res.ok) throw new Error(`Metrics request failed (HTTP ${res.status})`);
+				const data = await res.json();
+				const cpuSeconds = (data?.process?.cpuSeconds?.user ?? 0) + (data?.process?.cpuSeconds?.system ?? 0);
+				const wallMs = Date.now();
+				if (cancelled) return;
+				let cpuPercent = null;
+				const prev = sampleRef.current;
+				if (prev && prev.sandboxId === sandboxId) {
+					const dCpu = cpuSeconds - prev.cpuSeconds;
+					const dWallSec = (wallMs - prev.wallMs) / 1e3;
+					if (dWallSec > 0 && dCpu >= 0) cpuPercent = dCpu / dWallSec * 100;
+				}
+				sampleRef.current = {
+					cpuSeconds,
+					wallMs,
+					sandboxId
+				};
+				setMetrics({
+					cpuPercent,
+					rssBytes: data?.process?.memoryBytes?.rss ?? 0,
+					heapUsedBytes: data?.process?.memoryBytes?.heapUsed ?? 0,
+					heapTotalBytes: data?.process?.memoryBytes?.heapTotal ?? 0
+				});
+				const sys = data?.system ?? null;
+				setSystem(sys);
+				setLatency(data?.latency ?? null);
+				if (sys) {
+					const sample = {
+						at: wallMs,
+						cpuPercent: sys.cpuPercent,
+						memoryUsedBytes: sys.memory?.usedBytes ?? null,
+						memoryTotalBytes: sys.memory?.totalBytes ?? null,
+						diskUsedBytes: sys.disk?.usedBytes ?? null,
+						diskTotalBytes: sys.disk?.totalBytes ?? null
+					};
+					setHistory((prevHistory) => {
+						const next = [...prevHistory, sample];
+						return next.length > historyLimit ? next.slice(next.length - historyLimit) : next;
+					});
+				}
+				setLastUpdatedAt(wallMs);
+				setError(null);
+				hasLoadedRef.current = true;
+				setLoading(false);
+			} catch (err) {
+				if (cancelled || err instanceof DOMException && err.name === "AbortError") return;
+				setError(err instanceof Error ? err : new Error(String(err)));
+				if (!hasLoadedRef.current) setLoading(false);
+			}
+		};
+		const runLoop = async () => {
+			if (cancelled) return;
+			await fetchOnce();
+			if (cancelled) return;
+			timeoutId = window.setTimeout(runLoop, delay);
+		};
+		runLoop();
+		return () => {
+			cancelled = true;
+			controller.abort();
+			if (timeoutId !== null) window.clearTimeout(timeoutId);
+		};
+	}, [
+		apiBaseUrl,
+		sandboxId,
+		token,
+		enabled,
+		intervalMs,
+		historyLimit
+	]);
+	return {
+		metrics,
+		system,
+		latency,
+		history,
+		loading,
+		error,
+		lastUpdatedAt
+	};
+}
+//#endregion
+//#region src/hooks/use-session-crud.ts
+async function sessionFetch(apiUrl, token, path, opts) {
+	const res = await fetch(`${apiUrl}${path}`, {
+		...opts,
+		headers: {
+			"Content-Type": "application/json",
+			Authorization: `Bearer ${token}`,
+			...opts?.headers ?? {}
+		}
+	});
+	if (!res.ok) {
+		const text = await res.text();
+		throw new Error(text || `API error: ${res.status}`);
+	}
+	return res.json();
+}
+/** List all sessions for a sidecar. */
+function useSessions(apiUrl, token) {
+	return useQuery({
+		queryKey: [
+			"sessions",
+			apiUrl,
+			token
+		],
+		queryFn: () => sessionFetch(apiUrl, token, "/session/sessions"),
+		enabled: !!token,
+		staleTime: 3e4
+	});
+}
+/** Create a new session. */
+function useCreateSession(apiUrl, token) {
+	const queryClient = useQueryClient();
+	return useMutation({
+		mutationFn: async (title) => {
+			return sessionFetch(apiUrl, token, "/session/sessions", {
+				method: "POST",
+				body: JSON.stringify({
+					title,
+					backend: { type: "opencode" }
+				})
+			});
+		},
+		onSuccess: () => {
+			queryClient.invalidateQueries({ queryKey: [
+				"sessions",
+				apiUrl,
+				token
+			] });
+		}
+	});
+}
+/** Delete a session by ID. */
+function useDeleteSession(apiUrl, token) {
+	const queryClient = useQueryClient();
+	return useMutation({
+		mutationFn: async (sessionId) => {
+			return sessionFetch(apiUrl, token, `/session/sessions/${encodeURIComponent(sessionId)}`, { method: "DELETE" });
+		},
+		onSuccess: () => {
+			queryClient.invalidateQueries({ queryKey: [
+				"sessions",
+				apiUrl,
+				token
+			] });
+		}
+	});
+}
+/** Rename a session. */
+function useRenameSession(apiUrl, token) {
+	const queryClient = useQueryClient();
+	return useMutation({
+		mutationFn: async ({ sessionId, title }) => {
+			return sessionFetch(apiUrl, token, `/session/sessions/${encodeURIComponent(sessionId)}`, {
+				method: "PATCH",
+				body: JSON.stringify({ title })
+			});
+		},
+		onSuccess: () => {
+			queryClient.invalidateQueries({ queryKey: [
+				"sessions",
+				apiUrl,
+				token
+			] });
+		}
+	});
+}
+//#endregion
+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 };