@inkeep/agents-ui 0.15.13 → 0.15.14

package/dist/primitives/components/embedded-chat/use-inkeep-chat.js

@@ -1,204 +1,312 @@
 "use client";
-import { useChat as re } from "@ai-sdk/react";
-import { DefaultChatTransport as ae } from "ai";
-import { useState as m, useMemo as H, useEffect as O, useRef as ie, useImperativeHandle as le } from "react";
-import { useInkeepConfig as ce } from "../../providers/config-provider.js";
-import { useMediaQuery as me } from "../../hooks/use-media-query.js";
+import { useChat as De } from "@ai-sdk/react";
+import { DefaultChatTransport as Pe } from "ai";
+import { useState as C, useRef as l, useMemo as le, useEffect as ue, useCallback as x, useImperativeHandle as He } from "react";
+import { useModal as Le } from "../modal/modal-provider.js";
+import { useOptionalChatBubble as Ue } from "../../providers/chat-bubble-provider.js";
+import { useOptionalSidebarChat as $e } from "../../providers/sidebar-chat-provider.js";
+import { useInkeepConfig as ze } from "../../providers/config-provider.js";
+import { useCaptcha as We } from "./use-captcha.js";
+import { useMediaQuery as qe } from "../../hooks/use-media-query.js";
+import { useAnonymousSession as Ke } from "../../hooks/use-anonymous-session.js";
+import { useConversationLoader as Je } from "../../hooks/use-conversation-loader.js";
 import { generateUid as W } from "../../utils/generate-uid.js";
-import { useBaseEvents as pe } from "../../providers/base-events-provider.js";
-import { useChatForm as ue } from "../../providers/chat-form-provider.js";
-import { useWidget as fe } from "../../providers/widget-provider.js";
-import { useControllableState as ge } from "@radix-ui/react-use-controllable-state";
-import { useStreamingEvents as de } from "../../hooks/use-streaming-events.js";
-const he = `Hmm.. 
+import { useBaseEvents as je } from "../../providers/base-events-provider.js";
+import { useChatForm as Ge } from "../../providers/chat-form-provider.js";
+import { useWidget as Qe } from "../../providers/widget-provider.js";
+import { useControllableState as Ve } from "@radix-ui/react-use-controllable-state";
+import { useStreamingEvents as Ze } from "../../hooks/use-streaming-events.js";
+import { parseAuthError as Xe } from "../../hooks/use-inkeep-api-client.js";
+function Ye(d) {
+  const u = d.message ?? "";
+  let s = Number(d.code) || Number(d.statusCode);
+  if (Number.isNaN(s))
+    try {
+      s = Number(JSON.parse(u).status);
+    } catch {
+    }
+  const p = Xe(s, { detail: u });
+  return p !== null ? p : s === 401 ? "session" : null;
+}
+const pe = `Hmm.. 
 
-It seems I might be having some issues right now. Please clear the chat and try again.`, Fe = () => {
-  const { baseSettings: S, aiChatSettings: c } = ce(), [n = "", E] = ge({
-    prop: c.conversationId,
-    defaultProp: c.conversationId ?? ""
-  }), { logEvent: r } = pe(), { setConversationId: q, emitToParent: p } = de(), [a, u] = m(""), z = (e) => u(e.target.value), {
-    /*  shouldBypassCaptcha, */
-    filters: w
-  } = S, {
-    onInputMessageChange: K,
-    filters: M,
-    agentUrl: x,
-    context: f,
-    headers: g,
-    apiKey: d
-  } = c, U = (e) => {
+It seems I might be having some issues right now. Please clear the chat and try again.`, vt = () => {
+  const { baseSettings: d, aiChatSettings: u } = ze(), [s = "", p] = Ve({
+    prop: u.conversationId,
+    defaultProp: u.conversationId ?? ""
+  }), me = Le(), de = Ue(), fe = $e(), { logEvent: h } = je(), { setConversationId: ge, emitToParent: S } = Ze(), [y, k] = C(""), he = (e) => k(e.target.value), { shouldBypassCaptcha: q, filters: K, privacyPreferences: ye } = d, {
+    onInputMessageChange: ve,
+    filters: J,
+    baseUrl: I,
+    agentUrl: be,
+    context: j,
+    headers: G,
+    appId: v,
+    apiKey: m
+  } = u, Ce = me?.isOpen ?? de?.isOpen ?? fe?.isOpen ?? !0, { getCaptchaHeader: b, invalidate: c } = We({
+    baseUrl: I,
+    shouldBypassCaptcha: q || !!m,
+    shouldMakeInitialRequest: Ce
+  }), Q = l(b);
+  Q.current = b;
+  const V = be || `${I}/run/api/chat`, { sessionToken: N, refreshSession: T } = Ke({
+    baseUrl: I,
+    appId: v,
+    getCaptchaHeader: b,
+    invalidateCaptcha: c,
+    optOutAllAnalytics: ye?.optOutAllAnalytics
+  }), { loadConversation: Z } = Je({
+    baseUrl: I,
+    appId: v,
+    authToken: m ?? N,
+    getCaptchaHeader: b,
+    invalidateCaptcha: c,
+    // Only pass refreshSession for anonymous-session flows; API key auth has no token to refresh.
+    refreshSession: m ? void 0 : T
+  }), [Se, X] = C(!1), A = l(null);
+  A.current = N;
+  const f = l(0), Y = l(null), O = l(null), ee = l(G);
+  ee.current = G;
+  const _ = l(void 0);
+  _.current = K || J ? JSON.stringify({ ...K, ...J }) : void 0;
+  const Ie = (e) => {
     switch (e.code) {
       case 400:
         return e.message;
       case 403:
-        return `There seems to be a configuration error. Please contact ${S.organizationDisplayName ?? "Administrator"}`;
+        return `There seems to be a configuration error. Please contact ${d.organizationDisplayName ?? "Administrator"}`;
       default:
-        return he;
+        return pe;
     }
-  }, [$, h] = m([]), [L, _] = m(null), j = () => ({
-    "x-inkeep-client-timezone": Intl.DateTimeFormat().resolvedOptions().timeZone,
-    "x-inkeep-client-timestamp": (/* @__PURE__ */ new Date()).toISOString()
-  }), G = H(
-    () => new ae({
-      api: x,
-      headers: {
-        ...d ? { Authorization: `Bearer ${d}` } : {},
-        ...g
+  }, [Ae, R] = C([]), [Re, F] = C(null), we = le(
+    () => new Pe({
+      api: V,
+      headers: () => ({
+        "x-inkeep-client-timezone": Intl.DateTimeFormat().resolvedOptions().timeZone,
+        "x-inkeep-client-timestamp": (/* @__PURE__ */ new Date()).toISOString(),
+        ...v ? { "x-inkeep-app-id": v } : {},
+        ...A.current ? { Authorization: `Bearer ${A.current}` } : {},
+        ...m ? { Authorization: `Bearer ${m}` } : {},
+        ..._.current ? { "inkeep-filters": _.current } : {},
+        ...ee.current
+      }),
+      prepareSendMessagesRequest: async (e) => {
+        const t = await Q.current();
+        return {
+          body: {
+            ...e.body,
+            id: e.id,
+            messages: e.messages,
+            trigger: e.trigger,
+            messageId: e.messageId
+          },
+          headers: {
+            ...e.headers,
+            ...t
+          }
+        };
       },
       body: {
-        requestContext: f
+        requestContext: j
       }
     }),
-    [x, d, g, f]
+    [V, j, v, m]
   ), {
-    messages: i,
-    sendMessage: F,
-    addToolApprovalResponse: J,
-    status: k,
-    setMessages: A,
-    stop: Q,
-    error: v
-  } = re({
-    transport: G,
+    messages: w,
+    sendMessage: B,
+    addToolApprovalResponse: D,
+    status: te,
+    setMessages: g,
+    stop: se,
+    error: P
+  } = De({
+    transport: we,
     onData(e) {
-      p(e.type, e.data);
+      S(e.type, e.data);
     },
     async onFinish() {
-      p("completion", { conversationId: n }), await r({
+      S("completion", { conversationId: s }), await h({
         eventName: "assistant_message_received",
         properties: {
-          conversationId: n
+          conversationId: s
         }
-      }), r({
+      }), h({
         eventName: "assistant_answer_displayed",
         properties: {
-          conversationId: n
+          conversationId: s
         }
       });
     },
     onError(e) {
-      console.log("onError", e.message), r({
+      console.error("onError", { code: e.code, message: e.message });
+      const t = q || m ? null : Ye(e);
+      if (t !== null && f.current < 1) {
+        f.current++;
+        const a = O.current, n = Y.current;
+        (async () => {
+          if (t === "session") {
+            const o = await T();
+            o && (A.current = o);
+          } else
+            c();
+          if (a) {
+            D(a);
+            return;
+          }
+          n && (g((o) => {
+            let r = [...o];
+            return r.at(-1)?.role === "assistant" && (r = r.slice(0, -1)), r.at(-1)?.role === "user" && (r = r.slice(0, -1)), r;
+          }), B({ text: n.content }, { body: n.body }));
+        })().catch(() => {
+          f.current = 0, c(), g((o) => {
+            const r = [...o], z = r[r.length - 1];
+            if (!z) return r;
+            const ce = pe;
+            return z.role === "user" ? r.push({
+              id: W(16),
+              role: "assistant",
+              parts: [{ type: "text", text: ce }]
+            }) : z.parts = [{ type: "text", text: ce }], r;
+          });
+        });
+        return;
+      }
+      f.current = 0, t !== null && c(), h({
         eventName: "chat_error",
         properties: {
-          conversationId: n,
+          conversationId: s,
           error: e.message
         }
-      }), A((l) => {
-        const s = [...l], t = s[s.length - 1];
-        if (t) {
-          const o = U(e);
-          t.role === "user" ? s.push({
+      }), g((a) => {
+        const n = [...a], i = n[n.length - 1];
+        if (i) {
+          const o = Ie(e);
+          i.role === "user" ? n.push({
             id: W(16),
             role: "assistant",
             parts: [{ type: "text", text: o }]
-          }) : t.parts = [{ type: "text", text: o }];
+          }) : i.parts = [{ type: "text", text: o }];
         }
-        return s;
+        return n;
       });
     }
-  }), D = k === "submitted", y = k === "streaming", V = H(() => {
-    const e = (o) => {
-      if (!o || typeof o != "object") return !1;
-      const B = o;
-      return typeof B.type == "string" && B.type.startsWith("tool-");
-    }, s = [...i ?? []].reverse().find((o) => o.role === "assistant");
-    if (!s) return !1;
-    const t = s.parts?.at(-1);
-    return !(!e(t) || t.state !== "output-available" || !t.approval?.id || y);
-  }, [i, y]), N = y || V, T = D || N, Z = i.length === 0, I = !a.trim() || T, X = me("(max-width: 768px)"), [Y, C] = m(null);
-  O(() => {
-    v && C(v);
-  }, [v]);
-  const ee = () => C(null), R = ie(null);
-  O(() => {
-    K?.(a);
-  }, [a]);
-  const te = (e) => {
-    e.key === "Enter" && !e.shiftKey && !I && !e.nativeEvent.isComposing && (e.preventDefault(), b());
-  }, b = async (e = a) => {
-    if (I && (!e || e.trim().length === 0)) return;
-    h([]), u(""), await r({
+  }), re = te === "submitted", H = te === "streaming", Me = le(() => {
+    const e = (i) => {
+      if (!i || typeof i != "object") return !1;
+      const o = i;
+      return typeof o.type == "string" && o.type.startsWith("tool-");
+    }, a = [...w ?? []].reverse().find((i) => i.role === "assistant");
+    if (!a) return !1;
+    const n = a.parts?.at(-1);
+    return !(!e(n) || n.state !== "output-available" || !n.approval?.id || H);
+  }, [w, H]), ne = H || Me, oe = re || ne, Ee = w.length === 0, L = !y.trim() || oe, xe = qe("(max-width: 768px)"), [ke, M] = C(null);
+  ue(() => {
+    P && M(P);
+  }, [P]);
+  const Ne = () => M(null), ae = l(null);
+  ue(() => {
+    ve?.(y);
+  }, [y]);
+  const Te = (e) => {
+    e.key === "Enter" && !e.shiftKey && !L && !e.nativeEvent.isComposing && (e.preventDefault(), U());
+  }, U = async (e = y) => {
+    if (L && (!e || e.trim().length === 0)) return;
+    R([]), k(""), f.current = 0, O.current = null, await h({
       eventName: "user_message_submitted",
       properties: {
-        conversationId: n
+        conversationId: s
       }
     });
-    const l = w || M ? JSON.stringify({
-      ...w,
-      ...M
-    }) : void 0, s = {
-      ...g
-    };
-    l && (s["inkeep-filters"] = l);
-    let t = n;
-    t || (t = `conv_${W(16)}`, E(t)), q(t), F(
+    let t = s;
+    t || (t = `conv_${W(16)}`, p(t)), ge(t), Y.current = {
+      content: e,
+      body: { conversationId: t }
+    }, B(
+      { text: e },
       {
-        text: e
-      },
-      {
-        headers: {
-          ...j(),
-          ...s
-        },
-        body: {
-          conversationId: t,
-          requestContext: f
-        }
+        body: { conversationId: t }
       }
     );
-  }, se = () => {
-    Q().then(() => {
-      p("aborted", { conversationId: n });
+  }, Oe = x(
+    (e) => {
+      f.current = 0, O.current = e, D(e);
+    },
+    [D]
+  ), $ = x(() => {
+    se().then(() => {
+      S("aborted", { conversationId: s });
     });
-  }, P = () => {
-    ee(), A([]), E(""), h([]), _(null), r({
+  }, [se, s, S]), ie = () => {
+    Ne(), g([]), p(""), R([]), F(null), c(), h({
       eventName: "chat_clear_button_clicked",
       properties: {
-        conversationId: n
+        conversationId: s
       }
     });
-  }, { openForm: ne } = ue(), oe = fe();
-  return le(c.chatFunctionsRef, () => ({
-    submitMessage: b,
+  }, E = x(
+    (e, t) => {
+      M(null), g(t), p(e), R([]), F(null), c();
+    },
+    [g, p, c]
+  ), _e = x(
+    async (e, t) => {
+      $(), E(e, []), X(!0);
+      try {
+        const a = await Z(e, t);
+        a !== null && E(e, a);
+      } finally {
+        t?.aborted || X(!1);
+      }
+    },
+    [E, Z, $]
+  ), { openForm: Fe } = Ge(), Be = Qe();
+  return He(u.chatFunctionsRef, () => ({
+    submitMessage: U,
     updateInputMessage(e) {
-      u(e);
+      k(e);
     },
-    clearChat: P,
+    clearChat: ie,
     openForm: (e) => {
-      oe?.setView("chat"), ne(e, void 0);
+      Be?.setView("chat"), Fe(e, void 0);
     },
     focusInput: () => {
-      R.current?.focus();
+      ae.current?.focus();
     }
   })), {
-    messages: i,
-    sendMessage: F,
-    addToolApprovalResponse: J,
-    isLoading: D,
-    isStreaming: N,
-    isBusy: T,
-    error: Y,
-    setError: C,
-    isSubmitDisabled: I,
-    input: a,
-    handleInputChange: z,
-    handleInputKeyDown: te,
-    handleSubmit: b,
-    stop: se,
-    clear: P,
-    isEmpty: i.length === 0,
-    inputRef: R,
-    isMobile: X,
+    messages: w,
+    sendMessage: B,
+    addToolApprovalResponse: Oe,
+    isLoading: re,
+    isStreaming: ne,
+    isBusy: oe,
+    error: ke,
+    setError: M,
+    isSubmitDisabled: L,
+    input: y,
+    handleInputChange: he,
+    handleInputKeyDown: Te,
+    handleSubmit: U,
+    stop: $,
+    clear: ie,
+    inputRef: ae,
+    isMobile: xe,
     // Additional state for attachments and workflow
-    messageAttachments: $,
-    setMessageAttachments: h,
-    selectedWorkflow: L,
-    setSelectedWorkflow: _,
-    isNewChat: Z,
-    conversationId: n
+    messageAttachments: Ae,
+    setMessageAttachments: R,
+    selectedWorkflow: Re,
+    setSelectedWorkflow: F,
+    isNewChat: Ee,
+    conversationId: s,
+    restoreSession: E,
+    loadAndRestoreSession: _e,
+    isSessionLoading: Se,
+    sessionToken: N,
+    refreshSession: T,
+    getCaptchaHeader: b,
+    invalidateCaptcha: c
   };
 };
 export {
-  he as DEFAULT_ERROR_MESSAGE,
-  Fe as useInkeepChat
+  pe as DEFAULT_ERROR_MESSAGE,
+  vt as useInkeepChat
 };

package/dist/primitives/components/embedded-chat/use-stream-processor.cjs

@@ -1 +1 @@
-"use client";"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const n=require("react"),A=require("./use-inkeep-chat.cjs");function E(m,u,S){const[T,d]=n.useState(!1),x=n.useRef(0),C=n.useRef(0),w=n.useRef(Date.now()),c=n.useRef(new Map),h=n.useRef(null),{processedParts:p,summaryTimings:b}=n.useMemo(()=>{const s=[];let e="",o=[],y=!1;m.length>x.current&&(w.current=Date.now(),x.current=m.length),C.current=0;const i=new Map,l=(r=!1)=>{if(o.length>0){const t=`group-${C.current++}`,a=c.current.get(t);a?i.set(t,{...a,isCompleted:r}):i.set(t,{isCompleted:r}),s.push({type:"summary-group",summaries:[...o],groupKey:t}),o=[]}};for(const r of m)if(r.type==="text")l(!0),e+=r.text||"";else if(r.type==="data-summary")e.trim()&&(s.push({type:"text",text:e}),e=""),o.push(r.data);else if(r.type==="data-operation"){e.trim()&&(s.push({type:"text",text:e}),e="");const t=r.data;if(t?.type){if((t.type==="tool_call"||t.type==="tool_result")&&t.details?.data?.inDelegatedAgent===!1)continue;switch(t.type){case"agent_initializing":break;case"completion":{const{type:f}=t;o.push({type:f,label:"Completed"}),l(!0);break}case"error":{const f=t.message||"Unknown error";if(console.warn("Data operation error:",f),!s.length)l(!0),h.current=f,y||(s.push({type:"text",text:A.DEFAULT_ERROR_MESSAGE}),y=!0);else{const{type:g,label:v}=t;o.push({type:g,label:v})}break}default:{const{type:f,label:g}=t;o.push({type:f,label:g});break}}}}else if(r.type==="data-artifact")if(r.data?.type?.toLowerCase()==="citation"){const t=r.data,a=t.artifactSummary||{title:t.name};e+=` ^${a?.title||t.name}^`}else e.trim()&&(s.push({type:"text",text:e}),e=""),s.push(r);else r.type==="data-component"?(e.trim()&&(s.push({type:"text",text:e}),e=""),l(!0),s.push(r)):(e.trim()&&(s.push({type:"text",text:e}),e=""),l(!0),s.push(r));if(l(!u),e.trim()&&s.push({type:"text",text:e}),!u)for(const[r,t]of i.entries())t.isCompleted||i.set(r,{...t,isCompleted:!0});const D=i.size!==c.current.size||Array.from(i.entries()).some(([r,t])=>{const a=c.current.get(r);return!a||a.isCompleted!==t.isCompleted})?i:c.current;return c.current=D,{processedParts:s,summaryTimings:D}},[m,u]);n.useEffect(()=>{h.current&&(S(new Error(h.current)),h.current=null)});const R=n.useCallback(()=>{const s=Date.now()-w.current,e=Array.from(c.current.values()).some(y=>!y.isCompleted),o=s>1e3&&!e;d(o)},[]);n.useEffect(()=>{if(!u){d(!1);return}if(!(p.length>0)){d(!1);return}const e=setInterval(R,200);return()=>clearInterval(e)},[u,R,p.length]);const k=n.useMemo(()=>!!(!(p.length>0)&&u),[p.length,u]);return{processedParts:p,summaryTimings:b,shouldShowInitialLoading:k,shouldShowStreamDelayLoading:T}}exports.useStreamProcessor=E;
+"use client";"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const l=require("react"),O=require("./use-inkeep-chat.cjs");function R(a,n){if(n)return a.findIndex(h=>h.type==="tool_call"&&h.toolCallId===n);const d=a.length-1;return d>=0&&a[d].type==="tool_call"?d:-1}function G(a){const n=a.ctx,h=a.details?.data,y=n?.toolCallId??n?.callId??a.toolCallId??h?.toolCallId;return typeof y=="string"?y:void 0}function q(a,n,d){const[h,y]=l.useState(!1),D=l.useRef(0),v=l.useRef(0),A=l.useRef(Date.now()),g=l.useRef(new Map),k=l.useRef(null),{processedParts:b,summaryTimings:P}=l.useMemo(()=>{const r=[];let t="",o=[],w=!1;a.length>D.current&&(A.current=Date.now(),D.current=a.length),v.current=0;const f=new Map,x=(s=!1)=>{if(o.length>0){const e=`group-${v.current++}`,u=g.current.get(e);u?f.set(e,{...u,isCompleted:s}):f.set(e,{isCompleted:s}),r.push({type:"summary-group",summaries:[...o],groupKey:e}),o=[]}};for(const s of a)if(s.type==="text")x(!0),t+=s.text||"";else if(s.type==="data-summary")t.trim()&&(r.push({type:"text",text:t}),t=""),o.push(s.data);else if(s.type==="data-operation"){t.trim()&&(r.push({type:"text",text:t}),t="");const e=s.data;if(e?.type){if((e.type==="tool_call"||e.type==="tool_result")&&e.details?.data?.inDelegatedAgent===!1)continue;switch(e.type){case"agent_initializing":break;case"completion":{const{type:i}=e;o.push({type:i,label:"Completed"}),x(!0);break}case"error":{const i=e.message||"Unknown error";if(console.warn("Data operation error:",i),!r.length)x(!0),k.current=i,w||(r.push({type:"text",text:O.DEFAULT_ERROR_MESSAGE}),w=!0);else{const{type:p,label:c}=e;o.push({type:p,label:c})}break}case"tool_call":{const{type:i,label:p}=e,c=G(e);o.push({type:i,label:p,...c&&{toolCallId:c}});break}case"tool_result":{const{type:i,label:p}=e,c=G(e),S={type:i,label:p},M=R(o,c);if(M>=0){o[M]=S;break}const T=r.filter(I=>I?.type==="summary-group");if(c){let I=!1;for(let m=T.length-1;m>=0;m--){const C=T[m].summaries;if(C?.length){const L=R(C,c);if(L>=0){C[L]=S,I=!0;break}}}if(I)break}else{const m=T[T.length-1]?.summaries;if(m?.length){const C=R(m,void 0);if(C>=0){m[C]=S;break}}}o.push(S);break}default:{const{type:i,label:p}=e;o.push({type:i,label:p});break}}}}else if(s.type==="data-artifact")if(s.data?.type?.toLowerCase()==="citation"){const e=s.data,u=e.artifactSummary||{title:e.name};t+=` ^${u?.title||e.name}^`}else t.trim()&&(r.push({type:"text",text:t}),t=""),r.push(s);else s.type==="data-component"?(t.trim()&&(r.push({type:"text",text:t}),t=""),x(!0),r.push(s)):(t.trim()&&(r.push({type:"text",text:t}),t=""),x(!0),r.push(s));if(x(!n),t.trim()&&r.push({type:"text",text:t}),!n)for(const[s,e]of f.entries())e.isCompleted||f.set(s,{...e,isCompleted:!0});const _=f.size!==g.current.size||Array.from(f.entries()).some(([s,e])=>{const u=g.current.get(s);return!u||u.isCompleted!==e.isCompleted})?f:g.current;return g.current=_,{processedParts:r,summaryTimings:_}},[a,n]);l.useEffect(()=>{k.current&&(d(new Error(k.current)),k.current=null)});const E=l.useCallback(()=>{const r=Date.now()-A.current,t=Array.from(g.current.values()).some(w=>!w.isCompleted),o=r>1e3&&!t;y(o)},[]);l.useEffect(()=>{if(!n){y(!1);return}if(!(b.length>0)){y(!1);return}const t=setInterval(E,200);return()=>clearInterval(t)},[n,E,b.length]);const z=l.useMemo(()=>!!(!(b.length>0)&&n),[b.length,n]);return{processedParts:b,summaryTimings:P,shouldShowInitialLoading:z,shouldShowStreamDelayLoading:h}}exports.useStreamProcessor=q;

package/dist/primitives/components/embedded-chat/use-stream-processor.d.ts

@@ -6,6 +6,8 @@ interface DataSummary {
     type: string;
     label?: string;
     details?: Record<string, unknown>;
+    /** Used to match tool_result to tool_call when they're in different groups (e.g. approval in between) or parallel */
+    toolCallId?: string;
 }
 interface TextPart {
     type: 'text';