agl 43.2.0 → 43.3.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (213) hide show
  1. package/changelog.md +29 -0
  2. package/dist_serve/bundle.js +2845 -2638
  3. package/dist_serve/bundle.js.map +2 -2
  4. package/dist_serve/bundle.js.third-party-notices.json +1 -1
  5. package/dist_serve/bundle.js.third-party-notices.txt +1 -1
  6. package/dist_ts/00_commitinfo_data.js +1 -1
  7. package/dist_ts/aglapi/aglapisurface.document.js +197 -17
  8. package/dist_ts/classes.accountsactions.d.ts +3 -1
  9. package/dist_ts/classes.accountsactions.js +21 -3
  10. package/dist_ts/classes.authstore.d.ts +7 -0
  11. package/dist_ts/classes.authstore.js +9 -1
  12. package/dist_ts/classes.claudeharness.d.ts +29 -2
  13. package/dist_ts/classes.claudeharness.js +35 -6
  14. package/dist_ts/classes.codexclientadapter.d.ts +11 -0
  15. package/dist_ts/classes.codexclientadapter.js +14 -2
  16. package/dist_ts/classes.controller.d.ts +187 -12
  17. package/dist_ts/classes.controller.js +1208 -186
  18. package/dist_ts/classes.controllerdevices.d.ts +2 -0
  19. package/dist_ts/classes.controllerdevices.js +6 -1
  20. package/dist_ts/classes.inbox.d.ts +72 -0
  21. package/dist_ts/classes.inbox.js +231 -0
  22. package/dist_ts/classes.inferencerouter.d.ts +10 -0
  23. package/dist_ts/classes.inferencerouter.js +5 -3
  24. package/dist_ts/classes.inferenceservice.js +2 -2
  25. package/dist_ts/classes.mcpclient.d.ts +1 -1
  26. package/dist_ts/classes.mcpclient.js +24 -6
  27. package/dist_ts/classes.mcpcontrollerhost.js +6 -1
  28. package/dist_ts/classes.mcptools.js +18 -8
  29. package/dist_ts/classes.mcpvalidation.d.ts +5 -0
  30. package/dist_ts/classes.mcpvalidation.js +32 -2
  31. package/dist_ts/classes.nativesessions.d.ts +29 -4
  32. package/dist_ts/classes.nativesessions.js +41 -9
  33. package/dist_ts/classes.opencodeclient.d.ts +23 -2
  34. package/dist_ts/classes.opencodeclient.js +47 -3
  35. package/dist_ts/classes.publishedset.d.ts +38 -0
  36. package/dist_ts/classes.publishedset.js +50 -0
  37. package/dist_ts/classes.sessionfeed.d.ts +3 -3
  38. package/dist_ts/classes.sessionfeed.js +18 -26
  39. package/dist_ts/classes.systemmetricssampler.d.ts +6 -0
  40. package/dist_ts/classes.systemmetricssampler.js +15 -3
  41. package/dist_ts/classes.ticketstore.d.ts +50 -3
  42. package/dist_ts/classes.ticketstore.js +45 -8
  43. package/dist_ts/classes.workercallers.js +4 -2
  44. package/dist_ts/driver/classes.directreports.d.ts +14 -4
  45. package/dist_ts/driver/classes.directreports.js +42 -23
  46. package/dist_ts/driver/classes.directreportstore.d.ts +8 -1
  47. package/dist_ts/driver/classes.directreportstore.js +20 -10
  48. package/dist_ts/driver/classes.driverservice.d.ts +44 -3
  49. package/dist_ts/driver/classes.driverservice.js +50 -16
  50. package/dist_ts/fleet/classes.claudeworkers.d.ts +21 -5
  51. package/dist_ts/fleet/classes.claudeworkers.js +142 -46
  52. package/dist_ts/fleet/classes.codexworkers.d.ts +16 -4
  53. package/dist_ts/fleet/classes.codexworkers.js +22 -5
  54. package/dist_ts/fleet/classes.workercommand.d.ts +6 -1
  55. package/dist_ts/fleet/classes.workercommand.js +15 -4
  56. package/dist_ts/fleet/classes.workers.d.ts +21 -1
  57. package/dist_ts/fleet/classes.workers.js +80 -40
  58. package/dist_ts/fleet/classes.workerstore.js +14 -8
  59. package/dist_ts/fleet/functions.unbounddrivers.js +2 -2
  60. package/dist_ts/fleet/functions.workervalidation.js +11 -4
  61. package/dist_ts/fleet/interfaces.workers.d.ts +27 -5
  62. package/dist_ts/fleet/interfaces.workers.js +8 -4
  63. package/dist_ts/functions.agentmessage.d.ts +3 -0
  64. package/dist_ts/functions.agentmessage.js +4 -1
  65. package/dist_ts/functions.deviceapi.d.ts +198 -4
  66. package/dist_ts/functions.deviceapi.js +1060 -38
  67. package/dist_ts/functions.exactpersistence.d.ts +3 -0
  68. package/dist_ts/functions.exactpersistence.js +4 -0
  69. package/dist_ts/functions.fleetworkercli.d.ts +1 -1
  70. package/dist_ts/functions.fleetworkercli.js +11 -8
  71. package/dist_ts/functions.inferencecli.js +3 -1
  72. package/dist_ts/functions.mcpfleetworkertools.js +3 -3
  73. package/dist_ts/functions.ticketactor.d.ts +17 -1
  74. package/dist_ts/functions.ticketactor.js +55 -15
  75. package/dist_ts/functions.ticketvalidation.js +11 -2
  76. package/dist_ts/interfaces.auth.d.ts +1 -1
  77. package/dist_ts/interfaces.auth.js +9 -1
  78. package/dist_ts/plugins.d.ts +3 -1
  79. package/dist_ts/plugins.js +7 -2
  80. package/dist_ts_authswitch/authority-contract.d.ts +25 -0
  81. package/dist_ts_authswitch/authority-contract.js +1 -1
  82. package/dist_ts_authswitch/authority-overview.d.ts +8 -0
  83. package/dist_ts_authswitch/authority-overview.js +17 -6
  84. package/dist_ts_authswitch/authority-placement.d.ts +20 -16
  85. package/dist_ts_authswitch/authority-placement.js +17 -10
  86. package/dist_ts_authswitch/authority-renewal.d.ts +34 -0
  87. package/dist_ts_authswitch/authority-renewal.js +56 -0
  88. package/dist_ts_authswitch/classes.authoritybroker.d.ts +8 -0
  89. package/dist_ts_authswitch/classes.authoritybroker.js +35 -2
  90. package/dist_ts_authswitch/classes.authoritycli.d.ts +1 -0
  91. package/dist_ts_authswitch/classes.authoritycli.js +44 -3
  92. package/dist_ts_authswitch/classes.authorityclient.d.ts +6 -1
  93. package/dist_ts_authswitch/classes.authorityclient.js +12 -4
  94. package/dist_ts_authswitch/classes.authoritydaemon.js +8 -1
  95. package/dist_ts_authswitch/classes.authoritydatabase.js +6 -2
  96. package/dist_ts_authswitch/classes.authoritymodels.d.ts +7 -0
  97. package/dist_ts_authswitch/classes.authoritymodels.js +21 -5
  98. package/dist_ts_interfaces/devices.d.ts +1027 -7
  99. package/dist_ts_interfaces/devices.js +68 -2
  100. package/dist_ts_interfaces/fleetworkers.d.ts +37 -10
  101. package/dist_ts_interfaces/fleetworkers.js +19 -8
  102. package/dist_ts_interfaces/inbox.d.ts +234 -0
  103. package/dist_ts_interfaces/inbox.js +101 -0
  104. package/dist_ts_interfaces/index.d.ts +1 -0
  105. package/dist_ts_interfaces/index.js +2 -1
  106. package/dist_ts_interfaces/interfaces.d.ts +10 -3
  107. package/dist_ts_interfaces/interfaces.js +4 -2
  108. package/dist_ts_interfaces/mcprequests.d.ts +34 -4
  109. package/dist_ts_interfaces/mcprequests.js +11 -1
  110. package/dist_ts_interfaces/mcpworkspacerequests.d.ts +4 -1
  111. package/dist_ts_interfaces/mcpworkspacerequests.js +1 -1
  112. package/dist_ts_interfaces/nativesessions.d.ts +16 -3
  113. package/dist_ts_interfaces/plugins.d.ts +2 -1
  114. package/dist_ts_interfaces/plugins.js +4 -2
  115. package/dist_ts_interfaces/requests.accounts.d.ts +21 -0
  116. package/dist_ts_interfaces/requests.accounts.js +3 -1
  117. package/dist_ts_interfaces/requests.d.ts +3 -2
  118. package/dist_ts_interfaces/requests.js +1 -1
  119. package/dist_ts_interfaces/workercallers.d.ts +2 -0
  120. package/dist_ts_migration/classes.documentmigrationrunner.d.ts +14 -0
  121. package/dist_ts_migration/classes.documentmigrationrunner.js +20 -1
  122. package/dist_ts_migration/index.d.ts +1 -0
  123. package/dist_ts_migration/index.js +2 -1
  124. package/dist_ts_migration/v43_ticketactornames.d.ts +32 -0
  125. package/dist_ts_migration/v43_ticketactornames.js +236 -0
  126. package/docs/authswitch.md +20 -1
  127. package/package.json +3 -3
  128. package/readme.md +144 -27
  129. package/ts/00_commitinfo_data.ts +1 -1
  130. package/ts/aglapi/aglapisurface.document.ts +196 -16
  131. package/ts/classes.accountsactions.ts +30 -3
  132. package/ts/classes.authstore.ts +10 -0
  133. package/ts/classes.claudeharness.ts +45 -5
  134. package/ts/classes.codexclientadapter.ts +14 -1
  135. package/ts/classes.controller.ts +1412 -262
  136. package/ts/classes.controllerdevices.ts +6 -0
  137. package/ts/classes.inbox.ts +239 -0
  138. package/ts/classes.inferencerouter.ts +15 -2
  139. package/ts/classes.inferenceservice.ts +1 -1
  140. package/ts/classes.mcpclient.ts +24 -3
  141. package/ts/classes.mcpcontrollerhost.ts +5 -0
  142. package/ts/classes.mcptools.ts +17 -7
  143. package/ts/classes.mcpvalidation.ts +27 -1
  144. package/ts/classes.nativesessions.ts +63 -12
  145. package/ts/classes.opencodeclient.ts +55 -4
  146. package/ts/classes.publishedset.ts +56 -0
  147. package/ts/classes.sessionfeed.ts +17 -20
  148. package/ts/classes.systemmetricssampler.ts +13 -2
  149. package/ts/classes.ticketstore.ts +73 -12
  150. package/ts/classes.workercallers.ts +3 -1
  151. package/ts/driver/classes.directreports.ts +42 -23
  152. package/ts/driver/classes.directreportstore.ts +20 -9
  153. package/ts/driver/classes.driverservice.ts +75 -14
  154. package/ts/fleet/classes.claudeworkers.ts +112 -39
  155. package/ts/fleet/classes.codexworkers.ts +21 -6
  156. package/ts/fleet/classes.workercommand.ts +14 -4
  157. package/ts/fleet/classes.workers.ts +75 -41
  158. package/ts/fleet/classes.workerstore.ts +11 -7
  159. package/ts/fleet/functions.unbounddrivers.ts +1 -1
  160. package/ts/fleet/functions.workervalidation.ts +8 -3
  161. package/ts/fleet/interfaces.workers.ts +26 -7
  162. package/ts/functions.agentmessage.ts +3 -0
  163. package/ts/functions.deviceapi.ts +1292 -34
  164. package/ts/functions.exactpersistence.ts +5 -0
  165. package/ts/functions.fleetworkercli.ts +10 -7
  166. package/ts/functions.inferencecli.ts +2 -0
  167. package/ts/functions.mcpfleetworkertools.ts +2 -2
  168. package/ts/functions.ticketactor.ts +58 -14
  169. package/ts/functions.ticketvalidation.ts +11 -1
  170. package/ts/interfaces.auth.ts +8 -0
  171. package/ts/plugins.ts +7 -0
  172. package/ts_authswitch/authority-contract.ts +20 -0
  173. package/ts_authswitch/authority-overview.ts +28 -6
  174. package/ts_authswitch/authority-placement.ts +25 -17
  175. package/ts_authswitch/authority-renewal.ts +64 -0
  176. package/ts_authswitch/classes.authoritybroker.ts +34 -1
  177. package/ts_authswitch/classes.authoritycli.ts +49 -2
  178. package/ts_authswitch/classes.authorityclient.ts +14 -4
  179. package/ts_authswitch/classes.authoritydaemon.ts +9 -1
  180. package/ts_authswitch/classes.authoritydatabase.ts +5 -1
  181. package/ts_authswitch/classes.authoritymodels.ts +23 -3
  182. package/ts_authswitch/native-contracts.md +21 -0
  183. package/ts_authswitch/readme.md +1 -1
  184. package/ts_interfaces/devices.schema.json +3576 -603
  185. package/ts_interfaces/devices.ts +1111 -6
  186. package/ts_interfaces/fleetworkers.ts +38 -10
  187. package/ts_interfaces/inbox.ts +287 -0
  188. package/ts_interfaces/index.ts +1 -0
  189. package/ts_interfaces/interfaces.ts +9 -2
  190. package/ts_interfaces/mcprequests.ts +43 -4
  191. package/ts_interfaces/mcpworkspacerequests.ts +4 -2
  192. package/ts_interfaces/nativesessions.ts +17 -3
  193. package/ts_interfaces/plugins.ts +3 -1
  194. package/ts_interfaces/requests.accounts.ts +20 -0
  195. package/ts_interfaces/requests.ts +4 -0
  196. package/ts_interfaces/workercallers.ts +2 -0
  197. package/ts_migration/classes.documentmigrationrunner.ts +21 -0
  198. package/ts_migration/index.ts +1 -0
  199. package/ts_migration/v43_ticketactornames.ts +225 -0
  200. package/ts_web/00_commitinfo_data.ts +1 -1
  201. package/ts_web/accounts.plugins.ts +4 -2
  202. package/ts_web/classes.accountsreadmodel.ts +33 -0
  203. package/ts_web/classes.browserpresentation.ts +10 -5
  204. package/ts_web/classes.inboxfeed.ts +329 -0
  205. package/ts_web/classes.nativesessionstate.ts +9 -23
  206. package/ts_web/elements.accounts.ts +81 -0
  207. package/ts_web/elements.deployments.ts +66 -2
  208. package/ts_web/elements.fleetworker.ts +4 -2
  209. package/ts_web/elements.harnesscontrollerapp.ts +107 -37
  210. package/ts_web/elements.inbox.ts +808 -0
  211. package/ts_web/functions.inbox.ts +95 -0
  212. package/ts_web/functions.sessioncards.ts +40 -0
  213. package/ts_web/plugins.ts +2 -0
@@ -1,7 +1,113 @@
1
- import type { IControllerEvent, IControllerMessageBundle, IControllerPermission, IControllerQuestion, IControllerSessionFeedRow, TControllerElicitation, TControllerEventType, TControllerSessionFeedDelta } from '../dist_ts_interfaces/index.js';
2
- import { type IDeviceMessage, type IDevicePermission, type IDeviceQuestion, type IDeviceSessionFeedDelta, type IDeviceSessionRow, type IReq_DeviceAuthChallenge, type IReq_DeviceAuthProve, type IReq_DeviceElicitationReply, type IReq_DevicePair, type IReq_DevicePermissionReply, type IReq_DeviceQuestionReply, type IReq_DeviceSessionRead, type IReq_DeviceSessionSend, type TDeviceEvent, type TDeviceElicitation } from '../dist_ts_interfaces/devices.js';
1
+ import * as plugins from './plugins.js';
2
+ import { controllerOperationFailedErrorCode, type IControllerAuthorityProjection, type IControllerDevice, type IControllerDriverStatus, type IControllerEvent, type IControllerFleetWorkerView, type IControllerGatewayStatus, type IControllerInboxSnapshot, type IControllerMessageBundle, type IControllerPermission, type IControllerQuestion, type IControllerSessionFeedRow, type IDirectReportView, type IFleetDeployStatus, type IFleetDeployTicketPlacement, type IProxyCapacityAnswer, type ITicket, type ITicketBoard, type ITicketComment, type ITicketPerson, type ITicketQuestion, type TControllerAccountsAnswer, type TControllerAccountUsage, type TControllerElicitation, type TControllerEventType, type TControllerInboxDelta, type TControllerInboxItem, type TControllerSessionFeedDelta, type IFleetWorkerJob } from '../dist_ts_interfaces/index.js';
3
+ import { type IDeviceDirectReport, type IDeviceDriverStatus, type IDeviceHostAgl, type IDeviceHostDevice, type IDeviceHostUnavailable, type IDeviceInboxDelta, type IDeviceMessage, type IDevicePermission, type IDeviceTicketQuestion, type IReq_DeviceInboxList, type IReq_DeviceTicketAnswer, type TDeviceInboxItem, type IDeviceQuestion, type IDeviceSessionFeedDelta, type IDeviceSessionRow, type IDeviceTicket, type IDeviceTicketCard, type IDeviceTicketComment, type IDeviceTicketPerson, type IDeviceTicketPlacement, type IDeviceTicketPlans, type IReq_DeviceAuthChallenge, type IReq_DeviceAuthProve, type IReq_DeviceBoardList, type IReq_DeviceDirectReportMessage, type IReq_DeviceDriverRead, type IReq_DeviceDriverSend, type IReq_DeviceElicitationReply, type IReq_DeviceHostGet, type IReq_DevicePair, type IReq_DevicePermissionReply, type IReq_DeviceQuestionReply, type IReq_DeviceSessionRead, type IReq_DeviceSessionSend, type IReq_DeviceTicketAsk, type IReq_DeviceTicketComment, type IReq_DeviceTicketGet, type IReq_DeviceTicketMove, type TDeviceEvent, type TDeviceElicitation, type TDeviceRefusalCode } from '../dist_ts_interfaces/devices.js';
4
+ import { type DriverService, type IDriverNeedsInput } from './driver/classes.driverservice.js';
5
+ import type { TAuthErrorCode } from './interfaces.auth.js';
6
+ import { type TConfigurationErrorCode } from './configuration/classes.configurationerror.js';
7
+ import type { ControllerElicitationReplyError } from './functions.elicitation.js';
8
+ import type { FleetNativeTurnError } from './fleet/interfaces.workers.js';
3
9
  /** The controller events a device receives, each projected by `deviceEvent`; every other event never reaches one. */
4
10
  export declare const deviceRelayedEventTypes: ReadonlySet<TControllerEventType>;
11
+ /** Every refusal code of the device contract, once: what a device request may be refused with as it is. */
12
+ export declare const deviceRefusalCodes: ReadonlySet<string>;
13
+ /**
14
+ * Every code the controller refuses a device's request with before the device error translation: the codes of the
15
+ * typed errors `asTypedResponseError` passes on as their own (the auth store's, the configuration authority's, an
16
+ * elicitation reply's, a native Codex turn's), the codes it gives the others (`controller_operation_failed` for a fault
17
+ * under a failure journal reference), and the codes the browser's shared functions a device runs refuse with (session
18
+ * reads and sends, native sessions, answers, direct children).
19
+ */
20
+ export type TControllerRefusalCode = TAuthErrorCode | TConfigurationErrorCode | ControllerElicitationReplyError['code'] | FleetNativeTurnError['code'] | typeof controllerOperationFailedErrorCode | 'concurrent_change' | 'operation_limit' | 'session_not_found' | 'outcome_unknown' | 'flex_not_ready' | 'flex_operation_failed' | 'flex_projection_not_found' | 'flex_projection_cursor_invalid' | 'flex_projection_invalid' | 'controller_unavailable' | 'invalid_request' | 'rate_limited' | 'session_read_only' | 'project_not_found' | 'harness_unavailable' | 'native_session_failed' | 'not_found' | 'child_scope_invalid' | 'model_not_found' | 'model_harness_mismatch' | 'attachments_unsupported' | 'message_rate_limited';
21
+ /** A controller refusal's device code, by its code alone or, where its data says more, by its data. */
22
+ type TDeviceRefusalOf = TDeviceRefusalCode | ((errorDataArg: Readonly<Record<string, unknown>>) => TDeviceRefusalCode);
23
+ /**
24
+ * How every controller code outside the device contract reaches a device: the one table the device error translation
25
+ * reads, so the compiler names every code a new controller refusal adds before a device can meet it. A state of the
26
+ * controller is `controller_unavailable`; a race AGL lost before it acted `concurrent_change`; a dispatch that may have
27
+ * happened `outcome_unknown`; a session the device can no longer reach `session_not_found`; a refusal the owner resolves
28
+ * in the browser `session_read_only`; and a fault, or a refusal of a request no device makes, `controller_failed` with
29
+ * the failure journal's reference.
30
+ */
31
+ export declare const deviceControllerRefusals: Readonly<Record<Exclude<TControllerRefusalCode, TDeviceRefusalCode>, TDeviceRefusalOf>>;
32
+ /**
33
+ * The device error translation: the refusal a device receives for the typed refusal `typedArg` the controller answers
34
+ * `causeArg` with, always a code of the device contract. A contract code passes as it is; every other code maps through
35
+ * `deviceControllerRefusals`, with the controller's message, or the device code's own sentence where that message may
36
+ * carry a raw cause (`deviceRawTextCodes`). A fault, and a code the table does not know, is `controller_failed` with one
37
+ * fixed sentence and the failure journal's reference: the controller's own when it kept the cause, else one recorded
38
+ * here for `methodArg`.
39
+ */
40
+ export declare const deviceContractError: (typedArg: plugins.typedrequest.TypedResponseError, causeArg: unknown, methodArg: string) => plugins.typedrequest.TypedResponseError;
41
+ /**
42
+ * Runs a device's driver request and answers its failures in the device contract: a driver error by its device code,
43
+ * and a driver project or session that went away after the status named it as `driver_absent`. Every other failure is
44
+ * the session read's or send's own, as `device.session.read` and `device.session.send` answer it.
45
+ */
46
+ export declare const serveDeviceDriver: <T>(operationArg: () => Promise<T>) => Promise<T>;
47
+ /**
48
+ * A failure of the owner's message to a direct report, in the device contract: another Codex client's turn is
49
+ * `direct_report_busy` (a device reads no turn to name), the agent message rate `rate_limited` (final, as for every
50
+ * device request), and every other refusal outside the contract `direct_report_failed` with its text and the failure
51
+ * journal's reference, where AGL kept the cause; a refusal whose message may carry a raw cause (`deviceRawTextCodes`)
52
+ * reads `deviceRefusalSentences.direct_report_failed` instead, its message kept in the failure journal. Other failures
53
+ * are answered as `serveDirectReport` answers them.
54
+ */
55
+ export declare const deviceDirectReportMessageRefusal: (errorArg: unknown) => unknown;
56
+ /**
57
+ * A device's refusal of its message to a direct report whose fleet job failed. A job that may have delivered the
58
+ * message (`IFleetWorkerJob.errorOutcome` other than `refused`: the steer failed after its dispatch, or nothing proves
59
+ * it did not) is `outcome_unknown`, which a client never sends again on its own, never `direct_report_failed`, which
60
+ * says the report took no message. A job that sent nothing is `direct_report_failed`: a refusal the fleet wrote itself
61
+ * (`errorCode`) with its text, any other with the controller's generic sentence. Where the device does not read the
62
+ * job's error, the failure journal keeps it under the reference the message ends with, as the Driver view shows it.
63
+ */
64
+ export declare const deviceDirectReportJobRefusal: (jobArg: IFleetWorkerJob) => plugins.typedrequest.TypedResponseError;
65
+ /**
66
+ * A refusal of a device's ticket request in the device contract, whether the store's own (`TicketError`) or as the
67
+ * browser's ticket functions answer it: the store's codes `deviceTicketRefusalCodes` lists as they are, with the
68
+ * store's reason, and its other codes by `deviceTicketStoreRefusals`. Every other failure is answered as any device
69
+ * request's.
70
+ */
71
+ export declare const deviceTicketRefusal: (errorArg: unknown) => unknown;
72
+ /** What a device event reads of the driver as it is sent: the controller's `DriverService`. */
73
+ export type TDeviceDriverSource = Pick<DriverService, 'isSessionChange' | 'current' | 'needsInput'>;
74
+ /**
75
+ * The driver's status as a device sees it: no project, no session, no failure or limit text. The `needs input:` line
76
+ * only while it is what the status's `needs_input` stands for.
77
+ */
78
+ export declare const deviceDriverStatus: (statusArg: IControllerDriverStatus, needsInputArg: IDriverNeedsInput | undefined) => IDeviceDriverStatus;
79
+ /**
80
+ * A direct report as a device sees it, with the fleet workers that report to it: named, never by the report's stored
81
+ * id (which holds the configuration authority's id); the workers without their directories or profiles.
82
+ */
83
+ export declare const deviceDirectReport: (viewArg: IDirectReportView, workersArg: readonly IControllerFleetWorkerView[]) => IDeviceDirectReport;
84
+ /**
85
+ * The AGL that runs, as a device sees it: its release, its start, its public origin, and how a device reaches it --
86
+ * through the gateway AGL keeps its route on, with where that route's sync stands (never the gateway's address, the
87
+ * client AGL is there or the route's target), or through the owner's own reverse proxy while AGL is enrolled with no
88
+ * gateway.
89
+ */
90
+ export declare const deviceHostAgl: (aglArg: {
91
+ version: string;
92
+ startedAt: number;
93
+ origin: string;
94
+ gateway: IControllerGatewayStatus | undefined;
95
+ }) => IDeviceHostAgl;
96
+ /** A device's own record as it reads it: no id, key or fingerprint, and nothing it could change. */
97
+ export declare const deviceHostDevice: (deviceArg: IControllerDevice) => IDeviceHostDevice;
98
+ /** What `device.host.get` reads besides the AGL and the device, each section from its owner. */
99
+ export interface IDeviceHostSources {
100
+ /** The deploy monitor's status of every target, as the Deployments view reads it; never a probe. */
101
+ deployStatus: () => Promise<IFleetDeployStatus>;
102
+ /** The inference proxy's pools; absent while no proxy runs here. */
103
+ capacity: ((signalArg: AbortSignal) => Promise<IProxyCapacityAnswer>) | undefined;
104
+ /** The accounts service as the controller holds it. */
105
+ authority: () => IControllerAuthorityProjection;
106
+ /** The usage the accounts service holds for one login; it reads no provider for it. */
107
+ usage: (accountIdArg: string, loginIdArg: string, signalArg: AbortSignal) => Promise<TControllerAccountsAnswer<TControllerAccountUsage>>;
108
+ }
109
+ /** The host's deploy targets, account pools and API keys, read at once and each on its own. */
110
+ export declare const readDeviceHostSections: (sourcesArg: IDeviceHostSources, nowArg: number, signalArg: AbortSignal) => Promise<Pick<IReq_DeviceHostGet['response'], 'deploys' | 'pools' | 'apiKeys'>>;
5
111
  /** A feed row as a device sees it; none for a terminal row, which a device does not open. */
6
112
  export declare const deviceSessionRow: (rowArg: IControllerSessionFeedRow) => IDeviceSessionRow | undefined;
7
113
  export declare const deviceSessionRows: (rowsArg: readonly IControllerSessionFeedRow[]) => IDeviceSessionRow[];
@@ -12,19 +118,107 @@ export declare const deviceMessages: (bundlesArg: readonly IControllerMessageBun
12
118
  export declare const devicePermissions: (permissionsArg: readonly IControllerPermission[]) => IDevicePermission[];
13
119
  export declare const deviceQuestions: (questionsArg: readonly IControllerQuestion[]) => IDeviceQuestion[];
14
120
  export declare const deviceElicitations: (elicitationsArg: readonly TControllerElicitation[]) => TDeviceElicitation[];
15
- /** A controller event as a device receives it, or none. `rowOfArg` answers the feed's published rows. */
16
- export declare const deviceEvent: (eventArg: IControllerEvent, rowOfArg: (rowIdArg: string) => IControllerSessionFeedRow | undefined) => TDeviceEvent | undefined;
121
+ /** A ticket question as a device answers it: its options by id, and who asked and answered by name. */
122
+ export declare const deviceTicketQuestion: (questionArg: ITicketQuestion) => IDeviceTicketQuestion;
123
+ /**
124
+ * What a device's ticket views read besides the tickets: the owner's principal id (`owner:<webauthnUserId>`), which
125
+ * names the owner's account and never reaches a device, and the session feed's published rows.
126
+ */
127
+ export interface IDeviceTicketViewer {
128
+ ownerId: string;
129
+ rowOf: (rowIdArg: string) => IControllerSessionFeedRow | undefined;
130
+ }
131
+ /**
132
+ * A person on a ticket as a device sees it: by name and kind, the owner as `kind` `owner` (never the owner's principal
133
+ * id), and a session only as the session feed names it while the feed lists it for devices, so never the driver's own
134
+ * session or one the feed does not list. A person's id never reaches a device.
135
+ */
136
+ export declare const deviceTicketPerson: (personArg: ITicketPerson, viewerArg: IDeviceTicketViewer) => IDeviceTicketPerson;
137
+ /** A ticket as a device's card shows it; `parentArg` is the ticket its `parentId` names, when read. */
138
+ export declare const deviceTicketCard: (ticketArg: ITicket, parentArg: ITicket | undefined, viewerArg: IDeviceTicketViewer) => IDeviceTicketCard;
139
+ /**
140
+ * A ticket as a device's detail shows it: its card, description, source words, evidence and parent; never its source
141
+ * attachments, its plans' questions, who created or last changed it, or its permissions.
142
+ */
143
+ export declare const deviceTicket: (ticketArg: ITicket, parentArg: ITicket | undefined, viewerArg: IDeviceTicketViewer) => IDeviceTicket;
144
+ export declare const deviceTicketComment: (commentArg: ITicketComment, viewerArg: IDeviceTicketViewer) => IDeviceTicketComment;
145
+ /**
146
+ * One column of the board as `device.board.list` answers it, from one read of the whole board (`board`): the tasks the
147
+ * store's own filters (`ticketFilter`: text and project) and the board's narrowing (`ticketBoardNarrows`: epic,
148
+ * assignee, AutoLabel) let through, as the browser's board shows its cards, counted per column, and the page of the
149
+ * requested column in the column's order; the projects and the epics a filter may choose, as the browser's board
150
+ * offers them (the epics in the chosen project, their own or one of their tasks', and the chosen epic).
151
+ */
152
+ export declare const deviceBoardPage: (boardArg: ITicketBoard, requestArg: IReq_DeviceBoardList['request'], viewerArg: IDeviceTicketViewer) => IReq_DeviceBoardList['response'];
153
+ /**
154
+ * One page of a ticket's discussion, its comments and questions together in the order they were written: those
155
+ * before the entry `before` names (`c:<comment id>` or `q:<question id>`, as a page returned it), or the newest, at
156
+ * most `limit` and `deviceTicketDiscussionPage.bytes` of them as JSON but at least one, each list oldest first, and the
157
+ * cursor of the next older page, `null` at the first entry. A `before` that names no entry is refused.
158
+ */
159
+ export declare const deviceTicketDiscussion: (commentsArg: readonly ITicketComment[], questionsArg: readonly ITicketQuestion[], pageArg: {
160
+ before?: string;
161
+ limit?: number;
162
+ }, viewerArg: IDeviceTicketViewer) => Pick<IReq_DeviceTicketGet['response'], 'comments' | 'questions' | 'before'>;
163
+ /** Where a ticket's work runs as a device sees it: the deploy monitor's placement, the targets by id and name. */
164
+ export declare const deviceTicketPlacement: (placementArg: IFleetDeployTicketPlacement) => IDeviceTicketPlacement;
165
+ /**
166
+ * What a ticket plans, from the ticket itself: its release plan, its maintenance window and its deploy plan; while the
167
+ * deploy monitor answered (`placementArg`), where the window stands and the owner's go on it and on the deploy. Never a
168
+ * plan's question or who deploys it.
169
+ */
170
+ export declare const deviceTicketPlans: (ticketArg: ITicket, placementArg: IFleetDeployTicketPlacement | undefined) => IDeviceTicketPlans;
171
+ /** A ticket's placement for `device.ticket.get`, read on its own as a section of `device.host.get` is. */
172
+ export declare const readDeviceTicketPlacement: (readArg: () => Promise<IFleetDeployTicketPlacement>, signalArg: AbortSignal) => Promise<{
173
+ placement: IDeviceTicketPlacement | IDeviceHostUnavailable;
174
+ observed: IFleetDeployTicketPlacement | undefined;
175
+ }>;
176
+ /** An Inbox item as a device sees it: the same item without host paths, in the device protocol's shapes. */
177
+ export declare const deviceInboxItem: (itemArg: TControllerInboxItem, rowOfArg: (rowIdArg: string) => IControllerSessionFeedRow | undefined) => TDeviceInboxItem;
178
+ /** The Inbox as `device.inbox.list` answers it. */
179
+ export declare const deviceInboxList: (snapshotArg: IControllerInboxSnapshot, rowOfArg: (rowIdArg: string) => IControllerSessionFeedRow | undefined) => IReq_DeviceInboxList['response'];
180
+ /** An Inbox change as a device applies it: the same epoch, revision and order. */
181
+ export declare const deviceInboxDelta: (deltaArg: TControllerInboxDelta, rowOfArg: (rowIdArg: string) => IControllerSessionFeedRow | undefined) => IDeviceInboxDelta;
182
+ /**
183
+ * A controller event as a device receives it: none, one, or several in the order they are sent (a ticket change is
184
+ * the board's, the direct reports' and the host's). `rowOfArg` answers the feed's published rows; `driverArg` the driver as it
185
+ * is now, whose own session changes reach a device as `driver.changed` (never its streamed content).
186
+ */
187
+ export declare const deviceEvent: (eventArg: IControllerEvent, rowOfArg: (rowIdArg: string) => IControllerSessionFeedRow | undefined, driverArg: TDeviceDriverSource | undefined) => readonly TDeviceEvent[];
17
188
  export declare const assertDevicePairRequest: (valueArg: unknown) => IReq_DevicePair['request'];
18
189
  export declare const assertDeviceAuthChallengeRequest: (valueArg: unknown) => IReq_DeviceAuthChallenge['request'];
19
190
  export declare const assertDeviceAuthProveRequest: (valueArg: unknown) => IReq_DeviceAuthProve['request'];
20
191
  export declare const assertDeviceSessionReadRequest: (valueArg: unknown) => IReq_DeviceSessionRead['request'];
21
192
  export declare const assertDeviceSessionSendRequest: (valueArg: unknown) => IReq_DeviceSessionSend['request'];
193
+ export declare const assertDeviceDriverReadRequest: (valueArg: unknown) => IReq_DeviceDriverRead['request'];
194
+ export declare const assertDeviceDriverSendRequest: (valueArg: unknown) => IReq_DeviceDriverSend['request'];
195
+ /** A device's message to a direct report, in shape; the Driver view's own rules check the name and the text. */
196
+ export declare const assertDeviceDirectReportMessageRequest: (valueArg: unknown) => IReq_DeviceDirectReportMessage['request'];
22
197
  export declare const assertDevicePermissionReplyRequest: (valueArg: unknown) => IReq_DevicePermissionReply['request'];
23
198
  export declare const assertDeviceQuestionReplyRequest: (valueArg: unknown) => IReq_DeviceQuestionReply['request'];
24
199
  export declare const assertDeviceElicitationReplyRequest: (valueArg: unknown) => IReq_DeviceElicitationReply['request'];
200
+ /**
201
+ * A ticket answer of a device, in shape: the ticket by key, the question, option ids and text. The ticket store's own
202
+ * rules (`assertTicketRequest`) check the values as for the browser.
203
+ */
204
+ export declare const assertDeviceTicketAnswerRequest: (valueArg: unknown) => IReq_DeviceTicketAnswer['request'];
205
+ /**
206
+ * A page of the board a device asks for: a column, the board's filters (text 1 to 200 characters, a project, an epic, an
207
+ * assignee, an AutoLabel) and `limit` (1 to 100) tickets from `offset`. The store's own rules check the text and the
208
+ * project as for every listing (`assertTicketRequest('board')`).
209
+ */
210
+ export declare const assertDeviceBoardListRequest: (valueArg: unknown) => IReq_DeviceBoardList['request'];
211
+ /** A ticket a device opens, and the page of its discussion: the `before` of a newer page, and 1 to 50 entries. */
212
+ export declare const assertDeviceTicketGetRequest: (valueArg: unknown) => IReq_DeviceTicketGet['request'];
213
+ /** A device's comment: 1 to 64 KiB of UTF-8, not blank. The store's own rules check it as the browser's. */
214
+ export declare const assertDeviceTicketCommentRequest: (valueArg: unknown) => IReq_DeviceTicketComment['request'];
215
+ /** A device's question: text alone, 1 to 16 KiB of UTF-8, not blank. The store's own rules check it as the browser's. */
216
+ export declare const assertDeviceTicketAskRequest: (valueArg: unknown) => IReq_DeviceTicketAsk['request'];
217
+ export declare const assertDeviceTicketMoveRequest: (valueArg: unknown) => IReq_DeviceTicketMove['request'];
25
218
  export declare const assertDevicePairingCancelRequest: (valueArg: unknown) => {
26
219
  pairingId: string;
27
220
  };
28
221
  export declare const assertDeviceRevokeRequest: (valueArg: unknown) => {
29
222
  deviceId: string;
30
223
  };
224
+ export {};