export type GovernanceAuditAction = "pass" | "reject" | "override" | "approval" | "delegation" | "exception";
export type GovernanceAuditActorKind = "application" | "official-module" | "runtime-surface" | "operator" | "external-control";
export type GovernanceAuditBoundary = "input" | "contract" | "governance" | "runtime-state" | "scope";
export type GovernanceAuditErrorCode = "MISSING_RUNTIME_ID" | "MISSING_ACTOR" | "MISSING_ACTION" | "MISSING_SUBJECT" | "RUNTIME_NOT_READY";
export type GovernanceAuditActor = {
    kind: GovernanceAuditActorKind;
    id: string;
};
export type GovernanceAuditEntry = {
    auditId: string;
    runtimeId: string;
    actor: GovernanceAuditActor;
    action: GovernanceAuditAction;
    subject: string;
    summary: string;
    evidenceRefs: readonly string[];
    occurredAt: string;
    replayable: true;
    safeForInspection: true;
    internalDetailExposed: false;
};
export type GovernanceAuditTrailRequest = {
    runtimeId?: string;
    actor?: GovernanceAuditActor;
    action?: GovernanceAuditAction;
    subject?: string;
    summary?: string;
    evidenceRefs?: readonly string[];
    previousEntries?: readonly GovernanceAuditEntry[];
    occurredAt?: string;
    runtimeReady?: boolean;
    internalDetail?: unknown;
};
export type GovernanceAuditTrailError = {
    code: GovernanceAuditErrorCode;
    message: string;
    boundary: GovernanceAuditBoundary;
    safeForInspection: true;
    internalDetailExposed: false;
};
export type GovernanceAuditReplay = {
    cursor: string;
    entries: readonly GovernanceAuditEntry[];
};
export type GovernanceAuditTrailResult = {
    ok: true;
    entry: GovernanceAuditEntry;
    trail: readonly GovernanceAuditEntry[];
    replay: GovernanceAuditReplay;
    events: readonly string[];
} | {
    ok: false;
    error: GovernanceAuditTrailError;
    events: readonly string[];
};
export declare function recordGovernanceAuditTrail(request?: GovernanceAuditTrailRequest): GovernanceAuditTrailResult;
