@cline/core 0.0.95 → 0.2.0

package/dist/cloud/types.d.ts

@@ -1,7 +1,10 @@
 import type { AgentMode, HubEventEnvelope, MessageWithMetadata } from "@cline/shared";
 import type { CloudSessionRecord, CreateCloudSessionInput } from "./api";
 export type JsonRecord = Record<string, unknown>;
-export type CloudCreationOptions = Pick<CreateCloudSessionInput, "autoApproveTools" | "thinking" | "reasoningEffort">;
+export type CloudCreationOptions = Pick<CreateCloudSessionInput, "autoApproveTools" | "thinking" | "reasoningEffort" | "mode" | "workspaceRelativePath">;
+export type CloudSendLifecycle = {
+    beforeDispatch?: () => void;
+};
 export type CloudHandoffSeed = {
     sourceSessionId: string;
     messages: MessageWithMetadata[];

package/dist/extensions/context/compaction-shared.d.ts

@@ -43,6 +43,7 @@ export type EstimateMessageTokens = (message: MessageWithMetadata) => number;
  */
 export declare function resolveEffectiveMaxInputTokens(input: Pick<ModelInfo, "maxInputTokens" | "contextWindow">): number | undefined;
 export declare function truncateText(text: string, limit: number): string;
+export declare function resolveProviderMaxInputTokens(providerConfig: ProviderConfig): number | undefined;
 export declare function flattenToolResultContent(content: ToolResultContent["content"]): string;
 export declare function truncateToolResultContentForCompaction(content: ToolResultContent["content"]): ToolResultContent["content"];
 export declare function formatToolInput(input: Record<string, unknown>): string;

package/dist/extensions/context/compaction.d.ts

@@ -76,6 +76,13 @@ export declare function createImportedHistoryCompactionPrepareTurn(input: {
 export declare function createCompactionStateAwarePrepareTurn(input: {
     compact?: ContextPipelinePrepareTurn;
     getState?: () => SessionCompactionState | undefined;
+    /**
+     * The runtime's provider-request transform (extension message builders +
+     * `MessageBuilder.buildForApi`), i.e. what produced `context.apiMessages`
+     * from `context.messages`. Re-compaction swaps in a projected transcript
+     * and must estimate against its API-safe form, not the raw projection.
+     */
+    prepareApiMessages: (messages: CoreCompactionContext["messages"]) => Promise<CoreCompactionContext["messages"]>;
     /**
      * Persist a freshly-computed compaction state. `sourceMessages` are the
      * exact canonical messages the state's source-prefix hash was computed

package/dist/extensions/context/summarize-conversation.d.ts

@@ -0,0 +1,7 @@
+import { type MessageWithMetadata } from "@cline/shared";
+import { type ConnectionConfig } from "../../services/llms/handler-factory";
+export declare function summarizeConversation(options: {
+    messages: MessageWithMetadata[];
+    config: ConnectionConfig;
+    signal?: AbortSignal;
+}): Promise<string>;

package/dist/extensions/context/summary-generation.d.ts

@@ -0,0 +1,14 @@
+import type { ProviderConfig } from "../../types/provider-settings";
+export declare function generateSummary(options: {
+    providerConfig: ProviderConfig;
+    systemPrompt: string;
+    request: string;
+    maxOutputChars?: number;
+    signal?: AbortSignal;
+}): Promise<{
+    text: string;
+    reasoningChars: number;
+    failed: boolean;
+    usedTools: boolean;
+    incompleteReason: string | undefined;
+}>;

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

@@ -0,0 +1,16 @@
+import type { McpToolDescriptor } from "./types";
+export declare const MCP_APPS_EXTENSION_ID = "io.modelcontextprotocol/ui";
+export declare const MCP_APP_MIME_TYPE = "text/html;profile=mcp-app";
+export declare const MCP_APP_RESOURCE_URI_SCHEME = "ui:";
+export type McpAppToolVisibility = "model" | "app";
+export interface McpAppToolMeta {
+    resourceUri?: string;
+    visibility: readonly McpAppToolVisibility[];
+}
+export declare function createMcpAppsClientCapabilities(): {
+    extensions: Record<string, Record<string, unknown>>;
+};
+export declare function isMcpAppResourceUri(uri: string): boolean;
+export declare function getMcpAppToolMeta(tool: Pick<McpToolDescriptor, "_meta">): McpAppToolMeta | undefined;
+export declare function isMcpToolVisibleToModel(tool: Pick<McpToolDescriptor, "_meta">): boolean;
+export declare function isMcpToolVisibleToApp(tool: Pick<McpToolDescriptor, "_meta">): boolean;

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

@@ -9,6 +9,7 @@ export interface DefaultMcpServerClientFactoryOptions {
     fetch?: FetchLike;
     /** Keep literal configured headers on the declared MCP origin only. */
     restrictConfiguredHeadersToOrigin?: boolean;
+    mcpApps?: boolean;
 }
 export interface ProbeMcpServerConnectionOptions extends Omit<DefaultMcpServerClientFactoryOptions, "settingsPath"> {
     serverName: string;

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

@@ -1,3 +1,5 @@
+export type { McpAppToolMeta, McpAppToolVisibility } from "./apps";
+export { createMcpAppsClientCapabilities, getMcpAppToolMeta, isMcpAppResourceUri, isMcpToolVisibleToApp, isMcpToolVisibleToModel, MCP_APP_MIME_TYPE, MCP_APPS_EXTENSION_ID, } from "./apps";
 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";
@@ -9,6 +11,8 @@ export type { PluginMcpServerResolution } from "./plugin-server-registration";
 export { normalizePluginMcpServerRegistration, resolvePluginMcpServerRegistrations, } from "./plugin-server-registration";
 export type { CreateDisabledMcpToolPoliciesOptions, CreateDisabledMcpToolPolicyOptions, } from "./policies";
 export { createDisabledMcpToolPolicies, createDisabledMcpToolPolicy, } from "./policies";
+export type { CreateMcpAppsRuntimeOptions, McpAppResourceReadRequest, McpAppsRuntime, McpAppToolBinding, McpAppToolCallRequest, } from "./session-apps";
+export { createMcpAppsRuntime } from "./session-apps";
 export { augmentMcpTimeoutError } from "./timeout";
 export { createMcpTools } from "./tools";
-export type { CreateMcpToolsOptions, McpConnectionStatus, McpManager, McpManagerOptions, McpServerClient, McpServerClientFactory, McpServerOAuthClientConfig, McpServerOAuthState, McpServerOAuthStatus, McpServerRegistration, McpServerSnapshot, McpServerTransportConfig, McpSseTransportConfig, McpStdioTransportConfig, McpStreamableHttpTransportConfig, McpToolCallRequest, McpToolCallResult, McpToolDescriptor, McpToolNameTransform, McpToolProvider, } from "./types";
+export type { CreateMcpToolsOptions, McpConnectionStatus, McpManager, McpManagerOptions, McpResourceContents, McpResourceReadRequest, McpResourceReadResult, McpServerClient, McpServerClientFactory, McpServerOAuthClientConfig, McpServerOAuthState, McpServerOAuthStatus, McpServerRegistration, McpServerSnapshot, McpServerTransportConfig, McpSseTransportConfig, McpStdioTransportConfig, McpStreamableHttpTransportConfig, McpToolCallRequest, McpToolCallResult, McpToolDescriptor, McpToolNameTransform, McpToolProvider, } from "./types";

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

@@ -1,4 +1,4 @@
-import type { McpManager, McpManagerOptions, McpServerRegistration, McpServerSnapshot, McpToolCallRequest, McpToolCallResult, McpToolDescriptor } from "./types";
+import type { McpManager, McpManagerOptions, McpResourceReadRequest, McpResourceReadResult, McpServerRegistration, McpServerSnapshot, McpToolCallRequest, McpToolCallResult, McpToolDescriptor } from "./types";
 export declare class InMemoryMcpManager implements McpManager {
     private readonly toolsCacheTtlMs;
     private readonly clientFactory;
@@ -14,6 +14,7 @@ export declare class InMemoryMcpManager implements McpManager {
     listTools(serverName: string): Promise<readonly McpToolDescriptor[]>;
     refreshTools(serverName: string): Promise<readonly McpToolDescriptor[]>;
     callTool(request: McpToolCallRequest): Promise<McpToolCallResult>;
+    readResource(request: McpResourceReadRequest): Promise<McpResourceReadResult>;
     dispose(): Promise<void>;
     private ensureConnectedClient;
     private connectState;

package/dist/extensions/mcp/session-apps.d.ts

@@ -0,0 +1,28 @@
+import type { McpManager, McpResourceReadResult, McpToolCallResult, McpToolDescriptor, McpToolNameTransform } from "./types";
+export interface McpAppToolBinding {
+    serverName: string;
+    toolName: string;
+    resourceUri: string;
+}
+export interface McpAppResourceReadRequest {
+    serverName: string;
+    uri: string;
+}
+export interface McpAppToolCallRequest {
+    serverName: string;
+    toolName: string;
+    arguments?: Record<string, unknown>;
+}
+export interface McpAppsRuntime {
+    resolveTool(agentToolName: string): Promise<McpAppToolBinding | undefined>;
+    readResource(request: McpAppResourceReadRequest): Promise<McpResourceReadResult>;
+    callTool(request: McpAppToolCallRequest): Promise<McpToolCallResult>;
+}
+export interface CreateMcpAppsRuntimeOptions {
+    manager: Pick<McpManager, "listTools" | "callTool" | "readResource">;
+    serverNames: readonly string[];
+    agentTools: ReadonlyMap<string, readonly McpToolDescriptor[]>;
+    nameTransform?: McpToolNameTransform;
+    isToolEnabled?: (agentToolName: string) => boolean;
+}
+export declare function createMcpAppsRuntime(options: CreateMcpAppsRuntimeOptions): McpAppsRuntime;

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

@@ -3,6 +3,7 @@ export interface McpToolDescriptor {
     name: string;
     description?: string;
     inputSchema: Record<string, unknown>;
+    _meta?: Record<string, unknown>;
 }
 export interface McpToolCallRequest {
     serverName: string;
@@ -11,6 +12,22 @@ export interface McpToolCallRequest {
     context?: AgentToolContext;
 }
 export type McpToolCallResult = unknown;
+export interface McpResourceReadRequest {
+    serverName: string;
+    uri: string;
+    context?: AgentToolContext;
+}
+export interface McpResourceContents {
+    uri: string;
+    mimeType?: string;
+    text?: string;
+    blob?: string;
+    _meta?: Record<string, unknown>;
+}
+export interface McpResourceReadResult {
+    contents: McpResourceContents[];
+    _meta?: Record<string, unknown>;
+}
 export interface McpToolProvider {
     listTools(serverName: string): Promise<readonly McpToolDescriptor[]>;
     callTool(request: McpToolCallRequest): Promise<McpToolCallResult>;
@@ -95,6 +112,10 @@ export interface McpServerClient {
         arguments?: Record<string, unknown>;
         context?: AgentToolContext;
     }): Promise<McpToolCallResult>;
+    readResource?(request: {
+        uri: string;
+        context?: AgentToolContext;
+    }): Promise<McpResourceReadResult>;
 }
 export type McpServerClientFactory = (registration: McpServerRegistration) => Promise<McpServerClient> | McpServerClient;
 export interface McpServerOAuthStatus {
@@ -123,5 +144,6 @@ export interface McpManager extends McpToolProvider {
     listServers(): readonly McpServerSnapshot[];
     refreshTools(serverName: string): Promise<readonly McpToolDescriptor[]>;
     callTool(request: McpToolCallRequest): Promise<McpToolCallResult>;
+    readResource?(request: McpResourceReadRequest): Promise<McpResourceReadResult>;
     dispose(): Promise<void>;
 }

package/dist/extensions/plugin/plugin-command-origin.d.ts

@@ -0,0 +1,8 @@
+import type { AgentExtensionCommand } from "@cline/shared";
+/** Record a command registered by a loaded plugin, from either execution mode. */
+export declare function markPluginCommand(command: AgentExtensionCommand): AgentExtensionCommand;
+/**
+ * Whether a registered command came from a loaded plugin. Session registries
+ * also hold built-in skill and workflow commands, which are not plugin commands.
+ */
+export declare function isPluginCommand(command: AgentExtensionCommand): boolean;

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

@@ -1,5 +1,6 @@
 import type { AgentExtension, BasicLogger, PluginPolicies, PluginSetupContext, PluginStatusRecord, SessionPluginIssue } from "@cline/shared";
 import type { PluginInitializationFailure, PluginInitializationWarning } from "./plugin-load-report";
+export { isPluginCommand } from "./plugin-command-origin";
 import type { PluginTargeting } from "./plugin-targeting";
 export declare const DEFAULT_PLUGIN_IMPORT_TIMEOUT_MS = 4000;
 export declare const DEFAULT_PLUGIN_SETUP_TIMEOUT_MS = 4000;

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

@@ -0,0 +1,7 @@
+import type { SubprocessSandboxLauncher } from "../../runtime/tools/subprocess-sandbox";
+export declare const CLINE_PLUGIN_RUNTIME_DIR_ENV = "CLINE_PLUGIN_RUNTIME_DIR";
+/** Core owns the bootstrap and SDK as one artifact for every host and transport. */
+export declare function resolvePluginRuntimeDirectory(): string | undefined;
+/** Let a compiled host launch plugin children with its embedded filesystem mounted. */
+export declare function setPluginSandboxLauncher(launcher: SubprocessSandboxLauncher | undefined): void;
+export declare function getPluginSandboxLauncher(): SubprocessSandboxLauncher | undefined;

package/dist/hub/client/index.d.ts

@@ -1,6 +1,8 @@
 import { type HubClientRegistration, type HubCommandEnvelope, type HubEventEnvelope, type HubReplyEnvelope } from "@cline/shared";
 import { type HubOwnerContext } from "../discovery";
 type HubCommandOptions = {
+    /** Whether transport recovery may resend a request after dispatch. */
+    retryAfterDispatch?: boolean;
     timeoutMs?: number | null;
     /** Synchronous local guard, checked after connection before each dispatch. */
     beforeDispatch?: () => void;
@@ -121,6 +123,10 @@ export interface HubSessionActivity {
     activeSessionCount: number;
     /** Distinct client ids attached to those sessions. */
     participantClientCount: number;
+    /** Plugin command requests executing even without an attached session. */
+    activePluginRequests: number;
+    /** Cloud session commands, such as provisioning, executing in the hub. */
+    activeCloudCommands: number;
 }
 /**
  * Summarize live activity from a `session.list` payload. A session counts as

package/dist/hub/client/managed-hub-build-watcher.d.ts

@@ -25,6 +25,8 @@ export interface ManagedHubBuildMismatchEvent {
     activeSessionCount?: number;
     /** Distinct clients attached to those sessions (best-effort, `outdated_hub` only). */
     participantClientCount?: number;
+    /** Active plugin commands or catalog requests on the running Hub. */
+    activePluginRequests?: number;
 }
 /**
  * Probe the managed local Hub once and report whether a live Hub is running

package/dist/hub/client/plugin-commands.d.ts

@@ -0,0 +1,4 @@
+import type { PluginCommandsApi } from "../../services/plugin-command-api";
+import { type NodeHubClient } from "./index";
+/** Uses the caller's existing connection. */
+export declare function createHubPluginCommandsApi(client: Pick<NodeHubClient, "command">): PluginCommandsApi;

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

@@ -1,6 +1,7 @@
 import type * as LlmsProviders from "@cline/llms";
 import type { AgendaAutomationPolicy, AgendaTaskListInput, AgendaTaskRecord, AgendaTaskRunRecord, ChatRunTurnRequest, ChatStartSessionRequest, ChatStartSessionResponse, ChatTurnResult, HubSessionSearchHit, HubTaskCreateInput, HubTaskUpdateInput, TeamProgressProjectionEvent } from "@cline/shared";
 import type { CheckpointEntry } from "../../hooks/checkpoint-hooks";
+import type { PluginCommandsApi } from "../../services/plugin-command-api";
 type ScheduleClientRecord = Record<string, unknown> & {
     metadata?: Record<string, unknown>;
 };
@@ -57,6 +58,7 @@ export interface HubTeamProgressHandlers {
 }
 export declare class HubSessionClient {
     private readonly client;
+    readonly pluginCommands: PluginCommandsApi;
     constructor(options: HubSessionClientOptions);
     connect(): Promise<void>;
     private taskCommand;