@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
@@ -1,3 +1,4 @@
1
+ import { TENANT_KEY_HEADER } from "./GatewayConfig.js";
1
2
  /** Thrown when the upstream's response body is longer than the gateway relays. */
2
3
  export class UpstreamResponseTooLarge extends Error {
3
4
  constructor() {
@@ -26,6 +27,8 @@ const REQUEST_OWNED = new Set([
26
27
  "x-forwarded-proto",
27
28
  "x-forwarded-host",
28
29
  ]);
30
+ /** The gateway's own credentials a client presents to it; they end at the gateway. */
31
+ const GATEWAY_CREDENTIALS = new Set([TENANT_KEY_HEADER]);
29
32
  /** Response headers the relay recomputes, because it relays decoded bytes of a known length. */
30
33
  const RESPONSE_OWNED = new Set(["content-length", "content-encoding"]);
31
34
  const BODYLESS_METHODS = new Set(["GET", "HEAD"]);
@@ -33,6 +36,32 @@ const BODYLESS_METHODS = new Set(["GET", "HEAD"]);
33
36
  const EVIDENCE_HEADER_PREFIX = "x-agent-safe-";
34
37
  /** The headers the gateway sends the caller about the decision; an upstream may not set them. */
35
38
  const RELAY_HEADER_PREFIX = "agentsafe-";
39
+ /**
40
+ * The policy a hosted gateway adds to every relayed response. A browser
41
+ * renders the response as a unique, opaque origin: no script runs, so a page
42
+ * one tenant's upstream serves cannot set a cookie for the shared domain
43
+ * from script (which no `Set-Cookie` rewrite would see), and nothing it
44
+ * renders is same-origin with its own host. It is added beside any policy the
45
+ * upstream sent, and a browser enforces every policy it is given, so the
46
+ * upstream's own can only narrow it further.
47
+ */
48
+ export const SANDBOX_POLICY = "sandbox";
49
+ /**
50
+ * A `Set-Cookie` value without its `Domain` attribute, so the client keeps
51
+ * the cookie for the exact host it came from. Behind a hosted gateway every
52
+ * tenant is a sibling host under one domain; a cookie one tenant's upstream
53
+ * set for the parent would otherwise be sent to every other tenant. The
54
+ * name and value are the first segment and are never touched, whatever they
55
+ * contain.
56
+ */
57
+ export function hostOnlyCookie(value) {
58
+ const [pair, ...attributes] = value.split(";");
59
+ const kept = attributes.filter((attribute) => {
60
+ const name = attribute.split("=", 1)[0]?.trim().toLowerCase();
61
+ return name !== "domain";
62
+ });
63
+ return [pair, ...kept].join(";");
64
+ }
36
65
  /**
37
66
  * The one way the gateway reaches the upstream. It rebuilds the request
38
67
  * from what it is given: the upstream origin from the configuration, the
@@ -70,6 +99,7 @@ export class Upstream {
70
99
  // a caller's spelling of one is dropped so it can never be mistaken for it.
71
100
  if (HOP_BY_HOP.has(name) ||
72
101
  REQUEST_OWNED.has(name) ||
102
+ GATEWAY_CREDENTIALS.has(name) ||
73
103
  connectionNamed.has(name) ||
74
104
  name.startsWith(EVIDENCE_HEADER_PREFIX)) {
75
105
  continue;
@@ -117,8 +147,14 @@ export class Upstream {
117
147
  }
118
148
  relayed.push([name, value]);
119
149
  }
120
- for (const cookie of response.headers.getSetCookie())
121
- relayed.push(["set-cookie", cookie]);
150
+ for (const cookie of response.headers.getSetCookie()) {
151
+ relayed.push([
152
+ "set-cookie",
153
+ this.options.hostOnlyCookies === true ? hostOnlyCookie(cookie) : cookie,
154
+ ]);
155
+ }
156
+ if (this.options.sandboxed === true)
157
+ relayed.push(["content-security-policy", SANDBOX_POLICY]);
122
158
  return {
123
159
  status: response.status,
124
160
  headers: relayed,
@@ -150,6 +186,9 @@ export class Upstream {
150
186
  }
151
187
  return Buffer.concat(chunks);
152
188
  }
189
+ close() {
190
+ this.options.close?.();
191
+ }
153
192
  /** The signal for one send: the configured ceiling, or a tighter budget the caller holds. */
154
193
  signal(budgetMs = this.options.timeoutMs) {
155
194
  return AbortSignal.timeout(Math.max(Math.min(budgetMs, this.options.timeoutMs), 1));
@@ -1 +1 @@
1
- {"version":3,"file":"Upstream.js","sourceRoot":"","sources":["../../src/gateway/Upstream.ts"],"names":[],"mappings":"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"}
1
+ {"version":3,"file":"Upstream.js","sourceRoot":"","sources":["../../src/gateway/Upstream.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,235 @@
1
+ import { type AddressResolver } from "../egress/GuardedFetch.js";
2
+ import type { FetchLike } from "../handlers/HandlerRegistration.js";
3
+ import { type SecurityEvent } from "../incident/SecurityEvents.js";
4
+ /**
5
+ * Where an upstream's origin serves its proof: one fixed path, so a token is
6
+ * never part of a URL and an origin that echoes its URL cannot serve one.
7
+ */
8
+ export declare const UPSTREAM_PROOF_PATH = "/.well-known/agentsafe-upstream";
9
+ /** The label a TXT proof is published under, in front of the upstream's host name. */
10
+ export declare const UPSTREAM_PROOF_TXT_LABEL = "_agentsafe-challenge";
11
+ /** The header a forwarded answer carries while its upstream's proof is missing. */
12
+ export declare const UPSTREAM_PROOF_HEADER = "agentsafe-upstream-proof";
13
+ /** The most a proof file, or one TXT record, may be; anything longer is not a proof. */
14
+ export declare const MAX_PROOF_BYTES = 1024;
15
+ /** The TXT records read at the proof's name, in the order the resolver gives them. */
16
+ export declare const MAX_PROOF_RECORDS = 32;
17
+ export declare const PROOF_TIMEOUT_MS = 10000;
18
+ /** A proven upstream is checked again a day later, give or take the jitter. */
19
+ export declare const PROOF_RECHECK_MS: number;
20
+ export declare const PROOF_JITTER_MS: number;
21
+ /** While a proof is missing it is looked for every hour, and the gateway forwards for the grace. */
22
+ export declare const PROOF_MISSING_RECHECK_MS: number;
23
+ export declare const PROOF_GRACE_MS: number;
24
+ /** While the gateway forwards nothing, it looks every minute. */
25
+ export declare const PROOF_PENDING_RETRY_MS = 60000;
26
+ /**
27
+ * Whom a proof is for: the tenant's id, the Decionis organization it runs
28
+ * under, and the upstream's origin as the WHATWG URL spells it (lower-case
29
+ * host, no default port, no path). The base path is never part of it: the
30
+ * gateway is sealed to the whole origin, so the proof covers the whole origin.
31
+ */
32
+ export interface ProofBinding {
33
+ readonly tenant: string;
34
+ readonly org: string;
35
+ readonly origin: string;
36
+ }
37
+ /**
38
+ * The token that proves an origin for a tenant and an organization, issued
39
+ * at a time in Unix seconds: `v1.<issued>.<base64url of the first 16 bytes
40
+ * of SHA-256("agentsafe-upstream\nv1\n" + tenant + "\n" + org + "\n" +
41
+ * origin + "\n" + issued)>`. There is no secret in it: whoever asks for a
42
+ * token is given it, and what proves control is that only the origin's
43
+ * controller can serve it there.
44
+ */
45
+ export declare function proofToken(binding: ProofBinding, issued: number): string;
46
+ /**
47
+ * Whether any candidate, trimmed of white space at its ends and nothing
48
+ * else, is a token bound to this tenant, organization and origin, at any
49
+ * issue time: its age is onboarding's concern, never a recheck's.
50
+ */
51
+ export declare function provesUpstream(candidates: readonly string[], binding: ProofBinding): boolean;
52
+ /**
53
+ * A proof file's lines. A comment, a blank line and anything else that is not
54
+ * a token never proves anything, so nothing needs removing; a byte-order
55
+ * mark at the start is dropped and a line's carriage return is trimmed with
56
+ * its spaces. A body that is not UTF-8 has no lines at all, whatever one of
57
+ * them might hold: onboarding refuses such a file whole, and so does this.
58
+ */
59
+ export declare function proofLines(body: Uint8Array): readonly string[];
60
+ export type ProofMethod = "file" | "dns";
61
+ /**
62
+ * What one check found. `missing` is definitive: the origin answered over
63
+ * verified TLS and served no token bound to the tenant. `unreachable` is no
64
+ * answer at all, which says nothing about the proof.
65
+ */
66
+ export type ProofOutcome = {
67
+ readonly kind: "proven";
68
+ readonly method: ProofMethod;
69
+ } | {
70
+ readonly kind: "missing";
71
+ } | {
72
+ readonly kind: "unreachable";
73
+ readonly code: string;
74
+ };
75
+ /** TXT lookup as `dns.promises.resolveTxt` answers it: each record as its strings. */
76
+ export type TxtResolver = (name: string) => Promise<string[][]>;
77
+ export interface UpstreamProofCheckOptions {
78
+ readonly resolveTxt: TxtResolver;
79
+ /** Name resolution for the GET; the system resolver when absent. */
80
+ readonly resolve?: AddressResolver;
81
+ /** A transport under the guard, for a test; `node:https` when absent. */
82
+ readonly transport?: FetchLike;
83
+ }
84
+ /**
85
+ * One look at whether an upstream's origin serves a token bound to its
86
+ * tenant. The GET goes through a guarded egress of the check's own, sealed
87
+ * to the origin and the proof's path: public addresses only, a loopback name
88
+ * refused, TLS verified against the public roots, redirects never followed,
89
+ * at most 1 KiB, and no header of the tenant's. When the origin answers
90
+ * without a token, a TXT record at `_agentsafe-challenge.<host>` may prove it
91
+ * instead; a record alone never does, because DNS is not authenticated and
92
+ * only an answer over verified TLS ties the name to the origin traffic
93
+ * reaches. Nothing it reads is kept or written anywhere: what it returns is
94
+ * an outcome and a code.
95
+ */
96
+ export declare class UpstreamProofCheck {
97
+ private readonly binding;
98
+ private readonly guard;
99
+ private readonly resolveTxt;
100
+ constructor(binding: ProofBinding, options: UpstreamProofCheckOptions);
101
+ /** Looks once. Never rejects: every failure is an outcome. */
102
+ check(): Promise<ProofOutcome>;
103
+ close(): void;
104
+ /** The TXT record at the origin's name, once the origin has answered; an address has no name. */
105
+ private txt;
106
+ private static codeOf;
107
+ }
108
+ /**
109
+ * Where a tenant's proof stands in this process. `pending`: not yet seen;
110
+ * `verified`: seen, by file or by TXT; `missing`: gone since a time, and
111
+ * forwarded for the grace after it; `unverified`: not served when first
112
+ * looked for, or gone for longer than the grace.
113
+ */
114
+ export type ProofState = {
115
+ readonly kind: "pending";
116
+ } | {
117
+ readonly kind: "verified";
118
+ readonly method: ProofMethod;
119
+ } | {
120
+ readonly kind: "missing";
121
+ readonly since: number;
122
+ } | {
123
+ readonly kind: "unverified";
124
+ };
125
+ /** What a change of state is reported as, on the tenant's security stream, before its origin. */
126
+ export type ProofEvent = {
127
+ readonly event: "UPSTREAM_PROOF_MISSING";
128
+ readonly stops_at: string;
129
+ } | {
130
+ readonly event: "UPSTREAM_UNVERIFIED";
131
+ readonly code: "UPSTREAM_PROOF_NOT_SERVED" | "UPSTREAM_PROOF_GRACE_ENDED";
132
+ } | {
133
+ readonly event: "UPSTREAM_PROOF_RESTORED";
134
+ readonly method: ProofMethod;
135
+ };
136
+ export interface ProofStep {
137
+ readonly state: ProofState;
138
+ readonly event: ProofEvent | null;
139
+ }
140
+ /** What a tenant's request gets: forwarded, forwarded and marked, or refused. */
141
+ export type ProofAdmission = "FORWARD" | "MISSING" | "REFUSE";
142
+ export declare const PENDING: ProofState;
143
+ /**
144
+ * The state after a check's outcome at a time. A proof seen is verified,
145
+ * and restores a tenant that had lost it. A grace that has run out ends in
146
+ * unverified, whatever the check found short of a proof. A miss starts the
147
+ * grace for a verified tenant, and makes a tenant never seen unverified. An
148
+ * origin that did not answer changes nothing.
149
+ */
150
+ export declare function advance(state: ProofState, outcome: ProofOutcome, now: number): ProofStep;
151
+ /** What a request gets in a state at a time: the grace ends on the clock, not at the next check. */
152
+ export declare function admission(state: ProofState, now: number): ProofAdmission;
153
+ /**
154
+ * How long until the next check, with `random` in [0, 1): a day either side
155
+ * of an hour once verified, so a fleet's checks do not fall together; every
156
+ * hour while missing, and at the end of the grace; every minute otherwise.
157
+ */
158
+ export declare function nextCheckIn(state: ProofState, now: number, random: number): number;
159
+ /** What the operator's status shows of a tenant's proof: its state and times, never its text. */
160
+ export interface ProofSnapshot {
161
+ readonly state: ProofState["kind"];
162
+ readonly method: ProofMethod | null;
163
+ readonly checked_at: string | null;
164
+ readonly stops_at: string | null;
165
+ /** Why the last check had no answer, when it had none. */
166
+ readonly code: string | null;
167
+ }
168
+ /**
169
+ * Whether a proof kept for one binding holds for another: the same tenant,
170
+ * organization and origin, all three. A gateway rebuilt with any of them
171
+ * changed looks from the start, so an edit to a registry entry never carries
172
+ * a proof over to a binding no origin has proved.
173
+ */
174
+ export declare function sameBinding(kept: ProofBinding, binding: ProofBinding): boolean;
175
+ /**
176
+ * Where a tenant's proof stands, whole: its state, when it was last looked
177
+ * at and why that look had no answer, when the next look is due, and whether
178
+ * any look has ended. A gateway built to replace another takes it over as it
179
+ * stands at the swap, so a rebuild neither forgets the last look nor moves
180
+ * the next one.
181
+ */
182
+ export interface ProofStanding {
183
+ readonly state: ProofState;
184
+ readonly checkedAt: number | null;
185
+ readonly code: string | null;
186
+ /** When the next look is due; null while one is in flight, so whoever takes over looks at once. */
187
+ readonly dueAt: number | null;
188
+ readonly settled: boolean;
189
+ }
190
+ export interface UpstreamProofMonitorOptions {
191
+ readonly origin: string;
192
+ /** One look; never rejects. */
193
+ readonly check: () => Promise<ProofOutcome>;
194
+ /** Puts a change of state on the tenant's security stream. */
195
+ readonly report: (event: SecurityEvent) => void;
196
+ readonly clock: () => number;
197
+ readonly random: () => number;
198
+ }
199
+ /**
200
+ * A tenant's proof, kept: looked at once when nothing is known, or taken
201
+ * over from the monitor it replaces, then on the cadence its state sets, each
202
+ * change reported. It holds no socket and no timer that keeps a process alive.
203
+ */
204
+ export declare class UpstreamProofMonitor {
205
+ private readonly options;
206
+ private state;
207
+ private settledOnce;
208
+ private checkedAt;
209
+ private lastCode;
210
+ private dueAt;
211
+ private timer;
212
+ private stopped;
213
+ constructor(options: UpstreamProofMonitorOptions);
214
+ /** Looks now: nothing is known yet. */
215
+ start(): void;
216
+ /**
217
+ * Takes up a proof where another monitor bound the same way left it: its
218
+ * state and last look as they were, and its next look when it was due, or
219
+ * at once when that monitor was stopped with a look in flight.
220
+ */
221
+ resume(standing: ProofStanding): void;
222
+ /** Whether a look has finished, here or in the monitor this one took over from. */
223
+ get settled(): boolean;
224
+ get current(): ProofState;
225
+ /** Everything another monitor needs to go on from here; read it once this one is stopped. */
226
+ standing(): ProofStanding;
227
+ admits(): ProofAdmission;
228
+ snapshot(): ProofSnapshot;
229
+ /** No further look, and a look in flight changes nothing when it ends. */
230
+ stop(): void;
231
+ private run;
232
+ /** The next look, at a time; one already due runs at once. */
233
+ private schedule;
234
+ }
235
+ //# sourceMappingURL=UpstreamProof.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"UpstreamProof.d.ts","sourceRoot":"","sources":["../../src/gateway/UpstreamProof.ts"],"names":[],"mappings":"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"}