@inkeep/agents-ui 0.0.0-dev-20260528131439 → 0.0.0-dev-20260528142533

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/use-captcha.cjs

@@ -1 +1 @@
-"use client";"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const u=require("react"),m="[sentinel]",g="https://cdn.jsdelivr.net/npm/altcha@3.0.9/dist/main/altcha.min.js",v="sha384-SAvZpYmIwEwxkbER1dijvBKm10sobAn/28KXy+Z7/lGbsCshTPhYrFJ2kU7LKiFM",p=1e4;let f=null;function w(){if(typeof customElements>"u"||customElements.get("altcha-widget"))return Promise.resolve();if(f)return f;const a=r=>e=>{f=null,r(e)};return f=new Promise((r,e)=>{const t=a(e);if(document.querySelector(`script[src="${g}"]`)){customElements.whenDefined("altcha-widget").then(()=>r()).catch(t);return}const n=document.createElement("script");n.src=g,n.integrity=v,n.crossOrigin="anonymous",n.type="module",n.async=!0,n.onload=()=>{customElements.whenDefined("altcha-widget").then(()=>r()).catch(()=>t(new Error("altcha-widget custom element never registered")))},n.onerror=()=>{console.error(m,"failed to load widget script"),t(new Error("Failed to load altcha-widget script"))},document.head.appendChild(n)}),f}function y(a){const r=document.createElement("div");r.style.cssText="position:fixed;left:-9999px;top:-9999px;width:0;height:0;overflow:hidden;pointer-events:none",document.body.appendChild(r);const e=document.createElement("altcha-widget");e.setAttribute("challenge",a),e.setAttribute("auto","onload"),e.setAttribute("hidefooter","true"),e.setAttribute("hidelogo","true"),r.appendChild(e);let t=null,i,n="mounted",d=!1,o=!1;const c=()=>{d||(i=void 0,n="resetting",e.reset?.(),e.verify?.())},h=l=>{const s=l.detail;s&&(n=s.state??n,s.state==="verified"&&s.payload&&(o=!0,i=s.payload,t&&(t(s.payload),t=null)),s.state==="error"&&(i=void 0,t&&(t(void 0),t=null),o||(d=!0,console.warn(m,"Sentinel unavailable, requests will proceed without bot protection"))))};return e.addEventListener("statechange",h),{getPayload:()=>{if(d)return Promise.resolve(void 0);if(i){const l=i;return i=void 0,c(),Promise.resolve(l)}return n==="verified"&&c(),new Promise(l=>{t=l,setTimeout(()=>{t===l&&(t=null,l(void 0))},p)})},startNextSolve:c,destroy:()=>{e.removeEventListener("statechange",h),t=null,r.remove()}}}const E=({baseUrl:a,shouldBypassCaptcha:r=!1})=>{const e=u.useRef(null),t=u.useRef(null),i=u.useCallback(()=>e.current?Promise.resolve():(t.current||(t.current=w().then(()=>{if(!e.current){const o=`${a}/run/auth/sentinel/challenge`;e.current=y(o)}}).catch(o=>{console.error(m,"failed to mount widget",o),t.current=null})),t.current),[a]);u.useEffect(()=>{if(!r)return i(),()=>{e.current?.destroy(),e.current=null,t.current=null}},[r,i]);const n=u.useCallback(async()=>{if(r)return{};await i();const o=e.current;if(!o)return{};const c=await o.getPayload();return c?{"x-inkeep-challenge-solution":btoa(JSON.stringify({payload:c}))}:{}},[r,i]),d=u.useCallback(()=>{e.current?.startNextSolve()},[]);return{getCaptchaHeader:n,invalidate:d}};exports.useCaptcha=E;
+"use client";"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const d=require("react"),h="[sentinel]",v="https://cdn.jsdelivr.net/npm/altcha@3.0.9/dist/main/altcha.min.js",w="sha384-SAvZpYmIwEwxkbER1dijvBKm10sobAn/28KXy+Z7/lGbsCshTPhYrFJ2kU7LKiFM",y=1e4,E=3e4;let f=null;function T(){if(typeof customElements>"u"||customElements.get("altcha-widget"))return Promise.resolve();if(f)return f;const u=r=>e=>{f=null,r(e)};return f=new Promise((r,e)=>{const t=u(e);if(document.querySelector(`script[src="${v}"]`)){customElements.whenDefined("altcha-widget").then(()=>r()).catch(t);return}const n=document.createElement("script");n.src=v,n.integrity=w,n.crossOrigin="anonymous",n.type="module",n.async=!0,n.onload=()=>{customElements.whenDefined("altcha-widget").then(()=>r()).catch(()=>t(new Error("altcha-widget custom element never registered")))},n.onerror=()=>{console.error(h,"failed to load widget script"),t(new Error("Failed to load altcha-widget script"))},document.head.appendChild(n)}),f}function P(u){const r=document.createElement("div");r.style.cssText="position:fixed;left:-9999px;top:-9999px;width:0;height:0;overflow:hidden;pointer-events:none",document.body.appendChild(r);const e=document.createElement("altcha-widget");e.setAttribute("challenge",u),e.setAttribute("auto","onload"),e.setAttribute("hidefooter","true"),e.setAttribute("hidelogo","true"),r.appendChild(e);let t=null,i,n="mounted",s=!1,l=!1,o=null;const m=()=>{s||(i=void 0,n="resetting",e.reset?.(),e.verify?.())},p=()=>{o&&clearTimeout(o),o=setTimeout(()=>{o=null,s&&(s=!1,i=void 0,n="resetting",e.reset?.(),e.verify?.())},E)},g=c=>{const a=c.detail;a&&(n=a.state??n,a.state==="verified"&&a.payload&&(l=!0,i=a.payload,t&&(t(a.payload),t=null)),a.state==="error"&&(i=void 0,t&&(t(void 0),t=null),l||(s=!0,console.warn(h,"Sentinel unavailable, requests will proceed without bot protection"),p())))};return e.addEventListener("statechange",g),{getPayload:()=>{if(s)return Promise.resolve(void 0);if(i){const c=i;return i=void 0,m(),Promise.resolve(c)}return n==="verified"&&m(),new Promise(c=>{t=c,setTimeout(()=>{t===c&&(t=null,c(void 0))},y)})},startNextSolve:m,destroy:()=>{e.removeEventListener("statechange",g),o&&(clearTimeout(o),o=null),t=null,r.remove()}}}const S=({baseUrl:u,shouldBypassCaptcha:r=!1})=>{const e=d.useRef(null),t=d.useRef(null),i=d.useCallback(()=>e.current?Promise.resolve():(t.current||(t.current=T().then(()=>{if(!e.current){const l=`${u}/run/auth/sentinel/challenge`;e.current=P(l)}}).catch(l=>{console.error(h,"failed to mount widget",l),t.current=null})),t.current),[u]);d.useEffect(()=>{if(!r)return i(),()=>{e.current?.destroy(),e.current=null,t.current=null}},[r,i]);const n=d.useCallback(async()=>{if(r)return{};await i();const l=e.current;if(!l)return{};const o=await l.getPayload();return o?{"x-inkeep-challenge-solution":btoa(JSON.stringify({payload:o}))}:{}},[r,i]),s=d.useCallback(()=>{e.current?.startNextSolve()},[]);return{getCaptchaHeader:n,invalidate:s}};exports.useCaptcha=S;

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

@@ -1,15 +1,15 @@
 "use client";
-import { useRef as g, useCallback as f, useEffect as v } from "react";
-const m = "[sentinel]", p = "https://cdn.jsdelivr.net/npm/altcha@3.0.9/dist/main/altcha.min.js", w = "sha384-SAvZpYmIwEwxkbER1dijvBKm10sobAn/28KXy+Z7/lGbsCshTPhYrFJ2kU7LKiFM", y = 1e4;
+import { useRef as v, useCallback as m, useEffect as E } from "react";
+const h = "[sentinel]", p = "https://cdn.jsdelivr.net/npm/altcha@3.0.9/dist/main/altcha.min.js", y = "sha384-SAvZpYmIwEwxkbER1dijvBKm10sobAn/28KXy+Z7/lGbsCshTPhYrFJ2kU7LKiFM", T = 1e4, P = 3e4;
 let d = null;
-function E() {
+function A() {
   if (typeof customElements > "u" || customElements.get("altcha-widget")) return Promise.resolve();
   if (d) return d;
-  const c = (r) => (e) => {
+  const u = (r) => (e) => {
     d = null, r(e);
   };
   return d = new Promise((r, e) => {
-    const t = c(e);
+    const t = u(e);
     if (document.querySelector(
       `script[src="${p}"]`
     )) {
@@ -17,72 +17,76 @@ function E() {
       return;
     }
     const n = document.createElement("script");
-    n.src = p, n.integrity = w, n.crossOrigin = "anonymous", n.type = "module", n.async = !0, n.onload = () => {
+    n.src = p, n.integrity = y, n.crossOrigin = "anonymous", n.type = "module", n.async = !0, n.onload = () => {
       customElements.whenDefined("altcha-widget").then(() => r()).catch(() => t(new Error("altcha-widget custom element never registered")));
     }, n.onerror = () => {
-      console.error(m, "failed to load widget script"), t(new Error("Failed to load altcha-widget script"));
+      console.error(h, "failed to load widget script"), t(new Error("Failed to load altcha-widget script"));
     }, document.head.appendChild(n);
   }), d;
 }
-function P(c) {
+function S(u) {
   const r = document.createElement("div");
   r.style.cssText = "position:fixed;left:-9999px;top:-9999px;width:0;height:0;overflow:hidden;pointer-events:none", document.body.appendChild(r);
   const e = document.createElement("altcha-widget");
-  e.setAttribute("challenge", c), e.setAttribute("auto", "onload"), e.setAttribute("hidefooter", "true"), e.setAttribute("hidelogo", "true"), r.appendChild(e);
-  let t = null, i, n = "mounted", u = !1, o = !1;
-  const a = () => {
-    u || (i = void 0, n = "resetting", e.reset?.(), e.verify?.());
-  }, h = (l) => {
-    const s = l.detail;
-    s && (n = s.state ?? n, s.state === "verified" && s.payload && (o = !0, i = s.payload, t && (t(s.payload), t = null)), s.state === "error" && (i = void 0, t && (t(void 0), t = null), o || (u = !0, console.warn(
-      m,
+  e.setAttribute("challenge", u), e.setAttribute("auto", "onload"), e.setAttribute("hidefooter", "true"), e.setAttribute("hidelogo", "true"), r.appendChild(e);
+  let t = null, i, n = "mounted", s = !1, l = !1, o = null;
+  const f = () => {
+    s || (i = void 0, n = "resetting", e.reset?.(), e.verify?.());
+  }, w = () => {
+    o && clearTimeout(o), o = setTimeout(() => {
+      o = null, s && (s = !1, i = void 0, n = "resetting", e.reset?.(), e.verify?.());
+    }, P);
+  }, g = (c) => {
+    const a = c.detail;
+    a && (n = a.state ?? n, a.state === "verified" && a.payload && (l = !0, i = a.payload, t && (t(a.payload), t = null)), a.state === "error" && (i = void 0, t && (t(void 0), t = null), l || (s = !0, console.warn(
+      h,
       "Sentinel unavailable, requests will proceed without bot protection"
-    ))));
+    ), w())));
   };
-  return e.addEventListener("statechange", h), { getPayload: () => {
-    if (u) return Promise.resolve(void 0);
+  return e.addEventListener("statechange", g), { getPayload: () => {
+    if (s) return Promise.resolve(void 0);
     if (i) {
-      const l = i;
-      return i = void 0, a(), Promise.resolve(l);
+      const c = i;
+      return i = void 0, f(), Promise.resolve(c);
     }
-    return n === "verified" && a(), new Promise((l) => {
-      t = l, setTimeout(() => {
-        t === l && (t = null, l(void 0));
-      }, y);
+    return n === "verified" && f(), new Promise((c) => {
+      t = c, setTimeout(() => {
+        t === c && (t = null, c(void 0));
+      }, T);
     });
-  }, startNextSolve: a, destroy: () => {
-    e.removeEventListener("statechange", h), t = null, r.remove();
+  }, startNextSolve: f, destroy: () => {
+    e.removeEventListener("statechange", g), o && (clearTimeout(o), o = null), t = null, r.remove();
   } };
 }
-const b = ({ baseUrl: c, shouldBypassCaptcha: r = !1 }) => {
-  const e = g(null), t = g(null), i = f(() => e.current ? Promise.resolve() : (t.current || (t.current = E().then(() => {
+const x = ({ baseUrl: u, shouldBypassCaptcha: r = !1 }) => {
+  const e = v(null), t = v(null), i = m(() => e.current ? Promise.resolve() : (t.current || (t.current = A().then(() => {
     if (!e.current) {
-      const o = `${c}/run/auth/sentinel/challenge`;
-      e.current = P(o);
+      const l = `${u}/run/auth/sentinel/challenge`;
+      e.current = S(l);
     }
-  }).catch((o) => {
-    console.error(m, "failed to mount widget", o), t.current = null;
-  })), t.current), [c]);
-  v(() => {
+  }).catch((l) => {
+    console.error(h, "failed to mount widget", l), t.current = null;
+  })), t.current), [u]);
+  E(() => {
     if (!r)
       return i(), () => {
         e.current?.destroy(), e.current = null, t.current = null;
       };
   }, [r, i]);
-  const n = f(async () => {
+  const n = m(async () => {
     if (r) return {};
     await i();
-    const o = e.current;
-    if (!o) return {};
-    const a = await o.getPayload();
-    return a ? {
-      "x-inkeep-challenge-solution": btoa(JSON.stringify({ payload: a }))
+    const l = e.current;
+    if (!l) return {};
+    const o = await l.getPayload();
+    return o ? {
+      "x-inkeep-challenge-solution": btoa(JSON.stringify({ payload: o }))
     } : {};
-  }, [r, i]), u = f(() => {
+  }, [r, i]), s = m(() => {
     e.current?.startNextSolve();
   }, []);
-  return { getCaptchaHeader: n, invalidate: u };
+  return { getCaptchaHeader: n, invalidate: s };
 };
 export {
-  b as useCaptcha
+  x as useCaptcha
 };

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

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

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

@@ -15,10 +15,13 @@ 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 (Sentinel) failure
+ *   - 401 + detail matching JWT/bearer messages               → session token failure
+ *
+ * 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

@@ -3,7 +3,8 @@ import { useRef as s, useCallback as E } from "react";
 function m(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 (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 ?? "";
@@ -22,7 +23,7 @@ function y(e) {
   }
   return Array.isArray(e) ? Object.fromEntries(e) : e;
 }
-function A(e, r, t, c) {
+function R(e, r, t, c) {
   return {
     ...e ? { "x-inkeep-app-id": e } : {},
     ...r ? { Authorization: `Bearer ${r}` } : {},
@@ -42,28 +43,28 @@ function H({
   o.current = e;
   const i = s(r);
   i.current = r;
-  const R = s(t);
-  R.current = t;
+  const w = s(t);
+  w.current = t;
   const l = s(c);
   l.current = c;
   const a = s(f);
-  return a.current = f, { fetchWithAuth: E(async (d, u) => {
-    const k = A(o.current, i.current, {}, u?.headers), n = await fetch(d, { ...u, headers: k });
+  return a.current = f, { fetchWithAuth: E(async (h, u) => {
+    const k = R(o.current, i.current, {}, u?.headers), n = await fetch(h, { ...u, headers: k });
     if (n.status !== 400 && n.status !== 401) return n;
-    let h;
+    let d;
     try {
-      h = await n.clone().json();
+      d = await n.clone().json();
     } catch {
       return n;
     }
-    const p = m(n.status, h);
-    if (p === "pow")
+    const p = m(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 j = A(o.current, w, {}, u?.headers);
-      return fetch(d, { ...u, headers: j });
+      const A = await a.current();
+      if (!A) return n;
+      const j = R(o.current, A, {}, u?.headers);
+      return fetch(h, { ...u, headers: j });
     }
     return n;
   }, []) };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@inkeep/agents-ui",
-  "version": "0.0.0-dev-20260528131439",
+  "version": "0.0.0-dev-20260528142533",
   "description": "",
   "homepage": "",
   "repository": {