import { type GenerationArtifact } from "./installation/generation-plan.js";
import { type ManagerCandidateInstallerOptions } from "./manager-runtime/installer.js";
import type { ServiceScope } from "./service-definition.js";
import type { ServiceHost } from "./service-host.js";
export interface ManagerUpgradeCandidateRequest {
    id: string;
    scope: ServiceScope;
    expectedPreviousDigest: string;
    archiveSha256: string;
    artifacts: {
        host: GenerationArtifact;
        core: GenerationArtifact;
    };
    archives: {
        host: {
            bytes: Buffer;
            sha256: string;
        };
        core: {
            bytes: Buffer;
            sha256: string;
        };
    };
}
export interface ManagerUpgradeCandidateDependencies {
    download?: ManagerCandidateInstallerOptions["download"];
}
export interface PreparedManagerUpgradeCandidate {
    operationId: string;
    candidateDirectory: string;
    candidateDigest: string;
    targetVersion: string;
    archiveSha256?: string;
    coreArchiveSha256?: string;
}
export type ManagerUpgradeCandidateRejectionCode = "INVALID_REQUEST" | "SERVICE_METADATA_INVALID" | "ACTIVE_CANDIDATE_INVALID" | "ARTIFACT_INPUT_INVALID" | "CANDIDATE_STORE_INVALID" | "OPERATION_CONFLICT" | "ARTIFACT_INPUT_FAILED" | "CANDIDATE_ALLOCATION_FAILED" | "DOWNLOAD_FAILED" | "VERIFICATION_FAILED" | "CANDIDATE_RECEIPT_INVALID" | "CANDIDATE_ENTRY_INVALID" | "CANDIDATE_INVALID" | "PREFLIGHT_FAILED";
export declare class ManagerUpgradeCandidateRejectedError extends Error {
    readonly code: ManagerUpgradeCandidateRejectionCode;
    constructor(code?: unknown);
}
export declare class ManagerUpgradeCandidateUnknownError extends Error {
}
/**
 * 在独立不可变仓库中准备管理程序候选。意图先于下载持久化；相同操作只查询原安装，
 * 不会因为进程重启或下载结果未知而重新派发 npm/pnpm 外部效果。
 */
export declare function prepareManagerUpgradeCandidate(request: ManagerUpgradeCandidateRequest, host: ServiceHost, dependencies?: ManagerUpgradeCandidateDependencies): Promise<PreparedManagerUpgradeCandidate>;
/** 断网恢复只读取原意图、安装操作与已验证收据；不解析发布源、不写回缺失确认。 */
export declare function resumeManagerUpgradeCandidate(id: string, scope: ServiceScope, expectedPreviousDigest: string, host: ServiceHost, expectedVersion?: string): Promise<PreparedManagerUpgradeCandidate>;
//# sourceMappingURL=manager-service-upgrade-preparation.d.ts.map