mcp-use 2.0.0-beta.63 → 2.0.0-beta.65

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

@@ -1,221 +0,0 @@
-/**
- * Deprecated browser adapters for unchanged mcp-use v1 widgets.
- *
- * The adapters are deliberately composed from the native v2 runtime and
- * hooks. They do not recreate the v1 bridge or its global event machinery.
- */
-import type { CallToolResult, StandardSchemaWithJSON } from "@modelcontextprotocol/server";
-import React, { type ReactNode } from "react";
-import { ViewControls } from "./components/view-controls.js";
-import type { DisplayMode, SafeAreaInsets } from "./types/host-types.js";
-/** @deprecated Use native v2 registered result types. Removed in mcp-use v3. */
-export type UnknownObject = Record<string, unknown>;
-/** @deprecated Use native v2 host types. Removed in mcp-use v3. */
-export type Theme = "light" | "dark";
-/**
- * Metadata accepted by `resources/<name>/widget.tsx` during v1 compatibility
- * discovery.
- *
- * @deprecated Export native v2 `viewConfig` from `views/<name>/view.tsx` and
- * bind resource facts on the server tool. Removed in mcp-use v3.
- */
-export interface WidgetMetadata {
-    /** Widget title. */
-    title?: string;
-    /** Widget description. */
-    description?: string;
-    /** Widget props/input schema. */
-    props?: StandardSchemaWithJSON | unknown[];
-    /** Deprecated alias for props. */
-    inputs?: StandardSchemaWithJSON | unknown[];
-    /** Deprecated alias for props. */
-    schema?: StandardSchemaWithJSON | unknown[];
-    /** Model-facing output for an auto-registered widget tool. */
-    toolOutput?: CallToolResult | ((params: UnknownObject) => CallToolResult | Promise<CallToolResult>);
-    /** Whether CLI discovery auto-registers a same-named tool. */
-    exposeAsTool?: boolean;
-    /** Tool/resource annotations used by the compatibility registration. */
-    annotations?: UnknownObject;
-    /** Extension metadata. */
-    _meta?: UnknownObject;
-    /** Unified legacy widget metadata. */
-    metadata?: {
-        /** Resource description. */
-        description?: string;
-        /** MCP Apps CSP. */
-        csp?: UnknownObject;
-        /** Host border preference. */
-        prefersBorder?: boolean;
-        /** Dedicated view domain. */
-        domain?: string;
-        /** Human-readable Apps SDK widget summary. */
-        widgetDescription?: string;
-        /** Whether the v2 bootstrap automatically reports size changes. */
-        autoResize?: boolean;
-        /** Invocation status text. */
-        invoking?: string;
-        /** Completion status text. */
-        invoked?: string;
-    };
-    /** Legacy OpenAI Apps SDK resource metadata. */
-    appsSdkMetadata?: UnknownObject;
-}
-/**
- * v1 provider props translated onto native v2 theme and control components.
- *
- * @deprecated Compose native v2 view components directly. Removed in mcp-use
- * v3.
- */
-export interface McpUseProviderProps {
-    /** Widget children. */
-    children: ReactNode;
-    /** Show the debug overlay. */
-    debugger?: boolean;
-    /** Show display-mode controls. */
-    viewControls?: boolean | "pip" | "fullscreen";
-    /** Retained for source compatibility; sizing is owned by viewConfig/bootstrap. */
-    autoSize?: boolean;
-    /** Apply the active theme as the document color scheme. */
-    colorScheme?: boolean;
-}
-/**
- * v1 widget provider composed over the native v2 view runtime.
- *
- * @deprecated Use native v2 hooks/components from `mcp-use/react`. Removed in
- * mcp-use v3.
- */
-export declare function McpUseProvider({ children, debugger: enableDebugger, viewControls, colorScheme, }: McpUseProviderProps): React.ReactElement;
-/** @deprecated Use native v2 `CallToolResult`. Removed in mcp-use v3. */
-export interface CallToolResponse extends CallToolResult {
-    /** Joined text content convenience field. */
-    result: string;
-}
-/** @deprecated Use native v2 `SafeAreaInsets`. Removed in mcp-use v3. */
-export interface SafeArea {
-    /** Host safe-area insets. */
-    insets: SafeAreaInsets;
-}
-/** @deprecated Use native v2 host context. Removed in mcp-use v3. */
-export interface UserAgent {
-    /** Coarse device category. */
-    device: {
-        type: "mobile" | "tablet" | "desktop" | "unknown";
-    };
-    /** Input capabilities. */
-    capabilities: {
-        hover: boolean;
-        touch: boolean;
-    };
-}
-/**
- * Common v1 `useWidget()` return surface.
- *
- * @deprecated Use focused native v2 hooks such as `useToolContext`,
- * `useHostContext`, and `useCallTool`. Removed in mcp-use v3.
- */
-interface UseWidgetResultBase<TState = UnknownObject, TOutput = UnknownObject, TMetadata = UnknownObject, TToolInput = UnknownObject> {
-    /** Complete or partial tool input. */
-    toolInput: TToolInput;
-    /** Structured tool output, or null while pending/error. */
-    output: TOutput | null;
-    /** Tool result metadata. */
-    metadata: TMetadata | null;
-    /** Locally cached model-visible widget state. */
-    state: TState | null;
-    /** Update model-visible widget state. */
-    setState(state: TState | ((previous: TState | null) => TState)): Promise<void>;
-    /** Active host theme. */
-    theme: Theme;
-    /** Current display mode. */
-    displayMode: DisplayMode;
-    /** Host safe-area wrapper. */
-    safeArea: SafeArea;
-    /** Maximum host height, using the v1 600px default when unbounded. */
-    maxHeight: number;
-    /** Maximum host width. */
-    maxWidth?: number;
-    /** v1 device summary. */
-    userAgent: UserAgent;
-    /** Host locale. */
-    locale: string;
-    /** Host timezone. */
-    timeZone: string;
-    /** Public MCP origin exposed inside the sandbox. */
-    mcp_url: string;
-    /** Call any server tool through the native MCP Apps bridge. */
-    callTool(name: string, args: UnknownObject): Promise<CallToolResponse>;
-    /** Send a follow-up user message. */
-    sendFollowUpMessage(content: string | Array<{
-        type: string;
-        [key: string]: unknown;
-    }>): Promise<void>;
-    /** Ask the host to open an external URL. */
-    openExternal(href: string): void;
-    /** Request a host display mode. */
-    requestDisplayMode(mode: DisplayMode): Promise<{
-        mode: DisplayMode;
-    }>;
-    /** Whether the native MCP Apps bridge is connected. */
-    isAvailable: boolean;
-    /** Best-effort partial input while pending. */
-    partialToolInput: Partial<TToolInput> | null;
-    /** Whether partial input is currently available. */
-    isStreaming: boolean;
-    /** Connected host identity. */
-    hostInfo?: {
-        name: string;
-        version: string;
-    };
-    /** Connected host capabilities. */
-    hostCapabilities?: UnknownObject;
-    /** Raw native host context. */
-    hostContext?: UnknownObject;
-}
-/**
- * Common v1 `useWidget()` return surface. `isPending` narrows `props` exactly
- * as it did in v1, so unchanged widgets can safely render required props.
- *
- * @deprecated Use focused native v2 hooks. Removed in mcp-use v3.
- */
-export type UseWidgetResult<TProps = UnknownObject, TState = UnknownObject, TOutput = UnknownObject, TMetadata = UnknownObject, TToolInput = UnknownObject> = UseWidgetResultBase<TState, TOutput, TMetadata, TToolInput> & ({
-    isPending: true;
-    props: Partial<TProps>;
-} | {
-    isPending: false;
-    props: TProps;
-});
-/**
- * v1 all-in-one widget hook implemented from the native v2 runtime channels.
- *
- * @deprecated Use focused native v2 hooks from `mcp-use/react`. Removed in
- * mcp-use v3.
- */
-export declare function useWidget<TProps = UnknownObject, TState = UnknownObject, TOutput = UnknownObject, TMetadata = UnknownObject, TToolInput = UnknownObject>(defaultProps?: TProps): UseWidgetResult<TProps, TState, TOutput, TMetadata, TToolInput>;
-/**
- * Read v1 widget props.
- *
- * @deprecated Use native v2 `useToolContext`. Removed in mcp-use v3.
- */
-export declare function useWidgetProps<TProps = UnknownObject>(defaultProps?: TProps): Partial<TProps>;
-/**
- * Read the v1 widget theme.
- *
- * @deprecated Use native v2 `useViewTheme`. Removed in mcp-use v3.
- */
-export declare function useWidgetTheme(): Theme;
-/**
- * Read and update v1 widget state.
- *
- * @deprecated Use native v2 model-context APIs. Removed in mcp-use v3.
- */
-export declare function useWidgetState<TState>(defaultState?: TState): readonly [
-    TState | null,
-    (state: TState | ((previous: TState | null) => TState)) => Promise<void>
-];
-/**
- * v1 name for native v2 `ViewControls`.
- *
- * @deprecated Use `ViewControls`. Removed in mcp-use v3.
- */
-export declare const WidgetControls: typeof ViewControls;
-export {};