@particle-academy/agent-integrations 0.27.0 → 0.28.0

package/dist/components-shared-whiteboard.js

@@ -1,5 +1,5 @@
-import { ShareControls, AgentCursor, AgentActivityHighlight, AgentPanel } from './chunk-HKQBG2HZ.js';
-import { createSessionDescriptor, attachSseRelay } from './chunk-FUI7KXE7.js';
+import { ShareControls, AgentCursor, AgentActivityHighlight, AgentPanel } from './chunk-5KLUYF4D.js';
+import { createSessionDescriptor, attachSseRelay } from './chunk-KMSRG5KH.js';
 import { attachInProcess } from './chunk-AFUULW5E.js';
 import { registerWhiteboardBridge } from './chunk-AAMQOXZC.js';
 import './chunk-ULJL53DL.js';

package/dist/index.cjs

@@ -2820,7 +2820,7 @@ function registerNavigationBridge(host, options) {
       ].join("\n");
       return textResult(text, snap);
     },
-    false
+    () => target("Inspect page")
   );
   reg(
     "page_read",
@@ -2828,7 +2828,23 @@ function registerNavigationBridge(host, options) {
     {},
     [],
     () => textResult(adapter.read ? adapter.read() : "(host did not provide page text)"),
-    false
+    () => target("Read page")
+  );
+  reg(
+    "page_focus",
+    "Move the agent's visible focus to an interactive element by stable handle without activating it.",
+    { handle: { type: "string" } },
+    ["handle"],
+    (args) => {
+      const handle = String(args.handle ?? "");
+      const action = adapter.describe().actions.find((candidate) => candidate.handle === handle);
+      if (!action) return errorResult(`No element for handle "${handle}"`);
+      return textResult(`Focused ${handle}`, {
+        handle,
+        rect: adapter.rectFor?.(handle) ?? void 0
+      });
+    },
+    (args) => target(`Focus ${String(args.handle ?? "")}`, String(args.handle ?? ""))
   );
   reg(
     "nav_visit",
@@ -3853,6 +3869,7 @@ function constantTimeEqual(a, b) {
 }
 
 // src/sharing/sse-relay.ts
+init_registry();
 var SseRelayTransport = class {
   constructor(options) {
     this.disposed = false;
@@ -3860,6 +3877,7 @@ var SseRelayTransport = class {
     this.connected = false;
     this.listeners = /* @__PURE__ */ new Set();
     this.state = "idle";
+    this.peers = /* @__PURE__ */ new Set();
     this.opts = options;
     this.expectedToken = options.token;
   }
@@ -3958,6 +3976,36 @@ var SseRelayTransport = class {
     } catch {
       return;
     }
+    if ("method" in message && message.method === "notifications/peer_joined") {
+      const subscriberId = String(message.params?.subscriberId ?? "peer");
+      this.peers.add(subscriberId);
+      fancyAutoCommon.emitActivity({
+        agentId: "agent",
+        agentName: "Agent",
+        agentColor: "#a855f7",
+        action: "agent_connected",
+        timestamp: Date.now(),
+        target: { kind: "navigation", label: "Agent connected" },
+        meta: { subscriberId }
+      });
+      return;
+    }
+    if ("method" in message && message.method === "notifications/peer_left") {
+      const subscriberId = String(message.params?.subscriberId ?? "peer");
+      this.peers.delete(subscriberId);
+      if (this.peers.size === 0) {
+        fancyAutoCommon.emitActivity({
+          agentId: "agent",
+          agentName: "Agent",
+          agentColor: "#a855f7",
+          action: "agent_disconnected",
+          timestamp: Date.now(),
+          target: { kind: "navigation", label: "Agent disconnected" },
+          meta: { subscriberId }
+        });
+      }
+      return;
+    }
     await this.server.receive(this, message);
   }
   setState(state) {
@@ -4026,11 +4074,14 @@ function useCoBrowseSession(options) {
     if (!server || relayRef.current) return;
     const descriptor = createSessionDescriptor();
     const csrf = options.csrfToken?.() ?? "";
-    await fetch(`${relayBaseUrl}/register`, {
+    const response = await fetch(`${relayBaseUrl}/register`, {
       method: "POST",
       headers: { "content-type": "application/json", "x-csrf-token": csrf },
       body: JSON.stringify({ session: descriptor.id, token: descriptor.token })
     });
+    if (!response.ok) {
+      throw new Error(`Relay registration failed (${response.status})`);
+    }
     const relay = attachSseRelay(server, { baseUrl: relayBaseUrl, sessionId: descriptor.id, token: descriptor.token });
     relay.onStateChange(setRelayState);
     relayRef.current = relay;
@@ -4044,16 +4095,15 @@ function useCoBrowseSession(options) {
     setSession(null);
     if (current) {
       const csrf = options.csrfToken?.() ?? "";
-      void fetch(`${relayBaseUrl}/${current.id}/unregister`, {
+      void fetch(`${relayBaseUrl}/${current.id}/unregister?token=${encodeURIComponent(current.token)}`, {
         method: "POST",
-        headers: { "content-type": "application/json", "x-csrf-token": csrf },
-        body: JSON.stringify({ token: current.token })
+        headers: { "content-type": "application/json", "x-csrf-token": csrf }
       }).catch(() => {
       });
     }
   }, [relayBaseUrl, options, session]);
   const observeUser = react.useCallback((event) => {
-    const label = event.kind === "navigation" ? `You navigated to ${event.url}` : event.kind === "scroll" ? "You scrolled" : `You edited ${event.handle}${event.masked ? " (hidden)" : ""}`;
+    const label = event.kind === "navigation" ? `You navigated to ${event.url}` : event.kind === "scroll" ? "You scrolled" : event.kind === "click" ? `You clicked ${event.label ?? event.handle}` : `You edited ${event.handle}${event.masked ? " (hidden)" : ""}`;
     fancyAutoCommon.emitActivity({
       agentId: USER.id,
       agentName: USER.name,
@@ -4829,6 +4879,11 @@ function CoBrowseCursorLayer({ active = true, zIndex = 2147483e3 }) {
   const [pulse, setPulse] = react.useState(null);
   react.useEffect(() => {
     if (!latest || (latest.source ?? "agent") === "user") return;
+    if (latest.action === "agent_disconnected") {
+      setCursor(null);
+      setPulse(null);
+      return;
+    }
     const color = latest.agentColor ?? "#a855f7";
     const name = latest.agentName ?? "Agent";
     const status = latest.target?.label ?? latest.action;