export type BuilderBranchReadbackStage = "status_request" | "status_shape" | "status_binding" | "status_no_backup" | "status_currentness" | "post_read_status_request" | "post_read_status_shape" | "post_read_status_binding" | "post_read_status_currentness" | "download_url_request" | "download_url_shape" | "download_url_binding" | "bundle_download" | "bundle_read" | "bundle_digest" | "bundle_parse" | "target_subtree_missing" | "post_read_currentness";
export declare class BuilderBranchFilesError extends Error {
    readonly code: "invalid_request" | "not_connected" | "forbidden" | "unavailable" | "unverified" | "integrity_failed";
    readonly readbackStage?: BuilderBranchReadbackStage | undefined;
    constructor(code: "invalid_request" | "not_connected" | "forbidden" | "unavailable" | "unverified" | "integrity_failed", message: string, readbackStage?: BuilderBranchReadbackStage | undefined);
}
type BranchRef = {
    projectId: string;
    branchName: string;
};
export declare function readBuilderBranchBackupStatus(input: BranchRef): Promise<{
    branchState: "active" | "archived" | "deleted" | "unknown";
    backupPartial: "invalid" | "missing" | boolean;
    backupValid: boolean;
    backupComplete: boolean;
    backupCurrent: boolean;
    agentIdle: boolean;
    hasUnpushedChanges: boolean;
    verificationPerformed: false;
}>;
export declare function readBuilderBranchFiles(input: BranchRef & {
    appPath: string;
}): Promise<{
    commitSha: string;
    files: Array<{
        path: string;
        mode: string;
        content: Uint8Array;
    }>;
    projectId: string;
    branchName: string;
}>;
export {};