agl 43.1.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.
Files changed (259) hide show
  1. package/changelog.md +32 -0
  2. package/dist_serve/bundle.js +5950 -5530
  3. package/dist_serve/bundle.js.map +2 -2
  4. package/dist_serve/bundle.js.third-party-notices.json +31 -31
  5. package/dist_serve/bundle.js.third-party-notices.txt +31 -31
  6. package/dist_ts/00_commitinfo_data.js +1 -1
  7. package/dist_ts/aglapi/aglapisurface.document.js +521 -17
  8. package/dist_ts/aglapi/interfaces.d.ts +3 -0
  9. package/dist_ts/aglapi/interfaces.js +2 -1
  10. package/dist_ts/classes.accountsactions.d.ts +3 -1
  11. package/dist_ts/classes.accountsactions.js +21 -3
  12. package/dist_ts/classes.authmodels.js +17 -4
  13. package/dist_ts/classes.authstore.js +16 -2
  14. package/dist_ts/classes.claudeharness.d.ts +16 -0
  15. package/dist_ts/classes.claudeharness.js +24 -2
  16. package/dist_ts/classes.cli.d.ts +4 -2
  17. package/dist_ts/classes.cli.js +6 -3
  18. package/dist_ts/classes.codexclientadapter.d.ts +11 -0
  19. package/dist_ts/classes.codexclientadapter.js +14 -2
  20. package/dist_ts/classes.controller.d.ts +175 -11
  21. package/dist_ts/classes.controller.js +1213 -173
  22. package/dist_ts/classes.controllerdevices.d.ts +2 -0
  23. package/dist_ts/classes.controllerdevices.js +6 -1
  24. package/dist_ts/classes.controllermanagement.d.ts +14 -4
  25. package/dist_ts/classes.controllermanagement.js +20 -2
  26. package/dist_ts/classes.gatewayclient.d.ts +115 -0
  27. package/dist_ts/classes.gatewayclient.js +336 -0
  28. package/dist_ts/classes.gatewayclientstore.d.ts +97 -0
  29. package/dist_ts/classes.gatewayclientstore.js +261 -0
  30. package/dist_ts/classes.inbox.d.ts +72 -0
  31. package/dist_ts/classes.inbox.js +231 -0
  32. package/dist_ts/classes.inferencerouter.d.ts +19 -0
  33. package/dist_ts/classes.inferencerouter.js +15 -3
  34. package/dist_ts/classes.inferenceservice.d.ts +9 -0
  35. package/dist_ts/classes.inferenceservice.js +28 -2
  36. package/dist_ts/classes.mcpclient.d.ts +4 -1
  37. package/dist_ts/classes.mcpclient.js +42 -6
  38. package/dist_ts/classes.mcpcontrollerhost.d.ts +3 -1
  39. package/dist_ts/classes.mcpcontrollerhost.js +11 -1
  40. package/dist_ts/classes.mcptools.d.ts +3 -3
  41. package/dist_ts/classes.mcptools.js +38 -8
  42. package/dist_ts/classes.mcpvalidation.d.ts +5 -0
  43. package/dist_ts/classes.mcpvalidation.js +38 -2
  44. package/dist_ts/classes.nativesessions.d.ts +17 -4
  45. package/dist_ts/classes.nativesessions.js +41 -9
  46. package/dist_ts/classes.opencodeclient.d.ts +23 -2
  47. package/dist_ts/classes.opencodeclient.js +47 -3
  48. package/dist_ts/classes.proxycontrol.d.ts +11 -0
  49. package/dist_ts/classes.proxycontrol.js +7 -1
  50. package/dist_ts/classes.proxycontrolclient.d.ts +17 -0
  51. package/dist_ts/classes.proxycontrolclient.js +35 -1
  52. package/dist_ts/classes.proxydaemon.js +8 -1
  53. package/dist_ts/classes.proxymonitor.d.ts +7 -0
  54. package/dist_ts/classes.proxymonitor.js +13 -1
  55. package/dist_ts/classes.publishedset.d.ts +38 -0
  56. package/dist_ts/classes.publishedset.js +50 -0
  57. package/dist_ts/classes.sessionfeed.d.ts +3 -3
  58. package/dist_ts/classes.sessionfeed.js +18 -26
  59. package/dist_ts/classes.systemmetricssampler.d.ts +6 -0
  60. package/dist_ts/classes.systemmetricssampler.js +15 -3
  61. package/dist_ts/classes.ticketstore.d.ts +50 -3
  62. package/dist_ts/classes.ticketstore.js +45 -8
  63. package/dist_ts/classes.trustedproxysecrets.d.ts +2 -0
  64. package/dist_ts/classes.trustedproxysecrets.js +5 -1
  65. package/dist_ts/driver/classes.directreports.d.ts +14 -4
  66. package/dist_ts/driver/classes.directreports.js +25 -6
  67. package/dist_ts/driver/classes.driverservice.d.ts +44 -3
  68. package/dist_ts/driver/classes.driverservice.js +50 -16
  69. package/dist_ts/fleet/classes.claudeworkers.d.ts +21 -5
  70. package/dist_ts/fleet/classes.claudeworkers.js +142 -46
  71. package/dist_ts/fleet/classes.codexworkers.d.ts +16 -4
  72. package/dist_ts/fleet/classes.codexworkers.js +22 -5
  73. package/dist_ts/fleet/classes.workercommand.d.ts +6 -1
  74. package/dist_ts/fleet/classes.workercommand.js +15 -4
  75. package/dist_ts/fleet/classes.workers.d.ts +5 -1
  76. package/dist_ts/fleet/classes.workers.js +8 -2
  77. package/dist_ts/fleet/functions.unbounddrivers.js +2 -2
  78. package/dist_ts/fleet/functions.workervalidation.js +2 -2
  79. package/dist_ts/fleet/interfaces.workers.d.ts +21 -3
  80. package/dist_ts/fleet/interfaces.workers.js +1 -1
  81. package/dist_ts/functions.agentmessage.d.ts +3 -0
  82. package/dist_ts/functions.agentmessage.js +4 -1
  83. package/dist_ts/functions.controllermanagementsurface.d.ts +4 -0
  84. package/dist_ts/functions.controllermanagementsurface.js +15 -1
  85. package/dist_ts/functions.deviceapi.d.ts +151 -4
  86. package/dist_ts/functions.deviceapi.js +893 -38
  87. package/dist_ts/functions.fleetworkercli.d.ts +1 -1
  88. package/dist_ts/functions.fleetworkercli.js +11 -8
  89. package/dist_ts/functions.gatewaycli.d.ts +24 -0
  90. package/dist_ts/functions.gatewaycli.js +395 -0
  91. package/dist_ts/functions.gatewayroute.d.ts +135 -0
  92. package/dist_ts/functions.gatewayroute.js +366 -0
  93. package/dist_ts/functions.inferencecli.js +32 -1
  94. package/dist_ts/functions.inferencecliarguments.d.ts +8 -2
  95. package/dist_ts/functions.inferencecliarguments.js +31 -3
  96. package/dist_ts/functions.mcpfleetworkertools.js +2 -2
  97. package/dist_ts/functions.proxycapacity.d.ts +50 -0
  98. package/dist_ts/functions.proxycapacity.js +142 -0
  99. package/dist_ts/functions.proxycapacitycli.d.ts +30 -0
  100. package/dist_ts/functions.proxycapacitycli.js +65 -0
  101. package/dist_ts/functions.remotecli.d.ts +30 -3
  102. package/dist_ts/functions.remotecli.js +44 -18
  103. package/dist_ts/functions.ticketvalidation.js +11 -2
  104. package/dist_ts/interfaces.auth.d.ts +25 -4
  105. package/dist_ts/interfaces.auth.js +15 -1
  106. package/dist_ts/plugins.d.ts +5 -1
  107. package/dist_ts/plugins.js +10 -2
  108. package/dist_ts_authswitch/authority-contract.d.ts +25 -0
  109. package/dist_ts_authswitch/authority-contract.js +1 -1
  110. package/dist_ts_authswitch/authority-overview.d.ts +8 -0
  111. package/dist_ts_authswitch/authority-overview.js +17 -6
  112. package/dist_ts_authswitch/authority-placement.d.ts +20 -16
  113. package/dist_ts_authswitch/authority-placement.js +19 -26
  114. package/dist_ts_authswitch/authority-renewal.d.ts +34 -0
  115. package/dist_ts_authswitch/authority-renewal.js +56 -0
  116. package/dist_ts_authswitch/authority-usagelimit.d.ts +29 -0
  117. package/dist_ts_authswitch/authority-usagelimit.js +66 -2
  118. package/dist_ts_authswitch/authority-usagewindows.d.ts +6 -0
  119. package/dist_ts_authswitch/authority-usagewindows.js +15 -1
  120. package/dist_ts_authswitch/classes.authoritybroker.d.ts +8 -0
  121. package/dist_ts_authswitch/classes.authoritybroker.js +35 -2
  122. package/dist_ts_authswitch/classes.authoritycli.d.ts +1 -0
  123. package/dist_ts_authswitch/classes.authoritycli.js +44 -3
  124. package/dist_ts_authswitch/classes.authorityclient.d.ts +6 -1
  125. package/dist_ts_authswitch/classes.authorityclient.js +12 -4
  126. package/dist_ts_authswitch/classes.authoritydaemon.js +8 -1
  127. package/dist_ts_authswitch/classes.authoritydatabase.js +6 -2
  128. package/dist_ts_authswitch/classes.authoritymodels.d.ts +7 -0
  129. package/dist_ts_authswitch/classes.authoritymodels.js +21 -5
  130. package/dist_ts_interfaces/devices.d.ts +1012 -5
  131. package/dist_ts_interfaces/devices.js +68 -2
  132. package/dist_ts_interfaces/fleetworkers.d.ts +5 -3
  133. package/dist_ts_interfaces/gateway.d.ts +151 -0
  134. package/dist_ts_interfaces/gateway.js +66 -0
  135. package/dist_ts_interfaces/inbox.d.ts +234 -0
  136. package/dist_ts_interfaces/inbox.js +101 -0
  137. package/dist_ts_interfaces/index.d.ts +3 -0
  138. package/dist_ts_interfaces/index.js +4 -1
  139. package/dist_ts_interfaces/interfaces.d.ts +10 -3
  140. package/dist_ts_interfaces/interfaces.js +4 -2
  141. package/dist_ts_interfaces/management.d.ts +4 -4
  142. package/dist_ts_interfaces/management.js +3 -2
  143. package/dist_ts_interfaces/mcprequests.d.ts +48 -6
  144. package/dist_ts_interfaces/mcprequests.js +12 -1
  145. package/dist_ts_interfaces/mcpworkspacerequests.d.ts +4 -1
  146. package/dist_ts_interfaces/mcpworkspacerequests.js +1 -1
  147. package/dist_ts_interfaces/nativesessions.d.ts +16 -3
  148. package/dist_ts_interfaces/plugins.d.ts +2 -1
  149. package/dist_ts_interfaces/plugins.js +4 -2
  150. package/dist_ts_interfaces/proxycapacity.d.ts +99 -0
  151. package/dist_ts_interfaces/proxycapacity.js +74 -0
  152. package/dist_ts_interfaces/requests.accounts.d.ts +21 -0
  153. package/dist_ts_interfaces/requests.accounts.js +3 -1
  154. package/dist_ts_interfaces/requests.d.ts +3 -2
  155. package/dist_ts_interfaces/requests.js +1 -1
  156. package/docs/authswitch.md +20 -1
  157. package/package.json +6 -5
  158. package/readme.md +191 -31
  159. package/ts/00_commitinfo_data.ts +1 -1
  160. package/ts/aglapi/aglapisurface.document.ts +520 -16
  161. package/ts/aglapi/interfaces.ts +1 -0
  162. package/ts/classes.accountsactions.ts +30 -3
  163. package/ts/classes.authmodels.ts +22 -3
  164. package/ts/classes.authstore.ts +15 -1
  165. package/ts/classes.claudeharness.ts +27 -1
  166. package/ts/classes.cli.ts +7 -3
  167. package/ts/classes.codexclientadapter.ts +14 -1
  168. package/ts/classes.controller.ts +1428 -249
  169. package/ts/classes.controllerdevices.ts +6 -0
  170. package/ts/classes.controllermanagement.ts +40 -7
  171. package/ts/classes.gatewayclient.ts +401 -0
  172. package/ts/classes.gatewayclientstore.ts +272 -0
  173. package/ts/classes.inbox.ts +239 -0
  174. package/ts/classes.inferencerouter.ts +27 -2
  175. package/ts/classes.inferenceservice.ts +28 -1
  176. package/ts/classes.mcpclient.ts +42 -3
  177. package/ts/classes.mcpcontrollerhost.ts +15 -0
  178. package/ts/classes.mcptools.ts +42 -9
  179. package/ts/classes.mcpvalidation.ts +32 -1
  180. package/ts/classes.nativesessions.ts +50 -12
  181. package/ts/classes.opencodeclient.ts +55 -4
  182. package/ts/classes.proxycontrol.ts +16 -0
  183. package/ts/classes.proxycontrolclient.ts +30 -0
  184. package/ts/classes.proxydaemon.ts +8 -0
  185. package/ts/classes.proxymonitor.ts +12 -0
  186. package/ts/classes.publishedset.ts +56 -0
  187. package/ts/classes.sessionfeed.ts +17 -20
  188. package/ts/classes.systemmetricssampler.ts +13 -2
  189. package/ts/classes.ticketstore.ts +73 -12
  190. package/ts/classes.trustedproxysecrets.ts +5 -0
  191. package/ts/driver/classes.directreports.ts +25 -6
  192. package/ts/driver/classes.driverservice.ts +75 -14
  193. package/ts/fleet/classes.claudeworkers.ts +112 -39
  194. package/ts/fleet/classes.codexworkers.ts +21 -6
  195. package/ts/fleet/classes.workercommand.ts +14 -4
  196. package/ts/fleet/classes.workers.ts +9 -2
  197. package/ts/fleet/functions.unbounddrivers.ts +1 -1
  198. package/ts/fleet/functions.workervalidation.ts +1 -1
  199. package/ts/fleet/interfaces.workers.ts +20 -5
  200. package/ts/functions.agentmessage.ts +3 -0
  201. package/ts/functions.controllermanagementsurface.ts +15 -0
  202. package/ts/functions.deviceapi.ts +1071 -34
  203. package/ts/functions.fleetworkercli.ts +10 -7
  204. package/ts/functions.gatewaycli.ts +436 -0
  205. package/ts/functions.gatewayroute.ts +429 -0
  206. package/ts/functions.inferencecli.ts +26 -0
  207. package/ts/functions.inferencecliarguments.ts +30 -4
  208. package/ts/functions.mcpfleetworkertools.ts +1 -1
  209. package/ts/functions.proxycapacity.ts +191 -0
  210. package/ts/functions.proxycapacitycli.ts +104 -0
  211. package/ts/functions.remotecli.ts +56 -20
  212. package/ts/functions.ticketvalidation.ts +11 -1
  213. package/ts/interfaces.auth.ts +36 -4
  214. package/ts/plugins.ts +12 -0
  215. package/ts_authswitch/authority-contract.ts +20 -0
  216. package/ts_authswitch/authority-overview.ts +28 -6
  217. package/ts_authswitch/authority-placement.ts +27 -32
  218. package/ts_authswitch/authority-renewal.ts +64 -0
  219. package/ts_authswitch/authority-usagelimit.ts +84 -1
  220. package/ts_authswitch/authority-usagewindows.ts +13 -0
  221. package/ts_authswitch/classes.authoritybroker.ts +34 -1
  222. package/ts_authswitch/classes.authoritycli.ts +49 -2
  223. package/ts_authswitch/classes.authorityclient.ts +14 -4
  224. package/ts_authswitch/classes.authoritydaemon.ts +9 -1
  225. package/ts_authswitch/classes.authoritydatabase.ts +5 -1
  226. package/ts_authswitch/classes.authoritymodels.ts +23 -3
  227. package/ts_authswitch/native-contracts.md +21 -0
  228. package/ts_authswitch/readme.md +1 -1
  229. package/ts_interfaces/devices.schema.json +3573 -603
  230. package/ts_interfaces/devices.ts +1093 -4
  231. package/ts_interfaces/fleetworkers.ts +5 -3
  232. package/ts_interfaces/gateway.ts +242 -0
  233. package/ts_interfaces/inbox.ts +287 -0
  234. package/ts_interfaces/index.ts +3 -0
  235. package/ts_interfaces/interfaces.ts +9 -2
  236. package/ts_interfaces/management.ts +6 -4
  237. package/ts_interfaces/mcprequests.ts +61 -4
  238. package/ts_interfaces/mcpworkspacerequests.ts +4 -2
  239. package/ts_interfaces/nativesessions.ts +17 -3
  240. package/ts_interfaces/plugins.ts +3 -1
  241. package/ts_interfaces/proxycapacity.ts +162 -0
  242. package/ts_interfaces/requests.accounts.ts +20 -0
  243. package/ts_interfaces/requests.ts +4 -0
  244. package/ts_web/00_commitinfo_data.ts +1 -1
  245. package/ts_web/accounts.plugins.ts +4 -2
  246. package/ts_web/classes.accountsreadmodel.ts +33 -0
  247. package/ts_web/classes.browserpresentation.ts +19 -6
  248. package/ts_web/classes.inboxfeed.ts +329 -0
  249. package/ts_web/classes.nativesessionstate.ts +9 -23
  250. package/ts_web/elements.accounts.ts +121 -113
  251. package/ts_web/elements.configurationpane.ts +24 -37
  252. package/ts_web/elements.deployments.ts +66 -2
  253. package/ts_web/elements.devices.ts +4 -17
  254. package/ts_web/elements.flexlimitstrip.ts +21 -70
  255. package/ts_web/elements.harnesscontrollerapp.ts +198 -222
  256. package/ts_web/elements.inbox.ts +808 -0
  257. package/ts_web/functions.inbox.ts +95 -0
  258. package/ts_web/functions.sessioncards.ts +40 -0
  259. package/ts_web/plugins.ts +2 -0
@@ -0,0 +1,261 @@
1
+ var __esDecorate = (this && this.__esDecorate) || function (ctor, descriptorIn, decorators, contextIn, initializers, extraInitializers) {
2
+ function accept(f) { if (f !== void 0 && typeof f !== "function") throw new TypeError("Function expected"); return f; }
3
+ var kind = contextIn.kind, key = kind === "getter" ? "get" : kind === "setter" ? "set" : "value";
4
+ var target = !descriptorIn && ctor ? contextIn["static"] ? ctor : ctor.prototype : null;
5
+ var descriptor = descriptorIn || (target ? Object.getOwnPropertyDescriptor(target, contextIn.name) : {});
6
+ var _, done = false;
7
+ for (var i = decorators.length - 1; i >= 0; i--) {
8
+ var context = {};
9
+ for (var p in contextIn) context[p] = p === "access" ? {} : contextIn[p];
10
+ for (var p in contextIn.access) context.access[p] = contextIn.access[p];
11
+ context.addInitializer = function (f) { if (done) throw new TypeError("Cannot add initializers after decoration has completed"); extraInitializers.push(accept(f || null)); };
12
+ var result = (0, decorators[i])(kind === "accessor" ? { get: descriptor.get, set: descriptor.set } : descriptor[key], context);
13
+ if (kind === "accessor") {
14
+ if (result === void 0) continue;
15
+ if (result === null || typeof result !== "object") throw new TypeError("Object expected");
16
+ if (_ = accept(result.get)) descriptor.get = _;
17
+ if (_ = accept(result.set)) descriptor.set = _;
18
+ if (_ = accept(result.init)) initializers.unshift(_);
19
+ }
20
+ else if (_ = accept(result)) {
21
+ if (kind === "field") initializers.unshift(_);
22
+ else descriptor[key] = _;
23
+ }
24
+ }
25
+ if (target) Object.defineProperty(target, contextIn.name, descriptor);
26
+ done = true;
27
+ };
28
+ var __runInitializers = (this && this.__runInitializers) || function (thisArg, initializers, value) {
29
+ var useValue = arguments.length > 2;
30
+ for (var i = 0; i < initializers.length; i++) {
31
+ value = useValue ? initializers[i].call(thisArg, value) : initializers[i].call(thisArg);
32
+ }
33
+ return useValue ? value : void 0;
34
+ };
35
+ import * as plugins from './plugins.js';
36
+ import { controllerGatewayProblemCodes, } from '../dist_ts_interfaces/index.js';
37
+ const isText = (valueArg, maximumArg) => (typeof valueArg === 'string' && valueArg.length > 0 && valueArg.length <= maximumArg);
38
+ const isRecordOf = (valueArg, requiredArg, optionalArg = []) => (!!valueArg && typeof valueArg === 'object' && !Array.isArray(valueArg)
39
+ && requiredArg.every((keyArg) => Object.hasOwn(valueArg, keyArg))
40
+ && Object.keys(valueArg).every((keyArg) => requiredArg.includes(keyArg) || optionalArg.includes(keyArg)));
41
+ const isTime = (valueArg) => Number.isSafeInteger(valueArg) && valueArg >= 0;
42
+ /** A gateway token id as it may appear in a seal name. */
43
+ const gatewayTokenIdPattern = /^[A-Za-z0-9_.-]{1,64}$/u;
44
+ const isCredential = (valueArg) => (isRecordOf(valueArg, ['gatewayUrl', 'gatewayClientId', 'appId', 'hostname', 'targetHost', 'tokenId', 'ciphertext', 'at'])
45
+ && isText(valueArg.gatewayUrl, 2048) && isText(valueArg.gatewayClientId, 128) && isText(valueArg.appId, 128)
46
+ && isText(valueArg.hostname, 253) && isText(valueArg.targetHost, 253)
47
+ && typeof valueArg.tokenId === 'string' && gatewayTokenIdPattern.test(valueArg.tokenId)
48
+ && typeof valueArg.ciphertext === 'string' && /^[A-Za-z0-9_-]{1,131072}$/u.test(valueArg.ciphertext)
49
+ && isTime(valueArg.at));
50
+ const isSyncRecord = (valueArg) => {
51
+ if (!isRecordOf(valueArg, [], ['syncedAt', 'dns', 'sourceProfileVerified', 'problem']))
52
+ return false;
53
+ const { syncedAt, dns, sourceProfileVerified, problem } = valueArg;
54
+ return (syncedAt === undefined || isTime(syncedAt))
55
+ && (sourceProfileVerified === undefined || typeof sourceProfileVerified === 'boolean')
56
+ && (dns === undefined || (isRecordOf(dns, ['status', 'owned']) && isText(dns.status, 64) && typeof dns.owned === 'boolean'))
57
+ && (problem === undefined || (isRecordOf(problem, ['code', 'message'])
58
+ && controllerGatewayProblemCodes.includes(problem.code)
59
+ && isText(problem.message, 4096)));
60
+ };
61
+ const assertDocument = (valueArg) => {
62
+ if (!isRecordOf(valueArg, ['id'], ['active', 'candidate', 'lastSync'])
63
+ || typeof valueArg.id !== 'string' || !/^controller:[1-9][0-9]{0,4}$/u.test(valueArg.id)
64
+ || (valueArg.active === undefined && valueArg.candidate === undefined)
65
+ || (valueArg.active !== undefined && !isCredential(valueArg.active))
66
+ || (valueArg.candidate !== undefined && !isCredential(valueArg.candidate))
67
+ || (valueArg.lastSync !== undefined && !isSyncRecord(valueArg.lastSync))) {
68
+ throw new Error('Invalid gateway client record.');
69
+ }
70
+ };
71
+ let ControllerGatewayClientModel = (() => {
72
+ let _classDecorators = [plugins.nosqldb.managed({ collectionName: 'agl_controller_gateway_clients' }), plugins.nosqldb.exactPersistence({ assertDocument })];
73
+ let _classDescriptor;
74
+ let _classExtraInitializers = [];
75
+ let _classThis;
76
+ let _classSuper = plugins.nosqldb.SmartDataDbDoc;
77
+ let _id_decorators;
78
+ let _id_initializers = [];
79
+ let _id_extraInitializers = [];
80
+ let _active_decorators;
81
+ let _active_initializers = [];
82
+ let _active_extraInitializers = [];
83
+ let _candidate_decorators;
84
+ let _candidate_initializers = [];
85
+ let _candidate_extraInitializers = [];
86
+ let _lastSync_decorators;
87
+ let _lastSync_initializers = [];
88
+ let _lastSync_extraInitializers = [];
89
+ var ControllerGatewayClientModel = class extends _classSuper {
90
+ static { _classThis = this; }
91
+ static {
92
+ const _metadata = typeof Symbol === "function" && Symbol.metadata ? Object.create(_classSuper[Symbol.metadata] ?? null) : void 0;
93
+ _id_decorators = [plugins.nosqldb.unI()];
94
+ _active_decorators = [plugins.nosqldb.svDb()];
95
+ _candidate_decorators = [plugins.nosqldb.svDb()];
96
+ _lastSync_decorators = [plugins.nosqldb.svDb()];
97
+ __esDecorate(null, null, _id_decorators, { kind: "field", name: "id", static: false, private: false, access: { has: obj => "id" in obj, get: obj => obj.id, set: (obj, value) => { obj.id = value; } }, metadata: _metadata }, _id_initializers, _id_extraInitializers);
98
+ __esDecorate(null, null, _active_decorators, { kind: "field", name: "active", static: false, private: false, access: { has: obj => "active" in obj, get: obj => obj.active, set: (obj, value) => { obj.active = value; } }, metadata: _metadata }, _active_initializers, _active_extraInitializers);
99
+ __esDecorate(null, null, _candidate_decorators, { kind: "field", name: "candidate", static: false, private: false, access: { has: obj => "candidate" in obj, get: obj => obj.candidate, set: (obj, value) => { obj.candidate = value; } }, metadata: _metadata }, _candidate_initializers, _candidate_extraInitializers);
100
+ __esDecorate(null, null, _lastSync_decorators, { kind: "field", name: "lastSync", static: false, private: false, access: { has: obj => "lastSync" in obj, get: obj => obj.lastSync, set: (obj, value) => { obj.lastSync = value; } }, metadata: _metadata }, _lastSync_initializers, _lastSync_extraInitializers);
101
+ __esDecorate(null, _classDescriptor = { value: _classThis }, _classDecorators, { kind: "class", name: _classThis.name, metadata: _metadata }, null, _classExtraInitializers);
102
+ ControllerGatewayClientModel = _classThis = _classDescriptor.value;
103
+ if (_metadata) Object.defineProperty(_classThis, Symbol.metadata, { enumerable: true, configurable: true, writable: true, value: _metadata });
104
+ __runInitializers(_classThis, _classExtraInitializers);
105
+ }
106
+ id = __runInitializers(this, _id_initializers, void 0);
107
+ active = (__runInitializers(this, _id_extraInitializers), __runInitializers(this, _active_initializers, void 0));
108
+ candidate = (__runInitializers(this, _active_extraInitializers), __runInitializers(this, _candidate_initializers, void 0));
109
+ lastSync = (__runInitializers(this, _candidate_extraInitializers), __runInitializers(this, _lastSync_initializers, void 0));
110
+ constructor() {
111
+ super(...arguments);
112
+ __runInitializers(this, _lastSync_extraInitializers);
113
+ }
114
+ };
115
+ return ControllerGatewayClientModel = _classThis;
116
+ })();
117
+ export { ControllerGatewayClientModel };
118
+ const readStored = (controllerIdArg) => ControllerGatewayClientModel.exact.findStoredOne({ id: controllerIdArg });
119
+ /** What `agl remote gateway status` and the management status report of an enrolment, without its token. */
120
+ export const controllerGatewayEnrolment = (credentialArg, portArg) => ({
121
+ gatewayUrl: credentialArg.gatewayUrl,
122
+ gatewayClientId: credentialArg.gatewayClientId,
123
+ appId: credentialArg.appId,
124
+ hostname: credentialArg.hostname,
125
+ target: { host: credentialArg.targetHost, port: portArg },
126
+ enrolledAt: credentialArg.at,
127
+ });
128
+ /**
129
+ * A controller's gateway-client record in its database (`agl_controller_gateway_clients`): the active credential, a
130
+ * candidate awaiting the gateway's confirmation, and what the last sync left. Only `agl remote gateway` writes the
131
+ * credentials, against a stopped controller; the running controller writes only `lastSync`.
132
+ */
133
+ export class ControllerGatewayClientStore {
134
+ options;
135
+ constructor(options) {
136
+ this.options = options;
137
+ }
138
+ get controllerId() {
139
+ return this.options.controllerId;
140
+ }
141
+ async read() {
142
+ const stored = await readStored(this.options.controllerId);
143
+ return stored ? ControllerGatewayClientModel.exact.toPersisted(stored) : undefined;
144
+ }
145
+ /** The token of `credentialArg`, unsealed; the caller wipes nothing, the string is the gateway's own text. */
146
+ async unseal(credentialArg) {
147
+ let bytes;
148
+ try {
149
+ bytes = await this.options.codec.unseal(this.sealName(credentialArg.tokenId), credentialArg.ciphertext);
150
+ }
151
+ catch (errorArg) {
152
+ throw new Error(`The gateway credential of ${this.options.controllerId} cannot be unsealed on this machine. `
153
+ + 'Enrol again with `agl remote gateway enrol`.', { cause: errorArg });
154
+ }
155
+ try {
156
+ return Buffer.from(bytes).toString('utf8');
157
+ }
158
+ finally {
159
+ bytes.fill(0);
160
+ }
161
+ }
162
+ /**
163
+ * Seals a credential the gateway just issued and stores it as the candidate, before its confirmation is asked
164
+ * for. A candidate stored before is replaced: the gateway superseded it by issuing this one.
165
+ */
166
+ async storeCandidate(specArg, tokenIdArg, tokenArg) {
167
+ if (!gatewayTokenIdPattern.test(tokenIdArg))
168
+ throw new Error('The gateway issued a credential with an invalid id.');
169
+ const bytes = Buffer.from(tokenArg, 'utf8');
170
+ let ciphertext;
171
+ try {
172
+ ciphertext = await this.options.codec.seal(this.sealName(tokenIdArg), bytes);
173
+ }
174
+ finally {
175
+ bytes.fill(0);
176
+ }
177
+ const candidate = { ...specArg, tokenId: tokenIdArg, ciphertext, at: Date.now() };
178
+ const stored = await readStored(this.options.controllerId);
179
+ if (!stored) {
180
+ const inserted = await ControllerGatewayClientModel.exact.insert({ id: this.options.controllerId, candidate });
181
+ if (inserted.status !== 'inserted')
182
+ throw new Error('The gateway client record changed concurrently.');
183
+ return candidate;
184
+ }
185
+ await this.transition(stored, (modelArg) => { modelArg.candidate = candidate; });
186
+ return candidate;
187
+ }
188
+ /** Makes the confirmed candidate `tokenIdArg` the active credential; the previous one is gone from the gateway. */
189
+ async promoteCandidate(tokenIdArg) {
190
+ const stored = await this.requireStored();
191
+ const record = ControllerGatewayClientModel.exact.toPersisted(stored);
192
+ if (record.candidate?.tokenId !== tokenIdArg)
193
+ throw new Error('The gateway client record changed concurrently.');
194
+ const active = { ...record.candidate, at: Date.now() };
195
+ await this.transition(stored, (modelArg) => {
196
+ modelArg.active = active;
197
+ delete modelArg.candidate;
198
+ // A new credential starts without the previous one's outcome.
199
+ delete modelArg.lastSync;
200
+ });
201
+ return active;
202
+ }
203
+ /** Drops a candidate the gateway refuses to confirm; the record goes when it holds nothing else. */
204
+ async dropCandidate(tokenIdArg) {
205
+ const stored = await this.requireStored();
206
+ const record = ControllerGatewayClientModel.exact.toPersisted(stored);
207
+ if (record.candidate?.tokenId !== tokenIdArg)
208
+ throw new Error('The gateway client record changed concurrently.');
209
+ if (!record.active) {
210
+ await this.forget();
211
+ return;
212
+ }
213
+ await this.transition(stored, (modelArg) => { delete modelArg.candidate; });
214
+ }
215
+ /** Records what a sync of the running controller found; the record must still hold `tokenIdArg` as active. */
216
+ async recordSync(tokenIdArg, syncArg) {
217
+ const stored = await this.requireStored();
218
+ if (ControllerGatewayClientModel.exact.toPersisted(stored).active?.tokenId !== tokenIdArg) {
219
+ throw new Error('The gateway client record changed outside this controller.');
220
+ }
221
+ await this.transition(stored, (modelArg) => { modelArg.lastSync = structuredClone(syncArg); });
222
+ }
223
+ /** Removes the record; whether there was one. */
224
+ async forget() {
225
+ const stored = await readStored(this.options.controllerId);
226
+ if (!stored)
227
+ return false;
228
+ const deleted = await ControllerGatewayClientModel.exact.delete({ current: stored });
229
+ if (deleted.status !== 'deleted' && await readStored(this.options.controllerId)) {
230
+ throw new Error('The gateway client record could not be removed.');
231
+ }
232
+ return true;
233
+ }
234
+ sealName(tokenIdArg) {
235
+ return `agl-controller.${this.options.issuerId.slice(0, 22)}.${this.options.controllerId.replace(':', '-')}.gateway.${tokenIdArg}`;
236
+ }
237
+ async requireStored() {
238
+ const stored = await readStored(this.options.controllerId);
239
+ if (!stored)
240
+ throw new Error(`${this.options.controllerId} is not enrolled with a gateway.`);
241
+ return stored;
242
+ }
243
+ async transition(storedArg, changeArg) {
244
+ const result = await ControllerGatewayClientModel.exact.transition({ current: storedArg, change: changeArg });
245
+ if (result.status !== 'transitioned')
246
+ throw new Error('The gateway client record changed concurrently.');
247
+ }
248
+ }
249
+ /**
250
+ * The hostnames the gateway enrolment of `controllerIdArg` holds a route for, finished or not (its active and its
251
+ * candidate credential's); empty when it has none.
252
+ */
253
+ export const controllerGatewayEnrolledHostnames = async (controllerIdArg) => {
254
+ const stored = await readStored(controllerIdArg);
255
+ if (!stored)
256
+ return [];
257
+ const record = ControllerGatewayClientModel.exact.toPersisted(stored);
258
+ return [...new Set([record.active?.hostname, record.candidate?.hostname]
259
+ .filter((hostnameArg) => hostnameArg !== undefined))];
260
+ };
261
+ //# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiY2xhc3Nlcy5nYXRld2F5Y2xpZW50c3RvcmUuanMiLCJzb3VyY2VSb290IjoiIiwic291cmNlcyI6WyIuLi8uLi90cy9jbGFzc2VzLmdhdGV3YXljbGllbnRzdG9yZS50cyJdLCJuYW1lcyI6W10sIm1hcHBpbmdzIjoiOzs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7O0FBQUEsT0FBTyxLQUFLLE9BQU8sTUFBTSxjQUFjLENBQUM7QUFFeEMsT0FBTyxFQUNMLDZCQUE2QixHQUs5QixNQUFNLDJCQUEyQixDQUFDO0FBK0NuQyxNQUFNLE1BQU0sR0FBRyxDQUFDLFFBQWlCLEVBQUUsVUFBa0IsRUFBc0IsRUFBRSxDQUFDLENBQzVFLE9BQU8sUUFBUSxLQUFLLFFBQVEsSUFBSSxRQUFRLENBQUMsTUFBTSxHQUFHLENBQUMsSUFBSSxRQUFRLENBQUMsTUFBTSxJQUFJLFVBQVUsQ0FDckYsQ0FBQztBQUVGLE1BQU0sVUFBVSxHQUFHLENBQUMsUUFBaUIsRUFBRSxXQUE4QixFQUFFLFdBQVcsR0FBc0IsRUFBRSxFQUF1QyxFQUFFLENBQUMsQ0FDbEosQ0FBQyxDQUFDLFFBQVEsSUFBSSxPQUFPLFFBQVEsS0FBSyxRQUFRLElBQUksQ0FBQyxLQUFLLENBQUMsT0FBTyxDQUFDLFFBQVEsQ0FBQztPQUNuRSxXQUFXLENBQUMsS0FBSyxDQUFDLENBQUMsTUFBTSxFQUFFLEVBQUUsQ0FBQyxNQUFNLENBQUMsTUFBTSxDQUFDLFFBQVEsRUFBRSxNQUFNLENBQUMsQ0FBQztPQUM5RCxNQUFNLENBQUMsSUFBSSxDQUFDLFFBQVEsQ0FBQyxDQUFDLEtBQUssQ0FBQyxDQUFDLE1BQU0sRUFBRSxFQUFFLENBQUMsV0FBVyxDQUFDLFFBQVEsQ0FBQyxNQUFNLENBQUMsSUFBSSxXQUFXLENBQUMsUUFBUSxDQUFDLE1BQU0sQ0FBQyxDQUFDLENBQ3pHLENBQUM7QUFFRixNQUFNLE1BQU0sR0FBRyxDQUFDLFFBQWlCLEVBQXNCLEVBQUUsQ0FBQyxNQUFNLENBQUMsYUFBYSxDQUFD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
@@ -0,0 +1,72 @@
1
+ import { type IControllerEvent, type IControllerInboxSnapshot, type TControllerInboxDelta, type TControllerInboxItem } from '../dist_ts_interfaces/index.js';
2
+ /**
3
+ * Where the Inbox's items come from, each read as a unit: the requests the Claude Code and Codex harnesses hold (their
4
+ * conversations' and the native sessions' AGL runs turns in), the OpenCode and Flex conversations' requests, the waits
5
+ * harnesses show in their own clients, the driver's `needs input:` turn, and the board's open questions.
6
+ */
7
+ export type TInboxSource = 'claude' | 'codex' | 'opencode' | 'flex' | 'native_waits' | 'driver' | 'tickets';
8
+ export declare const inboxSources: readonly TInboxSource[];
9
+ /** The reads the Inbox merges; the controller binds them to its harnesses, session feed, driver and board. */
10
+ export interface IInboxSources {
11
+ /**
12
+ * The items `sourceArg` holds now. `previousArg` are the source's items of the last read, for a source that keeps
13
+ * the part of them a failed partial read could not renew. A read that fails keeps the source's previous items.
14
+ */
15
+ read(sourceArg: TInboxSource, previousArg: readonly TControllerInboxItem[], signalArg: AbortSignal): Promise<TControllerInboxItem[]>;
16
+ /** Whether a browser or a device receives controller events; without one the Inbox only marks its sources stale. */
17
+ hasViewers(): Promise<boolean>;
18
+ publish(deltaArg: TControllerInboxDelta): void;
19
+ reportError(messageArg: string, errorArg: unknown): void;
20
+ }
21
+ export interface IInboxOptions {
22
+ /** Event bursts coalesce: a pass reads `debounceMs` after the newest event, at most `maxDebounceMs` after the first. */
23
+ debounceMs?: number;
24
+ maxDebounceMs?: number;
25
+ }
26
+ /** One line of at most `controllerInboxLimits.titleChars` characters, its end marked when it was cut. */
27
+ export declare const inboxTitle: (textArg: string) => string;
28
+ /**
29
+ * An item within `controllerInboxLimits.itemBytes`: one over it keeps its place, kind, title and where it lives, and
30
+ * leaves its payload out with the marker `omitted`; it is then answered only where it lives. Nothing is cut short.
31
+ */
32
+ export declare const boundInboxItem: (itemArg: TControllerInboxItem) => TControllerInboxItem;
33
+ /**
34
+ * The Inbox (AGL-1635): one list of what waits for the owner, kept in memory and published to browsers and devices as
35
+ * deltas. Nothing is stored: every item is read from the component that owns it, so an answer anywhere removes it.
36
+ *
37
+ * Events mark the sources they concern stale; a pass reads only the stale ones, coalesced, and only while a browser
38
+ * or a device is connected. `list()` reads every stale source first.
39
+ */
40
+ export declare class ControllerInbox {
41
+ private readonly sources;
42
+ private readonly abort;
43
+ private readonly published;
44
+ private readonly items;
45
+ private readonly stale;
46
+ private readonly debounceMs;
47
+ private readonly maxDebounceMs;
48
+ private total;
49
+ private limited;
50
+ /** The last failure each source reported, so a lasting one is reported once. */
51
+ private readonly errors;
52
+ private timer?;
53
+ private firstPendingAt?;
54
+ /** Passes run one at a time, in order; a pass reads the sources stale when it starts. */
55
+ private tail;
56
+ constructor(sources: IInboxSources, optionsArg?: IInboxOptions);
57
+ /** The Inbox after reading every stale source. */
58
+ list(): Promise<IControllerInboxSnapshot>;
59
+ /** Called for every controller event: the ones that change what waits mark their sources stale. */
60
+ observe(eventArg: IControllerEvent): void;
61
+ /** The requests a harness holds for a native session came or went (no controller event names those sessions). */
62
+ nativeAttentionChanged(harnessArg: 'claude' | 'codex'): void;
63
+ markStale(...sourcesArg: TInboxSource[]): void;
64
+ /** Stops the timer and waits for the pass in flight, which sees the abort. */
65
+ close(): Promise<void>;
66
+ private schedule;
67
+ /** A scheduled pass runs only while someone receives its changes; otherwise its sources stay stale for `list()`. */
68
+ private passIfViewed;
69
+ private enqueuePass;
70
+ private pass;
71
+ private publish;
72
+ }
@@ -0,0 +1,231 @@
1
+ import { compareControllerInboxItems, controllerInboxLimits, } from '../dist_ts_interfaces/index.js';
2
+ import { PublishedSet } from './classes.publishedset.js';
3
+ export const inboxSources = ['claude', 'codex', 'opencode', 'flex', 'native_waits', 'driver', 'tickets'];
4
+ const sessionSources = ['claude', 'codex', 'opencode', 'flex', 'native_waits'];
5
+ /** One line of at most `controllerInboxLimits.titleChars` characters, its end marked when it was cut. */
6
+ export const inboxTitle = (textArg) => {
7
+ const line = textArg.replace(/\s+/gu, ' ').trim();
8
+ const characters = [...line];
9
+ return characters.length <= controllerInboxLimits.titleChars
10
+ ? line
11
+ : `${characters.slice(0, controllerInboxLimits.titleChars - 1).join('').trimEnd()}…`;
12
+ };
13
+ const itemBytes = (itemArg) => Buffer.byteLength(JSON.stringify(itemArg), 'utf8');
14
+ /**
15
+ * An item within `controllerInboxLimits.itemBytes`: one over it keeps its place, kind, title and where it lives, and
16
+ * leaves its payload out with the marker `omitted`; it is then answered only where it lives. Nothing is cut short.
17
+ */
18
+ export const boundInboxItem = (itemArg) => {
19
+ const bytes = itemBytes(itemArg);
20
+ if (bytes <= controllerInboxLimits.itemBytes)
21
+ return itemArg;
22
+ const omitted = { reason: 'oversize', bytes };
23
+ switch (itemArg.kind) {
24
+ case 'permission': {
25
+ const { permission: _payload, ...item } = itemArg;
26
+ return { ...item, answer: 'none', omitted };
27
+ }
28
+ case 'question': {
29
+ const { question: _payload, ...item } = itemArg;
30
+ return { ...item, answer: 'none', omitted };
31
+ }
32
+ case 'elicitation': {
33
+ const { elicitation: _payload, ...item } = itemArg;
34
+ return { ...item, answer: 'none', omitted };
35
+ }
36
+ case 'driver': {
37
+ const { line: _payload, ...item } = itemArg;
38
+ return { ...item, answer: 'none', omitted };
39
+ }
40
+ case 'deploy_go': {
41
+ const { question: _payload, ...item } = itemArg;
42
+ return { ...item, answer: 'none', omitted };
43
+ }
44
+ case 'window_go': {
45
+ const { question: _payload, ...item } = itemArg;
46
+ return { ...item, answer: 'none', omitted };
47
+ }
48
+ case 'ticket_question': {
49
+ const { question: _payload, ...item } = itemArg;
50
+ return { ...item, answer: 'none', omitted };
51
+ }
52
+ case 'native_wait': return { ...itemArg, omitted };
53
+ }
54
+ };
55
+ /**
56
+ * The Inbox (AGL-1635): one list of what waits for the owner, kept in memory and published to browsers and devices as
57
+ * deltas. Nothing is stored: every item is read from the component that owns it, so an answer anywhere removes it.
58
+ *
59
+ * Events mark the sources they concern stale; a pass reads only the stale ones, coalesced, and only while a browser
60
+ * or a device is connected. `list()` reads every stale source first.
61
+ */
62
+ export class ControllerInbox {
63
+ sources;
64
+ abort = new AbortController();
65
+ published = new PublishedSet(controllerInboxLimits.deltaItems);
66
+ items = new Map();
67
+ stale = new Set(inboxSources);
68
+ debounceMs;
69
+ maxDebounceMs;
70
+ total = 0;
71
+ limited = false;
72
+ /** The last failure each source reported, so a lasting one is reported once. */
73
+ errors = new Map();
74
+ timer;
75
+ firstPendingAt;
76
+ /** Passes run one at a time, in order; a pass reads the sources stale when it starts. */
77
+ tail = Promise.resolve();
78
+ constructor(sources, optionsArg = {}) {
79
+ this.sources = sources;
80
+ this.debounceMs = optionsArg.debounceMs ?? 100;
81
+ this.maxDebounceMs = optionsArg.maxDebounceMs ?? 1_000;
82
+ }
83
+ /** The Inbox after reading every stale source. */
84
+ async list() {
85
+ this.abort.signal.throwIfAborted();
86
+ await this.enqueuePass();
87
+ return { epoch: this.published.epoch, revision: this.published.revision, items: this.published.values(), total: this.total, limited: this.limited };
88
+ }
89
+ /** Called for every controller event: the ones that change what waits mark their sources stale. */
90
+ observe(eventArg) {
91
+ if (this.abort.signal.aborted)
92
+ return;
93
+ switch (eventArg.type) {
94
+ case 'permissions.changed': {
95
+ const harness = eventArg.harnessId;
96
+ this.markStale(...(harness === 'claude' || harness === 'codex' || harness === 'opencode' || harness === 'flex' ? [harness] : sessionSources));
97
+ return;
98
+ }
99
+ case 'sessions.changed':
100
+ case 'harness.changed':
101
+ case 'projects.changed':
102
+ this.markStale(...sessionSources);
103
+ return;
104
+ // A feed row's group and name are what session items name and where they wait: the rows' harnesses read again.
105
+ case 'sessionfeed.changed': {
106
+ const delta = eventArg.sessionFeed;
107
+ if (!delta || 'reset' in delta) {
108
+ this.markStale(...sessionSources);
109
+ return;
110
+ }
111
+ const harnesses = new Set([...delta.upserts.map((rowArg) => rowArg.harness),
112
+ ...delta.removed.map((rowIdArg) => rowIdArg.slice(0, rowIdArg.indexOf(':')))]);
113
+ this.markStale('native_waits', ...sessionSources.filter((sourceArg) => harnesses.has(sourceArg)));
114
+ return;
115
+ }
116
+ case 'driver.changed':
117
+ // The driver's own prompts are Flex permissions.
118
+ this.markStale('driver', 'flex');
119
+ return;
120
+ case 'tickets.changed':
121
+ case 'deployments.changed':
122
+ this.markStale('tickets');
123
+ return;
124
+ default:
125
+ return;
126
+ }
127
+ }
128
+ /** The requests a harness holds for a native session came or went (no controller event names those sessions). */
129
+ nativeAttentionChanged(harnessArg) {
130
+ this.markStale(harnessArg);
131
+ }
132
+ markStale(...sourcesArg) {
133
+ if (this.abort.signal.aborted)
134
+ return;
135
+ for (const source of sourcesArg)
136
+ this.stale.add(source);
137
+ this.schedule();
138
+ }
139
+ /** Stops the timer and waits for the pass in flight, which sees the abort. */
140
+ async close() {
141
+ this.abort.abort();
142
+ if (this.timer)
143
+ clearTimeout(this.timer);
144
+ this.timer = undefined;
145
+ await this.tail;
146
+ }
147
+ schedule() {
148
+ const now = Date.now();
149
+ this.firstPendingAt ??= now;
150
+ const due = Math.min(now + this.debounceMs, this.firstPendingAt + this.maxDebounceMs);
151
+ if (this.timer)
152
+ clearTimeout(this.timer);
153
+ this.timer = setTimeout(() => {
154
+ this.timer = undefined;
155
+ this.firstPendingAt = undefined;
156
+ void this.passIfViewed();
157
+ }, Math.max(0, due - now));
158
+ this.timer.unref?.();
159
+ }
160
+ /** A scheduled pass runs only while someone receives its changes; otherwise its sources stay stale for `list()`. */
161
+ async passIfViewed() {
162
+ let viewed;
163
+ try {
164
+ viewed = await this.sources.hasViewers();
165
+ }
166
+ catch (errorArg) {
167
+ this.sources.reportError('Checking for Inbox viewers failed.', errorArg);
168
+ return;
169
+ }
170
+ if (viewed && !this.abort.signal.aborted)
171
+ await this.enqueuePass();
172
+ }
173
+ enqueuePass() {
174
+ const pass = this.tail.then(() => this.pass());
175
+ this.tail = pass.catch((errorArg) => {
176
+ if (!this.abort.signal.aborted)
177
+ this.sources.reportError('An Inbox pass failed.', errorArg);
178
+ });
179
+ return pass;
180
+ }
181
+ async pass() {
182
+ const signal = this.abort.signal;
183
+ signal.throwIfAborted();
184
+ const sources = inboxSources.filter((sourceArg) => this.stale.has(sourceArg));
185
+ for (const source of sources)
186
+ this.stale.delete(source);
187
+ await Promise.all(sources.map(async (sourceArg) => {
188
+ try {
189
+ this.items.set(sourceArg, await this.sources.read(sourceArg, this.items.get(sourceArg) ?? [], signal));
190
+ this.errors.delete(sourceArg);
191
+ }
192
+ catch (errorArg) {
193
+ signal.throwIfAborted();
194
+ // The source keeps what it held; its next change reads it again.
195
+ const message = errorArg instanceof Error ? errorArg.message : String(errorArg);
196
+ if (this.errors.get(sourceArg) === message)
197
+ return;
198
+ this.errors.set(sourceArg, message);
199
+ this.sources.reportError(`Inbox: reading ${sourceArg} failed.`, errorArg);
200
+ }
201
+ }));
202
+ signal.throwIfAborted();
203
+ this.publish();
204
+ }
205
+ publish() {
206
+ const unique = new Map();
207
+ for (const item of [...this.items.values()].flat())
208
+ if (!unique.has(item.id))
209
+ unique.set(item.id, boundInboxItem(item));
210
+ const all = [...unique.values()].sort(compareControllerInboxItems);
211
+ const shown = [];
212
+ let bytes = 0;
213
+ for (const item of all) {
214
+ const size = itemBytes(item);
215
+ if (shown.length >= controllerInboxLimits.items || bytes + size > controllerInboxLimits.listBytes)
216
+ break;
217
+ shown.push(item);
218
+ bytes += size;
219
+ }
220
+ const total = all.length;
221
+ const limited = shown.length < total;
222
+ const countsChanged = total !== this.total || limited !== this.limited;
223
+ this.total = total;
224
+ this.limited = limited;
225
+ const delta = this.published.publish(shown, countsChanged);
226
+ if (!delta)
227
+ return;
228
+ this.sources.publish('reset' in delta ? delta : { ...delta, order: shown.map((itemArg) => itemArg.id), total, limited });
229
+ }
230
+ }
231
+ //# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiY2xhc3Nlcy5pbmJveC5qcyIsInNvdXJjZVJvb3QiOiIiLCJzb3VyY2VzIjpbIi4uLy4uL3RzL2NsYXNzZXMuaW5ib3gudHMiXSwibmFtZXMiOltdLCJtYXBwaW5ncyI6IkFBQUEsT0FBTyxFQUNMLDJCQUEyQixFQUMzQixxQkFBcUIsR0FLdEIsTUFBTSwyQkFBMkIsQ0FBQztBQUNuQyxPQUFPLEVBQUUsWUFBWSxFQUFFLE1BQU0sMkJBQTJCLENBQUM7QUFRekQsTUFBTSxDQUFDLE1BQU0sWUFBWSxHQUE0QixDQUFDLFFBQVEsRUFBRSxPQUFPLEVBQUUsVUFBVSxFQUFFLE1BQU0sRUFBRSxjQUFjLEVBQUUsUUFBUSxFQUFFLFNBQVMsQ0FBQyxDQUFDO0FBQ2xJLE1BQU0sY0FBYyxHQUE0QixDQUFDLFFBQVEsRUFBRSxPQUFPLEVBQUUsVUFBVSxFQUFFLE1BQU0sRUFBRSxjQUFjLENBQUMsQ0FBQztBQXFCeEcseUdBQXlHO0FBQ3pHLE1BQU0sQ0FBQyxNQUFNLFVBQVUsR0FBRyxDQUFDLE9BQWUsRUFBVSxFQUFFO0lBQ3BELE1BQU0sSUFBSSxHQUFHLE9BQU8sQ0FBQyxPQUFPLENBQUMsT0FBTyxFQUFFLEdBQUcsQ0FBQyxDQUFDLElBQUksRUFBRSxDQUFDO0lBQ2xELE1BQU0sVUFBVSxHQUFHLENBQUMsR0FBRyxJQUFJLENBQUMsQ0FBQztJQUM3QixPQUFPLFVBQVUsQ0FBQyxNQUFNLElBQUkscUJBQXFCLENBQUMsVUFBVTtRQUMxRCxDQUFDLENBQUMsSUFBSTtRQUNOLENBQUMsQ0FBQyxHQUFHLFVBQVUsQ0FBQyxLQUFLLENBQUMsQ0FBQyxFQUFFLHFCQUFxQixDQUFDLFVBQVUsR0FBRyxDQUFDLENBQUMsQ0FBQyxJQUFJLENBQUMsRUFBRSxDQUFDLENBQUMsT0FBTyxFQUFFLEdBQUcsQ0FBQztBQUN6RixDQUFDLENBQUM7QUFFRixNQUFNLFNBQVMsR0FBRyxDQUFDLE9BQTZCLEVBQVUsRUFBRSxDQUFDLE1BQU0sQ0FBQyxVQUFVLENBQUMsSUFBSSxDQUFDLFNB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
@@ -34,6 +34,11 @@ export interface IInferenceAccount {
34
34
  reserveLiftUntil: string | null;
35
35
  /** When the account's subscription ends (`IAuthSwitchAccount.lapsesAt`); `null` while it renews. */
36
36
  lapsesAt: string | null;
37
+ /**
38
+ * The anchor of a Claude sign-in's monthly renewal as its owner set it (`IAuthSwitchAccount.renewsAt`); `null`
39
+ * without one. Placement only: a window's usage counts as spent by the next renewal (`authSwitchPlacement`).
40
+ */
41
+ renewsAt: string | null;
37
42
  /**
38
43
  * An API key's monthly spend limit in micro-dollars (`IAuthSwitchAccount.spendLimitMicroUsd`); `null` without one,
39
44
  * and for a sign-in. It decides only whether a key whose spend the proxy holds no reading of may take work: one with
@@ -341,6 +346,11 @@ export interface IInferenceAccountStatus {
341
346
  lifecycle: plugins.authswitchPlacement.TAuthSwitchAccountLifecycle;
342
347
  /** When the account's subscription ends, or `null` while it renews. */
343
348
  lapsesAt: string | null;
349
+ /**
350
+ * The account's next renewal (`IInferenceAccount.renewsAt` rolled forward to the first one after now), or `null`
351
+ * without one. Placement ignores it while the account has a lapse date. A proxy of an earlier AGL reports none.
352
+ */
353
+ renewal?: plugins.authswitchRenewal.IAuthSwitchRenewal | null;
344
354
  /** The account's placement score in percent per hour (`IAuthSwitchPlacement.score`); `null` without a counted window. */
345
355
  placementScore: number | null;
346
356
  /**
@@ -626,6 +636,15 @@ export declare class InferenceRouter {
626
636
  * keys (`inferenceCredentialTiers`).
627
637
  */
628
638
  accountStatus(accountsArg: readonly IInferenceAccount[], heldArg: (accountIdArg: string) => plugins.authswitchAuthority.IAuthSwitchUsageSnapshot | undefined): IInferenceAccountStatus[];
639
+ /**
640
+ * The newest provider 429 this router saw on the account since it started (epoch milliseconds), or `null`, and until
641
+ * when the account rests after it as routing judges it on `usageArg` (`cooldownUntil`; 0 when it does not rest): the
642
+ * proxy's capacity reads both (`proxyPoolCapacity`). Held in memory only, so a restarted proxy starts with none.
643
+ */
644
+ quotaOf(accountArg: IInferenceAccount, usageArg: plugins.authswitchAuthority.IAuthSwitchUsageSnapshot | undefined): {
645
+ lastAt: number | null;
646
+ restUntil: number;
647
+ };
629
648
  /** Counts one request on an account until its release, which may be called more than once. */
630
649
  private reserve;
631
650
  /**