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

package/dist/oauth/better-auth.js.map

@@ -1 +0,0 @@
-{"version":3,"sources":["../../src/oauth/better-auth.ts"],"sourcesContent":["import type { AuthInfo, OAuthMetadata } from \"@modelcontextprotocol/server\";\n\nimport {\n  booleanValue,\n  createJwtVerifier,\n  invalidToken,\n  normalizedStrings,\n  normalizedProviderUrl,\n  payloadFromAuthInfo,\n  providerEndpoint,\n  requiredString,\n  stringValue,\n} from \"./jwt.js\";\nimport {\n  oauthCustomProvider,\n  type OAuthProvider,\n  type OAuthResourceOptions,\n} from \"./provider.js\";\n\n/** Verified Better Auth claims exposed to authenticated MCP callbacks. */\nexport interface BetterAuthOAuthUser {\n  id: string;\n  email?: string;\n  name?: string;\n  picture?: string;\n  emailVerified?: boolean;\n  sessionId?: string;\n  isAnonymous?: boolean;\n  roles: string[];\n}\n\n/** Configures Better Auth JWT verification and protected-resource metadata. */\nexport interface BetterAuthOAuthProviderOptions extends OAuthResourceOptions {\n  /** Full Better Auth issuer URL, including its base path. */\n  authURL: URL | string;\n}\n\n/**\n * Creates a provider for Better Auth's OAuth 2.1 Provider plugin.\n *\n * Better Auth owns registration, authorization, consent, and token issuance.\n * mcp-use advertises those endpoints and verifies the resulting access-token\n * JWTs against Better Auth's JWKS endpoint.\n *\n * @param options - Better Auth issuer URL and resource-server settings.\n * @returns A provider that rejects tokens not issued for the resolved MCP resource.\n */\nexport function oauthBetterAuthProvider(\n  options: BetterAuthOAuthProviderOptions\n): OAuthProvider<BetterAuthOAuthUser> {\n  const issuer = normalizedProviderUrl(\n    options.authURL,\n    \"Better Auth authURL\"\n  ).href.replace(/\\/$/, \"\");\n\n  return oauthCustomProvider<BetterAuthOAuthUser>({\n    ...options,\n    createTokenVerifier: (resource) =>\n      createJwtVerifier({\n        issuer,\n        jwksUrl: new URL(providerEndpoint(issuer, \"jwks\")),\n        resource,\n      }),\n    oauthMetadata: metadata(issuer, options.scopesSupported),\n    mapAuthInfo: mapUser,\n  });\n}\n\nfunction metadata(\n  issuer: string,\n  scopesSupported: readonly string[] | undefined\n): OAuthMetadata {\n  return {\n    issuer,\n    authorization_endpoint: providerEndpoint(issuer, \"oauth2/authorize\"),\n    token_endpoint: providerEndpoint(issuer, \"oauth2/token\"),\n    registration_endpoint: providerEndpoint(issuer, \"oauth2/register\"),\n    jwks_uri: providerEndpoint(issuer, \"jwks\"),\n    response_types_supported: [\"code\"],\n    grant_types_supported: [\n      \"authorization_code\",\n      \"client_credentials\",\n      \"refresh_token\",\n    ],\n    code_challenge_methods_supported: [\"S256\"],\n    scopes_supported:\n      scopesSupported === undefined\n        ? [\"openid\", \"profile\", \"email\", \"offline_access\"]\n        : [...scopesSupported],\n  };\n}\n\nfunction mapUser(authInfo: AuthInfo) {\n  const payload = payloadFromAuthInfo(authInfo);\n  const id = requiredString(payload, \"sub\");\n  if (id === undefined) throw invalidToken(\"Missing Better Auth subject\");\n\n  return {\n    user: {\n      id,\n      ...optional(\"email\", stringValue(payload, \"email\")),\n      ...optional(\"name\", stringValue(payload, \"name\")),\n      ...optional(\"picture\", stringValue(payload, \"picture\")),\n      ...optional(\"emailVerified\", booleanValue(payload, \"email_verified\")),\n      ...optional(\"sessionId\", stringValue(payload, \"sid\")),\n      ...optional(\n        \"isAnonymous\",\n        booleanValue(payload, \"is_anonymous\") ??\n          booleanValue(payload, \"isAnonymous\")\n      ),\n      roles: normalizedStrings(payload[\"roles\"]),\n    },\n    payload,\n    permissions: normalizedStrings(payload[\"permissions\"]),\n  };\n}\n\nfunction optional<T>(key: string, value: T | undefined): Record<string, T> {\n  return value === undefined ? {} : { [key]: value };\n}\n"],"mappings":";;;;;;;;;;;;;;AA+CO,SAAS,wBACd,SACoC;AACpC,QAAM,SAAS;AAAA,IACb,QAAQ;AAAA,IACR;AAAA,EACF,EAAE,KAAK,QAAQ,OAAO,EAAE;AAExB,SAAO,oBAAyC;AAAA,IAC9C,GAAG;AAAA,IACH,qBAAqB,CAAC,aACpB,kBAAkB;AAAA,MAChB;AAAA,MACA,SAAS,IAAI,IAAI,iBAAiB,QAAQ,MAAM,CAAC;AAAA,MACjD;AAAA,IACF,CAAC;AAAA,IACH,eAAe,SAAS,QAAQ,QAAQ,eAAe;AAAA,IACvD,aAAa;AAAA,EACf,CAAC;AACH;AAEA,SAAS,SACP,QACA,iBACe;AACf,SAAO;AAAA,IACL;AAAA,IACA,wBAAwB,iBAAiB,QAAQ,kBAAkB;AAAA,IACnE,gBAAgB,iBAAiB,QAAQ,cAAc;AAAA,IACvD,uBAAuB,iBAAiB,QAAQ,iBAAiB;AAAA,IACjE,UAAU,iBAAiB,QAAQ,MAAM;AAAA,IACzC,0BAA0B,CAAC,MAAM;AAAA,IACjC,uBAAuB;AAAA,MACrB;AAAA,MACA;AAAA,MACA;AAAA,IACF;AAAA,IACA,kCAAkC,CAAC,MAAM;AAAA,IACzC,kBACE,oBAAoB,SAChB,CAAC,UAAU,WAAW,SAAS,gBAAgB,IAC/C,CAAC,GAAG,eAAe;AAAA,EAC3B;AACF;AAEA,SAAS,QAAQ,UAAoB;AACnC,QAAM,UAAU,oBAAoB,QAAQ;AAC5C,QAAM,KAAK,eAAe,SAAS,KAAK;AACxC,MAAI,OAAO,OAAW,OAAM,aAAa,6BAA6B;AAEtE,SAAO;AAAA,IACL,MAAM;AAAA,MACJ;AAAA,MACA,GAAG,SAAS,SAAS,YAAY,SAAS,OAAO,CAAC;AAAA,MAClD,GAAG,SAAS,QAAQ,YAAY,SAAS,MAAM,CAAC;AAAA,MAChD,GAAG,SAAS,WAAW,YAAY,SAAS,SAAS,CAAC;AAAA,MACtD,GAAG,SAAS,iBAAiB,aAAa,SAAS,gBAAgB,CAAC;AAAA,MACpE,GAAG,SAAS,aAAa,YAAY,SAAS,KAAK,CAAC;AAAA,MACpD,GAAG;AAAA,QACD;AAAA,QACA,aAAa,SAAS,cAAc,KAClC,aAAa,SAAS,aAAa;AAAA,MACvC;AAAA,MACA,OAAO,kBAAkB,QAAQ,OAAO,CAAC;AAAA,IAC3C;AAAA,IACA;AAAA,IACA,aAAa,kBAAkB,QAAQ,aAAa,CAAC;AAAA,EACvD;AACF;AAEA,SAAS,SAAY,KAAa,OAAyC;AACzE,SAAO,UAAU,SAAY,CAAC,IAAI,EAAE,CAAC,GAAG,GAAG,MAAM;AACnD;","names":[]}

package/dist/proxy-DJYWGTGX.js

@@ -1,282 +0,0 @@
-// src/proxy.ts
-var PROXY_CLIENT_INSTALL_HINT = [
-  "[mcp-use] server.proxy() requires the optional @mcp-use/client package.",
-  "Install it in your project:",
-  "",
-  "  npm install @mcp-use/client"
-].join("\n");
-function passthroughJsonSchema(schema) {
-  return {
-    "~standard": {
-      version: 1,
-      vendor: "mcp-use-proxy",
-      validate(value) {
-        return { value };
-      },
-      jsonSchema: {
-        input: () => schema,
-        output: () => schema
-      }
-    }
-  };
-}
-function promptArgsToJsonSchema(args) {
-  const properties = /* @__PURE__ */ Object.create(null);
-  const required = [];
-  for (const arg of args ?? []) {
-    properties[arg.name] = {
-      type: "string",
-      ...arg.description !== void 0 && { description: arg.description }
-    };
-    if (arg.required === true) required.push(arg.name);
-  }
-  return {
-    type: "object",
-    properties,
-    ...required.length > 0 && { required }
-  };
-}
-function prefixedName(namespace, name) {
-  return `${namespace}_${name}`;
-}
-function proxiedResourceUri(namespace, uri) {
-  return `mcp-use-proxy:///${encodeURIComponent(namespace)}/${encodeURIComponent(uri)}`;
-}
-function isConnection(value) {
-  if (value === null || typeof value !== "object") return false;
-  const candidate = value;
-  return typeof candidate.listTools === "function" && typeof candidate.callTool === "function" && typeof candidate.readResource === "function" && typeof candidate.listPrompts === "function" && typeof candidate.getPrompt === "function";
-}
-function isClientPackageMissing(error) {
-  if (!(error instanceof Error)) return false;
-  const code = error.code;
-  return (code === "ERR_MODULE_NOT_FOUND" || code === "MODULE_NOT_FOUND") && error.message.includes("@mcp-use/client");
-}
-function proxyDiagnostic(message, error) {
-  if (error === void 0) {
-    console.error(`[mcp-use] ${message}`);
-    return;
-  }
-  const detail = error instanceof Error ? error.message : String(error);
-  console.error(`[mcp-use] ${message}: ${detail}`);
-}
-function proxyClientInstallError(error) {
-  return isClientPackageMissing(error) ? new Error(PROXY_CLIENT_INSTALL_HINT, { cause: error }) : void 0;
-}
-async function loadProxyClient(importer = () => import("@mcp-use/client")) {
-  try {
-    return await importer();
-  } catch (error) {
-    const installError = proxyClientInstallError(error);
-    if (installError !== void 0) throw installError;
-    throw error;
-  }
-}
-function supports(connection, capability) {
-  return connection.supports?.(capability) !== false;
-}
-async function introspect(namespace, connection) {
-  let tools = [];
-  if (supports(connection, "tools")) {
-    try {
-      tools = await connection.listTools();
-    } catch (error) {
-      proxyDiagnostic(
-        `Failed to introspect tools from upstream MCP server "${namespace}"`,
-        error
-      );
-    }
-  }
-  let resources = [];
-  if (supports(connection, "resources")) {
-    try {
-      if (connection.listAllResources !== void 0) {
-        resources = (await connection.listAllResources()).resources;
-      } else if (connection.listResources !== void 0) {
-        resources = (await connection.listResources()).resources;
-      }
-    } catch (error) {
-      proxyDiagnostic(
-        `Failed to introspect resources from upstream MCP server "${namespace}"`,
-        error
-      );
-    }
-  }
-  let prompts = [];
-  if (supports(connection, "prompts")) {
-    try {
-      prompts = (await connection.listPrompts()).prompts;
-    } catch (error) {
-      proxyDiagnostic(
-        `Failed to introspect prompts from upstream MCP server "${namespace}"`,
-        error
-      );
-    }
-  }
-  return { namespace, connection, tools, resources, prompts };
-}
-function mountPlan(host, plan) {
-  for (const tool of plan.tools) {
-    const name = prefixedName(plan.namespace, tool.name);
-    if (host.hasTool(name)) {
-      proxyDiagnostic(
-        `Skipping proxied tool "${name}" from upstream "${plan.namespace}" because that name is already registered`
-      );
-      continue;
-    }
-    const definition = {
-      name,
-      ...tool.title !== void 0 && { title: tool.title },
-      ...tool.description !== void 0 && { description: tool.description },
-      ...tool.annotations !== void 0 && { annotations: tool.annotations },
-      ...tool.inputSchema !== void 0 && {
-        inputSchema: passthroughJsonSchema(tool.inputSchema)
-      },
-      ...tool.outputSchema !== void 0 && {
-        outputSchema: passthroughJsonSchema(tool.outputSchema)
-      }
-    };
-    const upstreamName = tool.name;
-    const callback = async (params, ctx) => {
-      let progressForwarding = Promise.resolve();
-      try {
-        return await plan.connection.callTool(upstreamName, params, {
-          signal: ctx.signal,
-          onprogress: (progress) => {
-            progressForwarding = progressForwarding.then(async () => {
-              try {
-                await ctx.reportProgress(
-                  progress.progress,
-                  progress.total,
-                  progress.message
-                );
-              } catch (error) {
-                proxyDiagnostic(
-                  `Failed to forward progress for proxied tool "${definition.name}"`,
-                  error
-                );
-              }
-            });
-          }
-        });
-      } finally {
-        await progressForwarding;
-      }
-    };
-    host.registerTool(definition, callback);
-  }
-  for (const resource of plan.resources) {
-    const name = prefixedName(plan.namespace, resource.name);
-    if (host.hasResource(name)) {
-      proxyDiagnostic(
-        `Skipping proxied resource "${name}" from upstream "${plan.namespace}" because that name is already registered`
-      );
-      continue;
-    }
-    const upstreamUri = resource.uri;
-    host.registerResource(
-      {
-        name,
-        uri: proxiedResourceUri(plan.namespace, upstreamUri),
-        ...resource.title !== void 0 && { title: resource.title },
-        ...resource.description !== void 0 && {
-          description: resource.description
-        },
-        ...resource.mimeType !== void 0 && {
-          mimeType: resource.mimeType
-        }
-      },
-      async (_uri, ctx) => plan.connection.readResource(upstreamUri, { signal: ctx.signal })
-    );
-  }
-  for (const prompt of plan.prompts) {
-    const name = prefixedName(plan.namespace, prompt.name);
-    if (host.hasPrompt(name)) {
-      proxyDiagnostic(
-        `Skipping proxied prompt "${name}" from upstream "${plan.namespace}" because that name is already registered`
-      );
-      continue;
-    }
-    const upstreamName = prompt.name;
-    host.registerPrompt(
-      {
-        name,
-        ...prompt.title !== void 0 && { title: prompt.title },
-        ...prompt.description !== void 0 && {
-          description: prompt.description
-        },
-        schema: passthroughJsonSchema(promptArgsToJsonSchema(prompt.arguments))
-      },
-      async (params) => plan.connection.getPrompt(upstreamName, params)
-    );
-  }
-}
-async function mountProxyConnection(host, connection) {
-  if (host.isStarted()) {
-    throw new Error(
-      "Cannot call proxy() after the server has started: register upstream servers before listen()/getHandler()."
-    );
-  }
-  const namespace = connection.info.server.name;
-  const plan = await introspect(namespace, connection);
-  mountPlan(host, plan);
-}
-function toClientConfig(config) {
-  return {
-    url: config.url,
-    ...config.headers !== void 0 && { headers: config.headers },
-    ...config.authToken !== void 0 && { authToken: config.authToken },
-    ...config.timeout !== void 0 && { timeout: config.timeout },
-    ...config.fetch !== void 0 && { fetch: config.fetch },
-    ...config.protocolNegotiation !== void 0 && {
-      protocolNegotiation: config.protocolNegotiation
-    },
-    oauth: false
-  };
-}
-async function mountProxyServers(host, servers) {
-  if (host.isStarted()) {
-    throw new Error(
-      "Cannot call proxy() after the server has started: register upstream servers before listen()/getHandler()."
-    );
-  }
-  const { MCPClient } = await loadProxyClient();
-  const clientServers = Object.fromEntries(
-    Object.entries(servers).map(([name, config]) => [
-      name,
-      toClientConfig(config)
-    ])
-  );
-  const owner = new MCPClient({ mcpServers: clientServers });
-  try {
-    const plans = [];
-    for (const namespace of Object.keys(clientServers)) {
-      let connection;
-      try {
-        connection = await owner.connect(namespace);
-      } catch (error) {
-        proxyDiagnostic(
-          `Failed to connect to upstream MCP server "${namespace}"`,
-          error
-        );
-        continue;
-      }
-      plans.push(await introspect(namespace, connection));
-    }
-    for (const plan of plans) mountPlan(host, plan);
-    host.trackOwner(owner);
-  } catch (error) {
-    await owner.close().catch(() => void 0);
-    throw error;
-  }
-}
-function isProxyConnection(value) {
-  return isConnection(value);
-}
-export {
-  isProxyConnection,
-  mountProxyConnection,
-  mountProxyServers,
-  proxyClientInstallError
-};
-//# sourceMappingURL=proxy-DJYWGTGX.js.map

package/dist/proxy-DJYWGTGX.js.map

@@ -1 +0,0 @@
-{"version":3,"sources":["../src/proxy.ts"],"sourcesContent":["import type {\n  CallToolResult,\n  GetPromptResult,\n  InputRequiredResult,\n  JsonSchemaType,\n  PromptArgument,\n  ReadResourceResult,\n  StandardSchemaWithJSON,\n  ToolAnnotations,\n} from \"@modelcontextprotocol/server\";\nimport type {\n  HttpServerConfig as ClientHttpServerConfig,\n  MCPClient as ClientMCPClient,\n  MCPConnection as ClientMCPConnection,\n} from \"@mcp-use/client\";\n\nimport type { RequestContext } from \"./context.js\";\nimport type { PromptCallback, PromptDefinition } from \"./prompts.js\";\nimport type { ResourceCallback, ResourceDefinition } from \"./resources.js\";\nimport type { ToolCallback, ToolDefinition } from \"./tools.js\";\n\n/** HTTP connection settings accepted by {@link MCPServer.proxy}. */\nexport interface ProxyHttpConfig {\n  /** Upstream MCP endpoint URL. */\n  url: string;\n  /** Extra headers sent on every upstream request. */\n  headers?: Record<string, string>;\n  /** Bearer token sent to the upstream server. */\n  authToken?: string;\n  /** Connection timeout in milliseconds. */\n  timeout?: number;\n  /** Fetch implementation used for upstream HTTP requests. */\n  fetch?: typeof fetch;\n  /** Protocol negotiation mode forwarded to `@mcp-use/client`. */\n  protocolNegotiation?: \"auto\" | \"legacy\" | { pin: string };\n}\n\n/** Connection settings for one upstream server. */\nexport type ProxyServerConfig = ProxyHttpConfig;\n\n/** Progress payload received while a proxied tool is running. */\nexport interface ProxyProgress {\n  /** Completed work units. */\n  progress: number;\n  /** Total work units, when known. */\n  total?: number | undefined;\n  /** Human-readable progress detail. */\n  message?: string | undefined;\n}\n\n/** Request controls used when forwarding calls to an upstream connection. */\nexport interface ProxyRequestOptions {\n  /** Aborts the upstream request when the downstream request is cancelled. */\n  signal?: AbortSignal;\n  /** Receives upstream progress notifications. */\n  onprogress?: (progress: ProxyProgress) => void;\n}\n\n/** Structural connection contract accepted by the low-level proxy overload. */\nexport interface ProxyConnection {\n  /** Negotiated metadata used to derive the automatic capability namespace. */\n  readonly info: { server: { name: string } };\n  /** Whether the upstream advertised a named MCP capability. */\n  supports?(capability: string): boolean;\n  /** List upstream tools. */\n  listTools(): Promise<ProxyTool[]>;\n  /** Forward a tool call. */\n  callTool(\n    name: string,\n    args?: Record<string, unknown>,\n    options?: ProxyRequestOptions\n  ): Promise<CallToolResult | InputRequiredResult>;\n  /** List upstream resources, including pagination when supported. */\n  listAllResources?(): Promise<{ resources: ProxyResource[] }>;\n  /** List one page of upstream resources. */\n  listResources?(): Promise<{ resources: ProxyResource[] }>;\n  /** Read an upstream resource. */\n  readResource(\n    uri: string,\n    options?: ProxyRequestOptions\n  ): Promise<ReadResourceResult>;\n  /** List upstream prompts. */\n  listPrompts(): Promise<{ prompts: ProxyPrompt[] }>;\n  /** Render an upstream prompt. */\n  getPrompt(\n    name: string,\n    args: Record<string, unknown>\n  ): Promise<GetPromptResult>;\n}\n\n/** Tool metadata consumed while introspecting an upstream connection. */\nexport interface ProxyTool {\n  /** Upstream tool name. */\n  name: string;\n  /** Human-readable tool title. */\n  title?: string | undefined;\n  /** LLM-facing tool description. */\n  description?: string | undefined;\n  /** Upstream input JSON Schema. */\n  inputSchema?: Record<string, unknown> | undefined;\n  /** Upstream output JSON Schema. */\n  outputSchema?: Record<string, unknown> | undefined;\n  /** Upstream behavioral hints. */\n  annotations?: ToolAnnotations | undefined;\n}\n\n/** Resource metadata consumed while introspecting an upstream connection. */\nexport interface ProxyResource {\n  /** Upstream resource name. */\n  name: string;\n  /** Original upstream resource URI. */\n  uri: string;\n  /** Human-readable resource title. */\n  title?: string | undefined;\n  /** Human-readable resource description. */\n  description?: string | undefined;\n  /** Resource media type. */\n  mimeType?: string | undefined;\n}\n\n/** Prompt metadata consumed while introspecting an upstream connection. */\nexport interface ProxyPrompt {\n  /** Upstream prompt name. */\n  name: string;\n  /** Human-readable prompt title. */\n  title?: string | undefined;\n  /** Human-readable prompt description. */\n  description?: string | undefined;\n  /** String arguments accepted by the prompt. */\n  arguments?: PromptArgument[] | undefined;\n}\n\n/** Registration surface used while mounting proxied capabilities. @internal */\nexport interface ProxyMountHost {\n  /** Whether the parent server has mounted its handler. */\n  isStarted(): boolean;\n  /** Whether a tool name is already registered. */\n  hasTool(name: string): boolean;\n  /** Whether a resource name is already registered. */\n  hasResource(name: string): boolean;\n  /** Whether a prompt name is already registered. */\n  hasPrompt(name: string): boolean;\n  /** Register a proxied tool. */\n  registerTool(definition: ToolDefinition, callback: ToolCallback): void;\n  /** Register a proxied resource. */\n  registerResource(\n    definition: ResourceDefinition,\n    callback: ResourceCallback\n  ): void;\n  /** Register a proxied prompt. */\n  registerPrompt(definition: PromptDefinition, callback: PromptCallback): void;\n  /** Track a proxy client owned by the parent server. */\n  trackOwner(owner: { close(): Promise<void> }): void;\n}\n\ninterface ProxyNamespacePlan {\n  namespace: string;\n  connection: ProxyConnection;\n  tools: ProxyTool[];\n  resources: ProxyResource[];\n  prompts: ProxyPrompt[];\n}\n\ninterface ProxyClientPackage {\n  MCPClient: typeof ClientMCPClient;\n}\n\ntype Assert<T extends true> = T;\ntype _ProxyConfigMatchesClient = Assert<\n  ProxyServerConfig extends ClientHttpServerConfig ? true : false\n>;\ntype _ClientConnectionMatchesProxy = Assert<\n  ClientMCPConnection extends ProxyConnection ? true : false\n>;\n\nconst PROXY_CLIENT_INSTALL_HINT = [\n  \"[mcp-use] server.proxy() requires the optional @mcp-use/client package.\",\n  \"Install it in your project:\",\n  \"\",\n  \"  npm install @mcp-use/client\",\n].join(\"\\n\");\n\nfunction passthroughJsonSchema(\n  schema: Record<string, unknown>\n): StandardSchemaWithJSON<Record<string, unknown>, Record<string, unknown>> {\n  return {\n    \"~standard\": {\n      version: 1,\n      vendor: \"mcp-use-proxy\",\n      validate(value) {\n        return { value: value as Record<string, unknown> };\n      },\n      jsonSchema: {\n        input: () => schema as JsonSchemaType,\n        output: () => schema as JsonSchemaType,\n      },\n    },\n  };\n}\n\nfunction promptArgsToJsonSchema(\n  args: PromptArgument[] | undefined\n): JsonSchemaType {\n  const properties = Object.create(null) as Record<string, JsonSchemaType>;\n  const required: string[] = [];\n  for (const arg of args ?? []) {\n    properties[arg.name] = {\n      type: \"string\",\n      ...(arg.description !== undefined && { description: arg.description }),\n    };\n    if (arg.required === true) required.push(arg.name);\n  }\n  return {\n    type: \"object\",\n    properties,\n    ...(required.length > 0 && { required }),\n  };\n}\n\nfunction prefixedName(namespace: string, name: string): string {\n  return `${namespace}_${name}`;\n}\n\nfunction proxiedResourceUri(namespace: string, uri: string): string {\n  return `mcp-use-proxy:///${encodeURIComponent(namespace)}/${encodeURIComponent(uri)}`;\n}\n\nfunction isConnection(value: unknown): value is ProxyConnection {\n  if (value === null || typeof value !== \"object\") return false;\n  const candidate = value as Partial<ProxyConnection>;\n  return (\n    typeof candidate.listTools === \"function\" &&\n    typeof candidate.callTool === \"function\" &&\n    typeof candidate.readResource === \"function\" &&\n    typeof candidate.listPrompts === \"function\" &&\n    typeof candidate.getPrompt === \"function\"\n  );\n}\n\nfunction isClientPackageMissing(error: unknown): boolean {\n  if (!(error instanceof Error)) return false;\n  const code = (error as NodeJS.ErrnoException).code;\n  return (\n    (code === \"ERR_MODULE_NOT_FOUND\" || code === \"MODULE_NOT_FOUND\") &&\n    error.message.includes(\"@mcp-use/client\")\n  );\n}\n\nfunction proxyDiagnostic(message: string, error?: unknown): void {\n  if (error === undefined) {\n    console.error(`[mcp-use] ${message}`);\n    return;\n  }\n  const detail = error instanceof Error ? error.message : String(error);\n  console.error(`[mcp-use] ${message}: ${detail}`);\n}\n\n/** Convert a missing optional-client import into the proxy install error. @internal */\nexport function proxyClientInstallError(error: unknown): Error | undefined {\n  return isClientPackageMissing(error)\n    ? new Error(PROXY_CLIENT_INSTALL_HINT, { cause: error })\n    : undefined;\n}\n\nasync function loadProxyClient(\n  importer: () => Promise<unknown> = () => import(\"@mcp-use/client\")\n): Promise<ProxyClientPackage> {\n  try {\n    return (await importer()) as ProxyClientPackage;\n  } catch (error) {\n    const installError = proxyClientInstallError(error);\n    if (installError !== undefined) throw installError;\n    throw error;\n  }\n}\n\nfunction supports(\n  connection: ProxyConnection,\n  capability: \"tools\" | \"resources\" | \"prompts\"\n): boolean {\n  return connection.supports?.(capability) !== false;\n}\n\nasync function introspect(\n  namespace: string,\n  connection: ProxyConnection\n): Promise<ProxyNamespacePlan> {\n  let tools: ProxyTool[] = [];\n  if (supports(connection, \"tools\")) {\n    try {\n      tools = await connection.listTools();\n    } catch (error) {\n      proxyDiagnostic(\n        `Failed to introspect tools from upstream MCP server \"${namespace}\"`,\n        error\n      );\n    }\n  }\n\n  let resources: ProxyResource[] = [];\n  if (supports(connection, \"resources\")) {\n    try {\n      if (connection.listAllResources !== undefined) {\n        resources = (await connection.listAllResources()).resources;\n      } else if (connection.listResources !== undefined) {\n        resources = (await connection.listResources()).resources;\n      }\n    } catch (error) {\n      proxyDiagnostic(\n        `Failed to introspect resources from upstream MCP server \"${namespace}\"`,\n        error\n      );\n    }\n  }\n\n  let prompts: ProxyPrompt[] = [];\n  if (supports(connection, \"prompts\")) {\n    try {\n      prompts = (await connection.listPrompts()).prompts;\n    } catch (error) {\n      proxyDiagnostic(\n        `Failed to introspect prompts from upstream MCP server \"${namespace}\"`,\n        error\n      );\n    }\n  }\n\n  return { namespace, connection, tools, resources, prompts };\n}\n\nfunction mountPlan(host: ProxyMountHost, plan: ProxyNamespacePlan): void {\n  for (const tool of plan.tools) {\n    const name = prefixedName(plan.namespace, tool.name);\n    if (host.hasTool(name)) {\n      proxyDiagnostic(\n        `Skipping proxied tool \"${name}\" from upstream \"${plan.namespace}\" because that name is already registered`\n      );\n      continue;\n    }\n    const definition: ToolDefinition = {\n      name,\n      ...(tool.title !== undefined && { title: tool.title }),\n      ...(tool.description !== undefined && { description: tool.description }),\n      ...(tool.annotations !== undefined && { annotations: tool.annotations }),\n      ...(tool.inputSchema !== undefined && {\n        inputSchema: passthroughJsonSchema(tool.inputSchema),\n      }),\n      ...(tool.outputSchema !== undefined && {\n        outputSchema: passthroughJsonSchema(tool.outputSchema),\n      }),\n    };\n    const upstreamName = tool.name;\n    const callback = async (\n      params: Record<string, unknown>,\n      ctx: RequestContext\n    ) => {\n      let progressForwarding = Promise.resolve();\n      try {\n        return await plan.connection.callTool(upstreamName, params, {\n          signal: ctx.signal,\n          onprogress: (progress) => {\n            progressForwarding = progressForwarding.then(async () => {\n              try {\n                await ctx.reportProgress(\n                  progress.progress,\n                  progress.total,\n                  progress.message\n                );\n              } catch (error) {\n                proxyDiagnostic(\n                  `Failed to forward progress for proxied tool \"${definition.name}\"`,\n                  error\n                );\n              }\n            });\n          },\n        });\n      } finally {\n        await progressForwarding;\n      }\n    };\n    host.registerTool(definition, callback as ToolCallback);\n  }\n\n  for (const resource of plan.resources) {\n    const name = prefixedName(plan.namespace, resource.name);\n    if (host.hasResource(name)) {\n      proxyDiagnostic(\n        `Skipping proxied resource \"${name}\" from upstream \"${plan.namespace}\" because that name is already registered`\n      );\n      continue;\n    }\n    const upstreamUri = resource.uri;\n    host.registerResource(\n      {\n        name,\n        uri: proxiedResourceUri(plan.namespace, upstreamUri),\n        ...(resource.title !== undefined && { title: resource.title }),\n        ...(resource.description !== undefined && {\n          description: resource.description,\n        }),\n        ...(resource.mimeType !== undefined && {\n          mimeType: resource.mimeType,\n        }),\n      },\n      async (_uri, ctx) =>\n        plan.connection.readResource(upstreamUri, { signal: ctx.signal })\n    );\n  }\n\n  for (const prompt of plan.prompts) {\n    const name = prefixedName(plan.namespace, prompt.name);\n    if (host.hasPrompt(name)) {\n      proxyDiagnostic(\n        `Skipping proxied prompt \"${name}\" from upstream \"${plan.namespace}\" because that name is already registered`\n      );\n      continue;\n    }\n    const upstreamName = prompt.name;\n    host.registerPrompt(\n      {\n        name,\n        ...(prompt.title !== undefined && { title: prompt.title }),\n        ...(prompt.description !== undefined && {\n          description: prompt.description,\n        }),\n        schema: passthroughJsonSchema(promptArgsToJsonSchema(prompt.arguments)),\n      },\n      async (params) => plan.connection.getPrompt(upstreamName, params)\n    );\n  }\n}\n\n/**\n * Mount one existing upstream connection on a parent server.\n *\n * @param host - Parent server registration surface.\n * @param connection - Ready `@mcp-use/client` v2 connection.\n * @internal\n */\nexport async function mountProxyConnection(\n  host: ProxyMountHost,\n  connection: ProxyConnection\n): Promise<void> {\n  if (host.isStarted()) {\n    throw new Error(\n      \"Cannot call proxy() after the server has started: register upstream servers before listen()/getHandler().\"\n    );\n  }\n  const namespace = connection.info.server.name;\n  const plan = await introspect(namespace, connection);\n  mountPlan(host, plan);\n}\n\nfunction toClientConfig(config: ProxyServerConfig): ClientHttpServerConfig {\n  return {\n    url: config.url,\n    ...(config.headers !== undefined && { headers: config.headers }),\n    ...(config.authToken !== undefined && { authToken: config.authToken }),\n    ...(config.timeout !== undefined && { timeout: config.timeout }),\n    ...(config.fetch !== undefined && { fetch: config.fetch }),\n    ...(config.protocolNegotiation !== undefined && {\n      protocolNegotiation: config.protocolNegotiation,\n    }),\n    oauth: false,\n  };\n}\n\n/**\n * Connect and mount namespace-keyed upstream servers through\n * `@mcp-use/client` v2.\n *\n * @param host - Parent server registration surface.\n * @param servers - Namespace-keyed upstream client configuration.\n *\n * @internal\n */\nexport async function mountProxyServers(\n  host: ProxyMountHost,\n  servers: Record<string, ProxyServerConfig>\n): Promise<void> {\n  if (host.isStarted()) {\n    throw new Error(\n      \"Cannot call proxy() after the server has started: register upstream servers before listen()/getHandler().\"\n    );\n  }\n\n  const { MCPClient } = await loadProxyClient();\n  const clientServers = Object.fromEntries(\n    Object.entries(servers).map(([name, config]) => [\n      name,\n      toClientConfig(config),\n    ])\n  );\n  const owner = new MCPClient({ mcpServers: clientServers });\n  try {\n    const plans: ProxyNamespacePlan[] = [];\n    for (const namespace of Object.keys(clientServers)) {\n      let connection: ClientMCPConnection;\n      try {\n        connection = await owner.connect(namespace);\n      } catch (error) {\n        proxyDiagnostic(\n          `Failed to connect to upstream MCP server \"${namespace}\"`,\n          error\n        );\n        continue;\n      }\n      plans.push(await introspect(namespace, connection));\n    }\n    for (const plan of plans) mountPlan(host, plan);\n    host.trackOwner(owner);\n  } catch (error) {\n    await owner.close().catch(() => undefined);\n    throw error;\n  }\n}\n\n/** Determine whether a proxy argument is an existing connection. @internal */\nexport function isProxyConnection(value: unknown): value is ProxyConnection {\n  return isConnection(value);\n}\n"],"mappings":";AA+KA,IAAM,4BAA4B;AAAA,EAChC;AAAA,EACA;AAAA,EACA;AAAA,EACA;AACF,EAAE,KAAK,IAAI;AAEX,SAAS,sBACP,QAC0E;AAC1E,SAAO;AAAA,IACL,aAAa;AAAA,MACX,SAAS;AAAA,MACT,QAAQ;AAAA,MACR,SAAS,OAAO;AACd,eAAO,EAAE,MAAwC;AAAA,MACnD;AAAA,MACA,YAAY;AAAA,QACV,OAAO,MAAM;AAAA,QACb,QAAQ,MAAM;AAAA,MAChB;AAAA,IACF;AAAA,EACF;AACF;AAEA,SAAS,uBACP,MACgB;AAChB,QAAM,aAAa,uBAAO,OAAO,IAAI;AACrC,QAAM,WAAqB,CAAC;AAC5B,aAAW,OAAO,QAAQ,CAAC,GAAG;AAC5B,eAAW,IAAI,IAAI,IAAI;AAAA,MACrB,MAAM;AAAA,MACN,GAAI,IAAI,gBAAgB,UAAa,EAAE,aAAa,IAAI,YAAY;AAAA,IACtE;AACA,QAAI,IAAI,aAAa,KAAM,UAAS,KAAK,IAAI,IAAI;AAAA,EACnD;AACA,SAAO;AAAA,IACL,MAAM;AAAA,IACN;AAAA,IACA,GAAI,SAAS,SAAS,KAAK,EAAE,SAAS;AAAA,EACxC;AACF;AAEA,SAAS,aAAa,WAAmB,MAAsB;AAC7D,SAAO,GAAG,SAAS,IAAI,IAAI;AAC7B;AAEA,SAAS,mBAAmB,WAAmB,KAAqB;AAClE,SAAO,oBAAoB,mBAAmB,SAAS,CAAC,IAAI,mBAAmB,GAAG,CAAC;AACrF;AAEA,SAAS,aAAa,OAA0C;AAC9D,MAAI,UAAU,QAAQ,OAAO,UAAU,SAAU,QAAO;AACxD,QAAM,YAAY;AAClB,SACE,OAAO,UAAU,cAAc,cAC/B,OAAO,UAAU,aAAa,cAC9B,OAAO,UAAU,iBAAiB,cAClC,OAAO,UAAU,gBAAgB,cACjC,OAAO,UAAU,cAAc;AAEnC;AAEA,SAAS,uBAAuB,OAAyB;AACvD,MAAI,EAAE,iBAAiB,OAAQ,QAAO;AACtC,QAAM,OAAQ,MAAgC;AAC9C,UACG,SAAS,0BAA0B,SAAS,uBAC7C,MAAM,QAAQ,SAAS,iBAAiB;AAE5C;AAEA,SAAS,gBAAgB,SAAiB,OAAuB;AAC/D,MAAI,UAAU,QAAW;AACvB,YAAQ,MAAM,aAAa,OAAO,EAAE;AACpC;AAAA,EACF;AACA,QAAM,SAAS,iBAAiB,QAAQ,MAAM,UAAU,OAAO,KAAK;AACpE,UAAQ,MAAM,aAAa,OAAO,KAAK,MAAM,EAAE;AACjD;AAGO,SAAS,wBAAwB,OAAmC;AACzE,SAAO,uBAAuB,KAAK,IAC/B,IAAI,MAAM,2BAA2B,EAAE,OAAO,MAAM,CAAC,IACrD;AACN;AAEA,eAAe,gBACb,WAAmC,MAAM,OAAO,iBAAiB,GACpC;AAC7B,MAAI;AACF,WAAQ,MAAM,SAAS;AAAA,EACzB,SAAS,OAAO;AACd,UAAM,eAAe,wBAAwB,KAAK;AAClD,QAAI,iBAAiB,OAAW,OAAM;AACtC,UAAM;AAAA,EACR;AACF;AAEA,SAAS,SACP,YACA,YACS;AACT,SAAO,WAAW,WAAW,UAAU,MAAM;AAC/C;AAEA,eAAe,WACb,WACA,YAC6B;AAC7B,MAAI,QAAqB,CAAC;AAC1B,MAAI,SAAS,YAAY,OAAO,GAAG;AACjC,QAAI;AACF,cAAQ,MAAM,WAAW,UAAU;AAAA,IACrC,SAAS,OAAO;AACd;AAAA,QACE,wDAAwD,SAAS;AAAA,QACjE;AAAA,MACF;AAAA,IACF;AAAA,EACF;AAEA,MAAI,YAA6B,CAAC;AAClC,MAAI,SAAS,YAAY,WAAW,GAAG;AACrC,QAAI;AACF,UAAI,WAAW,qBAAqB,QAAW;AAC7C,qBAAa,MAAM,WAAW,iBAAiB,GAAG;AAAA,MACpD,WAAW,WAAW,kBAAkB,QAAW;AACjD,qBAAa,MAAM,WAAW,cAAc,GAAG;AAAA,MACjD;AAAA,IACF,SAAS,OAAO;AACd;AAAA,QACE,4DAA4D,SAAS;AAAA,QACrE;AAAA,MACF;AAAA,IACF;AAAA,EACF;AAEA,MAAI,UAAyB,CAAC;AAC9B,MAAI,SAAS,YAAY,SAAS,GAAG;AACnC,QAAI;AACF,iBAAW,MAAM,WAAW,YAAY,GAAG;AAAA,IAC7C,SAAS,OAAO;AACd;AAAA,QACE,0DAA0D,SAAS;AAAA,QACnE;AAAA,MACF;AAAA,IACF;AAAA,EACF;AAEA,SAAO,EAAE,WAAW,YAAY,OAAO,WAAW,QAAQ;AAC5D;AAEA,SAAS,UAAU,MAAsB,MAAgC;AACvE,aAAW,QAAQ,KAAK,OAAO;AAC7B,UAAM,OAAO,aAAa,KAAK,WAAW,KAAK,IAAI;AACnD,QAAI,KAAK,QAAQ,IAAI,GAAG;AACtB;AAAA,QACE,0BAA0B,IAAI,oBAAoB,KAAK,SAAS;AAAA,MAClE;AACA;AAAA,IACF;AACA,UAAM,aAA6B;AAAA,MACjC;AAAA,MACA,GAAI,KAAK,UAAU,UAAa,EAAE,OAAO,KAAK,MAAM;AAAA,MACpD,GAAI,KAAK,gBAAgB,UAAa,EAAE,aAAa,KAAK,YAAY;AAAA,MACtE,GAAI,KAAK,gBAAgB,UAAa,EAAE,aAAa,KAAK,YAAY;AAAA,MACtE,GAAI,KAAK,gBAAgB,UAAa;AAAA,QACpC,aAAa,sBAAsB,KAAK,WAAW;AAAA,MACrD;AAAA,MACA,GAAI,KAAK,iBAAiB,UAAa;AAAA,QACrC,cAAc,sBAAsB,KAAK,YAAY;AAAA,MACvD;AAAA,IACF;AACA,UAAM,eAAe,KAAK;AAC1B,UAAM,WAAW,OACf,QACA,QACG;AACH,UAAI,qBAAqB,QAAQ,QAAQ;AACzC,UAAI;AACF,eAAO,MAAM,KAAK,WAAW,SAAS,cAAc,QAAQ;AAAA,UAC1D,QAAQ,IAAI;AAAA,UACZ,YAAY,CAAC,aAAa;AACxB,iCAAqB,mBAAmB,KAAK,YAAY;AACvD,kBAAI;AACF,sBAAM,IAAI;AAAA,kBACR,SAAS;AAAA,kBACT,SAAS;AAAA,kBACT,SAAS;AAAA,gBACX;AAAA,cACF,SAAS,OAAO;AACd;AAAA,kBACE,gDAAgD,WAAW,IAAI;AAAA,kBAC/D;AAAA,gBACF;AAAA,cACF;AAAA,YACF,CAAC;AAAA,UACH;AAAA,QACF,CAAC;AAAA,MACH,UAAE;AACA,cAAM;AAAA,MACR;AAAA,IACF;AACA,SAAK,aAAa,YAAY,QAAwB;AAAA,EACxD;AAEA,aAAW,YAAY,KAAK,WAAW;AACrC,UAAM,OAAO,aAAa,KAAK,WAAW,SAAS,IAAI;AACvD,QAAI,KAAK,YAAY,IAAI,GAAG;AAC1B;AAAA,QACE,8BAA8B,IAAI,oBAAoB,KAAK,SAAS;AAAA,MACtE;AACA;AAAA,IACF;AACA,UAAM,cAAc,SAAS;AAC7B,SAAK;AAAA,MACH;AAAA,QACE;AAAA,QACA,KAAK,mBAAmB,KAAK,WAAW,WAAW;AAAA,QACnD,GAAI,SAAS,UAAU,UAAa,EAAE,OAAO,SAAS,MAAM;AAAA,QAC5D,GAAI,SAAS,gBAAgB,UAAa;AAAA,UACxC,aAAa,SAAS;AAAA,QACxB;AAAA,QACA,GAAI,SAAS,aAAa,UAAa;AAAA,UACrC,UAAU,SAAS;AAAA,QACrB;AAAA,MACF;AAAA,MACA,OAAO,MAAM,QACX,KAAK,WAAW,aAAa,aAAa,EAAE,QAAQ,IAAI,OAAO,CAAC;AAAA,IACpE;AAAA,EACF;AAEA,aAAW,UAAU,KAAK,SAAS;AACjC,UAAM,OAAO,aAAa,KAAK,WAAW,OAAO,IAAI;AACrD,QAAI,KAAK,UAAU,IAAI,GAAG;AACxB;AAAA,QACE,4BAA4B,IAAI,oBAAoB,KAAK,SAAS;AAAA,MACpE;AACA;AAAA,IACF;AACA,UAAM,eAAe,OAAO;AAC5B,SAAK;AAAA,MACH;AAAA,QACE;AAAA,QACA,GAAI,OAAO,UAAU,UAAa,EAAE,OAAO,OAAO,MAAM;AAAA,QACxD,GAAI,OAAO,gBAAgB,UAAa;AAAA,UACtC,aAAa,OAAO;AAAA,QACtB;AAAA,QACA,QAAQ,sBAAsB,uBAAuB,OAAO,SAAS,CAAC;AAAA,MACxE;AAAA,MACA,OAAO,WAAW,KAAK,WAAW,UAAU,cAAc,MAAM;AAAA,IAClE;AAAA,EACF;AACF;AASA,eAAsB,qBACpB,MACA,YACe;AACf,MAAI,KAAK,UAAU,GAAG;AACpB,UAAM,IAAI;AAAA,MACR;AAAA,IACF;AAAA,EACF;AACA,QAAM,YAAY,WAAW,KAAK,OAAO;AACzC,QAAM,OAAO,MAAM,WAAW,WAAW,UAAU;AACnD,YAAU,MAAM,IAAI;AACtB;AAEA,SAAS,eAAe,QAAmD;AACzE,SAAO;AAAA,IACL,KAAK,OAAO;AAAA,IACZ,GAAI,OAAO,YAAY,UAAa,EAAE,SAAS,OAAO,QAAQ;AAAA,IAC9D,GAAI,OAAO,cAAc,UAAa,EAAE,WAAW,OAAO,UAAU;AAAA,IACpE,GAAI,OAAO,YAAY,UAAa,EAAE,SAAS,OAAO,QAAQ;AAAA,IAC9D,GAAI,OAAO,UAAU,UAAa,EAAE,OAAO,OAAO,MAAM;AAAA,IACxD,GAAI,OAAO,wBAAwB,UAAa;AAAA,MAC9C,qBAAqB,OAAO;AAAA,IAC9B;AAAA,IACA,OAAO;AAAA,EACT;AACF;AAWA,eAAsB,kBACpB,MACA,SACe;AACf,MAAI,KAAK,UAAU,GAAG;AACpB,UAAM,IAAI;AAAA,MACR;AAAA,IACF;AAAA,EACF;AAEA,QAAM,EAAE,UAAU,IAAI,MAAM,gBAAgB;AAC5C,QAAM,gBAAgB,OAAO;AAAA,IAC3B,OAAO,QAAQ,OAAO,EAAE,IAAI,CAAC,CAAC,MAAM,MAAM,MAAM;AAAA,MAC9C;AAAA,MACA,eAAe,MAAM;AAAA,IACvB,CAAC;AAAA,EACH;AACA,QAAM,QAAQ,IAAI,UAAU,EAAE,YAAY,cAAc,CAAC;AACzD,MAAI;AACF,UAAM,QAA8B,CAAC;AACrC,eAAW,aAAa,OAAO,KAAK,aAAa,GAAG;AAClD,UAAI;AACJ,UAAI;AACF,qBAAa,MAAM,MAAM,QAAQ,SAAS;AAAA,MAC5C,SAAS,OAAO;AACd;AAAA,UACE,6CAA6C,SAAS;AAAA,UACtD;AAAA,QACF;AACA;AAAA,MACF;AACA,YAAM,KAAK,MAAM,WAAW,WAAW,UAAU,CAAC;AAAA,IACpD;AACA,eAAW,QAAQ,MAAO,WAAU,MAAM,IAAI;AAC9C,SAAK,WAAW,KAAK;AAAA,EACvB,SAAS,OAAO;AACd,UAAM,MAAM,MAAM,EAAE,MAAM,MAAM,MAAS;AACzC,UAAM;AAAA,EACR;AACF;AAGO,SAAS,kBAAkB,OAA0C;AAC1E,SAAO,aAAa,KAAK;AAC3B;","names":[]}

package/dist/proxy.d.ts

@@ -1,153 +0,0 @@
-import type { CallToolResult, GetPromptResult, InputRequiredResult, PromptArgument, ReadResourceResult, ToolAnnotations } from "@modelcontextprotocol/server";
-import type { PromptCallback, PromptDefinition } from "./prompts.js";
-import type { ResourceCallback, ResourceDefinition } from "./resources.js";
-import type { ToolCallback, ToolDefinition } from "./tools.js";
-/** HTTP connection settings accepted by {@link MCPServer.proxy}. */
-export interface ProxyHttpConfig {
-    /** Upstream MCP endpoint URL. */
-    url: string;
-    /** Extra headers sent on every upstream request. */
-    headers?: Record<string, string>;
-    /** Bearer token sent to the upstream server. */
-    authToken?: string;
-    /** Connection timeout in milliseconds. */
-    timeout?: number;
-    /** Fetch implementation used for upstream HTTP requests. */
-    fetch?: typeof fetch;
-    /** Protocol negotiation mode forwarded to `@mcp-use/client`. */
-    protocolNegotiation?: "auto" | "legacy" | {
-        pin: string;
-    };
-}
-/** Connection settings for one upstream server. */
-export type ProxyServerConfig = ProxyHttpConfig;
-/** Progress payload received while a proxied tool is running. */
-export interface ProxyProgress {
-    /** Completed work units. */
-    progress: number;
-    /** Total work units, when known. */
-    total?: number | undefined;
-    /** Human-readable progress detail. */
-    message?: string | undefined;
-}
-/** Request controls used when forwarding calls to an upstream connection. */
-export interface ProxyRequestOptions {
-    /** Aborts the upstream request when the downstream request is cancelled. */
-    signal?: AbortSignal;
-    /** Receives upstream progress notifications. */
-    onprogress?: (progress: ProxyProgress) => void;
-}
-/** Structural connection contract accepted by the low-level proxy overload. */
-export interface ProxyConnection {
-    /** Negotiated metadata used to derive the automatic capability namespace. */
-    readonly info: {
-        server: {
-            name: string;
-        };
-    };
-    /** Whether the upstream advertised a named MCP capability. */
-    supports?(capability: string): boolean;
-    /** List upstream tools. */
-    listTools(): Promise<ProxyTool[]>;
-    /** Forward a tool call. */
-    callTool(name: string, args?: Record<string, unknown>, options?: ProxyRequestOptions): Promise<CallToolResult | InputRequiredResult>;
-    /** List upstream resources, including pagination when supported. */
-    listAllResources?(): Promise<{
-        resources: ProxyResource[];
-    }>;
-    /** List one page of upstream resources. */
-    listResources?(): Promise<{
-        resources: ProxyResource[];
-    }>;
-    /** Read an upstream resource. */
-    readResource(uri: string, options?: ProxyRequestOptions): Promise<ReadResourceResult>;
-    /** List upstream prompts. */
-    listPrompts(): Promise<{
-        prompts: ProxyPrompt[];
-    }>;
-    /** Render an upstream prompt. */
-    getPrompt(name: string, args: Record<string, unknown>): Promise<GetPromptResult>;
-}
-/** Tool metadata consumed while introspecting an upstream connection. */
-export interface ProxyTool {
-    /** Upstream tool name. */
-    name: string;
-    /** Human-readable tool title. */
-    title?: string | undefined;
-    /** LLM-facing tool description. */
-    description?: string | undefined;
-    /** Upstream input JSON Schema. */
-    inputSchema?: Record<string, unknown> | undefined;
-    /** Upstream output JSON Schema. */
-    outputSchema?: Record<string, unknown> | undefined;
-    /** Upstream behavioral hints. */
-    annotations?: ToolAnnotations | undefined;
-}
-/** Resource metadata consumed while introspecting an upstream connection. */
-export interface ProxyResource {
-    /** Upstream resource name. */
-    name: string;
-    /** Original upstream resource URI. */
-    uri: string;
-    /** Human-readable resource title. */
-    title?: string | undefined;
-    /** Human-readable resource description. */
-    description?: string | undefined;
-    /** Resource media type. */
-    mimeType?: string | undefined;
-}
-/** Prompt metadata consumed while introspecting an upstream connection. */
-export interface ProxyPrompt {
-    /** Upstream prompt name. */
-    name: string;
-    /** Human-readable prompt title. */
-    title?: string | undefined;
-    /** Human-readable prompt description. */
-    description?: string | undefined;
-    /** String arguments accepted by the prompt. */
-    arguments?: PromptArgument[] | undefined;
-}
-/** Registration surface used while mounting proxied capabilities. @internal */
-export interface ProxyMountHost {
-    /** Whether the parent server has mounted its handler. */
-    isStarted(): boolean;
-    /** Whether a tool name is already registered. */
-    hasTool(name: string): boolean;
-    /** Whether a resource name is already registered. */
-    hasResource(name: string): boolean;
-    /** Whether a prompt name is already registered. */
-    hasPrompt(name: string): boolean;
-    /** Register a proxied tool. */
-    registerTool(definition: ToolDefinition, callback: ToolCallback): void;
-    /** Register a proxied resource. */
-    registerResource(definition: ResourceDefinition, callback: ResourceCallback): void;
-    /** Register a proxied prompt. */
-    registerPrompt(definition: PromptDefinition, callback: PromptCallback): void;
-    /** Track a proxy client owned by the parent server. */
-    trackOwner(owner: {
-        close(): Promise<void>;
-    }): void;
-}
-/** Convert a missing optional-client import into the proxy install error. @internal */
-export declare function proxyClientInstallError(error: unknown): Error | undefined;
-/**
- * Mount one existing upstream connection on a parent server.
- *
- * @param host - Parent server registration surface.
- * @param connection - Ready `@mcp-use/client` v2 connection.
- * @internal
- */
-export declare function mountProxyConnection(host: ProxyMountHost, connection: ProxyConnection): Promise<void>;
-/**
- * Connect and mount namespace-keyed upstream servers through
- * `@mcp-use/client` v2.
- *
- * @param host - Parent server registration surface.
- * @param servers - Namespace-keyed upstream client configuration.
- *
- * @internal
- */
-export declare function mountProxyServers(host: ProxyMountHost, servers: Record<string, ProxyServerConfig>): Promise<void>;
-/** Determine whether a proxy argument is an existing connection. @internal */
-export declare function isProxyConnection(value: unknown): value is ProxyConnection;
-//# sourceMappingURL=proxy.d.ts.map

package/dist/proxy.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"proxy.d.ts","sourceRoot":"","sources":["../src/proxy.ts"],"names":[],"mappings":"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"}

package/dist/public-route-5JEGFEIN.js

@@ -1,9 +0,0 @@
-import {
-  resolvePublicFilePath,
-  servePublicFile
-} from "./chunk-SMN75YED.js";
-export {
-  resolvePublicFilePath,
-  servePublicFile
-};
-//# sourceMappingURL=public-route-5JEGFEIN.js.map

package/dist/public-route-5JEGFEIN.js.map

@@ -1 +0,0 @@
-{"version":3,"sources":[],"sourcesContent":[],"mappings":"","names":[]}

package/dist/react/hooks/use-files.d.ts

@@ -1,25 +0,0 @@
-import type { UseFilesResult } from "../types/file-types.js";
-/**
- * Upload and download files through ChatGPT's optional `window.openai`
- * extension.
- *
- * File handling is not part of the MCP Apps bridge. Always check
- * `isSupported` before calling either action; unsupported calls reject with a
- * descriptive error. The hook does not read or update ChatGPT widget state and
- * does not make uploaded files model-visible as a side effect.
- *
- * The returned actions are referentially stable for the lifetime of the
- * mounted runtime.
- *
- * @example
- * ```tsx
- * const { isSupported, upload, getDownloadUrl } = useFiles();
- *
- * if (!isSupported) return <p>File handling requires ChatGPT.</p>;
- *
- * const { fileId } = await upload(file);
- * const { downloadUrl } = await getDownloadUrl({ fileId });
- * ```
- */
-export declare function useFiles(): UseFilesResult;
-//# sourceMappingURL=use-files.d.ts.map

package/dist/react/hooks/use-files.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"use-files.d.ts","sourceRoot":"","sources":["../../../src/react/hooks/use-files.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,wBAAwB,CAAC;AAE7D;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,wBAAgB,QAAQ,IAAI,cAAc,CAezC"}

package/dist/react/types/file-types.d.ts

@@ -1,16 +0,0 @@
-/** Opaque file reference returned by {@link useFiles}. */
-export type FileMetadata = {
-    fileId: string;
-};
-/** Value returned by {@link useFiles}. */
-export interface UseFilesResult {
-    /** Whether the ChatGPT file upload and download extensions are available. */
-    isSupported: boolean;
-    /** Upload a file through ChatGPT. */
-    upload(file: File): Promise<FileMetadata>;
-    /** Request a temporary download URL for an uploaded file. */
-    getDownloadUrl(file: FileMetadata): Promise<{
-        downloadUrl: string;
-    }>;
-}
-//# sourceMappingURL=file-types.d.ts.map

package/dist/react/types/file-types.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"file-types.d.ts","sourceRoot":"","sources":["../../../src/react/types/file-types.ts"],"names":[],"mappings":"AAAA,0DAA0D;AAC1D,MAAM,MAAM,YAAY,GAAG;IAAE,MAAM,EAAE,MAAM,CAAA;CAAE,CAAC;AAE9C,0CAA0C;AAC1C,MAAM,WAAW,cAAc;IAC7B,6EAA6E;IAC7E,WAAW,EAAE,OAAO,CAAC;IACrB,qCAAqC;IACrC,MAAM,CAAC,IAAI,EAAE,IAAI,GAAG,OAAO,CAAC,YAAY,CAAC,CAAC;IAC1C,6DAA6D;IAC7D,cAAc,CAAC,IAAI,EAAE,YAAY,GAAG,OAAO,CAAC;QAAE,WAAW,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;CACtE"}

package/dist/resource-completion.d.ts

@@ -1,12 +0,0 @@
-import type { CompleteResourceTemplateCallback } from "@modelcontextprotocol/server";
-import type { ResourceTemplateCompleter } from "./resources.js";
-/**
- * Convert public static and callback completions to the SDK callback map.
- *
- * @param completions - Public completion providers keyed by template variable.
- * @returns The callback-only map required by the official SDK.
- *
- * @internal
- */
-export declare function normalizeCompletions(completions: Readonly<Record<string, ResourceTemplateCompleter | undefined>>): Record<string, CompleteResourceTemplateCallback>;
-//# sourceMappingURL=resource-completion.d.ts.map

package/dist/resource-completion.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"resource-completion.d.ts","sourceRoot":"","sources":["../src/resource-completion.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gCAAgC,EAAE,MAAM,8BAA8B,CAAC;AAGrF,OAAO,KAAK,EAAE,yBAAyB,EAAE,MAAM,gBAAgB,CAAC;AAEhE;;;;;;;GAOG;AACH,wBAAgB,oBAAoB,CAClC,WAAW,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,yBAAyB,GAAG,SAAS,CAAC,CAAC,GAC3E,MAAM,CAAC,MAAM,EAAE,gCAAgC,CAAC,CAYlD"}

package/dist/views/csp-env.d.ts

@@ -1,37 +0,0 @@
-import type { McpUiResourceCsp } from "@modelcontextprotocol/ext-apps";
-import type { ViewResourceFacts } from "./types.js";
-type CspCategory = "connectDomains" | "resourceDomains" | "frameDomains" | "baseUriDomains";
-/** Parse a comma-separated env var into trimmed non-empty domain strings. */
-export declare function parseDomainList(raw: string | undefined): string[];
-/** Domains from `CSP_URLS` (shortcut for all categories). */
-export declare function readCspUrlsShortcut(): string[];
-/** Per-category env override, or `CSP_URLS` when the category var is unset. */
-export declare function readEnvDomainsForCategory(category: CspCategory): string[];
-/**
- * Merge domain lists: earlier segments win on duplicate (higher priority).
- */
-export declare function mergeDomainLists(...segments: string[][]): string[];
-/**
- * Resolved origins and flags used when merging author, env, and MCP CSP domains.
- *
- * @internal
- */
-export interface BuildCspOptions {
-    /** Public server origin from `MCP_URL` or forwarded request headers. */
-    serverOrigin: string;
-    /** Assets origin derived from `MCP_ASSETS_URL` or the server origin. */
-    assetsOrigin: string;
-    /** When false, server origin is appended to resourceDomains (same-origin assets). */
-    explicitAssetsBase: boolean;
-    /** When true, append the server origin's websocket variant for Vite HMR. */
-    hmrWs?: boolean;
-}
-/**
- * Build final `_meta.ui.csp` from author facts, env vars, and MCP auto-append.
- *
- * Precedence (high → low): author → env (`CSP_*_DOMAINS` or `CSP_URLS`) →
- * MCP auto-append (lowest).
- */
-export declare function buildMergedResourceCsp(authorFacts: ViewResourceFacts | undefined, options: BuildCspOptions): McpUiResourceCsp;
-export {};
-//# sourceMappingURL=csp-env.d.ts.map

package/dist/views/csp-env.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"csp-env.d.ts","sourceRoot":"","sources":["../../src/views/csp-env.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,gCAAgC,CAAC;AAEvE,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAC;AAEpD,KAAK,WAAW,GACZ,gBAAgB,GAChB,iBAAiB,GACjB,cAAc,GACd,gBAAgB,CAAC;AASrB,6EAA6E;AAC7E,wBAAgB,eAAe,CAAC,GAAG,EAAE,MAAM,GAAG,SAAS,GAAG,MAAM,EAAE,CAQjE;AAaD,6DAA6D;AAC7D,wBAAgB,mBAAmB,IAAI,MAAM,EAAE,CAE9C;AAED,+EAA+E;AAC/E,wBAAgB,yBAAyB,CAAC,QAAQ,EAAE,WAAW,GAAG,MAAM,EAAE,CAMzE;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,GAAG,QAAQ,EAAE,MAAM,EAAE,EAAE,GAAG,MAAM,EAAE,CAYlE;AAED;;;;GAIG;AACH,MAAM,WAAW,eAAe;IAC9B,wEAAwE;IACxE,YAAY,EAAE,MAAM,CAAC;IACrB,wEAAwE;IACxE,YAAY,EAAE,MAAM,CAAC;IACrB,qFAAqF;IACrF,kBAAkB,EAAE,OAAO,CAAC;IAC5B,4EAA4E;IAC5E,KAAK,CAAC,EAAE,OAAO,CAAC;CACjB;AAYD;;;;;GAKG;AACH,wBAAgB,sBAAsB,CACpC,WAAW,EAAE,iBAAiB,GAAG,SAAS,EAC1C,OAAO,EAAE,eAAe,GACvB,gBAAgB,CAgDlB"}