@mcp-use/client 2.0.0-beta.16 → 2.0.0-beta.17

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (65) hide show
  1. package/dist/.tsbuildinfo +1 -1
  2. package/dist/auth/browser.d.ts +51 -2
  3. package/dist/auth/browser.d.ts.map +1 -1
  4. package/dist/auth/node.d.ts +99 -4
  5. package/dist/auth/node.d.ts.map +1 -1
  6. package/dist/auth/session-store.d.ts +6 -0
  7. package/dist/auth/session-store.d.ts.map +1 -1
  8. package/dist/core/base.d.ts +4 -8
  9. package/dist/core/base.d.ts.map +1 -1
  10. package/dist/core/browser.d.ts +14 -2
  11. package/dist/core/browser.d.ts.map +1 -1
  12. package/dist/core/config.d.ts +82 -20
  13. package/dist/core/config.d.ts.map +1 -1
  14. package/dist/core/node.d.ts +7 -10
  15. package/dist/core/node.d.ts.map +1 -1
  16. package/dist/core/session.d.ts +18 -4
  17. package/dist/core/session.d.ts.map +1 -1
  18. package/dist/index-browser.d.ts +1 -0
  19. package/dist/index-browser.d.ts.map +1 -1
  20. package/dist/index-browser.js +142 -21
  21. package/dist/index-browser.js.map +1 -1
  22. package/dist/index.d.ts +1 -1
  23. package/dist/index.js +218 -31
  24. package/dist/index.js.map +1 -1
  25. package/dist/react/McpClientProvider.d.ts +22 -10
  26. package/dist/react/McpClientProvider.d.ts.map +1 -1
  27. package/dist/react/index.d.ts +2 -0
  28. package/dist/react/index.d.ts.map +1 -1
  29. package/dist/react/index.js +164 -21
  30. package/dist/react/index.js.map +1 -1
  31. package/dist/react/rpc-logger.d.ts +5 -0
  32. package/dist/react/rpc-logger.d.ts.map +1 -1
  33. package/dist/react/storage.d.ts +47 -0
  34. package/dist/react/storage.d.ts.map +1 -1
  35. package/dist/react/types.d.ts +107 -16
  36. package/dist/react/types.d.ts.map +1 -1
  37. package/dist/react/useMcp-operations.d.ts.map +1 -1
  38. package/dist/react/view/ViewRenderer.d.ts +7 -0
  39. package/dist/react/view/ViewRenderer.d.ts.map +1 -1
  40. package/dist/react/view/parse-custom-props.d.ts +8 -0
  41. package/dist/react/view/parse-custom-props.d.ts.map +1 -1
  42. package/dist/react/view/resolve-view-resource.d.ts +10 -0
  43. package/dist/react/view/resolve-view-resource.d.ts.map +1 -1
  44. package/dist/react/view/types.d.ts +89 -0
  45. package/dist/react/view/types.d.ts.map +1 -1
  46. package/dist/react/view/view-detection.d.ts +18 -0
  47. package/dist/react/view/view-detection.d.ts.map +1 -1
  48. package/dist/react/view/view-host-policy.d.ts +35 -0
  49. package/dist/react/view/view-host-policy.d.ts.map +1 -1
  50. package/dist/telemetry/telemetry.d.ts +5 -1
  51. package/dist/telemetry/telemetry.d.ts.map +1 -1
  52. package/dist/transport/base.d.ts +85 -13
  53. package/dist/transport/base.d.ts.map +1 -1
  54. package/dist/transport/connection-manager.d.ts +1 -1
  55. package/dist/transport/http.d.ts +51 -2
  56. package/dist/transport/http.d.ts.map +1 -1
  57. package/dist/transport/stdio.d.ts +29 -1
  58. package/dist/transport/stdio.d.ts.map +1 -1
  59. package/dist/utils/elicitation.d.ts +4 -2
  60. package/dist/utils/elicitation.d.ts.map +1 -1
  61. package/dist/utils/logging.d.ts +1 -0
  62. package/dist/utils/logging.d.ts.map +1 -1
  63. package/dist/utils/version.d.ts +6 -0
  64. package/dist/utils/version.d.ts.map +1 -1
  65. package/package.json +4 -4
@@ -3,110 +3,193 @@ import type { CreateMessageRequest, CreateMessageResult, CreateMessageResultWith
3
3
  export type { McpUiDownloadFileRequest, McpUiDownloadFileResult, McpUiHostCapabilities, McpUiHostContext, McpUiResourceCsp, McpUiResourcePermissions, McpUiSupportedContentBlockModalities, };
4
4
  import type { Transport } from "@modelcontextprotocol/client";
5
5
  import type { ReactNode } from "react";
6
+ /** Display mode requested by an MCP App. */
6
7
  export type ViewDisplayMode = "inline" | "pip" | "fullscreen";
8
+ /** Policy used to enforce an MCP App's declared content security policy. */
7
9
  export type ViewCspMode = "permissive" | "widget-declared";
10
+ /** Host operations and server metadata available to a live MCP App. */
8
11
  export interface ViewConnection {
12
+ /** Calls an MCP server tool. */
9
13
  callTool: (name: string, args?: Record<string, unknown>, options?: {
10
14
  timeout?: number;
11
15
  resetTimeoutOnProgress?: boolean;
12
16
  }) => Promise<unknown>;
17
+ /** Reads an MCP resource by URI. */
13
18
  readResource: (uri: string) => Promise<unknown>;
19
+ /** Tools available to the host, including app visibility metadata. */
14
20
  tools?: readonly {
21
+ /** Tool name. */
15
22
  name: string;
23
+ /** Optional tool metadata. */
16
24
  _meta?: {
25
+ /** MCP App-specific tool metadata. */
17
26
  ui?: {
27
+ /** Surfaces allowed to invoke or receive the tool. */
18
28
  visibility?: readonly ("model" | "app")[];
19
29
  };
20
30
  };
21
31
  }[];
32
+ /** Resources available to the host. */
22
33
  resources?: readonly {
34
+ /** Resource URI. */
23
35
  uri: string;
36
+ /** Optional resource metadata. */
24
37
  _meta?: {
38
+ /** MCP App-specific resource metadata. */
25
39
  ui?: unknown;
26
40
  };
27
41
  }[];
28
42
  }
43
+ /** Live or preloaded content used to initialize a {@link ViewRenderer}. */
29
44
  export type ViewRendererSource = {
45
+ /** Selects live resource resolution. */
30
46
  kind: "live";
47
+ /** MCP connection used to read the resource and call tools. */
31
48
  connection: ViewConnection;
49
+ /** URI of the MCP App resource to load. */
32
50
  resourceUri: string;
33
51
  } | {
52
+ /** Selects preloaded HTML rendering. */
34
53
  kind: "preloaded";
54
+ /** Complete HTML document to render. */
35
55
  html: string;
56
+ /** CSP declared for the preloaded document. */
36
57
  csp?: McpUiResourceCsp;
58
+ /** Browser permissions requested by the preloaded document. */
37
59
  permissions?: McpUiResourcePermissions;
60
+ /** Whether the preloaded app prefers visible host borders. */
38
61
  prefersBorder?: boolean;
39
62
  };
63
+ /** Normalized HTML, CSP, permissions, and MIME metadata for a rendered view. */
40
64
  export type ResolvedViewResource = {
65
+ /** HTML document rendered in the sandbox. */
41
66
  html: string;
67
+ /** CSP declared by the resource before host policy is applied. */
42
68
  declaredCsp: McpUiResourceCsp | undefined;
69
+ /** CSP enforced by the host, if any. */
43
70
  csp: McpUiResourceCsp | undefined;
71
+ /** Browser permissions requested by the resource. */
44
72
  permissions: McpUiResourcePermissions | undefined;
73
+ /** Whether the app prefers a visible host border. */
45
74
  prefersBorder: boolean;
75
+ /** MIME type reported by the resource. */
46
76
  mimeType: string | undefined;
77
+ /** Whether the MIME type is the MCP App resource media type. */
47
78
  mimeTypeValid: boolean;
79
+ /** MIME validation warning, or `null` for a valid resource. */
48
80
  mimeTypeWarning: string | null;
49
81
  };
82
+ /** Browser CSP violation observed while an MCP App is running. */
50
83
  export type ViewCspViolation = {
84
+ /** CSP directive reported by the browser. */
51
85
  directive: string;
86
+ /** Effective CSP directive reported by the browser. */
52
87
  effectiveDirective?: string;
88
+ /** URI blocked by the policy. */
53
89
  blockedUri: string;
90
+ /** Source file associated with the violation. */
54
91
  sourceFile?: string | null;
92
+ /** Source line associated with the violation. */
55
93
  lineNumber?: number | null;
94
+ /** Source column associated with the violation. */
56
95
  columnNumber?: number | null;
96
+ /** Original policy text reported by the browser. */
57
97
  originalPolicy?: string;
98
+ /** Unix timestamp in milliseconds when the violation occurred. */
58
99
  timestamp: number;
59
100
  };
101
+ /** App-visible tools and the function used to call them. */
60
102
  export type ViewAppToolConnection = {
103
+ /** Tools available to the app. */
61
104
  tools: Tool[];
105
+ /** Calls an app-visible tool. */
62
106
  callTool: (name: string, args?: Record<string, unknown>) => Promise<unknown>;
63
107
  };
108
+ /** Lifecycle stage reported by a rendered MCP App. */
64
109
  export type ViewLifecycleStatus = "resolving" | "sandbox-loading" | "connecting" | "initialized" | "ready" | "tearing-down" | "closed" | "error";
110
+ /** Lifecycle update emitted by {@link ViewRenderer}. */
65
111
  export type ViewLifecycleEvent = {
112
+ /** Current lifecycle stage. */
66
113
  status: ViewLifecycleStatus;
114
+ /** Error message when `status` is `"error"`. */
67
115
  error?: string;
68
116
  };
117
+ /** Props accepted by {@link ViewRenderer}. */
69
118
  export interface ViewRendererProps {
119
+ /** Stable identifier for the view instance. */
70
120
  viewId: string;
121
+ /** Live resource or preloaded HTML to render. */
71
122
  source: ViewRendererSource;
123
+ /** Sandbox page URL or function that derives one from the resolved resource. */
72
124
  sandboxUrl?: URL | ((resolved: ResolvedViewResource) => URL);
125
+ /** Tool associated with the view. */
73
126
  toolName?: string;
127
+ /** Complete tool input forwarded to the app. */
74
128
  toolInput?: Record<string, unknown>;
129
+ /** Tool result forwarded to the app. */
75
130
  toolOutput?: unknown;
131
+ /** Partial streaming tool input forwarded to the app. */
76
132
  partialToolInput?: Record<string, unknown>;
133
+ /** String-valued custom properties forwarded to the app. */
77
134
  customProps?: Record<string, string>;
135
+ /** Whether the associated tool call was cancelled. */
78
136
  cancelled?: boolean;
137
+ /** Host identity advertised to the app. */
79
138
  hostInfo?: {
139
+ /** Stable host name. */
80
140
  name: string;
141
+ /** Host version. */
81
142
  version: string;
82
143
  };
144
+ /** Initial host context sent to the app. */
83
145
  hostContext?: McpUiHostContext;
146
+ /** Explicit host capability overrides. */
84
147
  hostCapabilities?: Partial<McpUiHostCapabilities>;
148
+ /** Content modalities accepted by the host's message handler. */
85
149
  messageCapabilities?: McpUiSupportedContentBlockModalities;
150
+ /** Content modalities accepted by the model-context handler. */
86
151
  modelContextCapabilities?: McpUiSupportedContentBlockModalities;
152
+ /** CSP enforcement mode. Defaults to `"permissive"`. */
87
153
  cspMode?: ViewCspMode;
154
+ /** Initial display mode. Defaults to `"inline"`. */
88
155
  displayMode?: ViewDisplayMode;
156
+ /** Called when the app requests a supported display mode. */
89
157
  onDisplayModeChange?: (mode: ViewDisplayMode) => void;
158
+ /** Maximum inline view width in pixels. */
90
159
  inlineMaxWidth?: number;
160
+ /** Whether to hide the built-in view chrome. */
91
161
  chromeless?: boolean;
162
+ /** Handles content the app sends to the conversation. */
92
163
  onMessage?: (content: unknown[]) => void | Promise<void>;
164
+ /** Handles sampling requests from the app. */
93
165
  onSamplingRequest?: (params: CreateMessageRequest["params"]) => Promise<CreateMessageResult | CreateMessageResultWithTools>;
166
+ /** Handles file-download requests from the app. */
94
167
  onDownloadFile?: (params: McpUiDownloadFileRequest["params"]) => Promise<McpUiDownloadFileResult>;
168
+ /** Receives the current app-visible tool connection. */
95
169
  onAppToolsChanged?: (connection: ViewAppToolConnection | null) => void;
170
+ /** Handles model-context updates from the app. */
96
171
  onModelContextUpdate?: (ctx: {
97
172
  content?: unknown;
98
173
  structuredContent?: unknown;
99
174
  }) => void | Promise<void>;
175
+ /** Handles structured log entries from the app. */
100
176
  onLog?: (entry: {
101
177
  level: string;
102
178
  data: unknown;
103
179
  }) => void;
180
+ /** Called when the app signals that it is ready. */
104
181
  onReady?: () => void;
182
+ /** Called for each view lifecycle transition. */
105
183
  onLifecycleChange?: (event: ViewLifecycleEvent) => void;
184
+ /** Called when view initialization or runtime handling fails. */
106
185
  onError?: (message: string) => void;
186
+ /** Called when the browser reports a CSP violation. */
107
187
  onCspViolation?: (violation: ViewCspViolation) => void;
188
+ /** Called after a live or preloaded resource is normalized. */
108
189
  onResourceResolved?: (resolved: ResolvedViewResource) => void;
190
+ /** Wraps the host transport before it is connected to the app bridge. */
109
191
  wrapTransport?: (transport: Transport, viewId: string) => Transport;
192
+ /** Timeout in milliseconds for app-initiated tool calls. Defaults to `600000`. */
110
193
  toolCallTimeout?: number;
111
194
  /** Dev mock of ChatGPT file APIs for local hosts (inspector). Default false. */
112
195
  mockOpenAiFileApis?: boolean;
@@ -114,7 +197,9 @@ export interface ViewRendererProps {
114
197
  onInlineHeightChange?: (height: number) => void;
115
198
  /** Inspector-only chrome shown above the iframe in fullscreen display mode. */
116
199
  fullscreenHeader?: {
200
+ /** Header title. */
117
201
  title: string;
202
+ /** Optional header icon URL. */
118
203
  iconUrl?: string | null;
119
204
  };
120
205
  /** Optional host close control for fullscreen (e.g. shared Button + icon). */
@@ -123,9 +208,13 @@ export interface ViewRendererProps {
123
208
  "data-testid": string;
124
209
  "aria-label": string;
125
210
  }) => ReactNode;
211
+ /** Additional class name applied to the view container. */
126
212
  className?: string;
213
+ /** Test identifier applied to the view container. */
127
214
  testId?: string;
215
+ /** Status text shown while the associated tool is running. */
128
216
  invoking?: string;
217
+ /** Status text shown after the associated tool completes. */
129
218
  invoked?: string;
130
219
  }
131
220
  //# sourceMappingURL=types.d.ts.map
@@ -1 +1 @@
1
- {"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/react/view/types.ts"],"names":[],"mappings":"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"}
1
+ {"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/react/view/types.ts"],"names":[],"mappings":"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"}
@@ -1,4 +1,22 @@
1
+ /**
2
+ * Reads the MCP App resource URI from tool metadata.
3
+ *
4
+ * @param toolMeta - Tool `_meta` object.
5
+ * @returns The declared view resource URI, or `null` when none is declared.
6
+ */
1
7
  export declare function getViewResourceUri(toolMeta?: Record<string, unknown>): string | null;
8
+ /**
9
+ * Tests whether tool metadata declares an MCP App resource.
10
+ *
11
+ * @param toolMeta - Tool `_meta` object.
12
+ * @returns `true` when the tool declares a view resource URI.
13
+ */
2
14
  export declare function isViewTool(toolMeta?: Record<string, unknown>): boolean;
15
+ /**
16
+ * Tests whether a resource uses the MCP App HTML media type.
17
+ *
18
+ * @param mimeType - Resource MIME type.
19
+ * @returns `true` for the MCP App resource media type.
20
+ */
3
21
  export declare function isViewResource(mimeType?: string): boolean;
4
22
  //# sourceMappingURL=view-detection.d.ts.map
@@ -1 +1 @@
1
- {"version":3,"file":"view-detection.d.ts","sourceRoot":"","sources":["../../../src/react/view/view-detection.ts"],"names":[],"mappings":"AAEA,wBAAgB,kBAAkB,CAChC,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GACjC,MAAM,GAAG,IAAI,CAWf;AAED,wBAAgB,UAAU,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,CAEtE;AAED,wBAAgB,cAAc,CAAC,QAAQ,CAAC,EAAE,MAAM,GAAG,OAAO,CAEzD"}
1
+ {"version":3,"file":"view-detection.d.ts","sourceRoot":"","sources":["../../../src/react/view/view-detection.ts"],"names":[],"mappings":"AAEA;;;;;GAKG;AACH,wBAAgB,kBAAkB,CAChC,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GACjC,MAAM,GAAG,IAAI,CAWf;AAED;;;;;GAKG;AACH,wBAAgB,UAAU,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,CAEtE;AAED;;;;;GAKG;AACH,wBAAgB,cAAc,CAAC,QAAQ,CAAC,EAAE,MAAM,GAAG,OAAO,CAEzD"}
@@ -1,5 +1,6 @@
1
1
  import type { McpUiHostCapabilities, McpUiSupportedContentBlockModalities } from "./ext-apps-bridge.js";
2
2
  import type { ViewConnection, ViewDisplayMode } from "./types.js";
3
+ /** Inputs used to derive the capabilities advertised by an MCP App host. */
3
4
  type CapabilityInputs = {
4
5
  hasConnection: boolean;
5
6
  hasMessageHandler: boolean;
@@ -10,17 +11,51 @@ type CapabilityInputs = {
10
11
  messageCapabilities?: McpUiSupportedContentBlockModalities;
11
12
  modelContextCapabilities?: McpUiSupportedContentBlockModalities;
12
13
  };
14
+ /**
15
+ * Builds host capabilities from the callbacks and connections the host exposes.
16
+ *
17
+ * @param inputs - Available host features and supported content modalities.
18
+ * @returns Capabilities suitable for MCP App bridge initialization.
19
+ */
13
20
  export declare function buildDefaultHostCapabilities({ hasConnection, hasMessageHandler, hasModelContextHandler, hasLogHandler, hasSamplingHandler, hasDownloadHandler, messageCapabilities, modelContextCapabilities, }: CapabilityInputs): McpUiHostCapabilities;
21
+ /**
22
+ * Tests whether a tool is visible to the model.
23
+ *
24
+ * Tools without explicit visibility metadata remain model-visible.
25
+ *
26
+ * @param tool - Tool metadata to inspect.
27
+ * @returns `true` when the tool may be presented to the model.
28
+ */
14
29
  export declare function isToolVisibleToModel(tool: {
15
30
  _meta?: unknown;
16
31
  }): boolean;
32
+ /**
33
+ * Validates and dispatches an MCP App `ui/message` payload.
34
+ *
35
+ * @param handler - Host callback that accepts message content.
36
+ * @param content - Content blocks supplied by the app.
37
+ * @throws When the host has no message handler or `content` is empty.
38
+ */
17
39
  export declare function dispatchUiMessage(handler: ((content: unknown[]) => void | Promise<void>) | undefined, content: unknown[]): Promise<void>;
40
+ /**
41
+ * Resolves a display-mode request against host and app availability.
42
+ *
43
+ * @param options - Requested and current modes plus each side's supported modes.
44
+ * @returns The requested mode when both sides support it; otherwise `current`.
45
+ */
18
46
  export declare function resolveRequestedDisplayMode({ requested, current, hostAvailable, appAvailable, }: {
19
47
  requested: ViewDisplayMode;
20
48
  current: ViewDisplayMode;
21
49
  hostAvailable?: readonly ViewDisplayMode[];
22
50
  appAvailable?: readonly ViewDisplayMode[];
23
51
  }): ViewDisplayMode;
52
+ /**
53
+ * Asserts that an MCP App may call a named server tool.
54
+ *
55
+ * @param tools - Tools available through the live view connection.
56
+ * @param name - Tool name requested by the app.
57
+ * @throws When the tool is unavailable or not visible to apps.
58
+ */
24
59
  export declare function assertAppCanCallTool(tools: ViewConnection["tools"], name: string): void;
25
60
  export {};
26
61
  //# sourceMappingURL=view-host-policy.d.ts.map
@@ -1 +1 @@
1
- {"version":3,"file":"view-host-policy.d.ts","sourceRoot":"","sources":["../../../src/react/view/view-host-policy.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,qBAAqB,EACrB,oCAAoC,EACrC,MAAM,sBAAsB,CAAC;AAC9B,OAAO,KAAK,EAAE,cAAc,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAElE,KAAK,gBAAgB,GAAG;IACtB,aAAa,EAAE,OAAO,CAAC;IACvB,iBAAiB,EAAE,OAAO,CAAC;IAC3B,sBAAsB,EAAE,OAAO,CAAC;IAChC,aAAa,EAAE,OAAO,CAAC;IACvB,kBAAkB,CAAC,EAAE,OAAO,CAAC;IAC7B,kBAAkB,CAAC,EAAE,OAAO,CAAC;IAC7B,mBAAmB,CAAC,EAAE,oCAAoC,CAAC;IAC3D,wBAAwB,CAAC,EAAE,oCAAoC,CAAC;CACjE,CAAC;AAEF,wBAAgB,4BAA4B,CAAC,EAC3C,aAAa,EACb,iBAAiB,EACjB,sBAAsB,EACtB,aAAa,EACb,kBAAkB,EAClB,kBAAkB,EAClB,mBAAmB,EACnB,wBAAwB,GACzB,EAAE,gBAAgB,GAAG,qBAAqB,CAmB1C;AAED,wBAAgB,oBAAoB,CAAC,IAAI,EAAE;IAAE,KAAK,CAAC,EAAE,OAAO,CAAA;CAAE,GAAG,OAAO,CAQvE;AAED,wBAAsB,iBAAiB,CACrC,OAAO,EAAE,CAAC,CAAC,OAAO,EAAE,OAAO,EAAE,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC,GAAG,SAAS,EACnE,OAAO,EAAE,OAAO,EAAE,GACjB,OAAO,CAAC,IAAI,CAAC,CAQf;AAED,wBAAgB,2BAA2B,CAAC,EAC1C,SAAS,EACT,OAAO,EACP,aAAa,EACb,YAAY,GACb,EAAE;IACD,SAAS,EAAE,eAAe,CAAC;IAC3B,OAAO,EAAE,eAAe,CAAC;IACzB,aAAa,CAAC,EAAE,SAAS,eAAe,EAAE,CAAC;IAC3C,YAAY,CAAC,EAAE,SAAS,eAAe,EAAE,CAAC;CAC3C,GAAG,eAAe,CAMlB;AAED,wBAAgB,oBAAoB,CAClC,KAAK,EAAE,cAAc,CAAC,OAAO,CAAC,EAC9B,IAAI,EAAE,MAAM,GACX,IAAI,CAUN"}
1
+ {"version":3,"file":"view-host-policy.d.ts","sourceRoot":"","sources":["../../../src/react/view/view-host-policy.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,qBAAqB,EACrB,oCAAoC,EACrC,MAAM,sBAAsB,CAAC;AAC9B,OAAO,KAAK,EAAE,cAAc,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAElE,4EAA4E;AAC5E,KAAK,gBAAgB,GAAG;IACtB,aAAa,EAAE,OAAO,CAAC;IACvB,iBAAiB,EAAE,OAAO,CAAC;IAC3B,sBAAsB,EAAE,OAAO,CAAC;IAChC,aAAa,EAAE,OAAO,CAAC;IACvB,kBAAkB,CAAC,EAAE,OAAO,CAAC;IAC7B,kBAAkB,CAAC,EAAE,OAAO,CAAC;IAC7B,mBAAmB,CAAC,EAAE,oCAAoC,CAAC;IAC3D,wBAAwB,CAAC,EAAE,oCAAoC,CAAC;CACjE,CAAC;AAEF;;;;;GAKG;AACH,wBAAgB,4BAA4B,CAAC,EAC3C,aAAa,EACb,iBAAiB,EACjB,sBAAsB,EACtB,aAAa,EACb,kBAAkB,EAClB,kBAAkB,EAClB,mBAAmB,EACnB,wBAAwB,GACzB,EAAE,gBAAgB,GAAG,qBAAqB,CAmB1C;AAED;;;;;;;GAOG;AACH,wBAAgB,oBAAoB,CAAC,IAAI,EAAE;IAAE,KAAK,CAAC,EAAE,OAAO,CAAA;CAAE,GAAG,OAAO,CAQvE;AAED;;;;;;GAMG;AACH,wBAAsB,iBAAiB,CACrC,OAAO,EAAE,CAAC,CAAC,OAAO,EAAE,OAAO,EAAE,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC,GAAG,SAAS,EACnE,OAAO,EAAE,OAAO,EAAE,GACjB,OAAO,CAAC,IAAI,CAAC,CAQf;AAED;;;;;GAKG;AACH,wBAAgB,2BAA2B,CAAC,EAC1C,SAAS,EACT,OAAO,EACP,aAAa,EACb,YAAY,GACb,EAAE;IACD,SAAS,EAAE,eAAe,CAAC;IAC3B,OAAO,EAAE,eAAe,CAAC;IACzB,aAAa,CAAC,EAAE,SAAS,eAAe,EAAE,CAAC;IAC3C,YAAY,CAAC,EAAE,SAAS,eAAe,EAAE,CAAC;CAC3C,GAAG,eAAe,CAMlB;AAED;;;;;;GAMG;AACH,wBAAgB,oBAAoB,CAClC,KAAK,EAAE,cAAc,CAAC,OAAO,CAAC,EAC9B,IAAI,EAAE,MAAM,GACX,IAAI,CAUN"}
@@ -63,7 +63,11 @@ export declare class Telemetry {
63
63
  flush(): void;
64
64
  shutdown(): Promise<void>;
65
65
  }
66
- /** @alias */
66
+ /**
67
+ * Backward-compatible name for {@link Telemetry}.
68
+ *
69
+ * @alias
70
+ */
67
71
  export declare const Tel: typeof Telemetry;
68
72
  export declare function setTelemetrySource(source: string): void;
69
73
  export declare function setProductVersion(version: string): void;
@@ -1 +1 @@
1
- {"version":3,"file":"telemetry.d.ts","sourceRoot":"","sources":["../../src/telemetry/telemetry.ts"],"names":[],"mappings":"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"}
1
+ {"version":3,"file":"telemetry.d.ts","sourceRoot":"","sources":["../../src/telemetry/telemetry.ts"],"names":[],"mappings":"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"}
@@ -4,9 +4,12 @@ import type { ConnectionManager } from "./connection-manager.js";
4
4
  import type { ConnectorInitEventData } from "../telemetry/events.js";
5
5
  import type { MCPServerInfo } from "../core/session.js";
6
6
  /**
7
- * Handler function for server notifications
7
+ * Handles a notification received from an MCP server.
8
+ *
9
+ * @param notification - Notification envelope supplied by the server.
8
10
  */
9
11
  export type NotificationHandler = (notification: Notification) => void | Promise<void>;
12
+ /** Shared initialization options for all connector transports. */
10
13
  export interface ConnectorInitOptions {
11
14
  /**
12
15
  * Options forwarded to the underlying MCP `Client` instance.
@@ -65,14 +68,22 @@ export interface ConnectorInitOptions {
65
68
  * Controls retry behavior of the underlying `StreamableHTTPClientTransport`.
66
69
  */
67
70
  reconnectionOptions?: {
71
+ /** Maximum delay between reconnection attempts in milliseconds. */
68
72
  maxReconnectionDelay?: number;
73
+ /** Delay before the first reconnection attempt in milliseconds. */
69
74
  initialReconnectionDelay?: number;
75
+ /** Multiplier applied to the delay after each failed attempt. */
70
76
  reconnectionDelayGrowFactor?: number;
77
+ /** Maximum number of reconnection attempts. */
71
78
  maxRetries?: number;
72
79
  };
73
80
  }
74
81
  /**
75
- * Base class for MCP connectors.
82
+ * Implements protocol operations shared by MCP transport connectors.
83
+ *
84
+ * Subclasses provide transport-specific connection setup and a public
85
+ * identifier. Call {@link BaseConnector.connect}, then
86
+ * {@link BaseConnector.initialize}, before invoking protocol operations.
76
87
  */
77
88
  export declare abstract class BaseConnector {
78
89
  protected client: Client | null;
@@ -85,6 +96,11 @@ export declare abstract class BaseConnector {
85
96
  protected notificationHandlers: NotificationHandler[];
86
97
  protected rootsCache: Root[];
87
98
  private activeProgressHandlers;
99
+ /**
100
+ * Creates a connector with shared SDK and callback options.
101
+ *
102
+ * @param opts - Connector initialization options.
103
+ */
88
104
  constructor(opts?: ConnectorInitOptions);
89
105
  /**
90
106
  * Track connector initialization event
@@ -155,7 +171,9 @@ export declare abstract class BaseConnector {
155
171
  */
156
172
  setRoots(roots: Root[]): Promise<void>;
157
173
  /**
158
- * Get the current roots.
174
+ * Returns the roots currently advertised to the server.
175
+ *
176
+ * @returns A copy of the configured roots.
159
177
  */
160
178
  getRoots(): Root[];
161
179
  /**
@@ -174,13 +192,25 @@ export declare abstract class BaseConnector {
174
192
  * Must be registered after Client construction and before connect().
175
193
  */
176
194
  protected setupElicitationHandler(): void;
177
- /** Establish the connection and create the SDK client. */
195
+ /**
196
+ * Establishes the transport connection and creates the SDK client.
197
+ *
198
+ * @returns A promise that resolves when the connector is connected.
199
+ */
178
200
  abstract connect(): Promise<void>;
179
- /** Get the identifier for the connector. */
201
+ /**
202
+ * Returns transport-specific fields suitable for logs and telemetry.
203
+ *
204
+ * @returns A record identifying the connector without exposing credentials.
205
+ */
180
206
  abstract get publicIdentifier(): Record<string, string>;
181
- /** Disconnect and release resources. */
207
+ /**
208
+ * Disconnects the SDK client and releases transport resources.
209
+ *
210
+ * @returns A promise that resolves after cleanup completes.
211
+ */
182
212
  disconnect(): Promise<void>;
183
- /** Check if the client is connected */
213
+ /** Whether an SDK client currently exists for this connector. */
184
214
  get isClientConnected(): boolean;
185
215
  /**
186
216
  * Initialise the MCP session **after** `connect()` has succeeded.
@@ -188,13 +218,21 @@ export declare abstract class BaseConnector {
188
218
  * In the SDK, `Client.connect(transport)` automatically performs the
189
219
  * protocol‑level `initialize` handshake, so we only need to cache the list of
190
220
  * tools and expose some server info.
221
+ *
222
+ * @param defaultRequestOptions - Options used while fetching the initial tool list.
223
+ * @returns The capabilities advertised by the server.
224
+ * @throws When {@link BaseConnector.connect} has not completed.
191
225
  */
192
226
  initialize(defaultRequestOptions?: RequestOptions): Promise<ReturnType<Client["getServerCapabilities"]>>;
193
- /** Lazily expose the cached tools list. */
227
+ /**
228
+ * Returns the tool list cached during initialization.
229
+ *
230
+ * @throws When {@link BaseConnector.initialize} has not completed.
231
+ */
194
232
  get tools(): Tool[];
195
- /** Expose cached server capabilities. */
233
+ /** Capabilities cached during initialization, or an empty object. */
196
234
  get serverCapabilities(): Record<string, unknown>;
197
- /** Expose cached server info. */
235
+ /** Server identity cached during initialization, or `null`. */
198
236
  get serverInfo(): MCPServerInfo | null;
199
237
  /** Instructions supplied by the connected server, if any. */
200
238
  get instructions(): string | undefined;
@@ -207,7 +245,15 @@ export declare abstract class BaseConnector {
207
245
  get protocolEra(): ProtocolEra | undefined;
208
246
  /** The protocol version string negotiated for the active connection. */
209
247
  get negotiatedProtocolVersion(): string | undefined;
210
- /** Call a tool on the server. */
248
+ /**
249
+ * Calls a tool on the connected server.
250
+ *
251
+ * @param name - Tool name.
252
+ * @param args - Tool arguments.
253
+ * @param options - Per-request timeout, cancellation, and progress options.
254
+ * @returns The tool result returned by the server.
255
+ * @throws When the connector is not connected or the tool call fails.
256
+ */
211
257
  callTool(name: string, args: Record<string, any>, options?: RequestOptions): Promise<CallToolResult>;
212
258
  /**
213
259
  * List all available tools from the MCP server.
@@ -273,6 +319,7 @@ export declare abstract class BaseConnector {
273
319
  * @returns Complete list of all resources
274
320
  */
275
321
  listAllResources(options?: RequestOptions): Promise<{
322
+ /** Resources returned across all result pages. */
276
323
  resources: any[];
277
324
  }>;
278
325
  /**
@@ -330,7 +377,13 @@ export declare abstract class BaseConnector {
330
377
  * @returns Completion suggestions from the server
331
378
  */
332
379
  complete(params: CompleteRequestParams, options?: RequestOptions): Promise<CompleteResult>;
333
- /** Read a resource by URI. */
380
+ /**
381
+ * Reads a resource by URI.
382
+ *
383
+ * @param uri - Resource URI to read.
384
+ * @param options - Per-request options.
385
+ * @returns The resource contents returned by the server.
386
+ */
334
387
  readResource(uri: string, options?: RequestOptions): Promise<{
335
388
  [x: string]: unknown;
336
389
  contents: ({
@@ -413,6 +466,11 @@ export declare abstract class BaseConnector {
413
466
  } | undefined;
414
467
  } | undefined;
415
468
  }>;
469
+ /**
470
+ * Lists prompts exposed by the server.
471
+ *
472
+ * @returns The prompt list, or an empty list when prompts are unsupported.
473
+ */
416
474
  listPrompts(): Promise<{
417
475
  [x: string]: unknown;
418
476
  prompts: {
@@ -452,6 +510,13 @@ export declare abstract class BaseConnector {
452
510
  } | undefined;
453
511
  nextCursor?: string | undefined;
454
512
  }>;
513
+ /**
514
+ * Gets a prompt with the supplied arguments.
515
+ *
516
+ * @param name - Prompt name.
517
+ * @param args - Prompt arguments.
518
+ * @returns The rendered prompt returned by the server.
519
+ */
455
520
  getPrompt(name: string, args: Record<string, any>): Promise<{
456
521
  [x: string]: unknown;
457
522
  messages: {
@@ -558,7 +623,14 @@ export declare abstract class BaseConnector {
558
623
  } | undefined;
559
624
  description?: string | undefined;
560
625
  }>;
561
- /** Send a raw request through the client. */
626
+ /**
627
+ * Sends a raw, potentially non-standard request through the SDK client.
628
+ *
629
+ * @param method - JSON-RPC method name.
630
+ * @param params - Request parameters. Defaults to an empty object.
631
+ * @param options - Per-request options.
632
+ * @returns The unvalidated result returned by the server.
633
+ */
562
634
  request(method: string, params?: Record<string, any> | null, options?: RequestOptions): Promise<unknown>;
563
635
  /**
564
636
  * Helper to tear down the client & connection manager safely.
@@ -1 +1 @@
1
- {"version":3,"file":"base.d.ts","sourceRoot":"","sources":["../../src/transport/base.ts"],"names":[],"mappings":"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"}
1
+ {"version":3,"file":"base.d.ts","sourceRoot":"","sources":["../../src/transport/base.ts"],"names":[],"mappings":"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"}
@@ -26,7 +26,7 @@ export declare abstract class ConnectionManager<T = any> {
26
26
  * This method should be implemented by subclasses to close the specific type
27
27
  * of connection.
28
28
  *
29
- * @param connection The connection to close.
29
+ * @param connection - The connection to close.
30
30
  */
31
31
  protected abstract closeConnection(connection: T): Promise<void>;
32
32
  /**