@tangle-network/agent-app 0.44.60 → 0.45.1

package/dist/chunk-S4YW2Y52.js.map

@@ -1 +0,0 @@
-{"version":3,"sources":["../src/web-react/sandbox-terminal.ts"],"sourcesContent":["import { useCallback, useEffect, useRef, useState } from 'react'\n\n/** Define the connection details and status for a sandbox terminal session */\nexport interface SandboxTerminalConnection {\n  runtimeUrl: string | null\n  sidecarUrl: string | null\n  token: string | null\n  expiresAt: string | null\n  status: string\n  error: string | null\n  loading: boolean\n  sandboxId?: string\n  connectionId?: string\n}\n\n/**\n * Define the response structure for a sandbox terminal connection including URLs, token, status, and errors\n *\n * Transport-agnostic by construction (#341/#349): the browser-direct\n * scoped-token route (`createSandboxTerminalConnectionRoute`,\n * `src/sandbox/terminal-connection.ts`) returns `sidecarUrl` only — no\n * `runtimeUrl` — while the (now `@deprecated`) same-origin proxy route\n * returns both. `useSandboxTerminalConnection` below resolves\n * `runtimeUrl ?? sidecarUrl` so either shape lands on the same connection\n * state without a hook change.\n *\n * `connectionId` is the id the route's minted token's `sid` is bound to\n * (echoed back from the `connectionId` the hook sent) — pass it straight\n * through as `TerminalView`'s `connectionId` prop, since any other value\n * fails the WS upgrade on the current platform.\n */\nexport interface SandboxTerminalConnectionResponse {\n  runtimeUrl?: string\n  sidecarUrl?: string\n  token?: string\n  expiresAt?: string\n  status?: string\n  error?: string\n  sandboxId?: string\n  connectionId?: string\n}\n\n/**\n * Define options for configuring a sandbox terminal connection including workspace ID and connection parameters\n *\n * `connectionId`, when set, is passed to\n * `createSandboxTerminalConnectionRoute` as the `connectionId` query\n * parameter — pass `tabTerminalConnectionId()` here so the route mints a\n * token whose `sid` is bound to the same id `TerminalView` will dial. Give\n * `TerminalView` the response's echoed `connectionId` (not this input\n * value) alongside `sidecarUrl` as `apiUrl` and `token`, since a product's\n * `resolveConnectionId` seam may rewrite it server-side.\n */\nexport interface UseSandboxTerminalConnectionOptions {\n  workspaceId: string\n  connectionUrl?: string | ((workspaceId: string) => string)\n  connectionId?: string\n  fetcher?: typeof fetch\n  provisionPollIntervalMs?: number\n  provisionPollTimeoutMs?: number\n  tokenRefreshSkewMs?: number\n}\n\n/** Resolve sandbox terminal connection status and provide a method to initiate the connection */\nexport interface UseSandboxTerminalConnectionResult extends SandboxTerminalConnection {\n  connect: () => Promise<void>\n}\n\nconst DEFAULT_PROVISION_POLL_INTERVAL_MS = 2_000\nconst DEFAULT_PROVISION_POLL_TIMEOUT_MS = 90_000\nconst DEFAULT_TOKEN_REFRESH_SKEW_MS = 120_000\n\nconst EMPTY_CONNECTION: SandboxTerminalConnection = {\n  runtimeUrl: null,\n  sidecarUrl: null,\n  token: null,\n  expiresAt: null,\n  status: 'idle',\n  error: null,\n  loading: false,\n}\n\n/**\n * Manage and maintain a sandbox terminal connection with automatic polling and token refresh handling\n *\n * Transport-agnostic (#341/#349): this hook does not care whether\n * `connectionUrl` is backed by the fleet-default browser-direct\n * scoped-token route (`createSandboxTerminalConnectionRoute`,\n * `src/sandbox/terminal-connection.ts`, `sidecarUrl` only) or the\n * `@deprecated` same-origin proxy route (`runtimeUrl` + `sidecarUrl`) — it\n * resolves `runtimeUrl ?? sidecarUrl` either way.\n *\n * Pass `tabTerminalConnectionId()` as `opts.connectionId` — the hook forwards\n * it as the `connectionId` query parameter the browser-direct route requires\n * to mint a token whose `sid` is bound to that exact id (the orchestrator's\n * terminal WS gate fails closed on any other value). Give `TerminalView` the\n * RESULT's echoed `connectionId` (not the input value — a product's\n * `resolveConnectionId` seam may rewrite it), the resolved `sidecarUrl`/\n * `runtimeUrl` as `apiUrl`, and `token` as its token prop.\n */\nexport function useSandboxTerminalConnection(opts: UseSandboxTerminalConnectionOptions): UseSandboxTerminalConnectionResult {\n  const [conn, setConn] = useState<SandboxTerminalConnection>(EMPTY_CONNECTION)\n  const mountedRef = useRef(false)\n  const generationRef = useRef(0)\n  const fetcher = opts.fetcher ?? fetch\n  const pollIntervalMs = opts.provisionPollIntervalMs ?? DEFAULT_PROVISION_POLL_INTERVAL_MS\n  const pollTimeoutMs = opts.provisionPollTimeoutMs ?? DEFAULT_PROVISION_POLL_TIMEOUT_MS\n  const refreshSkewMs = opts.tokenRefreshSkewMs ?? DEFAULT_TOKEN_REFRESH_SKEW_MS\n\n  const connectionUrl = useCallback(() => {\n    const base = typeof opts.connectionUrl === 'function'\n      ? opts.connectionUrl(opts.workspaceId)\n      : opts.connectionUrl ?? `/api/workspaces/${encodeURIComponent(opts.workspaceId)}/sandbox/connection`\n    if (!opts.connectionId) return base\n    // `base` may be relative (SSR-safe), so a plain `URL` parse isn't always\n    // possible — string-append with proper encoding covers both shapes.\n    const separator = base.includes('?') ? '&' : '?'\n    return `${base}${separator}connectionId=${encodeURIComponent(opts.connectionId)}`\n  }, [opts.connectionUrl, opts.workspaceId, opts.connectionId])\n\n  const connect = useCallback(async () => {\n    const generation = generationRef.current + 1\n    generationRef.current = generation\n    const isCurrent = () => mountedRef.current && generationRef.current === generation\n    const setCurrentConn: typeof setConn = (value) => {\n      if (!isCurrent()) return\n      setConn(value)\n    }\n\n    setCurrentConn((current) => ({ ...current, loading: true, error: null }))\n    const deadline = Date.now() + pollTimeoutMs\n    while (isCurrent()) {\n      try {\n        const res = await fetcher(connectionUrl())\n        const data = (await res.json()) as SandboxTerminalConnectionResponse\n        if (!isCurrent()) return\n        const runtimeUrl = data.runtimeUrl ?? data.sidecarUrl\n        if (res.ok && runtimeUrl && data.token && data.expiresAt) {\n          setCurrentConn({\n            runtimeUrl,\n            sidecarUrl: data.sidecarUrl ?? runtimeUrl,\n            token: data.token,\n            expiresAt: data.expiresAt,\n            status: data.status ?? 'running',\n            error: null,\n            loading: false,\n            ...(data.sandboxId ? { sandboxId: data.sandboxId } : {}),\n            ...(data.connectionId ? { connectionId: data.connectionId } : {}),\n          })\n          return\n        }\n        if (res.ok) {\n          setCurrentConn({\n            runtimeUrl: null,\n            sidecarUrl: null,\n            token: null,\n            expiresAt: null,\n            loading: false,\n            error: 'Sandbox connection response is missing required fields',\n            status: data.status ?? 'error',\n            ...(data.sandboxId ? { sandboxId: data.sandboxId } : {}),\n          })\n          return\n        }\n        if (res.status === 503 && Date.now() < deadline) {\n          setCurrentConn((current) => ({\n            ...current,\n            loading: true,\n            status: data.status ?? 'provisioning',\n            error: null,\n          }))\n          await sleep(pollIntervalMs)\n          continue\n        }\n        setCurrentConn((current) => ({\n          ...current,\n          runtimeUrl: null,\n          sidecarUrl: null,\n          token: null,\n          expiresAt: null,\n          loading: false,\n          error: data.error ?? 'Sandbox not available',\n          status: data.status ?? 'error',\n        }))\n        return\n      } catch (err) {\n        if (!isCurrent()) return\n        if (Date.now() < deadline) {\n          await sleep(pollIntervalMs)\n          continue\n        }\n        setCurrentConn((current) => ({\n          ...current,\n          runtimeUrl: null,\n          sidecarUrl: null,\n          token: null,\n          expiresAt: null,\n          loading: false,\n          error: err instanceof Error ? err.message : 'Connection failed',\n        }))\n        return\n      }\n    }\n  }, [connectionUrl, fetcher, pollIntervalMs, pollTimeoutMs])\n\n  useEffect(() => {\n    mountedRef.current = true\n    return () => {\n      mountedRef.current = false\n      generationRef.current += 1\n    }\n  }, [])\n\n  useEffect(() => {\n    void connect()\n  }, [connect])\n\n  useEffect(() => {\n    if (!conn.runtimeUrl || !conn.token || !conn.expiresAt) return\n    const refreshAt = Date.parse(conn.expiresAt) - Date.now() - refreshSkewMs\n    if (!Number.isFinite(refreshAt)) {\n      setConn((current) => ({\n        ...current,\n        runtimeUrl: null,\n        sidecarUrl: null,\n        token: null,\n        expiresAt: null,\n        status: 'error',\n        error: 'Sandbox token expiry is invalid',\n      }))\n      return\n    }\n    const timer = window.setTimeout(() => {\n      void connect()\n    }, Math.max(1_000, refreshAt))\n    return () => window.clearTimeout(timer)\n  }, [conn.runtimeUrl, conn.token, conn.expiresAt, connect, refreshSkewMs])\n\n  return { ...conn, connect }\n}\n\nfunction sleep(ms: number): Promise<void> {\n  return new Promise((resolve) => window.setTimeout(resolve, ms))\n}\n\nconst DEFAULT_TERMINAL_CID_KEY = 'agent-app:terminal-connection-id'\n\nfunction newConnectionId(): string {\n  if (typeof crypto !== 'undefined' && typeof crypto.randomUUID === 'function') return crypto.randomUUID()\n  return `cid-${Date.now().toString(36)}-${Math.floor(Math.random() * 1e9).toString(36)}`\n}\n\n/**\n * Stable-per-tab, unique-per-client terminal connection id.\n *\n * Persists in `sessionStorage` so a reload in the same tab reuses the id (the\n * sidecar restores the same PTY session via `TerminalView.connectionId`), while\n * separate tabs/windows each get a distinct id. Pass the result as\n * `TerminalView`'s `connectionId`. Without it (e.g. gtm-agent today) every tab\n * shares one connection id and their reconnects evict each other.\n *\n * Falls back to an ephemeral id when `sessionStorage` is unavailable (SSR,\n * privacy mode) — still unique per call, just not reload-stable.\n */\nexport function tabTerminalConnectionId(storageKey: string = DEFAULT_TERMINAL_CID_KEY): string {\n  try {\n    const store = globalThis.sessionStorage\n    const existing = store?.getItem(storageKey)\n    if (existing) return existing\n    const id = newConnectionId()\n    store?.setItem(storageKey, id)\n    return id\n  } catch {\n    return newConnectionId()\n  }\n}\n"],"mappings":"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","names":[]}