agl 41.2.0 → 42.1.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 +41 -0
- package/dist_serve/bundle.js +2625 -2278
- package/dist_serve/bundle.js.map +2 -2
- package/dist_serve/bundle.js.third-party-notices.json +3 -68
- package/dist_serve/bundle.js.third-party-notices.txt +4 -137
- package/dist_ts/00_commitinfo_data.js +1 -1
- package/dist_ts/aglapi/aglapisurface.document.js +4 -4
- package/dist_ts/classes.authmodels.d.ts +2 -8
- package/dist_ts/classes.authmodels.js +60 -23
- package/dist_ts/classes.authstore.d.ts +24 -0
- package/dist_ts/classes.authstore.js +185 -23
- package/dist_ts/classes.cli.d.ts +3 -6
- package/dist_ts/classes.cli.js +38 -51
- package/dist_ts/classes.config.d.ts +17 -3
- package/dist_ts/classes.config.js +55 -18
- package/dist_ts/classes.controller.d.ts +83 -14
- package/dist_ts/classes.controller.js +545 -229
- package/dist_ts/classes.controllerdevices.d.ts +128 -0
- package/dist_ts/classes.controllerdevices.js +472 -0
- package/dist_ts/classes.controllermanagement.d.ts +42 -9
- package/dist_ts/classes.controllermanagement.js +72 -23
- package/dist_ts/classes.controllerservice.d.ts +3 -31
- package/dist_ts/classes.controllerservice.js +3 -47
- package/dist_ts/classes.mcpcontrollerhost.js +9 -3
- package/dist_ts/classes.processinspection.d.ts +8 -1
- package/dist_ts/classes.processinspection.js +92 -2
- package/dist_ts/classes.proxycontrol.js +6 -1
- package/dist_ts/classes.proxydaemon.d.ts +2 -2
- package/dist_ts/classes.proxydaemon.js +1 -1
- package/dist_ts/classes.proxystore.d.ts +2 -11
- package/dist_ts/classes.proxystore.js +3 -25
- package/dist_ts/classes.sessionfeed.d.ts +10 -1
- package/dist_ts/classes.sessionfeed.js +12 -2
- package/dist_ts/classes.tpmsecretcodec.d.ts +13 -0
- package/dist_ts/classes.tpmsecretcodec.js +28 -0
- package/dist_ts/classes.trustedproxysecrets.d.ts +91 -0
- package/dist_ts/classes.trustedproxysecrets.js +338 -0
- package/dist_ts/classes.upgradecoordinator.d.ts +14 -1
- package/dist_ts/classes.upgradecoordinator.js +21 -3
- package/dist_ts/classes.upgradetransaction.d.ts +32 -0
- package/dist_ts/classes.upgradetransaction.js +101 -4
- package/dist_ts/classes.validation.d.ts +2 -0
- package/dist_ts/classes.validation.js +2 -2
- package/dist_ts/functions.controlleradmission.d.ts +67 -0
- package/dist_ts/functions.controlleradmission.js +127 -0
- package/dist_ts/functions.deviceapi.d.ts +28 -0
- package/dist_ts/functions.deviceapi.js +246 -0
- package/dist_ts/functions.deviceproof.d.ts +33 -0
- package/dist_ts/functions.deviceproof.js +93 -0
- package/dist_ts/functions.remotecli.d.ts +27 -0
- package/dist_ts/functions.remotecli.js +241 -0
- package/dist_ts/functions.retiredenvironment.d.ts +11 -2
- package/dist_ts/functions.retiredenvironment.js +22 -5
- package/dist_ts/index.d.ts +1 -0
- package/dist_ts/index.js +2 -1
- package/dist_ts/interfaces.auth.d.ts +29 -4
- package/dist_ts/interfaces.auth.js +10 -1
- package/dist_ts/interfaces.config.d.ts +14 -0
- package/dist_ts/interfaces.config.js +9 -2
- package/dist_ts/interfaces.lifecycle.d.ts +3 -0
- package/dist_ts_authswitch/classes.authoritydaemon.js +6 -1
- package/dist_ts_interfaces/devices.d.ts +331 -0
- package/dist_ts_interfaces/devices.js +34 -0
- package/dist_ts_interfaces/index.d.ts +2 -0
- package/dist_ts_interfaces/index.js +3 -1
- package/dist_ts_interfaces/interfaces.d.ts +5 -3
- package/dist_ts_interfaces/interfaces.js +3 -2
- package/dist_ts_interfaces/management.d.ts +2 -2
- package/dist_ts_interfaces/management.js +2 -2
- package/dist_ts_interfaces/mcprequests.d.ts +1 -1
- package/dist_ts_interfaces/requests.d.ts +2 -2
- package/dist_ts_interfaces/requests.devices.d.ts +89 -0
- package/dist_ts_interfaces/requests.devices.js +2 -0
- package/dist_ts_interfaces/requests.upgrade.d.ts +0 -12
- package/package.json +12 -11
- package/readme.md +116 -24
- package/ts/00_commitinfo_data.ts +1 -1
- package/ts/aglapi/aglapisurface.document.ts +3 -3
- package/ts/classes.authmodels.ts +68 -25
- package/ts/classes.authstore.ts +183 -24
- package/ts/classes.cli.ts +38 -61
- package/ts/classes.config.ts +70 -21
- package/ts/classes.controller.ts +746 -329
- package/ts/classes.controllerdevices.ts +469 -0
- package/ts/classes.controllermanagement.ts +123 -49
- package/ts/classes.controllerservice.ts +3 -56
- package/ts/classes.mcpcontrollerhost.ts +10 -5
- package/ts/classes.processinspection.ts +84 -3
- package/ts/classes.proxycontrol.ts +2 -0
- package/ts/classes.proxydaemon.ts +3 -2
- package/ts/classes.proxystore.ts +4 -25
- package/ts/classes.sessionfeed.ts +13 -1
- package/ts/classes.tpmsecretcodec.ts +26 -0
- package/ts/classes.trustedproxysecrets.ts +317 -0
- package/ts/classes.upgradecoordinator.ts +33 -3
- package/ts/classes.upgradetransaction.ts +130 -1
- package/ts/classes.validation.ts +1 -1
- package/ts/functions.controlleradmission.ts +168 -0
- package/ts/functions.deviceapi.ts +295 -0
- package/ts/functions.deviceproof.ts +118 -0
- package/ts/functions.remotecli.ts +270 -0
- package/ts/functions.retiredenvironment.ts +25 -3
- package/ts/index.ts +1 -0
- package/ts/interfaces.auth.ts +41 -3
- package/ts/interfaces.config.ts +15 -0
- package/ts/interfaces.lifecycle.ts +3 -0
- package/ts_authswitch/classes.authoritydaemon.ts +2 -0
- package/ts_interfaces/devices.schema.json +890 -0
- package/ts_interfaces/devices.ts +392 -0
- package/ts_interfaces/index.ts +2 -0
- package/ts_interfaces/interfaces.ts +5 -2
- package/ts_interfaces/management.ts +2 -2
- package/ts_interfaces/mcprequests.ts +1 -1
- package/ts_interfaces/requests.devices.ts +95 -0
- package/ts_interfaces/requests.ts +10 -10
- package/ts_interfaces/requests.upgrade.ts +0 -16
- package/ts_web/00_commitinfo_data.ts +1 -1
- package/ts_web/classes.controllersocketclient.ts +27 -0
- package/ts_web/elements.devices.ts +752 -0
- package/ts_web/elements.harnesscontrollerapp.ts +18 -1
|
@@ -10,13 +10,26 @@ export const retiredControllerEnvironmentNames: Readonly<Record<string, string>>
|
|
|
10
10
|
HARNESS_CONTROLLER_MONGO_DB: 'AGL_MONGO_DB',
|
|
11
11
|
HARNESS_CONTROLLER_DB_DIR: 'AGL_DB_DIR',
|
|
12
12
|
HARNESS_CONTROLLER_FORWARD_ENV: 'AGL_FORWARD_ENV',
|
|
13
|
-
HARNESS_CONTROLLER_TRUSTED_PROXY_SECRET: 'AGL_TRUSTED_PROXY_SECRET',
|
|
14
13
|
HARNESS_CONTROLLER_CLAUDE_EXECUTABLE: 'AGL_CLAUDE_EXECUTABLE',
|
|
15
14
|
HARNESS_CONTROLLER_CODEX_EXECUTABLE: 'AGL_CODEX_EXECUTABLE',
|
|
16
15
|
HARNESS_CONTROLLER_CODEX_SERVER_URL: 'AGL_CODEX_SERVER_URL',
|
|
17
16
|
HARNESS_CONTROLLER_CODEX_SERVER_TOKEN: 'AGL_CODEX_SERVER_TOKEN',
|
|
18
17
|
});
|
|
19
18
|
|
|
19
|
+
const trustedProxySecretRemedy = 'The trusted-proxy secret is generated and sealed in the controller\'s database '
|
|
20
|
+
+ 'now; for a reverse proxy other than AGL\'s own gateway, stop the controller, pipe your secret into '
|
|
21
|
+
+ '`agl remote secret import --port <port>` (for example `printf \'%s\' "$AGL_TRUSTED_PROXY_SECRET" | agl remote '
|
|
22
|
+
+ 'secret import --port 4097`), then unset the variable.';
|
|
23
|
+
|
|
24
|
+
/**
|
|
25
|
+
* Configuration names retired without a replacement variable, each with what to do instead. A process started with
|
|
26
|
+
* one would silently run without it, so starting is refused here too.
|
|
27
|
+
*/
|
|
28
|
+
export const retiredControllerEnvironmentRemedies: Readonly<Record<string, string>> = Object.freeze({
|
|
29
|
+
AGL_TRUSTED_PROXY_SECRET: trustedProxySecretRemedy,
|
|
30
|
+
HARNESS_CONTROLLER_TRUSTED_PROXY_SECRET: trustedProxySecretRemedy,
|
|
31
|
+
});
|
|
32
|
+
|
|
20
33
|
const retiredPrefix = 'HARNESS_CONTROLLER_';
|
|
21
34
|
|
|
22
35
|
export class RetiredControllerEnvironmentError extends Error {
|
|
@@ -24,6 +37,8 @@ export class RetiredControllerEnvironmentError extends Error {
|
|
|
24
37
|
super(
|
|
25
38
|
`AGL no longer reads ${names.join(', ')}. `
|
|
26
39
|
+ names.map((nameArg) => {
|
|
40
|
+
const remedy = retiredControllerEnvironmentRemedies[nameArg];
|
|
41
|
+
if (remedy) return `${nameArg}: ${remedy}`;
|
|
27
42
|
const replacement = retiredControllerEnvironmentNames[nameArg];
|
|
28
43
|
return replacement ? `Set ${replacement} instead of ${nameArg}.` : `Remove ${nameArg}.`;
|
|
29
44
|
}).join(' '),
|
|
@@ -33,16 +48,23 @@ export class RetiredControllerEnvironmentError extends Error {
|
|
|
33
48
|
}
|
|
34
49
|
|
|
35
50
|
/**
|
|
36
|
-
* Refuses an environment that still sets a retired `HARNESS_CONTROLLER_*` name
|
|
51
|
+
* Refuses an environment that still sets a retired `HARNESS_CONTROLLER_*` name or a name retired without a
|
|
52
|
+
* replacement (`retiredControllerEnvironmentRemedies`). The upgrade token a
|
|
37
53
|
* pre-33 upgrade worker hands its target is the one exception: it is a process wire, not configuration.
|
|
38
54
|
* Only names are reported, never values.
|
|
39
55
|
*/
|
|
40
56
|
export const assertNoRetiredControllerEnvironment = (
|
|
41
57
|
environmentArg: NodeJS.ProcessEnv = process.env,
|
|
58
|
+
optionsArg: {
|
|
59
|
+
/** `agl remote`, which migrates them: the names of `retiredControllerEnvironmentRemedies` are left alone. */
|
|
60
|
+
allowRemedied?: boolean;
|
|
61
|
+
} = {},
|
|
42
62
|
): void => {
|
|
43
63
|
const names = Object.keys(environmentArg)
|
|
44
64
|
.filter((nameArg) => environmentArg[nameArg] !== undefined)
|
|
45
|
-
.filter((nameArg) =>
|
|
65
|
+
.filter((nameArg) => !(optionsArg.allowRemedied && Object.hasOwn(retiredControllerEnvironmentRemedies, nameArg)))
|
|
66
|
+
.filter((nameArg) => nameArg.toUpperCase().startsWith(retiredPrefix)
|
|
67
|
+
|| Object.hasOwn(retiredControllerEnvironmentRemedies, nameArg))
|
|
46
68
|
.filter((nameArg) => nameArg !== preAglUpgradeTokenEnvironmentVariable)
|
|
47
69
|
.sort();
|
|
48
70
|
if (names.length > 0) throw new RetiredControllerEnvironmentError(names);
|
package/ts/index.ts
CHANGED
|
@@ -60,6 +60,7 @@ export type {
|
|
|
60
60
|
export { buildControllerFlexCleanupCohort } from './classes.sessionidentityservice.js';
|
|
61
61
|
export * from './classes.cli.js';
|
|
62
62
|
export * from './classes.config.js';
|
|
63
|
+
export * from './functions.controlleradmission.js';
|
|
63
64
|
export * from './classes.controller.js';
|
|
64
65
|
export * from './classes.resourcecoordinator.js';
|
|
65
66
|
export * from './classes.terminalresourcehost.js';
|
package/ts/interfaces.auth.ts
CHANGED
|
@@ -141,6 +141,15 @@ export const controllerAuditEventTypes = [
|
|
|
141
141
|
'resource.browser.view.close',
|
|
142
142
|
'resource.browser.view.operate',
|
|
143
143
|
'resource.browser.paint.rearm',
|
|
144
|
+
// The offline `agl remote` commands, run by the local OS user against a stopped controller.
|
|
145
|
+
'remote.set',
|
|
146
|
+
'remote.unset',
|
|
147
|
+
'remote.secret.import',
|
|
148
|
+
// Paired devices (AGL-824): the owner makes a pairing code and revokes a device; a device pairs and authenticates.
|
|
149
|
+
'device.pairing.begin',
|
|
150
|
+
'device.pair',
|
|
151
|
+
'device.auth',
|
|
152
|
+
'device.revoke',
|
|
144
153
|
] as const;
|
|
145
154
|
export type TControllerAuditEventType = (typeof controllerAuditEventTypes)[number];
|
|
146
155
|
export type TControllerAuditOutcome = 'attempted' | 'succeeded' | 'denied' | 'failed';
|
|
@@ -250,6 +259,34 @@ export type TControllerAuditSessionId =
|
|
|
250
259
|
| IControllerRuntimeId
|
|
251
260
|
| plugins.browserRuntime.IBrowserClaudeSessionId;
|
|
252
261
|
|
|
262
|
+
/** One end of an offline `agl remote set|unset` move, as its audit events record it; never a secret. */
|
|
263
|
+
export interface IControllerAuditRemoteEndpoint {
|
|
264
|
+
publicOrigin: string;
|
|
265
|
+
rpId: string;
|
|
266
|
+
}
|
|
267
|
+
|
|
268
|
+
/** The public origin and RP ID a `remote.set` or `remote.unset` moves from and to. */
|
|
269
|
+
export interface IControllerAuditRemoteMove {
|
|
270
|
+
previous: IControllerAuditRemoteEndpoint;
|
|
271
|
+
target: IControllerAuditRemoteEndpoint;
|
|
272
|
+
}
|
|
273
|
+
|
|
274
|
+
/**
|
|
275
|
+
* What an audit event records beyond its envelope (bounded plain JSON). This release records `remoteMove` on
|
|
276
|
+
* `remote.set` and `remote.unset`; any other key is a later release's, kept and pruned as it wrote it.
|
|
277
|
+
*/
|
|
278
|
+
export interface IControllerAuditEventDetails {
|
|
279
|
+
/** `remote.set` and `remote.unset` only: where the move goes from and to. */
|
|
280
|
+
remoteMove?: IControllerAuditRemoteMove;
|
|
281
|
+
[key: string]: unknown;
|
|
282
|
+
}
|
|
283
|
+
|
|
284
|
+
/** What this release records in an audit event's `details`. */
|
|
285
|
+
export interface IRecordAuditEventDetails {
|
|
286
|
+
/** `remote.set` and `remote.unset` only: where the move goes from and to. */
|
|
287
|
+
remoteMove: IControllerAuditRemoteMove;
|
|
288
|
+
}
|
|
289
|
+
|
|
253
290
|
/**
|
|
254
291
|
* A stored audit event. The audit log is shared with later releases, so a stored `type` is any audit type, also one
|
|
255
292
|
* this release does not know (a later release's, read back after a rollback). This release writes only its own types
|
|
@@ -270,10 +307,10 @@ export interface IControllerAuditEvent {
|
|
|
270
307
|
senderLabel?: string;
|
|
271
308
|
localCli?: IConfigurationLocalCliActor;
|
|
272
309
|
/**
|
|
273
|
-
* What
|
|
274
|
-
*
|
|
310
|
+
* What the event records beyond the envelope (bounded plain JSON): this release's `remoteMove`, or what a later
|
|
311
|
+
* release's type adds, read back after a rollback.
|
|
275
312
|
*/
|
|
276
|
-
details?:
|
|
313
|
+
details?: IControllerAuditEventDetails;
|
|
277
314
|
}
|
|
278
315
|
|
|
279
316
|
export interface IControllerTempPasswordDocument {
|
|
@@ -304,6 +341,7 @@ export interface IRecordAuditEventInput {
|
|
|
304
341
|
/** The sender label an agent message declared (`session.message`). */
|
|
305
342
|
senderLabel?: string;
|
|
306
343
|
localCli?: IConfigurationLocalCliActor;
|
|
344
|
+
details?: IRecordAuditEventDetails;
|
|
307
345
|
}
|
|
308
346
|
|
|
309
347
|
export interface IConsumeCeremonyOptions {
|
package/ts/interfaces.config.ts
CHANGED
|
@@ -13,8 +13,23 @@ export interface IControllerRuntimeConfig {
|
|
|
13
13
|
projectsRoot: string;
|
|
14
14
|
opencodePort: number;
|
|
15
15
|
tlsMode: TControllerTlsMode;
|
|
16
|
+
/**
|
|
17
|
+
* TLS-proxy mode only: the addresses a gateway reaches this controller from (canonical IP literals, sorted, no
|
|
18
|
+
* duplicates). A request from any other address off loopback is refused, and without any the controller listens
|
|
19
|
+
* on loopback only. Present only while it names one; changed only by `agl remote set` against a stopped controller.
|
|
20
|
+
*/
|
|
21
|
+
gatewaySources?: string[];
|
|
16
22
|
}
|
|
17
23
|
|
|
24
|
+
/**
|
|
25
|
+
* What this release declares about gateway sources (`controllerGatewaySourcesVersion` in its `package.json`): it
|
|
26
|
+
* stores and enforces them as `IControllerRuntimeConfig.gatewaySources` holds them. 1 is that contract as AGL 42 ships
|
|
27
|
+
* it; only an incompatible change to it raises the number. A release that declares none (every release before 42)
|
|
28
|
+
* refuses to start on a configuration that names them, so an upgrade transaction records its source's declaration
|
|
29
|
+
* (`sourceGatewaySourcesVersion`) and a recovery never rolls back to a source without it while they are stored.
|
|
30
|
+
*/
|
|
31
|
+
export const controllerGatewaySourcesVersion = 1 as const;
|
|
32
|
+
|
|
18
33
|
export interface IControllerRuntimeOverrides {
|
|
19
34
|
controllerPort: number;
|
|
20
35
|
publicOrigin?: string;
|
|
@@ -2,6 +2,7 @@ import type { controllerServiceUnitName, IControllerStatus, TControllerProcessMo
|
|
|
2
2
|
import type { IAuthoritySocketPaths } from './classes.authorityclient.js';
|
|
3
3
|
import type { IControllerRuntimeOverrides } from './interfaces.config.js';
|
|
4
4
|
import type * as plugins from './plugins.js';
|
|
5
|
+
import type { ITpmSecretCodec } from './classes.tpmsecretcodec.js';
|
|
5
6
|
|
|
6
7
|
export interface IControllerStartOptions {
|
|
7
8
|
processMode: TControllerProcessMode;
|
|
@@ -24,6 +25,8 @@ export interface IControllerStartOptions {
|
|
|
24
25
|
codexAppServerScope?: plugins.authswitch.ICodexAppServerScopeOptions;
|
|
25
26
|
/** Operator-provided first-start setup code; a random code is minted when absent. */
|
|
26
27
|
setupCode?: string;
|
|
28
|
+
/** Seals the trusted-proxy secret in TLS-proxy mode; TPM2 (`TpmSecretCodec`) when absent. For tests. */
|
|
29
|
+
trustedProxySecretCodec?: ITpmSecretCodec;
|
|
27
30
|
/** Private upgrade transaction token received over parent IPC. */
|
|
28
31
|
upgradeToken?: string;
|
|
29
32
|
upgradeGlobalRoot?: string;
|
|
@@ -1363,6 +1363,8 @@ export class AuthSwitchAuthorityDaemon {
|
|
|
1363
1363
|
const answered: Promise<void> = router.routeAndAddResponse(request, { trustedLocalData: { authoritySocket: socket },
|
|
1364
1364
|
trustedAbortSignal: abort.signal })
|
|
1365
1365
|
.then(async response => {
|
|
1366
|
+
// Nothing to answer (the router refused the envelope): refuse it by closing, never with a bare null.
|
|
1367
|
+
if (response === null) { socket.destroy(); return; }
|
|
1366
1368
|
// A client that is already gone is owed no answer.
|
|
1367
1369
|
if (!socket.writable) return;
|
|
1368
1370
|
const raw = JSON.stringify(response);
|