@inkeep/agents-ui 0.17.5 → 0.17.7

package/dist/primitives/components/embedded-chat/chat-error-helpers.cjs

@@ -1,3 +1,3 @@
-"use client";"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const n=require("../../hooks/use-inkeep-api-client.cjs");function s(t){const e=Number(t.code)||Number(t.statusCode);if(e&&!Number.isNaN(e))return e;try{const r=Number(JSON.parse(t.message??"").status);return r&&!Number.isNaN(r)?r:null}catch{return null}}function o(t){const e=s(t),r=n.parseAuthError(e??0,{detail:t.message??""});return r!==null?r:e===401?"session":e===403?"captcha":null}function a(t){const e=s(t);return e===400||e===429}const u=`Hmm.. 
+"use client";"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const o=require("../../hooks/use-inkeep-api-client.cjs");function n(t){const e=Number(t.code)||Number(t.statusCode);if(e&&!Number.isNaN(e))return e;try{const r=Number(JSON.parse(t.message??"").status);return r&&!Number.isNaN(r)?r:null}catch{return null}}function E(t){const e=n(t),r=o.parseAuthError(e??0,{detail:t.message??""});return r!==null?r:e===401?"session":e===403?"captcha":null}function a(t){const e=n(t);return e===400||e===413||e===429}function i(t){if(n(t)!==null)return!1;const e=(t.message??"").toLowerCase();return e.includes("failed to fetch")||e.includes("load failed")||e.includes("networkerror")||e.includes("network request failed")}const u="Something went wrong sending your message. Check your connection and try again.",c="Your message could not be sent. If you attached large files, try removing one. Otherwise, check your connection and try again.",_=`Hmm.. 
 
-It seems I might be having some issues right now. Please clear the chat and try again.`,i="Please try again.",E="You're sending requests too quickly. Please wait a moment and try again.",c=8e3;exports.DEFAULT_ERROR_MESSAGE=u;exports.RATE_LIMIT_MESSAGE=E;exports.RECOVERABLE_FALLBACK_MESSAGE=i;exports.RECOVERABLE_NOTIFICATION_DURATION_MS=c;exports.isRecoverableError=a;exports.resolveHttpStatusCode=s;exports.resolveStreamingAuthError=o;
+It seems I might be having some issues right now. Please clear the chat and try again.`,l="Please try again.",R="You're sending requests too quickly. Please wait a moment and try again.",A="Your message or attachments are too large. Remove a file or shorten your message and try again.",S=43e5,s=4/3;function d(t){return new TextEncoder().encode(t.text).length+Math.ceil(t.rawFileBytes*s)+t.encodedPartsBytes}const O=8e3;exports.BASE64_SIZE_FACTOR=s;exports.DEFAULT_ERROR_MESSAGE=_;exports.MAX_REQUEST_BODY_BYTES=S;exports.NETWORK_ERROR_MESSAGE=u;exports.NETWORK_ERROR_WITH_FILES_MESSAGE=c;exports.PAYLOAD_TOO_LARGE_MESSAGE=A;exports.RATE_LIMIT_MESSAGE=R;exports.RECOVERABLE_FALLBACK_MESSAGE=l;exports.RECOVERABLE_NOTIFICATION_DURATION_MS=O;exports.estimateRequestBodyBytes=d;exports.isNetworkError=i;exports.isRecoverableError=a;exports.resolveHttpStatusCode=n;exports.resolveStreamingAuthError=E;

package/dist/primitives/components/embedded-chat/chat-error-helpers.d.ts

@@ -18,10 +18,47 @@ export declare function resolveStreamingAuthError(error: Error): 'captcha' | 'se
  * Recoverable errors are input-validation failures where the user can fix
  * their input and retry without clearing the conversation.
  *
+ * 413 (payload too large) is recoverable: the conversation is intact and the
+ * user can remove an attachment or shorten their message and resend.
+ *
  * Allowlist approach: unknown/unparseable errors default to non-recoverable (blocking).
  */
 export declare function isRecoverableError(error: Error): boolean;
+/**
+ * Detects an opaque transport failure that arrived with no readable HTTP status —
+ * the fetch rejected before (or without) a usable response.
+ *
+ * The most common production cause is a platform-level 413: Vercel rejects any
+ * request body over ~4.5MB at the edge (base64-encoded file attachments inflate
+ * ~33%, so this is easy to hit), and that platform 413 carries no CORS headers
+ * because the app's cors() middleware never runs on it. The browser therefore
+ * blocks JS from reading the response and surfaces `TypeError: Failed to fetch`
+ * with no status. Genuine offline/DNS failures land here too — in both cases the
+ * conversation is intact and the user should get a non-blocking retry prompt.
+ *
+ * Matched on message signature (not error.name) so we don't swallow genuine
+ * programming TypeErrors as recoverable network failures.
+ */
+export declare function isNetworkError(error: Error): boolean;
+export declare const NETWORK_ERROR_MESSAGE = "Something went wrong sending your message. Check your connection and try again.";
+export declare const NETWORK_ERROR_WITH_FILES_MESSAGE = "Your message could not be sent. If you attached large files, try removing one. Otherwise, check your connection and try again.";
 export declare const DEFAULT_ERROR_MESSAGE = "Hmm.. \n\nIt seems I might be having some issues right now. Please clear the chat and try again.";
 export declare const RECOVERABLE_FALLBACK_MESSAGE = "Please try again.";
 export declare const RATE_LIMIT_MESSAGE = "You're sending requests too quickly. Please wait a moment and try again.";
+export declare const PAYLOAD_TOO_LARGE_MESSAGE = "Your message or attachments are too large. Remove a file or shorten your message and try again.";
+export declare const MAX_REQUEST_BODY_BYTES = 4300000;
+export declare const BASE64_SIZE_FACTOR: number;
+/**
+ * Estimates the encoded byte size of the outgoing chat request body. Only the latest
+ * message is ever sent (the backend tracks history via conversationId), so file
+ * attachments in the current turn dominate — conversation history is irrelevant here.
+ */
+export declare function estimateRequestBodyBytes(input: {
+    /** Message text. */
+    text: string;
+    /** Sum of `File.size` for freshly attached files (raw, pre-base64). */
+    rawFileBytes: number;
+    /** Sum of `.url.length` for already-encoded FileUIParts (data URLs). */
+    encodedPartsBytes: number;
+}): number;
 export declare const RECOVERABLE_NOTIFICATION_DURATION_MS = 8000;

package/dist/primitives/components/embedded-chat/chat-error-helpers.js

@@ -1,32 +1,51 @@
 "use client";
 import { parseAuthError as r } from "../../hooks/use-inkeep-api-client.js";
-function n(t) {
+function s(t) {
   const e = Number(t.code) || Number(t.statusCode);
   if (e && !Number.isNaN(e)) return e;
   try {
-    const s = Number(JSON.parse(t.message ?? "").status);
-    return s && !Number.isNaN(s) ? s : null;
+    const n = Number(JSON.parse(t.message ?? "").status);
+    return n && !Number.isNaN(n) ? n : null;
   } catch {
     return null;
   }
 }
-function o(t) {
-  const e = n(t), s = r(e ?? 0, { detail: t.message ?? "" });
-  return s !== null ? s : e === 401 ? "session" : e === 403 ? "captcha" : null;
+function c(t) {
+  const e = s(t), n = r(e ?? 0, { detail: t.message ?? "" });
+  return n !== null ? n : e === 401 ? "session" : e === 403 ? "captcha" : null;
+}
+function i(t) {
+  const e = s(t);
+  return e === 400 || e === 413 || e === 429;
 }
 function u(t) {
-  const e = n(t);
-  return e === 400 || e === 429;
+  if (s(t) !== null) return !1;
+  const e = (t.message ?? "").toLowerCase();
+  return e.includes("failed to fetch") || // Chromium
+  e.includes("load failed") || // Safari
+  e.includes("networkerror") || // Firefox
+  e.includes("network request failed");
 }
-const i = `Hmm.. 
+const l = "Something went wrong sending your message. Check your connection and try again.", E = "Your message could not be sent. If you attached large files, try removing one. Otherwise, check your connection and try again.", d = `Hmm.. 
 
-It seems I might be having some issues right now. Please clear the chat and try again.`, c = "Please try again.", l = "You're sending requests too quickly. Please wait a moment and try again.", m = 8e3;
+It seems I might be having some issues right now. Please clear the chat and try again.`, m = "Please try again.", g = "You're sending requests too quickly. Please wait a moment and try again.", R = "Your message or attachments are too large. Remove a file or shorten your message and try again.", _ = 43e5, o = 4 / 3;
+function A(t) {
+  return new TextEncoder().encode(t.text).length + Math.ceil(t.rawFileBytes * o) + t.encodedPartsBytes;
+}
+const S = 8e3;
 export {
-  i as DEFAULT_ERROR_MESSAGE,
-  l as RATE_LIMIT_MESSAGE,
-  c as RECOVERABLE_FALLBACK_MESSAGE,
-  m as RECOVERABLE_NOTIFICATION_DURATION_MS,
-  u as isRecoverableError,
-  n as resolveHttpStatusCode,
-  o as resolveStreamingAuthError
+  o as BASE64_SIZE_FACTOR,
+  d as DEFAULT_ERROR_MESSAGE,
+  _ as MAX_REQUEST_BODY_BYTES,
+  l as NETWORK_ERROR_MESSAGE,
+  E as NETWORK_ERROR_WITH_FILES_MESSAGE,
+  R as PAYLOAD_TOO_LARGE_MESSAGE,
+  g as RATE_LIMIT_MESSAGE,
+  m as RECOVERABLE_FALLBACK_MESSAGE,
+  S as RECOVERABLE_NOTIFICATION_DURATION_MS,
+  A as estimateRequestBodyBytes,
+  u as isNetworkError,
+  i as isRecoverableError,
+  s as resolveHttpStatusCode,
+  c as resolveStreamingAuthError
 };

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

@@ -1,2 +1,2 @@
-"use client";"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const Ze=require("@ai-sdk/react"),Xe=require("./file-upload-input.cjs"),Ye=require("ai"),t=require("react"),et=require("../../providers/config-provider.cjs"),tt=require("../../providers/chat-auth-provider.cjs"),st=require("../../hooks/use-media-query.cjs"),rt=require("../../hooks/use-conversation-loader.cjs"),nt=require("../../hooks/use-initial-conversation.cjs"),k=require("../../utils/generate-uid.cjs"),at=require("../../providers/base-events-provider.cjs"),ot=require("../../providers/chat-form-provider.cjs"),it=require("../../providers/widget-provider.cjs"),ct=require("@radix-ui/react-use-controllable-state"),ut=require("../../hooks/use-streaming-events.cjs"),lt=require("../../hooks/use-input-notification.cjs"),p=require("./chat-error-helpers.cjs"),dt=()=>{const{baseSettings:se,aiChatSettings:E}=et.useInkeepConfig(),[c="",m]=ct.useControllableState({prop:E.conversationIdOverride,defaultProp:E.conversationIdOverride??""}),{logEvent:h}=at.useBaseEvents(),{setConversationId:ke,emitToParent:F}=ut.useStreamingEvents(),re=t.useRef(c);t.useEffect(()=>{const e=re.current;re.current=c,e!==c&&h({eventName:"chat_conversation_changed",properties:{conversationId:c,previousConversationId:e}})},[c,h]);const[S,C]=t.useState(""),Fe=e=>C(e.target.value),{shouldBypassCaptcha:_e,filters:ne,userProperties:N,analyticsProperties:O}=se,{authToken:ae,isAuthenticated:v,isAuthConfigured:oe,refreshAuthToken:ie,sessionToken:ce,refreshSession:ue,getCaptchaHeader:_,invalidateCaptcha:d,effectiveAuthToken:le,applicableRefreshSession:Pe}=tt.useChatAuth(),{onInputMessageChange:xe,filters:de,baseUrl:pe,agentUrl:qe,context:fe,headers:ge,appId:P,apiKey:U,files:I}=E,he=t.useRef(_);he.current=_;const me=qe||`${pe}/run/api/chat`,{loadConversation:ve}=rt.useConversationLoader({baseUrl:pe,appId:P,authToken:le,getCaptchaHeader:_,invalidateCaptcha:d,refreshSession:Pe}),[Le,ye]=t.useState(!1),D=t.useRef(null);D.current=ce;const $=t.useRef(null);$.current=ae;const B=t.useRef(void 0);B.current=N&&Object.keys(N).length>0?N:void 0;const G=t.useRef(void 0);G.current=O&&Object.keys(O).length>0?O:void 0;const y=t.useRef(0),H=t.useRef(null),K=t.useRef(null),R=t.useRef(void 0),Ne=I?.map(e=>`${e.filename??""}:${e.mediaType}:${e.url.length}:${e.url.slice(0,64)}:${e.url.slice(-32)}`).join(`
-`)??"";t.useEffect(()=>{R.current=I?.length?I:void 0},[Ne]);const Re=t.useRef(ge);Re.current=ge;const z=t.useRef(void 0);z.current=ne||de?JSON.stringify({...ne,...de}):void 0;const Oe=e=>{switch(p.resolveHttpStatusCode(e)){case 400:try{const s=JSON.parse(e.message??"");return s.detail??s.error?.message??p.RECOVERABLE_FALLBACK_MESSAGE}catch{return e.message?.trim()||p.RECOVERABLE_FALLBACK_MESSAGE}case 401:return oe?"Authentication failed. Please try again.":p.DEFAULT_ERROR_MESSAGE;case 403:return`There seems to be a configuration error. Please contact ${se.organizationDisplayName??"Administrator"}`;case 429:return p.RATE_LIMIT_MESSAGE;default:return p.DEFAULT_ERROR_MESSAGE}},[A,j]=t.useState([]),Ue=t.useMemo(()=>new Ye.DefaultChatTransport({api:me,headers:()=>{const e=U??$.current??D.current;return{"x-inkeep-client-timezone":Intl.DateTimeFormat().resolvedOptions().timeZone,"x-inkeep-client-timestamp":new Date().toISOString(),"x-inkeep-invocation-type":"chat_widget",...P?{"x-inkeep-app-id":P}:{},...e?{Authorization:`Bearer ${e}`}:{},...z.current?{"inkeep-filters":z.current}:{},...Re.current}},prepareSendMessagesRequest:async e=>{const a=await he.current(),s=e.messages[e.messages.length-1];return s||console.warn("[useInkeepChat] prepareSendMessagesRequest called with empty messages array"),{body:{...e.body,id:e.id,messages:s?[s]:[],trigger:e.trigger,messageId:e.messageId,...B.current?{userProperties:B.current}:{},...G.current?{properties:G.current}:{}},headers:{...e.headers,...a}}},body:{requestContext:fe}}),[me,fe,P,U]),{messages:b,sendMessage:V,addToolApprovalResponse:J,status:Ee,setMessages:f,stop:x,error:q}=Ze.useChat({transport:Ue,onData(e){F(e.type,e.data)},async onFinish({message:e}){F("completion",{conversationId:c}),await h({eventName:"assistant_message_received",properties:{conversationId:c,messageId:e.id}}),h({eventName:"assistant_answer_displayed",properties:{conversationId:c,messageId:e.id}})},onError(e){console.error("onError",{code:e.code,message:e.message});const a=_e||U?null:p.resolveStreamingAuthError(e);if(a!==null&&y.current<1){y.current++;const n=K.current,r=H.current;(async()=>{if(a==="session"&&oe){const l=await ie();if(!l)throw new Error("Auth token refresh failed");$.current=l}else if(a==="session"){const l=await ue();l&&(D.current=l)}else d();if(n){J(n);return}r&&(f(l=>{let o=[...l];return o.at(-1)?.role==="assistant"&&(o=o.slice(0,-1)),o.at(-1)?.role==="user"&&(o=o.slice(0,-1)),o}),V({id:r.messageId,parts:[...r.content.trim()?[{type:"text",text:r.content}]:[],...r.files??[]]},{body:r.body}))})().catch(()=>{y.current=0,d(),f(l=>{const o=[...l],g=o[o.length-1];if(!g)return o;const L=p.DEFAULT_ERROR_MESSAGE;return g.role==="user"?o.push({id:k.generateUid(16),role:"assistant",parts:[{type:"text",text:L}]}):g.parts=[{type:"text",text:L}],o})});return}y.current=0,a!==null&&d();const s=p.isRecoverableError(e),u=Oe(e);if(h({eventName:"chat_error",properties:{conversationId:c,messageId:b.at(-1)?.id,error:e.message}}),s){Y({title:"Request failed",message:u},p.RECOVERABLE_NOTIFICATION_DURATION_MS),f(r=>{let i=[...r];return i.at(-1)?.role==="assistant"&&(i=i.slice(0,-1)),i.at(-1)?.role==="user"&&(i=i.slice(0,-1)),i});const n=H.current?.content;n&&C(n),X.current=e;return}f(n=>{const r=[...n],i=r[r.length-1];return i&&(i.role==="user"?r.push({id:k.generateUid(16),role:"assistant",parts:[{type:"text",text:u}]}):i.parts=[{type:"text",text:u}]),r})}}),Se=t.useRef(v);t.useEffect(()=>{const e=Se.current;Se.current=v,e!==v&&(x(),w(null),f([]),m(""),C(""),j([]),d())},[v,x,f,m,d]);const Ce=Ee==="submitted",Q=Ee==="streaming",De=t.useMemo(()=>{const e=n=>{if(!n||typeof n!="object")return!1;const r=n;return typeof r.type=="string"&&r.type.startsWith("tool-")},s=[...b??[]].reverse().find(n=>n.role==="assistant");if(!s)return!1;const u=s.parts?.at(-1);return!(!e(u)||u.state!=="output-available"||!u.approval?.id||Q)},[b,Q]),[$e,W]=t.useState(!1),Ie=Q||De&&!$e,Ae=Ce||Ie,Be=b.length===0,Z=!S.trim()&&A.length===0||Ae,Ge=st.useMediaQuery("(max-width: 768px)"),[He,w]=t.useState(null),X=t.useRef(null);t.useEffect(()=>{if(q){if(X.current===q){X.current=null;return}w(q)}},[q]);const Ke=()=>w(null),{inputNotification:ze,showInputNotification:Y,clearInputNotification:je}=lt.useInputNotification(),be=t.useRef(null);t.useEffect(()=>{xe?.(S)},[S]);const Ve=e=>{e.key==="Enter"&&!e.shiftKey&&!Z&&!e.nativeEvent.isComposing&&(e.preventDefault(),ee())},ee=async(e=S)=>{if(Z&&(!e||e.trim().length===0)&&A.length===0||!e.trim()&&!A.length&&!R.current?.length)return;const a=A;j([]),C(""),y.current=0,K.current=null,W(!1);let s=c;s||(s=`conv_${k.generateUid(16)}`,m(s));const u=k.generateUid(21);ke(s),await h({eventName:"user_message_submitted",properties:{conversationId:s,messageId:u}});const n=R.current;R.current=void 0;let r=[];if(a.length>0)try{r=await Promise.all(a.map(o=>{const g=Xe.normalizeFileType(o);return new Promise((L,Te)=>{const T=new FileReader;T.onload=()=>{if(typeof T.result!="string"){Te(new Error(`Failed to read file "${g.name}"`));return}L({type:"file",url:T.result,mediaType:g.type,filename:g.name})},T.onerror=()=>Te(new Error(`Failed to read file "${g.name}"`)),T.readAsDataURL(g)})}))}catch{Y({title:"Failed to attach files",message:"Could not read one or more files. Please try again."});return}const i=r.length||n?.length?[...r,...n??[]]:void 0,l=[...e.trim()?[{type:"text",text:e}]:[],...i??[]];H.current={content:e,messageId:u,body:{conversationId:s},files:i},V({id:u,parts:l},{body:{conversationId:s}})},Je=t.useCallback(e=>{y.current=0,K.current=e,W(!1),J(e)},[J]),te=t.useCallback(()=>{W(!0),x().then(()=>{F("aborted",{conversationId:c})})},[x,c,F]),we=()=>{Ke(),f([]),m(""),d(),R.current=I?.length?I:void 0,h({eventName:"chat_clear_button_clicked",properties:{conversationId:c}})},M=t.useCallback((e,a)=>{w(null),f(a),m(e),d(),R.current=void 0},[f,m,d]),Me=t.useCallback(async(e,a)=>{te(),M(e,[]),ye(!0);try{const s=await ve(e,a);if(s===null)return!1;const n=s[s.length-1]?.role==="user"?[...s,{id:k.generateUid(16),role:"assistant",parts:[{type:"text",text:"This session was interrupted. Please check back in a few minutes or start a new conversation."}]}]:s;return M(e,n),!0}finally{a?.aborted||ye(!1)}},[M,ve,te]);nt.useInitialConversation({conversationId:E.conversationId,effectiveAuthToken:le,loadAndRestoreSession:Me,onLoadFailed:()=>M("",[])});const{openForm:Qe}=ot.useChatForm(),We=it.useWidget();return t.useImperativeHandle(E.chatFunctionsRef,()=>({submitMessage:ee,updateInputMessage(e){C(e)},clearChat:we,openForm:e=>{We?.setView("chat"),Qe(e,void 0)},focusInput:()=>{be.current?.focus()}})),{messages:b,sendMessage:V,addToolApprovalResponse:Je,isLoading:Ce,isStreaming:Ie,isBusy:Ae,error:He,setError:w,isSubmitDisabled:Z,input:S,handleInputChange:Fe,handleInputKeyDown:Ve,handleSubmit:ee,stop:te,clear:we,inputRef:be,isMobile:Ge,files:A,setFiles:j,isNewChat:Be,conversationId:c,restoreSession:M,loadAndRestoreSession:Me,isSessionLoading:Le,authToken:v?ae:ce,refreshSession:v?ie:ue,getCaptchaHeader:_,invalidateCaptcha:d,inputNotification:ze,showInputNotification:Y,clearInputNotification:je}};exports.useInkeepChat=dt;
+"use client";"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const Xe=require("@ai-sdk/react"),Ze=require("./file-upload-input.cjs"),et=require("ai"),t=require("react"),tt=require("../../providers/config-provider.cjs"),st=require("../../providers/chat-auth-provider.cjs"),rt=require("../../hooks/use-media-query.cjs"),nt=require("../../hooks/use-conversation-loader.cjs"),at=require("../../hooks/use-initial-conversation.cjs"),O=require("../../utils/generate-uid.cjs"),ot=require("../../providers/base-events-provider.cjs"),it=require("../../providers/chat-form-provider.cjs"),ct=require("../../providers/widget-provider.cjs"),ut=require("@radix-ui/react-use-controllable-state"),lt=require("../../hooks/use-streaming-events.cjs"),dt=require("../../hooks/use-input-notification.cjs"),s=require("./chat-error-helpers.cjs"),ft=()=>{const{baseSettings:se,aiChatSettings:R}=tt.useInkeepConfig(),[u="",v]=ut.useControllableState({prop:R.conversationIdOverride,defaultProp:R.conversationIdOverride??""}),{logEvent:m}=ot.useBaseEvents(),{setConversationId:we,emitToParent:k}=lt.useStreamingEvents(),re=t.useRef(u);t.useEffect(()=>{const e=re.current;re.current=u,e!==u&&m({eventName:"chat_conversation_changed",properties:{conversationId:u,previousConversationId:e}})},[u,m]);const[_,C]=t.useState(""),Oe=e=>C(e.target.value),{shouldBypassCaptcha:ke,filters:ne,userProperties:B,analyticsProperties:D}=se,{authToken:ae,isAuthenticated:S,isAuthConfigured:oe,refreshAuthToken:ie,sessionToken:ce,refreshSession:ue,getCaptchaHeader:F,invalidateCaptcha:f,effectiveAuthToken:le,applicableRefreshSession:Fe}=st.useChatAuth(),{onInputMessageChange:Le,filters:de,baseUrl:fe,agentUrl:Ne,context:pe,headers:ge,appId:L,apiKey:U,files:T}=R,he=t.useRef(F);he.current=F;const me=Ne||`${fe}/run/api/chat`,{loadConversation:Ee}=nt.useConversationLoader({baseUrl:fe,appId:L,authToken:le,getCaptchaHeader:F,invalidateCaptcha:f,refreshSession:Fe}),[Pe,Re]=t.useState(!1),G=t.useRef(null);G.current=ce;const $=t.useRef(null);$.current=ae;const K=t.useRef(void 0);K.current=B&&Object.keys(B).length>0?B:void 0;const H=t.useRef(void 0);H.current=D&&Object.keys(D).length>0?D:void 0;const y=t.useRef(0),N=t.useRef(null),W=t.useRef(null),E=t.useRef(void 0),xe=T?.map(e=>`${e.filename??""}:${e.mediaType}:${e.url.length}:${e.url.slice(0,64)}:${e.url.slice(-32)}`).join(`
+`)??"";t.useEffect(()=>{E.current=T?.length?T:void 0},[xe]);const ve=t.useRef(ge);ve.current=ge;const z=t.useRef(void 0);z.current=ne||de?JSON.stringify({...ne,...de}):void 0;const qe=e=>{if(s.isNetworkError(e))return N.current?.files?.length?s.NETWORK_ERROR_WITH_FILES_MESSAGE:s.NETWORK_ERROR_MESSAGE;switch(s.resolveHttpStatusCode(e)){case 400:try{const r=JSON.parse(e.message??"");return r.detail??r.error?.message??s.RECOVERABLE_FALLBACK_MESSAGE}catch{return e.message?.trim()||s.RECOVERABLE_FALLBACK_MESSAGE}case 401:return oe?"Authentication failed. Please try again.":s.DEFAULT_ERROR_MESSAGE;case 403:return`There seems to be a configuration error. Please contact ${se.organizationDisplayName??"Administrator"}`;case 413:return s.PAYLOAD_TOO_LARGE_MESSAGE;case 429:return s.RATE_LIMIT_MESSAGE;default:return s.DEFAULT_ERROR_MESSAGE}},[A,V]=t.useState([]),Be=t.useMemo(()=>new et.DefaultChatTransport({api:me,headers:()=>{const e=U??$.current??G.current;return{"x-inkeep-client-timezone":Intl.DateTimeFormat().resolvedOptions().timeZone,"x-inkeep-client-timestamp":new Date().toISOString(),"x-inkeep-invocation-type":"chat_widget",...L?{"x-inkeep-app-id":L}:{},...e?{Authorization:`Bearer ${e}`}:{},...z.current?{"inkeep-filters":z.current}:{},...ve.current}},prepareSendMessagesRequest:async e=>{const l=await he.current(),r=e.messages[e.messages.length-1];return r||console.warn("[useInkeepChat] prepareSendMessagesRequest called with empty messages array"),{body:{...e.body,id:e.id,messages:r?[r]:[],trigger:e.trigger,messageId:e.messageId,...K.current?{userProperties:K.current}:{},...H.current?{properties:H.current}:{}},headers:{...e.headers,...l}}},body:{requestContext:pe}}),[me,pe,L,U]),{messages:M,sendMessage:Y,addToolApprovalResponse:j,status:Se,setMessages:h,stop:P,error:x}=Xe.useChat({transport:Be,onData(e){k(e.type,e.data)},async onFinish({message:e}){k("completion",{conversationId:u}),await m({eventName:"assistant_message_received",properties:{conversationId:u,messageId:e.id}}),m({eventName:"assistant_answer_displayed",properties:{conversationId:u,messageId:e.id}})},onError(e){console.error("onError",{code:e.code,message:e.message});const l=ke||U?null:s.resolveStreamingAuthError(e);if(l!==null&&y.current<1){y.current++;const i=W.current,a=N.current;(async()=>{if(l==="session"&&oe){const o=await ie();if(!o)throw new Error("Auth token refresh failed");$.current=o}else if(l==="session"){const o=await ue();o&&(G.current=o)}else f();if(i){j(i);return}a&&(h(o=>{let c=[...o];return c.at(-1)?.role==="assistant"&&(c=c.slice(0,-1)),c.at(-1)?.role==="user"&&(c=c.slice(0,-1)),c}),Y({id:a.messageId,parts:[...a.content.trim()?[{type:"text",text:a.content}]:[],...a.files??[]]},{body:a.body}))})().catch(()=>{y.current=0,f(),h(o=>{const c=[...o],g=c[c.length-1];if(!g)return c;const d=s.DEFAULT_ERROR_MESSAGE;return g.role==="user"?c.push({id:O.generateUid(16),role:"assistant",parts:[{type:"text",text:d}]}):g.parts=[{type:"text",text:d}],c})});return}y.current=0,l!==null&&f();const r=s.isRecoverableError(e)||s.isNetworkError(e),n=qe(e);if(m({eventName:"chat_error",properties:{conversationId:u,messageId:M.at(-1)?.id,error:e.message}}),r){const i=n===s.PAYLOAD_TOO_LARGE_MESSAGE?"Message too large":n===s.RATE_LIMIT_MESSAGE?"Rate limit reached":n===s.NETWORK_ERROR_MESSAGE||n===s.NETWORK_ERROR_WITH_FILES_MESSAGE?"Connection error":"Request failed";q({title:i,message:n},s.RECOVERABLE_NOTIFICATION_DURATION_MS),h(p=>{let o=[...p];return o.at(-1)?.role==="assistant"&&(o=o.slice(0,-1)),o.at(-1)?.role==="user"&&(o=o.slice(0,-1)),o});const a=N.current?.content;a&&C(a),Z.current=e;return}h(i=>{const a=[...i],p=a[a.length-1];return p&&(p.role==="user"?a.push({id:O.generateUid(16),role:"assistant",parts:[{type:"text",text:n}]}):p.parts=[{type:"text",text:n}]),a})}}),ye=t.useRef(S);t.useEffect(()=>{const e=ye.current;ye.current=S,e!==S&&(P(),b(null),h([]),v(""),C(""),V([]),f())},[S,P,h,v,f]);const Ae=Se==="submitted",Q=Se==="streaming",De=t.useMemo(()=>{const e=i=>{if(!i||typeof i!="object")return!1;const a=i;return typeof a.type=="string"&&a.type.startsWith("tool-")},r=[...M??[]].reverse().find(i=>i.role==="assistant");if(!r)return!1;const n=r.parts?.at(-1);return!(!e(n)||n.state!=="output-available"||!n.approval?.id||Q)},[M,Q]),[Ue,J]=t.useState(!1),Ie=Q||De&&!Ue,_e=Ae||Ie,Ge=M.length===0,X=!_.trim()&&A.length===0||_e,$e=rt.useMediaQuery("(max-width: 768px)"),[Ke,b]=t.useState(null),Z=t.useRef(null);t.useEffect(()=>{if(x){if(Z.current===x){Z.current=null;return}b(x)}},[x]);const He=()=>b(null),{inputNotification:We,showInputNotification:q,clearInputNotification:ze}=dt.useInputNotification(),Ce=t.useRef(null);t.useEffect(()=>{Le?.(_)},[_]);const Ve=e=>{e.key==="Enter"&&!e.shiftKey&&!X&&!e.nativeEvent.isComposing&&(e.preventDefault(),ee())},ee=async(e=_)=>{if(X&&(!e||e.trim().length===0)&&A.length===0||!e.trim()&&!A.length&&!E.current?.length)return;if(s.estimateRequestBodyBytes({text:e,rawFileBytes:A.reduce((g,d)=>g+d.size,0),encodedPartsBytes:(E.current??[]).reduce((g,d)=>g+d.url.length,0)})>s.MAX_REQUEST_BODY_BYTES){q({title:"Message too large",message:s.PAYLOAD_TOO_LARGE_MESSAGE},s.RECOVERABLE_NOTIFICATION_DURATION_MS);return}const r=A;V([]),C(""),y.current=0,W.current=null,J(!1);let n=u;n||(n=`conv_${O.generateUid(16)}`,v(n));const i=O.generateUid(21);we(n),await m({eventName:"user_message_submitted",properties:{conversationId:n,messageId:i}});const a=E.current;E.current=void 0;let p=[];if(r.length>0)try{p=await Promise.all(r.map(g=>{const d=Ze.normalizeFileType(g);return new Promise((Je,be)=>{const w=new FileReader;w.onload=()=>{if(typeof w.result!="string"){be(new Error(`Failed to read file "${d.name}"`));return}Je({type:"file",url:w.result,mediaType:d.type,filename:d.name})},w.onerror=()=>be(new Error(`Failed to read file "${d.name}"`)),w.readAsDataURL(d)})}))}catch{q({title:"Failed to attach files",message:"Could not read one or more files. Please try again."});return}const o=p.length||a?.length?[...p,...a??[]]:void 0,c=[...e.trim()?[{type:"text",text:e}]:[],...o??[]];N.current={content:e,messageId:i,body:{conversationId:n},files:o},Y({id:i,parts:c},{body:{conversationId:n}})},Ye=t.useCallback(e=>{y.current=0,W.current=e,J(!1),j(e)},[j]),te=t.useCallback(()=>{J(!0),P().then(()=>{k("aborted",{conversationId:u})})},[P,u,k]),Te=()=>{He(),h([]),v(""),f(),E.current=T?.length?T:void 0,m({eventName:"chat_clear_button_clicked",properties:{conversationId:u}})},I=t.useCallback((e,l)=>{b(null),h(l),v(e),f(),E.current=void 0},[h,v,f]),Me=t.useCallback(async(e,l)=>{te(),I(e,[]),Re(!0);try{const r=await Ee(e,l);if(r===null)return!1;const i=r[r.length-1]?.role==="user"?[...r,{id:O.generateUid(16),role:"assistant",parts:[{type:"text",text:"This session was interrupted. Please check back in a few minutes or start a new conversation."}]}]:r;return I(e,i),!0}finally{l?.aborted||Re(!1)}},[I,Ee,te]);at.useInitialConversation({conversationId:R.conversationId,fetchedConversation:R.fetchedConversation,effectiveAuthToken:le,restoreSession:I,loadAndRestoreSession:Me,onLoadFailed:()=>I("",[])});const{openForm:je}=it.useChatForm(),Qe=ct.useWidget();return t.useImperativeHandle(R.chatFunctionsRef,()=>({submitMessage:ee,updateInputMessage(e){C(e)},clearChat:Te,openForm:e=>{Qe?.setView("chat"),je(e,void 0)},focusInput:()=>{Ce.current?.focus()}})),{messages:M,sendMessage:Y,addToolApprovalResponse:Ye,isLoading:Ae,isStreaming:Ie,isBusy:_e,error:Ke,setError:b,isSubmitDisabled:X,input:_,handleInputChange:Oe,handleInputKeyDown:Ve,handleSubmit:ee,stop:te,clear:Te,inputRef:Ce,isMobile:$e,files:A,setFiles:V,isNewChat:Ge,conversationId:u,restoreSession:I,loadAndRestoreSession:Me,isSessionLoading:Pe,authToken:S?ae:ce,refreshSession:S?ie:ue,getCaptchaHeader:F,invalidateCaptcha:f,inputNotification:We,showInputNotification:q,clearInputNotification:ze}};exports.useInkeepChat=ft;

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

@@ -1,113 +1,117 @@
 "use client";
-import { useChat as st } from "@ai-sdk/react";
-import { normalizeFileType as rt } from "./file-upload-input.js";
-import { DefaultChatTransport as nt } from "ai";
-import { useRef as i, useEffect as M, useState as k, useMemo as _e, useCallback as L, useImperativeHandle as ot } from "react";
-import { useInkeepConfig as at } from "../../providers/config-provider.js";
-import { useChatAuth as it } from "../../providers/chat-auth-provider.js";
-import { useMediaQuery as ct } from "../../hooks/use-media-query.js";
-import { useConversationLoader as lt } from "../../hooks/use-conversation-loader.js";
-import { useInitialConversation as ut } from "../../hooks/use-initial-conversation.js";
+import { useChat as lt } from "@ai-sdk/react";
+import { normalizeFileType as ut } from "./file-upload-input.js";
+import { DefaultChatTransport as dt } from "ai";
+import { useRef as i, useEffect as _, useState as k, useMemo as Oe, useCallback as $, useImperativeHandle as pt } from "react";
+import { useInkeepConfig as ft } from "../../providers/config-provider.js";
+import { useChatAuth as mt } from "../../providers/chat-auth-provider.js";
+import { useMediaQuery as gt } from "../../hooks/use-media-query.js";
+import { useConversationLoader as ht } from "../../hooks/use-conversation-loader.js";
+import { useInitialConversation as vt } from "../../hooks/use-initial-conversation.js";
 import { generateUid as F } from "../../utils/generate-uid.js";
-import { useBaseEvents as pt } from "../../providers/base-events-provider.js";
-import { useChatForm as dt } from "../../providers/chat-form-provider.js";
-import { useWidget as ft } from "../../providers/widget-provider.js";
-import { useControllableState as mt } from "@radix-ui/react-use-controllable-state";
-import { useStreamingEvents as gt } from "../../hooks/use-streaming-events.js";
-import { useInputNotification as ht } from "../../hooks/use-input-notification.js";
-import { resolveStreamingAuthError as vt, DEFAULT_ERROR_MESSAGE as ne, isRecoverableError as yt, RECOVERABLE_NOTIFICATION_DURATION_MS as It, resolveHttpStatusCode as Ct, RATE_LIMIT_MESSAGE as Rt, RECOVERABLE_FALLBACK_MESSAGE as Ne } from "./chat-error-helpers.js";
-const Bt = () => {
-  const { baseSettings: oe, aiChatSettings: I } = at(), [c = "", g] = mt({
-    prop: I.conversationIdOverride,
-    defaultProp: I.conversationIdOverride ?? ""
-  }), { logEvent: m } = pt(), { setConversationId: Pe, emitToParent: x } = gt(), ae = i(c);
-  M(() => {
-    const e = ae.current;
-    ae.current = c, e !== c && m({
+import { useBaseEvents as yt } from "../../providers/base-events-provider.js";
+import { useChatForm as Rt } from "../../providers/chat-form-provider.js";
+import { useWidget as Et } from "../../providers/widget-provider.js";
+import { useControllableState as It } from "@radix-ui/react-use-controllable-state";
+import { useStreamingEvents as St } from "../../hooks/use-streaming-events.js";
+import { useInputNotification as Ct } from "../../hooks/use-input-notification.js";
+import { resolveStreamingAuthError as At, DEFAULT_ERROR_MESSAGE as ne, isRecoverableError as Tt, isNetworkError as Ne, RECOVERABLE_NOTIFICATION_DURATION_MS as Pe, PAYLOAD_TOO_LARGE_MESSAGE as oe, RATE_LIMIT_MESSAGE as Be, NETWORK_ERROR_MESSAGE as De, NETWORK_ERROR_WITH_FILES_MESSAGE as Le, resolveHttpStatusCode as wt, RECOVERABLE_FALLBACK_MESSAGE as $e, estimateRequestBodyBytes as bt, MAX_REQUEST_BODY_BYTES as Mt } from "./chat-error-helpers.js";
+const Wt = () => {
+  const { baseSettings: ae, aiChatSettings: v } = ft(), [c = "", y] = It({
+    prop: v.conversationIdOverride,
+    defaultProp: v.conversationIdOverride ?? ""
+  }), { logEvent: g } = yt(), { setConversationId: Ue, emitToParent: x } = St(), ie = i(c);
+  _(() => {
+    const e = ie.current;
+    ie.current = c, e !== c && g({
       eventName: "chat_conversation_changed",
       properties: {
         conversationId: c,
         previousConversationId: e
       }
     });
-  }, [c, m]);
-  const [C, R] = k(""), Oe = (e) => R(e.target.value), {
-    shouldBypassCaptcha: De,
-    filters: ie,
-    userProperties: $,
-    analyticsProperties: B
-  } = oe, {
-    authToken: ce,
-    isAuthenticated: h,
-    isAuthConfigured: le,
-    refreshAuthToken: ue,
+  }, [c, g]);
+  const [C, A] = k(""), Ge = (e) => A(e.target.value), {
+    shouldBypassCaptcha: Ke,
+    filters: ce,
+    userProperties: U,
+    analyticsProperties: G
+  } = ae, {
+    authToken: le,
+    isAuthenticated: R,
+    isAuthConfigured: ue,
+    refreshAuthToken: de,
     sessionToken: pe,
-    refreshSession: de,
-    getCaptchaHeader: _,
-    invalidateCaptcha: p,
-    effectiveAuthToken: fe,
-    applicableRefreshSession: Le
-  } = it(), {
-    onInputMessageChange: $e,
-    filters: me,
-    baseUrl: ge,
-    agentUrl: Be,
-    context: he,
-    headers: ve,
+    refreshSession: fe,
+    getCaptchaHeader: O,
+    invalidateCaptcha: d,
+    effectiveAuthToken: me,
+    applicableRefreshSession: ze
+  } = mt(), {
+    onInputMessageChange: He,
+    filters: ge,
+    baseUrl: he,
+    agentUrl: qe,
+    context: ve,
+    headers: ye,
     appId: N,
-    apiKey: U,
-    files: S
-  } = I, ye = i(_);
-  ye.current = _;
-  const Ie = Be || `${ge}/run/api/chat`, { loadConversation: Ce } = lt({
-    baseUrl: ge,
+    apiKey: K,
+    files: T
+  } = v, Re = i(O);
+  Re.current = O;
+  const Ee = qe || `${he}/run/api/chat`, { loadConversation: Ie } = ht({
+    baseUrl: he,
     appId: N,
-    authToken: fe,
-    getCaptchaHeader: _,
-    invalidateCaptcha: p,
-    refreshSession: Le
-  }), [Ue, Re] = k(!1), z = i(null);
+    authToken: me,
+    getCaptchaHeader: O,
+    invalidateCaptcha: d,
+    refreshSession: ze
+  }), [We, Se] = k(!1), z = i(null);
   z.current = pe;
   const H = i(null);
-  H.current = ce;
-  const K = i(void 0);
-  K.current = $ && Object.keys($).length > 0 ? $ : void 0;
+  H.current = le;
   const q = i(void 0);
-  q.current = B && Object.keys(B).length > 0 ? B : void 0;
-  const v = i(0), j = i(null), G = i(null), y = i(void 0), ze = S?.map(
+  q.current = U && Object.keys(U).length > 0 ? U : void 0;
+  const W = i(void 0);
+  W.current = G && Object.keys(G).length > 0 ? G : void 0;
+  const E = i(0), P = i(null), j = i(null), h = i(void 0), je = T?.map(
     (e) => `${e.filename ?? ""}:${e.mediaType}:${e.url.length}:${e.url.slice(0, 64)}:${e.url.slice(-32)}`
   ).join(`
 `) ?? "";
-  M(() => {
-    y.current = S?.length ? S : void 0;
-  }, [ze]);
-  const Se = i(ve);
-  Se.current = ve;
+  _(() => {
+    h.current = T?.length ? T : void 0;
+  }, [je]);
+  const Ce = i(ye);
+  Ce.current = ye;
   const V = i(void 0);
-  V.current = ie || me ? JSON.stringify({ ...ie, ...me }) : void 0;
-  const He = (e) => {
-    switch (Ct(e)) {
+  V.current = ce || ge ? JSON.stringify({ ...ce, ...ge }) : void 0;
+  const Ve = (e) => {
+    if (Ne(e))
+      return P.current?.files?.length ? Le : De;
+    switch (wt(e)) {
       case 400:
         try {
           const t = JSON.parse(e.message ?? "");
-          return t.detail ?? t.error?.message ?? Ne;
+          return t.detail ?? t.error?.message ?? $e;
         } catch {
-          return e.message?.trim() || Ne;
+          return e.message?.trim() || $e;
         }
       case 401:
-        return le ? "Authentication failed. Please try again." : ne;
+        return ue ? "Authentication failed. Please try again." : ne;
       case 403:
-        return `There seems to be a configuration error. Please contact ${oe.organizationDisplayName ?? "Administrator"}`;
+        return `There seems to be a configuration error. Please contact ${ae.organizationDisplayName ?? "Administrator"}`;
+      case 413:
+        return oe;
       case 429:
-        return Rt;
+        return Be;
       default:
         return ne;
     }
-  }, [w, J] = k([]), Ke = _e(
-    () => new nt({
-      api: Ie,
+  }, [I, Y] = k([]), Ye = Oe(
+    () => new dt({
+      api: Ee,
       headers: () => {
-        const e = U ?? H.current ?? z.current;
+        const e = K ?? H.current ?? z.current;
         return {
           "x-inkeep-client-timezone": Intl.DateTimeFormat().resolvedOptions().timeZone,
           "x-inkeep-client-timestamp": (/* @__PURE__ */ new Date()).toISOString(),
@@ -115,11 +119,11 @@ const Bt = () => {
           ...N ? { "x-inkeep-app-id": N } : {},
           ...e ? { Authorization: `Bearer ${e}` } : {},
           ...V.current ? { "inkeep-filters": V.current } : {},
-          ...Se.current
+          ...Ce.current
         };
       },
       prepareSendMessagesRequest: async (e) => {
-        const n = await ye.current(), t = e.messages[e.messages.length - 1];
+        const l = await Re.current(), t = e.messages[e.messages.length - 1];
         return t || console.warn(
           "[useInkeepChat] prepareSendMessagesRequest called with empty messages array"
         ), {
@@ -129,41 +133,41 @@ const Bt = () => {
             messages: t ? [t] : [],
             trigger: e.trigger,
             messageId: e.messageId,
-            ...K.current ? { userProperties: K.current } : {},
-            ...q.current ? { properties: q.current } : {}
+            ...q.current ? { userProperties: q.current } : {},
+            ...W.current ? { properties: W.current } : {}
           },
           headers: {
             ...e.headers,
-            ...n
+            ...l
           }
         };
       },
       body: {
-        requestContext: he
+        requestContext: ve
       }
     }),
-    [Ie, he, N, U]
+    [Ee, ve, N, K]
   ), {
-    messages: A,
-    sendMessage: W,
+    messages: w,
+    sendMessage: J,
     addToolApprovalResponse: Q,
-    status: we,
-    setMessages: d,
-    stop: P,
-    error: O
-  } = st({
-    transport: Ke,
+    status: Ae,
+    setMessages: m,
+    stop: B,
+    error: D
+  } = lt({
+    transport: Ye,
     onData(e) {
       x(e.type, e.data);
     },
     async onFinish({ message: e }) {
-      x("completion", { conversationId: c }), await m({
+      x("completion", { conversationId: c }), await g({
         eventName: "assistant_message_received",
         properties: {
           conversationId: c,
           messageId: e.id
         }
-      }), m({
+      }), g({
         eventName: "assistant_answer_displayed",
         properties: {
           conversationId: c,
@@ -173,196 +177,210 @@ const Bt = () => {
     },
     onError(e) {
       console.error("onError", { code: e.code, message: e.message });
-      const n = De || U ? null : vt(e);
-      if (n !== null && v.current < 1) {
-        v.current++;
-        const r = G.current, s = j.current;
+      const l = Ke || K ? null : At(e);
+      if (l !== null && E.current < 1) {
+        E.current++;
+        const o = j.current, r = P.current;
         (async () => {
-          if (n === "session" && le) {
-            const u = await ue();
-            if (!u) throw new Error("Auth token refresh failed");
-            H.current = u;
-          } else if (n === "session") {
-            const u = await de();
-            u && (z.current = u);
+          if (l === "session" && ue) {
+            const n = await de();
+            if (!n) throw new Error("Auth token refresh failed");
+            H.current = n;
+          } else if (l === "session") {
+            const n = await fe();
+            n && (z.current = n);
           } else
-            p();
-          if (r) {
-            Q(r);
+            d();
+          if (o) {
+            Q(o);
             return;
           }
-          s && (d((u) => {
-            let o = [...u];
-            return o.at(-1)?.role === "assistant" && (o = o.slice(0, -1)), o.at(-1)?.role === "user" && (o = o.slice(0, -1)), o;
-          }), W(
+          r && (m((n) => {
+            let a = [...n];
+            return a.at(-1)?.role === "assistant" && (a = a.slice(0, -1)), a.at(-1)?.role === "user" && (a = a.slice(0, -1)), a;
+          }), J(
             {
-              id: s.messageId,
+              id: r.messageId,
               parts: [
-                ...s.content.trim() ? [{ type: "text", text: s.content }] : [],
-                ...s.files ?? []
+                ...r.content.trim() ? [{ type: "text", text: r.content }] : [],
+                ...r.files ?? []
               ]
             },
-            { body: s.body }
+            { body: r.body }
           ));
         })().catch(() => {
-          v.current = 0, p(), d((u) => {
-            const o = [...u], f = o[o.length - 1];
-            if (!f) return o;
-            const D = ne;
-            return f.role === "user" ? o.push({
+          E.current = 0, d(), m((n) => {
+            const a = [...n], f = a[a.length - 1];
+            if (!f) return a;
+            const u = ne;
+            return f.role === "user" ? a.push({
               id: F(16),
               role: "assistant",
-              parts: [{ type: "text", text: D }]
-            }) : f.parts = [{ type: "text", text: D }], o;
+              parts: [{ type: "text", text: u }]
+            }) : f.parts = [{ type: "text", text: u }], a;
           });
         });
         return;
       }
-      v.current = 0, n !== null && p();
-      const t = yt(e), l = He(e);
-      if (m({
+      E.current = 0, l !== null && d();
+      const t = Tt(e) || Ne(e), s = Ve(e);
+      if (g({
         eventName: "chat_error",
         properties: {
           conversationId: c,
-          messageId: A.at(-1)?.id,
+          messageId: w.at(-1)?.id,
           error: e.message
         }
       }), t) {
-        te(
-          { title: "Request failed", message: l },
-          It
-        ), d((s) => {
-          let a = [...s];
-          return a.at(-1)?.role === "assistant" && (a = a.slice(0, -1)), a.at(-1)?.role === "user" && (a = a.slice(0, -1)), a;
+        L(
+          { title: s === oe ? "Message too large" : s === Be ? "Rate limit reached" : s === De || s === Le ? "Connection error" : "Request failed", message: s },
+          Pe
+        ), m((p) => {
+          let n = [...p];
+          return n.at(-1)?.role === "assistant" && (n = n.slice(0, -1)), n.at(-1)?.role === "user" && (n = n.slice(0, -1)), n;
         });
-        const r = j.current?.content;
-        r && R(r), ee.current = e;
+        const r = P.current?.content;
+        r && A(r), te.current = e;
         return;
       }
-      d((r) => {
-        const s = [...r], a = s[s.length - 1];
-        return a && (a.role === "user" ? s.push({
+      m((o) => {
+        const r = [...o], p = r[r.length - 1];
+        return p && (p.role === "user" ? r.push({
           id: F(16),
           role: "assistant",
-          parts: [{ type: "text", text: l }]
-        }) : a.parts = [{ type: "text", text: l }]), s;
+          parts: [{ type: "text", text: s }]
+        }) : p.parts = [{ type: "text", text: s }]), r;
       });
     }
-  }), Ae = i(h);
-  M(() => {
-    const e = Ae.current;
-    Ae.current = h, e !== h && (P(), b(null), d([]), g(""), R(""), J([]), p());
-  }, [h, P, d, g, p]);
-  const be = we === "submitted", Z = we === "streaming", qe = _e(() => {
-    const e = (r) => {
-      if (!r || typeof r != "object") return !1;
-      const s = r;
-      return typeof s.type == "string" && s.type.startsWith("tool-");
-    }, t = [...A ?? []].reverse().find((r) => r.role === "assistant");
+  }), Te = i(R);
+  _(() => {
+    const e = Te.current;
+    Te.current = R, e !== R && (B(), b(null), m([]), y(""), A(""), Y([]), d());
+  }, [R, B, m, y, d]);
+  const we = Ae === "submitted", X = Ae === "streaming", Je = Oe(() => {
+    const e = (o) => {
+      if (!o || typeof o != "object") return !1;
+      const r = o;
+      return typeof r.type == "string" && r.type.startsWith("tool-");
+    }, t = [...w ?? []].reverse().find((o) => o.role === "assistant");
     if (!t) return !1;
-    const l = t.parts?.at(-1);
-    return !(!e(l) || l.state !== "output-available" || !l.approval?.id || Z);
-  }, [A, Z]), [je, X] = k(!1), Ee = Z || qe && !je, Te = be || Ee, Ge = A.length === 0, Y = !C.trim() && w.length === 0 || Te, Ve = ct("(max-width: 768px)"), [Je, b] = k(null), ee = i(null);
-  M(() => {
-    if (O) {
-      if (ee.current === O) {
-        ee.current = null;
+    const s = t.parts?.at(-1);
+    return !(!e(s) || s.state !== "output-available" || !s.approval?.id || X);
+  }, [w, X]), [Qe, Z] = k(!1), be = X || Je && !Qe, Me = we || be, Xe = w.length === 0, ee = !C.trim() && I.length === 0 || Me, Ze = gt("(max-width: 768px)"), [et, b] = k(null), te = i(null);
+  _(() => {
+    if (D) {
+      if (te.current === D) {
+        te.current = null;
         return;
       }
-      b(O);
+      b(D);
     }
-  }, [O]);
-  const We = () => b(null), { inputNotification: Qe, showInputNotification: te, clearInputNotification: Ze } = ht(), Me = i(null);
-  M(() => {
-    $e?.(C);
+  }, [D]);
+  const tt = () => b(null), { inputNotification: st, showInputNotification: L, clearInputNotification: rt } = Ct(), _e = i(null);
+  _(() => {
+    He?.(C);
   }, [C]);
-  const Xe = (e) => {
-    e.key === "Enter" && !e.shiftKey && !Y && !e.nativeEvent.isComposing && (e.preventDefault(), se());
+  const nt = (e) => {
+    e.key === "Enter" && !e.shiftKey && !ee && !e.nativeEvent.isComposing && (e.preventDefault(), se());
   }, se = async (e = C) => {
-    if (Y && (!e || e.trim().length === 0) && w.length === 0 || !e.trim() && !w.length && !y.current?.length)
+    if (ee && (!e || e.trim().length === 0) && I.length === 0 || !e.trim() && !I.length && !h.current?.length)
       return;
-    const n = w;
-    J([]), R(""), v.current = 0, G.current = null, X(!1);
-    let t = c;
-    t || (t = `conv_${F(16)}`, g(t));
-    const l = F(21);
-    Pe(t), await m({
+    if (bt({
+      text: e,
+      rawFileBytes: I.reduce((f, u) => f + u.size, 0),
+      encodedPartsBytes: (h.current ?? []).reduce(
+        (f, u) => f + u.url.length,
+        0
+      )
+    }) > Mt) {
+      L(
+        { title: "Message too large", message: oe },
+        Pe
+      );
+      return;
+    }
+    const t = I;
+    Y([]), A(""), E.current = 0, j.current = null, Z(!1);
+    let s = c;
+    s || (s = `conv_${F(16)}`, y(s));
+    const o = F(21);
+    Ue(s), await g({
       eventName: "user_message_submitted",
       properties: {
-        conversationId: t,
-        messageId: l
+        conversationId: s,
+        messageId: o
       }
     });
-    const r = y.current;
-    y.current = void 0;
-    let s = [];
-    if (n.length > 0)
+    const r = h.current;
+    h.current = void 0;
+    let p = [];
+    if (t.length > 0)
       try {
-        s = await Promise.all(
-          n.map((o) => {
-            const f = rt(o);
-            return new Promise((D, xe) => {
-              const T = new FileReader();
-              T.onload = () => {
-                if (typeof T.result != "string") {
-                  xe(new Error(`Failed to read file "${f.name}"`));
+        p = await Promise.all(
+          t.map((f) => {
+            const u = ut(f);
+            return new Promise((ct, xe) => {
+              const M = new FileReader();
+              M.onload = () => {
+                if (typeof M.result != "string") {
+                  xe(new Error(`Failed to read file "${u.name}"`));
                   return;
                 }
-                D({
+                ct({
                   type: "file",
-                  url: T.result,
-                  mediaType: f.type,
-                  filename: f.name
+                  url: M.result,
+                  mediaType: u.type,
+                  filename: u.name
                 });
-              }, T.onerror = () => xe(new Error(`Failed to read file "${f.name}"`)), T.readAsDataURL(f);
+              }, M.onerror = () => xe(new Error(`Failed to read file "${u.name}"`)), M.readAsDataURL(u);
             });
           })
         );
       } catch {
-        te({
+        L({
           title: "Failed to attach files",
           message: "Could not read one or more files. Please try again."
         });
         return;
       }
-    const a = s.length || r?.length ? [...s, ...r ?? []] : void 0, u = [
+    const n = p.length || r?.length ? [...p, ...r ?? []] : void 0, a = [
       ...e.trim() ? [{ type: "text", text: e }] : [],
-      ...a ?? []
+      ...n ?? []
     ];
-    j.current = {
+    P.current = {
       content: e,
-      messageId: l,
-      body: { conversationId: t },
-      files: a
-    }, W({ id: l, parts: u }, { body: { conversationId: t } });
-  }, Ye = L(
+      messageId: o,
+      body: { conversationId: s },
+      files: n
+    }, J({ id: o, parts: a }, { body: { conversationId: s } });
+  }, ot = $(
     (e) => {
-      v.current = 0, G.current = e, X(!1), Q(e);
+      E.current = 0, j.current = e, Z(!1), Q(e);
     },
     [Q]
-  ), re = L(() => {
-    X(!0), P().then(() => {
+  ), re = $(() => {
+    Z(!0), B().then(() => {
       x("aborted", { conversationId: c });
     });
-  }, [P, c, x]), ke = () => {
-    We(), d([]), g(""), p(), y.current = S?.length ? S : void 0, m({
+  }, [B, c, x]), ke = () => {
+    tt(), m([]), y(""), d(), h.current = T?.length ? T : void 0, g({
       eventName: "chat_clear_button_clicked",
       properties: {
         conversationId: c
       }
     });
-  }, E = L(
-    (e, n) => {
-      b(null), d(n), g(e), p(), y.current = void 0;
+  }, S = $(
+    (e, l) => {
+      b(null), m(l), y(e), d(), h.current = void 0;
     },
-    [d, g, p]
-  ), Fe = L(
-    async (e, n) => {
-      re(), E(e, []), Re(!0);
+    [m, y, d]
+  ), Fe = $(
+    async (e, l) => {
+      re(), S(e, []), Se(!0);
       try {
-        const t = await Ce(e, n);
+        const t = await Ie(e, l);
         if (t === null) return !1;
-        const r = t[t.length - 1]?.role === "user" ? [
+        const o = t[t.length - 1]?.role === "user" ? [
           ...t,
           {
             id: F(16),
@@ -375,66 +393,68 @@ const Bt = () => {
             ]
           }
         ] : t;
-        return E(e, r), !0;
+        return S(e, o), !0;
       } finally {
-        n?.aborted || Re(!1);
+        l?.aborted || Se(!1);
       }
     },
-    [E, Ce, re]
+    [S, Ie, re]
   );
-  ut({
-    conversationId: I.conversationId,
-    effectiveAuthToken: fe,
+  vt({
+    conversationId: v.conversationId,
+    fetchedConversation: v.fetchedConversation,
+    effectiveAuthToken: me,
+    restoreSession: S,
     loadAndRestoreSession: Fe,
-    onLoadFailed: () => E("", [])
+    onLoadFailed: () => S("", [])
   });
-  const { openForm: et } = dt(), tt = ft();
-  return ot(I.chatFunctionsRef, () => ({
+  const { openForm: at } = Rt(), it = Et();
+  return pt(v.chatFunctionsRef, () => ({
     submitMessage: se,
     updateInputMessage(e) {
-      R(e);
+      A(e);
     },
     clearChat: ke,
     openForm: (e) => {
-      tt?.setView("chat"), et(e, void 0);
+      it?.setView("chat"), at(e, void 0);
     },
     focusInput: () => {
-      Me.current?.focus();
+      _e.current?.focus();
     }
   })), {
-    messages: A,
-    sendMessage: W,
-    addToolApprovalResponse: Ye,
-    isLoading: be,
-    isStreaming: Ee,
-    isBusy: Te,
-    error: Je,
+    messages: w,
+    sendMessage: J,
+    addToolApprovalResponse: ot,
+    isLoading: we,
+    isStreaming: be,
+    isBusy: Me,
+    error: et,
     setError: b,
-    isSubmitDisabled: Y,
+    isSubmitDisabled: ee,
     input: C,
-    handleInputChange: Oe,
-    handleInputKeyDown: Xe,
+    handleInputChange: Ge,
+    handleInputKeyDown: nt,
     handleSubmit: se,
     stop: re,
     clear: ke,
-    inputRef: Me,
-    isMobile: Ve,
-    files: w,
-    setFiles: J,
-    isNewChat: Ge,
+    inputRef: _e,
+    isMobile: Ze,
+    files: I,
+    setFiles: Y,
+    isNewChat: Xe,
     conversationId: c,
-    restoreSession: E,
+    restoreSession: S,
     loadAndRestoreSession: Fe,
-    isSessionLoading: Ue,
-    authToken: h ? ce : pe,
-    refreshSession: h ? ue : de,
-    getCaptchaHeader: _,
-    invalidateCaptcha: p,
-    inputNotification: Qe,
-    showInputNotification: te,
-    clearInputNotification: Ze
+    isSessionLoading: We,
+    authToken: R ? le : pe,
+    refreshSession: R ? de : fe,
+    getCaptchaHeader: O,
+    invalidateCaptcha: d,
+    inputNotification: st,
+    showInputNotification: L,
+    clearInputNotification: rt
   };
 };
 export {
-  Bt as useInkeepChat
+  Wt as useInkeepChat
 };

package/dist/primitives/hooks/use-initial-conversation.cjs

@@ -1 +1 @@
-"use client";"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const o=require("react"),f=({conversationId:e,effectiveAuthToken:s,loadAndRestoreSession:u,onLoadFailed:l})=>{const r=o.useRef(null),c=o.useRef(u);c.current=u;const a=o.useRef(l);a.current=l,o.useEffect(()=>{if(!e||!s||r.current===e)return;r.current=e;const t=new AbortController,i=n=>{r.current=null,console.error("[useInitialConversation] failed to load conversation:",e,n),a.current?.()};return(async()=>{try{!await c.current(e,t.signal)&&!t.signal.aborted&&i()}catch(n){t.signal.aborted||i(n)}})(),()=>{r.current=null,t.abort()}},[e,s])};exports.useInitialConversation=f;
+"use client";"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const t=require("react"),d=({conversationId:r,fetchedConversation:n,effectiveAuthToken:s,restoreSession:o,loadAndRestoreSession:c,onLoadFailed:i})=>{const e=t.useRef(null),a=t.useRef(o);a.current=o;const f=t.useRef(c);f.current=c;const R=t.useRef(i);R.current=i,t.useEffect(()=>{if(n&&!r&&console.warn("[useInitialConversation] fetchedConversation was provided without conversationId and will be ignored"),!r||e.current===r)return;if(n){e.current=r,a.current(r,n);return}if(!s)return;e.current=r;const u=new AbortController,b=l=>{e.current=null,console.error("[useInitialConversation] failed to load conversation:",r,l),R.current?.()};return(async()=>{try{!await f.current(r,u.signal)&&!u.signal.aborted&&b()}catch(l){u.signal.aborted||b(l)}})(),()=>{e.current=null,u.abort()}},[r,n,s])};exports.useInitialConversation=d;

package/dist/primitives/hooks/use-initial-conversation.d.ts

@@ -1,8 +1,13 @@
+import { Message } from '../../types/message';
 interface UseInitialConversationOptions {
     /** The conversationId provided via props to load and restore. */
     conversationId: string | undefined;
+    /** Pre-fetched messages — when provided, skips the network fetch entirely. */
+    fetchedConversation: Message[] | undefined;
     /** Resolved auth token — fetch is skipped until one is available. */
     effectiveAuthToken: string | null;
+    /** Restores a session with the given id and messages (no fetch). */
+    restoreSession: (sessionId: string, messages: Message[]) => void;
     /** Returns true if the conversation was loaded successfully, false otherwise. */
     loadAndRestoreSession: (sessionId: string, signal?: AbortSignal) => Promise<boolean>;
     /** Called when the load fails (404 or other error) — use to reset conversation state. */
@@ -10,7 +15,8 @@ interface UseInitialConversationOptions {
 }
 /**
  * Loads and restores a conversation by ID once an auth token is available.
+ * When `fetchedConversation` is provided, seeds the session directly without fetching.
  * Calls `onLoadFailed` if the conversation is not found or the fetch fails.
  */
-export declare const useInitialConversation: ({ conversationId, effectiveAuthToken, loadAndRestoreSession, onLoadFailed, }: UseInitialConversationOptions) => void;
+export declare const useInitialConversation: ({ conversationId, fetchedConversation, effectiveAuthToken, restoreSession, loadAndRestoreSession, onLoadFailed, }: UseInitialConversationOptions) => void;
 export {};

package/dist/primitives/hooks/use-initial-conversation.js

@@ -1,34 +1,45 @@
 "use client";
-import { useRef as o, useEffect as f } from "react";
-const C = ({
+import { useRef as l, useEffect as d } from "react";
+const p = ({
   conversationId: r,
-  effectiveAuthToken: l,
-  loadAndRestoreSession: s,
-  onLoadFailed: c
+  fetchedConversation: e,
+  effectiveAuthToken: o,
+  restoreSession: s,
+  loadAndRestoreSession: c,
+  onLoadFailed: i
 }) => {
-  const t = o(null), u = o(s);
-  u.current = s;
-  const a = o(c);
-  a.current = c, f(() => {
-    if (!r || !l || t.current === r) return;
+  const t = l(null), a = l(s);
+  a.current = s;
+  const f = l(c);
+  f.current = c;
+  const b = l(i);
+  b.current = i, d(() => {
+    if (e && !r && console.warn(
+      "[useInitialConversation] fetchedConversation was provided without conversationId and will be ignored"
+    ), !r || t.current === r) return;
+    if (e) {
+      t.current = r, a.current(r, e);
+      return;
+    }
+    if (!o) return;
     t.current = r;
-    const e = new AbortController(), i = (n) => {
-      t.current = null, console.error("[useInitialConversation] failed to load conversation:", r, n), a.current?.();
+    const n = new AbortController(), w = (u) => {
+      t.current = null, console.error("[useInitialConversation] failed to load conversation:", r, u), b.current?.();
     };
     return (async () => {
       try {
-        !await u.current(
+        !await f.current(
           r,
-          e.signal
-        ) && !e.signal.aborted && i();
-      } catch (n) {
-        e.signal.aborted || i(n);
+          n.signal
+        ) && !n.signal.aborted && w();
+      } catch (u) {
+        n.signal.aborted || w(u);
       }
     })(), () => {
-      t.current = null, e.abort();
+      t.current = null, n.abort();
     };
-  }, [r, l]);
+  }, [r, e, o]);
 };
 export {
-  C as useInitialConversation
+  p as useInitialConversation
 };

package/dist/primitives/providers/base-events-provider.cjs

@@ -1 +1 @@
-"use client";"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const l=require("react/jsx-runtime"),t=require("react"),p=require("./config-provider.cjs"),n=t.createContext(void 0),g=({children:e})=>{const{baseSettings:s,componentType:o}=p.useInkeepConfig(),{tags:r,analyticsProperties:i}=s,c="0.17.5",a=t.useMemo(()=>({widgetLibraryVersion:c,componentType:o,tags:r}),[o,r,c]),v={logEvent:t.useCallback(async u=>{const E={...a,...u.properties,...i},d={eventName:u.eventName,properties:E};return s.onEvent?.(d)},[s,a,i])};return l.jsx(n.Provider,{value:v,children:e})},m=()=>{const e=t.useContext(n);if(!e)throw new Error("useBaseEvents must be used within a BaseEventsProvider");return e};exports.BaseEventsContext=n;exports.BaseEventsProvider=g;exports.useBaseEvents=m;
+"use client";"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const l=require("react/jsx-runtime"),t=require("react"),p=require("./config-provider.cjs"),n=t.createContext(void 0),g=({children:e})=>{const{baseSettings:s,componentType:o}=p.useInkeepConfig(),{tags:r,analyticsProperties:i}=s,c="0.17.7",a=t.useMemo(()=>({widgetLibraryVersion:c,componentType:o,tags:r}),[o,r,c]),v={logEvent:t.useCallback(async u=>{const E={...a,...u.properties,...i},d={eventName:u.eventName,properties:E};return s.onEvent?.(d)},[s,a,i])};return l.jsx(n.Provider,{value:v,children:e})},m=()=>{const e=t.useContext(n);if(!e)throw new Error("useBaseEvents must be used within a BaseEventsProvider");return e};exports.BaseEventsContext=n;exports.BaseEventsProvider=g;exports.useBaseEvents=m;

package/dist/primitives/providers/base-events-provider.js

@@ -3,7 +3,7 @@ import { jsx as u } from "react/jsx-runtime";
 import { createContext as E, useMemo as d, useCallback as l, useContext as g } from "react";
 import { useInkeepConfig as x } from "./config-provider.js";
 const c = E(void 0), b = ({ children: e }) => {
-  const { baseSettings: t, componentType: o } = x(), { tags: s, analyticsProperties: n } = t, r = "0.17.5", i = d(
+  const { baseSettings: t, componentType: o } = x(), { tags: s, analyticsProperties: n } = t, r = "0.17.7", i = d(
     () => ({
       widgetLibraryVersion: r,
       componentType: o,

package/dist/primitives/providers/chat-base-events-provider.cjs

@@ -1 +1 @@
-"use client";"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const j=require("react/jsx-runtime"),u=require("react"),B=require("./config-provider.cjs"),O=require("./chat-auth-provider.cjs"),U=require("../hooks/use-events-api.cjs"),x=require("./base-events-provider.cjs"),M=({children:g})=>{const{baseSettings:n,aiChatSettings:h,componentType:i}=B.useInkeepConfig(),{tags:t,analyticsProperties:r,privacyPreferences:y,userProperties:o}=n,c="0.17.5",a=u.useMemo(()=>({widgetLibraryVersion:c,componentType:i}),[i,c]),{effectiveAuthToken:b,applicableRefreshSession:f,getCaptchaHeader:E,invalidateCaptcha:P}=O.useChatAuth(),{baseUrl:m,appId:A,analyticsApiBaseUrl:C,headers:I}=h,p=y?.optOutAllAnalytics??!1,{logEvent:l}=U.useEventsApi({baseUrl:C??m,appId:A,authToken:b,getCaptchaHeader:E,invalidateCaptcha:P,refreshSession:f,headers:I}),k={logEvent:u.useCallback(async s=>{const q={eventName:s.eventName,properties:{...a,...t?{tags:t}:{},...s.properties,...r}};if(!p){const e=s.properties??{},v=typeof e.conversationId=="string"?e.conversationId:void 0,d=typeof e.messageId=="string"?e.messageId:void 0,S=!!o&&Object.keys(o).length>0,w={...t?{tags:t}:{},...r??{}},T={...a,...s.properties};l({body:{type:s.eventName,...v?{conversationId:v}:{},...d?{messageId:d}:{},...S?{userProperties:o}:{},properties:w,metadata:T}})}try{return await n.onEvent?.(q)}catch(e){console.warn("[events] onEvent callback threw",e)}},[n,a,t,r,l,p,o])};return j.jsx(x.BaseEventsContext.Provider,{value:k,children:g})};exports.ChatBaseEventsProvider=M;
+"use client";"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const j=require("react/jsx-runtime"),u=require("react"),B=require("./config-provider.cjs"),O=require("./chat-auth-provider.cjs"),U=require("../hooks/use-events-api.cjs"),x=require("./base-events-provider.cjs"),M=({children:g})=>{const{baseSettings:n,aiChatSettings:h,componentType:i}=B.useInkeepConfig(),{tags:t,analyticsProperties:r,privacyPreferences:y,userProperties:o}=n,c="0.17.7",a=u.useMemo(()=>({widgetLibraryVersion:c,componentType:i}),[i,c]),{effectiveAuthToken:b,applicableRefreshSession:f,getCaptchaHeader:E,invalidateCaptcha:P}=O.useChatAuth(),{baseUrl:m,appId:A,analyticsApiBaseUrl:C,headers:I}=h,p=y?.optOutAllAnalytics??!1,{logEvent:l}=U.useEventsApi({baseUrl:C??m,appId:A,authToken:b,getCaptchaHeader:E,invalidateCaptcha:P,refreshSession:f,headers:I}),k={logEvent:u.useCallback(async s=>{const q={eventName:s.eventName,properties:{...a,...t?{tags:t}:{},...s.properties,...r}};if(!p){const e=s.properties??{},v=typeof e.conversationId=="string"?e.conversationId:void 0,d=typeof e.messageId=="string"?e.messageId:void 0,S=!!o&&Object.keys(o).length>0,w={...t?{tags:t}:{},...r??{}},T={...a,...s.properties};l({body:{type:s.eventName,...v?{conversationId:v}:{},...d?{messageId:d}:{},...S?{userProperties:o}:{},properties:w,metadata:T}})}try{return await n.onEvent?.(q)}catch(e){console.warn("[events] onEvent callback threw",e)}},[n,a,t,r,l,p,o])};return j.jsx(x.BaseEventsContext.Provider,{value:k,children:g})};exports.ChatBaseEventsProvider=M;

package/dist/primitives/providers/chat-base-events-provider.js

@@ -6,7 +6,7 @@ import { useChatAuth as O } from "./chat-auth-provider.js";
 import { useEventsApi as j } from "../hooks/use-events-api.js";
 import { BaseEventsContext as M } from "./base-events-provider.js";
 const F = ({ children: m }) => {
-  const { baseSettings: r, aiChatSettings: g, componentType: i } = N(), { tags: t, analyticsProperties: n, privacyPreferences: f, userProperties: o } = r, c = "0.17.5", a = x(
+  const { baseSettings: r, aiChatSettings: g, componentType: i } = N(), { tags: t, analyticsProperties: n, privacyPreferences: f, userProperties: o } = r, c = "0.17.7", a = x(
     () => ({
       widgetLibraryVersion: c,
       componentType: i

package/dist/types/config/ai.d.ts

@@ -3,6 +3,7 @@ import { GetHelpOption, CustomMessageAction } from './settings/actions';
 import { SearchAndChatFilters } from './filters';
 import { ComponentsConfig } from './components';
 import { FileUIPart } from 'ai';
+import { Message } from '../message';
 export type { FileUIPart } from 'ai';
 export interface InkeepAIChatSettings {
     /**
@@ -166,6 +167,13 @@ export interface InkeepAIChatSettings {
      * restore a previous conversation state.
      */
     conversationIdOverride?: string;
+    /**
+     * Pre-fetched conversation messages to render without fetching.
+     * Requires `conversationId` to be set.
+     *
+     * @beta This prop is subject to change.
+     */
+    fetchedConversation?: Message[];
     /**
      * When enabled, prevents users from sending new messages.
      * Useful for displaying archived or shared chat sessions.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@inkeep/agents-ui",
-  "version": "0.17.5",
+  "version": "0.17.7",
   "description": "",
   "homepage": "",
   "repository": {