import type { WorkflowResumePoint } from '../../models/types.js';
import type { WorkflowTraceDiscovery } from '../observability/traceDiscovery.js';
import { type AgentFailureCategory } from '../../../shared/types/agent-failure.js';
import { type PullRequestContext } from '../pr-context.js';
export interface RunMetaObservability {
    traceDiscovery: WorkflowTraceDiscovery;
}
export declare const RUN_RESUME_MODES: readonly ["requeue", "retry", "instruct"];
export type RunResumeMode = (typeof RUN_RESUME_MODES)[number];
export interface RunResumeSource {
    readonly sourceRunSlug?: string;
    readonly resumeMode: RunResumeMode;
}
export interface RunFailure {
    readonly step: string;
    readonly error: string;
    readonly failureCategory?: AgentFailureCategory;
}
export interface RunMeta {
    task: string;
    workflow: string;
    runSlug: string;
    runRoot: string;
    reportDirectory: string;
    contextDirectory: string;
    logsDirectory: string;
    status: 'running' | 'completed' | 'aborted' | 'failed';
    reason?: string;
    failure?: RunFailure;
    startTime: string;
    endTime?: string;
    iterations?: number;
    currentStep?: string;
    currentIteration?: number;
    phase?: 1 | 2 | 3;
    updatedAt?: string;
    observability?: RunMetaObservability;
    resumePoint?: WorkflowResumePoint;
    sourceRunSlug?: string;
    resumeMode?: RunResumeSource['resumeMode'];
    /** resume-artifacts.json（継承 manifest）への相対パス。SSOT は manifest 側。 */
    resumeArtifacts?: string;
    operationJournalRunSlug?: string;
    operationClaimToken?: string;
    prContext?: PullRequestContext;
}
export declare const RESUMABLE_RUN_STATUSES: readonly ["aborted", "failed"];
export declare function isResumableRunStatus(status: RunMeta['status']): status is (typeof RESUMABLE_RUN_STATUSES)[number];
export type RunMetaWarningHandler = (warning: string) => void;
export declare function parseRunMeta(value: unknown): RunMeta;
export declare function readRunMeta(metaPath: string, onWarning?: RunMetaWarningHandler): RunMeta | null;
export declare function readRunMetaBySlug(cwd: string, slug: string, onWarning?: RunMetaWarningHandler, runsDirectory?: string): RunMeta | null;
export declare function findRunningStepByRunSlug(cwd: string, runSlug: string, onWarning?: RunMetaWarningHandler): string | undefined;
//# sourceMappingURL=run-meta.d.ts.map