@agents24/chat-react 0.5.20 → 0.5.22

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@agents24/chat-react",
-  "version": "0.5.20",
+  "version": "0.5.22",
   "description": "Accessible web UI and complete default layout for Agents24 chat applications.",
   "license": "MIT",
   "repository": {
@@ -59,8 +59,8 @@
   },
   "dependencies": {
     "@untitledui/file-icons": "0.0.9",
-    "@agents24/client": "0.2.10",
-    "@agents24/react": "0.2.11",
+    "@agents24/client": "0.2.12",
+    "@agents24/react": "0.2.13",
     "@fontsource-variable/inter": "^5.3.0",
     "@fontsource-variable/jetbrains-mono": "^5.3.0",
     "@fontsource-variable/merriweather": "^5.3.0",

package/dist/chunk-SSUO4EPD.js.map

@@ -1 +0,0 @@
-{"version":3,"sources":["../src/streaming-text.ts"],"sourcesContent":["import { useEffect, useRef, useState } from \"react\";\n\nimport type { ChatMessage, ChatPart } from \"./types\";\n\nexport type StreamingTextMode = \"streaming\" | \"static\";\n\nexport type StreamingTextCache = {\n  get: (id: string) => string | undefined;\n  set: (id: string, text: string) => void;\n};\n\nexport type UseStreamingTextOptions = {\n  id: string;\n  isStreaming: boolean;\n  text: string;\n  cache?: StreamingTextCache | false;\n  charsPerSecond?: number;\n  catchupThreshold?: number;\n  maxCatchupChars?: number;\n};\n\nexport type UseStreamingTextResult = {\n  displayedText: string;\n  isAnimating: boolean;\n  mode: StreamingTextMode;\n  parseIncompleteMarkdown: boolean;\n};\n\nconst DEFAULT_COMPLETED_TEXT_CACHE_SIZE = 200;\nconst STREAM_RUNWAY_MS = 80;\nconst STREAM_IDLE_RELEASE_MS = 120;\nconst defaultCompletedTextCache = new Map<string, string>();\n\nconst defaultStreamingTextCache: StreamingTextCache = {\n  get: (id) => defaultCompletedTextCache.get(id),\n  set: (id, text) => {\n    defaultCompletedTextCache.set(id, text);\n    if (defaultCompletedTextCache.size > DEFAULT_COMPLETED_TEXT_CACHE_SIZE) {\n      const firstKey = defaultCompletedTextCache.keys().next().value;\n      if (firstKey) defaultCompletedTextCache.delete(firstKey);\n    }\n  },\n};\n\nexport const getActiveStreamingTextPartId = (\n  message: ChatMessage,\n  streamingMessageId: string | null\n) => {\n  if (message.role !== \"assistant\" || streamingMessageId !== message.id) return null;\n  const trailingPart = message.parts[message.parts.length - 1];\n  return trailingPart?.kind === \"text\" ? trailingPart.id : null;\n};\n\nexport const isActiveStreamingTextPart = (\n  message: ChatMessage,\n  part: ChatPart,\n  streamingMessageId: string | null\n) => part.kind === \"text\" && part.id === getActiveStreamingTextPartId(message, streamingMessageId);\n\nconst graphemeEndOffsets = (value: string): number[] => {\n  if (!value) return [];\n\n  if (typeof Intl !== \"undefined\" && \"Segmenter\" in Intl) {\n    const segmenter = new Intl.Segmenter(undefined, { granularity: \"grapheme\" });\n    return Array.from(segmenter.segment(value), ({ index, segment }) => index + segment.length);\n  }\n\n  const characters = Array.from(value);\n  const offsets: number[] = [];\n  let offset = 0;\n  let regionalIndicators = 0;\n  characters.forEach((character, index) => {\n    const previous = characters[index - 1];\n    const codePoint = character.codePointAt(0) ?? 0;\n    const isRegionalIndicator = codePoint >= 0x1f1e6 && codePoint <= 0x1f1ff;\n    const continuesCluster =\n      index > 0 &&\n      (/^\\p{Mark}$/u.test(character) ||\n        (codePoint >= 0xfe00 && codePoint <= 0xfe0f) ||\n        (codePoint >= 0x1f3fb && codePoint <= 0x1f3ff) ||\n        character === \"\\u200d\" ||\n        previous === \"\\u200d\" ||\n        (isRegionalIndicator && regionalIndicators % 2 === 1));\n    if (!continuesCluster) {\n      if (offset > 0) offsets.push(offset);\n      regionalIndicators = 0;\n    }\n    offset += character.length;\n    regionalIndicators = isRegionalIndicator ? regionalIndicators + 1 : 0;\n  });\n  offsets.push(offset);\n  return offsets;\n};\n\nexport function useStreamingText({\n  id,\n  isStreaming,\n  text,\n  cache = defaultStreamingTextCache,\n  charsPerSecond = 72,\n  catchupThreshold = 40,\n  maxCatchupChars = 20,\n}: UseStreamingTextOptions): UseStreamingTextResult {\n  const cacheAdapter = cache === false ? null : cache;\n  const [displayedText, setDisplayedText] = useState(() => {\n    const cachedText = cacheAdapter?.get(id);\n    return cachedText && text.startsWith(cachedText) ? cachedText : text;\n  });\n  const targetRef = useRef(text);\n  const displayedRef = useRef(displayedText);\n  const rafRef = useRef<number | null>(null);\n  const lastFrameAtRef = useRef<number | null>(null);\n  const targetUpdatedAtRef = useRef<number | null>(null);\n  const progressRemainderRef = useRef(0);\n  const idRef = useRef(id);\n  const streamingRef = useRef(isStreaming);\n  const reduceMotionRef = useRef(false);\n\n  useEffect(() => {\n    if (isStreaming || !text) return;\n    cacheAdapter?.set(id, text);\n  }, [cacheAdapter, id, isStreaming, text]);\n\n  useEffect(() => {\n    targetRef.current = text;\n    targetUpdatedAtRef.current =\n      typeof performance === \"undefined\" ? null : performance.now();\n\n    if (\n      !isStreaming ||\n      reduceMotionRef.current ||\n      !text.startsWith(displayedRef.current)\n    ) {\n      displayedRef.current = text;\n      setDisplayedText(text);\n      progressRemainderRef.current = 0;\n    }\n  }, [isStreaming, text]);\n\n  useEffect(() => {\n    if (idRef.current === id) return;\n\n    idRef.current = id;\n    const cachedText = cacheAdapter?.get(id);\n    const initial = cachedText && text.startsWith(cachedText) ? cachedText : text;\n    displayedRef.current = initial;\n    setDisplayedText(initial);\n    lastFrameAtRef.current = null;\n    targetUpdatedAtRef.current =\n      typeof performance === \"undefined\" ? null : performance.now();\n    progressRemainderRef.current = 0;\n  }, [cacheAdapter, id, isStreaming, text]);\n\n  useEffect(() => {\n    streamingRef.current = isStreaming;\n\n    if (typeof window === \"undefined\") {\n      displayedRef.current = text;\n      setDisplayedText(text);\n      return;\n    }\n\n    const reduceMotion =\n      typeof window.matchMedia === \"function\" &&\n      window.matchMedia(\"(prefers-reduced-motion: reduce)\").matches;\n    reduceMotionRef.current = reduceMotion;\n\n    if (reduceMotion || !isStreaming) {\n      displayedRef.current = text;\n      setDisplayedText(text);\n      return;\n    }\n\n    const cachedText = cacheAdapter?.get(id);\n    if (cachedText === text) {\n      displayedRef.current = text;\n      setDisplayedText(text);\n      return;\n    }\n\n    if (!text.startsWith(displayedRef.current)) {\n      displayedRef.current = text;\n      setDisplayedText(text);\n    }\n\n    const tick = (timestamp: number) => {\n      const previousTimestamp = lastFrameAtRef.current ?? timestamp;\n      lastFrameAtRef.current = timestamp;\n\n      const target = targetRef.current;\n      const current = displayedRef.current;\n\n      if (!streamingRef.current || reduceMotionRef.current) {\n        displayedRef.current = target;\n        setDisplayedText(target);\n        rafRef.current = null;\n        return;\n      }\n\n      if (!target.startsWith(current)) {\n        displayedRef.current = target;\n        setDisplayedText(target);\n        progressRemainderRef.current = 0;\n        rafRef.current = window.requestAnimationFrame(tick);\n        return;\n      }\n\n      const pending = target.slice(current.length);\n      const pendingOffsets = graphemeEndOffsets(pending);\n      if (pendingOffsets.length === 0) {\n        rafRef.current = window.requestAnimationFrame(tick);\n        return;\n      }\n\n      const elapsedMs = Math.max(0, timestamp - previousTimestamp);\n      const targetIdleMs =\n        targetUpdatedAtRef.current === null\n          ? STREAM_IDLE_RELEASE_MS\n          : Math.max(0, timestamp - targetUpdatedAtRef.current);\n      const runway =\n        targetIdleMs >= STREAM_IDLE_RELEASE_MS\n          ? 0\n          : Math.min(\n              pendingOffsets.length - 1,\n              Math.max(1, Math.ceil((charsPerSecond * STREAM_RUNWAY_MS) / 1000))\n            );\n      const eligibleGraphemes = pendingOffsets.length - runway;\n\n      progressRemainderRef.current += (elapsedMs / 1000) * charsPerSecond;\n      let step = Math.floor(progressRemainderRef.current);\n      if (current.length === 0 && eligibleGraphemes > 0) step = Math.max(1, step);\n\n      const catchupStep =\n        pendingOffsets.length > catchupThreshold\n          ? Math.min(maxCatchupChars, Math.ceil(pendingOffsets.length / 10))\n          : 0;\n      step = Math.min(eligibleGraphemes, Math.max(step, catchupStep));\n\n      if (step > 0) {\n        progressRemainderRef.current = Math.max(0, progressRemainderRef.current - step);\n        const next = current + pending.slice(0, pendingOffsets[step - 1]);\n        displayedRef.current = next;\n        setDisplayedText(next);\n      }\n      rafRef.current = window.requestAnimationFrame(tick);\n    };\n\n    if (rafRef.current === null) {\n      rafRef.current = window.requestAnimationFrame(tick);\n    }\n\n    return () => {\n      if (rafRef.current !== null) {\n        cancelAnimationFrame(rafRef.current);\n        rafRef.current = null;\n      }\n      lastFrameAtRef.current = null;\n      progressRemainderRef.current = 0;\n    };\n  }, [cacheAdapter, catchupThreshold, charsPerSecond, id, isStreaming, maxCatchupChars]);\n\n  const reduceMotion =\n    typeof window !== \"undefined\" &&\n    typeof window.matchMedia === \"function\" &&\n    window.matchMedia(\"(prefers-reduced-motion: reduce)\").matches;\n\n  return {\n    displayedText: !isStreaming || reduceMotion ? text : displayedText,\n    isAnimating: isStreaming,\n    mode: isStreaming ? \"streaming\" : \"static\",\n    parseIncompleteMarkdown: isStreaming,\n  };\n}\n"],"mappings":"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","names":["reduceMotion"]}