site-operator-react 0.1.13 → 0.2.1

package/README.md

@@ -8,6 +8,8 @@ npm install site-operator-react
 
 ```tsx
 import { AgentChat, type AppContext, type AppState } from 'site-operator-react';
+import type { AgentChat as AgentChatElement } from 'site-operator';
+import { useRef } from 'react';
 
 const context: AppContext = {
   v: "1.1",
@@ -67,9 +69,12 @@ const state: AppState = {
 };
 
 function App() {
+  const chatRef = useRef<AgentChatElement>(null);
+
   return (
     <div className="App">
       <AgentChat
+        ref={chatRef}
         backendUrl="http://localhost:8001/ag_ui"
         appName="My React App"
         context={{ appContext: context, appState: state }}
@@ -82,10 +87,12 @@ function App() {
 
 ### useChatPortal Hook
 
-The `useChatPortal` hook allows you to register the "Copilot" capabilities (`AppContext`) for your application. This lets the agent understand the app structure and available targets.
+The `useChatPortal` hook allows you to register the "Copilot" capabilities (`AppContext`) for your application. This lets the agent understand the app structure and available targets. It can also return the live `ChatController` from `AgentChat` when you pass a `chatRef`.
 
 ```tsx
 import { useChatPortal, type AppContext } from 'site-operator-react';
+import type { AgentChat as AgentChatElement } from 'site-operator';
+import { useRef } from 'react';
 
 const context: AppContext = {
   v: "1.1",
@@ -98,11 +105,17 @@ const context: AppContext = {
 };
 
 function App() {
-  useChatPortal(context);
+  const chatRef = useRef<AgentChatElement>(null);
+  const controller = useChatPortal(context, { chatRef });
 
   return (
-    // ...
+    <AgentChat ref={chatRef} context={{ appContext: context }} />
   );
 }
-```
 
+// How chatRef works:
+// - pass it to <AgentChat /> so React forwards it to the web component
+// - useChatPortal listens for the "controller-ready" event
+// - once ready, it returns the live ChatController instance
+// controller?.sendMessage('Hola');
+```

package/dist/index.d.ts

@@ -1,10 +1,13 @@
+import { AgentChat as AgentChat_2 } from 'site-operator';
 import { AgentState } from 'site-operator';
 import { AppContext } from 'site-operator';
 import { AppState } from 'site-operator';
+import { ChatController } from 'site-operator';
 import { ClickTarget } from 'site-operator';
 import { default as default_2 } from 'react';
+import { RefObject } from 'react';
 
-export declare const AgentChat: default_2.FC<AgentChatProps>;
+export declare const AgentChat: default_2.ForwardRefExoticComponent<AgentChatProps & default_2.RefAttributes<AgentChat_2 | null>>;
 
 export declare interface AgentChatProps {
     backendUrl?: string;
@@ -51,7 +54,13 @@ export declare interface ThreadViewProps {
  * 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.
+ * @returns ChatController instance if an AgentChat ref is provided.
  */
-export declare function useChatPortal(context: AppContext): void;
+export declare function useChatPortal(context: AppContext, options?: UseChatPortalOptions): ChatController | null;
+
+export declare type UseChatPortalOptions = {
+    chatRef?: RefObject<AgentChat_2>;
+};
 
 export { }

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

@@ -1,6 +1,6 @@
-import ee, { useRef as re, useEffect as j } from "react";
-import { chatPortalService as te } from "site-operator";
-var S = { exports: {} }, v = {};
+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 = {};
 /**
  * @license React
  * react-jsx-runtime.production.js
@@ -11,26 +11,26 @@ var S = { exports: {} }, v = {};
  * LICENSE file in the root directory of this source tree.
  */
 var D;
-function ae() {
-  if (D) return v;
+function le() {
+  if (D) return p;
   D = 1;
-  var u = Symbol.for("react.transitional.element"), _ = Symbol.for("react.fragment");
-  function d(m, l, s) {
-    var E = null;
-    if (s !== void 0 && (E = "" + s), l.key !== void 0 && (E = "" + l.key), "key" in l) {
-      s = {};
-      for (var i in l)
-        i !== "key" && (s[i] = l[i]);
-    } else s = l;
-    return l = s.ref, {
-      $$typeof: u,
-      type: m,
-      key: E,
-      ref: l !== void 0 ? l : null,
-      props: s
+  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
     };
   }
-  return v.Fragment = _, v.jsx = d, v.jsxs = d, v;
+  return p.Fragment = i, p.jsx = m, p.jsxs = m, p;
 }
 var b = {};
 /**
@@ -43,97 +43,97 @@ var b = {};
  * LICENSE file in the root directory of this source tree.
  */
 var L;
-function ne() {
+function oe() {
   return L || (L = 1, process.env.NODE_ENV !== "production" && (function() {
-    function u(e) {
+    function c(e) {
       if (e == null) return null;
       if (typeof e == "function")
-        return e.$$typeof === Z ? null : e.displayName || e.name || null;
+        return e.$$typeof === Q ? null : e.displayName || e.name || null;
       if (typeof e == "string") return e;
       switch (e) {
-        case A:
+        case O:
           return "Fragment";
-        case q:
+        case J:
           return "Profiler";
-        case U:
+        case q:
           return "StrictMode";
-        case G:
-          return "Suspense";
         case X:
+          return "Suspense";
+        case H:
           return "SuspenseList";
-        case B:
+        case Z:
           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 W:
+          case U:
             return "Portal";
-          case V:
+          case z:
             return e.displayName || "Context";
-          case J:
+          case V:
             return (e._context.displayName || "Context") + ".Consumer";
-          case z:
+          case G:
             var r = e.render;
             return e = e.displayName, e || (e = r.displayName || r.name || "", e = e !== "" ? "ForwardRef(" + e + ")" : "ForwardRef"), e;
-          case H:
-            return r = e.displayName || null, r !== null ? r : u(e.type) || "Memo";
-          case O:
+          case B:
+            return r = e.displayName || null, r !== null ? r : c(e.type) || "Memo";
+          case P:
             r = e._payload, e = e._init;
             try {
-              return u(e(r));
+              return c(e(r));
             } catch {
             }
         }
       return null;
     }
-    function _(e) {
+    function i(e) {
       return "" + e;
     }
-    function d(e) {
+    function m(e) {
       try {
-        _(e);
+        i(e);
         var r = !1;
       } catch {
         r = !0;
       }
       if (r) {
         r = console;
-        var t = r.error, a = typeof Symbol == "function" && Symbol.toStringTag && e[Symbol.toStringTag] || e.constructor.name || "Object";
+        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.",
-          a
-        ), _(e);
+          n
+        ), i(e);
       }
     }
-    function m(e) {
-      if (e === A) return "<>";
-      if (typeof e == "object" && e !== null && e.$$typeof === O)
+    function f(e) {
+      if (e === O) return "<>";
+      if (typeof e == "object" && e !== null && e.$$typeof === P)
         return "<...>";
       try {
-        var r = u(e);
+        var r = c(e);
         return r ? "<" + r + ">" : "<...>";
       } catch {
         return "<...>";
       }
     }
-    function l() {
-      var e = P.A;
+    function a() {
+      var e = g.A;
       return e === null ? null : e.getOwner();
     }
-    function s() {
+    function u() {
       return Error("react-stack-top-frame");
     }
-    function E(e) {
-      if (h.call(e, "key")) {
+    function d(e) {
+      if (N.call(e, "key")) {
         var r = Object.getOwnPropertyDescriptor(e, "key").get;
         if (r && r.isReactWarning) return !1;
       }
       return e.key !== void 0;
     }
-    function i(e, r) {
+    function s(e, r) {
       function t() {
         x || (x = !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)",
@@ -145,23 +145,23 @@ function ne() {
         configurable: !0
       });
     }
-    function R() {
-      var e = u(this.type);
+    function v() {
+      var e = c(this.type);
       return Y[e] || (Y[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 c(e, r, t, a, k, g) {
-      var n = t.ref;
+    function _(e, r, t, n, S, j) {
+      var l = t.ref;
       return e = {
-        $$typeof: N,
+        $$typeof: C,
         type: e,
         key: r,
         props: t,
-        _owner: a
-      }, (n !== void 0 ? n : null) !== null ? Object.defineProperty(e, "ref", {
+        _owner: n
+      }, (l !== void 0 ? l : null) !== null ? Object.defineProperty(e, "ref", {
         enumerable: !1,
-        get: R
+        get: v
       }) : Object.defineProperty(e, "ref", { enumerable: !1, value: null }), e._store = {}, Object.defineProperty(e._store, "validated", {
         configurable: !1,
         enumerable: !1,
@@ -176,151 +176,167 @@ function ne() {
         configurable: !1,
         enumerable: !1,
         writable: !0,
-        value: k
+        value: S
       }), Object.defineProperty(e, "_debugTask", {
         configurable: !1,
         enumerable: !1,
         writable: !0,
-        value: g
+        value: j
       }), Object.freeze && (Object.freeze(e.props), Object.freeze(e)), e;
     }
-    function o(e, r, t, a, k, g) {
-      var n = r.children;
-      if (n !== void 0)
-        if (a)
-          if (Q(n)) {
-            for (a = 0; a < n.length; a++)
-              f(n[a]);
-            Object.freeze && Object.freeze(n);
+    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);
           } 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 f(n);
-      if (h.call(r, "key")) {
-        n = u(e);
-        var p = Object.keys(r).filter(function(K) {
-          return K !== "key";
+        else T(l);
+      if (N.call(r, "key")) {
+        l = c(e);
+        var R = Object.keys(r).filter(function(ee) {
+          return ee !== "key";
         });
-        a = 0 < p.length ? "{key: someKey, " + p.join(": ..., ") + ": ...}" : "{key: someKey}", F[n + a] || (p = 0 < p.length ? "{" + p.join(": ..., ") + ": ...}" : "{}", console.error(
+        n = 0 < R.length ? "{key: someKey, " + R.join(": ..., ") + ": ...}" : "{key: someKey}", F[l + n] || (R = 0 < R.length ? "{" + R.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} />`,
-          a,
           n,
-          p,
-          n
-        ), F[n + a] = !0);
+          l,
+          R,
+          l
+        ), F[l + n] = !0);
       }
-      if (n = null, t !== void 0 && (d(t), n = "" + t), E(r) && (d(r.key), n = "" + r.key), "key" in r) {
+      if (l = null, t !== void 0 && (m(t), l = "" + t), d(r) && (m(r.key), l = "" + r.key), "key" in r) {
         t = {};
-        for (var w in r)
-          w !== "key" && (t[w] = r[w]);
+        for (var h in r)
+          h !== "key" && (t[h] = r[h]);
       } else t = r;
-      return n && i(
+      return l && s(
         t,
         typeof e == "function" ? e.displayName || e.name || "Unknown" : e
-      ), c(
+      ), _(
         e,
-        n,
+        l,
         t,
-        l(),
-        k,
-        g
+        a(),
+        S,
+        j
       );
     }
-    function f(e) {
-      C(e) ? e._store && (e._store.validated = 1) : typeof e == "object" && e !== null && e.$$typeof === O && (e._payload.status === "fulfilled" ? C(e._payload.value) && e._payload.value._store && (e._payload.value._store.validated = 1) : e._store && (e._store.validated = 1));
+    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 C(e) {
-      return typeof e == "object" && e !== null && e.$$typeof === N;
+    function E(e) {
+      return typeof e == "object" && e !== null && e.$$typeof === C;
     }
-    var T = ee, N = Symbol.for("react.transitional.element"), W = Symbol.for("react.portal"), A = Symbol.for("react.fragment"), U = Symbol.for("react.strict_mode"), q = Symbol.for("react.profiler"), J = Symbol.for("react.consumer"), V = Symbol.for("react.context"), z = Symbol.for("react.forward_ref"), G = Symbol.for("react.suspense"), X = Symbol.for("react.suspense_list"), H = Symbol.for("react.memo"), O = Symbol.for("react.lazy"), B = Symbol.for("react.activity"), Z = Symbol.for("react.client.reference"), P = T.__CLIENT_INTERNALS_DO_NOT_USE_OR_WARN_USERS_THEY_CANNOT_UPGRADE, h = Object.prototype.hasOwnProperty, Q = Array.isArray, y = console.createTask ? console.createTask : function() {
+    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() {
       return null;
     };
-    T = {
+    k = {
       react_stack_bottom_frame: function(e) {
         return e();
       }
     };
-    var x, Y = {}, $ = T.react_stack_bottom_frame.bind(
-      T,
-      s
-    )(), I = y(m(s)), F = {};
-    b.Fragment = A, b.jsx = function(e, r, t) {
-      var a = 1e4 > P.recentlyCreatedOwnerStacks++;
+    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(
         e,
         r,
         t,
         !1,
-        a ? Error("react-stack-top-frame") : $,
-        a ? y(m(e)) : I
+        n ? Error("react-stack-top-frame") : $,
+        n ? w(f(e)) : I
       );
     }, b.jsxs = function(e, r, t) {
-      var a = 1e4 > P.recentlyCreatedOwnerStacks++;
+      var n = 1e4 > g.recentlyCreatedOwnerStacks++;
       return o(
         e,
         r,
         t,
         !0,
-        a ? Error("react-stack-top-frame") : $,
-        a ? y(m(e)) : I
+        n ? Error("react-stack-top-frame") : $,
+        n ? w(f(e)) : I
       );
     };
   })()), b;
 }
 var M;
-function oe() {
-  return M || (M = 1, process.env.NODE_ENV === "production" ? S.exports = ae() : S.exports = ne()), S.exports;
+function ue() {
+  return M || (M = 1, process.env.NODE_ENV === "production" ? A.exports = le() : A.exports = oe()), A.exports;
 }
-var le = oe();
-const ie = ({
-  backendUrl: u,
-  conversationUrl: _,
-  appName: d,
-  agentAvatar: m,
-  inspector: l,
-  interceptor: s,
-  className: E,
-  composer: i,
-  thread: R,
-  header: c,
+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
-}) => {
-  const f = re(null);
-  return j(() => {
-    f.current && (o != null && o.appContext) && f.current.setAppContext(o.appContext);
-  }, [o == null ? void 0 : o.appContext]), j(() => {
-    f.current && (o != null && o.appState) && f.current.setAppState(o.appState);
-  }, [o == null ? void 0 : o.appState]), /* @__PURE__ */ le.jsx(
+}, 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(
     "agent-chat",
     {
-      ref: f,
-      backendUrl: u,
-      conversationUrl: _,
-      appName: d,
-      agentAvatar: m,
-      disclaimer: i == null ? void 0 : i.disclaimer,
-      placeholder: i == null ? void 0 : i.placeholder,
-      emptyText: R == null ? void 0 : R.emptyText,
-      headerTitle: c == null ? void 0 : c.title,
-      hideHeader: c == null ? void 0 : c.hide,
-      inspector: l ? "true" : void 0,
-      interceptor: s ? !0 : void 0,
-      class: E
+      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
     }
   );
-};
-function ce(u) {
-  j(() => {
-    te.registerPortal(u);
-  }, [u]);
+});
+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);
+      return;
+    }
+    const u = (s) => {
+      f(s.detail ?? null);
+    };
+    return a.addEventListener("controller-ready", u), () => {
+      a.removeEventListener("controller-ready", u);
+    };
+  }, [i == null ? void 0 : i.chatRef]), m;
 }
 export {
   ie as AgentChat,
-  ce as useChatPortal
+  de as useChatPortal
 };

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

@@ -1,4 +1,4 @@
-(function(c,f){typeof exports=="object"&&typeof module<"u"?f(exports,require("react"),require("site-operator")):typeof define=="function"&&define.amd?define(["exports","react","site-operator"],f):(c=typeof globalThis<"u"?globalThis:c||self,f(c.SiteOperatorReact={},c.React,c.SiteOperator))})(this,(function(c,f,J){"use strict";var k={exports:{}},b={};/**
+(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={};/**
  * @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 C;function V(){if(C)return b;C=1;var u=Symbol.for("react.transitional.element"),R=Symbol.for("react.fragment");function E(_,s,l){var m=null;if(l!==void 0&&(m=""+l),s.key!==void 0&&(m=""+s.key),"key"in s){l={};for(var i in s)i!=="key"&&(l[i]=s[i])}else l=s;return s=l.ref,{$$typeof:u,type:_,key:m,ref:s!==void 0?s:null,props:l}}return b.Fragment=R,b.jsx=E,b.jsxs=E,b}var T={};/**
+ */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={};/**
  * @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 N;function z(){return N||(N=1,process.env.NODE_ENV!=="production"&&(function(){function u(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 Z:return"Profiler";case B: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 H:return"Portal";case K:return e.displayName||"Context";case Q: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:u(e.type)||"Memo";case y:r=e._payload,e=e._init;try{return u(e(r))}catch{}}return null}function R(e){return""+e}function E(e){try{R(e);var r=!1}catch{r=!0}if(r){r=console;var t=r.error,a=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.",a),R(e)}}function _(e){if(e===P)return"<>";if(typeof e=="object"&&e!==null&&e.$$typeof===y)return"<...>";try{var r=u(e);return r?"<"+r+">":"<...>"}catch{return"<...>"}}function s(){var e=g.A;return e===null?null:e.getOwner()}function l(){return Error("react-stack-top-frame")}function m(e){if(F.call(e,"key")){var r=Object.getOwnPropertyDescriptor(e,"key").get;if(r&&r.isReactWarning)return!1}return e.key!==void 0}function i(e,r){function t(){D||(D=!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=u(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 d(e,r,t,a,A,w){var n=t.ref;return e={$$typeof:I,type:e,key:r,props:t,_owner:a},(n!==void 0?n: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:A}),Object.defineProperty(e,"_debugTask",{configurable:!1,enumerable:!1,writable:!0,value:w}),Object.freeze&&(Object.freeze(e.props),Object.freeze(e)),e}function o(e,r,t,a,A,w){var n=r.children;if(n!==void 0)if(a)if(se(n)){for(a=0;a<n.length;a++)p(n[a]);Object.freeze&&Object.freeze(n)}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 p(n);if(F.call(r,"key")){n=u(e);var v=Object.keys(r).filter(function(ue){return ue!=="key"});a=0<v.length?"{key: someKey, "+v.join(": ..., ")+": ...}":"{key: someKey}",U[n+a]||(v=0<v.length?"{"+v.join(": ..., ")+": ...}":"{}",console.error(`A props object containing a "key" prop is being spread into JSX:
+ */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:
   let props = %s;
   <%s {...props} />
 React keys must be passed directly to JSX without using spread:
   let props = %s;
-  <%s key={someKey} {...props} />`,a,n,v,n),U[n+a]=!0)}if(n=null,t!==void 0&&(E(t),n=""+t),m(r)&&(E(r.key),n=""+r.key),"key"in r){t={};for(var h in r)h!=="key"&&(t[h]=r[h])}else t=r;return n&&i(t,typeof e=="function"?e.displayName||e.name||"Unknown":e),d(e,n,t,s(),A,w)}function p(e){Y(e)?e._store&&(e._store.validated=1):typeof e=="object"&&e!==null&&e.$$typeof===y&&(e._payload.status==="fulfilled"?Y(e._payload.value)&&e._payload.value._store&&(e._payload.value._store.validated=1):e._store&&(e._store.validated=1))}function Y(e){return typeof e=="object"&&e!==null&&e.$$typeof===I}var O=f,I=Symbol.for("react.transitional.element"),H=Symbol.for("react.portal"),P=Symbol.for("react.fragment"),B=Symbol.for("react.strict_mode"),Z=Symbol.for("react.profiler"),Q=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"),y=Symbol.for("react.lazy"),ne=Symbol.for("react.activity"),oe=Symbol.for("react.client.reference"),g=O.__CLIENT_INTERNALS_DO_NOT_USE_OR_WARN_USERS_THEY_CANNOT_UPGRADE,F=Object.prototype.hasOwnProperty,se=Array.isArray,j=console.createTask?console.createTask:function(){return null};O={react_stack_bottom_frame:function(e){return e()}};var D,M={},L=O.react_stack_bottom_frame.bind(O,l)(),W=j(_(l)),U={};T.Fragment=P,T.jsx=function(e,r,t){var a=1e4>g.recentlyCreatedOwnerStacks++;return o(e,r,t,!1,a?Error("react-stack-top-frame"):L,a?j(_(e)):W)},T.jsxs=function(e,r,t){var a=1e4>g.recentlyCreatedOwnerStacks++;return o(e,r,t,!0,a?Error("react-stack-top-frame"):L,a?j(_(e)):W)}})()),T}var x;function $(){return x||(x=1,process.env.NODE_ENV==="production"?k.exports=V():k.exports=z()),k.exports}var G=$();const q=({backendUrl:u,conversationUrl:R,appName:E,agentAvatar:_,inspector:s,interceptor:l,className:m,composer:i,thread:S,header:d,context:o})=>{const p=f.useRef(null);return f.useEffect(()=>{p.current&&(o!=null&&o.appContext)&&p.current.setAppContext(o.appContext)},[o==null?void 0:o.appContext]),f.useEffect(()=>{p.current&&(o!=null&&o.appState)&&p.current.setAppState(o.appState)},[o==null?void 0:o.appState]),G.jsx("agent-chat",{ref:p,backendUrl:u,conversationUrl:R,appName:E,agentAvatar:_,disclaimer:i==null?void 0:i.disclaimer,placeholder:i==null?void 0:i.placeholder,emptyText:S==null?void 0:S.emptyText,headerTitle:d==null?void 0:d.title,hideHeader:d==null?void 0:d.hide,inspector:s?"true":void 0,interceptor:l?!0:void 0,class:m})};function X(u){f.useEffect(()=>{J.chatPortalService.registerPortal(u)},[u])}c.AgentChat=q,c.useChatPortal=X,Object.defineProperty(c,Symbol.toStringTag,{value:"Module"})}));
+  <%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"})}));

package/package.json

@@ -1,19 +1,19 @@
 {
   "name": "site-operator-react",
-  "version": "0.1.13",
+  "version": "0.2.1",
   "description": "React wrapper for site-operator, providing AgentChat component and hooks.",
   "type": "module",
   "author": "jostvian",
   "license": "MIT",
   "repository": {
     "type": "git",
-    "url": "git+https://github.com/jostvian-agent/site-operator.git",
+    "url": "git+https://github.com/jostvian/site-operator.git",
     "directory": "packages/react"
   },
   "bugs": {
-    "url": "https://github.com/jostvian-agent/site-operator/issues"
+    "url": "https://github.com/jostvian/site-operator/issues"
   },
-  "homepage": "https://github.com/jostvian-agent/site-operator#readme",
+  "homepage": "https://github.com/jostvian/site-operator#readme",
   "main": "./dist/site-operator-react.umd.js",
   "module": "./dist/site-operator-react.es.js",
   "types": "./dist/index.d.ts",
@@ -32,17 +32,17 @@
     "dev": "vite build --watch"
   },
   "dependencies": {
-    "site-operator": "^0.1.13"
+    "site-operator": "^0.1.14"
   },
   "peerDependencies": {
     "react": "^19.0.0",
     "react-dom": "^19.0.0"
   },
   "devDependencies": {
-    "react": "^19.0.0",
-    "react-dom": "^19.0.0",
     "@types/react": "^19.0.0",
     "@types/react-dom": "^19.0.0",
+    "react": "^19.0.0",
+    "react-dom": "^19.0.0",
     "typescript": "^5.7.0",
     "vite": "^6.0.0",
     "vite-plugin-dts": "^4.5.0"