@webiny/mcp 6.3.0 → 6.4.0-beta.1

package/agents/claude.js

@@ -1,39 +1,28 @@
-/**
- * Agent adapter: Claude Code
- *
- * MCP config : .mcp.json  (project-level, checked into git)
- * Hint file  : CLAUDE.md  (Claude Code reads this automatically each session)
- *
- * Docs: https://docs.anthropic.com/en/docs/claude-code/mcp
- */
-
 import { join } from "path";
-import { writeMcpConfig, writeHintFile, webinyHintBlock, printDone } from "./shared.js";
-export const preset = {
-  slug: "claude",
-  displayName: "Claude Code",
-  configFile: ".mcp.json",
-  hintFile: "CLAUDE.md"
+import { printDone, webinyHintBlock, writeHintFile, writeMcpConfig } from "./shared.js";
+const preset = {
+    slug: "claude",
+    displayName: "Claude Code",
+    configFile: ".mcp.json",
+    hintFile: "CLAUDE.md"
 };
-export async function init({
-  ui,
-  cwd
-}) {
-  ui.info("Setting up for Claude Code...");
-  writeMcpConfig({
-    ui,
-    configPath: join(cwd, ".mcp.json")
-  });
-  writeHintFile({
-    ui,
-    hintPath: join(cwd, "CLAUDE.md"),
-    content: webinyHintBlock({
-      heading: "## Webiny"
-    })
-  });
-  printDone({
-    ui
-  });
+async function init({ ui, cwd }) {
+    ui.info("Setting up for Claude Code...");
+    writeMcpConfig({
+        ui,
+        configPath: join(cwd, ".mcp.json")
+    });
+    writeHintFile({
+        ui,
+        hintPath: join(cwd, "CLAUDE.md"),
+        content: webinyHintBlock({
+            heading: "## Webiny"
+        })
+    });
+    printDone({
+        ui
+    });
 }
+export { init, preset };
 
 //# sourceMappingURL=claude.js.map

package/agents/claude.js.map

@@ -1 +1 @@
-{"version":3,"names":["join","writeMcpConfig","writeHintFile","webinyHintBlock","printDone","preset","slug","displayName","configFile","hintFile","init","ui","cwd","info","configPath","hintPath","content","heading"],"sources":["claude.ts"],"sourcesContent":["/**\n * Agent adapter: Claude Code\n *\n * MCP config : .mcp.json  (project-level, checked into git)\n * Hint file  : CLAUDE.md  (Claude Code reads this automatically each session)\n *\n * Docs: https://docs.anthropic.com/en/docs/claude-code/mcp\n */\n\nimport { join } from \"path\";\nimport type { IUi } from \"../ui.js\";\nimport type { AgentPreset } from \"./types.js\";\nimport { writeMcpConfig, writeHintFile, webinyHintBlock, printDone } from \"./shared.js\";\n\nexport const preset: AgentPreset = {\n    slug: \"claude\",\n    displayName: \"Claude Code\",\n    configFile: \".mcp.json\",\n    hintFile: \"CLAUDE.md\"\n};\n\ninterface InitParams {\n    ui: IUi;\n    cwd: string;\n}\n\nexport async function init({ ui, cwd }: InitParams): Promise<void> {\n    ui.info(\"Setting up for Claude Code...\");\n\n    writeMcpConfig({\n        ui,\n        configPath: join(cwd, \".mcp.json\")\n    });\n\n    writeHintFile({\n        ui,\n        hintPath: join(cwd, \"CLAUDE.md\"),\n        content: webinyHintBlock({ heading: \"## Webiny\" })\n    });\n\n    printDone({ ui });\n}\n"],"mappings":"AAAA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;;AAEA,SAASA,IAAI,QAAQ,MAAM;AAG3B,SAASC,cAAc,EAAEC,aAAa,EAAEC,eAAe,EAAEC,SAAS;AAElE,OAAO,MAAMC,MAAmB,GAAG;EAC/BC,IAAI,EAAE,QAAQ;EACdC,WAAW,EAAE,aAAa;EAC1BC,UAAU,EAAE,WAAW;EACvBC,QAAQ,EAAE;AACd,CAAC;AAOD,OAAO,eAAeC,IAAIA,CAAC;EAAEC,EAAE;EAAEC;AAAgB,CAAC,EAAiB;EAC/DD,EAAE,CAACE,IAAI,CAAC,+BAA+B,CAAC;EAExCZ,cAAc,CAAC;IACXU,EAAE;IACFG,UAAU,EAAEd,IAAI,CAACY,GAAG,EAAE,WAAW;EACrC,CAAC,CAAC;EAEFV,aAAa,CAAC;IACVS,EAAE;IACFI,QAAQ,EAAEf,IAAI,CAACY,GAAG,EAAE,WAAW,CAAC;IAChCI,OAAO,EAAEb,eAAe,CAAC;MAAEc,OAAO,EAAE;IAAY,CAAC;EACrD,CAAC,CAAC;EAEFb,SAAS,CAAC;IAAEO;EAAG,CAAC,CAAC;AACrB","ignoreList":[]}
+{"version":3,"file":"agents/claude.js","sources":["../../src/agents/claude.ts"],"sourcesContent":["/**\n * Agent adapter: Claude Code\n *\n * MCP config : .mcp.json  (project-level, checked into git)\n * Hint file  : CLAUDE.md  (Claude Code reads this automatically each session)\n *\n * Docs: https://docs.anthropic.com/en/docs/claude-code/mcp\n */\n\nimport { join } from \"path\";\nimport type { IUi } from \"../ui.js\";\nimport type { AgentPreset } from \"./types.js\";\nimport { writeMcpConfig, writeHintFile, webinyHintBlock, printDone } from \"./shared.js\";\n\nexport const preset: AgentPreset = {\n    slug: \"claude\",\n    displayName: \"Claude Code\",\n    configFile: \".mcp.json\",\n    hintFile: \"CLAUDE.md\"\n};\n\ninterface InitParams {\n    ui: IUi;\n    cwd: string;\n}\n\nexport async function init({ ui, cwd }: InitParams): Promise<void> {\n    ui.info(\"Setting up for Claude Code...\");\n\n    writeMcpConfig({\n        ui,\n        configPath: join(cwd, \".mcp.json\")\n    });\n\n    writeHintFile({\n        ui,\n        hintPath: join(cwd, \"CLAUDE.md\"),\n        content: webinyHintBlock({ heading: \"## Webiny\" })\n    });\n\n    printDone({ ui });\n}\n"],"names":["preset","init","ui","cwd","writeMcpConfig","join","writeHintFile","webinyHintBlock","printDone"],"mappings":";;AAcO,MAAMA,SAAsB;IAC/B,MAAM;IACN,aAAa;IACb,YAAY;IACZ,UAAU;AACd;AAOO,eAAeC,KAAK,EAAEC,EAAE,EAAEC,GAAG,EAAc;IAC9CD,GAAG,IAAI,CAAC;IAERE,eAAe;QACXF;QACA,YAAYG,KAAKF,KAAK;IAC1B;IAEAG,cAAc;QACVJ;QACA,UAAUG,KAAKF,KAAK;QACpB,SAASI,gBAAgB;YAAE,SAAS;QAAY;IACpD;IAEAC,UAAU;QAAEN;IAAG;AACnB"}

package/agents/cline.js

@@ -1,35 +1,22 @@
-/**
- * Agent adapter: Cline
- *
- * MCP config : .vscode/cline_mcp_settings.json  (project-level)
- *
- * Cline reads instructions from its system prompt in settings,
- * so we only write the MCP config file.
- *
- * Docs: https://docs.cline.bot/mcp-servers/configuring-mcp-servers
- */
-
 import { join } from "path";
-import { writeMcpConfig, printDone } from "./shared.js";
-export const preset = {
-  slug: "cline",
-  displayName: "Cline",
-  configFile: ".vscode/cline_mcp_settings.json",
-  hintNote: "system prompt in settings"
+import { printDone, writeMcpConfig } from "./shared.js";
+const preset = {
+    slug: "cline",
+    displayName: "Cline",
+    configFile: ".vscode/cline_mcp_settings.json",
+    hintNote: "system prompt in settings"
 };
-export async function init({
-  ui,
-  cwd
-}) {
-  ui.info("Setting up for Cline...");
-  writeMcpConfig({
-    ui,
-    configPath: join(cwd, ".vscode", "cline_mcp_settings.json")
-  });
-  printDone({
-    ui,
-    extra: "Add Webiny instructions to Cline's system prompt in settings manually."
-  });
+async function init({ ui, cwd }) {
+    ui.info("Setting up for Cline...");
+    writeMcpConfig({
+        ui,
+        configPath: join(cwd, ".vscode", "cline_mcp_settings.json")
+    });
+    printDone({
+        ui,
+        extra: "Add Webiny instructions to Cline's system prompt in settings manually."
+    });
 }
+export { init, preset };
 
 //# sourceMappingURL=cline.js.map

package/agents/cline.js.map

@@ -1 +1 @@
-{"version":3,"names":["join","writeMcpConfig","printDone","preset","slug","displayName","configFile","hintNote","init","ui","cwd","info","configPath","extra"],"sources":["cline.ts"],"sourcesContent":["/**\n * Agent adapter: Cline\n *\n * MCP config : .vscode/cline_mcp_settings.json  (project-level)\n *\n * Cline reads instructions from its system prompt in settings,\n * so we only write the MCP config file.\n *\n * Docs: https://docs.cline.bot/mcp-servers/configuring-mcp-servers\n */\n\nimport { join } from \"path\";\nimport type { IUi } from \"../ui.js\";\nimport type { AgentPreset } from \"./types.js\";\nimport { writeMcpConfig, printDone } from \"./shared.js\";\n\nexport const preset: AgentPreset = {\n    slug: \"cline\",\n    displayName: \"Cline\",\n    configFile: \".vscode/cline_mcp_settings.json\",\n    hintNote: \"system prompt in settings\"\n};\n\ninterface InitParams {\n    ui: IUi;\n    cwd: string;\n}\n\nexport async function init({ ui, cwd }: InitParams): Promise<void> {\n    ui.info(\"Setting up for Cline...\");\n\n    writeMcpConfig({\n        ui,\n        configPath: join(cwd, \".vscode\", \"cline_mcp_settings.json\")\n    });\n\n    printDone({\n        ui,\n        extra: \"Add Webiny instructions to Cline's system prompt in settings manually.\"\n    });\n}\n"],"mappings":"AAAA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;;AAEA,SAASA,IAAI,QAAQ,MAAM;AAG3B,SAASC,cAAc,EAAEC,SAAS;AAElC,OAAO,MAAMC,MAAmB,GAAG;EAC/BC,IAAI,EAAE,OAAO;EACbC,WAAW,EAAE,OAAO;EACpBC,UAAU,EAAE,iCAAiC;EAC7CC,QAAQ,EAAE;AACd,CAAC;AAOD,OAAO,eAAeC,IAAIA,CAAC;EAAEC,EAAE;EAAEC;AAAgB,CAAC,EAAiB;EAC/DD,EAAE,CAACE,IAAI,CAAC,yBAAyB,CAAC;EAElCV,cAAc,CAAC;IACXQ,EAAE;IACFG,UAAU,EAAEZ,IAAI,CAACU,GAAG,EAAE,SAAS,EAAE,yBAAyB;EAC9D,CAAC,CAAC;EAEFR,SAAS,CAAC;IACNO,EAAE;IACFI,KAAK,EAAE;EACX,CAAC,CAAC;AACN","ignoreList":[]}
+{"version":3,"file":"agents/cline.js","sources":["../../src/agents/cline.ts"],"sourcesContent":["/**\n * Agent adapter: Cline\n *\n * MCP config : .vscode/cline_mcp_settings.json  (project-level)\n *\n * Cline reads instructions from its system prompt in settings,\n * so we only write the MCP config file.\n *\n * Docs: https://docs.cline.bot/mcp-servers/configuring-mcp-servers\n */\n\nimport { join } from \"path\";\nimport type { IUi } from \"../ui.js\";\nimport type { AgentPreset } from \"./types.js\";\nimport { writeMcpConfig, printDone } from \"./shared.js\";\n\nexport const preset: AgentPreset = {\n    slug: \"cline\",\n    displayName: \"Cline\",\n    configFile: \".vscode/cline_mcp_settings.json\",\n    hintNote: \"system prompt in settings\"\n};\n\ninterface InitParams {\n    ui: IUi;\n    cwd: string;\n}\n\nexport async function init({ ui, cwd }: InitParams): Promise<void> {\n    ui.info(\"Setting up for Cline...\");\n\n    writeMcpConfig({\n        ui,\n        configPath: join(cwd, \".vscode\", \"cline_mcp_settings.json\")\n    });\n\n    printDone({\n        ui,\n        extra: \"Add Webiny instructions to Cline's system prompt in settings manually.\"\n    });\n}\n"],"names":["preset","init","ui","cwd","writeMcpConfig","join","printDone"],"mappings":";;AAgBO,MAAMA,SAAsB;IAC/B,MAAM;IACN,aAAa;IACb,YAAY;IACZ,UAAU;AACd;AAOO,eAAeC,KAAK,EAAEC,EAAE,EAAEC,GAAG,EAAc;IAC9CD,GAAG,IAAI,CAAC;IAERE,eAAe;QACXF;QACA,YAAYG,KAAKF,KAAK,WAAW;IACrC;IAEAG,UAAU;QACNJ;QACA,OAAO;IACX;AACJ"}

package/agents/copilot.js

@@ -1,71 +1,57 @@
-/**
- * Agent adapter: GitHub Copilot / VS Code
- *
- * MCP config : .vscode/mcp.json  (project-level)
- * Hint file  : .github/copilot-instructions.md
- *
- * Note: VS Code uses "servers" as the top-level key, not "mcpServers".
- *
- * Docs: https://code.visualstudio.com/docs/copilot/chat/mcp-servers
- */
-
-import { join, dirname } from "path";
-import { readFileSync, writeFileSync, existsSync, mkdirSync } from "fs";
-import { writeHintFile, webinyHintBlock, printDone } from "./shared.js";
-export const preset = {
-  slug: "copilot",
-  displayName: "Copilot / VS Code",
-  configFile: ".vscode/mcp.json",
-  configNote: "uses 'servers', not 'mcpServers'",
-  hintFile: ".github/copilot-instructions.md"
+import { dirname, join } from "path";
+import { existsSync, mkdirSync, readFileSync, writeFileSync } from "fs";
+import { printDone, webinyHintBlock, writeHintFile } from "./shared.js";
+const preset = {
+    slug: "copilot",
+    displayName: "Copilot / VS Code",
+    configFile: ".vscode/mcp.json",
+    configNote: "uses 'servers', not 'mcpServers'",
+    hintFile: ".github/copilot-instructions.md"
 };
 function writeCopilotMcpConfig(ui, configPath) {
-  const dir = dirname(configPath);
-  if (!existsSync(dir)) {
-    mkdirSync(dir, {
-      recursive: true
+    const dir = dirname(configPath);
+    if (!existsSync(dir)) mkdirSync(dir, {
+        recursive: true
     });
-  }
-  const entry = {
-    command: "npx",
-    args: ["webiny-mcp", "serve"]
-  };
-  let config = {
-    servers: {}
-  };
-  if (existsSync(configPath)) {
-    try {
-      config = JSON.parse(readFileSync(configPath, "utf8"));
-      config.servers ??= {};
-    } catch {
-      ui.warning(`Could not parse %s — will overwrite.`, configPath);
+    const entry = {
+        command: "npx",
+        args: [
+            "webiny-mcp",
+            "serve"
+        ]
+    };
+    let config = {
+        servers: {}
+    };
+    if (existsSync(configPath)) try {
+        config = JSON.parse(readFileSync(configPath, "utf8"));
+        config.servers ??= {};
+    } catch  {
+        ui.warning("Could not parse %s — will overwrite.", configPath);
+    }
+    if (config.servers.webiny) {
+        ui.info(`${configPath} already has a %s entry — skipping.`, "webiny");
+        return false;
     }
-  }
-  if (config.servers.webiny) {
-    ui.info(`${configPath} already has a %s entry — skipping.`, "webiny");
-    return false;
-  }
-  config.servers.webiny = entry;
-  writeFileSync(configPath, JSON.stringify(config, null, 2) + "\n");
-  ui.success(`Registered Webiny MCP server in %s`, configPath);
-  return true;
+    config.servers.webiny = entry;
+    writeFileSync(configPath, JSON.stringify(config, null, 2) + "\n");
+    ui.success("Registered Webiny MCP server in %s", configPath);
+    return true;
 }
-export async function init({
-  ui,
-  cwd
-}) {
-  ui.info("Setting up for GitHub Copilot (VS Code)...");
-  writeCopilotMcpConfig(ui, join(cwd, ".vscode", "mcp.json"));
-  writeHintFile({
-    ui,
-    hintPath: join(cwd, ".github", "copilot-instructions.md"),
-    content: webinyHintBlock({
-      heading: "## Webiny"
-    })
-  });
-  printDone({
-    ui
-  });
+async function init({ ui, cwd }) {
+    ui.info("Setting up for GitHub Copilot (VS Code)...");
+    writeCopilotMcpConfig(ui, join(cwd, ".vscode", "mcp.json"));
+    writeHintFile({
+        ui,
+        hintPath: join(cwd, ".github", "copilot-instructions.md"),
+        content: webinyHintBlock({
+            heading: "## Webiny"
+        })
+    });
+    printDone({
+        ui
+    });
 }
+export { init, preset };
 
 //# sourceMappingURL=copilot.js.map

package/agents/copilot.js.map

@@ -1 +1 @@
-{"version":3,"names":["join","dirname","readFileSync","writeFileSync","existsSync","mkdirSync","writeHintFile","webinyHintBlock","printDone","preset","slug","displayName","configFile","configNote","hintFile","writeCopilotMcpConfig","ui","configPath","dir","recursive","entry","command","args","config","servers","JSON","parse","warning","webiny","info","stringify","success","init","cwd","hintPath","content","heading"],"sources":["copilot.ts"],"sourcesContent":["/**\n * Agent adapter: GitHub Copilot / VS Code\n *\n * MCP config : .vscode/mcp.json  (project-level)\n * Hint file  : .github/copilot-instructions.md\n *\n * Note: VS Code uses \"servers\" as the top-level key, not \"mcpServers\".\n *\n * Docs: https://code.visualstudio.com/docs/copilot/chat/mcp-servers\n */\n\nimport { join, dirname } from \"path\";\nimport { readFileSync, writeFileSync, existsSync, mkdirSync } from \"fs\";\nimport type { IUi } from \"../ui.js\";\nimport type { AgentPreset } from \"./types.js\";\nimport { writeHintFile, webinyHintBlock, printDone } from \"./shared.js\";\n\nexport const preset: AgentPreset = {\n    slug: \"copilot\",\n    displayName: \"Copilot / VS Code\",\n    configFile: \".vscode/mcp.json\",\n    configNote: \"uses 'servers', not 'mcpServers'\",\n    hintFile: \".github/copilot-instructions.md\"\n};\n\ninterface InitParams {\n    ui: IUi;\n    cwd: string;\n}\n\nfunction writeCopilotMcpConfig(ui: IUi, configPath: string): boolean {\n    const dir = dirname(configPath);\n    if (!existsSync(dir)) {\n        mkdirSync(dir, { recursive: true });\n    }\n\n    const entry = { command: \"npx\", args: [\"webiny-mcp\", \"serve\"] };\n    let config: { servers: Record<string, unknown> } = { servers: {} };\n\n    if (existsSync(configPath)) {\n        try {\n            config = JSON.parse(readFileSync(configPath, \"utf8\"));\n            config.servers ??= {};\n        } catch {\n            ui.warning(`Could not parse %s — will overwrite.`, configPath);\n        }\n    }\n\n    if (config.servers.webiny) {\n        ui.info(`${configPath} already has a %s entry — skipping.`, \"webiny\");\n        return false;\n    }\n\n    config.servers.webiny = entry;\n    writeFileSync(configPath, JSON.stringify(config, null, 2) + \"\\n\");\n    ui.success(`Registered Webiny MCP server in %s`, configPath);\n    return true;\n}\n\nexport async function init({ ui, cwd }: InitParams): Promise<void> {\n    ui.info(\"Setting up for GitHub Copilot (VS Code)...\");\n\n    writeCopilotMcpConfig(ui, join(cwd, \".vscode\", \"mcp.json\"));\n\n    writeHintFile({\n        ui,\n        hintPath: join(cwd, \".github\", \"copilot-instructions.md\"),\n        content: webinyHintBlock({ heading: \"## Webiny\" })\n    });\n\n    printDone({ ui });\n}\n"],"mappings":"AAAA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;;AAEA,SAASA,IAAI,EAAEC,OAAO,QAAQ,MAAM;AACpC,SAASC,YAAY,EAAEC,aAAa,EAAEC,UAAU,EAAEC,SAAS,QAAQ,IAAI;AAGvE,SAASC,aAAa,EAAEC,eAAe,EAAEC,SAAS;AAElD,OAAO,MAAMC,MAAmB,GAAG;EAC/BC,IAAI,EAAE,SAAS;EACfC,WAAW,EAAE,mBAAmB;EAChCC,UAAU,EAAE,kBAAkB;EAC9BC,UAAU,EAAE,kCAAkC;EAC9CC,QAAQ,EAAE;AACd,CAAC;AAOD,SAASC,qBAAqBA,CAACC,EAAO,EAAEC,UAAkB,EAAW;EACjE,MAAMC,GAAG,GAAGjB,OAAO,CAACgB,UAAU,CAAC;EAC/B,IAAI,CAACb,UAAU,CAACc,GAAG,CAAC,EAAE;IAClBb,SAAS,CAACa,GAAG,EAAE;MAAEC,SAAS,EAAE;IAAK,CAAC,CAAC;EACvC;EAEA,MAAMC,KAAK,GAAG;IAAEC,OAAO,EAAE,KAAK;IAAEC,IAAI,EAAE,CAAC,YAAY,EAAE,OAAO;EAAE,CAAC;EAC/D,IAAIC,MAA4C,GAAG;IAAEC,OAAO,EAAE,CAAC;EAAE,CAAC;EAElE,IAAIpB,UAAU,CAACa,UAAU,CAAC,EAAE;IACxB,IAAI;MACAM,MAAM,GAAGE,IAAI,CAACC,KAAK,CAACxB,YAAY,CAACe,UAAU,EAAE,MAAM,CAAC,CAAC;MACrDM,MAAM,CAACC,OAAO,KAAK,CAAC,CAAC;IACzB,CAAC,CAAC,MAAM;MACJR,EAAE,CAACW,OAAO,CAAC,sCAAsC,EAAEV,UAAU,CAAC;IAClE;EACJ;EAEA,IAAIM,MAAM,CAACC,OAAO,CAACI,MAAM,EAAE;IACvBZ,EAAE,CAACa,IAAI,CAAC,GAAGZ,UAAU,qCAAqC,EAAE,QAAQ,CAAC;IACrE,OAAO,KAAK;EAChB;EAEAM,MAAM,CAACC,OAAO,CAACI,MAAM,GAAGR,KAAK;EAC7BjB,aAAa,CAACc,UAAU,EAAEQ,IAAI,CAACK,SAAS,CAACP,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,GAAG,IAAI,CAAC;EACjEP,EAAE,CAACe,OAAO,CAAC,oCAAoC,EAAEd,UAAU,CAAC;EAC5D,OAAO,IAAI;AACf;AAEA,OAAO,eAAee,IAAIA,CAAC;EAAEhB,EAAE;EAAEiB;AAAgB,CAAC,EAAiB;EAC/DjB,EAAE,CAACa,IAAI,CAAC,4CAA4C,CAAC;EAErDd,qBAAqB,CAACC,EAAE,EAAEhB,IAAI,CAACiC,GAAG,EAAE,SAAS,EAAE,UAAU,CAAC,CAAC;EAE3D3B,aAAa,CAAC;IACVU,EAAE;IACFkB,QAAQ,EAAElC,IAAI,CAACiC,GAAG,EAAE,SAAS,EAAE,yBAAyB,CAAC;IACzDE,OAAO,EAAE5B,eAAe,CAAC;MAAE6B,OAAO,EAAE;IAAY,CAAC;EACrD,CAAC,CAAC;EAEF5B,SAAS,CAAC;IAAEQ;EAAG,CAAC,CAAC;AACrB","ignoreList":[]}
+{"version":3,"file":"agents/copilot.js","sources":["../../src/agents/copilot.ts"],"sourcesContent":["/**\n * Agent adapter: GitHub Copilot / VS Code\n *\n * MCP config : .vscode/mcp.json  (project-level)\n * Hint file  : .github/copilot-instructions.md\n *\n * Note: VS Code uses \"servers\" as the top-level key, not \"mcpServers\".\n *\n * Docs: https://code.visualstudio.com/docs/copilot/chat/mcp-servers\n */\n\nimport { join, dirname } from \"path\";\nimport { readFileSync, writeFileSync, existsSync, mkdirSync } from \"fs\";\nimport type { IUi } from \"../ui.js\";\nimport type { AgentPreset } from \"./types.js\";\nimport { writeHintFile, webinyHintBlock, printDone } from \"./shared.js\";\n\nexport const preset: AgentPreset = {\n    slug: \"copilot\",\n    displayName: \"Copilot / VS Code\",\n    configFile: \".vscode/mcp.json\",\n    configNote: \"uses 'servers', not 'mcpServers'\",\n    hintFile: \".github/copilot-instructions.md\"\n};\n\ninterface InitParams {\n    ui: IUi;\n    cwd: string;\n}\n\nfunction writeCopilotMcpConfig(ui: IUi, configPath: string): boolean {\n    const dir = dirname(configPath);\n    if (!existsSync(dir)) {\n        mkdirSync(dir, { recursive: true });\n    }\n\n    const entry = { command: \"npx\", args: [\"webiny-mcp\", \"serve\"] };\n    let config: { servers: Record<string, unknown> } = { servers: {} };\n\n    if (existsSync(configPath)) {\n        try {\n            config = JSON.parse(readFileSync(configPath, \"utf8\"));\n            config.servers ??= {};\n        } catch {\n            ui.warning(`Could not parse %s — will overwrite.`, configPath);\n        }\n    }\n\n    if (config.servers.webiny) {\n        ui.info(`${configPath} already has a %s entry — skipping.`, \"webiny\");\n        return false;\n    }\n\n    config.servers.webiny = entry;\n    writeFileSync(configPath, JSON.stringify(config, null, 2) + \"\\n\");\n    ui.success(`Registered Webiny MCP server in %s`, configPath);\n    return true;\n}\n\nexport async function init({ ui, cwd }: InitParams): Promise<void> {\n    ui.info(\"Setting up for GitHub Copilot (VS Code)...\");\n\n    writeCopilotMcpConfig(ui, join(cwd, \".vscode\", \"mcp.json\"));\n\n    writeHintFile({\n        ui,\n        hintPath: join(cwd, \".github\", \"copilot-instructions.md\"),\n        content: webinyHintBlock({ heading: \"## Webiny\" })\n    });\n\n    printDone({ ui });\n}\n"],"names":["preset","writeCopilotMcpConfig","ui","configPath","dir","dirname","existsSync","mkdirSync","entry","config","JSON","readFileSync","writeFileSync","init","cwd","join","writeHintFile","webinyHintBlock","printDone"],"mappings":";;;AAiBO,MAAMA,SAAsB;IAC/B,MAAM;IACN,aAAa;IACb,YAAY;IACZ,YAAY;IACZ,UAAU;AACd;AAOA,SAASC,sBAAsBC,EAAO,EAAEC,UAAkB;IACtD,MAAMC,MAAMC,QAAQF;IACpB,IAAI,CAACG,WAAWF,MACZG,UAAUH,KAAK;QAAE,WAAW;IAAK;IAGrC,MAAMI,QAAQ;QAAE,SAAS;QAAO,MAAM;YAAC;YAAc;SAAQ;IAAC;IAC9D,IAAIC,SAA+C;QAAE,SAAS,CAAC;IAAE;IAEjE,IAAIH,WAAWH,aACX,IAAI;QACAM,SAASC,KAAK,KAAK,CAACC,aAAaR,YAAY;QAC7CM,OAAO,OAAO,KAAK,CAAC;IACxB,EAAE,OAAM;QACJP,GAAG,OAAO,CAAC,wCAAwCC;IACvD;IAGJ,IAAIM,OAAO,OAAO,CAAC,MAAM,EAAE;QACvBP,GAAG,IAAI,CAAC,GAAGC,WAAW,mCAAmC,CAAC,EAAE;QAC5D,OAAO;IACX;IAEAM,OAAO,OAAO,CAAC,MAAM,GAAGD;IACxBI,cAAcT,YAAYO,KAAK,SAAS,CAACD,QAAQ,MAAM,KAAK;IAC5DP,GAAG,OAAO,CAAC,sCAAsCC;IACjD,OAAO;AACX;AAEO,eAAeU,KAAK,EAAEX,EAAE,EAAEY,GAAG,EAAc;IAC9CZ,GAAG,IAAI,CAAC;IAERD,sBAAsBC,IAAIa,KAAKD,KAAK,WAAW;IAE/CE,cAAc;QACVd;QACA,UAAUa,KAAKD,KAAK,WAAW;QAC/B,SAASG,gBAAgB;YAAE,SAAS;QAAY;IACpD;IAEAC,UAAU;QAAEhB;IAAG;AACnB"}

package/agents/cursor.js

@@ -1,39 +1,28 @@
-/**
- * Agent adapter: Cursor
- *
- * MCP config : .cursor/mcp.json  (project-level)
- * Hint file  : .cursor/rules/webiny.mdc
- *
- * Docs: https://docs.cursor.com/context/model-context-protocol
- */
-
 import { join } from "path";
-import { writeMcpConfig, writeHintFile, webinyHintBlock, printDone } from "./shared.js";
-export const preset = {
-  slug: "cursor",
-  displayName: "Cursor",
-  configFile: ".cursor/mcp.json",
-  hintFile: ".cursor/rules/*.mdc"
+import { printDone, webinyHintBlock, writeHintFile, writeMcpConfig } from "./shared.js";
+const preset = {
+    slug: "cursor",
+    displayName: "Cursor",
+    configFile: ".cursor/mcp.json",
+    hintFile: ".cursor/rules/*.mdc"
 };
-export async function init({
-  ui,
-  cwd
-}) {
-  ui.info("Setting up for Cursor...");
-  writeMcpConfig({
-    ui,
-    configPath: join(cwd, ".cursor", "mcp.json")
-  });
-  writeHintFile({
-    ui,
-    hintPath: join(cwd, ".cursor", "rules", "webiny.mdc"),
-    content: webinyHintBlock({
-      heading: "# Webiny"
-    })
-  });
-  printDone({
-    ui
-  });
+async function init({ ui, cwd }) {
+    ui.info("Setting up for Cursor...");
+    writeMcpConfig({
+        ui,
+        configPath: join(cwd, ".cursor", "mcp.json")
+    });
+    writeHintFile({
+        ui,
+        hintPath: join(cwd, ".cursor", "rules", "webiny.mdc"),
+        content: webinyHintBlock({
+            heading: "# Webiny"
+        })
+    });
+    printDone({
+        ui
+    });
 }
+export { init, preset };
 
 //# sourceMappingURL=cursor.js.map

package/agents/cursor.js.map

@@ -1 +1 @@
-{"version":3,"names":["join","writeMcpConfig","writeHintFile","webinyHintBlock","printDone","preset","slug","displayName","configFile","hintFile","init","ui","cwd","info","configPath","hintPath","content","heading"],"sources":["cursor.ts"],"sourcesContent":["/**\n * Agent adapter: Cursor\n *\n * MCP config : .cursor/mcp.json  (project-level)\n * Hint file  : .cursor/rules/webiny.mdc\n *\n * Docs: https://docs.cursor.com/context/model-context-protocol\n */\n\nimport { join } from \"path\";\nimport type { IUi } from \"../ui.js\";\nimport type { AgentPreset } from \"./types.js\";\nimport { writeMcpConfig, writeHintFile, webinyHintBlock, printDone } from \"./shared.js\";\n\nexport const preset: AgentPreset = {\n    slug: \"cursor\",\n    displayName: \"Cursor\",\n    configFile: \".cursor/mcp.json\",\n    hintFile: \".cursor/rules/*.mdc\"\n};\n\ninterface InitParams {\n    ui: IUi;\n    cwd: string;\n}\n\nexport async function init({ ui, cwd }: InitParams): Promise<void> {\n    ui.info(\"Setting up for Cursor...\");\n\n    writeMcpConfig({\n        ui,\n        configPath: join(cwd, \".cursor\", \"mcp.json\")\n    });\n\n    writeHintFile({\n        ui,\n        hintPath: join(cwd, \".cursor\", \"rules\", \"webiny.mdc\"),\n        content: webinyHintBlock({ heading: \"# Webiny\" })\n    });\n\n    printDone({ ui });\n}\n"],"mappings":"AAAA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;;AAEA,SAASA,IAAI,QAAQ,MAAM;AAG3B,SAASC,cAAc,EAAEC,aAAa,EAAEC,eAAe,EAAEC,SAAS;AAElE,OAAO,MAAMC,MAAmB,GAAG;EAC/BC,IAAI,EAAE,QAAQ;EACdC,WAAW,EAAE,QAAQ;EACrBC,UAAU,EAAE,kBAAkB;EAC9BC,QAAQ,EAAE;AACd,CAAC;AAOD,OAAO,eAAeC,IAAIA,CAAC;EAAEC,EAAE;EAAEC;AAAgB,CAAC,EAAiB;EAC/DD,EAAE,CAACE,IAAI,CAAC,0BAA0B,CAAC;EAEnCZ,cAAc,CAAC;IACXU,EAAE;IACFG,UAAU,EAAEd,IAAI,CAACY,GAAG,EAAE,SAAS,EAAE,UAAU;EAC/C,CAAC,CAAC;EAEFV,aAAa,CAAC;IACVS,EAAE;IACFI,QAAQ,EAAEf,IAAI,CAACY,GAAG,EAAE,SAAS,EAAE,OAAO,EAAE,YAAY,CAAC;IACrDI,OAAO,EAAEb,eAAe,CAAC;MAAEc,OAAO,EAAE;IAAW,CAAC;EACpD,CAAC,CAAC;EAEFb,SAAS,CAAC;IAAEO;EAAG,CAAC,CAAC;AACrB","ignoreList":[]}
+{"version":3,"file":"agents/cursor.js","sources":["../../src/agents/cursor.ts"],"sourcesContent":["/**\n * Agent adapter: Cursor\n *\n * MCP config : .cursor/mcp.json  (project-level)\n * Hint file  : .cursor/rules/webiny.mdc\n *\n * Docs: https://docs.cursor.com/context/model-context-protocol\n */\n\nimport { join } from \"path\";\nimport type { IUi } from \"../ui.js\";\nimport type { AgentPreset } from \"./types.js\";\nimport { writeMcpConfig, writeHintFile, webinyHintBlock, printDone } from \"./shared.js\";\n\nexport const preset: AgentPreset = {\n    slug: \"cursor\",\n    displayName: \"Cursor\",\n    configFile: \".cursor/mcp.json\",\n    hintFile: \".cursor/rules/*.mdc\"\n};\n\ninterface InitParams {\n    ui: IUi;\n    cwd: string;\n}\n\nexport async function init({ ui, cwd }: InitParams): Promise<void> {\n    ui.info(\"Setting up for Cursor...\");\n\n    writeMcpConfig({\n        ui,\n        configPath: join(cwd, \".cursor\", \"mcp.json\")\n    });\n\n    writeHintFile({\n        ui,\n        hintPath: join(cwd, \".cursor\", \"rules\", \"webiny.mdc\"),\n        content: webinyHintBlock({ heading: \"# Webiny\" })\n    });\n\n    printDone({ ui });\n}\n"],"names":["preset","init","ui","cwd","writeMcpConfig","join","writeHintFile","webinyHintBlock","printDone"],"mappings":";;AAcO,MAAMA,SAAsB;IAC/B,MAAM;IACN,aAAa;IACb,YAAY;IACZ,UAAU;AACd;AAOO,eAAeC,KAAK,EAAEC,EAAE,EAAEC,GAAG,EAAc;IAC9CD,GAAG,IAAI,CAAC;IAERE,eAAe;QACXF;QACA,YAAYG,KAAKF,KAAK,WAAW;IACrC;IAEAG,cAAc;QACVJ;QACA,UAAUG,KAAKF,KAAK,WAAW,SAAS;QACxC,SAASI,gBAAgB;YAAE,SAAS;QAAW;IACnD;IAEAC,UAAU;QAAEN;IAAG;AACnB"}

package/agents/discover.js

@@ -2,28 +2,25 @@ import { readdirSync } from "fs";
 import { fileURLToPath } from "url";
 import { dirname, join } from "path";
 let cache = null;
-export async function discoverAgents() {
-  if (cache) {
-    return cache;
-  }
-  const agentsDir = dirname(fileURLToPath(import.meta.url));
-  const files = readdirSync(agentsDir).filter(f => f.endsWith(".js") && !f.endsWith(".d.ts") && !f.endsWith(".js.map"));
-  const agents = new Map();
-  for (const file of files) {
-    const mod = await import(join(agentsDir, file));
-    if (mod.preset && typeof mod.init === "function") {
-      agents.set(mod.preset.slug, {
-        preset: mod.preset,
-        init: mod.init
-      });
+async function discoverAgents() {
+    if (cache) return cache;
+    const agentsDir = dirname(fileURLToPath(import.meta.url));
+    const files = readdirSync(agentsDir).filter((f)=>f.endsWith(".js") && !f.endsWith(".d.ts") && !f.endsWith(".js.map"));
+    const agents = new Map();
+    for (const file of files){
+        const mod = await import(join(agentsDir, file));
+        if (mod.preset && "function" == typeof mod.init) agents.set(mod.preset.slug, {
+            preset: mod.preset,
+            init: mod.init
+        });
     }
-  }
-  cache = agents;
-  return agents;
+    cache = agents;
+    return agents;
 }
-export async function discoverPresets() {
-  const agents = await discoverAgents();
-  return Array.from(agents.values()).map(a => a.preset);
+async function discoverPresets() {
+    const agents = await discoverAgents();
+    return Array.from(agents.values()).map((a)=>a.preset);
 }
+export { discoverAgents, discoverPresets };
 
 //# sourceMappingURL=discover.js.map

package/agents/discover.js.map

@@ -1 +1 @@
-{"version":3,"names":["readdirSync","fileURLToPath","dirname","join","cache","discoverAgents","agentsDir","import","meta","url","files","filter","f","endsWith","agents","Map","file","mod","preset","init","set","slug","discoverPresets","Array","from","values","map","a"],"sources":["discover.ts"],"sourcesContent":["import { readdirSync } from \"fs\";\nimport { fileURLToPath } from \"url\";\nimport { dirname, join } from \"path\";\nimport type { AgentPreset, AgentModule } from \"./types.js\";\n\nlet cache: Map<string, AgentModule> | null = null;\n\nexport async function discoverAgents(): Promise<Map<string, AgentModule>> {\n    if (cache) {\n        return cache;\n    }\n\n    const agentsDir = dirname(fileURLToPath(import.meta.url));\n    const files = readdirSync(agentsDir).filter(\n        f => f.endsWith(\".js\") && !f.endsWith(\".d.ts\") && !f.endsWith(\".js.map\")\n    );\n\n    const agents = new Map<string, AgentModule>();\n\n    for (const file of files) {\n        const mod = await import(join(agentsDir, file));\n        if (mod.preset && typeof mod.init === \"function\") {\n            agents.set(mod.preset.slug, { preset: mod.preset, init: mod.init });\n        }\n    }\n\n    cache = agents;\n    return agents;\n}\n\nexport async function discoverPresets(): Promise<AgentPreset[]> {\n    const agents = await discoverAgents();\n    return Array.from(agents.values()).map(a => a.preset);\n}\n"],"mappings":"AAAA,SAASA,WAAW,QAAQ,IAAI;AAChC,SAASC,aAAa,QAAQ,KAAK;AACnC,SAASC,OAAO,EAAEC,IAAI,QAAQ,MAAM;AAGpC,IAAIC,KAAsC,GAAG,IAAI;AAEjD,OAAO,eAAeC,cAAcA,CAAA,EAAsC;EACtE,IAAID,KAAK,EAAE;IACP,OAAOA,KAAK;EAChB;EAEA,MAAME,SAAS,GAAGJ,OAAO,CAACD,aAAa,CAACM,MAAM,CAACC,IAAI,CAACC,GAAG,CAAC,CAAC;EACzD,MAAMC,KAAK,GAAGV,WAAW,CAACM,SAAS,CAAC,CAACK,MAAM,CACvCC,CAAC,IAAIA,CAAC,CAACC,QAAQ,CAAC,KAAK,CAAC,IAAI,CAACD,CAAC,CAACC,QAAQ,CAAC,OAAO,CAAC,IAAI,CAACD,CAAC,CAACC,QAAQ,CAAC,SAAS,CAC3E,CAAC;EAED,MAAMC,MAAM,GAAG,IAAIC,GAAG,CAAsB,CAAC;EAE7C,KAAK,MAAMC,IAAI,IAAIN,KAAK,EAAE;IACtB,MAAMO,GAAG,GAAG,MAAM,MAAM,CAACd,IAAI,CAACG,SAAS,EAAEU,IAAI,CAAC,CAAC;IAC/C,IAAIC,GAAG,CAACC,MAAM,IAAI,OAAOD,GAAG,CAACE,IAAI,KAAK,UAAU,EAAE;MAC9CL,MAAM,CAACM,GAAG,CAACH,GAAG,CAACC,MAAM,CAACG,IAAI,EAAE;QAAEH,MAAM,EAAED,GAAG,CAACC,MAAM;QAAEC,IAAI,EAAEF,GAAG,CAACE;MAAK,CAAC,CAAC;IACvE;EACJ;EAEAf,KAAK,GAAGU,MAAM;EACd,OAAOA,MAAM;AACjB;AAEA,OAAO,eAAeQ,eAAeA,CAAA,EAA2B;EAC5D,MAAMR,MAAM,GAAG,MAAMT,cAAc,CAAC,CAAC;EACrC,OAAOkB,KAAK,CAACC,IAAI,CAACV,MAAM,CAACW,MAAM,CAAC,CAAC,CAAC,CAACC,GAAG,CAACC,CAAC,IAAIA,CAAC,CAACT,MAAM,CAAC;AACzD","ignoreList":[]}
+{"version":3,"file":"agents/discover.js","sources":["../../src/agents/discover.ts"],"sourcesContent":["import { readdirSync } from \"fs\";\nimport { fileURLToPath } from \"url\";\nimport { dirname, join } from \"path\";\nimport type { AgentPreset, AgentModule } from \"./types.js\";\n\nlet cache: Map<string, AgentModule> | null = null;\n\nexport async function discoverAgents(): Promise<Map<string, AgentModule>> {\n    if (cache) {\n        return cache;\n    }\n\n    const agentsDir = dirname(fileURLToPath(import.meta.url));\n    const files = readdirSync(agentsDir).filter(\n        f => f.endsWith(\".js\") && !f.endsWith(\".d.ts\") && !f.endsWith(\".js.map\")\n    );\n\n    const agents = new Map<string, AgentModule>();\n\n    for (const file of files) {\n        const mod = await import(join(agentsDir, file));\n        if (mod.preset && typeof mod.init === \"function\") {\n            agents.set(mod.preset.slug, { preset: mod.preset, init: mod.init });\n        }\n    }\n\n    cache = agents;\n    return agents;\n}\n\nexport async function discoverPresets(): Promise<AgentPreset[]> {\n    const agents = await discoverAgents();\n    return Array.from(agents.values()).map(a => a.preset);\n}\n"],"names":["cache","discoverAgents","agentsDir","dirname","fileURLToPath","files","readdirSync","f","agents","Map","file","mod","join","discoverPresets","Array","a"],"mappings":";;;AAKA,IAAIA,QAAyC;AAEtC,eAAeC;IAClB,IAAID,OACA,OAAOA;IAGX,MAAME,YAAYC,QAAQC,cAAc,YAAY,GAAG;IACvD,MAAMC,QAAQC,YAAYJ,WAAW,MAAM,CACvCK,CAAAA,IAAKA,EAAE,QAAQ,CAAC,UAAU,CAACA,EAAE,QAAQ,CAAC,YAAY,CAACA,EAAE,QAAQ,CAAC;IAGlE,MAAMC,SAAS,IAAIC;IAEnB,KAAK,MAAMC,QAAQL,MAAO;QACtB,MAAMM,MAAM,MAAM,MAAM,CAACC,KAAKV,WAAWQ;QACzC,IAAIC,IAAI,MAAM,IAAI,AAAoB,cAApB,OAAOA,IAAI,IAAI,EAC7BH,OAAO,GAAG,CAACG,IAAI,MAAM,CAAC,IAAI,EAAE;YAAE,QAAQA,IAAI,MAAM;YAAE,MAAMA,IAAI,IAAI;QAAC;IAEzE;IAEAX,QAAQQ;IACR,OAAOA;AACX;AAEO,eAAeK;IAClB,MAAML,SAAS,MAAMP;IACrB,OAAOa,MAAM,IAAI,CAACN,OAAO,MAAM,IAAI,GAAG,CAACO,CAAAA,IAAKA,EAAE,MAAM;AACxD"}

package/agents/instructions.js

@@ -1,26 +1,87 @@
-/**
- * --instructions / --manual
- *
- * Prints a clear, copy-paste-friendly guide for wiring up the Webiny MCP
- * server in any agent not covered by the built-in adapters.
- *
- * The agent tables are auto-generated from preset metadata.
- */
-
 import { discoverPresets } from "./discover.js";
-export async function printInstructions() {
-  const presets = await discoverPresets();
-  const configRows = presets.map(p => {
-    const note = p.configNote ? `  (${p.configNote})` : "";
-    return formatRow(p.displayName, p.configFile + note);
-  });
-  const hintRows = presets.filter(p => p.hintFile).map(p => formatRow(p.displayName, p.hintFile));
-  presets.filter(p => !p.hintFile && p.hintNote).forEach(p => hintRows.push(formatRow(p.displayName, p.hintNote)));
-  const lines = ["", "╔══════════════════════════════════════════════════════════════════╗", "║           Webiny MCP Server — Manual Setup Guide                ║", "╚══════════════════════════════════════════════════════════════════╝", "", "The Webiny MCP server works with any agent that supports the Model", "Context Protocol (MCP) over stdio transport.", "", "── Step 1: Register the MCP server ───────────────────────────────", "", "Most agents accept a JSON config file. Add the following entry:", "", '  "webiny": {', '    "command": "npx",', '    "args": ["webiny-mcp", "serve"]', "  }", "", "Where this config lives depends on your agent:", "", "  Agent              Config file", "  ─────────────────  ──────────────────────────────────────", ...configRows, "", "Full example (the most common shape):", "", "  {", '    "mcpServers": {', '      "webiny": {', '        "command": "npx",', '        "args": ["webiny-mcp", "serve"]', "      }", "    }", "  }", "", "── Step 2: Tell your agent about the MCP tools ───────────────────", "", "Add the following to your agent's instruction / rules file so it", "knows to reach for the Webiny tools automatically:", "", "  ## Webiny", "  This project uses the Webiny framework.", "  A `webiny` MCP server is available.", "  When helping with Webiny-related tasks:", "  1. Call `list_webiny_skills` to see available skills.", "  2. Call `get_webiny_skill` with the relevant topic before writing code.", "", "Where this instruction file lives:", "", "  Agent              Instruction file", "  ─────────────────  ──────────────────────────────────────", ...hintRows, "", "── Step 3: Verify the server starts ──────────────────────────────", "", "Test it with the MCP Inspector before relying on it in your agent:", "", "  npx @modelcontextprotocol/inspector npx webiny-mcp server", "", "Connect, click 'List Tools', and confirm you see:", "  • list_webiny_skills", "  • get_webiny_skill", "", "── Need a built-in adapter for your agent? ───────────────────────", "", "Open an issue or PR at: https://github.com/webiny/webiny-js", "The adapter just needs to write the right config file — see", "mcp/agents/claude.ts as a reference (~20 lines).", ""];
-  process.stdout.write(lines.join("\n") + "\n");
+async function printInstructions() {
+    const presets = await discoverPresets();
+    const configRows = presets.map((p)=>{
+        const note = p.configNote ? `  (${p.configNote})` : "";
+        return formatRow(p.displayName, p.configFile + note);
+    });
+    const hintRows = presets.filter((p)=>p.hintFile).map((p)=>formatRow(p.displayName, p.hintFile));
+    presets.filter((p)=>!p.hintFile && p.hintNote).forEach((p)=>hintRows.push(formatRow(p.displayName, p.hintNote)));
+    const lines = [
+        "",
+        "╔══════════════════════════════════════════════════════════════════╗",
+        "║           Webiny MCP Server — Manual Setup Guide                ║",
+        "╚══════════════════════════════════════════════════════════════════╝",
+        "",
+        "The Webiny MCP server works with any agent that supports the Model",
+        "Context Protocol (MCP) over stdio transport.",
+        "",
+        "── Step 1: Register the MCP server ───────────────────────────────",
+        "",
+        "Most agents accept a JSON config file. Add the following entry:",
+        "",
+        '  "webiny": {',
+        '    "command": "npx",',
+        '    "args": ["webiny-mcp", "serve"]',
+        "  }",
+        "",
+        "Where this config lives depends on your agent:",
+        "",
+        "  Agent              Config file",
+        "  ─────────────────  ──────────────────────────────────────",
+        ...configRows,
+        "",
+        "Full example (the most common shape):",
+        "",
+        "  {",
+        '    "mcpServers": {',
+        '      "webiny": {',
+        '        "command": "npx",',
+        '        "args": ["webiny-mcp", "serve"]',
+        "      }",
+        "    }",
+        "  }",
+        "",
+        "── Step 2: Tell your agent about the MCP tools ───────────────────",
+        "",
+        "Add the following to your agent's instruction / rules file so it",
+        "knows to reach for the Webiny tools automatically:",
+        "",
+        "  ## Webiny",
+        "  This project uses the Webiny framework.",
+        "  A `webiny` MCP server is available.",
+        "  When helping with Webiny-related tasks:",
+        "  1. Call `list_webiny_skills` to see available skills.",
+        "  2. Call `get_webiny_skill` with the relevant topic before writing code.",
+        "",
+        "Where this instruction file lives:",
+        "",
+        "  Agent              Instruction file",
+        "  ─────────────────  ──────────────────────────────────────",
+        ...hintRows,
+        "",
+        "── Step 3: Verify the server starts ──────────────────────────────",
+        "",
+        "Test it with the MCP Inspector before relying on it in your agent:",
+        "",
+        "  npx @modelcontextprotocol/inspector npx webiny-mcp server",
+        "",
+        "Connect, click 'List Tools', and confirm you see:",
+        "  • list_webiny_skills",
+        "  • get_webiny_skill",
+        "",
+        "── Need a built-in adapter for your agent? ───────────────────────",
+        "",
+        "Open an issue or PR at: https://github.com/webiny/webiny-js",
+        "The adapter just needs to write the right config file — see",
+        "mcp/agents/claude.ts as a reference (~20 lines).",
+        ""
+    ];
+    process.stdout.write(lines.join("\n") + "\n");
 }
 function formatRow(agent, path) {
-  return `  ${agent.padEnd(17)}  ${path}`;
+    return `  ${agent.padEnd(17)}  ${path}`;
 }
+export { printInstructions };
 
 //# sourceMappingURL=instructions.js.map

package/agents/instructions.js.map

@@ -1 +1 @@
-{"version":3,"names":["discoverPresets","printInstructions","presets","configRows","map","p","note","configNote","formatRow","displayName","configFile","hintRows","filter","hintFile","hintNote","forEach","push","lines","process","stdout","write","join","agent","path","padEnd"],"sources":["instructions.ts"],"sourcesContent":["/**\n * --instructions / --manual\n *\n * Prints a clear, copy-paste-friendly guide for wiring up the Webiny MCP\n * server in any agent not covered by the built-in adapters.\n *\n * The agent tables are auto-generated from preset metadata.\n */\n\nimport { discoverPresets } from \"./discover.js\";\n\nexport async function printInstructions(): Promise<void> {\n    const presets = await discoverPresets();\n\n    const configRows = presets.map(p => {\n        const note = p.configNote ? `  (${p.configNote})` : \"\";\n        return formatRow(p.displayName, p.configFile + note);\n    });\n\n    const hintRows = presets\n        .filter(p => p.hintFile)\n        .map(p => formatRow(p.displayName, p.hintFile!));\n    presets\n        .filter(p => !p.hintFile && p.hintNote)\n        .forEach(p => hintRows.push(formatRow(p.displayName, p.hintNote!)));\n\n    const lines = [\n        \"\",\n        \"╔══════════════════════════════════════════════════════════════════╗\",\n        \"║           Webiny MCP Server — Manual Setup Guide                ║\",\n        \"╚══════════════════════════════════════════════════════════════════╝\",\n        \"\",\n        \"The Webiny MCP server works with any agent that supports the Model\",\n        \"Context Protocol (MCP) over stdio transport.\",\n        \"\",\n        \"── Step 1: Register the MCP server ───────────────────────────────\",\n        \"\",\n        \"Most agents accept a JSON config file. Add the following entry:\",\n        \"\",\n        '  \"webiny\": {',\n        '    \"command\": \"npx\",',\n        '    \"args\": [\"webiny-mcp\", \"serve\"]',\n        \"  }\",\n        \"\",\n        \"Where this config lives depends on your agent:\",\n        \"\",\n        \"  Agent              Config file\",\n        \"  ─────────────────  ──────────────────────────────────────\",\n        ...configRows,\n        \"\",\n        \"Full example (the most common shape):\",\n        \"\",\n        \"  {\",\n        '    \"mcpServers\": {',\n        '      \"webiny\": {',\n        '        \"command\": \"npx\",',\n        '        \"args\": [\"webiny-mcp\", \"serve\"]',\n        \"      }\",\n        \"    }\",\n        \"  }\",\n        \"\",\n        \"── Step 2: Tell your agent about the MCP tools ───────────────────\",\n        \"\",\n        \"Add the following to your agent's instruction / rules file so it\",\n        \"knows to reach for the Webiny tools automatically:\",\n        \"\",\n        \"  ## Webiny\",\n        \"  This project uses the Webiny framework.\",\n        \"  A `webiny` MCP server is available.\",\n        \"  When helping with Webiny-related tasks:\",\n        \"  1. Call `list_webiny_skills` to see available skills.\",\n        \"  2. Call `get_webiny_skill` with the relevant topic before writing code.\",\n        \"\",\n        \"Where this instruction file lives:\",\n        \"\",\n        \"  Agent              Instruction file\",\n        \"  ─────────────────  ──────────────────────────────────────\",\n        ...hintRows,\n        \"\",\n        \"── Step 3: Verify the server starts ──────────────────────────────\",\n        \"\",\n        \"Test it with the MCP Inspector before relying on it in your agent:\",\n        \"\",\n        \"  npx @modelcontextprotocol/inspector npx webiny-mcp server\",\n        \"\",\n        \"Connect, click 'List Tools', and confirm you see:\",\n        \"  • list_webiny_skills\",\n        \"  • get_webiny_skill\",\n        \"\",\n        \"── Need a built-in adapter for your agent? ───────────────────────\",\n        \"\",\n        \"Open an issue or PR at: https://github.com/webiny/webiny-js\",\n        \"The adapter just needs to write the right config file — see\",\n        \"mcp/agents/claude.ts as a reference (~20 lines).\",\n        \"\"\n    ];\n\n    process.stdout.write(lines.join(\"\\n\") + \"\\n\");\n}\n\nfunction formatRow(agent: string, path: string): string {\n    return `  ${agent.padEnd(17)}  ${path}`;\n}\n"],"mappings":"AAAA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;;AAEA,SAASA,eAAe;AAExB,OAAO,eAAeC,iBAAiBA,CAAA,EAAkB;EACrD,MAAMC,OAAO,GAAG,MAAMF,eAAe,CAAC,CAAC;EAEvC,MAAMG,UAAU,GAAGD,OAAO,CAACE,GAAG,CAACC,CAAC,IAAI;IAChC,MAAMC,IAAI,GAAGD,CAAC,CAACE,UAAU,GAAG,MAAMF,CAAC,CAACE,UAAU,GAAG,GAAG,EAAE;IACtD,OAAOC,SAAS,CAACH,CAAC,CAACI,WAAW,EAAEJ,CAAC,CAACK,UAAU,GAAGJ,IAAI,CAAC;EACxD,CAAC,CAAC;EAEF,MAAMK,QAAQ,GAAGT,OAAO,CACnBU,MAAM,CAACP,CAAC,IAAIA,CAAC,CAACQ,QAAQ,CAAC,CACvBT,GAAG,CAACC,CAAC,IAAIG,SAAS,CAACH,CAAC,CAACI,WAAW,EAAEJ,CAAC,CAACQ,QAAS,CAAC,CAAC;EACpDX,OAAO,CACFU,MAAM,CAACP,CAAC,IAAI,CAACA,CAAC,CAACQ,QAAQ,IAAIR,CAAC,CAACS,QAAQ,CAAC,CACtCC,OAAO,CAACV,CAAC,IAAIM,QAAQ,CAACK,IAAI,CAACR,SAAS,CAACH,CAAC,CAACI,WAAW,EAAEJ,CAAC,CAACS,QAAS,CAAC,CAAC,CAAC;EAEvE,MAAMG,KAAK,GAAG,CACV,EAAE,EACF,sEAAsE,EACtE,qEAAqE,EACrE,sEAAsE,EACtE,EAAE,EACF,oEAAoE,EACpE,8CAA8C,EAC9C,EAAE,EACF,oEAAoE,EACpE,EAAE,EACF,iEAAiE,EACjE,EAAE,EACF,eAAe,EACf,uBAAuB,EACvB,qCAAqC,EACrC,KAAK,EACL,EAAE,EACF,gDAAgD,EAChD,EAAE,EACF,kCAAkC,EAClC,6DAA6D,EAC7D,GAAGd,UAAU,EACb,EAAE,EACF,uCAAuC,EACvC,EAAE,EACF,KAAK,EACL,qBAAqB,EACrB,mBAAmB,EACnB,2BAA2B,EAC3B,yCAAyC,EACzC,SAAS,EACT,OAAO,EACP,KAAK,EACL,EAAE,EACF,oEAAoE,EACpE,EAAE,EACF,kEAAkE,EAClE,oDAAoD,EACpD,EAAE,EACF,aAAa,EACb,2CAA2C,EAC3C,uCAAuC,EACvC,2CAA2C,EAC3C,yDAAyD,EACzD,2EAA2E,EAC3E,EAAE,EACF,oCAAoC,EACpC,EAAE,EACF,uCAAuC,EACvC,6DAA6D,EAC7D,GAAGQ,QAAQ,EACX,EAAE,EACF,oEAAoE,EACpE,EAAE,EACF,oEAAoE,EACpE,EAAE,EACF,6DAA6D,EAC7D,EAAE,EACF,mDAAmD,EACnD,wBAAwB,EACxB,sBAAsB,EACtB,EAAE,EACF,oEAAoE,EACpE,EAAE,EACF,6DAA6D,EAC7D,6DAA6D,EAC7D,kDAAkD,EAClD,EAAE,CACL;EAEDO,OAAO,CAACC,MAAM,CAACC,KAAK,CAACH,KAAK,CAACI,IAAI,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC;AACjD;AAEA,SAASb,SAASA,CAACc,KAAa,EAAEC,IAAY,EAAU;EACpD,OAAO,KAAKD,KAAK,CAACE,MAAM,CAAC,EAAE,CAAC,KAAKD,IAAI,EAAE;AAC3C","ignoreList":[]}
+{"version":3,"file":"agents/instructions.js","sources":["../../src/agents/instructions.ts"],"sourcesContent":["/**\n * --instructions / --manual\n *\n * Prints a clear, copy-paste-friendly guide for wiring up the Webiny MCP\n * server in any agent not covered by the built-in adapters.\n *\n * The agent tables are auto-generated from preset metadata.\n */\n\nimport { discoverPresets } from \"./discover.js\";\n\nexport async function printInstructions(): Promise<void> {\n    const presets = await discoverPresets();\n\n    const configRows = presets.map(p => {\n        const note = p.configNote ? `  (${p.configNote})` : \"\";\n        return formatRow(p.displayName, p.configFile + note);\n    });\n\n    const hintRows = presets\n        .filter(p => p.hintFile)\n        .map(p => formatRow(p.displayName, p.hintFile!));\n    presets\n        .filter(p => !p.hintFile && p.hintNote)\n        .forEach(p => hintRows.push(formatRow(p.displayName, p.hintNote!)));\n\n    const lines = [\n        \"\",\n        \"╔══════════════════════════════════════════════════════════════════╗\",\n        \"║           Webiny MCP Server — Manual Setup Guide                ║\",\n        \"╚══════════════════════════════════════════════════════════════════╝\",\n        \"\",\n        \"The Webiny MCP server works with any agent that supports the Model\",\n        \"Context Protocol (MCP) over stdio transport.\",\n        \"\",\n        \"── Step 1: Register the MCP server ───────────────────────────────\",\n        \"\",\n        \"Most agents accept a JSON config file. Add the following entry:\",\n        \"\",\n        '  \"webiny\": {',\n        '    \"command\": \"npx\",',\n        '    \"args\": [\"webiny-mcp\", \"serve\"]',\n        \"  }\",\n        \"\",\n        \"Where this config lives depends on your agent:\",\n        \"\",\n        \"  Agent              Config file\",\n        \"  ─────────────────  ──────────────────────────────────────\",\n        ...configRows,\n        \"\",\n        \"Full example (the most common shape):\",\n        \"\",\n        \"  {\",\n        '    \"mcpServers\": {',\n        '      \"webiny\": {',\n        '        \"command\": \"npx\",',\n        '        \"args\": [\"webiny-mcp\", \"serve\"]',\n        \"      }\",\n        \"    }\",\n        \"  }\",\n        \"\",\n        \"── Step 2: Tell your agent about the MCP tools ───────────────────\",\n        \"\",\n        \"Add the following to your agent's instruction / rules file so it\",\n        \"knows to reach for the Webiny tools automatically:\",\n        \"\",\n        \"  ## Webiny\",\n        \"  This project uses the Webiny framework.\",\n        \"  A `webiny` MCP server is available.\",\n        \"  When helping with Webiny-related tasks:\",\n        \"  1. Call `list_webiny_skills` to see available skills.\",\n        \"  2. Call `get_webiny_skill` with the relevant topic before writing code.\",\n        \"\",\n        \"Where this instruction file lives:\",\n        \"\",\n        \"  Agent              Instruction file\",\n        \"  ─────────────────  ──────────────────────────────────────\",\n        ...hintRows,\n        \"\",\n        \"── Step 3: Verify the server starts ──────────────────────────────\",\n        \"\",\n        \"Test it with the MCP Inspector before relying on it in your agent:\",\n        \"\",\n        \"  npx @modelcontextprotocol/inspector npx webiny-mcp server\",\n        \"\",\n        \"Connect, click 'List Tools', and confirm you see:\",\n        \"  • list_webiny_skills\",\n        \"  • get_webiny_skill\",\n        \"\",\n        \"── Need a built-in adapter for your agent? ───────────────────────\",\n        \"\",\n        \"Open an issue or PR at: https://github.com/webiny/webiny-js\",\n        \"The adapter just needs to write the right config file — see\",\n        \"mcp/agents/claude.ts as a reference (~20 lines).\",\n        \"\"\n    ];\n\n    process.stdout.write(lines.join(\"\\n\") + \"\\n\");\n}\n\nfunction formatRow(agent: string, path: string): string {\n    return `  ${agent.padEnd(17)}  ${path}`;\n}\n"],"names":["printInstructions","presets","discoverPresets","configRows","p","note","formatRow","hintRows","lines","process","agent","path"],"mappings":";AAWO,eAAeA;IAClB,MAAMC,UAAU,MAAMC;IAEtB,MAAMC,aAAaF,QAAQ,GAAG,CAACG,CAAAA;QAC3B,MAAMC,OAAOD,EAAE,UAAU,GAAG,CAAC,GAAG,EAAEA,EAAE,UAAU,CAAC,CAAC,CAAC,GAAG;QACpD,OAAOE,UAAUF,EAAE,WAAW,EAAEA,EAAE,UAAU,GAAGC;IACnD;IAEA,MAAME,WAAWN,QACZ,MAAM,CAACG,CAAAA,IAAKA,EAAE,QAAQ,EACtB,GAAG,CAACA,CAAAA,IAAKE,UAAUF,EAAE,WAAW,EAAEA,EAAE,QAAQ;IACjDH,QACK,MAAM,CAACG,CAAAA,IAAK,CAACA,EAAE,QAAQ,IAAIA,EAAE,QAAQ,EACrC,OAAO,CAACA,CAAAA,IAAKG,SAAS,IAAI,CAACD,UAAUF,EAAE,WAAW,EAAEA,EAAE,QAAQ;IAEnE,MAAMI,QAAQ;QACV;QACA;QACA;QACA;QACA;QACA;QACA;QACA;QACA;QACA;QACA;QACA;QACA;QACA;QACA;QACA;QACA;QACA;QACA;QACA;QACA;WACGL;QACH;QACA;QACA;QACA;QACA;QACA;QACA;QACA;QACA;QACA;QACA;QACA;QACA;QACA;QACA;QACA;QACA;QACA;QACA;QACA;QACA;QACA;QACA;QACA;QACA;QACA;QACA;QACA;WACGI;QACH;QACA;QACA;QACA;QACA;QACA;QACA;QACA;QACA;QACA;QACA;QACA;QACA;QACA;QACA;QACA;QACA;KACH;IAEDE,QAAQ,MAAM,CAAC,KAAK,CAACD,MAAM,IAAI,CAAC,QAAQ;AAC5C;AAEA,SAASF,UAAUI,KAAa,EAAEC,IAAY;IAC1C,OAAO,CAAC,EAAE,EAAED,MAAM,MAAM,CAAC,IAAI,EAAE,EAAEC,MAAM;AAC3C"}