@mcp-use/client 0.0.0-bootstrap.0 → 2.0.0-beta.1

package/dist/transport/stdio.d.ts

@@ -0,0 +1,48 @@
+import type { VersionNegotiationMode } from "@modelcontextprotocol/client";
+import type { StdioServerParameters } from "@modelcontextprotocol/client/stdio";
+import type { Writable } from "node:stream";
+import type { ConnectorInitOptions } from "./base.js";
+import { ConnectionManager } from "./connection-manager.js";
+import { StdioClientTransport } from "@modelcontextprotocol/client/stdio";
+import { BaseConnector } from "./base.js";
+import type { ClientInfo } from "./http.js";
+interface StdioConnectorOptions extends ConnectorInitOptions {
+    clientInfo?: ClientInfo;
+    /**
+     * Protocol version negotiation mode. Defaults to `"legacy"` for stdio: the
+     * SDK docs advise against `"auto"` for spawn-per-invocation CLI/debug tools
+     * (a legacy server that never answers unknown pre-`initialize` requests
+     * stalls the probe, and the probe round trip perturbs byte-stable
+     * transcripts). Opt into `"auto"` or a pin explicitly.
+     */
+    protocolNegotiation?: VersionNegotiationMode;
+}
+export declare class StdioConnector extends BaseConnector {
+    private readonly command;
+    private readonly args;
+    private readonly env?;
+    private readonly cwd?;
+    private readonly errlog;
+    private readonly clientInfo;
+    private readonly protocolNegotiation;
+    constructor({ command, args, env, errlog, ...rest }?: {
+        command?: string;
+        args?: string[];
+        env?: Record<string, string>;
+        errlog?: Writable;
+        cwd?: string;
+    } & StdioConnectorOptions);
+    /** Establish connection to the MCP implementation. */
+    connect(): Promise<void>;
+    get publicIdentifier(): Record<string, string>;
+}
+export declare class StdioConnectionManager extends ConnectionManager<StdioClientTransport> {
+    private readonly serverParams;
+    private readonly errlog;
+    private _transport;
+    constructor(serverParams: StdioServerParameters, errlog?: Writable);
+    protected establishConnection(): Promise<StdioClientTransport>;
+    protected closeConnection(_connection: StdioClientTransport): Promise<void>;
+}
+export {};
+//# sourceMappingURL=stdio.d.ts.map

package/dist/transport/stdio.d.ts.map

@@ -0,0 +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"}

package/dist/utils/elicitation.d.ts

@@ -0,0 +1,52 @@
+/**
+ * Client-side helpers for MCP elicitation (form/URL mode).
+ *
+ * The server sends `requestedSchema` as JSON Schema. These helpers provide
+ * defaults extraction, validation (via Zod's `z.fromJSONSchema`), and typed
+ * ElicitResult builders.
+ */
+import type { ElicitRequestFormParams, ElicitRequestURLParams, ElicitResult } from "@modelcontextprotocol/client";
+/** Content shape for ElicitResult when action is "accept". */
+export type ElicitContent = Record<string, string | number | boolean | string[]>;
+/** Result of validate(params, content). */
+export type ElicitValidationResult = {
+    valid: boolean;
+    errors?: string[];
+};
+type ElicitParams = ElicitRequestFormParams | ElicitRequestURLParams;
+/**
+ * Get default values from the elicitation request's requestedSchema (form mode).
+ * For URL mode or when no schema is present, returns an empty object.
+ */
+export declare function getDefaults(params: ElicitParams): ElicitContent;
+/**
+ * Merge partial content with schema defaults. Keys present in partial are kept;
+ * missing keys are filled from requestedSchema.properties[*].default.
+ */
+export declare function applyDefaults(params: ElicitParams, partial?: ElicitContent): ElicitContent;
+/**
+ * Return an ElicitResult that accepts with content built from schema defaults.
+ */
+export declare function acceptWithDefaults(params: ElicitParams): ElicitResult;
+/**
+ * Return an ElicitResult that accepts with the given content.
+ */
+export declare function accept(content: ElicitContent): ElicitResult;
+/**
+ * Return an ElicitResult that declines the elicitation (user chose not to provide).
+ * Optional reason is for logging; the SDK result is { action: "decline" }.
+ */
+export declare function decline(_reason?: string): ElicitResult;
+/**
+ * Return an ElicitResult that cancels the elicitation (user cancelled the operation).
+ */
+export declare function cancel(): ElicitResult;
+/**
+ * Validate content against the request's requestedSchema using Zod.
+ * Converts requestedSchema (JSON Schema) via `z.fromJSONSchema`, then
+ * safeParse(content). If conversion fails, returns
+ * { valid: false, errors: ["Unsupported or invalid schema"] }.
+ */
+export declare function validate(params: ElicitParams, content: ElicitContent): ElicitValidationResult;
+export {};
+//# sourceMappingURL=elicitation.d.ts.map

package/dist/utils/elicitation.d.ts.map

@@ -0,0 +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"}

package/dist/utils/favicon.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Detect and retrieve an MCP server's favicon as a base64 data URL.
+ * Skips local/private hosts; walks subdomain levels until a non-default favicon is found.
+ */
+export declare function detectFavicon(serverUrl: string): Promise<string | null>;
+//# sourceMappingURL=favicon.d.ts.map

package/dist/utils/favicon.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"favicon.d.ts","sourceRoot":"","sources":["../../src/utils/favicon.ts"],"names":[],"mappings":"AAgDA;;;GAGG;AACH,wBAAsB,aAAa,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAgC7E"}

package/dist/utils/json-schema-validator.d.ts

@@ -0,0 +1,13 @@
+import type { JsonSchemaType, jsonSchemaValidator } from "@modelcontextprotocol/client";
+/**
+ * JSON Schema validator that maps common `$schema` dialect URIs to the
+ * matching `@cfworker/json-schema` draft. The v2 SDK default rejects any
+ * schema not declaring JSON Schema 2020-12 as an "unsupported dialect", which
+ * breaks `tools/call` against v1-era servers that emit draft-04/-07/2019-09
+ * `$schema` on tool `outputSchema` (mcp-use#1839). Unknown `$schema` URIs
+ * still fail fast via the SDK's strict default validator.
+ */
+export declare class DialectJsonSchemaValidator implements jsonSchemaValidator {
+    getValidator<T>(schema: JsonSchemaType): import("@modelcontextprotocol/client").JsonSchemaValidator<T>;
+}
+//# sourceMappingURL=json-schema-validator.d.ts.map

package/dist/utils/json-schema-validator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"json-schema-validator.d.ts","sourceRoot":"","sources":["../../src/utils/json-schema-validator.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,cAAc,EACd,mBAAmB,EACpB,MAAM,8BAA8B,CAAC;AAmCtC;;;;;;;GAOG;AACH,qBAAa,0BAA2B,YAAW,mBAAmB;IACpE,YAAY,CAAC,CAAC,EAAE,MAAM,EAAE,cAAc;CAQvC"}

package/dist/utils/logging.d.ts

@@ -0,0 +1,32 @@
+export type LogLevel = "silent" | "error" | "warn" | "info" | "http" | "verbose" | "debug" | "silly";
+type LogFormat = "minimal" | "detailed" | "emoji";
+declare class SimpleConsoleLogger {
+    private name;
+    level: LogLevel;
+    format: LogFormat;
+    constructor(name?: string, level?: LogLevel, format?: LogFormat);
+    private write;
+    error: (m: string, ...a: unknown[]) => void;
+    warn: (m: string, ...a: unknown[]) => void;
+    info: (m: string, ...a: unknown[]) => void;
+    debug: (m: string, ...a: unknown[]) => void;
+    http: (m: string, ...a: unknown[]) => void;
+    verbose: (m: string, ...a: unknown[]) => void;
+    silly: (m: string, ...a: unknown[]) => void;
+    setFormat(format: LogFormat): void;
+}
+export declare class Logger {
+    private static instances;
+    private static currentFormat;
+    private static currentLevel;
+    static get(name?: string): SimpleConsoleLogger;
+    static configure({ level, format, }?: {
+        level?: LogLevel;
+        format?: LogFormat;
+    }): void;
+    static setDebug(enabled: boolean | 0 | 1 | 2): void;
+    static setFormat(format: LogFormat): void;
+}
+export declare const logger: SimpleConsoleLogger;
+export {};
+//# sourceMappingURL=logging.d.ts.map

package/dist/utils/logging.d.ts.map

@@ -0,0 +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"}

package/dist/utils/version.d.ts

@@ -0,0 +1,3 @@
+export declare const VERSION: string;
+export declare function getPackageVersion(): string;
+//# sourceMappingURL=version.d.ts.map

package/dist/utils/version.d.ts.map

@@ -0,0 +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"}

package/package.json

@@ -1,18 +1,87 @@
 {
   "name": "@mcp-use/client",
-  "version": "0.0.0-bootstrap.0",
-  "description": "Package-name reservation for GitHub OIDC releases of @mcp-use/client.",
+  "type": "module",
+  "version": "2.0.0-beta.1",
+  "description": "MCP client for connecting to Model Context Protocol servers — sessions, connectors, and OAuth. Part of the mcp-use v2 framework.",
+  "author": "mcp-use, Inc.",
   "license": "MIT",
+  "homepage": "https://github.com/mcp-use/mcp-use#readme",
   "repository": {
     "type": "git",
-    "url": "git+https://github.com/mcp-use/mcp-use.git"
+    "url": "git+https://github.com/mcp-use/mcp-use.git",
+    "directory": "libraries/typescript/packages/client"
   },
-  "homepage": "https://github.com/mcp-use/mcp-use",
+  "bugs": {
+    "url": "https://github.com/mcp-use/mcp-use/issues"
+  },
+  "keywords": [
+    "mcp",
+    "model-context-protocol",
+    "client",
+    "oauth",
+    "typescript"
+  ],
+  "exports": {
+    ".": {
+      "node": {
+        "types": "./dist/index.d.ts",
+        "import": "./dist/index.js"
+      },
+      "browser": {
+        "types": "./dist/index-browser.d.ts",
+        "import": "./dist/index-browser.js"
+      },
+      "default": {
+        "types": "./dist/index-browser.d.ts",
+        "import": "./dist/index-browser.js"
+      }
+    },
+    "./react": {
+      "types": "./dist/react/index.d.ts",
+      "import": "./dist/react/index.js"
+    }
+  },
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
   "files": [
-    "README.md"
+    "dist"
   ],
+  "engines": {
+    "node": ">=20.0.0"
+  },
+  "dependencies": {
+    "@modelcontextprotocol/client": "https://pkg.pr.new/@modelcontextprotocol/client@f60b40179b0f090f6d64248be1312245a160b5ee",
+    "@modelcontextprotocol/ext-apps": "https://pkg.pr.new/@modelcontextprotocol/ext-apps@432d42bb02a569078ab31ab6458428df6027809d"
+  },
+  "peerDependencies": {
+    "@e2b/code-interpreter": "^2.6.1",
+    "react": "^18.0.0 || ^19.0.0",
+    "zod": "^4.2.0"
+  },
+  "peerDependenciesMeta": {
+    "@e2b/code-interpreter": {
+      "optional": true
+    },
+    "react": {
+      "optional": true
+    }
+  },
+  "devDependencies": {
+    "@e2b/code-interpreter": "^2.6.1",
+    "@types/react": "^19.2.14",
+    "jsdom": "^27.0.0",
+    "react": "^19.2.3",
+    "react-test-renderer": "^19.2.4",
+    "vitest": "^4.1.0",
+    "zod": "^4.2.0"
+  },
   "publishConfig": {
-    "access": "public",
-    "tag": "bootstrap"
+    "access": "public"
+  },
+  "scripts": {
+    "build": "rimraf dist && tsup && tsc --emitDeclarationOnly --declaration",
+    "dev": "tsc --watch",
+    "test": "vitest",
+    "test:run": "vitest run"
   }
-}
+}