@agent-native/core 0.25.0 → 0.26.1

package/dist/collab/client.d.ts

@@ -50,6 +50,24 @@ export declare function emailToColor(email: string): string;
 /** Derive a display name from an email address. */
 export declare function emailToName(email: string): string;
 export declare function dedupeCollabUsersByEmail(users: CollabUser[]): CollabUser[];
+/**
+ * Leader election for applying authoritative external snapshots into a shared
+ * collaborative document.
+ *
+ * When the agent (or a Notion pull, or any full-document rewrite) writes new
+ * content to SQL, the open editor reconciles it into the live Y.Doc with
+ * `setContent`. If EVERY connected client did that independently, each would
+ * diff the same snapshot into the CRDT and the changed region would be inserted
+ * N times (concurrent inserts at the same position → duplicated text). So only
+ * ONE client — the "lead" — applies the snapshot; every other client receives
+ * the result through normal Yjs sync.
+ *
+ * The lead is the present client with the lowest Yjs `clientID`. The agent's
+ * awareness entry uses `AGENT_CLIENT_ID` (max int) so it can never be the lead,
+ * and a client editing alone is always the lead. This is deterministic across
+ * clients with no coordination round-trip.
+ */
+export declare function isReconcileLeadClient(awareness: Awareness | null | undefined, localClientId: number | null | undefined): boolean;
 export interface RemoteAwarenessSnapshot {
     clientId: number;
     state: unknown;

package/dist/collab/client.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../../src/collab/client.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAGH,OAAO,KAAK,CAAC,MAAM,KAAK,CAAC;AACzB,OAAO,EAAE,SAAS,EAAE,MAAM,uBAAuB,CAAC;AAGlD,MAAM,WAAW,UAAU;IACzB,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,0BAA0B;IACzC,2DAA2D;IAC3D,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IACrB,yCAAyC;IACzC,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,kFAAkF;IAClF,eAAe,CAAC,EAAE,OAAO,CAAC;IAC1B,sEAAsE;IACtE,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,8DAA8D;IAC9D,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,2CAA2C;IAC3C,IAAI,CAAC,EAAE,UAAU,CAAC;CACnB;AAED,MAAM,WAAW,yBAAyB;IACxC,4EAA4E;IAC5E,IAAI,EAAE,CAAC,CAAC,GAAG,GAAG,IAAI,CAAC;IACnB,uDAAuD;IACvD,SAAS,EAAE,SAAS,GAAG,IAAI,CAAC;IAC5B,kEAAkE;IAClE,SAAS,EAAE,OAAO,CAAC;IACnB,iDAAiD;IACjD,QAAQ,EAAE,OAAO,CAAC;IAClB,sDAAsD;IACtD,WAAW,EAAE,UAAU,EAAE,CAAC;IAC1B,6EAA6E;IAC7E,WAAW,EAAE,OAAO,CAAC;IACrB,+EAA+E;IAC/E,YAAY,EAAE,OAAO,CAAC;CACvB;AAgBD,4DAA4D;AAC5D,wBAAgB,YAAY,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAMlD;AAED,mDAAmD;AACnD,wBAAgB,WAAW,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAGjD;AAYD,wBAAgB,wBAAwB,CAAC,KAAK,EAAE,UAAU,EAAE,GAAG,UAAU,EAAE,CAY1E;AAED,MAAM,WAAW,uBAAuB;IACtC,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,OAAO,CAAC;CAChB;AAED,wBAAgB,8BAA8B,CAC5C,MAAM,EAAE,GAAG,CAAC,MAAM,EAAE,OAAO,CAAC,EAC5B,aAAa,EAAE,MAAM,EACrB,YAAY,EAAE,uBAAuB,EAAE,GACtC;IAAE,KAAK,EAAE,MAAM,EAAE,CAAC;IAAC,OAAO,EAAE,MAAM,EAAE,CAAC;IAAC,OAAO,EAAE,MAAM,EAAE,CAAA;CAAE,CA2B3D;AAoBD,wBAAgB,mBAAmB,CACjC,OAAO,EAAE,0BAA0B,GAClC,yBAAyB,CAgU3B"}
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../../src/collab/client.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAGH,OAAO,KAAK,CAAC,MAAM,KAAK,CAAC;AACzB,OAAO,EAAE,SAAS,EAAE,MAAM,uBAAuB,CAAC;AAIlD,MAAM,WAAW,UAAU;IACzB,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,0BAA0B;IACzC,2DAA2D;IAC3D,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IACrB,yCAAyC;IACzC,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,kFAAkF;IAClF,eAAe,CAAC,EAAE,OAAO,CAAC;IAC1B,sEAAsE;IACtE,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,8DAA8D;IAC9D,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,2CAA2C;IAC3C,IAAI,CAAC,EAAE,UAAU,CAAC;CACnB;AAED,MAAM,WAAW,yBAAyB;IACxC,4EAA4E;IAC5E,IAAI,EAAE,CAAC,CAAC,GAAG,GAAG,IAAI,CAAC;IACnB,uDAAuD;IACvD,SAAS,EAAE,SAAS,GAAG,IAAI,CAAC;IAC5B,kEAAkE;IAClE,SAAS,EAAE,OAAO,CAAC;IACnB,iDAAiD;IACjD,QAAQ,EAAE,OAAO,CAAC;IAClB,sDAAsD;IACtD,WAAW,EAAE,UAAU,EAAE,CAAC;IAC1B,6EAA6E;IAC7E,WAAW,EAAE,OAAO,CAAC;IACrB,+EAA+E;IAC/E,YAAY,EAAE,OAAO,CAAC;CACvB;AAgBD,4DAA4D;AAC5D,wBAAgB,YAAY,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAMlD;AAED,mDAAmD;AACnD,wBAAgB,WAAW,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAGjD;AAYD,wBAAgB,wBAAwB,CAAC,KAAK,EAAE,UAAU,EAAE,GAAG,UAAU,EAAE,CAY1E;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,qBAAqB,CACnC,SAAS,EAAE,SAAS,GAAG,IAAI,GAAG,SAAS,EACvC,aAAa,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,GACvC,OAAO,CA6BT;AAED,MAAM,WAAW,uBAAuB;IACtC,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,OAAO,CAAC;CAChB;AAED,wBAAgB,8BAA8B,CAC5C,MAAM,EAAE,GAAG,CAAC,MAAM,EAAE,OAAO,CAAC,EAC5B,aAAa,EAAE,MAAM,EACrB,YAAY,EAAE,uBAAuB,EAAE,GACtC;IAAE,KAAK,EAAE,MAAM,EAAE,CAAC;IAAC,OAAO,EAAE,MAAM,EAAE,CAAC;IAAC,OAAO,EAAE,MAAM,EAAE,CAAA;CAAE,CA2B3D;AAoBD,wBAAgB,mBAAmB,CACjC,OAAO,EAAE,0BAA0B,GAClC,yBAAyB,CA0V3B"}

package/dist/collab/client.js

@@ -12,6 +12,7 @@ import { useEffect, useRef, useState, useMemo } from "react";
 import * as Y from "yjs";
 import { Awareness } from "y-protocols/awareness";
 import { agentNativePath } from "../client/api-path.js";
+import { AGENT_CLIENT_ID } from "./agent-identity.js";
 // Consistent color palette for user cursors
 const CURSOR_COLORS = [
     "#f87171",
@@ -58,6 +59,57 @@ export function dedupeCollabUsersByEmail(users) {
     }
     return Array.from(byEmail.values());
 }
+/**
+ * Leader election for applying authoritative external snapshots into a shared
+ * collaborative document.
+ *
+ * When the agent (or a Notion pull, or any full-document rewrite) writes new
+ * content to SQL, the open editor reconciles it into the live Y.Doc with
+ * `setContent`. If EVERY connected client did that independently, each would
+ * diff the same snapshot into the CRDT and the changed region would be inserted
+ * N times (concurrent inserts at the same position → duplicated text). So only
+ * ONE client — the "lead" — applies the snapshot; every other client receives
+ * the result through normal Yjs sync.
+ *
+ * The lead is the present client with the lowest Yjs `clientID`. The agent's
+ * awareness entry uses `AGENT_CLIENT_ID` (max int) so it can never be the lead,
+ * and a client editing alone is always the lead. This is deterministic across
+ * clients with no coordination round-trip.
+ */
+export function isReconcileLeadClient(awareness, localClientId) {
+    if (localClientId == null)
+        return false;
+    if (!awareness)
+        return true; // standalone / tests — act alone
+    let hasPeer = false;
+    let minVisible = localClientId;
+    awareness.getStates().forEach((state, clientId) => {
+        if (clientId === AGENT_CLIENT_ID)
+            return; // agent never leads
+        if (clientId === localClientId)
+            return;
+        const s = state;
+        if (!s || !s.user)
+            return; // skip empty/stale entries
+        hasPeer = true;
+        // Only VISIBLE peers can act; a peer published `visible: false` (backgrounded)
+        // is skipped. A peer that hasn't published the field is treated as visible.
+        if (s.visible !== false && clientId < minVisible)
+            minVisible = clientId;
+    });
+    // Sole client: always the applier — no other client can duplicate the edit,
+    // so single-user agent edits apply even if this tab reports hidden.
+    if (!hasPeer)
+        return true;
+    // With peers present, exactly one VISIBLE client applies (the lowest clientId
+    // among visible ones). A backgrounded tab pauses its poll and can't reliably
+    // act, so it yields — otherwise an agent edit would never reach the tab the
+    // user is actually looking at. The caller re-elects on visibility change.
+    const localHidden = typeof document !== "undefined" && document.visibilityState === "hidden";
+    if (localHidden)
+        return false;
+    return localClientId <= minVisible;
+}
 export function reconcileRemoteAwarenessStates(states, localClientId, remoteStates) {
     const incoming = new Set();
     const added = [];
@@ -124,7 +176,10 @@ export function useCollaborativeDoc(options) {
     const [docMissing, setDocMissing] = useState(false);
     const agentTimerRef = useRef(null);
     const pollVersionRef = useRef(0);
-    // Set local awareness state (user info for cursor labels)
+    // Set local awareness state (user info for cursor labels). Also publish this
+    // tab's visibility so peers can elect a VISIBLE client to apply external
+    // snapshots (see isReconcileLeadClient) — a backgrounded tab pauses its poll
+    // and must not hold that role.
     useEffect(() => {
         if (!awareness || !user)
             return;
@@ -133,6 +188,7 @@ export function useCollaborativeDoc(options) {
             email: user.email,
             color: user.color,
         });
+        awareness.setLocalStateField("visible", !isDocumentHidden());
     }, [awareness, user?.name, user?.email, user?.color]);
     // Track active users from awareness changes
     useEffect(() => {
@@ -335,8 +391,31 @@ export function useCollaborativeDoc(options) {
             }
             void poll();
         }
+        // Publish this tab's visibility to peers. A hidden tab pauses its poll, so
+        // we push the state immediately (keepalive) instead of waiting for the next
+        // cycle — otherwise peers keep treating a backgrounded tab as the visible
+        // lead and an agent edit never lands on the tab the user is looking at.
+        function publishVisibility(visible) {
+            if (!awareness)
+                return;
+            awareness.setLocalStateField("visible", visible);
+            const localState = awareness.getLocalState();
+            if (!localState)
+                return;
+            fetch(`${baseUrl}/${docId}/awareness`, {
+                method: "POST",
+                headers: { "Content-Type": "application/json" },
+                body: JSON.stringify({
+                    clientId: ydoc.clientID,
+                    state: JSON.stringify(localState),
+                }),
+                keepalive: true,
+            }).catch(() => { });
+        }
         function handleVisibilityChange() {
-            if (document.visibilityState === "visible") {
+            const visible = document.visibilityState === "visible";
+            publishVisibility(visible);
+            if (visible) {
                 pollNow();
             }
             else if (pauseWhenHidden && timer) {

package/dist/collab/client.js.map

@@ -1 +1 @@
-{"version":3,"file":"client.js","sourceRoot":"","sources":["../../src/collab/client.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * Client-side hook for collaborative document editing via Yjs.\n *\n * Creates a STABLE Y.Doc per docId that never changes identity. This allows\n * TipTap's Collaboration extension to bind once without editor recreation.\n * Server state is applied to the existing doc when it arrives.\n *\n * Also manages Yjs Awareness for cursor positions and user presence,\n * synced via polling to the server's awareness endpoint.\n */\n\nimport { useEffect, useRef, useState, useMemo } from \"react\";\nimport * as Y from \"yjs\";\nimport { Awareness } from \"y-protocols/awareness\";\nimport { agentNativePath } from \"../client/api-path.js\";\n\nexport interface CollabUser {\n  name: string;\n  email: string;\n  color: string;\n}\n\nexport interface UseCollaborativeDocOptions {\n  /** Document ID to collaborate on. Pass null to disable. */\n  docId: string | null;\n  /** Poll interval in ms. Default: 2000 */\n  pollInterval?: number;\n  /** Pause remote update/presence polling while the tab is hidden. Default: true */\n  pauseWhenHidden?: boolean;\n  /** Base URL for collab endpoints. Default: \"/_agent-native/collab\" */\n  baseUrl?: string;\n  /** Request source ID for jitter prevention (e.g., tab ID). */\n  requestSource?: string;\n  /** Current user info for cursor labels. */\n  user?: CollabUser;\n}\n\nexport interface UseCollaborativeDocResult {\n  /** The Yjs document instance. Stable per docId — never changes identity. */\n  ydoc: Y.Doc | null;\n  /** Yjs Awareness instance for cursor/presence sync. */\n  awareness: Awareness | null;\n  /** Whether the initial state is still loading from the server. */\n  isLoading: boolean;\n  /** Whether the doc is synced with the server. */\n  isSynced: boolean;\n  /** Active users on this document (from awareness). */\n  activeUsers: CollabUser[];\n  /** True briefly when the AI agent makes an edit (for presence indicator). */\n  agentActive: boolean;\n  /** True when the AI agent has an active awareness entry (durable presence). */\n  agentPresent: boolean;\n}\n\n// Consistent color palette for user cursors\nconst CURSOR_COLORS = [\n  \"#f87171\",\n  \"#fb923c\",\n  \"#fbbf24\",\n  \"#a3e635\",\n  \"#34d399\",\n  \"#22d3ee\",\n  \"#60a5fa\",\n  \"#14b8a6\",\n  \"#f472b6\",\n  \"#e879f9\",\n];\n\n/** Hash a string to a consistent color from the palette. */\nexport function emailToColor(email: string): string {\n  let hash = 0;\n  for (let i = 0; i < email.length; i++) {\n    hash = ((hash << 5) - hash + email.charCodeAt(i)) | 0;\n  }\n  return CURSOR_COLORS[Math.abs(hash) % CURSOR_COLORS.length];\n}\n\n/** Derive a display name from an email address. */\nexport function emailToName(email: string): string {\n  const local = email.split(\"@\")[0] || email;\n  return local.charAt(0).toUpperCase() + local.slice(1);\n}\n\nfunction normalizeCollabEmail(email: string): string {\n  return email.trim().toLowerCase();\n}\n\nfunction isDocumentHidden(): boolean {\n  return (\n    typeof document !== \"undefined\" && document.visibilityState === \"hidden\"\n  );\n}\n\nexport function dedupeCollabUsersByEmail(users: CollabUser[]): CollabUser[] {\n  const byEmail = new Map<string, CollabUser>();\n  for (const user of users) {\n    const email = normalizeCollabEmail(user.email);\n    if (!email || byEmail.has(email)) continue;\n    byEmail.set(email, {\n      name: user.name || emailToName(email),\n      email,\n      color: user.color || emailToColor(email),\n    });\n  }\n  return Array.from(byEmail.values());\n}\n\nexport interface RemoteAwarenessSnapshot {\n  clientId: number;\n  state: unknown;\n}\n\nexport function reconcileRemoteAwarenessStates(\n  states: Map<number, unknown>,\n  localClientId: number,\n  remoteStates: RemoteAwarenessSnapshot[],\n): { added: number[]; updated: number[]; removed: number[] } {\n  const incoming = new Set<number>();\n  const added: number[] = [];\n  const updated: number[] = [];\n  const removed: number[] = [];\n\n  for (const remote of remoteStates) {\n    if (\n      !Number.isFinite(remote.clientId) ||\n      remote.clientId === localClientId\n    ) {\n      continue;\n    }\n    incoming.add(remote.clientId);\n    const hadState = states.has(remote.clientId);\n    states.set(remote.clientId, remote.state);\n    (hadState ? updated : added).push(remote.clientId);\n  }\n\n  for (const clientId of Array.from(states.keys())) {\n    if (clientId === localClientId) continue;\n    if (incoming.has(clientId)) continue;\n    states.delete(clientId);\n    removed.push(clientId);\n  }\n\n  return { added, updated, removed };\n}\n\n// Base64 helpers\nfunction uint8ArrayToBase64(arr: Uint8Array): string {\n  let binary = \"\";\n  for (let i = 0; i < arr.length; i++) {\n    binary += String.fromCharCode(arr[i]);\n  }\n  return btoa(binary);\n}\n\nfunction base64ToUint8Array(b64: string): Uint8Array {\n  const binary = atob(b64);\n  const arr = new Uint8Array(binary.length);\n  for (let i = 0; i < binary.length; i++) {\n    arr[i] = binary.charCodeAt(i);\n  }\n  return arr;\n}\n\nexport function useCollaborativeDoc(\n  options: UseCollaborativeDocOptions,\n): UseCollaborativeDocResult {\n  const {\n    docId,\n    pollInterval = 2000,\n    pauseWhenHidden = true,\n    baseUrl = agentNativePath(\"/_agent-native/collab\"),\n    requestSource,\n    user,\n  } = options;\n\n  // Stable Y.Doc per docId\n  const ydoc = useMemo(() => {\n    if (!docId) return null;\n    return new Y.Doc();\n  }, [docId]);\n\n  // Stable Awareness per ydoc\n  const awareness = useMemo(() => {\n    if (!ydoc) return null;\n    return new Awareness(ydoc);\n  }, [ydoc]);\n\n  const [isLoading, setIsLoading] = useState(!!docId);\n  const [isSynced, setIsSynced] = useState(false);\n  const [activeUsers, setActiveUsers] = useState<CollabUser[]>([]);\n  const [agentActive, setAgentActive] = useState(false);\n  const [agentPresent, setAgentPresent] = useState(false);\n  // Set when the initial state fetch returns 404/403 — stops the awareness\n  // poll so we don't spam the console with errors against a doc that doesn't\n  // exist or isn't accessible.\n  const [docMissing, setDocMissing] = useState(false);\n  const agentTimerRef = useRef<ReturnType<typeof setTimeout> | null>(null);\n  const pollVersionRef = useRef(0);\n\n  // Set local awareness state (user info for cursor labels)\n  useEffect(() => {\n    if (!awareness || !user) return;\n    awareness.setLocalStateField(\"user\", {\n      name: user.name,\n      email: user.email,\n      color: user.color,\n    });\n  }, [awareness, user?.name, user?.email, user?.color]);\n\n  // Track active users from awareness changes\n  useEffect(() => {\n    if (!awareness) return;\n\n    const updateUsers = () => {\n      const users: CollabUser[] = [];\n      let hasAgent = false;\n      awareness.getStates().forEach((state, clientId) => {\n        if (clientId === ydoc?.clientID) return; // Skip self\n        if (state.user) {\n          users.push(state.user as CollabUser);\n          if ((state.user as CollabUser).email === \"agent@system\") {\n            hasAgent = true;\n          }\n        }\n      });\n      setActiveUsers(dedupeCollabUsersByEmail(users));\n      setAgentPresent(hasAgent);\n    };\n\n    awareness.on(\"change\", updateUsers);\n    return () => {\n      awareness.off(\"change\", updateUsers);\n    };\n  }, [awareness, ydoc]);\n\n  // Clean up on unmount or docId change\n  useEffect(() => {\n    return () => {\n      awareness?.destroy();\n      ydoc?.destroy();\n    };\n  }, [ydoc, awareness]);\n\n  // Fetch server state and apply to existing doc\n  useEffect(() => {\n    if (!ydoc || !docId) {\n      setIsLoading(false);\n      return;\n    }\n\n    let cancelled = false;\n    setIsLoading(true);\n    setIsSynced(false);\n    setDocMissing(false);\n\n    fetch(`${baseUrl}/${docId}/state`)\n      .then(async (res) => {\n        if (cancelled) return;\n        if (res.status === 404 || res.status === 403) {\n          setDocMissing(true);\n          setIsLoading(false);\n          setIsSynced(true);\n          return;\n        }\n        const data = (await res.json().catch(() => null)) as {\n          state?: string;\n        } | null;\n        if (data?.state) {\n          const binary = base64ToUint8Array(data.state);\n          if (binary.length > 4) {\n            Y.applyUpdate(ydoc, binary, \"remote\");\n          }\n        }\n        setIsLoading(false);\n        setIsSynced(true);\n      })\n      .catch(() => {\n        if (cancelled) return;\n        setIsLoading(false);\n        setIsSynced(true);\n      });\n\n    return () => {\n      cancelled = true;\n    };\n  }, [ydoc, docId, baseUrl]);\n\n  // Send local updates to server\n  useEffect(() => {\n    if (!ydoc || !docId || docMissing) return;\n\n    const handler = (update: Uint8Array, origin: unknown) => {\n      if (origin === \"remote\") return;\n\n      fetch(`${baseUrl}/${docId}/update`, {\n        method: \"POST\",\n        headers: { \"Content-Type\": \"application/json\" },\n        body: JSON.stringify({\n          update: uint8ArrayToBase64(update),\n          requestSource,\n        }),\n      });\n    };\n\n    ydoc.on(\"update\", handler);\n    return () => {\n      ydoc.off(\"update\", handler);\n    };\n  }, [ydoc, docId, baseUrl, requestSource, docMissing]);\n\n  // Poll for remote doc updates + awareness sync\n  useEffect(() => {\n    if (!ydoc || !docId || docMissing) return;\n\n    let stopped = false;\n    let timer: ReturnType<typeof setTimeout> | null = null;\n\n    function schedulePoll() {\n      if (stopped) return;\n      if (pauseWhenHidden && isDocumentHidden()) return;\n      timer = setTimeout(poll, pollInterval);\n    }\n\n    async function poll() {\n      if (stopped) return;\n      try {\n        // Poll for document updates\n        const res = await fetch(\n          agentNativePath(\n            `/_agent-native/poll?since=${pollVersionRef.current}`,\n          ),\n        );\n        if (!res.ok) throw new Error(\"HTTP \" + res.status);\n        const data = await res.json();\n        const { version, events } = data as {\n          version: number;\n          events: Array<{\n            source: string;\n            docId?: string;\n            update?: string;\n            requestSource?: string;\n          }>;\n        };\n\n        for (const evt of events) {\n          if (evt.source === \"collab\" && evt.docId === docId && evt.update) {\n            if (requestSource && evt.requestSource === requestSource) continue;\n            Y.applyUpdate(ydoc, base64ToUint8Array(evt.update), \"remote\");\n\n            // Show agent presence indicator briefly\n            if (evt.requestSource === \"agent\") {\n              setAgentActive(true);\n              if (agentTimerRef.current) clearTimeout(agentTimerRef.current);\n              agentTimerRef.current = setTimeout(\n                () => setAgentActive(false),\n                3000,\n              );\n            }\n          }\n        }\n\n        pollVersionRef.current = version;\n\n        try {\n          // The poll ring buffer is process-local. Fetching a state-vector diff\n          // makes collaboration durable across serverless invocations, process\n          // restarts, or any missed poll event.\n          const stateVector = uint8ArrayToBase64(Y.encodeStateVector(ydoc));\n          const stateRes = await fetch(\n            `${baseUrl}/${docId}/state?stateVector=${encodeURIComponent(\n              stateVector,\n            )}`,\n          );\n          if (stateRes.ok) {\n            const stateData = (await stateRes.json().catch(() => null)) as {\n              state?: string;\n            } | null;\n            if (stateData?.state) {\n              const binary = base64ToUint8Array(stateData.state);\n              if (binary.length > 2) {\n                Y.applyUpdate(ydoc, binary, \"remote\");\n              }\n            }\n          }\n        } catch {\n          // The next poll retries; awareness should still sync below.\n        }\n\n        // Sync awareness (cursor positions)\n        if (awareness) {\n          const localState = awareness.getLocalState();\n          if (localState) {\n            const awarenessRes = await fetch(`${baseUrl}/${docId}/awareness`, {\n              method: \"POST\",\n              headers: { \"Content-Type\": \"application/json\" },\n              body: JSON.stringify({\n                clientId: ydoc.clientID,\n                state: JSON.stringify(localState),\n              }),\n            });\n            if (awarenessRes.ok) {\n              const awarenessData = await awarenessRes.json();\n              const remoteStates: RemoteAwarenessSnapshot[] = [];\n              for (const remote of awarenessData.states || []) {\n                try {\n                  const remoteState = JSON.parse(remote.state);\n                  remoteStates.push({\n                    clientId: Number(remote.clientId),\n                    state: remoteState,\n                  });\n                } catch {\n                  // Invalid state — skip\n                }\n              }\n              const changes = reconcileRemoteAwarenessStates(\n                awareness.getStates() as Map<number, unknown>,\n                ydoc.clientID,\n                remoteStates,\n              );\n              if (\n                changes.added.length ||\n                changes.updated.length ||\n                changes.removed.length\n              ) {\n                awareness.emit(\"change\", [changes, \"remote\"]);\n              }\n            }\n          }\n        }\n      } catch {\n        // Network error — retry next interval\n      }\n      schedulePoll();\n    }\n\n    function pollNow() {\n      if (pauseWhenHidden && isDocumentHidden()) return;\n      if (timer) {\n        clearTimeout(timer);\n        timer = null;\n      }\n      void poll();\n    }\n\n    function handleVisibilityChange() {\n      if (document.visibilityState === \"visible\") {\n        pollNow();\n      } else if (pauseWhenHidden && timer) {\n        clearTimeout(timer);\n        timer = null;\n      }\n    }\n\n    if (!pauseWhenHidden || !isDocumentHidden()) {\n      void poll();\n    }\n    window.addEventListener(\"focus\", pollNow);\n    document.addEventListener(\"visibilitychange\", handleVisibilityChange);\n\n    return () => {\n      stopped = true;\n      if (timer) clearTimeout(timer);\n      window.removeEventListener(\"focus\", pollNow);\n      document.removeEventListener(\"visibilitychange\", handleVisibilityChange);\n    };\n  }, [\n    ydoc,\n    awareness,\n    docId,\n    pollInterval,\n    pauseWhenHidden,\n    requestSource,\n    baseUrl,\n    docMissing,\n  ]);\n\n  return {\n    ydoc,\n    awareness,\n    isLoading,\n    isSynced,\n    activeUsers,\n    agentActive,\n    agentPresent,\n  };\n}\n"]}
+{"version":3,"file":"client.js","sourceRoot":"","sources":["../../src/collab/client.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * Client-side hook for collaborative document editing via Yjs.\n *\n * Creates a STABLE Y.Doc per docId that never changes identity. This allows\n * TipTap's Collaboration extension to bind once without editor recreation.\n * Server state is applied to the existing doc when it arrives.\n *\n * Also manages Yjs Awareness for cursor positions and user presence,\n * synced via polling to the server's awareness endpoint.\n */\n\nimport { useEffect, useRef, useState, useMemo } from \"react\";\nimport * as Y from \"yjs\";\nimport { Awareness } from \"y-protocols/awareness\";\nimport { agentNativePath } from \"../client/api-path.js\";\nimport { AGENT_CLIENT_ID } from \"./agent-identity.js\";\n\nexport interface CollabUser {\n  name: string;\n  email: string;\n  color: string;\n}\n\nexport interface UseCollaborativeDocOptions {\n  /** Document ID to collaborate on. Pass null to disable. */\n  docId: string | null;\n  /** Poll interval in ms. Default: 2000 */\n  pollInterval?: number;\n  /** Pause remote update/presence polling while the tab is hidden. Default: true */\n  pauseWhenHidden?: boolean;\n  /** Base URL for collab endpoints. Default: \"/_agent-native/collab\" */\n  baseUrl?: string;\n  /** Request source ID for jitter prevention (e.g., tab ID). */\n  requestSource?: string;\n  /** Current user info for cursor labels. */\n  user?: CollabUser;\n}\n\nexport interface UseCollaborativeDocResult {\n  /** The Yjs document instance. Stable per docId — never changes identity. */\n  ydoc: Y.Doc | null;\n  /** Yjs Awareness instance for cursor/presence sync. */\n  awareness: Awareness | null;\n  /** Whether the initial state is still loading from the server. */\n  isLoading: boolean;\n  /** Whether the doc is synced with the server. */\n  isSynced: boolean;\n  /** Active users on this document (from awareness). */\n  activeUsers: CollabUser[];\n  /** True briefly when the AI agent makes an edit (for presence indicator). */\n  agentActive: boolean;\n  /** True when the AI agent has an active awareness entry (durable presence). */\n  agentPresent: boolean;\n}\n\n// Consistent color palette for user cursors\nconst CURSOR_COLORS = [\n  \"#f87171\",\n  \"#fb923c\",\n  \"#fbbf24\",\n  \"#a3e635\",\n  \"#34d399\",\n  \"#22d3ee\",\n  \"#60a5fa\",\n  \"#14b8a6\",\n  \"#f472b6\",\n  \"#e879f9\",\n];\n\n/** Hash a string to a consistent color from the palette. */\nexport function emailToColor(email: string): string {\n  let hash = 0;\n  for (let i = 0; i < email.length; i++) {\n    hash = ((hash << 5) - hash + email.charCodeAt(i)) | 0;\n  }\n  return CURSOR_COLORS[Math.abs(hash) % CURSOR_COLORS.length];\n}\n\n/** Derive a display name from an email address. */\nexport function emailToName(email: string): string {\n  const local = email.split(\"@\")[0] || email;\n  return local.charAt(0).toUpperCase() + local.slice(1);\n}\n\nfunction normalizeCollabEmail(email: string): string {\n  return email.trim().toLowerCase();\n}\n\nfunction isDocumentHidden(): boolean {\n  return (\n    typeof document !== \"undefined\" && document.visibilityState === \"hidden\"\n  );\n}\n\nexport function dedupeCollabUsersByEmail(users: CollabUser[]): CollabUser[] {\n  const byEmail = new Map<string, CollabUser>();\n  for (const user of users) {\n    const email = normalizeCollabEmail(user.email);\n    if (!email || byEmail.has(email)) continue;\n    byEmail.set(email, {\n      name: user.name || emailToName(email),\n      email,\n      color: user.color || emailToColor(email),\n    });\n  }\n  return Array.from(byEmail.values());\n}\n\n/**\n * Leader election for applying authoritative external snapshots into a shared\n * collaborative document.\n *\n * When the agent (or a Notion pull, or any full-document rewrite) writes new\n * content to SQL, the open editor reconciles it into the live Y.Doc with\n * `setContent`. If EVERY connected client did that independently, each would\n * diff the same snapshot into the CRDT and the changed region would be inserted\n * N times (concurrent inserts at the same position → duplicated text). So only\n * ONE client — the \"lead\" — applies the snapshot; every other client receives\n * the result through normal Yjs sync.\n *\n * The lead is the present client with the lowest Yjs `clientID`. The agent's\n * awareness entry uses `AGENT_CLIENT_ID` (max int) so it can never be the lead,\n * and a client editing alone is always the lead. This is deterministic across\n * clients with no coordination round-trip.\n */\nexport function isReconcileLeadClient(\n  awareness: Awareness | null | undefined,\n  localClientId: number | null | undefined,\n): boolean {\n  if (localClientId == null) return false;\n  if (!awareness) return true; // standalone / tests — act alone\n\n  let hasPeer = false;\n  let minVisible = localClientId;\n  awareness.getStates().forEach((state, clientId) => {\n    if (clientId === AGENT_CLIENT_ID) return; // agent never leads\n    if (clientId === localClientId) return;\n    const s = state as { user?: unknown; visible?: boolean };\n    if (!s || !s.user) return; // skip empty/stale entries\n    hasPeer = true;\n    // Only VISIBLE peers can act; a peer published `visible: false` (backgrounded)\n    // is skipped. A peer that hasn't published the field is treated as visible.\n    if (s.visible !== false && clientId < minVisible) minVisible = clientId;\n  });\n\n  // Sole client: always the applier — no other client can duplicate the edit,\n  // so single-user agent edits apply even if this tab reports hidden.\n  if (!hasPeer) return true;\n\n  // With peers present, exactly one VISIBLE client applies (the lowest clientId\n  // among visible ones). A backgrounded tab pauses its poll and can't reliably\n  // act, so it yields — otherwise an agent edit would never reach the tab the\n  // user is actually looking at. The caller re-elects on visibility change.\n  const localHidden =\n    typeof document !== \"undefined\" && document.visibilityState === \"hidden\";\n  if (localHidden) return false;\n  return localClientId <= minVisible;\n}\n\nexport interface RemoteAwarenessSnapshot {\n  clientId: number;\n  state: unknown;\n}\n\nexport function reconcileRemoteAwarenessStates(\n  states: Map<number, unknown>,\n  localClientId: number,\n  remoteStates: RemoteAwarenessSnapshot[],\n): { added: number[]; updated: number[]; removed: number[] } {\n  const incoming = new Set<number>();\n  const added: number[] = [];\n  const updated: number[] = [];\n  const removed: number[] = [];\n\n  for (const remote of remoteStates) {\n    if (\n      !Number.isFinite(remote.clientId) ||\n      remote.clientId === localClientId\n    ) {\n      continue;\n    }\n    incoming.add(remote.clientId);\n    const hadState = states.has(remote.clientId);\n    states.set(remote.clientId, remote.state);\n    (hadState ? updated : added).push(remote.clientId);\n  }\n\n  for (const clientId of Array.from(states.keys())) {\n    if (clientId === localClientId) continue;\n    if (incoming.has(clientId)) continue;\n    states.delete(clientId);\n    removed.push(clientId);\n  }\n\n  return { added, updated, removed };\n}\n\n// Base64 helpers\nfunction uint8ArrayToBase64(arr: Uint8Array): string {\n  let binary = \"\";\n  for (let i = 0; i < arr.length; i++) {\n    binary += String.fromCharCode(arr[i]);\n  }\n  return btoa(binary);\n}\n\nfunction base64ToUint8Array(b64: string): Uint8Array {\n  const binary = atob(b64);\n  const arr = new Uint8Array(binary.length);\n  for (let i = 0; i < binary.length; i++) {\n    arr[i] = binary.charCodeAt(i);\n  }\n  return arr;\n}\n\nexport function useCollaborativeDoc(\n  options: UseCollaborativeDocOptions,\n): UseCollaborativeDocResult {\n  const {\n    docId,\n    pollInterval = 2000,\n    pauseWhenHidden = true,\n    baseUrl = agentNativePath(\"/_agent-native/collab\"),\n    requestSource,\n    user,\n  } = options;\n\n  // Stable Y.Doc per docId\n  const ydoc = useMemo(() => {\n    if (!docId) return null;\n    return new Y.Doc();\n  }, [docId]);\n\n  // Stable Awareness per ydoc\n  const awareness = useMemo(() => {\n    if (!ydoc) return null;\n    return new Awareness(ydoc);\n  }, [ydoc]);\n\n  const [isLoading, setIsLoading] = useState(!!docId);\n  const [isSynced, setIsSynced] = useState(false);\n  const [activeUsers, setActiveUsers] = useState<CollabUser[]>([]);\n  const [agentActive, setAgentActive] = useState(false);\n  const [agentPresent, setAgentPresent] = useState(false);\n  // Set when the initial state fetch returns 404/403 — stops the awareness\n  // poll so we don't spam the console with errors against a doc that doesn't\n  // exist or isn't accessible.\n  const [docMissing, setDocMissing] = useState(false);\n  const agentTimerRef = useRef<ReturnType<typeof setTimeout> | null>(null);\n  const pollVersionRef = useRef(0);\n\n  // Set local awareness state (user info for cursor labels). Also publish this\n  // tab's visibility so peers can elect a VISIBLE client to apply external\n  // snapshots (see isReconcileLeadClient) — a backgrounded tab pauses its poll\n  // and must not hold that role.\n  useEffect(() => {\n    if (!awareness || !user) return;\n    awareness.setLocalStateField(\"user\", {\n      name: user.name,\n      email: user.email,\n      color: user.color,\n    });\n    awareness.setLocalStateField(\"visible\", !isDocumentHidden());\n  }, [awareness, user?.name, user?.email, user?.color]);\n\n  // Track active users from awareness changes\n  useEffect(() => {\n    if (!awareness) return;\n\n    const updateUsers = () => {\n      const users: CollabUser[] = [];\n      let hasAgent = false;\n      awareness.getStates().forEach((state, clientId) => {\n        if (clientId === ydoc?.clientID) return; // Skip self\n        if (state.user) {\n          users.push(state.user as CollabUser);\n          if ((state.user as CollabUser).email === \"agent@system\") {\n            hasAgent = true;\n          }\n        }\n      });\n      setActiveUsers(dedupeCollabUsersByEmail(users));\n      setAgentPresent(hasAgent);\n    };\n\n    awareness.on(\"change\", updateUsers);\n    return () => {\n      awareness.off(\"change\", updateUsers);\n    };\n  }, [awareness, ydoc]);\n\n  // Clean up on unmount or docId change\n  useEffect(() => {\n    return () => {\n      awareness?.destroy();\n      ydoc?.destroy();\n    };\n  }, [ydoc, awareness]);\n\n  // Fetch server state and apply to existing doc\n  useEffect(() => {\n    if (!ydoc || !docId) {\n      setIsLoading(false);\n      return;\n    }\n\n    let cancelled = false;\n    setIsLoading(true);\n    setIsSynced(false);\n    setDocMissing(false);\n\n    fetch(`${baseUrl}/${docId}/state`)\n      .then(async (res) => {\n        if (cancelled) return;\n        if (res.status === 404 || res.status === 403) {\n          setDocMissing(true);\n          setIsLoading(false);\n          setIsSynced(true);\n          return;\n        }\n        const data = (await res.json().catch(() => null)) as {\n          state?: string;\n        } | null;\n        if (data?.state) {\n          const binary = base64ToUint8Array(data.state);\n          if (binary.length > 4) {\n            Y.applyUpdate(ydoc, binary, \"remote\");\n          }\n        }\n        setIsLoading(false);\n        setIsSynced(true);\n      })\n      .catch(() => {\n        if (cancelled) return;\n        setIsLoading(false);\n        setIsSynced(true);\n      });\n\n    return () => {\n      cancelled = true;\n    };\n  }, [ydoc, docId, baseUrl]);\n\n  // Send local updates to server\n  useEffect(() => {\n    if (!ydoc || !docId || docMissing) return;\n\n    const handler = (update: Uint8Array, origin: unknown) => {\n      if (origin === \"remote\") return;\n\n      fetch(`${baseUrl}/${docId}/update`, {\n        method: \"POST\",\n        headers: { \"Content-Type\": \"application/json\" },\n        body: JSON.stringify({\n          update: uint8ArrayToBase64(update),\n          requestSource,\n        }),\n      });\n    };\n\n    ydoc.on(\"update\", handler);\n    return () => {\n      ydoc.off(\"update\", handler);\n    };\n  }, [ydoc, docId, baseUrl, requestSource, docMissing]);\n\n  // Poll for remote doc updates + awareness sync\n  useEffect(() => {\n    if (!ydoc || !docId || docMissing) return;\n\n    let stopped = false;\n    let timer: ReturnType<typeof setTimeout> | null = null;\n\n    function schedulePoll() {\n      if (stopped) return;\n      if (pauseWhenHidden && isDocumentHidden()) return;\n      timer = setTimeout(poll, pollInterval);\n    }\n\n    async function poll() {\n      if (stopped) return;\n      try {\n        // Poll for document updates\n        const res = await fetch(\n          agentNativePath(\n            `/_agent-native/poll?since=${pollVersionRef.current}`,\n          ),\n        );\n        if (!res.ok) throw new Error(\"HTTP \" + res.status);\n        const data = await res.json();\n        const { version, events } = data as {\n          version: number;\n          events: Array<{\n            source: string;\n            docId?: string;\n            update?: string;\n            requestSource?: string;\n          }>;\n        };\n\n        for (const evt of events) {\n          if (evt.source === \"collab\" && evt.docId === docId && evt.update) {\n            if (requestSource && evt.requestSource === requestSource) continue;\n            Y.applyUpdate(ydoc, base64ToUint8Array(evt.update), \"remote\");\n\n            // Show agent presence indicator briefly\n            if (evt.requestSource === \"agent\") {\n              setAgentActive(true);\n              if (agentTimerRef.current) clearTimeout(agentTimerRef.current);\n              agentTimerRef.current = setTimeout(\n                () => setAgentActive(false),\n                3000,\n              );\n            }\n          }\n        }\n\n        pollVersionRef.current = version;\n\n        try {\n          // The poll ring buffer is process-local. Fetching a state-vector diff\n          // makes collaboration durable across serverless invocations, process\n          // restarts, or any missed poll event.\n          const stateVector = uint8ArrayToBase64(Y.encodeStateVector(ydoc));\n          const stateRes = await fetch(\n            `${baseUrl}/${docId}/state?stateVector=${encodeURIComponent(\n              stateVector,\n            )}`,\n          );\n          if (stateRes.ok) {\n            const stateData = (await stateRes.json().catch(() => null)) as {\n              state?: string;\n            } | null;\n            if (stateData?.state) {\n              const binary = base64ToUint8Array(stateData.state);\n              if (binary.length > 2) {\n                Y.applyUpdate(ydoc, binary, \"remote\");\n              }\n            }\n          }\n        } catch {\n          // The next poll retries; awareness should still sync below.\n        }\n\n        // Sync awareness (cursor positions)\n        if (awareness) {\n          const localState = awareness.getLocalState();\n          if (localState) {\n            const awarenessRes = await fetch(`${baseUrl}/${docId}/awareness`, {\n              method: \"POST\",\n              headers: { \"Content-Type\": \"application/json\" },\n              body: JSON.stringify({\n                clientId: ydoc.clientID,\n                state: JSON.stringify(localState),\n              }),\n            });\n            if (awarenessRes.ok) {\n              const awarenessData = await awarenessRes.json();\n              const remoteStates: RemoteAwarenessSnapshot[] = [];\n              for (const remote of awarenessData.states || []) {\n                try {\n                  const remoteState = JSON.parse(remote.state);\n                  remoteStates.push({\n                    clientId: Number(remote.clientId),\n                    state: remoteState,\n                  });\n                } catch {\n                  // Invalid state — skip\n                }\n              }\n              const changes = reconcileRemoteAwarenessStates(\n                awareness.getStates() as Map<number, unknown>,\n                ydoc.clientID,\n                remoteStates,\n              );\n              if (\n                changes.added.length ||\n                changes.updated.length ||\n                changes.removed.length\n              ) {\n                awareness.emit(\"change\", [changes, \"remote\"]);\n              }\n            }\n          }\n        }\n      } catch {\n        // Network error — retry next interval\n      }\n      schedulePoll();\n    }\n\n    function pollNow() {\n      if (pauseWhenHidden && isDocumentHidden()) return;\n      if (timer) {\n        clearTimeout(timer);\n        timer = null;\n      }\n      void poll();\n    }\n\n    // Publish this tab's visibility to peers. A hidden tab pauses its poll, so\n    // we push the state immediately (keepalive) instead of waiting for the next\n    // cycle — otherwise peers keep treating a backgrounded tab as the visible\n    // lead and an agent edit never lands on the tab the user is looking at.\n    function publishVisibility(visible: boolean) {\n      if (!awareness) return;\n      awareness.setLocalStateField(\"visible\", visible);\n      const localState = awareness.getLocalState();\n      if (!localState) return;\n      fetch(`${baseUrl}/${docId}/awareness`, {\n        method: \"POST\",\n        headers: { \"Content-Type\": \"application/json\" },\n        body: JSON.stringify({\n          clientId: ydoc.clientID,\n          state: JSON.stringify(localState),\n        }),\n        keepalive: true,\n      }).catch(() => {});\n    }\n\n    function handleVisibilityChange() {\n      const visible = document.visibilityState === \"visible\";\n      publishVisibility(visible);\n      if (visible) {\n        pollNow();\n      } else if (pauseWhenHidden && timer) {\n        clearTimeout(timer);\n        timer = null;\n      }\n    }\n\n    if (!pauseWhenHidden || !isDocumentHidden()) {\n      void poll();\n    }\n    window.addEventListener(\"focus\", pollNow);\n    document.addEventListener(\"visibilitychange\", handleVisibilityChange);\n\n    return () => {\n      stopped = true;\n      if (timer) clearTimeout(timer);\n      window.removeEventListener(\"focus\", pollNow);\n      document.removeEventListener(\"visibilitychange\", handleVisibilityChange);\n    };\n  }, [\n    ydoc,\n    awareness,\n    docId,\n    pollInterval,\n    pauseWhenHidden,\n    requestSource,\n    baseUrl,\n    docMissing,\n  ]);\n\n  return {\n    ydoc,\n    awareness,\n    isLoading,\n    isSynced,\n    activeUsers,\n    agentActive,\n    agentPresent,\n  };\n}\n"]}

package/dist/mcp/build-server.d.ts

@@ -21,6 +21,8 @@ import type { ActionEntry } from "../agent/production-agent.js";
 export interface MCPConfig {
     /** App name shown in MCP server info */
     name: string;
+    /** Optional human-facing app title shown by MCP hosts that support titles. */
+    title?: string;
     /**
      * Canonical app id (directory under `apps/`, e.g. `mail`) this MCP server
      * is mounted for. Optional & back-compat: when omitted the builtin
@@ -32,6 +34,15 @@ export interface MCPConfig {
     appId?: string;
     /** App description */
     description: string;
+    /** Optional canonical website URL for hosts that surface MCP app details. */
+    websiteUrl?: string;
+    /** Optional app icons for MCP hosts that render server branding. */
+    icons?: Array<{
+        src: string;
+        mimeType?: string;
+        sizes?: string[];
+        theme?: "light" | "dark";
+    }>;
     /** Version string (default "1.0.0") */
     version?: string;
     /** Action registry — same as agent chat and A2A */
@@ -83,6 +94,8 @@ export interface MCPCallerIdentity {
 export interface MCPRequestMeta {
     /** Origin of the running app, e.g. `http://localhost:8100`. */
     origin?: string;
+    /** Optional mount prefix for path-mounted apps, e.g. `/mail`. */
+    basePath?: string;
     /** Optional client preference for which URL the *markdown* link uses. */
     target?: "browser" | "desktop" | "terminal";
     /**

package/dist/mcp/build-server.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"build-server.d.ts","sourceRoot":"","sources":["../../src/mcp/build-server.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"build-server.d.ts","sourceRoot":"","sources":["../../src/mcp/build-server.ts"],"names":[],"mappings":"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"}

package/dist/mcp/build-server.js

@@ -26,6 +26,7 @@ import { isAgentNativeOpenDeepLink, withCollapsedAgentSidebarParam, } from "../s
 import { MCP_APP_CHAT_BRIDGE_QUERY_PARAM } from "../shared/embed-auth.js";
 import { getBuiltinCrossAppTools } from "./builtin-tools.js";
 import { MCP_CONNECT_SCOPE } from "./connect-store.js";
+import { getConfiguredAppBasePath } from "../server/app-base-path.js";
 import { hasMcpOAuthScope, verifyMcpOAuthAccessToken, } from "./oauth-token.js";
 function isActionVisibleForOAuthScope(entry, scopes) {
     if (!scopes)
@@ -383,6 +384,51 @@ function mergeBuiltinTools(config, baseActions, requestMeta) {
     }
     return merged;
 }
+function absoluteMetadataUrl(value, requestMeta) {
+    const trimmed = value?.trim();
+    if (!trimmed)
+        return undefined;
+    try {
+        if (requestMeta?.origin) {
+            const basePath = requestMeta.basePath ?? getConfiguredAppBasePath();
+            const appBase = `${requestMeta.origin.replace(/\/+$/, "")}${basePath}/`;
+            const appLocalValue = trimmed.startsWith("/") && !trimmed.startsWith("//")
+                ? trimmed.replace(/^\/+/, "")
+                : trimmed;
+            return new URL(appLocalValue, appBase).href;
+        }
+        return new URL(trimmed).href;
+    }
+    catch {
+        return trimmed;
+    }
+}
+function mcpServerInfo(config, requestMeta) {
+    const websiteUrl = absoluteMetadataUrl(config.websiteUrl, requestMeta);
+    const icons = config.icons
+        ?.map((icon) => {
+        const src = absoluteMetadataUrl(icon.src, requestMeta);
+        if (!src)
+            return null;
+        return {
+            src,
+            ...(icon.mimeType ? { mimeType: icon.mimeType } : {}),
+            ...(icon.sizes?.length ? { sizes: icon.sizes } : {}),
+            ...(icon.theme ? { theme: icon.theme } : {}),
+        };
+    })
+        .filter((icon) => Boolean(icon));
+    return {
+        name: config.name,
+        version: config.version ?? "1.0.0",
+        ...(config.title?.trim() ? { title: config.title.trim() } : {}),
+        ...(config.description?.trim()
+            ? { description: config.description.trim() }
+            : {}),
+        ...(websiteUrl ? { websiteUrl } : {}),
+        ...(icons?.length ? { icons } : {}),
+    };
+}
 function safeUiSegment(value, fallback) {
     const normalized = (value || fallback)
         .trim()
@@ -709,7 +755,7 @@ export async function createMCPServerForRequest(config, identity, requestMeta) {
         : visibleActions;
     const supportsMcpApps = compactMcpAppCatalog ||
         Object.values(advertisedActions).some((entry) => Boolean(entry.mcpApp?.resource));
-    const server = new Server({ name: config.name, version: config.version ?? "1.0.0" }, {
+    const server = new Server(mcpServerInfo(config, requestMeta), {
         capabilities: {
             tools: {},
             ...(supportsMcpApps