@panorama-ai/gateway 2.30.211 → 2.31.9

package/dist/drive-sync/drive-sync-transfer.js

@@ -0,0 +1,245 @@
+import { createHash, randomUUID } from 'node:crypto';
+import { createReadStream, createWriteStream } from 'node:fs';
+import { lstat, mkdir, rename, rm, writeFile } from 'node:fs/promises';
+import path from 'node:path';
+import { Readable } from 'node:stream';
+import { pipeline } from 'node:stream/promises';
+import { DRIVE_TRANSFER_POLICY } from '@panorama/shared/drive-transfer-policy';
+import { normalizeDrivePath } from './drive-sync-filesystem.js';
+const DEFAULT_DRIVE_SYNC_TRANSFER_TIMEOUT_MS = DRIVE_TRANSFER_POLICY.networkRequestTimeoutMs;
+export class LocalDriveFileDeferredError extends Error {
+    drivePath;
+    constructor(drivePath, message) {
+        super(message ?? `Local drive file changed while it was being read; deferring sync for ${drivePath}`);
+        this.name = 'LocalDriveFileDeferredError';
+        this.drivePath = drivePath;
+    }
+}
+export function isLocalDriveFileDeferredError(error) {
+    return error instanceof LocalDriveFileDeferredError;
+}
+export async function prepareLocalMutationUploads(params) {
+    const preparedMutations = [];
+    const deferredPaths = [];
+    const requiresUploadApi = params.mutations.some((mutation) => mutation.request.type === 'write_file' &&
+        mutation.localFilePath &&
+        typeof mutation.request.storage_key !== 'string');
+    if (requiresUploadApi && !params.api.prepareFileUpload) {
+        throw new Error('Drive sync direct upload API is not configured');
+    }
+    for (const mutation of params.mutations) {
+        const localFilePath = mutation.localFilePath;
+        if (mutation.request.type !== 'write_file' || !localFilePath) {
+            preparedMutations.push(mutation);
+            continue;
+        }
+        if (typeof mutation.request.storage_key === 'string') {
+            preparedMutations.push(mutation);
+            continue;
+        }
+        const drivePath = readMutationString(mutation.request, 'path');
+        try {
+            const contentSha256 = readMutationString(mutation.request, 'content_sha256');
+            const sizeBytes = readMutationNumber(mutation.request, 'size_bytes');
+            const versionId = buildDeterministicDriveVersionId({
+                driveId: params.driveId,
+                path: drivePath,
+                contentSha256,
+                sizeBytes,
+                baseVersionId: typeof mutation.request.base_version_id === 'string'
+                    ? mutation.request.base_version_id
+                    : null,
+            });
+            await assertLocalFileFingerprint(mutation);
+            const prepared = await params.api.prepareFileUpload({
+                sync_client_id: params.syncClientId,
+                drive_id: params.driveId,
+                path: drivePath,
+                version_id: versionId,
+                content_sha256: contentSha256,
+                size_bytes: sizeBytes,
+                mime_type: typeof mutation.request.mime_type === 'string' ? mutation.request.mime_type : null,
+            });
+            if (prepared.upload_request) {
+                await uploadLocalFileToSignedRequest({
+                    filePath: localFilePath,
+                    sizeBytes,
+                    signedRequest: prepared.upload_request,
+                });
+            }
+            else if (prepared.upload_status !== 'committed') {
+                throw new Error('Prepared drive upload did not include an upload request');
+            }
+            await assertLocalFileFingerprint(mutation);
+            mutation.request.version_id = prepared.version_id;
+            mutation.request.storage_key = prepared.storage_key;
+            preparedMutations.push(mutation);
+        }
+        catch (error) {
+            if (!isLocalDriveFileDeferredError(error)) {
+                throw error;
+            }
+            deferredPaths.push(error.drivePath);
+        }
+    }
+    return { preparedMutations, deferredPaths };
+}
+export async function downloadDriveVersionToLocalFile(params) {
+    const response = await params.api.downloadFileVersion({
+        sync_client_id: params.syncClientId,
+        drive_id: params.driveId,
+        version_id: params.versionId,
+        format: 'base64',
+        transfer_mode: 'direct',
+    });
+    if (response.file.transfer_mode === 'direct' && response.file.download_request) {
+        return await downloadSignedRequestToFile({
+            signedRequest: response.file.download_request,
+            targetPath: params.targetPath,
+            expectedSizeBytes: params.expectedSizeBytes,
+            expectedSha256: params.expectedSha256,
+        });
+    }
+    if (response.file.content_format !== 'base64' || !response.file.content_base64) {
+        throw new Error(`Drive file version ${params.versionId} was not returned as base64`);
+    }
+    const bytes = Buffer.from(response.file.content_base64, 'base64');
+    const contentSha256 = sha256Hex(bytes);
+    if (params.expectedSizeBytes !== null && bytes.byteLength !== params.expectedSizeBytes) {
+        throw new Error(`Downloaded drive file size mismatch for ${params.versionId}`);
+    }
+    if (params.expectedSha256 && contentSha256 !== params.expectedSha256) {
+        throw new Error(`Downloaded drive file hash mismatch for ${params.versionId}`);
+    }
+    await mkdir(path.dirname(params.targetPath), { recursive: true });
+    await writeFile(params.targetPath, bytes);
+    return { sizeBytes: bytes.byteLength, contentSha256 };
+}
+async function assertLocalFileFingerprint(mutation) {
+    if (!mutation.localFilePath || !mutation.localFingerprint) {
+        return;
+    }
+    const current = await lstat(mutation.localFilePath);
+    if (!current.isFile() ||
+        current.size !== mutation.localFingerprint.sizeBytes ||
+        current.mtimeMs !== mutation.localFingerprint.mtimeMs ||
+        current.ctimeMs !== mutation.localFingerprint.ctimeMs) {
+        const drivePath = readMutationString(mutation.request, 'path');
+        throw new LocalDriveFileDeferredError(drivePath);
+    }
+}
+async function uploadLocalFileToSignedRequest(params) {
+    const headers = new Headers(params.signedRequest.headers);
+    headers.set('content-length', String(params.sizeBytes));
+    const response = await fetchWithTimeout(params.signedRequest.url, {
+        method: params.signedRequest.method,
+        headers,
+        body: createReadStream(params.filePath),
+        duplex: 'half',
+    }, {
+        timeoutMs: DEFAULT_DRIVE_SYNC_TRANSFER_TIMEOUT_MS,
+        label: 'Drive object upload',
+    });
+    if (!response.ok) {
+        const body = await response.text().catch(() => '');
+        throw new Error(`Drive object upload failed with status ${response.status}${body ? ` body=${body.slice(0, 500)}` : ''}`);
+    }
+}
+async function downloadSignedRequestToFile(params) {
+    const response = await fetchWithTimeout(params.signedRequest.url, {
+        method: params.signedRequest.method,
+        headers: params.signedRequest.headers,
+    }, {
+        timeoutMs: DEFAULT_DRIVE_SYNC_TRANSFER_TIMEOUT_MS,
+        label: 'Drive object download',
+    });
+    if (!response.ok || !response.body) {
+        const body = await response.text().catch(() => '');
+        throw new Error(`Drive object download failed with status ${response.status}${body ? ` body=${body.slice(0, 500)}` : ''}`);
+    }
+    await mkdir(path.dirname(params.targetPath), { recursive: true });
+    const tempPath = `${params.targetPath}.panorama-download-${randomUUID()}.tmp`;
+    const hash = createHash('sha256');
+    let sizeBytes = 0;
+    try {
+        const source = Readable.fromWeb(response.body);
+        await pipeline(source, async function* hashChunks(chunks) {
+            for await (const chunk of chunks) {
+                const buffer = Buffer.isBuffer(chunk) ? chunk : Buffer.from(chunk);
+                sizeBytes += buffer.byteLength;
+                hash.update(buffer);
+                yield buffer;
+            }
+        }, createWriteStream(tempPath));
+        const contentSha256 = hash.digest('hex');
+        if (params.expectedSizeBytes !== null && sizeBytes !== params.expectedSizeBytes) {
+            throw new Error(`Downloaded drive file size mismatch for ${params.targetPath}`);
+        }
+        if (params.expectedSha256 && contentSha256 !== params.expectedSha256) {
+            throw new Error(`Downloaded drive file hash mismatch for ${params.targetPath}`);
+        }
+        await rename(tempPath, params.targetPath);
+        return { sizeBytes, contentSha256 };
+    }
+    catch (error) {
+        await rm(tempPath, { force: true }).catch(() => undefined);
+        throw error;
+    }
+}
+async function fetchWithTimeout(input, init, options) {
+    const controller = new AbortController();
+    const timer = setTimeout(() => {
+        controller.abort();
+    }, options.timeoutMs);
+    timer.unref?.();
+    try {
+        return await fetch(input, {
+            ...init,
+            signal: init.signal ?? controller.signal,
+        });
+    }
+    catch (error) {
+        if (controller.signal.aborted) {
+            throw new Error(`${options.label} timed out after ${options.timeoutMs}ms`);
+        }
+        throw error;
+    }
+    finally {
+        clearTimeout(timer);
+    }
+}
+function buildDeterministicDriveVersionId(params) {
+    const hash = createHash('sha256')
+        .update([
+        'panorama-drive-version-v1',
+        params.driveId,
+        normalizeDrivePath(params.path),
+        params.contentSha256,
+        String(params.sizeBytes),
+        params.baseVersionId ?? '',
+    ].join('\0'))
+        .digest();
+    const bytes = Buffer.from(hash.subarray(0, 16));
+    bytes[6] = (bytes[6] & 0x0f) | 0x50;
+    bytes[8] = (bytes[8] & 0x3f) | 0x80;
+    const hex = bytes.toString('hex');
+    return `${hex.slice(0, 8)}-${hex.slice(8, 12)}-${hex.slice(12, 16)}-${hex.slice(16, 20)}-${hex.slice(20)}`;
+}
+function readMutationString(request, key) {
+    const value = request[key];
+    if (typeof value !== 'string') {
+        throw new Error(`Local drive sync mutation is missing ${key}`);
+    }
+    return value;
+}
+function readMutationNumber(request, key) {
+    const value = request[key];
+    if (typeof value !== 'number' || !Number.isSafeInteger(value) || value < 0) {
+        throw new Error(`Local drive sync mutation is missing numeric ${key}`);
+    }
+    return value;
+}
+function sha256Hex(bytes) {
+    return createHash('sha256').update(bytes).digest('hex');
+}
+//# sourceMappingURL=drive-sync-transfer.js.map

package/dist/drive-sync/drive-sync-transfer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"drive-sync-transfer.js","sourceRoot":"","sources":["../../src/drive-sync/drive-sync-transfer.ts"],"names":[],"mappings":"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"}

package/dist/drive-sync/drive-sync.d.ts

@@ -0,0 +1,433 @@
+import type { GatewayDriveSyncConfig } from './config.js';
+import { type DriveSyncConflictRecord, type DriveSyncStateEntry } from './drive-sync-planner.js';
+import { type DriveSyncStateMutationStore, type LocalDriveMutationResult } from './drive-sync-state-applier.js';
+import { type DriveSyncSupabaseClient } from './runtime-utils.js';
+export type { DriveSyncConflictRecord, DriveSyncStateEntry, DriveSyncStateEntryType, LocalDriveMutation, LocalDriveScanEntry, } from './drive-sync-planner.js';
+export { resolveDriveLocalPath, resolveDriveLocalRoot } from './drive-sync-filesystem.js';
+type DriveSyncClientResponse = {
+    id: string;
+    team_id: string;
+    agent_id: string | null;
+    host_id: string | null;
+    vm_id: string | null;
+    display_name: string | null;
+    status: string;
+    metadata: Record<string, unknown>;
+    created_at: string;
+    updated_at: string;
+};
+type DriveSyncCursorResponse = {
+    id: string;
+    sync_client_id: string;
+    drive_id: string;
+    last_batch_sequence: number;
+    status: string;
+    last_success_at: string | null;
+    last_error: string | null;
+    metadata: Record<string, unknown>;
+    created_at: string;
+    updated_at: string;
+};
+type DriveSyncStatusValue = 'active' | 'degraded' | 'error';
+type DriveSyncStatusSummaryResponse = {
+    applied_batch_count: number;
+    applied_path_count: number;
+    remote_conflict_count: number;
+    uploaded_batch_count: number;
+    uploaded_change_count: number;
+    uploaded_applied_count: number;
+    uploaded_conflict_count: number;
+    uploaded_unsupported_count: number;
+    uploaded_rejected_count: number;
+    deferred_file_count: number;
+};
+type DriveSyncStatusReportResponse = {
+    id: string;
+    sync_client_id: string;
+    drive_id: string;
+    status: DriveSyncStatusValue;
+    last_reason: string | null;
+    last_error: string | null;
+    last_batch_sequence: number | null;
+    last_sync_at: string;
+    last_success_at: string | null;
+    summary: DriveSyncStatusSummaryResponse;
+    metadata: Record<string, unknown>;
+    created_at: string;
+    updated_at: string;
+};
+type DriveResourceResponse = {
+    id: string;
+    title: string | null;
+    metadata: Record<string, unknown>;
+    created_at: string;
+    updated_at: string;
+};
+type DriveChangeBatchPathResponse = {
+    id: string;
+    path: string;
+    scope: string;
+    change_type: string | null;
+    entry_type: string | null;
+    from_path: string | null;
+    to_path: string | null;
+    version_id: string | null;
+    version: {
+        id: string;
+        drive_id: string;
+        path: string;
+        content_sha256: string;
+        size_bytes: number;
+        mime_type: string | null;
+    } | null;
+};
+type DriveChangeBatchResponse = {
+    id: string;
+    sequence: number;
+    drive_id: string;
+    summary: string;
+    confidence: string;
+    counters: Record<string, unknown>;
+    observation_metadata: Record<string, unknown>;
+    completed_at: string;
+    created_at: string;
+    paths: DriveChangeBatchPathResponse[];
+};
+type RegisterDriveSyncClientResponse = {
+    success: true;
+    sync_client: DriveSyncClientResponse;
+};
+type ListSyncDrivesResponse = {
+    success: true;
+    sync_client: DriveSyncClientResponse;
+    drives: Array<{
+        resource: DriveResourceResponse;
+        cursor: DriveSyncCursorResponse | null;
+        sync_status?: DriveSyncStatusReportResponse | null;
+    }>;
+};
+type GetDriveChangesResponse = {
+    success: true;
+    sync_client: DriveSyncClientResponse;
+    drive_id: string;
+    cursor: DriveSyncCursorResponse;
+    changes: DriveChangeBatchResponse[];
+    next_batch_sequence: number | null;
+    has_more: boolean;
+};
+type DownloadDriveFileVersionResponse = {
+    success: true;
+    file: {
+        path: string;
+        version_id: string;
+        content_sha256: string;
+        mime_type: string | null;
+        size_bytes: number;
+        transfer_mode?: 'direct';
+        download_request?: DriveObjectSignedRequestResponse;
+        content_format?: 'base64' | 'text';
+        is_utf8_text?: boolean;
+        content_base64?: string;
+        text_content?: string;
+    };
+};
+type DriveObjectSignedRequestResponse = {
+    method: 'GET' | 'PUT' | 'DELETE';
+    url: string;
+    headers: Record<string, string>;
+    expires_at: string;
+};
+type PrepareDriveFileUploadResponse = {
+    success: true;
+    sync_client: DriveSyncClientResponse;
+    drive_id: string;
+    path: string;
+    version_id: string;
+    storage_backend: 'object';
+    storage_key: string;
+    content_sha256: string;
+    size_bytes: number;
+    mime_type: string | null;
+    upload_id?: string;
+    upload_expires_at?: string;
+    upload_status?: 'pending' | 'committed';
+    upload_request: DriveObjectSignedRequestResponse | null;
+};
+type AckDriveChangesResponse = {
+    success: true;
+    sync_client: DriveSyncClientResponse;
+    cursor: DriveSyncCursorResponse;
+    remote_conflict_count?: number;
+    remote_conflicts?: RemoteConflictAckResult[];
+    resource_operation_id?: string;
+    resource_operation_status?: string;
+};
+type RemoteConflictAckPayload = {
+    path: string;
+    reason: string | null;
+    conflict_path: string | null;
+    local_content_sha256: string | null;
+    local_size_bytes: number | null;
+    local_version_id: string | null;
+    remote_batch_id: string | null;
+    remote_sequence: number | null;
+};
+type RemoteConflictAckResult = {
+    path?: string;
+    status?: string;
+    conflict_id?: string | null;
+    conflict_path?: string | null;
+    reason?: string | null;
+    remote_batch_id?: string | null;
+    remote_sequence?: number | null;
+};
+type ApplyLocalDriveChangeBatchResponse = {
+    success: true;
+    idempotent: boolean;
+    drive_id: string;
+    sync_client_id: string;
+    batch: {
+        id: string;
+        sequence: number;
+    } | null;
+    results: LocalDriveChangeResult[];
+    applied_count: number;
+    conflict_count: number;
+    unsupported_count: number;
+    rejected_count: number;
+    resource_operation_status?: string;
+};
+type ApplyDriveConflictActionsResponse = {
+    success: true;
+    sync_client: DriveSyncClientResponse;
+    drive_id: string;
+    resolved_count: number;
+    ignored_count: number;
+    updated_count: number;
+    missing_count: number;
+    results: DriveConflictActionResult[];
+};
+type DriveConflictActionResult = {
+    index?: number;
+    type?: string;
+    path?: string;
+    conflict_id?: string | null;
+    conflict_path?: string | null;
+    status?: string;
+};
+type ReportDriveSyncStatusResponse = {
+    success: true;
+    sync_client: DriveSyncClientResponse;
+    status_report: DriveSyncStatusReportResponse;
+};
+type LocalDriveChangeResultBase = {
+    index: number;
+    type: string;
+    path?: string;
+    from_path?: string;
+    to_path?: string;
+    version_id?: string;
+    conflict_id?: string;
+    reason?: string;
+};
+type LocalDriveChangeResult = (LocalDriveChangeResultBase & LocalDriveMutationResult) | (LocalDriveChangeResultBase & {
+    status: 'staged';
+});
+export type DriveSyncFunctionApi = {
+    registerClient(body: {
+        team_id?: string;
+        agent_id?: string | null;
+        host_id?: string | null;
+        vm_id?: string | null;
+        client_key: string;
+        display_name: string;
+        metadata: Record<string, unknown>;
+    }): Promise<RegisterDriveSyncClientResponse>;
+    listDrives(body: {
+        sync_client_id: string;
+    }): Promise<ListSyncDrivesResponse>;
+    getChanges(body: {
+        sync_client_id: string;
+        drive_id: string;
+        limit: number;
+    }): Promise<GetDriveChangesResponse>;
+    downloadFileVersion(body: {
+        sync_client_id: string;
+        drive_id: string;
+        version_id: string;
+        format: 'base64';
+        transfer_mode?: 'direct';
+    }): Promise<DownloadDriveFileVersionResponse>;
+    prepareFileUpload?(body: {
+        sync_client_id: string;
+        drive_id: string;
+        path: string;
+        version_id: string;
+        content_sha256: string;
+        size_bytes: number;
+        mime_type?: string | null;
+    }): Promise<PrepareDriveFileUploadResponse>;
+    ackChanges(body: {
+        sync_client_id: string;
+        drive_id: string;
+        operation_id?: string;
+        last_batch_sequence: number;
+        last_error?: string | null;
+        remote_conflicts?: RemoteConflictAckPayload[];
+    }): Promise<AckDriveChangesResponse>;
+    applyLocalChangeBatch(body: {
+        sync_client_id: string;
+        drive_id: string;
+        resource_operation_id: string;
+        resource_operation_fingerprint: string;
+        resource_operation_chunk_fingerprint: string;
+        resource_operation_chunk_fingerprints: string[];
+        resource_operation_chunk_index: number;
+        resource_operation_chunk_count: number;
+        base_cursor_sequence: number | null;
+        changes: Record<string, unknown>[];
+    }): Promise<ApplyLocalDriveChangeBatchResponse>;
+    applyConflictActions?(body: {
+        sync_client_id: string;
+        drive_id: string;
+        operation_id: string;
+        actions: Record<string, unknown>[];
+    }): Promise<ApplyDriveConflictActionsResponse>;
+    reportStatus(body: {
+        sync_client_id: string;
+        drive_id: string;
+        status?: DriveSyncStatusValue | null;
+        last_reason?: string | null;
+        last_error?: string | null;
+        last_batch_sequence?: number | null;
+        summary?: DriveSyncStatusSummaryResponse;
+        metadata?: Record<string, unknown>;
+    }): Promise<ReportDriveSyncStatusResponse>;
+};
+export type DriveSyncStateDrive = {
+    id: string;
+    title: string | null;
+    rootPath: string;
+};
+export type DriveSyncStateStoreLike = DriveSyncStateMutationStore & {
+    getOrCreateClientKey?(prefix: string): string;
+    getEntry?(driveId: string, drivePath: string): DriveSyncStateEntry | null;
+    listEntries?(driveId: string): DriveSyncStateEntry[];
+    listDrives?(): DriveSyncStateDrive[];
+    listConflicts?(driveId: string): DriveSyncConflictRecord[];
+    setSyncClient(client: DriveSyncClientResponse): void;
+    upsertDrive(drive: {
+        id: string;
+        title: string | null;
+        rootPath: string;
+    }): void;
+    removeDrive?(driveId: string): void;
+    setCursor(driveId: string, lastBatchSequence: number): void;
+    close?(): void;
+};
+export declare class DriveSyncStateStore implements DriveSyncStateStoreLike {
+    private readonly db;
+    private constructor();
+    static open(stateDir: string): Promise<DriveSyncStateStore>;
+    close(): void;
+    getOrCreateClientKey(prefix: string): string;
+    getEntry(driveId: string, drivePath: string): DriveSyncStateEntry | null;
+    listEntries(driveId: string): DriveSyncStateEntry[];
+    listDrives(): DriveSyncStateDrive[];
+    getConflict(driveId: string, drivePath: string): DriveSyncConflictRecord | null;
+    listConflicts(driveId: string): DriveSyncConflictRecord[];
+    setSyncClient(client: DriveSyncClientResponse): void;
+    upsertDrive(drive: {
+        id: string;
+        title: string | null;
+        rootPath: string;
+    }): void;
+    removeDrive(driveId: string): void;
+    setCursor(driveId: string, lastBatchSequence: number): void;
+    upsertEntry(entry: DriveSyncStateEntry): void;
+    upsertConflict(conflict: DriveSyncConflictRecord): void;
+    deleteConflict(driveId: string, drivePath: string): void;
+    deleteConflictTree(driveId: string, drivePath: string): void;
+    deleteEntryTree(driveId: string, drivePath: string): void;
+    moveEntryTree(driveId: string, fromPath: string, toPath: string): void;
+    private ensureSchema;
+    private ensureColumn;
+}
+export type DriveSyncOptions = {
+    includeLocalWrites?: boolean;
+    dirtyLocalPaths?: string[];
+    schedulerStatus?: {
+        watchStatus: 'active' | 'unavailable' | 'error';
+        watchError: string | null;
+    };
+};
+export type DriveSyncService = {
+    syncOnce(options?: DriveSyncOptions): Promise<DriveSyncRunSummary>;
+    close(): void;
+};
+export type DriveSyncRunSummary = {
+    driveCount: number;
+    failedDriveCount: number;
+    appliedBatchCount: number;
+    appliedPathCount: number;
+    remoteConflictCount: number;
+    uploadedBatchCount: number;
+    uploadedChangeCount: number;
+    uploadedAppliedCount: number;
+    uploadedConflictCount: number;
+    uploadedUnsupportedCount: number;
+    uploadedRejectedCount: number;
+    deferredFileCount: number;
+};
+export type DriveSyncRuntimeIdentity = {
+    kind: 'vm_gateway';
+    teamId: string;
+    vmId: string;
+    gatewayId: string;
+    generation: number | null;
+    agentId?: string | null;
+};
+export type DriveSyncRuntimeConfig = {
+    runtimeId: string;
+    driveSync: GatewayDriveSyncConfig;
+    identity: DriveSyncRuntimeIdentity;
+};
+export declare function createDriveSyncService(params: {
+    config: DriveSyncRuntimeConfig;
+    supabase: DriveSyncSupabaseClient;
+    api?: DriveSyncFunctionApi;
+    stateStore?: DriveSyncStateStoreLike;
+}): Promise<DriveSyncService>;
+export declare function createSupabaseDriveSyncApi(supabase: DriveSyncSupabaseClient, options?: {
+    timeoutMs?: number;
+}): DriveSyncFunctionApi;
+export declare function applyDriveChangeBatchToLocalFilesystem(params: {
+    syncClientId: string;
+    driveRoot: string;
+    batch: DriveChangeBatchResponse;
+    api: Pick<DriveSyncFunctionApi, 'downloadFileVersion'>;
+    stateStore: DriveSyncStateStoreLike;
+}): Promise<{
+    appliedPathCount: number;
+    remoteConflictCount: number;
+    remoteConflicts: DriveSyncConflictRecord[];
+}>;
+export declare function reconcileLocalDriveToCloud(params: {
+    syncClientId: string;
+    driveId: string;
+    driveRoot: string;
+    baseCursorSequence: number | null;
+    api: Pick<DriveSyncFunctionApi, 'applyLocalChangeBatch' | 'prepareFileUpload' | 'applyConflictActions'>;
+    stateStore: DriveSyncStateStoreLike;
+    dirtyDrivePaths?: Set<string> | null;
+}): Promise<{
+    uploadedBatchCount: number;
+    uploadedChangeCount: number;
+    uploadedAppliedCount: number;
+    uploadedConflictCount: number;
+    uploadedUnsupportedCount: number;
+    uploadedRejectedCount: number;
+    deferredFileCount: number;
+}>;
+export declare function logDriveSyncRunSummary(summary: DriveSyncRunSummary): void;
+//# sourceMappingURL=drive-sync.d.ts.map