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
@@ -0,0 +1,93 @@
1
+ import * as plugins from './plugins.js';
2
+ import { deviceAuthenticationMessageLabel, devicePairingMessageLabel, devicePairingScheme, deviceSecretBytes, } from '../dist_ts_interfaces/devices.js';
3
+ /*
4
+ * The cryptography of the device protocol (`ts_interfaces/devices.ts`): the messages a device key signs, the P-256 key
5
+ * and signature checks, the fingerprint people compare, and the pairing payload of the QR code. Everything runs on
6
+ * `node:crypto`; the signed messages are byte for byte what HarnessKit's `DeviceProof` builds.
7
+ */
8
+ /** Everything of a P-256 SubjectPublicKeyInfo in DER before the uncompressed point's 64 bytes. */
9
+ const p256SpkiPrefix = Buffer.from('3059301306072a8648ce3d020106082a8648ce3d03010703420004', 'hex');
10
+ const p256SpkiBytes = p256SpkiPrefix.byteLength + 64;
11
+ const base64UrlPattern = /^[A-Za-z0-9_-]+$/u;
12
+ /**
13
+ * The bytes of a base64url text without padding, refused (undefined) unless it is exactly that text's canonical form,
14
+ * of `byteLengthArg` bytes when given and of at most `maximumBytesArg` otherwise.
15
+ */
16
+ export const decodeDeviceBase64Url = (valueArg, sizeArg) => {
17
+ if (typeof valueArg !== 'string' || !base64UrlPattern.test(valueArg))
18
+ return undefined;
19
+ const maximum = 'bytes' in sizeArg ? sizeArg.bytes : sizeArg.maximumBytes;
20
+ if (valueArg.length > Math.ceil((maximum * 4) / 3))
21
+ return undefined;
22
+ const bytes = Buffer.from(valueArg, 'base64url');
23
+ if (bytes.toString('base64url') !== valueArg)
24
+ return undefined;
25
+ if ('bytes' in sizeArg ? bytes.byteLength !== sizeArg.bytes : bytes.byteLength === 0)
26
+ return undefined;
27
+ return bytes;
28
+ };
29
+ /** A signed message: each field as a 4-byte big-endian length followed by its bytes. */
30
+ const signedMessage = (fieldsArg) => Buffer.concat(fieldsArg.flatMap((fieldArg) => {
31
+ const length = Buffer.alloc(4);
32
+ length.writeUInt32BE(fieldArg.byteLength);
33
+ return [length, fieldArg];
34
+ }));
35
+ /** The message a device signs to pair: it binds the key to this controller, origin and code. */
36
+ export const devicePairingMessage = (bindingArg, codeArg) => signedMessage([
37
+ Buffer.from(devicePairingMessageLabel, 'utf8'),
38
+ Buffer.from(bindingArg.controllerId, 'utf8'),
39
+ Buffer.from(bindingArg.origin, 'utf8'),
40
+ plugins.crypto.createHash('sha256').update(codeArg).digest(),
41
+ bindingArg.publicKey,
42
+ ]);
43
+ /** The message a device signs to authenticate one connection: it binds the key to this controller, origin and nonce. */
44
+ export const deviceAuthenticationMessage = (bindingArg, nonceArg) => {
45
+ if (nonceArg.byteLength !== deviceSecretBytes)
46
+ throw new Error(`A device nonce is ${deviceSecretBytes} bytes.`);
47
+ return signedMessage([
48
+ Buffer.from(deviceAuthenticationMessageLabel, 'utf8'),
49
+ Buffer.from(bindingArg.controllerId, 'utf8'),
50
+ Buffer.from(bindingArg.origin, 'utf8'),
51
+ nonceArg,
52
+ bindingArg.publicKey,
53
+ ]);
54
+ };
55
+ /**
56
+ * A device's public key: a P-256 SubjectPublicKeyInfo in DER with an uncompressed point on the curve, in exactly the
57
+ * form `node:crypto` exports it again, so one key has one text and one fingerprint. Undefined for anything else.
58
+ */
59
+ export const importDevicePublicKey = (spkiArg) => {
60
+ const spki = Buffer.from(spkiArg);
61
+ if (spki.byteLength !== p256SpkiBytes || !spki.subarray(0, p256SpkiPrefix.byteLength).equals(p256SpkiPrefix)) {
62
+ return undefined;
63
+ }
64
+ let key;
65
+ try {
66
+ key = plugins.crypto.createPublicKey({ key: spki, format: 'der', type: 'spki' });
67
+ }
68
+ catch {
69
+ return undefined;
70
+ }
71
+ if (key.asymmetricKeyType !== 'ec' || key.asymmetricKeyDetails?.namedCurve !== 'prime256v1')
72
+ return undefined;
73
+ return key.export({ format: 'der', type: 'spki' }).equals(spki) ? key : undefined;
74
+ };
75
+ /** Whether `signatureArg` (ECDSA P-256 with SHA-256, DER) is the key's signature of `messageArg`. */
76
+ export const verifyDeviceSignature = (keyArg, messageArg, signatureArg) => {
77
+ try {
78
+ return plugins.crypto.verify('sha256', messageArg, { key: keyArg, dsaEncoding: 'der' }, signatureArg);
79
+ }
80
+ catch {
81
+ return false;
82
+ }
83
+ };
84
+ /** A key's fingerprint for people to compare: SHA-256 of the SPKI, the first 16 bytes as 8 groups of 4 uppercase hex. */
85
+ export const deviceKeyFingerprint = (spkiArg) => plugins.crypto.createHash('sha256').update(spkiArg)
86
+ .digest().subarray(0, 16).toString('hex').toUpperCase().match(/.{4}/gu).join(' ');
87
+ /** Percent-encodes everything in a query value but letters, digits and `-._~`, as HarnessKit's payload writer does. */
88
+ const queryValue = (valueArg) => encodeURIComponent(valueArg)
89
+ .replace(/[!'()*]/gu, (characterArg) => `%${characterArg.charCodeAt(0).toString(16).toUpperCase()}`);
90
+ /** The QR code's payload: `agl-pair:?origin=<https origin>&controller=<controller id>&code=<base64url>`, each once. */
91
+ export const devicePairingPayload = (originArg, controllerIdArg, codeArg) => (`${devicePairingScheme}:?origin=${queryValue(originArg)}&controller=${queryValue(controllerIdArg)}`
92
+ + `&code=${Buffer.from(codeArg).toString('base64url')}`);
93
+ //# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiZnVuY3Rpb25zLmRldmljZXByb29mLmpzIiwic291cmNlUm9vdCI6IiIsInNvdXJjZXMiOlsiLi4vLi4vdHMvZnVuY3Rpb25zLmRldmljZXByb29mLnRzIl0sIm5hbWVzIjpbXSwibWFwcGluZ3MiOiJBQUFBLE9BQU8sS0FBSyxPQUFPLE1BQU0sY0FBYyxDQUFDO0FBQ3hDLE9BQU8sRUFDTCxnQ0FBZ0MsRUFDaEMseUJBQXlCLEVBQ3pCLG1CQUFtQixFQUNuQixpQkFBaUIsR0FDbEIsTUFBTSw2QkFBNkIsQ0FBQztBQUVyQzs7OztHQUlHO0FBRUgsa0dBQWtHO0FBQ2xHLE1BQU0sY0FBYyxHQUFHLE1BQU0sQ0FBQyxJQUFJLENBQUMsd0RBQXdELEVBQUUsS0FBSyxDQUFDLENBQUM7QUFDcEcsTUFBTSxhQUFhLEdBQUcsY0FBYyxDQUFDLFVBQVUsR0FBRyxFQUFFLENBQUM7QUFDckQsTUFBTSxnQkFBZ0IsR0FBRyxtQkFBbUIsQ0FBQztBQUU3Qzs7O0dBR0c7QUFDSCxNQUFNLENBQUMsTUFBTSxxQkFBcUIsR0FBRyxDQUNuQyxRQUFpQixFQUNqQixPQUFxRCxFQUNqQyxFQUFFO0lBQ3RCLElBQUksT0FBTyxRQUFRLEtBQUssUUFBUSxJQUFJLENBQUMsZ0JBQWdCLENBQUMsSUFBSSxDQUFDLFFBQVEsQ0FBQztRQUFFLE9BQU8sU0FBUyxDQUFDO0lBQ3ZGLE1BQU0sT0FBTyxHQUFHLE9BQU8sSUFBSSxPQUFPLENBQUMsQ0FBQyxDQUFDLE9BQU8sQ0FBQyxLQUFLLENBQUMsQ0FBQyxDQUFDLE9BQU8sQ0FBQyxZQUFZLENBQUM7SUFDMUUsSUFBSSxRQUFRLENBQUMsTUFBTSxHQUFHLElBQUksQ0FBQyxJQUFJLENBQUMsQ0FBQyxPQUFPLEdBQUcsQ0FBQyxDQUFDLEdBQUcsQ0FBQyxDQUFDO1FBQUUsT0FBTyxTQUFTLENBQUM7SUFDckUsTUFBTSxLQUFLLEdBQUcsTUFBTSxDQUFDLElBQUksQ0FBQyxRQUFRLEVBQUUsV0FBVyxDQUFDLENBQUM7SUFDakQsSUFBSSxLQUFL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
@@ -0,0 +1,27 @@
1
+ import { type ITpmSecretCodec } from './classes.tpmsecretcodec.js';
2
+ export declare const remoteCliHelp = "Usage: agl remote set --public-origin ORIGIN [--rp-id HOST] [--gateway-source ADDRESS]... [--port PORT]\n agl remote unset [--port PORT]\n agl remote secret import [--port PORT] < SECRET_FILE\nEvery command runs against a stopped controller (agl stop first) on the port it was initialized on (default 4097),\nas the local OS user, and is audited.\nset moves the port to the HTTPS public origin ORIGIN behind a TLS reverse proxy, with WebAuthn RP ID HOST (default:\nthe origin's hostname). Each --gateway-source names an address the proxy reaches this host from; without one only a\nreverse proxy on this host reaches the controller, which then listens on loopback. The controller keeps its id and\nall of its data. When the origin or RP ID changes, its passkey is removed and every temporary password revoked: the\nnext start prints a new setup code, to enroll a passkey at the new origin. When the origin changes, every paired\ndevice is removed as well (a device signs the origin it paired with). Run it again to change the gateway sources;\nthe passkey and the devices then stay.\nunset moves the port back to http://localhost:PORT (RP ID localhost), removes the passkey and every paired device,\nrevokes every temporary password and forgets the trusted-proxy secret.\nsecret import reads a 32-byte base64url secret (43 characters) from standard input, never from a terminal, and makes\nit the controller's trusted-proxy secret, for a reverse proxy other than AGL's own gateway: that proxy injects it as\nX-Harness-Controller-Proxy-Secret. The secret is sealed with the TPM and never printed.\n";
3
+ export type TRemoteCliArguments = {
4
+ action: 'set';
5
+ port: number;
6
+ publicOrigin: string;
7
+ rpId?: string;
8
+ gatewaySources: string[];
9
+ } | {
10
+ action: 'unset';
11
+ port: number;
12
+ } | {
13
+ action: 'secret-import';
14
+ port: number;
15
+ };
16
+ export declare const parseRemoteCliArguments: (argsArg: readonly string[]) => TRemoteCliArguments;
17
+ export interface IRemoteCliOptions {
18
+ /** Seals the trusted-proxy secret; TPM2 when absent. For tests. */
19
+ codec?: ITpmSecretCodec;
20
+ /** Where `secret import` reads the secret; this process's standard input when absent. */
21
+ input?: NodeJS.ReadableStream & {
22
+ isTTY?: boolean;
23
+ };
24
+ /** Where the outcome is written; standard output when absent. */
25
+ write?: (textArg: string) => void;
26
+ }
27
+ export declare const runRemoteCli: (argsArg: string[], optionsArg?: IRemoteCliOptions) => Promise<void>;
@@ -0,0 +1,241 @@
1
+ import * as plugins from './plugins.js';
2
+ import { defaultControllerPort, resolveMovedRuntimeConfig, resolveStoredRuntimeConfig, } from './classes.config.js';
3
+ import { acquireStartAdmission, withControllerAuthStore } from './classes.cli.js';
4
+ import { TpmSecretCodec } from './classes.tpmsecretcodec.js';
5
+ import { decodeTrustedProxySecret, importControllerTrustedProxySecret, removeControllerTrustedProxySecret, } from './classes.trustedproxysecrets.js';
6
+ import { configurationLocalCliActor } from './functions.configurationactor.js';
7
+ import { preflightAGLHomeMigration } from './functions.controllerdataroot.js';
8
+ export const remoteCliHelp = `Usage: agl remote set --public-origin ORIGIN [--rp-id HOST] [--gateway-source ADDRESS]... [--port PORT]
9
+ agl remote unset [--port PORT]
10
+ agl remote secret import [--port PORT] < SECRET_FILE
11
+ Every command runs against a stopped controller (agl stop first) on the port it was initialized on (default 4097),
12
+ as the local OS user, and is audited.
13
+ set moves the port to the HTTPS public origin ORIGIN behind a TLS reverse proxy, with WebAuthn RP ID HOST (default:
14
+ the origin's hostname). Each --gateway-source names an address the proxy reaches this host from; without one only a
15
+ reverse proxy on this host reaches the controller, which then listens on loopback. The controller keeps its id and
16
+ all of its data. When the origin or RP ID changes, its passkey is removed and every temporary password revoked: the
17
+ next start prints a new setup code, to enroll a passkey at the new origin. When the origin changes, every paired
18
+ device is removed as well (a device signs the origin it paired with). Run it again to change the gateway sources;
19
+ the passkey and the devices then stay.
20
+ unset moves the port back to http://localhost:PORT (RP ID localhost), removes the passkey and every paired device,
21
+ revokes every temporary password and forgets the trusted-proxy secret.
22
+ secret import reads a 32-byte base64url secret (43 characters) from standard input, never from a terminal, and makes
23
+ it the controller's trusted-proxy secret, for a reverse proxy other than AGL's own gateway: that proxy injects it as
24
+ X-Harness-Controller-Proxy-Secret. The secret is sealed with the TPM and never printed.
25
+ `;
26
+ export const parseRemoteCliArguments = (argsArg) => {
27
+ const rest = [...argsArg];
28
+ const first = rest.shift();
29
+ const action = first === 'secret' && rest[0] === 'import' ? (rest.shift(), 'secret-import')
30
+ : first === 'set' || first === 'unset' ? first : undefined;
31
+ if (!action)
32
+ throw new Error(remoteCliHelp);
33
+ let port = defaultControllerPort;
34
+ let publicOrigin;
35
+ let rpId;
36
+ const gatewaySources = [];
37
+ const seen = new Set();
38
+ for (let index = 0; index < rest.length; index++) {
39
+ const token = rest[index];
40
+ const equals = token.startsWith('--') ? token.indexOf('=') : -1;
41
+ const flag = equals > 0 ? token.slice(0, equals) : token;
42
+ if (flag !== '--gateway-source' && seen.has(flag))
43
+ throw new Error(`Duplicate remote option: ${flag}.`);
44
+ seen.add(flag);
45
+ const value = equals > 0 ? token.slice(equals + 1) : rest[++index];
46
+ if (value === undefined || value === '' || (equals < 0 && value.startsWith('--'))) {
47
+ throw new Error(`${flag} requires a value.`);
48
+ }
49
+ if (flag === '--port') {
50
+ port = Number(value);
51
+ continue;
52
+ }
53
+ if (action === 'set' && flag === '--public-origin') {
54
+ publicOrigin = value;
55
+ continue;
56
+ }
57
+ if (action === 'set' && flag === '--rp-id') {
58
+ rpId = value;
59
+ continue;
60
+ }
61
+ if (action === 'set' && flag === '--gateway-source') {
62
+ gatewaySources.push(value);
63
+ continue;
64
+ }
65
+ throw new Error(`Unknown remote option: ${flag}.`);
66
+ }
67
+ if (!/^[1-9][0-9]{0,4}$/u.test(String(port)) || port > 65_535)
68
+ throw new Error('--port must be an integer between 1 and 65535.');
69
+ if (action !== 'set')
70
+ return { action, port };
71
+ if (publicOrigin === undefined)
72
+ throw new Error('agl remote set requires --public-origin.');
73
+ return { action, port, publicOrigin, ...(rpId === undefined ? {} : { rpId }), gatewaySources };
74
+ };
75
+ /** A trusted-proxy secret file is a few dozen bytes; anything past this is not one. */
76
+ const maximumSecretInputBytes = 4_096;
77
+ const readSecretInput = async (inputArg) => {
78
+ if (inputArg.isTTY) {
79
+ throw new Error('agl remote secret import reads the secret from a pipe or a file, never from a terminal: '
80
+ + 'run it as `agl remote secret import --port <port> < SECRET_FILE`.');
81
+ }
82
+ const chunks = [];
83
+ let bytes = 0;
84
+ try {
85
+ for await (const chunk of inputArg) {
86
+ const buffer = typeof chunk === 'string' ? Buffer.from(chunk, 'utf8') : Buffer.from(chunk);
87
+ chunks.push(buffer);
88
+ bytes += buffer.byteLength;
89
+ if (bytes > maximumSecretInputBytes)
90
+ throw new Error('The standard input is longer than a trusted-proxy secret.');
91
+ }
92
+ return Buffer.concat(chunks).toString('utf8').trim();
93
+ }
94
+ finally {
95
+ for (const chunk of chunks)
96
+ chunk.fill(0);
97
+ }
98
+ };
99
+ /**
100
+ * Holds the controller's port on loopback while a command changes its stopped configuration: a controller still
101
+ * listening there (on loopback or every interface) is found, and one starting meanwhile cannot listen until the
102
+ * command ends.
103
+ */
104
+ const holdStoppedControllerPort = async (portArg) => {
105
+ const server = plugins.net.createServer((socketArg) => socketArg.destroy());
106
+ try {
107
+ await new Promise((resolve, reject) => {
108
+ server.once('error', reject);
109
+ server.listen({ host: '127.0.0.1', port: portArg, exclusive: true }, () => {
110
+ server.off('error', reject);
111
+ resolve();
112
+ });
113
+ });
114
+ }
115
+ catch (errorArg) {
116
+ server.close();
117
+ if (errorArg.code === 'EADDRINUSE') {
118
+ throw new Error(`Port ${portArg} is in use: agl remote changes a stopped controller only. Stop it with `
119
+ + `\`agl stop --port ${portArg}\` and run this again.`);
120
+ }
121
+ throw errorArg;
122
+ }
123
+ return server;
124
+ };
125
+ const releasePort = (serverArg) => new Promise((resolve) => {
126
+ serverArg.close(() => resolve());
127
+ });
128
+ /** Runs `actionArg` on the stored configuration of a stopped, initialized controller, under start admission. */
129
+ const withStoppedController = async (portArg, actionArg) => {
130
+ await preflightAGLHomeMigration();
131
+ const lease = await acquireStartAdmission('remote');
132
+ try {
133
+ const port = await holdStoppedControllerPort(portArg);
134
+ try {
135
+ return await withControllerAuthStore('The remote configuration change', async (authStoreArg, issuerArg) => {
136
+ const stored = await authStoreArg.getRuntimeConfig(portArg);
137
+ if (!stored) {
138
+ throw new Error(`No controller configuration exists for port ${portArg}. Start the controller on that port `
139
+ + 'once first, with the same AGL_HOME, AGL_DB_DIR or AGL_MONGO_URL / AGL_MONGO_DB environment.');
140
+ }
141
+ const config = await resolveStoredRuntimeConfig(stored, { controllerPort: portArg });
142
+ return actionArg({ authStore: authStoreArg, issuer: issuerArg, controllerId: `controller:${portArg}`, config });
143
+ });
144
+ }
145
+ finally {
146
+ await releasePort(port);
147
+ }
148
+ }
149
+ finally {
150
+ await lease?.release();
151
+ }
152
+ };
153
+ /**
154
+ * Records `typeArg` as attempted, runs the change, and records its outcome, attributed to this OS user and process;
155
+ * a move records on every event where it goes from and to (`details.remoteMove`).
156
+ */
157
+ const audited = async (authStoreArg, typeArg, actionArg, remoteMoveArg) => {
158
+ const localCli = await configurationLocalCliActor();
159
+ const detail = { localCli, ...(remoteMoveArg === undefined ? {} : { details: { remoteMove: remoteMoveArg } }) };
160
+ await authStoreArg.recordAuditEvent({ type: typeArg, outcome: 'attempted', ...detail });
161
+ let result;
162
+ try {
163
+ result = await actionArg();
164
+ }
165
+ catch (errorArg) {
166
+ try {
167
+ await authStoreArg.recordAuditEvent({ type: typeArg, outcome: 'failed', ...detail });
168
+ }
169
+ catch (auditErrorArg) {
170
+ throw new AggregateError([errorArg, auditErrorArg], 'The change failed and its failure could not be audited.', { cause: errorArg });
171
+ }
172
+ throw errorArg;
173
+ }
174
+ await authStoreArg.recordAuditEvent({ type: typeArg, outcome: 'succeeded', ...detail });
175
+ return result;
176
+ };
177
+ const describeConfig = (configArg) => configArg.tlsMode === 'local'
178
+ ? `${configArg.publicOrigin} (RP ID ${configArg.rpId}, local)`
179
+ : `${configArg.publicOrigin} (RP ID ${configArg.rpId}, behind a TLS reverse proxy, gateway sources: `
180
+ + `${configArg.gatewaySources?.join(', ') ?? 'none, only a reverse proxy on this host'})`;
181
+ const moveOutcome = (controllerIdArg, previousArg, targetArg, enrollmentResetArg, devicesRemovedArg) => [
182
+ `Moved ${controllerIdArg} from ${describeConfig(previousArg)} to ${describeConfig(targetArg)}.`,
183
+ ...(enrollmentResetArg
184
+ ? [`Its passkey was removed and every temporary password revoked. The next \`agl start --port ${targetArg.controllerPort}\` `
185
+ + `prints a setup code: enroll a passkey with it at ${targetArg.publicOrigin}.`]
186
+ : ['Its passkey stays: the origin and RP ID did not change.']),
187
+ ...(devicesRemovedArg > 0
188
+ ? [`${devicesRemovedArg === 1 ? 'Its paired device was' : `Its ${devicesRemovedArg} paired devices were`} removed: a device `
189
+ + 'signs the origin it paired with. Pair it again in Settings → Devices once the controller has a public origin.']
190
+ : []),
191
+ ...(targetArg.gatewaySources
192
+ ? [`Let only ${targetArg.gatewaySources.join(', ')} reach port ${targetArg.controllerPort} through the host firewall.`]
193
+ : []),
194
+ ].join('\n') + '\n';
195
+ export const runRemoteCli = async (argsArg, optionsArg = {}) => {
196
+ const write = optionsArg.write ?? ((textArg) => { process.stdout.write(textArg); });
197
+ if (argsArg.includes('--help') || argsArg.includes('-h')) {
198
+ write(remoteCliHelp);
199
+ return;
200
+ }
201
+ const parsed = parseRemoteCliArguments(argsArg);
202
+ if (parsed.action === 'secret-import') {
203
+ const secret = await readSecretInput(optionsArg.input ?? process.stdin);
204
+ decodeTrustedProxySecret(secret).fill(0);
205
+ const outcome = await withStoppedController(parsed.port, async (controllerArg) => {
206
+ if (controllerArg.config.tlsMode !== 'proxy') {
207
+ throw new Error(`${controllerArg.controllerId} runs on localhost, which takes no trusted-proxy secret: move it `
208
+ + 'behind the reverse proxy with `agl remote set` first.');
209
+ }
210
+ return audited(controllerArg.authStore, 'remote.secret.import', () => importControllerTrustedProxySecret({
211
+ controllerId: controllerArg.controllerId,
212
+ issuerId: controllerArg.issuer.issuerId,
213
+ codec: optionsArg.codec ?? new TpmSecretCodec(),
214
+ secret,
215
+ }));
216
+ });
217
+ write(`Imported the trusted-proxy secret of controller:${parsed.port} (generation ${outcome.generation}). `
218
+ + 'Its reverse proxy must send it as X-Harness-Controller-Proxy-Secret.\n');
219
+ return;
220
+ }
221
+ write(await withStoppedController(parsed.port, async (controllerArg) => {
222
+ const target = resolveMovedRuntimeConfig(controllerArg.config, parsed.action === 'set'
223
+ ? { publicOrigin: parsed.publicOrigin, ...(parsed.rpId === undefined ? {} : { rpId: parsed.rpId }), gatewaySources: parsed.gatewaySources }
224
+ : 'local');
225
+ const type = parsed.action === 'set' ? 'remote.set' : 'remote.unset';
226
+ const moved = await audited(controllerArg.authStore, type, async () => {
227
+ const result = await controllerArg.authStore.moveRuntimeConfig(target);
228
+ // Local mode takes no trusted-proxy secret, and moving back behind a proxy generates a new one.
229
+ if (parsed.action === 'unset')
230
+ await removeControllerTrustedProxySecret(controllerArg.controllerId);
231
+ return result;
232
+ }, {
233
+ previous: { publicOrigin: controllerArg.config.publicOrigin, rpId: controllerArg.config.rpId },
234
+ target: { publicOrigin: target.publicOrigin, rpId: target.rpId },
235
+ });
236
+ return moved.changed
237
+ ? moveOutcome(controllerArg.controllerId, moved.previous, target, moved.enrollmentReset, moved.devicesRemoved)
238
+ : `${controllerArg.controllerId} already serves ${describeConfig(target)}; nothing changed.\n`;
239
+ }));
240
+ };
241
+ //# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiZnVuY3Rpb25zLnJlbW90ZWNsaS5qcyIsInNvdXJjZVJvb3QiOiIiLCJzb3VyY2VzIjpbIi4uLy4uL3RzL2Z1bmN0aW9ucy5yZW1vdGVjbGkudHMiXSwibmFtZXMiOltdLCJtYXBwaW5ncyI6IkFBQUEsT0FBTyxLQUFLLE9BQU8sTUFBTSxjQUFjLENBQUM7QUFDeEMsT0FBTyxFQUNMLHFCQUFxQixFQUNyQix5QkFBeUIsRUFDekIsMEJBQTBCLEdBQzNCLE1BQU0scUJBQXFCLENBQUM7QUFDN0IsT0FBTyxFQUFFLHFCQUFxQixFQUFFLHVCQUF1QixFQUFFLE1BQU0sa0JBQWtCLENBQUM7QUFFbEYsT0FBTyxFQUFFLGNBQWMsRUFBd0IsTUFBTSw2QkFBNkIsQ0FBQztBQUNuRixPQUFPLEVBQ0wsd0JBQXdCLEVBQ3hCLGtDQUFrQyxFQUNsQyxrQ0FBa0MsR0FDbkMsTUFBTSxrQ0FBa0MsQ0FBQztBQUMxQyxPQUFPLEVBQUUsMEJBQTBCLEVBQUUsTUFBTSxtQ0FBbUMsQ0FBQztBQUMvRSxPQUFPLEVBQUUseUJBQXlCLEVBQUUsTUFBTSxtQ0FBbUMsQ0FBQztBQUs5RSxNQUFNLENBQUMsTUFBTSxhQUFhLEdBQUc7Ozs7Ozs7Ozs7Ozs7Ozs7O0NBaUI1QixDQUFDO0FBT0YsTUFBTSxDQUFDLE1BQU0sdUJBQXVCLEdBQUcsQ0FBQyxPQUEwQixFQUF1QixFQUFFO0lBQ3pGLE1BQU0sSUFBSSxHQUFHLENBQUMsR0FBRyxPQUFPLENBQUMsQ0FBQztJQUMxQixNQUFNLEtBQUssR0FBRyxJQUFJLENBQUMsS0FBSyxFQUFFLENBQUM7SUFDM0IsTUFBTSxNQUFNLEdBQUcsS0FBSyxLQUFLLFFBQVEsSUFBSSxJQUFJLENBQUMsQ0FBQyxDQUFDLEtBQUssUUFBUSxDQUFDLENBQUMsQ0FBQyxDQUFDLElBQUksQ0FBQyxLQUFLLEVBQUUsRUFBRSxlQUF3QixDQUFDO1FBQ2xHLENBQUMsQ0FBQyxLQUFLLEtBQUssS0FBSyxJQUFJLEtBQUssS0FBSyxPQUFPLENBQUMsQ0FBQyxDQUFDLEtB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
@@ -4,13 +4,22 @@
4
4
  * an embedded database instead of the configured server, for example. Starting is refused instead.
5
5
  */
6
6
  export declare const retiredControllerEnvironmentNames: Readonly<Record<string, string>>;
7
+ /**
8
+ * Configuration names retired without a replacement variable, each with what to do instead. A process started with
9
+ * one would silently run without it, so starting is refused here too.
10
+ */
11
+ export declare const retiredControllerEnvironmentRemedies: Readonly<Record<string, string>>;
7
12
  export declare class RetiredControllerEnvironmentError extends Error {
8
13
  readonly names: readonly string[];
9
14
  constructor(names: readonly string[]);
10
15
  }
11
16
  /**
12
- * Refuses an environment that still sets a retired `HARNESS_CONTROLLER_*` name. The upgrade token a
17
+ * Refuses an environment that still sets a retired `HARNESS_CONTROLLER_*` name or a name retired without a
18
+ * replacement (`retiredControllerEnvironmentRemedies`). The upgrade token a
13
19
  * pre-33 upgrade worker hands its target is the one exception: it is a process wire, not configuration.
14
20
  * Only names are reported, never values.
15
21
  */
16
- export declare const assertNoRetiredControllerEnvironment: (environmentArg?: NodeJS.ProcessEnv) => void;
22
+ export declare const assertNoRetiredControllerEnvironment: (environmentArg?: NodeJS.ProcessEnv, optionsArg?: {
23
+ /** `agl remote`, which migrates them: the names of `retiredControllerEnvironmentRemedies` are left alone. */
24
+ allowRemedied?: boolean;
25
+ }) => void;
@@ -9,18 +9,32 @@ export const retiredControllerEnvironmentNames = Object.freeze({
9
9
  HARNESS_CONTROLLER_MONGO_DB: 'AGL_MONGO_DB',
10
10
  HARNESS_CONTROLLER_DB_DIR: 'AGL_DB_DIR',
11
11
  HARNESS_CONTROLLER_FORWARD_ENV: 'AGL_FORWARD_ENV',
12
- HARNESS_CONTROLLER_TRUSTED_PROXY_SECRET: 'AGL_TRUSTED_PROXY_SECRET',
13
12
  HARNESS_CONTROLLER_CLAUDE_EXECUTABLE: 'AGL_CLAUDE_EXECUTABLE',
14
13
  HARNESS_CONTROLLER_CODEX_EXECUTABLE: 'AGL_CODEX_EXECUTABLE',
15
14
  HARNESS_CONTROLLER_CODEX_SERVER_URL: 'AGL_CODEX_SERVER_URL',
16
15
  HARNESS_CONTROLLER_CODEX_SERVER_TOKEN: 'AGL_CODEX_SERVER_TOKEN',
17
16
  });
17
+ const trustedProxySecretRemedy = 'The trusted-proxy secret is generated and sealed in the controller\'s database '
18
+ + 'now; for a reverse proxy other than AGL\'s own gateway, stop the controller, pipe your secret into '
19
+ + '`agl remote secret import --port <port>` (for example `printf \'%s\' "$AGL_TRUSTED_PROXY_SECRET" | agl remote '
20
+ + 'secret import --port 4097`), then unset the variable.';
21
+ /**
22
+ * Configuration names retired without a replacement variable, each with what to do instead. A process started with
23
+ * one would silently run without it, so starting is refused here too.
24
+ */
25
+ export const retiredControllerEnvironmentRemedies = Object.freeze({
26
+ AGL_TRUSTED_PROXY_SECRET: trustedProxySecretRemedy,
27
+ HARNESS_CONTROLLER_TRUSTED_PROXY_SECRET: trustedProxySecretRemedy,
28
+ });
18
29
  const retiredPrefix = 'HARNESS_CONTROLLER_';
19
30
  export class RetiredControllerEnvironmentError extends Error {
20
31
  names;
21
32
  constructor(names) {
22
33
  super(`AGL no longer reads ${names.join(', ')}. `
23
34
  + names.map((nameArg) => {
35
+ const remedy = retiredControllerEnvironmentRemedies[nameArg];
36
+ if (remedy)
37
+ return `${nameArg}: ${remedy}`;
24
38
  const replacement = retiredControllerEnvironmentNames[nameArg];
25
39
  return replacement ? `Set ${replacement} instead of ${nameArg}.` : `Remove ${nameArg}.`;
26
40
  }).join(' '));
@@ -29,17 +43,20 @@ export class RetiredControllerEnvironmentError extends Error {
29
43
  }
30
44
  }
31
45
  /**
32
- * Refuses an environment that still sets a retired `HARNESS_CONTROLLER_*` name. The upgrade token a
46
+ * Refuses an environment that still sets a retired `HARNESS_CONTROLLER_*` name or a name retired without a
47
+ * replacement (`retiredControllerEnvironmentRemedies`). The upgrade token a
33
48
  * pre-33 upgrade worker hands its target is the one exception: it is a process wire, not configuration.
34
49
  * Only names are reported, never values.
35
50
  */
36
- export const assertNoRetiredControllerEnvironment = (environmentArg = process.env) => {
51
+ export const assertNoRetiredControllerEnvironment = (environmentArg = process.env, optionsArg = {}) => {
37
52
  const names = Object.keys(environmentArg)
38
53
  .filter((nameArg) => environmentArg[nameArg] !== undefined)
39
- .filter((nameArg) => nameArg.toUpperCase().startsWith(retiredPrefix))
54
+ .filter((nameArg) => !(optionsArg.allowRemedied && Object.hasOwn(retiredControllerEnvironmentRemedies, nameArg)))
55
+ .filter((nameArg) => nameArg.toUpperCase().startsWith(retiredPrefix)
56
+ || Object.hasOwn(retiredControllerEnvironmentRemedies, nameArg))
40
57
  .filter((nameArg) => nameArg !== preAglUpgradeTokenEnvironmentVariable)
41
58
  .sort();
42
59
  if (names.length > 0)
43
60
  throw new RetiredControllerEnvironmentError(names);
44
61
  };
45
- //# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiZnVuY3Rpb25zLnJldGlyZWRlbnZpcm9ubWVudC5qcyIsInNvdXJjZVJvb3QiOiIiLCJzb3VyY2VzIjpbIi4uLy4uL3RzL2Z1bmN0aW9ucy5yZXRpcmVkZW52aXJvbm1lbnQudHMiXSwibmFtZXMiOltdLCJtYXBwaW5ncyI6IkFBQUEsT0FBTyxFQUFFLHFDQUFxQyxFQUFFLE1BQU0sbUNBQW1DLENBQUM7QUFFMUY7Ozs7R0FJRztBQUNILE1BQU0sQ0FBQyxNQUFNLGlDQUFpQyxHQUFxQyxNQUFNLENBQUMsTUFBTSxDQUFDO0lBQy9GLDRCQUE0QixFQUFFLGVBQWU7SUFDN0MsMkJBQTJCLEVBQUUsY0FBYztJQUMzQyx5QkFBeUIsRUFBRSxZQUFZO0lBQ3ZDLDhCQUE4QixFQUFFLGlCQUFpQjtJQUNqRCx1Q0FBdUMsRUFBRSwwQkFBMEI7SUFDbkUsb0NBQW9DLEVBQUUsdUJBQXVCO0lBQzdELG1DQUFtQyxFQUFFLHNCQUFzQjtJQUMzRCxtQ0FBbUMsRUFBRSxzQkFBc0I7SUFDM0QscUNBQXFDLEVBQUUsd0JBQXdCO0NBQ2hFLENBQUMsQ0FBQztBQUVILE1BQU0sYUFBYSxHQUFHLHFCQUFxQixDQUFDO0FBRTVDLE1BQU0sT0FBTyxpQ0FBa0MsU0FBUSxLQUFLO0lBQzlCLEtBQUs7SUFBakMsWUFBNEIsS0FBd0I7UUFDbEQsS0FBSyxDQUNILHVCQUF1QixLQUFLLENBQUMsSUFBSSxDQUFDLElBQUksQ0FBQyxJQUFJO2NBQ3pDLEtBQUssQ0FBQyxHQUFHLENBQUMsQ0FBQyxPQUFPLEVBQUUsRUFBRTtnQkFDdEIsTUFBTSxXQUFXLEdBQUcsaUNBQWlDLENBQUMsT0FBTyxDQUFDLENBQUM7Z0JBQy9ELE9BQU8sV0FBVyxDQUFDLENBQUMsQ0FBQyxPQUFPLFdBQVcsZUFBZSxPQUFPLEdBQUcsQ0FBQyxDQUFDLENBQUMsVUFBVSxPQUFPLEdBQUcsQ0FBQztZQUMxRixDQUFDLENBQUMsQ0FBQyxJQUFJLENBQUMsR0FBRyxDQUFDLENBQ2IsQ0FBQztxQkFQd0IsS0FBSztRQVEvQixJQUFJLENBQUMsSUFBSSxHQUFHLG1DQUFtQyxDQUFDO0lBQ2xELENBQUM7Q0FDRjtBQUVEOzs7O0dBSUc7QUFDSCxNQUFNLENBQUMsTUFBTSxvQ0FBb0MsR0FBRyxDQUNsRCxjQUFjLEdBQXNCLE9BQU8sQ0FBQyxHQUFHLEVBQ3pDLEVBQUU7SUFDUixNQUFNLEtBQUssR0FBRyxNQUFNLENBQUMsSUFBSSxDQUFDLGNBQWMsQ0FBQztTQUN0QyxNQUFNLENBQUMsQ0FBQyxPQUFPLEVBQUUsRUFBRSxDQUFDLGNBQWMsQ0FBQyxPQUFPLENBQUMsS0FBSyxTQUFTLENBQUM7U0FDMUQsTUFBTSxDQUFDLENBQUMsT0FBTyxFQUFFLEVBQUUsQ0FBQyxPQUFPLENBQUMsV0FBVyxFQUFFLENBQUMsVUFBVSxDQUFDLGFBQWEsQ0FBQyxDQUFDO1NBQ3BFLE1BQU0sQ0FBQyxDQUFDLE9BQU8sRUFBRSxFQUFFLENBQUMsT0FBTyxLQUFLLHFDQUFxQyxDQUFDO1NBQ3RFLElBQUksRUFBRSxDQUFDO0lBQ1YsSUFBSSxLQUFLLENBQUMsTUFBTSxHQUFHLENBQUM7UUFBRSxNQUFNLElBQUksaUNBQWlDLENBQUMsS0FBSyxDQUFDLENBQUM7QUFDM0UsQ0FBQyxDQUFDIn0=
62
+ //# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiZnVuY3Rpb25zLnJldGlyZWRlbnZpcm9ubWVudC5qcyIsInNvdXJjZVJvb3QiOiIiLCJzb3VyY2VzIjpbIi4uLy4uL3RzL2Z1bmN0aW9ucy5yZXRpcmVkZW52aXJvbm1lbnQudHMiXSwibmFtZXMiOltdLCJtYXBwaW5ncyI6IkFBQUEsT0FBTyxFQUFFLHFDQUFxQyxFQUFFLE1BQU0sbUNBQW1DLENBQUM7QUFFMUY7Ozs7R0FJRztBQUNILE1BQU0sQ0FBQyxNQUFNLGlDQUFpQyxHQUFxQyxNQUFNLENBQUMsTUFBTSxDQUFDO0lBQy9GLDRCQUE0QixFQUFFLGVBQWU7SUFDN0MsMkJBQTJCLEVBQUUsY0FBYztJQUMzQyx5QkFBeUIsRUFBRSxZQUFZO0lBQ3ZDLDhCQUE4QixFQUFFLGlCQUFpQjtJQUNqRCxvQ0FBb0MsRUFBRSx1QkFBdUI7SUFDN0QsbUNBQW1DLEVBQUUsc0JBQXNCO0lBQzNELG1DQUFtQyxFQUFFLHNCQUFzQjtJQUMzRCxxQ0FBcUMsRUFBRSx3QkFBd0I7Q0FDaEUsQ0FBQyxDQUFDO0FBRUgsTUFBTSx3QkFBd0IsR0FBRyxpRkFBaUY7TUFDOUcscUdBQXFHO01BQ3JHLGdIQUFnSDtNQUNoSCx1REFBdUQsQ0FBQztBQUU1RDs7O0dBR0c7QUFDSCxNQUFNLENBQUMsTUFBTSxvQ0FBb0MsR0FBcUMsTUFBTSxDQUFDLE1BQU0sQ0FBQztJQUNsRyx3QkFBd0IsRUFBRSx3QkFBd0I7SUFDbEQsdUNBQXVDLEVBQUUsd0JBQXdCO0NBQ2xFLENBQUMsQ0FBQztBQUVILE1BQU0sYUFBYSxHQUFHLHFCQUFxQixDQUFDO0FBRTVDLE1BQU0sT0FBTyxpQ0FBa0MsU0FBUSxLQUFLO0lBQzlCLEtBQUs7SUFBakMsWUFBNEIsS0FBd0I7UUFDbEQsS0FBSyxDQUNILHVCQUF1QixLQUFLLENBQUMsSUFBSSxDQUFDLElBQUksQ0FBQyxJQUFJO2NBQ3pDLEtBQUssQ0FBQyxHQUFHLENBQUMsQ0FBQyxPQUFPLEVBQUUsRUFBRTtnQkFDdEIsTUFBTSxNQUFNLEdBQUcsb0NBQW9DLENBQUMsT0FBTyxDQUFDLENBQUM7Z0JBQzdELElBQUksTUFBTTtvQkFBRSxPQUFPLEdBQUcsT0FBTyxLQUFLLE1BQU0sRUFBRSxDQUFDO2dCQUMzQyxNQUFNLFdBQVcsR0FBRyxpQ0FBaUMsQ0FBQyxPQUFPLENBQUMsQ0FBQztnQkFDL0QsT0FBTyxXQUFXLENBQUMsQ0FBQyxDQUFDLE9BQU8sV0FBVyxlQUFlLE9BQU8sR0FBRyxDQUFDLENBQUMsQ0FBQyxVQUFVLE9BQU8sR0FBRyxDQUFDO1lBQzFGLENBQUMsQ0FBQyxDQUFDLElBQUksQ0FBQyxHQUFHLENBQUMsQ0FDYixDQUFDO3FCQVR3QixLQUFLO1FBVS9CLElBQUksQ0FBQyxJQUFJLEdBQUcsbUNBQW1DLENBQUM7SUFDbEQsQ0FBQztDQUNGO0FBRUQ7Ozs7O0dBS0c7QUFDSCxNQUFNLENBQUMsTUFBTSxvQ0FBb0MsR0FBRyxDQUNsRCxjQUFjLEdBQXNCLE9BQU8sQ0FBQyxHQUFHLEVBQy9DLFVBQVUsR0FHTixFQUFFLEVBQ0EsRUFBRTtJQUNSLE1BQU0sS0FBSyxHQUFHLE1BQU0sQ0FBQyxJQUFJLENBQUMsY0FBYyxDQUFDO1NBQ3RDLE1BQU0sQ0FBQyxDQUFDLE9BQU8sRUFBRSxFQUFFLENBQUMsY0FBYyxDQUFDLE9BQU8sQ0FBQyxLQUFLLFNBQVMsQ0FBQztTQUMxRCxNQUFNLENBQUMsQ0FBQyxPQUFPLEVBQUUsRUFBRSxDQUFDLENBQUMsQ0FBQyxVQUFVLENBQUMsYUFBYSxJQUFJLE1BQU0sQ0FBQyxNQUFNLENBQUMsb0NBQW9DLEVBQUUsT0FBTyxDQUFDLENBQUMsQ0FBQztTQUNoSCxNQUFNLENBQUMsQ0FBQyxPQUFPLEVBQUUsRUFBRSxDQUFDLE9BQU8sQ0FBQyxXQUFXLEVBQUUsQ0FBQyxVQUFVLENBQUMsYUFBYSxDQUFDO1dBQy9ELE1BQU0sQ0FBQyxNQUFNLENBQUMsb0NBQW9DLEVBQUUsT0FBTyxDQUFDLENBQUM7U0FDakUsTUFBTSxDQUFDLENBQUMsT0FBTyxFQUFFLEVBQUUsQ0FBQyxPQUFPLEtBQUsscUNBQXFDLENBQUM7U0FDdEUsSUFBSSxFQUFFLENBQUM7SUFDVixJQUFJLEtBQUssQ0FBQyxNQUFNLEdBQUcsQ0FBQztRQUFFLE1BQU0sSUFBSSxpQ0FBaUMsQ0FBQyxLQUFLLENBQUMsQ0FBQztBQUMzRSxDQUFDLENBQUMifQ==
@@ -15,6 +15,7 @@ export type { IAdmitControllerManagedSessionInput, IBeginControllerManagedSessio
15
15
  export { buildControllerFlexCleanupCohort } from './classes.sessionidentityservice.js';
16
16
  export * from './classes.cli.js';
17
17
  export * from './classes.config.js';
18
+ export * from './functions.controlleradmission.js';
18
19
  export * from './classes.controller.js';
19
20
  export * from './classes.resourcecoordinator.js';
20
21
  export * from './classes.terminalresourcehost.js';
package/dist_ts/index.js CHANGED
@@ -13,6 +13,7 @@ export * from './classes.managedsessionmodels.js';
13
13
  export { buildControllerFlexCleanupCohort } from './classes.sessionidentityservice.js';
14
14
  export * from './classes.cli.js';
15
15
  export * from './classes.config.js';
16
+ export * from './functions.controlleradmission.js';
16
17
  export * from './classes.controller.js';
17
18
  export * from './classes.resourcecoordinator.js';
18
19
  export * from './classes.terminalresourcehost.js';
@@ -27,4 +28,4 @@ export * from './classes.processinspection.js';
27
28
  export * from './classes.upgradecoordinator.js';
28
29
  export * from './classes.upgradetransaction.js';
29
30
  export * from './classes.validation.js';
30
- //# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiaW5kZXguanMiLCJzb3VyY2VSb290IjoiIiwic291cmNlcyI6WyIuLi8uLi90cy9pbmRleC50cyJdLCJuYW1lcyI6W10sIm1hcHBpbmdzIjoiQUFBQSxjQUFjLDJCQUEyQixDQUFDO0FBRTFDLGNBQWMseUJBQXlCLENBQUM7QUFDeEMsY0FBYyxzQkFBc0IsQ0FBQztBQUNyQyxjQUFjLHdCQUF3QixDQUFDO0FBQ3ZDLGNBQWMsMkJBQTJCLENBQUM7QUFNMUMsY0FBYyxzQkFBc0IsQ0FBQztBQUNyQyxPQUFPLEVBQ0wsdUJBQXVCLEVBQ3ZCLGdCQUFnQixHQVVqQixNQUFNLDBCQUEwQixDQUFDO0FBQ2xDLGNBQWMsMEJBQTBCLENBQUM7QUFDekMsY0FBYyw4QkFBOEIsQ0FBQztBQUU3QyxjQUFjLHlCQUF5QixDQUFDO0FBQ3hDLGNBQWMsd0JBQXdCLENBQUM7QUFDdkMsY0FBYyxtQ0FBbUMsQ0FBQztBQTZCbEQsT0FBTyxFQUFFLGdDQUFnQyxFQUFFLE1BQU0scUNBQXFDLENBQUM7QUFDdkYsY0FBYyxrQkFBa0IsQ0FBQztBQUNqQyxjQUFjLHFCQUFxQixDQUFDO0FBQ3BDLGNBQWMseUJBQXlCLENBQUM7QUFDeEMsY0FBYyxrQ0FBa0MsQ0FBQztBQUNqRCxjQUFjLG1DQUFtQyxDQUFDO0FBQ2xELGNBQWMsa0NBQWtDLENBQUM7QUFDakQsY0FBYyxtQ0FBbUMsQ0FBQztBQUNsRCxjQUFjLGdDQUFnQyxDQUFDO0FBQy9DLGNBQWMsMkJBQTJCLENBQUM7QUFDMUMsY0FBYyw2QkFBNkIsQ0FBQztBQUM1QyxjQUFjLGlDQUFpQyxDQUFDO0FBQ2hELGNBQWMsNkJBQTZCLENBQUM7QUFDNUMsY0FBYyxnQ0FBZ0MsQ0FBQztBQUMvQyxjQUFjLGlDQUFpQyxDQUFDO0FBQ2hELGNBQWMsaUNBQWlDLENBQUM7QUFDaEQsY0FBYyx5QkFBeUIsQ0FBQyJ9
31
+ //# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiaW5kZXguanMiLCJzb3VyY2VSb290IjoiIiwic291cmNlcyI6WyIuLi8uLi90cy9pbmRleC50cyJdLCJuYW1lcyI6W10sIm1hcHBpbmdzIjoiQUFBQSxjQUFjLDJCQUEyQixDQUFDO0FBRTFDLGNBQWMseUJBQXlCLENBQUM7QUFDeEMsY0FBYyxzQkFBc0IsQ0FBQztBQUNyQyxjQUFjLHdCQUF3QixDQUFDO0FBQ3ZDLGNBQWMsMkJBQTJCLENBQUM7QUFNMUMsY0FBYyxzQkFBc0IsQ0FBQztBQUNyQyxPQUFPLEVBQ0wsdUJBQXVCLEVBQ3ZCLGdCQUFnQixHQVVqQixNQUFNLDBCQUEwQixDQUFDO0FBQ2xDLGNBQWMsMEJBQTBCLENBQUM7QUFDekMsY0FBYyw4QkFBOEIsQ0FBQztBQUU3QyxjQUFjLHlCQUF5QixDQUFDO0FBQ3hDLGNBQWMsd0JBQXdCLENBQUM7QUFDdkMsY0FBYyxtQ0FBbUMsQ0FBQztBQTZCbEQsT0FBTyxFQUFFLGdDQUFnQyxFQUFFLE1BQU0scUNBQXFDLENBQUM7QUFDdkYsY0FBYyxrQkFBa0IsQ0FBQztBQUNqQyxjQUFjLHFCQUFxQixDQUFDO0FBQ3BDLGNBQWMsb0NBQW9DLENBQUM7QUFDbkQsY0FBYyx5QkFBeUIsQ0FBQztBQUN4QyxjQUFjLGtDQUFrQyxDQUFDO0FBQ2pELGNBQWMsbUNBQW1DLENBQUM7QUFDbEQsY0FBYyxrQ0FBa0MsQ0FBQztBQUNqRCxjQUFjLG1DQUFtQyxDQUFDO0FBQ2xELGNBQWMsZ0NBQWdDLENBQUM7QUFDL0MsY0FBYywyQkFBMkIsQ0FBQztBQUMxQyxjQUFjLDZCQUE2QixDQUFDO0FBQzVDLGNBQWMsaUNBQWlDLENBQUM7QUFDaEQsY0FBYyw2QkFBNkIsQ0FBQztBQUM1QyxjQUFjLGdDQUFnQyxDQUFDO0FBQy9DLGNBQWMsaUNBQWlDLENBQUM7QUFDaEQsY0FBYyxpQ0FBaUMsQ0FBQztBQUNoRCxjQUFjLHlCQUF5QixDQUFDIn0=
@@ -11,7 +11,7 @@ export type TWebAuthnCeremonyState = 'pending' | 'consumed';
11
11
  * automatically storable with its type-specific checks — the two can no longer
12
12
  * drift apart. Other well-formed types are a later release's and still read.
13
13
  */
14
- export declare const controllerAuditEventTypes: readonly ['controller.started', 'controller.stopped', 'setup.finish', 'authentication.finish', 'authentication.logout', 'temppassword.create', 'temppassword.login', 'auth.resume', 'auth.handoff', 'auth.signout', 'session.list', 'conversation.list', 'conversation.search', 'conversation.open', 'conversation.archive', 'conversation.reopen', 'session.read', 'session.auxiliary.read', 'session.model.update', 'session.mode.update', 'session.scratchpad.save', 'session.intelligence.ask', 'session.messages.page', 'session.message.read', 'session.create', 'session.delete', 'session.discard-empty', 'session.send', 'session.message', 'session.abort', 'session.harness.restart', 'opencode.restart', 'controller.restart', 'session.compaction.update', 'session.limitresume.update', 'session.promptqueue.release', 'session.heldprompt.release', 'session.pendingprompt.edit', 'session.pendingprompt.retract', 'session.rename', 'session.archive', 'session.yolo', 'session.builtin', 'slash.list', 'slash.execute', 'permission.reply', 'question.reply', 'project.list', 'project.create', 'project.remove', 'project.removal.retry', 'project.agentmessages.update', 'model.list', 'provider.list', 'provider.connection.list', 'provider.login.begin', 'authswitch.request', 'accounts.rename', 'accounts.maxusage', 'accounts.reserve.lift', 'accounts.apikey.add', 'accounts.spendlimit', 'accounts.remove', 'accounts.add', 'accounts.reauth', 'accounts.operation.cancel', 'accounts.preuse.start', 'accounts.preuse.cancel', 'accounts.claude.signin.start', 'accounts.claude.signin.cancel', 'accounts.claude.adopt', 'accounts.claude.release', 'accounts.claude.repair', 'accounts.codex.adopt', 'accounts.codex.release', 'provider.login.read', 'provider.login.cancel', 'provider.connection.logout', 'provider.connection.activate-opencode', 'provider.connection.ratelimits.read', 'provider.model.refresh.begin', 'provider.model.refresh.read', 'command.list', 'session.command', 'settings.read', 'settings.update', 'sessiongroups.read', 'sessiongroups.update', 'terminal.list', 'terminal.create', 'terminal.rename', 'terminal.remove', 'terminal.attach', 'resource.list', 'resource.create', 'resource.rename', 'resource.attach', 'resource.detach', 'resource.start', 'resource.stop', 'resource.retire', 'resource.workspace.base', 'resource.workspace.write', 'resource.workspace.mkdir', 'resource.workspace.remove', 'resource.workspace.rename', 'resource.workspace.copy', 'resource.workspace.reveal', 'configuration.target.bind', 'configuration.owner.issue', 'configuration.owner.revoke', 'configuration.state', 'configuration.master.get', 'configuration.master.save', 'configuration.project', 'configuration.review', 'configuration.apply', 'configuration.restore.review', 'configuration.restore', 'configuration.operation.retry', 'configuration.operation.recover', 'configuration.operation.abandon', 'resource.browser.operation', 'resource.browser.view.open', 'resource.browser.view.close', 'resource.browser.view.operate', 'resource.browser.paint.rearm'];
14
+ export declare const controllerAuditEventTypes: readonly ['controller.started', 'controller.stopped', 'setup.finish', 'authentication.finish', 'authentication.logout', 'temppassword.create', 'temppassword.login', 'auth.resume', 'auth.handoff', 'auth.signout', 'session.list', 'conversation.list', 'conversation.search', 'conversation.open', 'conversation.archive', 'conversation.reopen', 'session.read', 'session.auxiliary.read', 'session.model.update', 'session.mode.update', 'session.scratchpad.save', 'session.intelligence.ask', 'session.messages.page', 'session.message.read', 'session.create', 'session.delete', 'session.discard-empty', 'session.send', 'session.message', 'session.abort', 'session.harness.restart', 'opencode.restart', 'controller.restart', 'session.compaction.update', 'session.limitresume.update', 'session.promptqueue.release', 'session.heldprompt.release', 'session.pendingprompt.edit', 'session.pendingprompt.retract', 'session.rename', 'session.archive', 'session.yolo', 'session.builtin', 'slash.list', 'slash.execute', 'permission.reply', 'question.reply', 'project.list', 'project.create', 'project.remove', 'project.removal.retry', 'project.agentmessages.update', 'model.list', 'provider.list', 'provider.connection.list', 'provider.login.begin', 'authswitch.request', 'accounts.rename', 'accounts.maxusage', 'accounts.reserve.lift', 'accounts.apikey.add', 'accounts.spendlimit', 'accounts.remove', 'accounts.add', 'accounts.reauth', 'accounts.operation.cancel', 'accounts.preuse.start', 'accounts.preuse.cancel', 'accounts.claude.signin.start', 'accounts.claude.signin.cancel', 'accounts.claude.adopt', 'accounts.claude.release', 'accounts.claude.repair', 'accounts.codex.adopt', 'accounts.codex.release', 'provider.login.read', 'provider.login.cancel', 'provider.connection.logout', 'provider.connection.activate-opencode', 'provider.connection.ratelimits.read', 'provider.model.refresh.begin', 'provider.model.refresh.read', 'command.list', 'session.command', 'settings.read', 'settings.update', 'sessiongroups.read', 'sessiongroups.update', 'terminal.list', 'terminal.create', 'terminal.rename', 'terminal.remove', 'terminal.attach', 'resource.list', 'resource.create', 'resource.rename', 'resource.attach', 'resource.detach', 'resource.start', 'resource.stop', 'resource.retire', 'resource.workspace.base', 'resource.workspace.write', 'resource.workspace.mkdir', 'resource.workspace.remove', 'resource.workspace.rename', 'resource.workspace.copy', 'resource.workspace.reveal', 'configuration.target.bind', 'configuration.owner.issue', 'configuration.owner.revoke', 'configuration.state', 'configuration.master.get', 'configuration.master.save', 'configuration.project', 'configuration.review', 'configuration.apply', 'configuration.restore.review', 'configuration.restore', 'configuration.operation.retry', 'configuration.operation.recover', 'configuration.operation.abandon', 'resource.browser.operation', 'resource.browser.view.open', 'resource.browser.view.close', 'resource.browser.view.operate', 'resource.browser.paint.rearm', 'remote.set', 'remote.unset', 'remote.secret.import', 'device.pairing.begin', 'device.pair', 'device.auth', 'device.revoke'];
15
15
  export type TControllerAuditEventType = (typeof controllerAuditEventTypes)[number];
16
16
  export type TControllerAuditOutcome = 'attempted' | 'succeeded' | 'denied' | 'failed';
17
17
  export type TAuthErrorCode = 'not_initialized' | 'config_mismatch' | 'setup_unavailable' | 'setup_invalid' | 'setup_expired' | 'rate_limited' | 'ceremony_limit' | 'ceremony_invalid' | 'ceremony_replayed' | 'ceremony_expired' | 'origin_mismatch' | 'peer_mismatch' | 'verification_failed' | 'credential_not_found' | 'concurrent_change' | 'ambiguous_write' | 'counter_conflict' | 'invalid_project' | 'invalid_resource' | 'invalid_settings' | 'temp_password_invalid' | 'temp_password_limit';
@@ -80,6 +80,30 @@ export interface ISetupAuthority {
80
80
  * BrowserRuntime qualifies it.
81
81
  */
82
82
  export type TControllerAuditSessionId = IControllerRuntimeId | plugins.browserRuntime.IBrowserClaudeSessionId;
83
+ /** One end of an offline `agl remote set|unset` move, as its audit events record it; never a secret. */
84
+ export interface IControllerAuditRemoteEndpoint {
85
+ publicOrigin: string;
86
+ rpId: string;
87
+ }
88
+ /** The public origin and RP ID a `remote.set` or `remote.unset` moves from and to. */
89
+ export interface IControllerAuditRemoteMove {
90
+ previous: IControllerAuditRemoteEndpoint;
91
+ target: IControllerAuditRemoteEndpoint;
92
+ }
93
+ /**
94
+ * What an audit event records beyond its envelope (bounded plain JSON). This release records `remoteMove` on
95
+ * `remote.set` and `remote.unset`; any other key is a later release's, kept and pruned as it wrote it.
96
+ */
97
+ export interface IControllerAuditEventDetails {
98
+ /** `remote.set` and `remote.unset` only: where the move goes from and to. */
99
+ remoteMove?: IControllerAuditRemoteMove;
100
+ [key: string]: unknown;
101
+ }
102
+ /** What this release records in an audit event's `details`. */
103
+ export interface IRecordAuditEventDetails {
104
+ /** `remote.set` and `remote.unset` only: where the move goes from and to. */
105
+ remoteMove: IControllerAuditRemoteMove;
106
+ }
83
107
  /**
84
108
  * A stored audit event. The audit log is shared with later releases, so a stored `type` is any audit type, also one
85
109
  * this release does not know (a later release's, read back after a rollback). This release writes only its own types
@@ -100,10 +124,10 @@ export interface IControllerAuditEvent {
100
124
  senderLabel?: string;
101
125
  localCli?: IConfigurationLocalCliActor;
102
126
  /**
103
- * What a later release's type records beyond the envelope (bounded plain JSON). This release never writes or
104
- * interprets it; it is declared so a rolled-back controller still reads and prunes such events.
127
+ * What the event records beyond the envelope (bounded plain JSON): this release's `remoteMove`, or what a later
128
+ * release's type adds, read back after a rollback.
105
129
  */
106
- details?: Record<string, unknown>;
130
+ details?: IControllerAuditEventDetails;
107
131
  }
108
132
  export interface IControllerTempPasswordDocument {
109
133
  id: string;
@@ -131,6 +155,7 @@ export interface IRecordAuditEventInput {
131
155
  /** The sender label an agent message declared (`session.message`). */
132
156
  senderLabel?: string;
133
157
  localCli?: IConfigurationLocalCliActor;
158
+ details?: IRecordAuditEventDetails;
134
159
  }
135
160
  export interface IConsumeCeremonyOptions {
136
161
  ceremonyId: string;