FlowGuard API - v1.2.0-rc.2
    Preparing search index...

    Interface ChainedAuditEvent

    Extended audit event with hash chain fields. These fields are added by the factory functions and stored in the JSONL trail.

    Hash chain integrity:

    • prevHash: hash of the previous event (or "genesis" for the first event)
    • chainHash: SHA-256(prevHash + JSON(this event without chainHash))
    • To verify: recompute chainHash from prevHash + event data, compare

    Actor identity (P27):

    • actor: Classification label — "human", "machine", or "system" (backward-compat string)
    • actorInfo: Optional structured identity (id, email, source). Present on human-influenced events (lifecycle, tool_call, decision). Absent on machine-only events (transition, error). When absent, JSON.stringify omits the field — chain hash stays identical for pre-P27 events.
    interface ChainedAuditEvent {
        id: string;
        sessionId: string;
        phase: string;
        event: string;
        timestamp: string;
        actor: string;
        actorInfo?: Readonly<
            {
                id: string;
                email: string
                | null;
                displayName?: string | null;
                source: "unknown" | "env" | "git" | "claim" | "oidc";
                assurance: "best_effort" | "claim_validated" | "idp_verified";
                verificationMeta?: Readonly<
                    {
                        issuer: string;
                        audience: string[];
                        keyId: string;
                        algorithm: string;
                        verifiedAt: string;
                    },
                >;
            },
        >;
        detail: Readonly<Record<string, unknown>>;
        prevHash: string;
        chainHash: string;
    }
    Index

    Properties

    id sessionId phase event timestamp actor actorInfo? detail prevHash chainHash

    Properties

    id: string
    sessionId: string
    phase: string
    event: string
    timestamp: string
    actor: string
    actorInfo?: Readonly<
        {
            id: string;
            email: string
            | null;
            displayName?: string | null;
            source: "unknown" | "env" | "git" | "claim" | "oidc";
            assurance: "best_effort" | "claim_validated" | "idp_verified";
            verificationMeta?: Readonly<
                {
                    issuer: string;
                    audience: string[];
                    keyId: string;
                    algorithm: string;
                    verifiedAt: string;
                },
            >;
        },
    >
    detail: Readonly<Record<string, unknown>>
    prevHash: string
    chainHash: string

    Settings

    Member Visibility

    On This Page

    Properties