GuardrailVerdictEvent

@forge/monorepo

---

@forge/monorepo / backend/src / GuardrailVerdictEvent

Type Alias: GuardrailVerdictEvent

GuardrailVerdictEvent = EventBase<"guardrail.verdict"> & object

Defined in: backend/src/core/events.ts:166

What a guardrail concluded — REQ-046 (#205).

Emitted for every verdict, including a pass, because "no guardrail ran" and "a guardrail ran and allowed it" are different facts and an incident review needs to tell them apart.

Carries no inspected value, ever. what names fields or entity types; the content that was redacted is precisely what must not travel into an event log, a trace, or a support ticket — otherwise the audit trail becomes the leak it exists to record.

Type Declaration

code?

readonly optional code?: string

For a refusal.

guardrail

readonly guardrail: string

outcome

readonly outcome: "pass" | "redacted" | "refused"

subject

readonly subject: "input" | "message" | "tool-call" | "tool-result"

threw?

readonly optional threw?: boolean

True when the guardrail threw and was therefore treated as a refusal.

what?

readonly optional what?: readonly string[]

For a redaction: the fields or entity types touched. Never their contents.