Class AuditLogger

new AuditLogger(
    config: {
        logDir: string;
        filePrefix: string;
        maxFileSizeBytes: number;
        maxFiles: number;
        enableHashChain: boolean;
        enableCompression: boolean;
        flushIntervalMs: number;
        minSeverity: "info" | "warning" | "critical";
        categories?: (
            | "authorization"
            | "system"
            | "configuration"
            | "security"
            | "authentication"
            | "tool_invocation"
            | "data_access"
            | "data_modification"
        )[];
    },
    storage?: IAuditStorage,
    logger?: ILogger,
): AuditLogger

log(
    input: {
        category:
            | "authorization"
            | "system"
            | "configuration"
            | "security"
            | "authentication"
            | "tool_invocation"
            | "data_access"
            | "data_modification";
        severity: "info"
        | "warning"
        | "critical";
        outcome: "error" | "success" | "failure" | "denied";
        action: string;
        description?: string;
        actor: {
            type: "system" | "user" | "external" | "agent";
            id: string;
            name?: string;
            ip?: string;
            userAgent?: string;
        };
        resource?: { type: string; id: string; name?: string; path?: string };
        requestId?: string;
        traceId?: string;
        sessionId?: string;
        toolName?: string;
        durationMs?: number;
        metadata?: Record<string, unknown>;
        policyName?: string;
        policyDecision?: string;
        violationType?: string;
    },
): void

logToolInvocation(opts: ToolInvocationAuditOpts): void

logPolicyDecision(opts: PolicyDecisionAuditOpts): void

logSecurityEvent(opts: SecurityEventAuditOpts): void

logRateLimitViolation(opts: RateLimitAuditOpts): void

logSystemStartup(metadata?: Record<string, unknown>): void

logSystemShutdown(metadata?: Record<string, unknown>): void

flush(): Promise<void>

close(): Promise<void>