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.
Files changed (120) hide show
  1. package/changelog.md +41 -0
  2. package/dist_serve/bundle.js +2625 -2278
  3. package/dist_serve/bundle.js.map +2 -2
  4. package/dist_serve/bundle.js.third-party-notices.json +3 -68
  5. package/dist_serve/bundle.js.third-party-notices.txt +4 -137
  6. package/dist_ts/00_commitinfo_data.js +1 -1
  7. package/dist_ts/aglapi/aglapisurface.document.js +4 -4
  8. package/dist_ts/classes.authmodels.d.ts +2 -8
  9. package/dist_ts/classes.authmodels.js +60 -23
  10. package/dist_ts/classes.authstore.d.ts +24 -0
  11. package/dist_ts/classes.authstore.js +185 -23
  12. package/dist_ts/classes.cli.d.ts +3 -6
  13. package/dist_ts/classes.cli.js +38 -51
  14. package/dist_ts/classes.config.d.ts +17 -3
  15. package/dist_ts/classes.config.js +55 -18
  16. package/dist_ts/classes.controller.d.ts +83 -14
  17. package/dist_ts/classes.controller.js +545 -229
  18. package/dist_ts/classes.controllerdevices.d.ts +128 -0
  19. package/dist_ts/classes.controllerdevices.js +472 -0
  20. package/dist_ts/classes.controllermanagement.d.ts +42 -9
  21. package/dist_ts/classes.controllermanagement.js +72 -23
  22. package/dist_ts/classes.controllerservice.d.ts +3 -31
  23. package/dist_ts/classes.controllerservice.js +3 -47
  24. package/dist_ts/classes.mcpcontrollerhost.js +9 -3
  25. package/dist_ts/classes.processinspection.d.ts +8 -1
  26. package/dist_ts/classes.processinspection.js +92 -2
  27. package/dist_ts/classes.proxycontrol.js +6 -1
  28. package/dist_ts/classes.proxydaemon.d.ts +2 -2
  29. package/dist_ts/classes.proxydaemon.js +1 -1
  30. package/dist_ts/classes.proxystore.d.ts +2 -11
  31. package/dist_ts/classes.proxystore.js +3 -25
  32. package/dist_ts/classes.sessionfeed.d.ts +10 -1
  33. package/dist_ts/classes.sessionfeed.js +12 -2
  34. package/dist_ts/classes.tpmsecretcodec.d.ts +13 -0
  35. package/dist_ts/classes.tpmsecretcodec.js +28 -0
  36. package/dist_ts/classes.trustedproxysecrets.d.ts +91 -0
  37. package/dist_ts/classes.trustedproxysecrets.js +338 -0
  38. package/dist_ts/classes.upgradecoordinator.d.ts +14 -1
  39. package/dist_ts/classes.upgradecoordinator.js +21 -3
  40. package/dist_ts/classes.upgradetransaction.d.ts +32 -0
  41. package/dist_ts/classes.upgradetransaction.js +101 -4
  42. package/dist_ts/classes.validation.d.ts +2 -0
  43. package/dist_ts/classes.validation.js +2 -2
  44. package/dist_ts/functions.controlleradmission.d.ts +67 -0
  45. package/dist_ts/functions.controlleradmission.js +127 -0
  46. package/dist_ts/functions.deviceapi.d.ts +28 -0
  47. package/dist_ts/functions.deviceapi.js +246 -0
  48. package/dist_ts/functions.deviceproof.d.ts +33 -0
  49. package/dist_ts/functions.deviceproof.js +93 -0
  50. package/dist_ts/functions.remotecli.d.ts +27 -0
  51. package/dist_ts/functions.remotecli.js +241 -0
  52. package/dist_ts/functions.retiredenvironment.d.ts +11 -2
  53. package/dist_ts/functions.retiredenvironment.js +22 -5
  54. package/dist_ts/index.d.ts +1 -0
  55. package/dist_ts/index.js +2 -1
  56. package/dist_ts/interfaces.auth.d.ts +29 -4
  57. package/dist_ts/interfaces.auth.js +10 -1
  58. package/dist_ts/interfaces.config.d.ts +14 -0
  59. package/dist_ts/interfaces.config.js +9 -2
  60. package/dist_ts/interfaces.lifecycle.d.ts +3 -0
  61. package/dist_ts_authswitch/classes.authoritydaemon.js +6 -1
  62. package/dist_ts_interfaces/devices.d.ts +331 -0
  63. package/dist_ts_interfaces/devices.js +34 -0
  64. package/dist_ts_interfaces/index.d.ts +2 -0
  65. package/dist_ts_interfaces/index.js +3 -1
  66. package/dist_ts_interfaces/interfaces.d.ts +5 -3
  67. package/dist_ts_interfaces/interfaces.js +3 -2
  68. package/dist_ts_interfaces/management.d.ts +2 -2
  69. package/dist_ts_interfaces/management.js +2 -2
  70. package/dist_ts_interfaces/mcprequests.d.ts +1 -1
  71. package/dist_ts_interfaces/requests.d.ts +2 -2
  72. package/dist_ts_interfaces/requests.devices.d.ts +89 -0
  73. package/dist_ts_interfaces/requests.devices.js +2 -0
  74. package/dist_ts_interfaces/requests.upgrade.d.ts +0 -12
  75. package/package.json +12 -11
  76. package/readme.md +116 -24
  77. package/ts/00_commitinfo_data.ts +1 -1
  78. package/ts/aglapi/aglapisurface.document.ts +3 -3
  79. package/ts/classes.authmodels.ts +68 -25
  80. package/ts/classes.authstore.ts +183 -24
  81. package/ts/classes.cli.ts +38 -61
  82. package/ts/classes.config.ts +70 -21
  83. package/ts/classes.controller.ts +746 -329
  84. package/ts/classes.controllerdevices.ts +469 -0
  85. package/ts/classes.controllermanagement.ts +123 -49
  86. package/ts/classes.controllerservice.ts +3 -56
  87. package/ts/classes.mcpcontrollerhost.ts +10 -5
  88. package/ts/classes.processinspection.ts +84 -3
  89. package/ts/classes.proxycontrol.ts +2 -0
  90. package/ts/classes.proxydaemon.ts +3 -2
  91. package/ts/classes.proxystore.ts +4 -25
  92. package/ts/classes.sessionfeed.ts +13 -1
  93. package/ts/classes.tpmsecretcodec.ts +26 -0
  94. package/ts/classes.trustedproxysecrets.ts +317 -0
  95. package/ts/classes.upgradecoordinator.ts +33 -3
  96. package/ts/classes.upgradetransaction.ts +130 -1
  97. package/ts/classes.validation.ts +1 -1
  98. package/ts/functions.controlleradmission.ts +168 -0
  99. package/ts/functions.deviceapi.ts +295 -0
  100. package/ts/functions.deviceproof.ts +118 -0
  101. package/ts/functions.remotecli.ts +270 -0
  102. package/ts/functions.retiredenvironment.ts +25 -3
  103. package/ts/index.ts +1 -0
  104. package/ts/interfaces.auth.ts +41 -3
  105. package/ts/interfaces.config.ts +15 -0
  106. package/ts/interfaces.lifecycle.ts +3 -0
  107. package/ts_authswitch/classes.authoritydaemon.ts +2 -0
  108. package/ts_interfaces/devices.schema.json +890 -0
  109. package/ts_interfaces/devices.ts +392 -0
  110. package/ts_interfaces/index.ts +2 -0
  111. package/ts_interfaces/interfaces.ts +5 -2
  112. package/ts_interfaces/management.ts +2 -2
  113. package/ts_interfaces/mcprequests.ts +1 -1
  114. package/ts_interfaces/requests.devices.ts +95 -0
  115. package/ts_interfaces/requests.ts +10 -10
  116. package/ts_interfaces/requests.upgrade.ts +0 -16
  117. package/ts_web/00_commitinfo_data.ts +1 -1
  118. package/ts_web/classes.controllersocketclient.ts +27 -0
  119. package/ts_web/elements.devices.ts +752 -0
  120. 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. The upgrade token a
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) => nameArg.toUpperCase().startsWith(retiredPrefix))
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';
@@ -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 a later release's type records beyond the envelope (bounded plain JSON). This release never writes or
274
- * interprets it; it is declared so a rolled-back controller still reads and prunes such events.
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?: Record<string, unknown>;
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 {
@@ -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);