agl 43.1.0 → 43.2.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/changelog.md +12 -0
- package/dist_serve/bundle.js +5329 -5116
- 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_ts/00_commitinfo_data.js +1 -1
- package/dist_ts/aglapi/aglapisurface.document.js +325 -1
- package/dist_ts/aglapi/interfaces.d.ts +3 -0
- package/dist_ts/aglapi/interfaces.js +2 -1
- package/dist_ts/classes.authmodels.js +17 -4
- package/dist_ts/classes.authstore.js +16 -2
- package/dist_ts/classes.cli.d.ts +4 -2
- package/dist_ts/classes.cli.js +6 -3
- package/dist_ts/classes.controller.d.ts +10 -0
- package/dist_ts/classes.controller.js +119 -4
- 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.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.mcpclient.d.ts +4 -1
- package/dist_ts/classes.mcpclient.js +19 -1
- package/dist_ts/classes.mcpcontrollerhost.d.ts +3 -1
- package/dist_ts/classes.mcpcontrollerhost.js +9 -1
- package/dist_ts/classes.mcptools.d.ts +3 -3
- package/dist_ts/classes.mcptools.js +26 -1
- package/dist_ts/classes.mcpvalidation.js +7 -1
- package/dist_ts/classes.proxycontrol.d.ts +11 -0
- package/dist_ts/classes.proxycontrol.js +7 -1
- package/dist_ts/classes.proxycontrolclient.d.ts +17 -0
- package/dist_ts/classes.proxycontrolclient.js +35 -1
- package/dist_ts/classes.proxydaemon.js +8 -1
- package/dist_ts/classes.proxymonitor.d.ts +7 -0
- package/dist_ts/classes.proxymonitor.js +13 -1
- package/dist_ts/classes.trustedproxysecrets.d.ts +2 -0
- package/dist_ts/classes.trustedproxysecrets.js +5 -1
- package/dist_ts/functions.controllermanagementsurface.d.ts +4 -0
- package/dist_ts/functions.controllermanagementsurface.js +15 -1
- 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.js +30 -1
- package/dist_ts/functions.inferencecliarguments.d.ts +8 -2
- package/dist_ts/functions.inferencecliarguments.js +31 -3
- 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.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 +7 -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/gateway.d.ts +151 -0
- package/dist_ts_interfaces/gateway.js +66 -0
- package/dist_ts_interfaces/index.d.ts +2 -0
- package/dist_ts_interfaces/index.js +3 -1
- package/dist_ts_interfaces/management.d.ts +4 -4
- package/dist_ts_interfaces/management.js +3 -2
- package/dist_ts_interfaces/mcprequests.d.ts +14 -2
- package/dist_ts_interfaces/mcprequests.js +2 -1
- package/dist_ts_interfaces/proxycapacity.d.ts +99 -0
- package/dist_ts_interfaces/proxycapacity.js +74 -0
- package/package.json +4 -3
- package/readme.md +79 -5
- package/ts/00_commitinfo_data.ts +1 -1
- package/ts/aglapi/aglapisurface.document.ts +324 -0
- package/ts/aglapi/interfaces.ts +1 -0
- package/ts/classes.authmodels.ts +22 -3
- package/ts/classes.authstore.ts +15 -1
- package/ts/classes.cli.ts +7 -3
- package/ts/classes.controller.ts +134 -3
- package/ts/classes.controllermanagement.ts +40 -7
- package/ts/classes.gatewayclient.ts +401 -0
- package/ts/classes.gatewayclientstore.ts +272 -0
- package/ts/classes.inferencerouter.ts +12 -0
- package/ts/classes.inferenceservice.ts +27 -0
- package/ts/classes.mcpclient.ts +18 -0
- package/ts/classes.mcpcontrollerhost.ts +13 -0
- package/ts/classes.mcptools.ts +30 -2
- package/ts/classes.mcpvalidation.ts +5 -0
- package/ts/classes.proxycontrol.ts +16 -0
- package/ts/classes.proxycontrolclient.ts +30 -0
- package/ts/classes.proxydaemon.ts +8 -0
- package/ts/classes.proxymonitor.ts +12 -0
- package/ts/classes.trustedproxysecrets.ts +5 -0
- package/ts/functions.controllermanagementsurface.ts +15 -0
- package/ts/functions.gatewaycli.ts +436 -0
- package/ts/functions.gatewayroute.ts +429 -0
- package/ts/functions.inferencecli.ts +24 -0
- package/ts/functions.inferencecliarguments.ts +30 -4
- package/ts/functions.proxycapacity.ts +191 -0
- package/ts/functions.proxycapacitycli.ts +104 -0
- package/ts/functions.remotecli.ts +56 -20
- package/ts/interfaces.auth.ts +28 -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/gateway.ts +242 -0
- package/ts_interfaces/index.ts +2 -0
- package/ts_interfaces/management.ts +6 -4
- package/ts_interfaces/mcprequests.ts +18 -0
- package/ts_interfaces/proxycapacity.ts +162 -0
- package/ts_web/00_commitinfo_data.ts +1 -1
- package/ts_web/classes.browserpresentation.ts +13 -5
- 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.flexlimitstrip.ts +21 -70
- package/ts_web/elements.harnesscontrollerapp.ts +91 -185
|
@@ -8,6 +8,7 @@ export const inferenceCliHelp = `Usage:
|
|
|
8
8
|
agl proxy service install [--port ${aglProxyDefaultPort}] | enable | start | stop | status
|
|
9
9
|
agl proxy serve [--port ${aglProxyDefaultPort}]
|
|
10
10
|
agl proxy status [--json]
|
|
11
|
+
agl proxy capacity [--provider anthropic|openai] [--min-headroom 15] [--json] [--wait [--max-seconds <seconds>]]
|
|
11
12
|
agl proxy credential <client> [--provider openai|anthropic] [--delivery file|none] [--write <path>] [--rotate] | --version
|
|
12
13
|
agl proxy run codex|claude|opencode [--provider openai|anthropic] [--account <id>] [--plan <name>] [--model <id>] -- [harness arguments]
|
|
13
14
|
agl proxy confined run [--provider anthropic|openai] -- docker run [docker options] <image> [command]
|
|
@@ -41,6 +42,14 @@ on 127.0.0.1:${aglProxyRelayDefaultPort} inside the container, which therefore k
|
|
|
41
42
|
and --network container:… are refused. It passes AGL_PROXY_SOCKET and MODELPROFILE_PROXY_TOKEN, and no model.
|
|
42
43
|
confined end ends a run's credential at once, and its launcher stops the container; agl proxy status lists the runs
|
|
43
44
|
with their harnesses and pools.
|
|
45
|
+
capacity answers each pool's room for new work: the headroom its members add now, summed. Its members are its
|
|
46
|
+
subscription sign-ins that have not lapsed and whose reading states a counted plan (Claude accounts: max; ChatGPT
|
|
47
|
+
accounts: every plan but free); one that takes no work now adds nothing. A pool is open when its room reaches
|
|
48
|
+
--min-headroom (15 unless given) and no provider 429 hit a member within five minutes (a proxy watches for five minutes
|
|
49
|
+
after its start before it says so); otherwise it waits until the first moment the members' readings foresee enough room.
|
|
50
|
+
Each member names its binding window and when its headroom next grows. Exit status: 0 when every pool reported is open,
|
|
51
|
+
2 when one waits, 1 on a failure. --wait (with --provider) asks again until the pool is open, at most --max-seconds when
|
|
52
|
+
given, and exits 2 when that time ran out.
|
|
44
53
|
Repeat --account or --plan to restrict automatic routing. Only accounts the account service holds are eligible.
|
|
45
54
|
ChatGPT pools: /openai/v1/responses, /anthropic/v1/messages (translated), and each prefix's /models.
|
|
46
55
|
Claude pools: /anthropic/v1/messages, /anthropic/v1/messages/count_tokens and /anthropic/v1/models, sent on as Claude Code sent them.
|
|
@@ -54,17 +63,18 @@ const commandOptions = {
|
|
|
54
63
|
run: ['--provider', '--account', '--plan', '--model'],
|
|
55
64
|
credential: ['--provider', '--delivery', '--write', '--rotate'],
|
|
56
65
|
status: ['--json'],
|
|
66
|
+
capacity: ['--provider', '--min-headroom', '--json', '--wait', '--max-seconds'],
|
|
57
67
|
service: ['--port'],
|
|
58
68
|
confined: [],
|
|
59
69
|
};
|
|
60
|
-
const flags = new Set(['--rotate', '--json']);
|
|
70
|
+
const flags = new Set(['--rotate', '--json', '--wait']);
|
|
61
71
|
export const parseInferenceCliArguments = (argvArg) => {
|
|
62
72
|
const argv = [...argvArg];
|
|
63
73
|
const command = argv.shift();
|
|
64
74
|
if (!command || !Object.hasOwn(commandOptions, command))
|
|
65
75
|
throw new Error(inferenceCliHelp);
|
|
66
76
|
const result = { command, port: aglProxyDefaultPort, policy: {}, rotate: false, version: false, json: false,
|
|
67
|
-
args: [] };
|
|
77
|
+
wait: false, args: [] };
|
|
68
78
|
if (command === 'run') {
|
|
69
79
|
const harness = argv.shift();
|
|
70
80
|
if (!['codex', 'claude', 'opencode'].includes(harness ?? ''))
|
|
@@ -140,6 +150,8 @@ export const parseInferenceCliArguments = (argvArg) => {
|
|
|
140
150
|
if (flags.has(name)) {
|
|
141
151
|
if (name === '--rotate')
|
|
142
152
|
result.rotate = true;
|
|
153
|
+
else if (name === '--wait')
|
|
154
|
+
result.wait = true;
|
|
143
155
|
else
|
|
144
156
|
result.json = true;
|
|
145
157
|
continue;
|
|
@@ -172,6 +184,16 @@ export const parseInferenceCliArguments = (argvArg) => {
|
|
|
172
184
|
throw new Error('--delivery is file or none.');
|
|
173
185
|
result.delivery = value;
|
|
174
186
|
}
|
|
187
|
+
else if (name === '--min-headroom') {
|
|
188
|
+
if (!/^\d+$/.test(value) || !Number.isSafeInteger(Number(value)))
|
|
189
|
+
throw new Error('--min-headroom is a whole percent, 0 or more.');
|
|
190
|
+
result.minHeadroom = Number(value);
|
|
191
|
+
}
|
|
192
|
+
else if (name === '--max-seconds') {
|
|
193
|
+
if (!/^[1-9]\d*$/.test(value) || !Number.isSafeInteger(Number(value)))
|
|
194
|
+
throw new Error('--max-seconds is a whole number of seconds, 1 or more.');
|
|
195
|
+
result.maxSeconds = Number(value);
|
|
196
|
+
}
|
|
175
197
|
else if (name === '--write') {
|
|
176
198
|
if (!path.isAbsolute(value))
|
|
177
199
|
throw new Error('--write needs an absolute path.');
|
|
@@ -183,6 +205,12 @@ export const parseInferenceCliArguments = (argvArg) => {
|
|
|
183
205
|
result.modelId = value;
|
|
184
206
|
}
|
|
185
207
|
}
|
|
208
|
+
if (command === 'capacity') {
|
|
209
|
+
if (result.wait && result.provider === undefined)
|
|
210
|
+
throw new Error('--wait waits for one pool: name it with --provider.');
|
|
211
|
+
if (result.maxSeconds !== undefined && !result.wait)
|
|
212
|
+
throw new Error('--max-seconds bounds --wait, which it needs.');
|
|
213
|
+
}
|
|
186
214
|
if (accounts.length > 64 || plans.length > 32)
|
|
187
215
|
throw new Error('The proxy policy exceeds its account or plan limit.');
|
|
188
216
|
if (accounts.length)
|
|
@@ -197,4 +225,4 @@ export const parseInferenceCliArguments = (argvArg) => {
|
|
|
197
225
|
}
|
|
198
226
|
return result;
|
|
199
227
|
};
|
|
200
|
-
//# sourceMappingURL=data:application/json;base64,
|
|
228
|
+
//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiZnVuY3Rpb25zLmluZmVyZW5jZWNsaWFyZ3VtZW50cy5qcyIsInNvdXJjZVJvb3QiOiIiLCJzb3VyY2VzIjpbIi4uLy4uL3RzL2Z1bmN0aW9ucy5pbmZlcmVuY2VjbGlhcmd1bWVudHMudHMiXSwibmFtZXMiOltdLCJtYXBwaW5ncyI6IkFBQUEsT0FBTyxLQUFLLElBQUksTUFBTSxXQUFXLENBQUM7QUFHbEMsT0FBTyxFQUNMLHlCQUF5QixFQUN6QiwwQkFBMEIsRUFDMUIsbUJBQW1CLEVBQ25CLHdCQUF3QixFQUN4QixpQkFBaUIsRUFDakIsdUJBQXVCLEVBQ3ZCLGdCQUFnQixFQUNoQiwwQkFBMEIsRUFDMUIsb0JBQW9CLEVBQ3BCLGtCQUFrQixFQUNsQixzQkFBc0IsRUFDdEIseUJBQXlCLEdBRzFCLE1BQU0sOEJBQThCLENBQUM7QUFFdEM7OztHQUdHO0FBRUgsTUFBTSxDQUFDLE1BQU0sZ0JBQWdCLEdBQUc7c0NBQ00sbUJBQW1COzRCQUM3QixtQkFBbUI7Ozs7Ozs7V0FPcEMsdUJBQXVCLElBQUksaUJBQWlCOzs7d0JBRy9CLGdCQUFnQjs7Ozs7Ozs7Ozs7c0VBVzhCLDBCQUEwQjs7Ozs7Ozs7OzZGQVNILHVCQUF1QjtvQ0FDaEYsdUJBQXVCLElBQUksaUJBQWlCO2VBQ2pFLHdCQUF3Qjs7Ozs7Ozs7Ozs7Ozs7Ozs7OztDQW1CdEMsQ0FBQztBQW1DRixNQUFNLGNBQWMsR0FBaUQ7SUFDbkUsS0FBSyxFQUFFLENBQUMsUUFBUSxDQUFDO0lBQ2pCLEdBQUcsRUFBRSxDQUFDLFlBQVksRUFBRSxXQUFXLEVBQUUsUUFBUSxFQUFFLFNBQVMsQ0FBQztJQUNyRCxVQUFVLEVBQUUsQ0FBQyxZQUFZLEVBQUUsWUFBWSxFQUFFLFNBQVMsRUFBRSxVQUFVLENBQUM7SUFDL0QsTUFBTSxFQUFFLENBQUMsUUFBUSxDQUFDO0lBQ2xCLFFBQVEsRUFBRSxDQUFDLFlBQVksRUFBRSxnQkFBZ0IsRUFBRSxRQUFRLEVBQUUsUUFBUSxFQUFFLGVBQWUsQ0FBQztJQUMvRSxPQUFP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
|
|
@@ -0,0 +1,50 @@
|
|
|
1
|
+
import * as plugins from './plugins.js';
|
|
2
|
+
import type { IInferenceAccountStatus } from './classes.inferencerouter.js';
|
|
3
|
+
import { type IProxyCapacityPool, type TProxyCapacityProvider } from '../dist_ts_interfaces/proxycapacity.js';
|
|
4
|
+
/**
|
|
5
|
+
* Which plans a pool counts, by the plan name its member's held reading states: `only` the plans listed, or every plan
|
|
6
|
+
* `except` them. A Claude account counts on Max alone (Anthropic's `organization_type` `claude_max`, both Max tiers;
|
|
7
|
+
* Claude Code reads the tier apart, from `rate_limit_tier`), a ChatGPT account on every plan but Free.
|
|
8
|
+
*/
|
|
9
|
+
export interface IProxyCapacityPlanRule {
|
|
10
|
+
counts: 'only' | 'except';
|
|
11
|
+
plans: readonly string[];
|
|
12
|
+
}
|
|
13
|
+
export declare const proxyCapacityPlans: Readonly<Record<TProxyCapacityProvider, IProxyCapacityPlanRule>>;
|
|
14
|
+
/** Whether a pool counts an account of the plan `planArg` names. */
|
|
15
|
+
export declare const proxyCapacityPlanCounts: (providerArg: TProxyCapacityProvider, planArg: string) => boolean;
|
|
16
|
+
/** The plan a held reading of the pool's kind states, whatever its age; `null` without one. */
|
|
17
|
+
export declare const proxyCapacityHeldPlan: (providerArg: TProxyCapacityProvider, usageArg: plugins.authswitchAuthority.IAuthSwitchUsageSnapshot | undefined) => string | null;
|
|
18
|
+
/** One account of the proxy as the capacity judges it. */
|
|
19
|
+
export interface IProxyCapacityAccount {
|
|
20
|
+
/** As `InferenceRouter.accountStatus` judged it. */
|
|
21
|
+
status: IInferenceAccountStatus;
|
|
22
|
+
/** The usage reading the status judged it on, or `undefined` while none is held. */
|
|
23
|
+
usage: plugins.authswitchAuthority.IAuthSwitchUsageSnapshot | undefined;
|
|
24
|
+
/** The newest provider 429 on it the proxy saw (epoch milliseconds), or `null`; and until when it rests after one (0: it does not). */
|
|
25
|
+
quota: {
|
|
26
|
+
lastAt: number | null;
|
|
27
|
+
restUntil: number;
|
|
28
|
+
};
|
|
29
|
+
}
|
|
30
|
+
export interface IProxyCapacityOptions {
|
|
31
|
+
/** The room the pool needs: a non-negative integer, in headroom percent summed over its members. */
|
|
32
|
+
minHeadroom: number;
|
|
33
|
+
/** Since when the proxy observes provider 429s (epoch milliseconds): its start. */
|
|
34
|
+
observedSince: number;
|
|
35
|
+
/** Epoch milliseconds. */
|
|
36
|
+
now: number;
|
|
37
|
+
}
|
|
38
|
+
/**
|
|
39
|
+
* A pool's room for new work (AGL-1097). Its members are the pool's subscription sign-ins that have not lapsed and whose
|
|
40
|
+
* held reading states a plan the pool counts (`proxyCapacityPlans`), stale or not; API keys never count. The room is
|
|
41
|
+
* the headroom its members add now (see `projectMember`), summed.
|
|
42
|
+
*
|
|
43
|
+
* The pool is open when the room reaches `minHeadroom` and it is quiet: no provider 429 on a member within
|
|
44
|
+
* `proxyCapacityQuietMs`, which the proxy can say only once it has observed that long. Otherwise it waits until the
|
|
45
|
+
* first moment the members' readings foresee the room at the minimum once it is quiet (`room`), or until it is quiet when
|
|
46
|
+
* the room is there by then (`provider-429`, or `quiet-unobserved` while the proxy has not observed long enough); with
|
|
47
|
+
* no such moment foreseen, without an end (`until` and `seconds` `null`). Each projected moment is the earliest the room
|
|
48
|
+
* can be there, as no reading foresees the usage spent meanwhile.
|
|
49
|
+
*/
|
|
50
|
+
export declare const proxyPoolCapacity: (providerArg: TProxyCapacityProvider, accountsArg: readonly IProxyCapacityAccount[], optionsArg: IProxyCapacityOptions) => IProxyCapacityPool;
|
|
@@ -0,0 +1,142 @@
|
|
|
1
|
+
import * as plugins from './plugins.js';
|
|
2
|
+
import { proxyCapacityQuietMs, } from '../dist_ts_interfaces/proxycapacity.js';
|
|
3
|
+
export const proxyCapacityPlans = {
|
|
4
|
+
anthropic: { counts: 'only', plans: ['max'] },
|
|
5
|
+
openai: { counts: 'except', plans: ['free'] },
|
|
6
|
+
};
|
|
7
|
+
/** Whether a pool counts an account of the plan `planArg` names. */
|
|
8
|
+
export const proxyCapacityPlanCounts = (providerArg, planArg) => {
|
|
9
|
+
const rule = proxyCapacityPlans[providerArg];
|
|
10
|
+
return rule.plans.includes(planArg) === (rule.counts === 'only');
|
|
11
|
+
};
|
|
12
|
+
/** The plan a held reading of the pool's kind states, whatever its age; `null` without one. */
|
|
13
|
+
export const proxyCapacityHeldPlan = (providerArg, usageArg) => {
|
|
14
|
+
const reading = usageArg?.reading;
|
|
15
|
+
if (providerArg === 'anthropic')
|
|
16
|
+
return reading?.kind === 'anthropic' ? reading.status.plan?.name || null : null;
|
|
17
|
+
return reading?.kind === 'openai' ? reading.rateLimits.plan || null : null;
|
|
18
|
+
};
|
|
19
|
+
/** What a projection adds to the room at `atArg`, no earlier than now. */
|
|
20
|
+
const headroomAt = (projectionArg, atArg) => {
|
|
21
|
+
let headroom = projectionArg.now;
|
|
22
|
+
for (const step of projectionArg.steps) {
|
|
23
|
+
if (step.at > atArg)
|
|
24
|
+
break;
|
|
25
|
+
headroom = step.headroom;
|
|
26
|
+
}
|
|
27
|
+
return headroom;
|
|
28
|
+
};
|
|
29
|
+
const iso = (atArg) => new Date(atArg).toISOString();
|
|
30
|
+
const capacityWindow = (windowArg) => ({
|
|
31
|
+
name: plugins.authswitchUsageWindows.authSwitchUsageWindowName(windowArg).slice(0, 128),
|
|
32
|
+
durationSeconds: windowArg.durationSeconds,
|
|
33
|
+
usedPercent: plugins.authswitchUsageWindows.authSwitchUsageWindowPercent(windowArg),
|
|
34
|
+
estimated: windowArg.estimatedUsedPercent !== null,
|
|
35
|
+
resetAt: windowArg.resetAt,
|
|
36
|
+
});
|
|
37
|
+
/**
|
|
38
|
+
* One member's projection. An account that takes work adds its headroom (`authSwitchHeadroomGrowth`) and grows as its
|
|
39
|
+
* windows reset. One that does not adds 0 until it takes work again -- a provider 429's rest ends (`cooling`), or the
|
|
40
|
+
* windows and provider refusal its limit is held by lift (`reserved`, `exhausted`: the limit's reset, never before the
|
|
41
|
+
* rest of a 429) -- and from then on what its windows leave it. One the proxy cannot judge (`unavailable`: a stale
|
|
42
|
+
* reading, a sign-in, model list or payment problem), or whose reading counts no window, adds 0 with no growth
|
|
43
|
+
* foreseen. A canceled account adds nothing from its lapse on.
|
|
44
|
+
*/
|
|
45
|
+
const projectMember = (accountArg, planArg, nowArg) => {
|
|
46
|
+
const { status, usage, quota } = accountArg;
|
|
47
|
+
const base = { accountId: status.id, plan: planArg, state: status.state };
|
|
48
|
+
const recheckAt = status.unavailable?.reason === 'usage_unread' ? status.unavailable.retryAt ?? null : null;
|
|
49
|
+
if (status.state === 'unavailable' || status.headroom === null || !usage?.reading) {
|
|
50
|
+
return { now: 0, steps: [], member: { ...base, headroom: 0, binding: null, growsAt: null, growsTo: null, recheckAt } };
|
|
51
|
+
}
|
|
52
|
+
const growth = plugins.authswitchUsageLimit.authSwitchHeadroomGrowth(usage.reading, status.maxUsagePercent, nowArg, status.reserveLiftUntil);
|
|
53
|
+
if (growth.headroom === null) {
|
|
54
|
+
return { now: 0, steps: [], member: { ...base, headroom: 0, binding: null, growsAt: null, growsTo: null, recheckAt } };
|
|
55
|
+
}
|
|
56
|
+
const windowsHeadroomAt = (atArg) => {
|
|
57
|
+
let headroom = growth.headroom;
|
|
58
|
+
for (const step of growth.steps) {
|
|
59
|
+
if (step.at > atArg)
|
|
60
|
+
break;
|
|
61
|
+
headroom = step.headroom;
|
|
62
|
+
}
|
|
63
|
+
return headroom;
|
|
64
|
+
};
|
|
65
|
+
// When it takes work again: now, a known moment ahead, or never as far as the reading says.
|
|
66
|
+
const statedReset = status.resetAt === null ? Number.NaN : Date.parse(status.resetAt);
|
|
67
|
+
const returns = status.state === 'available' ? -Infinity
|
|
68
|
+
: status.state === 'cooling' ? statedReset
|
|
69
|
+
: Math.max(statedReset, quota.restUntil);
|
|
70
|
+
const takesWorkFrom = status.state === 'available' ? -Infinity
|
|
71
|
+
: Number.isFinite(returns) && returns > nowArg ? returns : Infinity;
|
|
72
|
+
const lapses = status.lifecycle === 'canceled' && status.lapsesAt !== null ? Date.parse(status.lapsesAt) : Infinity;
|
|
73
|
+
const adds = (atArg) => atArg >= takesWorkFrom && atArg < lapses ? windowsHeadroomAt(atArg) : 0;
|
|
74
|
+
const moments = [...new Set([...growth.steps.map((stepArg) => stepArg.at), takesWorkFrom, lapses])]
|
|
75
|
+
.filter((atArg) => Number.isFinite(atArg) && atArg > nowArg)
|
|
76
|
+
.sort((left, right) => left - right);
|
|
77
|
+
const current = adds(nowArg);
|
|
78
|
+
const steps = [];
|
|
79
|
+
let previous = current;
|
|
80
|
+
for (const at of moments) {
|
|
81
|
+
const headroom = adds(at);
|
|
82
|
+
if (headroom !== previous)
|
|
83
|
+
steps.push({ at, headroom });
|
|
84
|
+
previous = headroom;
|
|
85
|
+
}
|
|
86
|
+
let before = current;
|
|
87
|
+
const grows = steps.find((stepArg) => {
|
|
88
|
+
const grew = stepArg.headroom > before;
|
|
89
|
+
before = stepArg.headroom;
|
|
90
|
+
return grew;
|
|
91
|
+
});
|
|
92
|
+
return { now: current, steps, member: { ...base, headroom: current,
|
|
93
|
+
binding: growth.binding ? capacityWindow(growth.binding) : null,
|
|
94
|
+
growsAt: grows ? iso(grows.at) : null, growsTo: grows ? grows.headroom : null, recheckAt } };
|
|
95
|
+
};
|
|
96
|
+
/**
|
|
97
|
+
* A pool's room for new work (AGL-1097). Its members are the pool's subscription sign-ins that have not lapsed and whose
|
|
98
|
+
* held reading states a plan the pool counts (`proxyCapacityPlans`), stale or not; API keys never count. The room is
|
|
99
|
+
* the headroom its members add now (see `projectMember`), summed.
|
|
100
|
+
*
|
|
101
|
+
* The pool is open when the room reaches `minHeadroom` and it is quiet: no provider 429 on a member within
|
|
102
|
+
* `proxyCapacityQuietMs`, which the proxy can say only once it has observed that long. Otherwise it waits until the
|
|
103
|
+
* first moment the members' readings foresee the room at the minimum once it is quiet (`room`), or until it is quiet when
|
|
104
|
+
* the room is there by then (`provider-429`, or `quiet-unobserved` while the proxy has not observed long enough); with
|
|
105
|
+
* no such moment foreseen, without an end (`until` and `seconds` `null`). Each projected moment is the earliest the room
|
|
106
|
+
* can be there, as no reading foresees the usage spent meanwhile.
|
|
107
|
+
*/
|
|
108
|
+
export const proxyPoolCapacity = (providerArg, accountsArg, optionsArg) => {
|
|
109
|
+
const { now, minHeadroom, observedSince } = optionsArg;
|
|
110
|
+
const counted = accountsArg.flatMap((accountArg) => {
|
|
111
|
+
const { status } = accountArg;
|
|
112
|
+
if (status.provider !== providerArg || status.credential !== 'subscription' || status.lifecycle === 'lapsed')
|
|
113
|
+
return [];
|
|
114
|
+
const plan = proxyCapacityHeldPlan(providerArg, accountArg.usage);
|
|
115
|
+
return plan !== null && proxyCapacityPlanCounts(providerArg, plan) ? [{ account: accountArg, plan }] : [];
|
|
116
|
+
}).sort((left, right) => left.account.status.id.localeCompare(right.account.status.id));
|
|
117
|
+
const projections = counted.map(({ account, plan }) => projectMember(account, plan, now));
|
|
118
|
+
const roomAt = (atArg) => projections.reduce((sumArg, projectionArg) => sumArg + headroomAt(projectionArg, atArg), 0);
|
|
119
|
+
const room = roomAt(now);
|
|
120
|
+
const lastQuota = counted.reduce((latestArg, { account }) => account.quota.lastAt === null ? latestArg
|
|
121
|
+
: Math.max(latestArg ?? -Infinity, account.quota.lastAt), null);
|
|
122
|
+
// When the pool is quiet, and why it is not before.
|
|
123
|
+
const quiet = [
|
|
124
|
+
...(lastQuota !== null ? [{ until: lastQuota + proxyCapacityQuietMs, reason: 'provider-429' }] : []),
|
|
125
|
+
{ until: observedSince + proxyCapacityQuietMs, reason: 'quiet-unobserved' },
|
|
126
|
+
].filter((entryArg) => entryArg.until > now).sort((left, right) => right.until - left.until);
|
|
127
|
+
const quietFrom = quiet[0]?.until ?? now;
|
|
128
|
+
let verdict;
|
|
129
|
+
if (!quiet.length && room >= minHeadroom)
|
|
130
|
+
verdict = { state: 'open' };
|
|
131
|
+
else {
|
|
132
|
+
const moments = [...new Set(projections.flatMap((projectionArg) => projectionArg.steps.map((stepArg) => stepArg.at)))]
|
|
133
|
+
.filter((atArg) => atArg > quietFrom).sort((left, right) => left - right);
|
|
134
|
+
const enough = roomAt(quietFrom) >= minHeadroom ? quietFrom : moments.find((atArg) => roomAt(atArg) >= minHeadroom);
|
|
135
|
+
verdict = enough === undefined ? { state: 'wait', reason: 'room', until: null, seconds: null }
|
|
136
|
+
: { state: 'wait', reason: enough > quietFrom || !quiet.length ? 'room' : quiet[0].reason, until: iso(enough),
|
|
137
|
+
seconds: Math.max(1, Math.ceil((enough - now) / 1000)) };
|
|
138
|
+
}
|
|
139
|
+
return { provider: providerArg, minHeadroom, room, members: projections.map((projectionArg) => projectionArg.member),
|
|
140
|
+
last429At: lastQuota === null ? null : iso(lastQuota), verdict };
|
|
141
|
+
};
|
|
142
|
+
//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiZnVuY3Rpb25zLnByb3h5Y2FwYWNpdHkuanMiLCJzb3VyY2VSb290IjoiIiwic291cmNlcyI6WyIuLi8uLi90cy9mdW5jdGlvbnMucHJveHljYXBhY2l0eS50cyJdLCJuYW1lcyI6W10sIm1hcHBpbmdzIjoiQUFBQSxPQUFPLEtBQUssT0FBTyxNQUFNLGNBQWMsQ0FBQztBQUV4QyxPQUFPLEVBQ0wsb0JBQW9CLEdBT3JCLE1BQU0sbUNBQW1DLENBQUM7QUFZM0MsTUFBTSxDQUFDLE1BQU0sa0JBQWtCLEdBQXFFO0lBQ2xHLFNBQVMsRUFBRSxFQUFFLE1BQU0sRUFBRSxNQUFNLEVBQUUsS0FBSyxFQUFFLENBQUMsS0FBSyxDQUFDLEVBQUU7SUFDN0MsTUFBTSxFQUFFLEVBQUUsTUFBTSxFQUFFLFFBQVEsRUFBRSxLQUFLLEVBQUUsQ0FBQyxNQUFNLENBQUMsRUFBRTtDQUM5QyxDQUFDO0FBRUYsb0VBQW9FO0FBQ3BFLE1BQU0sQ0FBQyxNQUFNLHVCQUF1QixHQUFHLENBQUMsV0FBbUMsRUFBRSxPQUFlLEVBQVcsRUFBRTtJQUN2RyxNQUFNLElBQUksR0FBRyxrQkFBa0IsQ0FBQyxXQUFXLENBQUMsQ0FBQztJQUM3QyxPQUFPLElBQUksQ0FBQyxLQUFLLENBQUMsUUFBUSxDQUFDLE9BQU8sQ0FBQyxLQUFLLENBQUMsSUFBSSxDQUFDLE1BQU0sS0FBSyxNQUFNLENBQUMsQ0FBQztBQUNuRSxDQUFDLENBQUM7QUFFRiwrRkFBK0Y7QUFDL0YsTUFBTSxDQUFDLE1BQU0scUJBQXFCLEdBQUcsQ0FBQyxXQUFtQyxFQUN2RSxRQUEwRSxFQUFpQixFQUFFO0lBQzdGLE1BQU0sT0FBTyxHQUFHLFFBQVEsRUFBRSxPQUFPLENBQUM7SUFDbEMsSUFBSSxXQUFXLEtBQUssV0FBVztRQUFFLE9BQU8sT0FBTyxFQUFFLElBQUksS0FBSyxXQUFXLENBQUMsQ0FBQyxDQUFDLE9BQU8sQ0FBQyxNQUFNLENBQUMsSUFBSSxFQUFFLElBQUksSUFBSSxJQUFJLENBQUMsQ0FBQyxDQUFDLElB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
|
|
@@ -0,0 +1,30 @@
|
|
|
1
|
+
import type { IProxyCapacityAnswer, IProxyCapacityRequest } from '../dist_ts_interfaces/proxycapacity.js';
|
|
2
|
+
/** `agl proxy capacity` exits 0 when every pool it reports is open, 2 when one waits or `--wait` ran out; a failure exits 1. */
|
|
3
|
+
export declare const proxyCapacityExitOpen = 0;
|
|
4
|
+
export declare const proxyCapacityExitWait = 2;
|
|
5
|
+
/** The answer as `agl proxy capacity` prints it: per pool its verdict, room and newest 429, then each counted account. */
|
|
6
|
+
export declare const formatProxyCapacity: (answerArg: IProxyCapacityAnswer) => string;
|
|
7
|
+
export interface IProxyCapacityCliOptions {
|
|
8
|
+
request: IProxyCapacityRequest;
|
|
9
|
+
json: boolean;
|
|
10
|
+
/** Ask again until every pool asked is open; `--wait` names one pool. */
|
|
11
|
+
wait: boolean;
|
|
12
|
+
/** How long `--wait` waits at most; unbounded when absent. */
|
|
13
|
+
maxSeconds?: number;
|
|
14
|
+
}
|
|
15
|
+
/** What the command reads and writes, so a test runs it without a proxy or a clock. */
|
|
16
|
+
export interface IProxyCapacityCliIo {
|
|
17
|
+
ask: (requestArg: IProxyCapacityRequest, signalArg: AbortSignal) => Promise<IProxyCapacityAnswer>;
|
|
18
|
+
now: () => number;
|
|
19
|
+
sleep: (msArg: number, signalArg: AbortSignal) => Promise<void>;
|
|
20
|
+
/** Standard output: the answer. */
|
|
21
|
+
write: (textArg: string) => void;
|
|
22
|
+
/** Standard error: what `--wait` waits for between its questions. */
|
|
23
|
+
note: (textArg: string) => void;
|
|
24
|
+
}
|
|
25
|
+
/**
|
|
26
|
+
* `agl proxy capacity`: asks the proxy, prints its answer (text or `--json`) and resolves to the exit status. With
|
|
27
|
+
* `--wait` it asks again after the pool's `seconds`, at most a minute and never past `--max-seconds`, until the pool is
|
|
28
|
+
* open or that time ran out, and prints the last answer. A failure (no proxy, an older one, a refusal) rejects.
|
|
29
|
+
*/
|
|
30
|
+
export declare const runProxyCapacity: (optionsArg: IProxyCapacityCliOptions, ioArg: IProxyCapacityCliIo, signalArg: AbortSignal) => Promise<number>;
|
|
@@ -0,0 +1,65 @@
|
|
|
1
|
+
import { proxyCapacityPlans } from './functions.proxycapacity.js';
|
|
2
|
+
/** `agl proxy capacity` exits 0 when every pool it reports is open, 2 when one waits or `--wait` ran out; a failure exits 1. */
|
|
3
|
+
export const proxyCapacityExitOpen = 0;
|
|
4
|
+
export const proxyCapacityExitWait = 2;
|
|
5
|
+
/** How long `--wait` pauses at most before it asks again. */
|
|
6
|
+
const longestPauseMs = 60_000;
|
|
7
|
+
const poolNames = { anthropic: 'Claude', openai: 'ChatGPT' };
|
|
8
|
+
const waitReasons = {
|
|
9
|
+
room: 'too little room',
|
|
10
|
+
'provider-429': 'a provider 429 on a member within five minutes',
|
|
11
|
+
'quiet-unobserved': 'the proxy has watched its pools for provider 429s for less than five minutes',
|
|
12
|
+
};
|
|
13
|
+
const percent = (valueArg) => `${Math.round(valueArg * 10) / 10}%`;
|
|
14
|
+
/** The plans a pool counts, in words (`proxyCapacityPlans`). */
|
|
15
|
+
const countedPlans = (providerArg) => {
|
|
16
|
+
const rule = proxyCapacityPlans[providerArg];
|
|
17
|
+
return `${rule.counts === 'only' ? 'plan' : 'every plan but'} ${rule.plans.join(', ')}`;
|
|
18
|
+
};
|
|
19
|
+
const memberText = (memberArg) => {
|
|
20
|
+
const binding = memberArg.binding;
|
|
21
|
+
return ` account ${memberArg.accountId.slice(0, 12)} (${memberArg.plan}): ${memberArg.state}, adds ${percent(memberArg.headroom)}`
|
|
22
|
+
+ `${binding === null ? '' : `, bound by its ${binding.name} window (${percent(binding.usedPercent)} used`
|
|
23
|
+
+ `${binding.estimated ? ', est.' : ''}${binding.resetAt === null ? '' : `, resets ${binding.resetAt}`})`}`
|
|
24
|
+
+ `${memberArg.growsAt === null ? '; no growth foreseen' : `; grows at ${memberArg.growsAt} to ${percent(memberArg.growsTo)}`}`
|
|
25
|
+
+ `${memberArg.recheckAt === null ? '' : `; its usage is read again at ${memberArg.recheckAt}`}`;
|
|
26
|
+
};
|
|
27
|
+
const poolText = (poolArg, observedSinceArg) => {
|
|
28
|
+
const verdict = poolArg.verdict;
|
|
29
|
+
const verdictText = verdict.state === 'open' ? 'open'
|
|
30
|
+
: verdict.until === null ? `wait (${waitReasons[verdict.reason]}; no moment foreseen when it suffices)`
|
|
31
|
+
: `wait ${verdict.seconds} s, until ${verdict.until} (${waitReasons[verdict.reason]})`;
|
|
32
|
+
return [
|
|
33
|
+
`${poolNames[poolArg.provider]} pool (${poolArg.provider}): ${verdictText}; room ${percent(poolArg.room)}, `
|
|
34
|
+
+ `minimum ${poolArg.minHeadroom}%; last provider 429 on a member: ${poolArg.last429At ?? `none since ${observedSinceArg}`}`,
|
|
35
|
+
...poolArg.members.length ? poolArg.members.map(memberText)
|
|
36
|
+
: [` no account counts (${countedPlans(poolArg.provider)}, a subscription sign-in that has not lapsed)`],
|
|
37
|
+
];
|
|
38
|
+
};
|
|
39
|
+
/** The answer as `agl proxy capacity` prints it: per pool its verdict, room and newest 429, then each counted account. */
|
|
40
|
+
export const formatProxyCapacity = (answerArg) => [`As of ${answerArg.at}:`, ...answerArg.pools.flatMap((poolArg) => poolText(poolArg, answerArg.observedSince))].join('\n') + '\n';
|
|
41
|
+
/**
|
|
42
|
+
* `agl proxy capacity`: asks the proxy, prints its answer (text or `--json`) and resolves to the exit status. With
|
|
43
|
+
* `--wait` it asks again after the pool's `seconds`, at most a minute and never past `--max-seconds`, until the pool is
|
|
44
|
+
* open or that time ran out, and prints the last answer. A failure (no proxy, an older one, a refusal) rejects.
|
|
45
|
+
*/
|
|
46
|
+
export const runProxyCapacity = async (optionsArg, ioArg, signalArg) => {
|
|
47
|
+
const deadline = optionsArg.maxSeconds === undefined ? Infinity : ioArg.now() + optionsArg.maxSeconds * 1000;
|
|
48
|
+
for (;;) {
|
|
49
|
+
const answer = await ioArg.ask(optionsArg.request, signalArg);
|
|
50
|
+
const open = answer.pools.every((poolArg) => poolArg.verdict.state === 'open');
|
|
51
|
+
const remaining = deadline - ioArg.now();
|
|
52
|
+
if (!optionsArg.wait || open || remaining <= 0) {
|
|
53
|
+
ioArg.write(optionsArg.json ? JSON.stringify(answer) + '\n' : formatProxyCapacity(answer));
|
|
54
|
+
return open ? proxyCapacityExitOpen : proxyCapacityExitWait;
|
|
55
|
+
}
|
|
56
|
+
// `--wait` names one pool, which waits: the pause is its seconds, at most a minute and never past `--max-seconds`.
|
|
57
|
+
const [waiting] = answer.pools.flatMap((poolArg) => poolArg.verdict.state === 'wait'
|
|
58
|
+
? [{ provider: poolArg.provider, verdict: poolArg.verdict }] : []);
|
|
59
|
+
const pause = Math.min((waiting.verdict.seconds ?? 60) * 1000, longestPauseMs, remaining);
|
|
60
|
+
ioArg.note(`AGL proxy capacity: the ${poolNames[waiting.provider]} pool waits (${waitReasons[waiting.verdict.reason]}); `
|
|
61
|
+
+ `asking again in ${Math.ceil(pause / 1000)} s.\n`);
|
|
62
|
+
await ioArg.sleep(pause, signalArg);
|
|
63
|
+
}
|
|
64
|
+
};
|
|
65
|
+
//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiZnVuY3Rpb25zLnByb3h5Y2FwYWNpdHljbGkuanMiLCJzb3VyY2VSb290IjoiIiwic291cmNlcyI6WyIuLi8uLi90cy9mdW5jdGlvbnMucHJveHljYXBhY2l0eWNsaS50cyJdLCJuYW1lcyI6W10sIm1hcHBpbmdzIjoiQUFRQSxPQUFPLEVBQUUsa0JBQWtCLEVBQUUsTUFBTSw4QkFBOEIsQ0FBQztBQUVsRSxnSUFBZ0k7QUFDaEksTUFBTSxDQUFDLE1BQU0scUJBQXFCLEdBQUcsQ0FBQyxDQUFDO0FBQ3ZDLE1BQU0sQ0FBQyxNQUFNLHFCQUFxQixHQUFHLENBQUMsQ0FBQztBQUV2Qyw2REFBNkQ7QUFDN0QsTUFBTSxjQUFjLEdBQUcsTUFBTSxDQUFDO0FBRTlCLE1BQU0sU0FBUyxHQUEyQyxFQUFFLFNBQVMsRUFBRSxRQUFRLEVBQUUsTUFBTSxFQUFFLFNBQVMsRUFBRSxDQUFDO0FBRXJHLE1BQU0sV0FBVyxHQUE2QztJQUM1RCxJQUFJLEVBQUUsaUJBQWlCO0lBQ3ZCLGNBQWMsRUFBRSxnREFBZ0Q7SUFDaEUsa0JBQWtCLEVBQUUsOEVBQThFO0NBQ25HLENBQUM7QUFFRixNQUFNLE9BQU8sR0FBRyxDQUFDLFFBQWdCLEVBQVUsRUFBRSxDQUFDLEdBQUcsSUFBSSxDQUFDLEtBQUssQ0FBQyxRQUFRLEdBQUcsRUFBRSxDQUFDLEdBQUcsRUFBRSxHQUFHLENBQUM7QUFFbkYsZ0VBQWdFO0FBQ2hFLE1BQU0sWUFBWSxHQUFHLENBQUMsV0FBbUMsRUFBVSxFQUFFO0lBQ25FLE1BQU0sSUFBSSxHQUFHLGtCQUFrQixDQUFDLFdBQVcsQ0FBQyxDQUFDO0lBQzdDLE9BQU8sR0FBRyxJQUFJLENBQUMsTUFBTSxLQUFLLE1BQU0sQ0FBQyxDQUFDLENBQUMsTUFBTSxDQUFDLENBQUMsQ0FBQyxnQkFBZ0IsSUFBSSxJQUFJLENBQUMsS0FBSyxDQUFDLElBQUksQ0FBQyxJQUFJLENBQUMsRUFBRSxDQUFDO0FBQzFGLENBQUMsQ0FBQztBQUVGLE1BQU0sVUFBVSxHQUFHLENBQUMs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
|
|
@@ -1,5 +1,9 @@
|
|
|
1
|
+
import type { SmartDataAuthStore } from './classes.authstore.js';
|
|
1
2
|
import { type ITpmSecretCodec } from './classes.tpmsecretcodec.js';
|
|
2
|
-
|
|
3
|
+
import type { IControllerIssuerIdentity } from './interfaces.identity.js';
|
|
4
|
+
import type { IControllerRuntimeConfig } from './interfaces.config.js';
|
|
5
|
+
import type { IRecordAuditEventDetails, TControllerAuditEventType } from './interfaces.auth.js';
|
|
6
|
+
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\n agl remote gateway enrol|status|sync|remove [options] (agl remote gateway --help)\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. While the controller is enrolled with a gateway, set keeps the origin's\nhostname: for another, run agl remote gateway remove, then agl remote set, then agl remote gateway enrol.\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. It is refused while the controller is enrolled\nwith a gateway: run agl remote gateway remove first.\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
7
|
export type TRemoteCliArguments = {
|
|
4
8
|
action: 'set';
|
|
5
9
|
port: number;
|
|
@@ -15,13 +19,36 @@ export type TRemoteCliArguments = {
|
|
|
15
19
|
};
|
|
16
20
|
export declare const parseRemoteCliArguments: (argsArg: readonly string[]) => TRemoteCliArguments;
|
|
17
21
|
export interface IRemoteCliOptions {
|
|
18
|
-
/** Seals the trusted-proxy secret; TPM2 when absent. For tests. */
|
|
22
|
+
/** Seals the trusted-proxy secret and the gateway credential; TPM2 when absent. For tests. */
|
|
19
23
|
codec?: ITpmSecretCodec;
|
|
20
|
-
/** Where `secret import`
|
|
24
|
+
/** Where `secret import` and `gateway enrol` read their secret; this process's standard input when absent. */
|
|
21
25
|
input?: NodeJS.ReadableStream & {
|
|
22
26
|
isTTY?: boolean;
|
|
23
27
|
};
|
|
24
28
|
/** Where the outcome is written; standard output when absent. */
|
|
25
29
|
write?: (textArg: string) => void;
|
|
30
|
+
/** Waits before each retried gateway confirmation of `gateway enrol`; 1 s and 3 s when absent. For tests. */
|
|
31
|
+
finalizeRetryDelaysMs?: readonly number[];
|
|
26
32
|
}
|
|
33
|
+
/**
|
|
34
|
+
* Reads a secret from standard input, a pipe or a file, never a terminal (`refusalArg` names the right way), and
|
|
35
|
+
* returns it trimmed; nothing of it is echoed or kept past the read.
|
|
36
|
+
*/
|
|
37
|
+
export declare const readStandardInputSecret: (inputArg: NodeJS.ReadableStream & {
|
|
38
|
+
isTTY?: boolean;
|
|
39
|
+
}, refusalArg: string, whatArg: string) => Promise<string>;
|
|
40
|
+
export interface IStoppedController {
|
|
41
|
+
authStore: SmartDataAuthStore;
|
|
42
|
+
issuer: IControllerIssuerIdentity;
|
|
43
|
+
/** `controller:<port>`. */
|
|
44
|
+
controllerId: string;
|
|
45
|
+
config: IControllerRuntimeConfig;
|
|
46
|
+
}
|
|
47
|
+
/** Runs `actionArg` on the stored configuration of a stopped, initialized controller, under start admission. */
|
|
48
|
+
export declare const withStoppedController: <T>(portArg: number, actionArg: (controllerArg: IStoppedController) => Promise<T>) => Promise<T>;
|
|
49
|
+
/**
|
|
50
|
+
* Records `typeArg` as attempted, runs the change, and records its outcome, attributed to this OS user and process;
|
|
51
|
+
* every event records `detailsArg` (a move where it goes from and to, a gateway command its route).
|
|
52
|
+
*/
|
|
53
|
+
export declare const audited: <T>(authStoreArg: SmartDataAuthStore, typeArg: TControllerAuditEventType, actionArg: () => Promise<T>, detailsArg?: IRecordAuditEventDetails) => Promise<T>;
|
|
27
54
|
export declare const runRemoteCli: (argsArg: string[], optionsArg?: IRemoteCliOptions) => Promise<void>;
|