@runtypelabs/persona 3.21.3 → 3.23.0

package/README.md

@@ -459,6 +459,72 @@ const myRules: ParseRule[] = [
 ];
 ```
 
+#### Optional: smart-dom-reader provider
+
+The default reader above is a zero-dependency `TreeWalker` and **does not pierce shadow
+DOM**. For pages built from web components, an optional provider backed by a
+vendored copy of [`@mcp-b/smart-dom-reader`](https://github.com/WebMCP-org/npm-packages/tree/main/packages/smart-dom-reader)
+ships as a **separate entry point**, `@runtypelabs/persona/smart-dom-reader`. It is **not**
+imported by the main bundle, so consumers who never import this subpath pay nothing — no
+extra install, no bundle weight, no IIFE/CDN impact.
+
+It adds, over the default reader: **Shadow-DOM piercing**, form grouping, and page
+landmarks/state — while still emitting Persona's `EnrichedPageElement[]` shape so it
+formats and flows through the same pipeline.
+
+```ts
+import initAgentWidget from '@runtypelabs/persona';
+import { createSmartDomReaderContextProvider } from '@runtypelabs/persona/smart-dom-reader';
+
+initAgentWidget({
+  // ...config
+  contextProviders: [
+    createSmartDomReaderContextProvider({
+      // 'interactive' (default) | 'full' — full adds semantic content AND is required
+      // for shadow-DOM piercing (shadow descendants surface only in full mode).
+      mode: 'full',
+      contextKey: 'pageContext',            // key under payload.context (default)
+      // root: document.querySelector('main') // optional: scope to a subtree, skip chrome
+    })
+  ]
+});
+```
+
+`contextProviders` are honored on the **agent** send path (`buildAgentPayload` merges each
+provider's result into `payload.context` on every request). If you drive the legacy
+flow/`buildPayload` path, call `collectSmartDomContext()` yourself and inject the result.
+
+You can also use the pieces directly:
+
+```ts
+import {
+  collectSmartDomContext,      // → EnrichedPageElement[] (parity with collectEnrichedPageContext)
+  smartDomResultToEnriched     // pure mapper: SmartDOMResult → EnrichedPageElement[]
+} from '@runtypelabs/persona/smart-dom-reader';
+import { formatEnrichedContext } from '@runtypelabs/persona';
+
+const pageContext = formatEnrichedContext(collectSmartDomContext({ mode: 'full' }));
+```
+
+Both `collectSmartDomContext()` and `createSmartDomReaderContextProvider()` accept a
+`root` element to scope extraction to a subtree (parity with `collectEnrichedPageContext`'s
+`root`) — useful to read only your main content region and skip nav/sidebars. Shadow DOM
+inside the subtree is still pierced.
+
+> **Actionability caveat.** Persona's click loop (`utils/actions.ts`) drives
+> `document.querySelector`, which cannot pierce shadow roots or evaluate XPath. The adapter
+> therefore prefers plain-CSS selectors; elements reachable only via shadow-piercing or
+> XPath selectors are surfaced to the model as **context only** and are **not clickable**
+> through the current `message_and_click` handler.
+
+> **Why vendored, not a dependency.** Every published version of `@mcp-b/smart-dom-reader`
+> (2.3.1–3.0.0) is mis-published — its `package.json` points to `dist/index.js` /
+> `dist/index.d.ts` while the build only ships `.mjs` / `.d.mts`, so it cannot be imported
+> by name in Node or any bundler. The library (MIT, zero-dep) is therefore vendored under
+> `packages/widget/src/vendor/smart-dom-reader/`; see that directory's `README.md` for
+> provenance and update steps. Once upstream republishes correctly this can revert to a
+> normal optional peer dependency.
+
 ### DOM Events
 
 The widget dispatches custom DOM events that you can listen to for integration with your application:
@@ -2278,6 +2344,7 @@ config: {
 | `showReasoning` | `boolean?` | Show thinking/reasoning bubbles. Default: `true`. |
 | `showToolCalls` | `boolean?` | Show tool usage bubbles. Default: `true`. |
 | `showEventStreamToggle` | `boolean?` | Show the event stream inspector toggle in the header. Default: `false`. |
+| `composerHistory` | `boolean?` | `Up`/`Down` arrows in the composer navigate previously sent user messages for re-entry/editing (shell / Slack style). Entered only when the caret is at the start of the input, so multi-line cursor movement is preserved. Default: `true`. |
 | `eventStream` | `EventStreamConfig?` | Event stream inspector configuration: `badgeColors`, `timestampFormat`, `showSequenceNumbers`, `maxEvents`, `descriptionFields`, `classNames`. |
 | `artifacts` | `AgentWidgetArtifactsFeature?` | Artifact sidebar: `enabled`, `allowedTypes`, optional `layout` (see below). |
 

package/dist/animations/glyph-cycle.cjs

@@ -1,62 +1,4 @@
-"use strict";
-var __defProp = Object.defineProperty;
-var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
-var __getOwnPropNames = Object.getOwnPropertyNames;
-var __hasOwnProp = Object.prototype.hasOwnProperty;
-var __export = (target, all) => {
-  for (var name in all)
-    __defProp(target, name, { get: all[name], enumerable: true });
-};
-var __copyProps = (to, from, except, desc) => {
-  if (from && typeof from === "object" || typeof from === "function") {
-    for (let key of __getOwnPropNames(from))
-      if (!__hasOwnProp.call(to, key) && key !== except)
-        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
-  }
-  return to;
-};
-var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
-
-// src/animations/glyph-cycle.ts
-var glyph_cycle_exports = {};
-__export(glyph_cycle_exports, {
-  default: () => glyph_cycle_default,
-  glyphCycle: () => glyphCycle
-});
-module.exports = __toCommonJS(glyph_cycle_exports);
-
-// src/utils/stream-animation.ts
-var BUILTIN_PLUGINS = [
-  {
-    name: "typewriter",
-    containerClass: "persona-stream-typewriter",
-    wrap: "char",
-    useCaret: true
-  },
-  {
-    name: "pop-bubble",
-    bubbleClass: "persona-stream-pop",
-    wrap: "none"
-  },
-  {
-    name: "letter-rise",
-    containerClass: "persona-stream-letter-rise",
-    wrap: "char"
-  },
-  {
-    name: "word-fade",
-    containerClass: "persona-stream-word-fade",
-    wrap: "word"
-  }
-];
-var globalRegistry = /* @__PURE__ */ new Map();
-for (const plugin of BUILTIN_PLUGINS) globalRegistry.set(plugin.name, plugin);
-var registerStreamAnimationPlugin = (plugin) => {
-  globalRegistry.set(plugin.name, plugin);
-};
-
-// src/animations/glyph-cycle.ts
-var STYLES = `
+"use strict";var d=Object.defineProperty;var L=Object.getOwnPropertyDescriptor;var P=Object.getOwnPropertyNames;var H=Object.prototype.hasOwnProperty;var W=(e,t)=>{for(var n in t)d(e,n,{get:t[n],enumerable:!0})},R=(e,t,n,r)=>{if(t&&typeof t=="object"||typeof t=="function")for(let a of P(t))!H.call(e,a)&&a!==n&&d(e,a,{get:()=>t[a],enumerable:!(r=L(t,a))||r.enumerable});return e};var N=e=>R(d({},"__esModule",{value:!0}),e);var J={};W(J,{default:()=>X,glyphCycle:()=>g});module.exports=N(J);var k=[{name:"typewriter",containerClass:"persona-stream-typewriter",wrap:"char",useCaret:!0},{name:"pop-bubble",bubbleClass:"persona-stream-pop",wrap:"none"},{name:"letter-rise",containerClass:"persona-stream-letter-rise",wrap:"char"},{name:"word-fade",containerClass:"persona-stream-word-fade",wrap:"word"}],f=new Map;for(let e of k)f.set(e.name,e);var A=e=>{f.set(e.name,e)};var D=`
 [data-persona-root] .persona-stream-glyph-cycle .persona-stream-char {
   animation: persona-stream-glyph-cycle-fade
     calc(var(--persona-stream-step, 120ms) * 1.5) ease-out both;
@@ -74,206 +16,4 @@ var STYLES = `
     opacity: 1 !important;
   }
 }
-`.trim();
-var GLYPHS = "ABCDEFGHIJKLMNOPQRSTUVWXYZ0123456789#$%&@";
-var TICK_COUNT = 10;
-var BASE_TICK_MS = 120;
-var DEFAULT_STEP_MS = 120;
-var CROSS_FLICKER_PROBABILITY = 0.4;
-var BUFFER_THRESHOLD = 50;
-var getStepMs = (container) => {
-  var _a;
-  if (!container) return DEFAULT_STEP_MS;
-  const raw = (_a = container.style.getPropertyValue("--persona-stream-step")) == null ? void 0 : _a.trim();
-  const match = raw.match(/([\d.]+)\s*ms/);
-  return match ? parseFloat(match[1]) : DEFAULT_STEP_MS;
-};
-var getTickMs = (span) => {
-  const container = span.closest(".persona-stream-glyph-cycle");
-  const step = getStepMs(container);
-  return BASE_TICK_MS * step / DEFAULT_STEP_MS;
-};
-var randomGlyph = (avoid) => {
-  let ch = GLYPHS[Math.floor(Math.random() * GLYPHS.length)];
-  if (avoid && ch === avoid) {
-    ch = GLYPHS[(GLYPHS.indexOf(ch) + 1) % GLYPHS.length];
-  }
-  return ch;
-};
-var flickerLaterSiblings = (span) => {
-  const container = span.closest(".persona-stream-glyph-cycle");
-  if (!container) return;
-  const unsettled = container.querySelectorAll(
-    ".persona-stream-char[data-glyph-cycle-final]"
-  );
-  let seenSelf = false;
-  for (const other of Array.from(unsettled)) {
-    if (other === span) {
-      seenSelf = true;
-      continue;
-    }
-    if (!seenSelf) continue;
-    if (Math.random() < CROSS_FLICKER_PROBABILITY) {
-      other.textContent = randomGlyph();
-    }
-  }
-};
-var containerNextSettleAt = /* @__PURE__ */ new WeakMap();
-var DEFAULT_ARRIVAL_MS = 25;
-var STAGGER_DRAIN_FACTOR = 0.5;
-var MIN_STAGGER_MS = 6;
-var EMA_ALPHA = 0.25;
-var containerLastScheduleAt = /* @__PURE__ */ new WeakMap();
-var containerArrivalMs = /* @__PURE__ */ new WeakMap();
-var observeStagger = (container, now) => {
-  var _a;
-  if (!container) return DEFAULT_ARRIVAL_MS * STAGGER_DRAIN_FACTOR;
-  const last = containerLastScheduleAt.get(container);
-  containerLastScheduleAt.set(container, now);
-  let observed = (_a = containerArrivalMs.get(container)) != null ? _a : DEFAULT_ARRIVAL_MS;
-  if (last !== void 0) {
-    const interval = now - last;
-    if (interval > 1) {
-      observed = observed * (1 - EMA_ALPHA) + interval * EMA_ALPHA;
-      containerArrivalMs.set(container, observed);
-    }
-  }
-  return Math.max(MIN_STAGGER_MS, observed * STAGGER_DRAIN_FACTOR);
-};
-var activeCyclesByMessage = /* @__PURE__ */ new Map();
-var getMessageId = (span) => {
-  var _a;
-  const bubble = span.closest("[data-message-id]");
-  return (_a = bubble == null ? void 0 : bubble.dataset.messageId) != null ? _a : null;
-};
-var incrementActive = (messageId) => {
-  var _a;
-  if (!messageId) return;
-  activeCyclesByMessage.set(messageId, ((_a = activeCyclesByMessage.get(messageId)) != null ? _a : 0) + 1);
-};
-var decrementActive = (messageId) => {
-  var _a;
-  if (!messageId) return;
-  const count = (_a = activeCyclesByMessage.get(messageId)) != null ? _a : 0;
-  if (count <= 1) activeCyclesByMessage.delete(messageId);
-  else activeCyclesByMessage.set(messageId, count - 1);
-};
-var scheduleCycle = (span) => {
-  var _a;
-  if (span.dataset.glyphCycleScheduled === "true") return;
-  const finalChar = (_a = span.textContent) != null ? _a : "";
-  if (!finalChar || /\s/.test(finalChar)) return;
-  span.dataset.glyphCycleScheduled = "true";
-  span.dataset.glyphCycleFinal = finalChar;
-  span.setAttribute("data-preserve-runtime", "stream-glyph-cycle");
-  span.textContent = randomGlyph();
-  const messageId = getMessageId(span);
-  if (messageId) span.dataset.glyphCycleMessageId = messageId;
-  incrementActive(messageId);
-  const container = span.closest(".persona-stream-glyph-cycle");
-  const now = Date.now();
-  const staggerMs = observeStagger(container, now);
-  const tickMs = getTickMs(span);
-  const baseDurationMs = TICK_COUNT * tickMs;
-  let settleAt = now + baseDurationMs;
-  if (container) {
-    const prev = containerNextSettleAt.get(container);
-    if (prev !== void 0) settleAt = Math.max(settleAt, prev);
-    containerNextSettleAt.set(container, settleAt + staggerMs);
-  }
-  startCycle(span, finalChar, settleAt);
-};
-var startCycle = (span, finalChar, settleAt) => {
-  var _a;
-  if (span.dataset.glyphCycleStarted === "true") return;
-  span.dataset.glyphCycleStarted = "true";
-  const tickMs = getTickMs(span);
-  let lastGlyph = (_a = span.textContent) != null ? _a : void 0;
-  const step = () => {
-    var _a2;
-    if (!span.isConnected) return;
-    if (Date.now() >= settleAt) {
-      span.textContent = finalChar;
-      span.removeAttribute("data-preserve-runtime");
-      delete span.dataset.glyphCycleStarted;
-      delete span.dataset.glyphCycleFinal;
-      decrementActive((_a2 = span.dataset.glyphCycleMessageId) != null ? _a2 : null);
-      delete span.dataset.glyphCycleMessageId;
-      return;
-    }
-    const glyph = randomGlyph(lastGlyph);
-    span.textContent = glyph;
-    lastGlyph = glyph;
-    flickerLaterSiblings(span);
-    setTimeout(step, tickMs);
-  };
-  setTimeout(step, tickMs);
-};
-var processCharSpans = (root) => {
-  var _a;
-  const spans = (_a = root.querySelectorAll) == null ? void 0 : _a.call(
-    root,
-    ".persona-stream-glyph-cycle .persona-stream-char:not([data-glyph-cycle-scheduled])"
-  );
-  if (!spans) return;
-  for (const span of Array.from(spans)) {
-    scheduleCycle(span);
-  }
-};
-var isElement = (node) => node.nodeType === 1;
-var glyphCycle = {
-  name: "glyph-cycle",
-  containerClass: "persona-stream-glyph-cycle",
-  wrap: "char",
-  // Narrow the default skip list so inline `<code>` and fenced `<pre>`
-  // code blocks both render as cycling glyphs along with everything else.
-  // Links stay clickable; <script>/<style> stay untouched.
-  skipTags: ["a", "script", "style"],
-  styles: STYLES,
-  bufferContent(content) {
-    if (content.length < BUFFER_THRESHOLD) return "";
-    let boldPairs = 0;
-    let lastSafe = -1;
-    let i = 0;
-    while (i < content.length) {
-      if (content[i] === "*" && content[i + 1] === "*") {
-        boldPairs += 1;
-        i += 2;
-        continue;
-      }
-      if (/\s/.test(content[i]) && boldPairs % 2 === 0) {
-        lastSafe = i;
-      }
-      i += 1;
-    }
-    if (lastSafe < 0) return "";
-    return content.slice(0, lastSafe);
-  },
-  isAnimating(message) {
-    var _a;
-    return ((_a = activeCyclesByMessage.get(message.id)) != null ? _a : 0) > 0;
-  },
-  onAttach(root) {
-    processCharSpans(root);
-    const observer = new MutationObserver((mutations) => {
-      for (const mutation of mutations) {
-        for (const node of Array.from(mutation.addedNodes)) {
-          if (!isElement(node)) continue;
-          if (node.classList.contains("persona-stream-char") && node.closest(".persona-stream-glyph-cycle")) {
-            scheduleCycle(node);
-          } else {
-            processCharSpans(node);
-          }
-        }
-      }
-    });
-    observer.observe(root, { childList: true, subtree: true });
-    return () => observer.disconnect();
-  }
-};
-registerStreamAnimationPlugin(glyphCycle);
-var glyph_cycle_default = glyphCycle;
-// Annotate the CommonJS export names for ESM import in node:
-0 && (module.exports = {
-  glyphCycle
-});
+`.trim(),l="ABCDEFGHIJKLMNOPQRSTUVWXYZ0123456789#$%&@",_=10,I=120,u=120,F=.4,B=50,O=e=>{var r;if(!e)return u;let n=((r=e.style.getPropertyValue("--persona-stream-step"))==null?void 0:r.trim()).match(/([\d.]+)\s*ms/);return n?parseFloat(n[1]):u},x=e=>{let t=e.closest(".persona-stream-glyph-cycle"),n=O(t);return I*n/u},p=e=>{let t=l[Math.floor(Math.random()*l.length)];return e&&t===e&&(t=l[(l.indexOf(t)+1)%l.length]),t},G=e=>{let t=e.closest(".persona-stream-glyph-cycle");if(!t)return;let n=t.querySelectorAll(".persona-stream-char[data-glyph-cycle-final]"),r=!1;for(let a of Array.from(n)){if(a===e){r=!0;continue}r&&Math.random()<F&&(a.textContent=p())}},S=new WeakMap,T=25,C=.5,U=6,M=.25,w=new WeakMap,E=new WeakMap,$=(e,t)=>{var a;if(!e)return T*C;let n=w.get(e);w.set(e,t);let r=(a=E.get(e))!=null?a:T;if(n!==void 0){let s=t-n;s>1&&(r=r*(1-M)+s*M,E.set(e,r))}return Math.max(U,r*C)},i=new Map,j=e=>{var n;let t=e.closest("[data-message-id]");return(n=t==null?void 0:t.dataset.messageId)!=null?n:null},K=e=>{var t;e&&i.set(e,((t=i.get(e))!=null?t:0)+1)},V=e=>{var n;if(!e)return;let t=(n=i.get(e))!=null?n:0;t<=1?i.delete(e):i.set(e,t-1)},v=e=>{var h;if(e.dataset.glyphCycleScheduled==="true")return;let t=(h=e.textContent)!=null?h:"";if(!t||/\s/.test(t))return;e.dataset.glyphCycleScheduled="true",e.dataset.glyphCycleFinal=t,e.setAttribute("data-preserve-runtime","stream-glyph-cycle"),e.textContent=p();let n=j(e);n&&(e.dataset.glyphCycleMessageId=n),K(n);let r=e.closest(".persona-stream-glyph-cycle"),a=Date.now(),s=$(r,a),c=x(e),m=_*c,o=a+m;if(r){let y=S.get(r);y!==void 0&&(o=Math.max(o,y)),S.set(r,o+s)}Y(e,t,o)},Y=(e,t,n)=>{var c;if(e.dataset.glyphCycleStarted==="true")return;e.dataset.glyphCycleStarted="true";let r=x(e),a=(c=e.textContent)!=null?c:void 0,s=()=>{var o;if(!e.isConnected)return;if(Date.now()>=n){e.textContent=t,e.removeAttribute("data-preserve-runtime"),delete e.dataset.glyphCycleStarted,delete e.dataset.glyphCycleFinal,V((o=e.dataset.glyphCycleMessageId)!=null?o:null),delete e.dataset.glyphCycleMessageId;return}let m=p(a);e.textContent=m,a=m,G(e),setTimeout(s,r)};setTimeout(s,r)},b=e=>{var n;let t=(n=e.querySelectorAll)==null?void 0:n.call(e,".persona-stream-glyph-cycle .persona-stream-char:not([data-glyph-cycle-scheduled])");if(t)for(let r of Array.from(t))v(r)},q=e=>e.nodeType===1,g={name:"glyph-cycle",containerClass:"persona-stream-glyph-cycle",wrap:"char",skipTags:["a","script","style"],styles:D,bufferContent(e){if(e.length<B)return"";let t=0,n=-1,r=0;for(;r<e.length;){if(e[r]==="*"&&e[r+1]==="*"){t+=1,r+=2;continue}/\s/.test(e[r])&&t%2===0&&(n=r),r+=1}return n<0?"":e.slice(0,n)},isAnimating(e){var t;return((t=i.get(e.id))!=null?t:0)>0},onAttach(e){b(e);let t=new MutationObserver(n=>{for(let r of n)for(let a of Array.from(r.addedNodes))q(a)&&(a.classList.contains("persona-stream-char")&&a.closest(".persona-stream-glyph-cycle")?v(a):b(a))});return t.observe(e,{childList:!0,subtree:!0}),()=>t.disconnect()}};A(g);var X=g;0&&(module.exports={glyphCycle});

package/dist/animations/glyph-cycle.d.cts

@@ -1,4 +1,4 @@
-import { S as StreamAnimationPlugin } from './types-CWPIj66R.cjs';
+import { S as StreamAnimationPlugin } from './types-BZVr1YOV.cjs';
 
 declare const glyphCycle: StreamAnimationPlugin;
 

package/dist/animations/glyph-cycle.d.ts

@@ -1,4 +1,4 @@
-import { S as StreamAnimationPlugin } from './types-CWPIj66R.js';
+import { S as StreamAnimationPlugin } from './types-BZVr1YOV.js';
 
 declare const glyphCycle: StreamAnimationPlugin;
 

package/dist/animations/glyph-cycle.js

@@ -1,35 +1,4 @@
-// src/utils/stream-animation.ts
-var BUILTIN_PLUGINS = [
-  {
-    name: "typewriter",
-    containerClass: "persona-stream-typewriter",
-    wrap: "char",
-    useCaret: true
-  },
-  {
-    name: "pop-bubble",
-    bubbleClass: "persona-stream-pop",
-    wrap: "none"
-  },
-  {
-    name: "letter-rise",
-    containerClass: "persona-stream-letter-rise",
-    wrap: "char"
-  },
-  {
-    name: "word-fade",
-    containerClass: "persona-stream-word-fade",
-    wrap: "word"
-  }
-];
-var globalRegistry = /* @__PURE__ */ new Map();
-for (const plugin of BUILTIN_PLUGINS) globalRegistry.set(plugin.name, plugin);
-var registerStreamAnimationPlugin = (plugin) => {
-  globalRegistry.set(plugin.name, plugin);
-};
-
-// src/animations/glyph-cycle.ts
-var STYLES = `
+var v=[{name:"typewriter",containerClass:"persona-stream-typewriter",wrap:"char",useCaret:!0},{name:"pop-bubble",bubbleClass:"persona-stream-pop",wrap:"none"},{name:"letter-rise",containerClass:"persona-stream-letter-rise",wrap:"char"},{name:"word-fade",containerClass:"persona-stream-word-fade",wrap:"word"}],h=new Map;for(let e of v)h.set(e.name,e);var y=e=>{h.set(e.name,e)};var L=`
 [data-persona-root] .persona-stream-glyph-cycle .persona-stream-char {
   animation: persona-stream-glyph-cycle-fade
     calc(var(--persona-stream-step, 120ms) * 1.5) ease-out both;
@@ -47,206 +16,4 @@ var STYLES = `
     opacity: 1 !important;
   }
 }
-`.trim();
-var GLYPHS = "ABCDEFGHIJKLMNOPQRSTUVWXYZ0123456789#$%&@";
-var TICK_COUNT = 10;
-var BASE_TICK_MS = 120;
-var DEFAULT_STEP_MS = 120;
-var CROSS_FLICKER_PROBABILITY = 0.4;
-var BUFFER_THRESHOLD = 50;
-var getStepMs = (container) => {
-  var _a;
-  if (!container) return DEFAULT_STEP_MS;
-  const raw = (_a = container.style.getPropertyValue("--persona-stream-step")) == null ? void 0 : _a.trim();
-  const match = raw.match(/([\d.]+)\s*ms/);
-  return match ? parseFloat(match[1]) : DEFAULT_STEP_MS;
-};
-var getTickMs = (span) => {
-  const container = span.closest(".persona-stream-glyph-cycle");
-  const step = getStepMs(container);
-  return BASE_TICK_MS * step / DEFAULT_STEP_MS;
-};
-var randomGlyph = (avoid) => {
-  let ch = GLYPHS[Math.floor(Math.random() * GLYPHS.length)];
-  if (avoid && ch === avoid) {
-    ch = GLYPHS[(GLYPHS.indexOf(ch) + 1) % GLYPHS.length];
-  }
-  return ch;
-};
-var flickerLaterSiblings = (span) => {
-  const container = span.closest(".persona-stream-glyph-cycle");
-  if (!container) return;
-  const unsettled = container.querySelectorAll(
-    ".persona-stream-char[data-glyph-cycle-final]"
-  );
-  let seenSelf = false;
-  for (const other of Array.from(unsettled)) {
-    if (other === span) {
-      seenSelf = true;
-      continue;
-    }
-    if (!seenSelf) continue;
-    if (Math.random() < CROSS_FLICKER_PROBABILITY) {
-      other.textContent = randomGlyph();
-    }
-  }
-};
-var containerNextSettleAt = /* @__PURE__ */ new WeakMap();
-var DEFAULT_ARRIVAL_MS = 25;
-var STAGGER_DRAIN_FACTOR = 0.5;
-var MIN_STAGGER_MS = 6;
-var EMA_ALPHA = 0.25;
-var containerLastScheduleAt = /* @__PURE__ */ new WeakMap();
-var containerArrivalMs = /* @__PURE__ */ new WeakMap();
-var observeStagger = (container, now) => {
-  var _a;
-  if (!container) return DEFAULT_ARRIVAL_MS * STAGGER_DRAIN_FACTOR;
-  const last = containerLastScheduleAt.get(container);
-  containerLastScheduleAt.set(container, now);
-  let observed = (_a = containerArrivalMs.get(container)) != null ? _a : DEFAULT_ARRIVAL_MS;
-  if (last !== void 0) {
-    const interval = now - last;
-    if (interval > 1) {
-      observed = observed * (1 - EMA_ALPHA) + interval * EMA_ALPHA;
-      containerArrivalMs.set(container, observed);
-    }
-  }
-  return Math.max(MIN_STAGGER_MS, observed * STAGGER_DRAIN_FACTOR);
-};
-var activeCyclesByMessage = /* @__PURE__ */ new Map();
-var getMessageId = (span) => {
-  var _a;
-  const bubble = span.closest("[data-message-id]");
-  return (_a = bubble == null ? void 0 : bubble.dataset.messageId) != null ? _a : null;
-};
-var incrementActive = (messageId) => {
-  var _a;
-  if (!messageId) return;
-  activeCyclesByMessage.set(messageId, ((_a = activeCyclesByMessage.get(messageId)) != null ? _a : 0) + 1);
-};
-var decrementActive = (messageId) => {
-  var _a;
-  if (!messageId) return;
-  const count = (_a = activeCyclesByMessage.get(messageId)) != null ? _a : 0;
-  if (count <= 1) activeCyclesByMessage.delete(messageId);
-  else activeCyclesByMessage.set(messageId, count - 1);
-};
-var scheduleCycle = (span) => {
-  var _a;
-  if (span.dataset.glyphCycleScheduled === "true") return;
-  const finalChar = (_a = span.textContent) != null ? _a : "";
-  if (!finalChar || /\s/.test(finalChar)) return;
-  span.dataset.glyphCycleScheduled = "true";
-  span.dataset.glyphCycleFinal = finalChar;
-  span.setAttribute("data-preserve-runtime", "stream-glyph-cycle");
-  span.textContent = randomGlyph();
-  const messageId = getMessageId(span);
-  if (messageId) span.dataset.glyphCycleMessageId = messageId;
-  incrementActive(messageId);
-  const container = span.closest(".persona-stream-glyph-cycle");
-  const now = Date.now();
-  const staggerMs = observeStagger(container, now);
-  const tickMs = getTickMs(span);
-  const baseDurationMs = TICK_COUNT * tickMs;
-  let settleAt = now + baseDurationMs;
-  if (container) {
-    const prev = containerNextSettleAt.get(container);
-    if (prev !== void 0) settleAt = Math.max(settleAt, prev);
-    containerNextSettleAt.set(container, settleAt + staggerMs);
-  }
-  startCycle(span, finalChar, settleAt);
-};
-var startCycle = (span, finalChar, settleAt) => {
-  var _a;
-  if (span.dataset.glyphCycleStarted === "true") return;
-  span.dataset.glyphCycleStarted = "true";
-  const tickMs = getTickMs(span);
-  let lastGlyph = (_a = span.textContent) != null ? _a : void 0;
-  const step = () => {
-    var _a2;
-    if (!span.isConnected) return;
-    if (Date.now() >= settleAt) {
-      span.textContent = finalChar;
-      span.removeAttribute("data-preserve-runtime");
-      delete span.dataset.glyphCycleStarted;
-      delete span.dataset.glyphCycleFinal;
-      decrementActive((_a2 = span.dataset.glyphCycleMessageId) != null ? _a2 : null);
-      delete span.dataset.glyphCycleMessageId;
-      return;
-    }
-    const glyph = randomGlyph(lastGlyph);
-    span.textContent = glyph;
-    lastGlyph = glyph;
-    flickerLaterSiblings(span);
-    setTimeout(step, tickMs);
-  };
-  setTimeout(step, tickMs);
-};
-var processCharSpans = (root) => {
-  var _a;
-  const spans = (_a = root.querySelectorAll) == null ? void 0 : _a.call(
-    root,
-    ".persona-stream-glyph-cycle .persona-stream-char:not([data-glyph-cycle-scheduled])"
-  );
-  if (!spans) return;
-  for (const span of Array.from(spans)) {
-    scheduleCycle(span);
-  }
-};
-var isElement = (node) => node.nodeType === 1;
-var glyphCycle = {
-  name: "glyph-cycle",
-  containerClass: "persona-stream-glyph-cycle",
-  wrap: "char",
-  // Narrow the default skip list so inline `<code>` and fenced `<pre>`
-  // code blocks both render as cycling glyphs along with everything else.
-  // Links stay clickable; <script>/<style> stay untouched.
-  skipTags: ["a", "script", "style"],
-  styles: STYLES,
-  bufferContent(content) {
-    if (content.length < BUFFER_THRESHOLD) return "";
-    let boldPairs = 0;
-    let lastSafe = -1;
-    let i = 0;
-    while (i < content.length) {
-      if (content[i] === "*" && content[i + 1] === "*") {
-        boldPairs += 1;
-        i += 2;
-        continue;
-      }
-      if (/\s/.test(content[i]) && boldPairs % 2 === 0) {
-        lastSafe = i;
-      }
-      i += 1;
-    }
-    if (lastSafe < 0) return "";
-    return content.slice(0, lastSafe);
-  },
-  isAnimating(message) {
-    var _a;
-    return ((_a = activeCyclesByMessage.get(message.id)) != null ? _a : 0) > 0;
-  },
-  onAttach(root) {
-    processCharSpans(root);
-    const observer = new MutationObserver((mutations) => {
-      for (const mutation of mutations) {
-        for (const node of Array.from(mutation.addedNodes)) {
-          if (!isElement(node)) continue;
-          if (node.classList.contains("persona-stream-char") && node.closest(".persona-stream-glyph-cycle")) {
-            scheduleCycle(node);
-          } else {
-            processCharSpans(node);
-          }
-        }
-      }
-    });
-    observer.observe(root, { childList: true, subtree: true });
-    return () => observer.disconnect();
-  }
-};
-registerStreamAnimationPlugin(glyphCycle);
-var glyph_cycle_default = glyphCycle;
-export {
-  glyph_cycle_default as default,
-  glyphCycle
-};
+`.trim(),l="ABCDEFGHIJKLMNOPQRSTUVWXYZ0123456789#$%&@",P=10,H=120,d=120,W=.4,R=50,N=e=>{var r;if(!e)return d;let n=((r=e.style.getPropertyValue("--persona-stream-step"))==null?void 0:r.trim()).match(/([\d.]+)\s*ms/);return n?parseFloat(n[1]):d},E=e=>{let t=e.closest(".persona-stream-glyph-cycle"),n=N(t);return H*n/d},u=e=>{let t=l[Math.floor(Math.random()*l.length)];return e&&t===e&&(t=l[(l.indexOf(t)+1)%l.length]),t},k=e=>{let t=e.closest(".persona-stream-glyph-cycle");if(!t)return;let n=t.querySelectorAll(".persona-stream-char[data-glyph-cycle-final]"),r=!1;for(let a of Array.from(n)){if(a===e){r=!0;continue}r&&Math.random()<W&&(a.textContent=u())}},f=new WeakMap,A=25,S=.5,D=6,T=.25,C=new WeakMap,M=new WeakMap,_=(e,t)=>{var a;if(!e)return A*S;let n=C.get(e);C.set(e,t);let r=(a=M.get(e))!=null?a:A;if(n!==void 0){let s=t-n;s>1&&(r=r*(1-T)+s*T,M.set(e,r))}return Math.max(D,r*S)},i=new Map,I=e=>{var n;let t=e.closest("[data-message-id]");return(n=t==null?void 0:t.dataset.messageId)!=null?n:null},F=e=>{var t;e&&i.set(e,((t=i.get(e))!=null?t:0)+1)},B=e=>{var n;if(!e)return;let t=(n=i.get(e))!=null?n:0;t<=1?i.delete(e):i.set(e,t-1)},b=e=>{var p;if(e.dataset.glyphCycleScheduled==="true")return;let t=(p=e.textContent)!=null?p:"";if(!t||/\s/.test(t))return;e.dataset.glyphCycleScheduled="true",e.dataset.glyphCycleFinal=t,e.setAttribute("data-preserve-runtime","stream-glyph-cycle"),e.textContent=u();let n=I(e);n&&(e.dataset.glyphCycleMessageId=n),F(n);let r=e.closest(".persona-stream-glyph-cycle"),a=Date.now(),s=_(r,a),c=E(e),m=P*c,o=a+m;if(r){let g=f.get(r);g!==void 0&&(o=Math.max(o,g)),f.set(r,o+s)}O(e,t,o)},O=(e,t,n)=>{var c;if(e.dataset.glyphCycleStarted==="true")return;e.dataset.glyphCycleStarted="true";let r=E(e),a=(c=e.textContent)!=null?c:void 0,s=()=>{var o;if(!e.isConnected)return;if(Date.now()>=n){e.textContent=t,e.removeAttribute("data-preserve-runtime"),delete e.dataset.glyphCycleStarted,delete e.dataset.glyphCycleFinal,B((o=e.dataset.glyphCycleMessageId)!=null?o:null),delete e.dataset.glyphCycleMessageId;return}let m=u(a);e.textContent=m,a=m,k(e),setTimeout(s,r)};setTimeout(s,r)},w=e=>{var n;let t=(n=e.querySelectorAll)==null?void 0:n.call(e,".persona-stream-glyph-cycle .persona-stream-char:not([data-glyph-cycle-scheduled])");if(t)for(let r of Array.from(t))b(r)},G=e=>e.nodeType===1,x={name:"glyph-cycle",containerClass:"persona-stream-glyph-cycle",wrap:"char",skipTags:["a","script","style"],styles:L,bufferContent(e){if(e.length<R)return"";let t=0,n=-1,r=0;for(;r<e.length;){if(e[r]==="*"&&e[r+1]==="*"){t+=1,r+=2;continue}/\s/.test(e[r])&&t%2===0&&(n=r),r+=1}return n<0?"":e.slice(0,n)},isAnimating(e){var t;return((t=i.get(e.id))!=null?t:0)>0},onAttach(e){w(e);let t=new MutationObserver(n=>{for(let r of n)for(let a of Array.from(r.addedNodes))G(a)&&(a.classList.contains("persona-stream-char")&&a.closest(".persona-stream-glyph-cycle")?b(a):w(a))});return t.observe(e,{childList:!0,subtree:!0}),()=>t.disconnect()}};y(x);var j=x;export{j as default,x as glyphCycle};

package/dist/animations/{types-CWPIj66R.d.cts → types-BZVr1YOV.d.cts}

@@ -73,6 +73,16 @@ type AgentMessageMetadata = {
      * `POST /v1/dispatch/resume` with the user's answer keyed by tool name.
      */
     awaitingLocalTool?: boolean;
+    /**
+     * The provider per-call id (`toolu_…`) carried on the `step_await` /
+     * `flow_await` events for a LOCAL tool (core#3878). Present only when the
+     * server emits it. Two PARALLEL calls to the same tool in one turn share a
+     * `toolName` (and a collapsed `toolId`) but get DISTINCT `webMcpToolCallId`s,
+     * so this is the key the widget batches a single `/resume` on — preferred
+     * over tool name, which collides for same-tool parallel calls. Absent →
+     * fall back to the legacy name-keyed resume contract.
+     */
+    webMcpToolCallId?: string;
     /**
      * Set to `true` once the user has picked / typed / dismissed an answer for
      * an `ask_user_question` tool call, so renderers stop re-mounting the

package/dist/animations/{types-CWPIj66R.d.ts → types-BZVr1YOV.d.ts}

@@ -73,6 +73,16 @@ type AgentMessageMetadata = {
      * `POST /v1/dispatch/resume` with the user's answer keyed by tool name.
      */
     awaitingLocalTool?: boolean;
+    /**
+     * The provider per-call id (`toolu_…`) carried on the `step_await` /
+     * `flow_await` events for a LOCAL tool (core#3878). Present only when the
+     * server emits it. Two PARALLEL calls to the same tool in one turn share a
+     * `toolName` (and a collapsed `toolId`) but get DISTINCT `webMcpToolCallId`s,
+     * so this is the key the widget batches a single `/resume` on — preferred
+     * over tool name, which collides for same-tool parallel calls. Absent →
+     * fall back to the legacy name-keyed resume contract.
+     */
+    webMcpToolCallId?: string;
     /**
      * Set to `true` once the user has picked / typed / dismissed an answer for
      * an `ask_user_question` tool call, so renderers stop re-mounting the