@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.
Files changed (271) hide show
  1. package/README.md +135 -20
  2. package/dist/Cli.js +19 -0
  3. package/dist/Cli.js.map +1 -1
  4. package/dist/Index.d.ts +10 -4
  5. package/dist/Index.d.ts.map +1 -1
  6. package/dist/Index.js +8 -2
  7. package/dist/Index.js.map +1 -1
  8. package/dist/TrustedExecutor.d.ts.map +1 -1
  9. package/dist/TrustedExecutor.js +1 -0
  10. package/dist/TrustedExecutor.js.map +1 -1
  11. package/dist/adapters/AdapterActionHandler.d.ts.map +1 -1
  12. package/dist/adapters/AdapterActionHandler.js +8 -4
  13. package/dist/adapters/AdapterActionHandler.js.map +1 -1
  14. package/dist/adapters/EffectAdapter.d.ts +6 -1
  15. package/dist/adapters/EffectAdapter.d.ts.map +1 -1
  16. package/dist/adapters/EffectAdapter.js +7 -1
  17. package/dist/adapters/EffectAdapter.js.map +1 -1
  18. package/dist/adapters/banking/CoreBankingHttpAdapter.d.ts.map +1 -1
  19. package/dist/adapters/banking/CoreBankingHttpAdapter.js +4 -4
  20. package/dist/adapters/banking/CoreBankingHttpAdapter.js.map +1 -1
  21. package/dist/adapters/cards/CardAuthorizationMatcher.d.ts +44 -0
  22. package/dist/adapters/cards/CardAuthorizationMatcher.d.ts.map +1 -0
  23. package/dist/adapters/cards/CardAuthorizationMatcher.js +39 -0
  24. package/dist/adapters/cards/CardAuthorizationMatcher.js.map +1 -0
  25. package/dist/adapters/cards/CardEffect.d.ts +52 -0
  26. package/dist/adapters/cards/CardEffect.d.ts.map +1 -0
  27. package/dist/adapters/cards/CardEffect.js +117 -0
  28. package/dist/adapters/cards/CardEffect.js.map +1 -0
  29. package/dist/adapters/cards/CardHandlers.d.ts +15 -0
  30. package/dist/adapters/cards/CardHandlers.d.ts.map +1 -0
  31. package/dist/adapters/cards/CardHandlers.js +26 -0
  32. package/dist/adapters/cards/CardHandlers.js.map +1 -0
  33. package/dist/adapters/cards/CardPurchase.d.ts +61 -0
  34. package/dist/adapters/cards/CardPurchase.d.ts.map +1 -0
  35. package/dist/adapters/cards/CardPurchase.js +116 -0
  36. package/dist/adapters/cards/CardPurchase.js.map +1 -0
  37. package/dist/adapters/cards/HeldCardGrants.d.ts +70 -0
  38. package/dist/adapters/cards/HeldCardGrants.d.ts.map +1 -0
  39. package/dist/adapters/cards/HeldCardGrants.js +79 -0
  40. package/dist/adapters/cards/HeldCardGrants.js.map +1 -0
  41. package/dist/adapters/cards/Pan.d.ts +17 -0
  42. package/dist/adapters/cards/Pan.d.ts.map +1 -0
  43. package/dist/adapters/cards/Pan.js +52 -0
  44. package/dist/adapters/cards/Pan.js.map +1 -0
  45. package/dist/adapters/mcp/McpGuard.d.ts.map +1 -1
  46. package/dist/adapters/mcp/McpGuard.js +9 -4
  47. package/dist/adapters/mcp/McpGuard.js.map +1 -1
  48. package/dist/audit/HashChain.d.ts +8 -2
  49. package/dist/audit/HashChain.d.ts.map +1 -1
  50. package/dist/audit/HashChain.js +14 -2
  51. package/dist/audit/HashChain.js.map +1 -1
  52. package/dist/cli/Commands.d.ts +1 -1
  53. package/dist/cli/Commands.d.ts.map +1 -1
  54. package/dist/cli/Commands.js +5 -0
  55. package/dist/cli/Commands.js.map +1 -1
  56. package/dist/cli/Edge.d.ts +4 -0
  57. package/dist/cli/Edge.d.ts.map +1 -0
  58. package/dist/cli/Edge.js +250 -0
  59. package/dist/cli/Edge.js.map +1 -0
  60. package/dist/cli/Help.d.ts.map +1 -1
  61. package/dist/cli/Help.js +8 -0
  62. package/dist/cli/Help.js.map +1 -1
  63. package/dist/cli/Host.d.ts +36 -0
  64. package/dist/cli/Host.d.ts.map +1 -0
  65. package/dist/cli/Host.js +247 -0
  66. package/dist/cli/Host.js.map +1 -0
  67. package/dist/cli/TcpBrokerCli.d.ts +4 -0
  68. package/dist/cli/TcpBrokerCli.d.ts.map +1 -0
  69. package/dist/cli/TcpBrokerCli.js +93 -0
  70. package/dist/cli/TcpBrokerCli.js.map +1 -0
  71. package/dist/cli/TcpClientCli.d.ts +16 -0
  72. package/dist/cli/TcpClientCli.d.ts.map +1 -0
  73. package/dist/cli/TcpClientCli.js +175 -0
  74. package/dist/cli/TcpClientCli.js.map +1 -0
  75. package/dist/config/ConfigKeys.d.ts +2 -2
  76. package/dist/config/ConfigKeys.d.ts.map +1 -1
  77. package/dist/config/ConfigKeys.js +19 -0
  78. package/dist/config/ConfigKeys.js.map +1 -1
  79. package/dist/config/ExecutorConfig.d.ts +62 -0
  80. package/dist/config/ExecutorConfig.d.ts.map +1 -1
  81. package/dist/config/ExecutorConfig.js +124 -0
  82. package/dist/config/ExecutorConfig.js.map +1 -1
  83. package/dist/edge/EdgeLicence.d.ts +25 -0
  84. package/dist/edge/EdgeLicence.d.ts.map +1 -0
  85. package/dist/edge/EdgeLicence.js +42 -0
  86. package/dist/edge/EdgeLicence.js.map +1 -0
  87. package/dist/edge/EdgeReplay.d.ts +45 -0
  88. package/dist/edge/EdgeReplay.d.ts.map +1 -0
  89. package/dist/edge/EdgeReplay.js +69 -0
  90. package/dist/edge/EdgeReplay.js.map +1 -0
  91. package/dist/edge/Entitlement.d.ts +57 -0
  92. package/dist/edge/Entitlement.d.ts.map +1 -0
  93. package/dist/edge/Entitlement.js +139 -0
  94. package/dist/edge/Entitlement.js.map +1 -0
  95. package/dist/edge/EntitlementEvaluation.d.ts +66 -0
  96. package/dist/edge/EntitlementEvaluation.d.ts.map +1 -0
  97. package/dist/edge/EntitlementEvaluation.js +74 -0
  98. package/dist/edge/EntitlementEvaluation.js.map +1 -0
  99. package/dist/edge/UsageCount.d.ts +40 -0
  100. package/dist/edge/UsageCount.d.ts.map +1 -0
  101. package/dist/edge/UsageCount.js +140 -0
  102. package/dist/edge/UsageCount.js.map +1 -0
  103. package/dist/edge/UsageKeyRegistration.d.ts +34 -0
  104. package/dist/edge/UsageKeyRegistration.d.ts.map +1 -0
  105. package/dist/edge/UsageKeyRegistration.js +74 -0
  106. package/dist/edge/UsageKeyRegistration.js.map +1 -0
  107. package/dist/edge/UsageMeter.d.ts +89 -0
  108. package/dist/edge/UsageMeter.d.ts.map +1 -0
  109. package/dist/edge/UsageMeter.js +275 -0
  110. package/dist/edge/UsageMeter.js.map +1 -0
  111. package/dist/edge/UsagePeriod.d.ts +23 -0
  112. package/dist/edge/UsagePeriod.d.ts.map +1 -0
  113. package/dist/edge/UsagePeriod.js +31 -0
  114. package/dist/edge/UsagePeriod.js.map +1 -0
  115. package/dist/edge/UsageReport.d.ts +92 -0
  116. package/dist/edge/UsageReport.d.ts.map +1 -0
  117. package/dist/edge/UsageReport.js +153 -0
  118. package/dist/edge/UsageReport.js.map +1 -0
  119. package/dist/edge/UsageTally.d.ts +63 -0
  120. package/dist/edge/UsageTally.d.ts.map +1 -0
  121. package/dist/edge/UsageTally.js +89 -0
  122. package/dist/edge/UsageTally.js.map +1 -0
  123. package/dist/egress/EgressError.d.ts +7 -1
  124. package/dist/egress/EgressError.d.ts.map +1 -1
  125. package/dist/egress/EgressError.js.map +1 -1
  126. package/dist/egress/EgressPolicy.d.ts +16 -3
  127. package/dist/egress/EgressPolicy.d.ts.map +1 -1
  128. package/dist/egress/EgressPolicy.js +33 -3
  129. package/dist/egress/EgressPolicy.js.map +1 -1
  130. package/dist/egress/GuardedFetch.d.ts +38 -1
  131. package/dist/egress/GuardedFetch.d.ts.map +1 -1
  132. package/dist/egress/GuardedFetch.js +52 -7
  133. package/dist/egress/GuardedFetch.js.map +1 -1
  134. package/dist/egress/TcpClient.d.ts +103 -0
  135. package/dist/egress/TcpClient.d.ts.map +1 -0
  136. package/dist/egress/TcpClient.js +490 -0
  137. package/dist/egress/TcpClient.js.map +1 -0
  138. package/dist/egress/TcpControlClient.d.ts +49 -0
  139. package/dist/egress/TcpControlClient.d.ts.map +1 -0
  140. package/dist/egress/TcpControlClient.js +186 -0
  141. package/dist/egress/TcpControlClient.js.map +1 -0
  142. package/dist/gateway/ForwardHandler.d.ts.map +1 -1
  143. package/dist/gateway/ForwardHandler.js +7 -4
  144. package/dist/gateway/ForwardHandler.js.map +1 -1
  145. package/dist/gateway/Gateway.d.ts +190 -10
  146. package/dist/gateway/Gateway.d.ts.map +1 -1
  147. package/dist/gateway/Gateway.js +465 -62
  148. package/dist/gateway/Gateway.js.map +1 -1
  149. package/dist/gateway/GatewayConfig.d.ts +67 -0
  150. package/dist/gateway/GatewayConfig.d.ts.map +1 -1
  151. package/dist/gateway/GatewayConfig.js +149 -2
  152. package/dist/gateway/GatewayConfig.js.map +1 -1
  153. package/dist/gateway/InterceptedRequest.d.ts +9 -2
  154. package/dist/gateway/InterceptedRequest.d.ts.map +1 -1
  155. package/dist/gateway/InterceptedRequest.js +41 -9
  156. package/dist/gateway/InterceptedRequest.js.map +1 -1
  157. package/dist/gateway/RateLimit.d.ts +29 -0
  158. package/dist/gateway/RateLimit.d.ts.map +1 -0
  159. package/dist/gateway/RateLimit.js +33 -0
  160. package/dist/gateway/RateLimit.js.map +1 -0
  161. package/dist/gateway/RefusalSampler.d.ts +28 -0
  162. package/dist/gateway/RefusalSampler.d.ts.map +1 -0
  163. package/dist/gateway/RefusalSampler.js +52 -0
  164. package/dist/gateway/RefusalSampler.js.map +1 -0
  165. package/dist/gateway/RouteTable.d.ts +3 -0
  166. package/dist/gateway/RouteTable.d.ts.map +1 -1
  167. package/dist/gateway/RouteTable.js +44 -7
  168. package/dist/gateway/RouteTable.js.map +1 -1
  169. package/dist/gateway/Upstream.d.ts +26 -0
  170. package/dist/gateway/Upstream.d.ts.map +1 -1
  171. package/dist/gateway/Upstream.js +41 -2
  172. package/dist/gateway/Upstream.js.map +1 -1
  173. package/dist/gateway/UpstreamProof.d.ts +235 -0
  174. package/dist/gateway/UpstreamProof.d.ts.map +1 -0
  175. package/dist/gateway/UpstreamProof.js +375 -0
  176. package/dist/gateway/UpstreamProof.js.map +1 -0
  177. package/dist/handlers/ForwardRequestHandler.d.ts +5 -1
  178. package/dist/handlers/ForwardRequestHandler.d.ts.map +1 -1
  179. package/dist/handlers/ForwardRequestHandler.js +12 -2
  180. package/dist/handlers/ForwardRequestHandler.js.map +1 -1
  181. package/dist/hosted/TenantHost.d.ts +180 -0
  182. package/dist/hosted/TenantHost.d.ts.map +1 -0
  183. package/dist/hosted/TenantHost.js +432 -0
  184. package/dist/hosted/TenantHost.js.map +1 -0
  185. package/dist/hosted/TenantRegistry.d.ts +73 -0
  186. package/dist/hosted/TenantRegistry.d.ts.map +1 -0
  187. package/dist/hosted/TenantRegistry.js +123 -0
  188. package/dist/hosted/TenantRegistry.js.map +1 -0
  189. package/dist/http/ExecutorHttpServer.d.ts +7 -0
  190. package/dist/http/ExecutorHttpServer.d.ts.map +1 -1
  191. package/dist/http/ExecutorHttpServer.js +30 -5
  192. package/dist/http/ExecutorHttpServer.js.map +1 -1
  193. package/dist/http/GatewayHttpServer.d.ts +55 -3
  194. package/dist/http/GatewayHttpServer.d.ts.map +1 -1
  195. package/dist/http/GatewayHttpServer.js +157 -17
  196. package/dist/http/GatewayHttpServer.js.map +1 -1
  197. package/dist/http/RedirectServer.d.ts +26 -0
  198. package/dist/http/RedirectServer.d.ts.map +1 -0
  199. package/dist/http/RedirectServer.js +62 -0
  200. package/dist/http/RedirectServer.js.map +1 -0
  201. package/dist/http/Routes.d.ts +17 -0
  202. package/dist/http/Routes.d.ts.map +1 -1
  203. package/dist/http/Routes.js +21 -0
  204. package/dist/http/Routes.js.map +1 -1
  205. package/dist/http/TcpBroker.d.ts +57 -0
  206. package/dist/http/TcpBroker.d.ts.map +1 -0
  207. package/dist/http/TcpBroker.js +299 -0
  208. package/dist/http/TcpBroker.js.map +1 -0
  209. package/dist/http/TcpHostRelay.d.ts +24 -0
  210. package/dist/http/TcpHostRelay.d.ts.map +1 -0
  211. package/dist/http/TcpHostRelay.js +194 -0
  212. package/dist/http/TcpHostRelay.js.map +1 -0
  213. package/dist/http/TcpRelayStreams.d.ts +24 -0
  214. package/dist/http/TcpRelayStreams.d.ts.map +1 -0
  215. package/dist/http/TcpRelayStreams.js +128 -0
  216. package/dist/http/TcpRelayStreams.js.map +1 -0
  217. package/dist/http/TlsListener.d.ts +3 -1
  218. package/dist/http/TlsListener.d.ts.map +1 -1
  219. package/dist/http/TlsListener.js +7 -2
  220. package/dist/http/TlsListener.js.map +1 -1
  221. package/dist/identity/PrincipalsFile.d.ts +3 -1
  222. package/dist/identity/PrincipalsFile.d.ts.map +1 -1
  223. package/dist/identity/PrincipalsFile.js +1 -0
  224. package/dist/identity/PrincipalsFile.js.map +1 -1
  225. package/dist/incident/Metrics.d.ts +2 -0
  226. package/dist/incident/Metrics.d.ts.map +1 -1
  227. package/dist/incident/Metrics.js +10 -0
  228. package/dist/incident/Metrics.js.map +1 -1
  229. package/dist/incident/SecurityEvents.d.ts +89 -0
  230. package/dist/incident/SecurityEvents.d.ts.map +1 -1
  231. package/dist/incident/SecurityEvents.js +93 -2
  232. package/dist/incident/SecurityEvents.js.map +1 -1
  233. package/dist/journal/ExecutionJournal.d.ts +27 -0
  234. package/dist/journal/ExecutionJournal.d.ts.map +1 -1
  235. package/dist/journal/ExecutionJournal.js +28 -0
  236. package/dist/journal/ExecutionJournal.js.map +1 -1
  237. package/dist/journal/FileExecutionJournal.d.ts +2 -1
  238. package/dist/journal/FileExecutionJournal.d.ts.map +1 -1
  239. package/dist/journal/FileExecutionJournal.js +4 -1
  240. package/dist/journal/FileExecutionJournal.js.map +1 -1
  241. package/dist/journal/InMemoryExecutionJournal.d.ts +2 -1
  242. package/dist/journal/InMemoryExecutionJournal.d.ts.map +1 -1
  243. package/dist/journal/InMemoryExecutionJournal.js +4 -1
  244. package/dist/journal/InMemoryExecutionJournal.js.map +1 -1
  245. package/dist/service/AuthorityClients.d.ts +8 -1
  246. package/dist/service/AuthorityClients.d.ts.map +1 -1
  247. package/dist/service/AuthorityClients.js +33 -5
  248. package/dist/service/AuthorityClients.js.map +1 -1
  249. package/dist/service/EdgeRuntime.d.ts +73 -0
  250. package/dist/service/EdgeRuntime.d.ts.map +1 -0
  251. package/dist/service/EdgeRuntime.js +209 -0
  252. package/dist/service/EdgeRuntime.js.map +1 -0
  253. package/dist/service/EscalationResolver.d.ts +82 -2
  254. package/dist/service/EscalationResolver.d.ts.map +1 -1
  255. package/dist/service/EscalationResolver.js +39 -3
  256. package/dist/service/EscalationResolver.js.map +1 -1
  257. package/dist/service/Requests.d.ts +28 -2
  258. package/dist/service/Requests.d.ts.map +1 -1
  259. package/dist/service/TrustedExecutorService.d.ts +71 -1
  260. package/dist/service/TrustedExecutorService.d.ts.map +1 -1
  261. package/dist/service/TrustedExecutorService.js +461 -27
  262. package/dist/service/TrustedExecutorService.js.map +1 -1
  263. package/dist/tcp/TcpWire.d.ts +18 -0
  264. package/dist/tcp/TcpWire.d.ts.map +1 -0
  265. package/dist/tcp/TcpWire.js +114 -0
  266. package/dist/tcp/TcpWire.js.map +1 -0
  267. package/dist/verify/VerifyAuditChain.d.ts +5 -0
  268. package/dist/verify/VerifyAuditChain.d.ts.map +1 -1
  269. package/dist/verify/VerifyAuditChain.js +20 -4
  270. package/dist/verify/VerifyAuditChain.js.map +1 -1
  271. package/package.json +7 -3
@@ -0,0 +1,375 @@
1
+ import { createHash } from "node:crypto";
2
+ import { EgressError } from "../egress/EgressError.js";
3
+ import { EgressPolicy } from "../egress/EgressPolicy.js";
4
+ import { GuardedFetch } from "../egress/GuardedFetch.js";
5
+ import { SecurityEvents } from "../incident/SecurityEvents.js";
6
+ /**
7
+ * Where an upstream's origin serves its proof: one fixed path, so a token is
8
+ * never part of a URL and an origin that echoes its URL cannot serve one.
9
+ */
10
+ export const UPSTREAM_PROOF_PATH = "/.well-known/agentsafe-upstream";
11
+ /** The label a TXT proof is published under, in front of the upstream's host name. */
12
+ export const UPSTREAM_PROOF_TXT_LABEL = "_agentsafe-challenge";
13
+ /** The header a forwarded answer carries while its upstream's proof is missing. */
14
+ export const UPSTREAM_PROOF_HEADER = "agentsafe-upstream-proof";
15
+ /** The most a proof file, or one TXT record, may be; anything longer is not a proof. */
16
+ export const MAX_PROOF_BYTES = 1_024;
17
+ /** The TXT records read at the proof's name, in the order the resolver gives them. */
18
+ export const MAX_PROOF_RECORDS = 32;
19
+ export const PROOF_TIMEOUT_MS = 10_000;
20
+ const HOUR_MS = 60 * 60 * 1_000;
21
+ /** A proven upstream is checked again a day later, give or take the jitter. */
22
+ export const PROOF_RECHECK_MS = 24 * HOUR_MS;
23
+ export const PROOF_JITTER_MS = HOUR_MS;
24
+ /** While a proof is missing it is looked for every hour, and the gateway forwards for the grace. */
25
+ export const PROOF_MISSING_RECHECK_MS = HOUR_MS;
26
+ export const PROOF_GRACE_MS = 72 * HOUR_MS;
27
+ /** While the gateway forwards nothing, it looks every minute. */
28
+ export const PROOF_PENDING_RETRY_MS = 60_000;
29
+ const TOKEN_DOMAIN = "agentsafe-upstream\nv1\n";
30
+ /** Ten digits; anchors would add nothing, since what it is tested on is ten characters at most. */
31
+ const ISSUED = /\d{10}/;
32
+ const REQUEST_HEADERS = { accept: "text/plain", "user-agent": "agentsafe-upstream-proof/1" };
33
+ /**
34
+ * What a line or a record is trimmed of at both ends: spaces, tabs and
35
+ * carriage returns, and nothing else, exactly as onboarding's own check
36
+ * (Tenant.py, PROOF_LINE_SPACE) reads the same proof, so the two never
37
+ * disagree about one. Not JavaScript's `trim()` nor Python's `strip()`,
38
+ * which each take more and differ from each other.
39
+ */
40
+ const SPACE = new Set([0x09, 0x0d, 0x20]);
41
+ /**
42
+ * A text without the white space at its ends. A position past either end
43
+ * reads as no code unit at all, never a space, so each scan stops there.
44
+ */
45
+ function stripped(text) {
46
+ let start = 0;
47
+ let end = text.length;
48
+ while (SPACE.has(text.charCodeAt(start)))
49
+ start += 1;
50
+ while (SPACE.has(text.charCodeAt(end - 1)))
51
+ end -= 1;
52
+ return text.slice(start, end);
53
+ }
54
+ function token(binding, issued) {
55
+ const digest = createHash("sha256")
56
+ .update(`${TOKEN_DOMAIN}${binding.tenant}\n${binding.org}\n${binding.origin}\n${issued}`)
57
+ .digest()
58
+ .subarray(0, 16)
59
+ .toString("base64url");
60
+ return `v1.${issued}.${digest}`;
61
+ }
62
+ /**
63
+ * The token that proves an origin for a tenant and an organization, issued
64
+ * at a time in Unix seconds: `v1.<issued>.<base64url of the first 16 bytes
65
+ * of SHA-256("agentsafe-upstream\nv1\n" + tenant + "\n" + org + "\n" +
66
+ * origin + "\n" + issued)>`. There is no secret in it: whoever asks for a
67
+ * token is given it, and what proves control is that only the origin's
68
+ * controller can serve it there.
69
+ */
70
+ export function proofToken(binding, issued) {
71
+ return token(binding, String(issued));
72
+ }
73
+ /**
74
+ * Whether any candidate, trimmed of white space at its ends and nothing
75
+ * else, is a token bound to this tenant, organization and origin, at any
76
+ * issue time: its age is onboarding's concern, never a recheck's.
77
+ */
78
+ export function provesUpstream(candidates, binding) {
79
+ return candidates.some((candidate) => {
80
+ const line = stripped(candidate);
81
+ const issued = line.slice(3, 13);
82
+ return ISSUED.test(issued) && line === token(binding, issued);
83
+ });
84
+ }
85
+ /**
86
+ * A proof file's lines. A comment, a blank line and anything else that is not
87
+ * a token never proves anything, so nothing needs removing; a byte-order
88
+ * mark at the start is dropped and a line's carriage return is trimmed with
89
+ * its spaces. A body that is not UTF-8 has no lines at all, whatever one of
90
+ * them might hold: onboarding refuses such a file whole, and so does this.
91
+ */
92
+ export function proofLines(body) {
93
+ let text;
94
+ try {
95
+ text = new TextDecoder("utf-8", { fatal: true }).decode(body);
96
+ }
97
+ catch {
98
+ return [];
99
+ }
100
+ return text.split("\n");
101
+ }
102
+ const MISSING = { kind: "missing" };
103
+ /**
104
+ * One look at whether an upstream's origin serves a token bound to its
105
+ * tenant. The GET goes through a guarded egress of the check's own, sealed
106
+ * to the origin and the proof's path: public addresses only, a loopback name
107
+ * refused, TLS verified against the public roots, redirects never followed,
108
+ * at most 1 KiB, and no header of the tenant's. When the origin answers
109
+ * without a token, a TXT record at `_agentsafe-challenge.<host>` may prove it
110
+ * instead; a record alone never does, because DNS is not authenticated and
111
+ * only an answer over verified TLS ties the name to the origin traffic
112
+ * reaches. Nothing it reads is kept or written anywhere: what it returns is
113
+ * an outcome and a code.
114
+ */
115
+ export class UpstreamProofCheck {
116
+ binding;
117
+ guard;
118
+ resolveTxt;
119
+ constructor(binding, options) {
120
+ this.binding = binding;
121
+ const { resolveTxt, ...seams } = options;
122
+ this.resolveTxt = resolveTxt;
123
+ this.guard = new GuardedFetch({
124
+ ...seams,
125
+ policy: new EgressPolicy([
126
+ {
127
+ origin: binding.origin,
128
+ pathPrefixes: [UPSTREAM_PROOF_PATH],
129
+ ca: null,
130
+ // Stryker disable next-line ArrayDeclaration: a pin binds only a real handshake, and a public-only check makes none with a test's loopback peer.
131
+ pins: [],
132
+ },
133
+ ]),
134
+ // What the check meets is its outcome, not the tenant's egress, so none
135
+ // of it reaches a security stream or the alerts read from one.
136
+ events: new SecurityEvents(() => undefined),
137
+ maxResponseBytes: MAX_PROOF_BYTES,
138
+ timeoutMs: PROOF_TIMEOUT_MS,
139
+ publicOnly: true,
140
+ });
141
+ }
142
+ /** Looks once. Never rejects: every failure is an outcome. */
143
+ async check() {
144
+ const url = new URL(UPSTREAM_PROOF_PATH, this.binding.origin);
145
+ // Public-only lets a loopback name through, as the gateway refuses it in
146
+ // its configuration instead; the check refuses it itself.
147
+ if (EgressPolicy.isLoopbackHost(url.hostname)) {
148
+ return { kind: "unreachable", code: "EGRESS_ADDRESS_REFUSED" };
149
+ }
150
+ let proven = false;
151
+ try {
152
+ const response = await this.guard.fetch(url, {
153
+ headers: REQUEST_HEADERS,
154
+ redirect: "manual",
155
+ });
156
+ proven =
157
+ response.status === 200 &&
158
+ provesUpstream(proofLines(new Uint8Array(await response.arrayBuffer())), this.binding);
159
+ }
160
+ catch (error) {
161
+ // An answer over the bound is an answer, and not a proof; anything else is no answer.
162
+ if (!(error instanceof EgressError && error.code === "EGRESS_BODY_TOO_LARGE")) {
163
+ return { kind: "unreachable", code: UpstreamProofCheck.codeOf(error) };
164
+ }
165
+ }
166
+ return proven ? { kind: "proven", method: "file" } : await this.txt(url.hostname);
167
+ }
168
+ close() {
169
+ this.guard.close();
170
+ }
171
+ /** The TXT record at the origin's name, once the origin has answered; an address has no name. */
172
+ async txt(hostname) {
173
+ if (EgressPolicy.addressOf(hostname) !== null)
174
+ return MISSING;
175
+ let records;
176
+ try {
177
+ records = await this.resolveTxt(`${UPSTREAM_PROOF_TXT_LABEL}.${hostname}`);
178
+ }
179
+ catch (error) {
180
+ // No such name or no such record is an answer; a resolver that failed is not.
181
+ const code = UpstreamProofCheck.codeOf(error);
182
+ if (code !== "ENODATA" && code !== "ENOTFOUND")
183
+ return { kind: "unreachable", code };
184
+ records = [];
185
+ }
186
+ // A record proves the origin when it is the token: its strings joined, as
187
+ // DNS may have split them, and trimmed, with nothing else in it. Only the
188
+ // first records are read, and none longer than a proof file, exactly as
189
+ // onboarding reads them, so a record it refuses never proves anything here.
190
+ const values = records
191
+ .slice(0, MAX_PROOF_RECORDS)
192
+ .map((strings) => strings.join(""))
193
+ .filter((value) => Buffer.byteLength(value) <= MAX_PROOF_BYTES);
194
+ return provesUpstream(values, this.binding) ? { kind: "proven", method: "dns" } : MISSING;
195
+ }
196
+ static codeOf(error) {
197
+ const code = error?.code;
198
+ return typeof code === "string" ? code : "UPSTREAM_UNREACHABLE";
199
+ }
200
+ }
201
+ export const PENDING = { kind: "pending" };
202
+ const UNVERIFIED = { kind: "unverified" };
203
+ /**
204
+ * The state after a check's outcome at a time. A proof seen is verified,
205
+ * and restores a tenant that had lost it. A grace that has run out ends in
206
+ * unverified, whatever the check found short of a proof. A miss starts the
207
+ * grace for a verified tenant, and makes a tenant never seen unverified. An
208
+ * origin that did not answer changes nothing.
209
+ */
210
+ export function advance(state, outcome, now) {
211
+ if (outcome.kind === "proven") {
212
+ const restored = state.kind === "missing" || state.kind === "unverified";
213
+ return {
214
+ state: { kind: "verified", method: outcome.method },
215
+ event: restored ? { event: "UPSTREAM_PROOF_RESTORED", method: outcome.method } : null,
216
+ };
217
+ }
218
+ switch (state.kind) {
219
+ case "missing":
220
+ return inGrace(state, now)
221
+ ? { state, event: null }
222
+ : {
223
+ state: UNVERIFIED,
224
+ event: { event: "UPSTREAM_UNVERIFIED", code: "UPSTREAM_PROOF_GRACE_ENDED" },
225
+ };
226
+ case "verified":
227
+ return outcome.kind === "missing"
228
+ ? {
229
+ state: { kind: "missing", since: now },
230
+ event: {
231
+ event: "UPSTREAM_PROOF_MISSING",
232
+ stops_at: new Date(now + PROOF_GRACE_MS).toISOString(),
233
+ },
234
+ }
235
+ : { state, event: null };
236
+ case "pending":
237
+ return outcome.kind === "missing"
238
+ ? {
239
+ state: UNVERIFIED,
240
+ event: { event: "UPSTREAM_UNVERIFIED", code: "UPSTREAM_PROOF_NOT_SERVED" },
241
+ }
242
+ : { state, event: null };
243
+ default:
244
+ return { state, event: null };
245
+ }
246
+ }
247
+ /** What a request gets in a state at a time: the grace ends on the clock, not at the next check. */
248
+ export function admission(state, now) {
249
+ switch (state.kind) {
250
+ case "verified":
251
+ return "FORWARD";
252
+ case "missing":
253
+ return inGrace(state, now) ? "MISSING" : "REFUSE";
254
+ default:
255
+ return "REFUSE";
256
+ }
257
+ }
258
+ function inGrace(state, now) {
259
+ return now < state.since + PROOF_GRACE_MS;
260
+ }
261
+ /**
262
+ * How long until the next check, with `random` in [0, 1): a day either side
263
+ * of an hour once verified, so a fleet's checks do not fall together; every
264
+ * hour while missing, and at the end of the grace; every minute otherwise.
265
+ */
266
+ export function nextCheckIn(state, now, random) {
267
+ switch (state.kind) {
268
+ case "verified":
269
+ return PROOF_RECHECK_MS + (random * 2 - 1) * PROOF_JITTER_MS;
270
+ case "missing":
271
+ return Math.min(PROOF_MISSING_RECHECK_MS, state.since + PROOF_GRACE_MS - now);
272
+ default:
273
+ return PROOF_PENDING_RETRY_MS;
274
+ }
275
+ }
276
+ /**
277
+ * Whether a proof kept for one binding holds for another: the same tenant,
278
+ * organization and origin, all three. A gateway rebuilt with any of them
279
+ * changed looks from the start, so an edit to a registry entry never carries
280
+ * a proof over to a binding no origin has proved.
281
+ */
282
+ export function sameBinding(kept, binding) {
283
+ return (kept.tenant === binding.tenant && kept.org === binding.org && kept.origin === binding.origin);
284
+ }
285
+ /**
286
+ * A tenant's proof, kept: looked at once when nothing is known, or taken
287
+ * over from the monitor it replaces, then on the cadence its state sets, each
288
+ * change reported. It holds no socket and no timer that keeps a process alive.
289
+ */
290
+ export class UpstreamProofMonitor {
291
+ options;
292
+ state = PENDING;
293
+ settledOnce = false;
294
+ checkedAt = null;
295
+ lastCode = null;
296
+ dueAt = null;
297
+ timer;
298
+ stopped = false;
299
+ constructor(options) {
300
+ this.options = options;
301
+ }
302
+ /** Looks now: nothing is known yet. */
303
+ start() {
304
+ void this.run();
305
+ }
306
+ /**
307
+ * Takes up a proof where another monitor bound the same way left it: its
308
+ * state and last look as they were, and its next look when it was due, or
309
+ * at once when that monitor was stopped with a look in flight.
310
+ */
311
+ resume(standing) {
312
+ this.state = standing.state;
313
+ this.checkedAt = standing.checkedAt;
314
+ this.lastCode = standing.code;
315
+ this.settledOnce = standing.settled;
316
+ this.schedule(standing.dueAt ?? this.options.clock());
317
+ }
318
+ /** Whether a look has finished, here or in the monitor this one took over from. */
319
+ get settled() {
320
+ return this.settledOnce;
321
+ }
322
+ get current() {
323
+ return this.state;
324
+ }
325
+ /** Everything another monitor needs to go on from here; read it once this one is stopped. */
326
+ standing() {
327
+ return {
328
+ state: this.state,
329
+ checkedAt: this.checkedAt,
330
+ code: this.lastCode,
331
+ dueAt: this.dueAt,
332
+ settled: this.settledOnce,
333
+ };
334
+ }
335
+ admits() {
336
+ return admission(this.state, this.options.clock());
337
+ }
338
+ snapshot() {
339
+ const state = this.state;
340
+ return {
341
+ state: state.kind,
342
+ method: state.kind === "verified" ? state.method : null,
343
+ checked_at: this.checkedAt === null ? null : new Date(this.checkedAt).toISOString(),
344
+ stops_at: state.kind === "missing" ? new Date(state.since + PROOF_GRACE_MS).toISOString() : null,
345
+ code: this.lastCode,
346
+ };
347
+ }
348
+ /** No further look, and a look in flight changes nothing when it ends. */
349
+ stop() {
350
+ this.stopped = true;
351
+ clearTimeout(this.timer);
352
+ }
353
+ async run() {
354
+ this.dueAt = null;
355
+ const outcome = await this.options.check();
356
+ if (this.stopped)
357
+ return;
358
+ const now = this.options.clock();
359
+ const step = advance(this.state, outcome, now);
360
+ this.state = step.state;
361
+ this.checkedAt = now;
362
+ this.lastCode = outcome.kind === "unreachable" ? outcome.code : null;
363
+ this.settledOnce = true;
364
+ if (step.event !== null)
365
+ this.options.report({ ...step.event, origin: this.options.origin });
366
+ this.schedule(now + nextCheckIn(this.state, now, this.options.random()));
367
+ }
368
+ /** The next look, at a time; one already due runs at once. */
369
+ schedule(at) {
370
+ this.dueAt = at;
371
+ this.timer = setTimeout(() => void this.run(), at - this.options.clock());
372
+ this.timer.unref();
373
+ }
374
+ }
375
+ //# sourceMappingURL=UpstreamProof.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"UpstreamProof.js","sourceRoot":"","sources":["../../src/gateway/UpstreamProof.ts"],"names":[],"mappings":"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"}
@@ -15,7 +15,11 @@ import type { FetchLike, HandlerRegistration } from "./HandlerRegistration.js";
15
15
  export declare const FORWARD_REQUEST_ACTION = "forward_request";
16
16
  /** Every action the reference registration registers, in the order `/ready` reports them. */
17
17
  export declare const REGISTERED_ACTIONS: readonly string[];
18
- /** What the executor reports about the downstream attempt: a status, never a body. */
18
+ /**
19
+ * What the executor reports about a completed downstream attempt: a status,
20
+ * never a body. Only a 2xx completes, so `accepted` is always true here; a
21
+ * refusal and an unknown outcome are reported as attempt outcomes instead.
22
+ */
19
23
  export interface DownstreamResult {
20
24
  readonly status: number;
21
25
  readonly accepted: boolean;
@@ -1 +1 @@
1
- {"version":3,"file":"ForwardRequestHandler.d.ts","sourceRoot":"","sources":["../../src/handlers/ForwardRequestHandler.ts"],"names":[],"mappings":"AAAA,OAAO,EAGL,KAAK,cAAc,EAEpB,MAAM,+BAA+B,CAAC;AACvC,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,6BAA6B,CAAC;AACpE,OAAO,KAAK,EACV,oBAAoB,EAErB,MAAM,uCAAuC,CAAC;AAK/C,OAAO,KAAK,EAAE,SAAS,EAAE,mBAAmB,EAAE,MAAM,0BAA0B,CAAC;AAE/E;;;;;;;;;GASG;AACH,eAAO,MAAM,sBAAsB,oBAAoB,CAAC;AAExD,6FAA6F;AAC7F,eAAO,MAAM,kBAAkB,EAAE,SAAS,MAAM,EAA6B,CAAC;AAE9E,sFAAsF;AACtF,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAC;CAC5B;AAID,wBAAgB,gBAAgB,CAC9B,QAAQ,EAAE,cAAc,EACxB,UAAU,EAAE,gBAAgB,EAC5B,UAAU,EAAE,oBAAoB,EAChC,SAAS,GAAE,SAAiB,GAC3B,cAAc,CAyFhB;AAED,8FAA8F;AAC9F,wBAAgB,sBAAsB,IAAI,mBAAmB,CAK5D"}
1
+ {"version":3,"file":"ForwardRequestHandler.d.ts","sourceRoot":"","sources":["../../src/handlers/ForwardRequestHandler.ts"],"names":[],"mappings":"AAAA,OAAO,EAIL,KAAK,cAAc,EAEpB,MAAM,+BAA+B,CAAC;AACvC,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,6BAA6B,CAAC;AACpE,OAAO,KAAK,EACV,oBAAoB,EAErB,MAAM,uCAAuC,CAAC;AAK/C,OAAO,KAAK,EAAE,SAAS,EAAE,mBAAmB,EAAE,MAAM,0BAA0B,CAAC;AAE/E;;;;;;;;;GASG;AACH,eAAO,MAAM,sBAAsB,oBAAoB,CAAC;AAExD,6FAA6F;AAC7F,eAAO,MAAM,kBAAkB,EAAE,SAAS,MAAM,EAA6B,CAAC;AAE9E;;;;GAIG;AACH,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAC;CAC5B;AAID,wBAAgB,gBAAgB,CAC9B,QAAQ,EAAE,cAAc,EACxB,UAAU,EAAE,gBAAgB,EAC5B,UAAU,EAAE,oBAAoB,EAChC,SAAS,GAAE,SAAiB,GAC3B,cAAc,CAkGhB;AAED,8FAA8F;AAC9F,wBAAgB,sBAAsB,IAAI,mBAAmB,CAK5D"}
@@ -1,4 +1,4 @@
1
- import { JsonObjectSchema, } from "@decionis/agent-safe-pipeline";
1
+ import { JsonObjectSchema, ProviderRefusal, } from "@decionis/agent-safe-pipeline";
2
2
  import { grantOf } from "../credential/GrantOf.js";
3
3
  import { EFFECT_RECEIPT_HEADER } from "../verify/EffectReceipt.js";
4
4
  import { SignedRequestCredential } from "../credential/SignedRequestCredential.js";
@@ -61,7 +61,17 @@ export function registerHandlers(registry, downstream, credential, fetchImpl = f
61
61
  const receipt = response.headers.get(EFFECT_RECEIPT_HEADER);
62
62
  if (receipt !== null)
63
63
  dispatch.receipt(receipt);
64
- return { status: response.status, accepted: response.ok };
64
+ // The same outcome table as every effect path (docs/execution-outcomes.md):
65
+ // a 2xx commits; a 4xx is the provider's refusal, except a 408, which is
66
+ // a timeout; a 5xx or anything else is unknown, because the provider may
67
+ // have acted before it failed. Reporting those as a result would finalize
68
+ // them COMMITTED.
69
+ if (response.ok)
70
+ return { status: response.status, accepted: true };
71
+ if (response.status >= 400 && response.status < 500 && response.status !== 408) {
72
+ throw new ProviderRefusal(`UPSTREAM_STATUS_${response.status}`);
73
+ }
74
+ throw new Error(`UPSTREAM_OUTCOME_UNKNOWN_${response.status}`);
65
75
  });
66
76
  };
67
77
  // Read-only: asks the downstream what it did with this idempotency key.
@@ -1 +1 @@
1
- {"version":3,"file":"ForwardRequestHandler.js","sourceRoot":"","sources":["../../src/handlers/ForwardRequestHandler.ts"],"names":[],"mappings":"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"}
1
+ {"version":3,"file":"ForwardRequestHandler.js","sourceRoot":"","sources":["../../src/handlers/ForwardRequestHandler.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,180 @@
1
+ import { Gateway, type GatewayDependencies, type GatewayIo } from "../gateway/Gateway.js";
2
+ import { type GatewayConfig } from "../gateway/GatewayConfig.js";
3
+ import type { GatewaySelector } from "../http/GatewayHttpServer.js";
4
+ import { type TenantEntry } from "./TenantRegistry.js";
5
+ /**
6
+ * What a tenant's gateway inherits from the host's environment: how to reach
7
+ * the authority and how long to wait for it and for the upstream. Nothing
8
+ * else crosses, and never a credential: each tenant's workspace key comes
9
+ * from its own mounted file, and the host's own environment may hold keys
10
+ * no tenant should ever run under.
11
+ */
12
+ export declare const SHARED_ENVIRONMENT: readonly ["NODE_ENV", "DECIONIS_API_URL", "DECIONIS_TIMEOUT_MS", "DECIONIS_ALLOW_INSECURE_LOOPBACK", "AGENTSAFE_UPSTREAM_TIMEOUT_MS", "AGENTSAFE_FAILURE_POLICY"];
13
+ /** How long a replaced or removed tenant's gateway keeps finishing requests already in flight. */
14
+ export declare const DEFAULT_DRAIN_MS = 30000;
15
+ /** The longest readiness waits for the tenants' first looks at their upstreams' proofs. */
16
+ export declare const PROOF_READY_CAP_MS = 30000;
17
+ export interface TenantHostOptions {
18
+ readonly registryPath: string;
19
+ /** The host's environment; only `SHARED_ENVIRONMENT` reaches a tenant. */
20
+ readonly env: Readonly<Record<string, string | undefined>>;
21
+ readonly io: GatewayIo;
22
+ /** The registry's text, or null when there is no such file. */
23
+ readonly readFile: (path: string) => string | null;
24
+ readonly version?: string;
25
+ readonly drainMs?: number;
26
+ /**
27
+ * Every tenant's gateway forwards nothing until its upstream's origin
28
+ * serves a token bound to the tenant (`--require-upstream-proof`).
29
+ */
30
+ readonly requireUpstreamProof?: boolean;
31
+ readonly clock?: () => number;
32
+ /** Assembles one tenant's gateway; `Gateway.create` unless a test says otherwise. */
33
+ readonly createGateway?: (config: GatewayConfig, dependencies: GatewayDependencies) => Promise<Gateway>;
34
+ /** Handed to every tenant's gateway beside its own environment and output (transports, in tests). */
35
+ readonly dependencies?: Omit<GatewayDependencies, "env" | "io">;
36
+ }
37
+ /** What one load of the registry did, as the host reports it. */
38
+ export interface TenantLoadReport {
39
+ readonly event: "TENANT_REGISTRY_LOADED" | "TENANT_REGISTRY_REFUSED";
40
+ /** The code when the registry itself was refused; the tenants served are then unchanged. */
41
+ readonly code: string | null;
42
+ /** The registry's text, as read, as a short digest; null when there was none to read. */
43
+ readonly revision: string | null;
44
+ readonly served: number;
45
+ readonly built: readonly string[];
46
+ readonly kept: number;
47
+ /** Tenants whose gateway took new keys in place, without a rebuild. */
48
+ readonly rekeyed: readonly string[];
49
+ readonly retired: number;
50
+ /**
51
+ * Tenants whose entry could not be applied, with the reason. Each keeps the
52
+ * gateway it had, if it had one, admitting only keys its entry still lists;
53
+ * when that is none, it is not served.
54
+ */
55
+ readonly failed: readonly {
56
+ readonly tenant: string;
57
+ readonly code: string;
58
+ }[];
59
+ }
60
+ /**
61
+ * Many tenants' gateways in one process, each at `{id}.{domain}`, built from
62
+ * the registry the operator mounts. Every tenant gets an ordinary hosted
63
+ * gateway (public-only upstream, shadow only, operator-only status,
64
+ * host-only cookies, its tenant key required) assembled from its entry and
65
+ * its own workspace key file; nothing about one tenant is visible to
66
+ * another, because each request is routed to one gateway by its host alone.
67
+ *
68
+ * A reload rebuilds only the tenants whose entry changed, swaps the set at
69
+ * once, and lets a replaced gateway drain before it is closed; the gateway
70
+ * built in its place continues its chains, found by the tenant's id and not
71
+ * its host, and takes over its upstream's proof at the swap, as it stands
72
+ * then. A change to a tenant's keys alone rebuilds nothing: its gateway
73
+ * takes them in place. A registry that cannot be read or is not valid
74
+ * changes nothing: the tenants served stay served.
75
+ */
76
+ export declare class TenantHost {
77
+ private readonly options;
78
+ private served;
79
+ private readonly draining;
80
+ private readonly timers;
81
+ private queue;
82
+ private closed;
83
+ private refusal;
84
+ private failing;
85
+ private currentDomain;
86
+ /** How the tenants' hosts are reached, once the listener is bound; null before. */
87
+ private scheme;
88
+ /** When one load first served every tenant the registry names; null until then. */
89
+ private everyTenantServedAt;
90
+ private readyLatched;
91
+ /** The gateway for a request's host, or null (the listener answers 421). */
92
+ readonly select: GatewaySelector;
93
+ private readonly clock;
94
+ private constructor();
95
+ /** Loads the registry and builds every tenant; a registry that cannot be served refuses the start. */
96
+ static start(options: TenantHostOptions): Promise<TenantHost>;
97
+ /**
98
+ * The tenants whose entry the last load could not apply: a reload with an
99
+ * unchanged registry tries exactly these again, since every other tenant
100
+ * is kept. A tenant whose key file had not arrived yet is one of them.
101
+ */
102
+ failures(): readonly string[];
103
+ /**
104
+ * Whether the process is ready for traffic: from the first load that served
105
+ * every tenant its registry names, once each of their gateways has had its
106
+ * first look at its upstream's proof, or 30 seconds have passed, and from
107
+ * then on. A new process, in a rollout or after a restart, gets no traffic
108
+ * while a tenant it should serve would be answered 421, or 503 only for
109
+ * want of a first look; once ready, a tenant that cannot be built later
110
+ * is reported, and never takes every other tenant out of service.
111
+ */
112
+ ready(): boolean;
113
+ /** The domain of the registry last loaded: the apex, and the parent of every tenant's host. */
114
+ domain(): string | null;
115
+ /** The hostnames served, sorted. */
116
+ hostnames(): readonly string[];
117
+ /**
118
+ * The listener is bound: every tenant's gateway starts, with its banner and
119
+ * its chained start line, and so does each gateway built from now on as it
120
+ * is swapped in. A started gateway reports its stop, and its shadow tally,
121
+ * when it is replaced or the host stops.
122
+ */
123
+ listening(scheme: "http" | "https"): void;
124
+ /** Reads the registry again; reloads never overlap, and each is reported as one line. */
125
+ reload(): Promise<TenantLoadReport>;
126
+ /**
127
+ * Stops every gateway, the draining ones included, and closes them: the
128
+ * draining ones first, so the head a journal persists last is the one the
129
+ * live gateway links on.
130
+ */
131
+ close(signal?: string): Promise<void>;
132
+ private load;
133
+ /**
134
+ * Makes a kept gateway admit exactly the keys its tenant's entry lists now,
135
+ * in place and at once. Digests it refuses (malformed, repeated) leave it
136
+ * only the keys it already admits that the entry still lists, and none of
137
+ * those means it is not served: a key the registry dropped is never left
138
+ * admitted because the rest of an entry could not be applied.
139
+ */
140
+ private static rekey;
141
+ /** The newest of a tenant's gateways still draining: the only one that may still persist its heads. */
142
+ private drainingFor;
143
+ /**
144
+ * One tenant's hosted gateway, from its entry, the shared environment and
145
+ * its own key file; continuing the gateway it replaces, when there is one.
146
+ */
147
+ private build;
148
+ /**
149
+ * The environment a tenant's gateway runs in: the shared settings, its own
150
+ * entry, and the host's own settings for every tenant.
151
+ */
152
+ static tenantEnvironment(host: Readonly<Record<string, string | undefined>>, tenant: TenantEntry, settings?: {
153
+ readonly upstreamProof?: boolean;
154
+ }): Record<string, string>;
155
+ /**
156
+ * A tenant's key digests as its gateway's loader reads them: split at
157
+ * commas, trimmed, and without empty values. A build and an in-place rekey
158
+ * both start from these, so a reload of an entry the build admitted admits
159
+ * the same keys, and never refuses them.
160
+ */
161
+ private static keyDigests;
162
+ /**
163
+ * The tenant's own output: every line a tenant's gateway writes names its
164
+ * tenant, so one process's stream can be read, retained and deleted per
165
+ * tenant. A chained line already carries `tenant` in its envelope, covered
166
+ * by its hash, and is passed through untouched: adding anything to it
167
+ * would break the chain. Any other JSON line gets `tenant` first; anything
168
+ * else is wrapped.
169
+ */
170
+ static taggedIo(io: GatewayIo, tenant: string): GatewayIo;
171
+ /** Why a tenant's gateway could not be built: a code and the setting, never a value. */
172
+ private static codeOf;
173
+ /**
174
+ * Lets a replaced or removed gateway finish what it has in flight, then
175
+ * stops it, so its shadow report counts what settled while it drained.
176
+ */
177
+ private drain;
178
+ private report;
179
+ }
180
+ //# sourceMappingURL=TenantHost.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"TenantHost.d.ts","sourceRoot":"","sources":["../../src/hosted/TenantHost.ts"],"names":[],"mappings":"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"}