@particle-academy/agent-integrations 0.11.1 → 0.13.0

package/dist/index.cjs

@@ -1953,19 +1953,39 @@ function serialize(entry) {
 var DEFAULT_AGENT8 = { id: "agent", name: "Agent", color: "#a855f7" };
 var truncate = (s, n = 60) => s.length > n ? s.slice(0, n) + "\u2026" : s;
 function registerTerminalBridge(host, options) {
-  const { adapter } = options;
   const agent = { ...DEFAULT_AGENT8, ...options.agent ?? {} };
   const pendingMode = options.pendingMode ?? false;
+  const screenId = options.screenId ?? options.adapter?.screenId;
   const disposers = [];
   const staged = /* @__PURE__ */ new Map();
   let seq = 0;
   ensureUndoToolsRegistered(host);
-  const target = (label) => ({
+  const listTerminals = () => {
+    if (options.terminals) return options.terminals();
+    if (options.adapter) return [{ id: "terminal", label: "Terminal", active: true, ...options.adapter }];
+    return [];
+  };
+  const resolve = (id) => {
+    const list = listTerminals();
+    if (typeof id === "string" && id !== "") return list.find((t) => t.id === id);
+    return list.find((t) => t.active) ?? list[0];
+  };
+  const anyMulti = !!options.terminals;
+  const canClear = anyMulti || !!options.adapter?.clear;
+  const canShells = anyMulti || !!options.adapter?.listShells;
+  const canSetShell = anyMulti || !!options.adapter?.setShell;
+  const target = (label, terminalId) => ({
     kind: "terminal",
-    screenId: adapter.screenId,
-    elementId: adapter.screenId ?? "terminal",
+    screenId,
+    elementId: terminalId ?? screenId ?? "terminal",
     label: label ?? "terminal"
   });
+  const TERMINAL_ARG = {
+    terminal: {
+      type: "string",
+      description: "Terminal id to target (call terminal_list for ids). Omit for the active / only terminal."
+    }
+  };
   const reg = (name, description, properties, required, handler, isMutation, resolveTarget) => {
     const wrapped = async (args) => {
       try {
@@ -1978,7 +1998,7 @@ function registerTerminalBridge(host, options) {
       toolName: name,
       agent,
       kind: "terminal",
-      screenId: adapter.screenId,
+      screenId,
       resolveTarget: ({ args, result }) => resolveTarget?.(args, result) ?? target()
     }) : wrapped;
     disposers.push(
@@ -1992,38 +2012,66 @@ function registerTerminalBridge(host, options) {
       )
     );
   };
-  async function exec(kind, data) {
+  const need = (args) => {
+    const t = resolve(args.terminal);
+    if (!t) {
+      const ids = listTerminals().map((x) => x.id).join(", ") || "(none)";
+      throw new Error(
+        typeof args.terminal === "string" && args.terminal ? `Unknown terminal '${args.terminal}'. Available: ${ids}. Use terminal_list.` : "No terminal available."
+      );
+    }
+    return t;
+  };
+  async function exec(t, kind, data) {
     if (kind === "run") {
-      if (adapter.runCommand) await adapter.runCommand(data);
-      else adapter.write(data + "\r");
+      if (t.runCommand) await t.runCommand(data);
+      else t.write(data + "\r");
     } else {
-      adapter.write(data);
+      t.write(data);
     }
   }
-  async function stageOrExec(kind, data) {
+  async function stageOrExec(t, kind, data) {
     if (!pendingMode) {
-      await exec(kind, data);
-      return textResult(`${kind === "run" ? "ran" : "wrote"}: ${truncate(data)}`, { kind, data, executed: true });
+      await exec(t, kind, data);
+      return textResult(`${kind === "run" ? "ran" : "wrote"} on ${t.id}: ${truncate(data)}`, {
+        kind,
+        data,
+        terminal: t.id,
+        executed: true
+      });
     }
     const id = `t${++seq}`;
-    const entry = { id, kind, data };
+    const entry = { id, kind, data, terminalId: t.id };
     staged.set(id, entry);
     options.onPending?.(entry);
     return textResult(
-      `Staged ${kind} (id ${id}) \u2014 awaiting human confirmation: ${truncate(data)}`,
+      `Staged ${kind} on ${t.id} (id ${id}) \u2014 awaiting human confirmation: ${truncate(data)}`,
       { ...entry, pending: true }
     );
   }
+  reg(
+    "terminal_list",
+    "List the terminals on this screen (id, label, which is active) \u2014 so you can reach into another terminal, not just the active one. Pass the chosen id as `terminal` to the other tools.",
+    {},
+    [],
+    () => {
+      const list = listTerminals().map((t) => ({ id: t.id, label: t.label ?? t.id, active: !!t.active }));
+      const text = list.length ? list.map((t) => `${t.active ? "* " : "  "}${t.id} \u2014 ${t.label}`).join("\n") : "(no terminals)";
+      return textResult(text, { terminals: list });
+    },
+    false
+  );
   reg(
     "terminal_read",
-    "Read the visible terminal buffer as text \u2014 what the user sees. Pass `tail` for only the last N lines.",
-    { tail: { type: "number", description: "Return only the last N lines." } },
+    "Read a terminal's visible buffer as text \u2014 what the user sees. Pass `tail` for only the last N lines, `terminal` to read a specific one.",
+    { ...TERMINAL_ARG, tail: { type: "number", description: "Return only the last N lines." } },
     [],
     (args) => {
-      let buf = adapter.getBuffer();
+      const t = need(args);
+      let buf = t.getBuffer();
       const tail = typeof args.tail === "number" ? args.tail : void 0;
       if (tail && tail > 0) buf = buf.split("\n").slice(-tail).join("\n");
-      return textResult(buf, { buffer: buf });
+      return textResult(buf, { buffer: buf, terminal: t.id });
     },
     false
   );
@@ -2035,7 +2083,7 @@ function registerTerminalBridge(host, options) {
     () => {
       const list = [...staged.values()];
       return textResult(
-        list.length ? list.map((s) => `${s.id}: ${s.kind} ${truncate(s.data)}`).join("\n") : "(none)",
+        list.length ? list.map((s) => `${s.id}: ${s.kind} on ${s.terminalId} ${truncate(s.data)}`).join("\n") : "(none)",
         { pending: list }
       );
     },
@@ -2043,20 +2091,21 @@ function registerTerminalBridge(host, options) {
   );
   reg(
     "terminal_write",
-    "Write raw data / keystrokes to the terminal (input, control chars, ANSI). In pendingMode this stages instead of executing.",
-    { data: { type: "string", description: "Raw bytes to write." } },
+    "Write raw data / keystrokes to a terminal (input, control chars, ANSI). Pass `terminal` to target a specific one. In pendingMode this stages instead of executing.",
+    { ...TERMINAL_ARG, data: { type: "string", description: "Raw bytes to write." } },
     ["data"],
-    (args) => stageOrExec("write", String(args.data)),
-    true
+    (args) => stageOrExec(need(args), "write", String(args.data)),
+    true,
+    (args) => target(`write:${String(args.terminal ?? "")}`, resolve(args.terminal)?.id)
   );
   reg(
     "terminal_run",
-    "Run a shell command \u2014 writes the command followed by Enter (or the host's command runner). In pendingMode this stages it for confirmation.",
-    { command: { type: "string", description: "The command line to run." } },
+    "Run a shell command in a terminal \u2014 writes the command + Enter (or the host's runner). Pass `terminal` to target a specific one. In pendingMode this stages it for confirmation.",
+    { ...TERMINAL_ARG, command: { type: "string", description: "The command line to run." } },
     ["command"],
-    (args) => stageOrExec("run", String(args.command)),
+    (args) => stageOrExec(need(args), "run", String(args.command)),
     true,
-    (args) => target(truncate(String(args.command ?? "")))
+    (args) => target(truncate(String(args.command ?? "")), resolve(args.terminal)?.id)
   );
   reg(
     "terminal_confirm",
@@ -2067,11 +2116,17 @@ function registerTerminalBridge(host, options) {
       const id = String(args.id);
       const entry = staged.get(id);
       if (!entry) return errorResult(`No staged command ${id}`);
+      const t = resolve(entry.terminalId);
+      if (!t) return errorResult(`Terminal '${entry.terminalId}' is gone \u2014 cannot run ${id}`);
       staged.delete(id);
-      await exec(entry.kind, entry.data);
-      return textResult(`Confirmed ${id}: ${entry.kind} ${truncate(entry.data)}`, { ...entry, executed: true });
+      await exec(t, entry.kind, entry.data);
+      return textResult(`Confirmed ${id}: ${entry.kind} on ${t.id} ${truncate(entry.data)}`, { ...entry, executed: true });
     },
-    true
+    true,
+    (args) => {
+      const e = staged.get(String(args.id));
+      return target(`confirm:${String(args.id ?? "")}`, e?.terminalId);
+    }
   );
   reg(
     "terminal_reject",
@@ -2085,51 +2140,58 @@ function registerTerminalBridge(host, options) {
     },
     false
   );
-  if (adapter.clear) {
+  if (canClear) {
     reg(
       "terminal_clear",
-      "Clear the terminal viewport.",
-      {},
+      "Clear a terminal's viewport. Pass `terminal` to target a specific one.",
+      { ...TERMINAL_ARG },
       [],
-      () => {
-        adapter.clear();
-        return textResult("cleared");
+      (args) => {
+        const t = need(args);
+        if (!t.clear) return errorResult(`Terminal '${t.id}' can't be cleared.`);
+        t.clear();
+        return textResult(`cleared ${t.id}`, { terminal: t.id });
       },
-      true
+      true,
+      (args) => target(`clear:${String(args.terminal ?? "")}`, resolve(args.terminal)?.id)
     );
   }
-  if (adapter.listShells) {
+  if (canShells) {
     reg(
       "terminal_list_shells",
-      "List the shells the host can switch to (cmd, PowerShell, Git Bash, \u2026) \u2014 id + label, with the active one marked.",
-      {},
+      "List the shells a terminal can switch to (cmd, PowerShell, Git Bash, \u2026) \u2014 id + label, active one marked. Pass `terminal` to target a specific one.",
+      { ...TERMINAL_ARG },
       [],
-      () => {
-        const shells = adapter.listShells();
-        const active = adapter.getShell?.();
+      (args) => {
+        const t = need(args);
+        if (!t.listShells) return errorResult(`Terminal '${t.id}' has no switchable shells.`);
+        const shells = t.listShells();
+        const active = t.getShell?.();
         const text = shells.length ? shells.map((s) => `${s.id === active ? "* " : "  "}${s.id} \u2014 ${s.label}`).join("\n") : "(none)";
-        return textResult(text, { shells, active });
+        return textResult(text, { shells, active, terminal: t.id });
       },
       false
     );
   }
-  if (adapter.setShell) {
+  if (canSetShell) {
     reg(
       "terminal_set_shell",
-      "Switch the active shell by id (e.g. 'powershell', 'git-bash'). Call terminal_list_shells first for valid ids. The host reconnects its backend to the chosen shell.",
-      { id: { type: "string", description: "Shell id to switch to." } },
+      "Switch a terminal's active shell by id (e.g. 'powershell', 'git-bash'). Call terminal_list_shells first for valid ids. Pass `terminal` to target a specific one.",
+      { ...TERMINAL_ARG, id: { type: "string", description: "Shell id to switch to." } },
       ["id"],
       async (args) => {
+        const t = need(args);
+        if (!t.setShell) return errorResult(`Terminal '${t.id}' can't switch shells.`);
         const id = String(args.id);
-        const shells = adapter.listShells?.();
+        const shells = t.listShells?.();
         if (shells && shells.length && !shells.some((s) => s.id === id)) {
-          return errorResult(`Unknown shell '${id}'. Use terminal_list_shells for valid ids.`);
+          return errorResult(`Unknown shell '${id}' for ${t.id}. Use terminal_list_shells for valid ids.`);
         }
-        await adapter.setShell(id);
-        return textResult(`Switched shell to ${id}`, { shell: id });
+        await t.setShell(id);
+        return textResult(`Switched ${t.id} shell to ${id}`, { shell: id, terminal: t.id });
       },
       true,
-      (args) => target(`shell:${String(args.id ?? "")}`)
+      (args) => target(`shell:${String(args.id ?? "")}`, resolve(args.terminal)?.id)
     );
   }
   return {
@@ -2143,8 +2205,9 @@ function registerTerminalBridge(host, options) {
     confirm: (id) => {
       const e = staged.get(id);
       if (e) {
+        const t = resolve(e.terminalId);
         staged.delete(id);
-        void exec(e.kind, e.data);
+        if (t) void exec(t, e.kind, e.data);
       }
     },
     reject: (id) => {
@@ -2753,6 +2816,342 @@ function attachSseRelay(server, options) {
   return transport;
 }
 
+// src/connectors/targets.ts
+var CLAUDE_CONNECTORS_URL = "https://claude.ai/settings/connectors";
+function encodeBase64Json(value) {
+  const json = JSON.stringify(value);
+  if (typeof btoa === "function") {
+    return btoa(unescape(encodeURIComponent(json)));
+  }
+  return Buffer.from(json, "utf8").toString("base64");
+}
+function buildCursorDeeplink(server) {
+  const config = encodeBase64Json({ url: server.url });
+  return `cursor://anysphere.cursor-deeplink/mcp/install?name=${encodeURIComponent(
+    server.name
+  )}&config=${config}`;
+}
+function buildVscodeDeeplink(server, opts = {}) {
+  const scheme = opts.insiders ? "vscode-insiders" : "vscode";
+  const payload = encodeURIComponent(
+    JSON.stringify({ name: server.name, url: server.url })
+  );
+  return `${scheme}://mcp/install?${payload}`;
+}
+function slugifyServerName(name) {
+  const slug = name.toLowerCase().replace(/[^a-z0-9]+/g, "-").replace(/^-+|-+$/g, "");
+  return slug || "mcp-server";
+}
+function buildManualConfig(server) {
+  return {
+    mcpServers: {
+      [slugifyServerName(server.name)]: {
+        command: "npx",
+        args: ["-y", "mcp-remote", server.url]
+      }
+    }
+  };
+}
+function buildManualConfigSnippet(server) {
+  return JSON.stringify(buildManualConfig(server), null, 2);
+}
+var CONNECTOR_TARGETS = {
+  "claude-web": {
+    id: "claude-web",
+    label: "Add to Claude",
+    mechanism: "copy-open",
+    hint: "Copy the MCP URL and open Claude's Connectors page \u2014 click 'Add custom connector' and paste."
+  },
+  "claude-desktop": {
+    id: "claude-desktop",
+    label: "Claude Desktop",
+    mechanism: "download",
+    hint: "Download a .mcpb bundle and double-click it to install in Claude Desktop."
+  },
+  cursor: {
+    id: "cursor",
+    label: "Add to Cursor",
+    mechanism: "deeplink",
+    hint: "Open Cursor with this MCP server pre-filled \u2014 confirm to install."
+  },
+  vscode: {
+    id: "vscode",
+    label: "Add to VS Code",
+    mechanism: "deeplink",
+    hint: "Open VS Code with this MCP server pre-filled \u2014 confirm to install."
+  },
+  manual: {
+    id: "manual",
+    label: "Manual setup",
+    mechanism: "snippet",
+    hint: "Show a config snippet to paste into any stdio MCP client."
+  }
+};
+function connectorHref(client, server, opts = {}) {
+  switch (client) {
+    case "cursor":
+      return buildCursorDeeplink(server);
+    case "vscode":
+      return buildVscodeDeeplink(server, opts);
+    default:
+      return null;
+  }
+}
+function ClaudeMark(props) {
+  return /* @__PURE__ */ jsxRuntime.jsx("svg", { viewBox: "0 0 24 24", fill: "currentColor", "aria-hidden": true, ...props, children: /* @__PURE__ */ jsxRuntime.jsx("path", { d: "M12 2 L 14 10 L 22 12 L 14 14 L 12 22 L 10 14 L 2 12 L 10 10 Z" }) });
+}
+function CursorMark(props) {
+  return /* @__PURE__ */ jsxRuntime.jsx("svg", { viewBox: "0 0 24 24", fill: "currentColor", "aria-hidden": true, ...props, children: /* @__PURE__ */ jsxRuntime.jsx("path", { d: "M3 3 L 20 11 L 12 13 L 9 21 Z" }) });
+}
+function VscodeMark(props) {
+  return /* @__PURE__ */ jsxRuntime.jsx("svg", { viewBox: "0 0 24 24", fill: "currentColor", "aria-hidden": true, ...props, children: /* @__PURE__ */ jsxRuntime.jsx("path", { d: "M17 2 L 22 4.5 V 19.5 L 17 22 L 6.5 13.2 L 3 16 L 1.5 15 V 9 L 3 8 L 6.5 10.8 Z M 17 6.5 L 10 12 L 17 17.5 Z" }) });
+}
+function DesktopMark(props) {
+  return /* @__PURE__ */ jsxRuntime.jsx("svg", { viewBox: "0 0 24 24", fill: "currentColor", "aria-hidden": true, ...props, children: /* @__PURE__ */ jsxRuntime.jsx("path", { d: "M3 4 H 21 A 1 1 0 0 1 22 5 V 16 A 1 1 0 0 1 21 17 H 14 V 19 H 16 V 21 H 8 V 19 H 10 V 17 H 3 A 1 1 0 0 1 2 16 V 5 A 1 1 0 0 1 3 4 Z" }) });
+}
+function WrenchMark(props) {
+  return /* @__PURE__ */ jsxRuntime.jsx("svg", { viewBox: "0 0 24 24", fill: "currentColor", "aria-hidden": true, ...props, children: /* @__PURE__ */ jsxRuntime.jsx("path", { d: "M21 4 a 5 5 0 0 1 -6.5 6.5 L 6 19 l -3 -3 l 8.5 -8.5 A 5 5 0 0 1 17 1 l -2.5 2.5 l 1.5 3 l 3 1.5 Z" }) });
+}
+var CONNECTOR_GLYPHS = {
+  "claude-web": ClaudeMark,
+  "claude-desktop": DesktopMark,
+  cursor: CursorMark,
+  vscode: VscodeMark,
+  manual: WrenchMark
+};
+var DEFAULT_CLIENTS = [
+  "claude-web",
+  "cursor",
+  "vscode",
+  "manual"
+];
+function ConnectorButtons({
+  serverName,
+  mcpUrl,
+  clients,
+  mcpbDownloadUrl,
+  claudeConnectorsUrl = CLAUDE_CONNECTORS_URL,
+  vscodeInsiders,
+  onCopy,
+  onAction,
+  labels,
+  className,
+  style
+}) {
+  const server = { name: serverName, url: mcpUrl };
+  const [copied, setCopied] = react.useState(null);
+  const [manualOpen, setManualOpen] = react.useState(false);
+  const manualId = react.useId();
+  const list = (clients ?? defaultClients(mcpbDownloadUrl)).filter(
+    (c) => c === "claude-desktop" ? !!mcpbDownloadUrl : true
+  );
+  const flashCopied = (target) => {
+    setCopied(target);
+    window.setTimeout(() => setCopied((c) => c === target ? null : c), 2e3);
+  };
+  const copy = async (value, target) => {
+    try {
+      await navigator.clipboard?.writeText(value);
+      flashCopied(target);
+      onCopy?.(target);
+    } catch {
+    }
+  };
+  const labelFor = (c) => labels?.[c] ?? CONNECTOR_TARGETS[c].label;
+  return /* @__PURE__ */ jsxRuntime.jsx(
+    "div",
+    {
+      className: ["fai-connect", className].filter(Boolean).join(" "),
+      style,
+      children: list.map((client) => {
+        const meta = CONNECTOR_TARGETS[client];
+        const Glyph = CONNECTOR_GLYPHS[client];
+        const base = `fai-connect__btn fai-connect__btn--${client}`;
+        const href = connectorHref(client, server, { insiders: vscodeInsiders });
+        if (href) {
+          return /* @__PURE__ */ jsxRuntime.jsxs(
+            "a",
+            {
+              href,
+              className: base,
+              title: meta.hint,
+              onClick: () => onAction?.(client),
+              children: [
+                /* @__PURE__ */ jsxRuntime.jsx(Glyph, { className: "fai-connect__glyph" }),
+                labelFor(client)
+              ]
+            },
+            client
+          );
+        }
+        if (client === "claude-desktop") {
+          return /* @__PURE__ */ jsxRuntime.jsxs(
+            "a",
+            {
+              href: mcpbDownloadUrl,
+              download: true,
+              className: base,
+              title: meta.hint,
+              onClick: () => onAction?.(client),
+              children: [
+                /* @__PURE__ */ jsxRuntime.jsx(Glyph, { className: "fai-connect__glyph" }),
+                labelFor(client)
+              ]
+            },
+            client
+          );
+        }
+        if (client === "claude-web") {
+          return /* @__PURE__ */ jsxRuntime.jsxs(
+            "button",
+            {
+              type: "button",
+              className: base,
+              title: meta.hint,
+              onClick: () => {
+                void copy(mcpUrl, client);
+                window.open(
+                  claudeConnectorsUrl,
+                  "_blank",
+                  "noopener,noreferrer"
+                );
+                onAction?.(client);
+              },
+              children: [
+                /* @__PURE__ */ jsxRuntime.jsx(Glyph, { className: "fai-connect__glyph" }),
+                copied === client ? "Copied \u2014 paste in Claude" : labelFor(client)
+              ]
+            },
+            client
+          );
+        }
+        return /* @__PURE__ */ jsxRuntime.jsxs("div", { className: "fai-connect__manual-wrap", children: [
+          /* @__PURE__ */ jsxRuntime.jsxs(
+            "button",
+            {
+              type: "button",
+              className: base,
+              title: meta.hint,
+              "aria-expanded": manualOpen,
+              "aria-controls": manualId,
+              onClick: () => {
+                setManualOpen((o) => !o);
+                onAction?.(client);
+              },
+              children: [
+                /* @__PURE__ */ jsxRuntime.jsx(Glyph, { className: "fai-connect__glyph" }),
+                labelFor(client)
+              ]
+            }
+          ),
+          manualOpen && /* @__PURE__ */ jsxRuntime.jsx(
+            ManualPopover,
+            {
+              id: manualId,
+              snippet: buildManualConfigSnippet(server),
+              copied: copied === client,
+              onCopy: () => copy(buildManualConfigSnippet(server), client),
+              onClose: () => setManualOpen(false)
+            }
+          )
+        ] }, client);
+      })
+    }
+  );
+}
+function defaultClients(mcpbDownloadUrl) {
+  return mcpbDownloadUrl ? ["claude-web", "claude-desktop", "cursor", "vscode", "manual"] : DEFAULT_CLIENTS;
+}
+function ManualPopover({
+  id,
+  snippet,
+  copied,
+  onCopy,
+  onClose
+}) {
+  return /* @__PURE__ */ jsxRuntime.jsxs("div", { id, className: "fai-connect__popover", role: "dialog", children: [
+    /* @__PURE__ */ jsxRuntime.jsxs("div", { className: "fai-connect__popover-head", children: [
+      /* @__PURE__ */ jsxRuntime.jsx("span", { children: "Add to any stdio MCP client" }),
+      /* @__PURE__ */ jsxRuntime.jsx(
+        "button",
+        {
+          type: "button",
+          className: "fai-connect__popover-close",
+          "aria-label": "Close",
+          onClick: onClose,
+          children: "\xD7"
+        }
+      )
+    ] }),
+    /* @__PURE__ */ jsxRuntime.jsxs("p", { className: "fai-connect__popover-hint", children: [
+      "Paste into ",
+      /* @__PURE__ */ jsxRuntime.jsx("code", { children: "claude_desktop_config.json" }),
+      " (or any stdio MCP client config). Needs Node 18+."
+    ] }),
+    /* @__PURE__ */ jsxRuntime.jsx("pre", { className: "fai-connect__snippet", children: snippet }),
+    /* @__PURE__ */ jsxRuntime.jsx("button", { type: "button", className: "fai-connect__copy-btn", onClick: onCopy, children: copied ? "Copied" : "Copy snippet" })
+  ] });
+}
+
+// src/connectors/mcpb.ts
+var MCPB_MANIFEST_VERSION = "0.2";
+var MCPB_MIN_NODE = ">=18.0.0";
+var DEFAULT_MCPB_ENTRY_POINT = "server/proxy.js";
+function buildMcpbManifest(input) {
+  const entryPoint = input.entryPoint ?? DEFAULT_MCPB_ENTRY_POINT;
+  return {
+    manifest_version: MCPB_MANIFEST_VERSION,
+    name: input.name,
+    display_name: input.display_name ?? input.name,
+    version: input.version,
+    description: input.description,
+    ...input.long_description ? { long_description: input.long_description } : {},
+    author: input.author,
+    ...input.homepage ? { homepage: input.homepage } : {},
+    ...input.documentation ? { documentation: input.documentation } : {},
+    ...input.support ? { support: input.support } : {},
+    server: {
+      type: "node",
+      entry_point: entryPoint,
+      mcp_config: {
+        command: "npx",
+        args: ["-y", "mcp-remote", input.mcpUrl]
+      }
+    },
+    tools: input.tools ?? [],
+    tools_generated: false,
+    prompts_generated: false,
+    ...input.keywords ? { keywords: input.keywords } : {},
+    license: input.license ?? "MIT",
+    compatibility: {
+      claude_desktop: ">=0.10.0",
+      platforms: ["darwin", "win32", "linux"],
+      runtimes: { node: MCPB_MIN_NODE }
+    }
+  };
+}
+function buildMcpbProxyStub(mcpUrl) {
+  const urlLiteral = JSON.stringify(mcpUrl);
+  return `#!/usr/bin/env node
+// MCPB proxy shim (generated by @particle-academy/agent-integrations).
+//
+// MCPB (Claude Desktop Extensions) only supports local stdio servers, but this
+// MCP server is a remote HTTP endpoint. The manifest's \`mcp_config\` invokes
+// \`npx -y mcp-remote <url>\` to bridge the gap \u2014 this file is the entry_point
+// fallback the manifest validator requires. If you're seeing this run,
+// mcp_config wasn't honored; spawn mcp-remote directly so the bundle still works.
+
+const { spawn } = require("node:child_process");
+
+const url = ${urlLiteral};
+const child = spawn("npx", ["-y", "mcp-remote", url], { stdio: "inherit" });
+
+child.on("exit", (code) => process.exit(code ?? 0));
+process.on("SIGINT", () => child.kill("SIGINT"));
+process.on("SIGTERM", () => child.kill("SIGTERM"));
+`;
+}
+
 Object.defineProperty(exports, "clearUndoStack", {
   enumerable: true,
   get: function () { return fancyAutoCommon.clearStack; }
@@ -2797,7 +3196,17 @@ exports.AgentActivityHighlight = AgentActivityHighlight;
 exports.AgentCursor = AgentCursor;
 exports.AgentPanel = AgentPanel;
 exports.BridgedForm = BridgedForm;
+exports.CLAUDE_CONNECTORS_URL = CLAUDE_CONNECTORS_URL;
+exports.CONNECTOR_GLYPHS = CONNECTOR_GLYPHS;
+exports.CONNECTOR_TARGETS = CONNECTOR_TARGETS;
+exports.ClaudeMark = ClaudeMark;
+exports.ConnectorButtons = ConnectorButtons;
+exports.CursorMark = CursorMark;
+exports.DEFAULT_MCPB_ENTRY_POINT = DEFAULT_MCPB_ENTRY_POINT;
+exports.DesktopMark = DesktopMark;
 exports.InProcessTransport = InProcessTransport;
+exports.MCPB_MANIFEST_VERSION = MCPB_MANIFEST_VERSION;
+exports.MCPB_MIN_NODE = MCPB_MIN_NODE;
 exports.MCP_PROTOCOL_VERSION = MCP_PROTOCOL_VERSION;
 exports.MicroMcpServer = MicroMcpServer;
 exports.RelayTransport = RelayTransport;
@@ -2805,13 +3214,23 @@ exports.ScreensActivityBridge = ScreensActivityBridge;
 exports.ShareControls = ShareControls;
 exports.SseRelayTransport = SseRelayTransport;
 exports.ToolRegistry = ToolRegistry;
+exports.VscodeMark = VscodeMark;
+exports.WrenchMark = WrenchMark;
 exports.attachInProcess = attachInProcess;
 exports.attachRelay = attachRelay;
 exports.attachSseRelay = attachSseRelay;
+exports.buildCursorDeeplink = buildCursorDeeplink;
+exports.buildManualConfig = buildManualConfig;
+exports.buildManualConfigSnippet = buildManualConfigSnippet;
+exports.buildMcpbManifest = buildMcpbManifest;
+exports.buildMcpbProxyStub = buildMcpbProxyStub;
 exports.buildShareConfig = buildShareConfig;
 exports.buildShareUrl = buildShareUrl;
+exports.buildVscodeDeeplink = buildVscodeDeeplink;
+exports.connectorHref = connectorHref;
 exports.createSessionDescriptor = createSessionDescriptor;
 exports.describeSession = describeSession;
+exports.encodeBase64Json = encodeBase64Json;
 exports.ensureUndoToolsRegistered = ensureUndoToolsRegistered;
 exports.errorResult = errorResult;
 exports.readSessionFromUrl = readSessionFromUrl;
@@ -2825,6 +3244,7 @@ exports.registerSlidesBridge = registerSlidesBridge;
 exports.registerTerminalBridge = registerTerminalBridge;
 exports.registerUndoTools = registerUndoTools;
 exports.rpcError = rpcError;
+exports.slugifyServerName = slugifyServerName;
 exports.textResult = textResult;
 exports.useAgentActivity = useAgentActivity;
 exports.useAgentActivityForScreen = useAgentActivityForScreen;