@particle-academy/agent-integrations 0.12.0 → 0.13.0

package/dist/connectors/index.d.cts

@@ -0,0 +1,130 @@
+import * as react from 'react';
+import { ReactNode, CSSProperties, ComponentType, SVGProps } from 'react';
+export { D as DEFAULT_MCPB_ENTRY_POINT, b as MCPB_MANIFEST_VERSION, c as MCPB_MIN_NODE, M as McpbManifestInput, a as McpbTool, d as buildMcpbManifest, e as buildMcpbProxyStub } from '../mcpb-BXOrsRnv.cjs';
+
+/** The MCP hosts we know how to generate an install affordance for. */
+type ConnectorClient = "claude-web" | "claude-desktop" | "cursor" | "vscode" | "manual";
+/** A remote MCP server to generate install artifacts for. */
+interface ConnectorServer {
+    /** Human-readable server name, e.g. `"Decksmith"`. */
+    name: string;
+    /** The remote MCP endpoint, e.g. `"https://decksmith.dev/mcp"`. */
+    url: string;
+}
+/**
+ * Claude's Connectors page — the manual "Add custom connector" flow.
+ *
+ * Claude exposes no install deeplink, so a button can only copy the URL and
+ * open this page for a paste. Override per-app if Claude moves it (it has
+ * historically lived at both `/settings/connectors` and `/customize/connectors`).
+ */
+declare const CLAUDE_CONNECTORS_URL = "https://claude.ai/settings/connectors";
+/** Base64-encode a JSON value, working in both the browser and Node. */
+declare function encodeBase64Json(value: unknown): string;
+/**
+ * Cursor install deeplink for a remote (HTTP) MCP server.
+ *
+ * `cursor://anysphere.cursor-deeplink/mcp/install?name=<name>&config=<base64>`,
+ * where `config` is base64 of `{"url":"<mcpUrl>"}` — the HTTP shape, with no
+ * `type`/`transport` keys (those are for the stdio examples in the docs). The
+ * base64 is intentionally NOT percent-encoded, matching Cursor's own install
+ * links. Docs: https://cursor.com/docs/context/mcp/install-links
+ */
+declare function buildCursorDeeplink(server: ConnectorServer): string;
+/**
+ * VS Code install deeplink for a remote (HTTP) MCP server.
+ *
+ * `vscode://mcp/install?<urlencoded-json>` — URL-ENCODED JSON (not base64), the
+ * opposite encoding from Cursor and an easy one to mix up. The payload is
+ * `{ "name", "url" }`; for VS Code Insiders pass `{ insiders: true }`.
+ */
+declare function buildVscodeDeeplink(server: ConnectorServer, opts?: {
+    insiders?: boolean;
+}): string;
+/** A normalized server key for a config file (`My App` → `my-app`). */
+declare function slugifyServerName(name: string): string;
+/** The `claude_desktop_config.json` object for a manual install. */
+interface ManualMcpConfig {
+    mcpServers: Record<string, {
+        command: string;
+        args: string[];
+    }>;
+}
+/**
+ * The `claude_desktop_config.json` (or any stdio MCP client config) entry for a
+ * remote server, wrapping it with `npx -y mcp-remote <url>` — the standard
+ * stdio→HTTP bridge, since stdio clients can't take an HTTP URL directly.
+ * Requires Node 18+ on the user's machine.
+ */
+declare function buildManualConfig(server: ConnectorServer): ManualMcpConfig;
+/** Pretty-printed JSON snippet of {@link buildManualConfig}, for a copy box. */
+declare function buildManualConfigSnippet(server: ConnectorServer): string;
+/** How a given client's button behaves — drives the default UI. */
+type ConnectorMechanism = "copy-open" | "download" | "deeplink" | "snippet";
+/** Display metadata for a client, so consumers don't redraw the marks. */
+interface ConnectorTargetMeta {
+    id: ConnectorClient;
+    /** Default button label. */
+    label: string;
+    mechanism: ConnectorMechanism;
+    /** One-line tooltip explaining what the button does. */
+    hint: string;
+}
+declare const CONNECTOR_TARGETS: Record<ConnectorClient, ConnectorTargetMeta>;
+/**
+ * Resolve the navigable href for a deeplink client (cursor / vscode), or null
+ * for clients whose mechanism isn't a plain navigation.
+ */
+declare function connectorHref(client: ConnectorClient, server: ConnectorServer, opts?: {
+    insiders?: boolean;
+}): string | null;
+
+interface ConnectorButtonsProps {
+    /** Human-readable server name, e.g. `"Decksmith"`. */
+    serverName: string;
+    /** The remote MCP endpoint, e.g. `"https://decksmith.dev/mcp"`. */
+    mcpUrl: string;
+    /**
+     * Which client buttons to render, in order. Defaults to
+     * `["claude-web", "cursor", "vscode", "manual"]` — plus `"claude-desktop"`
+     * when {@link mcpbDownloadUrl} is set. A `"claude-desktop"` entry with no
+     * `mcpbDownloadUrl` is skipped (there's nothing to download).
+     */
+    clients?: ConnectorClient[];
+    /** URL of a prebuilt `.mcpb` bundle; enables the Claude Desktop button. */
+    mcpbDownloadUrl?: string;
+    /** Override Claude's Connectors page (it has moved before). */
+    claudeConnectorsUrl?: string;
+    /** Target VS Code Insiders instead of stable. */
+    vscodeInsiders?: boolean;
+    /** Fired when a value is copied to the clipboard (URL or snippet). */
+    onCopy?: (target: ConnectorClient) => void;
+    /** Fired when any button is activated (after its side effect). */
+    onAction?: (target: ConnectorClient) => void;
+    /** Per-client label override. */
+    labels?: Partial<Record<ConnectorClient, ReactNode>>;
+    className?: string;
+    style?: CSSProperties;
+}
+/**
+ * Per-client "Add to <host>" buttons for a remote MCP server, each with the
+ * right (and subtly different) install behavior baked in — see {@link
+ * ./targets}. Brand glyphs, copy/feedback states, and the manual-config popover
+ * are owned here so a consumer just passes a name + URL.
+ *
+ * Needs the package stylesheet for its default look:
+ * `import "@particle-academy/agent-integrations/styles.css"`.
+ */
+declare function ConnectorButtons({ serverName, mcpUrl, clients, mcpbDownloadUrl, claudeConnectorsUrl, vscodeInsiders, onCopy, onAction, labels, className, style, }: ConnectorButtonsProps): react.JSX.Element;
+
+type GlyphProps = SVGProps<SVGSVGElement>;
+declare function ClaudeMark(props: GlyphProps): react.JSX.Element;
+declare function CursorMark(props: GlyphProps): react.JSX.Element;
+declare function VscodeMark(props: GlyphProps): react.JSX.Element;
+declare function DesktopMark(props: GlyphProps): react.JSX.Element;
+declare function WrenchMark(props: GlyphProps): react.JSX.Element;
+
+/** Glyph component for a given client. */
+declare const CONNECTOR_GLYPHS: Record<ConnectorClient, ComponentType<GlyphProps>>;
+
+export { CLAUDE_CONNECTORS_URL, CONNECTOR_GLYPHS, CONNECTOR_TARGETS, ClaudeMark, ConnectorButtons, type ConnectorButtonsProps, type ConnectorClient, type ConnectorMechanism, type ConnectorServer, type ConnectorTargetMeta, CursorMark, DesktopMark, type ManualMcpConfig, VscodeMark, WrenchMark, buildCursorDeeplink, buildManualConfig, buildManualConfigSnippet, buildVscodeDeeplink, connectorHref, encodeBase64Json, slugifyServerName };

package/dist/connectors/index.d.ts

@@ -0,0 +1,130 @@
+import * as react from 'react';
+import { ReactNode, CSSProperties, ComponentType, SVGProps } from 'react';
+export { D as DEFAULT_MCPB_ENTRY_POINT, b as MCPB_MANIFEST_VERSION, c as MCPB_MIN_NODE, M as McpbManifestInput, a as McpbTool, d as buildMcpbManifest, e as buildMcpbProxyStub } from '../mcpb-BXOrsRnv.js';
+
+/** The MCP hosts we know how to generate an install affordance for. */
+type ConnectorClient = "claude-web" | "claude-desktop" | "cursor" | "vscode" | "manual";
+/** A remote MCP server to generate install artifacts for. */
+interface ConnectorServer {
+    /** Human-readable server name, e.g. `"Decksmith"`. */
+    name: string;
+    /** The remote MCP endpoint, e.g. `"https://decksmith.dev/mcp"`. */
+    url: string;
+}
+/**
+ * Claude's Connectors page — the manual "Add custom connector" flow.
+ *
+ * Claude exposes no install deeplink, so a button can only copy the URL and
+ * open this page for a paste. Override per-app if Claude moves it (it has
+ * historically lived at both `/settings/connectors` and `/customize/connectors`).
+ */
+declare const CLAUDE_CONNECTORS_URL = "https://claude.ai/settings/connectors";
+/** Base64-encode a JSON value, working in both the browser and Node. */
+declare function encodeBase64Json(value: unknown): string;
+/**
+ * Cursor install deeplink for a remote (HTTP) MCP server.
+ *
+ * `cursor://anysphere.cursor-deeplink/mcp/install?name=<name>&config=<base64>`,
+ * where `config` is base64 of `{"url":"<mcpUrl>"}` — the HTTP shape, with no
+ * `type`/`transport` keys (those are for the stdio examples in the docs). The
+ * base64 is intentionally NOT percent-encoded, matching Cursor's own install
+ * links. Docs: https://cursor.com/docs/context/mcp/install-links
+ */
+declare function buildCursorDeeplink(server: ConnectorServer): string;
+/**
+ * VS Code install deeplink for a remote (HTTP) MCP server.
+ *
+ * `vscode://mcp/install?<urlencoded-json>` — URL-ENCODED JSON (not base64), the
+ * opposite encoding from Cursor and an easy one to mix up. The payload is
+ * `{ "name", "url" }`; for VS Code Insiders pass `{ insiders: true }`.
+ */
+declare function buildVscodeDeeplink(server: ConnectorServer, opts?: {
+    insiders?: boolean;
+}): string;
+/** A normalized server key for a config file (`My App` → `my-app`). */
+declare function slugifyServerName(name: string): string;
+/** The `claude_desktop_config.json` object for a manual install. */
+interface ManualMcpConfig {
+    mcpServers: Record<string, {
+        command: string;
+        args: string[];
+    }>;
+}
+/**
+ * The `claude_desktop_config.json` (or any stdio MCP client config) entry for a
+ * remote server, wrapping it with `npx -y mcp-remote <url>` — the standard
+ * stdio→HTTP bridge, since stdio clients can't take an HTTP URL directly.
+ * Requires Node 18+ on the user's machine.
+ */
+declare function buildManualConfig(server: ConnectorServer): ManualMcpConfig;
+/** Pretty-printed JSON snippet of {@link buildManualConfig}, for a copy box. */
+declare function buildManualConfigSnippet(server: ConnectorServer): string;
+/** How a given client's button behaves — drives the default UI. */
+type ConnectorMechanism = "copy-open" | "download" | "deeplink" | "snippet";
+/** Display metadata for a client, so consumers don't redraw the marks. */
+interface ConnectorTargetMeta {
+    id: ConnectorClient;
+    /** Default button label. */
+    label: string;
+    mechanism: ConnectorMechanism;
+    /** One-line tooltip explaining what the button does. */
+    hint: string;
+}
+declare const CONNECTOR_TARGETS: Record<ConnectorClient, ConnectorTargetMeta>;
+/**
+ * Resolve the navigable href for a deeplink client (cursor / vscode), or null
+ * for clients whose mechanism isn't a plain navigation.
+ */
+declare function connectorHref(client: ConnectorClient, server: ConnectorServer, opts?: {
+    insiders?: boolean;
+}): string | null;
+
+interface ConnectorButtonsProps {
+    /** Human-readable server name, e.g. `"Decksmith"`. */
+    serverName: string;
+    /** The remote MCP endpoint, e.g. `"https://decksmith.dev/mcp"`. */
+    mcpUrl: string;
+    /**
+     * Which client buttons to render, in order. Defaults to
+     * `["claude-web", "cursor", "vscode", "manual"]` — plus `"claude-desktop"`
+     * when {@link mcpbDownloadUrl} is set. A `"claude-desktop"` entry with no
+     * `mcpbDownloadUrl` is skipped (there's nothing to download).
+     */
+    clients?: ConnectorClient[];
+    /** URL of a prebuilt `.mcpb` bundle; enables the Claude Desktop button. */
+    mcpbDownloadUrl?: string;
+    /** Override Claude's Connectors page (it has moved before). */
+    claudeConnectorsUrl?: string;
+    /** Target VS Code Insiders instead of stable. */
+    vscodeInsiders?: boolean;
+    /** Fired when a value is copied to the clipboard (URL or snippet). */
+    onCopy?: (target: ConnectorClient) => void;
+    /** Fired when any button is activated (after its side effect). */
+    onAction?: (target: ConnectorClient) => void;
+    /** Per-client label override. */
+    labels?: Partial<Record<ConnectorClient, ReactNode>>;
+    className?: string;
+    style?: CSSProperties;
+}
+/**
+ * Per-client "Add to <host>" buttons for a remote MCP server, each with the
+ * right (and subtly different) install behavior baked in — see {@link
+ * ./targets}. Brand glyphs, copy/feedback states, and the manual-config popover
+ * are owned here so a consumer just passes a name + URL.
+ *
+ * Needs the package stylesheet for its default look:
+ * `import "@particle-academy/agent-integrations/styles.css"`.
+ */
+declare function ConnectorButtons({ serverName, mcpUrl, clients, mcpbDownloadUrl, claudeConnectorsUrl, vscodeInsiders, onCopy, onAction, labels, className, style, }: ConnectorButtonsProps): react.JSX.Element;
+
+type GlyphProps = SVGProps<SVGSVGElement>;
+declare function ClaudeMark(props: GlyphProps): react.JSX.Element;
+declare function CursorMark(props: GlyphProps): react.JSX.Element;
+declare function VscodeMark(props: GlyphProps): react.JSX.Element;
+declare function DesktopMark(props: GlyphProps): react.JSX.Element;
+declare function WrenchMark(props: GlyphProps): react.JSX.Element;
+
+/** Glyph component for a given client. */
+declare const CONNECTOR_GLYPHS: Record<ConnectorClient, ComponentType<GlyphProps>>;
+
+export { CLAUDE_CONNECTORS_URL, CONNECTOR_GLYPHS, CONNECTOR_TARGETS, ClaudeMark, ConnectorButtons, type ConnectorButtonsProps, type ConnectorClient, type ConnectorMechanism, type ConnectorServer, type ConnectorTargetMeta, CursorMark, DesktopMark, type ManualMcpConfig, VscodeMark, WrenchMark, buildCursorDeeplink, buildManualConfig, buildManualConfigSnippet, buildVscodeDeeplink, connectorHref, encodeBase64Json, slugifyServerName };

package/dist/connectors-build.cjs

@@ -0,0 +1,133 @@
+'use strict';
+
+var child_process = require('child_process');
+var promises = require('fs/promises');
+var os = require('os');
+var path = require('path');
+
+function _interopDefault (e) { return e && e.__esModule ? e : { default: e }; }
+
+var path__default = /*#__PURE__*/_interopDefault(path);
+
+// src/connectors/build.ts
+
+// 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"));
+`;
+}
+
+// src/connectors/build.ts
+async function writeMcpbBundle(opts) {
+  const cwd = opts.cwd ?? process.cwd();
+  const outFile = path__default.default.resolve(cwd, opts.outFile);
+  const validate = opts.validate ?? true;
+  const entryPoint = opts.manifest.entryPoint ?? DEFAULT_MCPB_ENTRY_POINT;
+  const manifest = buildMcpbManifest(opts.manifest);
+  const proxy = buildMcpbProxyStub(opts.manifest.mcpUrl);
+  const workDir = await promises.mkdtemp(path__default.default.join(os.tmpdir(), "fai-mcpb-"));
+  try {
+    await promises.writeFile(
+      path__default.default.join(workDir, "manifest.json"),
+      JSON.stringify(manifest, null, 2),
+      "utf8"
+    );
+    const entryAbs = path__default.default.join(workDir, entryPoint);
+    await promises.mkdir(path__default.default.dirname(entryAbs), { recursive: true });
+    await promises.writeFile(entryAbs, proxy, "utf8");
+    await promises.mkdir(path__default.default.dirname(outFile), { recursive: true });
+    const bin = normalizeBin(opts.mcpbBin);
+    if (validate) {
+      await run(bin, ["validate", "manifest.json"], workDir);
+    }
+    await run(bin, ["pack", workDir, outFile], cwd);
+    const bytes = (await promises.stat(outFile)).size;
+    return { outFile, bytes, manifest, workDir };
+  } finally {
+    if (!opts.keepWorkDir) {
+      await promises.rm(workDir, { recursive: true, force: true }).catch(() => {
+      });
+    }
+  }
+}
+function normalizeBin(bin) {
+  if (!bin) return ["npx", "-y", "@anthropic-ai/mcpb"];
+  return Array.isArray(bin) ? bin : [bin];
+}
+function run(bin, args, cwd) {
+  const [cmd, ...binArgs] = bin;
+  const argv = [...binArgs, ...args];
+  return new Promise((resolve, reject) => {
+    const child = child_process.spawn(cmd, argv, {
+      cwd,
+      stdio: "inherit",
+      shell: process.platform === "win32"
+      // npx resolves via .cmd on Windows
+    });
+    child.on("error", reject);
+    child.on("exit", (code) => {
+      if (code === 0) resolve();
+      else
+        reject(
+          new Error(`${cmd} ${argv.join(" ")} exited with code ${code ?? "null"}`)
+        );
+    });
+  });
+}
+
+exports.writeMcpbBundle = writeMcpbBundle;
+//# sourceMappingURL=connectors-build.cjs.map
+//# sourceMappingURL=connectors-build.cjs.map

package/dist/connectors-build.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/connectors/mcpb.ts","../src/connectors/build.ts"],"names":["path","mkdtemp","tmpdir","writeFile","mkdir","stat","rm","spawn"],"mappings":"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","file":"connectors-build.cjs","sourcesContent":["// MCPB (Claude Desktop \"Extensions\" bundle) manifest + proxy generation.\n//\n// PURE — no filesystem, no child_process — so it's trivially testable. The\n// `writeMcpbBundle` Node helper (./build) layers fs + the official mcpb CLI on\n// top of these.\n//\n// The hard fact MCPB forces on you: it is STDIO-ONLY. The manifest's\n// `server.type` is one of `node` / `python` / `binary` / `uv` — there is no\n// `type: \"http\"`. So to bundle a REMOTE MCP server (what fancy-* apps almost\n// always are) you ship a thin `node` server whose `mcp_config` runs\n// `npx -y mcp-remote <url>`, bridging stdio→HTTP. The manifest validator still\n// requires `entry_point`, so an (otherwise unused) proxy stub is emitted too.\n//\n// Future-proof: when MCPB grows a real `type: \"http\"`, drop the proxy and point\n// straight at the URL — the call site here doesn't change.\n\n/** The MCPB manifest schema version this helper emits. */\nexport const MCPB_MANIFEST_VERSION = \"0.2\";\n\n/** Minimum Node the mcp-remote proxy needs on the user's machine. */\nexport const MCPB_MIN_NODE = \">=18.0.0\";\n\n/** A tool advertised in the bundle manifest (display-only metadata). */\nexport interface McpbTool {\n  name: string;\n  description?: string;\n}\n\n/** Inputs for {@link buildMcpbManifest} / `writeMcpbBundle`. */\nexport interface McpbManifestInput {\n  /** Machine name, e.g. `\"decksmith\"` (lowercase, no spaces). */\n  name: string;\n  /** Human display name, e.g. `\"Decksmith\"`. Defaults to `name`. */\n  display_name?: string;\n  /** Bundle version, e.g. `\"0.2.0\"`. */\n  version: string;\n  /** Short one-line description. */\n  description: string;\n  /** Optional longer description shown on the extension's detail view. */\n  long_description?: string;\n  author: { name: string; url?: string; email?: string };\n  homepage?: string;\n  documentation?: string;\n  support?: string;\n  /** The remote MCP endpoint the bundle proxies to. */\n  mcpUrl: string;\n  /** Advertised tools (display metadata only). */\n  tools?: McpbTool[];\n  keywords?: string[];\n  license?: string;\n  /** Entry-point path inside the bundle. Defaults to `\"server/proxy.js\"`. */\n  entryPoint?: string;\n}\n\n/** The default entry-point path the proxy stub is written to. */\nexport const DEFAULT_MCPB_ENTRY_POINT = \"server/proxy.js\";\n\n/**\n * Build the full MCPB `manifest.json` object for a remote MCP server, wrapping\n * it with `npx -y mcp-remote <url>` (stdio→HTTP). Returns a plain object ready\n * to `JSON.stringify`.\n */\nexport function buildMcpbManifest(\n  input: McpbManifestInput,\n): Record<string, unknown> {\n  const entryPoint = input.entryPoint ?? DEFAULT_MCPB_ENTRY_POINT;\n  return {\n    manifest_version: MCPB_MANIFEST_VERSION,\n    name: input.name,\n    display_name: input.display_name ?? input.name,\n    version: input.version,\n    description: input.description,\n    ...(input.long_description\n      ? { long_description: input.long_description }\n      : {}),\n    author: input.author,\n    ...(input.homepage ? { homepage: input.homepage } : {}),\n    ...(input.documentation ? { documentation: input.documentation } : {}),\n    ...(input.support ? { support: input.support } : {}),\n    server: {\n      type: \"node\",\n      entry_point: entryPoint,\n      mcp_config: {\n        command: \"npx\",\n        args: [\"-y\", \"mcp-remote\", input.mcpUrl],\n      },\n    },\n    tools: input.tools ?? [],\n    tools_generated: false,\n    prompts_generated: false,\n    ...(input.keywords ? { keywords: input.keywords } : {}),\n    license: input.license ?? \"MIT\",\n    compatibility: {\n      claude_desktop: \">=0.10.0\",\n      platforms: [\"darwin\", \"win32\", \"linux\"],\n      runtimes: { node: MCPB_MIN_NODE },\n    },\n  };\n}\n\n/**\n * The `server/proxy.js` stub. MCPB requires an `entry_point` file even though\n * `mcp_config.command` overrides it; if it ever DOES run, it spawns\n * `npx -y mcp-remote <url>` itself so the bundle still works.\n */\nexport function buildMcpbProxyStub(mcpUrl: string): string {\n  // JSON.stringify gives us a safely-quoted JS string literal for the URL.\n  const urlLiteral = JSON.stringify(mcpUrl);\n  return `#!/usr/bin/env node\n// MCPB proxy shim (generated by @particle-academy/agent-integrations).\n//\n// MCPB (Claude Desktop Extensions) only supports local stdio servers, but this\n// MCP server is a remote HTTP endpoint. The manifest's \\`mcp_config\\` invokes\n// \\`npx -y mcp-remote <url>\\` to bridge the gap — this file is the entry_point\n// fallback the manifest validator requires. If you're seeing this run,\n// mcp_config wasn't honored; spawn mcp-remote directly so the bundle still works.\n\nconst { spawn } = require(\"node:child_process\");\n\nconst url = ${urlLiteral};\nconst child = spawn(\"npx\", [\"-y\", \"mcp-remote\", url], { stdio: \"inherit\" });\n\nchild.on(\"exit\", (code) => process.exit(code ?? 0));\nprocess.on(\"SIGINT\", () => child.kill(\"SIGINT\"));\nprocess.on(\"SIGTERM\", () => child.kill(\"SIGTERM\"));\n`;\n}\n","// Node-only build helper: generate + pack a `.mcpb` bundle for a remote MCP\n// server. Imported from `@particle-academy/agent-integrations/connectors/build`\n// at BUILD time (a CI step / a `scripts/build-mcpb.mjs`), never from browser\n// code — it touches fs + shells out to the official mcpb CLI.\n\nimport { spawn } from \"node:child_process\";\nimport { mkdtemp, writeFile, mkdir, rm, stat } from \"node:fs/promises\";\nimport { tmpdir } from \"node:os\";\nimport path from \"node:path\";\nimport {\n  buildMcpbManifest,\n  buildMcpbProxyStub,\n  DEFAULT_MCPB_ENTRY_POINT,\n  type McpbManifestInput,\n} from \"./mcpb\";\n\nexport type { McpbManifestInput, McpbTool } from \"./mcpb\";\n\nexport interface WriteMcpbBundleOptions {\n  /** Where to write the packed `.mcpb` (absolute or cwd-relative). */\n  outFile: string;\n  /** The manifest inputs (server name, version, mcpUrl, tools, …). */\n  manifest: McpbManifestInput;\n  /**\n   * The mcpb CLI to shell out to. Default: `[\"npx\", \"-y\", \"@anthropic-ai/mcpb\"]`.\n   * Pass a locally-installed binary path (string) or argv (array) to avoid the\n   * npx network fetch.\n   */\n  mcpbBin?: string | string[];\n  /** Run `mcpb validate` before packing. Default true. */\n  validate?: boolean;\n  /** Keep the temp work dir instead of removing it (debugging). Default false. */\n  keepWorkDir?: boolean;\n  /** Working directory the CLI runs in. Default `process.cwd()`. */\n  cwd?: string;\n}\n\nexport interface WriteMcpbBundleResult {\n  /** Absolute path to the written `.mcpb`. */\n  outFile: string;\n  /** Size of the written bundle in bytes. */\n  bytes: number;\n  /** The manifest object that was packed. */\n  manifest: Record<string, unknown>;\n  /** The work dir used (returned even after cleanup, for logging). */\n  workDir: string;\n}\n\n/**\n * Generate a `manifest.json` + `server/proxy.js` for a remote MCP server, then\n * validate and pack them into a `.mcpb` using the official `@anthropic-ai/mcpb`\n * CLI. Returns the output path + size.\n *\n * ```ts\n * import { writeMcpbBundle } from \"@particle-academy/agent-integrations/connectors/build\";\n *\n * await writeMcpbBundle({\n *   outFile: \"public/decksmith.mcpb\",\n *   manifest: {\n *     name: \"decksmith\",\n *     display_name: \"Decksmith\",\n *     version: \"0.2.0\",\n *     description: \"Agent-driven slide deck builder.\",\n *     author: { name: \"Particle Academy\", url: \"https://decksmith.dev\" },\n *     mcpUrl: \"https://decksmith.dev/mcp\",\n *     tools: [{ name: \"start_session\", description: \"…\" }],\n *   },\n * });\n * ```\n */\nexport async function writeMcpbBundle(\n  opts: WriteMcpbBundleOptions,\n): Promise<WriteMcpbBundleResult> {\n  const cwd = opts.cwd ?? process.cwd();\n  const outFile = path.resolve(cwd, opts.outFile);\n  const validate = opts.validate ?? true;\n  const entryPoint = opts.manifest.entryPoint ?? DEFAULT_MCPB_ENTRY_POINT;\n\n  const manifest = buildMcpbManifest(opts.manifest);\n  const proxy = buildMcpbProxyStub(opts.manifest.mcpUrl);\n\n  const workDir = await mkdtemp(path.join(tmpdir(), \"fai-mcpb-\"));\n  try {\n    // Lay out the bundle source: manifest.json + the entry-point stub.\n    await writeFile(\n      path.join(workDir, \"manifest.json\"),\n      JSON.stringify(manifest, null, 2),\n      \"utf8\",\n    );\n    const entryAbs = path.join(workDir, entryPoint);\n    await mkdir(path.dirname(entryAbs), { recursive: true });\n    await writeFile(entryAbs, proxy, \"utf8\");\n\n    // Ensure the output dir exists.\n    await mkdir(path.dirname(outFile), { recursive: true });\n\n    const bin = normalizeBin(opts.mcpbBin);\n    if (validate) {\n      await run(bin, [\"validate\", \"manifest.json\"], workDir);\n    }\n    await run(bin, [\"pack\", workDir, outFile], cwd);\n\n    const bytes = (await stat(outFile)).size;\n    return { outFile, bytes, manifest, workDir };\n  } finally {\n    if (!opts.keepWorkDir) {\n      await rm(workDir, { recursive: true, force: true }).catch(() => {});\n    }\n  }\n}\n\nfunction normalizeBin(bin: string | string[] | undefined): string[] {\n  if (!bin) return [\"npx\", \"-y\", \"@anthropic-ai/mcpb\"];\n  return Array.isArray(bin) ? bin : [bin];\n}\n\n/** Spawn `[cmd, ...args]`, inheriting stdio, rejecting on a non-zero exit. */\nfunction run(bin: string[], args: string[], cwd: string): Promise<void> {\n  const [cmd, ...binArgs] = bin;\n  const argv = [...binArgs, ...args];\n  return new Promise((resolve, reject) => {\n    const child = spawn(cmd, argv, {\n      cwd,\n      stdio: \"inherit\",\n      shell: process.platform === \"win32\", // npx resolves via .cmd on Windows\n    });\n    child.on(\"error\", reject);\n    child.on(\"exit\", (code) => {\n      if (code === 0) resolve();\n      else\n        reject(\n          new Error(`${cmd} ${argv.join(\" \")} exited with code ${code ?? \"null\"}`),\n        );\n    });\n  });\n}\n"]}

package/dist/connectors-build.js

@@ -0,0 +1,66 @@
+import { DEFAULT_MCPB_ENTRY_POINT, buildMcpbManifest, buildMcpbProxyStub } from './chunk-GO2Y6H6U.js';
+import { spawn } from 'child_process';
+import { mkdtemp, writeFile, mkdir, stat, rm } from 'fs/promises';
+import { tmpdir } from 'os';
+import path from 'path';
+
+async function writeMcpbBundle(opts) {
+  const cwd = opts.cwd ?? process.cwd();
+  const outFile = path.resolve(cwd, opts.outFile);
+  const validate = opts.validate ?? true;
+  const entryPoint = opts.manifest.entryPoint ?? DEFAULT_MCPB_ENTRY_POINT;
+  const manifest = buildMcpbManifest(opts.manifest);
+  const proxy = buildMcpbProxyStub(opts.manifest.mcpUrl);
+  const workDir = await mkdtemp(path.join(tmpdir(), "fai-mcpb-"));
+  try {
+    await writeFile(
+      path.join(workDir, "manifest.json"),
+      JSON.stringify(manifest, null, 2),
+      "utf8"
+    );
+    const entryAbs = path.join(workDir, entryPoint);
+    await mkdir(path.dirname(entryAbs), { recursive: true });
+    await writeFile(entryAbs, proxy, "utf8");
+    await mkdir(path.dirname(outFile), { recursive: true });
+    const bin = normalizeBin(opts.mcpbBin);
+    if (validate) {
+      await run(bin, ["validate", "manifest.json"], workDir);
+    }
+    await run(bin, ["pack", workDir, outFile], cwd);
+    const bytes = (await stat(outFile)).size;
+    return { outFile, bytes, manifest, workDir };
+  } finally {
+    if (!opts.keepWorkDir) {
+      await rm(workDir, { recursive: true, force: true }).catch(() => {
+      });
+    }
+  }
+}
+function normalizeBin(bin) {
+  if (!bin) return ["npx", "-y", "@anthropic-ai/mcpb"];
+  return Array.isArray(bin) ? bin : [bin];
+}
+function run(bin, args, cwd) {
+  const [cmd, ...binArgs] = bin;
+  const argv = [...binArgs, ...args];
+  return new Promise((resolve, reject) => {
+    const child = spawn(cmd, argv, {
+      cwd,
+      stdio: "inherit",
+      shell: process.platform === "win32"
+      // npx resolves via .cmd on Windows
+    });
+    child.on("error", reject);
+    child.on("exit", (code) => {
+      if (code === 0) resolve();
+      else
+        reject(
+          new Error(`${cmd} ${argv.join(" ")} exited with code ${code ?? "null"}`)
+        );
+    });
+  });
+}
+
+export { writeMcpbBundle };
+//# sourceMappingURL=connectors-build.js.map
+//# sourceMappingURL=connectors-build.js.map

package/dist/connectors-build.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/connectors/build.ts"],"names":[],"mappings":"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","file":"connectors-build.js","sourcesContent":["// Node-only build helper: generate + pack a `.mcpb` bundle for a remote MCP\n// server. Imported from `@particle-academy/agent-integrations/connectors/build`\n// at BUILD time (a CI step / a `scripts/build-mcpb.mjs`), never from browser\n// code — it touches fs + shells out to the official mcpb CLI.\n\nimport { spawn } from \"node:child_process\";\nimport { mkdtemp, writeFile, mkdir, rm, stat } from \"node:fs/promises\";\nimport { tmpdir } from \"node:os\";\nimport path from \"node:path\";\nimport {\n  buildMcpbManifest,\n  buildMcpbProxyStub,\n  DEFAULT_MCPB_ENTRY_POINT,\n  type McpbManifestInput,\n} from \"./mcpb\";\n\nexport type { McpbManifestInput, McpbTool } from \"./mcpb\";\n\nexport interface WriteMcpbBundleOptions {\n  /** Where to write the packed `.mcpb` (absolute or cwd-relative). */\n  outFile: string;\n  /** The manifest inputs (server name, version, mcpUrl, tools, …). */\n  manifest: McpbManifestInput;\n  /**\n   * The mcpb CLI to shell out to. Default: `[\"npx\", \"-y\", \"@anthropic-ai/mcpb\"]`.\n   * Pass a locally-installed binary path (string) or argv (array) to avoid the\n   * npx network fetch.\n   */\n  mcpbBin?: string | string[];\n  /** Run `mcpb validate` before packing. Default true. */\n  validate?: boolean;\n  /** Keep the temp work dir instead of removing it (debugging). Default false. */\n  keepWorkDir?: boolean;\n  /** Working directory the CLI runs in. Default `process.cwd()`. */\n  cwd?: string;\n}\n\nexport interface WriteMcpbBundleResult {\n  /** Absolute path to the written `.mcpb`. */\n  outFile: string;\n  /** Size of the written bundle in bytes. */\n  bytes: number;\n  /** The manifest object that was packed. */\n  manifest: Record<string, unknown>;\n  /** The work dir used (returned even after cleanup, for logging). */\n  workDir: string;\n}\n\n/**\n * Generate a `manifest.json` + `server/proxy.js` for a remote MCP server, then\n * validate and pack them into a `.mcpb` using the official `@anthropic-ai/mcpb`\n * CLI. Returns the output path + size.\n *\n * ```ts\n * import { writeMcpbBundle } from \"@particle-academy/agent-integrations/connectors/build\";\n *\n * await writeMcpbBundle({\n *   outFile: \"public/decksmith.mcpb\",\n *   manifest: {\n *     name: \"decksmith\",\n *     display_name: \"Decksmith\",\n *     version: \"0.2.0\",\n *     description: \"Agent-driven slide deck builder.\",\n *     author: { name: \"Particle Academy\", url: \"https://decksmith.dev\" },\n *     mcpUrl: \"https://decksmith.dev/mcp\",\n *     tools: [{ name: \"start_session\", description: \"…\" }],\n *   },\n * });\n * ```\n */\nexport async function writeMcpbBundle(\n  opts: WriteMcpbBundleOptions,\n): Promise<WriteMcpbBundleResult> {\n  const cwd = opts.cwd ?? process.cwd();\n  const outFile = path.resolve(cwd, opts.outFile);\n  const validate = opts.validate ?? true;\n  const entryPoint = opts.manifest.entryPoint ?? DEFAULT_MCPB_ENTRY_POINT;\n\n  const manifest = buildMcpbManifest(opts.manifest);\n  const proxy = buildMcpbProxyStub(opts.manifest.mcpUrl);\n\n  const workDir = await mkdtemp(path.join(tmpdir(), \"fai-mcpb-\"));\n  try {\n    // Lay out the bundle source: manifest.json + the entry-point stub.\n    await writeFile(\n      path.join(workDir, \"manifest.json\"),\n      JSON.stringify(manifest, null, 2),\n      \"utf8\",\n    );\n    const entryAbs = path.join(workDir, entryPoint);\n    await mkdir(path.dirname(entryAbs), { recursive: true });\n    await writeFile(entryAbs, proxy, \"utf8\");\n\n    // Ensure the output dir exists.\n    await mkdir(path.dirname(outFile), { recursive: true });\n\n    const bin = normalizeBin(opts.mcpbBin);\n    if (validate) {\n      await run(bin, [\"validate\", \"manifest.json\"], workDir);\n    }\n    await run(bin, [\"pack\", workDir, outFile], cwd);\n\n    const bytes = (await stat(outFile)).size;\n    return { outFile, bytes, manifest, workDir };\n  } finally {\n    if (!opts.keepWorkDir) {\n      await rm(workDir, { recursive: true, force: true }).catch(() => {});\n    }\n  }\n}\n\nfunction normalizeBin(bin: string | string[] | undefined): string[] {\n  if (!bin) return [\"npx\", \"-y\", \"@anthropic-ai/mcpb\"];\n  return Array.isArray(bin) ? bin : [bin];\n}\n\n/** Spawn `[cmd, ...args]`, inheriting stdio, rejecting on a non-zero exit. */\nfunction run(bin: string[], args: string[], cwd: string): Promise<void> {\n  const [cmd, ...binArgs] = bin;\n  const argv = [...binArgs, ...args];\n  return new Promise((resolve, reject) => {\n    const child = spawn(cmd, argv, {\n      cwd,\n      stdio: \"inherit\",\n      shell: process.platform === \"win32\", // npx resolves via .cmd on Windows\n    });\n    child.on(\"error\", reject);\n    child.on(\"exit\", (code) => {\n      if (code === 0) resolve();\n      else\n        reject(\n          new Error(`${cmd} ${argv.join(\" \")} exited with code ${code ?? \"null\"}`),\n        );\n    });\n  });\n}\n"]}