foldrun 20.9.1 → 20.9.2
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/docs/notifications.md +7 -1
- package/package.json +1 -1
package/docs/notifications.md
CHANGED
|
@@ -51,6 +51,12 @@ another's webhook flow and be accepted. Name no secret and nothing is
|
|
|
51
51
|
signed, which is what every existing destination keeps doing. How to check
|
|
52
52
|
it is under [Verifying a delivery](#verifying-a-delivery).
|
|
53
53
|
|
|
54
|
+
A question an agent asks mid-step (`tools: [ask]`) goes out as
|
|
55
|
+
`awaiting-approval`, as a gate does, and its webhook body also carries
|
|
56
|
+
`reason: "question"` and `question: { text, options, agent }`, so a receiver
|
|
57
|
+
can tell the two apart and show the question. `events: [asking]` subscribes
|
|
58
|
+
to questions alone, without the gates.
|
|
59
|
+
|
|
54
60
|
The default events are `failed` and `awaiting-approval`. `completed` is
|
|
55
61
|
opt-in on purpose: a schedule that works is the quiet kind of good news, and
|
|
56
62
|
a channel that pings on every success gets muted — which un-pings the
|
|
@@ -240,7 +246,7 @@ Every attempt carries these headers:
|
|
|
240
246
|
| header | |
|
|
241
247
|
|---|---|
|
|
242
248
|
| `X-Foldrun-Delivery` | the delivery's id, `dlv_…` — **the same on every attempt and every redelivery**. Dedupe on it: a receiver that took attempt 2 but timed out answering may see attempt 3 |
|
|
243
|
-
| `X-Foldrun-Event` | `failed`, `completed`, `blocked`, `awaiting-approval
|
|
249
|
+
| `X-Foldrun-Event` | `failed`, `completed`, `blocked`, `awaiting-approval` (a question too: its body has `reason: "question"`), `quarantined`, `sla`, `budget`, `room`, or `test` |
|
|
244
250
|
| `X-Foldrun-Attempt` | 1, 2, … |
|
|
245
251
|
| `X-Foldrun-Timestamp`, `X-Foldrun-Signature` | when `signing_secret:` is set — see below |
|
|
246
252
|
|