@cline/core 0.0.70 → 0.0.71-nightly.1786072417

package/dist/extensions/mcp/client.d.ts

@@ -6,4 +6,19 @@ export interface DefaultMcpServerClientFactoryOptions {
     clientVersion?: string;
     fetch?: FetchLike;
 }
+export interface ProbeMcpServerConnectionOptions extends Omit<DefaultMcpServerClientFactoryOptions, "settingsPath"> {
+    serverName: string;
+    filePath?: string;
+}
+export interface ProbeMcpServerConnectionResult {
+    serverName: string;
+    connected: boolean;
+    authorizationRequired: boolean;
+    error?: string;
+}
 export declare function createDefaultMcpServerClientFactory(options?: DefaultMcpServerClientFactoryOptions): McpServerClientFactory;
+/**
+ * Passively verifies a configured remote MCP endpoint. This may use or refresh
+ * existing credentials, but it never starts an interactive OAuth redirect.
+ */
+export declare function probeMcpServerConnection(options: ProbeMcpServerConnectionOptions): Promise<ProbeMcpServerConnectionResult>;

package/dist/extensions/mcp/config-loader.d.ts

@@ -1,11 +1,18 @@
 import type { BasicLogger } from "@cline/shared";
-import type { McpManager, McpServerOAuthState, McpServerOAuthStatus, McpServerRegistration } from "./types";
+import type { McpManager, McpServerOAuthClientConfig, McpServerOAuthState, McpServerOAuthStatus, McpServerRegistration } from "./types";
 export interface McpSettingsFile {
     mcpServers: Record<string, Omit<McpServerRegistration, "name">>;
 }
 export interface LoadMcpSettingsOptions {
     filePath?: string;
 }
+export interface UpdateMcpServerOAuthStateOptions extends LoadMcpSettingsOptions {
+    /**
+     * When present, only update OAuth state while the server still has this
+     * configured client. `null` asserts that dynamic registration is still in use.
+     */
+    expectedOAuthClient?: McpServerOAuthClientConfig | null;
+}
 export interface RegisterMcpServersFromSettingsOptions {
     filePath?: string;
 }
@@ -24,6 +31,9 @@ export type McpSettingsMutator<T> = (settings: Record<string, unknown>) => T;
 export declare class McpSettingsUpdateSkippedError extends Error {
     constructor(message: string);
 }
+export declare class McpOAuthClientChangedError extends Error {
+    constructor(serverName: string);
+}
 export declare class McpSettingsLockTimeoutError extends Error {
     constructor(message: string);
 }
@@ -61,6 +71,14 @@ export declare function loadMcpSettingsFile(options?: LoadMcpSettingsOptions): M
 export declare function normalizeMcpServerOAuthState(value: McpServerOAuthState | undefined): McpServerOAuthState | undefined;
 export declare function hasMcpSettingsFile(options?: LoadMcpSettingsOptions): boolean;
 export declare function resolveMcpServerRegistrations(options?: LoadMcpSettingsOptions): McpServerRegistration[];
+/**
+ * Parses one raw MCP settings entry without requiring sibling entries to be
+ * valid. Hosts with an editable settings UI can use this to keep healthy and
+ * repairable entries visible when a hand-edited sibling is malformed.
+ */
+export declare function parseMcpServerRegistration(name: string, value: unknown): McpServerRegistration;
+/** Resolves one configured server without requiring sibling entries to parse. */
+export declare function resolveMcpServerRegistration(serverName: string, options?: LoadMcpSettingsOptions): McpServerRegistration | undefined;
 export declare function setMcpServerDisabled(options: SetMcpServerDisabledOptions): void;
 export declare function getMcpServerOAuthState(serverName: string, options?: LoadMcpSettingsOptions): McpServerOAuthState | undefined;
 /**
@@ -71,12 +89,14 @@ export declare function getMcpServerOAuthState(serverName: string, options?: Loa
  *
  * TODO: Delete once all callers migrate to {@link updateMcpServerOAuthStateAsync}.
  */
-export declare function updateMcpServerOAuthState(serverName: string, updater: (current: McpServerOAuthState) => McpServerOAuthState, options?: LoadMcpSettingsOptions): McpServerOAuthState;
+export declare function updateMcpServerOAuthState(serverName: string, updater: (current: McpServerOAuthState) => McpServerOAuthState, options?: UpdateMcpServerOAuthStateOptions): McpServerOAuthState;
 /**
  * Scoped read-modify-write of one server's `oauth` block that yields the event
  * loop while acquiring the lock. The updater is synchronous and pure; it
  * receives the server's current OAuth state and returns the next state.
  */
-export declare function updateMcpServerOAuthStateAsync(serverName: string, updater: (current: McpServerOAuthState) => McpServerOAuthState, options?: LoadMcpSettingsOptions): Promise<McpServerOAuthState>;
+export declare function updateMcpServerOAuthStateAsync(serverName: string, updater: (current: McpServerOAuthState) => McpServerOAuthState, options?: UpdateMcpServerOAuthStateOptions): Promise<McpServerOAuthState>;
 export declare function listMcpServerOAuthStatuses(options?: LoadMcpSettingsOptions): McpServerOAuthStatus[];
+/** Calculates OAuth status for one already-parsed registration. */
+export declare function getMcpServerOAuthStatus(registration: McpServerRegistration): McpServerOAuthStatus;
 export declare function registerMcpServersFromSettingsFile(manager: Pick<McpManager, "registerServer">, options?: RegisterMcpServersFromSettingsOptions): Promise<McpServerRegistration[]>;

package/dist/extensions/mcp/index.d.ts

@@ -1,7 +1,7 @@
-export type { DefaultMcpServerClientFactoryOptions } from "./client";
-export { createDefaultMcpServerClientFactory } from "./client";
-export type { LoadMcpSettingsOptions, McpSettingsFile, McpSettingsLockOptions, McpSettingsMutator, RegisterMcpServersFromSettingsOptions, SetMcpServerDisabledOptions, } from "./config-loader";
-export { getMcpServerOAuthState, hasMcpSettingsFile, listMcpServerOAuthStatuses, loadMcpSettingsFile, McpSettingsLockTimeoutError, McpSettingsMutatorPurityError, McpSettingsUpdateSkippedError, registerMcpServersFromSettingsFile, resolveDefaultMcpSettingsPath, resolveMcpServerRegistrations, setMcpServerDisabled, updateMcpServerOAuthState, updateMcpServerOAuthStateAsync, updateMcpSettingsFile, updateMcpSettingsFileSync, } from "./config-loader";
+export type { DefaultMcpServerClientFactoryOptions, ProbeMcpServerConnectionOptions, ProbeMcpServerConnectionResult, } from "./client";
+export { createDefaultMcpServerClientFactory, probeMcpServerConnection, } from "./client";
+export type { LoadMcpSettingsOptions, McpSettingsFile, McpSettingsLockOptions, McpSettingsMutator, RegisterMcpServersFromSettingsOptions, SetMcpServerDisabledOptions, UpdateMcpServerOAuthStateOptions, } from "./config-loader";
+export { getMcpServerOAuthState, getMcpServerOAuthStatus, hasMcpSettingsFile, listMcpServerOAuthStatuses, loadMcpSettingsFile, McpOAuthClientChangedError, McpSettingsLockTimeoutError, McpSettingsMutatorPurityError, McpSettingsUpdateSkippedError, parseMcpServerRegistration, registerMcpServersFromSettingsFile, resolveDefaultMcpSettingsPath, resolveMcpServerRegistration, resolveMcpServerRegistrations, setMcpServerDisabled, updateMcpServerOAuthState, updateMcpServerOAuthStateAsync, updateMcpSettingsFile, updateMcpSettingsFileSync, } from "./config-loader";
 export { InMemoryMcpManager } from "./manager";
 export type { AuthorizeMcpServerOAuthOptions, AuthorizeMcpServerOAuthResult, CreateMcpOAuthProviderContextOptions, McpOAuthProviderContext, } from "./oauth";
 export { authorizeMcpServerOAuth } from "./oauth";
@@ -11,4 +11,4 @@ export type { CreateDisabledMcpToolPoliciesOptions, CreateDisabledMcpToolPolicyO
 export { createDisabledMcpToolPolicies, createDisabledMcpToolPolicy, } from "./policies";
 export { augmentMcpTimeoutError } from "./timeout";
 export { createMcpTools } from "./tools";
-export type { CreateMcpToolsOptions, McpConnectionStatus, McpManager, McpManagerOptions, McpServerClient, McpServerClientFactory, McpServerOAuthState, McpServerOAuthStatus, McpServerRegistration, McpServerSnapshot, McpServerTransportConfig, McpSseTransportConfig, McpStdioTransportConfig, McpStreamableHttpTransportConfig, McpToolCallRequest, McpToolCallResult, McpToolDescriptor, McpToolNameTransform, McpToolProvider, } from "./types";
+export type { CreateMcpToolsOptions, McpConnectionStatus, McpManager, McpManagerOptions, McpServerClient, McpServerClientFactory, McpServerOAuthClientConfig, McpServerOAuthState, McpServerOAuthStatus, McpServerRegistration, McpServerSnapshot, McpServerTransportConfig, McpSseTransportConfig, McpStdioTransportConfig, McpStreamableHttpTransportConfig, McpToolCallRequest, McpToolCallResult, McpToolDescriptor, McpToolNameTransform, McpToolProvider, } from "./types";

package/dist/extensions/mcp/oauth.d.ts

@@ -1,15 +1,17 @@
 import type { OAuthClientProvider } from "@modelcontextprotocol/sdk/client/auth.js";
 import { SSEClientTransport } from "@modelcontextprotocol/sdk/client/sse.js";
 import { StreamableHTTPClientTransport } from "@modelcontextprotocol/sdk/client/streamableHttp.js";
+import type { OAuthClientInformationMixed } from "@modelcontextprotocol/sdk/shared/auth.js";
 import type { FetchLike } from "@modelcontextprotocol/sdk/shared/transport.js";
 import { type OAuthServerCloseInfo, type OAuthServerListeningInfo } from "../../auth/server";
-import type { McpServerRegistration } from "./types";
+import type { McpServerOAuthClientConfig, McpServerRegistration } from "./types";
 export type McpSdkAuthCapableTransport = SSEClientTransport | StreamableHTTPClientTransport;
 export interface CreateMcpOAuthProviderContextOptions {
     settingsPath?: string;
     serverName: string;
     redirectUrl: string;
     onAuthorizationUrl?: (url: string) => void | Promise<void>;
+    clientInformation?: OAuthClientInformationMixed;
 }
 export interface McpOAuthProviderContext {
     provider: OAuthClientProvider;
@@ -17,6 +19,8 @@ export interface McpOAuthProviderContext {
     getLastOAuthState(): string | undefined;
     resetInteractiveState(): Promise<void>;
     markError(errorMessage: string): Promise<void>;
+    markConnectionError(errorMessage: string): Promise<void>;
+    markAuthorizationRequired(errorMessage: string): Promise<void>;
     clearError(): Promise<void>;
 }
 export interface AuthorizeMcpServerOAuthOptions {
@@ -33,12 +37,14 @@ export interface AuthorizeMcpServerOAuthOptions {
     successHtml?: string;
     onServerListening?: (info: OAuthServerListeningInfo) => void | Promise<void>;
     onServerClose?: (info: OAuthServerCloseInfo) => void | Promise<void>;
+    signal?: AbortSignal;
 }
 export interface AuthorizeMcpServerOAuthResult {
     serverName: string;
     authorized: true;
     message: string;
 }
+export declare function createMcpOAuthClientInformation(config: McpServerOAuthClientConfig | undefined): OAuthClientInformationMixed | undefined;
 export declare function createMcpOAuthProviderContext(options: CreateMcpOAuthProviderContextOptions): McpOAuthProviderContext;
 export declare function createMcpSdkTransport(input: {
     registration: McpServerRegistration;

package/dist/extensions/mcp/remote-proxy.d.ts

@@ -0,0 +1,9 @@
+import type { McpServerTransportConfig, McpStdioTransportConfig, McpStreamableHttpTransportConfig } from "./types";
+/**
+ * Recognizes the exact no-option `npx mcp-remote <url>` proxy shape emitted by
+ * older marketplace entries. Cline has a native Streamable HTTP transport, so
+ * spawning the proxy would duplicate OAuth handling and let the child process
+ * open a browser as a side effect of merely enabling the server.
+ */
+export declare function resolveMcpRemoteProxyTransport(transport: McpStdioTransportConfig): McpStreamableHttpTransportConfig | undefined;
+export declare function resolveNativeMcpTransport(transport: McpServerTransportConfig): McpServerTransportConfig;

package/dist/extensions/mcp/types.d.ts

@@ -54,6 +54,11 @@ export interface McpServerOAuthState {
     redirectUrl?: string;
     lastError?: string;
     lastAuthenticatedAt?: number;
+    authorizationRequired?: boolean;
+}
+export interface McpServerOAuthClientConfig {
+    clientId: string;
+    clientSecret?: string;
 }
 export interface McpServerRegistration {
     name: string;
@@ -69,6 +74,7 @@ export interface McpServerRegistration {
      */
     timeoutSeconds?: number;
     metadata?: Record<string, unknown>;
+    oauthClient?: McpServerOAuthClientConfig;
     oauth?: McpServerOAuthState;
 }
 export interface McpServerSnapshot {
@@ -95,6 +101,7 @@ export interface McpServerOAuthStatus {
     serverName: string;
     oauthSupported: boolean;
     oauthConfigured: boolean;
+    authorizationRequired: boolean;
     lastError?: string;
     lastAuthenticatedAt?: number;
 }