@particle-academy/agent-integrations 0.27.0 → 0.28.1

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

@@ -2772,6 +2772,17 @@ function registerNavigationBridge(host, options) {
   const agent = { ...DEFAULT_AGENT11, ...options.agent ?? {} };
   const pendingMode = options.pendingMode ?? true;
   const disposers = [];
+  let groundedRevision = null;
+  const staleIntent = () => {
+    const current = adapter.getRevision?.();
+    if (current === void 0) return null;
+    if (groundedRevision === null || groundedRevision !== current) {
+      return errorResult(
+        `Human took control at page revision ${current}. This agent action was cancelled; call page_describe before acting again.`
+      );
+    }
+    return null;
+  };
   ensureUndoToolsRegistered(host, { defaultAgentId: agent.id });
   const target = (label, elementId) => ({
     kind: "navigation",
@@ -2812,6 +2823,11 @@ function registerNavigationBridge(host, options) {
     [],
     () => {
       const snap = adapter.describe();
+      const revision = adapter.getRevision?.();
+      if (revision !== void 0) {
+        snap.revision = revision;
+        groundedRevision = revision;
+      }
       const text = [
         `URL: ${snap.url}`,
         `Title: ${snap.title}`,
@@ -2820,7 +2836,7 @@ function registerNavigationBridge(host, options) {
       ].join("\n");
       return textResult(text, snap);
     },
-    false
+    () => target("Inspect page")
   );
   reg(
     "page_read",
@@ -2828,7 +2844,25 @@ 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 stale = staleIntent();
+      if (stale) return stale;
+      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",
@@ -2836,6 +2870,8 @@ function registerNavigationBridge(host, options) {
     { url: { type: "string", description: "Path like /packages or an absolute URL." } },
     ["url"],
     async (args) => {
+      const stale = staleIntent();
+      if (stale) return stale;
       const url = String(args.url ?? "");
       if (!url) return errorResult("url is required");
       const from = adapter.getLocation().url;
@@ -2862,6 +2898,8 @@ function registerNavigationBridge(host, options) {
     {},
     [],
     async () => {
+      const stale = staleIntent();
+      if (stale) return stale;
       if (!adapter.back) return errorResult("Host did not provide back navigation.");
       await adapter.back();
       return textResult("Went back");
@@ -2874,6 +2912,8 @@ function registerNavigationBridge(host, options) {
     {},
     [],
     async () => {
+      const stale = staleIntent();
+      if (stale) return stale;
       if (!adapter.forward) return errorResult("Host did not provide forward navigation.");
       await adapter.forward();
       return textResult("Went forward");
@@ -2890,6 +2930,8 @@ function registerNavigationBridge(host, options) {
     },
     [],
     (args) => {
+      const stale = staleIntent();
+      if (stale) return stale;
       const handle = typeof args.handle === "string" ? args.handle : void 0;
       adapter.scrollTo({
         handle,
@@ -2906,6 +2948,8 @@ function registerNavigationBridge(host, options) {
     { dy: { type: "number" } },
     ["dy"],
     (args) => {
+      const stale = staleIntent();
+      if (stale) return stale;
       adapter.scrollBy(Number(args.dy ?? 0));
       return textResult(`Scrolled by ${Number(args.dy ?? 0)}px`);
     },
@@ -2920,6 +2964,8 @@ function registerNavigationBridge(host, options) {
     },
     ["handle", "value"],
     (args) => {
+      const stale = staleIntent();
+      if (stale) return stale;
       const handle = String(args.handle ?? "");
       const res = adapter.setField(handle, args.value);
       if (!res.ok) return errorResult(res.error ?? `Could not set ${handle}`);
@@ -2933,6 +2979,8 @@ function registerNavigationBridge(host, options) {
     { handle: { type: "string" } },
     ["handle"],
     async (args) => {
+      const stale = staleIntent();
+      if (stale) return stale;
       const handle = String(args.handle ?? "");
       const action = adapter.describe().actions.find((a) => a.handle === handle);
       const rect = adapter.rectFor?.(handle) ?? void 0;
@@ -2952,6 +3000,8 @@ function registerNavigationBridge(host, options) {
     { handle: { type: "string" } },
     ["handle"],
     async (args) => {
+      const stale = staleIntent();
+      if (stale) return stale;
       const handle = String(args.handle ?? "");
       const rect = adapter.rectFor?.(handle) ?? void 0;
       if (pendingMode && adapter.confirm) {
@@ -3853,6 +3903,7 @@ function constantTimeEqual(a, b) {
 }
 
 // src/sharing/sse-relay.ts
+init_registry();
 var SseRelayTransport = class {
   constructor(options) {
     this.disposed = false;
@@ -3860,6 +3911,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 +4010,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 +4108,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 +4129,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 +4913,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;