@mcp-use/client 0.0.0-bootstrap.0 → 2.0.0-beta.1
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.
- package/README.md +127 -4
- package/dist/.tsbuildinfo +1 -0
- package/dist/auth/browser.d.ts +149 -0
- package/dist/auth/browser.d.ts.map +1 -0
- package/dist/auth/callback.d.ts +9 -0
- package/dist/auth/callback.d.ts.map +1 -0
- package/dist/auth/flow.d.ts +23 -0
- package/dist/auth/flow.d.ts.map +1 -0
- package/dist/auth/node.d.ts +100 -0
- package/dist/auth/node.d.ts.map +1 -0
- package/dist/auth/popup.d.ts +67 -0
- package/dist/auth/popup.d.ts.map +1 -0
- package/dist/auth/session-store.d.ts +114 -0
- package/dist/auth/session-store.d.ts.map +1 -0
- package/dist/auth/storage-file.d.ts +18 -0
- package/dist/auth/storage-file.d.ts.map +1 -0
- package/dist/auth/storage.d.ts +25 -0
- package/dist/auth/storage.d.ts.map +1 -0
- package/dist/auth/url.d.ts +17 -0
- package/dist/auth/url.d.ts.map +1 -0
- package/dist/code-mode/connector.d.ts +27 -0
- package/dist/code-mode/connector.d.ts.map +1 -0
- package/dist/code-mode/executor-e2b.d.ts +46 -0
- package/dist/code-mode/executor-e2b.d.ts.map +1 -0
- package/dist/code-mode/executor-vm.d.ts +39 -0
- package/dist/code-mode/executor-vm.d.ts.map +1 -0
- package/dist/code-mode/executor.d.ts +66 -0
- package/dist/code-mode/executor.d.ts.map +1 -0
- package/dist/core/base.d.ts +418 -0
- package/dist/core/base.d.ts.map +1 -0
- package/dist/core/browser.d.ts +20 -0
- package/dist/core/browser.d.ts.map +1 -0
- package/dist/core/config.d.ts +149 -0
- package/dist/core/config.d.ts.map +1 -0
- package/dist/core/node.d.ts +441 -0
- package/dist/core/node.d.ts.map +1 -0
- package/dist/core/session.d.ts +683 -0
- package/dist/core/session.d.ts.map +1 -0
- package/dist/index-browser.d.ts +25 -0
- package/dist/index-browser.d.ts.map +1 -0
- package/dist/index-browser.js +4150 -0
- package/dist/index-browser.js.map +1 -0
- package/dist/index.d.ts +23 -0
- package/dist/index.d.ts.map +1 -0
- package/dist/index.js +5598 -0
- package/dist/index.js.map +1 -0
- package/dist/react/McpClientProvider.d.ts +242 -0
- package/dist/react/McpClientProvider.d.ts.map +1 -0
- package/dist/react/index.d.ts +33 -0
- package/dist/react/index.d.ts.map +1 -0
- package/dist/react/index.js +7936 -0
- package/dist/react/index.js.map +1 -0
- package/dist/react/rpc-logger.d.ts +42 -0
- package/dist/react/rpc-logger.d.ts.map +1 -0
- package/dist/react/storage.d.ts +51 -0
- package/dist/react/storage.d.ts.map +1 -0
- package/dist/react/types.d.ts +596 -0
- package/dist/react/types.d.ts.map +1 -0
- package/dist/react/useMcp-helpers.d.ts +99 -0
- package/dist/react/useMcp-helpers.d.ts.map +1 -0
- package/dist/react/useMcp-operations.d.ts +156 -0
- package/dist/react/useMcp-operations.d.ts.map +1 -0
- package/dist/react/useMcp.d.ts +48 -0
- package/dist/react/useMcp.d.ts.map +1 -0
- package/dist/react/useMcpServerQueues.d.ts +376 -0
- package/dist/react/useMcpServerQueues.d.ts.map +1 -0
- package/dist/react/view/ViewRenderer.d.ts +12 -0
- package/dist/react/view/ViewRenderer.d.ts.map +1 -0
- package/dist/react/view/ext-apps-bridge.d.ts +3 -0
- package/dist/react/view/ext-apps-bridge.d.ts.map +1 -0
- package/dist/react/view/parse-custom-props.d.ts +2 -0
- package/dist/react/view/parse-custom-props.d.ts.map +1 -0
- package/dist/react/view/resolve-view-resource.d.ts +12 -0
- package/dist/react/view/resolve-view-resource.d.ts.map +1 -0
- package/dist/react/view/sandbox-blob-url.d.ts +25 -0
- package/dist/react/view/sandbox-blob-url.d.ts.map +1 -0
- package/dist/react/view/types.d.ts +97 -0
- package/dist/react/view/types.d.ts.map +1 -0
- package/dist/react/view/use-display-mode.d.ts +18 -0
- package/dist/react/view/use-display-mode.d.ts.map +1 -0
- package/dist/react/view/view-detection.d.ts +4 -0
- package/dist/react/view/view-detection.d.ts.map +1 -0
- package/dist/telemetry/client-telemetry.d.ts +13 -0
- package/dist/telemetry/client-telemetry.d.ts.map +1 -0
- package/dist/telemetry/configure-browser.d.ts +2 -0
- package/dist/telemetry/configure-browser.d.ts.map +1 -0
- package/dist/telemetry/configure-node.d.ts +2 -0
- package/dist/telemetry/configure-node.d.ts.map +1 -0
- package/dist/telemetry/connector-telemetry.d.ts +8 -0
- package/dist/telemetry/connector-telemetry.d.ts.map +1 -0
- package/dist/telemetry/events.d.ts +91 -0
- package/dist/telemetry/events.d.ts.map +1 -0
- package/dist/telemetry/index.d.ts +3 -0
- package/dist/telemetry/index.d.ts.map +1 -0
- package/dist/telemetry/tel-fetch.d.ts +25 -0
- package/dist/telemetry/tel-fetch.d.ts.map +1 -0
- package/dist/telemetry/telemetry-browser.d.ts +6 -0
- package/dist/telemetry/telemetry-browser.d.ts.map +1 -0
- package/dist/telemetry/telemetry-node.d.ts +8 -0
- package/dist/telemetry/telemetry-node.d.ts.map +1 -0
- package/dist/telemetry/telemetry.d.ts +79 -0
- package/dist/telemetry/telemetry.d.ts.map +1 -0
- package/dist/transport/base.d.ts +505 -0
- package/dist/transport/base.d.ts.map +1 -0
- package/dist/transport/connection-manager.d.ts +55 -0
- package/dist/transport/connection-manager.d.ts.map +1 -0
- package/dist/transport/http.d.ts +74 -0
- package/dist/transport/http.d.ts.map +1 -0
- package/dist/transport/stdio.d.ts +48 -0
- package/dist/transport/stdio.d.ts.map +1 -0
- package/dist/utils/elicitation.d.ts +52 -0
- package/dist/utils/elicitation.d.ts.map +1 -0
- package/dist/utils/favicon.d.ts +6 -0
- package/dist/utils/favicon.d.ts.map +1 -0
- package/dist/utils/json-schema-validator.d.ts +13 -0
- package/dist/utils/json-schema-validator.d.ts.map +1 -0
- package/dist/utils/logging.d.ts +32 -0
- package/dist/utils/logging.d.ts.map +1 -0
- package/dist/utils/version.d.ts +3 -0
- package/dist/utils/version.d.ts.map +1 -0
- package/package.json +77 -8
|
@@ -0,0 +1,91 @@
|
|
|
1
|
+
export declare abstract class BaseTelemetryEvent {
|
|
2
|
+
abstract get name(): string;
|
|
3
|
+
abstract get properties(): Record<string, any>;
|
|
4
|
+
}
|
|
5
|
+
export interface MCPAgentExecutionEventData {
|
|
6
|
+
executionMethod: string;
|
|
7
|
+
query: string;
|
|
8
|
+
success: boolean;
|
|
9
|
+
modelProvider: string;
|
|
10
|
+
modelName: string;
|
|
11
|
+
serverCount: number;
|
|
12
|
+
serverIdentifiers: Array<Record<string, string>>;
|
|
13
|
+
totalToolsAvailable: number;
|
|
14
|
+
toolsAvailableNames: string[];
|
|
15
|
+
maxStepsConfigured: number;
|
|
16
|
+
memoryEnabled: boolean;
|
|
17
|
+
useServerManager: boolean;
|
|
18
|
+
maxStepsUsed: number | null;
|
|
19
|
+
manageConnector: boolean;
|
|
20
|
+
externalHistoryUsed: boolean;
|
|
21
|
+
stepsTaken?: number | null;
|
|
22
|
+
toolsUsedCount?: number | null;
|
|
23
|
+
toolsUsedNames?: string[] | null;
|
|
24
|
+
response?: string | null;
|
|
25
|
+
executionTimeMs?: number | null;
|
|
26
|
+
errorType?: string | null;
|
|
27
|
+
conversationHistoryLength?: number | null;
|
|
28
|
+
}
|
|
29
|
+
export declare class MCPAgentExecutionEvent extends BaseTelemetryEvent {
|
|
30
|
+
private data;
|
|
31
|
+
constructor(data: MCPAgentExecutionEventData);
|
|
32
|
+
get name(): string;
|
|
33
|
+
get properties(): Record<string, any>;
|
|
34
|
+
}
|
|
35
|
+
export interface MCPClientInitEventData {
|
|
36
|
+
codeMode: boolean;
|
|
37
|
+
sandbox: boolean;
|
|
38
|
+
allCallbacks: boolean;
|
|
39
|
+
verify: boolean;
|
|
40
|
+
servers: string[];
|
|
41
|
+
numServers: number;
|
|
42
|
+
isBrowser: boolean;
|
|
43
|
+
}
|
|
44
|
+
export declare class MCPClientInitEvent extends BaseTelemetryEvent {
|
|
45
|
+
private data;
|
|
46
|
+
constructor(data: MCPClientInitEventData);
|
|
47
|
+
get name(): string;
|
|
48
|
+
get properties(): Record<string, any>;
|
|
49
|
+
}
|
|
50
|
+
export interface ConnectorInitEventData {
|
|
51
|
+
connectorType: string;
|
|
52
|
+
serverCommand?: string | null;
|
|
53
|
+
serverArgs?: string[] | null;
|
|
54
|
+
serverUrl?: string | null;
|
|
55
|
+
publicIdentifier?: string | null;
|
|
56
|
+
}
|
|
57
|
+
export declare class ConnectorInitEvent extends BaseTelemetryEvent {
|
|
58
|
+
private data;
|
|
59
|
+
constructor(data: ConnectorInitEventData);
|
|
60
|
+
get name(): string;
|
|
61
|
+
get properties(): Record<string, any>;
|
|
62
|
+
}
|
|
63
|
+
/**
|
|
64
|
+
* Raw input data for tracking server addition.
|
|
65
|
+
* The event class will extract the necessary properties.
|
|
66
|
+
*/
|
|
67
|
+
interface ClientAddServerEventInput {
|
|
68
|
+
serverName: string;
|
|
69
|
+
serverConfig: Record<string, any>;
|
|
70
|
+
}
|
|
71
|
+
export declare class ClientAddServerEvent extends BaseTelemetryEvent {
|
|
72
|
+
private data;
|
|
73
|
+
constructor(data: ClientAddServerEventInput);
|
|
74
|
+
get name(): string;
|
|
75
|
+
get properties(): Record<string, any>;
|
|
76
|
+
private _extractHostname;
|
|
77
|
+
}
|
|
78
|
+
/**
|
|
79
|
+
* Raw input data for tracking server removal.
|
|
80
|
+
*/
|
|
81
|
+
interface ClientRemoveServerEventInput {
|
|
82
|
+
serverName: string;
|
|
83
|
+
}
|
|
84
|
+
export declare class ClientRemoveServerEvent extends BaseTelemetryEvent {
|
|
85
|
+
private data;
|
|
86
|
+
constructor(data: ClientRemoveServerEventInput);
|
|
87
|
+
get name(): string;
|
|
88
|
+
get properties(): Record<string, any>;
|
|
89
|
+
}
|
|
90
|
+
export {};
|
|
91
|
+
//# sourceMappingURL=events.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"events.d.ts","sourceRoot":"","sources":["../../src/telemetry/events.ts"],"names":[],"mappings":"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"}
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/telemetry/index.ts"],"names":[],"mappings":"AACA,OAAO,EACL,SAAS,EACT,GAAG,EACH,kBAAkB,EAClB,iBAAiB,GAClB,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EACL,QAAQ,EACR,cAAc,EACd,YAAY,EACZ,YAAY,EACZ,eAAe,EACf,iBAAiB,GAClB,MAAM,gBAAgB,CAAC"}
|
|
@@ -0,0 +1,25 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* Fire-and-forget telemetry HTTP request. Never surfaces network/HTTP failures
|
|
3
|
+
* to the host app — telemetry must not log or throw into user code.
|
|
4
|
+
*/
|
|
5
|
+
export declare function telFetch(url: string, init?: RequestInit): Promise<void>;
|
|
6
|
+
export declare const POSTHOG_HOST = "https://eu.i.posthog.com";
|
|
7
|
+
export declare const POSTHOG_API_KEY = "phc_lyTtbYwvkdSbrcMQNPiKiiRWrrM1seyKIMjycSvItEI";
|
|
8
|
+
export declare const SCARF_GATEWAY_URL = "https://mcpuse.gateway.scarf.sh/events-ts";
|
|
9
|
+
export declare const SCARF_GATEWAY_BEACON_URL = "https://mcpuse.gateway.scarf.sh/simple/";
|
|
10
|
+
/** Build a GET beacon URL for browser Scarf telemetry (query params, length-capped). */
|
|
11
|
+
export declare function buildScarfBeaconUrl(properties: Record<string, unknown>, baseUrl?: string): string;
|
|
12
|
+
/**
|
|
13
|
+
* Send a single event to PostHog's public capture endpoint using `fetch` only
|
|
14
|
+
* (no `posthog-js` / `posthog-node` SDK dependency). Errors are swallowed.
|
|
15
|
+
*/
|
|
16
|
+
export declare function capturePostHog(params: {
|
|
17
|
+
host?: string;
|
|
18
|
+
apiKey?: string;
|
|
19
|
+
event: string;
|
|
20
|
+
distinctId: string;
|
|
21
|
+
properties: Record<string, unknown>;
|
|
22
|
+
}): Promise<void>;
|
|
23
|
+
/** Send a single event to Scarf. Browser uses GET image beacon; Node uses POST JSON. */
|
|
24
|
+
export declare function captureScarf(properties: Record<string, unknown>, endpoint?: string): Promise<void>;
|
|
25
|
+
//# sourceMappingURL=tel-fetch.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"tel-fetch.d.ts","sourceRoot":"","sources":["../../src/telemetry/tel-fetch.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,wBAAsB,QAAQ,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC,CAM7E;AAED,eAAO,MAAM,YAAY,6BAA6B,CAAC;AACvD,eAAO,MAAM,eAAe,oDACuB,CAAC;AACpD,eAAO,MAAM,iBAAiB,8CAA8C,CAAC;AAC7E,eAAO,MAAM,wBAAwB,4CACM,CAAC;AAkB5C,wFAAwF;AACxF,wBAAgB,mBAAmB,CACjC,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EACnC,OAAO,GAAE,MAAiC,GACzC,MAAM,CAwBR;AA6BD;;;GAGG;AACH,wBAAgB,cAAc,CAAC,MAAM,EAAE;IACrC,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,MAAM,CAAC;IACd,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACrC,GAAG,OAAO,CAAC,IAAI,CAAC,CAehB;AAED,wFAAwF;AACxF,wBAAgB,YAAY,CAC1B,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EACnC,QAAQ,GAAE,MAA0B,GACnC,OAAO,CAAC,IAAI,CAAC,CAOf"}
|
|
@@ -0,0 +1,6 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* Browser entry for telemetry: re-exports the shared Telemetry singleton
|
|
3
|
+
* (localStorage when available; no `node:fs`).
|
|
4
|
+
*/
|
|
5
|
+
export { Telemetry, Tel, setTelemetrySource, setProductVersion, } from "./telemetry.js";
|
|
6
|
+
//# sourceMappingURL=telemetry-browser.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"telemetry-browser.d.ts","sourceRoot":"","sources":["../../src/telemetry/telemetry-browser.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,OAAO,EACL,SAAS,EACT,GAAG,EACH,kBAAkB,EAClB,iBAAiB,GAClB,MAAM,gBAAgB,CAAC"}
|
|
@@ -0,0 +1,8 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* Node entry for telemetry: installs filesystem persistence, then re-exports
|
|
3
|
+
* the shared Telemetry singleton. `node:fs` stays here so it never enters
|
|
4
|
+
* browser bundles.
|
|
5
|
+
*/
|
|
6
|
+
import { Tel, Telemetry, setProductVersion, setTelemetrySource } from "./telemetry.js";
|
|
7
|
+
export { Telemetry, Tel, setTelemetrySource, setProductVersion };
|
|
8
|
+
//# sourceMappingURL=telemetry-node.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"telemetry-node.d.ts","sourceRoot":"","sources":["../../src/telemetry/telemetry-node.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAEL,GAAG,EACH,SAAS,EACT,iBAAiB,EACjB,kBAAkB,EAEnB,MAAM,gBAAgB,CAAC;AAkFxB,OAAO,EAAE,SAAS,EAAE,GAAG,EAAE,kBAAkB,EAAE,iBAAiB,EAAE,CAAC"}
|
|
@@ -0,0 +1,79 @@
|
|
|
1
|
+
import type { BaseTelemetryEvent, ConnectorInitEventData, MCPAgentExecutionEventData, MCPClientInitEventData } from "./events.js";
|
|
2
|
+
/** True when semver `a` is strictly greater than `b` (numeric segments only). */
|
|
3
|
+
export declare function isVersionGreater(a: string, b: string): boolean;
|
|
4
|
+
export type TelemetryStorage = {
|
|
5
|
+
getUserId(): string | null;
|
|
6
|
+
setUserId(id: string): void;
|
|
7
|
+
getDownloadedVersion(): string | null;
|
|
8
|
+
setDownloadedVersion(version: string): void;
|
|
9
|
+
};
|
|
10
|
+
type RuntimeEnvironment = "browser" | "node" | "cloudflare-workers" | "edge" | "deno" | "bun" | "unknown";
|
|
11
|
+
type StorageCapability = "persistent" | "session-only";
|
|
12
|
+
export declare function configureTelemetryStorage(storage: TelemetryStorage): void;
|
|
13
|
+
/**
|
|
14
|
+
* Shared telemetry singleton for node and browser.
|
|
15
|
+
*
|
|
16
|
+
* Usage: `Tel.getInstance().trackMCPClientInit(...)`
|
|
17
|
+
*/
|
|
18
|
+
export declare class Telemetry {
|
|
19
|
+
private static instance;
|
|
20
|
+
private readonly UNKNOWN_USER_ID;
|
|
21
|
+
private _currUserId;
|
|
22
|
+
private _telemetryEnabled;
|
|
23
|
+
private _pending;
|
|
24
|
+
private _scarfEnabled;
|
|
25
|
+
private _runtimeEnvironment;
|
|
26
|
+
private _storageCapability;
|
|
27
|
+
private _storage;
|
|
28
|
+
/** True when node entry installed fs storage (package-download dedup). */
|
|
29
|
+
private _fsBacked;
|
|
30
|
+
private _source;
|
|
31
|
+
private _productVersion?;
|
|
32
|
+
private constructor();
|
|
33
|
+
get runtimeEnvironment(): RuntimeEnvironment;
|
|
34
|
+
get storageCapability(): StorageCapability;
|
|
35
|
+
static getInstance(): Telemetry;
|
|
36
|
+
setSource(source: string): void;
|
|
37
|
+
getSource(): string;
|
|
38
|
+
setProductVersion(version: string): void;
|
|
39
|
+
get isEnabled(): boolean;
|
|
40
|
+
get userId(): string;
|
|
41
|
+
capture(event: BaseTelemetryEvent): Promise<void>;
|
|
42
|
+
trackPackageDownload(properties?: Record<string, unknown>): Promise<void>;
|
|
43
|
+
trackAgentExecution(data: MCPAgentExecutionEventData): Promise<void>;
|
|
44
|
+
trackMCPClientInit(data: MCPClientInitEventData): Promise<void>;
|
|
45
|
+
trackConnectorInit(data: ConnectorInitEventData): Promise<void>;
|
|
46
|
+
trackClientAddServer(serverName: string, serverConfig: Record<string, any>): Promise<void>;
|
|
47
|
+
trackClientRemoveServer(serverName: string): Promise<void>;
|
|
48
|
+
trackUseMcpConnection(data: {
|
|
49
|
+
url: string;
|
|
50
|
+
transportType: string;
|
|
51
|
+
success: boolean;
|
|
52
|
+
errorType?: string | null;
|
|
53
|
+
connectionTimeMs?: number | null;
|
|
54
|
+
hasOAuth: boolean;
|
|
55
|
+
hasSampling: boolean;
|
|
56
|
+
hasElicitation: boolean;
|
|
57
|
+
}): Promise<void>;
|
|
58
|
+
trackUseMcpToolCall(data: {
|
|
59
|
+
toolName: string;
|
|
60
|
+
success: boolean;
|
|
61
|
+
errorType?: string | null;
|
|
62
|
+
executionTimeMs?: number | null;
|
|
63
|
+
}): Promise<void>;
|
|
64
|
+
trackUseMcpResourceRead(data: {
|
|
65
|
+
resourceUri: string;
|
|
66
|
+
success: boolean;
|
|
67
|
+
errorType?: string | null;
|
|
68
|
+
}): Promise<void>;
|
|
69
|
+
identify(userId: string, properties?: Record<string, unknown>): void;
|
|
70
|
+
reset(): void;
|
|
71
|
+
flush(): void;
|
|
72
|
+
shutdown(): Promise<void>;
|
|
73
|
+
}
|
|
74
|
+
/** @alias */
|
|
75
|
+
export declare const Tel: typeof Telemetry;
|
|
76
|
+
export declare function setTelemetrySource(source: string): void;
|
|
77
|
+
export declare function setProductVersion(version: string): void;
|
|
78
|
+
export {};
|
|
79
|
+
//# sourceMappingURL=telemetry.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"telemetry.d.ts","sourceRoot":"","sources":["../../src/telemetry/telemetry.ts"],"names":[],"mappings":"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"}
|