@portpowered/reference-data 0.4.6 → 0.4.8

package/generated/public/docs/for-ai/capability-interfaces/brightness/1.0.md

@@ -10,6 +10,7 @@ Read scopes: endpoint:read. Inbound control scope: message:send. Resource permis
 
 ## Messages
 
+- [adjust-brightness](/docs/references/capability-interfaces/brightness/1.0/messages/adjust-brightness.yaml) (in): Adjust brightness by a signed number of percentage points. The endpoint must advertise this message separately from set-brightness.
 - [set-brightness](/docs/references/capability-interfaces/brightness/1.0/messages/set-brightness.yaml) (in): Use this exact payload schema.
 
 ## State attributes

package/generated/public/docs/for-ai/capability-interfaces/media-player/1.0.md

@@ -12,6 +12,7 @@ Read scopes: endpoint:read. Inbound control scope: message:send. Resource permis
 
 - [audio](/docs/references/capability-interfaces/media-player/1.0/messages/audio.yaml) (out): Use this exact payload schema.
 - [audio-stream](/docs/references/capability-interfaces/media-player/1.0/messages/audio-stream.yaml) (out): Use this exact payload schema.
+- [fast-forward](/docs/references/capability-interfaces/media-player/1.0/messages/fast-forward.yaml) (in): Begin provider-defined fast-forward playback. This does not seek by a specific duration; use skip-forward or seek for a known position change.
 - [next](/docs/references/capability-interfaces/media-player/1.0/messages/next.yaml) (in): Use this exact payload schema.
 - [pause](/docs/references/capability-interfaces/media-player/1.0/messages/pause.yaml) (in): Use this exact payload schema.
 - [play-audio](/docs/references/capability-interfaces/media-player/1.0/messages/play-audio.yaml) (in): Play a base64 encoded audio object on the endpoint. Requires audio output support; RTSP or SDP alone does not establish playback support.
@@ -20,7 +21,7 @@ Read scopes: endpoint:read. Inbound control scope: message:send. Resource permis
 - [play-uri](/docs/references/capability-interfaces/media-player/1.0/messages/play-uri.yaml) (in): Use this exact payload schema.
 - [previous](/docs/references/capability-interfaces/media-player/1.0/messages/previous.yaml) (in): Use this exact payload schema.
 - [rewind](/docs/references/capability-interfaces/media-player/1.0/messages/rewind.yaml) (in): Use this exact payload schema.
-- [search-and-play](/docs/references/capability-interfaces/media-player/1.0/messages/search-and-play.yaml) (in): Use this exact payload schema.
+- [search-and-play](/docs/references/capability-interfaces/media-player/1.0/messages/search-and-play.yaml) (in): 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.
 - [seek](/docs/references/capability-interfaces/media-player/1.0/messages/seek.yaml) (in): Use this exact payload schema.
 - [skip-backward](/docs/references/capability-interfaces/media-player/1.0/messages/skip-backward.yaml) (in): Use this exact payload schema.
 - [skip-forward](/docs/references/capability-interfaces/media-player/1.0/messages/skip-forward.yaml) (in): Use this exact payload schema.
@@ -29,5 +30,6 @@ Read scopes: endpoint:read. Inbound control scope: message:send. Resource permis
 
 ## State attributes
 
+- [now-playing](/docs/references/capability-interfaces/media-player/1.0/attributes/now-playing.yaml)
 - [playback-speed](/docs/references/capability-interfaces/media-player/1.0/attributes/playback-speed.yaml)
 - [playback-state](/docs/references/capability-interfaces/media-player/1.0/attributes/playback-state.yaml)

package/generated/public/docs/for-ai/capability-interfaces/media-playlist/1.0.md

@@ -13,7 +13,10 @@ Read scopes: endpoint:read. Inbound control scope: message:send. Resource permis
 - [add-to-playlist](/docs/references/capability-interfaces/media-playlist/1.0/messages/add-to-playlist.yaml) (in): Use this exact payload schema.
 - [create-playlist](/docs/references/capability-interfaces/media-playlist/1.0/messages/create-playlist.yaml) (in): Use this exact payload schema.
 - [get-playlist](/docs/references/capability-interfaces/media-playlist/1.0/messages/get-playlist.yaml) (in): Use this exact payload schema.
+- [list-playlists](/docs/references/capability-interfaces/media-playlist/1.0/messages/list-playlists.yaml) (in): List the connected customer's owned or followed playlists; use search-media for catalog search.
 - [play-playlist](/docs/references/capability-interfaces/media-playlist/1.0/messages/play-playlist.yaml) (in): Use this exact payload schema.
+- [playlist-contents](/docs/references/capability-interfaces/media-playlist/1.0/messages/playlist-contents.yaml) (out): A bounded playlist page containing playable tracks or episodes.
+- [playlists](/docs/references/capability-interfaces/media-playlist/1.0/messages/playlists.yaml) (out): A page of the connected customer's playlists with exact resource IDs.
 - [remove-from-playlist](/docs/references/capability-interfaces/media-playlist/1.0/messages/remove-from-playlist.yaml) (in): Use this exact payload schema.
 - [shuffle-playlist](/docs/references/capability-interfaces/media-playlist/1.0/messages/shuffle-playlist.yaml) (in): Use this exact payload schema.
 

package/generated/public/docs/for-ai/capability-interfaces/media-search/1.0.md

@@ -11,6 +11,8 @@ Read scopes: endpoint:read. Inbound control scope: message:send. Resource permis
 ## Messages
 
 - [audio-media-results](/docs/references/capability-interfaces/media-search/1.0/messages/audio-media-results.yaml) (out): Use this exact payload schema.
+- [get-media](/docs/references/capability-interfaces/media-search/1.0/messages/get-media.yaml) (in): Inspect an exact media resource or traverse an album/show. Use get-playlist for playlist contents.
+- [media-details](/docs/references/capability-interfaces/media-search/1.0/messages/media-details.yaml) (out): Exact media resource details and a bounded page of its children.
 - [search-media](/docs/references/capability-interfaces/media-search/1.0/messages/search-media.yaml) (in): Use this exact payload schema.
 
 ## State attributes

package/generated/public/docs/for-ai/schemas/b-1.md

@@ -17,6 +17,7 @@
 - [BatteryInterfaceBatteryAttribute](/docs/references/schemas/BatteryInterfaceBatteryAttribute.json) (schemas)
 - [BatteryInterfaceConfiguration](/docs/references/schemas/BatteryInterfaceConfiguration.json) (schemas)
 - [BrandingInformation](/docs/references/schemas/BrandingInformation.json) (schemas)
+- [BrightnessInterfaceAdjustBrightnessMessage](/docs/references/schemas/BrightnessInterfaceAdjustBrightnessMessage.json) (schemas)
 - [BrightnessInterfaceBrightnessAttribute](/docs/references/schemas/BrightnessInterfaceBrightnessAttribute.json) (schemas)
 - [BrightnessInterfaceConfiguration](/docs/references/schemas/BrightnessInterfaceConfiguration.json) (schemas)
 - [BrightnessInterfaceSetBrightnessMessage](/docs/references/schemas/BrightnessInterfaceSetBrightnessMessage.json) (schemas)

package/generated/public/docs/for-ai/schemas/m-1.md

@@ -9,7 +9,9 @@
 - [MediaPlayerInterfaceAudioMessage](/docs/references/schemas/MediaPlayerInterfaceAudioMessage.json) (schemas)
 - [MediaPlayerInterfaceAudioStreamMessage](/docs/references/schemas/MediaPlayerInterfaceAudioStreamMessage.json) (schemas)
 - [MediaPlayerInterfaceConfiguration](/docs/references/schemas/MediaPlayerInterfaceConfiguration.json) (schemas)
+- [MediaPlayerInterfaceFastForwardMessage](/docs/references/schemas/MediaPlayerInterfaceFastForwardMessage.json) (schemas)
 - [MediaPlayerInterfaceNextMessage](/docs/references/schemas/MediaPlayerInterfaceNextMessage.json) (schemas)
+- [MediaPlayerInterfaceNowPlayingAttribute](/docs/references/schemas/MediaPlayerInterfaceNowPlayingAttribute.json) (schemas)
 - [MediaPlayerInterfacePauseMessage](/docs/references/schemas/MediaPlayerInterfacePauseMessage.json) (schemas)
 - [MediaPlayerInterfacePlayAudioMessage](/docs/references/schemas/MediaPlayerInterfacePlayAudioMessage.json) (schemas)
 - [MediaPlayerInterfacePlaybackSpeedAttribute](/docs/references/schemas/MediaPlayerInterfacePlaybackSpeedAttribute.json) (schemas)
@@ -29,16 +31,14 @@
 - [MediaPlaylistInterfaceConfiguration](/docs/references/schemas/MediaPlaylistInterfaceConfiguration.json) (schemas)
 - [MediaPlaylistInterfaceCreatePlaylistMessage](/docs/references/schemas/MediaPlaylistInterfaceCreatePlaylistMessage.json) (schemas)
 - [MediaPlaylistInterfaceGetPlaylistMessage](/docs/references/schemas/MediaPlaylistInterfaceGetPlaylistMessage.json) (schemas)
+- [MediaPlaylistInterfaceListPlaylistsMessage](/docs/references/schemas/MediaPlaylistInterfaceListPlaylistsMessage.json) (schemas)
+- [MediaPlaylistInterfacePlaylistContentsMessage](/docs/references/schemas/MediaPlaylistInterfacePlaylistContentsMessage.json) (schemas)
+- [MediaPlaylistInterfacePlaylistsMessage](/docs/references/schemas/MediaPlaylistInterfacePlaylistsMessage.json) (schemas)
 - [MediaPlaylistInterfacePlayPlaylistMessage](/docs/references/schemas/MediaPlaylistInterfacePlayPlaylistMessage.json) (schemas)
 - [MediaPlaylistInterfaceRemoveFromPlaylistMessage](/docs/references/schemas/MediaPlaylistInterfaceRemoveFromPlaylistMessage.json) (schemas)
 - [MediaPlaylistInterfaceShufflePlaylistMessage](/docs/references/schemas/MediaPlaylistInterfaceShufflePlaylistMessage.json) (schemas)
+- [MediaProvider](/docs/references/schemas/MediaProvider.json) (schemas)
 - [MediaSearchCapabilityInterfaceConfiguration](/docs/references/schemas/MediaSearchCapabilityInterfaceConfiguration.json) (schemas)
 - [MediaSearchInterfaceAudioMediaResultsMessage](/docs/references/schemas/MediaSearchInterfaceAudioMediaResultsMessage.json) (schemas)
-- [MediaSearchInterfaceSearchMediaMessage](/docs/references/schemas/MediaSearchInterfaceSearchMediaMessage.json) (schemas)
-- [Message](/docs/references/schemas/Message.json) (schemas)
-- [MessageAuthorizationContext](/docs/references/schemas/MessageAuthorizationContext.json) (schemas)
-- [MessageContext](/docs/references/schemas/MessageContext.json) (schemas)
-- [MessageEndpoint](/docs/references/schemas/MessageEndpoint.json) (schemas)
-- [MessageHeader](/docs/references/schemas/MessageHeader.json) (schemas)
-- [MessageInterfaceConfiguration](/docs/references/schemas/MessageInterfaceConfiguration.json) (schemas)
-- [MessageSourceNodeConfiguration](/docs/references/schemas/MessageSourceNodeConfiguration.json) (schemas)
+- [MediaSearchInterfaceGetMediaMessage](/docs/references/schemas/MediaSearchInterfaceGetMediaMessage.json) (schemas)
+- [MediaSearchInterfaceMediaDetailsMessage](/docs/references/schemas/MediaSearchInterfaceMediaDetailsMessage.json) (schemas)

package/generated/public/docs/for-ai/schemas/m-2.md

@@ -2,6 +2,14 @@
 
 [Schema directory](/docs/for-ai/schemas.md). Follow only the components linked by your operation.
 
+- [MediaSearchInterfaceSearchMediaMessage](/docs/references/schemas/MediaSearchInterfaceSearchMediaMessage.json) (schemas)
+- [Message](/docs/references/schemas/Message.json) (schemas)
+- [MessageAuthorizationContext](/docs/references/schemas/MessageAuthorizationContext.json) (schemas)
+- [MessageContext](/docs/references/schemas/MessageContext.json) (schemas)
+- [MessageEndpoint](/docs/references/schemas/MessageEndpoint.json) (schemas)
+- [MessageHeader](/docs/references/schemas/MessageHeader.json) (schemas)
+- [MessageInterfaceConfiguration](/docs/references/schemas/MessageInterfaceConfiguration.json) (schemas)
+- [MessageSourceNodeConfiguration](/docs/references/schemas/MessageSourceNodeConfiguration.json) (schemas)
 - [MessageTarget](/docs/references/schemas/MessageTarget.json) (schemas)
 - [MessageTargetGroupRoute](/docs/references/schemas/MessageTargetGroupRoute.json) (schemas)
 - [MessageTargetGroupRouteReference](/docs/references/schemas/MessageTargetGroupRouteReference.json) (schemas)

package/generated/public/docs/for-ai/schemas/p-2.md

@@ -6,6 +6,8 @@
 - [PM10ConcentrationMeasurementInterfaceMeasuredValueAttribute](/docs/references/schemas/PM10ConcentrationMeasurementInterfaceMeasuredValueAttribute.json) (schemas)
 - [PM25ConcentrationMeasurementInterfaceConfiguration](/docs/references/schemas/PM25ConcentrationMeasurementInterfaceConfiguration.json) (schemas)
 - [PM25ConcentrationMeasurementInterfaceMeasuredValueAttribute](/docs/references/schemas/PM25ConcentrationMeasurementInterfaceMeasuredValueAttribute.json) (schemas)
+- [PodcastEpisode](/docs/references/schemas/PodcastEpisode.json) (schemas)
+- [PodcastShow](/docs/references/schemas/PodcastShow.json) (schemas)
 - [Position](/docs/references/schemas/Position.json) (schemas)
 - [PowerInterfaceConfiguration](/docs/references/schemas/PowerInterfaceConfiguration.json) (schemas)
 - [PowerInterfacePowerAttribute](/docs/references/schemas/PowerInterfacePowerAttribute.json) (schemas)

package/generated/public/docs/for-ai/schemas/s-3.md

@@ -4,6 +4,7 @@
 
 - [SupportedEvent](/docs/references/schemas/SupportedEvent.json) (schemas)
 - [SupportedInput](/docs/references/schemas/SupportedInput.json) (schemas)
+- [SupportedMediaResource](/docs/references/schemas/SupportedMediaResource.json) (schemas)
 - [SynchronizationItemError](/docs/references/schemas/SynchronizationItemError.json) (schemas)
 - [SynchronizationRequest](/docs/references/schemas/SynchronizationRequest.json) (schemas)
 - [SyntheticEventAccepted](/docs/references/schemas/SyntheticEventAccepted.json) (schemas)

package/generated/public/docs/for-ai/schemas.md

@@ -6,7 +6,7 @@ Start with [the REST operation directory](/docs/for-ai/operations/index.md) and
 
 - [AccessControlEntity – AuthorizationInterfaceAuthorizationUpdateReportMessage](/docs/for-ai/schemas/a-1.md) (40 components)
 - [AuthorizationInterfaceConfiguration – AuthResourceType](/docs/for-ai/schemas/a-2.md) (5 components)
-- [BarrierControlInterfaceBarrierPositionAttribute – BrightnessInterfaceSetBrightnessMessage](/docs/for-ai/schemas/b-1.md) (18 components)
+- [BarrierControlInterfaceBarrierPositionAttribute – BrightnessInterfaceSetBrightnessMessage](/docs/for-ai/schemas/b-1.md) (19 components)
 - [CalendarEvent – ColorTemperatureInterfaceSetColorTemperatureMessage](/docs/for-ai/schemas/c-1.md) (40 components)
 - [ConductivityInterfaceMeasuredValueAttribute – CooktopInterfaceOperationalStateAttribute](/docs/for-ai/schemas/c-2.md) (40 components)
 - [CreateEndpointGroupItem – CustomPluginSecret](/docs/for-ai/schemas/c-3.md) (12 components)
@@ -20,18 +20,18 @@ Start with [the REST operation directory](/docs/for-ai/operations/index.md) and
 - [InferenceNodeConfiguration – IfMatch](/docs/for-ai/schemas/i-1.md) (9 components)
 - [KeypadInputInterfaceConfiguration – KeypadInputInterfaceSendKeyMessage](/docs/for-ai/schemas/k-1.md) (2 components)
 - [LaundryDryerInterfaceConfiguration – LockInterfaceUnlockMessage](/docs/for-ai/schemas/l-1.md) (18 components)
-- [MeasurementRange – MessageSourceNodeConfiguration](/docs/for-ai/schemas/m-1.md) (40 components)
-- [MessageTarget – MovementInstruction](/docs/for-ai/schemas/m-2.md) (12 components)
+- [MeasurementRange – MediaSearchInterfaceMediaDetailsMessage](/docs/for-ai/schemas/m-1.md) (40 components)
+- [MediaSearchInterfaceSearchMediaMessage – MovementInstruction](/docs/for-ai/schemas/m-2.md) (20 components)
 - [NO2ConcMeasInterfaceConfiguration – NotificationTimeWindow](/docs/for-ai/schemas/n-1.md) (11 components)
 - [O3ConcMeasInterfaceConfiguration – OvenInterfaceTemperatureAttribute](/docs/for-ai/schemas/o-1.md) (16 components)
 - [PaginationContext – PluginType](/docs/for-ai/schemas/p-1.md) (40 components)
-- [PM10ConcentrationMeasurementInterfaceConfiguration – PumpConfigurationAndControlInterfaceSetSpeedMessage](/docs/for-ai/schemas/p-2.md) (25 components)
+- [PM10ConcentrationMeasurementInterfaceConfiguration – PumpConfigurationAndControlInterfaceSetSpeedMessage](/docs/for-ai/schemas/p-2.md) (27 components)
 - [Query – QueryFlowsResponse](/docs/for-ai/schemas/q-1.md) (4 components)
 - [RadioDiagnosticValue – RouteDiscoveryConfiguration](/docs/for-ai/schemas/r-1.md) (40 components)
 - [RouteDiscoveryInterfaceAddGroupRouteMembersMessage – RtspSessionInterfaceStopSessionResponseMessage](/docs/for-ai/schemas/r-2.md) (30 components)
 - [SceneInterfaceActivateMessage – SimulatorSharedFields](/docs/for-ai/schemas/s-1.md) (40 components)
 - [SimulatorV2 – SuctionLevel](/docs/for-ai/schemas/s-2.md) (40 components)
-- [SupportedEvent – SystemId](/docs/for-ai/schemas/s-3.md) (9 components)
+- [SupportedEvent – SystemId](/docs/for-ai/schemas/s-3.md) (10 components)
 - [TemperatureSensorInterfaceConfiguration – TypeValue](/docs/for-ai/schemas/t-1.md) (25 components)
 - [UpdateOAuthClientResponse – UpsertViewResponse](/docs/for-ai/schemas/u-1.md) (29 components)
 - [ValidateOAuthRequestRequest – ViewSchemaVersion](/docs/for-ai/schemas/v-1.md) (5 components)

package/generated/public/docs/references/capability-interfaces/brightness/1.0/messages/adjust-brightness.yaml

@@ -0,0 +1,12 @@
+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

package/generated/public/docs/references/capability-interfaces/brightness/1.0.yaml

@@ -5,6 +5,24 @@ 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
     directionality: in

package/generated/public/docs/references/capability-interfaces/brightness.yaml

@@ -5,6 +5,24 @@ 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
     directionality: in

package/generated/public/docs/references/capability-interfaces/keypad-input/1.0/configuration.yaml

@@ -20,6 +20,7 @@ properties:
         - LEFT
         - RIGHT
         - SELECT
+        - HOME
         - BACK
         - EXIT
         - MENU

package/generated/public/docs/references/capability-interfaces/keypad-input/1.0/messages/send-key.yaml

@@ -18,6 +18,7 @@ properties:
       - LEFT
       - RIGHT
       - SELECT
+      - HOME
       - BACK
       - EXIT
       - MENU

package/generated/public/docs/references/capability-interfaces/keypad-input/1.0.yaml

@@ -29,6 +29,7 @@ messages:
             - LEFT
             - RIGHT
             - SELECT
+            - HOME
             - BACK
             - EXIT
             - MENU
@@ -82,6 +83,7 @@ configuration:
           - LEFT
           - RIGHT
           - SELECT
+          - HOME
           - BACK
           - EXIT
           - MENU

package/generated/public/docs/references/capability-interfaces/keypad-input.yaml

@@ -29,6 +29,7 @@ messages:
             - LEFT
             - RIGHT
             - SELECT
+            - HOME
             - BACK
             - EXIT
             - MENU
@@ -82,6 +83,7 @@ configuration:
           - LEFT
           - RIGHT
           - SELECT
+          - HOME
           - BACK
           - EXIT
           - MENU

package/generated/public/docs/references/capability-interfaces/media-player/1.0/attributes/now-playing.yaml

@@ -0,0 +1,30 @@
+description: >-
+  Media identity observed on this route. Active false means the provider session
+  is on another target; it does not prove the speaker is silent through other
+  providers.
+type: object
+properties:
+  active:
+    type: boolean
+  mediaId:
+    title: MediaId
+    type: string
+    minLength: 1
+    example: portos-media://portpowered.com/spotify/audio/track/Ab123
+    pattern: >-
+      ^(portos-media://portpowered[.]com/[a-z][a-z0-9_-]*/(audio|video|image)/[a-z][a-z0-9_-]*/([^/?#\s]|%[0-9A-Fa-f]{2})+|https?://[^\s]+|portos://[^\s]+|youtube:video:[A-Za-z0-9_-]+)$
+    description: >
+      Exact provider resource identity. The canonical form is
+      portos-media://portpowered.com/provider/media-type/resource-kind/resource-id,
+      with no URI version. Spotify emits audio track, playlist, album, artist,
+      show and episode identities. Copy an ID returned by search or library
+      discovery; do not send a search phrase as an ID. Legacy providers retain
+      their own input contracts until explicitly migrated. See
+      https://portpowered.com/docs/media.
+  contextMediaId:
+    $ref: '#/properties/mediaId'
+  name:
+    type: string
+required:
+  - active
+additionalProperties: false

package/generated/public/docs/references/capability-interfaces/media-player/1.0/configuration.yaml

@@ -3,6 +3,76 @@ description: >-
   playback. Read playback state and use only the commands supported by the connected player.
 type: object
 properties:
+  supportedMediaResources:
+    type: array
+    description: >-
+      Exact play-media URI combinations accepted by this route. Member or endpoint unions do not
+      imply support by every route.
+    items:
+      title: SupportedMediaResource
+      description: A provider, media type and resource-kind combination accepted by a control route.
+      type: object
+      properties:
+        provider:
+          $ref: '#/properties/supportedAudioProviders/items'
+        mediaType:
+          type: string
+          enum:
+            - AUDIO
+            - VIDEO
+            - IMAGE
+        resourceKinds:
+          type: array
+          minItems: 1
+          uniqueItems: true
+          items:
+            type: string
+            description: Lowercase resource-kind segment from the provider URI.
+      required:
+        - provider
+        - mediaType
+        - resourceKinds
+      additionalProperties: false
+  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:

package/generated/public/docs/references/capability-interfaces/media-player/1.0/messages/fast-forward.yaml

@@ -0,0 +1,5 @@
+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

package/generated/public/docs/references/capability-interfaces/media-player/1.0/messages/play-media.yaml

@@ -4,11 +4,17 @@ properties:
     title: MediaId
     type: string
     minLength: 1
-    description: >-
-      Media IDs are a standardized identifier that Port OS uses to represent
-      media across YouTube, Spotify, and other media providers. See
-      https://portpowered.com/docs/media for the current media identifiers
-      documentation.
+    example: portos-media://portpowered.com/spotify/audio/track/Ab123
+    pattern: >-
+      ^(portos-media://portpowered[.]com/[a-z][a-z0-9_-]*/(audio|video|image)/[a-z][a-z0-9_-]*/([^/?#\s]|%[0-9A-Fa-f]{2})+|https?://[^\s]+|portos://[^\s]+|youtube:video:[A-Za-z0-9_-]+)$
+    description: >
+      Exact provider resource identity. The canonical form is
+      portos-media://portpowered.com/provider/media-type/resource-kind/resource-id,
+      with no URI version. Spotify emits audio track, playlist, album, artist,
+      show and episode identities. Copy an ID returned by search or library
+      discovery; do not send a search phrase as an ID. Legacy providers retain
+      their own input contracts until explicitly migrated. See
+      https://portpowered.com/docs/media.
 required:
   - mediaId
 additionalProperties: false

package/generated/public/docs/references/capability-interfaces/media-player/1.0/messages/search-and-play.yaml

@@ -1,9 +1,47 @@
+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:
   - query
 additionalProperties: false