@flanksource/clicky-ui 0.3.35 → 0.3.37

package/dist/hooks/use-log-tail.js.map

@@ -1 +1 @@
-{"version":3,"file":"use-log-tail.js","sources":["../../src/hooks/use-log-tail.ts"],"sourcesContent":["import { useEffect, useRef, useState } from \"react\";\n\n// use-log-tail is the clicky-ui client for a *follow* session: the server opens\n// a live source for a query profile and streams rows out of it until someone\n// closes it. It is shaped like use-task-run — SSE-first, polling only when\n// EventSource is missing — but the resource underneath is far less forgiving. A\n// follow session holds a websocket to Loki, or a log stream to a kubelet, for as\n// long as it exists, and the server caps how many may run at once\n// (ErrMaxSessions, surfaced as HTTP 409). A session that is left behind is\n// therefore not untidy, it is a slot the next reader cannot have, which is why\n// stopping is a DELETE the hook issues on every exit path including unmount.\n//\n// The second thing this stream does differently is replay. Each SSE frame\n// carries an `id:`, so a reconnecting EventSource sends Last-Event-ID and the\n// server resumes from that sequence — re-delivering frames the client may\n// already hold. Sequences are the server's, not a client index: they do not\n// start at 1 and they do not reset, so the accumulator dedupes against the\n// highest sequence it has applied rather than against a position in an array.\n\nexport type LogSessionState =\n  | \"starting\"\n  | \"running\"\n  | \"completed\"\n  | \"failed\"\n  | \"stopped\"\n  | \"interrupted\";\n\n/** SessionInfo as returned by POST /profile/{name}/sessions and the `done` frame. */\nexport interface LogSessionInfo {\n  id: string;\n  profile: string;\n  kind: string;\n  state: LogSessionState;\n  params?: Record<string, unknown>;\n  error?: string;\n  eventCount: number;\n  startedAt: string;\n  stoppedAt?: string;\n}\n\n/**\n * One `event:` frame. It carries either a single `row` or a batch under `rows`\n * — never both — plus an `error` when the source failed mid-stream without the\n * session itself ending.\n */\nexport interface LogTailEvent {\n  sessionId: string;\n  sequence: number;\n  time?: string;\n  row?: Record<string, unknown>;\n  rows?: Record<string, unknown>[];\n  error?: string;\n}\n\n/**\n * Where a failure came from, because the three are not interchangeable to a\n * reader: `start` means the session never existed (409 is the cap), `stream`\n * means the session is alive but something in it went wrong, and `session`\n * means the server ended it.\n */\nexport interface LogTailError {\n  scope: \"start\" | \"stream\" | \"session\";\n  message: string;\n  /** HTTP status when a request produced the failure. 409 is the session cap. */\n  httpStatus?: number;\n}\n\n/** Renderable transport/session state. The terminal values are the server's own. */\nexport type LogTailStatus =\n  | \"idle\"\n  | \"starting\"\n  | \"streaming\"\n  | \"polling\"\n  | \"connection lost — retrying\"\n  | \"completed\"\n  | \"failed\"\n  | \"stopped\"\n  | \"interrupted\";\n\nconst TERMINAL: ReadonlySet<string> = new Set([\"completed\", \"failed\", \"stopped\", \"interrupted\"]);\n\nexport function isTerminalSessionState(state: LogSessionState | undefined): boolean {\n  return state !== undefined && TERMINAL.has(state);\n}\n\nexport interface LogTailBuffer {\n  /** Rows in arrival order, oldest first — the order this surface tails in. */\n  rows: Record<string, unknown>[];\n  /** Highest sequence applied, or null before the first frame. Never assumed to start at 1. */\n  lastSequence: number | null;\n  /** Rows evicted by the cap. Kept so the UI can say so instead of quietly shortening history. */\n  dropped: number;\n}\n\nexport const emptyLogTailBuffer: LogTailBuffer = { rows: [], lastSequence: null, dropped: 0 };\n\n/**\n * Renders profile parameters as the tail of a session request's query string,\n * `\"\"` when there are none, and each entry already `&`-prefixed so it appends\n * to a query that always begins with `?follow=true`.\n *\n * Keys are sorted so two callers passing the same parameters in a different\n * order produce the same string — the effect that opens the session depends on\n * it, and an unstable spelling would tear down a live tail and start a new one\n * on a render that changed nothing.\n *\n * A null or undefined value is omitted rather than sent as the text \"null\": the\n * server reads every query key as a supplied parameter, so spelling an absent\n * one out states a filter the caller did not ask for.\n */\nexport function encodeTailParams(params: Record<string, unknown> | undefined): string {\n  if (!params) return \"\";\n  const query = new URLSearchParams();\n  for (const key of Object.keys(params).sort()) {\n    const value = params[key];\n    if (value === undefined || value === null) continue;\n    query.append(key, String(value));\n  }\n  const encoded = query.toString();\n  return encoded === \"\" ? \"\" : `&${encoded}`;\n}\n\n/**\n * Applies one frame to the buffer, dropping anything at or below the highest\n * sequence already seen. A watermark is enough — and cheaper than remembering\n * every id — because SSE is ordered within a connection and the only source of\n * duplicates is a reconnect, whose replay starts at Last-Event-ID and so can\n * only re-deliver frames the buffer has already passed.\n *\n * Returns the buffer unchanged when the frame adds nothing, so React can bail\n * out of the render.\n */\nexport function appendTailEvent(\n  buffer: LogTailBuffer,\n  event: LogTailEvent,\n  maxRows: number,\n): LogTailBuffer {\n  if (buffer.lastSequence !== null && event.sequence <= buffer.lastSequence) return buffer;\n  const incoming = event.rows ?? (event.row ? [event.row] : []);\n  if (incoming.length === 0) return { ...buffer, lastSequence: event.sequence };\n\n  const merged = buffer.rows.concat(incoming);\n  const overflow = Math.max(0, merged.length - Math.max(1, maxRows));\n  return {\n    rows: overflow > 0 ? merged.slice(overflow) : merged,\n    lastSequence: event.sequence,\n    dropped: buffer.dropped + overflow,\n  };\n}\n\nexport interface UseLogTailOptions {\n  /** Query profile to follow, e.g. \"k8s-pod-logs\". */\n  profile: string;\n  /** Profile parameters, sent as the session request's query string. */\n  params?: Record<string, unknown> | undefined;\n  /** Base path of the session API, e.g. \"/api/v1\". */\n  basePath?: string | undefined;\n  /** Start/stop is the caller's: flipping this to false DELETEs the session. */\n  following?: boolean | undefined;\n  /** Rows kept in memory; older ones are evicted and counted in `droppedRows`. */\n  maxRows?: number | undefined;\n  /** Poll interval (ms) for the fallback transport. */\n  pollMs?: number | undefined;\n  /** Force polling even when EventSource exists (mainly tests). */\n  forcePoll?: boolean | undefined;\n}\n\nexport interface UseLogTailResult {\n  /** Accumulated rows, oldest first. */\n  rows: Record<string, unknown>[];\n  status: LogTailStatus;\n  error: LogTailError | null;\n  sessionId: string | null;\n  /** True while the caller wants rows and the session has not reached a terminal state. */\n  following: boolean;\n  /** Rows the cap evicted; non-zero means the tail no longer holds the whole run. */\n  droppedRows: number;\n  /** Highest sequence applied — the resume point a reconnect would ask for. */\n  lastSequence: number | null;\n  /** Latest SessionInfo the server sent, for eventCount / startedAt / state. */\n  session: LogSessionInfo | null;\n}\n\nconst DEFAULT_BASE = \"/api/v1\";\nconst DEFAULT_POLL_MS = 1_000;\nconst DEFAULT_MAX_ROWS = 5_000;\n\nfunction hasEventSource(): boolean {\n  return typeof globalThis !== \"undefined\" && typeof globalThis.EventSource !== \"undefined\";\n}\n\n/** DELETE the session. Exported because a caller that owns the id (a saved tail,\n *  a beforeunload handler) has to be able to release it without the hook. */\nexport async function stopLogSession(basePath: string, id: string): Promise<void> {\n  const res = await fetch(`${basePath}/sessions/${encodeURIComponent(id)}`, {\n    method: \"DELETE\",\n    keepalive: true,\n  });\n  if (!res.ok) {\n    throw new Error((await res.text()) || `stopping session ${id} failed with HTTP ${res.status}`);\n  }\n}\n\nexport function useLogTail(options: UseLogTailOptions): UseLogTailResult {\n  const {\n    profile,\n    params,\n    basePath = DEFAULT_BASE,\n    following: wantFollow = false,\n    maxRows = DEFAULT_MAX_ROWS,\n    pollMs = DEFAULT_POLL_MS,\n    forcePoll = false,\n  } = options;\n\n  const [buffer, setBuffer] = useState<LogTailBuffer>(emptyLogTailBuffer);\n  const [status, setStatus] = useState<LogTailStatus>(\"idle\");\n  const [error, setError] = useState<LogTailError | null>(null);\n  const [session, setSession] = useState<LogSessionInfo | null>(null);\n\n  // The cap is read when a frame lands rather than closed over, so changing how\n  // much history to keep never tears down a live session to do it.\n  const maxRowsRef = useRef(maxRows);\n  maxRowsRef.current = maxRows;\n\n  // Profile parameters travel in the query string because that is where the\n  // session endpoint reads them from: it builds its params by walking\n  // r.URL.Query() and never looks at the body, so a posted body is a filter the\n  // server silently ignores — the tail would run the profile's defaults while\n  // the reader believed they were following what they had filtered to.\n  //\n  // Serialized here rather than in the effect so it is also the effect's\n  // dependency: two renders with equal parameters must not restart the session.\n  const paramsQuery = encodeTailParams(params);\n\n  useEffect(() => {\n    if (!wantFollow) return;\n\n    // Each start is a distinct server session replaying from its own first\n    // sequence, so the previous run's rows cannot be continued — carrying them\n    // over would interleave two unrelated sequence spaces in one list.\n    setBuffer(emptyLogTailBuffer);\n    setError(null);\n    setSession(null);\n    setStatus(\"starting\");\n\n    let cancelled = false;\n    let source: EventSource | undefined;\n    let timer: ReturnType<typeof setTimeout> | undefined;\n    let liveSessionId: string | null = null;\n    let ended = false;\n\n    const apply = (event: LogTailEvent) => {\n      setBuffer((prev) => appendTailEvent(prev, event, maxRowsRef.current));\n      // An event-level error does not end the session, so it is reported beside\n      // the rows rather than in place of them.\n      if (event.error) setError({ scope: \"stream\", message: event.error });\n    };\n\n    // Unlike the task stream this does not skip what it cannot parse: a tail\n    // that silently discards frames is indistinguishable from a quiet log\n    // source, which is the one thing a reader must never be left guessing at.\n    const readFrame = (label: string, e: MessageEvent): unknown => {\n      try {\n        return JSON.parse(e.data as string);\n      } catch (cause) {\n        setError({ scope: \"stream\", message: `unparseable ${label} frame: ${String(cause)}` });\n        return undefined;\n      }\n    };\n\n    const settle = (info: LogSessionInfo) => {\n      setSession(info);\n      if (!isTerminalSessionState(info.state)) return;\n      ended = true;\n      setStatus(info.state as LogTailStatus);\n      if (info.state === \"failed\") {\n        setError({\n          scope: \"session\",\n          message: info.error || `session ${info.id} failed without reporting a reason`,\n        });\n      }\n    };\n\n    const subscribe = (id: string) => {\n      const es = new EventSource(`${basePath}/sessions/${encodeURIComponent(id)}/events`);\n      source = es;\n      setStatus(\"streaming\");\n      es.addEventListener(\"event\", (e) => {\n        const frame = readFrame(\"event\", e as MessageEvent);\n        if (frame) apply(frame as LogTailEvent);\n      });\n      es.addEventListener(\"done\", (e) => {\n        const info = readFrame(\"done\", e as MessageEvent);\n        if (info) settle(info as LogSessionInfo);\n        es.close();\n      });\n      // A dropped connection is not a failure: EventSource reconnects with\n      // Last-Event-ID and the server replays. It is reported through `status`\n      // only, so a blip never leaves a sticky error the reader has to dismiss —\n      // and never after the session ended, where it would overwrite the reason\n      // it ended with a reconnect that is not going to happen.\n      es.onerror = () => {\n        if (!ended) setStatus(\"connection lost — retrying\");\n      };\n    };\n\n    // The polling transport asks for the same replay the SSE reconnect gets:\n    // `after` is Last-Event-ID by another name.\n    const poll = (id: string) => {\n      let after: number | null = null;\n      const tick = async () => {\n        try {\n          const query = after === null ? \"\" : `?after=${after}`;\n          const res = await fetch(\n            `${basePath}/sessions/${encodeURIComponent(id)}/events${query}`,\n            { headers: { Accept: \"application/json\" } },\n          );\n          if (!res.ok) {\n            // A refused request is the session answering that it is gone or\n            // broken; retrying it forever would render as an empty tail.\n            ended = true;\n            setStatus(\"failed\");\n            setError({\n              scope: \"session\",\n              httpStatus: res.status,\n              message: `reading events for session ${id} failed with HTTP ${res.status}: ${\n                (await res.text()).trim() || \"no detail\"\n              }`,\n            });\n            return;\n          }\n          for (const event of (await res.json()) as LogTailEvent[]) {\n            apply(event);\n            if (after === null || event.sequence > after) after = event.sequence;\n          }\n          setStatus(\"polling\");\n        } catch {\n          setStatus(\"connection lost — retrying\");\n        }\n        if (!cancelled) timer = setTimeout(tick, pollMs);\n      };\n      void tick();\n    };\n\n    // Releasing can run while the component is already gone, so a failure here\n    // cannot be raised into state — but it is the failure that costs everyone\n    // else a session slot, so it is never swallowed either.\n    const release = (id: string) =>\n      stopLogSession(basePath, id).catch((cause: unknown) => {\n        console.error(`[useLogTail] could not stop follow session ${id}`, cause);\n      });\n\n    const start = async () => {\n      let info: LogSessionInfo;\n      try {\n        const res = await fetch(\n          `${basePath}/profile/${encodeURIComponent(profile)}/sessions?follow=true${paramsQuery}`,\n          { method: \"POST\", headers: { Accept: \"application/json\" } },\n        );\n        if (!res.ok) {\n          const detail = (await res.text()).trim() || \"no detail\";\n          setStatus(\"failed\");\n          setError({\n            scope: \"start\",\n            httpStatus: res.status,\n            message:\n              res.status === 409\n                ? `the server is already running as many follow sessions as it allows (HTTP 409): ${detail}`\n                : `could not start a follow session for ${profile} (HTTP ${res.status}): ${detail}`,\n          });\n          return;\n        }\n        info = (await res.json()) as LogSessionInfo;\n      } catch (cause) {\n        setStatus(\"failed\");\n        setError({\n          scope: \"start\",\n          message: `could not reach ${basePath} to start a follow session for ${profile}: ${String(cause)}`,\n        });\n        return;\n      }\n\n      if (cancelled) {\n        // The caller stopped following while the POST was in flight. The session\n        // exists on the server regardless, so it still has to be released.\n        void release(info.id);\n        return;\n      }\n      liveSessionId = info.id;\n      setSession(info);\n      if (forcePoll || !hasEventSource()) poll(info.id);\n      else subscribe(info.id);\n    };\n\n    void start();\n    // A session left running is not untidy, it is a slot the next reader cannot\n    // have — so it is released on every exit path, unmount included.\n    return () => {\n      cancelled = true;\n      if (timer) clearTimeout(timer);\n      source?.close();\n      if (liveSessionId && !ended) void release(liveSessionId);\n    };\n  }, [profile, paramsQuery, basePath, wantFollow, pollMs, forcePoll]);\n\n  // Stopping returns the surface to idle, but a session that ended on its own\n  // keeps its terminal status so the reason it ended stays on screen.\n  useEffect(() => {\n    if (!wantFollow) setStatus((prev) => (TERMINAL.has(prev) ? prev : \"idle\"));\n  }, [wantFollow]);\n\n  return {\n    rows: buffer.rows,\n    status,\n    error,\n    sessionId: session?.id ?? null,\n    following: wantFollow && !TERMINAL.has(status),\n    droppedRows: buffer.dropped,\n    lastSequence: buffer.lastSequence,\n    session,\n  };\n}\n"],"names":[],"mappings":"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"}
+{"version":3,"file":"use-log-tail.js","sources":["../../src/hooks/use-log-tail.ts"],"sourcesContent":["import { useEffect, useRef, useState } from \"react\";\nimport type { ClickyRow } from \"../data/Clicky\";\nimport { isSessionState, isSessionTerminal, type SessionState } from \"../rpc/sessionTypes\";\n\n// use-log-tail is the clicky-ui client for a *follow* session: the server opens\n// a live source for a query profile and streams rows out of it until someone\n// closes it. The resource underneath is unforgiving. A follow session holds a\n// websocket to Loki, or a log stream to a kubelet, for as long as it exists,\n// and the server caps how many may run at once (ErrMaxSessions, surfaced as\n// HTTP 409). The server owns that slot's release: a view session ends shortly\n// after its last subscriber disconnects, so every exit path — unmount and a\n// parameter change included — only has to abort the start request and close\n// the EventSource.\n//\n// Events travel over SSE only. The events route serves SSE (or ndjson on\n// request) and resumes through Last-Event-ID; there is no JSON-array polling\n// shape to fall back to, so a browser without EventSource fails loudly.\n//\n// Each SSE frame carries an `id:`, so a reconnecting EventSource sends\n// Last-Event-ID and the server resumes from that sequence — re-delivering\n// frames the client may already hold. Sequences are the server's, not a client\n// index: they do not start at 1 and they do not reset, so the accumulator\n// dedupes against the highest sequence it has applied rather than against a\n// position in an array.\n\n/** The sessions API's state, under the name this hook has always exported. */\nexport type LogSessionState = SessionState;\n\n/** SessionInfo as returned by POST /profile/{name}/sessions and the `done` frame. */\nexport interface LogSessionInfo {\n  id: string;\n  profile: string;\n  kind: string;\n  state: LogSessionState;\n  params?: Record<string, unknown>;\n  error?: string;\n  eventCount: number;\n  startedAt: string;\n  stoppedAt?: string;\n}\n\n/**\n * One `event:` frame. It carries either a single `row` or a batch under `rows`\n * — never both — plus an `error` when the source failed mid-stream without the\n * session itself ending.\n *\n * `clickyRow` is the presented row — `{cells, detail?}`, built by the exact\n * function that fills in `node.rows[n]` of the list's own\n * `application/json+clicky` document — riding next to the raw `row` on a\n * trace/follow session's per-row events. A plain log tail (or a top-session\n * snapshot event) never sets it; only a reader that reconciles rows against a\n * presented table, i.e. OperationCatalog's follow mode, depends on it.\n */\nexport interface LogTailEvent {\n  sessionId: string;\n  sequence: number;\n  time?: string;\n  row?: Record<string, unknown>;\n  rows?: Record<string, unknown>[];\n  /** The presented ClickyRow for `row`, when the profile sends one. */\n  clickyRow?: ClickyRow;\n  error?: string;\n}\n\n/**\n * Where a failure came from, because the three are not interchangeable to a\n * reader: `start` means the session never existed (409 is the cap), `stream`\n * means the session is alive but something in it went wrong, and `session`\n * means the server ended it.\n */\nexport interface LogTailError {\n  scope: \"start\" | \"stream\" | \"session\";\n  message: string;\n  /** HTTP status when a request produced the failure. 409 is the session cap. */\n  httpStatus?: number;\n}\n\n/** Renderable transport/session state. The terminal values are the server's own. */\nexport type LogTailStatus =\n  | \"idle\"\n  | \"starting\"\n  | \"streaming\"\n  | \"connection lost — retrying\"\n  | \"completed\"\n  | \"failed\"\n  | \"stopped\"\n  | \"interrupted\";\n\n/**\n * `stopping` is a stop in flight: the source may still flush rows, so the tail\n * keeps reading until the done frame.\n */\nexport function isTerminalSessionState(state: LogSessionState | undefined): boolean {\n  return state !== undefined && isSessionTerminal(state);\n}\n\nfunction isTerminalTailStatus(status: LogTailStatus): boolean {\n  return isSessionState(status) && isSessionTerminal(status);\n}\n\nexport interface LogTailBuffer {\n  /** Rows in arrival order, oldest first — the order this surface tails in. */\n  rows: Record<string, unknown>[];\n  /**\n   * Each entry's presented ClickyRow, index-aligned with `rows` (same length,\n   * same order) — `undefined` where the event carried none. Additive: a plain\n   * log tail never reads this and `rows` itself is unchanged, so existing\n   * `useLogTail` consumers keep working exactly as before.\n   */\n  clickyRows: (ClickyRow | undefined)[];\n  /** Highest sequence applied, or null before the first frame. Never assumed to start at 1. */\n  lastSequence: number | null;\n  /** Rows evicted by the cap. Kept so the UI can say so instead of quietly shortening history. */\n  dropped: number;\n}\n\nexport const emptyLogTailBuffer: LogTailBuffer = {\n  rows: [],\n  clickyRows: [],\n  lastSequence: null,\n  dropped: 0,\n};\n\n/**\n * Renders profile parameters as the tail of a session request's query string,\n * `\"\"` when there are none, and each entry already `&`-prefixed so it appends\n * to a query that always begins with `?follow=true`.\n *\n * Keys are sorted so two callers passing the same parameters in a different\n * order produce the same string — the effect that opens the session depends on\n * it, and an unstable spelling would tear down a live tail and start a new one\n * on a render that changed nothing.\n *\n * A null or undefined value is omitted rather than sent as the text \"null\": the\n * server reads every query key as a supplied parameter, so spelling an absent\n * one out states a filter the caller did not ask for.\n */\nexport function encodeTailParams(params: Record<string, unknown> | undefined): string {\n  if (!params) return \"\";\n  const query = new URLSearchParams();\n  for (const key of Object.keys(params).sort()) {\n    const value = params[key];\n    if (value === undefined || value === null) continue;\n    query.append(key, String(value));\n  }\n  const encoded = query.toString();\n  return encoded === \"\" ? \"\" : `&${encoded}`;\n}\n\n/**\n * Applies one frame to the buffer, dropping anything at or below the highest\n * sequence already seen. A watermark is enough — and cheaper than remembering\n * every id — because SSE is ordered within a connection and the only source of\n * duplicates is a reconnect, whose replay starts at Last-Event-ID and so can\n * only re-deliver frames the buffer has already passed.\n *\n * Returns the buffer unchanged when the frame adds nothing, so React can bail\n * out of the render.\n */\nexport function appendTailEvent(\n  buffer: LogTailBuffer,\n  event: LogTailEvent,\n  maxRows: number,\n): LogTailBuffer {\n  if (buffer.lastSequence !== null && event.sequence <= buffer.lastSequence) return buffer;\n  const incoming = event.rows ?? (event.row ? [event.row] : []);\n  if (incoming.length === 0) return { ...buffer, lastSequence: event.sequence };\n\n  // A batched `rows` frame has no per-item clickyRow equivalent — only the\n  // single-`row` shape trace/follow sessions use ever carries one — so a\n  // batch pads with `undefined` to stay index-aligned with `rows`.\n  const incomingClickyRows: (ClickyRow | undefined)[] = event.rows\n    ? event.rows.map(() => undefined)\n    : [event.clickyRow];\n\n  const merged = buffer.rows.concat(incoming);\n  const mergedClickyRows = buffer.clickyRows.concat(incomingClickyRows);\n  const overflow = Math.max(0, merged.length - Math.max(1, maxRows));\n  return {\n    rows: overflow > 0 ? merged.slice(overflow) : merged,\n    clickyRows: overflow > 0 ? mergedClickyRows.slice(overflow) : mergedClickyRows,\n    lastSequence: event.sequence,\n    dropped: buffer.dropped + overflow,\n  };\n}\n\nexport interface UseLogTailOptions {\n  /** Query profile to follow, e.g. \"k8s-pod-logs\". */\n  profile: string;\n  /** Profile parameters, sent as the session request's query string. */\n  params?: Record<string, unknown> | undefined;\n  /** Base path of the session API, e.g. \"/api/v1\". */\n  basePath?: string | undefined;\n  /** Start/stop is the caller's: flipping this to false closes the stream; the server reaps the unsubscribed session. */\n  following?: boolean | undefined;\n  /** Rows kept in memory; older ones are evicted and counted in `droppedRows`. */\n  maxRows?: number | undefined;\n  /**\n   * Called once per applied `event` frame, in sequence order, before the frame\n   * reaches the buffer — so a reducer sees every row even after `maxRows` starts\n   * evicting. A replayed sequence is not delivered again, and `done` frames are\n   * never delivered. The latest callback is always used; changing its identity\n   * does not restart the session. A throw is reported as a `stream` error.\n   */\n  onEvent?: ((event: LogTailEvent) => void) | undefined;\n}\n\nexport interface UseLogTailResult {\n  /** Accumulated rows, oldest first. */\n  rows: Record<string, unknown>[];\n  /** Each row's presented ClickyRow, index-aligned with `rows`; `undefined`\n   *  where the event carried none (a plain log tail, or a top-session\n   *  snapshot event). */\n  clickyRows: (ClickyRow | undefined)[];\n  status: LogTailStatus;\n  error: LogTailError | null;\n  sessionId: string | null;\n  /** True while the caller wants rows and the session has not reached a terminal state. */\n  following: boolean;\n  /** Rows the cap evicted; non-zero means the tail no longer holds the whole run. */\n  droppedRows: number;\n  /** Highest sequence applied — the resume point a reconnect would ask for. */\n  lastSequence: number | null;\n  /** Latest SessionInfo the server sent, for eventCount / startedAt / state. */\n  session: LogSessionInfo | null;\n}\n\nconst DEFAULT_BASE = \"/api/v1\";\nconst DEFAULT_MAX_ROWS = 5_000;\n\nfunction hasEventSource(): boolean {\n  return typeof globalThis !== \"undefined\" && typeof globalThis.EventSource !== \"undefined\";\n}\n\nexport function useLogTail(options: UseLogTailOptions): UseLogTailResult {\n  const {\n    profile,\n    params,\n    basePath = DEFAULT_BASE,\n    following: wantFollow = false,\n    maxRows = DEFAULT_MAX_ROWS,\n    onEvent,\n  } = options;\n\n  const [buffer, setBuffer] = useState<LogTailBuffer>(emptyLogTailBuffer);\n  const [status, setStatus] = useState<LogTailStatus>(\"idle\");\n  const [error, setError] = useState<LogTailError | null>(null);\n  const [session, setSession] = useState<LogSessionInfo | null>(null);\n\n  // The cap is read when a frame lands rather than closed over, so changing how\n  // much history to keep never tears down a live session to do it.\n  const maxRowsRef = useRef(maxRows);\n  maxRowsRef.current = maxRows;\n  const onEventRef = useRef(onEvent);\n  onEventRef.current = onEvent;\n\n  // Profile parameters travel in the query string because that is where the\n  // session endpoint reads them from: it builds its params by walking\n  // r.URL.Query() and never looks at the body, so a posted body is a filter the\n  // server silently ignores — the tail would run the profile's defaults while\n  // the reader believed they were following what they had filtered to.\n  //\n  // Serialized here rather than in the effect so it is also the effect's\n  // dependency: two renders with equal parameters must not restart the session.\n  const paramsQuery = encodeTailParams(params);\n\n  useEffect(() => {\n    if (!wantFollow) return;\n\n    // Each start is a distinct server session replaying from its own first\n    // sequence, so the previous run's rows cannot be continued — carrying them\n    // over would interleave two unrelated sequence spaces in one list.\n    setBuffer(emptyLogTailBuffer);\n    setError(null);\n    setSession(null);\n\n    // Checked before the session exists: a session nobody can subscribe to\n    // would hold a server slot until the reaper noticed.\n    if (!hasEventSource()) {\n      setStatus(\"failed\");\n      setError({\n        scope: \"start\",\n        message: `cannot follow ${profile}: this browser has no EventSource, and session events are served only as SSE`,\n      });\n      return;\n    }\n    setStatus(\"starting\");\n\n    let cancelled = false;\n    const aborter = new AbortController();\n    let source: EventSource | undefined;\n    let ended = false;\n    // onEvent's own watermark, tracked here rather than read from the buffer:\n    // the buffer only dedupes inside a state updater, which React may run twice,\n    // so a callback there would double-count. Same rule as appendTailEvent.\n    let delivered: number | null = null;\n\n    const deliver = (event: LogTailEvent) => {\n      if (delivered !== null && event.sequence <= delivered) return;\n      delivered = event.sequence;\n      try {\n        onEventRef.current?.(event);\n      } catch (cause) {\n        setError({ scope: \"stream\", message: `onEvent threw on sequence ${event.sequence}: ${String(cause)}` });\n      }\n    };\n\n    const apply = (event: LogTailEvent) => {\n      // An event-level error does not end the session, so it is reported beside\n      // the rows rather than in place of them. Set before delivery so a reducer\n      // that throws on the same frame is the error left standing.\n      if (event.error) setError({ scope: \"stream\", message: event.error });\n      deliver(event);\n      setBuffer((prev) => appendTailEvent(prev, event, maxRowsRef.current));\n    };\n\n    // Unlike the task stream this does not skip what it cannot parse: a tail\n    // that silently discards frames is indistinguishable from a quiet log\n    // source, which is the one thing a reader must never be left guessing at.\n    const readFrame = (label: string, e: MessageEvent): unknown => {\n      try {\n        return JSON.parse(e.data as string);\n      } catch (cause) {\n        setError({ scope: \"stream\", message: `unparseable ${label} frame: ${String(cause)}` });\n        return undefined;\n      }\n    };\n\n    const settle = (info: LogSessionInfo) => {\n      setSession(info);\n      if (!isTerminalSessionState(info.state)) return;\n      ended = true;\n      setStatus(info.state as LogTailStatus);\n      if (info.state === \"failed\") {\n        setError({\n          scope: \"session\",\n          message: info.error || `session ${info.id} failed without reporting a reason`,\n        });\n      }\n    };\n\n    const subscribe = (id: string) => {\n      const es = new EventSource(`${basePath}/sessions/${encodeURIComponent(id)}/events`);\n      source = es;\n      setStatus(\"streaming\");\n      es.addEventListener(\"event\", (e) => {\n        const frame = readFrame(\"event\", e as MessageEvent);\n        if (frame) apply(frame as LogTailEvent);\n      });\n      es.addEventListener(\"done\", (e) => {\n        const info = readFrame(\"done\", e as MessageEvent);\n        if (info) settle(info as LogSessionInfo);\n        es.close();\n      });\n      // A dropped connection is not a failure: EventSource reconnects with\n      // Last-Event-ID and the server replays. It is reported through `status`\n      // only, so a blip never leaves a sticky error the reader has to dismiss —\n      // and never after the session ended, where it would overwrite the reason\n      // it ended with a reconnect that is not going to happen.\n      es.onerror = () => {\n        if (!ended) setStatus(\"connection lost — retrying\");\n      };\n    };\n\n    const start = async () => {\n      let info: LogSessionInfo;\n      try {\n        const res = await fetch(\n          `${basePath}/profile/${encodeURIComponent(profile)}/sessions?follow=true${paramsQuery}`,\n          { method: \"POST\", headers: { Accept: \"application/json\" }, signal: aborter.signal },\n        );\n        if (cancelled) return;\n        if (!res.ok) {\n          const detail = (await res.text()).trim() || \"no detail\";\n          setStatus(\"failed\");\n          setError({\n            scope: \"start\",\n            httpStatus: res.status,\n            message:\n              res.status === 409\n                ? `the server is already running as many follow sessions as it allows (HTTP 409): ${detail}`\n                : `could not start a follow session for ${profile} (HTTP ${res.status}): ${detail}`,\n          });\n          return;\n        }\n        info = (await res.json()) as LogSessionInfo;\n      } catch (cause) {\n        // Our own abort on unmount or a parameter change: nothing is left to report to.\n        if (cancelled) return;\n        setStatus(\"failed\");\n        setError({\n          scope: \"start\",\n          message: `could not reach ${basePath} to start a follow session for ${profile}: ${String(cause)}`,\n        });\n        return;\n      }\n\n      // The caller stopped following while the POST was in flight. If the\n      // session was created, nothing ever subscribes, so the server ends it.\n      if (cancelled) return;\n      setSession(info);\n      subscribe(info.id);\n    };\n\n    void start();\n    // Aborting the start and closing the stream is the whole release: a view\n    // session without a subscriber ends server-side.\n    return () => {\n      cancelled = true;\n      aborter.abort();\n      source?.close();\n    };\n  }, [profile, paramsQuery, basePath, wantFollow]);\n\n  // Stopping returns the surface to idle, but a session that ended on its own\n  // keeps its terminal status so the reason it ended stays on screen.\n  useEffect(() => {\n    if (!wantFollow) setStatus((prev) => (isTerminalTailStatus(prev) ? prev : \"idle\"));\n  }, [wantFollow]);\n\n  return {\n    rows: buffer.rows,\n    clickyRows: buffer.clickyRows,\n    status,\n    error,\n    sessionId: session?.id ?? null,\n    following: wantFollow && !isTerminalTailStatus(status),\n    droppedRows: buffer.dropped,\n    lastSequence: buffer.lastSequence,\n    session,\n  };\n}\n"],"names":[],"mappings":"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"}

package/dist/hooks/use-media-query.cjs

@@ -0,0 +1,41 @@
+"use strict";
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+const react = require("react");
+function mediaMatches(query) {
+  const media = queryList(query);
+  return media ? media.matches : false;
+}
+function onMediaChange(query, onChange) {
+  var _a;
+  const media = queryList(query);
+  if (!media) return () => {
+  };
+  const listener = () => onChange(media.matches);
+  if (media.addEventListener) {
+    media.addEventListener("change", listener);
+    return () => media.removeEventListener("change", listener);
+  }
+  (_a = media.addListener) == null ? void 0 : _a.call(media, listener);
+  return () => {
+    var _a2;
+    return (_a2 = media.removeListener) == null ? void 0 : _a2.call(media, listener);
+  };
+}
+function useMediaQuery(query) {
+  const [matches, setMatches] = react.useState(() => mediaMatches(query));
+  react.useEffect(() => {
+    setMatches(mediaMatches(query));
+    return onMediaChange(query, setMatches);
+  }, [query]);
+  return matches;
+}
+function queryList(query) {
+  if (typeof window === "undefined" || typeof window.matchMedia !== "function") {
+    return null;
+  }
+  return window.matchMedia(query);
+}
+exports.mediaMatches = mediaMatches;
+exports.onMediaChange = onMediaChange;
+exports.useMediaQuery = useMediaQuery;
+//# sourceMappingURL=use-media-query.cjs.map

package/dist/hooks/use-media-query.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-media-query.cjs","sources":["../../src/hooks/use-media-query.ts"],"sourcesContent":["import { useEffect, useState } from \"react\";\n\n/**\n * One place that asks the environment a media question, for every component in\n * this library that needs one.\n *\n * `window.matchMedia` is not universally present. jsdom does not implement it\n * at all, which matters more than it sounds: this library's own suite installs\n * a stub in `src/test/setup.ts`, so an unguarded call passes here and then\n * throws `window.matchMedia is not a function` in every CONSUMER's test file\n * that happens to render the component. That failure names the consumer's test,\n * not the component, so it reads as their regression rather than ours. It is\n * also absent during SSR, where there is no window at all.\n *\n * The rule these helpers encode: a media query that cannot be asked answers\n * FALSE. Every query in this library is phrased so false is the safe default —\n * not a narrow viewport, not reduced motion, not a dark colour scheme — so a\n * component in an environment that cannot answer renders the ordinary desktop,\n * full-motion, light case rather than failing.\n */\n\n/** Whether the environment matches `query` right now. False when it cannot be asked. */\nexport function mediaMatches(query: string): boolean {\n  const media = queryList(query);\n  return media ? media.matches : false;\n}\n\n/**\n * Calls `onChange` whenever `query` starts or stops matching, and returns an\n * unsubscribe.\n *\n * The unsubscribe is always callable, including where matchMedia is missing:\n * callers invoke it from a React cleanup, which runs whether or not the\n * subscribe did anything, so returning nothing would turn an absent API into a\n * crash on unmount.\n */\nexport function onMediaChange(\n  query: string,\n  onChange: (matches: boolean) => void,\n): () => void {\n  const media = queryList(query);\n  if (!media) return () => {};\n\n  const listener = () => onChange(media.matches);\n  // addEventListener is the modern form; addListener is deprecated but is all\n  // Safari before 14 has, and dropping it would silently stop theme switching\n  // there rather than fail visibly.\n  if (media.addEventListener) {\n    media.addEventListener(\"change\", listener);\n    return () => media.removeEventListener(\"change\", listener);\n  }\n  media.addListener?.(listener);\n  return () => media.removeListener?.(listener);\n}\n\n/** `mediaMatches` as a hook: re-renders when the answer changes. */\nexport function useMediaQuery(query: string): boolean {\n  const [matches, setMatches] = useState(() => mediaMatches(query));\n\n  useEffect(() => {\n    // Re-read on subscribe: the query may have changed, or the environment may\n    // have moved between the initial render and this effect.\n    setMatches(mediaMatches(query));\n    return onMediaChange(query, setMatches);\n  }, [query]);\n\n  return matches;\n}\n\nfunction queryList(query: string): MediaQueryList | null {\n  if (typeof window === \"undefined\" || typeof window.matchMedia !== \"function\") {\n    return null;\n  }\n  return window.matchMedia(query);\n}\n"],"names":["_a","useState","useEffect"],"mappings":";;;AAsBO,SAAS,aAAa,OAAwB;AACnD,QAAM,QAAQ,UAAU,KAAK;AAC7B,SAAO,QAAQ,MAAM,UAAU;AACjC;AAWO,SAAS,cACd,OACA,UACY;;AACZ,QAAM,QAAQ,UAAU,KAAK;AAC7B,MAAI,CAAC,MAAO,QAAO,MAAM;AAAA,EAAC;AAE1B,QAAM,WAAW,MAAM,SAAS,MAAM,OAAO;AAI7C,MAAI,MAAM,kBAAkB;AAC1B,UAAM,iBAAiB,UAAU,QAAQ;AACzC,WAAO,MAAM,MAAM,oBAAoB,UAAU,QAAQ;AAAA,EAC3D;AACA,cAAM,gBAAN,+BAAoB;AACpB,SAAO,MAAA;;AAAM,YAAAA,MAAA,MAAM,mBAAN,gBAAAA,IAAA,YAAuB;AAAA;AACtC;AAGO,SAAS,cAAc,OAAwB;AACpD,QAAM,CAAC,SAAS,UAAU,IAAIC,MAAAA,SAAS,MAAM,aAAa,KAAK,CAAC;AAEhEC,QAAAA,UAAU,MAAM;AAGd,eAAW,aAAa,KAAK,CAAC;AAC9B,WAAO,cAAc,OAAO,UAAU;AAAA,EACxC,GAAG,CAAC,KAAK,CAAC;AAEV,SAAO;AACT;AAEA,SAAS,UAAU,OAAsC;AACvD,MAAI,OAAO,WAAW,eAAe,OAAO,OAAO,eAAe,YAAY;AAC5E,WAAO;AAAA,EACT;AACA,SAAO,OAAO,WAAW,KAAK;AAChC;;;;"}

package/dist/hooks/use-media-query.d.ts

@@ -0,0 +1,33 @@
+/**
+ * One place that asks the environment a media question, for every component in
+ * this library that needs one.
+ *
+ * `window.matchMedia` is not universally present. jsdom does not implement it
+ * at all, which matters more than it sounds: this library's own suite installs
+ * a stub in `src/test/setup.ts`, so an unguarded call passes here and then
+ * throws `window.matchMedia is not a function` in every CONSUMER's test file
+ * that happens to render the component. That failure names the consumer's test,
+ * not the component, so it reads as their regression rather than ours. It is
+ * also absent during SSR, where there is no window at all.
+ *
+ * The rule these helpers encode: a media query that cannot be asked answers
+ * FALSE. Every query in this library is phrased so false is the safe default —
+ * not a narrow viewport, not reduced motion, not a dark colour scheme — so a
+ * component in an environment that cannot answer renders the ordinary desktop,
+ * full-motion, light case rather than failing.
+ */
+/** Whether the environment matches `query` right now. False when it cannot be asked. */
+export declare function mediaMatches(query: string): boolean;
+/**
+ * Calls `onChange` whenever `query` starts or stops matching, and returns an
+ * unsubscribe.
+ *
+ * The unsubscribe is always callable, including where matchMedia is missing:
+ * callers invoke it from a React cleanup, which runs whether or not the
+ * subscribe did anything, so returning nothing would turn an absent API into a
+ * crash on unmount.
+ */
+export declare function onMediaChange(query: string, onChange: (matches: boolean) => void): () => void;
+/** `mediaMatches` as a hook: re-renders when the answer changes. */
+export declare function useMediaQuery(query: string): boolean;
+//# sourceMappingURL=use-media-query.d.ts.map

package/dist/hooks/use-media-query.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-media-query.d.ts","sourceRoot":"","sources":["../../src/hooks/use-media-query.ts"],"names":[],"mappings":"AAEA;;;;;;;;;;;;;;;;;GAiBG;AAEH,wFAAwF;AACxF,wBAAgB,YAAY,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAGnD;AAED;;;;;;;;GAQG;AACH,wBAAgB,aAAa,CAC3B,KAAK,EAAE,MAAM,EACb,QAAQ,EAAE,CAAC,OAAO,EAAE,OAAO,KAAK,IAAI,GACnC,MAAM,IAAI,CAcZ;AAED,oEAAoE;AACpE,wBAAgB,aAAa,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAWpD"}

package/dist/hooks/use-media-query.js

@@ -0,0 +1,41 @@
+import { useState, useEffect } from "react";
+function mediaMatches(query) {
+  const media = queryList(query);
+  return media ? media.matches : false;
+}
+function onMediaChange(query, onChange) {
+  var _a;
+  const media = queryList(query);
+  if (!media) return () => {
+  };
+  const listener = () => onChange(media.matches);
+  if (media.addEventListener) {
+    media.addEventListener("change", listener);
+    return () => media.removeEventListener("change", listener);
+  }
+  (_a = media.addListener) == null ? void 0 : _a.call(media, listener);
+  return () => {
+    var _a2;
+    return (_a2 = media.removeListener) == null ? void 0 : _a2.call(media, listener);
+  };
+}
+function useMediaQuery(query) {
+  const [matches, setMatches] = useState(() => mediaMatches(query));
+  useEffect(() => {
+    setMatches(mediaMatches(query));
+    return onMediaChange(query, setMatches);
+  }, [query]);
+  return matches;
+}
+function queryList(query) {
+  if (typeof window === "undefined" || typeof window.matchMedia !== "function") {
+    return null;
+  }
+  return window.matchMedia(query);
+}
+export {
+  mediaMatches,
+  onMediaChange,
+  useMediaQuery
+};
+//# sourceMappingURL=use-media-query.js.map

package/dist/hooks/use-media-query.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-media-query.js","sources":["../../src/hooks/use-media-query.ts"],"sourcesContent":["import { useEffect, useState } from \"react\";\n\n/**\n * One place that asks the environment a media question, for every component in\n * this library that needs one.\n *\n * `window.matchMedia` is not universally present. jsdom does not implement it\n * at all, which matters more than it sounds: this library's own suite installs\n * a stub in `src/test/setup.ts`, so an unguarded call passes here and then\n * throws `window.matchMedia is not a function` in every CONSUMER's test file\n * that happens to render the component. That failure names the consumer's test,\n * not the component, so it reads as their regression rather than ours. It is\n * also absent during SSR, where there is no window at all.\n *\n * The rule these helpers encode: a media query that cannot be asked answers\n * FALSE. Every query in this library is phrased so false is the safe default —\n * not a narrow viewport, not reduced motion, not a dark colour scheme — so a\n * component in an environment that cannot answer renders the ordinary desktop,\n * full-motion, light case rather than failing.\n */\n\n/** Whether the environment matches `query` right now. False when it cannot be asked. */\nexport function mediaMatches(query: string): boolean {\n  const media = queryList(query);\n  return media ? media.matches : false;\n}\n\n/**\n * Calls `onChange` whenever `query` starts or stops matching, and returns an\n * unsubscribe.\n *\n * The unsubscribe is always callable, including where matchMedia is missing:\n * callers invoke it from a React cleanup, which runs whether or not the\n * subscribe did anything, so returning nothing would turn an absent API into a\n * crash on unmount.\n */\nexport function onMediaChange(\n  query: string,\n  onChange: (matches: boolean) => void,\n): () => void {\n  const media = queryList(query);\n  if (!media) return () => {};\n\n  const listener = () => onChange(media.matches);\n  // addEventListener is the modern form; addListener is deprecated but is all\n  // Safari before 14 has, and dropping it would silently stop theme switching\n  // there rather than fail visibly.\n  if (media.addEventListener) {\n    media.addEventListener(\"change\", listener);\n    return () => media.removeEventListener(\"change\", listener);\n  }\n  media.addListener?.(listener);\n  return () => media.removeListener?.(listener);\n}\n\n/** `mediaMatches` as a hook: re-renders when the answer changes. */\nexport function useMediaQuery(query: string): boolean {\n  const [matches, setMatches] = useState(() => mediaMatches(query));\n\n  useEffect(() => {\n    // Re-read on subscribe: the query may have changed, or the environment may\n    // have moved between the initial render and this effect.\n    setMatches(mediaMatches(query));\n    return onMediaChange(query, setMatches);\n  }, [query]);\n\n  return matches;\n}\n\nfunction queryList(query: string): MediaQueryList | null {\n  if (typeof window === \"undefined\" || typeof window.matchMedia !== \"function\") {\n    return null;\n  }\n  return window.matchMedia(query);\n}\n"],"names":["_a"],"mappings":";AAsBO,SAAS,aAAa,OAAwB;AACnD,QAAM,QAAQ,UAAU,KAAK;AAC7B,SAAO,QAAQ,MAAM,UAAU;AACjC;AAWO,SAAS,cACd,OACA,UACY;;AACZ,QAAM,QAAQ,UAAU,KAAK;AAC7B,MAAI,CAAC,MAAO,QAAO,MAAM;AAAA,EAAC;AAE1B,QAAM,WAAW,MAAM,SAAS,MAAM,OAAO;AAI7C,MAAI,MAAM,kBAAkB;AAC1B,UAAM,iBAAiB,UAAU,QAAQ;AACzC,WAAO,MAAM,MAAM,oBAAoB,UAAU,QAAQ;AAAA,EAC3D;AACA,cAAM,gBAAN,+BAAoB;AACpB,SAAO,MAAA;;AAAM,YAAAA,MAAA,MAAM,mBAAN,gBAAAA,IAAA,YAAuB;AAAA;AACtC;AAGO,SAAS,cAAc,OAAwB;AACpD,QAAM,CAAC,SAAS,UAAU,IAAI,SAAS,MAAM,aAAa,KAAK,CAAC;AAEhE,YAAU,MAAM;AAGd,eAAW,aAAa,KAAK,CAAC;AAC9B,WAAO,cAAc,OAAO,UAAU;AAAA,EACxC,GAAG,CAAC,KAAK,CAAC;AAEV,SAAO;AACT;AAEA,SAAS,UAAU,OAAsC;AACvD,MAAI,OAAO,WAAW,eAAe,OAAO,OAAO,eAAe,YAAY;AAC5E,WAAO;AAAA,EACT;AACA,SAAO,OAAO,WAAW,KAAK;AAChC;"}

package/dist/hooks/use-task-run.cjs

@@ -2,6 +2,7 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
 const react = require("react");
 const TaskSnapshot = require("../data/TaskSnapshot.cjs");
+const taskStreams = require("../data/task-streams.cjs");
 const taskQueryKeys = require("../data/task-query-keys.cjs");
 const DEFAULT_BASE = "/api/v1";
 const DEFAULT_POLL_MS = 2e3;
@@ -22,18 +23,24 @@ function useTaskRun(options = {}) {
     forcePoll = false
   } = options;
   const runIdsKey = ((ids == null ? void 0 : ids.filter(Boolean)) ?? (id ? [id] : [])).join(",");
+  const subscriptionKey = JSON.stringify([runIdsKey, kind ?? "", basePath, enabled]);
+  const [stateKey, setStateKey] = react.useState(subscriptionKey);
   const [byId, setById] = react.useState({});
+  const [streamsById, setStreamsById] = react.useState({});
   const [status, setStatus] = react.useState("idle");
   const [isComplete, setIsComplete] = react.useState(false);
   react.useEffect(() => {
     const runIds = runIdsKey ? runIdsKey.split(",") : [];
+    setStateKey(subscriptionKey);
     if (!enabled || runIds.length === 0 && !kind) {
       setById({});
+      setStreamsById({});
       setStatus("idle");
       setIsComplete(false);
       return;
     }
     setById({});
+    setStreamsById({});
     setIsComplete(false);
     const params = new URLSearchParams();
     if (runIds.length > 0) params.set("tasks", runIdsKey);
@@ -47,20 +54,10 @@ function useTaskRun(options = {}) {
       });
     };
     const mergeOutput = (delta) => {
-      setById((prev) => {
-        const snapshot = prev[delta.id];
-        if (!snapshot) return prev;
-        const value = delta.reset ? delta.data : `${snapshot[delta.stream] ?? ""}${delta.data}`;
-        const truncatedField = delta.stream === "stdout" ? "stdoutTruncated" : "stderrTruncated";
-        return {
-          ...prev,
-          [delta.id]: {
-            ...snapshot,
-            [delta.stream]: value,
-            [truncatedField]: delta.truncated ?? snapshot[truncatedField]
-          }
-        };
-      });
+      setStreamsById((prev) => ({
+        ...prev,
+        [delta.id]: taskStreams.applyTaskOutputDelta(prev[delta.id] ?? taskStreams.emptyTaskStreams, delta)
+      }));
     };
     if (forcePoll || !hasEventSource()) {
       let stopped = false;
@@ -120,8 +117,13 @@ function useTaskRun(options = {}) {
     });
     es.onerror = () => setStatus("connection lost — retrying");
     return () => es.close();
-  }, [runIdsKey, kind, basePath, enabled, pollMs, forcePoll]);
-  return { snapshots: Object.values(byId), status, isComplete };
+  }, [subscriptionKey, runIdsKey, kind, basePath, enabled, pollMs, forcePoll]);
+  const current = stateKey === subscriptionKey;
+  const snapshots = react.useMemo(
+    () => current ? Object.values(byId).map((snapshot) => taskStreams.withTaskStreams(snapshot, streamsById[snapshot.id])) : [],
+    [current, byId, streamsById]
+  );
+  return { snapshots, status: current ? status : "idle", isComplete: current && isComplete };
 }
 function useTaskRuns(options = {}) {
   const {

package/dist/hooks/use-task-run.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"use-task-run.cjs","sources":["../../src/hooks/use-task-run.ts"],"sourcesContent":["import { useEffect, useState } from \"react\";\nimport {\n  allGroupsTerminal,\n  type TaskRunMeta,\n  type TaskSnapshot,\n} from \"../data/TaskSnapshot\";\nimport { taskQueryKeys } from \"../data/task-query-keys\";\n\n// use-task-run / use-task-runs are the generic clicky-ui task clients. They are\n// SSE-first: they subscribe to clicky's SSEHandler (event: task / event: done)\n// and fall back to polling the JSON endpoints only when EventSource is\n// unavailable. They speak only TaskSnapshot / TaskRunMeta — no app concepts.\n\nexport interface TaskTransportOptions {\n  /** Base path of the clicky task API, e.g. \"/api/v1\". */\n  basePath?: string | undefined;\n  /** Disable the subscription entirely (e.g. before an id is known). */\n  enabled?: boolean | undefined;\n  /** Poll interval (ms) for the fallback / runs listing. */\n  pollMs?: number | undefined;\n  /** Force the polling transport even when EventSource exists (mainly tests). */\n  forcePoll?: boolean | undefined;\n}\n\nconst DEFAULT_BASE = \"/api/v1\";\nconst DEFAULT_POLL_MS = 2_000;\n\nfunction streamUrl(base: string, query: string): string {\n  return `${base}/tasks/stream${query ? `?${query}` : \"\"}`;\n}\n\nfunction hasEventSource(): boolean {\n  return typeof globalThis !== \"undefined\" && typeof globalThis.EventSource !== \"undefined\";\n}\n\nexport interface UseTaskRunResult {\n  snapshots: TaskSnapshot[];\n  status: string;\n  isComplete: boolean;\n}\n\nexport interface UseTaskRunOptions extends TaskTransportOptions {\n  /** Stable run id to follow (drill-down). Mutually exclusive with ids/kind. */\n  id?: string | undefined;\n  /** Stable run ids to follow together. Mutually exclusive with id/kind. */\n  ids?: string[] | undefined;\n  /** Follow every run of a kind. */\n  kind?: string | undefined;\n}\n\n// useTaskRun follows one or more runs (by id) or a kind, SSE-first. It accumulates the\n// latest snapshot per task/group id and reports completion once every group is\n// terminal.\nexport function useTaskRun(options: UseTaskRunOptions = {}): UseTaskRunResult {\n  const {\n    id,\n    ids,\n    kind,\n    basePath = DEFAULT_BASE,\n    enabled = true,\n    pollMs = DEFAULT_POLL_MS,\n    forcePoll = false,\n  } = options;\n  const runIdsKey = (ids?.filter(Boolean) ?? (id ? [id] : [])).join(\",\");\n\n  const [byId, setById] = useState<Record<string, TaskSnapshot>>({});\n  const [status, setStatus] = useState(\"idle\");\n  const [isComplete, setIsComplete] = useState(false);\n\n  useEffect(() => {\n    const runIds = runIdsKey ? runIdsKey.split(\",\") : [];\n    if (!enabled || (runIds.length === 0 && !kind)) {\n      setById({});\n      setStatus(\"idle\");\n      setIsComplete(false);\n      return;\n    }\n    setById({});\n    setIsComplete(false);\n\n    const params = new URLSearchParams();\n    if (runIds.length > 0) params.set(\"tasks\", runIdsKey);\n    if (kind) params.set(\"kind\", kind);\n    const query = params.toString();\n\n    const merge = (incoming: TaskSnapshot[]) => {\n      setById((prev) => {\n        const next = { ...prev };\n        for (const snap of incoming) next[snap.type === \"group\" ? `group:${snap.groupId ?? snap.id}` : snap.id] = snap;\n        return next;\n      });\n    };\n\n    const mergeOutput = (delta: {\n      id: string;\n      stream: \"stdout\" | \"stderr\";\n      data: string;\n      reset?: boolean;\n      truncated?: boolean;\n    }) => {\n      setById((prev) => {\n        const snapshot = prev[delta.id];\n        if (!snapshot) return prev;\n        const value = delta.reset ? delta.data : `${snapshot[delta.stream] ?? \"\"}${delta.data}`;\n        const truncatedField = delta.stream === \"stdout\" ? \"stdoutTruncated\" : \"stderrTruncated\";\n        return {\n          ...prev,\n          [delta.id]: {\n            ...snapshot,\n            [delta.stream]: value,\n            [truncatedField]: delta.truncated ?? snapshot[truncatedField],\n          },\n        };\n      });\n    };\n\n    // Polling fallback transport.\n    if (forcePoll || !hasEventSource()) {\n      let stopped = false;\n      let timer: ReturnType<typeof setTimeout> | undefined;\n      const tick = async () => {\n        try {\n          const responses = await Promise.all(runIds.map((runId) => fetch(\n            `${basePath}/tasks/${encodeURIComponent(runId)}`,\n            { headers: { Accept: \"application/json\" } },\n          )));\n          if (responses.some((response) => !response.ok)) throw new Error(\"Task request failed\");\n          if (responses.every((response) => response.ok)) {\n            const snaps = (await Promise.all(responses.map(\n              async (response) => (await response.json()) as TaskSnapshot[],\n            ))).flat();\n            if (stopped) return;\n            merge(snaps);\n            setStatus(\"polling\");\n            if (allGroupsTerminal(snaps)) {\n              setIsComplete(true);\n              return; // stop polling\n            }\n          }\n        } catch {\n          if (!stopped) setStatus(\"connection lost — retrying\");\n        }\n        if (!stopped) timer = setTimeout(tick, pollMs);\n      };\n      void tick();\n      return () => {\n        stopped = true;\n        if (timer) clearTimeout(timer);\n      };\n    }\n\n    // SSE transport (default).\n    const es = new EventSource(streamUrl(basePath, query));\n    setStatus(\"connecting\");\n    es.onopen = () => setStatus(\"connected\");\n    es.addEventListener(\"task\", (e) => {\n      try {\n        merge([JSON.parse((e as MessageEvent).data) as TaskSnapshot]);\n        setStatus(\"connected\");\n      } catch {\n        setStatus(\"invalid task stream data\");\n      }\n    });\n    es.addEventListener(\"output\", (e) => {\n      try {\n        mergeOutput(JSON.parse((e as MessageEvent).data) as Parameters<typeof mergeOutput>[0]);\n      } catch {\n        setStatus(\"invalid task output data\");\n      }\n    });\n    es.addEventListener(\"done\", () => {\n      setStatus(\"complete\");\n      setIsComplete(true);\n      es.close();\n    });\n    es.onerror = () => setStatus(\"connection lost — retrying\");\n    return () => es.close();\n  }, [runIdsKey, kind, basePath, enabled, pollMs, forcePoll]);\n\n  return { snapshots: Object.values(byId), status, isComplete };\n}\n\nexport interface UseTaskRunsOptions extends TaskTransportOptions {\n  kind?: string | undefined;\n  status?: string | undefined;\n  /** Label equality filters (k=v). */\n  labels?: Record<string, string> | undefined;\n}\n\n/** The identity of the listing request that produced a given `runs` array. */\nexport type TaskRunsKey = ReturnType<typeof taskQueryKeys.runs>;\n\nexport interface UseTaskRunsResult {\n  runs: TaskRunMeta[];\n  status: string;\n  /**\n   * Query key of the request that actually produced `runs`, or null before the\n   * first frame arrives. Changing `kind`/`status`/`labels` re-subscribes but\n   * keeps the previous listing on screen until the new transport delivers, so\n   * this key lags `taskQueryKeys.runs(options)` during that window. A consumer\n   * mirroring `runs` into a cache must compare the two and skip the write while\n   * they differ, or it publishes rows that do not match the requested filters.\n   */\n  runsKey: TaskRunsKey | null;\n}\n\n// useTaskRuns lists all runs (TaskRunMeta) for the manager view. It is SSE-first:\n// it subscribes to clicky's runs stream (event: runs carrying the full listing)\n// and falls back to polling the JSON runs endpoint only when EventSource is\n// unavailable or forced off. The listing has no completion terminal of its own —\n// a manager view stays subscribed to observe new and changing runs.\nexport function useTaskRuns(options: UseTaskRunsOptions = {}): UseTaskRunsResult {\n  const {\n    kind,\n    status: statusFilter,\n    labels,\n    basePath = DEFAULT_BASE,\n    enabled = true,\n    pollMs = DEFAULT_POLL_MS,\n    forcePoll = false,\n  } = options;\n\n  // Runs are stored together with the key of the request that delivered them, so\n  // a stale listing can never be mistaken for the current filters' result.\n  const [received, setReceived] = useState<{\n    key: TaskRunsKey | null;\n    runs: TaskRunMeta[];\n  }>({ key: null, runs: [] });\n  const [status, setStatus] = useState(\"idle\");\n\n  useEffect(() => {\n    if (!enabled) return;\n\n    const params = new URLSearchParams();\n    if (kind) params.set(\"kind\", kind);\n    if (statusFilter) params.set(\"status\", statusFilter);\n    for (const [k, v] of Object.entries(labels ?? {})) params.append(\"label\", `${k}=${v}`);\n    const query = params.toString();\n    const requestKey = taskQueryKeys.runs({ basePath, kind, status: statusFilter, labels });\n    const receive = (next: TaskRunMeta[]) => setReceived({ key: requestKey, runs: next });\n\n    // Polling fallback transport.\n    if (forcePoll || !hasEventSource()) {\n      let stopped = false;\n      let timer: ReturnType<typeof setTimeout> | undefined;\n      const tick = async () => {\n        try {\n          const res = await fetch(`${basePath}/tasks${query ? `?${query}` : \"\"}`, {\n            headers: { Accept: \"application/json\" },\n          });\n          if (!res.ok) throw new Error(`Task listing failed with ${res.status}`);\n          if (res.ok) {\n            const next = (await res.json()) as TaskRunMeta[];\n            if (stopped) return;\n            receive(next);\n            setStatus(\"polling\");\n          }\n        } catch {\n          if (!stopped) setStatus(\"connection lost — retrying\");\n        }\n        if (!stopped) timer = setTimeout(tick, pollMs);\n      };\n      void tick();\n      return () => {\n        stopped = true;\n        if (timer) clearTimeout(timer);\n      };\n    }\n\n    // SSE transport (default).\n    const es = new EventSource(`${basePath}/tasks/runs/stream${query ? `?${query}` : \"\"}`);\n    setStatus(\"connecting\");\n    es.onopen = () => setStatus(\"connected\");\n    es.addEventListener(\"runs\", (e) => {\n      try {\n        receive(JSON.parse((e as MessageEvent).data) as TaskRunMeta[]);\n        setStatus(\"connected\");\n      } catch {\n        setStatus(\"invalid task listing data\");\n      }\n    });\n    es.onerror = () => setStatus(\"connection lost — retrying\");\n    return () => es.close();\n  }, [kind, statusFilter, JSON.stringify(labels ?? {}), basePath, enabled, pollMs, forcePoll]);\n\n  return { runs: received.runs, status, runsKey: received.key };\n}\n"],"names":["useState","useEffect","allGroupsTerminal","taskQueryKeys"],"mappings":"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"}
+{"version":3,"file":"use-task-run.cjs","sources":["../../src/hooks/use-task-run.ts"],"sourcesContent":["import { useEffect, useMemo, useState } from \"react\";\nimport {\n  allGroupsTerminal,\n  type TaskRunMeta,\n  type TaskSnapshot,\n} from \"../data/TaskSnapshot\";\nimport {\n  applyTaskOutputDelta,\n  emptyTaskStreams,\n  type TaskOutputDelta,\n  type TaskStreams,\n  withTaskStreams,\n} from \"../data/task-streams\";\nimport { taskQueryKeys } from \"../data/task-query-keys\";\n\n// use-task-run / use-task-runs are the generic clicky-ui task clients. They are\n// SSE-first: they subscribe to clicky's SSEHandler (event: task / event: done)\n// and fall back to polling the JSON endpoints only when EventSource is\n// unavailable. They speak only TaskSnapshot / TaskRunMeta — no app concepts.\n\nexport interface TaskTransportOptions {\n  /** Base path of the clicky task API, e.g. \"/api/v1\". */\n  basePath?: string | undefined;\n  /** Disable the subscription entirely (e.g. before an id is known). */\n  enabled?: boolean | undefined;\n  /** Poll interval (ms) for the fallback / runs listing. */\n  pollMs?: number | undefined;\n  /** Force the polling transport even when EventSource exists (mainly tests). */\n  forcePoll?: boolean | undefined;\n}\n\nconst DEFAULT_BASE = \"/api/v1\";\nconst DEFAULT_POLL_MS = 2_000;\n\nfunction streamUrl(base: string, query: string): string {\n  return `${base}/tasks/stream${query ? `?${query}` : \"\"}`;\n}\n\nfunction hasEventSource(): boolean {\n  return typeof globalThis !== \"undefined\" && typeof globalThis.EventSource !== \"undefined\";\n}\n\nexport interface UseTaskRunResult {\n  snapshots: TaskSnapshot[];\n  status: string;\n  isComplete: boolean;\n}\n\nexport interface UseTaskRunOptions extends TaskTransportOptions {\n  /** Stable run id to follow (drill-down). Mutually exclusive with ids/kind. */\n  id?: string | undefined;\n  /** Stable run ids to follow together. Mutually exclusive with id/kind. */\n  ids?: string[] | undefined;\n  /** Follow every run of a kind. */\n  kind?: string | undefined;\n}\n\n// useTaskRun follows one or more runs (by id) or a kind, SSE-first. It accumulates the\n// latest snapshot per task/group id and reports completion once every group is\n// terminal.\nexport function useTaskRun(options: UseTaskRunOptions = {}): UseTaskRunResult {\n  const {\n    id,\n    ids,\n    kind,\n    basePath = DEFAULT_BASE,\n    enabled = true,\n    pollMs = DEFAULT_POLL_MS,\n    forcePoll = false,\n  } = options;\n  const runIdsKey = (ids?.filter(Boolean) ?? (id ? [id] : [])).join(\",\");\n  // State is reset in an effect, so the first render after the subscription\n  // changes still holds the previous run's snapshots and completion; stateKey\n  // hides them until the reset lands.\n  const subscriptionKey = JSON.stringify([runIdsKey, kind ?? \"\", basePath, enabled]);\n  const [stateKey, setStateKey] = useState(subscriptionKey);\n\n  const [byId, setById] = useState<Record<string, TaskSnapshot>>({});\n  // Streams are held beside the snapshots, never inside them: a task frame\n  // replaces its snapshot wholesale and would take the accumulated output with\n  // it. See ../data/task-streams.\n  const [streamsById, setStreamsById] = useState<Record<string, TaskStreams>>({});\n  const [status, setStatus] = useState(\"idle\");\n  const [isComplete, setIsComplete] = useState(false);\n\n  useEffect(() => {\n    const runIds = runIdsKey ? runIdsKey.split(\",\") : [];\n    setStateKey(subscriptionKey);\n    if (!enabled || (runIds.length === 0 && !kind)) {\n      setById({});\n      setStreamsById({});\n      setStatus(\"idle\");\n      setIsComplete(false);\n      return;\n    }\n    setById({});\n    setStreamsById({});\n    setIsComplete(false);\n\n    const params = new URLSearchParams();\n    if (runIds.length > 0) params.set(\"tasks\", runIdsKey);\n    if (kind) params.set(\"kind\", kind);\n    const query = params.toString();\n\n    const merge = (incoming: TaskSnapshot[]) => {\n      setById((prev) => {\n        const next = { ...prev };\n        for (const snap of incoming) next[snap.type === \"group\" ? `group:${snap.groupId ?? snap.id}` : snap.id] = snap;\n        return next;\n      });\n    };\n\n    // Deltas are applied whether or not the task frame has landed yet: the\n    // stream is keyed by task id on its own, so output that arrives first is\n    // held rather than dropped.\n    const mergeOutput = (delta: TaskOutputDelta) => {\n      setStreamsById((prev) => ({\n        ...prev,\n        [delta.id]: applyTaskOutputDelta(prev[delta.id] ?? emptyTaskStreams, delta),\n      }));\n    };\n\n    // Polling fallback transport.\n    if (forcePoll || !hasEventSource()) {\n      let stopped = false;\n      let timer: ReturnType<typeof setTimeout> | undefined;\n      const tick = async () => {\n        try {\n          const responses = await Promise.all(runIds.map((runId) => fetch(\n            `${basePath}/tasks/${encodeURIComponent(runId)}`,\n            { headers: { Accept: \"application/json\" } },\n          )));\n          if (responses.some((response) => !response.ok)) throw new Error(\"Task request failed\");\n          if (responses.every((response) => response.ok)) {\n            const snaps = (await Promise.all(responses.map(\n              async (response) => (await response.json()) as TaskSnapshot[],\n            ))).flat();\n            if (stopped) return;\n            merge(snaps);\n            setStatus(\"polling\");\n            if (allGroupsTerminal(snaps)) {\n              setIsComplete(true);\n              return; // stop polling\n            }\n          }\n        } catch {\n          if (!stopped) setStatus(\"connection lost — retrying\");\n        }\n        if (!stopped) timer = setTimeout(tick, pollMs);\n      };\n      void tick();\n      return () => {\n        stopped = true;\n        if (timer) clearTimeout(timer);\n      };\n    }\n\n    // SSE transport (default).\n    const es = new EventSource(streamUrl(basePath, query));\n    setStatus(\"connecting\");\n    es.onopen = () => setStatus(\"connected\");\n    es.addEventListener(\"task\", (e) => {\n      try {\n        merge([JSON.parse((e as MessageEvent).data) as TaskSnapshot]);\n        setStatus(\"connected\");\n      } catch {\n        setStatus(\"invalid task stream data\");\n      }\n    });\n    es.addEventListener(\"output\", (e) => {\n      try {\n        mergeOutput(JSON.parse((e as MessageEvent).data) as TaskOutputDelta);\n      } catch {\n        setStatus(\"invalid task output data\");\n      }\n    });\n    es.addEventListener(\"done\", () => {\n      setStatus(\"complete\");\n      setIsComplete(true);\n      es.close();\n    });\n    es.onerror = () => setStatus(\"connection lost — retrying\");\n    return () => es.close();\n  }, [subscriptionKey, runIdsKey, kind, basePath, enabled, pollMs, forcePoll]);\n\n  const current = stateKey === subscriptionKey;\n  // The streams are merged back in only here, at the boundary. The polling\n  // fallback never populates them — its JSON snapshots already carry the full\n  // output — so this is a no-op on that transport.\n  const snapshots = useMemo(\n    () => current\n      ? Object.values(byId).map((snapshot) => withTaskStreams(snapshot, streamsById[snapshot.id]))\n      : [],\n    [current, byId, streamsById],\n  );\n\n  return { snapshots, status: current ? status : \"idle\", isComplete: current && isComplete };\n}\n\nexport interface UseTaskRunsOptions extends TaskTransportOptions {\n  kind?: string | undefined;\n  status?: string | undefined;\n  /** Label equality filters (k=v). */\n  labels?: Record<string, string> | undefined;\n}\n\n/** The identity of the listing request that produced a given `runs` array. */\nexport type TaskRunsKey = ReturnType<typeof taskQueryKeys.runs>;\n\nexport interface UseTaskRunsResult {\n  runs: TaskRunMeta[];\n  status: string;\n  /**\n   * Query key of the request that actually produced `runs`, or null before the\n   * first frame arrives. Changing `kind`/`status`/`labels` re-subscribes but\n   * keeps the previous listing on screen until the new transport delivers, so\n   * this key lags `taskQueryKeys.runs(options)` during that window. A consumer\n   * mirroring `runs` into a cache must compare the two and skip the write while\n   * they differ, or it publishes rows that do not match the requested filters.\n   */\n  runsKey: TaskRunsKey | null;\n}\n\n// useTaskRuns lists all runs (TaskRunMeta) for the manager view. It is SSE-first:\n// it subscribes to clicky's runs stream (event: runs carrying the full listing)\n// and falls back to polling the JSON runs endpoint only when EventSource is\n// unavailable or forced off. The listing has no completion terminal of its own —\n// a manager view stays subscribed to observe new and changing runs.\nexport function useTaskRuns(options: UseTaskRunsOptions = {}): UseTaskRunsResult {\n  const {\n    kind,\n    status: statusFilter,\n    labels,\n    basePath = DEFAULT_BASE,\n    enabled = true,\n    pollMs = DEFAULT_POLL_MS,\n    forcePoll = false,\n  } = options;\n\n  // Runs are stored together with the key of the request that delivered them, so\n  // a stale listing can never be mistaken for the current filters' result.\n  const [received, setReceived] = useState<{\n    key: TaskRunsKey | null;\n    runs: TaskRunMeta[];\n  }>({ key: null, runs: [] });\n  const [status, setStatus] = useState(\"idle\");\n\n  useEffect(() => {\n    if (!enabled) return;\n\n    const params = new URLSearchParams();\n    if (kind) params.set(\"kind\", kind);\n    if (statusFilter) params.set(\"status\", statusFilter);\n    for (const [k, v] of Object.entries(labels ?? {})) params.append(\"label\", `${k}=${v}`);\n    const query = params.toString();\n    const requestKey = taskQueryKeys.runs({ basePath, kind, status: statusFilter, labels });\n    const receive = (next: TaskRunMeta[]) => setReceived({ key: requestKey, runs: next });\n\n    // Polling fallback transport.\n    if (forcePoll || !hasEventSource()) {\n      let stopped = false;\n      let timer: ReturnType<typeof setTimeout> | undefined;\n      const tick = async () => {\n        try {\n          const res = await fetch(`${basePath}/tasks${query ? `?${query}` : \"\"}`, {\n            headers: { Accept: \"application/json\" },\n          });\n          if (!res.ok) throw new Error(`Task listing failed with ${res.status}`);\n          if (res.ok) {\n            const next = (await res.json()) as TaskRunMeta[];\n            if (stopped) return;\n            receive(next);\n            setStatus(\"polling\");\n          }\n        } catch {\n          if (!stopped) setStatus(\"connection lost — retrying\");\n        }\n        if (!stopped) timer = setTimeout(tick, pollMs);\n      };\n      void tick();\n      return () => {\n        stopped = true;\n        if (timer) clearTimeout(timer);\n      };\n    }\n\n    // SSE transport (default).\n    const es = new EventSource(`${basePath}/tasks/runs/stream${query ? `?${query}` : \"\"}`);\n    setStatus(\"connecting\");\n    es.onopen = () => setStatus(\"connected\");\n    es.addEventListener(\"runs\", (e) => {\n      try {\n        receive(JSON.parse((e as MessageEvent).data) as TaskRunMeta[]);\n        setStatus(\"connected\");\n      } catch {\n        setStatus(\"invalid task listing data\");\n      }\n    });\n    es.onerror = () => setStatus(\"connection lost — retrying\");\n    return () => es.close();\n  }, [kind, statusFilter, JSON.stringify(labels ?? {}), basePath, enabled, pollMs, forcePoll]);\n\n  return { runs: received.runs, status, runsKey: received.key };\n}\n"],"names":["useState","useEffect","applyTaskOutputDelta","emptyTaskStreams","allGroupsTerminal","useMemo","withTaskStreams","taskQueryKeys"],"mappings":"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"}

package/dist/hooks/use-task-run.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"use-task-run.d.ts","sourceRoot":"","sources":["../../src/hooks/use-task-run.ts"],"names":[],"mappings":"AACA,OAAO,EAEL,KAAK,WAAW,EAChB,KAAK,YAAY,EAClB,MAAM,sBAAsB,CAAC;AAC9B,OAAO,EAAE,aAAa,EAAE,MAAM,yBAAyB,CAAC;AAOxD,MAAM,WAAW,oBAAoB;IACnC,wDAAwD;IACxD,QAAQ,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC9B,sEAAsE;IACtE,OAAO,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;IAC9B,0DAA0D;IAC1D,MAAM,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC5B,+EAA+E;IAC/E,SAAS,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;CACjC;AAaD,MAAM,WAAW,gBAAgB;IAC/B,SAAS,EAAE,YAAY,EAAE,CAAC;IAC1B,MAAM,EAAE,MAAM,CAAC;IACf,UAAU,EAAE,OAAO,CAAC;CACrB;AAED,MAAM,WAAW,iBAAkB,SAAQ,oBAAoB;IAC7D,8EAA8E;IAC9E,EAAE,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACxB,0EAA0E;IAC1E,GAAG,CAAC,EAAE,MAAM,EAAE,GAAG,SAAS,CAAC;IAC3B,kCAAkC;IAClC,IAAI,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;CAC3B;AAKD,wBAAgB,UAAU,CAAC,OAAO,GAAE,iBAAsB,GAAG,gBAAgB,CA+H5E;AAED,MAAM,WAAW,kBAAmB,SAAQ,oBAAoB;IAC9D,IAAI,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC1B,MAAM,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC5B,oCAAoC;IACpC,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,SAAS,CAAC;CAC7C;AAED,8EAA8E;AAC9E,MAAM,MAAM,WAAW,GAAG,UAAU,CAAC,OAAO,aAAa,CAAC,IAAI,CAAC,CAAC;AAEhE,MAAM,WAAW,iBAAiB;IAChC,IAAI,EAAE,WAAW,EAAE,CAAC;IACpB,MAAM,EAAE,MAAM,CAAC;IACf;;;;;;;OAOG;IACH,OAAO,EAAE,WAAW,GAAG,IAAI,CAAC;CAC7B;AAOD,wBAAgB,WAAW,CAAC,OAAO,GAAE,kBAAuB,GAAG,iBAAiB,CA2E/E"}
+{"version":3,"file":"use-task-run.d.ts","sourceRoot":"","sources":["../../src/hooks/use-task-run.ts"],"names":[],"mappings":"AACA,OAAO,EAEL,KAAK,WAAW,EAChB,KAAK,YAAY,EAClB,MAAM,sBAAsB,CAAC;AAQ9B,OAAO,EAAE,aAAa,EAAE,MAAM,yBAAyB,CAAC;AAOxD,MAAM,WAAW,oBAAoB;IACnC,wDAAwD;IACxD,QAAQ,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC9B,sEAAsE;IACtE,OAAO,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;IAC9B,0DAA0D;IAC1D,MAAM,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC5B,+EAA+E;IAC/E,SAAS,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;CACjC;AAaD,MAAM,WAAW,gBAAgB;IAC/B,SAAS,EAAE,YAAY,EAAE,CAAC;IAC1B,MAAM,EAAE,MAAM,CAAC;IACf,UAAU,EAAE,OAAO,CAAC;CACrB;AAED,MAAM,WAAW,iBAAkB,SAAQ,oBAAoB;IAC7D,8EAA8E;IAC9E,EAAE,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACxB,0EAA0E;IAC1E,GAAG,CAAC,EAAE,MAAM,EAAE,GAAG,SAAS,CAAC;IAC3B,kCAAkC;IAClC,IAAI,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;CAC3B;AAKD,wBAAgB,UAAU,CAAC,OAAO,GAAE,iBAAsB,GAAG,gBAAgB,CAyI5E;AAED,MAAM,WAAW,kBAAmB,SAAQ,oBAAoB;IAC9D,IAAI,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC1B,MAAM,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC5B,oCAAoC;IACpC,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,SAAS,CAAC;CAC7C;AAED,8EAA8E;AAC9E,MAAM,MAAM,WAAW,GAAG,UAAU,CAAC,OAAO,aAAa,CAAC,IAAI,CAAC,CAAC;AAEhE,MAAM,WAAW,iBAAiB;IAChC,IAAI,EAAE,WAAW,EAAE,CAAC;IACpB,MAAM,EAAE,MAAM,CAAC;IACf;;;;;;;OAOG;IACH,OAAO,EAAE,WAAW,GAAG,IAAI,CAAC;CAC7B;AAOD,wBAAgB,WAAW,CAAC,OAAO,GAAE,kBAAuB,GAAG,iBAAiB,CA2E/E"}

package/dist/hooks/use-task-run.js

@@ -1,5 +1,6 @@
-import { useState, useEffect } from "react";
+import { useState, useEffect, useMemo } from "react";
 import { allGroupsTerminal } from "../data/TaskSnapshot.js";
+import { withTaskStreams, applyTaskOutputDelta, emptyTaskStreams } from "../data/task-streams.js";
 import { taskQueryKeys } from "../data/task-query-keys.js";
 const DEFAULT_BASE = "/api/v1";
 const DEFAULT_POLL_MS = 2e3;
@@ -20,18 +21,24 @@ function useTaskRun(options = {}) {
     forcePoll = false
   } = options;
   const runIdsKey = ((ids == null ? void 0 : ids.filter(Boolean)) ?? (id ? [id] : [])).join(",");
+  const subscriptionKey = JSON.stringify([runIdsKey, kind ?? "", basePath, enabled]);
+  const [stateKey, setStateKey] = useState(subscriptionKey);
   const [byId, setById] = useState({});
+  const [streamsById, setStreamsById] = useState({});
   const [status, setStatus] = useState("idle");
   const [isComplete, setIsComplete] = useState(false);
   useEffect(() => {
     const runIds = runIdsKey ? runIdsKey.split(",") : [];
+    setStateKey(subscriptionKey);
     if (!enabled || runIds.length === 0 && !kind) {
       setById({});
+      setStreamsById({});
       setStatus("idle");
       setIsComplete(false);
       return;
     }
     setById({});
+    setStreamsById({});
     setIsComplete(false);
     const params = new URLSearchParams();
     if (runIds.length > 0) params.set("tasks", runIdsKey);
@@ -45,20 +52,10 @@ function useTaskRun(options = {}) {
       });
     };
     const mergeOutput = (delta) => {
-      setById((prev) => {
-        const snapshot = prev[delta.id];
-        if (!snapshot) return prev;
-        const value = delta.reset ? delta.data : `${snapshot[delta.stream] ?? ""}${delta.data}`;
-        const truncatedField = delta.stream === "stdout" ? "stdoutTruncated" : "stderrTruncated";
-        return {
-          ...prev,
-          [delta.id]: {
-            ...snapshot,
-            [delta.stream]: value,
-            [truncatedField]: delta.truncated ?? snapshot[truncatedField]
-          }
-        };
-      });
+      setStreamsById((prev) => ({
+        ...prev,
+        [delta.id]: applyTaskOutputDelta(prev[delta.id] ?? emptyTaskStreams, delta)
+      }));
     };
     if (forcePoll || !hasEventSource()) {
       let stopped = false;
@@ -118,8 +115,13 @@ function useTaskRun(options = {}) {
     });
     es.onerror = () => setStatus("connection lost — retrying");
     return () => es.close();
-  }, [runIdsKey, kind, basePath, enabled, pollMs, forcePoll]);
-  return { snapshots: Object.values(byId), status, isComplete };
+  }, [subscriptionKey, runIdsKey, kind, basePath, enabled, pollMs, forcePoll]);
+  const current = stateKey === subscriptionKey;
+  const snapshots = useMemo(
+    () => current ? Object.values(byId).map((snapshot) => withTaskStreams(snapshot, streamsById[snapshot.id])) : [],
+    [current, byId, streamsById]
+  );
+  return { snapshots, status: current ? status : "idle", isComplete: current && isComplete };
 }
 function useTaskRuns(options = {}) {
   const {

package/dist/hooks/use-task-run.js.map

@@ -1 +1 @@
-{"version":3,"file":"use-task-run.js","sources":["../../src/hooks/use-task-run.ts"],"sourcesContent":["import { useEffect, useState } from \"react\";\nimport {\n  allGroupsTerminal,\n  type TaskRunMeta,\n  type TaskSnapshot,\n} from \"../data/TaskSnapshot\";\nimport { taskQueryKeys } from \"../data/task-query-keys\";\n\n// use-task-run / use-task-runs are the generic clicky-ui task clients. They are\n// SSE-first: they subscribe to clicky's SSEHandler (event: task / event: done)\n// and fall back to polling the JSON endpoints only when EventSource is\n// unavailable. They speak only TaskSnapshot / TaskRunMeta — no app concepts.\n\nexport interface TaskTransportOptions {\n  /** Base path of the clicky task API, e.g. \"/api/v1\". */\n  basePath?: string | undefined;\n  /** Disable the subscription entirely (e.g. before an id is known). */\n  enabled?: boolean | undefined;\n  /** Poll interval (ms) for the fallback / runs listing. */\n  pollMs?: number | undefined;\n  /** Force the polling transport even when EventSource exists (mainly tests). */\n  forcePoll?: boolean | undefined;\n}\n\nconst DEFAULT_BASE = \"/api/v1\";\nconst DEFAULT_POLL_MS = 2_000;\n\nfunction streamUrl(base: string, query: string): string {\n  return `${base}/tasks/stream${query ? `?${query}` : \"\"}`;\n}\n\nfunction hasEventSource(): boolean {\n  return typeof globalThis !== \"undefined\" && typeof globalThis.EventSource !== \"undefined\";\n}\n\nexport interface UseTaskRunResult {\n  snapshots: TaskSnapshot[];\n  status: string;\n  isComplete: boolean;\n}\n\nexport interface UseTaskRunOptions extends TaskTransportOptions {\n  /** Stable run id to follow (drill-down). Mutually exclusive with ids/kind. */\n  id?: string | undefined;\n  /** Stable run ids to follow together. Mutually exclusive with id/kind. */\n  ids?: string[] | undefined;\n  /** Follow every run of a kind. */\n  kind?: string | undefined;\n}\n\n// useTaskRun follows one or more runs (by id) or a kind, SSE-first. It accumulates the\n// latest snapshot per task/group id and reports completion once every group is\n// terminal.\nexport function useTaskRun(options: UseTaskRunOptions = {}): UseTaskRunResult {\n  const {\n    id,\n    ids,\n    kind,\n    basePath = DEFAULT_BASE,\n    enabled = true,\n    pollMs = DEFAULT_POLL_MS,\n    forcePoll = false,\n  } = options;\n  const runIdsKey = (ids?.filter(Boolean) ?? (id ? [id] : [])).join(\",\");\n\n  const [byId, setById] = useState<Record<string, TaskSnapshot>>({});\n  const [status, setStatus] = useState(\"idle\");\n  const [isComplete, setIsComplete] = useState(false);\n\n  useEffect(() => {\n    const runIds = runIdsKey ? runIdsKey.split(\",\") : [];\n    if (!enabled || (runIds.length === 0 && !kind)) {\n      setById({});\n      setStatus(\"idle\");\n      setIsComplete(false);\n      return;\n    }\n    setById({});\n    setIsComplete(false);\n\n    const params = new URLSearchParams();\n    if (runIds.length > 0) params.set(\"tasks\", runIdsKey);\n    if (kind) params.set(\"kind\", kind);\n    const query = params.toString();\n\n    const merge = (incoming: TaskSnapshot[]) => {\n      setById((prev) => {\n        const next = { ...prev };\n        for (const snap of incoming) next[snap.type === \"group\" ? `group:${snap.groupId ?? snap.id}` : snap.id] = snap;\n        return next;\n      });\n    };\n\n    const mergeOutput = (delta: {\n      id: string;\n      stream: \"stdout\" | \"stderr\";\n      data: string;\n      reset?: boolean;\n      truncated?: boolean;\n    }) => {\n      setById((prev) => {\n        const snapshot = prev[delta.id];\n        if (!snapshot) return prev;\n        const value = delta.reset ? delta.data : `${snapshot[delta.stream] ?? \"\"}${delta.data}`;\n        const truncatedField = delta.stream === \"stdout\" ? \"stdoutTruncated\" : \"stderrTruncated\";\n        return {\n          ...prev,\n          [delta.id]: {\n            ...snapshot,\n            [delta.stream]: value,\n            [truncatedField]: delta.truncated ?? snapshot[truncatedField],\n          },\n        };\n      });\n    };\n\n    // Polling fallback transport.\n    if (forcePoll || !hasEventSource()) {\n      let stopped = false;\n      let timer: ReturnType<typeof setTimeout> | undefined;\n      const tick = async () => {\n        try {\n          const responses = await Promise.all(runIds.map((runId) => fetch(\n            `${basePath}/tasks/${encodeURIComponent(runId)}`,\n            { headers: { Accept: \"application/json\" } },\n          )));\n          if (responses.some((response) => !response.ok)) throw new Error(\"Task request failed\");\n          if (responses.every((response) => response.ok)) {\n            const snaps = (await Promise.all(responses.map(\n              async (response) => (await response.json()) as TaskSnapshot[],\n            ))).flat();\n            if (stopped) return;\n            merge(snaps);\n            setStatus(\"polling\");\n            if (allGroupsTerminal(snaps)) {\n              setIsComplete(true);\n              return; // stop polling\n            }\n          }\n        } catch {\n          if (!stopped) setStatus(\"connection lost — retrying\");\n        }\n        if (!stopped) timer = setTimeout(tick, pollMs);\n      };\n      void tick();\n      return () => {\n        stopped = true;\n        if (timer) clearTimeout(timer);\n      };\n    }\n\n    // SSE transport (default).\n    const es = new EventSource(streamUrl(basePath, query));\n    setStatus(\"connecting\");\n    es.onopen = () => setStatus(\"connected\");\n    es.addEventListener(\"task\", (e) => {\n      try {\n        merge([JSON.parse((e as MessageEvent).data) as TaskSnapshot]);\n        setStatus(\"connected\");\n      } catch {\n        setStatus(\"invalid task stream data\");\n      }\n    });\n    es.addEventListener(\"output\", (e) => {\n      try {\n        mergeOutput(JSON.parse((e as MessageEvent).data) as Parameters<typeof mergeOutput>[0]);\n      } catch {\n        setStatus(\"invalid task output data\");\n      }\n    });\n    es.addEventListener(\"done\", () => {\n      setStatus(\"complete\");\n      setIsComplete(true);\n      es.close();\n    });\n    es.onerror = () => setStatus(\"connection lost — retrying\");\n    return () => es.close();\n  }, [runIdsKey, kind, basePath, enabled, pollMs, forcePoll]);\n\n  return { snapshots: Object.values(byId), status, isComplete };\n}\n\nexport interface UseTaskRunsOptions extends TaskTransportOptions {\n  kind?: string | undefined;\n  status?: string | undefined;\n  /** Label equality filters (k=v). */\n  labels?: Record<string, string> | undefined;\n}\n\n/** The identity of the listing request that produced a given `runs` array. */\nexport type TaskRunsKey = ReturnType<typeof taskQueryKeys.runs>;\n\nexport interface UseTaskRunsResult {\n  runs: TaskRunMeta[];\n  status: string;\n  /**\n   * Query key of the request that actually produced `runs`, or null before the\n   * first frame arrives. Changing `kind`/`status`/`labels` re-subscribes but\n   * keeps the previous listing on screen until the new transport delivers, so\n   * this key lags `taskQueryKeys.runs(options)` during that window. A consumer\n   * mirroring `runs` into a cache must compare the two and skip the write while\n   * they differ, or it publishes rows that do not match the requested filters.\n   */\n  runsKey: TaskRunsKey | null;\n}\n\n// useTaskRuns lists all runs (TaskRunMeta) for the manager view. It is SSE-first:\n// it subscribes to clicky's runs stream (event: runs carrying the full listing)\n// and falls back to polling the JSON runs endpoint only when EventSource is\n// unavailable or forced off. The listing has no completion terminal of its own —\n// a manager view stays subscribed to observe new and changing runs.\nexport function useTaskRuns(options: UseTaskRunsOptions = {}): UseTaskRunsResult {\n  const {\n    kind,\n    status: statusFilter,\n    labels,\n    basePath = DEFAULT_BASE,\n    enabled = true,\n    pollMs = DEFAULT_POLL_MS,\n    forcePoll = false,\n  } = options;\n\n  // Runs are stored together with the key of the request that delivered them, so\n  // a stale listing can never be mistaken for the current filters' result.\n  const [received, setReceived] = useState<{\n    key: TaskRunsKey | null;\n    runs: TaskRunMeta[];\n  }>({ key: null, runs: [] });\n  const [status, setStatus] = useState(\"idle\");\n\n  useEffect(() => {\n    if (!enabled) return;\n\n    const params = new URLSearchParams();\n    if (kind) params.set(\"kind\", kind);\n    if (statusFilter) params.set(\"status\", statusFilter);\n    for (const [k, v] of Object.entries(labels ?? {})) params.append(\"label\", `${k}=${v}`);\n    const query = params.toString();\n    const requestKey = taskQueryKeys.runs({ basePath, kind, status: statusFilter, labels });\n    const receive = (next: TaskRunMeta[]) => setReceived({ key: requestKey, runs: next });\n\n    // Polling fallback transport.\n    if (forcePoll || !hasEventSource()) {\n      let stopped = false;\n      let timer: ReturnType<typeof setTimeout> | undefined;\n      const tick = async () => {\n        try {\n          const res = await fetch(`${basePath}/tasks${query ? `?${query}` : \"\"}`, {\n            headers: { Accept: \"application/json\" },\n          });\n          if (!res.ok) throw new Error(`Task listing failed with ${res.status}`);\n          if (res.ok) {\n            const next = (await res.json()) as TaskRunMeta[];\n            if (stopped) return;\n            receive(next);\n            setStatus(\"polling\");\n          }\n        } catch {\n          if (!stopped) setStatus(\"connection lost — retrying\");\n        }\n        if (!stopped) timer = setTimeout(tick, pollMs);\n      };\n      void tick();\n      return () => {\n        stopped = true;\n        if (timer) clearTimeout(timer);\n      };\n    }\n\n    // SSE transport (default).\n    const es = new EventSource(`${basePath}/tasks/runs/stream${query ? `?${query}` : \"\"}`);\n    setStatus(\"connecting\");\n    es.onopen = () => setStatus(\"connected\");\n    es.addEventListener(\"runs\", (e) => {\n      try {\n        receive(JSON.parse((e as MessageEvent).data) as TaskRunMeta[]);\n        setStatus(\"connected\");\n      } catch {\n        setStatus(\"invalid task listing data\");\n      }\n    });\n    es.onerror = () => setStatus(\"connection lost — retrying\");\n    return () => es.close();\n  }, [kind, statusFilter, JSON.stringify(labels ?? {}), basePath, enabled, pollMs, forcePoll]);\n\n  return { runs: received.runs, status, runsKey: received.key };\n}\n"],"names":[],"mappings":";;;AAwBA,MAAM,eAAe;AACrB,MAAM,kBAAkB;AAExB,SAAS,UAAU,MAAc,OAAuB;AACtD,SAAO,GAAG,IAAI,gBAAgB,QAAQ,IAAI,KAAK,KAAK,EAAE;AACxD;AAEA,SAAS,iBAA0B;AACjC,SAAO,OAAO,eAAe,eAAe,OAAO,WAAW,gBAAgB;AAChF;AAoBO,SAAS,WAAW,UAA6B,IAAsB;AAC5E,QAAM;AAAA,IACJ;AAAA,IACA;AAAA,IACA;AAAA,IACA,WAAW;AAAA,IACX,UAAU;AAAA,IACV,SAAS;AAAA,IACT,YAAY;AAAA,EAAA,IACV;AACJ,QAAM,cAAa,2BAAK,OAAO,cAAa,KAAK,CAAC,EAAE,IAAI,CAAA,IAAK,KAAK,GAAG;AAErE,QAAM,CAAC,MAAM,OAAO,IAAI,SAAuC,CAAA,CAAE;AACjE,QAAM,CAAC,QAAQ,SAAS,IAAI,SAAS,MAAM;AAC3C,QAAM,CAAC,YAAY,aAAa,IAAI,SAAS,KAAK;AAElD,YAAU,MAAM;AACd,UAAM,SAAS,YAAY,UAAU,MAAM,GAAG,IAAI,CAAA;AAClD,QAAI,CAAC,WAAY,OAAO,WAAW,KAAK,CAAC,MAAO;AAC9C,cAAQ,CAAA,CAAE;AACV,gBAAU,MAAM;AAChB,oBAAc,KAAK;AACnB;AAAA,IACF;AACA,YAAQ,CAAA,CAAE;AACV,kBAAc,KAAK;AAEnB,UAAM,SAAS,IAAI,gBAAA;AACnB,QAAI,OAAO,SAAS,EAAG,QAAO,IAAI,SAAS,SAAS;AACpD,QAAI,KAAM,QAAO,IAAI,QAAQ,IAAI;AACjC,UAAM,QAAQ,OAAO,SAAA;AAErB,UAAM,QAAQ,CAAC,aAA6B;AAC1C,cAAQ,CAAC,SAAS;AAChB,cAAM,OAAO,EAAE,GAAG,KAAA;AAClB,mBAAW,QAAQ,SAAU,MAAK,KAAK,SAAS,UAAU,SAAS,KAAK,WAAW,KAAK,EAAE,KAAK,KAAK,EAAE,IAAI;AAC1G,eAAO;AAAA,MACT,CAAC;AAAA,IACH;AAEA,UAAM,cAAc,CAAC,UAMf;AACJ,cAAQ,CAAC,SAAS;AAChB,cAAM,WAAW,KAAK,MAAM,EAAE;AAC9B,YAAI,CAAC,SAAU,QAAO;AACtB,cAAM,QAAQ,MAAM,QAAQ,MAAM,OAAO,GAAG,SAAS,MAAM,MAAM,KAAK,EAAE,GAAG,MAAM,IAAI;AACrF,cAAM,iBAAiB,MAAM,WAAW,WAAW,oBAAoB;AACvE,eAAO;AAAA,UACL,GAAG;AAAA,UACH,CAAC,MAAM,EAAE,GAAG;AAAA,YACV,GAAG;AAAA,YACH,CAAC,MAAM,MAAM,GAAG;AAAA,YAChB,CAAC,cAAc,GAAG,MAAM,aAAa,SAAS,cAAc;AAAA,UAAA;AAAA,QAC9D;AAAA,MAEJ,CAAC;AAAA,IACH;AAGA,QAAI,aAAa,CAAC,kBAAkB;AAClC,UAAI,UAAU;AACd,UAAI;AACJ,YAAM,OAAO,YAAY;AACvB,YAAI;AACF,gBAAM,YAAY,MAAM,QAAQ,IAAI,OAAO,IAAI,CAAC,UAAU;AAAA,YACxD,GAAG,QAAQ,UAAU,mBAAmB,KAAK,CAAC;AAAA,YAC9C,EAAE,SAAS,EAAE,QAAQ,qBAAmB;AAAA,UAAE,CAC3C,CAAC;AACF,cAAI,UAAU,KAAK,CAAC,aAAa,CAAC,SAAS,EAAE,EAAG,OAAM,IAAI,MAAM,qBAAqB;AACrF,cAAI,UAAU,MAAM,CAAC,aAAa,SAAS,EAAE,GAAG;AAC9C,kBAAM,SAAS,MAAM,QAAQ,IAAI,UAAU;AAAA,cACzC,OAAO,aAAc,MAAM,SAAS,KAAA;AAAA,YAAK,CAC1C,GAAG,KAAA;AACJ,gBAAI,QAAS;AACb,kBAAM,KAAK;AACX,sBAAU,SAAS;AACnB,gBAAI,kBAAkB,KAAK,GAAG;AAC5B,4BAAc,IAAI;AAClB;AAAA,YACF;AAAA,UACF;AAAA,QACF,QAAQ;AACN,cAAI,CAAC,QAAS,WAAU,4BAA4B;AAAA,QACtD;AACA,YAAI,CAAC,QAAS,SAAQ,WAAW,MAAM,MAAM;AAAA,MAC/C;AACA,WAAK,KAAA;AACL,aAAO,MAAM;AACX,kBAAU;AACV,YAAI,oBAAoB,KAAK;AAAA,MAC/B;AAAA,IACF;AAGA,UAAM,KAAK,IAAI,YAAY,UAAU,UAAU,KAAK,CAAC;AACrD,cAAU,YAAY;AACtB,OAAG,SAAS,MAAM,UAAU,WAAW;AACvC,OAAG,iBAAiB,QAAQ,CAAC,MAAM;AACjC,UAAI;AACF,cAAM,CAAC,KAAK,MAAO,EAAmB,IAAI,CAAiB,CAAC;AAC5D,kBAAU,WAAW;AAAA,MACvB,QAAQ;AACN,kBAAU,0BAA0B;AAAA,MACtC;AAAA,IACF,CAAC;AACD,OAAG,iBAAiB,UAAU,CAAC,MAAM;AACnC,UAAI;AACF,oBAAY,KAAK,MAAO,EAAmB,IAAI,CAAsC;AAAA,MACvF,QAAQ;AACN,kBAAU,0BAA0B;AAAA,MACtC;AAAA,IACF,CAAC;AACD,OAAG,iBAAiB,QAAQ,MAAM;AAChC,gBAAU,UAAU;AACpB,oBAAc,IAAI;AAClB,SAAG,MAAA;AAAA,IACL,CAAC;AACD,OAAG,UAAU,MAAM,UAAU,4BAA4B;AACzD,WAAO,MAAM,GAAG,MAAA;AAAA,EAClB,GAAG,CAAC,WAAW,MAAM,UAAU,SAAS,QAAQ,SAAS,CAAC;AAE1D,SAAO,EAAE,WAAW,OAAO,OAAO,IAAI,GAAG,QAAQ,WAAA;AACnD;AA+BO,SAAS,YAAY,UAA8B,IAAuB;AAC/E,QAAM;AAAA,IACJ;AAAA,IACA,QAAQ;AAAA,IACR;AAAA,IACA,WAAW;AAAA,IACX,UAAU;AAAA,IACV,SAAS;AAAA,IACT,YAAY;AAAA,EAAA,IACV;AAIJ,QAAM,CAAC,UAAU,WAAW,IAAI,SAG7B,EAAE,KAAK,MAAM,MAAM,CAAA,GAAI;AAC1B,QAAM,CAAC,QAAQ,SAAS,IAAI,SAAS,MAAM;AAE3C,YAAU,MAAM;AACd,QAAI,CAAC,QAAS;AAEd,UAAM,SAAS,IAAI,gBAAA;AACnB,QAAI,KAAM,QAAO,IAAI,QAAQ,IAAI;AACjC,QAAI,aAAc,QAAO,IAAI,UAAU,YAAY;AACnD,eAAW,CAAC,GAAG,CAAC,KAAK,OAAO,QAAQ,UAAU,CAAA,CAAE,UAAU,OAAO,SAAS,GAAG,CAAC,IAAI,CAAC,EAAE;AACrF,UAAM,QAAQ,OAAO,SAAA;AACrB,UAAM,aAAa,cAAc,KAAK,EAAE,UAAU,MAAM,QAAQ,cAAc,QAAQ;AACtF,UAAM,UAAU,CAAC,SAAwB,YAAY,EAAE,KAAK,YAAY,MAAM,MAAM;AAGpF,QAAI,aAAa,CAAC,kBAAkB;AAClC,UAAI,UAAU;AACd,UAAI;AACJ,YAAM,OAAO,YAAY;AACvB,YAAI;AACF,gBAAM,MAAM,MAAM,MAAM,GAAG,QAAQ,SAAS,QAAQ,IAAI,KAAK,KAAK,EAAE,IAAI;AAAA,YACtE,SAAS,EAAE,QAAQ,mBAAA;AAAA,UAAmB,CACvC;AACD,cAAI,CAAC,IAAI,GAAI,OAAM,IAAI,MAAM,4BAA4B,IAAI,MAAM,EAAE;AACrE,cAAI,IAAI,IAAI;AACV,kBAAM,OAAQ,MAAM,IAAI,KAAA;AACxB,gBAAI,QAAS;AACb,oBAAQ,IAAI;AACZ,sBAAU,SAAS;AAAA,UACrB;AAAA,QACF,QAAQ;AACN,cAAI,CAAC,QAAS,WAAU,4BAA4B;AAAA,QACtD;AACA,YAAI,CAAC,QAAS,SAAQ,WAAW,MAAM,MAAM;AAAA,MAC/C;AACA,WAAK,KAAA;AACL,aAAO,MAAM;AACX,kBAAU;AACV,YAAI,oBAAoB,KAAK;AAAA,MAC/B;AAAA,IACF;AAGA,UAAM,KAAK,IAAI,YAAY,GAAG,QAAQ,qBAAqB,QAAQ,IAAI,KAAK,KAAK,EAAE,EAAE;AACrF,cAAU,YAAY;AACtB,OAAG,SAAS,MAAM,UAAU,WAAW;AACvC,OAAG,iBAAiB,QAAQ,CAAC,MAAM;AACjC,UAAI;AACF,gBAAQ,KAAK,MAAO,EAAmB,IAAI,CAAkB;AAC7D,kBAAU,WAAW;AAAA,MACvB,QAAQ;AACN,kBAAU,2BAA2B;AAAA,MACvC;AAAA,IACF,CAAC;AACD,OAAG,UAAU,MAAM,UAAU,4BAA4B;AACzD,WAAO,MAAM,GAAG,MAAA;AAAA,EAClB,GAAG,CAAC,MAAM,cAAc,KAAK,UAAU,UAAU,CAAA,CAAE,GAAG,UAAU,SAAS,QAAQ,SAAS,CAAC;AAE3F,SAAO,EAAE,MAAM,SAAS,MAAM,QAAQ,SAAS,SAAS,IAAA;AAC1D;"}
+{"version":3,"file":"use-task-run.js","sources":["../../src/hooks/use-task-run.ts"],"sourcesContent":["import { useEffect, useMemo, useState } from \"react\";\nimport {\n  allGroupsTerminal,\n  type TaskRunMeta,\n  type TaskSnapshot,\n} from \"../data/TaskSnapshot\";\nimport {\n  applyTaskOutputDelta,\n  emptyTaskStreams,\n  type TaskOutputDelta,\n  type TaskStreams,\n  withTaskStreams,\n} from \"../data/task-streams\";\nimport { taskQueryKeys } from \"../data/task-query-keys\";\n\n// use-task-run / use-task-runs are the generic clicky-ui task clients. They are\n// SSE-first: they subscribe to clicky's SSEHandler (event: task / event: done)\n// and fall back to polling the JSON endpoints only when EventSource is\n// unavailable. They speak only TaskSnapshot / TaskRunMeta — no app concepts.\n\nexport interface TaskTransportOptions {\n  /** Base path of the clicky task API, e.g. \"/api/v1\". */\n  basePath?: string | undefined;\n  /** Disable the subscription entirely (e.g. before an id is known). */\n  enabled?: boolean | undefined;\n  /** Poll interval (ms) for the fallback / runs listing. */\n  pollMs?: number | undefined;\n  /** Force the polling transport even when EventSource exists (mainly tests). */\n  forcePoll?: boolean | undefined;\n}\n\nconst DEFAULT_BASE = \"/api/v1\";\nconst DEFAULT_POLL_MS = 2_000;\n\nfunction streamUrl(base: string, query: string): string {\n  return `${base}/tasks/stream${query ? `?${query}` : \"\"}`;\n}\n\nfunction hasEventSource(): boolean {\n  return typeof globalThis !== \"undefined\" && typeof globalThis.EventSource !== \"undefined\";\n}\n\nexport interface UseTaskRunResult {\n  snapshots: TaskSnapshot[];\n  status: string;\n  isComplete: boolean;\n}\n\nexport interface UseTaskRunOptions extends TaskTransportOptions {\n  /** Stable run id to follow (drill-down). Mutually exclusive with ids/kind. */\n  id?: string | undefined;\n  /** Stable run ids to follow together. Mutually exclusive with id/kind. */\n  ids?: string[] | undefined;\n  /** Follow every run of a kind. */\n  kind?: string | undefined;\n}\n\n// useTaskRun follows one or more runs (by id) or a kind, SSE-first. It accumulates the\n// latest snapshot per task/group id and reports completion once every group is\n// terminal.\nexport function useTaskRun(options: UseTaskRunOptions = {}): UseTaskRunResult {\n  const {\n    id,\n    ids,\n    kind,\n    basePath = DEFAULT_BASE,\n    enabled = true,\n    pollMs = DEFAULT_POLL_MS,\n    forcePoll = false,\n  } = options;\n  const runIdsKey = (ids?.filter(Boolean) ?? (id ? [id] : [])).join(\",\");\n  // State is reset in an effect, so the first render after the subscription\n  // changes still holds the previous run's snapshots and completion; stateKey\n  // hides them until the reset lands.\n  const subscriptionKey = JSON.stringify([runIdsKey, kind ?? \"\", basePath, enabled]);\n  const [stateKey, setStateKey] = useState(subscriptionKey);\n\n  const [byId, setById] = useState<Record<string, TaskSnapshot>>({});\n  // Streams are held beside the snapshots, never inside them: a task frame\n  // replaces its snapshot wholesale and would take the accumulated output with\n  // it. See ../data/task-streams.\n  const [streamsById, setStreamsById] = useState<Record<string, TaskStreams>>({});\n  const [status, setStatus] = useState(\"idle\");\n  const [isComplete, setIsComplete] = useState(false);\n\n  useEffect(() => {\n    const runIds = runIdsKey ? runIdsKey.split(\",\") : [];\n    setStateKey(subscriptionKey);\n    if (!enabled || (runIds.length === 0 && !kind)) {\n      setById({});\n      setStreamsById({});\n      setStatus(\"idle\");\n      setIsComplete(false);\n      return;\n    }\n    setById({});\n    setStreamsById({});\n    setIsComplete(false);\n\n    const params = new URLSearchParams();\n    if (runIds.length > 0) params.set(\"tasks\", runIdsKey);\n    if (kind) params.set(\"kind\", kind);\n    const query = params.toString();\n\n    const merge = (incoming: TaskSnapshot[]) => {\n      setById((prev) => {\n        const next = { ...prev };\n        for (const snap of incoming) next[snap.type === \"group\" ? `group:${snap.groupId ?? snap.id}` : snap.id] = snap;\n        return next;\n      });\n    };\n\n    // Deltas are applied whether or not the task frame has landed yet: the\n    // stream is keyed by task id on its own, so output that arrives first is\n    // held rather than dropped.\n    const mergeOutput = (delta: TaskOutputDelta) => {\n      setStreamsById((prev) => ({\n        ...prev,\n        [delta.id]: applyTaskOutputDelta(prev[delta.id] ?? emptyTaskStreams, delta),\n      }));\n    };\n\n    // Polling fallback transport.\n    if (forcePoll || !hasEventSource()) {\n      let stopped = false;\n      let timer: ReturnType<typeof setTimeout> | undefined;\n      const tick = async () => {\n        try {\n          const responses = await Promise.all(runIds.map((runId) => fetch(\n            `${basePath}/tasks/${encodeURIComponent(runId)}`,\n            { headers: { Accept: \"application/json\" } },\n          )));\n          if (responses.some((response) => !response.ok)) throw new Error(\"Task request failed\");\n          if (responses.every((response) => response.ok)) {\n            const snaps = (await Promise.all(responses.map(\n              async (response) => (await response.json()) as TaskSnapshot[],\n            ))).flat();\n            if (stopped) return;\n            merge(snaps);\n            setStatus(\"polling\");\n            if (allGroupsTerminal(snaps)) {\n              setIsComplete(true);\n              return; // stop polling\n            }\n          }\n        } catch {\n          if (!stopped) setStatus(\"connection lost — retrying\");\n        }\n        if (!stopped) timer = setTimeout(tick, pollMs);\n      };\n      void tick();\n      return () => {\n        stopped = true;\n        if (timer) clearTimeout(timer);\n      };\n    }\n\n    // SSE transport (default).\n    const es = new EventSource(streamUrl(basePath, query));\n    setStatus(\"connecting\");\n    es.onopen = () => setStatus(\"connected\");\n    es.addEventListener(\"task\", (e) => {\n      try {\n        merge([JSON.parse((e as MessageEvent).data) as TaskSnapshot]);\n        setStatus(\"connected\");\n      } catch {\n        setStatus(\"invalid task stream data\");\n      }\n    });\n    es.addEventListener(\"output\", (e) => {\n      try {\n        mergeOutput(JSON.parse((e as MessageEvent).data) as TaskOutputDelta);\n      } catch {\n        setStatus(\"invalid task output data\");\n      }\n    });\n    es.addEventListener(\"done\", () => {\n      setStatus(\"complete\");\n      setIsComplete(true);\n      es.close();\n    });\n    es.onerror = () => setStatus(\"connection lost — retrying\");\n    return () => es.close();\n  }, [subscriptionKey, runIdsKey, kind, basePath, enabled, pollMs, forcePoll]);\n\n  const current = stateKey === subscriptionKey;\n  // The streams are merged back in only here, at the boundary. The polling\n  // fallback never populates them — its JSON snapshots already carry the full\n  // output — so this is a no-op on that transport.\n  const snapshots = useMemo(\n    () => current\n      ? Object.values(byId).map((snapshot) => withTaskStreams(snapshot, streamsById[snapshot.id]))\n      : [],\n    [current, byId, streamsById],\n  );\n\n  return { snapshots, status: current ? status : \"idle\", isComplete: current && isComplete };\n}\n\nexport interface UseTaskRunsOptions extends TaskTransportOptions {\n  kind?: string | undefined;\n  status?: string | undefined;\n  /** Label equality filters (k=v). */\n  labels?: Record<string, string> | undefined;\n}\n\n/** The identity of the listing request that produced a given `runs` array. */\nexport type TaskRunsKey = ReturnType<typeof taskQueryKeys.runs>;\n\nexport interface UseTaskRunsResult {\n  runs: TaskRunMeta[];\n  status: string;\n  /**\n   * Query key of the request that actually produced `runs`, or null before the\n   * first frame arrives. Changing `kind`/`status`/`labels` re-subscribes but\n   * keeps the previous listing on screen until the new transport delivers, so\n   * this key lags `taskQueryKeys.runs(options)` during that window. A consumer\n   * mirroring `runs` into a cache must compare the two and skip the write while\n   * they differ, or it publishes rows that do not match the requested filters.\n   */\n  runsKey: TaskRunsKey | null;\n}\n\n// useTaskRuns lists all runs (TaskRunMeta) for the manager view. It is SSE-first:\n// it subscribes to clicky's runs stream (event: runs carrying the full listing)\n// and falls back to polling the JSON runs endpoint only when EventSource is\n// unavailable or forced off. The listing has no completion terminal of its own —\n// a manager view stays subscribed to observe new and changing runs.\nexport function useTaskRuns(options: UseTaskRunsOptions = {}): UseTaskRunsResult {\n  const {\n    kind,\n    status: statusFilter,\n    labels,\n    basePath = DEFAULT_BASE,\n    enabled = true,\n    pollMs = DEFAULT_POLL_MS,\n    forcePoll = false,\n  } = options;\n\n  // Runs are stored together with the key of the request that delivered them, so\n  // a stale listing can never be mistaken for the current filters' result.\n  const [received, setReceived] = useState<{\n    key: TaskRunsKey | null;\n    runs: TaskRunMeta[];\n  }>({ key: null, runs: [] });\n  const [status, setStatus] = useState(\"idle\");\n\n  useEffect(() => {\n    if (!enabled) return;\n\n    const params = new URLSearchParams();\n    if (kind) params.set(\"kind\", kind);\n    if (statusFilter) params.set(\"status\", statusFilter);\n    for (const [k, v] of Object.entries(labels ?? {})) params.append(\"label\", `${k}=${v}`);\n    const query = params.toString();\n    const requestKey = taskQueryKeys.runs({ basePath, kind, status: statusFilter, labels });\n    const receive = (next: TaskRunMeta[]) => setReceived({ key: requestKey, runs: next });\n\n    // Polling fallback transport.\n    if (forcePoll || !hasEventSource()) {\n      let stopped = false;\n      let timer: ReturnType<typeof setTimeout> | undefined;\n      const tick = async () => {\n        try {\n          const res = await fetch(`${basePath}/tasks${query ? `?${query}` : \"\"}`, {\n            headers: { Accept: \"application/json\" },\n          });\n          if (!res.ok) throw new Error(`Task listing failed with ${res.status}`);\n          if (res.ok) {\n            const next = (await res.json()) as TaskRunMeta[];\n            if (stopped) return;\n            receive(next);\n            setStatus(\"polling\");\n          }\n        } catch {\n          if (!stopped) setStatus(\"connection lost — retrying\");\n        }\n        if (!stopped) timer = setTimeout(tick, pollMs);\n      };\n      void tick();\n      return () => {\n        stopped = true;\n        if (timer) clearTimeout(timer);\n      };\n    }\n\n    // SSE transport (default).\n    const es = new EventSource(`${basePath}/tasks/runs/stream${query ? `?${query}` : \"\"}`);\n    setStatus(\"connecting\");\n    es.onopen = () => setStatus(\"connected\");\n    es.addEventListener(\"runs\", (e) => {\n      try {\n        receive(JSON.parse((e as MessageEvent).data) as TaskRunMeta[]);\n        setStatus(\"connected\");\n      } catch {\n        setStatus(\"invalid task listing data\");\n      }\n    });\n    es.onerror = () => setStatus(\"connection lost — retrying\");\n    return () => es.close();\n  }, [kind, statusFilter, JSON.stringify(labels ?? {}), basePath, enabled, pollMs, forcePoll]);\n\n  return { runs: received.runs, status, runsKey: received.key };\n}\n"],"names":[],"mappings":";;;;AA+BA,MAAM,eAAe;AACrB,MAAM,kBAAkB;AAExB,SAAS,UAAU,MAAc,OAAuB;AACtD,SAAO,GAAG,IAAI,gBAAgB,QAAQ,IAAI,KAAK,KAAK,EAAE;AACxD;AAEA,SAAS,iBAA0B;AACjC,SAAO,OAAO,eAAe,eAAe,OAAO,WAAW,gBAAgB;AAChF;AAoBO,SAAS,WAAW,UAA6B,IAAsB;AAC5E,QAAM;AAAA,IACJ;AAAA,IACA;AAAA,IACA;AAAA,IACA,WAAW;AAAA,IACX,UAAU;AAAA,IACV,SAAS;AAAA,IACT,YAAY;AAAA,EAAA,IACV;AACJ,QAAM,cAAa,2BAAK,OAAO,cAAa,KAAK,CAAC,EAAE,IAAI,CAAA,IAAK,KAAK,GAAG;AAIrE,QAAM,kBAAkB,KAAK,UAAU,CAAC,WAAW,QAAQ,IAAI,UAAU,OAAO,CAAC;AACjF,QAAM,CAAC,UAAU,WAAW,IAAI,SAAS,eAAe;AAExD,QAAM,CAAC,MAAM,OAAO,IAAI,SAAuC,CAAA,CAAE;AAIjE,QAAM,CAAC,aAAa,cAAc,IAAI,SAAsC,CAAA,CAAE;AAC9E,QAAM,CAAC,QAAQ,SAAS,IAAI,SAAS,MAAM;AAC3C,QAAM,CAAC,YAAY,aAAa,IAAI,SAAS,KAAK;AAElD,YAAU,MAAM;AACd,UAAM,SAAS,YAAY,UAAU,MAAM,GAAG,IAAI,CAAA;AAClD,gBAAY,eAAe;AAC3B,QAAI,CAAC,WAAY,OAAO,WAAW,KAAK,CAAC,MAAO;AAC9C,cAAQ,CAAA,CAAE;AACV,qBAAe,CAAA,CAAE;AACjB,gBAAU,MAAM;AAChB,oBAAc,KAAK;AACnB;AAAA,IACF;AACA,YAAQ,CAAA,CAAE;AACV,mBAAe,CAAA,CAAE;AACjB,kBAAc,KAAK;AAEnB,UAAM,SAAS,IAAI,gBAAA;AACnB,QAAI,OAAO,SAAS,EAAG,QAAO,IAAI,SAAS,SAAS;AACpD,QAAI,KAAM,QAAO,IAAI,QAAQ,IAAI;AACjC,UAAM,QAAQ,OAAO,SAAA;AAErB,UAAM,QAAQ,CAAC,aAA6B;AAC1C,cAAQ,CAAC,SAAS;AAChB,cAAM,OAAO,EAAE,GAAG,KAAA;AAClB,mBAAW,QAAQ,SAAU,MAAK,KAAK,SAAS,UAAU,SAAS,KAAK,WAAW,KAAK,EAAE,KAAK,KAAK,EAAE,IAAI;AAC1G,eAAO;AAAA,MACT,CAAC;AAAA,IACH;AAKA,UAAM,cAAc,CAAC,UAA2B;AAC9C,qBAAe,CAAC,UAAU;AAAA,QACxB,GAAG;AAAA,QACH,CAAC,MAAM,EAAE,GAAG,qBAAqB,KAAK,MAAM,EAAE,KAAK,kBAAkB,KAAK;AAAA,MAAA,EAC1E;AAAA,IACJ;AAGA,QAAI,aAAa,CAAC,kBAAkB;AAClC,UAAI,UAAU;AACd,UAAI;AACJ,YAAM,OAAO,YAAY;AACvB,YAAI;AACF,gBAAM,YAAY,MAAM,QAAQ,IAAI,OAAO,IAAI,CAAC,UAAU;AAAA,YACxD,GAAG,QAAQ,UAAU,mBAAmB,KAAK,CAAC;AAAA,YAC9C,EAAE,SAAS,EAAE,QAAQ,qBAAmB;AAAA,UAAE,CAC3C,CAAC;AACF,cAAI,UAAU,KAAK,CAAC,aAAa,CAAC,SAAS,EAAE,EAAG,OAAM,IAAI,MAAM,qBAAqB;AACrF,cAAI,UAAU,MAAM,CAAC,aAAa,SAAS,EAAE,GAAG;AAC9C,kBAAM,SAAS,MAAM,QAAQ,IAAI,UAAU;AAAA,cACzC,OAAO,aAAc,MAAM,SAAS,KAAA;AAAA,YAAK,CAC1C,GAAG,KAAA;AACJ,gBAAI,QAAS;AACb,kBAAM,KAAK;AACX,sBAAU,SAAS;AACnB,gBAAI,kBAAkB,KAAK,GAAG;AAC5B,4BAAc,IAAI;AAClB;AAAA,YACF;AAAA,UACF;AAAA,QACF,QAAQ;AACN,cAAI,CAAC,QAAS,WAAU,4BAA4B;AAAA,QACtD;AACA,YAAI,CAAC,QAAS,SAAQ,WAAW,MAAM,MAAM;AAAA,MAC/C;AACA,WAAK,KAAA;AACL,aAAO,MAAM;AACX,kBAAU;AACV,YAAI,oBAAoB,KAAK;AAAA,MAC/B;AAAA,IACF;AAGA,UAAM,KAAK,IAAI,YAAY,UAAU,UAAU,KAAK,CAAC;AACrD,cAAU,YAAY;AACtB,OAAG,SAAS,MAAM,UAAU,WAAW;AACvC,OAAG,iBAAiB,QAAQ,CAAC,MAAM;AACjC,UAAI;AACF,cAAM,CAAC,KAAK,MAAO,EAAmB,IAAI,CAAiB,CAAC;AAC5D,kBAAU,WAAW;AAAA,MACvB,QAAQ;AACN,kBAAU,0BAA0B;AAAA,MACtC;AAAA,IACF,CAAC;AACD,OAAG,iBAAiB,UAAU,CAAC,MAAM;AACnC,UAAI;AACF,oBAAY,KAAK,MAAO,EAAmB,IAAI,CAAoB;AAAA,MACrE,QAAQ;AACN,kBAAU,0BAA0B;AAAA,MACtC;AAAA,IACF,CAAC;AACD,OAAG,iBAAiB,QAAQ,MAAM;AAChC,gBAAU,UAAU;AACpB,oBAAc,IAAI;AAClB,SAAG,MAAA;AAAA,IACL,CAAC;AACD,OAAG,UAAU,MAAM,UAAU,4BAA4B;AACzD,WAAO,MAAM,GAAG,MAAA;AAAA,EAClB,GAAG,CAAC,iBAAiB,WAAW,MAAM,UAAU,SAAS,QAAQ,SAAS,CAAC;AAE3E,QAAM,UAAU,aAAa;AAI7B,QAAM,YAAY;AAAA,IAChB,MAAM,UACF,OAAO,OAAO,IAAI,EAAE,IAAI,CAAC,aAAa,gBAAgB,UAAU,YAAY,SAAS,EAAE,CAAC,CAAC,IACzF,CAAA;AAAA,IACJ,CAAC,SAAS,MAAM,WAAW;AAAA,EAAA;AAG7B,SAAO,EAAE,WAAW,QAAQ,UAAU,SAAS,QAAQ,YAAY,WAAW,WAAA;AAChF;AA+BO,SAAS,YAAY,UAA8B,IAAuB;AAC/E,QAAM;AAAA,IACJ;AAAA,IACA,QAAQ;AAAA,IACR;AAAA,IACA,WAAW;AAAA,IACX,UAAU;AAAA,IACV,SAAS;AAAA,IACT,YAAY;AAAA,EAAA,IACV;AAIJ,QAAM,CAAC,UAAU,WAAW,IAAI,SAG7B,EAAE,KAAK,MAAM,MAAM,CAAA,GAAI;AAC1B,QAAM,CAAC,QAAQ,SAAS,IAAI,SAAS,MAAM;AAE3C,YAAU,MAAM;AACd,QAAI,CAAC,QAAS;AAEd,UAAM,SAAS,IAAI,gBAAA;AACnB,QAAI,KAAM,QAAO,IAAI,QAAQ,IAAI;AACjC,QAAI,aAAc,QAAO,IAAI,UAAU,YAAY;AACnD,eAAW,CAAC,GAAG,CAAC,KAAK,OAAO,QAAQ,UAAU,CAAA,CAAE,UAAU,OAAO,SAAS,GAAG,CAAC,IAAI,CAAC,EAAE;AACrF,UAAM,QAAQ,OAAO,SAAA;AACrB,UAAM,aAAa,cAAc,KAAK,EAAE,UAAU,MAAM,QAAQ,cAAc,QAAQ;AACtF,UAAM,UAAU,CAAC,SAAwB,YAAY,EAAE,KAAK,YAAY,MAAM,MAAM;AAGpF,QAAI,aAAa,CAAC,kBAAkB;AAClC,UAAI,UAAU;AACd,UAAI;AACJ,YAAM,OAAO,YAAY;AACvB,YAAI;AACF,gBAAM,MAAM,MAAM,MAAM,GAAG,QAAQ,SAAS,QAAQ,IAAI,KAAK,KAAK,EAAE,IAAI;AAAA,YACtE,SAAS,EAAE,QAAQ,mBAAA;AAAA,UAAmB,CACvC;AACD,cAAI,CAAC,IAAI,GAAI,OAAM,IAAI,MAAM,4BAA4B,IAAI,MAAM,EAAE;AACrE,cAAI,IAAI,IAAI;AACV,kBAAM,OAAQ,MAAM,IAAI,KAAA;AACxB,gBAAI,QAAS;AACb,oBAAQ,IAAI;AACZ,sBAAU,SAAS;AAAA,UACrB;AAAA,QACF,QAAQ;AACN,cAAI,CAAC,QAAS,WAAU,4BAA4B;AAAA,QACtD;AACA,YAAI,CAAC,QAAS,SAAQ,WAAW,MAAM,MAAM;AAAA,MAC/C;AACA,WAAK,KAAA;AACL,aAAO,MAAM;AACX,kBAAU;AACV,YAAI,oBAAoB,KAAK;AAAA,MAC/B;AAAA,IACF;AAGA,UAAM,KAAK,IAAI,YAAY,GAAG,QAAQ,qBAAqB,QAAQ,IAAI,KAAK,KAAK,EAAE,EAAE;AACrF,cAAU,YAAY;AACtB,OAAG,SAAS,MAAM,UAAU,WAAW;AACvC,OAAG,iBAAiB,QAAQ,CAAC,MAAM;AACjC,UAAI;AACF,gBAAQ,KAAK,MAAO,EAAmB,IAAI,CAAkB;AAC7D,kBAAU,WAAW;AAAA,MACvB,QAAQ;AACN,kBAAU,2BAA2B;AAAA,MACvC;AAAA,IACF,CAAC;AACD,OAAG,UAAU,MAAM,UAAU,4BAA4B;AACzD,WAAO,MAAM,GAAG,MAAA;AAAA,EAClB,GAAG,CAAC,MAAM,cAAc,KAAK,UAAU,UAAU,CAAA,CAAE,GAAG,UAAU,SAAS,QAAQ,SAAS,CAAC;AAE3F,SAAO,EAAE,MAAM,SAAS,MAAM,QAAQ,SAAS,SAAS,IAAA;AAC1D;"}

package/dist/hooks/use-theme.cjs

@@ -1,12 +1,13 @@
 "use strict";
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
 const react = require("react");
+const useMediaQuery = require("./use-media-query.cjs");
+const PREFERS_DARK_QUERY = "(prefers-color-scheme: dark)";
 const THEME_STORAGE_KEY = "clicky-ui-theme";
 const DATA_ATTR = "data-theme";
 const ThemeContext = react.createContext(null);
 function prefersDark() {
-  if (typeof window === "undefined") return false;
-  return window.matchMedia("(prefers-color-scheme: dark)").matches;
+  return useMediaQuery.mediaMatches(PREFERS_DARK_QUERY);
 }
 function readStoredTheme() {
   if (typeof window === "undefined") return "system";
@@ -34,18 +35,19 @@ function useResolvedTheme(override) {
   const [systemResolved, setSystemResolved] = react.useState(
     () => prefersDark() ? "dark" : "light"
   );
-  react.useEffect(() => {
-    if (typeof window === "undefined") return;
-    const mq = window.matchMedia("(prefers-color-scheme: dark)");
-    const onChange = () => setSystemResolved(mq.matches ? "dark" : "light");
-    mq.addEventListener("change", onChange);
-    return () => mq.removeEventListener("change", onChange);
-  }, []);
+  react.useEffect(
+    () => useMediaQuery.onMediaChange(
+      PREFERS_DARK_QUERY,
+      (dark) => setSystemResolved(dark ? "dark" : "light")
+    ),
+    []
+  );
   if (override && override !== "system") return override;
   if (override === "system") return systemResolved;
   if (ctx) return ctx.resolvedTheme;
   return systemResolved;
 }
+exports.PREFERS_DARK_QUERY = PREFERS_DARK_QUERY;
 exports.THEME_STORAGE_KEY = THEME_STORAGE_KEY;
 exports.ThemeContext = ThemeContext;
 exports.applyTheme = applyTheme;