@particle-academy/agent-integrations 0.33.0 → 0.35.0

package/dist/components-shared-whiteboard.js

@@ -1,5 +1,5 @@
-import { ShareControls, AgentCursor, AgentActivityHighlight, AgentPanel } from './chunk-SJTLTITO.js';
-import { createSessionDescriptor, attachSseRelay } from './chunk-N6RLSLOF.js';
+import { ShareControls, AgentCursor, AgentActivityHighlight, AgentPanel } from './chunk-ABP2THQV.js';
+import { createSessionDescriptor, attachSseRelay } from './chunk-JDCB2NMM.js';
 import { attachInProcess } from './chunk-AFUULW5E.js';
 import { registerWhiteboardBridge } from './chunk-2U5JB6ZA.js';
 import './chunk-CT3LRNH7.js';

package/dist/index.cjs

@@ -3896,10 +3896,196 @@ function registerFeaturesBridge(host, options) {
     }
   };
 }
+
+// src/bridges/passkeys.ts
 var DEFAULT_AGENT14 = { id: "agent", name: "Agent", color: "#a855f7" };
+var str6 = (v, fallback = "") => typeof v === "string" ? v : fallback;
+function toSummary(record) {
+  return {
+    id: str6(record?.id),
+    name: typeof record?.name === "string" ? record.name : null,
+    createdAt: str6(record?.createdAt),
+    lastUsedAt: typeof record?.lastUsedAt === "string" ? record.lastUsedAt : null,
+    transports: Array.isArray(record?.transports) ? record.transports.map((t) => String(t)) : [],
+    backedUp: record?.backedUp === true,
+    aaguid: str6(record?.aaguid),
+    clonedAt: typeof record?.clonedAt === "string" ? record.clonedAt : null
+  };
+}
+var PASSKEY_BRIDGE_TOOLS = [
+  "passkey_list",
+  "passkey_status",
+  "passkey_rename",
+  "passkey_revoke",
+  "passkey_begin_enrollment"
+];
+function registerPasskeyBridge(host, options) {
+  const { adapter } = options;
+  const agent = { ...DEFAULT_AGENT14, ...options.agent ?? {} };
+  const surfaceId = adapter.id ?? "passkeys";
+  const disposers = [];
+  ensureUndoToolsRegistered(host, { defaultAgentId: agent.id });
+  const target = (elementId, label) => ({
+    kind: "custom",
+    screenId: adapter.screenId,
+    elementId,
+    label: label ?? surfaceId
+  });
+  const reg = (name, description, properties, required, handler, resolveTarget) => {
+    const wrapped = async (args) => {
+      try {
+        return await handler(args);
+      } catch (e) {
+        return errorResult(e instanceof Error ? e.message : String(e));
+      }
+    };
+    const final = resolveTarget ? wrapToolWithActivity(wrapped, {
+      toolName: name,
+      agent,
+      kind: "custom",
+      screenId: adapter.screenId,
+      resolveTarget: ({ args }) => resolveTarget(args)
+    }) : wrapped;
+    disposers.push(
+      host.registerTool(
+        {
+          name,
+          description,
+          inputSchema: {
+            type: "object",
+            properties,
+            required,
+            additionalProperties: false
+          }
+        },
+        final
+      )
+    );
+  };
+  const findById = async (id) => (await adapter.list()).map(toSummary).find((p) => p.id === id) ?? null;
+  reg(
+    "passkey_list",
+    "List the signed-in user's passkeys: credential id, label, when it was added and last used, transports, whether it is a synced passkey, and whether the server flagged it as a possible clone. Read-only. Public keys, user handles and signature counters are never returned.",
+    {},
+    [],
+    async () => {
+      const passkeys = (await adapter.list()).map(toSummary);
+      return textResult(JSON.stringify(passkeys, null, 2), { passkeys, count: passkeys.length });
+    },
+    false
+  );
+  reg(
+    "passkey_status",
+    "Read what this browser can do (passkey support, a built-in authenticator, autofill sign-in) and what the management surface is currently showing (busy/error, a revoke awaiting confirmation, a rename in progress).",
+    {},
+    [],
+    async () => {
+      const support = adapter.support ? await adapter.support() : null;
+      const state = adapter.state ? await adapter.state() : null;
+      const out = {
+        support,
+        state,
+        // Said in the payload, not only in the docs: an agent reading this to
+        // work out "how do I sign the user in" should find the answer here.
+        canCompleteCeremony: false,
+        note: "A passkey ceremony needs a user gesture and a biometric or PIN. No tool on this bridge can perform one; ask the human to complete it on their device."
+      };
+      return textResult(JSON.stringify(out, null, 2), out);
+    },
+    false
+  );
+  reg(
+    "passkey_rename",
+    "Rename one passkey, by credential id (from passkey_list). Cosmetic and undoable with agent_undo.",
+    {
+      id: { type: "string", description: "base64url credential id." },
+      name: { type: "string", description: "New label, e.g. 'MacBook Touch ID'. Empty string clears it." }
+    },
+    ["id", "name"],
+    async (args) => {
+      const id = str6(args.id);
+      const name = str6(args.name);
+      if (!id) return errorResult("id is required.");
+      const existing = await findById(id);
+      if (!existing) return errorResult(`No passkey with id ${id}.`);
+      if (options.confirmRename) {
+        if (!options.confirm) {
+          return errorResult(
+            "passkey_rename requires confirmation (confirmRename), but the host wired no confirm hook."
+          );
+        }
+        const ok = await options.confirm({ action: "passkey_rename", id, name });
+        if (!ok) return errorResult(`Declined: rename ${id} (human did not confirm).`);
+      }
+      const previous = existing.name ?? "";
+      await adapter.rename({ id, name });
+      fancyAutoCommon.pushUndoEntry(agent.id, {
+        timestamp: Date.now(),
+        bridgeId: surfaceId,
+        action: "passkey_rename",
+        label: `Renamed passkey to ${name || "(unnamed)"}`,
+        undo: () => void adapter.rename({ id, name: previous }),
+        redo: () => void adapter.rename({ id, name })
+      });
+      return textResult(`Renamed passkey ${id} to ${name || "(unnamed)"}`, { id, name, previous });
+    },
+    (args) => target(str6(args.id), `rename ${str6(args.id)}`)
+  );
+  reg(
+    "passkey_revoke",
+    "PROPOSE revoking one passkey. This does NOT revoke it: the request is staged on the surface and the human confirms or cancels there. Revoking the last passkey can lock the user out, and the response says when that is the case so you can tell them before they confirm.",
+    { id: { type: "string", description: "base64url credential id." } },
+    ["id"],
+    async (args) => {
+      const id = str6(args.id);
+      if (!id) return errorResult("id is required.");
+      const existing = await findById(id);
+      if (!existing) return errorResult(`No passkey with id ${id}.`);
+      const proposal = await adapter.proposeRevoke({ id });
+      const isLastPasskey = proposal?.isLastPasskey === true;
+      const out = {
+        id,
+        name: existing.name,
+        staged: true,
+        awaitingHuman: true,
+        isLastPasskey
+      };
+      return textResult(
+        isLastPasskey ? `Staged a revoke of ${existing.name ?? id}. This is the account's LAST passkey \u2014 confirming it removes passkey sign-in entirely. Waiting for the human to confirm or cancel.` : `Staged a revoke of ${existing.name ?? id}. Waiting for the human to confirm or cancel on the surface.`,
+        out
+      );
+    },
+    (args) => target(str6(args.id), `propose revoke ${str6(args.id)}`)
+  );
+  reg(
+    "passkey_begin_enrollment",
+    "Ask the surface to start enrolling a new passkey. This only opens the prompt: the ceremony completes on the human's authenticator (Touch ID, Windows Hello, phone, security key) or it does not complete at all. Returns immediately.",
+    { name: { type: "string", description: "Optional label to pre-fill for the new passkey." } },
+    [],
+    async (args) => {
+      if (!adapter.beginEnrollment) return errorResult("Host did not wire beginEnrollment().");
+      const name = args.name === void 0 ? void 0 : str6(args.name);
+      await adapter.beginEnrollment(name === void 0 ? {} : { name });
+      const out = { awaitingHuman: true, ...name === void 0 ? {} : { name } };
+      return textResult(
+        "Enrollment prompt opened. The human has to complete it on their authenticator \u2014 there is no tool that can finish it for them.",
+        out
+      );
+    },
+    (args) => target(void 0, `begin enrollment${args.name ? ` (${str6(args.name)})` : ""}`)
+  );
+  return {
+    id: `passkeys:${surfaceId}`,
+    title: adapter.title ?? "Passkeys",
+    dispose: () => {
+      for (const d of disposers.splice(0)) d();
+    }
+  };
+}
+var DEFAULT_AGENT15 = { id: "agent", name: "Agent", color: "#a855f7" };
 function registerDocBridge(host, options) {
   const { adapter, surface } = options;
-  const agent = { ...DEFAULT_AGENT14, ...options.agent ?? {} };
+  const agent = { ...DEFAULT_AGENT15, ...options.agent ?? {} };
   const reducer = options.reducer ?? fancyDocCommons.treeReducer();
   const stage = options.stagePolicy ?? fancyDocCommons.autoApply;
   const makeNode = options.makeNode ?? (({ id, type, parent, order }, props) => ({ id, type, parent, order, props }));
@@ -4271,6 +4457,7 @@ var SseRelayTransport = class {
     this.listeners = /* @__PURE__ */ new Set();
     this.state = "idle";
     this.peers = /* @__PURE__ */ new Set();
+    this.peerListeners = /* @__PURE__ */ new Set();
     this.opts = options;
     this.expectedToken = options.token;
   }
@@ -4331,6 +4518,8 @@ var SseRelayTransport = class {
     this.es?.close();
     this.es = void 0;
     this.connected = false;
+    this.peers.clear();
+    this.notifyPeers();
     this.setState("closed");
   }
   onStateChange(listener) {
@@ -4338,6 +4527,28 @@ var SseRelayTransport = class {
     listener(this.state);
     return () => this.listeners.delete(listener);
   }
+  /** How many remote peers (agents) are currently attached to this session. */
+  peerCount() {
+    return this.peers.size;
+  }
+  /**
+   * Subscribe to peer arrivals/departures. Fires immediately with the current
+   * count.
+   *
+   * This is the ONLY honest answer to "is an agent actually here?".
+   * `onStateChange` reports the BROWSER's own channel to the relay, which opens
+   * the instant sharing starts — so a UI keyed on it announces "Agent is
+   * driving" to a human who has not yet handed the link to anybody, and can
+   * never tell them when one really arrives.
+   */
+  onPeersChange(listener) {
+    this.peerListeners.add(listener);
+    listener(this.peers.size);
+    return () => this.peerListeners.delete(listener);
+  }
+  notifyPeers() {
+    for (const l of this.peerListeners) l(this.peers.size);
+  }
   /**
    * For relays that wrap each frame with auth metadata: hosts can call this
    * directly when a frame arrives via a non-SSE path. The transport will
@@ -4372,6 +4583,7 @@ var SseRelayTransport = class {
     if ("method" in message && message.method === "notifications/peer_joined") {
       const subscriberId = String(message.params?.subscriberId ?? "peer");
       this.peers.add(subscriberId);
+      this.notifyPeers();
       fancyAutoCommon.emitActivity({
         agentId: "agent",
         agentName: "Agent",
@@ -4386,6 +4598,7 @@ var SseRelayTransport = class {
     if ("method" in message && message.method === "notifications/peer_left") {
       const subscriberId = String(message.params?.subscriberId ?? "peer");
       this.peers.delete(subscriberId);
+      this.notifyPeers();
       if (this.peers.size === 0) {
         fancyAutoCommon.emitActivity({
           agentId: "agent",
@@ -4431,11 +4644,11 @@ function attachSseRelay(server, options) {
 
 // src/sharing/use-co-browse-session.ts
 init_registry();
-var DEFAULT_AGENT15 = { id: "agent", name: "Agent", color: "#a855f7" };
+var DEFAULT_AGENT16 = { id: "agent", name: "Agent", color: "#a855f7" };
 var USER = { id: "human", name: "You" };
 function useCoBrowseSession(options) {
   const { adapter, extraBridges } = options;
-  const agent = { ...DEFAULT_AGENT15, ...options.agent ?? {} };
+  const agent = { ...DEFAULT_AGENT16, ...options.agent ?? {} };
   const relayBaseUrl = options.relayBaseUrl ?? "/agent-relay";
   const serverRef = react.useRef(null);
   const relayRef = react.useRef(null);
@@ -4443,6 +4656,7 @@ function useCoBrowseSession(options) {
   const disposeBridge = react.useRef(null);
   const [session, setSession] = react.useState(null);
   const [relayState, setRelayState] = react.useState("idle");
+  const [agentCount, setAgentCount] = react.useState(0);
   react.useEffect(() => {
     const server = new MicroMcpServer({
       info: options.info ?? { name: "fancy-co-browse", version: "0.1.0" },
@@ -4477,6 +4691,7 @@ function useCoBrowseSession(options) {
     }
     const relay = attachSseRelay(server, { baseUrl: relayBaseUrl, sessionId: descriptor.id, token: descriptor.token });
     relay.onStateChange(setRelayState);
+    relay.onPeersChange(setAgentCount);
     relayRef.current = relay;
     setSession(descriptor);
   }, [relayBaseUrl, options]);
@@ -4485,6 +4700,7 @@ function useCoBrowseSession(options) {
     relayRef.current?.close();
     relayRef.current = null;
     setRelayState("idle");
+    setAgentCount(0);
     setSession(null);
     if (current) {
       const csrf = options.csrfToken?.() ?? "";
@@ -4507,7 +4723,16 @@ function useCoBrowseSession(options) {
       meta: event
     });
   }, []);
-  return { server: serverRef.current, session, relayState, startShare, stopShare, observeUser };
+  return {
+    server: serverRef.current,
+    session,
+    relayState,
+    agentConnected: agentCount > 0,
+    agentCount,
+    startShare,
+    stopShare,
+    observeUser
+  };
 }
 function AgentPanel({ agent, activity, onSubmit, busy, actions, className, style }) {
   const scrollRef = react.useRef(null);
@@ -5230,10 +5455,12 @@ function ManualPopover({
     /* @__PURE__ */ jsxRuntime.jsx("button", { type: "button", className: "fai-connect__copy-btn", onClick: onCopy, children: copied ? "Copied" : "Copy snippet" })
   ] });
 }
+var LIFECYCLE_ACTIONS = /* @__PURE__ */ new Set(["agent_connected", "agent_disconnected"]);
 function CoBrowsePresence({ session, connectUrl, shareBaseUrl, className }) {
   const { events } = useAgentActivity(void 0, { capacity: 40 });
-  const lastAgentAction = [...events].reverse().find((e) => (e.source ?? "agent") !== "user");
-  const connected = session.relayState === "open";
+  const lastAgentAction = [...events].reverse().find((e) => (e.source ?? "agent") !== "user" && !LIFECYCLE_ACTIONS.has(e.action));
+  const connected = session.agentConnected;
+  const activity = react.useMemo(() => events.map(toPanelActivity), [events]);
   if (!session.session) {
     return /* @__PURE__ */ jsxRuntime.jsx("div", { className, "data-co-browse-presence": "idle", children: /* @__PURE__ */ jsxRuntime.jsx("button", { type: "button", onClick: () => void session.startShare(), "data-co-browse-start": true, children: "Let an agent drive" }) });
   }
@@ -5251,12 +5478,25 @@ function CoBrowsePresence({ session, connectUrl, shareBaseUrl, className }) {
         onStart: () => void session.startShare(),
         onStop: session.stopShare,
         status: session.relayState,
+        agentConnected: connected,
+        activity,
         shareBaseUrl
       }
     ),
     connectUrl && /* @__PURE__ */ jsxRuntime.jsx(ConnectorButtons, { serverName: "Fancy UI co-browse", mcpUrl: connectUrl })
   ] });
 }
+function toPanelActivity(event) {
+  const who = (event.source ?? "agent") === "user" ? "You" : event.agentName ?? "Agent";
+  return {
+    id: `${event.timestamp}-${event.action}-${event.target?.elementId ?? event.target?.label ?? ""}`,
+    at: event.timestamp,
+    kind: LIFECYCLE_ACTIONS.has(event.action) ? "info" : "tool",
+    source: who,
+    text: event.target?.label ?? event.action,
+    detail: event.meta
+  };
+}
 CoBrowsePresence.displayName = "CoBrowsePresence";
 var CURSOR_EDGE_INSET = 24;
 var FLUID_CURSOR_SPEED_PX_PER_SECOND = 1050;
@@ -5275,19 +5515,26 @@ function fluidGlideDuration(from, to) {
   const distance = Math.hypot(to.x - from.x, to.y - from.y);
   return Math.round(Math.min(MAX_GLIDE_MS, Math.max(MIN_GLIDE_MS, distance / FLUID_CURSOR_SPEED_PX_PER_SECOND * 1e3)));
 }
-function CoBrowseCursorLayer({ active = true, zIndex = 2147483e3 }) {
+var LIFECYCLE_ACTIONS2 = /* @__PURE__ */ new Set(["agent_connected", "agent_disconnected"]);
+function CoBrowseCursorLayer({
+  active = true,
+  zIndex = 2147483e3,
+  idleAfterMs = 15e3
+}) {
   const { latest } = useAgentActivity(void 0, { capacity: 12 });
   const [cursor, setCursor] = react.useState(
     null
   );
   const [pulse, setPulse] = react.useState(null);
+  const [lastActionAt, setLastActionAt] = react.useState(0);
   react.useEffect(() => {
     if (!latest || (latest.source ?? "agent") === "user") return;
-    if (latest.action === "agent_disconnected") {
-      setCursor((prev) => prev ? { ...prev, status: "Standing by", glideMs: 0 } : prev);
+    if (LIFECYCLE_ACTIONS2.has(latest.action)) {
+      setCursor((prev) => prev ? { ...prev, status: "Standing by", glideMs: 0 } : null);
       setPulse(null);
       return;
     }
+    setLastActionAt(latest.timestamp);
     const color = latest.agentColor ?? "#a855f7";
     const name = latest.agentName ?? "Agent";
     const status = latest.target?.label ?? latest.action;
@@ -5309,6 +5556,14 @@ function CoBrowseCursorLayer({ active = true, zIndex = 2147483e3 }) {
       );
     }
   }, [latest?.timestamp]);
+  react.useEffect(() => {
+    if (!idleAfterMs || !lastActionAt) return;
+    const timer = setTimeout(() => {
+      setCursor(null);
+      setPulse(null);
+    }, idleAfterMs);
+    return () => clearTimeout(timer);
+  }, [lastActionAt, idleAfterMs]);
   if (!active || !cursor || typeof document === "undefined") return null;
   return reactDom.createPortal(
     /* @__PURE__ */ jsxRuntime.jsxs("div", { "data-co-browse-cursor-layer": "", style: { position: "fixed", inset: 0, pointerEvents: "none", zIndex }, children: [
@@ -5654,6 +5909,7 @@ exports.MCPB_MIN_NODE = MCPB_MIN_NODE;
 exports.MCP_PROTOCOL_VERSION = MCP_PROTOCOL_VERSION;
 exports.MemoryHumanPlusEventStore = MemoryHumanPlusEventStore;
 exports.MicroMcpServer = MicroMcpServer;
+exports.PASSKEY_BRIDGE_TOOLS = PASSKEY_BRIDGE_TOOLS;
 exports.RelayTransport = RelayTransport;
 exports.ScreensActivityBridge = ScreensActivityBridge;
 exports.ShareControls = ShareControls;
@@ -5695,6 +5951,7 @@ exports.registerFormBridge = registerFormBridge;
 exports.registerGitBridge = registerGitBridge;
 exports.registerMapBridge = registerMapBridge;
 exports.registerNavigationBridge = registerNavigationBridge;
+exports.registerPasskeyBridge = registerPasskeyBridge;
 exports.registerSceneBridge = registerSceneBridge;
 exports.registerScreensBridge = registerScreensBridge;
 exports.registerSheetsBridge = registerSheetsBridge;