@ingenx-io/valets-schema-mcp-server 0.1.8 → 0.1.10

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:20:07 +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:20:07 +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:20:07 +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:20:07 +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,7 +60,7 @@ 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.
+**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                                                                                                           |
 | ---------------------------- | ------- | ---------------- | ---------- | ------------------------------------ | --------------------------------------------------------------------------------------------------------------------------- |
@@ -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 17:25:23 +0000
+Generated using [json-schema-for-humans](https://github.com/coveooss/json-schema-for-humans) on 2026-05-16 at 00:20:07 +0000

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

@@ -0,0 +1,366 @@
+---
+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"
+* "adhoc"
+
+:::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:20:07 +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, adhoc
+
+### 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
@@ -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)

package/data/static/openapi.yaml

@@ -122,6 +122,25 @@ components:
       - EXPIRED
       description: Core order lifecycle status (D03, D34). Universal across all business
         types. Replaces the Dashboard's legacy 20-value flat enum (MIG-11).
+    OutboundMessageKind:
+      type: string
+      enum:
+      - otp
+      - review_request
+      - adhoc
+      description: Outbound WhatsApp message kind. Strict enum — new kinds require
+        a schema version bump (GH#38).
+    OutboundMessageStatus:
+      type: string
+      enum:
+      - accepted
+      - sent
+      - delivered
+      - read
+      - failed
+      description: 'Outbound WhatsApp message delivery status. Lifecycle: accepted
+        → sent → delivered → read, or accepted → failed. Updated in-place by Meta
+        delivery callbacks (GH#38).'
     PaymentMethod:
       type: string
       enum:
@@ -4484,8 +4503,8 @@ components:
       - receivedAt
       additionalProperties: false
       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.'
+        Meta Cloud API webhook (GH#36). Collection: whatsapp_inbound_messages/{docId}.
+        Top-level scope: company resolution happens post-ingestion.'
     WhatsappInboundMessageCreate:
       allOf:
       - $ref: '#/components/schemas/WhatsappInboundMessage'
@@ -4505,6 +4524,123 @@ components:
       description: Write payload for partial update (PATCH) of a WhatsappInboundMessage
         document. All fields optional. Fields marked `readOnly` or `x-immutable` must
         not be sent.
+    WhatsappOutboundMessage:
+      type: object
+      properties:
+        id:
+          readOnly: true
+          description: (Read-only) Firestore document ID — wamid on success, generated
+            UUID on failure.
+          type:
+          - string
+          - 'null'
+        messageId:
+          type: string
+          x-immutable: true
+          description: (Immutable) WhatsApp message ID (wamid) on success; generated
+            UUID on send failure.
+        to:
+          type: string
+          x-immutable: true
+          description: (Immutable) Recipient phone number in E.164 format. Mirrors
+            inbound `from`.
+        waba:
+          $ref: '#/components/schemas/WabaLabel'
+          description: (Immutable) WABA that sent the message. Mirrors inbound `waba`.
+          x-immutable: true
+        wabaId:
+          type: string
+          x-immutable: true
+          description: (Immutable) Meta WABA ID. Mirrors inbound `wabaId`.
+        sentAt:
+          $ref: '#/components/schemas/FirestoreTimestamp'
+          description: (Read-only) Server-side send timestamp. Mirrors inbound `receivedAt`.
+          readOnly: true
+        phoneNumberId:
+          type: string
+          x-immutable: true
+          description: (Immutable) Meta phone number ID used for the send (specific
+            line within the WABA).
+        kind:
+          $ref: '#/components/schemas/OutboundMessageKind'
+          description: (Immutable) Message kind.
+          x-immutable: true
+        templateName:
+          type: string
+          x-immutable: true
+          description: (Immutable) WhatsApp template name used for the send.
+        status:
+          $ref: '#/components/schemas/OutboundMessageStatus'
+          description: Delivery status. Updated in-place by Meta delivery callbacks.
+        contactWaId:
+          description: Normalized wa_id returned by Meta on success. May differ from
+            `to`.
+          type:
+          - string
+          - 'null'
+        appId:
+          description: Tenant appId when applicable.
+          type:
+          - string
+          - 'null'
+        orderUuid:
+          description: Order reference. Present on review_request messages only.
+          type:
+          - string
+          - 'null'
+        statusUpdatedAt:
+          anyOf:
+          - $ref: '#/components/schemas/FirestoreTimestamp'
+          - type: 'null'
+          description: Timestamp of the last status update from a Meta delivery callback.
+        failureCode:
+          description: Meta error code. Present on failed sends only.
+          type:
+          - integer
+          - 'null'
+          minimum: -9007199254740991
+          maximum: 9007199254740991
+        failureErrors:
+          description: Raw Meta error objects. Present on failed sends only.
+          type:
+          - array
+          - 'null'
+          items: {}
+      required:
+      - messageId
+      - to
+      - waba
+      - wabaId
+      - sentAt
+      - phoneNumberId
+      - kind
+      - templateName
+      - status
+      additionalProperties: false
+      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).'
+    WhatsappOutboundMessageCreate:
+      allOf:
+      - $ref: '#/components/schemas/WhatsappOutboundMessage'
+      description: Write payload for creating a new WhatsappOutboundMessage document.
+        Fields marked `readOnly` are server-set and must not be included. Fields marked
+        `x-immutable` may be set once at creation.
+      required:
+      - messageId
+      - to
+      - waba
+      - wabaId
+      - phoneNumberId
+      - kind
+      - templateName
+      - status
+    WhatsappOutboundMessageUpdate:
+      allOf:
+      - $ref: '#/components/schemas/WhatsappOutboundMessage'
+      description: Write payload for partial update (PATCH) of a WhatsappOutboundMessage
+        document. All fields optional. Fields marked `readOnly` or `x-immutable` must
+        not be sent.
     PaymentSummary:
       type: object
       properties: