@decionis/agentsafe 0.2.5 → 0.3.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/README.md +135 -20
- package/dist/Cli.js +19 -0
- package/dist/Cli.js.map +1 -1
- package/dist/Index.d.ts +10 -4
- package/dist/Index.d.ts.map +1 -1
- package/dist/Index.js +8 -2
- package/dist/Index.js.map +1 -1
- package/dist/TrustedExecutor.d.ts.map +1 -1
- package/dist/TrustedExecutor.js +1 -0
- package/dist/TrustedExecutor.js.map +1 -1
- package/dist/adapters/AdapterActionHandler.d.ts.map +1 -1
- package/dist/adapters/AdapterActionHandler.js +8 -4
- package/dist/adapters/AdapterActionHandler.js.map +1 -1
- package/dist/adapters/EffectAdapter.d.ts +6 -1
- package/dist/adapters/EffectAdapter.d.ts.map +1 -1
- package/dist/adapters/EffectAdapter.js +7 -1
- package/dist/adapters/EffectAdapter.js.map +1 -1
- package/dist/adapters/banking/CoreBankingHttpAdapter.d.ts.map +1 -1
- package/dist/adapters/banking/CoreBankingHttpAdapter.js +4 -4
- package/dist/adapters/banking/CoreBankingHttpAdapter.js.map +1 -1
- package/dist/adapters/cards/CardAuthorizationMatcher.d.ts +44 -0
- package/dist/adapters/cards/CardAuthorizationMatcher.d.ts.map +1 -0
- package/dist/adapters/cards/CardAuthorizationMatcher.js +39 -0
- package/dist/adapters/cards/CardAuthorizationMatcher.js.map +1 -0
- package/dist/adapters/cards/CardEffect.d.ts +52 -0
- package/dist/adapters/cards/CardEffect.d.ts.map +1 -0
- package/dist/adapters/cards/CardEffect.js +117 -0
- package/dist/adapters/cards/CardEffect.js.map +1 -0
- package/dist/adapters/cards/CardHandlers.d.ts +15 -0
- package/dist/adapters/cards/CardHandlers.d.ts.map +1 -0
- package/dist/adapters/cards/CardHandlers.js +26 -0
- package/dist/adapters/cards/CardHandlers.js.map +1 -0
- package/dist/adapters/cards/CardPurchase.d.ts +61 -0
- package/dist/adapters/cards/CardPurchase.d.ts.map +1 -0
- package/dist/adapters/cards/CardPurchase.js +116 -0
- package/dist/adapters/cards/CardPurchase.js.map +1 -0
- package/dist/adapters/cards/HeldCardGrants.d.ts +70 -0
- package/dist/adapters/cards/HeldCardGrants.d.ts.map +1 -0
- package/dist/adapters/cards/HeldCardGrants.js +79 -0
- package/dist/adapters/cards/HeldCardGrants.js.map +1 -0
- package/dist/adapters/cards/Pan.d.ts +17 -0
- package/dist/adapters/cards/Pan.d.ts.map +1 -0
- package/dist/adapters/cards/Pan.js +52 -0
- package/dist/adapters/cards/Pan.js.map +1 -0
- package/dist/adapters/mcp/McpGuard.d.ts.map +1 -1
- package/dist/adapters/mcp/McpGuard.js +9 -4
- package/dist/adapters/mcp/McpGuard.js.map +1 -1
- package/dist/audit/HashChain.d.ts +8 -2
- package/dist/audit/HashChain.d.ts.map +1 -1
- package/dist/audit/HashChain.js +14 -2
- package/dist/audit/HashChain.js.map +1 -1
- package/dist/cli/Commands.d.ts +1 -1
- package/dist/cli/Commands.d.ts.map +1 -1
- package/dist/cli/Commands.js +5 -0
- package/dist/cli/Commands.js.map +1 -1
- package/dist/cli/Edge.d.ts +4 -0
- package/dist/cli/Edge.d.ts.map +1 -0
- package/dist/cli/Edge.js +250 -0
- package/dist/cli/Edge.js.map +1 -0
- package/dist/cli/Help.d.ts.map +1 -1
- package/dist/cli/Help.js +8 -0
- package/dist/cli/Help.js.map +1 -1
- package/dist/cli/Host.d.ts +36 -0
- package/dist/cli/Host.d.ts.map +1 -0
- package/dist/cli/Host.js +247 -0
- package/dist/cli/Host.js.map +1 -0
- package/dist/cli/TcpBrokerCli.d.ts +4 -0
- package/dist/cli/TcpBrokerCli.d.ts.map +1 -0
- package/dist/cli/TcpBrokerCli.js +93 -0
- package/dist/cli/TcpBrokerCli.js.map +1 -0
- package/dist/cli/TcpClientCli.d.ts +16 -0
- package/dist/cli/TcpClientCli.d.ts.map +1 -0
- package/dist/cli/TcpClientCli.js +175 -0
- package/dist/cli/TcpClientCli.js.map +1 -0
- package/dist/config/ConfigKeys.d.ts +2 -2
- package/dist/config/ConfigKeys.d.ts.map +1 -1
- package/dist/config/ConfigKeys.js +19 -0
- package/dist/config/ConfigKeys.js.map +1 -1
- package/dist/config/ExecutorConfig.d.ts +62 -0
- package/dist/config/ExecutorConfig.d.ts.map +1 -1
- package/dist/config/ExecutorConfig.js +124 -0
- package/dist/config/ExecutorConfig.js.map +1 -1
- package/dist/edge/EdgeLicence.d.ts +25 -0
- package/dist/edge/EdgeLicence.d.ts.map +1 -0
- package/dist/edge/EdgeLicence.js +42 -0
- package/dist/edge/EdgeLicence.js.map +1 -0
- package/dist/edge/EdgeReplay.d.ts +45 -0
- package/dist/edge/EdgeReplay.d.ts.map +1 -0
- package/dist/edge/EdgeReplay.js +69 -0
- package/dist/edge/EdgeReplay.js.map +1 -0
- package/dist/edge/Entitlement.d.ts +57 -0
- package/dist/edge/Entitlement.d.ts.map +1 -0
- package/dist/edge/Entitlement.js +139 -0
- package/dist/edge/Entitlement.js.map +1 -0
- package/dist/edge/EntitlementEvaluation.d.ts +66 -0
- package/dist/edge/EntitlementEvaluation.d.ts.map +1 -0
- package/dist/edge/EntitlementEvaluation.js +74 -0
- package/dist/edge/EntitlementEvaluation.js.map +1 -0
- package/dist/edge/UsageCount.d.ts +40 -0
- package/dist/edge/UsageCount.d.ts.map +1 -0
- package/dist/edge/UsageCount.js +140 -0
- package/dist/edge/UsageCount.js.map +1 -0
- package/dist/edge/UsageKeyRegistration.d.ts +34 -0
- package/dist/edge/UsageKeyRegistration.d.ts.map +1 -0
- package/dist/edge/UsageKeyRegistration.js +74 -0
- package/dist/edge/UsageKeyRegistration.js.map +1 -0
- package/dist/edge/UsageMeter.d.ts +89 -0
- package/dist/edge/UsageMeter.d.ts.map +1 -0
- package/dist/edge/UsageMeter.js +275 -0
- package/dist/edge/UsageMeter.js.map +1 -0
- package/dist/edge/UsagePeriod.d.ts +23 -0
- package/dist/edge/UsagePeriod.d.ts.map +1 -0
- package/dist/edge/UsagePeriod.js +31 -0
- package/dist/edge/UsagePeriod.js.map +1 -0
- package/dist/edge/UsageReport.d.ts +92 -0
- package/dist/edge/UsageReport.d.ts.map +1 -0
- package/dist/edge/UsageReport.js +153 -0
- package/dist/edge/UsageReport.js.map +1 -0
- package/dist/edge/UsageTally.d.ts +63 -0
- package/dist/edge/UsageTally.d.ts.map +1 -0
- package/dist/edge/UsageTally.js +89 -0
- package/dist/edge/UsageTally.js.map +1 -0
- package/dist/egress/EgressError.d.ts +7 -1
- package/dist/egress/EgressError.d.ts.map +1 -1
- package/dist/egress/EgressError.js.map +1 -1
- package/dist/egress/EgressPolicy.d.ts +16 -3
- package/dist/egress/EgressPolicy.d.ts.map +1 -1
- package/dist/egress/EgressPolicy.js +33 -3
- package/dist/egress/EgressPolicy.js.map +1 -1
- package/dist/egress/GuardedFetch.d.ts +38 -1
- package/dist/egress/GuardedFetch.d.ts.map +1 -1
- package/dist/egress/GuardedFetch.js +52 -7
- package/dist/egress/GuardedFetch.js.map +1 -1
- package/dist/egress/TcpClient.d.ts +103 -0
- package/dist/egress/TcpClient.d.ts.map +1 -0
- package/dist/egress/TcpClient.js +490 -0
- package/dist/egress/TcpClient.js.map +1 -0
- package/dist/egress/TcpControlClient.d.ts +49 -0
- package/dist/egress/TcpControlClient.d.ts.map +1 -0
- package/dist/egress/TcpControlClient.js +186 -0
- package/dist/egress/TcpControlClient.js.map +1 -0
- package/dist/gateway/ForwardHandler.d.ts.map +1 -1
- package/dist/gateway/ForwardHandler.js +7 -4
- package/dist/gateway/ForwardHandler.js.map +1 -1
- package/dist/gateway/Gateway.d.ts +190 -10
- package/dist/gateway/Gateway.d.ts.map +1 -1
- package/dist/gateway/Gateway.js +465 -62
- package/dist/gateway/Gateway.js.map +1 -1
- package/dist/gateway/GatewayConfig.d.ts +67 -0
- package/dist/gateway/GatewayConfig.d.ts.map +1 -1
- package/dist/gateway/GatewayConfig.js +149 -2
- package/dist/gateway/GatewayConfig.js.map +1 -1
- package/dist/gateway/InterceptedRequest.d.ts +9 -2
- package/dist/gateway/InterceptedRequest.d.ts.map +1 -1
- package/dist/gateway/InterceptedRequest.js +41 -9
- package/dist/gateway/InterceptedRequest.js.map +1 -1
- package/dist/gateway/RateLimit.d.ts +29 -0
- package/dist/gateway/RateLimit.d.ts.map +1 -0
- package/dist/gateway/RateLimit.js +33 -0
- package/dist/gateway/RateLimit.js.map +1 -0
- package/dist/gateway/RefusalSampler.d.ts +28 -0
- package/dist/gateway/RefusalSampler.d.ts.map +1 -0
- package/dist/gateway/RefusalSampler.js +52 -0
- package/dist/gateway/RefusalSampler.js.map +1 -0
- package/dist/gateway/RouteTable.d.ts +3 -0
- package/dist/gateway/RouteTable.d.ts.map +1 -1
- package/dist/gateway/RouteTable.js +44 -7
- package/dist/gateway/RouteTable.js.map +1 -1
- package/dist/gateway/Upstream.d.ts +26 -0
- package/dist/gateway/Upstream.d.ts.map +1 -1
- package/dist/gateway/Upstream.js +41 -2
- package/dist/gateway/Upstream.js.map +1 -1
- package/dist/gateway/UpstreamProof.d.ts +235 -0
- package/dist/gateway/UpstreamProof.d.ts.map +1 -0
- package/dist/gateway/UpstreamProof.js +375 -0
- package/dist/gateway/UpstreamProof.js.map +1 -0
- package/dist/handlers/ForwardRequestHandler.d.ts +5 -1
- package/dist/handlers/ForwardRequestHandler.d.ts.map +1 -1
- package/dist/handlers/ForwardRequestHandler.js +12 -2
- package/dist/handlers/ForwardRequestHandler.js.map +1 -1
- package/dist/hosted/TenantHost.d.ts +180 -0
- package/dist/hosted/TenantHost.d.ts.map +1 -0
- package/dist/hosted/TenantHost.js +432 -0
- package/dist/hosted/TenantHost.js.map +1 -0
- package/dist/hosted/TenantRegistry.d.ts +73 -0
- package/dist/hosted/TenantRegistry.d.ts.map +1 -0
- package/dist/hosted/TenantRegistry.js +123 -0
- package/dist/hosted/TenantRegistry.js.map +1 -0
- package/dist/http/ExecutorHttpServer.d.ts +7 -0
- package/dist/http/ExecutorHttpServer.d.ts.map +1 -1
- package/dist/http/ExecutorHttpServer.js +30 -5
- package/dist/http/ExecutorHttpServer.js.map +1 -1
- package/dist/http/GatewayHttpServer.d.ts +55 -3
- package/dist/http/GatewayHttpServer.d.ts.map +1 -1
- package/dist/http/GatewayHttpServer.js +157 -17
- package/dist/http/GatewayHttpServer.js.map +1 -1
- package/dist/http/RedirectServer.d.ts +26 -0
- package/dist/http/RedirectServer.d.ts.map +1 -0
- package/dist/http/RedirectServer.js +62 -0
- package/dist/http/RedirectServer.js.map +1 -0
- package/dist/http/Routes.d.ts +17 -0
- package/dist/http/Routes.d.ts.map +1 -1
- package/dist/http/Routes.js +21 -0
- package/dist/http/Routes.js.map +1 -1
- package/dist/http/TcpBroker.d.ts +57 -0
- package/dist/http/TcpBroker.d.ts.map +1 -0
- package/dist/http/TcpBroker.js +299 -0
- package/dist/http/TcpBroker.js.map +1 -0
- package/dist/http/TcpHostRelay.d.ts +24 -0
- package/dist/http/TcpHostRelay.d.ts.map +1 -0
- package/dist/http/TcpHostRelay.js +194 -0
- package/dist/http/TcpHostRelay.js.map +1 -0
- package/dist/http/TcpRelayStreams.d.ts +24 -0
- package/dist/http/TcpRelayStreams.d.ts.map +1 -0
- package/dist/http/TcpRelayStreams.js +128 -0
- package/dist/http/TcpRelayStreams.js.map +1 -0
- package/dist/http/TlsListener.d.ts +3 -1
- package/dist/http/TlsListener.d.ts.map +1 -1
- package/dist/http/TlsListener.js +7 -2
- package/dist/http/TlsListener.js.map +1 -1
- package/dist/identity/PrincipalsFile.d.ts +3 -1
- package/dist/identity/PrincipalsFile.d.ts.map +1 -1
- package/dist/identity/PrincipalsFile.js +1 -0
- package/dist/identity/PrincipalsFile.js.map +1 -1
- package/dist/incident/Metrics.d.ts +2 -0
- package/dist/incident/Metrics.d.ts.map +1 -1
- package/dist/incident/Metrics.js +10 -0
- package/dist/incident/Metrics.js.map +1 -1
- package/dist/incident/SecurityEvents.d.ts +89 -0
- package/dist/incident/SecurityEvents.d.ts.map +1 -1
- package/dist/incident/SecurityEvents.js +93 -2
- package/dist/incident/SecurityEvents.js.map +1 -1
- package/dist/journal/ExecutionJournal.d.ts +27 -0
- package/dist/journal/ExecutionJournal.d.ts.map +1 -1
- package/dist/journal/ExecutionJournal.js +28 -0
- package/dist/journal/ExecutionJournal.js.map +1 -1
- package/dist/journal/FileExecutionJournal.d.ts +2 -1
- package/dist/journal/FileExecutionJournal.d.ts.map +1 -1
- package/dist/journal/FileExecutionJournal.js +4 -1
- package/dist/journal/FileExecutionJournal.js.map +1 -1
- package/dist/journal/InMemoryExecutionJournal.d.ts +2 -1
- package/dist/journal/InMemoryExecutionJournal.d.ts.map +1 -1
- package/dist/journal/InMemoryExecutionJournal.js +4 -1
- package/dist/journal/InMemoryExecutionJournal.js.map +1 -1
- package/dist/service/AuthorityClients.d.ts +8 -1
- package/dist/service/AuthorityClients.d.ts.map +1 -1
- package/dist/service/AuthorityClients.js +33 -5
- package/dist/service/AuthorityClients.js.map +1 -1
- package/dist/service/EdgeRuntime.d.ts +73 -0
- package/dist/service/EdgeRuntime.d.ts.map +1 -0
- package/dist/service/EdgeRuntime.js +209 -0
- package/dist/service/EdgeRuntime.js.map +1 -0
- package/dist/service/EscalationResolver.d.ts +82 -2
- package/dist/service/EscalationResolver.d.ts.map +1 -1
- package/dist/service/EscalationResolver.js +39 -3
- package/dist/service/EscalationResolver.js.map +1 -1
- package/dist/service/Requests.d.ts +28 -2
- package/dist/service/Requests.d.ts.map +1 -1
- package/dist/service/TrustedExecutorService.d.ts +71 -1
- package/dist/service/TrustedExecutorService.d.ts.map +1 -1
- package/dist/service/TrustedExecutorService.js +461 -27
- package/dist/service/TrustedExecutorService.js.map +1 -1
- package/dist/tcp/TcpWire.d.ts +18 -0
- package/dist/tcp/TcpWire.d.ts.map +1 -0
- package/dist/tcp/TcpWire.js +114 -0
- package/dist/tcp/TcpWire.js.map +1 -0
- package/dist/verify/VerifyAuditChain.d.ts +5 -0
- package/dist/verify/VerifyAuditChain.d.ts.map +1 -1
- package/dist/verify/VerifyAuditChain.js +20 -4
- package/dist/verify/VerifyAuditChain.js.map +1 -1
- package/package.json +7 -3
|
@@ -0,0 +1,432 @@
|
|
|
1
|
+
import { join } from "node:path";
|
|
2
|
+
import { Gateway, shortDigest, } from "../gateway/Gateway.js";
|
|
3
|
+
import { GatewayConfigError, GatewayConfigLoader, } from "../gateway/GatewayConfig.js";
|
|
4
|
+
import { SecretError } from "../secrets/SecretStore.js";
|
|
5
|
+
import { parseTenantRegistry, registryRevision, tenantFingerprint, tenantHostname, TenantRegistryError, } from "./TenantRegistry.js";
|
|
6
|
+
/**
|
|
7
|
+
* What a tenant's gateway inherits from the host's environment: how to reach
|
|
8
|
+
* the authority and how long to wait for it and for the upstream. Nothing
|
|
9
|
+
* else crosses, and never a credential: each tenant's workspace key comes
|
|
10
|
+
* from its own mounted file, and the host's own environment may hold keys
|
|
11
|
+
* no tenant should ever run under.
|
|
12
|
+
*/
|
|
13
|
+
export const SHARED_ENVIRONMENT = [
|
|
14
|
+
"NODE_ENV",
|
|
15
|
+
"DECIONIS_API_URL",
|
|
16
|
+
"DECIONIS_TIMEOUT_MS",
|
|
17
|
+
"DECIONIS_ALLOW_INSECURE_LOOPBACK",
|
|
18
|
+
"AGENTSAFE_UPSTREAM_TIMEOUT_MS",
|
|
19
|
+
"AGENTSAFE_FAILURE_POLICY",
|
|
20
|
+
];
|
|
21
|
+
/** How long a replaced or removed tenant's gateway keeps finishing requests already in flight. */
|
|
22
|
+
export const DEFAULT_DRAIN_MS = 30_000;
|
|
23
|
+
/** The longest readiness waits for the tenants' first looks at their upstreams' proofs. */
|
|
24
|
+
export const PROOF_READY_CAP_MS = 30_000;
|
|
25
|
+
/**
|
|
26
|
+
* Many tenants' gateways in one process, each at `{id}.{domain}`, built from
|
|
27
|
+
* the registry the operator mounts. Every tenant gets an ordinary hosted
|
|
28
|
+
* gateway (public-only upstream, shadow only, operator-only status,
|
|
29
|
+
* host-only cookies, its tenant key required) assembled from its entry and
|
|
30
|
+
* its own workspace key file; nothing about one tenant is visible to
|
|
31
|
+
* another, because each request is routed to one gateway by its host alone.
|
|
32
|
+
*
|
|
33
|
+
* A reload rebuilds only the tenants whose entry changed, swaps the set at
|
|
34
|
+
* once, and lets a replaced gateway drain before it is closed; the gateway
|
|
35
|
+
* built in its place continues its chains, found by the tenant's id and not
|
|
36
|
+
* its host, and takes over its upstream's proof at the swap, as it stands
|
|
37
|
+
* then. A change to a tenant's keys alone rebuilds nothing: its gateway
|
|
38
|
+
* takes them in place. A registry that cannot be read or is not valid
|
|
39
|
+
* changes nothing: the tenants served stay served.
|
|
40
|
+
*/
|
|
41
|
+
export class TenantHost {
|
|
42
|
+
options;
|
|
43
|
+
served = new Map();
|
|
44
|
+
draining = new Set();
|
|
45
|
+
timers = new Set();
|
|
46
|
+
queue = Promise.resolve();
|
|
47
|
+
closed = false;
|
|
48
|
+
refusal = null;
|
|
49
|
+
failing = [];
|
|
50
|
+
currentDomain = null;
|
|
51
|
+
/** How the tenants' hosts are reached, once the listener is bound; null before. */
|
|
52
|
+
scheme = null;
|
|
53
|
+
/** When one load first served every tenant the registry names; null until then. */
|
|
54
|
+
everyTenantServedAt = null;
|
|
55
|
+
readyLatched = false;
|
|
56
|
+
/** The gateway for a request's host, or null (the listener answers 421). */
|
|
57
|
+
select = (hostname) => hostname === null ? null : (this.served.get(hostname)?.gateway ?? null);
|
|
58
|
+
clock;
|
|
59
|
+
constructor(options) {
|
|
60
|
+
this.options = options;
|
|
61
|
+
this.clock = options.clock ?? Date.now;
|
|
62
|
+
}
|
|
63
|
+
/** Loads the registry and builds every tenant; a registry that cannot be served refuses the start. */
|
|
64
|
+
static async start(options) {
|
|
65
|
+
const host = new TenantHost(options);
|
|
66
|
+
await host.reload();
|
|
67
|
+
if (host.refusal !== null) {
|
|
68
|
+
await host.close();
|
|
69
|
+
throw host.refusal;
|
|
70
|
+
}
|
|
71
|
+
return host;
|
|
72
|
+
}
|
|
73
|
+
/**
|
|
74
|
+
* The tenants whose entry the last load could not apply: a reload with an
|
|
75
|
+
* unchanged registry tries exactly these again, since every other tenant
|
|
76
|
+
* is kept. A tenant whose key file had not arrived yet is one of them.
|
|
77
|
+
*/
|
|
78
|
+
failures() {
|
|
79
|
+
return this.failing;
|
|
80
|
+
}
|
|
81
|
+
/**
|
|
82
|
+
* Whether the process is ready for traffic: from the first load that served
|
|
83
|
+
* every tenant its registry names, once each of their gateways has had its
|
|
84
|
+
* first look at its upstream's proof, or 30 seconds have passed, and from
|
|
85
|
+
* then on. A new process, in a rollout or after a restart, gets no traffic
|
|
86
|
+
* while a tenant it should serve would be answered 421, or 503 only for
|
|
87
|
+
* want of a first look; once ready, a tenant that cannot be built later
|
|
88
|
+
* is reported, and never takes every other tenant out of service.
|
|
89
|
+
*/
|
|
90
|
+
ready() {
|
|
91
|
+
const servedAt = this.everyTenantServedAt;
|
|
92
|
+
if (!this.readyLatched && servedAt !== null) {
|
|
93
|
+
const looked = [...this.served.values()].every((entry) => entry.gateway.upstreamProofSettled);
|
|
94
|
+
this.readyLatched = looked || this.clock() - servedAt >= PROOF_READY_CAP_MS;
|
|
95
|
+
}
|
|
96
|
+
return this.readyLatched;
|
|
97
|
+
}
|
|
98
|
+
/** The domain of the registry last loaded: the apex, and the parent of every tenant's host. */
|
|
99
|
+
domain() {
|
|
100
|
+
return this.currentDomain;
|
|
101
|
+
}
|
|
102
|
+
/** The hostnames served, sorted. */
|
|
103
|
+
hostnames() {
|
|
104
|
+
return [...this.served.keys()].sort();
|
|
105
|
+
}
|
|
106
|
+
/**
|
|
107
|
+
* The listener is bound: every tenant's gateway starts, with its banner and
|
|
108
|
+
* its chained start line, and so does each gateway built from now on as it
|
|
109
|
+
* is swapped in. A started gateway reports its stop, and its shadow tally,
|
|
110
|
+
* when it is replaced or the host stops.
|
|
111
|
+
*/
|
|
112
|
+
listening(scheme) {
|
|
113
|
+
this.scheme = scheme;
|
|
114
|
+
for (const [hostname, entry] of this.served)
|
|
115
|
+
entry.gateway.started(`${scheme}://${hostname}`);
|
|
116
|
+
}
|
|
117
|
+
/** Reads the registry again; reloads never overlap, and each is reported as one line. */
|
|
118
|
+
reload() {
|
|
119
|
+
const next = this.queue.then(() => this.load());
|
|
120
|
+
this.queue = next.catch(() => undefined);
|
|
121
|
+
return next;
|
|
122
|
+
}
|
|
123
|
+
/**
|
|
124
|
+
* Stops every gateway, the draining ones included, and closes them: the
|
|
125
|
+
* draining ones first, so the head a journal persists last is the one the
|
|
126
|
+
* live gateway links on.
|
|
127
|
+
*/
|
|
128
|
+
async close(signal = "SHUTDOWN") {
|
|
129
|
+
this.closed = true;
|
|
130
|
+
for (const timer of this.timers)
|
|
131
|
+
clearTimeout(timer);
|
|
132
|
+
this.timers.clear();
|
|
133
|
+
const draining = [...this.draining].map((entry) => entry.gateway);
|
|
134
|
+
const served = [...this.served.values()].map((entry) => entry.gateway);
|
|
135
|
+
this.served = new Map();
|
|
136
|
+
this.draining.clear();
|
|
137
|
+
if (this.scheme !== null) {
|
|
138
|
+
for (const gateway of [...draining, ...served])
|
|
139
|
+
gateway.stopped(signal);
|
|
140
|
+
}
|
|
141
|
+
await Promise.all(draining.map((gateway) => gateway.close()));
|
|
142
|
+
await Promise.all(served.map((gateway) => gateway.close()));
|
|
143
|
+
}
|
|
144
|
+
async load() {
|
|
145
|
+
let registry;
|
|
146
|
+
let revision = null;
|
|
147
|
+
try {
|
|
148
|
+
const text = this.options.readFile(this.options.registryPath);
|
|
149
|
+
if (text === null)
|
|
150
|
+
throw new TenantRegistryError("REGISTRY_UNREADABLE");
|
|
151
|
+
revision = shortDigest(registryRevision(text));
|
|
152
|
+
registry = parseTenantRegistry(text);
|
|
153
|
+
}
|
|
154
|
+
catch (error) {
|
|
155
|
+
this.refusal =
|
|
156
|
+
error instanceof TenantRegistryError
|
|
157
|
+
? error
|
|
158
|
+
: new TenantRegistryError("REGISTRY_UNREADABLE");
|
|
159
|
+
return this.report({
|
|
160
|
+
event: "TENANT_REGISTRY_REFUSED",
|
|
161
|
+
code: this.refusal.message,
|
|
162
|
+
revision,
|
|
163
|
+
served: this.served.size,
|
|
164
|
+
built: [],
|
|
165
|
+
kept: this.served.size,
|
|
166
|
+
rekeyed: [],
|
|
167
|
+
retired: 0,
|
|
168
|
+
failed: [],
|
|
169
|
+
});
|
|
170
|
+
}
|
|
171
|
+
this.refusal = null;
|
|
172
|
+
this.currentDomain = registry.domain;
|
|
173
|
+
const next = new Map();
|
|
174
|
+
const built = [];
|
|
175
|
+
const fresh = [];
|
|
176
|
+
// Each rebuilt gateway and the one it replaces, which hands over at the swap.
|
|
177
|
+
const handovers = [];
|
|
178
|
+
const rekeyed = [];
|
|
179
|
+
const failed = [];
|
|
180
|
+
const byId = new Map([...this.served.values()].map((entry) => [entry.id, entry.gateway]));
|
|
181
|
+
let kept = 0;
|
|
182
|
+
for (const tenant of registry.tenants) {
|
|
183
|
+
const hostname = tenantHostname(registry, tenant);
|
|
184
|
+
const fingerprint = tenantFingerprint(registry, tenant);
|
|
185
|
+
const current = this.served.get(hostname);
|
|
186
|
+
const unchanged = current?.fingerprint === fingerprint;
|
|
187
|
+
let failure = null;
|
|
188
|
+
if (!unchanged) {
|
|
189
|
+
try {
|
|
190
|
+
// A rebuilt tenant's gateway takes up the chains its old one links
|
|
191
|
+
// on, so its evidence goes on in one sequence, never from genesis.
|
|
192
|
+
// The old one is the tenant's, whatever its host: at another when
|
|
193
|
+
// the domain changed, or still draining when the tenant was
|
|
194
|
+
// removed and added back.
|
|
195
|
+
const predecessor = byId.get(tenant.id) ?? this.drainingFor(tenant.id);
|
|
196
|
+
const gateway = await this.build(registry, tenant, predecessor);
|
|
197
|
+
next.set(hostname, { id: tenant.id, fingerprint, gateway });
|
|
198
|
+
built.push(tenant.id);
|
|
199
|
+
fresh.push([hostname, gateway]);
|
|
200
|
+
if (predecessor !== undefined)
|
|
201
|
+
handovers.push([gateway, predecessor]);
|
|
202
|
+
continue;
|
|
203
|
+
}
|
|
204
|
+
catch (error) {
|
|
205
|
+
failure = error;
|
|
206
|
+
}
|
|
207
|
+
}
|
|
208
|
+
if (current !== undefined) {
|
|
209
|
+
// The gateway it had: unchanged but for its keys, or kept because its
|
|
210
|
+
// new entry cannot be built. Either way it admits, from now on, only
|
|
211
|
+
// keys the entry lists.
|
|
212
|
+
const keys = TenantHost.rekey(current.gateway, TenantHost.keyDigests(tenant));
|
|
213
|
+
failure ??= keys.error;
|
|
214
|
+
if (keys.changed)
|
|
215
|
+
rekeyed.push(tenant.id);
|
|
216
|
+
if (keys.served) {
|
|
217
|
+
next.set(hostname, current);
|
|
218
|
+
if (unchanged)
|
|
219
|
+
kept += 1;
|
|
220
|
+
}
|
|
221
|
+
}
|
|
222
|
+
if (failure !== null)
|
|
223
|
+
failed.push({ tenant: tenant.id, code: TenantHost.codeOf(failure) });
|
|
224
|
+
}
|
|
225
|
+
this.failing = failed.map((entry) => entry.tenant);
|
|
226
|
+
const live = new Set([...next.values()].map((entry) => entry.gateway));
|
|
227
|
+
const retired = [...this.served.values()].filter((entry) => !live.has(entry.gateway));
|
|
228
|
+
if (this.closed) {
|
|
229
|
+
await Promise.all([...next.values()].map((entry) => entry.gateway.close()));
|
|
230
|
+
}
|
|
231
|
+
else {
|
|
232
|
+
this.served = next;
|
|
233
|
+
if (next.size === registry.tenants.length)
|
|
234
|
+
this.everyTenantServedAt ??= this.clock();
|
|
235
|
+
// The replacement persists the chains' heads and looks at the upstream's
|
|
236
|
+
// proof from now on, not the gateway it replaced, which links on the
|
|
237
|
+
// chains only until it has drained. It takes the proof as it stands at
|
|
238
|
+
// this swap, so a look the old one finished during the builds counts.
|
|
239
|
+
for (const [gateway, predecessor] of handovers)
|
|
240
|
+
gateway.takeOver(predecessor);
|
|
241
|
+
for (const entry of retired)
|
|
242
|
+
this.drain(entry);
|
|
243
|
+
for (const entry of next.values()) {
|
|
244
|
+
entry.gateway.builtFrom({ revision, entry: shortDigest(`sha256:${entry.fingerprint}`) });
|
|
245
|
+
}
|
|
246
|
+
}
|
|
247
|
+
const report = this.report({
|
|
248
|
+
event: "TENANT_REGISTRY_LOADED",
|
|
249
|
+
code: null,
|
|
250
|
+
revision,
|
|
251
|
+
served: next.size,
|
|
252
|
+
built,
|
|
253
|
+
kept,
|
|
254
|
+
rekeyed,
|
|
255
|
+
retired: retired.length,
|
|
256
|
+
failed,
|
|
257
|
+
});
|
|
258
|
+
const scheme = this.scheme;
|
|
259
|
+
if (scheme !== null && !this.closed) {
|
|
260
|
+
for (const [hostname, gateway] of fresh)
|
|
261
|
+
gateway.started(`${scheme}://${hostname}`);
|
|
262
|
+
}
|
|
263
|
+
return report;
|
|
264
|
+
}
|
|
265
|
+
/**
|
|
266
|
+
* Makes a kept gateway admit exactly the keys its tenant's entry lists now,
|
|
267
|
+
* in place and at once. Digests it refuses (malformed, repeated) leave it
|
|
268
|
+
* only the keys it already admits that the entry still lists, and none of
|
|
269
|
+
* those means it is not served: a key the registry dropped is never left
|
|
270
|
+
* admitted because the rest of an entry could not be applied.
|
|
271
|
+
*/
|
|
272
|
+
static rekey(gateway, digests) {
|
|
273
|
+
const before = gateway.tenantKeys;
|
|
274
|
+
if (before.length === digests.length && before.every((digest) => digests.includes(digest))) {
|
|
275
|
+
return { changed: false, served: true, error: null };
|
|
276
|
+
}
|
|
277
|
+
try {
|
|
278
|
+
gateway.admitKeys(digests);
|
|
279
|
+
return { changed: true, served: true, error: null };
|
|
280
|
+
}
|
|
281
|
+
catch (error) {
|
|
282
|
+
const still = before.filter((digest) => digests.includes(digest));
|
|
283
|
+
if (still.length === 0)
|
|
284
|
+
return { changed: false, served: false, error };
|
|
285
|
+
gateway.admitKeys(still);
|
|
286
|
+
return { changed: still.length !== before.length, served: true, error };
|
|
287
|
+
}
|
|
288
|
+
}
|
|
289
|
+
/** The newest of a tenant's gateways still draining: the only one that may still persist its heads. */
|
|
290
|
+
drainingFor(id) {
|
|
291
|
+
let last;
|
|
292
|
+
for (const entry of this.draining)
|
|
293
|
+
if (entry.id === id)
|
|
294
|
+
last = entry.gateway;
|
|
295
|
+
return last;
|
|
296
|
+
}
|
|
297
|
+
/**
|
|
298
|
+
* One tenant's hosted gateway, from its entry, the shared environment and
|
|
299
|
+
* its own key file; continuing the gateway it replaces, when there is one.
|
|
300
|
+
*/
|
|
301
|
+
async build(registry, tenant, replacing) {
|
|
302
|
+
const env = TenantHost.tenantEnvironment(this.options.env, tenant, {
|
|
303
|
+
upstreamProof: this.options.requireUpstreamProof === true,
|
|
304
|
+
});
|
|
305
|
+
const rateLimit = tenant.rateLimit ?? registry.rateLimit;
|
|
306
|
+
const config = GatewayConfigLoader.load({
|
|
307
|
+
flags: { json: true },
|
|
308
|
+
env,
|
|
309
|
+
file: {
|
|
310
|
+
version: 1,
|
|
311
|
+
...(rateLimit === undefined ? {} : { gateway: { rateLimit } }),
|
|
312
|
+
...(tenant.interception === undefined ? {} : { interception: tenant.interception }),
|
|
313
|
+
...(registry.evidenceDir === undefined
|
|
314
|
+
? {}
|
|
315
|
+
: { evidence: { journalDir: join(registry.evidenceDir, tenant.id) } }),
|
|
316
|
+
},
|
|
317
|
+
credentials: null,
|
|
318
|
+
version: this.options.version ?? "0.0.0",
|
|
319
|
+
});
|
|
320
|
+
const create = this.options.createGateway ?? Gateway.create.bind(Gateway);
|
|
321
|
+
return await create(config, {
|
|
322
|
+
...(this.options.dependencies ?? {}),
|
|
323
|
+
env,
|
|
324
|
+
io: TenantHost.taggedIo(this.options.io, tenant.id),
|
|
325
|
+
...(this.options.version === undefined ? {} : { version: this.options.version }),
|
|
326
|
+
...(replacing === undefined ? {} : { continues: replacing.continuation() }),
|
|
327
|
+
});
|
|
328
|
+
}
|
|
329
|
+
/**
|
|
330
|
+
* The environment a tenant's gateway runs in: the shared settings, its own
|
|
331
|
+
* entry, and the host's own settings for every tenant.
|
|
332
|
+
*/
|
|
333
|
+
static tenantEnvironment(host, tenant, settings = {}) {
|
|
334
|
+
const env = {};
|
|
335
|
+
for (const name of SHARED_ENVIRONMENT) {
|
|
336
|
+
const value = host[name];
|
|
337
|
+
if (value !== undefined)
|
|
338
|
+
env[name] = value;
|
|
339
|
+
}
|
|
340
|
+
return {
|
|
341
|
+
...env,
|
|
342
|
+
AGENTSAFE_HOSTED_GATEWAY: "true",
|
|
343
|
+
AGENTSAFE_HOSTED_TENANT: tenant.id,
|
|
344
|
+
AGENTSAFE_MODE: "shadow",
|
|
345
|
+
AGENTSAFE_UPSTREAM: tenant.upstream,
|
|
346
|
+
AGENTSAFE_TENANT_KEY_DIGESTS: TenantHost.keyDigests(tenant).join(","),
|
|
347
|
+
// The tenant's own timeout wins over the host's.
|
|
348
|
+
...(tenant.upstreamTimeoutMs === undefined
|
|
349
|
+
? {}
|
|
350
|
+
: { AGENTSAFE_UPSTREAM_TIMEOUT_MS: String(tenant.upstreamTimeoutMs) }),
|
|
351
|
+
DECIONIS_TENANT_ID: tenant.workspace.tenantId,
|
|
352
|
+
DECIONIS_API_KEY_FILE: tenant.workspace.apiKeyFile,
|
|
353
|
+
// The proof binds the tenant's id, its workspace and its upstream's
|
|
354
|
+
// origin, all read from the entry above: no field of its own.
|
|
355
|
+
...(settings.upstreamProof === true ? { AGENTSAFE_UPSTREAM_PROOF_REQUIRED: "true" } : {}),
|
|
356
|
+
};
|
|
357
|
+
}
|
|
358
|
+
/**
|
|
359
|
+
* A tenant's key digests as its gateway's loader reads them: split at
|
|
360
|
+
* commas, trimmed, and without empty values. A build and an in-place rekey
|
|
361
|
+
* both start from these, so a reload of an entry the build admitted admits
|
|
362
|
+
* the same keys, and never refuses them.
|
|
363
|
+
*/
|
|
364
|
+
static keyDigests(tenant) {
|
|
365
|
+
return tenant.tenantKeyDigests
|
|
366
|
+
.join(",")
|
|
367
|
+
.split(",")
|
|
368
|
+
.map((digest) => digest.trim())
|
|
369
|
+
.filter((digest) => digest !== "");
|
|
370
|
+
}
|
|
371
|
+
/**
|
|
372
|
+
* The tenant's own output: every line a tenant's gateway writes names its
|
|
373
|
+
* tenant, so one process's stream can be read, retained and deleted per
|
|
374
|
+
* tenant. A chained line already carries `tenant` in its envelope, covered
|
|
375
|
+
* by its hash, and is passed through untouched: adding anything to it
|
|
376
|
+
* would break the chain. Any other JSON line gets `tenant` first; anything
|
|
377
|
+
* else is wrapped.
|
|
378
|
+
*/
|
|
379
|
+
static taggedIo(io, tenant) {
|
|
380
|
+
const tag = (line) => {
|
|
381
|
+
let parsed;
|
|
382
|
+
try {
|
|
383
|
+
parsed = JSON.parse(line);
|
|
384
|
+
}
|
|
385
|
+
catch {
|
|
386
|
+
return JSON.stringify({ tenant, line });
|
|
387
|
+
}
|
|
388
|
+
if (typeof parsed !== "object" || parsed === null || Array.isArray(parsed)) {
|
|
389
|
+
return JSON.stringify({ tenant, line });
|
|
390
|
+
}
|
|
391
|
+
if ("tenant" in parsed)
|
|
392
|
+
return line;
|
|
393
|
+
return Object.keys(parsed).length === 0
|
|
394
|
+
? JSON.stringify({ tenant, line })
|
|
395
|
+
: `{"tenant":${JSON.stringify(tenant)},${line.trimStart().slice(1)}`;
|
|
396
|
+
};
|
|
397
|
+
return {
|
|
398
|
+
stdout: (line) => io.stdout(tag(line)),
|
|
399
|
+
stderr: (line) => io.stderr(tag(line)),
|
|
400
|
+
color: false,
|
|
401
|
+
};
|
|
402
|
+
}
|
|
403
|
+
/** Why a tenant's gateway could not be built: a code and the setting, never a value. */
|
|
404
|
+
static codeOf(error) {
|
|
405
|
+
if (error instanceof GatewayConfigError)
|
|
406
|
+
return `${error.code}:${error.setting}`;
|
|
407
|
+
if (error instanceof SecretError)
|
|
408
|
+
return `${error.code}:${error.secret}`;
|
|
409
|
+
return "TENANT_BUILD_FAILED";
|
|
410
|
+
}
|
|
411
|
+
/**
|
|
412
|
+
* Lets a replaced or removed gateway finish what it has in flight, then
|
|
413
|
+
* stops it, so its shadow report counts what settled while it drained.
|
|
414
|
+
*/
|
|
415
|
+
drain(entry) {
|
|
416
|
+
this.draining.add(entry);
|
|
417
|
+
const timer = setTimeout(() => {
|
|
418
|
+
this.timers.delete(timer);
|
|
419
|
+
this.draining.delete(entry);
|
|
420
|
+
if (this.scheme !== null)
|
|
421
|
+
entry.gateway.stopped("RELOAD");
|
|
422
|
+
void entry.gateway.close();
|
|
423
|
+
}, this.options.drainMs ?? DEFAULT_DRAIN_MS);
|
|
424
|
+
timer.unref();
|
|
425
|
+
this.timers.add(timer);
|
|
426
|
+
}
|
|
427
|
+
report(report) {
|
|
428
|
+
this.options.io.stdout(JSON.stringify(report));
|
|
429
|
+
return report;
|
|
430
|
+
}
|
|
431
|
+
}
|
|
432
|
+
//# sourceMappingURL=TenantHost.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"TenantHost.js","sourceRoot":"","sources":["../../src/hosted/TenantHost.ts"],"names":[],"mappings":"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"}
|
|
@@ -0,0 +1,73 @@
|
|
|
1
|
+
import { z } from "zod";
|
|
2
|
+
export declare const TENANT_REGISTRY_VERSION = 1;
|
|
3
|
+
/** The most tenants one host serves; a registry over it is refused, not truncated. */
|
|
4
|
+
export declare const MAX_TENANTS = 1000;
|
|
5
|
+
declare const TenantSchema: z.ZodObject<{
|
|
6
|
+
id: z.ZodString;
|
|
7
|
+
upstream: z.ZodString;
|
|
8
|
+
tenantKeyDigests: z.ZodArray<z.ZodString>;
|
|
9
|
+
workspace: z.ZodObject<{
|
|
10
|
+
tenantId: z.ZodString;
|
|
11
|
+
apiKeyFile: z.ZodString;
|
|
12
|
+
}, z.core.$strict>;
|
|
13
|
+
rateLimit: z.ZodOptional<z.ZodObject<{
|
|
14
|
+
requestsPerSecond: z.ZodNumber;
|
|
15
|
+
burst: z.ZodNumber;
|
|
16
|
+
}, z.core.$strict>>;
|
|
17
|
+
upstreamTimeoutMs: z.ZodOptional<z.ZodNumber>;
|
|
18
|
+
interception: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
|
|
19
|
+
}, z.core.$strict>;
|
|
20
|
+
export declare const TenantRegistrySchema: z.ZodObject<{
|
|
21
|
+
version: z.ZodLiteral<1>;
|
|
22
|
+
domain: z.ZodString;
|
|
23
|
+
evidenceDir: z.ZodOptional<z.ZodString>;
|
|
24
|
+
rateLimit: z.ZodOptional<z.ZodObject<{
|
|
25
|
+
requestsPerSecond: z.ZodNumber;
|
|
26
|
+
burst: z.ZodNumber;
|
|
27
|
+
}, z.core.$strict>>;
|
|
28
|
+
tenants: z.ZodArray<z.ZodObject<{
|
|
29
|
+
id: z.ZodString;
|
|
30
|
+
upstream: z.ZodString;
|
|
31
|
+
tenantKeyDigests: z.ZodArray<z.ZodString>;
|
|
32
|
+
workspace: z.ZodObject<{
|
|
33
|
+
tenantId: z.ZodString;
|
|
34
|
+
apiKeyFile: z.ZodString;
|
|
35
|
+
}, z.core.$strict>;
|
|
36
|
+
rateLimit: z.ZodOptional<z.ZodObject<{
|
|
37
|
+
requestsPerSecond: z.ZodNumber;
|
|
38
|
+
burst: z.ZodNumber;
|
|
39
|
+
}, z.core.$strict>>;
|
|
40
|
+
upstreamTimeoutMs: z.ZodOptional<z.ZodNumber>;
|
|
41
|
+
interception: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
|
|
42
|
+
}, z.core.$strict>>;
|
|
43
|
+
}, z.core.$strict>;
|
|
44
|
+
export type TenantEntry = z.infer<typeof TenantSchema>;
|
|
45
|
+
export type TenantRegistry = z.infer<typeof TenantRegistrySchema>;
|
|
46
|
+
/** A registry that cannot be served: the code, and where it went wrong, never a value from the file. */
|
|
47
|
+
export declare class TenantRegistryError extends Error {
|
|
48
|
+
readonly code: "REGISTRY_UNREADABLE" | "REGISTRY_INVALID" | "REGISTRY_DUPLICATE_TENANT";
|
|
49
|
+
readonly where: string | null;
|
|
50
|
+
constructor(code: "REGISTRY_UNREADABLE" | "REGISTRY_INVALID" | "REGISTRY_DUPLICATE_TENANT", where?: string | null);
|
|
51
|
+
}
|
|
52
|
+
/**
|
|
53
|
+
* The tenant registry the operator mounts, parsed and checked whole: YAML or
|
|
54
|
+
* JSON, `version: 1`, one domain, and each tenant with its label, upstream,
|
|
55
|
+
* key digests and workspace. What each tenant's gateway makes of its entry
|
|
56
|
+
* (a public https upstream, well-formed digests, a valid interception
|
|
57
|
+
* section) is checked again by the gateway's own loader when it is built.
|
|
58
|
+
*/
|
|
59
|
+
export declare function parseTenantRegistry(text: string): TenantRegistry;
|
|
60
|
+
/** The hostname a tenant is served at. */
|
|
61
|
+
export declare function tenantHostname(registry: TenantRegistry, tenant: TenantEntry): string;
|
|
62
|
+
/**
|
|
63
|
+
* A digest of everything that shapes a tenant's gateway: its entry and the
|
|
64
|
+
* registry-wide settings it inherits. A reload rebuilds a tenant's gateway
|
|
65
|
+
* only when this changes, so an edit to one tenant never interrupts another.
|
|
66
|
+
* The tenant's key digests are not in it: a gateway takes new ones in place,
|
|
67
|
+
* so a rotation or a revocation rebuilds nothing.
|
|
68
|
+
*/
|
|
69
|
+
export declare function tenantFingerprint(registry: TenantRegistry, tenant: TenantEntry): string;
|
|
70
|
+
/** The registry's text, as read, as a digest: the revision a host reports it loaded. */
|
|
71
|
+
export declare function registryRevision(text: string): string;
|
|
72
|
+
export {};
|
|
73
|
+
//# sourceMappingURL=TenantRegistry.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"TenantRegistry.d.ts","sourceRoot":"","sources":["../../src/hosted/TenantRegistry.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAGxB,eAAO,MAAM,uBAAuB,IAAI,CAAC;AACzC,sFAAsF;AACtF,eAAO,MAAM,WAAW,OAAQ,CAAC;AAcjC,QAAA,MAAM,YAAY;;;;;;;;;;;;;;kBAwBhB,CAAC;AAEH,eAAO,MAAM,oBAAoB;;;;;;;;;;;;;;;;;;;;;;;kBAc/B,CAAC;AAEH,MAAM,MAAM,WAAW,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,YAAY,CAAC,CAAC;AACvD,MAAM,MAAM,cAAc,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,oBAAoB,CAAC,CAAC;AAElE,wGAAwG;AACxG,qBAAa,mBAAoB,SAAQ,KAAK;aAE1B,IAAI,EAAE,qBAAqB,GAAG,kBAAkB,GAAG,2BAA2B;aAC9E,KAAK,EAAE,MAAM,GAAG,IAAI;gBADpB,IAAI,EAAE,qBAAqB,GAAG,kBAAkB,GAAG,2BAA2B,EAC9E,KAAK,GAAE,MAAM,GAAG,IAAW;CAK9C;AAED;;;;;;GAMG;AACH,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,MAAM,GAAG,cAAc,CAqBhE;AAED,0CAA0C;AAC1C,wBAAgB,cAAc,CAAC,QAAQ,EAAE,cAAc,EAAE,MAAM,EAAE,WAAW,GAAG,MAAM,CAEpF;AAED;;;;;;GAMG;AACH,wBAAgB,iBAAiB,CAAC,QAAQ,EAAE,cAAc,EAAE,MAAM,EAAE,WAAW,GAAG,MAAM,CAWvF;AAED,wFAAwF;AACxF,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAErD"}
|
|
@@ -0,0 +1,123 @@
|
|
|
1
|
+
import { createHash } from "node:crypto";
|
|
2
|
+
import { isAbsolute } from "node:path";
|
|
3
|
+
import { parse as parseYaml } from "yaml";
|
|
4
|
+
import { z } from "zod";
|
|
5
|
+
import { CanonicalIntentHasher } from "@decionis/agent-safe-pipeline";
|
|
6
|
+
export const TENANT_REGISTRY_VERSION = 1;
|
|
7
|
+
/** The most tenants one host serves; a registry over it is refused, not truncated. */
|
|
8
|
+
export const MAX_TENANTS = 1_000;
|
|
9
|
+
/** A DNS label: what a tenant id becomes as the leftmost part of its hostname. */
|
|
10
|
+
const LABEL = /^[a-z0-9](?:[a-z0-9-]{0,61}[a-z0-9])?$/;
|
|
11
|
+
/** A lower-case hostname of at least two labels. */
|
|
12
|
+
const DOMAIN = /^(?:[a-z0-9](?:[a-z0-9-]{0,61}[a-z0-9])?\.)+[a-z0-9](?:[a-z0-9-]{0,61}[a-z0-9])?$/;
|
|
13
|
+
/** Labels a tenant may not take: they name the operator's own hosts. */
|
|
14
|
+
const RESERVED_LABELS = new Set(["www", "api", "status", "admin", "console"]);
|
|
15
|
+
const RateLimitSchema = z.strictObject({
|
|
16
|
+
requestsPerSecond: z.number().positive().max(10_000),
|
|
17
|
+
burst: z.number().int().min(1).max(100_000),
|
|
18
|
+
});
|
|
19
|
+
const TenantSchema = z.strictObject({
|
|
20
|
+
/** The tenant's label; it is served at `{id}.{domain}`. */
|
|
21
|
+
id: z
|
|
22
|
+
.string()
|
|
23
|
+
.regex(LABEL, "a lower-case DNS label")
|
|
24
|
+
.refine((id) => !RESERVED_LABELS.has(id), "a label the operator keeps for itself"),
|
|
25
|
+
upstream: z.string().url(),
|
|
26
|
+
tenantKeyDigests: z.array(z.string()).min(1).max(2),
|
|
27
|
+
workspace: z.strictObject({
|
|
28
|
+
/** The Decionis workspace the tenant's evaluations run in. */
|
|
29
|
+
tenantId: z.string().uuid(),
|
|
30
|
+
/** The mounted file holding the workspace key; the key itself is never in the registry. */
|
|
31
|
+
apiKeyFile: z
|
|
32
|
+
.string()
|
|
33
|
+
.min(1)
|
|
34
|
+
.max(500)
|
|
35
|
+
.refine((path) => isAbsolute(path), "an absolute path"),
|
|
36
|
+
}),
|
|
37
|
+
/** This tenant's rate, per process; the registry's `rateLimit` otherwise. */
|
|
38
|
+
rateLimit: RateLimitSchema.optional(),
|
|
39
|
+
/** How long this tenant's upstream may take to answer, in ms; the host's own setting otherwise. */
|
|
40
|
+
upstreamTimeoutMs: z.number().int().positive().max(120_000).optional(),
|
|
41
|
+
/** The tenant's `interception` section, as `agentsafe.yaml` has it; validated by the gateway's loader. */
|
|
42
|
+
interception: z.record(z.string(), z.unknown()).optional(),
|
|
43
|
+
});
|
|
44
|
+
export const TenantRegistrySchema = z.strictObject({
|
|
45
|
+
version: z.literal(TENANT_REGISTRY_VERSION),
|
|
46
|
+
/** The domain every tenant is a host under, e.g. `decionisedge.com`. */
|
|
47
|
+
domain: z.string().regex(DOMAIN, "a lower-case hostname"),
|
|
48
|
+
/** Where each tenant's evidence is kept, one directory per tenant; none when absent. */
|
|
49
|
+
evidenceDir: z
|
|
50
|
+
.string()
|
|
51
|
+
.min(1)
|
|
52
|
+
.max(500)
|
|
53
|
+
.refine((path) => isAbsolute(path), "an absolute path")
|
|
54
|
+
.optional(),
|
|
55
|
+
/** The rate every tenant without its own is admitted at; the hosted default when absent. */
|
|
56
|
+
rateLimit: RateLimitSchema.optional(),
|
|
57
|
+
tenants: z.array(TenantSchema).max(MAX_TENANTS),
|
|
58
|
+
});
|
|
59
|
+
/** A registry that cannot be served: the code, and where it went wrong, never a value from the file. */
|
|
60
|
+
export class TenantRegistryError extends Error {
|
|
61
|
+
code;
|
|
62
|
+
where;
|
|
63
|
+
constructor(code, where = null) {
|
|
64
|
+
super(where === null ? code : `${code}: ${where}`);
|
|
65
|
+
this.code = code;
|
|
66
|
+
this.where = where;
|
|
67
|
+
this.name = "TenantRegistryError";
|
|
68
|
+
}
|
|
69
|
+
}
|
|
70
|
+
/**
|
|
71
|
+
* The tenant registry the operator mounts, parsed and checked whole: YAML or
|
|
72
|
+
* JSON, `version: 1`, one domain, and each tenant with its label, upstream,
|
|
73
|
+
* key digests and workspace. What each tenant's gateway makes of its entry
|
|
74
|
+
* (a public https upstream, well-formed digests, a valid interception
|
|
75
|
+
* section) is checked again by the gateway's own loader when it is built.
|
|
76
|
+
*/
|
|
77
|
+
export function parseTenantRegistry(text) {
|
|
78
|
+
let raw;
|
|
79
|
+
try {
|
|
80
|
+
raw = parseYaml(text);
|
|
81
|
+
}
|
|
82
|
+
catch {
|
|
83
|
+
throw new TenantRegistryError("REGISTRY_UNREADABLE");
|
|
84
|
+
}
|
|
85
|
+
const parsed = TenantRegistrySchema.safeParse(raw);
|
|
86
|
+
if (!parsed.success) {
|
|
87
|
+
const issue = parsed.error.issues[0];
|
|
88
|
+
throw new TenantRegistryError("REGISTRY_INVALID", issue === undefined ? null : issue.path.join(".") || "(root)");
|
|
89
|
+
}
|
|
90
|
+
const seen = new Set();
|
|
91
|
+
for (const tenant of parsed.data.tenants) {
|
|
92
|
+
if (seen.has(tenant.id))
|
|
93
|
+
throw new TenantRegistryError("REGISTRY_DUPLICATE_TENANT", tenant.id);
|
|
94
|
+
seen.add(tenant.id);
|
|
95
|
+
}
|
|
96
|
+
return parsed.data;
|
|
97
|
+
}
|
|
98
|
+
/** The hostname a tenant is served at. */
|
|
99
|
+
export function tenantHostname(registry, tenant) {
|
|
100
|
+
return `${tenant.id}.${registry.domain}`;
|
|
101
|
+
}
|
|
102
|
+
/**
|
|
103
|
+
* A digest of everything that shapes a tenant's gateway: its entry and the
|
|
104
|
+
* registry-wide settings it inherits. A reload rebuilds a tenant's gateway
|
|
105
|
+
* only when this changes, so an edit to one tenant never interrupts another.
|
|
106
|
+
* The tenant's key digests are not in it: a gateway takes new ones in place,
|
|
107
|
+
* so a rotation or a revocation rebuilds nothing.
|
|
108
|
+
*/
|
|
109
|
+
export function tenantFingerprint(registry, tenant) {
|
|
110
|
+
const shape = Object.fromEntries(Object.entries(tenant).filter(([field]) => field !== "tenantKeyDigests"));
|
|
111
|
+
const canonical = CanonicalIntentHasher.stringify({
|
|
112
|
+
domain: registry.domain,
|
|
113
|
+
evidenceDir: registry.evidenceDir ?? null,
|
|
114
|
+
rateLimit: registry.rateLimit ?? null,
|
|
115
|
+
tenant: shape,
|
|
116
|
+
});
|
|
117
|
+
return createHash("sha256").update(canonical, "utf8").digest("hex");
|
|
118
|
+
}
|
|
119
|
+
/** The registry's text, as read, as a digest: the revision a host reports it loaded. */
|
|
120
|
+
export function registryRevision(text) {
|
|
121
|
+
return `sha256:${createHash("sha256").update(text, "utf8").digest("hex")}`;
|
|
122
|
+
}
|
|
123
|
+
//# sourceMappingURL=TenantRegistry.js.map
|