@flanksource/clicky-ui 0.3.46 → 0.3.47

package/dist/data/ai/SessionInspector.remote.cjs

@@ -13,12 +13,15 @@ const TERMINAL_SESSION_LIFECYCLES = [
 function isTerminalSessionLifecycle(status) {
   return status !== void 0 && TERMINAL_SESSION_LIFECYCLES.includes(status);
 }
-function sessionFollowUrl(src) {
+const DEFAULT_SESSION_PAGE_SIZE = 100;
+function sessionUrl(src, params) {
   const hashAt = src.indexOf("#");
   const base = hashAt === -1 ? src : src.slice(0, hashAt);
   const hash = hashAt === -1 ? "" : src.slice(hashAt);
-  const separator = !base.includes("?") ? "?" : base.endsWith("?") || base.endsWith("&") ? "" : "&";
-  return `${base}${separator}follow=1${hash}`;
+  const queryAt = base.indexOf("?");
+  const query = new URLSearchParams(queryAt === -1 ? "" : base.slice(queryAt + 1));
+  for (const [name, value] of Object.entries(params)) query.set(name, String(value));
+  return `${queryAt === -1 ? base : base.slice(0, queryAt)}?${query}${hash}`;
 }
 async function fetchRemoteSession(src, signal) {
   const response = await fetch(src, {
@@ -47,7 +50,8 @@ async function fetchRemoteSession(src, signal) {
   return parsed;
 }
 function mergeSessionMessages(base, incoming) {
-  const merged = [...base ?? []];
+  const real = incoming.some((message) => !message.placeholder);
+  const merged = (base ?? []).filter((message) => !(real && message.placeholder));
   for (const message of incoming) {
     const index = merged.findIndex((existing) => existing.id === message.id);
     if (index === -1) merged.push(message);
@@ -57,10 +61,13 @@ function mergeSessionMessages(base, incoming) {
 }
 function openRemoteSession(src, {
   follow,
+  pageSize = DEFAULT_SESSION_PAGE_SIZE,
   eventSourceFactory,
   onChange
 }) {
-  const url = sessionFollowUrl(src);
+  let url = sessionUrl(src, { follow: 1 });
+  let olderPage;
+  let pageError;
   const aborter = new AbortController();
   const streamed = /* @__PURE__ */ new Map();
   let closed = false;
@@ -84,23 +91,51 @@ function openRemoteSession(src, {
     emit({ ...state, loading: false, error: message });
   };
   const refresh = async () => {
-    var _a;
+    var _a, _b, _c, _d;
     const current = ++generation;
     const startedAt = seq;
-    const fetched = await fetchRemoteSession(src, aborter.signal);
+    const fetched = await fetchRemoteSession(sessionUrl(src, { tail: pageSize }), aborter.signal);
     if (closed || current !== generation) return void 0;
     const fetchedIds = new Set((_a = fetched.messages) == null ? void 0 : _a.map((message) => message.id));
     const keep = [...streamed.values()].filter((entry) => entry.seq > startedAt || !fetchedIds.has(entry.message.id)).map((entry) => entry.message);
+    const held = mergeSessionMessages((_b = state.session) == null ? void 0 : _b.messages, fetched.messages ?? []);
     const session = {
       ...fetched,
-      messages: mergeSessionMessages(fetched.messages, keep)
+      messages: mergeSessionMessages(held, keep)
     };
     if (typeof fetched.revision === "number") {
       revision = Math.max(revision ?? fetched.revision, fetched.revision);
     }
-    emit({ ...state, session, loading: false });
+    const hasOlder = state.session === void 0 ? (((_c = fetched.window) == null ? void 0 : _c.messages) ?? 0) > (((_d = fetched.messages) == null ? void 0 : _d.length) ?? 0) : state.hasOlder;
+    emit({ ...state, session, loading: false, hasOlder: hasOlder ?? false });
     return session;
   };
+  const loadOlder = () => {
+    var _a, _b, _c;
+    const oldest = (_c = (_b = (_a = state.session) == null ? void 0 : _a.messages) == null ? void 0 : _b[0]) == null ? void 0 : _c.id;
+    if (closed || olderPage || !state.hasOlder || !oldest) return olderPage ?? Promise.resolve();
+    emit({ ...state, loadingOlder: true });
+    olderPage = fetchRemoteSession(sessionUrl(src, { before: oldest, limit: pageSize }), aborter.signal).then((page) => {
+      const older = page.messages ?? [];
+      const { error, ...rest } = state;
+      const session = state.session;
+      emit({
+        ...rest,
+        ...error !== void 0 && error !== pageError ? { error } : {},
+        loadingOlder: false,
+        hasOlder: older.length === pageSize,
+        session: { ...session, messages: mergeSessionMessages(older, session.messages ?? []) }
+      });
+      pageError = void 0;
+    }).catch((reason) => {
+      if (closed) return;
+      pageError = errorMessage(reason);
+      emit({ ...state, loadingOlder: false, error: pageError });
+    }).finally(() => {
+      olderPage = void 0;
+    });
+    return olderPage;
+  };
   const readFrame = (event) => {
     try {
       return JSON.parse(event.data);
@@ -152,6 +187,9 @@ function openRemoteSession(src, {
     if (isTerminalSessionLifecycle(next.lifecycleStatus)) stopFollowing();
   };
   const startFollowing = () => {
+    var _a, _b, _c;
+    const newest = (_c = (_b = (_a = state.session) == null ? void 0 : _a.messages) == null ? void 0 : _b.filter((message) => !message.placeholder).at(-1)) == null ? void 0 : _c.id;
+    url = sessionUrl(src, newest ? { follow: 1, after: newest } : { follow: 1 });
     const es = eventSourceFactory(url);
     source = es;
     let received = false;
@@ -194,6 +232,7 @@ function openRemoteSession(src, {
   );
   return {
     loaded,
+    loadOlder,
     close: () => {
       closed = true;
       aborter.abort();
@@ -203,24 +242,51 @@ function openRemoteSession(src, {
 }
 const IDLE = { loading: false };
 const LOADING = { loading: true };
-function useRemoteSession(src, { follow } = {}) {
+function useRemoteSession(src, { follow, pageSize } = {}) {
   const eventSourceFactory = eventSource.useEventSourceFactory();
   const factoryRef = react.useRef(eventSourceFactory);
   factoryRef.current = eventSourceFactory;
+  const handleRef = react.useRef(void 0);
   const [snapshot, setSnapshot] = react.useState();
   react.useEffect(() => {
     if (src === void 0) return void 0;
     setSnapshot({ src, state: LOADING });
     const handle = openRemoteSession(src, {
       ...follow === void 0 ? {} : { follow },
+      ...pageSize === void 0 ? {} : { pageSize },
       eventSourceFactory: factoryRef.current,
-      onChange: (state) => setSnapshot({ src, state })
+      onChange: (state2) => setSnapshot({ src, state: state2 })
     });
+    handleRef.current = handle;
     handle.loaded.catch(() => void 0);
-    return handle.close;
-  }, [src, follow]);
-  if (src === void 0) return IDLE;
-  return (snapshot == null ? void 0 : snapshot.src) === src ? snapshot.state : LOADING;
+    return () => {
+      handle.close();
+      if (handleRef.current === handle) handleRef.current = void 0;
+    };
+  }, [src, follow, pageSize]);
+  const loadOlder = react.useCallback(() => {
+    var _a;
+    return ((_a = handleRef.current) == null ? void 0 : _a.loadOlder()) ?? Promise.resolve();
+  }, []);
+  const state = src === void 0 ? IDLE : (snapshot == null ? void 0 : snapshot.src) === src ? snapshot.state : LOADING;
+  return react.useMemo(() => ({ ...state, loadOlder }), [state, loadOlder]);
+}
+function useReportLoadState({
+  state,
+  enabled,
+  onChange
+}) {
+  const onChangeRef = react.useRef(onChange);
+  onChangeRef.current = onChange;
+  const { loading, error } = state;
+  react.useEffect(() => {
+    var _a;
+    if (!enabled) return;
+    (_a = onChangeRef.current) == null ? void 0 : _a.call(
+      onChangeRef,
+      error !== void 0 ? { status: "error", error: new Error(error) } : { status: loading ? "loading" : "ready" }
+    );
+  }, [enabled, loading, error]);
 }
 function useRemoteCollection(collection, options = {}) {
   const current = collection == null ? void 0 : collection.sessions.find(
@@ -264,12 +330,14 @@ function errorMessage(reason) {
 function isRecord(value) {
   return typeof value === "object" && value !== null && !Array.isArray(value);
 }
+exports.DEFAULT_SESSION_PAGE_SIZE = DEFAULT_SESSION_PAGE_SIZE;
 exports.TERMINAL_SESSION_LIFECYCLES = TERMINAL_SESSION_LIFECYCLES;
 exports.fetchRemoteSession = fetchRemoteSession;
 exports.isTerminalSessionLifecycle = isTerminalSessionLifecycle;
 exports.mergeSessionMessages = mergeSessionMessages;
 exports.openRemoteSession = openRemoteSession;
-exports.sessionFollowUrl = sessionFollowUrl;
+exports.sessionUrl = sessionUrl;
 exports.useRemoteCollection = useRemoteCollection;
 exports.useRemoteSession = useRemoteSession;
+exports.useReportLoadState = useReportLoadState;
 //# sourceMappingURL=SessionInspector.remote.cjs.map

package/dist/data/ai/SessionInspector.remote.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"SessionInspector.remote.cjs","sources":["../../../src/data/ai/SessionInspector.remote.ts"],"sourcesContent":["import { useEffect, useMemo, useRef, useState } from \"react\";\nimport {\n  useEventSourceFactory,\n  type EventSourceFactory,\n  type EventSourceLike,\n} from \"../../hooks/event-source\";\nimport type { SessionCollectionInput } from \"./SessionInspector.collection-types\";\nimport type {\n  SessionUIMessage,\n  UnifiedSessionInput,\n} from \"./SessionViewer.unified\";\n\n// SessionInspector.remote loads a session from a URL and follows it live.\n// The contract (captain `SessionHandler`):\n//   GET {src}  Accept: application/json → one UnifiedSessionInput; a non-2xx\n//              body is `{error, …}` JSON or plain text, surfaced verbatim.\n//   GET {src}?follow=1 (SSE) → `entry` frames (one SessionUIMessage, upserted\n//              by id), `state` frames ({revision, lifecycleStatus,\n//              activityState, facets}), `error` frames ({error}) and `: ping`\n//              comments. The server closes the stream once the session is\n//              terminal.\n// A `state` frame with a higher revision means aggregate facets (plan,\n// approvals, files, …) changed, so the aggregate is refetched; entries\n// streamed while it was in flight stay merged on top. `facets` is an opaque\n// fingerprint of the non-message session facets (plan, todos, files, approval\n// requests): the first frame's value is the baseline (no refetch from it\n// alone), and any later frame whose `facets` differs from the last one seen\n// also triggers a refetch, independently of `revision`.\n\nexport const TERMINAL_SESSION_LIFECYCLES = [\n  \"succeeded\",\n  \"partial\",\n  \"failed\",\n  \"cancelled\",\n  \"interrupted\",\n  \"completed\",\n] as const;\n\nexport function isTerminalSessionLifecycle(status: string | undefined) {\n  return (\n    status !== undefined &&\n    (TERMINAL_SESSION_LIFECYCLES as readonly string[]).includes(status)\n  );\n}\n\nexport interface RemoteSessionOptions {\n  /** Force (`true`) or suppress (`false`) the live stream. By default a\n   *  session follows only while it reports a non-terminal `lifecycleStatus`;\n   *  a session that reports none is not followed. */\n  follow?: boolean;\n}\n\nexport interface RemoteSessionState {\n  session?: UnifiedSessionInput;\n  error?: string;\n  loading: boolean;\n}\n\n/** The payload of a follow stream's `state` frame. */\nexport interface SessionFollowState {\n  revision: number;\n  lifecycleStatus: string;\n  activityState: string;\n  /** Opaque fingerprint of non-message session facets (plan, todos, files,\n   *  approval requests). Always sent by captain — see the module doc above\n   *  for how it's used to decide whether to refetch. */\n  facets: string;\n}\n\nexport interface RemoteSessionHandle {\n  /** Settles with the first fetched session, or rejects with the load error\n   *  (which `onChange` has already reported as `error`). */\n  loaded: Promise<UnifiedSessionInput>;\n  close: () => void;\n}\n\n/** `src` with `follow=1` appended to its query, keeping any fragment last. */\nexport function sessionFollowUrl(src: string) {\n  const hashAt = src.indexOf(\"#\");\n  const base = hashAt === -1 ? src : src.slice(0, hashAt);\n  const hash = hashAt === -1 ? \"\" : src.slice(hashAt);\n  const separator = !base.includes(\"?\")\n    ? \"?\"\n    : base.endsWith(\"?\") || base.endsWith(\"&\")\n      ? \"\"\n      : \"&\";\n  return `${base}${separator}follow=1${hash}`;\n}\n\nexport async function fetchRemoteSession(\n  src: string,\n  signal?: AbortSignal,\n): Promise<UnifiedSessionInput> {\n  const response = await fetch(src, {\n    headers: { Accept: \"application/json\" },\n    ...(signal ? { signal } : {}),\n  });\n  const body = await response.text();\n  if (!response.ok) {\n    throw new Error(\n      `Failed to load session ${src} (HTTP ${response.status}): ${errorDetail(body)}`,\n    );\n  }\n  let parsed: unknown;\n  try {\n    parsed = JSON.parse(body);\n  } catch (cause) {\n    throw new Error(\n      `Session ${src} returned invalid JSON (${String(cause)}): ${body.slice(0, 200)}`,\n    );\n  }\n  if (!isRecord(parsed)) {\n    throw new Error(\n      `Session ${src} returned ${Array.isArray(parsed) ? \"an array\" : String(parsed)}, expected a session object`,\n    );\n  }\n  return parsed as UnifiedSessionInput;\n}\n\n/** Upserts messages by id: a known id is replaced in place, a new one appended. */\nexport function mergeSessionMessages(\n  base: readonly SessionUIMessage[] | undefined,\n  incoming: readonly SessionUIMessage[],\n): SessionUIMessage[] {\n  const merged = [...(base ?? [])];\n  for (const message of incoming) {\n    const index = merged.findIndex((existing) => existing.id === message.id);\n    if (index === -1) merged.push(message);\n    else merged[index] = message;\n  }\n  return merged;\n}\n\n/** Fetches `src`, then follows it when wanted, reporting every change through\n *  `onChange`. Nothing is reported after `close()`. */\nexport function openRemoteSession(\n  src: string,\n  {\n    follow,\n    eventSourceFactory,\n    onChange,\n  }: RemoteSessionOptions & {\n    eventSourceFactory: EventSourceFactory;\n    onChange: (state: RemoteSessionState) => void;\n  },\n): RemoteSessionHandle {\n  const url = sessionFollowUrl(src);\n  const aborter = new AbortController();\n  const streamed = new Map<string, { message: SessionUIMessage; seq: number }>();\n  let closed = false;\n  let source: EventSourceLike | undefined;\n  let state: RemoteSessionState = { loading: true };\n  let revision: number | undefined;\n  let facets: string | undefined;\n  let seq = 0;\n  let generation = 0;\n\n  const emit = (next: RemoteSessionState) => {\n    if (closed) return;\n    state = next;\n    onChange(next);\n  };\n  const stopFollowing = () => {\n    source?.close();\n    source = undefined;\n  };\n  const fail = (message: string) => {\n    stopFollowing();\n    emit({ ...state, loading: false, error: message });\n  };\n\n  const refresh = async () => {\n    const current = ++generation;\n    const startedAt = seq;\n    const fetched = await fetchRemoteSession(src, aborter.signal);\n    if (closed || current !== generation) return undefined;\n    const fetchedIds = new Set(fetched.messages?.map((message) => message.id));\n    const keep = [...streamed.values()]\n      .filter((entry) => entry.seq > startedAt || !fetchedIds.has(entry.message.id))\n      .map((entry) => entry.message);\n    const session = {\n      ...fetched,\n      messages: mergeSessionMessages(fetched.messages, keep),\n    };\n    if (typeof fetched.revision === \"number\") {\n      revision = Math.max(revision ?? fetched.revision, fetched.revision);\n    }\n    emit({ ...state, session, loading: false });\n    return session;\n  };\n\n  const readFrame = (event: Event): unknown => {\n    try {\n      return JSON.parse((event as MessageEvent).data as string);\n    } catch (cause) {\n      fail(`Unparseable ${event.type} frame from ${url}: ${String(cause)}`);\n      return undefined;\n    }\n  };\n\n  const onEntry = (event: Event) => {\n    const message = readFrame(event);\n    if (message === undefined) return;\n    if (!isRecord(message) || typeof message.id !== \"string\" || !message.id) {\n      fail(`Entry frame from ${url} has no message id: ${String((event as MessageEvent).data)}`);\n      return;\n    }\n    const entry = message as unknown as SessionUIMessage;\n    streamed.set(message.id, { message: entry, seq: ++seq });\n    const session = state.session!;\n    emit({\n      ...state,\n      session: { ...session, messages: mergeSessionMessages(session.messages, [entry]) },\n    });\n  };\n\n  const onState = (event: Event) => {\n    const frame = readFrame(event);\n    if (frame === undefined) return;\n    if (\n      !isRecord(frame) ||\n      typeof frame.revision !== \"number\" ||\n      typeof frame.lifecycleStatus !== \"string\" ||\n      typeof frame.facets !== \"string\"\n    ) {\n      fail(`State frame from ${url} lacks a numeric revision, a lifecycleStatus, and facets: ${String((event as MessageEvent).data)}`);\n      return;\n    }\n    const next = frame as unknown as SessionFollowState;\n    emit({\n      ...state,\n      session: {\n        ...state.session,\n        lifecycleStatus: next.lifecycleStatus,\n        ...(typeof next.activityState === \"string\" ? { activityState: next.activityState } : {}),\n      },\n    });\n    const revisionIncreased = revision === undefined || next.revision > revision;\n    // The first state frame's facets is the baseline: it never triggers a\n    // refetch by itself, only a higher revision does (as before facets\n    // existed). Any later frame whose facets differ from the last one seen\n    // does trigger a refetch, independently of revision.\n    const facetsChanged = facets !== undefined && next.facets !== facets;\n    facets = next.facets;\n    if (revisionIncreased) revision = next.revision;\n    if (revisionIncreased || facetsChanged) {\n      refresh().catch((reason: unknown) => {\n        if (!closed) fail(errorMessage(reason));\n      });\n    }\n    if (isTerminalSessionLifecycle(next.lifecycleStatus)) stopFollowing();\n  };\n\n  const startFollowing = () => {\n    const es = eventSourceFactory(url);\n    source = es;\n    let received = false;\n    const onError = (event: Event) => {\n      const data = (event as MessageEvent).data;\n      if (typeof data === \"string\") {\n        const frame = readFrame(event);\n        if (frame === undefined) return;\n        const reported = isRecord(frame) && typeof frame.error === \"string\" ? frame.error : data;\n        fail(`Session stream ${url} reported an error: ${reported}`);\n        return;\n      }\n      // After data has arrived, a dropped connection reconnects on its own and\n      // the server replays; entries upsert by id, so the replay is idempotent.\n      if (received && es.readyState !== 2) return;\n      fail(\n        received\n          ? `Lost the session stream ${url}`\n          : `Could not connect to the session stream ${url}`,\n      );\n    };\n    es.addEventListener(\"entry\", (event) => {\n      received = true;\n      onEntry(event);\n    });\n    es.addEventListener(\"state\", (event) => {\n      received = true;\n      onState(event);\n    });\n    es.addEventListener(\"error\", onError);\n  };\n\n  const loaded = refresh().then(\n    (session) => {\n      if (!session) throw new Error(`Session ${src} was closed before it loaded`);\n      const lifecycle = session.lifecycleStatus;\n      const wanted =\n        follow ?? (lifecycle !== undefined && !isTerminalSessionLifecycle(lifecycle));\n      if (wanted && !closed) startFollowing();\n      return session;\n    },\n    (reason: unknown) => {\n      if (!closed) fail(errorMessage(reason));\n      throw reason;\n    },\n  );\n\n  return {\n    loaded,\n    close: () => {\n      closed = true;\n      aborter.abort();\n      stopFollowing();\n    },\n  };\n}\n\nconst IDLE: RemoteSessionState = { loading: false };\nconst LOADING: RemoteSessionState = { loading: true };\n\n/** Loads `src` (undefined loads nothing) and follows it on demand; see\n *  `RemoteSessionOptions.follow`. Changing `src` or `follow`, or unmounting,\n *  closes the previous stream. */\nexport function useRemoteSession(\n  src: string | undefined,\n  { follow }: RemoteSessionOptions = {},\n): RemoteSessionState {\n  const eventSourceFactory = useEventSourceFactory();\n  const factoryRef = useRef(eventSourceFactory);\n  factoryRef.current = eventSourceFactory;\n  const [snapshot, setSnapshot] = useState<{\n    src: string;\n    state: RemoteSessionState;\n  }>();\n\n  useEffect(() => {\n    if (src === undefined) return undefined;\n    setSnapshot({ src, state: LOADING });\n    const handle = openRemoteSession(src, {\n      ...(follow === undefined ? {} : { follow }),\n      eventSourceFactory: factoryRef.current,\n      onChange: (state) => setSnapshot({ src, state }),\n    });\n    // A load failure already reached the state through onChange as `error`.\n    handle.loaded.catch(() => undefined);\n    return handle.close;\n  }, [src, follow]);\n\n  if (src === undefined) return IDLE;\n  return snapshot?.src === src ? snapshot.state : LOADING;\n}\n\nexport interface RemoteCollectionState {\n  /** The collection with its current item's session loaded, once it is. */\n  collection?: SessionCollectionInput;\n  error?: string;\n  loading: boolean;\n}\n\n/** Loads the current item of a collection when it carries only `src`, so the\n *  hierarchy (which requires a loaded current session) can render. */\nexport function useRemoteCollection(\n  collection: SessionCollectionInput | undefined,\n  options: RemoteSessionOptions = {},\n): RemoteCollectionState {\n  const current = collection?.sessions.find(\n    (item) => item.id === collection.currentSessionId,\n  );\n  const src = current && !current.session ? current.src : undefined;\n  const remote = useRemoteSession(src, options);\n  return useMemo(() => {\n    if (!collection) return IDLE;\n    if (src === undefined || !current) return { collection, loading: false };\n    const status = {\n      loading: remote.loading,\n      ...(remote.error ? { error: remote.error } : {}),\n    };\n    if (!remote.session) return status;\n    const session = remote.session;\n    return {\n      ...status,\n      collection: {\n        ...collection,\n        sessions: collection.sessions.map((item) =>\n          item === current ? { ...item, session } : item,\n        ),\n      },\n    };\n  }, [collection, current, src, remote]);\n}\n\nfunction errorDetail(body: string) {\n  const text = body.trim();\n  if (!text) return \"empty response body\";\n  try {\n    const parsed: unknown = JSON.parse(text);\n    if (isRecord(parsed) && typeof parsed.error === \"string\") return parsed.error;\n  } catch {\n    // Not JSON: the text itself is the detail.\n  }\n  return text;\n}\n\nfunction errorMessage(reason: unknown) {\n  return reason instanceof Error ? reason.message : String(reason);\n}\n\nfunction isRecord(value: unknown): value is Record<string, unknown> {\n  return typeof value === \"object\" && value !== null && !Array.isArray(value);\n}\n"],"names":["useEventSourceFactory","useRef","useState","useEffect","useMemo"],"mappings":"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"}
+{"version":3,"file":"SessionInspector.remote.cjs","sources":["../../../src/data/ai/SessionInspector.remote.ts"],"sourcesContent":["import { useCallback, useEffect, useMemo, useRef, useState } from \"react\";\nimport {\n  useEventSourceFactory,\n  type EventSourceFactory,\n  type EventSourceLike,\n} from \"../../hooks/event-source\";\nimport type { SessionCollectionInput } from \"./SessionInspector.collection-types\";\nimport type {\n  SessionUIMessage,\n  UnifiedSessionInput,\n} from \"./SessionViewer.unified\";\n\n// SessionInspector.remote loads a session from a URL and follows it live,\n// asking only for the transcript's tail. The contract (captain\n// `SessionHandler`):\n//   GET {src}?tail=N  Accept: application/json → one UnifiedSessionInput with\n//              the newest N messages, and `window` (the full counts) when older\n//              ones were left out; a non-2xx body is `{error, …}` JSON or plain\n//              text, surfaced verbatim.\n//   GET {src}?before=<id>&limit=N → the N messages ahead of <id>: one page of\n//              history, loaded on demand (`loadOlder`) and prepended.\n//   GET {src}?follow=1&after=<id> (SSE) → `entry` frames for the messages\n//              after <id> and every later change (one SessionUIMessage, upserted\n//              by id), `state` frames ({revision, lifecycleStatus,\n//              activityState, facets}), `error` frames ({error}) and `: ping`\n//              comments. The server closes the stream once the session is\n//              terminal.\n// A `state` frame with a higher revision means aggregate facets (plan,\n// approvals, files, …) changed, so the tail is refetched and merged into the\n// messages already held; entries streamed while it was in flight stay merged\n// on top. `facets` is an opaque\n// fingerprint of the non-message session facets (plan, todos, files, approval\n// requests): the first frame's value is the baseline (no refetch from it\n// alone), and any later frame whose `facets` differs from the last one seen\n// also triggers a refetch, independently of `revision`.\n\nexport const TERMINAL_SESSION_LIFECYCLES = [\n  \"succeeded\",\n  \"partial\",\n  \"failed\",\n  \"cancelled\",\n  \"interrupted\",\n  \"completed\",\n] as const;\n\nexport function isTerminalSessionLifecycle(status: string | undefined) {\n  return (\n    status !== undefined &&\n    (TERMINAL_SESSION_LIFECYCLES as readonly string[]).includes(status)\n  );\n}\n\n/** Messages asked for by the first read and by each page of history. */\nexport const DEFAULT_SESSION_PAGE_SIZE = 100;\n\nexport interface RemoteSessionOptions {\n  /** Force (`true`) or suppress (`false`) the live stream. By default a\n   *  session follows only while it reports a non-terminal `lifecycleStatus`;\n   *  a session that reports none is not followed. */\n  follow?: boolean;\n  /** Messages per read: the first read's `tail` and each history page's\n   *  `limit`. Defaults to DEFAULT_SESSION_PAGE_SIZE. */\n  pageSize?: number;\n}\n\nexport interface RemoteSessionState {\n  session?: UnifiedSessionInput;\n  error?: string;\n  loading: boolean;\n  /** Older messages exist that `loadOlder` has not fetched yet. */\n  hasOlder?: boolean;\n  /** A `loadOlder` page is in flight. */\n  loadingOlder?: boolean;\n}\n\n/** The payload of a follow stream's `state` frame. */\nexport interface SessionFollowState {\n  revision: number;\n  lifecycleStatus: string;\n  activityState: string;\n  /** Opaque fingerprint of non-message session facets (plan, todos, files,\n   *  approval requests). Always sent by captain — see the module doc above\n   *  for how it's used to decide whether to refetch. */\n  facets: string;\n}\n\nexport interface RemoteSessionHandle {\n  /** Settles with the first fetched session, or rejects with the load error\n   *  (which `onChange` has already reported as `error`). */\n  loaded: Promise<UnifiedSessionInput>;\n  /** Fetches the page of history before the oldest message held and\n   *  prepends it; a no-op while one is in flight or nothing older remains. */\n  loadOlder: () => Promise<void>;\n  close: () => void;\n}\n\n/** `src` with `params` set in its query (replacing any of the same name),\n *  keeping any fragment last. */\nexport function sessionUrl(src: string, params: Record<string, string | number>) {\n  const hashAt = src.indexOf(\"#\");\n  const base = hashAt === -1 ? src : src.slice(0, hashAt);\n  const hash = hashAt === -1 ? \"\" : src.slice(hashAt);\n  const queryAt = base.indexOf(\"?\");\n  const query = new URLSearchParams(queryAt === -1 ? \"\" : base.slice(queryAt + 1));\n  for (const [name, value] of Object.entries(params)) query.set(name, String(value));\n  return `${queryAt === -1 ? base : base.slice(0, queryAt)}?${query}${hash}`;\n}\n\nexport async function fetchRemoteSession(\n  src: string,\n  signal?: AbortSignal,\n): Promise<UnifiedSessionInput> {\n  const response = await fetch(src, {\n    headers: { Accept: \"application/json\" },\n    ...(signal ? { signal } : {}),\n  });\n  const body = await response.text();\n  if (!response.ok) {\n    throw new Error(\n      `Failed to load session ${src} (HTTP ${response.status}): ${errorDetail(body)}`,\n    );\n  }\n  let parsed: unknown;\n  try {\n    parsed = JSON.parse(body);\n  } catch (cause) {\n    throw new Error(\n      `Session ${src} returned invalid JSON (${String(cause)}): ${body.slice(0, 200)}`,\n    );\n  }\n  if (!isRecord(parsed)) {\n    throw new Error(\n      `Session ${src} returned ${Array.isArray(parsed) ? \"an array\" : String(parsed)}, expected a session object`,\n    );\n  }\n  return parsed as UnifiedSessionInput;\n}\n\n/** Upserts messages by id: a known id is replaced in place, a new one appended.\n *  Placeholders stand in for a transcript that does not exist yet; the first\n *  real message replaces them all, since its ids never match theirs. */\nexport function mergeSessionMessages(\n  base: readonly SessionUIMessage[] | undefined,\n  incoming: readonly SessionUIMessage[],\n): SessionUIMessage[] {\n  const real = incoming.some((message) => !message.placeholder);\n  const merged = (base ?? []).filter((message) => !(real && message.placeholder));\n  for (const message of incoming) {\n    const index = merged.findIndex((existing) => existing.id === message.id);\n    if (index === -1) merged.push(message);\n    else merged[index] = message;\n  }\n  return merged;\n}\n\n/** Fetches `src`, then follows it when wanted, reporting every change through\n *  `onChange`. Nothing is reported after `close()`. */\nexport function openRemoteSession(\n  src: string,\n  {\n    follow,\n    pageSize = DEFAULT_SESSION_PAGE_SIZE,\n    eventSourceFactory,\n    onChange,\n  }: RemoteSessionOptions & {\n    eventSourceFactory: EventSourceFactory;\n    onChange: (state: RemoteSessionState) => void;\n  },\n): RemoteSessionHandle {\n  let url = sessionUrl(src, { follow: 1 });\n  let olderPage: Promise<void> | undefined;\n  let pageError: string | undefined;\n  const aborter = new AbortController();\n  const streamed = new Map<string, { message: SessionUIMessage; seq: number }>();\n  let closed = false;\n  let source: EventSourceLike | undefined;\n  let state: RemoteSessionState = { loading: true };\n  let revision: number | undefined;\n  let facets: string | undefined;\n  let seq = 0;\n  let generation = 0;\n\n  const emit = (next: RemoteSessionState) => {\n    if (closed) return;\n    state = next;\n    onChange(next);\n  };\n  const stopFollowing = () => {\n    source?.close();\n    source = undefined;\n  };\n  const fail = (message: string) => {\n    stopFollowing();\n    emit({ ...state, loading: false, error: message });\n  };\n\n  // Reads the tail and merges it into the messages already held — older pages\n  // and streamed entries — so a refetch never drops history the reader loaded.\n  const refresh = async () => {\n    const current = ++generation;\n    const startedAt = seq;\n    const fetched = await fetchRemoteSession(sessionUrl(src, { tail: pageSize }), aborter.signal);\n    if (closed || current !== generation) return undefined;\n    const fetchedIds = new Set(fetched.messages?.map((message) => message.id));\n    const keep = [...streamed.values()]\n      .filter((entry) => entry.seq > startedAt || !fetchedIds.has(entry.message.id))\n      .map((entry) => entry.message);\n    const held = mergeSessionMessages(state.session?.messages, fetched.messages ?? []);\n    const session = {\n      ...fetched,\n      messages: mergeSessionMessages(held, keep),\n    };\n    if (typeof fetched.revision === \"number\") {\n      revision = Math.max(revision ?? fetched.revision, fetched.revision);\n    }\n    const hasOlder =\n      state.session === undefined\n        ? (fetched.window?.messages ?? 0) > (fetched.messages?.length ?? 0)\n        : state.hasOlder;\n    emit({ ...state, session, loading: false, hasOlder: hasOlder ?? false });\n    return session;\n  };\n\n  const loadOlder = (): Promise<void> => {\n    const oldest = state.session?.messages?.[0]?.id;\n    if (closed || olderPage || !state.hasOlder || !oldest) return olderPage ?? Promise.resolve();\n    emit({ ...state, loadingOlder: true });\n    olderPage = fetchRemoteSession(sessionUrl(src, { before: oldest, limit: pageSize }), aborter.signal)\n      .then((page) => {\n        const older = page.messages ?? [];\n        // A page that loads clears the alert a failed page raised, never a\n        // stream's terminal error.\n        const { error, ...rest } = state;\n        const session = state.session!;\n        emit({\n          ...rest,\n          ...(error !== undefined && error !== pageError ? { error } : {}),\n          loadingOlder: false,\n          hasOlder: older.length === pageSize,\n          session: { ...session, messages: mergeSessionMessages(older, session.messages ?? []) },\n        });\n        pageError = undefined;\n      })\n      .catch((reason: unknown) => {\n        if (closed) return;\n        pageError = errorMessage(reason);\n        emit({ ...state, loadingOlder: false, error: pageError });\n      })\n      .finally(() => {\n        olderPage = undefined;\n      });\n    return olderPage;\n  };\n\n  const readFrame = (event: Event): unknown => {\n    try {\n      return JSON.parse((event as MessageEvent).data as string);\n    } catch (cause) {\n      fail(`Unparseable ${event.type} frame from ${url}: ${String(cause)}`);\n      return undefined;\n    }\n  };\n\n  const onEntry = (event: Event) => {\n    const message = readFrame(event);\n    if (message === undefined) return;\n    if (!isRecord(message) || typeof message.id !== \"string\" || !message.id) {\n      fail(`Entry frame from ${url} has no message id: ${String((event as MessageEvent).data)}`);\n      return;\n    }\n    const entry = message as unknown as SessionUIMessage;\n    streamed.set(message.id, { message: entry, seq: ++seq });\n    const session = state.session!;\n    emit({\n      ...state,\n      session: { ...session, messages: mergeSessionMessages(session.messages, [entry]) },\n    });\n  };\n\n  const onState = (event: Event) => {\n    const frame = readFrame(event);\n    if (frame === undefined) return;\n    if (\n      !isRecord(frame) ||\n      typeof frame.revision !== \"number\" ||\n      typeof frame.lifecycleStatus !== \"string\" ||\n      typeof frame.facets !== \"string\"\n    ) {\n      fail(`State frame from ${url} lacks a numeric revision, a lifecycleStatus, and facets: ${String((event as MessageEvent).data)}`);\n      return;\n    }\n    const next = frame as unknown as SessionFollowState;\n    emit({\n      ...state,\n      session: {\n        ...state.session,\n        lifecycleStatus: next.lifecycleStatus,\n        ...(typeof next.activityState === \"string\" ? { activityState: next.activityState } : {}),\n      },\n    });\n    const revisionIncreased = revision === undefined || next.revision > revision;\n    // The first state frame's facets is the baseline: it never triggers a\n    // refetch by itself, only a higher revision does (as before facets\n    // existed). Any later frame whose facets differ from the last one seen\n    // does trigger a refetch, independently of revision.\n    const facetsChanged = facets !== undefined && next.facets !== facets;\n    facets = next.facets;\n    if (revisionIncreased) revision = next.revision;\n    if (revisionIncreased || facetsChanged) {\n      refresh().catch((reason: unknown) => {\n        if (!closed) fail(errorMessage(reason));\n      });\n    }\n    if (isTerminalSessionLifecycle(next.lifecycleStatus)) stopFollowing();\n  };\n\n  // Resumes after the newest real message held, so the server replays only\n  // what came later; a placeholder is no position in the transcript, so a\n  // reader holding only placeholders follows from the start. A reconnect\n  // reuses this URL; replayed entries upsert by id.\n  const startFollowing = () => {\n    const newest = state.session?.messages?.filter((message) => !message.placeholder).at(-1)?.id;\n    url = sessionUrl(src, newest ? { follow: 1, after: newest } : { follow: 1 });\n    const es = eventSourceFactory(url);\n    source = es;\n    let received = false;\n    const onError = (event: Event) => {\n      const data = (event as MessageEvent).data;\n      if (typeof data === \"string\") {\n        const frame = readFrame(event);\n        if (frame === undefined) return;\n        const reported = isRecord(frame) && typeof frame.error === \"string\" ? frame.error : data;\n        fail(`Session stream ${url} reported an error: ${reported}`);\n        return;\n      }\n      // After data has arrived, a dropped connection reconnects on its own and\n      // the server replays; entries upsert by id, so the replay is idempotent.\n      if (received && es.readyState !== 2) return;\n      fail(\n        received\n          ? `Lost the session stream ${url}`\n          : `Could not connect to the session stream ${url}`,\n      );\n    };\n    es.addEventListener(\"entry\", (event) => {\n      received = true;\n      onEntry(event);\n    });\n    es.addEventListener(\"state\", (event) => {\n      received = true;\n      onState(event);\n    });\n    es.addEventListener(\"error\", onError);\n  };\n\n  const loaded = refresh().then(\n    (session) => {\n      if (!session) throw new Error(`Session ${src} was closed before it loaded`);\n      const lifecycle = session.lifecycleStatus;\n      const wanted =\n        follow ?? (lifecycle !== undefined && !isTerminalSessionLifecycle(lifecycle));\n      if (wanted && !closed) startFollowing();\n      return session;\n    },\n    (reason: unknown) => {\n      if (!closed) fail(errorMessage(reason));\n      throw reason;\n    },\n  );\n\n  return {\n    loaded,\n    loadOlder,\n    close: () => {\n      closed = true;\n      aborter.abort();\n      stopFollowing();\n    },\n  };\n}\n\nconst IDLE: RemoteSessionState = { loading: false };\nconst LOADING: RemoteSessionState = { loading: true };\n\nexport interface RemoteSessionView extends RemoteSessionState {\n  /** See RemoteSessionHandle.loadOlder; a no-op before the session loads. */\n  loadOlder: () => Promise<void>;\n}\n\n/** Loads `src` (undefined loads nothing) and follows it on demand; see\n *  `RemoteSessionOptions`. Changing `src`, `follow` or `pageSize`, or\n *  unmounting, closes the previous stream. */\nexport function useRemoteSession(\n  src: string | undefined,\n  { follow, pageSize }: RemoteSessionOptions = {},\n): RemoteSessionView {\n  const eventSourceFactory = useEventSourceFactory();\n  const factoryRef = useRef(eventSourceFactory);\n  factoryRef.current = eventSourceFactory;\n  const handleRef = useRef<RemoteSessionHandle>(undefined);\n  const [snapshot, setSnapshot] = useState<{\n    src: string;\n    state: RemoteSessionState;\n  }>();\n\n  useEffect(() => {\n    if (src === undefined) return undefined;\n    setSnapshot({ src, state: LOADING });\n    const handle = openRemoteSession(src, {\n      ...(follow === undefined ? {} : { follow }),\n      ...(pageSize === undefined ? {} : { pageSize }),\n      eventSourceFactory: factoryRef.current,\n      onChange: (state) => setSnapshot({ src, state }),\n    });\n    handleRef.current = handle;\n    // A load failure already reached the state through onChange as `error`.\n    handle.loaded.catch(() => undefined);\n    return () => {\n      handle.close();\n      if (handleRef.current === handle) handleRef.current = undefined;\n    };\n  }, [src, follow, pageSize]);\n\n  const loadOlder = useCallback(() => handleRef.current?.loadOlder() ?? Promise.resolve(), []);\n  const state = src === undefined ? IDLE : snapshot?.src === src ? snapshot.state : LOADING;\n  return useMemo(() => ({ ...state, loadOlder }), [state, loadOlder]);\n}\n\n/** What a host learns about a `src`-backed inspector's load. `error` carries\n *  the server's message (a 404 body's `error` field or plain text) or the\n *  follow stream's terminal error frame. */\nexport type SessionInspectorLoadState =\n  | { status: \"loading\" | \"ready\" }\n  | { status: \"error\"; error: Error };\n\n/** Reports `state` to `onChange` whenever its status or error changes; never\n *  when `enabled` is false (in-memory sessions have no load to report). */\nexport function useReportLoadState({\n  state,\n  enabled,\n  onChange,\n}: {\n  state: RemoteSessionState;\n  enabled: boolean;\n  onChange: ((state: SessionInspectorLoadState) => void) | undefined;\n}) {\n  const onChangeRef = useRef(onChange);\n  onChangeRef.current = onChange;\n  const { loading, error } = state;\n  useEffect(() => {\n    if (!enabled) return;\n    onChangeRef.current?.(\n      error !== undefined\n        ? { status: \"error\", error: new Error(error) }\n        : { status: loading ? \"loading\" : \"ready\" },\n    );\n  }, [enabled, loading, error]);\n}\n\nexport interface RemoteCollectionState {\n  /** The collection with its current item's session loaded, once it is. */\n  collection?: SessionCollectionInput;\n  error?: string;\n  loading: boolean;\n}\n\n/** Loads the current item of a collection when it carries only `src`, so the\n *  hierarchy (which requires a loaded current session) can render. */\nexport function useRemoteCollection(\n  collection: SessionCollectionInput | undefined,\n  options: RemoteSessionOptions = {},\n): RemoteCollectionState {\n  const current = collection?.sessions.find(\n    (item) => item.id === collection.currentSessionId,\n  );\n  const src = current && !current.session ? current.src : undefined;\n  const remote = useRemoteSession(src, options);\n  return useMemo(() => {\n    if (!collection) return IDLE;\n    if (src === undefined || !current) return { collection, loading: false };\n    const status = {\n      loading: remote.loading,\n      ...(remote.error ? { error: remote.error } : {}),\n    };\n    if (!remote.session) return status;\n    const session = remote.session;\n    return {\n      ...status,\n      collection: {\n        ...collection,\n        sessions: collection.sessions.map((item) =>\n          item === current ? { ...item, session } : item,\n        ),\n      },\n    };\n  }, [collection, current, src, remote]);\n}\n\nfunction errorDetail(body: string) {\n  const text = body.trim();\n  if (!text) return \"empty response body\";\n  try {\n    const parsed: unknown = JSON.parse(text);\n    if (isRecord(parsed) && typeof parsed.error === \"string\") return parsed.error;\n  } catch {\n    // Not JSON: the text itself is the detail.\n  }\n  return text;\n}\n\nfunction errorMessage(reason: unknown) {\n  return reason instanceof Error ? reason.message : String(reason);\n}\n\nfunction isRecord(value: unknown): value is Record<string, unknown> {\n  return typeof value === \"object\" && value !== null && !Array.isArray(value);\n}\n"],"names":["useEventSourceFactory","useRef","useState","useEffect","state","useCallback","useMemo"],"mappings":"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"}

package/dist/data/ai/SessionInspector.remote.d.ts

@@ -3,16 +3,25 @@ import { SessionCollectionInput } from './SessionInspector.collection-types.js';
 import { SessionUIMessage, UnifiedSessionInput } from './SessionViewer.unified.js';
 export declare const TERMINAL_SESSION_LIFECYCLES: readonly ["succeeded", "partial", "failed", "cancelled", "interrupted", "completed"];
 export declare function isTerminalSessionLifecycle(status: string | undefined): boolean;
+/** Messages asked for by the first read and by each page of history. */
+export declare const DEFAULT_SESSION_PAGE_SIZE = 100;
 export interface RemoteSessionOptions {
     /** Force (`true`) or suppress (`false`) the live stream. By default a
      *  session follows only while it reports a non-terminal `lifecycleStatus`;
      *  a session that reports none is not followed. */
     follow?: boolean;
+    /** Messages per read: the first read's `tail` and each history page's
+     *  `limit`. Defaults to DEFAULT_SESSION_PAGE_SIZE. */
+    pageSize?: number;
 }
 export interface RemoteSessionState {
     session?: UnifiedSessionInput;
     error?: string;
     loading: boolean;
+    /** Older messages exist that `loadOlder` has not fetched yet. */
+    hasOlder?: boolean;
+    /** A `loadOlder` page is in flight. */
+    loadingOlder?: boolean;
 }
 /** The payload of a follow stream's `state` frame. */
 export interface SessionFollowState {
@@ -28,23 +37,49 @@ export interface RemoteSessionHandle {
     /** Settles with the first fetched session, or rejects with the load error
      *  (which `onChange` has already reported as `error`). */
     loaded: Promise<UnifiedSessionInput>;
+    /** Fetches the page of history before the oldest message held and
+     *  prepends it; a no-op while one is in flight or nothing older remains. */
+    loadOlder: () => Promise<void>;
     close: () => void;
 }
-/** `src` with `follow=1` appended to its query, keeping any fragment last. */
-export declare function sessionFollowUrl(src: string): string;
+/** `src` with `params` set in its query (replacing any of the same name),
+ *  keeping any fragment last. */
+export declare function sessionUrl(src: string, params: Record<string, string | number>): string;
 export declare function fetchRemoteSession(src: string, signal?: AbortSignal): Promise<UnifiedSessionInput>;
-/** Upserts messages by id: a known id is replaced in place, a new one appended. */
+/** Upserts messages by id: a known id is replaced in place, a new one appended.
+ *  Placeholders stand in for a transcript that does not exist yet; the first
+ *  real message replaces them all, since its ids never match theirs. */
 export declare function mergeSessionMessages(base: readonly SessionUIMessage[] | undefined, incoming: readonly SessionUIMessage[]): SessionUIMessage[];
 /** Fetches `src`, then follows it when wanted, reporting every change through
  *  `onChange`. Nothing is reported after `close()`. */
-export declare function openRemoteSession(src: string, { follow, eventSourceFactory, onChange, }: RemoteSessionOptions & {
+export declare function openRemoteSession(src: string, { follow, pageSize, eventSourceFactory, onChange, }: RemoteSessionOptions & {
     eventSourceFactory: EventSourceFactory;
     onChange: (state: RemoteSessionState) => void;
 }): RemoteSessionHandle;
+export interface RemoteSessionView extends RemoteSessionState {
+    /** See RemoteSessionHandle.loadOlder; a no-op before the session loads. */
+    loadOlder: () => Promise<void>;
+}
 /** Loads `src` (undefined loads nothing) and follows it on demand; see
- *  `RemoteSessionOptions.follow`. Changing `src` or `follow`, or unmounting,
- *  closes the previous stream. */
-export declare function useRemoteSession(src: string | undefined, { follow }?: RemoteSessionOptions): RemoteSessionState;
+ *  `RemoteSessionOptions`. Changing `src`, `follow` or `pageSize`, or
+ *  unmounting, closes the previous stream. */
+export declare function useRemoteSession(src: string | undefined, { follow, pageSize }?: RemoteSessionOptions): RemoteSessionView;
+/** What a host learns about a `src`-backed inspector's load. `error` carries
+ *  the server's message (a 404 body's `error` field or plain text) or the
+ *  follow stream's terminal error frame. */
+export type SessionInspectorLoadState = {
+    status: "loading" | "ready";
+} | {
+    status: "error";
+    error: Error;
+};
+/** Reports `state` to `onChange` whenever its status or error changes; never
+ *  when `enabled` is false (in-memory sessions have no load to report). */
+export declare function useReportLoadState({ state, enabled, onChange, }: {
+    state: RemoteSessionState;
+    enabled: boolean;
+    onChange: ((state: SessionInspectorLoadState) => void) | undefined;
+}): void;
 export interface RemoteCollectionState {
     /** The collection with its current item's session loaded, once it is. */
     collection?: SessionCollectionInput;

package/dist/data/ai/SessionInspector.remote.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"SessionInspector.remote.d.ts","sourceRoot":"","sources":["../../../src/data/ai/SessionInspector.remote.ts"],"names":[],"mappings":"AACA,OAAO,EAEL,KAAK,kBAAkB,EAExB,MAAM,0BAA0B,CAAC;AAClC,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,qCAAqC,CAAC;AAClF,OAAO,KAAK,EACV,gBAAgB,EAChB,mBAAmB,EACpB,MAAM,yBAAyB,CAAC;AAmBjC,eAAO,MAAM,2BAA2B,sFAO9B,CAAC;AAEX,wBAAgB,0BAA0B,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,WAKpE;AAED,MAAM,WAAW,oBAAoB;IACnC;;uDAEmD;IACnD,MAAM,CAAC,EAAE,OAAO,CAAC;CAClB;AAED,MAAM,WAAW,kBAAkB;IACjC,OAAO,CAAC,EAAE,mBAAmB,CAAC;IAC9B,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,OAAO,CAAC;CAClB;AAED,sDAAsD;AACtD,MAAM,WAAW,kBAAkB;IACjC,QAAQ,EAAE,MAAM,CAAC;IACjB,eAAe,EAAE,MAAM,CAAC;IACxB,aAAa,EAAE,MAAM,CAAC;IACtB;;0DAEsD;IACtD,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,mBAAmB;IAClC;8DAC0D;IAC1D,MAAM,EAAE,OAAO,CAAC,mBAAmB,CAAC,CAAC;IACrC,KAAK,EAAE,MAAM,IAAI,CAAC;CACnB;AAED,8EAA8E;AAC9E,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,MAAM,UAU3C;AAED,wBAAsB,kBAAkB,CACtC,GAAG,EAAE,MAAM,EACX,MAAM,CAAC,EAAE,WAAW,GACnB,OAAO,CAAC,mBAAmB,CAAC,CAyB9B;AAED,mFAAmF;AACnF,wBAAgB,oBAAoB,CAClC,IAAI,EAAE,SAAS,gBAAgB,EAAE,GAAG,SAAS,EAC7C,QAAQ,EAAE,SAAS,gBAAgB,EAAE,GACpC,gBAAgB,EAAE,CAQpB;AAED;uDACuD;AACvD,wBAAgB,iBAAiB,CAC/B,GAAG,EAAE,MAAM,EACX,EACE,MAAM,EACN,kBAAkB,EAClB,QAAQ,GACT,EAAE,oBAAoB,GAAG;IACxB,kBAAkB,EAAE,kBAAkB,CAAC;IACvC,QAAQ,EAAE,CAAC,KAAK,EAAE,kBAAkB,KAAK,IAAI,CAAC;CAC/C,GACA,mBAAmB,CAoKrB;AAKD;;kCAEkC;AAClC,wBAAgB,gBAAgB,CAC9B,GAAG,EAAE,MAAM,GAAG,SAAS,EACvB,EAAE,MAAM,EAAE,GAAE,oBAAyB,GACpC,kBAAkB,CAwBpB;AAED,MAAM,WAAW,qBAAqB;IACpC,yEAAyE;IACzE,UAAU,CAAC,EAAE,sBAAsB,CAAC;IACpC,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,OAAO,CAAC;CAClB;AAED;sEACsE;AACtE,wBAAgB,mBAAmB,CACjC,UAAU,EAAE,sBAAsB,GAAG,SAAS,EAC9C,OAAO,GAAE,oBAAyB,GACjC,qBAAqB,CAyBvB"}
+{"version":3,"file":"SessionInspector.remote.d.ts","sourceRoot":"","sources":["../../../src/data/ai/SessionInspector.remote.ts"],"names":[],"mappings":"AACA,OAAO,EAEL,KAAK,kBAAkB,EAExB,MAAM,0BAA0B,CAAC;AAClC,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,qCAAqC,CAAC;AAClF,OAAO,KAAK,EACV,gBAAgB,EAChB,mBAAmB,EACpB,MAAM,yBAAyB,CAAC;AA0BjC,eAAO,MAAM,2BAA2B,sFAO9B,CAAC;AAEX,wBAAgB,0BAA0B,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,WAKpE;AAED,wEAAwE;AACxE,eAAO,MAAM,yBAAyB,MAAM,CAAC;AAE7C,MAAM,WAAW,oBAAoB;IACnC;;uDAEmD;IACnD,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB;0DACsD;IACtD,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,kBAAkB;IACjC,OAAO,CAAC,EAAE,mBAAmB,CAAC;IAC9B,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,OAAO,CAAC;IACjB,iEAAiE;IACjE,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,uCAAuC;IACvC,YAAY,CAAC,EAAE,OAAO,CAAC;CACxB;AAED,sDAAsD;AACtD,MAAM,WAAW,kBAAkB;IACjC,QAAQ,EAAE,MAAM,CAAC;IACjB,eAAe,EAAE,MAAM,CAAC;IACxB,aAAa,EAAE,MAAM,CAAC;IACtB;;0DAEsD;IACtD,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,mBAAmB;IAClC;8DAC0D;IAC1D,MAAM,EAAE,OAAO,CAAC,mBAAmB,CAAC,CAAC;IACrC;gFAC4E;IAC5E,SAAS,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;IAC/B,KAAK,EAAE,MAAM,IAAI,CAAC;CACnB;AAED;iCACiC;AACjC,wBAAgB,UAAU,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAAC,UAQ9E;AAED,wBAAsB,kBAAkB,CACtC,GAAG,EAAE,MAAM,EACX,MAAM,CAAC,EAAE,WAAW,GACnB,OAAO,CAAC,mBAAmB,CAAC,CAyB9B;AAED;;wEAEwE;AACxE,wBAAgB,oBAAoB,CAClC,IAAI,EAAE,SAAS,gBAAgB,EAAE,GAAG,SAAS,EAC7C,QAAQ,EAAE,SAAS,gBAAgB,EAAE,GACpC,gBAAgB,EAAE,CASpB;AAED;uDACuD;AACvD,wBAAgB,iBAAiB,CAC/B,GAAG,EAAE,MAAM,EACX,EACE,MAAM,EACN,QAAoC,EACpC,kBAAkB,EAClB,QAAQ,GACT,EAAE,oBAAoB,GAAG;IACxB,kBAAkB,EAAE,kBAAkB,CAAC;IACvC,QAAQ,EAAE,CAAC,KAAK,EAAE,kBAAkB,KAAK,IAAI,CAAC;CAC/C,GACA,mBAAmB,CAmNrB;AAKD,MAAM,WAAW,iBAAkB,SAAQ,kBAAkB;IAC3D,2EAA2E;IAC3E,SAAS,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;CAChC;AAED;;8CAE8C;AAC9C,wBAAgB,gBAAgB,CAC9B,GAAG,EAAE,MAAM,GAAG,SAAS,EACvB,EAAE,MAAM,EAAE,QAAQ,EAAE,GAAE,oBAAyB,GAC9C,iBAAiB,CA+BnB;AAED;;4CAE4C;AAC5C,MAAM,MAAM,yBAAyB,GACjC;IAAE,MAAM,EAAE,SAAS,GAAG,OAAO,CAAA;CAAE,GAC/B;IAAE,MAAM,EAAE,OAAO,CAAC;IAAC,KAAK,EAAE,KAAK,CAAA;CAAE,CAAC;AAEtC;2EAC2E;AAC3E,wBAAgB,kBAAkB,CAAC,EACjC,KAAK,EACL,OAAO,EACP,QAAQ,GACT,EAAE;IACD,KAAK,EAAE,kBAAkB,CAAC;IAC1B,OAAO,EAAE,OAAO,CAAC;IACjB,QAAQ,EAAE,CAAC,CAAC,KAAK,EAAE,yBAAyB,KAAK,IAAI,CAAC,GAAG,SAAS,CAAC;CACpE,QAYA;AAED,MAAM,WAAW,qBAAqB;IACpC,yEAAyE;IACzE,UAAU,CAAC,EAAE,sBAAsB,CAAC;IACpC,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,OAAO,CAAC;CAClB;AAED;sEACsE;AACtE,wBAAgB,mBAAmB,CACjC,UAAU,EAAE,sBAAsB,GAAG,SAAS,EAC9C,OAAO,GAAE,oBAAyB,GACjC,qBAAqB,CAyBvB"}

package/dist/data/ai/SessionInspector.remote.js

@@ -1,4 +1,4 @@
-import { useRef, useState, useEffect, useMemo } from "react";
+import { useRef, useState, useEffect, useCallback, useMemo } from "react";
 import { useEventSourceFactory } from "../../hooks/event-source.js";
 const TERMINAL_SESSION_LIFECYCLES = [
   "succeeded",
@@ -11,12 +11,15 @@ const TERMINAL_SESSION_LIFECYCLES = [
 function isTerminalSessionLifecycle(status) {
   return status !== void 0 && TERMINAL_SESSION_LIFECYCLES.includes(status);
 }
-function sessionFollowUrl(src) {
+const DEFAULT_SESSION_PAGE_SIZE = 100;
+function sessionUrl(src, params) {
   const hashAt = src.indexOf("#");
   const base = hashAt === -1 ? src : src.slice(0, hashAt);
   const hash = hashAt === -1 ? "" : src.slice(hashAt);
-  const separator = !base.includes("?") ? "?" : base.endsWith("?") || base.endsWith("&") ? "" : "&";
-  return `${base}${separator}follow=1${hash}`;
+  const queryAt = base.indexOf("?");
+  const query = new URLSearchParams(queryAt === -1 ? "" : base.slice(queryAt + 1));
+  for (const [name, value] of Object.entries(params)) query.set(name, String(value));
+  return `${queryAt === -1 ? base : base.slice(0, queryAt)}?${query}${hash}`;
 }
 async function fetchRemoteSession(src, signal) {
   const response = await fetch(src, {
@@ -45,7 +48,8 @@ async function fetchRemoteSession(src, signal) {
   return parsed;
 }
 function mergeSessionMessages(base, incoming) {
-  const merged = [...base ?? []];
+  const real = incoming.some((message) => !message.placeholder);
+  const merged = (base ?? []).filter((message) => !(real && message.placeholder));
   for (const message of incoming) {
     const index = merged.findIndex((existing) => existing.id === message.id);
     if (index === -1) merged.push(message);
@@ -55,10 +59,13 @@ function mergeSessionMessages(base, incoming) {
 }
 function openRemoteSession(src, {
   follow,
+  pageSize = DEFAULT_SESSION_PAGE_SIZE,
   eventSourceFactory,
   onChange
 }) {
-  const url = sessionFollowUrl(src);
+  let url = sessionUrl(src, { follow: 1 });
+  let olderPage;
+  let pageError;
   const aborter = new AbortController();
   const streamed = /* @__PURE__ */ new Map();
   let closed = false;
@@ -82,23 +89,51 @@ function openRemoteSession(src, {
     emit({ ...state, loading: false, error: message });
   };
   const refresh = async () => {
-    var _a;
+    var _a, _b, _c, _d;
     const current = ++generation;
     const startedAt = seq;
-    const fetched = await fetchRemoteSession(src, aborter.signal);
+    const fetched = await fetchRemoteSession(sessionUrl(src, { tail: pageSize }), aborter.signal);
     if (closed || current !== generation) return void 0;
     const fetchedIds = new Set((_a = fetched.messages) == null ? void 0 : _a.map((message) => message.id));
     const keep = [...streamed.values()].filter((entry) => entry.seq > startedAt || !fetchedIds.has(entry.message.id)).map((entry) => entry.message);
+    const held = mergeSessionMessages((_b = state.session) == null ? void 0 : _b.messages, fetched.messages ?? []);
     const session = {
       ...fetched,
-      messages: mergeSessionMessages(fetched.messages, keep)
+      messages: mergeSessionMessages(held, keep)
     };
     if (typeof fetched.revision === "number") {
       revision = Math.max(revision ?? fetched.revision, fetched.revision);
     }
-    emit({ ...state, session, loading: false });
+    const hasOlder = state.session === void 0 ? (((_c = fetched.window) == null ? void 0 : _c.messages) ?? 0) > (((_d = fetched.messages) == null ? void 0 : _d.length) ?? 0) : state.hasOlder;
+    emit({ ...state, session, loading: false, hasOlder: hasOlder ?? false });
     return session;
   };
+  const loadOlder = () => {
+    var _a, _b, _c;
+    const oldest = (_c = (_b = (_a = state.session) == null ? void 0 : _a.messages) == null ? void 0 : _b[0]) == null ? void 0 : _c.id;
+    if (closed || olderPage || !state.hasOlder || !oldest) return olderPage ?? Promise.resolve();
+    emit({ ...state, loadingOlder: true });
+    olderPage = fetchRemoteSession(sessionUrl(src, { before: oldest, limit: pageSize }), aborter.signal).then((page) => {
+      const older = page.messages ?? [];
+      const { error, ...rest } = state;
+      const session = state.session;
+      emit({
+        ...rest,
+        ...error !== void 0 && error !== pageError ? { error } : {},
+        loadingOlder: false,
+        hasOlder: older.length === pageSize,
+        session: { ...session, messages: mergeSessionMessages(older, session.messages ?? []) }
+      });
+      pageError = void 0;
+    }).catch((reason) => {
+      if (closed) return;
+      pageError = errorMessage(reason);
+      emit({ ...state, loadingOlder: false, error: pageError });
+    }).finally(() => {
+      olderPage = void 0;
+    });
+    return olderPage;
+  };
   const readFrame = (event) => {
     try {
       return JSON.parse(event.data);
@@ -150,6 +185,9 @@ function openRemoteSession(src, {
     if (isTerminalSessionLifecycle(next.lifecycleStatus)) stopFollowing();
   };
   const startFollowing = () => {
+    var _a, _b, _c;
+    const newest = (_c = (_b = (_a = state.session) == null ? void 0 : _a.messages) == null ? void 0 : _b.filter((message) => !message.placeholder).at(-1)) == null ? void 0 : _c.id;
+    url = sessionUrl(src, newest ? { follow: 1, after: newest } : { follow: 1 });
     const es = eventSourceFactory(url);
     source = es;
     let received = false;
@@ -192,6 +230,7 @@ function openRemoteSession(src, {
   );
   return {
     loaded,
+    loadOlder,
     close: () => {
       closed = true;
       aborter.abort();
@@ -201,24 +240,51 @@ function openRemoteSession(src, {
 }
 const IDLE = { loading: false };
 const LOADING = { loading: true };
-function useRemoteSession(src, { follow } = {}) {
+function useRemoteSession(src, { follow, pageSize } = {}) {
   const eventSourceFactory = useEventSourceFactory();
   const factoryRef = useRef(eventSourceFactory);
   factoryRef.current = eventSourceFactory;
+  const handleRef = useRef(void 0);
   const [snapshot, setSnapshot] = useState();
   useEffect(() => {
     if (src === void 0) return void 0;
     setSnapshot({ src, state: LOADING });
     const handle = openRemoteSession(src, {
       ...follow === void 0 ? {} : { follow },
+      ...pageSize === void 0 ? {} : { pageSize },
       eventSourceFactory: factoryRef.current,
-      onChange: (state) => setSnapshot({ src, state })
+      onChange: (state2) => setSnapshot({ src, state: state2 })
     });
+    handleRef.current = handle;
     handle.loaded.catch(() => void 0);
-    return handle.close;
-  }, [src, follow]);
-  if (src === void 0) return IDLE;
-  return (snapshot == null ? void 0 : snapshot.src) === src ? snapshot.state : LOADING;
+    return () => {
+      handle.close();
+      if (handleRef.current === handle) handleRef.current = void 0;
+    };
+  }, [src, follow, pageSize]);
+  const loadOlder = useCallback(() => {
+    var _a;
+    return ((_a = handleRef.current) == null ? void 0 : _a.loadOlder()) ?? Promise.resolve();
+  }, []);
+  const state = src === void 0 ? IDLE : (snapshot == null ? void 0 : snapshot.src) === src ? snapshot.state : LOADING;
+  return useMemo(() => ({ ...state, loadOlder }), [state, loadOlder]);
+}
+function useReportLoadState({
+  state,
+  enabled,
+  onChange
+}) {
+  const onChangeRef = useRef(onChange);
+  onChangeRef.current = onChange;
+  const { loading, error } = state;
+  useEffect(() => {
+    var _a;
+    if (!enabled) return;
+    (_a = onChangeRef.current) == null ? void 0 : _a.call(
+      onChangeRef,
+      error !== void 0 ? { status: "error", error: new Error(error) } : { status: loading ? "loading" : "ready" }
+    );
+  }, [enabled, loading, error]);
 }
 function useRemoteCollection(collection, options = {}) {
   const current = collection == null ? void 0 : collection.sessions.find(
@@ -263,13 +329,15 @@ function isRecord(value) {
   return typeof value === "object" && value !== null && !Array.isArray(value);
 }
 export {
+  DEFAULT_SESSION_PAGE_SIZE,
   TERMINAL_SESSION_LIFECYCLES,
   fetchRemoteSession,
   isTerminalSessionLifecycle,
   mergeSessionMessages,
   openRemoteSession,
-  sessionFollowUrl,
+  sessionUrl,
   useRemoteCollection,
-  useRemoteSession
+  useRemoteSession,
+  useReportLoadState
 };
 //# sourceMappingURL=SessionInspector.remote.js.map