Interface IAuditLogger

interface IAuditLogger {
    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;
    flush(): Promise<void>;
    close(): Promise<void>;
}