Type Alias: AuditSinkDisposition

AuditSinkDisposition = "forwarded" | "discarded" | "caller-supplied"

Defined in: src/types/gateway-governance.ts:24

What a GatewayClient does with the hook layer's audit events — record, recordResult and scanPrompts (AAASM-5681).

The hook layer calls those methods on every governed action. Whether anything leaves the process is a property of the client underneath, and until this type existed the SDK had no way to say so: every method returns Promise<void>, which is indistinguishable from success whether the event was sent or dropped.

Not a boolean, because the SDK can only speak for clients it built, and because "sent" and "dropped" are not the whole vocabulary. "caller-supplied" is not an assurance that the events are retained — it is the absence of a claim.

No value here earns ADR 0033 §6 Observed. §6's evidence column requires a durable event attributed to the action, and the SDK cannot establish that from this side — see the note on "forwarded". The strongest claim available to this type is about where the event was handed, not where it ended up.

The downstream half of that gap is tracked as AAASM-5783 and is unfixed: today report_event payloads reach neither the live stream nor the durable entry. Revisit these terms when it lands — not before.