@portpowered/reference-data 0.4.5 → 0.4.7

package/generated/capabilities.json

@@ -483,6 +483,26 @@
       "version": "1.0",
       "description": "Brightness sets how bright a connected device should be and reports its current level. Use it to dim a light for the evening or restore a brighter setting for work.",
       "messages": [
+        {
+          "name": "adjust-brightness",
+          "description": "Adjust brightness by a signed number of percentage points. The endpoint must advertise this message separately from set-brightness.",
+          "directionality": "in",
+          "schema": {
+            "description": "Adjust brightness by a signed number of percentage points. The endpoint must advertise this message separately from set-brightness.",
+            "type": "object",
+            "properties": {
+              "brightnessDelta": {
+                "type": "integer",
+                "minimum": -100,
+                "maximum": 100
+              }
+            },
+            "required": [
+              "brightnessDelta"
+            ],
+            "additionalProperties": false
+          }
+        },
         {
           "name": "set-brightness",
           "description": null,
@@ -3816,6 +3836,7 @@
                   "LEFT",
                   "RIGHT",
                   "SELECT",
+                  "HOME",
                   "BACK",
                   "EXIT",
                   "MENU",
@@ -3876,6 +3897,7 @@
                 "LEFT",
                 "RIGHT",
                 "SELECT",
+                "HOME",
                 "BACK",
                 "EXIT",
                 "MENU",
@@ -4317,6 +4339,16 @@
             "additionalProperties": false
           }
         },
+        {
+          "name": "fast-forward",
+          "description": "Begin provider-defined fast-forward playback. This does not seek by a specific duration; use skip-forward or seek for a known position change.",
+          "directionality": "in",
+          "schema": {
+            "description": "Begin provider-defined fast-forward playback. This does not seek by a specific duration; use skip-forward or seek for a known position change.",
+            "type": "object",
+            "additionalProperties": false
+          }
+        },
         {
           "name": "next",
           "description": null,
@@ -4457,15 +4489,50 @@
         },
         {
           "name": "search-and-play",
-          "description": null,
+          "description": "Search for and play media by title or query using a service advertised by the endpoint. Omitting mediaType retains audio search behavior; video-only endpoints may default to video.",
           "directionality": "in",
           "schema": {
+            "description": "Search for and play media by title or query using a service advertised by the endpoint. Omitting mediaType retains audio search behavior; video-only endpoints may default to video.",
             "type": "object",
             "properties": {
               "query": {
                 "type": "string",
-                "description": "Query to search for audio content",
+                "description": "Query to search for media content",
                 "minLength": 1
+              },
+              "provider": {
+                "type": "string",
+                "description": "Media service identifier. A provider enum value does not imply that every endpoint supports that service; use the endpoint's advertised provider lists.",
+                "enum": [
+                  "SPOTIFY",
+                  "AMAZON_MUSIC",
+                  "APPLE_MUSIC",
+                  "AUDIBLE",
+                  "TUNE_IN",
+                  "PANDORA",
+                  "IHEART_RADIO",
+                  "SIRIUSXM",
+                  "DEEZER",
+                  "TIDAL",
+                  "YOUTUBE",
+                  "NETFLIX",
+                  "PRIME_VIDEO",
+                  "DAILYMOTION"
+                ]
+              },
+              "mediaType": {
+                "type": "string",
+                "enum": [
+                  "AUDIO",
+                  "VIDEO"
+                ],
+                "description": "Media search domain. The endpoint must advertise support for the selected type."
+              },
+              "timerSeconds": {
+                "type": "integer",
+                "minimum": 1,
+                "maximum": 86400,
+                "description": "Optional provider playback timer in seconds."
               }
             },
             "required": [
@@ -4593,6 +4660,47 @@
         "description": "Media players select media by its Port OS media ID, play supplied audio or a URI, and control playback. Read playback state and use only the commands supported by the connected player.",
         "type": "object",
         "properties": {
+          "supportedAudioProviders": {
+            "type": "array",
+            "uniqueItems": true,
+            "description": "Audio services accepted by search-and-play on this endpoint. These describe command support, not active subscriptions.",
+            "items": {
+              "type": "string",
+              "description": "Media service identifier. A provider enum value does not imply that every endpoint supports that service; use the endpoint's advertised provider lists.",
+              "enum": [
+                "SPOTIFY",
+                "AMAZON_MUSIC",
+                "APPLE_MUSIC",
+                "AUDIBLE",
+                "TUNE_IN",
+                "PANDORA",
+                "IHEART_RADIO",
+                "SIRIUSXM",
+                "DEEZER",
+                "TIDAL",
+                "YOUTUBE",
+                "NETFLIX",
+                "PRIME_VIDEO",
+                "DAILYMOTION"
+              ]
+            }
+          },
+          "supportedVideoProviders": {
+            "type": "array",
+            "uniqueItems": true,
+            "description": "Video services accepted by search-and-play on this endpoint. These describe command support, not installed applications or active subscriptions.",
+            "items": {
+              "$ref": "#/properties/supportedAudioProviders/items"
+            }
+          },
+          "defaultAudioProvider": {
+            "$ref": "#/properties/supportedAudioProviders/items",
+            "description": "Default service for an audio search. Must be in supportedAudioProviders."
+          },
+          "defaultVideoProvider": {
+            "$ref": "#/properties/supportedAudioProviders/items",
+            "description": "Default service for a video search. Must be in supportedVideoProviders."
+          },
           "supportedPlaybackStates": {
             "type": "array",
             "items": {
@@ -9066,11 +9174,17 @@
                   "type": {
                     "type": "string",
                     "enum": [
-                      "SSML"
+                      "SSML",
+                      "CANNED_TTS"
                     ]
                   },
                   "ssml": {
                     "type": "string"
+                  },
+                  "cannedTtsStringId": {
+                    "type": "string",
+                    "minLength": 1,
+                    "description": "Provider-defined canned speech identifier; supported only by integrations advertising canned speech."
                   }
                 },
                 "title": "SpeechInput"
@@ -9081,7 +9195,24 @@
         }
       ],
       "attributes": [],
-      "configuration": null
+      "configuration": {
+        "type": "object",
+        "properties": {
+          "supportedInputTypes": {
+            "type": "array",
+            "uniqueItems": true,
+            "items": {
+              "type": "string",
+              "enum": [
+                "SSML",
+                "CANNED_TTS"
+              ]
+            }
+          }
+        },
+        "additionalProperties": false,
+        "description": "Speech synthesizers accept a request to speak. Use them to send spoken output to a connected device or integration."
+      }
     },
     {
       "name": "temperature-sensor",

package/generated/guides.json

@@ -50,7 +50,7 @@
   {
     "id": "lighting",
     "title": "Control lights and distinguish switches and plugs",
-    "content": "# Control lights and distinguish switches and plugs\n\nStart with authorized endpoint discovery and inspect capability declarations. A room name can be ambiguous; select by full ID and group path or ask the user. A power-capable plug or switch is not automatically a light.\n\nFor one bulb, read its power/brightness/color message schemas in [the capability directory](/docs/for-ai/capability-interfaces.md). Use the exact namespace, version, message name, units and constraints returned. [The quickstart](/docs/for-ai/guides/quickstart.md) shows the generic dispatch envelope.\n\nFor “all lights,” include explicitly authorized shared lights and the user-requested home/group scope. Complete pagination, exclude disabled/unavailable unsupported targets as documented and deduplicate nested groups. Do not broaden the set to every power-capable endpoint. Use the existing query/dispatch contract if it supports the selection; otherwise enumerate the fixed target set and report each result.\n\nA batch can partially succeed. Report selected, accepted, failed and unresolved targets separately. Read fresh state before claiming all lights changed. A lost response does not justify repeating relative brightness adjustments. See [authorization rules](/docs/for-ai/guides/authorization-rules.md).\n",
+    "content": "# Control lights and distinguish switches and plugs\n\nStart with authorized endpoint discovery and inspect capability declarations. A room name can be ambiguous; select by full ID and group path or ask the user. A power-capable plug or switch is not automatically a light.\n\nFor one bulb, read its power/brightness/color message schemas in [the capability directory](/docs/for-ai/capability-interfaces.md). Use the exact namespace, version, message name, units and constraints returned. [The quickstart](/docs/for-ai/guides/quickstart.md) shows the generic dispatch envelope.\n\nFor “all lights,” use [endpointQuery](/docs/for-ai/operations/endpointQuery.md): POST /endpoint-query with endpoint:read. Its results include readable shared endpoints from other owners. Start with the LIGHT and LIGHTBULB types below, then limit the results to the user's requested home or group.\n\n```json\n{\n  \"query\": {\n    \"or\": [\n      {\"match\": {\"key\": \"type\", \"value\": \"LIGHT\"}},\n      {\"match\": {\"key\": \"type\", \"value\": \"LIGHTBULB\"}}\n    ]\n  },\n  \"paginationContext\": {\"maxResults\": 25}\n}\n```\n\nFor a room, first resolve its full group ID using [group discovery](/docs/for-ai/guides/managing-groups.md). Intersect the type predicate with `{\"match\":{\"key\":\"groupId\",\"value\":\"<resolved-full-group-id>\"}}` inside query.and. This additionally requires group:read and permission to read that group. A group filter uses its returned member endpoints; resolve the requested nested groups as needed and deduplicate full endpoint IDs. Reading a group does not grant control of its members.\n\nRepeat the same query, page size and authenticated grant with paginationContext.nextToken from each response. Continue until that token is absent, including after an empty page. Disabled endpoints are excluded by default. Inspect declared capabilities for the selected endpoints and exclude unsupported targets; do not broaden the selection to every power-capable plug or switch. Freeze the discovered target set before dispatch and report each result.\n\nA batch can partially succeed. Report selected, accepted, failed and unresolved targets separately. For fresh readback, repeat endpointQuery with expand:[\"interfaces.attributes\"] and forceDeviceQuery:true. Inspect observation sample times and response errors before claiming all lights changed. A lost response does not justify repeating relative brightness adjustments. See [authorization rules](/docs/for-ai/guides/authorization-rules.md).\n",
     "setupPrompt": null
   },
   {
@@ -128,7 +128,7 @@
   {
     "id": "using-the-api",
     "title": "Using the REST API",
-    "content": "# Using the REST API\n\nDiscover authorization metadata, then use [OAuth setup](/docs/for-ai/guides/authentication-and-dcr.md). Obtain exact REST paths and schemas from [OpenAPI](/docs/references/openapi.yaml) or [small operation pages](/docs/for-ai/operations/index.md).\n\nEnumerate endpoints with endpoint:read. Follow returned pagination links/tokens exactly and stop only when continuation is absent. Inspect declared capabilities and versions; retrieve one message/attribute schema as needed. Send messages through POST /messages (the existing /messages/send alias also works). Never invent target IDs or message fields.\n\nREST dispatch and subsequent physical observation are separate facts. A 202 describes unfinished work. A timeout can mean the operation already acted; inspect existing results/state before repeating. IR/Bluetooth fire-and-forget and long-delay devices may never provide immediate confirmation. Use bounded polling and report unresolved state. An endpoint edit marked committed with cleanup pending must not be repeated as though it failed.\n\nUse documented idempotency/correlation and version preconditions only where the operation guarantees them. Setting a value and incrementing it have different replay risks. On an ambiguous lost relative-command response, report unknown or read back rather than blindly send again.\n\nRead [authorization rules](/docs/for-ai/guides/authorization-rules.md), [lighting](/docs/for-ai/guides/lighting.md) or the relevant task guide.\n",
+    "content": "# Using the REST API\n\nDiscover authorization metadata, then use [OAuth setup](/docs/for-ai/guides/authentication-and-dcr.md).\nStart with the [compact API catalog](/docs/for-ai/api-catalog.md). It\ncontains auth context, public operation links, parameter names and top-level JSON\nkeys. Obtain exact REST paths from its links or the [small operation index](/docs/for-ai/operations/index.md).\nFollow one operation's linked schemas for required/conditional fields and\nnested payloads. It does not inline all schemas or examples.\n\nFor SDK generation or a comprehensive contract download, request the\n[full OpenAPI document](/docs/references/openapi.yaml).\n\nThe website's `/api/` route serves this compact Markdown when the request puts\n`text/markdown` first in `Accept` (for example,\n`text/markdown, text/plain;q=0.9, text/html;q=0.8`). Browser HTML requests keep the\ninteractive reference. Add `?full=1` to explicitly retrieve the complete HTML\ncatalog; keep HTML in your accepted formats for that request. Both variants\ninclude `Vary: Accept` for caches. The direct compact Markdown URL works on both\nthe website and API host and does not depend on negotiation.\n\nEnumerate endpoints with endpoint:read. Follow returned pagination links/tokens exactly and stop only when continuation is absent. Inspect declared capabilities and versions; retrieve one message/attribute schema as needed. Send messages through POST /messages (the existing /messages/send alias also works). Never invent target IDs or message fields.\n\nFor filtered inventory including readable shared endpoints, use [POST /endpoint-query](/docs/for-ai/operations/endpointQuery.md). Its query accepts exact match and nested and/or/not predicates; read the request schema's supported fields rather than inventing comparisons or text search. A groupId predicate additionally needs group:read and access to that group. Keep the query, page size, expansions, forceDeviceQuery setting and grant unchanged while following paginationContext.nextToken. Empty pages can have a continuation. Cursors expire after fifteen minutes; restart without nextToken on a 400 cursor error.\n\nREST dispatch and subsequent physical observation are separate facts. A 202 describes unfinished work. A timeout can mean the operation already acted; inspect existing results/state before repeating. IR/Bluetooth fire-and-forget and long-delay devices may never provide immediate confirmation. Use bounded polling and report unresolved state. An endpoint edit marked committed with cleanup pending must not be repeated as though it failed.\n\nUse documented idempotency/correlation and version preconditions only where the operation guarantees them. Setting a value and incrementing it have different replay risks. On an ambiguous lost relative-command response, report unknown or read back rather than blindly send again.\n\nRead [authorization rules](/docs/for-ai/guides/authorization-rules.md), [lighting](/docs/for-ai/guides/lighting.md) or the relevant task guide.\n",
     "setupPrompt": null
   },
   {

package/generated/openapi.json

@@ -1086,7 +1086,12 @@
         "tags": [
           "Endpoints"
         ],
-        "description": "Query for endpoints",
+        "description": "Return a bounded page of authorized endpoints matching the shared Query expression, including endpoints shared by other owners. Read permission is evaluated before filtering, pagination and state expansion. See the request schema for supported fields and operators. Use groupId to select members of a readable room/group, then intersect type or declared interfaces to select lights. Group predicates additionally require group:read for delegated OAuth. Repeat the complete query settings and grant when following nextToken; cursors expire after fifteen minutes. Device attributes are returned only when expanded. Report per-target command acceptance and observed state separately; querying a group does not grant permission to control its members.",
+        "x-portos-conditional-scopes": {
+          "groupId": [
+            "group:read"
+          ]
+        },
         "requestBody": {
           "required": true,
           "content": {
@@ -1097,9 +1102,12 @@
               "example": {
                 "query": {
                   "match": {
-                    "key": "name",
-                    "value": "test"
+                    "key": "type",
+                    "value": "LIGHT"
                   }
+                },
+                "paginationContext": {
+                  "maxResults": 10
                 }
               }
             }
@@ -1114,16 +1122,13 @@
                   "$ref": "#/components/schemas/EndpointQueryResponse"
                 },
                 "example": {
-                  "results": [],
-                  "paginationContext": {
-                    "nextToken": "abc123"
-                  }
+                  "results": []
                 }
               }
             }
           },
           "400": {
-            "description": "Bad request - missing required parameters",
+            "description": "Invalid query, unsupported expansion, or invalid/expired/mismatched cursor.",
             "content": {
               "application/json": {
                 "schema": {
@@ -1152,6 +1157,51 @@
               }
             }
           },
+          "403": {
+            "description": "Missing conditional OAuth scope or permission to read a referenced group.",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/Error"
+                },
+                "example": {
+                  "message": "Permission to read the requested group is required.",
+                  "code": "FORBIDDEN",
+                  "family": "FORBIDDEN"
+                }
+              }
+            }
+          },
+          "404": {
+            "description": "A referenced group does not exist.",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/Error"
+                },
+                "example": {
+                  "message": "Requested group was not found.",
+                  "code": "NOT_FOUND",
+                  "family": "NOT_FOUND"
+                }
+              }
+            }
+          },
+          "409": {
+            "description": "A selected disabled endpoint cannot be forcibly refreshed.",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/Error"
+                },
+                "example": {
+                  "message": "endpoint messaging is disabled",
+                  "code": "ENDPOINT_DISABLED",
+                  "family": "CONFLICT"
+                }
+              }
+            }
+          },
           "500": {
             "description": "Internal server error",
             "content": {
@@ -13317,12 +13367,34 @@
         "x-version": "1.0",
         "x-type": "message",
         "x-directionality": "in",
+        "description": "Search for and play media by title or query using a service advertised by the endpoint. Omitting mediaType retains audio search behavior; video-only endpoints may default to video.",
         "type": "object",
         "properties": {
           "query": {
             "type": "string",
-            "description": "Query to search for audio content",
+            "description": "Query to search for media content",
             "minLength": 1
+          },
+          "provider": {
+            "$ref": "#/components/schemas/MediaProvider"
+          },
+          "mediaType": {
+            "type": "string",
+            "enum": [
+              "AUDIO",
+              "VIDEO"
+            ],
+            "description": "Media search domain. The endpoint must advertise support for the selected type.",
+            "x-enum-varnames": [
+              "MediaSearchTypeAudio",
+              "MediaSearchTypeVideo"
+            ]
+          },
+          "timerSeconds": {
+            "type": "integer",
+            "minimum": 1,
+            "maximum": 86400,
+            "description": "Optional provider playback timer in seconds."
           }
         },
         "required": [
@@ -14525,6 +14597,7 @@
               "LEFT",
               "RIGHT",
               "SELECT",
+              "HOME",
               "BACK",
               "EXIT",
               "MENU",
@@ -14637,6 +14710,16 @@
         "type": "object",
         "additionalProperties": false
       },
+      "MediaPlayerInterfaceFastForwardMessage": {
+        "x-namespace": "port1/systems/zero/capability-interfaces/media-player",
+        "x-name": "fast-forward",
+        "x-version": "1.0",
+        "x-type": "message",
+        "x-directionality": "in",
+        "description": "Begin provider-defined fast-forward playback. This does not seek by a specific duration; use skip-forward or seek for a known position change.",
+        "type": "object",
+        "additionalProperties": false
+      },
       "MediaPlayerInterfaceStartOverMessage": {
         "x-namespace": "port1/systems/zero/capability-interfaces/media-player",
         "x-name": "start-over",
@@ -15078,6 +15161,26 @@
           "brightness"
         ]
       },
+      "BrightnessInterfaceAdjustBrightnessMessage": {
+        "x-namespace": "port1/systems/zero/capability-interfaces/brightness",
+        "x-name": "adjust-brightness",
+        "x-version": "1.0",
+        "x-type": "message",
+        "x-directionality": "in",
+        "description": "Adjust brightness by a signed number of percentage points. The endpoint must advertise this message separately from set-brightness.",
+        "type": "object",
+        "properties": {
+          "brightnessDelta": {
+            "type": "integer",
+            "minimum": -100,
+            "maximum": 100
+          }
+        },
+        "required": [
+          "brightnessDelta"
+        ],
+        "additionalProperties": false
+      },
       "MediaSearchInterfaceAudioMediaResultsMessage": {
         "x-namespace": "port1/systems/zero/capability-interfaces/media-search",
         "x-name": "audio-media-results",
@@ -22076,6 +22179,7 @@
                 "LEFT",
                 "RIGHT",
                 "SELECT",
+                "HOME",
                 "BACK",
                 "EXIT",
                 "MENU",
@@ -22172,6 +22276,30 @@
         "description": "Configure media playback, media selection and audio playback. Advertise only the messages implemented by this endpoint.",
         "type": "object",
         "properties": {
+          "supportedAudioProviders": {
+            "type": "array",
+            "uniqueItems": true,
+            "description": "Audio services accepted by search-and-play on this endpoint. These describe command support, not active subscriptions.",
+            "items": {
+              "$ref": "#/components/schemas/MediaProvider"
+            }
+          },
+          "supportedVideoProviders": {
+            "type": "array",
+            "uniqueItems": true,
+            "description": "Video services accepted by search-and-play on this endpoint. These describe command support, not installed applications or active subscriptions.",
+            "items": {
+              "$ref": "#/components/schemas/MediaProvider"
+            }
+          },
+          "defaultAudioProvider": {
+            "$ref": "#/components/schemas/MediaProvider",
+            "description": "Default service for an audio search. Must be in supportedAudioProviders."
+          },
+          "defaultVideoProvider": {
+            "$ref": "#/components/schemas/MediaProvider",
+            "description": "Default service for a video search. Must be in supportedVideoProviders."
+          },
           "supportedPlaybackStates": {
             "type": "array",
             "items": {
@@ -22874,6 +23002,19 @@
         "x-version": "1.0",
         "x-type": "configuration",
         "type": "object",
+        "properties": {
+          "supportedInputTypes": {
+            "type": "array",
+            "uniqueItems": true,
+            "items": {
+              "type": "string",
+              "enum": [
+                "SSML",
+                "CANNED_TTS"
+              ]
+            }
+          }
+        },
         "additionalProperties": false
       },
       "TemperatureSensorInterfaceConfiguration": {
@@ -23657,22 +23798,50 @@
       },
       "EndpointQueryRequest": {
         "type": "object",
+        "additionalProperties": false,
         "required": [
           "query"
         ],
         "properties": {
           "query": {
-            "$ref": "#/components/schemas/Query"
+            "$ref": "#/components/schemas/Query",
+            "description": "A bounded shared Query expression. An empty object selects unfiltered readable inventory. This endpoint supports match, and, or, and not. Scalar match keys are id, name, type, ownerId, manufacturer, model, and enablement. interfaces matches membership in the endpoint's declared interface names; groupId matches membership in a readable endpoint group. Comparisons, patterns, freeform search, unknown keys, ambiguous nodes, expressions deeper than eight levels, or more than 64 nodes return 400. Values are exact strings. Collections hide disabled endpoints unless the expression explicitly filters enablement. Results include readable shared endpoints, regardless of their owner. A groupId predicate additionally requires group:read for delegated OAuth and read permission on that group."
           },
           "paginationContext": {
-            "$ref": "#/components/schemas/PaginationContext"
+            "type": "object",
+            "additionalProperties": false,
+            "properties": {
+              "maxResults": {
+                "type": "integer",
+                "minimum": 1,
+                "maximum": 100,
+                "default": 10,
+                "description": "Maximum authorized matching endpoints in this page."
+              },
+              "nextToken": {
+                "type": "string",
+                "minLength": 1,
+                "description": "Opaque server-issued continuation token. Repeat the same query, page size, expansions, forceDeviceQuery setting, and authenticated grant. Modified, expired, or differently bound tokens return 400; restart without nextToken. Follow nextToken until absent, including empty pages."
+              }
+            }
           },
           "expand": {
             "type": "array",
-            "description": "Expansion tokens that request related or computed endpoint fields.",
+            "uniqueItems": true,
+            "maxItems": 1,
+            "description": "Optional reported state expansion; only interfaces.attributes is supported.",
             "items": {
-              "type": "string"
+              "type": "string",
+              "enum": [
+                "interfaces.attributes"
+              ],
+              "x-enum-exempt": "Existing published REST expansion token shared with GET /endpoints."
             }
+          },
+          "forceDeviceQuery": {
+            "type": "boolean",
+            "default": false,
+            "description": "Refresh reported device attributes for the selected page. Requires expand to contain interfaces.attributes. An accepted command is not proof of device state; inspect the returned sample times and partial errors. Disabled endpoints cannot be forcibly refreshed."
           }
         }
       },
@@ -27021,6 +27190,42 @@
         },
         "additionalProperties": false
       },
+      "MediaProvider": {
+        "type": "string",
+        "description": "Media service identifier. A provider enum value does not imply that every endpoint supports that service; use the endpoint's advertised provider lists.",
+        "enum": [
+          "SPOTIFY",
+          "AMAZON_MUSIC",
+          "APPLE_MUSIC",
+          "AUDIBLE",
+          "TUNE_IN",
+          "PANDORA",
+          "IHEART_RADIO",
+          "SIRIUSXM",
+          "DEEZER",
+          "TIDAL",
+          "YOUTUBE",
+          "NETFLIX",
+          "PRIME_VIDEO",
+          "DAILYMOTION"
+        ],
+        "x-enum-varnames": [
+          "MediaProviderSpotify",
+          "MediaProviderAmazonMusic",
+          "MediaProviderAppleMusic",
+          "MediaProviderAudible",
+          "MediaProviderTuneIn",
+          "MediaProviderPandora",
+          "MediaProviderIHeartRadio",
+          "MediaProviderSiriusXM",
+          "MediaProviderDeezer",
+          "MediaProviderTidal",
+          "MediaProviderYouTube",
+          "MediaProviderNetflix",
+          "MediaProviderPrimeVideo",
+          "MediaProviderDailymotion"
+        ]
+      },
       "NotificationPayload": {
         "type": "object",
         "description": "Notification payload information",
@@ -27665,11 +27870,17 @@
           "type": {
             "type": "string",
             "enum": [
-              "SSML"
+              "SSML",
+              "CANNED_TTS"
             ]
           },
           "ssml": {
             "type": "string"
+          },
+          "cannedTtsStringId": {
+            "type": "string",
+            "minLength": 1,
+            "description": "Provider-defined canned speech identifier; supported only by integrations advertising canned speech."
           }
         }
       },