@mcp-native/webview 0.4.0 → 0.5.0

package/dist/bridge.d.ts

@@ -0,0 +1,69 @@
+import type { JsonObject, McpReadResourceResult, McpTool, McpToolCallResult } from "@mcp-native/core";
+import { McpAppsError } from "./apps.js";
+import type { McpAppsResource } from "./apps.js";
+import type { McpAppsNativeSandboxConfiguration } from "./sandbox.js";
+export declare const MCP_APPS_MAX_BRIDGE_MESSAGE_LENGTH = 1048576;
+export declare const MCP_APPS_MAX_PENDING_REQUESTS = 128;
+export type McpAppsDisplayMode = "fullscreen" | "inline" | "pip";
+export type McpAppsBridgeState = "awaiting-initialize" | "awaiting-initialized" | "ready" | "closing" | "closed";
+export type McpAppsContentModality = "audio" | "image" | "resource" | "resourceLink" | "structuredContent" | "text";
+export interface McpAppsBridgeHandlers {
+    readonly callTool?: (name: string, arguments_: JsonObject, requestMeta?: JsonObject) => McpToolCallResult | Promise<McpToolCallResult>;
+    readonly readResource?: (uri: string, requestMeta?: JsonObject) => McpReadResourceResult | Promise<McpReadResourceResult>;
+    readonly openLink?: (url: string) => boolean | Promise<boolean>;
+    readonly downloadFile?: (contents: readonly JsonObject[]) => void | Promise<void>;
+    readonly sendMessage?: (message: JsonObject) => void | Promise<void>;
+    readonly updateModelContext?: (context: JsonObject) => void | Promise<void>;
+    readonly requestDisplayMode?: (mode: McpAppsDisplayMode) => McpAppsDisplayMode | Promise<McpAppsDisplayMode>;
+    readonly log?: (message: JsonObject) => void | Promise<void>;
+    readonly sizeChanged?: (size: {
+        readonly width?: number;
+        readonly height?: number;
+    }) => void;
+    readonly requestTeardown?: () => void | Promise<void>;
+}
+export interface McpAppsBridgeOptions {
+    readonly postMessage: (serializedMessage: string) => void | Promise<void>;
+    readonly hostInfo: {
+        readonly name: string;
+        readonly version: string;
+        readonly title?: string;
+        readonly websiteUrl?: string;
+    };
+    readonly hostContext?: unknown;
+    readonly tools?: readonly McpTool[];
+    readonly resource: McpAppsResource;
+    readonly sandbox: McpAppsNativeSandboxConfiguration;
+    readonly handlers?: McpAppsBridgeHandlers;
+    readonly messageModalities?: readonly McpAppsContentModality[];
+    readonly updateModelContextModalities?: readonly McpAppsContentModality[];
+    readonly onProtocolError?: (error: McpAppsBridgeError) => void;
+    readonly onTeardownComplete?: (result: "error" | "success") => void;
+}
+export declare class McpAppsBridgeError extends McpAppsError {
+    readonly code: number;
+    constructor(message: string, code?: number, options?: ErrorOptions);
+}
+type RequestId = number | string;
+/**
+ * Stable MCP Apps host lifecycle for a single native WebView. Incoming data is
+ * schema-shaped and bounded before any host callback runs.
+ */
+export declare class McpAppsBridge {
+    #private;
+    constructor(options: McpAppsBridgeOptions);
+    get state(): McpAppsBridgeState;
+    get hostCapabilities(): JsonObject;
+    /** Receives a serialized native WebView message or an already-decoded test value. */
+    receive(value: unknown): Promise<void>;
+    sendToolInput(arguments_?: unknown): Promise<void>;
+    sendPartialToolInput(arguments_?: unknown): Promise<void>;
+    sendToolResult(result: McpToolCallResult): Promise<void>;
+    sendToolCancelled(reason?: string): Promise<void>;
+    sendHostContextChanged(context: unknown): Promise<void>;
+    /** Begins graceful teardown. The View's matching response closes the bridge. */
+    requestResourceTeardown(): Promise<RequestId>;
+    close(): void;
+}
+export {};
+//# sourceMappingURL=bridge.d.ts.map

package/dist/bridge.d.ts.map

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