mcp-use 2.0.0-beta.2 → 2.0.0-beta.4

package/dist/bin/args.d.ts

@@ -22,6 +22,8 @@ export interface ParsedArgs {
     tunnel: boolean;
     /** `false` when `--no-open` was passed (dev only); `true` otherwise. */
     open: boolean;
+    /** Whether `--with-inspector` was passed (build only). */
+    withInspector: boolean;
     /** Whether `--help`/`-h` was passed. */
     help: boolean;
     /** Whether `--version`/`-v` was passed. */

package/dist/bin/args.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"args.d.ts","sourceRoot":"","sources":["../../src/bin/args.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH;;;;GAIG;AACH,MAAM,WAAW,UAAU;IACzB,qFAAqF;IACrF,OAAO,EAAE,MAAM,GAAG,SAAS,CAAC;IAC5B,yEAAyE;IACzE,IAAI,EAAE,MAAM,GAAG,SAAS,CAAC;IACzB,qEAAqE;IACrE,KAAK,EAAE,MAAM,GAAG,SAAS,CAAC;IAC1B,oEAAoE;IACpE,IAAI,EAAE,MAAM,GAAG,SAAS,CAAC;IACzB,gDAAgD;IAChD,MAAM,EAAE,OAAO,CAAC;IAChB,wEAAwE;IACxE,IAAI,EAAE,OAAO,CAAC;IACd,wCAAwC;IACxC,IAAI,EAAE,OAAO,CAAC;IACd,2CAA2C;IAC3C,OAAO,EAAE,OAAO,CAAC;CAClB;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,SAAS,CAAC,IAAI,EAAE,SAAS,MAAM,EAAE,GAAG,UAAU,CA0E7D;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,WAAW,CACzB,QAAQ,EAAE,MAAM,GAAG,SAAS,EAC5B,GAAG,GAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC,CAAe,GAC9D,MAAM,CAQR"}
+{"version":3,"file":"args.d.ts","sourceRoot":"","sources":["../../src/bin/args.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH;;;;GAIG;AACH,MAAM,WAAW,UAAU;IACzB,qFAAqF;IACrF,OAAO,EAAE,MAAM,GAAG,SAAS,CAAC;IAC5B,yEAAyE;IACzE,IAAI,EAAE,MAAM,GAAG,SAAS,CAAC;IACzB,qEAAqE;IACrE,KAAK,EAAE,MAAM,GAAG,SAAS,CAAC;IAC1B,oEAAoE;IACpE,IAAI,EAAE,MAAM,GAAG,SAAS,CAAC;IACzB,gDAAgD;IAChD,MAAM,EAAE,OAAO,CAAC;IAChB,wEAAwE;IACxE,IAAI,EAAE,OAAO,CAAC;IACd,0DAA0D;IAC1D,aAAa,EAAE,OAAO,CAAC;IACvB,wCAAwC;IACxC,IAAI,EAAE,OAAO,CAAC;IACd,2CAA2C;IAC3C,OAAO,EAAE,OAAO,CAAC;CAClB;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,SAAS,CAAC,IAAI,EAAE,SAAS,MAAM,EAAE,GAAG,UAAU,CA8E7D;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,WAAW,CACzB,QAAQ,EAAE,MAAM,GAAG,SAAS,EAC5B,GAAG,GAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC,CAAe,GAC9D,MAAM,CAQR"}

package/dist/bin/main.d.ts

@@ -16,6 +16,8 @@ export interface CliCommandOptions {
     tunnel?: boolean;
     /** Auto-open the inspector in a browser at dev startup (`--no-open` disables). */
     open?: boolean;
+    /** Record inspector availability in the build manifest (`--with-inspector`). */
+    withInspector?: boolean;
 }
 /**
  * Run the `mcp-use` CLI.

package/dist/bin/main.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"main.d.ts","sourceRoot":"","sources":["../../src/bin/main.ts"],"names":[],"mappings":"AAWA;;;;GAIG;AACH,MAAM,WAAW,iBAAiB;IAChC,8DAA8D;IAC9D,GAAG,EAAE,MAAM,CAAC;IACZ,gDAAgD;IAChD,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,qCAAqC;IACrC,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,gCAAgC;IAChC,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,yDAAyD;IACzD,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,kFAAkF;IAClF,IAAI,CAAC,EAAE,OAAO,CAAC;CAChB;AA8BD;;;;;;;;GAQG;AACH,wBAAsB,IAAI,CAAC,IAAI,EAAE,SAAS,MAAM,EAAE,GAAG,OAAO,CAAC,MAAM,CAAC,CA0EnE"}
+{"version":3,"file":"main.d.ts","sourceRoot":"","sources":["../../src/bin/main.ts"],"names":[],"mappings":"AAWA;;;;GAIG;AACH,MAAM,WAAW,iBAAiB;IAChC,8DAA8D;IAC9D,GAAG,EAAE,MAAM,CAAC;IACZ,gDAAgD;IAChD,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,qCAAqC;IACrC,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,gCAAgC;IAChC,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,yDAAyD;IACzD,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,kFAAkF;IAClF,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,gFAAgF;IAChF,aAAa,CAAC,EAAE,OAAO,CAAC;CACzB;AA+BD;;;;;;;;GAQG;AACH,wBAAsB,IAAI,CAAC,IAAI,EAAE,SAAS,MAAM,EAAE,GAAG,OAAO,CAAC,MAAM,CAAC,CA0EnE"}

package/dist/bin.js

@@ -1,7 +1,7 @@
 #!/usr/bin/env node
 import {
   parseArgs
-} from "./chunk-Q4PUTBMV.js";
+} from "./chunk-IG2BCCMU.js";
 
 // src/bin/main.ts
 import { readFileSync } from "fs";
@@ -28,6 +28,7 @@ Options:
   -p, --port <n>     Port to serve on (default: $PORT or 3000)
   --host <host>      Host to bind (dev only)
   --entry <path>     Server entry module (dev/build only)
+  --with-inspector   Record inspector availability in the build manifest (build only)
   --tunnel           Expose the dev server through a public tunnel (dev only)
   --no-open          Do not auto-open the inspector in a browser (dev only)
   -h, --help         Show this help
@@ -135,7 +136,8 @@ async function cliCommand(command, args) {
     ...args.port !== void 0 && { port: args.port },
     ...args.host !== void 0 && { host: args.host },
     ...args.tunnel && { tunnel: true },
-    ...!args.open && { open: false }
+    ...!args.open && { open: false },
+    ...args.withInspector && { withInspector: true }
   };
   try {
     if (command === "dev") {

package/dist/bin.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/bin/main.ts","../src/bin.ts"],"sourcesContent":["/**\n * Command dispatch for the `mcp-use` bin (specs/CLI_SPEC.md).\n *\n * Every substantial command is dispatched through its own dynamic import.\n * The library entry, bin, and production `start` path therefore never\n * evaluate Vite or an unrelated command implementation.\n */\nimport { readFileSync } from \"node:fs\";\n\nimport { parseArgs, type ParsedArgs } from \"./args.js\";\n\n/**\n * Options this bin passes to the cli's `runDev`/`runBuild`.\n *\n * @internal\n */\nexport interface CliCommandOptions {\n  /** Project root the command operates on (`process.cwd()`). */\n  cwd: string;\n  /** Server entry module override (`--entry`). */\n  entry?: string;\n  /** Port override (`--port`/`-p`). */\n  port?: number;\n  /** Host override (`--host`). */\n  host?: string;\n  /** Start a public tunnel at dev startup (`--tunnel`). */\n  tunnel?: boolean;\n  /** Auto-open the inspector in a browser at dev startup (`--no-open` disables). */\n  open?: boolean;\n}\n\nconst HELP = `mcp-use — run MCP servers built with mcp-use\n\nUsage: mcp-use <command> [options]\n\nCommands:\n  dev      Start the dev server\n  build    Build the server into .mcp-use/build\n  start    Serve the production build from .mcp-use/build\n  login    Authenticate the cloud CLI\n  logout   Delete local cloud credentials\n  whoami   Show the authenticated cloud identity\n  org      Manage the active organization\n  servers  Manage cloud servers and environment variables\n  deployments Manage cloud deployments and logs\n  deploy   Deploy the current GitHub project\n  client   Connect to and invoke MCP servers\n  skills   Install maintained coding-agent skills\n  screenshot Capture an MCP Apps view\n\nOptions:\n  -p, --port <n>     Port to serve on (default: $PORT or 3000)\n  --host <host>      Host to bind (dev only)\n  --entry <path>     Server entry module (dev/build only)\n  --tunnel           Expose the dev server through a public tunnel (dev only)\n  --no-open          Do not auto-open the inspector in a browser (dev only)\n  -h, --help         Show this help\n  -v, --version      Print the version`;\n\n/**\n * Run the `mcp-use` CLI.\n *\n * @param argv - Raw arguments, typically `process.argv.slice(2)`.\n * @returns The process exit code. A `0` from `start`/`dev` means the command\n * launched successfully and the process should stay alive serving.\n *\n * @internal\n */\nexport async function main(argv: readonly string[]): Promise<number> {\n  if (argv.length === 1 && [\"--version\", \"-v\"].includes(argv[0] ?? \"\")) {\n    console.log(readOwnVersion());\n    return 0;\n  }\n  if (argv.some((token) => token === \"--help\" || token === \"-h\")) {\n    console.log(HELP);\n    return 0;\n  }\n\n  const command = argv[0];\n  if (command === \"login\" || command === \"logout\" || command === \"whoami\") {\n    const { runIdentity } = await import(\"../commands/identity.js\");\n    return runIdentity(command, argv.slice(1));\n  }\n  if (command === \"org\") {\n    const { runOrganizations } = await import(\"../commands/organizations.js\");\n    return runOrganizations(argv.slice(1));\n  }\n  if (command === \"servers\") {\n    const { runServers } = await import(\"../commands/servers.js\");\n    return runServers(argv.slice(1));\n  }\n  if (command === \"deployments\") {\n    const { runDeployments } = await import(\"../commands/deployments.js\");\n    return runDeployments(argv.slice(1));\n  }\n  if (command === \"deploy\") {\n    const { runDeploy } = await import(\"../commands/deploy.js\");\n    return runDeploy(argv.slice(1));\n  }\n  if (command === \"client\") {\n    const { runClient } = await import(\"../commands/client.js\");\n    return runClient(argv.slice(1));\n  }\n  if (command === \"skills\") {\n    const { runSkills } = await import(\"../commands/skills.js\");\n    return runSkills(argv.slice(1));\n  }\n  if (command === \"screenshot\") {\n    const { runScreenshot } = await import(\"../commands/screenshot.js\");\n    return runScreenshot(argv.slice(1));\n  }\n\n  let args: ParsedArgs;\n  try {\n    args = parseArgs(argv);\n  } catch (error) {\n    console.error(error instanceof Error ? error.message : String(error));\n    return 2;\n  }\n\n  if (args.version) {\n    console.log(readOwnVersion());\n    return 0;\n  }\n  if (args.help) {\n    console.log(HELP);\n    return 0;\n  }\n\n  switch (args.command) {\n    case \"start\":\n      return startCommand(args);\n    case \"dev\":\n    case \"build\":\n      return cliCommand(args.command, args);\n    case undefined:\n      console.error(HELP);\n      return 2;\n    default:\n      console.error(`Unknown command: ${args.command}\\n\\n${HELP}`);\n      return 2;\n  }\n}\n\n/** `mcp-use start`: serve the production build, wire shutdown signals. */\nasync function startCommand(args: ParsedArgs): Promise<number> {\n  let started;\n  try {\n    const { runStart } = await import(\"../commands/start.js\");\n    started = await runStart({ cwd: process.cwd(), port: args.port });\n  } catch (error) {\n    console.error(error instanceof Error ? error.message : String(error));\n    return 1;\n  }\n\n  console.log(`mcp-use server running at ${started.url}`);\n\n  const shutdown = (): void => {\n    started.close().then(\n      () => process.exit(0),\n      (error: unknown) => {\n        console.error(error instanceof Error ? error.message : String(error));\n        process.exit(1);\n      }\n    );\n  };\n  process.once(\"SIGINT\", shutdown);\n  process.once(\"SIGTERM\", shutdown);\n  return 0;\n}\n\n/** `mcp-use dev` / `mcp-use build`: dispatch to dedicated command chunks. */\nasync function cliCommand(\n  command: \"dev\" | \"build\",\n  args: ParsedArgs\n): Promise<number> {\n  const options: CliCommandOptions = {\n    cwd: process.cwd(),\n    ...(args.entry !== undefined && { entry: args.entry }),\n    ...(args.port !== undefined && { port: args.port }),\n    ...(args.host !== undefined && { host: args.host }),\n    ...(args.tunnel && { tunnel: true }),\n    ...(!args.open && { open: false }),\n  };\n\n  try {\n    if (command === \"dev\") {\n      const { runDev } = await import(\"../commands/dev.js\");\n      await runDev(options);\n    } else {\n      const { runBuild } = await import(\"../commands/build.js\");\n      await runBuild(options);\n    }\n    return 0;\n  } catch (error) {\n    console.error(error instanceof Error ? error.message : String(error));\n    return 1;\n  }\n}\n\n/**\n * Read this package's own version for `--version`.\n *\n * Probes both layouts — `dist/bin.js` (bundled, package root is one level\n * up) and `src/bin/main.ts` (tests, package root is two levels up) — and\n * verifies the manifest's `name` so an unrelated package.json never wins.\n */\nfunction readOwnVersion(): string {\n  for (const relative of [\"../package.json\", \"../../package.json\"]) {\n    try {\n      const raw = readFileSync(new URL(relative, import.meta.url), \"utf8\");\n      const pkg = JSON.parse(raw) as { name?: unknown; version?: unknown };\n      if (\n        (pkg.name === \"mcp-use\" || pkg.name === \"mcp-use\") &&\n        typeof pkg.version === \"string\"\n      ) {\n        return pkg.version;\n      }\n    } catch {\n      // Not there or unreadable — try the next candidate.\n    }\n  }\n  return \"unknown\";\n}\n","#!/usr/bin/env node\n/*\n * `mcp-use` bin entry point (specs/CLI_SPEC.md).\n *\n * Kept to a single call so all logic lives in testable modules under\n * src/bin/. On success the process is NOT exited: `start` (and `dev`) keep\n * serving, and `--help`/`--version` let the event loop drain naturally.\n */\nimport { main } from \"./bin/main.js\";\n\nmain(process.argv.slice(2)).then(\n  (code) => {\n    process.exitCode = code;\n  },\n  (error: unknown) => {\n    console.error(error instanceof Error ? error.message : String(error));\n    process.exitCode = 1;\n  }\n);\n"],"mappings":"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","names":[]}
+{"version":3,"sources":["../src/bin/main.ts","../src/bin.ts"],"sourcesContent":["/**\n * Command dispatch for the `mcp-use` bin (specs/CLI_SPEC.md).\n *\n * Every substantial command is dispatched through its own dynamic import.\n * The library entry, bin, and production `start` path therefore never\n * evaluate Vite or an unrelated command implementation.\n */\nimport { readFileSync } from \"node:fs\";\n\nimport { parseArgs, type ParsedArgs } from \"./args.js\";\n\n/**\n * Options this bin passes to the cli's `runDev`/`runBuild`.\n *\n * @internal\n */\nexport interface CliCommandOptions {\n  /** Project root the command operates on (`process.cwd()`). */\n  cwd: string;\n  /** Server entry module override (`--entry`). */\n  entry?: string;\n  /** Port override (`--port`/`-p`). */\n  port?: number;\n  /** Host override (`--host`). */\n  host?: string;\n  /** Start a public tunnel at dev startup (`--tunnel`). */\n  tunnel?: boolean;\n  /** Auto-open the inspector in a browser at dev startup (`--no-open` disables). */\n  open?: boolean;\n  /** Record inspector availability in the build manifest (`--with-inspector`). */\n  withInspector?: boolean;\n}\n\nconst HELP = `mcp-use — run MCP servers built with mcp-use\n\nUsage: mcp-use <command> [options]\n\nCommands:\n  dev      Start the dev server\n  build    Build the server into .mcp-use/build\n  start    Serve the production build from .mcp-use/build\n  login    Authenticate the cloud CLI\n  logout   Delete local cloud credentials\n  whoami   Show the authenticated cloud identity\n  org      Manage the active organization\n  servers  Manage cloud servers and environment variables\n  deployments Manage cloud deployments and logs\n  deploy   Deploy the current GitHub project\n  client   Connect to and invoke MCP servers\n  skills   Install maintained coding-agent skills\n  screenshot Capture an MCP Apps view\n\nOptions:\n  -p, --port <n>     Port to serve on (default: $PORT or 3000)\n  --host <host>      Host to bind (dev only)\n  --entry <path>     Server entry module (dev/build only)\n  --with-inspector   Record inspector availability in the build manifest (build only)\n  --tunnel           Expose the dev server through a public tunnel (dev only)\n  --no-open          Do not auto-open the inspector in a browser (dev only)\n  -h, --help         Show this help\n  -v, --version      Print the version`;\n\n/**\n * Run the `mcp-use` CLI.\n *\n * @param argv - Raw arguments, typically `process.argv.slice(2)`.\n * @returns The process exit code. A `0` from `start`/`dev` means the command\n * launched successfully and the process should stay alive serving.\n *\n * @internal\n */\nexport async function main(argv: readonly string[]): Promise<number> {\n  if (argv.length === 1 && [\"--version\", \"-v\"].includes(argv[0] ?? \"\")) {\n    console.log(readOwnVersion());\n    return 0;\n  }\n  if (argv.some((token) => token === \"--help\" || token === \"-h\")) {\n    console.log(HELP);\n    return 0;\n  }\n\n  const command = argv[0];\n  if (command === \"login\" || command === \"logout\" || command === \"whoami\") {\n    const { runIdentity } = await import(\"../commands/identity.js\");\n    return runIdentity(command, argv.slice(1));\n  }\n  if (command === \"org\") {\n    const { runOrganizations } = await import(\"../commands/organizations.js\");\n    return runOrganizations(argv.slice(1));\n  }\n  if (command === \"servers\") {\n    const { runServers } = await import(\"../commands/servers.js\");\n    return runServers(argv.slice(1));\n  }\n  if (command === \"deployments\") {\n    const { runDeployments } = await import(\"../commands/deployments.js\");\n    return runDeployments(argv.slice(1));\n  }\n  if (command === \"deploy\") {\n    const { runDeploy } = await import(\"../commands/deploy.js\");\n    return runDeploy(argv.slice(1));\n  }\n  if (command === \"client\") {\n    const { runClient } = await import(\"../commands/client.js\");\n    return runClient(argv.slice(1));\n  }\n  if (command === \"skills\") {\n    const { runSkills } = await import(\"../commands/skills.js\");\n    return runSkills(argv.slice(1));\n  }\n  if (command === \"screenshot\") {\n    const { runScreenshot } = await import(\"../commands/screenshot.js\");\n    return runScreenshot(argv.slice(1));\n  }\n\n  let args: ParsedArgs;\n  try {\n    args = parseArgs(argv);\n  } catch (error) {\n    console.error(error instanceof Error ? error.message : String(error));\n    return 2;\n  }\n\n  if (args.version) {\n    console.log(readOwnVersion());\n    return 0;\n  }\n  if (args.help) {\n    console.log(HELP);\n    return 0;\n  }\n\n  switch (args.command) {\n    case \"start\":\n      return startCommand(args);\n    case \"dev\":\n    case \"build\":\n      return cliCommand(args.command, args);\n    case undefined:\n      console.error(HELP);\n      return 2;\n    default:\n      console.error(`Unknown command: ${args.command}\\n\\n${HELP}`);\n      return 2;\n  }\n}\n\n/** `mcp-use start`: serve the production build, wire shutdown signals. */\nasync function startCommand(args: ParsedArgs): Promise<number> {\n  let started;\n  try {\n    const { runStart } = await import(\"../commands/start.js\");\n    started = await runStart({ cwd: process.cwd(), port: args.port });\n  } catch (error) {\n    console.error(error instanceof Error ? error.message : String(error));\n    return 1;\n  }\n\n  console.log(`mcp-use server running at ${started.url}`);\n\n  const shutdown = (): void => {\n    started.close().then(\n      () => process.exit(0),\n      (error: unknown) => {\n        console.error(error instanceof Error ? error.message : String(error));\n        process.exit(1);\n      }\n    );\n  };\n  process.once(\"SIGINT\", shutdown);\n  process.once(\"SIGTERM\", shutdown);\n  return 0;\n}\n\n/** `mcp-use dev` / `mcp-use build`: dispatch to dedicated command chunks. */\nasync function cliCommand(\n  command: \"dev\" | \"build\",\n  args: ParsedArgs\n): Promise<number> {\n  const options: CliCommandOptions = {\n    cwd: process.cwd(),\n    ...(args.entry !== undefined && { entry: args.entry }),\n    ...(args.port !== undefined && { port: args.port }),\n    ...(args.host !== undefined && { host: args.host }),\n    ...(args.tunnel && { tunnel: true }),\n    ...(!args.open && { open: false }),\n    ...(args.withInspector && { withInspector: true }),\n  };\n\n  try {\n    if (command === \"dev\") {\n      const { runDev } = await import(\"../commands/dev.js\");\n      await runDev(options);\n    } else {\n      const { runBuild } = await import(\"../commands/build.js\");\n      await runBuild(options);\n    }\n    return 0;\n  } catch (error) {\n    console.error(error instanceof Error ? error.message : String(error));\n    return 1;\n  }\n}\n\n/**\n * Read this package's own version for `--version`.\n *\n * Probes both layouts — `dist/bin.js` (bundled, package root is one level\n * up) and `src/bin/main.ts` (tests, package root is two levels up) — and\n * verifies the manifest's `name` so an unrelated package.json never wins.\n */\nfunction readOwnVersion(): string {\n  for (const relative of [\"../package.json\", \"../../package.json\"]) {\n    try {\n      const raw = readFileSync(new URL(relative, import.meta.url), \"utf8\");\n      const pkg = JSON.parse(raw) as { name?: unknown; version?: unknown };\n      if (\n        (pkg.name === \"mcp-use\" || pkg.name === \"mcp-use\") &&\n        typeof pkg.version === \"string\"\n      ) {\n        return pkg.version;\n      }\n    } catch {\n      // Not there or unreadable — try the next candidate.\n    }\n  }\n  return \"unknown\";\n}\n","#!/usr/bin/env node\n/*\n * `mcp-use` bin entry point (specs/CLI_SPEC.md).\n *\n * Kept to a single call so all logic lives in testable modules under\n * src/bin/. On success the process is NOT exited: `start` (and `dev`) keep\n * serving, and `--help`/`--version` let the event loop drain naturally.\n */\nimport { main } from \"./bin/main.js\";\n\nmain(process.argv.slice(2)).then(\n  (code) => {\n    process.exitCode = code;\n  },\n  (error: unknown) => {\n    console.error(error instanceof Error ? error.message : String(error));\n    process.exitCode = 1;\n  }\n);\n"],"mappings":"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","names":[]}

package/dist/{chunk-UDLRVMML.js → chunk-AQ2ZZM2P.js}

@@ -190,4 +190,4 @@ export {
   createBindingValidationServer,
   mcpUseViewsPlugin
 };
-//# sourceMappingURL=chunk-UDLRVMML.js.map
+//# sourceMappingURL=chunk-AQ2ZZM2P.js.map

package/dist/chunk-AQ2ZZM2P.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/cli/entry.ts","../src/cli/vite-config.ts","../src/cli/workspace.ts","../src/cli/views.ts","../src/cli/views-plugin.ts"],"sourcesContent":["/**\n * Server-entry discovery for `mcp-use build` and `mcp-use dev`.\n *\n * The entry contract (CLI_SPEC.md): the user's entry module default-exports\n * the `MCPServer` instance and never calls `listen()` itself — the CLI owns\n * the socket.\n */\n\nimport { existsSync } from \"node:fs\";\nimport { isAbsolute, join, resolve } from \"node:path\";\n\n/**\n * Conventional entry locations, checked in order relative to the project\n * root; the first existing file wins.\n *\n * @internal\n */\nexport const ENTRY_CANDIDATES = [\n  \"src/index.ts\",\n  \"src/server.ts\",\n  \"index.ts\",\n  \"server.ts\",\n] as const;\n\n/**\n * Locate the server entry for a project.\n *\n * With `override` set (the `--entry` flag), the path is resolved against\n * `cwd` and must exist. Otherwise the {@link ENTRY_CANDIDATES} are probed in\n * order and the first hit wins.\n *\n * @param cwd - Absolute path to the project root.\n * @param override - Explicit entry path (`--entry`), absolute or relative to `cwd`.\n * @returns Absolute path to the entry file.\n * @throws If the override does not exist, or no conventional candidate is\n * found — the error lists every location that was checked.\n *\n * @internal\n */\nexport function discoverEntry(cwd: string, override?: string): string {\n  if (override !== undefined) {\n    const entry = isAbsolute(override) ? override : resolve(cwd, override);\n    if (!existsSync(entry)) {\n      throw new Error(`Entry not found: ${entry} (from --entry \"${override}\")`);\n    }\n    return entry;\n  }\n  for (const candidate of ENTRY_CANDIDATES) {\n    const entry = join(cwd, candidate);\n    if (existsSync(entry)) {\n      return entry;\n    }\n  }\n  throw new Error(\n    `No server entry found in ${cwd}. Looked for: ` +\n      `${ENTRY_CANDIDATES.join(\", \")}. ` +\n      `Create one of these (default-exporting your MCPServer instance) ` +\n      `or pass --entry <path>.`\n  );\n}\n","/**\n * Resolve the project-level Vite config used only by the views client build.\n */\n\nimport { existsSync } from \"node:fs\";\nimport { join } from \"node:path\";\nimport { fileURLToPath } from \"node:url\";\n\nconst VITE_CONFIG_CANDIDATES = [\n  \"vite.config.ts\",\n  \"vite.config.js\",\n  \"vite.config.mts\",\n  \"vite.config.cjs\",\n] as const;\n\n/**\n * Locate a project Vite config, or disable config loading when absent.\n *\n * @param cwd - Absolute project root.\n * @returns Absolute config path or `false`.\n *\n * @internal\n */\nexport function resolveUserViteConfig(cwd: string): string | false {\n  for (const name of VITE_CONFIG_CANDIDATES) {\n    const path = join(cwd, name);\n    if (existsSync(path)) return path;\n  }\n  return false;\n}\n\n/**\n * Resolve the framework-owned Tailwind stylesheet for project CSS imports.\n *\n * @returns Absolute path exported by the installed `tailwindcss` dependency.\n *\n * @internal\n */\nexport function resolveTailwindCss(): string {\n  return fileURLToPath(import.meta.resolve(\"tailwindcss/index.css\"));\n}\n","/**\n * The per-project `.mcp-use/` workspace convention — the Next.js `.next`\n * analog. Everything tooling writes for a project lives under this single,\n * gitignored directory so a checkout stays clean and `rm -rf .mcp-use` is\n * always safe.\n *\n * The layout is a fixed convention, not configuration: there is deliberately\n * no config file and no `outDir` knob (runtime/project configuration lives on\n * the `MCPServer` constructor).\n *\n * This module is PURE: it only derives path strings (no filesystem access).\n *\n * Layout (relative to the project root):\n *\n * ```text\n * .mcp-use/\n * ├─ build/        ← compiled server + manifest.json (this package)\n * ├─ generated/    ← output of the typegen escape-hatch command — reserved (VIEWS_SPEC.md)\n * ├─ cache/        ← disposable dev/build scratch\n * ├─ state/        ← mutable runtime state (e.g. tunnel.json)\n * └─ cloud/        ← cloud linkage (link.json)\n * ```\n *\n * `build/` must contain NO mutable runtime state (that is `state/`'s job) so\n * build output stays reproducible and disposable. This is the per-project\n * workspace, distinct from the global `~/.mcp-use/` store (CLI auth,\n * credentials, per-user caches).\n */\n\nimport { join } from \"node:path\";\n\n/**\n * Fixed name of the per-project workspace directory.\n *\n * @internal\n */\nexport const WORKSPACE_DIR_NAME = \".mcp-use\";\n\n/**\n * Basename of the build manifest written inside the build output directory.\n *\n * @internal\n */\nexport const BUILD_MANIFEST_NAME = \"manifest.json\";\n\n/**\n * Manifest written to `.mcp-use/build/manifest.json` by {@link runBuild} and\n * read back by `mcp-use start`.\n *\n * @internal\n */\nexport interface BuildManifest {\n  /** Unique identifier for this build (random hex, regenerated per build). */\n  buildId: string;\n  /**\n   * Filename of the emitted server entry, relative to the build directory\n   * (e.g. `\"index.js\"`). `mcp-use start` imports `<build>/<entryPoint>` and\n   * serves its default export.\n   */\n  entryPoint: string;\n  /** ISO-8601 timestamp of when the build finished. */\n  createdAt: string;\n  /**\n   * Whether the build was created with `mcp-use build --with-inspector`.\n   * Consumed by `mcp-use start` to decide whether to mount the inspector shell.\n   */\n  inspector: boolean;\n}\n\n/**\n * Every resolved path for a project's `.mcp-use/` workspace.\n *\n * @internal\n */\nexport interface WorkspacePaths {\n  /** The project root (the directory containing `.mcp-use/`). */\n  projectRoot: string;\n  /** The `.mcp-use/` workspace directory. */\n  workspace: string;\n  /** Build output directory: `.mcp-use/build`. */\n  build: string;\n  /**\n   * Generated `.d.ts` artifacts directory — reserved for the typegen\n   * escape-hatch command (VIEWS_SPEC.md § Typegen, demoted).\n   */\n  generated: string;\n  /** Disposable dev/build scratch directory. */\n  cache: string;\n  /** Mutable runtime state directory. */\n  state: string;\n  /** Cloud linkage directory — reserved. */\n  cloud: string;\n  /** Build manifest: `<build>/manifest.json`. */\n  buildManifest: string;\n  /** Tunnel subdomain persistence: `<state>/tunnel.json`. */\n  tunnel: string;\n}\n\n/**\n * Derive every workspace path for a project from its root. Pure — no\n * filesystem access.\n *\n * @param projectRoot - Absolute path to the project root.\n *\n * @example\n * ```ts\n * const paths = resolveWorkspacePaths(process.cwd());\n * console.log(paths.build); // <cwd>/.mcp-use/build\n * ```\n *\n * @internal\n */\nexport function resolveWorkspacePaths(projectRoot: string): WorkspacePaths {\n  const workspace = join(projectRoot, WORKSPACE_DIR_NAME);\n  const build = join(workspace, \"build\");\n  return {\n    projectRoot,\n    workspace,\n    build,\n    generated: join(workspace, \"generated\"),\n    cache: join(workspace, \"cache\"),\n    state: join(workspace, \"state\"),\n    cloud: join(workspace, \"cloud\"),\n    buildManifest: join(build, BUILD_MANIFEST_NAME),\n    tunnel: join(workspace, \"state\", \"tunnel.json\"),\n  };\n}\n","/**\n * View discovery for `mcp-use build` / `mcp-use dev`.\n *\n * Views live under `resources/<name>/view.tsx` (VIEWS_SPEC.md § File-based views).\n */\n\nimport { existsSync, readdirSync } from \"node:fs\";\nimport { join } from \"node:path\";\nimport type { ViteDevServer } from \"vite\";\n\nimport type { ViewsManifest } from \"../views/types.js\";\n\n/** Prefix for per-view virtual entry modules (`virtual:mcp-use/views/<name>`). */\nexport const VIRTUAL_VIEW_PREFIX = \"virtual:mcp-use/views/\";\n\n/** Resolved virtual id prefix (Rollup null-prefixed module id). */\nexport const VIRTUAL_VIEW_RESOLVED_PREFIX = `\\0${VIRTUAL_VIEW_PREFIX}`;\n\n/**\n * One discovered view directory.\n *\n * @internal\n */\nexport interface DiscoveredView {\n  /** View directory name (the `resources/<name>` segment). */\n  name: string;\n  /** Absolute path to `resources/<name>/view.tsx`. */\n  entryPath: string;\n}\n\n/**\n * Scan `resources/<name>/view.tsx` under the project root.\n *\n * A missing or empty `resources/` directory yields an empty list — tool-only\n * projects keep byte-identical CLI behavior.\n *\n * @param cwd - Absolute project root.\n * @returns Discovered views sorted by name.\n *\n * @internal\n */\nexport function discoverViews(cwd: string): DiscoveredView[] {\n  const resourcesDir = join(cwd, \"resources\");\n  if (!existsSync(resourcesDir)) {\n    return [];\n  }\n\n  const views: DiscoveredView[] = [];\n  for (const entry of readdirSync(resourcesDir, { withFileTypes: true })) {\n    if (!entry.isDirectory()) {\n      continue;\n    }\n    const entryPath = join(resourcesDir, entry.name, \"view.tsx\");\n    if (existsSync(entryPath)) {\n      views.push({ name: entry.name, entryPath });\n    }\n  }\n  views.sort((a, b) => a.name.localeCompare(b.name));\n  return views;\n}\n\n/**\n * Virtual module id for a view entry (`virtual:mcp-use/views/<name>`).\n *\n * @param name - View directory name.\n *\n * @internal\n */\nexport function virtualViewId(name: string): string {\n  return `${VIRTUAL_VIEW_PREFIX}${name}`;\n}\n\n/**\n * Dev URL path Vite serves a resolved virtual module at (browser-loadable).\n *\n * @param name - View directory name.\n *\n * @internal\n */\nexport function devVirtualEntryPath(name: string): string {\n  return `/@id/__x00__${VIRTUAL_VIEW_PREFIX}${name}`;\n}\n\n/**\n * Whether a filesystem path is a view component file or lives under a view dir.\n *\n * @internal\n */\nexport function isViewPath(file: string, cwd: string): boolean {\n  const rel = file.startsWith(cwd) ? file.slice(cwd.length + 1) : file;\n  return (\n    /^resources\\/[^/]+\\//.test(rel) || /^resources\\/[^/]+\\/view\\.tsx$/.test(rel)\n  );\n}\n\n/**\n * Whether a path is a view's `view.tsx` entry.\n *\n * @internal\n */\nexport function isViewEntryPath(file: string, cwd: string): boolean {\n  const rel = file.startsWith(cwd) ? file.slice(cwd.length + 1) : file;\n  return /^resources\\/[^/]+\\/view\\.tsx$/.test(rel);\n}\n\n/**\n * Build a dev-shaped views manifest (Vite URLs, `/@vite/client` script hook).\n *\n * @internal\n */\nexport function buildDevViewsManifest(views: DiscoveredView[]): ViewsManifest {\n  const manifest: ViewsManifest = {};\n  for (const view of views) {\n    manifest[view.name] = {\n      kind: \"external\",\n      entry: devVirtualEntryPath(view.name),\n      css: [],\n      scripts: [\"/@vite/client\"],\n    };\n  }\n  return manifest;\n}\n\n/**\n * Create a temporary Vite dev server for build-time binding validation.\n *\n * @internal\n */\nexport async function createBindingValidationServer(\n  cwd: string,\n  cacheDir: string,\n  configFile: string | false\n): Promise<ViteDevServer> {\n  const { createServer } = await import(\"vite\");\n  return createServer({\n    root: cwd,\n    configFile,\n    envFile: false,\n    logLevel: \"warn\",\n    cacheDir,\n    server: { middlewareMode: true, hmr: false },\n    ssr: { external: true },\n  });\n}\n","/**\n * Vite plugin: virtual view entry modules and optional SSR wrapper entry.\n */\n\nimport type { Plugin } from \"vite\";\n\nimport type { DiscoveredView } from \"./views.js\";\nimport {\n  VIRTUAL_VIEW_PREFIX,\n  VIRTUAL_VIEW_RESOLVED_PREFIX,\n  virtualViewId,\n} from \"./views.js\";\n\nconst VIRTUAL_TAILWIND_ID = \"virtual:mcp-use/tailwind.css\";\nconst VIRTUAL_TAILWIND_RESOLVED_ID = `\\0${VIRTUAL_TAILWIND_ID}`;\n\n/**\n * Options for {@link mcpUseViewsPlugin}.\n *\n * @internal\n */\nexport interface McpUseViewsPluginOptions {\n  /** Static list or live getter (dev rediscovery). */\n  getViews: () => DiscoveredView[];\n  /**\n   * Dev-mode entry shape. When present, every virtual entry self-accepts HMR\n   * updates (`import.meta.hot.accept()`) so an update that propagates past the\n   * view module re-runs the bootstrap instead of full-reloading the iframe\n   * document (which would wipe bridge state). Absent for builds — entries stay\n   * byte-identical to the production contract.\n   */\n  dev?: {\n    /**\n     * Whether React Fast Refresh is active (`@vitejs/plugin-react` resolved).\n     * When `true`, entries import the plugin's virtual refresh preamble\n     * (`@vitejs/plugin-react/preamble`) before any component module so the\n     * refresh runtime hooks the document — the role `transformIndexHtml`\n     * plays for Vite-served HTML, which synthesized srcdoc documents never\n     * pass through.\n     */\n    reactRefresh: boolean;\n  };\n}\n\n/**\n * Vite plugin that resolves `virtual:mcp-use/views/<name>` to bootstrap code.\n *\n * Applies only to the **client** environment.\n *\n * @internal\n */\nexport function mcpUseViewsPlugin(options: McpUseViewsPluginOptions): Plugin {\n  return {\n    name: \"mcp-use-views\",\n    applyToEnvironment(environment) {\n      return environment.name === \"client\";\n    },\n    resolveId(id) {\n      if (id === VIRTUAL_TAILWIND_ID) {\n        return VIRTUAL_TAILWIND_RESOLVED_ID;\n      }\n      if (!id.startsWith(VIRTUAL_VIEW_PREFIX)) {\n        return undefined;\n      }\n      return `\\0${id}`;\n    },\n    load(id) {\n      if (id === VIRTUAL_TAILWIND_RESOLVED_ID) {\n        return `@import \"tailwindcss\";`;\n      }\n      if (!id.startsWith(VIRTUAL_VIEW_RESOLVED_PREFIX)) {\n        return undefined;\n      }\n      const name = id.slice(VIRTUAL_VIEW_RESOLVED_PREFIX.length);\n      const view = options.getViews().find((v) => v.name === name);\n      if (view === undefined) {\n        return undefined;\n      }\n      const lines: string[] = [];\n      if (options.dev?.reactRefresh === true) {\n        // Must be the first import: the preamble hooks the refresh runtime\n        // into the window before react-dom (via the bootstrap import below)\n        // or any refresh-wrapped view module evaluates.\n        lines.push(`import \"@vitejs/plugin-react/preamble\";`);\n      }\n      lines.push(`import ${JSON.stringify(VIRTUAL_TAILWIND_ID)};`);\n      lines.push(\n        `import { bootstrapView } from \"mcp-use/react\";`,\n        `import * as viewModule from ${JSON.stringify(view.entryPath)};`,\n        `bootstrapView(viewModule);`\n      );\n      if (options.dev !== undefined) {\n        lines.push(\n          `if (import.meta.hot) {`,\n          `  import.meta.hot.accept();`,\n          `}`\n        );\n      }\n      lines.push(\"\");\n      return lines.join(\"\\n\");\n    },\n  };\n}\n\n/**\n * Rollup input map for a client views build (one entry per view).\n *\n * @internal\n */\nexport function clientBuildInputs(\n  views: DiscoveredView[]\n): Record<string, string> {\n  const input: Record<string, string> = {};\n  for (const view of views) {\n    input[view.name] = virtualViewId(view.name);\n  }\n  return input;\n}\n"],"mappings":"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","names":["existsSync","join","join","existsSync","join"]}

package/dist/{chunk-Q4PUTBMV.js → chunk-IG2BCCMU.js}

@@ -7,6 +7,7 @@ function parseArgs(argv) {
     host: void 0,
     tunnel: false,
     open: true,
+    withInspector: false,
     help: false,
     version: false
   };
@@ -55,6 +56,9 @@ function parseArgs(argv) {
       case "--no-open":
         args.open = false;
         break;
+      case "--with-inspector":
+        args.withInspector = true;
+        break;
       default:
         if (flag.startsWith("-")) {
           throw new Error(`Unknown option: ${flag}`);
@@ -91,4 +95,4 @@ export {
   parseArgs,
   resolvePort
 };
-//# sourceMappingURL=chunk-Q4PUTBMV.js.map
+//# sourceMappingURL=chunk-IG2BCCMU.js.map

package/dist/chunk-IG2BCCMU.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/bin/args.ts"],"sourcesContent":["/**\n * Hand-rolled argv parsing for the `mcp-use` bin.\n *\n * Deliberately dependency-free (no commander): the bin must add zero runtime\n * dependencies to the package (see specs/CLI_SPEC.md, dependency rules).\n */\n\n/**\n * Result of parsing the `mcp-use` command line.\n *\n * @internal\n */\nexport interface ParsedArgs {\n  /** First positional argument — the subcommand — or `undefined` if none was given. */\n  command: string | undefined;\n  /** Value of `--port`/`-p`, or `undefined` if the flag was not passed. */\n  port: number | undefined;\n  /** Value of `--entry`, or `undefined` if the flag was not passed. */\n  entry: string | undefined;\n  /** Value of `--host`, or `undefined` if the flag was not passed. */\n  host: string | undefined;\n  /** Whether `--tunnel` was passed (dev only). */\n  tunnel: boolean;\n  /** `false` when `--no-open` was passed (dev only); `true` otherwise. */\n  open: boolean;\n  /** Whether `--with-inspector` was passed (build only). */\n  withInspector: boolean;\n  /** Whether `--help`/`-h` was passed. */\n  help: boolean;\n  /** Whether `--version`/`-v` was passed. */\n  version: boolean;\n}\n\n/**\n * Parse the `mcp-use` argv (everything after the node binary and script path).\n *\n * Supports `--flag value` and `--flag=value` forms. The first bare token is\n * taken as the subcommand.\n *\n * @param argv - Raw arguments, typically `process.argv.slice(2)`.\n * @throws Error on an unknown flag, a missing flag value, an out-of-range\n * port, or a second positional argument.\n *\n * @internal\n */\nexport function parseArgs(argv: readonly string[]): ParsedArgs {\n  const args: ParsedArgs = {\n    command: undefined,\n    port: undefined,\n    entry: undefined,\n    host: undefined,\n    tunnel: false,\n    open: true,\n    withInspector: false,\n    help: false,\n    version: false,\n  };\n\n  for (let i = 0; i < argv.length; i++) {\n    const token = argv[i];\n    if (token === undefined) continue;\n\n    // Split `--flag=value` into flag + inline value.\n    let flag = token;\n    let inline: string | undefined;\n    if (token.startsWith(\"--\")) {\n      const eq = token.indexOf(\"=\");\n      if (eq !== -1) {\n        flag = token.slice(0, eq);\n        inline = token.slice(eq + 1);\n      }\n    }\n\n    /** Consume the flag's value: inline (`=`) or the next argv token. */\n    const takeValue = (): string => {\n      if (inline !== undefined) return inline;\n      const next = argv[++i];\n      if (next === undefined || next.startsWith(\"-\")) {\n        throw new Error(`Missing value for ${flag}`);\n      }\n      return next;\n    };\n\n    switch (flag) {\n      case \"-h\":\n      case \"--help\":\n        args.help = true;\n        break;\n      case \"-v\":\n      case \"--version\":\n        args.version = true;\n        break;\n      case \"-p\":\n      case \"--port\":\n        args.port = parsePort(takeValue());\n        break;\n      case \"--entry\":\n        args.entry = takeValue();\n        break;\n      case \"--host\":\n        args.host = takeValue();\n        break;\n      case \"--tunnel\":\n        args.tunnel = true;\n        break;\n      case \"--no-open\":\n        args.open = false;\n        break;\n      case \"--with-inspector\":\n        args.withInspector = true;\n        break;\n      default:\n        if (flag.startsWith(\"-\")) {\n          throw new Error(`Unknown option: ${flag}`);\n        }\n        if (args.command !== undefined) {\n          throw new Error(`Unexpected argument: ${flag}`);\n        }\n        args.command = flag;\n    }\n  }\n\n  return args;\n}\n\n/**\n * Resolve the preferred port for `mcp-use start` and `mcp-use dev` (`dev`\n * additionally probes upward from this value when it is taken).\n *\n * Precedence: `--port` flag, then the `PORT` environment variable, then\n * `3000`. A `PORT` value that is not a valid port number is ignored (the\n * default applies); an invalid `--port` flag has already been rejected by\n * {@link parseArgs}.\n *\n * @param flagPort - Port from the `--port`/`-p` flag, if given.\n * @param env - Environment to read `PORT` from.\n * @defaultValue `env` defaults to `process.env`.\n *\n * @internal\n */\nexport function resolvePort(\n  flagPort: number | undefined,\n  env: Readonly<Record<string, string | undefined>> = process.env\n): number {\n  if (flagPort !== undefined) return flagPort;\n  const raw = env.PORT;\n  if (raw !== undefined && raw.trim() !== \"\") {\n    const port = Number(raw);\n    if (isValidPort(port)) return port;\n  }\n  return 3000;\n}\n\n/** Parse a `--port` value, rejecting anything that is not a valid port. */\nfunction parsePort(value: string): number {\n  const port = Number(value);\n  if (!isValidPort(port)) {\n    throw new Error(`Invalid port: ${value}`);\n  }\n  return port;\n}\n\n/** Whether a number is a bindable TCP port (0 = ephemeral). */\nfunction isValidPort(port: number): boolean {\n  return Number.isInteger(port) && port >= 0 && port <= 65535;\n}\n"],"mappings":";AA6CO,SAAS,UAAU,MAAqC;AAC7D,QAAM,OAAmB;AAAA,IACvB,SAAS;AAAA,IACT,MAAM;AAAA,IACN,OAAO;AAAA,IACP,MAAM;AAAA,IACN,QAAQ;AAAA,IACR,MAAM;AAAA,IACN,eAAe;AAAA,IACf,MAAM;AAAA,IACN,SAAS;AAAA,EACX;AAEA,WAAS,IAAI,GAAG,IAAI,KAAK,QAAQ,KAAK;AACpC,UAAM,QAAQ,KAAK,CAAC;AACpB,QAAI,UAAU,OAAW;AAGzB,QAAI,OAAO;AACX,QAAI;AACJ,QAAI,MAAM,WAAW,IAAI,GAAG;AAC1B,YAAM,KAAK,MAAM,QAAQ,GAAG;AAC5B,UAAI,OAAO,IAAI;AACb,eAAO,MAAM,MAAM,GAAG,EAAE;AACxB,iBAAS,MAAM,MAAM,KAAK,CAAC;AAAA,MAC7B;AAAA,IACF;AAGA,UAAM,YAAY,MAAc;AAC9B,UAAI,WAAW,OAAW,QAAO;AACjC,YAAM,OAAO,KAAK,EAAE,CAAC;AACrB,UAAI,SAAS,UAAa,KAAK,WAAW,GAAG,GAAG;AAC9C,cAAM,IAAI,MAAM,qBAAqB,IAAI,EAAE;AAAA,MAC7C;AACA,aAAO;AAAA,IACT;AAEA,YAAQ,MAAM;AAAA,MACZ,KAAK;AAAA,MACL,KAAK;AACH,aAAK,OAAO;AACZ;AAAA,MACF,KAAK;AAAA,MACL,KAAK;AACH,aAAK,UAAU;AACf;AAAA,MACF,KAAK;AAAA,MACL,KAAK;AACH,aAAK,OAAO,UAAU,UAAU,CAAC;AACjC;AAAA,MACF,KAAK;AACH,aAAK,QAAQ,UAAU;AACvB;AAAA,MACF,KAAK;AACH,aAAK,OAAO,UAAU;AACtB;AAAA,MACF,KAAK;AACH,aAAK,SAAS;AACd;AAAA,MACF,KAAK;AACH,aAAK,OAAO;AACZ;AAAA,MACF,KAAK;AACH,aAAK,gBAAgB;AACrB;AAAA,MACF;AACE,YAAI,KAAK,WAAW,GAAG,GAAG;AACxB,gBAAM,IAAI,MAAM,mBAAmB,IAAI,EAAE;AAAA,QAC3C;AACA,YAAI,KAAK,YAAY,QAAW;AAC9B,gBAAM,IAAI,MAAM,wBAAwB,IAAI,EAAE;AAAA,QAChD;AACA,aAAK,UAAU;AAAA,IACnB;AAAA,EACF;AAEA,SAAO;AACT;AAiBO,SAAS,YACd,UACA,MAAoD,QAAQ,KACpD;AACR,MAAI,aAAa,OAAW,QAAO;AACnC,QAAM,MAAM,IAAI;AAChB,MAAI,QAAQ,UAAa,IAAI,KAAK,MAAM,IAAI;AAC1C,UAAM,OAAO,OAAO,GAAG;AACvB,QAAI,YAAY,IAAI,EAAG,QAAO;AAAA,EAChC;AACA,SAAO;AACT;AAGA,SAAS,UAAU,OAAuB;AACxC,QAAM,OAAO,OAAO,KAAK;AACzB,MAAI,CAAC,YAAY,IAAI,GAAG;AACtB,UAAM,IAAI,MAAM,iBAAiB,KAAK,EAAE;AAAA,EAC1C;AACA,SAAO;AACT;AAGA,SAAS,YAAY,MAAuB;AAC1C,SAAO,OAAO,UAAU,IAAI,KAAK,QAAQ,KAAK,QAAQ;AACxD;","names":[]}

package/dist/chunk-VV2P4ZFZ.js

@@ -0,0 +1,187 @@
+// src/views/document.ts
+function resolveAssetUrl(assetPath, origin) {
+  if (!assetPath.startsWith("/")) {
+    throw new Error(
+      `View manifest asset path must be origin-absolute (start with "/"); got ${JSON.stringify(assetPath)}`
+    );
+  }
+  return `${origin}${assetPath}`;
+}
+function viewAssetsBasePath(basePath, viewName) {
+  return `${basePath}/_mcp-use/views/${viewName}/`;
+}
+function resolveExternalAssetUrl(assetPath, assetsBase, basePath, viewName) {
+  if (assetPath.startsWith("http://") || assetPath.startsWith("https://") || assetPath.startsWith("data:")) {
+    return assetPath;
+  }
+  if (assetPath.startsWith("/")) {
+    return resolveAssetUrl(assetPath, assetsBase);
+  }
+  return `${assetsBase}${viewAssetsBasePath(basePath, viewName)}${assetPath.replace(/^\/+/, "")}`;
+}
+function resolvePublicBase(assetsBase, basePath) {
+  return `${assetsBase}${basePath}/_mcp-use/public/`;
+}
+function escapeInlineScript(code) {
+  return code.replaceAll(/<\/script/gi, "<\\/script").replaceAll("<!--", "\\x3C!--");
+}
+function escapeInlineStyle(css) {
+  return css.replaceAll(/<\/style/gi, "<\\/style");
+}
+function escapeHtml(value) {
+  return value.replaceAll("&", "&amp;").replaceAll('"', "&quot;").replaceAll("<", "&lt;").replaceAll(">", "&gt;");
+}
+function synthesizeViewDocument(entry, assetsBase, basePath, viewName) {
+  const viewConfig = {
+    publicBase: resolvePublicBase(assetsBase, basePath)
+  };
+  const configScript = `<script>globalThis.__mcpUseViewConfig=${JSON.stringify(viewConfig)};</script>`;
+  if (entry.kind === "inline") {
+    const styleTag = entry.css.length > 0 ? `<style>${escapeInlineStyle(entry.css)}</style>` : "";
+    const moduleScript = `<script type="module">${escapeInlineScript(entry.js)}</script>`;
+    return `<!doctype html>
+<html>
+<head>
+<meta charset="utf-8">
+${configScript}
+${styleTag}
+</head>
+<body>
+<div id="root"></div>
+${moduleScript}
+</body>
+</html>`;
+  }
+  if (viewName === void 0) {
+    throw new Error(
+      "viewName is required when synthesizing an external view document."
+    );
+  }
+  const cssLinks = entry.css.map(
+    (path) => `<link rel="stylesheet" href="${escapeHtml(resolveExternalAssetUrl(path, assetsBase, basePath, viewName))}">`
+  ).join("\n");
+  const scriptTags = (entry.scripts ?? []).map(
+    (path) => `<script type="module" src="${escapeHtml(resolveExternalAssetUrl(path, assetsBase, basePath, viewName))}"></script>`
+  ).join("\n");
+  const entryUrl = resolveExternalAssetUrl(
+    entry.entry,
+    assetsBase,
+    basePath,
+    viewName
+  );
+  return `<!doctype html>
+<html>
+<head>
+<meta charset="utf-8">
+${configScript}
+${cssLinks}
+</head>
+<body>
+<div id="root"></div>
+${scriptTags}
+<script type="module" src="${escapeHtml(entryUrl)}"></script>
+</body>
+</html>`;
+}
+
+// src/views/origin.ts
+function stripTrailingSlashes(value) {
+  return value.replace(/\/+$/, "");
+}
+function readEnv(name) {
+  if (typeof process === "undefined") {
+    return void 0;
+  }
+  const value = process.env[name];
+  return value !== void 0 && value !== "" ? value : void 0;
+}
+function parseForwardedHeader(header) {
+  for (const part of header.split(",")) {
+    const params = /* @__PURE__ */ new Map();
+    for (const token of part.split(";")) {
+      const [key, ...rest] = token.trim().split("=");
+      if (key === void 0 || rest.length === 0) {
+        continue;
+      }
+      params.set(key.toLowerCase(), rest.join("=").replace(/^"|"$/g, ""));
+    }
+    const proto = params.get("proto");
+    const host = params.get("host");
+    if (proto !== void 0 && host !== void 0) {
+      return `${proto}://${host}`;
+    }
+  }
+  return void 0;
+}
+function resolveRequestOriginFromHeaders(request) {
+  const forwarded = request.headers.get("forwarded");
+  if (forwarded !== null) {
+    const fromForwarded = parseForwardedHeader(forwarded);
+    if (fromForwarded !== void 0) {
+      return fromForwarded;
+    }
+  }
+  const proto = request.headers.get("x-forwarded-proto");
+  const host = request.headers.get("x-forwarded-host");
+  if (proto !== null && host !== null) {
+    const firstHost = host.split(",")[0]?.trim();
+    const firstProto = proto.split(",")[0]?.trim();
+    if (firstHost !== void 0 && firstProto !== void 0 && firstHost !== "") {
+      return `${firstProto}://${firstHost}`;
+    }
+  }
+  return new URL(request.url).origin;
+}
+function resolveServerOrigin(request) {
+  const mcpUrl = readEnv("MCP_URL");
+  if (mcpUrl !== void 0) {
+    try {
+      return new URL(mcpUrl).origin;
+    } catch {
+    }
+  }
+  return resolveRequestOriginFromHeaders(request);
+}
+function originFromAssetsBase(assetsBase) {
+  try {
+    return new URL(assetsBase).origin;
+  } catch {
+    return assetsBase;
+  }
+}
+function normalizeAssetsBaseUrl(value) {
+  return stripTrailingSlashes(value);
+}
+function resolveAssetsBase(request) {
+  const assetsUrl = readEnv("MCP_ASSETS_URL");
+  if (assetsUrl !== void 0) {
+    try {
+      return normalizeAssetsBaseUrl(new URL(assetsUrl).href.replace(/\/$/, ""));
+    } catch {
+    }
+  }
+  return resolveServerOrigin(request);
+}
+function hasExplicitAssetsBase() {
+  const assetsUrl = readEnv("MCP_ASSETS_URL");
+  if (assetsUrl === void 0) {
+    return false;
+  }
+  try {
+    new URL(assetsUrl);
+    return true;
+  } catch {
+    return false;
+  }
+}
+
+export {
+  viewAssetsBasePath,
+  synthesizeViewDocument,
+  resolveServerOrigin,
+  originFromAssetsBase,
+  normalizeAssetsBaseUrl,
+  resolveAssetsBase,
+  hasExplicitAssetsBase
+};
+//# sourceMappingURL=chunk-VV2P4ZFZ.js.map

package/dist/chunk-VV2P4ZFZ.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/views/document.ts","../src/views/origin.ts"],"sourcesContent":["import type { McpUseViewConfig } from \"../react/public-assets.js\";\nimport type { ViewManifestEntry } from \"./types.js\";\n\n/**\n * Resolve a manifest asset path to an absolute URL for embedding in the\n * synthesized view document.\n *\n * External manifest entries are origin-absolute `/`-prefixed paths by\n * contract ({@link ExternalViewManifestEntry}).\n *\n * @param assetPath - Origin-absolute path starting with `/`.\n * @param origin - Request-resolved public origin.\n * @returns Absolute URL `${origin}${assetPath}`.\n * @throws When `assetPath` does not start with `/`.\n */\nexport function resolveAssetUrl(assetPath: string, origin: string): string {\n  if (!assetPath.startsWith(\"/\")) {\n    throw new Error(\n      `View manifest asset path must be origin-absolute (start with \"/\"); got ${JSON.stringify(assetPath)}`\n    );\n  }\n  return `${origin}${assetPath}`;\n}\n\n/**\n * Build the HTTP path prefix for a view's built assets (no origin).\n *\n * @param basePath - MCP mount prefix (e.g. `/mcp`).\n * @param viewName - View directory / manifest key.\n */\nexport function viewAssetsBasePath(basePath: string, viewName: string): string {\n  return `${basePath}/_mcp-use/views/${viewName}/`;\n}\n\n/**\n * Resolve a production or dev external asset path to an absolute URL.\n *\n * @param assetPath - Full CDN URL, origin-absolute dev path (`/…`), or\n *   view-relative production path (`assets/…`).\n * @param assetsBase - Assets URL prefix (origin + optional path).\n * @param basePath - MCP mount prefix.\n * @param viewName - View directory / manifest key (required for view-relative paths).\n */\nexport function resolveExternalAssetUrl(\n  assetPath: string,\n  assetsBase: string,\n  basePath: string,\n  viewName: string\n): string {\n  if (\n    assetPath.startsWith(\"http://\") ||\n    assetPath.startsWith(\"https://\") ||\n    assetPath.startsWith(\"data:\")\n  ) {\n    return assetPath;\n  }\n  if (assetPath.startsWith(\"/\")) {\n    return resolveAssetUrl(assetPath, assetsBase);\n  }\n  return `${assetsBase}${viewAssetsBasePath(basePath, viewName)}${assetPath.replace(/^\\/+/, \"\")}`;\n}\n\n/**\n * Resolve the absolute URL prefix for the project's `public/` directory.\n *\n * @param assetsBase - Assets URL prefix (origin + optional path).\n * @param basePath - MCP mount prefix (e.g. `/mcp`).\n * @returns Absolute prefix with trailing slash.\n */\nexport function resolvePublicBase(\n  assetsBase: string,\n  basePath: string\n): string {\n  return `${assetsBase}${basePath}/_mcp-use/public/`;\n}\n\n/**\n * Escape view JS so it can sit inside a HTML `<script>` element without\n * premature termination or comment-open sequences.\n *\n * @param code - Raw module source.\n */\nfunction escapeInlineScript(code: string): string {\n  return code\n    .replaceAll(/<\\/script/gi, \"<\\\\/script\")\n    .replaceAll(\"<!--\", \"\\\\x3C!--\");\n}\n\n/**\n * Escape CSS so it can sit inside a HTML `<style>` element without premature\n * termination.\n *\n * @param css - Raw stylesheet text.\n */\nfunction escapeInlineStyle(css: string): string {\n  return css.replaceAll(/<\\/style/gi, \"<\\\\/style\");\n}\n\nfunction escapeHtml(value: string): string {\n  return value\n    .replaceAll(\"&\", \"&amp;\")\n    .replaceAll('\"', \"&quot;\")\n    .replaceAll(\"<\", \"&lt;\")\n    .replaceAll(\">\", \"&gt;\");\n}\n\n/**\n * Synthesize a complete HTML document for a view from manifest data.\n *\n * Production (`kind: \"external\"`) loads built assets over HTTP with absolute\n * URLs. Legacy `kind: \"inline\"` embeds JS/CSS directly. Dev uses Vite module\n * URLs (`kind: \"external\"` with origin-absolute paths).\n *\n * @param entry - Primed manifest entry for the view.\n * @param assetsBase - Request-resolved assets URL prefix for absolute asset URLs.\n * @param basePath - MCP mount prefix (e.g. `/mcp`).\n * @param viewName - View directory / manifest key (required for production external paths).\n */\nexport function synthesizeViewDocument(\n  entry: ViewManifestEntry,\n  assetsBase: string,\n  basePath: string,\n  viewName?: string\n): string {\n  const viewConfig: McpUseViewConfig = {\n    publicBase: resolvePublicBase(assetsBase, basePath),\n  };\n  const configScript = `<script>globalThis.__mcpUseViewConfig=${JSON.stringify(viewConfig)};</script>`;\n\n  if (entry.kind === \"inline\") {\n    const styleTag =\n      entry.css.length > 0\n        ? `<style>${escapeInlineStyle(entry.css)}</style>`\n        : \"\";\n    const moduleScript = `<script type=\"module\">${escapeInlineScript(entry.js)}</script>`;\n    return `<!doctype html>\n<html>\n<head>\n<meta charset=\"utf-8\">\n${configScript}\n${styleTag}\n</head>\n<body>\n<div id=\"root\"></div>\n${moduleScript}\n</body>\n</html>`;\n  }\n\n  if (viewName === undefined) {\n    throw new Error(\n      \"viewName is required when synthesizing an external view document.\"\n    );\n  }\n\n  const cssLinks = entry.css\n    .map(\n      (path) =>\n        `<link rel=\"stylesheet\" href=\"${escapeHtml(resolveExternalAssetUrl(path, assetsBase, basePath, viewName))}\">`\n    )\n    .join(\"\\n\");\n\n  const scriptTags = (entry.scripts ?? [])\n    .map(\n      (path) =>\n        `<script type=\"module\" src=\"${escapeHtml(resolveExternalAssetUrl(path, assetsBase, basePath, viewName))}\"></script>`\n    )\n    .join(\"\\n\");\n\n  const entryUrl = resolveExternalAssetUrl(\n    entry.entry,\n    assetsBase,\n    basePath,\n    viewName\n  );\n\n  return `<!doctype html>\n<html>\n<head>\n<meta charset=\"utf-8\">\n${configScript}\n${cssLinks}\n</head>\n<body>\n<div id=\"root\"></div>\n${scriptTags}\n<script type=\"module\" src=\"${escapeHtml(entryUrl)}\"></script>\n</body>\n</html>`;\n}\n","/**\n * Resolve public origins and asset URL prefixes for view documents and CSP.\n *\n * **Server origin** (`resolveServerOrigin`): MCP endpoint / API base — OAuth\n * resource identity, `connectDomains`, dev HMR websocket host.\n *\n * **Assets base** (`resolveAssetsBase`): prefix for view JS/CSS and\n * `public/` URLs — may include a path (CDN bucket prefix).\n */\n\n/** Strip trailing slashes from a URL prefix. */\nexport function stripTrailingSlashes(value: string): string {\n  return value.replace(/\\/+$/, \"\");\n}\n\nfunction readEnv(name: string): string | undefined {\n  if (typeof process === \"undefined\") {\n    return undefined;\n  }\n  const value = process.env[name];\n  return value !== undefined && value !== \"\" ? value : undefined;\n}\n\nfunction parseForwardedHeader(header: string): string | undefined {\n  for (const part of header.split(\",\")) {\n    const params = new Map<string, string>();\n    for (const token of part.split(\";\")) {\n      const [key, ...rest] = token.trim().split(\"=\");\n      if (key === undefined || rest.length === 0) {\n        continue;\n      }\n      params.set(key.toLowerCase(), rest.join(\"=\").replace(/^\"|\"$/g, \"\"));\n    }\n    const proto = params.get(\"proto\");\n    const host = params.get(\"host\");\n    if (proto !== undefined && host !== undefined) {\n      return `${proto}://${host}`;\n    }\n  }\n  return undefined;\n}\n\n/**\n * Resolve origin from forwarded headers or the request URL (no env override).\n */\nexport function resolveRequestOriginFromHeaders(request: Request): string {\n  const forwarded = request.headers.get(\"forwarded\");\n  if (forwarded !== null) {\n    const fromForwarded = parseForwardedHeader(forwarded);\n    if (fromForwarded !== undefined) {\n      return fromForwarded;\n    }\n  }\n\n  const proto = request.headers.get(\"x-forwarded-proto\");\n  const host = request.headers.get(\"x-forwarded-host\");\n  if (proto !== null && host !== null) {\n    const firstHost = host.split(\",\")[0]?.trim();\n    const firstProto = proto.split(\",\")[0]?.trim();\n    if (\n      firstHost !== undefined &&\n      firstProto !== undefined &&\n      firstHost !== \"\"\n    ) {\n      return `${firstProto}://${firstHost}`;\n    }\n  }\n\n  return new URL(request.url).origin;\n}\n\n/**\n * Server public origin — `MCP_URL` when valid, else forwarded/request origin.\n *\n * Uses `.origin` only (path suffix on `MCP_URL` is ignored).\n */\nexport function resolveServerOrigin(request: Request): string {\n  const mcpUrl = readEnv(\"MCP_URL\");\n  if (mcpUrl !== undefined) {\n    try {\n      return new URL(mcpUrl).origin;\n    } catch {\n      // Fall through when MCP_URL is malformed.\n    }\n  }\n  return resolveRequestOriginFromHeaders(request);\n}\n\n/**\n * Extract the origin from an assets URL prefix (origin + optional path).\n */\nexport function originFromAssetsBase(assetsBase: string): string {\n  try {\n    return new URL(assetsBase).origin;\n  } catch {\n    return assetsBase;\n  }\n}\n\n/**\n * Normalize `MCP_ASSETS_URL` to a URL prefix without trailing slash.\n */\nexport function normalizeAssetsBaseUrl(value: string): string {\n  return stripTrailingSlashes(value);\n}\n\n/**\n * Assets URL prefix for view JS/CSS and `public/` — `MCP_ASSETS_URL` when set,\n * else server origin from {@link resolveServerOrigin}.\n */\nexport function resolveAssetsBase(request: Request): string {\n  const assetsUrl = readEnv(\"MCP_ASSETS_URL\");\n  if (assetsUrl !== undefined) {\n    try {\n      return normalizeAssetsBaseUrl(new URL(assetsUrl).href.replace(/\\/$/, \"\"));\n    } catch {\n      // Fall through when MCP_ASSETS_URL is malformed.\n    }\n  }\n  return resolveServerOrigin(request);\n}\n\n/**\n * @deprecated Alias for {@link resolveServerOrigin} — kept for OAuth callers.\n */\nexport function resolveRequestOrigin(request: Request): string {\n  return resolveServerOrigin(request);\n}\n\n/**\n * Whether `MCP_ASSETS_URL` is explicitly configured (distinct from server).\n */\nexport function hasExplicitAssetsBase(): boolean {\n  const assetsUrl = readEnv(\"MCP_ASSETS_URL\");\n  if (assetsUrl === undefined) {\n    return false;\n  }\n  try {\n    new URL(assetsUrl);\n    return true;\n  } catch {\n    return false;\n  }\n}\n"],"mappings":"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","names":[]}

package/dist/cli/build.d.ts

@@ -3,7 +3,7 @@
  * `.mcp-use/build/` workspace directory (CLI_SPEC.md § Commands → build).
  *
  * When views exist (under `resources/<name>/view.tsx`), also runs a client-environment
- * build per view (self-contained inline bundles), validates bindings, and emits a
+ * build per view (hashed assets on disk), validates bindings, and emits a
  * wrapper entry that primes views before re-exporting the server (VIEWS_SPEC.md §
  * Build system).
  *
@@ -28,6 +28,11 @@ export interface BuildOptions {
      * `index.ts`, `server.ts` — first hit wins.
      */
     entry?: string;
+    /**
+     * When true (`mcp-use build --with-inspector`), record `inspector: true`
+     * in the build manifest.
+     */
+    withInspector?: boolean;
 }
 /**
  * Build the project's server for production: a Vite build of the SSR/node

package/dist/cli/build.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"build.d.ts","sourceRoot":"","sources":["../../src/cli/build.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AA+BH;;;;GAIG;AACH,MAAM,WAAW,YAAY;IAC3B,8EAA8E;IAC9E,GAAG,EAAE,MAAM,CAAC;IACZ;;;;;OAKG;IACH,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAmID;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,wBAAsB,QAAQ,CAAC,OAAO,EAAE,YAAY,GAAG,OAAO,CAAC,IAAI,CAAC,CA6InE"}
+{"version":3,"file":"build.d.ts","sourceRoot":"","sources":["../../src/cli/build.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAoCH;;;;GAIG;AACH,MAAM,WAAW,YAAY;IAC3B,8EAA8E;IAC9E,GAAG,EAAE,MAAM,CAAC;IACZ;;;;;OAKG;IACH,KAAK,CAAC,EAAE,MAAM,CAAC;IACf;;;OAGG;IACH,aAAa,CAAC,EAAE,OAAO,CAAC;CACzB;AAsKD;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,wBAAsB,QAAQ,CAAC,OAAO,EAAE,YAAY,GAAG,OAAO,CAAC,IAAI,CAAC,CA6KnE"}

package/dist/cli/views-bindings.d.ts

@@ -3,6 +3,15 @@
  */
 import { type DevEnvironment } from "vite";
 import type { ViewsManifest } from "../views/types.js";
+/**
+ * Import the server entry and read `basePath` from the default export.
+ *
+ * Does not prime views or call `getHandler()`. Sets a synthetic `MCP_URL` only
+ * when unset so OAuth entries can construct during build introspection.
+ *
+ * @internal
+ */
+export declare function resolveBuildBasePath(environment: DevEnvironment, entry: string): Promise<string>;
 /**
  * Prime the server with the manifest and run mount-time binding validation
  * by calling `getHandler()`.

package/dist/cli/views-bindings.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"views-bindings.d.ts","sourceRoot":"","sources":["../../src/cli/views-bindings.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAA4B,KAAK,cAAc,EAAE,MAAM,MAAM,CAAC;AAErE,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AAYvD;;;;;;;;;;;;;GAaG;AACH,wBAAsB,2BAA2B,CAC/C,WAAW,EAAE,cAAc,EAC3B,KAAK,EAAE,MAAM,EACb,aAAa,EAAE,aAAa,GAC3B,OAAO,CAAC,IAAI,CAAC,CA2Bf"}
+{"version":3,"file":"views-bindings.d.ts","sourceRoot":"","sources":["../../src/cli/views-bindings.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAA4B,KAAK,cAAc,EAAE,MAAM,MAAM,CAAC;AAErE,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AAkBvD;;;;;;;GAOG;AACH,wBAAsB,oBAAoB,CACxC,WAAW,EAAE,cAAc,EAC3B,KAAK,EAAE,MAAM,GACZ,OAAO,CAAC,MAAM,CAAC,CA+BjB;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAsB,2BAA2B,CAC/C,WAAW,EAAE,cAAc,EAC3B,KAAK,EAAE,MAAM,EACb,aAAa,EAAE,aAAa,GAC3B,OAAO,CAAC,IAAI,CAAC,CA2Bf"}

package/dist/cli/workspace.d.ts

@@ -26,7 +26,6 @@
  * workspace, distinct from the global `~/.mcp-use/` store (CLI auth,
  * credentials, per-user caches).
  */
-import type { ViewsManifest } from "../views/types.js";
 /**
  * Fixed name of the per-project workspace directory.
  *
@@ -57,17 +56,10 @@ export interface BuildManifest {
     /** ISO-8601 timestamp of when the build finished. */
     createdAt: string;
     /**
-     * Whether the built server mounts the inspector shell route. Currently
-     * always written as `true` (not introspected from the server config) and
-     * consumed by nothing — the built server's own `MCPServer` config governs
-     * the route at runtime. Recorded as a known gap in CLI_SPEC.md § build.
+     * Whether the build was created with `mcp-use build --with-inspector`.
+     * Consumed by `mcp-use start` to decide whether to mount the inspector shell.
      */
     inspector: boolean;
-    /**
-     * Built views map (VIEWS_SPEC.md § Manifest). Present only when the project
-     * has view entries under `resources/<name>/view.tsx`.
-     */
-    views?: ViewsManifest;
 }
 /**
  * Every resolved path for a project's `.mcp-use/` workspace.

package/dist/cli/workspace.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"workspace.d.ts","sourceRoot":"","sources":["../../src/cli/workspace.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AAIH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AAEvD;;;;GAIG;AACH,eAAO,MAAM,kBAAkB,aAAa,CAAC;AAE7C;;;;GAIG;AACH,eAAO,MAAM,mBAAmB,kBAAkB,CAAC;AAEnD;;;;;GAKG;AACH,MAAM,WAAW,aAAa;IAC5B,4EAA4E;IAC5E,OAAO,EAAE,MAAM,CAAC;IAChB;;;;OAIG;IACH,UAAU,EAAE,MAAM,CAAC;IACnB,qDAAqD;IACrD,SAAS,EAAE,MAAM,CAAC;IAClB;;;;;OAKG;IACH,SAAS,EAAE,OAAO,CAAC;IACnB;;;OAGG;IACH,KAAK,CAAC,EAAE,aAAa,CAAC;CACvB;AAED;;;;GAIG;AACH,MAAM,WAAW,cAAc;IAC7B,+DAA+D;IAC/D,WAAW,EAAE,MAAM,CAAC;IACpB,2CAA2C;IAC3C,SAAS,EAAE,MAAM,CAAC;IAClB,gDAAgD;IAChD,KAAK,EAAE,MAAM,CAAC;IACd;;;OAGG;IACH,SAAS,EAAE,MAAM,CAAC;IAClB,8CAA8C;IAC9C,KAAK,EAAE,MAAM,CAAC;IACd,uCAAuC;IACvC,KAAK,EAAE,MAAM,CAAC;IACd,0CAA0C;IAC1C,KAAK,EAAE,MAAM,CAAC;IACd,+CAA+C;IAC/C,aAAa,EAAE,MAAM,CAAC;IACtB,2DAA2D;IAC3D,MAAM,EAAE,MAAM,CAAC;CAChB;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,qBAAqB,CAAC,WAAW,EAAE,MAAM,GAAG,cAAc,CAczE"}
+{"version":3,"file":"workspace.d.ts","sourceRoot":"","sources":["../../src/cli/workspace.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AAIH;;;;GAIG;AACH,eAAO,MAAM,kBAAkB,aAAa,CAAC;AAE7C;;;;GAIG;AACH,eAAO,MAAM,mBAAmB,kBAAkB,CAAC;AAEnD;;;;;GAKG;AACH,MAAM,WAAW,aAAa;IAC5B,4EAA4E;IAC5E,OAAO,EAAE,MAAM,CAAC;IAChB;;;;OAIG;IACH,UAAU,EAAE,MAAM,CAAC;IACnB,qDAAqD;IACrD,SAAS,EAAE,MAAM,CAAC;IAClB;;;OAGG;IACH,SAAS,EAAE,OAAO,CAAC;CACpB;AAED;;;;GAIG;AACH,MAAM,WAAW,cAAc;IAC7B,+DAA+D;IAC/D,WAAW,EAAE,MAAM,CAAC;IACpB,2CAA2C;IAC3C,SAAS,EAAE,MAAM,CAAC;IAClB,gDAAgD;IAChD,KAAK,EAAE,MAAM,CAAC;IACd;;;OAGG;IACH,SAAS,EAAE,MAAM,CAAC;IAClB,8CAA8C;IAC9C,KAAK,EAAE,MAAM,CAAC;IACd,uCAAuC;IACvC,KAAK,EAAE,MAAM,CAAC;IACd,0CAA0C;IAC1C,KAAK,EAAE,MAAM,CAAC;IACd,+CAA+C;IAC/C,aAAa,EAAE,MAAM,CAAC;IACtB,2DAA2D;IAC3D,MAAM,EAAE,MAAM,CAAC;CAChB;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,qBAAqB,CAAC,WAAW,EAAE,MAAM,GAAG,cAAc,CAczE"}