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

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 (66) 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/code-mode/executor-e2b.d.ts.map +1 -1
  9. package/dist/core/base.d.ts +4 -8
  10. package/dist/core/base.d.ts.map +1 -1
  11. package/dist/core/browser.d.ts +14 -2
  12. package/dist/core/browser.d.ts.map +1 -1
  13. package/dist/core/config.d.ts +82 -20
  14. package/dist/core/config.d.ts.map +1 -1
  15. package/dist/core/node.d.ts +7 -10
  16. package/dist/core/node.d.ts.map +1 -1
  17. package/dist/core/session.d.ts +18 -4
  18. package/dist/core/session.d.ts.map +1 -1
  19. package/dist/index-browser.d.ts +1 -0
  20. package/dist/index-browser.d.ts.map +1 -1
  21. package/dist/index-browser.js +142 -21
  22. package/dist/index-browser.js.map +1 -1
  23. package/dist/index.d.ts +1 -1
  24. package/dist/index.js +228 -37
  25. package/dist/index.js.map +1 -1
  26. package/dist/react/McpClientProvider.d.ts +22 -10
  27. package/dist/react/McpClientProvider.d.ts.map +1 -1
  28. package/dist/react/index.d.ts +2 -0
  29. package/dist/react/index.d.ts.map +1 -1
  30. package/dist/react/index.js +164 -21
  31. package/dist/react/index.js.map +1 -1
  32. package/dist/react/rpc-logger.d.ts +5 -0
  33. package/dist/react/rpc-logger.d.ts.map +1 -1
  34. package/dist/react/storage.d.ts +47 -0
  35. package/dist/react/storage.d.ts.map +1 -1
  36. package/dist/react/types.d.ts +107 -16
  37. package/dist/react/types.d.ts.map +1 -1
  38. package/dist/react/useMcp-operations.d.ts.map +1 -1
  39. package/dist/react/view/ViewRenderer.d.ts +7 -0
  40. package/dist/react/view/ViewRenderer.d.ts.map +1 -1
  41. package/dist/react/view/parse-custom-props.d.ts +8 -0
  42. package/dist/react/view/parse-custom-props.d.ts.map +1 -1
  43. package/dist/react/view/resolve-view-resource.d.ts +10 -0
  44. package/dist/react/view/resolve-view-resource.d.ts.map +1 -1
  45. package/dist/react/view/types.d.ts +89 -0
  46. package/dist/react/view/types.d.ts.map +1 -1
  47. package/dist/react/view/view-detection.d.ts +18 -0
  48. package/dist/react/view/view-detection.d.ts.map +1 -1
  49. package/dist/react/view/view-host-policy.d.ts +35 -0
  50. package/dist/react/view/view-host-policy.d.ts.map +1 -1
  51. package/dist/telemetry/telemetry.d.ts +5 -1
  52. package/dist/telemetry/telemetry.d.ts.map +1 -1
  53. package/dist/transport/base.d.ts +85 -13
  54. package/dist/transport/base.d.ts.map +1 -1
  55. package/dist/transport/connection-manager.d.ts +1 -1
  56. package/dist/transport/http.d.ts +51 -2
  57. package/dist/transport/http.d.ts.map +1 -1
  58. package/dist/transport/stdio.d.ts +29 -1
  59. package/dist/transport/stdio.d.ts.map +1 -1
  60. package/dist/utils/elicitation.d.ts +4 -2
  61. package/dist/utils/elicitation.d.ts.map +1 -1
  62. package/dist/utils/logging.d.ts +1 -0
  63. package/dist/utils/logging.d.ts.map +1 -1
  64. package/dist/utils/version.d.ts +6 -0
  65. package/dist/utils/version.d.ts.map +1 -1
  66. package/package.json +4 -4
@@ -1,23 +1,39 @@
1
1
  import { type VersionNegotiationMode } from "@modelcontextprotocol/client";
2
2
  import type { ConnectorInitOptions } from "./base.js";
3
3
  import { BaseConnector } from "./base.js";
4
+ /** Client identity advertised to an MCP server during connection setup. */
4
5
  export type ClientInfo = {
6
+ /** Stable programmatic client name. */
5
7
  name: string;
8
+ /** Optional human-readable client title. */
6
9
  title?: string;
10
+ /** Client version string. */
7
11
  version: string;
12
+ /** Human-readable client description. */
8
13
  description?: string;
14
+ /** Icons representing the client. */
9
15
  icons?: Array<{
16
+ /** Icon URL. */
10
17
  src: string;
18
+ /** Icon media type. */
11
19
  mimeType?: string;
20
+ /** Supported icon sizes, such as `"48x48"`. */
12
21
  sizes?: string[];
13
22
  }>;
23
+ /** Public website describing the client. */
14
24
  websiteUrl?: string;
15
25
  };
26
+ /** HTTP-specific connector options. */
16
27
  interface HttpConnectorOptions extends ConnectorInitOptions {
28
+ /** Bearer token added to the `Authorization` header. */
17
29
  authToken?: string;
30
+ /** Fetch implementation used by transport requests. */
18
31
  fetch?: typeof fetch;
32
+ /** Additional transport request headers. */
19
33
  headers?: Record<string, string>;
34
+ /** Connection timeout in milliseconds. Defaults to `10000`. */
20
35
  timeout?: number;
36
+ /** Client identity advertised to the server. */
21
37
  clientInfo?: ClientInfo;
22
38
  /**
23
39
  * Protocol version negotiation mode passed to the SDK `Client`.
@@ -32,15 +48,28 @@ interface HttpConnectorOptions extends ConnectorInitOptions {
32
48
  * - `{ pin: "2026-07-28" }`: modern era only, no fallback.
33
49
  */
34
50
  protocolNegotiation?: VersionNegotiationMode;
51
+ /** Gateway endpoint through which MCP transport requests are routed. */
35
52
  gatewayUrl?: string;
53
+ /** Server identifier forwarded to the gateway for observability. */
36
54
  serverId?: string;
55
+ /** Retry settings for streamable HTTP reconnection. */
37
56
  reconnectionOptions?: {
57
+ /** Maximum delay between reconnection attempts in milliseconds. */
38
58
  maxReconnectionDelay?: number;
59
+ /** Delay before the first reconnection attempt in milliseconds. */
39
60
  initialReconnectionDelay?: number;
61
+ /** Multiplier applied after each failed attempt. */
40
62
  reconnectionDelayGrowFactor?: number;
63
+ /** Maximum number of reconnection attempts. */
41
64
  maxRetries?: number;
42
65
  };
43
66
  }
67
+ /**
68
+ * Connects to an MCP server using streamable HTTP.
69
+ *
70
+ * The connector negotiates modern and legacy protocol eras by default and can
71
+ * route transport requests through an HTTP gateway.
72
+ */
44
73
  export declare class HttpConnector extends BaseConnector {
45
74
  private readonly baseUrl;
46
75
  private readonly headers;
@@ -53,11 +82,22 @@ export declare class HttpConnector extends BaseConnector {
53
82
  private readonly reconnectionOptions?;
54
83
  private transportType;
55
84
  private streamableTransport;
85
+ /**
86
+ * Creates an HTTP connector.
87
+ *
88
+ * @param baseUrl - MCP endpoint URL.
89
+ * @param opts - Authentication, transport, SDK, and reconnection options.
90
+ */
56
91
  constructor(baseUrl: string, opts?: HttpConnectorOptions);
57
92
  private buildClientOptions;
58
93
  private unwrapStreamableError;
59
94
  private classifyStreamableHttpFailure;
60
- /** Establish connection to the MCP implementation via streamable HTTP. */
95
+ /**
96
+ * Establishes a streamable HTTP connection to the MCP server.
97
+ *
98
+ * @returns A promise that resolves after protocol negotiation completes.
99
+ * @throws An error with `code: 401` when authentication is required.
100
+ */
61
101
  connect(): Promise<void>;
62
102
  /**
63
103
  * Tee an SSE response so v2 MRTR progress can be correlated even when the
@@ -65,8 +105,17 @@ export declare class HttpConnector extends BaseConnector {
65
105
  */
66
106
  private observeSseProgress;
67
107
  private connectWithStreamableHttp;
108
+ /**
109
+ * Returns fields that identify the endpoint and negotiated transport.
110
+ *
111
+ * @returns HTTP connector identity metadata.
112
+ */
68
113
  get publicIdentifier(): Record<string, string>;
69
- /** Get the active transport type (`streamable-http` once connected). */
114
+ /**
115
+ * Returns the active transport type.
116
+ *
117
+ * @returns `"streamable-http"` after connection, otherwise `null`.
118
+ */
70
119
  getTransportType(): "streamable-http" | null;
71
120
  protected cleanupResources(): Promise<void>;
72
121
  }
@@ -1 +1 @@
1
- {"version":3,"file":"http.d.ts","sourceRoot":"","sources":["../../src/transport/http.ts"],"names":[],"mappings":"AAAA,OAAO,EAOL,KAAK,sBAAsB,EAC5B,MAAM,8BAA8B,CAAC;AAGtC,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,WAAW,CAAC;AACtD,OAAO,EAAE,aAAa,EAAE,MAAM,WAAW,CAAC;AAsB1C,MAAM,MAAM,UAAU,GAAG;IACvB,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;IAChB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,KAAK,CAAC,EAAE,KAAK,CAAC;QACZ,GAAG,EAAE,MAAM,CAAC;QACZ,QAAQ,CAAC,EAAE,MAAM,CAAC;QAClB,KAAK,CAAC,EAAE,MAAM,EAAE,CAAC;KAClB,CAAC,CAAC;IACH,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB,CAAC;AAEF,UAAU,oBAAqB,SAAQ,oBAAoB;IACzD,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,KAAK,CAAC,EAAE,OAAO,KAAK,CAAC;IACrB,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACjC,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,UAAU,CAAC,EAAE,UAAU,CAAC;IACxB;;;;;;;;;;;OAWG;IACH,mBAAmB,CAAC,EAAE,sBAAsB,CAAC;IAC7C,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,mBAAmB,CAAC,EAAE;QACpB,oBAAoB,CAAC,EAAE,MAAM,CAAC;QAC9B,wBAAwB,CAAC,EAAE,MAAM,CAAC;QAClC,2BAA2B,CAAC,EAAE,MAAM,CAAC;QACrC,UAAU,CAAC,EAAE,MAAM,CAAC;KACrB,CAAC;CACH;AAmDD,qBAAa,aAAc,SAAQ,aAAa;IAC9C,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAS;IACjC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAyB;IACjD,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAS;IACjC,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAC,CAAe;IAC5C,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAa;IACxC,OAAO,CAAC,QAAQ,CAAC,mBAAmB,CAAyB;IAC7D,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAC,CAAS;IACrC,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAS;IACnC,OAAO,CAAC,QAAQ,CAAC,mBAAmB,CAAC,CAA8C;IACnF,OAAO,CAAC,aAAa,CAAkC;IACvD,OAAO,CAAC,mBAAmB,CAA8C;gBAE7D,OAAO,EAAE,MAAM,EAAE,IAAI,GAAE,oBAAyB;IAmC5D,OAAO,CAAC,kBAAkB;IAqD1B,OAAO,CAAC,qBAAqB;IAU7B,OAAO,CAAC,6BAA6B;IA0DrC,0EAA0E;IACpE,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;IAyC9B;;;OAGG;IACH,OAAO,CAAC,kBAAkB;YAmDZ,yBAAyB;IAuNvC,IAAI,gBAAgB,IAAI,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAO7C;IAED,wEAAwE;IACxE,gBAAgB,IAAI,iBAAiB,GAAG,IAAI;cAQ5B,gBAAgB,IAAI,OAAO,CAAC,IAAI,CAAC;CA8BlD"}
1
+ {"version":3,"file":"http.d.ts","sourceRoot":"","sources":["../../src/transport/http.ts"],"names":[],"mappings":"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"}
@@ -6,7 +6,9 @@ import { ConnectionManager } from "./connection-manager.js";
6
6
  import { StdioClientTransport } from "@modelcontextprotocol/client/stdio";
7
7
  import { BaseConnector } from "./base.js";
8
8
  import type { ClientInfo } from "./http.js";
9
+ /** Stdio-specific connector options. */
9
10
  interface StdioConnectorOptions extends ConnectorInitOptions {
11
+ /** Client identity advertised to the server. */
10
12
  clientInfo?: ClientInfo;
11
13
  /**
12
14
  * Protocol version negotiation mode. Defaults to `"legacy"` for stdio: the
@@ -17,6 +19,9 @@ interface StdioConnectorOptions extends ConnectorInitOptions {
17
19
  */
18
20
  protocolNegotiation?: VersionNegotiationMode;
19
21
  }
22
+ /**
23
+ * Launches and connects to a local MCP server over standard input and output.
24
+ */
20
25
  export declare class StdioConnector extends BaseConnector {
21
26
  private readonly command;
22
27
  private readonly args;
@@ -25,6 +30,11 @@ export declare class StdioConnector extends BaseConnector {
25
30
  private readonly errlog;
26
31
  private readonly clientInfo;
27
32
  private readonly protocolNegotiation;
33
+ /**
34
+ * Creates a stdio connector.
35
+ *
36
+ * @param options - Process launch, client identity, and shared connector options.
37
+ */
28
38
  constructor({ command, args, env, errlog, ...rest }?: {
29
39
  command?: string;
30
40
  args?: string[];
@@ -32,14 +42,32 @@ export declare class StdioConnector extends BaseConnector {
32
42
  errlog?: Writable;
33
43
  cwd?: string;
34
44
  } & StdioConnectorOptions);
35
- /** Establish connection to the MCP implementation. */
45
+ /**
46
+ * Starts the child process and establishes an MCP connection.
47
+ *
48
+ * @returns A promise that resolves after protocol negotiation completes.
49
+ */
36
50
  connect(): Promise<void>;
51
+ /**
52
+ * Returns fields identifying the launched command and arguments.
53
+ *
54
+ * @returns Stdio connector identity metadata.
55
+ */
37
56
  get publicIdentifier(): Record<string, string>;
38
57
  }
58
+ /**
59
+ * Owns the lifecycle of a stdio client transport.
60
+ */
39
61
  export declare class StdioConnectionManager extends ConnectionManager<StdioClientTransport> {
40
62
  private readonly serverParams;
41
63
  private readonly errlog;
42
64
  private _transport;
65
+ /**
66
+ * Creates a connection manager for a local server process.
67
+ *
68
+ * @param serverParams - Process parameters passed to the SDK transport.
69
+ * @param errlog - Destination for the child process's standard error stream.
70
+ */
43
71
  constructor(serverParams: StdioServerParameters, errlog?: Writable);
44
72
  protected establishConnection(): Promise<StdioClientTransport>;
45
73
  protected closeConnection(_connection: StdioClientTransport): Promise<void>;
@@ -1 +1 @@
1
- {"version":3,"file":"stdio.d.ts","sourceRoot":"","sources":["../../src/transport/stdio.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAEV,sBAAsB,EACvB,MAAM,8BAA8B,CAAC;AAEtC,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,oCAAoC,CAAC;AAChF,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AAG5C,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,WAAW,CAAC;AAItD,OAAO,EAAE,iBAAiB,EAAE,MAAM,yBAAyB,CAAC;AAC5D,OAAO,EAAE,oBAAoB,EAAE,MAAM,oCAAoC,CAAC;AAC1E,OAAO,EAAE,aAAa,EAAE,MAAM,WAAW,CAAC;AAC1C,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,WAAW,CAAC;AAE5C,UAAU,qBAAsB,SAAQ,oBAAoB;IAC1D,UAAU,CAAC,EAAE,UAAU,CAAC;IACxB;;;;;;OAMG;IACH,mBAAmB,CAAC,EAAE,sBAAsB,CAAC;CAC9C;AAED,qBAAa,cAAe,SAAQ,aAAa;IAC/C,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAS;IACjC,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAW;IAChC,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAyB;IAC9C,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAS;IAC9B,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAW;IAClC,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAa;IACxC,OAAO,CAAC,QAAQ,CAAC,mBAAmB,CAAyB;gBAEjD,EACV,OAAe,EACf,IAAS,EACT,GAAG,EACH,MAAuB,EACvB,GAAG,IAAI,EACR,GAAE;QACD,OAAO,CAAC,EAAE,MAAM,CAAC;QACjB,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;QAChB,GAAG,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;QAC7B,MAAM,CAAC,EAAE,QAAQ,CAAC;QAClB,GAAG,CAAC,EAAE,MAAM,CAAC;KACd,GAAG,qBAA0B;IAe9B,sDAAsD;IAChD,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;IA0H9B,IAAI,gBAAgB,IAAI,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAK7C;CACF;AAED,qBAAa,sBAAuB,SAAQ,iBAAiB,CAAC,oBAAoB,CAAC;IACjF,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAwB;IACrD,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAW;IAClC,OAAO,CAAC,UAAU,CAAqC;gBAGrD,YAAY,EAAE,qBAAqB,EACnC,MAAM,GAAE,QAAyB;cAOnB,mBAAmB,IAAI,OAAO,CAAC,oBAAoB,CAAC;cAgBpD,eAAe,CAC7B,WAAW,EAAE,oBAAoB,GAChC,OAAO,CAAC,IAAI,CAAC;CAWjB"}
1
+ {"version":3,"file":"stdio.d.ts","sourceRoot":"","sources":["../../src/transport/stdio.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAEV,sBAAsB,EACvB,MAAM,8BAA8B,CAAC;AAEtC,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,oCAAoC,CAAC;AAChF,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AAG5C,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,WAAW,CAAC;AAItD,OAAO,EAAE,iBAAiB,EAAE,MAAM,yBAAyB,CAAC;AAC5D,OAAO,EAAE,oBAAoB,EAAE,MAAM,oCAAoC,CAAC;AAC1E,OAAO,EAAE,aAAa,EAAE,MAAM,WAAW,CAAC;AAC1C,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,WAAW,CAAC;AAE5C,wCAAwC;AACxC,UAAU,qBAAsB,SAAQ,oBAAoB;IAC1D,gDAAgD;IAChD,UAAU,CAAC,EAAE,UAAU,CAAC;IACxB;;;;;;OAMG;IACH,mBAAmB,CAAC,EAAE,sBAAsB,CAAC;CAC9C;AAED;;GAEG;AACH,qBAAa,cAAe,SAAQ,aAAa;IAC/C,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAS;IACjC,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAW;IAChC,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAyB;IAC9C,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAS;IAC9B,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAW;IAClC,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAa;IACxC,OAAO,CAAC,QAAQ,CAAC,mBAAmB,CAAyB;IAE7D;;;;OAIG;gBACS,EACV,OAAe,EACf,IAAS,EACT,GAAG,EACH,MAAuB,EACvB,GAAG,IAAI,EACR,GAAE;QACD,OAAO,CAAC,EAAE,MAAM,CAAC;QACjB,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;QAChB,GAAG,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;QAC7B,MAAM,CAAC,EAAE,QAAQ,CAAC;QAClB,GAAG,CAAC,EAAE,MAAM,CAAC;KACd,GAAG,qBAA0B;IAe9B;;;;OAIG;IACG,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;IA0H9B;;;;OAIG;IACH,IAAI,gBAAgB,IAAI,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAK7C;CACF;AAED;;GAEG;AACH,qBAAa,sBAAuB,SAAQ,iBAAiB,CAAC,oBAAoB,CAAC;IACjF,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAwB;IACrD,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAW;IAClC,OAAO,CAAC,UAAU,CAAqC;IAEvD;;;;;OAKG;gBAED,YAAY,EAAE,qBAAqB,EACnC,MAAM,GAAE,QAAyB;cAOnB,mBAAmB,IAAI,OAAO,CAAC,oBAAoB,CAAC;cAgBpD,eAAe,CAC7B,WAAW,EAAE,oBAAoB,GAChC,OAAO,CAAC,IAAI,CAAC;CAWjB"}
@@ -10,7 +10,9 @@ import type { ElicitRequestFormParams, ElicitRequestURLParams, ElicitResult } fr
10
10
  export type ElicitContent = Record<string, string | number | boolean | string[]>;
11
11
  /** Result of validate(params, content). */
12
12
  export type ElicitValidationResult = {
13
+ /** Whether the submitted content satisfies the requested schema. */
13
14
  valid: boolean;
15
+ /** Validation error messages when `valid` is `false`. */
14
16
  errors?: string[];
15
17
  };
16
18
  type ElicitParams = ElicitRequestFormParams | ElicitRequestURLParams;
@@ -34,7 +36,7 @@ export declare function acceptWithDefaults(params: ElicitParams): ElicitResult;
34
36
  export declare function accept(content: ElicitContent): ElicitResult;
35
37
  /**
36
38
  * Return an ElicitResult that declines the elicitation (user chose not to provide).
37
- * Optional reason is for logging; the SDK result is { action: "decline" }.
39
+ * Optional reason is for logging; the SDK result is `{ action: "decline" }`.
38
40
  */
39
41
  export declare function decline(_reason?: string): ElicitResult;
40
42
  /**
@@ -45,7 +47,7 @@ export declare function cancel(): ElicitResult;
45
47
  * Validate content against the request's requestedSchema using Zod.
46
48
  * Converts requestedSchema (JSON Schema) via `z.fromJSONSchema`, then
47
49
  * safeParse(content). If conversion fails, returns
48
- * { valid: false, errors: ["Unsupported or invalid schema"] }.
50
+ * `{ valid: false, errors: ["Unsupported or invalid schema"] }`.
49
51
  */
50
52
  export declare function validate(params: ElicitParams, content: ElicitContent): ElicitValidationResult;
51
53
  export {};
@@ -1 +1 @@
1
- {"version":3,"file":"elicitation.d.ts","sourceRoot":"","sources":["../../src/utils/elicitation.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EACV,uBAAuB,EACvB,sBAAsB,EACtB,YAAY,EACb,MAAM,8BAA8B,CAAC;AAGtC,8DAA8D;AAC9D,MAAM,MAAM,aAAa,GAAG,MAAM,CAChC,MAAM,EACN,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,MAAM,EAAE,CACrC,CAAC;AAEF,2CAA2C;AAC3C,MAAM,MAAM,sBAAsB,GAAG;IACnC,KAAK,EAAE,OAAO,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,EAAE,CAAC;CACnB,CAAC;AAEF,KAAK,YAAY,GAAG,uBAAuB,GAAG,sBAAsB,CAAC;AAQrE;;;GAGG;AACH,wBAAgB,WAAW,CAAC,MAAM,EAAE,YAAY,GAAG,aAAa,CAoB/D;AAED;;;GAGG;AACH,wBAAgB,aAAa,CAC3B,MAAM,EAAE,YAAY,EACpB,OAAO,CAAC,EAAE,aAAa,GACtB,aAAa,CAIf;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,YAAY,GAAG,YAAY,CAErE;AAED;;GAEG;AACH,wBAAgB,MAAM,CAAC,OAAO,EAAE,aAAa,GAAG,YAAY,CAE3D;AAED;;;GAGG;AACH,wBAAgB,OAAO,CAAC,OAAO,CAAC,EAAE,MAAM,GAAG,YAAY,CAEtD;AAED;;GAEG;AACH,wBAAgB,MAAM,IAAI,YAAY,CAErC;AAED;;;;;GAKG;AACH,wBAAgB,QAAQ,CACtB,MAAM,EAAE,YAAY,EACpB,OAAO,EAAE,aAAa,GACrB,sBAAsB,CAiBxB"}
1
+ {"version":3,"file":"elicitation.d.ts","sourceRoot":"","sources":["../../src/utils/elicitation.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EACV,uBAAuB,EACvB,sBAAsB,EACtB,YAAY,EACb,MAAM,8BAA8B,CAAC;AAGtC,8DAA8D;AAC9D,MAAM,MAAM,aAAa,GAAG,MAAM,CAChC,MAAM,EACN,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,MAAM,EAAE,CACrC,CAAC;AAEF,2CAA2C;AAC3C,MAAM,MAAM,sBAAsB,GAAG;IACnC,oEAAoE;IACpE,KAAK,EAAE,OAAO,CAAC;IACf,yDAAyD;IACzD,MAAM,CAAC,EAAE,MAAM,EAAE,CAAC;CACnB,CAAC;AAEF,KAAK,YAAY,GAAG,uBAAuB,GAAG,sBAAsB,CAAC;AAQrE;;;GAGG;AACH,wBAAgB,WAAW,CAAC,MAAM,EAAE,YAAY,GAAG,aAAa,CAoB/D;AAED;;;GAGG;AACH,wBAAgB,aAAa,CAC3B,MAAM,EAAE,YAAY,EACpB,OAAO,CAAC,EAAE,aAAa,GACtB,aAAa,CAIf;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,YAAY,GAAG,YAAY,CAErE;AAED;;GAEG;AACH,wBAAgB,MAAM,CAAC,OAAO,EAAE,aAAa,GAAG,YAAY,CAE3D;AAED;;;GAGG;AACH,wBAAgB,OAAO,CAAC,OAAO,CAAC,EAAE,MAAM,GAAG,YAAY,CAEtD;AAED;;GAEG;AACH,wBAAgB,MAAM,IAAI,YAAY,CAErC;AAED;;;;;GAKG;AACH,wBAAgB,QAAQ,CACtB,MAAM,EAAE,YAAY,EACpB,OAAO,EAAE,aAAa,GACrB,sBAAsB,CAiBxB"}
@@ -27,6 +27,7 @@ export declare class Logger {
27
27
  static setDebug(enabled: boolean | 0 | 1 | 2): void;
28
28
  static setFormat(format: LogFormat): void;
29
29
  }
30
+ /** Default package logger used by client and connector operations. */
30
31
  export declare const logger: SimpleConsoleLogger;
31
32
  export {};
32
33
  //# sourceMappingURL=logging.d.ts.map
@@ -1 +1 @@
1
- {"version":3,"file":"logging.d.ts","sourceRoot":"","sources":["../../src/utils/logging.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,QAAQ,GAChB,QAAQ,GACR,OAAO,GACP,MAAM,GACN,MAAM,GACN,MAAM,GACN,SAAS,GACT,OAAO,GACP,OAAO,CAAC;AAEZ,KAAK,SAAS,GAAG,SAAS,GAAG,UAAU,GAAG,OAAO,CAAC;AAwClD,cAAM,mBAAmB;IAErB,OAAO,CAAC,IAAI;IACL,KAAK,EAAE,QAAQ;IACf,MAAM,EAAE,SAAS;gBAFhB,IAAI,SAAY,EACjB,KAAK,GAAE,QAAiB,EACxB,MAAM,GAAE,SAAqB;IAGtC,OAAO,CAAC,KAAK;IAmCb,KAAK,GAAI,GAAG,MAAM,EAAE,GAAG,GAAG,OAAO,EAAE,UAA+B;IAClE,IAAI,GAAI,GAAG,MAAM,EAAE,GAAG,GAAG,OAAO,EAAE,UAA8B;IAChE,IAAI,GAAI,GAAG,MAAM,EAAE,GAAG,GAAG,OAAO,EAAE,UAA8B;IAChE,KAAK,GAAI,GAAG,MAAM,EAAE,GAAG,GAAG,OAAO,EAAE,UAA+B;IAClE,IAAI,GAAI,GAAG,MAAM,EAAE,GAAG,GAAG,OAAO,EAAE,UAA8B;IAChE,OAAO,GAAI,GAAG,MAAM,EAAE,GAAG,GAAG,OAAO,EAAE,UAAiC;IACtE,KAAK,GAAI,GAAG,MAAM,EAAE,GAAG,GAAG,OAAO,EAAE,UAA+B;IAElE,SAAS,CAAC,MAAM,EAAE,SAAS,GAAG,IAAI;CAGnC;AAED,qBAAa,MAAM;IACjB,OAAO,CAAC,MAAM,CAAC,SAAS,CAA2C;IACnE,OAAO,CAAC,MAAM,CAAC,aAAa,CAAwB;IACpD,OAAO,CAAC,MAAM,CAAC,YAAY,CAAuB;IAElD,MAAM,CAAC,GAAG,CAAC,IAAI,SAAY,GAAG,mBAAmB;IAQjD,MAAM,CAAC,SAAS,CAAC,EACf,KAAkB,EAClB,MAAkB,GACnB,GAAE;QAAE,KAAK,CAAC,EAAE,QAAQ,CAAC;QAAC,MAAM,CAAC,EAAE,SAAS,CAAA;KAAO,GAAG,IAAI;IASvD,MAAM,CAAC,QAAQ,CAAC,OAAO,EAAE,OAAO,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,IAAI;IAcnD,MAAM,CAAC,SAAS,CAAC,MAAM,EAAE,SAAS,GAAG,IAAI;CAG1C;AAED,eAAO,MAAM,MAAM,qBAAe,CAAC"}
1
+ {"version":3,"file":"logging.d.ts","sourceRoot":"","sources":["../../src/utils/logging.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,QAAQ,GAChB,QAAQ,GACR,OAAO,GACP,MAAM,GACN,MAAM,GACN,MAAM,GACN,SAAS,GACT,OAAO,GACP,OAAO,CAAC;AAEZ,KAAK,SAAS,GAAG,SAAS,GAAG,UAAU,GAAG,OAAO,CAAC;AAwClD,cAAM,mBAAmB;IAErB,OAAO,CAAC,IAAI;IACL,KAAK,EAAE,QAAQ;IACf,MAAM,EAAE,SAAS;gBAFhB,IAAI,SAAY,EACjB,KAAK,GAAE,QAAiB,EACxB,MAAM,GAAE,SAAqB;IAGtC,OAAO,CAAC,KAAK;IAmCb,KAAK,GAAI,GAAG,MAAM,EAAE,GAAG,GAAG,OAAO,EAAE,UAA+B;IAClE,IAAI,GAAI,GAAG,MAAM,EAAE,GAAG,GAAG,OAAO,EAAE,UAA8B;IAChE,IAAI,GAAI,GAAG,MAAM,EAAE,GAAG,GAAG,OAAO,EAAE,UAA8B;IAChE,KAAK,GAAI,GAAG,MAAM,EAAE,GAAG,GAAG,OAAO,EAAE,UAA+B;IAClE,IAAI,GAAI,GAAG,MAAM,EAAE,GAAG,GAAG,OAAO,EAAE,UAA8B;IAChE,OAAO,GAAI,GAAG,MAAM,EAAE,GAAG,GAAG,OAAO,EAAE,UAAiC;IACtE,KAAK,GAAI,GAAG,MAAM,EAAE,GAAG,GAAG,OAAO,EAAE,UAA+B;IAElE,SAAS,CAAC,MAAM,EAAE,SAAS,GAAG,IAAI;CAGnC;AAED,qBAAa,MAAM;IACjB,OAAO,CAAC,MAAM,CAAC,SAAS,CAA2C;IACnE,OAAO,CAAC,MAAM,CAAC,aAAa,CAAwB;IACpD,OAAO,CAAC,MAAM,CAAC,YAAY,CAAuB;IAElD,MAAM,CAAC,GAAG,CAAC,IAAI,SAAY,GAAG,mBAAmB;IAQjD,MAAM,CAAC,SAAS,CAAC,EACf,KAAkB,EAClB,MAAkB,GACnB,GAAE;QAAE,KAAK,CAAC,EAAE,QAAQ,CAAC;QAAC,MAAM,CAAC,EAAE,SAAS,CAAA;KAAO,GAAG,IAAI;IASvD,MAAM,CAAC,QAAQ,CAAC,OAAO,EAAE,OAAO,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,IAAI;IAcnD,MAAM,CAAC,SAAS,CAAC,MAAM,EAAE,SAAS,GAAG,IAAI;CAG1C;AAED,sEAAsE;AACtE,eAAO,MAAM,MAAM,qBAAe,CAAC"}
@@ -1,3 +1,9 @@
1
+ /** Installed `@mcp-use/client` package version. */
1
2
  export declare const VERSION: string;
3
+ /**
4
+ * Returns the installed `@mcp-use/client` package version.
5
+ *
6
+ * @returns Package version string.
7
+ */
2
8
  export declare function getPackageVersion(): string;
3
9
  //# sourceMappingURL=version.d.ts.map
@@ -1 +1 @@
1
- {"version":3,"file":"version.d.ts","sourceRoot":"","sources":["../../src/utils/version.ts"],"names":[],"mappings":"AAEA,eAAO,MAAM,OAAO,QAA8B,CAAC;AAEnD,wBAAgB,iBAAiB,IAAI,MAAM,CAE1C"}
1
+ {"version":3,"file":"version.d.ts","sourceRoot":"","sources":["../../src/utils/version.ts"],"names":[],"mappings":"AAEA,mDAAmD;AACnD,eAAO,MAAM,OAAO,QAA8B,CAAC;AAEnD;;;;GAIG;AACH,wBAAgB,iBAAiB,IAAI,MAAM,CAE1C"}
package/package.json CHANGED
@@ -1,7 +1,7 @@
1
1
  {
2
2
  "name": "@mcp-use/client",
3
3
  "type": "module",
4
- "version": "2.0.0-beta.16",
4
+ "version": "2.0.0-beta.18",
5
5
  "description": "MCP client for connecting to Model Context Protocol servers — sessions, connectors, and OAuth. Part of the mcp-use v2 framework.",
6
6
  "author": "mcp-use, Inc.",
7
7
  "license": "MIT",
@@ -54,9 +54,9 @@
54
54
  "node": ">=22.22.2"
55
55
  },
56
56
  "dependencies": {
57
- "@modelcontextprotocol/client": "2.0.0-beta.5",
58
- "@modelcontextprotocol/core": "2.0.0-beta.5",
59
- "@modelcontextprotocol/ext-apps": "npm:@mcp-use/ext-apps@1.7.4-pr720.0"
57
+ "@modelcontextprotocol/client": "2.0.0",
58
+ "@modelcontextprotocol/core": "2.0.0",
59
+ "@modelcontextprotocol/ext-apps": "npm:@mcp-use/ext-apps@1.7.4-pr720.1"
60
60
  },
61
61
  "peerDependencies": {
62
62
  "@e2b/code-interpreter": "^2.6.1",