@opengeni/react 1.0.1 → 1.0.2-canary.37202341988001

package/dist/{chunk-KZ73RL76.js → chunk-YQEAA6LT.js}

@@ -1,3 +1,7 @@
+import {
+  normalizeError
+} from "./chunk-UGLEYEMP.js";
+
 // src/hooks/internal.ts
 import { useCallback, useEffect, useLayoutEffect, useRef, useState } from "react";
 var HIDDEN_STREAM_GRACE_MS = 2e3;
@@ -75,7 +79,7 @@ function usePolledValue(load, options = {}) {
         }
       } catch (cause) {
         if (ticket === generation.current && activeLoadRef.current === load && !requestAbort.signal.aborted) {
-          setError(cause instanceof Error ? cause : new Error(String(cause)));
+          setError(normalizeError(cause));
           setLoading(false);
         }
       } finally {
@@ -192,7 +196,7 @@ function useMutationRunner(identity = void 0) {
         return result;
       } catch (cause) {
         if (mounted.current && generation.current === ownedGeneration && Object.is(identityRef.current, ownedIdentity)) {
-          setMutationError(cause instanceof Error ? cause : new Error(String(cause)));
+          setMutationError(normalizeError(cause));
         }
         return null;
       } finally {
@@ -335,4 +339,4 @@ export {
   useSessionEventTrigger,
   useDebouncedCallback
 };
-//# sourceMappingURL=chunk-KZ73RL76.js.map
+//# sourceMappingURL=chunk-YQEAA6LT.js.map

package/dist/chunk-YQEAA6LT.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/hooks/internal.ts"],"sourcesContent":["import type { SessionEvent } from \"@opengeni/sdk\";\nimport { useCallback, useEffect, useLayoutEffect, useRef, useState } from \"react\";\nimport type { EmbeddedSessionEventClientLike } from \"../client\";\nimport { normalizeError } from \"../lib/error-message\";\n\nconst HIDDEN_STREAM_GRACE_MS = 2_000;\n\n/**\n * Keep live browser work active while the page is visible, then suspend it\n * after a short hidden-tab grace period. Returning to the page re-enables the\n * caller, which must reconcile durable state before resuming live delivery.\n */\nexport function usePageLiveActivity(hiddenGraceMs = HIDDEN_STREAM_GRACE_MS): boolean {\n  // Keep the server and initial browser render identical; the effect applies\n  // visibility after mount and preserves the intentional hidden-tab grace.\n  const [active, setActive] = useState(true);\n\n  useEffect(() => {\n    if (typeof document === \"undefined\") return;\n    let hiddenTimer: ReturnType<typeof setTimeout> | null = null;\n    const cancelHiddenTimer = () => {\n      if (hiddenTimer !== null) {\n        clearTimeout(hiddenTimer);\n        hiddenTimer = null;\n      }\n    };\n    const sync = () => {\n      cancelHiddenTimer();\n      if (document.visibilityState !== \"hidden\") {\n        setActive(true);\n        return;\n      }\n      hiddenTimer = setTimeout(() => {\n        hiddenTimer = null;\n        if (document.visibilityState === \"hidden\") setActive(false);\n      }, hiddenGraceMs);\n    };\n    document.addEventListener(\"visibilitychange\", sync);\n    window.addEventListener(\"pageshow\", sync);\n    sync();\n    return () => {\n      cancelHiddenTimer();\n      document.removeEventListener(\"visibilitychange\", sync);\n      window.removeEventListener(\"pageshow\", sync);\n    };\n  }, [hiddenGraceMs]);\n\n  return active;\n}\n\nexport type AsyncListState<T> = {\n  data: T | null;\n  loading: boolean;\n  error: Error | null;\n  refresh: () => Promise<void>;\n};\n\n/**\n * Shared fetch + optional polling loop for the list/read hooks. Stale\n * responses (superseded by a newer load or an unmount) are dropped.\n */\nexport function usePolledValue<T>(\n  load: (signal?: AbortSignal) => Promise<T>,\n  options: { pollIntervalMs?: number | undefined; enabled?: boolean | undefined } = {},\n): AsyncListState<T> {\n  const enabled = options.enabled ?? true;\n  const pollIntervalMs = options.pollIntervalMs;\n  const pageLive = usePageLiveActivity();\n  const [data, setData] = useState<T | null>(null);\n  const [loading, setLoading] = useState(enabled);\n  const [error, setError] = useState<Error | null>(null);\n  const generation = useRef(0);\n  const activeLoadRef = useRef(load);\n  useLayoutEffect(() => {\n    activeLoadRef.current = load;\n  }, [load]);\n  const requestAbortRef = useRef<AbortController | null>(null);\n  const inFlightRef = useRef<{ load: typeof load; promise: Promise<void> } | null>(null);\n  const trailingRefreshRef = useRef<{ load: typeof load; promise: Promise<void> } | null>(null);\n  const [stateIdentity, setStateIdentity] = useState<{ load: typeof load }>(() => ({ load }));\n\n  // A new loader identity means a new query (different session/workspace/...):\n  // drop the previous result instead of showing it as the new query's data.\n  useEffect(() => {\n    if (stateIdentity.load !== load) {\n      setStateIdentity({ load });\n      setData(null);\n      setError(null);\n    }\n  }, [load, stateIdentity.load]);\n\n  const run = useCallback((): Promise<void> => {\n    // A callback retained by a completed mutation from the previous query must\n    // not supersede or settle the current query's request.\n    if (activeLoadRef.current !== load) return Promise.resolve();\n    const existing = inFlightRef.current;\n    if (existing?.load === load) return existing.promise;\n    const ticket = ++generation.current;\n    const requestAbort = new AbortController();\n    requestAbortRef.current = requestAbort;\n    let promise!: Promise<void>;\n    promise = (async () => {\n      try {\n        const result = await load(requestAbort.signal);\n        if (\n          ticket === generation.current &&\n          activeLoadRef.current === load &&\n          !requestAbort.signal.aborted\n        ) {\n          setData(result);\n          setError(null);\n          setLoading(false);\n        }\n      } catch (cause) {\n        if (\n          ticket === generation.current &&\n          activeLoadRef.current === load &&\n          !requestAbort.signal.aborted\n        ) {\n          setError(normalizeError(cause));\n          setLoading(false);\n        }\n      } finally {\n        if (requestAbortRef.current === requestAbort) requestAbortRef.current = null;\n        if (inFlightRef.current?.promise === promise) inFlightRef.current = null;\n      }\n    })();\n    inFlightRef.current = { load, promise };\n    return promise;\n  }, [load]);\n\n  const refresh = useCallback((): Promise<void> => {\n    const existing = inFlightRef.current;\n    if (existing?.load !== load) return run();\n    const trailing = trailingRefreshRef.current;\n    if (trailing?.load === load) return trailing.promise;\n    let promise!: Promise<void>;\n    promise = existing.promise.then(async () => {\n      if (trailingRefreshRef.current?.promise === promise) {\n        trailingRefreshRef.current = null;\n      }\n      if (activeLoadRef.current === load) await run();\n    });\n    trailingRefreshRef.current = { load, promise };\n    return promise;\n  }, [load, run]);\n\n  useEffect(() => {\n    if (!enabled || !pageLive) {\n      setLoading(false);\n      generation.current += 1;\n      requestAbortRef.current?.abort();\n      inFlightRef.current = null;\n      trailingRefreshRef.current = null;\n      return;\n    }\n    setLoading(true);\n    let cancelled = false;\n    let timer: ReturnType<typeof setTimeout> | null = null;\n    const schedule = () => {\n      if (cancelled || pollIntervalMs === undefined || pollIntervalMs <= 0) return;\n      timer = setTimeout(() => {\n        timer = null;\n        void run().finally(schedule);\n      }, pollIntervalMs);\n    };\n    void run().finally(schedule);\n    if (pollIntervalMs === undefined || pollIntervalMs <= 0) {\n      return () => {\n        cancelled = true;\n        generation.current += 1;\n        requestAbortRef.current?.abort();\n        inFlightRef.current = null;\n        trailingRefreshRef.current = null;\n      };\n    }\n    return () => {\n      cancelled = true;\n      if (timer !== null) clearTimeout(timer);\n      generation.current += 1;\n      requestAbortRef.current?.abort();\n      inFlightRef.current = null;\n      trailingRefreshRef.current = null;\n    };\n  }, [run, enabled, pageLive, pollIntervalMs]);\n\n  const identityMatches = stateIdentity.load === load;\n  return {\n    data: identityMatches ? data : null,\n    loading: identityMatches ? loading : enabled,\n    error: identityMatches ? error : null,\n    refresh,\n  };\n}\n\nexport type MutationState = {\n  mutating: boolean;\n  mutationError: Error | null;\n  clearMutationError: () => void;\n};\n\n/**\n * Shared async mutation runner for the write hooks. `run` resolves with the\n * operation's value, or `null` after capturing the error in `mutationError`\n * (callers then roll back optimistic state).\n */\nexport function useMutationRunner(identity: unknown = undefined): MutationState & {\n  run: <T>(operation: () => Promise<T>) => Promise<T | null>;\n} {\n  const [mutating, setMutating] = useState(false);\n  const [mutationError, setMutationError] = useState<Error | null>(null);\n  const [stateIdentity, setStateIdentity] = useState<unknown>(() => identity);\n  const inFlight = useRef(0);\n  const generation = useRef(0);\n  const identityRef = useRef(identity);\n  useLayoutEffect(() => {\n    if (Object.is(identityRef.current, identity)) return;\n    identityRef.current = identity;\n    generation.current += 1;\n    inFlight.current = 0;\n  }, [identity]);\n  const mounted = useRef(true);\n  useEffect(() => {\n    mounted.current = true;\n    return () => {\n      mounted.current = false;\n    };\n  }, []);\n  useEffect(() => {\n    if (!Object.is(stateIdentity, identity)) {\n      setStateIdentity(() => identity);\n      setMutating(false);\n      setMutationError(null);\n    }\n  }, [identity, stateIdentity]);\n  const run = useCallback(\n    async <T>(operation: () => Promise<T>): Promise<T | null> => {\n      const ownedIdentity = identity;\n      const ownedGeneration = generation.current;\n      if (!Object.is(identityRef.current, ownedIdentity)) return null;\n      inFlight.current += 1;\n      if (mounted.current) {\n        setMutating(true);\n        setMutationError(null);\n      }\n      try {\n        const result = await operation();\n        if (\n          !mounted.current ||\n          generation.current !== ownedGeneration ||\n          !Object.is(identityRef.current, ownedIdentity)\n        ) {\n          return null;\n        }\n        return result;\n      } catch (cause) {\n        if (\n          mounted.current &&\n          generation.current === ownedGeneration &&\n          Object.is(identityRef.current, ownedIdentity)\n        ) {\n          setMutationError(normalizeError(cause));\n        }\n        return null;\n      } finally {\n        if (\n          generation.current === ownedGeneration &&\n          Object.is(identityRef.current, ownedIdentity)\n        ) {\n          inFlight.current -= 1;\n          if (mounted.current && inFlight.current === 0) {\n            setMutating(false);\n          }\n        }\n      }\n    },\n    [identity],\n  );\n  const identityMatches = Object.is(stateIdentity, identity);\n  return {\n    mutating: identityMatches && mutating,\n    mutationError: identityMatches ? mutationError : null,\n    clearMutationError: useCallback(() => {\n      if (Object.is(identityRef.current, identity)) setMutationError(null);\n    }, [identity]),\n    run,\n  };\n}\n\nexport type SessionEventFeedOptions = {\n  /**\n   * Share an existing event log (from `useSessionEvents`) instead of opening\n   * a second stream. When omitted the hook tails the session's event stream\n   * itself, starting at the current `lastSequence`.\n   */\n  events?: SessionEvent[] | undefined;\n  enabled?: boolean | undefined;\n};\n\n/**\n * Invoke `onEvent` for every session event matching `match` — the live-update\n * primitive behind `useTurnQueue` and `useGoal`. Either watches a shared\n * `events` log or tails the stream directly (reconnect handled by the SDK).\n */\nexport function useSessionEventTrigger(\n  client: EmbeddedSessionEventClientLike,\n  workspaceId: string,\n  sessionId: string | null | undefined,\n  match: (event: SessionEvent) => boolean,\n  onEvent: (event: SessionEvent) => void,\n  options: SessionEventFeedOptions = {},\n  reconcileBeforeLive?: (() => void | Promise<void>) | undefined,\n): void {\n  const enabled = options.enabled ?? true;\n  const pageLive = usePageLiveActivity();\n  const liveEnabled = enabled && pageLive;\n  const events = options.events;\n  const sharedFeed = events !== undefined;\n  const matchRef = useRef(match);\n  const onEventRef = useRef(onEvent);\n  const reconcileBeforeLiveRef = useRef(reconcileBeforeLive);\n  useLayoutEffect(() => {\n    matchRef.current = match;\n    onEventRef.current = onEvent;\n    reconcileBeforeLiveRef.current = reconcileBeforeLive;\n  }, [match, onEvent, reconcileBeforeLive]);\n  const consumedRef = useRef(0);\n  const feedKeyRef = useRef<string | null>(null);\n  const sharedFeedHasEventsRef = useRef(false);\n\n  // Shared-log mode: scan only the unseen tail on every append.\n  useEffect(() => {\n    if (!sharedFeed || !liveEnabled || !sessionId) {\n      return;\n    }\n    const feedKey = `${workspaceId}\\u0000${sessionId}`;\n    const firstSequence = events[0]?.sequence ?? 0;\n    if (feedKeyRef.current !== feedKey) {\n      feedKeyRef.current = feedKey;\n      sharedFeedHasEventsRef.current = events.length > 0;\n      // The caller has already loaded its authoritative initial projection.\n      // Seed from the shared log's current tail so mounting a large historical\n      // session cannot replay every old event as a new live trigger.\n      consumedRef.current = events.at(-1)?.sequence ?? 0;\n      return;\n    }\n    const firstNonEmptyBatch = !sharedFeedHasEventsRef.current && events.length > 0;\n    if (firstNonEmptyBatch || firstSequence > consumedRef.current + 1) {\n      // The usual shared feed mounts empty, then receives a historical tail.\n      // A later discontinuity can likewise replace the retained browser\n      // window. In either case, reconcile once from the latest relevant event\n      // instead of replaying the whole retained window as live traffic.\n      sharedFeedHasEventsRef.current = events.length > 0;\n      consumedRef.current = events.at(-1)?.sequence ?? consumedRef.current;\n      let latestMatch: SessionEvent | undefined;\n      for (let index = events.length - 1; index >= 0; index -= 1) {\n        const event = events[index];\n        if (event && matchRef.current(event)) {\n          latestMatch = event;\n          break;\n        }\n      }\n      if (latestMatch) {\n        onEventRef.current(latestMatch);\n      }\n      return;\n    }\n    sharedFeedHasEventsRef.current ||= events.length > 0;\n    for (const event of events) {\n      if (event.sequence <= consumedRef.current) {\n        continue;\n      }\n      consumedRef.current = event.sequence;\n      if (matchRef.current(event)) {\n        onEventRef.current(event);\n      }\n    }\n  }, [sharedFeed, liveEnabled, events, workspaceId, sessionId]);\n\n  // Self-stream mode: tail from the session's current lastSequence.\n  useEffect(() => {\n    if (sharedFeed || !liveEnabled || !sessionId) {\n      return;\n    }\n    const controller = new AbortController();\n    void (async () => {\n      try {\n        const session = await client.getSession(workspaceId, sessionId);\n        if (controller.signal.aborted) {\n          return;\n        }\n        const stream = client.streamEvents(workspaceId, sessionId, {\n          after: session.lastSequence,\n          signal: controller.signal,\n          onOpen: () => {\n            // Start reconciliation without delaying consumption of live SSE.\n            void Promise.resolve()\n              .then(() => reconcileBeforeLiveRef.current?.())\n              .catch(() => undefined);\n          },\n        });\n        for await (const event of stream) {\n          if (matchRef.current(event)) {\n            onEventRef.current(event);\n          }\n        }\n      } catch {\n        // Live updates are best-effort: the read hooks still expose refresh()\n        // and the initial load already populated state.\n      }\n    })();\n    return () => {\n      controller.abort();\n    };\n  }, [sharedFeed, liveEnabled, client, workspaceId, sessionId]);\n}\n\n/** Debounce rapid event bursts into one trailing call (default 150ms). */\nexport function useDebouncedCallback(callback: () => void, delayMs = 150): () => void {\n  const callbackRef = useRef(callback);\n  useLayoutEffect(() => {\n    callbackRef.current = callback;\n  }, [callback]);\n  const timerRef = useRef<ReturnType<typeof setTimeout> | null>(null);\n  useEffect(() => {\n    return () => {\n      if (timerRef.current !== null) {\n        clearTimeout(timerRef.current);\n      }\n    };\n  }, []);\n  return useCallback(() => {\n    if (timerRef.current !== null) {\n      clearTimeout(timerRef.current);\n    }\n    timerRef.current = setTimeout(() => {\n      timerRef.current = null;\n      callbackRef.current();\n    }, delayMs);\n  }, [delayMs]);\n}\n"],"mappings":"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","names":[]}

package/dist/chunk-YV4L3ILF.js

@@ -0,0 +1,9 @@
+// src/lib/sandbox-liveness.ts
+function sandboxAcceptsLiveIo(liveness) {
+  return liveness === "warm";
+}
+
+export {
+  sandboxAcceptsLiveIo
+};
+//# sourceMappingURL=chunk-YV4L3ILF.js.map

package/dist/chunk-YV4L3ILF.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/lib/sandbox-liveness.ts"],"sourcesContent":["/**\n * A sandbox is available for new I/O only after a holder has observed `warm`.\n *\n * `draining` means the holder count is zero and teardown owns the provider\n * instance. The provider may disappear before the durable lease reaches `cold`,\n * so treating `draining` as live races capture/termination. Explicit user intent\n * reacquires a holder; only its subsequent `warm` state re-enables live I/O.\n */\nexport function sandboxAcceptsLiveIo(liveness: string | null | undefined): boolean {\n  return liveness === \"warm\";\n}\n"],"mappings":";AAQO,SAAS,qBAAqB,UAA8C;AACjF,SAAO,aAAa;AACtB;","names":[]}

package/dist/chunk-ZYRGEKWS.js

@@ -0,0 +1,216 @@
+// src/components/timeline-annotation-layout.ts
+var ANNOTATION_BADGE_GAP_PX = 32;
+var ANNOTATION_BADGE_MIN_GAP_PX = 12;
+var ANNOTATION_REVIEW_DIALOG_WIDTH_PX = 400;
+var ANNOTATION_REVIEW_DIALOG_MAX_HEIGHT_PX = 32 * 16;
+var ANNOTATION_REVIEW_DIALOG_MIN_HEIGHT_PX = 160;
+var ANNOTATION_REVIEW_DIALOG_FLOOR_HEIGHT_PX = 80;
+var ANNOTATION_REVIEW_MARGIN_PX = 12;
+var ANNOTATION_NOTE_PREVIEW_CHARS = 280;
+var ANNOTATION_CARD_STACK_SCROLL_AT = 4;
+function clampAnnotationAxis(value, min, max) {
+  return Math.min(Math.max(value, min), Math.max(min, max));
+}
+function annotationBoxIntersects(a, b) {
+  return a.left <= b.right && a.right >= b.left && a.top <= b.bottom && a.bottom >= b.top;
+}
+function annotationViewportBox(viewportWidth, viewportHeight, scroller) {
+  const viewport = {
+    left: 0,
+    top: 0,
+    right: Math.max(1, viewportWidth),
+    bottom: Math.max(1, viewportHeight)
+  };
+  if (!scroller || scroller.right - scroller.left <= 0 || scroller.bottom - scroller.top <= 0) {
+    return viewport;
+  }
+  return {
+    left: Math.max(viewport.left, scroller.left),
+    top: Math.max(viewport.top, scroller.top),
+    right: Math.min(viewport.right, scroller.right),
+    bottom: Math.min(viewport.bottom, scroller.bottom)
+  };
+}
+function annotationNoteNeedsDisclosure(note) {
+  const trimmed = note.trim();
+  if (trimmed.length === 0) return false;
+  return trimmed.length > ANNOTATION_NOTE_PREVIEW_CHARS || trimmed.split("\n").length > 4;
+}
+function annotationAxisStops(min, max, gap) {
+  if (max <= min) return [min];
+  const stops = [];
+  for (let value = min; value <= max + 1e-6; value += gap) {
+    stops.push(value);
+  }
+  return stops;
+}
+function annotationPointKey(left, top) {
+  return `${Math.round(left * 100) / 100},${Math.round(top * 100) / 100}`;
+}
+function annotationPointFree(left, top, placed, gap) {
+  return placed.every((other) => Math.hypot(left - other.left, top - other.top) >= gap);
+}
+function annotationBadgePackGap(viewport, count, preferred = ANNOTATION_BADGE_GAP_PX) {
+  if (count <= 1) return preferred;
+  const width = Math.max(
+    1,
+    viewport.right - ANNOTATION_REVIEW_MARGIN_PX - (viewport.left + ANNOTATION_REVIEW_MARGIN_PX)
+  );
+  const height = Math.max(1, viewport.bottom - ANNOTATION_REVIEW_MARGIN_PX - (viewport.top + 8));
+  let gap = preferred;
+  const capacity = (step) => (Math.floor(width / step) + 1) * (Math.floor(height / step) + 1);
+  while (gap > ANNOTATION_BADGE_MIN_GAP_PX && capacity(gap) < count) {
+    gap -= 1;
+  }
+  return gap;
+}
+var ANNOTATION_BADGE_SHIFT_DIRS = [
+  [1, 0],
+  [1, 1],
+  [0, 1],
+  [-1, 1],
+  [-1, 0],
+  [-1, -1],
+  [0, -1],
+  [1, -1]
+];
+function layoutAnnotationBadges(anchors, viewport, preferredGap = ANNOTATION_BADGE_GAP_PX) {
+  const minLeft = viewport.left + ANNOTATION_REVIEW_MARGIN_PX;
+  const maxLeft = viewport.right - ANNOTATION_REVIEW_MARGIN_PX;
+  const minTop = viewport.top + 8;
+  const maxTop = viewport.bottom - ANNOTATION_REVIEW_MARGIN_PX;
+  const gap = annotationBadgePackGap(viewport, anchors.length, preferredGap);
+  const cells = annotationAxisStops(minLeft, maxLeft, gap).flatMap(
+    (left) => annotationAxisStops(minTop, maxTop, gap).map((top) => ({ left, top }))
+  );
+  const placed = [];
+  for (const anchor of [...anchors].sort((left, right) => left.ordinal - right.ordinal)) {
+    const originLeft = clampAnnotationAxis(anchor.left, minLeft, maxLeft);
+    const originTop = clampAnnotationAxis(anchor.top, minTop, maxTop);
+    const seen = /* @__PURE__ */ new Set();
+    const candidates = [];
+    const pushCandidate = (left, top) => {
+      if (left < minLeft || left > maxLeft || top < minTop || top > maxTop) return;
+      const key = annotationPointKey(left, top);
+      if (seen.has(key)) return;
+      seen.add(key);
+      candidates.push({ left, top });
+    };
+    pushCandidate(originLeft, originTop);
+    for (const [dx, dy] of ANNOTATION_BADGE_SHIFT_DIRS) {
+      const colliders = [...placed].sort(
+        (left, right) => right.left * dx + right.top * dy - (left.left * dx + left.top * dy)
+      );
+      for (const collider of colliders) {
+        pushCandidate(collider.left + dx * gap, collider.top + dy * gap);
+      }
+    }
+    const maxRadius = Math.ceil(Math.max(maxLeft - minLeft, maxTop - minTop) / Math.max(gap, 1)) + 1;
+    for (let radius = 1; radius <= maxRadius; radius++) {
+      const ring = [];
+      for (let dx = -radius; dx <= radius; dx++) {
+        for (let dy = -radius; dy <= radius; dy++) {
+          if (Math.max(Math.abs(dx), Math.abs(dy)) !== radius) continue;
+          ring.push([dx, dy]);
+        }
+      }
+      ring.sort((left, right) => {
+        const leftDir = (left[0] < 0 ? 2 : 0) + (left[1] < 0 ? 1 : 0);
+        const rightDir = (right[0] < 0 ? 2 : 0) + (right[1] < 0 ? 1 : 0);
+        if (leftDir !== rightDir) return leftDir - rightDir;
+        const hypot = Math.hypot(left[0], left[1]) - Math.hypot(right[0], right[1]);
+        if (hypot !== 0) return hypot;
+        if (left[0] !== right[0]) return right[0] - left[0];
+        return left[1] - right[1];
+      });
+      for (const [dx, dy] of ring) {
+        pushCandidate(originLeft + dx * gap, originTop + dy * gap);
+      }
+    }
+    for (const cell of cells) {
+      pushCandidate(cell.left, cell.top);
+    }
+    const free = candidates.find(
+      (point) => annotationPointFree(point.left, point.top, placed, gap)
+    );
+    let chosen = free ?? candidates[0];
+    if (!free && placed.length > 0) {
+      let bestMin = Number.NEGATIVE_INFINITY;
+      for (const point of candidates) {
+        const minDist = placed.reduce(
+          (current, other) => Math.min(current, Math.hypot(point.left - other.left, point.top - other.top)),
+          Number.POSITIVE_INFINITY
+        );
+        if (minDist > bestMin) {
+          bestMin = minDist;
+          chosen = point;
+        }
+      }
+    }
+    placed.push({ ...anchor, left: chosen.left, top: chosen.top });
+  }
+  return placed;
+}
+function scrollAnnotationRowIntoList(list, row) {
+  if (!list || !row || !list.contains(row)) return;
+  const listRect = list.getBoundingClientRect();
+  const rowRect = row.getBoundingClientRect();
+  if (rowRect.top < listRect.top) {
+    list.scrollTop -= listRect.top - rowRect.top;
+    return;
+  }
+  if (rowRect.bottom > listRect.bottom) {
+    list.scrollTop += rowRect.bottom - listRect.bottom;
+  }
+}
+function clampAnnotationDialogPlacement(input) {
+  const margin = ANNOTATION_REVIEW_MARGIN_PX;
+  const panelWidth = Math.min(
+    input.panelWidth ?? ANNOTATION_REVIEW_DIALOG_WIDTH_PX,
+    Math.max(1, input.viewportWidth - margin * 2)
+  );
+  const left = Math.min(
+    Math.max(margin, input.triggerLeft),
+    Math.max(margin, input.viewportWidth - panelWidth - margin)
+  );
+  const spaceBelow = input.viewportHeight - input.triggerBottom - margin;
+  const spaceAbove = input.triggerTop - margin;
+  const above = spaceBelow < Math.min(input.contentHeight, 200) && spaceAbove > spaceBelow;
+  const viewportBudget = Math.max(
+    ANNOTATION_REVIEW_DIALOG_FLOOR_HEIGHT_PX,
+    input.viewportHeight - margin * 2
+  );
+  const available = Math.max(
+    Math.min(ANNOTATION_REVIEW_DIALOG_MIN_HEIGHT_PX, viewportBudget),
+    above ? spaceAbove : spaceBelow
+  );
+  let maxHeight = Math.min(
+    Math.max(input.contentHeight, Math.min(ANNOTATION_REVIEW_DIALOG_MIN_HEIGHT_PX, viewportBudget)),
+    available,
+    Math.floor(input.viewportHeight * 0.7) || viewportBudget,
+    ANNOTATION_REVIEW_DIALOG_MAX_HEIGHT_PX,
+    viewportBudget
+  );
+  let top = above ? Math.max(margin, input.triggerTop - 8 - maxHeight) : Math.min(
+    input.triggerBottom + 8,
+    Math.max(margin, input.viewportHeight - margin - maxHeight)
+  );
+  top = Math.max(margin, top);
+  maxHeight = Math.min(
+    maxHeight,
+    Math.max(ANNOTATION_REVIEW_DIALOG_FLOOR_HEIGHT_PX, input.viewportHeight - margin - top)
+  );
+  return { left, top, maxHeight, above };
+}
+
+export {
+  ANNOTATION_REVIEW_DIALOG_WIDTH_PX,
+  ANNOTATION_CARD_STACK_SCROLL_AT,
+  annotationBoxIntersects,
+  annotationViewportBox,
+  annotationNoteNeedsDisclosure,
+  layoutAnnotationBadges,
+  scrollAnnotationRowIntoList,
+  clampAnnotationDialogPlacement
+};
+//# sourceMappingURL=chunk-ZYRGEKWS.js.map

package/dist/chunk-ZYRGEKWS.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/components/timeline-annotation-layout.ts"],"sourcesContent":["export type AnnotationBox = {\n  left: number;\n  right: number;\n  top: number;\n  bottom: number;\n};\n\nexport type AnnotationBadgeAnchor = {\n  id: string;\n  ordinal: number;\n  left: number;\n  top: number;\n  incomplete: boolean;\n};\n\nexport const ANNOTATION_BADGE_GAP_PX = 32;\nexport const ANNOTATION_BADGE_MIN_GAP_PX = 12;\nexport const ANNOTATION_REVIEW_DIALOG_WIDTH_PX = 400;\nexport const ANNOTATION_REVIEW_DIALOG_MAX_HEIGHT_PX = 32 * 16;\nexport const ANNOTATION_REVIEW_DIALOG_MIN_HEIGHT_PX = 160;\nexport const ANNOTATION_REVIEW_DIALOG_FLOOR_HEIGHT_PX = 80;\nexport const ANNOTATION_REVIEW_MARGIN_PX = 12;\nexport const ANNOTATION_NOTE_PREVIEW_CHARS = 280;\nexport const ANNOTATION_CARD_STACK_SCROLL_AT = 4;\n\nfunction clampAnnotationAxis(value: number, min: number, max: number): number {\n  return Math.min(Math.max(value, min), Math.max(min, max));\n}\n\nexport function annotationBoxIntersects(a: AnnotationBox, b: AnnotationBox): boolean {\n  return a.left <= b.right && a.right >= b.left && a.top <= b.bottom && a.bottom >= b.top;\n}\n\nexport function annotationViewportBox(\n  viewportWidth: number,\n  viewportHeight: number,\n  scroller?: AnnotationBox | null,\n): AnnotationBox {\n  const viewport: AnnotationBox = {\n    left: 0,\n    top: 0,\n    right: Math.max(1, viewportWidth),\n    bottom: Math.max(1, viewportHeight),\n  };\n  if (!scroller || scroller.right - scroller.left <= 0 || scroller.bottom - scroller.top <= 0) {\n    return viewport;\n  }\n  return {\n    left: Math.max(viewport.left, scroller.left),\n    top: Math.max(viewport.top, scroller.top),\n    right: Math.min(viewport.right, scroller.right),\n    bottom: Math.min(viewport.bottom, scroller.bottom),\n  };\n}\n\nexport function annotationNoteNeedsDisclosure(note: string): boolean {\n  const trimmed = note.trim();\n  if (trimmed.length === 0) return false;\n  return trimmed.length > ANNOTATION_NOTE_PREVIEW_CHARS || trimmed.split(\"\\n\").length > 4;\n}\n\nfunction annotationAxisStops(min: number, max: number, gap: number): number[] {\n  if (max <= min) return [min];\n  const stops: number[] = [];\n  for (let value = min; value <= max + 1e-6; value += gap) {\n    stops.push(value);\n  }\n  return stops;\n}\n\nfunction annotationPointKey(left: number, top: number): string {\n  return `${Math.round(left * 100) / 100},${Math.round(top * 100) / 100}`;\n}\n\nfunction annotationPointFree(\n  left: number,\n  top: number,\n  placed: readonly AnnotationBadgeAnchor[],\n  gap: number,\n): boolean {\n  return placed.every((other) => Math.hypot(left - other.left, top - other.top) >= gap);\n}\n\nexport function annotationBadgePackGap(\n  viewport: AnnotationBox,\n  count: number,\n  preferred = ANNOTATION_BADGE_GAP_PX,\n): number {\n  if (count <= 1) return preferred;\n  const width = Math.max(\n    1,\n    viewport.right - ANNOTATION_REVIEW_MARGIN_PX - (viewport.left + ANNOTATION_REVIEW_MARGIN_PX),\n  );\n  const height = Math.max(1, viewport.bottom - ANNOTATION_REVIEW_MARGIN_PX - (viewport.top + 8));\n  let gap = preferred;\n  const capacity = (step: number) =>\n    (Math.floor(width / step) + 1) * (Math.floor(height / step) + 1);\n  while (gap > ANNOTATION_BADGE_MIN_GAP_PX && capacity(gap) < count) {\n    gap -= 1;\n  }\n  return gap;\n}\n\nconst ANNOTATION_BADGE_SHIFT_DIRS: Array<[number, number]> = [\n  [1, 0],\n  [1, 1],\n  [0, 1],\n  [-1, 1],\n  [-1, 0],\n  [-1, -1],\n  [0, -1],\n  [1, -1],\n];\n\nexport function layoutAnnotationBadges(\n  anchors: readonly AnnotationBadgeAnchor[],\n  viewport: AnnotationBox,\n  preferredGap = ANNOTATION_BADGE_GAP_PX,\n): AnnotationBadgeAnchor[] {\n  const minLeft = viewport.left + ANNOTATION_REVIEW_MARGIN_PX;\n  const maxLeft = viewport.right - ANNOTATION_REVIEW_MARGIN_PX;\n  const minTop = viewport.top + 8;\n  const maxTop = viewport.bottom - ANNOTATION_REVIEW_MARGIN_PX;\n  const gap = annotationBadgePackGap(viewport, anchors.length, preferredGap);\n  const cells = annotationAxisStops(minLeft, maxLeft, gap).flatMap((left) =>\n    annotationAxisStops(minTop, maxTop, gap).map((top) => ({ left, top })),\n  );\n  const placed: AnnotationBadgeAnchor[] = [];\n  for (const anchor of [...anchors].sort((left, right) => left.ordinal - right.ordinal)) {\n    const originLeft = clampAnnotationAxis(anchor.left, minLeft, maxLeft);\n    const originTop = clampAnnotationAxis(anchor.top, minTop, maxTop);\n    const seen = new Set<string>();\n    const candidates: Array<{ left: number; top: number }> = [];\n    const pushCandidate = (left: number, top: number) => {\n      if (left < minLeft || left > maxLeft || top < minTop || top > maxTop) return;\n      const key = annotationPointKey(left, top);\n      if (seen.has(key)) return;\n      seen.add(key);\n      candidates.push({ left, top });\n    };\n    pushCandidate(originLeft, originTop);\n    for (const [dx, dy] of ANNOTATION_BADGE_SHIFT_DIRS) {\n      const colliders = [...placed].sort(\n        (left, right) => right.left * dx + right.top * dy - (left.left * dx + left.top * dy),\n      );\n      for (const collider of colliders) {\n        pushCandidate(collider.left + dx * gap, collider.top + dy * gap);\n      }\n    }\n    const maxRadius =\n      Math.ceil(Math.max(maxLeft - minLeft, maxTop - minTop) / Math.max(gap, 1)) + 1;\n    for (let radius = 1; radius <= maxRadius; radius++) {\n      const ring: Array<[number, number]> = [];\n      for (let dx = -radius; dx <= radius; dx++) {\n        for (let dy = -radius; dy <= radius; dy++) {\n          if (Math.max(Math.abs(dx), Math.abs(dy)) !== radius) continue;\n          ring.push([dx, dy]);\n        }\n      }\n      ring.sort((left, right) => {\n        const leftDir = (left[0] < 0 ? 2 : 0) + (left[1] < 0 ? 1 : 0);\n        const rightDir = (right[0] < 0 ? 2 : 0) + (right[1] < 0 ? 1 : 0);\n        if (leftDir !== rightDir) return leftDir - rightDir;\n        const hypot = Math.hypot(left[0], left[1]) - Math.hypot(right[0], right[1]);\n        if (hypot !== 0) return hypot;\n        if (left[0] !== right[0]) return right[0] - left[0];\n        return left[1] - right[1];\n      });\n      for (const [dx, dy] of ring) {\n        pushCandidate(originLeft + dx * gap, originTop + dy * gap);\n      }\n    }\n    for (const cell of cells) {\n      pushCandidate(cell.left, cell.top);\n    }\n    const free = candidates.find((point) =>\n      annotationPointFree(point.left, point.top, placed, gap),\n    );\n    let chosen = free ?? candidates[0]!;\n    if (!free && placed.length > 0) {\n      let bestMin = Number.NEGATIVE_INFINITY;\n      for (const point of candidates) {\n        const minDist = placed.reduce(\n          (current, other) =>\n            Math.min(current, Math.hypot(point.left - other.left, point.top - other.top)),\n          Number.POSITIVE_INFINITY,\n        );\n        if (minDist > bestMin) {\n          bestMin = minDist;\n          chosen = point;\n        }\n      }\n    }\n    placed.push({ ...anchor, left: chosen.left, top: chosen.top });\n  }\n  return placed;\n}\n\nexport function scrollAnnotationRowIntoList(\n  list: HTMLElement | null | undefined,\n  row: HTMLElement | null | undefined,\n): void {\n  if (!list || !row || !list.contains(row)) return;\n  const listRect = list.getBoundingClientRect();\n  const rowRect = row.getBoundingClientRect();\n  if (rowRect.top < listRect.top) {\n    list.scrollTop -= listRect.top - rowRect.top;\n    return;\n  }\n  if (rowRect.bottom > listRect.bottom) {\n    list.scrollTop += rowRect.bottom - listRect.bottom;\n  }\n}\n\nexport function clampAnnotationDialogPlacement(input: {\n  triggerLeft: number;\n  triggerTop: number;\n  triggerBottom: number;\n  contentHeight: number;\n  viewportWidth: number;\n  viewportHeight: number;\n  panelWidth?: number;\n}): {\n  left: number;\n  top: number;\n  maxHeight: number;\n  above: boolean;\n} {\n  const margin = ANNOTATION_REVIEW_MARGIN_PX;\n  const panelWidth = Math.min(\n    input.panelWidth ?? ANNOTATION_REVIEW_DIALOG_WIDTH_PX,\n    Math.max(1, input.viewportWidth - margin * 2),\n  );\n  const left = Math.min(\n    Math.max(margin, input.triggerLeft),\n    Math.max(margin, input.viewportWidth - panelWidth - margin),\n  );\n  const spaceBelow = input.viewportHeight - input.triggerBottom - margin;\n  const spaceAbove = input.triggerTop - margin;\n  const above = spaceBelow < Math.min(input.contentHeight, 200) && spaceAbove > spaceBelow;\n  const viewportBudget = Math.max(\n    ANNOTATION_REVIEW_DIALOG_FLOOR_HEIGHT_PX,\n    input.viewportHeight - margin * 2,\n  );\n  const available = Math.max(\n    Math.min(ANNOTATION_REVIEW_DIALOG_MIN_HEIGHT_PX, viewportBudget),\n    above ? spaceAbove : spaceBelow,\n  );\n  let maxHeight = Math.min(\n    Math.max(input.contentHeight, Math.min(ANNOTATION_REVIEW_DIALOG_MIN_HEIGHT_PX, viewportBudget)),\n    available,\n    Math.floor(input.viewportHeight * 0.7) || viewportBudget,\n    ANNOTATION_REVIEW_DIALOG_MAX_HEIGHT_PX,\n    viewportBudget,\n  );\n  let top = above\n    ? Math.max(margin, input.triggerTop - 8 - maxHeight)\n    : Math.min(\n        input.triggerBottom + 8,\n        Math.max(margin, input.viewportHeight - margin - maxHeight),\n      );\n  top = Math.max(margin, top);\n  maxHeight = Math.min(\n    maxHeight,\n    Math.max(ANNOTATION_REVIEW_DIALOG_FLOOR_HEIGHT_PX, input.viewportHeight - margin - top),\n  );\n  return { left, top, maxHeight, above };\n}\n"],"mappings":"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","names":[]}

package/dist/client.d.ts

@@ -4,7 +4,9 @@ import type { OpenGeniClient } from "@opengeni/sdk";
  * pass the real SDK client, a proxy-backed client that routes through their
  * own API, or a scripted client in tests/demos.
  */
-export type SessionClientLike = Pick<OpenGeniClient, "getClientConfig" | "getSession" | "getSessionLineage" | "updateSession" | "updateSessionPin" | "listSessions" | "listSessionPage" | "sendMessage" | "steerMessage" | "pauseSession" | "resumeSession" | "sendApprovalDecision" | "listHumanInputRequests" | "getHumanInputRequest" | "submitHumanInputResponse" | "listEvents" | "streamEvents" | "getQueue" | "moveQueueItem" | "editQueueItem" | "steerQueueItem" | "deleteQueueItem" | "getComposerDraft" | "saveComposerDraft" | "listTurns" | "getGoal" | "updateGoal" | "deleteGoal" | "clearSessionContext" | "compactSessionContext" | "listScheduledTasks" | "uploadFile" | "getFile" | "createFileDownloadUrl" | "listVariableSets" | "getVariableSetVariable" | "createVariableSet" | "updateVariableSet" | "deleteVariableSet" | "setVariableSetVariable" | "deleteVariableSetVariable" | "listEnvironments" | "createEnvironment" | "updateEnvironment" | "deleteEnvironment" | "setEnvironmentVariable" | "deleteEnvironmentVariable" | "listChannels" | "createChannel" | "updateChannel" | "deleteChannel" | "updateSessionChannel" | "listRigs" | "createRig" | "getRig" | "updateRig" | "deleteRig" | "listRigVersions" | "activateRigVersion" | "listRigChanges" | "proposeRigChange" | "getRigChange" | "verifyRigChange" | "promoteRigChange" | "verifyRig" | "listPacks" | "registerPack" | "enablePack" | "previewPackInstallation" | "installPack" | "previewPackUninstall" | "uninstallPack" | "deletePack" | "listWorkspaces" | "createWorkspace" | "updateWorkspace" | "setWorkspaceInferenceState" | "getWorkspace" | "getWorkspaceModelCatalog" | "listWorkspaceControlEvents" | "streamWorkspaceControlEvents" | "streamWorkspaceInteractionRevisions" | "getBillingUsage" | "getClientConfig" | "getStreamCapabilities" | "acknowledgeStream" | "attachViewer" | "heartbeatViewer" | "detachViewer" | "listNetworkRoutes" | "getNetworkRoute" | "createNetworkRoute" | "updateNetworkRoute" | "listSiteAuthConnections" | "getSiteAuthConnection" | "createSiteAuthConnection" | "updateSiteAuthConnection" | "listAuthRuns" | "getAuthRun" | "startBrowserAuthRun" | "reportBrowserAuthRun" | "protectedBrowserAuthFill" | "verifyBrowserAuthRun" | "listInteractionInterventions" | "getInteractionIntervention" | "createInteractionIntervention" | "resolveInteractionIntervention" | "listAttachedBrowsers" | "getAttachedBrowser" | "listBrowserIdentities" | "getBrowserIdentity" | "createBrowserIdentity" | "updateBrowserIdentity" | "listBrowserRevisions" | "listBrowserSessions" | "getBrowserSession" | "readBrowserClipboard" | "listBrowserDownloads" | "getBrowserDownload" | "saveBrowserDownload" | "createBrowserSession" | "listBrowserTargets" | "openBrowserTarget" | "selectBrowserTarget" | "closeBrowserTarget" | "observeBrowserTarget" | "actInBrowser" | "getBrowserActionReceipt" | "listBrowserDiagnostics" | "attachBrowserSession" | "heartbeatBrowserSession" | "publishBrowserRevision" | "suspendBrowserSession" | "resumeBrowserSession" | "endBrowserSession" | "listComputerSessions" | "getComputerSession" | "readComputerClipboard" | "createComputerSession" | "listComputerTargets" | "observeComputerTarget" | "actInComputer" | "getComputerActionReceipt" | "attachComputerSession" | "heartbeatComputerSession" | "endComputerSession" | "fsList" | "fsListBatch" | "fsRead" | "fsWrite" | "fsDelete" | "fsMove" | "fsMkdir" | "gitStatus" | "gitDiff" | "gitReadBatch" | "getWorkspaceCapture" | "getWorkspaceCaptureFile" | "terminalExec" | "terminalPtyOpen" | "terminalPtyWrite" | "terminalPtyResize" | "terminalPtyClose"> & Partial<Pick<OpenGeniClient, "createVideoArtifactPlaybackSource" | "streamWorkspaceLiveEvents">>;
+type SessionClientMethods = Pick<OpenGeniClient, "getClientConfig" | "getSession" | "getSessionLineage" | "updateSession" | "updateSessionPin" | "listSessions" | "listSessionPage" | "sendMessage" | "steerMessage" | "pauseSession" | "resumeSession" | "sendApprovalDecision" | "listHumanInputRequests" | "getHumanInputRequest" | "submitHumanInputResponse" | "listEvents" | "streamEvents" | "getQueue" | "moveQueueItem" | "editQueueItem" | "steerQueueItem" | "deleteQueueItem" | "getComposerDraft" | "saveComposerDraft" | "submitComposerDraft" | "listTurns" | "getGoal" | "updateGoal" | "deleteGoal" | "clearSessionContext" | "compactSessionContext" | "listScheduledTasks" | "uploadFile" | "getFile" | "createFileDownloadUrl" | "listVariableSets" | "getVariableSetVariable" | "createVariableSet" | "updateVariableSet" | "deleteVariableSet" | "setVariableSetVariable" | "deleteVariableSetVariable" | "listEnvironments" | "createEnvironment" | "updateEnvironment" | "deleteEnvironment" | "setEnvironmentVariable" | "deleteEnvironmentVariable" | "listChannels" | "createChannel" | "updateChannel" | "reorderChannels" | "deleteChannel" | "updateSessionChannel" | "listRigs" | "createRig" | "getRig" | "updateRig" | "deleteRig" | "listRigVersions" | "activateRigVersion" | "listRigChanges" | "proposeRigChange" | "getRigChange" | "verifyRigChange" | "promoteRigChange" | "verifyRig" | "listWorkspaces" | "createWorkspace" | "updateWorkspace" | "setWorkspaceInferenceState" | "getWorkspace" | "getWorkspaceModelCatalog" | "listWorkspaceControlEvents" | "streamWorkspaceControlEvents" | "streamWorkspaceInteractionRevisions" | "getBillingUsage" | "getClientConfig" | "getStreamCapabilities" | "acknowledgeStream" | "attachViewer" | "heartbeatViewer" | "detachViewer" | "listNetworkRoutes" | "getNetworkRoute" | "createNetworkRoute" | "updateNetworkRoute" | "listSiteAuthConnections" | "getSiteAuthConnection" | "createSiteAuthConnection" | "updateSiteAuthConnection" | "listAuthRuns" | "getAuthRun" | "startBrowserAuthRun" | "reportBrowserAuthRun" | "protectedBrowserAuthFill" | "verifyBrowserAuthRun" | "listInteractionInterventions" | "getInteractionIntervention" | "createInteractionIntervention" | "resolveInteractionIntervention" | "listAttachedBrowsers" | "getAttachedBrowser" | "listBrowserIdentities" | "getBrowserIdentity" | "createBrowserIdentity" | "updateBrowserIdentity" | "listBrowserRevisions" | "listBrowserSessions" | "getBrowserSession" | "readBrowserClipboard" | "listBrowserDownloads" | "getBrowserDownload" | "saveBrowserDownload" | "createBrowserSession" | "listBrowserTargets" | "openBrowserTarget" | "selectBrowserTarget" | "closeBrowserTarget" | "observeBrowserTarget" | "actInBrowser" | "getBrowserActionReceipt" | "listBrowserDiagnostics" | "attachBrowserSession" | "heartbeatBrowserSession" | "publishBrowserRevision" | "suspendBrowserSession" | "resumeBrowserSession" | "endBrowserSession" | "listComputerSessions" | "getComputerSession" | "readComputerClipboard" | "createComputerSession" | "listComputerTargets" | "observeComputerTarget" | "actInComputer" | "getComputerActionReceipt" | "attachComputerSession" | "heartbeatComputerSession" | "endComputerSession" | "fsList" | "fsListBatch" | "fsRead" | "fsWrite" | "fsDelete" | "fsMove" | "fsMkdir" | "gitStatus" | "gitDiff" | "gitReadBatch" | "getWorkspaceCapture" | "getWorkspaceCaptureFile" | "terminalExec" | "terminalPtyOpen" | "terminalPtyWrite" | "terminalPtyResize" | "terminalPtyClose"> & Partial<Pick<OpenGeniClient, "createVideoArtifactPlaybackSource" | "streamWorkspaceLiveEvents" | "listSessionBackgroundCommands" | "cancelSessionBackgroundCommand" | "getComputerInputPosture">>;
+/** Compact list transport is optional for scripted and older clients. */
+export type SessionClientLike = SessionClientMethods & Partial<Pick<OpenGeniClient, "listSessionSummaryPage">>;
 /**
  * Tenant-safe client surface required by the session-only React entry.
  *
@@ -14,7 +16,7 @@ export type SessionClientLike = Pick<OpenGeniClient, "getClientConfig" | "getSes
  * host that does not expose that authority still supports every session-local
  * composer/control path.
  */
-export type EmbeddedSessionClientLike = Pick<OpenGeniClient, "getSession" | "listEvents" | "streamEvents" | "getComposerDraft" | "saveComposerDraft" | "sendMessage" | "steerMessage" | "getQueue" | "moveQueueItem" | "editQueueItem" | "steerQueueItem" | "deleteQueueItem" | "pauseSession" | "resumeSession" | "sendApprovalDecision"> & {
+export type EmbeddedSessionClientLike = Pick<OpenGeniClient, "getSession" | "listEvents" | "streamEvents" | "getComposerDraft" | "saveComposerDraft" | "submitComposerDraft" | "sendMessage" | "steerMessage" | "getQueue" | "moveQueueItem" | "editQueueItem" | "steerQueueItem" | "deleteQueueItem" | "pauseSession" | "resumeSession" | "sendApprovalDecision"> & {
     setWorkspaceInferenceState?: OpenGeniClient["setWorkspaceInferenceState"] | undefined;
 };
 /** Event-read surface shared by hooks that optionally tail a session. */
@@ -26,7 +28,7 @@ export type EmbeddedGoalClientLike = EmbeddedSessionEventClientLike & Pick<OpenG
 /** Exact client surface required by {@link useSessionLineage}. */
 export type EmbeddedSessionLineageClientLike = EmbeddedSessionEventClientLike & Pick<OpenGeniClient, "getSessionLineage">;
 /** Exact client surface required by {@link useFileAttachments}. */
-export type EmbeddedFileAttachmentClientLike = Pick<OpenGeniClient, "uploadFile">;
+export type EmbeddedFileAttachmentClientLike = Pick<OpenGeniClient, "uploadFile"> & Partial<Pick<OpenGeniClient, "createFileDownloadUrl">>;
 /** Exact client surface required by structured human-input hooks. */
 export type EmbeddedHumanInputSessionClientLike = EmbeddedSessionEventClientLike & Pick<OpenGeniClient, "listHumanInputRequests" | "submitHumanInputResponse">;
 /** Exact client surface required by MCP approval-policy hooks. */
@@ -38,6 +40,7 @@ export type EmbeddedInterventionClientLike = Pick<OpenGeniClient, "streamWorkspa
 /** Exact public SDK surface required by BrowserSession hooks and components. */
 export type EmbeddedBrowserInteractionClientLike = Pick<OpenGeniClient, "streamWorkspaceInteractionRevisions" | "listNetworkRoutes" | "getNetworkRoute" | "createNetworkRoute" | "updateNetworkRoute" | "listSiteAuthConnections" | "getSiteAuthConnection" | "createSiteAuthConnection" | "updateSiteAuthConnection" | "listAuthRuns" | "getAuthRun" | "startBrowserAuthRun" | "reportBrowserAuthRun" | "protectedBrowserAuthFill" | "verifyBrowserAuthRun" | "listInteractionInterventions" | "getInteractionIntervention" | "createInteractionIntervention" | "resolveInteractionIntervention" | "listAttachedBrowsers" | "getAttachedBrowser" | "listBrowserIdentities" | "getBrowserIdentity" | "createBrowserIdentity" | "updateBrowserIdentity" | "listBrowserRevisions" | "listBrowserSessions" | "getBrowserSession" | "readBrowserClipboard" | "listBrowserDownloads" | "getBrowserDownload" | "saveBrowserDownload" | "createBrowserSession" | "listBrowserTargets" | "openBrowserTarget" | "selectBrowserTarget" | "closeBrowserTarget" | "observeBrowserTarget" | "actInBrowser" | "getBrowserActionReceipt" | "listBrowserDiagnostics" | "attachBrowserSession" | "heartbeatBrowserSession" | "publishBrowserRevision" | "suspendBrowserSession" | "resumeBrowserSession" | "endBrowserSession"> & EmbeddedInterventionClientLike;
 /** Exact public SDK surface required by ComputerSession hooks and components. */
-export type EmbeddedComputerInteractionClientLike = Pick<OpenGeniClient, "streamWorkspaceInteractionRevisions" | "listComputerSessions" | "getComputerSession" | "readComputerClipboard" | "createComputerSession" | "listComputerTargets" | "observeComputerTarget" | "actInComputer" | "getComputerActionReceipt" | "attachComputerSession" | "heartbeatComputerSession" | "endComputerSession"> & EmbeddedInterventionClientLike;
+export type EmbeddedComputerInteractionClientLike = Pick<OpenGeniClient, "streamWorkspaceInteractionRevisions" | "listComputerSessions" | "getComputerSession" | "readComputerClipboard" | "createComputerSession" | "listComputerTargets" | "observeComputerTarget" | "actInComputer" | "getComputerActionReceipt" | "attachComputerSession" | "heartbeatComputerSession" | "endComputerSession"> & EmbeddedInterventionClientLike & Partial<Pick<OpenGeniClient, "getComputerInputPosture">>;
 /** Complete public Browser + Computer interaction surface. */
 export type EmbeddedInteractionClientLike = EmbeddedBrowserInteractionClientLike & EmbeddedComputerInteractionClientLike;
+export {};

package/dist/clipboard.js

@@ -1,3 +1,4 @@
+import "./chunk-IWIDV7SB.js";
 import {
   copyTextToClipboard
 } from "./chunk-JVYQRRC4.js";

package/dist/commands/types.d.ts

@@ -40,6 +40,8 @@ export type CommandContext = {
     permissions: Permission[];
     /** Surface a transient ok/error notice in the composer. */
     notice: (notice: Notice) => void;
+    /** Optional presentation hook for native command failures; never rewrites command content. */
+    formatError?: ((error: unknown, defaultMessage: string) => string) | undefined;
     /** Open the in-composer /help panel (rendered from the registry). */
     openHelp: () => void;
     /**

package/dist/components/anthropic-mark.d.ts

@@ -0,0 +1,3 @@
+import type { SVGProps } from "react";
+/** AnthropicMark: Simple Icons, CC0; https://github.com/simple-icons/simple-icons */
+export declare function AnthropicMark(props: SVGProps<SVGSVGElement>): import("react").JSX.Element;

package/dist/components/approval-surface.d.ts

@@ -2,12 +2,16 @@ import { type ReactNode } from "react";
 import type { PendingApproval } from "../approvals.js";
 export type ApprovalSurfaceMessages = {
     title: string;
+    /** Screen-reader context for the decision; not shown visually. */
     description: string;
     approve: string;
     reject: string;
     approving: string;
     rejecting: string;
     formatToolName: (name: string) => string;
+    /** Toggle for the exact arguments when they are shown as readable fields. */
+    showDetails?: string | undefined;
+    hideDetails?: string | undefined;
 };
 export declare const defaultApprovalSurfaceMessages: ApprovalSurfaceMessages;
 export type ApprovalSurfaceProps = {
@@ -20,6 +24,17 @@ export type ApprovalSurfaceProps = {
     renderApproval?: ((approval: PendingApproval) => ReactNode) | undefined;
     className?: string | undefined;
 };
+export type ApprovalField = {
+    key: string;
+    label: string;
+    value: string;
+};
+/**
+ * Readable fields for a flat argument object (scalars and short scalar lists).
+ * Returns null when the arguments are nested, large, or not an object, so the
+ * caller shows the exact JSON instead of a lossy summary.
+ */
+export declare function approvalArgumentFields(value: unknown): ApprovalField[] | null;
 /**
  * Host-neutral approval presentation backed by the native pending-approval
  * projection and control callbacks. It owns only presentation and duplicate

package/dist/components/artifacts/artifact-chrome.d.ts

@@ -0,0 +1,120 @@
+import { type ComponentProps, type ReactNode } from "react";
+/**
+ * Shared chrome for artifact surfaces: the OpenGeni console and embedding hosts
+ * render the same header, controls, and load states. Class names use the
+ * package theme aliases, so the console's own Tailwind build and the compiled
+ * `.og-root` stylesheet resolve them identically.
+ */
+export type ArtifactKind = "document" | "spreadsheet" | "presentation" | "site" | "image" | "file";
+declare const BUTTON_VARIANT: {
+    readonly ghost: "hover:bg-accent hover:text-accent-foreground dark:hover:bg-accent/50";
+    readonly outline: "border bg-background shadow-xs hover:bg-accent hover:text-accent-foreground dark:border-border dark:bg-input/30 dark:hover:bg-input/50";
+};
+declare const BUTTON_SIZE: {
+    readonly sm: "h-8 gap-1.5 rounded-md px-3 has-[>svg]:px-2.5";
+    readonly icon: "size-9";
+    readonly "icon-sm": "size-8";
+};
+export declare function ArtifactButton({ variant, size, className, type, ...props }: ComponentProps<"button"> & {
+    variant?: keyof typeof BUTTON_VARIANT;
+    size?: keyof typeof BUTTON_SIZE;
+}): import("react").JSX.Element;
+export declare function ArtifactBadge({ className, ...props }: ComponentProps<"span">): import("react").JSX.Element;
+export declare const ArtifactSelect: import("react").ForwardRefExoticComponent<Omit<import("react").DetailedHTMLProps<import("react").SelectHTMLAttributes<HTMLSelectElement>, HTMLSelectElement>, "ref"> & import("react").RefAttributes<HTMLSelectElement>>;
+export declare function artifactKindIcon(kind: ArtifactKind): ReactNode;
+export declare function artifactKindSubtitle(kind: ArtifactKind): string;
+type LoadErrorCopy = Readonly<Record<"unavailable" | "invalid" | "transient", {
+    title: string;
+    message: string;
+}>>;
+/**
+ * Every user-facing string in the artifact surfaces (inline Site preview, Site
+ * frame, viewer header and states). Hosts translate by passing a partial
+ * `labels` object; unspecified keys keep the English defaults.
+ */
+export type ArtifactLabels = Readonly<{
+    back: string;
+    close: string;
+    /** Header title and loading copy until an artifact's title is known. */
+    opening: string;
+    /** Header title when an artifact cannot be opened. */
+    artifact: string;
+    startingEditor: string;
+    kindSubtitle: (kind: ArtifactKind) => string;
+    live: string;
+    reloadSite: string;
+    openFullScreen: string;
+    editWithAgent: string;
+    editShort: string;
+    preview: string;
+    loadPreview: string;
+    loadSitePreview: string;
+    siteVersion: string;
+    savedVersion: string;
+    version: (revision: number) => string;
+    openSite: string;
+    loadingSite: string;
+    siteArchived: string;
+    siteUnpublished: string;
+    siteReferenceInvalid: string;
+    siteLoadFailed: string;
+    retry: string;
+    tryAgain: string;
+    toolCount: (count: number) => string;
+    toolsAvailable: (count: number) => string;
+    sourceFileCount: (count: number) => string;
+    viewingDisabled: {
+        title: string;
+        message: string;
+    };
+    editorsMissing: {
+        title: string;
+        message: string;
+    };
+    siteErrors: LoadErrorCopy;
+    editableErrors: LoadErrorCopy;
+    reference: (id: string) => string;
+}>;
+export declare const DEFAULT_ARTIFACT_LABELS: ArtifactLabels;
+/** Translate every artifact surface below; nested providers override outer ones. */
+export declare function ArtifactLabelsProvider({ labels, children, }: {
+    labels: Partial<ArtifactLabels> | undefined;
+    children: ReactNode;
+}): import("react").JSX.Element;
+export declare function useArtifactLabels(): ArtifactLabels;
+/**
+ * One artifact header: optional Back, the kind tile, title (or a host-supplied
+ * title control), trailing actions, and optional Close. The console dock and
+ * embedded viewers share it.
+ */
+export declare function ArtifactViewerHeader({ kind, title, subtitle, titleSlot, onBack, backLabel, actions, onClose, closeLabel, }: Readonly<{
+    /** `null` while the host does not know the modality yet. */
+    kind: ArtifactKind | null;
+    title: string;
+    subtitle?: string | undefined;
+    /** Replaces the title text, for example with a picker. */
+    titleSlot?: ReactNode;
+    onBack?: (() => void) | undefined;
+    backLabel?: string | undefined;
+    actions?: ReactNode;
+    onClose?: (() => void) | undefined;
+    closeLabel?: string | undefined;
+}>): import("react").JSX.Element;
+export declare function ArtifactLoading({ label }: {
+    label: string;
+}): import("react").JSX.Element;
+export declare function ArtifactProblem({ view, onRetry, }: {
+    view: ArtifactLoadErrorView;
+    onRetry?: (() => void) | undefined;
+}): import("react").JSX.Element;
+export type ArtifactLoadErrorKind = "site" | "editable";
+export type ArtifactLoadErrorView = Readonly<{
+    title: string;
+    message: string;
+    retryable: boolean;
+    correlationId?: string;
+}>;
+/** Site/editor load copy. Never surfaces raw OpenGeni API status text. */
+export declare function artifactLoadErrorView(error: unknown, kind: ArtifactLoadErrorKind, labels?: ArtifactLabels): ArtifactLoadErrorView;
+export declare function artifactLoadErrorMessage(view: ArtifactLoadErrorView, labels?: ArtifactLabels): string;
+export {};

package/dist/components/artifacts/artifact-sandbox.d.ts

@@ -0,0 +1,27 @@
+import { type ReactNode } from "react";
+import { type PublishedHtmlArtifactToolBridge } from "./published-html-artifact-frame.js";
+export type ArtifactSandboxProps = {
+    html: string;
+    height?: number | undefined;
+    autoHeight?: boolean | undefined;
+    theme?: "light" | "dark" | undefined;
+    headerControls?: ReactNode | undefined;
+    title: string;
+    /** Hide the visible title/icon while retaining the accessible iframe title. */
+    showTitle?: boolean | undefined;
+    showLiveStatus?: boolean | undefined;
+    versionLabel?: string | undefined;
+    className?: string | undefined;
+    editDisabled?: boolean | undefined;
+    onEdit?: (() => void) | undefined;
+    toolBridge?: PublishedHtmlArtifactToolBridge | undefined;
+    connectedToolCount?: number | undefined;
+    sourceFileCount?: number | undefined;
+    fill?: boolean | undefined;
+};
+/**
+ * The Site/preview frame chrome shared by the console and embedding hosts:
+ * title, version and tool badges, live status, reload, and a full-screen mode
+ * that escapes the host's scroll containers through the modal top layer.
+ */
+export declare function ArtifactSandbox(props: ArtifactSandboxProps): import("react").JSX.Element;

package/dist/components/artifacts/artifact-surface.d.ts

@@ -3,6 +3,8 @@ export type ArtifactModality = "spreadsheet" | "document" | "presentation";
 export type ArtifactSurfaceProps = {
     modality: ArtifactModality;
     title: string;
+    /** An embedding host may already provide the artifact title and navigation. */
+    showHeader?: boolean | undefined;
     subtitle?: ReactNode | undefined;
     actions?: ReactNode | undefined;
     children: ReactNode;
@@ -15,4 +17,4 @@ export type ArtifactSurfaceProps = {
  * persistence state: hosts can use the same surface for a local draft, a
  * durable OpenGeni artifact, or a collaborative projection.
  */
-export declare function ArtifactSurface({ modality, title, subtitle, actions, children, footer, busy, className, }: ArtifactSurfaceProps): import("react").JSX.Element;
+export declare function ArtifactSurface({ modality, title, showHeader, subtitle, actions, children, footer, busy, className, }: ArtifactSurfaceProps): import("react").JSX.Element;