agl 43.0.5 → 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.
- package/changelog.md +30 -0
- package/dist_serve/bundle.js +5996 -5280
- package/dist_serve/bundle.js.map +2 -2
- package/dist_serve/bundle.js.third-party-notices.json +30 -30
- package/dist_serve/bundle.js.third-party-notices.txt +30 -30
- package/dist_serve/third-party-notices.md +1 -1
- package/dist_ts/00_commitinfo_data.js +1 -1
- package/dist_ts/aglapi/aglapisurface.document.js +805 -10
- package/dist_ts/aglapi/interfaces.d.ts +13 -0
- package/dist_ts/aglapi/interfaces.js +4 -1
- package/dist_ts/classes.authmodels.js +17 -4
- package/dist_ts/classes.authstore.js +16 -2
- package/dist_ts/classes.claudeharness.d.ts +14 -5
- package/dist_ts/classes.claudeharness.js +62 -2
- package/dist_ts/classes.cli.d.ts +4 -2
- package/dist_ts/classes.cli.js +6 -3
- package/dist_ts/classes.codexclientadapter.d.ts +7 -5
- package/dist_ts/classes.codexclientadapter.js +38 -3
- package/dist_ts/classes.controller.d.ts +19 -2
- package/dist_ts/classes.controller.js +234 -27
- package/dist_ts/classes.controllermanagement.d.ts +14 -4
- package/dist_ts/classes.controllermanagement.js +20 -2
- package/dist_ts/classes.gatewayclient.d.ts +115 -0
- package/dist_ts/classes.gatewayclient.js +336 -0
- package/dist_ts/classes.gatewayclientstore.d.ts +97 -0
- package/dist_ts/classes.gatewayclientstore.js +261 -0
- package/dist_ts/classes.inferencegateway.d.ts +8 -5
- package/dist_ts/classes.inferencegateway.js +62 -19
- package/dist_ts/classes.inferencerouter.d.ts +9 -0
- package/dist_ts/classes.inferencerouter.js +11 -1
- package/dist_ts/classes.inferenceservice.d.ts +9 -0
- package/dist_ts/classes.inferenceservice.js +27 -1
- package/dist_ts/classes.inferencespend.d.ts +9 -3
- package/dist_ts/classes.inferencespend.js +44 -16
- package/dist_ts/classes.mcpclient.d.ts +9 -4
- package/dist_ts/classes.mcpclient.js +24 -2
- package/dist_ts/classes.mcpcontrollerhost.d.ts +3 -1
- package/dist_ts/classes.mcpcontrollerhost.js +13 -1
- package/dist_ts/classes.mcptools.d.ts +3 -3
- package/dist_ts/classes.mcptools.js +42 -4
- package/dist_ts/classes.mcpvalidation.js +7 -1
- package/dist_ts/classes.opencodeclient.js +3 -1
- package/dist_ts/classes.proxycontrol.d.ts +33 -11
- package/dist_ts/classes.proxycontrol.js +12 -3
- package/dist_ts/classes.proxycontrolclient.d.ts +23 -5
- package/dist_ts/classes.proxycontrolclient.js +42 -6
- package/dist_ts/classes.proxydaemon.d.ts +8 -6
- package/dist_ts/classes.proxydaemon.js +42 -21
- package/dist_ts/classes.proxyleaseholder.d.ts +12 -4
- package/dist_ts/classes.proxyleaseholder.js +39 -9
- package/dist_ts/classes.proxymonitor.d.ts +7 -0
- package/dist_ts/classes.proxymonitor.js +13 -1
- package/dist_ts/classes.proxystore.d.ts +4 -3
- package/dist_ts/classes.proxystore.js +17 -7
- package/dist_ts/classes.sessionfeed.d.ts +1 -1
- package/dist_ts/classes.trustedproxysecrets.d.ts +2 -0
- package/dist_ts/classes.trustedproxysecrets.js +5 -1
- package/dist_ts/classes.validation.d.ts +7 -0
- package/dist_ts/classes.validation.js +49 -2
- package/dist_ts/driver/functions.drivertools.js +2 -2
- package/dist_ts/fleet/classes.codexworkers.d.ts +4 -11
- package/dist_ts/fleet/classes.codexworkers.js +6 -3
- package/dist_ts/fleet/classes.workers.d.ts +25 -13
- package/dist_ts/fleet/classes.workers.js +105 -9
- package/dist_ts/fleet/functions.workervalidation.d.ts +26 -1
- package/dist_ts/fleet/functions.workervalidation.js +40 -11
- package/dist_ts/fleet/interfaces.workers.d.ts +17 -11
- package/dist_ts/fleet/interfaces.workers.js +10 -1
- package/dist_ts/functions.confinedrelay.d.ts +21 -0
- package/dist_ts/functions.confinedrelay.js +65 -0
- package/dist_ts/functions.controllermanagementsurface.d.ts +4 -0
- package/dist_ts/functions.controllermanagementsurface.js +15 -1
- package/dist_ts/functions.deviceapi.d.ts +4 -2
- package/dist_ts/functions.deviceapi.js +20 -2
- package/dist_ts/functions.elicitation.d.ts +49 -0
- package/dist_ts/functions.elicitation.js +418 -0
- package/dist_ts/functions.gatewaycli.d.ts +24 -0
- package/dist_ts/functions.gatewaycli.js +395 -0
- package/dist_ts/functions.gatewayroute.d.ts +135 -0
- package/dist_ts/functions.gatewayroute.js +366 -0
- package/dist_ts/functions.inferencecli.d.ts +3 -3
- package/dist_ts/functions.inferencecli.js +62 -10
- package/dist_ts/functions.inferencecliarguments.d.ts +9 -2
- package/dist_ts/functions.inferencecliarguments.js +59 -10
- package/dist_ts/functions.inferencelaunch.d.ts +35 -7
- package/dist_ts/functions.inferencelaunch.js +143 -16
- package/dist_ts/functions.mcpfleetworkertools.d.ts +63 -70
- package/dist_ts/functions.mcpfleetworkertools.js +32 -4
- package/dist_ts/functions.proxycapacity.d.ts +50 -0
- package/dist_ts/functions.proxycapacity.js +142 -0
- package/dist_ts/functions.proxycapacitycli.d.ts +30 -0
- package/dist_ts/functions.proxycapacitycli.js +65 -0
- package/dist_ts/functions.proxycontract.d.ts +21 -4
- package/dist_ts/functions.proxycontract.js +12 -5
- package/dist_ts/functions.proxyharnessconfig.d.ts +7 -0
- package/dist_ts/functions.proxyharnessconfig.js +11 -1
- package/dist_ts/functions.remotecli.d.ts +30 -3
- package/dist_ts/functions.remotecli.js +44 -18
- package/dist_ts/interfaces.auth.d.ts +25 -4
- package/dist_ts/interfaces.auth.js +8 -1
- package/dist_ts/plugins.d.ts +2 -0
- package/dist_ts/plugins.js +4 -1
- package/dist_ts_authswitch/authority-placement.js +3 -17
- package/dist_ts_authswitch/authority-usagelimit.d.ts +29 -0
- package/dist_ts_authswitch/authority-usagelimit.js +66 -2
- package/dist_ts_authswitch/authority-usagewindows.d.ts +6 -0
- package/dist_ts_authswitch/authority-usagewindows.js +15 -1
- package/dist_ts_interfaces/devices.d.ts +133 -3
- package/dist_ts_interfaces/devices.js +3 -2
- package/dist_ts_interfaces/elicitations.d.ts +125 -0
- package/dist_ts_interfaces/elicitations.js +7 -0
- package/dist_ts_interfaces/fleetworkers.d.ts +119 -5
- package/dist_ts_interfaces/fleetworkers.js +14 -2
- package/dist_ts_interfaces/gateway.d.ts +151 -0
- package/dist_ts_interfaces/gateway.js +66 -0
- package/dist_ts_interfaces/index.d.ts +3 -0
- package/dist_ts_interfaces/index.js +4 -1
- package/dist_ts_interfaces/interfaces.d.ts +3 -1
- package/dist_ts_interfaces/interfaces.js +2 -2
- package/dist_ts_interfaces/management.d.ts +4 -4
- package/dist_ts_interfaces/management.js +3 -2
- package/dist_ts_interfaces/mcprequests.d.ts +18 -2
- package/dist_ts_interfaces/mcprequests.js +3 -1
- package/dist_ts_interfaces/nativesessions.d.ts +14 -0
- package/dist_ts_interfaces/proxycapacity.d.ts +99 -0
- package/dist_ts_interfaces/proxycapacity.js +74 -0
- package/dist_ts_interfaces/requests.d.ts +3 -3
- package/dist_ts_interfaces/requests.fleetworkers.js +2 -2
- package/dist_ts_interfaces/requests.js +1 -1
- package/dist_ts_interfaces/requests.promptreply.d.ts +18 -0
- package/dist_ts_interfaces/sessionfeed.d.ts +3 -2
- package/dist_ts_interfaces/sessionfeed.js +1 -1
- package/package.json +5 -4
- package/readme.md +267 -26
- package/third-party-notices.md +1 -1
- package/ts/00_commitinfo_data.ts +1 -1
- package/ts/aglapi/aglapisurface.document.ts +804 -9
- package/ts/aglapi/interfaces.ts +3 -0
- package/ts/classes.authmodels.ts +22 -3
- package/ts/classes.authstore.ts +15 -1
- package/ts/classes.claudeharness.ts +80 -9
- package/ts/classes.cli.ts +7 -3
- package/ts/classes.codexclientadapter.ts +41 -5
- package/ts/classes.controller.ts +276 -32
- package/ts/classes.controllermanagement.ts +40 -7
- package/ts/classes.gatewayclient.ts +401 -0
- package/ts/classes.gatewayclientstore.ts +272 -0
- package/ts/classes.inferencegateway.ts +69 -23
- package/ts/classes.inferencerouter.ts +12 -0
- package/ts/classes.inferenceservice.ts +27 -0
- package/ts/classes.inferencespend.ts +46 -13
- package/ts/classes.mcpclient.ts +26 -4
- package/ts/classes.mcpcontrollerhost.ts +17 -0
- package/ts/classes.mcptools.ts +47 -5
- package/ts/classes.mcpvalidation.ts +5 -0
- package/ts/classes.opencodeclient.ts +2 -0
- package/ts/classes.proxycontrol.ts +43 -13
- package/ts/classes.proxycontrolclient.ts +39 -6
- package/ts/classes.proxydaemon.ts +57 -27
- package/ts/classes.proxyleaseholder.ts +43 -11
- package/ts/classes.proxymonitor.ts +12 -0
- package/ts/classes.proxystore.ts +21 -8
- package/ts/classes.sessionfeed.ts +1 -1
- package/ts/classes.trustedproxysecrets.ts +5 -0
- package/ts/classes.validation.ts +52 -0
- package/ts/driver/functions.drivertools.ts +1 -1
- package/ts/fleet/classes.codexworkers.ts +8 -6
- package/ts/fleet/classes.workers.ts +101 -17
- package/ts/fleet/functions.workervalidation.ts +35 -9
- package/ts/fleet/interfaces.workers.ts +11 -4
- package/ts/functions.confinedrelay.ts +65 -0
- package/ts/functions.controllermanagementsurface.ts +15 -0
- package/ts/functions.deviceapi.ts +24 -1
- package/ts/functions.elicitation.ts +443 -0
- package/ts/functions.gatewaycli.ts +436 -0
- package/ts/functions.gatewayroute.ts +429 -0
- package/ts/functions.inferencecli.ts +62 -13
- package/ts/functions.inferencecliarguments.ts +56 -9
- package/ts/functions.inferencelaunch.ts +143 -16
- package/ts/functions.mcpfleetworkertools.ts +34 -4
- package/ts/functions.proxycapacity.ts +191 -0
- package/ts/functions.proxycapacitycli.ts +104 -0
- package/ts/functions.proxycontract.ts +17 -4
- package/ts/functions.proxyharnessconfig.ts +11 -0
- package/ts/functions.remotecli.ts +56 -20
- package/ts/interfaces.auth.ts +29 -4
- package/ts/plugins.ts +5 -0
- package/ts_authswitch/authority-placement.ts +2 -15
- package/ts_authswitch/authority-usagelimit.ts +84 -1
- package/ts_authswitch/authority-usagewindows.ts +13 -0
- package/ts_interfaces/devices.schema.json +476 -2
- package/ts_interfaces/devices.ts +146 -2
- package/ts_interfaces/elicitations.ts +148 -0
- package/ts_interfaces/fleetworkers.ts +96 -4
- package/ts_interfaces/gateway.ts +242 -0
- package/ts_interfaces/index.ts +3 -0
- package/ts_interfaces/interfaces.ts +3 -1
- package/ts_interfaces/management.ts +6 -4
- package/ts_interfaces/mcprequests.ts +19 -0
- package/ts_interfaces/nativesessions.ts +16 -0
- package/ts_interfaces/proxycapacity.ts +162 -0
- package/ts_interfaces/requests.fleetworkers.ts +1 -1
- package/ts_interfaces/requests.promptreply.ts +22 -0
- package/ts_interfaces/requests.ts +4 -0
- package/ts_interfaces/sessionfeed.ts +3 -2
- package/ts_web/00_commitinfo_data.ts +1 -1
- package/ts_web/classes.browserpresentation.ts +13 -5
- package/ts_web/classes.elicitationcards.ts +106 -0
- package/ts_web/classes.nativesessionstate.ts +38 -1
- package/ts_web/elements.accounts.ts +40 -113
- package/ts_web/elements.configurationpane.ts +24 -37
- package/ts_web/elements.devices.ts +4 -17
- package/ts_web/elements.fleetworker.ts +27 -2
- package/ts_web/elements.flexlimitstrip.ts +21 -70
- package/ts_web/elements.harnesscontrollerapp.ts +159 -186
- package/ts_web/functions.sessionchat.ts +5 -0
|
@@ -0,0 +1,336 @@
|
|
|
1
|
+
import * as plugins from './plugins.js';
|
|
2
|
+
import { ControllerGatewayClientStore, controllerGatewayEnrolment, } from './classes.gatewayclientstore.js';
|
|
3
|
+
import { deleteGatewayRoutes, gatewayContextProblem, gatewayProblemOf, gatewayRouteHeaderRefusal, gatewayRouteReadBack, gatewayRouteSyncOutcome, gatewayRouteSyncRequest, GatewayClientTransport, GatewaySyncProblemError, } from './functions.gatewayroute.js';
|
|
4
|
+
import { controllerGatewayProblemKind, } from '../dist_ts_interfaces/index.js';
|
|
5
|
+
const nodeClock = {
|
|
6
|
+
now: () => Date.now(),
|
|
7
|
+
setTimeout: (callbackArg, delayMsArg) => setTimeout(callbackArg, delayMsArg),
|
|
8
|
+
clearTimeout: (handleArg) => clearTimeout(handleArg),
|
|
9
|
+
};
|
|
10
|
+
/**
|
|
11
|
+
* When the gateway route is synced again (Linus, AGL-828): a failure a later sync can fix is retried with jittered
|
|
12
|
+
* exponential backoff from 30 s up to 15 min, reset by a sync that writes the route; a written route is synced again
|
|
13
|
+
* after six hours to repair drift; a gateway without request headers is asked again with the same backoff once, up to
|
|
14
|
+
* 15 min, and then at every six-hour sync; a terminal failure waits for the operator.
|
|
15
|
+
*/
|
|
16
|
+
export const gatewaySyncTimings = Object.freeze({
|
|
17
|
+
retryInitialMs: 30_000,
|
|
18
|
+
retryMaximumMs: 15 * 60_000,
|
|
19
|
+
/** ±20 % around the nominal delay, within the maximum. */
|
|
20
|
+
retryJitter: 0.2,
|
|
21
|
+
resyncMs: 6 * 60 * 60_000,
|
|
22
|
+
});
|
|
23
|
+
/** The delay before retry `attemptArg` (1 for the first) after a transient failure. */
|
|
24
|
+
export const gatewayRetryDelayMs = (attemptArg, randomArg) => {
|
|
25
|
+
const { retryInitialMs, retryMaximumMs, retryJitter } = gatewaySyncTimings;
|
|
26
|
+
const nominal = Math.min(retryInitialMs * 2 ** Math.min(Math.max(attemptArg, 1) - 1, 30), retryMaximumMs);
|
|
27
|
+
const factor = 1 - retryJitter + 2 * retryJitter * Math.min(Math.max(randomArg(), 0), 1);
|
|
28
|
+
return Math.min(Math.round(nominal * factor), retryMaximumMs);
|
|
29
|
+
};
|
|
30
|
+
/** The waits of a backoff from 30 s until one reaches 15 min: after them, a waiting state is asked every six hours. */
|
|
31
|
+
export const gatewayWaitingRetries = Math.ceil(Math.log2(gatewaySyncTimings.retryMaximumMs / gatewaySyncTimings.retryInitialMs)) + 1;
|
|
32
|
+
/**
|
|
33
|
+
* Runs one sync at a time: first at `start`, then as the last one's result decides (`gatewaySyncTimings`), and on
|
|
34
|
+
* demand (`syncNow`), which replaces the sync that was scheduled. `close` clears the timer and waits for a running
|
|
35
|
+
* sync; nothing runs after it.
|
|
36
|
+
*/
|
|
37
|
+
export class GatewaySyncScheduler {
|
|
38
|
+
options;
|
|
39
|
+
clock;
|
|
40
|
+
random;
|
|
41
|
+
chain = Promise.resolve();
|
|
42
|
+
timer;
|
|
43
|
+
timerDueAt;
|
|
44
|
+
attempts = 0;
|
|
45
|
+
waitingAttempts = 0;
|
|
46
|
+
closed = false;
|
|
47
|
+
constructor(options) {
|
|
48
|
+
this.options = options;
|
|
49
|
+
this.clock = options.clock ?? nodeClock;
|
|
50
|
+
this.random = options.random ?? Math.random;
|
|
51
|
+
}
|
|
52
|
+
/** Schedules the first sync at once; it runs after the caller's turn, never inside it. */
|
|
53
|
+
start() {
|
|
54
|
+
this.schedule(0);
|
|
55
|
+
}
|
|
56
|
+
/** Runs a sync now, after one that is running, and resolves once it ended. */
|
|
57
|
+
syncNow() {
|
|
58
|
+
if (this.closed)
|
|
59
|
+
return Promise.reject(new Error('The gateway client is stopped.'));
|
|
60
|
+
this.cancelTimer();
|
|
61
|
+
return this.enqueue();
|
|
62
|
+
}
|
|
63
|
+
/** When the next sync runs on its own; `undefined` while none is scheduled. */
|
|
64
|
+
nextSyncAt() {
|
|
65
|
+
return this.timerDueAt;
|
|
66
|
+
}
|
|
67
|
+
/** Whether a timer is armed; false after `close`. */
|
|
68
|
+
hasTimer() {
|
|
69
|
+
return this.timer !== undefined;
|
|
70
|
+
}
|
|
71
|
+
async close() {
|
|
72
|
+
this.closed = true;
|
|
73
|
+
this.cancelTimer();
|
|
74
|
+
await this.chain;
|
|
75
|
+
}
|
|
76
|
+
schedule(delayMsArg) {
|
|
77
|
+
this.cancelTimer();
|
|
78
|
+
if (this.closed)
|
|
79
|
+
return;
|
|
80
|
+
this.timerDueAt = this.clock.now() + delayMsArg;
|
|
81
|
+
this.timer = this.clock.setTimeout(() => {
|
|
82
|
+
this.timer = undefined;
|
|
83
|
+
this.timerDueAt = undefined;
|
|
84
|
+
void this.enqueue();
|
|
85
|
+
}, delayMsArg);
|
|
86
|
+
}
|
|
87
|
+
cancelTimer() {
|
|
88
|
+
if (this.timer !== undefined)
|
|
89
|
+
this.clock.clearTimeout(this.timer);
|
|
90
|
+
this.timer = undefined;
|
|
91
|
+
this.timerDueAt = undefined;
|
|
92
|
+
}
|
|
93
|
+
enqueue() {
|
|
94
|
+
const run = this.chain.then(() => this.runOnce());
|
|
95
|
+
this.chain = run.catch(() => undefined);
|
|
96
|
+
return run;
|
|
97
|
+
}
|
|
98
|
+
async runOnce() {
|
|
99
|
+
if (this.closed)
|
|
100
|
+
return;
|
|
101
|
+
// A sync now replaces the one that was scheduled.
|
|
102
|
+
this.cancelTimer();
|
|
103
|
+
let result;
|
|
104
|
+
try {
|
|
105
|
+
result = await this.options.pass();
|
|
106
|
+
}
|
|
107
|
+
catch {
|
|
108
|
+
result = 'transient';
|
|
109
|
+
}
|
|
110
|
+
if (this.closed)
|
|
111
|
+
return;
|
|
112
|
+
if (result !== 'transient')
|
|
113
|
+
this.attempts = 0;
|
|
114
|
+
if (result !== 'waiting')
|
|
115
|
+
this.waitingAttempts = 0;
|
|
116
|
+
if (result === 'synced') {
|
|
117
|
+
this.schedule(gatewaySyncTimings.resyncMs);
|
|
118
|
+
}
|
|
119
|
+
else if (result === 'transient') {
|
|
120
|
+
this.attempts += 1;
|
|
121
|
+
this.schedule(gatewayRetryDelayMs(this.attempts, this.random));
|
|
122
|
+
}
|
|
123
|
+
else if (result === 'waiting') {
|
|
124
|
+
this.waitingAttempts += 1;
|
|
125
|
+
this.schedule(this.waitingAttempts <= gatewayWaitingRetries
|
|
126
|
+
? gatewayRetryDelayMs(this.waitingAttempts, this.random) : gatewaySyncTimings.resyncMs);
|
|
127
|
+
}
|
|
128
|
+
}
|
|
129
|
+
}
|
|
130
|
+
/**
|
|
131
|
+
* The controller's gateway client (AGL-828): with the credential `agl remote gateway enrol` stored, it keeps the
|
|
132
|
+
* controller's route on its gateway, in the background, after the listener is up; the controller's start never waits
|
|
133
|
+
* for the gateway. A sync checks the credential, deletes the client's routes the controller no longer serves (an
|
|
134
|
+
* earlier hostname), and writes the route with the trusted-proxy secret, then confirms a rotation the route carries.
|
|
135
|
+
*/
|
|
136
|
+
export class ControllerGatewayClient {
|
|
137
|
+
options;
|
|
138
|
+
scheduler;
|
|
139
|
+
abortController = new AbortController();
|
|
140
|
+
log;
|
|
141
|
+
state = 'not_enrolled';
|
|
142
|
+
record;
|
|
143
|
+
lastSync = {};
|
|
144
|
+
loggedProblem;
|
|
145
|
+
constructor(options) {
|
|
146
|
+
this.options = options;
|
|
147
|
+
this.log = options.log ?? ((textArg) => { console.log(textArg); });
|
|
148
|
+
this.scheduler = new GatewaySyncScheduler({
|
|
149
|
+
pass: () => this.pass(),
|
|
150
|
+
...(options.clock ? { clock: options.clock } : {}),
|
|
151
|
+
...(options.random ? { random: options.random } : {}),
|
|
152
|
+
});
|
|
153
|
+
}
|
|
154
|
+
/** Reads the enrolment, for the status to report before the first sync. */
|
|
155
|
+
async load() {
|
|
156
|
+
this.adopt(await this.options.store.read());
|
|
157
|
+
}
|
|
158
|
+
/** Schedules the first sync; it runs in the background. */
|
|
159
|
+
start() {
|
|
160
|
+
if (this.record?.active && !this.record.candidate)
|
|
161
|
+
this.state = 'syncing';
|
|
162
|
+
this.scheduler.start();
|
|
163
|
+
}
|
|
164
|
+
status() {
|
|
165
|
+
const record = this.record;
|
|
166
|
+
const credential = record?.active ?? record?.candidate;
|
|
167
|
+
const nextSyncAt = this.scheduler.nextSyncAt();
|
|
168
|
+
const secrets = this.options.secrets();
|
|
169
|
+
return {
|
|
170
|
+
state: this.state,
|
|
171
|
+
...(credential ? { enrolment: controllerGatewayEnrolment(credential, this.options.runtimeConfig().controllerPort) } : {}),
|
|
172
|
+
...(this.lastSync.syncedAt === undefined ? {} : { lastSyncedAt: this.lastSync.syncedAt }),
|
|
173
|
+
...(this.lastSync.dns ? { dns: { ...this.lastSync.dns } } : {}),
|
|
174
|
+
...(this.lastSync.sourceProfileVerified === undefined ? {} : { sourceProfileVerified: this.lastSync.sourceProfileVerified }),
|
|
175
|
+
...(this.lastSync.problem ? { problem: { ...this.lastSync.problem } } : {}),
|
|
176
|
+
...(nextSyncAt === undefined ? {} : { nextSyncAt }),
|
|
177
|
+
...(secrets?.rotating() ? { rotationPending: true } : {}),
|
|
178
|
+
};
|
|
179
|
+
}
|
|
180
|
+
/**
|
|
181
|
+
* Syncs now (`agl remote gateway sync`), after rotating the trusted-proxy secret when `rotate` is set: the route
|
|
182
|
+
* then carries the new secret, and the previous one is refused once a sync wrote it. Resolves with the status after
|
|
183
|
+
* that sync.
|
|
184
|
+
*/
|
|
185
|
+
async sync(optionsArg) {
|
|
186
|
+
if (optionsArg.rotate) {
|
|
187
|
+
const record = await this.options.store.read();
|
|
188
|
+
if (!record?.active)
|
|
189
|
+
throw new Error('This controller is not enrolled with a gateway, so no route carries a rotated secret.');
|
|
190
|
+
const secrets = this.options.secrets();
|
|
191
|
+
if (!secrets)
|
|
192
|
+
throw new Error('This controller runs no trusted reverse proxy, so it has no secret to rotate.');
|
|
193
|
+
await secrets.rotate();
|
|
194
|
+
}
|
|
195
|
+
await this.scheduler.syncNow();
|
|
196
|
+
return this.status();
|
|
197
|
+
}
|
|
198
|
+
/** Whether any timer is armed; false once closed. */
|
|
199
|
+
hasTimer() {
|
|
200
|
+
return this.scheduler.hasTimer();
|
|
201
|
+
}
|
|
202
|
+
/** Stops every timer, aborts a running sync's requests and waits for it. */
|
|
203
|
+
async close() {
|
|
204
|
+
this.abortController.abort(new Error('The controller is stopping.'));
|
|
205
|
+
await this.scheduler.close();
|
|
206
|
+
}
|
|
207
|
+
adopt(recordArg) {
|
|
208
|
+
this.record = recordArg;
|
|
209
|
+
this.lastSync = structuredClone(recordArg?.lastSync ?? {});
|
|
210
|
+
if (!recordArg)
|
|
211
|
+
this.state = 'not_enrolled';
|
|
212
|
+
else if (recordArg.candidate)
|
|
213
|
+
this.state = 'finalize_pending';
|
|
214
|
+
}
|
|
215
|
+
async pass() {
|
|
216
|
+
let record;
|
|
217
|
+
try {
|
|
218
|
+
record = await this.options.store.read();
|
|
219
|
+
}
|
|
220
|
+
catch (errorArg) {
|
|
221
|
+
this.log(`The gateway client could not read its enrolment: ${errorArg instanceof Error ? errorArg.message : String(errorArg)}`);
|
|
222
|
+
return 'transient';
|
|
223
|
+
}
|
|
224
|
+
this.adopt(record);
|
|
225
|
+
const active = record?.active;
|
|
226
|
+
if (!record || !active) {
|
|
227
|
+
if (record?.candidate) {
|
|
228
|
+
return this.finish(undefined, { code: 'finalize_pending', message: 'The gateway has not confirmed the enrolment\'s '
|
|
229
|
+
+ 'credential. Stop the controller and run `agl remote gateway enrol` again to finish it.' });
|
|
230
|
+
}
|
|
231
|
+
return 'idle';
|
|
232
|
+
}
|
|
233
|
+
if (record.candidate) {
|
|
234
|
+
return this.finish(active.tokenId, { code: 'finalize_pending', message: 'A new enrolment is not finished. Stop the '
|
|
235
|
+
+ 'controller and run `agl remote gateway enrol` again to finish it.' });
|
|
236
|
+
}
|
|
237
|
+
const config = this.options.runtimeConfig();
|
|
238
|
+
if (config.tlsMode !== 'proxy') {
|
|
239
|
+
return this.finish(active.tokenId, { code: 'not_proxied', message: 'The controller is not behind a TLS reverse '
|
|
240
|
+
+ 'proxy (`agl remote set`), so it has no route.' });
|
|
241
|
+
}
|
|
242
|
+
this.state = 'syncing';
|
|
243
|
+
try {
|
|
244
|
+
// Refuses a stored URL that is plain http off loopback (`gateway_url_insecure`) before the token is unsealed.
|
|
245
|
+
const transport = new GatewayClientTransport(active.gatewayUrl, {
|
|
246
|
+
...(this.options.requestTimeoutMs === undefined ? {} : { timeoutMs: this.options.requestTimeoutMs }),
|
|
247
|
+
signal: this.abortController.signal,
|
|
248
|
+
});
|
|
249
|
+
const token = await this.options.store.unseal(active);
|
|
250
|
+
const context = await transport.fire('getGatewayClientContext', { apiToken: token });
|
|
251
|
+
const contextProblem = gatewayContextProblem(context, active.gatewayClientId);
|
|
252
|
+
if (contextProblem)
|
|
253
|
+
throw new GatewaySyncProblemError(contextProblem);
|
|
254
|
+
// The client's routes for anything the controller no longer serves go first: an earlier hostname's. `agl remote
|
|
255
|
+
// set` refuses another hostname while enrolled, so this and `origin_changed` are the safety net for a leftover
|
|
256
|
+
// (an interrupted change, or a move an earlier release made after a rollback).
|
|
257
|
+
const hostname = new URL(config.publicOrigin).hostname;
|
|
258
|
+
const removed = await deleteGatewayRoutes(transport, token, (routeArg) => routeArg.ownership.appId === active.appId
|
|
259
|
+
&& routeArg.ownership.hostname === hostname && routeArg.ownership.routeRef === undefined);
|
|
260
|
+
if (removed.length > 0)
|
|
261
|
+
this.log(`The gateway client deleted routes the controller no longer serves: ${removed.join(', ')}.`);
|
|
262
|
+
if (hostname !== active.hostname) {
|
|
263
|
+
throw new GatewaySyncProblemError({ code: 'origin_changed', message: `The controller's public origin is `
|
|
264
|
+
+ `${config.publicOrigin}, but it was enrolled for ${active.hostname}. Run \`agl remote gateway enrol\` again `
|
|
265
|
+
+ `for ${hostname}.` });
|
|
266
|
+
}
|
|
267
|
+
// No route is written without the trusted-proxy secret, which only a gateway that takes request headers sets.
|
|
268
|
+
const headerRefusal = gatewayRouteHeaderRefusal(context.capabilities);
|
|
269
|
+
if (headerRefusal)
|
|
270
|
+
throw new GatewaySyncProblemError(headerRefusal);
|
|
271
|
+
const secrets = this.options.secrets();
|
|
272
|
+
if (!secrets) {
|
|
273
|
+
throw new GatewaySyncProblemError({ code: 'not_proxied', message: 'The controller has no trusted-proxy secret for its route.' });
|
|
274
|
+
}
|
|
275
|
+
const spec = {
|
|
276
|
+
gatewayClientId: active.gatewayClientId,
|
|
277
|
+
appId: active.appId,
|
|
278
|
+
hostname,
|
|
279
|
+
targetHost: active.targetHost,
|
|
280
|
+
targetPort: config.controllerPort,
|
|
281
|
+
};
|
|
282
|
+
// The secret the route carries: a rotation's while one is in progress, so the sync that writes it confirms it.
|
|
283
|
+
const carried = secrets.routeSecret();
|
|
284
|
+
const outcome = gatewayRouteSyncOutcome(await transport.fire('syncGatewayClientRoute', gatewayRouteSyncRequest(token, spec, carried.secret)));
|
|
285
|
+
if (!outcome.synced)
|
|
286
|
+
throw new GatewaySyncProblemError(outcome.problem);
|
|
287
|
+
const readBack = gatewayRouteReadBack((await transport.fire('getGatewayClientRoutes', { apiToken: token })).routes, spec);
|
|
288
|
+
if (readBack.problem)
|
|
289
|
+
throw new GatewaySyncProblemError(readBack.problem);
|
|
290
|
+
// The route carries the secret: a rotation it carries ends, and the previous secret is refused from now on. One
|
|
291
|
+
// that began while this sync ran is carried by the next sync, which runs right after it.
|
|
292
|
+
if (secrets.routeSecret().generation === carried.generation)
|
|
293
|
+
await secrets.confirm(carried.generation);
|
|
294
|
+
return await this.finish(active.tokenId, undefined, outcome.dns, readBack.sourceProfileVerified);
|
|
295
|
+
}
|
|
296
|
+
catch (errorArg) {
|
|
297
|
+
if (this.abortController.signal.aborted)
|
|
298
|
+
return 'idle';
|
|
299
|
+
return this.finish(active.tokenId, gatewayProblemOf(errorArg));
|
|
300
|
+
}
|
|
301
|
+
}
|
|
302
|
+
/** Records a sync's end, in memory and in the database, and tells the scheduler what follows. */
|
|
303
|
+
async finish(tokenIdArg, problemArg, dnsArg, sourceProfileVerifiedArg) {
|
|
304
|
+
const kind = problemArg === undefined ? undefined : controllerGatewayProblemKind[problemArg.code];
|
|
305
|
+
const transient = kind === 'transient';
|
|
306
|
+
const previous = this.lastSync;
|
|
307
|
+
const lastSync = problemArg
|
|
308
|
+
? { ...(previous.syncedAt === undefined ? {} : { syncedAt: previous.syncedAt }),
|
|
309
|
+
...(previous.dns ? { dns: previous.dns } : {}),
|
|
310
|
+
...(previous.sourceProfileVerified === undefined ? {} : { sourceProfileVerified: previous.sourceProfileVerified }),
|
|
311
|
+
problem: problemArg }
|
|
312
|
+
: { syncedAt: this.options.clock?.now() ?? Date.now(), ...(dnsArg ? { dns: dnsArg } : {}),
|
|
313
|
+
...(sourceProfileVerifiedArg === undefined ? {} : { sourceProfileVerified: sourceProfileVerifiedArg }) };
|
|
314
|
+
const logged = problemArg ? `${problemArg.code}: ${problemArg.message}` : undefined;
|
|
315
|
+
if (logged !== this.loggedProblem) {
|
|
316
|
+
this.log(problemArg ? `The gateway route was not synced (${problemArg.code}${kind === 'terminal' ? '' : ', asked again'}): `
|
|
317
|
+
+ `${problemArg.message}` : 'The gateway route is synced.');
|
|
318
|
+
this.loggedProblem = logged;
|
|
319
|
+
}
|
|
320
|
+
if (tokenIdArg !== undefined) {
|
|
321
|
+
try {
|
|
322
|
+
await this.options.store.recordSync(tokenIdArg, lastSync);
|
|
323
|
+
}
|
|
324
|
+
catch (errorArg) {
|
|
325
|
+
this.log(`The gateway client could not record its sync: ${errorArg instanceof Error ? errorArg.message : String(errorArg)}`);
|
|
326
|
+
}
|
|
327
|
+
}
|
|
328
|
+
// The status shows the sync's end once it is recorded; the scheduler arms the next one right after.
|
|
329
|
+
this.lastSync = lastSync;
|
|
330
|
+
this.state = !problemArg ? 'synced'
|
|
331
|
+
: problemArg.code === 'finalize_pending' ? 'finalize_pending'
|
|
332
|
+
: transient ? 'retrying' : kind === 'waiting' ? 'waiting' : 'failed';
|
|
333
|
+
return !problemArg ? 'synced' : kind === 'terminal' ? 'terminal' : kind === 'waiting' ? 'waiting' : 'transient';
|
|
334
|
+
}
|
|
335
|
+
}
|
|
336
|
+
//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiY2xhc3Nlcy5nYXRld2F5Y2xpZW50LmpzIiwic291cmNlUm9vdCI6IiIsInNvdXJjZXMiOlsiLi4vLi4vdHMvY2xhc3Nlcy5nYXRld2F5Y2xpZW50LnRzIl0sIm5hbWVzIjpbXSwibWFwcGluZ3MiOiJBQUFBLE9BQU8sS0FBSyxPQUFPLE1BQU0sY0FBYyxDQUFDO0FBQ3hDLE9BQU8sRUFDTCw0QkFBNEIsRUFDNUIsMEJBQTBCLEdBRzNCLE1BQU0saUNBQWlDLENBQUM7QUFFekMsT0FBTyxFQUNMLG1CQUFtQixFQUNuQixxQkFBcUIsRUFDckIsZ0JBQWdCLEVBQ2hCLHlCQUF5QixFQUN6QixvQkFBb0IsRUFDcEIsdUJBQXVCLEVBQ3ZCLHVCQUF1QixFQUN2QixzQkFBc0IsRUFDdEIsdUJBQXVCLEdBRXhCLE1BQU0sNkJBQTZCLENBQUM7QUFFckMsT0FBTyxFQUNMLDRCQUE0QixHQUs3QixNQUFNLDJCQUEyQixDQUFDO0FBYW5DLE1BQU0sU0FBUyxHQUFzQjtJQUNuQyxHQUFHLEVBQUUsR0FBRyxFQUFFLENBQUMsSUFBSSxDQUFDLEdBQUcsRUFBRTtJQUNyQixVQUFVLEVBQUUsQ0FBQyxXQUFXLEVBQUUsVUFBVSxFQUFFLEVBQUUsQ0FBQyxVQUFVLENBQUMsV0FBVyxFQUFFLFVBQVUsQ0FBQztJQUM1RSxZQUFZLEVBQUUsQ0FBQyxTQUFTLEVBQUUsRUFBRSxDQUFDLFlBQVksQ0FBQyxTQUEyQixDQUFDO0NBQ3ZFLENBQUM7QUFFRjs7Ozs7R0FLRztBQUNILE1BQU0sQ0FBQyxNQUFNLGtCQUFrQixHQUFHLE1BQU0sQ0FBQyxNQUFNLENBQUM7SUFDOUMsY0FBYyxFQUFFLE1BQU07SUFDdEIsY0FBYyxFQUFFLEVBQUUsR0FBRyxNQUFNO0lBQzNCLDBEQUEwRDtJQUMxRCxXQUFXLEVBQUUsR0FBRztJQUNoQixRQUFRLEVBQUUsQ0FBQyxHQUFHLEVBQUUsR0FBRyxNQUFNO0NBQzFCLENBQUMsQ0FBQztBQUVILHVGQUF1RjtBQUN2RixNQUFNLENBQUMsTUFBTSxtQkFBbUIs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
|
|
@@ -0,0 +1,97 @@
|
|
|
1
|
+
import * as plugins from './plugins.js';
|
|
2
|
+
import type { ITpmSecretCodec } from './classes.tpmsecretcodec.js';
|
|
3
|
+
import { type IControllerGatewayDns, type IControllerGatewayEnrolment, type IControllerGatewayProblem } from '../dist_ts_interfaces/index.js';
|
|
4
|
+
/**
|
|
5
|
+
* One gateway-client credential of a controller with everything it was issued for: the gateway, the client, the
|
|
6
|
+
* route it may write and the token, TPM2-sealed (`TpmSecretCodec`) under a name bound to the controller and the
|
|
7
|
+
* token id. The token's plaintext exists only in the process that uses it, never in a log, a file or the output.
|
|
8
|
+
*/
|
|
9
|
+
export interface IControllerGatewayCredential {
|
|
10
|
+
/** The gateway's API base URL; requests go to `<gatewayUrl>/typedrequest`. */
|
|
11
|
+
gatewayUrl: string;
|
|
12
|
+
/** `agl-<installation>-<port>`, type `custom`. */
|
|
13
|
+
gatewayClientId: string;
|
|
14
|
+
/** `controller-<port>`. */
|
|
15
|
+
appId: string;
|
|
16
|
+
hostname: string;
|
|
17
|
+
targetHost: string;
|
|
18
|
+
/** The gateway's id of the token; the seal name binds it. */
|
|
19
|
+
tokenId: string;
|
|
20
|
+
ciphertext: string;
|
|
21
|
+
/** Unix epoch milliseconds: when the gateway issued it (a candidate) or confirmed it (the active credential). */
|
|
22
|
+
at: number;
|
|
23
|
+
}
|
|
24
|
+
/** What the last sync of a running controller left for `agl remote gateway status` to show while it is stopped. */
|
|
25
|
+
export interface IControllerGatewaySyncRecord {
|
|
26
|
+
/** Unix epoch milliseconds of the last sync that wrote the route. */
|
|
27
|
+
syncedAt?: number;
|
|
28
|
+
dns?: IControllerGatewayDns;
|
|
29
|
+
/** Whether the gateway named the route's source profile as `LOCAL NETWORK` after that sync; false when it named none. */
|
|
30
|
+
sourceProfileVerified?: boolean;
|
|
31
|
+
/** Why the last sync failed; absent when it wrote the route. */
|
|
32
|
+
problem?: IControllerGatewayProblem;
|
|
33
|
+
}
|
|
34
|
+
export interface IControllerGatewayClientDocument {
|
|
35
|
+
/** `controller:<port>`. */
|
|
36
|
+
id: string;
|
|
37
|
+
/** The credential the controller syncs with, once the gateway confirmed it (`finalizeGatewayClientCredential`). */
|
|
38
|
+
active?: IControllerGatewayCredential;
|
|
39
|
+
/**
|
|
40
|
+
* A credential the gateway issued that is not confirmed yet: sealed and stored before the confirmation is asked for,
|
|
41
|
+
* so a confirmation whose answer is lost is asked for again with the same credential.
|
|
42
|
+
*/
|
|
43
|
+
candidate?: IControllerGatewayCredential;
|
|
44
|
+
lastSync?: IControllerGatewaySyncRecord;
|
|
45
|
+
}
|
|
46
|
+
export declare class ControllerGatewayClientModel extends plugins.nosqldb.SmartDataDbDoc<ControllerGatewayClientModel, IControllerGatewayClientDocument> {
|
|
47
|
+
static exact: plugins.nosqldb.TExact<ControllerGatewayClientModel>;
|
|
48
|
+
id: string;
|
|
49
|
+
active?: IControllerGatewayCredential;
|
|
50
|
+
candidate?: IControllerGatewayCredential;
|
|
51
|
+
lastSync?: IControllerGatewaySyncRecord;
|
|
52
|
+
}
|
|
53
|
+
export interface IControllerGatewayClientStoreOptions {
|
|
54
|
+
/** `controller:<port>`. */
|
|
55
|
+
controllerId: string;
|
|
56
|
+
/** The controller database's issuer id: a credential is sealed under a name bound to it. */
|
|
57
|
+
issuerId: string;
|
|
58
|
+
codec: ITpmSecretCodec;
|
|
59
|
+
}
|
|
60
|
+
/** The fields of a credential that say what it was issued for, without the token. */
|
|
61
|
+
export type TControllerGatewayCredentialSpec = Pick<IControllerGatewayCredential, 'gatewayUrl' | 'gatewayClientId' | 'appId' | 'hostname' | 'targetHost'>;
|
|
62
|
+
/** What `agl remote gateway status` and the management status report of an enrolment, without its token. */
|
|
63
|
+
export declare const controllerGatewayEnrolment: (credentialArg: IControllerGatewayCredential, portArg: number) => IControllerGatewayEnrolment;
|
|
64
|
+
/**
|
|
65
|
+
* A controller's gateway-client record in its database (`agl_controller_gateway_clients`): the active credential, a
|
|
66
|
+
* candidate awaiting the gateway's confirmation, and what the last sync left. Only `agl remote gateway` writes the
|
|
67
|
+
* credentials, against a stopped controller; the running controller writes only `lastSync`.
|
|
68
|
+
*/
|
|
69
|
+
export declare class ControllerGatewayClientStore {
|
|
70
|
+
private readonly options;
|
|
71
|
+
constructor(options: IControllerGatewayClientStoreOptions);
|
|
72
|
+
get controllerId(): string;
|
|
73
|
+
read(): Promise<IControllerGatewayClientDocument | undefined>;
|
|
74
|
+
/** The token of `credentialArg`, unsealed; the caller wipes nothing, the string is the gateway's own text. */
|
|
75
|
+
unseal(credentialArg: IControllerGatewayCredential): Promise<string>;
|
|
76
|
+
/**
|
|
77
|
+
* Seals a credential the gateway just issued and stores it as the candidate, before its confirmation is asked
|
|
78
|
+
* for. A candidate stored before is replaced: the gateway superseded it by issuing this one.
|
|
79
|
+
*/
|
|
80
|
+
storeCandidate(specArg: TControllerGatewayCredentialSpec, tokenIdArg: string, tokenArg: string): Promise<IControllerGatewayCredential>;
|
|
81
|
+
/** Makes the confirmed candidate `tokenIdArg` the active credential; the previous one is gone from the gateway. */
|
|
82
|
+
promoteCandidate(tokenIdArg: string): Promise<IControllerGatewayCredential>;
|
|
83
|
+
/** Drops a candidate the gateway refuses to confirm; the record goes when it holds nothing else. */
|
|
84
|
+
dropCandidate(tokenIdArg: string): Promise<void>;
|
|
85
|
+
/** Records what a sync of the running controller found; the record must still hold `tokenIdArg` as active. */
|
|
86
|
+
recordSync(tokenIdArg: string, syncArg: IControllerGatewaySyncRecord): Promise<void>;
|
|
87
|
+
/** Removes the record; whether there was one. */
|
|
88
|
+
forget(): Promise<boolean>;
|
|
89
|
+
private sealName;
|
|
90
|
+
private requireStored;
|
|
91
|
+
private transition;
|
|
92
|
+
}
|
|
93
|
+
/**
|
|
94
|
+
* The hostnames the gateway enrolment of `controllerIdArg` holds a route for, finished or not (its active and its
|
|
95
|
+
* candidate credential's); empty when it has none.
|
|
96
|
+
*/
|
|
97
|
+
export declare const controllerGatewayEnrolledHostnames: (controllerIdArg: string) => Promise<string[]>;
|