export declare const CORE_RUN_ID_PATTERN: RegExp;
export declare const LATEST_POINTER_SCHEMA = "humanish.latest-run.v1";
export declare const HISTORY_ENTRY_SCHEMA = "humanish.run-history-entry.v1";
export type CoreRunMode = "dry-run" | "live";
export interface BuildRunIdOptions {
    prefix: string;
    createdAt: Date | string;
    entropy: string;
}
export interface ArtifactLayout {
    artifactRoot: string;
    run: string;
    reviewJson: string;
    reviewMarkdown: string;
    observerData: string;
    events: string;
    latestPointer: string;
}
export interface LatestRunPointer {
    schema: typeof LATEST_POINTER_SCHEMA;
    runId: string;
    path: string;
    updatedAt: string;
}
export interface RunHistoryEntry {
    schema: typeof HISTORY_ENTRY_SCHEMA;
    runId: string;
    createdAt: string;
    mode: CoreRunMode;
    path: string;
}
export interface CoreLifecycleEvent {
    at: string;
    event: string;
    message: string;
}
export interface TimingSummary {
    startedAt: string;
    endedAt: string | null;
    durationMs: number | null;
    status: "running" | "complete";
}
export declare function buildRunId(options: BuildRunIdOptions): string;
export declare function isValidRunId(value: string): boolean;
export declare function assertRunId(value: string): void;
export declare function buildArtifactLayout(runId: string, runsRoot?: string): ArtifactLayout;
export declare function createLatestPointer(options: {
    runId: string;
    artifactRoot: string;
    updatedAt: Date | string;
}): LatestRunPointer;
export declare function createHistoryEntry(options: {
    runId: string;
    createdAt: Date | string;
    mode: CoreRunMode;
    artifactRoot: string;
}): RunHistoryEntry;
export declare function createLifecycleEvent(options: {
    at: Date | string;
    event: string;
    message: string;
}): CoreLifecycleEvent;
export declare function summarizeTiming(options: {
    startedAt: Date | string;
    endedAt?: Date | string;
}): TimingSummary;