import type { Rfc64SelectedSwmGraphSyncStatus } from '@origintrail-official/dkg-agent';
import type { CatchupJobResult } from './catchup-runner.js';
export declare const CATCHUP_JOB_STATES: readonly ["queued", "running", "done", "failed", "denied", "deferred", "partial", "unreachable"];
export type CatchupJobState = typeof CATCHUP_JOB_STATES[number];
/** Closed pre-`jobStatus` vocabulary retained for older API clients. */
export declare const LEGACY_CATCHUP_JOB_STATES: readonly ["queued", "running", "done", "failed", "denied", "deferred", "unreachable"];
export type LegacyCatchupJobState = typeof LEGACY_CATCHUP_JOB_STATES[number];
/** Explicit public response shape for the catch-up status endpoint. */
export interface CatchupStatusResponse {
    readonly jobId: string;
    readonly contextGraphId: string;
    /** Legacy request field retained on the wire. */
    readonly includeWorkspace: boolean;
    readonly includeSharedMemory: boolean;
    /** Closed legacy status vocabulary for older clients. */
    readonly status: LegacyCatchupJobState;
    /** Precise bounded-job outcome for upgraded clients. */
    readonly jobStatus: CatchupJobState;
    readonly queuedAt: number;
    readonly startedAt?: number;
    readonly finishedAt?: number;
    readonly result?: CatchupJobResult;
    readonly error?: string;
    /** VM is inapplicable only under the current allowed unregistered authority. */
    readonly durablePlane?: 'required' | 'not-applicable';
    readonly graphSync?: Rfc64SelectedSwmGraphSyncStatus;
    /**
     * Set when the job was requested for an on-chain name hash that resolved to
     * its verified cleartext id while it ran; the job continued under that id.
     */
    readonly resolvedContextGraphId?: string;
    /** Present when the requested id is (or was) known only by its name hash. */
    readonly identity?: CatchupContextGraphIdentity;
}
/** Operator-facing identity of a name-hash subscription (additive field). */
export interface CatchupContextGraphIdentity {
    readonly state: 'name-hash-only' | 'name-hash-only-private' | 'resolved';
    readonly nameHash: string;
    readonly onChainId?: string;
    readonly contextGraphId?: string;
    readonly message: string;
}
/**
 * Present on a subscribe response when the request named an on-chain numeric
 * id (`32`, `#32`); `subscribed` carries the graph it named (additive field).
 */
export interface ContextGraphOnChainReferenceNote {
    readonly onChainId: string;
    readonly message: string;
}
/** Older daemons can omit newer aliases; the client normalizes them at the boundary. */
export type CatchupStatusWireResponse = Omit<CatchupStatusResponse, 'includeSharedMemory' | 'jobStatus'> & {
    readonly includeSharedMemory?: boolean;
    readonly jobStatus?: CatchupJobState;
};
/** One terminality contract for daemon telemetry and CLI watch behavior. */
export declare const CATCHUP_TERMINAL_STATES: ReadonlySet<CatchupJobState>;
export declare function isTerminalCatchupJobState(state: CatchupJobState): boolean;
/** Preserve the pre-`jobStatus` wire vocabulary for older clients. */
export declare function toLegacyCatchupJobState(state: CatchupJobState): LegacyCatchupJobState;
//# sourceMappingURL=catchup-status.d.ts.map