agl 43.2.0 → 43.3.0
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.
- package/changelog.md +20 -0
- package/dist_serve/bundle.js +2845 -2638
- package/dist_serve/bundle.js.map +2 -2
- package/dist_serve/bundle.js.third-party-notices.json +1 -1
- package/dist_serve/bundle.js.third-party-notices.txt +1 -1
- package/dist_ts/00_commitinfo_data.js +1 -1
- package/dist_ts/aglapi/aglapisurface.document.js +197 -17
- package/dist_ts/classes.accountsactions.d.ts +3 -1
- package/dist_ts/classes.accountsactions.js +21 -3
- package/dist_ts/classes.claudeharness.d.ts +16 -0
- package/dist_ts/classes.claudeharness.js +24 -2
- package/dist_ts/classes.codexclientadapter.d.ts +11 -0
- package/dist_ts/classes.codexclientadapter.js +14 -2
- package/dist_ts/classes.controller.d.ts +165 -11
- package/dist_ts/classes.controller.js +1095 -170
- package/dist_ts/classes.controllerdevices.d.ts +2 -0
- package/dist_ts/classes.controllerdevices.js +6 -1
- package/dist_ts/classes.inbox.d.ts +72 -0
- package/dist_ts/classes.inbox.js +231 -0
- package/dist_ts/classes.inferencerouter.d.ts +10 -0
- package/dist_ts/classes.inferencerouter.js +5 -3
- package/dist_ts/classes.inferenceservice.js +2 -2
- package/dist_ts/classes.mcpclient.d.ts +1 -1
- package/dist_ts/classes.mcpclient.js +24 -6
- package/dist_ts/classes.mcpcontrollerhost.js +3 -1
- package/dist_ts/classes.mcptools.js +13 -8
- package/dist_ts/classes.mcpvalidation.d.ts +5 -0
- package/dist_ts/classes.mcpvalidation.js +32 -2
- package/dist_ts/classes.nativesessions.d.ts +17 -4
- package/dist_ts/classes.nativesessions.js +41 -9
- package/dist_ts/classes.opencodeclient.d.ts +23 -2
- package/dist_ts/classes.opencodeclient.js +47 -3
- package/dist_ts/classes.publishedset.d.ts +38 -0
- package/dist_ts/classes.publishedset.js +50 -0
- package/dist_ts/classes.sessionfeed.d.ts +3 -3
- package/dist_ts/classes.sessionfeed.js +18 -26
- package/dist_ts/classes.systemmetricssampler.d.ts +6 -0
- package/dist_ts/classes.systemmetricssampler.js +15 -3
- package/dist_ts/classes.ticketstore.d.ts +50 -3
- package/dist_ts/classes.ticketstore.js +45 -8
- package/dist_ts/driver/classes.directreports.d.ts +14 -4
- package/dist_ts/driver/classes.directreports.js +25 -6
- package/dist_ts/driver/classes.driverservice.d.ts +44 -3
- package/dist_ts/driver/classes.driverservice.js +50 -16
- package/dist_ts/fleet/classes.claudeworkers.d.ts +21 -5
- package/dist_ts/fleet/classes.claudeworkers.js +142 -46
- package/dist_ts/fleet/classes.codexworkers.d.ts +16 -4
- package/dist_ts/fleet/classes.codexworkers.js +22 -5
- package/dist_ts/fleet/classes.workercommand.d.ts +6 -1
- package/dist_ts/fleet/classes.workercommand.js +15 -4
- package/dist_ts/fleet/classes.workers.d.ts +5 -1
- package/dist_ts/fleet/classes.workers.js +8 -2
- package/dist_ts/fleet/functions.unbounddrivers.js +2 -2
- package/dist_ts/fleet/functions.workervalidation.js +2 -2
- package/dist_ts/fleet/interfaces.workers.d.ts +21 -3
- package/dist_ts/fleet/interfaces.workers.js +1 -1
- package/dist_ts/functions.agentmessage.d.ts +3 -0
- package/dist_ts/functions.agentmessage.js +4 -1
- package/dist_ts/functions.deviceapi.d.ts +151 -4
- package/dist_ts/functions.deviceapi.js +893 -38
- package/dist_ts/functions.fleetworkercli.d.ts +1 -1
- package/dist_ts/functions.fleetworkercli.js +11 -8
- package/dist_ts/functions.inferencecli.js +3 -1
- package/dist_ts/functions.mcpfleetworkertools.js +2 -2
- package/dist_ts/functions.ticketvalidation.js +11 -2
- package/dist_ts/interfaces.auth.d.ts +1 -1
- package/dist_ts/interfaces.auth.js +9 -1
- package/dist_ts/plugins.d.ts +3 -1
- package/dist_ts/plugins.js +7 -2
- package/dist_ts_authswitch/authority-contract.d.ts +25 -0
- package/dist_ts_authswitch/authority-contract.js +1 -1
- package/dist_ts_authswitch/authority-overview.d.ts +8 -0
- package/dist_ts_authswitch/authority-overview.js +17 -6
- package/dist_ts_authswitch/authority-placement.d.ts +20 -16
- package/dist_ts_authswitch/authority-placement.js +17 -10
- package/dist_ts_authswitch/authority-renewal.d.ts +34 -0
- package/dist_ts_authswitch/authority-renewal.js +56 -0
- package/dist_ts_authswitch/classes.authoritybroker.d.ts +8 -0
- package/dist_ts_authswitch/classes.authoritybroker.js +35 -2
- package/dist_ts_authswitch/classes.authoritycli.d.ts +1 -0
- package/dist_ts_authswitch/classes.authoritycli.js +44 -3
- package/dist_ts_authswitch/classes.authorityclient.d.ts +6 -1
- package/dist_ts_authswitch/classes.authorityclient.js +12 -4
- package/dist_ts_authswitch/classes.authoritydaemon.js +8 -1
- package/dist_ts_authswitch/classes.authoritydatabase.js +6 -2
- package/dist_ts_authswitch/classes.authoritymodels.d.ts +7 -0
- package/dist_ts_authswitch/classes.authoritymodels.js +21 -5
- package/dist_ts_interfaces/devices.d.ts +1012 -5
- package/dist_ts_interfaces/devices.js +68 -2
- package/dist_ts_interfaces/fleetworkers.d.ts +5 -3
- package/dist_ts_interfaces/inbox.d.ts +234 -0
- package/dist_ts_interfaces/inbox.js +101 -0
- package/dist_ts_interfaces/index.d.ts +1 -0
- package/dist_ts_interfaces/index.js +2 -1
- package/dist_ts_interfaces/interfaces.d.ts +10 -3
- package/dist_ts_interfaces/interfaces.js +4 -2
- package/dist_ts_interfaces/mcprequests.d.ts +34 -4
- package/dist_ts_interfaces/mcprequests.js +11 -1
- package/dist_ts_interfaces/mcpworkspacerequests.d.ts +4 -1
- package/dist_ts_interfaces/mcpworkspacerequests.js +1 -1
- package/dist_ts_interfaces/nativesessions.d.ts +16 -3
- package/dist_ts_interfaces/plugins.d.ts +2 -1
- package/dist_ts_interfaces/plugins.js +4 -2
- package/dist_ts_interfaces/requests.accounts.d.ts +21 -0
- package/dist_ts_interfaces/requests.accounts.js +3 -1
- package/dist_ts_interfaces/requests.d.ts +3 -2
- package/dist_ts_interfaces/requests.js +1 -1
- package/docs/authswitch.md +20 -1
- package/package.json +3 -3
- package/readme.md +112 -26
- package/ts/00_commitinfo_data.ts +1 -1
- package/ts/aglapi/aglapisurface.document.ts +196 -16
- package/ts/classes.accountsactions.ts +30 -3
- package/ts/classes.claudeharness.ts +27 -1
- package/ts/classes.codexclientadapter.ts +14 -1
- package/ts/classes.controller.ts +1294 -246
- package/ts/classes.controllerdevices.ts +6 -0
- package/ts/classes.inbox.ts +239 -0
- package/ts/classes.inferencerouter.ts +15 -2
- package/ts/classes.inferenceservice.ts +1 -1
- package/ts/classes.mcpclient.ts +24 -3
- package/ts/classes.mcpcontrollerhost.ts +2 -0
- package/ts/classes.mcptools.ts +12 -7
- package/ts/classes.mcpvalidation.ts +27 -1
- package/ts/classes.nativesessions.ts +50 -12
- package/ts/classes.opencodeclient.ts +55 -4
- package/ts/classes.publishedset.ts +56 -0
- package/ts/classes.sessionfeed.ts +17 -20
- package/ts/classes.systemmetricssampler.ts +13 -2
- package/ts/classes.ticketstore.ts +73 -12
- package/ts/driver/classes.directreports.ts +25 -6
- package/ts/driver/classes.driverservice.ts +75 -14
- package/ts/fleet/classes.claudeworkers.ts +112 -39
- package/ts/fleet/classes.codexworkers.ts +21 -6
- package/ts/fleet/classes.workercommand.ts +14 -4
- package/ts/fleet/classes.workers.ts +9 -2
- package/ts/fleet/functions.unbounddrivers.ts +1 -1
- package/ts/fleet/functions.workervalidation.ts +1 -1
- package/ts/fleet/interfaces.workers.ts +20 -5
- package/ts/functions.agentmessage.ts +3 -0
- package/ts/functions.deviceapi.ts +1071 -34
- package/ts/functions.fleetworkercli.ts +10 -7
- package/ts/functions.inferencecli.ts +2 -0
- package/ts/functions.mcpfleetworkertools.ts +1 -1
- package/ts/functions.ticketvalidation.ts +11 -1
- package/ts/interfaces.auth.ts +8 -0
- package/ts/plugins.ts +7 -0
- package/ts_authswitch/authority-contract.ts +20 -0
- package/ts_authswitch/authority-overview.ts +28 -6
- package/ts_authswitch/authority-placement.ts +25 -17
- package/ts_authswitch/authority-renewal.ts +64 -0
- package/ts_authswitch/classes.authoritybroker.ts +34 -1
- package/ts_authswitch/classes.authoritycli.ts +49 -2
- package/ts_authswitch/classes.authorityclient.ts +14 -4
- package/ts_authswitch/classes.authoritydaemon.ts +9 -1
- package/ts_authswitch/classes.authoritydatabase.ts +5 -1
- package/ts_authswitch/classes.authoritymodels.ts +23 -3
- package/ts_authswitch/native-contracts.md +21 -0
- package/ts_authswitch/readme.md +1 -1
- package/ts_interfaces/devices.schema.json +3573 -603
- package/ts_interfaces/devices.ts +1093 -4
- package/ts_interfaces/fleetworkers.ts +5 -3
- package/ts_interfaces/inbox.ts +287 -0
- package/ts_interfaces/index.ts +1 -0
- package/ts_interfaces/interfaces.ts +9 -2
- package/ts_interfaces/mcprequests.ts +43 -4
- package/ts_interfaces/mcpworkspacerequests.ts +4 -2
- package/ts_interfaces/nativesessions.ts +17 -3
- package/ts_interfaces/plugins.ts +3 -1
- package/ts_interfaces/requests.accounts.ts +20 -0
- package/ts_interfaces/requests.ts +4 -0
- package/ts_web/00_commitinfo_data.ts +1 -1
- package/ts_web/accounts.plugins.ts +4 -2
- package/ts_web/classes.accountsreadmodel.ts +33 -0
- package/ts_web/classes.browserpresentation.ts +10 -5
- package/ts_web/classes.inboxfeed.ts +329 -0
- package/ts_web/classes.nativesessionstate.ts +9 -23
- package/ts_web/elements.accounts.ts +81 -0
- package/ts_web/elements.deployments.ts +66 -2
- package/ts_web/elements.harnesscontrollerapp.ts +107 -37
- package/ts_web/elements.inbox.ts +808 -0
- package/ts_web/functions.inbox.ts +95 -0
- package/ts_web/functions.sessioncards.ts +40 -0
- package/ts_web/plugins.ts +2 -0
|
@@ -66,267 +66,193 @@
|
|
|
66
66
|
}
|
|
67
67
|
},
|
|
68
68
|
{
|
|
69
|
-
"name": "
|
|
70
|
-
"method": "device.
|
|
71
|
-
"description": "
|
|
69
|
+
"name": "IReq_DeviceBoardList",
|
|
70
|
+
"method": "device.board.list",
|
|
71
|
+
"description": "One column of the shared board, as the browser's board shows its cards: the tasks (an epic and its subtasks show on their task's card in the browser; a device opens them with `device.ticket.get`), in the column's order, `limit` from `offset` on. The filters are the browser board's: `text` (in the key, title, description and source words), `project`, `epic` (the epic's own tasks), `assignee` and an AutoLabel `label`. `columns` counts every column under the same filters, from the same read as the page; `total` is the requested column's count. `projects` are those the board's tickets name and `epics` the epics a filter may choose: in the chosen project (their own or one of their tasks'), and the chosen epic. `revision` is the board's: when a later page answers another revision, or `tickets.changed` arrives, a client reads the board again from offset 0. Scope `device`. Since protocol 1.3.",
|
|
72
72
|
"request": {
|
|
73
73
|
"type": "object",
|
|
74
74
|
"properties": {
|
|
75
|
-
"
|
|
76
|
-
"
|
|
75
|
+
"column": {
|
|
76
|
+
"$ref": "#/components/schemas/TDeviceTicketColumn"
|
|
77
77
|
},
|
|
78
|
-
"
|
|
78
|
+
"text": {
|
|
79
|
+
"type": "string",
|
|
80
|
+
"description": "1 to 200 characters."
|
|
81
|
+
},
|
|
82
|
+
"project": {
|
|
79
83
|
"type": "string"
|
|
80
84
|
},
|
|
81
|
-
"
|
|
82
|
-
"
|
|
83
|
-
|
|
84
|
-
|
|
85
|
-
|
|
86
|
-
|
|
87
|
-
|
|
88
|
-
"
|
|
89
|
-
|
|
90
|
-
|
|
91
|
-
|
|
92
|
-
|
|
93
|
-
|
|
94
|
-
|
|
95
|
-
"
|
|
96
|
-
"type": "
|
|
97
|
-
|
|
98
|
-
},
|
|
99
|
-
"required": [
|
|
100
|
-
"success"
|
|
101
|
-
],
|
|
102
|
-
"additionalProperties": false
|
|
103
|
-
}
|
|
104
|
-
},
|
|
105
|
-
{
|
|
106
|
-
"name": "IReq_DeviceEventPush",
|
|
107
|
-
"method": "device.event",
|
|
108
|
-
"description": "An event, sent by the controller to an authenticated device connection.",
|
|
109
|
-
"request": {
|
|
110
|
-
"type": "object",
|
|
111
|
-
"properties": {
|
|
112
|
-
"event": {
|
|
113
|
-
"$ref": "#/components/schemas/TDeviceEvent"
|
|
85
|
+
"epic": {
|
|
86
|
+
"type": "string",
|
|
87
|
+
"description": "The epic's key."
|
|
88
|
+
},
|
|
89
|
+
"assignee": {
|
|
90
|
+
"$ref": "#/components/schemas/TDeviceAssigneeFilter"
|
|
91
|
+
},
|
|
92
|
+
"label": {
|
|
93
|
+
"$ref": "#/components/schemas/TDeviceTicketAutoLabel"
|
|
94
|
+
},
|
|
95
|
+
"offset": {
|
|
96
|
+
"type": "integer",
|
|
97
|
+
"description": "Tickets of the column to skip, 0 when absent."
|
|
98
|
+
},
|
|
99
|
+
"limit": {
|
|
100
|
+
"type": "integer",
|
|
101
|
+
"description": "Tickets on the page, 1 to 100 (default 50)."
|
|
114
102
|
}
|
|
115
103
|
},
|
|
116
104
|
"required": [
|
|
117
|
-
"
|
|
105
|
+
"column"
|
|
118
106
|
],
|
|
119
107
|
"additionalProperties": false
|
|
120
108
|
},
|
|
121
|
-
"response": {
|
|
122
|
-
"type": "object",
|
|
123
|
-
"additionalProperties": false
|
|
124
|
-
}
|
|
125
|
-
},
|
|
126
|
-
{
|
|
127
|
-
"name": "IReq_DeviceHello",
|
|
128
|
-
"method": "device.hello",
|
|
129
|
-
"description": "The device protocol of this controller. A device speaks one major; minors only add. Unauthenticated (scope `devicePairing`).",
|
|
130
|
-
"request": {
|
|
131
|
-
"type": "object",
|
|
132
|
-
"additionalProperties": false
|
|
133
|
-
},
|
|
134
109
|
"response": {
|
|
135
110
|
"type": "object",
|
|
136
111
|
"properties": {
|
|
137
|
-
"
|
|
112
|
+
"revision": {
|
|
138
113
|
"type": "integer"
|
|
139
114
|
},
|
|
140
|
-
"
|
|
115
|
+
"columns": {
|
|
116
|
+
"type": "array",
|
|
117
|
+
"items": {
|
|
118
|
+
"$ref": "#/components/schemas/IDeviceBoardColumn"
|
|
119
|
+
}
|
|
120
|
+
},
|
|
121
|
+
"tickets": {
|
|
122
|
+
"type": "array",
|
|
123
|
+
"items": {
|
|
124
|
+
"$ref": "#/components/schemas/IDeviceTicketCard"
|
|
125
|
+
}
|
|
126
|
+
},
|
|
127
|
+
"total": {
|
|
141
128
|
"type": "integer"
|
|
129
|
+
},
|
|
130
|
+
"projects": {
|
|
131
|
+
"type": "array",
|
|
132
|
+
"items": {
|
|
133
|
+
"type": "string"
|
|
134
|
+
}
|
|
135
|
+
},
|
|
136
|
+
"epics": {
|
|
137
|
+
"type": "array",
|
|
138
|
+
"items": {
|
|
139
|
+
"$ref": "#/components/schemas/IDeviceTicketRef"
|
|
140
|
+
}
|
|
142
141
|
}
|
|
143
142
|
},
|
|
144
143
|
"required": [
|
|
145
|
-
"
|
|
146
|
-
"
|
|
144
|
+
"revision",
|
|
145
|
+
"columns",
|
|
146
|
+
"tickets",
|
|
147
|
+
"total",
|
|
148
|
+
"projects",
|
|
149
|
+
"epics"
|
|
147
150
|
],
|
|
148
151
|
"additionalProperties": false
|
|
149
152
|
}
|
|
150
153
|
},
|
|
151
154
|
{
|
|
152
|
-
"name": "
|
|
153
|
-
"method": "device.
|
|
154
|
-
"description": "
|
|
155
|
+
"name": "IReq_DeviceDirectReportMessage",
|
|
156
|
+
"method": "device.directreport.message",
|
|
157
|
+
"description": "Sends the active direct report `name` the owner's message, as the Driver view does: a fleet worker is steered through the report's ticket and the request resolves once the fleet settled the steer (a failed steer is refused with `direct_report_failed`); a Codex thread takes it as the owner's agent message, steered into the turn AGL runs or else its next turn. A turn another Codex client runs is refused with `direct_report_busy`, a Claude Code session the fleet does not run with `direct_report_failed`, and messages to a report faster than its agent message rate with `rate_limited`. Scope `device`. Since protocol 1.3.",
|
|
155
158
|
"request": {
|
|
156
159
|
"type": "object",
|
|
157
160
|
"properties": {
|
|
158
|
-
"code": {
|
|
159
|
-
"type": "string",
|
|
160
|
-
"description": "The QR's code: base64url (no padding) of 32 bytes."
|
|
161
|
-
},
|
|
162
161
|
"name": {
|
|
163
|
-
"type": "string"
|
|
164
|
-
"description": "The device's name, at most 64 characters."
|
|
165
|
-
},
|
|
166
|
-
"model": {
|
|
167
|
-
"type": "string",
|
|
168
|
-
"description": "The hardware model, at most 64 characters."
|
|
169
|
-
},
|
|
170
|
-
"publicKey": {
|
|
171
|
-
"type": "string",
|
|
172
|
-
"description": "The P-256 public key: SubjectPublicKeyInfo DER, base64url."
|
|
162
|
+
"type": "string"
|
|
173
163
|
},
|
|
174
|
-
"
|
|
164
|
+
"text": {
|
|
175
165
|
"type": "string",
|
|
176
|
-
"description": "
|
|
166
|
+
"description": "At most 64 KiB of UTF-8 (16 KiB for a Codex thread), not blank."
|
|
177
167
|
}
|
|
178
168
|
},
|
|
179
169
|
"required": [
|
|
180
|
-
"code",
|
|
181
170
|
"name",
|
|
182
|
-
"
|
|
183
|
-
"publicKey",
|
|
184
|
-
"proof"
|
|
171
|
+
"text"
|
|
185
172
|
],
|
|
186
173
|
"additionalProperties": false
|
|
187
174
|
},
|
|
188
175
|
"response": {
|
|
189
176
|
"type": "object",
|
|
190
177
|
"properties": {
|
|
191
|
-
"
|
|
192
|
-
"
|
|
193
|
-
},
|
|
194
|
-
"name": {
|
|
195
|
-
"type": "string",
|
|
196
|
-
"description": "The name AGL keeps for the device."
|
|
178
|
+
"delivery": {
|
|
179
|
+
"$ref": "#/components/schemas/TDeviceDirectReportDelivery"
|
|
197
180
|
}
|
|
198
181
|
},
|
|
199
182
|
"required": [
|
|
200
|
-
"
|
|
201
|
-
"name"
|
|
183
|
+
"delivery"
|
|
202
184
|
],
|
|
203
185
|
"additionalProperties": false
|
|
204
186
|
}
|
|
205
187
|
},
|
|
206
188
|
{
|
|
207
|
-
"name": "
|
|
208
|
-
"method": "device.
|
|
209
|
-
"description": "
|
|
189
|
+
"name": "IReq_DeviceDirectReportsList",
|
|
190
|
+
"method": "device.directreports.list",
|
|
191
|
+
"description": "The owner's active direct reports, as the Driver view lists them. Scope `device`. Since protocol 1.3.",
|
|
210
192
|
"request": {
|
|
211
193
|
"type": "object",
|
|
212
|
-
"properties": {
|
|
213
|
-
"sessionId": {
|
|
214
|
-
"type": "string"
|
|
215
|
-
},
|
|
216
|
-
"permissionId": {
|
|
217
|
-
"type": "string"
|
|
218
|
-
},
|
|
219
|
-
"reply": {
|
|
220
|
-
"type": "string",
|
|
221
|
-
"enum": [
|
|
222
|
-
"once",
|
|
223
|
-
"reject"
|
|
224
|
-
]
|
|
225
|
-
},
|
|
226
|
-
"message": {
|
|
227
|
-
"type": "string",
|
|
228
|
-
"description": "Sent along with the answer where the harness takes one (OpenCode)."
|
|
229
|
-
}
|
|
230
|
-
},
|
|
231
|
-
"required": [
|
|
232
|
-
"sessionId",
|
|
233
|
-
"permissionId",
|
|
234
|
-
"reply"
|
|
235
|
-
],
|
|
236
194
|
"additionalProperties": false
|
|
237
195
|
},
|
|
238
196
|
"response": {
|
|
239
197
|
"type": "object",
|
|
240
198
|
"properties": {
|
|
241
|
-
"
|
|
242
|
-
"type": "
|
|
199
|
+
"reports": {
|
|
200
|
+
"type": "array",
|
|
201
|
+
"items": {
|
|
202
|
+
"$ref": "#/components/schemas/IDeviceDirectReport"
|
|
203
|
+
}
|
|
243
204
|
}
|
|
244
205
|
},
|
|
245
206
|
"required": [
|
|
246
|
-
"
|
|
207
|
+
"reports"
|
|
247
208
|
],
|
|
248
209
|
"additionalProperties": false
|
|
249
210
|
}
|
|
250
211
|
},
|
|
251
212
|
{
|
|
252
|
-
"name": "
|
|
253
|
-
"method": "device.
|
|
254
|
-
"description": "
|
|
213
|
+
"name": "IReq_DeviceDriverGet",
|
|
214
|
+
"method": "device.driver.get",
|
|
215
|
+
"description": "The host's driver now. Scope `device`. Since protocol 1.3.",
|
|
255
216
|
"request": {
|
|
256
217
|
"type": "object",
|
|
257
|
-
"properties": {
|
|
258
|
-
"sessionId": {
|
|
259
|
-
"type": "string"
|
|
260
|
-
},
|
|
261
|
-
"questionId": {
|
|
262
|
-
"type": "string"
|
|
263
|
-
},
|
|
264
|
-
"answers": {
|
|
265
|
-
"anyOf": [
|
|
266
|
-
{
|
|
267
|
-
"type": "array",
|
|
268
|
-
"items": {
|
|
269
|
-
"type": "array",
|
|
270
|
-
"items": {
|
|
271
|
-
"type": "string"
|
|
272
|
-
}
|
|
273
|
-
}
|
|
274
|
-
},
|
|
275
|
-
{
|
|
276
|
-
"type": "null"
|
|
277
|
-
}
|
|
278
|
-
]
|
|
279
|
-
}
|
|
280
|
-
},
|
|
281
|
-
"required": [
|
|
282
|
-
"sessionId",
|
|
283
|
-
"questionId",
|
|
284
|
-
"answers"
|
|
285
|
-
],
|
|
286
218
|
"additionalProperties": false
|
|
287
219
|
},
|
|
288
220
|
"response": {
|
|
289
221
|
"type": "object",
|
|
290
222
|
"properties": {
|
|
291
|
-
"
|
|
292
|
-
"
|
|
223
|
+
"driver": {
|
|
224
|
+
"$ref": "#/components/schemas/IDeviceDriverStatus"
|
|
293
225
|
}
|
|
294
226
|
},
|
|
295
227
|
"required": [
|
|
296
|
-
"
|
|
228
|
+
"driver"
|
|
297
229
|
],
|
|
298
230
|
"additionalProperties": false
|
|
299
231
|
}
|
|
300
232
|
},
|
|
301
233
|
{
|
|
302
|
-
"name": "
|
|
303
|
-
"method": "device.
|
|
304
|
-
"description": "A bounded page of
|
|
234
|
+
"name": "IReq_DeviceDriverRead",
|
|
235
|
+
"method": "device.driver.read",
|
|
236
|
+
"description": "A bounded page of the driver's transcript, oldest first, and the driver's own prompts, which a device shows but does not answer. Paged as `device.session.read`. Refused with `driver_absent` while the host has no driver session. Scope `device`. Since protocol 1.3.",
|
|
305
237
|
"request": {
|
|
306
238
|
"type": "object",
|
|
307
239
|
"properties": {
|
|
308
|
-
"sessionId": {
|
|
309
|
-
"type": "string"
|
|
310
|
-
},
|
|
311
240
|
"before": {
|
|
312
241
|
"type": "string",
|
|
313
242
|
"description": "The `before` cursor of a newer page; absent for the newest page."
|
|
314
243
|
},
|
|
315
244
|
"limit": {
|
|
316
245
|
"type": "integer",
|
|
317
|
-
"description": "Messages of an older page (a read with `before`), 1 to 50 (default 20)
|
|
246
|
+
"description": "Messages of an older page (a read with `before`), 1 to 50 (default 20); the newest page ignores it."
|
|
318
247
|
}
|
|
319
248
|
},
|
|
320
|
-
"required": [
|
|
321
|
-
"sessionId"
|
|
322
|
-
],
|
|
323
249
|
"additionalProperties": false
|
|
324
250
|
},
|
|
325
251
|
"response": {
|
|
326
252
|
"type": "object",
|
|
327
253
|
"properties": {
|
|
328
|
-
"
|
|
329
|
-
"$ref": "#/components/schemas/
|
|
254
|
+
"driver": {
|
|
255
|
+
"$ref": "#/components/schemas/IDeviceDriverStatus"
|
|
330
256
|
},
|
|
331
257
|
"messages": {
|
|
332
258
|
"type": "array",
|
|
@@ -357,12 +283,11 @@
|
|
|
357
283
|
"type": "array",
|
|
358
284
|
"items": {
|
|
359
285
|
"$ref": "#/components/schemas/TDeviceElicitation"
|
|
360
|
-
}
|
|
361
|
-
"description": "Since protocol 1.1."
|
|
286
|
+
}
|
|
362
287
|
}
|
|
363
288
|
},
|
|
364
289
|
"required": [
|
|
365
|
-
"
|
|
290
|
+
"driver",
|
|
366
291
|
"messages",
|
|
367
292
|
"before",
|
|
368
293
|
"permissions",
|
|
@@ -373,22 +298,39 @@
|
|
|
373
298
|
}
|
|
374
299
|
},
|
|
375
300
|
{
|
|
376
|
-
"name": "
|
|
377
|
-
"method": "device.
|
|
378
|
-
"description": "
|
|
301
|
+
"name": "IReq_DeviceDriverSeen",
|
|
302
|
+
"method": "device.driver.seen",
|
|
303
|
+
"description": "Marks the driver's ended turns seen: the unread count is the owner's, one for every client, so this clears it in the browser too. Scope `device`. Since protocol 1.3.",
|
|
304
|
+
"request": {
|
|
305
|
+
"type": "object",
|
|
306
|
+
"additionalProperties": false
|
|
307
|
+
},
|
|
308
|
+
"response": {
|
|
309
|
+
"type": "object",
|
|
310
|
+
"properties": {
|
|
311
|
+
"driver": {
|
|
312
|
+
"$ref": "#/components/schemas/IDeviceDriverStatus"
|
|
313
|
+
}
|
|
314
|
+
},
|
|
315
|
+
"required": [
|
|
316
|
+
"driver"
|
|
317
|
+
],
|
|
318
|
+
"additionalProperties": false
|
|
319
|
+
}
|
|
320
|
+
},
|
|
321
|
+
{
|
|
322
|
+
"name": "IReq_DeviceDriverSend",
|
|
323
|
+
"method": "device.driver.send",
|
|
324
|
+
"description": "Sends the driver text as a direct message; it queues behind a running turn. Refused with `driver_absent` while the host has no driver session: a device never creates one. Scope `device`. Since protocol 1.3.",
|
|
379
325
|
"request": {
|
|
380
326
|
"type": "object",
|
|
381
327
|
"properties": {
|
|
382
|
-
"sessionId": {
|
|
383
|
-
"type": "string"
|
|
384
|
-
},
|
|
385
328
|
"text": {
|
|
386
329
|
"type": "string",
|
|
387
330
|
"description": "At most 64 KiB of UTF-8, not blank."
|
|
388
331
|
}
|
|
389
332
|
},
|
|
390
333
|
"required": [
|
|
391
|
-
"sessionId",
|
|
392
334
|
"text"
|
|
393
335
|
],
|
|
394
336
|
"additionalProperties": false
|
|
@@ -408,140 +350,2446 @@
|
|
|
408
350
|
}
|
|
409
351
|
},
|
|
410
352
|
{
|
|
411
|
-
"name": "
|
|
412
|
-
"method": "device.
|
|
413
|
-
"description": "
|
|
353
|
+
"name": "IReq_DeviceElicitationReply",
|
|
354
|
+
"method": "device.elicitation.reply",
|
|
355
|
+
"description": "Answers an MCP elicitation. Scope `device`. Since protocol 1.1.",
|
|
414
356
|
"request": {
|
|
415
|
-
"type": "object",
|
|
416
|
-
"additionalProperties": false
|
|
417
|
-
},
|
|
418
|
-
"response": {
|
|
419
357
|
"type": "object",
|
|
420
358
|
"properties": {
|
|
421
|
-
"
|
|
359
|
+
"sessionId": {
|
|
422
360
|
"type": "string"
|
|
423
361
|
},
|
|
424
|
-
"
|
|
425
|
-
"type": "
|
|
362
|
+
"elicitationId": {
|
|
363
|
+
"type": "string"
|
|
426
364
|
},
|
|
427
|
-
"
|
|
428
|
-
"
|
|
429
|
-
"items": {
|
|
430
|
-
"$ref": "#/components/schemas/IDeviceSessionRow"
|
|
431
|
-
}
|
|
365
|
+
"reply": {
|
|
366
|
+
"$ref": "#/components/schemas/TDeviceElicitationReply"
|
|
432
367
|
}
|
|
433
368
|
},
|
|
434
369
|
"required": [
|
|
435
|
-
"
|
|
436
|
-
"
|
|
437
|
-
"
|
|
370
|
+
"sessionId",
|
|
371
|
+
"elicitationId",
|
|
372
|
+
"reply"
|
|
438
373
|
],
|
|
439
374
|
"additionalProperties": false
|
|
440
|
-
}
|
|
375
|
+
},
|
|
376
|
+
"response": {
|
|
377
|
+
"type": "object",
|
|
378
|
+
"properties": {
|
|
379
|
+
"success": {
|
|
380
|
+
"type": "boolean"
|
|
381
|
+
}
|
|
382
|
+
},
|
|
383
|
+
"required": [
|
|
384
|
+
"success"
|
|
385
|
+
],
|
|
386
|
+
"additionalProperties": false
|
|
387
|
+
}
|
|
388
|
+
},
|
|
389
|
+
{
|
|
390
|
+
"name": "IReq_DeviceEventPush",
|
|
391
|
+
"method": "device.event",
|
|
392
|
+
"description": "An event, sent by the controller to an authenticated device connection.",
|
|
393
|
+
"request": {
|
|
394
|
+
"type": "object",
|
|
395
|
+
"properties": {
|
|
396
|
+
"event": {
|
|
397
|
+
"$ref": "#/components/schemas/TDeviceEvent"
|
|
398
|
+
}
|
|
399
|
+
},
|
|
400
|
+
"required": [
|
|
401
|
+
"event"
|
|
402
|
+
],
|
|
403
|
+
"additionalProperties": false
|
|
404
|
+
},
|
|
405
|
+
"response": {
|
|
406
|
+
"type": "object",
|
|
407
|
+
"additionalProperties": false
|
|
408
|
+
}
|
|
409
|
+
},
|
|
410
|
+
{
|
|
411
|
+
"name": "IReq_DeviceHello",
|
|
412
|
+
"method": "device.hello",
|
|
413
|
+
"description": "The device protocol of this controller. A device speaks one major; minors only add. Unauthenticated (scope `devicePairing`).",
|
|
414
|
+
"request": {
|
|
415
|
+
"type": "object",
|
|
416
|
+
"additionalProperties": false
|
|
417
|
+
},
|
|
418
|
+
"response": {
|
|
419
|
+
"type": "object",
|
|
420
|
+
"properties": {
|
|
421
|
+
"major": {
|
|
422
|
+
"type": "integer"
|
|
423
|
+
},
|
|
424
|
+
"minor": {
|
|
425
|
+
"type": "integer"
|
|
426
|
+
}
|
|
427
|
+
},
|
|
428
|
+
"required": [
|
|
429
|
+
"major",
|
|
430
|
+
"minor"
|
|
431
|
+
],
|
|
432
|
+
"additionalProperties": false
|
|
433
|
+
}
|
|
434
|
+
},
|
|
435
|
+
{
|
|
436
|
+
"name": "IReq_DeviceHostGet",
|
|
437
|
+
"method": "device.host.get",
|
|
438
|
+
"description": "The host's status, read-only: the AGL that runs and how a device reaches it, this device, the deploy targets, the account pools and the API keys. A section that cannot be read answers `unavailable` on its own; the request still answers the others. Nothing names an account, a key or a dollar amount, and no deploy probe runs for it: a device changes nothing on the host. `host.changed` says when to read it again. Scope `device`. Since protocol 1.3.",
|
|
439
|
+
"request": {
|
|
440
|
+
"type": "object",
|
|
441
|
+
"additionalProperties": false
|
|
442
|
+
},
|
|
443
|
+
"response": {
|
|
444
|
+
"type": "object",
|
|
445
|
+
"properties": {
|
|
446
|
+
"agl": {
|
|
447
|
+
"$ref": "#/components/schemas/IDeviceHostAgl"
|
|
448
|
+
},
|
|
449
|
+
"device": {
|
|
450
|
+
"$ref": "#/components/schemas/IDeviceHostDevice"
|
|
451
|
+
},
|
|
452
|
+
"deploys": {
|
|
453
|
+
"anyOf": [
|
|
454
|
+
{
|
|
455
|
+
"$ref": "#/components/schemas/IDeviceHostDeploys"
|
|
456
|
+
},
|
|
457
|
+
{
|
|
458
|
+
"$ref": "#/components/schemas/IDeviceHostUnavailable"
|
|
459
|
+
}
|
|
460
|
+
]
|
|
461
|
+
},
|
|
462
|
+
"pools": {
|
|
463
|
+
"anyOf": [
|
|
464
|
+
{
|
|
465
|
+
"$ref": "#/components/schemas/IDeviceHostPools"
|
|
466
|
+
},
|
|
467
|
+
{
|
|
468
|
+
"$ref": "#/components/schemas/IDeviceHostUnavailable"
|
|
469
|
+
}
|
|
470
|
+
]
|
|
471
|
+
},
|
|
472
|
+
"apiKeys": {
|
|
473
|
+
"anyOf": [
|
|
474
|
+
{
|
|
475
|
+
"$ref": "#/components/schemas/IDeviceHostApiKeys"
|
|
476
|
+
},
|
|
477
|
+
{
|
|
478
|
+
"$ref": "#/components/schemas/IDeviceHostUnavailable"
|
|
479
|
+
}
|
|
480
|
+
]
|
|
481
|
+
}
|
|
482
|
+
},
|
|
483
|
+
"required": [
|
|
484
|
+
"agl",
|
|
485
|
+
"device",
|
|
486
|
+
"deploys",
|
|
487
|
+
"pools",
|
|
488
|
+
"apiKeys"
|
|
489
|
+
],
|
|
490
|
+
"additionalProperties": false
|
|
491
|
+
}
|
|
492
|
+
},
|
|
493
|
+
{
|
|
494
|
+
"name": "IReq_DeviceInboxList",
|
|
495
|
+
"method": "device.inbox.list",
|
|
496
|
+
"description": "What waits for the owner, in the Inbox's order: the session prompts, then the driver, then go's, then ticket questions, the oldest first within each kind. `inbox.changed` events keep it current. Scope `device`. Since 1.2.",
|
|
497
|
+
"request": {
|
|
498
|
+
"type": "object",
|
|
499
|
+
"additionalProperties": false
|
|
500
|
+
},
|
|
501
|
+
"response": {
|
|
502
|
+
"type": "object",
|
|
503
|
+
"properties": {
|
|
504
|
+
"epoch": {
|
|
505
|
+
"type": "string"
|
|
506
|
+
},
|
|
507
|
+
"revision": {
|
|
508
|
+
"type": "integer"
|
|
509
|
+
},
|
|
510
|
+
"items": {
|
|
511
|
+
"type": "array",
|
|
512
|
+
"items": {
|
|
513
|
+
"$ref": "#/components/schemas/TDeviceInboxItem"
|
|
514
|
+
}
|
|
515
|
+
},
|
|
516
|
+
"total": {
|
|
517
|
+
"type": "integer"
|
|
518
|
+
},
|
|
519
|
+
"limited": {
|
|
520
|
+
"type": "boolean"
|
|
521
|
+
}
|
|
522
|
+
},
|
|
523
|
+
"required": [
|
|
524
|
+
"epoch",
|
|
525
|
+
"revision",
|
|
526
|
+
"items",
|
|
527
|
+
"total",
|
|
528
|
+
"limited"
|
|
529
|
+
],
|
|
530
|
+
"additionalProperties": false
|
|
531
|
+
}
|
|
532
|
+
},
|
|
533
|
+
{
|
|
534
|
+
"name": "IReq_DevicePair",
|
|
535
|
+
"method": "device.pair",
|
|
536
|
+
"description": "Pairs a device with the single-use code of the QR. `proof` is the device key's signature over the pairing message (label `agl-device-pair`, controller id, origin, SHA-256 of the code bytes, public key). Refused while the controller has no public origin. Unauthenticated (scope `devicePairing`).",
|
|
537
|
+
"request": {
|
|
538
|
+
"type": "object",
|
|
539
|
+
"properties": {
|
|
540
|
+
"code": {
|
|
541
|
+
"type": "string",
|
|
542
|
+
"description": "The QR's code: base64url (no padding) of 32 bytes."
|
|
543
|
+
},
|
|
544
|
+
"name": {
|
|
545
|
+
"type": "string",
|
|
546
|
+
"description": "The device's name, at most 64 characters."
|
|
547
|
+
},
|
|
548
|
+
"model": {
|
|
549
|
+
"type": "string",
|
|
550
|
+
"description": "The hardware model, at most 64 characters."
|
|
551
|
+
},
|
|
552
|
+
"publicKey": {
|
|
553
|
+
"type": "string",
|
|
554
|
+
"description": "The P-256 public key: SubjectPublicKeyInfo DER, base64url."
|
|
555
|
+
},
|
|
556
|
+
"proof": {
|
|
557
|
+
"type": "string",
|
|
558
|
+
"description": "ECDSA P-256 with SHA-256, DER (X9.62), base64url."
|
|
559
|
+
}
|
|
560
|
+
},
|
|
561
|
+
"required": [
|
|
562
|
+
"code",
|
|
563
|
+
"name",
|
|
564
|
+
"model",
|
|
565
|
+
"publicKey",
|
|
566
|
+
"proof"
|
|
567
|
+
],
|
|
568
|
+
"additionalProperties": false
|
|
569
|
+
},
|
|
570
|
+
"response": {
|
|
571
|
+
"type": "object",
|
|
572
|
+
"properties": {
|
|
573
|
+
"deviceId": {
|
|
574
|
+
"type": "string"
|
|
575
|
+
},
|
|
576
|
+
"name": {
|
|
577
|
+
"type": "string",
|
|
578
|
+
"description": "The name AGL keeps for the device."
|
|
579
|
+
}
|
|
580
|
+
},
|
|
581
|
+
"required": [
|
|
582
|
+
"deviceId",
|
|
583
|
+
"name"
|
|
584
|
+
],
|
|
585
|
+
"additionalProperties": false
|
|
586
|
+
}
|
|
587
|
+
},
|
|
588
|
+
{
|
|
589
|
+
"name": "IReq_DevicePermissionReply",
|
|
590
|
+
"method": "device.permission.reply",
|
|
591
|
+
"description": "Answers a permission. Scope `device`.",
|
|
592
|
+
"request": {
|
|
593
|
+
"type": "object",
|
|
594
|
+
"properties": {
|
|
595
|
+
"sessionId": {
|
|
596
|
+
"type": "string"
|
|
597
|
+
},
|
|
598
|
+
"childSessionId": {
|
|
599
|
+
"type": "string",
|
|
600
|
+
"description": "The direct child (an OpenCode subagent) of the session that asks, as the Inbox names it. Since protocol 1.2."
|
|
601
|
+
},
|
|
602
|
+
"permissionId": {
|
|
603
|
+
"type": "string"
|
|
604
|
+
},
|
|
605
|
+
"reply": {
|
|
606
|
+
"type": "string",
|
|
607
|
+
"enum": [
|
|
608
|
+
"once",
|
|
609
|
+
"reject"
|
|
610
|
+
]
|
|
611
|
+
},
|
|
612
|
+
"message": {
|
|
613
|
+
"type": "string",
|
|
614
|
+
"description": "Sent along with the answer where the harness takes one (OpenCode)."
|
|
615
|
+
}
|
|
616
|
+
},
|
|
617
|
+
"required": [
|
|
618
|
+
"sessionId",
|
|
619
|
+
"permissionId",
|
|
620
|
+
"reply"
|
|
621
|
+
],
|
|
622
|
+
"additionalProperties": false
|
|
623
|
+
},
|
|
624
|
+
"response": {
|
|
625
|
+
"type": "object",
|
|
626
|
+
"properties": {
|
|
627
|
+
"success": {
|
|
628
|
+
"type": "boolean"
|
|
629
|
+
}
|
|
630
|
+
},
|
|
631
|
+
"required": [
|
|
632
|
+
"success"
|
|
633
|
+
],
|
|
634
|
+
"additionalProperties": false
|
|
635
|
+
}
|
|
636
|
+
},
|
|
637
|
+
{
|
|
638
|
+
"name": "IReq_DeviceQuestionReply",
|
|
639
|
+
"method": "device.question.reply",
|
|
640
|
+
"description": "Answers a question: one answer list per question, in order; `null` rejects it. Scope `device`.",
|
|
641
|
+
"request": {
|
|
642
|
+
"type": "object",
|
|
643
|
+
"properties": {
|
|
644
|
+
"sessionId": {
|
|
645
|
+
"type": "string"
|
|
646
|
+
},
|
|
647
|
+
"childSessionId": {
|
|
648
|
+
"type": "string",
|
|
649
|
+
"description": "The direct child (an OpenCode subagent) of the session that asks, as the Inbox names it. Since protocol 1.2."
|
|
650
|
+
},
|
|
651
|
+
"questionId": {
|
|
652
|
+
"type": "string"
|
|
653
|
+
},
|
|
654
|
+
"answers": {
|
|
655
|
+
"anyOf": [
|
|
656
|
+
{
|
|
657
|
+
"type": "array",
|
|
658
|
+
"items": {
|
|
659
|
+
"type": "array",
|
|
660
|
+
"items": {
|
|
661
|
+
"type": "string"
|
|
662
|
+
}
|
|
663
|
+
}
|
|
664
|
+
},
|
|
665
|
+
{
|
|
666
|
+
"type": "null"
|
|
667
|
+
}
|
|
668
|
+
]
|
|
669
|
+
}
|
|
670
|
+
},
|
|
671
|
+
"required": [
|
|
672
|
+
"sessionId",
|
|
673
|
+
"questionId",
|
|
674
|
+
"answers"
|
|
675
|
+
],
|
|
676
|
+
"additionalProperties": false
|
|
677
|
+
},
|
|
678
|
+
"response": {
|
|
679
|
+
"type": "object",
|
|
680
|
+
"properties": {
|
|
681
|
+
"success": {
|
|
682
|
+
"type": "boolean"
|
|
683
|
+
}
|
|
684
|
+
},
|
|
685
|
+
"required": [
|
|
686
|
+
"success"
|
|
687
|
+
],
|
|
688
|
+
"additionalProperties": false
|
|
689
|
+
}
|
|
690
|
+
},
|
|
691
|
+
{
|
|
692
|
+
"name": "IReq_DeviceSessionRead",
|
|
693
|
+
"method": "device.session.read",
|
|
694
|
+
"description": "A bounded page of one session's transcript, oldest first, and what the session waits for now (on every page). Scope `device`. A read without `before` returns the newest page, sized by the controller's own bound whatever `limit` says; a read with `before` returns the next older page of `limit` messages.",
|
|
695
|
+
"request": {
|
|
696
|
+
"type": "object",
|
|
697
|
+
"properties": {
|
|
698
|
+
"sessionId": {
|
|
699
|
+
"type": "string"
|
|
700
|
+
},
|
|
701
|
+
"before": {
|
|
702
|
+
"type": "string",
|
|
703
|
+
"description": "The `before` cursor of a newer page; absent for the newest page."
|
|
704
|
+
},
|
|
705
|
+
"limit": {
|
|
706
|
+
"type": "integer",
|
|
707
|
+
"description": "Messages of an older page (a read with `before`), 1 to 50 (default 20). The newest page ignores it and holds what the controller's own bound allows; the value is still validated."
|
|
708
|
+
}
|
|
709
|
+
},
|
|
710
|
+
"required": [
|
|
711
|
+
"sessionId"
|
|
712
|
+
],
|
|
713
|
+
"additionalProperties": false
|
|
714
|
+
},
|
|
715
|
+
"response": {
|
|
716
|
+
"type": "object",
|
|
717
|
+
"properties": {
|
|
718
|
+
"session": {
|
|
719
|
+
"$ref": "#/components/schemas/IDeviceSessionRow"
|
|
720
|
+
},
|
|
721
|
+
"messages": {
|
|
722
|
+
"type": "array",
|
|
723
|
+
"items": {
|
|
724
|
+
"$ref": "#/components/schemas/IDeviceMessage"
|
|
725
|
+
}
|
|
726
|
+
},
|
|
727
|
+
"before": {
|
|
728
|
+
"type": [
|
|
729
|
+
"string",
|
|
730
|
+
"null"
|
|
731
|
+
],
|
|
732
|
+
"description": "The cursor of the next older page; `null` at the first message."
|
|
733
|
+
},
|
|
734
|
+
"permissions": {
|
|
735
|
+
"type": "array",
|
|
736
|
+
"items": {
|
|
737
|
+
"$ref": "#/components/schemas/IDevicePermission"
|
|
738
|
+
}
|
|
739
|
+
},
|
|
740
|
+
"questions": {
|
|
741
|
+
"type": "array",
|
|
742
|
+
"items": {
|
|
743
|
+
"$ref": "#/components/schemas/IDeviceQuestion"
|
|
744
|
+
}
|
|
745
|
+
},
|
|
746
|
+
"elicitations": {
|
|
747
|
+
"type": "array",
|
|
748
|
+
"items": {
|
|
749
|
+
"$ref": "#/components/schemas/TDeviceElicitation"
|
|
750
|
+
},
|
|
751
|
+
"description": "Since protocol 1.1."
|
|
752
|
+
}
|
|
753
|
+
},
|
|
754
|
+
"required": [
|
|
755
|
+
"session",
|
|
756
|
+
"messages",
|
|
757
|
+
"before",
|
|
758
|
+
"permissions",
|
|
759
|
+
"questions",
|
|
760
|
+
"elicitations"
|
|
761
|
+
],
|
|
762
|
+
"additionalProperties": false
|
|
763
|
+
}
|
|
764
|
+
},
|
|
765
|
+
{
|
|
766
|
+
"name": "IReq_DeviceSessionSend",
|
|
767
|
+
"method": "device.session.send",
|
|
768
|
+
"description": "Sends text to a session as a direct message (never the browser's shared draft); it queues behind a running turn. A session AGL does not write to (another process runs it, a fleet worker owns it) refuses it. Scope `device`.",
|
|
769
|
+
"request": {
|
|
770
|
+
"type": "object",
|
|
771
|
+
"properties": {
|
|
772
|
+
"sessionId": {
|
|
773
|
+
"type": "string"
|
|
774
|
+
},
|
|
775
|
+
"text": {
|
|
776
|
+
"type": "string",
|
|
777
|
+
"description": "At most 64 KiB of UTF-8, not blank."
|
|
778
|
+
}
|
|
779
|
+
},
|
|
780
|
+
"required": [
|
|
781
|
+
"sessionId",
|
|
782
|
+
"text"
|
|
783
|
+
],
|
|
784
|
+
"additionalProperties": false
|
|
785
|
+
},
|
|
786
|
+
"response": {
|
|
787
|
+
"type": "object",
|
|
788
|
+
"properties": {
|
|
789
|
+
"accepted": {
|
|
790
|
+
"type": "boolean",
|
|
791
|
+
"const": true
|
|
792
|
+
}
|
|
793
|
+
},
|
|
794
|
+
"required": [
|
|
795
|
+
"accepted"
|
|
796
|
+
],
|
|
797
|
+
"additionalProperties": false
|
|
798
|
+
}
|
|
799
|
+
},
|
|
800
|
+
{
|
|
801
|
+
"name": "IReq_DeviceSessionsList",
|
|
802
|
+
"method": "device.sessions.list",
|
|
803
|
+
"description": "The session feed, newest first, without terminal rows. Scope `device`.",
|
|
804
|
+
"request": {
|
|
805
|
+
"type": "object",
|
|
806
|
+
"additionalProperties": false
|
|
807
|
+
},
|
|
808
|
+
"response": {
|
|
809
|
+
"type": "object",
|
|
810
|
+
"properties": {
|
|
811
|
+
"epoch": {
|
|
812
|
+
"type": "string"
|
|
813
|
+
},
|
|
814
|
+
"revision": {
|
|
815
|
+
"type": "integer"
|
|
816
|
+
},
|
|
817
|
+
"rows": {
|
|
818
|
+
"type": "array",
|
|
819
|
+
"items": {
|
|
820
|
+
"$ref": "#/components/schemas/IDeviceSessionRow"
|
|
821
|
+
}
|
|
822
|
+
}
|
|
823
|
+
},
|
|
824
|
+
"required": [
|
|
825
|
+
"epoch",
|
|
826
|
+
"revision",
|
|
827
|
+
"rows"
|
|
828
|
+
],
|
|
829
|
+
"additionalProperties": false
|
|
830
|
+
}
|
|
831
|
+
},
|
|
832
|
+
{
|
|
833
|
+
"name": "IReq_DeviceTicketAnswer",
|
|
834
|
+
"method": "device.ticket.answer",
|
|
835
|
+
"description": "Answers a ticket question as the owner, also a deploy plan's or a maintenance window's question, whose answer is the owner's go: option ids from the question (one unless it takes several) and text where it takes text. The identical answer again is accepted; a different one is refused (`ticket_question_answered`). Scope `device`. Since 1.2.",
|
|
836
|
+
"request": {
|
|
837
|
+
"type": "object",
|
|
838
|
+
"properties": {
|
|
839
|
+
"ticketKey": {
|
|
840
|
+
"type": "string"
|
|
841
|
+
},
|
|
842
|
+
"questionId": {
|
|
843
|
+
"type": "string"
|
|
844
|
+
},
|
|
845
|
+
"choices": {
|
|
846
|
+
"type": "array",
|
|
847
|
+
"items": {
|
|
848
|
+
"type": "string"
|
|
849
|
+
}
|
|
850
|
+
},
|
|
851
|
+
"text": {
|
|
852
|
+
"type": "string",
|
|
853
|
+
"description": "At most 16 KiB, not blank."
|
|
854
|
+
}
|
|
855
|
+
},
|
|
856
|
+
"required": [
|
|
857
|
+
"ticketKey",
|
|
858
|
+
"questionId"
|
|
859
|
+
],
|
|
860
|
+
"additionalProperties": false
|
|
861
|
+
},
|
|
862
|
+
"response": {
|
|
863
|
+
"type": "object",
|
|
864
|
+
"properties": {
|
|
865
|
+
"question": {
|
|
866
|
+
"$ref": "#/components/schemas/IDeviceTicketQuestion"
|
|
867
|
+
}
|
|
868
|
+
},
|
|
869
|
+
"required": [
|
|
870
|
+
"question"
|
|
871
|
+
],
|
|
872
|
+
"additionalProperties": false
|
|
873
|
+
}
|
|
874
|
+
},
|
|
875
|
+
{
|
|
876
|
+
"name": "IReq_DeviceTicketAsk",
|
|
877
|
+
"method": "device.ticket.ask",
|
|
878
|
+
"description": "Asks a question on a ticket as the owner, as the browser's board does: text alone, answered with text. A refusal changes nothing. Scope `device`. Since protocol 1.3.",
|
|
879
|
+
"request": {
|
|
880
|
+
"type": "object",
|
|
881
|
+
"properties": {
|
|
882
|
+
"ticketKey": {
|
|
883
|
+
"type": "string"
|
|
884
|
+
},
|
|
885
|
+
"question": {
|
|
886
|
+
"type": "string",
|
|
887
|
+
"description": "Markdown, at most 16 KiB of UTF-8, not blank."
|
|
888
|
+
}
|
|
889
|
+
},
|
|
890
|
+
"required": [
|
|
891
|
+
"ticketKey",
|
|
892
|
+
"question"
|
|
893
|
+
],
|
|
894
|
+
"additionalProperties": false
|
|
895
|
+
},
|
|
896
|
+
"response": {
|
|
897
|
+
"type": "object",
|
|
898
|
+
"properties": {
|
|
899
|
+
"question": {
|
|
900
|
+
"$ref": "#/components/schemas/IDeviceTicketQuestion"
|
|
901
|
+
}
|
|
902
|
+
},
|
|
903
|
+
"required": [
|
|
904
|
+
"question"
|
|
905
|
+
],
|
|
906
|
+
"additionalProperties": false
|
|
907
|
+
}
|
|
908
|
+
},
|
|
909
|
+
{
|
|
910
|
+
"name": "IReq_DeviceTicketComment",
|
|
911
|
+
"method": "device.ticket.comment",
|
|
912
|
+
"description": "Comments on a ticket as the owner, as the browser's board does. A refusal changes nothing: the app keeps the draft, reads the ticket again and shows the reason. Scope `device`. Since protocol 1.3.",
|
|
913
|
+
"request": {
|
|
914
|
+
"type": "object",
|
|
915
|
+
"properties": {
|
|
916
|
+
"ticketKey": {
|
|
917
|
+
"type": "string"
|
|
918
|
+
},
|
|
919
|
+
"text": {
|
|
920
|
+
"type": "string",
|
|
921
|
+
"description": "Markdown, at most 64 KiB of UTF-8, not blank."
|
|
922
|
+
}
|
|
923
|
+
},
|
|
924
|
+
"required": [
|
|
925
|
+
"ticketKey",
|
|
926
|
+
"text"
|
|
927
|
+
],
|
|
928
|
+
"additionalProperties": false
|
|
929
|
+
},
|
|
930
|
+
"response": {
|
|
931
|
+
"type": "object",
|
|
932
|
+
"properties": {
|
|
933
|
+
"comment": {
|
|
934
|
+
"$ref": "#/components/schemas/IDeviceTicketComment"
|
|
935
|
+
}
|
|
936
|
+
},
|
|
937
|
+
"required": [
|
|
938
|
+
"comment"
|
|
939
|
+
],
|
|
940
|
+
"additionalProperties": false
|
|
941
|
+
}
|
|
942
|
+
},
|
|
943
|
+
{
|
|
944
|
+
"name": "IReq_DeviceTicketGet",
|
|
945
|
+
"method": "device.ticket.get",
|
|
946
|
+
"description": "A ticket as its detail shows it, with one page of its discussion: the comments and questions written before `before`, or the newest without it, within `deviceTicketDiscussionPage`, each list oldest first; the page's own `before` reads the next older one and is `null` at the first. \"Where it runs\" (`placement`) is read from the deploy monitor and answers `unavailable` on its own, as a section of `device.host.get` does; `plans` come from the ticket, with the owner's go and where a window stands while the monitor answers. No history of the ticket's other changes and no source attachments. Scope `device`. Since protocol 1.3.",
|
|
947
|
+
"request": {
|
|
948
|
+
"type": "object",
|
|
949
|
+
"properties": {
|
|
950
|
+
"ticketKey": {
|
|
951
|
+
"type": "string"
|
|
952
|
+
},
|
|
953
|
+
"before": {
|
|
954
|
+
"type": "string",
|
|
955
|
+
"description": "The `before` of a newer page; absent for the newest page."
|
|
956
|
+
},
|
|
957
|
+
"limit": {
|
|
958
|
+
"type": "integer",
|
|
959
|
+
"description": "Comments and questions on the page, 1 to 50 (default 20)."
|
|
960
|
+
}
|
|
961
|
+
},
|
|
962
|
+
"required": [
|
|
963
|
+
"ticketKey"
|
|
964
|
+
],
|
|
965
|
+
"additionalProperties": false
|
|
966
|
+
},
|
|
967
|
+
"response": {
|
|
968
|
+
"type": "object",
|
|
969
|
+
"properties": {
|
|
970
|
+
"ticket": {
|
|
971
|
+
"$ref": "#/components/schemas/IDeviceTicket"
|
|
972
|
+
},
|
|
973
|
+
"questions": {
|
|
974
|
+
"type": "array",
|
|
975
|
+
"items": {
|
|
976
|
+
"$ref": "#/components/schemas/IDeviceTicketQuestion"
|
|
977
|
+
}
|
|
978
|
+
},
|
|
979
|
+
"comments": {
|
|
980
|
+
"type": "array",
|
|
981
|
+
"items": {
|
|
982
|
+
"$ref": "#/components/schemas/IDeviceTicketComment"
|
|
983
|
+
}
|
|
984
|
+
},
|
|
985
|
+
"before": {
|
|
986
|
+
"type": [
|
|
987
|
+
"string",
|
|
988
|
+
"null"
|
|
989
|
+
]
|
|
990
|
+
},
|
|
991
|
+
"placement": {
|
|
992
|
+
"anyOf": [
|
|
993
|
+
{
|
|
994
|
+
"$ref": "#/components/schemas/IDeviceTicketPlacement"
|
|
995
|
+
},
|
|
996
|
+
{
|
|
997
|
+
"$ref": "#/components/schemas/IDeviceHostUnavailable"
|
|
998
|
+
}
|
|
999
|
+
]
|
|
1000
|
+
},
|
|
1001
|
+
"plans": {
|
|
1002
|
+
"$ref": "#/components/schemas/IDeviceTicketPlans"
|
|
1003
|
+
}
|
|
1004
|
+
},
|
|
1005
|
+
"required": [
|
|
1006
|
+
"ticket",
|
|
1007
|
+
"questions",
|
|
1008
|
+
"comments",
|
|
1009
|
+
"before",
|
|
1010
|
+
"placement",
|
|
1011
|
+
"plans"
|
|
1012
|
+
],
|
|
1013
|
+
"additionalProperties": false
|
|
1014
|
+
}
|
|
1015
|
+
},
|
|
1016
|
+
{
|
|
1017
|
+
"name": "IReq_DeviceTicketMove",
|
|
1018
|
+
"method": "device.ticket.move",
|
|
1019
|
+
"description": "Moves a ticket to the end of `column` as the owner (\"Move to…\", a phone's drag on the browser's board); the column's rules hold as for the browser (review needs a branch, landed a commit, released a release; landed work is not closed). A refusal changes nothing. Scope `device`. Since protocol 1.3.",
|
|
1020
|
+
"request": {
|
|
1021
|
+
"type": "object",
|
|
1022
|
+
"properties": {
|
|
1023
|
+
"ticketKey": {
|
|
1024
|
+
"type": "string"
|
|
1025
|
+
},
|
|
1026
|
+
"column": {
|
|
1027
|
+
"$ref": "#/components/schemas/TDeviceTicketColumn"
|
|
1028
|
+
}
|
|
1029
|
+
},
|
|
1030
|
+
"required": [
|
|
1031
|
+
"ticketKey",
|
|
1032
|
+
"column"
|
|
1033
|
+
],
|
|
1034
|
+
"additionalProperties": false
|
|
1035
|
+
},
|
|
1036
|
+
"response": {
|
|
1037
|
+
"type": "object",
|
|
1038
|
+
"properties": {
|
|
1039
|
+
"ticket": {
|
|
1040
|
+
"$ref": "#/components/schemas/IDeviceTicketCard"
|
|
1041
|
+
}
|
|
1042
|
+
},
|
|
1043
|
+
"required": [
|
|
1044
|
+
"ticket"
|
|
1045
|
+
],
|
|
1046
|
+
"additionalProperties": false
|
|
1047
|
+
}
|
|
441
1048
|
}
|
|
442
1049
|
],
|
|
443
1050
|
"schemas": {
|
|
1051
|
+
"IDeviceApiKeyGroup": {
|
|
1052
|
+
"type": "object",
|
|
1053
|
+
"properties": {
|
|
1054
|
+
"provider": {
|
|
1055
|
+
"$ref": "#/components/schemas/TDeviceAccountProvider"
|
|
1056
|
+
},
|
|
1057
|
+
"within": {
|
|
1058
|
+
"type": "integer",
|
|
1059
|
+
"description": "Keys under their limit this month."
|
|
1060
|
+
},
|
|
1061
|
+
"over": {
|
|
1062
|
+
"type": "integer",
|
|
1063
|
+
"description": "Keys at their limit (or with an answer AGL could not price): AGL places nothing on them until the month ends."
|
|
1064
|
+
},
|
|
1065
|
+
"unlimited": {
|
|
1066
|
+
"type": "integer",
|
|
1067
|
+
"description": "Keys without a spend limit."
|
|
1068
|
+
},
|
|
1069
|
+
"unread": {
|
|
1070
|
+
"type": "integer",
|
|
1071
|
+
"description": "Keys whose month AGL could not read."
|
|
1072
|
+
},
|
|
1073
|
+
"resetAt": {
|
|
1074
|
+
"type": "integer",
|
|
1075
|
+
"description": "Unix milliseconds the keys over their limit take work again, at the month's end; absent while none is."
|
|
1076
|
+
}
|
|
1077
|
+
},
|
|
1078
|
+
"required": [
|
|
1079
|
+
"provider",
|
|
1080
|
+
"within",
|
|
1081
|
+
"over",
|
|
1082
|
+
"unlimited",
|
|
1083
|
+
"unread"
|
|
1084
|
+
],
|
|
1085
|
+
"additionalProperties": false,
|
|
1086
|
+
"description": "How a provider's API keys stand against their monthly spend limits, counted. Since protocol 1.3."
|
|
1087
|
+
},
|
|
1088
|
+
"IDeviceBoardColumn": {
|
|
1089
|
+
"type": "object",
|
|
1090
|
+
"properties": {
|
|
1091
|
+
"id": {
|
|
1092
|
+
"$ref": "#/components/schemas/TDeviceTicketColumn"
|
|
1093
|
+
},
|
|
1094
|
+
"title": {
|
|
1095
|
+
"type": "string"
|
|
1096
|
+
},
|
|
1097
|
+
"done": {
|
|
1098
|
+
"type": "boolean",
|
|
1099
|
+
"description": "It holds finished work; the board folds it."
|
|
1100
|
+
},
|
|
1101
|
+
"count": {
|
|
1102
|
+
"type": "integer"
|
|
1103
|
+
}
|
|
1104
|
+
},
|
|
1105
|
+
"required": [
|
|
1106
|
+
"id",
|
|
1107
|
+
"title",
|
|
1108
|
+
"done",
|
|
1109
|
+
"count"
|
|
1110
|
+
],
|
|
1111
|
+
"additionalProperties": false,
|
|
1112
|
+
"description": "A column of the board and how many of its tickets the filters let through. Since protocol 1.3."
|
|
1113
|
+
},
|
|
1114
|
+
"IDeviceDeployGo": {
|
|
1115
|
+
"type": "object",
|
|
1116
|
+
"properties": {
|
|
1117
|
+
"target": {
|
|
1118
|
+
"type": "string"
|
|
1119
|
+
},
|
|
1120
|
+
"targetName": {
|
|
1121
|
+
"type": "string"
|
|
1122
|
+
},
|
|
1123
|
+
"environment": {
|
|
1124
|
+
"type": "string"
|
|
1125
|
+
},
|
|
1126
|
+
"version": {
|
|
1127
|
+
"type": "string"
|
|
1128
|
+
},
|
|
1129
|
+
"runs": {
|
|
1130
|
+
"type": "string"
|
|
1131
|
+
},
|
|
1132
|
+
"deployWhen": {
|
|
1133
|
+
"type": "string",
|
|
1134
|
+
"enum": [
|
|
1135
|
+
"anytime",
|
|
1136
|
+
"window",
|
|
1137
|
+
"idle"
|
|
1138
|
+
],
|
|
1139
|
+
"description": "`anytime`, `window` (in a maintenance window the owner gave) or `idle` (the AGL controller: no session busy)."
|
|
1140
|
+
},
|
|
1141
|
+
"window": {
|
|
1142
|
+
"$ref": "#/components/schemas/IDeviceTimeSpan",
|
|
1143
|
+
"description": "The maintenance window the deploy would run in."
|
|
1144
|
+
},
|
|
1145
|
+
"ships": {
|
|
1146
|
+
"type": "array",
|
|
1147
|
+
"items": {
|
|
1148
|
+
"$ref": "#/components/schemas/IDeviceTicketRef"
|
|
1149
|
+
}
|
|
1150
|
+
},
|
|
1151
|
+
"shipsTotal": {
|
|
1152
|
+
"type": "integer"
|
|
1153
|
+
}
|
|
1154
|
+
},
|
|
1155
|
+
"required": [
|
|
1156
|
+
"target",
|
|
1157
|
+
"version",
|
|
1158
|
+
"ships",
|
|
1159
|
+
"shipsTotal"
|
|
1160
|
+
],
|
|
1161
|
+
"additionalProperties": false,
|
|
1162
|
+
"description": "A deploy plan as its go shows it: what the target runs now, what it deploys, when, and what ships with it."
|
|
1163
|
+
},
|
|
1164
|
+
"IDeviceDeployPlan": {
|
|
1165
|
+
"type": "object",
|
|
1166
|
+
"properties": {
|
|
1167
|
+
"ticketKey": {
|
|
1168
|
+
"type": "string"
|
|
1169
|
+
},
|
|
1170
|
+
"title": {
|
|
1171
|
+
"type": "string"
|
|
1172
|
+
},
|
|
1173
|
+
"version": {
|
|
1174
|
+
"type": "string"
|
|
1175
|
+
},
|
|
1176
|
+
"go": {
|
|
1177
|
+
"$ref": "#/components/schemas/TDeviceDeployPlanGo"
|
|
1178
|
+
},
|
|
1179
|
+
"window": {
|
|
1180
|
+
"$ref": "#/components/schemas/IDeviceTimeSpan",
|
|
1181
|
+
"description": "For `window`: the maintenance window it is queued into; absent while the owner gave none."
|
|
1182
|
+
}
|
|
1183
|
+
},
|
|
1184
|
+
"required": [
|
|
1185
|
+
"ticketKey",
|
|
1186
|
+
"title",
|
|
1187
|
+
"version",
|
|
1188
|
+
"go"
|
|
1189
|
+
],
|
|
1190
|
+
"additionalProperties": false,
|
|
1191
|
+
"description": "A planned deploy of a target: its ticket, the release the target should run (or a newer one) and the owner's go. Who deploys it and the question it is answered on stay on the host. Since protocol 1.3."
|
|
1192
|
+
},
|
|
1193
|
+
"IDeviceDeployRunning": {
|
|
1194
|
+
"type": "object",
|
|
1195
|
+
"properties": {
|
|
1196
|
+
"version": {
|
|
1197
|
+
"type": "string"
|
|
1198
|
+
},
|
|
1199
|
+
"since": {
|
|
1200
|
+
"type": "integer",
|
|
1201
|
+
"description": "Unix milliseconds the probe first answered this version."
|
|
1202
|
+
},
|
|
1203
|
+
"previousVersion": {
|
|
1204
|
+
"type": "string",
|
|
1205
|
+
"description": "The version it ran before."
|
|
1206
|
+
},
|
|
1207
|
+
"rolledBack": {
|
|
1208
|
+
"type": "boolean",
|
|
1209
|
+
"description": "It runs an older version than before."
|
|
1210
|
+
},
|
|
1211
|
+
"untagged": {
|
|
1212
|
+
"type": "boolean",
|
|
1213
|
+
"description": "Its commit is not the one its version's release tag names, such as a development checkout's."
|
|
1214
|
+
}
|
|
1215
|
+
},
|
|
1216
|
+
"required": [
|
|
1217
|
+
"version",
|
|
1218
|
+
"since",
|
|
1219
|
+
"rolledBack",
|
|
1220
|
+
"untagged"
|
|
1221
|
+
],
|
|
1222
|
+
"additionalProperties": false,
|
|
1223
|
+
"description": "What a deploy target runs, as its probe answered it. Since protocol 1.3."
|
|
1224
|
+
},
|
|
1225
|
+
"IDeviceDeployTarget": {
|
|
1226
|
+
"type": "object",
|
|
1227
|
+
"properties": {
|
|
1228
|
+
"id": {
|
|
1229
|
+
"type": "string"
|
|
1230
|
+
},
|
|
1231
|
+
"name": {
|
|
1232
|
+
"type": "string",
|
|
1233
|
+
"description": "The name the views show; absent shows the id."
|
|
1234
|
+
},
|
|
1235
|
+
"environment": {
|
|
1236
|
+
"type": "string",
|
|
1237
|
+
"description": "Where it runs: an environment such as `production`, or a host."
|
|
1238
|
+
},
|
|
1239
|
+
"repo": {
|
|
1240
|
+
"type": "string",
|
|
1241
|
+
"description": "The repository it runs, `org/name`."
|
|
1242
|
+
},
|
|
1243
|
+
"running": {
|
|
1244
|
+
"$ref": "#/components/schemas/IDeviceDeployRunning",
|
|
1245
|
+
"description": "Absent until its probe answered a version."
|
|
1246
|
+
},
|
|
1247
|
+
"probe": {
|
|
1248
|
+
"$ref": "#/components/schemas/TDeviceDeployProbeState"
|
|
1249
|
+
},
|
|
1250
|
+
"probedAt": {
|
|
1251
|
+
"type": "integer",
|
|
1252
|
+
"description": "Unix milliseconds of its last probe."
|
|
1253
|
+
},
|
|
1254
|
+
"downSince": {
|
|
1255
|
+
"type": "integer",
|
|
1256
|
+
"description": "Unix milliseconds of the first failed probe of a failure that still lasts."
|
|
1257
|
+
},
|
|
1258
|
+
"latest": {
|
|
1259
|
+
"type": "string",
|
|
1260
|
+
"description": "The repository's newest release."
|
|
1261
|
+
},
|
|
1262
|
+
"undeployed": {
|
|
1263
|
+
"type": "array",
|
|
1264
|
+
"items": {
|
|
1265
|
+
"type": "string"
|
|
1266
|
+
},
|
|
1267
|
+
"description": "The releases newer than the version it runs, newest first; none while its probe answered no version."
|
|
1268
|
+
},
|
|
1269
|
+
"deployWhen": {
|
|
1270
|
+
"type": "string",
|
|
1271
|
+
"enum": [
|
|
1272
|
+
"anytime",
|
|
1273
|
+
"window",
|
|
1274
|
+
"idle"
|
|
1275
|
+
],
|
|
1276
|
+
"description": "`anytime`, `window` (in a maintenance window the owner gave) or `idle` (the AGL controller: no session busy)."
|
|
1277
|
+
},
|
|
1278
|
+
"plans": {
|
|
1279
|
+
"type": "array",
|
|
1280
|
+
"items": {
|
|
1281
|
+
"$ref": "#/components/schemas/IDeviceDeployPlan"
|
|
1282
|
+
},
|
|
1283
|
+
"description": "Its planned deploys whose ticket is not done, the newest version first."
|
|
1284
|
+
}
|
|
1285
|
+
},
|
|
1286
|
+
"required": [
|
|
1287
|
+
"id",
|
|
1288
|
+
"repo",
|
|
1289
|
+
"probe",
|
|
1290
|
+
"undeployed",
|
|
1291
|
+
"deployWhen",
|
|
1292
|
+
"plans"
|
|
1293
|
+
],
|
|
1294
|
+
"additionalProperties": false,
|
|
1295
|
+
"description": "A deploy target and what it runs; its probe's address and the owner's notes on it stay on the host. Since protocol 1.3."
|
|
1296
|
+
},
|
|
1297
|
+
"IDeviceDirectReport": {
|
|
1298
|
+
"type": "object",
|
|
1299
|
+
"properties": {
|
|
1300
|
+
"name": {
|
|
1301
|
+
"type": "string"
|
|
1302
|
+
},
|
|
1303
|
+
"kind": {
|
|
1304
|
+
"type": "string",
|
|
1305
|
+
"enum": [
|
|
1306
|
+
"fleet-worker",
|
|
1307
|
+
"session"
|
|
1308
|
+
],
|
|
1309
|
+
"description": "`fleet-worker`: a fleet worker AGL runs; `session`: a Claude Code or Codex session the fleet does not run."
|
|
1310
|
+
},
|
|
1311
|
+
"harness": {
|
|
1312
|
+
"$ref": "#/components/schemas/TDeviceDirectReportHarness"
|
|
1313
|
+
},
|
|
1314
|
+
"status": {
|
|
1315
|
+
"$ref": "#/components/schemas/TDeviceDirectReportStatus",
|
|
1316
|
+
"description": "Absent while AGL does not observe the report's session."
|
|
1317
|
+
},
|
|
1318
|
+
"sessionId": {
|
|
1319
|
+
"type": "string",
|
|
1320
|
+
"description": "The report's session as the session feed names it (`harness:nativeId`); `device.session.read` opens it while the feed lists it."
|
|
1321
|
+
},
|
|
1322
|
+
"projects": {
|
|
1323
|
+
"type": "array",
|
|
1324
|
+
"items": {
|
|
1325
|
+
"type": "string"
|
|
1326
|
+
},
|
|
1327
|
+
"description": "Ticket projects whose open questions count as the report's."
|
|
1328
|
+
},
|
|
1329
|
+
"ticketKey": {
|
|
1330
|
+
"type": "string",
|
|
1331
|
+
"description": "The ticket the report is steered through."
|
|
1332
|
+
},
|
|
1333
|
+
"latestResult": {
|
|
1334
|
+
"$ref": "#/components/schemas/IDeviceDirectReportResult"
|
|
1335
|
+
},
|
|
1336
|
+
"openQuestions": {
|
|
1337
|
+
"type": "array",
|
|
1338
|
+
"items": {
|
|
1339
|
+
"$ref": "#/components/schemas/IDeviceDirectReportQuestion"
|
|
1340
|
+
},
|
|
1341
|
+
"description": "The oldest open questions first, at most 20."
|
|
1342
|
+
},
|
|
1343
|
+
"openQuestionCount": {
|
|
1344
|
+
"type": "integer"
|
|
1345
|
+
},
|
|
1346
|
+
"workers": {
|
|
1347
|
+
"type": "array",
|
|
1348
|
+
"items": {
|
|
1349
|
+
"$ref": "#/components/schemas/IDeviceReportWorker"
|
|
1350
|
+
},
|
|
1351
|
+
"description": "The fleet workers that report to it."
|
|
1352
|
+
},
|
|
1353
|
+
"messageable": {
|
|
1354
|
+
"type": "boolean",
|
|
1355
|
+
"description": "Whether `device.directreport.message` reaches it: a Claude Code session the fleet does not run takes none."
|
|
1356
|
+
}
|
|
1357
|
+
},
|
|
1358
|
+
"required": [
|
|
1359
|
+
"name",
|
|
1360
|
+
"kind",
|
|
1361
|
+
"harness",
|
|
1362
|
+
"sessionId",
|
|
1363
|
+
"projects",
|
|
1364
|
+
"ticketKey",
|
|
1365
|
+
"openQuestions",
|
|
1366
|
+
"openQuestionCount",
|
|
1367
|
+
"workers",
|
|
1368
|
+
"messageable"
|
|
1369
|
+
],
|
|
1370
|
+
"additionalProperties": false,
|
|
1371
|
+
"description": "A session that reports to the owner directly, as the Driver view lists it. A device names a report only by `name`. Since protocol 1.3."
|
|
1372
|
+
},
|
|
1373
|
+
"IDeviceDirectReportQuestion": {
|
|
1374
|
+
"type": "object",
|
|
1375
|
+
"properties": {
|
|
1376
|
+
"ticketKey": {
|
|
1377
|
+
"type": "string"
|
|
1378
|
+
},
|
|
1379
|
+
"project": {
|
|
1380
|
+
"type": "string"
|
|
1381
|
+
},
|
|
1382
|
+
"question": {
|
|
1383
|
+
"$ref": "#/components/schemas/IDeviceTicketQuestion"
|
|
1384
|
+
}
|
|
1385
|
+
},
|
|
1386
|
+
"required": [
|
|
1387
|
+
"ticketKey",
|
|
1388
|
+
"project",
|
|
1389
|
+
"question"
|
|
1390
|
+
],
|
|
1391
|
+
"additionalProperties": false,
|
|
1392
|
+
"description": "An open ticket question that counts as a direct report's: asked by its session, or in one of its projects."
|
|
1393
|
+
},
|
|
1394
|
+
"IDeviceDirectReportResult": {
|
|
1395
|
+
"type": "object",
|
|
1396
|
+
"properties": {
|
|
1397
|
+
"text": {
|
|
1398
|
+
"type": "string"
|
|
1399
|
+
},
|
|
1400
|
+
"at": {
|
|
1401
|
+
"type": "integer"
|
|
1402
|
+
}
|
|
1403
|
+
},
|
|
1404
|
+
"required": [
|
|
1405
|
+
"text",
|
|
1406
|
+
"at"
|
|
1407
|
+
],
|
|
1408
|
+
"additionalProperties": false,
|
|
1409
|
+
"description": "The newest `result:` line a direct report's session ended a turn or reported on. Since protocol 1.3."
|
|
1410
|
+
},
|
|
1411
|
+
"IDeviceDirectReportsChangedEvent": {
|
|
1412
|
+
"type": "object",
|
|
1413
|
+
"properties": {
|
|
1414
|
+
"type": {
|
|
1415
|
+
"type": "string",
|
|
1416
|
+
"const": "directreports.changed"
|
|
1417
|
+
}
|
|
1418
|
+
},
|
|
1419
|
+
"required": [
|
|
1420
|
+
"type"
|
|
1421
|
+
],
|
|
1422
|
+
"additionalProperties": false,
|
|
1423
|
+
"description": "The direct reports, their workers or their open questions changed: list them again. Since protocol 1.3."
|
|
1424
|
+
},
|
|
1425
|
+
"IDeviceDriverChangedEvent": {
|
|
1426
|
+
"type": "object",
|
|
1427
|
+
"properties": {
|
|
1428
|
+
"type": {
|
|
1429
|
+
"type": "string",
|
|
1430
|
+
"const": "driver.changed"
|
|
1431
|
+
},
|
|
1432
|
+
"driver": {
|
|
1433
|
+
"$ref": "#/components/schemas/IDeviceDriverStatus"
|
|
1434
|
+
}
|
|
1435
|
+
},
|
|
1436
|
+
"required": [
|
|
1437
|
+
"type",
|
|
1438
|
+
"driver"
|
|
1439
|
+
],
|
|
1440
|
+
"additionalProperties": false,
|
|
1441
|
+
"description": "The driver's status changed, or its transcript or prompts did: apply `driver`, and read an open Driver view again. A device that was resynchronized (`sessions.changed`) reads it again too. Since protocol 1.3."
|
|
1442
|
+
},
|
|
1443
|
+
"IDeviceDriverStatus": {
|
|
1444
|
+
"type": "object",
|
|
1445
|
+
"properties": {
|
|
1446
|
+
"activity": {
|
|
1447
|
+
"$ref": "#/components/schemas/TDeviceDriverActivity"
|
|
1448
|
+
},
|
|
1449
|
+
"unreadCount": {
|
|
1450
|
+
"type": "integer",
|
|
1451
|
+
"description": "Driver turns that ended since the owner last marked the driver seen, in any client: one count for all of them."
|
|
1452
|
+
},
|
|
1453
|
+
"title": {
|
|
1454
|
+
"type": "string",
|
|
1455
|
+
"description": "The driver session's title, while it can be read."
|
|
1456
|
+
},
|
|
1457
|
+
"needsInput": {
|
|
1458
|
+
"type": "string",
|
|
1459
|
+
"description": "The `needs input:` line the driver's last turn ended on, while that turn is what `needs_input` stands for."
|
|
1460
|
+
},
|
|
1461
|
+
"updatedAt": {
|
|
1462
|
+
"type": "integer",
|
|
1463
|
+
"description": "Unix milliseconds of the last status change."
|
|
1464
|
+
}
|
|
1465
|
+
},
|
|
1466
|
+
"required": [
|
|
1467
|
+
"activity",
|
|
1468
|
+
"unreadCount",
|
|
1469
|
+
"updatedAt"
|
|
1470
|
+
],
|
|
1471
|
+
"additionalProperties": false,
|
|
1472
|
+
"description": "The host's driver as a device sees it. Since protocol 1.3."
|
|
1473
|
+
},
|
|
444
1474
|
"IDeviceElicitationBooleanField": {
|
|
445
1475
|
"type": "object",
|
|
446
1476
|
"properties": {
|
|
447
|
-
"kind": {
|
|
448
|
-
"type": "string",
|
|
449
|
-
"const": "boolean"
|
|
450
|
-
},
|
|
1477
|
+
"kind": {
|
|
1478
|
+
"type": "string",
|
|
1479
|
+
"const": "boolean"
|
|
1480
|
+
},
|
|
1481
|
+
"name": {
|
|
1482
|
+
"type": "string"
|
|
1483
|
+
},
|
|
1484
|
+
"title": {
|
|
1485
|
+
"type": "string"
|
|
1486
|
+
},
|
|
1487
|
+
"description": {
|
|
1488
|
+
"type": "string"
|
|
1489
|
+
},
|
|
1490
|
+
"required": {
|
|
1491
|
+
"type": "boolean"
|
|
1492
|
+
},
|
|
1493
|
+
"default": {
|
|
1494
|
+
"type": "boolean"
|
|
1495
|
+
}
|
|
1496
|
+
},
|
|
1497
|
+
"required": [
|
|
1498
|
+
"kind",
|
|
1499
|
+
"name",
|
|
1500
|
+
"required"
|
|
1501
|
+
],
|
|
1502
|
+
"additionalProperties": false,
|
|
1503
|
+
"description": "A yes or no."
|
|
1504
|
+
},
|
|
1505
|
+
"IDeviceElicitationChoiceField": {
|
|
1506
|
+
"type": "object",
|
|
1507
|
+
"properties": {
|
|
1508
|
+
"kind": {
|
|
1509
|
+
"type": "string",
|
|
1510
|
+
"const": "choice"
|
|
1511
|
+
},
|
|
1512
|
+
"name": {
|
|
1513
|
+
"type": "string"
|
|
1514
|
+
},
|
|
1515
|
+
"title": {
|
|
1516
|
+
"type": "string"
|
|
1517
|
+
},
|
|
1518
|
+
"description": {
|
|
1519
|
+
"type": "string"
|
|
1520
|
+
},
|
|
1521
|
+
"required": {
|
|
1522
|
+
"type": "boolean"
|
|
1523
|
+
},
|
|
1524
|
+
"options": {
|
|
1525
|
+
"type": "array",
|
|
1526
|
+
"items": {
|
|
1527
|
+
"$ref": "#/components/schemas/IDeviceElicitationOption"
|
|
1528
|
+
}
|
|
1529
|
+
},
|
|
1530
|
+
"default": {
|
|
1531
|
+
"type": "string"
|
|
1532
|
+
}
|
|
1533
|
+
},
|
|
1534
|
+
"required": [
|
|
1535
|
+
"kind",
|
|
1536
|
+
"name",
|
|
1537
|
+
"required",
|
|
1538
|
+
"options"
|
|
1539
|
+
],
|
|
1540
|
+
"additionalProperties": false,
|
|
1541
|
+
"description": "One choice among the options; the answer carries the option's `value`."
|
|
1542
|
+
},
|
|
1543
|
+
"IDeviceElicitationChoicesField": {
|
|
1544
|
+
"type": "object",
|
|
1545
|
+
"properties": {
|
|
1546
|
+
"kind": {
|
|
1547
|
+
"type": "string",
|
|
1548
|
+
"const": "choices"
|
|
1549
|
+
},
|
|
1550
|
+
"name": {
|
|
1551
|
+
"type": "string"
|
|
1552
|
+
},
|
|
1553
|
+
"title": {
|
|
1554
|
+
"type": "string"
|
|
1555
|
+
},
|
|
1556
|
+
"description": {
|
|
1557
|
+
"type": "string"
|
|
1558
|
+
},
|
|
1559
|
+
"required": {
|
|
1560
|
+
"type": "boolean"
|
|
1561
|
+
},
|
|
1562
|
+
"options": {
|
|
1563
|
+
"type": "array",
|
|
1564
|
+
"items": {
|
|
1565
|
+
"$ref": "#/components/schemas/IDeviceElicitationOption"
|
|
1566
|
+
}
|
|
1567
|
+
},
|
|
1568
|
+
"minItems": {
|
|
1569
|
+
"type": "integer"
|
|
1570
|
+
},
|
|
1571
|
+
"maxItems": {
|
|
1572
|
+
"type": "integer"
|
|
1573
|
+
},
|
|
1574
|
+
"default": {
|
|
1575
|
+
"type": "array",
|
|
1576
|
+
"items": {
|
|
1577
|
+
"type": "string"
|
|
1578
|
+
}
|
|
1579
|
+
}
|
|
1580
|
+
},
|
|
1581
|
+
"required": [
|
|
1582
|
+
"kind",
|
|
1583
|
+
"name",
|
|
1584
|
+
"required",
|
|
1585
|
+
"options"
|
|
1586
|
+
],
|
|
1587
|
+
"additionalProperties": false,
|
|
1588
|
+
"description": "Several of the options, each at most once; the answer carries their `value`s."
|
|
1589
|
+
},
|
|
1590
|
+
"IDeviceElicitationForm": {
|
|
1591
|
+
"type": "object",
|
|
1592
|
+
"properties": {
|
|
1593
|
+
"mode": {
|
|
1594
|
+
"type": "string",
|
|
1595
|
+
"const": "form"
|
|
1596
|
+
},
|
|
1597
|
+
"id": {
|
|
1598
|
+
"type": "string"
|
|
1599
|
+
},
|
|
1600
|
+
"serverName": {
|
|
1601
|
+
"type": "string"
|
|
1602
|
+
},
|
|
1603
|
+
"message": {
|
|
1604
|
+
"type": "string"
|
|
1605
|
+
},
|
|
1606
|
+
"fields": {
|
|
1607
|
+
"type": "array",
|
|
1608
|
+
"items": {
|
|
1609
|
+
"$ref": "#/components/schemas/TDeviceElicitationField"
|
|
1610
|
+
}
|
|
1611
|
+
},
|
|
1612
|
+
"createdAt": {
|
|
1613
|
+
"type": "integer"
|
|
1614
|
+
}
|
|
1615
|
+
},
|
|
1616
|
+
"required": [
|
|
1617
|
+
"mode",
|
|
1618
|
+
"id",
|
|
1619
|
+
"serverName",
|
|
1620
|
+
"message",
|
|
1621
|
+
"fields",
|
|
1622
|
+
"createdAt"
|
|
1623
|
+
],
|
|
1624
|
+
"additionalProperties": false,
|
|
1625
|
+
"description": "An MCP server of the session asks the owner to fill in `fields`; it is never answered automatically."
|
|
1626
|
+
},
|
|
1627
|
+
"IDeviceElicitationNumberField": {
|
|
1628
|
+
"type": "object",
|
|
1629
|
+
"properties": {
|
|
1630
|
+
"kind": {
|
|
1631
|
+
"type": "string",
|
|
1632
|
+
"const": "number"
|
|
1633
|
+
},
|
|
1634
|
+
"name": {
|
|
1635
|
+
"type": "string"
|
|
1636
|
+
},
|
|
1637
|
+
"title": {
|
|
1638
|
+
"type": "string"
|
|
1639
|
+
},
|
|
1640
|
+
"description": {
|
|
1641
|
+
"type": "string"
|
|
1642
|
+
},
|
|
1643
|
+
"required": {
|
|
1644
|
+
"type": "boolean"
|
|
1645
|
+
},
|
|
1646
|
+
"integer": {
|
|
1647
|
+
"type": "boolean"
|
|
1648
|
+
},
|
|
1649
|
+
"minimum": {
|
|
1650
|
+
"type": "number"
|
|
1651
|
+
},
|
|
1652
|
+
"maximum": {
|
|
1653
|
+
"type": "number"
|
|
1654
|
+
},
|
|
1655
|
+
"default": {
|
|
1656
|
+
"type": "number"
|
|
1657
|
+
}
|
|
1658
|
+
},
|
|
1659
|
+
"required": [
|
|
1660
|
+
"kind",
|
|
1661
|
+
"name",
|
|
1662
|
+
"required",
|
|
1663
|
+
"integer"
|
|
1664
|
+
],
|
|
1665
|
+
"additionalProperties": false,
|
|
1666
|
+
"description": "A number field; `integer` takes whole numbers only, the bounds are inclusive."
|
|
1667
|
+
},
|
|
1668
|
+
"IDeviceElicitationOption": {
|
|
1669
|
+
"type": "object",
|
|
1670
|
+
"properties": {
|
|
1671
|
+
"value": {
|
|
1672
|
+
"type": "string"
|
|
1673
|
+
},
|
|
1674
|
+
"label": {
|
|
1675
|
+
"type": "string"
|
|
1676
|
+
}
|
|
1677
|
+
},
|
|
1678
|
+
"required": [
|
|
1679
|
+
"value",
|
|
1680
|
+
"label"
|
|
1681
|
+
],
|
|
1682
|
+
"additionalProperties": false,
|
|
1683
|
+
"description": "One choice of an elicitation field: the value the answer carries, and its label."
|
|
1684
|
+
},
|
|
1685
|
+
"IDeviceElicitationTextField": {
|
|
1686
|
+
"type": "object",
|
|
1687
|
+
"properties": {
|
|
1688
|
+
"kind": {
|
|
1689
|
+
"type": "string",
|
|
1690
|
+
"const": "text"
|
|
1691
|
+
},
|
|
1692
|
+
"name": {
|
|
1693
|
+
"type": "string",
|
|
1694
|
+
"description": "The name the answer carries the value under."
|
|
1695
|
+
},
|
|
1696
|
+
"title": {
|
|
1697
|
+
"type": "string"
|
|
1698
|
+
},
|
|
1699
|
+
"description": {
|
|
1700
|
+
"type": "string"
|
|
1701
|
+
},
|
|
1702
|
+
"required": {
|
|
1703
|
+
"type": "boolean"
|
|
1704
|
+
},
|
|
1705
|
+
"format": {
|
|
1706
|
+
"type": "string",
|
|
1707
|
+
"enum": [
|
|
1708
|
+
"email",
|
|
1709
|
+
"uri",
|
|
1710
|
+
"date",
|
|
1711
|
+
"date-time"
|
|
1712
|
+
]
|
|
1713
|
+
},
|
|
1714
|
+
"minLength": {
|
|
1715
|
+
"type": "integer"
|
|
1716
|
+
},
|
|
1717
|
+
"maxLength": {
|
|
1718
|
+
"type": "integer"
|
|
1719
|
+
},
|
|
1720
|
+
"default": {
|
|
1721
|
+
"type": "string"
|
|
1722
|
+
}
|
|
1723
|
+
},
|
|
1724
|
+
"required": [
|
|
1725
|
+
"kind",
|
|
1726
|
+
"name",
|
|
1727
|
+
"required"
|
|
1728
|
+
],
|
|
1729
|
+
"additionalProperties": false,
|
|
1730
|
+
"description": "A text field; a value is checked against `format` (`email`, `uri`, `date`, `date-time`) and the lengths in characters."
|
|
1731
|
+
},
|
|
1732
|
+
"IDeviceElicitationUnsupported": {
|
|
1733
|
+
"type": "object",
|
|
1734
|
+
"properties": {
|
|
1735
|
+
"mode": {
|
|
1736
|
+
"type": "string",
|
|
1737
|
+
"const": "unsupported"
|
|
1738
|
+
},
|
|
1739
|
+
"id": {
|
|
1740
|
+
"type": "string"
|
|
1741
|
+
},
|
|
1742
|
+
"serverName": {
|
|
1743
|
+
"type": "string"
|
|
1744
|
+
},
|
|
1745
|
+
"message": {
|
|
1746
|
+
"type": "string"
|
|
1747
|
+
},
|
|
1748
|
+
"reason": {
|
|
1749
|
+
"type": "string"
|
|
1750
|
+
},
|
|
1751
|
+
"createdAt": {
|
|
1752
|
+
"type": "integer"
|
|
1753
|
+
}
|
|
1754
|
+
},
|
|
1755
|
+
"required": [
|
|
1756
|
+
"mode",
|
|
1757
|
+
"id",
|
|
1758
|
+
"serverName",
|
|
1759
|
+
"message",
|
|
1760
|
+
"reason",
|
|
1761
|
+
"createdAt"
|
|
1762
|
+
],
|
|
1763
|
+
"additionalProperties": false,
|
|
1764
|
+
"description": "An MCP request AGL cannot collect, with the reason: only decline or cancel answer it."
|
|
1765
|
+
},
|
|
1766
|
+
"IDeviceElicitationUrl": {
|
|
1767
|
+
"type": "object",
|
|
1768
|
+
"properties": {
|
|
1769
|
+
"mode": {
|
|
1770
|
+
"type": "string",
|
|
1771
|
+
"const": "url"
|
|
1772
|
+
},
|
|
1773
|
+
"id": {
|
|
1774
|
+
"type": "string"
|
|
1775
|
+
},
|
|
1776
|
+
"serverName": {
|
|
1777
|
+
"type": "string"
|
|
1778
|
+
},
|
|
1779
|
+
"message": {
|
|
1780
|
+
"type": "string"
|
|
1781
|
+
},
|
|
1782
|
+
"url": {
|
|
1783
|
+
"type": "string"
|
|
1784
|
+
},
|
|
1785
|
+
"createdAt": {
|
|
1786
|
+
"type": "integer"
|
|
1787
|
+
}
|
|
1788
|
+
},
|
|
1789
|
+
"required": [
|
|
1790
|
+
"mode",
|
|
1791
|
+
"id",
|
|
1792
|
+
"serverName",
|
|
1793
|
+
"message",
|
|
1794
|
+
"url",
|
|
1795
|
+
"createdAt"
|
|
1796
|
+
],
|
|
1797
|
+
"additionalProperties": false,
|
|
1798
|
+
"description": "An MCP server of the session asks the owner to visit `url`, which AGL never opens or fetches: show it as plain text and accept, without content, once the owner reports the visit done."
|
|
1799
|
+
},
|
|
1800
|
+
"IDeviceHostAgl": {
|
|
1801
|
+
"type": "object",
|
|
1802
|
+
"properties": {
|
|
1803
|
+
"version": {
|
|
1804
|
+
"type": "string",
|
|
1805
|
+
"description": "The AGL release, such as `43.2.0`."
|
|
1806
|
+
},
|
|
1807
|
+
"startedAt": {
|
|
1808
|
+
"type": "integer",
|
|
1809
|
+
"description": "Unix milliseconds the controller started."
|
|
1810
|
+
},
|
|
1811
|
+
"origin": {
|
|
1812
|
+
"type": "string",
|
|
1813
|
+
"description": "The public origin a device reaches the host at."
|
|
1814
|
+
},
|
|
1815
|
+
"reach": {
|
|
1816
|
+
"anyOf": [
|
|
1817
|
+
{
|
|
1818
|
+
"$ref": "#/components/schemas/IDeviceHostGatewayReach"
|
|
1819
|
+
},
|
|
1820
|
+
{
|
|
1821
|
+
"$ref": "#/components/schemas/IDeviceHostProxyReach"
|
|
1822
|
+
}
|
|
1823
|
+
]
|
|
1824
|
+
}
|
|
1825
|
+
},
|
|
1826
|
+
"required": [
|
|
1827
|
+
"version",
|
|
1828
|
+
"startedAt",
|
|
1829
|
+
"origin",
|
|
1830
|
+
"reach"
|
|
1831
|
+
],
|
|
1832
|
+
"additionalProperties": false,
|
|
1833
|
+
"description": "The AGL that runs on the host, and how a device reaches it. Since protocol 1.3."
|
|
1834
|
+
},
|
|
1835
|
+
"IDeviceHostApiKeys": {
|
|
1836
|
+
"type": "object",
|
|
1837
|
+
"properties": {
|
|
1838
|
+
"state": {
|
|
1839
|
+
"type": "string",
|
|
1840
|
+
"const": "ready"
|
|
1841
|
+
},
|
|
1842
|
+
"groups": {
|
|
1843
|
+
"type": "array",
|
|
1844
|
+
"items": {
|
|
1845
|
+
"$ref": "#/components/schemas/IDeviceApiKeyGroup"
|
|
1846
|
+
}
|
|
1847
|
+
}
|
|
1848
|
+
},
|
|
1849
|
+
"required": [
|
|
1850
|
+
"state",
|
|
1851
|
+
"groups"
|
|
1852
|
+
],
|
|
1853
|
+
"additionalProperties": false,
|
|
1854
|
+
"description": "The host's API keys, per provider that holds any. Since protocol 1.3."
|
|
1855
|
+
},
|
|
1856
|
+
"IDeviceHostChangedEvent": {
|
|
1857
|
+
"type": "object",
|
|
1858
|
+
"properties": {
|
|
1859
|
+
"type": {
|
|
1860
|
+
"type": "string",
|
|
1861
|
+
"const": "host.changed"
|
|
1862
|
+
}
|
|
1863
|
+
},
|
|
1864
|
+
"required": [
|
|
1865
|
+
"type"
|
|
1866
|
+
],
|
|
1867
|
+
"additionalProperties": false,
|
|
1868
|
+
"description": "What the host's status reads may have changed: its deploy targets, their planned deploys (tickets) or its accounts. It says nothing more: an open Host view reads `device.host.get` again. Since protocol 1.3."
|
|
1869
|
+
},
|
|
1870
|
+
"IDeviceHostDeploys": {
|
|
1871
|
+
"type": "object",
|
|
1872
|
+
"properties": {
|
|
1873
|
+
"state": {
|
|
1874
|
+
"type": "string",
|
|
1875
|
+
"const": "ready"
|
|
1876
|
+
},
|
|
1877
|
+
"checkedAt": {
|
|
1878
|
+
"type": "integer"
|
|
1879
|
+
},
|
|
1880
|
+
"targets": {
|
|
1881
|
+
"type": "array",
|
|
1882
|
+
"items": {
|
|
1883
|
+
"$ref": "#/components/schemas/IDeviceDeployTarget"
|
|
1884
|
+
}
|
|
1885
|
+
}
|
|
1886
|
+
},
|
|
1887
|
+
"required": [
|
|
1888
|
+
"state",
|
|
1889
|
+
"checkedAt",
|
|
1890
|
+
"targets"
|
|
1891
|
+
],
|
|
1892
|
+
"additionalProperties": false,
|
|
1893
|
+
"description": "The host's deploy targets, the AGL controller among them. Since protocol 1.3."
|
|
1894
|
+
},
|
|
1895
|
+
"IDeviceHostDevice": {
|
|
1896
|
+
"type": "object",
|
|
1897
|
+
"properties": {
|
|
1898
|
+
"name": {
|
|
1899
|
+
"type": "string"
|
|
1900
|
+
},
|
|
1901
|
+
"model": {
|
|
1902
|
+
"type": "string"
|
|
1903
|
+
},
|
|
1904
|
+
"pairedAt": {
|
|
1905
|
+
"type": "integer",
|
|
1906
|
+
"description": "Unix milliseconds it paired."
|
|
1907
|
+
},
|
|
1908
|
+
"lastSeenAt": {
|
|
1909
|
+
"type": "integer",
|
|
1910
|
+
"description": "Unix milliseconds of its last authenticated connection, kept to about five minutes."
|
|
1911
|
+
}
|
|
1912
|
+
},
|
|
1913
|
+
"required": [
|
|
1914
|
+
"name",
|
|
1915
|
+
"model",
|
|
1916
|
+
"pairedAt"
|
|
1917
|
+
],
|
|
1918
|
+
"additionalProperties": false,
|
|
1919
|
+
"description": "This device, as the host keeps it: read-only, a device neither renames nor unpairs itself. Since protocol 1.3."
|
|
1920
|
+
},
|
|
1921
|
+
"IDeviceHostGatewayReach": {
|
|
1922
|
+
"type": "object",
|
|
1923
|
+
"properties": {
|
|
1924
|
+
"kind": {
|
|
1925
|
+
"type": "string",
|
|
1926
|
+
"const": "gateway"
|
|
1927
|
+
},
|
|
1928
|
+
"state": {
|
|
1929
|
+
"$ref": "#/components/schemas/TDeviceGatewayState"
|
|
1930
|
+
}
|
|
1931
|
+
},
|
|
1932
|
+
"required": [
|
|
1933
|
+
"kind",
|
|
1934
|
+
"state"
|
|
1935
|
+
],
|
|
1936
|
+
"additionalProperties": false,
|
|
1937
|
+
"description": "The host reached through its gateway, which AGL keeps its own route on. Since protocol 1.3."
|
|
1938
|
+
},
|
|
1939
|
+
"IDeviceHostPools": {
|
|
1940
|
+
"type": "object",
|
|
1941
|
+
"properties": {
|
|
1942
|
+
"state": {
|
|
1943
|
+
"type": "string",
|
|
1944
|
+
"const": "ready"
|
|
1945
|
+
},
|
|
1946
|
+
"pools": {
|
|
1947
|
+
"type": "array",
|
|
1948
|
+
"items": {
|
|
1949
|
+
"$ref": "#/components/schemas/IDevicePool"
|
|
1950
|
+
}
|
|
1951
|
+
}
|
|
1952
|
+
},
|
|
1953
|
+
"required": [
|
|
1954
|
+
"state",
|
|
1955
|
+
"pools"
|
|
1956
|
+
],
|
|
1957
|
+
"additionalProperties": false,
|
|
1958
|
+
"description": "The host's account pools. Since protocol 1.3."
|
|
1959
|
+
},
|
|
1960
|
+
"IDeviceHostProxyReach": {
|
|
1961
|
+
"type": "object",
|
|
1962
|
+
"properties": {
|
|
1963
|
+
"kind": {
|
|
1964
|
+
"type": "string",
|
|
1965
|
+
"const": "proxy"
|
|
1966
|
+
}
|
|
1967
|
+
},
|
|
1968
|
+
"required": [
|
|
1969
|
+
"kind"
|
|
1970
|
+
],
|
|
1971
|
+
"additionalProperties": false,
|
|
1972
|
+
"description": "The host reached through a TLS reverse proxy the owner runs. Since protocol 1.3."
|
|
1973
|
+
},
|
|
1974
|
+
"IDeviceHostUnavailable": {
|
|
1975
|
+
"type": "object",
|
|
1976
|
+
"properties": {
|
|
1977
|
+
"state": {
|
|
1978
|
+
"type": "string",
|
|
1979
|
+
"const": "unavailable"
|
|
1980
|
+
},
|
|
1981
|
+
"reason": {
|
|
1982
|
+
"$ref": "#/components/schemas/TDeviceHostUnavailableReason"
|
|
1983
|
+
},
|
|
1984
|
+
"reference": {
|
|
1985
|
+
"type": "string",
|
|
1986
|
+
"description": "For `failed`: the failure journal's reference, which the browser's diagnostics show the cause under."
|
|
1987
|
+
}
|
|
1988
|
+
},
|
|
1989
|
+
"required": [
|
|
1990
|
+
"state",
|
|
1991
|
+
"reason"
|
|
1992
|
+
],
|
|
1993
|
+
"additionalProperties": false,
|
|
1994
|
+
"description": "A section that was not read: of the host's status, whose other sections are read on their own, or a ticket's placement (`device.ticket.get`). Since protocol 1.3."
|
|
1995
|
+
},
|
|
1996
|
+
"IDeviceInboxChangedEvent": {
|
|
1997
|
+
"type": "object",
|
|
1998
|
+
"properties": {
|
|
1999
|
+
"type": {
|
|
2000
|
+
"type": "string",
|
|
2001
|
+
"const": "inbox.changed"
|
|
2002
|
+
},
|
|
2003
|
+
"delta": {
|
|
2004
|
+
"$ref": "#/components/schemas/IDeviceInboxDelta"
|
|
2005
|
+
}
|
|
2006
|
+
},
|
|
2007
|
+
"required": [
|
|
2008
|
+
"type",
|
|
2009
|
+
"delta"
|
|
2010
|
+
],
|
|
2011
|
+
"additionalProperties": false,
|
|
2012
|
+
"description": "The Inbox changed. Since protocol 1.2."
|
|
2013
|
+
},
|
|
2014
|
+
"IDeviceInboxDelta": {
|
|
2015
|
+
"type": "object",
|
|
2016
|
+
"properties": {
|
|
2017
|
+
"epoch": {
|
|
2018
|
+
"type": "string"
|
|
2019
|
+
},
|
|
2020
|
+
"revision": {
|
|
2021
|
+
"type": "integer"
|
|
2022
|
+
},
|
|
2023
|
+
"reset": {
|
|
2024
|
+
"type": "boolean"
|
|
2025
|
+
},
|
|
2026
|
+
"upserts": {
|
|
2027
|
+
"type": "array",
|
|
2028
|
+
"items": {
|
|
2029
|
+
"$ref": "#/components/schemas/TDeviceInboxItem"
|
|
2030
|
+
}
|
|
2031
|
+
},
|
|
2032
|
+
"removed": {
|
|
2033
|
+
"type": "array",
|
|
2034
|
+
"items": {
|
|
2035
|
+
"type": "string"
|
|
2036
|
+
}
|
|
2037
|
+
},
|
|
2038
|
+
"order": {
|
|
2039
|
+
"type": "array",
|
|
2040
|
+
"items": {
|
|
2041
|
+
"type": "string"
|
|
2042
|
+
}
|
|
2043
|
+
},
|
|
2044
|
+
"total": {
|
|
2045
|
+
"type": "integer"
|
|
2046
|
+
},
|
|
2047
|
+
"limited": {
|
|
2048
|
+
"type": "boolean"
|
|
2049
|
+
}
|
|
2050
|
+
},
|
|
2051
|
+
"required": [
|
|
2052
|
+
"epoch",
|
|
2053
|
+
"revision",
|
|
2054
|
+
"reset",
|
|
2055
|
+
"upserts",
|
|
2056
|
+
"removed",
|
|
2057
|
+
"order",
|
|
2058
|
+
"total",
|
|
2059
|
+
"limited"
|
|
2060
|
+
],
|
|
2061
|
+
"additionalProperties": false,
|
|
2062
|
+
"description": "An Inbox change: apply it on the same epoch at the revision after the held one, then show the items in `order`; on `reset` or any gap, list again. `total` counts every item, also those `limited` left out of the list."
|
|
2063
|
+
},
|
|
2064
|
+
"IDeviceInboxDeployGoItem": {
|
|
2065
|
+
"type": "object",
|
|
2066
|
+
"properties": {
|
|
2067
|
+
"id": {
|
|
2068
|
+
"type": "string",
|
|
2069
|
+
"description": "Stable across clients: the kind, where it lives and the request or question id."
|
|
2070
|
+
},
|
|
2071
|
+
"since": {
|
|
2072
|
+
"type": "integer",
|
|
2073
|
+
"description": "Unix milliseconds since it waits."
|
|
2074
|
+
},
|
|
2075
|
+
"title": {
|
|
2076
|
+
"type": "string",
|
|
2077
|
+
"description": "One line: what is asked."
|
|
2078
|
+
},
|
|
2079
|
+
"where": {
|
|
2080
|
+
"$ref": "#/components/schemas/TDeviceInboxWhere"
|
|
2081
|
+
},
|
|
2082
|
+
"answer": {
|
|
2083
|
+
"$ref": "#/components/schemas/TDeviceInboxAnswer"
|
|
2084
|
+
},
|
|
2085
|
+
"omitted": {
|
|
2086
|
+
"$ref": "#/components/schemas/IDeviceInboxOmission",
|
|
2087
|
+
"description": "Set when the payload was left out for its size: it is answered only where it lives."
|
|
2088
|
+
},
|
|
2089
|
+
"kind": {
|
|
2090
|
+
"type": "string",
|
|
2091
|
+
"const": "deploy_go"
|
|
2092
|
+
},
|
|
2093
|
+
"question": {
|
|
2094
|
+
"$ref": "#/components/schemas/IDeviceTicketQuestion"
|
|
2095
|
+
},
|
|
2096
|
+
"plan": {
|
|
2097
|
+
"$ref": "#/components/schemas/IDeviceDeployGo"
|
|
2098
|
+
}
|
|
2099
|
+
},
|
|
2100
|
+
"required": [
|
|
2101
|
+
"answer",
|
|
2102
|
+
"id",
|
|
2103
|
+
"kind",
|
|
2104
|
+
"plan",
|
|
2105
|
+
"since",
|
|
2106
|
+
"title",
|
|
2107
|
+
"where"
|
|
2108
|
+
],
|
|
2109
|
+
"additionalProperties": false
|
|
2110
|
+
},
|
|
2111
|
+
"IDeviceInboxDriverItem": {
|
|
2112
|
+
"type": "object",
|
|
2113
|
+
"properties": {
|
|
2114
|
+
"id": {
|
|
2115
|
+
"type": "string",
|
|
2116
|
+
"description": "Stable across clients: the kind, where it lives and the request or question id."
|
|
2117
|
+
},
|
|
2118
|
+
"since": {
|
|
2119
|
+
"type": "integer",
|
|
2120
|
+
"description": "Unix milliseconds since it waits."
|
|
2121
|
+
},
|
|
2122
|
+
"title": {
|
|
2123
|
+
"type": "string",
|
|
2124
|
+
"description": "One line: what is asked."
|
|
2125
|
+
},
|
|
2126
|
+
"where": {
|
|
2127
|
+
"$ref": "#/components/schemas/TDeviceInboxWhere"
|
|
2128
|
+
},
|
|
2129
|
+
"answer": {
|
|
2130
|
+
"$ref": "#/components/schemas/TDeviceInboxAnswer"
|
|
2131
|
+
},
|
|
2132
|
+
"omitted": {
|
|
2133
|
+
"$ref": "#/components/schemas/IDeviceInboxOmission",
|
|
2134
|
+
"description": "Set when the payload was left out for its size: it is answered only where it lives."
|
|
2135
|
+
},
|
|
2136
|
+
"kind": {
|
|
2137
|
+
"type": "string",
|
|
2138
|
+
"const": "driver"
|
|
2139
|
+
},
|
|
2140
|
+
"line": {
|
|
2141
|
+
"type": "string"
|
|
2142
|
+
}
|
|
2143
|
+
},
|
|
2144
|
+
"required": [
|
|
2145
|
+
"answer",
|
|
2146
|
+
"id",
|
|
2147
|
+
"kind",
|
|
2148
|
+
"since",
|
|
2149
|
+
"title",
|
|
2150
|
+
"where"
|
|
2151
|
+
],
|
|
2152
|
+
"additionalProperties": false,
|
|
2153
|
+
"description": "The driver's last turn ended on this `needs input:` line."
|
|
2154
|
+
},
|
|
2155
|
+
"IDeviceInboxElicitationItem": {
|
|
2156
|
+
"type": "object",
|
|
2157
|
+
"properties": {
|
|
2158
|
+
"id": {
|
|
2159
|
+
"type": "string",
|
|
2160
|
+
"description": "Stable across clients: the kind, where it lives and the request or question id."
|
|
2161
|
+
},
|
|
2162
|
+
"since": {
|
|
2163
|
+
"type": "integer",
|
|
2164
|
+
"description": "Unix milliseconds since it waits."
|
|
2165
|
+
},
|
|
2166
|
+
"title": {
|
|
2167
|
+
"type": "string",
|
|
2168
|
+
"description": "One line: what is asked."
|
|
2169
|
+
},
|
|
2170
|
+
"where": {
|
|
2171
|
+
"$ref": "#/components/schemas/TDeviceInboxWhere"
|
|
2172
|
+
},
|
|
2173
|
+
"answer": {
|
|
2174
|
+
"$ref": "#/components/schemas/TDeviceInboxAnswer"
|
|
2175
|
+
},
|
|
2176
|
+
"omitted": {
|
|
2177
|
+
"$ref": "#/components/schemas/IDeviceInboxOmission",
|
|
2178
|
+
"description": "Set when the payload was left out for its size: it is answered only where it lives."
|
|
2179
|
+
},
|
|
2180
|
+
"kind": {
|
|
2181
|
+
"type": "string",
|
|
2182
|
+
"const": "elicitation"
|
|
2183
|
+
},
|
|
2184
|
+
"elicitation": {
|
|
2185
|
+
"$ref": "#/components/schemas/TDeviceElicitation"
|
|
2186
|
+
}
|
|
2187
|
+
},
|
|
2188
|
+
"required": [
|
|
2189
|
+
"answer",
|
|
2190
|
+
"id",
|
|
2191
|
+
"kind",
|
|
2192
|
+
"since",
|
|
2193
|
+
"title",
|
|
2194
|
+
"where"
|
|
2195
|
+
],
|
|
2196
|
+
"additionalProperties": false
|
|
2197
|
+
},
|
|
2198
|
+
"IDeviceInboxNativeWaitItem": {
|
|
2199
|
+
"type": "object",
|
|
2200
|
+
"properties": {
|
|
2201
|
+
"id": {
|
|
2202
|
+
"type": "string",
|
|
2203
|
+
"description": "Stable across clients: the kind, where it lives and the request or question id."
|
|
2204
|
+
},
|
|
2205
|
+
"since": {
|
|
2206
|
+
"type": "integer",
|
|
2207
|
+
"description": "Unix milliseconds since it waits."
|
|
2208
|
+
},
|
|
2209
|
+
"title": {
|
|
2210
|
+
"type": "string",
|
|
2211
|
+
"description": "One line: what is asked."
|
|
2212
|
+
},
|
|
2213
|
+
"where": {
|
|
2214
|
+
"$ref": "#/components/schemas/TDeviceInboxWhere"
|
|
2215
|
+
},
|
|
2216
|
+
"answer": {
|
|
2217
|
+
"$ref": "#/components/schemas/TDeviceInboxAnswer"
|
|
2218
|
+
},
|
|
2219
|
+
"omitted": {
|
|
2220
|
+
"$ref": "#/components/schemas/IDeviceInboxOmission",
|
|
2221
|
+
"description": "Set when the payload was left out for its size: it is answered only where it lives."
|
|
2222
|
+
},
|
|
2223
|
+
"kind": {
|
|
2224
|
+
"type": "string",
|
|
2225
|
+
"const": "native_wait"
|
|
2226
|
+
},
|
|
2227
|
+
"reason": {
|
|
2228
|
+
"type": "string",
|
|
2229
|
+
"enum": [
|
|
2230
|
+
"approval",
|
|
2231
|
+
"user_input",
|
|
2232
|
+
"native_prompt",
|
|
2233
|
+
"unrecognized"
|
|
2234
|
+
],
|
|
2235
|
+
"description": "`approval`, `user_input`, `native_prompt` (Claude Code) or `unrecognized`."
|
|
2236
|
+
},
|
|
2237
|
+
"host": {
|
|
2238
|
+
"type": "string"
|
|
2239
|
+
}
|
|
2240
|
+
},
|
|
2241
|
+
"required": [
|
|
2242
|
+
"answer",
|
|
2243
|
+
"host",
|
|
2244
|
+
"id",
|
|
2245
|
+
"kind",
|
|
2246
|
+
"reason",
|
|
2247
|
+
"since",
|
|
2248
|
+
"title",
|
|
2249
|
+
"where"
|
|
2250
|
+
],
|
|
2251
|
+
"additionalProperties": false,
|
|
2252
|
+
"description": "The harness waits in its own client on this controller's host, `host`: it is answered there."
|
|
2253
|
+
},
|
|
2254
|
+
"IDeviceInboxOmission": {
|
|
2255
|
+
"type": "object",
|
|
2256
|
+
"properties": {
|
|
2257
|
+
"reason": {
|
|
2258
|
+
"type": "string",
|
|
2259
|
+
"const": "oversize"
|
|
2260
|
+
},
|
|
2261
|
+
"bytes": {
|
|
2262
|
+
"type": "integer"
|
|
2263
|
+
}
|
|
2264
|
+
},
|
|
2265
|
+
"required": [
|
|
2266
|
+
"reason",
|
|
2267
|
+
"bytes"
|
|
2268
|
+
],
|
|
2269
|
+
"additionalProperties": false,
|
|
2270
|
+
"description": "Why an item's payload was left out: its size in bytes."
|
|
2271
|
+
},
|
|
2272
|
+
"IDeviceInboxPermissionItem": {
|
|
2273
|
+
"type": "object",
|
|
2274
|
+
"properties": {
|
|
2275
|
+
"id": {
|
|
2276
|
+
"type": "string",
|
|
2277
|
+
"description": "Stable across clients: the kind, where it lives and the request or question id."
|
|
2278
|
+
},
|
|
2279
|
+
"since": {
|
|
2280
|
+
"type": "integer",
|
|
2281
|
+
"description": "Unix milliseconds since it waits."
|
|
2282
|
+
},
|
|
2283
|
+
"title": {
|
|
2284
|
+
"type": "string",
|
|
2285
|
+
"description": "One line: what is asked."
|
|
2286
|
+
},
|
|
2287
|
+
"where": {
|
|
2288
|
+
"$ref": "#/components/schemas/TDeviceInboxWhere"
|
|
2289
|
+
},
|
|
2290
|
+
"answer": {
|
|
2291
|
+
"$ref": "#/components/schemas/TDeviceInboxAnswer"
|
|
2292
|
+
},
|
|
2293
|
+
"omitted": {
|
|
2294
|
+
"$ref": "#/components/schemas/IDeviceInboxOmission",
|
|
2295
|
+
"description": "Set when the payload was left out for its size: it is answered only where it lives."
|
|
2296
|
+
},
|
|
2297
|
+
"kind": {
|
|
2298
|
+
"type": "string",
|
|
2299
|
+
"const": "permission"
|
|
2300
|
+
},
|
|
2301
|
+
"permission": {
|
|
2302
|
+
"$ref": "#/components/schemas/IDevicePermission"
|
|
2303
|
+
}
|
|
2304
|
+
},
|
|
2305
|
+
"required": [
|
|
2306
|
+
"answer",
|
|
2307
|
+
"id",
|
|
2308
|
+
"kind",
|
|
2309
|
+
"since",
|
|
2310
|
+
"title",
|
|
2311
|
+
"where"
|
|
2312
|
+
],
|
|
2313
|
+
"additionalProperties": false
|
|
2314
|
+
},
|
|
2315
|
+
"IDeviceInboxQuestionItem": {
|
|
2316
|
+
"type": "object",
|
|
2317
|
+
"properties": {
|
|
2318
|
+
"id": {
|
|
2319
|
+
"type": "string",
|
|
2320
|
+
"description": "Stable across clients: the kind, where it lives and the request or question id."
|
|
2321
|
+
},
|
|
2322
|
+
"since": {
|
|
2323
|
+
"type": "integer",
|
|
2324
|
+
"description": "Unix milliseconds since it waits."
|
|
2325
|
+
},
|
|
2326
|
+
"title": {
|
|
2327
|
+
"type": "string",
|
|
2328
|
+
"description": "One line: what is asked."
|
|
2329
|
+
},
|
|
2330
|
+
"where": {
|
|
2331
|
+
"$ref": "#/components/schemas/TDeviceInboxWhere"
|
|
2332
|
+
},
|
|
2333
|
+
"answer": {
|
|
2334
|
+
"$ref": "#/components/schemas/TDeviceInboxAnswer"
|
|
2335
|
+
},
|
|
2336
|
+
"omitted": {
|
|
2337
|
+
"$ref": "#/components/schemas/IDeviceInboxOmission",
|
|
2338
|
+
"description": "Set when the payload was left out for its size: it is answered only where it lives."
|
|
2339
|
+
},
|
|
2340
|
+
"kind": {
|
|
2341
|
+
"type": "string",
|
|
2342
|
+
"const": "question"
|
|
2343
|
+
},
|
|
2344
|
+
"question": {
|
|
2345
|
+
"$ref": "#/components/schemas/IDeviceQuestion"
|
|
2346
|
+
}
|
|
2347
|
+
},
|
|
2348
|
+
"required": [
|
|
2349
|
+
"answer",
|
|
2350
|
+
"id",
|
|
2351
|
+
"kind",
|
|
2352
|
+
"since",
|
|
2353
|
+
"title",
|
|
2354
|
+
"where"
|
|
2355
|
+
],
|
|
2356
|
+
"additionalProperties": false
|
|
2357
|
+
},
|
|
2358
|
+
"IDeviceInboxTicketQuestionItem": {
|
|
2359
|
+
"type": "object",
|
|
2360
|
+
"properties": {
|
|
2361
|
+
"id": {
|
|
2362
|
+
"type": "string",
|
|
2363
|
+
"description": "Stable across clients: the kind, where it lives and the request or question id."
|
|
2364
|
+
},
|
|
2365
|
+
"since": {
|
|
2366
|
+
"type": "integer",
|
|
2367
|
+
"description": "Unix milliseconds since it waits."
|
|
2368
|
+
},
|
|
2369
|
+
"title": {
|
|
2370
|
+
"type": "string",
|
|
2371
|
+
"description": "One line: what is asked."
|
|
2372
|
+
},
|
|
2373
|
+
"where": {
|
|
2374
|
+
"$ref": "#/components/schemas/TDeviceInboxWhere"
|
|
2375
|
+
},
|
|
2376
|
+
"answer": {
|
|
2377
|
+
"$ref": "#/components/schemas/TDeviceInboxAnswer"
|
|
2378
|
+
},
|
|
2379
|
+
"omitted": {
|
|
2380
|
+
"$ref": "#/components/schemas/IDeviceInboxOmission",
|
|
2381
|
+
"description": "Set when the payload was left out for its size: it is answered only where it lives."
|
|
2382
|
+
},
|
|
2383
|
+
"kind": {
|
|
2384
|
+
"type": "string",
|
|
2385
|
+
"const": "ticket_question"
|
|
2386
|
+
},
|
|
2387
|
+
"question": {
|
|
2388
|
+
"$ref": "#/components/schemas/IDeviceTicketQuestion"
|
|
2389
|
+
}
|
|
2390
|
+
},
|
|
2391
|
+
"required": [
|
|
2392
|
+
"answer",
|
|
2393
|
+
"id",
|
|
2394
|
+
"kind",
|
|
2395
|
+
"since",
|
|
2396
|
+
"title",
|
|
2397
|
+
"where"
|
|
2398
|
+
],
|
|
2399
|
+
"additionalProperties": false
|
|
2400
|
+
},
|
|
2401
|
+
"IDeviceInboxWindowGoItem": {
|
|
2402
|
+
"type": "object",
|
|
2403
|
+
"properties": {
|
|
2404
|
+
"id": {
|
|
2405
|
+
"type": "string",
|
|
2406
|
+
"description": "Stable across clients: the kind, where it lives and the request or question id."
|
|
2407
|
+
},
|
|
2408
|
+
"since": {
|
|
2409
|
+
"type": "integer",
|
|
2410
|
+
"description": "Unix milliseconds since it waits."
|
|
2411
|
+
},
|
|
2412
|
+
"title": {
|
|
2413
|
+
"type": "string",
|
|
2414
|
+
"description": "One line: what is asked."
|
|
2415
|
+
},
|
|
2416
|
+
"where": {
|
|
2417
|
+
"$ref": "#/components/schemas/TDeviceInboxWhere"
|
|
2418
|
+
},
|
|
2419
|
+
"answer": {
|
|
2420
|
+
"$ref": "#/components/schemas/TDeviceInboxAnswer"
|
|
2421
|
+
},
|
|
2422
|
+
"omitted": {
|
|
2423
|
+
"$ref": "#/components/schemas/IDeviceInboxOmission",
|
|
2424
|
+
"description": "Set when the payload was left out for its size: it is answered only where it lives."
|
|
2425
|
+
},
|
|
2426
|
+
"kind": {
|
|
2427
|
+
"type": "string",
|
|
2428
|
+
"const": "window_go"
|
|
2429
|
+
},
|
|
2430
|
+
"question": {
|
|
2431
|
+
"$ref": "#/components/schemas/IDeviceTicketQuestion"
|
|
2432
|
+
},
|
|
2433
|
+
"window": {
|
|
2434
|
+
"$ref": "#/components/schemas/IDeviceWindowGo"
|
|
2435
|
+
}
|
|
2436
|
+
},
|
|
2437
|
+
"required": [
|
|
2438
|
+
"answer",
|
|
2439
|
+
"id",
|
|
2440
|
+
"kind",
|
|
2441
|
+
"since",
|
|
2442
|
+
"title",
|
|
2443
|
+
"where",
|
|
2444
|
+
"window"
|
|
2445
|
+
],
|
|
2446
|
+
"additionalProperties": false
|
|
2447
|
+
},
|
|
2448
|
+
"IDeviceMessage": {
|
|
2449
|
+
"type": "object",
|
|
2450
|
+
"properties": {
|
|
2451
|
+
"id": {
|
|
2452
|
+
"type": "string"
|
|
2453
|
+
},
|
|
2454
|
+
"role": {
|
|
2455
|
+
"$ref": "#/components/schemas/TDeviceMessageRole"
|
|
2456
|
+
},
|
|
2457
|
+
"createdAt": {
|
|
2458
|
+
"type": "integer"
|
|
2459
|
+
},
|
|
2460
|
+
"parts": {
|
|
2461
|
+
"type": "array",
|
|
2462
|
+
"items": {
|
|
2463
|
+
"$ref": "#/components/schemas/TDeviceMessagePart"
|
|
2464
|
+
}
|
|
2465
|
+
}
|
|
2466
|
+
},
|
|
2467
|
+
"required": [
|
|
2468
|
+
"id",
|
|
2469
|
+
"role",
|
|
2470
|
+
"createdAt",
|
|
2471
|
+
"parts"
|
|
2472
|
+
],
|
|
2473
|
+
"additionalProperties": false
|
|
2474
|
+
},
|
|
2475
|
+
"IDevicePermission": {
|
|
2476
|
+
"type": "object",
|
|
2477
|
+
"properties": {
|
|
2478
|
+
"id": {
|
|
2479
|
+
"type": "string"
|
|
2480
|
+
},
|
|
2481
|
+
"title": {
|
|
2482
|
+
"type": "string"
|
|
2483
|
+
},
|
|
2484
|
+
"type": {
|
|
2485
|
+
"type": "string"
|
|
2486
|
+
},
|
|
2487
|
+
"patterns": {
|
|
2488
|
+
"type": "array",
|
|
2489
|
+
"items": {
|
|
2490
|
+
"type": "string"
|
|
2491
|
+
}
|
|
2492
|
+
}
|
|
2493
|
+
},
|
|
2494
|
+
"required": [
|
|
2495
|
+
"id",
|
|
2496
|
+
"title",
|
|
2497
|
+
"type",
|
|
2498
|
+
"patterns"
|
|
2499
|
+
],
|
|
2500
|
+
"additionalProperties": false,
|
|
2501
|
+
"description": "A permission the session waits for."
|
|
2502
|
+
},
|
|
2503
|
+
"IDevicePool": {
|
|
2504
|
+
"type": "object",
|
|
2505
|
+
"properties": {
|
|
2506
|
+
"provider": {
|
|
2507
|
+
"$ref": "#/components/schemas/TDeviceAccountProvider"
|
|
2508
|
+
},
|
|
2509
|
+
"verdict": {
|
|
2510
|
+
"anyOf": [
|
|
2511
|
+
{
|
|
2512
|
+
"$ref": "#/components/schemas/IDevicePoolOpen"
|
|
2513
|
+
},
|
|
2514
|
+
{
|
|
2515
|
+
"$ref": "#/components/schemas/IDevicePoolWait"
|
|
2516
|
+
}
|
|
2517
|
+
]
|
|
2518
|
+
},
|
|
2519
|
+
"room": {
|
|
2520
|
+
"type": "number"
|
|
2521
|
+
},
|
|
2522
|
+
"members": {
|
|
2523
|
+
"type": "array",
|
|
2524
|
+
"items": {
|
|
2525
|
+
"$ref": "#/components/schemas/IDevicePoolMember"
|
|
2526
|
+
}
|
|
2527
|
+
}
|
|
2528
|
+
},
|
|
2529
|
+
"required": [
|
|
2530
|
+
"provider",
|
|
2531
|
+
"verdict",
|
|
2532
|
+
"room",
|
|
2533
|
+
"members"
|
|
2534
|
+
],
|
|
2535
|
+
"additionalProperties": false,
|
|
2536
|
+
"description": "An account pool of the host's inference proxy: its verdict, its room (the headroom of its accounts summed, in percent) and its accounts, by plan and then the most used first. Since protocol 1.3."
|
|
2537
|
+
},
|
|
2538
|
+
"IDevicePoolMember": {
|
|
2539
|
+
"type": "object",
|
|
2540
|
+
"properties": {
|
|
2541
|
+
"plan": {
|
|
2542
|
+
"type": "string"
|
|
2543
|
+
},
|
|
2544
|
+
"state": {
|
|
2545
|
+
"$ref": "#/components/schemas/TDevicePoolMemberState"
|
|
2546
|
+
},
|
|
2547
|
+
"window": {
|
|
2548
|
+
"$ref": "#/components/schemas/IDevicePoolWindow",
|
|
2549
|
+
"description": "Absent without a usable reading."
|
|
2550
|
+
}
|
|
2551
|
+
},
|
|
2552
|
+
"required": [
|
|
2553
|
+
"plan",
|
|
2554
|
+
"state"
|
|
2555
|
+
],
|
|
2556
|
+
"additionalProperties": false,
|
|
2557
|
+
"description": "One account of a pool, without anything that names it. Since protocol 1.3."
|
|
2558
|
+
},
|
|
2559
|
+
"IDevicePoolOpen": {
|
|
2560
|
+
"type": "object",
|
|
2561
|
+
"properties": {
|
|
2562
|
+
"state": {
|
|
2563
|
+
"type": "string",
|
|
2564
|
+
"const": "open"
|
|
2565
|
+
}
|
|
2566
|
+
},
|
|
2567
|
+
"required": [
|
|
2568
|
+
"state"
|
|
2569
|
+
],
|
|
2570
|
+
"additionalProperties": false,
|
|
2571
|
+
"description": "A pool takes new work now. Since protocol 1.3."
|
|
2572
|
+
},
|
|
2573
|
+
"IDevicePoolWait": {
|
|
2574
|
+
"type": "object",
|
|
2575
|
+
"properties": {
|
|
2576
|
+
"state": {
|
|
2577
|
+
"type": "string",
|
|
2578
|
+
"const": "wait"
|
|
2579
|
+
},
|
|
2580
|
+
"reason": {
|
|
2581
|
+
"type": "string",
|
|
2582
|
+
"enum": [
|
|
2583
|
+
"room",
|
|
2584
|
+
"provider-429",
|
|
2585
|
+
"quiet-unobserved"
|
|
2586
|
+
]
|
|
2587
|
+
},
|
|
2588
|
+
"until": {
|
|
2589
|
+
"type": "integer",
|
|
2590
|
+
"description": "Unix milliseconds it takes new work again; absent when its accounts' readings foresee no such moment."
|
|
2591
|
+
}
|
|
2592
|
+
},
|
|
2593
|
+
"required": [
|
|
2594
|
+
"state",
|
|
2595
|
+
"reason"
|
|
2596
|
+
],
|
|
2597
|
+
"additionalProperties": false,
|
|
2598
|
+
"description": "A pool waits: for too little room, a provider 429 within the quiet period, or a proxy that has not observed it long enough. Since protocol 1.3."
|
|
2599
|
+
},
|
|
2600
|
+
"IDevicePoolWindow": {
|
|
2601
|
+
"type": "object",
|
|
2602
|
+
"properties": {
|
|
2603
|
+
"name": {
|
|
2604
|
+
"type": "string",
|
|
2605
|
+
"description": "The provider's name for the window, or its length (`5h`, `7d`)."
|
|
2606
|
+
},
|
|
2607
|
+
"usedPercent": {
|
|
2608
|
+
"type": "number"
|
|
2609
|
+
},
|
|
2610
|
+
"estimated": {
|
|
2611
|
+
"type": "boolean",
|
|
2612
|
+
"description": "Whether `usedPercent` is the accounts service's estimate between its reads."
|
|
2613
|
+
},
|
|
2614
|
+
"resetAt": {
|
|
2615
|
+
"type": "integer",
|
|
2616
|
+
"description": "Unix milliseconds its current period ends; absent when the reading states none."
|
|
2617
|
+
}
|
|
2618
|
+
},
|
|
2619
|
+
"required": [
|
|
2620
|
+
"name",
|
|
2621
|
+
"usedPercent",
|
|
2622
|
+
"estimated"
|
|
2623
|
+
],
|
|
2624
|
+
"additionalProperties": false,
|
|
2625
|
+
"description": "The usage window an account's room is bound by, as its last reading states it. Since protocol 1.3."
|
|
2626
|
+
},
|
|
2627
|
+
"IDeviceQuestion": {
|
|
2628
|
+
"type": "object",
|
|
2629
|
+
"properties": {
|
|
2630
|
+
"id": {
|
|
2631
|
+
"type": "string"
|
|
2632
|
+
},
|
|
2633
|
+
"questions": {
|
|
2634
|
+
"type": "array",
|
|
2635
|
+
"items": {
|
|
2636
|
+
"$ref": "#/components/schemas/IDeviceQuestionItem"
|
|
2637
|
+
}
|
|
2638
|
+
}
|
|
2639
|
+
},
|
|
2640
|
+
"required": [
|
|
2641
|
+
"id",
|
|
2642
|
+
"questions"
|
|
2643
|
+
],
|
|
2644
|
+
"additionalProperties": false,
|
|
2645
|
+
"description": "A question the session waits for; it is never answered automatically."
|
|
2646
|
+
},
|
|
2647
|
+
"IDeviceQuestionItem": {
|
|
2648
|
+
"type": "object",
|
|
2649
|
+
"properties": {
|
|
2650
|
+
"question": {
|
|
2651
|
+
"type": "string"
|
|
2652
|
+
},
|
|
2653
|
+
"header": {
|
|
2654
|
+
"type": "string"
|
|
2655
|
+
},
|
|
2656
|
+
"options": {
|
|
2657
|
+
"type": "array",
|
|
2658
|
+
"items": {
|
|
2659
|
+
"$ref": "#/components/schemas/IDeviceQuestionOption"
|
|
2660
|
+
}
|
|
2661
|
+
},
|
|
2662
|
+
"multiple": {
|
|
2663
|
+
"type": "boolean"
|
|
2664
|
+
},
|
|
2665
|
+
"custom": {
|
|
2666
|
+
"type": "boolean",
|
|
2667
|
+
"description": "A free-text answer is accepted besides the options."
|
|
2668
|
+
}
|
|
2669
|
+
},
|
|
2670
|
+
"required": [
|
|
2671
|
+
"question",
|
|
2672
|
+
"header",
|
|
2673
|
+
"options"
|
|
2674
|
+
],
|
|
2675
|
+
"additionalProperties": false
|
|
2676
|
+
},
|
|
2677
|
+
"IDeviceQuestionOption": {
|
|
2678
|
+
"type": "object",
|
|
2679
|
+
"properties": {
|
|
2680
|
+
"label": {
|
|
2681
|
+
"type": "string"
|
|
2682
|
+
},
|
|
2683
|
+
"description": {
|
|
2684
|
+
"type": "string"
|
|
2685
|
+
}
|
|
2686
|
+
},
|
|
2687
|
+
"required": [
|
|
2688
|
+
"label",
|
|
2689
|
+
"description"
|
|
2690
|
+
],
|
|
2691
|
+
"additionalProperties": false
|
|
2692
|
+
},
|
|
2693
|
+
"IDeviceReasoningPart": {
|
|
2694
|
+
"type": "object",
|
|
2695
|
+
"properties": {
|
|
2696
|
+
"type": {
|
|
2697
|
+
"type": "string",
|
|
2698
|
+
"const": "reasoning"
|
|
2699
|
+
},
|
|
2700
|
+
"id": {
|
|
2701
|
+
"type": "string"
|
|
2702
|
+
},
|
|
2703
|
+
"text": {
|
|
2704
|
+
"type": "string"
|
|
2705
|
+
}
|
|
2706
|
+
},
|
|
2707
|
+
"required": [
|
|
2708
|
+
"type",
|
|
2709
|
+
"id",
|
|
2710
|
+
"text"
|
|
2711
|
+
],
|
|
2712
|
+
"additionalProperties": false
|
|
2713
|
+
},
|
|
2714
|
+
"IDeviceReportWorker": {
|
|
2715
|
+
"type": "object",
|
|
2716
|
+
"properties": {
|
|
451
2717
|
"name": {
|
|
452
2718
|
"type": "string"
|
|
453
2719
|
},
|
|
454
|
-
"
|
|
455
|
-
"
|
|
456
|
-
},
|
|
457
|
-
"description": {
|
|
458
|
-
"type": "string"
|
|
2720
|
+
"harness": {
|
|
2721
|
+
"$ref": "#/components/schemas/TDeviceDirectReportHarness"
|
|
459
2722
|
},
|
|
460
|
-
"
|
|
461
|
-
"
|
|
2723
|
+
"status": {
|
|
2724
|
+
"$ref": "#/components/schemas/TDeviceReportWorkerStatus",
|
|
2725
|
+
"description": "Absent until AGL observed the worker."
|
|
462
2726
|
},
|
|
463
|
-
"
|
|
464
|
-
"type": "
|
|
2727
|
+
"ticketKey": {
|
|
2728
|
+
"type": "string",
|
|
2729
|
+
"description": "The ticket the worker is bound to."
|
|
465
2730
|
}
|
|
466
2731
|
},
|
|
467
2732
|
"required": [
|
|
468
|
-
"kind",
|
|
469
2733
|
"name",
|
|
470
|
-
"
|
|
2734
|
+
"harness"
|
|
471
2735
|
],
|
|
472
2736
|
"additionalProperties": false,
|
|
473
|
-
"description": "A
|
|
2737
|
+
"description": "A fleet worker that a direct report started or adopted, which reports to it. Since protocol 1.3."
|
|
474
2738
|
},
|
|
475
|
-
"
|
|
2739
|
+
"IDeviceSessionChangedEvent": {
|
|
476
2740
|
"type": "object",
|
|
477
2741
|
"properties": {
|
|
478
|
-
"
|
|
2742
|
+
"type": {
|
|
479
2743
|
"type": "string",
|
|
480
|
-
"const": "
|
|
481
|
-
},
|
|
482
|
-
"name": {
|
|
483
|
-
"type": "string"
|
|
484
|
-
},
|
|
485
|
-
"title": {
|
|
486
|
-
"type": "string"
|
|
487
|
-
},
|
|
488
|
-
"description": {
|
|
489
|
-
"type": "string"
|
|
490
|
-
},
|
|
491
|
-
"required": {
|
|
492
|
-
"type": "boolean"
|
|
493
|
-
},
|
|
494
|
-
"options": {
|
|
495
|
-
"type": "array",
|
|
496
|
-
"items": {
|
|
497
|
-
"$ref": "#/components/schemas/IDeviceElicitationOption"
|
|
498
|
-
}
|
|
2744
|
+
"const": "session.changed"
|
|
499
2745
|
},
|
|
500
|
-
"
|
|
2746
|
+
"sessionId": {
|
|
501
2747
|
"type": "string"
|
|
502
2748
|
}
|
|
503
2749
|
},
|
|
504
2750
|
"required": [
|
|
505
|
-
"
|
|
506
|
-
"
|
|
507
|
-
"required",
|
|
508
|
-
"options"
|
|
2751
|
+
"type",
|
|
2752
|
+
"sessionId"
|
|
509
2753
|
],
|
|
510
2754
|
"additionalProperties": false,
|
|
511
|
-
"description": "
|
|
2755
|
+
"description": "The session's transcript, state or pending prompts changed: read it again."
|
|
512
2756
|
},
|
|
513
|
-
"
|
|
2757
|
+
"IDeviceSessionFeedChangedEvent": {
|
|
514
2758
|
"type": "object",
|
|
515
2759
|
"properties": {
|
|
516
|
-
"
|
|
2760
|
+
"type": {
|
|
517
2761
|
"type": "string",
|
|
518
|
-
"const": "
|
|
519
|
-
},
|
|
520
|
-
"name": {
|
|
521
|
-
"type": "string"
|
|
2762
|
+
"const": "sessionfeed.changed"
|
|
522
2763
|
},
|
|
523
|
-
"
|
|
2764
|
+
"delta": {
|
|
2765
|
+
"$ref": "#/components/schemas/IDeviceSessionFeedDelta"
|
|
2766
|
+
}
|
|
2767
|
+
},
|
|
2768
|
+
"required": [
|
|
2769
|
+
"type",
|
|
2770
|
+
"delta"
|
|
2771
|
+
],
|
|
2772
|
+
"additionalProperties": false
|
|
2773
|
+
},
|
|
2774
|
+
"IDeviceSessionFeedDelta": {
|
|
2775
|
+
"type": "object",
|
|
2776
|
+
"properties": {
|
|
2777
|
+
"epoch": {
|
|
524
2778
|
"type": "string"
|
|
525
2779
|
},
|
|
526
|
-
"
|
|
527
|
-
"type": "
|
|
2780
|
+
"revision": {
|
|
2781
|
+
"type": "integer"
|
|
528
2782
|
},
|
|
529
|
-
"
|
|
2783
|
+
"reset": {
|
|
530
2784
|
"type": "boolean"
|
|
531
2785
|
},
|
|
532
|
-
"
|
|
2786
|
+
"upserts": {
|
|
533
2787
|
"type": "array",
|
|
534
2788
|
"items": {
|
|
535
|
-
"$ref": "#/components/schemas/
|
|
2789
|
+
"$ref": "#/components/schemas/IDeviceSessionRow"
|
|
536
2790
|
}
|
|
537
2791
|
},
|
|
538
|
-
"
|
|
539
|
-
"type": "integer"
|
|
540
|
-
},
|
|
541
|
-
"maxItems": {
|
|
542
|
-
"type": "integer"
|
|
543
|
-
},
|
|
544
|
-
"default": {
|
|
2792
|
+
"removed": {
|
|
545
2793
|
"type": "array",
|
|
546
2794
|
"items": {
|
|
547
2795
|
"type": "string"
|
|
@@ -549,626 +2797,936 @@
|
|
|
549
2797
|
}
|
|
550
2798
|
},
|
|
551
2799
|
"required": [
|
|
552
|
-
"
|
|
553
|
-
"
|
|
554
|
-
"
|
|
555
|
-
"
|
|
2800
|
+
"epoch",
|
|
2801
|
+
"revision",
|
|
2802
|
+
"reset",
|
|
2803
|
+
"upserts",
|
|
2804
|
+
"removed"
|
|
556
2805
|
],
|
|
557
2806
|
"additionalProperties": false,
|
|
558
|
-
"description": "
|
|
2807
|
+
"description": "A feed change: apply it on the same epoch at the revision after the held one; on `reset` or any gap, list again."
|
|
559
2808
|
},
|
|
560
|
-
"
|
|
2809
|
+
"IDeviceSessionRow": {
|
|
561
2810
|
"type": "object",
|
|
562
2811
|
"properties": {
|
|
563
|
-
"
|
|
2812
|
+
"id": {
|
|
564
2813
|
"type": "string",
|
|
565
|
-
"
|
|
2814
|
+
"description": "`${harness}:${nativeId}`, the feed's row id; the device names a session only by it."
|
|
566
2815
|
},
|
|
567
|
-
"
|
|
568
|
-
"
|
|
2816
|
+
"harness": {
|
|
2817
|
+
"$ref": "#/components/schemas/TDeviceHarness"
|
|
569
2818
|
},
|
|
570
|
-
"
|
|
571
|
-
"
|
|
2819
|
+
"state": {
|
|
2820
|
+
"$ref": "#/components/schemas/TDeviceSessionState"
|
|
572
2821
|
},
|
|
573
|
-
"
|
|
2822
|
+
"name": {
|
|
574
2823
|
"type": "string"
|
|
575
2824
|
},
|
|
576
|
-
"
|
|
577
|
-
"type": "
|
|
578
|
-
"
|
|
579
|
-
"$ref": "#/components/schemas/TDeviceElicitationField"
|
|
580
|
-
}
|
|
2825
|
+
"excerpt": {
|
|
2826
|
+
"type": "string",
|
|
2827
|
+
"description": "The tail of the newest assistant text."
|
|
581
2828
|
},
|
|
582
|
-
"
|
|
583
|
-
"type": "integer"
|
|
2829
|
+
"updatedAt": {
|
|
2830
|
+
"type": "integer",
|
|
2831
|
+
"description": "Unix milliseconds of the session's last activity."
|
|
584
2832
|
}
|
|
585
2833
|
},
|
|
586
2834
|
"required": [
|
|
587
|
-
"mode",
|
|
588
2835
|
"id",
|
|
589
|
-
"
|
|
590
|
-
"
|
|
591
|
-
"
|
|
592
|
-
"
|
|
2836
|
+
"harness",
|
|
2837
|
+
"state",
|
|
2838
|
+
"name",
|
|
2839
|
+
"updatedAt"
|
|
593
2840
|
],
|
|
594
2841
|
"additionalProperties": false,
|
|
595
|
-
"description": "
|
|
2842
|
+
"description": "One session of the feed as a device sees it: the browser feed row without where it opens (no host paths, no tickets)."
|
|
596
2843
|
},
|
|
597
|
-
"
|
|
2844
|
+
"IDeviceSessionTextDeltaEvent": {
|
|
598
2845
|
"type": "object",
|
|
599
2846
|
"properties": {
|
|
600
|
-
"
|
|
2847
|
+
"type": {
|
|
601
2848
|
"type": "string",
|
|
602
|
-
"const": "
|
|
2849
|
+
"const": "session.text.delta"
|
|
603
2850
|
},
|
|
604
|
-
"
|
|
2851
|
+
"delta": {
|
|
2852
|
+
"$ref": "#/components/schemas/IDeviceTextDelta"
|
|
2853
|
+
}
|
|
2854
|
+
},
|
|
2855
|
+
"required": [
|
|
2856
|
+
"type",
|
|
2857
|
+
"delta"
|
|
2858
|
+
],
|
|
2859
|
+
"additionalProperties": false
|
|
2860
|
+
},
|
|
2861
|
+
"IDeviceSessionTextUpdatedEvent": {
|
|
2862
|
+
"type": "object",
|
|
2863
|
+
"properties": {
|
|
2864
|
+
"type": {
|
|
2865
|
+
"type": "string",
|
|
2866
|
+
"const": "session.text.updated"
|
|
2867
|
+
},
|
|
2868
|
+
"update": {
|
|
2869
|
+
"$ref": "#/components/schemas/IDeviceTextUpdate"
|
|
2870
|
+
}
|
|
2871
|
+
},
|
|
2872
|
+
"required": [
|
|
2873
|
+
"type",
|
|
2874
|
+
"update"
|
|
2875
|
+
],
|
|
2876
|
+
"additionalProperties": false
|
|
2877
|
+
},
|
|
2878
|
+
"IDeviceSessionsChangedEvent": {
|
|
2879
|
+
"type": "object",
|
|
2880
|
+
"properties": {
|
|
2881
|
+
"type": {
|
|
2882
|
+
"type": "string",
|
|
2883
|
+
"const": "sessions.changed"
|
|
2884
|
+
}
|
|
2885
|
+
},
|
|
2886
|
+
"required": [
|
|
2887
|
+
"type"
|
|
2888
|
+
],
|
|
2889
|
+
"additionalProperties": false,
|
|
2890
|
+
"description": "Changes reached this device only in part: list the feed and read the open session again."
|
|
2891
|
+
},
|
|
2892
|
+
"IDeviceTextDelta": {
|
|
2893
|
+
"type": "object",
|
|
2894
|
+
"properties": {
|
|
2895
|
+
"sessionId": {
|
|
605
2896
|
"type": "string"
|
|
606
2897
|
},
|
|
607
|
-
"
|
|
2898
|
+
"messageId": {
|
|
608
2899
|
"type": "string"
|
|
609
2900
|
},
|
|
610
|
-
"
|
|
2901
|
+
"partId": {
|
|
611
2902
|
"type": "string"
|
|
612
2903
|
},
|
|
613
|
-
"
|
|
614
|
-
"type": "
|
|
2904
|
+
"delta": {
|
|
2905
|
+
"type": "string"
|
|
615
2906
|
},
|
|
616
|
-
"
|
|
617
|
-
"type": "
|
|
2907
|
+
"baseTextUtf8Bytes": {
|
|
2908
|
+
"type": "integer"
|
|
618
2909
|
},
|
|
619
|
-
"
|
|
620
|
-
"type": "
|
|
2910
|
+
"textUtf8Bytes": {
|
|
2911
|
+
"type": "integer"
|
|
2912
|
+
}
|
|
2913
|
+
},
|
|
2914
|
+
"required": [
|
|
2915
|
+
"sessionId",
|
|
2916
|
+
"messageId",
|
|
2917
|
+
"partId",
|
|
2918
|
+
"delta",
|
|
2919
|
+
"baseTextUtf8Bytes",
|
|
2920
|
+
"textUtf8Bytes"
|
|
2921
|
+
],
|
|
2922
|
+
"additionalProperties": false,
|
|
2923
|
+
"description": "Text appended to an assistant text part while it streams. Apply it only when the part's text held now is `baseTextUtf8Bytes` long in UTF-8, which makes it `textUtf8Bytes` long; otherwise read the session again."
|
|
2924
|
+
},
|
|
2925
|
+
"IDeviceTextPart": {
|
|
2926
|
+
"type": "object",
|
|
2927
|
+
"properties": {
|
|
2928
|
+
"type": {
|
|
2929
|
+
"type": "string",
|
|
2930
|
+
"const": "text"
|
|
621
2931
|
},
|
|
622
|
-
"
|
|
623
|
-
"type": "
|
|
2932
|
+
"id": {
|
|
2933
|
+
"type": "string"
|
|
624
2934
|
},
|
|
625
|
-
"
|
|
626
|
-
"type": "
|
|
2935
|
+
"text": {
|
|
2936
|
+
"type": "string"
|
|
627
2937
|
}
|
|
628
2938
|
},
|
|
629
2939
|
"required": [
|
|
630
|
-
"
|
|
631
|
-
"
|
|
632
|
-
"
|
|
633
|
-
"integer"
|
|
2940
|
+
"type",
|
|
2941
|
+
"id",
|
|
2942
|
+
"text"
|
|
634
2943
|
],
|
|
635
|
-
"additionalProperties": false
|
|
636
|
-
"description": "A number field; `integer` takes whole numbers only, the bounds are inclusive."
|
|
2944
|
+
"additionalProperties": false
|
|
637
2945
|
},
|
|
638
|
-
"
|
|
2946
|
+
"IDeviceTextUpdate": {
|
|
639
2947
|
"type": "object",
|
|
640
2948
|
"properties": {
|
|
641
|
-
"
|
|
2949
|
+
"sessionId": {
|
|
642
2950
|
"type": "string"
|
|
643
2951
|
},
|
|
644
|
-
"
|
|
2952
|
+
"messageId": {
|
|
2953
|
+
"type": "string"
|
|
2954
|
+
},
|
|
2955
|
+
"partId": {
|
|
2956
|
+
"type": "string"
|
|
2957
|
+
},
|
|
2958
|
+
"text": {
|
|
645
2959
|
"type": "string"
|
|
646
2960
|
}
|
|
647
2961
|
},
|
|
648
2962
|
"required": [
|
|
649
|
-
"
|
|
650
|
-
"
|
|
2963
|
+
"sessionId",
|
|
2964
|
+
"messageId",
|
|
2965
|
+
"partId",
|
|
2966
|
+
"text"
|
|
651
2967
|
],
|
|
652
2968
|
"additionalProperties": false,
|
|
653
|
-
"description": "
|
|
2969
|
+
"description": "A live snapshot of an assistant text part while it streams: it replaces the part's text."
|
|
654
2970
|
},
|
|
655
|
-
"
|
|
2971
|
+
"IDeviceTicket": {
|
|
656
2972
|
"type": "object",
|
|
657
2973
|
"properties": {
|
|
658
|
-
"
|
|
659
|
-
"type": "string"
|
|
660
|
-
"const": "text"
|
|
661
|
-
},
|
|
662
|
-
"name": {
|
|
663
|
-
"type": "string",
|
|
664
|
-
"description": "The name the answer carries the value under."
|
|
2974
|
+
"key": {
|
|
2975
|
+
"type": "string"
|
|
665
2976
|
},
|
|
666
2977
|
"title": {
|
|
667
2978
|
"type": "string"
|
|
668
2979
|
},
|
|
669
|
-
"
|
|
2980
|
+
"kind": {
|
|
2981
|
+
"$ref": "#/components/schemas/TDeviceTicketKind"
|
|
2982
|
+
},
|
|
2983
|
+
"project": {
|
|
670
2984
|
"type": "string"
|
|
671
2985
|
},
|
|
672
|
-
"
|
|
673
|
-
"
|
|
2986
|
+
"column": {
|
|
2987
|
+
"$ref": "#/components/schemas/TDeviceTicketColumn"
|
|
674
2988
|
},
|
|
675
|
-
"
|
|
676
|
-
"
|
|
677
|
-
"enum": [
|
|
678
|
-
"email",
|
|
679
|
-
"uri",
|
|
680
|
-
"date",
|
|
681
|
-
"date-time"
|
|
682
|
-
]
|
|
2989
|
+
"priority": {
|
|
2990
|
+
"$ref": "#/components/schemas/TDeviceTicketPriority"
|
|
683
2991
|
},
|
|
684
|
-
"
|
|
685
|
-
"
|
|
2992
|
+
"assignee": {
|
|
2993
|
+
"$ref": "#/components/schemas/IDeviceTicketPerson"
|
|
686
2994
|
},
|
|
687
|
-
"
|
|
2995
|
+
"labels": {
|
|
2996
|
+
"type": "array",
|
|
2997
|
+
"items": {
|
|
2998
|
+
"type": "string"
|
|
2999
|
+
}
|
|
3000
|
+
},
|
|
3001
|
+
"autoLabels": {
|
|
3002
|
+
"type": "array",
|
|
3003
|
+
"items": {
|
|
3004
|
+
"$ref": "#/components/schemas/TDeviceTicketAutoLabel"
|
|
3005
|
+
}
|
|
3006
|
+
},
|
|
3007
|
+
"epic": {
|
|
3008
|
+
"$ref": "#/components/schemas/IDeviceTicketRef",
|
|
3009
|
+
"description": "The epic a task belongs to."
|
|
3010
|
+
},
|
|
3011
|
+
"updatedAt": {
|
|
688
3012
|
"type": "integer"
|
|
689
3013
|
},
|
|
690
|
-
"
|
|
691
|
-
"type": "string"
|
|
692
|
-
}
|
|
693
|
-
},
|
|
694
|
-
"required": [
|
|
695
|
-
"kind",
|
|
696
|
-
"name",
|
|
697
|
-
"required"
|
|
698
|
-
],
|
|
699
|
-
"additionalProperties": false,
|
|
700
|
-
"description": "A text field; a value is checked against `format` (`email`, `uri`, `date`, `date-time`) and the lengths in characters."
|
|
701
|
-
},
|
|
702
|
-
"IDeviceElicitationUnsupported": {
|
|
703
|
-
"type": "object",
|
|
704
|
-
"properties": {
|
|
705
|
-
"mode": {
|
|
3014
|
+
"description": {
|
|
706
3015
|
"type": "string",
|
|
707
|
-
"
|
|
3016
|
+
"description": "Markdown."
|
|
708
3017
|
},
|
|
709
|
-
"
|
|
710
|
-
"
|
|
3018
|
+
"source": {
|
|
3019
|
+
"$ref": "#/components/schemas/IDeviceTicketSource"
|
|
711
3020
|
},
|
|
712
|
-
"
|
|
713
|
-
"type": "
|
|
3021
|
+
"links": {
|
|
3022
|
+
"type": "array",
|
|
3023
|
+
"items": {
|
|
3024
|
+
"$ref": "#/components/schemas/TDeviceTicketLink"
|
|
3025
|
+
}
|
|
714
3026
|
},
|
|
715
|
-
"
|
|
716
|
-
"
|
|
3027
|
+
"parent": {
|
|
3028
|
+
"$ref": "#/components/schemas/IDeviceTicketRef",
|
|
3029
|
+
"description": "The epic of a task, the task of a subtask."
|
|
717
3030
|
},
|
|
718
|
-
"
|
|
719
|
-
"type": "
|
|
3031
|
+
"revision": {
|
|
3032
|
+
"type": "integer",
|
|
3033
|
+
"description": "Moves with every change of the ticket, its comments and its questions."
|
|
720
3034
|
},
|
|
721
3035
|
"createdAt": {
|
|
722
3036
|
"type": "integer"
|
|
723
3037
|
}
|
|
724
3038
|
},
|
|
725
3039
|
"required": [
|
|
726
|
-
"
|
|
727
|
-
"
|
|
728
|
-
"
|
|
729
|
-
"
|
|
730
|
-
"
|
|
731
|
-
"
|
|
3040
|
+
"autoLabels",
|
|
3041
|
+
"column",
|
|
3042
|
+
"createdAt",
|
|
3043
|
+
"description",
|
|
3044
|
+
"key",
|
|
3045
|
+
"kind",
|
|
3046
|
+
"labels",
|
|
3047
|
+
"links",
|
|
3048
|
+
"priority",
|
|
3049
|
+
"project",
|
|
3050
|
+
"revision",
|
|
3051
|
+
"source",
|
|
3052
|
+
"title",
|
|
3053
|
+
"updatedAt"
|
|
732
3054
|
],
|
|
733
3055
|
"additionalProperties": false,
|
|
734
|
-
"description": "
|
|
3056
|
+
"description": "A ticket as its detail shows it: the card, its description, where it came from and its evidence. Since protocol 1.3."
|
|
735
3057
|
},
|
|
736
|
-
"
|
|
3058
|
+
"IDeviceTicketCard": {
|
|
737
3059
|
"type": "object",
|
|
738
3060
|
"properties": {
|
|
739
|
-
"
|
|
740
|
-
"type": "string",
|
|
741
|
-
"const": "url"
|
|
742
|
-
},
|
|
743
|
-
"id": {
|
|
3061
|
+
"key": {
|
|
744
3062
|
"type": "string"
|
|
745
3063
|
},
|
|
746
|
-
"
|
|
3064
|
+
"title": {
|
|
747
3065
|
"type": "string"
|
|
748
3066
|
},
|
|
749
|
-
"
|
|
750
|
-
"
|
|
3067
|
+
"kind": {
|
|
3068
|
+
"$ref": "#/components/schemas/TDeviceTicketKind"
|
|
751
3069
|
},
|
|
752
|
-
"
|
|
3070
|
+
"project": {
|
|
753
3071
|
"type": "string"
|
|
754
3072
|
},
|
|
755
|
-
"
|
|
3073
|
+
"column": {
|
|
3074
|
+
"$ref": "#/components/schemas/TDeviceTicketColumn"
|
|
3075
|
+
},
|
|
3076
|
+
"priority": {
|
|
3077
|
+
"$ref": "#/components/schemas/TDeviceTicketPriority"
|
|
3078
|
+
},
|
|
3079
|
+
"assignee": {
|
|
3080
|
+
"$ref": "#/components/schemas/IDeviceTicketPerson"
|
|
3081
|
+
},
|
|
3082
|
+
"labels": {
|
|
3083
|
+
"type": "array",
|
|
3084
|
+
"items": {
|
|
3085
|
+
"type": "string"
|
|
3086
|
+
}
|
|
3087
|
+
},
|
|
3088
|
+
"autoLabels": {
|
|
3089
|
+
"type": "array",
|
|
3090
|
+
"items": {
|
|
3091
|
+
"$ref": "#/components/schemas/TDeviceTicketAutoLabel"
|
|
3092
|
+
}
|
|
3093
|
+
},
|
|
3094
|
+
"epic": {
|
|
3095
|
+
"$ref": "#/components/schemas/IDeviceTicketRef",
|
|
3096
|
+
"description": "The epic a task belongs to."
|
|
3097
|
+
},
|
|
3098
|
+
"updatedAt": {
|
|
756
3099
|
"type": "integer"
|
|
757
3100
|
}
|
|
758
3101
|
},
|
|
759
3102
|
"required": [
|
|
760
|
-
"
|
|
761
|
-
"
|
|
762
|
-
"
|
|
763
|
-
"
|
|
764
|
-
"
|
|
765
|
-
"
|
|
3103
|
+
"key",
|
|
3104
|
+
"title",
|
|
3105
|
+
"kind",
|
|
3106
|
+
"project",
|
|
3107
|
+
"column",
|
|
3108
|
+
"priority",
|
|
3109
|
+
"labels",
|
|
3110
|
+
"autoLabels",
|
|
3111
|
+
"updatedAt"
|
|
766
3112
|
],
|
|
767
3113
|
"additionalProperties": false,
|
|
768
|
-
"description": "
|
|
3114
|
+
"description": "A ticket as the board's card shows it. Since protocol 1.3."
|
|
769
3115
|
},
|
|
770
|
-
"
|
|
3116
|
+
"IDeviceTicketComment": {
|
|
771
3117
|
"type": "object",
|
|
772
3118
|
"properties": {
|
|
773
3119
|
"id": {
|
|
774
3120
|
"type": "string"
|
|
775
3121
|
},
|
|
776
|
-
"
|
|
777
|
-
"$ref": "#/components/schemas/
|
|
3122
|
+
"author": {
|
|
3123
|
+
"$ref": "#/components/schemas/IDeviceTicketPerson"
|
|
778
3124
|
},
|
|
779
3125
|
"createdAt": {
|
|
780
3126
|
"type": "integer"
|
|
781
3127
|
},
|
|
782
|
-
"
|
|
3128
|
+
"body": {
|
|
783
3129
|
"type": "array",
|
|
784
3130
|
"items": {
|
|
785
|
-
"$ref": "#/components/schemas/
|
|
3131
|
+
"$ref": "#/components/schemas/TDeviceTicketCommentPart"
|
|
786
3132
|
}
|
|
787
3133
|
}
|
|
788
3134
|
},
|
|
789
3135
|
"required": [
|
|
790
3136
|
"id",
|
|
791
|
-
"
|
|
3137
|
+
"author",
|
|
792
3138
|
"createdAt",
|
|
793
|
-
"
|
|
3139
|
+
"body"
|
|
794
3140
|
],
|
|
795
|
-
"additionalProperties": false
|
|
3141
|
+
"additionalProperties": false,
|
|
3142
|
+
"description": "A comment in a ticket's discussion. Since protocol 1.3."
|
|
796
3143
|
},
|
|
797
|
-
"
|
|
3144
|
+
"IDeviceTicketDeploy": {
|
|
798
3145
|
"type": "object",
|
|
799
3146
|
"properties": {
|
|
800
|
-
"
|
|
3147
|
+
"target": {
|
|
801
3148
|
"type": "string"
|
|
802
3149
|
},
|
|
803
|
-
"
|
|
3150
|
+
"version": {
|
|
804
3151
|
"type": "string"
|
|
805
3152
|
},
|
|
806
|
-
"
|
|
3153
|
+
"targetName": {
|
|
3154
|
+
"type": "string",
|
|
3155
|
+
"description": "What the deploy monitor reads besides: absent while it cannot be read and once the ticket is done."
|
|
3156
|
+
},
|
|
3157
|
+
"environment": {
|
|
807
3158
|
"type": "string"
|
|
808
3159
|
},
|
|
809
|
-
"
|
|
810
|
-
"
|
|
811
|
-
|
|
812
|
-
|
|
813
|
-
|
|
3160
|
+
"go": {
|
|
3161
|
+
"$ref": "#/components/schemas/TDeviceDeployPlanGo"
|
|
3162
|
+
},
|
|
3163
|
+
"deployWhen": {
|
|
3164
|
+
"type": "string",
|
|
3165
|
+
"enum": [
|
|
3166
|
+
"anytime",
|
|
3167
|
+
"window",
|
|
3168
|
+
"idle"
|
|
3169
|
+
],
|
|
3170
|
+
"description": "`anytime`, `window` (in a maintenance window the owner gave) or `idle` (the AGL controller: no session busy)."
|
|
3171
|
+
},
|
|
3172
|
+
"window": {
|
|
3173
|
+
"$ref": "#/components/schemas/IDeviceTimeSpan",
|
|
3174
|
+
"description": "For the go `window`: the maintenance window it is queued into."
|
|
814
3175
|
}
|
|
815
3176
|
},
|
|
816
3177
|
"required": [
|
|
817
|
-
"
|
|
818
|
-
"
|
|
819
|
-
"type",
|
|
820
|
-
"patterns"
|
|
3178
|
+
"target",
|
|
3179
|
+
"version"
|
|
821
3180
|
],
|
|
822
3181
|
"additionalProperties": false,
|
|
823
|
-
"description": "A
|
|
3182
|
+
"description": "A planned deploy on a ticket (\"Planned\"): the target should run `version` or a newer release. Since protocol 1.3."
|
|
824
3183
|
},
|
|
825
|
-
"
|
|
3184
|
+
"IDeviceTicketLanding": {
|
|
826
3185
|
"type": "object",
|
|
827
3186
|
"properties": {
|
|
828
|
-
"
|
|
3187
|
+
"repo": {
|
|
829
3188
|
"type": "string"
|
|
830
3189
|
},
|
|
831
|
-
"
|
|
832
|
-
"type": "
|
|
833
|
-
|
|
834
|
-
|
|
835
|
-
|
|
3190
|
+
"sha": {
|
|
3191
|
+
"type": "string"
|
|
3192
|
+
},
|
|
3193
|
+
"branch": {
|
|
3194
|
+
"type": "string"
|
|
3195
|
+
},
|
|
3196
|
+
"fixedIn": {
|
|
3197
|
+
"type": "string",
|
|
3198
|
+
"description": "The first release (`v<version>`) that holds it; absent while none does."
|
|
836
3199
|
}
|
|
837
3200
|
},
|
|
838
3201
|
"required": [
|
|
839
|
-
"
|
|
840
|
-
"
|
|
3202
|
+
"repo",
|
|
3203
|
+
"sha"
|
|
841
3204
|
],
|
|
842
3205
|
"additionalProperties": false,
|
|
843
|
-
"description": "A
|
|
3206
|
+
"description": "A commit a ticket landed as on a repository's main, and the first release that holds it. Since protocol 1.3."
|
|
844
3207
|
},
|
|
845
|
-
"
|
|
3208
|
+
"IDeviceTicketPerson": {
|
|
846
3209
|
"type": "object",
|
|
847
3210
|
"properties": {
|
|
848
|
-
"
|
|
3211
|
+
"name": {
|
|
849
3212
|
"type": "string"
|
|
850
3213
|
},
|
|
851
|
-
"
|
|
3214
|
+
"kind": {
|
|
3215
|
+
"$ref": "#/components/schemas/TDeviceTicketPersonKind"
|
|
3216
|
+
},
|
|
3217
|
+
"sessionId": {
|
|
852
3218
|
"type": "string"
|
|
3219
|
+
}
|
|
3220
|
+
},
|
|
3221
|
+
"required": [
|
|
3222
|
+
"name"
|
|
3223
|
+
],
|
|
3224
|
+
"additionalProperties": false,
|
|
3225
|
+
"description": "Who holds, wrote or asked something on a ticket, by name. The owner is `kind` `owner`, never the owner's account; `sessionId` names the person's session as the session feed does, only while the feed lists it. Since protocol 1.3."
|
|
3226
|
+
},
|
|
3227
|
+
"IDeviceTicketPlacement": {
|
|
3228
|
+
"type": "object",
|
|
3229
|
+
"properties": {
|
|
3230
|
+
"state": {
|
|
3231
|
+
"type": "string",
|
|
3232
|
+
"const": "ready"
|
|
853
3233
|
},
|
|
854
|
-
"
|
|
3234
|
+
"landed": {
|
|
855
3235
|
"type": "array",
|
|
856
3236
|
"items": {
|
|
857
|
-
"$ref": "#/components/schemas/
|
|
3237
|
+
"$ref": "#/components/schemas/IDeviceTicketLanding"
|
|
858
3238
|
}
|
|
859
3239
|
},
|
|
860
|
-
"
|
|
861
|
-
"type": "
|
|
3240
|
+
"runs": {
|
|
3241
|
+
"type": "array",
|
|
3242
|
+
"items": {
|
|
3243
|
+
"$ref": "#/components/schemas/IDeviceTicketRun"
|
|
3244
|
+
}
|
|
862
3245
|
},
|
|
863
|
-
"
|
|
864
|
-
"type": "
|
|
865
|
-
"
|
|
3246
|
+
"foundIn": {
|
|
3247
|
+
"type": "array",
|
|
3248
|
+
"items": {
|
|
3249
|
+
"type": "object",
|
|
3250
|
+
"properties": {
|
|
3251
|
+
"repo": {
|
|
3252
|
+
"type": "string"
|
|
3253
|
+
},
|
|
3254
|
+
"version": {
|
|
3255
|
+
"type": "string"
|
|
3256
|
+
}
|
|
3257
|
+
},
|
|
3258
|
+
"required": [
|
|
3259
|
+
"repo",
|
|
3260
|
+
"version"
|
|
3261
|
+
],
|
|
3262
|
+
"additionalProperties": false
|
|
3263
|
+
},
|
|
3264
|
+
"description": "The versions it was found in (its `affects` links)."
|
|
866
3265
|
}
|
|
867
3266
|
},
|
|
868
3267
|
"required": [
|
|
869
|
-
"
|
|
870
|
-
"
|
|
871
|
-
"
|
|
3268
|
+
"state",
|
|
3269
|
+
"landed",
|
|
3270
|
+
"runs",
|
|
3271
|
+
"foundIn"
|
|
872
3272
|
],
|
|
873
|
-
"additionalProperties": false
|
|
3273
|
+
"additionalProperties": false,
|
|
3274
|
+
"description": "Where a ticket's work runs, as the deploy monitor last observed it (\"Where it runs\"). Since protocol 1.3."
|
|
874
3275
|
},
|
|
875
|
-
"
|
|
3276
|
+
"IDeviceTicketPlans": {
|
|
876
3277
|
"type": "object",
|
|
877
3278
|
"properties": {
|
|
878
|
-
"
|
|
879
|
-
"type": "
|
|
3279
|
+
"release": {
|
|
3280
|
+
"type": "object",
|
|
3281
|
+
"properties": {
|
|
3282
|
+
"repo": {
|
|
3283
|
+
"type": "string"
|
|
3284
|
+
},
|
|
3285
|
+
"version": {
|
|
3286
|
+
"type": "string"
|
|
3287
|
+
}
|
|
3288
|
+
},
|
|
3289
|
+
"required": [
|
|
3290
|
+
"repo"
|
|
3291
|
+
],
|
|
3292
|
+
"additionalProperties": false
|
|
880
3293
|
},
|
|
881
|
-
"
|
|
882
|
-
"
|
|
3294
|
+
"window": {
|
|
3295
|
+
"$ref": "#/components/schemas/IDeviceTicketWindow"
|
|
3296
|
+
},
|
|
3297
|
+
"deploy": {
|
|
3298
|
+
"$ref": "#/components/schemas/IDeviceTicketDeploy"
|
|
883
3299
|
}
|
|
884
3300
|
},
|
|
885
|
-
"
|
|
886
|
-
|
|
887
|
-
"description"
|
|
888
|
-
],
|
|
889
|
-
"additionalProperties": false
|
|
3301
|
+
"additionalProperties": false,
|
|
3302
|
+
"description": "What a ticket plans: a release of a repository (the next one, or `version`), a maintenance window, a deploy. Since 1.3."
|
|
890
3303
|
},
|
|
891
|
-
"
|
|
3304
|
+
"IDeviceTicketQuestion": {
|
|
892
3305
|
"type": "object",
|
|
893
3306
|
"properties": {
|
|
894
|
-
"
|
|
3307
|
+
"id": {
|
|
895
3308
|
"type": "string",
|
|
896
|
-
"
|
|
3309
|
+
"description": "`Q1`, `Q2` and so on, per ticket."
|
|
897
3310
|
},
|
|
898
|
-
"
|
|
3311
|
+
"question": {
|
|
899
3312
|
"type": "string"
|
|
900
3313
|
},
|
|
901
|
-
"
|
|
902
|
-
"type": "
|
|
3314
|
+
"options": {
|
|
3315
|
+
"type": "array",
|
|
3316
|
+
"items": {
|
|
3317
|
+
"$ref": "#/components/schemas/IDeviceTicketQuestionOption"
|
|
3318
|
+
}
|
|
3319
|
+
},
|
|
3320
|
+
"multiSelect": {
|
|
3321
|
+
"type": "boolean"
|
|
3322
|
+
},
|
|
3323
|
+
"allowCustom": {
|
|
3324
|
+
"type": "boolean"
|
|
3325
|
+
},
|
|
3326
|
+
"askedBy": {
|
|
3327
|
+
"type": "string",
|
|
3328
|
+
"description": "Who asked it."
|
|
3329
|
+
},
|
|
3330
|
+
"createdAt": {
|
|
3331
|
+
"type": "integer"
|
|
3332
|
+
},
|
|
3333
|
+
"answer": {
|
|
3334
|
+
"$ref": "#/components/schemas/IDeviceTicketQuestionAnswer",
|
|
3335
|
+
"description": "Present once it is answered."
|
|
903
3336
|
}
|
|
904
3337
|
},
|
|
905
3338
|
"required": [
|
|
906
|
-
"type",
|
|
907
3339
|
"id",
|
|
908
|
-
"
|
|
3340
|
+
"question",
|
|
3341
|
+
"options",
|
|
3342
|
+
"multiSelect",
|
|
3343
|
+
"allowCustom",
|
|
3344
|
+
"askedBy",
|
|
3345
|
+
"createdAt"
|
|
909
3346
|
],
|
|
910
|
-
"additionalProperties": false
|
|
3347
|
+
"additionalProperties": false,
|
|
3348
|
+
"description": "A ticket's question: Markdown text, options to choose from (several when `multiSelect`), and text when `allowCustom`."
|
|
911
3349
|
},
|
|
912
|
-
"
|
|
3350
|
+
"IDeviceTicketQuestionAnswer": {
|
|
913
3351
|
"type": "object",
|
|
914
3352
|
"properties": {
|
|
915
|
-
"
|
|
916
|
-
"type": "
|
|
917
|
-
"
|
|
3353
|
+
"choices": {
|
|
3354
|
+
"type": "array",
|
|
3355
|
+
"items": {
|
|
3356
|
+
"type": "string"
|
|
3357
|
+
}
|
|
918
3358
|
},
|
|
919
|
-
"
|
|
3359
|
+
"text": {
|
|
3360
|
+
"type": "string"
|
|
3361
|
+
},
|
|
3362
|
+
"answeredBy": {
|
|
920
3363
|
"type": "string"
|
|
3364
|
+
},
|
|
3365
|
+
"answeredAt": {
|
|
3366
|
+
"type": "integer"
|
|
921
3367
|
}
|
|
922
3368
|
},
|
|
923
3369
|
"required": [
|
|
924
|
-
"
|
|
925
|
-
"
|
|
3370
|
+
"choices",
|
|
3371
|
+
"answeredBy",
|
|
3372
|
+
"answeredAt"
|
|
926
3373
|
],
|
|
927
3374
|
"additionalProperties": false,
|
|
928
|
-
"description": "
|
|
3375
|
+
"description": "A ticket question's answer: the chosen option ids, the text, who answered and when."
|
|
929
3376
|
},
|
|
930
|
-
"
|
|
3377
|
+
"IDeviceTicketQuestionOption": {
|
|
931
3378
|
"type": "object",
|
|
932
3379
|
"properties": {
|
|
933
|
-
"
|
|
934
|
-
"type": "string"
|
|
935
|
-
"const": "sessionfeed.changed"
|
|
3380
|
+
"id": {
|
|
3381
|
+
"type": "string"
|
|
936
3382
|
},
|
|
937
|
-
"
|
|
938
|
-
"
|
|
3383
|
+
"label": {
|
|
3384
|
+
"type": "string"
|
|
3385
|
+
},
|
|
3386
|
+
"description": {
|
|
3387
|
+
"type": "string"
|
|
939
3388
|
}
|
|
940
3389
|
},
|
|
941
3390
|
"required": [
|
|
942
|
-
"
|
|
943
|
-
"
|
|
3391
|
+
"id",
|
|
3392
|
+
"label"
|
|
944
3393
|
],
|
|
945
|
-
"additionalProperties": false
|
|
3394
|
+
"additionalProperties": false,
|
|
3395
|
+
"description": "An option of a ticket question; the answer names it by `id`."
|
|
946
3396
|
},
|
|
947
|
-
"
|
|
3397
|
+
"IDeviceTicketRef": {
|
|
948
3398
|
"type": "object",
|
|
949
3399
|
"properties": {
|
|
950
|
-
"
|
|
3400
|
+
"key": {
|
|
951
3401
|
"type": "string"
|
|
952
3402
|
},
|
|
953
|
-
"
|
|
954
|
-
"type": "
|
|
955
|
-
},
|
|
956
|
-
"reset": {
|
|
957
|
-
"type": "boolean"
|
|
958
|
-
},
|
|
959
|
-
"upserts": {
|
|
960
|
-
"type": "array",
|
|
961
|
-
"items": {
|
|
962
|
-
"$ref": "#/components/schemas/IDeviceSessionRow"
|
|
963
|
-
}
|
|
964
|
-
},
|
|
965
|
-
"removed": {
|
|
966
|
-
"type": "array",
|
|
967
|
-
"items": {
|
|
968
|
-
"type": "string"
|
|
969
|
-
}
|
|
3403
|
+
"title": {
|
|
3404
|
+
"type": "string"
|
|
970
3405
|
}
|
|
971
3406
|
},
|
|
972
3407
|
"required": [
|
|
973
|
-
"
|
|
974
|
-
"
|
|
975
|
-
"reset",
|
|
976
|
-
"upserts",
|
|
977
|
-
"removed"
|
|
3408
|
+
"key",
|
|
3409
|
+
"title"
|
|
978
3410
|
],
|
|
979
3411
|
"additionalProperties": false,
|
|
980
|
-
"description": "A
|
|
3412
|
+
"description": "A ticket by key and title."
|
|
981
3413
|
},
|
|
982
|
-
"
|
|
3414
|
+
"IDeviceTicketRun": {
|
|
983
3415
|
"type": "object",
|
|
984
3416
|
"properties": {
|
|
985
|
-
"
|
|
986
|
-
"type": "string"
|
|
987
|
-
"description": "`${harness}:${nativeId}`, the feed's row id; the device names a session only by it."
|
|
3417
|
+
"target": {
|
|
3418
|
+
"type": "string"
|
|
988
3419
|
},
|
|
989
|
-
"
|
|
990
|
-
"
|
|
3420
|
+
"name": {
|
|
3421
|
+
"type": "string"
|
|
991
3422
|
},
|
|
992
|
-
"
|
|
993
|
-
"
|
|
3423
|
+
"environment": {
|
|
3424
|
+
"type": "string"
|
|
994
3425
|
},
|
|
995
|
-
"
|
|
3426
|
+
"repo": {
|
|
996
3427
|
"type": "string"
|
|
997
3428
|
},
|
|
998
|
-
"
|
|
3429
|
+
"version": {
|
|
999
3430
|
"type": "string",
|
|
1000
|
-
"description": "The
|
|
3431
|
+
"description": "The version it runs; absent until its probe answered one."
|
|
1001
3432
|
},
|
|
1002
|
-
"
|
|
1003
|
-
"
|
|
1004
|
-
|
|
3433
|
+
"probe": {
|
|
3434
|
+
"$ref": "#/components/schemas/TDeviceDeployProbeState"
|
|
3435
|
+
},
|
|
3436
|
+
"runs": {
|
|
3437
|
+
"type": "boolean",
|
|
3438
|
+
"description": "It runs a release that holds the ticket's work."
|
|
3439
|
+
},
|
|
3440
|
+
"shippedIn": {
|
|
3441
|
+
"type": "string",
|
|
3442
|
+
"description": "The release that ships the ticket's work in the target's repository."
|
|
1005
3443
|
}
|
|
1006
3444
|
},
|
|
1007
3445
|
"required": [
|
|
1008
|
-
"
|
|
1009
|
-
"harness",
|
|
1010
|
-
"state",
|
|
3446
|
+
"target",
|
|
1011
3447
|
"name",
|
|
1012
|
-
"
|
|
3448
|
+
"repo",
|
|
3449
|
+
"probe",
|
|
3450
|
+
"runs"
|
|
1013
3451
|
],
|
|
1014
3452
|
"additionalProperties": false,
|
|
1015
|
-
"description": "
|
|
3453
|
+
"description": "A deploy target of a ticket's repositories: what it runs, and whether that holds the ticket's release. Since protocol 1.3."
|
|
1016
3454
|
},
|
|
1017
|
-
"
|
|
3455
|
+
"IDeviceTicketSource": {
|
|
1018
3456
|
"type": "object",
|
|
1019
3457
|
"properties": {
|
|
1020
|
-
"
|
|
3458
|
+
"kind": {
|
|
1021
3459
|
"type": "string",
|
|
1022
|
-
"
|
|
3460
|
+
"enum": [
|
|
3461
|
+
"owner_words",
|
|
3462
|
+
"driver",
|
|
3463
|
+
"worker"
|
|
3464
|
+
]
|
|
1023
3465
|
},
|
|
1024
|
-
"
|
|
1025
|
-
"
|
|
3466
|
+
"text": {
|
|
3467
|
+
"type": "string"
|
|
3468
|
+
},
|
|
3469
|
+
"by": {
|
|
3470
|
+
"$ref": "#/components/schemas/IDeviceTicketPerson"
|
|
1026
3471
|
}
|
|
1027
3472
|
},
|
|
1028
3473
|
"required": [
|
|
1029
|
-
"
|
|
1030
|
-
"
|
|
3474
|
+
"kind",
|
|
3475
|
+
"text",
|
|
3476
|
+
"by"
|
|
1031
3477
|
],
|
|
1032
|
-
"additionalProperties": false
|
|
3478
|
+
"additionalProperties": false,
|
|
3479
|
+
"description": "Where a ticket came from: the owner's, the driver's or a worker's own words, and who wrote them. Since protocol 1.3."
|
|
1033
3480
|
},
|
|
1034
|
-
"
|
|
3481
|
+
"IDeviceTicketWindow": {
|
|
1035
3482
|
"type": "object",
|
|
1036
3483
|
"properties": {
|
|
1037
|
-
"
|
|
3484
|
+
"from": {
|
|
3485
|
+
"type": "integer"
|
|
3486
|
+
},
|
|
3487
|
+
"to": {
|
|
3488
|
+
"type": "integer"
|
|
3489
|
+
},
|
|
3490
|
+
"targets": {
|
|
3491
|
+
"type": "array",
|
|
3492
|
+
"items": {
|
|
3493
|
+
"type": "string"
|
|
3494
|
+
}
|
|
3495
|
+
},
|
|
3496
|
+
"state": {
|
|
1038
3497
|
"type": "string",
|
|
1039
|
-
"
|
|
3498
|
+
"enum": [
|
|
3499
|
+
"scheduled",
|
|
3500
|
+
"active",
|
|
3501
|
+
"done"
|
|
3502
|
+
],
|
|
3503
|
+
"description": "Where it stands now; absent while the deploy monitor cannot be read and once its ticket is done."
|
|
1040
3504
|
},
|
|
1041
|
-
"
|
|
1042
|
-
"
|
|
3505
|
+
"go": {
|
|
3506
|
+
"type": "string",
|
|
3507
|
+
"enum": [
|
|
3508
|
+
"given",
|
|
3509
|
+
"waiting",
|
|
3510
|
+
"declined"
|
|
3511
|
+
],
|
|
3512
|
+
"description": "The owner's go: `given` (the owner's own window, or one the owner approved), `waiting` (a window the driver proposed, its question open) or `declined`; absent as `state` is."
|
|
1043
3513
|
}
|
|
1044
3514
|
},
|
|
1045
3515
|
"required": [
|
|
1046
|
-
"
|
|
1047
|
-
"
|
|
3516
|
+
"from",
|
|
3517
|
+
"to",
|
|
3518
|
+
"targets"
|
|
1048
3519
|
],
|
|
1049
|
-
"additionalProperties": false
|
|
3520
|
+
"additionalProperties": false,
|
|
3521
|
+
"description": "A maintenance window on a ticket (\"Planned\"). Since protocol 1.3."
|
|
1050
3522
|
},
|
|
1051
|
-
"
|
|
3523
|
+
"IDeviceTicketsChangedEvent": {
|
|
1052
3524
|
"type": "object",
|
|
1053
3525
|
"properties": {
|
|
1054
3526
|
"type": {
|
|
1055
3527
|
"type": "string",
|
|
1056
|
-
"const": "
|
|
3528
|
+
"const": "tickets.changed"
|
|
3529
|
+
},
|
|
3530
|
+
"revision": {
|
|
3531
|
+
"type": "integer"
|
|
1057
3532
|
}
|
|
1058
3533
|
},
|
|
1059
3534
|
"required": [
|
|
1060
3535
|
"type"
|
|
1061
3536
|
],
|
|
1062
3537
|
"additionalProperties": false,
|
|
1063
|
-
"description": "
|
|
3538
|
+
"description": "The shared board changed: a ticket, its comments or questions, or the AutoLabels the deploy monitor computes. It names no ticket: an open board reads `device.board.list` again from its first page, an open ticket `device.ticket.get`. `revision` is the board's after the change; it is absent when only AutoLabels moved, which move no revision. Since protocol 1.3."
|
|
1064
3539
|
},
|
|
1065
|
-
"
|
|
3540
|
+
"IDeviceTimeSpan": {
|
|
1066
3541
|
"type": "object",
|
|
1067
3542
|
"properties": {
|
|
1068
|
-
"
|
|
1069
|
-
"type": "string"
|
|
1070
|
-
},
|
|
1071
|
-
"messageId": {
|
|
1072
|
-
"type": "string"
|
|
1073
|
-
},
|
|
1074
|
-
"partId": {
|
|
1075
|
-
"type": "string"
|
|
1076
|
-
},
|
|
1077
|
-
"delta": {
|
|
1078
|
-
"type": "string"
|
|
1079
|
-
},
|
|
1080
|
-
"baseTextUtf8Bytes": {
|
|
3543
|
+
"from": {
|
|
1081
3544
|
"type": "integer"
|
|
1082
3545
|
},
|
|
1083
|
-
"
|
|
3546
|
+
"to": {
|
|
1084
3547
|
"type": "integer"
|
|
1085
3548
|
}
|
|
1086
3549
|
},
|
|
1087
3550
|
"required": [
|
|
1088
|
-
"
|
|
1089
|
-
"
|
|
1090
|
-
"partId",
|
|
1091
|
-
"delta",
|
|
1092
|
-
"baseTextUtf8Bytes",
|
|
1093
|
-
"textUtf8Bytes"
|
|
3551
|
+
"from",
|
|
3552
|
+
"to"
|
|
1094
3553
|
],
|
|
1095
3554
|
"additionalProperties": false,
|
|
1096
|
-
"description": "
|
|
3555
|
+
"description": "A span of time in Unix milliseconds."
|
|
1097
3556
|
},
|
|
1098
|
-
"
|
|
3557
|
+
"IDeviceToolPart": {
|
|
1099
3558
|
"type": "object",
|
|
1100
3559
|
"properties": {
|
|
1101
3560
|
"type": {
|
|
1102
3561
|
"type": "string",
|
|
1103
|
-
"const": "
|
|
3562
|
+
"const": "tool"
|
|
1104
3563
|
},
|
|
1105
3564
|
"id": {
|
|
1106
3565
|
"type": "string"
|
|
1107
3566
|
},
|
|
1108
|
-
"
|
|
3567
|
+
"tool": {
|
|
3568
|
+
"type": "string"
|
|
3569
|
+
},
|
|
3570
|
+
"title": {
|
|
1109
3571
|
"type": "string"
|
|
3572
|
+
},
|
|
3573
|
+
"status": {
|
|
3574
|
+
"$ref": "#/components/schemas/TDeviceToolStatus"
|
|
1110
3575
|
}
|
|
1111
3576
|
},
|
|
1112
3577
|
"required": [
|
|
1113
3578
|
"type",
|
|
1114
3579
|
"id",
|
|
1115
|
-
"
|
|
3580
|
+
"tool",
|
|
3581
|
+
"status"
|
|
3582
|
+
],
|
|
3583
|
+
"additionalProperties": false,
|
|
3584
|
+
"description": "A tool call, reduced to its name, title and status: no input, no output."
|
|
3585
|
+
},
|
|
3586
|
+
"IDeviceWindowGo": {
|
|
3587
|
+
"type": "object",
|
|
3588
|
+
"properties": {
|
|
3589
|
+
"from": {
|
|
3590
|
+
"type": "integer"
|
|
3591
|
+
},
|
|
3592
|
+
"to": {
|
|
3593
|
+
"type": "integer"
|
|
3594
|
+
},
|
|
3595
|
+
"targets": {
|
|
3596
|
+
"type": "array",
|
|
3597
|
+
"items": {
|
|
3598
|
+
"type": "string"
|
|
3599
|
+
}
|
|
3600
|
+
}
|
|
3601
|
+
},
|
|
3602
|
+
"required": [
|
|
3603
|
+
"from",
|
|
3604
|
+
"to",
|
|
3605
|
+
"targets"
|
|
3606
|
+
],
|
|
3607
|
+
"additionalProperties": false,
|
|
3608
|
+
"description": "A maintenance window the driver proposed, as its go shows it."
|
|
3609
|
+
},
|
|
3610
|
+
"TDeviceAccountProvider": {
|
|
3611
|
+
"type": "string",
|
|
3612
|
+
"enum": [
|
|
3613
|
+
"anthropic",
|
|
3614
|
+
"openai"
|
|
3615
|
+
],
|
|
3616
|
+
"description": "An account pool, or an API key's provider: Claude (`anthropic`) or ChatGPT and OpenAI (`openai`). Since protocol 1.3."
|
|
3617
|
+
},
|
|
3618
|
+
"TDeviceAssigneeFilter": {
|
|
3619
|
+
"anyOf": [
|
|
3620
|
+
{
|
|
3621
|
+
"type": "object",
|
|
3622
|
+
"properties": {
|
|
3623
|
+
"kind": {
|
|
3624
|
+
"type": "string",
|
|
3625
|
+
"const": "owner"
|
|
3626
|
+
}
|
|
3627
|
+
},
|
|
3628
|
+
"required": [
|
|
3629
|
+
"kind"
|
|
3630
|
+
],
|
|
3631
|
+
"additionalProperties": false
|
|
3632
|
+
},
|
|
3633
|
+
{
|
|
3634
|
+
"type": "object",
|
|
3635
|
+
"properties": {
|
|
3636
|
+
"kind": {
|
|
3637
|
+
"type": "string",
|
|
3638
|
+
"const": "unassigned"
|
|
3639
|
+
}
|
|
3640
|
+
},
|
|
3641
|
+
"required": [
|
|
3642
|
+
"kind"
|
|
3643
|
+
],
|
|
3644
|
+
"additionalProperties": false
|
|
3645
|
+
},
|
|
3646
|
+
{
|
|
3647
|
+
"type": "object",
|
|
3648
|
+
"properties": {
|
|
3649
|
+
"kind": {
|
|
3650
|
+
"type": "string",
|
|
3651
|
+
"const": "session"
|
|
3652
|
+
},
|
|
3653
|
+
"sessionId": {
|
|
3654
|
+
"type": "string"
|
|
3655
|
+
}
|
|
3656
|
+
},
|
|
3657
|
+
"required": [
|
|
3658
|
+
"kind",
|
|
3659
|
+
"sessionId"
|
|
3660
|
+
],
|
|
3661
|
+
"additionalProperties": false
|
|
3662
|
+
}
|
|
3663
|
+
],
|
|
3664
|
+
"description": "Whose tickets the board shows: the owner's, nobody's, or those of the session the feed names `sessionId` (as a ticket person's `sessionId` names it). Since protocol 1.3."
|
|
3665
|
+
},
|
|
3666
|
+
"TDeviceDeployPlanGo": {
|
|
3667
|
+
"type": "string",
|
|
3668
|
+
"enum": [
|
|
3669
|
+
"waiting",
|
|
3670
|
+
"now",
|
|
3671
|
+
"window",
|
|
3672
|
+
"idle",
|
|
3673
|
+
"hold"
|
|
3674
|
+
],
|
|
3675
|
+
"description": "The owner's go on a planned deploy, from the answer to its question: `waiting` while it is open, `now`, `window` (the next maintenance window), `idle` (the AGL controller: when no session is busy) or `hold`. Since protocol 1.3."
|
|
3676
|
+
},
|
|
3677
|
+
"TDeviceDeployProbeState": {
|
|
3678
|
+
"type": "string",
|
|
3679
|
+
"enum": [
|
|
3680
|
+
"up",
|
|
3681
|
+
"down",
|
|
3682
|
+
"unknown"
|
|
3683
|
+
],
|
|
3684
|
+
"description": "What a deploy target's last probe found: `unknown` before its first probe. Since protocol 1.3."
|
|
3685
|
+
},
|
|
3686
|
+
"TDeviceDirectReportDelivery": {
|
|
3687
|
+
"type": "string",
|
|
3688
|
+
"enum": [
|
|
3689
|
+
"fleet",
|
|
3690
|
+
"steer",
|
|
3691
|
+
"next-turn",
|
|
3692
|
+
"queue"
|
|
3693
|
+
],
|
|
3694
|
+
"description": "How a direct report took a message: `fleet`, the fleet steered its worker through the report's ticket and the steer succeeded; `steer`, its Codex thread's running turn took it; `next-turn`, the thread's next turn takes it; `queue`, it runs after every earlier message. Since protocol 1.3."
|
|
3695
|
+
},
|
|
3696
|
+
"TDeviceDirectReportHarness": {
|
|
3697
|
+
"type": "string",
|
|
3698
|
+
"enum": [
|
|
3699
|
+
"claude",
|
|
3700
|
+
"codex"
|
|
1116
3701
|
],
|
|
1117
|
-
"
|
|
3702
|
+
"description": "The harness a direct report's session runs on. Since protocol 1.3."
|
|
1118
3703
|
},
|
|
1119
|
-
"
|
|
1120
|
-
"
|
|
1121
|
-
|
|
1122
|
-
|
|
1123
|
-
"type": "string"
|
|
1124
|
-
},
|
|
1125
|
-
"messageId": {
|
|
1126
|
-
"type": "string"
|
|
3704
|
+
"TDeviceDirectReportStatus": {
|
|
3705
|
+
"anyOf": [
|
|
3706
|
+
{
|
|
3707
|
+
"$ref": "#/components/schemas/TDeviceReportWorkerStatus"
|
|
1127
3708
|
},
|
|
1128
|
-
|
|
1129
|
-
"type": "string"
|
|
3709
|
+
{
|
|
3710
|
+
"type": "string",
|
|
3711
|
+
"const": "failed"
|
|
1130
3712
|
},
|
|
1131
|
-
|
|
1132
|
-
"type": "string"
|
|
3713
|
+
{
|
|
3714
|
+
"type": "string",
|
|
3715
|
+
"const": "unknown"
|
|
1133
3716
|
}
|
|
1134
|
-
},
|
|
1135
|
-
"required": [
|
|
1136
|
-
"sessionId",
|
|
1137
|
-
"messageId",
|
|
1138
|
-
"partId",
|
|
1139
|
-
"text"
|
|
1140
3717
|
],
|
|
1141
|
-
"
|
|
1142
|
-
"description": "A live snapshot of an assistant text part while it streams: it replaces the part's text."
|
|
3718
|
+
"description": "A direct report's status, derived on every read: its fleet worker's, `failed` for a session that failed, `unknown` for a fleet worker whose last dispatch has no known outcome. Since protocol 1.3."
|
|
1143
3719
|
},
|
|
1144
|
-
"
|
|
1145
|
-
"type": "
|
|
1146
|
-
"
|
|
1147
|
-
"
|
|
1148
|
-
|
|
1149
|
-
|
|
1150
|
-
|
|
1151
|
-
"
|
|
1152
|
-
"type": "string"
|
|
1153
|
-
},
|
|
1154
|
-
"tool": {
|
|
1155
|
-
"type": "string"
|
|
1156
|
-
},
|
|
1157
|
-
"title": {
|
|
1158
|
-
"type": "string"
|
|
1159
|
-
},
|
|
1160
|
-
"status": {
|
|
1161
|
-
"$ref": "#/components/schemas/TDeviceToolStatus"
|
|
1162
|
-
}
|
|
1163
|
-
},
|
|
1164
|
-
"required": [
|
|
1165
|
-
"type",
|
|
1166
|
-
"id",
|
|
1167
|
-
"tool",
|
|
1168
|
-
"status"
|
|
3720
|
+
"TDeviceDriverActivity": {
|
|
3721
|
+
"type": "string",
|
|
3722
|
+
"enum": [
|
|
3723
|
+
"absent",
|
|
3724
|
+
"idle",
|
|
3725
|
+
"working",
|
|
3726
|
+
"needs_input",
|
|
3727
|
+
"error"
|
|
1169
3728
|
],
|
|
1170
|
-
"
|
|
1171
|
-
"description": "A tool call, reduced to its name, title and status: no input, no output."
|
|
3729
|
+
"description": "What the host's driver does: `absent`, the host has no driver session (a device never creates one); `needs_input`, its last turn ended on a `needs input:` line, or one of its own prompts waits. Since protocol 1.3."
|
|
1172
3730
|
},
|
|
1173
3731
|
"TDeviceElicitation": {
|
|
1174
3732
|
"anyOf": [
|
|
@@ -1289,10 +3847,38 @@
|
|
|
1289
3847
|
},
|
|
1290
3848
|
{
|
|
1291
3849
|
"$ref": "#/components/schemas/IDeviceSessionsChangedEvent"
|
|
3850
|
+
},
|
|
3851
|
+
{
|
|
3852
|
+
"$ref": "#/components/schemas/IDeviceInboxChangedEvent"
|
|
3853
|
+
},
|
|
3854
|
+
{
|
|
3855
|
+
"$ref": "#/components/schemas/IDeviceDriverChangedEvent"
|
|
3856
|
+
},
|
|
3857
|
+
{
|
|
3858
|
+
"$ref": "#/components/schemas/IDeviceDirectReportsChangedEvent"
|
|
3859
|
+
},
|
|
3860
|
+
{
|
|
3861
|
+
"$ref": "#/components/schemas/IDeviceHostChangedEvent"
|
|
3862
|
+
},
|
|
3863
|
+
{
|
|
3864
|
+
"$ref": "#/components/schemas/IDeviceTicketsChangedEvent"
|
|
1292
3865
|
}
|
|
1293
3866
|
],
|
|
1294
3867
|
"description": "The events a device receives: an allowlist, each in a reduced shape."
|
|
1295
3868
|
},
|
|
3869
|
+
"TDeviceGatewayState": {
|
|
3870
|
+
"type": "string",
|
|
3871
|
+
"enum": [
|
|
3872
|
+
"finalize_pending",
|
|
3873
|
+
"syncing",
|
|
3874
|
+
"synced",
|
|
3875
|
+
"retrying",
|
|
3876
|
+
"waiting",
|
|
3877
|
+
"failed",
|
|
3878
|
+
"stopped"
|
|
3879
|
+
],
|
|
3880
|
+
"description": "Where the host's route on its gateway stands: `finalize_pending`, the enrolment waits to be confirmed; `syncing`; `synced`, the route is written; `retrying`, the last sync failed and is retried; `waiting`, the gateway cannot carry the route yet; `failed`, the last sync failed until the owner acts; `stopped`. Since protocol 1.3."
|
|
3881
|
+
},
|
|
1296
3882
|
"TDeviceHarness": {
|
|
1297
3883
|
"type": "string",
|
|
1298
3884
|
"enum": [
|
|
@@ -1303,6 +3889,130 @@
|
|
|
1303
3889
|
],
|
|
1304
3890
|
"description": "The harness a session runs on."
|
|
1305
3891
|
},
|
|
3892
|
+
"TDeviceHostUnavailableReason": {
|
|
3893
|
+
"type": "string",
|
|
3894
|
+
"enum": [
|
|
3895
|
+
"not_running",
|
|
3896
|
+
"outdated",
|
|
3897
|
+
"failed"
|
|
3898
|
+
],
|
|
3899
|
+
"description": "Why a section was not read: `not_running`, what answers it does not run now (the configuration service the deploy monitor reads, the inference proxy or the accounts service; it may be starting); `outdated`, it runs a release this AGL cannot read; `failed`, the read failed, and AGL keeps the cause in its failure journal under `reference`. Since protocol 1.3."
|
|
3900
|
+
},
|
|
3901
|
+
"TDeviceInboxAnswer": {
|
|
3902
|
+
"type": "string",
|
|
3903
|
+
"enum": [
|
|
3904
|
+
"session",
|
|
3905
|
+
"child",
|
|
3906
|
+
"ticket",
|
|
3907
|
+
"none"
|
|
3908
|
+
],
|
|
3909
|
+
"description": "How a device answers an item: `session` with `device.permission.reply`, `device.question.reply` or `device.elicitation.reply` for the session; `child` with the same replies and the child's `childSessionId`; `ticket` with `device.ticket.answer`; `none` not on a device (the driver's turn, the driver's own prompts, a native wait, an item whose payload was left out, or a session the feed does not list)."
|
|
3910
|
+
},
|
|
3911
|
+
"TDeviceInboxItem": {
|
|
3912
|
+
"anyOf": [
|
|
3913
|
+
{
|
|
3914
|
+
"$ref": "#/components/schemas/IDeviceInboxPermissionItem"
|
|
3915
|
+
},
|
|
3916
|
+
{
|
|
3917
|
+
"$ref": "#/components/schemas/IDeviceInboxQuestionItem"
|
|
3918
|
+
},
|
|
3919
|
+
{
|
|
3920
|
+
"$ref": "#/components/schemas/IDeviceInboxElicitationItem"
|
|
3921
|
+
},
|
|
3922
|
+
{
|
|
3923
|
+
"$ref": "#/components/schemas/IDeviceInboxNativeWaitItem"
|
|
3924
|
+
},
|
|
3925
|
+
{
|
|
3926
|
+
"$ref": "#/components/schemas/IDeviceInboxDriverItem"
|
|
3927
|
+
},
|
|
3928
|
+
{
|
|
3929
|
+
"$ref": "#/components/schemas/IDeviceInboxDeployGoItem"
|
|
3930
|
+
},
|
|
3931
|
+
{
|
|
3932
|
+
"$ref": "#/components/schemas/IDeviceInboxWindowGoItem"
|
|
3933
|
+
},
|
|
3934
|
+
{
|
|
3935
|
+
"$ref": "#/components/schemas/IDeviceInboxTicketQuestionItem"
|
|
3936
|
+
}
|
|
3937
|
+
],
|
|
3938
|
+
"description": "One thing that waits for the owner. Since protocol 1.2."
|
|
3939
|
+
},
|
|
3940
|
+
"TDeviceInboxWhere": {
|
|
3941
|
+
"anyOf": [
|
|
3942
|
+
{
|
|
3943
|
+
"type": "object",
|
|
3944
|
+
"properties": {
|
|
3945
|
+
"kind": {
|
|
3946
|
+
"type": "string",
|
|
3947
|
+
"const": "session"
|
|
3948
|
+
},
|
|
3949
|
+
"sessionId": {
|
|
3950
|
+
"type": "string",
|
|
3951
|
+
"description": "The feed's row id."
|
|
3952
|
+
},
|
|
3953
|
+
"harness": {
|
|
3954
|
+
"$ref": "#/components/schemas/TDeviceHarness"
|
|
3955
|
+
},
|
|
3956
|
+
"name": {
|
|
3957
|
+
"type": "string"
|
|
3958
|
+
},
|
|
3959
|
+
"childSessionId": {
|
|
3960
|
+
"type": "string",
|
|
3961
|
+
"description": "The direct child that asks, which `childSessionId` of the reply names."
|
|
3962
|
+
},
|
|
3963
|
+
"childName": {
|
|
3964
|
+
"type": "string"
|
|
3965
|
+
}
|
|
3966
|
+
},
|
|
3967
|
+
"required": [
|
|
3968
|
+
"kind",
|
|
3969
|
+
"sessionId",
|
|
3970
|
+
"harness",
|
|
3971
|
+
"name"
|
|
3972
|
+
],
|
|
3973
|
+
"additionalProperties": false
|
|
3974
|
+
},
|
|
3975
|
+
{
|
|
3976
|
+
"type": "object",
|
|
3977
|
+
"properties": {
|
|
3978
|
+
"kind": {
|
|
3979
|
+
"type": "string",
|
|
3980
|
+
"const": "driver"
|
|
3981
|
+
}
|
|
3982
|
+
},
|
|
3983
|
+
"required": [
|
|
3984
|
+
"kind"
|
|
3985
|
+
],
|
|
3986
|
+
"additionalProperties": false
|
|
3987
|
+
},
|
|
3988
|
+
{
|
|
3989
|
+
"type": "object",
|
|
3990
|
+
"properties": {
|
|
3991
|
+
"kind": {
|
|
3992
|
+
"type": "string",
|
|
3993
|
+
"const": "ticket"
|
|
3994
|
+
},
|
|
3995
|
+
"ticketKey": {
|
|
3996
|
+
"type": "string"
|
|
3997
|
+
},
|
|
3998
|
+
"ticketTitle": {
|
|
3999
|
+
"type": "string"
|
|
4000
|
+
},
|
|
4001
|
+
"project": {
|
|
4002
|
+
"type": "string"
|
|
4003
|
+
}
|
|
4004
|
+
},
|
|
4005
|
+
"required": [
|
|
4006
|
+
"kind",
|
|
4007
|
+
"ticketKey",
|
|
4008
|
+
"ticketTitle",
|
|
4009
|
+
"project"
|
|
4010
|
+
],
|
|
4011
|
+
"additionalProperties": false
|
|
4012
|
+
}
|
|
4013
|
+
],
|
|
4014
|
+
"description": "Where an item lives: a session as the feed names it (with the direct child that asks, an OpenCode subagent, when it is one), the host's driver, or a ticket."
|
|
4015
|
+
},
|
|
1306
4016
|
"TDeviceMessagePart": {
|
|
1307
4017
|
"anyOf": [
|
|
1308
4018
|
{
|
|
@@ -1323,6 +4033,17 @@
|
|
|
1323
4033
|
"assistant"
|
|
1324
4034
|
]
|
|
1325
4035
|
},
|
|
4036
|
+
"TDevicePoolMemberState": {
|
|
4037
|
+
"type": "string",
|
|
4038
|
+
"enum": [
|
|
4039
|
+
"available",
|
|
4040
|
+
"reserved",
|
|
4041
|
+
"exhausted",
|
|
4042
|
+
"cooling",
|
|
4043
|
+
"unavailable"
|
|
4044
|
+
],
|
|
4045
|
+
"description": "Whether a pool's account takes new work now, or why not. Since protocol 1.3."
|
|
4046
|
+
},
|
|
1326
4047
|
"TDeviceRefusalCode": {
|
|
1327
4048
|
"type": "string",
|
|
1328
4049
|
"enum": [
|
|
@@ -1335,9 +4056,64 @@
|
|
|
1335
4056
|
"device_challenge_invalid",
|
|
1336
4057
|
"device_authentication_required",
|
|
1337
4058
|
"session_not_found",
|
|
1338
|
-
"session_read_only"
|
|
4059
|
+
"session_read_only",
|
|
4060
|
+
"ticket_revision_conflict",
|
|
4061
|
+
"ticket_identity_required",
|
|
4062
|
+
"ticket_not_found",
|
|
4063
|
+
"ticket_not_assigned",
|
|
4064
|
+
"ticket_worker_column",
|
|
4065
|
+
"ticket_worker_create_backlog",
|
|
4066
|
+
"ticket_assignment_forbidden",
|
|
4067
|
+
"ticket_review_branch_required",
|
|
4068
|
+
"ticket_landed_evidence_required",
|
|
4069
|
+
"ticket_released_evidence_required",
|
|
4070
|
+
"ticket_closed_landed",
|
|
4071
|
+
"ticket_parent_required",
|
|
4072
|
+
"ticket_parent_invalid",
|
|
4073
|
+
"ticket_move_anchor_invalid",
|
|
4074
|
+
"ticket_label_reserved",
|
|
4075
|
+
"ticket_release_plan_forbidden",
|
|
4076
|
+
"ticket_unlink_forbidden",
|
|
4077
|
+
"ticket_release_link_forbidden",
|
|
4078
|
+
"ticket_link_not_found",
|
|
4079
|
+
"ticket_affects_invalid",
|
|
4080
|
+
"ticket_release_plan_invalid",
|
|
4081
|
+
"ticket_window_forbidden",
|
|
4082
|
+
"ticket_window_invalid",
|
|
4083
|
+
"ticket_deploy_plan_forbidden",
|
|
4084
|
+
"ticket_deploy_plan_invalid",
|
|
4085
|
+
"ticket_deploy_plan_link_forbidden",
|
|
4086
|
+
"ticket_deploy_plan_fixed",
|
|
4087
|
+
"ticket_window_waiting",
|
|
4088
|
+
"ticket_go_owner_only",
|
|
4089
|
+
"ticket_ask_forbidden",
|
|
4090
|
+
"ticket_answer_forbidden",
|
|
4091
|
+
"ticket_question_not_found",
|
|
4092
|
+
"ticket_comment_not_found",
|
|
4093
|
+
"ticket_question_answered",
|
|
4094
|
+
"ticket_answer_invalid",
|
|
4095
|
+
"driver_absent",
|
|
4096
|
+
"direct_report_failed",
|
|
4097
|
+
"direct_report_busy",
|
|
4098
|
+
"rate_limited",
|
|
4099
|
+
"invalid_request",
|
|
4100
|
+
"controller_unavailable",
|
|
4101
|
+
"operation_limit"
|
|
4102
|
+
],
|
|
4103
|
+
"description": "Why AGL refused a device request, as `error.data.code`: `device_unknown`: no such device is paired (any more): forget the pairing; `device_pairing_invalid`: the code is unknown, used or expired; `device_pairing_unavailable`: the controller has no public origin, so nothing can pair with it; `device_limit`: the controller holds its maximum of devices; `device_already_paired`: this key is paired already; `device_proof_invalid`: the signature does not verify; `device_challenge_invalid`: no live nonce of this connection for this device; `device_authentication_required`: the connection is not authenticated as a device; `session_not_found`: the session feed lists no such session (or, for a `childSessionId`, the session has no such direct child that runs); `session_read_only`: AGL does not write to the session (another process runs it, a fleet worker owns it); the ticket store's own refusals, `deviceTicketRefusalCodes`, each with the store's reason (since 1.3; these four since 1.2): `ticket_not_found`, `ticket_question_not_found`: no such ticket, or no such question on it; `ticket_question_answered`: the question already has a different answer; a second answer is refused; `ticket_answer_invalid`: the answer chooses options the question does not have, more than one where it takes one, or text where it takes none; `driver_absent`: the host has no driver session; the owner starts the driver in the browser, a device never does (since 1.3); `direct_report_failed`: the direct report took no message, or AGL could not confirm it did: it is not an active report, it is a Claude Code session the fleet does not run, or its fleet job or Codex server failed; the message says why (since 1.3); `direct_report_busy`: the report's Codex thread runs a turn another Codex client started, which a device does not steer; nothing was sent: send it again once that turn ended (since 1.3); `rate_limited`, `invalid_request`, `controller_unavailable` and `operation_limit` as for any client. In this device protocol version (1.0) AGL sends no retry hint with a refusal (no `retry` beside the error, no retry timing in `error.data`), and `rate_limited` is final: a client never resends the refused request on its own; it shows the refusal, and the user may try again."
|
|
4104
|
+
},
|
|
4105
|
+
"TDeviceReportWorkerStatus": {
|
|
4106
|
+
"type": "string",
|
|
4107
|
+
"enum": [
|
|
4108
|
+
"busy",
|
|
4109
|
+
"idle",
|
|
4110
|
+
"blocked",
|
|
4111
|
+
"stopped",
|
|
4112
|
+
"archived",
|
|
4113
|
+
"reaped",
|
|
4114
|
+
"gone"
|
|
1339
4115
|
],
|
|
1340
|
-
"description": "
|
|
4116
|
+
"description": "A fleet worker's native status as AGL last observed it: `reaped`, its process ended under it; `gone`, its session is no more. Since protocol 1.3."
|
|
1341
4117
|
},
|
|
1342
4118
|
"TDeviceSessionState": {
|
|
1343
4119
|
"type": "string",
|
|
@@ -1349,6 +4125,200 @@
|
|
|
1349
4125
|
],
|
|
1350
4126
|
"description": "`needs_input`: a question, a permission or an MCP elicitation waits for the owner."
|
|
1351
4127
|
},
|
|
4128
|
+
"TDeviceTicketAutoLabel": {
|
|
4129
|
+
"type": "string",
|
|
4130
|
+
"enum": [
|
|
4131
|
+
"openQuestion",
|
|
4132
|
+
"planned",
|
|
4133
|
+
"undeployed"
|
|
4134
|
+
],
|
|
4135
|
+
"description": "A label AGL computes from a ticket's state, never set by hand: `openQuestion`, an unanswered question on a ticket that is not done; `planned`, a release plan, a deploy plan or a maintenance window on a ticket that is not done; `undeployed`, released in a version some deploy target of its repositories does not run yet. Since protocol 1.3."
|
|
4136
|
+
},
|
|
4137
|
+
"TDeviceTicketColumn": {
|
|
4138
|
+
"type": "string",
|
|
4139
|
+
"enum": [
|
|
4140
|
+
"backlog",
|
|
4141
|
+
"ready",
|
|
4142
|
+
"in_progress",
|
|
4143
|
+
"needs_input",
|
|
4144
|
+
"review",
|
|
4145
|
+
"landed",
|
|
4146
|
+
"released",
|
|
4147
|
+
"closed"
|
|
4148
|
+
],
|
|
4149
|
+
"description": "A column of the shared board, in the board's order; `released` and `closed` hold finished work. Since protocol 1.3."
|
|
4150
|
+
},
|
|
4151
|
+
"TDeviceTicketCommentPart": {
|
|
4152
|
+
"anyOf": [
|
|
4153
|
+
{
|
|
4154
|
+
"type": "object",
|
|
4155
|
+
"properties": {
|
|
4156
|
+
"type": {
|
|
4157
|
+
"type": "string",
|
|
4158
|
+
"const": "text"
|
|
4159
|
+
},
|
|
4160
|
+
"text": {
|
|
4161
|
+
"type": "string"
|
|
4162
|
+
}
|
|
4163
|
+
},
|
|
4164
|
+
"required": [
|
|
4165
|
+
"type",
|
|
4166
|
+
"text"
|
|
4167
|
+
],
|
|
4168
|
+
"additionalProperties": false
|
|
4169
|
+
},
|
|
4170
|
+
{
|
|
4171
|
+
"type": "object",
|
|
4172
|
+
"properties": {
|
|
4173
|
+
"type": {
|
|
4174
|
+
"type": "string",
|
|
4175
|
+
"const": "reference"
|
|
4176
|
+
},
|
|
4177
|
+
"id": {
|
|
4178
|
+
"type": "string"
|
|
4179
|
+
},
|
|
4180
|
+
"label": {
|
|
4181
|
+
"type": "string"
|
|
4182
|
+
}
|
|
4183
|
+
},
|
|
4184
|
+
"required": [
|
|
4185
|
+
"type",
|
|
4186
|
+
"id",
|
|
4187
|
+
"label"
|
|
4188
|
+
],
|
|
4189
|
+
"additionalProperties": false
|
|
4190
|
+
}
|
|
4191
|
+
],
|
|
4192
|
+
"description": "A part of a comment: text (Markdown), or a reference by id with its label. Since protocol 1.3."
|
|
4193
|
+
},
|
|
4194
|
+
"TDeviceTicketKind": {
|
|
4195
|
+
"type": "string",
|
|
4196
|
+
"enum": [
|
|
4197
|
+
"epic",
|
|
4198
|
+
"task",
|
|
4199
|
+
"subtask"
|
|
4200
|
+
],
|
|
4201
|
+
"description": "An epic holds tasks, a task subtasks. Since protocol 1.3."
|
|
4202
|
+
},
|
|
4203
|
+
"TDeviceTicketLink": {
|
|
4204
|
+
"anyOf": [
|
|
4205
|
+
{
|
|
4206
|
+
"type": "object",
|
|
4207
|
+
"properties": {
|
|
4208
|
+
"kind": {
|
|
4209
|
+
"type": "string",
|
|
4210
|
+
"const": "branch"
|
|
4211
|
+
},
|
|
4212
|
+
"repo": {
|
|
4213
|
+
"type": "string"
|
|
4214
|
+
},
|
|
4215
|
+
"branch": {
|
|
4216
|
+
"type": "string"
|
|
4217
|
+
},
|
|
4218
|
+
"sha": {
|
|
4219
|
+
"type": "string"
|
|
4220
|
+
}
|
|
4221
|
+
},
|
|
4222
|
+
"required": [
|
|
4223
|
+
"kind",
|
|
4224
|
+
"repo",
|
|
4225
|
+
"branch",
|
|
4226
|
+
"sha"
|
|
4227
|
+
],
|
|
4228
|
+
"additionalProperties": false
|
|
4229
|
+
},
|
|
4230
|
+
{
|
|
4231
|
+
"type": "object",
|
|
4232
|
+
"properties": {
|
|
4233
|
+
"kind": {
|
|
4234
|
+
"type": "string",
|
|
4235
|
+
"const": "commit"
|
|
4236
|
+
},
|
|
4237
|
+
"repo": {
|
|
4238
|
+
"type": "string"
|
|
4239
|
+
},
|
|
4240
|
+
"sha": {
|
|
4241
|
+
"type": "string"
|
|
4242
|
+
}
|
|
4243
|
+
},
|
|
4244
|
+
"required": [
|
|
4245
|
+
"kind",
|
|
4246
|
+
"repo",
|
|
4247
|
+
"sha"
|
|
4248
|
+
],
|
|
4249
|
+
"additionalProperties": false
|
|
4250
|
+
},
|
|
4251
|
+
{
|
|
4252
|
+
"type": "object",
|
|
4253
|
+
"properties": {
|
|
4254
|
+
"kind": {
|
|
4255
|
+
"type": "string",
|
|
4256
|
+
"const": "release"
|
|
4257
|
+
},
|
|
4258
|
+
"version": {
|
|
4259
|
+
"type": "string"
|
|
4260
|
+
},
|
|
4261
|
+
"package": {
|
|
4262
|
+
"type": "string"
|
|
4263
|
+
},
|
|
4264
|
+
"repo": {
|
|
4265
|
+
"type": "string"
|
|
4266
|
+
},
|
|
4267
|
+
"sha": {
|
|
4268
|
+
"type": "string"
|
|
4269
|
+
}
|
|
4270
|
+
},
|
|
4271
|
+
"required": [
|
|
4272
|
+
"kind",
|
|
4273
|
+
"version"
|
|
4274
|
+
],
|
|
4275
|
+
"additionalProperties": false
|
|
4276
|
+
},
|
|
4277
|
+
{
|
|
4278
|
+
"type": "object",
|
|
4279
|
+
"properties": {
|
|
4280
|
+
"kind": {
|
|
4281
|
+
"type": "string",
|
|
4282
|
+
"const": "affects"
|
|
4283
|
+
},
|
|
4284
|
+
"repo": {
|
|
4285
|
+
"type": "string"
|
|
4286
|
+
},
|
|
4287
|
+
"version": {
|
|
4288
|
+
"type": "string"
|
|
4289
|
+
}
|
|
4290
|
+
},
|
|
4291
|
+
"required": [
|
|
4292
|
+
"kind",
|
|
4293
|
+
"repo",
|
|
4294
|
+
"version"
|
|
4295
|
+
],
|
|
4296
|
+
"additionalProperties": false
|
|
4297
|
+
}
|
|
4298
|
+
],
|
|
4299
|
+
"description": "Evidence a ticket carries: a branch or a commit it landed as, a release (`v<version>` of a repository, or a package), or the version of a repository a bug was found in (`affects`). Since protocol 1.3."
|
|
4300
|
+
},
|
|
4301
|
+
"TDeviceTicketPersonKind": {
|
|
4302
|
+
"type": "string",
|
|
4303
|
+
"enum": [
|
|
4304
|
+
"owner",
|
|
4305
|
+
"person",
|
|
4306
|
+
"claude",
|
|
4307
|
+
"codex",
|
|
4308
|
+
"worker"
|
|
4309
|
+
],
|
|
4310
|
+
"description": "What a person on a ticket is: the owner, a person, a Claude Code or Codex session, another worker. Since protocol 1.3."
|
|
4311
|
+
},
|
|
4312
|
+
"TDeviceTicketPriority": {
|
|
4313
|
+
"type": "string",
|
|
4314
|
+
"enum": [
|
|
4315
|
+
"none",
|
|
4316
|
+
"low",
|
|
4317
|
+
"normal",
|
|
4318
|
+
"high",
|
|
4319
|
+
"urgent"
|
|
4320
|
+
]
|
|
4321
|
+
},
|
|
1352
4322
|
"TDeviceToolStatus": {
|
|
1353
4323
|
"type": "string",
|
|
1354
4324
|
"enum": [
|