@cline/core 0.0.86 → 0.0.87

package/dist/cloud/api.d.ts

@@ -1,8 +1,10 @@
+import { type AgentMode, type MessageWithMetadata } from "@cline/shared";
 import type { CloudBranchListOptions, CloudBranchListResult, CloudRepositoryListResult } from "./repositories";
 type FetchLike = (input: string | URL | Request, init?: RequestInit) => Promise<Response>;
 export type CloudSessionRecord = {
     id: string;
     status: string;
+    sandboxType?: "standard" | "resumable";
     title?: string;
     sandboxUrl: string;
     repoContext: {
@@ -10,11 +12,13 @@ export type CloudSessionRecord = {
         branch?: string;
     };
     metadata: {
+        sandboxType?: "standard" | "resumable";
         modelId?: string;
         taskId?: string;
         statusReason?: string;
         provisioningPhase?: CloudProvisioningPhase;
         createRequestTitle?: string;
+        cwd?: string;
     };
     expiredAt?: string | null;
     lastActivityAt?: string;
@@ -24,6 +28,7 @@ export type CloudSessionRecord = {
 export type CloudProvisioningPhase = "provisioning" | "cloning_repo" | "agent_starting" | "ready" | "failed";
 export declare function deriveCloudSessionTitle(prompt: string): string;
 export type CreateCloudSessionInput = {
+    sandboxType?: "standard" | "resumable";
     /** Stable client-planned id for single-flighting one chat's start request. */
     requestId?: string;
     modelId: string;
@@ -33,18 +38,32 @@ export type CreateCloudSessionInput = {
     autoApproveTools?: boolean;
     thinking?: boolean;
     reasoningEffort?: "low" | "medium" | "high" | "xhigh";
-    /** Omit for a personal session; otherwise scopes billing to this org. */
-    organizationId?: string;
+    mode?: AgentMode;
+    workspaceRelativePath?: string;
+    /** Null explicitly selects Personal; controllers resolve an omitted scope. */
+    organizationId?: string | null;
+    /** Host persistence hooks; never serialized into the provisioning request. */
+    handoff?: {
+        sourceSessionId: string;
+        resolveMessages: () => Promise<MessageWithMetadata[]>;
+        /** Persist dispatch intent after successful recovery lookup, before POST. */
+        onCreating: () => void | Promise<void>;
+        onOuterSessionCreated: (sessionId: string, context?: {
+            created: boolean;
+        }) => Promise<void>;
+        onOuterSessionRemoved?: (sessionId: string) => Promise<void>;
+        onSeeding?: () => void | Promise<void>;
+    };
 };
 export type { CloudBranchListOptions, CloudBranchListResult, CloudRepositoryListResult, CloudRepositoryOption, } from "./repositories";
-type CloudSessionApiOptions = {
+export type CloudSessionApiOptions = {
     apiBaseUrl: string;
     appBaseUrl: string;
     getAuthToken: () => Promise<string | undefined>;
     fetch?: FetchLike;
     createTimeoutMs?: number;
 };
-type CloudErrorCode = "authentication_required" | "github_not_connected" | "session_not_found" | "session_expired" | "session_failed" | "request_failed";
+export type CloudErrorCode = "authentication_required" | "github_not_connected" | "session_not_found" | "session_expired" | "session_failed" | "request_failed";
 export declare class CloudSessionError extends Error {
     readonly code: CloudErrorCode;
     readonly detail: string;
@@ -55,6 +74,11 @@ export declare class CloudSessionError extends Error {
     /** HTTP status of the failed request, when one was received. */
     status?: number | undefined);
 }
+/** The fresh handoff POST definitely did not create a workspace. Marker/list
+ * failures and ambiguous transport outcomes deliberately never use this type. */
+export declare class CloudHandoffCreationRejectedError extends Error {
+    constructor(cause: unknown);
+}
 export declare function parseCloudProvisioningPhase(value: unknown): CloudProvisioningPhase | undefined;
 export declare class CloudSessionApi {
     private readonly options;
@@ -62,9 +86,10 @@ export declare class CloudSessionApi {
     private readonly appBaseUrl;
     private readonly fetchImpl;
     private readonly createTimeoutMs;
+    private readonly unconfirmedHandoffCreates;
+    private readonly completedHandoffCreates;
     constructor(options: CloudSessionApiOptions);
     private request;
-    private refreshCreationAuth;
     list(organizationId?: string): Promise<CloudSessionRecord[]>;
     private listWithToken;
     listRepositories(organizationId?: string): Promise<CloudRepositoryListResult>;
@@ -84,9 +109,11 @@ export declare class CloudSessionApi {
         sandboxUrl: string;
         cleanupAuthToken: string;
     }>;
+    private persistHandoffOuterSession;
     waitUntilReady(sessionId: string, signal: AbortSignal, onStatus?: (status: {
         phase?: CloudProvisioningPhase;
     }) => void): Promise<void>;
+    resume(sessionId: string, signal?: AbortSignal): Promise<CloudSessionRecord>;
     delete(sessionId: string, authToken?: string): Promise<void>;
     private deleteWithAuth;
     updateTitle(sessionId: string, title: string): Promise<CloudSessionRecord>;

package/dist/cloud/controller.d.ts

@@ -1,11 +1,20 @@
-import type { BasicLogger, ToolApprovalResult } from "@cline/shared";
+import type { BasicLogger, MessageWithMetadata, ToolApprovalResult } from "@cline/shared";
 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, CloudSessionAttachment, CloudSessionEvent, CloudSessionSnapshot, CloudSessionState, JsonRecord } from "./types";
+import type { CloudCreationOptions, CloudHandoffSeed, CloudSessionAttachment, CloudSessionEvent, CloudSessionSnapshot, CloudSessionState, JsonRecord } from "./types";
+/** The seed command was not dispatched; the host may clear its seed marker. */
+export declare class CloudHandoffSeedRejectedError extends Error {
+    constructor(cause: unknown);
+}
+/** A queued prompt may have been accepted even when recovery also fails. */
 export declare class CloudQueueUnconfirmedError extends CloudSessionError {
     constructor();
 }
+export declare class CloudHandoffSeedUnsupportedError extends Error {
+    constructor();
+}
 type CloudHubClient = Pick<NodeHubClient, "command" | "connect" | "dispose" | "getClientId" | "subscribe">;
 export type CloudSessionControllerOptions = {
     logger?: BasicLogger;
@@ -19,7 +28,7 @@ export type CloudSessionControllerOptions = {
     lateCreateDisposition?: "preserve" | "delete";
     /** Host-owned first-task policy survives controller replacement; established tasks never qualify. */
     pendingInitialTasks?: Map<string, CloudCreationOptions>;
-    api: Pick<CloudSessionApi, "create" | "delete" | "list" | "status" | "waitUntilReady" | "history" | "updateTitle" | "listRepositories" | "listBranches">;
+    api: Pick<CloudSessionApi, "create" | "resume" | "delete" | "list" | "status" | "waitUntilReady" | "history" | "updateTitle" | "listRepositories" | "listBranches">;
     getAuthToken: () => Promise<string | undefined>;
     apiBaseUrl: string;
     getActiveOrganizationId?: (options?: {
@@ -47,6 +56,7 @@ export declare class CloudSessionController {
     private readonly pendingInitialTasks;
     private lastListedSessions;
     private discoveryRefresh?;
+    private readonly unconfirmedInnerCreates;
     private readonly createRequests;
     private readonly provisioningControllers;
     private readonly sendAbortTokens;
@@ -77,9 +87,15 @@ 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[]>;
+    handoffTargetExists(sessionId: string): Promise<boolean>;
     private preserveConnectedRuntimeModel;
     private resolveActiveOrganizationId;
     listRepositories(): Promise<CloudRepositoryListResult>;
+    listModels(): Promise<CloudModel[]>;
+    /** Validates account auth and GitHub access before provisioning a handoff. */
+    prepareHandoffRepository(repoUrl: string): Promise<{
+        organizationId?: string;
+    }>;
     listBranches(repositoryId: number, options?: CloudBranchListOptions): Promise<CloudBranchListResult>;
     listForDiscovery(options?: {
         timeoutMs?: number;
@@ -87,6 +103,15 @@ export declare class CloudSessionController {
     create(input: CreateCloudSessionInput): Promise<CloudSessionAttachment>;
     private trackProvisioningController;
     private abortProvisioningControllers;
+    /** Waits for an adopted pending handoff target before opening its Hub proxy. */
+    waitUntilReady(outerSessionId: string): Promise<void>;
+    /** Seeds an already-provisioned outer session when retrying a pending handoff. */
+    seedHandoff(outerSessionId: string, seed: CloudHandoffSeed): Promise<{
+        innerSessionId: string;
+    }>;
+    verifyHandoffTranscript(outerSessionId: string, expected: readonly MessageWithMetadata[], options?: {
+        allowAppendedMessages?: boolean;
+    }): Promise<void>;
     private createOnce;
     private deleteProvisionedSessionAfterDispose;
     attach(outerSessionId: string, creationOptions?: CloudCreationOptions): Promise<CloudSessionAttachment>;
@@ -125,7 +150,10 @@ export declare class CloudSessionController {
     private assertSessionActive;
     private ensureConnection;
     private resolveInnerSession;
+    private restoreSavedInnerSession;
+    private assertHandoffConnectionReusable;
     private createInnerSession;
+    private adoptExistingHandoffSession;
     private createInnerSessionOnce;
     private handleEvent;
     private forwardEvent;
@@ -138,7 +166,7 @@ export declare class CloudSessionController {
     private subscribeToInnerSession;
     private applySessionModel;
     private disposeConnection;
-    /** Stop reconnecting only when the session is gone, not when lookup fails. */
+    /** Stop reconnecting when the sandbox is unavailable, not when lookup fails. */
     private disposeConnectionIfSessionGone;
 }
 export {};

package/dist/cloud/index.d.ts

@@ -1,6 +1,8 @@
-/** Experimental shared cloud-session client; does not initialize a local agent. */
+/** Experimental cloud execution client. No local runtime or tool execution is initialized. */
+export * from "../services/cloud-handoff";
 export * from "./api";
 export * from "./controller";
+export * from "./models";
 export * from "./repositories";
 export * from "./snapshots";
 export { normalizeSessionTitle, resolveSessionListTitle, stringifyMessageContent, } from "./state";