@pidgeon-ai/sdk 1.35.0 → 1.37.0

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/CHANGELOG.md CHANGED
@@ -7,6 +7,41 @@ the two would publish a release for every unrelated product deploy.
7
7
  Semver applies to **this package's own surface** — the exported names, the
8
8
  call shapes, the result shape — not to the API behind it.
9
9
 
10
+ ## 1.37.0 — every endpoint keeps the API's promises
11
+
12
+ - **Every write takes an `Idempotency-Key` header**, not only the sends and
13
+ the creates: every `PATCH`, `PUT` and `DELETE`, and the other `POST`s.
14
+ Each declares the `409` (`idempotency_in_progress`,
15
+ `idempotency_mismatch`) and the test-mode `504`. A retried delete replays
16
+ "deleted" instead of answering `404`. Unauthenticated agent signup and
17
+ `keysRotate` are the exceptions.
18
+ - **Every list pages to the end.** `domainsList` and `webhooksList` honour
19
+ the `limit` and `cursor` they always declared; `webhooksDeliveries`,
20
+ `draftsList`, `calendarListEvents`, `calendarGetAgenda`,
21
+ `calendarListEventInstances` and `messagesSearch` take `cursor` and answer
22
+ `next_cursor`. Each used to stop at `limit` with `has_more: false`. A
23
+ calendar window holding more than 1,000 events is a `400` naming
24
+ `before`; search reads the 1,000 best matches.
25
+ - `appPasswordsCreate` answers `AppPasswordCreated`, with the `username` and
26
+ `password` it always returned. `password` and `WebhookCreated.secret` are
27
+ `string | null`: null on an `Idempotency-Key` replay, because neither is
28
+ stored. Check them before storing.
29
+ - `MailboxChange` carries the listing row's fields, as the endpoint always
30
+ sent them.
31
+ - A `400` names the field you sent: an unknown key by its name, and in
32
+ `snake_case` (`send_at`, not `sendAt`). Every `429` carries
33
+ `X-RateLimit-Limit`, `-Remaining` and `-Reset` beside `Retry-After`.
34
+
35
+ ## 1.36.0 — the mail a domain already receives
36
+
37
+ `domainsCreate` answers `existing_mail`: who already receives mail for the
38
+ domain, read from its MX — `{ provider, name, hosts }`, with `provider` one of
39
+ `google`, `microsoft`, `zoho`, `fastmail`, `proton`, `icloud`, `godaddy` or
40
+ `other` — or null when nothing does. When it is set and `inbound_enabled` is
41
+ true, publishing the MX record stops that mail arriving at the provider. Send
42
+ `inbound_enabled: false`, or add a subdomain such as `agents.` instead.
43
+ Additive.
44
+
10
45
  ## 1.35.0 — a key says what it is, and minting is idempotent
11
46
 
12
47
  - `meGet` returns `key.test`, `key.rotated_at` and