@opengeni/react 4.4.1 → 4.5.1-canary.39832248373001

package/dist/{chunk-NAWXARTY.js → chunk-2KO2G3RI.js}

@@ -4,7 +4,7 @@ import {
 } from "./chunk-CM7LVUKC.js";
 
 // src/hooks/internal.ts
-import { observedSessionSequence } from "@opengeni/sdk";
+import { isTransientRequestError, observedSessionSequence } from "@opengeni/sdk";
 import { useCallback, useEffect, useLayoutEffect, useRef, useState } from "react";
 var HIDDEN_STREAM_GRACE_MS = 2e3;
 function usePageLiveActivity(hiddenGraceMs = HIDDEN_STREAM_GRACE_MS) {
@@ -40,9 +40,31 @@ function usePageLiveActivity(hiddenGraceMs = HIDDEN_STREAM_GRACE_MS) {
   }, [hiddenGraceMs]);
   return active;
 }
+var DEFAULT_TRANSIENT_READ_RETRY = Object.freeze({
+  quietWindowMs: 2e4,
+  initialDelayMs: 1e3,
+  maxDelayMs: 4e3,
+  backgroundDelayMs: 15e3
+});
+function jittered(delayMs) {
+  return Math.round(delayMs * (0.8 + Math.random() * 0.4));
+}
+function transientReadRetryStep(streak, now, policy) {
+  streak.attempts += 1;
+  const quiet = now - streak.since < policy.quietWindowMs;
+  const delayMs = quiet ? Math.min(policy.maxDelayMs, policy.initialDelayMs * 2 ** (streak.attempts - 1)) : policy.backgroundDelayMs;
+  return { quiet, delayMs: Math.max(0, jittered(delayMs)) };
+}
 function usePolledValue(load, options = {}) {
   const enabled = options.enabled ?? true;
   const pollIntervalMs = options.pollIntervalMs;
+  const transientRetryRef = useRef(null);
+  transientRetryRef.current = options.transientRetry === false ? null : {
+    quietWindowMs: options.transientRetry?.quietWindowMs ?? DEFAULT_TRANSIENT_READ_RETRY.quietWindowMs,
+    initialDelayMs: options.transientRetry?.initialDelayMs ?? DEFAULT_TRANSIENT_READ_RETRY.initialDelayMs,
+    maxDelayMs: options.transientRetry?.maxDelayMs ?? DEFAULT_TRANSIENT_READ_RETRY.maxDelayMs,
+    backgroundDelayMs: options.transientRetry?.backgroundDelayMs ?? DEFAULT_TRANSIENT_READ_RETRY.backgroundDelayMs
+  };
   const pageLive = usePageLiveActivity();
   const [data, setData] = useState(null);
   const [loading, setLoading] = useState(enabled);
@@ -55,6 +77,15 @@ function usePolledValue(load, options = {}) {
   const requestAbortRef = useRef(null);
   const inFlightRef = useRef(null);
   const trailingRefreshRef = useRef(null);
+  const transientStreakRef = useRef(null);
+  const transientRetryTimerRef = useRef(null);
+  const retryLiveRef = useRef(false);
+  const cancelTransientRetry = useCallback(() => {
+    if (transientRetryTimerRef.current !== null) {
+      clearTimeout(transientRetryTimerRef.current);
+      transientRetryTimerRef.current = null;
+    }
+  }, []);
   const [stateIdentity, setStateIdentity] = useState(() => ({ load }));
   useEffect(() => {
     if (stateIdentity.load !== load) {
@@ -75,14 +106,39 @@ function usePolledValue(load, options = {}) {
       try {
         const result = await load(requestAbort.signal);
         if (ticket === generation.current && activeLoadRef.current === load && !requestAbort.signal.aborted) {
+          transientStreakRef.current = null;
+          cancelTransientRetry();
           setData(result);
           setError(null);
           setLoading(false);
         }
       } catch (cause) {
         if (ticket === generation.current && activeLoadRef.current === load && !requestAbort.signal.aborted) {
-          setError(normalizeError(cause));
-          setLoading(false);
+          const policy = transientRetryRef.current;
+          if (policy && retryLiveRef.current && isTransientRequestError(cause)) {
+            const now = Date.now();
+            const streak = transientStreakRef.current ??= {
+              since: now,
+              attempts: 0,
+              surfaced: false
+            };
+            const step = transientReadRetryStep(streak, now, policy);
+            if (!step.quiet) {
+              if (!streak.surfaced) setError(normalizeError(cause));
+              streak.surfaced = true;
+              setLoading(false);
+            }
+            cancelTransientRetry();
+            transientRetryTimerRef.current = setTimeout(() => {
+              transientRetryTimerRef.current = null;
+              if (retryLiveRef.current) void run();
+            }, step.delayMs);
+          } else {
+            transientStreakRef.current = null;
+            cancelTransientRetry();
+            setError(normalizeError(cause));
+            setLoading(false);
+          }
         }
       } finally {
         if (requestAbortRef.current === requestAbort) requestAbortRef.current = null;
@@ -91,7 +147,7 @@ function usePolledValue(load, options = {}) {
     })();
     inFlightRef.current = { load, promise };
     return promise;
-  }, [load]);
+  }, [cancelTransientRetry, load]);
   const refresh = useCallback(() => {
     const existing = inFlightRef.current;
     if (existing?.load !== load) return run();
@@ -108,7 +164,10 @@ function usePolledValue(load, options = {}) {
     return promise;
   }, [load, run]);
   useEffect(() => {
+    transientStreakRef.current = null;
+    cancelTransientRetry();
     if (!enabled || !pageLive) {
+      retryLiveRef.current = false;
       setLoading(false);
       generation.current += 1;
       requestAbortRef.current?.abort();
@@ -116,6 +175,7 @@ function usePolledValue(load, options = {}) {
       trailingRefreshRef.current = null;
       return;
     }
+    retryLiveRef.current = true;
     setLoading(true);
     let cancelled = false;
     let timer = null;
@@ -130,6 +190,8 @@ function usePolledValue(load, options = {}) {
     if (pollIntervalMs === void 0 || pollIntervalMs <= 0) {
       return () => {
         cancelled = true;
+        retryLiveRef.current = false;
+        cancelTransientRetry();
         generation.current += 1;
         requestAbortRef.current?.abort();
         inFlightRef.current = null;
@@ -139,12 +201,14 @@ function usePolledValue(load, options = {}) {
     return () => {
       cancelled = true;
       if (timer !== null) clearTimeout(timer);
+      retryLiveRef.current = false;
+      cancelTransientRetry();
       generation.current += 1;
       requestAbortRef.current?.abort();
       inFlightRef.current = null;
       trailingRefreshRef.current = null;
     };
-  }, [run, enabled, pageLive, pollIntervalMs]);
+  }, [run, enabled, pageLive, pollIntervalMs, cancelTransientRetry]);
   const identityMatches = stateIdentity.load === load;
   return {
     data: identityMatches ? data : null,
@@ -378,10 +442,12 @@ function useDebouncedCallback(callback, delayMs = 150) {
 
 export {
   usePageLiveActivity,
+  DEFAULT_TRANSIENT_READ_RETRY,
+  transientReadRetryStep,
   usePolledValue,
   useMutationRunner,
   projectionReadThrough,
   useSessionEventTrigger,
   useDebouncedCallback
 };
-//# sourceMappingURL=chunk-NAWXARTY.js.map
+//# sourceMappingURL=chunk-2KO2G3RI.js.map

package/dist/chunk-2KO2G3RI.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/hooks/internal.ts"],"sourcesContent":["import { isTransientRequestError, observedSessionSequence, 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 * How a read hook rides out transient failures (a transport error or a\n * 502/503/504, as during an API rolling deploy). While the failures last less\n * than `quietWindowMs`, the hook keeps its loading state or its last data and\n * retries with backoff; after that it surfaces the error but keeps retrying\n * every `backgroundDelayMs`, and clears the error when a read succeeds.\n * Definitive errors (401, 403, 404, other statuses) surface immediately.\n */\nexport type TransientReadRetryOptions = {\n  quietWindowMs?: number | undefined;\n  initialDelayMs?: number | undefined;\n  maxDelayMs?: number | undefined;\n  backgroundDelayMs?: number | undefined;\n};\n\nexport type TransientReadRetryPolicy = {\n  quietWindowMs: number;\n  initialDelayMs: number;\n  maxDelayMs: number;\n  backgroundDelayMs: number;\n};\n\nexport const DEFAULT_TRANSIENT_READ_RETRY: Readonly<TransientReadRetryPolicy> = Object.freeze({\n  quietWindowMs: 20_000,\n  initialDelayMs: 1_000,\n  maxDelayMs: 4_000,\n  backgroundDelayMs: 15_000,\n});\n\ntype TransientReadStreak = { since: number; attempts: number; surfaced: boolean };\n\nfunction jittered(delayMs: number): number {\n  return Math.round(delayMs * (0.8 + Math.random() * 0.4));\n}\n\n/**\n * The decision for one transient read failure: stay quiet and retry soon, or\n * surface the error (once per streak) and keep retrying in the background.\n */\nexport function transientReadRetryStep(\n  streak: TransientReadStreak,\n  now: number,\n  policy: TransientReadRetryPolicy,\n): { quiet: boolean; delayMs: number } {\n  streak.attempts += 1;\n  const quiet = now - streak.since < policy.quietWindowMs;\n  const delayMs = quiet\n    ? Math.min(policy.maxDelayMs, policy.initialDelayMs * 2 ** (streak.attempts - 1))\n    : policy.backgroundDelayMs;\n  return { quiet, delayMs: Math.max(0, jittered(delayMs)) };\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 * Transient failures are retried quietly (see {@link TransientReadRetryOptions}).\n */\nexport function usePolledValue<T>(\n  load: (signal?: AbortSignal) => Promise<T>,\n  options: {\n    pollIntervalMs?: number | undefined;\n    enabled?: boolean | undefined;\n    /** Quiet retry of transient failures; on by default, `false` surfaces them at once. */\n    transientRetry?: TransientReadRetryOptions | false | undefined;\n  } = {},\n): AsyncListState<T> {\n  const enabled = options.enabled ?? true;\n  const pollIntervalMs = options.pollIntervalMs;\n  const transientRetryRef = useRef<TransientReadRetryPolicy | null>(null);\n  transientRetryRef.current =\n    options.transientRetry === false\n      ? null\n      : {\n          quietWindowMs:\n            options.transientRetry?.quietWindowMs ?? DEFAULT_TRANSIENT_READ_RETRY.quietWindowMs,\n          initialDelayMs:\n            options.transientRetry?.initialDelayMs ?? DEFAULT_TRANSIENT_READ_RETRY.initialDelayMs,\n          maxDelayMs: options.transientRetry?.maxDelayMs ?? DEFAULT_TRANSIENT_READ_RETRY.maxDelayMs,\n          backgroundDelayMs:\n            options.transientRetry?.backgroundDelayMs ??\n            DEFAULT_TRANSIENT_READ_RETRY.backgroundDelayMs,\n        };\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  // The current run of consecutive transient failures, and its pending retry.\n  const transientStreakRef = useRef<TransientReadStreak | null>(null);\n  const transientRetryTimerRef = useRef<ReturnType<typeof setTimeout> | null>(null);\n  // Retries run only while the query is enabled and the page is live.\n  const retryLiveRef = useRef(false);\n  const cancelTransientRetry = useCallback(() => {\n    if (transientRetryTimerRef.current !== null) {\n      clearTimeout(transientRetryTimerRef.current);\n      transientRetryTimerRef.current = null;\n    }\n  }, []);\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          transientStreakRef.current = null;\n          cancelTransientRetry();\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          const policy = transientRetryRef.current;\n          if (policy && retryLiveRef.current && isTransientRequestError(cause)) {\n            // Keep the loading state or the last data on screen while a\n            // deploy or network blip passes; retry, and surface the error\n            // only once it outlasts the quiet window.\n            const now = Date.now();\n            const streak = (transientStreakRef.current ??= {\n              since: now,\n              attempts: 0,\n              surfaced: false,\n            });\n            const step = transientReadRetryStep(streak, now, policy);\n            if (!step.quiet) {\n              // One stable error per streak: background retries that fail\n              // the same way must not re-announce it.\n              if (!streak.surfaced) setError(normalizeError(cause));\n              streak.surfaced = true;\n              setLoading(false);\n            }\n            cancelTransientRetry();\n            transientRetryTimerRef.current = setTimeout(() => {\n              transientRetryTimerRef.current = null;\n              if (retryLiveRef.current) void run();\n            }, step.delayMs);\n          } else {\n            transientStreakRef.current = null;\n            cancelTransientRetry();\n            setError(normalizeError(cause));\n            setLoading(false);\n          }\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  }, [cancelTransientRetry, 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    // Every (re)start begins a fresh streak; a pending retry belongs to the\n    // previous query or visibility period.\n    transientStreakRef.current = null;\n    cancelTransientRetry();\n    if (!enabled || !pageLive) {\n      retryLiveRef.current = false;\n      setLoading(false);\n      generation.current += 1;\n      requestAbortRef.current?.abort();\n      inFlightRef.current = null;\n      trailingRefreshRef.current = null;\n      return;\n    }\n    retryLiveRef.current = true;\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        retryLiveRef.current = false;\n        cancelTransientRetry();\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      retryLiveRef.current = false;\n      cancelTransientRetry();\n      generation.current += 1;\n      requestAbortRef.current?.abort();\n      inFlightRef.current = null;\n      trailingRefreshRef.current = null;\n    };\n  }, [run, enabled, pageLive, pollIntervalMs, cancelTransientRetry]);\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 * What a read hook's authoritative value reflects, for {@link useSessionEventTrigger}:\n *\n * - a number: every session event at or below this sequence (the session\n *   detail's `lastSequence`, or a projection's `observedSessionSequence`);\n * - `\"reading\"`: the first read for this conversation is still in flight;\n * - `null` (or omitted): unknown, so every matching event refreshes.\n */\nexport type SessionReadThrough = number | \"reading\" | null;\n\n/** The sequence a projection read reflects, as {@link SessionReadThrough}. */\nexport function projectionReadThrough(\n  value: unknown,\n  firstReadInFlight: boolean,\n): SessionReadThrough {\n  if (value === null || value === undefined) return firstReadInFlight ? \"reading\" : null;\n  return observedSessionSequence(value) ?? null;\n}\n\nexport type SessionEventTriggerOptions = SessionEventFeedOptions & {\n  /**\n   * Shared-feed mode: deliver an event only when the hook's own read does not\n   * already reflect it. While the first read is in flight, matching events\n   * wait for it and the newest is delivered once if the read predates it.\n   */\n  readThrough?: SessionReadThrough | undefined;\n  /**\n   * Re-read the hook's projection. Called instead of delivering an event when\n   * the feed's window starts after the sequence the read reflects, so events\n   * between them (which could have changed the projection) were never seen.\n   */\n  refresh?: (() => void) | undefined;\n};\n\ntype HeldBatch = { latestMatch: SessionEvent | undefined; windowStart: number };\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: SessionEventTriggerOptions = {},\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 readThrough = options.readThrough ?? null;\n  const matchRef = useRef(match);\n  const onEventRef = useRef(onEvent);\n  const reconcileBeforeLiveRef = useRef(reconcileBeforeLive);\n  const readThroughRef = useRef(readThrough);\n  const refreshRef = useRef(options.refresh);\n  useLayoutEffect(() => {\n    matchRef.current = match;\n    onEventRef.current = onEvent;\n    reconcileBeforeLiveRef.current = reconcileBeforeLive;\n    readThroughRef.current = readThrough;\n    refreshRef.current = options.refresh;\n  }, [match, onEvent, reconcileBeforeLive, readThrough, options.refresh]);\n  const consumedRef = useRef(0);\n  const feedKeyRef = useRef<string | null>(null);\n  const sharedFeedHasEventsRef = useRef(false);\n  // The newest matching event that arrived while the first read was in flight,\n  // and the latest window start the feed reported meanwhile.\n  const awaitingReadRef = useRef<HeldBatch | null>(null);\n  const deliverBatch = useCallback((batch: HeldBatch) => {\n    const through = readThroughRef.current;\n    if (through === \"reading\") {\n      const waiting = awaitingReadRef.current;\n      const latest =\n        waiting?.latestMatch &&\n        (!batch.latestMatch || waiting.latestMatch.sequence > batch.latestMatch.sequence)\n          ? waiting.latestMatch\n          : batch.latestMatch;\n      awaitingReadRef.current = {\n        latestMatch: latest,\n        windowStart: Math.max(waiting?.windowStart ?? 0, batch.windowStart),\n      };\n      return;\n    }\n    if (typeof through === \"number\") {\n      // Events between the read and the window's first event were never seen.\n      if (batch.windowStart > through + 1 && refreshRef.current) {\n        refreshRef.current();\n        return;\n      }\n      if (batch.latestMatch && batch.latestMatch.sequence > through) {\n        onEventRef.current(batch.latestMatch);\n      }\n      return;\n    }\n    if (batch.latestMatch) onEventRef.current(batch.latestMatch);\n  }, []);\n  const deliver = useCallback(\n    (event: SessionEvent) => deliverBatch({ latestMatch: event, windowStart: 0 }),\n    [deliverBatch],\n  );\n  // The first read landed: settle what waited for it against what it reflects.\n  useEffect(() => {\n    if (readThrough === \"reading\") return;\n    const waiting = awaitingReadRef.current;\n    awaitingReadRef.current = null;\n    if (waiting && sharedFeed && liveEnabled) deliverBatch(waiting);\n  }, [deliverBatch, liveEnabled, readThrough, sharedFeed]);\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      awaitingReadRef.current = null;\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      deliverBatch({ latestMatch, windowStart: firstSequence });\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        deliver(event);\n      }\n    }\n  }, [sharedFeed, liveEnabled, events, workspaceId, sessionId, deliver, deliverBatch]);\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-TWXIFWBD.js → chunk-34EU25RL.js}

@@ -3,7 +3,7 @@ import {
   invalidateSharedQueries,
   peekSharedQuery,
   sharedQueryWriter
-} from "./chunk-JKUICTLM.js";
+} from "./chunk-NLAFNMPK.js";
 
 // src/hooks/session-view-cache.ts
 import { OpenGeniApiError } from "@opengeni/sdk";
@@ -99,4 +99,4 @@ export {
   deniesRetainedView,
   useRetainedSessionView
 };
-//# sourceMappingURL=chunk-TWXIFWBD.js.map
+//# sourceMappingURL=chunk-34EU25RL.js.map

package/dist/{chunk-PTGRFAMH.js → chunk-3ABPIUCK.js}

@@ -1,7 +1,7 @@
 "use client";
 import {
   ProviderRecoveryNotice
-} from "./chunk-P5T36BA3.js";
+} from "./chunk-FRP64DEK.js";
 
 // src/app/components/session/model-recovery-notice.tsx
 import { jsx } from "react/jsx-runtime";
@@ -12,4 +12,4 @@ function ModelRecoveryNotice({ recovery }) {
 export {
   ModelRecoveryNotice
 };
-//# sourceMappingURL=chunk-PTGRFAMH.js.map
+//# sourceMappingURL=chunk-3ABPIUCK.js.map

package/dist/{chunk-722UO6YQ.js → chunk-3PEXVG4D.js}

@@ -7,7 +7,7 @@ import {
 } from "./chunk-W6KAUGXO.js";
 import {
   useMachines
-} from "./chunk-HT5WSUC7.js";
+} from "./chunk-QXEDIDBZ.js";
 import {
   useOpenGeni
 } from "./chunk-TVQCDDSZ.js";
@@ -53,4 +53,4 @@ function useWorkspaceMachines(options = {}) {
 export {
   useWorkspaceMachines
 };
-//# sourceMappingURL=chunk-722UO6YQ.js.map
+//# sourceMappingURL=chunk-3PEXVG4D.js.map

package/dist/{chunk-N3ZP4IDU.js → chunk-45WYYFP6.js}

@@ -1,7 +1,7 @@
 "use client";
 import {
   rememberedProjectCompute
-} from "./chunk-JXT5QDJC.js";
+} from "./chunk-KNFDWNCH.js";
 
 // src/app/routes/sessions-index-hydration.tsx
 function initialNewSessionProjectLaunchIntent(launchChannelId) {
@@ -53,4 +53,4 @@ export {
   resolveHydratedNewSessionProjectSelection,
   hydratedNewSessionProjectProvenancePresent
 };
-//# sourceMappingURL=chunk-N3ZP4IDU.js.map
+//# sourceMappingURL=chunk-45WYYFP6.js.map

package/dist/{chunk-HOJGAJAB.js → chunk-4MQLGMV2.js}

@@ -4,16 +4,16 @@ import {
 } from "./chunk-XVVJBNUQ.js";
 import {
   scheduledTaskIdOf
-} from "./chunk-BJIZ7PL7.js";
+} from "./chunk-D64Z4V26.js";
 import {
   sessionSiteOrigin
 } from "./chunk-K3TJNJSU.js";
 import {
   sessionStatusLabel
-} from "./chunk-GTQ3SNEI.js";
+} from "./chunk-E36IC3LU.js";
 import {
   t
-} from "./chunk-HPPKLBTJ.js";
+} from "./chunk-TJQDL3JH.js";
 import {
   formatAbsoluteTime,
   inSentence
@@ -21,7 +21,7 @@ import {
 import {
   sessionHasUpcomingSchedule,
   sessionInputWait
-} from "./chunk-Z5WMLJKI.js";
+} from "./chunk-F2RMKGDQ.js";
 import {
   sessionAdmissionBlocked,
   sessionDisplayStatus
@@ -196,4 +196,4 @@ export {
   sessionHoverFacts,
   sessionHoverDescription
 };
-//# sourceMappingURL=chunk-HOJGAJAB.js.map
+//# sourceMappingURL=chunk-4MQLGMV2.js.map

package/dist/{chunk-L7YURQI2.js → chunk-4U4GXWXS.js}

@@ -1,13 +1,13 @@
 "use client";
 import {
   useTimelineSearchReveal
-} from "./chunk-R63QEVPK.js";
+} from "./chunk-SJORXXLV.js";
 import {
   cn
 } from "./chunk-TXS65BB2.js";
 import {
   useOpenGeniText
-} from "./chunk-5JZYPZ72.js";
+} from "./chunk-JFK7NTEA.js";
 
 // src/components/user-message-body.tsx
 import {
@@ -396,4 +396,4 @@ export {
   userMessageLikelyNeedsDisclosure,
   UserMessageBody
 };
-//# sourceMappingURL=chunk-L7YURQI2.js.map
+//# sourceMappingURL=chunk-4U4GXWXS.js.map

package/dist/{chunk-63VGE4OH.js → chunk-5HIOVXOX.js}

@@ -4,10 +4,10 @@ import {
 } from "./chunk-IIFO2H3P.js";
 import {
   t
-} from "./chunk-HPPKLBTJ.js";
+} from "./chunk-TJQDL3JH.js";
 import {
   buildTimeline
-} from "./chunk-5MZTJMZ3.js";
+} from "./chunk-6MRY2RUZ.js";
 import {
   presentFailure
 } from "./chunk-SJGAHTY5.js";
@@ -298,4 +298,4 @@ export {
   sandboxProvisionInFlight,
   eventLabel
 };
-//# sourceMappingURL=chunk-63VGE4OH.js.map
+//# sourceMappingURL=chunk-5HIOVXOX.js.map

package/dist/{chunk-GFUUFM2O.js → chunk-5M23GZA2.js}

@@ -4,7 +4,7 @@ import {
 } from "./chunk-PRJUHXST.js";
 import {
   t
-} from "./chunk-HPPKLBTJ.js";
+} from "./chunk-TJQDL3JH.js";
 import {
   userErrorText
 } from "./chunk-L4OF77LE.js";
@@ -14,7 +14,7 @@ import {
 import {
   invalidateSharedQueries,
   useSharedQuery
-} from "./chunk-JKUICTLM.js";
+} from "./chunk-NLAFNMPK.js";
 import {
   projectPickerRows,
   sortPickerRows
@@ -68,4 +68,4 @@ function useWorkspaceModelCatalog(workspaceId, fundingRevision) {
 export {
   useWorkspaceModelCatalog
 };
-//# sourceMappingURL=chunk-GFUUFM2O.js.map
+//# sourceMappingURL=chunk-5M23GZA2.js.map

package/dist/{chunk-PM3OSANE.js → chunk-5MJHH72T.js}

@@ -93,6 +93,7 @@ function RailTrailingMetadata({
   summary,
   scheduled = false,
   relativeTime,
+  jumpKey,
   creator,
   quickActionSlots = 0
 }) {
@@ -100,7 +101,7 @@ function RailTrailingMetadata({
   const hasRelativeTime = Boolean(relativeTime);
   const hasMonogram = creator ? creatorInitials(creator) !== null : false;
   const waitingFor = summary.kind === "needs_attention" && summary.attentionSince ? formatWaitingSince(summary.attentionSince) : "";
-  if (!scheduled && !hasStatusMarker && !hasRelativeTime && !hasMonogram && !quickActionSlots)
+  if (!scheduled && !hasStatusMarker && !hasRelativeTime && !jumpKey && !hasMonogram && !quickActionSlots)
     return null;
   const items = Children.toArray([
     scheduled ? /* @__PURE__ */ jsx(
@@ -123,7 +124,15 @@ function RailTrailingMetadata({
       "waiting"
     ) : null,
     hasStatusMarker ? /* @__PURE__ */ jsx("span", { className: "flex size-3 items-center justify-center", title: summary.label, children: /* @__PURE__ */ jsx(RailAggregateDot, { summary }) }, "status") : null,
-    hasRelativeTime ? /* @__PURE__ */ jsx(
+    jumpKey ? /* @__PURE__ */ jsx(
+      "kbd",
+      {
+        "data-session-row-jump-key": true,
+        className: "inline-flex h-4.5 min-w-9 shrink-0 items-center justify-center rounded-[4px] border border-border bg-surface-2 px-1 font-sans text-2xs leading-none font-medium whitespace-nowrap text-fg-muted",
+        children: jumpKey
+      },
+      "time"
+    ) : hasRelativeTime ? /* @__PURE__ */ jsx(
       "span",
       {
         className: "min-w-9 shrink-0 whitespace-nowrap text-right text-2xs tabular-nums text-fg",
@@ -165,6 +174,7 @@ function SessionRowContent({
   summary,
   scheduled = false,
   relativeTime,
+  jumpKey,
   creator,
   quickActionSlots = 0
 }) {
@@ -191,6 +201,7 @@ function SessionRowContent({
         summary,
         scheduled,
         relativeTime,
+        jumpKey,
         creator
       }
     )
@@ -203,4 +214,4 @@ export {
   RailTrailingMetadata,
   SessionRowContent
 };
-//# sourceMappingURL=chunk-PM3OSANE.js.map
+//# sourceMappingURL=chunk-5MJHH72T.js.map

package/dist/chunk-5MJHH72T.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/app/components/rail/session-row-content.tsx"],"sourcesContent":["import {\n  CalendarClockIcon,\n  Clock3Icon,\n  HourglassIcon,\n  Loader2Icon,\n  TriangleAlertIcon,\n} from \"lucide-react\";\nimport { Children, isValidElement, useId } from \"react\";\n\nimport { CreatorMonogram } from \"../creator-monogram\";\nimport { type CreatorRef, creatorAnnouncement, creatorInitials } from \"../../lib/creator-initials\";\nimport { formatWaitingSince } from \"../../lib/format\";\nimport { cn } from \"../../lib/utils\";\nimport type { RailAggregateStatus } from \"../../lib/sessions-group\";\n\nexport function ActiveWorkMark({ className }: { className?: string | undefined }) {\n  const maskId = `active-work-${useId().replaceAll(\":\", \"\")}`;\n  return (\n    <svg\n      aria-hidden=\"true\"\n      viewBox=\"0 0 108 108\"\n      className={cn(\"size-2.5 shrink-0 text-session-update\", className)}\n    >\n      <defs>\n        <mask id={maskId} maskUnits=\"userSpaceOnUse\" x=\"0\" y=\"0\" width=\"108\" height=\"108\">\n          <circle cx=\"54\" cy=\"54\" r=\"48\" fill=\"white\" />\n          <g fill=\"none\" stroke=\"black\" strokeWidth=\"21\" strokeLinecap=\"round\">\n            <path d=\"M-8 43 C35 40 71 29 116 16\" />\n            <path d=\"M-8 86 C35 83 71 72 116 59\" />\n          </g>\n        </mask>\n      </defs>\n      <circle cx=\"54\" cy=\"54\" r=\"48\" fill=\"currentColor\" mask={`url(#${maskId})`} />\n      <circle cx=\"54\" cy=\"54\" r=\"48\" fill=\"none\" stroke=\"currentColor\" strokeWidth=\"2.5\" />\n    </svg>\n  );\n}\n\n/** The one descendant-aware status marker shared by rows and section headers. */\nfunction RailAggregateDot({ summary }: { summary: RailAggregateStatus }) {\n  if (summary.kind === \"neutral\") return null;\n  if (summary.kind === \"active\") {\n    return (\n      <Loader2Icon\n        aria-hidden=\"true\"\n        className=\"size-3 shrink-0 animate-spin text-fg-subtle motion-reduce:animate-none\"\n        style={{ animationDuration: \"1.333333s\" }}\n      />\n    );\n  }\n  if (summary.kind === \"queued\") {\n    return <Clock3Icon aria-hidden=\"true\" className=\"size-3 shrink-0 text-fg-subtle\" />;\n  }\n  if (summary.kind === \"waiting\") {\n    // Parked until input or its wake-up time: nothing is executing, so no spinner.\n    return <HourglassIcon aria-hidden=\"true\" className=\"size-3 shrink-0 text-fg-subtle\" />;\n  }\n  if (summary.kind === \"active_work\") {\n    return <ActiveWorkMark />;\n  }\n  if (summary.kind === \"send_failed\") {\n    return (\n      <TriangleAlertIcon aria-hidden=\"true\" className=\"size-3.5 shrink-0 text-status-failed\" />\n    );\n  }\n  const tone =\n    summary.kind === \"needs_attention\"\n      ? \"bg-status-waiting\"\n      : summary.kind === \"failed\"\n        ? \"bg-status-failed\"\n        : \"bg-session-update\";\n  return (\n    <span\n      aria-hidden=\"true\"\n      className={cn(\"relative inline-flex size-2 shrink-0 rounded-full\", tone)}\n    />\n  );\n}\n\n/**\n * The row's announced name.\n *\n * `aria-label` replaces name-from-content, so this string is the whole of what\n * a screen reader hears for the row: the creator chip is `aria-hidden`, and\n * even the sr-only state line inside the link is inert for it. Every fact a\n * sighted user reads off the row belongs here, and in exactly one place.\n */\nexport function sessionRowAccessibleName({\n  title,\n  stateLabel,\n  pinned,\n  statusLabel,\n  spawnedLabel,\n  creator,\n}: {\n  title: string;\n  stateLabel: string;\n  pinned: boolean;\n  statusLabel: string;\n  spawnedLabel?: string | null | undefined;\n  creator?: CreatorRef | null | undefined;\n}): string {\n  const spokenCreator = creatorAnnouncement(creator ?? null);\n  return `Open ${title}. ${stateLabel}${pinned ? \". Pinned\" : \"\"}. ${statusLabel}${\n    spawnedLabel ? `. ${spawnedLabel}` : \"\"\n  }${spokenCreator ? `. Created by ${spokenCreator}` : \"\"}`;\n}\n\nexport function RailTrailingMetadata({\n  summary,\n  scheduled = false,\n  relativeTime,\n  jumpKey,\n  creator,\n  quickActionSlots = 0,\n}: {\n  summary: RailAggregateStatus;\n  scheduled?: boolean | undefined;\n  relativeTime?: string | undefined;\n  /** The key that opens this row (\"⌘3\"), shown in place of the time while ⌘ is held. */\n  jumpKey?: string | undefined;\n  /** Rightmost items replaced in place by the row's desktop quick actions. */\n  quickActionSlots?: number | undefined;\n  /**\n   * Session creator for a top-level row, else null; callers decide which rows\n   * are roots. A chip is its own reason to render this block: a mobile root row\n   * can have no status marker and no time and still name who started it.\n   */\n  creator?: CreatorRef | null | undefined;\n}) {\n  const hasStatusMarker = summary.kind !== \"neutral\";\n  const hasRelativeTime = Boolean(relativeTime);\n  const hasMonogram = creator ? creatorInitials(creator) !== null : false;\n  // How long the longest-waiting session behind a \"needs you\" marker has been\n  // blocked on a human. A collapsed parent with a child parked for ten hours\n  // must say so, not hide it behind a dot.\n  const waitingFor =\n    summary.kind === \"needs_attention\" && summary.attentionSince\n      ? formatWaitingSince(summary.attentionSince)\n      : \"\";\n  if (\n    !scheduled &&\n    !hasStatusMarker &&\n    !hasRelativeTime &&\n    !jumpKey &&\n    !hasMonogram &&\n    !quickActionSlots\n  )\n    return null;\n  const items = Children.toArray([\n    scheduled ? (\n      <CalendarClockIcon\n        key=\"schedule\"\n        aria-label=\"Scheduled task\"\n        className=\"size-3.5 shrink-0 text-fg-subtle\"\n      />\n    ) : null,\n    hasMonogram && creator ? (\n      <CreatorMonogram key=\"creator\" createdBy={creator} showTitle={false} />\n    ) : null,\n    waitingFor ? (\n      <span\n        key=\"waiting\"\n        data-session-row-waiting\n        title={summary.label}\n        className=\"shrink-0 whitespace-nowrap text-2xs tabular-nums text-status-waiting\"\n      >\n        {waitingFor}\n      </span>\n    ) : null,\n    hasStatusMarker ? (\n      <span key=\"status\" className=\"flex size-3 items-center justify-center\" title={summary.label}>\n        <RailAggregateDot summary={summary} />\n      </span>\n    ) : null,\n    jumpKey ? (\n      <kbd\n        key=\"time\"\n        data-session-row-jump-key\n        className=\"inline-flex h-4.5 min-w-9 shrink-0 items-center justify-center rounded-[4px] border border-border bg-surface-2 px-1 font-sans text-2xs leading-none font-medium whitespace-nowrap text-fg-muted\"\n      >\n        {jumpKey}\n      </kbd>\n    ) : hasRelativeTime ? (\n      <span\n        key=\"time\"\n        className=\"min-w-9 shrink-0 whitespace-nowrap text-right text-2xs tabular-nums text-fg\"\n      >\n        {relativeTime}\n      </span>\n    ) : null,\n  ]).filter(isValidElement);\n  if (!quickActionSlots) {\n    return (\n      <span\n        data-session-row-metadata\n        className=\"inline-flex shrink-0 items-center justify-end gap-1\"\n      >\n        {items}\n      </span>\n    );\n  }\n  // Empty rows still reserve their action footprint. Visibility (never display\n  // or padding) swaps the last items, keeping every other box stationary.\n  while (items.length < quickActionSlots) items.unshift(<span key={`empty-${items.length}`} />);\n  return (\n    <span data-session-row-metadata className=\"inline-flex shrink-0 items-center justify-end\">\n      {items.map((item, index) => (\n        <span\n          key={item.key}\n          data-session-row-slot\n          className={cn(\n            \"inline-flex min-w-6 shrink-0 items-center justify-center last:min-w-10\",\n            index >= items.length - quickActionSlots &&\n              \"pointer-fine:group-hover:invisible pointer-fine:group-focus-within:invisible\",\n          )}\n        >\n          {item}\n        </span>\n      ))}\n    </span>\n  );\n}\n\nexport function SessionRowContent({\n  title,\n  stateLabel,\n  depthLabel,\n  descendantLabel,\n  mobile,\n  summary,\n  scheduled = false,\n  relativeTime,\n  jumpKey,\n  creator,\n  quickActionSlots = 0,\n}: {\n  title: string;\n  stateLabel: string;\n  depthLabel?: string | null | undefined;\n  descendantLabel?: string | null | undefined;\n  mobile: boolean;\n  summary: RailAggregateStatus;\n  scheduled?: boolean | undefined;\n  relativeTime?: string | undefined;\n  /** See RailTrailingMetadata. */\n  jumpKey?: string | undefined;\n  quickActionSlots?: number | undefined;\n  /** Session creator for a top-level row, else null. See RailTrailingMetadata. */\n  creator?: CreatorRef | null | undefined;\n}) {\n  return (\n    <>\n      {/* Inert for the row's accessible name, which its `aria-label` owns -\n          including the creator. Kept as-is so this change regresses nothing. */}\n      <span className=\"sr-only\">{stateLabel}. </span>\n      <span className=\"flex min-w-0 flex-1 flex-col leading-tight\">\n        <span data-session-row-title className=\"block min-w-0 overflow-hidden whitespace-nowrap\">\n          {title}\n        </span>\n        {mobile ? (\n          <span\n            data-session-row-state\n            className=\"mt-0.5 truncate text-2xs font-normal text-fg-muted\"\n          >\n            {[stateLabel, depthLabel, descendantLabel, relativeTime].filter(Boolean).join(\" · \")}\n          </span>\n        ) : null}\n      </span>\n      <RailTrailingMetadata\n        quickActionSlots={quickActionSlots}\n        summary={summary}\n        scheduled={scheduled}\n        relativeTime={relativeTime}\n        jumpKey={jumpKey}\n        creator={creator}\n      />\n    </>\n  );\n}\n"],"mappings":"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","names":[]}

package/dist/{chunk-RKB2Z457.js → chunk-5VGJXWQ2.js}

@@ -2,7 +2,7 @@
 import {
   useMutationRunner,
   usePolledValue
-} from "./chunk-NAWXARTY.js";
+} from "./chunk-2KO2G3RI.js";
 import {
   useOpenGeni
 } from "./chunk-TVQCDDSZ.js";
@@ -164,4 +164,4 @@ function useChannels(options = {}) {
 export {
   useChannels
 };
-//# sourceMappingURL=chunk-RKB2Z457.js.map
+//# sourceMappingURL=chunk-5VGJXWQ2.js.map

package/dist/{chunk-6W3LF3DB.js → chunk-5YFY4SFC.js}

@@ -4,16 +4,7 @@ import {
 } from "./chunk-CM7LVUKC.js";
 import {
   useOpenGeniText
-} from "./chunk-5JZYPZ72.js";
-
-// src/components/queue-draft-policy.ts
-function requestQueueDraftEdit(composer, confirmReplacement, editImmediately) {
-  if (composer.hasDraftContent()) {
-    confirmReplacement();
-  } else {
-    editImmediately();
-  }
-}
+} from "./chunk-JFK7NTEA.js";
 
 // src/components/queue-surface-state.tsx
 import { Loader2Icon, RotateCwIcon } from "lucide-react";
@@ -105,9 +96,8 @@ function QueueErrorAlert({
 }
 
 export {
-  requestQueueDraftEdit,
   EmptyQueueStateSurface,
   QueueStoppingStatus,
   QueueErrorAlert
 };
-//# sourceMappingURL=chunk-6W3LF3DB.js.map
+//# sourceMappingURL=chunk-5YFY4SFC.js.map

package/dist/chunk-5YFY4SFC.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/components/queue-surface-state.tsx"],"sourcesContent":["import { Loader2Icon, RotateCwIcon } from \"lucide-react\";\n\nimport type { UseTurnQueueResult } from \"../hooks/use-turn-queue\";\nimport { useErrorMessage } from \"../lib/error-message\";\nimport { useOpenGeniText } from \"../messages/runtime\";\n\ntype QueueStateProps = {\n  queue: UseTurnQueueResult;\n};\n\nexport function EmptyQueueStateSurface({ queue }: QueueStateProps) {\n  const hasError = Boolean(queue.error || queue.mutationError);\n  return (\n    <div\n      className=\"og-root mx-auto mb-2 w-full max-w-3xl shrink-0 px-4 sm:px-6\"\n      data-testid=\"queue-surface\"\n    >\n      <div className=\"overflow-hidden rounded-lg border border-border bg-surface/80 shadow-sm\">\n        {queue.stoppingPreviousAttempt ? (\n          <QueueStoppingStatus queue={queue} dividerAfter={hasError} />\n        ) : null}\n        {hasError ? <QueueErrorAlert queue={queue} /> : null}\n      </div>\n    </div>\n  );\n}\n\nexport function QueueStoppingStatus({\n  queue,\n  dividerAfter = false,\n}: QueueStateProps & { dividerAfter?: boolean }) {\n  const t = useOpenGeniText();\n  return (\n    <div\n      role=\"status\"\n      aria-live=\"polite\"\n      className={`flex min-h-11 items-center gap-2.5 bg-status-waiting/[0.07] px-3 py-2 text-og-control text-fg ${\n        dividerAfter ? \"border-b border-status-waiting/20\" : \"\"\n      }`}\n      data-testid=\"stopping-previous-attempt\"\n    >\n      <Loader2Icon\n        aria-hidden=\"true\"\n        className=\"size-3.5 shrink-0 animate-spin text-status-waiting motion-reduce:animate-none\"\n      />\n      <span className=\"min-w-0\">\n        <span className=\"font-medium\">\n          {queue.effectiveControl?.state === \"paused\"\n            ? t(\"queueSurfaceState.stoppingCurrentAttempt\")\n            : t(\"queueSurfaceState.stoppingPreviousAttempt\")}\n        </span>{\" \"}\n        <span className=\"text-fg-muted\">\n          {queue.effectiveControl?.state === \"paused\"\n            ? t(\"queueSurfaceState.queuedWorkStaysSavedUntil\")\n            : t(\"queueSurfaceState.queuedWorkIsSavedAnd\")}\n        </span>\n      </span>\n    </div>\n  );\n}\n\nexport function QueueErrorAlert({\n  queue,\n  dividerBefore = false,\n}: QueueStateProps & { dividerBefore?: boolean }) {\n  const t = useOpenGeniText();\n  const formatError = useErrorMessage();\n  return (\n    <div className={`${dividerBefore ? \"border-t border-border\" : \"\"} p-2`}>\n      <div\n        role=\"alert\"\n        className=\"flex min-w-0 max-w-full flex-wrap items-start gap-2 rounded-md bg-status-failed/10 px-2 py-1.5 text-og-control text-status-failed\"\n      >\n        <span\n          role=\"region\"\n          aria-label={t(\"queueSurfaceState.queueErrorDetails\")}\n          tabIndex={0}\n          className=\"max-h-[min(5rem,20dvh)] min-w-0 max-w-full flex-[1_1_5rem] overflow-auto overscroll-contain whitespace-pre-wrap rounded-sm outline-hidden [overflow-wrap:anywhere] [unicode-bidi:plaintext] focus-visible:ring-2 focus-visible:ring-ring/40\"\n          data-testid=\"queue-error-message\"\n          dir=\"auto\"\n        >\n          {formatError(queue.mutationError ?? queue.error)}\n        </span>\n        <button\n          type=\"button\"\n          onClick={() => {\n            queue.clearMutationError();\n            void queue.refresh();\n          }}\n          aria-label={t(\"queueSurfaceState.dismissQueueErrorAndRetry\")}\n          title={t(\"queueSurfaceState.retryLoadingTheQueue\")}\n          className=\"ms-auto inline-flex size-7 shrink-0 items-center justify-center self-start rounded-md outline-hidden transition-colors hover:bg-surface-3 focus-visible:ring-2 focus-visible:ring-ring/40 motion-reduce:transition-none pointer-coarse:size-[44px]\"\n        >\n          <RotateCwIcon className=\"size-3.5\" />\n        </button>\n      </div>\n    </div>\n  );\n}\n"],"mappings":";;;;;;;;;AAAA,SAAS,aAAa,oBAAoB;AAiBpC,SAEI,KAFJ;AAPC,SAAS,uBAAuB,EAAE,MAAM,GAAoB;AACjE,QAAM,WAAW,QAAQ,MAAM,SAAS,MAAM,aAAa;AAC3D,SACE;AAAA,IAAC;AAAA;AAAA,MACC,WAAU;AAAA,MACV,eAAY;AAAA,MAEZ,+BAAC,SAAI,WAAU,2EACZ;AAAA,cAAM,0BACL,oBAAC,uBAAoB,OAAc,cAAc,UAAU,IACzD;AAAA,QACH,WAAW,oBAAC,mBAAgB,OAAc,IAAK;AAAA,SAClD;AAAA;AAAA,EACF;AAEJ;AAEO,SAAS,oBAAoB;AAAA,EAClC;AAAA,EACA,eAAe;AACjB,GAAiD;AAC/C,QAAM,IAAI,gBAAgB;AAC1B,SACE;AAAA,IAAC;AAAA;AAAA,MACC,MAAK;AAAA,MACL,aAAU;AAAA,MACV,WAAW,iGACT,eAAe,sCAAsC,EACvD;AAAA,MACA,eAAY;AAAA,MAEZ;AAAA;AAAA,UAAC;AAAA;AAAA,YACC,eAAY;AAAA,YACZ,WAAU;AAAA;AAAA,QACZ;AAAA,QACA,qBAAC,UAAK,WAAU,WACd;AAAA,8BAAC,UAAK,WAAU,eACb,gBAAM,kBAAkB,UAAU,WAC/B,EAAE,0CAA0C,IAC5C,EAAE,2CAA2C,GACnD;AAAA,UAAQ;AAAA,UACR,oBAAC,UAAK,WAAU,iBACb,gBAAM,kBAAkB,UAAU,WAC/B,EAAE,6CAA6C,IAC/C,EAAE,wCAAwC,GAChD;AAAA,WACF;AAAA;AAAA;AAAA,EACF;AAEJ;AAEO,SAAS,gBAAgB;AAAA,EAC9B;AAAA,EACA,gBAAgB;AAClB,GAAkD;AAChD,QAAM,IAAI,gBAAgB;AAC1B,QAAM,cAAc,gBAAgB;AACpC,SACE,oBAAC,SAAI,WAAW,GAAG,gBAAgB,2BAA2B,EAAE,QAC9D;AAAA,IAAC;AAAA;AAAA,MACC,MAAK;AAAA,MACL,WAAU;AAAA,MAEV;AAAA;AAAA,UAAC;AAAA;AAAA,YACC,MAAK;AAAA,YACL,cAAY,EAAE,qCAAqC;AAAA,YACnD,UAAU;AAAA,YACV,WAAU;AAAA,YACV,eAAY;AAAA,YACZ,KAAI;AAAA,YAEH,sBAAY,MAAM,iBAAiB,MAAM,KAAK;AAAA;AAAA,QACjD;AAAA,QACA;AAAA,UAAC;AAAA;AAAA,YACC,MAAK;AAAA,YACL,SAAS,MAAM;AACb,oBAAM,mBAAmB;AACzB,mBAAK,MAAM,QAAQ;AAAA,YACrB;AAAA,YACA,cAAY,EAAE,6CAA6C;AAAA,YAC3D,OAAO,EAAE,wCAAwC;AAAA,YACjD,WAAU;AAAA,YAEV,8BAAC,gBAAa,WAAU,YAAW;AAAA;AAAA,QACrC;AAAA;AAAA;AAAA,EACF,GACF;AAEJ;","names":[]}

package/dist/{chunk-I6VUUEXH.js → chunk-6AFSZKZA.js}

@@ -1,10 +1,10 @@
 "use client";
 import {
   formatElapsed
-} from "./chunk-TQGJN5UZ.js";
+} from "./chunk-AW3QEFOF.js";
 import {
   timelineGroupContainsPresentedImage
-} from "./chunk-ANHUMDJX.js";
+} from "./chunk-WNDTLK44.js";
 import {
   formatClockTime
 } from "./chunk-SJGAHTY5.js";
@@ -410,4 +410,4 @@ export {
   timelineGroupSequences,
   timelineGroupIndexAtSequence
 };
-//# sourceMappingURL=chunk-I6VUUEXH.js.map
+//# sourceMappingURL=chunk-6AFSZKZA.js.map

package/dist/{chunk-FBMU3VK5.js → chunk-6DCEDIF6.js}

@@ -1,7 +1,7 @@
 "use client";
 import {
   workspaceSessionPath
-} from "./chunk-WRLWLGEF.js";
+} from "./chunk-Y5E3XQ2S.js";
 
 // src/app/lib/session-deep-link.tsx
 var SESSION_ID_PATTERN = /^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$/i;
@@ -71,4 +71,4 @@ export {
   canonicalSessionDeepLinkTarget,
   shouldRedirectSessionDeepLink
 };
-//# sourceMappingURL=chunk-FBMU3VK5.js.map
+//# sourceMappingURL=chunk-6DCEDIF6.js.map

package/dist/{chunk-5MZTJMZ3.js → chunk-6MRY2RUZ.js}

@@ -1,8 +1,11 @@
 "use client";
+import {
+  invokedTool
+} from "./chunk-ULYQEFNH.js";
 import {
   mcpToolLeaf,
   toolMatchesLeaf
-} from "./chunk-STUCI6QA.js";
+} from "./chunk-LEKBNKLD.js";
 import {
   CREDIT_EXHAUSTION_MESSAGE,
   isCreditExhaustion,
@@ -1058,18 +1061,21 @@ function buildTimeline(t, events, options = {}) {
         if (callId && humanInputToolCallIds.has(callId)) {
           break;
         }
-        if (toolMatchesLeaf(name, WORKER_SPAWN_TOOL) || toolMatchesLeaf(name, WORKER_MESSAGE_TOOL)) {
-          const spawn = toolMatchesLeaf(name, WORKER_SPAWN_TOOL);
-          const title = spawn ? workerTitle(args) : null;
+        const invoked = invokedTool(name, args);
+        const workerName = invoked?.name ?? name;
+        const workerArgs = invoked ? invoked.arguments : args;
+        if (toolMatchesLeaf(workerName, WORKER_SPAWN_TOOL) || toolMatchesLeaf(workerName, WORKER_MESSAGE_TOOL)) {
+          const spawn = toolMatchesLeaf(workerName, WORKER_SPAWN_TOOL);
+          const title = spawn ? workerTitle(workerArgs) : null;
           const item2 = {
             kind: "worker",
             id: event.id,
             turnId,
             callId,
             action: spawn ? "spawn" : "message",
-            prompt: workerPrompt(args),
+            prompt: workerPrompt(workerArgs),
             ...title ? { title } : {},
-            workerSessionId: extractSessionRef(args),
+            workerSessionId: extractSessionRef(workerArgs),
             failure: null,
             status: "running",
             occurredAt: event.occurredAt
@@ -3444,4 +3450,4 @@ export {
   isTurnExecutionEvidence,
   extractSessionRef
 };
-//# sourceMappingURL=chunk-5MZTJMZ3.js.map
+//# sourceMappingURL=chunk-6MRY2RUZ.js.map