agl 42.0.0 → 42.2.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.
Files changed (168) hide show
  1. package/changelog.md +44 -0
  2. package/dist_serve/bundle.js +2520 -2158
  3. package/dist_serve/bundle.js.map +2 -2
  4. package/dist_ts/00_commitinfo_data.js +1 -1
  5. package/dist_ts/aglapi/aglapisurface.document.js +124 -10
  6. package/dist_ts/classes.accountsactions.d.ts +3 -1
  7. package/dist_ts/classes.accountsactions.js +16 -1
  8. package/dist_ts/classes.authstore.d.ts +2 -0
  9. package/dist_ts/classes.authstore.js +58 -17
  10. package/dist_ts/classes.cli.js +19 -49
  11. package/dist_ts/classes.configurationauthority.js +2 -2
  12. package/dist_ts/classes.controller.d.ts +71 -2
  13. package/dist_ts/classes.controller.js +500 -113
  14. package/dist_ts/classes.controllerdevices.d.ts +128 -0
  15. package/dist_ts/classes.controllerdevices.js +472 -0
  16. package/dist_ts/classes.controllerservice.d.ts +20 -2
  17. package/dist_ts/classes.controllerservice.js +42 -6
  18. package/dist_ts/classes.flexservice.js +8 -3
  19. package/dist_ts/classes.inferencegateway.d.ts +30 -2
  20. package/dist_ts/classes.inferencegateway.js +115 -20
  21. package/dist_ts/classes.inferencerouter.d.ts +16 -0
  22. package/dist_ts/classes.inferencerouter.js +5 -3
  23. package/dist_ts/classes.inferenceservice.js +7 -3
  24. package/dist_ts/classes.sessionfeed.d.ts +10 -1
  25. package/dist_ts/classes.sessionfeed.js +12 -2
  26. package/dist_ts/classes.ticketmodels.js +4 -3
  27. package/dist_ts/classes.ticketnotifier.js +9 -2
  28. package/dist_ts/classes.ticketstore.js +9 -5
  29. package/dist_ts/classes.upgradecoordinator.d.ts +6 -1
  30. package/dist_ts/classes.upgradecoordinator.js +9 -2
  31. package/dist_ts/classes.upgradetransaction.d.ts +27 -1
  32. package/dist_ts/classes.upgradetransaction.js +92 -2
  33. package/dist_ts/classes.validation.d.ts +2 -0
  34. package/dist_ts/classes.validation.js +2 -2
  35. package/dist_ts/configuration/functions.master.d.ts +7 -2
  36. package/dist_ts/configuration/functions.master.js +7 -4
  37. package/dist_ts/driver/classes.drivereventrelay.d.ts +1 -1
  38. package/dist_ts/driver/classes.drivereventrelay.js +3 -3
  39. package/dist_ts/fleet/classes.boardpump.d.ts +1 -1
  40. package/dist_ts/fleet/classes.boardpump.js +7 -4
  41. package/dist_ts/fleet/classes.claudeworkers.d.ts +6 -0
  42. package/dist_ts/fleet/classes.claudeworkers.js +17 -7
  43. package/dist_ts/fleet/classes.deploymodels.d.ts +19 -0
  44. package/dist_ts/fleet/classes.deploymodels.js +140 -0
  45. package/dist_ts/fleet/functions.validation.d.ts +8 -1
  46. package/dist_ts/fleet/functions.validation.js +65 -3
  47. package/dist_ts/fleet/interfaces.workers.d.ts +6 -0
  48. package/dist_ts/fleet/interfaces.workers.js +65 -2
  49. package/dist_ts/functions.deviceapi.d.ts +28 -0
  50. package/dist_ts/functions.deviceapi.js +246 -0
  51. package/dist_ts/functions.deviceproof.d.ts +33 -0
  52. package/dist_ts/functions.deviceproof.js +93 -0
  53. package/dist_ts/functions.fleetworkercli.d.ts +16 -3
  54. package/dist_ts/functions.fleetworkercli.js +21 -7
  55. package/dist_ts/functions.inferencecli.js +4 -2
  56. package/dist_ts/functions.mcptickettools.d.ts +1 -0
  57. package/dist_ts/functions.remotecli.d.ts +1 -1
  58. package/dist_ts/functions.remotecli.js +12 -7
  59. package/dist_ts/functions.ticketvalidation.d.ts +36 -3
  60. package/dist_ts/functions.ticketvalidation.js +45 -14
  61. package/dist_ts/interfaces.auth.d.ts +1 -1
  62. package/dist_ts/interfaces.auth.js +7 -1
  63. package/dist_ts_authswitch/authority-contract.d.ts +23 -0
  64. package/dist_ts_authswitch/authority-contract.js +1 -1
  65. package/dist_ts_authswitch/classes.authoritybroker.d.ts +6 -0
  66. package/dist_ts_authswitch/classes.authoritybroker.js +31 -4
  67. package/dist_ts_authswitch/classes.authoritycli.d.ts +1 -0
  68. package/dist_ts_authswitch/classes.authoritycli.js +26 -1
  69. package/dist_ts_authswitch/classes.authorityclient.d.ts +3 -1
  70. package/dist_ts_authswitch/classes.authorityclient.js +10 -4
  71. package/dist_ts_authswitch/classes.authoritydaemon.js +7 -1
  72. package/dist_ts_authswitch/classes.authorityimport.js +2 -2
  73. package/dist_ts_authswitch/classes.authoritymodels.d.ts +3 -0
  74. package/dist_ts_authswitch/classes.authoritymodels.js +10 -3
  75. package/dist_ts_authswitch/testsupport.js +4 -4
  76. package/dist_ts_authswitch/ts_migration/0012_account_claude_code.d.ts +11 -0
  77. package/dist_ts_authswitch/ts_migration/0012_account_claude_code.js +18 -0
  78. package/dist_ts_authswitch/ts_migration/index.js +3 -1
  79. package/dist_ts_interfaces/deployments.d.ts +104 -0
  80. package/dist_ts_interfaces/deployments.js +8 -0
  81. package/dist_ts_interfaces/devices.d.ts +331 -0
  82. package/dist_ts_interfaces/devices.js +34 -0
  83. package/dist_ts_interfaces/fleet.d.ts +2 -0
  84. package/dist_ts_interfaces/index.d.ts +3 -0
  85. package/dist_ts_interfaces/index.js +4 -1
  86. package/dist_ts_interfaces/interfaces.d.ts +4 -2
  87. package/dist_ts_interfaces/interfaces.js +3 -2
  88. package/dist_ts_interfaces/mcprequests.d.ts +1 -1
  89. package/dist_ts_interfaces/requests.accounts.d.ts +18 -0
  90. package/dist_ts_interfaces/requests.accounts.js +1 -1
  91. package/dist_ts_interfaces/requests.d.ts +3 -2
  92. package/dist_ts_interfaces/requests.devices.d.ts +89 -0
  93. package/dist_ts_interfaces/requests.devices.js +2 -0
  94. package/dist_ts_interfaces/requests.js +1 -1
  95. package/dist_ts_interfaces/tickets.d.ts +53 -4
  96. package/dist_ts_interfaces/tickets.js +6 -2
  97. package/dist_ts_migration/index.d.ts +1 -0
  98. package/dist_ts_migration/index.js +2 -1
  99. package/dist_ts_migration/v41_ticketmigrationmarkers.d.ts +19 -0
  100. package/dist_ts_migration/v41_ticketmigrationmarkers.js +85 -0
  101. package/docs/authswitch.md +6 -0
  102. package/package.json +5 -5
  103. package/readme.md +84 -16
  104. package/ts/00_commitinfo_data.ts +1 -1
  105. package/ts/aglapi/aglapisurface.document.ts +123 -9
  106. package/ts/classes.accountsactions.ts +24 -0
  107. package/ts/classes.authstore.ts +54 -14
  108. package/ts/classes.cli.ts +17 -54
  109. package/ts/classes.configurationauthority.ts +1 -1
  110. package/ts/classes.controller.ts +697 -167
  111. package/ts/classes.controllerdevices.ts +469 -0
  112. package/ts/classes.controllerservice.ts +49 -6
  113. package/ts/classes.flexservice.ts +7 -2
  114. package/ts/classes.inferencegateway.ts +133 -19
  115. package/ts/classes.inferencerouter.ts +20 -2
  116. package/ts/classes.inferenceservice.ts +6 -3
  117. package/ts/classes.sessionfeed.ts +13 -1
  118. package/ts/classes.ticketmodels.ts +3 -2
  119. package/ts/classes.ticketnotifier.ts +8 -1
  120. package/ts/classes.ticketstore.ts +8 -4
  121. package/ts/classes.upgradecoordinator.ts +14 -4
  122. package/ts/classes.upgradetransaction.ts +118 -0
  123. package/ts/classes.validation.ts +1 -1
  124. package/ts/configuration/functions.master.ts +6 -3
  125. package/ts/driver/classes.drivereventrelay.ts +2 -2
  126. package/ts/fleet/classes.boardpump.ts +7 -4
  127. package/ts/fleet/classes.claudeworkers.ts +16 -6
  128. package/ts/fleet/classes.deploymodels.ts +44 -0
  129. package/ts/fleet/functions.validation.ts +50 -2
  130. package/ts/fleet/interfaces.workers.ts +56 -1
  131. package/ts/functions.deviceapi.ts +295 -0
  132. package/ts/functions.deviceproof.ts +118 -0
  133. package/ts/functions.fleetworkercli.ts +26 -8
  134. package/ts/functions.inferencecli.ts +3 -1
  135. package/ts/functions.remotecli.ts +11 -5
  136. package/ts/functions.ticketvalidation.ts +48 -13
  137. package/ts/interfaces.auth.ts +6 -0
  138. package/ts_authswitch/authority-contract.ts +18 -0
  139. package/ts_authswitch/classes.authoritybroker.ts +29 -3
  140. package/ts_authswitch/classes.authoritycli.ts +29 -0
  141. package/ts_authswitch/classes.authorityclient.ts +12 -4
  142. package/ts_authswitch/classes.authoritydaemon.ts +8 -1
  143. package/ts_authswitch/classes.authorityimport.ts +1 -1
  144. package/ts_authswitch/classes.authoritymodels.ts +5 -1
  145. package/ts_authswitch/native-contracts.md +10 -0
  146. package/ts_authswitch/testsupport.ts +3 -3
  147. package/ts_authswitch/ts_migration/0012_account_claude_code.ts +17 -0
  148. package/ts_authswitch/ts_migration/index.ts +2 -0
  149. package/ts_interfaces/deployments.ts +98 -0
  150. package/ts_interfaces/devices.schema.json +890 -0
  151. package/ts_interfaces/devices.ts +392 -0
  152. package/ts_interfaces/fleet.ts +2 -0
  153. package/ts_interfaces/index.ts +3 -0
  154. package/ts_interfaces/interfaces.ts +4 -1
  155. package/ts_interfaces/mcprequests.ts +1 -1
  156. package/ts_interfaces/requests.accounts.ts +16 -0
  157. package/ts_interfaces/requests.devices.ts +95 -0
  158. package/ts_interfaces/requests.ts +12 -0
  159. package/ts_interfaces/tickets.ts +34 -4
  160. package/ts_migration/index.ts +1 -0
  161. package/ts_migration/v41_ticketmigrationmarkers.ts +28 -0
  162. package/ts_web/00_commitinfo_data.ts +1 -1
  163. package/ts_web/classes.accountsreadmodel.ts +12 -1
  164. package/ts_web/classes.controllersocketclient.ts +27 -0
  165. package/ts_web/elements.accounts.ts +44 -0
  166. package/ts_web/elements.devices.ts +752 -0
  167. package/ts_web/elements.harnesscontrollerapp.ts +18 -1
  168. package/ts_web/elements.ticketboard.ts +15 -4
@@ -160,6 +160,10 @@ export declare class OpenCodeController {
160
160
  private pendingFlexMessageEventBytes;
161
161
  private flexControllerEventDrainTask?;
162
162
  private controllerEventDelivery?;
163
+ /** Every authenticated device connection's own ordered event queue, of the events a device receives. */
164
+ private deviceEventDelivery?;
165
+ /** The paired devices, their pairing codes and authenticated connections; open while the controller runs. */
166
+ private devices?;
163
167
  private flexAutoAcceptDrainTask?;
164
168
  /** Sweeps whose auto-accept failed, queued again when the retry timer fires. */
165
169
  private readonly failedFlexAutoAcceptSweeps;
@@ -1042,12 +1046,43 @@ export declare class OpenCodeController {
1042
1046
  private recordPeerLogout;
1043
1047
  private performStop;
1044
1048
  /**
1045
- * Composes the three auth scopes. A handler is guarded by the scope router it is
1049
+ * Composes the five auth scopes. A handler is guarded by the scope router it is
1046
1050
  * registered on and by nothing else, so each `register*Handlers` method is handed
1047
1051
  * exactly one scope here, and test/test.routerscopes.node.ts freezes the resulting
1048
- * method-to-scope table.
1052
+ * method-to-scope table. A paired device reaches only `devicePairing` (before it is
1053
+ * authenticated) and `device`; it never reaches `protected`.
1049
1054
  */
1050
1055
  private createRouter;
1056
+ private requireDevices;
1057
+ private requireSessionFeed;
1058
+ /**
1059
+ * Runs a device's request under the connection's operation budget and abort signal, which revoking the device
1060
+ * aborts. `deviceIdArg` names the authenticated device: its requests share one budget across its connections, count
1061
+ * against the authenticated rate limit and are audited as `device:<id>`.
1062
+ */
1063
+ private runDeviceOperation;
1064
+ /** The authenticated device of a request in the `device` scope, which its middleware checked. */
1065
+ private requestDevice;
1066
+ /** The session a device names, as the session feed lists it now: a conversation or a native session, never a terminal. */
1067
+ private deviceSessionTarget;
1068
+ /**
1069
+ * Scope `devicePairing`: what a device asks before it is authenticated -- the protocol version, pairing with a QR
1070
+ * code, and the challenge and proof that authenticate a connection. Every request counts against the
1071
+ * unauthenticated preflight budget; a pairing and a proof are audited, under the unauthenticated audit budget.
1072
+ */
1073
+ private registerDevicePairingHandlers;
1074
+ /**
1075
+ * Scope `device`: the session feed, bounded transcript reads, direct sends and permission and question answers of an
1076
+ * authenticated device -- through the same operations the owner's browser runs, audited as `device:<id>`.
1077
+ */
1078
+ private registerDeviceHandlers;
1079
+ /**
1080
+ * The owner's side of the devices, in Settings → Devices: the list, the single-use pairing code of the QR, and
1081
+ * revoking a device, which closes its live connections with 4403 at once.
1082
+ */
1083
+ private registerDevicesHandlers;
1084
+ /** Ends a revoked device's connection: its requests in flight are aborted, and it is closed with 4403. */
1085
+ private closeRevokedDevicePeer;
1051
1086
  /** Public scope: a browser reads the status before it holds a passkey session. */
1052
1087
  private registerStatusHandlers;
1053
1088
  /**
@@ -1097,6 +1132,16 @@ export declare class OpenCodeController {
1097
1132
  * are scoped through their parent session and live with the session handlers.
1098
1133
  */
1099
1134
  private registerPromptReplyHandlers;
1135
+ /**
1136
+ * Answers a permission request of a conversation, for the owner's browser and a paired device alike: the request must
1137
+ * be pending in the session, and the harness that owns it takes the answer.
1138
+ */
1139
+ private replyPermissionForPrincipal;
1140
+ /**
1141
+ * Answers a question of a conversation, for the owner's browser and a paired device alike; `null` rejects it. The
1142
+ * question must be pending in the session. Questions are never answered automatically.
1143
+ */
1144
+ private replyQuestionForPrincipal;
1100
1145
  private registerResourceHandlers;
1101
1146
  private registerBrowserHandlers;
1102
1147
  private registerTicketHandlers;
@@ -1154,6 +1199,16 @@ export declare class OpenCodeController {
1154
1199
  * with that reason.
1155
1200
  */
1156
1201
  private registerNativeSessionHandlers;
1202
+ /**
1203
+ * A native session, a bounded page of its transcript and what AGL's own turns in it wait for, for the owner's browser
1204
+ * and a paired device alike. The session resolves only through what the session feed's sources list.
1205
+ */
1206
+ private readNativeSessionForPrincipal;
1207
+ /**
1208
+ * Answers a permission (`permission`) or a question (`answers`, `null` rejects it) of AGL's own turn in a native
1209
+ * session, for the owner's browser and a paired device alike. The request must still be pending.
1210
+ */
1211
+ private replyNativeSessionForPrincipal;
1157
1212
  /** The requests of AGL's own turns in a native session that wait for an answer. */
1158
1213
  private nativeSessionAttention;
1159
1214
  private replyNativeSessionRequest;
@@ -1524,6 +1579,12 @@ export declare class OpenCodeController {
1524
1579
  private childScopeBindingKey;
1525
1580
  private childScopeParentKey;
1526
1581
  private childScopeCredentialId;
1582
+ /**
1583
+ * A connection is either the owner's browser or a device, never both: every browser sign-in step (setup, passkey,
1584
+ * temporary password, resume) refuses a connection a device authenticated, before it reads or consumes anything, as
1585
+ * `device.auth.prove` refuses a connection signed in as the browser.
1586
+ */
1587
+ private refuseDevicePeerSignIn;
1527
1588
  private setAuthenticatedPeerCredential;
1528
1589
  /** Takes the authentication of a live connection away; its socket stays open. */
1529
1590
  private signOutPeer;
@@ -2261,6 +2322,12 @@ export declare class OpenCodeController {
2261
2322
  * holds the event, never on an acknowledgement.
2262
2323
  */
2263
2324
  private pushControllerEvent;
2325
+ /**
2326
+ * Every authenticated device connection's own ordered event queue, created with the first event a device receives:
2327
+ * the queues and their collapse rules are the browsers', the limits smaller, and each event is projected to the
2328
+ * device's shape (`deviceEvent`) as it is sent, so a session the feed does not list reaches no device.
2329
+ */
2330
+ private deviceEventDeliveryQueues;
2264
2331
  private runUpgradePreparationAdmission;
2265
2332
  private upgradePreparationReplayIsAccepted;
2266
2333
  private createUpgradePreparationContext;
@@ -2296,6 +2363,8 @@ export declare class OpenCodeController {
2296
2363
  private isFlexPromptAdmissionTerminated;
2297
2364
  private assertStartActive;
2298
2365
  private runOperation;
2366
+ /** The signal every operation of a connection runs under: its close, and a revoked device's revocation, abort it. */
2367
+ private peerOperationSignal;
2299
2368
  private runPrincipalOperation;
2300
2369
  private assertControllerOperationPrincipal;
2301
2370
  private auditPeerId;