@portpowered/reference-data 0.4.7 → 0.4.9

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

@@ -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 – MessageHeader](/docs/for-ai/schemas/m-1.md) (40 components)
-- [MessageInterfaceConfiguration – MovementInstruction](/docs/for-ai/schemas/m-2.md) (14 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/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,36 @@ 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

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.yaml

@@ -144,10 +144,16 @@ messages:
           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
@@ -288,6 +294,39 @@ messages:
       type: object
       additionalProperties: false
 attributes:
+  - name: now-playing
+    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.
+    schema:
+      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
   - name: playback-speed
     description: null
     schema:
@@ -324,6 +363,36 @@ configuration:
     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

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

@@ -144,10 +144,16 @@ messages:
           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
@@ -288,6 +294,39 @@ messages:
       type: object
       additionalProperties: false
 attributes:
+  - name: now-playing
+    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.
+    schema:
+      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
   - name: playback-speed
     description: null
     schema:
@@ -324,6 +363,36 @@ configuration:
     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

package/generated/public/docs/references/capability-interfaces/media-playlist/1.0/messages/get-playlist.yaml

@@ -4,6 +4,15 @@ properties:
     type: string
     description: ID of the playlist to retrieve
     minLength: 1
+  maxResults:
+    type: integer
+    minimum: 1
+    maximum: 50
+    default: 20
+  nextToken:
+    type: string
+    minLength: 1
+    description: Opaque continuation for the same playlist.
 required:
   - playlistId
 additionalProperties: false

package/generated/public/docs/references/capability-interfaces/media-playlist/1.0/messages/list-playlists.yaml

@@ -0,0 +1,15 @@
+description: >-
+  List the connected customer's owned or followed playlists; use search-media
+  for catalog search.
+type: object
+properties:
+  maxResults:
+    type: integer
+    minimum: 1
+    maximum: 50
+    default: 20
+  nextToken:
+    type: string
+    minLength: 1
+required: []
+additionalProperties: false

package/generated/public/docs/references/capability-interfaces/media-playlist/1.0/messages/playlist-contents.yaml

@@ -0,0 +1,114 @@
+description: A bounded playlist page containing playable tracks or episodes.
+type: object
+properties:
+  playlistId:
+    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.
+  tracks:
+    type: array
+    items:
+      type: object
+      description: Track information
+      properties:
+        id:
+          type: string
+          description: Unique identifier for the track
+          minLength: 1
+        name:
+          type: string
+          description: Track name
+          minLength: 1
+        artists:
+          type: array
+          items:
+            type: object
+            description: Artist information
+            properties:
+              id:
+                type: string
+                description: Unique identifier for the artist
+                minLength: 1
+              name:
+                type: string
+                description: Artist name
+                minLength: 1
+            required:
+              - id
+              - name
+            additionalProperties: false
+            title: Artist
+          description: Track artists
+        album:
+          description: Track album
+          type: object
+          properties:
+            id:
+              type: string
+              description: Unique identifier for the album
+              minLength: 1
+            name:
+              type: string
+              description: Album name
+              minLength: 1
+            artists:
+              type: array
+              items:
+                $ref: '#/properties/tracks/items/properties/artists/items'
+              description: Album artists
+          required:
+            - id
+            - name
+            - artists
+          additionalProperties: false
+          title: Album
+      required:
+        - id
+        - name
+        - artists
+        - album
+      additionalProperties: false
+      title: Track
+  episodes:
+    type: array
+    items:
+      type: object
+      description: Provider-qualified podcast episode with selection metadata.
+      properties:
+        id:
+          $ref: '#/properties/playlistId'
+        name:
+          type: string
+          minLength: 1
+        showId:
+          $ref: '#/properties/playlistId'
+        releaseDate:
+          type: string
+          description: Provider release date; precision can be year, month or day.
+        releaseDatePrecision:
+          type: string
+          description: Provider date precision.
+      required:
+        - id
+        - name
+      additionalProperties: false
+      title: PodcastEpisode
+  nextToken:
+    type: string
+    minLength: 1
+required:
+  - playlistId
+  - tracks
+  - episodes
+additionalProperties: false

package/generated/public/docs/references/capability-interfaces/media-playlist/1.0/messages/playlists.yaml

@@ -0,0 +1,35 @@
+description: A page of the connected customer's playlists with exact resource IDs.
+type: object
+properties:
+  playlists:
+    type: array
+    items:
+      type: object
+      properties:
+        id:
+          type: string
+          description: Unique identifier for the playlist
+          minLength: 1
+        name:
+          type: string
+          description: Playlist name
+          minLength: 1
+        ownerId:
+          type: string
+          description: Provider-scoped owner identity, when supplied by the provider.
+        ownerName:
+          type: string
+          description: >-
+            Owner display name, useful for distinguishing owned and followed
+            playlists.
+      required:
+        - id
+        - name
+      additionalProperties: false
+      title: Playlist
+  nextToken:
+    type: string
+    minLength: 1
+required:
+  - playlists
+additionalProperties: false