agl 43.1.0 → 43.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 (123) hide show
  1. package/changelog.md +12 -0
  2. package/dist_serve/bundle.js +5329 -5116
  3. package/dist_serve/bundle.js.map +2 -2
  4. package/dist_serve/bundle.js.third-party-notices.json +30 -30
  5. package/dist_serve/bundle.js.third-party-notices.txt +30 -30
  6. package/dist_ts/00_commitinfo_data.js +1 -1
  7. package/dist_ts/aglapi/aglapisurface.document.js +325 -1
  8. package/dist_ts/aglapi/interfaces.d.ts +3 -0
  9. package/dist_ts/aglapi/interfaces.js +2 -1
  10. package/dist_ts/classes.authmodels.js +17 -4
  11. package/dist_ts/classes.authstore.js +16 -2
  12. package/dist_ts/classes.cli.d.ts +4 -2
  13. package/dist_ts/classes.cli.js +6 -3
  14. package/dist_ts/classes.controller.d.ts +10 -0
  15. package/dist_ts/classes.controller.js +119 -4
  16. package/dist_ts/classes.controllermanagement.d.ts +14 -4
  17. package/dist_ts/classes.controllermanagement.js +20 -2
  18. package/dist_ts/classes.gatewayclient.d.ts +115 -0
  19. package/dist_ts/classes.gatewayclient.js +336 -0
  20. package/dist_ts/classes.gatewayclientstore.d.ts +97 -0
  21. package/dist_ts/classes.gatewayclientstore.js +261 -0
  22. package/dist_ts/classes.inferencerouter.d.ts +9 -0
  23. package/dist_ts/classes.inferencerouter.js +11 -1
  24. package/dist_ts/classes.inferenceservice.d.ts +9 -0
  25. package/dist_ts/classes.inferenceservice.js +27 -1
  26. package/dist_ts/classes.mcpclient.d.ts +4 -1
  27. package/dist_ts/classes.mcpclient.js +19 -1
  28. package/dist_ts/classes.mcpcontrollerhost.d.ts +3 -1
  29. package/dist_ts/classes.mcpcontrollerhost.js +9 -1
  30. package/dist_ts/classes.mcptools.d.ts +3 -3
  31. package/dist_ts/classes.mcptools.js +26 -1
  32. package/dist_ts/classes.mcpvalidation.js +7 -1
  33. package/dist_ts/classes.proxycontrol.d.ts +11 -0
  34. package/dist_ts/classes.proxycontrol.js +7 -1
  35. package/dist_ts/classes.proxycontrolclient.d.ts +17 -0
  36. package/dist_ts/classes.proxycontrolclient.js +35 -1
  37. package/dist_ts/classes.proxydaemon.js +8 -1
  38. package/dist_ts/classes.proxymonitor.d.ts +7 -0
  39. package/dist_ts/classes.proxymonitor.js +13 -1
  40. package/dist_ts/classes.trustedproxysecrets.d.ts +2 -0
  41. package/dist_ts/classes.trustedproxysecrets.js +5 -1
  42. package/dist_ts/functions.controllermanagementsurface.d.ts +4 -0
  43. package/dist_ts/functions.controllermanagementsurface.js +15 -1
  44. package/dist_ts/functions.gatewaycli.d.ts +24 -0
  45. package/dist_ts/functions.gatewaycli.js +395 -0
  46. package/dist_ts/functions.gatewayroute.d.ts +135 -0
  47. package/dist_ts/functions.gatewayroute.js +366 -0
  48. package/dist_ts/functions.inferencecli.js +30 -1
  49. package/dist_ts/functions.inferencecliarguments.d.ts +8 -2
  50. package/dist_ts/functions.inferencecliarguments.js +31 -3
  51. package/dist_ts/functions.proxycapacity.d.ts +50 -0
  52. package/dist_ts/functions.proxycapacity.js +142 -0
  53. package/dist_ts/functions.proxycapacitycli.d.ts +30 -0
  54. package/dist_ts/functions.proxycapacitycli.js +65 -0
  55. package/dist_ts/functions.remotecli.d.ts +30 -3
  56. package/dist_ts/functions.remotecli.js +44 -18
  57. package/dist_ts/interfaces.auth.d.ts +25 -4
  58. package/dist_ts/interfaces.auth.js +7 -1
  59. package/dist_ts/plugins.d.ts +2 -0
  60. package/dist_ts/plugins.js +4 -1
  61. package/dist_ts_authswitch/authority-placement.js +3 -17
  62. package/dist_ts_authswitch/authority-usagelimit.d.ts +29 -0
  63. package/dist_ts_authswitch/authority-usagelimit.js +66 -2
  64. package/dist_ts_authswitch/authority-usagewindows.d.ts +6 -0
  65. package/dist_ts_authswitch/authority-usagewindows.js +15 -1
  66. package/dist_ts_interfaces/gateway.d.ts +151 -0
  67. package/dist_ts_interfaces/gateway.js +66 -0
  68. package/dist_ts_interfaces/index.d.ts +2 -0
  69. package/dist_ts_interfaces/index.js +3 -1
  70. package/dist_ts_interfaces/management.d.ts +4 -4
  71. package/dist_ts_interfaces/management.js +3 -2
  72. package/dist_ts_interfaces/mcprequests.d.ts +14 -2
  73. package/dist_ts_interfaces/mcprequests.js +2 -1
  74. package/dist_ts_interfaces/proxycapacity.d.ts +99 -0
  75. package/dist_ts_interfaces/proxycapacity.js +74 -0
  76. package/package.json +4 -3
  77. package/readme.md +79 -5
  78. package/ts/00_commitinfo_data.ts +1 -1
  79. package/ts/aglapi/aglapisurface.document.ts +324 -0
  80. package/ts/aglapi/interfaces.ts +1 -0
  81. package/ts/classes.authmodels.ts +22 -3
  82. package/ts/classes.authstore.ts +15 -1
  83. package/ts/classes.cli.ts +7 -3
  84. package/ts/classes.controller.ts +134 -3
  85. package/ts/classes.controllermanagement.ts +40 -7
  86. package/ts/classes.gatewayclient.ts +401 -0
  87. package/ts/classes.gatewayclientstore.ts +272 -0
  88. package/ts/classes.inferencerouter.ts +12 -0
  89. package/ts/classes.inferenceservice.ts +27 -0
  90. package/ts/classes.mcpclient.ts +18 -0
  91. package/ts/classes.mcpcontrollerhost.ts +13 -0
  92. package/ts/classes.mcptools.ts +30 -2
  93. package/ts/classes.mcpvalidation.ts +5 -0
  94. package/ts/classes.proxycontrol.ts +16 -0
  95. package/ts/classes.proxycontrolclient.ts +30 -0
  96. package/ts/classes.proxydaemon.ts +8 -0
  97. package/ts/classes.proxymonitor.ts +12 -0
  98. package/ts/classes.trustedproxysecrets.ts +5 -0
  99. package/ts/functions.controllermanagementsurface.ts +15 -0
  100. package/ts/functions.gatewaycli.ts +436 -0
  101. package/ts/functions.gatewayroute.ts +429 -0
  102. package/ts/functions.inferencecli.ts +24 -0
  103. package/ts/functions.inferencecliarguments.ts +30 -4
  104. package/ts/functions.proxycapacity.ts +191 -0
  105. package/ts/functions.proxycapacitycli.ts +104 -0
  106. package/ts/functions.remotecli.ts +56 -20
  107. package/ts/interfaces.auth.ts +28 -4
  108. package/ts/plugins.ts +5 -0
  109. package/ts_authswitch/authority-placement.ts +2 -15
  110. package/ts_authswitch/authority-usagelimit.ts +84 -1
  111. package/ts_authswitch/authority-usagewindows.ts +13 -0
  112. package/ts_interfaces/gateway.ts +242 -0
  113. package/ts_interfaces/index.ts +2 -0
  114. package/ts_interfaces/management.ts +6 -4
  115. package/ts_interfaces/mcprequests.ts +18 -0
  116. package/ts_interfaces/proxycapacity.ts +162 -0
  117. package/ts_web/00_commitinfo_data.ts +1 -1
  118. package/ts_web/classes.browserpresentation.ts +13 -5
  119. package/ts_web/elements.accounts.ts +40 -113
  120. package/ts_web/elements.configurationpane.ts +24 -37
  121. package/ts_web/elements.devices.ts +4 -17
  122. package/ts_web/elements.flexlimitstrip.ts +21 -70
  123. package/ts_web/elements.harnesscontrollerapp.ts +91 -185
@@ -0,0 +1,395 @@
1
+ import * as plugins from './plugins.js';
2
+ import { defaultControllerPort } from './classes.config.js';
3
+ import { tryQueryControllerStatus } from './classes.cli.js';
4
+ import { requestControllerGatewaySync } from './classes.controllermanagement.js';
5
+ import { ControllerGatewayClientStore, controllerGatewayEnrolment, } from './classes.gatewayclientstore.js';
6
+ import { TpmSecretCodec } from './classes.tpmsecretcodec.js';
7
+ import { configurationLocalCliActor } from './functions.configurationactor.js';
8
+ import { deleteGatewayRoute, deleteGatewayRoutes, gatewayAppId, gatewayClientIdFor, gatewayClientProvisioningSpec, GatewayClientTransport, gatewayClientType, gatewayProblemOf, gatewayRouteKey, gatewayRouteOwnership, isLoopbackHost, normalizeGatewayTargetHost, normalizeGatewayUrl, } from './functions.gatewayroute.js';
9
+ import { audited, readStandardInputSecret, withStoppedController, } from './functions.remotecli.js';
10
+ export const gatewayCliHelp = `Usage: agl remote gateway enrol [--gateway-url URL] [--target-host HOST] [--port PORT] < ADMIN_TOKEN_FILE
11
+ agl remote gateway status [--json] [--port PORT]
12
+ agl remote gateway sync [--rotate] [--port PORT]
13
+ agl remote gateway remove [--abandon] [--port PORT]
14
+ The controller on PORT (default 4097) keeps its own route on a dcrouter gateway, as a gateway client of type custom:
15
+ https://HOST of its public origin, TLS ended at the gateway, forwarded with the trusted-proxy secret to HOST:PORT,
16
+ reachable from private networks only (source profile LOCAL NETWORK, directly at the hub and over its VPN, never through
17
+ RemoteIngress), with the gateway's own DNS record. The running controller syncs it in the background: at start, again
18
+ after six hours, and with backoff from 30 s to 15 min after a failure a later sync can fix. A gateway without
19
+ routes.requestHeaders (before dcrouter 34.5.0) gets no route and is waited for: asked again with that backoff, then
20
+ every six hours and at every sync. A failure only the operator can fix (a revoked or stale credential, a refused
21
+ route, a DNS conflict) stops the syncs until the next start or sync; status names it.
22
+ enrol runs against a stopped controller behind its gateway (agl remote set first). It reads a gateway admin token
23
+ from standard input, a pipe or a file, never a terminal, provisions the gateway client agl-<installation>-PORT with
24
+ exactly this route and its own credential, and keeps that credential sealed with the TPM; the admin token is used
25
+ once and never stored or printed: revoke it afterwards. --gateway-url is the gateway's API base URL (requests go to
26
+ URL/typedrequest): https, plain http only on loopback (127.0.0.0/8, ::1, localhost), for every request carries a
27
+ credential. --target-host is the address the gateway reaches this host by; both are required the first time and
28
+ kept for the next. Run it again to finish an enrolment whose confirmation was lost (no token needed then), or to
29
+ renew the credential.
30
+ status shows the enrolment and the last sync, from the running controller or, while it is stopped, from its
31
+ database. sync asks the running controller to sync now; --rotate first rotates the trusted-proxy secret, which the
32
+ previous secret stays valid for until a sync carried the new one to the route.
33
+ remove runs against a stopped controller: it deletes the route and its DNS record on the gateway and forgets the
34
+ credential. --abandon forgets the enrolment without reaching the gateway and prints the route left behind, for a
35
+ gateway admin to delete.
36
+ `;
37
+ export const parseGatewayCliArguments = (argsArg) => {
38
+ const rest = [...argsArg];
39
+ const action = rest.shift();
40
+ if (action !== 'enrol' && action !== 'status' && action !== 'sync' && action !== 'remove')
41
+ throw new Error(gatewayCliHelp);
42
+ const flags = {
43
+ enrol: ['--gateway-url', '--target-host'], status: ['--json'], sync: ['--rotate'], remove: ['--abandon'],
44
+ };
45
+ const booleanFlags = new Set(['--json', '--rotate', '--abandon']);
46
+ let port = defaultControllerPort;
47
+ const values = new Map();
48
+ const switches = new Set();
49
+ const seen = new Set();
50
+ for (let index = 0; index < rest.length; index++) {
51
+ const token = rest[index];
52
+ const equals = token.startsWith('--') ? token.indexOf('=') : -1;
53
+ const flag = equals > 0 ? token.slice(0, equals) : token;
54
+ if (flag !== '--port' && !flags[action].includes(flag))
55
+ throw new Error(`Unknown remote gateway option: ${flag}.`);
56
+ if (seen.has(flag))
57
+ throw new Error(`Duplicate remote gateway option: ${flag}.`);
58
+ seen.add(flag);
59
+ if (booleanFlags.has(flag)) {
60
+ if (equals > 0)
61
+ throw new Error(`${flag} takes no value.`);
62
+ switches.add(flag);
63
+ continue;
64
+ }
65
+ const value = equals > 0 ? token.slice(equals + 1) : rest[++index];
66
+ if (value === undefined || value === '' || (equals < 0 && value.startsWith('--')))
67
+ throw new Error(`${flag} requires a value.`);
68
+ if (flag === '--port')
69
+ port = Number(value);
70
+ else
71
+ values.set(flag, value);
72
+ }
73
+ if (!/^[1-9][0-9]{0,4}$/u.test(String(port)) || port > 65_535)
74
+ throw new Error('--port must be an integer between 1 and 65535.');
75
+ if (action === 'enrol') {
76
+ const gatewayUrl = values.get('--gateway-url');
77
+ const targetHost = values.get('--target-host');
78
+ return { action, port, ...(gatewayUrl === undefined ? {} : { gatewayUrl }), ...(targetHost === undefined ? {} : { targetHost }) };
79
+ }
80
+ if (action === 'status')
81
+ return { action, port, json: switches.has('--json') };
82
+ if (action === 'sync')
83
+ return { action, port, rotate: switches.has('--rotate') };
84
+ return { action, port, abandon: switches.has('--abandon') };
85
+ };
86
+ /** A gateway admin token is one line of visible ASCII; it is checked only for that, never printed. */
87
+ const gatewayAdminTokenPattern = /^[\x21-\x7e]{8,4096}$/u;
88
+ const readAdminToken = async (inputArg, portArg) => {
89
+ const token = await readStandardInputSecret(inputArg, 'agl remote gateway enrol reads the gateway admin token from a pipe or a file, never from a terminal: run it as '
90
+ + `\`agl remote gateway enrol --port ${portArg} < ADMIN_TOKEN_FILE\`.`, 'a gateway admin token');
91
+ if (!gatewayAdminTokenPattern.test(token)) {
92
+ throw new Error('The standard input holds no gateway admin token: one line of visible characters.');
93
+ }
94
+ return token;
95
+ };
96
+ const auditGateway = (specArg, portArg) => ({
97
+ gatewayUrl: specArg.gatewayUrl,
98
+ gatewayClientId: specArg.gatewayClientId,
99
+ appId: specArg.appId,
100
+ hostname: specArg.hostname,
101
+ targetHost: specArg.targetHost,
102
+ targetPort: portArg,
103
+ routeKey: gatewayRouteKey(specArg),
104
+ });
105
+ const sameSpec = (leftArg, rightArg) => (leftArg.gatewayUrl === rightArg.gatewayUrl && leftArg.gatewayClientId === rightArg.gatewayClientId
106
+ && leftArg.appId === rightArg.appId && leftArg.hostname === rightArg.hostname && leftArg.targetHost === rightArg.targetHost);
107
+ const sleep = (msArg) => new Promise((resolve) => { setTimeout(resolve, msArg); });
108
+ /**
109
+ * Asks the gateway to confirm a stored candidate, again after each delay while it does not answer, and makes it the
110
+ * active credential once confirmed: dcrouter answers a confirmation it already made with the same success. A refusal
111
+ * (superseded, revoked) drops the candidate. One that never got an answer keeps it for the next `enrol`.
112
+ */
113
+ const finalizeCandidate = async (storeArg, candidateArg, delaysMsArg) => {
114
+ const token = await storeArg.unseal(candidateArg);
115
+ const transport = new GatewayClientTransport(candidateArg.gatewayUrl);
116
+ let unanswered = '';
117
+ for (let attempt = 0; attempt <= delaysMsArg.length; attempt++) {
118
+ if (attempt > 0)
119
+ await sleep(delaysMsArg[attempt - 1]);
120
+ let result;
121
+ try {
122
+ result = await transport.fire('finalizeGatewayClientCredential', {
123
+ apiToken: token,
124
+ tokenId: candidateArg.tokenId,
125
+ });
126
+ }
127
+ catch (errorArg) {
128
+ unanswered = gatewayProblemOf(errorArg).message;
129
+ continue;
130
+ }
131
+ if (result.success) {
132
+ if (result.gatewayClientId !== candidateArg.gatewayClientId || result.tokenId !== candidateArg.tokenId) {
133
+ throw new Error('The gateway confirmed another credential than the one it issued.');
134
+ }
135
+ await storeArg.promoteCandidate(candidateArg.tokenId);
136
+ return { finalized: true };
137
+ }
138
+ const message = String(result.message).slice(0, 512);
139
+ if (/not initialized/u.test(message)) {
140
+ unanswered = `The gateway is not ready: ${message}`;
141
+ continue;
142
+ }
143
+ await storeArg.dropCandidate(candidateArg.tokenId);
144
+ return { finalized: false, refusal: message };
145
+ }
146
+ throw new Error(`The gateway did not confirm the enrolment. ${unanswered} The credential it issued is stored sealed: `
147
+ + 'run `agl remote gateway enrol` again to finish it; that needs no admin token.');
148
+ };
149
+ /**
150
+ * Deletes every route the credential's gateway client holds on its gateway, with its DNS record, and the route its
151
+ * enrolment names in case the gateway lists it no more; a failure names `--abandon`.
152
+ */
153
+ const deleteEnrolmentRoutes = async (storeArg, credentialArg, portArg) => {
154
+ try {
155
+ const token = await storeArg.unseal(credentialArg);
156
+ const transport = new GatewayClientTransport(credentialArg.gatewayUrl);
157
+ const deleted = await deleteGatewayRoutes(transport, token, () => false);
158
+ const own = gatewayRouteKey(credentialArg);
159
+ if (!deleted.includes(own)) {
160
+ await deleteGatewayRoute(transport, token, gatewayRouteOwnership({ ...credentialArg, targetPort: portArg }));
161
+ }
162
+ return deleted.includes(own) ? deleted : [...deleted, own];
163
+ }
164
+ catch (errorArg) {
165
+ throw new Error(`The route ${gatewayRouteKey(credentialArg)} on ${credentialArg.gatewayUrl} could not be deleted: `
166
+ + `${gatewayProblemOf(errorArg).message} Retry, or forget the enrolment with \`agl remote gateway remove --abandon `
167
+ + `--port ${portArg}\` and have a gateway admin delete the route.`, { cause: errorArg });
168
+ }
169
+ };
170
+ const enrol = async (parsedArg, optionsArg) => withStoppedController(parsedArg.port, async (controllerArg) => {
171
+ const { config, controllerId, issuer } = controllerArg;
172
+ const port = parsedArg.port;
173
+ const origin = new URL(config.publicOrigin);
174
+ if (config.tlsMode !== 'proxy' || origin.protocol !== 'https:' || origin.port !== '') {
175
+ throw new Error(`${controllerId} is not behind its gateway: move it to its public origin with \`agl remote set `
176
+ + `--public-origin https://HOST --gateway-source ADDRESS --port ${port}\` first.`);
177
+ }
178
+ const hostname = origin.hostname;
179
+ if (!plugins.servezoneInterfaces.data.isGatewayClientHostname(hostname)) {
180
+ throw new Error(`The public origin ${config.publicOrigin} has no hostname a gateway route can serve.`);
181
+ }
182
+ const store = new ControllerGatewayClientStore({
183
+ controllerId,
184
+ issuerId: issuer.issuerId,
185
+ codec: optionsArg.codec ?? new TpmSecretCodec(),
186
+ });
187
+ const record = await store.read();
188
+ const known = record?.candidate ?? record?.active;
189
+ // A kept URL is held to the same rule as a new one.
190
+ const keptUrl = parsedArg.gatewayUrl ?? known?.gatewayUrl;
191
+ const gatewayUrl = keptUrl === undefined ? undefined : normalizeGatewayUrl(keptUrl);
192
+ const targetHost = parsedArg.targetHost === undefined ? known?.targetHost : normalizeGatewayTargetHost(parsedArg.targetHost);
193
+ if (gatewayUrl === undefined || targetHost === undefined) {
194
+ throw new Error('The first agl remote gateway enrol needs --gateway-url and --target-host.');
195
+ }
196
+ if (!isLoopbackHost(targetHost) && !config.gatewaySources) {
197
+ throw new Error(`${controllerId} listens on loopback only, so the gateway cannot reach ${targetHost}:${port}: name `
198
+ + `the gateway's source address with \`agl remote set --public-origin ${config.publicOrigin} --gateway-source ADDRESS `
199
+ + `--port ${port}\` first.`);
200
+ }
201
+ const spec = {
202
+ gatewayUrl,
203
+ gatewayClientId: gatewayClientIdFor(issuer.issuerId, port),
204
+ appId: gatewayAppId(port),
205
+ hostname,
206
+ targetHost,
207
+ };
208
+ const delays = optionsArg.finalizeRetryDelaysMs ?? [1_000, 3_000];
209
+ const finished = await audited(controllerArg.authStore, 'remote.gateway.enrol', async () => {
210
+ // An enrolment whose confirmation was lost is finished with its own credential.
211
+ if (record?.candidate && sameSpec(record.candidate, spec)) {
212
+ if ((await finalizeCandidate(store, record.candidate, delays)).finalized)
213
+ return 'finished';
214
+ }
215
+ // The routes of a credential for another gateway or hostname would stay behind: they go first.
216
+ const active = (await store.read())?.active;
217
+ if (active && (active.gatewayUrl !== spec.gatewayUrl || active.hostname !== spec.hostname)) {
218
+ await deleteEnrolmentRoutes(store, active, port);
219
+ }
220
+ const adminToken = await readAdminToken(optionsArg.input ?? process.stdin, port);
221
+ const transport = new GatewayClientTransport(spec.gatewayUrl);
222
+ let provisioned;
223
+ try {
224
+ provisioned = await transport.fire('provisionGatewayClientCredential', {
225
+ apiToken: adminToken,
226
+ provisioning: gatewayClientProvisioningSpec({ ...spec, targetPort: port }),
227
+ credentialName: `AGL ${spec.appId} ${spec.hostname}`,
228
+ expiresInDays: null,
229
+ });
230
+ }
231
+ catch (errorArg) {
232
+ throw new Error(`The gateway did not provision the client: ${gatewayProblemOf(errorArg).message}`, { cause: errorArg });
233
+ }
234
+ if (!provisioned.success)
235
+ throw new Error(`The gateway refused to provision the client: ${String(provisioned.message).slice(0, 512)}`);
236
+ if (provisioned.gatewayClient.id !== spec.gatewayClientId || provisioned.gatewayClient.type !== gatewayClientType
237
+ || provisioned.credential.state !== 'candidate') {
238
+ throw new Error('The gateway provisioned another client than the one asked for.');
239
+ }
240
+ // Sealed and stored before the confirmation is asked for: a lost answer is retried with the same credential.
241
+ const candidate = await store.storeCandidate(spec, provisioned.credential.tokenId, provisioned.credential.tokenValue);
242
+ const confirmed = await finalizeCandidate(store, candidate, delays);
243
+ if (!confirmed.finalized)
244
+ throw new Error(`The gateway refused to confirm the credential it issued: ${confirmed.refusal}`);
245
+ return provisioned.action;
246
+ }, { gateway: auditGateway(spec, port) });
247
+ return [
248
+ `Enrolled ${controllerId} with the gateway at ${spec.gatewayUrl} as gateway client ${spec.gatewayClientId}`
249
+ + `${finished === 'finished' ? ' (finished the enrolment it had begun)' : ` (${finished})`}.`,
250
+ `Its route: https://${hostname} → ${targetHost}:${port}, LOCAL NETWORK only (${gatewayRouteKey(spec)}).`,
251
+ 'The credential is sealed in the controller\'s database; the admin token was not stored: revoke it now.',
252
+ `\`agl start --port ${port}\` syncs the route in the background; \`agl remote gateway status --port ${port}\` shows it.`,
253
+ ].join('\n') + '\n';
254
+ });
255
+ const remove = async (parsedArg, optionsArg) => withStoppedController(parsedArg.port, async (controllerArg) => {
256
+ const { controllerId, issuer } = controllerArg;
257
+ const port = parsedArg.port;
258
+ const store = new ControllerGatewayClientStore({
259
+ controllerId,
260
+ issuerId: issuer.issuerId,
261
+ codec: optionsArg.codec ?? new TpmSecretCodec(),
262
+ });
263
+ const record = await store.read();
264
+ const credential = record?.active ?? record?.candidate;
265
+ if (!record || !credential)
266
+ return `${controllerId} is not enrolled with a gateway; nothing to remove.\n`;
267
+ const details = { gateway: auditGateway(credential, port) };
268
+ const routeKeys = [...new Set([record.active, record.candidate]
269
+ .filter((entryArg) => entryArg !== undefined)
270
+ .map((entryArg) => gatewayRouteKey(entryArg)))];
271
+ if (parsedArg.abandon) {
272
+ await audited(controllerArg.authStore, 'remote.gateway.abandon', async () => { await store.forget(); }, details);
273
+ return [
274
+ `Forgot the gateway enrolment of ${controllerId} without reaching ${credential.gatewayUrl}.`,
275
+ `Left behind on the gateway: the route ${routeKeys.join(' and ')} with its DNS record, and the gateway client `
276
+ + `${credential.gatewayClientId} with its credential.`,
277
+ `A gateway admin deletes them: in the gateway's Ops UI, delete the route under Routes and the gateway client `
278
+ + `${credential.gatewayClientId} under Access → Gateway Clients (that revokes its credentials).`,
279
+ ].join('\n') + '\n';
280
+ }
281
+ const deleted = await audited(controllerArg.authStore, 'remote.gateway.remove', async () => {
282
+ const routes = record.active ? await deleteEnrolmentRoutes(store, record.active, port) : [];
283
+ await store.forget();
284
+ return routes;
285
+ }, details);
286
+ return [
287
+ `Removed the gateway enrolment of ${controllerId}: ${deleted.length > 0
288
+ ? `deleted ${deleted.join(', ')} with ${deleted.length === 1 ? 'its DNS record' : 'their DNS records'}`
289
+ : 'no route had been written'} and forgot the credential.`,
290
+ `The gateway client ${credential.gatewayClientId} stays on ${credential.gatewayUrl} without a route until a gateway admin `
291
+ + 'deletes it (Access → Gateway Clients), which revokes its credential.',
292
+ ].join('\n') + '\n';
293
+ });
294
+ /** The gateway status a stopped controller's database holds. */
295
+ const storedStatus = (recordArg, portArg) => {
296
+ const credential = recordArg?.active ?? recordArg?.candidate;
297
+ if (!recordArg || !credential)
298
+ return { state: 'not_enrolled' };
299
+ const lastSync = recordArg.lastSync;
300
+ return {
301
+ state: recordArg.candidate ? 'finalize_pending' : 'stopped',
302
+ enrolment: controllerGatewayEnrolment(credential, portArg),
303
+ ...(lastSync?.syncedAt === undefined ? {} : { lastSyncedAt: lastSync.syncedAt }),
304
+ ...(lastSync?.dns ? { dns: lastSync.dns } : {}),
305
+ ...(lastSync?.sourceProfileVerified === undefined ? {} : { sourceProfileVerified: lastSync.sourceProfileVerified }),
306
+ ...(lastSync?.problem ? { problem: lastSync.problem } : {}),
307
+ };
308
+ };
309
+ const time = (valueArg) => new Date(valueArg).toISOString();
310
+ export const formatGatewayStatus = (portArg, runningArg, statusArg) => {
311
+ const lines = [`Gateway client of controller:${portArg} (${runningArg ? 'running' : 'stopped'}): ${statusArg.state.replace(/_/gu, ' ')}`];
312
+ const enrolment = statusArg.enrolment;
313
+ if (enrolment) {
314
+ lines.push(` gateway: ${enrolment.gatewayUrl} as ${enrolment.gatewayClientId}, enrolled ${time(enrolment.enrolledAt)}`);
315
+ lines.push(` route: https://${enrolment.hostname} → ${enrolment.target.host}:${enrolment.target.port}, LOCAL NETWORK only `
316
+ + `(${gatewayRouteKey(enrolment)})`);
317
+ }
318
+ if (statusArg.lastSyncedAt !== undefined) {
319
+ lines.push(` last synced: ${time(statusArg.lastSyncedAt)}${statusArg.dns ? `, DNS ${statusArg.dns.status}`
320
+ + `${statusArg.dns.owned ? '' : ' (not owned: records the gateway does not manage satisfy it)'}` : ''}`);
321
+ if (statusArg.sourceProfileVerified !== undefined) {
322
+ lines.push(` source profile: ${statusArg.sourceProfileVerified ? 'LOCAL NETWORK (verified)'
323
+ : 'profile unverified (the gateway does not name the profile it bound)'}`);
324
+ }
325
+ }
326
+ else if (enrolment) {
327
+ lines.push(' last synced: never');
328
+ }
329
+ if (statusArg.problem)
330
+ lines.push(` problem (${statusArg.problem.code}): ${statusArg.problem.message}`);
331
+ if (statusArg.nextSyncAt !== undefined)
332
+ lines.push(` next sync: ${time(statusArg.nextSyncAt)}`);
333
+ if (statusArg.rotationPending)
334
+ lines.push(' secret rotation: waiting for a sync that carries the new secret to the route');
335
+ return `${lines.join('\n')}\n`;
336
+ };
337
+ const status = async (parsedArg, optionsArg) => {
338
+ const running = await tryQueryControllerStatus(parsedArg.port);
339
+ let gateway;
340
+ if (running) {
341
+ if (!running.gateway) {
342
+ throw new Error(`The controller on port ${parsedArg.port} reports no gateway client: it runs an earlier release.`);
343
+ }
344
+ gateway = running.gateway;
345
+ }
346
+ else {
347
+ gateway = await withStoppedController(parsedArg.port, async (controllerArg) => storedStatus(await new ControllerGatewayClientStore({
348
+ controllerId: controllerArg.controllerId,
349
+ issuerId: controllerArg.issuer.issuerId,
350
+ codec: optionsArg.codec ?? new TpmSecretCodec(),
351
+ }).read(), parsedArg.port));
352
+ }
353
+ return parsedArg.json
354
+ ? `${JSON.stringify({ port: parsedArg.port, controller: running ? 'running' : 'stopped', gateway }, null, 2)}\n`
355
+ : formatGatewayStatus(parsedArg.port, running !== undefined, gateway);
356
+ };
357
+ const sync = async (parsedArg) => {
358
+ const running = await tryQueryControllerStatus(parsedArg.port);
359
+ if (!running) {
360
+ throw new Error(`No controller runs on port ${parsedArg.port}: \`agl start --port ${parsedArg.port}\` syncs its route as it starts.`);
361
+ }
362
+ if (!running.gateway) {
363
+ throw new Error(`The controller on port ${parsedArg.port} reports no gateway client: it runs an earlier release.`);
364
+ }
365
+ const gateway = await requestControllerGatewaySync(parsedArg.port, running, {
366
+ rotate: parsedArg.rotate,
367
+ localCli: await configurationLocalCliActor(),
368
+ });
369
+ return { text: formatGatewayStatus(parsedArg.port, true, gateway), synced: gateway.state === 'synced' };
370
+ };
371
+ export const runGatewayCli = async (argsArg, optionsArg = {}) => {
372
+ const write = optionsArg.write ?? ((textArg) => { process.stdout.write(textArg); });
373
+ if (argsArg.length === 0 || argsArg.includes('--help') || argsArg.includes('-h')) {
374
+ write(gatewayCliHelp);
375
+ return;
376
+ }
377
+ const parsed = parseGatewayCliArguments(argsArg);
378
+ if (parsed.action === 'enrol') {
379
+ write(await enrol(parsed, optionsArg));
380
+ return;
381
+ }
382
+ if (parsed.action === 'remove') {
383
+ write(await remove(parsed, optionsArg));
384
+ return;
385
+ }
386
+ if (parsed.action === 'status') {
387
+ write(await status(parsed, optionsArg));
388
+ return;
389
+ }
390
+ const outcome = await sync(parsed);
391
+ write(outcome.text);
392
+ if (!outcome.synced)
393
+ throw new Error('The gateway route was not synced; the problem above says why.');
394
+ };
395
+ //# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiZnVuY3Rpb25zLmdhdGV3YXljbGkuanMiLCJzb3VyY2VSb290IjoiIiwic291cmNlcyI6WyIuLi8uLi90cy9mdW5jdGlvbnMuZ2F0ZXdheWNsaS50cyJdLCJuYW1lcyI6W10sIm1hcHBpbmdzIjoiQUFBQSxPQUFPLEtBQUssT0FBTyxNQUFNLGNBQWMsQ0FBQztBQUN4QyxPQUFPLEVBQUUscUJBQXFCLEVBQUUsTUFBTSxxQkFBcUIsQ0FBQztBQUM1RCxPQUFPLEVBQUUsd0JBQXdCLEVBQUUsTUFBTSxrQkFBa0IsQ0FBQztBQUM1RCxPQUFPLEVBQUUsNEJBQTRCLEVBQUUsTUFBTSxtQ0FBbUMsQ0FBQztBQUNqRixPQUFPLEVBQ0wsNEJBQTRCLEVBQzVCLDBCQUEwQixHQUkzQixNQUFNLGlDQUFpQyxDQUFDO0FBQ3pDLE9BQU8sRUFBRSxjQUFjLEVBQUUsTUFBTSw2QkFBNkIsQ0FBQztBQUM3RCxPQUFPLEVBQUUsMEJBQTBCLEVBQUUsTUFBTSxtQ0FBbUMsQ0FBQztBQUMvRSxPQUFPLEVBQ0wsa0JBQWtCLEVBQ2xCLG1CQUFtQixFQUNuQixZQUFZLEVBQ1osa0JBQWtCLEVBQ2xCLDZCQUE2QixFQUM3QixzQkFBc0IsRUFDdEIsaUJBQWlCLEVBQ2pCLGdCQUFnQixFQUNoQixlQUFlLEVBQ2YscUJBQXFCLEVBQ3JCLGNBQWMsRUFDZCwwQkFBMEIsRUFDMUIsbUJBQW1CLEdBQ3BCLE1BQU0sNkJBQTZCLENBQUM7QUFDckMsT0FBTyxFQUNMLE9BQU8sRUFDUCx1QkFBdUIsRUFDdkIscUJBQXFCLEdBRXRCLE1BQU0sMEJBQTBCLENBQUM7QUFPbEMsTUFBTSxDQUFDLE1BQU0sY0FBYyxHQUFHOzs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7OztDQTBCN0IsQ0FBQztBQVFGLE1BQU0sQ0FBQyxNQUFNLHdCQUF3QixHQUFHLENBQUMsT0FBMEIsRUFBd0IsRUFBRTtJQUMzRixNQUFNLElBQUksR0FBRyxDQUFDLEdBQUcsT0FBTyxDQUFDLENBQUM7SUFDMUIsTUFBTSxNQUFNLEdBQUcs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
@@ -0,0 +1,135 @@
1
+ import * as plugins from './plugins.js';
2
+ import type { IControllerGatewayDns, IControllerGatewayProblem } from '../dist_ts_interfaces/index.js';
3
+ type IGatewayCapabilities = plugins.servezoneInterfaces.data.IGatewayCapabilities;
4
+ type IGatewayClientOwnership = plugins.servezoneInterfaces.data.IGatewayClientOwnership;
5
+ type IGatewayClientProvisioningSpec = plugins.servezoneInterfaces.data.IGatewayClientProvisioningSpec;
6
+ type IGatewayClientRoute = plugins.servezoneInterfaces.data.IGatewayClientRoute;
7
+ type IGatewayRouteSyncResult = plugins.servezoneInterfaces.data.IGatewayRouteSyncResult;
8
+ type IReq_GetGatewayClientContext = plugins.servezoneInterfaces.requests.gateway.IReq_GetGatewayClientContext;
9
+ type IReq_SyncGatewayClientRoute = plugins.servezoneInterfaces.requests.gateway.IReq_SyncGatewayClientRoute;
10
+ /**
11
+ * AGL's side of the gateway-client protocol of a dcrouter (`@serve.zone/interfaces` `requests.gateway`, served by
12
+ * dcrouter's `GatewayClientHandler`): the route AGL keeps for its own public hostname, the policy it provisions for
13
+ * itself, and how it reads the gateway's answers. Every request carries the credential as `apiToken` and is sent with
14
+ * no TypedRequest hooks, so no hook ever sees it.
15
+ */
16
+ /** The gateway's source profile AGL's route is bound to, by name on every sync: private networks only. */
17
+ export declare const gatewayLocalNetworkSourceProfile = "LOCAL NETWORK";
18
+ /** The gateway-client type AGL registers as. */
19
+ export declare const gatewayClientType = "custom";
20
+ /** The request header the route sets with the trusted-proxy secret, which the controller's admission checks. */
21
+ export declare const gatewayRouteSecretHeader = "x-harness-controller-proxy-secret";
22
+ /** What the credential must allow: list its routes (stale ones are deleted), write them, and reconcile their DNS. */
23
+ export declare const gatewayRequiredTokenCapabilities: readonly ["readRoutes", "syncRoutes", "syncDnsRecords"];
24
+ /** How long one gateway request may take; DNS reconciliation runs inside a route sync. */
25
+ export declare const gatewayRequestTimeoutMs = 60000;
26
+ /** The route AGL keeps on its gateway: one per controller, for the hostname of its public origin. */
27
+ export interface IGatewayRouteSpec {
28
+ gatewayClientId: string;
29
+ /** `controller-<port>`. */
30
+ appId: string;
31
+ hostname: string;
32
+ targetHost: string;
33
+ targetPort: number;
34
+ }
35
+ /** `controller-<port>`: the app of a controller within its gateway client. */
36
+ export declare const gatewayAppId: (portArg: number) => string;
37
+ /**
38
+ * The gateway client a controller is: unique per installation and port, so two controllers never share one (a
39
+ * finalized credential revokes every older credential of its client), and stable across restarts and `agl remote set`.
40
+ * Derived from the controller database's issuer id, lowercase, so the gateway keeps it as it is.
41
+ */
42
+ export declare const gatewayClientIdFor: (issuerIdArg: string, portArg: number) => string;
43
+ /** The key the gateway files the route under (dcrouter's `externalKey`), which an admin finds it by. */
44
+ export declare const gatewayRouteKey: (specArg: Pick<IGatewayRouteSpec, 'gatewayClientId' | 'appId' | 'hostname'>) => string;
45
+ /** Whether a host is this machine's loopback: `localhost`, 127.0.0.0/8 or `::1` (a URL's hostname without its brackets). */
46
+ export declare const isLoopbackHost: (hostArg: string) => boolean;
47
+ /**
48
+ * A gateway's API base URL: `https` (`http` only on loopback), no credentials, query or fragment, no trailing slash.
49
+ * Requests go to `<url>/typedrequest`.
50
+ */
51
+ export declare const normalizeGatewayUrl: (valueArg: string) => string;
52
+ /** A route target: an IP address or a lowercase hostname of two or more labels. */
53
+ export declare const normalizeGatewayTargetHost: (valueArg: string) => string;
54
+ /** The policy AGL provisions for its own gateway client: its hostname, its target and nothing more. */
55
+ export declare const gatewayClientProvisioningSpec: (specArg: IGatewayRouteSpec) => IGatewayClientProvisioningSpec;
56
+ export declare const gatewayRouteOwnership: (specArg: IGatewayRouteSpec) => IGatewayClientOwnership;
57
+ /**
58
+ * The request headers the route sets: the trusted-proxy secret, which replaces every copy a client sent. Checked
59
+ * with the contract's own validator, whose refusals name the field and never the value.
60
+ */
61
+ export declare const gatewayRouteRequestHeaders: (routeSecretArg: string) => Record<string, string>;
62
+ /**
63
+ * The complete sync of AGL's route. Every field is sent on every sync, because the gateway fills an omitted one from
64
+ * the route it stored or a default (an omitted source profile is STANDARD, an omitted `remoteIngress` keeps an
65
+ * export to the edge, and a sync without `requestHeaders` sets none): TLS ends at the gateway with its own
66
+ * certificate, the gateway sets the trusted-proxy secret on every request and WebSocket upgrade it forwards,
67
+ * WebSockets pass, the route is reachable directly at the hub and over its VPN from private networks only
68
+ * (`LOCAL NETWORK`), never through RemoteIngress, and its DNS record is the gateway's own, unproxied.
69
+ */
70
+ export declare const gatewayRouteSyncRequest: (apiTokenArg: string, specArg: IGatewayRouteSpec, routeSecretArg: string) => IReq_SyncGatewayClientRoute['request'];
71
+ /**
72
+ * Why the route cannot carry the trusted-proxy secret on this gateway, or `undefined` when it can. AGL never writes
73
+ * a route without it: the controller refuses every request off loopback that lacks the secret, and a gateway built
74
+ * before `requestHeaders` refuses a route that carries them, so the route goes only to a gateway that announces
75
+ * `routes.requestHeaders`.
76
+ */
77
+ export declare const gatewayRouteHeaderRefusal: (capabilitiesArg: IGatewayCapabilities) => IControllerGatewayProblem | undefined;
78
+ /**
79
+ * Reads the route back after a sync: it must set the trusted-proxy secret header (`requestHeaderNames`) and be bound
80
+ * to `LOCAL NETWORK` when the gateway names the profile (`sourceProfileName`, matched as the gateway matches it:
81
+ * case-insensitively). A gateway that does not name it (before dcrouter 34.5.0) leaves the binding unverified.
82
+ */
83
+ export declare const gatewayRouteReadBack: (routesArg: readonly IGatewayClientRoute[], specArg: Pick<IGatewayRouteSpec, 'appId' | 'hostname'>) => {
84
+ problem: IControllerGatewayProblem;
85
+ } | {
86
+ problem?: undefined;
87
+ sourceProfileVerified: boolean;
88
+ };
89
+ /** A problem that ends a sync, raised from the steps of a sync and read back with `gatewayProblemOf`. */
90
+ export declare class GatewaySyncProblemError extends Error {
91
+ readonly problem: IControllerGatewayProblem;
92
+ constructor(problem: IControllerGatewayProblem);
93
+ }
94
+ /** The problem a failed gateway request ends a sync with. */
95
+ export declare const gatewayProblemOf: (errorArg: unknown) => IControllerGatewayProblem;
96
+ /**
97
+ * Checks the credential's own view (`getGatewayClientContext`): a finalized credential of this very gateway client,
98
+ * allowed to list, write and reconcile its routes, on a gateway that writes routes idempotently.
99
+ */
100
+ export declare const gatewayContextProblem: (responseArg: IReq_GetGatewayClientContext['response'], gatewayClientIdArg: string) => IControllerGatewayProblem | undefined;
101
+ /**
102
+ * Reads a route sync's answer: the route is written when the gateway says so and its DNS is the route's own record
103
+ * or manual records that satisfy it (`manual-satisfied`, which counts as success but is not owned). DNS conflicts,
104
+ * an unmanaged zone and an invalid target are terminal; other DNS failures are the provider's and are retried.
105
+ */
106
+ export declare const gatewayRouteSyncOutcome: (resultArg: IGatewayRouteSyncResult) => {
107
+ synced: true;
108
+ dns: IControllerGatewayDns;
109
+ } | {
110
+ synced: false;
111
+ problem: IControllerGatewayProblem;
112
+ };
113
+ /**
114
+ * One gateway at `<gatewayUrl>/typedrequest`, every request bounded by a timeout and the caller's signal. A URL
115
+ * `normalizeGatewayUrl` refuses for plain http off loopback is refused here too (`gateway_url_insecure`), so no stored
116
+ * enrolment sends its credential over one.
117
+ */
118
+ export declare class GatewayClientTransport {
119
+ private readonly gatewayUrl;
120
+ private readonly options;
121
+ constructor(gatewayUrl: string, options?: {
122
+ timeoutMs?: number;
123
+ signal?: AbortSignal;
124
+ });
125
+ fire<T extends plugins.typedrequestInterfaces.ITypedRequest>(methodArg: T['method'], requestArg: T['request']): Promise<T['response']>;
126
+ }
127
+ /**
128
+ * Deletes every route of the credential's gateway client that `keepArg` does not keep, with its DNS record
129
+ * (`delete: true`, DNS `reconcile`), and returns their keys. The gateway lists only the client's own routes inside
130
+ * its policy.
131
+ */
132
+ export declare const deleteGatewayRoutes: (transportArg: GatewayClientTransport, apiTokenArg: string, keepArg: (routeArg: IGatewayClientRoute) => boolean) => Promise<string[]>;
133
+ /** Deletes one route and its DNS record; deleting a route the gateway does not hold succeeds unchanged. */
134
+ export declare const deleteGatewayRoute: (transportArg: GatewayClientTransport, apiTokenArg: string, ownershipArg: IGatewayClientOwnership) => Promise<void>;
135
+ export {};