@inkeep/agents-ui 0.16.5 → 0.17.1

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 r(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}catch{return null}}function o(t){const e=r(t),s=n.parseAuthError(e??0,{detail:t.message??""});return s!==null?s:e===401?"session":null}function a(t){const e=r(t);return e===400||e===429}const u=`Hmm.. 
+"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.. 
 
-It seems I might be having some issues right now. Please clear the chat and try again.`,E="Please try again.",i="You're sending requests too quickly. Please wait a moment and try again.",c=8e3;exports.DEFAULT_ERROR_MESSAGE=u;exports.RATE_LIMIT_MESSAGE=i;exports.RECOVERABLE_FALLBACK_MESSAGE=E;exports.RECOVERABLE_NOTIFICATION_DURATION_MS=c;exports.isRecoverableError=a;exports.resolveHttpStatusCode=r;exports.resolveStreamingAuthError=o;
+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;

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

@@ -10,9 +10,10 @@ export interface ErrorWithCode extends Error {
  */
 export declare function resolveHttpStatusCode(error: Error): number | null;
 /**
- * Classifies a streaming-transport error as a PoW or session auth failure, or null.
+ * Classifies a streaming-transport error as a captcha (Sentinel) or session auth failure,
+ * or null.
  */
-export declare function resolveStreamingAuthError(error: Error): 'pow' | 'session' | null;
+export declare function resolveStreamingAuthError(error: Error): 'captcha' | 'session' | null;
 /**
  * Recoverable errors are input-validation failures where the user can fix
  * their input and retry without clearing the conversation.

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

@@ -10,9 +10,9 @@ function n(t) {
     return null;
   }
 }
-function a(t) {
+function o(t) {
   const e = n(t), s = r(e ?? 0, { detail: t.message ?? "" });
-  return s !== null ? s : e === 401 ? "session" : null;
+  return s !== null ? s : e === 401 ? "session" : e === 403 ? "captcha" : null;
 }
 function u(t) {
   const e = n(t);
@@ -28,5 +28,5 @@ export {
   m as RECOVERABLE_NOTIFICATION_DURATION_MS,
   u as isRecoverableError,
   n as resolveHttpStatusCode,
-  a as resolveStreamingAuthError
+  o as resolveStreamingAuthError
 };

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

@@ -1 +1 @@
-"use client";"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const w=require("altcha-lib"),c=require("react"),x=30*1e3;function b(l){const e=/[?&]expires=(\d+)/.exec(l);return e?Number.parseInt(e[1],10)*1e3:null}const p=async l=>{try{const e=await fetch(l,{method:"GET"});if(!e.ok)throw new Error(`Failed to fetch challenge: ${e.statusText}`);const i=await e.json(),{challenge:u,algorithm:n,salt:r,maxnumber:t}=i,{promise:g}=await w.solveChallenge(u,r,n,t),f=await g||void 0;if(!f)throw new Error("Challenge not solved");return{payload:{number:f.number,...i},expiresAt:b(r)}}catch(e){console.warn("[captcha] Error fetching/solving challenge:",e);return}},m=({baseUrl:l,shouldBypassCaptcha:e=!1,shouldMakeInitialRequest:i=!0})=>{const u=`${l}/run/auth/pow/challenge`,n=c.useRef(null),r=c.useRef(null),t=c.useCallback(()=>{const o=p(u);n.current=o,o.then(a=>{a&&(r.current=a.expiresAt)})},[u]),g=c.useCallback(async()=>{if(e)return{};n.current||t();const o=n.current;n.current=null,t();const a=n.current,h=await o;if(!h){const s=await a;return s?{"x-inkeep-challenge-solution":btoa(JSON.stringify(s.payload))}:{}}if(h.expiresAt!==null&&Date.now()>=h.expiresAt){const s=await a;return s?{"x-inkeep-challenge-solution":btoa(JSON.stringify(s.payload))}:{}}return{"x-inkeep-challenge-solution":btoa(JSON.stringify(h.payload))}},[e,t]),f=c.useCallback(()=>{e||t()},[e,t]);return c.useEffect(()=>{if(!i||e)return;const o=r.current!==null&&Date.now()>=r.current-x;(!n.current||o)&&t()},[i,e,t]),{getCaptchaHeader:g,invalidate:f}};exports.fetchAndSolveChallenge=p;exports.useCaptcha=m;
+"use client";"use strict";var A=Object.create;var w=Object.defineProperty;var S=Object.getOwnPropertyDescriptor;var P=Object.getOwnPropertyNames;var b=Object.getPrototypeOf,O=Object.prototype.hasOwnProperty;var L=(r,n,e,o)=>{if(n&&typeof n=="object"||typeof n=="function")for(let t of P(n))!O.call(r,t)&&t!==e&&w(r,t,{get:()=>n[t],enumerable:!(o=S(n,t))||o.enumerable});return r};var C=(r,n,e)=>(e=r!=null?A(b(r)):{},L(n||!r||!r.__esModule?w(e,"default",{value:r,enumerable:!0}):e,r));Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const f=require("react"),h="[sentinel]",x=45e3,M=3e4,N=3,D=5,F=250,I=4e3;let v=null;function Y(){return typeof customElements>"u"||customElements.get("altcha-widget")?Promise.resolve():v||(v=import("altcha").then(()=>customElements.whenDefined("altcha-widget")).then(()=>{}).catch(r=>{throw v=null,console.error(h,"failed to load altcha widget module",r),r instanceof Error?r:new Error("Failed to load altcha widget module")}),v)}function k(r){const n=document.createElement("div");n.style.cssText="position:fixed;left:-9999px;top:-9999px;width:0;height:0;overflow:hidden;pointer-events:none",document.body.appendChild(n);const e=document.createElement("altcha-widget");e.setAttribute("challenge",r),e.setAttribute("auto","onload"),e.setAttribute("hidefooter","true"),e.setAttribute("hidelogo","true"),e.setAttribute("configuration",JSON.stringify({disableAutoFocus:!0})),n.appendChild(e);let o=[],t,c="mounted",s=!1,E=!1,u=null,i=null,a=0,m=!1;const R=d=>{const l=o;o=[];for(const p of l)p(d)},g=()=>{s||m||(t=void 0,c="resetting",e.reset?.(),e.verify?.())},_=()=>{u&&clearTimeout(u),u=setTimeout(()=>{u=null,!(!s||m)&&(s=!1,a=0,t=void 0,c="resetting",e.reset?.(),e.verify?.())},M)},y=d=>{const l=d.detail;if(l&&(c=l.state??c,l.state==="verified"&&l.payload&&(E=!0,a=0,t=l.payload,R(l.payload)),l.state==="error"))if(t=void 0,a++,a>=(E?D:N))R(void 0),s=!0,console.warn(h,`Sentinel unavailable after ${a} consecutive errors, requests will proceed without bot protection`),_();else{const T=Math.min(F*2**(a-1),I);i&&clearTimeout(i),i=setTimeout(()=>{i=null,!(m||s)&&(c="resetting",e.reset?.(),e.verify?.())},T)}};return e.addEventListener("statechange",y),{getPayload:()=>{if(m||s)return Promise.resolve(void 0);if(t){const d=t;return t=void 0,g(),Promise.resolve(d)}return c==="verified"&&g(),new Promise(d=>{o.push(d),setTimeout(()=>{const l=o.indexOf(d);l!==-1&&(o.splice(l,1),d(void 0))},x)})},startNextSolve:g,destroy:()=>{m=!0,e.removeEventListener("statechange",y),u&&(clearTimeout(u),u=null),i&&(clearTimeout(i),i=null),R(void 0),n.remove()}}}const V=({baseUrl:r,appId:n,shouldBypassCaptcha:e=!1})=>{const o=f.useRef(null),t=f.useRef(null),c=f.useRef(!1),s=f.useCallback(()=>o.current?Promise.resolve():t.current?t.current:n?(t.current=Y().then(()=>{if(!c.current&&!o.current){const i=`${r}/run/auth/sentinel/challenge?appId=${encodeURIComponent(n)}`;o.current=k(i)}}).catch(i=>{console.error(h,"failed to mount widget",i),t.current=null}),t.current):Promise.resolve(),[r,n]);f.useEffect(()=>{if(c.current=!1,!e)return s(),()=>{c.current=!0,o.current?.destroy(),o.current=null,t.current=null}},[e,s]);const E=f.useCallback(async()=>{if(e)return{};await s();const i=o.current;if(!i)return{};const a=await i.getPayload();return a?{"x-inkeep-challenge-solution":btoa(JSON.stringify({payload:a}))}:{}},[e,s]),u=f.useCallback(()=>{o.current?.startNextSolve()},[]);return{getCaptchaHeader:E,invalidate:u}};exports.useCaptcha=V;

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

@@ -1,29 +1,9 @@
-import { Payload } from 'altcha-lib/types';
 interface UseCaptchaOptions {
     baseUrl: string;
+    appId: string | undefined;
     shouldBypassCaptcha?: boolean;
-    shouldMakeInitialRequest?: boolean;
 }
-interface SolvedEntry {
-    payload: Payload;
-    expiresAt: number | null;
-}
-export declare const fetchAndSolveChallenge: (fetchUrl: string) => Promise<SolvedEntry | undefined>;
-/**
- * Manages the PoW captcha lifecycle for /run/* API requests.
- *
- * - getCaptchaHeader(): atomically consumes the current pre-fetched challenge,
- *   immediately kicks off the next fetch so a fresh solution is always warm, and
- *   returns the ready-to-use `{ 'x-inkeep-challenge-solution': '...' }` header
- *   (or {} when bypassing or on failure). Checks token expiry and falls back to
- *   the already-started pre-fetch if the resolved token is stale.
- *
- * - invalidate(): discards any in-flight solution and starts a fresh fetch.
- *   Call this on request errors to recover from a rejected/stale challenge.
- *
- * All hooks are called unconditionally — bypass logic lives inside callbacks.
- */
-export declare const useCaptcha: ({ baseUrl, shouldBypassCaptcha, shouldMakeInitialRequest, }: UseCaptchaOptions) => {
+export declare const useCaptcha: ({ baseUrl, appId, shouldBypassCaptcha }: UseCaptchaOptions) => {
     getCaptchaHeader: () => Promise<Record<string, string>>;
     invalidate: () => void;
 };

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

@@ -1,67 +1,92 @@
 "use client";
-import { solveChallenge as m } from "altcha-lib";
-import { useRef as p, useCallback as h, useEffect as x } from "react";
-const w = 30 * 1e3;
-function E(i) {
-  const e = /[?&]expires=(\d+)/.exec(i);
-  return e ? Number.parseInt(e[1], 10) * 1e3 : null;
+import { useRef as R, useCallback as h, useEffect as A } from "react";
+const y = "[sentinel]", P = 45e3, S = 3e4, O = 3, b = 5, L = 250, x = 4e3;
+let m = null;
+function N() {
+  return typeof customElements > "u" || customElements.get("altcha-widget") ? Promise.resolve() : m || (m = import("altcha").then(() => customElements.whenDefined("altcha-widget")).then(() => {
+  }).catch((a) => {
+    throw m = null, console.error(y, "failed to load altcha widget module", a), a instanceof Error ? a : new Error("Failed to load altcha widget module");
+  }), m);
 }
-const y = async (i) => {
-  try {
-    const e = await fetch(i, { method: "GET" });
-    if (!e.ok)
-      throw new Error(`Failed to fetch challenge: ${e.statusText}`);
-    const c = await e.json(), { challenge: s, algorithm: t, salt: r, maxnumber: n } = c, { promise: g } = await m(
-      s,
-      r,
-      t,
-      n
-    ), u = await g || void 0;
-    if (!u)
-      throw new Error("Challenge not solved");
-    return {
-      payload: { number: u.number, ...c },
-      expiresAt: E(r)
-    };
-  } catch (e) {
-    console.warn("[captcha] Error fetching/solving challenge:", e);
-    return;
-  }
-}, k = ({
-  baseUrl: i,
-  shouldBypassCaptcha: e = !1,
-  shouldMakeInitialRequest: c = !0
-}) => {
-  const s = `${i}/run/auth/pow/challenge`, t = p(null), r = p(null), n = h(() => {
-    const o = y(s);
-    t.current = o, o.then((l) => {
-      l && (r.current = l.expiresAt);
-    });
-  }, [s]), g = h(async () => {
-    if (e) return {};
-    t.current || n();
-    const o = t.current;
-    t.current = null, n();
-    const l = t.current, f = await o;
-    if (!f) {
-      const a = await l;
-      return a ? { "x-inkeep-challenge-solution": btoa(JSON.stringify(a.payload)) } : {};
+function C(a) {
+  const d = document.createElement("div");
+  d.style.cssText = "position:fixed;left:-9999px;top:-9999px;width:0;height:0;overflow:hidden;pointer-events:none", document.body.appendChild(d);
+  const e = document.createElement("altcha-widget");
+  e.setAttribute("challenge", a), e.setAttribute("auto", "onload"), e.setAttribute("hidefooter", "true"), e.setAttribute("hidelogo", "true"), e.setAttribute("configuration", JSON.stringify({ disableAutoFocus: !0 })), d.appendChild(e);
+  let n = [], t, l = "mounted", i = !1, E = !1, s = null, r = null, c = 0, f = !1;
+  const v = (u) => {
+    const o = n;
+    n = [];
+    for (const w of o) w(u);
+  }, g = () => {
+    i || f || (t = void 0, l = "resetting", e.reset?.(), e.verify?.());
+  }, _ = () => {
+    s && clearTimeout(s), s = setTimeout(() => {
+      s = null, !(!i || f) && (i = !1, c = 0, t = void 0, l = "resetting", e.reset?.(), e.verify?.());
+    }, S);
+  }, p = (u) => {
+    const o = u.detail;
+    if (o && (l = o.state ?? l, o.state === "verified" && o.payload && (E = !0, c = 0, t = o.payload, v(o.payload)), o.state === "error"))
+      if (t = void 0, c++, c >= (E ? b : O))
+        v(void 0), i = !0, console.warn(
+          y,
+          `Sentinel unavailable after ${c} consecutive errors, requests will proceed without bot protection`
+        ), _();
+      else {
+        const T = Math.min(
+          L * 2 ** (c - 1),
+          x
+        );
+        r && clearTimeout(r), r = setTimeout(() => {
+          r = null, !(f || i) && (l = "resetting", e.reset?.(), e.verify?.());
+        }, T);
+      }
+  };
+  return e.addEventListener("statechange", p), { getPayload: () => {
+    if (f || i) return Promise.resolve(void 0);
+    if (t) {
+      const u = t;
+      return t = void 0, g(), Promise.resolve(u);
     }
-    if (f.expiresAt !== null && Date.now() >= f.expiresAt) {
-      const a = await l;
-      return a ? { "x-inkeep-challenge-solution": btoa(JSON.stringify(a.payload)) } : {};
+    return l === "verified" && g(), new Promise((u) => {
+      n.push(u), setTimeout(() => {
+        const o = n.indexOf(u);
+        o !== -1 && (n.splice(o, 1), u(void 0));
+      }, P);
+    });
+  }, startNextSolve: g, destroy: () => {
+    f = !0, e.removeEventListener("statechange", p), s && (clearTimeout(s), s = null), r && (clearTimeout(r), r = null), v(void 0), d.remove();
+  } };
+}
+const M = ({ baseUrl: a, appId: d, shouldBypassCaptcha: e = !1 }) => {
+  const n = R(null), t = R(null), l = R(!1), i = h(() => n.current ? Promise.resolve() : t.current ? t.current : d ? (t.current = N().then(() => {
+    if (!l.current && !n.current) {
+      const r = `${a}/run/auth/sentinel/challenge?appId=${encodeURIComponent(d)}`;
+      n.current = C(r);
     }
-    return { "x-inkeep-challenge-solution": btoa(JSON.stringify(f.payload)) };
-  }, [e, n]), u = h(() => {
-    e || n();
-  }, [e, n]);
-  return x(() => {
-    if (!c || e) return;
-    const o = r.current !== null && Date.now() >= r.current - w;
-    (!t.current || o) && n();
-  }, [c, e, n]), { getCaptchaHeader: g, invalidate: u };
+  }).catch((r) => {
+    console.error(y, "failed to mount widget", r), t.current = null;
+  }), t.current) : Promise.resolve(), [a, d]);
+  A(() => {
+    if (l.current = !1, !e)
+      return i(), () => {
+        l.current = !0, n.current?.destroy(), n.current = null, t.current = null;
+      };
+  }, [e, i]);
+  const E = h(async () => {
+    if (e) return {};
+    await i();
+    const r = n.current;
+    if (!r) return {};
+    const c = await r.getPayload();
+    return c ? {
+      "x-inkeep-challenge-solution": btoa(JSON.stringify({ payload: c }))
+    } : {};
+  }, [e, i]), s = h(() => {
+    n.current?.startNextSolve();
+  }, []);
+  return { getCaptchaHeader: E, invalidate: s };
 };
 export {
-  y as fetchAndSolveChallenge,
-  k as useCaptcha
+  M as useCaptcha
 };

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

@@ -294,7 +294,7 @@ export declare const EmbeddedChatPrimitiveFormFieldSelectTrigger: React.ForwardR
 declare const PrimitiveFormFieldSelectValue: React.ForwardRefExoticComponent< PolymorphicProps & Omit<SelectPrimitive.SelectValueProps & React.RefAttributes<HTMLSpanElement>, "_id"> & Partial<Pick<SelectPrimitive.SelectValueProps & React.RefAttributes<HTMLSpanElement>, "_id">>>;
 export declare const EmbeddedChatPrimitiveFormFieldSelectValue: (props: ComponentPropsWithRef<typeof PrimitiveFormFieldSelectValue>) => import("react/jsx-runtime").JSX.Element;
 export declare const EmbeddedChatPrimitiveFormFieldSelectIcon: React.ForwardRefExoticComponent< PolymorphicProps & Omit<SelectPrimitive.SelectIconProps & React.RefAttributes<HTMLSpanElement>, "children" | "asChild" | "_id"> & Partial<Pick<SelectPrimitive.SelectIconProps & React.RefAttributes<HTMLSpanElement>, "children" | "asChild" | "_id">>>;
-export declare const EmbeddedChatPrimitiveFormFieldSelectContent: React.ForwardRefExoticComponent< PolymorphicProps & Omit<SelectPrimitive.SelectContentProps & React.RefAttributes<HTMLDivElement>, "position" | "_id"> & Partial<Pick<SelectPrimitive.SelectContentProps & React.RefAttributes<HTMLDivElement>, "position" | "_id">>>;
+export declare const EmbeddedChatPrimitiveFormFieldSelectContent: React.ForwardRefExoticComponent< PolymorphicProps & Omit<SelectPrimitive.SelectContentProps & React.RefAttributes<HTMLDivElement>, "_id" | "position"> & Partial<Pick<SelectPrimitive.SelectContentProps & React.RefAttributes<HTMLDivElement>, "_id" | "position">>>;
 export declare const EmbeddedChatPrimitiveFormFieldSelectViewport: React.ForwardRefExoticComponent< PolymorphicProps & Omit<SelectPrimitive.SelectViewportProps & React.RefAttributes<HTMLDivElement>, "_id"> & Partial<Pick<SelectPrimitive.SelectViewportProps & React.RefAttributes<HTMLDivElement>, "_id">>>;
 export declare const EmbeddedChatPrimitiveFormFieldSelectItem: React.ForwardRefExoticComponent< PolymorphicProps & Omit<SelectPrimitive.SelectItemProps & React.RefAttributes<HTMLDivElement>, "_id"> & Partial<Pick<SelectPrimitive.SelectItemProps & React.RefAttributes<HTMLDivElement>, "_id">>>;
 export declare const EmbeddedChatPrimitiveFormFieldSelectItemText: React.ForwardRefExoticComponent< PolymorphicProps & Omit<SelectPrimitive.SelectItemTextProps & React.RefAttributes<HTMLSpanElement>, "_id"> & Partial<Pick<SelectPrimitive.SelectItemTextProps & React.RefAttributes<HTMLSpanElement>, "_id">>>;

package/dist/primitives/hooks/use-anonymous-session.cjs

@@ -1 +1 @@
-"use client";"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const e=require("react"),j=require("./use-local-storage.cjs"),p=require("./use-inkeep-api-client.cjs"),_=30*1e3,q=2147483647,P=()=>{},B=async()=>({});function x(s){return new Date(s.expiresAt).getTime()-_<=Date.now()}const W=({baseUrl:s,appId:t,getCaptchaHeader:$,invalidateCaptcha:D,optOutAllAnalytics:m,enabled:n=!0})=>{const F=n&&t&&!m?`inkeep_session_${t}`:null,[c,h]=j.useLocalStorage(F),E=e.useRef(n);e.useEffect(()=>{const r=E.current;if(E.current=n,r&&!n&&t&&!m){try{localStorage.removeItem(`inkeep_session_${t}`)}catch{}h(null)}},[n,t,m,h]);const{fetchWithAuth:v}=p.useInkeepApiClient({appId:t,authToken:void 0,getCaptchaHeader:$??B,invalidateCaptcha:D??P}),R=e.useRef(s);R.current=s;const y=e.useRef(t);y.current=t;const f=e.useRef(c);f.current=c;const T=e.useRef(h);T.current=h;const g=e.useRef(v);g.current=v;const a=e.useRef(null),w=e.useRef(n);w.current=n;const o=e.useCallback(async r=>{if(!w.current||!R.current||!y.current)return null;if(!r&&a.current)return a.current;const u=`${R.current}/run/auth/apps/${y.current}/anonymous-session`,l=(async()=>{try{const i={"Content-Type":"application/json"},M=f.current?.token;M&&(i.Authorization=`Bearer ${M}`);const A=await g.current(u,{method:"POST",headers:i,signal:r});if(!A.ok)throw new Error(`Failed to fetch anonymous session: ${A.status}`);const S=await A.json();return T.current({token:S.token,expiresAt:S.expiresAt}),S.token}catch(i){return i instanceof Error&&i.name==="AbortError"||console.error("[anonymous-session] fetch failed",i),null}finally{r||(a.current=null)}})();return r||(a.current=l),l},[]),C=e.useRef(!1);e.useEffect(()=>{if(!n||!s||!t)return;const r=!C.current;if(C.current=!0,!r&&f.current&&!x(f.current)||a.current)return;const u=new AbortController;return o(u.signal),()=>u.abort()},[s,t,n,o]),e.useEffect(()=>{if(!n||!s||!t||!c?.expiresAt)return;const k=new Date(c.expiresAt).getTime()-_-Date.now();if(k<=0)return;const l=setTimeout(()=>o(),Math.min(k,q));return()=>clearTimeout(l)},[s,t,n,c?.expiresAt,o]),e.useEffect(()=>{if(!n||!s||!t)return;const r=()=>{if(document.visibilityState!=="visible")return;const u=f.current;(!u||x(u))&&o()};return document.addEventListener("visibilitychange",r),()=>document.removeEventListener("visibilitychange",r)},[s,t,n,o]);const L=e.useCallback(()=>o(),[o]);return{sessionToken:c?.token??null,refreshSession:L}};exports.useAnonymousSession=W;
+"use client";"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const e=require("react"),P=require("./use-local-storage.cjs"),B=require("./use-inkeep-api-client.cjs"),D=30*1e3,W=2147483647,X=()=>{},v=async()=>({});function j(s){return new Date(s.expiresAt).getTime()-D<=Date.now()}const z=({baseUrl:s,appId:t,getCaptchaHeader:R,invalidateCaptcha:F,optOutAllAnalytics:m,enabled:n=!0})=>{const L=n&&t&&!m?`inkeep_session_${t}`:null,[i,h]=P.useLocalStorage(L),T=e.useRef(n);e.useEffect(()=>{const r=T.current;if(T.current=n,r&&!n&&t&&!m){try{localStorage.removeItem(`inkeep_session_${t}`)}catch{}h(null)}},[n,t,m,h]);const{fetchWithAuth:w}=B.useInkeepApiClient({appId:t,authToken:void 0,getCaptchaHeader:R??v,invalidateCaptcha:F??X}),k=e.useRef(s);k.current=s;const y=e.useRef(t);y.current=t;const f=e.useRef(i);f.current=i;const g=e.useRef(h);g.current=h;const M=e.useRef(w);M.current=w;const x=e.useRef(R??v);x.current=R??v;const a=e.useRef(null),C=e.useRef(n);C.current=n;const o=e.useCallback(async r=>{if(!C.current||!k.current||!y.current)return null;if(!r&&a.current)return a.current;const u=`${k.current}/run/auth/apps/${y.current}/anonymous-session`,l=(async()=>{try{const c={"Content-Type":"application/json"},$=f.current?.token;$&&(c.Authorization=`Bearer ${$}`);const q=await x.current();Object.assign(c,q);const S=await M.current(u,{method:"POST",headers:c,signal:r});if(!S.ok)throw new Error(`Failed to fetch anonymous session: ${S.status}`);const E=await S.json();return g.current({token:E.token,expiresAt:E.expiresAt}),E.token}catch(c){return c instanceof Error&&c.name==="AbortError"||console.error("[anon-session] fetch failed",c),null}finally{r||(a.current=null)}})();return r||(a.current=l),l},[]),_=e.useRef(!1);e.useEffect(()=>{if(!n||!s||!t)return;const r=!_.current;if(_.current=!0,!r&&f.current&&!j(f.current)||a.current)return;const u=new AbortController;return o(u.signal),()=>u.abort()},[s,t,n,o]),e.useEffect(()=>{if(!n||!s||!t||!i?.expiresAt)return;const A=new Date(i.expiresAt).getTime()-D-Date.now();if(A<=0)return;const l=setTimeout(()=>o(),Math.min(A,W));return()=>clearTimeout(l)},[s,t,n,i?.expiresAt,o]),e.useEffect(()=>{if(!n||!s||!t)return;const r=()=>{if(document.visibilityState!=="visible")return;const u=f.current;(!u||j(u))&&o()};return document.addEventListener("visibilitychange",r),()=>document.removeEventListener("visibilitychange",r)},[s,t,n,o]);const p=e.useCallback(()=>o(),[o]);return{sessionToken:i?.token??null,refreshSession:p}};exports.useAnonymousSession=z;

package/dist/primitives/hooks/use-anonymous-session.js

@@ -1,96 +1,101 @@
 "use client";
-import { useRef as o, useEffect as l, useCallback as g } from "react";
-import { useLocalStorage as B } from "./use-local-storage.js";
-import { useInkeepApiClient as P } from "./use-inkeep-api-client.js";
-const p = 30 * 1e3, W = 2147483647, X = () => {
-}, z = async () => ({});
-function $(n) {
-  return new Date(n.expiresAt).getTime() - p <= Date.now();
+import { useRef as o, useEffect as l, useCallback as D } from "react";
+import { useLocalStorage as X } from "./use-local-storage.js";
+import { useInkeepApiClient as z } from "./use-inkeep-api-client.js";
+const j = 30 * 1e3, H = 2147483647, K = () => {
+}, T = async () => ({});
+function F(n) {
+  return new Date(n.expiresAt).getTime() - j <= Date.now();
 }
-const Y = ({
+const G = ({
   baseUrl: n,
-  appId: e,
-  getCaptchaHeader: D,
-  invalidateCaptcha: F,
-  optOutAllAnalytics: k,
-  enabled: t = !0
+  appId: t,
+  getCaptchaHeader: k,
+  invalidateCaptcha: L,
+  optOutAllAnalytics: y,
+  enabled: e = !0
 }) => {
-  const L = t && e && !k ? `inkeep_session_${e}` : null, [c, h] = B(L), S = o(t);
+  const B = e && t && !y ? `inkeep_session_${t}` : null, [u, h] = X(B), w = o(e);
   l(() => {
-    const r = S.current;
-    if (S.current = t, r && !t && e && !k) {
+    const r = w.current;
+    if (w.current = e, r && !e && t && !y) {
       try {
-        localStorage.removeItem(`inkeep_session_${e}`);
+        localStorage.removeItem(`inkeep_session_${t}`);
       } catch {
       }
       h(null);
     }
-  }, [t, e, k, h]);
-  const { fetchWithAuth: T } = P({
-    appId: e,
+  }, [e, t, y, h]);
+  const { fetchWithAuth: x } = z({
+    appId: t,
     authToken: void 0,
-    getCaptchaHeader: D ?? z,
-    invalidateCaptcha: F ?? X
-  }), y = o(n);
-  y.current = n;
-  const A = o(e);
-  A.current = e;
-  const f = o(c);
-  f.current = c;
-  const w = o(h);
-  w.current = h;
-  const x = o(T);
-  x.current = T;
-  const a = o(null), M = o(t);
-  M.current = t;
-  const s = g(async (r) => {
-    if (!M.current || !y.current || !A.current) return null;
+    getCaptchaHeader: k ?? T,
+    invalidateCaptcha: L ?? K
+  }), A = o(n);
+  A.current = n;
+  const R = o(t);
+  R.current = t;
+  const f = o(u);
+  f.current = u;
+  const M = o(h);
+  M.current = h;
+  const _ = o(x);
+  _.current = x;
+  const g = o(k ?? T);
+  g.current = k ?? T;
+  const a = o(null), C = o(e);
+  C.current = e;
+  const s = D(async (r) => {
+    if (!C.current || !A.current || !R.current) return null;
     if (!r && a.current)
       return a.current;
-    const i = `${y.current}/run/auth/apps/${A.current}/anonymous-session`, m = (async () => {
+    const c = `${A.current}/run/auth/apps/${R.current}/anonymous-session`, m = (async () => {
       try {
-        const u = { "Content-Type": "application/json" }, _ = f.current?.token;
-        _ && (u.Authorization = `Bearer ${_}`);
-        const v = await x.current(i, {
+        const i = { "Content-Type": "application/json" }, p = f.current?.token;
+        p && (i.Authorization = `Bearer ${p}`);
+        const W = await g.current();
+        Object.assign(i, W);
+        const E = await _.current(c, {
           method: "POST",
-          headers: u,
+          headers: i,
           signal: r
         });
-        if (!v.ok) throw new Error(`Failed to fetch anonymous session: ${v.status}`);
-        const E = await v.json();
-        return w.current({ token: E.token, expiresAt: E.expiresAt }), E.token;
-      } catch (u) {
-        return u instanceof Error && u.name === "AbortError" || console.error("[anonymous-session] fetch failed", u), null;
+        if (!E.ok)
+          throw new Error(`Failed to fetch anonymous session: ${E.status}`);
+        const S = await E.json();
+        return M.current({ token: S.token, expiresAt: S.expiresAt }), S.token;
+      } catch (i) {
+        return i instanceof Error && i.name === "AbortError" || console.error("[anon-session] fetch failed", i), null;
       } finally {
         r || (a.current = null);
       }
     })();
     return r || (a.current = m), m;
-  }, []), C = o(!1);
+  }, []), $ = o(!1);
   l(() => {
-    if (!t || !n || !e) return;
-    const r = !C.current;
-    if (C.current = !0, !r && f.current && !$(f.current) || a.current) return;
-    const i = new AbortController();
-    return s(i.signal), () => i.abort();
-  }, [n, e, t, s]), l(() => {
-    if (!t || !n || !e || !c?.expiresAt) return;
-    const R = new Date(c.expiresAt).getTime() - p - Date.now();
-    if (R <= 0) return;
-    const m = setTimeout(() => s(), Math.min(R, W));
+    if (!e || !n || !t) return;
+    const r = !$.current;
+    if ($.current = !0, !r && f.current && !F(f.current) || a.current) return;
+    const c = new AbortController();
+    return s(c.signal), () => c.abort();
+  }, [n, t, e, s]), l(() => {
+    if (!e || !n || !t || !u?.expiresAt) return;
+    const v = new Date(u.expiresAt).getTime() - j - Date.now();
+    if (v <= 0) return;
+    const m = setTimeout(() => s(), Math.min(v, H));
     return () => clearTimeout(m);
-  }, [n, e, t, c?.expiresAt, s]), l(() => {
-    if (!t || !n || !e) return;
+  }, [n, t, e, u?.expiresAt, s]), l(() => {
+    if (!e || !n || !t) return;
     const r = () => {
       if (document.visibilityState !== "visible") return;
-      const i = f.current;
-      (!i || $(i)) && s();
+      const c = f.current;
+      (!c || F(c)) && s();
     };
     return document.addEventListener("visibilitychange", r), () => document.removeEventListener("visibilitychange", r);
-  }, [n, e, t, s]);
-  const j = g(() => s(), [s]);
-  return { sessionToken: c?.token ?? null, refreshSession: j };
+  }, [n, t, e, s]);
+  const P = D(() => s(), [s]);
+  return { sessionToken: u?.token ?? null, refreshSession: P };
 };
 export {
-  Y as useAnonymousSession
+  G as useAnonymousSession
 };

package/dist/primitives/hooks/use-inkeep-api-client.cjs

@@ -1 +1 @@
-"use client";"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const u=require("react");function y(e,r){if(e===400&&typeof r=="object"&&r!==null){const t=(r.detail??"").toLowerCase();if(t.includes("challenge")||t.includes("proof-of-work"))return"pow"}if(e===401&&typeof r=="object"&&r!==null){const t=r.detail??"";if(t.includes("Invalid end-user JWT")||t.includes("Bearer token required"))return"session"}return null}function H(e){if(!e)return{};if(e instanceof Headers){const r={};return e.forEach((t,c)=>{r[c]=t}),r}return Array.isArray(e)?Object.fromEntries(e):e}function p(e,r,t,c){return{...e?{"x-inkeep-app-id":e}:{},...r?{Authorization:`Bearer ${r}`}:{},...H(c),...t}}function g({appId:e,authToken:r,getCaptchaHeader:t,invalidateCaptcha:c,refreshSession:R}){const a=u.useRef(e);a.current=e;const i=u.useRef(r);i.current=r;const o=u.useRef(t);o.current=t;const w=u.useRef(c);w.current=c;const h=u.useRef(R);return h.current=R,{fetchWithAuth:u.useCallback(async(l,s)=>{const C=await o.current(),j=p(a.current,i.current,C,s?.headers),n=await fetch(l,{...s,headers:j});if(n.status!==400&&n.status!==401)return n;let A;try{A=await n.clone().json()}catch{return n}const k=y(n.status,A);if(k==="pow"){w.current();const f=await o.current(),d=p(a.current,i.current,f,s?.headers);return fetch(l,{...s,headers:d})}if(k==="session"&&h.current){const f=await h.current();if(!f)return n;const d=await o.current(),E=p(a.current,f,d,s?.headers);return fetch(l,{...s,headers:E})}return n},[])}}exports.parseAuthError=y;exports.useInkeepApiClient=g;
+"use client";"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const u=require("react");function w(r,e){if(r===400&&typeof e=="object"&&e!==null){const t=(e.detail??"").toLowerCase();if(t.includes("challenge")||t.includes("bot protection")||t.includes("proof-of-work"))return"captcha"}if(r===401&&typeof e=="object"&&e!==null){const t=e.detail??"";if(t.includes("Invalid end-user JWT")||t.includes("Bearer token required"))return"session"}return r===403&&typeof e=="object"&&e!==null&&(e.detail??"").toLowerCase().includes("bot protection")?"captcha":null}function E(r){if(!r)return{};if(r instanceof Headers){const e={};return r.forEach((t,c)=>{e[c]=t}),e}return Array.isArray(r)?Object.fromEntries(r):r}function A(r,e,t,c){return{...r?{"x-inkeep-app-id":r}:{},...e?{Authorization:`Bearer ${e}`}:{},...E(c),...t}}function g({appId:r,authToken:e,getCaptchaHeader:t,invalidateCaptcha:c,refreshSession:i}){const o=u.useRef(r);o.current=r;const f=u.useRef(e);f.current=e;const j=u.useRef(t);j.current=t;const l=u.useRef(c);l.current=c;const a=u.useRef(i);return a.current=i,{fetchWithAuth:u.useCallback(async(d,s)=>{const k=A(o.current,f.current,{},s?.headers),n=await fetch(d,{...s,headers:k});if(n.status!==400&&n.status!==401&&n.status!==403)return n;let h;try{h=await n.clone().json()}catch{return n}const p=w(n.status,h);if(p==="captcha")return l.current(),n;if(p==="session"&&a.current){const R=await a.current();if(!R)return n;const C=A(o.current,R,{},s?.headers);return fetch(d,{...s,headers:C})}return n},[])}}exports.parseAuthError=w;exports.useInkeepApiClient=g;

package/dist/primitives/hooks/use-inkeep-api-client.d.ts

@@ -15,10 +15,15 @@ interface UseInkeepApiClientOptions {
  * Parses an API error response body to determine the failure type.
  *
  * The Run API returns:
- *   - 400 + detail containing "challenge" or "proof-of-work" → PoW failure
- *   - 401 + detail matching JWT/bearer messages              → session token failure
+ *   - 400 + detail containing "challenge" or "bot protection"        → captcha format failure
+ *   - 401 + detail matching JWT/bearer messages                      → session token failure
+ *   - 403 + detail containing "bot protection verification failed"   → captcha rejected
+ *     (Sentinel classified as bot OR payload was replayed)
+ *
+ * Legacy "proof-of-work" wording is still matched so older server versions are handled
+ * gracefully during the rolling deploy window.
  */
-export declare function parseAuthError(status: number, body: unknown): 'pow' | 'session' | null;
+export declare function parseAuthError(status: number, body: unknown): 'captcha' | 'session' | null;
 /**
  * Returns a stable `fetchWithAuth` function that automatically:
  * - Injects auth headers (x-inkeep-app-id, Authorization, x-inkeep-challenge-solution)

package/dist/primitives/hooks/use-inkeep-api-client.js

@@ -1,87 +1,75 @@
 "use client";
-import { useRef as u, useCallback as y } from "react";
-function E(e, r) {
-  if (e === 400 && typeof r == "object" && r !== null) {
-    const t = (r.detail ?? "").toLowerCase();
-    if (t.includes("challenge") || t.includes("proof-of-work")) return "pow";
+import { useRef as s, useCallback as C } from "react";
+function E(r, e) {
+  if (r === 400 && typeof e == "object" && e !== null) {
+    const t = (e.detail ?? "").toLowerCase();
+    if (t.includes("challenge") || t.includes("bot protection") || t.includes("proof-of-work"))
+      return "captcha";
   }
-  if (e === 401 && typeof r == "object" && r !== null) {
-    const t = r.detail ?? "";
+  if (r === 401 && typeof e == "object" && e !== null) {
+    const t = e.detail ?? "";
     if (t.includes("Invalid end-user JWT") || t.includes("Bearer token required"))
       return "session";
   }
-  return null;
+  return r === 403 && typeof e == "object" && e !== null && (e.detail ?? "").toLowerCase().includes("bot protection") ? "captcha" : null;
 }
-function m(e) {
-  if (!e) return {};
-  if (e instanceof Headers) {
-    const r = {};
-    return e.forEach((t, c) => {
-      r[c] = t;
-    }), r;
+function m(r) {
+  if (!r) return {};
+  if (r instanceof Headers) {
+    const e = {};
+    return r.forEach((t, c) => {
+      e[c] = t;
+    }), e;
   }
-  return Array.isArray(e) ? Object.fromEntries(e) : e;
+  return Array.isArray(r) ? Object.fromEntries(r) : r;
 }
-function p(e, r, t, c) {
+function A(r, e, t, c) {
   return {
-    ...e ? { "x-inkeep-app-id": e } : {},
-    ...r ? { Authorization: `Bearer ${r}` } : {},
+    ...r ? { "x-inkeep-app-id": r } : {},
+    ...e ? { Authorization: `Bearer ${e}` } : {},
     ...m(c),
     // captcha last — must not be overridden by caller headers
     ...t
   };
 }
-function x({
-  appId: e,
-  authToken: r,
+function W({
+  appId: r,
+  authToken: e,
   getCaptchaHeader: t,
   invalidateCaptcha: c,
-  refreshSession: w
+  refreshSession: i
 }) {
-  const a = u(e);
-  a.current = e;
-  const i = u(r);
-  i.current = r;
-  const o = u(t);
-  o.current = t;
-  const A = u(c);
-  A.current = c;
-  const h = u(w);
-  return h.current = w, { fetchWithAuth: y(async (d, s) => {
-    const C = await o.current(), H = p(
-      a.current,
-      i.current,
-      C,
-      s?.headers
-    ), n = await fetch(d, { ...s, headers: H });
-    if (n.status !== 400 && n.status !== 401) return n;
-    let R;
+  const o = s(r);
+  o.current = r;
+  const f = s(e);
+  f.current = e;
+  const R = s(t);
+  R.current = t;
+  const l = s(c);
+  l.current = c;
+  const a = s(i);
+  return a.current = i, { fetchWithAuth: C(async (h, u) => {
+    const j = A(o.current, f.current, {}, u?.headers), n = await fetch(h, { ...u, headers: j });
+    if (n.status !== 400 && n.status !== 401 && n.status !== 403) return n;
+    let d;
     try {
-      R = await n.clone().json();
+      d = await n.clone().json();
     } catch {
       return n;
     }
-    const k = E(n.status, R);
-    if (k === "pow") {
-      A.current();
-      const f = await o.current(), l = p(
-        a.current,
-        i.current,
-        f,
-        s?.headers
-      );
-      return fetch(d, { ...s, headers: l });
-    }
-    if (k === "session" && h.current) {
-      const f = await h.current();
-      if (!f) return n;
-      const l = await o.current(), j = p(a.current, f, l, s?.headers);
-      return fetch(d, { ...s, headers: j });
+    const p = E(n.status, d);
+    if (p === "captcha")
+      return l.current(), n;
+    if (p === "session" && a.current) {
+      const w = await a.current();
+      if (!w) return n;
+      const k = A(o.current, w, {}, u?.headers);
+      return fetch(h, { ...u, headers: k });
     }
     return n;
   }, []) };
 }
 export {
   E as parseAuthError,
-  x as useInkeepApiClient
+  W as useInkeepApiClient
 };

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.16.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.1",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.16.5", i = d(
+  const { baseSettings: t, componentType: o } = x(), { tags: s, analyticsProperties: n } = t, r = "0.17.1", i = d(
     () => ({
       widgetLibraryVersion: r,
       componentType: o,

package/dist/primitives/providers/chat-auth-provider.cjs

@@ -1 +1 @@
-"use client";"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const S=require("react/jsx-runtime"),d=require("react"),T=require("./config-provider.cjs"),O=require("../components/modal/modal-provider.cjs"),m=require("./chat-bubble-provider.cjs"),x=require("./sidebar-chat-provider.cjs"),B=require("../hooks/use-auth-token.cjs"),R=require("../components/embedded-chat/use-captcha.cjs"),w=require("../hooks/use-anonymous-session.cjs"),l=d.createContext(void 0),I=({children:e})=>{const{baseSettings:n,aiChatSettings:p}=T.useInkeepConfig(),{shouldBypassCaptcha:C,privacyPreferences:A}=n,{baseUrl:i,appId:b,apiKey:s}=p,v=O.useModal(),f=m.useOptionalChatBubble(),g=x.useOptionalSidebarChat(),k=v?.isOpen??f?.isOpen??g?.isOpen??!0,{authToken:o,isLoading:a,refreshToken:q}=B.useAuthToken(),y=!!n.getAuthToken,t=!!o,{getCaptchaHeader:r,invalidate:u}=R.useCaptcha({baseUrl:i,shouldBypassCaptcha:C||!!s,shouldMakeInitialRequest:k}),{sessionToken:c,refreshSession:h}=w.useAnonymousSession({baseUrl:i,appId:b,getCaptchaHeader:r,invalidateCaptcha:u,optOutAllAnalytics:A?.optOutAllAnalytics,enabled:!t&&!a}),P={authToken:o,isAuthenticated:t,isAuthLoading:a,isAuthConfigured:y,refreshAuthToken:q,sessionToken:c,refreshSession:h,getCaptchaHeader:r,invalidateCaptcha:u,effectiveAuthToken:s??(t?o:c),applicableRefreshSession:s||t?void 0:h};return S.jsx(l.Provider,{value:P,children:e})},j=()=>{const e=d.useContext(l);if(!e)throw new Error("useChatAuth must be used within a ChatAuthProvider");return e};exports.ChatAuthProvider=I;exports.useChatAuth=j;
+"use client";"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const y=require("react/jsx-runtime"),d=require("react"),T=require("./config-provider.cjs"),S=require("../hooks/use-auth-token.cjs"),b=require("../components/embedded-chat/use-captcha.cjs"),P=require("../hooks/use-anonymous-session.cjs"),l=d.createContext(void 0),q=({children:e})=>{const{baseSettings:o,aiChatSettings:p}=T.useInkeepConfig(),{shouldBypassCaptcha:C,privacyPreferences:f}=o,{baseUrl:i,appId:u,apiKey:s}=p,{authToken:n,isLoading:a,refreshToken:v}=S.useAuthToken(),g=!!o.getAuthToken,t=!!n,{getCaptchaHeader:r,invalidate:c}=b.useCaptcha({baseUrl:i,appId:u,shouldBypassCaptcha:C||!!s}),{sessionToken:h,refreshSession:A}=P.useAnonymousSession({baseUrl:i,appId:u,getCaptchaHeader:r,invalidateCaptcha:c,optOutAllAnalytics:f?.optOutAllAnalytics,enabled:!t&&!a}),k={authToken:n,isAuthenticated:t,isAuthLoading:a,isAuthConfigured:g,refreshAuthToken:v,sessionToken:h,refreshSession:A,getCaptchaHeader:r,invalidateCaptcha:c,effectiveAuthToken:s??(t?n:h),applicableRefreshSession:s||t?void 0:A};return y.jsx(l.Provider,{value:k,children:e})},x=()=>{const e=d.useContext(l);if(!e)throw new Error("useChatAuth must be used within a ChatAuthProvider");return e};exports.ChatAuthProvider=q;exports.useChatAuth=x;

package/dist/primitives/providers/chat-auth-provider.js

@@ -1,46 +1,43 @@
 "use client";
-import { jsx as T } from "react/jsx-runtime";
-import { useContext as y, createContext as S } from "react";
-import { useInkeepConfig as x } from "./config-provider.js";
-import { useModal as w } from "../components/modal/modal-provider.js";
-import { useOptionalChatBubble as B } from "./chat-bubble-provider.js";
-import { useOptionalSidebarChat as I } from "./sidebar-chat-provider.js";
-import { useAuthToken as P } from "../hooks/use-auth-token.js";
-import { useCaptcha as R } from "../components/embedded-chat/use-captcha.js";
-import { useAnonymousSession as L } from "../hooks/use-anonymous-session.js";
-const p = S(void 0), J = ({ children: t }) => {
-  const { baseSettings: n, aiChatSettings: l } = x(), { shouldBypassCaptcha: d, privacyPreferences: f } = n, { baseUrl: i, appId: m, apiKey: o } = l, C = w(), A = B(), b = I(), v = C?.isOpen ?? A?.isOpen ?? b?.isOpen ?? !0, { authToken: s, isLoading: a, refreshToken: k } = P(), g = !!n.getAuthToken, e = !!s, { getCaptchaHeader: r, invalidate: u } = R({
+import { jsx as k } from "react/jsx-runtime";
+import { useContext as g, createContext as T } from "react";
+import { useInkeepConfig as y } from "./config-provider.js";
+import { useAuthToken as b } from "../hooks/use-auth-token.js";
+import { useCaptcha as x } from "../components/embedded-chat/use-captcha.js";
+import { useAnonymousSession as S } from "../hooks/use-anonymous-session.js";
+const f = T(void 0), E = ({ children: t }) => {
+  const { baseSettings: n, aiChatSettings: l } = y(), { shouldBypassCaptcha: A, privacyPreferences: d } = n, { baseUrl: i, appId: a, apiKey: o } = l, { authToken: s, isLoading: r, refreshToken: C } = b(), m = !!n.getAuthToken, e = !!s, { getCaptchaHeader: h, invalidate: u } = x({
     baseUrl: i,
-    shouldBypassCaptcha: d || !!o,
-    shouldMakeInitialRequest: v
-  }), { sessionToken: h, refreshSession: c } = L({
+    appId: a,
+    shouldBypassCaptcha: A || !!o
+  }), { sessionToken: c, refreshSession: p } = S({
     baseUrl: i,
-    appId: m,
-    getCaptchaHeader: r,
+    appId: a,
+    getCaptchaHeader: h,
     invalidateCaptcha: u,
-    optOutAllAnalytics: f?.optOutAllAnalytics,
-    enabled: !e && !a
-  }), O = {
+    optOutAllAnalytics: d?.optOutAllAnalytics,
+    enabled: !e && !r
+  }), v = {
     authToken: s,
     isAuthenticated: e,
-    isAuthLoading: a,
-    isAuthConfigured: g,
-    refreshAuthToken: k,
-    sessionToken: h,
-    refreshSession: c,
-    getCaptchaHeader: r,
+    isAuthLoading: r,
+    isAuthConfigured: m,
+    refreshAuthToken: C,
+    sessionToken: c,
+    refreshSession: p,
+    getCaptchaHeader: h,
     invalidateCaptcha: u,
-    effectiveAuthToken: o ?? (e ? s : h),
-    applicableRefreshSession: o || e ? void 0 : c
+    effectiveAuthToken: o ?? (e ? s : c),
+    applicableRefreshSession: o || e ? void 0 : p
   };
-  return /* @__PURE__ */ T(p.Provider, { value: O, children: t });
-}, N = () => {
-  const t = y(p);
+  return /* @__PURE__ */ k(f.Provider, { value: v, children: t });
+}, H = () => {
+  const t = g(f);
   if (!t)
     throw new Error("useChatAuth must be used within a ChatAuthProvider");
   return t;
 };
 export {
-  J as ChatAuthProvider,
-  N as useChatAuth
+  E as ChatAuthProvider,
+  H as useChatAuth
 };

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.16.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.1",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.16.5", a = x(
+  const { baseSettings: r, aiChatSettings: g, componentType: i } = N(), { tags: t, analyticsProperties: n, privacyPreferences: f, userProperties: o } = r, c = "0.17.1", a = x(
     () => ({
       widgetLibraryVersion: c,
       componentType: i

package/dist/react/embedded-search-and-chat.d.ts

@@ -5,6 +5,31 @@ export interface InkeepEmbeddedSearchAndChatFunctions {
     setView: (view: ModalViewTypes) => void;
 }
 export interface InkeepEmbeddedSearchAndChatProps extends Partial<Omit<InkeepConfig, 'componentType'>>, WidgetView {
+    /**
+     * Callback fired when the user selects "Ask AI" — via the Ask AI card or the
+     * Search/Ask AI toggle.
+     *
+     * When provided, this replaces the default behavior of switching to the
+     * component's internal chat view. The internal chat pane is not shown and no
+     * message is submitted to it; instead the parent handles the Ask AI intent
+     * (for example, closing the modal and opening a separate sidebar chat).
+     *
+     * `query` is the current search input, so the parent can autofill or submit it
+     * in the destination chat.
+     *
+     * `autoSubmit` reflects the user's intent based on how they selected Ask AI:
+     * `true` when they clicked the Ask AI card (a query-specific action), and
+     * `false`/`undefined` when they used the Search/Ask AI toggle (a mode switch).
+     * Honor it to decide between auto-submitting and only filling in the query.
+     *
+     * Precedence: this takes full ownership of the Ask AI intent. When it is
+     * provided, `onToggleView` is NOT called for `view: 'chat'` selections and the
+     * internal view does not change. `onToggleView` still fires for `view: 'search'`.
+     */
+    onSelectAskAI?: (opts: {
+        query?: string;
+        autoSubmit?: boolean;
+    }) => void;
     /**
      * The default view to show when the widget is loaded.
      * @default 'search'

package/dist/react/embedded-search-and-chat.impl.cjs

@@ -1 +1 @@
-"use client";"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const t=require("react"),a=require("./utils.cjs");function p(f){const{defaultView:u="search",aiChatSettings:i,baseSettings:g,searchSettings:o,shouldAutoFocusInput:l=!0,onToggleView:h,ref:R,...S}=f,s=t.useRef(null),m=a.composeRefs(s,i?.chatFunctionsRef),r=t.useRef(null),d=a.composeRefs(r,o?.searchFunctionsRef),w={...i,chatFunctionsRef:m},I={...o,searchFunctionsRef:d},[n,c]=t.useState(u),b=e=>{e.autoSubmit&&e.query&&s.current?.submitMessage(e.query),h?.(e),c(e.view)};return t.useImperativeHandle(R,()=>({setView:c})),t.useEffect(()=>{n==="chat"?s.current?.focusInput():r.current?.focusInput()},[n]),{config:{baseSettings:g,aiChatSettings:w,searchSettings:I},defaultView:u,view:n,setView:c,onToggleView:b,shouldAutoFocusInput:l,...S}}exports.useWidgetImpl=p;
+"use client";"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const t=require("react"),f=require("./utils.cjs");function y(g){const{defaultView:c="search",aiChatSettings:i,baseSettings:l,searchSettings:o,shouldAutoFocusInput:h=!0,onToggleView:S,onSelectAskAI:r,ref:R,...m}=g,s=t.useRef(null),w=f.composeRefs(s,i?.chatFunctionsRef),a=t.useRef(null),b=f.composeRefs(a,o?.searchFunctionsRef),d={...i,chatFunctionsRef:w},I={...o,searchFunctionsRef:b},[n,u]=t.useState(c),q=e=>{if(e.view==="chat"&&r){r({query:e.query,autoSubmit:e.autoSubmit});return}e.autoSubmit&&e.query&&s.current?.submitMessage(e.query),S?.(e),u(e.view)};return t.useImperativeHandle(R,()=>({setView:u})),t.useEffect(()=>{n==="chat"?s.current?.focusInput():a.current?.focusInput()},[n]),{config:{baseSettings:l,aiChatSettings:d,searchSettings:I},defaultView:c,view:n,setView:u,onToggleView:q,shouldAutoFocusInput:h,...m}}exports.useWidgetImpl=y;

package/dist/react/embedded-search-and-chat.impl.js

@@ -1,43 +1,48 @@
 "use client";
-import { useRef as r, useState as V, useImperativeHandle as d, useEffect as b } from "react";
-import { composeRefs as a } from "./utils.js";
-function _(f) {
+import { useRef as a, useState as d, useImperativeHandle as q, useEffect as v } from "react";
+import { composeRefs as f } from "./utils.js";
+function T(g) {
   const {
     defaultView: c = "search",
-    aiChatSettings: i,
-    baseSettings: g,
-    searchSettings: o,
-    shouldAutoFocusInput: h = !0,
-    onToggleView: l,
+    aiChatSettings: u,
+    baseSettings: h,
+    searchSettings: i,
+    shouldAutoFocusInput: l = !0,
+    onToggleView: S,
+    onSelectAskAI: o,
     ref: m,
-    ...S
-  } = f, t = r(null), R = a(t, i?.chatFunctionsRef), u = r(null), w = a(u, o?.searchFunctionsRef), p = {
-    ...i,
+    ...w
+  } = g, t = a(null), R = f(t, u?.chatFunctionsRef), r = a(null), I = f(r, i?.searchFunctionsRef), b = {
+    ...u,
     chatFunctionsRef: R
   }, F = {
-    ...o,
-    searchFunctionsRef: w
-  }, [n, s] = V(c), I = (e) => {
-    e.autoSubmit && e.query && t.current?.submitMessage(e.query), l?.(e), s(e.view);
+    ...i,
+    searchFunctionsRef: I
+  }, [n, s] = d(c), V = (e) => {
+    if (e.view === "chat" && o) {
+      o({ query: e.query, autoSubmit: e.autoSubmit });
+      return;
+    }
+    e.autoSubmit && e.query && t.current?.submitMessage(e.query), S?.(e), s(e.view);
   };
-  return d(m, () => ({
+  return q(m, () => ({
     setView: s
-  })), b(() => {
-    n === "chat" ? t.current?.focusInput() : u.current?.focusInput();
+  })), v(() => {
+    n === "chat" ? t.current?.focusInput() : r.current?.focusInput();
   }, [n]), {
     config: {
-      baseSettings: g,
-      aiChatSettings: p,
+      baseSettings: h,
+      aiChatSettings: b,
       searchSettings: F
     },
     defaultView: c,
     view: n,
     setView: s,
-    onToggleView: I,
-    shouldAutoFocusInput: h,
-    ...S
+    onToggleView: V,
+    shouldAutoFocusInput: l,
+    ...w
   };
 }
 export {
-  _ as useWidgetImpl
+  T as useWidgetImpl
 };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@inkeep/agents-ui",
-  "version": "0.16.5",
+  "version": "0.17.1",
   "description": "",
   "homepage": "",
   "repository": {
@@ -72,7 +72,7 @@
     "@zag-js/react": "^1.38.1",
     "@zag-js/remove-scroll": "^1.38.1",
     "ai": "6.0.44",
-    "altcha-lib": "^1.2.0",
+    "altcha": "^3.0.9",
     "aria-hidden": "^1.2.4",
     "class-variance-authority": "0.7.1",
     "clsx": "2.1.1",