@ingenx-io/valets-schema-mcp-server 0.1.7 → 0.1.9

package/data/docs/models/site.md

@@ -546,7 +546,7 @@ Do not include in write requests. This field is set exclusively by the server (F
 **Description:** Timestamp of the most recent analytics event seen for this site.
 
 ----------------------------------------------------------------------------------------------------------------------------
-Generated using [json-schema-for-humans](https://github.com/coveooss/json-schema-for-humans) on 2026-05-15 at 16:32:39 +0000
+Generated using [json-schema-for-humans](https://github.com/coveooss/json-schema-for-humans) on 2026-05-16 at 00:18:16 +0000
 
 :::warning Server-set
 Do not include in write requests. This field is set exclusively by the server (Firestore trigger or Admin SDK). Clients that send it will have the value silently ignored or may receive a validation error.

package/data/docs/models/stocktake-item.md

@@ -497,4 +497,4 @@ Read-time hint snapshot of the verifier's display name (GH#29 §3 / Q10).
 | **Required** | No     |
 
 ----------------------------------------------------------------------------------------------------------------------------
-Generated using [json-schema-for-humans](https://github.com/coveooss/json-schema-for-humans) on 2026-05-15 at 16:32:39 +0000
+Generated using [json-schema-for-humans](https://github.com/coveooss/json-schema-for-humans) on 2026-05-16 at 00:18:16 +0000

package/data/docs/models/stocktake.md

@@ -642,7 +642,7 @@ Read-time hint snapshot of the completer's display name (GH#29 §3 / Q10).
 | **Required** | No     |
 
 ----------------------------------------------------------------------------------------------------------------------------
-Generated using [json-schema-for-humans](https://github.com/coveooss/json-schema-for-humans) on 2026-05-15 at 16:32:39 +0000
+Generated using [json-schema-for-humans](https://github.com/coveooss/json-schema-for-humans) on 2026-05-16 at 00:18:16 +0000
 
 :::warning Server-set
 Do not include in write requests. This field is set exclusively by the server (Firestore trigger or Admin SDK). Clients that send it will have the value silently ignored or may receive a validation error.

package/data/docs/models/ticket.md

@@ -388,7 +388,7 @@ Do not include in write requests. This field is set exclusively by the server (F
 **Description:** (Immutable) FK → User/staff UID who created this ticket.
 
 ----------------------------------------------------------------------------------------------------------------------------
-Generated using [json-schema-for-humans](https://github.com/coveooss/json-schema-for-humans) on 2026-05-15 at 16:32:39 +0000
+Generated using [json-schema-for-humans](https://github.com/coveooss/json-schema-for-humans) on 2026-05-16 at 00:18:16 +0000
 
 :::info Immutable
 Set at creation only. This field cannot be modified after the document is created. Include it in CREATE payloads; omit it (or leave unchanged) in UPDATE payloads.

package/data/docs/models/whatsapp-inbound-message.md

@@ -60,23 +60,23 @@ sidebar_position: 28
 | **Additional properties** | Not allowed                            |
 | **Defined in**            | #/definitions/whatsapp-inbound-message |
 
-**Description:** WhatsappInboundMessage — inbound WhatsApp message persisted from Meta Cloud API webhook (GH#36). Collection: whatsapp_inbound_messages/\{docId\} in ratenplate project. Top-level scope: company resolution happens post-ingestion.
-
-| Property                     | Pattern | Type             | Deprecated | Definition                           | Title/Description                                                                                               |
-| ---------------------------- | ------- | ---------------- | ---------- | ------------------------------------ | --------------------------------------------------------------------------------------------------------------- |
-| - [id](#id )                 | No      | string or null   | No         | -                                    | (Read-only) Firestore document ID — wamid from Meta Cloud API.                                                  |
-| + [wabaId](#wabaId )         | No      | string           | No         | -                                    | (Immutable) Meta WABA ID identifying which business number received the message.                                |
-| + [waba](#waba )             | No      | enum (of string) | No         | In #/definitions/waba-label          | (Immutable) Human-readable WABA label (cmz \| val). See WabaLabel enum.                                         |
-| + [messageId](#messageId )   | No      | string           | No         | -                                    | (Immutable) WhatsApp message ID (wamid) returned by Meta — mirrors the document ID.                             |
-| + [from](#from )             | No      | string           | No         | -                                    | (Immutable) Sender phone number in E.164 format.                                                                |
-| + [type](#type )             | No      | Combination      | No         | -                                    | (Immutable) Meta message type.                                                                                  |
-| + [timestamp](#timestamp )   | No      | object           | No         | In #/definitions/firestore-timestamp | (Immutable) Message timestamp as reported by Meta.                                                              |
-| + [receivedAt](#receivedAt ) | No      | object           | No         | In #/definitions/firestore-timestamp | (Read-only) Server-side ingestion time set by the Cloud Function.                                               |
-| - [text](#text )             | No      | string or null   | No         | -                                    | Message body text. Present on type=text messages only.                                                          |
-| - [mediaId](#mediaId )       | No      | string or null   | No         | -                                    | Meta media ID. Present on image, audio, video, document, sticker messages.                                      |
-| - [caption](#caption )       | No      | string or null   | No         | -                                    | Media caption text. Present when the sender included a caption.                                                 |
-| - [storageUrl](#storageUrl ) | No      | string or null   | No         | -                                    | Durable Cloud Storage URL for the downloaded media binary. Present after the CF downloads and stores the media. |
-| - [context](#context )       | No      | object or null   | No         | -                                    | Reply/forward context. Present on replies and forwarded messages.                                               |
+**Description:** WhatsappInboundMessage — inbound WhatsApp message persisted from Meta Cloud API webhook (GH#36). Collection: whatsapp_inbound_messages/\{docId\}. Top-level scope: company resolution happens post-ingestion.
+
+| Property                     | Pattern | Type             | Deprecated | Definition                           | Title/Description                                                                                                           |
+| ---------------------------- | ------- | ---------------- | ---------- | ------------------------------------ | --------------------------------------------------------------------------------------------------------------------------- |
+| - [id](#id )                 | No      | string or null   | No         | -                                    | (Read-only) Firestore document ID — wamid from Meta Cloud API.                                                              |
+| + [wabaId](#wabaId )         | No      | string           | No         | -                                    | (Immutable) Meta WABA ID identifying which business number received the message.                                            |
+| + [waba](#waba )             | No      | enum (of string) | No         | In #/definitions/waba-label          | (Immutable) Human-readable WABA label (cmz \| val). See WabaLabel enum.                                                     |
+| + [messageId](#messageId )   | No      | string           | No         | -                                    | (Immutable) WhatsApp message ID (wamid) returned by Meta — mirrors the document ID.                                         |
+| + [from](#from )             | No      | string           | No         | -                                    | (Immutable) Sender phone number in E.164 format.                                                                            |
+| + [type](#type )             | No      | Combination      | No         | -                                    | (Immutable) Meta message type.                                                                                              |
+| + [timestamp](#timestamp )   | No      | object           | No         | In #/definitions/firestore-timestamp | (Immutable) Message timestamp as reported by Meta.                                                                          |
+| + [receivedAt](#receivedAt ) | No      | object           | No         | In #/definitions/firestore-timestamp | (Read-only) Server-side ingestion timestamp.                                                                                |
+| - [text](#text )             | No      | string or null   | No         | -                                    | Message body text. Present on type=text messages only.                                                                      |
+| - [mediaId](#mediaId )       | No      | string or null   | No         | -                                    | Meta media ID. Present on image, audio, video, document, sticker messages.                                                  |
+| - [caption](#caption )       | No      | string or null   | No         | -                                    | Media caption text. Present when the sender included a caption.                                                             |
+| - [storageUrl](#storageUrl ) | No      | string or null   | No         | -                                    | Durable Cloud Storage URL for the downloaded media binary. Present after the media has been fetched and stored server-side. |
+| - [context](#context )       | No      | object or null   | No         | -                                    | Reply/forward context. Present on replies and forwarded messages.                                                           |
 
 ## <a name="id"></a>1. Property `id`
 
@@ -250,7 +250,7 @@ Set at creation only. This field cannot be modified after the document is create
 | **Additional properties** | Not allowed                       |
 | **Defined in**            | #/definitions/firestore-timestamp |
 
-**Description:** (Read-only) Server-side ingestion time set by the Cloud Function.
+**Description:** (Read-only) Server-side ingestion timestamp.
 
 | Property                                   | Pattern | Type    | Deprecated | Definition | Title/Description |
 | ------------------------------------------ | ------- | ------- | ---------- | ---------- | ----------------- |
@@ -319,7 +319,7 @@ Do not include in write requests. This field is set exclusively by the server (F
 | **Type**     | `string or null` |
 | **Required** | No               |
 
-**Description:** Durable Cloud Storage URL for the downloaded media binary. Present after the CF downloads and stores the media.
+**Description:** Durable Cloud Storage URL for the downloaded media binary. Present after the media has been fetched and stored server-side.
 
 ## <a name="context"></a>13. Property `context`
 
@@ -366,4 +366,4 @@ Do not include in write requests. This field is set exclusively by the server (F
 Specific value: `true`
 
 ----------------------------------------------------------------------------------------------------------------------------
-Generated using [json-schema-for-humans](https://github.com/coveooss/json-schema-for-humans) on 2026-05-15 at 16:32:39 +0000
+Generated using [json-schema-for-humans](https://github.com/coveooss/json-schema-for-humans) on 2026-05-16 at 00:18:16 +0000

package/data/docs/models/whatsapp-outbound-message.md

@@ -0,0 +1,365 @@
+---
+title: "WhatsappOutboundMessage"
+sidebar_label: "WhatsappOutboundMessage"
+sidebar_position: 29
+---
+
+# WhatsappOutboundMessage
+
+<details>
+<summary>Example JSON</summary>
+
+```json
+{
+  "id": null,
+  "messageId": "mes_ref123",
+  "to": "to",
+  "waba": "waba",
+  "wabaId": "wab_ref123",
+  "sentAt": "sentAt",
+  "phoneNumberId": "pho_ref123",
+  "kind": "kind",
+  "templateName": "templateName",
+  "status": "status",
+  "contactWaId": null,
+  "appId": null,
+  "orderUuid": null,
+  "statusUpdatedAt": "statusUpdatedAt",
+  "failureCode": null,
+  "failureErrors": null
+}
+```
+
+</details>
+
+
+- [1. Property `id`](#id)
+- [2. Property `messageId`](#messageId)
+- [3. Property `to`](#to)
+- [4. Property `waba`](#waba)
+- [5. Property `wabaId`](#wabaId)
+- [6. Property `sentAt`](#sentAt)
+  - [6.1. Property `_seconds`](#sentAt__seconds)
+  - [6.2. Property `_nanoseconds`](#sentAt__nanoseconds)
+- [7. Property `phoneNumberId`](#phoneNumberId)
+- [8. Property `kind`](#kind)
+- [9. Property `templateName`](#templateName)
+- [10. Property `status`](#status)
+- [11. Property `contactWaId`](#contactWaId)
+- [12. Property `appId`](#appId)
+- [13. Property `orderUuid`](#orderUuid)
+- [14. Property `statusUpdatedAt`](#statusUpdatedAt)
+  - [14.1. Property `firestore-timestamp`](#statusUpdatedAt_anyOf_i0)
+  - [14.2. Property `item 1`](#statusUpdatedAt_anyOf_i1)
+- [15. Property `failureCode`](#failureCode)
+- [16. Property `failureErrors`](#failureErrors)
+  - [16.1. failureErrors items](#failureErrors_items)
+
+|                           |                                         |
+| ------------------------- | --------------------------------------- |
+| **Type**                  | `object`                                |
+| **Required**              | No                                      |
+| **Additional properties** | Not allowed                             |
+| **Defined in**            | #/definitions/whatsapp-outbound-message |
+
+**Description:** WhatsappOutboundMessage — outbound WhatsApp message persisted at send time (GH#38). Collection: whatsapp_outbound_messages/\{docId\}. Top-level scope. Symmetric counterpart to WhatsappInboundMessage (GH#36).
+
+| Property                               | Pattern | Type             | Deprecated | Definition                               | Title/Description                                                                   |
+| -------------------------------------- | ------- | ---------------- | ---------- | ---------------------------------------- | ----------------------------------------------------------------------------------- |
+| - [id](#id )                           | No      | string or null   | No         | -                                        | (Read-only) Firestore document ID — wamid on success, generated UUID on failure.    |
+| + [messageId](#messageId )             | No      | string           | No         | -                                        | (Immutable) WhatsApp message ID (wamid) on success; generated UUID on send failure. |
+| + [to](#to )                           | No      | string           | No         | -                                        | (Immutable) Recipient phone number in E.164 format. Mirrors inbound \`from\`.       |
+| + [waba](#waba )                       | No      | enum (of string) | No         | In #/definitions/waba-label              | (Immutable) WABA that sent the message. Mirrors inbound \`waba\`.                   |
+| + [wabaId](#wabaId )                   | No      | string           | No         | -                                        | (Immutable) Meta WABA ID. Mirrors inbound \`wabaId\`.                               |
+| + [sentAt](#sentAt )                   | No      | object           | No         | In #/definitions/firestore-timestamp     | (Read-only) Server-side send timestamp. Mirrors inbound \`receivedAt\`.             |
+| + [phoneNumberId](#phoneNumberId )     | No      | string           | No         | -                                        | (Immutable) Meta phone number ID used for the send (specific line within the WABA). |
+| + [kind](#kind )                       | No      | enum (of string) | No         | In #/definitions/outbound-message-kind   | (Immutable) Message kind.                                                           |
+| + [templateName](#templateName )       | No      | string           | No         | -                                        | (Immutable) WhatsApp template name used for the send.                               |
+| + [status](#status )                   | No      | enum (of string) | No         | In #/definitions/outbound-message-status | Delivery status. Updated in-place by Meta delivery callbacks.                       |
+| - [contactWaId](#contactWaId )         | No      | string or null   | No         | -                                        | Normalized wa_id returned by Meta on success. May differ from \`to\`.               |
+| - [appId](#appId )                     | No      | string or null   | No         | -                                        | Tenant appId when applicable.                                                       |
+| - [orderUuid](#orderUuid )             | No      | string or null   | No         | -                                        | Order reference. Present on review_request messages only.                           |
+| - [statusUpdatedAt](#statusUpdatedAt ) | No      | Combination      | No         | -                                        | Timestamp of the last status update from a Meta delivery callback.                  |
+| - [failureCode](#failureCode )         | No      | integer or null  | No         | -                                        | Meta error code. Present on failed sends only.                                      |
+| - [failureErrors](#failureErrors )     | No      | array or null    | No         | -                                        | Raw Meta error objects. Present on failed sends only.                               |
+
+## <a name="id"></a>1. Property `id`
+
+|              |                  |
+| ------------ | ---------------- |
+| **Type**     | `string or null` |
+| **Required** | No               |
+
+**Description:** (Read-only) Firestore document ID — wamid on success, generated UUID on failure.
+
+:::warning Server-set
+Do not include in write requests. This field is set exclusively by the server (Firestore trigger or Admin SDK). Clients that send it will have the value silently ignored or may receive a validation error.
+:::
+
+## <a name="messageId"></a>2. Property `messageId`
+
+|              |          |
+| ------------ | -------- |
+| **Type**     | `string` |
+| **Required** | Yes      |
+
+**Description:** (Immutable) WhatsApp message ID (wamid) on success; generated UUID on send failure.
+
+:::info Immutable
+Set at creation only. This field cannot be modified after the document is created. Include it in CREATE payloads; omit it (or leave unchanged) in UPDATE payloads.
+:::
+
+## <a name="to"></a>3. Property `to`
+
+|              |          |
+| ------------ | -------- |
+| **Type**     | `string` |
+| **Required** | Yes      |
+
+**Description:** (Immutable) Recipient phone number in E.164 format. Mirrors inbound `from`.
+
+:::info Immutable
+Set at creation only. This field cannot be modified after the document is created. Include it in CREATE payloads; omit it (or leave unchanged) in UPDATE payloads.
+:::
+
+## <a name="waba"></a>4. Property `waba`
+
+|                |                          |
+| -------------- | ------------------------ |
+| **Type**       | `enum (of string)`       |
+| **Required**   | Yes                      |
+| **Defined in** | #/definitions/waba-label |
+
+**Description:** (Immutable) WABA that sent the message. Mirrors inbound `waba`.
+
+Must be one of:
+* "cmz"
+* "val"
+
+:::info Immutable
+Set at creation only. This field cannot be modified after the document is created. Include it in CREATE payloads; omit it (or leave unchanged) in UPDATE payloads.
+:::
+
+## <a name="wabaId"></a>5. Property `wabaId`
+
+|              |          |
+| ------------ | -------- |
+| **Type**     | `string` |
+| **Required** | Yes      |
+
+**Description:** (Immutable) Meta WABA ID. Mirrors inbound `wabaId`.
+
+:::info Immutable
+Set at creation only. This field cannot be modified after the document is created. Include it in CREATE payloads; omit it (or leave unchanged) in UPDATE payloads.
+:::
+
+## <a name="sentAt"></a>6. Property `sentAt`
+
+|                           |                                   |
+| ------------------------- | --------------------------------- |
+| **Type**                  | `object`                          |
+| **Required**              | Yes                               |
+| **Additional properties** | Not allowed                       |
+| **Defined in**            | #/definitions/firestore-timestamp |
+
+**Description:** (Read-only) Server-side send timestamp. Mirrors inbound `receivedAt`.
+
+| Property                                | Pattern | Type    | Deprecated | Definition | Title/Description |
+| --------------------------------------- | ------- | ------- | ---------- | ---------- | ----------------- |
+| + [_seconds](#sentAt__seconds )         | No      | integer | No         | -          | -                 |
+| + [_nanoseconds](#sentAt__nanoseconds ) | No      | integer | No         | -          | -                 |
+
+### <a name="sentAt__seconds"></a>6.1. Property `_seconds`
+
+|              |           |
+| ------------ | --------- |
+| **Type**     | `integer` |
+| **Required** | Yes       |
+
+| Restrictions |                        |
+| ------------ | ---------------------- |
+| **Minimum**  | &ge; -9007199254740991 |
+| **Maximum**  | &le; 9007199254740991  |
+
+### <a name="sentAt__nanoseconds"></a>6.2. Property `_nanoseconds`
+
+|              |           |
+| ------------ | --------- |
+| **Type**     | `integer` |
+| **Required** | Yes       |
+
+| Restrictions |                        |
+| ------------ | ---------------------- |
+| **Minimum**  | &ge; -9007199254740991 |
+| **Maximum**  | &le; 9007199254740991  |
+
+:::warning Server-set
+Do not include in write requests. This field is set exclusively by the server (Firestore trigger or Admin SDK). Clients that send it will have the value silently ignored or may receive a validation error.
+:::
+
+## <a name="phoneNumberId"></a>7. Property `phoneNumberId`
+
+|              |          |
+| ------------ | -------- |
+| **Type**     | `string` |
+| **Required** | Yes      |
+
+**Description:** (Immutable) Meta phone number ID used for the send (specific line within the WABA).
+
+:::info Immutable
+Set at creation only. This field cannot be modified after the document is created. Include it in CREATE payloads; omit it (or leave unchanged) in UPDATE payloads.
+:::
+
+## <a name="kind"></a>8. Property `kind`
+
+|                |                                     |
+| -------------- | ----------------------------------- |
+| **Type**       | `enum (of string)`                  |
+| **Required**   | Yes                                 |
+| **Defined in** | #/definitions/outbound-message-kind |
+
+**Description:** (Immutable) Message kind.
+
+Must be one of:
+* "otp"
+* "review_request"
+
+:::info Immutable
+Set at creation only. This field cannot be modified after the document is created. Include it in CREATE payloads; omit it (or leave unchanged) in UPDATE payloads.
+:::
+
+## <a name="templateName"></a>9. Property `templateName`
+
+|              |          |
+| ------------ | -------- |
+| **Type**     | `string` |
+| **Required** | Yes      |
+
+**Description:** (Immutable) WhatsApp template name used for the send.
+
+:::info Immutable
+Set at creation only. This field cannot be modified after the document is created. Include it in CREATE payloads; omit it (or leave unchanged) in UPDATE payloads.
+:::
+
+## <a name="status"></a>10. Property `status`
+
+|                |                                       |
+| -------------- | ------------------------------------- |
+| **Type**       | `enum (of string)`                    |
+| **Required**   | Yes                                   |
+| **Defined in** | #/definitions/outbound-message-status |
+
+**Description:** Delivery status. Updated in-place by Meta delivery callbacks.
+
+Must be one of:
+* "accepted"
+* "sent"
+* "delivered"
+* "read"
+* "failed"
+
+## <a name="contactWaId"></a>11. Property `contactWaId`
+
+|              |                  |
+| ------------ | ---------------- |
+| **Type**     | `string or null` |
+| **Required** | No               |
+
+**Description:** Normalized wa_id returned by Meta on success. May differ from `to`.
+
+## <a name="appId"></a>12. Property `appId`
+
+|              |                  |
+| ------------ | ---------------- |
+| **Type**     | `string or null` |
+| **Required** | No               |
+
+**Description:** Tenant appId when applicable.
+
+## <a name="orderUuid"></a>13. Property `orderUuid`
+
+|              |                  |
+| ------------ | ---------------- |
+| **Type**     | `string or null` |
+| **Required** | No               |
+
+**Description:** Order reference. Present on review_request messages only.
+
+## <a name="statusUpdatedAt"></a>14. Property `statusUpdatedAt`
+
+|                           |                  |
+| ------------------------- | ---------------- |
+| **Type**                  | `combining`      |
+| **Required**              | No               |
+| **Additional properties** | Any type allowed |
+
+**Description:** Timestamp of the last status update from a Meta delivery callback.
+
+| Any of(Option)                                   |
+| ------------------------------------------------ |
+| [firestore-timestamp](#statusUpdatedAt_anyOf_i0) |
+| [item 1](#statusUpdatedAt_anyOf_i1)              |
+
+### <a name="statusUpdatedAt_anyOf_i0"></a>14.1. Property `firestore-timestamp`
+
+|                           |                   |
+| ------------------------- | ----------------- |
+| **Type**                  | `object`          |
+| **Required**              | No                |
+| **Additional properties** | Not allowed       |
+| **Same definition as**    | [sentAt](#sentAt) |
+
+**Description:** Firestore Timestamp serialized representation
+
+### <a name="statusUpdatedAt_anyOf_i1"></a>14.2. Property `item 1`
+
+|              |        |
+| ------------ | ------ |
+| **Type**     | `null` |
+| **Required** | No     |
+
+## <a name="failureCode"></a>15. Property `failureCode`
+
+|              |                   |
+| ------------ | ----------------- |
+| **Type**     | `integer or null` |
+| **Required** | No                |
+
+**Description:** Meta error code. Present on failed sends only.
+
+| Restrictions |                        |
+| ------------ | ---------------------- |
+| **Minimum**  | &ge; -9007199254740991 |
+| **Maximum**  | &le; 9007199254740991  |
+
+## <a name="failureErrors"></a>16. Property `failureErrors`
+
+|              |                 |
+| ------------ | --------------- |
+| **Type**     | `array or null` |
+| **Required** | No              |
+
+**Description:** Raw Meta error objects. Present on failed sends only.
+
+|                      | Array restrictions |
+| -------------------- | ------------------ |
+| **Min items**        | N/A                |
+| **Max items**        | N/A                |
+| **Items unicity**    | False              |
+| **Additional items** | False              |
+| **Tuple validation** | See below          |
+
+| Each item of this array must be             | Description |
+| ------------------------------------------- | ----------- |
+| [failureErrors items](#failureErrors_items) | -           |
+
+### <a name="failureErrors_items"></a>16.1. failureErrors items
+
+|                           |                  |
+| ------------------------- | ---------------- |
+| **Type**                  | `object`         |
+| **Required**              | No               |
+| **Additional properties** | Any type allowed |
+
+----------------------------------------------------------------------------------------------------------------------------
+Generated using [json-schema-for-humans](https://github.com/coveooss/json-schema-for-humans) on 2026-05-16 at 00:18:16 +0000

package/data/static/llms.txt

@@ -4,7 +4,7 @@
 > Source of truth: Zod schemas in packages/schema/src/
 > All Firestore documents are scoped under companies/{companyId}/
 
-> Generated: 2026-05-15
+> Generated: 2026-05-16
 
 ---
 
@@ -50,6 +50,14 @@ Values: EARNED, REDEEMED, ADJUSTED, EXPIRED, BONUS, REFUND
 Core order lifecycle status (D03, D34). Universal across all business types. Replaces the Dashboard's legacy 20-value flat enum (MIG-11).
 Values: PENDING, CONFIRMED, PROCESSING, READY, COMPLETED, CANCELLED, EXPIRED
 
+### OutboundMessageKind
+Outbound WhatsApp message kind. Strict enum — new kinds require a schema version bump (GH#38).
+Values: otp, review_request
+
+### OutboundMessageStatus
+Outbound WhatsApp message delivery status. Lifecycle: accepted → sent → delivered → read, or accepted → failed. Updated in-place by Meta delivery callbacks (GH#38).
+Values: accepted, sent, delivered, read, failed
+
 ### PaymentMethod
 Unified payment method set with African + global methods (D02).
 Values: CASH, CREDIT_CARD, ORANGE_MONEY, WAVE, MTN_MONEY, MOOV_MONEY, BANK_TRANSFER, PAYPAL, STRIPE, OTHER
@@ -1484,11 +1492,11 @@ Fields: 13 (7 required)
 | from | string | yes | (Immutable) Sender phone number in E.164 format. |
 | type | any | yes | (Immutable) Meta message type. |
 | timestamp | FirestoreTimestamp | yes | (Immutable) Message timestamp as reported by Meta. |
-| receivedAt | FirestoreTimestamp | yes | (Read-only) Server-side ingestion time set by the Cloud Function. |
+| receivedAt | FirestoreTimestamp | yes | (Read-only) Server-side ingestion timestamp. |
 | text | ['string', 'null'] | no | Message body text. Present on type=text messages only. |
 | mediaId | ['string', 'null'] | no | Meta media ID. Present on image, audio, video, document, sticker messages. |
 | caption | ['string', 'null'] | no | Media caption text. Present when the sender included a caption. |
-| storageUrl | ['string', 'null'] | no | Durable Cloud Storage URL for the downloaded media binary. Present after the CF downloads and stores the media. |
+| storageUrl | ['string', 'null'] | no | Durable Cloud Storage URL for the downloaded media binary. Present after the media has been fetched and stored server-side. |
 | context | ['object', 'null'] | no | Reply/forward context. Present on replies and forwarded messages. |
 
 Example:
@@ -1510,6 +1518,50 @@ Example:
 }
 ```
 
+### WhatsappOutboundMessage
+Fields: 16 (9 required)
+
+| Field | Type | Required | Description |
+|-------|------|----------|-------------|
+| id | ['string', 'null'] | no | (Read-only) Firestore document ID — wamid on success, generated UUID on failure. |
+| messageId | string | yes | (Immutable) WhatsApp message ID (wamid) on success; generated UUID on send failure. |
+| to | string | yes | (Immutable) Recipient phone number in E.164 format. Mirrors inbound `from`. |
+| waba | WabaLabel | yes | (Immutable) WABA that sent the message. Mirrors inbound `waba`. |
+| wabaId | string | yes | (Immutable) Meta WABA ID. Mirrors inbound `wabaId`. |
+| sentAt | FirestoreTimestamp | yes | (Read-only) Server-side send timestamp. Mirrors inbound `receivedAt`. |
+| phoneNumberId | string | yes | (Immutable) Meta phone number ID used for the send (specific line within the WABA). |
+| kind | OutboundMessageKind | yes | (Immutable) Message kind. |
+| templateName | string | yes | (Immutable) WhatsApp template name used for the send. |
+| status | OutboundMessageStatus | yes | Delivery status. Updated in-place by Meta delivery callbacks. |
+| contactWaId | ['string', 'null'] | no | Normalized wa_id returned by Meta on success. May differ from `to`. |
+| appId | ['string', 'null'] | no | Tenant appId when applicable. |
+| orderUuid | ['string', 'null'] | no | Order reference. Present on review_request messages only. |
+| statusUpdatedAt | any | no | Timestamp of the last status update from a Meta delivery callback. |
+| failureCode | ['integer', 'null'] | no | Meta error code. Present on failed sends only. |
+| failureErrors | ['array', 'null'] | no | Raw Meta error objects. Present on failed sends only. |
+
+Example:
+```json
+{
+  "id": null,
+  "messageId": "mes_ref123",
+  "to": "to",
+  "waba": "waba",
+  "wabaId": "wab_ref123",
+  "sentAt": "sentAt",
+  "phoneNumberId": "pho_ref123",
+  "kind": "kind",
+  "templateName": "templateName",
+  "status": "status",
+  "contactWaId": null,
+  "appId": null,
+  "orderUuid": null,
+  "statusUpdatedAt": "statusUpdatedAt",
+  "failureCode": null,
+  "failureErrors": null
+}
+```
+
 ---
 
 ## Proposed (Work In Progress)