mcp-use 2.0.0-beta.9 → 2.0.1

package/dist/chunk-ZMIKQPSO.js

@@ -1,151 +0,0 @@
-import {
-  CommandError,
-  GLOBAL_STATE_DIR,
-  readJson,
-  removeFile,
-  writePrivateJson
-} from "./chunk-XUD22N3Y.js";
-
-// src/commands/cloud-api.ts
-import { join } from "path";
-var CONFIG_PATH = join(GLOBAL_STATE_DIR, "config.json");
-function cloudApiUrl() {
-  const configured = process.env["MCP_USE_CLOUD_API_URL"];
-  const base = configured ?? "https://cloud.manufact.com/api/v1";
-  return base.replace(/\/+$/, "").replace(/\/api\/v1$/, "") + "/api/v1";
-}
-function cloudAuthUrl() {
-  return cloudApiUrl().replace(/\/api\/v1$/, "");
-}
-async function readCloudConfig() {
-  return readJson(CONFIG_PATH, {});
-}
-async function writeCloudConfig(config) {
-  await writePrivateJson(CONFIG_PATH, config);
-}
-async function clearCloudConfig() {
-  await removeFile(CONFIG_PATH);
-}
-function resolveOrganization(organizations, selector) {
-  const matches = organizations.filter(
-    (organization) => organization.id === selector || organization.slug === selector
-  );
-  if (matches.length !== 1) {
-    throw new CommandError(
-      matches.length === 0 ? "organization_not_found" : "organization_ambiguous",
-      `Organization not found: ${selector}`
-    );
-  }
-  return matches[0];
-}
-var CloudApi = class _CloudApi {
-  #apiKey;
-  #organizationId;
-  constructor(apiKey, organizationId) {
-    this.#apiKey = apiKey;
-    this.#organizationId = organizationId;
-  }
-  /** Create a client from persisted credentials. */
-  static async create(organizationId) {
-    const config = await readCloudConfig();
-    const apiKey = process.env["MCP_USE_API_KEY"] ?? config.apiKey;
-    if (apiKey === void 0 || apiKey === "") {
-      throw new CommandError(
-        "not_authenticated",
-        "Not logged in. Run `mcp-use login`."
-      );
-    }
-    return new _CloudApi(apiKey, organizationId ?? config.orgId);
-  }
-  /** Create a client for validating a candidate API key. */
-  static withApiKey(apiKey) {
-    return new _CloudApi(apiKey);
-  }
-  /** Perform an authenticated JSON request. */
-  async request(path, init = {}) {
-    const organizationId = init.organizationId ?? this.#organizationId;
-    const response = await fetch(`${cloudApiUrl()}${path}`, {
-      ...init,
-      headers: {
-        Accept: "application/json",
-        "x-api-key": this.#apiKey,
-        ...organizationId !== void 0 ? { "x-profile-id": organizationId } : {},
-        ...init.body !== void 0 ? { "Content-Type": "application/json" } : {},
-        ...init.headers
-      }
-    });
-    const text = await response.text();
-    let body;
-    try {
-      body = text === "" ? void 0 : JSON.parse(text);
-    } catch {
-      body = text;
-    }
-    if (!response.ok) {
-      throw new CommandError(
-        response.status === 401 ? "not_authenticated" : response.status === 403 ? "forbidden" : "cloud_api_error",
-        messageFrom(body) ?? `Cloud API request failed (${response.status}).`,
-        { status: response.status }
-      );
-    }
-    return body;
-  }
-  /** Verify credentials and return the current identity. */
-  async identity() {
-    const response = await this.request("/test-auth");
-    return {
-      userId: response.user_id,
-      email: response.email,
-      organizations: response.profiles.map((profile) => ({
-        id: profile.id,
-        name: profile.profile_name,
-        slug: profile.slug,
-        role: profile.role
-      })),
-      defaultOrganizationId: response.default_profile_id
-    };
-  }
-  /** Update the account-default organization. */
-  async setDefaultOrganization(organizationId) {
-    await this.request(`/organizations/${organizationId}/set-default`, {
-      method: "POST"
-    });
-  }
-};
-async function cloudApiForOrganization(selector) {
-  const config = await readCloudConfig();
-  const identity = await (await CloudApi.create()).identity();
-  const organization = selector !== void 0 ? resolveOrganization(identity.organizations, selector) : identity.organizations.find(
-    (item) => item.id === (config.orgId ?? identity.defaultOrganizationId)
-  );
-  if (organization === void 0) {
-    throw new CommandError(
-      "organization_required",
-      "No active organization. Run `mcp-use org use <id-or-slug>`."
-    );
-  }
-  return {
-    api: await CloudApi.create(organization.id),
-    organizationId: organization.id
-  };
-}
-function messageFrom(body) {
-  if (typeof body === "string" && body !== "") return body;
-  if (body === null || typeof body !== "object") return void 0;
-  for (const key of ["message", "error", "detail"]) {
-    const value = body[key];
-    if (typeof value === "string" && value !== "") return value;
-  }
-  return void 0;
-}
-
-export {
-  cloudAuthUrl,
-  readCloudConfig,
-  writeCloudConfig,
-  clearCloudConfig,
-  resolveOrganization,
-  CloudApi,
-  cloudApiForOrganization
-};
-//# sourceMappingURL=chunk-ZMIKQPSO.js.map

package/dist/chunk-ZMIKQPSO.js.map

@@ -1 +0,0 @@
-{"version":3,"sources":["../src/commands/cloud-api.ts"],"sourcesContent":["import { join } from \"node:path\";\n\nimport {\n  CommandError,\n  GLOBAL_STATE_DIR,\n  readJson,\n  removeFile,\n  writePrivateJson,\n} from \"./shared.js\";\n\n/** Organization returned by the cloud authentication endpoint. */\nexport interface CloudOrganization {\n  /** Organization id. */\n  id: string;\n  /** Human-readable organization name. */\n  name: string;\n  /** URL-safe organization slug. */\n  slug: string | null;\n  /** Current member's role. */\n  role: string;\n}\n\n/** Persisted cloud CLI state. */\nexport interface CloudConfig {\n  /** Cloud API key. */\n  apiKey?: string;\n  /** Active organization id. */\n  orgId?: string;\n  /** Active organization name. */\n  orgName?: string;\n  /** Active organization slug. */\n  orgSlug?: string;\n}\n\n/** Authentication response normalized for CLI consumers. */\nexport interface CloudIdentity {\n  /** User id. */\n  userId: string;\n  /** User email address. */\n  email: string;\n  /** Organization memberships. */\n  organizations: CloudOrganization[];\n  /** Account-default organization id. */\n  defaultOrganizationId: string | null;\n}\n\ninterface AuthWireResponse {\n  user_id: string;\n  email: string;\n  profiles: Array<{\n    id: string;\n    profile_name: string;\n    slug: string | null;\n    role: string;\n  }>;\n  default_profile_id: string | null;\n}\n\nconst CONFIG_PATH = join(GLOBAL_STATE_DIR, \"config.json\");\n\n/** Cloud API base URL. */\nexport function cloudApiUrl(): string {\n  const configured = process.env[\"MCP_USE_CLOUD_API_URL\"];\n  const base = configured ?? \"https://cloud.manufact.com/api/v1\";\n  return base.replace(/\\/+$/, \"\").replace(/\\/api\\/v1$/, \"\") + \"/api/v1\";\n}\n\n/** Cloud web application URL. */\nexport function cloudWebUrl(): string {\n  return (\n    process.env[\"MCP_USE_CLOUD_WEB_URL\"] ?? \"https://manufact.com\"\n  ).replace(/\\/+$/, \"\");\n}\n\n/** OAuth base URL hosting device authorization endpoints. */\nexport function cloudAuthUrl(): string {\n  return cloudApiUrl().replace(/\\/api\\/v1$/, \"\");\n}\n\n/** Read cloud CLI state. */\nexport async function readCloudConfig(): Promise<CloudConfig> {\n  return readJson(CONFIG_PATH, {});\n}\n\n/** Persist cloud CLI state. */\nexport async function writeCloudConfig(config: CloudConfig): Promise<void> {\n  await writePrivateJson(CONFIG_PATH, config);\n}\n\n/** Delete cloud CLI state. */\nexport async function clearCloudConfig(): Promise<void> {\n  await removeFile(CONFIG_PATH);\n}\n\n/** Resolve an organization id or slug from memberships. */\nexport function resolveOrganization(\n  organizations: readonly CloudOrganization[],\n  selector: string\n): CloudOrganization {\n  const matches = organizations.filter(\n    (organization) =>\n      organization.id === selector || organization.slug === selector\n  );\n  if (matches.length !== 1) {\n    throw new CommandError(\n      matches.length === 0\n        ? \"organization_not_found\"\n        : \"organization_ambiguous\",\n      `Organization not found: ${selector}`\n    );\n  }\n  return matches[0]!;\n}\n\n/** Minimal authenticated cloud API client. */\nexport class CloudApi {\n  readonly #apiKey: string;\n  readonly #organizationId: string | undefined;\n\n  private constructor(apiKey: string, organizationId?: string) {\n    this.#apiKey = apiKey;\n    this.#organizationId = organizationId;\n  }\n\n  /** Create a client from persisted credentials. */\n  static async create(organizationId?: string): Promise<CloudApi> {\n    const config = await readCloudConfig();\n    const apiKey = process.env[\"MCP_USE_API_KEY\"] ?? config.apiKey;\n    if (apiKey === undefined || apiKey === \"\") {\n      throw new CommandError(\n        \"not_authenticated\",\n        \"Not logged in. Run `mcp-use login`.\"\n      );\n    }\n    return new CloudApi(apiKey, organizationId ?? config.orgId);\n  }\n\n  /** Create a client for validating a candidate API key. */\n  static withApiKey(apiKey: string): CloudApi {\n    return new CloudApi(apiKey);\n  }\n\n  /** Perform an authenticated JSON request. */\n  async request<T>(\n    path: string,\n    init: RequestInit & { organizationId?: string } = {}\n  ): Promise<T> {\n    const organizationId = init.organizationId ?? this.#organizationId;\n    const response = await fetch(`${cloudApiUrl()}${path}`, {\n      ...init,\n      headers: {\n        Accept: \"application/json\",\n        \"x-api-key\": this.#apiKey,\n        ...(organizationId !== undefined\n          ? { \"x-profile-id\": organizationId }\n          : {}),\n        ...(init.body !== undefined\n          ? { \"Content-Type\": \"application/json\" }\n          : {}),\n        ...init.headers,\n      },\n    });\n    const text = await response.text();\n    let body: unknown;\n    try {\n      body = text === \"\" ? undefined : JSON.parse(text);\n    } catch {\n      body = text;\n    }\n    if (!response.ok) {\n      throw new CommandError(\n        response.status === 401\n          ? \"not_authenticated\"\n          : response.status === 403\n            ? \"forbidden\"\n            : \"cloud_api_error\",\n        messageFrom(body) ?? `Cloud API request failed (${response.status}).`,\n        { status: response.status }\n      );\n    }\n    return body as T;\n  }\n\n  /** Verify credentials and return the current identity. */\n  async identity(): Promise<CloudIdentity> {\n    const response = await this.request<AuthWireResponse>(\"/test-auth\");\n    return {\n      userId: response.user_id,\n      email: response.email,\n      organizations: response.profiles.map((profile) => ({\n        id: profile.id,\n        name: profile.profile_name,\n        slug: profile.slug,\n        role: profile.role,\n      })),\n      defaultOrganizationId: response.default_profile_id,\n    };\n  }\n\n  /** Update the account-default organization. */\n  async setDefaultOrganization(organizationId: string): Promise<void> {\n    await this.request(`/organizations/${organizationId}/set-default`, {\n      method: \"POST\",\n    });\n  }\n}\n\n/** Create a cloud client for an optional organization id or slug. */\nexport async function cloudApiForOrganization(\n  selector?: string\n): Promise<{ api: CloudApi; organizationId: string }> {\n  const config = await readCloudConfig();\n  const identity = await (await CloudApi.create()).identity();\n  const organization =\n    selector !== undefined\n      ? resolveOrganization(identity.organizations, selector)\n      : identity.organizations.find(\n          (item) => item.id === (config.orgId ?? identity.defaultOrganizationId)\n        );\n  if (organization === undefined) {\n    throw new CommandError(\n      \"organization_required\",\n      \"No active organization. Run `mcp-use org use <id-or-slug>`.\"\n    );\n  }\n  return {\n    api: await CloudApi.create(organization.id),\n    organizationId: organization.id,\n  };\n}\n\nfunction messageFrom(body: unknown): string | undefined {\n  if (typeof body === \"string\" && body !== \"\") return body;\n  if (body === null || typeof body !== \"object\") return undefined;\n  for (const key of [\"message\", \"error\", \"detail\"]) {\n    const value = (body as Record<string, unknown>)[key];\n    if (typeof value === \"string\" && value !== \"\") return value;\n  }\n  return undefined;\n}\n"],"mappings":"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","names":[]}

package/dist/cli/build.d.ts

@@ -1,61 +0,0 @@
-/**
- * `mcp-use build` — Vite SSR/node build of the user's server entry into the
- * `.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 (hashed assets on disk), validates bindings, and emits a
- * wrapper entry that primes views before re-exporting the server (VIEWS_SPEC.md §
- * Build system).
- *
- * `vite` is an optional peer dependency of `mcp-use` (never a regular
- * dependency): this module is only ever reached through the bin's dynamic
- * `import("./cli/index.js")`, so a missing install surfaces as a rejected
- * promise there (classified by `bin/main.ts`'s `isViteMissing`), not at
- * package load time.
- */
-/**
- * Options for {@link runBuild}.
- *
- * @internal
- */
-export interface BuildOptions {
-    /** Absolute path to the project root (the directory containing the entry). */
-    cwd: string;
-    /**
-     * Explicit entry path (the `--entry` flag), absolute or relative to `cwd`.
-     *
-     * @defaultValue Conventional discovery: `src/index.ts`, `src/server.ts`,
-     * `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
- * environment only (the client environment for views arrives with
- * VIEWS_SPEC.md), emitted as ESM to `.mcp-use/build/` with a `manifest.json`
- * alongside it.
- *
- * Dependencies stay external (`ssr: { external: true }`): only the
- * user's own source is bundled; every bare import resolves from
- * `node_modules` at runtime. The built entry preserves the default export
- * (the `MCPServer` instance) so `mcp-use start` can import and serve it.
- *
- * There is deliberately no typecheck step — the build is transpile-only;
- * users run `tsc --noEmit` via their own script.
- *
- * @param options - Project root and optional entry override.
- * @throws If no entry is found (see {@link discoverEntry}), or if `vite` is
- * not installed (`mcp-use build` requires it as a devDependency) — the
- * `import("vite")` rejection propagates to the bin's dispatch boundary,
- * which classifies it and prints the install hint.
- *
- * @internal Reached only via the bin's `import("./cli/index.js")`
- * dispatch (`bin/main.ts`) — not re-exported from the package's "." entry.
- */
-export declare function runBuild(options: BuildOptions): Promise<void>;
-//# sourceMappingURL=build.d.ts.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"build.d.ts","sourceRoot":"","sources":["../../src/cli/build.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AA4CH;;;;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,CAkLnE"}

package/dist/cli/dev-api.d.ts

@@ -1,49 +0,0 @@
-/**
- * Dev-only inspector API routes intercepted by `mcp-use dev` before the MCP
- * handler — tunnel controls and session metadata for the inspector UI.
- */
-import type { TunnelManager } from "./tunnel.js";
-/** Web-standard request handler, as returned by `MCPServer.getHandler()`. */
-type FetchHandler = (request: Request) => Promise<Response>;
-/**
- * Dependencies for {@link createDevApiHandler}.
- *
- * @internal
- */
-export interface DevApiHandlerOptions {
-    /** Returns the current MCP mount path (may change after a dev reload). */
-    getBasePath: () => string;
-    /** Port the dev HTTP listener is bound to. */
-    port: number;
-    /** Tunnel lifecycle manager owned by the dev process. */
-    tunnel: TunnelManager;
-}
-/** JSON body for `GET …/inspector/api/dev/info`. */
-export interface DevInfoResponse {
-    /** Full MCP endpoint URL when a tunnel is active; otherwise `null`. */
-    mcpUrl: string | null;
-    /** Port the dev server listens on. */
-    port: number;
-    /** Whether the request is served by `mcp-use dev` (always `true` here). */
-    fromCli: true;
-    /** Public tunnel origin URL, or `null` when no tunnel is running. */
-    tunnelUrl: string | null;
-}
-/**
- * Wrap an MCP {@link FetchHandler} so dev-only inspector API routes are
- * answered in-process before delegating everything else.
- *
- * @param options - Base path, bound port, and tunnel manager.
- * @param fallback - Handler to invoke when the request is not a dev API route.
- *
- * @example
- * ```ts
- * const handler = createDevApiHandler(
- *   { getBasePath: () => "/mcp", port: 3000, tunnel },
- *   server.getHandler()
- * );
- * ```
- */
-export declare function createDevApiHandler(options: DevApiHandlerOptions, fallback: FetchHandler): FetchHandler;
-export {};
-//# sourceMappingURL=dev-api.d.ts.map

package/dist/cli/dev-api.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"dev-api.d.ts","sourceRoot":"","sources":["../../src/cli/dev-api.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAEjD,6EAA6E;AAC7E,KAAK,YAAY,GAAG,CAAC,OAAO,EAAE,OAAO,KAAK,OAAO,CAAC,QAAQ,CAAC,CAAC;AAE5D;;;;GAIG;AACH,MAAM,WAAW,oBAAoB;IACnC,0EAA0E;IAC1E,WAAW,EAAE,MAAM,MAAM,CAAC;IAC1B,8CAA8C;IAC9C,IAAI,EAAE,MAAM,CAAC;IACb,yDAAyD;IACzD,MAAM,EAAE,aAAa,CAAC;CACvB;AAED,oDAAoD;AACpD,MAAM,WAAW,eAAe;IAC9B,uEAAuE;IACvE,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,sCAAsC;IACtC,IAAI,EAAE,MAAM,CAAC;IACb,2EAA2E;IAC3E,OAAO,EAAE,IAAI,CAAC;IACd,qEAAqE;IACrE,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;CAC1B;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,mBAAmB,CACjC,OAAO,EAAE,oBAAoB,EAC7B,QAAQ,EAAE,YAAY,GACrB,YAAY,CA4Cd"}

package/dist/cli/dev.d.ts

@@ -1,101 +0,0 @@
-/**
- * `mcp-use dev` — a single long-lived dev process (CLI_SPEC.md § Commands →
- * dev): a Vite dev server (Environment API, node/SSR environment only) loads
- * the entry through the module runner; one HTTP listener delegates every
- * request to an atomically swappable handler reference.
- *
- * When views exist, the same Vite server gains a client environment with real
- * HMR for view files; the CLI primes views on each entry reload via the
- * internal {@link registerViews} API (VIEWS_SPEC.md § Dev).
- *
- * Reload, not HMR: on file change the entry is re-imported and the handler
- * reference swapped — no registration diffing or running-registry mutation.
- * All handler generations share one event bus, so a successful swap invalidates
- * the tool, prompt, and resource lists for subscribed development clients.
- *
- * This module is reached only through the bin's dedicated dynamic dev import,
- * so library consumers and production startup never evaluate Vite.
- */
-/**
- * Options for {@link runDev}.
- *
- * @internal
- */
-export interface DevOptions {
-    /** Absolute path to the project root. */
-    cwd: string;
-    /**
-     * Explicit entry path (the `--entry` flag), absolute or relative to `cwd`.
-     *
-     * @defaultValue Conventional discovery: `src/index.ts`, `src/server.ts`,
-     * `index.ts`, `server.ts` — first hit wins.
-     */
-    entry?: string;
-    /**
-     * Preferred port. When taken, the next free port upward is used (and the
-     * substitution logged).
-     *
-     * @defaultValue The `PORT` environment variable, else `3000`.
-     */
-    port?: number;
-    /**
-     * Interface address to bind — `"0.0.0.0"` exposes the dev server to the
-     * local network (phones, containers, teammates); the default keeps it
-     * machine-local. Printed and auto-opened URLs use `localhost` for
-     * loopback/wildcard binds and the given host verbatim otherwise.
-     *
-     * Localhost-class binds get DNS-rebinding protection: every request's
-     * `Host` is validated (plus the active tunnel hostname); `Origin` only on
-     * non-GET/HEAD. Non-localhost binds skip validation — the legitimate
-     * hostnames are unknowable here — and log a warning instead.
-     *
-     * @defaultValue `"127.0.0.1"` (matching the server's localhost-first posture).
-     */
-    host?: string;
-    /**
-     * Abort signal for embedding and tests: aborting shuts the dev process
-     * down gracefully (same path as SIGINT/SIGTERM). The CLI itself does not
-     * pass this.
-     */
-    signal?: AbortSignal;
-    /**
-     * When `true`, start a public tunnel as soon as the HTTP listener is bound
-     * (same as the inspector "Start Tunnel" control, but at startup).
-     *
-     * @defaultValue `false`
-     */
-    tunnel?: boolean;
-    /**
-     * Auto-open the inspector in the default browser once the listener is
-     * bound (`--no-open` sets this to `false`). Opening is additionally
-     * skipped when stdout is not a TTY — agents and CI never get a spurious
-     * browser launch or a "failed to open" error.
-     *
-     * @defaultValue `true`
-     */
-    open?: boolean;
-}
-/**
- * Run the dev server: import the entry through Vite's module runner (full
- * TS/alias support), serve `server.getHandler()` on one long-lived HTTP
- * listener, and swap the handler on file change.
- *
- * A throwing re-import keeps the previous handler alive and prints the error
- * — the dev process never crashes on a bad save. `.env` (if present) is
- * loaded from `cwd` via `process.loadEnvFile()` before the entry is first
- * imported.
- *
- * The returned promise resolves after a graceful shutdown (SIGINT/SIGTERM or
- * `options.signal` aborting).
- *
- * @param options - Project root, optional entry override, port and host.
- * @throws If no entry is found, if the initial import fails, if the entry's
- * default export is not an `MCPServer` (see the entry contract in
- * CLI_SPEC.md), or if `vite` is not installed (`mcp-use dev` requires it as a
- * devDependency).
- *
- * @internal Reached only via the bin's dedicated dev command chunk — not
- * re-exported from the package's "." entry.
- */
-export declare function runDev(options: DevOptions): Promise<void>;
-//# sourceMappingURL=dev.d.ts.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"dev.d.ts","sourceRoot":"","sources":["../../src/cli/dev.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAyDH;;;;GAIG;AACH,MAAM,WAAW,UAAU;IACzB,yCAAyC;IACzC,GAAG,EAAE,MAAM,CAAC;IACZ;;;;;OAKG;IACH,KAAK,CAAC,EAAE,MAAM,CAAC;IACf;;;;;OAKG;IACH,IAAI,CAAC,EAAE,MAAM,CAAC;IACd;;;;;;;;;;;;OAYG;IACH,IAAI,CAAC,EAAE,MAAM,CAAC;IACd;;;;OAIG;IACH,MAAM,CAAC,EAAE,WAAW,CAAC;IACrB;;;;;OAKG;IACH,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB;;;;;;;OAOG;IACH,IAAI,CAAC,EAAE,OAAO,CAAC;CAChB;AAwID;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,wBAAsB,MAAM,CAAC,OAAO,EAAE,UAAU,GAAG,OAAO,CAAC,IAAI,CAAC,CAgc/D"}

package/dist/cli/entry.d.ts

@@ -1,31 +0,0 @@
-/**
- * Server-entry discovery for `mcp-use build` and `mcp-use dev`.
- *
- * The entry contract (CLI_SPEC.md): the user's entry module default-exports
- * the `MCPServer` instance and never calls `listen()` itself — the CLI owns
- * the socket.
- */
-/**
- * Conventional entry locations, checked in order relative to the project
- * root; the first existing file wins.
- *
- * @internal
- */
-export declare const ENTRY_CANDIDATES: readonly ["src/index.ts", "src/server.ts", "index.ts", "server.ts"];
-/**
- * Locate the server entry for a project.
- *
- * With `override` set (the `--entry` flag), the path is resolved against
- * `cwd` and must exist. Otherwise the {@link ENTRY_CANDIDATES} are probed in
- * order and the first hit wins.
- *
- * @param cwd - Absolute path to the project root.
- * @param override - Explicit entry path (`--entry`), absolute or relative to `cwd`.
- * @returns Absolute path to the entry file.
- * @throws If the override does not exist, or no conventional candidate is
- * found — the error lists every location that was checked.
- *
- * @internal
- */
-export declare function discoverEntry(cwd: string, override?: string): string;
-//# sourceMappingURL=entry.d.ts.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"entry.d.ts","sourceRoot":"","sources":["../../src/cli/entry.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAKH;;;;;GAKG;AACH,eAAO,MAAM,gBAAgB,YAC3B,cAAc,EACd,eAAe,EACf,UAAU,EACV,WAAW,CACH,CAAC;AAEX;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,aAAa,CAAC,GAAG,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,MAAM,GAAG,MAAM,CAoBpE"}

package/dist/cli/index.d.ts

@@ -1,17 +0,0 @@
-/**
- * The `mcp-use` dev/build toolchain, built on Vite.
- *
- * Shared source exports for CLI tests and internal tooling. The published bin
- * dispatches `dev` and `build` through separate `src/commands/*` entries so
- * neither command, production startup, nor library imports evaluate unrelated
- * Vite code.
- *
- * @packageDocumentation
- */
-export { runBuild, type BuildOptions } from "./build.js";
-export { runDev, type DevOptions } from "./dev.js";
-export { discoverEntry, ENTRY_CANDIDATES } from "./entry.js";
-export { resolvePort, type ResolvedPort } from "./port.js";
-export { discoverViews, type DiscoveredView } from "./views.js";
-export { BUILD_MANIFEST_NAME, WORKSPACE_DIR_NAME, resolveWorkspacePaths, type BuildManifest, type WorkspacePaths, } from "./workspace.js";
-//# sourceMappingURL=index.d.ts.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/cli/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,EAAE,QAAQ,EAAE,KAAK,YAAY,EAAE,MAAM,YAAY,CAAC;AACzD,OAAO,EAAE,MAAM,EAAE,KAAK,UAAU,EAAE,MAAM,UAAU,CAAC;AACnD,OAAO,EAAE,aAAa,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AAC7D,OAAO,EAAE,WAAW,EAAE,KAAK,YAAY,EAAE,MAAM,WAAW,CAAC;AAC3D,OAAO,EAAE,aAAa,EAAE,KAAK,cAAc,EAAE,MAAM,YAAY,CAAC;AAChE,OAAO,EACL,mBAAmB,EACnB,kBAAkB,EAClB,qBAAqB,EACrB,KAAK,aAAa,EAClB,KAAK,cAAc,GACpB,MAAM,gBAAgB,CAAC"}

package/dist/cli/port.d.ts

@@ -1,30 +0,0 @@
-/**
- * Port resolution for `mcp-use dev`: `--port`, else `PORT` env, else 3000 — probing
- * upward when the requested port is taken.
- */
-/**
- * Outcome of {@link resolvePort}.
- *
- * @internal
- */
-export interface ResolvedPort {
-    /** The free port to bind. */
-    port: number;
-    /** The port that was originally requested (differs when probing moved on). */
-    requested: number;
-}
-/**
- * Resolve the port to bind: take `requested` (already reduced from
- * `--port` / `PORT` / the default by the caller) and probe upward until a
- * free port is found.
- *
- * @param requested - The preferred port.
- * @param host - The host the server will bind (probing binds the same host).
- * @returns The first free port at or above `requested`, plus the original
- * request so callers can log the substitution.
- * @throws If no free port is found within {@link MAX_PROBES} attempts.
- *
- * @internal
- */
-export declare function resolvePort(requested: number, host: string): Promise<ResolvedPort>;
-//# sourceMappingURL=port.d.ts.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"port.d.ts","sourceRoot":"","sources":["../../src/cli/port.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAOH;;;;GAIG;AACH,MAAM,WAAW,YAAY;IAC3B,6BAA6B;IAC7B,IAAI,EAAE,MAAM,CAAC;IACb,8EAA8E;IAC9E,SAAS,EAAE,MAAM,CAAC;CACnB;AAcD;;;;;;;;;;;;GAYG;AACH,wBAAsB,WAAW,CAC/B,SAAS,EAAE,MAAM,EACjB,IAAI,EAAE,MAAM,GACX,OAAO,CAAC,YAAY,CAAC,CASvB"}

package/dist/cli/tools-declaration.d.ts

@@ -1,22 +0,0 @@
-/**
- * Root-level tool registry declaration shared by `mcp-use dev` and
- * `mcp-use build`.
- *
- * The file contains no generated tool names. It creates a live type-only edge
- * to the user's server entry, so exported `ToolRef`s update in TypeScript
- * without rerunning the CLI.
- */
-/** Filename of the project-owned tool registry declaration. */
-export declare const TOOLS_DECLARATION_NAME = "tools.d.ts";
-/** Build the stable declaration contents for a discovered server entry. */
-export declare function renderToolsDeclaration(cwd: string, entry: string): string;
-/**
- * Create the root `tools.d.ts` if absent.
- *
- * Exclusive-create mode makes this safe when dev and build start together and
- * guarantees that a user-authored declaration is never truncated or replaced.
- *
- * @returns `true` when this invocation created the file.
- */
-export declare function ensureToolsDeclaration(cwd: string, entry: string): Promise<boolean>;
-//# sourceMappingURL=tools-declaration.d.ts.map

package/dist/cli/tools-declaration.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"tools-declaration.d.ts","sourceRoot":"","sources":["../../src/cli/tools-declaration.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAKH,+DAA+D;AAC/D,eAAO,MAAM,sBAAsB,eAAe,CAAC;AAoBnD,2EAA2E;AAC3E,wBAAgB,sBAAsB,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,CAazE;AAED;;;;;;;GAOG;AACH,wBAAsB,sBAAsB,CAC1C,GAAG,EAAE,MAAM,EACX,KAAK,EAAE,MAAM,GACZ,OAAO,CAAC,OAAO,CAAC,CAmBlB"}

package/dist/cli/tunnel.d.ts

@@ -1,46 +0,0 @@
-/**
- * Tunnel lifecycle for `mcp-use dev` — spawns `@mcp-use/tunnel`,
- * parses the public URL from stdout, persists the subdomain under
- * `.mcp-use/state/tunnel.json`, and releases it through the tunnel API before
- * reuse.
- */
-/**
- * Base URL of the tunnel API (subdomain reservation/release). Overridable via
- * the `MCP_USE_TUNNEL_API` environment variable.
- */
-export declare function tunnelApiBase(): string;
-/**
- * Minimal tunnel manager surface used by {@link createDevApiHandler} and
- * {@link runDev}.
- */
-export interface TunnelManager {
-    /**
-     * Start (or attach) a tunnel targeting `port` and return the public origin
-     * URL and assigned subdomain.
-     */
-    start(port: number): Promise<{
-        url: string;
-        subdomain: string;
-    }>;
-    /** Stop the tunnel child process and release the subdomain. */
-    stop(): Promise<void>;
-    /** Current tunnel public origin URL, or `null` when no tunnel is active. */
-    status(): {
-        url: string | null;
-    };
-}
-/**
- * Create a tunnel manager that reads and writes subdomain state at
- * `stateFilePath` (typically `.mcp-use/state/tunnel.json`).
- *
- * @param stateFilePath - Absolute path to the tunnel state JSON file.
- *
- * @example
- * ```ts
- * const tunnel = createTunnelManager(paths.tunnel);
- * const { url } = await tunnel.start(3000);
- * console.log(url); // https://happy-cat.local.mcp-use.run
- * ```
- */
-export declare function createTunnelManager(stateFilePath: string): TunnelManager;
-//# sourceMappingURL=tunnel.d.ts.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"tunnel.d.ts","sourceRoot":"","sources":["../../src/cli/tunnel.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AASH;;;GAGG;AACH,wBAAgB,aAAa,IAAI,MAAM,CAEtC;AAQD;;;GAGG;AACH,MAAM,WAAW,aAAa;IAC5B;;;OAGG;IACH,KAAK,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC;QAAE,GAAG,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IACjE,+DAA+D;IAC/D,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IACtB,4EAA4E;IAC5E,MAAM,IAAI;QAAE,GAAG,EAAE,MAAM,GAAG,IAAI,CAAA;KAAE,CAAC;CAClC;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,mBAAmB,CAAC,aAAa,EAAE,MAAM,GAAG,aAAa,CA6NxE"}

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

@@ -1,30 +0,0 @@
-/**
- * Build-time view binding validation via mount-time checks.
- */
-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()`.
- *
- * Surfaces the same errors as runtime mount: missing primed view, missing
- * `outputSchema`, double binding. Unbound views emit a warning to stderr.
- *
- * @param environment - Vite SSR environment for module evaluation.
- * @param entry - Absolute path to the user's server entry.
- * @param viewsManifest - Built or dev-shaped manifest to prime.
- * @throws On binding hard errors (naming the view/tool).
- *
- * @internal
- */
-export declare function validateViewBindingsAtBuild(environment: DevEnvironment, entry: string, viewsManifest: ViewsManifest): Promise<void>;
-//# sourceMappingURL=views-bindings.d.ts.map

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

@@ -1 +0,0 @@
-{"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/views-plugin.d.ts

@@ -1,47 +0,0 @@
-/**
- * Vite plugin: virtual view entry modules and optional SSR wrapper entry.
- */
-import type { Plugin } from "vite";
-import type { DiscoveredView } from "./views.js";
-/**
- * Options for {@link mcpUseViewsPlugin}.
- *
- * @internal
- */
-export interface McpUseViewsPluginOptions {
-    /** Static list or live getter (dev rediscovery). */
-    getViews: () => DiscoveredView[];
-    /**
-     * Dev-mode entry shape. When present, every virtual entry self-accepts HMR
-     * updates (`import.meta.hot.accept()`) so an update that propagates past the
-     * view module re-runs the bootstrap instead of full-reloading the iframe
-     * document (which would wipe bridge state). Absent for builds — entries stay
-     * byte-identical to the production contract.
-     */
-    dev?: {
-        /**
-         * Whether React Fast Refresh is active (`@vitejs/plugin-react` resolved).
-         * When `true`, entries import the plugin's virtual refresh preamble
-         * (`@vitejs/plugin-react/preamble`) before any component module so the
-         * refresh runtime hooks the document — the role `transformIndexHtml`
-         * plays for Vite-served HTML, which synthesized srcdoc documents never
-         * pass through.
-         */
-        reactRefresh: boolean;
-    };
-}
-/**
- * Vite plugin that resolves `virtual:mcp-use/views/<name>` to bootstrap code.
- *
- * Applies only to the **client** environment.
- *
- * @internal
- */
-export declare function mcpUseViewsPlugin(options: McpUseViewsPluginOptions): Plugin;
-/**
- * Rollup input map for a client views build (one entry per view).
- *
- * @internal
- */
-export declare function clientBuildInputs(views: DiscoveredView[]): Record<string, string>;
-//# sourceMappingURL=views-plugin.d.ts.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"views-plugin.d.ts","sourceRoot":"","sources":["../../src/cli/views-plugin.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,MAAM,CAAC;AAEnC,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAUjD;;;;GAIG;AACH,MAAM,WAAW,wBAAwB;IACvC,oDAAoD;IACpD,QAAQ,EAAE,MAAM,cAAc,EAAE,CAAC;IACjC;;;;;;OAMG;IACH,GAAG,CAAC,EAAE;QACJ;;;;;;;WAOG;QACH,YAAY,EAAE,OAAO,CAAC;KACvB,CAAC;CACH;AAED;;;;;;GAMG;AACH,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,wBAAwB,GAAG,MAAM,CAmD3E;AAED;;;;GAIG;AACH,wBAAgB,iBAAiB,CAC/B,KAAK,EAAE,cAAc,EAAE,GACtB,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAMxB"}