@components-kit/open-workbook 0.1.0

package/assets/backend/dist/runtime-service.d.ts

@@ -0,0 +1,3167 @@
+import { BackupManager, BatchCompiler, LockManager, PlanManager, SnapshotManager, TaskRegistry, TemplateRegistry, TransactionManager } from "@components-kit/open-workbook-excel-core";
+import type { BackupRecord } from "@components-kit/open-workbook-excel-core";
+import type { TemplateRecord } from "@components-kit/open-workbook-excel-core";
+import type { AddinTemplateRepairRequest, A1Range, AgentId, AgentRecord, BackupId, BatchRequest, ChartCreateRequest, ChartSelector, ChartUpdateDataSourceRequest, CleaningReport, CollaborationEvent, ConflictRecord, ConflictTelemetrySummary, ConnectionId, FormulaCompareResponse, FormulaDependencyGraph, FormulaTraceResponse, FormulaCopyPatternsRequest, ConflictGuidanceResponse, LockAcquireResponse, LockId, LockLeasePolicy, LockMode, LockRenewResponse, LockReleaseResponse, FormulaFillRequest, FormulaMutationResponse, FormulaPatternRequest, FormulaPatternResponse, NameCreateRequest, NameSelector, NameUpdateRequest, OperationResult, OperationWarning, PermissionState, PivotCopyFromTemplateRequest, PivotCompareFingerprintRequest, PivotCreateRequest, PivotDiff, PivotFingerprint, PivotOperationCapabilityStatus, PivotRebuildWithSourceRequest, PivotRepairFromTemplateRequest, PivotSelector, PivotTableInfo, PivotValidateSourceRequest, PlanCreateRequest, PlanId, PlanRefreshResult, RangeMetadataRequest, RangeSearchRequest, RepairReport, RegionRegisterRequest, RegionSelector, RuntimeCapabilities, RuntimeSelectionResponse, SnapshotId, TaskId, TaskBlocker, TaskScheduleResponse, TaskRecord, TableAppendRowsRequest, TableApplyFiltersRequest, TableCopyStructureRequest, TableCreateRequest, TableResizeRequest, TableSelector, TableSetStyleRequest, TableSetTotalRowRequest, TableSortRequest, TableUpdateRowsRequest, TemplateId, TemplateCaptureRequest, TransactionId, TransactionRecord, TransactionRollbackPreview, TransactionRollbackChainPreview, SheetTemplateFingerprintResponse, TemplateValidationResponse, StyleCompareResponse, StyleCopyRequest, StyleCopyResponse, StyleDimension, StyleFingerprintRequest, StyleFingerprintResponse, ValidationIssue, ValidationReport, WorkbookBackupRetentionRequest, WorkbookCreateFileBackupRequest, WorkbookFileBackupManifest, WorkbookRestoreFileBackupRequest, WorkbookScope, WorkbookRegion, WorkbookId, WorkbookEmbeddedLocalConfigResponse, WorkbookLocalConfig, WorkbookLocalConfigImportRequest, WorkbookLocalConfigImportResponse, WorkbookRef } from "@components-kit/open-workbook-protocol";
+import { runtimeError } from "@components-kit/open-workbook-protocol";
+import { SessionRegistry } from "./session-registry.js";
+import type { AddinRpcClient } from "./addin-rpc-client.js";
+import { NativeFileBridge } from "./native-file-bridge.js";
+export interface RuntimeServiceOptions {
+    stateDir?: string;
+    persistState?: boolean;
+    fileBridge?: NativeFileBridge;
+}
+export declare class RuntimeService {
+    readonly sessions: SessionRegistry;
+    readonly backups: BackupManager;
+    readonly snapshots: SnapshotManager;
+    readonly templates: TemplateRegistry;
+    readonly compiler: BatchCompiler;
+    readonly plans: PlanManager;
+    readonly tasks: TaskRegistry;
+    readonly locks: LockManager;
+    readonly transactions: TransactionManager;
+    private readonly addinClients;
+    private readonly regions;
+    private readonly agents;
+    private readonly collabEvents;
+    private readonly conflicts;
+    private readonly conflictTelemetry;
+    private transactionQueue;
+    private readonly defaultAgentId;
+    private readonly stateStore;
+    private readonly fileBridge;
+    private lockLeasePolicy;
+    private permissionState;
+    private readonly events;
+    private eventSubscriptionEnabled;
+    private eventDebounceMs;
+    constructor(options?: RuntimeServiceOptions);
+    registerAgent(input?: {
+        agentId?: AgentId | undefined;
+        agentName?: string | undefined;
+        clientType?: AgentRecord["clientType"] | undefined;
+        pid?: number | undefined;
+    }): {
+        ok: boolean;
+        agent: AgentRecord;
+    };
+    createTask(input: {
+        workbookId: WorkbookId;
+        goal: string;
+        role?: string | undefined;
+        priority?: TaskRecord["priority"] | undefined;
+        assignedAgentId?: AgentId | undefined;
+        allowedScopes?: WorkbookScope[] | undefined;
+        dependencies?: TaskId[] | undefined;
+    }): {
+        ok: boolean;
+        task: TaskRecord;
+    };
+    claimTask(taskId: TaskId, agentId: AgentId): {
+        ok: boolean;
+        task: TaskRecord;
+    };
+    updateTask(taskId: TaskId, patch: Partial<Pick<TaskRecord, "goal" | "role" | "priority" | "status" | "progress" | "currentStep" | "blockers" | "assignedAgentId" | "allowedScopes" | "dependencies" | "errorMessage">>): {
+        ok: boolean;
+        task: TaskRecord;
+    };
+    setTaskProgress(taskId: TaskId, progress: number, currentStep?: string | undefined): {
+        ok: boolean;
+        task: TaskRecord;
+    };
+    addTaskBlocker(taskId: TaskId, input: Pick<TaskBlocker, "message" | "severity"> & {
+        scope?: WorkbookScope | undefined;
+    }): {
+        ok: boolean;
+        task: TaskRecord;
+        blocker: TaskBlocker | undefined;
+    };
+    resolveTaskBlocker(taskId: TaskId, blockerId: string): {
+        ok: boolean;
+        task: TaskRecord;
+    };
+    evaluateTaskSchedule(input?: {
+        workbookId?: WorkbookId | undefined;
+        apply?: boolean | undefined;
+        lockMode?: LockMode | undefined;
+    }): TaskScheduleResponse;
+    resumeReadyTasks(workbookId?: WorkbookId | undefined): TaskScheduleResponse;
+    getTask(taskId: TaskId): {
+        ok: boolean;
+        task: TaskRecord;
+        error?: never;
+    } | {
+        ok: boolean;
+        error: import("@components-kit/open-workbook-protocol").ExcelRuntimeError;
+        task?: never;
+    };
+    listTasks(workbookId?: WorkbookId): {
+        ok: boolean;
+        tasks: TaskRecord[];
+    };
+    getCollaborationStatus(workbookId?: WorkbookId): {
+        ok: boolean;
+        agents: AgentRecord[];
+        tasks: TaskRecord[];
+        locks: import("@components-kit/open-workbook-protocol").LockRecord[];
+        transactions: TransactionRecord[];
+        conflicts: ConflictRecord[];
+        events: CollaborationEvent[];
+    };
+    listAgents(): {
+        ok: boolean;
+        agents: AgentRecord[];
+    };
+    listLocks(workbookId?: WorkbookId): {
+        ok: boolean;
+        locks: import("@components-kit/open-workbook-protocol").LockRecord[];
+    };
+    getLockPolicy(): {
+        ok: boolean;
+        policy: LockLeasePolicy;
+    };
+    setLockPolicy(update: Partial<LockLeasePolicy>): {
+        ok: boolean;
+        policy: LockLeasePolicy;
+    };
+    acquireLocks(input: {
+        workbookId: WorkbookId;
+        scopes: WorkbookScope[];
+        mode: LockMode;
+        reason: string;
+        ownerAgentId?: AgentId | undefined;
+        taskId?: TaskId | undefined;
+        ttlMs?: number | undefined;
+    }): LockAcquireResponse;
+    renewLocks(lockIds: LockId[], ttlMs?: number | undefined): LockRenewResponse;
+    releaseLocks(lockIds: LockId[]): LockReleaseResponse;
+    listTransactions(workbookId?: WorkbookId): {
+        ok: boolean;
+        transactions: TransactionRecord[];
+    };
+    getTransaction(transactionId: TransactionId): {
+        ok: boolean;
+        transaction: TransactionRecord;
+        error?: never;
+    } | {
+        ok: boolean;
+        error: import("@components-kit/open-workbook-protocol").ExcelRuntimeError;
+        transaction?: never;
+    };
+    previewTransactionRollback(transactionId: TransactionId): TransactionRollbackPreview;
+    rollbackTransaction(transactionId: TransactionId, confirmationToken?: string): Promise<OperationResult>;
+    previewTransactionRollbackChain(transactionId: TransactionId): TransactionRollbackChainPreview;
+    rollbackTransactionChain(transactionId: TransactionId, confirmationToken?: string): Promise<OperationResult>;
+    private collectRollbackChain;
+    private rollbackChainConfirmationToken;
+    listConflicts(workbookId?: WorkbookId): {
+        ok: boolean;
+        conflicts: ConflictRecord[];
+    };
+    getConflictGuidance(workbookId?: WorkbookId): ConflictGuidanceResponse;
+    explainConflict(conflict: ConflictRecord): {
+        ok: boolean;
+        conflict: ConflictRecord;
+        guidance: import("@components-kit/open-workbook-protocol").ConflictResolutionGuidance | undefined;
+    };
+    getConflictTelemetry(workbookId?: WorkbookId, windowSize?: number): ConflictTelemetrySummary;
+    clearConflictTelemetry(workbookId?: WorkbookId): {
+        ok: boolean;
+        workbookId: WorkbookId | undefined;
+        cleared: number;
+    };
+    private restoreState;
+    private recoverRuntimeState;
+    private persistState;
+    attachAddinClient(connectionId: ConnectionId, client: AddinRpcClient): void;
+    detachAddinClient(connectionId: ConnectionId): void;
+    recordAddinEvent(connectionId: ConnectionId, method: string, params?: unknown): void;
+    private recordCollabEvent;
+    private recordConflictTelemetry;
+    private markConflictTelemetryClearedByLock;
+    getStatus(): {
+        ok: boolean;
+        activeAddinConnected: boolean;
+        fileBridge: import("@components-kit/open-workbook-protocol").WorkbookFileBridgeStatus;
+        sessions: import("./session-registry.js").AddinSession[];
+        activeWorkbook: WorkbookRef | undefined;
+    };
+    getStatusWithFileBridgeProbe(): Promise<{
+        fileBridge: import("@components-kit/open-workbook-protocol").WorkbookFileBridgeStatus;
+        ok: boolean;
+        activeAddinConnected: boolean;
+        sessions: import("./session-registry.js").AddinSession[];
+        activeWorkbook: WorkbookRef | undefined;
+    }>;
+    getCapabilities(options?: {
+        includePreview?: boolean;
+    }): {
+        runtime: {
+            ok: boolean;
+            activeAddinConnected: boolean;
+            fileBridge: import("@components-kit/open-workbook-protocol").WorkbookFileBridgeStatus;
+            sessions: import("./session-registry.js").AddinSession[];
+            activeWorkbook: WorkbookRef | undefined;
+        };
+        activeHostCapabilities: RuntimeCapabilities;
+        connectedHostCapabilities: {
+            connectionId: ConnectionId;
+            connectedAt: string;
+            lastSeenAt: string;
+            activeWorkbook: WorkbookRef | undefined;
+            capabilities: RuntimeCapabilities | undefined;
+        }[];
+        catalog: {
+            total: number;
+            exposed: number;
+            stable: number;
+            preview: number;
+            planned: number;
+            unsupported: number;
+            tools: import("@components-kit/open-workbook-protocol").ToolContract[];
+        };
+        fileBridge: import("@components-kit/open-workbook-protocol").WorkbookFileBridgeStatus;
+        resources: import("@components-kit/open-workbook-protocol").ResourceContract[];
+        prompts: import("@components-kit/open-workbook-protocol").PromptContract[];
+    };
+    subscribeEvents(): {
+        ok: boolean;
+        subscribed: boolean;
+        debounceMs: number;
+    };
+    unsubscribeEvents(): {
+        ok: boolean;
+        subscribed: boolean;
+    };
+    getRecentEvents(limit?: number): {
+        ok: boolean;
+        subscribed: boolean;
+        debounceMs: number;
+        events: {
+            eventId: string;
+            connectionId: ConnectionId;
+            method: string;
+            params?: unknown;
+            receivedAt: string;
+        }[];
+    };
+    clearEvents(): {
+        ok: boolean;
+    };
+    setEventDebounce(debounceMs: number): {
+        ok: boolean;
+        debounceMs: number;
+    };
+    getPermissions(): {
+        ok: boolean;
+        permissions: PermissionState;
+    };
+    setPermissions(update: Partial<PermissionState>): {
+        ok: boolean;
+        permissions: PermissionState;
+    };
+    requireConfirmation(levels: PermissionState["requireConfirmationFor"]): {
+        ok: boolean;
+        permissions: PermissionState;
+    };
+    setPermissionScope(scope: PermissionState["scope"]): {
+        ok: boolean;
+        permissions: PermissionState;
+    };
+    allowDestructiveActions(allow: boolean): {
+        ok: boolean;
+        permissions: PermissionState;
+    };
+    allowMacroExecution(allow: boolean): {
+        ok: boolean;
+        permissions: PermissionState;
+    };
+    lockRegions(input: {
+        workbookId: WorkbookId;
+        regions: Array<{
+            regionName: string;
+            reason?: string;
+        }>;
+    }): Promise<{
+        ok: boolean;
+        permissions: PermissionState;
+    } | {
+        ok: boolean;
+        region: WorkbookRegion;
+        error?: never;
+    } | {
+        ok: boolean;
+        error: import("@components-kit/open-workbook-protocol").ExcelRuntimeError;
+        region?: never;
+    }>;
+    unlockRegions(input: {
+        workbookId: WorkbookId;
+        regionNames?: string[];
+    }): {
+        ok: boolean;
+        permissions: PermissionState;
+    };
+    connectAddinInfo(): {
+        ok: boolean;
+        backendUrl: string;
+        activeAddinConnected: boolean;
+    };
+    disconnectActiveAddin(): {
+        ok: boolean;
+        error: import("@components-kit/open-workbook-protocol").ExcelRuntimeError;
+    } | {
+        ok: boolean;
+        error?: never;
+    };
+    pingAddin(): Promise<unknown>;
+    createPlan(request: PlanCreateRequest): import("@components-kit/open-workbook-excel-core").PlanRecord;
+    compileBatch(request: BatchRequest): import("@components-kit/open-workbook-protocol").CompiledBatch;
+    previewPlan(planId: PlanId): Promise<import("@components-kit/open-workbook-protocol").PlanPreview>;
+    refreshPlanPreview(planId: PlanId): Promise<PlanRefreshResult>;
+    rebasePlan(planId: PlanId): Promise<PlanRefreshResult>;
+    getPlanDiffResource(workbookId: WorkbookId, planId: PlanId): {
+        ok: boolean;
+        workbookId: WorkbookId;
+        planId: PlanId;
+        error: import("@components-kit/open-workbook-protocol").ExcelRuntimeError;
+        diffSummary?: never;
+        preview?: never;
+        plan?: never;
+    } | {
+        ok: boolean;
+        workbookId: WorkbookId;
+        planId: PlanId;
+        diffSummary: import("@components-kit/open-workbook-protocol").DiffSummary | undefined;
+        preview: import("@components-kit/open-workbook-protocol").PlanPreview | undefined;
+        plan: import("@components-kit/open-workbook-excel-core").PlanRecord;
+        error?: never;
+    };
+    getActiveContext(): Promise<{
+        ok: boolean;
+        error: import("@components-kit/open-workbook-protocol").ExcelRuntimeError;
+        activeWorkbook?: never;
+    } | {
+        ok: boolean;
+        activeWorkbook: WorkbookRef | undefined;
+        error?: never;
+    }>;
+    getSelection(): Promise<RuntimeSelectionResponse | {
+        ok: boolean;
+        error: import("@components-kit/open-workbook-protocol").ExcelRuntimeError;
+    }>;
+    getWorkbookInfo(): Promise<{
+        ok: boolean;
+        error: import("@components-kit/open-workbook-protocol").ExcelRuntimeError;
+        info?: never;
+    } | {
+        ok: boolean;
+        info: unknown;
+        error?: never;
+    }>;
+    getWorkbookMap(): Promise<{
+        ok: boolean;
+        error: import("@components-kit/open-workbook-protocol").ExcelRuntimeError;
+        map?: never;
+    } | {
+        ok: boolean;
+        map: unknown;
+        error?: never;
+    }>;
+    createWorkbookSnapshot(input: {
+        workbookId: WorkbookId;
+        reason?: string;
+        ranges?: A1Range[];
+    }): Promise<{
+        ok: boolean;
+        error: import("@components-kit/open-workbook-protocol").ExcelRuntimeError;
+        snapshot?: never;
+    } | {
+        ok: boolean;
+        snapshot: import("@components-kit/open-workbook-excel-core").WorkbookSnapshotRecord;
+        error?: never;
+    }>;
+    getSnapshot(snapshotId: SnapshotId): {
+        ok: boolean;
+        error: import("@components-kit/open-workbook-protocol").ExcelRuntimeError;
+        snapshot?: never;
+    } | {
+        ok: boolean;
+        snapshot: import("@components-kit/open-workbook-excel-core").WorkbookSnapshotRecord;
+        error?: never;
+    };
+    listSnapshots(workbookId: WorkbookId): {
+        ok: boolean;
+        snapshots: import("@components-kit/open-workbook-excel-core").WorkbookSnapshotRecord[];
+    };
+    invalidateSnapshot(snapshotId: SnapshotId): {
+        ok: boolean;
+        error: import("@components-kit/open-workbook-protocol").ExcelRuntimeError;
+        snapshot?: never;
+    } | {
+        ok: boolean;
+        snapshot: import("@components-kit/open-workbook-excel-core").WorkbookSnapshotRecord;
+        error?: never;
+    };
+    deleteSnapshot(snapshotId: SnapshotId): {
+        ok: boolean;
+    };
+    compareSnapshots(leftSnapshotId: SnapshotId, rightSnapshotId: SnapshotId): {
+        ok: boolean;
+        error: import("@components-kit/open-workbook-protocol").ExcelRuntimeError;
+        diff?: never;
+    } | {
+        ok: boolean;
+        diff: import("@components-kit/open-workbook-protocol").DiffSummary;
+        error?: never;
+    };
+    detectExternalChanges(input: {
+        workbookId: WorkbookId;
+        snapshotId: SnapshotId;
+    }): Promise<{
+        ok: boolean;
+        error: import("@components-kit/open-workbook-protocol").ExcelRuntimeError;
+        snapshot?: never;
+    } | {
+        ok: boolean;
+        snapshot: import("@components-kit/open-workbook-excel-core").WorkbookSnapshotRecord;
+        error?: never;
+    } | {
+        ok: boolean;
+        error: import("@components-kit/open-workbook-protocol").ExcelRuntimeError;
+        diff?: never;
+    } | {
+        ok: boolean;
+        diff: import("@components-kit/open-workbook-protocol").DiffSummary;
+        error?: never;
+    }>;
+    calculateWorkbook(workbookId: WorkbookId, calculationType?: "full" | "recalculate"): Promise<unknown>;
+    saveWorkbook(workbookId: WorkbookId): Promise<unknown>;
+    saveWorkbookAs(workbookId: WorkbookId, targetPath?: string): Promise<{
+        ok: boolean;
+        workbookId: WorkbookId;
+        targetPath: string | undefined;
+        bridge: import("@components-kit/open-workbook-protocol").WorkbookFileBridgeResponse;
+        error?: never;
+        bridgeStatus?: never;
+    } | {
+        ok: boolean;
+        workbookId: WorkbookId;
+        targetPath: string | undefined;
+        bridge: import("@components-kit/open-workbook-protocol").WorkbookFileBridgeResponse;
+        error: import("@components-kit/open-workbook-protocol").ExcelRuntimeError;
+        bridgeStatus?: never;
+    } | {
+        ok: boolean;
+        workbookId: WorkbookId;
+        targetPath: string | undefined;
+        bridgeStatus: import("@components-kit/open-workbook-protocol").WorkbookFileBridgeStatus;
+        error: import("@components-kit/open-workbook-protocol").ExcelRuntimeError;
+        bridge?: never;
+    }>;
+    exportWorkbookCopy(input: {
+        workbookId: WorkbookId;
+        reason?: string;
+        targetPath?: string;
+        ranges?: A1Range[];
+    }): Promise<{
+        ok: boolean;
+        workbookId: WorkbookId;
+        targetPath: string | undefined;
+        backup: {
+            ok: boolean;
+            error: import("@components-kit/open-workbook-protocol").ExcelRuntimeError;
+            snapshot?: never;
+        } | {
+            ok: boolean;
+            snapshot: import("@components-kit/open-workbook-excel-core").WorkbookSnapshotRecord;
+            error?: never;
+        };
+        error: import("@components-kit/open-workbook-protocol").ExcelRuntimeError;
+        bridge?: never;
+    } | {
+        ok: boolean;
+        workbookId: WorkbookId;
+        targetPath: string | undefined;
+        backup: {
+            ok: boolean;
+            backup: BackupRecord;
+        };
+        bridge: import("@components-kit/open-workbook-protocol").WorkbookFileBridgeResponse;
+        error?: never;
+    } | {
+        file: {
+            path: string;
+            size: number;
+            sliceCount: number;
+            capturedAt: string;
+            method: string;
+        };
+        bridge?: import("@components-kit/open-workbook-protocol").WorkbookFileBridgeResponse;
+        ok: boolean;
+        workbookId: WorkbookId;
+        targetPath: string;
+        backup: {
+            ok: boolean;
+            backup: BackupRecord;
+        };
+        bridgeStatus: import("@components-kit/open-workbook-protocol").WorkbookFileBridgeStatus;
+        error?: never;
+    } | {
+        error: import("@components-kit/open-workbook-protocol").ExcelRuntimeError;
+        bridge?: import("@components-kit/open-workbook-protocol").WorkbookFileBridgeResponse;
+        ok: boolean;
+        workbookId: WorkbookId;
+        targetPath: string | undefined;
+        backup: {
+            ok: boolean;
+            backup: BackupRecord;
+        };
+        bridgeStatus: import("@components-kit/open-workbook-protocol").WorkbookFileBridgeStatus;
+    }>;
+    createFileBackup(input: WorkbookCreateFileBackupRequest): Promise<{
+        ok: boolean;
+        workbookId: WorkbookId;
+        targetPath: string | undefined;
+        backup: {
+            ok: boolean;
+            error: import("@components-kit/open-workbook-protocol").ExcelRuntimeError;
+            snapshot?: never;
+        } | {
+            ok: boolean;
+            snapshot: import("@components-kit/open-workbook-excel-core").WorkbookSnapshotRecord;
+            error?: never;
+        };
+        error: import("@components-kit/open-workbook-protocol").ExcelRuntimeError;
+        bridge?: never;
+    } | {
+        ok: boolean;
+        workbookId: WorkbookId;
+        targetPath: string | undefined;
+        backup: {
+            ok: boolean;
+            backup: BackupRecord;
+        };
+        bridge: import("@components-kit/open-workbook-protocol").WorkbookFileBridgeResponse;
+        error?: never;
+    } | {
+        file: {
+            path: string;
+            size: number;
+            sliceCount: number;
+            capturedAt: string;
+            method: string;
+        };
+        bridge?: import("@components-kit/open-workbook-protocol").WorkbookFileBridgeResponse;
+        ok: boolean;
+        workbookId: WorkbookId;
+        targetPath: string;
+        backup: {
+            ok: boolean;
+            backup: BackupRecord;
+        };
+        bridgeStatus: import("@components-kit/open-workbook-protocol").WorkbookFileBridgeStatus;
+        error?: never;
+    } | {
+        error: import("@components-kit/open-workbook-protocol").ExcelRuntimeError;
+        bridge?: import("@components-kit/open-workbook-protocol").WorkbookFileBridgeResponse;
+        ok: boolean;
+        workbookId: WorkbookId;
+        targetPath: string | undefined;
+        backup: {
+            ok: boolean;
+            backup: BackupRecord;
+        };
+        bridgeStatus: import("@components-kit/open-workbook-protocol").WorkbookFileBridgeStatus;
+    } | {
+        ok: boolean;
+        backup: BackupRecord;
+        manifest: WorkbookFileBackupManifest;
+        export: {
+            ok: boolean;
+            workbookId: WorkbookId;
+            targetPath: string | undefined;
+            backup: {
+                ok: boolean;
+                error: import("@components-kit/open-workbook-protocol").ExcelRuntimeError;
+                snapshot?: never;
+            } | {
+                ok: boolean;
+                snapshot: import("@components-kit/open-workbook-excel-core").WorkbookSnapshotRecord;
+                error?: never;
+            };
+            error: import("@components-kit/open-workbook-protocol").ExcelRuntimeError;
+            bridge?: never;
+        } | {
+            ok: boolean;
+            workbookId: WorkbookId;
+            targetPath: string | undefined;
+            backup: {
+                ok: boolean;
+                backup: BackupRecord;
+            };
+            bridge: import("@components-kit/open-workbook-protocol").WorkbookFileBridgeResponse;
+            error?: never;
+        } | {
+            file: {
+                path: string;
+                size: number;
+                sliceCount: number;
+                capturedAt: string;
+                method: string;
+            };
+            bridge?: import("@components-kit/open-workbook-protocol").WorkbookFileBridgeResponse;
+            ok: boolean;
+            workbookId: WorkbookId;
+            targetPath: string;
+            backup: {
+                ok: boolean;
+                backup: BackupRecord;
+            };
+            bridgeStatus: import("@components-kit/open-workbook-protocol").WorkbookFileBridgeStatus;
+            error?: never;
+        } | {
+            error: import("@components-kit/open-workbook-protocol").ExcelRuntimeError;
+            bridge?: import("@components-kit/open-workbook-protocol").WorkbookFileBridgeResponse;
+            ok: boolean;
+            workbookId: WorkbookId;
+            targetPath: string | undefined;
+            backup: {
+                ok: boolean;
+                backup: BackupRecord;
+            };
+            bridgeStatus: import("@components-kit/open-workbook-protocol").WorkbookFileBridgeStatus;
+        };
+    }>;
+    listFileBackups(workbookId?: WorkbookId): {
+        ok: boolean;
+        backups: {
+            backup: BackupRecord;
+            manifest: WorkbookFileBackupManifest | undefined;
+        }[];
+    };
+    getFileBackup(backupId: BackupId): {
+        ok: boolean;
+        error: import("@components-kit/open-workbook-protocol").ExcelRuntimeError;
+        backup?: never;
+        manifest?: never;
+    } | {
+        ok: boolean;
+        backup: BackupRecord;
+        manifest: WorkbookFileBackupManifest | undefined;
+        error?: never;
+    };
+    verifyFileBackup(backupId: BackupId): Promise<{
+        ok: boolean;
+        error: import("@components-kit/open-workbook-protocol").ExcelRuntimeError;
+        backup?: never;
+        manifest?: never;
+    } | {
+        ok: boolean;
+        backup: BackupRecord | undefined;
+        manifest: WorkbookFileBackupManifest;
+        error?: never;
+    }>;
+    restoreFileBackup(input: WorkbookRestoreFileBackupRequest): Promise<{
+        ok: boolean;
+        error: import("@components-kit/open-workbook-protocol").ExcelRuntimeError;
+        backup?: never;
+        manifest?: never;
+    } | {
+        ok: boolean;
+        backup: BackupRecord | undefined;
+        manifest: WorkbookFileBackupManifest;
+        error?: never;
+    } | {
+        ok: boolean;
+        warnings: OperationWarning[];
+        error: import("@components-kit/open-workbook-protocol").ExcelRuntimeError;
+    } | {
+        ok: boolean;
+        workbookId: WorkbookId;
+        backupId: BackupId;
+        mode: NonNullable<import("@components-kit/open-workbook-protocol").WorkbookFileRestoreMode | undefined>;
+        emergencyBackup: {
+            ok: boolean;
+            workbookId: WorkbookId;
+            targetPath: string | undefined;
+            backup: {
+                ok: boolean;
+                error: import("@components-kit/open-workbook-protocol").ExcelRuntimeError;
+                snapshot?: never;
+            } | {
+                ok: boolean;
+                snapshot: import("@components-kit/open-workbook-excel-core").WorkbookSnapshotRecord;
+                error?: never;
+            };
+            error: import("@components-kit/open-workbook-protocol").ExcelRuntimeError;
+            bridge?: never;
+        } | {
+            ok: boolean;
+            workbookId: WorkbookId;
+            targetPath: string | undefined;
+            backup: {
+                ok: boolean;
+                backup: BackupRecord;
+            };
+            bridge: import("@components-kit/open-workbook-protocol").WorkbookFileBridgeResponse;
+            error?: never;
+        } | {
+            file: {
+                path: string;
+                size: number;
+                sliceCount: number;
+                capturedAt: string;
+                method: string;
+            };
+            bridge?: import("@components-kit/open-workbook-protocol").WorkbookFileBridgeResponse;
+            ok: boolean;
+            workbookId: WorkbookId;
+            targetPath: string;
+            backup: {
+                ok: boolean;
+                backup: BackupRecord;
+            };
+            bridgeStatus: import("@components-kit/open-workbook-protocol").WorkbookFileBridgeStatus;
+            error?: never;
+        } | {
+            error: import("@components-kit/open-workbook-protocol").ExcelRuntimeError;
+            bridge?: import("@components-kit/open-workbook-protocol").WorkbookFileBridgeResponse;
+            ok: boolean;
+            workbookId: WorkbookId;
+            targetPath: string | undefined;
+            backup: {
+                ok: boolean;
+                backup: BackupRecord;
+            };
+            bridgeStatus: import("@components-kit/open-workbook-protocol").WorkbookFileBridgeStatus;
+        } | {
+            ok: boolean;
+            backup: BackupRecord;
+            manifest: WorkbookFileBackupManifest;
+            export: {
+                ok: boolean;
+                workbookId: WorkbookId;
+                targetPath: string | undefined;
+                backup: {
+                    ok: boolean;
+                    error: import("@components-kit/open-workbook-protocol").ExcelRuntimeError;
+                    snapshot?: never;
+                } | {
+                    ok: boolean;
+                    snapshot: import("@components-kit/open-workbook-excel-core").WorkbookSnapshotRecord;
+                    error?: never;
+                };
+                error: import("@components-kit/open-workbook-protocol").ExcelRuntimeError;
+                bridge?: never;
+            } | {
+                ok: boolean;
+                workbookId: WorkbookId;
+                targetPath: string | undefined;
+                backup: {
+                    ok: boolean;
+                    backup: BackupRecord;
+                };
+                bridge: import("@components-kit/open-workbook-protocol").WorkbookFileBridgeResponse;
+                error?: never;
+            } | {
+                file: {
+                    path: string;
+                    size: number;
+                    sliceCount: number;
+                    capturedAt: string;
+                    method: string;
+                };
+                bridge?: import("@components-kit/open-workbook-protocol").WorkbookFileBridgeResponse;
+                ok: boolean;
+                workbookId: WorkbookId;
+                targetPath: string;
+                backup: {
+                    ok: boolean;
+                    backup: BackupRecord;
+                };
+                bridgeStatus: import("@components-kit/open-workbook-protocol").WorkbookFileBridgeStatus;
+                error?: never;
+            } | {
+                error: import("@components-kit/open-workbook-protocol").ExcelRuntimeError;
+                bridge?: import("@components-kit/open-workbook-protocol").WorkbookFileBridgeResponse;
+                ok: boolean;
+                workbookId: WorkbookId;
+                targetPath: string | undefined;
+                backup: {
+                    ok: boolean;
+                    backup: BackupRecord;
+                };
+                bridgeStatus: import("@components-kit/open-workbook-protocol").WorkbookFileBridgeStatus;
+            };
+        };
+        error: import("@components-kit/open-workbook-protocol").ExcelRuntimeError;
+        bridge?: never;
+    } | {
+        backup?: unknown;
+        ok: boolean;
+        workbookId: WorkbookId;
+        backupId: BackupId;
+        mode: NonNullable<import("@components-kit/open-workbook-protocol").WorkbookFileRestoreMode | undefined>;
+        bridge: import("@components-kit/open-workbook-protocol").WorkbookFileBridgeResponse;
+        emergencyBackup: {
+            ok: boolean;
+            workbookId: WorkbookId;
+            targetPath: string | undefined;
+            backup: {
+                ok: boolean;
+                error: import("@components-kit/open-workbook-protocol").ExcelRuntimeError;
+                snapshot?: never;
+            } | {
+                ok: boolean;
+                snapshot: import("@components-kit/open-workbook-excel-core").WorkbookSnapshotRecord;
+                error?: never;
+            };
+            error: import("@components-kit/open-workbook-protocol").ExcelRuntimeError;
+            bridge?: never;
+        } | {
+            ok: boolean;
+            workbookId: WorkbookId;
+            targetPath: string | undefined;
+            backup: {
+                ok: boolean;
+                backup: BackupRecord;
+            };
+            bridge: import("@components-kit/open-workbook-protocol").WorkbookFileBridgeResponse;
+            error?: never;
+        } | {
+            file: {
+                path: string;
+                size: number;
+                sliceCount: number;
+                capturedAt: string;
+                method: string;
+            };
+            bridge?: import("@components-kit/open-workbook-protocol").WorkbookFileBridgeResponse;
+            ok: boolean;
+            workbookId: WorkbookId;
+            targetPath: string;
+            backup: {
+                ok: boolean;
+                backup: BackupRecord;
+            };
+            bridgeStatus: import("@components-kit/open-workbook-protocol").WorkbookFileBridgeStatus;
+            error?: never;
+        } | {
+            error: import("@components-kit/open-workbook-protocol").ExcelRuntimeError;
+            bridge?: import("@components-kit/open-workbook-protocol").WorkbookFileBridgeResponse;
+            ok: boolean;
+            workbookId: WorkbookId;
+            targetPath: string | undefined;
+            backup: {
+                ok: boolean;
+                backup: BackupRecord;
+            };
+            bridgeStatus: import("@components-kit/open-workbook-protocol").WorkbookFileBridgeStatus;
+        } | {
+            ok: boolean;
+            backup: BackupRecord;
+            manifest: WorkbookFileBackupManifest;
+            export: {
+                ok: boolean;
+                workbookId: WorkbookId;
+                targetPath: string | undefined;
+                backup: {
+                    ok: boolean;
+                    error: import("@components-kit/open-workbook-protocol").ExcelRuntimeError;
+                    snapshot?: never;
+                } | {
+                    ok: boolean;
+                    snapshot: import("@components-kit/open-workbook-excel-core").WorkbookSnapshotRecord;
+                    error?: never;
+                };
+                error: import("@components-kit/open-workbook-protocol").ExcelRuntimeError;
+                bridge?: never;
+            } | {
+                ok: boolean;
+                workbookId: WorkbookId;
+                targetPath: string | undefined;
+                backup: {
+                    ok: boolean;
+                    backup: BackupRecord;
+                };
+                bridge: import("@components-kit/open-workbook-protocol").WorkbookFileBridgeResponse;
+                error?: never;
+            } | {
+                file: {
+                    path: string;
+                    size: number;
+                    sliceCount: number;
+                    capturedAt: string;
+                    method: string;
+                };
+                bridge?: import("@components-kit/open-workbook-protocol").WorkbookFileBridgeResponse;
+                ok: boolean;
+                workbookId: WorkbookId;
+                targetPath: string;
+                backup: {
+                    ok: boolean;
+                    backup: BackupRecord;
+                };
+                bridgeStatus: import("@components-kit/open-workbook-protocol").WorkbookFileBridgeStatus;
+                error?: never;
+            } | {
+                error: import("@components-kit/open-workbook-protocol").ExcelRuntimeError;
+                bridge?: import("@components-kit/open-workbook-protocol").WorkbookFileBridgeResponse;
+                ok: boolean;
+                workbookId: WorkbookId;
+                targetPath: string | undefined;
+                backup: {
+                    ok: boolean;
+                    backup: BackupRecord;
+                };
+                bridgeStatus: import("@components-kit/open-workbook-protocol").WorkbookFileBridgeStatus;
+            };
+        };
+        error?: never;
+    } | {
+        ok: boolean;
+        workbookId: WorkbookId;
+        backupId: BackupId;
+        mode: NonNullable<import("@components-kit/open-workbook-protocol").WorkbookFileRestoreMode | undefined>;
+        bridge: import("@components-kit/open-workbook-protocol").WorkbookFileBridgeResponse;
+        emergencyBackup: {
+            ok: boolean;
+            workbookId: WorkbookId;
+            targetPath: string | undefined;
+            backup: {
+                ok: boolean;
+                error: import("@components-kit/open-workbook-protocol").ExcelRuntimeError;
+                snapshot?: never;
+            } | {
+                ok: boolean;
+                snapshot: import("@components-kit/open-workbook-excel-core").WorkbookSnapshotRecord;
+                error?: never;
+            };
+            error: import("@components-kit/open-workbook-protocol").ExcelRuntimeError;
+            bridge?: never;
+        } | {
+            ok: boolean;
+            workbookId: WorkbookId;
+            targetPath: string | undefined;
+            backup: {
+                ok: boolean;
+                backup: BackupRecord;
+            };
+            bridge: import("@components-kit/open-workbook-protocol").WorkbookFileBridgeResponse;
+            error?: never;
+        } | {
+            file: {
+                path: string;
+                size: number;
+                sliceCount: number;
+                capturedAt: string;
+                method: string;
+            };
+            bridge?: import("@components-kit/open-workbook-protocol").WorkbookFileBridgeResponse;
+            ok: boolean;
+            workbookId: WorkbookId;
+            targetPath: string;
+            backup: {
+                ok: boolean;
+                backup: BackupRecord;
+            };
+            bridgeStatus: import("@components-kit/open-workbook-protocol").WorkbookFileBridgeStatus;
+            error?: never;
+        } | {
+            error: import("@components-kit/open-workbook-protocol").ExcelRuntimeError;
+            bridge?: import("@components-kit/open-workbook-protocol").WorkbookFileBridgeResponse;
+            ok: boolean;
+            workbookId: WorkbookId;
+            targetPath: string | undefined;
+            backup: {
+                ok: boolean;
+                backup: BackupRecord;
+            };
+            bridgeStatus: import("@components-kit/open-workbook-protocol").WorkbookFileBridgeStatus;
+        } | {
+            ok: boolean;
+            backup: BackupRecord;
+            manifest: WorkbookFileBackupManifest;
+            export: {
+                ok: boolean;
+                workbookId: WorkbookId;
+                targetPath: string | undefined;
+                backup: {
+                    ok: boolean;
+                    error: import("@components-kit/open-workbook-protocol").ExcelRuntimeError;
+                    snapshot?: never;
+                } | {
+                    ok: boolean;
+                    snapshot: import("@components-kit/open-workbook-excel-core").WorkbookSnapshotRecord;
+                    error?: never;
+                };
+                error: import("@components-kit/open-workbook-protocol").ExcelRuntimeError;
+                bridge?: never;
+            } | {
+                ok: boolean;
+                workbookId: WorkbookId;
+                targetPath: string | undefined;
+                backup: {
+                    ok: boolean;
+                    backup: BackupRecord;
+                };
+                bridge: import("@components-kit/open-workbook-protocol").WorkbookFileBridgeResponse;
+                error?: never;
+            } | {
+                file: {
+                    path: string;
+                    size: number;
+                    sliceCount: number;
+                    capturedAt: string;
+                    method: string;
+                };
+                bridge?: import("@components-kit/open-workbook-protocol").WorkbookFileBridgeResponse;
+                ok: boolean;
+                workbookId: WorkbookId;
+                targetPath: string;
+                backup: {
+                    ok: boolean;
+                    backup: BackupRecord;
+                };
+                bridgeStatus: import("@components-kit/open-workbook-protocol").WorkbookFileBridgeStatus;
+                error?: never;
+            } | {
+                error: import("@components-kit/open-workbook-protocol").ExcelRuntimeError;
+                bridge?: import("@components-kit/open-workbook-protocol").WorkbookFileBridgeResponse;
+                ok: boolean;
+                workbookId: WorkbookId;
+                targetPath: string | undefined;
+                backup: {
+                    ok: boolean;
+                    backup: BackupRecord;
+                };
+                bridgeStatus: import("@components-kit/open-workbook-protocol").WorkbookFileBridgeStatus;
+            };
+        };
+        error: import("@components-kit/open-workbook-protocol").ExcelRuntimeError;
+    } | {
+        ok: boolean;
+        workbookId: WorkbookId;
+        backupId: BackupId;
+        mode: "open-as-new";
+        filePath: string;
+        note: string;
+        error?: never;
+        bridgeStatus?: never;
+    } | {
+        ok: boolean;
+        workbookId: WorkbookId;
+        backupId: BackupId;
+        mode: "replace-open-workbook" | "restore-into-open-workbook";
+        error: import("@components-kit/open-workbook-protocol").ExcelRuntimeError;
+        filePath?: never;
+        note?: never;
+        bridgeStatus?: never;
+    } | {
+        ok: boolean;
+        workbookId: WorkbookId;
+        backupId: BackupId;
+        mode: "replace-open-workbook" | "restore-into-open-workbook";
+        bridgeStatus: import("@components-kit/open-workbook-protocol").WorkbookFileBridgeStatus;
+        error: import("@components-kit/open-workbook-protocol").ExcelRuntimeError;
+        filePath?: never;
+        note?: never;
+    }>;
+    private restoreFileBackupThroughBridge;
+    deleteFileBackup(backupId: BackupId): {
+        ok: boolean;
+        error: import("@components-kit/open-workbook-protocol").ExcelRuntimeError;
+        backup?: never;
+        backupId?: never;
+    } | {
+        ok: boolean;
+        backup: BackupRecord;
+        error: import("@components-kit/open-workbook-protocol").ExcelRuntimeError;
+        backupId?: never;
+    } | {
+        ok: boolean;
+        backupId: BackupId;
+        error?: never;
+        backup?: never;
+    };
+    pruneFileBackups(input: WorkbookBackupRetentionRequest): {
+        ok: boolean;
+        dryRun: boolean;
+        candidates: BackupRecord[];
+        pruned?: never;
+    } | {
+        ok: boolean;
+        pruned: BackupId[];
+        dryRun?: never;
+        candidates?: never;
+    };
+    pinFileBackup(backupId: BackupId, pinned: boolean): {
+        ok: boolean;
+        error: import("@components-kit/open-workbook-protocol").ExcelRuntimeError;
+        backup?: never;
+        manifest?: never;
+    } | {
+        ok: boolean;
+        backup: BackupRecord | undefined;
+        manifest: {
+            pinned: boolean;
+            backupId: BackupId;
+            workbookId: WorkbookId;
+            createdAt: string;
+            reason: string;
+            filePath?: string;
+            mode: import("@components-kit/open-workbook-protocol").WorkbookFileBackupMode;
+            size?: number;
+            checksum?: string;
+            sourceSnapshotBackupId?: BackupId;
+            verifiedAt?: string;
+            transactionId?: TransactionId;
+            taskId?: TaskId;
+            agentId?: AgentId;
+            restoreStatus?: "available" | "missing" | "checksum_mismatch" | "unsupported";
+            bridge?: import("@components-kit/open-workbook-protocol").WorkbookFileBridgeResponse;
+            metadata?: Record<string, unknown>;
+        } | undefined;
+        error?: never;
+    };
+    closeWorkbook(workbookId: WorkbookId, closeBehavior?: "Save" | "SkipSave"): Promise<unknown>;
+    readRangeMetadata(method: string, request: RangeMetadataRequest | RangeSearchRequest): Promise<unknown>;
+    listNames(workbookId: WorkbookId): Promise<unknown>;
+    getName(request: NameSelector): Promise<unknown>;
+    createName(request: NameCreateRequest): Promise<{
+        ok: false;
+        transactionId: TransactionId;
+        rollbackAvailable: false;
+        backups: [];
+        warnings: OperationWarning[];
+        telemetry: {
+            warningCount: number;
+        };
+        error: ReturnType<typeof runtimeError>;
+    } | {
+        ok: boolean;
+        backup: {
+            ok: boolean;
+            error: import("@components-kit/open-workbook-protocol").ExcelRuntimeError;
+            snapshot?: never;
+        } | {
+            ok: boolean;
+            snapshot: import("@components-kit/open-workbook-excel-core").WorkbookSnapshotRecord;
+            error?: never;
+        } | {
+            ok: boolean;
+            backup: BackupRecord;
+        };
+        result: unknown;
+    } | {
+        ok: boolean;
+        result: unknown;
+        backup?: never;
+    } | {
+        ok: boolean;
+        error: import("@components-kit/open-workbook-protocol").ExcelRuntimeError;
+    }>;
+    updateName(request: NameUpdateRequest): Promise<{
+        ok: false;
+        transactionId: TransactionId;
+        rollbackAvailable: false;
+        backups: [];
+        warnings: OperationWarning[];
+        telemetry: {
+            warningCount: number;
+        };
+        error: ReturnType<typeof runtimeError>;
+    } | {
+        ok: boolean;
+        backup: {
+            ok: boolean;
+            error: import("@components-kit/open-workbook-protocol").ExcelRuntimeError;
+            snapshot?: never;
+        } | {
+            ok: boolean;
+            snapshot: import("@components-kit/open-workbook-excel-core").WorkbookSnapshotRecord;
+            error?: never;
+        } | {
+            ok: boolean;
+            backup: BackupRecord;
+        };
+        result: unknown;
+    } | {
+        ok: boolean;
+        result: unknown;
+        backup?: never;
+    } | {
+        ok: boolean;
+        error: import("@components-kit/open-workbook-protocol").ExcelRuntimeError;
+    }>;
+    deleteName(request: NameSelector): Promise<{
+        ok: false;
+        transactionId: TransactionId;
+        rollbackAvailable: false;
+        backups: [];
+        warnings: OperationWarning[];
+        telemetry: {
+            warningCount: number;
+        };
+        error: ReturnType<typeof runtimeError>;
+    } | {
+        ok: boolean;
+        result: unknown;
+    } | {
+        ok: boolean;
+        error: import("@components-kit/open-workbook-protocol").ExcelRuntimeError;
+    }>;
+    listPivotTables(workbookId: WorkbookId): Promise<unknown>;
+    getPivotTableInfo(request: PivotSelector): Promise<unknown>;
+    createPivotTable(request: PivotCreateRequest): Promise<{
+        ok: boolean;
+        error: import("@components-kit/open-workbook-protocol").ExcelRuntimeError;
+    } | {
+        ok: boolean;
+        backup: {
+            ok: boolean;
+            error: import("@components-kit/open-workbook-protocol").ExcelRuntimeError;
+            snapshot?: never;
+        } | {
+            ok: boolean;
+            snapshot: import("@components-kit/open-workbook-excel-core").WorkbookSnapshotRecord;
+            error?: never;
+        } | {
+            ok: boolean;
+            backup: BackupRecord;
+        };
+        result: unknown;
+    }>;
+    refreshPivotTable(request: PivotSelector): Promise<unknown>;
+    refreshAllPivotTables(workbookId: WorkbookId): Promise<unknown>;
+    updatePivotSource(request: PivotCreateRequest): {
+        ok: boolean;
+        request: PivotCreateRequest;
+        warnings: OperationWarning[];
+        capabilityStatus: PivotOperationCapabilityStatus;
+        error: import("@components-kit/open-workbook-protocol").ExcelRuntimeError;
+    };
+    copyPivotFromTemplate(request: PivotCopyFromTemplateRequest): Promise<{
+        ok: boolean;
+        snapshot: import("@components-kit/open-workbook-excel-core").WorkbookSnapshotRecord;
+        error?: never;
+    } | {
+        ok: boolean;
+        error: import("@components-kit/open-workbook-protocol").ExcelRuntimeError;
+    } | {
+        ok: boolean;
+        backup: BackupRecord;
+        result: {
+            warnings: OperationWarning[];
+            capabilityStatus: PivotOperationCapabilityStatus;
+            ok: boolean;
+            copied?: string[];
+            source?: PivotTableInfo;
+            target?: PivotTableInfo;
+        };
+        warnings: OperationWarning[];
+        capabilityStatus: PivotOperationCapabilityStatus;
+    } | {
+        ok: boolean;
+        request: PivotCopyFromTemplateRequest;
+        error: import("@components-kit/open-workbook-protocol").ExcelRuntimeError;
+        target?: never;
+        source?: never;
+        issues?: never;
+    } | {
+        ok: boolean;
+        target: unknown;
+        error: import("@components-kit/open-workbook-protocol").ExcelRuntimeError;
+        request?: never;
+        source?: never;
+        issues?: never;
+    } | {
+        ok: boolean;
+        source: unknown;
+        error: import("@components-kit/open-workbook-protocol").ExcelRuntimeError;
+        request?: never;
+        target?: never;
+        issues?: never;
+    } | {
+        ok: boolean;
+        source: unknown;
+        target: unknown;
+        issues: ValidationIssue[];
+        error: import("@components-kit/open-workbook-protocol").ExcelRuntimeError;
+        request?: never;
+    }>;
+    deletePivotTable(request: PivotSelector): Promise<{
+        ok: boolean;
+        snapshot: import("@components-kit/open-workbook-excel-core").WorkbookSnapshotRecord;
+        error?: never;
+    } | {
+        ok: boolean;
+        error: import("@components-kit/open-workbook-protocol").ExcelRuntimeError;
+    } | {
+        ok: boolean;
+        backup: BackupRecord;
+        result: unknown;
+    } | {
+        ok: boolean;
+        target: unknown;
+        error: import("@components-kit/open-workbook-protocol").ExcelRuntimeError;
+    }>;
+    validatePivotSource(request: PivotValidateSourceRequest): Promise<{
+        ok: boolean;
+        info: unknown;
+        summary: {
+            hasSource: boolean;
+            sourceType: string | undefined;
+            hasOutputRange: boolean;
+            hierarchyCount: number;
+            sourceFieldCount: number;
+            sourceFields: string[];
+            rowFields: string[];
+            columnFields: string[];
+            filterFields: string[];
+            dataFields: string[];
+        };
+        issues: {
+            code: string;
+            severity: "info" | "warning" | "error";
+            message: string;
+            details?: Record<string, unknown>;
+        }[];
+    }>;
+    getPivotCapabilityMatrix(workbookId?: WorkbookId): {
+        ok: boolean;
+        matrix: {
+            workbookId: WorkbookId | undefined;
+            hostPlatform: "unknown" | "mac" | "windows" | "web" | undefined;
+            capabilities: ({
+                capability: string;
+                status: string;
+                reason?: never;
+            } | {
+                capability: string;
+                status: string;
+                reason: string;
+            })[];
+        };
+    };
+    getPivotFingerprint(request: PivotSelector): Promise<{
+        ok: boolean;
+        info: unknown;
+        error: import("@components-kit/open-workbook-protocol").ExcelRuntimeError;
+        fingerprint?: never;
+    } | {
+        ok: boolean;
+        fingerprint: PivotFingerprint;
+        info: PivotTableInfo;
+        error?: never;
+    }>;
+    comparePivotFingerprint(request: PivotCompareFingerprintRequest): Promise<{
+        ok: boolean;
+        source: {
+            ok: boolean;
+            info: unknown;
+            error: import("@components-kit/open-workbook-protocol").ExcelRuntimeError;
+            fingerprint?: never;
+        } | {
+            ok: boolean;
+            fingerprint: PivotFingerprint;
+            info: PivotTableInfo;
+            error?: never;
+        };
+        target: {
+            ok: boolean;
+            info: unknown;
+            error: import("@components-kit/open-workbook-protocol").ExcelRuntimeError;
+            fingerprint?: never;
+        } | {
+            ok: boolean;
+            fingerprint: PivotFingerprint;
+            info: PivotTableInfo;
+            error?: never;
+        };
+        error: import("@components-kit/open-workbook-protocol").ExcelRuntimeError;
+        diff?: never;
+    } | {
+        ok: boolean;
+        source: PivotFingerprint;
+        target: PivotFingerprint;
+        diff: PivotDiff;
+        error?: never;
+    }>;
+    diffPivotTables(request: PivotCompareFingerprintRequest): Promise<PivotDiff>;
+    repairPivotFromTemplate(request: PivotRepairFromTemplateRequest): Promise<{
+        ok: boolean;
+        snapshot: import("@components-kit/open-workbook-excel-core").WorkbookSnapshotRecord;
+        error?: never;
+    } | {
+        ok: boolean;
+        error: import("@components-kit/open-workbook-protocol").ExcelRuntimeError;
+    } | {
+        ok: boolean;
+        backup: BackupRecord;
+        result: {
+            warnings: OperationWarning[];
+            capabilityStatus: PivotOperationCapabilityStatus;
+            ok: boolean;
+            copied?: string[];
+            source?: PivotTableInfo;
+            target?: PivotTableInfo;
+        };
+        warnings: OperationWarning[];
+        capabilityStatus: PivotOperationCapabilityStatus;
+    } | {
+        ok: boolean;
+        before: {
+            ok: boolean;
+            source: {
+                ok: boolean;
+                info: unknown;
+                error: import("@components-kit/open-workbook-protocol").ExcelRuntimeError;
+                fingerprint?: never;
+            } | {
+                ok: boolean;
+                fingerprint: PivotFingerprint;
+                info: PivotTableInfo;
+                error?: never;
+            };
+            target: {
+                ok: boolean;
+                info: unknown;
+                error: import("@components-kit/open-workbook-protocol").ExcelRuntimeError;
+                fingerprint?: never;
+            } | {
+                ok: boolean;
+                fingerprint: PivotFingerprint;
+                info: PivotTableInfo;
+                error?: never;
+            };
+            error: import("@components-kit/open-workbook-protocol").ExcelRuntimeError;
+            diff?: never;
+        } | {
+            ok: boolean;
+            source: PivotFingerprint;
+            target: PivotFingerprint;
+            diff: PivotDiff;
+            error?: never;
+        };
+        warnings: OperationWarning[];
+        capabilityStatus: PivotOperationCapabilityStatus;
+        error: import("@components-kit/open-workbook-protocol").ExcelRuntimeError;
+        copy?: never;
+        after?: never;
+    } | {
+        ok: boolean;
+        before: {
+            ok: boolean;
+            source: {
+                ok: boolean;
+                info: unknown;
+                error: import("@components-kit/open-workbook-protocol").ExcelRuntimeError;
+                fingerprint?: never;
+            } | {
+                ok: boolean;
+                fingerprint: PivotFingerprint;
+                info: PivotTableInfo;
+                error?: never;
+            };
+            target: {
+                ok: boolean;
+                info: unknown;
+                error: import("@components-kit/open-workbook-protocol").ExcelRuntimeError;
+                fingerprint?: never;
+            } | {
+                ok: boolean;
+                fingerprint: PivotFingerprint;
+                info: PivotTableInfo;
+                error?: never;
+            };
+            error: import("@components-kit/open-workbook-protocol").ExcelRuntimeError;
+            diff?: never;
+        } | {
+            ok: boolean;
+            source: PivotFingerprint;
+            target: PivotFingerprint;
+            diff: PivotDiff;
+            error?: never;
+        };
+        copy: {
+            ok: boolean;
+            snapshot: import("@components-kit/open-workbook-excel-core").WorkbookSnapshotRecord;
+            error?: never;
+        } | {
+            ok: boolean;
+            error: import("@components-kit/open-workbook-protocol").ExcelRuntimeError;
+        } | {
+            ok: boolean;
+            backup: BackupRecord;
+            result: {
+                warnings: OperationWarning[];
+                capabilityStatus: PivotOperationCapabilityStatus;
+                ok: boolean;
+                copied?: string[];
+                source?: PivotTableInfo;
+                target?: PivotTableInfo;
+            };
+            warnings: OperationWarning[];
+            capabilityStatus: PivotOperationCapabilityStatus;
+        } | {
+            ok: boolean;
+            request: PivotCopyFromTemplateRequest;
+            error: import("@components-kit/open-workbook-protocol").ExcelRuntimeError;
+            target?: never;
+            source?: never;
+            issues?: never;
+        } | {
+            ok: boolean;
+            target: unknown;
+            error: import("@components-kit/open-workbook-protocol").ExcelRuntimeError;
+            request?: never;
+            source?: never;
+            issues?: never;
+        } | {
+            ok: boolean;
+            source: unknown;
+            error: import("@components-kit/open-workbook-protocol").ExcelRuntimeError;
+            request?: never;
+            target?: never;
+            issues?: never;
+        } | {
+            ok: boolean;
+            source: unknown;
+            target: unknown;
+            issues: ValidationIssue[];
+            error: import("@components-kit/open-workbook-protocol").ExcelRuntimeError;
+            request?: never;
+        };
+        after: {
+            ok: boolean;
+            source: {
+                ok: boolean;
+                info: unknown;
+                error: import("@components-kit/open-workbook-protocol").ExcelRuntimeError;
+                fingerprint?: never;
+            } | {
+                ok: boolean;
+                fingerprint: PivotFingerprint;
+                info: PivotTableInfo;
+                error?: never;
+            };
+            target: {
+                ok: boolean;
+                info: unknown;
+                error: import("@components-kit/open-workbook-protocol").ExcelRuntimeError;
+                fingerprint?: never;
+            } | {
+                ok: boolean;
+                fingerprint: PivotFingerprint;
+                info: PivotTableInfo;
+                error?: never;
+            };
+            error: import("@components-kit/open-workbook-protocol").ExcelRuntimeError;
+            diff?: never;
+        } | {
+            ok: boolean;
+            source: PivotFingerprint;
+            target: PivotFingerprint;
+            diff: PivotDiff;
+            error?: never;
+        };
+        warnings: OperationWarning[];
+        capabilityStatus: PivotOperationCapabilityStatus;
+        error?: never;
+    }>;
+    rebuildPivotWithSource(request: PivotRebuildWithSourceRequest): Promise<{
+        ok: boolean;
+        request: PivotRebuildWithSourceRequest;
+        error: import("@components-kit/open-workbook-protocol").ExcelRuntimeError;
+        deleted?: never;
+        created?: never;
+        warnings?: never;
+        capabilityStatus?: never;
+        repaired?: never;
+    } | {
+        ok: boolean;
+        request: PivotRebuildWithSourceRequest;
+        deleted: {
+            ok: boolean;
+            snapshot: import("@components-kit/open-workbook-excel-core").WorkbookSnapshotRecord;
+            error?: never;
+        } | {
+            ok: boolean;
+            error: import("@components-kit/open-workbook-protocol").ExcelRuntimeError;
+        } | {
+            ok: boolean;
+            backup: BackupRecord;
+            result: unknown;
+        } | {
+            ok: boolean;
+            target: unknown;
+            error: import("@components-kit/open-workbook-protocol").ExcelRuntimeError;
+        };
+        error?: never;
+        created?: never;
+        warnings?: never;
+        capabilityStatus?: never;
+        repaired?: never;
+    } | {
+        ok: boolean | undefined;
+        deleted: {
+            ok: boolean;
+            snapshot: import("@components-kit/open-workbook-excel-core").WorkbookSnapshotRecord;
+            error?: never;
+        } | {
+            ok: boolean;
+            error: import("@components-kit/open-workbook-protocol").ExcelRuntimeError;
+        } | {
+            ok: boolean;
+            backup: BackupRecord;
+            result: unknown;
+        } | {
+            ok: boolean;
+            target: unknown;
+            error: import("@components-kit/open-workbook-protocol").ExcelRuntimeError;
+        };
+        created: {
+            ok: boolean;
+            error: import("@components-kit/open-workbook-protocol").ExcelRuntimeError;
+        } | {
+            ok: boolean;
+            backup: {
+                ok: boolean;
+                error: import("@components-kit/open-workbook-protocol").ExcelRuntimeError;
+                snapshot?: never;
+            } | {
+                ok: boolean;
+                snapshot: import("@components-kit/open-workbook-excel-core").WorkbookSnapshotRecord;
+                error?: never;
+            } | {
+                ok: boolean;
+                backup: BackupRecord;
+            };
+            result: unknown;
+        };
+        warnings: OperationWarning[];
+        capabilityStatus: PivotOperationCapabilityStatus;
+        request?: never;
+        error?: never;
+        repaired?: never;
+    } | {
+        ok: boolean | undefined;
+        deleted: {
+            ok: boolean;
+            snapshot: import("@components-kit/open-workbook-excel-core").WorkbookSnapshotRecord;
+            error?: never;
+        } | {
+            ok: boolean;
+            error: import("@components-kit/open-workbook-protocol").ExcelRuntimeError;
+        } | {
+            ok: boolean;
+            backup: BackupRecord;
+            result: unknown;
+        } | {
+            ok: boolean;
+            target: unknown;
+            error: import("@components-kit/open-workbook-protocol").ExcelRuntimeError;
+        };
+        created: {
+            ok: boolean;
+            error: import("@components-kit/open-workbook-protocol").ExcelRuntimeError;
+        } | {
+            ok: boolean;
+            backup: {
+                ok: boolean;
+                error: import("@components-kit/open-workbook-protocol").ExcelRuntimeError;
+                snapshot?: never;
+            } | {
+                ok: boolean;
+                snapshot: import("@components-kit/open-workbook-excel-core").WorkbookSnapshotRecord;
+                error?: never;
+            } | {
+                ok: boolean;
+                backup: BackupRecord;
+            };
+            result: unknown;
+        };
+        repaired: {
+            ok: boolean;
+            snapshot: import("@components-kit/open-workbook-excel-core").WorkbookSnapshotRecord;
+            error?: never;
+        } | {
+            ok: boolean;
+            error: import("@components-kit/open-workbook-protocol").ExcelRuntimeError;
+        } | {
+            ok: boolean;
+            backup: BackupRecord;
+            result: {
+                warnings: OperationWarning[];
+                capabilityStatus: PivotOperationCapabilityStatus;
+                ok: boolean;
+                copied?: string[];
+                source?: PivotTableInfo;
+                target?: PivotTableInfo;
+            };
+            warnings: OperationWarning[];
+            capabilityStatus: PivotOperationCapabilityStatus;
+        } | {
+            ok: boolean;
+            before: {
+                ok: boolean;
+                source: {
+                    ok: boolean;
+                    info: unknown;
+                    error: import("@components-kit/open-workbook-protocol").ExcelRuntimeError;
+                    fingerprint?: never;
+                } | {
+                    ok: boolean;
+                    fingerprint: PivotFingerprint;
+                    info: PivotTableInfo;
+                    error?: never;
+                };
+                target: {
+                    ok: boolean;
+                    info: unknown;
+                    error: import("@components-kit/open-workbook-protocol").ExcelRuntimeError;
+                    fingerprint?: never;
+                } | {
+                    ok: boolean;
+                    fingerprint: PivotFingerprint;
+                    info: PivotTableInfo;
+                    error?: never;
+                };
+                error: import("@components-kit/open-workbook-protocol").ExcelRuntimeError;
+                diff?: never;
+            } | {
+                ok: boolean;
+                source: PivotFingerprint;
+                target: PivotFingerprint;
+                diff: PivotDiff;
+                error?: never;
+            };
+            warnings: OperationWarning[];
+            capabilityStatus: PivotOperationCapabilityStatus;
+            error: import("@components-kit/open-workbook-protocol").ExcelRuntimeError;
+            copy?: never;
+            after?: never;
+        } | {
+            ok: boolean;
+            before: {
+                ok: boolean;
+                source: {
+                    ok: boolean;
+                    info: unknown;
+                    error: import("@components-kit/open-workbook-protocol").ExcelRuntimeError;
+                    fingerprint?: never;
+                } | {
+                    ok: boolean;
+                    fingerprint: PivotFingerprint;
+                    info: PivotTableInfo;
+                    error?: never;
+                };
+                target: {
+                    ok: boolean;
+                    info: unknown;
+                    error: import("@components-kit/open-workbook-protocol").ExcelRuntimeError;
+                    fingerprint?: never;
+                } | {
+                    ok: boolean;
+                    fingerprint: PivotFingerprint;
+                    info: PivotTableInfo;
+                    error?: never;
+                };
+                error: import("@components-kit/open-workbook-protocol").ExcelRuntimeError;
+                diff?: never;
+            } | {
+                ok: boolean;
+                source: PivotFingerprint;
+                target: PivotFingerprint;
+                diff: PivotDiff;
+                error?: never;
+            };
+            copy: {
+                ok: boolean;
+                snapshot: import("@components-kit/open-workbook-excel-core").WorkbookSnapshotRecord;
+                error?: never;
+            } | {
+                ok: boolean;
+                error: import("@components-kit/open-workbook-protocol").ExcelRuntimeError;
+            } | {
+                ok: boolean;
+                backup: BackupRecord;
+                result: {
+                    warnings: OperationWarning[];
+                    capabilityStatus: PivotOperationCapabilityStatus;
+                    ok: boolean;
+                    copied?: string[];
+                    source?: PivotTableInfo;
+                    target?: PivotTableInfo;
+                };
+                warnings: OperationWarning[];
+                capabilityStatus: PivotOperationCapabilityStatus;
+            } | {
+                ok: boolean;
+                request: PivotCopyFromTemplateRequest;
+                error: import("@components-kit/open-workbook-protocol").ExcelRuntimeError;
+                target?: never;
+                source?: never;
+                issues?: never;
+            } | {
+                ok: boolean;
+                target: unknown;
+                error: import("@components-kit/open-workbook-protocol").ExcelRuntimeError;
+                request?: never;
+                source?: never;
+                issues?: never;
+            } | {
+                ok: boolean;
+                source: unknown;
+                error: import("@components-kit/open-workbook-protocol").ExcelRuntimeError;
+                request?: never;
+                target?: never;
+                issues?: never;
+            } | {
+                ok: boolean;
+                source: unknown;
+                target: unknown;
+                issues: ValidationIssue[];
+                error: import("@components-kit/open-workbook-protocol").ExcelRuntimeError;
+                request?: never;
+            };
+            after: {
+                ok: boolean;
+                source: {
+                    ok: boolean;
+                    info: unknown;
+                    error: import("@components-kit/open-workbook-protocol").ExcelRuntimeError;
+                    fingerprint?: never;
+                } | {
+                    ok: boolean;
+                    fingerprint: PivotFingerprint;
+                    info: PivotTableInfo;
+                    error?: never;
+                };
+                target: {
+                    ok: boolean;
+                    info: unknown;
+                    error: import("@components-kit/open-workbook-protocol").ExcelRuntimeError;
+                    fingerprint?: never;
+                } | {
+                    ok: boolean;
+                    fingerprint: PivotFingerprint;
+                    info: PivotTableInfo;
+                    error?: never;
+                };
+                error: import("@components-kit/open-workbook-protocol").ExcelRuntimeError;
+                diff?: never;
+            } | {
+                ok: boolean;
+                source: PivotFingerprint;
+                target: PivotFingerprint;
+                diff: PivotDiff;
+                error?: never;
+            };
+            warnings: OperationWarning[];
+            capabilityStatus: PivotOperationCapabilityStatus;
+            error?: never;
+        };
+        warnings: OperationWarning[];
+        capabilityStatus: PivotOperationCapabilityStatus;
+        request?: never;
+        error?: never;
+    } | {
+        warnings: OperationWarning[];
+        capabilityStatus: PivotOperationCapabilityStatus;
+        ok?: never;
+        request?: never;
+        error?: never;
+        deleted?: never;
+        created?: never;
+        repaired?: never;
+    } | {
+        ok: boolean | undefined;
+        created: {
+            ok: boolean;
+            error: import("@components-kit/open-workbook-protocol").ExcelRuntimeError;
+        } | {
+            ok: boolean;
+            backup: {
+                ok: boolean;
+                error: import("@components-kit/open-workbook-protocol").ExcelRuntimeError;
+                snapshot?: never;
+            } | {
+                ok: boolean;
+                snapshot: import("@components-kit/open-workbook-excel-core").WorkbookSnapshotRecord;
+                error?: never;
+            } | {
+                ok: boolean;
+                backup: BackupRecord;
+            };
+            result: unknown;
+        };
+        repaired: {
+            ok: boolean;
+            snapshot: import("@components-kit/open-workbook-excel-core").WorkbookSnapshotRecord;
+            error?: never;
+        } | {
+            ok: boolean;
+            error: import("@components-kit/open-workbook-protocol").ExcelRuntimeError;
+        } | {
+            ok: boolean;
+            backup: BackupRecord;
+            result: {
+                warnings: OperationWarning[];
+                capabilityStatus: PivotOperationCapabilityStatus;
+                ok: boolean;
+                copied?: string[];
+                source?: PivotTableInfo;
+                target?: PivotTableInfo;
+            };
+            warnings: OperationWarning[];
+            capabilityStatus: PivotOperationCapabilityStatus;
+        } | {
+            ok: boolean;
+            before: {
+                ok: boolean;
+                source: {
+                    ok: boolean;
+                    info: unknown;
+                    error: import("@components-kit/open-workbook-protocol").ExcelRuntimeError;
+                    fingerprint?: never;
+                } | {
+                    ok: boolean;
+                    fingerprint: PivotFingerprint;
+                    info: PivotTableInfo;
+                    error?: never;
+                };
+                target: {
+                    ok: boolean;
+                    info: unknown;
+                    error: import("@components-kit/open-workbook-protocol").ExcelRuntimeError;
+                    fingerprint?: never;
+                } | {
+                    ok: boolean;
+                    fingerprint: PivotFingerprint;
+                    info: PivotTableInfo;
+                    error?: never;
+                };
+                error: import("@components-kit/open-workbook-protocol").ExcelRuntimeError;
+                diff?: never;
+            } | {
+                ok: boolean;
+                source: PivotFingerprint;
+                target: PivotFingerprint;
+                diff: PivotDiff;
+                error?: never;
+            };
+            warnings: OperationWarning[];
+            capabilityStatus: PivotOperationCapabilityStatus;
+            error: import("@components-kit/open-workbook-protocol").ExcelRuntimeError;
+            copy?: never;
+            after?: never;
+        } | {
+            ok: boolean;
+            before: {
+                ok: boolean;
+                source: {
+                    ok: boolean;
+                    info: unknown;
+                    error: import("@components-kit/open-workbook-protocol").ExcelRuntimeError;
+                    fingerprint?: never;
+                } | {
+                    ok: boolean;
+                    fingerprint: PivotFingerprint;
+                    info: PivotTableInfo;
+                    error?: never;
+                };
+                target: {
+                    ok: boolean;
+                    info: unknown;
+                    error: import("@components-kit/open-workbook-protocol").ExcelRuntimeError;
+                    fingerprint?: never;
+                } | {
+                    ok: boolean;
+                    fingerprint: PivotFingerprint;
+                    info: PivotTableInfo;
+                    error?: never;
+                };
+                error: import("@components-kit/open-workbook-protocol").ExcelRuntimeError;
+                diff?: never;
+            } | {
+                ok: boolean;
+                source: PivotFingerprint;
+                target: PivotFingerprint;
+                diff: PivotDiff;
+                error?: never;
+            };
+            copy: {
+                ok: boolean;
+                snapshot: import("@components-kit/open-workbook-excel-core").WorkbookSnapshotRecord;
+                error?: never;
+            } | {
+                ok: boolean;
+                error: import("@components-kit/open-workbook-protocol").ExcelRuntimeError;
+            } | {
+                ok: boolean;
+                backup: BackupRecord;
+                result: {
+                    warnings: OperationWarning[];
+                    capabilityStatus: PivotOperationCapabilityStatus;
+                    ok: boolean;
+                    copied?: string[];
+                    source?: PivotTableInfo;
+                    target?: PivotTableInfo;
+                };
+                warnings: OperationWarning[];
+                capabilityStatus: PivotOperationCapabilityStatus;
+            } | {
+                ok: boolean;
+                request: PivotCopyFromTemplateRequest;
+                error: import("@components-kit/open-workbook-protocol").ExcelRuntimeError;
+                target?: never;
+                source?: never;
+                issues?: never;
+            } | {
+                ok: boolean;
+                target: unknown;
+                error: import("@components-kit/open-workbook-protocol").ExcelRuntimeError;
+                request?: never;
+                source?: never;
+                issues?: never;
+            } | {
+                ok: boolean;
+                source: unknown;
+                error: import("@components-kit/open-workbook-protocol").ExcelRuntimeError;
+                request?: never;
+                target?: never;
+                issues?: never;
+            } | {
+                ok: boolean;
+                source: unknown;
+                target: unknown;
+                issues: ValidationIssue[];
+                error: import("@components-kit/open-workbook-protocol").ExcelRuntimeError;
+                request?: never;
+            };
+            after: {
+                ok: boolean;
+                source: {
+                    ok: boolean;
+                    info: unknown;
+                    error: import("@components-kit/open-workbook-protocol").ExcelRuntimeError;
+                    fingerprint?: never;
+                } | {
+                    ok: boolean;
+                    fingerprint: PivotFingerprint;
+                    info: PivotTableInfo;
+                    error?: never;
+                };
+                target: {
+                    ok: boolean;
+                    info: unknown;
+                    error: import("@components-kit/open-workbook-protocol").ExcelRuntimeError;
+                    fingerprint?: never;
+                } | {
+                    ok: boolean;
+                    fingerprint: PivotFingerprint;
+                    info: PivotTableInfo;
+                    error?: never;
+                };
+                error: import("@components-kit/open-workbook-protocol").ExcelRuntimeError;
+                diff?: never;
+            } | {
+                ok: boolean;
+                source: PivotFingerprint;
+                target: PivotFingerprint;
+                diff: PivotDiff;
+                error?: never;
+            };
+            warnings: OperationWarning[];
+            capabilityStatus: PivotOperationCapabilityStatus;
+            error?: never;
+        };
+        warnings: OperationWarning[];
+        capabilityStatus: PivotOperationCapabilityStatus;
+        request?: never;
+        error?: never;
+        deleted?: never;
+    }>;
+    listCharts(workbookId: WorkbookId): Promise<unknown>;
+    getChartInfo(request: ChartSelector): Promise<unknown>;
+    createChart(request: ChartCreateRequest): Promise<{
+        ok: boolean;
+        error: import("@components-kit/open-workbook-protocol").ExcelRuntimeError;
+    } | {
+        ok: boolean;
+        backup: {
+            ok: boolean;
+            error: import("@components-kit/open-workbook-protocol").ExcelRuntimeError;
+            snapshot?: never;
+        } | {
+            ok: boolean;
+            snapshot: import("@components-kit/open-workbook-excel-core").WorkbookSnapshotRecord;
+            error?: never;
+        } | {
+            ok: boolean;
+            backup: BackupRecord;
+        };
+        result: unknown;
+    }>;
+    updateChartDataSource(request: ChartUpdateDataSourceRequest): Promise<{
+        ok: boolean;
+        error: import("@components-kit/open-workbook-protocol").ExcelRuntimeError;
+    } | {
+        ok: boolean;
+        backup: {
+            ok: boolean;
+            error: import("@components-kit/open-workbook-protocol").ExcelRuntimeError;
+            snapshot?: never;
+        } | {
+            ok: boolean;
+            snapshot: import("@components-kit/open-workbook-excel-core").WorkbookSnapshotRecord;
+            error?: never;
+        } | {
+            ok: boolean;
+            backup: BackupRecord;
+        };
+        result: unknown;
+    }>;
+    copyChartFromTemplate(request: ChartSelector & {
+        templateChartName: string;
+        templateSheetName: string;
+    }): Promise<{
+        ok: boolean;
+        snapshot: import("@components-kit/open-workbook-excel-core").WorkbookSnapshotRecord;
+        error?: never;
+    } | {
+        ok: boolean;
+        error: import("@components-kit/open-workbook-protocol").ExcelRuntimeError;
+    } | {
+        ok: boolean;
+        backup: BackupRecord;
+        result: unknown;
+    }>;
+    refreshChart(request: ChartSelector): Promise<unknown>;
+    deleteChart(request: ChartSelector): Promise<unknown>;
+    validateChartAgainstTemplate(request: ChartSelector & {
+        templateChartName?: string;
+        templateSheetName?: string;
+    }): Promise<{
+        ok: boolean;
+        target: unknown;
+        template: unknown;
+        note: string;
+    }>;
+    detectRegions(workbookId: WorkbookId): Promise<{
+        ok: boolean;
+        registered: WorkbookRegion[];
+        candidates: {
+            workbookId: WorkbookId;
+            name: string;
+            sheetName: string | undefined;
+            address: string;
+            kind: string;
+            source: string;
+        }[];
+        sources: {
+            map: {
+                ok: boolean;
+                error: import("@components-kit/open-workbook-protocol").ExcelRuntimeError;
+                map?: never;
+            } | {
+                ok: boolean;
+                map: unknown;
+                error?: never;
+            };
+            names: unknown;
+        };
+    }>;
+    registerRegion(request: RegionRegisterRequest): Promise<{
+        ok: boolean;
+        region: WorkbookRegion;
+    }>;
+    listRegions(workbookId: WorkbookId): {
+        ok: boolean;
+        regions: WorkbookRegion[];
+    };
+    getRegion(request: RegionSelector): Promise<{
+        ok: boolean;
+        region: WorkbookRegion;
+        error?: never;
+    } | {
+        ok: boolean;
+        error: import("@components-kit/open-workbook-protocol").ExcelRuntimeError;
+        region?: never;
+    }>;
+    clearRegionValues(request: RegionSelector): Promise<OperationResult | {
+        ok: false;
+        error: ReturnType<typeof runtimeError>;
+    }>;
+    writeRegionValues(request: RegionSelector & {
+        values: unknown[][];
+    }): Promise<OperationResult | {
+        ok: false;
+        error: ReturnType<typeof runtimeError>;
+    }>;
+    fillRegion(request: RegionSelector & {
+        values: unknown[][];
+        clearFirst?: boolean;
+    }): Promise<OperationResult | {
+        ok: false;
+        error: ReturnType<typeof runtimeError>;
+    }>;
+    cleanDetectHeaderRow(input: CleanRangeInput & {
+        maxRows?: number;
+    }): Promise<CleaningReport>;
+    cleanNormalizeHeaders(input: CleanRangeInput & {
+        headerRowIndex?: number;
+    }): Promise<CleaningReport>;
+    cleanTrimWhitespace(input: CleanRangeInput): Promise<CleaningReport>;
+    cleanRemoveDuplicates(input: CleanRangeInput & {
+        hasHeader?: boolean;
+        keyColumns?: number[];
+    }): Promise<CleaningReport>;
+    cleanParseDates(input: CleanRangeInput): Promise<CleaningReport>;
+    cleanParseNumbers(input: CleanRangeInput): Promise<CleaningReport>;
+    cleanStandardizeCurrency(input: CleanRangeInput): Promise<CleaningReport>;
+    cleanFillMissingValues(input: CleanRangeInput & {
+        strategy?: "value" | "zero" | "previous" | "next";
+        value?: unknown;
+    }): Promise<CleaningReport>;
+    cleanSplitColumn(input: CleanRangeInput & {
+        columnIndex: number;
+        delimiter?: string;
+        targetAddress: string;
+    }): Promise<CleaningReport>;
+    cleanMergeColumns(input: CleanRangeInput & {
+        columnIndexes: number[];
+        separator?: string;
+        targetAddress: string;
+    }): Promise<CleaningReport>;
+    cleanDetectOutliers(input: CleanRangeInput & {
+        columnIndex?: number;
+        threshold?: number;
+    }): Promise<CleaningReport>;
+    cleanFuzzyMatch(input: CleanRangeInput & {
+        lookupValues: string[];
+        threshold?: number;
+    }): Promise<CleaningReport>;
+    validateWorkbook(input: {
+        workbookId: WorkbookId;
+    }): Promise<ValidationReport>;
+    validateSheet(input: {
+        workbookId: WorkbookId;
+        sheetName: string;
+    }): Promise<ValidationReport>;
+    validateTemplateConsistency(input: {
+        workbookId: WorkbookId;
+        templateId: TemplateId;
+        targetSheetName: string;
+    }): Promise<ValidationReport>;
+    validateFormulas(input: {
+        workbookId: WorkbookId;
+        sheetName?: string;
+        address?: string;
+    }): Promise<ValidationReport>;
+    validateStyles(input: {
+        workbookId: WorkbookId;
+        templateId?: TemplateId;
+        targetSheetName?: string;
+        sheetName?: string;
+    }): Promise<ValidationReport>;
+    validateTables(input: {
+        workbookId: WorkbookId;
+        tableName?: string;
+        templateId?: TemplateId;
+    }): Promise<ValidationReport>;
+    validateFilters(input: {
+        workbookId: WorkbookId;
+        tableName?: string;
+    }): Promise<ValidationReport>;
+    validatePrintLayout(input: {
+        workbookId: WorkbookId;
+        templateId?: TemplateId;
+        targetSheetName?: string;
+    }): ValidationReport;
+    validateNoBrokenReferences(input: {
+        workbookId: WorkbookId;
+        sheetName?: string;
+        address?: string;
+    }): Promise<ValidationReport>;
+    validateNoFormulaErrors(input: {
+        workbookId: WorkbookId;
+        sheetName?: string;
+        address?: string;
+    }): Promise<ValidationReport>;
+    validateNoUnintendedChanges(input: {
+        workbookId: WorkbookId;
+        snapshotId?: SnapshotId;
+        leftSnapshotId?: SnapshotId;
+        rightSnapshotId?: SnapshotId;
+    }): Promise<ValidationReport>;
+    repairStyleFromTemplate(input: {
+        workbookId: WorkbookId;
+        templateId: TemplateId;
+        targetSheetName: string;
+    }): Promise<RepairReport>;
+    repairFormulasFromTemplate(input: {
+        workbookId: WorkbookId;
+        templateId: TemplateId;
+        targetSheetName: string;
+    }): Promise<RepairReport>;
+    repairFiltersFromTemplate(input: {
+        workbookId: WorkbookId;
+        templateId?: TemplateId;
+        targetSheetName?: string;
+    }): RepairReport;
+    repairTableStructure(input: TableCopyStructureRequest): Promise<RepairReport>;
+    repairPrintLayout(input: {
+        workbookId: WorkbookId;
+    }): RepairReport;
+    repairNamedRanges(input: {
+        workbookId: WorkbookId;
+    }): RepairReport;
+    repairFormulaErrors(input: {
+        workbookId: WorkbookId;
+    }): RepairReport;
+    repairMergedCells(input: {
+        workbookId: WorkbookId;
+    }): RepairReport;
+    listTables(workbookId: WorkbookId): Promise<unknown>;
+    getTableInfo(request: TableSelector): Promise<unknown>;
+    readTable(request: TableSelector): Promise<unknown>;
+    createTable(request: TableCreateRequest): Promise<{
+        ok: false;
+        transactionId: TransactionId;
+        rollbackAvailable: false;
+        backups: [];
+        warnings: OperationWarning[];
+        telemetry: {
+            warningCount: number;
+        };
+        error: ReturnType<typeof runtimeError>;
+    } | {
+        ok: boolean;
+        backup: {
+            ok: boolean;
+            error: import("@components-kit/open-workbook-protocol").ExcelRuntimeError;
+            snapshot?: never;
+        } | {
+            ok: boolean;
+            snapshot: import("@components-kit/open-workbook-excel-core").WorkbookSnapshotRecord;
+            error?: never;
+        } | {
+            ok: boolean;
+            backup: BackupRecord;
+        };
+        result: unknown;
+    } | {
+        ok: boolean;
+        error: import("@components-kit/open-workbook-protocol").ExcelRuntimeError;
+        warnings?: never;
+    } | {
+        ok: boolean;
+        error: import("@components-kit/open-workbook-protocol").ExcelRuntimeError;
+        warnings: OperationWarning[];
+    }>;
+    resizeTable(request: TableResizeRequest): Promise<{
+        ok: false;
+        transactionId: TransactionId;
+        rollbackAvailable: false;
+        backups: [];
+        warnings: OperationWarning[];
+        telemetry: {
+            warningCount: number;
+        };
+        error: ReturnType<typeof runtimeError>;
+    } | {
+        ok: boolean;
+        backup: {
+            ok: boolean;
+            error: import("@components-kit/open-workbook-protocol").ExcelRuntimeError;
+            snapshot?: never;
+        } | {
+            ok: boolean;
+            snapshot: import("@components-kit/open-workbook-excel-core").WorkbookSnapshotRecord;
+            error?: never;
+        } | {
+            ok: boolean;
+            backup: BackupRecord;
+        };
+        result: unknown;
+    } | {
+        ok: boolean;
+        error: import("@components-kit/open-workbook-protocol").ExcelRuntimeError;
+        warnings?: never;
+    } | {
+        ok: boolean;
+        error: import("@components-kit/open-workbook-protocol").ExcelRuntimeError;
+        warnings: OperationWarning[];
+    }>;
+    appendTableRows(request: TableAppendRowsRequest): Promise<{
+        ok: false;
+        transactionId: TransactionId;
+        rollbackAvailable: false;
+        backups: [];
+        warnings: OperationWarning[];
+        telemetry: {
+            warningCount: number;
+        };
+        error: ReturnType<typeof runtimeError>;
+    } | {
+        ok: boolean;
+        backup: {
+            ok: boolean;
+            error: import("@components-kit/open-workbook-protocol").ExcelRuntimeError;
+            snapshot?: never;
+        } | {
+            ok: boolean;
+            snapshot: import("@components-kit/open-workbook-excel-core").WorkbookSnapshotRecord;
+            error?: never;
+        } | {
+            ok: boolean;
+            backup: BackupRecord;
+        };
+        result: unknown;
+    } | {
+        ok: boolean;
+        error: import("@components-kit/open-workbook-protocol").ExcelRuntimeError;
+        warnings?: never;
+    } | {
+        ok: boolean;
+        error: import("@components-kit/open-workbook-protocol").ExcelRuntimeError;
+        warnings: OperationWarning[];
+    }>;
+    updateTableRows(request: TableUpdateRowsRequest): Promise<{
+        ok: false;
+        transactionId: TransactionId;
+        rollbackAvailable: false;
+        backups: [];
+        warnings: OperationWarning[];
+        telemetry: {
+            warningCount: number;
+        };
+        error: ReturnType<typeof runtimeError>;
+    } | {
+        ok: boolean;
+        backup: {
+            ok: boolean;
+            error: import("@components-kit/open-workbook-protocol").ExcelRuntimeError;
+            snapshot?: never;
+        } | {
+            ok: boolean;
+            snapshot: import("@components-kit/open-workbook-excel-core").WorkbookSnapshotRecord;
+            error?: never;
+        } | {
+            ok: boolean;
+            backup: BackupRecord;
+        };
+        result: unknown;
+    } | {
+        ok: boolean;
+        error: import("@components-kit/open-workbook-protocol").ExcelRuntimeError;
+        warnings?: never;
+    } | {
+        ok: boolean;
+        error: import("@components-kit/open-workbook-protocol").ExcelRuntimeError;
+        warnings: OperationWarning[];
+    }>;
+    clearTableDataKeepFormulas(request: TableSelector): Promise<{
+        ok: false;
+        transactionId: TransactionId;
+        rollbackAvailable: false;
+        backups: [];
+        warnings: OperationWarning[];
+        telemetry: {
+            warningCount: number;
+        };
+        error: ReturnType<typeof runtimeError>;
+    } | {
+        ok: boolean;
+        backup: {
+            ok: boolean;
+            error: import("@components-kit/open-workbook-protocol").ExcelRuntimeError;
+            snapshot?: never;
+        } | {
+            ok: boolean;
+            snapshot: import("@components-kit/open-workbook-excel-core").WorkbookSnapshotRecord;
+            error?: never;
+        } | {
+            ok: boolean;
+            backup: BackupRecord;
+        };
+        result: unknown;
+    } | {
+        ok: boolean;
+        error: import("@components-kit/open-workbook-protocol").ExcelRuntimeError;
+        warnings?: never;
+    } | {
+        ok: boolean;
+        error: import("@components-kit/open-workbook-protocol").ExcelRuntimeError;
+        warnings: OperationWarning[];
+    }>;
+    clearTableFilters(request: TableSelector): Promise<{
+        ok: false;
+        transactionId: TransactionId;
+        rollbackAvailable: false;
+        backups: [];
+        warnings: OperationWarning[];
+        telemetry: {
+            warningCount: number;
+        };
+        error: ReturnType<typeof runtimeError>;
+    } | {
+        ok: boolean;
+        backup: {
+            ok: boolean;
+            error: import("@components-kit/open-workbook-protocol").ExcelRuntimeError;
+            snapshot?: never;
+        } | {
+            ok: boolean;
+            snapshot: import("@components-kit/open-workbook-excel-core").WorkbookSnapshotRecord;
+            error?: never;
+        } | {
+            ok: boolean;
+            backup: BackupRecord;
+        };
+        result: unknown;
+    } | {
+        ok: boolean;
+        error: import("@components-kit/open-workbook-protocol").ExcelRuntimeError;
+        warnings?: never;
+    } | {
+        ok: boolean;
+        error: import("@components-kit/open-workbook-protocol").ExcelRuntimeError;
+        warnings: OperationWarning[];
+    }>;
+    applyTableFilters(request: TableApplyFiltersRequest): Promise<{
+        ok: false;
+        transactionId: TransactionId;
+        rollbackAvailable: false;
+        backups: [];
+        warnings: OperationWarning[];
+        telemetry: {
+            warningCount: number;
+        };
+        error: ReturnType<typeof runtimeError>;
+    } | {
+        ok: boolean;
+        backup: {
+            ok: boolean;
+            error: import("@components-kit/open-workbook-protocol").ExcelRuntimeError;
+            snapshot?: never;
+        } | {
+            ok: boolean;
+            snapshot: import("@components-kit/open-workbook-excel-core").WorkbookSnapshotRecord;
+            error?: never;
+        } | {
+            ok: boolean;
+            backup: BackupRecord;
+        };
+        result: unknown;
+    } | {
+        ok: boolean;
+        error: import("@components-kit/open-workbook-protocol").ExcelRuntimeError;
+        warnings?: never;
+    } | {
+        ok: boolean;
+        error: import("@components-kit/open-workbook-protocol").ExcelRuntimeError;
+        warnings: OperationWarning[];
+    }>;
+    sortTable(request: TableSortRequest): Promise<{
+        ok: false;
+        transactionId: TransactionId;
+        rollbackAvailable: false;
+        backups: [];
+        warnings: OperationWarning[];
+        telemetry: {
+            warningCount: number;
+        };
+        error: ReturnType<typeof runtimeError>;
+    } | {
+        ok: boolean;
+        backup: {
+            ok: boolean;
+            error: import("@components-kit/open-workbook-protocol").ExcelRuntimeError;
+            snapshot?: never;
+        } | {
+            ok: boolean;
+            snapshot: import("@components-kit/open-workbook-excel-core").WorkbookSnapshotRecord;
+            error?: never;
+        } | {
+            ok: boolean;
+            backup: BackupRecord;
+        };
+        result: unknown;
+    } | {
+        ok: boolean;
+        error: import("@components-kit/open-workbook-protocol").ExcelRuntimeError;
+        warnings?: never;
+    } | {
+        ok: boolean;
+        error: import("@components-kit/open-workbook-protocol").ExcelRuntimeError;
+        warnings: OperationWarning[];
+    }>;
+    clearTableSort(request: TableSelector): Promise<{
+        ok: false;
+        transactionId: TransactionId;
+        rollbackAvailable: false;
+        backups: [];
+        warnings: OperationWarning[];
+        telemetry: {
+            warningCount: number;
+        };
+        error: ReturnType<typeof runtimeError>;
+    } | {
+        ok: boolean;
+        backup: {
+            ok: boolean;
+            error: import("@components-kit/open-workbook-protocol").ExcelRuntimeError;
+            snapshot?: never;
+        } | {
+            ok: boolean;
+            snapshot: import("@components-kit/open-workbook-excel-core").WorkbookSnapshotRecord;
+            error?: never;
+        } | {
+            ok: boolean;
+            backup: BackupRecord;
+        };
+        result: unknown;
+    } | {
+        ok: boolean;
+        error: import("@components-kit/open-workbook-protocol").ExcelRuntimeError;
+        warnings?: never;
+    } | {
+        ok: boolean;
+        error: import("@components-kit/open-workbook-protocol").ExcelRuntimeError;
+        warnings: OperationWarning[];
+    }>;
+    setTableTotalRow(request: TableSetTotalRowRequest): Promise<{
+        ok: false;
+        transactionId: TransactionId;
+        rollbackAvailable: false;
+        backups: [];
+        warnings: OperationWarning[];
+        telemetry: {
+            warningCount: number;
+        };
+        error: ReturnType<typeof runtimeError>;
+    } | {
+        ok: boolean;
+        backup: {
+            ok: boolean;
+            error: import("@components-kit/open-workbook-protocol").ExcelRuntimeError;
+            snapshot?: never;
+        } | {
+            ok: boolean;
+            snapshot: import("@components-kit/open-workbook-excel-core").WorkbookSnapshotRecord;
+            error?: never;
+        } | {
+            ok: boolean;
+            backup: BackupRecord;
+        };
+        result: unknown;
+    } | {
+        ok: boolean;
+        error: import("@components-kit/open-workbook-protocol").ExcelRuntimeError;
+        warnings?: never;
+    } | {
+        ok: boolean;
+        error: import("@components-kit/open-workbook-protocol").ExcelRuntimeError;
+        warnings: OperationWarning[];
+    }>;
+    setTableStyle(request: TableSetStyleRequest): Promise<{
+        ok: false;
+        transactionId: TransactionId;
+        rollbackAvailable: false;
+        backups: [];
+        warnings: OperationWarning[];
+        telemetry: {
+            warningCount: number;
+        };
+        error: ReturnType<typeof runtimeError>;
+    } | {
+        ok: boolean;
+        backup: {
+            ok: boolean;
+            error: import("@components-kit/open-workbook-protocol").ExcelRuntimeError;
+            snapshot?: never;
+        } | {
+            ok: boolean;
+            snapshot: import("@components-kit/open-workbook-excel-core").WorkbookSnapshotRecord;
+            error?: never;
+        } | {
+            ok: boolean;
+            backup: BackupRecord;
+        };
+        result: unknown;
+    } | {
+        ok: boolean;
+        error: import("@components-kit/open-workbook-protocol").ExcelRuntimeError;
+        warnings?: never;
+    } | {
+        ok: boolean;
+        error: import("@components-kit/open-workbook-protocol").ExcelRuntimeError;
+        warnings: OperationWarning[];
+    }>;
+    copyTableStructure(request: TableCopyStructureRequest): Promise<{
+        ok: false;
+        transactionId: TransactionId;
+        rollbackAvailable: false;
+        backups: [];
+        warnings: OperationWarning[];
+        telemetry: {
+            warningCount: number;
+        };
+        error: ReturnType<typeof runtimeError>;
+    } | {
+        ok: boolean;
+        backup: {
+            ok: boolean;
+            error: import("@components-kit/open-workbook-protocol").ExcelRuntimeError;
+            snapshot?: never;
+        } | {
+            ok: boolean;
+            snapshot: import("@components-kit/open-workbook-excel-core").WorkbookSnapshotRecord;
+            error?: never;
+        } | {
+            ok: boolean;
+            backup: BackupRecord;
+        };
+        result: unknown;
+    } | {
+        ok: boolean;
+        error: import("@components-kit/open-workbook-protocol").ExcelRuntimeError;
+        warnings?: never;
+    } | {
+        ok: boolean;
+        error: import("@components-kit/open-workbook-protocol").ExcelRuntimeError;
+        warnings: OperationWarning[];
+    }>;
+    validateTableAgainstTemplate(request: TableSelector & {
+        templateId: TemplateId;
+    }): Promise<{
+        ok: boolean;
+        error: import("@components-kit/open-workbook-protocol").ExcelRuntimeError;
+        table?: never;
+        templateTables?: never;
+        note?: never;
+    } | {
+        ok: boolean;
+        table: unknown;
+        templateTables: unknown;
+        note: string;
+        error?: never;
+    }>;
+    createWorkbookBackup(input: {
+        workbookId: WorkbookId;
+        reason?: string;
+        ranges?: A1Range[];
+    }): Promise<{
+        ok: boolean;
+        error: import("@components-kit/open-workbook-protocol").ExcelRuntimeError;
+        snapshot?: never;
+    } | {
+        ok: boolean;
+        snapshot: import("@components-kit/open-workbook-excel-core").WorkbookSnapshotRecord;
+        error?: never;
+    } | {
+        ok: boolean;
+        backup: BackupRecord;
+    }>;
+    restoreBackup(backupId: BackupId, confirmationToken?: string): Promise<OperationResult>;
+    private mutateTable;
+    private mutateFormulas;
+    private getTableBackupRanges;
+    setActiveWorkbook(workbookIdOrName: string): {
+        ok: boolean;
+        error: import("@components-kit/open-workbook-protocol").ExcelRuntimeError;
+        activeWorkbook?: never;
+    } | {
+        ok: boolean;
+        activeWorkbook: WorkbookRef | undefined;
+        error?: never;
+    };
+    setActiveSheet(sheetName: string): Promise<unknown>;
+    registerTemplate(request: TemplateCaptureRequest): Promise<TemplateRecord>;
+    listTemplates(workbookId?: WorkbookId): TemplateRecord[];
+    getTemplate(templateId: TemplateId): {
+        ok: boolean;
+        error: import("@components-kit/open-workbook-protocol").ExcelRuntimeError;
+        template?: never;
+    } | {
+        ok: boolean;
+        template: TemplateRecord;
+        error?: never;
+    };
+    unregisterTemplate(templateId: TemplateId): {
+        ok: boolean;
+    };
+    exportWorkbookLocalConfig(workbookId: WorkbookId, options?: {
+        includePermissions?: boolean;
+    }): {
+        ok: boolean;
+        workbookId: WorkbookId;
+        config: WorkbookLocalConfig;
+        counts: {
+            templates: number;
+            regions: number;
+            permissions: boolean;
+        };
+    };
+    importWorkbookLocalConfig(request: WorkbookLocalConfigImportRequest): WorkbookLocalConfigImportResponse;
+    embedWorkbookLocalConfig(workbookId: WorkbookId, options?: {
+        includePermissions?: boolean;
+    }): Promise<{
+        ok: boolean;
+        error: import("@components-kit/open-workbook-protocol").ExcelRuntimeError;
+    } | {
+        config: WorkbookLocalConfig;
+        ok: boolean;
+        workbookId: WorkbookId;
+        embedded: boolean;
+        partCount?: number;
+        warnings?: OperationWarning[];
+        error?: import("@components-kit/open-workbook-protocol").ExcelRuntimeError;
+    }>;
+    readWorkbookEmbeddedLocalConfig(workbookId: WorkbookId): Promise<WorkbookEmbeddedLocalConfigResponse>;
+    importWorkbookEmbeddedLocalConfig(input: {
+        workbookId: WorkbookId;
+        includeTemplates?: boolean;
+        includeRegions?: boolean;
+        includePermissions?: boolean;
+        overwrite?: boolean;
+    }): Promise<WorkbookLocalConfigImportResponse | WorkbookEmbeddedLocalConfigResponse>;
+    detectTemplates(workbookId: WorkbookId): Promise<{
+        ok: boolean;
+        error: import("@components-kit/open-workbook-protocol").ExcelRuntimeError;
+        map?: never;
+    } | {
+        ok: boolean;
+        map: unknown;
+        error?: never;
+    } | {
+        ok: boolean;
+        candidates: {
+            workbookId: WorkbookId;
+            sheetName: string;
+            usedRange: {
+                address: string;
+                rowCount: number;
+                columnCount: number;
+            } | undefined;
+            score: number;
+            reason: string;
+        }[];
+    }>;
+    inferTemplateRegions(templateId: TemplateId): {
+        ok: boolean;
+        error: import("@components-kit/open-workbook-protocol").ExcelRuntimeError;
+        templateId?: never;
+        dataRegions?: never;
+        inferredRegions?: never;
+    } | {
+        ok: boolean;
+        templateId: TemplateId;
+        dataRegions: string[];
+        inferredRegions: {
+            address: string;
+            kind: string;
+        }[];
+        error?: never;
+    };
+    validateSheetAgainstTemplate(input: {
+        workbookId: WorkbookId;
+        templateId: TemplateId;
+        targetSheetName: string;
+    }): Promise<TemplateValidationResponse | {
+        ok: false;
+        error: ReturnType<typeof runtimeError>;
+    }>;
+    getSheetTemplateFingerprint(input: {
+        workbookId: WorkbookId;
+        sheetName: string;
+        dataRegions?: string[];
+    }): Promise<{
+        ok: boolean;
+        error: import("@components-kit/open-workbook-protocol").ExcelRuntimeError;
+        fingerprint?: never;
+    } | {
+        ok: boolean;
+        fingerprint: SheetTemplateFingerprintResponse;
+        error?: never;
+    }>;
+    getStyleFingerprint(input: StyleFingerprintRequest): Promise<{
+        ok: true;
+        fingerprint: StyleFingerprintResponse;
+    } | {
+        ok: false;
+        error: ReturnType<typeof runtimeError>;
+    }>;
+    compareStyleFingerprints(input: {
+        workbookId: WorkbookId;
+        sourceSheetName: string;
+        targetSheetName: string;
+        sourceAddress?: string;
+        targetAddress?: string;
+        dimensions?: StyleDimension[];
+        maxCellSamples?: number;
+    }): Promise<StyleCompareResponse | {
+        ok: false;
+        error: ReturnType<typeof runtimeError>;
+    }>;
+    copyStyleDimensions(input: StyleCopyRequest): Promise<{
+        ok: boolean;
+        error: import("@components-kit/open-workbook-protocol").ExcelRuntimeError;
+        warnings?: never;
+        backup?: never;
+        result?: never;
+        validation?: never;
+    } | {
+        ok: boolean;
+        error: import("@components-kit/open-workbook-protocol").ExcelRuntimeError;
+        warnings: OperationWarning[];
+        backup?: never;
+        result?: never;
+        validation?: never;
+    } | {
+        ok: boolean;
+        backup: {
+            ok: boolean;
+            error: import("@components-kit/open-workbook-protocol").ExcelRuntimeError;
+            snapshot?: never;
+        } | {
+            ok: boolean;
+            snapshot: import("@components-kit/open-workbook-excel-core").WorkbookSnapshotRecord;
+            error?: never;
+        } | {
+            ok: boolean;
+            backup: BackupRecord;
+        };
+        result: StyleCopyResponse;
+        validation: StyleCompareResponse | {
+            ok: false;
+            error: ReturnType<typeof runtimeError>;
+        };
+        error?: never;
+        warnings?: never;
+    }>;
+    readFormulaPatterns(input: FormulaPatternRequest): Promise<{
+        ok: true;
+        patterns: FormulaPatternResponse;
+    } | {
+        ok: false;
+        error: ReturnType<typeof runtimeError>;
+    }>;
+    getFormulaDependencyGraph(input: FormulaPatternRequest): Promise<{
+        ok: true;
+        graph: FormulaDependencyGraph;
+    } | {
+        ok: false;
+        error: ReturnType<typeof runtimeError>;
+    }>;
+    traceFormulaPrecedents(input: FormulaPatternRequest): Promise<FormulaTraceResponse | {
+        ok: false;
+        error: ReturnType<typeof runtimeError>;
+    }>;
+    traceFormulaDependents(input: FormulaPatternRequest): Promise<FormulaTraceResponse | {
+        ok: false;
+        error: ReturnType<typeof runtimeError>;
+    }>;
+    private getFormulaGraphTables;
+    compareFormulaPatterns(input: {
+        workbookId: WorkbookId;
+        sourceSheetName: string;
+        targetSheetName: string;
+        sourceAddress?: string;
+        targetAddress?: string;
+    }): Promise<FormulaCompareResponse | {
+        ok: false;
+        error: ReturnType<typeof runtimeError>;
+    }>;
+    copyFormulaPatterns(input: FormulaCopyPatternsRequest): Promise<{
+        ok: false;
+        transactionId: TransactionId;
+        rollbackAvailable: false;
+        backups: [];
+        warnings: OperationWarning[];
+        telemetry: {
+            warningCount: number;
+        };
+        error: ReturnType<typeof runtimeError>;
+    } | {
+        ok: boolean;
+        backup: {
+            ok: boolean;
+            error: import("@components-kit/open-workbook-protocol").ExcelRuntimeError;
+            snapshot?: never;
+        } | {
+            ok: boolean;
+            snapshot: import("@components-kit/open-workbook-excel-core").WorkbookSnapshotRecord;
+            error?: never;
+        } | {
+            ok: boolean;
+            backup: BackupRecord;
+        };
+        result: FormulaMutationResponse;
+        validation: FormulaCompareResponse | {
+            ok: false;
+            error: ReturnType<typeof runtimeError>;
+        } | undefined;
+    } | {
+        ok: boolean;
+        error: import("@components-kit/open-workbook-protocol").ExcelRuntimeError;
+        warnings?: never;
+    } | {
+        ok: boolean;
+        error: import("@components-kit/open-workbook-protocol").ExcelRuntimeError;
+        warnings: OperationWarning[];
+    }>;
+    fillFormulaPattern(input: FormulaFillRequest): Promise<{
+        ok: false;
+        transactionId: TransactionId;
+        rollbackAvailable: false;
+        backups: [];
+        warnings: OperationWarning[];
+        telemetry: {
+            warningCount: number;
+        };
+        error: ReturnType<typeof runtimeError>;
+    } | {
+        ok: boolean;
+        backup: {
+            ok: boolean;
+            error: import("@components-kit/open-workbook-protocol").ExcelRuntimeError;
+            snapshot?: never;
+        } | {
+            ok: boolean;
+            snapshot: import("@components-kit/open-workbook-excel-core").WorkbookSnapshotRecord;
+            error?: never;
+        } | {
+            ok: boolean;
+            backup: BackupRecord;
+        };
+        result: FormulaMutationResponse;
+        validation: FormulaCompareResponse | {
+            ok: false;
+            error: ReturnType<typeof runtimeError>;
+        } | undefined;
+    } | {
+        ok: boolean;
+        error: import("@components-kit/open-workbook-protocol").ExcelRuntimeError;
+        warnings?: never;
+    } | {
+        ok: boolean;
+        error: import("@components-kit/open-workbook-protocol").ExcelRuntimeError;
+        warnings: OperationWarning[];
+    }>;
+    convertFormulasToValues(input: FormulaPatternRequest): Promise<{
+        ok: false;
+        transactionId: TransactionId;
+        rollbackAvailable: false;
+        backups: [];
+        warnings: OperationWarning[];
+        telemetry: {
+            warningCount: number;
+        };
+        error: ReturnType<typeof runtimeError>;
+    } | {
+        ok: boolean;
+        backup: {
+            ok: boolean;
+            error: import("@components-kit/open-workbook-protocol").ExcelRuntimeError;
+            snapshot?: never;
+        } | {
+            ok: boolean;
+            snapshot: import("@components-kit/open-workbook-excel-core").WorkbookSnapshotRecord;
+            error?: never;
+        } | {
+            ok: boolean;
+            backup: BackupRecord;
+        };
+        result: FormulaMutationResponse;
+        validation: FormulaCompareResponse | {
+            ok: false;
+            error: ReturnType<typeof runtimeError>;
+        } | undefined;
+    } | {
+        ok: boolean;
+        error: import("@components-kit/open-workbook-protocol").ExcelRuntimeError;
+        warnings?: never;
+    } | {
+        ok: boolean;
+        error: import("@components-kit/open-workbook-protocol").ExcelRuntimeError;
+        warnings: OperationWarning[];
+    }>;
+    repairSheetFromTemplate(input: {
+        workbookId: WorkbookId;
+        templateId: TemplateId;
+        targetSheetName: string;
+        repair?: AddinTemplateRepairRequest["repair"];
+    }): Promise<{
+        ok: boolean;
+        error: import("@components-kit/open-workbook-protocol").ExcelRuntimeError;
+        backup?: never;
+        result?: never;
+        validation?: never;
+    } | {
+        ok: boolean;
+        backup: {
+            ok: boolean;
+            error: import("@components-kit/open-workbook-protocol").ExcelRuntimeError;
+            snapshot?: never;
+        } | {
+            ok: boolean;
+            snapshot: import("@components-kit/open-workbook-excel-core").WorkbookSnapshotRecord;
+            error?: never;
+        } | {
+            ok: boolean;
+            backup: BackupRecord;
+        };
+        result: unknown;
+        validation: TemplateValidationResponse | {
+            ok: false;
+            error: ReturnType<typeof runtimeError>;
+        };
+        error?: never;
+    }>;
+    applyPlan(planId: PlanId, confirmationToken?: string): Promise<OperationResult>;
+    rollbackPlan(planId: PlanId, confirmationToken?: string): Promise<OperationResult>;
+    applyBatch(request: BatchRequest): Promise<OperationResult>;
+    private enqueueTransaction;
+    private enqueueRuntimeMutation;
+    private applyDirectTransaction;
+    private applyBatchDirect;
+    private cleanTransform;
+    private readRangeValues;
+    private writeCleanValues;
+    private validateBatchPermissions;
+    private validatePermissionScope;
+    private validateLockedRegions;
+    private validateDirectMutation;
+    private templateRepairReport;
+    private getActiveAddinClient;
+    private resolveTemplateSources;
+    private createRollbackOperations;
+    private getUsedRangesForSnapshot;
+    private getSheetUsedRange;
+    private getPivotTemplateCopyRanges;
+    private getFormulaMutationRanges;
+    private getValidationRanges;
+    private resolveRegion;
+    private persistBackupPayload;
+    private loadBackupPayload;
+    private getBackupDirectory;
+    private getExportDirectory;
+    private defaultWorkbookExportPath;
+    private defaultWorkbookFileBackupPath;
+    private writeWorkbookFileContent;
+    private hashFile;
+    private unlinkBackupPayloadIfSafe;
+}
+interface CleanRangeInput {
+    workbookId: WorkbookId;
+    sheetName: string;
+    address: string;
+}
+export {};
+//# sourceMappingURL=runtime-service.d.ts.map