npm - webmcp-codegen - Versions diffs - 0.2.1 → 0.3.0 - Mend

webmcp-codegen 0.2.1 → 0.3.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (27) hide show

package/README.md +44 -35
package/dist/{chunk-N245GNCB.js → chunk-3LTHWIAP.js} +35 -2
package/dist/chunk-3LTHWIAP.js.map +1 -0
package/dist/{chunk-BIKKPCRT.js → chunk-FWSATV7C.js} +26 -2
package/dist/chunk-FWSATV7C.js.map +1 -0
package/dist/chunk-JVBVTHZ7.js +235 -0
package/dist/chunk-JVBVTHZ7.js.map +1 -0
package/dist/{chunk-LYHLGSAI.js → chunk-MJQ5B6HB.js} +105 -15
package/dist/chunk-MJQ5B6HB.js.map +1 -0
package/dist/{chunk-OILNQ2HE.js → chunk-TGOJ3HUE.js} +165 -34
package/dist/chunk-TGOJ3HUE.js.map +1 -0
package/dist/cli.js +258 -97
package/dist/cli.js.map +1 -1
package/dist/generators/index.d.ts +1 -1
package/dist/generators/index.js +1 -1
package/dist/index.d.ts +12 -2
package/dist/index.js +2 -2
package/dist/server-OR4IMRQ5.js +638 -0
package/dist/server-OR4IMRQ5.js.map +1 -0
package/dist/sources/index.d.ts +1 -1
package/dist/sources/index.js +2 -2
package/dist/{types-DRCQtX0w.d.ts → types-DWUum51l.d.ts} +54 -1
package/package.json +1 -1
package/dist/chunk-BIKKPCRT.js.map +0 -1
package/dist/chunk-LYHLGSAI.js.map +0 -1
package/dist/chunk-N245GNCB.js.map +0 -1
package/dist/chunk-OILNQ2HE.js.map +0 -1

package/dist/cli.js CHANGED Viewed

@@ -1,58 +1,153 @@
 #!/usr/bin/env node
 import {
-  CONFIG_FILE_NAMES,
-  loadConfig,
-  runGenerate
-} from "./chunk-LYHLGSAI.js";
-import {
-  js
-} from "./chunk-OILNQ2HE.js";
+  findSpecs,
+  loadDataFile,
+  resolveSetup,
+  saveDataFile
+} from "./chunk-JVBVTHZ7.js";
 import {
-  openapi
-} from "./chunk-N245GNCB.js";
-import "./chunk-BIKKPCRT.js";
+  runGenerate
+} from "./chunk-MJQ5B6HB.js";
+import "./chunk-TGOJ3HUE.js";
+import "./chunk-3LTHWIAP.js";
+import "./chunk-FWSATV7C.js";
 import "./chunk-KSQMJERY.js";
 // src/cli.ts
 import { existsSync, watch } from "fs";
-import { writeFile } from "fs/promises";
-import { basename, join as join2, relative as relative2 } from "path";
+import { writeFile as writeFile2 } from "fs/promises";
+import { join as join2, relative as relative2 } from "path";
+import "readline/promises";
 import { parseArgs } from "util";
-// src/detect.ts
-import { readdir } from "fs/promises";
-import { join, relative } from "path";
-var SPEC_FILE_PATTERN = /^(openapi|swagger|api)\.(ya?ml|json)$/i;
-var IGNORED_DIRS = /* @__PURE__ */ new Set([
-  "node_modules",
-  ".git",
-  ".turbo",
-  ".next",
-  "dist",
-  "build",
-  "coverage"
-]);
-var MAX_DEPTH = 5;
-async function findSpecs(cwd) {
-  const found = [];
-  async function walk(dir, depth) {
-    if (depth > MAX_DEPTH) return;
-    let entries;
-    try {
-      entries = await readdir(dir, { withFileTypes: true });
-    } catch {
-      return;
+// src/wire.ts
+import { readFile, writeFile } from "fs/promises";
+import { dirname, join, relative } from "path";
+async function planWiring(cwd, app, outDir) {
+  switch (app.framework) {
+    case "next":
+      return planNextWiring(cwd, app, outDir);
+    case "vite-react":
+      return planViteWiring(cwd, app, outDir);
+    default:
+      return null;
+  }
+}
+async function applyWiring(plan) {
+  for (const edit of plan.edits) {
+    await writeFile(edit.path, edit.contents, "utf8");
+  }
+}
+async function planNextWiring(cwd, app, outDir) {
+  const layoutCandidates = [
+    join(cwd, app.dir, "src/app/layout.tsx"),
+    join(cwd, app.dir, "src/app/layout.jsx"),
+    join(cwd, app.dir, "app/layout.tsx"),
+    join(cwd, app.dir, "app/layout.jsx")
+  ];
+  const layoutPath = await firstExisting(layoutCandidates);
+  if (!layoutPath) return null;
+  const registerPath = join(cwd, outDir, "register.tsx");
+  const layout = await readFile(layoutPath, "utf8");
+  if (layout.includes("WebMCPRegister")) return { edits: [], alreadyWired: true };
+  const importPath = withoutExtension(relative(dirname(layoutPath), registerPath));
+  const edits = [
+    {
+      path: registerPath,
+      action: "create",
+      contents: nextRegisterComponent(),
+      summary: `created ${relative(cwd, registerPath)} (a client component that registers your tools on page load)`
     }
-    for (const entry of entries) {
-      if (entry.isDirectory()) {
-        if (!IGNORED_DIRS.has(entry.name)) await walk(join(dir, entry.name), depth + 1);
-      } else if (SPEC_FILE_PATTERN.test(entry.name)) {
-        found.push({ path: join(dir, entry.name), depth });
+  ];
+  const withImport = insertAfterLastImport(
+    layout,
+    `import { WebMCPRegister } from "${importPath}";`
+  );
+  if (!withImport) return null;
+  const withComponent = withImport.replace(
+    /<body([^>]*)>\s*/,
+    "<body$1>\n        <WebMCPRegister />\n        "
+  );
+  if (withComponent === withImport) return null;
+  edits.push({
+    path: layoutPath,
+    action: "modify",
+    contents: withComponent,
+    summary: `added 2 lines to ${relative(cwd, layoutPath)} (an import and <WebMCPRegister /> inside <body>)`
+  });
+  return { edits };
+}
+function nextRegisterComponent() {
+  return `"use client";
+import { useEffect } from "react";
+import { registerAllTools } from "./index";
+/**
+ * Registers the generated WebMCP tools once, on page load.
+ * Generated by webmcp-codegen. Safe to move; keep it mounted near the root.
+ */
+export function WebMCPRegister() {
+  useEffect(() => {
+    void registerAllTools();
+  }, []);
+  return null;
+}
+`;
+}
+async function planViteWiring(cwd, app, outDir) {
+  const entryCandidates = [
+    join(cwd, app.dir, "src/main.tsx"),
+    join(cwd, app.dir, "src/main.jsx"),
+    join(cwd, app.dir, "src/index.tsx"),
+    join(cwd, app.dir, "src/index.jsx")
+  ];
+  const entryPath = await firstExisting(entryCandidates);
+  if (!entryPath) return null;
+  const entry = await readFile(entryPath, "utf8");
+  if (entry.includes("registerAllTools")) return { edits: [], alreadyWired: true };
+  const importPath = withoutExtension(relative(dirname(entryPath), join(cwd, outDir, "index")));
+  const withWiring = insertAfterLastImport(
+    entry,
+    `import { registerAllTools } from "${importPath}";
+void registerAllTools();`
+  );
+  if (!withWiring) return null;
+  return {
+    edits: [
+      {
+        path: entryPath,
+        action: "modify",
+        contents: withWiring,
+        summary: `added 2 lines to ${relative(cwd, entryPath)} (an import and a registerAllTools() call)`
       }
+    ]
+  };
+}
+function insertAfterLastImport(source, line) {
+  const lines = source.split("\n");
+  let lastImport = -1;
+  for (let index = 0; index < lines.length; index += 1) {
+    if (/^import\s/.test(lines[index])) lastImport = index;
+  }
+  if (lastImport === -1) return null;
+  lines.splice(lastImport + 1, 0, line);
+  return lines.join("\n");
+}
+function withoutExtension(path) {
+  const bare = path.replace(/\.(tsx?|jsx?)$/, "").replace(/\/index$/, "");
+  return bare.startsWith(".") ? bare : `./${bare}`;
+}
+async function firstExisting(paths) {
+  for (const path of paths) {
+    try {
+      await readFile(path, "utf8");
+      return path;
+    } catch {
     }
   }
-  await walk(cwd, 0);
-  return found.sort((a, b) => a.depth - b.depth).map((entry) => relative(cwd, entry.path));
+  return void 0;
 }
 // src/cli.ts
@@ -60,22 +155,27 @@ var HELP = `webmcp-codegen: generate WebMCP tools from the API contracts you alr
 Fastest start (no install, no config):
   npx webmcp-codegen generate --dry-run   Detect your spec, preview the tools
-  npx webmcp-codegen generate             Write the tool files
+  npx webmcp-codegen generate             Write the tool files, wire them up
 Commands:
   init                         Write a codegen.config.mjs for full control
   generate                     Generate (or update) your WebMCP tools
   generate --watch             Re-generate when files change
+  dev                          Open the tools dashboard (list, edit, try tools)
 Flags for generate:
   --spec PATH    Which OpenAPI spec to use (auto-detected when omitted)
-  --out DIR      Where the tool files go (default: ./src/webmcp)
+  --out DIR      Where the tool files go (default: your web app's src/webmcp)
   --dry-run      Preview what would be written, write nothing
   --skip-audit   Skip the safety report
   --force        Write files even when the audit reports errors
   --config PATH  Use a config file at PATH
+Flags for dev:
+  --port N       Dashboard port (default: 4700)
 `;
 var CONFIG_FILE = "codegen.config.mjs";
+var MAX_LISTED_TOOLS = 15;
 async function main() {
   const { positionals, values } = parseArgs({
     allowPositionals: true,
@@ -87,6 +187,7 @@ async function main() {
       config: { type: "string" },
       spec: { type: "string" },
       out: { type: "string" },
+      port: { type: "string" },
       help: { type: "boolean", default: false }
     }
   });
@@ -98,6 +199,8 @@ async function main() {
   switch (command) {
     case "init":
       return init();
+    case "dev":
+      return dev(Number.parseInt(values.port ?? "4700", 10));
     case "generate":
       return generate({
         dryRun: values["dry-run"],
@@ -124,7 +227,7 @@ async function init() {
   }
   const specs = await findSpecs(cwd);
   const specPath = specs.length > 0 ? `./${specs[0]}` : "./openapi.yaml";
-  await writeFile(
+  await writeFile2(
     configPath,
     `import { defineConfig } from "webmcp-codegen";
 import { openapi } from "webmcp-codegen/sources";
@@ -163,63 +266,58 @@ async function generate(flags) {
   const result = await runOnce(cwd, flags);
   return result.blocked ? 1 : 0;
 }
-async function resolveConfig(cwd, flags) {
-  const hasConfigFile = flags.configPath ? existsSync(join2(cwd, flags.configPath)) : CONFIG_FILE_NAMES.some((name) => existsSync(join2(cwd, name)));
-  if (hasConfigFile) {
-    const { config, path } = await loadConfig(cwd, flags.configPath);
-    if (flags.spec || flags.out) {
-      console.warn(`Note: --spec/--out are ignored; ${basename(path)} is in charge here.`);
-    }
-    return { config, label: basename(path) };
-  }
-  if (flags.configPath) {
-    throw new Error(`No config file at "${flags.configPath}".`);
-  }
-  const spec = flags.spec ?? await detectSpec(cwd);
-  const outDir = flags.out ?? "./src/webmcp";
-  return {
-    config: { sources: [openapi({ spec })], generate: [js({ outDir })] },
-    label: flags.spec ? `--spec ${spec}` : `detected ${spec}`
-  };
-}
-async function detectSpec(cwd) {
-  const specs = await findSpecs(cwd);
-  if (specs.length === 0) {
-    throw new Error(
-      "No OpenAPI spec found in this project.\nPoint at one:  npx webmcp-codegen generate --spec path/to/openapi.json"
-    );
-  }
-  if (specs.length > 1) {
-    const list = specs.map((spec) => `  - ${spec}`).join("\n");
-    throw new Error(
-      `Found ${specs.length} API specs:
-${list}
-Pick one:  npx webmcp-codegen generate --spec ${specs[0]}`
-    );
-  }
-  console.log(`Detected ${specs[0]} (override with --spec)
-`);
-  return specs[0];
-}
 async function runOnce(cwd, flags) {
-  const { config, label } = await resolveConfig(cwd, flags);
-  const result = await runGenerate(config, {
+  const setup = await resolveSetup(cwd, flags);
+  const data = await loadDataFile(cwd);
+  const result = await runGenerate(setup.config, {
     cwd,
     dryRun: flags.dryRun,
     skipAudit: flags.skipAudit,
-    force: flags.force
+    force: flags.force,
+    overrides: data.overrides
   });
-  printReport(result, flags, label, cwd);
+  let wiring = null;
+  if (!result.blocked && setup.app) {
+    const outDir = findOutDir(setup.config);
+    if (outDir) {
+      wiring = await planWiring(cwd, setup.app, outDir);
+      if (wiring && wiring.edits.length > 0 && !flags.dryRun && result.wrote) {
+        await applyWiring(wiring);
+      }
+    }
+  }
+  if (!setup.fromConfigFile && !flags.dryRun && result.wrote) {
+    await saveDataFile(cwd, setup.remember);
+  }
+  printReport(result, flags, setup, wiring, cwd);
   return result;
 }
-function printReport(result, flags, configName, cwd) {
-  const { tools, findings, files, blocked } = result;
+function findOutDir(config) {
+  return config.generate[0]?.outDir;
+}
+function printReport(result, flags, setup, wiring, cwd) {
+  const { tools, skipped, findings, files, notes, blocked } = result;
   console.log(`
-webmcp-codegen (${configName}): ${tools.length} tool(s)
-`);
-  for (const tool of tools) {
-    console.log(`  ${tool.name}  [${tool.sideEffect}]  \u2190 ${tool.source.ref}`);
+webmcp-codegen (${setup.label}): ${tools.length} tool(s)`);
+  for (const note of notes) {
+    console.log(`
+  note: ${note}`);
+  }
+  if (skipped.length > 0) {
+    console.log(`
+  ${skipped.length} endpoint(s) skipped:`);
+    for (const entry of skipped) {
+      console.log(`    ${entry.ref}: ${entry.reason}`);
+    }
+  }
+  console.log("");
+  const listed = tools.slice(0, MAX_LISTED_TOOLS);
+  for (const tool of listed) {
+    const state = tool.enabledByDefault ? "" : "  starts disabled";
+    console.log(`  ${tool.name}  [${tool.sideEffect}]${state}  \u2190 ${tool.source.ref}`);
+  }
+  if (tools.length > listed.length) {
+    console.log(`  \u2026and ${tools.length - listed.length} more`);
   }
   if (findings.length > 0) {
     console.log("");
@@ -237,23 +335,86 @@ webmcp-codegen (${configName}): ${tools.length} tool(s)
       console.log(`  ${shown}: ${relative2(cwd, file.path)}`);
     }
   }
+  if (wiring) {
+    if (wiring.alreadyWired) {
+      console.log("\n  registration: already wired into your app");
+    } else if (wiring.edits.length > 0) {
+      console.log(flags.dryRun ? "\n  registration (would do):" : "\n  registration:");
+      for (const edit of wiring.edits) {
+        console.log(`    ${edit.summary}`);
+      }
+      if (!flags.dryRun) {
+        console.log("    undo: delete the added lines (nothing else was touched)");
+      }
+    }
+  } else if (!blocked && setup.app) {
+    console.log("\n  registration: could not find your app's entry file, so add this by hand:");
+    console.log('    import { registerAllTools } from "<path-to>/src/webmcp";');
+    console.log("    void registerAllTools();");
+  }
   if (blocked) {
     console.log(
       "\nGeneration blocked by audit errors. Fix them, or re-run with --force to write anyway."
     );
-  } else if (flags.dryRun) {
+    return;
+  }
+  if (flags.dryRun) {
     console.log("\nDry run: nothing written. Re-run without --dry-run to write these files.");
+    return;
+  }
+  printNextSteps(result);
+}
+function printNextSteps(result) {
+  const enabled = result.tools.filter((tool) => tool.enabledByDefault);
+  const disabled = result.tools.filter((tool) => !tool.enabledByDefault);
+  const parts = [];
+  if (enabled.length > 0) parts.push(`${enabled.length} read tool(s) work out of the box`);
+  if (disabled.length > 0) {
+    parts.push(`${disabled.length} tool(s) start disabled (open the file and uncomment to enable)`);
+  }
+  console.log(`
+Done. ${parts.join("; ")}.`);
+  const suggestion = pickSuggestedTool(result.tools);
+  console.log("\nTry it:");
+  console.log("  1. Start your app and open it in Chrome.");
+  console.log("  2. Turn on chrome://flags/#enable-webmcp-testing and reload the page.");
+  if (suggestion) {
+    console.log(`  3. Ask the agent: "${suggestion}"`);
   } else {
-    console.log("\nDone. Fill in each execute() below the marker, then registerAllTools().");
+    console.log("  3. Ask the agent to use one of your tools.");
   }
 }
+function pickSuggestedTool(tools) {
+  const reads = tools.filter((tool2) => tool2.enabledByDefault && tool2.endpointRole === "endpoint");
+  if (reads.length === 0) return void 0;
+  const tool = reads.find((candidate) => /^(list|get|search|find|fetch|recent)-/.test(candidate.name)) ?? reads[0];
+  if (!tool) return void 0;
+  const description = tool.description.trim().replace(/\.$/, "");
+  const looksTemplated = /^(GET|POST|PUT|PATCH|DELETE)\s/.test(description);
+  const phrase = looksTemplated ? tool.name.replace(/-/g, " ") : description.charAt(0).toLowerCase() + description.slice(1);
+  return phrase;
+}
+async function dev(port) {
+  const { startDevServer } = await import("./server-OR4IMRQ5.js");
+  const server = await startDevServer({ cwd: process.cwd(), port });
+  console.log(`
+webmcp-codegen dashboard: http://localhost:${port}`);
+  console.log("List, describe, enable, and try your tools. Ctrl+C to stop.\n");
+  await new Promise((resolveExit) => {
+    process.on("SIGINT", () => {
+      server.close();
+      resolveExit();
+    });
+  });
+  return 0;
+}
 async function watchLoop(cwd, flags) {
   await runOnce(cwd, { ...flags, dryRun: false });
   console.log("\nWatching for changes\u2026 (Ctrl+C to stop)");
   let timer;
   watch(cwd, { recursive: true }, (_event, filename) => {
     if (!filename) return;
-    if (/node_modules|\.git|\/dist|\/src\/webmcp/.test(filename)) return;
+    if (/node_modules|\.git|\/dist|\/src\/webmcp|\.webmcp-codegen\.json/.test(filename)) return;
     if (!/\.(ya?ml|json|ts|tsx|mts|mjs)$/.test(filename)) return;
     clearTimeout(timer);
     timer = setTimeout(() => {

package/dist/cli.js.map CHANGED Viewed

	@@ -1 +1 @@
1	- {"version":3,"sources":["../src/cli.ts","../src/detect.ts"],"sourcesContent":["#!/usr/bin/env node\n\n/*\n The webmcp-codegen CLI.\n \n The path we optimize for is the zero-everything first run:\n \n npx webmcp-codegen generate\n \n No install, no config file, no flags. The CLI detects your API spec and\n * generates into ./src/webmcp. When you outgrow the defaults:\n \n --spec/--out quick overrides without a config file\n * init writes codegen.config.mjs for full control (needs the\n * package installed, since the config imports from it)\n \n Plus the flags you'd expect on a codegen tool: --dry-run to preview,\n * --watch to re-run on change, --skip-audit to bypass the safety report,\n * --force to write through audit errors, --config to point at a config\n * file somewhere else.\n /\n\nimport { existsSync, watch } from \"node:fs\";\nimport { writeFile } from \"node:fs/promises\";\nimport { basename, join, relative } from \"node:path\";\nimport { parseArgs } from \"node:util\";\nimport { CONFIG_FILE_NAMES, loadConfig } from \"./config.js\";\nimport { findSpecs } from \"./detect.js\";\nimport { js } from \"./generators/js.js\";\nimport { type GenerateResult, runGenerate } from \"./pipeline.js\";\nimport { openapi } from \"./sources/openapi.js\";\nimport type { CodegenConfig } from \"./types.js\";\n\nconst HELP = `webmcp-codegen: generate WebMCP tools from the API contracts you already have\n\nFastest start (no install, no config):\n npx webmcp-codegen generate --dry-run Detect your spec, preview the tools\n npx webmcp-codegen generate Write the tool files\n\nCommands:\n init Write a codegen.config.mjs for full control\n generate Generate (or update) your WebMCP tools\n generate --watch Re-generate when files change\n\nFlags for generate:\n --spec PATH Which OpenAPI spec to use (auto-detected when omitted)\n --out DIR Where the tool files go (default: ./src/webmcp)\n --dry-run Preview what would be written, write nothing\n --skip-audit Skip the safety report\n --force Write files even when the audit reports errors\n --config PATH Use a config file at PATH\n`;\n\nconst CONFIG_FILE = \"codegen.config.mjs\";\n\nasync function main(): Promise<number> {\n const { positionals, values } = parseArgs({\n allowPositionals: true,\n options: {\n \"dry-run\": { type: \"boolean\", default: false },\n \"skip-audit\": { type: \"boolean\", default: false },\n force: { type: \"boolean\", default: false },\n watch: { type: \"boolean\", default: false },\n config: { type: \"string\" },\n spec: { type: \"string\" },\n out: { type: \"string\" },\n help: { type: \"boolean\", default: false },\n },\n });\n\n const command = positionals[0];\n if (values.help \|\| !command) {\n console.log(HELP);\n return 0;\n }\n\n switch (command) {\n case \"init\":\n return init();\n case \"generate\":\n return generate({\n dryRun: values[\"dry-run\"],\n skipAudit: values[\"skip-audit\"],\n force: values.force,\n watch: values.watch,\n configPath: values.config,\n spec: values.spec,\n out: values.out,\n });\n default:\n console.error(`Unknown command \"${command}\".\\n`);\n console.log(HELP);\n return 1;\n }\n}\n\n/* Detect the project's API spec and write a starter config. /\nasync function init(): Promise<number> {\n const cwd = process.cwd();\n const configPath = join(cwd, CONFIG_FILE);\n\n if (existsSync(configPath)) {\n console.error(`${CONFIG_FILE} already exists. Nothing to do.`);\n return 1;\n }\n\n const specs = await findSpecs(cwd);\n const specPath = specs.length > 0 ? `./${specs[0]}` : \"./openapi.yaml\";\n\n await writeFile(\n configPath,\n `import { defineConfig } from \"webmcp-codegen\";\nimport { openapi } from \"webmcp-codegen/sources\";\nimport { js } from \"webmcp-codegen/generators\";\n\nexport default defineConfig({\n sources: [openapi({ spec: \"${specPath}\" })],\n generate: [js({ outDir: \"./src/webmcp\" })],\n safety: {\n // Extra field names to treat as PII, on top of the built-in list:\n // piiFields: [\"internalId\"],\n // Tools to skip entirely (matched against name and route):\n // exclude: [\"internal\"],\n },\n});\n`,\n );\n\n // The config imports from the package, so keeping it means installing it.\n console.log(\"Installed the package? A config file needs it:\");\n console.log(\" npm install -D webmcp-codegen\\n\");\n if (specs.length > 0) {\n console.log(`Found ${specs[0]}. Wrote ${CONFIG_FILE}.`);\n console.log(\"\\nNext: npx webmcp-codegen generate --dry-run\");\n } else {\n console.log(`No OpenAPI spec found, so ${CONFIG_FILE} points at ./openapi.yaml.`);\n console.log(\"Edit the `spec` path to point at your spec, then run:\");\n console.log(\"\\n npx webmcp-codegen generate --dry-run\");\n }\n return 0;\n}\n\ninterface GenerateFlags {\n dryRun: boolean;\n skipAudit: boolean;\n force: boolean;\n watch: boolean;\n configPath?: string;\n spec?: string;\n out?: string;\n}\n\nasync function generate(flags: GenerateFlags): Promise<number> {\n const cwd = process.cwd();\n\n if (flags.watch) {\n // Watch mode never exits; it re-runs generate on every relevant change.\n await watchLoop(cwd, flags);\n return 0;\n }\n\n const result = await runOnce(cwd, flags);\n return result.blocked ? 1 : 0;\n}\n\n/\n Where the tools come from, in priority order:\n \n 1. a config file (codegen.config.mjs or --config) for full control\n * 2. --spec/--out flags as quick overrides, no config needed\n * 3. auto-detection, on the zero-argument npx run\n \n Branches 2 and 3 build the config right here inside the CLI, which is\n * what makes `npx webmcp-codegen generate` work without installing the\n * package: the user's project never has to resolve a webmcp-codegen import.\n /\nasync function resolveConfig(\n cwd: string,\n flags: GenerateFlags,\n): Promise<{ config: CodegenConfig; label: string }> {\n const hasConfigFile = flags.configPath\n ? existsSync(join(cwd, flags.configPath))\n : CONFIG_FILE_NAMES.some((name) => existsSync(join(cwd, name)));\n\n if (hasConfigFile) {\n const { config, path } = await loadConfig(cwd, flags.configPath);\n if (flags.spec \|\| flags.out) {\n console.warn(`Note: --spec/--out are ignored; ${basename(path)} is in charge here.`);\n }\n return { config, label: basename(path) };\n }\n if (flags.configPath) {\n throw new Error(`No config file at \"${flags.configPath}\".`);\n }\n\n const spec = flags.spec ?? (await detectSpec(cwd));\n const outDir = flags.out ?? \"./src/webmcp\";\n return {\n config: { sources: [openapi({ spec })], generate: [js({ outDir })] },\n label: flags.spec ? `--spec ${spec}` : `detected ${spec}`,\n };\n}\n\n/\n Find the project's API spec. One candidate: use it and say so. Several:\n * list them and make the human pick. None: say exactly what to do next.\n /\nasync function detectSpec(cwd: string): Promise<string> {\n const specs = await findSpecs(cwd);\n\n if (specs.length === 0) {\n throw new Error(\n \"No OpenAPI spec found in this project.\\n\" +\n \"Point at one: npx webmcp-codegen generate --spec path/to/openapi.json\",\n );\n }\n if (specs.length > 1) {\n const list = specs.map((spec) => ` - ${spec}`).join(\"\\n\");\n throw new Error(\n `Found ${specs.length} API specs:\\n${list}\\n\\n` +\n `Pick one: npx webmcp-codegen generate --spec ${specs[0]}`,\n );\n }\n\n console.log(`Detected ${specs[0]} (override with --spec)\\n`);\n return specs[0] as string;\n}\n\n/* One generate pass: resolve the config, run the pipeline, print the report. /\nasync function runOnce(cwd: string, flags: GenerateFlags): Promise<GenerateResult> {\n const { config, label } = await resolveConfig(cwd, flags);\n const result = await runGenerate(config, {\n cwd,\n dryRun: flags.dryRun,\n skipAudit: flags.skipAudit,\n force: flags.force,\n });\n printReport(result, flags, label, cwd);\n return result;\n}\n\n/\n The report is the product's voice: plain language, one line per file,\n * findings grouped by severity, and a summary that says what to do next.\n /\nfunction printReport(\n result: GenerateResult,\n flags: GenerateFlags,\n configName: string,\n cwd: string,\n): void {\n const { tools, findings, files, blocked } = result;\n\n console.log(`\\nwebmcp-codegen (${configName}): ${tools.length} tool(s)\\n`);\n\n for (const tool of tools) {\n console.log(` ${tool.name} [${tool.sideEffect}] ← ${tool.source.ref}`);\n }\n\n if (findings.length > 0) {\n console.log(\"\");\n for (const finding of findings) {\n const icon = finding.level === \"error\" ? \"✖\" : \"⚠\";\n const where = finding.tool ? ` (${finding.tool})` : \"\";\n console.log(` ${icon} ${finding.message}${where}`);\n }\n }\n\n if (files.length > 0) {\n console.log(\"\");\n for (const file of files) {\n if (file.action === \"unchanged\" && !file.conflict) continue;\n const shown = file.conflict\n ? `conflict → wrote ${relative(cwd, file.conflict)}`\n : file.action;\n console.log(` ${shown}: ${relative(cwd, file.path)}`);\n }\n }\n\n if (blocked) {\n console.log(\n \"\\nGeneration blocked by audit errors. Fix them, or re-run with --force to write anyway.\",\n );\n } else if (flags.dryRun) {\n console.log(\"\\nDry run: nothing written. Re-run without --dry-run to write these files.\");\n } else {\n console.log(\"\\nDone. Fill in each execute() below the marker, then registerAllTools().\");\n }\n}\n\n/\n Re-run generate when anything relevant changes. Node's recursive watcher\n * covers Linux/macOS/Windows on Node 20+, which is our engine floor anyway.\n /\nasync function watchLoop(cwd: string, flags: GenerateFlags): Promise<void> {\n await runOnce(cwd, { ...flags, dryRun: false });\n console.log(\"\\nWatching for changes… (Ctrl+C to stop)\");\n\n let timer: NodeJS.Timeout \| undefined;\n watch(cwd, { recursive: true }, (_event, filename) => {\n if (!filename) return;\n // Only source-ish changes are worth regenerating for.\n if (/node_modules\|\\.git\|\\/dist\|\\/src\\/webmcp/.test(filename)) return;\n if (!/\\.(ya?ml\|json\|ts\|tsx\|mts\|mjs)$/.test(filename)) return;\n clearTimeout(timer);\n timer = setTimeout(() => {\n runOnce(cwd, { ...flags, dryRun: false }).catch((error: unknown) => {\n console.error(error instanceof Error ? error.message : error);\n });\n }, 300);\n });\n}\n\nmain()\n .then((code) => process.exit(code))\n .catch((error: unknown) => {\n console.error(error instanceof Error ? error.message : error);\n process.exit(1);\n });\n","/\n Spec auto-detection: the reason `npx webmcp-codegen generate` works with\n * zero arguments, zero config, and zero install.\n \n The rule is deliberately boring: walk the project (skipping the obvious\n * noise), recognize the usual spec filenames, and return what we find\n * shallowest-first. When exactly one spec exists we just use it; the CLI\n * layer decides what to do about zero or several.\n /\n\nimport type { Dirent } from \"node:fs\";\nimport { readdir } from \"node:fs/promises\";\nimport { join, relative } from \"node:path\";\n\n/* Filenames we recognize as API specs. /\nexport const SPEC_FILE_PATTERN = /^(openapi\|swagger\|api)\\.(ya?ml\|json)$/i;\n\n/* Directories never worth descending into. /\nconst IGNORED_DIRS = new Set([\n \"node_modules\",\n \".git\",\n \".turbo\",\n \".next\",\n \"dist\",\n \"build\",\n \"coverage\",\n]);\n\n/\n How deep we look. Enough for monorepo layouts like\n * apps/server/openapi/openapi.json (depth 3) without wandering forever.\n /\nconst MAX_DEPTH = 5;\n\n/\n Find API spec files under `cwd`, returned as paths relative to `cwd`,\n * shallowest first. A root-level spec is a likelier intent than one\n * buried six folders deep.\n */\nexport async function findSpecs(cwd: string): Promise<string[]> {\n const found: { path: string; depth: number }[] = [];\n\n async function walk(dir: string, depth: number): Promise<void> {\n if (depth > MAX_DEPTH) return;\n let entries: Dirent[];\n try {\n entries = await readdir(dir, { withFileTypes: true });\n } catch {\n return; // Unreadable directory. Skip it, never die on detection.\n }\n for (const entry of entries) {\n if (entry.isDirectory()) {\n if (!IGNORED_DIRS.has(entry.name)) await walk(join(dir, entry.name), depth + 1);\n } else if (SPEC_FILE_PATTERN.test(entry.name)) {\n found.push({ path: join(dir, entry.name), depth });\n }\n }\n }\n\n await walk(cwd, 0);\n return found.sort((a, b) => a.depth - b.depth).map((entry) => relative(cwd, entry.path));\n}\n"],"mappings":"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","names":["join","relative","join","relative"]}
1	+ {"version":3,"sources":["../src/cli.ts","../src/wire.ts"],"sourcesContent":["#!/usr/bin/env node\n\n/*\n The webmcp-codegen CLI.\n \n The path we optimize for is the zero-everything first run:\n \n npx webmcp-codegen generate\n \n No install, no config file, no flags. The CLI finds your API spec, finds\n * the package that is your web app, writes working tools into it, wires the\n * registration into your app's entry file, and tells you how to see it all\n * working. Choices we had to ask for are remembered in .webmcp-codegen.json\n * so we never ask twice.\n \n When you outgrow the defaults:\n \n --spec/--out quick overrides without a config file\n * init writes codegen.config.mjs for full control (needs the\n * package installed, since the config imports from it)\n \n Plus the flags you'd expect on a codegen tool: --dry-run to preview,\n * --watch to re-run on change, --skip-audit to bypass the safety report,\n * --force to write through audit errors, --config to point at a config\n * file somewhere else.\n /\n\nimport { existsSync, watch } from \"node:fs\";\nimport { writeFile } from \"node:fs/promises\";\nimport { basename, join, relative } from \"node:path\";\nimport { createInterface } from \"node:readline/promises\";\nimport { parseArgs } from \"node:util\";\nimport { CONFIG_FILE_NAMES, loadConfig } from \"./config.js\";\nimport { loadDataFile, saveDataFile } from \"./data-file.js\";\nimport { findSpecs } from \"./detect.js\";\nimport { js } from \"./generators/js.js\";\nimport { type GenerateResult, runGenerate } from \"./pipeline.js\";\nimport { type GenerateFlags, resolveSetup, type Setup } from \"./setup.js\";\nimport { openapi } from \"./sources/openapi.js\";\nimport type { CodegenConfig, ReviewedTool } from \"./types.js\";\nimport { applyWiring, planWiring, type WirePlan } from \"./wire.js\";\n\nconst HELP = `webmcp-codegen: generate WebMCP tools from the API contracts you already have\n\nFastest start (no install, no config):\n npx webmcp-codegen generate --dry-run Detect your spec, preview the tools\n npx webmcp-codegen generate Write the tool files, wire them up\n\nCommands:\n init Write a codegen.config.mjs for full control\n generate Generate (or update) your WebMCP tools\n generate --watch Re-generate when files change\n dev Open the tools dashboard (list, edit, try tools)\n\nFlags for generate:\n --spec PATH Which OpenAPI spec to use (auto-detected when omitted)\n --out DIR Where the tool files go (default: your web app's src/webmcp)\n --dry-run Preview what would be written, write nothing\n --skip-audit Skip the safety report\n --force Write files even when the audit reports errors\n --config PATH Use a config file at PATH\n\nFlags for dev:\n --port N Dashboard port (default: 4700)\n`;\n\nconst CONFIG_FILE = \"codegen.config.mjs\";\n\n/* How many tools to list before folding the rest into a count. /\nconst MAX_LISTED_TOOLS = 15;\n\nasync function main(): Promise<number> {\n const { positionals, values } = parseArgs({\n allowPositionals: true,\n options: {\n \"dry-run\": { type: \"boolean\", default: false },\n \"skip-audit\": { type: \"boolean\", default: false },\n force: { type: \"boolean\", default: false },\n watch: { type: \"boolean\", default: false },\n config: { type: \"string\" },\n spec: { type: \"string\" },\n out: { type: \"string\" },\n port: { type: \"string\" },\n help: { type: \"boolean\", default: false },\n },\n });\n\n const command = positionals[0];\n if (values.help \|\| !command) {\n console.log(HELP);\n return 0;\n }\n\n switch (command) {\n case \"init\":\n return init();\n case \"dev\":\n return dev(Number.parseInt(values.port ?? \"4700\", 10));\n case \"generate\":\n return generate({\n dryRun: values[\"dry-run\"],\n skipAudit: values[\"skip-audit\"],\n force: values.force,\n watch: values.watch,\n configPath: values.config,\n spec: values.spec,\n out: values.out,\n });\n default:\n console.error(`Unknown command \"${command}\".\\n`);\n console.log(HELP);\n return 1;\n }\n}\n\n/* Detect the project's API spec and write a starter config. /\nasync function init(): Promise<number> {\n const cwd = process.cwd();\n const configPath = join(cwd, CONFIG_FILE);\n\n if (existsSync(configPath)) {\n console.error(`${CONFIG_FILE} already exists. Nothing to do.`);\n return 1;\n }\n\n const specs = await findSpecs(cwd);\n const specPath = specs.length > 0 ? `./${specs[0]}` : \"./openapi.yaml\";\n\n await writeFile(\n configPath,\n `import { defineConfig } from \"webmcp-codegen\";\nimport { openapi } from \"webmcp-codegen/sources\";\nimport { js } from \"webmcp-codegen/generators\";\n\nexport default defineConfig({\n sources: [openapi({ spec: \"${specPath}\" })],\n generate: [js({ outDir: \"./src/webmcp\" })],\n safety: {\n // Extra field names to treat as PII, on top of the built-in list:\n // piiFields: [\"internalId\"],\n // Tools to skip entirely (matched against name and route):\n // exclude: [\"internal\"],\n },\n});\n`,\n );\n\n // The config imports from the package, so keeping it means installing it.\n console.log(\"Installed the package? A config file needs it:\");\n console.log(\" npm install -D webmcp-codegen\\n\");\n if (specs.length > 0) {\n console.log(`Found ${specs[0]}. Wrote ${CONFIG_FILE}.`);\n console.log(\"\\nNext: npx webmcp-codegen generate --dry-run\");\n } else {\n console.log(`No OpenAPI spec found, so ${CONFIG_FILE} points at ./openapi.yaml.`);\n console.log(\"Edit the `spec` path to point at your spec, then run:\");\n console.log(\"\\n npx webmcp-codegen generate --dry-run\");\n }\n return 0;\n}\n\nasync function generate(flags: GenerateFlags): Promise<number> {\n const cwd = process.cwd();\n\n if (flags.watch) {\n // Watch mode never exits; it re-runs generate on every relevant change.\n // Wiring is idempotent, so it is part of every pass and quietly no-ops\n // after the first.\n await watchLoop(cwd, flags);\n return 0;\n }\n\n const result = await runOnce(cwd, flags);\n return result.blocked ? 1 : 0;\n}\n\n/* One generate pass: resolve setup, run the pipeline, wire, report. /\nasync function runOnce(cwd: string, flags: GenerateFlags): Promise<GenerateResult> {\n const setup = await resolveSetup(cwd, flags);\n const data = await loadDataFile(cwd);\n const result = await runGenerate(setup.config, {\n cwd,\n dryRun: flags.dryRun,\n skipAudit: flags.skipAudit,\n force: flags.force,\n overrides: data.overrides,\n });\n\n // Registration wiring: additive, idempotent, and only for real runs.\n let wiring: WirePlan \| null = null;\n if (!result.blocked && setup.app) {\n const outDir = findOutDir(setup.config);\n if (outDir) {\n wiring = await planWiring(cwd, setup.app, outDir);\n if (wiring && wiring.edits.length > 0 && !flags.dryRun && result.wrote) {\n await applyWiring(wiring);\n }\n }\n }\n\n // Remember the choices detection made, so the next run never re-asks.\n if (!setup.fromConfigFile && !flags.dryRun && result.wrote) {\n await saveDataFile(cwd, setup.remember);\n }\n\n printReport(result, flags, setup, wiring, cwd);\n return result;\n}\n\n/* Pull the outDir back out of the resolved config (there is one generator). /\nfunction findOutDir(config: CodegenConfig): string \| undefined {\n return config.generate[0]?.outDir;\n}\n\n/\n The report is the product's voice: plain language, no jargon, one line per\n * file, findings grouped by severity, and a summary that says what happens\n * next — including the one command's worth of \"try it\" at the end.\n /\nfunction printReport(\n result: GenerateResult,\n flags: GenerateFlags,\n setup: Setup,\n wiring: WirePlan \| null,\n cwd: string,\n): void {\n const { tools, skipped, findings, files, notes, blocked } = result;\n\n console.log(`\\nwebmcp-codegen (${setup.label}): ${tools.length} tool(s)`);\n\n for (const note of notes) {\n console.log(`\\n note: ${note}`);\n }\n\n if (skipped.length > 0) {\n console.log(`\\n ${skipped.length} endpoint(s) skipped:`);\n for (const entry of skipped) {\n console.log(` ${entry.ref}: ${entry.reason}`);\n }\n }\n\n console.log(\"\");\n const listed = tools.slice(0, MAX_LISTED_TOOLS);\n for (const tool of listed) {\n const state = tool.enabledByDefault ? \"\" : \" starts disabled\";\n console.log(` ${tool.name} [${tool.sideEffect}]${state} ← ${tool.source.ref}`);\n }\n if (tools.length > listed.length) {\n console.log(` …and ${tools.length - listed.length} more`);\n }\n\n if (findings.length > 0) {\n console.log(\"\");\n for (const finding of findings) {\n const icon = finding.level === \"error\" ? \"✖\" : \"⚠\";\n const where = finding.tool ? ` (${finding.tool})` : \"\";\n console.log(` ${icon} ${finding.message}${where}`);\n }\n }\n\n if (files.length > 0) {\n console.log(\"\");\n for (const file of files) {\n if (file.action === \"unchanged\" && !file.conflict) continue;\n const shown = file.conflict\n ? `conflict → wrote ${relative(cwd, file.conflict)}`\n : file.action;\n console.log(` ${shown}: ${relative(cwd, file.path)}`);\n }\n }\n\n if (wiring) {\n if (wiring.alreadyWired) {\n console.log(\"\\n registration: already wired into your app\");\n } else if (wiring.edits.length > 0) {\n console.log(flags.dryRun ? \"\\n registration (would do):\" : \"\\n registration:\");\n for (const edit of wiring.edits) {\n console.log(` ${edit.summary}`);\n }\n if (!flags.dryRun) {\n console.log(\" undo: delete the added lines (nothing else was touched)\");\n }\n }\n } else if (!blocked && setup.app) {\n console.log(\"\\n registration: could not find your app's entry file, so add this by hand:\");\n console.log(' import { registerAllTools } from \"<path-to>/src/webmcp\";');\n console.log(\" void registerAllTools();\");\n }\n\n if (blocked) {\n console.log(\n \"\\nGeneration blocked by audit errors. Fix them, or re-run with --force to write anyway.\",\n );\n return;\n }\n if (flags.dryRun) {\n console.log(\"\\nDry run: nothing written. Re-run without --dry-run to write these files.\");\n return;\n }\n\n printNextSteps(result);\n}\n\n/\n The parting message. The read tools already work; the mutations are one\n * uncomment away; and we end with the single most convincing thing a new\n * user can do: watch an agent call their app.\n /\nfunction printNextSteps(result: GenerateResult): void {\n const enabled = result.tools.filter((tool) => tool.enabledByDefault);\n const disabled = result.tools.filter((tool) => !tool.enabledByDefault);\n\n const parts: string[] = [];\n if (enabled.length > 0) parts.push(`${enabled.length} read tool(s) work out of the box`);\n if (disabled.length > 0) {\n parts.push(`${disabled.length} tool(s) start disabled (open the file and uncomment to enable)`);\n }\n console.log(`\\nDone. ${parts.join(\"; \")}.`);\n\n const suggestion = pickSuggestedTool(result.tools);\n console.log(\"\\nTry it:\");\n console.log(\" 1. Start your app and open it in Chrome.\");\n console.log(\" 2. Turn on chrome://flags/#enable-webmcp-testing and reload the page.\");\n if (suggestion) {\n console.log(` 3. Ask the agent: \"${suggestion}\"`);\n } else {\n console.log(\" 3. Ask the agent to use one of your tools.\");\n }\n}\n\n/\n The example request in the \"try it\" line. Pick an enabled read tool —\n * preferably one whose name sounds like listing or looking something up —\n * and phrase it the way a user would say it, from the spec's own description.\n /\nfunction pickSuggestedTool(tools: ReviewedTool[]): string \| undefined {\n const reads = tools.filter((tool) => tool.enabledByDefault && tool.endpointRole === \"endpoint\");\n if (reads.length === 0) return undefined;\n const tool =\n reads.find((candidate) => /^(list\|get\|search\|find\|fetch\|recent)-/.test(candidate.name)) ??\n reads[0];\n if (!tool) return undefined;\n\n const description = tool.description.trim().replace(/\\.$/, \"\");\n // A template description (\"GET /v1/trips\") would read as jargon; fall back\n // to the tool name in words (\"list trips\").\n const looksTemplated = /^(GET\|POST\|PUT\|PATCH\|DELETE)\\s/.test(description);\n const phrase = looksTemplated\n ? tool.name.replace(/-/g, \" \")\n : description.charAt(0).toLowerCase() + description.slice(1);\n return phrase;\n}\n\n/\n The tools dashboard: a local control panel for what was generated.\n * Runs until Ctrl+C; nothing is written to the app, ever.\n /\nasync function dev(port: number): Promise<number> {\n const { startDevServer } = await import(\"./dev/server.js\");\n const server = await startDevServer({ cwd: process.cwd(), port });\n console.log(`\\nwebmcp-codegen dashboard: http://localhost:${port}`);\n console.log(\"List, describe, enable, and try your tools. Ctrl+C to stop.\\n\");\n\n await new Promise<void>((resolveExit) => {\n process.on(\"SIGINT\", () => {\n server.close();\n resolveExit();\n });\n });\n return 0;\n}\n\n/\n Re-run generate when anything relevant changes. Node's recursive watcher\n * covers Linux/macOS/Windows on Node 20+, which is our engine floor anyway.\n /\nasync function watchLoop(cwd: string, flags: GenerateFlags): Promise<void> {\n await runOnce(cwd, { ...flags, dryRun: false });\n console.log(\"\\nWatching for changes… (Ctrl+C to stop)\");\n\n let timer: NodeJS.Timeout \| undefined;\n watch(cwd, { recursive: true }, (_event, filename) => {\n if (!filename) return;\n // Only source-ish changes are worth regenerating for. Never react to our\n // own outputs (generated files, the data file) or watch mode loops.\n if (/node_modules\|\\.git\|\\/dist\|\\/src\\/webmcp\|\\.webmcp-codegen\\.json/.test(filename)) return;\n if (!/\\.(ya?ml\|json\|ts\|tsx\|mts\|mjs)$/.test(filename)) return;\n clearTimeout(timer);\n timer = setTimeout(() => {\n runOnce(cwd, { ...flags, dryRun: false }).catch((error: unknown) => {\n console.error(error instanceof Error ? error.message : error);\n });\n }, 300);\n });\n}\n\nmain()\n .then((code) => process.exit(code))\n .catch((error: unknown) => {\n console.error(error instanceof Error ? error.message : error);\n process.exit(1);\n });\n","/\n Registration wiring: making the app actually register its tools.\n \n Generated files do nothing until something calls registerAllTools() once at\n * startup. Rather than telling the developer to go do that, we do it for\n * them — under strict rules, because this is the one place we edit their\n * files instead of ours:\n \n 1. Edits are additive only. We insert lines; we never change or remove\n * existing ones.\n * 2. Idempotent. If the wiring is already there, we do nothing.\n * 3. Honest. Every edit is reported with exact paths and how to undo it.\n * 4. When we cannot find the entry point with confidence, we do not guess:\n * we print the two lines and where they go, and leave it to the human.\n /\n\nimport { readFile, writeFile } from \"node:fs/promises\";\nimport { dirname, join, relative } from \"node:path\";\nimport type { WebApp } from \"./detect-app.js\";\n\nexport interface WireEdit {\n /* Absolute path of the file to create or modify. /\n path: string;\n action: \"create\" \| \"modify\";\n /* The full new contents (for modify: the existing contents plus our lines). /\n contents: string;\n /* One human sentence per edit, for the report. /\n summary: string;\n}\n\nexport interface WirePlan {\n edits: WireEdit[];\n /* Set when we already found the wiring in place. /\n alreadyWired?: boolean;\n}\n\n/\n Compute the wiring edits for the detected app, or null when we cannot\n * locate the entry point with confidence (the CLI then prints manual\n * instructions instead).\n /\nexport async function planWiring(\n cwd: string,\n app: WebApp,\n outDir: string,\n): Promise<WirePlan \| null> {\n switch (app.framework) {\n case \"next\":\n return planNextWiring(cwd, app, outDir);\n case \"vite-react\":\n return planViteWiring(cwd, app, outDir);\n default:\n // Nuxt/SvelteKit/unknown: we know where the tools go but not where the\n // app boots. Print instructions rather than guess-edit an entry file.\n return null;\n }\n}\n\n/* Apply a plan. Kept trivial on purpose: the plan already did the thinking. /\nexport async function applyWiring(plan: WirePlan): Promise<void> {\n for (const edit of plan.edits) {\n await writeFile(edit.path, edit.contents, \"utf8\");\n }\n}\n\n/ ── Next.js (app router) ──────────────────────────────────────────────── /\n\n/\n Next needs the registration to run on the client, so we generate a tiny\n * \"use client\" component next to the tools and mount it in the root layout:\n \n import { WebMCPRegister } from \"../webmcp/register\"; ← added\n * ...\n * <body>\n * <WebMCPRegister /> ← added\n * {children}\n /\nasync function planNextWiring(cwd: string, app: WebApp, outDir: string): Promise<WirePlan \| null> {\n const layoutCandidates = [\n join(cwd, app.dir, \"src/app/layout.tsx\"),\n join(cwd, app.dir, \"src/app/layout.jsx\"),\n join(cwd, app.dir, \"app/layout.tsx\"),\n join(cwd, app.dir, \"app/layout.jsx\"),\n ];\n const layoutPath = await firstExisting(layoutCandidates);\n if (!layoutPath) return null;\n\n const registerPath = join(cwd, outDir, \"register.tsx\");\n const layout = await readFile(layoutPath, \"utf8\");\n if (layout.includes(\"WebMCPRegister\")) return { edits: [], alreadyWired: true };\n\n // Import path from the layout's directory to the register component.\n const importPath = withoutExtension(relative(dirname(layoutPath), registerPath));\n\n const edits: WireEdit[] = [\n {\n path: registerPath,\n action: \"create\",\n contents: nextRegisterComponent(),\n summary: `created ${relative(cwd, registerPath)} (a client component that registers your tools on page load)`,\n },\n ];\n\n const withImport = insertAfterLastImport(\n layout,\n `import { WebMCPRegister } from \"${importPath}\";`,\n );\n if (!withImport) return null;\n // Mount right after <body ...>, each element on its own line.\n const withComponent = withImport.replace(\n /<body([^>])>\\s/,\n \"<body$1>\\n <WebMCPRegister />\\n \",\n );\n if (withComponent === withImport) return null; // No <body> tag found; do not guess.\n\n edits.push({\n path: layoutPath,\n action: \"modify\",\n contents: withComponent,\n summary: `added 2 lines to ${relative(cwd, layoutPath)} (an import and <WebMCPRegister /> inside <body>)`,\n });\n return { edits };\n}\n\nfunction nextRegisterComponent(): string {\n return `\"use client\";\n\nimport { useEffect } from \"react\";\nimport { registerAllTools } from \"./index\";\n\n/\n Registers the generated WebMCP tools once, on page load.\n * Generated by webmcp-codegen. Safe to move; keep it mounted near the root.\n /\nexport function WebMCPRegister() {\n useEffect(() => {\n void registerAllTools();\n }, []);\n return null;\n}\n`;\n}\n\n/ ── Vite + React (SPAs) ───────────────────────────────────────────────── /\n\n/\n A Vite app boots in main.tsx, so wiring is two added lines there:\n \n import { registerAllTools } from \"./webmcp\"; ← added\n * void registerAllTools(); ← added\n /\nasync function planViteWiring(cwd: string, app: WebApp, outDir: string): Promise<WirePlan \| null> {\n const entryCandidates = [\n join(cwd, app.dir, \"src/main.tsx\"),\n join(cwd, app.dir, \"src/main.jsx\"),\n join(cwd, app.dir, \"src/index.tsx\"),\n join(cwd, app.dir, \"src/index.jsx\"),\n ];\n const entryPath = await firstExisting(entryCandidates);\n if (!entryPath) return null;\n\n const entry = await readFile(entryPath, \"utf8\");\n if (entry.includes(\"registerAllTools\")) return { edits: [], alreadyWired: true };\n\n const importPath = withoutExtension(relative(dirname(entryPath), join(cwd, outDir, \"index\")));\n const withWiring = insertAfterLastImport(\n entry,\n `import { registerAllTools } from \"${importPath}\";\\n\\nvoid registerAllTools();`,\n );\n if (!withWiring) return null;\n\n return {\n edits: [\n {\n path: entryPath,\n action: \"modify\",\n contents: withWiring,\n summary: `added 2 lines to ${relative(cwd, entryPath)} (an import and a registerAllTools() call)`,\n },\n ],\n };\n}\n\n/ ── Shared helpers ────────────────────────────────────────────────────── /\n\n/* Insert a line after the file's last top-level import statement. /\nfunction insertAfterLastImport(source: string, line: string): string \| null {\n const lines = source.split(\"\\n\");\n let lastImport = -1;\n for (let index = 0; index < lines.length; index += 1) {\n if (/^import\\s/.test(lines[index] as string)) lastImport = index;\n }\n if (lastImport === -1) return null;\n lines.splice(lastImport + 1, 0, line);\n return lines.join(\"\\n\");\n}\n\n/\n Turn a filesystem path into a JS import specifier: no extension, and an\n * explicit \"./\" when the target is in the same directory or deeper —\n * `relative()` alone yields \"webmcp/index\", which JS would read as a\n * package name, not a file.\n */\nfunction withoutExtension(path: string): string {\n const bare = path.replace(/\\.(tsx?\|jsx?)$/, \"\").replace(/\\/index$/, \"\");\n return bare.startsWith(\".\") ? bare : `./${bare}`;\n}\n\nasync function firstExisting(paths: string[]): Promise<string \| undefined> {\n for (const path of paths) {\n try {\n await readFile(path, \"utf8\");\n return path;\n } catch {\n // Try the next candidate.\n }\n }\n return undefined;\n}\n"],"mappings":"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","names":["writeFile","join","relative","join","writeFile","relative","tool"]}

package/dist/generators/index.d.ts CHANGED Viewed

@@ -1,4 +1,4 @@
-import { T as ToolGenerator } from '../types-DRCQtX0w.js';
+import { T as ToolGenerator } from '../types-DWUum51l.js';
 /**
  * The `js` generator, named after what lands in your repo: plain JavaScript/

package/dist/generators/index.js CHANGED Viewed

@@ -1,6 +1,6 @@
 import {
   js
-} from "../chunk-OILNQ2HE.js";
+} from "../chunk-TGOJ3HUE.js";
 import "../chunk-KSQMJERY.js";
 export {
   js

package/dist/index.d.ts CHANGED Viewed

@@ -1,5 +1,5 @@
-import { C as CodegenConfig, R as ReviewedTool, A as AuditFinding, G as GeneratedFile } from './types-DRCQtX0w.js';
-export { a as CandidateTool, J as JsonSchema, b as RiskTier, c as SafetyOptions, d as SideEffect, S as Source, e as SourceKind, T as ToolGenerator, f as ToolHints } from './types-DRCQtX0w.js';
+import { C as CodegenConfig, a as ToolOverrides, R as ReviewedTool, b as SkippedEndpoint, A as AuditFinding, G as GeneratedFile } from './types-DWUum51l.js';
+export { c as CandidateTool, J as JsonSchema, d as RiskTier, e as SafetyOptions, f as SideEffect, S as Source, g as SourceKind, T as ToolGenerator, h as ToolHints } from './types-DWUum51l.js';
 /**
  * Config: `defineConfig` for authoring, `loadConfig` for the CLI.
@@ -34,11 +34,21 @@ interface GenerateOptions {
     skipAudit?: boolean;
     /** Write even when the audit found errors. The report still shows them. */
     force?: boolean;
+    /**
+     * Hand-authored tweaks from .webmcp-codegen.json (usually written by the
+     * dev dashboard). Applied after the safety review so they survive
+     * regeneration.
+     */
+    overrides?: ToolOverrides;
 }
 interface GenerateResult {
     tools: ReviewedTool[];
+    /** Endpoints deliberately not generated (webhooks, config exclusions). */
+    skipped: SkippedEndpoint[];
     findings: AuditFinding[];
     files: GeneratedFile[];
+    /** Human-facing pipeline notes, e.g. "stripped the shared v1 prefix". */
+    notes: string[];
     /** True when audit errors stopped any file from being written. */
     blocked: boolean;
     /** True when this run actually wrote files (false for dry runs and blocks). */

package/dist/index.js CHANGED Viewed

@@ -1,8 +1,8 @@
 import {
   defineConfig,
   runGenerate
-} from "./chunk-LYHLGSAI.js";
-import "./chunk-BIKKPCRT.js";
+} from "./chunk-MJQ5B6HB.js";
+import "./chunk-FWSATV7C.js";
 import "./chunk-KSQMJERY.js";
 export {
   defineConfig,