@ingenx-io/valets-schema-mcp-server 0.2.7 → 0.2.8

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

@@ -24,6 +24,7 @@ sidebar_position: 40
     "uid": "user_u8x92kqm"
   },
   "createdAt": "createdAt",
+  "contactE164": null,
   "status": "status",
   "wamid": null,
   "error": null,
@@ -58,21 +59,22 @@ sidebar_position: 40
 - [11. Property `createdAt`](#createdAt)
   - [11.1. Property `_seconds`](#createdAt__seconds)
   - [11.2. Property `_nanoseconds`](#createdAt__nanoseconds)
-- [12. Property `status`](#status)
-- [13. Property `wamid`](#wamid)
-- [14. Property `error`](#error)
-- [15. Property `sentAt`](#sentAt)
-  - [15.1. Property `firestore-timestamp`](#sentAt_anyOf_i0)
-  - [15.2. Property `item 1`](#sentAt_anyOf_i1)
-- [16. Property `deliveredAt`](#deliveredAt)
-  - [16.1. Property `firestore-timestamp`](#deliveredAt_anyOf_i0)
-  - [16.2. Property `item 1`](#deliveredAt_anyOf_i1)
-- [17. Property `readAt`](#readAt)
-  - [17.1. Property `firestore-timestamp`](#readAt_anyOf_i0)
-  - [17.2. Property `item 1`](#readAt_anyOf_i1)
-- [18. Property `failedAt`](#failedAt)
-  - [18.1. Property `firestore-timestamp`](#failedAt_anyOf_i0)
-  - [18.2. Property `item 1`](#failedAt_anyOf_i1)
+- [12. Property `contactE164`](#contactE164)
+- [13. Property `status`](#status)
+- [14. Property `wamid`](#wamid)
+- [15. Property `error`](#error)
+- [16. Property `sentAt`](#sentAt)
+  - [16.1. Property `firestore-timestamp`](#sentAt_anyOf_i0)
+  - [16.2. Property `item 1`](#sentAt_anyOf_i1)
+- [17. Property `deliveredAt`](#deliveredAt)
+  - [17.1. Property `firestore-timestamp`](#deliveredAt_anyOf_i0)
+  - [17.2. Property `item 1`](#deliveredAt_anyOf_i1)
+- [18. Property `readAt`](#readAt)
+  - [18.1. Property `firestore-timestamp`](#readAt_anyOf_i0)
+  - [18.2. Property `item 1`](#readAt_anyOf_i1)
+- [19. Property `failedAt`](#failedAt)
+  - [19.1. Property `firestore-timestamp`](#failedAt_anyOf_i0)
+  - [19.2. Property `item 1`](#failedAt_anyOf_i1)
 
 |                           |                                         |
 | ------------------------- | --------------------------------------- |
@@ -96,6 +98,7 @@ sidebar_position: 40
 | - [orderUuid](#orderUuid )     | No      | string or null   | No         | -                                        | Order reference. Present on review_request messages.                                                                                                                           |
 | + [sentBy](#sentBy )           | No      | object           | No         | -                                        | (Immutable) Dashboard actor who enqueued the message.                                                                                                                          |
 | + [createdAt](#createdAt )     | No      | object           | No         | In #/definitions/firestore-timestamp     | (Immutable) Enqueue timestamp, set by the dashboard at create.                                                                                                                 |
+| - [contactE164](#contactE164 ) | No      | string or null   | No         | -                                        | (Read-only) E.164-normalized recipient phone (e.g. +2250777471485). Canonical join key (#56). Populated by the backend; absent on pre-migration docs.                          |
 | + [status](#status )           | No      | enum (of string) | No         | In #/definitions/outbound-message-status | Delivery status. Created as \`queued\` by the dashboard; updated in place by the backend.                                                                                      |
 | - [wamid](#wamid )             | No      | string or null   | No         | -                                        | (Read-only) WhatsApp message ID returned by Meta once the backend sends. Absent while queued or on failure.                                                                    |
 | - [error](#error )             | No      | string or null   | No         | -                                        | (Read-only) Human-readable failure reason. Present on status=failed. Raw Meta error detail lives in the lifecycle_events subcollection.                                        |
@@ -402,7 +405,28 @@ Set at creation only. This field cannot be modified after the document is create
 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>12. Property `status`
+## <a name="contactE164"></a>12. Property `contactE164`
+
+|              |                  |
+| ------------ | ---------------- |
+| **Type**     | `string or null` |
+| **Required** | No               |
+
+**Description:** (Read-only) E.164-normalized recipient phone (e.g. +2250777471485). Canonical join key (#56). Populated by the backend; absent on pre-migration docs.
+
+:::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.
+:::
+
+:::note
+E.164-normalized form of `to` (wa_id). Canonical join key across WhatsappOutboundMessage, WhatsappInboundMessage, and NotificationRecord. Use this for conversation threading, search, and cross-collection joins — not the raw `to` wa_id (#56).
+:::
+
+:::tip When to set
+Populated by whatsapp-server on every new outbound doc. Absent on pre-#56 docs until the backfill migration runs. CI normalization: wa_id 22577471485 → +2250777471485 (insert trunk 0 after country code for 8-digit numbers in the 07/05/01 series that predate the 2014 10-digit migration).
+:::
+
+## <a name="status"></a>13. Property `status`
 
 |                |                                       |
 | -------------- | ------------------------------------- |
@@ -423,7 +447,7 @@ Must be one of:
 Dashboard must create with `queued`. The backend owns every transition after (sent → delivered → read, or failed).
 :::
 
-## <a name="wamid"></a>13. Property `wamid`
+## <a name="wamid"></a>14. Property `wamid`
 
 |              |                  |
 | ------------ | ---------------- |
@@ -440,7 +464,7 @@ Do not include in write requests. This field is set exclusively by the server (F
 Useful for audit and dedup. Does NOT enable reply-threading for template messages — Meta silently ignores context.message_id on templates. Threading only works for kind=text within the 24-hour service window (#50).
 :::
 
-## <a name="error"></a>14. Property `error`
+## <a name="error"></a>15. Property `error`
 
 |              |                  |
 | ------------ | ---------------- |
@@ -453,7 +477,7 @@ Useful for audit and dedup. Does NOT enable reply-threading for template message
 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="sentAt"></a>15. Property `sentAt`
+## <a name="sentAt"></a>16. Property `sentAt`
 
 |                           |                  |
 | ------------------------- | ---------------- |
@@ -468,7 +492,7 @@ Do not include in write requests. This field is set exclusively by the server (F
 | [firestore-timestamp](#sentAt_anyOf_i0) |
 | [item 1](#sentAt_anyOf_i1)              |
 
-### <a name="sentAt_anyOf_i0"></a>15.1. Property `firestore-timestamp`
+### <a name="sentAt_anyOf_i0"></a>16.1. Property `firestore-timestamp`
 
 |                           |                         |
 | ------------------------- | ----------------------- |
@@ -479,7 +503,7 @@ Do not include in write requests. This field is set exclusively by the server (F
 
 **Description:** Firestore Timestamp — Admin SDK form: \{ _seconds, _nanoseconds \}. See types/firestore.ts for REST API v1 and client SDK serialization notes (#10).
 
-### <a name="sentAt_anyOf_i1"></a>15.2. Property `item 1`
+### <a name="sentAt_anyOf_i1"></a>16.2. Property `item 1`
 
 |              |        |
 | ------------ | ------ |
@@ -490,7 +514,7 @@ Do not include in write requests. This field is set exclusively by the server (F
 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="deliveredAt"></a>16. Property `deliveredAt`
+## <a name="deliveredAt"></a>17. Property `deliveredAt`
 
 |                           |                  |
 | ------------------------- | ---------------- |
@@ -505,7 +529,7 @@ Do not include in write requests. This field is set exclusively by the server (F
 | [firestore-timestamp](#deliveredAt_anyOf_i0) |
 | [item 1](#deliveredAt_anyOf_i1)              |
 
-### <a name="deliveredAt_anyOf_i0"></a>16.1. Property `firestore-timestamp`
+### <a name="deliveredAt_anyOf_i0"></a>17.1. Property `firestore-timestamp`
 
 |                           |                         |
 | ------------------------- | ----------------------- |
@@ -516,7 +540,7 @@ Do not include in write requests. This field is set exclusively by the server (F
 
 **Description:** Firestore Timestamp — Admin SDK form: \{ _seconds, _nanoseconds \}. See types/firestore.ts for REST API v1 and client SDK serialization notes (#10).
 
-### <a name="deliveredAt_anyOf_i1"></a>16.2. Property `item 1`
+### <a name="deliveredAt_anyOf_i1"></a>17.2. Property `item 1`
 
 |              |        |
 | ------------ | ------ |
@@ -527,7 +551,7 @@ Do not include in write requests. This field is set exclusively by the server (F
 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="readAt"></a>17. Property `readAt`
+## <a name="readAt"></a>18. Property `readAt`
 
 |                           |                  |
 | ------------------------- | ---------------- |
@@ -542,7 +566,7 @@ Do not include in write requests. This field is set exclusively by the server (F
 | [firestore-timestamp](#readAt_anyOf_i0) |
 | [item 1](#readAt_anyOf_i1)              |
 
-### <a name="readAt_anyOf_i0"></a>17.1. Property `firestore-timestamp`
+### <a name="readAt_anyOf_i0"></a>18.1. Property `firestore-timestamp`
 
 |                           |                         |
 | ------------------------- | ----------------------- |
@@ -553,7 +577,7 @@ Do not include in write requests. This field is set exclusively by the server (F
 
 **Description:** Firestore Timestamp — Admin SDK form: \{ _seconds, _nanoseconds \}. See types/firestore.ts for REST API v1 and client SDK serialization notes (#10).
 
-### <a name="readAt_anyOf_i1"></a>17.2. Property `item 1`
+### <a name="readAt_anyOf_i1"></a>18.2. Property `item 1`
 
 |              |        |
 | ------------ | ------ |
@@ -564,7 +588,7 @@ Do not include in write requests. This field is set exclusively by the server (F
 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="failedAt"></a>18. Property `failedAt`
+## <a name="failedAt"></a>19. Property `failedAt`
 
 |                           |                  |
 | ------------------------- | ---------------- |
@@ -579,7 +603,7 @@ Do not include in write requests. This field is set exclusively by the server (F
 | [firestore-timestamp](#failedAt_anyOf_i0) |
 | [item 1](#failedAt_anyOf_i1)              |
 
-### <a name="failedAt_anyOf_i0"></a>18.1. Property `firestore-timestamp`
+### <a name="failedAt_anyOf_i0"></a>19.1. Property `firestore-timestamp`
 
 |                           |                         |
 | ------------------------- | ----------------------- |
@@ -590,7 +614,7 @@ Do not include in write requests. This field is set exclusively by the server (F
 
 **Description:** Firestore Timestamp — Admin SDK form: \{ _seconds, _nanoseconds \}. See types/firestore.ts for REST API v1 and client SDK serialization notes (#10).
 
-### <a name="failedAt_anyOf_i1"></a>18.2. Property `item 1`
+### <a name="failedAt_anyOf_i1"></a>19.2. Property `item 1`
 
 |              |        |
 | ------------ | ------ |
@@ -598,7 +622,7 @@ Do not include in write requests. This field is set exclusively by the server (F
 | **Required** | No     |
 
 ----------------------------------------------------------------------------------------------------------------------------
-Generated using [json-schema-for-humans](https://github.com/coveooss/json-schema-for-humans) on 2026-05-30 at 13:57:29 +0000
+Generated using [json-schema-for-humans](https://github.com/coveooss/json-schema-for-humans) on 2026-05-30 at 14:38:11 +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/whatsapp-template.md

@@ -291,7 +291,7 @@ Do not include in write requests. This field is set exclusively by the server (F
 **Description:** (Read-only) Rendered preview text for display in the dashboard picker.
 
 ----------------------------------------------------------------------------------------------------------------------------
-Generated using [json-schema-for-humans](https://github.com/coveooss/json-schema-for-humans) on 2026-05-30 at 13:57:29 +0000
+Generated using [json-schema-for-humans](https://github.com/coveooss/json-schema-for-humans) on 2026-05-30 at 14:38:11 +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/static/llms.txt

@@ -1332,17 +1332,20 @@ Fields: 12 (6 required)
 | recipients | object | yes | (Read-only) Recipients of the notification. |
 | recipients.to | array<object> | yes | Primary recipients. |
 | recipients.to[].email | string | no | Recipient email address. Present for email notifications. |
-| recipients.to[].phone | string | no | Recipient phone number (E.164). Present for whatsapp/sms notifications. |
+| recipients.to[].phone | string | no | Recipient phone number as passed by the sender (may be raw wa_id or E.164). Present for whatsapp/sms notifications. |
+| recipients.to[].contactE164 | string | no | (Read-only) E.164-normalized phone (e.g. +2250777471485). Canonical join key across WhatsApp and notification collections (#56). |
 | recipients.to[].name | string | no | Recipient display name. |
 | recipients.to[].role | string | no | Recipient role (e.g. organizer, customer). |
 | recipients.cc | array<object> | no | CC recipients (email). |
 | recipients.cc[].email | string | no | Recipient email address. Present for email notifications. |
-| recipients.cc[].phone | string | no | Recipient phone number (E.164). Present for whatsapp/sms notifications. |
+| recipients.cc[].phone | string | no | Recipient phone number as passed by the sender (may be raw wa_id or E.164). Present for whatsapp/sms notifications. |
+| recipients.cc[].contactE164 | string | no | (Read-only) E.164-normalized phone (e.g. +2250777471485). Canonical join key across WhatsApp and notification collections (#56). |
 | recipients.cc[].name | string | no | Recipient display name. |
 | recipients.cc[].role | string | no | Recipient role (e.g. organizer, customer). |
 | recipients.bcc | array<object> | no | BCC recipients (email). |
 | recipients.bcc[].email | string | no | Recipient email address. Present for email notifications. |
-| recipients.bcc[].phone | string | no | Recipient phone number (E.164). Present for whatsapp/sms notifications. |
+| recipients.bcc[].phone | string | no | Recipient phone number as passed by the sender (may be raw wa_id or E.164). Present for whatsapp/sms notifications. |
+| recipients.bcc[].contactE164 | string | no | (Read-only) E.164-normalized phone (e.g. +2250777471485). Canonical join key across WhatsApp and notification collections (#56). |
 | recipients.bcc[].name | string | no | Recipient display name. |
 | recipients.bcc[].role | string | no | Recipient role (e.g. organizer, customer). |
 | relatedEntity | object | yes | (Read-only) Entity that triggered the notification. type=order triggers the dual-write to the order subcollection. |
@@ -1947,7 +1950,7 @@ Example:
 ```
 
 ### WhatsappInboundMessage
-Fields: 13 (7 required)
+Fields: 14 (7 required)
 
 | Field | Type | Required | Description |
 |-------|------|----------|-------------|
@@ -1964,6 +1967,7 @@ Fields: 13 (7 required)
 | 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 media has been fetched and stored server-side. |
 | context | ['object', 'null'] | no | Reply/forward context. Present on replies and forwarded messages. |
+| contactE164 | ['string', 'null'] | no | (Read-only) E.164-normalized sender phone (e.g. +2250777471485). Canonical join key (#56). Populated by the backend; absent on pre-migration docs. |
 
 Example:
 ```json
@@ -1980,7 +1984,8 @@ Example:
   "mediaId": null,
   "caption": null,
   "storageUrl": null,
-  "context": null
+  "context": null,
+  "contactE164": null
 }
 ```
 
@@ -2019,7 +2024,7 @@ Example:
 ```
 
 ### WhatsappOutboundMessage
-Fields: 18 (7 required)
+Fields: 19 (7 required)
 
 | Field | Type | Required | Description |
 |-------|------|----------|-------------|
@@ -2036,6 +2041,7 @@ Fields: 18 (7 required)
 | sentBy.uid | string | yes | Firebase Auth UID of the dashboard user who enqueued the message. |
 | sentBy.email | string | no | Email of the sender, if available. |
 | createdAt | FirestoreTimestamp | yes | (Immutable) Enqueue timestamp, set by the dashboard at create. |
+| contactE164 | ['string', 'null'] | no | (Read-only) E.164-normalized recipient phone (e.g. +2250777471485). Canonical join key (#56). Populated by the backend; absent on pre-migration docs. |
 | status | OutboundMessageStatus | yes | Delivery status. Created as `queued` by the dashboard; updated in place by the backend. |
 | wamid | ['string', 'null'] | no | (Read-only) WhatsApp message ID returned by Meta once the backend sends. Absent while queued or on failure. |
 | error | ['string', 'null'] | no | (Read-only) Human-readable failure reason. Present on status=failed. Raw Meta error detail lives in the lifecycle_events subcollection. |
@@ -2060,6 +2066,7 @@ Example:
     "uid": "user_u8x92kqm"
   },
   "createdAt": "createdAt",
+  "contactE164": null,
   "status": "status",
   "wamid": null,
   "error": null,

package/data/static/openapi.yaml

@@ -3999,8 +3999,20 @@ components:
                     description: Recipient email address. Present for email notifications.
                     type: string
                   phone:
-                    description: Recipient phone number (E.164). Present for whatsapp/sms
-                      notifications.
+                    description: Recipient phone number as passed by the sender (may
+                      be raw wa_id or E.164). Present for whatsapp/sms notifications.
+                    type: string
+                  contactE164:
+                    readOnly: true
+                    x-note: Canonical E.164 phone, normalized from `phone` by the
+                      backend writer. Use this for joins and search, not the raw `phone`
+                      field (#56). Absent on pre-migration docs.
+                    x-when: Populated by Cloud Functions on every new NotificationRecord
+                      for whatsapp/sms channels. CI normalization applied (8→10-digit
+                      07/05/01 series).
+                    description: (Read-only) E.164-normalized phone (e.g. +2250777471485).
+                      Canonical join key across WhatsApp and notification collections
+                      (#56).
                     type: string
                   name:
                     description: Recipient display name.
@@ -4021,8 +4033,20 @@ components:
                     description: Recipient email address. Present for email notifications.
                     type: string
                   phone:
-                    description: Recipient phone number (E.164). Present for whatsapp/sms
-                      notifications.
+                    description: Recipient phone number as passed by the sender (may
+                      be raw wa_id or E.164). Present for whatsapp/sms notifications.
+                    type: string
+                  contactE164:
+                    readOnly: true
+                    x-note: Canonical E.164 phone, normalized from `phone` by the
+                      backend writer. Use this for joins and search, not the raw `phone`
+                      field (#56). Absent on pre-migration docs.
+                    x-when: Populated by Cloud Functions on every new NotificationRecord
+                      for whatsapp/sms channels. CI normalization applied (8→10-digit
+                      07/05/01 series).
+                    description: (Read-only) E.164-normalized phone (e.g. +2250777471485).
+                      Canonical join key across WhatsApp and notification collections
+                      (#56).
                     type: string
                   name:
                     description: Recipient display name.
@@ -4042,8 +4066,20 @@ components:
                     description: Recipient email address. Present for email notifications.
                     type: string
                   phone:
-                    description: Recipient phone number (E.164). Present for whatsapp/sms
-                      notifications.
+                    description: Recipient phone number as passed by the sender (may
+                      be raw wa_id or E.164). Present for whatsapp/sms notifications.
+                    type: string
+                  contactE164:
+                    readOnly: true
+                    x-note: Canonical E.164 phone, normalized from `phone` by the
+                      backend writer. Use this for joins and search, not the raw `phone`
+                      field (#56). Absent on pre-migration docs.
+                    x-when: Populated by Cloud Functions on every new NotificationRecord
+                      for whatsapp/sms channels. CI normalization applied (8→10-digit
+                      07/05/01 series).
+                    description: (Read-only) E.164-normalized phone (e.g. +2250777471485).
+                      Canonical join key across WhatsApp and notification collections
+                      (#56).
                     type: string
                   name:
                     description: Recipient display name.
@@ -6071,6 +6107,22 @@ components:
               type: boolean
               const: true
           additionalProperties: false
+        contactE164:
+          readOnly: true
+          x-note: E.164-normalized form of `from` (wa_id). Canonical join key across
+            WhatsappInboundMessage, WhatsappOutboundMessage, and NotificationRecord.
+            Use this for conversation threading, search, and cross-collection joins
+            — not the raw `from` wa_id (#56).
+          x-when: 'Populated by whatsapp-server on every new inbound doc. Absent on
+            pre-#56 docs until the backfill migration runs. CI normalization: wa_id
+            22577471485 → +2250777471485 (insert trunk 0 after country code for 8-digit
+            numbers in the 07/05/01 series that predate the 2014 10-digit migration).'
+          description: (Read-only) E.164-normalized sender phone (e.g. +2250777471485).
+            Canonical join key (#56). Populated by the backend; absent on pre-migration
+            docs.
+          type:
+          - string
+          - 'null'
       required:
       - wabaId
       - waba
@@ -6290,6 +6342,22 @@ components:
           $ref: '#/components/schemas/FirestoreTimestamp'
           description: (Immutable) Enqueue timestamp, set by the dashboard at create.
           x-immutable: true
+        contactE164:
+          readOnly: true
+          x-note: E.164-normalized form of `to` (wa_id). Canonical join key across
+            WhatsappOutboundMessage, WhatsappInboundMessage, and NotificationRecord.
+            Use this for conversation threading, search, and cross-collection joins
+            — not the raw `to` wa_id (#56).
+          x-when: 'Populated by whatsapp-server on every new outbound doc. Absent
+            on pre-#56 docs until the backfill migration runs. CI normalization: wa_id
+            22577471485 → +2250777471485 (insert trunk 0 after country code for 8-digit
+            numbers in the 07/05/01 series that predate the 2014 10-digit migration).'
+          description: (Read-only) E.164-normalized recipient phone (e.g. +2250777471485).
+            Canonical join key (#56). Populated by the backend; absent on pre-migration
+            docs.
+          type:
+          - string
+          - 'null'
         status:
           $ref: '#/components/schemas/OutboundMessageStatus'
           description: Delivery status. Created as `queued` by the dashboard; updated

package/data/static/schemas.json

@@ -1,7 +1,7 @@
 {
   "$schema": "http://json-schema.org/draft-07/schema#",
   "description": "@valets/schema \u2014 consolidated schema bundle",
-  "generated": "2026-05-30T13:57:29.446011+00:00",
+  "generated": "2026-05-30T14:38:11.260961+00:00",
   "schemas": {
     "allowed-user": {
       "type": "object",
@@ -4467,7 +4467,14 @@
                     "type": "string"
                   },
                   "phone": {
-                    "description": "Recipient phone number (E.164). Present for whatsapp/sms notifications.",
+                    "description": "Recipient phone number as passed by the sender (may be raw wa_id or E.164). Present for whatsapp/sms notifications.",
+                    "type": "string"
+                  },
+                  "contactE164": {
+                    "readOnly": true,
+                    "x-note": "Canonical E.164 phone, normalized from `phone` by the backend writer. Use this for joins and search, not the raw `phone` field (#56). Absent on pre-migration docs.",
+                    "x-when": "Populated by Cloud Functions on every new NotificationRecord for whatsapp/sms channels. CI normalization applied (8\u219210-digit 07/05/01 series).",
+                    "description": "(Read-only) E.164-normalized phone (e.g. +2250777471485). Canonical join key across WhatsApp and notification collections (#56).",
                     "type": "string"
                   },
                   "name": {
@@ -4495,7 +4502,14 @@
                     "type": "string"
                   },
                   "phone": {
-                    "description": "Recipient phone number (E.164). Present for whatsapp/sms notifications.",
+                    "description": "Recipient phone number as passed by the sender (may be raw wa_id or E.164). Present for whatsapp/sms notifications.",
+                    "type": "string"
+                  },
+                  "contactE164": {
+                    "readOnly": true,
+                    "x-note": "Canonical E.164 phone, normalized from `phone` by the backend writer. Use this for joins and search, not the raw `phone` field (#56). Absent on pre-migration docs.",
+                    "x-when": "Populated by Cloud Functions on every new NotificationRecord for whatsapp/sms channels. CI normalization applied (8\u219210-digit 07/05/01 series).",
+                    "description": "(Read-only) E.164-normalized phone (e.g. +2250777471485). Canonical join key across WhatsApp and notification collections (#56).",
                     "type": "string"
                   },
                   "name": {
@@ -4522,7 +4536,14 @@
                     "type": "string"
                   },
                   "phone": {
-                    "description": "Recipient phone number (E.164). Present for whatsapp/sms notifications.",
+                    "description": "Recipient phone number as passed by the sender (may be raw wa_id or E.164). Present for whatsapp/sms notifications.",
+                    "type": "string"
+                  },
+                  "contactE164": {
+                    "readOnly": true,
+                    "x-note": "Canonical E.164 phone, normalized from `phone` by the backend writer. Use this for joins and search, not the raw `phone` field (#56). Absent on pre-migration docs.",
+                    "x-when": "Populated by Cloud Functions on every new NotificationRecord for whatsapp/sms channels. CI normalization applied (8\u219210-digit 07/05/01 series).",
+                    "description": "(Read-only) E.164-normalized phone (e.g. +2250777471485). Canonical join key across WhatsApp and notification collections (#56).",
                     "type": "string"
                   },
                   "name": {
@@ -7361,6 +7382,16 @@
             }
           },
           "additionalProperties": false
+        },
+        "contactE164": {
+          "readOnly": true,
+          "x-note": "E.164-normalized form of `from` (wa_id). Canonical join key across WhatsappInboundMessage, WhatsappOutboundMessage, and NotificationRecord. Use this for conversation threading, search, and cross-collection joins \u2014 not the raw `from` wa_id (#56).",
+          "x-when": "Populated by whatsapp-server on every new inbound doc. Absent on pre-#56 docs until the backfill migration runs. CI normalization: wa_id 22577471485 \u2192 +2250777471485 (insert trunk 0 after country code for 8-digit numbers in the 07/05/01 series that predate the 2014 10-digit migration).",
+          "description": "(Read-only) E.164-normalized sender phone (e.g. +2250777471485). Canonical join key (#56). Populated by the backend; absent on pre-migration docs.",
+          "type": [
+            "string",
+            "null"
+          ]
         }
       },
       "required": [
@@ -7387,7 +7418,8 @@
         "mediaId": null,
         "caption": null,
         "storageUrl": null,
-        "context": null
+        "context": null,
+        "contactE164": null
       }
     },
     "whatsapp-outbound-lifecycle-event": {
@@ -7623,6 +7655,16 @@
           "description": "(Immutable) Enqueue timestamp, set by the dashboard at create.",
           "x-immutable": true
         },
+        "contactE164": {
+          "readOnly": true,
+          "x-note": "E.164-normalized form of `to` (wa_id). Canonical join key across WhatsappOutboundMessage, WhatsappInboundMessage, and NotificationRecord. Use this for conversation threading, search, and cross-collection joins \u2014 not the raw `to` wa_id (#56).",
+          "x-when": "Populated by whatsapp-server on every new outbound doc. Absent on pre-#56 docs until the backfill migration runs. CI normalization: wa_id 22577471485 \u2192 +2250777471485 (insert trunk 0 after country code for 8-digit numbers in the 07/05/01 series that predate the 2014 10-digit migration).",
+          "description": "(Read-only) E.164-normalized recipient phone (e.g. +2250777471485). Canonical join key (#56). Populated by the backend; absent on pre-migration docs.",
+          "type": [
+            "string",
+            "null"
+          ]
+        },
         "status": {
           "$ref": "#/definitions/outbound-message-status",
           "description": "Delivery status. Created as `queued` by the dashboard; updated in place by the backend.",
@@ -7719,6 +7761,7 @@
           "uid": "user_u8x92kqm"
         },
         "createdAt": "createdAt",
+        "contactE164": null,
         "status": "status",
         "wamid": null,
         "error": null,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ingenx-io/valets-schema-mcp-server",
-  "version": "0.2.7",
+  "version": "0.2.8",
   "description": "MCP server exposing @valets/schema documentation to AI agents",
   "type": "module",
   "main": "index.js",