@athenaintel/react 0.40.0 → 0.40.2

package/dist/chat/run-activity.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"run-activity.cjs","sources":["../../src/chat/run-activity.ts"],"sourcesContent":["import { getToolDisplayMeta } from '@athenaintel/agent-runtime';\n\n/**\n * Run-liveness key for a streaming assistant message.\n *\n * A tool card's spinner says \"this call is running\"; nothing says the RUN is\n * still alive once parts exist — a stalled stream and a busy one look\n * identical. The activity key summarizes the message tail: it is `null` when\n * no liveness row should show (no parts yet, or a text/reasoning tail that\n * already animates on its own), and otherwise changes whenever anything\n * streams into the tail part — so an elapsed timer keyed on it measures\n * \"time since the stream last moved\", not just \"time since the call began\".\n */\nexport function runActivityKey(parts: ReadonlyArray<unknown>): string | null {\n  const tail = tailPart(parts);\n  if (!tail) return null;\n  const type = typeof tail['type'] === 'string' ? (tail['type'] as string) : 'unknown';\n  if (type === 'text' || type === 'reasoning') return null;\n  const argsText = typeof tail['argsText'] === 'string' ? (tail['argsText'] as string).length : 0;\n  const settled = tail['result'] === undefined ? 0 : 1;\n  return `${parts.length}:${type}:${argsText}:${settled}`;\n}\n\n/**\n * The present-tense verb for what the run is doing right now — the registry's\n * activity label for a tool call still awaiting its result (\"Searching the\n * web\") — or `null` when the tail is not an unsettled tool call.\n */\nexport function runActivityVerb(parts: ReadonlyArray<unknown>): string | null {\n  const tail = tailPart(parts);\n  if (!tail || tail['type'] !== 'tool-call' || tail['result'] !== undefined) return null;\n  const toolName = tail['toolName'];\n  if (typeof toolName !== 'string' || toolName.length === 0) return null;\n  return getToolDisplayMeta(toolName).activeLabel;\n}\n\nfunction tailPart(parts: ReadonlyArray<unknown>): Record<string, unknown> | null {\n  const last = parts[parts.length - 1];\n  if (last === undefined || last === null || typeof last !== 'object') return null;\n  return last as Record<string, unknown>;\n}\n\n/** Seconds without any streamed change before the row flips to a stall tone. */\nexport const RUN_ACTIVITY_STALL_SECONDS = 30;\n\n/** Seconds before the row starts showing its elapsed counter. */\nexport const RUN_ACTIVITY_COUNTER_SECONDS = 3;\n\n/** The default verb when nothing more specific is known. */\nexport const RUN_ACTIVITY_DEFAULT_VERB = 'Thinking';\n\n/**\n * The counter alone for a card whose header already names the verb: `null`\n * until it is due, then \"11s\" / \"1m 05s\". The stall tone is the caller's\n * (a color and an announcement), not more words on the header row.\n */\nexport function runElapsedLabel(seconds: number): string | null {\n  if (seconds < RUN_ACTIVITY_COUNTER_SECONDS) return null;\n  if (seconds < 60) return `${seconds}s`;\n  const minutes = Math.floor(seconds / 60);\n  const remainder = seconds % 60;\n  return `${minutes}m ${String(remainder).padStart(2, '0')}s`;\n}\n\n/**\n * The status line for `seconds` since the stream last moved: the verb with an\n * ellipsis, the elapsed counter once it is due, and the stall tone.\n */\nexport function runActivityLabel(seconds: number, verb: string = RUN_ACTIVITY_DEFAULT_VERB): string {\n  if (seconds >= RUN_ACTIVITY_STALL_SECONDS) {\n    return `Still working — nothing new for ${seconds}s`;\n  }\n  if (seconds >= RUN_ACTIVITY_COUNTER_SECONDS) {\n    return `${verb}… · ${seconds}s`;\n  }\n  return `${verb}…`;\n}\n"],"names":["getToolDisplayMeta"],"mappings":";;;AAaO,SAAS,eAAe,OAA8C;AAC3E,QAAM,OAAO,SAAS,KAAK;AAC3B,MAAI,CAAC,KAAM,QAAO;AAClB,QAAM,OAAO,OAAO,KAAK,MAAM,MAAM,WAAY,KAAK,MAAM,IAAe;AAC3E,MAAI,SAAS,UAAU,SAAS,YAAa,QAAO;AACpD,QAAM,WAAW,OAAO,KAAK,UAAU,MAAM,WAAY,KAAK,UAAU,EAAa,SAAS;AAC9F,QAAM,UAAU,KAAK,QAAQ,MAAM,SAAY,IAAI;AACnD,SAAO,GAAG,MAAM,MAAM,IAAI,IAAI,IAAI,QAAQ,IAAI,OAAO;AACvD;AAOO,SAAS,gBAAgB,OAA8C;AAC5E,QAAM,OAAO,SAAS,KAAK;AAC3B,MAAI,CAAC,QAAQ,KAAK,MAAM,MAAM,eAAe,KAAK,QAAQ,MAAM,OAAW,QAAO;AAClF,QAAM,WAAW,KAAK,UAAU;AAChC,MAAI,OAAO,aAAa,YAAY,SAAS,WAAW,EAAG,QAAO;AAClE,SAAOA,aAAAA,mBAAmB,QAAQ,EAAE;AACtC;AAEA,SAAS,SAAS,OAA+D;AAC/E,QAAM,OAAO,MAAM,MAAM,SAAS,CAAC;AACnC,MAAI,SAAS,UAAa,SAAS,QAAQ,OAAO,SAAS,SAAU,QAAO;AAC5E,SAAO;AACT;AAGO,MAAM,6BAA6B;AAGnC,MAAM,+BAA+B;AAGrC,MAAM,4BAA4B;AAOlC,SAAS,gBAAgB,SAAgC;AAC9D,MAAI,UAAU,6BAA8B,QAAO;AACnD,MAAI,UAAU,GAAI,QAAO,GAAG,OAAO;AACnC,QAAM,UAAU,KAAK,MAAM,UAAU,EAAE;AACvC,QAAM,YAAY,UAAU;AAC5B,SAAO,GAAG,OAAO,KAAK,OAAO,SAAS,EAAE,SAAS,GAAG,GAAG,CAAC;AAC1D;AAMO,SAAS,iBAAiB,SAAiB,OAAe,2BAAmC;AAClG,MAAI,WAAW,4BAA4B;AACzC,WAAO,mCAAmC,OAAO;AAAA,EACnD;AACA,MAAI,WAAW,8BAA8B;AAC3C,WAAO,GAAG,IAAI,OAAO,OAAO;AAAA,EAC9B;AACA,SAAO,GAAG,IAAI;AAChB;;;;;;;;"}
+{"version":3,"file":"run-activity.cjs","sources":["../../src/chat/run-activity.ts"],"sourcesContent":["import { getToolDisplayMeta } from '@athenaintel/agent-runtime';\nimport { isStreamingToolPlaceholder } from './super-grouping/activity-timeline';\n\n/**\n * Run-liveness key for a streaming assistant message.\n *\n * A tool card's spinner says \"this call is running\"; nothing says the RUN is\n * still alive once parts exist — a stalled stream and a busy one look\n * identical. The activity key summarizes the message tail: it is `null` when\n * no liveness row should show (no parts yet, or a text/reasoning tail that\n * already animates on its own), and otherwise changes whenever anything\n * streams into the tail part. The stall clock itself keys on\n * {@link runProgressKey}, which also moves while a text or reasoning tail grows.\n */\nexport function runActivityKey(parts: ReadonlyArray<unknown>): string | null {\n  const tail = tailPart(parts);\n  if (!tail) return null;\n  const type = tailType(tail);\n  if (type === 'text' || type === 'reasoning') return null;\n  return tailActivityKey({ tail, type, partCount: parts.length });\n}\n\n/**\n * Characters of streamed text or reasoning per step of {@link runProgressKey}.\n * The model writes a step within a second at any ordinary streaming rate, so\n * the stall clock restarts about as often as words arrive, while the small\n * meta that reads the key re-renders once per step, never once per token. Only\n * a stream slower than one step per stall window (about two characters a\n * second) could read as quiet while it writes.\n */\nexport const RUN_PROGRESS_TEXT_STEP = 64;\n\n/**\n * The stall clock's key for a streaming assistant message: it changes\n * whenever anything streams, so a timer keyed on it counts the seconds\n * nothing has streamed, which is what the stall tone says\n * ({@link isRunActivityStalled}). A part added, a tool call's arguments\n * growing, a result landing, or the tail's text or reasoning growing by\n * another {@link RUN_PROGRESS_TEXT_STEP} characters each move it. A primitive,\n * so a selector returning it re-renders nothing while the stream is still.\n * A tail that is not text or reasoning keys as {@link runActivityKey} does.\n */\nexport function runProgressKey(parts: ReadonlyArray<unknown>): string {\n  const tail = tailPart(parts);\n  if (!tail) return String(parts.length);\n  const type = tailType(tail);\n  if (type !== 'text' && type !== 'reasoning') {\n    return tailActivityKey({ tail, type, partCount: parts.length });\n  }\n  const text = tail['text'];\n  const step = Math.floor((typeof text === 'string' ? text.length : 0) / RUN_PROGRESS_TEXT_STEP);\n  return `${parts.length}:${type}:${step}`;\n}\n\nfunction tailType(tail: Record<string, unknown>): string {\n  const type = tail['type'];\n  return typeof type === 'string' ? type : 'unknown';\n}\n\n/** What a tool-call (or any other non-text) tail has streamed: its arguments so far, and whether its result is in. */\nfunction tailActivityKey({\n  tail,\n  type,\n  partCount,\n}: {\n  tail: Record<string, unknown>;\n  type: string;\n  partCount: number;\n}): string {\n  const argsText = tail['argsText'];\n  const argsLength = typeof argsText === 'string' ? argsText.length : 0;\n  // A streaming placeholder is not a result: the key moves when the real one replaces it.\n  const settled = hasNoResultYet(tail) ? 0 : 1;\n  return `${partCount}:${type}:${argsLength}:${settled}`;\n}\n\n/**\n * The present-tense verb for what the run is doing right now — the registry's\n * activity label for a tool call still awaiting its result (\"Searching the\n * web\") — or `null` when the tail is not a tool call in flight.\n */\nexport function runActivityVerb(parts: ReadonlyArray<unknown>): string | null {\n  const tail = tailPart(parts);\n  if (!tail || !isTailToolCallRunning(tail)) return null;\n  const toolName = tail['toolName'];\n  if (typeof toolName !== 'string' || toolName.length === 0) return null;\n  return getToolDisplayMeta(toolName).activeLabel;\n}\n\n/**\n * Whether the run is waiting on a tool that is still running: the tail part\n * is a tool call with no result yet, or only the streaming placeholder a\n * long tool (Python execution, a task subagent) publishes while it works. A\n * command, a build or a test suite streams nothing for minutes while it\n * works, so a quiet stream then is work, not a stall.\n */\nexport function isToolCallInFlight(parts: ReadonlyArray<unknown>): boolean {\n  const tail = tailPart(parts);\n  return tail !== null && isTailToolCallRunning(tail);\n}\n\nfunction isTailToolCallRunning(tail: Record<string, unknown>): boolean {\n  return tail['type'] === 'tool-call' && hasNoResultYet(tail);\n}\n\n/** No result yet: none at all, or only the streaming placeholder (`isStreamingToolPlaceholder`). */\nfunction hasNoResultYet(tail: Record<string, unknown>): boolean {\n  return tail['result'] === undefined || isStreamingToolPlaceholder({ artifact: tail['artifact'] });\n}\n\nfunction tailPart(parts: ReadonlyArray<unknown>): Record<string, unknown> | null {\n  const last = parts[parts.length - 1];\n  if (last === undefined || last === null || typeof last !== 'object') return null;\n  return last as Record<string, unknown>;\n}\n\n/**\n * Seconds without any streamed change before the row flips to a stall tone —\n * while the run waits on the model, never while a tool call is in flight\n * ({@link isRunActivityStalled}).\n */\nexport const RUN_ACTIVITY_STALL_SECONDS = 30;\n\n/**\n * Whether the run looks stalled: nothing has streamed for\n * {@link RUN_ACTIVITY_STALL_SECONDS} while it waits on the model. Never while a\n * tool call is in flight: the call's own row says it is running.\n */\nexport function isRunActivityStalled({\n  seconds,\n  toolCallInFlight,\n}: {\n  seconds: number;\n  toolCallInFlight: boolean;\n}): boolean {\n  return !toolCallInFlight && seconds >= RUN_ACTIVITY_STALL_SECONDS;\n}\n\n/** Seconds before the row starts showing its elapsed counter. */\nexport const RUN_ACTIVITY_COUNTER_SECONDS = 3;\n\n/** The default verb when nothing more specific is known. */\nexport const RUN_ACTIVITY_DEFAULT_VERB = 'Thinking';\n\n/**\n * The counter alone for a card whose header already names the verb: `null`\n * until it is due, then \"11s\" / \"1m 05s\". The stall tone is the caller's\n * (a color and an announcement), not more words on the header row.\n */\nexport function runElapsedLabel(seconds: number): string | null {\n  if (seconds < RUN_ACTIVITY_COUNTER_SECONDS) return null;\n  if (seconds < 60) return `${seconds}s`;\n  const minutes = Math.floor(seconds / 60);\n  const remainder = seconds % 60;\n  return `${minutes}m ${String(remainder).padStart(2, '0')}s`;\n}\n\n/**\n * The status line for `seconds` since the stream last moved: the verb with an\n * ellipsis and the elapsed counter once it is due (`runElapsedLabel`), or the\n * stall wording when the run looks `stalled` ({@link isRunActivityStalled}).\n */\nexport function runActivityLabel({\n  seconds,\n  verb = RUN_ACTIVITY_DEFAULT_VERB,\n  stalled,\n}: {\n  seconds: number;\n  verb?: string;\n  stalled: boolean;\n}): string {\n  if (stalled) return `Still working — nothing new for ${seconds}s`;\n  const elapsed = runElapsedLabel(seconds);\n  return elapsed === null ? `${verb}…` : `${verb}… · ${elapsed}`;\n}\n"],"names":["getToolDisplayMeta","isStreamingToolPlaceholder"],"mappings":";;;;AAcO,SAAS,eAAe,OAA8C;AAC3E,QAAM,OAAO,SAAS,KAAK;AAC3B,MAAI,CAAC,KAAM,QAAO;AAClB,QAAM,OAAO,SAAS,IAAI;AAC1B,MAAI,SAAS,UAAU,SAAS,YAAa,QAAO;AACpD,SAAO,gBAAgB,EAAE,MAAM,MAAM,WAAW,MAAM,QAAQ;AAChE;AAUO,MAAM,yBAAyB;AAY/B,SAAS,eAAe,OAAuC;AACpE,QAAM,OAAO,SAAS,KAAK;AAC3B,MAAI,CAAC,KAAM,QAAO,OAAO,MAAM,MAAM;AACrC,QAAM,OAAO,SAAS,IAAI;AAC1B,MAAI,SAAS,UAAU,SAAS,aAAa;AAC3C,WAAO,gBAAgB,EAAE,MAAM,MAAM,WAAW,MAAM,QAAQ;AAAA,EAChE;AACA,QAAM,OAAO,KAAK,MAAM;AACxB,QAAM,OAAO,KAAK,OAAO,OAAO,SAAS,WAAW,KAAK,SAAS,KAAK,sBAAsB;AAC7F,SAAO,GAAG,MAAM,MAAM,IAAI,IAAI,IAAI,IAAI;AACxC;AAEA,SAAS,SAAS,MAAuC;AACvD,QAAM,OAAO,KAAK,MAAM;AACxB,SAAO,OAAO,SAAS,WAAW,OAAO;AAC3C;AAGA,SAAS,gBAAgB;AAAA,EACvB;AAAA,EACA;AAAA,EACA;AACF,GAIW;AACT,QAAM,WAAW,KAAK,UAAU;AAChC,QAAM,aAAa,OAAO,aAAa,WAAW,SAAS,SAAS;AAEpE,QAAM,UAAU,eAAe,IAAI,IAAI,IAAI;AAC3C,SAAO,GAAG,SAAS,IAAI,IAAI,IAAI,UAAU,IAAI,OAAO;AACtD;AAOO,SAAS,gBAAgB,OAA8C;AAC5E,QAAM,OAAO,SAAS,KAAK;AAC3B,MAAI,CAAC,QAAQ,CAAC,sBAAsB,IAAI,EAAG,QAAO;AAClD,QAAM,WAAW,KAAK,UAAU;AAChC,MAAI,OAAO,aAAa,YAAY,SAAS,WAAW,EAAG,QAAO;AAClE,SAAOA,aAAAA,mBAAmB,QAAQ,EAAE;AACtC;AASO,SAAS,mBAAmB,OAAwC;AACzE,QAAM,OAAO,SAAS,KAAK;AAC3B,SAAO,SAAS,QAAQ,sBAAsB,IAAI;AACpD;AAEA,SAAS,sBAAsB,MAAwC;AACrE,SAAO,KAAK,MAAM,MAAM,eAAe,eAAe,IAAI;AAC5D;AAGA,SAAS,eAAe,MAAwC;AAC9D,SAAO,KAAK,QAAQ,MAAM,UAAaC,iBAAAA,2BAA2B,EAAE,UAAU,KAAK,UAAU,GAAG;AAClG;AAEA,SAAS,SAAS,OAA+D;AAC/E,QAAM,OAAO,MAAM,MAAM,SAAS,CAAC;AACnC,MAAI,SAAS,UAAa,SAAS,QAAQ,OAAO,SAAS,SAAU,QAAO;AAC5E,SAAO;AACT;AAOO,MAAM,6BAA6B;AAOnC,SAAS,qBAAqB;AAAA,EACnC;AAAA,EACA;AACF,GAGY;AACV,SAAO,CAAC,oBAAoB,WAAW;AACzC;AAGO,MAAM,+BAA+B;AAGrC,MAAM,4BAA4B;AAOlC,SAAS,gBAAgB,SAAgC;AAC9D,MAAI,UAAU,6BAA8B,QAAO;AACnD,MAAI,UAAU,GAAI,QAAO,GAAG,OAAO;AACnC,QAAM,UAAU,KAAK,MAAM,UAAU,EAAE;AACvC,QAAM,YAAY,UAAU;AAC5B,SAAO,GAAG,OAAO,KAAK,OAAO,SAAS,EAAE,SAAS,GAAG,GAAG,CAAC;AAC1D;AAOO,SAAS,iBAAiB;AAAA,EAC/B;AAAA,EACA,OAAO;AAAA,EACP;AACF,GAIW;AACT,MAAI,QAAS,QAAO,mCAAmC,OAAO;AAC9D,QAAM,UAAU,gBAAgB,OAAO;AACvC,SAAO,YAAY,OAAO,GAAG,IAAI,MAAM,GAAG,IAAI,OAAO,OAAO;AAC9D;;;;;;;;;;;;"}

package/dist/chat/run-activity.d.ts

@@ -6,18 +6,59 @@
  * identical. The activity key summarizes the message tail: it is `null` when
  * no liveness row should show (no parts yet, or a text/reasoning tail that
  * already animates on its own), and otherwise changes whenever anything
- * streams into the tail part — so an elapsed timer keyed on it measures
- * "time since the stream last moved", not just "time since the call began".
+ * streams into the tail part. The stall clock itself keys on
+ * {@link runProgressKey}, which also moves while a text or reasoning tail grows.
  */
 export declare function runActivityKey(parts: ReadonlyArray<unknown>): string | null;
+/**
+ * Characters of streamed text or reasoning per step of {@link runProgressKey}.
+ * The model writes a step within a second at any ordinary streaming rate, so
+ * the stall clock restarts about as often as words arrive, while the small
+ * meta that reads the key re-renders once per step, never once per token. Only
+ * a stream slower than one step per stall window (about two characters a
+ * second) could read as quiet while it writes.
+ */
+export declare const RUN_PROGRESS_TEXT_STEP = 64;
+/**
+ * The stall clock's key for a streaming assistant message: it changes
+ * whenever anything streams, so a timer keyed on it counts the seconds
+ * nothing has streamed, which is what the stall tone says
+ * ({@link isRunActivityStalled}). A part added, a tool call's arguments
+ * growing, a result landing, or the tail's text or reasoning growing by
+ * another {@link RUN_PROGRESS_TEXT_STEP} characters each move it. A primitive,
+ * so a selector returning it re-renders nothing while the stream is still.
+ * A tail that is not text or reasoning keys as {@link runActivityKey} does.
+ */
+export declare function runProgressKey(parts: ReadonlyArray<unknown>): string;
 /**
  * The present-tense verb for what the run is doing right now — the registry's
  * activity label for a tool call still awaiting its result ("Searching the
- * web") — or `null` when the tail is not an unsettled tool call.
+ * web") — or `null` when the tail is not a tool call in flight.
  */
 export declare function runActivityVerb(parts: ReadonlyArray<unknown>): string | null;
-/** Seconds without any streamed change before the row flips to a stall tone. */
+/**
+ * Whether the run is waiting on a tool that is still running: the tail part
+ * is a tool call with no result yet, or only the streaming placeholder a
+ * long tool (Python execution, a task subagent) publishes while it works. A
+ * command, a build or a test suite streams nothing for minutes while it
+ * works, so a quiet stream then is work, not a stall.
+ */
+export declare function isToolCallInFlight(parts: ReadonlyArray<unknown>): boolean;
+/**
+ * Seconds without any streamed change before the row flips to a stall tone —
+ * while the run waits on the model, never while a tool call is in flight
+ * ({@link isRunActivityStalled}).
+ */
 export declare const RUN_ACTIVITY_STALL_SECONDS = 30;
+/**
+ * Whether the run looks stalled: nothing has streamed for
+ * {@link RUN_ACTIVITY_STALL_SECONDS} while it waits on the model. Never while a
+ * tool call is in flight: the call's own row says it is running.
+ */
+export declare function isRunActivityStalled({ seconds, toolCallInFlight, }: {
+    seconds: number;
+    toolCallInFlight: boolean;
+}): boolean;
 /** Seconds before the row starts showing its elapsed counter. */
 export declare const RUN_ACTIVITY_COUNTER_SECONDS = 3;
 /** The default verb when nothing more specific is known. */
@@ -30,6 +71,11 @@ export declare const RUN_ACTIVITY_DEFAULT_VERB = "Thinking";
 export declare function runElapsedLabel(seconds: number): string | null;
 /**
  * The status line for `seconds` since the stream last moved: the verb with an
- * ellipsis, the elapsed counter once it is due, and the stall tone.
+ * ellipsis and the elapsed counter once it is due (`runElapsedLabel`), or the
+ * stall wording when the run looks `stalled` ({@link isRunActivityStalled}).
  */
-export declare function runActivityLabel(seconds: number, verb?: string): string;
+export declare function runActivityLabel({ seconds, verb, stalled, }: {
+    seconds: number;
+    verb?: string;
+    stalled: boolean;
+}): string;

package/dist/chat/run-activity.js

@@ -1,26 +1,67 @@
+import { isStreamingToolPlaceholder } from "./super-grouping/activity-timeline.js";
 import { getToolDisplayMeta } from "../agent-runtime/src/tool-metadata.js";
 function runActivityKey(parts) {
   const tail = tailPart(parts);
   if (!tail) return null;
-  const type = typeof tail["type"] === "string" ? tail["type"] : "unknown";
+  const type = tailType(tail);
   if (type === "text" || type === "reasoning") return null;
-  const argsText = typeof tail["argsText"] === "string" ? tail["argsText"].length : 0;
-  const settled = tail["result"] === void 0 ? 0 : 1;
-  return `${parts.length}:${type}:${argsText}:${settled}`;
+  return tailActivityKey({ tail, type, partCount: parts.length });
+}
+const RUN_PROGRESS_TEXT_STEP = 64;
+function runProgressKey(parts) {
+  const tail = tailPart(parts);
+  if (!tail) return String(parts.length);
+  const type = tailType(tail);
+  if (type !== "text" && type !== "reasoning") {
+    return tailActivityKey({ tail, type, partCount: parts.length });
+  }
+  const text = tail["text"];
+  const step = Math.floor((typeof text === "string" ? text.length : 0) / RUN_PROGRESS_TEXT_STEP);
+  return `${parts.length}:${type}:${step}`;
+}
+function tailType(tail) {
+  const type = tail["type"];
+  return typeof type === "string" ? type : "unknown";
+}
+function tailActivityKey({
+  tail,
+  type,
+  partCount
+}) {
+  const argsText = tail["argsText"];
+  const argsLength = typeof argsText === "string" ? argsText.length : 0;
+  const settled = hasNoResultYet(tail) ? 0 : 1;
+  return `${partCount}:${type}:${argsLength}:${settled}`;
 }
 function runActivityVerb(parts) {
   const tail = tailPart(parts);
-  if (!tail || tail["type"] !== "tool-call" || tail["result"] !== void 0) return null;
+  if (!tail || !isTailToolCallRunning(tail)) return null;
   const toolName = tail["toolName"];
   if (typeof toolName !== "string" || toolName.length === 0) return null;
   return getToolDisplayMeta(toolName).activeLabel;
 }
+function isToolCallInFlight(parts) {
+  const tail = tailPart(parts);
+  return tail !== null && isTailToolCallRunning(tail);
+}
+function isTailToolCallRunning(tail) {
+  return tail["type"] === "tool-call" && hasNoResultYet(tail);
+}
+function hasNoResultYet(tail) {
+  return tail["result"] === void 0 || isStreamingToolPlaceholder({ artifact: tail["artifact"] });
+}
 function tailPart(parts) {
   const last = parts[parts.length - 1];
   if (last === void 0 || last === null || typeof last !== "object") return null;
   return last;
 }
 const RUN_ACTIVITY_STALL_SECONDS = 30;
+function isRunActivityStalled({
+  seconds,
+  toolCallInFlight
+}) {
+  return !toolCallInFlight && seconds >= RUN_ACTIVITY_STALL_SECONDS;
+}
 const RUN_ACTIVITY_COUNTER_SECONDS = 3;
 const RUN_ACTIVITY_DEFAULT_VERB = "Thinking";
 function runElapsedLabel(seconds) {
@@ -30,22 +71,26 @@ function runElapsedLabel(seconds) {
   const remainder = seconds % 60;
   return `${minutes}m ${String(remainder).padStart(2, "0")}s`;
 }
-function runActivityLabel(seconds, verb = RUN_ACTIVITY_DEFAULT_VERB) {
-  if (seconds >= RUN_ACTIVITY_STALL_SECONDS) {
-    return `Still working — nothing new for ${seconds}s`;
-  }
-  if (seconds >= RUN_ACTIVITY_COUNTER_SECONDS) {
-    return `${verb}… · ${seconds}s`;
-  }
-  return `${verb}…`;
+function runActivityLabel({
+  seconds,
+  verb = RUN_ACTIVITY_DEFAULT_VERB,
+  stalled
+}) {
+  if (stalled) return `Still working — nothing new for ${seconds}s`;
+  const elapsed = runElapsedLabel(seconds);
+  return elapsed === null ? `${verb}…` : `${verb}… · ${elapsed}`;
 }
 export {
   RUN_ACTIVITY_COUNTER_SECONDS,
   RUN_ACTIVITY_DEFAULT_VERB,
   RUN_ACTIVITY_STALL_SECONDS,
+  RUN_PROGRESS_TEXT_STEP,
+  isRunActivityStalled,
+  isToolCallInFlight,
   runActivityKey,
   runActivityLabel,
   runActivityVerb,
-  runElapsedLabel
+  runElapsedLabel,
+  runProgressKey
 };
 //# sourceMappingURL=run-activity.js.map

package/dist/chat/run-activity.js.map

@@ -1 +1 @@
-{"version":3,"file":"run-activity.js","sources":["../../src/chat/run-activity.ts"],"sourcesContent":["import { getToolDisplayMeta } from '@athenaintel/agent-runtime';\n\n/**\n * Run-liveness key for a streaming assistant message.\n *\n * A tool card's spinner says \"this call is running\"; nothing says the RUN is\n * still alive once parts exist — a stalled stream and a busy one look\n * identical. The activity key summarizes the message tail: it is `null` when\n * no liveness row should show (no parts yet, or a text/reasoning tail that\n * already animates on its own), and otherwise changes whenever anything\n * streams into the tail part — so an elapsed timer keyed on it measures\n * \"time since the stream last moved\", not just \"time since the call began\".\n */\nexport function runActivityKey(parts: ReadonlyArray<unknown>): string | null {\n  const tail = tailPart(parts);\n  if (!tail) return null;\n  const type = typeof tail['type'] === 'string' ? (tail['type'] as string) : 'unknown';\n  if (type === 'text' || type === 'reasoning') return null;\n  const argsText = typeof tail['argsText'] === 'string' ? (tail['argsText'] as string).length : 0;\n  const settled = tail['result'] === undefined ? 0 : 1;\n  return `${parts.length}:${type}:${argsText}:${settled}`;\n}\n\n/**\n * The present-tense verb for what the run is doing right now — the registry's\n * activity label for a tool call still awaiting its result (\"Searching the\n * web\") — or `null` when the tail is not an unsettled tool call.\n */\nexport function runActivityVerb(parts: ReadonlyArray<unknown>): string | null {\n  const tail = tailPart(parts);\n  if (!tail || tail['type'] !== 'tool-call' || tail['result'] !== undefined) return null;\n  const toolName = tail['toolName'];\n  if (typeof toolName !== 'string' || toolName.length === 0) return null;\n  return getToolDisplayMeta(toolName).activeLabel;\n}\n\nfunction tailPart(parts: ReadonlyArray<unknown>): Record<string, unknown> | null {\n  const last = parts[parts.length - 1];\n  if (last === undefined || last === null || typeof last !== 'object') return null;\n  return last as Record<string, unknown>;\n}\n\n/** Seconds without any streamed change before the row flips to a stall tone. */\nexport const RUN_ACTIVITY_STALL_SECONDS = 30;\n\n/** Seconds before the row starts showing its elapsed counter. */\nexport const RUN_ACTIVITY_COUNTER_SECONDS = 3;\n\n/** The default verb when nothing more specific is known. */\nexport const RUN_ACTIVITY_DEFAULT_VERB = 'Thinking';\n\n/**\n * The counter alone for a card whose header already names the verb: `null`\n * until it is due, then \"11s\" / \"1m 05s\". The stall tone is the caller's\n * (a color and an announcement), not more words on the header row.\n */\nexport function runElapsedLabel(seconds: number): string | null {\n  if (seconds < RUN_ACTIVITY_COUNTER_SECONDS) return null;\n  if (seconds < 60) return `${seconds}s`;\n  const minutes = Math.floor(seconds / 60);\n  const remainder = seconds % 60;\n  return `${minutes}m ${String(remainder).padStart(2, '0')}s`;\n}\n\n/**\n * The status line for `seconds` since the stream last moved: the verb with an\n * ellipsis, the elapsed counter once it is due, and the stall tone.\n */\nexport function runActivityLabel(seconds: number, verb: string = RUN_ACTIVITY_DEFAULT_VERB): string {\n  if (seconds >= RUN_ACTIVITY_STALL_SECONDS) {\n    return `Still working — nothing new for ${seconds}s`;\n  }\n  if (seconds >= RUN_ACTIVITY_COUNTER_SECONDS) {\n    return `${verb}… · ${seconds}s`;\n  }\n  return `${verb}…`;\n}\n"],"names":[],"mappings":";AAaO,SAAS,eAAe,OAA8C;AAC3E,QAAM,OAAO,SAAS,KAAK;AAC3B,MAAI,CAAC,KAAM,QAAO;AAClB,QAAM,OAAO,OAAO,KAAK,MAAM,MAAM,WAAY,KAAK,MAAM,IAAe;AAC3E,MAAI,SAAS,UAAU,SAAS,YAAa,QAAO;AACpD,QAAM,WAAW,OAAO,KAAK,UAAU,MAAM,WAAY,KAAK,UAAU,EAAa,SAAS;AAC9F,QAAM,UAAU,KAAK,QAAQ,MAAM,SAAY,IAAI;AACnD,SAAO,GAAG,MAAM,MAAM,IAAI,IAAI,IAAI,QAAQ,IAAI,OAAO;AACvD;AAOO,SAAS,gBAAgB,OAA8C;AAC5E,QAAM,OAAO,SAAS,KAAK;AAC3B,MAAI,CAAC,QAAQ,KAAK,MAAM,MAAM,eAAe,KAAK,QAAQ,MAAM,OAAW,QAAO;AAClF,QAAM,WAAW,KAAK,UAAU;AAChC,MAAI,OAAO,aAAa,YAAY,SAAS,WAAW,EAAG,QAAO;AAClE,SAAO,mBAAmB,QAAQ,EAAE;AACtC;AAEA,SAAS,SAAS,OAA+D;AAC/E,QAAM,OAAO,MAAM,MAAM,SAAS,CAAC;AACnC,MAAI,SAAS,UAAa,SAAS,QAAQ,OAAO,SAAS,SAAU,QAAO;AAC5E,SAAO;AACT;AAGO,MAAM,6BAA6B;AAGnC,MAAM,+BAA+B;AAGrC,MAAM,4BAA4B;AAOlC,SAAS,gBAAgB,SAAgC;AAC9D,MAAI,UAAU,6BAA8B,QAAO;AACnD,MAAI,UAAU,GAAI,QAAO,GAAG,OAAO;AACnC,QAAM,UAAU,KAAK,MAAM,UAAU,EAAE;AACvC,QAAM,YAAY,UAAU;AAC5B,SAAO,GAAG,OAAO,KAAK,OAAO,SAAS,EAAE,SAAS,GAAG,GAAG,CAAC;AAC1D;AAMO,SAAS,iBAAiB,SAAiB,OAAe,2BAAmC;AAClG,MAAI,WAAW,4BAA4B;AACzC,WAAO,mCAAmC,OAAO;AAAA,EACnD;AACA,MAAI,WAAW,8BAA8B;AAC3C,WAAO,GAAG,IAAI,OAAO,OAAO;AAAA,EAC9B;AACA,SAAO,GAAG,IAAI;AAChB;"}
+{"version":3,"file":"run-activity.js","sources":["../../src/chat/run-activity.ts"],"sourcesContent":["import { getToolDisplayMeta } from '@athenaintel/agent-runtime';\nimport { isStreamingToolPlaceholder } from './super-grouping/activity-timeline';\n\n/**\n * Run-liveness key for a streaming assistant message.\n *\n * A tool card's spinner says \"this call is running\"; nothing says the RUN is\n * still alive once parts exist — a stalled stream and a busy one look\n * identical. The activity key summarizes the message tail: it is `null` when\n * no liveness row should show (no parts yet, or a text/reasoning tail that\n * already animates on its own), and otherwise changes whenever anything\n * streams into the tail part. The stall clock itself keys on\n * {@link runProgressKey}, which also moves while a text or reasoning tail grows.\n */\nexport function runActivityKey(parts: ReadonlyArray<unknown>): string | null {\n  const tail = tailPart(parts);\n  if (!tail) return null;\n  const type = tailType(tail);\n  if (type === 'text' || type === 'reasoning') return null;\n  return tailActivityKey({ tail, type, partCount: parts.length });\n}\n\n/**\n * Characters of streamed text or reasoning per step of {@link runProgressKey}.\n * The model writes a step within a second at any ordinary streaming rate, so\n * the stall clock restarts about as often as words arrive, while the small\n * meta that reads the key re-renders once per step, never once per token. Only\n * a stream slower than one step per stall window (about two characters a\n * second) could read as quiet while it writes.\n */\nexport const RUN_PROGRESS_TEXT_STEP = 64;\n\n/**\n * The stall clock's key for a streaming assistant message: it changes\n * whenever anything streams, so a timer keyed on it counts the seconds\n * nothing has streamed, which is what the stall tone says\n * ({@link isRunActivityStalled}). A part added, a tool call's arguments\n * growing, a result landing, or the tail's text or reasoning growing by\n * another {@link RUN_PROGRESS_TEXT_STEP} characters each move it. A primitive,\n * so a selector returning it re-renders nothing while the stream is still.\n * A tail that is not text or reasoning keys as {@link runActivityKey} does.\n */\nexport function runProgressKey(parts: ReadonlyArray<unknown>): string {\n  const tail = tailPart(parts);\n  if (!tail) return String(parts.length);\n  const type = tailType(tail);\n  if (type !== 'text' && type !== 'reasoning') {\n    return tailActivityKey({ tail, type, partCount: parts.length });\n  }\n  const text = tail['text'];\n  const step = Math.floor((typeof text === 'string' ? text.length : 0) / RUN_PROGRESS_TEXT_STEP);\n  return `${parts.length}:${type}:${step}`;\n}\n\nfunction tailType(tail: Record<string, unknown>): string {\n  const type = tail['type'];\n  return typeof type === 'string' ? type : 'unknown';\n}\n\n/** What a tool-call (or any other non-text) tail has streamed: its arguments so far, and whether its result is in. */\nfunction tailActivityKey({\n  tail,\n  type,\n  partCount,\n}: {\n  tail: Record<string, unknown>;\n  type: string;\n  partCount: number;\n}): string {\n  const argsText = tail['argsText'];\n  const argsLength = typeof argsText === 'string' ? argsText.length : 0;\n  // A streaming placeholder is not a result: the key moves when the real one replaces it.\n  const settled = hasNoResultYet(tail) ? 0 : 1;\n  return `${partCount}:${type}:${argsLength}:${settled}`;\n}\n\n/**\n * The present-tense verb for what the run is doing right now — the registry's\n * activity label for a tool call still awaiting its result (\"Searching the\n * web\") — or `null` when the tail is not a tool call in flight.\n */\nexport function runActivityVerb(parts: ReadonlyArray<unknown>): string | null {\n  const tail = tailPart(parts);\n  if (!tail || !isTailToolCallRunning(tail)) return null;\n  const toolName = tail['toolName'];\n  if (typeof toolName !== 'string' || toolName.length === 0) return null;\n  return getToolDisplayMeta(toolName).activeLabel;\n}\n\n/**\n * Whether the run is waiting on a tool that is still running: the tail part\n * is a tool call with no result yet, or only the streaming placeholder a\n * long tool (Python execution, a task subagent) publishes while it works. A\n * command, a build or a test suite streams nothing for minutes while it\n * works, so a quiet stream then is work, not a stall.\n */\nexport function isToolCallInFlight(parts: ReadonlyArray<unknown>): boolean {\n  const tail = tailPart(parts);\n  return tail !== null && isTailToolCallRunning(tail);\n}\n\nfunction isTailToolCallRunning(tail: Record<string, unknown>): boolean {\n  return tail['type'] === 'tool-call' && hasNoResultYet(tail);\n}\n\n/** No result yet: none at all, or only the streaming placeholder (`isStreamingToolPlaceholder`). */\nfunction hasNoResultYet(tail: Record<string, unknown>): boolean {\n  return tail['result'] === undefined || isStreamingToolPlaceholder({ artifact: tail['artifact'] });\n}\n\nfunction tailPart(parts: ReadonlyArray<unknown>): Record<string, unknown> | null {\n  const last = parts[parts.length - 1];\n  if (last === undefined || last === null || typeof last !== 'object') return null;\n  return last as Record<string, unknown>;\n}\n\n/**\n * Seconds without any streamed change before the row flips to a stall tone —\n * while the run waits on the model, never while a tool call is in flight\n * ({@link isRunActivityStalled}).\n */\nexport const RUN_ACTIVITY_STALL_SECONDS = 30;\n\n/**\n * Whether the run looks stalled: nothing has streamed for\n * {@link RUN_ACTIVITY_STALL_SECONDS} while it waits on the model. Never while a\n * tool call is in flight: the call's own row says it is running.\n */\nexport function isRunActivityStalled({\n  seconds,\n  toolCallInFlight,\n}: {\n  seconds: number;\n  toolCallInFlight: boolean;\n}): boolean {\n  return !toolCallInFlight && seconds >= RUN_ACTIVITY_STALL_SECONDS;\n}\n\n/** Seconds before the row starts showing its elapsed counter. */\nexport const RUN_ACTIVITY_COUNTER_SECONDS = 3;\n\n/** The default verb when nothing more specific is known. */\nexport const RUN_ACTIVITY_DEFAULT_VERB = 'Thinking';\n\n/**\n * The counter alone for a card whose header already names the verb: `null`\n * until it is due, then \"11s\" / \"1m 05s\". The stall tone is the caller's\n * (a color and an announcement), not more words on the header row.\n */\nexport function runElapsedLabel(seconds: number): string | null {\n  if (seconds < RUN_ACTIVITY_COUNTER_SECONDS) return null;\n  if (seconds < 60) return `${seconds}s`;\n  const minutes = Math.floor(seconds / 60);\n  const remainder = seconds % 60;\n  return `${minutes}m ${String(remainder).padStart(2, '0')}s`;\n}\n\n/**\n * The status line for `seconds` since the stream last moved: the verb with an\n * ellipsis and the elapsed counter once it is due (`runElapsedLabel`), or the\n * stall wording when the run looks `stalled` ({@link isRunActivityStalled}).\n */\nexport function runActivityLabel({\n  seconds,\n  verb = RUN_ACTIVITY_DEFAULT_VERB,\n  stalled,\n}: {\n  seconds: number;\n  verb?: string;\n  stalled: boolean;\n}): string {\n  if (stalled) return `Still working — nothing new for ${seconds}s`;\n  const elapsed = runElapsedLabel(seconds);\n  return elapsed === null ? `${verb}…` : `${verb}… · ${elapsed}`;\n}\n"],"names":[],"mappings":";;AAcO,SAAS,eAAe,OAA8C;AAC3E,QAAM,OAAO,SAAS,KAAK;AAC3B,MAAI,CAAC,KAAM,QAAO;AAClB,QAAM,OAAO,SAAS,IAAI;AAC1B,MAAI,SAAS,UAAU,SAAS,YAAa,QAAO;AACpD,SAAO,gBAAgB,EAAE,MAAM,MAAM,WAAW,MAAM,QAAQ;AAChE;AAUO,MAAM,yBAAyB;AAY/B,SAAS,eAAe,OAAuC;AACpE,QAAM,OAAO,SAAS,KAAK;AAC3B,MAAI,CAAC,KAAM,QAAO,OAAO,MAAM,MAAM;AACrC,QAAM,OAAO,SAAS,IAAI;AAC1B,MAAI,SAAS,UAAU,SAAS,aAAa;AAC3C,WAAO,gBAAgB,EAAE,MAAM,MAAM,WAAW,MAAM,QAAQ;AAAA,EAChE;AACA,QAAM,OAAO,KAAK,MAAM;AACxB,QAAM,OAAO,KAAK,OAAO,OAAO,SAAS,WAAW,KAAK,SAAS,KAAK,sBAAsB;AAC7F,SAAO,GAAG,MAAM,MAAM,IAAI,IAAI,IAAI,IAAI;AACxC;AAEA,SAAS,SAAS,MAAuC;AACvD,QAAM,OAAO,KAAK,MAAM;AACxB,SAAO,OAAO,SAAS,WAAW,OAAO;AAC3C;AAGA,SAAS,gBAAgB;AAAA,EACvB;AAAA,EACA;AAAA,EACA;AACF,GAIW;AACT,QAAM,WAAW,KAAK,UAAU;AAChC,QAAM,aAAa,OAAO,aAAa,WAAW,SAAS,SAAS;AAEpE,QAAM,UAAU,eAAe,IAAI,IAAI,IAAI;AAC3C,SAAO,GAAG,SAAS,IAAI,IAAI,IAAI,UAAU,IAAI,OAAO;AACtD;AAOO,SAAS,gBAAgB,OAA8C;AAC5E,QAAM,OAAO,SAAS,KAAK;AAC3B,MAAI,CAAC,QAAQ,CAAC,sBAAsB,IAAI,EAAG,QAAO;AAClD,QAAM,WAAW,KAAK,UAAU;AAChC,MAAI,OAAO,aAAa,YAAY,SAAS,WAAW,EAAG,QAAO;AAClE,SAAO,mBAAmB,QAAQ,EAAE;AACtC;AASO,SAAS,mBAAmB,OAAwC;AACzE,QAAM,OAAO,SAAS,KAAK;AAC3B,SAAO,SAAS,QAAQ,sBAAsB,IAAI;AACpD;AAEA,SAAS,sBAAsB,MAAwC;AACrE,SAAO,KAAK,MAAM,MAAM,eAAe,eAAe,IAAI;AAC5D;AAGA,SAAS,eAAe,MAAwC;AAC9D,SAAO,KAAK,QAAQ,MAAM,UAAa,2BAA2B,EAAE,UAAU,KAAK,UAAU,GAAG;AAClG;AAEA,SAAS,SAAS,OAA+D;AAC/E,QAAM,OAAO,MAAM,MAAM,SAAS,CAAC;AACnC,MAAI,SAAS,UAAa,SAAS,QAAQ,OAAO,SAAS,SAAU,QAAO;AAC5E,SAAO;AACT;AAOO,MAAM,6BAA6B;AAOnC,SAAS,qBAAqB;AAAA,EACnC;AAAA,EACA;AACF,GAGY;AACV,SAAO,CAAC,oBAAoB,WAAW;AACzC;AAGO,MAAM,+BAA+B;AAGrC,MAAM,4BAA4B;AAOlC,SAAS,gBAAgB,SAAgC;AAC9D,MAAI,UAAU,6BAA8B,QAAO;AACnD,MAAI,UAAU,GAAI,QAAO,GAAG,OAAO;AACnC,QAAM,UAAU,KAAK,MAAM,UAAU,EAAE;AACvC,QAAM,YAAY,UAAU;AAC5B,SAAO,GAAG,OAAO,KAAK,OAAO,SAAS,EAAE,SAAS,GAAG,GAAG,CAAC;AAC1D;AAOO,SAAS,iBAAiB;AAAA,EAC/B;AAAA,EACA,OAAO;AAAA,EACP;AACF,GAIW;AACT,MAAI,QAAS,QAAO,mCAAmC,OAAO;AAC9D,QAAM,UAAU,gBAAgB,OAAO;AACvC,SAAO,YAAY,OAAO,GAAG,IAAI,MAAM,GAAG,IAAI,OAAO,OAAO;AAC9D;"}

package/dist/lib/use-document-active.cjs

@@ -0,0 +1,40 @@
+"use strict";
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+const react = require("react");
+function isActive(doc) {
+  if (!doc) return false;
+  return doc.visibilityState === "visible" && doc.hasFocus();
+}
+function getServerSnapshot() {
+  return false;
+}
+function subscribeTo(doc, onChange) {
+  const view = doc == null ? void 0 : doc.defaultView;
+  if (!doc || !view) return () => {
+  };
+  let afterBlur = null;
+  const onBlur = () => {
+    onChange();
+    if (afterBlur !== null) clearTimeout(afterBlur);
+    afterBlur = setTimeout(() => {
+      afterBlur = null;
+      onChange();
+    }, 0);
+  };
+  view.addEventListener("focus", onChange);
+  view.addEventListener("blur", onBlur);
+  doc.addEventListener("visibilitychange", onChange);
+  return () => {
+    view.removeEventListener("focus", onChange);
+    view.removeEventListener("blur", onBlur);
+    doc.removeEventListener("visibilitychange", onChange);
+    if (afterBlur !== null) clearTimeout(afterBlur);
+  };
+}
+function useDocumentActive(doc) {
+  const subscribe = react.useCallback((onChange) => subscribeTo(doc, onChange), [doc]);
+  const getSnapshot = react.useCallback(() => isActive(doc), [doc]);
+  return react.useSyncExternalStore(subscribe, getSnapshot, getServerSnapshot);
+}
+exports.useDocumentActive = useDocumentActive;
+//# sourceMappingURL=use-document-active.cjs.map

package/dist/lib/use-document-active.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-document-active.cjs","sources":["../../src/lib/use-document-active.ts"],"sourcesContent":["import { useCallback, useSyncExternalStore } from 'react';\n\nfunction isActive(doc: Document | null): boolean {\n  if (!doc) return false;\n  return doc.visibilityState === 'visible' && doc.hasFocus();\n}\n\nfunction getServerSnapshot(): boolean {\n  return false;\n}\n\nfunction subscribeTo(doc: Document | null, onChange: () => void): () => void {\n  const view = doc?.defaultView;\n  if (!doc || !view) return () => {};\n  let afterBlur: ReturnType<typeof setTimeout> | null = null;\n  // `blur` fires before focus has landed. Focus that moved into a frame of\n  // this page (a computer's live desktop, an embedded asset) leaves the\n  // document focused, so it is read again once the browser has moved it.\n  const onBlur = () => {\n    onChange();\n    if (afterBlur !== null) clearTimeout(afterBlur);\n    afterBlur = setTimeout(() => {\n      afterBlur = null;\n      onChange();\n    }, 0);\n  };\n  view.addEventListener('focus', onChange);\n  view.addEventListener('blur', onBlur);\n  doc.addEventListener('visibilitychange', onChange);\n  return () => {\n    view.removeEventListener('focus', onChange);\n    view.removeEventListener('blur', onBlur);\n    doc.removeEventListener('visibilitychange', onChange);\n    if (afterBlur !== null) clearTimeout(afterBlur);\n  };\n}\n\n/**\n * Whether `doc` is in front of the person: visible and focused\n * (`hasFocus()`, which stays true while focus is inside a frame of the page).\n * Pass the document a subtree renders into (`useOwnerDocument()`), so a pane\n * popped out into another window reads that window. Re-read on its window's\n * `focus` / `blur` and its `visibilitychange`; nothing polls. `false` on the\n * server and without a document.\n */\nexport function useDocumentActive(doc: Document | null): boolean {\n  const subscribe = useCallback((onChange: () => void) => subscribeTo(doc, onChange), [doc]);\n  const getSnapshot = useCallback(() => isActive(doc), [doc]);\n  return useSyncExternalStore(subscribe, getSnapshot, getServerSnapshot);\n}\n"],"names":["useCallback","useSyncExternalStore"],"mappings":";;;AAEA,SAAS,SAAS,KAA+B;AAC/C,MAAI,CAAC,IAAK,QAAO;AACjB,SAAO,IAAI,oBAAoB,aAAa,IAAI,SAAA;AAClD;AAEA,SAAS,oBAA6B;AACpC,SAAO;AACT;AAEA,SAAS,YAAY,KAAsB,UAAkC;AAC3E,QAAM,OAAO,2BAAK;AAClB,MAAI,CAAC,OAAO,CAAC,aAAa,MAAM;AAAA,EAAC;AACjC,MAAI,YAAkD;AAItD,QAAM,SAAS,MAAM;AACnB,aAAA;AACA,QAAI,cAAc,KAAM,cAAa,SAAS;AAC9C,gBAAY,WAAW,MAAM;AAC3B,kBAAY;AACZ,eAAA;AAAA,IACF,GAAG,CAAC;AAAA,EACN;AACA,OAAK,iBAAiB,SAAS,QAAQ;AACvC,OAAK,iBAAiB,QAAQ,MAAM;AACpC,MAAI,iBAAiB,oBAAoB,QAAQ;AACjD,SAAO,MAAM;AACX,SAAK,oBAAoB,SAAS,QAAQ;AAC1C,SAAK,oBAAoB,QAAQ,MAAM;AACvC,QAAI,oBAAoB,oBAAoB,QAAQ;AACpD,QAAI,cAAc,KAAM,cAAa,SAAS;AAAA,EAChD;AACF;AAUO,SAAS,kBAAkB,KAA+B;AAC/D,QAAM,YAAYA,kBAAY,CAAC,aAAyB,YAAY,KAAK,QAAQ,GAAG,CAAC,GAAG,CAAC;AACzF,QAAM,cAAcA,MAAAA,YAAY,MAAM,SAAS,GAAG,GAAG,CAAC,GAAG,CAAC;AAC1D,SAAOC,2BAAqB,WAAW,aAAa,iBAAiB;AACvE;;"}

package/dist/lib/use-document-active.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Whether `doc` is in front of the person: visible and focused
+ * (`hasFocus()`, which stays true while focus is inside a frame of the page).
+ * Pass the document a subtree renders into (`useOwnerDocument()`), so a pane
+ * popped out into another window reads that window. Re-read on its window's
+ * `focus` / `blur` and its `visibilitychange`; nothing polls. `false` on the
+ * server and without a document.
+ */
+export declare function useDocumentActive(doc: Document | null): boolean;

package/dist/lib/use-document-active.js

@@ -0,0 +1,40 @@
+import { useCallback, useSyncExternalStore } from "react";
+function isActive(doc) {
+  if (!doc) return false;
+  return doc.visibilityState === "visible" && doc.hasFocus();
+}
+function getServerSnapshot() {
+  return false;
+}
+function subscribeTo(doc, onChange) {
+  const view = doc == null ? void 0 : doc.defaultView;
+  if (!doc || !view) return () => {
+  };
+  let afterBlur = null;
+  const onBlur = () => {
+    onChange();
+    if (afterBlur !== null) clearTimeout(afterBlur);
+    afterBlur = setTimeout(() => {
+      afterBlur = null;
+      onChange();
+    }, 0);
+  };
+  view.addEventListener("focus", onChange);
+  view.addEventListener("blur", onBlur);
+  doc.addEventListener("visibilitychange", onChange);
+  return () => {
+    view.removeEventListener("focus", onChange);
+    view.removeEventListener("blur", onBlur);
+    doc.removeEventListener("visibilitychange", onChange);
+    if (afterBlur !== null) clearTimeout(afterBlur);
+  };
+}
+function useDocumentActive(doc) {
+  const subscribe = useCallback((onChange) => subscribeTo(doc, onChange), [doc]);
+  const getSnapshot = useCallback(() => isActive(doc), [doc]);
+  return useSyncExternalStore(subscribe, getSnapshot, getServerSnapshot);
+}
+export {
+  useDocumentActive
+};
+//# sourceMappingURL=use-document-active.js.map

package/dist/lib/use-document-active.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-document-active.js","sources":["../../src/lib/use-document-active.ts"],"sourcesContent":["import { useCallback, useSyncExternalStore } from 'react';\n\nfunction isActive(doc: Document | null): boolean {\n  if (!doc) return false;\n  return doc.visibilityState === 'visible' && doc.hasFocus();\n}\n\nfunction getServerSnapshot(): boolean {\n  return false;\n}\n\nfunction subscribeTo(doc: Document | null, onChange: () => void): () => void {\n  const view = doc?.defaultView;\n  if (!doc || !view) return () => {};\n  let afterBlur: ReturnType<typeof setTimeout> | null = null;\n  // `blur` fires before focus has landed. Focus that moved into a frame of\n  // this page (a computer's live desktop, an embedded asset) leaves the\n  // document focused, so it is read again once the browser has moved it.\n  const onBlur = () => {\n    onChange();\n    if (afterBlur !== null) clearTimeout(afterBlur);\n    afterBlur = setTimeout(() => {\n      afterBlur = null;\n      onChange();\n    }, 0);\n  };\n  view.addEventListener('focus', onChange);\n  view.addEventListener('blur', onBlur);\n  doc.addEventListener('visibilitychange', onChange);\n  return () => {\n    view.removeEventListener('focus', onChange);\n    view.removeEventListener('blur', onBlur);\n    doc.removeEventListener('visibilitychange', onChange);\n    if (afterBlur !== null) clearTimeout(afterBlur);\n  };\n}\n\n/**\n * Whether `doc` is in front of the person: visible and focused\n * (`hasFocus()`, which stays true while focus is inside a frame of the page).\n * Pass the document a subtree renders into (`useOwnerDocument()`), so a pane\n * popped out into another window reads that window. Re-read on its window's\n * `focus` / `blur` and its `visibilitychange`; nothing polls. `false` on the\n * server and without a document.\n */\nexport function useDocumentActive(doc: Document | null): boolean {\n  const subscribe = useCallback((onChange: () => void) => subscribeTo(doc, onChange), [doc]);\n  const getSnapshot = useCallback(() => isActive(doc), [doc]);\n  return useSyncExternalStore(subscribe, getSnapshot, getServerSnapshot);\n}\n"],"names":[],"mappings":";AAEA,SAAS,SAAS,KAA+B;AAC/C,MAAI,CAAC,IAAK,QAAO;AACjB,SAAO,IAAI,oBAAoB,aAAa,IAAI,SAAA;AAClD;AAEA,SAAS,oBAA6B;AACpC,SAAO;AACT;AAEA,SAAS,YAAY,KAAsB,UAAkC;AAC3E,QAAM,OAAO,2BAAK;AAClB,MAAI,CAAC,OAAO,CAAC,aAAa,MAAM;AAAA,EAAC;AACjC,MAAI,YAAkD;AAItD,QAAM,SAAS,MAAM;AACnB,aAAA;AACA,QAAI,cAAc,KAAM,cAAa,SAAS;AAC9C,gBAAY,WAAW,MAAM;AAC3B,kBAAY;AACZ,eAAA;AAAA,IACF,GAAG,CAAC;AAAA,EACN;AACA,OAAK,iBAAiB,SAAS,QAAQ;AACvC,OAAK,iBAAiB,QAAQ,MAAM;AACpC,MAAI,iBAAiB,oBAAoB,QAAQ;AACjD,SAAO,MAAM;AACX,SAAK,oBAAoB,SAAS,QAAQ;AAC1C,SAAK,oBAAoB,QAAQ,MAAM;AACvC,QAAI,oBAAoB,oBAAoB,QAAQ;AACpD,QAAI,cAAc,KAAM,cAAa,SAAS;AAAA,EAChD;AACF;AAUO,SAAS,kBAAkB,KAA+B;AAC/D,QAAM,YAAY,YAAY,CAAC,aAAyB,YAAY,KAAK,QAAQ,GAAG,CAAC,GAAG,CAAC;AACzF,QAAM,cAAc,YAAY,MAAM,SAAS,GAAG,GAAG,CAAC,GAAG,CAAC;AAC1D,SAAO,qBAAqB,WAAW,aAAa,iBAAiB;AACvE;"}

package/dist/react/package.json.cjs

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperties(exports, { __esModule: { value: true }, [Symbol.toStringTag]: { value: "Module" } });
-const version = "0.40.0";
+const version = "0.40.2";
 const packageJson = {
   version
 };

package/dist/react/package.json.js

@@ -1,4 +1,4 @@
-const version = "0.40.0";
+const version = "0.40.2";
 const packageJson = {
   version
 };