@portpowered/reference-data 0.4.9 → 0.4.11

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (61) hide show
  1. package/generated/capabilities.json +288 -7
  2. package/generated/guides.json +4 -4
  3. package/generated/openapi.json +288 -10
  4. package/generated/public/docs/for-ai/api-catalog.md +3 -2
  5. package/generated/public/docs/for-ai/capability-interfaces/media-player/1.0.md +1 -0
  6. package/generated/public/docs/for-ai/capability-interfaces/reminders-provider/1.0.md +8 -2
  7. package/generated/public/docs/for-ai/guides/authentication-and-dcr.md +26 -4
  8. package/generated/public/docs/for-ai/guides/oauth-consent-and-callback.md +23 -1
  9. package/generated/public/docs/for-ai/guides/oauth-discovery.md +2 -2
  10. package/generated/public/docs/for-ai/guides/oauth-token-lifecycle.md +1 -1
  11. package/generated/public/docs/for-ai/operations/beginOAuthAuthorization.md +2 -2
  12. package/generated/public/docs/for-ai/operations/completeOAuthConsent.md +5 -2
  13. package/generated/public/docs/for-ai/operations/deliverOAuthAuthorizationResponse.md +74 -0
  14. package/generated/public/docs/for-ai/operations/index.md +1 -0
  15. package/generated/public/docs/for-ai/schemas/m-1.md +1 -1
  16. package/generated/public/docs/for-ai/schemas/m-2.md +1 -0
  17. package/generated/public/docs/for-ai/schemas/r-1.md +7 -7
  18. package/generated/public/docs/for-ai/schemas/r-2.md +7 -0
  19. package/generated/public/docs/for-ai/schemas.md +4 -4
  20. package/generated/public/docs/references/authorization.json +9 -0
  21. package/generated/public/docs/references/authorization.yaml +7 -0
  22. package/generated/public/docs/references/capability-interfaces/media-player/1.0/attributes/now-playing.yaml +7 -0
  23. package/generated/public/docs/references/capability-interfaces/media-player/1.0/messages/transfer-playback.yaml +10 -0
  24. package/generated/public/docs/references/capability-interfaces/media-player/1.0.yaml +26 -0
  25. package/generated/public/docs/references/capability-interfaces/media-player.yaml +26 -0
  26. package/generated/public/docs/references/capability-interfaces/reminders-provider/1.0/messages/create-reminder-response.yaml +33 -0
  27. package/generated/public/docs/references/capability-interfaces/reminders-provider/1.0/messages/create-reminder.yaml +20 -0
  28. package/generated/public/docs/references/capability-interfaces/reminders-provider/1.0/messages/delete-reminder-response.yaml +4 -0
  29. package/generated/public/docs/references/capability-interfaces/reminders-provider/1.0/messages/delete-reminder.yaml +16 -0
  30. package/generated/public/docs/references/capability-interfaces/reminders-provider/1.0/messages/list-reminders-response.yaml +34 -2
  31. package/generated/public/docs/references/capability-interfaces/reminders-provider/1.0/messages/list-reminders.yaml +17 -1
  32. package/generated/public/docs/references/capability-interfaces/reminders-provider/1.0/messages/update-reminder-response.yaml +33 -0
  33. package/generated/public/docs/references/capability-interfaces/reminders-provider/1.0/messages/update-reminder.yaml +26 -0
  34. package/generated/public/docs/references/capability-interfaces/reminders-provider/1.0.yaml +202 -4
  35. package/generated/public/docs/references/capability-interfaces/reminders-provider.yaml +202 -4
  36. package/generated/public/docs/references/manifest.json +208 -76
  37. package/generated/public/docs/references/openapi.yaml +241 -7
  38. package/generated/public/docs/references/schemas/MediaPlayerInterfaceNowPlayingAttribute.json +5 -0
  39. package/generated/public/docs/references/schemas/MediaPlayerInterfaceTransferPlaybackMessage.json +11 -0
  40. package/generated/public/docs/references/schemas/PluginAuthCodeExchangeRequest.json +4 -0
  41. package/generated/public/docs/references/schemas/Reminder.json +33 -0
  42. package/generated/public/docs/references/schemas/RemindersProviderInterfaceCreateReminderMessage.json +31 -0
  43. package/generated/public/docs/references/schemas/RemindersProviderInterfaceCreateReminderResponseMessage.json +20 -0
  44. package/generated/public/docs/references/schemas/RemindersProviderInterfaceDeleteReminderMessage.json +28 -0
  45. package/generated/public/docs/references/schemas/RemindersProviderInterfaceDeleteReminderResponseMessage.json +12 -0
  46. package/generated/public/docs/references/schemas/RemindersProviderInterfaceListRemindersMessage.json +23 -2
  47. package/generated/public/docs/references/schemas/RemindersProviderInterfaceListRemindersResponseMessage.json +15 -4
  48. package/generated/public/docs/references/schemas/RemindersProviderInterfaceUpdateReminderMessage.json +39 -0
  49. package/generated/public/docs/references/schemas/RemindersProviderInterfaceUpdateReminderResponseMessage.json +20 -0
  50. package/generated/public/docs/references/schemas/index.json +48 -0
  51. package/generated/resources/media-player/message-transfer-playback.json +5 -0
  52. package/generated/resources/media-player/state-now-playing.json +5 -0
  53. package/generated/resources/reminders-provider/message-create-reminder-response.json +44 -0
  54. package/generated/resources/reminders-provider/message-create-reminder.json +25 -0
  55. package/generated/resources/reminders-provider/message-delete-reminder-response.json +6 -0
  56. package/generated/resources/reminders-provider/message-delete-reminder.json +22 -0
  57. package/generated/resources/reminders-provider/message-list-reminders-response.json +44 -3
  58. package/generated/resources/reminders-provider/message-list-reminders.json +23 -2
  59. package/generated/resources/reminders-provider/message-update-reminder-response.json +44 -0
  60. package/generated/resources/reminders-provider/message-update-reminder.json +33 -0
  61. package/package.json +1 -1
@@ -0,0 +1,74 @@
1
+ # deliverOAuthAuthorizationResponse
2
+
3
+ GET `/oauth/authorization-response`
4
+
5
+ Redirect the browser to the approved OAuth callback
6
+
7
+ Navigate the browser here using the continuation returned by authenticated
8
+ consent. The opaque reference expires after two minutes and is consumed once.
9
+ The server chooses the stored callback; caller-supplied redirect destinations
10
+ are never used. Approval carries code, original state and issuer; denial
11
+ carries access_denied, original state and issuer. No bearer token is needed.
12
+
13
+
14
+ ## Authorization
15
+
16
+ ```yaml
17
+ path: /oauth/authorization-response
18
+ runtimePath: /oauth/authorization-response
19
+ method: GET
20
+ operationId: deliverOAuthAuthorizationResponse
21
+ security: []
22
+ delegated: false
23
+ resourcePermissionRequired: false
24
+ ```
25
+
26
+ ## Complete operation contract
27
+
28
+ ```yaml
29
+ path: /oauth/authorization-response
30
+ get:
31
+ operationId: deliverOAuthAuthorizationResponse
32
+ tags:
33
+ - Auth
34
+ security: []
35
+ x-portos-resource-permission: false
36
+ x-portos-delegated: false
37
+ summary: Redirect the browser to the approved OAuth callback
38
+ description: |
39
+ Navigate the browser here using the continuation returned by authenticated
40
+ consent. The opaque reference expires after two minutes and is consumed once.
41
+ The server chooses the stored callback; caller-supplied redirect destinations
42
+ are never used. Approval carries code, original state and issuer; denial
43
+ carries access_denied, original state and issuer. No bearer token is needed.
44
+ parameters:
45
+ - in: query
46
+ name: request_id
47
+ required: true
48
+ schema:
49
+ type: string
50
+ responses:
51
+ '303':
52
+ description: Navigate with GET to the exact registered callback.
53
+ headers:
54
+ Location:
55
+ schema:
56
+ type: string
57
+ format: uri
58
+ Cache-Control:
59
+ schema:
60
+ type: string
61
+ description: no-store
62
+ Referrer-Policy:
63
+ schema:
64
+ type: string
65
+ description: no-referrer
66
+ '400':
67
+ description: Missing, wrong-stage, expired or consumed continuation reference.
68
+ ```
69
+
70
+ ## Linked components
71
+
72
+ This operation uses inline schemas.
73
+
74
+ Follow only the linked components needed for this operation. [Schema directory](/docs/for-ai/schemas.md). [Auth guide](/docs/for-ai/guides/authentication-and-dcr.md).
@@ -79,6 +79,7 @@ Use the operation’s scopes and its resource permission requirements. Public di
79
79
  - [GET /oauth/authorize](/docs/for-ai/operations/beginOAuthAuthorization.md)
80
80
  - [POST /oauth/authorize](/docs/for-ai/operations/completeOAuthConsent.md)
81
81
  - [GET /oauth/authorization-request](/docs/for-ai/operations/getPendingOAuthConsent.md)
82
+ - [GET /oauth/authorization-response](/docs/for-ai/operations/deliverOAuthAuthorizationResponse.md)
82
83
  - [POST /oauth/validate-request](/docs/for-ai/operations/validateOAuthRequest.md)
83
84
  - [GET /oauth/verify-device](/docs/for-ai/operations/verifyDevice.md)
84
85
  - [POST /oauth/authorize-device](/docs/for-ai/operations/authorizeDevice.md)
@@ -27,6 +27,7 @@
27
27
  - [MediaPlayerInterfaceSkipForwardMessage](/docs/references/schemas/MediaPlayerInterfaceSkipForwardMessage.json) (schemas)
28
28
  - [MediaPlayerInterfaceStartOverMessage](/docs/references/schemas/MediaPlayerInterfaceStartOverMessage.json) (schemas)
29
29
  - [MediaPlayerInterfaceStopMessage](/docs/references/schemas/MediaPlayerInterfaceStopMessage.json) (schemas)
30
+ - [MediaPlayerInterfaceTransferPlaybackMessage](/docs/references/schemas/MediaPlayerInterfaceTransferPlaybackMessage.json) (schemas)
30
31
  - [MediaPlaylistInterfaceAddToPlaylistMessage](/docs/references/schemas/MediaPlaylistInterfaceAddToPlaylistMessage.json) (schemas)
31
32
  - [MediaPlaylistInterfaceConfiguration](/docs/references/schemas/MediaPlaylistInterfaceConfiguration.json) (schemas)
32
33
  - [MediaPlaylistInterfaceCreatePlaylistMessage](/docs/references/schemas/MediaPlaylistInterfaceCreatePlaylistMessage.json) (schemas)
@@ -41,4 +42,3 @@
41
42
  - [MediaSearchCapabilityInterfaceConfiguration](/docs/references/schemas/MediaSearchCapabilityInterfaceConfiguration.json) (schemas)
42
43
  - [MediaSearchInterfaceAudioMediaResultsMessage](/docs/references/schemas/MediaSearchInterfaceAudioMediaResultsMessage.json) (schemas)
43
44
  - [MediaSearchInterfaceGetMediaMessage](/docs/references/schemas/MediaSearchInterfaceGetMediaMessage.json) (schemas)
44
- - [MediaSearchInterfaceMediaDetailsMessage](/docs/references/schemas/MediaSearchInterfaceMediaDetailsMessage.json) (schemas)
@@ -2,6 +2,7 @@
2
2
 
3
3
  [Schema directory](/docs/for-ai/schemas.md). Follow only the components linked by your operation.
4
4
 
5
+ - [MediaSearchInterfaceMediaDetailsMessage](/docs/references/schemas/MediaSearchInterfaceMediaDetailsMessage.json) (schemas)
5
6
  - [MediaSearchInterfaceSearchMediaMessage](/docs/references/schemas/MediaSearchInterfaceSearchMediaMessage.json) (schemas)
6
7
  - [Message](/docs/references/schemas/Message.json) (schemas)
7
8
  - [MessageAuthorizationContext](/docs/references/schemas/MessageAuthorizationContext.json) (schemas)
@@ -15,10 +15,17 @@
15
15
  - [RefrigeratorInterfaceTemperatureAttribute](/docs/references/schemas/RefrigeratorInterfaceTemperatureAttribute.json) (schemas)
16
16
  - [RelationshipInterface](/docs/references/schemas/RelationshipInterface.json) (schemas)
17
17
  - [RelationshipType](/docs/references/schemas/RelationshipType.json) (schemas)
18
+ - [Reminder](/docs/references/schemas/Reminder.json) (schemas)
18
19
  - [ReminderList](/docs/references/schemas/ReminderList.json) (schemas)
19
20
  - [RemindersProviderCapabilityInterfaceConfiguration](/docs/references/schemas/RemindersProviderCapabilityInterfaceConfiguration.json) (schemas)
21
+ - [RemindersProviderInterfaceCreateReminderMessage](/docs/references/schemas/RemindersProviderInterfaceCreateReminderMessage.json) (schemas)
22
+ - [RemindersProviderInterfaceCreateReminderResponseMessage](/docs/references/schemas/RemindersProviderInterfaceCreateReminderResponseMessage.json) (schemas)
23
+ - [RemindersProviderInterfaceDeleteReminderMessage](/docs/references/schemas/RemindersProviderInterfaceDeleteReminderMessage.json) (schemas)
24
+ - [RemindersProviderInterfaceDeleteReminderResponseMessage](/docs/references/schemas/RemindersProviderInterfaceDeleteReminderResponseMessage.json) (schemas)
20
25
  - [RemindersProviderInterfaceListRemindersMessage](/docs/references/schemas/RemindersProviderInterfaceListRemindersMessage.json) (schemas)
21
26
  - [RemindersProviderInterfaceListRemindersResponseMessage](/docs/references/schemas/RemindersProviderInterfaceListRemindersResponseMessage.json) (schemas)
27
+ - [RemindersProviderInterfaceUpdateReminderMessage](/docs/references/schemas/RemindersProviderInterfaceUpdateReminderMessage.json) (schemas)
28
+ - [RemindersProviderInterfaceUpdateReminderResponseMessage](/docs/references/schemas/RemindersProviderInterfaceUpdateReminderResponseMessage.json) (schemas)
22
29
  - [RemoteControlInterfaceConfiguration](/docs/references/schemas/RemoteControlInterfaceConfiguration.json) (schemas)
23
30
  - [RemoteControlInterfaceEndSessionMessage](/docs/references/schemas/RemoteControlInterfaceEndSessionMessage.json) (schemas)
24
31
  - [RemoteControlInterfaceMoveMessage](/docs/references/schemas/RemoteControlInterfaceMoveMessage.json) (schemas)
@@ -35,10 +42,3 @@
35
42
  - [RoboticVacuumCleanerInterfaceCleanRoomMessage](/docs/references/schemas/RoboticVacuumCleanerInterfaceCleanRoomMessage.json) (schemas)
36
43
  - [RoboticVacuumCleanerInterfaceConfiguration](/docs/references/schemas/RoboticVacuumCleanerInterfaceConfiguration.json) (schemas)
37
44
  - [RoboticVacuumCleanerInterfaceOperationalStateAttribute](/docs/references/schemas/RoboticVacuumCleanerInterfaceOperationalStateAttribute.json) (schemas)
38
- - [RoboticVacuumCleanerInterfacePauseMessage](/docs/references/schemas/RoboticVacuumCleanerInterfacePauseMessage.json) (schemas)
39
- - [RoboticVacuumCleanerInterfaceReturnToDockMessage](/docs/references/schemas/RoboticVacuumCleanerInterfaceReturnToDockMessage.json) (schemas)
40
- - [RoboticVacuumCleanerInterfaceSetCleaningModeMessage](/docs/references/schemas/RoboticVacuumCleanerInterfaceSetCleaningModeMessage.json) (schemas)
41
- - [RoboticVacuumCleanerInterfaceStartMessage](/docs/references/schemas/RoboticVacuumCleanerInterfaceStartMessage.json) (schemas)
42
- - [RoboticVacuumCleanerInterfaceStopMessage](/docs/references/schemas/RoboticVacuumCleanerInterfaceStopMessage.json) (schemas)
43
- - [Route](/docs/references/schemas/Route.json) (schemas)
44
- - [RouteDiscoveryConfiguration](/docs/references/schemas/RouteDiscoveryConfiguration.json) (schemas)
@@ -2,6 +2,13 @@
2
2
 
3
3
  [Schema directory](/docs/for-ai/schemas.md). Follow only the components linked by your operation.
4
4
 
5
+ - [RoboticVacuumCleanerInterfacePauseMessage](/docs/references/schemas/RoboticVacuumCleanerInterfacePauseMessage.json) (schemas)
6
+ - [RoboticVacuumCleanerInterfaceReturnToDockMessage](/docs/references/schemas/RoboticVacuumCleanerInterfaceReturnToDockMessage.json) (schemas)
7
+ - [RoboticVacuumCleanerInterfaceSetCleaningModeMessage](/docs/references/schemas/RoboticVacuumCleanerInterfaceSetCleaningModeMessage.json) (schemas)
8
+ - [RoboticVacuumCleanerInterfaceStartMessage](/docs/references/schemas/RoboticVacuumCleanerInterfaceStartMessage.json) (schemas)
9
+ - [RoboticVacuumCleanerInterfaceStopMessage](/docs/references/schemas/RoboticVacuumCleanerInterfaceStopMessage.json) (schemas)
10
+ - [Route](/docs/references/schemas/Route.json) (schemas)
11
+ - [RouteDiscoveryConfiguration](/docs/references/schemas/RouteDiscoveryConfiguration.json) (schemas)
5
12
  - [RouteDiscoveryInterfaceAddGroupRouteMembersMessage](/docs/references/schemas/RouteDiscoveryInterfaceAddGroupRouteMembersMessage.json) (schemas)
6
13
  - [RouteDiscoveryInterfaceDiscoverRoutesMessage](/docs/references/schemas/RouteDiscoveryInterfaceDiscoverRoutesMessage.json) (schemas)
7
14
  - [RouteDiscoveryInterfaceRemoveGroupRouteMembersMessage](/docs/references/schemas/RouteDiscoveryInterfaceRemoveGroupRouteMembersMessage.json) (schemas)
@@ -20,15 +20,15 @@ Start with [the REST operation directory](/docs/for-ai/operations/index.md) and
20
20
  - [InferenceNodeConfiguration – IfMatch](/docs/for-ai/schemas/i-1.md) (9 components)
21
21
  - [KeypadInputInterfaceConfiguration – KeypadInputInterfaceSendKeyMessage](/docs/for-ai/schemas/k-1.md) (2 components)
22
22
  - [LaundryDryerInterfaceConfiguration – LockInterfaceUnlockMessage](/docs/for-ai/schemas/l-1.md) (18 components)
23
- - [MeasurementRange – MediaSearchInterfaceMediaDetailsMessage](/docs/for-ai/schemas/m-1.md) (40 components)
24
- - [MediaSearchInterfaceSearchMediaMessage – MovementInstruction](/docs/for-ai/schemas/m-2.md) (20 components)
23
+ - [MeasurementRange – MediaSearchInterfaceGetMediaMessage](/docs/for-ai/schemas/m-1.md) (40 components)
24
+ - [MediaSearchInterfaceMediaDetailsMessage – MovementInstruction](/docs/for-ai/schemas/m-2.md) (21 components)
25
25
  - [NO2ConcMeasInterfaceConfiguration – NotificationTimeWindow](/docs/for-ai/schemas/n-1.md) (11 components)
26
26
  - [O3ConcMeasInterfaceConfiguration – OvenInterfaceTemperatureAttribute](/docs/for-ai/schemas/o-1.md) (16 components)
27
27
  - [PaginationContext – PluginType](/docs/for-ai/schemas/p-1.md) (40 components)
28
28
  - [PM10ConcentrationMeasurementInterfaceConfiguration – PumpConfigurationAndControlInterfaceSetSpeedMessage](/docs/for-ai/schemas/p-2.md) (27 components)
29
29
  - [Query – QueryFlowsResponse](/docs/for-ai/schemas/q-1.md) (4 components)
30
- - [RadioDiagnosticValue – RouteDiscoveryConfiguration](/docs/for-ai/schemas/r-1.md) (40 components)
31
- - [RouteDiscoveryInterfaceAddGroupRouteMembersMessage – RtspSessionInterfaceStopSessionResponseMessage](/docs/for-ai/schemas/r-2.md) (30 components)
30
+ - [RadioDiagnosticValue – RoboticVacuumCleanerInterfaceOperationalStateAttribute](/docs/for-ai/schemas/r-1.md) (40 components)
31
+ - [RoboticVacuumCleanerInterfacePauseMessage – RtspSessionInterfaceStopSessionResponseMessage](/docs/for-ai/schemas/r-2.md) (37 components)
32
32
  - [SceneInterfaceActivateMessage – SimulatorSharedFields](/docs/for-ai/schemas/s-1.md) (40 components)
33
33
  - [SimulatorV2 – SuctionLevel](/docs/for-ai/schemas/s-2.md) (40 components)
34
34
  - [SupportedEvent – SystemId](/docs/for-ai/schemas/s-3.md) (10 components)
@@ -1127,6 +1127,15 @@
1127
1127
  "delegated": false,
1128
1128
  "resourcePermissionRequired": false
1129
1129
  },
1130
+ {
1131
+ "path": "/oauth/authorization-response",
1132
+ "runtimePath": "/oauth/authorization-response",
1133
+ "method": "GET",
1134
+ "operationId": "deliverOAuthAuthorizationResponse",
1135
+ "security": [],
1136
+ "delegated": false,
1137
+ "resourcePermissionRequired": false
1138
+ },
1130
1139
  {
1131
1140
  "path": "/oauth/validate-request",
1132
1141
  "runtimePath": "/oauth/validate-request",
@@ -694,6 +694,13 @@ operations:
694
694
  - bearerAuth: []
695
695
  delegated: false
696
696
  resourcePermissionRequired: false
697
+ - path: /oauth/authorization-response
698
+ runtimePath: /oauth/authorization-response
699
+ method: GET
700
+ operationId: deliverOAuthAuthorizationResponse
701
+ security: []
702
+ delegated: false
703
+ resourcePermissionRequired: false
697
704
  - path: /oauth/validate-request
698
705
  runtimePath: /oauth/validate-request
699
706
  method: POST
@@ -25,6 +25,13 @@ properties:
25
25
  $ref: '#/properties/mediaId'
26
26
  name:
27
27
  type: string
28
+ positionMs:
29
+ description: >-
30
+ Provider-observed position within the current media item in milliseconds.
31
+ Omitted when unknown. Compare fresh observations with media identity and
32
+ playback state; a track transition does not prove continuity.
33
+ type: integer
34
+ minimum: 0
28
35
  required:
29
36
  - active
30
37
  additionalProperties: false
@@ -0,0 +1,10 @@
1
+ description: >-
2
+ Move the current playback session of the destination route's connected
3
+ provider account to this one destination, preserving playing or paused state
4
+ and media context. Select an advertised destination route. This affects that
5
+ account's current session; it does not copy media, restart playback, transfer
6
+ between providers or accounts, or fan out to group members. Read fresh source
7
+ and destination state before and after dispatch to verify the move. An
8
+ unavailable target requires an explicit choice of another destination.
9
+ type: object
10
+ additionalProperties: false
@@ -293,6 +293,25 @@ messages:
293
293
  schema:
294
294
  type: object
295
295
  additionalProperties: false
296
+ - name: transfer-playback
297
+ description: >-
298
+ Move the current playback session of the destination route's connected provider account to
299
+ this one destination, preserving playing or paused state and media context. Select an
300
+ advertised destination route. This affects that account's current session; it does not copy
301
+ media, restart playback, transfer between providers or accounts, or fan out to group members.
302
+ Read fresh source and destination state before and after dispatch to verify the move. An
303
+ unavailable target requires an explicit choice of another destination.
304
+ directionality: in
305
+ schema:
306
+ description: >-
307
+ Move the current playback session of the destination route's connected provider account to
308
+ this one destination, preserving playing or paused state and media context. Select an
309
+ advertised destination route. This affects that account's current session; it does not copy
310
+ media, restart playback, transfer between providers or accounts, or fan out to group
311
+ members. Read fresh source and destination state before and after dispatch to verify the
312
+ move. An unavailable target requires an explicit choice of another destination.
313
+ type: object
314
+ additionalProperties: false
296
315
  attributes:
297
316
  - name: now-playing
298
317
  description: >-
@@ -324,6 +343,13 @@ attributes:
324
343
  $ref: '#/properties/mediaId'
325
344
  name:
326
345
  type: string
346
+ positionMs:
347
+ description: >-
348
+ Provider-observed position within the current media item in milliseconds. Omitted when
349
+ unknown. Compare fresh observations with media identity and playback state; a track
350
+ transition does not prove continuity.
351
+ type: integer
352
+ minimum: 0
327
353
  required:
328
354
  - active
329
355
  additionalProperties: false
@@ -293,6 +293,25 @@ messages:
293
293
  schema:
294
294
  type: object
295
295
  additionalProperties: false
296
+ - name: transfer-playback
297
+ description: >-
298
+ Move the current playback session of the destination route's connected provider account to
299
+ this one destination, preserving playing or paused state and media context. Select an
300
+ advertised destination route. This affects that account's current session; it does not copy
301
+ media, restart playback, transfer between providers or accounts, or fan out to group members.
302
+ Read fresh source and destination state before and after dispatch to verify the move. An
303
+ unavailable target requires an explicit choice of another destination.
304
+ directionality: in
305
+ schema:
306
+ description: >-
307
+ Move the current playback session of the destination route's connected provider account to
308
+ this one destination, preserving playing or paused state and media context. Select an
309
+ advertised destination route. This affects that account's current session; it does not copy
310
+ media, restart playback, transfer between providers or accounts, or fan out to group
311
+ members. Read fresh source and destination state before and after dispatch to verify the
312
+ move. An unavailable target requires an explicit choice of another destination.
313
+ type: object
314
+ additionalProperties: false
296
315
  attributes:
297
316
  - name: now-playing
298
317
  description: >-
@@ -324,6 +343,13 @@ attributes:
324
343
  $ref: '#/properties/mediaId'
325
344
  name:
326
345
  type: string
346
+ positionMs:
347
+ description: >-
348
+ Provider-observed position within the current media item in milliseconds. Omitted when
349
+ unknown. Compare fresh observations with media identity and playback state; a track
350
+ transition does not prove continuity.
351
+ type: integer
352
+ minimum: 0
327
353
  required:
328
354
  - active
329
355
  additionalProperties: false
@@ -0,0 +1,33 @@
1
+ description: The provider accepted the reminder change.
2
+ type: object
3
+ additionalProperties: false
4
+ properties:
5
+ reminder:
6
+ type: object
7
+ additionalProperties: false
8
+ description: A reminder and its current provider revision for guarded edits.
9
+ properties:
10
+ reminderId:
11
+ type: string
12
+ listId:
13
+ type: string
14
+ title:
15
+ type: string
16
+ notes:
17
+ type: string
18
+ completed:
19
+ type: boolean
20
+ revision:
21
+ type: string
22
+ description: >-
23
+ Omitted when the provider does not supply a revision; writes require
24
+ it.
25
+ required:
26
+ - reminderId
27
+ - listId
28
+ - title
29
+ - completed
30
+ title: Reminder
31
+ required:
32
+ - reminder
33
+ title: RemindersProviderInterfaceCreateReminderResponseMessage
@@ -0,0 +1,20 @@
1
+ description: >-
2
+ Create a reminder in a discovered list. Creation is sent once; refresh before
3
+ retrying an uncertain result.
4
+ type: object
5
+ additionalProperties: false
6
+ properties:
7
+ listId:
8
+ type: string
9
+ minLength: 1
10
+ description: Discovered list identifier.
11
+ title:
12
+ type: string
13
+ minLength: 1
14
+ description: Reminder title.
15
+ notes:
16
+ type: string
17
+ required:
18
+ - listId
19
+ - title
20
+ title: RemindersProviderInterfaceCreateReminderMessage
@@ -0,0 +1,4 @@
1
+ description: The provider accepted soft deletion of the reminder.
2
+ type: object
3
+ additionalProperties: false
4
+ title: RemindersProviderInterfaceDeleteReminderResponseMessage
@@ -0,0 +1,16 @@
1
+ description: Soft-delete a reminder using its last observed revision.
2
+ type: object
3
+ additionalProperties: false
4
+ properties:
5
+ reminderId:
6
+ type: string
7
+ minLength: 1
8
+ description: Reminder identifier.
9
+ revision:
10
+ type: string
11
+ minLength: 1
12
+ description: Revision from the latest listing.
13
+ required:
14
+ - reminderId
15
+ - revision
16
+ title: RemindersProviderInterfaceDeleteReminderMessage
@@ -1,5 +1,6 @@
1
- description: Response containing a list of reminder lists from a reminders provider
1
+ description: Reminder lists and one bounded page of reminders.
2
2
  type: object
3
+ additionalProperties: false
3
4
  properties:
4
5
  reminderLists:
5
6
  type: array
@@ -14,6 +15,37 @@ properties:
14
15
  required:
15
16
  - listId
16
17
  title: ReminderList
18
+ reminders:
19
+ type: array
20
+ items:
21
+ type: object
22
+ additionalProperties: false
23
+ description: A reminder and its current provider revision for guarded edits.
24
+ properties:
25
+ reminderId:
26
+ type: string
27
+ listId:
28
+ type: string
29
+ title:
30
+ type: string
31
+ notes:
32
+ type: string
33
+ completed:
34
+ type: boolean
35
+ revision:
36
+ type: string
37
+ description: >-
38
+ Omitted when the provider does not supply a revision; writes require
39
+ it.
40
+ required:
41
+ - reminderId
42
+ - listId
43
+ - title
44
+ - completed
45
+ title: Reminder
46
+ nextCursor:
47
+ type: string
17
48
  required:
18
49
  - reminderLists
19
- additionalProperties: false
50
+ - reminders
51
+ title: RemindersProviderInterfaceListRemindersResponseMessage
@@ -1,3 +1,19 @@
1
- description: Request to list reminders from a reminders provider
1
+ description: List reminder lists and their reminders. Omit listId to enumerate all lists.
2
2
  type: object
3
3
  additionalProperties: false
4
+ properties:
5
+ listId:
6
+ type: string
7
+ minLength: 1
8
+ description: List identifier from a previous listing.
9
+ includeCompleted:
10
+ type: boolean
11
+ default: false
12
+ cursor:
13
+ type: string
14
+ description: Opaque next-page cursor.
15
+ maxResults:
16
+ type: integer
17
+ minimum: 1
18
+ maximum: 1000
19
+ title: RemindersProviderInterfaceListRemindersMessage
@@ -0,0 +1,33 @@
1
+ description: The provider accepted the reminder change.
2
+ type: object
3
+ additionalProperties: false
4
+ properties:
5
+ reminder:
6
+ type: object
7
+ additionalProperties: false
8
+ description: A reminder and its current provider revision for guarded edits.
9
+ properties:
10
+ reminderId:
11
+ type: string
12
+ listId:
13
+ type: string
14
+ title:
15
+ type: string
16
+ notes:
17
+ type: string
18
+ completed:
19
+ type: boolean
20
+ revision:
21
+ type: string
22
+ description: >-
23
+ Omitted when the provider does not supply a revision; writes require
24
+ it.
25
+ required:
26
+ - reminderId
27
+ - listId
28
+ - title
29
+ - completed
30
+ title: Reminder
31
+ required:
32
+ - reminder
33
+ title: RemindersProviderInterfaceUpdateReminderResponseMessage
@@ -0,0 +1,26 @@
1
+ description: >-
2
+ Edit a reminder using its last observed revision; omitted fields are
3
+ preserved.
4
+ type: object
5
+ additionalProperties: false
6
+ properties:
7
+ reminderId:
8
+ type: string
9
+ minLength: 1
10
+ description: Reminder identifier.
11
+ revision:
12
+ type: string
13
+ minLength: 1
14
+ description: Revision from the latest listing.
15
+ title:
16
+ type: string
17
+ minLength: 1
18
+ description: Replacement title.
19
+ notes:
20
+ type: string
21
+ completed:
22
+ type: boolean
23
+ required:
24
+ - reminderId
25
+ - revision
26
+ title: RemindersProviderInterfaceUpdateReminderMessage