@inkeep/agents-ui 0.15.27 → 0.15.28

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

@@ -1,4 +1,4 @@
-"use client";"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const Ve=require("@ai-sdk/react"),Se=require("./file-upload-input.cjs"),Ze=require("ai"),t=require("react"),Xe=require("../modal/modal-provider.cjs"),Ye=require("../../providers/chat-bubble-provider.cjs"),et=require("../../providers/sidebar-chat-provider.cjs"),tt=require("../../providers/config-provider.cjs"),st=require("./use-captcha.cjs"),rt=require("../../hooks/use-media-query.cjs"),nt=require("../../hooks/use-anonymous-session.cjs"),at=require("../../hooks/use-auth-token.cjs"),ot=require("../../hooks/use-conversation-loader.cjs"),O=require("../../utils/generate-uid.cjs"),it=require("../../providers/base-events-provider.cjs"),ut=require("../../providers/chat-form-provider.cjs"),ct=require("../../providers/widget-provider.cjs"),lt=require("@radix-ui/react-use-controllable-state"),dt=require("../../hooks/use-streaming-events.cjs"),pt=require("../../hooks/use-inkeep-api-client.cjs"),ft=require("../../hooks/use-input-notification.cjs");function ht(g){const m=g.message??"";let r=Number(g.code)||Number(g.statusCode);if(Number.isNaN(r))try{r=Number(JSON.parse(m).status)}catch{}const d=pt.parseAuthError(r,{detail:m});return d!==null?d:r===401?"session":null}const _=`Hmm.. 
+"use client";"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const Ze=require("@ai-sdk/react"),Ae=require("./file-upload-input.cjs"),Xe=require("ai"),t=require("react"),Ye=require("../modal/modal-provider.cjs"),et=require("../../providers/chat-bubble-provider.cjs"),tt=require("../../providers/sidebar-chat-provider.cjs"),st=require("../../providers/config-provider.cjs"),rt=require("./use-captcha.cjs"),nt=require("../../hooks/use-media-query.cjs"),at=require("../../hooks/use-anonymous-session.cjs"),ot=require("../../hooks/use-auth-token.cjs"),it=require("../../hooks/use-conversation-loader.cjs"),ut=require("../../hooks/use-initial-conversation.cjs"),O=require("../../utils/generate-uid.cjs"),ct=require("../../providers/base-events-provider.cjs"),lt=require("../../providers/chat-form-provider.cjs"),dt=require("../../providers/widget-provider.cjs"),ft=require("@radix-ui/react-use-controllable-state"),pt=require("../../hooks/use-streaming-events.cjs"),ht=require("../../hooks/use-inkeep-api-client.cjs"),gt=require("../../hooks/use-input-notification.cjs");function mt(m){const h=m.message??"";let r=Number(m.code)||Number(m.statusCode);if(Number.isNaN(r))try{r=Number(JSON.parse(h).status)}catch{}const d=ht.parseAuthError(r,{detail:h});return d!==null?d:r===401?"session":null}const _=`Hmm.. 
 
-It seems I might be having some issues right now. Please clear the chat and try again.`,gt=()=>{const{baseSettings:g,aiChatSettings:m}=tt.useInkeepConfig(),[r="",d]=lt.useControllableState({prop:m.conversationId,defaultProp:m.conversationId??""}),Ae=Xe.useModal(),Ie=Ye.useOptionalChatBubble(),we=et.useOptionalSidebarChat(),{logEvent:v}=it.useBaseEvents(),{setConversationId:ke,emitToParent:T}=dt.useStreamingEvents(),Y=t.useRef(r);t.useEffect(()=>{const e=Y.current;Y.current=r,e!==r&&v({eventName:"chat_conversation_changed",properties:{conversationId:r,previousConversationId:e}})},[r,v]);const[C,E]=t.useState(""),Te=e=>E(e.target.value),{shouldBypassCaptcha:ee,filters:te,privacyPreferences:Ee,userProperties:U}=g,{authToken:M,isLoading:Me,refreshToken:se}=at.useAuthToken(),re=!!g.getAuthToken,p=!!M,{onInputMessageChange:qe,filters:ne,baseUrl:q,agentUrl:xe,context:ae,headers:oe,appId:R,apiKey:y,files:S}=m,Fe=Ae?.isOpen??Ie?.isOpen??we?.isOpen??!0,{getCaptchaHeader:A,invalidate:c}=st.useCaptcha({baseUrl:q,shouldBypassCaptcha:ee||!!y,shouldMakeInitialRequest:Fe}),ie=t.useRef(A);ie.current=A;const ue=xe||`${q}/run/api/chat`,{sessionToken:D,refreshSession:L}=nt.useAnonymousSession({baseUrl:q,appId:R,getCaptchaHeader:A,invalidateCaptcha:c,optOutAllAnalytics:Ee?.optOutAllAnalytics,enabled:!p&&!Me}),{loadConversation:ce}=ot.useConversationLoader({baseUrl:q,appId:R,authToken:y??(p?M:D),getCaptchaHeader:A,invalidateCaptcha:c,refreshSession:y||p?void 0:L}),[Pe,le]=t.useState(!1),$=t.useRef(null);$.current=D;const B=t.useRef(null);B.current=M;const z=t.useRef(void 0);z.current=U&&Object.keys(U).length>0?JSON.stringify(U):void 0;const b=t.useRef(0),de=t.useRef(null),H=t.useRef(null),I=t.useRef(void 0),Ne=S?.map(e=>`${e.filename??""}:${e.mediaType}:${e.url.length}:${e.url.slice(0,64)}:${e.url.slice(-32)}`).join(`
-`)??"";t.useEffect(()=>{I.current=S?.length?S:void 0},[Ne]);const pe=t.useRef(oe);pe.current=oe;const K=t.useRef(void 0);K.current=te||ne?JSON.stringify({...te,...ne}):void 0;const Oe=e=>{switch(e.code){case 400:return e.message;case 401:return re?"Authentication failed. Please try again.":_;case 403:return`There seems to be a configuration error. Please contact ${g.organizationDisplayName??"Administrator"}`;default:return _}},[x,j]=t.useState([]),_e=t.useMemo(()=>new Ze.DefaultChatTransport({api:ue,headers:()=>{const e=y??B.current??$.current;return{"x-inkeep-client-timezone":Intl.DateTimeFormat().resolvedOptions().timeZone,"x-inkeep-client-timestamp":new Date().toISOString(),...R?{"x-inkeep-app-id":R}:{},...e?{Authorization:`Bearer ${e}`}:{},...K.current?{"inkeep-filters":K.current}:{},...z.current?{"x-inkeep-user-properties":z.current}:{},...pe.current}},prepareSendMessagesRequest:async e=>{const u=await ie.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},headers:{...e.headers,...u}}},body:{requestContext:ae}}),[ue,ae,R,y]),{messages:F,sendMessage:J,addToolApprovalResponse:G,status:fe,setMessages:h,stop:P,error:Q}=Ve.useChat({transport:_e,onData(e){T(e.type,e.data)},async onFinish(){T("completion",{conversationId:r}),await v({eventName:"assistant_message_received",properties:{conversationId:r}}),v({eventName:"assistant_answer_displayed",properties:{conversationId:r}})},onError(e){console.error("onError",{code:e.code,message:e.message});const u=ee||y?null:ht(e);if(u!==null&&b.current<1){b.current++;const s=H.current,n=de.current;(async()=>{if(u==="session"&&re){const a=await se();if(!a)throw new Error("Auth token refresh failed");B.current=a}else if(u==="session"){const a=await L();a&&($.current=a)}else c();if(s){G(s);return}n&&(h(a=>{let o=[...a];return o.at(-1)?.role==="assistant"&&(o=o.slice(0,-1)),o.at(-1)?.role==="user"&&(o=o.slice(0,-1)),o}),J(n.files?.length?{parts:[{type:"text",text:n.content},...n.files]}:{text:n.content},{body:n.body}))})().catch(()=>{b.current=0,c(),h(a=>{const o=[...a],f=o[o.length-1];if(!f)return o;const l=_;return f.role==="user"?o.push({id:O.generateUid(16),role:"assistant",parts:[{type:"text",text:l}]}):f.parts=[{type:"text",text:l}],o})});return}b.current=0,u!==null&&c(),v({eventName:"chat_error",properties:{conversationId:r,error:e.message}}),h(s=>{const n=[...s],i=n[n.length-1];if(i){const a=Oe(e);i.role==="user"?n.push({id:O.generateUid(16),role:"assistant",parts:[{type:"text",text:a}]}):i.parts=[{type:"text",text:a}]}return n})}}),he=t.useRef(p);t.useEffect(()=>{const e=he.current;he.current=p,e!==p&&(P(),w(null),h([]),d(""),E(""),j([]),c())},[p,P,h,d,c]);const ge=fe==="submitted",W=fe==="streaming",Ue=t.useMemo(()=>{const e=i=>{if(!i||typeof i!="object")return!1;const a=i;return typeof a.type=="string"&&a.type.startsWith("tool-")},s=[...F??[]].reverse().find(i=>i.role==="assistant");if(!s)return!1;const n=s.parts?.at(-1);return!(!e(n)||n.state!=="output-available"||!n.approval?.id||W)},[F,W]),me=W||Ue,ve=ge||me,De=F.length===0,V=!C.trim()&&x.length===0||ve,Le=rt.useMediaQuery("(max-width: 768px)"),[$e,w]=t.useState(null);t.useEffect(()=>{Q&&w(Q)},[Q]);const Be=()=>w(null),{inputNotification:ze,showInputNotification:ye,clearInputNotification:He}=ft.useInputNotification(),be=t.useRef(null);t.useEffect(()=>{qe?.(C)},[C]);const Ke=e=>{e.key==="Enter"&&!e.shiftKey&&!V&&!e.nativeEvent.isComposing&&(e.preventDefault(),Z())},Z=async(e=C)=>{if(V&&(!e||e.trim().length===0)&&x.length===0)return;const u=x;j([]),E(""),b.current=0,H.current=null,await v({eventName:"user_message_submitted",properties:{conversationId:r}});let s=r;s||(s=`conv_${O.generateUid(16)}`,d(s)),ke(s);const n=I.current;I.current=void 0;let i,a;if(n?.length){let o;try{o=await Promise.all(u.map(f=>{const l=Se.normalizeFileType(f);return new Promise((We,Re)=>{const k=new FileReader;k.onload=()=>{if(typeof k.result!="string"){Re(new Error(`Failed to read file "${l.name}"`));return}We({type:"file",url:k.result,mediaType:l.type,filename:l.name})},k.onerror=()=>Re(new Error(`Failed to read file "${l.name}"`)),k.readAsDataURL(l)})}))}catch{ye({title:"Failed to attach files",message:"Could not read one or more files. Please try again."});return}a=[...o,...n],i=e.trim()?{parts:[{type:"text",text:e},...a]}:{parts:a}}else if(u.length>0){const o=new DataTransfer;for(const l of u)o.items.add(Se.normalizeFileType(l));const f=o.files;i=e.trim()?{text:e,files:f}:{files:f}}else i={text:e};de.current={content:e,body:{conversationId:s},files:a},J(i,{body:{conversationId:s}})},je=t.useCallback(e=>{b.current=0,H.current=e,G(e)},[G]),X=t.useCallback(()=>{P().then(()=>{T("aborted",{conversationId:r})})},[P,r,T]),Ce=()=>{Be(),h([]),d(""),c(),I.current=S?.length?S:void 0,v({eventName:"chat_clear_button_clicked",properties:{conversationId:r}})},N=t.useCallback((e,u)=>{w(null),h(u),d(e),c(),I.current=void 0},[h,d,c]),Je=t.useCallback(async(e,u)=>{X(),N(e,[]),le(!0);try{const s=await ce(e,u),n=s?.[s.length-1],i=s!==null&&n?.role==="user"?[...s,{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."}]}]:s;i!==null&&N(e,i)}finally{u?.aborted||le(!1)}},[N,ce,X]),{openForm:Ge}=ut.useChatForm(),Qe=ct.useWidget();return t.useImperativeHandle(m.chatFunctionsRef,()=>({submitMessage:Z,updateInputMessage(e){E(e)},clearChat:Ce,openForm:e=>{Qe?.setView("chat"),Ge(e,void 0)},focusInput:()=>{be.current?.focus()}})),{messages:F,sendMessage:J,addToolApprovalResponse:je,isLoading:ge,isStreaming:me,isBusy:ve,error:$e,setError:w,isSubmitDisabled:V,input:C,handleInputChange:Te,handleInputKeyDown:Ke,handleSubmit:Z,stop:X,clear:Ce,inputRef:be,isMobile:Le,files:x,setFiles:j,isNewChat:De,conversationId:r,restoreSession:N,loadAndRestoreSession:Je,isSessionLoading:Pe,authToken:p?M:D,refreshSession:p?se:L,getCaptchaHeader:A,invalidateCaptcha:c,inputNotification:ze,showInputNotification:ye,clearInputNotification:He}};exports.DEFAULT_ERROR_MESSAGE=_;exports.useInkeepChat=gt;
+It seems I might be having some issues right now. Please clear the chat and try again.`,vt=()=>{const{baseSettings:m,aiChatSettings:h}=st.useInkeepConfig(),[r="",d]=ft.useControllableState({prop:h.conversationIdOverride,defaultProp:h.conversationIdOverride??""}),ke=Ye.useModal(),we=et.useOptionalChatBubble(),Te=tt.useOptionalSidebarChat(),{logEvent:v}=ct.useBaseEvents(),{setConversationId:Ee,emitToParent:E}=pt.useStreamingEvents(),Y=t.useRef(r);t.useEffect(()=>{const e=Y.current;Y.current=r,e!==r&&v({eventName:"chat_conversation_changed",properties:{conversationId:r,previousConversationId:e}})},[r,v]);const[C,M]=t.useState(""),Me=e=>M(e.target.value),{shouldBypassCaptcha:ee,filters:te,privacyPreferences:qe,userProperties:U}=m,{authToken:q,isLoading:Fe,refreshToken:se}=ot.useAuthToken(),re=!!m.getAuthToken,f=!!q,{onInputMessageChange:xe,filters:ne,baseUrl:F,agentUrl:Pe,context:ae,headers:oe,appId:R,apiKey:y,files:S}=h,Ne=ke?.isOpen??we?.isOpen??Te?.isOpen??!0,{getCaptchaHeader:I,invalidate:c}=rt.useCaptcha({baseUrl:F,shouldBypassCaptcha:ee||!!y,shouldMakeInitialRequest:Ne}),ie=t.useRef(I);ie.current=I;const ue=Pe||`${F}/run/api/chat`,{sessionToken:D,refreshSession:L}=at.useAnonymousSession({baseUrl:F,appId:R,getCaptchaHeader:I,invalidateCaptcha:c,optOutAllAnalytics:qe?.optOutAllAnalytics,enabled:!f&&!Fe}),ce=y??(f?q:D),{loadConversation:le}=it.useConversationLoader({baseUrl:F,appId:R,authToken:ce,getCaptchaHeader:I,invalidateCaptcha:c,refreshSession:y||f?void 0:L}),[Oe,de]=t.useState(!1),$=t.useRef(null);$.current=D;const B=t.useRef(null);B.current=q;const z=t.useRef(void 0);z.current=U&&Object.keys(U).length>0?JSON.stringify(U):void 0;const b=t.useRef(0),fe=t.useRef(null),H=t.useRef(null),A=t.useRef(void 0),_e=S?.map(e=>`${e.filename??""}:${e.mediaType}:${e.url.length}:${e.url.slice(0,64)}:${e.url.slice(-32)}`).join(`
+`)??"";t.useEffect(()=>{A.current=S?.length?S:void 0},[_e]);const pe=t.useRef(oe);pe.current=oe;const K=t.useRef(void 0);K.current=te||ne?JSON.stringify({...te,...ne}):void 0;const Ue=e=>{switch(e.code){case 400:return e.message;case 401:return re?"Authentication failed. Please try again.":_;case 403:return`There seems to be a configuration error. Please contact ${m.organizationDisplayName??"Administrator"}`;default:return _}},[x,j]=t.useState([]),De=t.useMemo(()=>new Xe.DefaultChatTransport({api:ue,headers:()=>{const e=y??B.current??$.current;return{"x-inkeep-client-timezone":Intl.DateTimeFormat().resolvedOptions().timeZone,"x-inkeep-client-timestamp":new Date().toISOString(),...R?{"x-inkeep-app-id":R}:{},...e?{Authorization:`Bearer ${e}`}:{},...K.current?{"inkeep-filters":K.current}:{},...z.current?{"x-inkeep-user-properties":z.current}:{},...pe.current}},prepareSendMessagesRequest:async e=>{const u=await ie.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},headers:{...e.headers,...u}}},body:{requestContext:ae}}),[ue,ae,R,y]),{messages:P,sendMessage:J,addToolApprovalResponse:G,status:he,setMessages:g,stop:N,error:Q}=Ze.useChat({transport:De,onData(e){E(e.type,e.data)},async onFinish(){E("completion",{conversationId:r}),await v({eventName:"assistant_message_received",properties:{conversationId:r}}),v({eventName:"assistant_answer_displayed",properties:{conversationId:r}})},onError(e){console.error("onError",{code:e.code,message:e.message});const u=ee||y?null:mt(e);if(u!==null&&b.current<1){b.current++;const s=H.current,a=fe.current;(async()=>{if(u==="session"&&re){const n=await se();if(!n)throw new Error("Auth token refresh failed");B.current=n}else if(u==="session"){const n=await L();n&&($.current=n)}else c();if(s){G(s);return}a&&(g(n=>{let o=[...n];return o.at(-1)?.role==="assistant"&&(o=o.slice(0,-1)),o.at(-1)?.role==="user"&&(o=o.slice(0,-1)),o}),J(a.files?.length?{parts:[{type:"text",text:a.content},...a.files]}:{text:a.content},{body:a.body}))})().catch(()=>{b.current=0,c(),g(n=>{const o=[...n],p=o[o.length-1];if(!p)return o;const l=_;return p.role==="user"?o.push({id:O.generateUid(16),role:"assistant",parts:[{type:"text",text:l}]}):p.parts=[{type:"text",text:l}],o})});return}b.current=0,u!==null&&c(),v({eventName:"chat_error",properties:{conversationId:r,error:e.message}}),g(s=>{const a=[...s],i=a[a.length-1];if(i){const n=Ue(e);i.role==="user"?a.push({id:O.generateUid(16),role:"assistant",parts:[{type:"text",text:n}]}):i.parts=[{type:"text",text:n}]}return a})}}),ge=t.useRef(f);t.useEffect(()=>{const e=ge.current;ge.current=f,e!==f&&(N(),k(null),g([]),d(""),M(""),j([]),c())},[f,N,g,d,c]);const me=he==="submitted",W=he==="streaming",Le=t.useMemo(()=>{const e=i=>{if(!i||typeof i!="object")return!1;const n=i;return typeof n.type=="string"&&n.type.startsWith("tool-")},s=[...P??[]].reverse().find(i=>i.role==="assistant");if(!s)return!1;const a=s.parts?.at(-1);return!(!e(a)||a.state!=="output-available"||!a.approval?.id||W)},[P,W]),ve=W||Le,ye=me||ve,$e=P.length===0,V=!C.trim()&&x.length===0||ye,Be=nt.useMediaQuery("(max-width: 768px)"),[ze,k]=t.useState(null);t.useEffect(()=>{Q&&k(Q)},[Q]);const He=()=>k(null),{inputNotification:Ke,showInputNotification:be,clearInputNotification:je}=gt.useInputNotification(),Ce=t.useRef(null);t.useEffect(()=>{xe?.(C)},[C]);const Je=e=>{e.key==="Enter"&&!e.shiftKey&&!V&&!e.nativeEvent.isComposing&&(e.preventDefault(),Z())},Z=async(e=C)=>{if(V&&(!e||e.trim().length===0)&&x.length===0)return;const u=x;j([]),M(""),b.current=0,H.current=null,await v({eventName:"user_message_submitted",properties:{conversationId:r}});let s=r;s||(s=`conv_${O.generateUid(16)}`,d(s)),Ee(s);const a=A.current;A.current=void 0;let i,n;if(a?.length){let o;try{o=await Promise.all(u.map(p=>{const l=Ae.normalizeFileType(p);return new Promise((Ve,Ie)=>{const T=new FileReader;T.onload=()=>{if(typeof T.result!="string"){Ie(new Error(`Failed to read file "${l.name}"`));return}Ve({type:"file",url:T.result,mediaType:l.type,filename:l.name})},T.onerror=()=>Ie(new Error(`Failed to read file "${l.name}"`)),T.readAsDataURL(l)})}))}catch{be({title:"Failed to attach files",message:"Could not read one or more files. Please try again."});return}n=[...o,...a],i=e.trim()?{parts:[{type:"text",text:e},...n]}:{parts:n}}else if(u.length>0){const o=new DataTransfer;for(const l of u)o.items.add(Ae.normalizeFileType(l));const p=o.files;i=e.trim()?{text:e,files:p}:{files:p}}else i={text:e};fe.current={content:e,body:{conversationId:s},files:n},J(i,{body:{conversationId:s}})},Ge=t.useCallback(e=>{b.current=0,H.current=e,G(e)},[G]),X=t.useCallback(()=>{N().then(()=>{E("aborted",{conversationId:r})})},[N,r,E]),Re=()=>{He(),g([]),d(""),c(),A.current=S?.length?S:void 0,v({eventName:"chat_clear_button_clicked",properties:{conversationId:r}})},w=t.useCallback((e,u)=>{k(null),g(u),d(e),c(),A.current=void 0},[g,d,c]),Se=t.useCallback(async(e,u)=>{X(),w(e,[]),de(!0);try{const s=await le(e,u);if(s===null)return!1;const i=s[s.length-1]?.role==="user"?[...s,{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."}]}]:s;return w(e,i),!0}finally{u?.aborted||de(!1)}},[w,le,X]);ut.useInitialConversation({conversationId:h.conversationId,effectiveAuthToken:ce,loadAndRestoreSession:Se,onLoadFailed:()=>w("",[])});const{openForm:Qe}=lt.useChatForm(),We=dt.useWidget();return t.useImperativeHandle(h.chatFunctionsRef,()=>({submitMessage:Z,updateInputMessage(e){M(e)},clearChat:Re,openForm:e=>{We?.setView("chat"),Qe(e,void 0)},focusInput:()=>{Ce.current?.focus()}})),{messages:P,sendMessage:J,addToolApprovalResponse:Ge,isLoading:me,isStreaming:ve,isBusy:ye,error:ze,setError:k,isSubmitDisabled:V,input:C,handleInputChange:Me,handleInputKeyDown:Je,handleSubmit:Z,stop:X,clear:Re,inputRef:Ce,isMobile:Be,files:x,setFiles:j,isNewChat:$e,conversationId:r,restoreSession:w,loadAndRestoreSession:Se,isSessionLoading:Oe,authToken:f?q:D,refreshSession:f?se:L,getCaptchaHeader:I,invalidateCaptcha:c,inputNotification:Ke,showInputNotification:be,clearInputNotification:je}};exports.DEFAULT_ERROR_MESSAGE=_;exports.useInkeepChat=vt;

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

@@ -47,7 +47,7 @@ export declare const useInkeepChat: () => {
     isNewChat: boolean;
     conversationId: string;
     restoreSession: (sessionId: string, loadedMessages: Message[]) => void;
-    loadAndRestoreSession: (sessionId: string, signal?: AbortSignal) => Promise<void>;
+    loadAndRestoreSession: (sessionId: string, signal?: AbortSignal) => Promise<boolean>;
     isSessionLoading: boolean;
     authToken: string | null;
     refreshSession: () => Promise<string | null>;

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

@@ -1,122 +1,123 @@
 "use client";
-import { useChat as et } from "@ai-sdk/react";
-import { normalizeFileType as Re } from "./file-upload-input.js";
-import { DefaultChatTransport as tt } from "ai";
-import { useRef as l, useEffect as k, useState as D, useMemo as Te, useCallback as $, useImperativeHandle as st } from "react";
-import { useModal as rt } from "../modal/modal-provider.js";
-import { useOptionalChatBubble as nt } from "../../providers/chat-bubble-provider.js";
-import { useOptionalSidebarChat as ot } from "../../providers/sidebar-chat-provider.js";
-import { useInkeepConfig as at } from "../../providers/config-provider.js";
-import { useCaptcha as it } from "./use-captcha.js";
-import { useMediaQuery as lt } from "../../hooks/use-media-query.js";
-import { useAnonymousSession as ct } from "../../hooks/use-anonymous-session.js";
-import { useAuthToken as ut } from "../../hooks/use-auth-token.js";
-import { useConversationLoader as pt } from "../../hooks/use-conversation-loader.js";
+import { useChat as tt } from "@ai-sdk/react";
+import { normalizeFileType as ke } from "./file-upload-input.js";
+import { DefaultChatTransport as st } from "ai";
+import { useRef as l, useEffect as x, useState as D, useMemo as xe, useCallback as $, useImperativeHandle as rt } from "react";
+import { useModal as nt } from "../modal/modal-provider.js";
+import { useOptionalChatBubble as ot } from "../../providers/chat-bubble-provider.js";
+import { useOptionalSidebarChat as at } from "../../providers/sidebar-chat-provider.js";
+import { useInkeepConfig as it } from "../../providers/config-provider.js";
+import { useCaptcha as lt } from "./use-captcha.js";
+import { useMediaQuery as ct } from "../../hooks/use-media-query.js";
+import { useAnonymousSession as ut } from "../../hooks/use-anonymous-session.js";
+import { useAuthToken as pt } from "../../hooks/use-auth-token.js";
+import { useConversationLoader as dt } from "../../hooks/use-conversation-loader.js";
+import { useInitialConversation as ft } from "../../hooks/use-initial-conversation.js";
 import { generateUid as L } from "../../utils/generate-uid.js";
-import { useBaseEvents as dt } from "../../providers/base-events-provider.js";
-import { useChatForm as ft } from "../../providers/chat-form-provider.js";
-import { useWidget as mt } from "../../providers/widget-provider.js";
-import { useControllableState as ht } from "@radix-ui/react-use-controllable-state";
-import { useStreamingEvents as gt } from "../../hooks/use-streaming-events.js";
-import { parseAuthError as yt } from "../../hooks/use-inkeep-api-client.js";
-import { useInputNotification as vt } from "../../hooks/use-input-notification.js";
-function bt(h) {
-  const g = h.message ?? "";
-  let s = Number(h.code) || Number(h.statusCode);
+import { useBaseEvents as mt } from "../../providers/base-events-provider.js";
+import { useChatForm as ht } from "../../providers/chat-form-provider.js";
+import { useWidget as gt } from "../../providers/widget-provider.js";
+import { useControllableState as vt } from "@radix-ui/react-use-controllable-state";
+import { useStreamingEvents as yt } from "../../hooks/use-streaming-events.js";
+import { parseAuthError as bt } from "../../hooks/use-inkeep-api-client.js";
+import { useInputNotification as Ct } from "../../hooks/use-input-notification.js";
+function It(g) {
+  const m = g.message ?? "";
+  let s = Number(g.code) || Number(g.statusCode);
   if (Number.isNaN(s))
     try {
-      s = Number(JSON.parse(g).status);
+      s = Number(JSON.parse(m).status);
     } catch {
     }
-  const p = yt(s, { detail: g });
+  const p = bt(s, { detail: m });
   return p !== null ? p : s === 401 ? "session" : null;
 }
 const te = `Hmm.. 
 
-It seems I might be having some issues right now. Please clear the chat and try again.`, zt = () => {
-  const { baseSettings: h, aiChatSettings: g } = at(), [s = "", p] = ht({
-    prop: g.conversationId,
-    defaultProp: g.conversationId ?? ""
-  }), ke = rt(), xe = nt(), Me = ot(), { logEvent: y } = dt(), { setConversationId: Ee, emitToParent: x } = gt(), se = l(s);
-  k(() => {
+It seems I might be having some issues right now. Please clear the chat and try again.`, Kt = () => {
+  const { baseSettings: g, aiChatSettings: m } = it(), [s = "", p] = vt({
+    prop: m.conversationIdOverride,
+    defaultProp: m.conversationIdOverride ?? ""
+  }), Me = nt(), Fe = ot(), Ee = at(), { logEvent: v } = mt(), { setConversationId: Ne, emitToParent: M } = yt(), se = l(s);
+  x(() => {
     const e = se.current;
-    se.current = s, e !== s && y({
+    se.current = s, e !== s && v({
       eventName: "chat_conversation_changed",
       properties: {
         conversationId: s,
         previousConversationId: e
       }
     });
-  }, [s, y]);
-  const [C, M] = D(""), Fe = (e) => M(e.target.value), { shouldBypassCaptcha: re, filters: ne, privacyPreferences: Ne, userProperties: B } = h, { authToken: E, isLoading: Pe, refreshToken: oe } = ut(), ae = !!h.getAuthToken, d = !!E, {
-    onInputMessageChange: Oe,
+  }, [s, v]);
+  const [C, F] = D(""), Oe = (e) => F(e.target.value), { shouldBypassCaptcha: re, filters: ne, privacyPreferences: Pe, userProperties: B } = g, { authToken: E, isLoading: _e, refreshToken: oe } = pt(), ae = !!g.getAuthToken, d = !!E, {
+    onInputMessageChange: De,
     filters: ie,
-    baseUrl: F,
-    agentUrl: _e,
+    baseUrl: N,
+    agentUrl: $e,
     context: le,
     headers: ce,
-    appId: w,
-    apiKey: v,
-    files: S
-  } = g, De = ke?.isOpen ?? xe?.isOpen ?? Me?.isOpen ?? !0, { getCaptchaHeader: I, invalidate: c } = it({
-    baseUrl: F,
-    shouldBypassCaptcha: re || !!v,
-    shouldMakeInitialRequest: De
-  }), ue = l(I);
-  ue.current = I;
-  const pe = _e || `${F}/run/api/chat`, { sessionToken: U, refreshSession: z } = ct({
-    baseUrl: F,
-    appId: w,
-    getCaptchaHeader: I,
+    appId: I,
+    apiKey: y,
+    files: w
+  } = m, Le = Me?.isOpen ?? Fe?.isOpen ?? Ee?.isOpen ?? !0, { getCaptchaHeader: S, invalidate: c } = lt({
+    baseUrl: N,
+    shouldBypassCaptcha: re || !!y,
+    shouldMakeInitialRequest: Le
+  }), ue = l(S);
+  ue.current = S;
+  const pe = $e || `${N}/run/api/chat`, { sessionToken: U, refreshSession: z } = ut({
+    baseUrl: N,
+    appId: I,
+    getCaptchaHeader: S,
     invalidateCaptcha: c,
-    optOutAllAnalytics: Ne?.optOutAllAnalytics,
-    enabled: !d && !Pe
-  }), { loadConversation: de } = pt({
-    baseUrl: F,
-    appId: w,
-    authToken: v ?? (d ? E : U),
-    getCaptchaHeader: I,
+    optOutAllAnalytics: Pe?.optOutAllAnalytics,
+    enabled: !d && !_e
+  }), de = y ?? (d ? E : U), { loadConversation: fe } = dt({
+    baseUrl: N,
+    appId: I,
+    authToken: de,
+    getCaptchaHeader: S,
     invalidateCaptcha: c,
-    refreshSession: v || d ? void 0 : z
-  }), [$e, fe] = D(!1), H = l(null);
+    refreshSession: y || d ? void 0 : z
+  }), [Be, me] = D(!1), H = l(null);
   H.current = U;
   const q = l(null);
   q.current = E;
   const K = l(void 0);
   K.current = B && Object.keys(B).length > 0 ? JSON.stringify(B) : void 0;
-  const b = l(0), me = l(null), J = l(null), A = l(void 0), Le = S?.map((e) => `${e.filename ?? ""}:${e.mediaType}:${e.url.length}:${e.url.slice(0, 64)}:${e.url.slice(-32)}`).join(`
+  const b = l(0), he = l(null), J = l(null), A = l(void 0), Ue = w?.map((e) => `${e.filename ?? ""}:${e.mediaType}:${e.url.length}:${e.url.slice(0, 64)}:${e.url.slice(-32)}`).join(`
 `) ?? "";
-  k(() => {
-    A.current = S?.length ? S : void 0;
-  }, [Le]);
-  const he = l(ce);
-  he.current = ce;
+  x(() => {
+    A.current = w?.length ? w : void 0;
+  }, [Ue]);
+  const ge = l(ce);
+  ge.current = ce;
   const j = l(void 0);
   j.current = ne || ie ? JSON.stringify({ ...ne, ...ie }) : void 0;
-  const Be = (e) => {
+  const ze = (e) => {
     switch (e.code) {
       case 400:
         return e.message;
       case 401:
         return ae ? "Authentication failed. Please try again." : te;
       case 403:
-        return `There seems to be a configuration error. Please contact ${h.organizationDisplayName ?? "Administrator"}`;
+        return `There seems to be a configuration error. Please contact ${g.organizationDisplayName ?? "Administrator"}`;
       default:
         return te;
     }
-  }, [N, W] = D([]), Ue = Te(
-    () => new tt({
+  }, [O, W] = D([]), He = xe(
+    () => new st({
       api: pe,
       headers: () => {
-        const e = v ?? q.current ?? H.current;
+        const e = y ?? q.current ?? H.current;
         return {
           "x-inkeep-client-timezone": Intl.DateTimeFormat().resolvedOptions().timeZone,
           "x-inkeep-client-timestamp": (/* @__PURE__ */ new Date()).toISOString(),
-          ...w ? { "x-inkeep-app-id": w } : {},
+          ...I ? { "x-inkeep-app-id": I } : {},
           ...e ? { Authorization: `Bearer ${e}` } : {},
           ...j.current ? { "inkeep-filters": j.current } : {},
           ...K.current ? { "x-inkeep-user-properties": K.current } : {},
-          ...he.current
+          ...ge.current
         };
       },
       prepareSendMessagesRequest: async (e) => {
@@ -139,27 +140,27 @@ It seems I might be having some issues right now. Please clear the chat and try
         requestContext: le
       }
     }),
-    [pe, le, w, v]
+    [pe, le, I, y]
   ), {
     messages: P,
     sendMessage: G,
     addToolApprovalResponse: Q,
-    status: ge,
-    setMessages: m,
-    stop: O,
+    status: ve,
+    setMessages: h,
+    stop: _,
     error: V
-  } = et({
-    transport: Ue,
+  } = tt({
+    transport: He,
     onData(e) {
-      x(e.type, e.data);
+      M(e.type, e.data);
     },
     async onFinish() {
-      x("completion", { conversationId: s }), await y({
+      M("completion", { conversationId: s }), await v({
         eventName: "assistant_message_received",
         properties: {
           conversationId: s
         }
-      }), y({
+      }), v({
         eventName: "assistant_answer_displayed",
         properties: {
           conversationId: s
@@ -168,34 +169,34 @@ It seems I might be having some issues right now. Please clear the chat and try
     },
     onError(e) {
       console.error("onError", { code: e.code, message: e.message });
-      const i = re || v ? null : bt(e);
+      const i = re || y ? null : It(e);
       if (i !== null && b.current < 1) {
         b.current++;
-        const t = J.current, r = me.current;
+        const t = J.current, n = he.current;
         (async () => {
           if (i === "session" && ae) {
-            const n = await oe();
-            if (!n) throw new Error("Auth token refresh failed");
-            q.current = n;
+            const r = await oe();
+            if (!r) throw new Error("Auth token refresh failed");
+            q.current = r;
           } else if (i === "session") {
-            const n = await z();
-            n && (H.current = n);
+            const r = await z();
+            r && (H.current = r);
           } else
             c();
           if (t) {
             Q(t);
             return;
           }
-          r && (m((n) => {
-            let o = [...n];
+          n && (h((r) => {
+            let o = [...r];
             return o.at(-1)?.role === "assistant" && (o = o.slice(0, -1)), o.at(-1)?.role === "user" && (o = o.slice(0, -1)), o;
           }), G(
-            r.files?.length ? { parts: [{ type: "text", text: r.content }, ...r.files] } : { text: r.content },
-            { body: r.body }
+            n.files?.length ? { parts: [{ type: "text", text: n.content }, ...n.files] } : { text: n.content },
+            { body: n.body }
           ));
         })().catch(() => {
-          b.current = 0, c(), m((n) => {
-            const o = [...n], f = o[o.length - 1];
+          b.current = 0, c(), h((r) => {
+            const o = [...r], f = o[o.length - 1];
             if (!f) return o;
             const u = te;
             return f.role === "user" ? o.push({
@@ -207,83 +208,83 @@ It seems I might be having some issues right now. Please clear the chat and try
         });
         return;
       }
-      b.current = 0, i !== null && c(), y({
+      b.current = 0, i !== null && c(), v({
         eventName: "chat_error",
         properties: {
           conversationId: s,
           error: e.message
         }
-      }), m((t) => {
-        const r = [...t], a = r[r.length - 1];
+      }), h((t) => {
+        const n = [...t], a = n[n.length - 1];
         if (a) {
-          const n = Be(e);
-          a.role === "user" ? r.push({
+          const r = ze(e);
+          a.role === "user" ? n.push({
             id: L(16),
             role: "assistant",
-            parts: [{ type: "text", text: n }]
-          }) : a.parts = [{ type: "text", text: n }];
+            parts: [{ type: "text", text: r }]
+          }) : a.parts = [{ type: "text", text: r }];
         }
-        return r;
+        return n;
       });
     }
   }), ye = l(d);
-  k(() => {
+  x(() => {
     const e = ye.current;
-    ye.current = d, e !== d && (O(), R(null), m([]), p(""), M(""), W([]), c());
-  }, [d, O, m, p, c]);
-  const ve = ge === "submitted", Z = ge === "streaming", ze = Te(() => {
+    ye.current = d, e !== d && (_(), T(null), h([]), p(""), F(""), W([]), c());
+  }, [d, _, h, p, c]);
+  const be = ve === "submitted", Z = ve === "streaming", qe = xe(() => {
     const e = (a) => {
       if (!a || typeof a != "object") return !1;
-      const n = a;
-      return typeof n.type == "string" && n.type.startsWith("tool-");
+      const r = a;
+      return typeof r.type == "string" && r.type.startsWith("tool-");
     }, t = [...P ?? []].reverse().find((a) => a.role === "assistant");
     if (!t) return !1;
-    const r = t.parts?.at(-1);
-    return !(!e(r) || r.state !== "output-available" || !r.approval?.id || Z);
-  }, [P, Z]), be = Z || ze, Ce = ve || be, He = P.length === 0, X = !C.trim() && N.length === 0 || Ce, qe = lt("(max-width: 768px)"), [Ke, R] = D(null);
-  k(() => {
-    V && R(V);
+    const n = t.parts?.at(-1);
+    return !(!e(n) || n.state !== "output-available" || !n.approval?.id || Z);
+  }, [P, Z]), Ce = Z || qe, Ie = be || Ce, Ke = P.length === 0, X = !C.trim() && O.length === 0 || Ie, Je = ct("(max-width: 768px)"), [je, T] = D(null);
+  x(() => {
+    V && T(V);
   }, [V]);
-  const Je = () => R(null), { inputNotification: je, showInputNotification: we, clearInputNotification: We } = vt(), Se = l(null);
-  k(() => {
-    Oe?.(C);
+  const We = () => T(null), { inputNotification: Ge, showInputNotification: we, clearInputNotification: Qe } = Ct(), Se = l(null);
+  x(() => {
+    De?.(C);
   }, [C]);
-  const Ge = (e) => {
+  const Ve = (e) => {
     e.key === "Enter" && !e.shiftKey && !X && !e.nativeEvent.isComposing && (e.preventDefault(), Y());
   }, Y = async (e = C) => {
-    if (X && (!e || e.trim().length === 0) && N.length === 0) return;
-    const i = N;
-    W([]), M(""), b.current = 0, J.current = null, await y({
+    if (X && (!e || e.trim().length === 0) && O.length === 0) return;
+    const i = O;
+    W([]), F(""), b.current = 0, J.current = null, await v({
       eventName: "user_message_submitted",
       properties: {
         conversationId: s
       }
     });
     let t = s;
-    t || (t = `conv_${L(16)}`, p(t)), Ee(t);
-    const r = A.current;
+    t || (t = `conv_${L(16)}`, p(t)), Ne(t);
+    const n = A.current;
     A.current = void 0;
-    let a, n;
-    if (r?.length) {
+    let a, r;
+    if (n?.length) {
       let o;
       try {
         o = await Promise.all(
           i.map((f) => {
-            const u = Re(f);
-            return new Promise((Ye, Ae) => {
-              const T = new FileReader();
-              T.onload = () => {
-                if (typeof T.result != "string") {
-                  Ae(new Error(`Failed to read file "${u.name}"`));
+            const u = ke(f);
+            return new Promise((et, Re) => {
+              const k = new FileReader();
+              k.onload = () => {
+                if (typeof k.result != "string") {
+                  Re(new Error(`Failed to read file "${u.name}"`));
                   return;
                 }
-                Ye({
+                et({
                   type: "file",
-                  url: T.result,
+                  url: k.result,
                   mediaType: u.type,
                   filename: u.name
                 });
-              }, T.onerror = () => Ae(new Error(`Failed to read file "${u.name}"`)), T.readAsDataURL(u);
+              }, k.onerror = () => Re(new Error(`Failed to read file "${u.name}"`)), k.readAsDataURL(u);
             });
           })
         );
@@ -294,66 +295,75 @@ It seems I might be having some issues right now. Please clear the chat and try
         });
         return;
       }
-      n = [...o, ...r], a = e.trim() ? { parts: [{ type: "text", text: e }, ...n] } : { parts: n };
+      r = [...o, ...n], a = e.trim() ? { parts: [{ type: "text", text: e }, ...r] } : { parts: r };
     } else if (i.length > 0) {
       const o = new DataTransfer();
-      for (const u of i) o.items.add(Re(u));
+      for (const u of i) o.items.add(ke(u));
       const f = o.files;
       a = e.trim() ? { text: e, files: f } : { files: f };
     } else
       a = { text: e };
-    me.current = {
+    he.current = {
       content: e,
       body: { conversationId: t },
-      files: n
+      files: r
     }, G(a, {
       body: { conversationId: t }
     });
-  }, Qe = $(
+  }, Ze = $(
     (e) => {
       b.current = 0, J.current = e, Q(e);
     },
     [Q]
   ), ee = $(() => {
-    O().then(() => {
-      x("aborted", { conversationId: s });
+    _().then(() => {
+      M("aborted", { conversationId: s });
     });
-  }, [O, s, x]), Ie = () => {
-    Je(), m([]), p(""), c(), A.current = S?.length ? S : void 0, y({
+  }, [_, s, M]), Ae = () => {
+    We(), h([]), p(""), c(), A.current = w?.length ? w : void 0, v({
       eventName: "chat_clear_button_clicked",
       properties: {
         conversationId: s
       }
     });
-  }, _ = $(
+  }, R = $(
     (e, i) => {
-      R(null), m(i), p(e), c(), A.current = void 0;
+      T(null), h(i), p(e), c(), A.current = void 0;
     },
-    [m, p, c]
-  ), Ve = $(
+    [h, p, c]
+  ), Te = $(
     async (e, i) => {
-      ee(), _(e, []), fe(!0);
+      ee(), R(e, []), me(!0);
       try {
-        const t = await de(e, i), r = t?.[t.length - 1], a = t !== null && r?.role === "user" ? [...t, {
+        const t = await fe(e, i);
+        if (t === null) return !1;
+        const a = t[t.length - 1]?.role === "user" ? [...t, {
           id: L(16),
           role: "assistant",
           parts: [{ type: "text", text: "This session was interrupted. Please check back in a few minutes or start a new conversation." }]
         }] : t;
-        a !== null && _(e, a);
+        return R(e, a), !0;
       } finally {
-        i?.aborted || fe(!1);
+        i?.aborted || me(!1);
       }
     },
-    [_, de, ee]
-  ), { openForm: Ze } = ft(), Xe = mt();
-  return st(g.chatFunctionsRef, () => ({
+    [R, fe, ee]
+  );
+  ft({
+    conversationId: m.conversationId,
+    effectiveAuthToken: de,
+    loadAndRestoreSession: Te,
+    onLoadFailed: () => R("", [])
+  });
+  const { openForm: Xe } = ht(), Ye = gt();
+  return rt(m.chatFunctionsRef, () => ({
     submitMessage: Y,
     updateInputMessage(e) {
-      M(e);
+      F(e);
     },
-    clearChat: Ie,
+    clearChat: Ae,
     openForm: (e) => {
-      Xe?.setView("chat"), Ze(e, void 0);
+      Ye?.setView("chat"), Xe(e, void 0);
     },
     focusInput: () => {
       Se.current?.focus();
@@ -361,38 +371,38 @@ It seems I might be having some issues right now. Please clear the chat and try
   })), {
     messages: P,
     sendMessage: G,
-    addToolApprovalResponse: Qe,
-    isLoading: ve,
-    isStreaming: be,
-    isBusy: Ce,
-    error: Ke,
-    setError: R,
+    addToolApprovalResponse: Ze,
+    isLoading: be,
+    isStreaming: Ce,
+    isBusy: Ie,
+    error: je,
+    setError: T,
     isSubmitDisabled: X,
     input: C,
-    handleInputChange: Fe,
-    handleInputKeyDown: Ge,
+    handleInputChange: Oe,
+    handleInputKeyDown: Ve,
     handleSubmit: Y,
     stop: ee,
-    clear: Ie,
+    clear: Ae,
     inputRef: Se,
-    isMobile: qe,
-    files: N,
+    isMobile: Je,
+    files: O,
     setFiles: W,
-    isNewChat: He,
+    isNewChat: Ke,
     conversationId: s,
-    restoreSession: _,
-    loadAndRestoreSession: Ve,
-    isSessionLoading: $e,
+    restoreSession: R,
+    loadAndRestoreSession: Te,
+    isSessionLoading: Be,
     authToken: d ? E : U,
     refreshSession: d ? oe : z,
-    getCaptchaHeader: I,
+    getCaptchaHeader: S,
     invalidateCaptcha: c,
-    inputNotification: je,
+    inputNotification: Ge,
     showInputNotification: we,
-    clearInputNotification: We
+    clearInputNotification: Qe
   };
 };
 export {
   te as DEFAULT_ERROR_MESSAGE,
-  zt as useInkeepChat
+  Kt as useInkeepChat
 };

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

@@ -0,0 +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;

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

@@ -0,0 +1,16 @@
+interface UseInitialConversationOptions {
+    /** The conversationId provided via props to load and restore. */
+    conversationId: string | undefined;
+    /** Resolved auth token — fetch is skipped until one is available. */
+    effectiveAuthToken: string | null;
+    /** 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. */
+    onLoadFailed?: () => void;
+}
+/**
+ * Loads and restores a conversation by ID once an auth token is available.
+ * Calls `onLoadFailed` if the conversation is not found or the fetch fails.
+ */
+export declare const useInitialConversation: ({ conversationId, effectiveAuthToken, loadAndRestoreSession, onLoadFailed, }: UseInitialConversationOptions) => void;
+export {};

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

@@ -0,0 +1,31 @@
+"use client";
+import { useRef as o, useEffect as f } from "react";
+const C = ({
+  conversationId: r,
+  effectiveAuthToken: l,
+  loadAndRestoreSession: s,
+  onLoadFailed: c
+}) => {
+  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;
+    t.current = r;
+    const e = new AbortController(), i = (n) => {
+      t.current = null, console.error("[useInitialConversation] failed to load conversation:", r, n), a.current?.();
+    };
+    return (async () => {
+      try {
+        !await u.current(r, e.signal) && !e.signal.aborted && i();
+      } catch (n) {
+        e.signal.aborted || i(n);
+      }
+    })(), () => {
+      t.current = null, e.abort();
+    };
+  }, [r, l]);
+};
+export {
+  C as useInitialConversation
+};

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

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

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

@@ -5,7 +5,7 @@ import { useInkeepConfig as g } from "./config-provider.js";
 const a = d(void 0), P = ({ children: e }) => {
   const { baseSettings: t, componentType: o } = g(), { tags: s, analyticsProperties: n } = t, r = u(
     () => ({
-      widgetLibraryVersion: "0.15.27",
+      widgetLibraryVersion: "0.15.28",
       componentType: o,
       tags: s
     }),

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

@@ -130,8 +130,15 @@ export interface InkeepAIChatSettings {
     /**
      * Unique identifier for loading a specific conversation.
      * Use this to restore a previous conversation state.
+     * If the conversation is not found, a new conversation is started.
      */
     conversationId?: string;
+    /**
+     * @deprecated Internal use only. Bypasses conversation loading and sets the
+     * conversation ID directly without fetching. Use `conversationId` instead to
+     * restore a previous conversation state.
+     */
+    conversationIdOverride?: string;
     /**
      * 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.15.27",
+  "version": "0.15.28",
   "description": "",
   "homepage": "",
   "repository": {