@cline/core 0.0.71 → 0.0.72

package/dist/cron/reports/cron-report-writer.d.ts

@@ -23,6 +23,8 @@ export interface CronRunReportData {
     }>;
     durationMs?: number;
     error?: string;
+    /** Optional context for where in the run lifecycle the error occurred. */
+    errorContext?: string;
     triggerEvent?: CronEventLogRecord;
 }
 export interface WriteReportOptions {

package/dist/cron/service/schedule-service.d.ts

@@ -1,4 +1,5 @@
 import { type BasicLogger, type ChatRunTurnRequest, type ChatStartSessionArtifacts, type ChatStartSessionRequest, type HubScheduleCreateInput, type HubScheduleUpdateInput, type ScheduleExecutionRecord, type ScheduleExecutionStatus, type ScheduleRecord } from "@cline/shared";
+import type { ResolveCronSpecsDirOptions } from "@cline/shared/storage";
 type HubScheduleTurnResult = {
     text: string;
     usage?: {
@@ -48,6 +49,12 @@ export interface HubScheduleServiceOptions {
     eventPublisher?: (eventType: string, payload: Record<string, unknown>) => void;
     logger?: BasicLogger;
     dbPath?: string;
+    /**
+     * Cron spec source/report location forwarded to the runner. Defaults to
+     * the global `~/.cline/cron` directory — tests must override this so run
+     * reports land in a temp directory instead of the user's real one.
+     */
+    specs?: ResolveCronSpecsDirOptions;
     pollIntervalMs?: number;
     globalMaxConcurrency?: number;
     claimLeaseSeconds?: number;

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

@@ -1,9 +1,25 @@
 import type { FetchLike } from "@modelcontextprotocol/sdk/shared/transport.js";
 import type { McpServerClientFactory } from "./types";
+export declare const DEFAULT_MCP_CONNECT_TIMEOUT_MS = 3000;
 export interface DefaultMcpServerClientFactoryOptions {
     settingsPath?: string;
     clientName?: string;
     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, DEFAULT_MCP_CONNECT_TIMEOUT_MS, 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,16 +37,26 @@ 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;
     oauthProvider?: OAuthClientProvider;
     fetch?: FetchLike;
 }): McpSdkAuthCapableTransport;
+/**
+ * Recognizes a 401 from a remote MCP server across transports. The streamable
+ * HTTP transport (and SSE message POSTs) reject with the typed
+ * UnauthorizedError raised at the fetch boundary, but the SSE stream request
+ * runs inside EventSource, which consumes the response and reports the HTTP
+ * status only through SseError's code.
+ */
+export declare function isMcpUnauthorizedError(error: unknown): boolean;
 export declare function authorizeMcpServerOAuth(options: AuthorizeMcpServerOAuthOptions): Promise<AuthorizeMcpServerOAuthResult>;

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;
@@ -62,13 +67,14 @@ export interface McpServerRegistration {
     /**
      * Per-server request timeout in seconds, from the `timeout` field in
      * cline_mcp_settings.json. Undefined means the shared default for ordinary
-     * requests; the stdio client preserves its fast compatibility probe for
+     * requests; the stdio client uses its default connect budget for
      * initialize until a finite timeout is explicitly configured. Registrations are
      * resolved when the runtime is built, so changes take effect on the next
      * session.
      */
     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;
 }

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

@@ -9,6 +9,7 @@ export interface ResolveAgentPluginPathsOptions {
     pluginPaths?: ReadonlyArray<string>;
     workspacePath?: string;
     cwd?: string;
+    includeDisabled?: boolean;
 }
 export declare function resolveAgentPluginPaths(options?: ResolveAgentPluginPathsOptions): string[];
 export declare function resolvePluginSkillDirectoriesFromPaths(pluginPaths: ReadonlyArray<string>): string[];

package/dist/extensions/plugin/plugin-sandbox.d.ts

@@ -43,6 +43,30 @@ export interface PluginSandboxOptions extends PluginTargeting {
      */
     telemetryAvailable?: boolean;
 }
+/**
+ * Pick the bootstrap the sandbox subprocess should run.
+ *
+ * Sibling compiled candidates always match the running host build, so they
+ * win. When the host runs from source (the `.ts` bootstrap exists next to
+ * this module), the sandbox must run that SAME source bootstrap: the
+ * wrapper/executable fallbacks locate compiled bootstraps from a separately
+ * installed CLI package (e.g. a published version in the package-manager
+ * cache), and mixing that code with a source host silently breaks plugin
+ * loading because its module resolution points at the other installation's
+ * layout. Those fallbacks exist only for compiled hosts
+ * (`bun build --compile`) where import.meta points inside the binary and no
+ * sibling file exists on real disk.
+ */
+export declare function selectBootstrapCandidate(options: {
+    siblingCandidates: string[];
+    sourceBootstrapPath: string;
+    installedCandidates: Array<string | undefined>;
+    exists?: (path: string) => boolean;
+}): {
+    file: string;
+} | {
+    sourcePath: string;
+};
 export declare function loadSandboxedPlugins(options: PluginSandboxOptions): Promise<{
     extensions: AgentConfig["extensions"];
     pluginPaths: string[];

package/dist/hub/client/ui-client.d.ts

@@ -1,4 +1,5 @@
 import type { HubClientRecord, HubUINotifyPayload, HubUIShowWindowPayload, SessionRecord } from "@cline/shared";
+import type { CoreSettingsMutationResult, CoreSettingsToggleInput } from "../../settings";
 export interface HubUIClientOptions {
     address: string;
     authToken?: string;
@@ -29,6 +30,7 @@ export declare class HubUIClient {
     sendShowWindow(payload?: HubUIShowWindowPayload): Promise<void>;
     listClients(): Promise<HubClientRecord[]>;
     listSessions(limit?: number): Promise<SessionRecord[]>;
+    toggleSetting(input: CoreSettingsToggleInput): Promise<CoreSettingsMutationResult>;
     /**
      * Subscribe to UI-relevant hub events.
      * Returns an unsubscribe function.

package/dist/hub/daemon/entry.d.ts

@@ -3,3 +3,13 @@
  * lifecycle handlers are installed.
  */
 export declare const hubDaemonReady: Promise<void>;
+/**
+ * Abort-family rejections are expected daemon noise, not fatal faults: when a
+ * user cancels a turn, in-flight provider streams and fetches can reject on a
+ * floating promise after the run has already settled (DOMException
+ * "AbortError" from fetch/undici, Node ABORT_ERR, or the runtime's own
+ * AgentRuntimeAbortError). Exiting on those kills every resident session in
+ * the daemon — the next message from any connected client then lands on
+ * `session_not_found` and forces a rebuild from disk.
+ */
+export declare function isAbortRejection(reason: unknown): boolean;