@flanksource/clicky-ui 0.3.17 → 0.3.18

package/dist/data.js

@@ -7,6 +7,8 @@ import { CodeBlock } from "./data/CodeBlock.js";
 import { CodeDiff } from "./data/CodeDiff.js";
 import { computeLineDiff, parseUnifiedDiff } from "./data/code-diff.js";
 import { inferColumns } from "./data/data-table-utils.js";
+import { parseMultiFilterValue, serializeMultiFilterValue, splitCommaValues, updateFilterSelection } from "./data/data-table-filter-values.js";
+import { DATA_TABLE_FILTER_LOOKUP_LIMIT, serverColumnsToDataTableColumns, serverFiltersToFilterBar } from "./data/data-table-server-filters.js";
 import { DataTable } from "./data/DataTable.js";
 import { groupRecords, isGroupCollapsedByDefault } from "./data/DataTable.grouping.js";
 import { StatStrip } from "./data/StatStrip.js";
@@ -14,6 +16,7 @@ import { EntityCell } from "./data/cells/EntityCell.js";
 import { Timestamp } from "./data/cells/Timestamp.js";
 import { chooseTimestampFormat, formatDateTimeRelative, formatRelativeTime, formatTimestamp, modeToFormat, parseTimestamp } from "./data/cells/timestamp-format.js";
 import { TagActionsProvider, TagList } from "./data/cells/TagList.js";
+import { CellFilterActions } from "./data/cells/CellFilterActions.js";
 import { normalizeTags, splitTagToken, tagActionsFromRecord, tagFilterTokens, useTagActions, useTagActionsValue } from "./data/cells/tag-utils.js";
 import { StatusDot } from "./data/cells/StatusDot.js";
 import { STATUS_TOKEN_GROUPS, normalizeStatus } from "./data/cells/status-mapping.js";
@@ -69,6 +72,7 @@ import { allGroupsTerminal, isTerminalStatus } from "./data/TaskSnapshot.js";
 import { bucketTasks, logLevelColor, taskSegments, taskStatusBg, taskStatusColor, taskStatusIcon } from "./data/task-status.js";
 import { TaskProgress } from "./data/TaskProgress.js";
 import { TaskManager } from "./data/TaskManager.js";
+import { taskQueryKeys } from "./data/task-query-keys.js";
 import { TaskManagerButton } from "./data/TaskManagerButton.js";
 import { PromptDialog } from "./data/PromptDialog.js";
 import { PromptBanner } from "./data/PromptBanner.js";
@@ -425,6 +429,7 @@ import { annotateRoutePaths, findNodeByRoutePath, slugify } from "./data/test-ru
 import { applyFixtureFrontmatterRaw, applyFixtureFrontmatterState, fixtureFrontmatterState, parseFixtureFrontmatter } from "./data/FixtureEditor/fixture-frontmatter.js";
 import { cacheQueryKeys, createCacheClient } from "./data/cache-browser/api.js";
 import { changeIconAliases, getChangeIcon } from "./icons/changeIconAliases.js";
+import { clickyIconProvider, iconsByConsumerName } from "./icons/registry.js";
 import { createChecklistMarkdown, createFenceMarkdown, fixtureFenceKind, fixtureFenceSchemaAliases, fixtureFenceSnippetInfo, parseFixtureYaml, resolveFixtureFenceSchema, schemaKeys, stringifyFixtureYaml } from "./data/FixtureEditor/fixture-blocks.js";
 import { cycleFilterState, decodeFilterState, emptyTestFilters, encodeFilterState, filterStateToRecord, matchesFilterState, recordToFilterState } from "./data/test-runner/filterState.js";
 import { formatGitCommitDateHeader } from "./data/git/git-dates.js";
@@ -442,9 +447,11 @@ export {
   CacheStatsOverview,
   CacheTree,
   CacheValue,
+  CellFilterActions,
   CodeBlock,
   CodeDiff,
   CopyBadge,
+  DATA_TABLE_FILTER_LOOKUP_LIMIT,
   DataTable,
   DiagnosticsDetailPanel,
   DiagnosticsTree,
@@ -1132,6 +1139,7 @@ export {
   changeIconAliases,
   chooseTimestampFormat,
   clickyFormatForMarkdownPreview,
+  clickyIconProvider,
   collapseSingleChildChains,
   collectFrameworks,
   compactStackPath,
@@ -1177,6 +1185,7 @@ export {
   hasHoverMeta,
   hasPending,
   humanizeName,
+  iconsByConsumerName,
   inferColumns,
   isApplicationStackFrame,
   isGroupCollapsedByDefault,
@@ -1200,6 +1209,7 @@ export {
   parseInlineJsonContextValue,
   parseJavaStackTrace,
   parseJvmThreadDump,
+  parseMultiFilterValue,
   parseServerTiming,
   parseStackDump,
   parseTimestamp,
@@ -1214,11 +1224,15 @@ export {
   resolveSeries,
   schemaKeys,
   segment,
+  serializeMultiFilterValue,
   seriesStats,
+  serverColumnsToDataTableColumns,
+  serverFiltersToFilterBar,
   serverTimingCounterSummary,
   serverTimingMetricLabel,
   setFallbackIconProvider,
   slugify,
+  splitCommaValues,
   splitTagToken,
   statusIconFor,
   statusToneFor,
@@ -1227,12 +1241,14 @@ export {
   sumNonTaskTests,
   tagActionsFromRecord,
   tagFilterTokens,
+  taskQueryKeys,
   taskSegments,
   taskStatusBg,
   taskStatusColor,
   taskStatusIcon,
   testStatus,
   totalDuration,
+  updateFilterSelection,
   usePrompts,
   useTagActions,
   useTagActionsValue,

package/dist/data.js.map

@@ -1 +1 @@
-{"version":3,"file":"data.js","sources":[],"sourcesContent":[],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;"}
+{"version":3,"file":"data.js","sources":[],"sourcesContent":[],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;"}

package/dist/hooks/use-hotkey.cjs

@@ -48,12 +48,17 @@ function isFormElement(target) {
   if (target.isContentEditable) return true;
   return ["INPUT", "TEXTAREA", "SELECT"].includes(target.tagName);
 }
+function eventOrigin(event) {
+  var _a;
+  return ((_a = event.composedPath) == null ? void 0 : _a.call(event)[0]) ?? event.target;
+}
 function onKeyDown(event) {
   if (event.defaultPrevented || event.isComposing) return;
+  const origin = eventOrigin(event);
   let winner;
   for (const registration of registrations) {
     if (!matches(event, registration.combo)) continue;
-    if (!registration.enableOnFormElements && isFormElement(event.target)) continue;
+    if (!registration.enableOnFormElements && isFormElement(origin)) continue;
     if (!winner || registration.priority >= winner.priority) winner = registration;
   }
   if (!winner) return;

package/dist/hooks/use-hotkey.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"use-hotkey.cjs","sources":["../../src/hooks/use-hotkey.ts"],"sourcesContent":["import { useEffect, useId, useRef } from \"react\";\n\n// A process-wide registry of global keyboard shortcuts, modeled on the escape\n// layer in ../overlay/modalStack. Bindings mount independently (no shared\n// provider), so the registry lives at module scope. Exactly ONE binding wins a\n// given key combo — the highest `priority`, breaking ties toward the most\n// recently mounted. Without that discipline every mounted component that binds\n// the same combo fires on one keypress, which is how two ⌘K search fields end\n// up racing to focus themselves.\n//\n// The listener is attached to `document`, matching modalStack, so hotkeys and\n// escape layers agree on event target and ordering.\n\ntype Registration = {\n  id: string;\n  combo: ParsedHotkey;\n  priority: number;\n  enableOnFormElements: boolean;\n  run: (event: KeyboardEvent) => void;\n};\n\nconst registrations: Registration[] = [];\nlet boundDocument: Document | null = null;\n\nexport type ParsedHotkey = {\n  /** Bare key, lower-cased (e.g. \"k\"). */\n  key: string;\n  /** Requires cmd on macOS / ctrl elsewhere. */\n  mod: boolean;\n  shift: boolean;\n  alt: boolean;\n};\n\nfunction isMacPlatform(): boolean {\n  if (typeof navigator === \"undefined\") return false;\n  return /mac|iphone|ipad|ipod/i.test(navigator.platform || navigator.userAgent);\n}\n\n/**\n * Parses a combo string such as `\"mod+k\"` or `\"mod+shift+p\"`. `mod` means ⌘ on\n * macOS and Ctrl elsewhere. The last segment is the key; order is irrelevant.\n */\nexport function parseHotkey(combo: string): ParsedHotkey {\n  const parts = combo\n    .split(\"+\")\n    .map((part) => part.trim().toLowerCase())\n    .filter(Boolean);\n  const key = parts[parts.length - 1];\n  if (!key) throw new Error(`useHotkey: empty combo \"${combo}\"`);\n  return {\n    key,\n    mod: parts.includes(\"mod\") || parts.includes(\"cmd\") || parts.includes(\"ctrl\"),\n    shift: parts.includes(\"shift\"),\n    alt: parts.includes(\"alt\") || parts.includes(\"option\"),\n  };\n}\n\n/**\n * Renders a combo for display — `\"mod+k\"` becomes `\"⌘K\"` on macOS and `\"Ctrl+K\"`\n * elsewhere. Deriving the label from the combo (rather than hand-authoring the\n * label and reverse-engineering the key from it) keeps the two in sync.\n */\nexport function formatHotkey(combo: string, platform?: \"mac\" | \"other\"): string {\n  const parsed = parseHotkey(combo);\n  const mac = platform ? platform === \"mac\" : isMacPlatform();\n  const key = parsed.key.length === 1 ? parsed.key.toUpperCase() : titleCase(parsed.key);\n  if (mac) {\n    return `${parsed.mod ? \"⌘\" : \"\"}${parsed.alt ? \"⌥\" : \"\"}${parsed.shift ? \"⇧\" : \"\"}${key}`;\n  }\n  const segments = [\n    ...(parsed.mod ? [\"Ctrl\"] : []),\n    ...(parsed.alt ? [\"Alt\"] : []),\n    ...(parsed.shift ? [\"Shift\"] : []),\n    key,\n  ];\n  return segments.join(\"+\");\n}\n\nfunction titleCase(value: string): string {\n  return value.charAt(0).toUpperCase() + value.slice(1);\n}\n\nfunction matches(event: KeyboardEvent, combo: ParsedHotkey): boolean {\n  if (event.key.toLowerCase() !== combo.key) return false;\n  if (combo.mod !== (event.metaKey || event.ctrlKey)) return false;\n  if (combo.shift !== event.shiftKey) return false;\n  if (combo.alt !== event.altKey) return false;\n  return true;\n}\n\nfunction isFormElement(target: EventTarget | null): boolean {\n  if (!(target instanceof HTMLElement)) return false;\n  if (target.isContentEditable) return true;\n  return [\"INPUT\", \"TEXTAREA\", \"SELECT\"].includes(target.tagName);\n}\n\nfunction onKeyDown(event: KeyboardEvent) {\n  if (event.defaultPrevented || event.isComposing) return;\n\n  // Highest priority wins; ties go to the most recently registered, so a\n  // transient surface layered over the page takes precedence over the chrome.\n  let winner: Registration | undefined;\n  for (const registration of registrations) {\n    if (!matches(event, registration.combo)) continue;\n    if (!registration.enableOnFormElements && isFormElement(event.target)) continue;\n    if (!winner || registration.priority >= winner.priority) winner = registration;\n  }\n  if (!winner) return;\n\n  event.preventDefault();\n  winner.run(event);\n}\n\nfunction ensureListener() {\n  if (boundDocument || typeof document === \"undefined\") return;\n  boundDocument = document;\n  boundDocument.addEventListener(\"keydown\", onKeyDown);\n}\n\nfunction unregister(id: string) {\n  const index = registrations.findIndex((entry) => entry.id === id);\n  if (index !== -1) registrations.splice(index, 1);\n\n  if (registrations.length === 0 && boundDocument) {\n    boundDocument.removeEventListener(\"keydown\", onKeyDown);\n    boundDocument = null;\n  }\n}\n\nexport type UseHotkeyOptions = {\n  /** Register the binding. Defaults to `true`. */\n  enabled?: boolean | undefined;\n  /**\n   * Ordering among bindings for the same combo. Higher wins; ties break toward\n   * the most recently mounted. Defaults to `0`.\n   */\n  priority?: number | undefined;\n  /**\n   * Fire while focus sits in an input, textarea, select, or contenteditable.\n   * Defaults to `true` for combos carrying a modifier (⌘K should work while\n   * typing) and `false` for bare keys (which would swallow ordinary typing).\n   */\n  enableOnFormElements?: boolean | undefined;\n};\n\n/**\n * Binds a global keyboard shortcut for as long as the component is mounted and\n * `enabled`. Pass `null`/`undefined` as the combo to bind nothing. Only the\n * winning registration for a combo runs, so overlapping bindings cannot both\n * fire on a single keypress.\n */\nexport function useHotkey(\n  combo: string | null | undefined,\n  handler: (event: KeyboardEvent) => void,\n  options: UseHotkeyOptions = {},\n): void {\n  const id = useId();\n  const handlerRef = useRef(handler);\n  handlerRef.current = handler;\n\n  const { enabled = true, priority = 0, enableOnFormElements } = options;\n\n  useEffect(() => {\n    if (!combo || !enabled) return;\n    const parsed = parseHotkey(combo);\n\n    ensureListener();\n    registrations.push({\n      id,\n      combo: parsed,\n      priority,\n      enableOnFormElements: enableOnFormElements ?? parsed.mod,\n      run: (event) => handlerRef.current(event),\n    });\n\n    return () => unregister(id);\n  }, [combo, enabled, priority, enableOnFormElements, id]);\n}\n"],"names":["useId","useRef","useEffect"],"mappings":"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"}
+{"version":3,"file":"use-hotkey.cjs","sources":["../../src/hooks/use-hotkey.ts"],"sourcesContent":["import { useEffect, useId, useRef } from \"react\";\n\n// A process-wide registry of global keyboard shortcuts, modeled on the escape\n// layer in ../overlay/modalStack. Bindings mount independently (no shared\n// provider), so the registry lives at module scope. Exactly ONE binding wins a\n// given key combo — the highest `priority`, breaking ties toward the most\n// recently mounted. Without that discipline every mounted component that binds\n// the same combo fires on one keypress, which is how two ⌘K search fields end\n// up racing to focus themselves.\n//\n// The listener is attached to `document`, matching modalStack, so hotkeys and\n// escape layers agree on event target and ordering.\n\ntype Registration = {\n  id: string;\n  combo: ParsedHotkey;\n  priority: number;\n  enableOnFormElements: boolean;\n  run: (event: KeyboardEvent) => void;\n};\n\nconst registrations: Registration[] = [];\nlet boundDocument: Document | null = null;\n\nexport type ParsedHotkey = {\n  /** Bare key, lower-cased (e.g. \"k\"). */\n  key: string;\n  /** Requires cmd on macOS / ctrl elsewhere. */\n  mod: boolean;\n  shift: boolean;\n  alt: boolean;\n};\n\nfunction isMacPlatform(): boolean {\n  if (typeof navigator === \"undefined\") return false;\n  return /mac|iphone|ipad|ipod/i.test(navigator.platform || navigator.userAgent);\n}\n\n/**\n * Parses a combo string such as `\"mod+k\"` or `\"mod+shift+p\"`. `mod` means ⌘ on\n * macOS and Ctrl elsewhere. The last segment is the key; order is irrelevant.\n */\nexport function parseHotkey(combo: string): ParsedHotkey {\n  const parts = combo\n    .split(\"+\")\n    .map((part) => part.trim().toLowerCase())\n    .filter(Boolean);\n  const key = parts[parts.length - 1];\n  if (!key) throw new Error(`useHotkey: empty combo \"${combo}\"`);\n  return {\n    key,\n    mod: parts.includes(\"mod\") || parts.includes(\"cmd\") || parts.includes(\"ctrl\"),\n    shift: parts.includes(\"shift\"),\n    alt: parts.includes(\"alt\") || parts.includes(\"option\"),\n  };\n}\n\n/**\n * Renders a combo for display — `\"mod+k\"` becomes `\"⌘K\"` on macOS and `\"Ctrl+K\"`\n * elsewhere. Deriving the label from the combo (rather than hand-authoring the\n * label and reverse-engineering the key from it) keeps the two in sync.\n */\nexport function formatHotkey(combo: string, platform?: \"mac\" | \"other\"): string {\n  const parsed = parseHotkey(combo);\n  const mac = platform ? platform === \"mac\" : isMacPlatform();\n  const key = parsed.key.length === 1 ? parsed.key.toUpperCase() : titleCase(parsed.key);\n  if (mac) {\n    return `${parsed.mod ? \"⌘\" : \"\"}${parsed.alt ? \"⌥\" : \"\"}${parsed.shift ? \"⇧\" : \"\"}${key}`;\n  }\n  const segments = [\n    ...(parsed.mod ? [\"Ctrl\"] : []),\n    ...(parsed.alt ? [\"Alt\"] : []),\n    ...(parsed.shift ? [\"Shift\"] : []),\n    key,\n  ];\n  return segments.join(\"+\");\n}\n\nfunction titleCase(value: string): string {\n  return value.charAt(0).toUpperCase() + value.slice(1);\n}\n\nfunction matches(event: KeyboardEvent, combo: ParsedHotkey): boolean {\n  if (event.key.toLowerCase() !== combo.key) return false;\n  if (combo.mod !== (event.metaKey || event.ctrlKey)) return false;\n  if (combo.shift !== event.shiftKey) return false;\n  if (combo.alt !== event.altKey) return false;\n  return true;\n}\n\nfunction isFormElement(target: EventTarget | null): boolean {\n  if (!(target instanceof HTMLElement)) return false;\n  if (target.isContentEditable) return true;\n  return [\"INPUT\", \"TEXTAREA\", \"SELECT\"].includes(target.tagName);\n}\n\n// Across a shadow boundary `event.target` is retargeted to the shadow HOST, so a\n// key typed into an input inside a shadow root looks like a bare keypress on a\n// <div> and would fire hotkeys that must not fire while typing. The composed\n// path's first entry is the true origin.\nfunction eventOrigin(event: KeyboardEvent): EventTarget | null {\n  return event.composedPath?.()[0] ?? event.target;\n}\n\nfunction onKeyDown(event: KeyboardEvent) {\n  if (event.defaultPrevented || event.isComposing) return;\n\n  // Highest priority wins; ties go to the most recently registered, so a\n  // transient surface layered over the page takes precedence over the chrome.\n  const origin = eventOrigin(event);\n  let winner: Registration | undefined;\n  for (const registration of registrations) {\n    if (!matches(event, registration.combo)) continue;\n    if (!registration.enableOnFormElements && isFormElement(origin)) continue;\n    if (!winner || registration.priority >= winner.priority) winner = registration;\n  }\n  if (!winner) return;\n\n  event.preventDefault();\n  winner.run(event);\n}\n\nfunction ensureListener() {\n  if (boundDocument || typeof document === \"undefined\") return;\n  boundDocument = document;\n  boundDocument.addEventListener(\"keydown\", onKeyDown);\n}\n\nfunction unregister(id: string) {\n  const index = registrations.findIndex((entry) => entry.id === id);\n  if (index !== -1) registrations.splice(index, 1);\n\n  if (registrations.length === 0 && boundDocument) {\n    boundDocument.removeEventListener(\"keydown\", onKeyDown);\n    boundDocument = null;\n  }\n}\n\nexport type UseHotkeyOptions = {\n  /** Register the binding. Defaults to `true`. */\n  enabled?: boolean | undefined;\n  /**\n   * Ordering among bindings for the same combo. Higher wins; ties break toward\n   * the most recently mounted. Defaults to `0`.\n   */\n  priority?: number | undefined;\n  /**\n   * Fire while focus sits in an input, textarea, select, or contenteditable.\n   * Defaults to `true` for combos carrying a modifier (⌘K should work while\n   * typing) and `false` for bare keys (which would swallow ordinary typing).\n   */\n  enableOnFormElements?: boolean | undefined;\n};\n\n/**\n * Binds a global keyboard shortcut for as long as the component is mounted and\n * `enabled`. Pass `null`/`undefined` as the combo to bind nothing. Only the\n * winning registration for a combo runs, so overlapping bindings cannot both\n * fire on a single keypress.\n */\nexport function useHotkey(\n  combo: string | null | undefined,\n  handler: (event: KeyboardEvent) => void,\n  options: UseHotkeyOptions = {},\n): void {\n  const id = useId();\n  const handlerRef = useRef(handler);\n  handlerRef.current = handler;\n\n  const { enabled = true, priority = 0, enableOnFormElements } = options;\n\n  useEffect(() => {\n    if (!combo || !enabled) return;\n    const parsed = parseHotkey(combo);\n\n    ensureListener();\n    registrations.push({\n      id,\n      combo: parsed,\n      priority,\n      enableOnFormElements: enableOnFormElements ?? parsed.mod,\n      run: (event) => handlerRef.current(event),\n    });\n\n    return () => unregister(id);\n  }, [combo, enabled, priority, enableOnFormElements, id]);\n}\n"],"names":["useId","useRef","useEffect"],"mappings":"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"}

package/dist/hooks/use-hotkey.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"use-hotkey.d.ts","sourceRoot":"","sources":["../../src/hooks/use-hotkey.ts"],"names":[],"mappings":"AAwBA,MAAM,MAAM,YAAY,GAAG;IACzB,wCAAwC;IACxC,GAAG,EAAE,MAAM,CAAC;IACZ,8CAA8C;IAC9C,GAAG,EAAE,OAAO,CAAC;IACb,KAAK,EAAE,OAAO,CAAC;IACf,GAAG,EAAE,OAAO,CAAC;CACd,CAAC;AAOF;;;GAGG;AACH,wBAAgB,WAAW,CAAC,KAAK,EAAE,MAAM,GAAG,YAAY,CAavD;AAED;;;;GAIG;AACH,wBAAgB,YAAY,CAAC,KAAK,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,KAAK,GAAG,OAAO,GAAG,MAAM,CAc9E;AAqDD,MAAM,MAAM,gBAAgB,GAAG;IAC7B,gDAAgD;IAChD,OAAO,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;IAC9B;;;OAGG;IACH,QAAQ,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC9B;;;;OAIG;IACH,oBAAoB,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;CAC5C,CAAC;AAEF;;;;;GAKG;AACH,wBAAgB,SAAS,CACvB,KAAK,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,EAChC,OAAO,EAAE,CAAC,KAAK,EAAE,aAAa,KAAK,IAAI,EACvC,OAAO,GAAE,gBAAqB,GAC7B,IAAI,CAsBN"}
+{"version":3,"file":"use-hotkey.d.ts","sourceRoot":"","sources":["../../src/hooks/use-hotkey.ts"],"names":[],"mappings":"AAwBA,MAAM,MAAM,YAAY,GAAG;IACzB,wCAAwC;IACxC,GAAG,EAAE,MAAM,CAAC;IACZ,8CAA8C;IAC9C,GAAG,EAAE,OAAO,CAAC;IACb,KAAK,EAAE,OAAO,CAAC;IACf,GAAG,EAAE,OAAO,CAAC;CACd,CAAC;AAOF;;;GAGG;AACH,wBAAgB,WAAW,CAAC,KAAK,EAAE,MAAM,GAAG,YAAY,CAavD;AAED;;;;GAIG;AACH,wBAAgB,YAAY,CAAC,KAAK,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,KAAK,GAAG,OAAO,GAAG,MAAM,CAc9E;AA8DD,MAAM,MAAM,gBAAgB,GAAG;IAC7B,gDAAgD;IAChD,OAAO,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;IAC9B;;;OAGG;IACH,QAAQ,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC9B;;;;OAIG;IACH,oBAAoB,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;CAC5C,CAAC;AAEF;;;;;GAKG;AACH,wBAAgB,SAAS,CACvB,KAAK,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,EAChC,OAAO,EAAE,CAAC,KAAK,EAAE,aAAa,KAAK,IAAI,EACvC,OAAO,GAAE,gBAAqB,GAC7B,IAAI,CAsBN"}

package/dist/hooks/use-hotkey.js

@@ -46,12 +46,17 @@ function isFormElement(target) {
   if (target.isContentEditable) return true;
   return ["INPUT", "TEXTAREA", "SELECT"].includes(target.tagName);
 }
+function eventOrigin(event) {
+  var _a;
+  return ((_a = event.composedPath) == null ? void 0 : _a.call(event)[0]) ?? event.target;
+}
 function onKeyDown(event) {
   if (event.defaultPrevented || event.isComposing) return;
+  const origin = eventOrigin(event);
   let winner;
   for (const registration of registrations) {
     if (!matches(event, registration.combo)) continue;
-    if (!registration.enableOnFormElements && isFormElement(event.target)) continue;
+    if (!registration.enableOnFormElements && isFormElement(origin)) continue;
     if (!winner || registration.priority >= winner.priority) winner = registration;
   }
   if (!winner) return;

package/dist/hooks/use-hotkey.js.map

@@ -1 +1 @@
-{"version":3,"file":"use-hotkey.js","sources":["../../src/hooks/use-hotkey.ts"],"sourcesContent":["import { useEffect, useId, useRef } from \"react\";\n\n// A process-wide registry of global keyboard shortcuts, modeled on the escape\n// layer in ../overlay/modalStack. Bindings mount independently (no shared\n// provider), so the registry lives at module scope. Exactly ONE binding wins a\n// given key combo — the highest `priority`, breaking ties toward the most\n// recently mounted. Without that discipline every mounted component that binds\n// the same combo fires on one keypress, which is how two ⌘K search fields end\n// up racing to focus themselves.\n//\n// The listener is attached to `document`, matching modalStack, so hotkeys and\n// escape layers agree on event target and ordering.\n\ntype Registration = {\n  id: string;\n  combo: ParsedHotkey;\n  priority: number;\n  enableOnFormElements: boolean;\n  run: (event: KeyboardEvent) => void;\n};\n\nconst registrations: Registration[] = [];\nlet boundDocument: Document | null = null;\n\nexport type ParsedHotkey = {\n  /** Bare key, lower-cased (e.g. \"k\"). */\n  key: string;\n  /** Requires cmd on macOS / ctrl elsewhere. */\n  mod: boolean;\n  shift: boolean;\n  alt: boolean;\n};\n\nfunction isMacPlatform(): boolean {\n  if (typeof navigator === \"undefined\") return false;\n  return /mac|iphone|ipad|ipod/i.test(navigator.platform || navigator.userAgent);\n}\n\n/**\n * Parses a combo string such as `\"mod+k\"` or `\"mod+shift+p\"`. `mod` means ⌘ on\n * macOS and Ctrl elsewhere. The last segment is the key; order is irrelevant.\n */\nexport function parseHotkey(combo: string): ParsedHotkey {\n  const parts = combo\n    .split(\"+\")\n    .map((part) => part.trim().toLowerCase())\n    .filter(Boolean);\n  const key = parts[parts.length - 1];\n  if (!key) throw new Error(`useHotkey: empty combo \"${combo}\"`);\n  return {\n    key,\n    mod: parts.includes(\"mod\") || parts.includes(\"cmd\") || parts.includes(\"ctrl\"),\n    shift: parts.includes(\"shift\"),\n    alt: parts.includes(\"alt\") || parts.includes(\"option\"),\n  };\n}\n\n/**\n * Renders a combo for display — `\"mod+k\"` becomes `\"⌘K\"` on macOS and `\"Ctrl+K\"`\n * elsewhere. Deriving the label from the combo (rather than hand-authoring the\n * label and reverse-engineering the key from it) keeps the two in sync.\n */\nexport function formatHotkey(combo: string, platform?: \"mac\" | \"other\"): string {\n  const parsed = parseHotkey(combo);\n  const mac = platform ? platform === \"mac\" : isMacPlatform();\n  const key = parsed.key.length === 1 ? parsed.key.toUpperCase() : titleCase(parsed.key);\n  if (mac) {\n    return `${parsed.mod ? \"⌘\" : \"\"}${parsed.alt ? \"⌥\" : \"\"}${parsed.shift ? \"⇧\" : \"\"}${key}`;\n  }\n  const segments = [\n    ...(parsed.mod ? [\"Ctrl\"] : []),\n    ...(parsed.alt ? [\"Alt\"] : []),\n    ...(parsed.shift ? [\"Shift\"] : []),\n    key,\n  ];\n  return segments.join(\"+\");\n}\n\nfunction titleCase(value: string): string {\n  return value.charAt(0).toUpperCase() + value.slice(1);\n}\n\nfunction matches(event: KeyboardEvent, combo: ParsedHotkey): boolean {\n  if (event.key.toLowerCase() !== combo.key) return false;\n  if (combo.mod !== (event.metaKey || event.ctrlKey)) return false;\n  if (combo.shift !== event.shiftKey) return false;\n  if (combo.alt !== event.altKey) return false;\n  return true;\n}\n\nfunction isFormElement(target: EventTarget | null): boolean {\n  if (!(target instanceof HTMLElement)) return false;\n  if (target.isContentEditable) return true;\n  return [\"INPUT\", \"TEXTAREA\", \"SELECT\"].includes(target.tagName);\n}\n\nfunction onKeyDown(event: KeyboardEvent) {\n  if (event.defaultPrevented || event.isComposing) return;\n\n  // Highest priority wins; ties go to the most recently registered, so a\n  // transient surface layered over the page takes precedence over the chrome.\n  let winner: Registration | undefined;\n  for (const registration of registrations) {\n    if (!matches(event, registration.combo)) continue;\n    if (!registration.enableOnFormElements && isFormElement(event.target)) continue;\n    if (!winner || registration.priority >= winner.priority) winner = registration;\n  }\n  if (!winner) return;\n\n  event.preventDefault();\n  winner.run(event);\n}\n\nfunction ensureListener() {\n  if (boundDocument || typeof document === \"undefined\") return;\n  boundDocument = document;\n  boundDocument.addEventListener(\"keydown\", onKeyDown);\n}\n\nfunction unregister(id: string) {\n  const index = registrations.findIndex((entry) => entry.id === id);\n  if (index !== -1) registrations.splice(index, 1);\n\n  if (registrations.length === 0 && boundDocument) {\n    boundDocument.removeEventListener(\"keydown\", onKeyDown);\n    boundDocument = null;\n  }\n}\n\nexport type UseHotkeyOptions = {\n  /** Register the binding. Defaults to `true`. */\n  enabled?: boolean | undefined;\n  /**\n   * Ordering among bindings for the same combo. Higher wins; ties break toward\n   * the most recently mounted. Defaults to `0`.\n   */\n  priority?: number | undefined;\n  /**\n   * Fire while focus sits in an input, textarea, select, or contenteditable.\n   * Defaults to `true` for combos carrying a modifier (⌘K should work while\n   * typing) and `false` for bare keys (which would swallow ordinary typing).\n   */\n  enableOnFormElements?: boolean | undefined;\n};\n\n/**\n * Binds a global keyboard shortcut for as long as the component is mounted and\n * `enabled`. Pass `null`/`undefined` as the combo to bind nothing. Only the\n * winning registration for a combo runs, so overlapping bindings cannot both\n * fire on a single keypress.\n */\nexport function useHotkey(\n  combo: string | null | undefined,\n  handler: (event: KeyboardEvent) => void,\n  options: UseHotkeyOptions = {},\n): void {\n  const id = useId();\n  const handlerRef = useRef(handler);\n  handlerRef.current = handler;\n\n  const { enabled = true, priority = 0, enableOnFormElements } = options;\n\n  useEffect(() => {\n    if (!combo || !enabled) return;\n    const parsed = parseHotkey(combo);\n\n    ensureListener();\n    registrations.push({\n      id,\n      combo: parsed,\n      priority,\n      enableOnFormElements: enableOnFormElements ?? parsed.mod,\n      run: (event) => handlerRef.current(event),\n    });\n\n    return () => unregister(id);\n  }, [combo, enabled, priority, enableOnFormElements, id]);\n}\n"],"names":[],"mappings":"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"}
+{"version":3,"file":"use-hotkey.js","sources":["../../src/hooks/use-hotkey.ts"],"sourcesContent":["import { useEffect, useId, useRef } from \"react\";\n\n// A process-wide registry of global keyboard shortcuts, modeled on the escape\n// layer in ../overlay/modalStack. Bindings mount independently (no shared\n// provider), so the registry lives at module scope. Exactly ONE binding wins a\n// given key combo — the highest `priority`, breaking ties toward the most\n// recently mounted. Without that discipline every mounted component that binds\n// the same combo fires on one keypress, which is how two ⌘K search fields end\n// up racing to focus themselves.\n//\n// The listener is attached to `document`, matching modalStack, so hotkeys and\n// escape layers agree on event target and ordering.\n\ntype Registration = {\n  id: string;\n  combo: ParsedHotkey;\n  priority: number;\n  enableOnFormElements: boolean;\n  run: (event: KeyboardEvent) => void;\n};\n\nconst registrations: Registration[] = [];\nlet boundDocument: Document | null = null;\n\nexport type ParsedHotkey = {\n  /** Bare key, lower-cased (e.g. \"k\"). */\n  key: string;\n  /** Requires cmd on macOS / ctrl elsewhere. */\n  mod: boolean;\n  shift: boolean;\n  alt: boolean;\n};\n\nfunction isMacPlatform(): boolean {\n  if (typeof navigator === \"undefined\") return false;\n  return /mac|iphone|ipad|ipod/i.test(navigator.platform || navigator.userAgent);\n}\n\n/**\n * Parses a combo string such as `\"mod+k\"` or `\"mod+shift+p\"`. `mod` means ⌘ on\n * macOS and Ctrl elsewhere. The last segment is the key; order is irrelevant.\n */\nexport function parseHotkey(combo: string): ParsedHotkey {\n  const parts = combo\n    .split(\"+\")\n    .map((part) => part.trim().toLowerCase())\n    .filter(Boolean);\n  const key = parts[parts.length - 1];\n  if (!key) throw new Error(`useHotkey: empty combo \"${combo}\"`);\n  return {\n    key,\n    mod: parts.includes(\"mod\") || parts.includes(\"cmd\") || parts.includes(\"ctrl\"),\n    shift: parts.includes(\"shift\"),\n    alt: parts.includes(\"alt\") || parts.includes(\"option\"),\n  };\n}\n\n/**\n * Renders a combo for display — `\"mod+k\"` becomes `\"⌘K\"` on macOS and `\"Ctrl+K\"`\n * elsewhere. Deriving the label from the combo (rather than hand-authoring the\n * label and reverse-engineering the key from it) keeps the two in sync.\n */\nexport function formatHotkey(combo: string, platform?: \"mac\" | \"other\"): string {\n  const parsed = parseHotkey(combo);\n  const mac = platform ? platform === \"mac\" : isMacPlatform();\n  const key = parsed.key.length === 1 ? parsed.key.toUpperCase() : titleCase(parsed.key);\n  if (mac) {\n    return `${parsed.mod ? \"⌘\" : \"\"}${parsed.alt ? \"⌥\" : \"\"}${parsed.shift ? \"⇧\" : \"\"}${key}`;\n  }\n  const segments = [\n    ...(parsed.mod ? [\"Ctrl\"] : []),\n    ...(parsed.alt ? [\"Alt\"] : []),\n    ...(parsed.shift ? [\"Shift\"] : []),\n    key,\n  ];\n  return segments.join(\"+\");\n}\n\nfunction titleCase(value: string): string {\n  return value.charAt(0).toUpperCase() + value.slice(1);\n}\n\nfunction matches(event: KeyboardEvent, combo: ParsedHotkey): boolean {\n  if (event.key.toLowerCase() !== combo.key) return false;\n  if (combo.mod !== (event.metaKey || event.ctrlKey)) return false;\n  if (combo.shift !== event.shiftKey) return false;\n  if (combo.alt !== event.altKey) return false;\n  return true;\n}\n\nfunction isFormElement(target: EventTarget | null): boolean {\n  if (!(target instanceof HTMLElement)) return false;\n  if (target.isContentEditable) return true;\n  return [\"INPUT\", \"TEXTAREA\", \"SELECT\"].includes(target.tagName);\n}\n\n// Across a shadow boundary `event.target` is retargeted to the shadow HOST, so a\n// key typed into an input inside a shadow root looks like a bare keypress on a\n// <div> and would fire hotkeys that must not fire while typing. The composed\n// path's first entry is the true origin.\nfunction eventOrigin(event: KeyboardEvent): EventTarget | null {\n  return event.composedPath?.()[0] ?? event.target;\n}\n\nfunction onKeyDown(event: KeyboardEvent) {\n  if (event.defaultPrevented || event.isComposing) return;\n\n  // Highest priority wins; ties go to the most recently registered, so a\n  // transient surface layered over the page takes precedence over the chrome.\n  const origin = eventOrigin(event);\n  let winner: Registration | undefined;\n  for (const registration of registrations) {\n    if (!matches(event, registration.combo)) continue;\n    if (!registration.enableOnFormElements && isFormElement(origin)) continue;\n    if (!winner || registration.priority >= winner.priority) winner = registration;\n  }\n  if (!winner) return;\n\n  event.preventDefault();\n  winner.run(event);\n}\n\nfunction ensureListener() {\n  if (boundDocument || typeof document === \"undefined\") return;\n  boundDocument = document;\n  boundDocument.addEventListener(\"keydown\", onKeyDown);\n}\n\nfunction unregister(id: string) {\n  const index = registrations.findIndex((entry) => entry.id === id);\n  if (index !== -1) registrations.splice(index, 1);\n\n  if (registrations.length === 0 && boundDocument) {\n    boundDocument.removeEventListener(\"keydown\", onKeyDown);\n    boundDocument = null;\n  }\n}\n\nexport type UseHotkeyOptions = {\n  /** Register the binding. Defaults to `true`. */\n  enabled?: boolean | undefined;\n  /**\n   * Ordering among bindings for the same combo. Higher wins; ties break toward\n   * the most recently mounted. Defaults to `0`.\n   */\n  priority?: number | undefined;\n  /**\n   * Fire while focus sits in an input, textarea, select, or contenteditable.\n   * Defaults to `true` for combos carrying a modifier (⌘K should work while\n   * typing) and `false` for bare keys (which would swallow ordinary typing).\n   */\n  enableOnFormElements?: boolean | undefined;\n};\n\n/**\n * Binds a global keyboard shortcut for as long as the component is mounted and\n * `enabled`. Pass `null`/`undefined` as the combo to bind nothing. Only the\n * winning registration for a combo runs, so overlapping bindings cannot both\n * fire on a single keypress.\n */\nexport function useHotkey(\n  combo: string | null | undefined,\n  handler: (event: KeyboardEvent) => void,\n  options: UseHotkeyOptions = {},\n): void {\n  const id = useId();\n  const handlerRef = useRef(handler);\n  handlerRef.current = handler;\n\n  const { enabled = true, priority = 0, enableOnFormElements } = options;\n\n  useEffect(() => {\n    if (!combo || !enabled) return;\n    const parsed = parseHotkey(combo);\n\n    ensureListener();\n    registrations.push({\n      id,\n      combo: parsed,\n      priority,\n      enableOnFormElements: enableOnFormElements ?? parsed.mod,\n      run: (event) => handlerRef.current(event),\n    });\n\n    return () => unregister(id);\n  }, [combo, enabled, priority, enableOnFormElements, id]);\n}\n"],"names":[],"mappings":"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"}

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 taskQueryKeys = require("../data/task-query-keys.cjs");
 const DEFAULT_BASE = "/api/v1";
 const DEFAULT_POLL_MS = 2e3;
 function streamUrl(base, query) {
@@ -122,7 +123,7 @@ function useTaskRuns(options = {}) {
     pollMs = DEFAULT_POLL_MS,
     forcePoll = false
   } = options;
-  const [runs, setRuns] = react.useState([]);
+  const [received, setReceived] = react.useState({ key: null, runs: [] });
   const [status, setStatus] = react.useState("idle");
   react.useEffect(() => {
     if (!enabled) return;
@@ -131,6 +132,8 @@ function useTaskRuns(options = {}) {
     if (statusFilter) params.set("status", statusFilter);
     for (const [k, v] of Object.entries(labels ?? {})) params.append("label", `${k}=${v}`);
     const query = params.toString();
+    const requestKey = taskQueryKeys.taskQueryKeys.runs({ basePath, kind, status: statusFilter, labels });
+    const receive = (next) => setReceived({ key: requestKey, runs: next });
     if (forcePoll || !hasEventSource()) {
       let stopped = false;
       let timer;
@@ -140,7 +143,7 @@ function useTaskRuns(options = {}) {
             headers: { Accept: "application/json" }
           });
           if (res.ok) {
-            setRuns(await res.json());
+            receive(await res.json());
             setStatus("polling");
           }
         } catch {
@@ -158,14 +161,14 @@ function useTaskRuns(options = {}) {
     setStatus("connected");
     es.addEventListener("runs", (e) => {
       try {
-        setRuns(JSON.parse(e.data));
+        receive(JSON.parse(e.data));
       } catch {
       }
     });
     es.onerror = () => setStatus("connection lost — retrying");
     return () => es.close();
   }, [kind, statusFilter, JSON.stringify(labels ?? {}), basePath, enabled, pollMs, forcePoll]);
-  return { runs, status };
+  return { runs: received.runs, status, runsKey: received.key };
 }
 exports.useTaskRun = useTaskRun;
 exports.useTaskRuns = useTaskRuns;

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, useRef, useState } from \"react\";\nimport {\n  allGroupsTerminal,\n  type TaskRunMeta,\n  type TaskSnapshot,\n} from \"../data/TaskSnapshot\";\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 kind. */\n  id?: string | undefined;\n  /** Follow every run of a kind. */\n  kind?: string | undefined;\n}\n\n// useTaskRun follows one run (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    kind,\n    basePath = DEFAULT_BASE,\n    enabled = true,\n    pollMs = DEFAULT_POLL_MS,\n    forcePoll = false,\n  } = options;\n\n  const [byId, setById] = useState<Record<string, TaskSnapshot>>({});\n  const [status, setStatus] = useState(\"idle\");\n  const [isComplete, setIsComplete] = useState(false);\n  // Reset accumulator whenever the subscription target changes.\n  const targetKey = `${id ?? \"\"}|${kind ?? \"\"}|${enabled}`;\n  const prevKey = useRef(targetKey);\n  if (prevKey.current !== targetKey) {\n    prevKey.current = targetKey;\n  }\n\n  useEffect(() => {\n    if (!enabled || (!id && !kind)) {\n      return;\n    }\n    setById({});\n    setIsComplete(false);\n\n    const params = new URLSearchParams();\n    if (id) params.set(\"tasks\", id);\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.id] = { ...next[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 res = await fetch(`${basePath}/tasks/${encodeURIComponent(id ?? \"\")}`, {\n            headers: { Accept: \"application/json\" },\n          });\n          if (res.ok) {\n            const snaps = (await res.json()) as TaskSnapshot[];\n            merge(snaps);\n            setStatus(\"polling\");\n            if (allGroupsTerminal(snaps)) {\n              setIsComplete(true);\n              return; // stop polling\n            }\n          }\n        } catch {\n          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(\"connected\");\n    es.addEventListener(\"task\", (e) => {\n      try {\n        merge([JSON.parse((e as MessageEvent).data) as TaskSnapshot]);\n      } catch {\n        /* ignore malformed frame */\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        /* ignore malformed frame */\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  }, [id, 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\nexport interface UseTaskRunsResult {\n  runs: TaskRunMeta[];\n  status: string;\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  const [runs, setRuns] = useState<TaskRunMeta[]>([]);\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\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) {\n            setRuns((await res.json()) as TaskRunMeta[]);\n            setStatus(\"polling\");\n          }\n        } catch {\n          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(\"connected\");\n    es.addEventListener(\"runs\", (e) => {\n      try {\n        setRuns(JSON.parse((e as MessageEvent).data) as TaskRunMeta[]);\n      } catch {\n        /* ignore malformed frame */\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, status };\n}\n"],"names":["useState","useRef","useEffect","allGroupsTerminal"],"mappings":"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"}
+{"version":3,"file":"use-task-run.cjs","sources":["../../src/hooks/use-task-run.ts"],"sourcesContent":["import { useEffect, useRef, 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 kind. */\n  id?: string | undefined;\n  /** Follow every run of a kind. */\n  kind?: string | undefined;\n}\n\n// useTaskRun follows one run (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    kind,\n    basePath = DEFAULT_BASE,\n    enabled = true,\n    pollMs = DEFAULT_POLL_MS,\n    forcePoll = false,\n  } = options;\n\n  const [byId, setById] = useState<Record<string, TaskSnapshot>>({});\n  const [status, setStatus] = useState(\"idle\");\n  const [isComplete, setIsComplete] = useState(false);\n  // Reset accumulator whenever the subscription target changes.\n  const targetKey = `${id ?? \"\"}|${kind ?? \"\"}|${enabled}`;\n  const prevKey = useRef(targetKey);\n  if (prevKey.current !== targetKey) {\n    prevKey.current = targetKey;\n  }\n\n  useEffect(() => {\n    if (!enabled || (!id && !kind)) {\n      return;\n    }\n    setById({});\n    setIsComplete(false);\n\n    const params = new URLSearchParams();\n    if (id) params.set(\"tasks\", id);\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.id] = { ...next[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 res = await fetch(`${basePath}/tasks/${encodeURIComponent(id ?? \"\")}`, {\n            headers: { Accept: \"application/json\" },\n          });\n          if (res.ok) {\n            const snaps = (await res.json()) as TaskSnapshot[];\n            merge(snaps);\n            setStatus(\"polling\");\n            if (allGroupsTerminal(snaps)) {\n              setIsComplete(true);\n              return; // stop polling\n            }\n          }\n        } catch {\n          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(\"connected\");\n    es.addEventListener(\"task\", (e) => {\n      try {\n        merge([JSON.parse((e as MessageEvent).data) as TaskSnapshot]);\n      } catch {\n        /* ignore malformed frame */\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        /* ignore malformed frame */\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  }, [id, 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) {\n            receive((await res.json()) as TaskRunMeta[]);\n            setStatus(\"polling\");\n          }\n        } catch {\n          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(\"connected\");\n    es.addEventListener(\"runs\", (e) => {\n      try {\n        receive(JSON.parse((e as MessageEvent).data) as TaskRunMeta[]);\n      } catch {\n        /* ignore malformed frame */\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","useRef","useEffect","allGroupsTerminal","taskQueryKeys"],"mappings":"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"}

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

@@ -1,4 +1,5 @@
 import { TaskRunMeta, TaskSnapshot } from '../data/TaskSnapshot';
+import { taskQueryKeys } from '../data/task-query-keys';
 export interface TaskTransportOptions {
     /** Base path of the clicky task API, e.g. "/api/v1". */
     basePath?: string | undefined;
@@ -27,9 +28,20 @@ export interface UseTaskRunsOptions extends TaskTransportOptions {
     /** Label equality filters (k=v). */
     labels?: Record<string, string> | undefined;
 }
+/** The identity of the listing request that produced a given `runs` array. */
+export type TaskRunsKey = ReturnType<typeof taskQueryKeys.runs>;
 export interface UseTaskRunsResult {
     runs: TaskRunMeta[];
     status: string;
+    /**
+     * Query key of the request that actually produced `runs`, or null before the
+     * first frame arrives. Changing `kind`/`status`/`labels` re-subscribes but
+     * keeps the previous listing on screen until the new transport delivers, so
+     * this key lags `taskQueryKeys.runs(options)` during that window. A consumer
+     * mirroring `runs` into a cache must compare the two and skip the write while
+     * they differ, or it publishes rows that do not match the requested filters.
+     */
+    runsKey: TaskRunsKey | null;
 }
 export declare function useTaskRuns(options?: UseTaskRunsOptions): UseTaskRunsResult;
 //# sourceMappingURL=use-task-run.d.ts.map

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;AAO9B,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,0EAA0E;IAC1E,EAAE,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACxB,kCAAkC;IAClC,IAAI,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;CAC3B;AAKD,wBAAgB,UAAU,CAAC,OAAO,GAAE,iBAAsB,GAAG,gBAAgB,CAwH5E;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,MAAM,WAAW,iBAAiB;IAChC,IAAI,EAAE,WAAW,EAAE,CAAC;IACpB,MAAM,EAAE,MAAM,CAAC;CAChB;AAOD,wBAAgB,WAAW,CAAC,OAAO,GAAE,kBAAuB,GAAG,iBAAiB,CA+D/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;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,0EAA0E;IAC1E,EAAE,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACxB,kCAAkC;IAClC,IAAI,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;CAC3B;AAKD,wBAAgB,UAAU,CAAC,OAAO,GAAE,iBAAsB,GAAG,gBAAgB,CAwH5E;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,CAsE/E"}

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

@@ -1,5 +1,6 @@
 import { useState, useRef, useEffect } from "react";
 import { allGroupsTerminal } from "../data/TaskSnapshot.js";
+import { taskQueryKeys } from "../data/task-query-keys.js";
 const DEFAULT_BASE = "/api/v1";
 const DEFAULT_POLL_MS = 2e3;
 function streamUrl(base, query) {
@@ -120,7 +121,7 @@ function useTaskRuns(options = {}) {
     pollMs = DEFAULT_POLL_MS,
     forcePoll = false
   } = options;
-  const [runs, setRuns] = useState([]);
+  const [received, setReceived] = useState({ key: null, runs: [] });
   const [status, setStatus] = useState("idle");
   useEffect(() => {
     if (!enabled) return;
@@ -129,6 +130,8 @@ function useTaskRuns(options = {}) {
     if (statusFilter) params.set("status", statusFilter);
     for (const [k, v] of Object.entries(labels ?? {})) params.append("label", `${k}=${v}`);
     const query = params.toString();
+    const requestKey = taskQueryKeys.runs({ basePath, kind, status: statusFilter, labels });
+    const receive = (next) => setReceived({ key: requestKey, runs: next });
     if (forcePoll || !hasEventSource()) {
       let stopped = false;
       let timer;
@@ -138,7 +141,7 @@ function useTaskRuns(options = {}) {
             headers: { Accept: "application/json" }
           });
           if (res.ok) {
-            setRuns(await res.json());
+            receive(await res.json());
             setStatus("polling");
           }
         } catch {
@@ -156,14 +159,14 @@ function useTaskRuns(options = {}) {
     setStatus("connected");
     es.addEventListener("runs", (e) => {
       try {
-        setRuns(JSON.parse(e.data));
+        receive(JSON.parse(e.data));
       } catch {
       }
     });
     es.onerror = () => setStatus("connection lost — retrying");
     return () => es.close();
   }, [kind, statusFilter, JSON.stringify(labels ?? {}), basePath, enabled, pollMs, forcePoll]);
-  return { runs, status };
+  return { runs: received.runs, status, runsKey: received.key };
 }
 export {
   useTaskRun,

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, useRef, useState } from \"react\";\nimport {\n  allGroupsTerminal,\n  type TaskRunMeta,\n  type TaskSnapshot,\n} from \"../data/TaskSnapshot\";\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 kind. */\n  id?: string | undefined;\n  /** Follow every run of a kind. */\n  kind?: string | undefined;\n}\n\n// useTaskRun follows one run (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    kind,\n    basePath = DEFAULT_BASE,\n    enabled = true,\n    pollMs = DEFAULT_POLL_MS,\n    forcePoll = false,\n  } = options;\n\n  const [byId, setById] = useState<Record<string, TaskSnapshot>>({});\n  const [status, setStatus] = useState(\"idle\");\n  const [isComplete, setIsComplete] = useState(false);\n  // Reset accumulator whenever the subscription target changes.\n  const targetKey = `${id ?? \"\"}|${kind ?? \"\"}|${enabled}`;\n  const prevKey = useRef(targetKey);\n  if (prevKey.current !== targetKey) {\n    prevKey.current = targetKey;\n  }\n\n  useEffect(() => {\n    if (!enabled || (!id && !kind)) {\n      return;\n    }\n    setById({});\n    setIsComplete(false);\n\n    const params = new URLSearchParams();\n    if (id) params.set(\"tasks\", id);\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.id] = { ...next[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 res = await fetch(`${basePath}/tasks/${encodeURIComponent(id ?? \"\")}`, {\n            headers: { Accept: \"application/json\" },\n          });\n          if (res.ok) {\n            const snaps = (await res.json()) as TaskSnapshot[];\n            merge(snaps);\n            setStatus(\"polling\");\n            if (allGroupsTerminal(snaps)) {\n              setIsComplete(true);\n              return; // stop polling\n            }\n          }\n        } catch {\n          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(\"connected\");\n    es.addEventListener(\"task\", (e) => {\n      try {\n        merge([JSON.parse((e as MessageEvent).data) as TaskSnapshot]);\n      } catch {\n        /* ignore malformed frame */\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        /* ignore malformed frame */\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  }, [id, 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\nexport interface UseTaskRunsResult {\n  runs: TaskRunMeta[];\n  status: string;\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  const [runs, setRuns] = useState<TaskRunMeta[]>([]);\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\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) {\n            setRuns((await res.json()) as TaskRunMeta[]);\n            setStatus(\"polling\");\n          }\n        } catch {\n          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(\"connected\");\n    es.addEventListener(\"runs\", (e) => {\n      try {\n        setRuns(JSON.parse((e as MessageEvent).data) as TaskRunMeta[]);\n      } catch {\n        /* ignore malformed frame */\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, status };\n}\n"],"names":[],"mappings":";;AAuBA,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;AAkBO,SAAS,WAAW,UAA6B,IAAsB;AAC5E,QAAM;AAAA,IACJ;AAAA,IACA;AAAA,IACA,WAAW;AAAA,IACX,UAAU;AAAA,IACV,SAAS;AAAA,IACT,YAAY;AAAA,EAAA,IACV;AAEJ,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,QAAM,YAAY,GAAG,MAAM,EAAE,IAAI,QAAQ,EAAE,IAAI,OAAO;AACtD,QAAM,UAAU,OAAO,SAAS;AAChC,MAAI,QAAQ,YAAY,WAAW;AACjC,YAAQ,UAAU;AAAA,EACpB;AAEA,YAAU,MAAM;AACd,QAAI,CAAC,WAAY,CAAC,MAAM,CAAC,MAAO;AAC9B;AAAA,IACF;AACA,YAAQ,CAAA,CAAE;AACV,kBAAc,KAAK;AAEnB,UAAM,SAAS,IAAI,gBAAA;AACnB,QAAI,GAAI,QAAO,IAAI,SAAS,EAAE;AAC9B,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,EAAE,IAAI,EAAE,GAAG,KAAK,KAAK,EAAE,GAAG,GAAG,KAAA;AACpE,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,MAAM,MAAM,MAAM,GAAG,QAAQ,UAAU,mBAAmB,MAAM,EAAE,CAAC,IAAI;AAAA,YAC3E,SAAS,EAAE,QAAQ,mBAAA;AAAA,UAAmB,CACvC;AACD,cAAI,IAAI,IAAI;AACV,kBAAM,QAAS,MAAM,IAAI,KAAA;AACzB,kBAAM,KAAK;AACX,sBAAU,SAAS;AACnB,gBAAI,kBAAkB,KAAK,GAAG;AAC5B,4BAAc,IAAI;AAClB;AAAA,YACF;AAAA,UACF;AAAA,QACF,QAAQ;AACN,oBAAU,4BAA4B;AAAA,QACxC;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,WAAW;AACrB,OAAG,iBAAiB,QAAQ,CAAC,MAAM;AACjC,UAAI;AACF,cAAM,CAAC,KAAK,MAAO,EAAmB,IAAI,CAAiB,CAAC;AAAA,MAC9D,QAAQ;AAAA,MAER;AAAA,IACF,CAAC;AACD,OAAG,iBAAiB,UAAU,CAAC,MAAM;AACnC,UAAI;AACF,oBAAY,KAAK,MAAO,EAAmB,IAAI,CAAsC;AAAA,MACvF,QAAQ;AAAA,MAER;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,IAAI,MAAM,UAAU,SAAS,QAAQ,SAAS,CAAC;AAEnD,SAAO,EAAE,WAAW,OAAO,OAAO,IAAI,GAAG,QAAQ,WAAA;AACnD;AAmBO,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;AAEJ,QAAM,CAAC,MAAM,OAAO,IAAI,SAAwB,CAAA,CAAE;AAClD,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;AAGrB,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,IAAI,IAAI;AACV,oBAAS,MAAM,IAAI,MAAwB;AAC3C,sBAAU,SAAS;AAAA,UACrB;AAAA,QACF,QAAQ;AACN,oBAAU,4BAA4B;AAAA,QACxC;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,WAAW;AACrB,OAAG,iBAAiB,QAAQ,CAAC,MAAM;AACjC,UAAI;AACF,gBAAQ,KAAK,MAAO,EAAmB,IAAI,CAAkB;AAAA,MAC/D,QAAQ;AAAA,MAER;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,OAAA;AACjB;"}
+{"version":3,"file":"use-task-run.js","sources":["../../src/hooks/use-task-run.ts"],"sourcesContent":["import { useEffect, useRef, 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 kind. */\n  id?: string | undefined;\n  /** Follow every run of a kind. */\n  kind?: string | undefined;\n}\n\n// useTaskRun follows one run (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    kind,\n    basePath = DEFAULT_BASE,\n    enabled = true,\n    pollMs = DEFAULT_POLL_MS,\n    forcePoll = false,\n  } = options;\n\n  const [byId, setById] = useState<Record<string, TaskSnapshot>>({});\n  const [status, setStatus] = useState(\"idle\");\n  const [isComplete, setIsComplete] = useState(false);\n  // Reset accumulator whenever the subscription target changes.\n  const targetKey = `${id ?? \"\"}|${kind ?? \"\"}|${enabled}`;\n  const prevKey = useRef(targetKey);\n  if (prevKey.current !== targetKey) {\n    prevKey.current = targetKey;\n  }\n\n  useEffect(() => {\n    if (!enabled || (!id && !kind)) {\n      return;\n    }\n    setById({});\n    setIsComplete(false);\n\n    const params = new URLSearchParams();\n    if (id) params.set(\"tasks\", id);\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.id] = { ...next[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 res = await fetch(`${basePath}/tasks/${encodeURIComponent(id ?? \"\")}`, {\n            headers: { Accept: \"application/json\" },\n          });\n          if (res.ok) {\n            const snaps = (await res.json()) as TaskSnapshot[];\n            merge(snaps);\n            setStatus(\"polling\");\n            if (allGroupsTerminal(snaps)) {\n              setIsComplete(true);\n              return; // stop polling\n            }\n          }\n        } catch {\n          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(\"connected\");\n    es.addEventListener(\"task\", (e) => {\n      try {\n        merge([JSON.parse((e as MessageEvent).data) as TaskSnapshot]);\n      } catch {\n        /* ignore malformed frame */\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        /* ignore malformed frame */\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  }, [id, 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) {\n            receive((await res.json()) as TaskRunMeta[]);\n            setStatus(\"polling\");\n          }\n        } catch {\n          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(\"connected\");\n    es.addEventListener(\"runs\", (e) => {\n      try {\n        receive(JSON.parse((e as MessageEvent).data) as TaskRunMeta[]);\n      } catch {\n        /* ignore malformed frame */\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":"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"}

package/dist/icons/index.d.ts

@@ -588,4 +588,5 @@ export { UiCloudUploadFilled } from './components/UiCloudUpload';
 export type { IconProps, IconComponent } from './types';
 export { changeIconAliases, getChangeIcon } from './changeIconAliases';
 export type { ChangeIconEntry } from './changeIconAliases';
+export { clickyIconProvider, iconsByConsumerName } from './registry';
 //# sourceMappingURL=index.d.ts.map