TriggerMessage

Defined in: types.ts:319

One message a trigger can post: a room, the agent to mention, the body template, and — webhook triggers only — a CEL match: predicate gating whether this message fires for a given delivery. See [[ZOD085]] §Design 4.

Properties

room

room: string

Defined in: types.ts:321

Room id or alias the message goes to.

---

mention

mention: string

Defined in: types.ts:323

Agent name (key in agents) to mention. Structural, never templated — §Design 3.

---

text

text: string

Defined in: types.ts:325

The message body. Literal for a scheduled trigger; ${...} is CEL-interpolated for a webhook trigger.

---

match?

optional match?: string

Defined in: types.ts:331

CEL predicate over the delivery (event, body, headers, output). Absent means always fire. Only valid on a webhook: trigger — a schedule trigger has no delivery to evaluate.

---

ttlMs?

optional ttlMs?: number

Defined in: types.ts:340

How long a fired copy of this message stays worth answering, in ms. Stamped onto the posted event as dev.zooid.trigger.ttl_ms; a receiving daemon that comes back after this window drops it rather than replaying stale work — see [[ZOD087]] §TTL policy. Defaults to 6h for a schedule: trigger and no expiry for a webhook: trigger; overridable per trigger with expires_after:.