@particle-academy/agent-integrations 0.32.0 → 0.34.0

package/dist/components-shared-whiteboard.js

@@ -1,4 +1,4 @@
-import { ShareControls, AgentCursor, AgentActivityHighlight, AgentPanel } from './chunk-HSI5RVF4.js';
+import { ShareControls, AgentCursor, AgentActivityHighlight, AgentPanel } from './chunk-SJTLTITO.js';
 import { createSessionDescriptor, attachSseRelay } from './chunk-N6RLSLOF.js';
 import { attachInProcess } from './chunk-AFUULW5E.js';
 import { registerWhiteboardBridge } from './chunk-2U5JB6ZA.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 }));
@@ -4431,11 +4617,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);
@@ -4772,11 +4958,21 @@ function ShareControls({
   onStart,
   onStop,
   status,
+  agentConnected = false,
+  activity,
   shareBaseUrl,
   className,
   style
 }) {
   const [tab, setTab] = react.useState("prompt");
+  const wasConnected = react.useRef(false);
+  react.useEffect(() => {
+    if (agentConnected && !wasConnected.current) {
+      wasConnected.current = true;
+      setTab("activity");
+    }
+    if (!agentConnected) wasConnected.current = false;
+  }, [agentConnected]);
   if (!session) {
     return /* @__PURE__ */ jsxRuntime.jsxs("div", { className: ["fai-share fai-share--idle", className ?? ""].filter(Boolean).join(" "), style, children: [
       /* @__PURE__ */ jsxRuntime.jsx("button", { type: "button", className: "fai-share__start", onClick: onStart, children: "Start shared session" }),
@@ -4811,12 +5007,14 @@ function ShareControls({
       ] })
     ] }),
     /* @__PURE__ */ jsxRuntime.jsxs("div", { className: "fai-share__tabs", role: "tablist", children: [
+      agentConnected && /* @__PURE__ */ jsxRuntime.jsx(TabButton, { tab: "activity", active: tab, setTab, children: "Activity" }),
       /* @__PURE__ */ jsxRuntime.jsx(TabButton, { tab: "prompt", active: tab, setTab, children: "Agent prompt" }),
       /* @__PURE__ */ jsxRuntime.jsx(TabButton, { tab: "url", active: tab, setTab, children: "URL" }),
       /* @__PURE__ */ jsxRuntime.jsx(TabButton, { tab: "json", active: tab, setTab, children: "JSON" }),
       /* @__PURE__ */ jsxRuntime.jsx(TabButton, { tab: "curl", active: tab, setTab, children: "cURL recipe" })
     ] }),
     /* @__PURE__ */ jsxRuntime.jsxs("div", { className: "fai-share__panel", children: [
+      tab === "activity" && /* @__PURE__ */ jsxRuntime.jsx(ActivityLog, { activity }),
       tab === "prompt" && /* @__PURE__ */ jsxRuntime.jsx(
         CopyBox,
         {
@@ -4844,6 +5042,21 @@ function ShareControls({
     ] })
   ] });
 }
+function ActivityLog({ activity }) {
+  const entries = (activity ?? []).slice().reverse();
+  if (entries.length === 0) {
+    return /* @__PURE__ */ jsxRuntime.jsx("p", { className: "fai-share__empty", children: "Connected. Nothing yet \u2014 actions appear here as the agent takes them." });
+  }
+  return /* @__PURE__ */ jsxRuntime.jsx("ol", { className: "fai-share__activity", "aria-live": "polite", children: entries.map((entry) => /* @__PURE__ */ jsxRuntime.jsxs("li", { className: "fai-share__activity-row", "data-kind": entry.kind, children: [
+    /* @__PURE__ */ jsxRuntime.jsx("time", { className: "fai-share__activity-time", dateTime: new Date(entry.at).toISOString(), children: new Date(entry.at).toLocaleTimeString(void 0, {
+      hour: "2-digit",
+      minute: "2-digit",
+      second: "2-digit"
+    }) }),
+    /* @__PURE__ */ jsxRuntime.jsx("span", { className: "fai-share__activity-source", children: entry.source }),
+    /* @__PURE__ */ jsxRuntime.jsx("span", { className: "fai-share__activity-text", children: entry.text })
+  ] }, entry.id)) });
+}
 function TabButton({ tab, active, setTab, children }) {
   return /* @__PURE__ */ jsxRuntime.jsx(
     "button",
@@ -5627,6 +5840,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;
@@ -5668,6 +5882,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;