mcp-use 2.0.0-beta.46 → 2.0.0-beta.47

package/dist/bin.js

@@ -1,2 +1,2 @@
 #!/usr/bin/env node
-var{main}=await import("@mcp-use/cli");main(process.argv.slice(2),{frameworkVersion:"2.0.0-beta.46"}).then(code=>{process.exitCode=code},error=>{console.error(error instanceof Error?error.message:String(error)),process.exitCode=1});
+var{main}=await import("@mcp-use/cli");main(process.argv.slice(2),{frameworkVersion:"2.0.0-beta.47"}).then(code=>{process.exitCode=code},error=>{console.error(error instanceof Error?error.message:String(error)),process.exitCode=1});

package/dist/chunk-4TTKTNKI.js

@@ -0,0 +1 @@
+function d(e){return e.replace(/\/+$/,"")}function o(e){if(typeof process>"u")return;let n=process.env[e];return n!==void 0&&n!==""?n:void 0}function c(e){for(let n of e.split(",")){let t=new Map;for(let i of n.split(";")){let[u,...f]=i.trim().split("=");u===void 0||f.length===0||t.set(u.toLowerCase(),f.join("=").replace(/^"|"$/g,""))}let s=t.get("proto"),r=t.get("host");if(s!==void 0&&r!==void 0)return`${s}://${r}`}}function a(e){let n=e.headers.get("forwarded");if(n!==null){let r=c(n);if(r!==void 0)return r}let t=e.headers.get("x-forwarded-proto"),s=e.headers.get("x-forwarded-host");if(t!==null&&s!==null){let r=s.split(",")[0]?.trim(),i=t.split(",")[0]?.trim();if(r!==void 0&&i!==void 0&&r!=="")return`${i}://${r}`}return new URL(e.url).origin}function l(e){let n=o("MCP_URL");if(n!==void 0)try{return new URL(n).origin}catch{}return a(e)}function p(e){try{return new URL(e).origin}catch{return e}}function g(e){return d(e)}function h(e){let n=o("MCP_ASSETS_URL");if(n!==void 0)try{return g(new URL(n).href.replace(/\/$/,""))}catch{}return l(e)}function R(){let e=o("MCP_ASSETS_URL");if(e===void 0)return!1;try{return new URL(e),!0}catch{return!1}}export{l as a,p as b,h as c,R as d};

package/dist/{chunk-YGVMTVPK.js → chunk-MNSSFPOL.js}

@@ -1,2 +1,2 @@
 var EVENT="mcp_use_sdk_event",ENDPOINT="https://eu.i.posthog.com/i/v0/e/",TOKEN="phc_lyTtbYwvkdSbrcMQNPiKiiRWrrM1seyKIMjycSvItEI",CONTENT=/(^|_)(arguments?|args|body|command|headers?|location|message|organization|path|query|response|secret|subject|token|uri|url|user_agent)(_|$)/i,RESERVED=new Set("feature action sdk_generation telemetry_schema_version sdk_package sdk_version server_id runtime_id identity_stability distinct_id validation_run_id is_validation".split(" ")),runtimeId=crypto.randomUUID(),once=new Set,pending=new Set,identities=new Map;function hasControl(value){return[...value].some(character=>{let code=character.charCodeAt(0);return code<32||code===127})}function env(name){return typeof process>"u"?void 0:process.env?.[name]}function safeEnv(name){let value=env(name);return value!==void 0&&value.length>0&&value.length<=128&&!hasControl(value)?value:void 0}function disabled(){if(env("MCP_USE_ANONYMIZED_TELEMETRY")==="false")return!0;try{return globalThis.__MCP_USE_ANONYMIZED_TELEMETRY__===!1||typeof localStorage<"u"&&localStorage.getItem("MCP_USE_ANONYMIZED_TELEMETRY")==="false"}catch{return!1}}function clean(properties){return Object.fromEntries(Object.entries(properties).filter(([key,value])=>key.length>128||hasControl(key)||key.startsWith("$")||RESERVED.has(key)||CONTENT.test(key)||value===void 0?!1:typeof value=="string"?value.length<=128&&!hasControl(value):typeof value=="boolean"||typeof value=="number"&&Number.isFinite(value)))}async function identity(serverRoot){let projectId=safeEnv("MCP_USE_TELEMETRY_PROJECT_ID");if(projectId!==void 0)return{id:projectId,stability:"project"};if(serverRoot===void 0||typeof process>"u")return{id:runtimeId,stability:"process"};let existing=identities.get(serverRoot);if(existing!==void 0)return existing;let resolving=(async()=>{try{let fs=await import("fs/promises"),directory=`${serverRoot}/.mcp-use`,file=`${directory}/usage.json`,read=async()=>{try{let value=JSON.parse(await fs.readFile(file,"utf8"));if(typeof value=="object"&&value!==null&&"schemaVersion"in value&&value.schemaVersion===1&&"serverId"in value&&typeof value.serverId=="string"&&/^[0-9a-f]{8}-[0-9a-f]{4}-4[0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}$/i.test(value.serverId))return value.serverId}catch{}},stored=await read();if(stored!==void 0)return{id:stored,stability:"server"};await fs.mkdir(directory,{recursive:!0,mode:448});let created=crypto.randomUUID();try{return await fs.writeFile(file,`${JSON.stringify({schemaVersion:1,serverId:created})}
-`,{flag:"wx",mode:384}),{id:created,stability:"server"}}catch{let raced=await read();if(raced!==void 0)return{id:raced,stability:"server"}}}catch{}return{id:runtimeId,stability:"process"}})();return identities.set(serverRoot,resolving),resolving}function capture(feature,action,properties,options,resolveIdentity){let validationId=safeEnv("MCP_USE_TELEMETRY_VALIDATION_ID");if(disabled()||env("NODE_ENV")==="test"&&validationId===void 0||pending.size>=16)return;if(options.onceKey!==void 0){if(once.has(options.onceKey))return;once.add(options.onceKey)}let rate=Math.max(0,Math.min(1,options.sampleRate??1));if(validationId===void 0&&Math.random()>=rate)return;let request=(async()=>{try{let resolvedIdentity=await resolveIdentity(),body=JSON.stringify({api_key:TOKEN,event:EVENT,properties:{...clean(properties),feature,action,sdk_generation:"v2",telemetry_schema_version:2,sdk_package:"mcp-use",sdk_version:"2.0.0-beta.46",server_id:resolvedIdentity.id,runtime_id:runtimeId,identity_stability:resolvedIdentity.stability,distinct_id:resolvedIdentity.id,sample_rate:validationId===void 0?rate:1,$process_person_profile:!1,$geoip_disable:!0,...validationId!==void 0&&{is_validation:!0,validation_run_id:validationId}}});await fetch(ENDPOINT,{method:"POST",headers:{"content-type":"application/json"},keepalive:!0,body})}catch{return}})();pending.add(request),request.then(()=>pending.delete(request))}function recordUsage(feature,action,properties={},options={}){capture(feature,action,properties,options,()=>identity(options.serverRoot))}async function flushUsage(){await Promise.all([...pending])}export{recordUsage,flushUsage};
+`,{flag:"wx",mode:384}),{id:created,stability:"server"}}catch{let raced=await read();if(raced!==void 0)return{id:raced,stability:"server"}}}catch{}return{id:runtimeId,stability:"process"}})();return identities.set(serverRoot,resolving),resolving}function capture(feature,action,properties,options,resolveIdentity){let validationId=safeEnv("MCP_USE_TELEMETRY_VALIDATION_ID");if(disabled()||env("NODE_ENV")==="test"&&validationId===void 0||pending.size>=16)return;if(options.onceKey!==void 0){if(once.has(options.onceKey))return;once.add(options.onceKey)}let rate=Math.max(0,Math.min(1,options.sampleRate??1));if(validationId===void 0&&Math.random()>=rate)return;let request=(async()=>{try{let resolvedIdentity=await resolveIdentity(),body=JSON.stringify({api_key:TOKEN,event:EVENT,properties:{...clean(properties),feature,action,sdk_generation:"v2",telemetry_schema_version:2,sdk_package:"mcp-use",sdk_version:"2.0.0-beta.47",server_id:resolvedIdentity.id,runtime_id:runtimeId,identity_stability:resolvedIdentity.stability,distinct_id:resolvedIdentity.id,sample_rate:validationId===void 0?rate:1,$process_person_profile:!1,$geoip_disable:!0,...validationId!==void 0&&{is_validation:!0,validation_run_id:validationId}}});await fetch(ENDPOINT,{method:"POST",headers:{"content-type":"application/json"},keepalive:!0,body})}catch{return}})();pending.add(request),request.then(()=>pending.delete(request))}function recordUsage(feature,action,properties={},options={}){capture(feature,action,properties,options,()=>identity(options.serverRoot))}async function flushUsage(){await Promise.all([...pending])}export{recordUsage,flushUsage};

package/dist/chunk-ZBN5QPYD.js

@@ -0,0 +1 @@
+var c={".css":"text/css",".gif":"image/gif",".html":"text/html",".ico":"image/x-icon",".jpeg":"image/jpeg",".jpg":"image/jpeg",".js":"application/javascript",".json":"application/json",".map":"application/json",".png":"image/png",".svg":"image/svg+xml",".txt":"text/plain",".webp":"image/webp",".woff":"font/woff",".woff2":"font/woff2"};async function p(i,t){let{stat:r}=await import("fs/promises"),{resolve:o,sep:a}=await import("path");if(t===""||t.includes("\\")||t.split("/").some(l=>l===".."))return null;let e=t.replace(/^\/+/,"");if(e===""||e.endsWith("/"))return null;let n=o(i),s=o(n,e);if(s!==n&&!s.startsWith(n+a))return null;try{if(!(await r(s)).isFile())return null}catch{return null}return s}async function g(i,t={}){let{readFile:r}=await import("fs/promises"),{extname:o}=await import("path"),a=o(i).toLowerCase(),e=c[a]??"application/octet-stream",n=t.head===!0?null:new Uint8Array(await r(i));return new Response(n,{status:200,headers:{"Content-Type":e,"Cache-Control":"public, max-age=0, must-revalidate",...t.deferCors!==!0&&{"Access-Control-Allow-Origin":"*"}}})}export{p as a,g as b};

package/dist/compat-v1/oauth.d.ts

@@ -0,0 +1,37 @@
+/**
+ * v1 OAuth provider factories with legacy env fallbacks.
+ *
+ * @deprecated Import from `mcp-use/oauth/*`. Removed in mcp-use v3.
+ */
+import { type Auth0OAuthProviderOptions } from "../oauth/auth0.js";
+import { type BetterAuthOAuthProviderOptions } from "../oauth/better-auth.js";
+import { type ClerkOAuthProviderOptions } from "../oauth/clerk.js";
+import { type KeycloakOAuthProviderOptions } from "../oauth/keycloak.js";
+import type { OAuthProvider } from "../oauth/provider.js";
+import { type SupabaseOAuthProviderOptions } from "../oauth/supabase.js";
+import { type WorkOSOAuthProviderOptions } from "../oauth/workos.js";
+/** @deprecated Removed in mcp-use v3. */
+export declare function oauthSupabaseProvider(options?: Partial<SupabaseOAuthProviderOptions>): OAuthProvider<unknown>;
+/** @deprecated Removed in mcp-use v3. */
+export declare function oauthAuth0Provider(options?: Partial<Auth0OAuthProviderOptions> & {
+    audience?: string;
+    verifyJwt?: boolean;
+}): OAuthProvider<unknown>;
+/** @deprecated Removed in mcp-use v3. */
+export declare function oauthKeycloakProvider(options?: Partial<KeycloakOAuthProviderOptions> & {
+    audience?: string;
+    verifyJwt?: boolean;
+}): OAuthProvider<unknown>;
+/** @deprecated Removed in mcp-use v3. */
+export declare function oauthWorkOSProvider(options?: Partial<WorkOSOAuthProviderOptions> & {
+    verifyJwt?: boolean;
+}): OAuthProvider<unknown>;
+/** @deprecated Removed in mcp-use v3. */
+export declare function oauthClerkProvider(options?: Partial<ClerkOAuthProviderOptions> & {
+    audience?: string;
+    verifyJwt?: boolean;
+}): OAuthProvider<unknown>;
+/** @deprecated Removed in mcp-use v3. */
+export declare function oauthBetterAuthProvider(options?: Partial<BetterAuthOAuthProviderOptions> & {
+    verifyJwt?: boolean;
+}): OAuthProvider<unknown>;

package/dist/compat-v1.d.ts

@@ -0,0 +1,528 @@
+/**
+ * Deprecated v1 server compatibility entry.
+ *
+ * This file intentionally contains the complete server-side bridge. It
+ * normalizes the common v1 authoring shapes and delegates all protocol and
+ * HTTP behavior to the native v2 server.
+ */
+import type { CallToolResult, GetPromptResult, ReadResourceResult, StandardSchemaWithJSON } from "@modelcontextprotocol/server";
+import type { Context, Env, Next } from "hono";
+import type { ServerConfig as NativeServerConfig } from "./config.js";
+import type { RequestContext, RequestClientContext } from "./context.js";
+import type { FromOpenAPIOptions } from "./openapi/types.js";
+import type { OAuthProvider } from "./oauth/provider.js";
+import type { PromptDefinition as NativePromptDefinition } from "./prompts.js";
+import { audio, binary, css, error, html, image, javascript, markdown, mix, object, resource, text, xml, type ToolContentResult, type TypedCallToolResult, type WidgetResponseConfig } from "./response-helpers.js";
+import type { ResourceDefinition as NativeResourceDefinition, ResourceTemplateDefinition as NativeResourceTemplateDefinition } from "./resources.js";
+import { MCPServer as NativeMCPServer } from "./server.js";
+import type { ToolDefinition as NativeToolDefinition, ToolViewConfig } from "./tools.js";
+import type { ViewsManifest } from "./views/types.js";
+type UnknownRecord = Record<string, unknown>;
+type MaybePromise<T> = T | Promise<T>;
+/**
+ * Authenticated user shape exposed by the v1 callback context.
+ *
+ * @deprecated Temporary v1 compatibility. Native v2 providers expose their
+ * provider-specific user type at `ctx.auth.user`. Removed in mcp-use v3.
+ */
+export interface UserInfo extends UnknownRecord {
+    /** Stable v1 user identifier. */
+    userId: string;
+    /** Optional email claim. */
+    email?: string;
+    /** Optional display name. */
+    name?: string;
+    /** Optional role list. */
+    roles?: string[];
+    /** Optional permission list. */
+    permissions?: string[];
+    /** Optional scope list. */
+    scopes?: string[];
+}
+/**
+ * Authentication data exposed by v1-compatible callbacks.
+ *
+ * @deprecated Use native v2 `OAuthAuth` from `mcp-use`. Removed in mcp-use v3.
+ */
+export interface AuthInfo {
+    /** Normalized legacy user object. */
+    user: UserInfo;
+    /** Verified token payload. */
+    payload: UnknownRecord;
+    /** Original bearer token. */
+    accessToken: string;
+    /** Granted scopes. */
+    scopes: string[];
+    /** Granted permissions. */
+    permissions: string[];
+}
+/**
+ * v1 client helpers plus the v1 `supportsApps()` spelling.
+ *
+ * @deprecated Use native v2 `RequestClientContext`; replace `supportsApps()`
+ * with `supportsViews()`. Removed in mcp-use v3.
+ */
+export interface ClientCapabilityChecker extends RequestClientContext {
+    /** Alias for native v2 `supportsViews()`. */
+    supportsApps(): boolean;
+}
+/**
+ * Common v1 callback context translated onto the request-scoped v2 context.
+ * Session-backed sampling and blocking elicitation are intentionally absent.
+ *
+ * @deprecated Use native v2 `RequestContext` from `mcp-use`. Removed in
+ * mcp-use v3.
+ */
+export type McpContext<_HasOAuth extends boolean = false> = Omit<RequestContext<never, false>, "auth" | "client"> & {
+    /** v1-compatible client metadata helpers. */
+    client: ClientCapabilityChecker;
+    /** v1 name for native v2 `sendLog()`. */
+    log(level: "debug" | "info" | "notice" | "warning" | "error" | "critical" | "alert" | "emergency", data: unknown, logger?: string): Promise<void>;
+} & {
+    /**
+     * v1 authentication context. The compatibility entry keeps this
+     * non-optional because the v1 constructor inferred OAuth from
+     * `config.oauth`; callbacks still only receive it when OAuth is configured.
+     */
+    auth: AuthInfo;
+};
+/**
+ * Common v1 CORS option names.
+ *
+ * @deprecated Use `CorsOptions` from `mcp-use`. Removed in mcp-use v3.
+ */
+export interface CorsOptions {
+    /** Allowed response origin or origins. */
+    origin?: string | string[];
+    /** v1 spelling for allowed HTTP methods. */
+    allowMethods?: string[];
+    /** v1 spelling for allowed request headers. */
+    allowHeaders?: string[];
+    /** Whether credentials are allowed. */
+    credentials?: boolean;
+}
+/**
+ * Common v1 constructor configuration supported by the temporary bridge.
+ *
+ * @deprecated Use `ServerConfig` from `mcp-use`. Removed in mcp-use v3.
+ */
+export interface ServerConfig {
+    /** Server implementation name. */
+    name: string;
+    /** Server implementation version. */
+    version: string;
+    /** Display title. */
+    title?: string;
+    /** Server description. */
+    description?: string;
+    /** Model-facing server instructions. */
+    instructions?: string;
+    /** Node listener host. */
+    host?: string;
+    /** Node listener port. */
+    port?: number;
+    /** Public v1 server URL. */
+    baseUrl?: string;
+    /** v1 Host allowlist despite the historical option name. */
+    allowedOrigins?: string[];
+    /** v1 CORS configuration. */
+    cors?: CorsOptions;
+    /** Stateless mode is accepted only when true. */
+    stateless?: boolean;
+    /** Unsupported v1 session idle timeout. */
+    sessionIdleTimeoutMs?: number;
+    /** Unsupported v1 stale-session behavior. */
+    autoCreateSessionOnInvalidId?: boolean;
+    /** Unsupported v1 session storage. */
+    sessionStore?: unknown;
+    /** Unsupported v1 stream manager. */
+    streamManager?: unknown;
+    /** Built-in external OAuth resource-server provider. */
+    oauth?: OAuthProvider<unknown>;
+    /** Whether the landing page is public with OAuth enabled. */
+    publicLandingPage?: boolean;
+    /** Browser favicon. */
+    favicon?: string;
+    /** Server icons. */
+    icons?: NativeServerConfig["icons"];
+    /** Server website. */
+    websiteUrl?: string;
+}
+/**
+ * v1 tool-to-widget binding.
+ *
+ * @deprecated Use native v2 `view` from `mcp-use`. Removed in mcp-use v3.
+ */
+export interface ToolWidgetConfig {
+    /** Legacy widget directory name. */
+    name: string;
+    /** Invocation status text. */
+    invoking?: string;
+    /** Completion status text. */
+    invoked?: string;
+    /** Whether the widget may call tools. */
+    widgetAccessible?: boolean;
+    /** Whether the result can open the widget. */
+    resultCanProduceWidget?: boolean;
+}
+/**
+ * Common v1 tool definition.
+ *
+ * @deprecated Use native v2 `ToolDefinition` and pass the callback separately.
+ * Removed in mcp-use v3.
+ */
+export interface ToolDefinition<TInput = UnknownRecord, TOutput = UnknownRecord, HasOAuth extends boolean = false> extends Omit<NativeToolDefinition, "inputSchema" | "view"> {
+    /** Zod/Standard Schema input definition. */
+    schema?: StandardSchemaWithJSON;
+    /** Unsupported legacy array schema. */
+    inputs?: unknown[];
+    /** Optional inline callback. */
+    cb?: ToolCallback<TInput, TOutput, HasOAuth>;
+    /** Legacy widget binding. */
+    widget?: ToolWidgetConfig;
+}
+/**
+ * Common v1 tool callback.
+ *
+ * @deprecated Use native v2 `ToolCallback` from `mcp-use`. Removed in mcp-use
+ * v3.
+ */
+export type ToolCallback<TInput = UnknownRecord, TOutput = UnknownRecord, HasOAuth extends boolean = false> = (params: TInput, ctx: McpContext<HasOAuth>) => MaybePromise<CallToolResult | TypedCallToolResult<Extract<TOutput, UnknownRecord>> | ToolContentResult>;
+/**
+ * Infer v1 tool input from its Standard Schema.
+ *
+ * @deprecated Use native v2 `InferToolInput`. Removed in mcp-use v3.
+ */
+export type InferToolInput<T> = T extends {
+    schema: infer S extends StandardSchemaWithJSON;
+} ? StandardSchemaWithJSON.InferOutput<S> : UnknownRecord;
+/**
+ * Infer v1 tool structured output from its Standard Schema.
+ *
+ * @deprecated Use native v2 `InferToolOutput`. Removed in mcp-use v3.
+ */
+export type InferToolOutput<T> = T extends {
+    outputSchema: infer S extends StandardSchemaWithJSON;
+} ? StandardSchemaWithJSON.InferOutput<S> : UnknownRecord;
+/**
+ * Common v1 static-resource definition.
+ *
+ * @deprecated Use native v2 `ResourceDefinition` and pass the reader
+ * separately. Removed in mcp-use v3.
+ */
+export interface ResourceDefinition<HasOAuth extends boolean = false> extends NativeResourceDefinition {
+    /** Optional inline v1 reader. */
+    readCallback?: ReadResourceCallback<HasOAuth>;
+    /** Legacy completion container; ignored for static resources. */
+    callbacks?: {
+        complete?: Record<string, unknown>;
+    };
+}
+/**
+ * Common v1 static-resource callback. The first argument is context, not URI.
+ *
+ * @deprecated Use native v2 `ResourceCallback`. Removed in mcp-use v3.
+ */
+export type ReadResourceCallback<HasOAuth extends boolean = false> = (ctx: McpContext<HasOAuth>) => MaybePromise<ReadResourceResult | CallToolResult>;
+/**
+ * v1 nested resource-template configuration.
+ *
+ * @deprecated Use native v2 `ResourceTemplateDefinition`. Removed in mcp-use
+ * v3.
+ */
+export interface ResourceTemplateConfig {
+    /** RFC 6570 URI template. */
+    uriTemplate: string;
+    /** Optional nested name. */
+    name?: string;
+    /** MIME type. */
+    mimeType?: string;
+    /** Description. */
+    description?: string;
+    /** Legacy completion callbacks. */
+    callbacks?: {
+        complete?: Record<string, unknown>;
+    };
+}
+/**
+ * Common nested or flat v1 resource-template definition.
+ *
+ * @deprecated Use native v2 `ResourceTemplateDefinition`. Removed in mcp-use
+ * v3.
+ */
+export interface ResourceTemplateDefinition<HasOAuth extends boolean = false> {
+    /** Registration name. */
+    name: string;
+    /** Flat v1 URI-template form. */
+    uriTemplate?: string;
+    /** Nested v1 URI-template form. */
+    resourceTemplate?: ResourceTemplateConfig;
+    /** Optional title. */
+    title?: string;
+    /** Optional description. */
+    description?: string;
+    /** Optional MIME type. */
+    mimeType?: string;
+    /** Optional annotations. */
+    annotations?: NativeResourceTemplateDefinition["annotations"];
+    /** Optional descriptor metadata. */
+    _meta?: NativeResourceTemplateDefinition["_meta"];
+    /** Schema used only for v1 parameter inference. */
+    schema?: StandardSchemaWithJSON;
+    /** Legacy completion callbacks. */
+    callbacks?: {
+        complete?: Record<string, unknown>;
+    };
+    /** Optional inline reader. */
+    readCallback?: ReadResourceTemplateCallback<UnknownRecord, HasOAuth>;
+}
+/**
+ * Common v1 resource-template callback signatures.
+ *
+ * @deprecated Use native v2 `ResourceTemplateCallback`. Removed in mcp-use
+ * v3.
+ */
+export type ReadResourceTemplateCallback<TParams extends UnknownRecord = Record<string, string>, HasOAuth extends boolean = false> = (uri: URL, params: TParams, ctx: McpContext<HasOAuth>) => MaybePromise<ReadResourceResult | CallToolResult | TypedCallToolResult<UnknownRecord> | ToolContentResult>;
+/** Infer v1 resource-template parameters from an optional Standard Schema. */
+type InferResourceTemplateParams<T> = T extends {
+    schema: infer S extends StandardSchemaWithJSON;
+} ? Extract<StandardSchemaWithJSON.InferOutput<S>, UnknownRecord> : Record<string, string>;
+/**
+ * Common v1 prompt definition.
+ *
+ * @deprecated Use native v2 `PromptDefinition` and pass the callback
+ * separately. Removed in mcp-use v3.
+ */
+export interface PromptDefinition<TInput = UnknownRecord, HasOAuth extends boolean = false> extends NativePromptDefinition {
+    /** Unsupported legacy argument array. */
+    args?: unknown[];
+    /** Optional inline v1 callback. */
+    cb?: PromptCallback<TInput, HasOAuth>;
+}
+/**
+ * Common v1 prompt callback.
+ *
+ * @deprecated Use native v2 `PromptCallback`. Removed in mcp-use v3.
+ */
+export type PromptCallback<TInput = UnknownRecord, HasOAuth extends boolean = false> = (params: TInput, ctx: McpContext<HasOAuth>) => MaybePromise<GetPromptResult | CallToolResult>;
+/**
+ * Infer v1 prompt input from its Standard Schema.
+ *
+ * @deprecated Use native v2 `InferPromptInput`. Removed in mcp-use v3.
+ */
+export type InferPromptInput<T> = T extends {
+    schema: infer S extends StandardSchemaWithJSON;
+} ? StandardSchemaWithJSON.InferOutput<S> : UnknownRecord;
+interface LegacyWidgetMetadata {
+    title?: string;
+    description?: string;
+    props?: StandardSchemaWithJSON | unknown[];
+    inputs?: StandardSchemaWithJSON | unknown[];
+    schema?: StandardSchemaWithJSON | unknown[];
+    toolOutput?: CallToolResult | ((params: UnknownRecord) => MaybePromise<CallToolResult>);
+    exposeAsTool?: boolean;
+    annotations?: NativeToolDefinition["annotations"];
+    _meta?: UnknownRecord;
+    metadata?: {
+        description?: string;
+        csp?: ToolViewConfig["csp"];
+        prefersBorder?: boolean;
+        domain?: string;
+        widgetDescription?: string;
+        autoResize?: boolean;
+        invoking?: string;
+        invoked?: string;
+    };
+    appsSdkMetadata?: {
+        "openai/widgetDescription"?: string;
+        "openai/widgetCSP"?: {
+            connect_domains?: string[];
+            resource_domains?: string[];
+            frame_domains?: string[];
+        };
+        "openai/widgetPrefersBorder"?: boolean;
+        "openai/widgetDomain"?: string;
+    };
+}
+/**
+ * Temporary v1-compatible server facade backed by the native stateless v2
+ * server.
+ *
+ * @deprecated Temporary v1 compatibility. Import `MCPServer` from `mcp-use`.
+ * Removed in mcp-use v3.
+ */
+export declare class MCPServer<HasOAuth extends boolean = false, TEnv extends Env = Env> {
+    #private;
+    /** Original v1 configuration. */
+    readonly config: ServerConfig;
+    /** Native Hono application. */
+    readonly app: NativeMCPServer<unknown, TEnv>["app"];
+    /** Native Web-standard fetch handler. */
+    readonly fetch: NativeMCPServer<unknown, TEnv>["fetch"];
+    /** Native Hono GET route helper. */
+    readonly get: NativeMCPServer<unknown, TEnv>["get"];
+    /** Native Hono POST route helper. */
+    readonly post: NativeMCPServer<unknown, TEnv>["post"];
+    /** Native Hono PUT route helper. */
+    readonly put: NativeMCPServer<unknown, TEnv>["put"];
+    /** Native Hono PATCH route helper. */
+    readonly patch: NativeMCPServer<unknown, TEnv>["patch"];
+    /** Native Hono DELETE route helper. */
+    readonly delete: NativeMCPServer<unknown, TEnv>["delete"];
+    /** Native Hono all-method route helper. */
+    readonly all: NativeMCPServer<unknown, TEnv>["all"];
+    /** Native HTTP/MCP middleware registration. */
+    readonly use: NativeMCPServer<unknown, TEnv>["use"];
+    /** Native MCP observer registration. */
+    readonly on: NativeMCPServer<unknown, TEnv>["on"];
+    /** Configured listener host. */
+    readonly serverHost: string;
+    /** Actual listener port after standalone `listen()`. */
+    serverPort?: number;
+    /** Configured public URL. */
+    readonly serverBaseUrl?: string;
+    /**
+     * Create a v1-compatible facade.
+     *
+     * @param config - Common v1 server configuration.
+     */
+    constructor(config: ServerConfig);
+    /**
+     * Create a v1-compatible server from an OpenAPI document.
+     *
+     * @deprecated Use native v2 `MCPServer.fromOpenAPI()` from `mcp-use`.
+     * Removed in mcp-use v3.
+     */
+    static fromOpenAPI(options: FromOpenAPIOptions): MCPServer;
+    /** Native v2 MCP route path. */
+    get basePath(): string;
+    /** Configured native listener host. */
+    get host(): string | undefined;
+    /** Configured native listener port. */
+    get port(): number | undefined;
+    /** Native normalized branding. */
+    get branding(): NativeMCPServer<unknown, TEnv>["branding"];
+    /**
+     * Register a common v1 tool shape.
+     *
+     * @returns This facade for v1 method chaining.
+     */
+    tool<T extends Omit<ToolDefinition, "cb">>(definition: T & {
+        cb: ToolCallback<InferToolInput<T>, InferToolOutput<T>, HasOAuth>;
+    }): this;
+    /** Register a common v1 tool with a separate callback. */
+    tool<T extends Omit<ToolDefinition, "cb">>(definition: T, callback: ToolCallback<InferToolInput<T>, InferToolOutput<T>, HasOAuth>): this;
+    /** Register a common v1 static resource. */
+    resource(definition: ResourceDefinition<HasOAuth>, callback?: ReadResourceCallback<HasOAuth>): this;
+    /** Register a common nested or flat v1 resource template. */
+    resourceTemplate<T extends Omit<ResourceTemplateDefinition<HasOAuth>, "readCallback">>(definition: T & {
+        readCallback: ReadResourceTemplateCallback<InferResourceTemplateParams<T>, HasOAuth>;
+    }): this;
+    resourceTemplate<T extends Omit<ResourceTemplateDefinition<HasOAuth>, "readCallback">>(definition: T, callback: ReadResourceTemplateCallback<InferResourceTemplateParams<T>, HasOAuth>): this;
+    /** Register a common v1 prompt shape. */
+    prompt<T extends Omit<PromptDefinition, "cb">>(definition: T & {
+        cb: PromptCallback<InferPromptInput<T>, HasOAuth>;
+    }): this;
+    /** Register a common v1 prompt with a separate callback. */
+    prompt<T extends Omit<PromptDefinition, "cb">>(definition: T, callback: PromptCallback<InferPromptInput<T>, HasOAuth>): this;
+    /**
+     * Start a standalone listener. Inside `mcp-use dev/build/start`, the call is
+     * captured because the CLI owns the listener.
+     */
+    listen(port?: number, options?: Parameters<NativeMCPServer<unknown, TEnv>["listen"]>[1]): Promise<void | {
+        port: number;
+        url: string;
+    }>;
+    /** Close the native v2 server. */
+    close(): Promise<void>;
+    /** Deprecated v1 handler accessor backed by native `fetch`. */
+    getHandler(): typeof this.fetch;
+    /** Delegate supported HTTP upstream proxy registrations to v2. */
+    proxy(...args: Parameters<NativeMCPServer<unknown, TEnv>["proxy"]>): Promise<void>;
+    /** Delegate resource-update notifications to v2. */
+    notifyResourceUpdated(uri: string): Promise<void>;
+    /** @internal Called by the v2 CLI before view priming. */
+    __registerLegacyViews(widgets: Record<string, {
+        widgetMetadata?: LegacyWidgetMetadata;
+    }>): void;
+    /** @internal Prime the native view manifest after legacy metadata loading. */
+    __primeViews(views: ViewsManifest, options?: {
+        dev?: boolean;
+        projectRoot?: string;
+    }): void;
+    /** @internal Mount and validate the native v2 application. */
+    __mount(): void;
+    /** @internal Attach the CLI development event bus. */
+    __setEventBus(bus: Parameters<NativeMCPServer<unknown, TEnv>["__setEventBus"]>[0]): void;
+}
+/**
+ * Create a v1-compatible server using the old name-plus-config factory.
+ *
+ * @deprecated Use `new MCPServer(...)` from `mcp-use`. Removed in mcp-use v3.
+ */
+export declare function createMCPServer(name: string, config?: Partial<ServerConfig>): MCPServer;
+/**
+ * v1 array helper preserving `structuredContent: { data }`.
+ *
+ * @deprecated Return a raw v2 tool result. Removed in mcp-use v3.
+ */
+export declare function array<T extends unknown[]>(data: T): CallToolResult;
+/**
+ * v1 widget helper that always emits an object `structuredContent` value.
+ *
+ * @deprecated Register a native v2 `view` and return a raw result. Removed in
+ * mcp-use v3.
+ */
+export declare function widget<TProps extends UnknownRecord = UnknownRecord>(config: WidgetResponseConfig<TProps>): TypedCallToolResult<TProps>;
+/** @deprecated Import `text` from `mcp-use` only while migrating. Removed in mcp-use v3. */
+export { text };
+/** @deprecated Import `markdown` from `mcp-use` only while migrating. Removed in mcp-use v3. */
+export { markdown };
+/** @deprecated Import `html` from `mcp-use` only while migrating. Removed in mcp-use v3. */
+export { html };
+/** @deprecated Import `xml` from `mcp-use` only while migrating. Removed in mcp-use v3. */
+export { xml };
+/** @deprecated Import `css` from `mcp-use` only while migrating. Removed in mcp-use v3. */
+export { css };
+/** @deprecated Import `javascript` from `mcp-use` only while migrating. Removed in mcp-use v3. */
+export { javascript };
+/** @deprecated Import `object` from `mcp-use` only while migrating. Removed in mcp-use v3. */
+export { object };
+/** @deprecated Import `image` from `mcp-use` only while migrating. Removed in mcp-use v3. */
+export { image };
+/** @deprecated Import `audio` from `mcp-use` only while migrating. Removed in mcp-use v3. */
+export { audio };
+/** @deprecated Import `binary` from `mcp-use` only while migrating. Removed in mcp-use v3. */
+export { binary };
+/** @deprecated Import `resource` from `mcp-use` only while migrating. Removed in mcp-use v3. */
+export { resource };
+/** @deprecated Import `mix` from `mcp-use` only while migrating. Removed in mcp-use v3. */
+export { mix };
+/** @deprecated Import `error` from `mcp-use` only while migrating. Removed in mcp-use v3. */
+export { error };
+/** @deprecated Import `completable` from `mcp-use` only while migrating. Removed in mcp-use v3. */
+export { completable } from "./completable.js";
+/** @deprecated Use raw v2 result types from `mcp-use`. Removed in mcp-use v3. */
+export type { ToolContentResult, TypedCallToolResult, WidgetResponseConfig };
+/** @deprecated Use raw SDK result types from `mcp-use`. Removed in mcp-use v3. */
+export type { CallToolResult, GetPromptResult, ReadResourceResult };
+/** @deprecated Use native v2 OpenAPI types from `mcp-use`. Removed in mcp-use v3. */
+export type { FromOpenAPIOptions, OpenAPIAuth, OpenAPIDocument, OpenAPIExcludeRule, } from "./openapi/types.js";
+/** @deprecated Import from `mcp-use/oauth/*`. Removed in mcp-use v3. */
+export { oauthAuth0Provider, oauthBetterAuthProvider, oauthClerkProvider, oauthKeycloakProvider, oauthSupabaseProvider, oauthWorkOSProvider, } from "./compat-v1/oauth.js";
+/** @deprecated Use native v2 middleware types from `mcp-use`. Removed in mcp-use v3. */
+export type { McpMiddlewareFn, McpMiddlewareFnFor, McpMiddlewarePattern, MiddlewareContext, } from "./middleware/mcp-middleware.js";
+/**
+ * Read v1-compatible authentication data from a tool or Hono context.
+ *
+ * @deprecated Read `ctx.auth` directly in native v2. Removed in mcp-use v3.
+ */
+export declare function getAuth(context: McpContext<boolean> | Context): AuthInfo;
+/** @deprecated Check `ctx.auth.scopes` in native v2. Removed in mcp-use v3. */
+export declare function hasScope(context: McpContext<boolean> | Context, needed: string | string[]): boolean;
+/** @deprecated Check `ctx.auth.scopes` in native v2. Removed in mcp-use v3. */
+export declare function hasAnyScope(context: McpContext<boolean> | Context, needed: string[]): boolean;
+/** @deprecated Write native v2 Hono middleware. Removed in mcp-use v3. */
+export declare function requireScope(needed: string | string[]): (context: Context, next: Next) => Promise<Response | void>;
+/** @deprecated Write native v2 Hono middleware. Removed in mcp-use v3. */
+export declare function requireAnyScope(needed: string[]): (context: Context, next: Next) => Promise<Response | void>;