@cline/core 0.0.95 → 0.2.0-nightly.1793312794

package/dist/ClineCore.d.ts

@@ -1,6 +1,7 @@
 import type { ClineCoreAutomationApi, ClineCoreListHistoryOptions, ClineCoreOptions, ClineCoreSettingsApi, ClineCoreStartInput, CompareCheckpointInput, CompareCheckpointResult, RestoreInput, RestoreResult } from "./cline-core/types";
-import type { PendingPromptsServiceApi, RuntimeHost, RuntimeHostSubscribeOptions, SessionConnectionRuntimeService, SessionModelRuntimeService, SessionUsageRuntimeService, StartSessionInput, StartSessionResult } from "./runtime/host/runtime-host";
+import type { McpAppsRuntimeService, PendingPromptsServiceApi, RuntimeHost, RuntimeHostSubscribeOptions, SessionConnectionRuntimeService, SessionModelRuntimeService, SessionUsageRuntimeService, StartSessionInput, StartSessionResult } from "./runtime/host/runtime-host";
 import { FeatureFlagsService } from "./services/feature-flags";
+import type { PluginCommandsApi } from "./services/plugin-command-api";
 import { type SessionDisplayMessage } from "./session/display-messages";
 import type { CoreSessionEvent } from "./types/events";
 import type { SessionHistoryRecord } from "./types/sessions";
@@ -21,6 +22,7 @@ export declare class ClineCore {
     readonly runtimeAddress: string | undefined;
     readonly automation: ClineCoreAutomationApi;
     readonly settings: ClineCoreSettingsApi;
+    readonly pluginCommands: PluginCommandsApi;
     readonly featureFlags: FeatureFlagsService;
     readonly pendingPrompts: PendingPromptsServiceApi;
     private readonly host;
@@ -327,4 +329,7 @@ export declare class ClineCore {
      * an active session.
      */
     updateSessionConnection: SessionConnectionRuntimeService["updateSessionConnection"];
+    resolveMcpAppTool: McpAppsRuntimeService["resolveMcpAppTool"];
+    readMcpAppResource: McpAppsRuntimeService["readMcpAppResource"];
+    callMcpAppTool: McpAppsRuntimeService["callMcpAppTool"];
 }

package/dist/account/rpc.d.ts

@@ -1,5 +1,5 @@
 import type { ClineAccountActionRequest, ProviderActionRequest } from "@cline/shared";
-import type { ClineAccountBalance, ClineAccountOrganization, ClineAccountOrganizationBalance, ClineAccountOrganizationUsageTransaction, ClineAccountPaymentTransaction, ClineAccountUsageTransaction, ClineAccountUser, FeaturebaseTokenResponse } from "./types";
+import type { ClineAccountBalance, ClineAccountOrganization, ClineAccountOrganizationBalance, ClineAccountOrganizationUsageTransaction, ClineAccountPaymentTransaction, ClineAccountUsageTransaction, ClineAccountUser, FeaturebaseTokenResponse, UserCurrentPlan } from "./types";
 export interface ClineAccountOperations {
     fetchMe(): Promise<ClineAccountUser>;
     fetchBalance(userId?: string): Promise<ClineAccountBalance>;
@@ -13,6 +13,7 @@ export interface ClineAccountOperations {
     }): Promise<ClineAccountOrganizationUsageTransaction[]>;
     switchAccount(organizationId?: string | null): Promise<void>;
     fetchFeaturebaseToken?(): Promise<FeaturebaseTokenResponse | undefined>;
+    fetchCurrentUserPlan?(): Promise<UserCurrentPlan | undefined>;
 }
 export declare function isClineAccountActionRequest(request: ProviderActionRequest): request is ClineAccountActionRequest;
 export declare function executeClineAccountAction(request: ClineAccountActionRequest, service: ClineAccountOperations): Promise<unknown>;
@@ -36,5 +37,6 @@ export declare class RpcClineAccountService implements ClineAccountOperations {
     }): Promise<ClineAccountOrganizationUsageTransaction[]>;
     switchAccount(organizationId?: string | null): Promise<void>;
     fetchFeaturebaseToken(): Promise<FeaturebaseTokenResponse | undefined>;
+    fetchCurrentUserPlan(): Promise<UserCurrentPlan | undefined>;
     private request;
 }

package/dist/account/types.d.ts

@@ -13,6 +13,8 @@ export interface ClineAccountUser {
     createdAt: string;
     updatedAt: string;
     organizations: ClineAccountOrganization[];
+    /** Web app path where the user manages data use and Cline Bench preferences. */
+    dataPrivacyPath?: string;
 }
 export interface UserRemoteConfigOrganization {
     organizationId: string;

package/dist/artifacts/cloud/fetch.d.ts

@@ -0,0 +1,8 @@
+import type { ConnectorsRequest } from "../../extensions/composio/composio-meta-tools";
+export declare function createArtifactFetcher({ request, cloudSessionId, }: {
+    request: ConnectorsRequest;
+    cloudSessionId: string;
+}): ({ artifactId, signal, }: {
+    artifactId: string;
+    signal?: AbortSignal;
+}) => Promise<Response>;

package/dist/artifacts/cloud/publish.d.ts

@@ -0,0 +1,6 @@
+import type { ConnectorsRequest } from "../../extensions/composio/composio-meta-tools";
+import { type ArtifactPublisher } from "../publish";
+export declare function createArtifactPublisher({ request, cloudSessionId, }: {
+    request: ConnectorsRequest;
+    cloudSessionId: string;
+}): ArtifactPublisher;

package/dist/artifacts/publish.d.ts

@@ -0,0 +1,30 @@
+export type ArtifactPublicationResult = {
+    path: string;
+    artifactId: string;
+} | {
+    path: string;
+    artifactId?: string;
+    error: {
+        code: string;
+        message: string;
+    };
+};
+export type ArtifactPublicationFile = {
+    path: string;
+    artifactId: string;
+    size: number;
+    modifiedAt: number;
+};
+export type ArtifactPublisher = (files: readonly ArtifactPublicationFile[], options: {
+    signal?: AbortSignal;
+}) => Promise<ArtifactPublicationResult[]>;
+export declare class ArtifactPublicationError extends Error {
+    code: string;
+    constructor(code: string, message: string);
+}
+export declare function publicationFailure(path: string, error: unknown, artifactId?: string, signal?: AbortSignal): ArtifactPublicationResult;
+export declare function createPublishArtifactsTool({ publish, }: {
+    publish: ArtifactPublisher;
+}): import("@cline/shared").AgentTool<unknown, {
+    files: ArtifactPublicationResult[];
+}>;

package/dist/cline-core/runtime-services.d.ts

@@ -1,5 +1,7 @@
-import type { PendingPromptsRuntimeService, PendingPromptsServiceApi, RuntimeHost, SessionConnectionRuntimeService, SessionModelRuntimeService, SessionUsageRuntimeService } from "../runtime/host/runtime-host";
+import type { McpAppsRuntimeService, PendingPromptsRuntimeService, PendingPromptsServiceApi, RuntimeHost, SessionConnectionRuntimeService, SessionModelRuntimeService, SessionUsageRuntimeService } from "../runtime/host/runtime-host";
+import type { PluginCommandsApi } from "../services/plugin-command-api";
 import { type ClineCoreSettingsApi } from "../settings";
-export type RuntimeHostServiceExtensions = RuntimeHost & Partial<PendingPromptsRuntimeService & SessionUsageRuntimeService & SessionConnectionRuntimeService & SessionModelRuntimeService>;
+export type RuntimeHostServiceExtensions = RuntimeHost & Partial<PendingPromptsRuntimeService & SessionUsageRuntimeService & SessionConnectionRuntimeService & SessionModelRuntimeService & McpAppsRuntimeService>;
 export declare function createClineCoreSettingsApi(host: RuntimeHost): ClineCoreSettingsApi;
 export declare function createClineCorePendingPromptsApi(host: RuntimeHost): PendingPromptsServiceApi;
+export declare function createClineCorePluginCommandsApi(host: RuntimeHost): PluginCommandsApi;

package/dist/cloud/computer-use-prompt.d.ts

@@ -0,0 +1,9 @@
+/** Lets local development enable cloud computer use without the rollout flag. */
+export declare const CLOUD_COMPUTER_USE_ENV = "CLINE_CLOUD_COMPUTER_USE";
+/**
+ * Screenshots only help a model that can see them. Models missing from the
+ * bundled catalog are treated as text-only so the section never reaches a
+ * model whose `read_files` would reject images.
+ */
+export declare function cloudModelSupportsImages(modelId: string): boolean;
+export declare const CLOUD_COMPUTER_USE_PROMPT = "## Verify your work visually\n\nThis sandbox may have a virtual display and standard Linux tools for computer use: Xvfb, xdotool, ImageMagick (`import`), wmctrl, and Chromium. Check with `command -v Xvfb xdotool import chromium` the first time you need them. If any are missing, skip visual verification and don't try to install them. To see a screenshot, call `read_files` on the image file.\n\n### When to verify\n\nUse your judgment. Verify when a change affects something a user sees or interacts with (a navbar style, a new dialog, a form flow, a terminal UI). Skip it when there's nothing to look at (a git operation, a config tweak, a refactor with no visible effect).\n\n### Display, input, and screenshots\n\n- Start the display if it isn't running: `Xvfb :99 -screen 0 1280x800x24 -nolisten tcp &`, and run every GUI command with `DISPLAY=:99` (for example `export DISPLAY=:99` at the start of the command). Keep the display as small as the check allows so screenshots stay legible. To check a phone layout, restart Xvfb at 390x844 and relaunch the app window at 0,0 with the same size.\n- Start the app (for example `bun run dev &`) and wait until it's serving.\n- Open web apps in a normal Chromium window so screenshots look like a real browser:\n  `chromium --new-window http://localhost:5173 --remote-debugging-port=9222 --window-position=0,0 --window-size=1280,800 --force-device-scale-factor=1 --user-data-dir=\"$(mktemp -d)\" --no-first-run --no-default-browser-check --disable-features=Translate --disable-gpu --no-sandbox &`\n  - `--remote-debugging-port=9222` exposes the Chrome DevTools Protocol, so you can inspect the DOM, console, and network when a screenshot alone doesn't explain a problem.\n  - A fixed position and size, plus `--force-device-scale-factor=1`, keep screenshot pixels equal to click coordinates.\n  - A fresh `--user-data-dir` and the first-run flags keep restore prompts and popups out of screenshots. `--disable-gpu` and `--no-sandbox` are needed in this container.\n- Drive the app with xdotool: `key`, `type --delay 40 --`, `mousemove X Y click 1` (buttons 4 and 5 scroll). Find the window with `xdotool search --sync --onlyvisible --class chromium | tail -1` and focus it with `xdotool windowfocus --sync <id>`.\n- Take screenshots of the whole display, for example `import -window root /tmp/cu-shots/03-filtered.png`, so every frame has the same size and framing. Wait about half a second after each action so the UI settles. To look closely at one area, crop a copy instead of capturing a region.\n- Take a fresh screenshot before every click and click in that screenshot's coordinates; layouts move. If a click misses, look again before retrying.\n- Move the pointer out of the way before screenshots you'll show the user, so hover states don't leak in.\n\nExample of a loop that works well:\n\n```bash\nexport DISPLAY=:99\nmkdir -p /tmp/cu-shots\nWID=$(xdotool search --sync --onlyvisible --class chromium | tail -1)\nxdotool windowfocus --sync \"$WID\"\nxdotool key ctrl+k && sleep 0.5 && import -window root /tmp/cu-shots/01-palette.png\nxdotool type --delay 40 -- \"over\" && sleep 0.5 && import -window root /tmp/cu-shots/02-search.png\nxdotool mousemove 640 228 click 1 && sleep 0.5 && import -window root /tmp/cu-shots/03-filtered.png\n```\n\n### What to check\n\n- Check the states that usually break: empty, loading, error, long content, dark mode, and a narrow viewport.\n- If something looks wrong, fix it, reload, and check again.\n- Read only the screenshots you need; each one costs context (about 1.4k tokens at 1280x800).\n- Never close the window you're testing, and never put secrets (tokens, passwords, `.env` contents) on screen.\n\n### Show the user what you verified\n\nThe user can't see this sandbox, and its files disappear when it stops. When you've verified something, publish the few screenshots that prove it with the `publish_artifacts` tool, which uploads them to this session so the user can open them. Pass absolute paths, for example `{\"files\": [{\"path\": \"/tmp/cu-shots/01-palette.png\"}, {\"path\": \"/tmp/cu-shots/03-filtered.png\"}]}`.\n\n- Publish frames for the reader, not a log of every input: usually 1 to 8 per thing you verified, in the order that tells the story (at most 20 per call).\n- The tool reports an `artifactId` or an `error` for each file. To retry a failed file, pass the same `artifactId` back. If publishing fails or the tool isn't available, say so in your answer and carry on.\n- In your answer, say what each published screenshot shows, in order, and call out anything you couldn't fix.";

package/dist/cloud/controller.d.ts

@@ -3,10 +3,17 @@ import { NodeHubClient } from "../hub/client/index";
 import { type CloudSessionApi, CloudSessionError, type CloudSessionRecord, type CreateCloudSessionInput } from "./api";
 import { type CloudModel } from "./models";
 import type { CloudBranchListOptions, CloudBranchListResult, CloudRepositoryListResult } from "./repositories";
-import type { CloudCreationOptions, CloudHandoffSeed, CloudSessionAttachment, CloudSessionEvent, CloudSessionSnapshot, CloudSessionState, JsonRecord } from "./types";
+import type { CloudCreationOptions, CloudHandoffSeed, CloudSendLifecycle, CloudSessionAttachment, CloudSessionEvent, CloudSessionSnapshot, CloudSessionState, JsonRecord } from "./types";
+type CloudSendFailure = {
+    dispatched: boolean;
+    message: string;
+    detail?: string;
+};
 export declare const CLOUD_SESSION_SYSTEM_PROMPT: string;
 /** The prompt a new cloud task starts with: GitHub access plus its work-branch rules. */
-export declare function buildCloudSessionSystemPrompt(record: Pick<CloudSessionRecord, "id" | "sandboxType" | "metadata">): string;
+export declare function buildCloudSessionSystemPrompt(record: Pick<CloudSessionRecord, "id" | "sandboxType" | "metadata">, options?: {
+    computerUse?: boolean;
+}): string;
 /** The seed command was not dispatched; the host may clear its seed marker. */
 export declare class CloudHandoffSeedRejectedError extends Error {
     constructor(cause: unknown);
@@ -31,6 +38,8 @@ export type CloudSessionControllerOptions = {
     lateCreateDisposition?: "preserve" | "delete";
     /** Host-owned first-task policy survives controller replacement; established tasks never qualify. */
     pendingInitialTasks?: Map<string, CloudCreationOptions>;
+    /** Rollout gate for the computer-use prompt section; omitted means off. */
+    isComputerUseEnabled?: () => Promise<boolean>;
     api: Pick<CloudSessionApi, "create" | "resume" | "delete" | "list" | "status" | "waitUntilReady" | "history" | "updateTitle" | "listRepositories" | "listBranches">;
     getAuthToken: () => Promise<string | undefined>;
     apiBaseUrl: string;
@@ -58,9 +67,11 @@ export declare class CloudSessionController {
     private readonly unlistedSessions;
     private readonly pendingInitialTasks;
     private lastListedSessions;
+    private lastListedOrganizationId?;
     private discoveryRefresh?;
     private readonly unconfirmedInnerCreates;
     private readonly createRequests;
+    private readonly initialSends;
     private readonly provisioningControllers;
     private readonly sendAbortTokens;
     private readonly titleWrites;
@@ -90,8 +101,10 @@ export declare class CloudSessionController {
     /** Revalidates a cached row by id when the active-scope list does not include it. */
     getCrossScopeDiscoveryRecord(sessionId: string): Promise<JsonRecord | undefined>;
     list(): Promise<CloudSessionRecord[]>;
+    private listInOrganization;
     handoffTargetExists(sessionId: string): Promise<boolean>;
     private preserveConnectedRuntimeModel;
+    refreshOrganization(): Promise<void>;
     private resolveActiveOrganizationId;
     listRepositories(): Promise<CloudRepositoryListResult>;
     listModels(): Promise<CloudModel[]>;
@@ -103,7 +116,15 @@ export declare class CloudSessionController {
     listForDiscovery(options?: {
         timeoutMs?: number;
     }): Promise<JsonRecord[]>;
-    create(input: CreateCloudSessionInput): Promise<CloudSessionAttachment>;
+    create(input: CreateCloudSessionInput & {
+        initialMessage?: {
+            text: string;
+            images?: string[];
+        };
+    }): Promise<CloudSessionAttachment & {
+        initialSend?: Awaited<ReturnType<CloudSessionController["send"]>> | CloudSendFailure;
+    }>;
+    private createSession;
     private trackProvisioningController;
     private abortProvisioningControllers;
     /** Waits for an adopted pending handoff target before opening its Hub proxy. */
@@ -118,7 +139,7 @@ export declare class CloudSessionController {
     private createOnce;
     private deleteProvisionedSessionAfterDispose;
     attach(outerSessionId: string, creationOptions?: CloudCreationOptions): Promise<CloudSessionAttachment>;
-    send(outerSessionId: string, prompt: string, requestedDelivery?: "queue" | "steer", modelId?: string, userImages?: string[]): Promise<{
+    send(outerSessionId: string, prompt: string, requestedDelivery?: "queue" | "steer", modelId?: string, userImages?: string[], lifecycle?: CloudSendLifecycle): Promise<{
         sessionId: string;
         ok: true;
         queued?: boolean;
@@ -157,6 +178,7 @@ export declare class CloudSessionController {
     private assertHandoffConnectionReusable;
     private createInnerSession;
     private adoptExistingHandoffSession;
+    private resolveComputerUse;
     private createInnerSessionOnce;
     private handleEvent;
     private forwardEvent;

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

@@ -0,0 +1,53 @@
+import type { NodeHubClient } from "../hub/client";
+import { type CloudSessionRecord } from "./api";
+import type { CloudHubArgs, CloudHubOperation, CloudHubResult, CloudHubScope } from "./hub-protocol";
+import type { CloudSessionEvent, CloudSessionSnapshot, JsonRecord } from "./types";
+export type CloudHubConnection = Pick<NodeHubClient, "command" | "subscribe">;
+/** Transport facade for a hub-owned cloud controller. Disposing only releases this viewer. */
+export declare class HubCloudSessionClient {
+    private readonly getConnection;
+    private readonly snapshots;
+    private readonly records;
+    private readonly listeners;
+    private unsubscribe?;
+    private connection?;
+    private disposed;
+    private serviceId?;
+    private scopeGeneration;
+    private revision;
+    private readonly sessionRevisions;
+    constructor(getConnection: () => Promise<CloudHubConnection>);
+    private ready;
+    connect(): Promise<void>;
+    get scope(): CloudHubScope | undefined;
+    private recover;
+    private acceptVersion;
+    private checkReply;
+    private receive;
+    subscribe(listener: (event: CloudSessionEvent) => void): () => void;
+    protected call<K extends CloudHubOperation>(operation: K, args: CloudHubArgs<K>, expectedScope?: CloudHubScope): Promise<CloudHubResult<K>>;
+    create(input: CloudHubArgs<"create">[0], scope?: CloudHubScope): Promise<CloudHubResult<"create">>;
+    attach(...args: CloudHubArgs<"attach">): Promise<CloudHubResult<"attach">>;
+    send(...args: CloudHubArgs<"send">): Promise<CloudHubResult<"send">>;
+    prepareHandoffRepository(repoUrl: string, scope?: CloudHubScope): Promise<CloudHubResult<"prepareHandoffRepository">>;
+    refreshOrganization(): Promise<void>;
+    abort(...args: CloudHubArgs<"abort">): Promise<CloudHubResult<"abort">>;
+    pendingPrompts(...args: CloudHubArgs<"pendingPrompts">): Promise<CloudHubResult<"pendingPrompts">>;
+    updatePendingPrompt(...args: CloudHubArgs<"updatePendingPrompt">): Promise<CloudHubResult<"updatePendingPrompt">>;
+    removePendingPrompt(...args: CloudHubArgs<"removePendingPrompt">): Promise<CloudHubResult<"removePendingPrompt">>;
+    readMessages(...args: CloudHubArgs<"readMessages">): Promise<CloudHubResult<"readMessages">>;
+    updateTitle(...args: CloudHubArgs<"updateTitle">): Promise<CloudHubResult<"updateTitle">>;
+    delete(...args: CloudHubArgs<"delete">): Promise<CloudHubResult<"delete">>;
+    listModels(scope?: CloudHubScope): Promise<CloudHubResult<"listModels">>;
+    listRepositories(...args: CloudHubArgs<"listRepositories">): Promise<CloudHubResult<"listRepositories">>;
+    listBranches(...args: CloudHubArgs<"listBranches">): Promise<CloudHubResult<"listBranches">>;
+    respondApproval(...args: CloudHubArgs<"respondApproval">): Promise<CloudHubResult<"respondApproval">>;
+    restoreCreationOptions(...args: CloudHubArgs<"restoreCreationOptions">): Promise<CloudHubResult<"restoreCreationOptions">>;
+    getCrossScopeDiscoveryRecord(...args: CloudHubArgs<"getCrossScopeDiscoveryRecord">): Promise<CloudHubResult<"getCrossScopeDiscoveryRecord">>;
+    list(): Promise<CloudSessionRecord[]>;
+    listForDiscovery(...args: CloudHubArgs<"listForDiscovery">): Promise<JsonRecord[]>;
+    getCachedDiscoveryRecord(sessionId: string): JsonRecord | undefined;
+    getSnapshot(sessionId: string): CloudSessionSnapshot | undefined;
+    isCloudSession(sessionId: string): boolean;
+    dispose(): Promise<void>;
+}

package/dist/cloud/hub-protocol.d.ts

@@ -0,0 +1,32 @@
+import type { HandoffGitPublication } from "../services/cloud-handoff/git-preparation";
+import type { CloudSessionController } from "./controller";
+/** Operations available to cloud UI clients. Lifecycle callbacks remain host-local. */
+export declare const CLOUD_HUB_OPERATIONS: readonly ["create", "attach", "send", "abort", "pendingPrompts", "updatePendingPrompt", "removePendingPrompt", "readMessages", "updateTitle", "delete", "list", "listForDiscovery", "getCrossScopeDiscoveryRecord", "listModels", "listRepositories", "listBranches", "respondApproval", "restoreCreationOptions", "refreshOrganization", "prepareHandoffRepository"];
+export type CloudHubScope = {
+    serviceId: string;
+    scopeGeneration: number;
+    expectedAccountId?: string;
+};
+export type CloudHubOperation = (typeof CLOUD_HUB_OPERATIONS)[number];
+export type CloudHubMethods = Pick<CloudSessionController, CloudHubOperation>;
+type CloudCreateInput = Omit<Parameters<CloudSessionController["create"]>[0], "handoff">;
+export type CloudHubCreateInput = CloudCreateInput & ({
+    localGit?: never;
+} | {
+    localGit: HandoffGitPublication;
+    organizationId: string | null;
+    requestId: string;
+    initialMessage: {
+        text: string;
+        images?: string[];
+    };
+});
+export type CloudHubArgs<K extends CloudHubOperation> = K extends "create" ? [input: CloudHubCreateInput] : K extends "send" ? [
+    sessionId: string,
+    prompt: string,
+    delivery?: "queue" | "steer",
+    modelId?: string,
+    images?: string[]
+] : Parameters<CloudHubMethods[K]>;
+export type CloudHubResult<K extends CloudHubOperation> = Awaited<ReturnType<CloudHubMethods[K]>>;
+export {};

package/dist/cloud/index.d.ts

@@ -1,7 +1,12 @@
 /** Experimental cloud execution client. No local runtime or tool execution is initialized. */
+export { createArtifactFetcher } from "../artifacts/cloud/fetch";
+export { createArtifactPublisher } from "../artifacts/cloud/publish";
 export * from "../services/cloud-handoff";
+export { type HandoffGitPlan, type HandoffGitPreview, inspectHandoffGit, previewHandoffGit, } from "../services/cloud-handoff/git-preparation";
 export * from "./api";
 export * from "./controller";
+export * from "./hub-client";
+export * from "./hub-protocol";
 export * from "./models";
 export * from "./repositories";
 export * from "./snapshots";