Interface: AuditEvent

Defined in: src/types/audit.ts:51

A single governance-relevant occurrence in the gateway audit trail.

Focused subset of the proto assembly.audit.v1.AuditEvent message — exposes the scalar identifying fields, labels, and the new callStack field added in AAASM-1419. The proto's detail oneof (LLM / tool / file-op / network / process / violation / approval variants) and the full lineage block are intentionally out of scope here; they will land as separate follow-up Tasks if a Node consumer needs them.

Properties

actionType

actionType: string

Defined in: src/types/audit.ts:61

High-level action category — e.g. "llm_call", "tool_call", "file_op". Open-ended on the wire (proto enum, surfaced as a normalized string).

---

agentId

agentId: string

Defined in: src/types/audit.ts:55

Identity string of the agent that produced this event.

---

callStack?

optional callStack?: CallStackNode[]

Defined in: src/types/audit.ts:80

Hierarchical record of LLM / tool / result steps that led to this event. Empty array (or undefined) when the producer did not record a stack. Renders inline beneath an expanded Live Ops row.

---

decision

decision: string

Defined in: src/types/audit.ts:66

Policy engine verdict — e.g. "allow", "deny", "redact". Open-ended on the wire.

---

eventId

eventId: string

Defined in: src/types/audit.ts:53

Unique identifier for this audit record (UUID v7).

---

labels?

optional labels?: Record<string, string>

Defined in: src/types/audit.ts:74

Arbitrary key/value labels attached at event creation.

---

parentSpanId?

optional parentSpanId?: string

Defined in: src/types/audit.ts:72

Distributed tracing parent span identifier. Empty when this is a root span.

---

spanId?

optional spanId?: string

Defined in: src/types/audit.ts:70

Distributed tracing action-level identifier. Empty string when unset.

---

traceId?

optional traceId?: string

Defined in: src/types/audit.ts:68

Distributed tracing run-level identifier. Empty string when unset.