Every event is a CloudEvent 1.0: the same envelope and, inside data, what is specific to each event. id is the idempotency key (it comes from the work, not from chance) and subject is the workspace, so a consumer can drop duplicates and process in order per workspace. Names follow ai.qomni.<domain>.<object>.<action>.v<n>.
Envelope
CloudEvents 1.0 as every qomni event uses it (STYLE.md, events). Each event schema is this envelope plus its type and its data. id is the idempotency key, derived from the work; subject is the workspace slug, so brokers partition by workspace; time is when it happened.
| Field | Type | Detail |
|---|---|---|
specversion Required |
string | "1.0" |
id Required |
string | ≤ 200 |
source Required |
string | Who publishes it, e.g. /cells/co1/agents |
type Required |
string | |
time Required |
string | date-time |
datacontenttype Required |
string | "application/json" |
subject Required |
string | The workspace slug. |
livemode Optional |
boolean | CloudEvents extension: false for test-mode work. |
traceparent Optional |
string | CloudEvents distributed-tracing extension. |
data Required |
object |
Shared objects
Objects several events carry inside data.
actor
Who or what acted: an agent, a member, an API key (its ID, never the key) or the system.
| Field | Type | Detail |
|---|---|---|
type Required |
string | agent, member, api_key, system |
id Required |
string | |
on_behalf_of Optional |
string | The member an API key or an approved agent action acts for. |
subject
| Field | Type | Detail |
|---|---|---|
type Required |
string | agent, conversation, call, phone_number |
id Required |
string |