site-operator-react 0.2.1 → 0.2.4

package/README.md

@@ -119,3 +119,43 @@ function App() {
 // - once ready, it returns the live ChatController instance
 // controller?.sendMessage('Hola');
 ```
+
+### AgentChatProvider + AgentChatMount + useAgentChatController
+
+If you prefer a React Context approach, wrap your app (or a subtree) with `AgentChatProvider`. It manages the `ref` and exposes the `ChatController` via `useAgentChatController`. Place `<AgentChatMount />` where you want the chat UI to render.
+
+```tsx
+import { AgentChatProvider, AgentChatMount, useAgentChatController, type AppContext } from 'site-operator-react';
+
+const context: AppContext = {
+  v: "1.1",
+  site: { name: "Mi Portal" },
+  user: { id: "u-123" },
+  nav: { routes: [] }
+};
+
+function ChatActions() {
+  const controller = useAgentChatController();
+  return (
+    <button onClick={() => controller?.startNewThread()}>
+      Nuevo chat
+    </button>
+  );
+}
+
+function App() {
+  return (
+    <AgentChatProvider
+      backendUrl="http://localhost:8001/ag_ui"
+      appName="My React App"
+      context={{ appContext: context }}
+    >
+      <header>Mi App</header>
+      <main>
+        <AgentChatMount className="chat-root" />
+      </main>
+      <ChatActions />
+    </AgentChatProvider>
+  );
+}
+```

package/dist/index.d.ts

@@ -1,3 +1,4 @@
+import { Action } from 'site-operator';
 import { AgentChat as AgentChat_2 } from 'site-operator';
 import { AgentState } from 'site-operator';
 import { AppContext } from 'site-operator';
@@ -5,9 +6,14 @@ import { AppState } from 'site-operator';
 import { ChatController } from 'site-operator';
 import { ClickTarget } from 'site-operator';
 import { default as default_2 } from 'react';
+import { ExecutePlanResult } from 'site-operator';
 import { RefObject } from 'react';
 
-export declare const AgentChat: default_2.ForwardRefExoticComponent<AgentChatProps & default_2.RefAttributes<AgentChat_2 | null>>;
+export declare const AgentChat: default_2.ForwardRefExoticComponent<AgentChatProps & default_2.RefAttributes<AgentChat_2>>;
+
+export declare const AgentChatMount: default_2.FC<AgentChatMountProps>;
+
+export declare type AgentChatMountProps = default_2.HTMLAttributes<HTMLDivElement>;
 
 export declare interface AgentChatProps {
     backendUrl?: string;
@@ -23,6 +29,15 @@ export declare interface AgentChatProps {
     context?: ContextProps;
 }
 
+export declare const AgentChatProvider: default_2.FC<AgentChatProviderProps>;
+
+export declare type AgentChatProviderProps = AgentChatProps & {
+    children?: default_2.ReactNode;
+    handlers?: {
+        executePlan?: (plan: Action) => Promise<ExecutePlanResult>;
+    };
+};
+
 export { AgentState }
 
 export { AppContext }
@@ -50,17 +65,24 @@ export declare interface ThreadViewProps {
     emptyText?: string;
 }
 
+export declare function useAgentChatController(): ChatController | null;
+
 /**
  * A hook to register a Chat Portal specification for the agent.
  * This allows the agent to navigate and control the host application.
  * @param context The AppContext defining site, user and navigation.
- * @param options Optional refs for accessing the AgentChat controller.
+ *                If null/undefined, registration is skipped.
+ * @param options Optional refs for accessing the AgentChat controller and custom handlers.
  * @returns ChatController instance if an AgentChat ref is provided.
  */
-export declare function useChatPortal(context: AppContext, options?: UseChatPortalOptions): ChatController | null;
+export declare function useChatPortal(context: AppContext | null | undefined, options?: UseChatPortalOptions & {
+    handlers?: {
+        executePlan?: (plan: Action) => Promise<ExecutePlanResult>;
+    };
+}): ChatController | null;
 
 export declare type UseChatPortalOptions = {
-    chatRef?: RefObject<AgentChat_2>;
+    chatRef?: RefObject<AgentChat_2 | null>;
 };
 
 export { }

package/dist/site-operator-react.es.js

@@ -1,6 +1,7 @@
-import W, { useRef as re, useImperativeHandle as te, useEffect as y, useState as ae } from "react";
-import { chatPortalService as ne } from "site-operator";
-var A = { exports: {} }, p = {};
+import q, { useRef as N, useImperativeHandle as ce, useEffect as A, useState as J, createContext as V, useContext as z } from "react";
+import { chatPortalService as ie } from "site-operator";
+import { createPortal as fe } from "react-dom";
+var C = { exports: {} }, b = {};
 /**
  * @license React
  * react-jsx-runtime.production.js
@@ -10,29 +11,29 @@ var A = { exports: {} }, p = {};
  * This source code is licensed under the MIT license found in the
  * LICENSE file in the root directory of this source tree.
  */
-var D;
-function le() {
-  if (D) return p;
-  D = 1;
-  var c = Symbol.for("react.transitional.element"), i = Symbol.for("react.fragment");
-  function m(f, a, u) {
-    var d = null;
-    if (u !== void 0 && (d = "" + u), a.key !== void 0 && (d = "" + a.key), "key" in a) {
-      u = {};
-      for (var s in a)
-        s !== "key" && (u[s] = a[s]);
-    } else u = a;
-    return a = u.ref, {
-      $$typeof: c,
-      type: f,
-      key: d,
-      ref: a !== void 0 ? a : null,
-      props: u
+var L;
+function de() {
+  if (L) return b;
+  L = 1;
+  var o = Symbol.for("react.transitional.element"), t = Symbol.for("react.fragment");
+  function i(d, n, s) {
+    var m = null;
+    if (s !== void 0 && (m = "" + s), n.key !== void 0 && (m = "" + n.key), "key" in n) {
+      s = {};
+      for (var f in n)
+        f !== "key" && (s[f] = n[f]);
+    } else s = n;
+    return n = s.ref, {
+      $$typeof: o,
+      type: d,
+      key: m,
+      ref: n !== void 0 ? n : null,
+      props: s
     };
   }
-  return p.Fragment = i, p.jsx = m, p.jsxs = m, p;
+  return b.Fragment = t, b.jsx = i, b.jsxs = i, b;
 }
-var b = {};
+var T = {};
 /**
  * @license React
  * react-jsx-runtime.development.js
@@ -42,126 +43,126 @@ var b = {};
  * This source code is licensed under the MIT license found in the
  * LICENSE file in the root directory of this source tree.
  */
-var L;
-function oe() {
-  return L || (L = 1, process.env.NODE_ENV !== "production" && (function() {
-    function c(e) {
+var W;
+function me() {
+  return W || (W = 1, process.env.NODE_ENV !== "production" && (function() {
+    function o(e) {
       if (e == null) return null;
       if (typeof e == "function")
-        return e.$$typeof === Q ? null : e.displayName || e.name || null;
+        return e.$$typeof === ue ? null : e.displayName || e.name || null;
       if (typeof e == "string") return e;
       switch (e) {
-        case O:
+        case g:
           return "Fragment";
-        case J:
+        case Q:
           return "Profiler";
-        case q:
+        case Z:
           return "StrictMode";
-        case X:
+        case te:
           return "Suspense";
-        case H:
+        case ne:
           return "SuspenseList";
-        case Z:
+        case le:
           return "Activity";
       }
       if (typeof e == "object")
         switch (typeof e.tag == "number" && console.error(
           "Received an unexpected object in getComponentNameFromType(). This is likely a bug in React. Please file an issue."
         ), e.$$typeof) {
-          case U:
+          case B:
             return "Portal";
-          case z:
+          case ee:
             return e.displayName || "Context";
-          case V:
+          case K:
             return (e._context.displayName || "Context") + ".Consumer";
-          case G:
+          case re:
             var r = e.render;
             return e = e.displayName, e || (e = r.displayName || r.name || "", e = e !== "" ? "ForwardRef(" + e + ")" : "ForwardRef"), e;
-          case B:
-            return r = e.displayName || null, r !== null ? r : c(e.type) || "Memo";
-          case P:
+          case ae:
+            return r = e.displayName || null, r !== null ? r : o(e.type) || "Memo";
+          case h:
             r = e._payload, e = e._init;
             try {
-              return c(e(r));
+              return o(e(r));
             } catch {
             }
         }
       return null;
     }
-    function i(e) {
+    function t(e) {
       return "" + e;
     }
-    function m(e) {
+    function i(e) {
       try {
-        i(e);
+        t(e);
         var r = !1;
       } catch {
         r = !0;
       }
       if (r) {
         r = console;
-        var t = r.error, n = typeof Symbol == "function" && Symbol.toStringTag && e[Symbol.toStringTag] || e.constructor.name || "Object";
-        return t.call(
+        var a = r.error, l = typeof Symbol == "function" && Symbol.toStringTag && e[Symbol.toStringTag] || e.constructor.name || "Object";
+        return a.call(
           r,
           "The provided key is an unsupported type %s. This value must be coerced to a string before using it here.",
-          n
-        ), i(e);
+          l
+        ), t(e);
       }
     }
-    function f(e) {
-      if (e === O) return "<>";
-      if (typeof e == "object" && e !== null && e.$$typeof === P)
+    function d(e) {
+      if (e === g) return "<>";
+      if (typeof e == "object" && e !== null && e.$$typeof === h)
         return "<...>";
       try {
-        var r = c(e);
+        var r = o(e);
         return r ? "<" + r + ">" : "<...>";
       } catch {
         return "<...>";
       }
     }
-    function a() {
-      var e = g.A;
+    function n() {
+      var e = y.A;
       return e === null ? null : e.getOwner();
     }
-    function u() {
+    function s() {
       return Error("react-stack-top-frame");
     }
-    function d(e) {
-      if (N.call(e, "key")) {
+    function m(e) {
+      if (Y.call(e, "key")) {
         var r = Object.getOwnPropertyDescriptor(e, "key").get;
         if (r && r.isReactWarning) return !1;
       }
       return e.key !== void 0;
     }
-    function s(e, r) {
-      function t() {
-        x || (x = !0, console.error(
+    function f(e, r) {
+      function a() {
+        $ || ($ = !0, console.error(
           "%s: `key` is not a prop. Trying to access it will result in `undefined` being returned. If you need to access the same value within the child component, you should pass it as a different prop. (https://react.dev/link/special-props)",
           r
         ));
       }
-      t.isReactWarning = !0, Object.defineProperty(e, "key", {
-        get: t,
+      a.isReactWarning = !0, Object.defineProperty(e, "key", {
+        get: a,
         configurable: !0
       });
     }
-    function v() {
-      var e = c(this.type);
-      return Y[e] || (Y[e] = !0, console.error(
+    function R() {
+      var e = o(this.type);
+      return I[e] || (I[e] = !0, console.error(
         "Accessing element.ref was removed in React 19. ref is now a regular prop. It will be removed from the JSX Element type in a future release."
       )), e = this.props.ref, e !== void 0 ? e : null;
     }
-    function _(e, r, t, n, S, j) {
-      var l = t.ref;
+    function v(e, r, a, l, S, j) {
+      var u = a.ref;
       return e = {
-        $$typeof: C,
+        $$typeof: x,
         type: e,
         key: r,
-        props: t,
-        _owner: n
-      }, (l !== void 0 ? l : null) !== null ? Object.defineProperty(e, "ref", {
+        props: a,
+        _owner: l
+      }, (u !== void 0 ? u : null) !== null ? Object.defineProperty(e, "ref", {
         enumerable: !1,
-        get: v
+        get: R
       }) : Object.defineProperty(e, "ref", { enumerable: !1, value: null }), e._store = {}, Object.defineProperty(e._store, "validated", {
         configurable: !1,
         enumerable: !1,
@@ -184,159 +185,186 @@ function oe() {
         value: j
       }), Object.freeze && (Object.freeze(e.props), Object.freeze(e)), e;
     }
-    function o(e, r, t, n, S, j) {
-      var l = r.children;
-      if (l !== void 0)
-        if (n)
-          if (K(l)) {
-            for (n = 0; n < l.length; n++)
-              T(l[n]);
-            Object.freeze && Object.freeze(l);
+    function c(e, r, a, l, S, j) {
+      var u = r.children;
+      if (u !== void 0)
+        if (l)
+          if (oe(u)) {
+            for (l = 0; l < u.length; l++)
+              k(u[l]);
+            Object.freeze && Object.freeze(u);
           } else
             console.error(
               "React.jsx: Static children should always be an array. You are likely explicitly calling React.jsxs or React.jsxDEV. Use the Babel transform instead."
             );
-        else T(l);
-      if (N.call(r, "key")) {
-        l = c(e);
-        var R = Object.keys(r).filter(function(ee) {
-          return ee !== "key";
+        else k(u);
+      if (Y.call(r, "key")) {
+        u = o(e);
+        var _ = Object.keys(r).filter(function(se) {
+          return se !== "key";
         });
-        n = 0 < R.length ? "{key: someKey, " + R.join(": ..., ") + ": ...}" : "{key: someKey}", F[l + n] || (R = 0 < R.length ? "{" + R.join(": ..., ") + ": ...}" : "{}", console.error(
+        l = 0 < _.length ? "{key: someKey, " + _.join(": ..., ") + ": ...}" : "{key: someKey}", D[u + l] || (_ = 0 < _.length ? "{" + _.join(": ..., ") + ": ...}" : "{}", console.error(
           `A props object containing a "key" prop is being spread into JSX:
   let props = %s;
   <%s {...props} />
 React keys must be passed directly to JSX without using spread:
   let props = %s;
   <%s key={someKey} {...props} />`,
-          n,
           l,
-          R,
-          l
-        ), F[l + n] = !0);
+          u,
+          _,
+          u
+        ), D[u + l] = !0);
       }
-      if (l = null, t !== void 0 && (m(t), l = "" + t), d(r) && (m(r.key), l = "" + r.key), "key" in r) {
-        t = {};
-        for (var h in r)
-          h !== "key" && (t[h] = r[h]);
-      } else t = r;
-      return l && s(
-        t,
+      if (u = null, a !== void 0 && (i(a), u = "" + a), m(r) && (i(r.key), u = "" + r.key), "key" in r) {
+        a = {};
+        for (var w in r)
+          w !== "key" && (a[w] = r[w]);
+      } else a = r;
+      return u && f(
+        a,
         typeof e == "function" ? e.displayName || e.name || "Unknown" : e
-      ), _(
+      ), v(
         e,
-        l,
-        t,
-        a(),
+        u,
+        a,
+        n(),
         S,
         j
       );
     }
-    function T(e) {
-      E(e) ? e._store && (e._store.validated = 1) : typeof e == "object" && e !== null && e.$$typeof === P && (e._payload.status === "fulfilled" ? E(e._payload.value) && e._payload.value._store && (e._payload.value._store.validated = 1) : e._store && (e._store.validated = 1));
+    function k(e) {
+      E(e) ? e._store && (e._store.validated = 1) : typeof e == "object" && e !== null && e.$$typeof === h && (e._payload.status === "fulfilled" ? E(e._payload.value) && e._payload.value._store && (e._payload.value._store.validated = 1) : e._store && (e._store.validated = 1));
     }
     function E(e) {
-      return typeof e == "object" && e !== null && e.$$typeof === C;
+      return typeof e == "object" && e !== null && e.$$typeof === x;
     }
-    var k = W, C = Symbol.for("react.transitional.element"), U = Symbol.for("react.portal"), O = Symbol.for("react.fragment"), q = Symbol.for("react.strict_mode"), J = Symbol.for("react.profiler"), V = Symbol.for("react.consumer"), z = Symbol.for("react.context"), G = Symbol.for("react.forward_ref"), X = Symbol.for("react.suspense"), H = Symbol.for("react.suspense_list"), B = Symbol.for("react.memo"), P = Symbol.for("react.lazy"), Z = Symbol.for("react.activity"), Q = Symbol.for("react.client.reference"), g = k.__CLIENT_INTERNALS_DO_NOT_USE_OR_WARN_USERS_THEY_CANNOT_UPGRADE, N = Object.prototype.hasOwnProperty, K = Array.isArray, w = console.createTask ? console.createTask : function() {
+    var P = q, x = Symbol.for("react.transitional.element"), B = Symbol.for("react.portal"), g = Symbol.for("react.fragment"), Z = Symbol.for("react.strict_mode"), Q = Symbol.for("react.profiler"), K = Symbol.for("react.consumer"), ee = Symbol.for("react.context"), re = Symbol.for("react.forward_ref"), te = Symbol.for("react.suspense"), ne = Symbol.for("react.suspense_list"), ae = Symbol.for("react.memo"), h = Symbol.for("react.lazy"), le = Symbol.for("react.activity"), ue = Symbol.for("react.client.reference"), y = P.__CLIENT_INTERNALS_DO_NOT_USE_OR_WARN_USERS_THEY_CANNOT_UPGRADE, Y = Object.prototype.hasOwnProperty, oe = Array.isArray, O = console.createTask ? console.createTask : function() {
       return null;
     };
-    k = {
+    P = {
       react_stack_bottom_frame: function(e) {
         return e();
       }
     };
-    var x, Y = {}, $ = k.react_stack_bottom_frame.bind(
-      k,
-      u
-    )(), I = w(f(u)), F = {};
-    b.Fragment = O, b.jsx = function(e, r, t) {
-      var n = 1e4 > g.recentlyCreatedOwnerStacks++;
-      return o(
+    var $, I = {}, M = P.react_stack_bottom_frame.bind(
+      P,
+      s
+    )(), F = O(d(s)), D = {};
+    T.Fragment = g, T.jsx = function(e, r, a) {
+      var l = 1e4 > y.recentlyCreatedOwnerStacks++;
+      return c(
         e,
         r,
-        t,
+        a,
         !1,
-        n ? Error("react-stack-top-frame") : $,
-        n ? w(f(e)) : I
+        l ? Error("react-stack-top-frame") : M,
+        l ? O(d(e)) : F
       );
-    }, b.jsxs = function(e, r, t) {
-      var n = 1e4 > g.recentlyCreatedOwnerStacks++;
-      return o(
+    }, T.jsxs = function(e, r, a) {
+      var l = 1e4 > y.recentlyCreatedOwnerStacks++;
+      return c(
         e,
         r,
-        t,
+        a,
         !0,
-        n ? Error("react-stack-top-frame") : $,
-        n ? w(f(e)) : I
+        l ? Error("react-stack-top-frame") : M,
+        l ? O(d(e)) : F
       );
     };
-  })()), b;
+  })()), T;
 }
-var M;
-function ue() {
-  return M || (M = 1, process.env.NODE_ENV === "production" ? A.exports = le() : A.exports = oe()), A.exports;
+var U;
+function Ee() {
+  return U || (U = 1, process.env.NODE_ENV === "production" ? C.exports = de() : C.exports = me()), C.exports;
 }
-var se = ue();
-const ie = W.forwardRef(({
-  backendUrl: c,
-  conversationUrl: i,
-  appName: m,
-  agentAvatar: f,
-  inspector: a,
-  interceptor: u,
-  className: d,
-  composer: s,
-  thread: v,
-  header: _,
-  context: o
-}, T) => {
-  const E = re(null);
-  return te(T, () => E.current), y(() => {
-    E.current && (o != null && o.appContext) && E.current.setAppContext(o.appContext);
-  }, [o == null ? void 0 : o.appContext]), y(() => {
-    E.current && (o != null && o.appState) && E.current.setAppState(o.appState);
-  }, [o == null ? void 0 : o.appState]), /* @__PURE__ */ se.jsx(
+var p = Ee();
+const G = q.forwardRef(({
+  backendUrl: o,
+  conversationUrl: t,
+  appName: i,
+  agentAvatar: d,
+  inspector: n,
+  interceptor: s,
+  className: m,
+  composer: f,
+  thread: R,
+  header: v,
+  context: c
+}, k) => {
+  const E = N(null);
+  return ce(k, () => E.current), A(() => {
+    E.current && (c != null && c.appContext) && E.current.setAppContext(c.appContext);
+  }, [c == null ? void 0 : c.appContext]), A(() => {
+    E.current && (c != null && c.appState) && E.current.setAppState(c.appState);
+  }, [c == null ? void 0 : c.appState]), /* @__PURE__ */ p.jsx(
     "agent-chat",
     {
       ref: E,
-      backendUrl: c,
-      conversationUrl: i,
-      appName: m,
-      agentAvatar: f,
-      disclaimer: s == null ? void 0 : s.disclaimer,
-      placeholder: s == null ? void 0 : s.placeholder,
-      emptyText: v == null ? void 0 : v.emptyText,
-      headerTitle: _ == null ? void 0 : _.title,
-      hideHeader: _ == null ? void 0 : _.hide,
-      inspector: a ? "true" : void 0,
-      interceptor: u ? !0 : void 0,
-      class: d
+      backendUrl: o,
+      conversationUrl: t,
+      appName: i,
+      agentAvatar: d,
+      disclaimer: f == null ? void 0 : f.disclaimer,
+      placeholder: f == null ? void 0 : f.placeholder,
+      emptyText: R == null ? void 0 : R.emptyText,
+      headerTitle: v == null ? void 0 : v.title,
+      hideHeader: v == null ? void 0 : v.hide,
+      inspector: n ? "true" : void 0,
+      interceptor: s ? !0 : void 0,
+      class: m
     }
   );
 });
-ie.displayName = "AgentChat";
-function de(c, i) {
-  const [m, f] = ae(null);
-  return y(() => {
-    ne.registerPortal(c);
-  }, [c]), y(() => {
-    var d;
-    const a = (d = i == null ? void 0 : i.chatRef) == null ? void 0 : d.current;
-    if (!a) return;
-    if (a.controller) {
-      f(a.controller);
+G.displayName = "AgentChat";
+function ve(o, t) {
+  const [i, d] = J(null);
+  return A(() => {
+    o && ie.registerPortal(o, t == null ? void 0 : t.handlers);
+  }, [o, t == null ? void 0 : t.handlers]), A(() => {
+    var m;
+    const n = (m = t == null ? void 0 : t.chatRef) == null ? void 0 : m.current;
+    if (!n) return;
+    if (n.controller) {
+      d(n.controller);
       return;
     }
-    const u = (s) => {
-      f(s.detail ?? null);
+    const s = (f) => {
+      d(f.detail ?? null);
     };
-    return a.addEventListener("controller-ready", u), () => {
-      a.removeEventListener("controller-ready", u);
+    return n.addEventListener("controller-ready", s), () => {
+      n.removeEventListener("controller-ready", s);
     };
-  }, [i == null ? void 0 : i.chatRef]), m;
+  }, [t == null ? void 0 : t.chatRef]), i;
 }
+const X = V(null), H = V(null);
+function Te() {
+  return z(X);
+}
+const pe = ({ children: o, ...t }) => {
+  const i = z(H), d = N(null);
+  return A(() => {
+    if (i)
+      return i(d.current), () => {
+        i(null);
+      };
+  }, [i]), /* @__PURE__ */ p.jsx("div", { ref: d, ...t, children: o });
+}, Ae = ({
+  children: o,
+  context: t,
+  handlers: i,
+  ...d
+}) => {
+  const n = N(null), s = ve(t == null ? void 0 : t.appContext, { chatRef: n, handlers: i }), [m, f] = J(null);
+  return /* @__PURE__ */ p.jsx(X.Provider, { value: s, children: /* @__PURE__ */ p.jsxs(H.Provider, { value: f, children: [
+    o,
+    m ? fe(/* @__PURE__ */ p.jsx(G, { ref: n, context: t, ...d }), m) : null
+  ] }) });
+};
 export {
-  ie as AgentChat,
-  de as useChatPortal
+  G as AgentChat,
+  pe as AgentChatMount,
+  Ae as AgentChatProvider,
+  Te as useAgentChatController,
+  ve as useChatPortal
 };

package/dist/site-operator-react.umd.js

@@ -1,4 +1,4 @@
-(function(m,i){typeof exports=="object"&&typeof module<"u"?i(exports,require("react"),require("site-operator")):typeof define=="function"&&define.amd?define(["exports","react","site-operator"],i):(m=typeof globalThis<"u"?globalThis:m||self,i(m.SiteOperatorReact={},m.React,m.SiteOperator))})(this,(function(m,i,V){"use strict";var k={exports:{}},b={};/**
+(function(E,l){typeof exports=="object"&&typeof module<"u"?l(exports,require("react"),require("site-operator"),require("react-dom")):typeof define=="function"&&define.amd?define(["exports","react","site-operator","react-dom"],l):(E=typeof globalThis<"u"?globalThis:E||self,l(E.SiteOperatorReact={},E.React,E.SiteOperator,E.ReactDOM))})(this,(function(E,l,H,B){"use strict";var h={exports:{}},b={};/**
  * @license React
  * react-jsx-runtime.production.js
  *
@@ -6,7 +6,7 @@
  *
  * This source code is licensed under the MIT license found in the
  * LICENSE file in the root directory of this source tree.
- */var N;function z(){if(N)return b;N=1;var f=Symbol.for("react.transitional.element"),c=Symbol.for("react.fragment");function _(d,a,u){var E=null;if(u!==void 0&&(E=""+u),a.key!==void 0&&(E=""+a.key),"key"in a){u={};for(var s in a)s!=="key"&&(u[s]=a[s])}else u=a;return a=u.ref,{$$typeof:f,type:d,key:E,ref:a!==void 0?a:null,props:u}}return b.Fragment=c,b.jsx=_,b.jsxs=_,b}var T={};/**
+ */var Y;function Z(){if(Y)return b;Y=1;var s=Symbol.for("react.transitional.element"),t=Symbol.for("react.fragment");function i(m,n,c){var v=null;if(c!==void 0&&(v=""+c),n.key!==void 0&&(v=""+n.key),"key"in n){c={};for(var d in n)d!=="key"&&(c[d]=n[d])}else c=n;return n=c.ref,{$$typeof:s,type:m,key:v,ref:n!==void 0?n:null,props:c}}return b.Fragment=t,b.jsx=i,b.jsxs=i,b}var p={};/**
  * @license React
  * react-jsx-runtime.development.js
  *
@@ -14,9 +14,9 @@
  *
  * This source code is licensed under the MIT license found in the
  * LICENSE file in the root directory of this source tree.
- */var x;function G(){return x||(x=1,process.env.NODE_ENV!=="production"&&(function(){function f(e){if(e==null)return null;if(typeof e=="function")return e.$$typeof===oe?null:e.displayName||e.name||null;if(typeof e=="string")return e;switch(e){case P:return"Fragment";case Q:return"Profiler";case q:return"StrictMode";case re:return"Suspense";case te:return"SuspenseList";case ne:return"Activity"}if(typeof e=="object")switch(typeof e.tag=="number"&&console.error("Received an unexpected object in getComponentNameFromType(). This is likely a bug in React. Please file an issue."),e.$$typeof){case Z:return"Portal";case K:return e.displayName||"Context";case $:return(e._context.displayName||"Context")+".Consumer";case ee:var r=e.render;return e=e.displayName,e||(e=r.displayName||r.name||"",e=e!==""?"ForwardRef("+e+")":"ForwardRef"),e;case ae:return r=e.displayName||null,r!==null?r:f(e.type)||"Memo";case g:r=e._payload,e=e._init;try{return f(e(r))}catch{}}return null}function c(e){return""+e}function _(e){try{c(e);var r=!1}catch{r=!0}if(r){r=console;var t=r.error,n=typeof Symbol=="function"&&Symbol.toStringTag&&e[Symbol.toStringTag]||e.constructor.name||"Object";return t.call(r,"The provided key is an unsupported type %s. This value must be coerced to a string before using it here.",n),c(e)}}function d(e){if(e===P)return"<>";if(typeof e=="object"&&e!==null&&e.$$typeof===g)return"<...>";try{var r=f(e);return r?"<"+r+">":"<...>"}catch{return"<...>"}}function a(){var e=h.A;return e===null?null:e.getOwner()}function u(){return Error("react-stack-top-frame")}function E(e){if(D.call(e,"key")){var r=Object.getOwnPropertyDescriptor(e,"key").get;if(r&&r.isReactWarning)return!1}return e.key!==void 0}function s(e,r){function t(){L||(L=!0,console.error("%s: `key` is not a prop. Trying to access it will result in `undefined` being returned. If you need to access the same value within the child component, you should pass it as a different prop. (https://react.dev/link/special-props)",r))}t.isReactWarning=!0,Object.defineProperty(e,"key",{get:t,configurable:!0})}function S(){var e=f(this.type);return M[e]||(M[e]=!0,console.error("Accessing element.ref was removed in React 19. ref is now a regular prop. It will be removed from the JSX Element type in a future release.")),e=this.props.ref,e!==void 0?e:null}function R(e,r,t,n,O,w){var o=t.ref;return e={$$typeof:F,type:e,key:r,props:t,_owner:n},(o!==void 0?o:null)!==null?Object.defineProperty(e,"ref",{enumerable:!1,get:S}):Object.defineProperty(e,"ref",{enumerable:!1,value:null}),e._store={},Object.defineProperty(e._store,"validated",{configurable:!1,enumerable:!1,writable:!0,value:0}),Object.defineProperty(e,"_debugInfo",{configurable:!1,enumerable:!1,writable:!0,value:null}),Object.defineProperty(e,"_debugStack",{configurable:!1,enumerable:!1,writable:!0,value:O}),Object.defineProperty(e,"_debugTask",{configurable:!1,enumerable:!1,writable:!0,value:w}),Object.freeze&&(Object.freeze(e.props),Object.freeze(e)),e}function l(e,r,t,n,O,w){var o=r.children;if(o!==void 0)if(n)if(le(o)){for(n=0;n<o.length;n++)y(o[n]);Object.freeze&&Object.freeze(o)}else console.error("React.jsx: Static children should always be an array. You are likely explicitly calling React.jsxs or React.jsxDEV. Use the Babel transform instead.");else y(o);if(D.call(r,"key")){o=f(e);var v=Object.keys(r).filter(function(ue){return ue!=="key"});n=0<v.length?"{key: someKey, "+v.join(": ..., ")+": ...}":"{key: someKey}",J[o+n]||(v=0<v.length?"{"+v.join(": ..., ")+": ...}":"{}",console.error(`A props object containing a "key" prop is being spread into JSX:
+ */var M;function Q(){return M||(M=1,process.env.NODE_ENV!=="production"&&(function(){function s(e){if(e==null)return null;if(typeof e=="function")return e.$$typeof===ie?null:e.displayName||e.name||null;if(typeof e=="string")return e;switch(e){case O:return"Fragment";case ne:return"Profiler";case te:return"StrictMode";case ue:return"Suspense";case se:return"SuspenseList";case fe:return"Activity"}if(typeof e=="object")switch(typeof e.tag=="number"&&console.error("Received an unexpected object in getComponentNameFromType(). This is likely a bug in React. Please file an issue."),e.$$typeof){case re:return"Portal";case le:return e.displayName||"Context";case ae:return(e._context.displayName||"Context")+".Consumer";case oe:var r=e.render;return e=e.displayName,e||(e=r.displayName||r.name||"",e=e!==""?"ForwardRef("+e+")":"ForwardRef"),e;case ce:return r=e.displayName||null,r!==null?r:s(e.type)||"Memo";case g:r=e._payload,e=e._init;try{return s(e(r))}catch{}}return null}function t(e){return""+e}function i(e){try{t(e);var r=!1}catch{r=!0}if(r){r=console;var a=r.error,o=typeof Symbol=="function"&&Symbol.toStringTag&&e[Symbol.toStringTag]||e.constructor.name||"Object";return a.call(r,"The provided key is an unsupported type %s. This value must be coerced to a string before using it here.",o),t(e)}}function m(e){if(e===O)return"<>";if(typeof e=="object"&&e!==null&&e.$$typeof===g)return"<...>";try{var r=s(e);return r?"<"+r+">":"<...>"}catch{return"<...>"}}function n(){var e=j.A;return e===null?null:e.getOwner()}function c(){return Error("react-stack-top-frame")}function v(e){if(U.call(e,"key")){var r=Object.getOwnPropertyDescriptor(e,"key").get;if(r&&r.isReactWarning)return!1}return e.key!==void 0}function d(e,r){function a(){J||(J=!0,console.error("%s: `key` is not a prop. Trying to access it will result in `undefined` being returned. If you need to access the same value within the child component, you should pass it as a different prop. (https://react.dev/link/special-props)",r))}a.isReactWarning=!0,Object.defineProperty(e,"key",{get:a,configurable:!0})}function C(){var e=s(this.type);return V[e]||(V[e]=!0,console.error("Accessing element.ref was removed in React 19. ref is now a regular prop. It will be removed from the JSX Element type in a future release.")),e=this.props.ref,e!==void 0?e:null}function _(e,r,a,o,k,N){var u=a.ref;return e={$$typeof:W,type:e,key:r,props:a,_owner:o},(u!==void 0?u:null)!==null?Object.defineProperty(e,"ref",{enumerable:!1,get:C}):Object.defineProperty(e,"ref",{enumerable:!1,value:null}),e._store={},Object.defineProperty(e._store,"validated",{configurable:!1,enumerable:!1,writable:!0,value:0}),Object.defineProperty(e,"_debugInfo",{configurable:!1,enumerable:!1,writable:!0,value:null}),Object.defineProperty(e,"_debugStack",{configurable:!1,enumerable:!1,writable:!0,value:k}),Object.defineProperty(e,"_debugTask",{configurable:!1,enumerable:!1,writable:!0,value:N}),Object.freeze&&(Object.freeze(e.props),Object.freeze(e)),e}function f(e,r,a,o,k,N){var u=r.children;if(u!==void 0)if(o)if(de(u)){for(o=0;o<u.length;o++)S(u[o]);Object.freeze&&Object.freeze(u)}else console.error("React.jsx: Static children should always be an array. You are likely explicitly calling React.jsxs or React.jsxDEV. Use the Babel transform instead.");else S(u);if(U.call(r,"key")){u=s(e);var T=Object.keys(r).filter(function(me){return me!=="key"});o=0<T.length?"{key: someKey, "+T.join(": ..., ")+": ...}":"{key: someKey}",X[u+o]||(T=0<T.length?"{"+T.join(": ..., ")+": ...}":"{}",console.error(`A props object containing a "key" prop is being spread into JSX:
   let props = %s;
   <%s {...props} />
 React keys must be passed directly to JSX without using spread:
   let props = %s;
-  <%s key={someKey} {...props} />`,n,o,v,o),J[o+n]=!0)}if(o=null,t!==void 0&&(_(t),o=""+t),E(r)&&(_(r.key),o=""+r.key),"key"in r){t={};for(var C in r)C!=="key"&&(t[C]=r[C])}else t=r;return o&&s(t,typeof e=="function"?e.displayName||e.name||"Unknown":e),R(e,o,t,a(),O,w)}function y(e){p(e)?e._store&&(e._store.validated=1):typeof e=="object"&&e!==null&&e.$$typeof===g&&(e._payload.status==="fulfilled"?p(e._payload.value)&&e._payload.value._store&&(e._payload.value._store.validated=1):e._store&&(e._store.validated=1))}function p(e){return typeof e=="object"&&e!==null&&e.$$typeof===F}var A=i,F=Symbol.for("react.transitional.element"),Z=Symbol.for("react.portal"),P=Symbol.for("react.fragment"),q=Symbol.for("react.strict_mode"),Q=Symbol.for("react.profiler"),$=Symbol.for("react.consumer"),K=Symbol.for("react.context"),ee=Symbol.for("react.forward_ref"),re=Symbol.for("react.suspense"),te=Symbol.for("react.suspense_list"),ae=Symbol.for("react.memo"),g=Symbol.for("react.lazy"),ne=Symbol.for("react.activity"),oe=Symbol.for("react.client.reference"),h=A.__CLIENT_INTERNALS_DO_NOT_USE_OR_WARN_USERS_THEY_CANNOT_UPGRADE,D=Object.prototype.hasOwnProperty,le=Array.isArray,j=console.createTask?console.createTask:function(){return null};A={react_stack_bottom_frame:function(e){return e()}};var L,M={},W=A.react_stack_bottom_frame.bind(A,u)(),U=j(d(u)),J={};T.Fragment=P,T.jsx=function(e,r,t){var n=1e4>h.recentlyCreatedOwnerStacks++;return l(e,r,t,!1,n?Error("react-stack-top-frame"):W,n?j(d(e)):U)},T.jsxs=function(e,r,t){var n=1e4>h.recentlyCreatedOwnerStacks++;return l(e,r,t,!0,n?Error("react-stack-top-frame"):W,n?j(d(e)):U)}})()),T}var Y;function X(){return Y||(Y=1,process.env.NODE_ENV==="production"?k.exports=z():k.exports=G()),k.exports}var H=X();const I=i.forwardRef(({backendUrl:f,conversationUrl:c,appName:_,agentAvatar:d,inspector:a,interceptor:u,className:E,composer:s,thread:S,header:R,context:l},y)=>{const p=i.useRef(null);return i.useImperativeHandle(y,()=>p.current),i.useEffect(()=>{p.current&&(l!=null&&l.appContext)&&p.current.setAppContext(l.appContext)},[l==null?void 0:l.appContext]),i.useEffect(()=>{p.current&&(l!=null&&l.appState)&&p.current.setAppState(l.appState)},[l==null?void 0:l.appState]),H.jsx("agent-chat",{ref:p,backendUrl:f,conversationUrl:c,appName:_,agentAvatar:d,disclaimer:s==null?void 0:s.disclaimer,placeholder:s==null?void 0:s.placeholder,emptyText:S==null?void 0:S.emptyText,headerTitle:R==null?void 0:R.title,hideHeader:R==null?void 0:R.hide,inspector:a?"true":void 0,interceptor:u?!0:void 0,class:E})});I.displayName="AgentChat";function B(f,c){const[_,d]=i.useState(null);return i.useEffect(()=>{V.chatPortalService.registerPortal(f)},[f]),i.useEffect(()=>{var E;const a=(E=c==null?void 0:c.chatRef)==null?void 0:E.current;if(!a)return;if(a.controller){d(a.controller);return}const u=s=>{d(s.detail??null)};return a.addEventListener("controller-ready",u),()=>{a.removeEventListener("controller-ready",u)}},[c==null?void 0:c.chatRef]),_}m.AgentChat=I,m.useChatPortal=B,Object.defineProperty(m,Symbol.toStringTag,{value:"Module"})}));
+  <%s key={someKey} {...props} />`,o,u,T,u),X[u+o]=!0)}if(u=null,a!==void 0&&(i(a),u=""+a),v(r)&&(i(r.key),u=""+r.key),"key"in r){a={};for(var x in r)x!=="key"&&(a[x]=r[x])}else a=r;return u&&d(a,typeof e=="function"?e.displayName||e.name||"Unknown":e),_(e,u,a,n(),k,N)}function S(e){R(e)?e._store&&(e._store.validated=1):typeof e=="object"&&e!==null&&e.$$typeof===g&&(e._payload.status==="fulfilled"?R(e._payload.value)&&e._payload.value._store&&(e._payload.value._store.validated=1):e._store&&(e._store.validated=1))}function R(e){return typeof e=="object"&&e!==null&&e.$$typeof===W}var P=l,W=Symbol.for("react.transitional.element"),re=Symbol.for("react.portal"),O=Symbol.for("react.fragment"),te=Symbol.for("react.strict_mode"),ne=Symbol.for("react.profiler"),ae=Symbol.for("react.consumer"),le=Symbol.for("react.context"),oe=Symbol.for("react.forward_ref"),ue=Symbol.for("react.suspense"),se=Symbol.for("react.suspense_list"),ce=Symbol.for("react.memo"),g=Symbol.for("react.lazy"),fe=Symbol.for("react.activity"),ie=Symbol.for("react.client.reference"),j=P.__CLIENT_INTERNALS_DO_NOT_USE_OR_WARN_USERS_THEY_CANNOT_UPGRADE,U=Object.prototype.hasOwnProperty,de=Array.isArray,w=console.createTask?console.createTask:function(){return null};P={react_stack_bottom_frame:function(e){return e()}};var J,V={},z=P.react_stack_bottom_frame.bind(P,c)(),G=w(m(c)),X={};p.Fragment=O,p.jsx=function(e,r,a){var o=1e4>j.recentlyCreatedOwnerStacks++;return f(e,r,a,!1,o?Error("react-stack-top-frame"):z,o?w(m(e)):G)},p.jsxs=function(e,r,a){var o=1e4>j.recentlyCreatedOwnerStacks++;return f(e,r,a,!0,o?Error("react-stack-top-frame"):z,o?w(m(e)):G)}})()),p}var I;function K(){return I||(I=1,process.env.NODE_ENV==="production"?h.exports=Z():h.exports=Q()),h.exports}var A=K();const y=l.forwardRef(({backendUrl:s,conversationUrl:t,appName:i,agentAvatar:m,inspector:n,interceptor:c,className:v,composer:d,thread:C,header:_,context:f},S)=>{const R=l.useRef(null);return l.useImperativeHandle(S,()=>R.current),l.useEffect(()=>{R.current&&(f!=null&&f.appContext)&&R.current.setAppContext(f.appContext)},[f==null?void 0:f.appContext]),l.useEffect(()=>{R.current&&(f!=null&&f.appState)&&R.current.setAppState(f.appState)},[f==null?void 0:f.appState]),A.jsx("agent-chat",{ref:R,backendUrl:s,conversationUrl:t,appName:i,agentAvatar:m,disclaimer:d==null?void 0:d.disclaimer,placeholder:d==null?void 0:d.placeholder,emptyText:C==null?void 0:C.emptyText,headerTitle:_==null?void 0:_.title,hideHeader:_==null?void 0:_.hide,inspector:n?"true":void 0,interceptor:c?!0:void 0,class:v})});y.displayName="AgentChat";function D(s,t){const[i,m]=l.useState(null);return l.useEffect(()=>{s&&H.chatPortalService.registerPortal(s,t==null?void 0:t.handlers)},[s,t==null?void 0:t.handlers]),l.useEffect(()=>{var v;const n=(v=t==null?void 0:t.chatRef)==null?void 0:v.current;if(!n)return;if(n.controller){m(n.controller);return}const c=d=>{m(d.detail??null)};return n.addEventListener("controller-ready",c),()=>{n.removeEventListener("controller-ready",c)}},[t==null?void 0:t.chatRef]),i}const F=l.createContext(null),L=l.createContext(null);function q(){return l.useContext(F)}const $=({children:s,...t})=>{const i=l.useContext(L),m=l.useRef(null);return l.useEffect(()=>{if(i)return i(m.current),()=>{i(null)}},[i]),A.jsx("div",{ref:m,...t,children:s})},ee=({children:s,context:t,handlers:i,...m})=>{const n=l.useRef(null),c=D(t==null?void 0:t.appContext,{chatRef:n,handlers:i}),[v,d]=l.useState(null);return A.jsx(F.Provider,{value:c,children:A.jsxs(L.Provider,{value:d,children:[s,v?B.createPortal(A.jsx(y,{ref:n,context:t,...m}),v):null]})})};E.AgentChat=y,E.AgentChatMount=$,E.AgentChatProvider=ee,E.useAgentChatController=q,E.useChatPortal=D,Object.defineProperty(E,Symbol.toStringTag,{value:"Module"})}));

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "site-operator-react",
-  "version": "0.2.1",
+  "version": "0.2.4",
   "description": "React wrapper for site-operator, providing AgentChat component and hooks.",
   "type": "module",
   "author": "jostvian",
@@ -32,7 +32,7 @@
     "dev": "vite build --watch"
   },
   "dependencies": {
-    "site-operator": "^0.1.14"
+    "site-operator": "^0.2.4"
   },
   "peerDependencies": {
     "react": "^19.0.0",
@@ -47,4 +47,4 @@
     "vite": "^6.0.0",
     "vite-plugin-dts": "^4.5.0"
   }
-}
+}